[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
pkgsrc/doc/guide/files/using.xml: 1.30 -> 1.32
以下のページの更新をしました。ツッコミをお願いします。
pkgsrc/doc/guide/files/using.xml: 1.30 -> 1.32
> revision 1.32
> date: 2007/08/16 09:25:16; author: rillig; state: Exp; lines: +2 -2
> A trailing slash saves one redirection on the server.
> ----------------------------
> revision 1.31
> date: 2007/08/16 09:10:51; author: rillig; state: Exp; lines: +24 -46
> Updated the section on finding binary packages.
木曜日までに異議がなければ、 commit します。
以下、訳と原文それぞれの新旧の差分です。
--- using.xml.orig 2007-08-22 01:16:34.000000000 +0900
+++ using.xml 2007-08-22 01:16:34.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: using.xml,v 1.30 2007/08/15 06:33:46 rillig Exp $ -->
+<!-- $NetBSD: using.xml,v 1.32 2007/08/16 09:25:16 rillig Exp $ -->
<!-- Based on english version: -->
-<!-- NetBSD: using.xml,v 1.30 2007/08/15 06:33:46 rillig Exp -->
+<!-- NetBSD: using.xml,v 1.32 2007/08/16 09:25:16 rillig Exp -->
<chapter id="using"> <?dbhtml filename="using.html"?>
<title>pkgsrc を使う</title>
@@ -20,19 +20,12 @@
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 9</entry><entry><filename>ftp://ftp0.mh.bbc.co.uk/pub/pkgsrc/packages/bootstrap-pkgsrc/</filename></entry></row>
- <row><entry>Solaris 10</entry><entry><filename>http://public.enst.fr/pkgsrc/packages/bootstrap-pkgsrc/</filename></entry></row>
- </tbody>
- </tgroup>
- </informaltable>
+ プラットフォームによっては、管理用のツールのパッケージが、
+ 最初からアーカイブに入っており、
+ <filename>/</filename> ディレクトリーに展開するだけで使うことができます。
+ このツールは、FTP サーバーの <ulink
+ url="ftp://ftp.NetBSD.org/pub/pkgsrc/bootstrap-pkgsrc"><filename>bootstrap-pkgsrc</filename></ulink>
+ ディレクトリーにあります。</para>
<para>この構築済みパッケージ用ツールは、基点ディレクトリーとして
<filename>/usr/pkg</filename> を使い、
@@ -47,35 +40,22 @@
<para>バイナリーパッケージをインストールするためには、
まず、バイナリーパッケージがどこで入手できるか知っている必要があります。
- バイナリーパッケージは CD-ROM, DVD や、FTP
- または HTTP 経由で入手することができます。</para>
-
- <para>バイナリーパッケージは、
- 以下の場所にあります。</para>
-
- <informaltable id="binary-packages">
- <tgroup cols="2">
- <thead><row><entry>プラットフォーム</entry><entry>URL</entry></row></thead>
- <tbody>
- <row><entry>NetBSD</entry><entry><filename>ftp://ftp.NetBSD.org/pub/NetBSD/packages/</filename></entry></row>
- <row><entry>Solaris 9</entry><entry><filename>ftp://ftp0.mh.bbc.co.uk/pub/pkgsrc/packages/</filename></entry></row>
- <row><entry>Solaris 10</entry><entry><filename>http://public.enst.fr/pkgsrc/packages/</filename></entry></row>
- </tbody>
- </tgroup>
- </informaltable>
-
- <para>これらのディレクトリーはたいてい、複数のプラットフォーム用の
- バイナリーパッケージを含んでいます。<filename>All</filename>
- というディレクトリーがみつかるまで、
- お使いのマシンのアーキテクチャーやオペレーティングシステムに応じて、
- 適切なサブディレクトリーを選んでいってください。
- <filename>All</filename> ディレクトリーは、すべてのバイナリーパッケージを含んでいます。
- さらに、カテゴリー別のサブディレクトリーがあり、
- <filename>../All</filename>
- にあるバイナリーパッケージの実体へのシンボリックリンクを含んでいます。
- このディレクトリー配置は、アクセス方法が HTTP, FTP, NFS, CD-ROM
- あるいはローカルファイルシステムのいずれであるかにかかわらず、
- すべてのパッケージの置場に共通のものです。</para>
+ 最初に調べる場所は、pkgsrc の主たる FTP サーバーの <ulink
+ url="ftp://ftp.NetBSD.org/pub/pkgsrc/packages/"><filename>/pub/pkgsrc/packages</filename></ulink>
+ ディレクトリーです。</para>
+
+ <para>このディレクトリーには、複数のプラットフォーム用の
+ バイナリーパッケージがあります。
+ 最初に、お使いのオペレーティングシステムのディレクトリーを選んでください。
+ (バージョン番号がついているディレクトリーは、
+ 歴史的な理由で残っているだけですので、無視してください。)
+ 次に、ハードウェアアーキテクチャーを選び、
+ その次に、OS のバージョンと pkgsrc の<quote>バージョン</quote>の組合せを選びます。
+ このディレクトリーには <filename>All</filename> というサブディレクトリーがあり、
+ そこに (ほとんど) すべてのバイナリーパッケージが置かれています。
+ 「ほとんど」というのは、脆弱性のあるパッケージが、
+ 間違ってインストールされることのないよう
+ <filename>vulnerable</filename> ディレクトリーに移されているからです。</para>
</sect2>
<sect2 id="installing-binary-packages">
@@ -92,7 +72,7 @@
ドしたくないのであれば、<command>pkg_add</command>にFTPのURLを指定して自動でダウンロードさせる
事もできます。</para>
- <screen>&rprompt; <userinput>pkg_add ftp://ftp.NetBSD.org/pub/NetBSD/packages/<OSVERSION>/<ARCH>/All/package</userinput></screen>
+ <screen>&rprompt; <userinput>pkg_add ftp://ftp.NetBSD.org/pub/pkgsrc/packages/<replaceable>OPSYS</replaceable>/<replaceable>ARCH</replaceable>/<replaceable>VERSIONS</replaceable>/All/<replaceable>package</replaceable></userinput></screen>
<para>パッケージを実行するためにあらかじめ必要な他のパッケージがインストー
ルされるかもしれない事にも注意してください。一緒にインストールされる他のパッ
Index: using.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/using.xml,v
retrieving revision 1.30
retrieving revision 1.32
diff -u -r1.30 -r1.32
--- using.xml 15 Aug 2007 06:33:46 -0000 1.30
+++ using.xml 16 Aug 2007 09:25:16 -0000 1.32
@@ -1,4 +1,4 @@
-<!-- $NetBSD: using.xml,v 1.30 2007/08/15 06:33:46 rillig Exp $ -->
+<!-- $NetBSD: using.xml,v 1.32 2007/08/16 09:25:16 rillig Exp $ -->
<chapter id="using"> <?dbhtml filename="using.html"?>
<title>Using pkgsrc</title>
@@ -13,22 +13,13 @@
<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 9</entry><entry><filename>ftp://ftp0.mh.bbc.co.uk/pub/pkgsrc/packages/bootstrap-pkgsrc/</filename></entry></row>
- <row><entry>Solaris 10</entry><entry><filename>http://public.enst.fr/pkgsrc/packages/bootstrap-pkgsrc/</filename></entry></row>
- </tbody>
- </tgroup>
- </informaltable>
+ <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 some platforms, these
+ tools are already packages in an archive, ready to be extracted in the
+ <filename>/</filename> directory. They can be found in the <ulink
+ url="ftp://ftp.NetBSD.org/pub/pkgsrc/bootstrap-pkgsrc"><filename>bootstrap-pkgsrc</filename></ulink>
+ directory of the FTP server.</para>
<para>These pre-built package tools use
<filename>/usr/pkg</filename> for the base directory, and
@@ -41,34 +32,21 @@
<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>The 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>NetBSD</entry><entry><filename>ftp://ftp.NetBSD.org/pub/NetBSD/packages/</filename></entry></row>
- <row><entry>Solaris 9</entry><entry><filename>ftp://ftp0.mh.bbc.co.uk/pub/pkgsrc/packages/</filename></entry></row>
- <row><entry>Solaris 10</entry><entry><filename>http://public.enst.fr/pkgsrc/packages/</filename></entry></row>
- </tbody>
- </tgroup>
- </informaltable>
-
- <para>Most of these directories contain binary packages for
- multiple platforms. Select the appropriate subdirectories,
- according to your machine architecture and operating system,
- until you find a directory called <filename>All</filename>. This
- directory 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>
+ <para>To install binary packages, you first need to know from where
+ to get them. The first place where you should look is on the main
+ pkgsrc FTP server in the directory <ulink
+ url="ftp://ftp.NetBSD.org/pub/pkgsrc/packages/"><filename>/pub/pkgsrc/packages</filename></ulink>.</para>
+
+ <para>This directory contains binary packages for multiple
+ platforms. First, select your operating system. (Ignore the
+ directories with version numbers attached to it, they just exist for
+ legacy reasons.) Then, select your hardware architecture, and in the
+ third step, the OS version and the <quote>version</quote> of pkgsrc.
+ This directory contains a subdirectory called
+ <filename>All</filename>, where (almost) all binary packages are
+ stored. Almost, because vulnerable packages are moved to the
+ <filename>vulnerable</filename> directory so they don't get
+ installed accidentally.</para>
</sect2>
<sect2 id="installing-binary-packages">
@@ -84,7 +62,7 @@
packages via FTP prior to installation, you can do this
automatically by giving <command>pkg_add</command> an FTP URL:</para>
- <screen>&rprompt; <userinput>pkg_add ftp://ftp.NetBSD.org/pub/NetBSD/packages/<OSVERSION>/<ARCH>/All/package</userinput></screen>
+ <screen>&rprompt; <userinput>pkg_add ftp://ftp.NetBSD.org/pub/pkgsrc/packages/<replaceable>OPSYS</replaceable>/<replaceable>ARCH</replaceable>/<replaceable>VERSIONS</replaceable>/All/<replaceable>package</replaceable></userinput></screen>
<para>Note that any prerequisite packages needed to run the
package in question will be installed, too, assuming they are