svn commit: r40806 - head/en_US.ISO8859-1/books/handbook/cutting-edge

[Warren Block]

Author: wblock
Date: Tue Jan 29 22:37:44 2013
New Revision: 40806
URL: http://svnweb.freebsd.org/changeset/doc/40806

Log:
  Fix some minor grammar and punctuation problems.
  freebsd-update: change one mention to a man entity.
  freebsd-update: Set SRCCONF to null in both custom kernel sections.
  doc: add link to FDP in "building doc from source" section.
  doc: use <replaceable> in svn URL
  Move indexterm in signal 11 FAQ to answer fix rendering.
  Some changes suggested by Mehmet Erol Sanliturk
  <m.e.sanliturk at gmail.com>.

Modified:
  head/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.xml

Modified: head/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.xml	Tue Jan 29 20:12:33 2013	(r40805)
+++ head/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.xml	Tue Jan 29 22:37:44 2013	(r40806)
@@ -12,7 +12,7 @@
 	<firstname>Jim</firstname>
 	<surname>Mock</surname>
 	<contrib>Restructured, reorganized, and parts updated
-	  by</contrib>
+	  by </contrib>
       </author>
       <!-- Mar 2000 -->
     </authorgroup>
@@ -168,7 +168,7 @@
     </note>
 
     <para>If a <command>crontab</command> utilizing the features
-      of <command>freebsd-update</command> exists, it must be
+      of &man.freebsd-update.8; exists, it must be
       disabled before the following operation is started.</para>
 
     <sect2 id="freebsdupdate-config-file">
@@ -432,7 +432,7 @@ MergeChanges /etc/ /var/named/etc/</prog
 		installed from the sources:</para>
 
 	      <screen>&prompt.root; <userinput>cd /usr/src</userinput>
-&prompt.root; <userinput>env DESTDIR=/boot/GENERIC make kernel __MAKE_CONF=/dev/null</userinput>
+&prompt.root; <userinput>env DESTDIR=/boot/GENERIC make kernel __MAKE_CONF=/dev/null SRCCONF=/dev/null</userinput>
 &prompt.root; <userinput>mv /boot/GENERIC/boot/kernel/* /boot/GENERIC</userinput>
 &prompt.root; <userinput>rm -rf /boot/GENERIC/boot</userinput></screen>
 
@@ -481,7 +481,7 @@ MergeChanges /etc/ /var/named/etc/</prog
 		installed from the sources:</para>
 
 	      <screen>&prompt.root; <userinput>cd /usr/src</userinput>
-&prompt.root; <userinput>make kernel __MAKE_CONF=/dev/null</userinput></screen>
+&prompt.root; <userinput>make kernel __MAKE_CONF=/dev/null SRCCONF=/dev/null</userinput></screen>
 
 	      <para>For this kernel to be identified as the
 		<literal>GENERIC</literal> kernel by
@@ -912,7 +912,7 @@ Fetching 133 new ports or files... done.
 	western US mirror using the HTTPS protocol with this
 	command:</para>
 
-      <screen>&prompt.root; <userinput>svn checkout <literal>https://svn0.us-west.FreeBSD.org/doc/head</literal> /usr/doc</userinput></screen>
+      <screen>&prompt.root; <userinput>svn checkout <replaceable>https://svn0.us-west.FreeBSD.org</replaceable>/doc/head /usr/doc</userinput></screen>
 
       <para>Please use the closest mirror from the available <link
 	  linkend="svn-mirrors">Subversion mirror sites</link>.</para>
@@ -1021,6 +1021,11 @@ Fetching 133 new ports or files... done.
 
       <screen>&prompt.root; <userinput>cd /usr/doc</userinput>
 &prompt.root; <userinput>make FORMATS='html html-split' install clean</userinput></screen>
+
+      <para>For information on editing and submitting corrections to
+	the documentation, please see the <ulink
+	  url="&url.books.fdp-primer;">FreeBSD Documentation
+	  Project Primer for New Contributors</ulink>.</para>
     </sect2>
 
     <sect2 id="doc-ports">
@@ -2924,13 +2929,13 @@ Script done, …</screen>
 
 	<qandaentry>
 	  <question>
-	    <indexterm><primary>signal 11</primary></indexterm>
-
 	    <para>My compile failed with lots of signal 11 (or other
 	      signal number) errors.  What has happened?</para>
 	  </question>
 
 	  <answer>
+	    <indexterm><primary>signal 11</primary></indexterm>
+
 	    <para>This is normally indicative of hardware problems.
 	      (Re)making the world is an effective way to stress test
 	      your hardware, and will frequently throw up memory
@@ -2969,7 +2974,7 @@ Script done, …</screen>
 	    <para>However, if you know what you are doing you can have
 	      <command>make buildworld</command> skip this step.  This
 	      will make subsequent builds run much faster, since most
-	      of sources will not need to be recompiled.  The flip
+	      of the sources will not need to be recompiled.  The flip
 	      side of this is that subtle dependency problems can
 	      creep in, causing your build to fail in odd ways.  This
 	      frequently generates noise on the &os; mailing lists,