MAN

åç§°
æ¦è¿°
æè¿°
示ä¾
æ¦è¿°
é»è®¤å¼
é项
éåºç¶æ
ç¯å¢
æä»¶
亦è§
åå²
BUGS


åç§°

man − ç³»ç»åèæåçæ¥å£

æ¦è¿°

man [man é项] [[ç« è] 页 …] …
man −k
[apropos é项] æ£å表达å¼
man −K
[man é项] [ç« è] å³é®è¯ 
man −f
[whatis é项] 页
man −l
[man é项] æä»¶
man −w
|−W [man é项] page

æè¿°

man æ¯ç³»ç»çæåå页ç¨åºãæå®ç» man ç 页 é项é常æ¯ç¨åºã工巿彿°åãç¨åºå°æ¾ç¤ºæ¯ä¸ä¸ªæ¾å°çç¸å³ æå页ã妿æå®äº ç« èï¼man å°åªå¨æåçæå® ç« è æç´¢ãé»è®¤å°æé¢å®çé¡ºåºæ¥æ¾ææå¯ç¨ç ç« èï¼åè§ é»è®¤å¼ ä¸èï¼ï¼å¹¶åªæ¾ç¤ºæ¾å°ç第ä¸ä¸ª 页ï¼å³ä½¿å¤ä¸ª ç« è ä¸é½æè¿ä¸ª 页é¢ã

ä¸è¡¨æ¾ç¤ºäºæåç ç« è å·åå¶åå«çæå页类åã

       

Image grohtml-969701.png

ä¸ä¸ªæå é¡µé¢ åå«è¥å¹²ä¸ªå°èã

å°èåç§°é叏忬 NAME, æ¦è¿°(SYNOPSIS), éç½®(CONFIGURATION), æè¿°(DESCRIPTION), é项(OPTIONS), éåºç¶æ(EXIT STATUS), è¿åå¼(RETURN VALUE), é误(ERRORS), ç¯å¢(ENVIRONMENT), æä»¶(FILES), çæ¬(VERSIONS), ç¬¦åæ å(CONFORMING TO), 注(NOTES), 缺é·(BUGS), 示ä¾(EXAMPLE), ä½è(AUTHORS), å 亦è§(SEE ALSO).

以ä¸è§èéç¨äº æ¦è¿°(SYNOPSIS) å°èï¼ä¹å¯ä½ä¸ºå¶ä»å°èçæåã

   

Image grohtml-969702.png

å®é渲æçææå¯è½å è¾åºè®¾å¤èå¼ãä¾å¦ï¼å¨ç»ç«¯ä¸ man ç¨åºéå¸¸æ æ³æ¸²æåºæä½ï¼è¿æ¶ä¸è¬ä¼ä»¥ä¸å线æå½©è²æå代æ¿ã

ç¨åºå彿°è¯´æåºè¯¥æ¯ä¸ä¸ªå¯ä»¥å¹éææå¯è½ç¨æ³ç模å¼(pattern)ãæäºæåµä¸ï¼å»ºè®®ææ- ¤æå页 æ¦è¿°(SYNOPSIS) å°èææ¾ç¤ºçåå«éè¿°å ç§äºæ¥çç¨æ³ã

示ä¾

man ls

æ¾ç¤º é¡¹ç® (ç¨åº) ls 对åºçæå页ã

man man.7

æ¾ç¤ºç« è 7 ä¸å®å man 对åºçæå页ãï¼è¿æ¯âman 7 manâçå¦ä¸ç§æ¼åæ¹æ³ãï¼

man ’man(7)’

æ¾ç¤ºç« è 7 ä¸å®å man 对åºçæå页ãï¼è¿æ¯âman 7 manâçå¦ä¸ç§æ¼åæ¹æ³ãè¯¥æ¹æ³å¨å¤å¶åç²è´´æå页ç交åå¼ç¨æ¶å¯è½æ´æ¹ä¾¿ã请注æï¼æ¬å·å¨é常æåµä¸å¿é¡»è¢«å¼å·æ¬èµ·ä»¥é¿å shell 转ä¹ãï¼

man −a intro

æ£ç¡®æ§è¡æ¶æ¾ç¤ºæåä¸åå«çææå¯ç¨ç intro æå页ãå¯ä»¥å¨è¿ç»æ¾ç¤ºè¿ç¨ä¸- éåºæè·³è¿ä»»ä¸é¡µã

man −t bash | lpr −Pps

Format the manual page for bash into the default troff or groff format and pipe it to the printer named ps. The default output for groff is usually PostScript. man −−help should advise as to which processor is bound to the −t option.

man −l −Tdvi ./foo.1x.gz > ./foo.1x.dvi

This command will decompress and format the nroff source manual page ./foo.1x.gz into a device independent (dvi) file. The redirection is necessary as the −T flag causes output to be directed to stdout with no pager. The output could be viewed with a program such as xdvi or further processed into PostScript using a program such as dvips.

man −k printf

å°å³é®è¯ printf ä½ä¸ºæ- £åè¡¨è¾¾å¼æ¥æç´¢å¯¹åºçæå页æ¦è¿°åæå页åç§°ï¼å¹¶æå°ææå¹éç»æãçæäº apropos printf.

man −f smail

