cvs commit: jakarta-tomcat/src/doc faq

[bojan]

bojan   02/01/27 15:42:45

  Modified:src/doc  faq
  Log:
  Include segmentation errors in FAQ. It's been asked too often.
  
  Revision  ChangesPath
  1.4   +9 -1  jakarta-tomcat/src/doc/faq
  
  Index: faq
  ===
  RCS file: /home/cvs/jakarta-tomcat/src/doc/faq,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- faq   12 Mar 2001 04:18:14 -  1.3
  +++ faq   27 Jan 2002 23:42:45 -  1.4
  @@ -341,4 +341,12 @@
   throw new Error(e.toString());
}
 }
  -   }
  \ No newline at end of file
  +   }
  +
  +
  +Q. Whey I run Tomcat, my JVM gives me segmentation fault of segmentation
  +   violation errors. Should I be reporting a Tomcat bug?
  +
  +A. No. This is surely a JVM problem. Possible solutions are to switch to
  +   another JVM, apply relevant patches to your OS or find out if there are
  +   any particular environmental settings required.
  
  
  

--
To unsubscribe, e-mail:   
For additional commands, e-mail: 

cvs commit: jakarta-tomcat/src/doc faq

[larryi]

larryi  01/03/11 20:18:15

  Modified:src/doc  faq
  Log:
  Update the jar file list.
  
  Also, add a question and answer to explain the problem that can occur when
  using beans with properties whose second letter is capitalized.
  
  Revision  ChangesPath
  1.3   +72 -11jakarta-tomcat/src/doc/faq
  
  Index: faq
  ===
  RCS file: /home/cvs/jakarta-tomcat/src/doc/faq,v
  retrieving revision 1.2
  retrieving revision 1.3
  diff -u -r1.2 -r1.3
  --- faq   2001/02/08 21:40:01 1.2
  +++ faq   2001/03/12 04:18:14 1.3
  @@ -57,6 +57,7 @@
  specific problem/exception can be obtained by looking at the 
  server-side trace.
   
  +
   Q: What do I need in my CLASSPATH?
   
   A: All you need is a correct version of JDK (1.1.x or 1.2). 
  @@ -70,19 +71,31 @@
  All other classes, jar files that are needed, are put by the startserver
  script and you don't need to worry about them.
   
  +
   Q: Where are the classes for JSPs and Servlets?
  +
  +A: lib classes:
  +
  + tomcat.jar -- Executable jar for starting Tomcat
  + stop-tomcat.jar-- Executable jar for stopping Tomcat
  +
  +   lib/common classes
  +
  + core_util.jar  -- Utility classes used by apps and container
  + jasper-runtime.jar -- JSP Engine runtime classes
  + servlet.jar-- Public APIs for Servlets and JSP
  + tomcat_core.jar-- Tomcat web server core classes
  +
  +   lib/container classes
  +
  + facade22.jar   -- Servlet Engine classes.
  + jasper.jar -- JSP Engine translation classes
  + jaxp.jar   -- Public APIs for XML parser interface
  + parser.jar -- Public XML parser reference implementation
  + tomcat_modules.jar -- Tomcat module classes
  + tomcat_util.jar-- Utility classes.
  + tomcat-startup.jar -- Tomcat start/stop classes
   
  -A: lib/facade22.jar-- Servlet Engine classes.
  -   lib/jaxp.jar   -- Public APIs for XML parser interface
  -   lib/parser.jar -- Public XML parser reference implementation
  -   lib/tomcat_core.jar-- Tomcat web server core classes
  -   lib/tomcat_modules.jar -- Tomcat module classes
  -   lib/tomcat-startup.jar -- Tomcat start/stop classes
  -   lib/common/servlet.jar -- Public APIs for Servlet.
  -   lib/shared/jasper.jar  -- JSP Engine classes
  -   lib/shared/tomcat_util.jar -- Utility classes.
  -   lib/tomcat.jar -- Executable jar for starting Tomcat
  -   lib/stop-tomcat.jar-- Executable jar for stopping Tomcat
   
   Q: Can I combine these classes with other webservers?
   
  @@ -91,6 +104,7 @@
  the Servlet 2.2 API but we have not tested this release on any servlet 
  engine other than the one in Tomcat.
   
  +
   Q: Where do I put my jsp sources and beans?
   
   A: If you just want to test JSPs without creating a separate web-application
  @@ -196,12 +210,14 @@
   
