[FFmpeg-devel] [PATCH 0/3] Some changes and fixes for the documentation build system

[Michael Niedermayer]

On Wed, Jul 11, 2012 at 08:20:26AM +0200, Reimar Döffinger wrote:
> On 11 Jul 2012, at 04:24, jamal <jamrial at gmail.com> wrote:
> > Among other things this covers Carl Eugen Hoyos' ticket #1515 on Trac regarding texi2html.
> > The first patch makes the configure script check for pod2man instead of texi2html when choosing if it should disable or enable CONFIG_DOC.
> > Since make install only cares about man pages, the availability of texi2html should not decide if the documentation is built or not.
> 
> To be honest I rather dislike this automatic doc enabling anyway.

I have no oppinion on this
if people want it disabled by default, fine with me, if they want it
enabled, fine too
whats the oppinon of the other developers ?


> On my systems there is e.g. a texi2hml but it does not actually work because it misses some data files or such.
> Thus I have to disable docs to be able to build at all.

this sounds like a quite specific misconfiguration on your side.
maybe you want to improve the text2html check in configure to work
better in that case.


> But even when it works, I think the docs building just wastes time for most people building themselves (seriously, how many people actually care about reading anything but the man page locally? I at least sometimes even read man pages online instead...)

building docs with make -j4 takes 1.6 seconds here

one disadvantage of disabling it by default is that it would reduce
testing of the doc building significantly as most users probably
wont override the default

[...]
-- 
Michael     GnuPG fingerprint: 9FF2128B147EF6730BADF133611EC787040B0FAB

The greatest way to live with honor in this world is to be what we pretend
to be. -- Socrates
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 198 bytes
Desc: Digital signature
URL: <http://ffmpeg.org/pipermail/ffmpeg-devel/attachments/20120711/4ff39140/attachment.asc>