Re: [PATCH] bug 9962: improve -v, -D documentation

[Richard Purdie <richard.purdie@linuxfoundation.org>]

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