æ¥æ¾ smail å¼ç¨çæå页并è¾åºæ¾å°çæææ¦è¿°ãçæäº whatis smail.

æ¦è¿°

man æè®¸å¤é项ä¾ç¨æ·çµæ´»ä½¿ç¨ãæç´¢è·¯å¾ãç« è顺åºãè¾åºå¤çå¨åå¶ä»è¡ä¸ºåæä½å坿´æ¹ï¼å·ä½å¦ä¸ã

If set, various environment variables are interrogated to determine the operation of man. It is possible to set the “catch−all” variable $MANOPT to any string in command line format, with the exception that any spaces used as part of an option’s argument must be escaped (preceded by a backslash). man will parse $MANOPT prior to parsing its own command line. Those options requiring an argument will be overridden by the same options found on the command line. To reset all of the options set in $MANOPT, −D can be specified as the initial command line option. This will allow man to “forget” about the options specified in $MANOPT, although they must still have been valid.

Manual pages are normally stored in nroff(1) format under a directory such as /usr/share/man. In some installations, there may also be preformatted cat pages to improve performance. See manpath(5) for details of where these files are stored.

This package supports manual pages in multiple languages, controlled by your locale. If your system did not set this up for you automatically, then you may need to set $LC_MESSAGES, $LANG, or another system−dependent environment variable to indicate your preferred locale, usually specified in the POSIX format:

<è¯è¨>[_<å°åº>[.<å符é>[,<çæ¬>]]]

妿æéç页颿æ¨ç åºå 对åºççæ¬ï¼å®ä¼æ¿ä»£æ åç(é常为ç¾å½è±è¯- )æå页æ¾ç¤ºã

If you find that the translations supplied with this package are not available in your native language and you would like to supply them, please contact the maintainer who will be coordinating such activity.

ç¬ç«çå个æå页é常ç±å个ç¨åºã彿°æç¸å³ä¸»é¢çç»´æ¤èæç¼åæä¾ï¼å®ä»¬å¹¶ä¸åå«äºæ¬è½¯ä»¶åä¸- ã妿æ¨åç°äºç¼ºå¤±æå容ä¸å®æ´çæå页ï¼è¯·å对åºè½¯ä»¶åçç»´æ¤èæ¥åè¿ä¸ªé®é¢ã

æå³æ¤æåå页ç¨åºå¶ä»å¯ç¨åè½åæ©å±çä¿¡æ¯ï¼è¯·é读æ¤åæä¾çææ¡£ã

é»è®¤å¼

The order of sections to search may be overridden by the environment variable $MANSECT or by the SECTION directive in /etc/man_db.conf. By default it is as follows:

1 1p 8 2 3 3p 3pm 4 5 6 7 9 0p n l p o 1x 2x 3x 4x 5x 6x 7x 8x

ç»è¿æ ¼å¼åçæå页å°ä½¿ç¨ä¸ä¸ªå页å¨ï¼pagerï¼è¿è¡æ¾ç¤ºãææ°ç§æå®å页æ¾ç¤ºçæ¹æ³ï¼è¥æ æå®åå°ä½¿ç¨é»è®¤æ¹å¼ï¼åè§ −P é项äºè§£è¯¦ç»ä¿¡æ¯ï¼ã

å¯ä»¥éè¿å ç§æ¹å¼æå®è¿æ»¤ç¨åºãé¦åï¼ä¼æ¥è¯¢å½ä»¤è¡é项 −p æç¯å¢åé $MANROFFSEQãå¦ææ²¡ææå® −pï¼ç¯å¢åé乿ªè®¾ç½®ï¼å°è§£æ nroff ç第ä¸è¡æ¥æ¥æ¾é¢å¤çå¨å符串ãè¦å嫿æçé¢å¤çå¨å- 符串ï¼ç¬¬ä¸è¡å¿é¡»è¿æ ·åï¼

’” <å符串>

å¶ä¸ å符串 å¯ä»¥æ¯ä¸é¢ −p é项ææè¿°çä»»ä½å符çç»åã

妿以䏿¹æ³é½æ²¡ææä¾è¿æ»¤ç¨åºä¿¡æ¯ï¼å°ä½¿ç¨é»è®¤ç¨åºéã

è¿æ»¤ç¨åºå主格å¼åç¨åº(nroff æ [tg]roff −t) å°ç»ææ ¼å¼åæµæ°´çº¿å¹¶æ§è¡ãæèï¼å¦æ man æ æ ¹èç¹æå¯æ§è¡ç mandb_nfmtmandb_tfmt −t) ç¨åºï¼å°è½¬èæ§è¡å®ãæåæºæä»¶ãé¢å¤çå符串ï¼ä»¥åå¯éç以 −T æ −E æå®ç设å¤å°ä½ä¸ºåæ°ä¼ éç»å®ã

é项

Non−argument options that are duplicated either on the command line, in $MANOPT, or both, are not harmful. For options that require an argument, each duplication will override the previous argument value.

常è§é项
−C 
æä»¶−−config−file=æä»¶

ä½¿ç¨æ¤ç¨æ·éç½®æä»¶ä»£æ¿é»è®¤ç ~/.manpathã

−d, −−debug

æå°è°è¯ä¿¡æ¯ã

−D, −−default

