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

pkgsrc/doc/guide/files/introduction.xml: 1.15 -> 1.16



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

pkgsrc/doc/guide/files/introduction.xml: 1.15 -> 1.16

> revision 1.16
> date: 2006/07/29 15:57:04;  author: rillig;  state: Exp;  lines: +117 -46
> Moved all the pkgsrc documentation from outside the pkgsrc guide to
> here. There's still much to do to avoid repetition and such, but
> the first steps are done.

追加された部分は、
htdocs/Documentation/software/packages.xml と同じなので、
訳も流用しています。

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

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

--- introduction.xml.orig	2006-12-09 00:35:18.000000000 +0900
+++ introduction.xml	2006-12-09 00:35:18.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: introduction.xml,v 1.15 2006/07/29 14:14:19 rillig Exp $ -->
+<!-- $NetBSD: introduction.xml,v 1.16 2006/07/29 15:57:04 rillig Exp $ -->
 <!-- Based on english version: -->
-<!-- NetBSD: introduction.xml,v 1.15 2006/07/29 14:14:19 rillig Exp   -->
+<!-- NetBSD: introduction.xml,v 1.16 2006/07/29 15:57:04 rillig Exp   -->
 
 <chapter id="introduction">
   <title>pkgsrc とは何か</title>
@@ -47,55 +47,123 @@
       pthreads や X11 のようなプラットフォームによって異なる依存関係や、
       IPv6 対応のような拡張機能の処理が組み込まれています。</para>
 
-    <para>pkgsrc は FreeBSD の ports システムから派生したもので、
-      はじめは NetBSD 専用として開発されていました。その後、
-      pkgsrc は大きく成長し、現在では以下のプラットフォームに対応しています。</para>
-
-    <itemizedlist>
-      <listitem>
-	<para><ulink url="http://developer.apple.com/darwin/">Darwin</ulink>
-	  (<ulink url="http://www.apple.com/macosx/">Mac OS X</ulink>)</para>
-      </listitem>
-
-      <listitem>
-	<para><ulink url="http://www.DragonFlyBSD.org/">DragonFly BSD</ulink></para>
-      </listitem>
+<sect2 id="why-pkgsrc">
+<title>なぜ pkgsrc なのか?</title>
 
-      <listitem>
-	<para><ulink url="http://www.FreeBSD.org/">FreeBSD</ulink></para>
-      </listitem>
-
-      <listitem>
-	<para>Microsoft Windows (<ulink url="http://www.microsoft.com/windows/sfu/">Interix</ulink> を使って)</para>
-      </listitem>
-
-      <listitem>
-	<para><ulink url="http://www.sgi.com/software/irix6.5/">IRIX</ulink></para>
-      </listitem>
+<para>
+pkgsrc が提供する重要な機能は、以下のようなものです
+</para>
+
+<itemizedlist>
+<listitem><para>ソフトウェアのソースからの構築のほか、バイナリーパッケージの作成および
+  インストールが容易にできるようになります。ソースと最新のパッチを
+  マスターサイトかミラーダウンロードサイトから取得し、チェックサムを検証してから、
+  あなたのシステムで構築をおこないます。
+  バイナリーのみ配布されているソフトウェアも、ネイティブプラットフォームと
+  NetBSD でエミュレートされたプラットフォームの双方で利用可能です。</para></listitem>
+<listitem><para>バイナリー、ライブラリー、マニュアルページ、その他の文書など、
+  すべてのパッケージは首尾一貫したディレクトリーツリーにインストールされます。</para></listitem>
+<listitem><para>パッケージの依存関係は、パッケージ更新時も含め、
+  自動的に解決されます。更新の際には、
+  さまざまなパッケージの設定ファイルが自動的に処理され、
+  ローカルな変更点は保持されます。</para></listitem>
+<listitem><para>NetBSD と同様、 pkgsrc は移植性を意図して設計されており、
+  高い移植性を持つコードでできています。これにより、
+  新しいプラットフォームへの移植は、きわめて迅速な開発が可能です。
+  この移植性はまた、 pkgsrc を <emphasis>全プラットフォームの間で一貫したもの</emphasis>にしています。</para></listitem>
+<listitem><para>膨大な数のパッケージに対する、インストール先、
+  受け入れ可能なソフトウェアライセンス、国際版の暗号が必要か、
+  および構築時オプションは、
+  すべて単一の設定ファイルで管理されます。</para></listitem>
+<listitem><para>完全なソース (ソフトウェアの配布ファイルは含みません) は、
+  BSD ライセンスの下で自由に使用できますので、必要に応じて 
+  pkgsrc の拡張や改造ができます。そのままでローカルパッケージやパッチに
+  対応しているので、あなたの環境に合わせて設定することができます。</para></listitem>
+</itemizedlist>
+</sect2>
 
