名称
: T0 \, b; k0 U4 Z* `( gman-显示线上求助手册(manualpage)manpath-决定线上手册的搜寻路径
' T) e; O j) A% t& ~+ f9 g4 _& m
3 T0 _: j. \3 L! i* ^3 P摘要
9 n' T3 V4 o0 |man[-acdfhkKtwW][-msystem][-pstring][-Cconfig_file][-Mpath][-Ppager][-Ssection_list][section]name...
+ @/ ]6 Q$ x- F! `) a, g$ a1 g
/ C- K! v* e9 ?/ f4 l0 u6 C描述% b' d/ X. H& r/ a! E
man是用来排版并显示线上求助手册,此版本了解MANPATH与(MAN)PAGER这两个环境变数,所以你可以拥有个人的线上手册,并选择任何程式来显示已排版的手册。如果指定了section,则man只会显示该手册的特定章节。您也可以利用选项或是环境变数来指定搜寻的次序或是排版之前的处理工具。如果name包含了`/'则man会先搜寻所指定的档案,所以您可以man./foo.5或者是man/cd/foo/bar.1.gz。
. w0 g5 V- j7 r( }. b5 \% d' k
& N$ ^, Q+ j" @. f选项
}" ?; |* e* i5 u* M8 J
-Cconfig_file指定设定档man.conf;内定值是/etc/man.conf。(Seeman.conf(5).)
" c/ Z- A9 a% p( S0 a
-M
3 O* e% A3 o7 P# F3 n! j. Dpath指定了线上手册的搜寻路径,如果没有指定则使用环境变数MANPATH的设定;如果没有使用MANPATH,则会使用/usr/lib/man.conf内的设定;如果MANPATH是空字串则表示使用内定值。
; A& W. n& H( k( R9 l2 e) n-P
, k6 t8 J1 e0 e. T3 E" t& [5 Upager指定使用何种pager.man会优先使用此选项设定,然后是依环境变数MANPAGER设定,然后是环境变数PAGER;man内定使用/usr/bin/less-is。
% v# K" `- o# c+ ~* z% u8 e-S
+ N1 |& A+ U9 _ W
section_listman所搜寻的章节列表(以冒号分隔),此选项会覆盖环境变数MANSECT的设定。
* A" u4 {" q" y" n) N-a
0 V! g' C! F/ @: A- d
man内定在显示第一个找到的手册之后就会停止搜寻,使用此选项会强迫man显示所有符合name的线上手册。
, m, h6 Y1 B @* T* ~3 f
-c
; h: `7 q `/ \2 ]0 X- \
即使有最新的catpage,还是对线上手册重新作排版,本选项在萤幕的行列数改变时或已排版的线上手册损坏时特别有意义。
) r0 ^' F) X+ U& c( L
[color=#FFFFFF']
: k0 B4 t1 f1 }9 B( l8 A$ C2 l( Y7 O6 K6 ?
-d
6 I' P2 C- X* b; p: ?* x9 K
不要真的显示线上手册,只显示除错讯息。
( M4 n* Y* v3 @2 G1 {2 K
-D
, j8 z" p5 v# K- N- ^8 K; L! m
同时显示线上手册与除错讯息。
3 i/ B! ?* x& A3 R1 s-f
0 J1 L& B, w: A0 m9 }# k% B功能同whatis。
# O" T _1 c1 N: E2 a-h
/ U4 H L4 Y8 p" E2 o& I显示求助讯息然后结束程式。
2 |; ^$ y' l+ U! \" g-k
9 @ Y0 w7 ?7 C- q
功能同apropos。
& I! o+ M: _1 o2 I9 E
-K
- u9 M- ], s3 ~6 R; O9 O3 e& t; a6 ^# Z对所有的线上手册搜寻所指定的字串。警告:本功能回应
速度可能很慢!如果指定section会对速度有帮助。
1 P6 y6 X/ a! f
-m
B! U) O; n% z8 [
system依所指定的system名称而指定另一组的线上手册。
; v4 F2 r* \# p" B) C6 Q6 f-p
6 B$ |1 S( I4 `2 f; Q4 Z, ~
string指定在nroff或troff之前所执行的处理程式不是所有的安装都会有完整的前
处理器。各个前处理器所代表的字母分别为:eqn(e),grap(g),pic(p),tbl(t),vgrind(v),refer(r).本选项覆盖环境变数MANROFFSEQ的设定。
0 V5 y; F! y$ D
-t
5 w8 }! G* h6 T7 }) h2 K, \ ^使用/usr/bin/groff-Tps-mandoc来对线上手册排版,并将结果显示至stdout。/usr/bin/groff-Tps-mandoc的输出结果可能还需要特定的过滤器才能列印(如bg5ps)。
3 j* C3 }5 w6 a, ~ W% w, K$ E: s
-w或--path
4 w; L7 j* ~/ K
不要真的显示线上手册,但显示线上手册的位置.如果没有指定引数则显示man所搜寻的目录列表。如果manpath是man的□结,则%26;#29612;anpath?功能同%26;#29612;an--path?。
. r- y, E( ]. b( F. H6 [+ F- g1 M0 f* \-W
. z' I; x) f1 D* z3 S i2 R% T
功能
类-w,但每行只印出一个档名,不印出额外的讯息.这在下面的状况特别有用:man-aWman│xargsls-l。
H `) |1 k2 F) u9 M w1 C3 i& e" c+ T
2 k; j9 c: K4 s* C! O
man会试着存下已排版的线上手册,以节省下回排版所需要的
时间。传统上,位于DIR/X的手册在排版完成后会存于DIR/catX,但在这里是存于/var/ctaman/catX。如果
系统没有所需要的目录,则不会有任何catpage存档。
# [- @. s( {! v2 W3 @) I, g3 k
% `5 ?6 c9 L: o: y9 Z3 lItispossibletomakemansuidtoauserman.Then,ifacatdirectoryhasownermanandmode0755(onlywritablebyman),andthecatfileshaveownermanandmode0644or0444(onlywritablebyman,ornotwritableatall),noordinaryusercanchangethecatpagesorputotherfilesinthecatdirectory.Ifmanisnotmadesuid,thenacatdirectoryshouldhavemode0777ifallusersshouldbeabletoleavecatpagesthere.
8 M* g* y" W1 a# @1 I6 J
! H' s* B3 B6 o, W# Q
选项-c强迫对线上手册重新作排版。
; ?: k- U0 b l8 z) G( P6 E; m: V- j' {- f8 t* m% y4 O6 G! E
环境变数
$ u2 O: A& t7 l* [
[color=#FFFFFF']
9 ?* k0 M1 f/ v/ a7 S. {: a( b' }5 [5 ?( T! U+ I# ]
MANPATHMANPATH用来设定man的搜寻路径。
' I# A4 t6 ~# ]' C# _2 W1 V. }. K
MANROFFSEQ
: |% l! p- c: O$ h6 f+ wMANROFFSEQ用来设定在nroff或troff执行前所需要的前处理器。内定在nroff前会先执行tablepreprocessor。
) Z# w, Q& n0 K" z0 b
MANSECT
: ?0 K% Y8 _, f3 n3 r
MANSECT决定man搜寻的章节。
6 N$ U3 G, n0 b( G6 g
MANWIDTH
) ^ v- |& V, m7 C3 z+ xMANWIDTH用来设定显示的宽度。若无设定,则手册会填满您萤幕的宽度。
. V- y0 K$ A! L w
MANPAGER
X. |6 C. d0 T& \
MANPAGER决定了显示线上手册的工具。如果无MANPAGER则使用PAGER,如果两者皆未设定则使用/usr/bin/less-is。
8 C0 D. ^) u' W! c5 E
% A0 u2 ?* l7 `# ~( [' C' _$ ELANGLANG决定了man先搜寻的的子目录的名称所以`LANG=dkman1foo'会使man先搜寻[path]/dk/man1/foo.1,如果找不到该档,man才去寻找[path]/man1/foo.1,[path]是指预设的搜寻路径。
" N% J: _4 F# y* ~$ S5 N. J! v2 o& K' `
NLSPATH,LC_MESSAGES,LANG
, r4 n6 N: f8 k& y; B! _
环境变数NLSPATH与LC_MESSAGES(如果LC_MESSAGE不存在则使用LANG)用来指定讯息的语言种类.(英文讯息是编译时即内定,故不需另外设定.)请注意,man所呼叫的程式,如col(1)也会使用这些环境变数。
* n9 ~5 a. G3 [( A" ^ o" h: r2 B+ J/ W0 u6 M6 s9 ~
PATHPATH是用来设定man的搜寻线上手册的路径。
8 k! }4 x0 }1 H
* X# T" G2 T" U/ ^+ `6 b* T; ZSYSTEMSYSTEM用来设定替代的系统名(此为选
3 z, w4 ~7 i/ J+ b
项-m所使用)。
# F' k& S4 L6 [# j
1 |4 h% c' i) i! \* e相关说明
1 F1 M7 b+ w" t. O6 T
apropos(1),whatis(1),less(1),groff(1)。
3 S4 m% i$ w# C7 e7 K/ r+ M
& K6 F6 |# k, i, h* p* I臭虫
9 b! W& N/ _5 X" v2 g
选项-t只会在有类似troff工具存在时才有功用。在gnome-help-browser还看不到中文。在kdehelp中可看到中文,但固定字型建建议选取courier或lucidatyperiter。（BP1.0）
