[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Documentation/updating.xml: 1.5 -> 1.7
以下のページの更新をしました。ツッコミをお願いします。
Documentation/updating.xml: 1.5 -> 1.7
火曜日までに異議がなければ、 commit します。
# 1.8 は後日やります
## 人によってインデントと改行のしかたが違うのはなんとかならんか
> revision 1.7
> date: 2006/04/30 16:00:31; author: jschauma; state: Exp; lines: +3 -3
> move parenthesis inside a paragraph
> ----------------------------
> revision 1.6
> date: 2006/04/30 15:13:56; author: jschauma; state: Exp; lines: +28 -24
> Update this text to be valid for NetBSD 2.0 and 3.0, noting the differences
> to build.sh syntax in 1.6 where necessary.
以下、訳と原文の差分です。
--- Documentation/updating.xml.orig 2006-05-01 21:04:31.000000000 +0900
+++ Documentation/updating.xml 2006-05-01 21:04:31.000000000 +0900
@@ -6,21 +6,29 @@
<webpage id="ja-Documentation-updating">
<config param="desc" value="安定版 NetBSD リリースの更新" />
<config param="cvstag"
- value="$NetBSD: updating.xml,v 1.5 2005/11/05 07:55:19 reed Exp $" />
+ value="$NetBSD: updating.xml,v 1.7 2006/04/30 16:00:31 jschauma Exp $" />
<!-- Based on english version: -->
- <!-- NetBSD: updating.xml,v 1.5 2005/11/05 07:55:19 reed Exp -->
- <config param="rcsdate" value="$Date: 2005/11/05 07:55:19 $" />
+ <!-- NetBSD: updating.xml,v 1.7 2006/04/30 16:00:31 jschauma Exp -->
+ <config param="rcsdate" value="$Date: 2006/04/30 16:00:31 $" />
<head>
-<!-- Copyright (c) 2003-2005
- The NetBSD Foundation, Inc. ALL RIGHTS RESERVED. -->
+ <!-- Copyright (c) 2003-2006
+ The NetBSD Foundation, Inc. ALL RIGHTS RESERVED. -->
<title>安定版 NetBSD リリースの更新</title>
</head>
- <sect1 role="toc">
+ <sect1 role="toc" id="updating-stable">
<sect2 id="top">
+
+ <sect3 id="current">
+ <title>-current を追跡する</title>
+ <para>-current
+ の追跡方法についての資料は、
+ <ulink url="current/">この文書</ulink>をご覧ください。</para>
+ </sect3>
+
<sect3 id="update-src">
<title>ソースを更新する</title>
<para>安定版 (
- <ulink url="../Releases/formal-2.0/">NetBSD 2.0</ulink>
+ <ulink url="../Releases/formal-3.0/">NetBSD 3.0</ulink>
など) の NetBSD リリースを、本番環境として使っている場合、
そのリリース向けのセキュリティー上の修正を取り込むために、
時々ソースを更新のうえシステムまたはカーネルを再構築すべきです。
@@ -30,10 +38,10 @@
ssh</ulink>
を使っておこなうことができます。
たとえば、
- NetBSD 2.0 リリースのソースをチェックアウトするためには、
+ NetBSD 3.0 リリースのソースをチェックアウトするためには、
以下のようにします:</para>
<programlisting> $ cd /usr
- $ env CVS_RSH=ssh cvs -d anoncvs@anoncvs.NetBSD.org:/cvsroot co -r netbsd-2-0 -P src</programlisting>
+ $ env CVS_RSH=ssh cvs -d anoncvs@anoncvs.NetBSD.org:/cvsroot co -r netbsd-3-0 -P src</programlisting>
<note>
間違ってソースツリーを<emphasis>ダウングレード</emphasis>することのないよう、
適切な意図通りの枝タグを選ぶように気を付けてください。
@@ -51,13 +59,14 @@
スクリプトの書式が違うことにご注意ください。
<code>build.sh</code>
は、
- NetBSD 1.6 と -current では大幅に変わっています;
+ NetBSD 1.6 の後で、大幅に変わっています。(NetBSD > 1.6 または
-current を使っているのでなければ、
カーネルの構築に
<code>build.sh</code>
は
- <emphasis>使えません</emphasis>。</para>
+ <emphasis>使えません</emphasis>。)</para>
</sect3>
+
<sect3 id="userland">
<title>ユーザーランドを更新する</title>
<para>かならず
@@ -71,12 +80,14 @@
で指定できるオプションが<emphasis>たくさん</emphasis>あるので、
これは重要なことです。
結局は、単一のコマンドに要約されます:
- <code>build.sh -d</code>
+ <code>build.sh distribution</code> (NetBSD 1.6 の場合は
+ <code>build.sh -d</code>)
</para>
<para>これは、ユーザーランド
<emphasis>すべて</emphasis>
を更新することになるのに注意してください。</para>
</sect3>
+
<sect3 id="parts">
<title>ソースツリーの一部だけを更新する</title>
<para>セキュリティー勧告が発行され、
@@ -90,6 +101,7 @@
$ su
# make USETOOLS=no install</programlisting>
</sect3>
+
<sect3 id="summary">
<title>簡潔なまとめ</title>
<itemizedlist>
@@ -98,10 +110,8 @@
$ env CVS_RSH=ssh cvs update -dP</programlisting>
</listitem>
<listitem><para>カーネルの再構築:</para>
- <programlisting> $ cd /usr/src/sys/arch/<ARCH>/conf
- $ config <KERNEL>
- $ cd /usr/src/sys/arch/<ARCH>/compile/<KERNEL>
- $ make depend all
+ <programlisting> $ cd /usr/src
+ $ ./build.sh kernel=<KERNEL>
$ su
# mv /netbsd /netbsd.old
# mv /usr/src/sys/arch/<ARCH>/compile/<KERNEL>/netbsd /</programlisting>
@@ -110,17 +120,11 @@
<programlisting> $ cd /usr/src
$ ./build.sh -h
$ su
- # ./build.sh -d <other options></programlisting>
+ # ./build.sh <optional arguments> distribution</programlisting>
</listitem>
</itemizedlist>
</sect3>
- <sect3 id="current">
- <title>-current を追跡する</title>
- <para>-current
- の追跡方法についての資料は、
- <ulink url="current/">この文書</ulink>をご覧ください。</para>
- </sect3>
+
</sect2>
</sect1>
</webpage>
-
Index: Documentation/updating.xml
===================================================================
RCS file: /cvsroot/htdocs/Documentation/updating.xml,v
retrieving revision 1.5
retrieving revision 1.7
diff -u -r1.5 -r1.7
--- Documentation/updating.xml 5 Nov 2005 07:55:19 -0000 1.5
+++ Documentation/updating.xml 30 Apr 2006 16:00:31 -0000 1.7
@@ -6,19 +6,27 @@
<webpage id="Documentation-updating">
<config param="desc" value="Updating a stable NetBSD release" />
<config param="cvstag"
- value="$NetBSD: updating.xml,v 1.5 2005/11/05 07:55:19 reed Exp $" />
- <config param="rcsdate" value="$Date: 2005/11/05 07:55:19 $" />
+ value="$NetBSD: updating.xml,v 1.7 2006/04/30 16:00:31 jschauma Exp $" />
+ <config param="rcsdate" value="$Date: 2006/04/30 16:00:31 $" />
<head>
-<!-- Copyright (c) 2003-2005
- The NetBSD Foundation, Inc. ALL RIGHTS RESERVED. -->
+ <!-- Copyright (c) 2003-2006
+ The NetBSD Foundation, Inc. ALL RIGHTS RESERVED. -->
<title>Updating a stable NetBSD release</title>
</head>
- <sect1 role="toc">
+ <sect1 role="toc" id="updating-stable">
<sect2 id="top">
+
+ <sect3 id="current">
+ <title>Tracking -current</title>
+ <para>See
+ <ulink url="current/">this document</ulink>
+ for our documentation on how to track -current.</para>
+ </sect3>
+
<sect3 id="update-src">
<title>Updating the sources</title>
<para>If you are running a stable NetBSD release (such as
- <ulink url="../Releases/formal-2.0/">NetBSD 2.0</ulink>
+ <ulink url="../Releases/formal-3.0/">NetBSD 3.0</ulink>
), in a production environment, you should occasionally
update your sources and rebuild the system or the kernel,
in order to incorporate any security fixes that have been
@@ -28,10 +36,10 @@
<ulink url="current/#using-anoncvs-over-ssh">anoncvs over
ssh</ulink>
by specifying the correct branch tag. For example, to
- checkout the sources for the NetBSD 2.0 release, you
+ checkout the sources for the NetBSD 3.0 release, you
could use:</para>
<programlisting> $ cd /usr
- $ env CVS_RSH=ssh cvs -d anoncvs@anoncvs.NetBSD.org:/cvsroot co -r netbsd-2-0 -P src</programlisting>
+ $ env CVS_RSH=ssh cvs -d anoncvs@anoncvs.NetBSD.org:/cvsroot co -r netbsd-3-0 -P src</programlisting>
<note>
Be sure to take care in selecting the correct and desired branch tag so
you don't accidently <emphasis>downgrade</emphasis> your source tree.
@@ -49,13 +57,14 @@
<code>build.sh</code>
script.
<code>build.sh</code>
- has changed significantly between NetBSD 1.6 and -current;
- if you are not using -current, you can
+ has changed significantly after NetBSD 1.6. (If you are not using
+ NetBSD > 1.6 or -current, you can
<emphasis>not</emphasis>
use
<code>build.sh</code>
- to build the new kernel!</para>
+ to build the new kernel!)</para>
</sect3>
+
<sect3 id="userland">
<title>Updating the userland</title>
<para>Please always refer to
@@ -69,12 +78,14 @@
options that can be set on the command line or in
<filename>/etc/mk.conf</filename>
. In the end, it all boils down to a single command:
- <code>build.sh -d</code>
+ <code>build.sh distribution</code> (or <code>build.sh -d</code> on
+ NetBSD 1.6).
.</para>
<para>Note that this will update the
<emphasis>entire</emphasis>
userland!</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
@@ -88,6 +99,7 @@
$ su
# make USETOOLS=no install</programlisting>
</sect3>
+
<sect3 id="summary">
<title>Terse summary</title>
<itemizedlist>
@@ -96,10 +108,8 @@
$ env CVS_RSH=ssh cvs update -dP</programlisting>
</listitem>
<listitem><para>Build a new kernel:</para>
- <programlisting> $ cd /usr/src/sys/arch/<ARCH>/conf
- $ config <KERNEL>
- $ cd /usr/src/sys/arch/<ARCH>/compile/<KERNEL>
- $ make depend all
+ <programlisting> $ cd /usr/src
+ $ ./build.sh kernel=<KERNEL>
$ su
# mv /netbsd /netbsd.old
# mv /usr/src/sys/arch/<ARCH>/compile/<KERNEL>/netbsd /</programlisting>
@@ -108,17 +118,11 @@
<programlisting> $ cd /usr/src
$ ./build.sh -h
$ su
- # ./build.sh -d <other options></programlisting>
+ # ./build.sh <optional arguments> distribution</programlisting>
</listitem>
</itemizedlist>
</sect3>
- <sect3 id="current">
- <title>Tracking -current</title>
- <para>See
- <ulink url="current/">this document</ulink>
- for our documentation on how to track -current.</para>
- </sect3>
+
</sect2>
</sect1>
</webpage>
-