[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

pkgsrc/doc/guide/files/introduction.xml: 1.11 -> 1.13



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

pkgsrc/doc/guide/files/introduction.xml: 1.11 -> 1.13

> revision 1.13
> date: 2006/05/19 22:04:19;  author: rillig;  state: Exp;  lines: +9 -4
> Clarified that pkgsrc users are not necessarily "end users".
> ----------------------------
> revision 1.12
> date: 2006/05/19 21:43:23;  author: rillig;  state: Exp;  lines: +29 -1
> Added definitions for the people involved in pkgsrc.

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

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

--- introduction.xml.orig	2006-11-14 00:41:01.000000000 +0900
+++ introduction.xml	2006-11-14 00:41:01.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: introduction.xml,v 1.11 2006/05/12 23:03:22 rillig Exp $ -->
+<!-- $NetBSD: introduction.xml,v 1.13 2006/05/19 22:04:19 rillig Exp $ -->
 <!-- Based on english version: -->
-<!-- NetBSD: introduction.xml,v 1.11 2006/05/12 23:03:22 rillig Exp   -->
+<!-- NetBSD: introduction.xml,v 1.13 2006/05/19 22:04:19 rillig Exp   -->
 
 <chapter id="introduction">
   <title>pkgsrc とは何か</title>
@@ -208,6 +208,40 @@
 	</listitem>
       </varlistentry>
     </variablelist>
+
+  <sect2 id="term.people">
+  <title>pkgsrc に関わる人たち</title>
+
+	<variablelist>
+
+	<varlistentry><term>pkgsrc 利用者</term><listitem><para>pkgsrc
+	利用者とは、pkgsrc で提供されているパッケージを使う人たちです。
+	ふつうはシステム管理者のことです。パッケージを構成するソフトウェアを使う人たち
+	(<quote>末端利用者</quote> ということがあります) については、
+	the pkgsrc guide では対象としません。</para>
+
+	<para>pkgsrc 利用者には二通りあります: 一方は、
+	構築済みバイナリーパッケージをインストールしたいだけの人たちです。
+	もう一方は、pkgsrc のパッケージをソースから構築する人たちで、
+	こちらは、そのままインストールすることが目的の場合と、
+	バイナリーパッケージ自体を構築することが目的の場合があります。
+	pkgsrc 利用者にとって必要なことはすべて、<xref
+	linkend="users-guide"/> に書いてあるはずです。</para></listitem></varlistentry>
+
+	<varlistentry><term>パッケージメンテナー</term><listitem><para>
+	パッケージメンテナーは、<xref
+	linkend="developers-guide"/> で説明されているようにパッケージを作成する人です。</para></listitem></varlistentry>
+
+	<varlistentry><term>基盤開発者</term>
+	<listitem><para><filename>mk/</filename>
+	ディレクトリー以下にある各ファイルに携わる人たちです。
+	<xref
+	linkend="infrastructure"/> を通しで読む必要があるのは、この人たちだけのはずです
+	(基盤開発者以外の人が興味を持つこともあるでしょうが)。</para></listitem></varlistentry>
+
+	</variablelist>
+
+  </sect2>
   </sect1>
 
   <sect1 id="typography">
Index: introduction.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/introduction.xml,v
retrieving revision 1.11
retrieving revision 1.13
diff -u -r1.11 -r1.13
--- introduction.xml	12 May 2006 23:03:22 -0000	1.11
+++ introduction.xml	19 May 2006 22:04:19 -0000	1.13
@@ -1,4 +1,4 @@
-<!-- $NetBSD: introduction.xml,v 1.11 2006/05/12 23:03:22 rillig Exp $ -->
+<!-- $NetBSD: introduction.xml,v 1.13 2006/05/19 22:04:19 rillig Exp $ -->
 
 <chapter id="introduction">
   <title>What is pkgsrc?</title>
@@ -217,6 +217,39 @@
 	</listitem>
       </varlistentry>
     </variablelist>
+
+  <sect2 id="term.people">
+  <title>People involved in pkgsrc</title>
+
+	<variablelist>
+
+	<varlistentry><term>pkgsrc users</term><listitem><para>The
+	pkgsrc users are people who use the packages provided by pkgsrc.
+	Typically they are system administrators. The people using the
+	software that is inside the packages (maybe called <quote>end
+	users</quote>) are not covered by the pkgsrc guide.</para>
+
+	<para>There are two kinds of pkgsrc users: Some only want to
+	install pre-built binary packages. Others build the pkgsrc
+	packages from source, either for installing them directly or for
+	building binary packages themselves. For pkgsrc users <xref
+	linkend="users-guide"/> should provide all necessary
+	documentation.</para></listitem></varlistentry>
+
+	<varlistentry><term>package maintainers</term><listitem><para>A
+	package maintainer creates packages as described in <xref
+	linkend="developers-guide"/>.</para></listitem></varlistentry>
+
+	<varlistentry><term>infrastructure developers</term>
+	<listitem><para>These people are involved in all those files
+	that live in the <filename>mk/</filename> directory and below.
+	Only these people should need to read through <xref
+	linkend="infrastructure"/>, though others might be curious,
+	too.</para></listitem></varlistentry>
+
+	</variablelist>
+
+  </sect2>
   </sect1>
 
   <sect1 id="typography">