æ¤é项é常ä½ä¸ºç¬¬ä¸ä¸ªé项ï¼å®å° man çè¡ä¸ºæ¢å¤ä¸ºé»è®¤å¼ãå®çä½ç¨æ¯é置任ä½å¨ $MANOPT ä¸- 设置çé项ã−D ä¹åçä»»ä½é项ä¿çå¶åæææã

−−warnings[=è¦å]

å¯ç¨æ¥èª groff çè¦åãè¿å¯ä»¥ç¨äºæ£æ¥æåé¡µæºæä»¶å®æ´æ§ãè¦å æ¯ä»¥è±æéå·åéçè¦ååå表ï¼å¦æä¸æä¾ï¼é»è®¤ä¸ºâmacâã请æ¥é info groff ä¸ç “è¦å” èç¹äºè§£å¯ç¨çè¦ååå表ã

ä¸»è¦æä½æ¹å¼
−f
, −−whatis

çåäº whatisãæ¾ç¤ºæ¥èªæå页çå ç®ç说æ(è¥æ)ãè¯¦è§ whatis(1)ã

−k, −−apropos

çåäº aproposãæç´¢å³é®è¯å¯¹åºçæåæ¦è¿°å¹¶æ¾ç¤ºææå¹éç»æãè¯¦è§ aproposã

−K, −−global−apropos

卿ææåä¸- æç´¢ææ¬ãè¿æ¯è®åæç´¢ï¼éè¦è±è´¹ä¸å®æ¶é´ï¼å¦æå¯ä»¥ï¼æ¨åºè¯¥æå®æåç« è以åå°éè¦æç´¢çæå页æ°éãæç´¢æ¡ç®å¯ä»¥æ¯ç®åçå- 符串(é»è®¤)ï¼ææ£å表达å¼(è¥ä½¿ç¨äº −−regex é项)ã

注æï¼è¿ç§åæ³åºç¨äºæç´¢æå页ç èµæºï¼è鿏²æåçææ¬ï¼æä»¥å¯è½ä¼åå«ä¸äºä¸ç¸å¹²çå容ï¼å¦æºæä»¶ä¸- çæ³¨éï¼ãè¥è¦æç´¢æ¸²æåçææ¬ï¼éåº¦ä¼æ¯è¾æ¢ã

−l, −−local−file

Activate “local” mode. Format and display local manual files instead of searching through the system’s manual collection. Each manual page argument will be interpreted as an nroff source file in the correct format. No cat file is produced. If ’−’ is listed as one of the arguments, input will be taken from stdin. When this option is not used, and man fails to find the page required, before displaying the error message, it attempts to act as if this option was supplied, using the name as a filename and looking for an exact match.

−w, −−where, −−path, −−location

Don’t actually display the manual page, but do print the location of the source nroff file that would be formatted. If the −a option is also used, then print the locations of all source files that match the search criteria.

−W, −−where−cat, −−location−cat

Don’t actually display the manual page, but do print the location of the preformatted cat file that would be displayed. If the −a option is also used, then print the locations of all preformatted cat files that match the search criteria.

If −w and −W are both used, then print both source file and cat file separated by a space. If all of −w, −W, and −a are used, then do this for each possible match.

−c, −−catman

æ¤é项ä¸è¬ä¸ä½¿ç¨ï¼å¹¶ä¸åªåºç± catman ç¨åºä½¿ç¨ã

−R ç¼ç −−recode=ç¼ç 

䏿£å¸¸çæ ¼å¼åæå页ä¸åï¼å°è¾å¥æºè½¬æ¢ææå®ç ç¼ç  è¾åºã妿æ¨å·²ç»ç¥éæºæä»¶çç¼ç ï¼ä¹å¯ä»¥ç´æ¥ä½¿ç¨ manconv(1)ãä¸è¿ï¼æ- ¤é项å¯ä»¥å°å ä¸ªæå页转æ¢ä¸ºåä¸ç¼ç ï¼èä¸ç¨æç¡®å£°æåèªçç¼ç ï¼åææ¯å®ä»¬å·²ç»å®è£å¨ä¸æå页屿¬¡ç»æç±»ä¼¼çç®å½ç»æä¸- ã

å¦é转æ¢å¤ä¸ªæå页ï¼è¯·èèä½¿ç¨ man-recode(1) å·¥å·ï¼å®æä¾äºæ¹é转æ¢çæ¥å£ï¼è½å¤å¤§å¤§å å¿«å¤çé度ã

æ¥æ¾æå页
−L 
åºå−−locale=åºå

man é常ä¼éè¿è°ç¨ C è¯è¨å½æ° setlocale(3) æ¥ç¡®å®æ¨çå½ååºå设置ãè¯¥å½æ°ä¼æ¥è¯¢å¤ä¸ªç¯å¢åéï¼å¯è½åæ¬ $LC_MESSAGES å $LANGãè¦ä¸´æ¶è¦çæ£æµå°çå¼ï¼è¯·ä½¿ç¨è¯¥éé¡¹ç´æ¥å man æä¾ä¸ä¸ª åºå å- ç¬¦ä¸²ãæ³¨æï¼å¨æç´¢é¡µé¢å®éå¼å§åå®ä¸ä¼çæã叮婿¶æ¯ç- è¾åºå°å§ç»ä»¥æ£æµå°çåºåè¯è¨æ¾ç¤ºã

