常规选项¶

-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) 设备时才正确显示。

描述	八进制	latin1	ascii
连字符	255	‐	-
点(中间点)	267	•	o
重音符号	264	´	'
乘号	327	×	x

如果 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

显示版本信息。