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

Skip to content

Inherit more docstrings. #13389

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 1 commit into from
Feb 8, 2019
Merged

Conversation

anntzer
Copy link
Contributor

@anntzer anntzer commented Feb 8, 2019

This caught a few places where a docstring assignment previously
overwrote an explicit docstring (PolarAxes.__init__,
Barbs.set_offsets) or where a bunch of methods were aliases to each
other, but then docstrings were repeatedly overwritten
(IndentityTransform methods).

For Axes methods that are straight pass-throughs of functions defined
elsewhere, on the other hand, straight aliasing yields better pyplot
signatures (as seen in the pyplot diff).

PR Summary

PR Checklist

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

This caught a few places where a docstring assignment previously
overwrote an explicit docstring (`PolarAxes.__init__`,
`Barbs.set_offsets`) or where a bunch of methods were aliases to each
other, but then docstrings were repeatedly overwritten
(IndentityTransform methods).

For Axes methods that are straight pass-throughs of functions defined
elsewhere, on the other hand, straight aliasing yields better pyplot
signatures (as seen in the pyplot diff).
@anntzer anntzer force-pushed the inherit-more-docstrings branch from 9a623ac to 816224f Compare February 8, 2019 10:20
Copy link
Member

@jklymak jklymak left a comment

Choose a reason for hiding this comment

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

Seems fine to me - I didn't check all the docstrings....

@jklymak jklymak merged commit f949caa into matplotlib:master Feb 8, 2019
@anntzer anntzer deleted the inherit-more-docstrings branch February 8, 2019 15:40
@QuLogic QuLogic added this to the v3.1.0 milestone Feb 8, 2019
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