−m ç³»ç»[,…], −−systems=ç³»ç»[,…]

妿æ¤ç³»ç»å¯ä»¥è®¿é®å¶ä»æä½ç³»ç»çæå页ï¼å¯ä»¥ä½¿ç¨æ- ¤é项访é®å®ä»¬ãå¦è¦å¨ NewOS çæå页éä¸æç´¢æä¸ªæå页ï¼ä½¿ç¨ −m NewOS é项ã

æå®ç ç³»ç» é项å¯ä»¥æ¯éå·åéçæä½ç³»ç»åç§°ç»åãè¦å¨æç´¢ä¸- 忬æ¬å°æä½ç³»ç»çæå页ï¼å¯ä»¥å¨åæ°å符串ä¸åå«ç³»ç»å manãæ- ¤é项ä¼è¦ç $SYSTEM ç¯å¢åéã

−M è·¯å¾−−manpath=è·¯å¾

æå®è¦ä½¿ç¨çå¦ä¸ manpath è·¯å¾ãé»è®¤æåµä¸ man ä½¿ç¨ manpath å¾å°çä»£ç æ¥ç¡®å®æç´¢è·¯å¾ãæ¤é项ä¼è¦ç $SYSTEM ç¯å¢åéã

æå®ä¸º manpath çè·¯å¾å¿é¡»æ¯åå为è¥å¹²ç« èçæå页屿¬¡ç»æçæ ¹ç®å½ãç« èæè¿°è§ man−db æå(ä½äºâæå页系ç»â)ãè¦æ¥ç屿¬¡ç»æä¹å¤çæå页ï¼è¯·åé −l é项ã

−S å表, −s å表, −−sections=å表

The given list is a colon− or comma−separated list of sections, used to determine which manual sections to search and in what order. This option overrides the $MANSECT environment variable. (The −s spelling is for compatibility with System V.)

−e sub−extension−−extension=sub−extension

Some systems incorporate large packages of manual pages, such as those that accompany the Tcl package, into the main manual page hierarchy. To get around the problem of having two manual pages with the same name such as exit(3), the Tcl pages were usually all assigned to section l. As this is unfortunate, it is now possible to put the pages in the correct section, and to assign a specific “extension” to them, in this case, exit(3tcl). Under normal operation, man will display exit(3) in preference to exit(3tcl). To negotiate this situation and to avoid having to know which section the page you require resides in, it is now possible to give man a sub−extension string indicating which package the page must belong to. Using the above example, supplying the option −e tcl to man will restrict the search to pages having an extension of *tcl.

−i, −−ignore−case

æç´¢æå页æ¶å¿½ç¥å¤§å°åãæ¤ä¸ºé»è®¤å¼ã

−I, −−match−case

æç´¢æå页æ¶å¹é大å°åã

−−regex

æ¾ç¤ºååææè¿°çä»»ä½é¨å䏿æä¾çæ£åè¡¨è¾¾å¼ é¡µ åæ°å¹éçææé¡µé¢ï¼åä½¿ç¨ apropos(1) 䏿 ·ãç±äºæç´¢æ- £åè¡¨è¾¾å¼æ¶éå¸¸æ²¡åæ³éåºâæä½³âæåé¡µï¼æ¤é项éå«äº −a é项ã

−−wildcard

æ¾ç¤ºååææè¿°çä»»ä½é¨å䏿æä¾ç shell æ ¼å¼éé符 页 åæ°å¹éçææé¡µé¢ï¼åä½¿ç¨ apropos(1) −−wildcard 䏿 ·ã页 åæ°å¿é¡»å¹éæ´ä¸ªååææè¿°ï¼æå¹éæè¿°ä¸- åè¯çè¾¹çãç±äºæç´¢éé符æ¶éå¸¸æ²¡åæ³éåºâæä½³âæåé¡µï¼æ¤é项éå«äº −a é项ã

−−names−only

å¦æä½¿ç¨äº −−regex æ −−wildcard é项ï¼ååªå¹éæå页åèä¸å¹éæè¿°ï¼å°±åä½¿ç¨ whatis(1) 䏿 ·ãå¦åä¸èµ·ä½ç¨ã

−a, −−all

é»è®¤æåµä¸ï¼man 卿¾ç¤ºå®æ¾å°çæç¬¦åçæå页åä¼éåºãæ¤éé¡¹å¼ºå¶ man æ¾ç¤ºååå¹éæç´¢æ¡ä»¶çææçæå页ã

−u, −−update

该é项å°ä½¿å¾ man æ´æ°å·²å®è£æå页çç¼å- æ°æ®åºã该æä½åªå¨æå°æ°æåµä¸æéè¦è¿è¡ï¼ä¸è¬æåµä¸åªè¿è¡ mandb(8) æ´å¥½ã

−−no−subpages

