From owner-doc-jp@jp.freebsd.org  Sun Oct 31 15:41:14 1999
Received: (from daemon@localhost)
	by castle.jp.freebsd.org (8.9.3+3.2W/8.7.3) id PAA67731;
	Sun, 31 Oct 1999 15:41:14 +0900 (JST)
	(envelope-from owner-doc-jp@jp.FreeBSD.org)
Received: from sv01.geocities.co.jp (sv01.geocities.co.jp [210.153.89.155])
	by castle.jp.freebsd.org (8.9.3+3.2W/8.7.3) with ESMTP id PAA67726
	for <doc-jp@jp.freebsd.org>; Sun, 31 Oct 1999 15:41:14 +0900 (JST)
	(envelope-from hrs@geocities.co.jp)
Received: from mail.geocities.co.jp (mail.geocities.co.jp [210.153.89.137]) by sv01.geocities.co.jp (8.9.3+3.2W/3.7W) with ESMTP id PAA17587 for <doc-jp@jp.freebsd.org>; Sun, 31 Oct 1999 15:41:13 +0900 (JST)
Received: from mail.hrs.jp (sutnmax1-ppp45.ed.noda.sut.ac.jp [133.31.173.55]) by mail.geocities.co.jp (1.3G-GeocitiesJ-3.3) with ESMTP id PAA07619 for <doc-jp@jp.freebsd.org>; Sun, 31 Oct 1999 15:41:12 +0900 (JST)
Message-Id: <199910310641.PAA07619@mail.geocities.co.jp>
Received: from localhost (alph.hrs.jp [192.168.0.10])
	by mail.hrs.jp (8.9.3/3.7W/DomainMaster) with ESMTP id PAA77423
	for <doc-jp@jp.freebsd.org>; Sun, 31 Oct 1999 15:35:57 +0900 (JST)
	(envelope-from hrs@hrs.jp)
To: FreeBSD-doc-jp <doc-jp@jp.freebsd.org>
X-Mailer: Mew version 1.94 on Emacs 19.34 / Mule 2.3 (SUETSUMUHANA)
Mime-Version: 1.0
Content-Type: Text/Plain; charset=iso-2022-jp
Content-Transfer-Encoding: 7bit
Date: Sun, 31 Oct 1999 15:35:10 +0900
From: Hiroki Sato <hrs@geocities.co.jp>
X-Dispatcher: imput version 990905(IM130)
Lines: 128
Reply-To: doc-jp@jp.freebsd.org
Precedence: list
X-Distribute: distribute version 2.1 (Alpha) patchlevel 24e+990727
X-Sequence: doc-jp 6820
Subject: [doc-jp 6820] <handbook> cutting-edge/chapter.sgml 1.30 -> 1.32 (part 1/7)
Errors-To: owner-doc-jp@jp.freebsd.org
Sender: owner-doc-jp@jp.freebsd.org
X-Originator: hrs@geocities.co.jp

$B:4F#!wEl5~M}2JBg3X$G$9!#(B

cutting-edge/chapter.sgml 1.30 -> 1.32 $B$N1Q8lHG:9J,$O(B
$BJ,NL$,B?$$$?$a!"E,Ev$JBg$-$5$KJ,$1$?:9J,$rN.$7$^$9!#(B

$B:G=*E*$J(B merge $B$O:4F#$,$d$j$^$9$N$G!"(B
$BK]Lu$5$l$kJ}$O!"3F:9J,C10L$GC1=c$KK]Lu$9$k$@$1$G9=$$$^$;$s!#(B

$B$^$:0l$DL\!#(B

@@ -167,9 +167,9 @@
 	      <para>You can do:
 					
 		<screen><prompt>ftp&gt;</prompt> <userinput>cd usr.bin</userinput>
-<prompt>ftp&gt;</prompt> <userinput>get lex.tar.Z</userinput></screen>
+<prompt>ftp&gt;</prompt> <userinput>get lex.tar</userinput></screen>
 		
-		and it will get the whole directory for you as a compressed
+		and it will get the whole directory for you as a
 		tar file.</para>
 	    </listitem>
 	  </orderedlist>
@@ -324,9 +324,9 @@
 	      <para>You can do:
 		
 		<screen><prompt>ftp&gt;</prompt> <userinput>cd usr.bin</userinput>
-<prompt>ftp&gt;</prompt> <userinput>get lex.tar.Z</userinput></screen>
+<prompt>ftp&gt;</prompt> <userinput>get lex.tar</userinput></screen>
 			
