(Optionally) embed ly source files inside generated PDF

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

diff --git a/Documentation/usage/running.itely b/Documentation/usage/running.itely
index 8ec83109257cab3caf67d76f1ea682a9ef9285ba..995119e57b061b5122dfb412a7b05e4de04c1a50 100644 (file)
--- a/Documentation/usage/running.itely
+++ b/Documentation/usage/running.itely
@@ -485,21 +485,22 @@ 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.
+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.
 @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
+By default in svg output LilyPond will use the generic
+@code{font-family} values of @code{serif}, @code{sans-serif}, or
+@code{monospace}.  Therefore, when using the backend @code{svg} command
+you should explicitly define particular default fonts in your source
 file;
 
 @quotation
@@ -579,6 +580,10 @@ 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