é»è®¤æåµä¸ï¼man ä¼è¯å¾å°å½ä»¤è¡ä¸æä¾çä¸å¯¹æå页åè§ååå«è¿å- 符æä¸å线çå个æåé¡µåæ¥è§£éãè¿ä¼æ¯æé£äºå®ç°äºå¤ä¸ªå- å½ä»¤çç¨åºçå¸¸è§æ¨¡å¼ï¼å许ç¨åºä¸ºæ¯ä¸ªå- å½ä»¤æä¾æå页ï¼å¹¶ç¨åè°ç¨ååå½ä»¤çè¯- æ³ç±»ä¼¼çæ¹å¼è®¿é®å®ä»¬ãä¾å¦ï¼

$ man −aw git diff
/usr/share/man/man1/git−diff.1.gz

è¦ç¦ç¨æ¤è¡ä¸ºï¼è¯·ä½¿ç¨ −−no−subpages é项ã

$ man −aw −−no−subpages git diff
/usr/share/man/man1/git.1.gz
/usr/share/man/man3/Git.3pm.gz
/usr/share/man/man1/diff.1.gz

æ§å¶æ ¼å¼åè¾åº
−P 
å页ç¨åº−−pager=å页ç¨åº

æå®ä½¿ç¨åªä¸ªè¾åºå页ç¨åºãman é»è®¤ä½¿ç¨ lessï¼å¨æ æ³æ¾å° less æå®ä¸æ¯å¯æ§è¡æä»¶æ¶åä¼åéå°ä½¿ç¨ catãæ¤é项ä¼è¦ç $MANPAGER ç¯å¢åéï¼è¿ä¸æ¥è¦ç $PAGER ç¯å¢åéãå®ä¸å −f æ −k åç¨ã

å¼å¯ä»¥æ¯ç®åçå½ä»¤åæå¸¦åæ°çå½ä»¤ï¼å¹¶å¯ä»¥ä½¿ç¨ shell å¼ç¨(åææ ãåå¼å·æåå¼å·)ãä¸è½ä½¿ç¨ç®¡éè¿æ¥å¤ä¸ªå½ä»¤ï¼å¦ææ¨éè¦ï¼è¯·ä½¿ç¨å°è£å¨èæ¬ï¼å®è½å¤ä»¥åæ°å½¢å¼æä»æ åè¾å¥è·å¾è¦æ¾ç¤ºçæä»¶ã

−r æç¤º−−prompt=æç¤º

å¦æä½¿ç¨è¾æ°ç less ä½ä¸ºå页ç¨åºï¼man å°å°è¯è®¾ç½®å®çæç¤ºæ¶æ¯åä¸äºææé项ãé»è®¤çæç¤ºæ¶æ¯ç±»ä¼¼äº

Manual page name(sec) line x

å¶ä¸ name 表示æå页åï¼sec 表示æ¾å°çæå页æå±çç« èï¼x æ¯å½åè¡å·ãè¿æ¯éè¿ä½¿ç¨ $LESS ç¯å¢åéå®ç°çã

Supplying −r with a string will override this default. The string may contain the text $MAN_PN which will be expanded to the name of the current manual page and its section name surrounded by “(” and “)”. The string used to produce the default could be expressed as

 Manual page $MAN_PN ?ltline %lt?L/%L.:
byte %bB?s/%s..? (END):?pB %pB\%..
(press h for help or q to quit)

ä¸ºäºæ¹ä¾¿é读ï¼è¿éåæäºä¸è¡ãå符串çå«ä¹è¯·åé less(1) æå页ãæç¤ºå符串å°é¦åç± shell è§£éãæç¤ºä¸- çææçåå¼å·ãåææ é½å¿é¡»å¨åé¢å ä¸ä¸ªåææ è½¬ä¹ãæç¤ºå- 符串å¯ä»¥è½¬ä¹ç $ ç»æï¼åé¢è¿å¯ä»¥è·å¶ä»ç less é项ãman é»è®¤è®¾ç½® −ix8 é项ã

ä¸é¢æè¿°ç $MANLESS ç¯å¢åéå¯ä»¥ç¨æ¥å¨å½ä»¤è¡æªæå®æ¶è®¾ç½®é»è®¤çæç¤ºå符串ã

−7, −−ascii

å½å¨7ä½ç¼ç çç»ç«¯æç»ç«¯æ¨¡æå¨ä¸æ¥ç纯 ascii(7) æå页æ¶ï¼è¥ä½¿ç¨ GNU nroff latin1(7) è®¾å¤æè¿°ï¼ä¸äºå符å¯è½æ¾ç¤ºä¸æ£ç¡®ãæ- ¤é项å许纯 ascii æåé¡µä½¿ç¨ latin11 设å¤ä»¥ ascii æ¾ç¤ºãå®ä¸ä¼è½¬æ¢ä»»ä½ latin1 ææ¬ã以ä¸è¡¨æ ¼æ¾ç¤ºäºè¿è¡ç转æ¢ï¼å¶ä¸ä¸é¨åå¯è½åªæå¨ä½¿ç¨ GNU nroff ç latin1(7) è®¾å¤æ¶ææ£ç¡®æ¾ç¤ºã

Image grohtml-969703.png

妿 latin1 åæ¾ç¤ºæ£ç¡®ï¼æ¨çç»ç«¯å¯è½ä½äº latin1 åç¬¦è®¾ç½®ï¼æ- ¤é项å°ä¸éè¦ã妿 latin1 å ascii å䏿 ·ï¼é£ä¹æ¨æ£å¨ä½¿ç¨æ- ¤é项éè¯»æ¬æåé¡µï¼æ man æªä½¿ç¨ latin1 è®¾å¤æè¿°æ¥æ ¼å¼åæ- ¤é¡µã妿 latin1 å缺æï¼æ¨å¯è½è¦ä½¿ç¨æ¤éé¡¹æ¥æ¥çæå页ã

