CMPP 常见问题（FAQ）
当前维护人员：徐明<xuming@users.sourceforge.net>
最后更新：2003 年 10 月 26 日 01:53:11 CST
本文档的最新版本可以在 http://cmpp.linuxforum.net 找到。

目录

1，什么是 CMPP？
2，为什么要发起 CMPP 手册页计划？
3，这个计划的站点在哪里？
4，如何参与该计划？
5，这个计划的 CVS 服务器是什么？
6，这个计划的 CVS Web 的 URL 是什么？
7，这个计划的邮递列表是什么？
8，如何使用匿名 CVS？
9，如何支持该计划？
10，如何认领手册页翻译？
11，本计划的协调人是谁？
12，如何使用中文手册页？
13，如何提交您的翻译或者补丁？
14，CMPP 翻译的手册页的要求是什么？
15，troff 格式是什么样的？
16, 为什么我的手册页一行中有时空白很大；有时没有空白，反而出现断行错
    误和乱码？
17，如何加入 CMPP 的邮递列表？




1，什么是 CMPP？

CMPP 是“中文手册页计划”（ Chinese Man Pages Project ）的缩写。
这个计划的目的是把英文的 man pages （手册页）翻译成中文的手册页，
让更多的人能够受益于手册页详实丰富的内容。降低学习 Linux 系统的难度。


2，为什么要发起 CMPP 手册页计划？

手册页是 Unix 体系里最为权威和丰富的技术资料， Linux 作为自由软件
的 Unix 版本和其他所有相关工具和软件一起，其手册页的质量和数量都
非常高，为了帮助广大网友学习和使用这些自由软件，linuxforum.net 发起
了这个本身也是自由软件项目之一的翻译工程。


3，这个计划的站点在哪里？

http://cmpp.linuxforum.net
我们在这个站点上发布与 CMPP 相关的所有信息。


4，如何参与该计划？

您可以通过共同参与翻译、校对手册页，也可以通过您合适的途径传播
CMPP 计划，让更多的人认识、参与并最终从 CMPP 计划中受益。


5，这个计划的 CVS 服务器是什么？

目前 CMPP 计划已经开始使用 CVS 进行管理，其 CVS 仓库的地址是：

sf.linuxforum.net

6，这个计划的 CVS Web 的 URL 是什么？

http://cmpp.linuxforum.net

7，这个计划的邮递列表是什么？

cmpp@linuxforum.net
您有任何问题或者有任何译文提交都可以向这个列表发邮件。


8，如何使用匿名 CVS？

首先，如果您使用的是 Linux，那么您可以先把 CVS 软件安装上，
在 Slackware 7.x 里，在 /contrib 目录下有 cvs 的安装包，您只需要使
用命令：

#installpkg cvs-xxx.tgz 
就可以了，（在这里补充其他 linux 版本、其他平台的安装方法）。
大部分 linux 版本里都有 cvs 包，阅读您的系统的文档，安装上这个软件。
如果您的系统里没有这个软件，您可以到下面的站点下载安装，具体的安装
方法和步骤请参阅它自己的文档。

然后，您可以执行下面的命令：

如果您用的是 bash 或者其变种，您可以：

$ export CVSROOT=:pserver:anonymous@sf.linuxforum.net:/cvsroot/cmpp

如果您用的是 csh 或者其变种，您可以：

% set CVSROOT=:pserver:anonymous@sf.linuxforum.net:/cvsroot/cmpp

然后再执行命令：

$ cvs login

这时候 CVS 系统会向您提示输入口令，您只需要按回车就可以了。这时候
cvs 会把口令保存在 .cvspass，这样您以后就不再用输入了。

接下来您就可以把所有 CMPP 源文件都下载下来了，命令是：

$cvs -z3 co -P cman

第一次下载需要比较长的时间，但以后如果您再需要更新，就不需要下载那么
多的东西了，只需要进入 cman 的目录里，执行：

$cvs -z3 update -d -P

如果您的平台是 windows，那么您可以有两种使用 CVS 的方法，第一种是到
www.cygwin.com 下载 cygwin 包，安装到系统中，运行 cygwin 之后的所有
方法都是和在 linux 或者 unix 里一样的，这里就不多说了。如果您使用的
是 cvs 的 windows 客户端软件 WinCVS 的话，那么您可以按照下面步骤：
（命令中的 “->”表示菜单级联）：

第一，Admin->preferenes->General->Enter the CVSROOT，输入
:pserver:anonymous@202.204.24.8:/home/cvsroot
第二，登陆 CVS 服务器
Admin->login...
第三，抓取所有 cman 文件：
Create->Chechout module->checkout settings->enter the..

输入cman（或者某个手册页的内容）

Local folder checkout to处输入：你的工作目录（本地目录）

使用压缩选项 Golbals->Use tcp/ip compression
 
第四，以后更新手册页的时候可以：

Modify->Update selection...


9，如何支持该计划？

第一，您可以亲身参与该计划，见“如何参与该计划”；
第二，您可以赞助该计划，您可以提供各种翻译相关资料、资源、甚至是书籍、
金钱等赞助，赞助事宜可以和本计划协调人或 linuxforum.net 的管理人联系
（见“本计划协调人”）；
第三，使用我们的中文手册页！只有更多的人使用，才能真正推动 CMPP 的
发展和进步。

