建议下载下面四个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 &lt;stdio.h&gt;

            </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