Re: Doc: Usage - Update svg & svg-woff backend text (issue 274260043 by address@hidden)

[pkx166h]

Reviewers: trueroad,

Description:
Doc: Usage - Update svg & svg-woff backend text

Issue 4650

Update explanation so as to
inform the user that they will
need to make sure that the font/
WOFF font file information for
anything other than LP Music glyphs
are not included and need to be
'made available' to the SVG viewer
separately.

Please review this at https://codereview.appspot.com/274260043/

Affected files (+14, -12 lines):
  M Documentation/usage/running.itely


Index: Documentation/usage/running.itely
diff --git a/Documentation/usage/running.itely  
b/Documentation/usage/running.itely
index  
f072d3648e74734f5a3815706702c9e07beb6995..15421f9622bec75ecbffe28ff856be2c4388a0c7  
100644
--- a/Documentation/usage/running.itely
+++ b/Documentation/usage/running.itely
@@ -478,12 +478,13 @@ file with all pages (systems) including fonts.  Used  
as default by
 @item
 @tab @code{svg}
 @tab Scalable Vector Graphics.
-This creates a single SVG file for every page of output.
-Font information is not embedded so the SVG viewer will require
-the fonts be available for optimal rendering.
-It is recommended that you do not use @q{font aliases}
-or @q{font lists} in case your SVG viewer is not able to handle them.
-Also see the @code{svg-woff} option.
+A single SVG file is created for every page of output.  Apart from
+LilyPond's own music glyphs, any other font information will not
+be included.  The SVG viewer will therefore require the fonts be
+available to it for proper rendering of text and lyrics.  It is also
+recommended not to use any font @q{aliases} or @q{lists} in case the SVG
+viewer cannot handle them.  For @emph{Web Open Font Format} (WOFF) file
+use the @code{svg-woff} option.
 @end multitable

 @noindent
@@ -773,12 +774,13 @@ size increases in PDF files.

 @item @code{svg-woff}
 @tab @code{#f}
address@hidden Use woff font files in SVG backend.
-By using the woff file properly,
-you do not have to install the fonts which are used by SVG files
-to SVG viewer environment.
-However, LilyPond does not contain woff font file for text.
-woff font file is required.
address@hidden Use Web Open Font Format (WOFF) font files in the SVG backend.
+A single SVG file is created for every page of output.  Apart from
+LilyPond's own music glyphs, any other WOFF font will not be included.
+The SVG viewer will therefore require WOFF fonts to be available to it
+for proper rendering of text and lyrics.  It is also recommended not to
+use any font @q{aliases} or @q{lists} in case the SVG viewer cannot
+handle them.  For other font format files use the @code{svg} option.

 @item @code{trace-memory-frequency}
 @tab @code{#f}