creating the javadoc api documentation from the fop sources failes due to a illegal charatcer in PDFGraphics2D.java : ------- D:\>D:\Programme\Java\J2SE\SDK\j2sdk1.4.1_01\bin\javadoc -sourcepath . -d apidocs -subpackages org.apache.fop Loading source files for package org.apache.fop.apps... Loading source files for package org.apache.fop.configuration... Loading source files for package org.apache.fop.datatypes... Loading source files for package org.apache.fop.extensions... Loading source files for package org.apache.fop.fo... Loading source files for package org.apache.fop.fo.expr... Loading source files for package org.apache.fop.fo.flow... Loading source files for package org.apache.fop.fo.pagination... Loading source files for package org.apache.fop.fonts.apps... Loading source files for package org.apache.fop.fonts... Loading source files for package org.apache.fop.fonts.type1... Loading source files for package org.apache.fop.image... Loading source files for package org.apache.fop.image.analyser... Loading source files for package org.apache.fop.layout... Loading source files for package org.apache.fop.layout.hyphenation... Loading source files for package org.apache.fop.layout.inline... Loading source files for package org.apache.fop.messaging... Loading source files for package org.apache.fop.mif... Loading source files for package org.apache.fop.pdf... Loading source files for package org.apache.fop.render... Loading source files for package org.apache.fop.render.awt... Loading source files for package org.apache.fop.render.mif... Loading source files for package org.apache.fop.render.mif.fonts... Loading source files for package org.apache.fop.render.pcl... Loading source files for package org.apache.fop.render.pdf... Loading source files for package org.apache.fop.render.pdf.fonts... Loading source files for package org.apache.fop.render.ps... Loading source files for package org.apache.fop.render.svg... Loading source files for package org.apache.fop.render.txt... Loading source files for package org.apache.fop.render.xml... Loading source files for package org.apache.fop.svg... D:\Programme\Apache\XML\Fop\fop-0.20.5rc2\src\.\org\apache\fop\svg\PDFGraphics2D .java:1288: illegal character: \64 @jdk14codestart@ ^ D:\Programme\Apache\XML\Fop\fop-0.20.5rc2\src\.\org\apache\fop\svg\PDFGraphics2D .java:1288: illegal character: \64 @jdk14codestart@ ^ D:\Programme\Apache\XML\Fop\fop-0.20.5rc2\src\.\org\apache\fop\svg\PDFGraphics2D .java:1292: illegal character: \64 @jdk14codeend@ ^ D:\Programme\Apache\XML\Fop\fop-0.20.5rc2\src\.\org\apache\fop\svg\PDFGraphics2D .java:1292: illegal character: \64 @jdk14codeend@ ^ D:\Programme\Apache\XML\Fop\fop-0.20.5rc2\src\.\org\apache\fop\svg\PDFGraphics2D .java:1292: <identifier> expected @jdk14codeend@ ^ Loading source files for package org.apache.fop.tools.anttasks... Loading source files for package org.apache.fop.tools... Loading source files for package org.apache.fop.tools.xslt... Loading source files for package org.apache.fop.viewer... 5 errors ------- the result is the javadocs only fur the subpackages "apps". by the way: why isn't there an only javadoc like with the other apache projects (e.g. Xalan : http://xml.apache.org/xalan-j/apidocs/index.html)
That's the string substitution tag for the java 1.4 compatiblity. I don't think this will be fixed in the maintenance branch (HEAD does currently not have this problem). If you really want to have the javadocs, delete the tags or somthing to this effect.
The build works correctly in gump for the maintenance branch. Try building the javadocs using the build.bat: http://xml.apache.org/fop/compiling.html It looks like our doc could stand to be improved here. I'll work on it.
Oops. Sorry, javadocs were NOT being built by gump on the maintenance branch, and would have failed if they had. I have fixed the problem on the build, and have added the javadoc target so that they will be built by gump. Also, I think we are within a few days of having the gump javadocs output available from the FOP website. Look for a link on the dev page, and I'll probably post a message on the fop-user & fop-dev lists as well.
batch transition to closed remaining pre-FOP1.0 resolved bugs