1.6. Настройка путей поиска man-страниц

Проблема

У вас постоянно возникают сложности с нахождением man-страниц. После применения средств, описанных в разделе 1.4, выясняется, что большинство отсутствующих страниц находятся в каталоге, о котором man, похоже, ничего не знает. Возможно, вновь установленная программа разместила свои man-страницы в каком-то странном каталоге (скажем, /opt/man). А может, вы хотите разместить часть страниц в нестандартном каталоге. Как настроить man на поиск этих страниц?

Решение

Отредактируйте файл /etc/manpath.config.

# Поля, включаемые в каждый автоматически
# сгенерированный путь MANPATH
MANDATORY_MANPATH /usr/man
MANDATORY_MANPATH /usr/share/man
MANDATORY_MANPATH /usr/XllR6/man
MANDATORY_MANPATH /usr/local/man
MANDATORY_MANPATH /opt/man

Теперь man найдет man-страницы, находящиеся в новом каталоге. При создании нестандартного каталога man-страниц не забудьте создать подкаталоги разделов:

$ ls /opt/man/local
man1 man2 man3 man4 man5 man6 man7 man8 man9

Включать все нумерованные подразделы не обязательно — достаточно разделов для тех man-страниц, которые будут там храниться. Если вы будете использовать подкаталоги (например, /opt/man и /opt/man/local), укажите их именно в таком порядке:

MANDATORY_MANPATH /opt/man/local
MANDATORY_MANPATH /opt/man

Подкаталоги должны указываться перед родительскими каталогами, в противном случае программа просмотра man-страниц их проигнорирует.

Комментарии
Чтобы узнать текущий путь поиска man-страниц, выполните команду manpath без параметров:

$ manpath
/usr/local/man:/usr/share/man:/usr/X11R6/man:/usr/man

См. также

manpath(1); manpath(5).