使用pip安装python包手册页

Question

我在/opt/python-2.7.6中维护了一个自定义编译的Python安装。我希望手册页安装在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

该软件包没有手册页see here。它是Debian policy，要求每个程序都添加一个手册页。因此，该软件包会为您安装一个。

作为旁注

如果您维护自己的套餐，则可以在data_files中使用指令setup.py：

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

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