å¨ä½¿ç¨ −t, −H, −T, æ −Z éé¡¹æ¶æ¤é项å¯è½å¯¹ GNU ç ä¹å¤ç nroff ç¨åºæ ç¨ã

−E ç¼ç −−encoding=ç¼ç 

çæå¯¹åºå符ç¼ç çè¾åºï¼èéé»è®¤ç¼ç ã为ååå¼å®¹ï¼ç¼ç  å¯ä»¥æ¯ nroff 设å¤ï¼å¦ asciiãlatin1 æ utf8ï¼ä¹å¯ä»¥æ¯å®éçå符ç¼ç å¦ UTF−8ã

−−no−hyphenation, −−nh

é常ï¼å¦æéè¦å°åè¯æå¨ä¸è¡è䏿·»å è¿å¤çç©ºæ ¼ï¼ nroff ä¼å¨æ¢è¡å¤èªå¨æå(ç»ææ¬æ·»å è¿å符ï¼å³ä½¿åè¯æ¬æ¥ä¸åå«)ãæ¤éé¡¹ç¦æ- ¢èªå¨æåï¼å³åè¯åå«è¿åç¬¦æ¶æä¼è¢«æå¼ã

妿æ¨ç¼åæå页æ¶åªæ¯ä¸å¸æ nroff å¨æä¸ªä½ç½®ä¸æ°å½å°æå- ï¼ä¸è¦ä½¿ç¨æ¤é项ï¼èåºæ¥é nroff ææ¡£ä¸- çç¸å³æ¹æ³ï¼ä¾å¦ï¼æ¨å¯ä»¥å¨åè¯ä¸æå¥â%âæ¥æç¤ºè¯¥ä½ç½®å¯ä»¥æå- ï¼æå¨åè¯å¼å¤´æå¥â%âæ¥é»æ¢å¯¹å®æåã

−−no−justification, −−nj

é常ï¼nroff ä¼èªå¨ä¸¤ç«¯å¯¹é½ææ¬ãæ¤éé¡¹ç¦æ- ¢ä¸¤ç«¯å¯¹é½ï¼åªå¯¹é½å·¦è¾¹ï¼å½¢ææè°çâragged−rightâ(å³è¾¹ä¸é½)çææ¬ã

妿æ¨ç¼åæå页æ¶åªæ¯ä¸å¸æ nroff å¯¹é½æäºæ®µè½ï¼ä¸è¦ä½¿ç¨æ- ¤é项ï¼èåºæ¥é nroff ææ¡£ä¸- çç¸å³æ¹æ³ï¼ä¾å¦ï¼æ¨å¯ä»¥ä½¿ç¨â.naâãâ.nfâãâ.fiâåâ.adâè¯·æ±æ¥ä¸´æ¶ç¦æ- ¢å¯¹é½åå¡«åã

−p å符串−−preprocessor=å符串

æå® nroff æ troff/groff ä¹åè¿è¡çé¢å¤çå¨åºåãç³»ç»ä¸- å¯è½æªå®è£ææçé¢å¤çå¨ãä¸äºé¢å¤çå¨åå¶ä»£å·å¦ä¸ï¼eqn (e), grap (g), pic (p), tbl (t), vgrind (v), refer (r)ãæ¤é项è¦ç $MANROFFSEQ ç¯å¢åéãzsoelim æ»æ¯ä½ä¸ºç¬¬ä¸ä¸ªé¢å¤çå¨è¿è¡ã

−t, −−troff

ä½¿ç¨ %troff æ¥æ ¼å¼åæåé¡µå° stdoutãæ¤é项ä¸è¦æ±å −Hã−T æ −Z ä¸èµ·ä½¿ç¨ã

−T[设å¤], −−troff−device[=设å¤]

æ¤é项ç¨äºæ´æ¹ groff (ä¹å¯è½æ¯ troff) çè¾åºä»¥éåæä¸ªéé»è®¤è®¾å¤ãæ¤é项éå«äº −tã(Groff−1.17 æä¾ç)ä¾å忬 dviãlatin1ãpsãutf8ãX75 å X100ã

−H[æµè§å¨], −−html[=æµè§å¨]

æ¤é项使 groff çæ HTML è¾åºå¹¶å¨æµè§å¨ä¸- æ¾ç¤ºè¾åºç»æãæµè§å¨éæ©åå³äºå¯éç browser åæ°(è¥æä¾)ã$BROWSER ç¯å¢åéï¼æç¼è¯æ¶æå®çé»è®¤å¼(æç¯å¢åéæªè®¾ç½®ï¼é»è®¤å¼é常为 lynx)ãæ¤é项éå«äº −tï¼å¹¶åªå GNU troff ä¸èµ·ä½¿ç¨ã

−X[dpi], −−gxditview[=dpi]

