pip手册页与命令帮助内容冲突及相关技术问题咨询

问题1：该问题属于Ubuntu还是Pip的Bug？是否需要上报？ #

这是Ubuntu的打包维护问题，不属于Pip官方Bug。Pip官方的pip help install输出是准确的，而Ubuntu系统里的pip3.1.gz手册页由Ubuntu打包团队负责维护，他们没及时跟进Pip升级策略的变更。这种情况建议上报给Ubuntu的Bug追踪系统，帮助更新过时的手册内容。

问题2：Pip是否不再使用手册页了？ #

是的，Pip官方已不再主动维护manpage（手册页）。现在官方推荐通过pip help <command>命令获取实时准确的帮助信息——命令行帮助会随Pip版本同步更新，能保证内容时效性。官方详细文档也以在线形式为主，不再依赖manpage作为主要帮助渠道。

问题3：若手册页已不再维护或过时，为何仍存在于系统中？ #

主要有两点原因：

• Unix/Linux系统里不少用户保留了用manpage查帮助的习惯，Ubuntu打包时为兼容这类用户的使用习惯，依然保留了manpage文件。
• Ubuntu的打包流程可能沿用了旧模板，或是更新Pip包时没同步更新对应的manpage内容，导致过时文件被保留下来。

内容的提问来源于stack exchange，提问作者Steve Lorimer