[pkg-java] r2775 - branches/tomcat5.5/feature/debian/debian

[Marcus Better]

Author: marcusb-guest
Date: 2006-11-21 11:02:14 +0100 (Tue, 21 Nov 2006)
New Revision: 2775

Modified:
   branches/tomcat5.5/feature/debian/debian/README.Debian
Log:
Document gcj and security mangager issue better.


Modified: branches/tomcat5.5/feature/debian/debian/README.Debian
===================================================================
--- branches/tomcat5.5/feature/debian/debian/README.Debian	2006-11-21 09:55:18 UTC (rev 2774)
+++ branches/tomcat5.5/feature/debian/debian/README.Debian	2006-11-21 10:02:14 UTC (rev 2775)
@@ -30,21 +30,27 @@
   file from SUN or Blackdown into a deb package. Tomcat5.5 also works
   with free runtimes like java-gcj-compat-dev or kaffe.
 
-- You can install our own web applications as .war files or in extracted form
-  into a subdirectory of /var/lib/tomcat5.5/webapps. The name of the WAR file
-  or subdirectory is the servlet context for this webapp.
+  WARNING: Currently Tomcat cannot use a security manager while
+  running under java-gcj-compat-dev. Do not run without a security
+  manager unless you understand the consequences. See
+    http://localhost:8180/tomcat-docs/security-manager-howto.html
+  for more information.
 
 - You can test if Tomcat is working properly by pointing your favourite web
   browser to http://localhost:8180/ and testing some of the Servlet and JSP
   examples. This requires installation of the tomcat5.5-webapps package.
 
+- You can install our own web applications as .war files or in extracted form
+  into a subdirectory of /var/lib/tomcat5.5/webapps. The name of the WAR file
+  or subdirectory is the servlet context for this webapp.
+
 - Multiple Tomcat instances can be started by different users when
   $CATALINA_BASE is set to a local directory that contains the subdirectories
   conf, logs, webapps, work and temp. See RUNNING.txt for more about this.
 
-- Tomcat is started using a security manager, you can define the permissions
+- When Tomcat runs with a security manager, you can define the permissions
   for your servlets and JSPs in /etc/tomcat5.5/policy.d/*. All files in this
-  directory are joined to /etc/tomcat5.5/catalina.policy at startup.
+  directory are joined to create /etc/tomcat5.5/catalina.policy at startup.
 
   If your webapp does not work with the tomcat5.5 Debian package but works fine
   with the binary distribution from Jakarta, try to disable the security
@@ -52,10 +58,6 @@
   permissions in a new file in /etc/tomcat5.5/policy.d/ restart and re-enable 
   the security manager.
 
-  Disabling the security manager is not recommended on production systems
-  since a call to System.exit() in a servlet of JSP page would then stop the
-  whole virtual machine that is running Tomcat.
-
 - There is a webapp for basic web-based administration of Tomcat's webapps
   in the tomcat5.5-admin package. You need to add one of the users in
   /var/lib/tomcat5.5/conf/tomcat-users.xml to the manager role and probably
@@ -77,10 +79,7 @@
 - For more information about Jakarta-Tomcat please take a look at the Tomcat
   home page at <http://tomcat.apache.org/index.html>.
 
-- The official Servlet 2.4 and JSP 2.0 specifications can be found at
-  <http://java.sun.com/products/servlet/> & <http://java.sun.com/products/jsp/>
-
 - This package is heavily based on the great work of Stephan Gybas on
   the tomcat4 package
 
- -- Arnaud Vandyck <avdyk at debian.org>, Fri, 23 Jun 2006 12:40:58 +0200
+ -- Marcus Better <marcus at better.se>, Tue, 21 Nov 2006 11:01:41 +0100