@@ -109,11 +109,11 @@ The ``name`` is potentially a period-separated hierarchical value, like
109
109
Loggers that are further down in the hierarchical list are children of loggers
110
110
higher up in the list. For example, given a logger with a name of ``foo ``,
111
111
loggers with names of ``foo.bar ``, ``foo.bar.baz ``, and ``foo.bam `` are all
112
- descendants of ``foo ``. The logger name hierarchy is analogous to the Python
113
- package hierarchy, and identical to it if you organise your loggers on a
114
- per-module basis using the recommended construction
115
- ``logging.getLogger(__name__) ``. That's because in a module, `` __name__ ``
116
- is the module's name in the Python package namespace.
112
+ descendants of ``foo ``. In addition, all loggers are descendants of the root
113
+ logger. The logger name hierarchy is analogous to the Python package hierarchy,
114
+ and identical to it if you organise your loggers on a per-module basis using
115
+ the recommended construction ``logging.getLogger(__name__) ``. That's because
116
+ in a module, `` __name__ `` is the module's name in the Python package namespace.
117
117
118
118
119
119
.. class :: Logger
@@ -1157,10 +1157,12 @@ functions.
1157
1157
1158
1158
.. function :: getLogger(name=None)
1159
1159
1160
- Return a logger with the specified name or, if name is ``None ``, return a
1161
- logger which is the root logger of the hierarchy. If specified, the name is
1162
- typically a dot-separated hierarchical name like *'a' *, *'a.b' * or *'a.b.c.d' *.
1163
- Choice of these names is entirely up to the developer who is using logging.
1160
+ Return a logger with the specified name or, if name is ``None ``, return the
1161
+ root logger of the hierarchy. If specified, the name is typically a
1162
+ dot-separated hierarchical name like *'a' *, *'a.b' * or *'a.b.c.d' *. Choice
1163
+ of these names is entirely up to the developer who is using logging, though
1164
+ it is recommended that ``__name__ `` be used unless you have a specific
1165
+ reason for not doing that, as mentioned in :ref: `logger `.
1164
1166
1165
1167
All calls to this function with a given name return the same logger instance.
1166
1168
This means that logger instances never need to be passed between different parts
0 commit comments