2.2 创建描述文件

有三个描述性文件pkg-comment pkg-descr pkg-plist,以pkg开头与其他的文件区分开.

2.2.1 pkg-comment

对port一行的描述.不要包含包的名字或版本.这个文件以大写字母开头不以标点结尾.例子:


    A cat chasing a mouse all over the screen

2.2.2 pkg-descr

这是一个较长的描述文件,使用几段文字详细的描述这个port.

注意: 这并不是如何使用或编译的手册.如果你是从README或man page中拷贝的,一定要注意格式.如果你port的软件源代码有web site,请在这里注明.

建议你在最后留下您的名字,例子:


    This is a port of oneko, in which a cat chases a poor mouse all over
    the screen.
     :
    (etc.)
    
    WWW: http://www.oneko.org/
    
    - Satoshi
    [email protected]

2.2.3 pkg-plist

这个文件列出了port安装的所有文件.之所以称之为"packing list"是因为最后的pkg安装包制作就是将所列的文件打包.路径与安装的prefix相关(通常是/usr/local/usr/X11R6). 如果你使用的MAN*变量,不要在这里列出MAN page.

这里是一个简单的例子:


    bin/oneko
    lib/X11/app-defaults/Oneko
    lib/X11/oneko/cat1.xpm
    lib/X11/oneko/cat2.xpm
    lib/X11/oneko/mouse.xpm
    @dirrm lib/X11/oneko

参考pkg_create(1)的man page以获得更多的信息.

注意: 你应该列出所有的文件而不仅仅是目录名.如果这个port创建了目录,一定要加入@dirrm一行以便在删除port时,可以将目录清除.

推荐你将本文件中的文件名排序,可以方便你的port升级.

手动创建一个pkg_plist文件可能是一件很困难的事情.如果这个port安装了太多的文件.请参考 自动创建pkg_plist ,可以节省一些时间.