1 files changed, 99 insertions, 23 deletions

diff --git a/zh_CN.GB2312/books/porters-handbook/book.sgml b/zh_CN.GB2312/books/porters-handbook/book.sgml
index 1ecb0bf48f..56113a8ff2 100644
--- a/zh_CN.GB2312/books/porters-handbook/book.sgml
+++ b/zh_CN.GB2312/books/porters-handbook/book.sgml
@@ -2,7 +2,7 @@
      The FreeBSD Documentation Project
      The FreeBSD Simplified Chinese Project
 
-     Original Revision: 1.782
+     Original Revision: 1.795
      $FreeBSD$
 -->
 
@@ -29,6 +29,7 @@
       <year>2004</year>
       <year>2005</year>
       <year>2006</year>
+      <year>2007</year>
       <holder role="mailto:doc@FreeBSD.org">The FreeBSD Documentation
 	Project</holder>
     </copyright>
@@ -43,6 +44,7 @@
     <copyright>
       <year>2005</year>
       <year>2006</year>
+      <year>2007</year>
       <holder>&cnproj.freebsd.org;</holder>
     </copyright>
 
@@ -676,7 +678,16 @@ PLIST_DIRS=     lib/X11/oneko</programlisting>
 	  <literal>USE_DOS2UNIX=yes</literal>。 除此之外，
 	  还可以指定一个需要执行这种转换操作的文件列表：</para>
 
-	<programlisting>USE_DOS2UNIX=	util.c util.h</programlisting>
+	<programlisting>USE_DOS2UNIX=    util.c util.h</programlisting>
+
+	<para>如果希望转换一系列目录中的一组文件， 也可以使用
+	  <makevar>DOS2UNIX_REGEX</makevar>。 它的参数是与
+	  <command>find</command> 兼容的正则表达式。
+	  关于这种格式的说明， 请参阅 &man.re.format.7;。
+	  这个选项对转换所有指定扩展名的文件， 例如只转换源代码文件这样的应用非常有用：</para>
+
+	<programlisting>USE_DOS2UNIX=    yes
+DOS2UNIX_REGEX=  .*\.(c|cpp|h)</programlisting>
       </sect1>
 
       <sect1 id="slow-configure">
@@ -1472,6 +1483,12 @@ PORTEPOCH=      1</programlisting>
 	      </row>
 
 	      <row>
+		<entry><filename>gnustep*</filename></entry>
+		<entry>与 GNUstep 桌面环境有关的软件。</entry>
+		<entry></entry>
+	      </row>
+
+	      <row>
 		<entry><filename>hamradio*</filename></entry>
 		<entry>业余无线电爱好者使用的软件。</entry>
 		<entry></entry>
@@ -1655,6 +1672,11 @@ PORTEPOCH=      1</programlisting>
 	      </row>
 
 	      <row>
+		<entry><filename>ports-mgmt</filename></entry>
+		<entry>用于管理、 安装和开发 FreeBSD ports 和预编译包的 port。</entry>
+	      </row>
+
+	      <row>
 		<entry><filename>portuguese</filename></entry>
 		<entry>葡萄牙语语言支持。</entry>
 		<entry></entry>
@@ -3161,18 +3183,6 @@ ALWAYS_KEEP_DISTFILES=  yes
 	    <makevar>DEPENDS_TARGET</makevar> 相同， 就可略去不写。</para>
 	</sect2>
 
-	<sect2>
-	  <title><makevar>DEPENDS</makevar> (一般依赖)</title>
-
-	  <para>如果有无法归类于上述类别的依赖关系， 或者您的 port
-	    需要解压缩其它 port 的源代码才能够完成构建或安装，
-	    则应使用它来表达。 这个变量是一组格式为
-	    <replaceable>dir</replaceable><optional><replaceable>:target</replaceable></optional>
-	    的元组表， 与前四个不同， 它并不实施检查。 这里的
-	    <replaceable>target</replaceable> 部分，
-	    如果与 <makevar>DEPENDS_TARGET</makevar> 相同， 就可以略去不写。</para>
-	</sect2>
-
 	<sect2 id="use-vars">
 	<title><makevar>USE_<replaceable>*</replaceable></makevar></title>
 
@@ -3232,6 +3242,15 @@ ALWAYS_KEEP_DISTFILES=  yes
 	      </row>
 
 	      <row>
+		<entry><makevar>USE_CDRTOOLS</makevar></entry>
+
+		<entry>此 port 需要使用 <application>cdrecord</application>，
+		  根据用户的喜好， 可能是 <filename
+		  role="package">sysutils/cdrtools</filename> 或 <filename
+		  role="package">sysutils/cdrtools-cjk</filename>。</entry>
+	      </row>
+
+	      <row>
 		<entry><makevar>USE_GCC</makevar></entry>
 
 		<entry>此 port 需要使用某一特定版本的
@@ -3313,13 +3332,6 @@ ALWAYS_KEEP_DISTFILES=  yes
 	    <programlisting>BUILD_DEPENDS=   ${NONEXISTENT}:${PORTSDIR}/graphics/jpeg:extract</programlisting>
 
 	    表示依赖 <literal>jpeg</literal> port 并将其解压缩。</para>
-
-	  <para>除非其它方式都不适合， 否则不要使用 <makevar>DEPENDS</makevar>。
-	    这样指定将在任何情况下都构建 (默认情况下还会安装) 其它 port，
-	    而且这依赖关系还会进入 package。 如果真的需要这样， 写成
-	    <literal>BUILD_DEPENDS</literal> 和
-	    <literal>RUN_DEPENDS</literal> 可能更合适一些 &mdash;
-	    至少它的表达更为明确。</para>
 	</sect2>
 
       <sect2>