10，如何认领手册页翻译？

您可以参阅我们的 TODO 文件里面的详细招领列表，也可以到：

http://www.linuxforum.net/forum/showthreaded.php?Cat=&Board=Tworkshop&Number=114227&page=0&view=expanded&sb=5&o=31&part=

里面有一个招领贴，里面有和 TODO 里的详细招领列表一样的待译文件列表。
如果您对某些东西感兴趣，但是它们又不在招领列表里，那么您可以浏览 
CVSWeb，在里面的那些非中文的手册页都是可以翻译的项目。具体方法是：
第一，登录 CVSWeb：http://cmpp.linuxforum.net
第二，点击 cman 浏览 CVSWeb 里的 cman 内容，寻找您感兴趣的非中文手册页，
如果找到（比如 man9/cmannullfile.9），那么：
第三，点击该文件的链接，进入下一个页面，里面有一个 download 链接，在 
windows 里用鼠标右键点击，在弹出菜单中选择“目标另存为”，在新弹出的
菜单中选择保存路径和文件名（最好不要更改文件名），然后点“确认”即可，
然后您就可以在它上面进行翻译了。


11，本计划的协调人是谁？

何伟平：laser@zhengmai.com.cn
冼景彬：rawk@chinese.com
徐明：xuming@users.sourceforge.net

如果您有与 CMPP 相关的事项协商或者希望参与到经常性提交者的行列中，
请与他们联系。


12，如何使用中文手册页？

我们打包下载的中文手册页包中有相应手册页的 html 格式文件，如果您的平
台不支持 troff 格式（Unix 手册页的格式），那么您可以阅读 html 格式文
件获取帮助，如果您的系统支持 groff 格式（比如 Linux ），那么需要注意
做下面的一些修改：

首先，把/usr/lib/man.conf 里的
NROFF /usr/bin/groff -S -Tascii -mandoc
改为:

NROFF /usr/bin/groff -S -Tlatin1 -mandoc

然后在 /etc/profile，或者您的 .profile （.bash_profile）里加下面一行：
export LESSCHARSET=latin1

运行以下命令令环境变量生效：

$. .bash_profile

或

$source .bash_profile

最后，把对应的中文man考贝到/usr/man/的对应目录下，然后在X里的终端或
者cxterm里，
$man xxxx 

这样就可以用了，如果您的 Linux 发布版是支持中文的，那么很有可能您不
用做这些事情就可以使用了。如果您没有访问和修改系统文件的权限，那么您
可以把手册页拷贝到您的自己的某个目录里，然后用下面的命令访问某个手册
页：

$cd /cman/man[1-9n]
$man ./xxx.[1-9n]

这里的 man[1-9n] 是手册页的目录，而 xxx.[1-9n] 是某个手册页。


13，如何提交您的翻译或者补丁？

您可以向 CMPP 计划的邮递列表递交您的译文或者补丁。
其邮递列表参见“这个计划的邮递列表是什么？”


14，CMPP 翻译的手册页的要求是什么？

因为手册页的格式是 troff 格式，所以我们建议在做翻译的时候最好也使用 
troff 格式，简单说就是保留源文件的格式，覆盖翻译，如果您还是觉得这样
的用法不方便，那么您可以使用我们的 windows 下编辑用的专用软件：

http://www.cmpp.net/Ttool.php3

这个软件是一个所见即所得的编辑工具，其详细用法请参阅其说明。而 troff 
格式的详细说明，请参阅“troff 格式是什么样的？”条目。


15，troff 格式是什么样的？

troff 格式是手册页的基本格式，它是由一些标记对文本进行标记，然后通过
专门的软件进行分析实现的。其符号和标记的详细信息可以参阅我们的两个文
件：

http://www.cmpp.net/man-faq2.php3

和

在 man7 目录中的手册页 man.7。


16, 为什么我的手册页一行中有时空白很大；有时没有空白，反而出现断行错
误和乱码？

troff 格式是通过 groff/troff 程序过滤产生输出的。而目前的 groff/troff 
是按英文习惯断行。它使用英文空白符 (ASCII 值 0x20) 和英文断词法决定
断行的位置，然后把每行英文重新排版，使之两边对齐。

可是中文词与词之间是没有空格的，断行要求与英文也大不相同。因为通常在
中英文交替时加个空格， groff/troff 只能依靠这些有限的空格断行了。一
句中间无空格的中文句会被看作一个英文词（而且是无法用断词法断词的）。
如果中文句很短， groff/troff 会认为一行只有很少几个词，拉伸使之两边
对齐，就出现了较大的空白；如果中文句很长， groff/troff 会报告 
"warning: can't break line" ，无法断行，而一直排下去，到行尾时若处于
一个汉字中间（一个汉字被视为两个英文字符），强行断开，下一行就会出现
乱码。

文件 http://www.cmpp.net/Test.1 描述了这个问题。分别用编辑器和 man 
命令观看会发现差异。

最新版本groff 中没有这些问题。

17，如何订阅 CMPP 的邮递列表和退订？

详细情况请参阅

http://www2.linuxforum.net/mailman/listinfo/

和

http://www2.linuxforum.net/mailman/listinfo/cmpp
