X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fuser%2Flilypond-book.itely;h=1c46d4a1aebcfe977fb6195bc632dd8a7e9c6ed7;hb=84dfa31321b6f0c3224ed8c586b64ec97e88402f;hp=f0af1fcf1706209bb3712cefe55c24152ec9504a;hpb=dcb2c123433b93c48e9305700d15f3649a9a8004;p=lilypond.git diff --git a/Documentation/user/lilypond-book.itely b/Documentation/user/lilypond-book.itely index f0af1fcf17..1c46d4a1ae 100644 --- a/Documentation/user/lilypond-book.itely +++ b/Documentation/user/lilypond-book.itely @@ -635,8 +635,8 @@ If @code{verbatim} is used in a @code{lilypondfile} command, it is possible to enclose verbatim only a part of the source file. If the source file contain a comment containing @samp{begin verbatim} (without quotes), quoting the source in the verbatim block will start after the -last occurence of such a comment; similarly, quoting the source verbatim -will stop just before the first occurence of a comment containing +last occurrence of such a comment; similarly, quoting the source verbatim +will stop just before the first occurrence of a comment containing @samp{end verbatim}, it there is any. In the following source file example, the music will be interpreted in relative mode, but the verbatim quote will not show the @code{relative} block, i.e. @@ -656,6 +656,10 @@ will be printed with a verbatim block like f2 e @end example +@item addversion +(Only for Texinfo output.) Prepend line @code{\version +@@w@{"@@version@{@}"@}} to @code{verbatim} output. + @item texidoc (Only for Texinfo output.) If @command{lilypond} is called with the @option{--header=@/texidoc} option, and the file to be processed is @@ -700,8 +704,9 @@ useful if you want to @code{quote} the music snippet but not the @item printfilename If a LilyPond input file is included with @code{\lilypondfile}, print -the file name right before the music snippet. For HTML output, this is -a link. +the file name right before the music snippet. For HTML output, this +is a link. Only the base name of the file is printed, i.e. the +directory part of the file path is stripped. @item fontload This option includes fonts in all of the generated EPS-files for this @@ -817,7 +822,11 @@ Print a short help message. @item -I @var{dir} @itemx --include=@var{dir} -Add @var{dir} to the include path. +Add @var{dir} to the include path. @command{lilypond-book} also looks +for already compiled snippets in the include path, and does not write +them back to the output directory, so in some cases it is necessary to +invoke further processing commands such as @command{makeinfo} or +@command{latex} with the same @code{-I @var{dir}} options. @item -o @var{dir} @itemx --output=@var{dir} @@ -834,7 +843,7 @@ cd out @end example @itemx --left-padding=@var{amount} -Pad EPS boxes by this much. @var{amount} is measured in milimeters, +Pad EPS boxes by this much. @var{amount} is measured in millimeters, and is 3.0 by default. This option should be used if the lines of music stick out of the right margin.