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

pkgsrc/doc/guide/files/using.xml: 1.16 -> 1.18



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

pkgsrc/doc/guide/files/using.xml: 1.16 -> 1.18

> revision 1.18
> date: 2006/03/01 17:16:21;  author: rillig;  state: Exp;  lines: +5 -4
> Minor wording change.
> ----------------------------
> revision 1.17
> date: 2006/02/22 01:30:25;  author: rillig;  state: Exp;  lines: +74 -35
> Updated the "Using pkgsrc" chapter a bit, making it more
> platform-independent. Explicitly added URLs where to find binary
> packages for Solaris.

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

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

--- using.xml.orig	2006-11-04 17:56:03.000000000 +0900
+++ using.xml	2006-11-04 17:56:03.000000000 +0900
@@ -1,40 +1,86 @@
-<!-- $NetBSD: using.xml,v 1.16 2006/02/12 14:44:59 rillig Exp $ -->
+<!-- $NetBSD: using.xml,v 1.18 2006/03/01 17:16:21 rillig Exp $ -->
 <!-- Based on english version: -->
-<!-- NetBSD: using.xml,v 1.16 2006/02/12 14:44:59 rillig Exp   -->
+<!-- NetBSD: using.xml,v 1.18 2006/03/01 17:16:21 rillig Exp   -->
 
 <chapter id="using"> <?dbhtml filename="using.html"?>
-  <title>pkgsrc を使う</title>
+<title>pkgsrc を使う</title>
 
