[Python-bugs-list] [ python-Bugs-647387 ] Minor corrections to "What's new in 2.3"

[noreply@sourceforge.net]

Bugs item #647387, was opened at 2002-12-03 00:26
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=647387&group_id=5470

Category: Documentation
Group: Python 2.3
Status: Open
Resolution: None
Priority: 5
Submitted By: Vinay Sajip (vsajip)
Assigned to: Nobody/Anonymous (nobody)
Summary: Minor corrections to "What's new in 2.3"

Initial Comment:
Many thanks for the section "PEP 282: The logging 
Package" in "What's New in Python 2.3". It's a great 
introduction to the package - clear and concise.

Some minor corrections/clarifications:

The root logger is named "root" in the implementation, 
but it cannot be accessed by logging.getLogger("root") 
which would return a different non-root logger 
named "root". The correct way of getting the root logger 
is logging.getLogger("") or logging.getLogger(None). It's 
a bit of a wart, but naming the root logger as "" (which I 
thought of doing) would show an empty logger name in 
logging output when formatted with %(name)s, which I 
thought might be confusing. I'm not sure how to resolve 
it, but for now perhaps you could omit the clause 'with 
the name "root"' in the last sentence of paragraph 2?

In the first lot of logging output shown, the warning 
message should be "WARN:root:Warning: config file 
server.conf not found" (the filename is missing in your 
example).

In the penultimate paragraph, the propagate value 
should be false rather than true (if you want to prevent 
propagation up the logger hierarchy).

Thanks & Regards, Vinay Sajip

----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=647387&group_id=5470