[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
pkgsrc/doc/guide/files/fixes.xml: 1.48 -> 1.49
以下のページの更新をしました。ツッコミをお願いします。
pkgsrc/doc/guide/files/fixes.xml: 1.48 -> 1.49
> revision 1.49
> date: 2006/04/06 06:21:57; author: reed; state: Exp; lines: +9 -14
> Over 1200 files touched but no revisions bumped :)
>
> RECOMMENDED is removed. It becomes ABI_DEPENDS.
>
> BUILDLINK_RECOMMENDED.foo becomes BUILDLINK_ABI_DEPENDS.foo.
>
> BUILDLINK_DEPENDS.foo becomes BUILDLINK_API_DEPENDS.foo.
>
> BUILDLINK_DEPENDS does not change.
>
> IGNORE_RECOMMENDED (which defaulted to "no") becomes USE_ABI_DEPENDS
> which defaults to "yes".
>
> Added to obsolete.mk checking for IGNORE_RECOMMENDED.
>
> I did not manually go through and fix any aesthetic tab/spacing issues.
>
> I have tested the above patch on DragonFly building and packaging
> subversion and pkglint and their many dependencies.
>
> I have also tested USE_ABI_DEPENDS=no on my NetBSD workstation (where I
> have used IGNORE_RECOMMENDED for a long time). I have been an active user
> of IGNORE_RECOMMENDED since it was available.
>
> As suggested, I removed the documentation sentences suggesting bumping for
> "security" issues.
>
> As discussed on tech-pkg.
>
> I will commit to revbump, pkglint, pkg_install, createbuildlink separately.
>
> Note that if you use wip, it will fail! I will commit to pkgsrc-wip
> later (within day).
木曜日までに異議がなければ、 commit します。
以下、訳と原文それぞれの新旧の差分です。
--- fixes.xml.orig 2006-11-08 22:29:10.000000000 +0900
+++ fixes.xml 2006-11-08 22:29:10.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: fixes.xml,v 1.48 2006/03/20 01:48:57 jlam Exp $ -->
+<!-- $NetBSD: fixes.xml,v 1.49 2006/04/06 06:21:57 reed Exp $ -->
<!-- Based on english version: -->
-<!-- NetBSD: fixes.xml,v 1.48 2006/03/20 01:48:57 jlam Exp -->
+<!-- NetBSD: fixes.xml,v 1.49 2006/04/06 06:21:57 reed Exp -->
<chapter id="fixes"> <?dbhtml filename="fixes.html"?>
<title>パッケージを動くようにする</title>
@@ -201,23 +201,23 @@
ではパッケージがコンパイルできないような場合に、構築できることを保証することができます。</para>
<para>なお、このような形式の依存関係は、新しい依存関係が必要となった場合のみに更新してください。
- セキュリティー上の更新あるいは ABI の変更などであって、構築自体は正常におこなうことができる場合、
+ ABI の変更などであって、構築自体は正常におこなうことができる場合、
その推奨のために依存関係を更新したりしないでください。
- 後者の場合は <varname>RECOMMENDED</varname> を使って推奨を示すことができます。</para>
+ 後者の場合は <varname>ABI_DEPENDS</varname> を使って推奨を示すことができます。</para>
<programlisting>
- RECOMMENDED+= tiff>=3.6.1:../../graphics/tiff
+ ABI_DEPENDS+= tiff>=3.6.1:../../graphics/tiff
</programlisting>
<para>これを上述の <varname>DEPENDS</varname> 行に追加することで、
パッケージの構築は tiff>=3.5.4 でおこなうことができるが、
少なくともバージョン 3.6.1 を推奨するということを意味します。
- <varname>RECOMMENDED</varname> の内容は、(警告が表示された際に)
+ <varname>ABI_DEPENDS</varname> の内容は、(警告が表示された際に)
明示的に無視された場合を除き、依存関係に反映されます。</para>
- <para>依存性に関するこの推奨を無視して、必須の
+ <para>ABI の依存性に関するこの推奨を無視して、必須の
<varname>DEPENDS</varname> を使うだけにするには、
- <varname>IGNORE_RECOMMENDED=YES</varname> を設定します。
+ <varname>USE_ABI_DEPENDS=NO</varname> を設定します。
こうすると、互換性のある古い依存性をそのまま使うことができるので、
pkgsrc を使って構築されたパッケージの更新が簡単かつ速くできるようになります。
これは、パッケージの再構築を念入りに観察する人にとっては便利な方法ですが、
@@ -231,8 +231,8 @@
別バージョンのバイナリーパッケージが複数インストールされる可能性があるので、
そのようなこともしないようにしてください。</para>
- <para>セキュリティー上の修正があった場合は、<varname>RECOMMENDED</varname>
- を設定するとともに、パッケージ脆弱性ファイルを更新してください。
+ <para>セキュリティー上の修正があった場合は、
+ パッケージ脆弱性ファイルを更新してください。
さらなる情報は、<xref
linkend="security-handling"/>を参照してください。</para>
</listitem>
@@ -347,10 +347,7 @@
<para>脆弱性の修正を、パッチの適用によっておこなった場合は、修正後に
<varname>PKGREVISION</varname> を上げます (もちろん、問題の修正を、
新しくリリースされたソフトウェアを使っておこなった場合は、
- これは必要ありません)。さらに、脆弱性の影響を受けるパッケージに
- <filename>buildlink3.mk</filename> ファイルが存在する場合は、対応する
- <varname>BUILDLINK_RECOMMENDED.<replaceable>pkg</replaceable></varname>
- エントリーを追加または更新してください。</para>
+ これは必要ありません)。</para>
<para>また、修正を安定版 pkgsrc 枝に適用したほうがよい場合は、
pullup 要求を提出してください。</para>
Index: fixes.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/fixes.xml,v
retrieving revision 1.48
retrieving revision 1.49
diff -u -r1.48 -r1.49
--- fixes.xml 20 Mar 2006 01:48:57 -0000 1.48
+++ fixes.xml 6 Apr 2006 06:21:57 -0000 1.49
@@ -1,4 +1,4 @@
-<!-- $NetBSD: fixes.xml,v 1.48 2006/03/20 01:48:57 jlam Exp $ -->
+<!-- $NetBSD: fixes.xml,v 1.49 2006/04/06 06:21:57 reed Exp $ -->
<chapter id="fixes"> <?dbhtml filename="fixes.html"?>
<title>Making your package work</title>
@@ -221,25 +221,25 @@
<para>Please note that such dependencies should only be
updated if a package requires a newer pre-requisite, but
- not to denote recommendations such as security updates or
+ not to denote recommendations such as
ABI changes that do not prevent a package from building
correctly. Such recommendations can be expressed using
- <varname>RECOMMENDED</varname>:</para>
+ <varname>ABI_DEPENDS</varname>:</para>
<programlisting>
- RECOMMENDED+= tiff>=3.6.1:../../graphics/tiff
+ ABI_DEPENDS+= 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
+ <varname>ABI_DEPENDS</varname> entries will be turned into
dependencies unless explicitly ignored (in which case a
warning will be printed).</para>
- <para>To ignore these dependency recommendations and just
+ <para>To ignore these ABI dependency recommendations and just
use the required <varname>DEPENDS</varname>, set
- <varname>IGNORE_RECOMMENDED=YES</varname>. This may make
+ <varname>USE_ABI_DEPENDS=NO</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
@@ -254,8 +254,7 @@
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
+ vulnerabilities file. See <xref
linkend="security-handling"/> for more
information.</para>
</listitem>
@@ -379,11 +378,7 @@
<para>After fixing the vulnerability by a patch, its
<varname>PKGREVISION</varname> should be increased (this
is of course not necessary if the problem is fixed by using
- a newer release of the software). In addition, if a
- <filename>buildlink3.mk</filename> file exists for an
- affected package, a corresponding
- <varname>BUILDLINK_RECOMMENDED.<replaceable>pkg</replaceable></varname>
- entry should be added or updated in it.</para>
+ a newer release of the software).</para>
<para>Also, if the fix should be applied to the stable pkgsrc
branch, be sure to submit a pullup request!</para>