diff options
author | Xin LI <delphij@FreeBSD.org> | 2005-11-23 15:06:30 +0000 |
---|---|---|
committer | Xin LI <delphij@FreeBSD.org> | 2005-11-23 15:06:30 +0000 |
commit | 050e7f3c0726fd075e8f71ef0e4dd1a9740da7b0 (patch) | |
tree | 2b6f9f48e042b797f3f1ad34747001278ad73e86 /zh_CN.GB2312/books | |
parent | 065cd3fca2b3fbfb9c6cb66e6695d5551755c5c2 (diff) |
Notes
Diffstat (limited to 'zh_CN.GB2312/books')
-rw-r--r-- | zh_CN.GB2312/books/porters-handbook/book.sgml | 2135 |
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> ����������� — ���� 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>�� - �˴���Ҫд�κ�˵���Ե����֣� ����������ʵ���� — ���ʹ - <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>�� + �벻Ҫ�ڴ˴�д�κ�˵���Ե����֣� ����������ʵ���� — ���� + <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> ���ܸ�����һЩ — @@ -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> ���г������ֲ� — �μ� <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&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 <bsd.port.pre.mk> @@ -3489,20 +3590,6 @@ RUN_DEPENDS+= bar:${PORTSDIR}/bar/bar .include <bsd.port.post.mk></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=${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>:-></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=${PREFIX} + ${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>${MACHINE_ARCH}-portbld-freebsd${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>${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>${MOTIFLIB}</literal>��</para> + </listitem> - <row> - <entry><makevar>USE_LIBTOOL_VER</makevar></entry> + <listitem> + <para>��� port ���� <filename>Imakefile</filename> + ��ʹ�� <literal>XmClientLibs</literal>�� �����Ϊ + <literal>${MOTIFLIB} ${XTOOLLIB} + ${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 <bsd.port.post.mk></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>. /etc/rc.subr</literal> ��Ӧ�滻Ϊ + <literal>. %%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>—�μ� <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>${MOTIFLIB}</literal> ���ɡ�</para> - </listitem> + <para>ʾ���� <filename>Makefile</filename> ���֣�</para> - <listitem> - <para>��� port ���� <filename>Imakefile</filename> ��ʹ���� - <literal>XmClientLibs</literal>�� ��Ӧ�����Ϊ - <literal>${MOTIFLIB} ${XTOOLLIB} - ${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 > 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 > 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 #' >> 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> > 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 ${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: <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: <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: <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: <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: <http://www.freebsd.org/ports/portaudit/74a9541d-5d6c-11d8-80e3-00 <programlisting>#if __FreeBSD__ >= 2 #include <osreldate.h> # if __FreeBSD_version >= 199504 - /* 2.0.5+ release specific code here */ + /* ������ 2.0.5+ �汾�Ĵ��� */ # endif #endif</programlisting> </listitem> @@ -7693,6 +8034,14 @@ Reference: <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: <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: <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: <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>�������������…</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 <bsd.port.mk></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 > 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 > 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 #' >> 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> > 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�Ҫ��—��Ȼһ����˵������������ 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"> |