Bagaimana cara saya langsung menampilkan halaman manual?

16

Saya sedang menulis halaman manual untuk program yang saya kemas. Bagaimana saya bisa menampilkan file manual yang saya buat, untuk memeriksa apakah tidak apa-apa? Apakah ada cara untuk mengirimkan file saya langsung ke manperintah alih-alih mencari mencari halaman yang diinstal dengan nama?

Saya mencoba melakukan hal-hal seperti man myprog.1dan man < myprog.1tetapi dalam kedua kasus saya mendapatkan kesalahan mengatakan bahwa halaman manual tidak dapat ditemukan.

hugomg
sumber

Jawaban:

24

man memiliki opsi untuk membaca file lokal: -l

-l, --local-file

Aktifkan mode `lokal '. Format dan tampilkan file manual lokal alih-alih mencari melalui koleksi manual sistem. Setiap argumen halaman manual akan ditafsirkan sebagai file sumber nroff dalam format yang benar. Tidak ada file kucing yang diproduksi.

Jika '-' terdaftar sebagai salah satu argumen, input akan diambil dari stdin. Ketika opsi ini tidak digunakan, dan manusia gagal menemukan halaman yang diperlukan, sebelum menampilkan pesan kesalahan, ia mencoba untuk bertindak seolah-olah opsi ini diberikan, menggunakan nama sebagai nama file dan mencari kecocokan yang tepat.

Jadi, Anda dapat melihat pratinjau pekerjaan Anda yang sedang berjalan dengan:

man -l /path/to/manfile.1

jasonwryan
sumber
2
Itu pada dasarnya spesifik untuk Linux. Anda mungkin ingin membatasi jawaban Anda.
Thomas Dickey
5
@ThomasDickey Saya hanya menggunakan Linux; Anda dipersilakan untuk mengedit atau menambahkan jawaban ...
jasonwryan
15

Cara 'sekolah lama', untuk sistem yang memberi tanggal sebelum -lpilihan, adalah

nroff -man filename | more -s
Flup
sumber
10

Saya telah menggunakan sederhana

man ./path/to/man.1

Anda perlu memasukkan garis miring di jalur, jika tidak mencari direktori sistem. Bekerja pada sistem Linux dan OS X yang saya miliki (yang terakhir tidak punya -l).

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

Pada Solaris, the -M pergantian ke manakan menimpa jalur pencarian untuk halaman manual: -

man -M path/to/man myprog

File manual Anda harus berada di subdirektori yang sesuai dengan bagian dan bahasa mark-up, misalnya: path/to/man/man1/myprog.1 untuk halaman manual nroff di bagian 1.

crw
sumber