Skip to content

docs: set man_make_section_directory to false #3750

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

Conversation

bastimeyer
Copy link
Member

@bastimeyer bastimeyer commented May 25, 2021

And fix inconsistent manpage build paths between recent sphinx
releases. False is the currently expected value, as setup.py
will check for a built manpage in docs/_build/man/streamlink.1
for inclusion in the release tarballs.

Even though the doc's HTML theme "furo" does currently limit the
used sphinx version to 3.x, this won't stop users building the
manpage using sphinx 4.x, eg. via a global system-package.


What a mess...
https://www.sphinx-doc.org/en/master/changes.html

Sphinx 4:
https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-man_make_section_directory

man_make_section_directory
If true, make a section directory on build man page. Default is True.

New in version 3.3.
Changed in version 4.0: The default is changed to False from True.
Changed in version 4.0.2: The default is changed to True from False again.

Sphinx 3:
https://www.sphinx-doc.org/en/3.x/usage/configuration.html#confval-man_make_section_directory

man_make_section_directory
If true, make a section directory on build man page. Default is False.

New in version 3.3.

And fix inconsistent manpage build paths between recent sphinx
releases. False is the currently expected value, as setup.py
will check for a built manpage in `docs/_build/man/streamlink.1`
for inclusion in the release tarballs.

Even though the doc's HTML theme "furo" does currently limit the
used sphinx version to 3.x, this won't stop users building the
manpage using sphinx 4.x, eg. via a global system-package.
@back-to back-to merged commit 5e65d2d into streamlink:master May 26, 2021
@bastimeyer bastimeyer deleted the docs/manpage-section-directory branch May 26, 2021 17:33
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.

2 participants