Loglevels: User documentation in AU

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

diff --git a/Documentation/usage/running.itely b/Documentation/usage/running.itely
index b4726ab6cb86142bc40cca268bb311ed6051492c..5f226c3ed82de883d5df04d591d0952112c50d51 100644 (file)
--- a/Documentation/usage/running.itely
+++ b/Documentation/usage/running.itely
@@ -8,7 +8,7 @@
     Guide, node Updating translation committishes..
 @end ignore
 
-@c \version "2.13.36"
+@c \version "2.14.0"
 
 
 @node Running lilypond
@@ -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.
 
+@item 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}.
@@ -325,6 +335,32 @@ found the search will continue in subsequent directories.
 @item -i,--init=@var{file}
 Set init file to @var{file} (default: @file{init.ly}).
 
+@cindex loglevel
+@cindex output verbosity, setting
+
+@item -l,--loglevel=@var{LEVEL}
+Set the verbosity of the console output to @var{LEVEL}. Possible values are:
+@table @code
+@item NONE
+No output at all, not even error messages.
+
+@item ERROR
+Only error messages, no warnings or progress messages.
+
+@item WARN
+Warnings and error messages, no progress.
+
+@item BASIC_PROGRESS
+Basic progress messages (success), warnings and errors.
+
+@item PROGRESS (default)
+All progress messages, warnings and errors.
+
+@item DEBUG
+All possible messages, including verbose debug output.
+@end table
+
+
 @cindex folder, directing output to
 @cindex output filename, setting
 
@@ -445,6 +481,10 @@ subdirectories called @file{ly/}, @file{ps/}, @file{tex/}, etc.
 @item LANG
 This selects the language for the warning messages.
 
+@item LILYPOND_LOGLEVEL
+The default loglevel. If LilyPond is called without an explicit loglevel (i.e.
+no @code{--loglevel} command line option), this value is used.
+
 @item LILYPOND_GC_YIELD
 A variable, as a percentage, that tunes memory management
 behavior.  A higher values means the program uses more memory, a