[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Documentation/current/index.xml: 1.3 -> 1.7



以下のページの更新をしました。ツッコミをお願いします。

Documentation/current/index.xml: 1.3 -> 1.7

金曜日までに異議がなければ、 commit します。

以下、訳と原文の差分です。

--- Documentation/current/index.xml.orig	Thu Feb  9 22:15:02 2006
+++ Documentation/current/index.xml	Thu Feb  9 22:15:02 2006
@@ -5,10 +5,10 @@
 
 <webpage id="ja-Documentation-current-index">
 <config param="desc" value="Tracking NetBSD-current"/>
-<config param="cvstag" value="$NetBSD: index.xml,v 1.3 2005/07/19 12:50:55 rpaulo Exp $"/>
+<config param="cvstag" value="$NetBSD: index.xml,v 1.7 2006/01/27 06:25:59 reed Exp $"/>
 <!-- Based on english version: -->
-<!-- NetBSD: index.xml,v 1.3 2005/07/19 12:50:55 rpaulo Exp   -->
-<config param="rcsdate" value="$Date: 2005/07/19 12:50:55 $"/>
+<!-- NetBSD: index.xml,v 1.7 2006/01/27 06:25:59 reed Exp   -->
+<config param="rcsdate" value="$Date: 2006/01/27 06:25:59 $"/>
 <head>
 
 <!-- Copyright (c) 1994-2005
@@ -233,7 +233,7 @@
 </para>
 <para>
 異なるアーキテクチャー用に
-<ulink url="../cross/">クロスコンパイル</ulink>
+<ulink url="../../guide/en/chap-build.html">クロスコンパイル</ulink>
 をおこないたい場合は、 build.sh 実行時に
 '<code>-m MACHINE -a ARCH</code>' オプションをつけます。
 </para>
@@ -287,7 +287,7 @@
 </listitem>
 <listitem>古くなったファイルの修正のため、出力される説明に従う。たとえば以下のように。
 <programlisting>
-    # /usr/src/etc/postinstall -s /usr/src -d // fix defaults mtree obsolete
+    # /usr/src/usr.sbin/postinstall -s /usr/src -d // fix defaults mtree obsolete
 </programlisting>
 </listitem>
 <listitem>/etc の<ulink url="#etcupdate">更新</ulink>
@@ -406,9 +406,7 @@
 <orderedlist>
 <listitem><filename role="pkg">devel/cvs</filename> をインストールします。
 <emphasis>もし NetBSD が 2000-09-04 以降の -current のソースから構築されていれば、
-cvs はすでにインストールされています。</emphasis> 注意: cvs のバージョンによっては
-(特に、バージョン 1.11.5 では)、 '-z' フラグ使用時にエラーを起こすことがあります。後述の<ulink
-url="#hints">有用なヒント</ulink>を参照してください。
+cvs はすでにインストールされています。</emphasis>
 </listitem>
 <listitem>環境変数 CVSROOT を お好きな <ulink url="../../mirrors/#anoncvs">anoncvs
 サーバー</ulink>を指すように設定します。
@@ -537,6 +535,11 @@
 <sect4 id="hints">
 <title><ulink name="hints">有用なヒント</ulink></title>
 <itemizedlist>
+<listitem>
+cvs の '-z' フラグは使わないでください。使った場合、データストリームが同期せず、
+クライアント側でソースが壊れたり、クライアントが完全にハングアップしたりします。
+さらに、 cvs サーバーに余計な負荷がかかります。
+</listitem>
 <listitem>ツリー内のあるブランチをチェックアウトしたい場合に、
 このブランチ用に新しいディレクトリーを作って、既存のディレクトリーが上書きされないように
 慎重を期したい方もいるでしょう:
@@ -559,26 +562,13 @@
 </listitem>
 <listitem>
 <para>
-使用している回線が非常に細い場合、コマンドラインでコマンドの<emphasis>前に</emphasis>
-<code>-z5</code> (あるいは 1 から 9の間の他の数字)をつけると良いかも知れません
-(例 "<code>cvs -z5 update -dP</code>"); こうすると、
-全てのデータは圧縮されて転送されます。これは、cvs サーバーにとっては、余分な
-負荷を与えることを心に止めておいてください!
-</para>
-<para>
-注意: cvs のバージョンによっては (特に、バージョン 1.11.5 では)、 '-z'
-フラグ使用時にエラーを起こすことがあります。エラーが起きた場合は、 cvs
-をアップグレードするか、 '-z' フラグを外して圧縮させないようにしてください。
-</para>
-<para>
 
 特定のコマンドに対するスイッチはホームディレクトリーの .cvsrc に
 記述しておけば、自動的に使われます。.cvsrc ファイルの例を
 掲げておきます。
 </para>
 
-<programlisting>   cvs -q -z5
-   update -dP
+<programlisting> update -dP
    checkout -P
    diff -u</programlisting>
 </listitem>
@@ -968,24 +958,6 @@
 手伝ってくれるスクリプトです。オペレーティングシステムのアップグレードは、
 ソースからのコンパイル、バイナリー配布物の展開の、いずれの方法でも
 おこなうことができます。
-</sect4>
-
-<sect4 id="installing-etcupdate">
-<title>etcupdate のインストール</title>
-
-<orderedlist>
-<listitem>etcupdate の最新バージョンを入手します
-<emphasis>NetBSD が -current ソースから構築されたものの場合は、
-etcupdate はすでにインストールされています。</emphasis>
-<programlisting># cd /usr/pkgsrc/sysutils
-# cvs update -dP etcupdate
-</programlisting></listitem>
-
-<listitem>pkgsrc からインストールします
-<programlisting># cd /usr/pkgsrc/sysutils/etcupdate
-# make install clean
-</programlisting></listitem>
-</orderedlist>
 </sect4>
 
 <sect4 id="using-etcupdate-source">
Index: Documentation/current/index.xml
===================================================================
RCS file: /cvsroot/htdocs/Documentation/current/index.xml,v
retrieving revision 1.3
retrieving revision 1.7
diff -u -r1.3 -r1.7
--- Documentation/current/index.xml	19 Jul 2005 12:50:55 -0000	1.3
+++ Documentation/current/index.xml	27 Jan 2006 06:25:59 -0000	1.7
@@ -5,8 +5,8 @@
 
 <webpage id="Documentation-current-index">
 <config param="desc" value="Tracking NetBSD-current"/>
-<config param="cvstag" value="$NetBSD: index.xml,v 1.3 2005/07/19 12:50:55 rpaulo Exp $"/>
-<config param="rcsdate" value="$Date: 2005/07/19 12:50:55 $"/>
+<config param="cvstag" value="$NetBSD: index.xml,v 1.7 2006/01/27 06:25:59 reed Exp $"/>
+<config param="rcsdate" value="$Date: 2006/01/27 06:25:59 $"/>
 <head>
 
 <!-- Copyright (c) 1994-2005
@@ -235,7 +235,7 @@
 </para>
 <para>
 If you wish to
-<ulink url="../cross/">cross compile</ulink>
+<ulink url="../../guide/en/chap-build.html">cross compile</ulink>
 for a different architecture,
 include '<code>-m MACHINE -a ARCH</code>' when running build.sh.
 </para>
@@ -289,7 +289,7 @@
 </listitem>
 <listitem>Follow the instruction in the output for fixing obsolete files, for example:
 <programlisting>
-    # /usr/src/etc/postinstall -s /usr/src -d // fix defaults mtree obsolete
+    # /usr/src/usr.sbin/postinstall -s /usr/src -d // fix defaults mtree obsolete
 </programlisting>
 </listitem>
 <listitem><ulink url="#etcupdate">Update</ulink> /etc:
@@ -409,9 +409,7 @@
 <orderedlist>
 <listitem>Install <filename role="pkg">devel/cvs</filename>.  
 <emphasis>If NetBSD is built from -current sources
-past 2000-09-04, cvs is already installed.</emphasis>  Note: some versions of cvs
-(notably version 1.11.5) may lead to errors when using the '-z' flag.  See <ulink
-url="#hints">useful hints</ulink> below.
+past 2000-09-04, cvs is already installed.</emphasis>
 </listitem>
 <listitem>Set the CVSROOT environment variable to point to the
 <ulink url="../../mirrors/#anoncvs">anoncvs server</ulink> of your choice:
@@ -542,6 +540,11 @@
 <sect4 id="hints">
 <title>Useful hints</title>
 <itemizedlist>
+<listitem>
+Do not use the cvs '-z' flag.  The data stream gets out of sync,
+leading to corruption on the client, or causing the client to hang
+completely.  The additional load is also hard on the cvs server.
+</listitem>
 <listitem>If you want to check out a certain branch of the tree, you may
 want to take caution not to overwrite any existing directories by creating a
 new directory for this branch:
@@ -563,25 +566,12 @@
 </listitem>
 <listitem>
 <para>
-If you're on a very low bandwidth line, you may want to add <code>-z5</code>
-(or some other number from 1 to 9) to your commandline <emphasis>before</emphasis> the
-command (eg "<code>cvs -z5 update -dP</code>"); this turns on
-compression of all data. Keep in mind that this will put extra
-load on the cvs server!
-</para>
-<para>
-Note:  some versions of cvs (notably version 1.11.5) may lead to errors when
-using the '-z' flag.  If you receive errors, try to either upgrade cvs or
-disable compression by leaving out the '-z' flag.
-</para>
-<para>
 
 You can put switches for specific commands in a .cvsrc in your home
 directory, and they will be automatically used. A sample .cvsrc would be:
 </para>
 
-<programlisting>   cvs -q -z5
-   update -dP
+<programlisting> update -dP
    checkout -P
    diff -u</programlisting>
 </listitem>
@@ -983,24 +973,6 @@
 the distribution binaries. 
 </sect4>
 
-<sect4 id="installing-etcupdate">
-<title>Installing etcupdate</title>
-
-<orderedlist>
-<listitem>Get the latest version of etcupdate
-<emphasis>If NetBSD is built from -current sources,
-etcupdate is already installed.</emphasis>
-<programlisting># cd /usr/pkgsrc/sysutils
-# cvs update -dP etcupdate
-</programlisting></listitem>
-
-<listitem>Install it from pkgsrc
-<programlisting># cd /usr/pkgsrc/sysutils/etcupdate
-# make install clean
-</programlisting></listitem>
-</orderedlist>
-</sect4>
-
 <sect4 id="using-etcupdate-source">
 <title>Using etcupdate with source files</title>
 <para>