cnman:1:man

MAN(1) -- 格式化并显示在线手册页面

FreeBSD General Commands Manual

名称

man -- 格式化并显示在线手册页面

摘要

man [-adfhkotw] [-m arch[:machine]] [-p string] [-M path] [-P pager]
man [-S list] [section] name

描述

此程序用于格式化并显示在线手册页面。当前版本支持利用环境变量MANPATH与PAGER自定义页面及调度程序;若指定了参数section则仅查询特定章节;也可以指定章节的搜索顺序和预处理时的相关选项及环境变量。若系统管理员允许,格式化后的页面会通过命令/usr/bin/gzip -c压缩以节省空间。
可用选项包括:

-M path替换manpath。默认情况下将使用manpath(1)(内建于man程序中)确定搜索路径;此选项会覆盖环境变量MANPATH。
-P pager指定页面调度程序。默认情况下将使用more -s;此选项会覆盖环境变量PAGER。
-S list参数list指定了搜索的章节范围,其值为使用:分隔各项的一个列表,每项的数字对应一个章节;此选项会覆盖环境变量MANSECT。
-a显示所有匹配参数name取值的页面。默认情况下仅显示首个匹配的页面。
-d仅列出执行时的调试信息而不显示页面。
-f相当于whatis命令。
-h列出man程序的帮助信息。
-k相当于apropos命令。
-m arch[:machine]参数arch表示系统架构,参数machine表示机器类型;由此可以限制搜索范围,注意机器类型优先于系统架构。例如若使用i386:pc98,则会依次搜索子目录man8/pc98、man8/i386与man8。参数arch会覆盖环境变量MACHINE_ARCH,参数machine会覆盖环境变量MACHINE。
-o查找原始(非本地化)页面。默认情况下将根据manpath(1)搜索本地化页面。首先依次查询环境变量LC_ALL、LC_CTYPE与LANG并从中选取首个非空值作为本地化名称,然后依次搜索名称格式为_lang___country_._charset_、_lang_._charset_与en._charset_的子目录;若失败则仅查询非本地化页面。例如,本地化名称为de_DE.ISO8859-1时会依次搜索目录/usr/share/man/de_DE.ISO8859-1、/usr/share/man/de.ISO8859-1与/usr/share/man/en.ISO8859-1;若失败则仅查询默认目录/usr/share/man。
-p string指定在nroff(1)troff(1)之前运行的预处理器顺序。系统安装时可能会包括以下预处理器:eqn(e)、grap(g)、pic(p)、tbl(t)、vgrind(v)及refer(r)。此选项会覆盖环境变量MANROFFSEQ。
-t使用/usr/bin/groff -S -man格式化手册页面并将其发送至标准输出。groff(1)的默认输出格式为Postscript,详见其手册页面。输出前可能需要根据所选格式及打印设备进行预处理,例如使用过滤器。
-w仅列出页面文件的路径而不显示页面。

环境

LC_ALL, LC_CTYPE, LANG这些变量用于指定页面首选语言。(参考之前的选项-o)
MACHINE此变量用于指定机器类型。
MACHINE_ARCH此变量用于指定系统架构。
MANPATH此变量用于指定页面的搜索路径。
MANROFFSEQ此变量用于指定优先于nroff(1)troff(1)运行的预处理器。默认情况下,在nroff(1)前会首先使用表格预处理器(tbl(1))。
MANSECT此变量用于指定搜索的章节范围。
PAGER此变量用于指定页面调度程序。默认情况下为more -s。

范例

若要在手册中查看与getpot相关的页面,可以使用:

man getopt

若仅查看特定章节,例如getopt(3),可以使用:

man 3 getopt

参考

缺陷

选项-t仅在安装了troff(1)类程序后生效。

/data/vhosts/wiki-data/pages/cnman/1/man.txt · 最后更改: 2010/10/20 01:25 由 alphachi