-      <listitem>
-	<para><ulink url="http://www.linux.org/">Linux</ulink></para>
-      </listitem>
+<sect2 id="intro.platforms">
+<title>対応プラットフォーム</title>
 
-      <listitem>
-	<para><ulink url="http://www.NetBSD.org/">NetBSD</ulink> (
-	  当然)</para>
-      </listitem>
+<para>pkgsrc には、
+これらのオペレーティングシステム用のソース配布およびバイナリー配布の両形態があります。
+必要なソースまたはバイナリーを取ってくれば、
+すぐに pkgsrc で作業を始めることができます。</para>
 
-      <listitem>
-	<para><ulink url="http://h30097.www3.hp.com/">Tru64</ulink>
-	  (Digital UNIX, OSF1)</para>
-      </listitem>
+    <para>pkgsrc は FreeBSD の ports システムから派生したもので、
+      はじめは NetBSD 専用として開発されていました。その後、
+      pkgsrc は大きく成長し、現在では以下のプラットフォームに対応しています。</para>
 
-      <listitem>
-	<para><ulink url="http://www.openbsd.org/">OpenBSD</ulink></para>
-      </listitem>
+<table id="supported-platforms">
+  <title>pkgsrc が対応しているプラットフォーム</title>
+  <tgroup cols = "2">
+    <thead>
+      <row>
+        <entry>プラットフォーム</entry>
+        <entry>対応した日</entry>
+      </row>
+    </thead>
+    <tbody>
+      <row>
+        <entry><ulink url="http://www.NetBSD.org/">NetBSD</ulink></entry>
+        <entry align="center">1997 年 8 月</entry>
+      </row>
+      <row>
+        <entry><ulink url="http://wwws.sun.com/software/solaris/">Solaris</ulink></entry>
+        <entry align="center">1999 年 3 月</entry>
+      </row>
+      <row>
+        <entry><ulink url="http://www.kernel.org/">Linux</ulink></entry>
+        <entry align="center">1999 年 6 月</entry>
+      </row>
+      <row>
+        <entry>
+          <ulink url="http://developer.apple.com/darwin/">Darwin</ulink>
+          (<ulink url="http://developer.apple.com/macosx/">Mac OS X</ulink>)
+        </entry>
+        <entry align="center">2001 年 10 月</entry>
+      </row>
+      <row>
+        <entry><ulink url="http://www.freebsd.org/">FreeBSD</ulink></entry>
+        <entry align="center">2002 年 11 月</entry>
+      </row>
+      <row>
+        <entry><ulink url="http://www.openbsd.org/">OpenBSD</ulink></entry>
+        <entry align="center">2002 年 11 月</entry>
+      </row>
+      <row>
+        <entry><ulink url="http://www.sgi.com/software/irix/">IRIX</ulink></entry>
+        <entry align="center">2002 年 12 月</entry>
+      </row>
+      <row>
+        <entry>BSD/OS</entry>
+        <entry align="center">2003 年 12 月</entry>
+      </row>
+      <row>
+        <entry><ulink url="http://www-1.ibm.com/servers/aix/">AIX</ulink></entry>
+        <entry align="center">2003 年 12 月</entry>
+      </row>
+      <row>
+        <entry>
+          <ulink url="http://www.microsoft.com/windows/sfu/">Interix</ulink>
+          (Microsoft Windows Services for Unix)
+        </entry>
+        <entry align="center">2004 年 3 月</entry>
+      </row>
+      <row>
+        <entry><ulink url="http://www.dragonflybsd.org/">DragonFlyBSD</ulink></entry>
+        <entry align="center">2004 年 10 月</entry>
+      </row>
+      <row>
+        <entry><ulink url="http://www.tru64.org/">OSF/1</ulink></entry>
+        <entry align="center">2004 年 11 月</entry>
+      </row>
+    </tbody>
+  </tgroup>
+</table>
+</sect2>
 
