FS#63223 - [python-pip] Missing man pages for pip subcommands

Attached to Project: Arch Linux
Opened by Daniel Mulford (dgmulf) - Wednesday, 17 July 2019, 23:14 GMT
Last edited by Felix Yan (felixonmars) - Tuesday, 27 August 2019, 08:46 GMT
Task Type Bug Report
Category Upstream Bugs
Status Closed
Assigned To Felix Yan (felixonmars)
Architecture All
Severity Low
Priority Normal
Reported Version
Due in Version Undecided
Due Date Undecided
Percent Complete 100%
Votes 0
Private No

Details

Description:
python-pip only provides pip(1), but not the additional man pages for pip subcommands (i.e. pip-install(1), pip-download(1)...)

Additional info:
Discovered in python-pip 19.0.3-1
This task depends upon

Closed by  Felix Yan (felixonmars)
Tuesday, 27 August 2019, 08:46 GMT
Reason for closing:  Fixed
Additional comments about closing:  19.2.3-1
Comment by Eli Schwartz (eschwartz) - Thursday, 18 July 2019, 02:46 GMT
  • Field changed: Category (Packages: Extra → Upstream Bugs)
Unfortunately, it seems that that is the only thing sphinx-build creates. There are other files which should be getting built, referring to the pip-*(1) pages referenced under COMMANDS, but they apparently aren't... this is an upstream pip bug.
Comment by Eli Schwartz (eschwartz) - Thursday, 18 July 2019, 03:02 GMT
I've submitted an upstream issue https://github.com/pypa/pip/issues/6724 and a proposed fix in https://github.com/pypa/pip/pull/6725

So assuming this gets merged, the next version of pip will actually have code which generates manpages (for everyone).
Comment by Eli Schwartz (eschwartz) - Thursday, 18 July 2019, 15:47 GMT
Fix merged upstream. It would be quite nice to backport this in order to ship manpages as expected -- and to take the opportunity to bump the pkgver to 19.1.1 at the same time.

Bumping the pkgver and removing the two backported patches is sufficient to update pip, and everything works as expected. For completeness, here is a diff that updates pip and adds the manpages in at the same time.
   pip-update-plus-manpages.diff (2 KiB)
Comment by Eli Schwartz (eschwartz) - Monday, 05 August 2019, 00:27 GMT
pip 19.2 and 19.2.1 have the fixed docs, so at this point a pkgver bump should suffice.

Loading...