[oe-commits] [bitbake] 04/04: main: Improve -v and -D option documentation
git at git.openembedded.org
git at git.openembedded.org
Mon Mar 27 10:16:47 UTC 2017
This is an automated email from the git hooks/post-receive script.
rpurdie pushed a commit to branch master-next
in repository bitbake.
commit 921592026c69287cdb40ffd90944d5944f28e2c3
Author: Diana Thayer <garbados at gmail.com>
AuthorDate: Tue Mar 21 13:27:05 2017 -0700
main: Improve -v and -D option documentation
Expanded and clarify documentation for the -v, --verbose and -D, --debug
options.
[YOCTO #9962]
Signed-off-by: Diana Thayer <garbados at gmail.com>
Signed-off-by: Richard Purdie <richard.purdie at linuxfoundation.org>
---
doc/bitbake-user-manual/bitbake-user-manual-intro.xml | 16 +++++++++++++---
lib/bb/main.py | 15 +++++++++++++--
2 files changed, 26 insertions(+), 5 deletions(-)
diff --git a/doc/bitbake-user-manual/bitbake-user-manual-intro.xml b/doc/bitbake-user-manual/bitbake-user-manual-intro.xml
index 7248a0b..5bbfc67 100644
--- a/doc/bitbake-user-manual/bitbake-user-manual-intro.xml
+++ b/doc/bitbake-user-manual/bitbake-user-manual-intro.xml
@@ -504,9 +504,19 @@
Read the specified file before bitbake.conf.
-R POSTFILE, --postread=POSTFILE
Read the specified file after bitbake.conf.
- -v, --verbose Output more log message data to the terminal.
- -D, --debug Increase the debug level. You can specify this more
- than once.
+ -v, --verbose Enable tracing of shell tasks (with 'set -x').
+ Also print bb.note(...) messages to stdout (in
+ addition to writing them to ${T}/log.do_<task>).
+ -D, --debug Increase the debug level. You can specify this
+ more than once. -D sets the debug level to 1,
+ where only bb.debug(1, ...) messages are printed
+ to stdout; -DD sets the debug level to 2, where
+ both bb.debug(1, ...) and bb.debug(2, ...)
+ messages are printed; etc. Without -D, no debug
+ messages are printed. Note that -D only affects
+ output to stdout. All debug messages are written
+ to ${T}/log.do_taskname, regardless of the debug
+ level.
-n, --dry-run Don't execute, just go through the motions.
-S SIGNATURE_HANDLER, --dump-signatures=SIGNATURE_HANDLER
Dump out the signature construction information, with
diff --git a/lib/bb/main.py b/lib/bb/main.py
index b3cd2cf..8c948c2 100755
--- a/lib/bb/main.py
+++ b/lib/bb/main.py
@@ -174,10 +174,21 @@ class BitBakeConfigParameters(cookerdata.ConfigParameters):
help="Read the specified file after bitbake.conf.")
parser.add_option("-v", "--verbose", action="store_true", dest="verbose", default=False,
- help="Output more log message data to the terminal.")
+ help="Enable tracing of shell tasks (with 'set -x'). "
+ "Also print bb.note(...) messages to stdout (in "
+ "addition to writing them to ${T}/log.do_<task>).")
parser.add_option("-D", "--debug", action="count", dest="debug", default=0,
- help="Increase the debug level. You can specify this more than once.")
+ help="Increase the debug level. You can specify this "
+ "more than once. -D sets the debug level to 1, "
+ "where only bb.debug(1, ...) messages are printed "
+ "to stdout; -DD sets the debug level to 2, where "
+ "both bb.debug(1, ...) and bb.debug(2, ...) "
+ "messages are printed; etc. Without -D, no debug "
+ "messages are printed. Note that -D only affects "
+ "output to stdout. All debug messages are written "
+ "to ${T}/log.do_taskname, regardless of the debug "
+ "level.")
parser.add_option("-q", "--quiet", action="count", dest="quiet", default=0,
help="Output less log message data to the terminal. You can specify this more than once.")
--
To stop receiving notification emails like this one, please contact
the administrator of this repository.
More information about the Openembedded-commits
mailing list