-      <listitem>
-	<para><ulink url="http://www.sun.com/solaris/">Solaris</ulink></para>
-      </listitem>
-    </itemizedlist>
-  </sect1>
+</sect1>
 
   <sect1 id="overview">
     <title>概要</title>
@@ -216,7 +284,7 @@
 
 </sect2>
 
-  <sect2 id="term.people">
+  <sect2 id="term.roles">
   <title>pkgsrc に関わる人たち</title>
 
 	<variablelist>
Index: introduction.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/introduction.xml,v
retrieving revision 1.15
retrieving revision 1.16
diff -u -r1.15 -r1.16
--- introduction.xml	29 Jul 2006 14:14:19 -0000	1.15
+++ introduction.xml	29 Jul 2006 15:57:04 -0000	1.16
@@ -1,4 +1,4 @@
-<!-- $NetBSD: introduction.xml,v 1.15 2006/07/29 14:14:19 rillig Exp $ -->
+<!-- $NetBSD: introduction.xml,v 1.16 2006/07/29 15:57:04 rillig Exp $ -->
 
 <chapter id="introduction">
   <title>What is pkgsrc?</title>
@@ -45,55 +45,126 @@
       such as pthreads and X11, and extended features such as IPv6 support on
       a range of platforms.</para>
 
-    <para>pkgsrc was derived from FreeBSD's ports system, and
-      initially developed for NetBSD only. Since then, pkgsrc has
-      grown a lot, and now supports the following platforms:</para>
-
-    <itemizedlist>
-      <listitem>
-	<para><ulink url="http://developer.apple.com/darwin/">Darwin</ulink>
-	  (<ulink url="http://www.apple.com/macosx/">Mac OS X</ulink>)</para>
-      </listitem>
-
-      <listitem>
-	<para><ulink url="http://www.DragonFlyBSD.org/">DragonFly BSD</ulink></para>
-      </listitem>
+<sect2 id="why-pkgsrc">
+<title>Why pkgsrc?</title>
 
-      <listitem>
-	<para><ulink url="http://www.FreeBSD.org/">FreeBSD</ulink></para>
-      </listitem>
-
-      <listitem>
-	<para>Microsoft Windows, via <ulink url="http://www.microsoft.com/windows/sfu/">Interix</ulink></para>
-      </listitem>
-
-      <listitem>
-	<para><ulink url="http://www.sgi.com/software/irix6.5/">IRIX</ulink></para>
-      </listitem>
+<para>
+pkgsrc provides the following key features:
+</para>
+
+<itemizedlist>
+<listitem><para>Easy building of software from source as well as the creation
+  and installation of binary packages. The source and latest
+  patches are retrieved from a master or mirror download site, checksum
+  verified, then built on your system. Support for binary-only
+  distributions is available for both native platforms and NetBSD
+  emulated platforms.</para></listitem>
+<listitem><para>All packages are installed in a consistent directory tree,
+  including binaries, libraries, man pages and other
+  documentation.</para></listitem>
+<listitem><para>Package dependencies, including when performing package updates,
+  are handled automatically. The configuration files of various
+  packages are handled automatically during updates, so local changes
+  are preserved.</para></listitem>
+<listitem><para>Like NetBSD, pkgsrc is designed with portability in mind and
+  consists of highly portable code. This allows the greatest speed of
+  development when porting to new a platform. This portability also
+  ensures that pkgsrc is <emphasis>consistent across all
+  platforms</emphasis>.</para></listitem>
+<listitem><para>The installation prefix, acceptable software licenses,
+  international encryption requirements and build-time options for a
+  large number of packages are all set in a simple, central
+  configuration file.</para></listitem>
+<listitem><para>The entire source (not including the distribution files) is
+  freely available under a BSD license, so you may extend and adapt
+  pkgsrc to your needs. Support for local packages and patches is
+  available right out of the box, so you can configure it specifically
+  for your environment.</para></listitem>
+</itemizedlist>
+</sect2>
 
