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

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



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

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

> revision 1.9
> date: 2005/05/15 20:38:40;  author: rillig;  state: Exp;  lines: +23 -19
> Fixed some typos. Using uppercase names for variable parts of PKG_PATH.
> Added /usr/pkg/sbin to the list of directories in which tools can be
> installed.

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

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

--- using.xml.orig	2006-09-08 00:31:22.000000000 +0900
+++ using.xml	2006-09-08 00:31:22.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: using.xml,v 1.8 2005/05/07 15:35:11 wiz Exp $ -->
+<!-- $NetBSD: using.xml,v 1.9 2005/05/15 20:38:40 rillig Exp $ -->
 <!-- Based on english version: -->
-<!-- NetBSD: using.xml,v 1.8 2005/05/07 15:35:11 wiz Exp   -->
+<!-- NetBSD: using.xml,v 1.9 2005/05/15 20:38:40 rillig Exp   -->
 
 <chapter id="using"> <?dbhtml filename="using.html"?>
   <title>pkgsrc を使う</title>
@@ -15,8 +15,12 @@
       <title>バイナリーパッケージの配布場所</title>
       
       <para> コンパイル済みのパッケージは、ftp.NetBSD.orgおよびそのミラー上の、匿名FTPア
-        クセスのためのディレクトリー<filename>/pub/NetBSD/packages</filename>に置かれています。
-        <command>uname -p</command>で表示されるのと同じサブディレクトリーを選択してください。このディレクト
+        クセスのためのディレクトリー
+        <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>ファイル形式で実際
@@ -44,13 +48,9 @@
         事もできます。
         </para>
 
-      <screen><prompt>#</prompt> <userinput>pkg_add ftp://ftp.NetBSD.org/pub/NetBSD/packages/&lt;OSvers&gt;/&lt;arch&gt;/All/package.tgz</userinput></screen>
+      <screen><prompt>#</prompt> <userinput>pkg_add ftp://ftp.NetBSD.org/pub/NetBSD/packages/&lt;OSVERSION&gt;/&lt;ARCH&gt;/All/package.tgz</userinput></screen>
 
-      <para>ここで &lt;OSvers&gt; や
-        &lt;arch&gt; がよくわからない場合は、unameユーティリティーを
-        <command>uname -rp</command>のように使って調べられます。 </para>
-
-      <para>また、パッケージを実行するためにあらかじめ必要な他のパッケージがインストー
+      <para>パッケージを実行するためにあらかじめ必要な他のパッケージがインストー
         ルされるかもしれない事にも注意してください。一緒にインストールされる他のパッ
         ケージも同じ場所に存在していると仮定されます。 </para>
 
@@ -70,11 +70,12 @@
         (特に、パッケージを新たにインストールした後には) 実行して、
         脆弱性の影響がある構成となっているかどうかを確認するようにしてください。
         <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>
+      <filename>ftp://ftp.NetBSD.org/pub/NetBSD/packages/&lt;OSVERSION&gt;/&lt;ARCH&gt;/All;ftp://ftp.NetBSD.org/pub/NetBSD/packages/&lt;OSVERSION&gt;/&lt;ARCH&gt;/vulnerable</filename>
         なお、セミコロン (';') はシェルにとって特別な意味を持つ文字ですので、
         クォートする必要があるでしょう。</para>
 
-      <para>パッケージをインストールした後に、<varname>PATH</varname>に <filename>/usr/pkg/bin</filename> が含まれている事を確
+      <para>パッケージをインストールした後に、<varname>PATH</varname>に
+        <filename>/usr/pkg/bin</filename> と <filename>/usr/pkg/sbin</filename> が含まれている事を確
         認してください。これで、インストールされたプログラムを実際に使い始めること
         ができます。 </para>
     </sect2>
@@ -93,7 +94,8 @@
     <title>ソースからパッケージを構築する</title>
     
     <para> ここでは、パッケージがすでに pkgsrc に含まれていると仮定
-      しています。もし、そうでなれば、<xref linkend="developers-guide"/>をご覧ください。 </para>
+      しています。もし、そうでなれば、<xref linkend="developers-guide"/>で、
+      パッケージを新たに作る方法をご覧ください。 </para>
 
     <sect2>
       <title>必要なもの</title>
@@ -102,16 +104,16 @@
         <quote>comp</quote>および<quote>text</quote>
         配布物一式をインストールしておく必要があります。X11関連のパッケージを
         構築する場合は、さらに<quote>xbase</quote>および<quote>xcomp</quote> 配布物一式も必要です。</para>
+      <!-- FIXME: what about installing x11/XFree86-*? -->
     </sect2>
     
 
     <sect2>
       <title>配布ファイルの取得</title>
 
-      <para>パッケージシステムを構築するためには、
-        配布ファイル(未変更のソース)がシステム上に存在していなけれ
-        ばなりません。配布ファイルが存在しない場合、pkgsrc は &man.ftp.1;
-        を使って自動的に配布ファイルを取得します。</para>
+      <para>パッケージを構築するうえで最初にすることは、配布ファイル (未変更のソース)
+      のダウンロードです。配布ファイルがまだダウンロードされていない場合、
+      pkgsrc は自動的に配布ファイルを取得します。</para>
 
       <para>主要な配布サイトをあなたのところに近いサイトで上書きす
         ることができます。