æ¤éé¡¹ä½¿ç¨ gxditview ç¨åºå¨ä¸ä¸ªå¾å½¢çªå£ä¸æ¾ç¤º groff çè¾åºç»æãdpi (ç¹/è±å¯¸)å¯ä»¥æ¯ 75ã75−12ã100 æ 100−12ï¼é»è®¤ä¸º 75ï¼−12 å½¢å¼ä½¿ç¨ 12 ç¹çåºç¡åå·ãæ¤é项éå«äºå¸¦ç¸åº X75ãX75−12ãX100 æ X100−12 åæ°ç −T é项ã

−Z, −−ditroff

groff ä¼è¿è¡ troff ç¶å使ç¨åéçåå¤çå¨äº§çéåæé设å¤çè¾åºã妿 %troff 为 groffï¼æ¤é项ä¼ä¼ éç» groff å¹¶ç¦æ¢ä½¿ç¨åå¤çå¨ãæ- ¤é项éå«äº −t é项ã

è·å帮å©
−?
, −−help

æå°å¸®å©æ¶æ¯å¹¶éåºã

−−usage

æå°ç®çç叮婿¶æ¯å¹¶éåºã

−V, −−version

æ¾ç¤ºçæ¬ä¿¡æ¯ã

éåºç¶æ

0

ç¨åºæåæ§è¡ã

1

ç¨æ³ãè¯æ³æéç½®æä»¶åºéã

2

æä½åºéã

3

åè¿ç¨è¿åäºéé¶çéåºç¶æç ã

16

è³å°æä¸ä¸ªé¡µé¢/æä»¶/å³é®è¯ä¸å卿ä¸å¹éã

ç¯å¢

MANPATH

å¦æè®¾ç½®äº $MANPATHï¼å®çå¼ä¼ç¨ä½æç´¢æå页çè·¯å¾ã

MANROFFOPT

æ¯å½ man è°ç¨æ ¼å¼å工巿¶ï¼nroffãtroff æ groffï¼ï¼å®å°æ $MANROFFOPT çå容添å è³æ ¼å¼åå·¥å·çå½ä»¤è¡åæ°ã

MANROFFSEQ

å¦æè®¾ç½®äº $MANROFFSEQï¼å®çå¼ä¼ç¨äºç¡®å®æ¯ä¸ªæå页ç»è¿çé¢å¤çç¨åºçéåãé»è®¤çé¢å¤çå¨å表å ç³»ç»èå¼ã

MANSECT

å¦æè®¾ç½®äº $MANSECTï¼å®çå¼(以åå·åéçç« èå表)ä¼ç¨äºç¡®å®æç´¢åªäºç« èåæç´¢é¡ºåºãé»è®¤å¼ä¸ºâ1 1p 8 2 3 3p 3pm 4 5 6 7 9 0p n l p o 1x 2x 3x 4x 5x 6x 7x 8xâï¼é¤é被 /etc/man_db.conf ä¸ç SECTION æä»¤è¦çã

MANPAGER, PAGER

å¦æè®¾ç½®äº $MANPAGER æ $PAGER (ä¼åä½¿ç¨ $MANPAGER)ï¼å®çå¼ä¼ç¨ä½æ¾ç¤ºæå页çç¨åºçåç§°ãé»è®¤ä½¿ç¨ lessï¼å¦ææ æ³æ¾å° less æå®ä¸æ¯å¯æ§è¡æä»¶çè¯åä¼åéå°ä½¿ç¨ catã

å¼å¯ä»¥æ¯ç®åçå½ä»¤åæå¸¦åæ°çå½ä»¤ï¼å¹¶å¯ä»¥ä½¿ç¨ shell å¼ç¨(åææ ãåå¼å·æåå¼å·)ãä¸è½ä½¿ç¨ç®¡éè¿æ¥å¤ä¸ªå½ä»¤ï¼å¦ææ¨éè¦ï¼è¯·ä½¿ç¨å°è£å¨èæ¬ï¼å®è½å¤ä»¥åæ°å½¢å¼æä»æ åè¾å¥è·å¾è¦æ¾ç¤ºçæä»¶ã

MANLESS

å¦æè®¾ç½®äº $MANLESSï¼å®çå¼å°ç¨ä½ less å页ç¨åºçé»è®¤æç¤ºå- 符串ï¼å¦åä½ä¸º −r é项çåæ°ä¼ é䏿 ·(å æ¤åºç°çä»»ä½ $MAN_PN ä¼ä»¥åæ ·çæ¹å¼å±å¼)ãä¾å¦ï¼å¦ææ¨æ³å°æç¤ºå- ç¬¦ä¸²æ æ¡ä»¶å°è®¾ç½®ä¸º“my prompt string”ï¼è¯·å° $MANLESS 设置为 ‘−Psmy prompt string’ãä½¿ç¨ −r é项ä¼è¦çæ¤ç¯å¢åéã

BROWSER

å¦æè®¾ç½®äº $BROWSERï¼å®çå¼(åå·åéçå½ä»¤å表)ä¸- çæ¯ä¸ä¸ªä¼è½®æµç¨äºå°è¯ä¸º man −−html å¯å¨ä¸ä¸ªç½ç»æµè§å¨ãæ¯ä¸ªå½ä»¤ä¸ï¼%s 伿¿æ¢æåå« groff HTML è¾åºçæä»¶åï¼%% 伿¿æ¢æä¸ä¸ªç¾åå·(%)ï¼%c 伿¿æ¢æåå·(:)ã

