diff options
author | Xin LI <delphij@FreeBSD.org> | 2006-10-08 16:30:27 +0000 |
---|---|---|
committer | Xin LI <delphij@FreeBSD.org> | 2006-10-08 16:30:27 +0000 |
commit | 914b35f784ed80f4a86fe77fdeef9ff574ba2d5b (patch) | |
tree | 47e3aa0d270c41dc3aede6903c413026311793cc /zh_CN.GB2312/books/porters-handbook | |
parent | dbc4960a53d107d5e4a70fe468f1e4bce766331a (diff) |
Notes
Diffstat (limited to 'zh_CN.GB2312/books/porters-handbook')
-rw-r--r-- | zh_CN.GB2312/books/porters-handbook/book.sgml | 79 |
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> 分类 — @@ -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>:>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: <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: <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> |