From: Vinay Sajip <vinay_sajip@yahoo.co.uk>
Date: Tue, 31 Aug 2004 10:21:51 +0000 (+0000)
Subject: Updated doc for getLogger()
X-Git-Tag: v2.4a3~38
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=17952b78e10818fb567c1163a67017c0e313c78b;p=thirdparty%2FPython%2Fcpython.git

Updated doc for getLogger()
---

diff --git a/Doc/lib/liblogging.tex b/Doc/lib/liblogging.tex
index daaabceebe3c..ecb3791dfb8f 100644
--- a/Doc/lib/liblogging.tex
+++ b/Doc/lib/liblogging.tex
@@ -134,7 +134,10 @@ level functions.
 
 \begin{funcdesc}{getLogger}{\optional{name}}
 Return a logger with the specified name or, if no name is specified, return
-a logger which is the root logger of the hierarchy.
+a logger which is the root logger of the hierarchy. If specified, the name
+is typically a dot-separated hierarchical name like \var{"a"}, \var{"a.b"}
+or \var{"a.b.c.d"}. Choice of these names is entirely up to the developer
+who is using logging.
 
 All calls to this function with a given name return the same logger instance.
 This means that logger instances never need to be passed between different