aboutsummaryrefslogtreecommitdiff
path: root/zh_CN.GB2312/books
diff options
context:
space:
mode:
authorXin LI <delphij@FreeBSD.org>2005-11-23 15:06:30 +0000
committerXin LI <delphij@FreeBSD.org>2005-11-23 15:06:30 +0000
commit050e7f3c0726fd075e8f71ef0e4dd1a9740da7b0 (patch)
tree2b6f9f48e042b797f3f1ad34747001278ad73e86 /zh_CN.GB2312/books
parent065cd3fca2b3fbfb9c6cb66e6695d5551755c5c2 (diff)
Notes
Diffstat (limited to 'zh_CN.GB2312/books')
-rw-r--r--zh_CN.GB2312/books/porters-handbook/book.sgml2135
1 files changed, 1212 insertions, 923 deletions
diff --git a/zh_CN.GB2312/books/porters-handbook/book.sgml b/zh_CN.GB2312/books/porters-handbook/book.sgml
index 2465ed7954..1fe685f65d 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.603
+ Original Revision: 1.639
$FreeBSD$
-->
@@ -42,7 +42,7 @@
<para>����ÿ���˶���ͨ�� FreeBSD Ports Collection
�� FreeBSD ����װӦ�ó��� (��ports��)�ġ�
- ����FreeBSD����������һ���� ����Ҫ������־Ը�ߵ�Ŭ����
+ ����FreeBSD����������һ���� ����Ҫ������־Ը�ߵ�Ŭ����
�������Ķ�����ĵ���ʱ������ؼ�ס��Щ��</para>
<para>�� FreeBSD ������� �κ��˶����ύ�µ� port��
@@ -65,7 +65,7 @@
<filename>/usr/ports/Mk/bsd.port.mk</filename>�� ���� port
�� Makefile �ļ������������ ��ʹ����ÿ�춼ȥ��Ū Makefile��
��Ҳ����Ǹ��ļ������úܶ�֪ʶ�� �����ע�ͷdz���ϸ��
- ����Ҫ����һ�£�����������������⣬ ���Ը�&a.ports;
+ ����Ҫ����һ�£�����������������⣬ ���Ը�&a.ports;
��� mailing list ���š�</para>
<note>
@@ -73,7 +73,7 @@
(<makevar><replaceable>VAR</replaceable></makevar>)
�Dz����޸ĵġ� ��� (������ȫ��) ����
<filename>/usr/ports/Mk/bsd.port.mk</filename>
- �Ŀ�ʼ���ֽ����˽��ܣ� ����һЩҲӦ�ÿ����������ҵ���
+ �Ŀ�ʼ���ֽ����˽��ܣ� ����һЩҲӦ�ÿ����������ҵ���
ע����Щ�ļ�ʹ���˷DZ�׼���Ʊ�����
<application>Emacs</application> ��
<application>Vim</application> Ӧ�����ڴ��ļ���ʱ���Զ�ʶ������
@@ -139,7 +139,7 @@ USE_IMAKE= yes
�������Dz��Ǵ����Ϊ package�� ������
<filename>pkg-descr</filename> ��
<filename>pkg-plist</filename>�� �������ļ�ʹ�� <filename>pkg-</filename>
- ǰ׺�������������ļ���</para><!-- NOT GOOD -->
+ ǰ׺�������������ļ���</para><!-- NOT GOOD -->
<sect2>
<title><filename>pkg-descr</filename> (���� port ���߳������ļ�)</title>
@@ -157,21 +157,18 @@ USE_IMAKE= yes
���Ҫ��ֲ�������йٷ���WWW��ҳ�� ��Ӧ���������г�����
ʹ�� <literal>WWW:</literal> ��Ϊǰ׺����ʾ
<emphasis>һ��</emphasis>��վ��
- �����������Զ����߾������������ˡ�</para>
+ �����������Զ����߾������������ˡ�</para>
</note>
- <para>���������ļ�����������������֣�
- ��������:</para>
+ <para>������һ���򵥵�
+ <filename>pkg-descr</filename> ���ӣ�</para>
<programlisting>This is a port of oneko, in which a cat chases a poor mouse all over
the screen.
:
(etc.)
-WWW: http://www.oneko.org/
-
-- Satoshi
-asami@cs.berkeley.edu</programlisting>
+WWW: http://www.oneko.org/</programlisting>
</sect2>
<sect2>
@@ -205,10 +202,10 @@ lib/X11/oneko/mouse.xpm
</note>
<note>
- <para>�ֹ�����һ���������ļ��б���һ���dz���������顣
- ��� port Ҫ��װ�dz�����ļ��Ļ��� ��ο� <link
- linkend="porting-autoplist">�Զ���������ļ��б�</link>
- һ�ڣ� �����ʡ�²���ʱ�䡣</para>
+ <para>�ֹ���������һ���б�������һ���dz���������顣
+ ������� port ��Ҫ��װ�������ļ��� <link
+ linkend="plist-autoplist">�Զ�����װ�䵥</link>
+ �����ʡ�²���ʱ�䡣</para>
</note>
<para>ֻ��һ��������Բ��� <filename>pkg-plist</filename>�ļ���
@@ -230,16 +227,16 @@ PLIST_DIRS= lib/X11/oneko</programlisting>
<para>��Ȼ�� ���һ�� port ����Ҫ�����Լ�����Ŀ¼�Ļ���
�Ͳ������� <makevar>PLIST_DIRS</makevar> �����ˡ�</para>
- <para>�����г� port Ҫ��װ���ļ���Ŀ¼�Ĵ��۾��ǣ�
- ���޷�ʹ���� &man.pkg.create.1; ������ܵ����������� package��
- ��ˣ� ���ַ��������ʺ�һЩ�򵥵� port��
- ��Ϊ��������Щ port ��ø�Ϊ�򵥡� ���⣬
- ������Ҳ�����ڼ��� port collection �е��ļ�������
- ���ڴ������ <filename>pkg-plist</filename> ǰ����һ�����������</para>
+ <para>������ ��������ַ�ʽ���г� port Ҫ��װ���ļ���Ŀ¼�Ļ���
+ Ҳ���޷������� &man.pkg.create.1; ����ܵ����������� package �ˡ�
+ ��ˣ� ���ַ���ֻ��������Щ�򵥵� port�� ʹ���Ǹ�Ϊ�򻯡� ͬʱ��
+ ��������Ҳ�����ڼ��� ports collection �е��ļ�������
+ �ڲ��� <filename>pkg-plist</filename> ֮ǰ��
+ �뿼��һ��ʹ�����ַ�����</para>
- <para>�Ժ����ǽ����� <filename>pkg-plist</filename> ��
- <makevar>PLIST_FILES</makevar> ����
- <link linkend="porting-plist">�����ӵ�����</link>��</para>
+ <para>�Ժ����ǽ����� <filename>pkg-plist</filename>
+ �Լ� <makevar>PLIST_FILES</makevar> ��δ���
+ <link linkend="plist">�����ӵ�����</link>��</para>
</sect2>
</sect1>
@@ -279,8 +276,8 @@ PLIST_DIRS= lib/X11/oneko</programlisting>
</listitem>
<listitem>
- <para>���� port ���� deinstall �Ժ��Զ����
- <link linkend="porting-cleaning">����</link></para>
+ <para>���� port ����ж�� (deinstall) ʱ��
+ �Զ���� <link linkend="plist-cleaning">����</link></para>
</listitem>
</itemizedlist>
@@ -326,13 +323,12 @@ PLIST_DIRS= lib/X11/oneko</programlisting>
<sect1 id="porting-portlint">
<title>�� <command>portlint</command> ����� port</title>
- <para>��ʹ�� <command>portlint</command> �������������
- port �Ƿ�������ǵĹ淶�� <command>portlint</command>
- ������ ports collection ��һ���֡� ���⣬ ��Ҳ��Ҫ���
- <link linkend="porting-samplem">Makefile</link>
- �Ƿ���Ϲ淶�� �Լ�
- <link linkend="porting-pkgname">package</link>
- �Ƿ�ǡ����������</para>
+ <para>��ʹ�� <command>portlint</command> ������������� port
+ �Ƿ�������ǵĹ淶�� <filename role="package">
+ devel/portlint</filename> ������ ports collection ��һ���֡�
+ ����������Ҫ�����ǰ��������
+ <link linkend="porting-samplem">Makefile</link> ����ʽ�Ƿ���Ϲ淶��
+ �Լ� <link linkend="porting-pkgname">package</link> �������Ƿ���塣</para>
</sect1>
<sect1 id="porting-submitting">
@@ -341,25 +337,21 @@ PLIST_DIRS= lib/X11/oneko</programlisting>
<para>���ȣ� ȷ�����Ѿ��Ķ���
<link linkend="porting-dads">����ʲô�Ͳ�����ʲô</link> һ�ڡ�</para>
- <para>��Ȼ������������ port�� ʣ�µĹ������ǰ����Ž�
- FreeBSD �� ports���� ʹ����������Ҳϲ������ ���Dz���Ҫ����
- <filename>work</filename> Ŀ¼����
- <filename>pkgname.tgz</filename> ���� �������ڿ���ɾ�������ˡ�
- ��һ����ֻҪ��
- <command>shar `find port_dir`</command>��������
- ����һ�� bug �����У� �� &man.send-pr.1; �����ύ (�����
- <ulink url="&url.articles.contributing;/contrib-how.html#CONTRIB-GENERAL">
- Bug Reports and General Commentary</ulink> �Ի�ø������
- &man.send-pr.1;�����顣) ���δѹ����
- port ���� 20KB�� ������ϣ������ѹ���� tar ���� ���ڰ����ӽ�
- bug����ǰʹ�� &man.uuencode.1; (��ȻС�� 20KB
- �� bug ����Ҳ����ʹ�ò��� uuencode ����� tar����
- �������Dz���������������) ȷ������ bug ���水�� <literal>ports</literal>
- �� <literal>change-request</literal> ���࣬ (ע�ⲻҪ��
- Bug �����dz� ���ܣ� �� <literal>confidential</literal> �ģ�)
- �� PR �� <quote>Description</quote> һ������дһ������
- port �ļ������� ͬʱ�� shar �� uuencode ����� tar �ļ�����
- <quote>Fix</quote> ��һ����</para>
+ <para>��Ȼ�Ѿ����������� port �൱�����ˣ� ʣ�µĹ�����
+ ���ǽ����Ž� FreeBSD ���� ports ���� �Ա��ø�����˴������档
+ ���Dz�����Ҫ���� <filename>work</filename>
+ Ŀ¼�Լ� <filename>pkgname.tgz</filename> ���� ������ڿ���ɾ�������ˡ�
+ �������� ֻҪ�� <command>shar `find
+ port_dir`</command> �����д��һ�� bug �����У� ����
+ &man.send-pr.1; ���� (�μ� <ulink url="&url.articles.contributing;/contrib-how.html#CONTRIB-GENERAL">Bug
+ Reports and General Commentary</ulink> ���˽����
+ &man.send-pr.1; �Ľ�һ������) �����ͳ��� ����ؽ����� bug ������� (category) Ϊ
+ <literal>ports</literal> �����ӷ��� (class) ����Ϊ
+ <literal>change-request</literal> (��Ҫ�ѱ������Ϊ���ܵģ� ��
+ <literal>confidential</literal>��)�� ���⣬
+ �� PR ������ (<quote>Description</quote>) һ���У�
+ Ӧ����д������ֲ��Ӧ�ó���ļ򵥽��ܣ� �� shar
+ ��Ӧ�ŵ����� (<quote>Fix</quote>) ���С�</para>
<note>
<para>�����ⱨ������ʹ����һ�κõ�������
@@ -386,7 +378,7 @@ PLIST_DIRS= lib/X11/oneko</programlisting>
<para>һ�����ǿ��������ı��棬 �б�Ҫ�Ļ����ǻ���ϵ����
�������ŵ� ports ��� ��������Ҳ�������
<ulink url="&url.articles.contributors;/contrib-additional.html">Additional FreeBSD Contributors</ulink>
- ���������ļ��� ���Ǻܰ���!? <!-- smiley -->
+ ���������ļ��� ���Ǻܰ���!? <!-- smiley -->
:-)</para>
</sect1>
</chapter>
@@ -457,7 +449,7 @@ PLIST_DIRS= lib/X11/oneko</programlisting>
</listitem>
<listitem>
- <para>��������� <makevar>HAS_CONFIGURe</makevar>
+ <para>��������� <makevar>HAS_CONFIGURE</makevar>
���� <makevar>GNU_CONFIGURE</makevar>�� �ͻ�ִ��
<filename><makevar>WRKSRC</makevar>/configure</filename>��</para>
</listitem>
@@ -595,7 +587,7 @@ PLIST_DIRS= lib/X11/oneko</programlisting>
<note>
<para>������ȷ�������� �������ύ��
FreeBSD ports collection �IJ�����
- �ű����������ļ��������ٶ��Ա�׼�� BSD ��Ȩ������</para>
+ �ű����������ļ��������ٶ��Ա�׼�� BSD ��Ȩ������</para>
</note>
</sect1>
@@ -614,7 +606,7 @@ PLIST_DIRS= lib/X11/oneko</programlisting>
��Щ�ļ�Ӧ�ñ����� <makevar>PATCHDIR</makevar> �
������Щ�������ᱻ�Զ����ϡ�
���еIJ������������ <makevar>WRKSRC</makevar> ��
- (port ��� tarball ��ѹ������� ��������µ���������)��
+ (port ��� tarball ��ѹ������� ��������µ���������)��
Ϊ��ʹ�޸ĺ�������ø����ף� Ӧ����ʹ�ö��
patch ȥ�޸�ͬһ���ļ� (���磬
<filename>patch-file</filename> �� <filename>patch-file2</filename>
@@ -622,7 +614,7 @@ PLIST_DIRS= lib/X11/oneko</programlisting>
��Ӧ������)��<para>
<para>ֻ�� <literal>[-+._a-zA-Z0-9]</literal> ��Щ�ַ���
- ���Գ����ڲ������ļ����У� ����ز�Ҫʹ�ó���Щ�ַ�����������ַ���
+ ���Գ����ڲ������ļ����У� ����ز�Ҫʹ�ó���Щ�ַ�����������ַ���
��Ҫ�����IJ��������� <filename>patch-aa</filename>
�� <filename>patch-ab</filename> �����������֣�
������ڲ��������ᵽ·�����ļ�����</para>
@@ -713,7 +705,7 @@ post-extract:
������ֲ���Ҳ��һ��
<link linkend="porting-samplem">Makefile����</link>��
�������������˳����д��ʹ������ port
- �����׵ر������˿�����</para>
+ �����׵ر������˿�����</para>
<para>���ڣ� ������ʼ��д���µ�<filename>Makefile</filename>
��ʱ�� ��������˼��һ�����µ����⣺</para>
@@ -1047,16 +1039,16 @@ PORTEPOCH= 1</programlisting>
</listitem>
<listitem>
- <para>������ port �ܽ���ͬ��Ĭ������
- <link linkend="porting-masterdir">Ӳ����</link>
- ������ (ͨ���Dz��ֵ�Ŀ¼��)�� ��ô
+ <para>��� port ����ʹ�ò�ͬ�� <link
+ linkend="makefile-masterdir">Ӳ����Ĭ������</link>
+ ���й��� (ͨ����һϵ�� port ��һ����Ŀ¼��)�� ��
<replaceable>-compiled.specifics</replaceable>
- Ӧ�������������ȥ��Ĭ������ (���ֺ��ǿ�ѡ��)��
- ��������������ֽ�Ŵ�С�Ͳ�ͬ�����塣</para>
+ ���־�Ӧ����ʾ�����ȥ��Ĭ��ֵ (�˴����ֺ��ǿ�ѡ��)��
+ ͨ������������ֽ�ͺͲ�ͬ������ߴ硣</para>
<para><replaceable>-compiled.specifics</replaceable>
- ����Ӧ���� <makevar>PKGNAMESUFFIX</makevar>
- ���������á�</para>
+ ����Ӧ��ͨ�� <makevar>PKGNAMESUFFIX</makevar>
+ ���������á�</para>
</listitem>
<listitem>
@@ -1405,7 +1397,7 @@ PORTEPOCH= 1</programlisting>
<row>
<entry><filename>emulators</filename></entry>
- <entry>��������ϵͳ��ģ������</entry>
+ <entry>��������ϵͳ��ģ������</entry>
<entry>�ն�ģ���� <emphasis>��Ӧ��</emphasis>
����������� &mdash; ���� X ��Ӧ�÷���
<filename>x11</filename> �������ı�ģʽ��Ӧ�÷ŵ�
@@ -1544,7 +1536,7 @@ PORTEPOCH= 1</programlisting>
<row>
<entry><filename>math</filename></entry>
- <entry>��ֵ�����������ѧ��ص�������</entry>
+ <entry>��ֵ�����������ѧ��ص�������</entry>
<entry></entry>
</row>
@@ -1557,7 +1549,7 @@ PORTEPOCH= 1</programlisting>
<row>
<entry><filename>misc</filename></entry>
<entry>��ʽ������ʵ�ó���</entry>
- <entry>ͨ���������������κη��࣬
+ <entry>ͨ���������������κη��࣬
������ܵĻ��� ����Ϊ���� port ѡ��
<literal>misc</literal>
����ķ��࣬ ��Ϊ�������
@@ -1577,6 +1569,12 @@ PORTEPOCH= 1</programlisting>
</row>
<row>
+ <entry><filename>net-im</filename></entry>
+ <entry>��ʱ��Ϣ������</entry>
+ <entry></entry>
+ </row>
+
+ <row>
<entry><filename>net-mgmt</filename></entry>
<entry>�������������</entry>
<entry></entry>
@@ -1884,7 +1882,7 @@ PORTEPOCH= 1</programlisting>
<listitem>
<para>���ض�����ķ���Ӧ�����������ض������ǰ�档
���磬 HTML �༭��Ӧ���������� <filename>www
- editors</filename>�� ������������ʲô�� ͬ���أ�
+ editors</filename>�� ������������ʲô�� ͬ���أ�
����Ӧ���г� <filename>net</filename>�� ��� port ����
<filename>irc</filename>�� <filename>mail</filename>��
<filename>mbone</filename>�� <filename>news</filename>��
@@ -1912,11 +1910,11 @@ PORTEPOCH= 1</programlisting>
<listitem>
<para><filename>misc</filename>
- ����� port ����������������ķ��ࡣ
+ ����� port ����������������ķ��ࡣ
����������� <makevar>CATEGORIES</makevar>
������ <literal>misc</literal> ������ķ��࣬
����ζ�ſ��԰�ȫ��ɾ�� <literal>misc</literal>
- ���� port �ŵ���������Ŀ¼���ˣ�</para>
+ ���� port �ŵ���������Ŀ¼���ˣ�</para>
</listitem>
<listitem>
@@ -2302,7 +2300,7 @@ EXTRACT_ONLY= source.tar.gz</programlisting>
<para>һЩӦ�ó�����Ҫ�Ӷ��վ�����ز�ͬ��Դ����� ���磬
<application>Ghostscript</application> �����˳�����ı�����
�Լ������������ļ��� �Լ���ȡ�����û��Ĵ�ӡ��Ʒ�ƺ��ͺŵ���������
- ijЩ�����ļ��Ѿ��������ĸ����� ��Ҳ�кܶ���Ҫ������վ�����ء�</para>
+ ijЩ�����ļ��Ѿ��������ĸ����� ��Ҳ�кܶ���Ҫ������վ�����ء�</para>
<para>Ϊ����Ӧ������Ҫ�� ÿһ��
<makevar>DISTFILES</makevar> ��Ӧ����һ��ð�ţ�
@@ -2393,7 +2391,7 @@ DISTFILES= source1.tar.gz:source1 \
<para>û�к�׺��Ԫ��������ģ� Ҳ�������Ƕ������Ǹ������
<literal>DEFAULT</literal> �顣 ��Ԫ�ؼ���
<literal>DEFAULT</literal> ��׺ͨ���Ƕ���ģ�
- ��������ͬʱ���� <literal>DEFAULT</literal> ���������Ԫ��
+ ��������ͬʱ���� <literal>DEFAULT</literal> ���������Ԫ��
(�μ� <xref
linkend="porting-master-sites-n-comma-operator">)��</para>
@@ -2873,25 +2871,25 @@ PATCHFILES= patch1:test</programlisting>
<para>���ڴ˴�д�����ĵ����ʼ���ַ�� <!-- smiley
--><emphasis>:-)</emphasis></para>
- <para>��Ҫע����ǣ� <makevar>MAINTAINER</makevar> ��ֵֻ����һ�������ʼ���ַ��
- ���ʽ�� <literal>user@hostname.domain</literal>��
- �˴���Ҫд�κ�˵���Ե����֣� ����������ʵ���� &mdash; ���ʹ
- <filename>bsd.port.mk</filename> �е����� �������֣�
- Ӧ���� <filename>pkg-descr</filename> �С�</para>
-
- <para>�໤�˵�ְ��˵����
- ������ <ulink url="&url.books.developers-handbook;/policies.html#POLICIES-MAINTAINER">Makefiles
- �е� MAINTAINER</ulink> �ҵ���</para>
-
- <para>���ijһ port �ļ໤��û�������� (��Ҫ�Ĺ������ճ���)
- ֮����Ӧ�û��ĸ������� ����Ϊ�໤�˳�ʱ��
- �Ӷ�������û�м໤����ȷͬ��������½��и��¡�
- ����໤��û����������֮��������Ӧ�� �����ڲ��Ƕ�������Σ�
- ����Ա����Ӧ port �ļ໤�ˡ� �˹涨���ڼ໤��Ϊ &a.portmgr; ��
- &a.security-officer; �� port �����á� δ�����ɣ�
- ������ commit ��ЩС�����໤�� port��</para>
-
- <para>&a.portmgr; �������κ�ԭ���ջػ��ƹ��໤Ȩ��Ȩ����
+ <para>��Ҫע��һ�㣬 <makevar>MAINTAINER</makevar>
+ ������ֵֻ����һ��������ע�Ͳ��ֵĵ����ʼ���ַ��
+ ���ʽӦΪ <literal>user@hostname.domain</literal>��
+ �벻Ҫ�ڴ˴�д�κ�˵���Ե����֣� ����������ʵ���� &mdash; ����
+ <filename>bsd.port.mk</filename> �����鷳��</para>
+
+ <para>��ϸ�ļ໤��ְ��˵����
+ ������ <ulink url="&url.books.developers-handbook;/policies.html#POLICIES-MAINTAINER">Makefile
+ �е� MAINTAINER</ulink> С�����ҵ���</para>
+
+ <para>����ijһ port �ļ໤��û��������֮�� (��������Ҫ�Ĺ�������)
+ ��Ӧ�����û��ĸ������� �����Ϊ�໤�˳�ʱ��
+ ����������¿�����û�м໤����ȷͬ��������½��и��¡�
+ ����໤���ڶ�������µ�ʱ����û�н����κ���Ӧ��
+ �������Ϊ�ü໤�˲��Ƕ��� �����Գ��ִ�������� port ���м໤�˱����
+ ������ˣ� �໤��Ϊ &a.portmgr; ���� &a.security-officer; �� port
+ ���ܴ��ޡ� �Լ໤��Ϊ��ЩС��� port ����δ�����ɵ� commit �Dz������ġ�</para>
+
+ <para>&a.portmgr; �������κ�ԭ���ջػ��ƹ��κ��˼໤Ȩ��Ȩ����
�� &a.security-officer; �����԰�ȫԭ���ջػ��ƹ��໤Ȩ��Ȩ����</para>
</sect1>
@@ -2915,7 +2913,7 @@ PATCHFILES= patch1:test</programlisting>
<sect1 id="makefile-depend">
<title>������ϵ</title>
- <para>���� port ���������� port��
+ <para>���� port ���������� port��
���߸��������ڰ�����ȷ��������ļ����������û��Ļ����ϡ�
���⣬ Ҳ�ṩ������֧�ֳ������ε�������ϵ������
�Լ���������ϵ��Ϊ�ĸ�����ơ�</para>
@@ -2952,7 +2950,7 @@ PATCHFILES= patch1:test</programlisting>
<maketarget>extract</maketarget> target �У� ����һ��������
<maketarget>install</maketarget> target�� ���⣬
������ϵ�����ֻ�ŵ� package �У� �Ա���
- &man.pkg.add.1; �ܹ��Զ������û�ϵͳ�ϰ�װ�����δ��װ������
+ &man.pkg.add.1; �ܹ��Զ������û�ϵͳ�ϰ�װ�����δ��װ������
package��</para>
</sect2>
@@ -3047,7 +3045,7 @@ PATCHFILES= patch1:test</programlisting>
<sect2>
<title><makevar>EXTRACT_DEPENDS</makevar> (�����Ľ�ѹ������)</title>
- <para>�˱�������ָ�� port �ڽ�ѹ��ʱ����Ŀ�ִ���ļ���������Դ�ļ���
+ <para>�˱�������ָ�� port �ڽ�ѹ��ʱ����Ŀ�ִ���ļ���������Դ�ļ���
��ǰһ���������ƣ� ����һϵ��
<replaceable>path</replaceable>:<replaceable>dir</replaceable><optional><replaceable>:target</replaceable></optional>
Ԫ����б��� ���磬 <programlisting>EXTRACT_DEPENDS=
@@ -3062,7 +3060,7 @@ PATCHFILES= patch1:test</programlisting>
�������ȥ <replaceable>target</replaceable> ���֡�</para>
<note>
- <para>ֻ����������ʽ�������� (Ĭ���� <command>gzip</command>)
+ <para>ֻ����������ʽ�������� (Ĭ���� <command>gzip</command>)
�����޷�ͨ�� <xref
linkend="use-vars"> �����ܵ� <makevar>USE_ZIP</makevar> ��
<makevar>USE_BZIP2</makevar> �����ܴﵽ��Ҫʱ��
@@ -3074,7 +3072,7 @@ PATCHFILES= patch1:test</programlisting>
<title><makevar>PATCH_DEPENDS</makevar> (�����Ĵ򲹶�����)</title>
<para>�����������ָ�� port �ڽ��� patch
- ����ʱ����Ŀ�ִ���ļ���������Դ�ļ��� ��ǰһ���������ƣ� ����һ��
+ ����ʱ����Ŀ�ִ���ļ���������Դ�ļ��� ��ǰһ���������ƣ� ����һ��
<replaceable>path</replaceable>:<replaceable>dir</replaceable><optional><replaceable>:target</replaceable></optional>
Ԫ��ı��� ���磬 <programlisting> PATCH_DEPENDS=
${NONEXISTENT}:${PORTSDIR}/java/jfc:extract
@@ -3092,7 +3090,7 @@ PATCHFILES= patch1:test</programlisting>
<title><makevar>DEPENDS</makevar> (һ������)</title>
<para>������޷���������������������ϵ�� �������� port
- ��Ҫ��ѹ������ port ��Դ������ܹ���ɹ�����װ��
+ ��Ҫ��ѹ������ port ��Դ������ܹ���ɹ�����װ��
��Ӧʹ��������� ���������һ���ʽΪ
<replaceable>dir</replaceable><optional><replaceable>:target</replaceable></optional>
��Ԫ����� ��ǰ�ĸ���ͬ�� ������ʵʩ��顣 �����
@@ -3153,75 +3151,13 @@ PATCHFILES= patch1:test</programlisting>
</row>
<row>
- <entry><makevar>USE_GMAKE</makevar></entry>
-
- <entry>�� port ��Ҫʹ��<command>gmake</command> �����й�����</entry>
-
- </row>
-
- <row>
- <entry><makevar>USE_PERL5</makevar></entry>
-
- <entry>�� port �Ĺ����Ͱ�װ��Ҫʹ�� <literal>perl 5</literal>�� �μ�
- <xref linkend="using-perl"> ���˽��� <literal>perl</literal>
- �йص�����������</entry>
- </row>
-
- <row>
- <entry><makevar>USE_X_PREFIX</makevar></entry>
-
- <entry>�� port ����װ�� <makevar>X11BASE</makevar>
- ����Ĭ�ϵ� <makevar>PREFIX</makevar>�� ��μ�
- <xref linkend="using-x11"> ���˽������� X11 �йصı�����</entry>
- </row>
-
- <row>
- <entry><makevar>USE_AUTOMAKE_VER</makevar></entry>
-
- <entry>�� port �Ĺ����������õ��� GNU <command>automake</command>��
- ��μ� <xref linkend="using-automake"> ���˽���
- <command>automake</command> �йص�����������</entry>
- </row>
-
- <row>
- <entry><makevar>USE_AUTOCONF_VER</makevar></entry>
-
- <entry>�� port �Ĺ����������õ��� GNU <command>autoconf</command>��
- ��μ� <xref linkend="using-automake"> ���˽���
- <command>autoconf</command> �йص�����������</entry>
- </row>
-
- <row>
- <entry><makevar>USE_LIBTOOL_VER</makevar></entry>
-
- <entry>�� port ���������õ��� GNU <command>libtool</command>��
- ��μ� <xref linkend="using-automake"> ���˽���
- <command>libtool</command> �йص�����������</entry>
- </row>
-
- <row>
- <entry><makevar>GMAKE</makevar></entry>
-
- <entry><command>gmake</command> ������·���� ���������
- <envar>PATH</envar> �еĻ���</entry>
- </row>
-
- <row>
<entry><makevar>USE_BISON</makevar></entry>
<entry>�� port �ڹ���ʱʹ�� <command>bison</command>��</entry>
</row>
<row>
- <entry><makevar>USE_SDL</makevar></entry>
-
- <entry>�� port ʹ�� <literal>SDL</literal> ����ɹ�����֧�����С�
- �μ� <xref linkend="using-sdl"> ���˽����ʹ��
- <makevar>USE_SDL</makevar>��</entry>
- </row>
-
- <row>
- <entry><makevar>USE_GCC</makevar></entry>
+ <entry><makevar>USE_GCC</makevar></entry>
<entry>�� port ��Ҫʹ��ijһ�ض��汾��
<command>gcc</command> ������ɱ��롣
@@ -3236,29 +3172,31 @@ PATCHFILES= patch1:test</programlisting>
<makevar>USE_LIBTOOL_VER</makevar> ���á�</entry>
</row>
- <row>
- <entry><makevar>NO_INSTALL_MANPAGES</makevar></entry>
-
- <entry>��Ҫʹ�� <maketarget>install.man</maketarget>
- target��</entry>
- </row>
</tbody>
</tgroup>
</table>
- <para>������� port ��Ҫʹ�� X Window ϵͳ��
- ��Ӧ���� <literal>USE_XLIB=yes</literal>�� (���������
- <makevar>USE_IMAKE</makevar> �������������)�� ������� port
- ʹ���� GNU <command>make</command> ������ BSD
- <command>make</command>�� ��Ӧ����
- <literal>USE_GMAKE=yes</literal>�� �����Ҫ���� GNU autoconf��
- ����Ҫ���� <literal>USE_AUTOCONF_VER=213</literal>��
- ���� <literal>USE_QT_VER=3</literal> ��ʾ���� port ��Ҫʹ�����µ�
- Qt toolkit�� ���⣬ ��������
- <literal>USE_PERL5=yes</literal> ����ʾ port ��Ҫ
- <literal>perl</literal> ���Եĵ� 5 �档 (���һ����������Ҫ��
- ��ΪijЩ�汾�� FreeBSD �Ļ���ϵͳ�а����� <literal>perl5</literal>��
- ���°汾��û�С�)</para>
+ <para>�� <application>gmake</application>
+ �� <filename>configure</filename> �ű��йصı�����
+ <xref linkend="building"> �н����˽��ܣ� ��
+ <application>autoconf</application>��
+ <application>automake</application> �Լ�
+ <application>libtool</application> �Ľ����������
+ <xref linkend="using-autotools"> �ҵ��� <xref linkend="using-perl">
+ �������� <application>Perl</application> �йصĵı�����
+ <xref linkend="using-x11"> ���г��˹��� X11 �ı����� ���� GNOME �ı����� <xref
+ linkend="using-gnome">�� ������ KDE ������ <xref
+ linkend="using-kde">�� <xref
+ linkend="using-java"> �����˺� Java �йصı����� �� <xref
+ linkend="using-php"> ������˹���
+ <application>Apache</application>�� <application>PHP</application>
+ �Լ� PEAR �Ľ�������Ϣ�� ���� <application>Python</application>��
+ �� <xref linkend="using-python"> ���������ۣ� ������
+ <application>Ruby</application> �Ľ��ܣ�
+ ������� <xref linkend="using-ruby"> ���ҵ���
+ ��� <xref linkend="using-sdl"> �ṩ������
+ <application>SDL</application> Ӧ�ó���ı������ܡ�</para>
+
</sect2>
<sect2>
@@ -3281,7 +3219,7 @@ PATCHFILES= patch1:test</programlisting>
<para>Ҫ������������ij�� port�� ����ʹ�� <makevar>${NONEXISTENT}</makevar>
��Ϊ <makevar>BUILD_DEPENDS</makevar> ��
- <makevar>RUN_DEPENDS</makevar> �ĵ�һ���֡� ֻ��������Ҫʹ������
+ <makevar>RUN_DEPENDS</makevar> �ĵ�һ���֡� ֻ��������Ҫʹ������
port �ṩ��Դ����ʱ��Ӧ�������� ͨ��Ҳ����ͨ������ָ�������̱��������ʱ�䡣
����
@@ -3289,8 +3227,8 @@ PATCHFILES= patch1:test</programlisting>
��ʾ���� <literal>jpeg</literal> port �������ѹ����</para>
- <para>����������ʽ�����ʺϣ� ����Ҫʹ�� <makevar>DEPENDS</makevar>��
- ����ָ�������κ�����¶����� (Ĭ������»��ᰲװ) ���� port��
+ <para>����������ʽ�����ʺϣ� ����Ҫʹ�� <makevar>DEPENDS</makevar>��
+ ����ָ�������κ�����¶����� (Ĭ������»��ᰲװ) ���� port��
������������ϵ������� package�� ��������Ҫ������ д��
<literal>BUILD_DEPENDS</literal> ��
<literal>RUN_DEPENDS</literal> ���ܸ�����һЩ &mdash;
@@ -3314,6 +3252,141 @@ PATCHFILES= patch1:test</programlisting>
</sect1>
+ <sect1 id="makefile-masterdir">
+ <title><makevar>MASTERDIR</makevar> (�� port ���ڵ�Ŀ¼)</title>
+
+ <para>��� port ��Ҫ��ijЩ���������� (������˵�� �ֱ��ʻ�ֽ��)
+ ���������в�ͬ��Ԥ������� �����Ϊÿһ�������İ�������ͬ��Ŀ¼��
+ �����������û������׵ؿ���������Ҫ��װ�İ汾�� ����������Щ port
+ ֮�乲�þ����ܶ���ļ��� һ������£� ������õõ��� ����Ŀ¼֮�ⶼֻ��Ҫ�̵ܶ�
+ <filename>Makefile</filename>�� ��٠<filename>Makefile</filename> ��
+ ������ <makevar>MASTERDIR</makevar> ��ָ�������ļ����ڵ�Ŀ¼��
+ ���⣬ ��Ӧʹ��һ��������Ϊ
+ <link linkend="porting-pkgname"><makevar>PKGNAMESUFFIX</makevar></link>
+ ��һ���֣� �Ա�Ϊ��ͬ�İ�������ͬ��������</para>
+
+ <para>��������������Щ���Ϊ������ ������
+ <filename>japanese/xdvi300/Makefile</filename> �IJ��ִ��룺</para>
+
+ <programlisting>PORTNAME= xdvi
+PORTVERSION= 17
+PKGNAMEPREFIX= ja-
+PKGNAMESUFFIX= ${RESOLUTION}
+ :
+# default
+RESOLUTION?= 300
+.if ${RESOLUTION} != 118 && ${RESOLUTION} != 240 && \
+ ${RESOLUTION} != 300 && ${RESOLUTION} != 400
+ @${ECHO} "Error: invalid value for RESOLUTION: \"${RESOLUTION}\""
+ @${ECHO} "Possible values are: 118, 240, 300 (default) and 400."
+ @${FALSE}
+.endif</programlisting>
+
+ <para><filename role="package">japanese/xdvi300</filename> Ҳ�ṩ��ȫ������IJ�����
+ �Լ�����õ����ļ��ȵ����ݡ� ��������������� <command>make</command>��
+ ����ʹ��Ĭ�ϵķֱ���ֵ (300) �������ع��� port��</para>
+
+ <para>���������ֱ��ʶ��ԣ� ������ <emphasis>������</emphasis>
+ <filename>xdvi118/Makefile</filename>��</para>
+
+ <programlisting>RESOLUTION= 118
+MASTERDIR= ${.CURDIR}/../xdvi300
+
+.include "${MASTERDIR}/Makefile"</programlisting>
+
+ <para>(<filename>xdvi240/Makefile</filename> ��
+ <filename>xdvi400/Makefile</filename> �����Ƶ�)��
+ <makevar>MASTERDIR</makevar> ��������
+ <filename>bsd.port.mk</filename> �����Ŀ¼��
+ ���� <makevar>FILESDIR</makevar> �Լ�
+ <makevar>SCRIPTDIR</makevar> Ӧ��
+ <filename>xdvi300</filename> �в��ҡ� <literal>RESOLUTION=118</literal>
+ ��������� <filename>xdvi300/Makefile</filename> ��������
+ <literal>RESOLUTION=300</literal> ���ã� �Ӷ� port
+ ���Էֱ���Ϊ 118 ��������������</para>
+ </sect1>
+
+ <sect1 id="makefile-manpages">
+ <title>�����ֲ�</title>
+
+ <para><makevar>MAN[1-9LN]</makevar> ��������
+ ���Զ��ؽ������ֲ�ӵ� <filename>pkg-plist</filename> (��Ҳ��ζ��
+ <emphasis>����</emphasis> ��
+ <filename>pkg-plist</filename> ���г������ֲ� &mdash; �μ� <link
+ linkend="plist-sub">PLIST ������</link> ���˽����ϸ��)�� ���⣬
+ ��Ҳ���ð�װ�׶��Զ��ظ����� <filename>/etc/make.conf</filename>
+ �������� <makevar>NOMANCOMPRESS</makevar> �������Զ��������ֲ��ļ�ִ��ѹ�����ѹ��������</para>
+
+ <para>��� port ����ͨ��ʹ�÷������ӻ�Ӳ���ӽ������ֲᰲװΪ������֣�
+ �ͱ���ʹ�� <makevar>MLINKS</makevar> ������������ʾ��
+ �� port ���������ӣ� ���� <filename>bsd.port.mk</filename>
+ ɾ�����ؽ��� ��ȷ������ָ������ȷ���ļ��� �κ��� MLINKS ���г����ļ�����Ӧ��
+ <filename>pkg-plist</filename> ���ٳ��֡�</para>
+
+ <para>Ҫָ���Ƿ��ڰ�װʱ�������ֲ����ѹ����
+ ����ʹ�� <makevar>MANCOMPRESSED</makevar> ������
+ ��һ��������ȡ����ֵ�� <literal>yes</literal>�� <literal>no</literal> ��
+ <literal>maybe</literal> ֮һ�� <literal>yes</literal>
+ ��ʾ�����ֲ��Ѿ���ѹ������ʽ��װ�� <literal>no</literal> ��ʾ��û�У�
+ �� <literal>maybe</literal> ���ʾ����װ������������
+ <makevar>NOMANCOMPRESS</makevar> ������ֵ�� ���
+ <filename>bsd.port.mk</filename> ����Ҫ�ر���ʲô���顣</para>
+
+ <para>��������� <makevar>USE_IMAKE</makevar> �����
+ <makevar>NO_INSTALL_MANPAGES</makevar>��
+ <makevar>MANCOMPRESSED</makevar> ���Զ���Ϊ
+ <literal>yes</literal>�� ��֮����
+ <literal>no</literal>�� ����Ĭ��ֵ�����ʣ�
+ ����Ͳ���Ҫ�� port ����ȷ�ؼ��Ըı䡣</para>
+
+ <para>��� port �������ֲ�ŵ���
+ <makevar>PREFIX</makevar> ֮�������Ŀ¼�� ��Ӧʹ��
+ <makevar>MANPREFIX</makevar> ���������á� ���⣬
+ ���ֻ��ijЩ���ֵ������ֲ�ᰲװ������׼��λ�ã� ����ijЩ <literal>perl</literal>
+ ģ��� port�� ������ʹ��
+ <makevar>MAN<replaceable>sect</replaceable>PREFIX</makevar> (�˴�
+ <replaceable>sect</replaceable> �� <literal>1-9</literal>��
+ <literal>L</literal> �� <literal>N</literal> ֮һ) ��ָ����</para>
+
+ <para>������������ֲ���Ҫװ��ר����ijһ����ר�õ���Ŀ¼��
+ ��Ҫ�� <makevar>MANLANG</makevar> ��Ϊ�������Ե����֡�
+ �˱�����Ĭ��ֵ�� <literal>""</literal> (Ҳ����ֻ��Ӣ��)��</para>
+
+ <para>������һ���ۺϵ����ӡ�</para>
+
+ <programlisting>MAN1= foo.1
+MAN3= bar.3
+MAN4= baz.4
+MLINKS= foo.1 alt-name.8
+MANLANG= "" ja
+MAN3PREFIX= ${PREFIX}/share/foobar
+MANCOMPRESSED= yes</programlisting>
+
+ <para>���ʾ port �ᰲװ�����ļ���</para>
+
+ <programlisting>${PREFIX}/man/man1/foo.1.gz
+${PREFIX}/man/ja/man1/foo.1.gz
+${PREFIX}/share/foobar/man/man3/bar.3.gz
+${PREFIX}/share/foobar/man/ja/man3/bar.3.gz
+${PREFIX}/man/man4/baz.4.gz
+${PREFIX}/man/ja/man4/baz.4.gz</programlisting>
+
+ <para>���⣬ <filename>${PREFIX}/man/man8/alt-name.8.gz</filename>
+ ���ܻ�ͨ������ port ��װ�� Ҳ���ܲ��ᡣ ������Σ�
+ ���ᴴ��һ���������ӣ� �� foo(1) ��
+ alt-name(8) �����ֲ���������</para>
+
+ </sect1>
+
+ <sect1 id="makefile-info">
+ <title>Info �ļ�</title>
+
+ <para>�����������Ҫ��װ GNU �ļ���
+ ����Ҫ�� <makevar>INFO</makevar> �������г� (����Ҫָ��
+ <literal>.info</literal> ��׺)�� ������װ/ж�ش���ͻ��Զ�����ע���ʱ�����Ǽ��뵽
+ <filename>pkg-plist</filename> �ˡ�</para>
+ </sect1>
+
<sect1 id="makefile-options">
<title>Makefile ѡ��</title>
@@ -3324,7 +3397,10 @@ PATCHFILES= patch1:test</programlisting>
ϵͳ�ṩ��һ�鷽��Ļ��ƣ� ���� port �����߿��ƹ���ʱ�����á�
֧����Щ���Կ������û�������ã� ���ﵽ�°빦����Ч����</para>
- <sect2>
+ <sect2>
+ <title>���� (<makevar>KNOBS</makevar>)</title>
+
+ <sect3>
<title><makevar>WITH_<replaceable>*</replaceable></makevar> ��
<makevar>WITHOUT_<replaceable>*</replaceable></makevar></title>
@@ -3430,6 +3506,19 @@ PATCHFILES= patch1:test</programlisting>
</tgroup>
</table>
+ </sect3>
+
+ <sect3>
+ <title>���� (knob) ������</title>
+ <para>���ǽ��� port �Ŀ�����Աʹ�����ƵĿ��أ� �Ա������û�ʹ�ã�
+ �����ٿ������Ƶ������� ��Ϊ���õĿ������ֿ�����
+ <ulink url="http://www.freebsd.org/cgi/cvsweb.cgi/ports/KNOBS?rev=HEAD&amp;content-type=text/x-cvsweb-markup">KNOBS</ulink>
+ �ļ����ҵ���</para>
+
+ <para>���ص�����Ӧ��ӳ�书�ܡ� ��� port �� <makevar>PORTNAME</makevar>
+ ���� lib- ǰ׺�� �򿪹�����Ӧɾȥ lib- ǰ׺��</para>
+
+ </sect3>
</sect2>
<sect2>
@@ -3437,13 +3526,25 @@ PATCHFILES= patch1:test</programlisting>
<sect3>
<title>����</title>
- <para><makevar>OPTIONS</makevar> ��������װ port
- ���û�����һ���Ի��� ���и������õ�ѡ� ��Щѡ����浽
- <filename>/var/db/ports/portname/options</filename> �С�
- �´����¹��� port ʱ�� ��Щѡ������á� ������
- �Ͳ�����Ҫ�������ϴι��� port ʱ���õ��������
+ <para><makevar>OPTIONS</makevar> ��Ϊ���ڰ�װ port
+ ���û��ṩһ����������ѡ��ĶԻ���
+ �����û���ѡ�񱣴浽 <filename>/var/db/ports/<replaceable>portname</replaceable>/options</filename> �С�
+ �´��������� port ʱ�� ��Щѡ����ٴ�ʹ�á�
+ ����һ���� �Ͳ���Ҫ����ȥ������֮ǰ���� port ʱ���Ǽ�ʮ��
<makevar>WITH_<replaceable>*</replaceable></makevar> ��
- <makevar>WITHOUT_<replaceable>*</replaceable></makevar> �ˣ�</para>
+ <makevar>WITHOUT_<replaceable>*</replaceable></makevar>ѡ���ˣ�</para>
+
+ <para>���û����� <command>make config</command> (���״�����
+ <command>make build</command>) ʱ�� ��ܻ����ȼ��
+ <filename>/var/db/ports/<replaceable>portname</replaceable>/options</filename>��
+ �������ļ������ڣ� ������ʹ��
+ <makevar>OPTIONS</makevar> ��ֵ������һ���������û���ø���ѡ��ĶԻ���
+ ��� �û���ѡ�񽫱��浽
+ <filename>options</filename> �ļ��У�
+ ������������ port��</para>
+
+ <para>ʹ�� <command>make showconfig</command> ���Բ鿴��������á�
+ ���⣬ <command>make rmconfig</command> ����ɾ���Ѿ���������á�</para>
</sect3>
<sect3>
@@ -3456,23 +3557,23 @@ PATCHFILES= patch1:test</programlisting>
Ĭ��ֵ������ <literal>ON</literal> ��
<literal>OFF</literal> ֮һ�� ������Ԫ�����ʹ�ö�Ρ�</para>
- <para>���û�ִ�� <command>make config</command> (���״�ִ��
- <command>make build</command>) ʱ��
- ϵͳ����� <filename>/var/db/ports/<replaceable>portname</replaceable>
- /options</filename>�� �������ļ������ڣ� ����ʹ��
- <makevar>OPTIONS</makevar> �е�ֵ����ʾһ���Ի���
- �Ա����û����ijЩѡ� ��� �û���ѡ����Ŀ��������������
- ����Ӧ�ı��������ڹ������̡�</para>
-
- <para>�� <command>make showconfig</command> ���鿴��������á�
- �� <command>make rmconfig</command> ɾ���Ѿ���������á�</para>
+ <para>���� <makevar>OPTIONS</makevar> ������ֵ��
+ ���������� <filename>bsd.port.pre.mk</filename> ֮ǰ���塣
+ �� <makevar>WITH_*</makevar> �� <makevar>WITHOUT_*</makevar>
+ ֻ����������
+ <filename>bsd.port.pre.mk</filename> ֮����ܿ�ʼ��⡣
+ ���ڻ���֧�ֿ�ܵ�һЩȱ�ݣ� ��ֻ��ʹ��
+ <makevar>WITH_*</makevar> �����������ЩĬ��ֵΪ
+ <literal>OFF</literal> ��ѡ� ��ʹ��
+ <makevar>WITHOUT_*</makevar> �����������ЩĬ��ֵΪ
+ <literal>ON</literal> ��ѡ�</para>
<sect3>
<title>����</title>
<example id="ports-options-simple-use">
<title>�򵥵� <makevar>OPTIONS</makevar> �÷�</title>
- <para><programlisting>OPTIONS= FOO "���� foo ѡ��" On \
- BAR "֧�� bar ѡ��" Off
+ <para><programlisting>OPTIONS= FOO "���� foo ѡ��" On \
+ BAR "֧�� bar ����" Off
.include &lt;bsd.port.pre.mk&gt;
@@ -3489,20 +3590,6 @@ RUN_DEPENDS+= bar:${PORTSDIR}/bar/bar
.include &lt;bsd.port.post.mk&gt;</programlisting></para>
</example>
- <sect3>
- <title>��֪����</title>
- <itemizedlist>
- <listitem>
- <para><command>make index</command> Ŀǰ�����ܰ���
- <makevar>OPTIONS</makevar> ��������������ɹ��� (ports/75727)</para>
- </listitem>
- <listitem>
- <para><makevar>PACKAGE_BUILDING</makevar> Ŀǰ�޷���ȷ���
- <makevar>OPTIONS</makevar> (ports/75727?)</para>
- </listitem>
- </itemizedlist>
- </sect3>
-
</sect2>
</sect1>
@@ -3567,61 +3654,6 @@ PORTVERSION= 1.0</programlisting>
</note>
</sect1>
- <sect1 id="makefile-build">
- <title>��������</title>
-
- <para>������������õ��� GNU <command>make</command>�� ��Ӧ����
- <literal>USE_GMAKE=yes</literal>�� �������
- <command>configure</command>�� ��Ӧ����
- <literal>HAS_CONFIGURE=yes</literal>�� ����Ҫʹ�� GNU
- <command>configure</command>�� ����Ҫ����
- <literal>GNU_CONFIGURE=yes</literal> (����Զ�����
- <literal>HAS_CONFIGURE</literal>)�� ���ϣ����
- <command>configure</command> ����һЩ���� (���� GNU
- <command>configure</command> ���ԣ� ��Ĭ��ֵ��
- <literal>--prefix=&dollar;{PREFIX}</literal>�� ���Է� GNU
- <command>configure</command> ���ǿմ�)�� ����Щ����IJ�������Ϊ
- <makevar>CONFIGURE_ARGS</makevar>�� �������������ʹ�� GNU
- <command>autoconf</command>�� ��������
- <literal>USE_AUTOCONF_VER=213</literal>�� ����Զ�����
- <makevar>GNU_CONFIGURE</makevar>�� ����
- <command>autoconf</command> ��
- <command>configure</command> ֮ǰִ�С�</para>
-
- <note>
- <para>����������õ� GNU <command>configure</command>��
- ���������ɵĿ�ִ���ļ������ֺ� <quote>���</quote>�� ����
- <filename>i386-portbld-freebsd4.7-</filename><replaceable>appname</replaceable>��
- ����Ҫ������ֹ��޸�
- <makevar>CONFIGURE_TARGET</makevar> ������
- ���ս��°�� <command>autoconf</command>
- ϣ���ķ�ʽָ��Ŀ������֡� �������� <filename>Makefile</filename>
- �е� <literal>GNU_CONFIGURE=yes</literal> ����֮����룺</para>
-
- <para>
- <literal>CONFIGURE_TARGET=--build=${MACHINE_ARCH}-portbld-freebsd${OSREL}</literal>
- </para>
- </note>
-
- <para>��������������� X Ӧ�ó��� ����ʹ�� <command>imake</command>
- �� <filename>Imakefile</filename> �����ɵ� <filename>Makefile</filename>��
- ��Ӧ����
- <literal>USE_IMAKE=yes</literal>�� ������ ���ܹ��� configure
- �׶��Զ���ִ�� <command>xmkmf -a</command>�� ������� port ʹ��
- <option>-a</option> �����ᵼ�����⣬ ��Ҫ��һ������
- <literal>XMKMF=xmkmf</literal>�� ��� port ʹ��
- <command>imake</command> ���޷�����
- <maketarget>install.man</maketarget> target�� ��Ӧ����
- <literal>NO_INSTALL_MANPAGES=yes</literal>�� ���
- ��Щ����Ӧ֪ͨ���� port ������ԭ���ߡ� <!--
- smiley --><emphasis>:-&gt;</emphasis></para>
-
- <para>������� port ��Դ <filename>Makefile</filename>
- ���ڹ����� target ���ֲ��� <maketarget>all</maketarget>��
- ��Ҫ��Ӧ������ <makevar>ALL_TARGET</makevar>�� ͬ����
- ���� <maketarget>install</maketarget> ��������
- <makevar>INSTALL_TARGET</makevar>��</para>
- </sect1>
</chapter>
<chapter id="special">
@@ -3658,18 +3690,37 @@ PORTVERSION= 1.0</programlisting>
<programlisting>INSTALLS_SHLIB= yes
LDCONFIG_DIRS= %%PREFIX%%/lib/foo %%PREFIX%%/lib/bar</programlisting>
+ <para>Ҫʱ�̽��ǣ� �DZ�׼��Ŀ¼������ (��) ����ʱ�Զ����ݸ�
+ &man.ldconfig.8; �� ����� port �����Ҫ�������� ����Ҫ��
+ <filename role="package">x11/kdelibs3</filename> ������װһ�������ű���
+ �������ϸ��飬 ͨ��������ȫ����Ҫ�ģ�
+ ���߿���ͨ�� <literal>-rpath</literal> ��������ʱ���� <envar>LD_RUN_PATH</envar>
+ ������ (�μ� <filename role="package">lang/moscow_ml</filename>
+ ����������)�� ������һ�� shell ��װ��������ִ�п�ִ���ļ�֮ǰ����
+ <makevar>LD_LIBRARY_PATH</makevar>�� ����
+ <filename role="package">www/mozilla</filename> ������</para>
+
<para>ֵ��ע��������� <makevar>LDCONFIG_DIRS</makevar> ����
�ݾ��� <filename>pkg-plist</filename>
- ����������һ��Ҫͨ��&man.sed.1;���ˣ���
+ ����������һ��Ҫͨ��&man.sed.1;���ˣ���
�� <makevar>PLIST_SUB</makevar>
�û�Ҳ��Ӧ�á������Ƽ���ʹ�� <literal>%%PREFIX%%</literal> �滻
<makevar>PREFIX</makevar>��<literal>%%LOCALBASE%%</literal>
�滻<makevar>LOCALBASE</makevar>��<literal>%%X11BASE%%</literal>
�滻<makevar>X11BASE</makevar>.</para>
+
+ <para>������������汾�ű���Ϊ
+ <filename>libfoo.so.0</filename> �����ĸ�ʽ��
+ ���ǵ����л���������ֻ������ (��һ��) �汾���֡�</para>
+
+ <para>����ڸ��� port ʱ�������������汾�ţ�
+ ������������������Ӱ��Ŀ�� port �� <makevar>PORTREVISION</makevar> ��Ӧ������
+ ��ǿ�����Dz����°汾�Ŀ����±��롣</para>
+
</sect1>
<sect1 id="porting-restrictions">
- <title>Ports�������</title>
+ <title>Ports �������</title>
<para>�ڶ�Э�飬�������е�һЩ������
����������Ӧ�ó����ܱ������
@@ -3763,11 +3814,437 @@ LDCONFIG_DIRS= %%PREFIX%%/lib/foo %%PREFIX%%/lib/bar</programlisting>
</sect2>
</sect1>
+ <sect1 id="building">
+ <title>��������</title>
+
+ <sect2 id="using-make">
+ <title><command>make</command>�� <command>gmake</command>�� �Լ�
+ <command>imake</command></title>
+
+ <para>��� port �õ��� <application>GNU make</application>�� Ӧ����
+ <literal>USE_GMAKE=yes</literal>��</para>
+
+ <table frame="none">
+ <title>������ gmake �йص� port �ı���</title>
+
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>����</entry>
+
+ <entry>����</entry>
+ </row>
+ </thead>
+
+ <tbody>
+ <row>
+ <entry><makevar>USE_GMAKE</makevar></entry>
+
+ <entry>�� port ��Ҫʹ�� <command>gmake</command>
+ ����ɹ������̡�</entry>
+ </row>
+
+ <row>
+ <entry><makevar>GMAKE</makevar></entry>
+
+ <entry>���� <envar>PATH</envar> ��ʱ�� <command>gmake</command>
+ ������·����</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+
+ <para>���� X Ӧ�ó���� port�� �����ʹ��
+ <application>imake</application> ����
+ <filename>Imakefile</filename> �������
+ <filename>Makefile</filename>�� ��Ӧ����
+ <literal>USE_IMAKE=yes</literal>�� ���ʹ���������е�����
+ (configure) �׶��Զ�ִ�� <command>xmkmf -a</command>��
+ ��� <option>-a</option> ��־������� port �����鷳�� ��������
+ <literal>XMKMF=xmkmf</literal>�� ��� port �õ���
+ <application>imake</application> ������ʹ��
+ <maketarget>install.man</maketarget> target�� ��Ӧ����
+ <literal>NO_INSTALL_MANPAGES=yes</literal>��</para>
+
+ <para>��� port Դ�ļ��� <filename>Makefile</filename> ��������
+ target �� <maketarget>all</maketarget> ��������֣�
+ Ӧ��Ӧ������ <makevar>ALL_TARGET</makevar>��
+ ���� <maketarget>install</maketarget> ���ԣ� ��Ӧ�ı�����
+ <makevar>INSTALL_TARGET</makevar>��</para>
+
+ </sect2>
+
+ <sect2 id="using-configure">
+ <title><command>configure</command> �ű�</title>
+
+ <para>���� port ʹ�� <command>configure</command> �ű�����
+ <filename>Makefile.in</filename>
+ ���� <filename>Makefile</filename> �ļ��� ��Ҫ����
+ <literal>GNU_CONFIGURE=yes</literal>��
+ ���ϣ��������IJ����� <command>configure</command> �ű�
+ (Ĭ�ϲ���Ϊ <literal>--prefix=&dollar;{PREFIX}
+ &dollar;{CONFIGURE_TARGET}</literal>)��
+ Ӧͨ�� <makevar>CONFIGURE_ARGS</makevar> ��ָ����Щ������
+ ���Ƶأ� ����ͨ��
+ <makevar>CONFIGURE_ENV</makevar> ����������һЩ����������</para>
+
+ <para>�������������ʹ�� GNU <command>configure</command>��
+ �����ɵĿ�ִ���ļ�������ʽ <quote>����</quote> ��
+ <filename>i386-portbld-freebsd4.7-</filename><replaceable>Ӧ�ó�����</replaceable>��
+ ����Ҫ����һ����ͨ���ı�
+ <makevar>CONFIGURE_TARGET</makevar> ���������ս��°汾��
+ <command>autoconf</command> ���ɵĽű���ϣ���ķ�ʽָ�� target��
+ �䷽���ǣ� ���� <filename>Makefile</filename>
+ �� <literal>GNU_CONFIGURE=yes</literal> һ��֮����룺</para>
+
+ <para>
+ <literal>CONFIGURE_TARGET=--build=${MACHINE_ARCH}-portbld-freebsd${OSREL}</literal>
+ </para>
+
+ <table frame="none">
+ <title>�����õ��� configure �ű��� port �ı���</title>
+
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>����</entry>
+
+ <entry>����</entry>
+ </row>
+ </thead>
+
+ <tbody>
+ <row>
+ <entry><makevar>GNU_CONFIGURE</makevar></entry>
+
+ <entry>�� port ��Ҫ�� <command>configure</command> �ű���׼��������</entry>
+ </row>
+
+ <row>
+ <entry><makevar>HAS_CONFIGURE</makevar></entry>
+
+ <entry>�� <makevar>GNU_CONFIGURE</makevar> ���ƣ�
+ ��Ĭ�ϵ� configure target ��������
+ <makevar>CONFIGURE_ARGS</makevar>��</entry>
+ </row>
+
+ <row>
+ <entry><makevar>CONFIGURE_ARGS</makevar></entry>
+
+ <entry>ϣ������
+ <command>configure</command> �ű��Ķ��������</entry>
+ </row>
+
+ <row>
+ <entry><makevar>CONFIGURE_ENV</makevar></entry>
+
+ <entry>ϣ����ִ�� <command>configure</command>
+ �ű�ʱ���õĻ���������</entry>
+ </row>
+
+ <row>
+ <entry><makevar>CONFIGURE_TARGET</makevar></entry>
+
+ <entry>�滻Ĭ�ϵ� configure target�� ��Ĭ��ֵ��
+ <literal>&dollar;{MACHINE_ARCH}-portbld-freebsd&dollar;{OSREL}</literal>��</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </sect2>
+ </sect1>
+
+ <sect1 id="using-autotools">
+ <title>���� GNU autotools</title>
+
+ <sect2 id="using-autotools-introduction">
+ <title>����</title>
+
+ <para>�ڶ� GNU autotools �ṩ��һ���ڶ��ز���ϵͳ�ͻ����ܹ�֮�Ϲ��������ij�����ơ�
+ �� Ports Collection �У� port ����ͨ���򵥵ķ�����ʹ����Щ���ߣ�</para>
+
+ <programlisting>USE_AUTOTOOLS= <replaceable>����</replaceable>:<replaceable>�汾</replaceable>[:<replaceable>����</replaceable>] ...</programlisting>
+
+ <para>׫д����ʱ�� <replaceable>����</replaceable> ��������Ϊ
+ <literal>libtool</literal>�� <literal>libltdl</literal>��
+ <literal>autoconf</literal>�� <literal>autoheader</literal>��
+ <literal>automake</literal> �� <literal>aclocal</literal> ֮һ��</para>
+
+ <para><replaceable>�汾</replaceable> ����ָ��ϣ��ʹ�õĹ��ߵ��ض��汾 (�μ�
+ <literal>devel/{automake,autoconf,libtool}[0-9]+</literal>
+ ���˽���Ч�İ汾��)��</para>
+
+ <para><replaceable>����</replaceable> ��һ����ѡ����չѡ�
+ �����޸����ʹ�ù��ߡ�</para>
+
+ <para>����ͬʱָ�������ͬ�Ĺ��ߣ� ������һ����ָ���� Ҳ������
+ Makefile �� <literal>+=</literal> �ṹ��</para>
+
+ <para>�ڿ�ʼ������������֮ǰ�� ��Ҫǿ�����ǣ� ��Щ�ṹֻ�����ڹ��� port��
+ ���ϣ�����п�ƽ̨�Ŀ����� ������ IDE �У� ��Ӧʹ��
+ <literal>devel/gnu-{automake,autoconf,libtool}</literal> ��٠port�� <filename
+ role="package">devel/anjuta</filename> �Լ� <filename
+ role="package">devel/kdevelop</filename> (�ֱ��Ӧ�� GNOME �� KDE)
+ �ǹ������������һ������÷�����</para>
+
+ </sect2>
+
+ <sect2 id="using-libtool">
+ <title><command>libtool</command></title>
+
+ <para>ʹ�� GNU ������ܵĹ�����ͨ����ʹ��
+ <command>libtool</command> ������������ı���Ͱ�װ��
+ �Ա��������еIJ���ϵͳ��ƥ�䡣 Ports Collection
+ �ṩ��һϵ�о����޸�����Ӧ &os; �IJ�ͬ�汾�� <command>libtool</command>��</para>
+
+ <programlisting>USE_AUTOTOOLS= libtool:<replaceable>�汾</replaceable>[:inc|:env]</programlisting>
+
+ <para>�����ʹ�ö���IJ�������
+ <literal>libtool:<replaceable>�汾</replaceable></literal>
+ �����߹������ port ϣ��ʹ��
+ <command>libtool</command>�� ��Ҳ�����ض�����
+ <makevar>GNU_CONFIGURE</makevar>�� configure �ű���ʹ��ϵͳ��װ��
+ <command>libtool</command> �汾�����޲��� ����һ����
+ ��������һϵ�� make �� shell ������ �Ա� port ʹ�á� ��μ�
+ <filename>bsd.autotools.mk</filename> �˽��һ�������顣</para>
+
+ <para>���ʹ�� <literal>:inc</literal> �������� ������û�����
+ ��ʹ��һЩ��΢��ͬ�IJ�����</para>
+
+ <para>���ʹ�� <literal>:env</literal> �������� ��ֻ���û�����</para>
+
+ <informaltable frame="none">
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>��ǰ��д��</entry>
+
+ <entry>�µ� <makevar>USE_AUTOTOOLS</makevar> �ṹ</entry>
+ </row>
+ </thead>
+
+ <tbody>
+ <row>
+ <entry><literal>USE_LIBTOOL_VER=13</literal></entry>
+
+ <entry><literal>libtool:13</literal></entry>
+ </row>
+
+ <row>
+ <entry><literal>USE_INC_LIBTOOL_VER=15</literal></entry>
+
+ <entry><literal>libtool:15:inc</literal></entry>
+ </row>
+
+ <row>
+ <entry><literal>WANT_LIBTOOL_VER=15</literal></entry>
+
+ <entry><literal>libtool:15:env</literal></entry>
+ </row>
+
+ </tbody>
+ </tgroup>
+ </informaltable>
+
+ <para>��� <makevar>LIBTOOLFLAGS</makevar> ��
+ <makevar>LIBTOOLFILES</makevar> ���������滻��޸ĵIJ����� �Լ�����
+ <command>libtool</command> �޲����ļ��� ���� port ����Ҫ��������
+ ��μ� <filename>bsd.autotools.mk</filename> ���˽��һ����ϸ�ڡ�</para>
+
+ </sect2>
+
+ <sect2 id="using-libltdl">
+ <title><command>libltdl</command></title>
+
+ <para>һЩ ports ��ʹ�� <command>libltdl</command> �⣬
+ ������ <command>libtool</command> ��������һ���֡�
+ ʹ������Ⲣ����ζ�ű���ʹ��
+ <command>libtool</command> ������ ����ṩ����һ��ṹ��</para>
+
+ <programlisting>USE_AUTOTOOLS= libltdl:<replaceable>�汾</replaceable></programlisting>
+
+ <para>Ŀǰ�� ��һ����������ȫ�������ǽ�
+ <makevar>LIB_DEPENDS</makevar> ����Ϊ�ʵ���
+ <command>libltdl</command> port�� ����Ϊһ���Ĺ��ܣ�
+ Э��������Ա������ <makevar>USE_AUTOTOOLS</makevar> �������ģ�
+ ���� autotools port �������� ������߲����ṩ�����IJ�������</para>
+
+ <informaltable frame="none">
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>��ǰ��д��</entry>
+
+ <entry>�µ� <makevar>USE_AUTOTOOLS</makevar> �ṹ</entry>
+ </row>
+ </thead>
+
+ <tbody>
+ <row>
+ <entry><literal>USE_LIBLTDL=YES</literal></entry>
+
+ <entry><literal>libltdl:15</literal></entry>
+ </row>
+
+ </tbody>
+ </tgroup>
+ </informaltable>
+
+ </sect2>
+
+ <sect2 id="using-autoconf">
+ <title><command>autoconf</command> ��
+ <command>autoheader</command></title>
+
+ <para>ijЩ port ��û��ֱ���ṩ configure �ű��� ����������Ϊ
+ autoconf �� <filename>configure.ac</filename> ���
+ ����������������Ҫ��
+ <command>autoconf</command> ���� configure �ű���
+ ��ʹ�� <command>autoheader</command> ��Ϊ configure
+ �ű�����ģ��ͷ�ļ���</para>
+
+ <programlisting>USE_AUTOTOOLS= autoconf:<replaceable>�汾</replaceable>[:env]</programlisting>
+
+ <para>�Լ�</para>
+
+ <programlisting>USE_AUTOTOOLS= autoheader:<replaceable>�汾</replaceable></programlisting>
+
+ <para>�������ûᰵ��ʹ��
+ <literal>autoconf:<replaceable>�汾</replaceable></literal>��</para>
+
+ <para>���� <command>libtool</command>�� ������ǰ�����ơ�
+ ���ָ����ѡ�� <literal>:env</literal> ��������
+ ���ʾֻ�������ں��������Ļ����� �����ָ����
+ ���� port ������Ӧ���޲����������á�</para>
+
+ <informaltable frame="none">
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>��ǰ��д��</entry>
+
+ <entry>�µ� <makevar>USE_AUTOTOOLS</makevar> �ṹ</entry>
+ </row>
+ </thead>
+
+ <tbody>
+ <row>
+ <entry><literal>USE_AUTOCONF_VER=213</literal></entry>
+
+ <entry><literal>autoconf:213</literal></entry>
+ </row>
+
+ <row>
+ <entry><literal>WANT_AUTOCONF_VER=259</literal></entry>
+
+ <entry><literal>autoconf:259:env</literal></entry>
+ </row>
+
+ <row>
+ <entry><literal>USE_AUTOHEADER_VER=253</literal></entry>
+
+ <entry><literal>autoheader:253</literal> (implies
+ <literal>autoconf:253</literal>)</entry>
+ </row>
+
+ </tbody>
+ </tgroup>
+ </informaltable>
+
+ <para>�����Ŀ�ѡ������ ��
+ <makevar>AUTOCONF_ARGS</makevar> ��
+ <makevar>AUTOHEADER_ARGS</makevar> ����ͨ�� port ��
+ <filename>Makefile</filename> ����ʽ��ָ���滻��
+ ���� <command>libtool</command>�� ���� port ������Ҫ��������</para>
+
+ </sect2>
+
+ <sect2 id="using-automake">
+ <title><command>automake</command> ��
+ <command>aclocal</command></title>
+
+ <para>ijЩ������ֻ�ṩ�� <filename>Makefile.am</filename>
+ �ļ��� ��Щ�ļ�����������
+ <command>automake</command> ת��Ϊ
+ <filename>Makefile.in</filename> ��ʹ��
+ <command>configure</command> ������ʵ�ʵ�
+ <filename>Makefile</filename>��</para>
+
+ <para>���Ƶأ� ż������һЩ���������ṩ���������
+ <filename>aclocal.m4</filename> ���
+ ��Щ�ļ�����ͨ��ʹ�� <command>aclocal</command>
+ ��ɨ�� <filename>configure.ac</filename> ��
+ <filename>configure.in</filename> �Զ����ɡ�</para>
+
+ <para><command>aclocal</command> ��
+ <command>automake</command> �к� <command>autoheader</command>
+ �� <command>autoconf</command> ��ǰ��һ���������ܵ������ƵĹ�ϵ��
+ <command>aclocal</command> �ᰵ��ʹ��
+ <command>automake</command>�� ��ˣ�</para>
+
+ <programlisting>USE_AUTOTOOLS= automake:<replaceable>�汾</replaceable>[:<replaceable>env</replaceable>]</programlisting>
+
+ <para>��</para>
+
+ <programlisting>USE_AUTOTOOLS= aclocal:<replaceable>�汾</replaceable></programlisting>
+
+ <para>Ҳ�Զ�����ʹ��
+ <literal>automake:<replaceable>�汾</replaceable></literal>��</para>
+
+ <para>�� <command>libtool</command> ���ƣ�
+ <command>autoconf</command> ���ʹ���˿�ѡ��
+ <literal>:env</literal> ��������ʾ�����������ں���ʹ�õĻ�����
+ ��������ã� ���� port �����������á�</para>
+
+ <informaltable frame="none">
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>��ǰ��д��</entry>
+
+ <entry><makevar>USE_AUTOTOOLS</makevar> construct</entry>
+ </row>
+ </thead>
+
+ <tbody>
+ <row>
+ <entry><literal>USE_AUTOMAKE_VER=14</literal></entry>
+
+ <entry><literal>automake:14</literal></entry>
+ </row>
+
+ <row>
+ <entry><literal>WANT_AUTOMAKE_VER=15</literal></entry>
+
+ <entry><literal>automake:15:env</literal></entry>
+ </row>
+
+ <row>
+ <entry><literal>USE_ACLOCAL_VER=19</literal></entry>
+
+ <entry><literal>aclocal:19</literal> (implies
+ <literal>automake:19</literal>)</entry>
+ </row>
+
+ </tbody>
+ </tgroup>
+ </informaltable>
+
+ <para>As with
+ <command>autoconf</command> �� <command>autoheader</command>��
+ <command>automake</command> �� <command>aclocal</command>
+ �ṩ�˶�Ӧ�Ŀ�ѡ�������� <makevar>AUTOMAKE_ARGS</makevar> ��
+ <makevar>ACLOCAL_ARGS</makevar>�� �����Ҫ�Ļ���
+ ������ port �� <filename>Makefile</filename> ��ָ����</para>
+
+ </sect2>
+ </sect1>
+
<sect1 id="using-perl">
<title>ʹ�� <literal>perl</literal></title>
<table frame="none">
- <title>ʹ�� <literal>perl</literal> �� ports ����ʹ�õı���</title>
+ <title>�����õ� <literal>perl</literal> �� port �ı���</title>
<tgroup cols="2">
<thead>
@@ -3875,11 +4352,22 @@ LDCONFIG_DIRS= %%PREFIX%%/lib/foo %%PREFIX%%/lib/bar</programlisting>
</tbody>
</tgroup>
</table>
+
+ <note>
+ <para>Perl ģ��ͨ����û�йٷ���վ�� ��Щ port
+ Ӧ�� <hostid>cpan.org</hostid> ��Ϊ��
+ <filename>pkg-descr</filename> WWW �е����ݡ� �Ƽ��� URL ��ʽΪ
+ <literal>http://search.cpan.org/dist/Module-Name</literal>��</para>
+ </note>
+
</sect1>
<sect1 id="using-x11">
<title>ʹ�� X11</title>
+ <sect2 id="x11-variables">
+ <title>Variable definitions</title>
+
<table frame="none">
<title>�õ� X �� port ����ʹ�õı���</title>
@@ -3931,7 +4419,7 @@ LDCONFIG_DIRS= %%PREFIX%%/lib/foo %%PREFIX%%/lib/bar</programlisting>
<row>
<entry><makevar>X_IMAKE_PORT</makevar></entry>
- <entry>�����ṩ <command>imake</command> �Լ������������ڹ���
+ <entry>�����ṩ <command>imake</command> �Լ������������ڹ���
X11 �Ĺ��ߵ� port��</entry>
</row>
@@ -4036,197 +4524,75 @@ RUN_DEPENDS= ${X11BASE}/bin/xfs:${X_FONTSERVER_PORT} \
USE_XLIB= yes</programlisting>
</example>
- </sect1>
-
- <sect1 id="using-automake">
- <title>ʹ�� <command>automake</command>�� <command>autoconf</command>��
- �Լ� <command>libtool</command></title>
-
- <table frame="none">
- <title>�õ� automake, autoconf �� libtool �� port ����ʹ�õı���</title>
-
- <tgroup cols="2">
- <thead>
- <row>
- <entry>����</entry>
-
- <entry>����</entry>
- </row>
- </thead>
-
- <tbody>
- <row>
- <entry><makevar>AUTOMAKE</makevar></entry>
-
- <entry>���û���� <envar>PATH</envar> �еĻ���
- <command>automake</command> ������·����</entry>
- </row>
-
- <row>
- <entry><makevar>USE_AUTOMAKE_VER</makevar></entry>
-
- <entry>��ʾ�� port ʹ�� <command>automake</command>��
- �����ܵ�ȡֵ���� <literal>14</literal> ��
- <literal>15</literal>�� ���һ��Զ�������
- <makevar>AUTOMAKE_DIR</makevar> ��
- <makevar>ACLOCAL_DIR</makevar> ����������Ϊ�ʵ���ֵ��</entry>
- </row>
-
- <row>
- <entry><makevar>AUTOMAKE_ARGS</makevar></entry>
-
- <entry>������ <makevar>USE_AUTOMAKE_VER</makevar> ʱ�� ϣ�����ݸ�
- <makevar>AUTOMAKE</makevar> �IJ�����</entry>
- </row>
-
- <row>
- <entry><makevar>AUTOMAKE_ENV</makevar></entry>
-
- <entry>ִ�� <makevar>AUTOMAKE</makevar> ֮ǰӦ���õĻ�������
- (�Լ���Щ������ֵ)��</entry>
- </row>
-
- <row>
- <entry><makevar>ACLOCAL</makevar></entry>
-
- <entry>GNU <command>aclocal</command> ������·����
- ��������� <envar>PATH</envar> �еĻ��� Ĭ��ֵ��
- <makevar>USE_AUTOMAKE_VER</makevar> ���������þ����ġ�</entry>
- </row>
-
- <row>
- <entry><makevar>ACLOCAL_DIR</makevar></entry>
-
- <entry>GNU <command>aclocal</command> ����Ŀ¼������·���� Ĭ��ֵ����
- <makevar>USE_AUTOMAKE_VER</makevar> ���������þ����ġ�</entry>
- </row>
-
- <row>
- <entry><makevar>AUTOMAKE_DIR</makevar></entry>
-
- <entry>GNU <command>automake</command> ����Ŀ¼������·���� Ĭ��ֵ����
- <makevar>USE_AUTOMAKE_VER</makevar> ���������þ����ġ�</entry>
- </row>
-
- <row>
- <entry><makevar>USE_AUTOCONF_VER</makevar></entry>
-
- <entry>ָ�� port ���� <command>autoconf</command> �İ汾��
- �����Զ����� <literal>GNU_CONFIGURE</literal>��
- �˱���Ĭ��ֵΪ 213��</entry>
- </row>
-
- <row>
- <entry><makevar>AUTOCONF</makevar></entry>
-
- <entry>GNU <command>autoconf</command> ������·����
- ��������� <envar>PATH</envar> �еĻ��� Ĭ��ֵ��
- <makevar>USE_AUTOCONF_VER</makevar> �����������йء�</entry>
- </row>
-
- <row>
- <entry><makevar>AUTOCONF_ARGS</makevar></entry>
-
- <entry>���ݸ� <command>autoconf</command> �������в�����</entry>
- </row>
-
- <row>
- <entry><makevar>AUTOCONF_ENV</makevar></entry>
-
- <entry>������ <command>autoconf</command> ֮ǰ�� ��������������
- <literal><replaceable>������</replaceable>=<replaceable>ֵ</replaceable></literal>
- ����������</entry>
- </row>
-
- <row>
- <entry><makevar>USE_AUTOHEADER_VER</makevar></entry>
-
- <entry>ָ�� port ���õ� <command>autoheader</command> �汾��
- �����Զ����� <literal>USE_AUTOCONF_VER</literal>��
- �˱���Ĭ��ֵΪ 213��</entry>
- </row>
-
- <row>
- <entry><makevar>AUTOHEADER</makevar></entry>
- <entry>GNU <command>autoheader</command> ������·����
- ��������� <envar>PATH</envar> �еĻ��� Ĭ��ֵ��
- <makevar>USE_AUTOCONF_VER</makevar> �������йء�</entry>
- </row>
-
- <row>
- <entry><makevar>AUTORECONF</makevar></entry>
+ </sect2>
- <entry>GNU <command>autoreconf</command> ������·����
- ��������� <envar>PATH</envar> �еĻ��� Ĭ��ֵ��
- <makevar>USE_AUTOCONF_VER</makevar> �������йء�</entry>
- </row>
+ <sect2 id="x11-motif">
+ <title>��Ҫʹ�� Motif �� port</title>
- <row>
- <entry><makevar>AUTOSCAN</makevar></entry>
+ <para>������� port ��Ҫ Motif �⣬ ��Ӧ��
+ <filename>Makefile</filename> ��� <makevar>USE_MOTIF</makevar>��
+ Ĭ�ϵ� Motif ʵ����
+ <filename role="package">x11-toolkits/open-motif</filename>��
+ �û�����ͨ������ <makevar>WANT_LESSTIF</makevar> ������ѡ��
+ <filename role="package">x11-toolkits/lesstif</filename> ��������</para>
- <entry>GNU <command>autoscan</command> ������·����
- ��������� <envar>PATH</envar> �еĻ��� Ĭ��ֵ��
- <makevar>USE_AUTOCONF_VER</makevar> �������йء�</entry>
- </row>
+ <para><filename>bsd.port.mk</filename> �Ὣ <makevar>MOTIFLIB</makevar>
+ ��������Ϊ�����ʵ� Motif ������á� ��ʹ�ò������� port ��
+ <filename>Makefile</filename> ��
+ <filename>Imakefile</filename> �ᵽ Motif
+ ��ĵط���Ϊ <literal>&dollar;{MOTIFLIB}</literal>��</para>
- <row>
- <entry><makevar>AUTOIFNAMES</makevar></entry>
+ <para>�����ֱȽϳ����������</para>
- <entry>GNU <command>autoifnames</command> ������·����
- ��������� <envar>PATH</envar> �еĻ��� Ĭ��ֵ��
- <makevar>USE_AUTOCONF_VER</makevar> �������йء�</entry>
- </row>
+ <itemizedlist>
+ <listitem>
+ <para>��� port �н� Motif ���� <filename>Makefile</filename> ��
+ <filename>Imakefile</filename> ����Ϊ
+ <literal>-lXm</literal>�� ��򵥵ؽ����滻Ϊ
+ <literal>&dollar;{MOTIFLIB}</literal>��</para>
+ </listitem>
- <row>
- <entry><makevar>USE_LIBTOOL_VER</makevar></entry>
+ <listitem>
+ <para>��� port ���� <filename>Imakefile</filename>
+ ��ʹ�� <literal>XmClientLibs</literal>�� �����Ϊ
+ <literal>&dollar;{MOTIFLIB} &dollar;{XTOOLLIB}
+ &dollar;{XLIB}</literal>.</para>
+ </listitem>
- <entry>��һ port ʹ�õ� <command>libtool</command> �汾�� �����Զ�����
- <makevar>GNU_CONFIGURE</makevar>�� Ĭ��ֵ�� 13��</entry>
- </row>
+ </itemizedlist>
- <row>
- <entry><makevar>LIBTOOL</makevar></entry>
+ <para>ע�� <makevar>MOTIFLIB</makevar> (ͨ��) ��չ��Ϊ
+ <literal>-L/usr/X11R6/lib -lXm</literal> ��
+ <literal>/usr/X11R6/lib/libXm.a</literal>�� ���Բ���Ҫ����ǰ����
+ <literal>-L</literal> �� <literal>-l</literal>��</para>
- <entry><command>libtool</command> ������·����
- ��������� <envar>PATH</envar> �еĻ���</entry>
- </row>
+ </sect2>
- <row>
- <entry><makevar>LIBTOOLFILES</makevar></entry>
+ <sect2>
+ <title>X11 ����</title>
- <entry>���ڶ� <command>libtool</command> ���Զ��޸ĵ��ļ���
- ��������� <makevar>USE_AUTOCONF</makevar>��
- ���� <literal>aclocal.m4</literal>�� ����Ӧ����
- <literal>configure</literal>��</entry>
- </row>
+ <para>��� port ��Ϊ X Window ϵͳ��װ���壬 ����Щ����ŵ�
+ <filename><makevar>X11BASE</makevar>/lib/X11/fonts/local</filename>��<para>
- <row>
- <entry><makevar>LIBTOOLFLAGS</makevar></entry>
+ </sect2>
- <entry>��Ҫ���ݸ�
- <command>ltconfig</command> �Ķ����־������ Ĭ����
- <literal>--disable-ltlibs</literal>��</entry>
- </row>
- </tbody>
- </tgroup>
- </table>
</sect1>
<sect1 id="using-gnome">
<title>ʹ�� GNOME</title>
- <para>The FreeBSD/GNOME project ʹ��һ���Լ��ı��������� port
+ <para>FreeBSD/GNOME ��Ŀ��ʹ��һ���Լ��ı��������� port
��ʹ�õ� GNOME �����
- <ulink url="http://www.FreeBSD.org/gnome/docs/porting.html">��Щ��������ϸ�б�
- </ulink> ������ FreeBSD/GNOME ��Ŀ����ҳ�ҵ���</para>
+ <ulink url="http://www.FreeBSD.org/gnome/docs/porting.html">��Щ��������ϸ�б�</ulink>
+ ������ FreeBSD/GNOME ��Ŀ����ҳ�ҵ���</para>
<note>
<para>���ֻ�ǰ�װ
<application>pkg-config</application> Ԫ�����ļ���
<filename><makevar>PREFIX</makevar>/libdata/pkgconfig</filename>
- �Ļ��� ���� port �Ͳ���Ҫ���� GNOME�� ͬ���� port ���ƣ�
- ���� port Ӧ����������׼���� ��ɾ����Щ�յ�Ŀ¼�� �ٶ����� port ��װ
+ �Ļ��� ���� port �Ͳ���Ҫ���� GNOME�� ͬ���� port ���ƣ�
+ ���� port Ӧ����������׼���� ��ɾ����Щ��Ŀ¼�� �ٶ����� port ��װ
<filename>gtkmumble.pc</filename> ������λ�ã�
��Ӧ�� <filename>pkg-plist</filename> �м��룺</para>
@@ -4244,18 +4610,18 @@ USE_XLIB= yes</programlisting>
<title>ʹ�� KDE</title>
<table frame="none">
- <title>����ʹ�� KDE �� port �ı���</title>
+ <title>�����õ� KDE �� port �ı���</title>
<tgroup cols="2">
<tbody>
<row>
<entry><makevar>USE_QT_VER</makevar></entry>
- <entry>��ʾ���� port ���õ��� Qt�� ��ѡ��ֵ��
+ <entry>��ʾ���� port ʹ���� Qt�� ��ѡ��ֵ��
<literal>1</literal> ��
<literal>3</literal>�� ���DZ�ʾ���õ� Qt �����汾�š�
����������Զ��� <makevar>MOC</makevar> ��
- <makevar>QTCPPFLAGS</makevar> ����Ϊ�ʵ���ֵ��</entry>
+ <makevar>QTCPPFLAGS</makevar> Ĭ������Ϊ�ʵ���ֵ��</entry>
</row>
<row>
@@ -4325,7 +4691,7 @@ USE_XLIB= yes</programlisting>
<tbody>
<row>
<entry><makevar>USE_JAVA</makevar></entry>
- <entry>ֻ�ж���������ʹ����������Ч��</entry>
+ <entry>ֻ�ж���������ʹ����������Ч��</entry>
</row>
<row>
<entry><makevar>JAVA_VERSION</makevar></entry>
@@ -4540,17 +4906,17 @@ USE_XLIB= yes</programlisting>
</row>
<row>
<entry><makevar>JAVALIBDIR</makevar></entry>
- <entry>���� port ��װ�� JAR �ļ����ڵ�Ŀ¼�� Ĭ��ֵ��
+ <entry>���� port ��װ�� JAR �ļ����ڵ�Ŀ¼�� Ĭ��ֵ��
<filename>${LOCALBASE}/share/java/classes</filename>��</entry>
</row>
</tbody>
</tgroup>
</table>
- <para>��ص���Ҳ��
+ <para>��ص���Ҳ�ᶨ����
<makevar>PLIST_SUB</makevar> (��
- <xref linkend="porting-plist"> ����) ��
- <makevar>SUB_LIST</makevar> �ṩ�˶�Ӧ�Ķ��塣</para>
+ <xref linkend="plist-sub"> ����) ��
+ <makevar>SUB_LIST</makevar> �С�</para>
</sect2>
@@ -4559,15 +4925,15 @@ USE_XLIB= yes</programlisting>
<para>��� port ���� Apache Ant �������
����Ҫ���� <makevar>USE_ANT</makevar>�� ���ǣ� �� Ant
- ����Ϊ ��-make ������ʹ�á� ��� port δ�趨��
- <literal>do-build</literal> target�� ��Ĭ�Ͻ��� <makevar>MAKE_ENV</makevar>��
- <makevar>MAKE_ARGS</makevar> �� <makevar>ALL_TARGETS</makevar>
- ������ִ�� Ant�� �������� <makevar>USE_GMAKE</makevar> �Ļ��ƣ�
- ������ <xref linkend="makefile-build"> �������ܡ�</para>
+ ����Ϊ ��-make ������ʹ�á� ��� port δ���� <literal>do-build</literal>
+ target�� ��Ĭ���� <makevar>MAKE_ENV</makevar>��
+ <makevar>MAKE_ARGS</makevar> �� <makevar>ALL_TARGETS</makevar>.
+ ������ִ�� Ant�� �������� <xref linkend="building"> �н��ܵĹ���
+ <makevar>USE_GMAKE</makevar> �Ļ��ơ�</para>
<para>�� <command>jikes</command> ����Ϊ
- <command>javac</command> ʹ�� (�μ� <xref linkend="java-variables">
- �е� <makevar>USE_JIKES</makevar>)�� �� Ant ���Զ������������� port��</para>
+ <command>javac</command> ʹ�� (�μ� <xref linkend="java-variables"> �е�
+ <makevar>USE_JIKES</makevar>)�� �� Ant ���Զ��������� port �Ĺ������̡�</para>
</sect2>
@@ -4575,7 +4941,7 @@ USE_XLIB= yes</programlisting>
<title>���ʵ��</title>
<para>���������ֲij�� Java �⣬ ���� port Ӧ��
- JAR �ļ���װ�� <filename>${JAVAJARDIR}</filename>�� �������ļ���Ӧ����
+ JAR �ļ���װ�� <filename>${JAVAJARDIR}</filename>�� �������ļ���Ӧ����
<filename>${JAVASHAREDIR}/${PORTNAME}</filename> ��
(�����ĵ��� �μ�����)�� Ҫ���ٴ���ļ��ijߴ磬
������ֱ���� <filename>Makefile</filename> ��������Щ JAR �ļ���
@@ -4587,12 +4953,12 @@ USE_XLIB= yes</programlisting>
<para>��ֲ Java Ӧ�ó���ʱ�� port ͨ����ϣ���������ļ���װ��ͬһĿ¼
(������������ JAR)�� ��ʱǿ�ҽ���ʹ��
<filename>${JAVASHAREDIR}/${PORTNAME}</filename>��
- ��ֲ�����Ŀ�����Ա�� �������о����Ƿ������������� JAR ��װ����Ŀ¼��
+ ��ֲ�����Ŀ�����Ա�� �������о����Ƿ������������� JAR ��װ����Ŀ¼��
��ֱ��ʹ���Ѿ�װ�õ���Щ
(���� <filename>${JAVAJARDIR}</filename>)��</para>
<para>��������������һ��� port (�����Ӧ�ó���)��
- ���ӵ��ĵ���Ӧ��װ�������� port
+ ���ӵ��ĵ���Ӧ��װ�������� port
<link linkend="dads-documentation">ͬ����λ��</link>��
�Ѿ�֪���� JavaDoc ����� JDK �汾�IJ�ͬ��������ͬ���ļ���
������Щ������ǿ��ʹ��ijһ�ض��汾 JDK �� port ���ԣ�
@@ -4609,7 +4975,7 @@ USE_XLIB= yes</programlisting>
<filename>${JAVASHAREDIR}/${PORTNAME}</filename> ��һ�������⡣
��Ȼ�� <makevar>DATADIR</makevar> ���Զ��ӵ�
<makevar>PLIST_SUB</makevar> �� (�� <xref
- linkend="porting-plist"> ��������) �����������
+ linkend="plist-sub"> ��������) �����������
<filename>pkg-plist</filename> ��ֱ��ʹ��
<literal>%%DATADIR%%</literal>��</para>
@@ -4623,7 +4989,7 @@ USE_XLIB= yes</programlisting>
�����Ȳ��� <ulink
url="http://www.freebsd.org/cgi/cvsweb.cgi/ports/Mk/bsd.java.mk">
bsd.java.mk CVS ��־</ulink>�� ��Ϊͨ��׫�Ľ�������������ҪһЩʱ�䡣
- ���⣬ �������Ϊ��ȱ�ٵ�֧�ֶ��������� Java port �������棬
+ ���⣬ �������Ϊ��ȱ�ٵ�֧�ֶ��������� Java port �������棬
���� &a.java; ����������ۡ�</para>
<para>�� PR �е� <literal>java</literal> ���
@@ -4843,10 +5209,10 @@ _DOCSDIR= .
<entry>ʹ�� Python distutils ��������á� ����Ͱ�װ�� �԰���
<filename>setup.py</filename> �� port �������DZ���ġ�
�����Զ�����Ĭ�ϵ�
- <maketarget>do-build</maketarget> ��
- <maketarget>do-install</maketarget> ���� target��
- ���û�ж��� <makevar>GNU_CONFIGURE</makevar>��
- Ҳ�Ḳ�� <maketarget>do-configure</maketarget> ��Ϊ��</entry>
+ <maketarget>do-build</maketarget> �Լ�
+ <maketarget>do-install</maketarget> ������ target�� �����
+ <makevar>GNU_CONFIGURE</makevar>��
+ ������ı� <maketarget>do-configure</maketarget>��</entry>
</row>
<row>
@@ -4861,23 +5227,23 @@ _DOCSDIR= .
<entry>ȫվ package ���ڵ�Ŀ¼�� �������� Python
�İ�װĿ¼ (ͨ���� <makevar>LOCALBASE</makevar>)��
- �� <makevar>PYTHON_SITELIBDIR</makevar> ������
- ���ڰ�װ Python ģ����dz����á�</entry>
+ �ڰ�װ Python ģ��ʱ�� <makevar>PYTHON_SITELIBDIR</makevar>
+ ������dz����á�</entry>
</row>
-
+
<row>
<entry><makevar>PYTHONPREFIX_SITELIBDIR</makevar></entry>
-
- <entry>ȥ���� PREFIX ���ֵ� PYTHON_SITELIBDIR�� Ӧ������
+
+ <entry>ȥ���� PREFIX ���ֵ� PYTHON_SITELIBDIR�� Ӧ��������
<filename>pkg-plist</filename> ��ʹ��
- <literal>%%PYTHON_SITELIBDIR%%</literal> ������
- <literal>%%PYTHON_SITELIBDIR%%</literal> Ĭ��Ϊ
+ <literal>%%PYTHON_SITELIBDIR%%</literal>��
+ <literal>%%PYTHON_SITELIBDIR%%</literal> ��Ĭ��ֵ��
<literal>lib/python%%PYTHON_VERSION%%/site-packages</literal></entry>
</row>
<row>
<entry><makevar>PYTHON_CMD</makevar></entry>
-
+
<entry>Python �������������У� �����汾�š�</entry>
</row>
@@ -5147,238 +5513,295 @@ USE_SDL+= mixer
.include &lt;bsd.port.post.mk&gt;</programlisting>
</sect1>
- </chapter>
- <chapter id="porting-masterdir">
- <title><makevar>MASTERDIR</makevar> (�� port ���ڵ�Ŀ¼)</title>
+ <sect1 id="rc-scripts">
+ <title>������ֹͣ���� (rc �ű�)</title>
- <para>������� port ��Ҫͨ��ijЩ���� (���磬 �ֱ��ʣ� ��ֽ��)
- ȡ��ͬ��ֵ��������������
- ��Ϊ������һ���µ�Ŀ¼��ʹ�û�������֪�������Լ�����ʲô��
- ��ʱӦ�ڲ�ͬ�� port ֮�乲�������ܶ���ļ��� һ������£� ��ֻ��Ҫһ���̵ܶ�
- <filename>Makefile</filename>�� ����Ա��������õõ��Ļ���
- ���� <filename>Makefile</filename> �п���ʹ�� <makevar>MASTERDIR</makevar>
- ��ָ�������ļ����ڵ�Ŀ¼�� ���⣬ ����Ӧָ��һ��
- <link linkend="porting-pkgname"><makevar>PKGNAMESUFFIX</makevar></link>
- �Ա��� package ����������������</para>
+ <para>ϵͳ����ʱ�� �����ű��ᱻ������������ ���⣬
+ ����Ϊ����Ա�ṩ��һ�ֱ�׼�ķ�ʽ��ֹͣ�� ��������������
+ ��ϵͳ�� <filename>rc.d</filename> ����м����˶��� ports ��֧�֡�
+ �������ʹ�����ľ�����ܣ� ������
+ <ulink url="&url.books.handbook;/configtuning-rcng.html">ʹ���ֲ��еĶ�Ӧ�½�</ulink>
+ �ҵ��� �����������ϸ���ܣ� �������
+ &man.rc.subr.8; �ҵ���</para>
- <para>��Щʹ�����������Բ������Ϊ������ ������
- <filename>japanese/xdvi300/Makefile</filename> �IJ��ִ��룺</para>
+ <para>���԰�װһ���� rc �ű���</para>
- <programlisting>PORTNAME= xdvi
-PORTVERSION= 17
-PKGNAMEPREFIX= ja-
-PKGNAMESUFFIX= ${RESOLUTION}
- :
-# default
-RESOLUTION?= 300
-.if ${RESOLUTION} != 118 && ${RESOLUTION} != 240 && \
- ${RESOLUTION} != 300 && ${RESOLUTION} != 400
- @${ECHO} "Error: invalid value for RESOLUTION: \"${RESOLUTION}\""
- @${ECHO} "Possible values are: 118, 240, 300 (default) and 400."
- @${FALSE}
-.endif</programlisting>
+ <programlisting>USE_RC_SUBR= doorman.sh</programlisting>
- <para><filename role="package">japanese/xdvi300</filename> Ҳ�ṩ��ȫ������IJ�����
- �Լ�����õ����ļ��ȵ����ݡ� ��������������� <command>make</command>��
- ����ʹ��Ĭ�ϵķֱ���ֵ (300) ������ port��</para>
+ <para>��Щ�ű�����ŵ� <filename>files</filename>
+ Ŀ¼�� ������ <literal>.in</literal> ��׺�� �����ϵͳ�е� rc
+ �ű�Ψһ���������ڣ� ���ֽű��е�
+ <literal>.&nbsp;/etc/rc.subr</literal> ��Ӧ�滻Ϊ
+ <literal>.&nbsp;%%RC_SUBR%%</literal>�� ��Ϊ����汾�� &os;
+ ��û�� <filename>/etc/rc.subr</filename> �ļ��� ���⻹����ʹ�ñ�׼��
+ <makevar>SUB_LIST</makevar> չ���� �ر��Ƽ�ʹ��
+ <literal>%%PREFIX%%</literal>�� ����
+ <makevar>SUB_LIST</makevar> �Ľ�һ�����ܿ��Բο� <link
+ linkend="using-sub-files">����½�</link>��</para>
- <para>�������ֱ��ʵİ汾���ƣ� ������ <emphasis>������</emphasis>
- <filename>xdvi118/Makefile</filename>��</para>
+ <para>�� &man.rcorder.8; �ļ�����ͨ��
+ <makevar>USE_RCORDER</makevar> ������
+ <makevar>USE_RC_SUBR</makevar> ����ɵġ�</para>
- <programlisting>RESOLUTION= 118
-MASTERDIR= ${.CURDIR}/../xdvi300
+ <para>������һ���򵥵� rc �ű���</para>
-.include "${MASTERDIR}/Makefile"</programlisting>
+ <programlisting>#!/bin/sh
- <para>(<filename>xdvi240/Makefile</filename> ��
- <filename>xdvi400/Makefile</filename> �����Ƶ�)��
- <makevar>MASTERDIR</makevar> ��������
- <filename>bsd.port.mk</filename> �����Ŀ¼��
- ���� <makevar>FILESDIR</makevar> ��
- <makevar>SCRIPTDIR</makevar> Ӧ����
- <filename>xdvi300</filename> �в��ҡ�
- <literal>RESOLUTION=118</literal> ���������
- <filename>xdvi300/Makefile</filename> �����е�
- <literal>RESOLUTION=300</literal> ���ã� �Ӷ��Էֱ��� 118
- ���� port��</para>
- </chapter>
+# PROVIDE: doorman
+# REQUIRE: LOGIN
+# KEYWORD: FreeBSD
- <chapter id="shared">
- <title>������İ汾</title>
+#
+# �� /etc/rc.conf �������������ÿ������� doorman��
+# doorman_enable (bool): Ĭ����Ϊ "NO"��
+# ��Ϊ "YES" ��ʾ���� doorman��
+# doorman_config (path): Ĭ����Ϊ "%%PREFIX%%/etc/doormand/doormand.cf"��
+#
- <para>���Ķ����ǵ� <ulink url="&url.books.developers-handbook;/policies-shlib.html">���ڹ�����汾�����Ĺ涨</ulink>
- ���˽���Ϊ������ָ���汾ʱ��һ�����
- ��ҪäĿ�ؼٶ�����������֪����������ʲô�� �����˲��������
- ��ϸ�ؿ�����Щϸ�ڷdz���Ҫ�� ��Ϊ������Ҫ������໥���ͻ��������������Ρ�
- ���ĵ����� port �����ڹ�ȥ���¹��dz����ص����� (���Ƿ��������
- Ϊʲô <filename>jpeg-6b</filename> �Ĺ�����汾�� 9?)�� ��������ǣ�
- ������ &a.ports; ѯ�ʡ� �������ʱ��
- ���Ĺ�������ѡ����һ���ʵ��Ĺ�����汾��
- ��ǡ���ض����������޸Ķ�����ʵ�֡�</para>
+. %%RC_SUBR%%
-<!--
- <para>However, if there is a port which is a different version of the
- same software already in the tree, the situation is much more complex.
- In short, the FreeBSD implementation does not allow the user to
- specify to the linker which version of shared library to link against
- (the linker will always pick the highest numbered version). This
- means, if there is a <filename>libfoo.so.3.2</filename> and
- <filename>libfoo.so.4.0</filename> in the system, there is no way to
- tell the linker to link a particular application to
- <filename>libfoo.so.3.2</filename>. It is essentially completely
- overshadowed in terms of compilation-time linkage. In this case, the
- only solution is to rename the <emphasis>base</emphasis> part of the
- shared library. For instance, change
- <filename>libfoo.so.4.0</filename> to
- <filename>libfoo4.so.1.0</filename> so both version 3.2 and 4.0 can be
- linked from other ports.</para>
--->
- </chapter>
+name="doorman"
+rcvar=`set_rcvar`
- <chapter id="porting-manpages">
- <title>�����ֲ�</title>
+load_rc_config $name
- <para>���ʹ���� <makevar>MAN[1-9LN]</makevar> ������
- �ͻ��Զ��ؽ������ֲ���뵽 <filename>pkg-plist</filename> ��
- (����ζ���� <emphasis>����</emphasis> Ӧ�ð������ֲ�����
- <filename>pkg-plist</filename>&mdash;�μ� <link
- linkend="porting-plist">���� PLIST</link> �˽����ϸ��)��
- ���⣬ ��Ҳ���ð�װ�׶��Զ��ظ����� <filename>/etc/make.conf</filename>
- �е� <makevar>NOMANCOMPRESS</makevar> ������ѹ�����ѹ�������ֲ��ļ���</para>
-
- <para>������� port ���Խ������ֲ�ʹ��Ӳ���Ӱ�װ�ɶ�����֣�
- �����ͨ�� <makevar>MLINKS</makevar> ����������˵����
- ������ port ��װ�����ӻᱻ <filename>bsd.port.mk</filename>
- �ٵ����ؽ��� �Ա�֤����ָ������ȷ���ļ��� ������ MLINKS �и����������ֲᣬ
- ����Ӧ���� <filename>pkg-plist</filename> ���г���</para>
-
- <para>Ҫָ�������ֲ��Ƿ��ڰ�װʱ����ѹ����
- ����ʹ�� <makevar>MANCOMPRESSED</makevar> ������
- �����������ʹ������ֵ�� <literal>yes</literal>�� <literal>no</literal> ��
- <literal>maybe</literal>�� <literal>yes</literal>
- ��ʾ�����ֲ��Ѿ���ѹ������ʽ��װ�� <literal>no</literal> ��ʾ��û�У�
- �� <literal>maybe</literal> ���ʾ����װ������������
- <makevar>NOMANCOMPRESS</makevar> ������ֵ�� ����֮
- <filename>bsd.port.mk</filename> ����Ҫ��ʲô�ر�����顣</para>
+: ${doorman_enable="NO"}
+: ${doorman_config="%%PREFIX%%/etc/doormand/doormand.cf"}
- <para>��������� <makevar>USE_IMAKE</makevar> �����
- <makevar>NO_INSTALL_MANPAGES</makevar>��
- <makevar>MANCOMPRESSED</makevar> ���Զ�����Ϊ
- <literal>yes</literal>�� ��֮���� <literal>no</literal>��
- ����Ĭ��ֵ�����ʣ� ����Ͳ���Ҫ������ port ���޸�֮��</para>
+command=%%PREFIX%%/sbin/doormand
+pidfile=/var/run/doormand.pid
+command_args="-p $pidfile -f $doorman_config"
- <para>������� port ���ֲ�ҳ��Ŀ¼�ŵ���
- <makevar>PREFIX</makevar> ����ĵط��� �����ʹ��
- <makevar>MANPREFIX</makevar> ���������� ���⣬
- ���ֻ��ijЩ���ֵ������ֲ�ᰲװ������׼��λ�ã� ����ijЩ <literal>perl</literal>
- �� port�� ����������
- <makevar>MAN<replaceable>sect</replaceable>PREFIX</makevar> (����
- <replaceable>sect</replaceable> �� <literal>1-9</literal>��
- <literal>L</literal> �� <literal>N</literal> ֮һ)��</para>
+run_rc_command "$1"</programlisting>
- <para>������������ֲ���Ҫװ��ר����ijһ����ר�õ���Ŀ¼��
- ��Ҫ�� <makevar>MANLANG</makevar> ����Ϊ��һ���ԡ�
- ���������Ĭ��ֵ�� <literal>""</literal> (Ҳ����ֻ��Ӣ��)��</para>
+ </sect1>
+ </chapter>
- <para>������һ���ۺϵ����ӡ�</para>
+ <chapter id="plist">
+ <title>�߼� <filename>pkg-plist</filename> �÷�</title>
- <programlisting>MAN1= foo.1
-MAN3= bar.3
-MAN4= baz.4
-MLINKS= foo.1 alt-name.8
-MANLANG= "" ja
-MAN3PREFIX= ${PREFIX}/share/foobar
-MANCOMPRESSED= yes</programlisting>
+ <sect1 id="plist-sub">
+ <title>���� make ������ <filename>pkg-plist</filename> �����޸�</title>
- <para>���ʾ port �ᰲװ�����ļ���</para>
+ <para>ijЩ port�� �ر��� <literal>p5-</literal> port��
+ ����Ҫ��������ѡ�� (����� <literal>p5-</literal> port ���ԣ�
+ <literal>perl</literal> �İ汾) ���޸����ǵ� <filename>pkg-plist</filename>��
+ Ϊ����һ������ ��
+ <filename>pkg-plist</filename> �е� <literal>%%OSREL%%</literal>��
+ <literal>%%PERL_VER%%</literal>�� �Լ�
+ <literal>%%PERL_VERSION%%</literal> ���Զ�������Ӧ���滻��
+ ���У� <literal>%%OSREL%%</literal> ��ֵ�Dz���ϵͳ����ֵ��ʾ�İ汾 (����
+ <literal>4.9</literal>)�� <literal>%%PERL_VERSION%%</literal>
+ ���� <command>perl</command> �������汾�� (����
+ <literal>5.00502</literal>) �� <literal>%%PERL_VER%%</literal>
+ �� <command>perl</command> �İ汾ȥ�� patchlevel
+ �IJ��� (���� <literal>5.005</literal>)�� ���������� port �ĵ��ļ��йص�
+ <literal>%%<replaceable>����</replaceable>%%</literal> �� <link
+ linkend="dads-documentation">��Ӧ�½�</link> �н����˽��ܡ�</para>
+
+ <para>���������Ҫ�����������滻�� ����ͨ����
+ <makevar>PLIST_SUB</makevar> ��������Ϊһ��
+ <literal><replaceable>����</replaceable>=<replaceable>ֵ</replaceable></literal>
+ ����ʵ�֡� ���У� <literal>%%<replaceable>VAR</replaceable>%%</literal>
+ ��ʾ�� <filename>pkg-plist</filename> �н���
+ <replaceable>ֵ</replaceable> �滻����Щ���֡�</para>
+
+ <para>������˵�� ��� port ��Ҫ�Ѻܶ��ļ��ŵ��Ͱ汾�йص�Ŀ¼�У�
+ ������ <filename>Makefile</filename> �а���������������ӣ�</para>
- <programlisting>${PREFIX}/man/man1/foo.1.gz
-${PREFIX}/man/ja/man1/foo.1.gz
-${PREFIX}/share/foobar/man/man3/bar.3.gz
-${PREFIX}/share/foobar/man/ja/man3/bar.3.gz
-${PREFIX}/man/man4/baz.4.gz
-${PREFIX}/man/ja/man4/baz.4.gz</programlisting>
+ <programlisting>OCTAVE_VERSION= 2.0.13
+PLIST_SUB= OCTAVE_VERSION=${OCTAVE_VERSION}</programlisting>
- <para>���� <filename>${PREFIX}/man/man8/alt-name.8.gz</filename>
- ���ܻ�ͨ������ port ��װ�� Ҳ���ܲ��ᡣ ������Σ�
- ���ᴴ��һ���������ӣ� �� foo(1) ��
- alt-name(8) �����ֲ���������</para>
+ <para>���� <filename>pkg-plist</filename> �н�����İ汾�滻Ϊ
+ <literal>%%OCTAVE_VERSION%%</literal>�� ������ ������ port ʱ��
+ �Ͳ���Ҫ�ٵ� <filename>pkg-plist</filename> ���޸��Ǽ�ʮ (���ߣ�
+ ��ʱ�������ϰ�) �е������ˡ�</para>
- </chapter>
+ <para>��һ�滻���� (�Լ����� <link
+ linkend="makefile-manpages">�����ֲ�</link> �Ĺ���)��
+ ���� <maketarget>pre-install</maketarget> ��
+ <maketarget>do-install</maketarget> ���� target ֮�䣬 ͨ����ȡ
+ <filename><makevar>PLIST</makevar></filename> ���
+ <filename><makevar>TMPPLIST</makevar></filename>
+ (Ĭ������£� �ǣ�
+ <filename><makevar>WRKDIR</makevar>/.PLIST.mktmp</filename>) ����ɡ�
+ ��ˣ� ������� port ��̬���� <filename><makevar>PLIST</makevar></filename>��
+ ����Ҫ�� <maketarget>pre-install</maketarget> ֮ǰ��ɡ�
+ ���⣬ ������� port ��Ҫ�༭�����ɵ��ļ��� ����Ҫ��
+ <maketarget>post-install</maketarget> �в�����Ϊ
+ <filename><makevar>TMPPLIST</makevar></filename> ���Ǹ��ļ���</para>
+
+ <para>��һ�ֿ��е��޸�װ�䵥�ķ�����
+ ���Ǹ��� <makevar>PLIST_FILES</makevar> ��
+ <makevar>PLIST_DIRS</makevar> ����������������������
+ ���ǵ�ֵ����ΪĿ¼����ͬ <filename><makevar>PLIST</makevar></filename>
+ ������һ��д�� <filename><makevar>TMPPLIST</makevar></filename>��
+ �� <makevar>PLIST_FILES</makevar>
+ �� <makevar>PLIST_DIRS</makevar> ���г������֣� �ᾭ��ǰ�������ܵ�
+ <literal>%%<replaceable>����</replaceable>%%</literal>
+ �滻���̡� ����֮�⣬ �� <makevar>PLIST_FILES</makevar>
+ ���г����ļ��� �᲻���κ��޸ĵڳ��������յ�װ�䵥�У�
+ �� <literal>@dirrm</literal> ����Ϊǰ׺�ӵ� <makevar>PLIST_DIRS</makevar>
+ ���е�����֮ǰ�� Ϊ�˴ﵽĿ�ģ� <makevar>PLIST_FILES</makevar> ��
+ <makevar>PLIST_DIRS</makevar> ������д
+ <filename><makevar>TMPPLIST</makevar></filename> ֮ǰ��
+ Ҳ������ <maketarget>pre-install</maketarget> �����Ľ׶ν������á�</para>
+ </sect1>
+
+ <sect1 id="plist-cleaning">
+ <title>��Ŀ¼</title>
+
+ <sect2 id="plist-dir-cleaning">
+ <title>������Ŀ¼</title>
+
+ <para>һ��Ҫ�� port ��ж��ʱ����������Ŀ¼��
+ ͨ���� ����ͨ��Ϊ������ port ������Ŀ¼���Ӷ�Ӧ��
+ <literal>@dirrm</literal> ����ʵ�֡� ��ɾ����Ŀ¼֮ǰ��
+ ��Ҫ����ɾ��������Ŀ¼��</para>
+
+ <programlisting> :
+lib/X11/oneko/pixmaps/cat.xpm
+lib/X11/oneko/sounds/cat.au
+ :
+@dirrm lib/X11/oneko/pixmaps
+@dirrm lib/X11/oneko/sounds
+@dirrm lib/X11/oneko</programlisting>
- <chapter id="porting-motif">
- <title>��Ҫʹ�� Motif �� port</title>
+ <para>Ȼ���� ��ʱ <literal>@dirrm</literal> ���������� port
+ ʹ����ͬһ��Ŀ¼���������� �������� <literal>@unexec</literal>
+ �е��� <command>rmdir</command> �Ա�ֻɾ����Ŀ¼��
+ ���������κξ��档</para>
- <para>��������ڱ���ʱ���õ� Motif �� (�кܶ���ҵ�汾��
- ����Ҳ��һ���ܹ�֧������Ӧ�ó������е�
- <filename role="package">x11-toolkits/lesstif</filename>)��
- ��Ϊ����һ���dz����еĹ��߰��� ��������Ȩͨ������������̬���ӵĿ�ִ���ļ���
- ���ǶԴ�����Ҫ Motif �� port ����һЩ����Ĺ涨��
- �������ܹ����ɵر��붯̬���ӵĿ�ִ���ļ� (���ڴ� port
- ���������û�) ��̬������ (������Щϣ������ package ���û�)��</para>
+ <programlisting>@unexec rmdir %D/share/doc/gimp 2>/dev/null || true</programlisting>
- <sect1 id="motif-use">
- <title><makevar>USE_MOTIF</makevar> (�õ��� Motif)</title>
+ <para>���������д���� ��������ʾ�κδ�����Ϣ�� ���ң���ʹ��
+ <filename><makevar>PREFIX</makevar>/share/doc/gimp</filename>
+ �������� port �����а�װ��һЩ�ļ�������£� ��Ҳ���ᵼ��
+ &man.pkg.delete.1; �쳣�˳���</para>
+ </sect2>
+
+ <sect2 id="plist-dir-empty">
+ <title>��ν�����Ŀ¼</title>
+
+ <para>�� port ��װ�����д����Ŀ�Ŀ¼��Ҫ�ر����⡣ ��װ package
+ ʱ�������Զ�������ЩĿ¼�� ������Ϊ package ֻ�����ļ���
+ Ҫȷ����װ package ʱ���Զ�������Щ��Ŀ¼�� ��Ҫ��
+ <filename>pkg-plist</filename> �����
+ <literal>@dirrm</literal> ��Ӧ���У�</para>
+
+ <programlisting>@exec mkdir -p %D/share/foo/templates</programlisting>
+ </sect2>
- <para>������� port ��Ҫ Motif�� ��Ӧ��
- <filename>Makefile</filename> �������� ����û�а�װ Motif
- ���û��Ͳ��᳢�Ա������ˡ�</para>
</sect1>
- <sect1 id="motif-lib">
- <title><makevar>MOTIFLIB</makevar> (ָ��ʹ�õ� Motif ��汾)</title>
+ <sect1 id="plist-config">
+ <title>�����ļ�</title>
- <para>��������ᱻ <filename>bsd.port.mk</filename> ����Ϊ�� Motif
- ����ʵ������á� ������� port ���õ���Դ��������޸ģ�
- ������ֱ��ָ�� Motif ��� <filename>Makefile</filename> ��
- <filename>Imakefile</filename> ��Ϊʹ�����������</para>
+ <para>��� port ��Ҫ��һЩ�ļ��ŵ�
+ <filename><makevar>PREFIX</makevar>/etc</filename>��
+ <emphasis>��Ҫ</emphasis> �򵥵ذ�װ���ǣ� ����������
+ <filename>pkg-plist</filename>�� ��Ϊ�����ᵼ��
+ &man.pkg.delete.1; ɾ���û����ı༭���ļ���
+ ���°�װʱ���ֻ����Щ�ļ����ǡ�</para>
- <para>���������ֳ��������Σ�</para>
+ <para>��ˣ� ��Ӧ�������ļ������Ӱ������ĺ�׺����װ
+ (���� <filename><replaceable>filename</replaceable>.sample</filename>
+ ����һ��������ѡ��) ����ʾһ�� <link
+ linkend="porting-message">��Ϣ</link>
+ �����û���θ��Ʋ��༭��������ļ��� �Ա��������ܹ���ȷ������</para>
+ <para>��ˣ� Ӧ�������ĺ�׺����װ�����ļ�������
+ (<filename><replaceable>filename</replaceable>.sample</filename>
+ ����һ��������ѡ��)�� ���ʵ�ʵ������ļ������ڣ�
+ ���临��Ϊʵ���ļ������֡� ж��ʱ�� ��������û�û���޸������ļ���
+ ����ɾ���� ����Ҫ�� port �� <filename>Makefile</filename>��
+ �Լ� <filename>pkg-plist</filename> (���ڴ� package
+ ��װ������) ���д�����</para>
- <itemizedlist>
- <listitem>
- <para>��� port ���� <filename>Makefile</filename> ��
- <filename>Imakefile</filename> ���� <literal>-lXm</literal>
- ����ʽ������ Motif �⣬ �򵥵ؽ����Ϊ
- <literal>&dollar;{MOTIFLIB}</literal> ���ɡ�</para>
- </listitem>
+ <para>ʾ���� <filename>Makefile</filename> ���֣�</para>
- <listitem>
- <para>��� port ���� <filename>Imakefile</filename> ��ʹ����
- <literal>XmClientLibs</literal>�� ��Ӧ�����Ϊ
- <literal>&dollar;{MOTIFLIB} &dollar;{XTOOLLIB}
- &dollar;{XLIB}</literal>��</para>
- </listitem>
+ <programlisting>post-install:
+ @if [ ! -f ${PREFIX}/etc/orbit.conf ]; then \
+ ${CP} -p ${PREFIX}/etc/orbit.conf.sample ${PREFIX}/etc/orbit.conf ; \
+ fi</programlisting>
- </itemizedlist>
+ <para>ʾ���� <filename>pkg-plist</filename> ���֣�</para>
- <para>ע�� <makevar>MOTIFLIB</makevar> (ͨ�������) ��չ����
- <literal>-L/usr/X11R6/lib -lXm</literal> ��
- <literal>/usr/X11R6/lib/libXm.a</literal>�� �����Ͳ�����Ҫ��ǰ������
- <literal>-L</literal> �� <literal>-l</literal> �ˡ�</para>
+ <programlisting>@unexec if cmp -s %D/etc/orbit.conf.sample %D/etc/orbit.conf; then rm -f %D/etc/orbit.conf; fi
+etc/orbit.conf.sample
+@exec if [ ! -f %D/etc/orbit.conf ] ; then cp -p %D/%F %B/orbit.conf; fi</programlisting>
+
+ <para>���⣬ ��Ӧ��ʾһ�� <link
+ linkend="porting-message">��Ϣ</link> ָ���û�Ӧ�ںδ����Ʋ��༭����ļ���
+ �Ա��������ܿ�ʼ����������</para>
</sect1>
- </chapter>
- <chapter id="x11-fonts">
- <title>X11 ����</title>
+ <sect1 id="plist-autoplist">
+ <title>װ�䵥 (package list) ���Զ�������</title>
- <para>������� port ��Ҫ�� X Window ϵͳ��װ���壬 Ӧ�����Ƿŵ�
- <filename><makevar>X11BASE</makevar>/lib/X11/fonts/local</filename>��
- ���Ŀ¼���� <application>XFree86 3.3.3</application> �������ġ�
- ����������ڣ� ��Ӧ����һ���� ������һ����ϢҪ���û���
- <application>XFree86</application> ���µ� 3.3.3 ����°汾��
- ���ߣ� ���ٽ����Ŀ¼���뵽 <filename>/etc/XF86Config</filename>
- �е�����·���С�</para>
- </chapter>
+ <para>���ȣ� ��ȷ���Ѿ������������ port �Ĺ����� ��ȱ
+ <filename>pkg-plist</filename>��</para>
- <chapter id="porting-info">
- <title>Info �ļ�</title>
+ <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>
+
+ <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>
+&prompt.root; <userinput>make depends PREFIX=/var/tmp/<replaceable>port-name</replaceable></userinput></screen>
+
+ <para>��Ŀ¼�ṹ���浽һ���ļ��С�</para>
+
+ <screen>&prompt.root; <userinput>(cd /var/tmp/<replaceable>port-name</replaceable> && find -d * -type d) | sort &gt; OLD-DIRS</userinput></screen>
+
+ <para>����һ�հ� <filename>pkg-plist</filename> �ļ���</para>
+
+ <screen>&prompt.root; <userinput>touch pkg-plist</userinput></screen>
+
+ <para>������� port ��ѭ <makevar>PREFIX</makevar> (Ӧ�����)
+ �������Ӧ��װ�� port ������װ�䵥��</para>
+
+ <screen>&prompt.root; <userinput>make install PREFIX=/var/tmp/<replaceable>port-name</replaceable></userinput>
+&prompt.root; <userinput>(cd /var/tmp/<replaceable>port-name</replaceable> && find -d * \! -type d) | sort &gt; pkg-plist</userinput></screen>
+
+ <para>���⻹Ӧ���½�����Ŀ¼����װ�䵥��</para>
+
+ <screen>&prompt.root; <userinput>(cd /var/tmp/<replaceable>port-name</replaceable> && find -d * -type d) | sort | comm -13 OLD-DIRS - | sort -r | sed -e 's#^#@dirrm #' &gt;&gt; pkg-plist</userinput></screen>
+
+ <para>�����Ҫ�ֹ����� packing list�� ��һ���̲���
+ <emphasis>��ȫ</emphasis> �Զ��ġ� �����ֲ�Ӧ���� port
+ �� <filename>Makefile</filename> �е�
+ <makevar>MAN<replaceable>n</replaceable></makevar>�� ������װ�䵥��
+ �û������ļ�Ӧ��ɾ���� ����
+ <filename><replaceable>filename</replaceable>.sample</filename>
+ ��������������װ�� <filename>info/dir</filename> �ļ���
+ Ҳ��Ӧ���룬 ͬʱӦ���� <link linkend="makefile-info">info
+ �ļ�</link> ��˵��������һЩ <filename>install-info</filename> �С�
+ ������ port ��װ�Ŀ⣬ Ӧ����
+ <link linkend="porting-shlibs">��̬���ӿ�</link>
+ С���н��ܵķ���������</para>
+
+ <para>���⣬ Ҳ����ʹ��
+ <filename>/usr/ports/Tools/scripts/</filename> �е�
+ <command>plist</command> �ű����Զ�����
+ package list�� ��һ��������һ���� Ҳ����
+ <command>mkdir</command>�� <command>mtree</command> ��
+ <command>make depends</command>�� Ȼ�󹹽��Ͱ�װ
+ port��</para>
+
+ <screen>&prompt.root; <userinput>make install PREFIX=/var/tmp/<replaceable>port-name</replaceable></userinput></screen>
+
+ <para>Ȼ���� <command>plist</command> ����
+ <filename>pkg-plist</filename> ���</para>
+
+ <screen>&prompt.root; <userinput>/usr/ports/Tools/scripts/plist -Md -m /etc/mtree/BSD.<replaceable>port-type</replaceable>.dist /var/tmp/<replaceable>port-name</replaceable> &gt; pkg-plist</userinput></screen>
+
+ <para>��ǰ�����ƣ� ������ɵ�װ�䵥Ҳ��Ҫ�ֹ�����һЩ����������</para>
+
+ </sect1>
- <para>������� package ��Ҫ��װ GNU info �ļ���
- Ӧ���������� <makevar>INFO</makevar> ������ (����Ҫָ��
- <literal>.info</literal> ��׺)�� ������װ/ж�ش���ͻ��Զ����� package
- ע��ʱ���뵽 <filename>pkg-plist</filename> �ˡ�</para>
</chapter>
<chapter id="pkg-files">
@@ -5454,75 +5877,6 @@ ${PREFIX}/man/ja/man4/baz.4.gz</programlisting>
<literal>pkg-req &dollar;{PKGNAME} DEINSTALL</literal> ��������ִ�С�</para>
</sect1>
- <sect1 id="porting-plist">
- <title>���� make �����ı� <filename>pkg-plist</filename></title>
-
- <para>ijЩ port�� �ر��� <literal>p5-</literal> port��
- ����Ҫ��������ѡ�� (����� <literal>p5-</literal> ���ԣ�
- <literal>perl</literal> �İ汾) �������ǵ�<filename>pkg-plist</filename>
- �����޸ġ� Ϊ��������� ��
- <filename>pkg-plist</filename> �е� <literal>%%OSREL%%</literal>��
- <literal>%%PERL_VER%%</literal>�� �Լ�
- <literal>%%PERL_VERSION%%</literal> ���ᱻ�ʵ��������滻��
- ���У� <literal>%%OSREL%%</literal> ��ʾ����ϵͳ��������ʽ��ֵ (����
- <literal>4.9</literal>)�� <literal>%%PERL_VERSION%%</literal>
- ���滻Ϊ <command>perl</command> �������汾�� (���磬
- <literal>5.00502</literal>) �� <literal>%%PERL_VER%%</literal>
- ���ʾ <command>perl</command> �汾��ȥ�� patchlevel
- �IJ��� (���磬 <literal>5.005</literal>)�� ���������Ĺ���
- ports ���ĵ��ļ���
- <literal>%%<replaceable>VARS</replaceable>%%</literal> ��������
- �� <link
- linkend="dads-documentation">���С��</link> �л�ֱ���ܡ�</para>
-
- <para>���������Ҫ�����������滻�� ����ͨ����
- <makevar>PLIST_SUB</makevar> ����������һ��
- <literal><replaceable>VAR</replaceable>=<replaceable>VALUE</replaceable></literal>
- ���� <filename>pkg-plist</filename> �е�
- <literal>%%<replaceable>VAR</replaceable>%%</literal>
- �滻Ϊ <replaceable>VALUE</replaceable>��</para>
-
- <para>������˵�� ������� port ��Ҫ�Ѻܶ��ļ��ŵ��Ͱ汾�йص�Ŀ¼�У�
- ������ <filename>Makefile</filename> �а���������������ӣ�</para>
-
- <programlisting>OCTAVE_VERSION= 2.0.13
-PLIST_SUB= OCTAVE_VERSION=${OCTAVE_VERSION}</programlisting>
-
- <para>����д�� ���� <filename>pkg-plist</filename> �еľ���汾��Ϊ
- <literal>%%OCTAVE_VERSION%%</literal>�� ������ �������� port ʱ��
- �Ͳ���Ҫ�ٵ� <filename>pkg-plist</filename> ���޸��Ǽ�ʮ (���ߣ�
- ijЩ����¿���������) �е������ˡ�</para>
-
- <para>��һ�滻 (�Լ����� <link
- linkend="porting-manpages">�����ֲ�</link>)
- ���� <maketarget>pre-install</maketarget> ��
- <maketarget>do-install</maketarget> ���� target ֮�䣬 ͨ����ȡ
- <filename><makevar>PLIST</makevar></filename> ���
- <filename><makevar>TMPPLIST</makevar></filename> �����
- (Ĭ������£� ��
- <filename><makevar>WRKDIR</makevar>/.PLIST.mktmp</filename>)��
- ������� port ֱ�ӹ��� <filename><makevar>PLIST</makevar></filename>��
- ��Ӧ�� <maketarget>pre-install</maketarget> ��֮ǰ���С�
- ���⣬ ������� port ��Ҫ�༭���ɵ������ļ��� Ӧ��
- <maketarget>post-install</maketarget> �ж�
- <filename><makevar>TMPPLIST</makevar></filename> �������</para>
-
- <para>��һ�ֿ����ǣ� ��Ҫ���� <makevar>PLIST_FILES</makevar> ��
- <makevar>PLIST_DIRS</makevar> �����������޸� port ��װ�䵥��
- ������������ֵ����Ϊ·����д�뵽 <filename><makevar>TMPPLIST</makevar></filename>
- �� <filename><makevar>PLIST</makevar></filename>��
- �� <makevar>PLIST_FILES</makevar> �� <makevar>PLIST_DIRS</makevar>
- ���г�������Ҳ����к�ǰ����ܵķ�ʽ��ͬ��
- <literal>%%<replaceable>VAR</replaceable>%%</literal>
- �滻�� ����֮�⣬ �� <makevar>PLIST_FILES</makevar>
- �е�·�����᲻���޸ĵس��������յ�װ�䵥�У�
- �� <literal>@dirrm</literal> ���������� <makevar>PLIST_DIRS</makevar>
- ��Ԥ��ָ�������֡� Ҫ�ﵽЧ���� <makevar>PLIST_FILES</makevar> ��
- <makevar>PLIST_DIRS</makevar> �������
- <filename><makevar>TMPPLIST</makevar></filename> ֮ǰ�������ã�
- Ҳ���� <maketarget>pre-install</maketarget> ����硣</para>
- </sect1>
-
<sect1 id="pkg-names">
<title id="porting-pkgfiles">�ı�
<filename>pkg-<replaceable>*</replaceable></filename> �������</title>
@@ -5676,23 +6030,10 @@ as .putsy.conf and edit it.</programlisting>
<note>
<para>������ <filename>make.conf</filename> ��������ʲôѡ�
����ļ���Ӧ�ܹ���ȷ�����ɡ� ��ˣ�
- Ӧ������ (����) ij��������ϵ�޷�����ʱʹ�� <literal>.error</literal>��</para>
+ Ӧ������ (����) ij��������ϵ�޷�����ʱʹ�� <literal>.error</literal>��
+ (�μ� <xref linkend="dads-dot-error">��)</para>
</note>
- <example id="dot-error-breaks-index">
- <title>��α���ʹ�� <literal>.error</literal></title>
- <para>���������� <filename>make.conf</filename> ��������
- <programlisting>USE_POINTYHAT=yes</programlisting> ������
- ����������У� ��һ�� <filename>Makefile</filename>
- ������ <command>make index</command> ʧ�ܣ� ���ڶ������᣺</para>
- <programlisting>.if USE_POINTYHAT
-.error "POINTYHAT is not supported"
-.endif</programlisting>
- <programlisting>.if USE_POINTYHAT
-IGNORE=POINTYHAT is not supported
-.endif</programlisting>
- </example>
-
<para>��� <command>make describe</command> ֻ�Dz���һ���ַ�����
�����Ǵ�����Ϣ�� ���ܾ�ûʲô���⡣ ��μ�
<filename>bsd.port.mk</filename> ���˽������ɵĴ������塣</para>
@@ -5736,7 +6077,7 @@ IGNORE=POINTYHAT is not supported
<filename>/usr/X11R6</filename> ������·���� ���������
port ������࣬ �����ܹ���Ӧ����վ�������
����ʹ���� <command>imake</command> �� X port ���ԣ�
- �����Զ��ģ� �������� port��
+ �����Զ��ģ� �������� port��
��ͨ������ͨ������ �ű�/<filename>Makefile</filename>
�г��ֵ� <filename>/usr/local</filename> (����ڲ�ʹ�� imake �� X port��
<filename>/usr/X11R6</filename>) ��Ϊʹ��
@@ -5777,7 +6118,7 @@ IGNORE=POINTYHAT is not supported
����
<literal>-DPAGER=\"/usr/local/bin/less\"</literal>��
���ַ����ܹ�������ϵͳ����Ա������ <filename>/usr/local</filename>
- Ŀ¼Ų������λ��ʱ��װ�ɹ��Ļ��ᡣ</para>
+ Ŀ¼Ų������λ��ʱ��װ�ɹ��Ļ��ᡣ</para>
</sect1>
</chapter>
@@ -5883,8 +6224,8 @@ IGNORE=POINTYHAT is not supported
<para>���͵�С bug ͨ��ֻӰ����Щ������ijЩ�ܹ���������ѡ����ϵ��û���
������Ա���ջ��ڷ���û���Ǹ�������°�֮�����һ����������������
���û��е����岢�������������� ��Ϊ���Dz�û�������������е����ա�
- ���ص� bug ���ܻᵼ�����ݶ�ʧ���������⣬ ������Σ�
- �������û�֪���� �������� bug ֮�⻹�кܶ������¹ʿ��ܻᵼ�����ݶ�ʧ��
+ ���ص� bug ���ܻᵼ�����ݶ�ʧ���������⣬ ������Σ�
+ �������û�֪���� �������� bug ֮�⻹�кܶ������¹ʿ��ܻᵼ�����ݶ�ʧ��
������ǻᱸ����Ҫ���ݣ� ���⣬ ���ص� bug ͨ���ᱻ�ܿ췢�֡�</para>
<para>��ȫ©������ȫ��ͬ�� ��һ�� ���ǿ��ܴ���������������֣�
@@ -5892,7 +6233,7 @@ IGNORE=POINTYHAT is not supported
�����һ�����ܻ�õ�δ����Ȩ�ķ���Ȩ�ޣ�
��������ЩȨ�޻ٵ����޸��������ݣ�
����������������û����ܸ���ע�ⲻ�����Ѿ������� ������
- ��¶����ȫ©����ϵͳ�� �����ܹ����������ߴ�������֮ǰ�����ܽ����ϵͳ��
+ ��¶����ȫ©����ϵͳ�� �����ܹ����������ߴ�������֮ǰ�����ܽ����ϵͳ��
��ˣ� ֻ��������ȫ©���Dz����ģ� ������������ȫ��ķ�ʽ֪ͨ���ڣ�
�������Ǿ��ܹ��������գ� ����ȡ�ʵ��Ĵ�ʩ��</para>
</sect1>
@@ -5954,7 +6295,7 @@ IGNORE=POINTYHAT is not supported
<para>������� committer�� ��������и��� VuXML ���ݿ⡣
������ �����ܹ�ͬʱ������ȫ���Ŷӣ�
�����罫������Ҫ����Ϣ������û�Ⱥ�塣 Ȼ���� ��������� committer��
- �����������Լ�������һ���쳣���ص�©���� �����������������
+ �����������Լ�������һ���쳣���ص�©���� �����������������
�벻Ҫ���ڰ��� <ulink
url="http://www.freebsd.org/zh_CN/security/#how">FreeBSD
��ȫ��Ϣ</ulink> ҳ���ϵķ�����ϵ��ȫ���Ŷӡ�</para>
@@ -5966,7 +6307,7 @@ IGNORE=POINTYHAT is not supported
���ԣ� ����ȫ����
<filename><envar>PORTSDIR</envar>/security/vuxml/vuln.xml</filename>��
ÿ�������� port �еİ�ȫ©��ʱ�� ����µļ�¼���뵽�Ǹ��ļ��С�
- ����Ϥ VuXML ֮ǰ�� ������ȿ����Ƿ������Ƶ������ֵ������������¼��
+ ����Ϥ VuXML ֮ǰ�� ������ȿ����Ƿ������Ƶ������ֵ������������¼��
����������Ϊģ�塣</para>
</sect2>
@@ -6072,15 +6413,15 @@ IGNORE=POINTYHAT is not supported
</listitem>
<listitem>
- <para>������ͬ��׺���������壬 ����
+ <para>������ͬ��׺���������壬 ����
<literal>-a4</literal> (���ںʹ�ӡ�йص�������)��
<literal>-without-gui</literal> (�ṩ�������� X
- ֧�ֵ�������)�� �Լ����Ƶ����������</para>
+ ֧�ֵ�������)�� �Լ����Ƶ����������</para>
</listitem>
<listitem>
<para><literal>jp-</literal>�� <literal>ru-</literal>��
- <literal>zh-</literal>�� �Լ��������ܵı��ػ����壬
+ <literal>zh-</literal>�� �Լ��������ܵı��ػ����壬
����ͨ�������� Ports Collection ����Ӧ�Ĺ��ҷ������ҵ���</para>
</listitem>
</itemizedlist>
@@ -6200,7 +6541,7 @@ IGNORE=POINTYHAT is not supported
</callout>
<callout arearefs="co-vx-url">
- <para>һ��� URL�� ֻ����û���������ʺϵIJο�����ʱ��
+ <para>һ��� URL�� ֻ����û���������ʺϵIJο�����ʱ��
��Ӧʹ������</para>
</callout>
@@ -6330,7 +6671,7 @@ Reference: &lt;http://www.freebsd.org/ports/portaudit/74a9541d-5d6c-11d8-80e3-00
<para>������һЩ����ֲ����ʱ���ܻ������ij������⡣
��Ӧ��������б�����Լ��� port�� ͬ���أ�
��Ҳ���԰������ <ulink url="http://www.FreeBSD.org/cgi/query-pr-summary.cgi?query">PR ���ݿ�</ulink>
- �����������ύ�� port�� �밴����
+ �����������ύ�� port�� �밴����
<ulink url="&url.articles.contributing;/contrib-how.html#CONTRIB-GENERAL"
>���ⱨ���һ����ע��</ulink> �н��ܵķ����ύ���Ŀ�����
������� PR ���ݿ��е� ports ���ܹ��������Ǹ���� commit ���ǣ�
@@ -6381,7 +6722,7 @@ Reference: &lt;http://www.freebsd.org/ports/portaudit/74a9541d-5d6c-11d8-80e3-00
<listitem>
<para><makevar>INSTALL_MAN</makevar> �������ڰ�װ�����ֲᣬ
- �Լ������ĵ������� (ע�⣬ �����������Щ�ļ�ʵʩѹ������)��</para>
+ �Լ������ĵ������� (ע�⣬ �����������Щ�ļ�ʵʩѹ������)��</para>
</listitem>
</itemizedlist>
@@ -6408,7 +6749,7 @@ Reference: &lt;http://www.freebsd.org/ports/portaudit/74a9541d-5d6c-11d8-80e3-00
<para>һ��Ҫȷ������ port ���� <makevar>WRKDIRPREFIX</makevar> �����á�
������� port ������Ҫ��������� ����˵����
- ���������� port �� <makevar>WRKDIR</makevar> ʱ��
+ ���������� port �� <makevar>WRKDIR</makevar> ʱ��
��Ҫע����ȷ��λ��Ӧ����
<filename><makevar>WRKDIRPREFIX</makevar><makevar>PORTSDIR</makevar>/<replaceable>subdir</replaceable>/<replaceable>name</replaceable>/work</filename>
������ <filename><makevar>PORTSDIR</makevar>/<replaceable>subdir</replaceable>/<replaceable>name</replaceable>/work</filename> �� <filename><makevar>.CURDIR</makevar>/../../<replaceable>subdir</replaceable>/<replaceable>name</replaceable>/work</filename>��
@@ -6424,7 +6765,7 @@ Reference: &lt;http://www.freebsd.org/ports/portaudit/74a9541d-5d6c-11d8-80e3-00
<para>�ڲ�ͬ�汾�� Unix �¿�����Ҫ�Դ������һЩ�޸Ļ�������������ѡ�
���ܹ���ȷ�ر�������С� �������Ҫ����һЩ�������Դ�������޸ģ�
�뾡��������Щ�޸�ͨ�ã� ������ ���Ǿ��ܹ�����Щ������ֲ�ظ���� FreeBSD
- ϵͳ�� ��������ֲ������ BSD ϵͳ�� �������� CSRG �� 4.4BSD��
+ ϵͳ�� ��������ֲ������ BSD ϵͳ�� �������� CSRG �� 4.4BSD��
BSD/386�� 386BSD�� NetBSD �� OpenBSD��</para>
<para>�Ƽ��Ļ�� 4.3BSD/Reno (1990) �Լ����°汾 BSD ����汾�ŵķ�ʽ�� ��ʹ��
@@ -6502,7 +6843,7 @@ Reference: &lt;http://www.freebsd.org/ports/portaudit/74a9541d-5d6c-11d8-80e3-00
<programlisting>#if __FreeBSD__ &gt;= 2
#include &lt;osreldate.h&gt;
# if __FreeBSD_version &gt;= 199504
- /* 2.0.5+ release specific code here */
+ /* ������ 2.0.5+ �汾�Ĵ��� */
# endif
#endif</programlisting>
</listitem>
@@ -7693,6 +8034,14 @@ Reference: &lt;http://www.freebsd.org/ports/portaudit/74a9541d-5d6c-11d8-80e3-00
<entry>504102</entry>
</row>
<row>
+ <entry>MFC if_bridge ֮��� 5.4-STABLE</entry>
+ <entry>504103</entry>
+ </row>
+ <row>
+ <entry>bsdiff �� portsnap MFC ֮��� 5.4-STABLE</entry>
+ <entry>504104</entry>
+ </row>
+ <row>
<entry>6.0-CURRENT</entry>
<entry>600000</entry>
</row>
@@ -7841,10 +8190,14 @@ Reference: &lt;http://www.freebsd.org/ports/portaudit/74a9541d-5d6c-11d8-80e3-00
</row>
<row>
<entry>Ϊ dev_clone �������ں���������������Ϣ����֮���
- 6.0-STABLE��</entry>
+ 6.0-STABLE�� 6.0-RELEASE��</entry>
<entry>600034</entry>
</row>
<row>
+ <entry>6.0-RELEASE ֮��� 6.0-STABLE</entry>
+ <entry>600100</entry>
+ </row>
+ <row>
<entry>7.0-CURRENT��</entry>
<entry>700000</entry>
</row>
@@ -7862,6 +8215,21 @@ Reference: &lt;http://www.freebsd.org/ports/portaudit/74a9541d-5d6c-11d8-80e3-00
<entry>�� memmem(3) ���� libc ֮��� 7.0-CURRENT��</entry>
<entry>700003</entry>
</row>
+ <row>
+ <entry>�� solisten(9) ��Ϊ����һ backlog ����֮���
+ 7.0-CURRENT��</entry>
+ <entry>700004</entry>
+ </row>
+ <row>
+ <entry>�� IFP2ENADDR() ��Ϊ����һ IF_LLADDR() ָ��֮���
+ 7.0-CURRENT��</entry>
+ <entry>700005</entry>
+ </row>
+ <row>
+ <entry>�� <literal>struct ifnet</literal> ������ <literal>if_addr</literal>
+ ��Ա�� ��ɾ�� IFP2ENADDR() ֮��� 7.0-CURRENT��</entry>
+ <entry>700006</entry>
+ </row>
</tbody>
</tgroup>
</table>
@@ -7897,7 +8265,7 @@ Reference: &lt;http://www.freebsd.org/ports/portaudit/74a9541d-5d6c-11d8-80e3-00
<para><filename>bsd.port.pre.mk</filename> ֻ�����˺��ٵı�����
���ǿ����� <filename>Makefile</filename>
�����ڽ���һЩ���ԣ� �� <filename>bsd.port.post.mk</filename>
- ���������������ı�����</para>
+ ���������������ı�����</para>
<para>������һЩ�� <filename>bsd.port.pre.mk</filename>
����ıȽ���Ҫ�ı��� (�Ⲣ����һ���������б���
@@ -8055,7 +8423,7 @@ post-install:
Ҳ����˵�� <filename>share/doc/<makevar>PORTNAME</makevar></filename>
��װ�䵥��Ĭ������»��滻�� <literal>%%DOCSDIR%%</literal>�� �ȵȡ�
(����� <filename>pkg-plist</filename> ����������
- <link linkend="porting-plist">����</link> �ҵ���)</para>
+ <link linkend="plist-sub">����</link> �ҵ���)</para>
<para>���еİ�װ���ĵ��ļ���Ŀ¼��
��Ӧ�� <filename>pkg-plist</filename> ���֣� ����ʹ��
@@ -8065,22 +8433,21 @@ post-install:
%%PORTDOCS%%%%DOCSDIR%%/CONTACT
%%PORTDOCS%%@dirrm %%DOCSDIR%%</programlisting>
- <para>��������� <filename>pkg-plist</filename> ��һһ�о��ĵ��� port
- Ҳ�������� <makevar>PORTDOCS</makevar> ���г�����Ҫ����Щ�ļ������ƣ�
- �Լ�ϣ�����뵽���յ�װ�䵥�е� shell glob ģʽ��
- ��Щ����Ӧ��������� <makevar>DOCSDIR</makevar> ·���ġ�
- ��ˣ� ʹ���� <makevar>PORTDOCS</makevar>
- ����ʹ���˷�Ĭ�ϵ�λ��������ĵ��� port�� Ӧ����Ӧ������
- <makevar>DOCSDIR</makevar>�� ���Ŀ¼���е��� <makevar>PORTDOCS</makevar>
- �У� ������������ glob ģʽƥ�䣬 ����������Ŀ¼�µ��ļ���Ŀ¼��
- Ҳ����ע�ᵽ���յ�װ�䵥�С� ���ָ���� <makevar>NOPORTDOCS</makevar>��
- ��Ӧ���� <makevar>PORTDOCS</makevar>�� ��������ķ�ʽ��
- ���ĵ���װ�� <makevar>PORTDOCS</makevar> �У� ������ port ��������ɡ�
- ʹ�� <makevar>PORTDOCS</makevar> �ĵ��������ǣ�</para>
-
- <programlisting>.if !defined(NOPORTDOCS)
- PORTDOCS= *
-.endif</programlisting>
+ <para>�����ϣ���� <filename>pkg-plist</filename> ������о��ĵ��ļ��� port
+ Ҳ���Խ� <makevar>PORTDOCS</makevar> ����Ϊһ���ļ����� shell glob
+ ģʽ�� ͨ�����ַ�ʽ�����뵽���յ�װ�䵥�С�
+ ��Щ����Ӧ������� <makevar>DOCSDIR</makevar> �ġ�
+ ��ˣ� ʹ���� <makevar>PORTDOCS</makevar>��
+ �����ĵ���װ���DZ�׼λ�õ� port�� Ӧ��Ӧ������
+ <makevar>DOCSDIR</makevar>��
+ ������� <makevar>PORTDOCS</makevar> ���г�Ŀ¼��
+ ������һ�����е� glob ģʽƥ�䵽��Ŀ¼�� �����������е��ļ���Ŀ¼��
+ ������ע�ᵽ���յ�װ�䵥�С� ��������� <makevar>NOPORTDOCS</makevar>�� ��
+ <makevar>PORTDOCS</makevar> �ж�����ļ���Ŀ¼��������װ�����װ�䵥��
+ �Ƿ�װ�ĵ���ǰ����˵�� <makevar>PORTDOCS</makevar> ��ȡ���� port ������
+ ������һ�����͵�ʹ�� <makevar>PORTDOCS</makevar> �����ӣ�</para>
+
+ <programlisting>PORTDOCS= README.* ChangeLog docs/*</programlisting>
<note>
<para>��Ҳ����ʹ�� <filename>pkg-message</filename> ����ļ���
@@ -8106,7 +8473,7 @@ post-install:
(��ϵͳ�ڲ����õĿ�ִ���ļ�)�� <filename>sbin</filename>
(Ϊ�����û�/����Ա�ṩ�Ŀ�ִ���ļ�)�� <filename>info</filename>
(���� info ��������ĵ�) �� <filename>share</filename>
- (ƽ̨�޹ص������ļ�)�� ��μ� &man.hier.7; ���˽��һ�������飻 ���
+ (ƽ̨�޹ص������ļ�)�� ��μ� &man.hier.7; ���˽��һ�������飻 ���
<filename>/usr</filename> ����Щ���� ͬ��Ҳ������
<filename>/usr/local</filename>�� �����������Щ��Ҫ�� USENET
<quote>news</quote> �򽻵��� port�� ���ǿ���ѡ�����
@@ -8114,35 +8481,6 @@ post-install:
��Ϊ�ļ���Ŀ�ĵء�</para>
</sect1>
- <sect1 id="porting-cleaning">
- <title>������Ŀ¼</title>
-
- <para>һ��Ҫ������ port ��ж��ʱ����������
- ��ͨ����ͨ��Ϊ������ port ������Ŀ¼����һ��
- <literal>@dirrm</literal> ����ɵġ� ��ע�⣬ ��ɾ����Ŀ¼֮ǰ��
- ��Ҫ����ɾ����Ŀ¼��</para>
-
- <programlisting> :
-lib/X11/oneko/pixmaps/cat.xpm
-lib/X11/oneko/sounds/cat.au
- :
-@dirrm lib/X11/oneko/pixmaps
-@dirrm lib/X11/oneko/sounds
-@dirrm lib/X11/oneko</programlisting>
-
- <para>Ȼ���� ��ʱ <literal>@dirrm</literal> �������� port
- ����ͬһ����Ŀ¼ʱ�������� ������ͨ��ʹ�� <literal>@unexec</literal>
- ������ <command>rmdir</command> ���ﵽɾ����Ŀ¼��
- �������������Ŀ�ġ�</para>
-
- <programlisting>@unexec rmdir %D/share/doc/gimp 2>/dev/null || true</programlisting>
-
- <para>�������Ȳ�����ʾ����������Ϣ�� Ҳ���ᵼ��
- &man.pkg.delete.1; �쳣�˳��� ��ʹ���ڰ�װ������ port ��ʹ��
- <filename><makevar>PREFIX</makevar>/share/doc/gimp</filename>
- ���������ǿյ�ʱ��Ҳ����ˡ�</para>
- </sect1>
-
<sect1 id="dads-uid-and-gids">
<title>UID �� GID</title>
@@ -8155,7 +8493,7 @@ lib/X11/oneko/sounds/cat.au
������� 50 �� 999 ֮��ѡ��һ��δ�õ� UID�� ��μ�
<filename role="package">japanese/Wnn6</filename> �ṩ�����ӡ�</para>
- <para>һ����Ҫʹ��ϵͳ������ port �Ѿ�ʹ�õ� UID��</para>
+ <para>һ����Ҫʹ��ϵͳ������ port �Ѿ�ʹ�õ� UID��</para>
<para>������ĿǰԤ���� 50 �� 999 ֮��� UID��</para>
@@ -8221,8 +8559,15 @@ polipo:*:173:173:polipo web cache:/nonexistent:/sbin/nologin
bogomilter:*:174:174:milter-bogom:/nonexistent:/sbin/nologin
moinmoin:*:192:192:MoinMoin User:/nonexistent:/sbin/nologin
sympa:*:200:200:Sympa Owner:/nonexistent:/sbin/nologin
+privoxy:*:201:201:Privoxy proxy user:/nonexistent:/sbin/nologin
dspam:*:202:202:Dspam:/nonexistent:/sbin/nologin
+shoutcast:*:210:210:Shoutcast sandbox:/nonexistent:/bin/sh
_tor:*:256:256:Tor anonymising router:/var/db/tor:/bin/sh
+smxs:*:260:260:Sendmail X SMTPS:/nonexistent:/sbin/nologin
+smxq:*:261:261:Sendmail X QMGR:/nonexistent:/sbin/nologin
+smxc:*:262:262:Sendmail X SMTPC:/nonexistent:/sbin/nologin
+smxm:*:263:263:Sendmail X misc:/nonexistent:/sbin/nologin
+smx:*:264:264:Sendmail X other:/nonexistent:/sbin/nologin
ldap:*:389:389:OpenLDAP Server:/nonexistent:/sbin/nologin
drweb:*:426:426:Dr.Web Mail Scanner:/nonexistent:/sbin/nologin
courier:*:465:465:Courier Mail Server:/nonexistent:/sbin/nologin
@@ -8230,6 +8575,7 @@ _bbstored:*:505:505::0:0:BoxBackup Store Daemon:/nonexistent:/bin/sh
qtss:*:554:554:Darwin Streaming Server:/nonexistent:/sbin/nologin
ircdru:*:555:555:Russian hybrid IRC server:/nonexistent:/bin/sh
messagebus:*:556:556:D-BUS Daemon User:/nonexistent:/sbin/nologin
+avahi:*:558:558:Avahi Daemon User:/nonexistent:/sbin/nologin
bnetd:*:700:700:Bnetd user:/nonexistent:/sbin/nologin
bopm:*:717:717:Blitzed Open Proxy Monitor:/nonexistent:/bin/sh
bacula:*:910:910:Bacula Daemon:/var/db/bacula:/sbin/nologin</programlisting>
@@ -8291,6 +8637,11 @@ moinmoin:*:192:
sympa:*:200:
dspam:*:202:
_tor:*:256:
+smxs:*:260:
+smxq:*:261:
+smxc:*:262:
+smxm:*:263:
+smx:*:264:
ldap:*:389:
drweb:*:426:
courier:*:465:
@@ -8299,6 +8650,7 @@ qtss:*:554:
ircdru:*:555:
messagebus:*:556:
realtime:*:557:
+avahi:*:558:
bnetd:*:700:
bopm:*:717:
bacula:*:910:</programlisting>
@@ -8335,7 +8687,7 @@ bacula:*:910:</programlisting>
<para>port Ӧ��ѭ <makevar>CC</makevar>
�� <makevar>CXX</makevar> ���������á�
��Ҳ����˵�� port ��Ӧʹ�þ��Եķ�ʽ���������������ֵ��
- ������Ѿ����ڵ����ã� ����෴�� ��Ӧ������ֵ�������Ҫ������ֵ��
+ ������Ѿ����ڵ����ã� ����෴�� ��Ӧ������ֵ�������Ҫ������ֵ��
������ �Ϳ�������ȫ�ֵĹ���ѡ� ����Ӱ�����е� port ���������ˡ�</para>
<para>���ʵ���޷��������� ���� <filename>Makefile</filename>
@@ -8370,7 +8722,7 @@ bacula:*:910:</programlisting>
<para>���� port Ӧ��ѭ <makevar>CFLAGS</makevar> ���������á�
��Ҳ����˵�� port ��Ӧʹ�þ��Եķ�ʽ���������������ֵ��
- ������Ѿ����ڵ����ã� ����෴�� ��Ӧ������ֵ�������Ҫ������ֵ��
+ ������Ѿ����ڵ����ã� ����෴�� ��Ӧ������ֵ�������Ҫ������ֵ��
������ �Ϳ�������ȫ�ֵĹ���ѡ� ����Ӱ�����е� port ���������ˡ�</para>
<para>���ʵ���޷��������� ���� <filename>Makefile</filename>
@@ -8410,23 +8762,6 @@ bacula:*:910:</programlisting>
</sect1>
- <sect1 id="dads-config">
- <title>�����ļ�</title>
-
- <para>������� port ��Ҫ��
- <filename><makevar>PREFIX</makevar>/etc</filename> �б��������ļ���
- <emphasis>��Ҫ</emphasis> �򵥵ذ�װ���Dz���������
- <filename>pkg-plist</filename>�� �⽫����
- &man.pkg.delete.1; ɾ���û����ı�д�������ļ���
- �����µİ�װҲ�����Щ�ļ��������</para>
-
- <para>��ˣ� ��Ӧ�������ļ������Ӱ������ĺ�׺����װ
- (���� <filename><replaceable>filename</replaceable>.sample</filename>
- ����һ��������ѡ��) ����ʾһ�� <link
- linkend="porting-message">��Ϣ</link>
- �����û���θ��Ʋ��༭��������ļ��� �Ա��������ܹ���ȷ������</para>
- </sect1>
-
<sect1 id="dads-freedback">
<title>����</title>
@@ -8506,13 +8841,13 @@ bacula:*:910:</programlisting>
�Ա���ٰ���©���� FreeBSD ����������
(����ϣ���������õİ�ȫ��¼)�� Ȼ����
��ʱ�ڰ�ȫ©������¶����������֮����ܻ���һ�������
- ��ʱӦ����˵���� ���˰�ȫ֮�⣬ �벻Ҫ���κ��������ɽ� port ���Ϊ
+ ��ʱӦ����˵���� ���˰�ȫ֮�⣬ �벻Ҫ���κ��������ɽ� port ���Ϊ
<makevar>FORBIDDEN</makevar>��</para>
</listitem>
<listitem>
<para><makevar>IGNORE</makevar> ������ʾ port
- ����ijЩ����ԭ��Ӧ���Թ����� �����Ϊ�����˽ṹ�Ե����⣬
+ ����ijЩ����ԭ��Ӧ���Թ����� �����Ϊ�����˽ṹ�Ե����⣬
��Ӧʹ������ �κ�����£�
������Ⱥ�����ṹ�����Ϊ
<makevar>IGNORE</makevar> �� port�� ������ʹ��
@@ -8571,7 +8906,7 @@ bacula:*:910:</programlisting>
<sect2 id="dads-noinstall-notes">
<title>ʵ��˵��</title>
- <para>���� <filename>bsd.port.mk</filename> ������һЩ�ط�
+ <para>���� <filename>bsd.port.mk</filename> ������һЩ�ط�
<makevar>IGNORECMD</makevar> ��һЩ�����÷���
<makevar>BROKEN</makevar> ��ֵӦ����������������
�� <makevar>IGNORE</makevar> ������������������</para>
@@ -8617,6 +8952,39 @@ bacula:*:910:</programlisting>
�ܹ���һ��ʱ�����������⡣</para>
</sect1>
+ <sect1 id="dads-dot-error">
+ <title>����ʹ�� <literal>.error</literal> �ṹ</title>
+
+ <para>�� <filename>Makefile</filename> �и����źţ�
+ ��ʾ����ij��������� (���磬 �û�ָ������Ч�Ĺ���ѡ��)
+ ���޷���װ�ķ����ǽ�����
+ <makevar>IGNORE</makevar> ��Ϊһ�ǿ�ֵ�� ���ֵ������ʽ����
+ �����û�ִ�� <command>make install</command> �Ǹ�����ʾ��</para>
+
+ <para>�� <literal>.error</literal> ʵ����һĿ����һ�ֳ��������á�
+ �������������ǣ� ������ ports �������е��Զ������߻���˶�ʧ�ܡ�
+ �����������ڹ��� <filename>/usr/ports/INDEX</filename> �Ĺ���
+ (�μ� <xref linkend="make-describe">)�� Ȼ���� ��ʹʮ����ͨ�����
+ ���� <command>make -V maintainer</command>��
+ �����������Ҳ��ʧ�ܡ� ���Dz��ɽ��ܵġ�</para>
+
+ <example id="dot-error-breaks-index">
+ <title>��������ʹ�� <literal>.error</literal></title>
+ <para>���������� <filename>make.conf</filename> ��������
+ <programlisting>USE_POINTYHAT=yes</programlisting>
+ �����Ρ� �������������У� ��һ�� <filename>Makefile</filename>
+ �е����⽫���� <command>make index</command> ʧ�ܣ�
+ ���ڶ����򲻻᣺</para>
+ <programlisting>.if USE_POINTYHAT
+.error "POINTYHAT is not supported"
+.endif</programlisting>
+ <programlisting>.if USE_POINTYHAT
+IGNORE=POINTYHAT is not supported
+.endif</programlisting>
+ </example>
+
+ </sect1>
+
<sect1 id="dads-workarounds">
<title>һЩ��Ҫ�� workaround</title>
@@ -8652,18 +9020,6 @@ bacula:*:910:</programlisting>
��Ҫ�����Ƿ���û�еõ��Ϸ���Ȩ��������</para>
</sect1>
- <sect1 id="dads-stuck">
- <title>�������������&hellip;</title>
-
- <para>��һ�����еķ����� �Լ�
- <filename>bsd.port.mk</filename> ���
- Ȼ���ٿ������ʣ�
- <!-- smiley --><emphasis>;-)</emphasis></para>
-
- <para>����������鷳һ��Ҫ���ʣ�
- ��Ҫֻ�����Լ���ͷȥײǽ�� <!-- smiley
- --><emphasis>:-)</emphasis></para>
- </sect1>
</chapter>
<chapter id="porting-samplem">
@@ -8712,14 +9068,13 @@ EXTRACT_SUFX= .tar.Z
PATCH_SITES= ftp://ftp.sra.co.jp/pub/X11/japanese/
PATCHFILES= xdvi-18.patch1.gz xdvi-18.patch2.gz
-[ά����(maintainer); *������*�� ����ij���û��ڷ�������򱨸� bug
- ʱ����������� (����� commit Ȩ��) - �����Ӧ���� port��
- ��ij�����԰�����ת������� port ���Ǹ��˵��ˡ�
- �������IJ���������д�Լ��ĵ�ַ�� ��������Ϊ "ports@FreeBSD.org"��]
+[�໤��(maintainer); *������*! ����ij����Դ���� port ���¡� ����ʧ�ܣ�
+ �Լ��ش��û�ֱ�����ʻ�㱨 bug ���ˡ� Ϊ�˱�֤ Ports Collection
+ �о����ܸߵ�Ʒ�ʣ� ���Dz��ٽ���ָ���� "ports@FreeBSD.org" ���� port��]
MAINTAINER= asami@FreeBSD.org
COMMENT= A DVI Previewer for the X Window System
-[���������������� -- ������]
+[���������������� -- ������]
RUN_DEPENDS= gs:${PORTSDIR}/print/ghostscript
LIB_DEPENDS= Xpm.5:${PORTSDIR}/graphics/xpm
@@ -8755,72 +9110,6 @@ pre-install:
.include &lt;bsd.port.mk&gt;</programlisting>
</chapter>
- <chapter id="porting-autoplist">
- <title>װ�䵥 (package list) ���Զ�������</title>
-
- <para>���ȣ� ��ȷ���Ѿ������������ port �Ĺ����� ��ȱ
- <filename>pkg-plist</filename>��</para>
-
- <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>
-
- <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>
-&prompt.root; <userinput>make depends PREFIX=/var/tmp/<replaceable>port-name</replaceable></userinput></screen>
-
- <para>��Ŀ¼�ṹ���浽һ�����ļ��С�</para>
-
- <screen>&prompt.root; <userinput>(cd /var/tmp/<replaceable>port-name</replaceable> && find -d * -type d) | sort &gt; OLD-DIRS</userinput></screen>
-
- <para>����һ���յ� <filename>pkg-plist</filename> �ļ���</para>
-
- <screen>&prompt.root; <userinput>touch pkg-plist</userinput></screen>
-
- <para>������� port ���� <makevar>PREFIX</makevar> ��װ (��Ӧ���)
- ����԰�װ�������� package list��</para>
-
- <screen>&prompt.root; <userinput>make install PREFIX=/var/tmp/<replaceable>port-name</replaceable></userinput>
-&prompt.root; <userinput>(cd /var/tmp/<replaceable>port-name</replaceable> && find -d * \! -type d) | sort &gt; pkg-plist</userinput></screen>
-
- <para>��Ҳ���԰�������Ŀ¼���뵽 packing list �С�</para>
-
- <screen>&prompt.root; <userinput>(cd /var/tmp/<replaceable>port-name</replaceable> && find -d * -type d) | sort | comm -13 OLD-DIRS - | sort -r | sed -e 's#^#@dirrm #' &gt;&gt; pkg-plist</userinput></screen>
-
- <para>��� ��Ҫ�ֹ����� packing list�� ��һ���̲���
- <emphasis>��ȫ</emphasis> �Զ��ġ� �����ֲ�Ӧ���� port
- �� <filename>Makefile</filename> ��
- <makevar>MAN<replaceable>n</replaceable></makevar>�� ������
- package list�� �û������ļ�Ӧ��ɾ���� ����
- <filename><replaceable>filename</replaceable>.sample</filename>
- ����������װ�� <filename>info/dir</filename> �ļ���
- Ҳ��Ӧ���룬 ͬʱӦ���� <link linkend="porting-info">info
- �ļ�</link> ��˵��������һЩ <filename>install-info</filename> �С�
- ������ port ��װ�Ŀ⣬ Ӧ����
- <link linkend="porting-shlibs">��̬���ӿ�</link>
- С���н��ܵķ���������</para>
-
- <para>���⣬ Ҳ����ʹ��
- <filename>/usr/ports/Tools/scripts/</filename> �е�
- <command>plist</command> �ű����Զ�����
- package list�� ��һ��������һ���� Ҳ����
- <command>mkdir</command>�� <command>mtree</command> ��
- <command>make depends</command>�� Ȼ�󹹽��Ͱ�װ
- port��</para>
-
- <screen>&prompt.root; <userinput>make install PREFIX=/var/tmp/<replaceable>port-name</replaceable></userinput></screen>
-
- <para>֮��Ϳ����� <command>plist</command> ������
- <filename>pkg-plist</filename> �ļ��ˣ�</para>
-
- <screen>&prompt.root; <userinput>/usr/ports/Tools/scripts/plist -Md -m /etc/mtree/BSD.<replaceable>port-type</replaceable>.dist /var/tmp/<replaceable>port-name</replaceable> &gt; pkg-plist</userinput></screen>
-
- <para>ͬ���أ� ��˴����� packing list Ҳ��Ҫ�ֹ�������һ�¡�</para>
-
- </chapter>
-
<chapter id="keeping-up">
<title>����ͬ��</title>
@@ -8833,7 +9122,7 @@ pre-install:
<para>��򵥵��˽��Ѿ��� commit �� ports �еĸ��µķ����� �Ƕ���
<ulink url="http://www.FreshPorts.org/">FreshPorts</ulink>��
������ѡ���� ports ��������м��ӡ� ǿ�ҽ���ά����Ա��������
- �����Ͳ����ܽ��յ������Լ��������޸ģ� �����ܿ������� &os;
+ �����Ͳ����ܽ��յ������Լ��������޸ģ� �����ܿ������� &os;
committer �����ĸĶ��� (��������������
ports ���ͬ���DZ�Ҫ��&mdash;��Ȼһ����˵������������ commit
֮ǰ�յ�һ����ò�Ե�֪ͨ�� ����ʱ���ܻ�����û��ע�⵽��Ҫ��������
@@ -8923,7 +9212,7 @@ pre-install:
�����õ��˺� ports �йص����ⱨ�� (PR)�� ���Թ�����Ⱥ�Ĵ�����־��
�Լ����� Ports Collection ���ļ����ṩ����Ϣ��
δ���� ����������н�һ������չ�� �Ӷ��ṩ���� distfile �ղ飬
- �Լ�������Դ���ڵĸ�����Ϣ��</para>
+ �Լ�������Դ���ڵĸ�����Ϣ��</para>
<para>Ҫʹ��������ߣ� ���ԴӲ鿴����ijһ�� port ��ȫ�����ϵ�
<ulink url="http://portsmon.FreeBSD.org/portoverview.py">