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>