Як я можу безпосередньо відобразити чоловічу сторінку?

Я пишу довідкову сторінку для програми, яку я пакую. Як я можу відобразити створений мною файл файлів, щоб перевірити, чи все в порядку? Чи є спосіб передати мій файл безпосередньо manкоманді замість того, щоб він шукав встановлені manpages по імені?

Я намагався робити такі речі , як man myprog.1і , man < myprog.1але в обох випадках я отримав повідомлення про помилку говорить , що сторінка не може бути знайдений.

man є можливість прочитати локальний файл: -l

-l, --local-file

Активуйте режим `локальний '. Форматування та відображення локальних файлів вручну замість пошуку в ручній колекції системи. Кожен аргумент сторінки вручну буде інтерпретуватися як вихідний файл nroff у правильному форматі. Файл котів не створюється.

Якщо "-" вказано в якості одного з аргументів, введення буде взято з stdin. Якщо цей параметр не використовується, і людина не знаходить потрібну сторінку, перш ніж відобразити повідомлення про помилку, він намагається діяти так, як якщо б ця опція була надана, використовуючи ім'я як ім'я файлу та шукаючи точну відповідність.

Тож ви можете попередньо переглянути свою роботу за допомогою:

man -l /path/to/manfile.1

Шлях "старого шкільного" для систем, які попередньо бачили цю -lопцію, є

nroff -man filename | more -s

Я використовував просто

man ./path/to/man.1

Потрібно включити косу рису в шлях, інакше він шукає системні каталоги. Працює в системах Linux та OS X (останніх у мене немає -l).

$ cd /tmp
$ cp /usr/share/man/man1/ls.1 .
$ man ls.1
No manual entry for ls.1
$ man ./ls.1     # works

У Solaris -Mперемикач на manперекриє шлях пошуку для manpages: -

man -M path/to/man myprog

Ваш файл manpage повинен містити відповідний підкаталог, відповідний розділу та мові розмітки, наприклад: path/to/man/man1/myprog.1для nroff manpage у розділі 1.