lilypond-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: building sections of the docs


From: John Mandereau
Subject: Re: building sections of the docs
Date: Sun, 06 Jan 2008 13:40:11 +0100

Le dimanche 06 janvier 2008 à 03:06 -0700, Paul Scott a écrit :
> Hi Graham or anyone who knows,
> 
> Can I build just pitches.itely portion of the doc's?  If so how?

No, but you can build/clean only stuff in Documentation/user (or any
directory with docs) with these (mostly undocumented) incantations:

make out=www WWW  # build all docs, and process subdirs recursively
make out=www local-WWW  # idem but restrict to current directory
make out=www clean # rm -rf out-www (in all subdirs too), no local- flavor 
available

To force rebuild the docs without cleaning everything (and avoiding
rebuilding all ly snippets, which is the most time-consuming step), do a
partial clean with

find -wholename '*out-www/*.html' -delete

before rebuilding. In Doc/user, this makes rebuilding PDFs too, but in
some other dirs, you need to delete PDFs too to trigger rebuilding PDFs
(strange, isn't it?).

Of course you can choose to make only a specific target, have a look at
Documentation/user/GNUmakefile.

All these commands make docs available in out-www subdirs, to get the
docs with final postprocessing steps in
(top-src-dir)/out-www/offline-root, do at top of the source tree

make out=www local-WWW-post

HTH,
John





reply via email to

[Prev in Thread] Current Thread [Next in Thread]