Provided by: man-db_2.5.6-2_i386 bug

НАЗВАНИЕ

       manpath - формат файла /etc/manpath.config

ОПИСАНИЕ

       Файл  настройки  manpath  используется утилитами справочных страниц для
       доступа к пользовательским manpath во время работы;  в  нём  определено
       какие   иерархии   справочных   страниц  (manpath)  считать  системными
       иерархиями, а также для них назначены каталоги хранения cat файлов.

       Если  установлена  переменная  окружения  $MANPATH,  то  информация  из
       /etc/manpath.config использоваться не будет.

ФОРМАТ

       В данный момент распознаются следующие типы полей:

       # 
              Пустые  или  начинающиеся  с  # строки считаются комментариями и
              игнорируются.

       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 пользователь, а
              какие вызываются из-под обычного пользователя.

              Системные   иерархии   справочных   страниц  обычно  хранятся  в
              подкаталогах  /usr,   например,   /usr/man,   /usr/local/man   и
              /usr/X11R6/man.

              Если  cat  страницы  из  определённого manpath_ не нужно
              хранить,  или  они  будут  храниться   в   обычном   месте,   то
              catpath_ можно не указывать.

              Традиционное  размещение  cat  страниц  было  бы невозможным для
              смонтированных только на чтение  каталогов  иерархий  справочных
              страниц,  и  поэтому  возможно определить любую рабочую иерархию
              каталогов  для  их  хранения.  Допустимый  каталог  можно  найти
              поиском в Linux FSSTND по ключевому слову FSSTND.

              К  сожалению,  требуется  указать  все пути системных справочных
              страниц, включая пути альтернативных операционных систем,  такие
              как    /usr/man/sun   и   все   пути   локалей   NLS,   например
              /usr/man/de_DE.88591.

              Так как  информация  обрабатывается  последовательно  строка  за
              строкой  в  порядке  хранения,  необходимо  все manpath, которые
              являются субиерархиями  другой  иерархии,  указывать  в  начале,
              иначе     поиск     может     быть    некорректным.    Например,
              /usr/man/de_DE.88591 должно быть указано раньше, чем /usr/man.

       DEFINE  
              Строки в этом формате определяют различные переменные настройки;
              в  файле  настройки  по  умолчанию  описаны  переменные, которые
              используются утилитами пейджера справочных  страниц.  Они  могут
              содержать  пути  по  умолчанию к различным программам (например,
              grep и tbl) и параметры по умолчанию для этих программ.

       SECTION  ...
              Строки данного формата определяют порядок  поиска  в  справочных
              разделах.  Если  в файле настройки директивы SECTION не указаны,
              то по умолчанию используется:

                     SECTION 1 n l 8 3 0 2 5 4 9 6 7

              Если  указано  несколько  директив  SECTION,  то   их   значения
              объединяются в список.

              Если  какого-то  расширения не окажется в этом списке (например,
              1mh), то страница будет показана вместе с  оставшимся  разделом,
              которому  принадлежит.  Смысл  этого  в том, что нужно указывать
              только расширения,  для  которых  вы  бы  хотели  жёстко  задать
              определённый  порядок.  Разделы  с  расширениями,  как  правило,
              указываются рядом с их основным разделом  (например,  "1  1mh  8
              ...").

              В   качестве   альтернативного   имени   этой   директивы  может
              использоваться SECTIONS.

       MINCATWIDTH 
              Если  ширина  терминала  меньше  чем  ,  то  cat  страницы
              создаваться (если их нет) или отображаться не будут. Значение по
              умолчанию равно 80.

       MAXCATWIDTH 
              Если  ширина  терминала  больше  чем  ,  то  cat  страницы
              создаваться (если их нет) или отображаться не будут. Значение по
              умолчанию равно 80.

       CATWIDTH 
              Если значение  не равно 0, то cat  страницы  будут  всегда
              форматироваться  для  терминала  данной  ширины,  независимо  от
              ширины терминала, который используется на  самом  деле.  Обычно,
              это значение находится в рамках между MINCATWIDTH и MAXCATWIDTH.

       NOCACHE
              Этот  параметр  запрещает  man(1)  автоматически  создавать  cat
              страницы.

ОШИБКИ

       Если  точно не следовать правилам, описанным ранее, то утилиты пейджера
       справочных страниц не будут работать как ожидалось.  Правила  чрезмерно
       запутаны.