转自: http://www.fire3.cn/2008/08/03/linux-howto-read-man-page.html
Table of Contents
1 什么是man手册
首先，man是manual的简称，中文说法可以是手册。
在Linux世界中，许多新手请教某条命令的用法时， 好多不耐心的老手通常会用一条命令来回答这位无助的新手，而这条命令通常
就是man开头。无助的新手敲上这条命令一看究竟，在终端上顿时显示出来了一屏幕的英文，
老手的意思是，自己看看手册吗，可是看手册也是有学问的，无助的新手甚
至不知道怎么退出这条命令呢。下面我们就来讲解一下看man手册的学问。
2 从man手册中获取有用的信息
我们先以mkdir命令来解释读man手册的一些入门知识。
MKDIR(1) FSF MKDIR(1)
NAME
mkdir - make directories
SYNOPSIS
mkdir [OPTION] DIRECTORY...
DESCRIPTION
Create the DIRECTORY(ies), if they do not already exist.
Mandatory arguments to long options are mandatory for short options
too.
-m, --mode=MODE
set permission mode (as in chmod), not rwxrwxrwx - umask
-p, --parents
no error if existing, make parent directories as needed
-v, --verbose
print a message for each created directory
--help display this help and exit
--version
output version information and exit
AUTHOR
Written by David MacKenzie.
REPORTING BUGS
Report bugs to .
COPYRIGHT
Copyright ? 2002 Free Software Foundation, Inc.
This is free software; see the source for copying conditions. There is
NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
PURPOSE.
SEE ALSO
The full documentation for mkdir is maintained as a Texinfo manual. If
the info and mkdir programs are properly installed at your site, the
command
info mkdir
should give you access to the complete manual.
首先第一行 MKDIR(1)，显然，MKDIR是命令的大写，那么为什么有个(1)呢，那是因为man手册页有如下的规定：
| Section | 名称 | 说明 |
|---|---|---|
| l | 本地文档 | 与本特定系统有关的 |
| 1 | 用户命令 | 可由任何人启动的 |
| 2 | 系统调用 | 即由内核提供的函数 |
| 3 | 例程 | 即库函数 |
| 4 | 设备 | 即/dev目录下的特殊文件 |
| 5 | 文件格式描述 | 例如/etc/passwd |
| 6 | 游戏 | 不用解释啦 |
| 7 | 杂项 | 例如宏命令包、惯例等 |
| 8 | 系统管理员工具 | 只能由root启动 |
| 9 | 其他（Linux特定的） | 用来存放内核例行程序的文档 |
| n | 新文档 | 可能要移到更适合的领域 |
| o | 老文档 | 可能会在一段期限内保留 |
MKDIR(1)表示该命令属于Section 1，为用户命令，类似的man
apt-get会看到APT-GET(8)，表示apt-get命令为系统管理工具。
“NAME”部分是该命令的名字和简单的解释，显然，在命令行中要执行该命令要使用到它的名称。
“SNOPSIS”是摘要部分，简要解释该命令如何使用，比如mkdir的摘要：
mkdir [OPTION] DIRECTORY…，读到这里便需要讲解一下了：
“OPTIONS”左右有”[“和”]”，表示这些参数并不必须，但是可以使用。对应的DIRECTORY两边没有”[]”，就是必须要加的参数了。
另外，它们后面都有”…” ，表示这些参数可以重复使用多次。至于OPTIONS具体怎么用，就要看DESCRIPTION部分了。下面举几个简单的例子，并配合例子解释：
| 用法 | 解释 |
|---|---|
| mkdir tmp | 创建 tmp 目录 |
| mkdir –mode=a+w tmp | 创建一个模式为“a+w”的tmp目录，–mode是长参数，用法是–mode=MODE，在DESCRIPTION里说明 |
| mkdir -m a+w tmp | 创建一个模式为“a+w”的tmp目录，-m 是短参数，不用加 = 号，效果等同 –mode=MODE |
| mkdir -mv a+w tmp | 创建一个模式为“a+w”的tmp目录，同时显示信息，verbose模式，-mv可以一起用 |
| mkdir -v -m a+w tmp | 创建一个模式为“a+w”的tmp目录，同时显示信息，verbose模式，-v后面接一个空格再用-m |
3 man手册页的操作
3.1 退出man
最简单，按下“q”键
3.2 查找
如果你知道要打开的手册页，在man命令打开的手册页中可以用
“/” 键进行正则表达式的搜索。
如果不知道所要打开的手册页名称，可以用 “man
-k”命令搜索相关的手册页，比如：
man -k postscript
会给出一堆关于“postscript”的相关命令页。
3.3 打印
最简单的办法，以mkdir为例：
man -t mkdir > mkdir_man.ps
可以直接打印ps，打算发给别人打印的话，转换成pdf也比较方便：
ps2pdf mkdir_man.ps mkdir_man.pdf
Posts
No comments:
Post a Comment