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

Stefano Sabatini stefasab at gmail.com
Sat Mar 30 18:37:24 CET 2013


On date Saturday 2013-03-30 17:06:09 +0100, Stefano Sabatini encoded:
> 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.
> 
> I'm fine with both approaches.

Anyway before painting the bikeshed I'd like to get the work in, then
somebody more motivated than me can fill in the missing features in
case he wants all the possible permutations of more-or-less
monolithic.

Complete patchset is:
 doc: move ffmpeg-codecs.texi content to separated file
 doc: move ffmpeg-formats.texi content to separated file
 doc: move ffmpeg-devices.texi content to separated file
 doc: move ffmpeg-resampler.texi content to separated file
 doc: move ffmpeg-scaler.texi content to separated file
 doc: enable compilation of monolithic tools pages with --enable-monolithic-tools-doc

The first patches are trivial move around of documentation, from
ffmpeg-x.texi file to x.texi file.

Updated version of the last patch in attachment.
-- 
FFmpeg = Fabulous & Faithful Miracolous Puristic Erratic Gem
-------------- next part --------------
A non-text attachment was scrubbed...
Name: 0007-doc-enable-compilation-of-monolithic-tools-pages-wit.patch
Type: text/x-diff
Size: 5171 bytes
Desc: not available
URL: <http://ffmpeg.org/pipermail/ffmpeg-devel/attachments/20130330/3bb661ec/attachment.bin>


More information about the ffmpeg-devel mailing list