[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>