Provided by:
manpages-zh_1.5.1-2_all 
NAME
man - 格式化並顯示在線幫助手冊
manpath - 定義使用者查找man手冊隍爾纁|
`覽
man [-acdfFhkKtwW] [-m 系統名] [-p <前處理程式>] [-C <配置檔案>] [-M
<路徑>] [-P <瀏覽方式>] [-S <區段清單>] [區段名稱] 幫助主題 ...
yz
man 格式化並顯示在線幫助手冊雇。此版本支持 MANPATH 和 ]MANPAGER
環境變量,因此,你可以擁有你自己的一系列 man 手冊隅癡M定使用-
茧{式來顯示此格式的雇。如果定義了區段, man
將只查找在指定區段內的文件。你也可以通過命令行或環境變量來指定查找區段
的順序和預定義將-
n執行的程式。如果主題中有"/"符號,則將其作為檔名的一部分處理
,也就是說你可以用 man ./foo.5 也可以用 man /cd/foo/bar.1.gz
dUmanC
項
-Ctm案
定義man.conf供使用;預設使用的是 /etc/man.config 。(參見
man.conf(5)-M|
定義一組查找man手冊隍漸媬。如果沒有指定此參數,系統環境變量
MANPATH/etc/man.config
檔案中指定的查找。一茠讀 MANPATH 子字 符串表示使用預設清單。
-Ps式
定義瀏覽的方式。此選項將覆.B MANPAGER 環境變量(此變量將覆.B
PAGER 變量)。Y不指定 此參數,則使用 MANPAGER 或 PAGER
環境變量中的設置。此選項的預設的顯示方式為 /usr/bin/less-is-SqM單
該清單是一組用冒號分隔的欲查找的手冊清單。此選項將覆.B MANSECT
環境變量。 有些指令或程式可能有一茈H上的主題,它-
怞鴝韝ㄕP的區段中。因此,n查看較後的區 段,你可以在此指定 man
查找區段的順序。具體區段劃分如下所示:
區段1:使用者指令
區段2:系統調用
區段3:程式庫調用
區段4:設備
區段5:檔案格式
區段6:遊戲
區段7:雜項
區段8:系統指令
區段9:核心內部指令
區段n:Tcl或Tk指令
-a 預設情況下,man在顯示完每一茤珙d到的man手冊-
雅伢|自動退出程式。而使用此選項
,則可使man顯示所有與此主題相匹配的手冊隊漁e,而不僅僅是第一項。
-c 即使已存在最近已排版過的幫助檔案(即以前曾查詢過該主題的幫助文件),使用該參
數後仍會再次執行一次排版操作。此參數適用於已排版過的幫助檔案已損壞或螢幕的行列數有
改變時。
-d 不顯示幫助文件的具體內容,只顯示調試排錯信息。
-D 既顯示幫助文件內容,同時又顯示調試排錯信息。
-f 相當於運行whatis 的操作。即:顯示工具指令與工具程式的簡單說明。
-F" --preformat
只進行格式化操作,而不真正的顯示出來。
-h 顯示man的語法和參數說明,執行完成後退出程式。
-k 查當於使用 apropos 命令。
-K 在所有的幫助檔案中查找包含有指定關鍵字的幫助文件。此操作可能很慢,所以在使用
此參數時最好配合-s 的參數來查找指定區段。(這只是一-
茞妦云熒妝嚏A在作者本人的機器 上每分鐘可查500脁an文件。)
-m 系統名 定義所n查找的man文件所屬的系統名。
-p 字串 定義在排版幫助檔案這前所-
n執行的預處理程式的次序。不是所有的安裝都有完整預處理
程式組。一般有6蚢w處理程式,它-
怓O:eqn(e)、grap(g)、pic(p)、tbl(t)、vgrind(v)和
reger(r)。此參數將覆鄙藿疻僆qMANROFFSEQ。
-t 使用 /usr/bin/groff - Tps - mandoc 來排版man手冊-
間A並輸出到標準輸出。從 /usr/bin/groff - Tpa - madoc
輸出的內容可能需n某些其它過濾才能真正輸出到標準輸出列印。
-w" --path
不顯示幫助文件的具體內容而只顯示相應幫助主題檔案的位置。如果沒有給定參數,則將
在標準輸出顯示一組由man所查到的相匹配的man
文件所在目錄。如果命令manpath是一茖骻
an的鏈接,那麼執行"manpath"就相當於執行"man --path"。
-W 相當於-w參數,但所顯示的內容以分行方式顯示。此參數方便其它指定或程式對其輸出
做進一步處理,如: man -aW man | xargs ls -l
CAT
Man 會試著對所查的文件進行保存,為的是便於下次使用此幫助-
雅犮i節約格式化時間。傳
統上,被格式化的DIR/manX文件會被存儲在DIR/catX中,但你可以在
/etc/man.config 配置文
件中指定其它的目錄。如果所需的cat目錄不存在時,系統就不對格式化後的man文件進行保存
。
對於使用man命令的人,man命令可能對其進行setuid的操作。因此,如果一-
翃at目錄屬於 man並且其模式是0755(只有man對其有寫的權-
),而且,cat檔案也屬於man和其模式是064 4或0444(只有man對其有寫權-
或根本就沒有寫權),則普通用就不能更改cat文件間A也
不能在此目錄中存放其它檔案。而如果man沒有執行setuid的操作,那麼,為了能使所有使用者
都能存放cat隅駥at目錄,則必須將這翃at目錄設置成0777模式。
參數 -c 可以強制生成一虓s的man間A既使已經有一翃at隋s在。
q
MANPATH
如果 MANPATH 有定義,那麼它的N在查找man文件-
雅仱筋健j索路徑來使用。
MANROFFSEQ
如果 MANROFFSEQ 有定義,則此變量的-
N用來決定在nroff或troff執行前將n執行的預處
理程式的次序。預設情況下,手冊須|在nroff處理前選取進行表格處理。
MANSECT
如果 MANSECT 有定義,它的N決定man有搜索時的查找區段。
MANWIDTH
如果MANWIDTH有定義,它的N決定顯示man手冊-
雅阞獐e度。否則,將是以全屏的方式來 顯示。
MANPAGER
如果 MANPAGER 有定義,它的-
N指定用來顯示man文件的程式。如果沒有在此指定,那麼將
使用由PAGER變量指定的程式。如果還是沒有指定,那麼會預設使用/usr/bin/less
-is 。
LANG 如果 LANG 有定義,它的N指定man在查找文件時-
漸查找的子目錄。因此,命令"LAN G=dk man 1 foo"會使man在查找man-
雅仴先查找../dk/man1/foo.1,如果在其中沒有找到相
關文件,則查找../man/foo.1,此目錄是由查找路徑指定的。
NLAPATHLC_MESSAGESLANG
環境變量 NLAPATH 和 LC_MESSAGES (或當後一茪ㄕs在時使用 LANG
)充當了定位文件目錄的 角色。(但-
^文信息是編譯進命令的,所以針對-
^文而言,就沒有目錄存在)。注意,像col
(1)這樣被man調用的程式也使用像 LC_CTYPE 這樣的變量。
PATH 變量 PATH 是在解釋查找man手冊飧纁|時使用的。
SYSTEM 變量 SYSTEM
是用來得到預設的系統名(用-m參數可以得到同樣的效果)。
t見
apropos(1),whatis(1),less(1),groff(1).
BUGS
選項 -t 只能使用在裝有類troff程式的環境中。
如果在你的顯示中出現高亮度的255或<AD>這樣的字符而不是連字符,請在你的配置檔案中
寫入"LESSCHARSET=latin1"這樣的環境變量。
巧
如果你在你的 .emacs 檔案中加入(global-set-
key[(f1)](lambda()(interactive)(manuale
ntry(current-word))))這一行,則當你按F1鍵時會自動跳出當前滑鼠指向的相應程式的man手冊-
間C
[]
} <xuming@users.sourceforge.net>
譯者: 所羅門 <solomen@email.com.cn>
[]
2003/05/13 第一版
mLinuxanhttp://cmpp.linuxforum.net
September 2, 1995 man(1)