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

docs/current/index.xml: 1.5 -> 1.7

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

docs/current/index.xml: 1.5 -> 1.7
> revision 1.7
> date: 2009/05/14 14:35:45;  author: jschauma;  state: Exp;  lines: +3 -3
> s/whill/will/; noted by Aleksej Saushev
> ----------------------------
> revision 1.6
> date: 2009/04/20 12:30:13;  author: tsutsui;  state: Exp;  lines: +25 -8
> Add more descriptions in "installing a current snapshot" section:
>  - add a warning not to extract userland sets before rebooting a new kernel
>  - extract base.tgz first in example
>  - note about -p option (perserve perimissions) on tar(1) command
>  - add a warning not to extract etc.tgz on the installed system
>  - use man page links for postinstall(8) and etcupdate(8)
> etc.

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

更新後の訳の全文は
  http://www.na.rim.or.jp/%7Ekano/tmp/docs/current/index.xml
  http://www.na.rim.or.jp/%7Ekano/tmp/docs/current/index.html
に置いてあります。

以下、訳と原文それぞれの新旧の差分です。

--- docs/current/index.xml.orig	2009-05-25 07:00:58.000000000 +0900
+++ docs/current/index.xml	2009-05-25 07:00:58.000000000 +0900
@@ -5,10 +5,10 @@
 
 <webpage id="ja-docs-current-index">
 <config param="desc" value="Tracking NetBSD-current"/>
-<config param="cvstag" value="$NetBSD: index.xml,v 1.5 2009/01/13 21:49:05 hubertf Exp $"/>
+<config param="cvstag" value="$NetBSD: index.xml,v 1.7 2009/05/14 14:35:45 jschauma Exp $"/>
 <!-- Based on english version: -->
-<!-- NetBSD: index.xml,v 1.5 2009/01/13 21:49:05 hubertf Exp   -->
-<config param="rcsdate" value="$Date: 2009/01/13 21:49:05 $"/>
+<!-- NetBSD: index.xml,v 1.7 2009/05/14 14:35:45 jschauma Exp   -->
+<config param="rcsdate" value="$Date: 2009/05/14 14:35:45 $"/>
 <head>
 
 <!-- Copyright (c) 1994-2005
@@ -72,32 +72,49 @@
 (たとえば <emphasis><code>$HOME/current</code></emphasis> ) に置きます。
 ディスクスペースや時間が足りない場合は、
 必要不可欠なのは kern-GENERIC, etc, base, comp (コンパイラーが必要な場合) だけです。</listitem>
-<listitem> <code>/etc</code> およびカーネルを展開します。
+<listitem> 適切なカーネル (通常は <code>GENERIC</code>) を展開して
+<code>/</code> にコピーし、そのカーネルでマシンを再起動します。
 <programlisting>
     $ su
     # cd /root
     # tar -zxpf ~/kern-GENERIC.tgz
     # ln -fh /netbsd /netbsd.old
-    # mv netbsd /netbsd
+    # cp netbsd /netbsd
     # shutdown -r now
 </programlisting>
+<para>
+  <emphasis role="bold">注意: 新しいカーネルでマシンを再起動するまでは、
+  ユーザーランドのバイナリーは一切展開してはいけません。</emphasis>
+  新しいバイナリーでは、新しいシステムコール (動作中の古いカーネルでは非対応)
+  を使っているかもしれないからです。
+</para>
 </listitem>
 <listitem> 新しいカーネルが、問題なく起動して動作することを確認します。
+新しいカーネルに問題がある場合は、名前を変えた古いカーネルをロードして、
+元に戻すことができます。
 </listitem>
-<listitem> <code>base</code> ほか一連の必要なものを展開し、
+<listitem> <code>base</code> ほか一連の必要なもの
+(<emphasis role="bold"><code>etc</code> は除く</emphasis>) を展開し、
 配置します。
 <programlisting>
     $ su
     # cd /
+    # tar -zxpf ~/base.tgz
     # tar -zxpf ~/comp.tgz
     # ...
-    # tar -zxpf ~/base.tgz
 </programlisting>
