webmcp

changeset 520:ec1cca939315

Improved documentation of WebMCP's initialization procedure
author jbe
date Mon Aug 21 19:52:27 2017 +0200 (2017-08-21)
parents 55a43a67e9ad
children c5bf8d6963c4
files doc/autodoc-header.htmlpart
line diff
     1.1 --- a/doc/autodoc-header.htmlpart	Mon Aug 21 15:01:21 2017 +0200
     1.2 +++ b/doc/autodoc-header.htmlpart	Mon Aug 21 19:52:27 2017 +0200
     1.3 @@ -131,43 +131,48 @@
     1.4      </p>
     1.5      <ol>
     1.6        <li>
     1.7 -        Loading all WebMCP libraries except the "multirand" library (multirand opens /dev/urandom and thus must not be loaded prior to forking)
     1.8 +        Initialization code of <tt>mcp.lua</tt> in the <tt>bin/</tt> directory of the framework, including:
     1.9 +        <ul>
    1.10 +          <li>Initialization of WebMCP's autoloader in <tt>mcp.lua</tt> (in the <tt>bin/</tt> directory of the framework),</li>
    1.11 +          <li>Execution of <tt>env/__init.lua</tt> (both relative to the framework and, if existent, relative to the application base directory)</li>
    1.12 +          <li>Loading of most of WebMCP's libraries (excluding "multirand" library, which must not be loaded prior to forking);</li>
    1.13 +        </ul>
    1.14        </li>
    1.15        <li>
    1.16 -        Executing the selected configuration file: <tt>config/</tt><i>configuration_name</i><tt>.lua</tt>
    1.17 +        Executing the selected configuration file: <tt>config/</tt><i>configuration_name</i><tt>.lua</tt>;
    1.18        </li>
    1.19        <li>
    1.20 -        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
    1.21 +        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;
    1.22        </li>
    1.23        <li>
    1.24 -        The Moonbridge Network Server forks the process (i.e. cloning the whole Lua machine)<br />
    1.25 +        The Moonbridge Network Server forks the process (i.e. cloning the whole Lua machine);<br />
    1.26          <span style="color: red">Note: no file handles or network connections must be opened prior to this point!</span>
    1.27        </li>
    1.28        <li>
    1.29 -        Loading WebMCP's "multirand" library
    1.30 +        Loading WebMCP's "multirand" library;
    1.31        </li>
    1.32        <li>
    1.33 -        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
    1.34 +        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;
    1.35        </li>
    1.36        <li>
    1.37          For each request:
    1.38          <ul>
    1.39            <li>
    1.40 -            Execution of all applicable filters until call of <tt>execute.inner()</tt> within each filter
    1.41 +            Execution of all applicable filters until call of <tt>execute.inner()</tt> within each filter,
    1.42            </li>
    1.43            <li>
    1.44 -            Handling of the request by calling the appropriate view or action
    1.45 +            Handling of the request by calling the appropriate view or action,
    1.46            </li>
    1.47            <li>
    1.48 -            Resuming execution of all filters in reverse order from that position where <tt>execute.inner()</tt> had been called
    1.49 +            Resuming execution of all filters in reverse order from that position where <tt>execute.inner()</tt> had been called;
    1.50            </li>
    1.51          </ul>
    1.52        </li>
    1.53        <li>
    1.54 -        Resuming execution of all post-fork initializers in reverse order from that position where <tt>execute.inner()</tt> had been called
    1.55 +        Resuming execution of all post-fork initializers in reverse order from that position where <tt>execute.inner()</tt> had been called;
    1.56        </li>
    1.57        <li>
    1.58 -        Resuming execution of all pre-fork initializers in reverse order from that position where <tt>execute.inner()</tt> had been called
    1.59 +        Resuming execution of all pre-fork initializers in reverse order from that position where <tt>execute.inner()</tt> had been called.
    1.60        </li>
    1.61      </ol>
    1.62      </p>

Impressum / About Us