[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Documentation/pkgsrc/using/chapter.xml: 1.5 -> 1.6
以下のページの更新をしました。ツッコミをお願いします。
Documentation/pkgsrc/using/chapter.xml: 1.5 -> 1.6
木曜日までに異議がなければ、 commit します。
以下、訳と原文の差分です。
--- Documentation/pkgsrc/using/chapter.xml.orig 2006-03-29 01:10:02.000000000 +0900
+++ Documentation/pkgsrc/using/chapter.xml 2006-03-29 01:10:02.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: chapter.xml,v 1.5 2003/06/20 04:51:34 grant Exp $ -->
+<!-- $NetBSD: chapter.xml,v 1.6 2003/06/20 05:02:09 grant Exp $ -->
<!-- Based on english version: -->
-<!-- NetBSD: chapter.xml,v 1.5 2003/06/20 04:51:34 grant Exp -->
+<!-- NetBSD: chapter.xml,v 1.6 2003/06/20 05:02:09 grant Exp -->
<chapter id="using"> <?dbhtml filename="using.html"?>
<title>NetBSD パッケージシステムを使う</title>
@@ -42,7 +42,7 @@
<command>su</command>している事を確認してください):
</para>
-<programlisting># pkg_add /path/to/package.tgz</programlisting>
+<screen><prompt>#</prompt> <userinput>pkg_add /path/to/package.tgz</userinput></screen>
<para>
もし、FTPアクセスが可能で、インストール前にFTPを使ってパッケージをダウンロー
@@ -50,7 +50,7 @@
事もできます。
</para>
-<programlisting># pkg_add ftp://ftp.NetBSD.org/pub/NetBSD/packages/<OS Ver>/<arch>/All/package.tgz</programlisting>
+<screen><prompt>#</prompt> <userinput>pkg_add ftp://ftp.NetBSD.org/pub/NetBSD/packages/<OS Ver>/<arch>/All/package.tgz</userinput></screen>
<para>
ここで <OS Ver> や <arch> がよくわからない場合は、unameユーティリティーを
@@ -114,9 +114,13 @@
<para>
あるいは、ソフトウェア更新プロトコル(Software Update Protocol) SUPを使い
-pkgsrcを入手することもできます。まず、supfileの中に<quote>release=pkgsrc</quote>という
+pkgsrcを入手することもできます。まず、supfileの中に
+
+<programlisting>release=pkgsrc</programlisting>
+
+という
行があることを確認してください。例えば、<filename>/usr/share/examples/supfiles</filename>を見て
-ください。それからディレクトリー<filename>/usr/pkgsrc</filename>が存在することを確認してください。
+ください。それから<filename>/usr/pkgsrc</filename>ディレクトリーが存在することを確認してください。
後は
<command>sup -v /path/to/your/supfile</command>
を実行するだけです。
@@ -129,10 +133,10 @@
下の手順を踏みます:
</para>
-<programlisting>% setenv CVSROOT anoncvs@anoncvs.NetBSD.org:/cvsroot
-% setenv CVS_RSH ssh
-% cd /usr
-% cvs checkout -P pkgsrc</programlisting>
+<screen><prompt>%</prompt> <userinput>setenv CVSROOT anoncvs@anoncvs.NetBSD.org:/cvsroot</userinput>
+<prompt>%</prompt> <userinput>setenv CVS_RSH ssh</userinput>
+<prompt>%</prompt> <userinput>cd /usr</userinput>
+<prompt>%</prompt> <userinput>cvs checkout -P pkgsrc</userinput></screen>
<para>
こうすると、<filename>/usr</filename>以下に<filename>pkgsrc</filename>ディレクトリーが作られ、
@@ -142,8 +146,8 @@
<varname>CVS_RSH</varname>を上のように設定してから、以下のようにします:
</para>
-<programlisting>% cd /usr/pkgsrc
-% cvs -q update -dP</programlisting>
+<screen><prompt>%</prompt> <userinput>cd /usr/pkgsrc</userinput>
+<prompt>%</prompt> <userinput>cvs -q update -dP</userinput></screen>
<para>
また、pkgsrcの階層構造を、使用中の状態で複数持つことも常にできます - すべて
@@ -191,13 +195,13 @@
移動してください。そして、シェルプロンプト上で以下のようにタイプしてくだ
さい。
-<programlisting>% make</programlisting>
+<screen><prompt>%</prompt> <userinput>make</userinput></screen>
</para>
<para>
これで、パッケージのさまざまなコンポーネントが構築されます。それから、
-<programlisting># make install</programlisting>
+<screen><prompt>#</prompt> <userinput>make install</userinput></screen>
</para>
<para>
@@ -216,15 +220,13 @@
<varname>LOCALBASE</varname>
を設定してください。この値はパッケージツリーのルートとして使用さ
れます。例えば、<filename>/usr/local</filename>を使う場合、
-
-<programlisting>LOCALBASE= /usr/local</programlisting>
-</para>
-
-<para>
-と設定してください。なお、ルートにはパッケージ専用の場所を使い、他のプログ
+<varname>LOCALBASE=/usr/local</varname> と設定してください。
+なお、ルートにはパッケージ専用の場所を使い、他のプログ
ラムと共有させないようにします(つまり、 <varname>LOCALBASE=/usr</varname> などとしてはいけませ
-ん)。また、<varname>LOCALBASE</varname>ツリー内には、独自のファイルやディレクトリー(たとえば、
-src, obj, pkgsrcのようなもの)は一切追加しないようにしてください。これは、パッ
+ん)。また、<varname>LOCALBASE</varname>ツリー内には、独自のファイルやディレクトリー
+(<filename>src/</filename>,
+<filename>obj/</filename>, <filename>pkgsrc/</filename>
+のようなもの)は一切追加しないようにしてください。これは、パッ
ケージシステムがインストールするプログラムなどのファイルが、そこにインストー
ルされているかもしれない別のファイルと衝突することがないようにするためです。
</para>
@@ -257,35 +259,41 @@
ています。
</para>
+<orderedlist>
+<listitem>
<para>
-(1) make(1)コマンドをPKG_DEBUG_LEVEL=2付きで呼び出すと、大量の情報が表示さ
-れるようになります。実際の例として、
+make(1)コマンドを<varname>PKG_DEBUG_LEVEL=2</varname>付きで呼び出すと、大量の情報が表示さ
+れるようになります。たとえば、
</para>
-<programlisting>% make patch PKG_DEBUG_LEVEL=2</programlisting>
+<screen><prompt>%</prompt> <userinput>make patch PKG_DEBUG_LEVEL=2</userinput></screen>
<para>
は、<quote>patch</quote>の段階および、そこに至るまでに呼び出されるコマンドをすべて表示し
ます。
</para>
+</listitem>
+<listitem>
<para>
-(2) 特定のmake(1)定義の値を知りたい場合は、show-varターゲットとともに、
+特定のmake(1)定義の値を知りたい場合は、show-varターゲットとともに、
<varname>VARNAME</varname>定義を使います。たとえば、
</para>
-<programlisting>% make show-var VARNAME=DISTFILES</programlisting>
+<screen><prompt>%</prompt> <userinput>make show-var VARNAME=DISTFILES</userinput></screen>
<para>
は、make(1)変数
<varname>DISTFILES</varname>の展開結果を表示します。
</para>
+</listitem>
+</orderedlist>
<para>
自分で作った(次章参照)、手動でpkgsrc/packagesに置いた、またはリモートFTPサー
バーに置かれたバイナリーパッケージを、アンインストールおよび再インストール
したい場合は、"bin-install"ターゲットを使うことができます。このターゲットは、
-- もし可能ならば - pkg_addを使ってバイナリーパッケージをインストールするほ
+- もし可能ならば - <command>pkg_add</command>を使ってバイナリーパッケージをインストールするほ
か、<command>make package</command>をおこないます。検索先リモートFTPサーバーのリストは
<varname>BINPKG_SITE</varname>変数に保持され、デフォルトはftp.NetBSD.orgです。pkg_add(8)に与え
るべきフラグはすべて、<varname>BIN_INSTALL_FLAGS</varname>変数で保持することができます。詳細は
Index: Documentation/pkgsrc/using/chapter.xml
===================================================================
RCS file: /cvsroot/htdocs/Documentation/pkgsrc/using/Attic/chapter.xml,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- Documentation/pkgsrc/using/chapter.xml 20 Jun 2003 04:51:34 -0000 1.5
+++ Documentation/pkgsrc/using/chapter.xml 20 Jun 2003 05:02:09 -0000 1.6
@@ -1,4 +1,4 @@
-<!-- $NetBSD: chapter.xml,v 1.5 2003/06/20 04:51:34 grant Exp $ -->
+<!-- $NetBSD: chapter.xml,v 1.6 2003/06/20 05:02:09 grant Exp $ -->
<chapter id="using"> <?dbhtml filename="using.html"?>
<title>Using The NetBSD package system</title>
@@ -41,7 +41,7 @@
<command>su</command> to root first):
</para>
-<programlisting># pkg_add /path/to/package.tgz</programlisting>
+<screen><prompt>#</prompt> <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
@@ -49,7 +49,7 @@
<command>pkg_add</command> an FTP URL:
</para>
-<programlisting># pkg_add ftp://ftp.NetBSD.org/pub/NetBSD/packages/<OS Ver>/<arch>/All/package.tgz</programlisting>
+<screen><prompt>#</prompt> <userinput>pkg_add ftp://ftp.NetBSD.org/pub/NetBSD/packages/<OS Ver>/<arch>/All/package.tgz</userinput></screen>
<para>
If there is any doubt, the uname utility can be used to determine the
@@ -115,9 +115,12 @@
<para>
As an alternative, you can get pkgsrc via the Software Update Protocol,
SUP. To do so, make sure your supfile has a line
-<quote>release=pkgsrc</quote> in it, see the examples in
+
+<programlisting>release=pkgsrc</programlisting>
+
+in it, see the examples in
<filename>/usr/share/examples/supfiles</filename>, and that the
-directory <filename>/usr/pkgsrc</filename> does exist. Then, simply run
+<filename>/usr/pkgsrc</filename> directory exists. Then, simply run
<command>sup -v /path/to/your/supfile</command>.
</para>
@@ -127,10 +130,10 @@
To do an initial (full) checkout of pkgsrc, do the following steps:
</para>
-<programlisting>% setenv CVSROOT anoncvs@anoncvs.NetBSD.org:/cvsroot
-% setenv CVS_RSH ssh
-% cd /usr
-% cvs checkout -P pkgsrc</programlisting>
+<screen><prompt>%</prompt> <userinput>setenv CVSROOT anoncvs@anoncvs.NetBSD.org:/cvsroot</userinput>
+<prompt>%</prompt> <userinput>setenv CVS_RSH ssh</userinput>
+<prompt>%</prompt> <userinput>cd /usr</userinput>
+<prompt>%</prompt> <userinput>cvs checkout -P pkgsrc</userinput></screen>
<para>
This will create the <filename>pkgsrc</filename> directory in your
@@ -140,8 +143,8 @@
<varname>CVS_RSH</varname> set as above, then do:
</para>
-<programlisting>% cd /usr/pkgsrc
-% cvs -q update -dP</programlisting>
+<screen><prompt>%</prompt> <userinput>cd /usr/pkgsrc</userinput>
+<prompt>%</prompt> <userinput>cvs -q update -dP</userinput></screen>
<para>
Please also note that it is possible to have multiple copies of the
@@ -190,13 +193,13 @@
Assuming that the distfile has been fetched (see previous section), become
root and change into the relevant directory. Then you can type
-<programlisting>% make</programlisting>
+<screen><prompt>%</prompt> <userinput>make</userinput></screen>
</para>
<para>
at the shell prompt to build the various components of the package, and
-<programlisting># make install</programlisting>
+<screen><prompt>#</prompt> <userinput>make install</userinput></screen>
</para>
<para>
@@ -215,18 +218,15 @@
simply set the <varname>LOCALBASE</varname>
variable in your environment, and it will use that value as the root of
your packages tree. So, to use <filename>/usr/local</filename>, set
-
-<programlisting>LOCALBASE= /usr/local</programlisting>
-</para>
-
-<para>
-in your environment. Please note that you should use a root which is
+<varname>LOCALBASE=/usr/local</varname> in your environment. Please note
+that you should use a root which is
dedicated to packages and not shared with other programs (ie, do not try
and use <varname>LOCALBASE=/usr</varname>). Also, you should not try to
-add any of your own files or directories (such as, for example, src, obj,
-or pkgsrc) below the <varname>LOCALBASE</varname> tree. This is to
-prevent possible conflicts between programs and other files installed by
-the package system and whatever else may have been installed there.
+add any of your own files or directories (such as <filename>src/</filename>,
+<filename>obj/</filename>, or <filename>pkgsrc/</filename>) below the
+<varname>LOCALBASE</varname> tree. This is to prevent possible conflicts
+between programs and other files installed by the package system and
+whatever else may have been installed there.
</para>
<para>
@@ -259,37 +259,44 @@
values have been added to help with this.
</para>
+<orderedlist>
+<listitem>
<para>
-(1) If you invoke the make(1) command with PKG_DEBUG_LEVEL=2, then a
-huge amount of information will be displayed. As a worked example,
+If you invoke the make(1) command with <varname>PKG_DEBUG_LEVEL=2</varname>,
+then a huge amount of information will be displayed. For example,
</para>
-<programlisting>% make patch PKG_DEBUG_LEVEL=2</programlisting>
+<screen><prompt>%</prompt> <userinput>make patch PKG_DEBUG_LEVEL=2</userinput></screen>
<para>
will show all the commands that are invoked, up to and including the
<quote>patch</quote> stage.
</para>
+</listitem>
+<listitem>
<para>
-(2) If you want to know the value of a certain make(1) definition, then
+If you want to know the value of a certain make(1) definition, then
the <varname>VARNAME</varname> definition should be used, in conjunction
with the show-var target. e.g.
</para>
-<programlisting>% make show-var VARNAME=DISTFILES</programlisting>
+<screen><prompt>%</prompt> <userinput>make show-var VARNAME=DISTFILES</userinput></screen>
<para>
will show the expansion of the make(1) variable
<varname>DISTFILES</varname>.
</para>
+</listitem>
+</orderedlist>
<para>
If you want to de-install and re-install a binary package that you've
created (see next section), that you put into pkgsrc/packages manually or
that's located on a remote FTP server, you can use the the "bin-install"
target. This target will install a binary package - if available - via
-pkg_add, and do a <command>make package</command> else. The list of remote
+<command>pkg_add</command>, else do a <command>make package</command>.
+The list of remote
FTP sites searched is kept in the variable
<varname>BINPKG_SITE</varname>, which defaults to
ftp.NetBSD.org. Any flags that should be added to pkg_add(8) can be put