[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
pkgsrc/doc/guide/files/getting.xml: 1.21 -> 1.22
以下のページの更新をしました。ツッコミをお願いします。
pkgsrc/doc/guide/files/getting.xml: 1.21 -> 1.22
> revision 1.22
> date: 2008/02/18 23:57:53; author: weinem; state: Exp; lines: +50 -22
> More details about getting pkgsrc via cvs, updates
水曜日までに異議がなければ、 commit します。
# export CVSROOT="anoncvs@anoncvs.NetBSD.org:/cvsroot"
# ってのは、ありなのでしょーか
以下、訳と原文それぞれの新旧の差分です。
--- getting.xml.orig 2008-02-19 23:01:53.000000000 +0900
+++ getting.xml 2008-02-19 23:01:53.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: getting.xml,v 1.21 2007/07/20 23:08:14 wiz Exp $ -->
+<!-- $NetBSD: getting.xml,v 1.22 2008/02/18 23:57:53 weinem Exp $ -->
<!-- Based on english version: -->
-<!-- NetBSD: getting.xml,v 1.21 2007/07/20 23:08:14 wiz Exp -->
+<!-- NetBSD: getting.xml,v 1.22 2008/02/18 23:57:53 weinem Exp -->
<chapter id="getting">
<title>どこからpkgsrcを得て、どうやって最新に保つか</title>
@@ -24,7 +24,7 @@
後者は、current 枝から四半期ごとに分岐するもので、
セキュリティー上の更新に限って修正されます。
stable 枝の名前は、年と四半期を組み合わせたもので、たとえば
- <literal>2007Q1</literal> となります。</para>
+ <literal>2007Q4</literal> となります。</para>
<para>次に、pkgsrc を<emphasis>どの方法で</emphasis>
ダウンロードするかを決めます。方法としては、tarファイル、SUP経由、
@@ -43,15 +43,36 @@
url="ftp://ftp.NetBSD.org/pub/pkgsrc/current/pkgsrc.tar.gz"><filename>pkgsrc.tar.gz</filename></ulink> です。
このファイルは、毎日、自動生成されます。</para>
- <para>安定版の 2007Q1 枝の tar ファイルは、
- <filename>pkgsrc-2007Q1</filename> ディレクトリー内にあり、ファイル名は同じく <ulink
- url="ftp://ftp.NetBSD.org/pub/pkgsrc/pkgsrc-2007Q1/pkgsrc-2007Q1.tar.gz"><filename>pkgsrc-2007Q1.tar.gz</filename></ulink> です。</para>
+ <para>安定版の 2007Q4 枝の tar ファイルは、
+ <filename>pkgsrc-2007Q4</filename> ディレクトリー内にあり、ファイル名は同じく <ulink
+ url="ftp://ftp.NetBSD.org/pub/pkgsrc/pkgsrc-2007Q4/pkgsrc-2007Q4.tar.gz"><filename>pkgsrc-2007Q4.tar.gz</filename></ulink> です。</para>
+ <para>安定版 pkgsrc の tarball をダウンロードするには、以下のコマンドを実行します。</para>
+
+<screen>
+&uprompt; <userinput>ftp ftp://ftp.NetBSD.org/pub/pkgsrc/<replaceable>pkgsrc-200xQy</replaceable>/<replaceable>pkgsrc-200xQy</replaceable>.tar.gz</userinput></screen>
+
+ <para>ここで、<replaceable>pkgsrc-200xQy</replaceable> は、
+ ダウンロードする安定版の枝名にします。たとえば、
+ <quote>pkgsrc-2007Q4</quote> になります。</para>
+<!--
<para>tar ファイルをダウンロードしたら、
pkgsrc を置く場所のディレクトリーへ移動します。
ふつうは <filename>/usr</filename> です。
次に、<command>gzcat
pkgsrc.tar.gz | tar xf -</command> を実行してファイルを展開します。</para>
+-->
+ <para>ダウンロードしたら、以下のようにして展開します。</para>
+
+<screen>&uprompt; <userinput>tar -xzf <replaceable>pkgsrc-200xQy</replaceable>.tar.gz -C /usr</userinput></screen>
+
+ <para>こうすると、<filename>/usr/</filename> に
+ <filename>pkgsrc/</filename> ディレクトリーが作られ、
+ <filename>/usr/pkgsrc/</filename> 以下に全パッケージのソースが置かれます。</para>
+
+ <para>pkgsrc-current をダウンロードするには、以下のコマンドを実行します。</para>
+
+<screen>&uprompt; <userinput>ftp ftp://ftp.NetBSD.org/pub/pkgsrc/current/pkgsrc.tar.gz</userinput></screen>
</sect2>
<sect2 id="getting-via-sup">
@@ -75,8 +96,7 @@
<sect2 id="getting-via-cvs">
<title>anonymous CVS 経由</title>
- <para>CVS経由でpkgsrcを入手するためには、&man.cvs.1; がインストールされていることが必要です。
- pkgsrcを初めて(完全に)チェックアウトする際は、
+ <para>pkgsrcを初めて(完全に)チェックアウトする際は、
まず環境変数を設定しておく必要があります。C シェルの場合は、
以下のようにします。</para>
@@ -88,13 +108,12 @@
<para>bourne シェルの場合は、以下のようにします。</para>
<screen>
- &uprompt; <userinput>CVSROOT="anoncvs@anoncvs.NetBSD.org:/cvsroot"</userinput>
- &uprompt; <userinput>CVS_RSH="ssh"</userinput>
- &uprompt; <userinput>export CVSROOT CVS_RSH</userinput>
+ &uprompt; <userinput>export CVSROOT="anoncvs@anoncvs.NetBSD.org:/cvsroot"</userinput>
+ &uprompt; <userinput>export CVS_RSH="ssh"</userinput>
</screen>
- <para>cvs は、標準状態では、多くの人の望む挙動をしてくれませんし、
- 今後、標準での挙動がそのように変わることもなさそうです。しかし、
+ <para>cvs は、標準状態では、多くの人の望む挙動をしてくれません。
+ しかし、
以下の内容の <filename>.cvsrc</filename>
というファイルをホームディレクトリーに置いておけば、
標準での挙動を変えることができます。このファイルを置いておけば、
@@ -113,15 +132,23 @@
rdiff -u
</programlisting>
- <para>次に、pkgsrc を置く場所のディレクトリーへ移動します。
- ふつうは <filename>/usr</filename> です。
- このディレクトリーでチェックアウト用のコマンドを実行します。
- current の枝をチェックアウトするコマンドは <command>cvs -q checkout -P
- pkgsrc</command> で、安定版の枝をチェックアウトするコマンドは <command>cvs -q
- checkout -rpkgsrc-2007Q1 -P pkgsrc</command> です。
- このコマンドを実行すると、<filename>pkgsrc</filename>
- というディレクトリーが作られ、その中に pkgsrc
- のファイルがすべて入っている状態になります。</para>
+
+<para>何もないところに、pkgsrc の stable 枝名を指定して取得するためには、以下のコマンドを実行します。</para>
+
+<screen>&uprompt; <userinput>cd /usr</userinput>
+ &uprompt; <userinput>cvs checkout -r <replaceable>pkgsrc-200xQy</replaceable> -P pkgsrc</userinput></screen>
+
+ <para>ここで、<replaceable>pkgsrc-200xQy</replaceable> は、
+ チェックアウトする stable 枝名にします。たとえば <quote>pkgsrc-2007Q4</quote> になります。</para>
+
+ <para>こうすると、<filename>/usr/</filename> ディレクトリーに
+ <filename>pkgsrc/</filename> ディレクトリーが作られ、
+ <filename>/usr/pkgsrc/</filename> 以下に全パッケージのソースが置かれます。</para>
+
+<para>pkgsrc current を取得するには、以下のコマンドを実行します。</para>
+
+<screen>&uprompt; <userinput>cd /usr</userinput>
+&uprompt; <userinput>cvs checkout -r -P pkgsrc</userinput></screen>
</sect2>
</sect1>
@@ -163,8 +190,9 @@
<para>CVS を使って pkgsrc を更新するためには、環境変数
<varname>CVS_RSH</varname> を初回の入手時と同じものに設定しておいてください。次に、
- pkgsrc ディレクトリーへ移動して <command>cvs -q update
- -dP</command> を実行します。</para>
+ pkgsrc ディレクトリーへ移動して、以下のコマンドを実行します。</para>
+
+<screen>&uprompt; <userinput>cvs update -dP</userinput></screen>
<sect3 id="uptodate-cvs-switch">
<title>pkgsrc の別の枝に移る</title>
Index: getting.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/getting.xml,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -r1.21 -r1.22
--- getting.xml 20 Jul 2007 23:08:14 -0000 1.21
+++ getting.xml 18 Feb 2008 23:57:53 -0000 1.22
@@ -1,4 +1,4 @@
-<!-- $NetBSD: getting.xml,v 1.21 2007/07/20 23:08:14 wiz Exp $ -->
+<!-- $NetBSD: getting.xml,v 1.22 2008/02/18 23:57:53 weinem Exp $ -->
<chapter id="getting">
<title>Where to get pkgsrc and how to keep it up-to-date</title>
@@ -21,7 +21,7 @@
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>2007Q1</literal>.</para>
+ <literal>2007Q4</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,
@@ -40,14 +40,35 @@
url="ftp://ftp.NetBSD.org/pub/pkgsrc/current/pkgsrc.tar.gz"><filename>pkgsrc.tar.gz</filename></ulink>.
It is autogenerated daily.</para>
- <para>The tar file for the stable branch 2007Q1 is in the
- directory <filename>pkgsrc-2007Q1</filename> and is also called <ulink
- url="ftp://ftp.NetBSD.org/pub/pkgsrc/pkgsrc-2007Q1/pkgsrc-2007Q1.tar.gz"><filename>pkgsrc-2007Q1.tar.gz</filename></ulink>.</para>
+ <para>The tar file for the stable branch 2007Q4 is in the
+ directory <filename>pkgsrc-2007Q4</filename> and is also called <ulink
+ url="ftp://ftp.NetBSD.org/pub/pkgsrc/pkgsrc-2007Q4/pkgsrc-2007Q4.tar.gz"><filename>pkgsrc-2007Q4.tar.gz</filename></ulink>.</para>
+ <para>To download a pkgsrc stable tarball, run:</para>
+
+<screen>
+&uprompt; <userinput>ftp ftp://ftp.NetBSD.org/pub/pkgsrc/<replaceable>pkgsrc-200xQy</replaceable>/<replaceable>pkgsrc-200xQy</replaceable>.tar.gz</userinput></screen>
+
+ <para>Where <replaceable>pkgsrc-200xQy</replaceable> is the
+ stable branch to be downloaded, for example,
+ <quote>pkgsrc-2007Q4</quote>.</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>gzcat
pkgsrc.tar.gz | tar xf -</command> to extract the files.</para>
+-->
+ <para>Then, extract it with:</para>
+
+<screen>&uprompt; <userinput>tar -xzf <replaceable>pkgsrc-200xQy</replaceable>.tar.gz -C /usr</userinput></screen>
+
+ <para>This will create the directory <filename>pkgsrc/</filename>
+ in <filename>/usr/</filename> and all the package source will be
+ stored under <filename>/usr/pkgsrc/</filename>.</para>
+
+ <para>To download pkgsrc-current, run:</para>
+
+<screen>&uprompt; <userinput>ftp ftp://ftp.NetBSD.org/pub/pkgsrc/current/pkgsrc.tar.gz</userinput></screen>
</sect2>
<sect2 id="getting-via-sup">
@@ -71,8 +92,7 @@
<sect2 id="getting-via-cvs">
<title>Via anonymous 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
+ <para>To do an initial (full) checkout of pkgsrc, you first
have to set some environment variables. For the C-Shell,
type:</para>
@@ -84,13 +104,12 @@
<para>Or, the same for the bourne shell:</para>
<screen>
- &uprompt; <userinput>CVSROOT="anoncvs@anoncvs.NetBSD.org:/cvsroot"</userinput>
- &uprompt; <userinput>CVS_RSH="ssh"</userinput>
- &uprompt; <userinput>export CVSROOT CVS_RSH</userinput>
+ &uprompt; <userinput>export CVSROOT="anoncvs@anoncvs.NetBSD.org:/cvsroot"</userinput>
+ &uprompt; <userinput>export CVS_RSH="ssh"</userinput>
</screen>
<para>By default, cvs doesn't do things like most people would
- expect it to do, and this is unlikely to change. But there is a
+ expect it to do. But there is a
way to convince cvs, by creating a file called
<filename>.cvsrc</filename> in your home directory and saving
the following lines to it. This file will save you lots of
@@ -108,15 +127,23 @@
rdiff -u
</programlisting>
- <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-2007Q1 -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>To fetch a specific pkgsrc stable branch from scratch, run:</para>
+
+<screen>&uprompt; <userinput>cd /usr</userinput>
+ &uprompt; <userinput>cvs checkout -r <replaceable>pkgsrc-200xQy</replaceable> -P pkgsrc</userinput></screen>
+
+ <para>Where <replaceable>pkgsrc-200xQy</replaceable> is the stable
+ branch to be checked out, for example, <quote>pkgsrc-2007Q4</quote></para>
+
+ <para>This will create the directory <filename>pkgsrc/</filename>
+ in your <filename>/usr/</filename> directory and all the package source
+ will be stored under <filename>/usr/pkgsrc/</filename>.</para>
+
+<para>To fetch the pkgsrc current branch, run:</para>
+
+<screen>&uprompt; <userinput>cd /usr</userinput>
+&uprompt; <userinput>cvs checkout -r -P pkgsrc</userinput></screen>
</sect2>
</sect1>
@@ -158,8 +185,9 @@
<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>
+ change to the pkgsrc directory and run:</para>
+
+<screen>&uprompt; <userinput>cvs update -dP</userinput></screen>
<sect3 id="uptodate-cvs-switch">
<title>Switching between different pkgsrc branches</title>