[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
pkgsrc/doc/guide/files/fixes.xml: 1.16 -> 1.17
以下のページの更新をしました。ツッコミをお願いします。
pkgsrc/doc/guide/files/fixes.xml: 1.16 -> 1.17
> revision 1.17
> date: 2005/05/29 09:10:42; author: wiz; state: Exp; lines: +18 -11
> Update section on what to do when distfiles change.
水曜日までに異議がなければ、 commit します。
以下、訳と原文それぞれの新旧の差分です。
--- fixes.xml.orig 2006-09-19 22:44:37.000000000 +0900
+++ fixes.xml 2006-09-19 22:44:37.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: fixes.xml,v 1.16 2005/05/26 16:32:42 wiz Exp $ -->
+<!-- $NetBSD: fixes.xml,v 1.17 2005/05/29 09:10:42 wiz Exp $ -->
<!-- Based on english version: -->
-<!-- NetBSD: fixes.xml,v 1.16 2005/05/26 16:32:42 wiz Exp -->
+<!-- NetBSD: fixes.xml,v 1.17 2005/05/29 09:10:42 wiz Exp -->
<chapter id="fixes"> <?dbhtml filename="fixes.html"?>
<title>パッケージの修正に関する注意</title>
@@ -434,13 +434,22 @@
<para> 時々、ソフトウェアパッケージの作者がソフトウェアのリリース後に変更を加え、
変更後のdistfileを、バージョン番号を変えずに公開することがあります。このと
- き、pkgsrcにそのパッケージがすでに入っていると、md5チェックサムが一致しない
- ことになります。この問題の正しい回避策は、パッケージのmd5チェックサムをマス
- ターサイト(ミラーサイトでは更新されていないことがあります!)のパッケージに合
- わせて変更し、古いdistfileを ftp.NetBSD.org の<filename>/pub/NetBSD/packages/distfiles</filename>
- ディレクトリーから削除することです。さらに、パッケージの正当な作者にメール
- を出して、distfileの更新が意図されたものであって、トロイの木馬などが仕込ま
- れたのではないことを確認します。 </para>
+ き、pkgsrcにそのパッケージがすでに入っていると、チェックサムが一致しない
+ ことになります。distfileの更新が意図されたものであって、
+ トロイの木馬などが仕込まれたのではないことを確認するため、
+ 新しい distfile の内容と変更前の古い distfile の内容と比較してください。
+ 確認後、この問題の正しい回避策は、<varname>DIST_SUBDIR</varname>
+ を一意な (普通は <varname>PKGNAME_NOREV</varname>
+ にもとづく) ディレクトリー名に設定することです。
+ この問題が起こりにくくするために、<varname>PKGNAME</varname> を使ったり
+ (これにより <filename>nbX</filename> サフィックスが含まれる)、
+ <varname>${PKGNAME_NOREV}-YYYYMMDD</varname> のように日付を付けたりすることができます。
+ 設定後は、<filename>distinfo</filename> ファイルを作り直すのを忘れないでください。
+ このファイルでは、ファイル名のなかに <varname>DIST_SUBDIR</varname>
+ パスが含まれているからです。
+ さらに、パッケージの正当な作者にメールを出して、
+ リリース後に、ファイル名を変えずに
+ distfile の内容を変えるのはよろしくないやり方だと伝えてください。 </para>
</sect2>
</sect1>
Index: fixes.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/fixes.xml,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- fixes.xml 26 May 2005 16:32:42 -0000 1.16
+++ fixes.xml 29 May 2005 09:10:42 -0000 1.17
@@ -1,4 +1,4 @@
-<!-- $NetBSD: fixes.xml,v 1.16 2005/05/26 16:32:42 wiz Exp $ -->
+<!-- $NetBSD: fixes.xml,v 1.17 2005/05/29 09:10:42 wiz Exp $ -->
<chapter id="fixes"> <?dbhtml filename="fixes.html"?>
<title>Notes on fixes for packages</title>
@@ -475,16 +475,23 @@
<para> Sometimes authors of a software package make some
modifications after the software was released, and they put up a
new distfile without changing the package's version number. If a
- package is already in pkgsrc at that time, the md5 checksum will
- no longer match. The correct way to work around this is to
- update the package's md5 checksum to match the package on the
- master site (beware, any mirrors may not be up to date yet!),
- and to remove the old distfile from
- ftp.NetBSD.org's
- <filename>/pub/NetBSD/packages/distfiles</filename> directory.
- Furthermore, a mail to the package's author seems appropriate
- making sure the distfile was really updated on purpose, and that
- no trojan horse or so crept in. </para>
+ package is already in pkgsrc at that time, the checksum will
+ no longer match. The contents of the new distfile should be
+ 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.
+ 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>. 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.
+ 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>
</sect2>
</sect1>