转载自 http://blog.sina.com.cn/s/blog_602f87700100gsvp.html
使用Linux下man已经很久了。但只是大概知道其内容的存放目录,以及man number xxx中mumber的含义。今天需要添加C++ man page。顺便将man的内容作一个较详细的了解。
之前Sam在查找C库函数时,会使用#man 3 func
在查找系统调用时,则使用#man 2 fork.
否则有时会出现查到同名的shell中命令的情况,如#man printf.
只是大概明白这个数字表示的是不同类型,但其具体是什么,以及如何发挥作用。则并不清楚。1 shell中用户可用的命令(User Commands)
2 使用函数库中程序可用的系统调用
3 程序中可用的库函数
4 /dev目录中可用的设备
5 多种杂项系统文件(ex:/etc/)
6 如果有的话,游戏程序
7 杂项信息
8 管理员可用的命令
1:$PATH变量指定的路径
2:/etc/man.config文件中MANPATH中指定的路径
其中/etc/man.config中有如下内容:
MANPATH /usr/man
MANPATH /usr/share/man
MANPATH /usr/local/man
MANPATH /usr/local/share/man
MANPATH /usr/X11R6/man
所以,如果需要添加新的man page.则只需要将man page目录添加到/etc/man.config MANPATH项目既可。
在/etc/man.config中,有一项:MANSECT,用来指定显示优先级。
MANSECT 1:1p:8:2:3:3p:4:5:6:7:9:0p:n:l:p:o:1x:2x:3x:4x:5x:6x:7x:8x
如果没有指定具体显示哪一个,则按MANSECT顺选来显示。
例如:
#man printf
则会优先显示1.shell中用户可用的命令
可以使用#man -a printf查看其顺序。
其中3p的p,表示 POSIX。
man程序读取的帮助文件格式分为两大类.
1. troff程序编写的源程序.
2. 通过压缩工具压缩过的源程序.
man程序可以直接读取的格式,是第一大类,和第二大类中用gzip压缩的帮助文件..gz /usr/bin/gunzip -c
.bz2 /usr/bin/bzip2 -c -d
.z
.Z /bin/zcat
.F
.Y
/usr/share/man存放了绝大多数的帮助文件,而且都是压缩格式的帮助文件./usr/local/share/man存放的都是以文本格式的帮助文件.
例如:使用gunzip -c /usr/share/man/man3/strcpy.3.gz的内容,就与#man 3 strcpy 结果对应。
/usr/share/man中包括man1,man2,man3,man3p....man8等目录。其中man后的数字,就是对应前面知识点1中的list.
1.download
ftp://gcc.gnu.org/pub/gcc/libstdc++/doxygen/
2.解压缩,将man3目录copy到/usr/share/c++/man目录中。
3.在/etc/man.config中添加
MANPATH /usr/share/c++/man
然后使用:
#man std::iostream
成功。
安装Man-Page:
$sudo yum install man
$sudo yum install man-pages