Author Kylotan
Recipients Kylotan
Date 2007-12-10.15:23:13
SpamBayes Score 0.0405956
Marked as misclassified No
Message-id <>
The documentation for the logging module is quite confusing, and (I am
told) seems to assume prior experience with the log4j utility or similar.

In particular:
 - the front page has a rather confusing example of the named hierarchy
system, which might mislead the reader by making them think it's about
file types (perhaps for log output) rather than just arbitrary naming
 - section 14.5.3 attempts to explain this hierarchy, but does so via an
example for something else (ie. showing logging to multiple
destinations), and is just a large code-dump, mixing several concepts in
one example.

All in all, it could just do with being a lot more explicit about how
the naming convention and the hierarchy works, how each logger relates
to children/parents, and having a more transparent example on the first
Date User Action Args
2007-12-10 15:23:14Kylotansetspambayes_score: 0.0405956 -> 0.0405956
recipients: + Kylotan
2007-12-10 15:23:14Kylotansetspambayes_score: 0.0405956 -> 0.0405956
messageid: <>
2007-12-10 15:23:14Kylotanlinkissue1579 messages
2007-12-10 15:23:13Kylotancreate