Справочные страницы с MakeMaker

Я написал несколько справочных страниц, которые хочу установить из MakeMaker.

Я хотел бы контролировать, где они установлены, используя переменные среды, такие как INSTALLSITEMAN1DIR* переменные среды.

Где в дереве исходных текстов я должен разместить файлы man или что мне нужно сделать, чтобы Makefile.PL сообщил о них?


perl manpage makemaker
person ajwood    schedule 10.09.2012    source источник

Ответы (1)


arrow_upward
2
arrow_downward

В каком формате ваши справочные страницы? Вы не должны поставлять полностью скомпилированные справочные страницы, так как каждый целевой хост должен будет отформатировать их по мере необходимости с помощью своей собственной версии groff или troff или чего-то еще.

Если вы пишете свои справочные страницы в формате POD, MakeMaker автоматически выберет их и поместит в нужное место.

  1. Просто назовите файлы с .pod в конце,
  2. Поместите их в свой каталог lib и
  3. Отформатируйте их в формате Perl Plain Old Documentation (POD).

Если вам нужно поставлять свои справочные страницы в каком-то другом формате, я не знаю, какой будет протокол. Вам, вероятно, придется настроить Makefile, который генерирует ExtUtils::MakeMaker. В этот момент вы можете заглянуть в Module::Build, Module::Install или Dist::Zilla, поскольку их намного проще настроить.

person zostay    schedule 10.09.2012
comment
Ааа - я написал это на основе какой-то другой справочной страницы, которую я просматривал, но я не уверен, что именно. Я думал, что синтаксис был слишком дрянным, чтобы делать правильные вещи :) - person ajwood; 10.09.2012