[FFmpeg-devel] [PATCH] Use makeinfo to generate html doc for the new website

[Timothy Gu]

On Wed, Sep 3, 2014 at 2:44 PM, Michael Niedermayer <michaelni at gmx.at> wrote:
> On Sun, Aug 31, 2014 at 07:39:35PM -0700, Timothy Gu wrote:
>> This is a new iteration of the patch that has been stalled for more than a
>> month. Finally got time to work on it.
>>
>> Change since last patch:
>> - Fix compilation on machines with makeinfo < 5 that don't support HTML
>>   output.
>>
>> ---8<---
>> texi2html is deprecated by upstream in favor of makeinfo/texi2any. See:
>>
>> - https://www.gnu.org/software/texinfo/manual/texinfo/html_node/texi2html.html
>> - https://wiki.debian.org/Texi2htmlTransition
>> - https://lists.debian.org/debian-devel/2013/05/msg01516.html
>>
>> This is actually two separate changes. But as makeinfo and texi2html
>> adopt 2 (very) different init file syntaxes, it is easier to do the two
>> transitions at once.
>>
>> Based on a patch by Andreas Cadhalpun <Andreas.Cadhalpun at googlemail.com>.
>>
>> Fixes Trac ticket #3232.
>>
>> Signed-off-by: Timothy Gu <timothygu99 at gmail.com>
>> ---
>>  configure         |   9 ++-
>>  doc/Makefile      |   8 +-
>>  doc/platform.texi |   2 +-
>>  doc/t2h.init      | 123 ------------------------------
>>  doc/t2h.pm        | 220 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
>
> isnt it possible to retain texi2html support for a transition
> period, that is until all major distrbutions support a recent
> makeinfo/texi2any ?

Yes.

>
> iam not sure how many of our users use te html documentation but
> i suspect many would have to install makeinfo/texi2any from source
> due to lack of distro packages if they want to build the html docs

Will send new patch soon.

Timothy