Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Add a docstring to toolkit's BezierPath.__init__. #17587

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

Merged
merged 2 commits into from
Jun 9, 2020

Conversation

QuLogic
Copy link
Member

@QuLogic QuLogic commented Jun 8, 2020

PR Summary

This breaks on new Sphinx due to missing the docstring for the inherited methods that the superclass docstring references, but this method doesn't need it.

PR Checklist

  • [N/A] Has Pytest style unit tests
  • Code is Flake 8 compliant
  • [N/A] New features are documented, with examples if plot related
  • Documentation is sphinx and numpydoc compliant
  • [N/A] Added an entry to doc/users/next_whats_new/ if major new feature (follow instructions in README.rst there)
  • [N/A] Documented in doc/api/api_changes.rst if API changed in a backward-incompatible way

@QuLogic QuLogic added this to the v3.2.2 milestone Jun 8, 2020
@QuLogic QuLogic requested a review from anntzer June 8, 2020 20:59
path : path.Path
The path to draw.
**kwargs
All remaining keyword arguments are passed to `Line2D`.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This probably needs to be .Line2D with a dot?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I forgot to test the doc build (only did a REPL check) after fixing the deprecation decorator, but strangely, it does not seem to warn about this either way. I guess I need to update my conda environment, but we might want to bump minimum sphinx requirements as well, so this is more consistent.

Copy link
Contributor

@anntzer anntzer left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

looks fine to me if ci passes
(I missed the discussion of this point in the call, though)

Copy link
Member

@tacaswell tacaswell left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Anyone can merge on green.

QuLogic added 2 commits June 8, 2020 18:54
This breaks on new Sphinx due to missing the docstring for the inherited
methods that the superclass docstring references, but this method
doesn't need it.
The docstring is lost otherwise.
@timhoffm timhoffm merged commit c404d1f into matplotlib:master Jun 9, 2020
meeseeksmachine pushed a commit to meeseeksmachine/matplotlib that referenced this pull request Jun 9, 2020
tacaswell added a commit that referenced this pull request Jun 9, 2020
…587-on-v3.2.x

Backport PR #17587 on branch v3.2.x (Add a docstring to toolkit's BezierPath.__init__.)
@QuLogic QuLogic deleted the fix-docs branch June 9, 2020 06:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants