[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
docs/updating.xml: 1.3 -> 1.5

Subject: docs/updating.xml: 1.3 -> 1.5
From: kano@na.rim.or.jp (OKANO Takayoshi)
To: www-changes-ja@jp.NetBSD.org
Date: Sat, 11 Aug 2007 20:25:14 +0900 (JST)
Message-Id: <200708111125.UAA14228@shell.rim.or.jp>
Delivered-To: mailing list www-changes-ja@jp.netbsd.org
Mailing-List: contact www-changes-ja-help@jp.netbsd.org; run by ezmlm-idx
以下のページの更新をしました。ツッコミをお願いします。

docs/updating.xml: 1.3 -> 1.5
> revision 1.5
> date: 2007/08/11 09:25:52;  author: kano;  state: Exp;  lines: +3 -3
> add missing space
> ----------------------------
> revision 1.4
> date: 2007/08/10 21:14:00;  author: weinem;  state: Exp;  lines: +54 -25
> More improvements, based on feedback from Clayton <ckoeni@gmail.com>

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

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

--- docs/updating.xml.orig	2007-08-11 20:24:23.000000000 +0900
+++ docs/updating.xml	2007-08-11 20:24:23.000000000 +0900
@@ -6,10 +6,10 @@
 <webpage id="ja-docs-updating">
   <config param="desc" value="安定版 NetBSD リリースの更新" />
   <config param="cvstag"
-  value="$NetBSD: updating.xml,v 1.3 2007/08/08 00:51:06 weinem Exp $" />
+  value="$NetBSD: updating.xml,v 1.5 2007/08/11 09:25:52 kano Exp $" />
   <!-- Based on english version: -->
-  <!-- NetBSD: updating.xml,v 1.3 2007/08/08 00:51:06 weinem Exp   -->
-  <config param="rcsdate" value="$Date: 2007/08/08 00:51:06 $" />
+  <!-- NetBSD: updating.xml,v 1.5 2007/08/11 09:25:52 kano Exp   -->
+  <config param="rcsdate" value="$Date: 2007/08/11 09:25:52 $" />
   <head>
     <!-- Copyright (c) 2003-2006
            The NetBSD Foundation, Inc.  ALL RIGHTS RESERVED. -->
@@ -37,7 +37,15 @@
           時々ソースを更新のうえシステムまたはカーネルを再構築すべきです。
        </para>
 
-       <para> 
+       <para>以下に示す各手順のほとんどは、一般ユーザーの権限でおこなうことができます。
+       新しいカーネルとユーザーランドのインストールのみ、
+       root 権限が必要です。
+       以下の例示では、作業ディレクトリーとして <filename>/usr</filename>
+       を使っていますが、ユーザーのホームディレクトリー以下で作業をおこなうことができます。
+       通常、一般ユーザーは <filename>/usr</filename> 以下への書き込み権限を持っていませんが、
+       これは root が変更することができます。 </para>
+
+     <para> 
          リリース版のソースの再現や更新は、適切な枝タグを指定して、
          <ulink url="current/#using-anoncvs-over-ssh">anoncvs オーバー
           ssh</ulink>
@@ -48,7 +56,8 @@
         </para>
         <programlisting>
 $ cd /usr
-$ env CVS_RSH=ssh cvs -d anoncvs@anoncvs.NetBSD.org:/cvsroot co -r netbsd-3-1 -P src</programlisting>
+$ export CVS_RSH=ssh 
+$ cvs -d anoncvs@anoncvs.NetBSD.org:/cvsroot co -r netbsd-3-1 -P src</programlisting>
 
   <note>
   間違ってソースツリーを<emphasis>ダウングレード</emphasis>することのないよう、
@@ -59,10 +68,25 @@
 
 <programlisting>
 $ cd /usr/src
-$ env CVS_RSH=ssh 
+$ export CVS_RSH=ssh 
 $ cvs update -dP</programlisting>
 
-      </sect3>
+</sect3>
+
+<sect3 id="tools">
+  <title>必要なツールを構築する</title>
+
+  <para>次にすることは、toolchain の構築です。
+  あらかじめ <filename>obj/</filename> および <filename>tools/</filename>
+  ディレクトリーを作成してから、<command>build.sh</command> を実行する必要があります。</para>
+
+  <programlisting>
+$ mkdir /usr/obj /usr/tools
+$ cd /usr/src
+$ ./build.sh -O /usr/obj -T /usr/tools -U -u tools</programlisting>
+
+</sect3>
+
 
       <sect3 id="kernel">
         <title>新しいカーネルを構築する</title>
@@ -120,14 +144,16 @@
 $ su
 # ./build.sh -O ../obj -T ../tools -U install=/ </programlisting>
 
-<para>新しいカーネル "netbsd" がうまくブートしなかった場合は、
-"netbsd.old" カーネルをブートして、以前の状態に戻すことができます。</para>
+<para>新しいカーネル <filename>netbsd</filename> がうまくブートしなかった場合は、
+<filename>netbsd.old</filename> カーネルをブートして、
+以前の状態に戻すことができます。</para>
 
 </sect3>
 
 
       <sect3 id="parts">
         <title>ソースツリーの一部だけを更新する</title>
+
         <para>
           セキュリティー勧告が発行され、
           再構築が必要となったライブラリーやアプリケーションだけを構築したい場合、
@@ -137,35 +163,38 @@
 
 <programlisting>
 $ cd src
-$ env CVS_RSH=ssh cvs update -d -P -r netbsd-3-1 gnu/dist/sendmail/sendmail
+$ export CVS_RSH=ssh cvs update -d -P -r netbsd-3-1 gnu/dist/sendmail/sendmail
 $ cd gnu/usr.sbin/sendmail
 $ make USETOOLS=no cleandir dependall
 $ su
 # make USETOOLS=no install</programlisting>
 
-      </sect3>
+</sect3>
+
+<sect3 id="summary">
+  <title>更新手順の簡潔なまとめ</title>
+<itemizedlist>
 
-      <sect3 id="summary">
-        <title>更新手順の簡潔なまとめ</title>
-        <itemizedlist>
           <listitem>
             <para>ソースの更新:</para>
             <programlisting>
 $ cd /usr/src
-$ env CVS_RSH=ssh cvs update -dP</programlisting>
-
+$ export CVS_RSH=ssh 
+$ cvs update -dP</programlisting>
           </listitem>
-          <listitem>
-            <para>カーネルとユーザーランドの再構築:</para>
-            <programlisting>
+
+
+  <listitem>
+  <para>カーネルとユーザーランドの再構築:</para>
+  <programlisting>
 $ cd /usr/src
 $ ./build.sh -O ../obj -T ../tools kernel=&lt;KERNEL&gt;
 $ ./build.sh -U distribution</programlisting>
-</listitem>
+  </listitem>
 
-<listitem>
-<para>Installing the new kernel and userland:</para>
-<programlisting>
+  <listitem>
+  <para>Installing the new kernel and userland:</para>
+  <programlisting>
 $ su
 # mv /netbsd /netbsd.old
 # mv /usr/src/sys/arch/&lt;ARCH&gt;/compile/&lt;KERNEL&gt;/netbsd /
@@ -174,10 +203,9 @@
 $ cd /usr/src
 $ su
 # ./build.sh -O ../obj -T ../tools -U install=/ </programlisting>
-</listitem>
+  </listitem>
 
 </itemizedlist>
-
 </sect3>
 
     </sect2>
Index: docs/updating.xml
===================================================================
RCS file: /cvsroot/htdocs/docs/updating.xml,v
retrieving revision 1.3
retrieving revision 1.5
diff -u -r1.3 -r1.5
--- docs/updating.xml	8 Aug 2007 00:51:06 -0000	1.3
+++ docs/updating.xml	11 Aug 2007 09:25:52 -0000	1.5
@@ -6,8 +6,8 @@
 <webpage id="docs-updating">
   <config param="desc" value="Updating a stable NetBSD release" />
   <config param="cvstag"
-  value="$NetBSD: updating.xml,v 1.3 2007/08/08 00:51:06 weinem Exp $" />
-  <config param="rcsdate" value="$Date: 2007/08/08 00:51:06 $" />
+  value="$NetBSD: updating.xml,v 1.5 2007/08/11 09:25:52 kano Exp $" />
+  <config param="rcsdate" value="$Date: 2007/08/11 09:25:52 $" />
   <head>
     <!-- Copyright (c) 2003-2006
            The NetBSD Foundation, Inc.  ALL RIGHTS RESERVED. -->
@@ -36,7 +36,16 @@
           applied to the branch since its release.
        </para>
 
-       <para> 
+       <para>Most of the following steps can be done as ordinary user. 
+       Only the installation of a new kernel and the userland will require 
+       root privileges.
+       Although <filename>/usr</filename> is choosen as the working 
+       directory in the following examples, the procedure can also 
+       take place in a user's home directory. Ordinary users have normally not 
+       the permissions to make changes in <filename>/usr</filename>, 
+       but this can be changed by root. </para>
+
+     <para> 
          You can retrieve or update the sources for your
          release using 
          <ulink url="current/#using-anoncvs-over-ssh">anoncvs over
@@ -47,7 +56,8 @@
         </para>
         <programlisting>
 $ cd /usr
-$ env CVS_RSH=ssh cvs -d anoncvs@anoncvs.NetBSD.org:/cvsroot co -r netbsd-3-1 -P src</programlisting>
+$ export CVS_RSH=ssh 
+$ cvs -d anoncvs@anoncvs.NetBSD.org:/cvsroot co -r netbsd-3-1 -P src</programlisting>
 
   <note>
   Be sure to take care in selecting the correct and desired branch tag so
@@ -58,10 +68,25 @@
 
 <programlisting>
 $ cd /usr/src
-$ env CVS_RSH=ssh 
+$ export CVS_RSH=ssh 
 $ cvs update -dP</programlisting>
 
-      </sect3>
+</sect3>
+
+<sect3 id="tools">
+  <title>Building the tools</title>
+
+  <para>The next step is to build the toolchain. You need to 
+  create an <filename>obj/</filename> and a <filename>tools/</filename> 
+  directory, followed by a run of <command>build.sh</command>:</para>
+
+  <programlisting>
+$ mkdir /usr/obj /usr/tools
+$ cd /usr/src
+$ ./build.sh -O /usr/obj -T /usr/tools -U -u tools</programlisting>
+
+</sect3>
+
 
       <sect3 id="kernel">
         <title>Building a new kernel</title>
@@ -115,14 +140,16 @@
 $ su
 # ./build.sh -O ../obj -T ../tools -U install=/ </programlisting>
 
-<para>If the new kernel "netbsd" does not boot successfully, you can 
-fall back on booting the "netbsd.old" kernel.</para>
+<para>If the new kernel <filename>netbsd</filename> does not boot 
+successfully, you can fall back on booting the 
+<filename>netbsd.old</filename> kernel.</para>
 
 </sect3>
 
 
       <sect3 id="parts">
         <title>Updating only parts of the source tree</title>
+
         <para>
           If a security advisory has been issued, and you want
           to just rebuild the necessary libraries and applications,
@@ -132,35 +159,38 @@
 
 <programlisting>
 $ cd src
-$ env CVS_RSH=ssh cvs update -d -P -r netbsd-3-1 gnu/dist/sendmail/sendmail
+$ export CVS_RSH=ssh cvs update -d -P -r netbsd-3-1 gnu/dist/sendmail/sendmail
 $ cd gnu/usr.sbin/sendmail
 $ make USETOOLS=no cleandir dependall
 $ su
 # make USETOOLS=no install</programlisting>
 
-      </sect3>
+</sect3>
+
+<sect3 id="summary">
+  <title>Terse summary of an updating procedure</title>
+<itemizedlist>
 
-      <sect3 id="summary">
-        <title>Terse summary of the updating procedure</title>
-        <itemizedlist>
           <listitem>
-            <para>Update the sources:</para>
+            <para>Updating the sources:</para>
             <programlisting>
 $ cd /usr/src
-$ env CVS_RSH=ssh cvs update -dP</programlisting>
-
+$ export CVS_RSH=ssh 
+$ cvs update -dP</programlisting>
           </listitem>
-          <listitem>
-            <para>Building the new kernel and userland:</para>
-            <programlisting>
+
+
+  <listitem>
+  <para>Building the new kernel and userland:</para>
+  <programlisting>
 $ cd /usr/src
 $ ./build.sh -O ../obj -T ../tools kernel=&lt;KERNEL&gt;
 $ ./build.sh -U distribution</programlisting>
-</listitem>
+  </listitem>
 
-<listitem>
-<para>Installing the new kernel and userland:</para>
-<programlisting>
+  <listitem>
+  <para>Installing the new kernel and userland:</para>
+  <programlisting>
 $ su
 # mv /netbsd /netbsd.old
 # mv /usr/src/sys/arch/&lt;ARCH&gt;/compile/&lt;KERNEL&gt;/netbsd /
@@ -169,10 +199,9 @@
 $ cd /usr/src
 $ su
 # ./build.sh -O ../obj -T ../tools -U install=/ </programlisting>
-</listitem>
+  </listitem>
 
 </itemizedlist>
-
 </sect3>
 
     </sect2>
Prev by Date: changes/2002.xml
Next by Date: pkgsrc/doc/guide/files/configuring.xml: 1.27 -> 1.28 ほか
Prev by thread: changes/2002.xml
Next by thread: pkgsrc/doc/guide/files/configuring.xml: 1.27 -> 1.28 ほか
Index(es):
- Date
- Thread