This Bugzilla instance is a read-only archive of historic NetBeans bug reports. To report a bug in NetBeans please follow the project's instructions for reporting issues.
I would like to include additional documentation parts (apichanges, api-questions, etc.) into the API distribution, so they are aligned together with the javadoc. Here is a small patch to openide module to include the apichanges.html in the javadoc itself. Please review and let me know if this is reasonable.
Created attachment 8181 [details] apichanges.html included in the OpenAPIs javadoc
Not so easy.... XSL processing requires a network connection, bad behind a firewall. I need to get the XHTML DTD into CVS, which will (sigh) probably require a month of legal negotations.
Working on it, but first need to (1) be able to assume Ant 1.5.1, (2) be able to commit the XHTML DTD to CVS. So don't expect this anytime soon (dependencies on both buildmasters and lawyers).
Desired for ARC.
Created attachment 8185 [details] Modest refinements, but will have to suspend work on this until Ant & XHTML issues resolved
Created attachment 8189 [details] I have a better idea than to wait for lawyers. Ant <proxy> task.
See comments in issue #29337 for why I don't like this solution.
Done.
This does not seem to work for me. I have tried cd openide ant javadoc and always recieve following exception: [style] Using class org.apache.tools.ant.taskdefs.optional.TraXLiaison [style] Processing /home.local/jarda/src/jaga/openide.HEAD/api/doc/changes/apichanges.xml to /home.local/jarda/src/jaga/openide.HEAD/javadoc/OpenAPIs/apichanges.htm l [style] Loading stylesheet /home.local/jarda/src/jaga/nbbuild/javadoctools/apichanges.xsl [style] Failed to process /home.local/jarda/src/jaga/openide.HEAD/api/doc/changes/apichanges.xml BUILD FAILED /home.local/jarda/src/jaga/openide.HEAD/build.xml:671: javax.xml.transform.TransformerException: java.net.UnknownHostException: home.local at org.apache.tools.ant.taskdefs.XSLTProcess.process(XSLTProcess.java:374) at org.apache.tools.ant.taskdefs.XSLTProcess.execute(XSLTProcess.java:159) at org.apache.tools.ant.Task.perform(Task.java:217) at org.apache.tools.ant.Target.execute(Target.java:184) at org.apache.tools.ant.Target.performTasks(Target.java:202) at org.apache.tools.ant.Project.executeTarget(Project.java:601) at org.apache.tools.ant.Project.executeTargets(Project.java:560) at org.apache.tools.ant.Main.runBuild(Main.java:454) at org.apache.tools.ant.Main.start(Main.java:153) at org.apache.tools.ant.Main.main(Main.java:176) --- Nested Exception --- javax.xml.transform.TransformerException: java.net.UnknownHostException: home.local at org.apache.xalan.transformer.TransformerImpl.transform(TransformerImpl.java:686) at org.apache.xalan.transformer.TransformerImpl.transform(TransformerImpl.java:1088) at org.apache.xalan.transformer.TransformerImpl.transform(TransformerImpl.java:1066) at org.apache.tools.ant.taskdefs.optional.TraXLiaison.transform(TraXLiaison.java:127) at org.apache.tools.ant.taskdefs.XSLTProcess.process(XSLTProcess.java:369) at org.apache.tools.ant.taskdefs.XSLTProcess.execute(XSLTProcess.java:159) at org.apache.tools.ant.Task.perform(Task.java:217) at org.apache.tools.ant.Target.execute(Target.java:184) at org.apache.tools.ant.Target.performTasks(Target.java:202) at org.apache.tools.ant.Project.executeTarget(Project.java:601) at org.apache.tools.ant.Project.executeTargets(Project.java:560) at org.apache.tools.ant.Main.runBuild(Main.java:454) at org.apache.tools.ant.Main.start(Main.java:153) at org.apache.tools.ant.Main.main(Main.java:176) Caused by: java.net.UnknownHostException: home.local at org.apache.crimson.parser.Parser2.fatal(Parser2.java:3182) at org.apache.crimson.parser.Parser2.externalParameterEntity(Parser2.java:2870) at org.apache.crimson.parser.Parser2.maybePEReference(Parser2.java:2574) at org.apache.crimson.parser.Parser2.externalParameterEntity(Parser2.java:2895) at org.apache.crimson.parser.Parser2.maybeDoctypeDecl(Parser2.java:1167) at org.apache.crimson.parser.Parser2.parseInternal(Parser2.java:489) at org.apache.crimson.parser.Parser2.parse(Parser2.java:305) at org.apache.crimson.parser.XMLReaderImpl.parse(XMLReaderImpl.java:442) at org.apache.xml.dtm.ref.DTMManagerDefault.getDTM(DTMManagerDefault.java:349) at org.apache.xalan.transformer.TransformerImpl.transform(TransformerImpl.java:630) ... 13 more ---------
Doesn't happen to me; some problem in your config relating to JAXP or proxies or something, I presume. Try just plain <style> in a simple Ant script, or try a different JDK, etc. If it persists please open a separate bug and try to debug it yourself - I have no way of reproducing it. You may need to patch Xalan sources to include better debug info - they seem to have a habit of throwing away original stack traces, silently ignoring problems, etc.
*** Issue 29337 has been marked as a duplicate of this issue. ***
The new javadoc should appear on nb.org I guess. In such case something is wrong (maybe my problem) as JavaDoc on on nb.org has not been updated since this issue has been implemented. Ruda, what do you know about it - is release process of javadoc fine or not?
There were some bugs in the javadoc build, should be fixed now, let's hope.