BugRat Report #393 has been filed.

[BugRat Mail System <to...@cortexity.com>]

Bug report #393 has just been filed.

You can view the report at the following URL:

   <http://znutar.cortexity.com:8888/BugRatViewer/ShowReport/393>

REPORT #393 Details.

Project: Struts
Category: Bug Report
SubCategory: New Bug Report
Class: docbug
State: received
Priority: medium
Severity: non-critical
Confidence: public
Environment: 
   Release: latest
   JVM Release: any
   Operating System: all
   OS Release: any
   Platform: any

Synopsis: 
problems with build.dat and setting SERVLETAPI_HOME

Description:
I've had problems building from source with SERVLETAPI_HOME
set.  The documentation at:
   http://jakarta.apache.org/struts/installation.html#Building

says that either the SERVLETAPI_HOME must be set (to
the directory containing 'lib\servlet.jar') or the
jar file must be part of the CLASSPATH.

I've found that when servlet.jar is not part of the
CLASSPATH, and SERVLETAPI_HOME is correctly set, the
the 'javadoc' task in 'build.bat dist' generates
errors because it cannot find the Servlet classes.
I tried to remedy this by adding the attribute:

  classpath="${servlet.jar}"

to the 'javadoc' task.  However, Javadoc was able
to find the Servlet classes, but was no longer able
to find the XML classes.  It seems that the classpath
attribute in the 'javadoc' task overrides the CLASSPATH
environment variable.

My conclusion is that:
  1. SERVLETAPI_HOME should not be set, and the
     Servlet Jar should be added to the CLASSPATH
     environment variable.
  2. -Dservlet.home %SERVLETAPI_HOME%\lib\servlet.jar
     can be removed from 'build.bat'
  3. all instances of ${servlet.jar} may be removed
     from 'build.xml'