Re: Doc: Usage - new option for lilypond-book (issue4806050)

[pkx166h]

Reviewers: Graham Percival,

Message:
Pushed as

Commit 23cdda9506931d5b9a1e75ee8be8be8b74f9084a7c0

James

Description:
Doc: Usage - new option for lilypond-book

Documenting new feature made in

Commit 23cdda9506931d5b9a1e75ee8be8be8b74f9084a7c0

Also for Tracker issue 1730 adding information for 'gui' option for
windows users running lilypond-windows.exe -dgui.

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

Affected files:
  M Documentation/usage/lilypond-book.itely
  M Documentation/usage/running.itely


Index: Documentation/usage/lilypond-book.itely
diff --git a/Documentation/usage/lilypond-book.itely  
b/Documentation/usage/lilypond-book.itely
index  
9d018275ef1fa2b61426c0fbabff3f57c60d70c3..d1018be507685bbcd4dad5dc0c3988cf90bbe8c9  
100644
--- a/Documentation/usage/lilypond-book.itely
+++ b/Documentation/usage/lilypond-book.itely
@@ -959,6 +959,10 @@ Process LilyPond snippets using @var{command}.  The  
default command is
 @item --pdf
 Create PDF files for use with address@hidden

address@hidden --redirect-lilypond-output
+By default, output is displayed on the terminal.  This option redirects
+all output to log files in the same directory as the source files.
+
 @itemx --use-source-file-names
 Write snippet output files with the same base name as their source file.
 This option works only for snippets included with @code{lilypondfile}
Index: Documentation/usage/running.itely
diff --git a/Documentation/usage/running.itely  
b/Documentation/usage/running.itely
index  
4d32d67e50414b7774a0515fac05e99db828823e..f37985396305b4e121422219e400e9fe42d2922b  
100644
--- a/Documentation/usage/running.itely
+++ b/Documentation/usage/running.itely
@@ -299,6 +299,16 @@ first system of every @code{\bookpart} will appear in  
the output.
 The @code{ps}, @code{eps}, and @code{svg} backends support this
 option.

address@hidden gui
+Runs silently and redirect all output to a log file.
+
+Note to Windows users: By default @code{lilypond.exe} outputs all
+progress information to the command window, @code{lilypond-windows.exe}
+does not and returns a prompt, with no progress information, immediately
+at the command line.  The @code{-dgui} option can be used in this case
+to redirect output to a log file.
+
+
 @item print-pages
 Generate the full pages, the default.  @code{-dno-print-pages} is
 useful in combination with @code{-dpreview}.