Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

Commit 7ba4978

Browse filesBrowse files
authored
Merge pull request #24926 from meeseeksmachine/auto-backport-of-pr-24925-on-v3.7.x
Backport PR #24925 on branch v3.7.x (DOC: Improve documentation for set_loglevel)
2 parents cef02fd + 6750316 commit 7ba4978
Copy full SHA for 7ba4978

File tree

Expand file treeCollapse file tree

1 file changed

+13
-2
lines changed
Filter options
Expand file treeCollapse file tree

1 file changed

+13
-2
lines changed

‎lib/matplotlib/__init__.py

Copy file name to clipboardExpand all lines: lib/matplotlib/__init__.py
+13-2Lines changed: 13 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -247,12 +247,22 @@ def _ensure_handler():
247247

248248
def set_loglevel(level):
249249
"""
250-
Set Matplotlib's root logger and root logger handler level, creating
251-
the handler if it does not exist yet.
250+
Configure Matplotlib's logging levels.
251+
252+
Matplotlib uses the standard library `logging` framework under the root
253+
logger 'matplotlib'. This is a helper function to:
254+
255+
- set Matplotlib's root logger level
256+
- set the root logger handler's level, creating the handler
257+
if it does not exist yet
252258
253259
Typically, one should call ``set_loglevel("info")`` or
254260
``set_loglevel("debug")`` to get additional debugging information.
255261
262+
Users or applications that are installing their own logging handlers
263+
may want to directly manipulate ``logging.getLogger('matplotlib')`` rather
264+
than use this function.
265+
256266
Parameters
257267
----------
258268
level : {"notset", "debug", "info", "warning", "error", "critical"}
@@ -263,6 +273,7 @@ def set_loglevel(level):
263273
The first time this function is called, an additional handler is attached
264274
to Matplotlib's root handler; this handler is reused every time and this
265275
function simply manipulates the logger and handler's level.
276+
266277
"""
267278
_log.setLevel(level.upper())
268279
_ensure_handler().setLevel(level.upper())

0 commit comments

Comments
0 (0)
Morty Proxy This is a proxified and sanitized view of the page, visit original site.