如何建立自己的man手册

打开Terminal，输入以下命令，创建一个路径，并将路径添加到系统环境变量中。

mkdir -p tmp/man1

chmod 777 tmp/man1 -R

export MANPATH=$HOME/tmp

在上述目录中，创建一个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

给予testMan.1可执行权限，并备份它，接着再使用gzip命令生产gz文件，命令如下：

chmod a+x testMan.1

cp testMan.1 testMan.1.bak

gzip testMan.1

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

man testMan

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

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

:set ff=unix