[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
pkgsrc/doc/guide/files/fixes.xml: 1.78 -> 1.80
以下のページの更新をしました。ツッコミをお願いします。
pkgsrc/doc/guide/files/fixes.xml: 1.78 -> 1.80
> revision 1.80
> date: 2007/02/19 15:22:29; author: reed; state: Exp; lines: +7 -2
> Some more details for whaty to do when a distfile changes.
> ----------------------------
> revision 1.79
> date: 2007/02/19 08:34:00; author: rillig; state: Exp; lines: +5 -3
> Platform and compiler-specific macros for MIPSpro on IRIX.
水曜日までに異議がなければ、 commit します。
以下、訳と原文それぞれの新旧の差分です。
--- fixes.xml.orig 2007-02-20 22:44:33.000000000 +0900
+++ fixes.xml 2007-02-20 22:44:33.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: fixes.xml,v 1.78 2006/12/15 13:22:14 martti Exp $ -->
+<!-- $NetBSD: fixes.xml,v 1.80 2007/02/19 15:22:29 reed Exp $ -->
<!-- Based on english version: -->
-<!-- NetBSD: fixes.xml,v 1.78 2006/12/15 13:22:14 martti Exp -->
+<!-- NetBSD: fixes.xml,v 1.80 2007/02/19 15:22:29 reed Exp -->
<chapter id="fixes"> <?dbhtml filename="fixes.html"?>
<title>パッケージを動くようにする</title>
@@ -649,12 +649,15 @@
ことになります。distfileの更新が意図されたものであって、
トロイの木馬などが仕込まれたのではないことを確認するため、
新しい distfile の内容と変更前の古い distfile の内容と比較してください。
+ 新旧の distfile を比較したことと、何が変わったのかを、
+ commit メッセージに含めてください。
確認後、この問題の正しい回避策は、<varname>DIST_SUBDIR</varname>
を一意な (普通は <varname>PKGNAME_NOREV</varname>
にもとづく) ディレクトリー名に設定することです。
これを設定すると、このパッケージの <varname>DISTFILES</varname> と
<varname>PATCHFILES</varname> はすべて、
distfiles ディレクトリー以下の、設定した名前のサブディレクトリーに置かれます。
+ (詳細は、<xref linkend="bumping-pkgrevision"/>をご覧ください。)
この問題がよく起きる場合は、ディレクトリー名に
<varname>PKGNAME</varname> を使ったり
(これにより <filename>nbX</filename> サフィックスが含まれる)、
@@ -662,6 +665,8 @@
設定後は、<filename>distinfo</filename> ファイルを作り直すのを忘れないでください。
このファイルでは、ファイル名のなかに <varname>DIST_SUBDIR</varname>
パスが含まれているからです。
+ この変更によって、インストールされるパッケージが以前のものと異なるものになる場合は、
+ PKGREVISION も上げます。
さらに、パッケージの正当な作者にメールを出して、
リリース後に、ファイル名を変えずに
distfile の内容を変えるのはよろしくないやり方だと伝えてください。</para>
@@ -1050,6 +1055,7 @@
FreeBSD __FreeBSD__
DragonFly __DragonFly__
Interix __INTERIX
+ IRIX __sgi (TODO: 出典の確認)
Linux linux, __linux, __linux__
NetBSD __NetBSD__
OpenBSD __OpenBSD__
@@ -1072,8 +1078,9 @@
<programlisting>
GCC __GNUC__ (メジャーバージョン), __GNUC_MINOR__
- SunPro __SUNPRO_C (バージョン 5.7 なら 0x570)
- SunPro C++ __SUNPRO_CC (バージョン 5.8 なら 0x580)
+ MIPSpro _COMPILER_VERSION (MIPSpro 7.41 なら 0x741)
+ SunPro __SUNPRO_C (Sun C 5.7 なら 0x570)
+ SunPro C++ __SUNPRO_CC (Sun C++ 5.8 なら 0x580)
</programlisting>
</sect3>
Index: fixes.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/fixes.xml,v
retrieving revision 1.78
retrieving revision 1.80
diff -u -r1.78 -r1.80
--- fixes.xml 15 Dec 2006 13:22:14 -0000 1.78
+++ fixes.xml 19 Feb 2007 15:22:29 -0000 1.80
@@ -1,4 +1,4 @@
-<!-- $NetBSD: fixes.xml,v 1.78 2006/12/15 13:22:14 martti Exp $ -->
+<!-- $NetBSD: fixes.xml,v 1.80 2007/02/19 15:22:29 reed Exp $ -->
<chapter id="fixes"> <?dbhtml filename="fixes.html"?>
<title>Making your package work</title>
@@ -675,18 +675,23 @@
compared against the old one before changing anything, to make
sure the distfile was really updated on purpose, and that
no trojan horse or so crept in.
+ Please mention that the distfiles were compared and what was found
+ in your commit message.
Then, the correct way to work around this is to
set <varname>DIST_SUBDIR</varname> to a unique directory name,
usually based on <varname>PKGNAME_NOREV</varname>. All
<varname>DISTFILES</varname> and
<varname>PATCHFILES</varname> for this package will be put in that
- subdirectory of the local distfiles directory. In case this
+ subdirectory of the local distfiles directory.
+ (See <xref linkend="bumping-pkgrevision"/> for more details.)
+ In case this
happens more often, <varname>PKGNAME</varname> can be used (thus
including the <filename>nbX</filename> suffix) or a date stamp
can be appended, like <varname>${PKGNAME_NOREV}-YYYYMMDD</varname>.
Do not forget regenerating the <filename>distinfo</filename> file
after that, since it contains the <varname>DIST_SUBDIR</varname>
path in the filenames.
+ Also increase the PKGREVISION if the installed package is different.
Furthermore, a mail to the package's authors seems appropriate
telling them that changing distfiles after releases without
changing the file names is not good practice.</para>
@@ -1088,6 +1093,7 @@
FreeBSD __FreeBSD__
DragonFly __DragonFly__
Interix __INTERIX
+ IRIX __sgi (TODO: get a definite source for this)
Linux linux, __linux, __linux__
NetBSD __NetBSD__
OpenBSD __OpenBSD__
@@ -1110,8 +1116,9 @@
<programlisting>
GCC __GNUC__ (major version), __GNUC_MINOR__
- SunPro __SUNPRO_C (0x570 for version 5.7)
- SunPro C++ __SUNPRO_CC (0x580 for version 5.8)
+ MIPSpro _COMPILER_VERSION (0x741 for MIPSpro 7.41)
+ SunPro __SUNPRO_C (0x570 for Sun C 5.7)
+ SunPro C++ __SUNPRO_CC (0x580 for Sun C++ 5.8)
</programlisting>
</sect3>