1 files changed, 173 insertions, 16 deletions

diff --git a/zh_CN.GB2312/books/porters-handbook/book.sgml b/zh_CN.GB2312/books/porters-handbook/book.sgml
index 216e5f5562..d8619dce3c 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.702
+     Original Revision: 1.714
      $FreeBSD$
 -->
 
@@ -4683,6 +4683,34 @@ BUILD_DEPENDS+= Xvfb:${X_VFBSERVER_PORT} \
 
       </sect2>
 
+      <sect2 id="desktop-entries">
+	<title>桌面项</title>
+
+	<para>通过利用
+	  <makevar>DESKTOP_ENTRIES</makevar> 变量，
+	  可以很容易地在您的 port 中创建桌面项 (<ulink
+	  url="http://standards.freedesktop.org/desktop-entry-spec/latest/">Freedesktop
+	  标准</ulink>)。 这些项会在类似 GNOME 或 KDE
+	  这样的符合这一标准的桌面环境中显示在应用程序菜单中。
+	  这样做会自动创建、 安装 <filename>.desktop</filename> 文件， 并将其加入
+	  <filename>pkg-plist</filename>。 其语法为：</para>
+
+	<programlisting>DESKTOP_ENTRIES=  "NAME" "COMMENT" "ICON" "COMMAND" "CATEGORY" StartupNotify</programlisting>
+
+	<para>您可以在 <ulink
+	  url="http://standards.freedesktop.org/menu-spec/latest/apa.html">
+	  Freedesktop 网站上</ulink> 找到可用的分类名称。 <makevar>StartupNotify</makevar>
+	  表示应用程序在支持启动通知的环境中清除状态信息。</para>
+
+	<para>例子：</para>
+
+	<programlisting>DESKTOP_ENTRIES=  "ToME" "Roguelike game based on JRR Tolkien's work" \
+                  "${DATADIR}/xtra/graf/tome-128.png" \
+                  "tome -v -g" "Application;Game;RolePlaying" \
+                  false</programlisting>
+
+      </sect2>
+
     </sect1>
 
     <sect1 id="using-gnome">
@@ -5107,29 +5135,136 @@ BUILD_DEPENDS+= Xvfb:${X_VFBSERVER_PORT} \
 	    <tbody>
 
 	      <row>
-		<entry>USE_APACHE</entry>
+		<entry><makevar>USE_APACHE</makevar></entry>
 
-		<entry>此 port 需要 Apache。</entry>
+		<entry>此 port 需要 Apache。 可用的值：
+		  <literal>yes</literal> (任意可用版本)、
+		  <literal>1.3</literal>、 <literal>2.0</literal>、
+		  <literal>2.2</literal>、 <literal>2.0+</literal>、
+		  等等。 默认依赖的版本是
+		  <literal>1.3</literal>。</entry>
 	      </row>
 
 	      <row>
-		<entry>WITH_APACHE2</entry>
+		<entry><makevar>WITH_APACHE2</makevar></entry>
 
 		<entry>此 port 需要 Apache 2.0。 如果没有这个变量，
