對於它的價值,我不是信息頁的粉絲。我更喜歡優秀的舊版Unix手冊頁,編寫它們非常簡單。您可以在編輯器中簡單地打開任何手冊頁,查看它的源代碼並將其複製以滿足您的需求。
在大多數系統上,手冊頁位於/usr/share/man/{man1,man2,man3,man4,man5,man6,man7,man8}/
之類的目錄中,或者您可以使用man
命令的-w
選項查看任何手冊頁的位置,然後將其打開。例如
$ man -w ls
/usr/share/man/man1/ls.1.gz
$ vim /usr/share/man/man1/ls.1.gz
您可以看到它是如何寫入的,並模仿它來編寫自己的手冊頁。爲了讓任何人都能夠閱讀由您編寫的手冊頁,手冊頁必須安裝在man utility搜索手冊頁的目錄之一中。在Linux上,通常可以通過運行manpath
命令來查看這個目錄列表(在其他系統上它可能不同,您將不得不看到man
命令本身的手冊頁)。如果您將手冊頁存儲在其中一個目錄中,則任何人都可以使用man
實用程序來閱讀它。
按照POSIX
的man
效用也尊重環境變量MANPATH
,所以如果你存儲你的男人頁非標準位置,你可以設置MANPATH變量,使man
可以看看它。或者,您也可以修改/etc/man.conf
文件以將手冊頁目錄添加到搜索路徑man
。
現在,手冊頁使用宏語言進行標記。 Linux系統傾向於使用man(7)
宏語法,以便您可以看到手動here
有編寫手冊頁另一種現代的宏設定,堪稱mdoc(7)
,這是在BSD系列操作系統的廣泛應用。你可以看到它的手冊here