[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
pkgsrc/doc/guide/files/components.xml: 1.9 -> 1.11
以下のページの更新をしました。ツッコミをお願いします。
pkgsrc/doc/guide/files/components.xml: 1.9 -> 1.11
> revision 1.11
> date: 2005/08/03 16:34:19; author: wiz; state: Exp; lines: +12 -9
> Fix some XML errors I introduced. Noted by rpaulo@.
> ----------------------------
> revision 1.10
> date: 2005/07/28 11:05:36; author: wiz; state: Exp; lines: +144 -114
> Document some more variables.
水曜日までに異議がなければ、 commit します。
以下、訳と原文それぞれの新旧の差分です。
--- components.xml.orig 2006-10-07 22:03:44.000000000 +0900
+++ components.xml 2006-10-07 22:03:44.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: components.xml,v 1.9 2005/07/27 21:29:50 rpaulo Exp $ -->
+<!-- $NetBSD: components.xml,v 1.11 2005/08/03 16:34:19 wiz Exp $ -->
<!-- Based on english version: -->
-<!-- NetBSD: components.xml,v 1.9 2005/07/27 21:29:50 rpaulo Exp -->
+<!-- NetBSD: components.xml,v 1.11 2005/08/03 16:34:19 wiz Exp -->
<chapter id="components"> <?dbhtml filename="components.html"?>
<title>パッケージコンポーネント - ファイル、ディレクトリー、およびコンテンツ</title>
@@ -39,102 +39,145 @@
また、最初の文字はアルファベットまたは数字である必要があります。</para></listitem>
<listitem><para><varname>CATEGORIES</varname> は、
- 当該パッケージにふさわしいカテゴリーのリストです。
- pkgsrc の最上層にあるディレクトリーから自由に選ぶことができます。</para></listitem>
+ 当該パッケージにふさわしいカテゴリーのリストです。
+ pkgsrc の最上層にあるディレクトリーから自由に選ぶことができます。</para>
- <listitem><para><varname>MASTER_SITES</varname> は、配布ファイルをダウンロード可能な
- URL のリストです。
- 各 URL はスラッシュで終わる必要があります。</para></listitem>
+ <para>現在<varname>CATEGORIES</varname>の値として以下が使用できます。もし複数にまたがる場合、それら
+ の値はスペースで分けられる必要があります:</para>
+ <programlisting>
+archivers cross geography meta-pkgs security
+audio databases graphics misc shells
+benchmarks devel ham multimedia sysutils
+biology editors inputmethod net textproc
+cad emulators lang news time
+chat finance mail parallel wm
+comms fonts math pkgtools www
+converters games mbone print x11</programlisting>
+ </listitem>
+
+ <listitem><para><varname>MASTER_SITES</varname> は、配布ファイルをダウンロード可能な
+ URL のリストです。
+ 各 URL はスラッシュで終わる必要があります。</para>
+ <para><varname>MASTER_SITES</varname> には、
+ 以下の定義済みのサイトを使うこともできます。</para>
+
+<!-- sort bsd.sites.mk | sed -n 's/\(^MA[A-Z_]*\).*/ ${\1}/p' -->
+ <programlisting>
+ ${MASTER_SITE_APACHE}
+ ${MASTER_SITE_BACKUP}
+ ${MASTER_SITE_CYGWIN}
+ ${MASTER_SITE_DEBIAN}
+ ${MASTER_SITE_FREEBSD}
+ ${MASTER_SITE_FREEBSD_LOCAL}
+ ${MASTER_SITE_GNOME}
+ ${MASTER_SITE_GNU}
+ ${MASTER_SITE_GNUSTEP}
+ ${MASTER_SITE_IFARCHIVE}
+ ${MASTER_SITE_MOZILLA}
+ ${MASTER_SITE_OPENOFFICE}
+ ${MASTER_SITE_PERL_CPAN}
+ ${MASTER_SITE_R_CRAN}
+ ${MASTER_SITE_SOURCEFORGE}
+ ${MASTER_SITE_SUNSITE}
+ ${MASTER_SITE_SUSE}
+ ${MASTER_SITE_TEX_CTAN}
+ ${MASTER_SITE_XCONTRIB}
+ ${MASTER_SITE_XEMACS}
+ </programlisting>
+
+ <para>もしこれらの予め定義されたサイトの1つを選んだ場合、そのサイトのサブディレク
+ トリーを指定することが必要となるかもしれません。これらのマクロは複数の実際
+ のサイトに展開されるかもしれませんので、サブディレクトリーを指定する場合は、
+ 以下の表記を<emphasis>使わなければなりません</emphasis>:</para>
+
+ <programlisting>
+ ${MASTER_SITE_GNU:=subdirectory/name/}
+ ${MASTER_SITE_SOURCEFORGE:=project_name/}</programlisting>
+
+ <para>サブディレクトリー名の後のスラッシュ/に注意してください。</para>
+
+ <para>パッケージに複数の
+ <varname>DISTFILES</varname>または複数の
+ <varname>PATCHFILES</varname>があって、それらの配布元サ
+ イトが異なる場合は、<varname>SITES_foo</varname>を、ファイル
+ <quote>foo</quote>があるURIを列挙したものに設定
+ します。<quote>foo</quote>にはサフィックスを含めます。たとえば以下のようにします。</para>
+ <programlisting>DISTFILES= ${DISTNAME}${EXTRACT_SUFX}
+DISTFILES+= foo-file.tar.gz
+SITES_foo-file.tar.gz=http://www.somewhere.com/somehow/ \
+ http://www.somewhereelse.com/mirror/somehow/</programlisting>
+ </listitem>
+
+ <listitem><para><varname>DISTFILES</varname>: 配布物を含んでいるアーカイブファイルのファイル名です。
+ 標準では
+ <filename>${DISTNAME}${EXTRACT_SUFX}</filename> になります。
+ 複数の配布ファイルを使う場合に限り、設定するものです。</para>
+ <para>なお、通常おこなうような、<varname>DISTFILES</varname>へのファイルの(置換ではなく)追加をする場
+ 合は、標準的な<varname>DISTFILES</varname>のデフォルト設定を明示的におこなわなければなりません。</para>
+ </listitem>
+
+ <listitem><para><varname>EXTRACT_SUFX</varname>: 配布ファイルのサフィックスで、
+ <varname>DISTNAME</varname> の後につけられます。標準では
+ <filename>.tar.gz</filename> になります。
+ </para>
+ </listitem>
</itemizedlist>
</para>
- <para>二つ目の節には、以下に掲げる変数を書きます。
+ <para>二つ目の節には、別途ダウンロードするパッチがある場合に、
+ そのパッチに関する情報を書きます。
+ <itemizedlist>
+ <listitem><para><varname>PATCHFILES</varname>
+ 配布されているパッチを含んでいる、追加ファイルのファイル名です。
+ 標準の値はありません。pkgsrc はこのファイルを
+ <varname>PATCH_SITES</varname> から探します。
+ ファイル名の末尾が <filename>.gz</filename> または
+ <filename>.Z</filename> の場合は、
+ パッチ適用前に自動的に伸長されます。</para>
+ </listitem>
+ <listitem><para><varname>PATCH_SITES</varname>:
+ 配布されているパッチファイル (上述の
+ <varname>PATCHFILES</varname> を参照) がローカルにない場合用の、主な配布場所です。</para>
+ </listitem>
+ </itemizedlist>
+ </para>
+ <para>三つ目の節には、以下に掲げる変数を書きます。
<itemizedlist>
- <listitem><para><varname>MAINTAINER</varname> は当該パッケージのメンテナー
- (パッケージが動作しない場合の連絡先となる人)
- のメールアドレスです。</para></listitem>
+ <listitem><para><varname>MAINTAINER</varname> は、
+ 当該パッケージに関する連絡先となる人の電子メールアドレスです。
+ このパッケージに関する責任があると思っている人で、
+ &man.send-pr.1; を使って報告された問題や質問の面倒をもっともよく見そうな人にします。
+ パッケージに大幅な変更を加える際に、事前に連絡すべき人として適切な人です。
+ 新しいプログラムをパッケージ化する場合は、
+ <varname>MAINTAINER</varname> をあなた自身に設定してください。
+ そのパッケージを将来の更新に応じて保守することがどうしてもできない場合は、
+ <email>tech-pkg@NetBSD.org</email> に設定します。</para>
+ </listitem>
<listitem><para><varname>HOMEPAGE</varname> は、当該パッケージについて、
利用者がより詳しい情報を得られる URL です。</para></listitem>
<listitem><para><varname>COMMENT</varname> は、
- 当該パッケージの用途についての一行説明です。</para></listitem>
-
+ 当該パッケージについての一行説明です
+ (パッケージ名は含めません)。</para></listitem>
</itemizedlist>
</para>
- <para><varname>MASTER_SITES</varname>は、定義済みのサイトの一つをセットすることもできます。</para>
-
-<!-- sort bsd.sites.mk | sed -n 's/\(^MA[A-Z_]*\).*/ ${\1}/p' -->
- <programlisting>
- ${MASTER_SITE_APACHE}
- ${MASTER_SITE_BACKUP}
- ${MASTER_SITE_CYGWIN}
- ${MASTER_SITE_DEBIAN}
- ${MASTER_SITE_FREEBSD}
- ${MASTER_SITE_FREEBSD_LOCAL}
- ${MASTER_SITE_GNOME}
- ${MASTER_SITE_GNU}
- ${MASTER_SITE_GNUSTEP}
- ${MASTER_SITE_IFARCHIVE}
- ${MASTER_SITE_MOZILLA}
- ${MASTER_SITE_OPENOFFICE}
- ${MASTER_SITE_PERL_CPAN}
- ${MASTER_SITE_R_CRAN}
- ${MASTER_SITE_SOURCEFORGE}
- ${MASTER_SITE_SUNSITE}
- ${MASTER_SITE_SUSE}
- ${MASTER_SITE_TEX_CTAN}
- ${MASTER_SITE_XCONTRIB}
- ${MASTER_SITE_XEMACS}
- </programlisting>
-
- <para>もしこれらの予め定義されたサイトの1つを選んだ場合、そのサイトのサブディレク
- トリーを指定する方法が必要となるかもしれません。これらのマクロは複数の実際
- のサイトに展開されるかもしれませんので、サブディレクトリーを指定する場合は、
- 以下の表記を<emphasis>使わなければなりません</emphasis>:</para>
-
- <programlisting>
- ${MASTER_SITE_GNU:=subdirectory/name/}
- ${MASTER_SITE_SOURCEFORGE:=project_name/} </programlisting>
-
- <para>サブディレクトリー名の後のスラッシュ/に注意してください。</para>
-
- <note>
- <para><varname>MASTER_SITE_SUBDIR</varname> は廃止されましたので、
- <emphasis>もう使わないでください</emphasis>。</para>
- </note>
-
- <para>パッケージに複数の<varname>DISTFILES</varname>または複数の
- <varname>PATCHFILES</varname>があって、それらの配布元サ
- イトが異なる場合は、<varname>SITES_foo</varname>を、ファイル
- <quote>foo</quote>があるURIを列挙したものに設定
- します。<quote>foo</quote>にはサフィックスを含めます。たとえば以下のようにします。</para>
-
-<programlisting>DISTFILES= ${DISTNAME}${EXTRACT_SUFX}
-DISTFILES+= foo-file.tar.gz
-SITES_foo-file.tar.gz=http://www.somewhere.com/somehow/ \
- http://www.somewhereelse.com/mirror/somehow/</programlisting>
-
- <para>なお、通常おこなうような、<varname>DISTFILES</varname>へのファイルの(置換ではなく)追加をする場
- 合は、標準的な<varname>DISTFILES</varname>のデフォルト設定を明示的におこなわなければなりません。</para>
-
- <para>現在<varname>CATEGORIES</varname>の値として以下が使用できます。もし複数にまたがる場合、それら
- の値はスペースで分けられる必要があります:</para>
-
- <programlisting>
-archivers cross geography meta-pkgs security
-audio databases graphics misc shells
-benchmarks devel ham multimedia sysutils
-biology editors inputmethod net textproc
-cad emulators lang news time
-chat finance mail parallel wm
-comms fonts math pkgtools www
-converters games mbone print x11</programlisting>
-
- <para> 以下の事柄に気を配ってください。: </para>
+ <para>このほか、構築に影響のある変数としては、以下のものがあります。
+ <itemizedlist>
+ <listitem><para><varname>WRKSRC</varname>:
+ <filename>${WRKDIR}</filename> のサブディレクトリーで、
+ 配布ファイルが実際に展開される場所です。標準では
+ <filename>${WRKDIR}/${DISTNAME}</filename> になります。
+ <varname>WRKSRC</varname> は、
+ パッケージが通常の慣習に従わない場合に設定するものであって、
+ サブディレクトリーとしてパッケージの名前を含めるようにします。</para>
+ </listitem>
+ </itemizedlist>
+ </para>
+ <para>以下の事柄に気を配ってください。</para>
<itemizedlist>
<listitem>
@@ -153,23 +196,6 @@
<xref linkend="faq.info-files"/>を参照してください。</para>
</listitem>
- <listitem>
- <para><varname>MAINTAINER</varname> をあなた自身に設定してください。
- そのパッケージを将来の更新に応じて保守することがどうしてもできない場合は、
- <email>tech-pkg@NetBSD.org</email> に設定します。</para>
- </listitem>
-
- <listitem>
- <para>もし問題のソフトウェアにホームページが存在するのであれば、
- <varname>MAINTAINER</varname>の後ろに
- <varname>HOMEPAGE</varname>を追加してください。
- <varname>HOMEPAGE</varname>の値はホームページのURLにしてください。</para>
- </listitem>
-
- <listitem>
- <para>パッケージの短い説明を、 (パッケージ名は含めずに)
- <varname>COMMENT</varname>変数に設定してください。</para>
- </listitem>
</itemizedlist>
</sect1>
@@ -347,12 +373,17 @@
<sect1 id="work-dir">
<title><filename>work*</filename></title>
- <para><command>make</command>とタイプした時に、配布ファイルがこのディレクトリーに展開されます。
+ <para><command>make</command>とタイプした時に、配布ファイルが
+ <varname>WRKDIR</varname> で示されたディレクトリーに展開されます。
<command>make clean</command>
を実行すれば、これらを削除することができます。
このディレクトリーは、ソースの展開のほか、
- さまざまなタイムスタンプファイルを作っておくためにも使用されます。</para>
-
+ さまざまなタイムスタンプファイルを作っておくためにも使用されます。
+ これらも、clean によって<emphasis>完全に削除されます</emphasis>。
+ 標準では <filename>${.CURDIR}/work</filename>
+ (<varname>OBJMACHINE</varname> が設定されている場合は
+ <filename>${.CURDIR}/work.${MACHINE_ARCH}</filename>) です。</para>
+
<para> パッケージが例えばGNUソフトウェアのようにサブディレクトリーを作るのではなく、
カレントディレクトリーに展開される場合、適宜 <varname>WRKSRC</varname>
を設定します。例はもう一度<filename role="pkg">editors/sam</filename>を見てください。
@@ -360,10 +391,8 @@
<programlisting>WRKSRC= ${WRKDIR}</programlisting>
- <para> なお、以前使われていた <varname>NO_WRKSUBDIR</varname>
- は廃止されましたので、もう使わないでください。
- また、パッケージが <varname>DISTNAME</varname> と同名のサブディレクトリーは作らずに、
- 別の名前のサブディレクトリーを作る場合も、
+ <para>パッケージが <varname>DISTNAME</varname> と同名のサブディレクトリーは作らずに、
+ 別の名前のサブディレクトリーを作る場合は、
<varname>WRKSRC</varname> を設定して
<filename>${WRKDIR}</filename> 内の適切な名前を指すようにします。
例としては <filename
Index: components.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/components.xml,v
retrieving revision 1.9
retrieving revision 1.11
diff -u -r1.9 -r1.11
--- components.xml 27 Jul 2005 21:29:50 -0000 1.9
+++ components.xml 3 Aug 2005 16:34:19 -0000 1.11
@@ -1,4 +1,4 @@
-<!-- $NetBSD: components.xml,v 1.9 2005/07/27 21:29:50 rpaulo Exp $ -->
+<!-- $NetBSD: components.xml,v 1.11 2005/08/03 16:34:19 wiz Exp $ -->
<chapter id="components"> <?dbhtml filename="components.html"?>
<title>Package components - files, directories and contents</title>
@@ -37,106 +37,153 @@
dashes, underscores, dots and plus signs.</para></listitem>
<listitem><para><varname>CATEGORIES</varname> is a list of categories
- which the package fits in. You can choose any of the top-level
- directories of pkgsrc for it.</para></listitem>
+ which the package fits in. You can choose any of the top-level
+ directories of pkgsrc for it.</para>
- <listitem><para><varname>MASTER_SITES</varname> is a list of URLs where
- the distribution files can be downloaded. Each URL must end with a
- slash.</para></listitem>
+ <para>Currently the following values are available for
+ <varname>CATEGORIES</varname>. If more than
+ one is used, they need to be separated by spaces:</para>
+ <programlisting>
+archivers cross geography meta-pkgs security
+audio databases graphics misc shells
+benchmarks devel ham multimedia sysutils
+biology editors inputmethod net textproc
+cad emulators lang news time
+chat finance mail parallel wm
+comms fonts math pkgtools www
+converters games mbone print x11</programlisting>
+ </listitem>
+
+ <listitem><para><varname>MASTER_SITES</varname> is a list of URLs where
+ the distribution files can be downloaded. Each URL must end with a
+ slash.</para>
+ <para>The <varname>MASTER_SITES</varname> may make use of
+ the following predefined sites:</para>
+
+<!-- sort bsd.sites.mk | sed -n 's/\(^MA[A-Z_]*\).*/ ${\1}/p' -->
+ <programlisting>
+ ${MASTER_SITE_APACHE}
+ ${MASTER_SITE_BACKUP}
+ ${MASTER_SITE_CYGWIN}
+ ${MASTER_SITE_DEBIAN}
+ ${MASTER_SITE_FREEBSD}
+ ${MASTER_SITE_FREEBSD_LOCAL}
+ ${MASTER_SITE_GNOME}
+ ${MASTER_SITE_GNU}
+ ${MASTER_SITE_GNUSTEP}
+ ${MASTER_SITE_IFARCHIVE}
+ ${MASTER_SITE_MOZILLA}
+ ${MASTER_SITE_OPENOFFICE}
+ ${MASTER_SITE_PERL_CPAN}
+ ${MASTER_SITE_R_CRAN}
+ ${MASTER_SITE_SOURCEFORGE}
+ ${MASTER_SITE_SUNSITE}
+ ${MASTER_SITE_SUSE}
+ ${MASTER_SITE_TEX_CTAN}
+ ${MASTER_SITE_XCONTRIB}
+ ${MASTER_SITE_XEMACS}
+ </programlisting>
+
+ <para>If one of these predefined sites is chosen, you may
+ want to specify a subdirectory of that
+ site. Since these macros may expand to more than one
+ actual site, you <emphasis>must</emphasis> use the
+ following construct to specify a subdirectory:</para>
+
+ <programlisting>
+ ${MASTER_SITE_GNU:=subdirectory/name/}
+ ${MASTER_SITE_SOURCEFORGE:=project_name/}</programlisting>
+
+ <para>Note the trailing slash after the subdirectory name.</para>
+
+ <para>If the package has multiple
+ <varname>DISTFILES</varname> or multiple
+ <varname>PATCHFILES</varname> from different
+ sites, set <varname>SITES_foo</varname> to a list of URI's
+ where file <quote>foo</quote> may be
+ found. <quote>foo</quote> includes the suffix, e.g.</para>
+ <programlisting>DISTFILES= ${DISTNAME}${EXTRACT_SUFX}
+DISTFILES+= foo-file.tar.gz
+SITES_foo-file.tar.gz=http://www.somewhere.com/somehow/ \
+ http://www.somewhereelse.com/mirror/somehow/</programlisting>
+ </listitem>
+
+ <listitem><para><varname>DISTFILES</varname>: Name(s)
+ of archive file(s) containing distribution. The default is
+ <filename>${DISTNAME}${EXTRACT_SUFX}</filename>. Should only
+ be set if you have more than one distfile.</para>
+ <para>Note that the normal default setting of
+ <varname>DISTFILES</varname> must be made explicit if you
+ want to add to it (rather than replace it), as you usually
+ would.</para>
+ </listitem>
+
+ <listitem><para><varname>EXTRACT_SUFX</varname>: Suffix of the
+ distribution file, will be appended to
+ <varname>DISTNAME</varname>. Defaults to
+ <filename>.tar.gz</filename>.
+ </para>
+ </listitem>
</itemizedlist>
</para>
- <para>The second section contains the following variables.
+ <para>The second section contains information about separately
+ downloaded patches, if any.
+ <itemizedlist>
+ <listitem><para><varname>PATCHFILES</varname>
+ Name(s) of additional files that contain distribution patches.
+ There is no default. pkgsrc will look for them at
+ <varname>PATCH_SITES</varname>.
+ They will automatically be uncompressed before patching if
+ the names end with <filename>.gz</filename> or
+ <filename>.Z</filename>.</para>
+ </listitem>
+ <listitem><para><varname>PATCH_SITES</varname>:
+ Primary location(s) for distribution patch files (see
+ <varname>PATCHFILES</varname> below) if not found locally.</para>
+ </listitem>
+ </itemizedlist>
+ </para>
+ <para>The third section contains the following variables.
<itemizedlist>
- <listitem><para><varname>MAINTAINER</varname> is the mail address of the
- package's maintainer, which is the person you can contact when the
- package does not work.</para></listitem>
+ <listitem><para><varname>MAINTAINER</varname> is the email address of the
+ contact person for this package.
+ The person who feels responsible for this package, and who is most
+ likely to look at problems or questions regarding this package
+ which have been reported with &man.send-pr.1;. The right
+ person to contact before making major changes to the
+ package.
+ When packaging a new program, set
+ <varname>MAINTAINER</varname> to yourself. If you really
+ can't maintain the package for future updates, set it to
+ <email>tech-pkg@NetBSD.org</email>.</para>
+ </listitem>
<listitem><para><varname>HOMEPAGE</varname> is a URL where users can
find more information about the package.</para></listitem>
- <listitem><para><varname>COMMENT</varname> is a one-line comment about
- the purpose of the package.</para></listitem>
-
+ <listitem><para><varname>COMMENT</varname> is a one-line
+ description of the package (should not include the package
+ name).</para></listitem>
</itemizedlist>
</para>
- <para>The <varname>MASTER_SITES</varname> may be set to one of the
- predefined sites:</para>
-
-<!-- sort bsd.sites.mk | sed -n 's/\(^MA[A-Z_]*\).*/ ${\1}/p' -->
- <programlisting>
- ${MASTER_SITE_APACHE}
- ${MASTER_SITE_BACKUP}
- ${MASTER_SITE_CYGWIN}
- ${MASTER_SITE_DEBIAN}
- ${MASTER_SITE_FREEBSD}
- ${MASTER_SITE_FREEBSD_LOCAL}
- ${MASTER_SITE_GNOME}
- ${MASTER_SITE_GNU}
- ${MASTER_SITE_GNUSTEP}
- ${MASTER_SITE_IFARCHIVE}
- ${MASTER_SITE_MOZILLA}
- ${MASTER_SITE_OPENOFFICE}
- ${MASTER_SITE_PERL_CPAN}
- ${MASTER_SITE_R_CRAN}
- ${MASTER_SITE_SOURCEFORGE}
- ${MASTER_SITE_SUNSITE}
- ${MASTER_SITE_SUSE}
- ${MASTER_SITE_TEX_CTAN}
- ${MASTER_SITE_XCONTRIB}
- ${MASTER_SITE_XEMACS}
- </programlisting>
-
- <para>If one of these predefined sites is chosen, you may require the
- ability to specify a subdirectory of that site. Since these macros
- may expand to more than one actual site, you
- <emphasis>must</emphasis> use the following construct to specify a
- subdirectory:</para>
-
- <programlisting>
- ${MASTER_SITE_GNU:=subdirectory/name/}
- ${MASTER_SITE_SOURCEFORGE:=project_name/} </programlisting>
-
- <para>Note the trailing slash after the subdirectory name.</para>
-
- <note>
- <para><varname>MASTER_SITE_SUBDIR</varname> has been deprecated and
- <emphasis>should no longer be used</emphasis>.</para>
- </note>
-
- <para>If the package has multiple <varname>DISTFILES</varname> or multiple
- <varname>PATCHFILES</varname> from different
- sites, set <varname>SITES_foo</varname> to a list of URI's where file
- <quote>foo</quote> may be found. <quote>foo</quote>
- includes the suffix, e.g.</para>
-
-<programlisting>DISTFILES= ${DISTNAME}${EXTRACT_SUFX}
-DISTFILES+= foo-file.tar.gz
-SITES_foo-file.tar.gz=http://www.somewhere.com/somehow/ \
- http://www.somewhereelse.com/mirror/somehow/</programlisting>
-
- <para>Note that the normal default setting of <varname>DISTFILES</varname>
- must be made explicit if you want to add to it (rather than replace
- it), as you usually would.</para>
-
- <para>Currently the following values are available for
- <varname>CATEGORIES</varname>. If more than
- one is used, they need to be separated by spaces:</para>
-
- <programlisting>
-archivers cross geography meta-pkgs security
-audio databases graphics misc shells
-benchmarks devel ham multimedia sysutils
-biology editors inputmethod net textproc
-cad emulators lang news time
-chat finance mail parallel wm
-comms fonts math pkgtools www
-converters games mbone print x11</programlisting>
-
- <para> Please pay attention to the following gotchas: </para>
+ <para>Other variables that affect the build:
+ <itemizedlist>
+ <listitem><para><varname>WRKSRC</varname>:
+ The subdirectory of <filename>${WRKDIR}</filename> to which
+ the distribution actually unpacks. The default is
+ <filename>${WRKDIR}/${DISTNAME}</filename>.
+ The value of <varname>WRKSRC</varname> should be set
+ explicitly if the package does not follow standard
+ conventions and include the package's name as a
+ subdirectory.</para>
+ </listitem>
+ </itemizedlist>
+ </para>
+ <para>Please pay attention to the following gotchas:</para>
<itemizedlist>
<listitem>
@@ -155,23 +202,6 @@
<xref linkend="faq.info-files"/>.</para>
</listitem>
- <listitem>
- <para>Set <varname>MAINTAINER</varname> to be yourself.
- If you really can't maintain the package for future updates,
- set it to <email>tech-pkg@NetBSD.org</email>.</para>
- </listitem>
-
- <listitem>
- <para>If a home page for the software in question exists,
- add the variable <varname>HOMEPAGE</varname> right after
- <varname>MAINTAINER</varname>. The value of this
- variable should be the URL for the home page.</para>
- </listitem>
-
- <listitem>
- <para>Be sure to set the <varname>COMMENT</varname> variable to a short
- description of the package, not containing the pkg's name.</para>
- </listitem>
</itemizedlist>
</sect1>
@@ -357,21 +387,24 @@
<title><filename>work*</filename></title>
<para>When you type <command>make</command> the distribution files are
- unpacked into this directory. It can be removed by running
+ unpacked into the directory denoted by
+ <varname>WRKDIR</varname>. It can be removed by running
<command>make clean</command>. Besides the sources, this
- directory is also used to keep various timestamp files.</para>
-
+ directory is also used to keep various timestamp files.
+ The directory gets <emphasis>removed completely</emphasis> on clean.
+ The default is <filename>${.CURDIR}/work</filename>
+ or <filename>${.CURDIR}/work.${MACHINE_ARCH}</filename>
+ if <varname>OBJMACHINE</varname> is set.</para>
+
<para> If a package doesn't create a subdirectory for itself (like
- GNU software does, for instance), but extracts itself in the
- current directory, you should set <varname>WRKSRC</varname>
- accordingly, e.g. <filename role="pkg">editors/sam</filename>
- again, but the quick answer is: </para>
+ GNU software does, for instance), but extracts itself in the
+ current directory, you should set <varname>WRKSRC</varname>
+ accordingly, e.g. <filename role="pkg">editors/sam</filename>
+ again, but the quick answer is:</para>
<programlisting>WRKSRC= ${WRKDIR}</programlisting>
- <para> Please note that the old <varname>NO_WRKSUBDIR</varname>
- has been deprecated and should not be used. Also, if your
- package doesn't create a subdir with the name of
+ <para>If a package doesn't create a subdir with the name of
<varname>DISTNAME</varname> but some different name, set
<varname>WRKSRC</varname> to point to the proper name in
<filename>${WRKDIR}</filename>. See <filename