[FFmpeg-devel] [PATCH] 5 patches from the Debian packaging

[Timothy Gu]

On Sat, Mar 8, 2014 at 1:07 PM, Andreas Cadhalpun
<andreas.cadhalpun at googlemail.com> wrote:
> On 08.03.2014 20:57, Timothy Gu wrote:
>>
>>  From doc/t2h.init. Another thing i noticed is that makeinfo doesn't seem
>> to
>> support texi2html init files, which FFmpeg uses for lots of things
>> including CSS and title. Although makeinfo has --init-file option, the
>> syntax of that is not documented anywhere, unlike texi2html.
>
>
> Indeed it seems that makeinfo completely ignores the init file. The output
> is the same without the --init-file option.
>
> Unless you have a better idea, I'm going to file a bug against texinfo.

Yes, that seems to be the best idea.

I can see that the perl implementation of makeinfo/texi2any (there are
2 implementations: a Perl one and an C one) does have rudimentary init
file support [1], and many of the variable we use are valid (e.g.
PRE_BODY_CLOSE and EXTRA_HEAD) for the Texinfo Perl module [2]. It's
just that the subroutine Texinfo::Config::set_from_init_file is never
used.

Therefore, IMO adding support for it just requires using the function
to parse the init file, but I'm no Perl expert, so ...

Also Libav is considering switching to Markdown for documentation
(Luca Barbato is working on a Python port of kramdown and a texinfo
parser for kramdown [3]).

Timothy

[1] http://anonscm.debian.org/gitweb/?p=debian-tex/texinfo.git;a=blob;f=tp/texi2any.pl;h=93f0b21214240ffa568db869a479b03a80d7d34e;hb=14b5153d64acb57a571d3546fff44965ce852387#l374
[2] http://anonscm.debian.org/gitweb/?p=debian-tex/texinfo.git;a=blob;f=tp/Texinfo/Convert/HTML.pm;h=7ff99aecffd7ca83fada9963dca6543a40e46788;hb=14b5153d64acb57a571d3546fff44965ce852387#l6144
[3] http://wiki.luminem.org/kramdown