[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
pkgsrc/doc/guide/files/getting.xml: 1.26 -> 1.27
以下のページの更新をしました。ツッコミをお願いします。
pkgsrc/doc/guide/files/getting.xml: 1.26 -> 1.27
> ----------------------------
> revision 1.27
> date: 2010/12/23 10:42:16; author: asau; state: Exp; lines: +38 -37
> Simplify CVS instructions:
> - multiple steps are harder to understand than single step,
> and commands are black magic to novice user anyway;
> - single step also makes instructions more cut-and-paste friendly;
> - drop csh support, csh users have more troubles when following
> instructions already, they have to refer to their documentation;
> - explain CVS_RSH issues;
> - sort CVS subcommands in sample .cvsrc so that it could be more
> comprehensible (this should be moved into separate section in
> appendix along with rest CVS "magic" or just go away).
>
> FIXME: link the list of AnonCVS mirrors.
>
> Discussed with <abs> and <joerg>.
日曜日までに異議がなければ、 commit します。
# つーか FIXME のは http://www.NetBSD.org/mirrors/#anoncvs でいいんでしょーか的な
改行位置や順序が変更されているので差分が大きくなっていますが、
新たに追加されたものは以下の部分だけです (原文と訳の差分)
--- (ここから)
- <para>Refer to <ulink url="http://NetBSD.org/FIXME">list of available CVS mirrors</ulink> to choose faster one.</para>
+ <para><ulink url="http://NetBSD.org/FIXME">利用可能な CVS ミラーサイト一覧</ulink>から、もっとも速いものを選んで使ってください。</para>
<!-- FIXME: All this CVS magic should move into appendix or so. -->
- <para>If you get error messages from <literal>rsh</literal>, you need to set CVS_RSH variable. E.g.:</para>
+ <para><literal>rsh</literal> のエラーメッセージが出た場合は、たとえば以下のようにして、環境変数 CVS_RSH を設定する必要があります。</para>
<screen>&uprompt; <userinput>cd /usr && env CVS_RSH=ssh cvs -q -z3 -d anoncvs@anoncvs.NetBSD.org:/cvsroot checkout -P pkgsrc</userinput>
</screen>
- <para>Refer to documentation on your command shell how to set CVS_RSH=ssh permanently.
- For Bourne shells, you can set it in your <filename>.profile</filename>
- or better globally in <filename>/etc/profile</filename>:</para>
+ <para>CVS_RSH=ssh の設定を今後も有効なままにする方法は、お使いのコマンドシェルのドキュメンテーションをご覧ください。
+ Bourne シェルの場合は、この設定を以下のとおりユーザーの <filename>.profile</filename> に、
+ またはより大域的に <filename>/etc/profile</filename> に書くことができます。</para>
<programlisting>
# set CVS remote shell command
CVS_RSH=ssh
export CVS_RSH
</programlisting>
--- (ここまで)
以下、訳と原文それぞれの新旧の差分です。
--- getting.xml.orig 2010-12-25 14:23:13.000000000 +0900
+++ getting.xml 2010-12-25 14:23:13.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: getting.xml,v 1.26 2010/12/23 10:08:18 asau Exp $ -->
+<!-- $NetBSD: getting.xml,v 1.27 2010/12/23 10:42:16 asau Exp $ -->
<!-- Based on english version: -->
-<!-- NetBSD: getting.xml,v 1.26 2010/12/23 10:08:18 asau Exp -->
+<!-- NetBSD: getting.xml,v 1.27 2010/12/23 10:42:16 asau Exp -->
<chapter id="getting">
<title>どこからpkgsrcを得て、どうやって最新に保つか</title>
@@ -78,20 +78,42 @@
<sect2 id="getting-via-cvs">
<title>anonymous CVS 経由</title>
- <para>pkgsrcを初めて(完全に)チェックアウトする際は、
- まず環境変数を設定しておく必要があります。C シェルの場合は、
- 以下のようにします。</para>
+<para>pkgsrc の stable 枝名を指定して取得するためには、以下のコマンドを実行します。</para>
-<screen>&cprompt; <userinput>setenv CVSROOT anoncvs@anoncvs.NetBSD.org:/cvsroot</userinput>
-&cprompt; <userinput>setenv CVS_RSH ssh</userinput>
+<screen>&uprompt; <userinput>cd /usr && cvs -q -z3 -d anoncvs@anoncvs.NetBSD.org:/cvsroot checkout -r <replaceable>pkgsrc-20xxQy</replaceable> -P pkgsrc</userinput>
</screen>
- <para>bourne シェルの場合は、以下のようにします。</para>
+ <para>ここで、<replaceable>pkgsrc-20xxQy</replaceable> は、
+ チェックアウトする stable 枝名にします。たとえば <quote>pkgsrc-2009Q1</quote> になります。</para>
-<screen>&uprompt; <userinput>export CVSROOT="anoncvs@anoncvs.NetBSD.org:/cvsroot"</userinput>
-&uprompt; <userinput>export CVS_RSH="ssh"</userinput>
+ <para>こうすると、<filename>/usr/</filename> ディレクトリーに
+ <filename>pkgsrc/</filename> ディレクトリーが作られ、
+ <filename>/usr/pkgsrc/</filename> 以下に全パッケージのソースが置かれます。</para>
+
+<para>pkgsrc current を取得するには、以下のコマンドを実行します。</para>
+
+<screen>&uprompt; <userinput>cd /usr && cvs -q -z3 -d anoncvs@anoncvs.NetBSD.org:/cvsroot checkout -P pkgsrc</userinput>
</screen>
+ <para><ulink url="http://NetBSD.org/FIXME">利用可能な CVS ミラーサイト一覧</ulink>から、もっとも速いものを選んで使ってください。</para>
+
+<!-- FIXME: All this CVS magic should move into appendix or so. -->
+ <para><literal>rsh</literal> のエラーメッセージが出た場合は、たとえば以下のようにして、環境変数 CVS_RSH を設定する必要があります。</para>
+
+<screen>&uprompt; <userinput>cd /usr && env CVS_RSH=ssh cvs -q -z3 -d anoncvs@anoncvs.NetBSD.org:/cvsroot checkout -P pkgsrc</userinput>
+</screen>
+
+ <para>CVS_RSH=ssh の設定を今後も有効なままにする方法は、お使いのコマンドシェルのドキュメンテーションをご覧ください。
+ Bourne シェルの場合は、この設定を以下のとおりユーザーの <filename>.profile</filename> に、
+ またはより大域的に <filename>/etc/profile</filename> に書くことができます。</para>
+
+<programlisting>
+# set CVS remote shell command
+CVS_RSH=ssh
+export CVS_RSH
+</programlisting>
+
+<!-- FIXME: This should move into appendix or so. -->
<para>CVS は、標準状態では、多くの人の望む挙動をしてくれません。
しかし、
以下の内容の <filename>.cvsrc</filename>
@@ -104,32 +126,14 @@
<programlisting>
# recommended CVS configuration file from the pkgsrc guide
+cvs -q -z3
checkout -P
update -dP
-release -d
diff -upN
-cvs -q -z3
rdiff -u
+release -d
</programlisting>
-
-<para>何もないところに、pkgsrc の stable 枝名を指定して取得するためには、以下のコマンドを実行します。</para>
-
-<screen>&uprompt; <userinput>cd /usr</userinput>
-&uprompt; <userinput>cvs checkout -r <replaceable>pkgsrc-20xxQy</replaceable> -P pkgsrc</userinput></screen>
-
- <para>ここで、<replaceable>pkgsrc-20xxQy</replaceable> は、
- チェックアウトする stable 枝名にします。たとえば <quote>pkgsrc-2009Q1</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 -P pkgsrc</userinput></screen>
-
</sect2>
</sect1>
Index: getting.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/getting.xml,v
retrieving revision 1.26
retrieving revision 1.27
diff -u -r1.26 -r1.27
--- getting.xml 23 Dec 2010 10:08:18 -0000 1.26
+++ getting.xml 23 Dec 2010 10:42:16 -0000 1.27
@@ -1,4 +1,4 @@
-<!-- $NetBSD: getting.xml,v 1.26 2010/12/23 10:08:18 asau Exp $ -->
+<!-- $NetBSD: getting.xml,v 1.27 2010/12/23 10:42:16 asau Exp $ -->
<chapter id="getting">
<title>Where to get pkgsrc and how to keep it up-to-date</title>
@@ -74,57 +74,58 @@
<sect2 id="getting-via-cvs">
<title>Via anonymous CVS</title>
- <para>To do an initial (full) checkout of pkgsrc, you first
- have to set some environment variables. For the C-Shell,
- type:</para>
+<para>To fetch a specific pkgsrc stable branch, run:</para>
-<screen>&cprompt; <userinput>setenv CVSROOT anoncvs@anoncvs.NetBSD.org:/cvsroot</userinput>
-&cprompt; <userinput>setenv CVS_RSH ssh</userinput>
+<screen>&uprompt; <userinput>cd /usr && cvs -q -z3 -d anoncvs@anoncvs.NetBSD.org:/cvsroot checkout -r <replaceable>pkgsrc-20xxQy</replaceable> -P pkgsrc</userinput>
</screen>
- <para>Or, the same for the bourne shell:</para>
+ <para>Where <replaceable>pkgsrc-20xxQy</replaceable> is the stable
+ branch to be checked out, for example, <quote>pkgsrc-2009Q1</quote></para>
-<screen>&uprompt; <userinput>export CVSROOT="anoncvs@anoncvs.NetBSD.org:/cvsroot"</userinput>
-&uprompt; <userinput>export CVS_RSH="ssh"</userinput>
+ <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 && cvs -q -z3 -d anoncvs@anoncvs.NetBSD.org:/cvsroot checkout -P pkgsrc</userinput>
</screen>
- <para>By default, CVS doesn't do things like most people would
- 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
- headache and some bug reports, so we strongly recommend it. You
- can find an explanation of this file in the CVS
- documentation.</para>
+ <para>Refer to <ulink url="http://NetBSD.org/FIXME">list of available CVS mirrors</ulink> to choose faster one.</para>
+
+<!-- FIXME: All this CVS magic should move into appendix or so. -->
+ <para>If you get error messages from <literal>rsh</literal>, you need to set CVS_RSH variable. E.g.:</para>
+
+<screen>&uprompt; <userinput>cd /usr && env CVS_RSH=ssh cvs -q -z3 -d anoncvs@anoncvs.NetBSD.org:/cvsroot checkout -P pkgsrc</userinput>
+</screen>
+
+ <para>Refer to documentation on your command shell how to set CVS_RSH=ssh permanently.
+ For Bourne shells, you can set it in your <filename>.profile</filename>
+ or better globally in <filename>/etc/profile</filename>:</para>
+
+<programlisting>
+# set CVS remote shell command
+CVS_RSH=ssh
+export CVS_RSH
+</programlisting>
+
+<!-- FIXME: This should move into appendix or so. -->
+ <para>By default, CVS doesn't do things like most people would 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 headache and some bug reports, so we strongly recommend it.
+ You can find an explanation of this file in the CVS documentation.</para>
<programlisting>
# recommended CVS configuration file from the pkgsrc guide
+cvs -q -z3
checkout -P
update -dP
-release -d
diff -upN
-cvs -q -z3
rdiff -u
+release -d
</programlisting>
-
-<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-20xxQy</replaceable> -P pkgsrc</userinput></screen>
-
- <para>Where <replaceable>pkgsrc-20xxQy</replaceable> is the stable
- branch to be checked out, for example, <quote>pkgsrc-2009Q1</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 -P pkgsrc</userinput></screen>
-
</sect2>
</sect1>