[issue1579] logging documentation is unclear

2008-03-29 Thread Vinay Sajip
Vinay Sajip <[EMAIL PROTECTED]> added the comment: In your original submission, you said: "... 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 arbitrar

[issue1579] logging documentation is unclear

2008-03-29 Thread Kylotan
Kylotan <[EMAIL PROTECTED]> added the comment: I think I gave some pretty clear details in my original submission. A better example on the front page is needed rather than one that could be confused with output methods. The example in 14.5.3 needs to not be one big code dump with no explanation o

[issue1579] logging documentation is unclear

2008-03-28 Thread Vinay Sajip
Vinay Sajip <[EMAIL PROTECTED]> added the comment: I don't believe that the logging documentation is particularly unclear, though of course it could always be improved, like most other documentation ;-) It certainly does not rely on prior experience of log4j; though some of the concepts are simi

[issue1579] logging documentation is unclear

2008-01-28 Thread Christian Heimes
Changes by Christian Heimes: -- keywords: +easy priority: -> normal type: -> rfe versions: +Python 2.6 -Python 2.5 __ Tracker <[EMAIL PROTECTED]> __ _

[issue1579] logging documentation is unclear

2007-12-10 Thread Facundo Batista
Facundo Batista added the comment: Do you think that can came up with a patch for this? Just the paragraphs better written, or a better example, that would be great! Thanks! -- nosy: +facundobatista __ Tracker <[EMAIL PROTECTED]>

[issue1579] logging documentation is unclear

2007-12-10 Thread Kylotan
New submission from Kylotan: 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 rea