ref-manual: Applied review comments to logging mechanism section
Fixes [YOCTO #9950] I Provided a suggested introductory sentence and a better link to the logging.class file, which is near the end. (From yocto-docs rev: 6f296266b35f17792510d6a01f5640ba30818a22) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
parent
2db1d3b76d
commit
818e439cf5
|
@ -356,8 +356,8 @@
|
||||||
<section id='recipe-logging-mechanisms'>
|
<section id='recipe-logging-mechanisms'>
|
||||||
<title>Recipe Logging Mechanisms</title>
|
<title>Recipe Logging Mechanisms</title>
|
||||||
<para>
|
<para>
|
||||||
Best practices exist while writing recipes that both log build
|
The Yocto Project provides several logging functions for producing
|
||||||
progress and act on build conditions such as warnings and errors.
|
debugging output and reporting errors and warnings.
|
||||||
For Python functions, the following logging functions exist.
|
For Python functions, the following logging functions exist.
|
||||||
All of these functions log to
|
All of these functions log to
|
||||||
<filename>${T}/log.do_</filename><replaceable>task</replaceable>,
|
<filename>${T}/log.do_</filename><replaceable>task</replaceable>,
|
||||||
|
@ -411,13 +411,13 @@
|
||||||
<filename>bbplain</filename>, <filename>bbnote</filename>,
|
<filename>bbplain</filename>, <filename>bbnote</filename>,
|
||||||
<filename>bbdebug</filename>, <filename>bbwarn</filename>,
|
<filename>bbdebug</filename>, <filename>bbwarn</filename>,
|
||||||
<filename>bberror</filename>, and <filename>bbfatal</filename>.
|
<filename>bberror</filename>, and <filename>bbfatal</filename>.
|
||||||
</para>
|
The
|
||||||
|
<link linkend='ref-classes-logging'><filename>logging</filename></link>
|
||||||
<para>
|
class implements these functions.
|
||||||
For guidance on how logging is handled in both Python and Bash recipes, see the
|
See that class in the
|
||||||
<filename>logging.bbclass</filename> file in the
|
|
||||||
<filename>meta/classes</filename> folder of the
|
<filename>meta/classes</filename> folder of the
|
||||||
<ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>Source Directory</ulink>.
|
<ulink url='&YOCTO_DOCS_DEV_URL;#source-directory'>Source Directory</ulink>
|
||||||
|
for information.
|
||||||
</para>
|
</para>
|
||||||
|
|
||||||
<section id='logging-with-python'>
|
<section id='logging-with-python'>
|
||||||
|
|
Loading…
Reference in New Issue