http://localhost:8080/WEBAPP/yourfile.jsp
   
  +
   Q: How are the URIs mapped at the server?
   
   A: First, the web-server will match the beginning of the requested URI
  against the prefixes of all contexts (web-applications). If no context 
  matches, it will use the default context instead. 
   
  +
   Q: What do different init parameters for the JSP engine mean?
   
  * keepgenerated: 
  @@ -281,3 +297,48 @@
   *.jsp
   
   
  +
  +
  +Q. I have a bean with a property whose second letter is capitalized.
  +   Why won't my JSP page that uses this bean compile?
  +
  +A. This may not happen often, but can be difficult to determine why.
  +   The reason is found in the Java Beans specification, where in section
  +   "8.8 Capitalization of inferred names" it states:
  +
  +   Thus when we extract a property or event name from the middle of an
  +   existing Java name, we normally convert the first character to lower
  +   case. However to support the occasional use of all upper-case names,
  +   we check if the first two characters of the name are both upper case
  +   and if so leave it alone.
  +
  +   This means that if you have a bean with a setter method of "setXLoc",
  +   then the inferred property is "XLoc", not "xLoc".  If you used this
  +   bean in a JSP page and you tried to use "xLoc" as the property, it
  +   would not compile. Using "XLoc" as the property would succeed.
  +
  +   If you insist on using "xLoc" on the JSP page, you can make this possible
  +   by creating a BeanInfo class for the bean.  The following is an example
  +   of such a BeanInfo class for a simple bean called Coordinate.  It
  +   explicitly defines the properties of the bean to be "xLoc" and "yLoc".
  +
  +   import java.beans.*;
  +   public class CoordinateBeanInfo extends SimpleBeanInfo
  +   {
  +  private final static Class beanClass = Coordinate.class;
  +
  +  

cvs commit: jakarta-tomcat/src/doc faq

[larryi]

larryi  01/02/08 13:40:05

  Modified:src/doc  faq
  Log:
  Port 3.2 faq. Update the jar file info for Tomcat 3.3m1.
  
  Revision  ChangesPath
  1.2   +46 -17jakarta-tomcat/src/doc/faq
  
  Index: faq
  ===
  RCS file: /home/cvs/jakarta-tomcat/src/doc/faq,v
  retrieving revision 1.1
  retrieving revision 1.2
  diff -u -r1.1 -r1.2
  --- faq   2000/02/08 21:08:34 1.1
  +++ faq   2001/02/08 21:40:01 1.2
  @@ -72,11 +72,17 @@
   
   Q: Where are the classes for JSPs and Servlets?
   
  -A: webserver.jar  -- class files for Servlet Engine.
  -   lib/jspengine.jar -- class files for JSP Engine.
  -   lib/servlet.jar   -- Public APIs for Servlet.
  -   lib/jsp.jar   -- Public APIs for JSP.
  -   lib/xml.jar   -- classes for parsing XML document.
  +A: lib/facade22.jar-- Servlet Engine classes.
  +   lib/jaxp.jar   -- Public APIs for XML parser interface
  +   lib/parser.jar -- Public XML parser reference implementation
  +   lib/tomcat_core.jar-- Tomcat web server core classes
  +   lib/tomcat_modules.jar -- Tomcat module classes
  +   lib/tomcat-startup.jar -- Tomcat start/stop classes
  +   lib/common/servlet.jar -- Public APIs for Servlet.
  +   lib/shared/jasper.jar  -- JSP Engine classes
  +   lib/shared/tomcat_util.jar -- Utility classes.
  +   lib/tomcat.jar -- Executable jar for starting Tomcat
  +   lib/stop-tomcat.jar-- Executable jar for stopping Tomcat
   
   Q: Can I combine these classes with other webservers?
   
  @@ -115,13 +121,21 @@
  To add "baseball" application you can make the following additions to 
  the file (at the appropriate place):
   
  -   
  +   
   
  +   Replace  with an absolute path to the "baseball" directory,
  +   or a relative path that is relative to the Tomcat home directory.
  +
  Please read "server.xml" for more details.
   
  +   In addition, thanks to the AutoSetup interceptor, you may create or
  +   copy the "baseball" directory to the "webapps" directory found under
  +   the Tomcat home directory.  When placed there, it will be served
  +   automcatically with the default settings.  A  entry
  +   in the server.xml is not required unless you want to override the
  +   default settings.
  +
  a) To install servlets within a web-application, you can do the following:
   
  * Once a servlet has been compiled, it can be added to Tomcat by:
  @@ -191,31 +205,46 @@
   Q: What do different init parameters for the JSP engine mean?
   
  * keepgenerated: 
  -Whether to keep the generated java file or no. Can take a
  -value of true/false. If value is true then the generated files 
  -are kept else they are deleted.
  +Whether to keep the generated java file or not. Can take a
  +value of true/false. If value is true, then the generated files 
  +are kept, otherwise they are deleted. The default is true.
   
  * scratchdir: 
