Как установить файл man-страницы для всей системы?
Например, если у меня есть файл man-страницы examplecommand.1
, как мне установить его, чтобы я мог просто набрать man examplecommand
для посмотреть?
Во-первых, узнайте, какому разделу Ваша страница справочника принадлежит. Если это - команда, это, вероятно, принадлежит разделу 1
. Можно прочитать страницу справочника для man
команда для наблюдения описания различных разделов и их соответствующих чисел.
Скопируйте свою страницу справочника в /usr/local/share/man/man1/
(изменение 1
к Вашему числу раздела в случае необходимости). Можно также установить его на /usr/share/man/man1/
, но это - наиболее успешная практика для использования local
каталог для файлов, которые установлены, не используя диспетчер пакетов APT:
sudo cp examplecommand.1 /usr/local/share/man/man1/
Работайте mandb
команда. Это обновит man
внутренняя база данных:
sudo mandb
Именно! Необходимо смочь просмотреть страницу справочника путем выполнения:
man 1 examplecommand
man
команда mandb
команда /usr/bin/dh_installman
если можно считать Perl, установленный с debhelper
пакет.Ответ @ntc2 выше является людьми, должен смотреть на. Я хотел добавить некоторый дополнительный комментарий, который не поместился в раздел комментариев:
Подход @ntc2 предоставляет путь людям, только бывшим должным устанавливать их ПУТЬ (который они уже ожидают) для локальных двоичных файлов.
Однако я не думаю универсальное отображение <path>/bin
-> <path>/share/man
существует для всех путей в $PATH
. Кажется, что этого определенного отображения избегают когда $PATH
рассматриваемый $HOME/bin
. При выполнении strace (1) на man
с MANPATH=:/nonexistingdir
, Я вижу следующие поиски:
Для любого элемента в $PATH
это не $HOME/bin
<path>/bin
-> <path>/man
<path>/bin
-> <path>/bin/man
<path>/bin
-> <path>/share/man
<path>/bin
-> <path>/bin/share/man
Для $HOME/bin
$HOME/bin
-> $HOME/man
Я понятия не имею, почему это пропускает другие. Это находится в системе Debian Buster. Это может отличаться в других системах.
Для меня это означает, что самый безопасный путь для установки страниц справочника <path>/man
, поскольку это, как гарантируют, будет найдено, если это будет в $PATH
.
Если только необходимо установить страницу справочника локально:
Если MANPATH
сброшен или включает пустой компонент (т.е. запускается с :
, концы с :
, или содержит ::
), затем <path>/share/man
будет автоматически искаться страницы справочника каждый раз, когда <path>/bin
часть PATH
, для всех значений <path>
.
Это обеспечивает очень простой способ добавить страницы справочника для локально установленного программного обеспечения. Существуют некоторые детали в man manpath
и /etc/manpath.config
, но я не вижу упоминания об универсальном отображении от <path>/bin
кому: <path>/share/man
.