-
-
Notifications
You must be signed in to change notification settings - Fork 7.9k
Numpydocify setp. #18686
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Numpydocify setp. #18686
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks for the cleanup!
I will ask for minor change, either explicitly state that file
is forwarded to print
or else let the user know what None
means.
lib/matplotlib/artist.py
Outdated
file : file-like or None, default: `sys.stdout` | ||
Where `setp` writes its output, e.g. :: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This defaults description only makes sense if you know we're forwarding this to print
, otherwise None
could also plausibly interpreted to mean "no output".
file : file-like or None, default: `sys.stdout` | |
Where `setp` writes its output, e.g. :: | |
file : file-like, optional, default: `sys.stdout` | |
Where `setp` writes its output if it is asked to list allowed values. | |
e.g. :: | |
with open('output.log') as file: | |
setp(line, file=file) | |
Passing ``None`` forwards output to `sys.stdout`. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
yup
PR Summary
PR Checklist
pytest
passes).flake8
on changed files to check).flake8-docstrings
andpydocstyle<4
and runflake8 --docstring-convention=all
).doc/users/next_whats_new/
(follow instructions in README.rst there).doc/api/next_api_changes/
(follow instructions in README.rst there).