SYSTEM

å¦æè®¾ç½®äº $SYSTEM ç¯å¢åéï¼å¶ææå°ä¸ −m é项çåæ°ç¸åã

MANOPT

å¦æè®¾ç½®äº $MANOPTï¼å®ä¼åäº man çå½ä»¤è¡å¹¶åè®¾ä¸ºç±»ä¼¼çæ ¼å¼æ¥è§£æãç±äºææå¶ä»ç man ç¹å®ç¯å¢åéå¯ä»¥è¡¨è¾¾ä¸ºå½ä»¤è¡é项èå¯ä»¥å被å«è¿ $MANOPTï¼å æ¤ è¿äºç¯å¢åéå¯è½åºå¼ã注æï¼ææåºå½è§£é为å½ä»¤è¡é项忰ä¸é¨åç空格å¿é¡»è¢«è½¬ä¹ã

MANWIDTH

If $MANWIDTH is set, its value is used as the line length for which manual pages should be formatted. If it is not set, manual pages will be formatted with a line length appropriate to the current terminal (using the value of $COLUMNS, and ioctl(2) if available, or falling back to 80 characters if neither is available). Cat pages will only be saved when the default formatting can be used, that is when the terminal line length is between 66 and 80 characters.

MAN_KEEP_FORMATTING

é常ï¼å½è¾åºä¸å®åå°ç»ç«¯æ¶(å¦å®åå°æä»¶æç®¡é)ï¼æ ¼å¼åå- 符ä¼è¢«å¿½ç¥ï¼ä»¥ä¾¿ä¸ä½¿ç¨ç¹æ®å·¥å·å°±è½éè¯»ç»æãä½å¦æ $MAN_KEEP_FORMATTING 设置æäºä»»ä½é空çå¼ï¼è¿äºæ ¼å¼åå符å°ä¿å- ãè¿å¯¹äºå¯ä»¥è§£éæ ¼å¼åå符ç man å°è£ç¨åºæç¨ã

MAN_KEEP_STDERR

é常ï¼å½è¾åºå®åå°ç»ç«¯æ¶(ä¸è¬æ¯å页ç¨åº)ï¼äº§çæåæ ¼å¼åçæ¬çå½ä»¤é æçä»»ä½é误è¾åºé½ä¼è¢«å¿½ç¥ï¼ä»¥åå¹²æ°å页ç¨åºæ¾ç¤ºãgroff è¿æ ·çç¨åº¦ç»å¸¸äº§çè¾å°çæå³æçæ¾ç¤ºçéè¯¯æ¶æ¯(妿ªå¯¹é½)ãè¿äºæ¶æ¯å¾é¾çï¼å¹¶ä¸ä¸è¬ä¸æå页ä¸èµ·æ¾ç¤ºæ¶ä¼äº§çå¹²æ°ãä¸è¿ï¼æäºç¨æ·å°±æ¯æ³çå°å®ä»¬ï¼å¥½å§ï¼å¦æ $MAN_KEEP_STDERR 设æäºé空çå¼ï¼è¿äºé误è¾åºä¼ç§å¸¸æ¾ç¤ºã

LANG, LC_MESSAGES

åå³äºç³»ç»åå®ç°ï¼ç¨åºä¼æ¥è¯¢ $LANG å/æ $LC_MESSAGES è·ç¥å½åçæ¶æ¯åºåè¯è¨ãman ä¼ä»¥è¯¥åºåè¯è¨æ¾ç¤ºæ¶æ¯(è¥å¯ç¨)ãåé setlocale(3) äºè§£åç¡®ç详æã

æä»¶

/etc/man_db.conf

man−db éç½®æä»¶ã

/usr/share/man

å¨å±æå页屿¬¡ç»æã

亦è§

apropos(1), groff(1), less(1), manpath(1), nroff(1), troff(1), whatis(1), zsoelim(1), manpath(5), man(7), catman(8), mandb(8)

æäºåçææ¡£å¯è½ä»¥å¶å®æ ¼å¼æä¾ï¼å¦ info(1) æ HTMLã

åå²

1990, 1991 – åä½è John W. Eaton (jwe@che.utexas.edu)ã

1992å¹´12æ23æ¥: Rik Faith (faith@cs.unc.edu) åºç¨äº Willem Kasdorp (wkasdo@nikhefk.nikef.nl) æä¾ç bug è¡¥ä¸ã

1994å¹´4æ30æ¥ – 2000å¹´2æ23æ¥: Wilf. (G.Wilford@ee.surrey.ac.uk) å¨å ä½çå¿äººç帮å©ä¸å¼ååç»´æ¤è¿ä¸ªåã

1996å¹´10æ30æ¥ – 2001å¹´3æ30æ¥: Fabrizio Polacco 为 Debian 项ç®ç»´æ¤å¹¶å¢å¼ºäºè¿ä¸ªåï¼è¿ç¨ä¸å¾å°æ´ä¸ªç¤¾åºç帮å©ã

2001å¹´3æ31æ¥ – ä»å¤©: Colin Watson å¼ååç»´æ¤ç man−dbã

BUGS

https://savannah.nongnu.org/bugs/?group=man-db