]> git.donarmstrong.com Git - lilypond.git/commitdiff
Doc: Add documentation for --loglevel for all python scripts
authorReinhold Kainhofer <reinhold@kainhofer.com>
Fri, 23 Sep 2011 14:07:48 +0000 (16:07 +0200)
committerReinhold Kainhofer <reinhold@kainhofer.com>
Fri, 23 Sep 2011 14:08:19 +0000 (16:08 +0200)
Documentation/usage/external.itely
Documentation/usage/lilypond-book.itely
Documentation/usage/updating.itely

index f3a3b0948193cc3fdc4d4b944b708789d3d53636..a8c087db19503b9f371efd29b9c002a3d8d054d1 100644 (file)
@@ -341,6 +341,10 @@ print usage and option summary.
 @item -l, --language=LANG
 use LANG for pitch names, e.g. 'deutsch' for note names in German.
 
+@item --loglevel=@var{loglevel}
+Set the output verbosity to @var{loglevel}. Possible values are @code{NONE},
+@code{ERROR}, @code{WARNING}, @code{PROGRESS} (default) and @code{DEBUG}.
+
 @item --lxml
 use the lxml.etree Python package for XML-parsing; uses less memory and cpu time.
 
index 1cc7daf52f4052fc3234e45e4f4caeccf7059502..2b00f57cc4d126000ea5bcc09bc6c61cd4a17632 100644 (file)
@@ -974,6 +974,13 @@ them back to the output directory, so in some cases it is necessary to
 invoke further processing commands such as @command{makeinfo} or
 @command{latex} with the same @option{-I @var{dir}} options.
 
+@item -l @var{loglevel}
+@itemx --loglevel=@var{loglevel}
+Set the output verbosity to @var{loglevel}. Possible values are @code{NONE},
+@code{ERROR}, @code{WARNING}, @code{PROGRESS} (default) and @code{DEBUG}. If
+this option is not used, and the environment variable
+@code{LILYPOND_BOOK_LOGLEVEL} is set, its value is used as the loglevel.
+
 @item -o @var{dir}
 @itemx --output=@var{dir}
 Place generated files in directory @var{dir}.  Running
@@ -1001,6 +1008,14 @@ Write lily-XXX files to directory @var{dir}, link into @option{--output}
 directory.  Use this option to save building time for documents in
 different directories which share a lot of identical snippets.
 
+@itemx --lily-loglevel=@var{loglevel}
+Set the output verbosity of the invoked @command{lilypond} calls to @var{loglevel}.
+Possible values are @code{NONE}, @code{ERROR}, @code{WARNING}, @code{BASIC_PROGRESS},
+@code{PROGRESS}, @code{INFO} (default) and @code{DEBUG}. If
+this option is not used, and the environment variable
+@code{LILYPOND_LOGLEVEL} is set, its value is used as the loglevel.
+
+
 @itemx --info-images-dir=@var{dir}
 Format Texinfo output so that Info will look for images of music in
 @var{dir}.
@@ -1041,13 +1056,16 @@ and only if directories implied by @option{--output-dir} and
 
 @item -V
 @itemx --verbose
-Be verbose.
+Be verbose. This is equivalent to @code{--loglevel=DEBUG}.
 
 @item -v
 @itemx --version
 Print version information.
 @end table
 
+
+In addition, @command{lilypond-book}
+
 @knownissues
 
 The Texinfo command @code{@@pagesizes} is not interpreted.  Similarly,
index 8bb8cef9260a059ecbdd2b83a14ecf9e3593293e..7f4afa85463391b6421d6ab42b66bf70797e9394 100644 (file)
@@ -147,6 +147,11 @@ available version.  E.g. @option{--to=2.12.2}
 
 @item -h, --help
 Print usage help.
+
+@item -l @var{loglevel}, --loglevel=@var{loglevel}
+Set the output verbosity to @var{loglevel}. Possible values are @code{NONE},
+@code{ERROR}, @code{WARNING}, @code{PROGRESS} (default) and @code{DEBUG}.
+
 @end table
 
 To upgrade LilyPond fragments in texinfo files, use