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

pkgsrc/doc/guide/files/using.xml: 1.25 -> 1.26



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

pkgsrc/doc/guide/files/using.xml: 1.25 -> 1.26

> revision 1.26
> date: 2006/09/13 23:39:07;  author: wiz;  state: Exp;  lines: +508 -492
> Use &cprompt;. Do not mention not-existing INET_COUNTRY.
> Describe MASTER_SORT and MASTER_SORT_REGEX.

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

原文は
http://cvsweb.de.NetBSD.org/cgi-bin/cvsweb.cgi/pkgsrc/doc/guide/files/using.xml?rev=1.26&content-type=text/plain
で、訳文は
http://www.na.rim.or.jp/%7Ekano/tmp/pkgsrc/doc/guide/files/using.xml
に置いてあります。

以下、訳と原文それぞれの、
1.25 から空白類文字を調節したものと 1.26 との差分です。

--- using.xml.orig	2006-12-30 17:10:43.000000000 +0900
+++ using.xml	2006-12-30 17:25:20.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: using.xml,v 1.25 2006/09/10 19:33:05 wiz Exp $ -->
+<!-- $NetBSD: using.xml,v 1.26 2006/09/13 23:39:07 wiz Exp $ -->
 <!-- Based on english version: -->
-<!-- NetBSD: using.xml,v 1.25 2006/09/10 19:33:05 wiz Exp   -->
+<!-- NetBSD: using.xml,v 1.26 2006/09/13 23:39:07 wiz Exp   -->
 
 <chapter id="using"> <?dbhtml filename="using.html"?>
 <title>pkgsrc を使う</title>
@@ -86,13 +86,13 @@
     ことができます(最初にrootに
     <command>su</command>している事を確認してください):</para>
 
-    <screen><prompt>#</prompt> <userinput>pkg_add /path/to/package.tgz</userinput></screen>
+    <screen>&rprompt; <userinput>pkg_add /path/to/package.tgz</userinput></screen>
 
     <para>もし、FTPアクセスが可能で、インストール前にFTPを使ってパッケージをダウンロー
     ドしたくないのであれば、<command>pkg_add</command>にFTPのURLを指定して自動でダウンロードさせる
     事もできます。</para>
 
-    <screen><prompt>#</prompt> <userinput>pkg_add ftp://ftp.NetBSD.org/pub/NetBSD/packages/&lt;OSVERSION&gt;/&lt;ARCH&gt;/All/package</userinput></screen>
+    <screen>&rprompt; <userinput>pkg_add ftp://ftp.NetBSD.org/pub/NetBSD/packages/&lt;OSVERSION&gt;/&lt;ARCH&gt;/All/package</userinput></screen>
 
     <para>パッケージを実行するためにあらかじめ必要な他のパッケージがインストー
     ルされるかもしれない事にも注意してください。一緒にインストールされる他のパッ
@@ -213,7 +213,7 @@
       <command>lintpkgsrc</command> に <quote>-i</quote> を付けて実行します。たとえば以下のようになります。
     </para>
     <screen>
-<prompt>%</prompt> <userinput>lintpkgsrc -i</userinput>
+&cprompt; <userinput>lintpkgsrc -i</userinput>
 ...
 Version mismatch: 'tcsh' 6.09.00 vs 6.10.00
     </screen>
@@ -299,9 +299,14 @@
 
     <para>主要な配布サイトをあなたのところに近いサイトで上書きす
     ることができます。
-    <filename>pkgsrc/mk/defaults/mk.conf</filename>の例の、特に<varname>MASTER_SORT</varname>,
-    <varname>MASTER_SORT_REGEX</varname>,
-    <varname>INET_COUNTRY</varname> 定義を参照してください。これにより、帯域幅
+    変数をひとつかふたつ設定すると、
+    マスターサイトにアクセスする順序を変えることができます。
+    <varname>MASTER_SORT</varname> には、
+    ドメインの接尾辞を空白で区切ったリストが含まれます。
+    <varname>MASTER_SORT_REGEX</varname> はこれより柔軟なもので、
+    正規表現を空白で区切ったリストが含まれます。
+    これは <varname>MASTER_SORT</varname> より高い優先度を持ちます。
+    <filename>pkgsrc/mk/defaults/mk.conf</filename>の例を参照してください。これにより、帯域幅
     と時間が節約できるかもしれません。</para>
 
     <para>これらの設定は、シェルの環境変数でも変更できますし、その設定を今後も有効に
@@ -315,7 +320,7 @@
       ダウンロードとコンパイルを交互に繰り返すことがあります。
       最初に必要なすべてのソースを確実にダウンロードするには、
       次のコマンドを使用します:
-      <screen><prompt>%</prompt> <userinput>make fetch-list | sh</userinput></screen>
+      <screen>&cprompt; <userinput>make fetch-list | sh</userinput></screen>
       このコマンドは必要なファイルを取ってきて<filename>distfiles</filename> ディレクトリー
       に保存するためのシェルコマンドを出力、実行します。必要なファイルを手動で
       ダウンロードするという方法もあります。
@@ -351,7 +356,7 @@
     インストールしようとしているパッケージのディレクトリーにいる間に
 
     <screen>
