pkgsrc/doc/guide/files/introduction.xml: 1.19 -> 1.20

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

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

pkgsrc/doc/guide/files/introduction.xml: 1.19 -> 1.20

> revision 1.20
> date: 2006/10/07 09:31:16;  author: rillig;  state: Exp;  lines: +22 -1
> Stated some major goals of pkgsrc:
> - high quality of the generated packages
> - platform independence, portability
> - uniform look and feel on all platforms
> 
> Feel free to add you own goals.

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

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

--- introduction.xml.orig	2007-01-09 22:33:18.000000000 +0900
+++ introduction.xml	2007-01-09 22:33:18.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: introduction.xml,v 1.19 2006/09/13 23:31:15 wiz Exp $ -->
+<!-- $NetBSD: introduction.xml,v 1.20 2006/10/07 09:31:16 rillig Exp $ -->
 <!-- Based on english version: -->
-<!-- NetBSD: introduction.xml,v 1.19 2006/09/13 23:31:15 wiz Exp   -->
+<!-- NetBSD: introduction.xml,v 1.20 2006/10/07 09:31:16 rillig Exp   -->
 
 <chapter id="introduction">
   <title>pkgsrc とは何か</title>
@@ -80,6 +80,29 @@
   pkgsrc の拡張や改造ができます。そのままでローカルパッケージやパッチに
   対応しているので、あなたの環境に合わせて設定することができます。</para></listitem>
 </itemizedlist>
+
+<para>pkgsrc では、以下の思想が基礎となっています。</para>
+
+<itemizedlist>
+
+<listitem><para><quote>正しいもののみが動くべき。</quote>
+&mdash; これは、パッケージにバグがある場合に、
+パッケージをただインストールして、それがうまく動くよう祈るよりも、
+バグを見つけて、そのことを訴えるほうがよいということです。
+pkgsrc には、そのようなバグを見つけるために、
+静的な分析ツール (<filename
+role="pkg">pkgtools/pkglint</filename>)、構築時の検査 (シェルスクリプトの移植性)や、
+インストール後の検査 (インストールされたファイル、
+共有ライブラリーの参照、スクリプトインタープリター) といった、
+多数の検査が用意されています。</para></listitem>
+
+<listitem><para><quote>動くものは、どこででも動くべき</quote>
+&mdash; NetBSD が多くのハードウェアアーキテクチャーに移植されているのと同様に、
+pkgsrc は多くのオペレーティングシステムに移植されています。
+すべてのプラットフォームでパッケージが同じように動くように注意が払われています。</para></listitem>
+
+</itemizedlist>
+
 </sect2>
 
 <sect2 id="intro.platforms">
Index: introduction.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/introduction.xml,v
retrieving revision 1.19
retrieving revision 1.20
diff -u -r1.19 -r1.20
--- introduction.xml	13 Sep 2006 23:31:15 -0000	1.19
+++ introduction.xml	7 Oct 2006 09:31:16 -0000	1.20
@@ -1,4 +1,4 @@
-<!-- $NetBSD: introduction.xml,v 1.19 2006/09/13 23:31:15 wiz Exp $ -->
+<!-- $NetBSD: introduction.xml,v 1.20 2006/10/07 09:31:16 rillig Exp $ -->
 
 <chapter id="introduction">
   <title>What is pkgsrc?</title>
@@ -81,6 +81,27 @@
   available right out of the box, so you can configure it specifically
   for your environment.</para></listitem>
 </itemizedlist>
+
+<para>The following principles are basic to pkgsrc:</para>
+
+<itemizedlist>
+
+<listitem><para><quote>It should only work if it's right.</quote>
+&mdash; That means, if a package contains bugs, it's better to find
+them and to complain about them rather than to just install the package
+and hope that it works. There are numerous checks in pkgsrc that try to
+find such bugs: Static analysis tools (<filename
+role="pkg">pkgtools/pkglint</filename>), build-time checks (portability
+of shell scripts), and post-installation checks (installed files,
+references to shared libraries, script interpreters).</para></listitem>
+
+<listitem><para><quote>If it works, it should work everywhere</quote>
+&mdash; Like NetBSD has been ported to many hardware architectures,
+pkgsrc has been ported to many operating systems. Care is taken that
+packages behave the same on all platforms.</para></listitem>
+
+</itemizedlist>
+
 </sect2>
 
 <sect2 id="intro.platforms">