aboutsummaryrefslogtreecommitdiff
path: root/zh_CN.GB2312/books/porters-handbook
diff options
context:
space:
mode:
authorXin LI <delphij@FreeBSD.org>2006-10-08 16:30:27 +0000
committerXin LI <delphij@FreeBSD.org>2006-10-08 16:30:27 +0000
commit914b35f784ed80f4a86fe77fdeef9ff574ba2d5b (patch)
tree47e3aa0d270c41dc3aede6903c413026311793cc /zh_CN.GB2312/books/porters-handbook
parentdbc4960a53d107d5e4a70fe468f1e4bce766331a (diff)
Notes
Diffstat (limited to 'zh_CN.GB2312/books/porters-handbook')
-rw-r--r--zh_CN.GB2312/books/porters-handbook/book.sgml79
1 files changed, 68 insertions, 11 deletions
diff --git a/zh_CN.GB2312/books/porters-handbook/book.sgml b/zh_CN.GB2312/books/porters-handbook/book.sgml
index 2a29925098..65c3d24b12 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.751
+ Original Revision: 1.759
$FreeBSD$
-->
@@ -1958,7 +1958,7 @@ PORTEPOCH= 1</programlisting>
</sect2>
<sect2 id="proposing-categories">
- <title>提议建立新的分类</title>
+ <title>如何提议建立新的分类</title>
<para>由于 Ports Collection 在持续增长, 已经引入了许多新的分类。
新的分类既可以是 <emphasis>虚拟的</emphasis> 分类 &mdash;
@@ -2048,7 +2048,7 @@ PORTEPOCH= 1</programlisting>
</sect2>
<sect2 id="proposing-reorg">
- <title>提议对分类进行重新组织</title>
+ <title>如何提议对分类进行重新组织</title>
<para>有些时候会有一些人提议重新将分类组织为 2-层 或某种基于关键字的结构。
目前为止, 还没有进行任何相关的改变, 因为尽管这些修改比较容易完成,
@@ -4403,6 +4403,16 @@ PORTVERSION= 1.0</programlisting>
<literal>gettext</literal> 的位置告诉它:</para>
<programlisting>USE_GETTEXT= yes
+CPPFLAGS+= -I${LOCALBASE}/include
+LDFLAGS+= -L${LOCALBASE}/lib
+
+GNU_CONFIGURE= yes
+CONFIGURE_ENV= CPPFLAGS="${CPPFLAGS}" \
+ LDFLAGS="${LDFLAGS}"</programlisting>
+
+ <para>当然, 不需要传参数给 <command>configure</command> 时, 代码可以更为简练:</para>
+
+ <programlisting>USE_GETTEXT= yes
GNU_CONFIGURE= yes
CONFIGURE_ENV= CPPFLAGS="-I${LOCALBASE}/include" \
LDFLAGS="-L${LOCALBASE}/lib"</programlisting>
@@ -5880,9 +5890,8 @@ USE_SDL+= mixer
<title>使用 wxWidgets</title>
<para>如果您的 port 用到了跨平台工具套件 <application>wxWidgets</application>,
- 则应定义 <literal>USE_WX=yes</literal>。 如果希望指定具体的版本,
- 则可以设置为类似
- <literal>USE_WX=2.6</literal> 这样。 除此之外,
+ 则应定义 <literal>USE_WX</literal>。 此外, 必须通过类似
+ <literal>USE_WX=2.6</literal> 这样的形式来指定具体的版本。 除此之外,
还可以指定范围 (<literal>2.4-2.6</literal>)
和开区间 (<literal>-2.4</literal>、 <literal>2.6+</literal>)
这样的形式。</para>
@@ -5943,7 +5952,7 @@ USE_SDL+= mixer
<makevar>WX_CONF_ARGS</makevar>。 可选的值包括表示
<literal>--with-wx-config=${WX_CONFIG}</literal> 的
<literal>absolute</literal>, 以及表示
- <literal>--with-wx=${X11BASE}</literal> 的
+ <literal>--with-wx=${X11BASE} --with-wx-config=${WX_CONFIG}</literal> 的
<literal>relative</literal>; 这些参数将作为 configure 的参数。</para>
<para>如果您的 port 需要 Unicode 版本的 wxWidgets 函数库, 则应定义
@@ -6245,7 +6254,7 @@ etc/orbit.conf.sample
<para>建立一空白 <filename>pkg-plist</filename> 文件:</para>
- <screen>&prompt.root; <userinput>touch pkg-plist</userinput></screen>
+ <screen>&prompt.root; <userinput>:&gt;pkg-plist</userinput></screen>
<para>如果您的 port 遵循 <makevar>PREFIX</makevar> (应该如此)
则接下来应安装该 port 并创建装箱单。</para>
@@ -6660,6 +6669,21 @@ post-install:
会自动剔除 <makevar>DESTDIR</makevar>,
因为这些文件都会在目标环境中使用。</para>
</sect1>
+
+ <sect1 id="testing-tinderbox">
+ <title>Tinderbox</title>
+
+ <para>如果您是非常热心的 ports 参与者, 则可以看看 <application>Tinderbox</application>。
+ 这是一个强大的用于构建和测试 ports 的系统, 它基于
+ <link linkend="build-cluster">Pointyhat</link> 的脚本。 您可以使用
+ <filename role="package">misc/tinderbox</filename> port 来安装
+ <application>Tinderbox</application>。 请一定仔细阅读随它安装的文档,
+ 因为配置并不简单。</para>
+
+ <para>请访问 <ulink url="http://tinderbox.marcuscom.com/">Tinderbox 网站</ulink>
+ 以了解进一步的细节。</para>
+
+ </sect1>
</chapter>
<chapter id="port-upgrading">
@@ -8782,6 +8806,14 @@ Reference: &lt;http://www.freebsd.org/ports/portaudit/74a9541d-5d6c-11d8-80e3-00
<entry>601104</entry>
</row>
<row>
+ <entry>6.2-RELEASE</entry>
+ <entry>602000</entry>
+ </row>
+ <row>
+ <entry>6.2-RELEASE 之后的 6.2-STABLE。</entry>
+ <entry>602100</entry>
+ </row>
+ <row>
<entry>7.0-CURRENT。</entry>
<entry>700000</entry>
</row>
@@ -8890,6 +8922,14 @@ Reference: &lt;http://www.freebsd.org/ports/portaudit/74a9541d-5d6c-11d8-80e3-00
7.0-CURRENT。</entry>
<entry>700022</entry>
</row>
+ <row>
+ <entry>加入新的声音 IOCTL 之后的 7.0-CURRENT。</entry>
+ <entry>700023</entry>
+ </row>
+ <row>
+ <entry>汇入 OpenSSL 0.9.8d 之后的 7.0-CURRENT。</entry>
+ <entry>700024</entry>
+ </row>
</tbody>
</tgroup>
</table>
@@ -9327,7 +9367,7 @@ exec %%LOCALBASE%%/bin/java -jar %%DATADIR%%/foo.jar "$@"</programlisting>
<sect1 id="dads-noinstall">
<title>使用 <makevar>BROKEN</makevar>、
<makevar>FORBIDDEN</makevar> 或 <makevar>IGNORE</makevar>
- 标记不可安装的 port</title>
+ 阻止用户安装 port</title>
<para>某些时候会需要阻止用户安装某个 port。
想要告诉用户某个 port 不应被安装, 有许多可以在 port 的
@@ -9490,8 +9530,8 @@ exec %%LOCALBASE%%/bin/java -jar %%DATADIR%%/foo.jar "$@"</programlisting>
</sect1>
<sect1 id="dads-deprecated">
- <title>可以用 <makevar>DEPRECATED</makevar>
- 或 <makevar>EXPIRATION_DATE</makevar> 表示某个 port 将被删除。</title>
+ <title>使用 <makevar>DEPRECATED</makevar>
+ 或 <makevar>EXPIRATION_DATE</makevar> 表示某个 port 将被删除</title>
<para>一定要记得 <makevar>BROKEN</makevar> 和
<makevar>FORBIDDEN</makevar> 只应作为当某个 port
@@ -9561,6 +9601,23 @@ IGNORE=POINTYHAT is not supported
因为此变量将展开成命令的完整路径, 并且用户可以根据需要另行指定。</para>
</sect1>
+ <sect1 id="dads-rerolling-distfiles">
+ <title>重新发布的 distfiles</title>
+
+ <para>有时, 一些软件的作者会修改业已发布的 distfile 的内容,
+ 而并不修改文件名。 这种情况下, 您需要验证这些变动是来自软件作者的官方改动。
+ 在过去, 曾经发生过下载服务器上的 distfile 被悄悄换成注入过恶意代码的版本,
+ 并给用户安全造成威胁或损害的事情。</para>
+
+ <para>您应保留一份旧的 distfile, 并下载一份新的, 分别展开,
+ 用 &man.diff.1; 来对比其内容。 如果没有发现可疑的变动,
+ 就可以更新 <filename>distinfo</filename> 了。
+ 请务必在您的 PR 或 commit log 中对这些差异进行描述,
+ 以便让别人了解您已经仔细对比过差异, 并确认没有问题了。</para>
+
+ <para>除此之外, 也可以联系软件的作者, 以确认这些修改是否是他们做的。</para>
+ </sect1>
+
<sect1 id="dads-workarounds">
<title>一些必要的 workaround</title>