如何建立自己的man手册
1、打开Terminal,输入以下命令,创建一个路径,并将路径添加到系统环境变量中。
mkdir -p tmp/man1
chmod 777 tmp/man1 -R
export MANPATH=$HOME/tmp

2、在上述目录中,创建一个testMan.1的文件,命令和内容如下:
cd tmp/man1
vim testMan.1
以下是testMan.1文件内容:
.\ "author : author name
.TH testMan 1 "2017-12-28" "GNU" "User Commands" \" testMan(1) User Commands testMan(1)
\" GNU 2017-17-28 testMan(1)
.SH Name \" left
testMan \- testMan use to do somehing
.SH SYNOPSIS
.B testMan
.RB [\fB\-option1\fR]
.RB [\-option2]
.sp
.SH DESCRIPTION
this is a test man sample\&.
.TP
-a 1111111111111111111111111111111
.TP
-n 2222222222222222222222222222222
.sp
.sp
.TP 3
3333333333333333333333
444

3、给予testMan.1可执行权限,并备份它,接着再使用gzip命令生产gz文件,命令如下:
chmod a+x testMan.1
cp testMan.1 testMan.1.bak
gzip testMan.1

4、现在自己创建的man手册就制作好啦,输入以下命令即可获得testMan的帮助。
man testMan

5、现在我们可以对比一下man手册定义文件testMan.1文件和最后看到的man帮助之间的关系了,如下图,蓝色字为小编添加的注解,testMan.1文件与man帮助中相对应的部分用相同颜色的方格或线条标志出来了。朋友们可以根据这个图,制作自己的man手册。

6、注意,请先将输入法切换成英文半角符号状态,再创建testMan.1文件。如果直接复制这篇经验步骤2的内容到testMan.1中,由于经验是在Windows电脑上写的,复制过去可能会产生格式的问题,可以在vim中输入以下命令切换成unix格式。
:set ff=unix
