X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fuser%2Flilypond-book.itely;h=9d166bb43d631f64301dd762cb20ee7e30817a6e;hb=b97565a9af1c13369ac7e7e9ea80c2638dbc0e51;hp=34ebeab922260505c74f22cea8e360239100267b;hpb=5e9d78f917081510be42811a2cfa2a4a3bedd1f6;p=lilypond.git diff --git a/Documentation/user/lilypond-book.itely b/Documentation/user/lilypond-book.itely index 34ebeab922..9d166bb43d 100644 --- a/Documentation/user/lilypond-book.itely +++ b/Documentation/user/lilypond-book.itely @@ -7,7 +7,7 @@ version that you are working on. See TRANSLATION for details. @end ignore -@c \version "2.11.61" +@c \version "2.12.0" @c Note: keep this node named so that `info lilypond-book' brings you here. @node LilyPond-book @@ -255,7 +255,7 @@ use the @code{line-width} music fragment option. Each snippet will call the following macros if they have been defined by the user: -@itemize bullet +@itemize @bullet @item @code{\preLilyPondExample} called before the music, @item @code{\postLilyPondExample} called after the music, @@ -306,7 +306,7 @@ output. In @LaTeX{}, define @code{\betweenLilyPondSystem} in such a way that inclusion of other systems is terminated once the required number of -systems are included. Since @code{\betweenLilypondSystem} is first +systems are included. Since @code{\betweenLilyPondSystem} is first called @emph{after} the first system, including only the first system is trivial. @@ -359,6 +359,7 @@ and then saying only how many systems you want before each fragment, \begin@{lilypond@}...\end@{lilypond@} @end example + @seealso There are specific @command{lilypond-book} command line options and other details to know when processing @LaTeX{} documents, see @@ -573,11 +574,6 @@ For single-line snippets, allow the staff length to be stretched to equal that of the line width, i.e., @code{ragged-right = ##f} is added to the LilyPond snippet. -@c does this option still exist in lilypond? -jm -@item packed -Produce lines with packed spacing, i.e., @code{packed = ##t} is added -to the LilyPond snippet. - @item line-width @itemx line-width=@var{size}\@var{unit} Set line width to @var{size}, using @var{unit} as units. @var{unit} is @@ -678,6 +674,13 @@ will be printed with a verbatim block like f2 e @end example +@noindent +If you would like to translate comments and variable names in verbatim +output but not in the sources, you may set the environment variable +@code{LYDOC_LOCALEDIR} to a directory path; the directory should +contain a tree of @file{.mo} message catalogs with @code{lilypond-doc} +as a domain. + @item addversion (Only for Texinfo output.) Prepend line @code{\version @@w@{"@@version@{@}"@}} to @code{verbatim} output. @@ -710,8 +713,8 @@ and we have this in our Texinfo document @file{test.texinfo} the following command line gives the expected result @example -lilypond-book --process="lilypond --format=tex --tex \ - --header=texidoc test.texinfo +lilypond-book --pdf --process="lilypond \ + -dbackend=eps --header=texidoc" test.texinfo @end example Most LilyPond test documents (in the @file{input} directory of the @@ -744,6 +747,10 @@ Texinfo document as @code{@@lydoctitle @var{text}}. The same remark about @code{texidoc} processing with localized languages also applies to @code{doctitle}. +@item nogettext +(Only for Texinfo output.) Do not translate comments and variable +names in the snippet quoted verbatim. + @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