@@ -241,6 +243,7 @@
             <para> パッケージ構築時に使われる一連のコンパイラーを指定する値を並べたものです。
               以下の値を使うことができます。 </para>
             
+<!-- TODO: update this list after jlam's changes in May 2005 -->
             <itemizedlist>
               <listitem><para><varname>distcc</varname>:
                 分散 C/C++ コンパイラー (連鎖可能)</para>
@@ -279,6 +282,10 @@
 	
         <varlistentry>
           <term><varname>GCC_REQD</varname>:</term>
+<!--
+   TODO: what are the effects of setting GCC_REQD if PKGSRC_COMPILER
+   is not gcc?
+-->
           <listitem>
             <para> パッケージの構築用として、最低限必要な
               GCC のバージョンを指定します。システム附属の GCC
Index: using.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/using.xml,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- using.xml	7 May 2005 15:35:11 -0000	1.8
+++ using.xml	15 May 2005 20:38:40 -0000	1.9
@@ -1,4 +1,4 @@
-<!-- $NetBSD: using.xml,v 1.8 2005/05/07 15:35:11 wiz Exp $ -->
+<!-- $NetBSD: using.xml,v 1.9 2005/05/15 20:38:40 rillig Exp $ -->
 
 <chapter id="using"> <?dbhtml filename="using.html"?>
   <title>Using pkgsrc</title>
@@ -15,9 +15,11 @@
       
       <para> Precompiled packages are stored on ftp.NetBSD.org and its
         mirrors in the directory
-        <filename>/pub/NetBSD/packages</filename> for anonymous FTP
-        access.  Please pick the right subdirectory there as indicated
-        by <command>uname -p</command>. In that directory, there is a
+        <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
@@ -37,7 +39,7 @@
       
       <para> If you have the files on a CDROM or downloaded them to
         your hard disk, you can install them with the following command
-        (be sure to<command>su</command> to root first):</para>
+        (be sure to <command>su</command> to root first):</para>
 
         <screen><prompt>#</prompt> <userinput>pkg_add /path/to/package.tgz</userinput></screen>
 
@@ -46,13 +48,9 @@
         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;OSvers&gt;/&lt;arch&gt;/All/package.tgz</userinput></screen>
+      <screen><prompt>#</prompt> <userinput>pkg_add ftp://ftp.NetBSD.org/pub/NetBSD/packages/&lt;OSVERSION&gt;/&lt;ARCH&gt;/All/package.tgz</userinput></screen>
 
-      <para>If there is any doubt, the uname utility can be used to
-        determine the &lt;OSvers&gt;, and &lt;arch&gt; by running
-        <command>uname -rp</command>. </para>
-
-      <para>Also note that any prerequisite packages needed to run the
+      <para>Note that any prerequisite packages needed to run the
         package in question will be installed, too, assuming they are
         present where you install from. </para>
 
@@ -71,12 +69,12 @@
         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>
+      <filename>ftp://ftp.NetBSD.org/pub/NetBSD/packages/&lt;OSVERSION&gt;/&lt;ARCH&gt;/All;ftp://ftp.NetBSD.org/pub/NetBSD/packages/&lt;OSVERSION&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
+        <filename>/usr/pkg/bin</filename> and <filename>/usr/pkg/sbin</filename> in your
         <varname>PATH</varname> so you can actually start the just
         installed program. </para> 
     </sect2>
@@ -97,7 +95,8 @@
     <title>Building packages from source</title>
     
     <para> This assumes that the package is already in pkgsrc. If it
-      is not, see <xref linkend="developers-guide"/>. </para>
+      is not, see <xref linkend="developers-guide"/> for instructions
+      how to create your own packages.</para>
 
     <sect2>
       <title>Requirements</title>
@@ -107,21 +106,21 @@
         sets must be installed. If you want to build X11 related
         packages the <quote>xbase</quote> and <quote>xcomp</quote>
         distribution sets are required, too.</para>
+      <!-- FIXME: what about installing x11/XFree86-*? -->
     </sect2>
     
 
     <sect2>
       <title>Fetching distfiles</title>
 
-      <para>The distfile (i.e. the unmodified source)
-        must exist on your system for the packages system to be able
-        to build it. If it does not exist, pkgsrc will use &man.ftp.1; to
-        fetch it automatically.</para>
+      <para>The first step for building a package is downloading the
+      distfiles (i.e. the unmodified source). If they have not yet been
+      downloaded, pkgsrc will fetch them automatically.</para>
 
       <para>You can overwrite some of the major distribution sites to fit to sites
         that are close to your own.  Have a look at
         <filename>pkgsrc/mk/defaults/mk.conf</filename> to find some examples
-        - in particular, look for the <varname>MASTER_SORT</varname>,
+        &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 time.</para>
@@ -253,6 +252,7 @@
               compilers to invoke when building packages.  Valid values
               are: </para>
             
+<!-- TODO: update this list after jlam's changes in May 2005 -->
             <itemizedlist>
               <listitem><para><varname>distcc</varname>:
                 distributed C/C++ (chainable)</para>
@@ -292,6 +292,10 @@
 	
         <varlistentry>
           <term><varname>GCC_REQD</varname>:</term>
+<!--
+   TODO: what are the effects of setting GCC_REQD if PKGSRC_COMPILER
+   is not gcc?
+-->
           <listitem>
             <para> This specifies the minimum version of GCC to use
               when building packages.  If the system GCC doesn't