-  <sect1 id="getting-started">
-    <title>バイナリーパッケージを使って作業する</title>
-
-    <para> このセクションは、あなたの機種用にすでに準備されたコンパイル済みのバイナリー
-      パッケージを見つけ、取得してインストールする方法について説明します。 </para>
-
-    <sect2 id="where-to-get-binary-packages">
-      <title>バイナリーパッケージの配布場所</title>
-
-      <para> コンパイル済みのパッケージは、ftp.NetBSD.orgおよびそのミラー上の、匿名FTPア
-        クセスのためのディレクトリー
-        <filename>/pub/NetBSD/packages/&lt;OSVERSION&gt;/&lt;ARCH&gt;/</filename>
-	に置かれています。<varname>OSVERSION</varname> は &os;
-	のバージョン (<command>uname -r</command>)、 <varname>ARCH</varname>
-	はアーキテクチャー (<command>uname -p</command>) です。
-	このディレクト
-        リーの中には、カテゴリー毎のサブディレクトリーと、<filename>All</filename>サブディレクトリー
-        が存在しています。<filename>All</filename>サブディレクトリーの中には、
-        <filename>.tgz</filename>ファイル形式で実際
-        のバイナリーがあります。カテゴリー毎のサブディレクトリーは、これらのファイ
-        ルへのシンボリックリンクを使用しています (<filename>/usr/pkgsrc/packages</filename>と同じディレ
-        クトリー配置です)。 </para>
-
-      <para> CD-ROMディストリビューションでも、このディレクトリー配置は同じで、単
-        にディレクトリーのルートが異なるだけです。たぶん<filename>/cdrom</filename>かどこかの下でしょう。
-        正確なディレクトリーは、CD-ROMのドキュメンテーションを参照してください。 </para>
-    </sect2>
-
-    <sect2 id="how-to-use-binary-packages">
-      <title>バイナリーパッケージの使い方</title>
+	<para>基本的に、pkgsrc には二通りの使い方があります。
+	一つ目の使い方は、パッケージ用のツールだけをインストールして、
+	他の人が用意したバイナリーパッケージを使うものです。
+	これは、pkgsrc のうち <quote>pkg</quote> に相当します。
+	二つ目の使い方は、pkgsrc の <quote>src</quote> もインストールするものです。
+	こうすると、自分でパッケージを構築することができますし、
+	他の人が用意したバイナリーパッケージを使うこともできます。</para>
+
+<sect1 id="using-pkg">
+<title>バイナリーパッケージを使う</title>
+
+	<para>バイナリーパッケージを使うためには、管理用のツールがいくつか必要になります。
+	NetBSD では、管理用のツールはあらかじめインストールされています。
+	NetBSD 以外の各オペレーティングシステムでは、
+	まず、管理用のツールをインストールする必要があります。
+	以下のプラットフォーム用には、
+	パッケージ用のツールをあらかじめ構築したものが用意されており、ダウンロードして
+	<filename>/</filename> ディレクトリーに展開するだけで使うことができます。</para>
+
+	<informaltable id="binary-bootstrap-kits">
+	<tgroup cols="2">
+	<thead><row><entry>プラットフォーム</entry><entry>URL</entry></row></thead>
+	<tbody>
+	<row><entry>Solaris 5.10</entry><entry><filename>http://public.enst.fr/pkgsrc/packages/bootstrap-pkgsrc/</filename></entry></row>
+	</tbody>
+	</tgroup>
+	</informaltable>
+
+	<para>この構築済みパッケージ用ツールは、基点ディレクトリーとして
+	<filename>/usr/pkg</filename> を使い、
+	インストールされているパッケージのデータベースとして
+	<filename>/var/db/pkg</filename> を使います。
+	何らかの理由 (root 権限がないなど) でこの各ディレクトリーが使えない場合は、
+	パッケージ用ツールを自分で構築する必要があります。これについては<xref
+	linkend="bootstrapping-pkgsrc" />に説明があります。</para>
+
+<sect2 id="finding-binary-packages">
+<title>バイナリーパッケージの配布場所</title>
+
+	<para>バイナリーパッケージをインストールするためには、
+	まず、バイナリーパッケージがどこで入手できるか知っている必要があります。
+	バイナリーパッケージは CD-ROM, DVD や、FTP 
+	または HTTP 経由で入手することができます。</para>
+
+	<para>NetBSD 用のバイナリーパッケージは、
+	<filename>ftp.NetBSD.org</filename> およびミラーサイトの、
+	<filename>/pub/NetBSD/packages/<replaceable>OSVERSION</replaceable>/<replaceable>ARCH</replaceable>/</filename> ディレクトリーにあります。
+	<replaceable>OSVERSION</replaceable> には
+	<command>uname -r</command> の出力を、
+	<replaceable>ARCH</replaceable> には <command>uname
+	-p</command> の出力を当てはめます。</para>
+
+	<para>NetBSD 以外の一部のプラットフォーム用のバイナリーパッケージは、
+	以下の場所にあります。</para>
+
+	<informaltable id="binary-packages">
+	<tgroup cols="2">
+	<thead><row><entry>プラットフォーム</entry><entry>URL</entry></row></thead>
+	<tbody>
+	<row><entry>Solaris 5.10</entry><entry><filename>http://public.enst.fr/pkgsrc/packages/</filename></entry></row>
+	</tbody>
+	</tgroup>
+	</informaltable>
+
+	<para>この各ディレクトリーには、サブディレクトリー
+	<filename>All</filename> があり、すべてのバイナリーパッケージを含んでいます。
+	さらに、カテゴリー別のサブディレクトリーがあり、
+	<filename>../All</filename>
+	にあるバイナリーパッケージの実体へのシンボリックリンクを含んでいます。
+	このディレクトリー配置は、アクセス方法が HTTP, FTP, NFS, CD-ROM
+	あるいはローカルファイルシステムのいずれであるかにかかわらず、
+	すべてのパッケージの置場に共通のものです。</para>
+
+</sect2>
+<sect2 id="installing-binary-packages">
+<title>バイナリーパッケージをインストールする</title>
 
       <para> もし、コンパイル済みのパッケージのファイルがCD-ROM上にある、あるいはハードディ
         スク上にダウンロードされているのであれば、以下のコマンドでインストールする
Index: using.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/using.xml,v
retrieving revision 1.16
retrieving revision 1.18
diff -u -r1.16 -r1.18
--- using.xml	12 Feb 2006 14:44:59 -0000	1.16
+++ using.xml	1 Mar 2006 17:16:21 -0000	1.18
@@ -1,41 +1,81 @@
-<!-- $NetBSD: using.xml,v 1.16 2006/02/12 14:44:59 rillig Exp $ -->
+<!-- $NetBSD: using.xml,v 1.18 2006/03/01 17:16:21 rillig Exp $ -->
 
 <chapter id="using"> <?dbhtml filename="using.html"?>
-  <title>Using pkgsrc</title>
+<title>Using pkgsrc</title>
 
