# HG changeset patch
# User jbe
# Date 1503337947 -7200
# Node ID ec1cca939315d437f640942a1cf30f79c675bcc6
# Parent  55a43a67e9ada3d61fd657476c8a85e3e790aa60
Improved documentation of WebMCP's initialization procedure

diff -r 55a43a67e9ad -r ec1cca939315 doc/autodoc-header.htmlpart
--- a/doc/autodoc-header.htmlpart	Mon Aug 21 15:01:21 2017 +0200
+++ b/doc/autodoc-header.htmlpart	Mon Aug 21 19:52:27 2017 +0200
@@ -131,43 +131,48 @@
     </p>
     <ol>
       <li>
-        Loading all WebMCP libraries except the "multirand" library (multirand opens /dev/urandom and thus must not be loaded prior to forking)
+        Initialization code of <tt>mcp.lua</tt> in the <tt>bin/</tt> directory of the framework, including:
+        <ul>
+          <li>Initialization of WebMCP's autoloader in <tt>mcp.lua</tt> (in the <tt>bin/</tt> directory of the framework),</li>
+          <li>Execution of <tt>env/__init.lua</tt> (both relative to the framework and, if existent, relative to the application base directory)</li>
+          <li>Loading of most of WebMCP's libraries (excluding "multirand" library, which must not be loaded prior to forking);</li>
+        </ul>
       </li>
       <li>
-        Executing the selected configuration file: <tt>config/</tt><i>configuration_name</i><tt>.lua</tt>
+        Executing the selected configuration file: <tt>config/</tt><i>configuration_name</i><tt>.lua</tt>;
       </li>
       <li>
-        Executing all pre-fork initializers (both those in the <tt>app/_prefork/</tt> and those in the <tt>app/</tt><i>application_name</i><tt>/_prefork/</tt> directory) until call of <tt>execute.inner()</tt> within each initializer
+        Executing all pre-fork initializers (both those in the <tt>app/_prefork/</tt> and those in the <tt>app/</tt><i>application_name</i><tt>/_prefork/</tt> directory) until call of <tt>execute.inner()</tt> within each initializer;
       </li>
       <li>
-        The Moonbridge Network Server forks the process (i.e. cloning the whole Lua machine)<br />
+        The Moonbridge Network Server forks the process (i.e. cloning the whole Lua machine);<br />
         <span style="color: red">Note: no file handles or network connections must be opened prior to this point!</span>
       </li>
       <li>
-        Loading WebMCP's "multirand" library
+        Loading WebMCP's "multirand" library;
       </li>
       <li>
-        Executing all post-fork initializers (both those in the <tt>app/_postfork/</tt> and those in the <tt>app/</tt><i>application_name</i><tt>/_postfork/</tt> directory) until call of <tt>execute.inner()</tt> within each initializer
+        Executing all post-fork initializers (both those in the <tt>app/_postfork/</tt> and those in the <tt>app/</tt><i>application_name</i><tt>/_postfork/</tt> directory) until call of <tt>execute.inner()</tt> within each initializer;
       </li>
       <li>
         For each request:
         <ul>
           <li>
-            Execution of all applicable filters until call of <tt>execute.inner()</tt> within each filter
+            Execution of all applicable filters until call of <tt>execute.inner()</tt> within each filter,
           </li>
           <li>
-            Handling of the request by calling the appropriate view or action
+            Handling of the request by calling the appropriate view or action,
           </li>
           <li>
-            Resuming execution of all filters in reverse order from that position where <tt>execute.inner()</tt> had been called
+            Resuming execution of all filters in reverse order from that position where <tt>execute.inner()</tt> had been called;
           </li>
         </ul>
       </li>
       <li>
-        Resuming execution of all post-fork initializers in reverse order from that position where <tt>execute.inner()</tt> had been called
+        Resuming execution of all post-fork initializers in reverse order from that position where <tt>execute.inner()</tt> had been called;
       </li>
       <li>
-        Resuming execution of all pre-fork initializers in reverse order from that position where <tt>execute.inner()</tt> had been called
+        Resuming execution of all pre-fork initializers in reverse order from that position where <tt>execute.inner()</tt> had been called.
       </li>
     </ol>
     </p>