-		and it will get the whole directory for you as a compressed
+		and it will get the whole directory for you as a
 		tar file.</para>
 	    </listitem>
 	  </orderedlist>
@@ -1127,7 +1127,14 @@
 	    collection</link> or the corresponding <ulink
 	    url="ftp://ftp.FreeBSD.org/pub/FreeBSD/packages-current/net/cvsup-16.0.tgz">binary
 	    package</ulink>, depending on whether you prefer to roll your own
-	  or not.</para>
+	  or not.  If you do not know anything about cvsup at all and want a
+	  single package which will install it, set up the configuration file
+	  and start the transfer via a pointy-clicky type of interface, then
+	  get the <ulink
+	  url="ftp://ftp.FreeBSD.org/pub/FreeBSD/development/CVSup/cvsupit.tgz">
+	  cvsupit</ulink> package.  Just hand it to pkg_add(1) and it will
+	  lead you through the configuration process in a menu-oriented fashion.
+	  </para>
 	    
 	<para>If you are running FreeBSD-2.1.6 or 2.1.7, you unfortunately
 	  cannot use the binary package versions due to the fact that they
@@ -2478,12 +2485,1106 @@
       <literal>current</literal> and so on) you must then use the source tree
       to rebuild the system.</para>
 	
-    <para>Currently, the best source of information on how to do that is a
-      tutorial available from <ulink
-	url="http://www.nothing-going-on.demon.co.uk/FreeBSD/make-world/make-world.html">http://www.nothing-going-on.demon.co.uk/FreeBSD/make-world/make-world.html</ulink>.</para>
+    <warning>
+      <title>Take a backup</title>
+      
+      <para>I cannot stress highly enough how important it is to take a backup
+	of your system <emphasis>before</emphasis> you do this.  While
+	remaking the world is (as long as you follow these instructions) an
+	easy task to do, there will inevitably be times when you make
+	mistakes, or when mistakes made by others in the source tree render
+	your system unbootable.</para>
+    
+      <para>Make sure you have taken a backup.  And have a fixit floppy to
+	hand.  I have never needed to use them, and, touch wood, I never will,
+	but it is always better to be safe than sorry.</para>
+    </warning>
+
+    <warning>
+      <title>Subscribe to the right mailing list</title>
+      
+      <para>The -stable and -current FreeBSD code branches are, by their
+	nature,  <emphasis>in development</emphasis>.  People that contribute
+	to FreeBSD are human, and mistakes occasionally happen.</para>
+
+      <para>Sometimes these mistakes can be quite harmless, just causing your
+	system to print a new diagnostic warning.  Or the change may be
+	catastrophic, and render your system unbootable or destroy your
+	filesystems (or worse).</para>
+
+      <para>If problems like these occur, a <quote>heads up</quote> is posted
+	to  the appropriate mailing list, explaining the nature of the problem
+	and which systems it affects.  And an <quote>all clear</quote>
+	announcement is posted when the problem has been solved.</para>
+
+      <para>If you try and track -stable or -current and do not read
+	<email>FreeBSD-stable@FreeBSD.ORG</email> or
+	<email>FreeBSD-current@FreeBSD.ORG</email> then you are asking for
+	trouble.</para>
+    </warning>
+
+  <sect2>
+      <title>Check <filename>/etc/make.conf</filename></title>
+      
+      <para>Examine the file <filename>/etc/make.conf</filename>.  This
+	contains some default defines for <command/make/, which will be used
+	when you rebuild the source.  They are also used every time you use
+	<command/make/, so it is a good idea to make sure they are set to
+	something sensible for your system.</para>
+    
+      <para>Everything is, by default, commented out.  Uncomment those entries
+	that look useful.  For a typical user (not a developer), you will
+	probably want to uncomment the CFLAGS and NOPROFILE
+	definitions.</para>
+
+      <note>
+	<title/Version 2.1.7 and below/
+	
+	<para>If your machine has a floating point unit (386DX, 486DX, Pentium
+	  and up class machines) then you can also uncomment the HAVE_FPU
+	  line.</para>
+
+	<para>This definition was removed for version 2.2.2 and up of
+	  FreeBSD.</para>
+      </note>
+      
+      <para>Examine the other definitions (COPTFLAGS, NOPORTDOCS and so on)
+	and decide if they are relevant to you.</para>
+    </sect2>

--
| $B:4F#(B $B9-@8!wEl5~M}2JBg3X(B <hrs@geocities.co.jp>
|                         mailto:j7397067@ed.noda.sut.ac.jp
|