-		  则 port 将依赖 Apache 1.3。</entry>
+		  则 port 将依赖 Apache 1.3。 这一变量目前已经过时，
+		  因而不应继续使用。</entry>
+	      </row>
+
+	      <row>
+		<entry><makevar>APXS</makevar></entry>
+
+		<entry>到 <command>apxs</command> 可执行文件的完整路径。
+		  您可以在 port 中替代该值。</entry>
+	      </row>
+
+	      <row>
+		<entry><makevar>HTTPD</makevar></entry>
+
+		<entry>到 <command>httpd</command> 可执行文件的完整路径。
+		  您可以在 port 中替代该值。</entry>
+	      </row>
+
+	      <row>
+		<entry><makevar>APACHE_VERSION</makevar></entry>
+
+		<entry>目前系统中安装的 Apache 版本 (只读变量)。
+		  这一变量只有在引用了 <filename>bsd.port.pre.mk</filename>
+		  之后才能使用， 其可能的值为：
+		  <literal>13</literal>、 <literal>20</literal>、
+		  <literal>22</literal>。</entry>
+	      </row>
+
+	      <row>
+		<entry><makevar>APACHEMODDIR</makevar></entry>
+
+		<entry>Apache 模块所在的文件夹。 在 pkg-plist 中，
+		  这一变量会自动展开。</entry>
+	      </row>
+
+	      <row>
+		<entry><makevar>APACHEINCLUDEDIR</makevar></entry>
+
+		<entry>Apache 头文件所在的文件夹。 在 pkg-plist 中，
+		  这一变量会自动展开。</entry>
+	      </row>
+
+	      <row>
+		<entry><makevar>APACHEETCDIR</makevar></entry>
+
+		<entry>Apache 配置文件所在的文件夹。 在 pkg-plist 中，
+		  这一变量会自动展开。</entry>
+	      </row>
+
+	    </tbody>
+	  </tgroup>
+	</table>
+
+	<table frame="none">
+	  <title>在移植 Apache 模块时比较有用的变量</title>
+
+	  <tgroup cols="2">
+	    <tbody>
+
+	      <row>
+		<entry><makevar>MODULENAME</makevar></entry>
+
+		<entry>模块的名称。 默认值为
+		  <makevar>PORTNAME</makevar>。 例如：
+		  <literal>mod_hello</literal></entry>
+	      </row>
+
+	      <row>
+		<entry><makevar>SHORTMODNAME</makevar></entry>
+
+		<entry>模块的简略名字。 默认情况下会自动根据
+		  <makevar>MODULENAME</makevar> 计算， 但您也可以自行设置值来替代它。
+		  例如： <literal>hello</literal></entry>
+	      </row>
+
+	      <row>
+		<entry><makevar>AP_FAST_BUILD</makevar></entry>
+
+		<entry>使用 <command>apxs</command> 来编译和安装模块。</entry>
+	      </row>
+
+	      <row>
+		<entry><makevar>AP_GENPLIST</makevar></entry>
+
+		<entry>同时自动创建
+		  <filename>pkg-plist</filename>。</entry>
 	      </row>
 
 	      <row>
-		<entry>APXS</entry>
+		<entry><makevar>AP_INC</makevar></entry>
 
-		<entry>到 <command>apxs</command> 程序的完整路径
-		  (这是一个只读的变量)。</entry>
+		<entry>在编译过程中， 将指定的目录加入到搜索头文件的目录中。</entry>
+	      </row>
+
+	      <row>
+		<entry><makevar>AP_LIB</makevar></entry>
+
+		<entry>在编译过程中， 将指定的目录加入到搜索函数库的目录中。</entry>
+	      </row>
+
+	      <row>
+		<entry><makevar>AP_EXTRAS</makevar></entry>
+
+		<entry>传递给
+		  <command>apxs</command> 的额外参数。</entry>
 	      </row>
 
 	    </tbody>
 	  </tgroup>
 	</table>
 
+	<para>Web 应用程序应安装到
+	  <makevar>PREFIX</makevar><filename>/www/<replaceable>应用程序的名字</replaceable></filename>
+	  并且不应假定 Apache 的存在， 除非它们必须使用 Apache。
+	  用户可能会希望运行 Apache 以外的其它 Web 服务器。</para>
+
       </sect2>
 
       <sect2 id="php-variables">
@@ -5473,7 +5608,7 @@ _DOCSDIR=       .
 	    </row>
 
 	    <row>
-	      <entry><makevar>RUBY_SITEARCHILIBDIR</makevar></entry>
+	      <entry><makevar>RUBY_SITEARCHLIBDIR</makevar></entry>
 
 	      <entry>平台相关的库的安装路径。</entry>
 
@@ -5659,15 +5794,16 @@ USE_SDL+=   mixer
 name="doormand"
 rcvar=${name}_enable
 
-command=%%PREFIX%%/sbin/doormand
-command_args="-p $pidfile -f $doormand_config"
-pidfile=/var/run/doormand.pid
+command=%%PREFIX%%/sbin/${name}
+pidfile=/var/run/${name}.pid
 
 load_rc_config $name
 
 : ${doormand_enable="NO"}
 : ${doormand_config="%%PREFIX%%/etc/doormand/doormand.cf"}
 
