.\" .\" Generated automatically from man.1.in by the .\" configure script. .\" .\" Man page for man (and the former manpath) .\" .\" Copyright (c) 1990, 1991, John W. Eaton. .\" .\" You may distribute under the terms of the GNU General Public .\" License as specified in the README file that comes with the man 1.0 .\" distribution. .\" .\" John W. Eaton .\" jwe@che.utexas.edu .\" Department of Chemical Engineering .\" The University of Texas at Austin .\" Austin, Texas 78712 .\" .\" Many changes - aeb .\" .TH man 1 "September 2, 1995" .SH NAME man \- 格式化並顯示在線幫助手冊頁 .br manpath \- 定義使用者查找man手冊頁的路徑 .SH 總覽 man [-acdfFhkKtwW] [-m 系統名] [-p <前處理程式>] [-C <配置檔案>] [-M <路徑>] [-P <瀏覽方式>] [-S <區段清單>] [區段名稱] 幫助主題 ... .SH 描述 .B man 格式化並顯示在線幫助手冊頁面。此版本支持 .B MANPATH 和 .B （MAN）PAGER 環境變量，因此，你可以擁有你自己的一系列 .B man 手冊頁並決定使用哪個程式來顯示此格式的頁面。如果定義了區段， .B man 將只查找在指定區段內的文件。你也可以通過命令行或環境變量來指定查找區段 的順序和預定義將要執行的程式。如果主題中有\(lq/\(rq符號，則將其作為檔名的一部分處理 ，也就是說你可以用 .B "man ./foo.5" 也可以用 .B "man /cd/foo/bar.1.gz"來查看各man 文件。 .SH 選項 .TP .B -C "配置檔案" 定義man.conf供使用；預設使用的是 .BR /etc/man.config 。（參見 .BR man.conf(5)）。 .TP .B -M "路徑" 定義一組查找man手冊頁的目錄。如果沒有指定此參數，系統環境變量 .B MANPATH將被使用。 如果查無到此環境變量，則按預設 .BR /etc/man.config 檔案中指定的查找。一個空的 .B MANPATH 子字 符串表示使用預設清單。 .TP .B -P "瀏覽方式" 定義瀏覽的方式。此選項將覆蓋 .B MANPAGER 環境變量（此變量將覆蓋 .B PAGER 變量）。若不指定 此參數，則使用 .B MANPAGER 或 .B PAGER 環境變量中的設置。此選項的預設的顯示方式為 .BR /usr/bin/less-is。 .TP .B -S "區段清單" 該清單是一組用冒號分隔的欲查找的手冊清單。此選項將覆蓋 .B MANSECT 環境變量。 有些指令或程式可能有一個以上的主題，它們位於不同的區段中。因此，要查看較後的區 段，你可以在此指定 .B man 查找區段的順序。具體區段劃分如下所示： .RS 區段1：使用者指令 .br 區段2：系統調用 .br 區段3：程式庫調用 .br 區段4：設備 .br 區段5：檔案格式 .br 區段6：遊戲 .br 區段7：雜項 .br 區段8：系統指令 .br 區段9：核心內部指令 .br 區段n：Tcl或Tk指令 .RE .TP .B -a 預設情況下，man在顯示完每一個所查到的man手冊頁時會自動退出程式。而使用此選項 ，則可使man顯示所有與此主題相匹配的手冊頁內容，而不僅僅是第一項。 .TP .B -c 即使已存在最近已排版過的幫助檔案（即以前曾查詢過該主題的幫助文件），使用該參 數後仍會再次執行一次排版操作。此參數適用於已排版過的幫助檔案已損壞或螢幕的行列數有 改變時。 .TP .B -d 不顯示幫助文件的具體內容，只顯示調試排錯信息。 .TP .B -D 既顯示幫助文件內容，同時又顯示調試排錯信息。 .TP .B -f 相當於運行whatis 的操作。即：顯示工具指令與工具程式的簡單說明。 .TP .B -F" 或 "--preformat 只進行格式化操作，而不真正的顯示出來。 .TP .B -h 顯示man的語法和參數說明，執行完成後退出程式。 .TP .B -k 查當於使用 .B apropos 命令。 .TP .B -K 在所有的幫助檔案中查找包含有指定關鍵字的幫助文件。此操作可能很慢，所以在使用 此參數時最好配合-s 的參數來查找指定區段。（這只是一個粗略的概念，在作者本人的機器 上每分鐘可查500個man文件。） .TP .B -m 系統名 定義所要查找的man文件所屬的系統名。 .TP .B -p 字串 定義在排版幫助檔案這前所要執行的預處理程式的次序。不是所有的安裝都有完整預處理 程式組。一般有6個預處理程式，它們是：eqn(e)、grap(g)、pic(p)、tbl(t)、vgrind(v)和 reger(r)。此參數將覆蓋環境變量MANROFFSEQ。 .TP .B -t 使用 .B /usr/bin/groff - Tps - mandoc 來排版man手冊頁，並輸出到標準輸出。從 .B /usr/bin/groff - Tpa - madoc 輸出的內容可能需要某些其它過濾才能真正輸出到標準輸出列印。 .TP .B -w" 或 "--path 不顯示幫助文件的具體內容而只顯示相應幫助主題檔案的位置。如果沒有給定參數，則將 在標準輸出顯示一組由man所查到的相匹配的man 文件所在目錄。如果命令manpath是一個到m an的鏈接，那麼執行\(lqmanpath\(rq就相當於執行\(lqman --path\(rq。 .TP .B -W 相當於-w參數，但所顯示的內容以分行方式顯示。此參數方便其它指定或程式對其輸出 做進一步處理，如： .ft CW .B "man -aW man | xargs ls -l " .ft .SH CAT頁 Man 會試著對所查的文件進行保存，為的是便於下次使用此幫助頁時可節約格式化時間。傳 統上，被格式化的DIR/manX文件會被存儲在DIR/catX中，但你可以在 .BR /etc/man.config 配置文 件中指定其它的目錄。如果所需的cat目錄不存在時，系統就不對格式化後的man文件進行保存 。 .PP 對於使用man命令的人，man命令可能對其進行setuid的操作。因此，如果一個cat目錄屬於 man並且其模式是0755（只有man對其有寫的權限），而且，cat檔案也屬於man和其模式是064 4或0444（只有man對其有寫權限或根本就沒有寫權限），則普通用就不能更改cat文件頁，也 不能在此目錄中存放其它檔案。而如果man沒有執行setuid的操作，那麼，為了能使所有使用者 都能存放cat頁到cat目錄，則必須將這個cat目錄設置成0777模式。 .PP 參數 .B -c 可以強制生成一個新的man頁，既使已經有一個cat頁存在。 .SH 環境變量 .TP .B MANPATH 如果 .B MANPATH 有定義，那麼它的值將在查找man文件頁時做為搜索路徑來使用。 .TP .B MANROFFSEQ 如果 .B MANROFFSEQ 有定義，則此變量的值將用來決定在nroff或troff執行前將要執行的預處 理程式的次序。預設情況下，手冊頁會在nroff處理前選取進行表格處理。 .TP .B MANSECT 如果 .B MANSECT 有定義，它的值將決定man有搜索時的查找區段。 .TP .B MANWIDTH 如果MANWIDTH有定義，它的值將決定顯示man手冊頁時的寬度。否則，將是以全屏的方式來 顯示。 .TP .B MANPAGER 如果 .B MANPAGER 有定義，它的值將指定用來顯示man文件的程式。如果沒有在此指定，那麼將 使用由PAGER變量指定的程式。如果還是沒有指定，那麼會預設使用/usr/bin/less -is 。 .TP .B LANG 如果 .B LANG 有定義，它的值將指定man在查找文件時首先查找的子目錄。因此，命令\(lqLAN G=dk man 1 foo\(rq會使man在查找man頁時首先查找../dk/man1/foo.1，如果在其中沒有找到相 關文件，則查找../man/foo.1，此目錄是由查找路徑指定的。 .TP .B "NLAPATH，LC_MESSAGES，LANG" 環境變量 .B NLAPATH 和 .B LC_MESSAGES （或當後一個不存在時使用 .B LANG ）充當了定位文件目錄的 角色。（但英文信息是編譯進命令的，所以針對英文而言，就沒有目錄存在）。注意，像col (1)這樣被man調用的程式也使用像 .B LC_CTYPE 這樣的變量。 .TP .B PATH 變量 .B PATH 是在解釋查找man手冊頁路徑時使用的。 .TP .B SYSTEM 變量 .B SYSTEM 是用來得到預設的系統名（用-m參數可以得到同樣的效果）。 .SH 另見 apropos(1),whatis(1),less(1),groff(1). .SH BUGS 選項 .B -t 只能使用在裝有類troff程式的環境中。 如果在你的顯示中出現高亮度的\255或這樣的字符而不是連字符，請在你的配置檔案中 寫入\(lqLESSCHARSET=latin1\(rq這樣的環境變量。 .SH 技巧 如果你在你的 .IR .emacs 檔案中加入(global-set-key[(f1)](lambda()(interactive)(manuale ntry(current-word))))這一行，則當你按F1鍵時會自動跳出當前滑鼠指向的相應程式的man手冊頁。 .SH "[中文版維護人]" .B 徐明 .TP 譯者： 所羅門 .SH "[中文版最新更新]" .BR 2003/05/13 第一版 .SH "《中國Linux論壇man手冊頁翻譯計劃》" .BI http://cmpp.linuxforum.net