-      <listitem>
-	<para><ulink url="http://www.linux.org/">Linux</ulink></para>
-      </listitem>
+<sect2 id="intro.platforms">
+<title>Supported platforms</title>
 
-      <listitem>
-	<para><ulink url="http://www.NetBSD.org/">NetBSD</ulink> (of
-	  course)</para>
-      </listitem>
+<para>pkgsrc consists of both a source distribution and a binary
+distribution for these operating systems. After retrieving the required
+source or binaries, you can be up and running with pkgsrc in just
+minutes!</para>
 
-      <listitem>
-	<para><ulink url="http://h30097.www3.hp.com/">Tru64</ulink>
-	  (Digital UNIX, OSF1)</para>
-      </listitem>
+    <para>pkgsrc was derived from FreeBSD's ports system, and
+      initially developed for NetBSD only. Since then, pkgsrc has
+      grown a lot, and now supports the following platforms:</para>
 
-      <listitem>
-	<para><ulink url="http://www.openbsd.org/">OpenBSD</ulink></para>
-      </listitem>
+<table id="supported-platforms">
+  <title>Platforms supported by pkgsrc</title>
+  <tgroup cols = "2">
+    <thead>
+      <row>
+        <entry>Platform</entry>
+        <entry>Date Support Added</entry>
+      </row>
+    </thead>
+    <tbody>
+      <row>
+        <entry><ulink url="http://www.NetBSD.org/">NetBSD</ulink></entry>
+        <entry align="center">Aug 1997</entry>
+      </row>
+      <row>
+        <entry><ulink url="http://wwws.sun.com/software/solaris/">Solaris</ulink></entry>
+        <entry align="center">Mar 1999</entry>
+      </row>
+      <row>
+        <entry><ulink url="http://www.kernel.org/">Linux</ulink></entry>
+        <entry align="center">Jun 1999</entry>
+      </row>
+      <row>
+        <entry>
+          <ulink url="http://developer.apple.com/darwin/">Darwin</ulink>
+          (<ulink url="http://developer.apple.com/macosx/">Mac OS X</ulink>)
+        </entry>
+        <entry align="center">Oct 2001</entry>
+      </row>
+      <row>
+        <entry><ulink url="http://www.freebsd.org/">FreeBSD</ulink></entry>
+        <entry align="center">Nov 2002</entry>
+      </row>
+      <row>
+        <entry><ulink url="http://www.openbsd.org/">OpenBSD</ulink></entry>
+        <entry align="center">Nov 2002</entry>
+      </row>
+      <row>
+        <entry><ulink url="http://www.sgi.com/software/irix/">IRIX</ulink></entry>
+        <entry align="center">Dec 2002</entry>
+      </row>
+      <row>
+        <entry>BSD/OS</entry>
+        <entry align="center">Dec 2003</entry>
+      </row>
+      <row>
+        <entry><ulink url="http://www-1.ibm.com/servers/aix/">AIX</ulink></entry>
+        <entry align="center">Dec 2003</entry>
+      </row>
+      <row>
+        <entry>
+          <ulink url="http://www.microsoft.com/windows/sfu/">Interix</ulink>
+          (Microsoft Windows Services for Unix)
+        </entry>
+        <entry align="center">Mar 2004</entry>
+      </row>
+      <row>
+        <entry><ulink url="http://www.dragonflybsd.org/">DragonFlyBSD</ulink></entry>
+        <entry align="center">Oct 2004</entry>
+      </row>
+      <row>
+        <entry><ulink url="http://www.tru64.org/">OSF/1</ulink></entry>
+        <entry align="center">Nov 2004</entry>
+      </row>
+    </tbody>
+  </tgroup>
+</table>
+</sect2>
 
-      <listitem>
-	<para><ulink url="http://www.sun.com/solaris/">Solaris</ulink></para>
-      </listitem>
-    </itemizedlist>
-  </sect1>
+</sect1>
 
   <sect1 id="overview">
     <title>Overview</title>
@@ -223,8 +294,8 @@
 
 </sect2>
 
-  <sect2 id="term.people">
-  <title>People involved in pkgsrc</title>
+  <sect2 id="term.roles">
+  <title>Roles involved in pkgsrc</title>
 
 	<variablelist>