You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
man pages not available when installed with pipx #1023
When installed via pipx install bpython, the man pages for bpython are not available (even the .rst files don't seem to be present).
I took a look at pipx's documentation and they linked to (pycowsay) as an example. From what I can tell the only difference is pycowsay has the man pages built and included in the repo, whereas bpython just has the .rst files.
@sebastinas I tried installing sphinx with pipx, then installing bpython, but it still didn't build the man pages. I assume this is caused by pipx's manner of installing packages, so in this case I think it's more accurate to say that the man pages just aren't built if someone is using pipx.
Yes, I didn't quite have time to check the docs yesterday but I had started to suspect that. I don't have a definitive answer for whether pipx would generate the docs if sphinx were installed globally via regular pip or apt or something, but that isn't recommended anyway so it's somewhat irrelevant.
Overall, I think if you want to start tracking the generated man file as part of the repo itself that would be great, but otherwise we can close this issue as a "won't fix" since the actual problem has been identified.
Activity
sebastinas commentedon Sep 1, 2024
The man pages are only built and installed if sphinx is available.
jmdevin commentedon Sep 8, 2024
Would it be possible to include the built pages in the repository? It would be useful for users with a situation like mine.
jmdevin commentedon May 11, 2025
@sebastinas I tried installing sphinx with pipx, then installing bpython, but it still didn't build the man pages. I assume this is caused by pipx's manner of installing packages, so in this case I think it's more accurate to say that the man pages just aren't built if someone is using pipx.
sebastinas commentedon May 11, 2025
So is pipx ignoring
data_files?sebastinas commentedon May 11, 2025
No, it doesn't. But installing sphinx with pipx get sphinx installed in a different virtual env. So it's not available when building bpython.
jmdevin commentedon May 11, 2025
Yes, I didn't quite have time to check the docs yesterday but I had started to suspect that. I don't have a definitive answer for whether pipx would generate the docs if sphinx were installed globally via regular pip or apt or something, but that isn't recommended anyway so it's somewhat irrelevant.
Overall, I think if you want to start tracking the generated man file as part of the repo itself that would be great, but otherwise we can close this issue as a "won't fix" since the actual problem has been identified.