[svnbook] r3953 committed - * src/en/book/ch06-server-configuration.xml...

[svnbook at googlecode.com]

Revision: 3953
Author:   cmpilato at gmail.com
Date:     Thu Aug  4 05:47:12 2011
Log:      * src/en/book/ch06-server-configuration.xml
   Still more launchd section edits.

Patch by: Quinn "More patches than an heirloom quilt" Taylor  
<quinntaylor at mac.com>

http://code.google.com/p/svnbook/source/detail?r=3953

Modified:
  /trunk/src/en/book/ch06-server-configuration.xml

=======================================
--- /trunk/src/en/book/ch06-server-configuration.xml	Wed Aug  3 13:19:09  
2011
+++ /trunk/src/en/book/ch06-server-configuration.xml	Thu Aug  4 05:47:12  
2011
@@ -733,16 +733,6 @@
            <command>svnserve</command> as a long-running
            background process.</para>

-        <warning>
-          <para>The Mac OS X <command>launchd</command> system can be
-            somewhat challenging to learn.  Fortunately, the operating
-            system provides online documentation for the various
-            commands we describe in this section.  For example,
-            run <userinput>man launchd</userinput> from the command
-            line to read the manual page for
-            the <command>launchd</command> daemon itself.</para>
-        </warning>
-
          <para>To configure <command>svnserve</command> as
            a <command>launchd</command> job, first create a job
            definition file named
@@ -795,6 +785,16 @@
  </programlisting>
          </example>

+        <warning>
+          <para>The <command>launchd</command> system can be somewhat
+            challenging to learn.  Fortunately, documentation exists
+            for the commands described in this section. For example,
+            run <userinput>man launchd</userinput> from the command
+            line to see the manual page for <command>launchd</command>
+            itself, <userinput>man launchd.plist</userinput> to read
+            about the job definition format, etc.</para>
+        </warning>
+
          <para>Once your job definition file is created, you can
            activate the job using <command>launchctl load</command>:</para>

@@ -805,12 +805,12 @@
  </screen>
          </informalexample>

-        <para>To be clear, this action doesn't
-          launch <command>svnserve</command> yet.  It simply tells
-          your system that when incoming networking traffic arrives on
-          the <literal>svn</literal> network port, it should fire up a
-          short-lived instead of <command>svnserve</command> to handle
-          that traffic.</para>
+        <para>To be clear, this action doesn't actually launch
+          <command>svnserve</command> yet.  It simply tells
+          <command>launchd</command> how to fire up
+          <command>svnserve</command> when incoming networking traffic
+          arrives on the <literal>svn</literal> network port; it will
+          be terminated it after the traffic has been handled.</para>

          <note>
            <para>Because we want <command>svnserve</command> to be a