8000 Fix joinstyles example by timhoffm · Pull Request #13911 · matplotlib/matplotlib · GitHub
[go: up one dir, main page]

Skip to content

Fix joinstyles example #13911

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
Apr 10, 2019
Merged

Conversation

timhoffm
Copy link
Member
@timhoffm timhoffm commented Apr 9, 2019

PR Summary

Fixes a formatting issue with the heading. Original rendered docs:

grafik

Cause:

Having a file-level """-docstring immediately followed by a sphinx-gallery comment section is problematic. Each part is stripped when generating the .rst file. In the present case, this results in no blank line before the heading (https://matplotlib.org/devdocs/_sources/gallery/lines_bars_and_markers/joinstyle.rst.txt), which is invalid ReST markup.

Note: Also changed the heading marker to not conflict with triple-quotes.

@anntzer
Copy link
Contributor
anntzer commented Apr 10, 2019

Should that be reported as a bug on s-g's side? Even if we put in this fix for now, making the Join styles part a commented section rather than part of the toplevel docstring is more symmetric...

@NelleV
Copy link
Member
NelleV commented Apr 10, 2019

Feel free to open a ticket on SG. In the meantime, this fixes a problem, so I'm going to go ahead and merge.

Thanks @timhoffm

@NelleV NelleV merged commit deb512f into matplotlib:master Apr 10, 2019
@QuLogic QuLogic added this to the v3.2.0 milestone Apr 11, 2019
@timhoffm timhoffm deleted the fix-joinstyles-example branch April 13, 2019 15:03
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
0