常规选项¶

-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

启用“本地”方式。格式化并显示本地手册文件，而非搜索系统手册集。每个手册页参数将解释为格式正确的 nroff 源文件。不产生 cat 文件。如果参数中有“-”，将从标准输入读取。如果未指定它，而 man 未找到要求的页面，在显示错误消息前 man 会假设指定了此选项进行尝试，使用名称作为文件名并查找精确匹配。

-w, --where, --path, --location

不显示手册页，但打印将被格式化的 nroff 文件的位置。

-W, --where-cat, --location-cat

不实际显示手册页，但打印将显示的 cat 文件的位置。如果同时指定了 -w 和 -W，则同时打印二者，以空格隔开。

-c, --catman

此选项一般不使用，并且只应由 catman 程序使用。

-R 编码, --recode=编码

与正常的格式化手册页不同，将输入源转换成指定的 编码 输出。如果您已经知道源文件的编码，也可以直接使用 manconv(1)。不过，此选项可以将几个手册页转换为单一编码，而不用明确声明各自的编码，前提是它们已经安装在与手册页层次结构类似的目录结构中。

查找手册页¶

-L 区域, --locale=区域

man 通常会通过调用 C 语言函数 setlocale(3) 来确定您的当前区域设置。该函数会查询多个环境变量，可能包括 $LC_MESSAGES 和 $LANG。要临时覆盖检测到的值，请使用该选项直接向 man 提供一个 区域 字符串。注意，在搜索页面实际开始前它不会生效。帮助消息等输出将始终以检测到的区域语言显示。

-m 系统[,...], --systems=系统[,...]

-M 路径, --manpath=路径

指定要使用的另一 manpath 路径。默认情况下 man 使用 manpath 得到的代码来确定搜索路径。此选项会覆盖 $SYSTEM 环境变量。

指定为 manpath 的路径必须是划分为若干章节的手册页层次结构的根目录。章节描述见 man-db 手册(位于“手册页系统”)。要查看层次结构之外的手册页，请参阅 -l 选项。

-S 列表, -s 列表, --sections=列表

要搜索的“指定顺序”的手册章节列表，以英文冒号或逗号分隔。此选项会覆盖 $MANSECT 环境变量。(使用 -s 表示是为了与 System V 兼容。)

-e sub-extension, --extension=sub-extension

某些系统包含大量的手册页包，例如某些系统将 Tcl (手册)包并入主手册页层次目录。为避免两个手册页重名，如 exit(3)，Tcl 手册页通常都归于 l 章节。为解决这一不便，现在可以将页面放在正确的节，分配给它们一个特定的“扩展(extension”即可；这个例子中，就是 exit(3tcl)。正常操作时，man 会优先显示 exit(3) 而不是 exit(3tcl)。为协调这一状况并避免要记住所需手册页属于哪个章节，现在可以给 man 指定一个 sub-extension字符串，指示该手册页必须属于哪个包。对于上面的例子，给 man 加上 -e tcl 选项，就能限制只搜索带有 *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 对数据库缓存进行“inode 级别”的一致性检查，以保证缓存与文件系统精确对应。只有安装的 man 程序设置了 setuid 权限位时它才有效。

--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 默认使用 pager，在无法找到 pager 或它不是可执行文件时则会回退到使用 cat。此选项会覆盖 $MANPAGER 环境变量，进一步覆盖 $PAGER 环境变量。它不和 -f 或 -k 合用。

值可以是简单的命令名或带参数的命令，并可以使用 shell 引用(反斜杠、单引号或双引号)。不能使用管道连接多个命令；如果您需要，请使用封装器脚本，它能够以参数形式或从标准输入获得要显示的文件。

-r 提示, --prompt=提示

如果使用较新的 less 作为分页程序，man 将尝试设置它的提示消息和一些敏感选项。默认的提示消息类似于

 Manual page name(sec) line x

其中 name 表示手册页名，sec 表示找到的手册页所属的章节，x 是当前行号。这是通过使用 $LESS 环境变量实现的。

提供一个带字符串的 -r 选项会覆盖这个默认值。字符串可以包含文本 $MAN_PN，它会展开为用“(”和“)”括起来的当前手册页的章节名。显示默认提示的字符串可以表示为

\ 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

显示版本信息。