Man

建议下载下面四个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了

   

源文档 <http://blog.csdn.net/wang72560/article/details/6280315>

************************************************************