@@ -3463,6 +3475,21 @@ ${PREFIX}/man/ja/man4/baz.4.gz</programlisting>
 	都会创建一个符号连接， 把 foo(1) 和
 	alt-name(8) 联机手册连起来。</para>
 
+      <para>假如只有部分联机手册是翻译过的，
+	则可以使用一些根据 <makevar>MANLANG</makevar> 内容动态生成的变量：</para>
+
+      <programlisting>MANLANG=       "" de ja
+MAN1=          foo.1
+MAN1_EN=       bar.1
+MAN3_DE=       baz.3</programlisting>
+
+      <para>这相当于下列文件：</para>
+
+      <programlisting>${PREFIX}/man/man1/foo.1.gz
+${PREFIX}/man/de/man1/foo.1.gz
+${PREFIX}/man/ja/man1/foo.1.gz
+${PREFIX}/man/man1/bar.1.gz
+${PREFIX}/man/de/man3/baz.3.gz</programlisting>
     </sect1>
 
     <sect1 id="makefile-info">
@@ -4683,8 +4710,7 @@ PLIST_SUB+=             NLS="@comment "
 	    <row>
 	      <entry><makevar>USE_MOTIF</makevar></entry>
 
-	      <entry>此 port 使用 Motif 工具包。 这一变量暗含
-		<makevar>USE_XPM</makevar> 设置。</entry>
+	      <entry>此 port 使用 Motif 工具包。</entry>
 	    </row>
 
 	    <row>
@@ -5609,6 +5635,19 @@ _DOCSDIR=       .
     <sect1 id="using-python">
       <title>使用 Python</title>
 
+      <para>Ports 套件支持同时并行安装多个不同的
+	Python 版本。 Ports 应确保能够根据用户配置的
+	<makevar>PYTHON_VERSION</makevar> 变量使用正确的
+	<command>python</command> 解释器。 一般说来，
+	这是通过将脚本中的 <command>python</command> 路径名替换为
+	<makevar>PYTHON_CMD</makevar> 变量的值来实现的。</para>
+
+      <para>在 <makevar>PYTHON_SITELIBDIR</makevar>
+	下安装文件的 ports 应在包名上使用 <literal>pyXY-</literal> 前缀，
+	以便明示它们将会配合哪个 Python 版本使用。</para>
+
+      <programlisting>PKGNAMEPREFIX= ${PYTHON_PKGNAMEPREFIX}</programlisting>
+
       <table frame="none">
 	<title>对用到 Python 的 port 最有用的一些变量</title>
 
@@ -7155,6 +7194,27 @@ run_rc_command "$1"</programlisting>
 	而采用 &quot;:=&quot; 来进行赋值，
 	则会在不经意间覆盖用户所希望的设置。</para>
 
+      <para>rc 脚本的后缀名， 会通过
+	<makevar>RC_SUBR_SUFFIX</makevar> 提供， 以便在 port 的
+	<filename>Makefile</filename> 中使用。 最新版本的 &os; 并不为脚本名增加任何后缀，
+	但较早的版本则曾使用过
+	<filename>.sh</filename> 后缀。</para>
+
+      <sect2>
+	<title>卸载时停止服务</title>
+
+	<para>可以在卸载的过程中自动地停止服务。 我们建议只有在绝对必要，
+	  例如必须在删除文件之前停止服务这类的情况下才使用这一功能。
+	  通常来说， 决定是否在卸载时停止服务是系统管理员需要考虑的事情。
+	  另外要注意， 这个功能也会影响升级过程。</para>
+
+	<para>需要时可以在 <filename>pkg-plist</filename> 中加入：</para>
+
+	<programlisting>@stopdaemon doormand</programlisting>
+
+	<para>这里的参数必须与
+	  <makevar>USE_RC_SUBR</makevar> 变量的内容匹配。</para>
+      </sect2>
     </sect1>
   </chapter>
 
@@ -9949,6 +10009,17 @@ Reference: &lt;http://www.freebsd.org/ports/portaudit/74a9541d-5d6c-11d8-80e3-00
 		    <entry>602102</entry>
 		  </row>
 		  <row>
+		    <entry>MFC 了对 dlsym 进行修改， 使其在指定 dso 及其暗指的依赖中查找符号之后的
+		      6.2-STABLE。</entry>
+		    <entry>602103</entry>
+		  </row>
+		  <row>
+		    <entry>MFC 了 netgraph 节点 ng_deflate(4) 和
+		      ng_pred1(4) 以及用于 ng_ppp(4)
+		      节点的新压缩及加密模式之后的 6.2-STABLE。</entry>
+		    <entry>602104</entry>
+		  </row>
+		  <row>
 		    <entry>7.0-CURRENT。</entry>
 		    <entry>700000</entry>
 		  </row>
@@ -10083,6 +10154,11 @@ Reference: &lt;http://www.freebsd.org/ports/portaudit/74a9541d-5d6c-11d8-80e3-00
 		    </entry>
 		    <entry>700028</entry>
 		  </row>
+		  <row>
+		    <entry>将 GNU &man.gzip.1; 实现替换为从 NetBSD 移植的采用 BSD 授权版本之后的
+		      7.0-CURRENT。</entry>
+		    <entry>700029</entry>
+		  </row>
 
 		</tbody>
 	      </tgroup>