pkgsrc/doc/guide/files/components.xml: 1.11 -> 1.12

[kano@na.rim.or.jp (OKANO Takayoshi)]

以下のページの更新をしました。ツッコミをお願いします。

pkgsrc/doc/guide/files/components.xml: 1.11 -> 1.12

> revision 1.12
> date: 2005/08/04 17:38:06;  author: gdt;  state: Exp;  lines: +7 -1
> In components, in patches section, add admonition to send patches that
> are really fixes upstream.  (Prompted by note back from an upstream
> maintainer after sending him someone else's bugfix patch that he
> hadn't already gotten asking me to make sure upstream maintainers get
> patches.)

木曜日までに異議がなければ、 commit します。

以下、訳と原文それぞれの新旧の差分です。

--- components.xml.orig	2006-10-11 00:15:53.000000000 +0900
+++ components.xml	2006-10-11 00:15:53.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: components.xml,v 1.11 2005/08/03 16:34:19 wiz Exp $ -->
+<!-- $NetBSD: components.xml,v 1.12 2005/08/04 17:38:06 gdt Exp $ -->
 <!-- Based on english version: -->
-<!-- NetBSD: components.xml,v 1.11 2005/08/03 16:34:19 wiz Exp   -->
+<!-- NetBSD: components.xml,v 1.12 2005/08/04 17:38:06 gdt Exp   -->
 
 <chapter id="components"> <?dbhtml filename="components.html"?>
   <title>パッケージコンポーネント - ファイル、ディレクトリー、およびコンテンツ</title>
@@ -273,6 +273,12 @@
       イルのチェックサムを生成するようにしてください。<xref linkend="components.distinfo"/>を参照してくだ
       さい。</para>
 
+    <para>(たとえば、マニュアルページの場所を pkgsrc の流儀に合わせるようなものではなく)
+      distfile の問題を修正するパッチを追加した場合は、
+      そのパッチをバグ報告としてメンテナーに送ってください。こうすることで、
+      pkgsrc を使っていないパッケージ利用者が幸せになれますし、
+      通常は、将来のバージョンでパッチを削除することができるようになります。</para>
+
     <para>作者その他のメンテナーが配布しているパッチファイルは、
       <varname>$PATCHFILES</varname>
       に列挙することができます。 </para> 
Index: components.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/components.xml,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -r1.11 -r1.12
--- components.xml	3 Aug 2005 16:34:19 -0000	1.11
+++ components.xml	4 Aug 2005 17:38:06 -0000	1.12
@@ -1,4 +1,4 @@
-<!-- $NetBSD: components.xml,v 1.11 2005/08/03 16:34:19 wiz Exp $ -->
+<!-- $NetBSD: components.xml,v 1.12 2005/08/04 17:38:06 gdt Exp $ -->
 
 <chapter id="components"> <?dbhtml filename="components.html"?>
   <title>Package components - files, directories and contents</title>
@@ -283,6 +283,12 @@
       for the patch files by using the <command>make makepatchsum</command>
       command, see <xref linkend="components.distinfo"/>.</para>
 
+    <para>When adding a patch that corrects a problem in the distfile (rather
+      than e.g. enforcing pkgsrc's view of where man pages should go), send
+      the patch as a bug report to the maintainer.  This benefits
+      non-pkgsrc users of the package, and usually enables removing
+      the patch in future version.</para>
+
     <para>Patch files that are distributed by the author or other
       maintainers can be listed in
       <varname>$PATCHFILES</varname>. </para>