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

pkgsrc/doc/guide/files/using.xml: 1.5 -> 1.8



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

pkgsrc/doc/guide/files/using.xml: 1.5 -> 1.8

> revision 1.8
> date: 2005/05/07 15:35:11;  author: wiz;  state: Exp;  lines: +3 -3
> Fix previous: paragraph should end after last letters.
> ----------------------------
> revision 1.7
> date: 2005/05/06 21:24:21;  author: wiz;  state: Exp;  lines: +3 -1
> Mention that semicolon is a shell meta-character and that it probably
> needs quoting in the PKG_PATH, to avoid user confusion.
> Reviewed by dillo.
> ----------------------------
> revision 1.6
> date: 2005/05/06 00:46:43;  author: wiz;  state: Exp;  lines: +19 -2
> Fix a typo. Document PKG_PATH. Document vulnerable/ directory.
> Reviewed by dillo, rillig, salo.

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

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

--- using.xml.orig	2006-09-06 22:09:32.000000000 +0900
+++ using.xml	2006-09-06 22:09:32.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: using.xml,v 1.5 2005/04/11 16:38:21 reed Exp $ -->
+<!-- $NetBSD: using.xml,v 1.8 2005/05/07 15:35:11 wiz Exp $ -->
 <!-- Based on english version: -->
-<!-- NetBSD: using.xml,v 1.5 2005/04/11 16:38:21 reed Exp   -->
+<!-- NetBSD: using.xml,v 1.8 2005/05/07 15:35:11 wiz Exp   -->
 
 <chapter id="using"> <?dbhtml filename="using.html"?>
   <title>pkgsrc を使う</title>
@@ -54,6 +54,26 @@
         ルされるかもしれない事にも注意してください。一緒にインストールされる他のパッ
         ケージも同じ場所に存在していると仮定されます。 </para>
 
+      <para>タイプを少なくするために、パス (リモート URL を含む)
+        をセミコロンで区切ったものを <varname>PKG_PATH</varname>
+        環境変数に設定することができます。
+        このパスの末尾にスラッシュをつけることはできません。 </para>
+
+      <para><filename>All</filename> ディレクトリーのほかに、
+        脆弱性が知られているバイナリーパッケージの移動先である
+        <filename>vulnerable</filename> ディレクトリーが存在します。
+        バイナリーパッケージを削除してしまうと、
+        依存性が失われることがあるため、移動するのです。
+        ここに移動されたパッケージを使うためには、<varname>PKG_PATH</varname>
+        に <filename>vulnerable</filename> ディレクトリーを追加します。ただし、
+        <pkg>security/audit-packages</pkg> を定期的に
+        (特に、パッケージを新たにインストールした後には) 実行して、
+        脆弱性の影響がある構成となっているかどうかを確認するようにしてください。
+        <varname>PKG_PATH</varname> はたとえば以下のようになります:
+      <filename>ftp://ftp.NetBSD.org/pub/NetBSD/packages/&lt;OSvers&gt;/&lt;arch&gt;/All;ftp://ftp.NetBSD.org/pub/NetBSD/packages/&lt;OSvers&gt;/&lt;arch&gt;/vulnerable</filename>
+        なお、セミコロン (';') はシェルにとって特別な意味を持つ文字ですので、
+        クォートする必要があるでしょう。</para>
+
       <para>パッケージをインストールした後に、<varname>PATH</varname>に <filename>/usr/pkg/bin</filename> が含まれている事を確
         認してください。これで、インストールされたプログラムを実際に使い始めること
         ができます。 </para>
Index: using.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/using.xml,v
retrieving revision 1.5
retrieving revision 1.8
diff -u -r1.5 -r1.8
--- using.xml	11 Apr 2005 16:38:21 -0000	1.5
+++ using.xml	7 May 2005 15:35:11 -0000	1.8
@@ -1,4 +1,4 @@
-<!-- $NetBSD: using.xml,v 1.5 2005/04/11 16:38:21 reed Exp $ -->
+<!-- $NetBSD: using.xml,v 1.8 2005/05/07 15:35:11 wiz Exp $ -->
 
 <chapter id="using"> <?dbhtml filename="using.html"?>
   <title>Using pkgsrc</title>
@@ -36,7 +36,7 @@
       <title>How to use binary packages</title>
       
       <para> If you have the files on a CDROM or downloaded them to
-        your hard disk, youcan install them with the following command
+        your hard disk, you can install them with the following command
         (be sure to<command>su</command> to root first):</para>
 
         <screen><prompt>#</prompt> <userinput>pkg_add /path/to/package.tgz</userinput></screen>
@@ -56,6 +56,25 @@
         package in question will be installed, too, assuming they are
         present where you install from. </para>
 
+      <para>To save some typing, you can set the
+        <varname>PKG_PATH</varname> environment variable to a semicolon
+        separated list of paths (including remote URLs); trailing
+        slashes are not allowed. </para>
+
+      <para>Additionally to the <filename>All</filename> directory
+        there exists a <filename>vulnerable</filename> directory to
+        which binary packages with known vulnerabilities are
+        moved, since removing them could cause missing dependencies. To
+        use these packages, add the <filename>vulnerable</filename>
+        directory to your <varname>PKG_PATH</varname>. However, you should run
+        <pkg>security/audit-packages</pkg> regularly, and especially after
+        installing new packages, and verify that the vulnerabilities are
+        acceptable for your configuration. An example
+        <varname>PKG_PATH</varname> would be:
+      <filename>ftp://ftp.NetBSD.org/pub/NetBSD/packages/&lt;OSvers&gt;/&lt;arch&gt;/All;ftp://ftp.NetBSD.org/pub/NetBSD/packages/&lt;OSvers&gt;/&lt;arch&gt;/vulnerable</filename>
+        Please note that semicolon (';') is a shell meta-character, so
+        you'll probably have to quote it.</para>
+
       <para>After you've installed packages, be sure to have
         <filename>/usr/pkg/bin</filename> in your
         <varname>PATH</varname> so you can actually start the just