.\" Man page for format of the manpath.config data file
.\"
.\" Copyright (C) 1994, 1995 Graeme W. Wilford. (Wilf.)
.\" Copyright (C) 2001-2019 Colin Watson.
.\"
.\" You may distribute under the terms of the GNU General Public
.\" License as specified in the file docs/COPYING.GPLv2 that comes with the
.\" man-db distribution.
.\"
.\" Sat Oct 29 13:09:31 GMT 1994  Wilf. (G.Wilford@ee.surrey.ac.uk)
.\"
.pc ""
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH MANPATH 5 2025-05-02 2.13.1 /etc/man_db.conf
.SH ІМʼЯ
manpath \- формат файлу /etc/man_db.conf
.SH ОПИС
Файл конфігурації manpath використовується утилітами сторінок довідки для
оцінки шляхів користувачів під час роботи, щоб вказати, які ієрархії
сторінок довідки (manpaths) повинні розглядатися як системні ієрархії та
призначати їм каталоги для зберігання файлів cat.

Якщо змінна середовища $\fBMANPATH\fP вже встановлена, інформація, яка
міститься у /etc/man_db.conf, не буде її перезаписувати.
.SH "ШЛЯХ ПОШУКУ"
За замовчуванням, man\-db перевіряє шлях користувача $\fBPATH\fP. Для кожного
знайденого тут \fIелементу_шляху\fP, воно додає \fIелемент_шляху\fP до шляху
пошуку.

Якщо у конфігураційному файлі немає рядка \fBMANPATH_MAP\fP для заданого
\fIелементу_шляху\fP, тоді до шляху пошуку додаються всі наявні каталоги
\fIелементи_шляху/../man\fP, \fIелементи_шляху/man\fP,
\fIелементи_шляху/../share/man\fP, та \fIелементи_шляху/share/man\fP.

Потім додає всі записи \fBMANDATORY_MANPATH\fP з файлу конфігурації до шляху
пошуку.

Нарешті, якщо використовується опція \fB\-\-systems\fP або встановлена змінна
середовища $\fBSYSTEM\fP, то це повинно складатися з послідовності імен
операційних систем, розділених комами або двокрапками. Це діє як шаблон,
розширюючи шлях пошуку ще раз, щоб дозволити доступ до сторінок керівництва
інших операційних систем: для кожної назви системи man\-db шукає цю назву як
підкаталог кожного запису у шляху пошуку та додає його до остаточного шляху
пошуку, якщо він існує. Назва системного \fBman\fP вставляє звичайний шлях
пошуку без підкаталогів. Наприклад, якщо шлях пошуку був би
\fI/usr/share/man:/usr/local/man\fP, а $\fBSYSTEM\fP встановлено на \fInewOS:man\fP,
то остаточний шлях пошуку буде
\fI/usr/share/man/newOS:\:/usr/share/man:\:/usr/local/man/newOS:\:/usr/local/man\fP.

Змінна середовища $\fBMANPATH\fP перекриває шляхи пошуку сторінок довідки за
замовчуванням у man\-db. Зазвичай користувачам не потрібно її
встановлювати. Синтаксис схожий на змінну середовища $\fBPATH\fP: вона
складається з послідовності імен каталогів, розділених двокрапками. Вона
перекриває типовий шлях пошуку, описаний вище.

Якщо значення $\fBMANPATH\fP починається з двокрапки, то допоміжний шлях пошуку
додається на початок. Якщо значення $\fBMANPATH\fP закінчується двокрапкою, то
допоміжний шлях пошуку додається в кінець. Якщо значення $\fBMANPATH\fP містить
подвійну двокрапку (\fB::\fP), то допоміжний шлях пошуку вставляється
посередині значення, між двома двокрапками.
.SH ФОРМАТ
Наступні типи полів визнаються зараз:
.TP 
\fB#\fP\fI\ коментар\fP
Порожні рядки або ті, що починаються з \fB#\fP, будуть вважатися коментарями і
проігноровані.
.TP 
\fBMANDATORY_MANPATH\fP\fI\ елемент_шляхів_до_man\fP
Ці рядки вказують на шляхи до каталогів, які повинні бути включені до
кожного автоматично згенерованого $\fBMANPATH\fP. Зазвичай це включає
\fI/usr/man\fP.
.TP 
\fBMANPATH_MAP\fP\fI\ елемент_шлях\ елемент_шляхів_до_man\fP
Ці рядки встановлюють відповідність між елементами шляху $\fBPATH\fP та
$\fBMANPATH\fP. Для кожного знайденого \fIелементу_шляху\fP у $\fBPATH\fP
користувача, \fIелемент_шляху_до_man\fP буде додано до $\fBMANPATH\fP.
.TP 
\fBMANDB_MAP \fP\fIелемент_шляхів_до_man\fP\|[\| \fIелемент_шляхів_до_cat\fP \|]
Ці рядки вказують, які шляхи до man повинні розглядатися як системні шляхи
і, необовʼязково, де мають зберігатися їхні файли cat. Цей тип полів
особливо важливий, якщо \fBman\fP є програмою з правами setuid, оскільки вона
вказує, які ієрархії сторінок довідки потрібно отримувати від користувача
setuid, а які \- від користувача що викликав команду (при наявності у
системному конфігураційному файлі /etc/man_db.conf замість
персонального конфігураційного файлу .manpath).

