[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
pkgsrc/doc/guide/files/components.xml: 1.25 -> 1.26
以下のページの更新をしました。ツッコミをお願いします。
pkgsrc/doc/guide/files/components.xml: 1.25 -> 1.26
> revision 1.26
> date: 2006/07/24 10:32:36; author: rillig; state: Exp; lines: +11 -78
> Moved the explanation of the various variables in the "fetch" phase from
> components.xml to build.xml. Added a list of variable names and a link
> to the old place. Rewrote and extended the existing documentation to
> cover most common cases.
木曜日までに異議がなければ、 commit します。
以下、訳と原文それぞれの新旧の差分です。
--- components.xml.orig 2006-12-06 07:21:43.000000000 +0900
+++ components.xml 2006-12-06 07:21:43.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: components.xml,v 1.25 2006/06/25 10:33:33 rillig Exp $ -->
+<!-- $NetBSD: components.xml,v 1.26 2006/07/24 10:32:36 rillig Exp $ -->
<!-- Based on english version: -->
-<!-- NetBSD: components.xml,v 1.25 2006/06/25 10:33:33 rillig Exp -->
+<!-- NetBSD: components.xml,v 1.26 2006/07/24 10:32:36 rillig Exp -->
<chapter id="components"> <?dbhtml filename="components.html"?>
<title>パッケージコンポーネント - ファイル、ディレクトリー、およびコンテンツ</title>
@@ -22,7 +22,10 @@
当該パッケージについて記述した、複数の節からなっています。</para>
<para>最初の節には、以下に掲げる変数を書きます。
- これらは以下に掲げたままの順で並べるようにします。
+ これらは以下に掲げたままの順で並べるようにします。
+ このような変数の順序や節へのまとめ方は、ほとんど歴史的なものであって、
+ それ以上の意味はありません。</para>
+
<itemizedlist>
<listitem><para><varname>DISTNAME</varname> は、当該パッケージの
@@ -57,79 +60,13 @@
</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>
+ <listitem><para><varname>MASTER_SITES</varname>,
+ <varname>DYNAMIC_MASTER_SITES</varname>,
+ <varname>DIST_SUBDIR</varname>, <varname>EXTRACT_SUFX</varname>,
+ <varname>DISTFILES</varname> の各変数については、
+ <xref linkend="build.fetch"/>で詳しく論じます。</para></listitem>
-<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>
+ </itemizedlist>
<para>二つ目の節には、別途ダウンロードするパッチがある場合に、
そのパッチに関する情報を書きます。
Index: components.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/components.xml,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -r1.25 -r1.26
--- components.xml 25 Jun 2006 10:33:33 -0000 1.25
+++ components.xml 24 Jul 2006 10:32:36 -0000 1.26
@@ -1,4 +1,4 @@
-<!-- $NetBSD: components.xml,v 1.25 2006/06/25 10:33:33 rillig Exp $ -->
+<!-- $NetBSD: components.xml,v 1.26 2006/07/24 10:32:36 rillig Exp $ -->
<chapter id="components"> <?dbhtml filename="components.html"?>
<title>Package components - files, directories and contents</title>
@@ -21,7 +21,10 @@
sections that describe the package.</para>
<para>In the first section there are the following variables, which
- should appear exactly in the order given here.
+ should appear exactly in the order given here. The ordering and
+ grouping of variables is mostly historical and has no further
+ meaning.</para>
+
<itemizedlist>
<listitem><para><varname>DISTNAME</varname> is the basename of the
@@ -56,83 +59,13 @@
</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 URIs
- where file <quote>foo</quote> may be
- found. <quote>foo</quote> includes the suffix, e.g.:</para>
+ <listitem><para><varname>MASTER_SITES</varname>,
+ <varname>DYNAMIC_MASTER_SITES</varname>,
+ <varname>DIST_SUBDIR</varname>, <varname>EXTRACT_SUFX</varname>
+ and <varname>DISTFILES</varname> are discussed in detail in
+ <xref linkend="build.fetch"/>.</para></listitem>
-<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>
+ </itemizedlist>
<para>The second section contains information about separately
downloaded patches, if any.