* [PATCH] bug 9962: improve -v, -D documentation
@ 2017-03-21 20:27 Diana Thayer
2017-03-21 20:33 ` Diana Thayer
2017-03-27 17:07 ` Leonardo Sandoval
0 siblings, 2 replies; 5+ messages in thread
From: Diana Thayer @ 2017-03-21 20:27 UTC (permalink / raw)
To: bitbake-devel
Per bug-9962, expanded and clarified documentation
for -v, --verbose and -D, --debug.
Signed-off-by: Diana Thayer <garbados@gmail.com>
---
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.")
--
2.7.4
^ permalink raw reply related [flat|nested] 5+ messages in thread
* Re: [PATCH] bug 9962: improve -v, -D documentation
2017-03-21 20:27 [PATCH] bug 9962: improve -v, -D documentation Diana Thayer
@ 2017-03-21 20:33 ` Diana Thayer
2017-03-27 10:14 ` Richard Purdie
2017-03-27 17:07 ` Leonardo Sandoval
1 sibling, 1 reply; 5+ messages in thread
From: Diana Thayer @ 2017-03-21 20:33 UTC (permalink / raw)
To: bitbake-devel
[-- Attachment #1: Type: text/plain, Size: 5220 bytes --]
Hi!
I did my best to follow patch submission guidelines
<https://www.openembedded.org/wiki/How_to_submit_a_patch_to_OpenEmbedded>
and code styleguide <https://www.openembedded.org/wiki/Styleguide> but this
is my very first patch to anything in the Yocto project. Please let me know
if and how I can improve future patch submissions! I figured since it's my
first time, I would follow up and say hello :)
This patch addresses bug 9962
<https://bugzilla.yoctoproject.org/show_bug.cgi?id=9962> by updating the
documentation of bitbake's -v and -D CLI options. I copied the updated text
directly from the bug report, and changed it both in the code and in the
user manual.
Anyway hi! I hope to contribute more soon :)
On Tue, Mar 21, 2017 at 1:27 PM, Diana Thayer <garbados@gmail.com> wrote:
> Per bug-9962, expanded and clarified documentation
> for -v, --verbose and -D, --debug.
>
> Signed-off-by: Diana Thayer <garbados@gmail.com>
> ---
> 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.")
> --
> 2.7.4
>
>
[-- Attachment #2: Type: text/html, Size: 6661 bytes --]
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: [PATCH] bug 9962: improve -v, -D documentation
2017-03-21 20:33 ` Diana Thayer
@ 2017-03-27 10:14 ` Richard Purdie
0 siblings, 0 replies; 5+ messages in thread
From: Richard Purdie @ 2017-03-27 10:14 UTC (permalink / raw)
To: Diana Thayer, bitbake-devel
On Tue, 2017-03-21 at 13:33 -0700, Diana Thayer wrote:
> Hi!
>
> I did my best to follow patch submission guidelines and code
> styleguide but this is my very first patch to anything in the Yocto
> project. Please let me know if and how I can improve future patch
> submissions! I figured since it's my first time, I would follow up
> and say hello :)
>
> This patch addresses bug 9962 by updating the documentation of
> bitbake's -v and -D CLI options. I copied the updated text directly
> from the bug report, and changed it both in the code and in the user
> manual.
>
> Anyway hi! I hope to contribute more soon :)
Hi!
Thanks for taking the time to submit the patch and sorry for the delay
in getting back to you. I've just queued this in master-next for
further testing. The patch itself is great, I did have to tweak the
commit message a bit. In particular:
I added "main: " as a prefix to the shortlog since this indicates there
the change was made. I also changed the bug reference to our standard
form [YOCTO #XXXX] so that when we search commits for bug references,
its in a standard form. The commit message needs to stand alone without
someone needing to read the bug, that is there just as a useful link
for more information. All just minor formatting tweaks really though.
Cheers,
Richard
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: [PATCH] bug 9962: improve -v, -D documentation
2017-03-21 20:27 [PATCH] bug 9962: improve -v, -D documentation Diana Thayer
2017-03-21 20:33 ` Diana Thayer
@ 2017-03-27 17:07 ` Leonardo Sandoval
2017-03-30 10:11 ` Richard Purdie
1 sibling, 1 reply; 5+ messages in thread
From: Leonardo Sandoval @ 2017-03-27 17:07 UTC (permalink / raw)
To: Diana Thayer; +Cc: bitbake-devel
On Tue, 2017-03-21 at 13:27 -0700, Diana Thayer wrote:
> Per bug-9962, expanded and clarified documentation
> for -v, --verbose and -D, --debug.
>
> Signed-off-by: Diana Thayer <garbados@gmail.com>
> ---
> 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.
I think the description is fine for -D/--debug , but I am not sure if
this is the place to describe that level N includes N-1, etc.. This is
something standard, and describing here make it a bit verbose.
> -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.")
> --
> 2.7.4
>
^ permalink raw reply [flat|nested] 5+ messages in thread
* Re: [PATCH] bug 9962: improve -v, -D documentation
2017-03-27 17:07 ` Leonardo Sandoval
@ 2017-03-30 10:11 ` Richard Purdie
0 siblings, 0 replies; 5+ messages in thread
From: Richard Purdie @ 2017-03-30 10:11 UTC (permalink / raw)
To: Leonardo Sandoval, Diana Thayer; +Cc: bitbake-devel
On Mon, 2017-03-27 at 11:07 -0600, Leonardo Sandoval wrote:
> On Tue, 2017-03-21 at 13:27 -0700, Diana Thayer wrote:
> > 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_).
> > + -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.
> I think the description is fine for -D/--debug , but I am not sure if
> this is the place to describe that level N includes N-1, etc.. This
> is something standard, and describing here make it a bit verbose.
FWIW I tend to agree with you. Further patches are welcome.
Cheers,
Richard
^ permalink raw reply [flat|nested] 5+ messages in thread
end of thread, other threads:[~2017-03-30 10:11 UTC | newest]
Thread overview: 5+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2017-03-21 20:27 [PATCH] bug 9962: improve -v, -D documentation Diana Thayer
2017-03-21 20:33 ` Diana Thayer
2017-03-27 10:14 ` Richard Purdie
2017-03-27 17:07 ` Leonardo Sandoval
2017-03-30 10:11 ` Richard Purdie
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.