15.7 安装额外的文档

如果你的port中含有对用户很重要的文档,但又不是man或info.你可以在post-install阶段把他们安装在PREFIX/share/doc.

你应该新创建一个目录,一般是以PORTNAME为名,如果有版本的区别,你也可以用PKGNAME为名.

看下面这一段,你会发现文档的安装依赖于NOPORTDOCS的定义.用户可以在/etc/make.conf中如下定义

    post-install:
    .if !defined(NOPORTDOCS)
            ${MKDIR} ${PREFIX}/share/doc/xv
            ${INSTALL_MAN} ${WRKSRC}/docs/xvdocs.ps ${PREFIX}/share/doc/xv
    .endif

任何安装的额外的文档应当出现在pkg-plist.并且以%%PORTDOCS%%为前缀:

    %%PORTDOCS%%share/doc/pure-ftpd/AUTHORS
    %%PORTDOCS%%share/doc/pure-ftpd/CONTACT
    %%PORTDOCS%%@dirrm share/doc/pure-ftpd

你也可以在安装时使用pkg-message文件来输出一些信息.参看pkg-message 以获得更多信息.