[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
pkgsrc/doc/guide/files/getting.xml: 1.9 -> 1.11
以下のページの更新をしました。ツッコミをお願いします。
pkgsrc/doc/guide/files/getting.xml: 1.9 -> 1.11
> revision 1.11
> date: 2006/05/31 11:44:07; author: rillig; state: Exp; lines: +9 -10
> Clarified a bit on why updating pkgsrc using a tar file is discouraged.
> ----------------------------
> revision 1.10
> date: 2006/05/28 20:37:52; author: rillig; state: Exp; lines: +157 -68
> Rewrote the chapter on "getting pkgsrc and keeping it up-to-date" based on
> the current discussion on the pkgsrc-users mailing list.
火曜日までに異議がなければ、 commit します。
via SUP の節がそのまま残っているほかは、
全面的に書き直されているので、訳も全部書き直しです。
原文は
http://cvsweb.NetBSD.org/bsdweb.cgi/%7Echeckout%7E/pkgsrc/doc/guide/files/getting.xml?rev=1.11&content-type=text/plain
http://cvsweb.NetBSD.org/bsdweb.cgi/%7Echeckout%7E/htdocs/Documentation/pkgsrc/getting.html?rev=1.30&content-type=text/html
で、訳文は
http://www.na.rim.or.jp/%7Ekano/tmp/pkgsrc/doc/guide/files/getting.xml
http://www.na.rim.or.jp/%7Ekano/tmp/Documentation/pkgsrc/getting.html
に置いてあります。
以下は原文との差分です。
--- getting.xml.orig 2006-11-15 01:17:49.000000000 +0900
+++ getting.xml 2006-11-19 20:38:36.000000000 +0900
@@ -1,88 +1,88 @@
<!-- $NetBSD: getting.xml,v 1.11 2006/05/31 11:44:07 rillig Exp $ -->
<chapter id="getting">
-<title>Where to get pkgsrc and how to keep it up-to-date</title>
+<title>どこからpkgsrcを得て、どうやって最新に保つか</title>
- <para>The most common location where pkgsrc is installed is
- <filename>/usr/pkgsrc</filename> for the <quote>package
- sources</quote> and <filename>/usr/pkg</filename> for the
- installed binary packages. You are though free to install the
- sources and binary packages wherever you want in your
- filesystem, provided that both paths do not contain white-space
- or other characters that are interpreted specially by the shell
- and some other programs. A safe bet is to use only letters,
- digits, underscores and dashes in the names.</para>
+ <para>もっとも一般的な pkgsrc のインストール場所は、
+ <quote>パッケージのソース</quote> は <filename>/usr/pkgsrc</filename>
+ であり、バイナリーパッケージのインストール先は
+ <filename>/usr/pkg</filename> です。ソースおよびバイナリーパッケージは、
+ ファイルシステム中のどこでも好きな場所にインストールしてかまいませんが、
+ シェルその他のプログラムにとって特別な意味を持つスペースなどの文字は、
+ パスに含めてはいけません。パス名には、
+ アルファベット、数字、下線とダッシュだけを使うのが安全な方法です。</para>
<sect1 id="getting-first">
-<title>Getting pkgsrc for the first time</title>
+<title>pkgsrc を初めて入手する</title>
- <para>Before you download any pkgsrc files, you should decide
- whether you want the <emphasis>current</emphasis> branch or the
- <emphasis>stable</emphasis> branch. The latter is forked on a
- quarterly basis from the current branch and only gets modified
- for security updates. The names of the stable branches are built
- from the year and the quarter, for example
- <literal>2006Q1</literal>.</para>
+ <para>pkgsrc のファイルをダウンロードする前に、
+ <emphasis>current</emphasis> 枝と <emphasis>stable</emphasis>
+ (安定版) 枝のどちらを使うのかを決めます。
+ 後者は、current 枝から四半期ごとに分岐するもので、
+ セキュリティー上の更新に限って修正されます。
+ stable 枝の名前は、年と四半期を組み合わせたもので、たとえば
+ <literal>2006Q1</literal> となります。</para>
- <para>The second step is to decide <emphasis>how</emphasis> you
- want to download pkgsrc. You can get it as a tar file, via SUP,
- or via CVS. All three ways are described here.</para>
+ <para>次に、pkgsrc を<emphasis>どの方法で</emphasis>
+ ダウンロードするかを決めます。方法としては、tarファイル、SUP経由、
+ CVS経由があります。ここではこの三つとも説明します。</para>
<sect2 id="getting-via-tar">
-<title>As tar file</title>
+<title>tar ファイル</title>
- <para>The primary download location for all pkgsrc files is
- <ulink url="ftp://ftp.NetBSD.org/pub/pkgsrc/"/>. There are a
- number of subdirectories for different purposes, which are
- described in detail in <xref linkend="ftp-layout"/>.</para>
+ <para>pkgsrc のあらゆるファイルの一時配布元は
+ <ulink url="ftp://ftp.NetBSD.org/pub/pkgsrc/"/> です。
+ 目的別に多数のサブディレクトリーがありますが、
+ それについては <xref linkend="ftp-layout"/> で詳しく説明しています。</para>
- <para>The tar file for the current branch is in the directory
- <filename>current</filename> and is called <ulink
- url="ftp://ftp.NetBSD.org/pub/pkgsrc/current/pkgsrc.tar.gz"><filename>pkgsrc.tar.gz</filename></ulink>.
- It is autogenerated daily.</para>
+ <para>current 枝の tar ファイルは、
+ <filename>current</filename> ディレクトリー内にあり、ファイル名は <ulink
+ url="ftp://ftp.NetBSD.org/pub/pkgsrc/current/pkgsrc.tar.gz"><filename>pkgsrc.tar.gz</filename></ulink> です。
+ このファイルは、毎日、自動生成されます。</para>
- <para>The tar file for the stable branch 2006Q1 is in the
- directory <filename>2006Q1</filename> and is also called <ulink
- url="ftp://ftp.NetBSD.org/pub/pkgsrc/2006Q1/pkgsrc.tar.gz"><filename>pkgsrc.tar.gz</filename></ulink>.</para>
+ <para>安定版の 2006Q1 枝の tar ファイルは、
+ <filename>2006Q1</filename> ディレクトリー内にあり、ファイル名は同じく <ulink
+ url="ftp://ftp.NetBSD.org/pub/pkgsrc/2006Q1/pkgsrc.tar.gz"><filename>pkgsrc.tar.gz</filename></ulink> です。</para>
- <para>After downloading the tar file, change to the directory
- where you want to have pkgsrc. This is usually
- <filename>/usr</filename>. Then, run <command>tar xfz
- pkgsrc.tar.gz</command> to extract the files.</para>
+ <para>tar ファイルをダウンロードしたら、
+ pkgsrc を置く場所のディレクトリーへ移動します。
+ ふつうは <filename>/usr</filename> です。
+ 次に、<command>tar xfz
+ pkgsrc.tar.gz</command> を実行してファイルを展開します。</para>
</sect2>
<sect2 id="getting-via-sup">
-<title>Via SUP</title>
+<title>SUP 経由</title>
- <para>As an alternative to the tar file, you can get pkgsrc via
- the Software Update Protocol, SUP. To do so, make sure your
- supfile has a line
+ <para>tar ファイルのかわりに、ソフトウェア更新プロトコル(Software Update Protocol) SUPを使い
+ pkgsrcを入手することもできます。まず、supfileの中に
<programlisting>
release=pkgsrc
</programlisting>
- in it, see the examples in
- <filename>/usr/share/examples/supfiles</filename>, and that the
- <filename>/usr/pkgsrc</filename> directory exists. Then, simply
- run <command>sup -v
- <replaceable>/path/to/your/supfile</replaceable></command>.</para>
+ という
+ 行があることを確認してください。例えば、<filename>/usr/share/examples/supfiles</filename>を見て
+ ください。それから<filename>/usr/pkgsrc</filename>ディレクトリーが存在することを確認してください。
+ 後は
+ <command>sup -v <replaceable>/path/to/your/supfile</replaceable></command>
+ を実行するだけです。</para>
</sect2>
<sect2 id="getting-via-cvs">
-<title>Via CVS</title>
+<title>CVS 経由</title>
- <para>To get pkgsrc via CVS, make sure you have &man.cvs.1;
- installed. To do an initial (full) checkout of pkgsrc, you first
- have to set some environment variables. For the C-Shell,
- type:</para>
+ <para>CVS経由でpkgsrcを入手するためには、&man.cvs.1; がインストールされていることが必要です。
+ pkgsrcを初めて(完全に)チェックアウトする際は、
+ まず環境変数を設定しておく必要があります。C シェルの場合は、
+ 以下のようにします。</para>
<screen>
&cprompt; <userinput>setenv CVSROOT anoncvs@anoncvs.NetBSD.org:/cvsroot</userinput>
&cprompt; <userinput>setenv CVS_RSH ssh</userinput>
</screen>
- <para>Or, the same for the bourne shell:</para>
+ <para>bourne シェルの場合は、以下のようにします。</para>
<screen>
&uprompt; <userinput>CVSROOT="anoncvs@anoncvs.NetBSD.org:/cvsroot"</userinput>
@@ -90,74 +90,73 @@
&uprompt; <userinput>export CVSROOT CVS_RSH</userinput>
</screen>
- <para>Then, you change to the directory where you want to have
- your copy of pkgsrc. In most cases this is
- <filename>/usr</filename>. In that directory you run the
- checkout command, which is <command>cvs -q checkout -P
- pkgsrc</command> for the current branch and <command>cvs -q
- checkout -rpkgsrc-2006Q1 -P pkgsrc</command> for the stable
- branch. This command will create a directory called
- <filename>pkgsrc</filename> with all the pkgsrc files in
- it.</para>
+ <para>次に、pkgsrc を置く場所のディレクトリーへ移動します。
+ ふつうは <filename>/usr</filename> です。
+ このディレクトリーでチェックアウト用のコマンドを実行します。
+ current の枝をチェックアウトするコマンドは <command>cvs -q checkout -P
+ pkgsrc</command> で、安定版の枝をチェックアウトするコマンドは <command>cvs -q
+ checkout -rpkgsrc-2006Q1 -P pkgsrc</command> です。
+ このコマンドを実行すると、<filename>pkgsrc</filename>
+ というディレクトリーが作られ、その中に pkgsrc
+ のファイルがすべて入っている状態になります。</para>
</sect2>
</sect1>
<sect1 id="uptodate">
-<title>Keeping pkgsrc up-to-date</title>
+<title>pkgsrc を最新の状態に保つ</title>
- <para>The preferred way to keep pkgsrc up-to-date is via CVS
- (which also works if you have first installed it via a tar
- file). It saves bandwidth and hard disk activity, compared to
- downloading the tar file again.</para>
+ <para>pkgsrc を最新の状態に保つ方法としては、CVS をおすすめします
+ (最初に tar ファイルを使ってインストールした場合でも、更新には
+ CVS を使えます)。 CVS を使えば、tar ファイルをあらためてダウンロードした場合にくらべ、
+ 帯域やハードディスクの負荷を減らすことができます。</para>
<sect2 id="uptodate-tar">
-<title>Via tar files</title>
+<title>tar ファイルを使用</title>
- <warning><para>When updating from a tar file, you first need to
- completely remove the old pkgsrc directory. Otherwise those
- files that have been removed from pkgsrc in the mean time will
- not be removed on your local disk, resulting in inconsistencies.
- When removing the old files, any changes that you have done to
- the pkgsrc files will be lost after updating. Therefore updating
- via CVS is strongly recommended.</para></warning>
+ <warning><para>tar ファイルを使って更新する場合は、まず、
+ これまで使っていた pkgsrc ディレクトリーを完全に削除する必要があります。
+ さもないと、それまでの間に pkgsrc から削除されたファイルがローカルディスクに残ったままになり、
+ 不整合が生じてしまいます。
+ これまで使っていたファイルを消す場合、pkgsrc のファイルに独自に施した変更が、
+ 更新後にすべて失われてしまいます。
+ このため、CVS を使った更新を強くおすすめします。</para></warning>
- <para>To update pkgsrc from a tar file, download the tar file as
- explained above. Then, make sure that you have not made any
- changes to the files in the pkgsrc directory. Remove the pkgsrc
- directory and extract the new tar file. Done.</para>
+ <para>tar ファイルを使って pkgsrc を更新するためには、
+ 初回の入手時と同様に、tar ファイルをダウンロードします。
+ 次に、pkgsrc ディレクトリーに独自の変更を何も加えていないことを確認します。
+ pkgsrc ディレクトリーを削除してから、新しい tar ファイルを展開します。これで完了です。</para>
</sect2>
<sect2 id="uptodate-cvs">
-<title>Via CVS</title>
+<title>CVS 経由</title>
- <para>To update pkgsrc via CVS, make sure the environment
- variable <varname>CVS_RSH</varname> is set as above. Then,
- change to the pkgsrc directory and run <command>cvs -q update
- -dP</command>.</para>
+ <para>CVS を使って pkgsrc を更新するためには、環境変数
+ <varname>CVS_RSH</varname> を初回の入手時と同じものに設定しておいてください。次に、
+ pkgsrc ディレクトリーへ移動して <command>cvs -q update
+ -dP</command> を実行します。</para>
<sect3 id="uptodate-cvs-switch">
-<title>Switching between different pkgsrc branches</title>
+<title>pkgsrc の別の枝に移る</title>
- <para>When updating pkgsrc, the CVS program keeps track of the
- branch you selected. But if you, for whatever reason, want to
- switch from the stable branch to the current one, you can do it
- by adding the option <quote>-A</quote> after the
- <quote>update</quote> keyword. To switch from the current branch
- back to the stable branch, add the
- <quote>-rpkgsrc-2006Q1</quote> option.</para>
+ <para>pkgsrc の更新時、CVS プログラムはそれまで使っていた枝をそのまま追いつづけます。
+ しかし、何らかの理由で stable 枝から current 枝に移りたい場合は、
+ <quote>update</quote> キーワードの後に <quote>-A</quote>
+ オプションを追加して current に移ることができます。
+ current 枝から stable 枝に戻るには、
+ <quote>-rpkgsrc-2006Q1</quote> オプションを追加します。</para>
</sect3>
<sect3 id="uptodate-cvs-changes">
-<title>What happens to my changes when updating?</title>
+<title>私がおこなった変更は、更新時にどうなるか?</title>
- <para>When you update pkgsrc, the CVS program will only touch
- those files that are registered in the CVS repository. That
- means that any packages that you created on your own will stay
- unmodified. If you change files that are managed by CVS, later
- updates will try to merge your changes with those that have been
- done by others. See the CVS manual, chapter
- <quote>update</quote> for details.</para>
+ <para>pkgsrc の更新時、CVS プログラムは
+ CVS リポジトリーに登録されたファイルだけに手を加えます。
+ このため、あなたが独自に作成したパッケージは、変更されずに残ります。
+ あなたが CVS の管理下にあるファイルを独自に修正している場合、
+ CVS による更新時には、あなた独自の変更と他の人による
+ (CVS リポジトリーに反映されている) 変更を統合しようとします。
+ 詳細は、CVS のマニュアルの <quote>update</quote> の章をご覧ください。</para>
</sect3>
</sect2>