svn commit: r854607 - in /websites/staging/sling/trunk/content: ./ documentation/the-sling-engine/the-sling-launchpad.html

[bu...@apache.org]

Author: buildbot
Date: Fri Mar 15 10:27:47 2013
New Revision: 854607

Log:
Staging update by buildbot for sling

Modified:
    websites/staging/sling/trunk/content/   (props changed)
    websites/staging/sling/trunk/content/documentation/the-sling-engine/the-sling-launchpad.html

Propchange: websites/staging/sling/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Fri Mar 15 10:27:47 2013
@@ -1 +1 @@
-1453826
+1456864

Modified: websites/staging/sling/trunk/content/documentation/the-sling-engine/the-sling-launchpad.html
==============================================================================
--- websites/staging/sling/trunk/content/documentation/the-sling-engine/the-sling-launchpad.html (original)
+++ websites/staging/sling/trunk/content/documentation/the-sling-engine/the-sling-launchpad.html Fri Mar 15 10:27:47 2013
@@ -91,6 +91,7 @@
 <li><a href="#sling-home">Sling Home</a></li>
 <li><a href="#command-line-options">Command Line Options</a><ul>
 <li><a href="#control-port">Control Port</a></li>
+<li><a href="#shutdown-hook">Shutdown Hook</a></li>
 </ul>
 </li>
 <li><a href="#servlet-parameters">Servlet Parameters</a></li>
@@ -187,6 +188,11 @@
 <td>Sets the property <code>n</code> to the value <code>v</code>. This option can be added repeatedly setting additional properties. Any property set in this manner overwrites same named properties in the <code>sling.properties</code> file. (since Sling Launchpad 2.4.0)</td>
 </tr>
 <tr>
+<td><code>-n</code></td>
+<td>--</td>
+<td>Don't install the shutdown hook. See <a href="#shutdown-hook">Shutdown Hook</a> below. (since Sling Launchpad 2.5.2)</td>
+</tr>
+<tr>
 <td><code>-h</code></td>
 <td>--</td>
 <td>Prints a simple usage message listing all available command line options.</td>
@@ -211,6 +217,14 @@
 <p>Suggestions:
 <em> Do not allow the control port to be opened on an externally visible interface. Using the localhost/127.0.0.1 is just sufficient.
 </em> Make sure only legitimate users have access to the installation folder of Sling (<code>${sling.home}</code>).</p>
+<h3 id="shutdown-hook">Shutdown Hook</h3>
+<p>By default the Sling Launchpad standalone application installs a Shutdown Hook with the Java Runtime to make sure the framework is properly
+terminated in case of a Java termination. In some situations or setups you want to control shutdown of Sling yourselves, so Sling supports a command
+line option <code>-n</code> to prevent the installation of a shutdown hook.</p>
+<p>Apart from the command line option, the <code>sling.shutdown.hook</code> system property is also supported: If this property is set to <code>true</code> or is not set at all
+the shutdown hook is installed as expected. If the property is set to anything other than <code>true</code>, e.g. <code>false</code>, the shutdown hook is not installed.</p>
+<p>If you are embedding the Sling Launchpad application's <code>Main</code> class, the <code>sling.shutdown.hook</code> property can also be set as a member of the <code>props</code> map
+handed to the <code>Main</code> constructor.</p>
 <h2 id="servlet-parameters">Servlet Parameters</h2>
 <p>The Web Application does not require specific servlet parameters. Those which are specified are used to overwrite any properties with the same name from the <code>sling.properties</code> file. One exception to this rule is the <code>sling.home</code> parameter, which is used to set the value of the <code>sling.home</code> property. If no parameter with this name is defined the Sling home directory is derived from the context path at which the Sling Web Application is registered.</p>
 <p>The <code>sling.home</code> folders for Sling Web Applications without the <code>sling.home</code> servlet parameter are all located in the <code>sling</code> folder in the current working directory as reported by the <code>user.dir</code> system property. The name of the actual directory is derived from the Web Application Context Path by replacing all slash characters <code>/</code> by underscore characters <code>_</code>. For the root context a single underscore character <code>_</code> is used.</p>
@@ -337,7 +351,7 @@
 </ul>
 <p>That's it. The resulting artifact may be directly used to launch the Standalone Java Application or may directly be deployed into any Servlet API 2.4 (or later) compliant servlet container.</p>
       <div class="timestamp" style="margin-top: 30px; font-size: 80%; text-align: right;">
-        Rev. 1366516 by fmeschbe on Fri, 27 Jul 2012 19:54:11 +0000
+        Rev. 1456864 by fmeschbe on Fri, 15 Mar 2013 10:27:37 +0000
       </div>
       <div class="trademarkFooter"> 
         Apache Sling, Sling, Apache, the Apache feather logo, and the Apache Sling project