RESENDING: BUG: Xalan-Java 1.2.D02: Error building "docs" target - Ant and GNU make

[Barry Draper <ba...@informix.com>]

>X-Sender: barry@pop0.oak.informix.com
>X-Mailer: QUALCOMM Windows Eudora Pro Version 4.1 
>Date: Thu, 31 Aug 2000 11:12:08 -0700
>To: xalan-dev@xml.apache.org
>From: Barry Draper <ba...@informix.com>
>Subject: BUG: Xalan-Java 1.2.D02: Error building "docs" target - Ant
>  and GNU make
>Cc: barry@informix.com
>
>Hello. This is my first posting to this alias. Please advise if I violated
>any protocols.
>I am using Xalan-Java 1.2.D02 and am reporting a bug with building the
>build/docs 
>directory files (build target "docs") using both the Ant build tool and the
>GNU makefile.
>I am using Sun JDK 1.2.2 on Solaris 2.6, with 1.1.3 Xerces-Java.
>
>Result when using Ant
>--------------------------------
>> sh build.sh docs
>Xalan-J Build
>-------------
>
>Building with classpath
>bin/ant.jar:/opt/depot/jdk-1.2.2/lib/tools.jar:./xerces.jar:./bsf.jar:./bsfe
>ngines.jar:xdocs/stylebook-1.0-b2.jar:xdocs/xalanjdoc.jar:/local1/barry/jswd
>k-1.0.1/lib/servlet.jar:.:/opt/depot/jdk-1.2.2/lib:/net/louie/local1/barry/A
>pache_XML/xerces-j-/bin/xerces.jar:/net/louie/local1/barry/Apache_XML/xerces
>-j/samples:/net/louie/local1/barry/Apache_XML/xalan-j/xalan.jar
>
>Starting Ant...
>Buildfile: build.xml
>
>prepare:
>
>prepare.docs:
>    [untar] Expanding:
>/local1/barry/Apache_XML/xalan-j/xdocs/xml-site-style.tar into
>/local1/barry/Apache_XML/xalan-j/xdocs
>
>compile:
>
>package:
>
>autodocs:
>autodocs is for automated build process, without dependencies
>
>BUILD FAILED
>
>build.xml:195: Error exec: /local1/barry/Apache_XML/xalan-j/bin/antRun
>/local1/barry/Apache_XML/xalan-j java -classpath
>bin/ant.jar:/opt/depot/jdk-1.2.2/lib/tools.jar:./xerces.jar:./bsf.jar:./bsfe
>ngines.jar:xdocs/stylebook-1.0-b2.jar:xdocs/xalanjdoc.jar:/local1/barry/jswd
>k-1.0.1/lib/servlet.jar:.:/opt/depot/jdk-1.2.2/lib:/net/louie/local1/barry/A
>pache_XML/xerces-j/bin/xerces.jar:/net/louie/local1/barry/Apache_XML/xerces-
>j/samples:/net/louie/local1/barry/Apache_XML/xalan-j/xalan.jar:./build/xalan
>.jar org.apache.stylebook.StyleBook targetDirectory=./build/docs
>./xdocs/sources/xalanlocal.xml ./xdocs/style
>java.io.IOException: /local1/barry/Apache_XML/xalan-j/bin/antRun: cannot
>execute
>	at java.lang.UNIXProcess.forkAndExec(Native Method)
>	at java.lang.UNIXProcess.<init>(UNIXProcess.java, Compiled Code)
>	at java.lang.Runtime.execInternal(Native Method)
>	at java.lang.Runtime.exec(Runtime.java, Compiled Code)
>	at java.lang.Runtime.exec(Runtime.java, Compiled Code)
>	at java.lang.Runtime.exec(Runtime.java, Compiled Code)
>	at org.apache.tools.ant.taskdefs.Exec.run(Exec.java, Compiled Code)
>	at org.apache.tools.ant.taskdefs.Java.executeJava(Java.java, Compiled Code)
>	at org.apache.tools.ant.taskdefs.Java.execute(Java.java, Compiled Code)
>	at org.apache.tools.ant.Target.execute(Target.java, Compiled Code)
>	at org.apache.tools.ant.Project.runTarget(Project.java, Compiled Code)
>	at org.apache.tools.ant.Project.executeTarget(Project.java, Compiled Code)
>	at org.apache.tools.ant.Project.executeTargets(Project.java, Compiled Code)
>	at org.apache.tools.ant.Main.runBuild(Main.java, Compiled Code)
>	at org.apache.tools.ant.Main.main(Main.java, Compiled Code)
>
>Total time: 3 seconds
>
>I examined the build/docs and build/docs/apidocs directories and found they
>were empty. No .html files were copied to those directories.
>
>I then tried using GNU make (though I know it is discouraged).
>
>GNU Make results
>---------------------------
>
>java -classpath
>"../../xml-xerces/java/bin/xerces.jar:../xalan.jar:../bsf.jar:../bsfengines.
>jar:xalanjdoc.jar:stylebook-1.0-b2.jar:.:/opt/depot/jdk-1.2.2/lib:/net/louie
>/local1/barry/Apache_XML/xerces-j/bin/xerces.jar:/net/louie/local1/barry/Apa
>che_XML/xerces-j/samples:/net/louie/local1/barry/Apache_XML/xalan-j/xalan.ja
>r" org.apache.stylebook.StyleBook "loaderConfig=sbk:/style/loaderjdoc.xml"
>targetDirectory=../src sources/javadocPackages.xml style
>[StyleBook] Overriding loaderConfig="sbk:/style/loaderjdoc.xml"
>(Old="sbk:/style/loader.xml")
>[StyleBook] Overriding targetDirectory="../src" (Old=".")
>[StyleBook] Project URL: "sbk:/sources/javadocPackages.xml"
>[BasicEngine] Initializing
>[Loader] Parsing Project file
>[XercesParser] File "sbk:/style/dtd/javadocPackages.dtd" not found. [File:
>"sbk:/sources/javadocPackages.xml" Line: 0 Column: 0]
>[Loader] Caught org.apache.stylebook.CreationException
>[StyleBook] Caught org.apache.stylebook.LoadingException
>org.apache.stylebook.LoadingException: SAXException caught while parsing
>	at org.apache.stylebook.Loader.load(Loader.java, Compiled Code)
>	at org.apache.stylebook.StyleBook.getProject(StyleBook.java, Compiled Code)
>	at org.apache.stylebook.StyleBook.main(StyleBook.java, Compiled Code)
>[StyleBook] Error creating project
>Gmake[1]: *** [makejavadoc] Error 3
>Gmake[1]: Leaving directory `/local1/barry/Apache_XML/xalan-j/xdocs'
>Gmake: *** [makedocs] Error 2
>
>I noticed that there is the following file:
>/local1/barry/Apache_XML/xalan-j/xdocs/style/dtd/javadocpackages.dtd
>and suspected that the above failure was simply due to a typographical error.
>I copied javadocpackages.dtd to javadocPackages.dtd
>and ran Gmake docs again (Gmake is the ClearCase GNU make).
>This time, the build completed without error (although I got 187 warnings) and
>the documentation files were copied. I could read them without error in my 
>Web browser.
>
>To summarize, I am reporting the following:
>1) a bug using Ant to build the "docs" target which I was not able to resolve
>2) a bug using the GNU makefile to build the "docs" target for which I am
>providing
>    what I believe to be a correct fix, which is to rename 
>    /local1/barry/Apache_XML/xalan-j/xdocs/style/dtd/javadocpackages.dtd
>    to
>    /local1/barry/Apache_XML/xalan-j/xdocs/style/dtd/javadocPackages.dtd
>
>Thanks.
>
>Barry Draper
>Informix Software, Inc.
>Oakland, CA
>Email: barry @informix.com
>
>
>