Issue 5166/2: Doc: Delete note for svg backend which become unnecessary

[lilypond.git] / Documentation / usage / running.itely

diff --git a/Documentation/usage/running.itely b/Documentation/usage/running.itely
index 3f13f7c17d1c78f106879a9bce7777a9956a7099..4eeabc80dc587e6c033cebe160b6d8e66ffe3bb5 100644 (file)
--- a/Documentation/usage/running.itely
+++ b/Documentation/usage/running.itely
@@ -246,6 +246,10 @@ which formats should be written.  Choices for @code{format} are
 
 Example: @code{lilypond -fpng @var{filename}.ly}
 
 
 Example: @code{lilypond -fpng @var{filename}.ly}
 

+@noindent
+For @code{svg} and @code{eps} formats use the @code{-dbackend} option.
+See @ref{Advanced command line options for LilyPond}.
+

 @item -h, --help
 Show a summary of usage.
 
 @item -h, --help
 Show a summary of usage.
 


@@ -466,12 +470,12 @@ can lead to very large file sizes.
 @tab @code{eps}
 @tab Used as default by the @command{lilypond-book} command.  This dumps
 every page as both a single file with all pages and fonts included and
 @tab @code{eps}
 @tab Used as default by the @command{lilypond-book} command.  This dumps
 every page as both a single file with all pages and fonts included and

-as separate encapsulated postscipt files for each page but without fonts
+as separate encapsulated postscript files for each page but without fonts

 included.
 
 @item
 @tab @code{null}
 included.
 
 @item
 @tab @code{null}

-@tab Do not output a printed score.  This the same effect as
+@tab Do not output a printed score.  This has the same effect as

 @code{-dno-print-pages}.
 
 @item
 @code{-dno-print-pages}.
 
 @item


@@ -481,38 +485,15 @@ included.
 @item
 @tab @code{svg}
 @tab Scalable Vector Graphics.
 @item
 @tab @code{svg}
 @tab Scalable Vector Graphics.

-A single SVG file is created for every page of output.  Apart from
-LilyPond's own music glyphs, no other font information will be included.
-Any SVG viewer will therefore require the fonts be available to it for
-the proper rendering of both text and lyrics.  It is recommended to not
-to use font @q{aliases} or @q{lists} in case the SVG viewer is unable to
-handle them.  When using @emph{Web Open Font Format} (WOFF) files the
-additional @code{--svg-woff} switch is required.
-@end multitable
-
-@noindent
-@strong{Note for backend svg output:}
-LilyPond's default fonts (@code{LilyPond Serif},
-@code{LilyPond Sans Serif} and @code{LilyPond Monospace}) are just
-@emph{local} font aliases.  Therefore, when using the backend @code{svg}
-command you must explicitly define the default fonts in your source
-file;
+A single SVG file is created for every page of output.  Music glyphs
+are encoded as vector graphics, but text fonts are @emph{not} embedded
+in the SVG files.  Any SVG viewer will therefore need the relevant text
+fonts to be available to it for proper rendering of both text and
+lyrics.  It is recommended to not use font @q{lists} or @q{aliases}
+in case an SVG viewer is unable to handle them.  When using
+@emph{Web Open Font Format} (WOFF) files the additional
+@code{--svg-woff} switch is required.

 
 

-@quotation
-@verbatim
-\paper  {
-  #(define fonts
-    (make-pango-font-tree "TeX Gyre Schola"
-                          "TeX Gyre Heros"
-                          "TeX Gyre Cursor"
-                          (/ staff-height pt 20)))
-}
-@end verbatim
-@end quotation
-
-Also see @ruser{Entire document fonts}.
-
-@multitable @columnfractions .33 .16 .51

 @item @code{check-internal-types}
 @tab @code{#f}
 @tab Check every property assignment for types.
 @item @code{check-internal-types}
 @tab @code{#f}
 @tab Check every property assignment for types.


@@ -575,11 +556,19 @@ compilation.
 @tab @code{#f}
 @tab Dump output signatures of each system. Used for regression testing.
 
 @tab @code{#f}
 @tab Dump output signatures of each system. Used for regression testing.
 

+@item @code{embed-source-code}
+@tab @code{#f}
+@tab Embed the LilyPond source files inside the generated PDF document.
+

 @item @code{eps-box-padding}
 @tab @code{#f}
 @tab Pad left edge of the output EPS bounding box by the given amount
 (in mm).
 
 @item @code{eps-box-padding}
 @tab @code{#f}
 @tab Pad left edge of the output EPS bounding box by the given amount
 (in mm).
 

+@item @code{font-export-dir}
+@tab @code{#f [dir]}
+@tab Directory for exporting fonts as PostScript files.
+

 @item @code{gs-load-fonts}
 @tab @code{#f}
 @tab Load fonts via Ghostscript.
 @item @code{gs-load-fonts}
 @tab @code{#f}
 @tab Load fonts via Ghostscript.


@@ -588,6 +577,10 @@ compilation.
 @tab @code{#f}
 @tab Load only the LilyPond fonts via Ghostscript.
 
 @tab @code{#f}
 @tab Load only the LilyPond fonts via Ghostscript.
 

+@item @code{gs-never-embed-fonts}
+@tab @code{#f}
+@tab Make Ghostscript embed only TrueType fonts and no other font format.
+

 @item @code{gui}
 @tab @code{#f}
 @tab Runs silently and redirect all output to a log file.
 @item @code{gui}
 @tab @code{#f}
 @tab Runs silently and redirect all output to a log file.


@@ -1199,8 +1192,7 @@ staves are introduced in parallel, i.e. simultaneously:
 @end lilypond
 
 @node Warning this voice needs a voiceXx or shiftXx setting
 @end lilypond
 
 @node Warning this voice needs a voiceXx or shiftXx setting

-@unnumberedsubsec Warning this voice needs a @code{@bs{}voiceXx}
- or @code{@bs{}shiftXx} setting
+@unnumberedsubsec Warning this voice needs a @code{@bs{}voiceXx} or @code{@bs{}shiftXx} setting

 
 If notes from two different voices with stems in the same direction
 occur at the same musical moment, but the voices have no
 
 If notes from two different voices with stems in the same direction
 occur at the same musical moment, but the voices have no