X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2Fuser%2Frunning.itely;h=ecae5f9e82f381a727e245e1193064fd049b7ed0;hb=38d7d319eabc906e82fb42002678c6d42a23b6f7;hp=0bbd4d14bb75befa94fc4b698639a762658b2e33;hpb=5c14a087ca6cbd665fd631452b7b1283ba0387c3;p=lilypond.git diff --git a/Documentation/user/running.itely b/Documentation/user/running.itely index 0bbd4d14bb..ecae5f9e82 100644 --- a/Documentation/user/running.itely +++ b/Documentation/user/running.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" @node Running LilyPond @@ -89,9 +89,9 @@ number. An input file containing @example #(define output-suffix "violin") -\book @{ @dots{} @} +\score @{ @dots{} @} #(define output-suffix "cello") -\book @{ @dots{} @} +\score @{ @dots{} @} @end example @noindent @@ -130,7 +130,7 @@ at the top of the @code{.ly} file. @item -f,--format=@var{format} which formats should be written. Choices for @code{format} are -@code{svg}, @code{ps}, @code{pdf}, @code{png}, @code{tex}, @code{dvi}. +@code{svg}, @code{ps}, @code{pdf}, and @code{png}. Example: @code{lilypond -fpng @var{filename}.ly} @@ -208,20 +208,13 @@ The safe mode will prevent many useful LilyPond snippets from being compiled. The @code{--jail} is a more secure alternative, but requires more work to set up. +@cindex output format, setting @item backend the output format to use for the back-end. Choices for @code{format} are @table @code -@item tex -for @TeX{} output, to be processed with La@TeX{}. If present, the file -@file{file.textmetrics} is read to determine text extents. -@item texstr -dump text strings to @file{.texstr} file, which can be run through -(La)@TeX{}, resulting in a @code{.textmetrics} file, which contains the -extents of strings of text. @strong{Warning:} this functionality is -currently missing due to heavy restructuring of the source code. @item ps - for PostScript. @cindex PostScript output + for PostScript. Postscript files include TTF, Type1 and OTF fonts. No subsetting of these fonts is done. When using oriental character sets, this can @@ -235,23 +228,24 @@ all pages (systems) including fonts. This mode is used by default by @command{lilypond-book}. @item svg +@cindex SVG (Scalable Vector Graphics) for SVG (Scalable Vector Graphics). This dumps every page as a separate @file{SVG} file, with embedded fonts. -@cindex SVG (Scalable Vector Graphics) You need a SVG viewer which supports embedded fonts, or a SVG viewer which is able to replace the embedded fonts with OTF fonts. Under UNIX, you may use @uref{http://www.inkscape.org,Inkscape} (version 0.42 or later), after copying the OTF fonts from the LilyPond directory (typically @file{/usr/share/lilypond/VERSION/fonts/otf/}) to @file{~/.fonts/}. @item scm - for a dump of the raw, internal Scheme-based drawing commands. @cindex Scheme dump + for a dump of the raw, internal Scheme-based drawing commands. + +@item null + do not output a printed score; has the same effect as @code{-dno-print-pages}. @end table Example: @code{lilypond -dbackend=svg @var{filename}.ly} -@cindex output format, setting - @item preview Generate an output file containing the titles and the first system @@ -279,16 +273,11 @@ Set init file to @var{file} (default: @file{init.ly}). @item -o,--output=@var{FILE} Set the default output file to @var{FILE}. The appropriate -suffix will be added (i.e. @code{.pdf} for pdf, @code{.tex} -for tex, etc). +suffix will be added (e.g. @code{.pdf} for pdf) @item --ps Generate PostScript. -@item --dvi -Generate DVI files. In this case, the @TeX{} backend should be -specified, i.e., @code{-dbackend=tex}. - @item --png Generate pictures of each page, in PNG format. This implies @code{--ps}. The resolution in DPI of the image may be set with