-<prompt>%</prompt> <userinput>make install</userinput>
+&cprompt; <userinput>make install</userinput>
     </screen>
 
     と入力してください。</para>
@@ -365,7 +370,7 @@
     もうこれ以上コンパイル後の作業ファイルは必要とされないので、
 
     <screen>
-<prompt>%</prompt> <userinput>make clean</userinput>
+&cprompt; <userinput>make clean</userinput>
     </screen>
 
     と入力し作業ディレクトリー内のファイルを削除してしまってもかまいません。
@@ -374,7 +379,7 @@
     それらも次のコマンドにより、きちんと削除することができます。</para>
 
     <screen>
-<prompt>%</prompt> <userinput>make clean-depends</userinput>
+&cprompt; <userinput>make clean-depends</userinput>
     </screen>
 
     <para>figlet ユーティリティーを例にあげると、<xref linkend="logs"/>のように構築することに
--- using.xml.orig	2006-12-30 17:10:48.000000000 +0900
+++ using.xml	2006-12-30 16:21:20.000000000 +0900
@@ -1,4 +1,4 @@
-<!-- $NetBSD: using.xml,v 1.25 2006/09/10 19:33:05 wiz Exp $ -->
+<!-- $NetBSD: using.xml,v 1.26 2006/09/13 23:39:07 wiz Exp $ -->
 
 <chapter id="using"> <?dbhtml filename="using.html"?>
 <title>Using pkgsrc</title>
@@ -78,13 +78,13 @@
     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>
+    <screen>&rprompt; <userinput>pkg_add /path/to/package.tgz</userinput></screen>
 
     <para>If you have FTP access and you don't want to download the
     packages via FTP prior to installation, you can do this
     automatically by giving <command>pkg_add</command> an FTP URL:</para>
 
-    <screen><prompt>#</prompt> <userinput>pkg_add ftp://ftp.NetBSD.org/pub/NetBSD/packages/&lt;OSVERSION&gt;/&lt;ARCH&gt;/All/package</userinput></screen>
+    <screen>&rprompt; <userinput>pkg_add ftp://ftp.NetBSD.org/pub/NetBSD/packages/&lt;OSVERSION&gt;/&lt;ARCH&gt;/All/package</userinput></screen>
 
     <para>Note that any prerequisite packages needed to run the
     package in question will be installed, too, assuming they are
@@ -199,7 +199,7 @@
       argument to check if your packages are up-to-date, e.g.
     </para>
     <screen>
-<prompt>%</prompt> <userinput>lintpkgsrc -i</userinput>
+&cprompt; <userinput>lintpkgsrc -i</userinput>
 ...
 Version mismatch: 'tcsh' 6.09.00 vs 6.10.00
     </screen>
@@ -286,13 +286,15 @@
     to your <filename>mk.conf</filename>.</para>
 
     <para>You can overwrite some of the major distribution sites to
-    fit to sites that are close to your own.  Have a
+    fit to sites that are close to your own.  By setting one or two
+    variables you can modify the order in which the master sites are
+    accessed.  <varname>MASTER_SORT</varname> contains a whitespace
+    delimited list of domain suffixes.
+    <varname>MASTER_SORT_REGEX</varname> is even more flexible, it
+    contains a whitespace delimited list of regular expressions.  It
+    has higher priority than <varname>MASTER_SORT</varname>.  Have a
     look at <filename>pkgsrc/mk/defaults/mk.conf</filename> to find
-    some examples
-    &mdash; in particular, look for the <varname>MASTER_SORT</varname>,
-    <varname>MASTER_SORT_REGEX</varname> and
-    <varname>INET_COUNTRY</varname> definitions.  This may save some of your
-    bandwidth and
+    some examples.  This may save some of your bandwidth and
     time.</para>
 
     <para>You can change these settings either in your shell's environment, or,
@@ -306,7 +308,7 @@
       alternate between periods of
       downloading source, and compiling. To ensure you have all the source
       downloaded initially you can run the command:
-      <screen><prompt>%</prompt> <userinput>make fetch-list | sh</userinput></screen>
+      <screen>&cprompt; <userinput>make fetch-list | sh</userinput></screen>
       which will output and run a set of shell commands to fetch the
       necessary files into the <filename>distfiles</filename> directory.  You can
       also choose to download the files manually.
@@ -342,7 +344,7 @@
     program onto your system. Do this by entering:
 
     <screen>
-<prompt>%</prompt> <userinput>make install</userinput>
+&cprompt; <userinput>make install</userinput>
     </screen>
 
     while you are still in the directory for whatever package you
@@ -357,7 +359,7 @@
     You can now enter:
 
     <screen>
-<prompt>%</prompt> <userinput>make clean</userinput>
+&cprompt; <userinput>make clean</userinput>
     </screen>
 
     to remove the compiled files in the work directory, as you shouldn't need
@@ -366,7 +368,7 @@
     also with the command:</para>
 
     <screen>
-<prompt>%</prompt> <userinput>make clean-depends</userinput>
+&cprompt; <userinput>make clean-depends</userinput>
     </screen>
 
     <para>Taking the figlet utility as an example, we can install it on our