The work dir which will be created for storing all the
generated code. This can be set to any dir. That directory will be 
created under the docbase.
   
  -   * largeFile: 
  +   * largefile: 
Can take a value of true/false. If the file is really large then 
all the static html is stored is a separate data file if the value 
  - of this param is set to true.
  + of this param is set to true. If true, this setting overrides
  +the mappedfile param. The default is false.
  +
  +   * mappedfile: 
  + Can take a value of true/false. If you prefer each line of static
  +html be output separately, set this parameter true.  If largefile
  +is set true, this param is ignored.  If neither largefile or
  +mappedfile is true, the static html is output in blocks up to 32K
  +in length. The default is false.
   
  * sendErrToClient: 
Can take a value of true/false. If set to true then all
the compilation/parsing errors will be sent as part of the response 
  - to the client.
  + to the client. The default is false.
   
  * ieClassId: 
This is used with the plugin. This is a particular id that is
set to activate the plugin. The default value for IE 4 and 5 are 
  - set as of now. This is for future use incase the classId for IE 
  + set as of now. This is for future use in case the classId for IE 
changes in the future. 
   
  +   * classdebuginfo: 
  + Whether to include debugging information in the class file. Can take
  +a value of true/false. If the value is true, then class debugging
  +information is included in the servlet class file when it is
  +compiled. The default is false.
  +
  +
  To set any of these to a value other than the default you need to
  explicitely defin

cvs commit: jakarta-tomcat/src/doc faq

[larryi]

larryi  01/01/14 12:18:04

  Modified:src/doc  Tag: tomcat_32 faq
  Log:
  Add information about "classdebuginfo" init paramter added to Jasper.
  Update other information as well.
  
  Revision  ChangesPath
  No   revision
  
  
  No   revision
  
  
  1.1.4.3   +38 -15jakarta-tomcat/src/doc/faq
  
  Index: faq
  ===
  RCS file: /home/cvs/jakarta-tomcat/src/doc/faq,v
  retrieving revision 1.1.4.2
  retrieving revision 1.1.4.3
  diff -u -r1.1.4.2 -r1.1.4.3
  --- faq   2001/01/13 14:11:09 1.1.4.2
  +++ faq   2001/01/14 20:18:01 1.1.4.3
  @@ -72,11 +72,11 @@
   
   Q: Where are the classes for JSPs and Servlets?
   
  -A: webserver.jar  -- class files for Servlet Engine.
  -   lib/jspengine.jar -- class files for JSP Engine.
  +A: lib/webserver.jar  -- class files for Servlet Engine.
  +   lib/jasper.jar-- class files for JSP Engine.
  lib/servlet.jar   -- Public APIs for Servlet.
  -   lib/jsp.jar   -- Public APIs for JSP.
  -   lib/xml.jar   -- classes for parsing XML document.
  +   lib/jaxp.jar  -- Public APIs for XML parser interface
  +   lib/parser.jar-- Public XML parser reference implementation
   
   Q: Can I combine these classes with other webservers?
   
  @@ -115,13 +115,21 @@
  To add "baseball" application you can make the following additions to 
  the file (at the appropriate place):
   
  -   
  +   
   
  +   Replace  with an absolute path to the "baseball" directory,
  +   or a relative path that is relative to the Tomcat home directory.
  +
  Please read "server.xml" for more details.
   
  +   In addition, thanks to the AutoSetup interceptor, you may create or
  +   copy the "baseball" directory to the "webapps" directory found under
  +   the Tomcat home directory.  When placed there, it will be served
  +   automcatically with the default settings.  A  entry
  +   in the server.xml is not required unless you want to override the
  +   default settings.
  +
  a) To install servlets within a web-application, you can do the following:
   
  * Once a servlet has been compiled, it can be added to Tomcat by:
  @@ -191,30 +199,45 @@
   Q: What do different init parameters for the JSP engine mean?
   
  * keepgenerated: 
  -Whether to keep the generated java file or no. Can take a
  -value of true/false. If value is true then the generated files 
  -are kept else they are deleted.
  +Whether to keep the generated java file or not. Can take a
  +value of true/false. If value is true, then the generated files 
  +are kept, otherwise they are deleted. The default is true.
   
  * scratchdir: 
The work dir which will be created for storing all the
generated code. This can be set to any dir. That directory will be 
created under the docbase.
   
  -   * largeFile: 
  +   * largefile: 
