DO NOT REPLY [Bug 17136] New: - Xalan documentation needs polishing

[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=17136>.
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=17136

Xalan documentation needs polishing

           Summary: Xalan documentation needs polishing
           Product: XalanJ2
           Version: 2.4
          Platform: All
        OS/Version: All
            Status: NEW
          Severity: Enhancement
          Priority: Other
         Component: Xalan
        AssignedTo: xalan-dev@xml.apache.org
        ReportedBy: arenaud@accovia.com


Nice work guys, Xalan seems to work great for XSLT, like IE6, NN7 or
XMLSpy, but server-side.

Now would it be too much to be precise on documentation so that people
won't loose hours on small things.

Like, I don't know for the rest of it, but I stumbled quite a bit on the
servlet examples, only to discover at some point that they require
xml-apis.jar, something not mentioned anywhere...

Also some examples are not correct, for instance:
http://localhost/servlet.UseStylesheetParamServlet?XML=fooparam.xml&XSL=fooparam
.xsl&PVAL=GoodBye

will throw up;
it needs:
http://localhost/servlet.UseStylesheetParamServlet?XML=http://localhost/fooparam
.xml&XSL=http://localhost/fooparam.xsl&PVAL=GoodBye

or that spec.xsl is NOT in the distribution so why use it in the
examples... that sort of things.

I'm pointing that out because it seems a general pattern will all those Apache 
projects. For instance I had also problems with some Ant tasks... only to 
discover that they work fine... provided you had an adequate documentation, 
which again was not the case with Ant. Shall I go on with Tomcat, Struts, etc.? 
 You see my point.

Thanks.