other sections
MANPATH(5) | /etc/manpath.config | MANPATH(5) |
НАЗВАНИЕ¶
manpath - формат файла /etc/manpath.configОПИСАНИЕ¶
Файл настройки manpath используется утилитами справочных страниц для доступа к пользовательским manpath во время работы; в нём определено какие иерархии справочных страниц (manpath) считать системными иерархиями, а также для них назначены каталоги хранения cat файлов.ФОРМАТ¶
В данный момент распознаются следующие типы полей:- # комментарий
- Пустые или начинающиеся с # строки считаются комментариями и игнорируются.
- MANDATORY_MANPATH manpath_элемент
- Строки в этом формате содержат manpath, которые каждый раз генерируются автоматически для включения в $ MANPATH. Обычно, сюда включается /usr/man.
- MANPATH_MAP элемент_пути manpath_элемент
- Строки в этом формате содержат отображение $ PATH в $MANPATH. Для каждого элемента_пути, найденного в пользовательском $ PATH, в $ MANPATH будет добавляться manpath_элемент.
- MANDB_MAP manpath_элемент [ catpath_элемент ]
- Строки в
этом
формате
определяют,
какие manpath
должны
считаться
системными
manpath, а также
можно
задать для
каких из них
нужно
хранить cat
файлы. Этот
тип поля
особенно
важен, если
man является setuid
программой,
так как
(когда
задаются в
системном
файле
настройки
/etc/manpath.config, а не в
персональном
файле
настройки
пользователя
.manpath) им
определяется,
к каким
иерархиям
справочных
страниц
имеет
доступ setuid
пользователь,
а какие
вызываются
из-под
обычного
пользователя.
- DEFINE ключ значение
- Строки в этом формате определяют различные переменные настройки; в файле настройки по умолчанию описаны переменные, которые используются утилитами пейджера справочных страниц. Они могут содержать пути по умолчанию к различным программам (например, grep и tbl) и параметры по умолчанию для этих программ.
- SECTION раздел ...
Строки
данного
формата
определяют
порядок
поиска в
справочных
разделах.
Если в файле
настройки
директивы SECTION
не указаны,
то по
умолчанию
используется:
Если указано
несколько
директив SECTION,
то их
значения
объединяются
в список.
Если
какого-то
расширения
не окажется
в этом
списке
(например, 1mh),
то страница
будет
показана
вместе с
оставшимся
разделом,
которому
принадлежит.
Смысл этого
в том, что
нужно
указывать
только
расширения,
для которых
вы бы хотели
жёстко
задать
определённый
порядок.
Разделы с
расширениями,
как правило,
указываются
рядом с их
основным
разделом
(например, "1 1mh 8
...").
В качестве
альтернативного
имени этой
директивы
может
использоваться
SECTIONS.
SECTION 1 n l 8 3 0 2 5 4 9 6 7
- MINCATWIDTH ширина
- Если ширина терминала меньше чем ширина, то cat страницы создаваться (если их нет) или отображаться не будут. Значение по умолчанию равно 80.
- MAXCATWIDTH ширина
- Если ширина терминала больше чем ширина, то cat страницы создаваться (если их нет) или отображаться не будут. Значение по умолчанию равно 80.
- CATWIDTH ширина
- Если значение ширина не равно 0, то cat страницы будут всегда форматироваться для терминала данной ширины, независимо от ширины терминала, который используется на самом деле. Обычно, это значение находится в рамках между MINCATWIDTH и MAXCATWIDTH.
- NOCACHE
- Этот параметр запрещает man(1) автоматически создавать cat страницы.
ОШИБКИ¶
Если точно не следовать правилам, описанным ранее, то утилиты пейджера справочных страниц не будут работать как ожидалось. Правила чрезмерно запутаны.2012-06-18 | 2.6.2 |