Existem dois arquivos de descrição que são necessários para qualquer port, se eles são realmente pacotes ou não. Eles são pkg-descr e pkg-plist. Seus prefixos pkg- distingue-os de outros arquivos.
Esta é uma descrição mais longa do port. Um a alguns parágrafos concietizamente explicando o que o port faz é suficiente.
Nota: Este não é um manual ou uma descrição aprofundada em como usar ou compilar o port! Por favor tenha cautela se você está compiando do README ou manpage; tão frequentemente eles não são uma descrição concisa do port ou está em um formato de difícil manipulação (ex., manpages tem espaçamento justificado). Se o software portado tem uma homepage WWW oficial, você deve lista-la aqui. Prefix one do websites com WWW: assim ferramentas automatizadas funcionarão corretamente.
Isto é recomendado que você assine seu nome no final deste arquivo, como em:
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 asami@cs.berkeley.edu
Este arquivo lista todos os arquivos instalados pelo port. Ele é tambem chamado de ``lista de empacotamento'' porque o pacote é gerado pelo empacotamento dos arquivos listados aqui. Os pathnames são relativos ao prefixo de instalação (normalmente /usr/local ou /usr/X11R6). Se você está usando o MANn variáveis (como você deve estar), não liste nenhum manpages aqui.
Aqui está um pequeno exemplo:
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
Consulte a página do manual pkg_create(1) para detalhes na lista de empacotamento.
Nota: Você deve listar todos arquivos, mas não o nomes de diretórios, na lista. Também, se o port cria diretórios para si mesmo durante a instalação, certifique-se de adicionar linhas @dirrm tão necessária para remove-los quando o port é apagado.
É recomendavél que você mantenha todos nomes de arquivos neste arquivo sortidos alfabeticamente. Isto fará a verificação das mudanças quando você upgrade o port muito mais fácil.
Criação de uma lista de empacotamento manualmente pode ser uma tarefa muito intediante. Se o port instala um grande numero de arquivos, criando lista de empacotamento automaticamente pode economizar tempo.