[FFmpeg-devel] [PATCH] doc: enable compilation of monolithic tools doc with --enable-monolithic-tools-doc

[Michael Niedermayer]

On Sat, Mar 30, 2013 at 05:06:09PM +0100, Stefano Sabatini wrote:
> On date Sunday 2013-03-24 13:53:47 +0100, Michael Niedermayer encoded:
> > On Tue, Mar 19, 2013 at 10:25:24PM +0100, Stefano Sabatini wrote:
> > > On date Tuesday 2013-03-19 20:56:11 +0100, Stefano Sabatini encoded:
> > > > Fix trac issue #2374.
> > > > ---
> > > >  configure         |    8 +++++++-
> > > >  doc/ffmpeg.texi   |   12 ++++++++++++
> > > >  doc/ffplay.texi   |   12 ++++++++++++
> > > >  doc/ffprobe.texi  |   12 ++++++++++++
> > > >  doc/ffserver.texi |   12 ++++++++++++
> > > >  5 files changed, 55 insertions(+), 1 deletion(-)
> > > 
> > > Updated with a few minor fixes.
> > > 
> > > Website inclusion may be a bit complicate, as it is not very clear if
> > > we should link by default the monolithic (more
> > > lazy-grepping-user-friendly) or the more readable slim version.
> > > 
> > 
> > > Ideally we should include both which means we should build both
> > > variants which may implicate a few complications to the updater
> > > script.
> > 
> > why not build both by default ?
> > maybe by adding:
> > doc/ffmpeg-monolithic.texi
> > doc/ffplay-monolithic.texi
> 
> In this case the user will have to do:
> man ffmpeg-monolithic.1
> 
> to read the monolithic document, while with the current approach it
> depends on compilation options.

if it depends on compile time options then i dont want to be
the one dealing with users
"why does my man ffmpeg not describe option X"
"I did X and suddenly half the options are missing in the
 documentation" 

 or "please look in man ffmpeg" ... "i do but its not documented
 there" ...



> 
> I'm fine with both approaches.
> 
> [...]
> -- 
> FFmpeg = Frightening Foolish Mystic Political Evil Gem
> _______________________________________________
> ffmpeg-devel mailing list
> ffmpeg-devel at ffmpeg.org
> http://ffmpeg.org/mailman/listinfo/ffmpeg-devel
> 

-- 
Michael     GnuPG fingerprint: 9FF2128B147EF6730BADF133611EC787040B0FAB

The worst form of inequality is to try to make unequal things equal.
-- Aristotle
-------------- 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/20130403/f6cb4f07/attachment.asc>