Пакет также может включать в свой состав справочные страницы (но
взгляните на стандарты GNU за информацией о них), section `Man Pages' in The GNU Coding Standards. Страницы руководства объявляются
с помощью основной переменной `MANS'. Обычно используется макрос
man_MANS. Справочные страницы автоматически устанавливаются в
зависимости от расширения файлов в соответствующие подкаталоги
mandir. Они не включаются в состав дистрибутива автоматически.
По умолчанию страницы руководства устанавливаются при выполнении
`make install'. Однако, поскольку проекты GNU не требуют наличия
справочных страниц, то многие разработчики проектов не расходуют
время на поддержание справочных страниц в обновленном состоянии. В этих
случаях опция no-installman отключит установку справочных страниц
по умолчанию. Пользователь все равно будет иметь возможность явно
установить справочные страницы, используя команду `make
install-man'.
Вот как документация обрабатывается в пакете GNU cpio (который
включает в себя как документацию в Texinfo, так и справочные страницы):
info_TEXINFOS = cpio.texi man_MANS = cpio.1 mt.1 EXTRA_DIST = $(man_MANS)
Исходные тексты Texinfo и страницы info считаются исходными файлами и включаются в состав дистрибутива.
В настоящее время страницы руководства не рассматриваются как исходные файлы, потому что зачастую они генерируются автоматически. Именно поэтому они и не включаются автоматически в состав дистрибутива.
Go to the first, previous, next, last section, table of contents.