]> git.donarmstrong.com Git - lilypond.git/blobdiff - Documentation/usage/running.itely
Issue 5166/2: Doc: Delete note for svg backend which become unnecessary
[lilypond.git] / Documentation / usage / running.itely
index 8ec83109257cab3caf67d76f1ea682a9ef9285ba..4eeabc80dc587e6c033cebe160b6d8e66ffe3bb5 100644 (file)
@@ -485,38 +485,15 @@ included.
 @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;
-
-@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}.
+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.
 
-@multitable @columnfractions .33 .16 .51
 @item @code{check-internal-types}
 @tab @code{#f}
 @tab Check every property assignment for types.
@@ -579,11 +556,19 @@ compilation.
 @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{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.
@@ -592,6 +577,10 @@ compilation.
 @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.