Как вручную установить файл справочной страницы?

Как установить файл man-страницы для всей системы?

Например, если у меня есть файл man-страницы examplecommand.1, как мне установить его, чтобы я мог просто набрать man examplecommand для посмотреть?

44
задан 2 January 2019 в 19:02

3 ответа

  1. Во-первых, узнайте, какому разделу Ваша страница справочника принадлежит. Если это - команда, это, вероятно, принадлежит разделу 1. Можно прочитать страницу справочника для man командаManpage icon для наблюдения описания различных разделов и их соответствующих чисел.

  2. Скопируйте свою страницу справочника в /usr/local/share/man/man1/ (изменение 1 к Вашему числу раздела в случае необходимости). Можно также установить его на /usr/share/man/man1/, но это - наиболее успешная практика для использования local каталог для файлов, которые установлены, не используя диспетчер пакетов APT:

    sudo cp examplecommand.1 /usr/local/share/man/man1/
    
  3. Работайте mandb команда. Это обновит manвнутренняя база данных:

    sudo mandb
    
  4. Именно! Необходимо смочь просмотреть страницу справочника путем выполнения:

    man 1 examplecommand
    

Ссылки:

53
ответ дан 2 January 2019 в 19:02

Ответ @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.

1
ответ дан 2 January 2019 в 19:02

Если только необходимо установить страницу справочника локально:

Если MANPATH сброшен или включает пустой компонент (т.е. запускается с :, концы с :, или содержит ::), затем <path>/share/man будет автоматически искаться страницы справочника каждый раз, когда <path>/bin часть PATH, для всех значений <path>.

Это обеспечивает очень простой способ добавить страницы справочника для локально установленного программного обеспечения. Существуют некоторые детали в man manpath и /etc/manpath.config, но я не вижу упоминания об универсальном отображении от <path>/bin кому: <path>/share/man.

10
ответ дан 2 January 2019 в 19:02

Другие вопросы по тегам:

Похожие вопросы: