2015-05-16 15 views
5

我正嘗試在Mac OS X 10.9.5上安裝bash腳本的手冊頁。我試圖遵循的程序總結如下:man page tutorial。我還總結了我嘗試以下步驟:如何在mac os上安裝自定義man(手動)頁面x

cp custom_command.1 /usr/local/man/man1/custom_command.1 
gzip /usr/local/man/man1/custom_command.1 

當試圖man custom_command我得到的輸出No manual entry for custom_command。我也嘗試了man page tutorial中提到的其他安裝方法,但沒有成功。

有趣的是,上述步驟適用於emacs控制檯,即當我輸入man custom_command時,我確實得到了正確的手冊。但是,該命令未被自動完成識別,我在閱讀手冊之前收到以下警告:WARNING: terminal is not fully functional

任何有關如何解決上述問題(即與系統終端和emacs控制檯)的建議,將不勝感激。


備註1

對於一個參考,這名男子的腳本,我試圖安裝從tutorial拍攝並在下文中重申了參考:

.\" Manpage for nuseradd. 
.\" Contact [email protected] to correct errors or typos. 
.TH man 8 "06 May 2010" "1.0" "nuseradd man page" 
.SH NAME 
nuseradd \- create a new LDAP user 
.SH SYNOPSIS 
nuseradd [USERNAME] 
.SH DESCRIPTION 
nuseradd is high level shell program for adding users to LDAP server. On Debian, administrators should usually use nuseradd.debian(8) instead. 
.SH OPTIONS 
The nuseradd does not take any options. However, you can supply username. 
.SH SEE ALSO 
useradd(8), passwd(5), nuseradd.debian(8) 
.SH BUGS 
No known bugs. 
.SH AUTHOR 
Vivek Gite ([email protected]) 

備註2

我在Linux論壇上看到的其中一個建議是在安裝新命令man後運行命令mandb。但是,該命令在我的操作系統上不可用。

回答

4

第一。爲此,將man文件的路徑傳遞給man命令。它必須包含一個斜線,以被識別爲路徑,例如:

man /usr/local/man/man1/custom_command.1 

那麼你應該確保路徑要安裝你的男人頁面是man命令的搜索列表上。爲了找到該名男子頁的路徑必須是:在環境變量MANPATH

  • 在其配置文件(/private/etc/man.conf在OS X)列出-M選項指定的man命令
    • 根據MANPATH聲明或MANPATH_MAP聲明(僅適用於您的PATH環境變量中的位置)
    • 位於相對於安裝二進制文件的位置,即:如果binary安裝在path/bin手冊頁中搜索在path/manpath/catpath/bin/manpath/bin/cat
    • /private/etc/manpaths.d/目錄

    手冊頁文件的名稱必須相同可選節號命令名稱添加的文件中列出。它可能會被壓縮。

    要看到的人將搜索custom_command手冊頁運行

    man -d custom_command 
    
  • 2

    OS X用戶命令手冊頁在通常創建:

    /usr/local/share/man/man1 
    

    如果您喜歡在不同的目錄編輯創建手冊頁:

    /private/etc/man.conf 
    

    然後將新路徑添加到MANPATH_MAP,爲例如:

    MANPATH_MAP  /usr/local/bin   /usr/local/man 
    

    要讓man搜索非默認路徑用默認的備用(/usr/local/share/man):

    所有你可能要檢查,如果你要安裝手冊頁具有正確的格式,並且可以通過 man命令打開的
    MANPATH   /usr/local/man  
    MANPATH   /usr/local/share/man 
    MANPATH_MAP  /usr/local/bin   /usr/local/share/man 
    
    0

    我已經通過BREW安裝的軟件包,但該男子命令一片空白,因爲我已經安裝了BREW到不同的目錄。 爲了避開這個,還是連接的包(鏈接的內容了幾個目錄),然後我可以加入我的.bash_profile到MANPATH,像這樣......

    MANPATH="/Users/me/Developer/share/man:$MANPATH"