Author: kkolinko
Date: Thu Nov 20 03:13:00 2014
New Revision: 1640655
URL: http://svn.apache.org/r1640655
Log:
Update CGI-howto.
Recommend to copy the servlet into one's own web application instead of
uncommenting it globally.
Modified:
tomcat/trunk/webapps/docs/cgi-howto.xml
Modified: tomcat/trunk/webapps/docs/cgi-howto.xml
URL:
http://svn.apache.org/viewvc/tomcat/trunk/webapps/docs/cgi-howto.xml?rev=1640655&r1=1640654&r2=1640655&view=diff
==============================================================================
--- tomcat/trunk/webapps/docs/cgi-howto.xml (original)
+++ tomcat/trunk/webapps/docs/cgi-howto.xml Thu Nov 20 03:13:00 2014
@@ -23,7 +23,6 @@
&project;
<properties>
- <author email="gl...@apache.org">Glenn L. Nielsen</author>
<title>CGI How To</title>
</properties>
@@ -61,11 +60,29 @@ this servlet is mapped to the URL patter
external to the Tomcat JVM. If you are using the Java SecurityManager this
will bypass your security policy configuration in
<code>catalina.policy.</code></p>
-<p>Remove the XML comments from around the CGI servlet and servlet-mapping
-configuration in <code>$CATALINA_BASE/conf/web.xml</code>.</p>
+<p>To enable CGI support:</p>
-<p>Only Contexts which are marked as privileged may use the CGI servlet (see
the
-privileged property of the Context element).</p>
+<ol>
+<li><p>There are commented-out sample servlet and servlet-mapping elements for
+CGI servlet in the default <code>$CATALINA_BASE/conf/web.xml</code> file.
+To enable CGI support in your web application, copy that servlet and
+servlet-mapping declarations into <code>WEB-INF/web.xml</code> file of your
+web application.</p>
+
+<p>Uncommenting the servlet and servlet-mapping in
+<code>$CATALINA_BASE/conf/web.xml</code> file enables CGI for all installed
+web applications at once.</p>
+</li>
+
+<li><p>Set <code>privileged="true"</code> on the Context element for your
+web application.</p>
+
+<p>Only Contexts which are marked as privileged are allowed to use the
+CGI servlet. Note that modifying the global
<code>$CATALINA_BASE/conf/context.xml</code>
+file affects all web applications. See
+<a href="config/context.html">Context documentation</a> for details.</p>
+</li>
+</ol>
</section>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org
For additional commands, e-mail: dev-h...@tomcat.apache.org
