From: Reinhold Kainhofer <reinhold@kainhofer.com>
Date: Fri, 23 Sep 2011 14:07:48 +0000 (+0200)
Subject: Doc: Add documentation for --loglevel for all python scripts
X-Git-Tag: release/2.15.13-1~19
X-Git-Url: https://git.donarmstrong.com/?a=commitdiff_plain;h=2aeac5e3815effa47427dad86d6be811c7b0d8a2;p=lilypond.git

Doc: Add documentation for --loglevel for all python scripts
---

diff --git a/Documentation/usage/external.itely b/Documentation/usage/external.itely
index f3a3b09481..a8c087db19 100644
--- a/Documentation/usage/external.itely
+++ b/Documentation/usage/external.itely
@@ -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.
 
diff --git a/Documentation/usage/lilypond-book.itely b/Documentation/usage/lilypond-book.itely
index 1cc7daf52f..2b00f57cc4 100644
--- a/Documentation/usage/lilypond-book.itely
+++ b/Documentation/usage/lilypond-book.itely
@@ -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,
diff --git a/Documentation/usage/updating.itely b/Documentation/usage/updating.itely
index 8bb8cef926..7f4afa8546 100644
--- a/Documentation/usage/updating.itely
+++ b/Documentation/usage/updating.itely
@@ -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