建议下载下面四个man手册 | //命令：sudo apt-get install manpages |
roger@ubuntu:~$ dpkg -l | grep manpages
ii manpages 3.24-1ubuntu1 Manual pages about using a GNU/Linux system
ii manpages-dev 3.24-1ubuntu1 Manual pages about using GNU/Linux for development
ii manpages-posix 2.16-1 Manual pages about using POSIX system
ii manpages-posix-dev 2.16-1 Manual pages about using a POSIX system for development
************************************************************
man 中文
通过linux wget下载开发包
[chengmo@centos5 ~]$ wget http://manpages-zh.googlecode.com/files/manpages-zh-1.5.tar.gz
输入即可
2、解压man中文手册包
只要在自己工作目录下面建立man/zh_CN 目录，将压缩包解压，按照规格目录中。man命令就可以搜索到。
特别说明下,下面的安装保证你的语言环境设置为中文：
[chengmo@centos5 ~]$ echo $LANG
zh_CN.GB2312
如果不是：通过 export LANG=zh_CN.GB2312
如果你发现上面执行不通过，你可以运行：locale -a 查一下你系统支持的字符集
[chengmo@centos5 ~]$ cd ~
#进入当前目录
[chengmo@centos5 ~]$ mkdir -p man/zh_CN
#建立目录man 以及子目录zh_CN
[chengmo@centos5 ~]$ tree man
man
`-- zh_CN
#目录以及子目录已经可以了，现在只需要将压缩包解压到zh_CN 中文目录即可
[chengmo@centos5 ~]$ tar -xzvf manpages-zh-1.5.tar.gz
manpages-zh-1.5/src/mann/expr.n
manpages-zh-1.5/src/mann/fblocked.n
manpages-zh-1.5/src/mann/fconfigure.n
manpages-zh-1.5/src/mann/fcopy.n
manpages-zh-1.5/src/mann/file.n
manpages-zh-1.5/src/mann/fileevent.n
manpages-zh-1.5/src/mann/filename.n
manpages-zh-1.5/src/mann/flush.n
manpages-zh-1.5/src/mann/focusNext.n
manpages-zh-1.5/src/mann/for.n
manpages-zh-1.5/src/mann/foreach.n
#......解压数据包
[chengmo@centos5 ~]$ cd manpages-zh-1.5
[chengmo@centos5 manpages-zh-1.5]$ ls
COPYING debian DOCS Makefile man-pages-zh_CN.spec raw README README.GB src utils
#该目录结构 支持make安装的,可以通过make命令生成编译文件，也可以直接复制里面src目录安装
[chengmo@centos5 manpages-zh-1.5]$ make
mkdir UTF-8
cp -r src/man* UTF-8/
#已经生成了：UTF-8目录下面文件，只需要将该目录复制到~/man/zh_CN下面即可
[chengmo@centos5 manpages-zh-1.5]$ cp -r UTF-8/* ~/man/zh_CN/
通过上面几步已经将帮助手册安装到自己的工作目录下面的man/zh_CN下面了。
3、测试man中文帮助手册是否安装成功
1 下面检查下，看man中文手册是否加入到man路径里面了。
[chengmo@centos5 manpages-zh-1.5]$ man -w
/usr/kerberos/man:/usr/local/share/man:/usr/share/man/zh_CN:/usr/share/man:/home/chengmo/man/zh_CN:/home/chengmo/man:/usr/local/ma
n
#发现已经在MANPATH路径加入了：/home/chengmo/man 以及：/home/chengmo/man/zh_CN
[chengmo@centos5 ~]$ man -aw passwd
/usr/share/man/man1/passwd.1.gz
/usr/share/man/man5/passwd.5.gz
/home/chengmo/man/zh_CN/man5/passwd.5
#发现已经找到中文手册了
[chengmo@centos5 ~]$ man 5 -aw passwd
/usr/share/man/man5/passwd.5.gz
/home/chengmo/man/zh_CN/man5/passwd.5
#读取领域5限定类型，这样系统原先的英文也保留了，看中英文也很方便
[chengmo@centos5 ~]$ man 5 -a passwd
#显示英文的，按q就会出来中文文档了
源文档 <http://bbs.hx95.com/read-htm-tid-193816-fpage-2.html>
关于man页的写作和，写好后，怎么看效果，怎么把它加入到manpath.
1.man页的书写
本书是利用docbook进行书写man页的。下面是一个利子，你可以参考一下
<?xml version='1.0' encoding='utf-8'?>
<refentry xml:id="myprintf" xmlns="http://docbook.org/ns/docbook"
version="5.0">
<info>
<productname>
</productname>
<author>
<firstname>
xinglong
</firstname>
<surname>
wang
</surname>
<contrib>
banshi
xxp
mew
</contrib>
<contrib>
xxp
</contrib>
<contrib>
xiaolong
</contrib>
</author>
</info>
<refmeta>
<manvolnum>
3
</manvolnum>
<refmiscinfo class="sectdesc">
Linux Programmer's Manual
</refmiscinfo>
<refmiscinfo class="software">
myprintf xxp
</refmiscinfo>
<refmiscinfo class="version">
1.2
</refmiscinfo>
</refmeta>
<refnamediv>
<refname>myprintf</refname>
<refname>xxmyprintf</refname>
<refname>ssprintf</refname>
<refpurpose>print formatted output</refpurpose>
</refnamediv>
<refsynopsisdiv>
<funcsynopsis>
<funcsynopsisinfo>
#include <stdio.h>
</funcsynopsisinfo>
<funcprototype>
<funcdef>
int
<function>
myprintf
</function>
</funcdef>
<paramdef>
const char *
<parameter>
format
</parameter>
</paramdef>
<varargs/>
</funcprototype>
<funcprototype>
<funcdef>
int
<function>
xxprintf
</function>
</funcdef>
<paramdef>
const char *
<parameter>
format
</parameter>
</paramdef>
<varargs />
</funcprototype>
<funcprototype>
<funcdef>
int
<function>
ssprintf
</function>
</funcdef>
<paramdef>
char *
<parameter>
s
</parameter>
</paramdef>
<paramdef>
const char *
<parameter>
format
</parameter>
</paramdef>
<varargs/>
</funcprototype>
</funcsynopsis>
</refsynopsisdiv>
<refsect1>
<title>
Description
</title>
<para>
<indexterm>
<primary>
functions
</primary>
<secondary>
myprintf
</secondary>
</indexterm>
<indexterm>
<primary>
printing function
</primary>
</indexterm>
<function>
myprintf
</function>
places output on the standard
output stream stdout.
</para>
</refsect1>
</refentry>
将上面的内容保存在mymanpages.xml
2.man页的生成
xsltproc manpages/docbook.xsl mymanpages.xml
这时，就生成了
myprintf.3 ssprintf.3 xxmyprintf.3
三个文件
3.看man页的效果
man ./myprintf.3
如果效果不好。。你想加入一些更多的内容，
这时，你可以修改mymanpages.xml的内容
4.对man页打包
gzip myprintf.3
你也可以把所生成的man页文件都打包了，这里为了测试，就只打这么 一个
然后建立的你man页首目录
我以，我的当前目录为man首目录
比如，现在，我在我的目录下建立文件夹
mew@mew:~/practice/xml$ pwd
/home/mew/practice/xml
mew@mew:~/practice/xml$ mkdir man3
mew@mew:~/practice/xml$ gzip myprintf.3
mew@mew:~/practice/xml$ cp myprintf.3.gz ./man3/
4.修改manpath
cd /etc/
sudo vim manpath.config
找到
#---------------------------------------------------------
# every automatically generated MANPATH includes these fields
#
#MANDATORY_MANPATH /usr/src/pvm3/man
#
MANDATORY_MANPATH /usr/man
MANDATORY_MANPATH /usr/share/man
MANDATORY_MANPATH /usr/local/share/man
然后在这一段中加入你存放你自己写的man页目录
如我加入了下面一行
MANDATORY_MANPATH /home/mew/practice/xml
5.现在，你就可以用man myprintf了
