DO NOT REPLY [Bug 19435] New: - awkward documentation for novices (clarification herein)

[bu...@apache.org]

DO NOT REPLY TO THIS EMAIL, BUT PLEASE POST YOUR BUG 
RELATED COMMENTS THROUGH THE WEB INTERFACE AVAILABLE AT
<http://nagoya.apache.org/bugzilla/show_bug.cgi?id=19435>.
ANY REPLY MADE TO THIS MESSAGE WILL NOT BE COLLECTED AND 
INSERTED IN THE BUG DATABASE.

http://nagoya.apache.org/bugzilla/show_bug.cgi?id=19435

awkward documentation for novices (clarification herein)

           Summary: awkward documentation for novices (clarification herein)
           Product: Axis
           Version: 1.1rc2
          Platform: All
               URL: http://cvs.apache.org/viewcvs.cgi/~checkout~/xml-
                    axis/java/docs/install.html
        OS/Version: Other
            Status: NEW
          Severity: Normal
          Priority: Other
         Component: Documentation
        AssignedTo: axis-dev@ws.apache.org
        ReportedBy: jeff@cogentlogic.com


The installation instructions state:

"In your Application Server installation, you should find a directory into 
which web applications ("webapps") are to be placed. Into this directory copy 
the webapps/axis directory from the xml-axis distribution."

and later on:

"set AXIS_HOME=c:\tomcat\webapps\axis"

then:

"set AXIS_LIB=%AXIS_HOME%\lib"

but AXIS_HOME, as set above, doesn't contain lib (at least not by following "In 
your Application Server installation, ...").

I suspect that AXIS_HOME should be set as the folder containing the contents of 
axis-1_1RC2.zip since this does contain the lib folder (this works for me).


Also: on NT machines:

java -cp "%AXISCLASSPATH%" samples.stock.GetQuote -
lhttp://localhost:8080/axis/servlet/AxisServlet -uuser1 -wpass1 XXX 

won't work, instead use:

java -cp .;%AXISCLASSPATH% samples.stock.GetQuote -
lhttp://localhost:8080/axis/servlet/AxisServlet -uuser1 -wpass1 XXX 


I hope you don't think I'm being pedantic but for many Java developers 
classpath nonsense can be a show-stopper even after reading and following the 
standard classpath documentation :-)