第18章 Man page

MAN[1-9LN]变量会自动的将所有的man page加入pkg-plist(你不需要在pkg-pilst中列出,参看创建pkg-plist文件). 在安装时是否压缩文件依赖/etc/make.conf中的NOMANCOMPRESS定义.

如果你的port使用符号连接或硬连接安装man page到不同名字,你必须设置MLINKS变量.这些连接将会被bsd.port.mk破坏并重建以确定指向正确的文件.在MLINKS中列出的文件不能出现在pkg-plist中.

你可以通过设置MANCOMPRESSED变量来指定是否在安装时压缩.有三个取值:yes no maybe.yes指压缩,no指不压缩,maybe指已经从NOMANCOMPRESS取值所以不需要bsd.port.mk做额外的工作.

如果设定了USE_IMAKE并且NO_INSTALL_MANPAGES没有设置或置为no,那么MANCOMPRESSED会自动置为yes.

如果源代码的作者将man page树安装在别的地方而不是PREFIX,你可以通过MANPREFIX指定.通常只有一些特殊的软件会这样,如perl模块,你可以使用Man[*]PREFIX([*]代表1-9,L或N)分别指定.

如果你的man page安装在特定的语言子目录,设置MANLANG变量(缺省为"",英文)

下面是一个例子:

    MAN1=          foo.1
    MAN3=          bar.3
    MAN4=          baz.4
    MLINKS=        foo.1 alt-name.8
    MANLANG=       "" ja
    MAN3PREFIX=    ${PREFIX}/share/foobar
    MANCOMPRESSED= yes

man page文件会被安装成如下:

    ${PREFIX}/man/man1/foo.1.gz
    ${PREFIX}/man/ja/man1/foo.1.gz
    ${PREFIX}/share/foobar/man/man3/bar.3.gz
    ${PREFIX}/share/foobar/man/ja/man3/bar.3.gz
    ${PREFIX}/man/man4/baz.4.gz
    ${PREFIX}/man/ja/man4/baz.4.gz