[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
pkgsrc/doc/guide/files/fixes.xml: 1.19 -> 1.20
以下のページの更新をしました。ツッコミをお願いします。
pkgsrc/doc/guide/files/fixes.xml: 1.19 -> 1.20
> revision 1.20
> date: 2005/06/03 16:09:11; author: reed; state: Exp; lines: +20 -8
> Document IGNORE_RECOMMENDED=YES. This includes sentences from tv@
> that I read on tech-pkg@.
火曜日までに異議がなければ、 commit します。
以下、訳と原文それぞれの新旧の差分です。
--- fixes.xml.orig 2006-10-02 01:01:01.000000000 +0900
+++ fixes.xml 2006-10-02 01:01:01.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: fixes.xml,v 1.19 2005/06/03 12:27:48 jmmv Exp $ -->
+<!-- $NetBSD: fixes.xml,v 1.20 2005/06/03 16:09:11 reed Exp $ -->
<!-- Based on english version: -->
-<!-- NetBSD: fixes.xml,v 1.19 2005/06/03 12:27:48 jmmv Exp -->
+<!-- NetBSD: fixes.xml,v 1.20 2005/06/03 16:09:11 reed Exp -->
<chapter id="fixes"> <?dbhtml filename="fixes.html"?>
<title>パッケージの修正に関する注意</title>
@@ -191,17 +191,29 @@
後者の場合は <varname>RECOMMENDED</varname> を使って推奨を示すことができます。 </para>
<programlisting>RECOMMENDED+= tiff>=3.6.1:../../graphics/tiff</programlisting>
-
+
<para> これを上述の <varname>DEPENDS</varname> 行に追加することで、
パッケージの構築は tiff>=3.5.4 でおこなうことができるが、
少なくともバージョン 3.6.1 を推奨するということを意味します。
<varname>RECOMMENDED</varname> の内容は、(警告が表示された際に)
- 明示的に無視された場合を除き、依存関係に反映されます。
- 推奨を無視して構築されたパッケージは、開発者が ftp.NetBSD.org
+ 明示的に無視された場合を除き、依存関係に反映されます。 </para>
+
+ <para>依存性に関するこの推奨を無視して、必須の
+ <varname>DEPENDS</varname> を使うだけにするには、
+ <varname>IGNORE_RECOMMENDED=YES</varname> を設定します。
+ こうすると、互換性のある古い依存性をそのまま使うことができるので、
+ pkgsrc を使って構築されたパッケージの更新が簡単かつ速くできるようになります。
+ これは、パッケージの再構築を念入りに観察する人にとっては便利な方法ですが、
+ 一般向けにはよろしくない方法です。
+ この方法を使う場合は、OS に由来するものも含めて、
+ 起こりうる ABI の変更に十分注意する必要があります。
+ </para>
+
+ <para> 推奨を無視して構築されたパッケージは、開発者が ftp.NetBSD.org
へアップロードしてはいけません。また、そのようなパッケージを別のシステムで使うと、
別バージョンのバイナリーパッケージが複数インストールされる可能性があるので、
そのようなこともしないようにしてください。 </para>
-
+
<para> セキュリティー上の修正があった場合は、<varname>RECOMMENDED</varname>
を設定するとともに、パッケージ脆弱性ファイルを更新してください。
さらなる情報は、<xref
Index: fixes.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/fixes.xml,v
retrieving revision 1.19
retrieving revision 1.20
diff -u -r1.19 -r1.20
--- fixes.xml 3 Jun 2005 12:27:48 -0000 1.19
+++ fixes.xml 3 Jun 2005 16:09:11 -0000 1.20
@@ -1,4 +1,4 @@
-<!-- $NetBSD: fixes.xml,v 1.19 2005/06/03 12:27:48 jmmv Exp $ -->
+<!-- $NetBSD: fixes.xml,v 1.20 2005/06/03 16:09:11 reed Exp $ -->
<chapter id="fixes"> <?dbhtml filename="fixes.html"?>
<title>Notes on fixes for packages</title>
@@ -214,18 +214,30 @@
<varname>RECOMMENDED</varname>: </para>
<programlisting>RECOMMENDED+= tiff>=3.6.1:../../graphics/tiff</programlisting>
-
+
<para> In addition to the above <varname>DEPENDS</varname>
line, this denotes that while a package will build against
tiff>=3.5.4, at least version 3.6.1 is recommended.
<varname>RECOMMENDED</varname> entries will be turned into
dependencies unless explicitly ignored (in which case a
- warning will be printed). Packages that are built with
- recommendations ignored may not be uploaded to
- ftp.NetBSD.org by developers and should not be used across
- different systems that may have different versions of binary
- packages installed. </para>
-
+ warning will be printed). </para>
+
+ <para>To ignore these dependency recommendations and just
+ use the required <varname>DEPENDS</varname>, set
+ <varname>IGNORE_RECOMMENDED=YES</varname>. This may make
+ it easier and faster to update packages built using pkgsrc,
+ since older compatible dependencies can continue to be
+ used. This is useful for people who watch their rebuilds
+ very carefully; it is not very good as a general-purpose
+ hammer. If you use it, you need to be mindful of possible
+ ABI changes, including those from the underlying OS.
+ </para>
+
+ <para> Packages that are built with recommendations ignored
+ may not be uploaded to ftp.NetBSD.org by developers and
+ should not be used across different systems that may have
+ different versions of binary packages installed. </para>
+
<para> For security fixes, please update the package
vulnerabilities file as well as setting
<varname>RECOMMENDED</varname>, see <xref