man page

来自 Arch Linux 中文维基

man 手册页,指 "manual pages",是类 UNIX 系统的标准手册工具,Arch 也不例外。显示 man 手册页的命令是:man

man手册页被设计成独立的文档,不能引用其它手册页面。这与支持超链接的 Info 文档形成鲜明对比,GNU正在将 man 手册替换成 info 文档。

安装[编辑 | 编辑源代码]

man-db 提供了 man 命令,lessman 的默认分页器。

man-pages 提供了 Linux man 页面的内容。

下面是一些语言的翻译版本:

下面程序也可以用来阅读手册:

  • GNOME HelpGNOME 帮助阅读程序。 通过 yelp man:<name>Ctrl+L 快捷键阅读手册页面。
https://wiki.gnome.org/Apps/Yelp || yelp
  • KHelpCenterKDE 帮助阅读程序,可以通过 khelpcenter man:<name> 阅读手册。
https://userbase.kde.org/KHelpCenter || khelpcenter
  • Konqueror — KDE 文件和网页浏览器,也可以通过 man:<name> 显示手册。
https://konqueror.org/ || konqueror
  • xman — 可以分类查看手册。
https://xorg.freedesktop.org/ || xorg-xman

阅读手册页[编辑 | 编辑源代码]

通过以下命令阅读man手册页:

$ man 手册名

man手册页分为很多段落。完整的列表可以参考: man-pages(7).

man手册页通过名称和所属分类标识。有些不同分类的man手册页名字可能相同,比如 man(1) 和 man(7),这时需要额外指明分类以访问需要的手册。例如:

$ man 5 passwd

会显示有关文件/etc/passwd,而非命令 passwd,的内容。

搜索手册页[编辑 | 编辑源代码]

如果用户压根儿不知道要查阅的手册的名称,该怎么办呢?没事,通过 -k 或者 --apropos 参数就可以按给定关键词搜索相关手册。例如,要查阅有关密码的手册(“password”):

关键词搜索特性是从一个专用的缓存生成的。默认情况下你没有这个缓存,所以无论你搜什么,都会提示你nothing appropriate。你可以通过下面的命令来生成这个缓存:

# mandb

每当你安装新的manpage之后都需要运行这个命令,缓存才会更新。

现在你可以开始搜索了。 例如,要查阅有关密码的手册(“password”),可以使用下面的命令:

$ man -k password
$ man --apropos password
$ apropos password

关键字可以使用正则表达式。

如果你想全文搜索的话,你可以用-K选项:

$ man -K password

通过whatis命令,可以只显示需要的man手册页的简要信息。如果只是想获取对命令 ls 的简要说明,使用以下命令:

$ whatis ls
ls (1p)              - list directory contents
ls (1)               - list directory contents

使用浏览器阅读手册页[编辑 | 编辑源代码]

还可以通过 lynxFirefox之类的浏览器阅读man手册页。由于使用浏览器,手册页可以支持超链接。

此外,KDE用户可以直接在Konqueror使用以下地址访问man手册:

man:<name>

转换为 HTML[编辑 | 编辑源代码]

man2html[编辑 | 编辑源代码]

首先,安装软件包man2html

然后使用它转换man手册页:

$ man free | man2html -compress -cgiurl man$section/$title.$section$subsection.html > ~/man/free.html

此外,man2html还可以把man页转换为便于打印的文本文件:

$ man free | man2html -bare > ~/free.txt

man -H[编辑 | 编辑源代码]

Arch提供的man也具有浏览器阅读功能:

$ man -H free

BROWSER环境变量决定使用的浏览器。也可以使用 man -Hlynx(H后无空格)这样的形式手动设置浏览器。

转换为 PDF[编辑 | 编辑源代码]

man pages 是可以打印的,遵循 troff 格式,本来就是一种打印设置语言,安装 ghostscript 后,可以用下面命令将 man 页面转换为 PDF man -t <manpage> | ps2pdf - <pdf>.

注意这里仅能使用 Times 字体,没有超链接,有些手册是转为终端设计,PS 或 PDF 格式看起来不太正常。

使用在线手册页[编辑 | 编辑源代码]

许多网站提供在线man手册页,详细列表参见:Wikipedia:Man_page#Repositories_of_manual_pages