使用pip安装python包手册页

Question

我维护一个自定义编译的Python安装/opt/python-2.7.6.我希望安装手册页share/man.我已经安装了已经使用几个库pip(numpy,scipy,matplotlib,sympy).我不确定他们是否应该附带手册页.

现在,我安装了pygments.它附带一个名为的二进制文件pygmentize,它已正确安装bin.

Sidetracking:我在Debian包中查找了文件python-pygments,它附带了一个手册页:

$ apt-file list python-pygments
...
/usr/share/man/man1/pygmentize.1.gz
...

回到主题:我不想安装python-pygments,apt-get因为它将与系统Python相关联.我想继续使用pip来维护我的自定义Python安装.使用将share/man目录添加到MANPATH环境变量应该很容易.bashrc

export MANPATH=/opt/python-2.7.6/share/man:$MANPATH

问题:如何使用pip与Python库一起安装手册页？

Answer 1

该包没有手册页，请参阅此处。Debian政策要求每个程序都添加一个手册页。因此，该软件包会为您安装一个。

作为旁注

如果您维护自己的包，则可以data_files在您的setup.py：

setup(
    ...
    data_files = [('man/man1', ['path/to/your/manpage.1/'])],
)

如果您想为您的程序自动创建一个手册页（如果您使用的是 argparse，请查看我的包man-utils ）。