Алексей Махоткин

домашняя страница

Automake

Go to the first, previous, next, last section, table of contents.


Страницы руководства

Пакет также может включать в свой состав справочные страницы (но взгляните на стандарты 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.

Comments