[docs] Logging module

[Raphael.Mankin at rbs.com]

I have just started using 'logging' and had some difficulty understanding the documentation. This was in spite of my knowing log4j, log4perl and so on.

1. It is nowhere stated that all handlers for a logger are called.
2. In http://docs.python.org/release/2.5/lib/module-logging.html the entry for basicConfig()( does not explain that 'filename' and 'stream' are mutually exclusive. This is stated elsewhere, but one has to dig for it.
3. More generally, the distinction between the convenience functions defined at 'logging' level, and the specific functions defined at 'Logger' level is not made clear in the documentation, particularly in the introductory section.
4. The introductory section talks of hierarchies of loggers but does not mention the 'propagate' flag or the idea of naming loggers after the fully qualified class name, leaving the whole hierarchical naming scheme unmotivated.

I hope this helps to improve the documentation.

Raphael Mankin
- 
RBS Global Banking & Markets
135 Bishopsgate, London, EC2M 3UR, GB
Office: +44 20 7085 9080   |  Mobile: +44 20 7085 9080 

***********************************************************************************
The Royal Bank of Scotland plc. Registered in Scotland No 90312. 
Registered Office: 36 St Andrew Square, Edinburgh EH2 2YB. 
Authorised and regulated by the Financial Services Authority. The
Royal Bank of Scotland N.V. is authorised and regulated by the 
De Nederlandsche Bank and has its seat at Amsterdam, the 
Netherlands, and is registered in the Commercial Register under 
number 33002587. Registered Office: Gustav Mahlerlaan 10, 
Amsterdam, The Netherlands. The Royal Bank of Scotland N.V. and 
The Royal Bank of Scotland plc are authorised to act as agent for each 
other in certain jurisdictions.
 
This e-mail message is confidential and for use by the addressee only.
If the message is received by anyone other than the addressee, please 
return the message to the sender by replying to it and then delete the 
message from your computer. Internet e-mails are not necessarily 
secure. The Royal Bank of Scotland plc and The Royal Bank of Scotland 
N.V. including its affiliates ("RBS group") does not accept responsibility 
for changes made to this message after it was sent. 

Whilst all reasonable care has been taken to avoid the transmission of 
viruses, it is the responsibility of the recipient to ensure that the onward
transmission, opening or use of this message and any attachments will 
not adversely affect its systems or data. No responsibility is accepted 
by the RBS group in this regard and the recipient should carry out such 
virus and other checks as it considers appropriate. 

Visit our website at www.rbs.com

***********************************************************************************