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

manpage documentation is missing all subcommands #6724

Closed
eli-schwartz opened this issue Jul 18, 2019 · 1 comment · Fixed by #6725
Closed

manpage documentation is missing all subcommands #6724

eli-schwartz opened this issue Jul 18, 2019 · 1 comment · Fixed by #6725
Labels
auto-locked Outdated issues that have been locked by automation type: bug A confirmed bug or unintended behavior type: docs Documentation related

Comments

@eli-schwartz
Copy link
Contributor

eli-schwartz commented Jul 18, 2019

Initially reported in Arch Linux as: https://bugs.archlinux.org/task/63223

To reproduce:

git clone https://github.com/pypa/pip/
cd pip/docs
PYTHONPATH=$PWD/../src/ sphinx-build -W -b man -d build/doctrees/man man build/man -c html

Look in build/man and you will see only one manpage: pip.1

Really quick reproducer: look at a recent Travis CI build for the TOXENV=docs results, for example https://travis-ci.org/pypa/pip/jobs/559973823#L388, and see only one file being written out.

Expectation: There should be lots of manpages, one for each pip subcommand, and linux distro packages which install the docs/build/man/ directory to /usr/share/man/man1/ should be able to read all about pip's many excellent features in their offline documentation reader.

The cause of this breakage is #5724, which reorganized the conf.py layout due to readthedocs/readthedocs.org#1543 but did not adapt the somewhat hacky code to automatically add new entries.

@triage-new-issues triage-new-issues bot added the S: needs triage Issues/PRs that need to be triaged label Jul 18, 2019
@pradyunsg
Copy link
Member

Makes sense. Happy to merge your fix conditional to a minor nitpick. 🙃

@chrahunt chrahunt added type: bug A confirmed bug or unintended behavior type: docs Documentation related labels Jul 21, 2019
@triage-new-issues triage-new-issues bot removed the S: needs triage Issues/PRs that need to be triaged label Jul 21, 2019
@lock lock bot added the auto-locked Outdated issues that have been locked by automation label Aug 20, 2019
@lock lock bot locked as resolved and limited conversation to collaborators Aug 20, 2019
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
auto-locked Outdated issues that have been locked by automation type: bug A confirmed bug or unintended behavior type: docs Documentation related
Projects
None yet
Development

Successfully merging a pull request may close this issue.

3 participants