Re: AU: Updated CLI preview option for lilypond (issue 5716056)

[pkx166h]

Reviewers: dak,

Message:


Description:
AU: Updated CLI preview option for lilypond

Issue 2327

Reworded section on 'preview' based on Eluze's suggestion.

Please review this at http://codereview.appspot.com/5716056/

Affected files:
  M Documentation/usage/running.itely


Index: Documentation/usage/running.itely
diff --git a/Documentation/usage/running.itely  
b/Documentation/usage/running.itely
index  
82d804c839f48019cf0898e0f9580df16975ec94..871f52e8764dd0bd1a41be9e4dc0f08a9f5be83f  
100644
--- a/Documentation/usage/running.itely
+++ b/Documentation/usage/running.itely
@@ -273,13 +273,15 @@ Example: @code{lilypond -dbackend=svg  
@var{filename}.ly}
 @cindex preview, command line

 This option is supported by all backends; @code{pdf}, @code{png},
address@hidden, @code{eps} and @code{svg}, but not @code{scm} and generates
-an output file containing the titles and the first system of music.  If
address@hidden blocks are used, the titles and first system of every
address@hidden will appear in the output.
-
-An additional file in the form @code{myFile.preview.extension} is
-generated, to avoid this use the additional @option{-dprint-pages} or
address@hidden, @code{eps} and @code{svg}, but not @code{scm}.  It generates
+an output file, in the form @code{myFile.preview.extension}, containing
+the titles and the first system of music.  If @code{\book} or
address@hidden blocks are used, the titles of @code{\book},
address@hidden or @code{\score} will appear in the output, including
+the first system of every @code{\score} block if the @code{\paper}
+variable @code{print-all-headers} is set to @code{#t}.
+
+To suppress the usual output, use the @option{-dprint-pages} or
 @option{-dno-print-pages} options according to your requirements.

 @item gui