+&man.tar.1; コマンドの <code>"p"</code> オプション (許可属性の保持)
+を忘れずに指定してください。そうしないと、setuid されたコマンド (&man.su.1; など)
+が動作しません。
+<para>
+  <emphasis role="bold">注意: 既存のシステムに対して <code>etc.tgz</code>
+  を展開すると、独自におこなった設定が上書きされてしまいます。</emphasis>
+</para>
 </listitem>
 <listitem> 最後に、 <code>/etc</code>
 を <ulink url="#etcupdate">更新</ulink> します。
-postinstall は、最初の検査をし、自動的に修正できることはほとんど修正してくれます。
-その次にある etcupdate は、どのようにマージするかたずねてきます。
+&man.postinstall.8; は、最初の検査をし、自動的に修正できることはほとんど修正してくれます。
+その次にある &man.etcupdate.8; は、どのようにマージするかたずねてきます。
 <programlisting>
     # /usr/sbin/postinstall -s ~/etc.tgz check
     # /usr/sbin/postinstall -s ~/etc.tgz fix
Index: docs/current/index.xml
===================================================================
RCS file: /cvsroot/htdocs/docs/current/index.xml,v
retrieving revision 1.5
retrieving revision 1.7
diff -u -r1.5 -r1.7
--- docs/current/index.xml	13 Jan 2009 21:49:05 -0000	1.5
+++ docs/current/index.xml	14 May 2009 14:35:45 -0000	1.7
@@ -5,8 +5,8 @@
 
 <webpage id="docs-current-index">
 <config param="desc" value="Tracking NetBSD-current"/>
-<config param="cvstag" value="$NetBSD: index.xml,v 1.5 2009/01/13 21:49:05 hubertf Exp $"/>
-<config param="rcsdate" value="$Date: 2009/01/13 21:49:05 $"/>
+<config param="cvstag" value="$NetBSD: index.xml,v 1.7 2009/05/14 14:35:45 jschauma Exp $"/>
+<config param="rcsdate" value="$Date: 2009/05/14 14:35:45 $"/>
 <head>
 
 <!-- Copyright (c) 1994-2005
@@ -73,31 +73,48 @@
 when limited by disk space and/or time,
 only kern-GENERIC, etc, base, and comp (if you want a compiler) are
 essential.</listitem>
-<listitem> Extract the desired <code>/etc</code> and kernel:
+<listitem> Extract the desired kernel (usually <code>GENERIC</code>),
+copy it into <code>/</code>, and reboot machine with the new kernel:
 <programlisting>
     $ su
     # cd /root
     # tar -zxpf ~/kern-GENERIC.tgz
     # ln -fh /netbsd /netbsd.old
-    # mv netbsd /netbsd
+    # cp netbsd /netbsd
     # shutdown -r now
 </programlisting>
+<para>
+  <emphasis role="bold">Warning: Don't extract any userland binary sets
+  before rebooting your machine with the new kernel.</emphasis>
+  Newer binaries might use new system calls an old running kernel doesn't
+  support.
+</para>
 </listitem>
 <listitem> Make sure the new kernel boots and works properly.
+If your new kernel has any trouble, you can recover it by loading
+the renamed old one.
 </listitem>
 <listitem> Extract the matching <code>base</code>,
-and any other desirable feature sets:
+and any other desirable feature sets
+<emphasis role="bold">except <code>etc</code></emphasis>:
 <programlisting>
     $ su
     # cd /
+    # tar -zxpf ~/base.tgz
     # tar -zxpf ~/comp.tgz
     # ...
-    # tar -zxpf ~/base.tgz
 </programlisting>
+Don't forget to specify <code>"p"</code> option (preserve permissions)
+on &man.tar.1; command otherwise setuid'ed commands (like &man.su.1;)
+won't work.
+<para>
+  <emphasis role="bold">Warning: Extracting <code>etc.tgz</code> on
+  the installed system will overwrite your local settings.</emphasis>
+</para>
 </listitem>
 <listitem> <ulink url="#etcupdate">Update</ulink> <code>/etc</code>
-as last step: postinstall whill first check and fix most things that
-can be automated, and etcupdate in the second step will ask on what
+as last step: &man.postinstall.8; will first check and fix most things that
+can be automated, and &man.etcupdate.8; in the second step will ask on what
 to merge:
 <programlisting>
     # /usr/sbin/postinstall -s ~/etc.tgz check