Системні ієрархії сторінок довідки зазвичай зберігаються в /usr, такі як
/usr/man, /usr/local/man та /usr/X11R6/man.

Якщо сторінки каталогу з певного \fIелементу_шляху_до_man\fP не повинні
зберігатися або мають бути збережені в традиційному розташуванні, то можна
опустити \fIелементу_шляху_до_cat\fP.

Традиційне розміщення файлів cat було б неможливим для ієрархій сторінок
довідки змонтованих тільки для читання, тому, через це, можна вказати
будь\-яку дійсну ієрархію каталогів для зберігання їх. Щоб відповідати
стандарту \fBLinux FSSTND\fP, замість фактичного каталогу можна використовувати
ключове слово \fBFSSTND\fP.

На жаль, необхідно вказати \fBВСІ\fP шляхи до дерева системних сторінок man,
включаючи альтернативні шляхи операційної системи, такі як \fI/usr/man/sun\fP,
а також будь\-які шляхи \fBNLS locale\fP, наприклад \fI/usr/man/de_DE.88591\fP.

Оскільки інформація аналізується по рядку в тому порядку, в якому вони
записані, необхідно, щоб будь\-який шлях до man, який є підієрархією іншої
ієрархії, був перерахований першим, інакше буде зроблено неправильну
відповідність. Наприклад, шлях \fI/usr/man/de_DE.88591\fP повинен йти перед
\fI/usr/man\fP.
.TP 
\fBDEFINE\fP\fI\ ключ\ значення\fP
Ці рядки визначають різні конфігураційні змінні; дивіться файл конфігурації
за замовчуванням для тих змінних, які використовуються утилітами переглядача
сторінок. Вони включають шляхи за замовчуванням до різних програм (таких як
\fIgrep\fP і \fItbl\fP) та набори аргументів для цих програм.
.TP 
\fBSECTION\fP \fIрозділ\fP .\|.\|.
.RS
Ці рядки визначають порядок пошуку розділів довідки. Якщо в конфігураційному
файлі немає директив \fBSECTION\fP, то за замовчуванням використовується:
.PP
.RS
.nf
.if  !'po4a'hide' SECTION 1 n l 8 3 0 2 3type 5 4 9 6 7
.fi
.RE
.PP
Якщо вказано кілька директив \fBSECTION\fP, їхні списки розділів будуть
обʼєднані.
.PP
Якщо певне розширення не знаходиться у цьому списку (наприклад, 1mh), воно
буде показано разом з іншою секцією, до якої воно належить. Наслідком є те,
що вам потрібно вказати розширення явно лише тоді, коли ви хочете задати
певний порядок. Секції з розширеннями зазвичай повинні бути суміжними з
їхньою основною секцією (наприклад, "1 1mh 8 ...").
.PP
\fBSECTIONS\fP також приймається як альтернативна назва для цієї директиви.
.RE
.TP 
\fBMINCATWIDTH\fP\fI\ ширина\fP
Якщо ширина терміналу менша за \fIширину\fP, сторінки cat не будуть створені
(якщо їх немає) або показані. За замовчуванням це 80.
.TP 
\fBMAXCATWIDTH\fP\fI\ ширина\fP
Якщо ширина терміналу більша за \fIширину\fP, сторінки cat не будуть створені
(якщо вони відсутні) або показані. За замовчуванням це 80.
.TP 
\fBCATWIDTH\fP\fI\ ширина\fP
Якщо \fIширина\fP не дорівнює нулю, сторінки cat будуть завжди форматовані для
терміналу вказаної ширини, незалежно від фактично використовуваного
терміналу. Це перевизначає \fBMINCATWIDTH\fP та \fBMAXCATWIDTH\fP.
.TP 
.if  !'po4a'hide' .B NOCACHE
Цей прапорець забороняє \fBman\fP(1) автоматично створювати сторінки
категорій.
.SH ПОМИЛКИ
Якщо правила вище не будуть дотримані точно, утиліти переглядача сторінок не
працюватимуть так, як бажано. Правила занадто складні.
.PP
.if  !'po4a'hide' https://gitlab.com/man-db/man-db/\-/issues
.br
.if  !'po4a'hide' https://savannah.nongnu.org/bugs/?group=man\-db