[FFmpeg-devel] [PATCH 0/8] [WIP] doc/texi2pod: merge changes from GCC upstream

[Stefano Sabatini]

On date Wednesday 2014-01-22 20:03:58 -0800, Timothy Gu encoded:
> For people who don't already know, doc/texi2pod.pl is initially copied from GCC
> as contrib/texi2pod.pl, in 2002 or 2003. Since then, FFmpeg and GCC both fixed
> and improved this script, but without backporting with each other's fixes.
> 
> This patchset, although not finished, reduces differences between the 2
> projects. I will send some of FFmpeg's fixes to GCC later.
> 
> Patches 01-07 do not change the output of the texi2pod at all. Patch 08 changes
> the output in order to be consistent with GCC.

I'm not against, but:

1. would be possible to lobby GCC devs in order to make texi2pod a
standalone application/package, so that we don't have to include our
custom version and duplicate work with upstream?

2. the current conversion chain texi->POD->MAN is a kludge, it would
be much better to rely on a more generic framework rather than have
different tools for different outputs. pandoc would be a solution (but
doesn't support texi->MAN and relies on Haskell, which is a somehow
strong requirement), and the current texi2any (successor of texi2html)
doesn't support POD/MAN output.

As a short/medium term solution, synching our texi2pod with upstream
is probably a good idea, but I'm afraid that upstreaming our changes
would not be trivial.
-- 
FFmpeg = Friendly and Frenzy Maxi Prodigious Erudite Gargoyle