3.2.编写描述文件

对于任何port,都需要两个描述文件,无论它们实际上是否打包。它们是 pkg-descr 和 pkg-plist。它们的 pkg-前缀使它们与其他文件区分开来。

3.2.1. pkg-descr

这是一个关于 port 的较长描述。简洁地解释 port 的功能即可。

一个写得很好的 pkg-descr 完全描述了 port,让用户无需查阅文档或访问网站即可了解软件的功能、用途以及特别好的功能。提到某些要求,如图形工具包、重要的依赖项、运行时环境或实现语言,有助于用户决定这个 port 是否适合他们。

3.2.2. pkg-plist

此文件列出了port安装的所有文件。它也被称为“包装清单”,因为该软件包是通过打包在此处列出的文件而生成的。路径名是相对于安装前缀(通常为/usr/local)。

这里有一个小例子:

bin/oneko
man/man1/oneko.1.gz
lib/X11/app-defaults/Oneko
lib/X11/oneko/cat1.xpm
lib/X11/oneko/cat2.xpm
lib/X11/oneko/mouse.xpm

有关包装清单的详细信息,请参阅 pkg-create(8) 手册页。

只有一种情况可以省略 pkg-plist 。如果 port 只安装少量文件,请将它们列在 PLIST_FILES 中,位于 port 的 Makefile 内。例如,我们可以通过将这些行添加到 Makefile 中而无需在上述 oneko port 中使用 pkg-plist:

PLIST_FILES=	bin/oneko \
		man/man1/oneko.1.gz \
		lib/X11/app-defaults/Oneko \
		lib/X11/oneko/cat1.xpm \
		lib/X11/oneko/cat2.xpm \
		lib/X11/oneko/mouse.xpm
PLIST_FILES=	"@sample ${ETCDIR}/oneko.conf.sample"

稍后我们将看到如何使用 pkg-plist 和 PLIST_FILES 来实现更复杂的任务。

最后更新于

FreeBSD 中文社区