Переменные MAN[1-9LN]
автоматически добавят любые
страницы Справочника к файлу pkg-plist
(это
означает, что вам не нужно указывать страницы
Справочника в файле pkg-plist
—обратитесь к
главе о генерации файла PLIST для
получения более подробной информации). Это также позволяет на этапе
установки автоматически упаковывать и распаковывать страницы
Справочника в зависимости от значения переменной
NO_MANCOMPRESS
в файле
/etc/make.conf
.
Если ваш порт пытается задать несколько имен для страниц
Справочника при помощи символических или жестких ссылок, то вы должны
использовать переменную MLINKS
, чтобы указать на
это. Ссылка, установленная вашим портом, будет уничтожена и создана
заново сценарием bsd.port.mk
для проверки того,
что она указывает на правильный файл. Любые страницы Справочника,
перечисленные в переменной MLINKS, не должны фигурировать в файле
pkg-plist
.
Для указания того, что страницы Справочника нужно сжимать во
время установки, используйте переменную
MANCOMPRESSED
. Эта переменная может принимать три
значения - yes
, no
и
maybe
. yes
означает, что
страницы Справочника устанавливаются уже сжатыми, no
означает, что они не сжимаются и maybe
означает, что
программное обеспечение принимает во внимание значение переменной
NO_MANCOMPRESS
, так что сценарию
bsd.port.mk
ничего дополнительно делать не
нужно.
Значение переменной MANCOMPRESSED
автоматически
устанавливается в yes
, если переменная
USE_IMAKE
задана, а
NO_INSTALL_MANPAGES
нет, и в значение
no
в противном случае. Вам не нужно задавать ее
явно, если значение по умолчанию подходит вашему порту.
Если ваш порт определяет корнем для файлов Справочника каталог,
отличный от PREFIX
, вы можете использовать
переменную MANPREFIX
, чтобы задать его явно. Кроме
того, если страницы только некоторых разделов помещаются в
нестандартное место, например, в случае портов модулей языка
perl
Perl, вы можете установить маршруты к справочным
страницам индивидуально, при помощи
MAN
(где
sect
PREFIXsect
принимает значения
1-9
, L
или
N
).
Если страницы Справочника помещаются в подкаталоги, соответствующие
некоторому языку, то задайте название языка языка в переменной
MANLANG
. Значение этой переменной по умолчанию
равно ""
(то есть только английский язык).
Вот пример, в котором приводятся все случаи.
Здесь указано, что этот порт устанавливает 6 файлов:
Кроме того, файл
${MANPREFIX}/man/man8/alt-name.8.gz
может быть, а
может и не быть установлен вашим портом. В любом случае будет создана
символическая ссылка для объединения страниц Справочника foo(1) и
alt-name(8).
Если переведена только часть страниц справочника, вы можете
использовать некоторые переменные, созданные динамически из
содержимого MANLANG
:
Что переводится в такой список файлов:
Этот, и другие документы, могут быть скачаны с http://ftp.FreeBSD.org/pub/FreeBSD/doc/.
По вопросам, связанным с FreeBSD, прочитайте
документацию прежде чем писать в
<questions@FreeBSD.org>.
По вопросам, связанным с этой документацией, пишите в рассылку
<doc@FreeBSD.org>.