Skip to content
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

Fix #9568: autosummary: summarise overlined sectioned headings correctly #9569

Merged
merged 2 commits into from Aug 29, 2021

Conversation

jakelishman
Copy link
Contributor

@jakelishman jakelishman commented Aug 20, 2021

Subject: autosummary: summarise overlined sectioned headings correctly

Feature or Bugfix

  • Bugfix

Purpose

Detail

Add an extra step in the autosummary summariser algorithm to get a valid
text form of section headings. This fixed issues when the first element
of a summarised document was a section heading with overlines, such as

    =======
    Heading
    =======

Previously, the first line would be taken verbatim, which caused parse
errors in the rest of the document.

Relates

…ngs correctly

Add an extra step in the autosummary summariser algorithm to get a valid
text form of section headings.  This fixed issues when the first element
of a summarised document was a section heading with overlines, such as

    =======
    Heading
    =======

Previously, the first line would be taken verbatim, which caused parse
errors in the rest of the document.
@tk0miya tk0miya merged commit a4a0b97 into sphinx-doc:4.x Aug 29, 2021
@github-actions github-actions bot locked as resolved and limited conversation to collaborators Sep 29, 2021
@jakelishman jakelishman deleted the fix-autosummary-sections branch September 1, 2022 19:24
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Autosummary fails to summarise docstrings that begin with overline section headings
2 participants