Can take a value of true/false. If the file is really large then 
all the static html is stored is a separate data file if the value 
  - of this param is set to true.
  + of this param is set to true. If true, this setting overrides
  +the mappedfile param. The default is false.
  +
  +   * mappedfile: 
  + Can take a value of true/false. If you prefer each line of static
  +html be output separately, set this parameter true.  If largefile
  +is set true, this param is ignored.  If neither largefile or
  +mappedfile is true, the static html is output in blocks up to 32K
  +in length. The default is false.
   
  * sendErrToClient: 
Can take a value of true/false. If set to true then all
the compilation/parsing errors will be sent as part of the response 
  - to the client.
  + to the client. The default is false.
   
  * ieClassId: 
This is used with the plugin. This is a particular id that is
set to activate the plugin. The default value for IE 4 and 5 are 
  - set as of now. This is for future use incase the classId for IE 
  + set as of now. This is for future use in case the classId for IE 
changes in the future. 
  +
  +   * classdebuginfo: 
  + Whether to include debugging information in the class file. Can take
  +a value of true/false. If the value is true, then class debugging
  +information is included in the servlet class file when it is
  +compiled. The default is false.
  +
   
  To set any of these to a value other than the default you need to
  explicitely define the JSP engine servlet and a mapping for the
  
  
  

-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, email: [EMAIL PROTECTED]

cvs commit: jakarta-tomcat/src/doc faq

[jiricka]

jiricka 01/01/13 06:11:10

  Modified:src/doc  Tag: tomcat_32 faq
  Log:
  Updating a DD code example to reflect repackaging of the JspServlet class.
  
  Revision  ChangesPath
  No   revision
  
  
  No   revision
  
  
  1.1.4.2   +1 -1  jakarta-tomcat/src/doc/faq
  
  Index: faq
  ===
  RCS file: /home/cvs/jakarta-tomcat/src/doc/faq,v
  retrieving revision 1.1.4.1
  retrieving revision 1.1.4.2
  diff -u -r1.1.4.1 -r1.1.4.2
  --- faq   2001/01/13 01:12:22 1.1.4.1
  +++ faq   2001/01/13 14:11:09 1.1.4.2
  @@ -225,7 +225,7 @@
 jsp
 
 
  -  org.apache.jasper.runtime.JspServlet
  +  org.apache.jasper.servlet.JspServlet
 
 
 
  
  
  

-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, email: [EMAIL PROTECTED]

Re: cvs commit: jakarta-tomcat/src/doc faq

[Hans Bergsten]

[EMAIL PROTECTED] wrote:
> 
> nacho   01/01/12 17:12:23
> 
>   Modified:src/doc  Tag: tomcat_32 faq
>   Log:
>   src/doc/faq contains wrong information for overriding the JspServlet
>   Submitter: David Rees ( [EMAIL PROTECTED]  )
> [...]
>   -  org.apache.jasper.runtime.JSPServlet
>   +  org.apache.jasper.runtime.JspServlet

Hmm... Doesn't look like you changed much ;-) "runtime" should be
replaced with "servlet". If you don't have the time to fix this I
will try to get to it this weekend.

Hans
-- 
Hans Bergsten   [EMAIL PROTECTED]
Gefion Software http://www.gefionsoftware.com
Author of JavaServer Pages (O'Reilly), http://TheJSPBook.com

-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, email: [EMAIL PROTECTED]

cvs commit: jakarta-tomcat/src/doc faq

[nacho]

nacho   01/01/12 17:12:23

  Modified:src/doc  Tag: tomcat_32 faq
  Log:
  src/doc/faq contains wrong information for overriding the JspServlet
  Submitter: David Rees ( [EMAIL PROTECTED]  )
  
  Revision  ChangesPath
  No   revision
  
  
  No   revision
  
  
  1.1.4.1   +1 -1  jakarta-tomcat/src/doc/faq
  
  Index: faq
  ===
  RCS file: /home/cvs/jakarta-tomcat/src/doc/faq,v
  retrieving revision 1.1
  retrieving revision 1.1.4.1
  diff -u -r1.1 -r1.1.4.1
  --- faq   2000/02/08 21:08:34 1.1
  +++ faq   2001/01/13 01:12:22 1.1.4.1
  @@ -225,7 +225,7 @@
 jsp
 
 
  -  org.apache.jasper.runtime.JSPServlet
  +  org.apache.jasper.runtime.JspServlet
 
 
 
  
  
  

-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, email: [EMAIL PROTECTED]