pkgsrc/doc/guide/files/components.xml: 1.37 -> 1.38

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

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

pkgsrc/doc/guide/files/components.xml: 1.37 -> 1.38
> revision 1.38
> date: 2008/01/02 14:20:55;  author: rillig;  state: Exp;  lines: +2 -3
> Patches that replace the == argument to test(1) with a single = don't
> need to be commented upon at all. Fixes PR 37167.

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

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

--- components.xml.orig	2008-01-04 20:45:06.000000000 +0900
+++ components.xml	2008-01-04 20:45:06.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: components.xml,v 1.37 2007/08/15 06:33:44 rillig Exp $ -->
+<!-- $NetBSD: components.xml,v 1.38 2008/01/02 14:20:55 rillig Exp $ -->
 <!-- Based on english version: -->
-<!-- NetBSD: components.xml,v 1.37 2007/08/15 06:33:44 rillig Exp   -->
+<!-- NetBSD: components.xml,v 1.38 2008/01/02 14:20:55 rillig Exp   -->
 
 <chapter id="components"> <?dbhtml filename="components.html"?>
 <title>パッケージコンポーネント - ファイル、ディレクトリー、およびコンテンツ</title>
@@ -243,9 +243,8 @@
   <itemizedlist>
 
   <listitem><para>シェルスクリプト中の &man.test.1; 用の <literal>==</literal>
-  演算子を <literal>=</literal> に置き換えるパッチには、
-  同じ説明を省くために、<!-- xref linkend="test-eqeq"/ -->
-  への参照を含めるようにします。</para></listitem>
+  演算子を <literal>=</literal> に置き換えるパッチは、
+  よくあるものなので、一切コメントを書く必要はありません。</para></listitem>
 
   <listitem><para>一般に知られている脆弱性に対するパッチには、
   その脆弱性の ID (CAN, CVE) を記すようにします。</para></listitem>
Index: components.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/components.xml,v
retrieving revision 1.37
retrieving revision 1.38
diff -u -r1.37 -r1.38
--- components.xml	15 Aug 2007 06:33:44 -0000	1.37
+++ components.xml	2 Jan 2008 14:20:55 -0000	1.38
@@ -1,4 +1,4 @@
-<!-- $NetBSD: components.xml,v 1.37 2007/08/15 06:33:44 rillig Exp $ -->
+<!-- $NetBSD: components.xml,v 1.38 2008/01/02 14:20:55 rillig Exp $ -->
 
 <chapter id="components"> <?dbhtml filename="components.html"?>
 <title>Package components - files, directories and contents</title>
@@ -244,8 +244,7 @@
 
   <listitem><para>Patches that replace the <literal>==</literal>
   operator for &man.test.1; with <literal>=</literal> in shell scripts
-  should contain a reference to <!-- xref linkend="test-eqeq"/ -->, to avoid
-  redundant explanations.</para></listitem>
+  are so common that they don't need a comment at all.</para></listitem>
 
   <listitem><para>Patches for commonly known vulnerabilities should
   mention the vulnerability ID (CAN, CVE).</para></listitem>