-  <sect1 id="getting-started">
-    <title>Working with binary packages</title>
-
-    <para> This section describes how to find, retrieve and install a
-      precompiled binary package that someone else already prepared
-      for your type of machine. </para>
-
-    <sect2 id="where-to-get-binary-packages">
-      <title>Where to get binary packages</title>
-
-      <para> Precompiled packages are stored on ftp.NetBSD.org and its
-        mirrors in the directory
-        <filename>/pub/NetBSD/packages/&lt;OSVERSION&gt;/&lt;ARCH&gt;/</filename> for
-	anonymous FTP access.  <varname>OSVERSION</varname> is the &os;
-	version (<command>uname -r</command>), <varname>ARCH</varname>
-	is the architecture (<command>uname -p</command>).
-	In that directory, there is a
-        subdirectory for each category plus a subdirectory
-        <filename>All</filename> which includes the actual binaries in
-        <filename>.tgz</filename> files. The category subdirectories
-        use symbolic links to those files (this is the same directory
-        layout as in
-        <filename>/usr/pkgsrc/packages</filename>). </para>
-
-      <para> This same directory layout applies for CD-ROM
-        distributions, only that the directory may be rooted somewhere
-        else, probably somewhere below
-        <filename>/cdrom</filename>. Please consult your CD-ROMs
-        documentation for the exact location. </para>
-    </sect2>
-
-    <sect2 id="how-to-use-binary-packages">
-      <title>How to use binary packages</title>
+	<para>Basically, there are two ways of using pkgsrc. The first
+	is to only install the package tools and to use binary packages
+	that someone else has prepared. This is the <quote>pkg</quote>
+	in pkgsrc. The second way is to install the <quote>src</quote>
+	of pkgsrc, too. Then you are able to build your own packages,
+	and you can still use binary packages from someone else.</para>
+
+<sect1 id="using-pkg">
+<title>Using binary packages</title>
+
+	<para>To use binary packages, you need some tools to manage
+	them. On NetBSD, these tools are already installed. On all other
+	operating systems, you need to install them first. For the
+	following platforms, prebuilt versions of the package tools
+	are available and can simply be downloaded and unpacked in the
+	<filename>/</filename> directory:</para>
+
+	<informaltable id="binary-bootstrap-kits">
+	<tgroup cols="2">
+	<thead><row><entry>Platform</entry><entry>URL</entry></row></thead>
+	<tbody>
+	<row><entry>Solaris 5.10</entry><entry><filename>http://public.enst.fr/pkgsrc/packages/bootstrap-pkgsrc/</filename></entry></row>
+	</tbody>
+	</tgroup>
+	</informaltable>
+
+	<para>These prebuilt package tools use
+	<filename>/usr/pkg</filename> for the base directory, and
+	<filename>/var/db/pkg</filename> for the database of installed
+	packages. If you cannot use these directories for whatever
+	reasons (maybe because you're not root), you have to build the
+	package tools yourself, which is explained in <xref
+	linkend="bootstrapping-pkgsrc" />.</para>
+
+<sect2 id="finding-binary-packages">
+<title>Finding binary packages</title>
+
+	<para>To install binary packages, you first need to know from
+	where to get them. You can get them on CD-ROMs, DVDs, or via FTP
+	or HTTP.</para>
+
+	<para>For NetBSD, the binary packages are made available on
+	<filename>ftp.NetBSD.org</filename> and its mirrors, in the
+	directory
+	<filename>/pub/NetBSD/packages/<replaceable>OSVERSION</replaceable>/<replaceable>ARCH</replaceable>/</filename>.
+	For <replaceable>OSVERSION</replaceable>, you should insert the
+	output of <command>uname -r</command>, and for
+	<replaceable>ARCH</replaceable> the output of <command>uname
+	-p</command>.</para>
+
+	<para>For some other platforms, binary packages can be found at
+	the following locations:</para>
+
+	<informaltable id="binary-packages">
+	<tgroup cols="2">
+	<thead><row><entry>Platform</entry><entry>URL</entry></row></thead>
+	<tbody>
+	<row><entry>Solaris 5.10</entry><entry><filename>http://public.enst.fr/pkgsrc/packages/</filename></entry></row>
+	</tbody>
+	</tgroup>
+	</informaltable>
+
+	<para>In each of these directories, there is a subdirectory
+	<filename>All</filename> that contains all the binary packages.
+	Further, there are subdirectories for categories that contain
+	symbolic links that point to the actual binary package in
+	<filename>../All</filename>. This directory layout is used for
+	all package repositories, no matter if they are accessed via
+	HTTP, FTP, NFS, CD-ROM, or the local filesystem.</para>
+
+</sect2>
+<sect2 id="installing-binary-packages">
+<title>Installing binary packages</title>
 
       <para> If you have the files on a CD-ROM or downloaded them to
         your hard disk, you can install them with the following command