+command_args="-p $pidfile -f $doormand_config"
+
 run_rc_command "$1"</programlisting>
 
       <para>这里， 对变量的默认赋值方法应采用 &quot;=&quot;，
@@ -5878,9 +6014,10 @@ etc/orbit.conf.sample
 
       <para>接下来， 建立一个临时的目录， 以便安装您的 port，
 	首先在其中安装所有依赖的 port。 对于非 X 的 port，
-	<replaceable>port-type</replaceable> 应该是 <literal>local</literal>；
-	而如果是一个遵循 XFree86 4 或更早的 XFree 86 版本目录结构的 port，
-	则应相应地选择 <literal>x11-4</literal> 或 <literal>x11</literal>。</para>
+	<replaceable>port-type</replaceable> 应该是 <literal>local</literal>;
+	而使用 XFree86 4.X 或 X.org 目录结构的对应则是 <literal>x11-4</literal>，
+	最后， 如果 port 使用的是 XFree86 3.X， 则应使用
+	<literal>x11</literal>。</para>
 
       <screen>&prompt.root; <userinput>mkdir /var/tmp/<replaceable>port-name</replaceable></userinput>
 &prompt.root; <userinput>mtree -U -f /etc/mtree/BSD.<replaceable>port-type</replaceable>.dist -d -e -p /var/tmp/<replaceable>port-name</replaceable></userinput>
@@ -6313,7 +6450,7 @@ as .putsy.conf and edit it.</programlisting>
 	Makefile 中的 MAINTAINER</ulink> 小节)。</para>
 
       <para>将 diff 发送给我们的最佳方式是通过 &man.send-pr.1; (category 一栏写
-	<literal>ports</literal>)。 如果您是维护那个 port 的志愿者，
+	<literal>ports</literal>)。 如果您正维护那个 port，
 	请务必在 synopsis 的开头写上 <literal>[maintainer update]</literal>，
 	并将您的 PR 的 <quote>Class</quote> 设置为 <literal>maintainer-update</literal>。
 	反之， 您的 PR 的 <quote>Class</quote> 就应该是
@@ -8162,6 +8299,14 @@ Reference: &lt;http://www.freebsd.org/ports/portaudit/74a9541d-5d6c-11d8-80e3-00
 		    <entry>504105</entry>
 		  </row>
 		  <row>
+		    <entry>5.5-RELEASE.</entry>
+		    <entry>505000</entry>
+		  </row>
+		  <row>
+		    <entry>在创建 RELENG_5_5 分支之后的 5.5-STABLE</entry>
+		    <entry>505100</entry>
+		  </row>
+		  <row>
 		    <entry>6.0-CURRENT</entry>
 		    <entry>600000</entry>
 		  </row>
@@ -8422,6 +8567,10 @@ Reference: &lt;http://www.freebsd.org/ports/portaudit/74a9541d-5d6c-11d8-80e3-00
 		      7.0-CURRENT。</entry>
 		    <entry>700016</entry>
 		  </row>
+		  <row>
+		    <entry>删去 ip6fw 之后的 7.0-CURRENT。</entry>
+		    <entry>700017</entry>
+		  </row>
 		</tbody>
 	      </tgroup>
 	    </table>
@@ -9141,6 +9290,14 @@ bacula:*:910:</programlisting>
 	    <programlisting>ONLY_FOR_ARCHS= i386 amd64</programlisting>
 
 	    <programlisting>NOT_FOR_ARCHS= alpha ia64 sparc64</programlisting>
+
+	    <para>可以使用 <makevar>ONLY_FOR_ARCHS_REASON</makevar> 和
+	      <makevar>NOT_FOR_ARCHS_REASON</makevar> 来配置定制的
+	      <makevar>IGNORE</makevar> 消息。 此外， 还可以使用
+	      <makevar>ONLY_FOR_ARCHS_REASON_<replaceable>ARCH</replaceable></makevar>
+	      和
+	      <makevar>NOT_FOR_ARCHS_REASON_<replaceable>ARCH</replaceable></makevar>
+	      来分别指定与具体平台有关的信息。</para>
 	  </listitem>
 
 	</itemizedlist>