Capítulo 8. Manpages

As variáveis MAN[1-9LN] automaticamente adicionarão quaisquer manpages ao pkg-plist (isto significa que você não tem que listar manpages no pkg-plist--veja gerando PLIST para mais). Também faz o estágio de instalar automaticamente compressa ou descompressa manpages dependendo das definições do NOMANCOMPRESS no /etc/make.conf.

Se seu port tenta instalar nomes multiplos para manpages usando symlinks ou hardlinks, você tem que usar a variável MLINKS para identificar estes. O link instalado pelo seu port será destruído e recriado pelo bsd.port.mk para certificar-se que ele indica ao arquivo correto. Quaisquer manpages listadas em MLINKS não tem que ser listada no pkg-plist.

Para especificar whether o manpages são comprimidas na instalação, use a variável MANCOMPRESSED. Esta variável pode ter três valores, yes, no e maybe. yes significa que manpages estão já instaladas comprimidas, no significa que elas não estão, e maybe significa que o software já cumpre o valor do NOMANCOMPRESS assim bsd.port.mk não tem que fazer nada especial.

O MANCOMPRESSED é automaticamente dfinido a yes se USE_IMAKE é definido e NO_INSTALL_MANPAGES não é definido, e para no ao contrário. Você não tem que defini-lo explicitamnete ao menos que o padrão não é suitable para seu port.

Se seu port anchors its man tree em outro algum lugar que PREFIX, você pode usar o MANPREFIX para defini-lo. Também, se somente manpages em certain sections go in a non-standard place, como alguns ports do módulos perl, você pode definir paths do man individual usando MANsectPREFIX (onde sect é um de 1-9, L ou N).

Se seus manpages forem aos subdiretórios de lingua-específica, defina o nome das linguas ao MANLANG. O valor desta variável defaults to "" (ex., somente Inglês).

Aqui está um exemplo que colocamos eles todos juntos.

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

Teste estados que seis arquivos são instalados por este port;

${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

Adicionalmente ${PREFIX}/man/man8/alt-name.8.gz pode or não ser instalado por seu port. Regardless, um symlink será criado para juntar o manpage foo(1) e manpage alt-name(8).

For questions about the FreeBSD ports system, e-mail <ports@FreeBSD.org>.
For questions about this documentation, e-mail <doc@FreeBSD.org>.