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.

Bug 109722 - compilation of apidocs fails because of broken links
Summary: compilation of apidocs fails because of broken links
Status: RESOLVED INVALID
Alias: None
Product: apisupport
Classification: Unclassified
Component: API docs (show other bugs)
Version: 6.x
Hardware: All Linux
: P3 blocker (vote)
Assignee: Jesse Glick
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2007-07-14 18:11 UTC by fordfrog
Modified: 2007-08-28 17:49 UTC (History)
0 users

See Also:
Issue Type: DEFECT
Exception Reporter:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description fordfrog 2007-07-14 18:11:00 UTC
I tried to compile experimental cluster and the build failed at apidocs because of broken links. The code used is from
cvs from 2007-07-14 11:14:40.

javadoc-check-broken-links:
[checklinks] Scanning for broken links in
/var/tmp/portage/dev-util/netbeans-6.0_pre20070714111440/work/netbeans-src/apisupport/apidocs/build/javadoc ...
(external URLs will be skipped)
[checklinks] WARNING: Broken link referred from:
/var/tmp/portage/dev-util/netbeans-6.0_pre20070714111440/work/netbeans-src/apisupport/apidocs/build/javadoc/apichanges.html:273:27
Broken link:
file:/var/tmp/portage/dev-util/netbeans-6.0_pre20070714111440/work/netbeans-src/apisupport/apidocs/build/javadoc/org-netbeans-modules-nbjunit/apichanges.html
[checklinks]
/var/tmp/portage/dev-util/netbeans-6.0_pre20070714111440/work/netbeans-src/apisupport/apidocs/build/javadoc/apichanges.html:291:26:
broken link (already reported):
file:/var/tmp/portage/dev-util/netbeans-6.0_pre20070714111440/work/netbeans-src/apisupport/apidocs/build/javadoc/org-netbeans-modules-nbjunit/apichanges.html#logging
[checklinks]
/var/tmp/portage/dev-util/netbeans-6.0_pre20070714111440/work/netbeans-src/apisupport/apidocs/build/javadoc/apichanges.html:290:26:
broken link (already reported):
file:/var/tmp/portage/dev-util/netbeans-6.0_pre20070714111440/work/netbeans-src/apisupport/apidocs/build/javadoc/org-netbeans-modules-nbjunit/apichanges.html#controlFlow
[checklinks]
/var/tmp/portage/dev-util/netbeans-6.0_pre20070714111440/work/netbeans-src/apisupport/apidocs/build/javadoc/apichanges.html:214:27:
broken link (already reported):
file:/var/tmp/portage/dev-util/netbeans-6.0_pre20070714111440/work/netbeans-src/apisupport/apidocs/build/javadoc/org-netbeans-modules-nbjunit/apichanges.html#PreferencesForTests
[checklinks]
/var/tmp/portage/dev-util/netbeans-6.0_pre20070714111440/work/netbeans-src/apisupport/apidocs/build/javadoc/apichanges.html:252:27:
broken link (already reported):
file:/var/tmp/portage/dev-util/netbeans-6.0_pre20070714111440/work/netbeans-src/apisupport/apidocs/build/javadoc/org-netbeans-modules-nbjunit/apichanges.html#MockServicesAndLookup
[checklinks] WARNING: Broken link referred from:
/var/tmp/portage/dev-util/netbeans-6.0_pre20070714111440/work/netbeans-src/apisupport/apidocs/build/javadoc/overview-summary.html:2457:10
Broken link:
file:/var/tmp/portage/dev-util/netbeans-6.0_pre20070714111440/work/netbeans-src/apisupport/apidocs/build/javadoc/org-netbeans-modules-nbjunit/index.html
[checklinks] WARNING: Broken link referred from:
/var/tmp/portage/dev-util/netbeans-6.0_pre20070714111440/work/netbeans-src/apisupport/apidocs/build/javadoc/overview-summary.html:613:13
Broken link:
file:/var/tmp/portage/dev-util/netbeans-6.0_pre20070714111440/work/netbeans-src/apisupport/apidocs/build/javadoc/org-netbeans-modules-nbjunit-ide/overview-summary.html
[checklinks] WARNING: Broken link referred from:
/var/tmp/portage/dev-util/netbeans-6.0_pre20070714111440/work/netbeans-src/apisupport/apidocs/build/javadoc/overview-summary.html:2458:28
Broken link:
file:/var/tmp/portage/dev-util/netbeans-6.0_pre20070714111440/work/netbeans-src/apisupport/apidocs/build/javadoc/org-netbeans-modules-nbjunit/architecture-summary.html
[checklinks] WARNING: Broken link referred from:
/var/tmp/portage/dev-util/netbeans-6.0_pre20070714111440/work/netbeans-src/apisupport/apidocs/build/javadoc/overview-summary.html:2457:74
Broken link:
file:/var/tmp/portage/dev-util/netbeans-6.0_pre20070714111440/work/netbeans-src/apisupport/apidocs/build/javadoc/org-netbeans-modules-nbjunit.zip
[checklinks]
/var/tmp/portage/dev-util/netbeans-6.0_pre20070714111440/work/netbeans-src/apisupport/apidocs/build/javadoc/overview-summary.html:2490:62:
broken link (already reported):
file:/var/tmp/portage/dev-util/netbeans-6.0_pre20070714111440/work/netbeans-src/apisupport/apidocs/build/javadoc/org-netbeans-modules-nbjunit/architecture-summary.html#group-property
[checklinks]
/var/tmp/portage/dev-util/netbeans-6.0_pre20070714111440/work/netbeans-src/apisupport/apidocs/build/javadoc/usecases.html:3446:68:
broken link:
file:/var/tmp/portage/dev-util/netbeans-6.0_pre20070714111440/work/netbeans-src/apisupport/apidocs/build/javadoc/overview-summary.html#def-api-NB%20JUnit%20IDE%20Integration
  [nbmerge] Failed to build target: all-apisupport/apidocs

BUILD FAILED
/var/tmp/portage/dev-util/netbeans-6.0_pre20070714111440/work/netbeans-src/nbbuild/build.xml:654: The following error
occurred while executing this line:
/var/tmp/portage/dev-util/netbeans-6.0_pre20070714111440/work/netbeans-src/nbbuild/build.xml:649: The following error
occurred while executing this line:
/var/tmp/portage/dev-util/netbeans-6.0_pre20070714111440/work/netbeans-src/nbbuild/build.xml:699: The following error
occurred while executing this line:
/var/tmp/portage/dev-util/netbeans-6.0_pre20070714111440/work/netbeans-src/apisupport/apidocs/build.xml:68: The
following error occurred while executing this line:
/var/tmp/portage/dev-util/netbeans-6.0_pre20070714111440/work/netbeans-src/apisupport/apidocs/build.xml:39: The
following error occurred while executing this line:
/var/tmp/portage/dev-util/netbeans-6.0_pre20070714111440/work/netbeans-src/nbbuild/build.xml:258: The following error
occurred while executing this line:
/var/tmp/portage/dev-util/netbeans-6.0_pre20070714111440/work/netbeans-src/nbbuild/build.xml:498: There were broken links

Total time: 62 minutes 7 seconds
 * 
 * ERROR: dev-util/netbeans-6.0_pre20070714111440 failed.
 * Call stack:
 *   ebuild.sh, line 1647:   Called dyn_compile
 *   ebuild.sh, line 988:   Called qa_call 'src_compile'
 *   ebuild.sh, line 44:   Called src_compile
 *   netbeans-6.0_pre20070714111440.ebuild, line 419:   Called eant '-Dstop.when.broken.modules=true'
'-Dbuild.compiler.deprecation=false'
'-Dnb.clusters.list=nb.cluster.platform,nb.cluster.apisupport,nb.cluster.cnd,nb.cluster.experimental,nb.cluster.harness,nb.cluster.ide,nb.cluster.identity,nb.cluster.j2ee,nb.cluster.java,nb.cluster.mobility,nb.cluster.nb,nb.cluster.profiler,nb.cluster.ruby,nb.cluster.soa,nb.cluster.testtools,nb.cluster.uml,nb.cluster.visualweb,nb.cluster.xml'
'-f' 'nbbuild/build.xml' '-Dbuildnum=6.0_pre20070714111440' 'build-nozip'
 *   java-utils-2.eclass, line 1894:   Called die
 * 
 * eant failed
 * If you need support, post the topmost build error, and the call stack if relevant.
 * A complete build log is located at '/var/tmp/portage/dev-util/netbeans-6.0_pre20070714111440/temp/build.log'.
 * This ebuild is from an overlay: '/home/fordfrog/gentoo/java/java-experimental/'
 * 
!!! When you file a bug report, please include the following information:
GENTOO_VM=sun-jdk-1.5  CLASSPATH="" JAVA_HOME="/opt/sun-jdk-1.5.0.12"
JAVACFLAGS="-source 1.5 -target 1.5" COMPILER="javac"
Comment 1 Jesse Glick 2007-07-14 20:03:33 UTC
Odd. Runs fine on deadlock.netbeans.org. Looks like xtest/nbjunit is being included in one part of the build but is not
accessible in another. What is the exact command line you used to launch Ant?
Comment 2 fordfrog 2007-07-14 20:14:20 UTC
ANT_TASKS="ant-nodeps antlr-netbeans-cnd ant-antlr ant-trax" ANT_OPTS="-Xmx1g -Djava.awt.headless=true" eant
'-Dstop.when.broken.modules=true' '-Dbuild.compiler.deprecation=false'
'-Dnb.clusters.list=nb.cluster.platform,nb.cluster.apisupport,nb.cluster.cnd,nb.cluster.experimental,nb.cluster.harness,nb.cluster.ide,nb.cluster.identity,nb.cluster.j2ee,nb.cluster.java,nb.cluster.mobility,nb.cluster.nb,nb.cluster.profiler,nb.cluster.ruby,nb.cluster.soa,nb.cluster.testtools,nb.cluster.uml,nb.cluster.visualweb,nb.cluster.xml'
'-f' 'nbbuild/build.xml' '-Dbuildnum=6.0_pre20070714111440' 'build-nozip'

where eant is just wrapper for ant

complete build script (Gentoo ebuild) is here if needed:
http://overlays.gentoo.org/proj/java/browser/java-experimental/dev-util/netbeans/netbeans-6.0_pre20070714111440.ebuild
Comment 3 Jesse Glick 2007-07-14 20:16:37 UTC
Huh, you have nb.cluster.testtools. I will try it sometime.
Comment 4 fordfrog 2007-07-14 20:19:15 UTC
yeah, I try to build all the clusters
Comment 5 fordfrog 2007-08-25 23:48:36 UTC
apidocs still fails to compile, but now there is only one broken link (again building all clusters):

javadoc-stage-check:
[checklinks] Scanning for broken links in
/var/tmp/portage/dev-util/netbeans-6.0_pre20070825092557/work/netbeans-src/apisupport/apidocs/build/javadoc/org-openide-util
... (external URLs will be skipped)
[checklinks]
/var/tmp/portage/dev-util/netbeans-6.0_pre20070825092557/work/netbeans-src/apisupport/apidocs/build/javadoc/org-openide-util/checklinks-errors-org-openide-util.xml:
1 failures out of 1 tests

javadoc:
      [zip] Building zip:
/var/tmp/portage/dev-util/netbeans-6.0_pre20070825092557/work/netbeans-src/apisupport/apidocs/build/javadoc/org-openide-util.zip

netbeans-javadoc:
 [for-each] Process 'openide/awt' location with 'netbeans-javadoc' target ...

init-tasks:

default.init:
[propertyfile] Updating property file:
/var/tmp/portage/dev-util/netbeans-6.0_pre20070825092557/work/netbeans-src/nbbuild/netbeans/moduleCluster.properties

common-init:

-jdk-pre-preinit:

-jdk-preinit:

-jdk-warn:

-jdk-presetdef-basic:

-jdk-default:

-jdk-init:

basic-init:

-release.dir:

projectized-common.-release.files:

-release.files:

files-init:

jdk-5-check:

build-init:
  [nbmerge] Failed to build target: all-apisupport/apidocs

BUILD FAILED
/var/tmp/portage/dev-util/netbeans-6.0_pre20070825092557/work/netbeans-src/nbbuild/build.xml:654: The following error
occurred while executing this line:
/var/tmp/portage/dev-util/netbeans-6.0_pre20070825092557/work/netbeans-src/nbbuild/build.xml:649: The following error
occurred while executing this line:
/var/tmp/portage/dev-util/netbeans-6.0_pre20070825092557/work/netbeans-src/nbbuild/build.xml:699: The following error
occurred while executing this line:
/var/tmp/portage/dev-util/netbeans-6.0_pre20070825092557/work/netbeans-src/apisupport/apidocs/build.xml:68: The
following error occurred while executing this line:
/var/tmp/portage/dev-util/netbeans-6.0_pre20070825092557/work/netbeans-src/apisupport/apidocs/build.xml:39: The
following error occurred while executing this line:
/var/tmp/portage/dev-util/netbeans-6.0_pre20070825092557/work/netbeans-src/nbbuild/build.xml:254: The following error
occurred while executing this line:
/var/tmp/portage/dev-util/netbeans-6.0_pre20070825092557/work/netbeans-src/nbbuild/templates/projectized.xml:62: No such
classpath entry: /home/fordfrog/gentoo/tmp/netbeans/netbeans-src/nbbuild/netbeans/platform7/lib/org-openide-util.jar

Total time: 35 minutes 3 seconds
 * 
 * ERROR: dev-util/netbeans-6.0_pre20070825092557 failed.
 * Call stack:
 *   ebuild.sh, line 1654:   Called dyn_compile
 *   ebuild.sh, line 990:   Called qa_call 'src_compile'
 *   ebuild.sh, line 44:   Called src_compile
 *   netbeans-6.0_pre20070825092557.ebuild, line 436:   Called eant '-Dstop.when.broken.modules=true'
'-Dbuild.compiler.deprecation=false'
'-Dnb.clusters.list=nb.cluster.platform,nb.cluster.apisupport,nb.cluster.cnd,nb.cluster.experimental,nb.cluster.harness,nb.cluster.ide,nb.cluster.identity,nb.cluster.j2ee,nb.cluster.java,nb.cluster.mobility,nb.cluster.nb,nb.cluster.profiler,nb.cluster.ruby,nb.cluster.soa,nb.cluster.stableuc,nb.cluster.testtools,nb.cluster.uml,nb.cluster.visualweb,nb.cluster.xml'
'-f' 'nbbuild/build.xml' '-Dbuildnum=6.0_pre20070825092557' 'build-nozip'
 *   java-utils-2.eclass, line 1919:   Called die
 * 
 * eant failed
 * If you need support, post the topmost build error, and the call stack if relevant.
 * A complete build log is located at '/var/tmp/portage/dev-util/netbeans-6.0_pre20070825092557/temp/build.log'.
 * This ebuild is from an overlay: '/home/fordfrog/gentoo/java/java-experimental/'
 * 
!!! When you file a bug report, please include the following information:
GENTOO_VM=sun-jdk-1.5  CLASSPATH="." JAVA_HOME="/opt/sun-jdk-1.5.0.12"
JAVACFLAGS="-source 1.5 -target 1.5" COMPILER="javac"
Comment 6 Jesse Glick 2007-08-27 18:06:23 UTC
Broken links no longer cause build failures. They are aggregated into JUnit-style reports instead.

I have no idea why nbbuild/netbeans/platform7/lib/org-openide-util.jar would not be present; that file should be the
very second JAR built when running a regular NB source build.
Comment 7 fordfrog 2007-08-27 19:50:16 UTC
Hm, now I see where the problem is though I have no idea about the reason. See this line:

/var/tmp/portage/dev-util/netbeans-6.0_pre20070825092557/work/netbeans-src/nbbuild/templates/projectized.xml:62: No such
classpath entry: /home/fordfrog/gentoo/tmp/netbeans/netbeans-src/nbbuild/netbeans/platform7/lib/org-openide-util.jar

/var/tmp/portage/dev-util/netbeans-6.0_pre20070825092557/work/netbeans-src is where the nb sources are being located
/home/fordfrog/gentoo/tmp/netbeans/netbeans-src is CVS source tree of nb from where I create source tarballs

Here are scripts I use to package nb in Gentoo distro: https://overlays.gentoo.org/proj/java/browser/scripts/netbeans

First I update the sources using 'updatenbcvs', simply updating all nb modules cvs -q up -PCdRA -D
"<datetime_from_deadlock_stable_build>"
Then I run 'createnbtarballs' where I first clean nb tree using 'GENTOO_VM="sun-jdk-1.5" ant -f
netbeans-src/nbbuild/build.xml clean' and then create tarball for each module.

The reason mentioning the info above is I suppose somewhere during this process the path to the CVS tree is hardcoded
somewhere in nb.


Just now I noticed another strange thing, which is distro related. I have global CLASSPATH variable set to "." which is
weird. That could probably be the cause if nb build system scans the classpath when building apidocs so I'll first check
this and let you know if that was the cause.
Comment 8 fordfrog 2007-08-27 20:56:45 UTC
I disabled the classpath but the result is the same, and I checked I do not run the emerge (installation) script from
the CVS root so I guess it is hardcoded somewhere:

javadoc-stage-check:
[checklinks] Scanning for broken links in
/var/tmp/portage/dev-util/netbeans-6.0_pre20070825092557/work/netbeans-src/apisupport/apidocs/build/javadoc/org-openide-util
... (external URLs will be skipped)
[checklinks]
/var/tmp/portage/dev-util/netbeans-6.0_pre20070825092557/work/netbeans-src/apisupport/apidocs/build/javadoc/org-openide-util/checklinks-errors-org-openide-util.xml:
1 failures out of 1 tests

javadoc:
      [zip] Building zip:
/var/tmp/portage/dev-util/netbeans-6.0_pre20070825092557/work/netbeans-src/apisupport/apidocs/build/javadoc/org-openide-util.zip

netbeans-javadoc:
 [for-each] Process 'openide/awt' location with 'netbeans-javadoc' target ...

init-tasks:

default.init:
[propertyfile] Updating property file:
/var/tmp/portage/dev-util/netbeans-6.0_pre20070825092557/work/netbeans-src/nbbuild/netbeans/moduleCluster.properties

common-init:

-jdk-pre-preinit:

-jdk-preinit:

-jdk-warn:

-jdk-presetdef-basic:

-jdk-default:

-jdk-init:

basic-init:

-release.dir:

projectized-common.-release.files:

-release.files:

files-init:

jdk-5-check:

build-init:
  [nbmerge] Failed to build target: all-apisupport/apidocs

BUILD FAILED
/var/tmp/portage/dev-util/netbeans-6.0_pre20070825092557/work/netbeans-src/nbbuild/build.xml:654: The following error
occurred while executing this line:
/var/tmp/portage/dev-util/netbeans-6.0_pre20070825092557/work/netbeans-src/nbbuild/build.xml:649: The following error
occurred while executing this line:
/var/tmp/portage/dev-util/netbeans-6.0_pre20070825092557/work/netbeans-src/nbbuild/build.xml:699: The following error
occurred while executing this line:
/var/tmp/portage/dev-util/netbeans-6.0_pre20070825092557/work/netbeans-src/apisupport/apidocs/build.xml:68: The
following error occurred while executing this line:
/var/tmp/portage/dev-util/netbeans-6.0_pre20070825092557/work/netbeans-src/apisupport/apidocs/build.xml:39: The
following error occurred while executing this line:
/var/tmp/portage/dev-util/netbeans-6.0_pre20070825092557/work/netbeans-src/nbbuild/build.xml:254: The following error
occurred while executing this line:
/var/tmp/portage/dev-util/netbeans-6.0_pre20070825092557/work/netbeans-src/nbbuild/templates/projectized.xml:62: No such
classpath entry: /home/fordfrog/gentoo/tmp/netbeans/netbeans-src/nbbuild/netbeans/platform7/lib/org-openide-util.jar

Total time: 27 minutes 55 seconds
 * 
 * ERROR: dev-util/netbeans-6.0_pre20070825092557 failed.
 * Call stack:
 *   ebuild.sh, line 1654:   Called dyn_compile
 *   ebuild.sh, line 990:   Called qa_call 'src_compile'
 *   ebuild.sh, line 44:   Called src_compile
 *   netbeans-6.0_pre20070825092557.ebuild, line 440:   Called eant '-Dstop.when.broken.modules=true'
'-Dbuild.compiler.deprecation=false'
'-Dnb.clusters.list=nb.cluster.platform,nb.cluster.apisupport,nb.cluster.cnd,nb.cluster.experimental,nb.cluster.harness,nb.cluster.ide,nb.cluster.identity,nb.cluster.j2ee,nb.cluster.java,nb.cluster.mobility,nb.cluster.nb,nb.cluster.profiler,nb.cluster.ruby,nb.cluster.soa,nb.cluster.stableuc,nb.cluster.testtools,nb.cluster.uml,nb.cluster.visualweb,nb.cluster.xml'
'-f' 'nbbuild/build.xml' '-Dbuildnum=6.0_pre20070825092557' 'build-nozip'
 *   java-utils-2.eclass, line 1919:   Called die
 * 
 * eant failed
 * If you need support, post the topmost build error, and the call stack if relevant.
 * A complete build log is located at '/var/tmp/portage/dev-util/netbeans-6.0_pre20070825092557/temp/build.log'.
 * This ebuild is from an overlay: '/home/fordfrog/gentoo/java/java-experimental/'
 * 
!!! When you file a bug report, please include the following information:
GENTOO_VM=sun-jdk-1.5  CLASSPATH="" JAVA_HOME="/opt/sun-jdk-1.5.0.12"
JAVACFLAGS="-source 1.5 -target 1.5" COMPILER="javac"
Comment 9 fordfrog 2007-08-28 10:13:09 UTC
I grepped the whole source tree and found the path in these files:

./netbeans/netbeans-src/nbbuild/nbproject/private/scan-cache-full.ser
./netbeans/netbeans-src/nbbuild/nbproject/private/scan-cache-standard.ser
Comment 10 Jesse Glick 2007-08-28 16:08:58 UTC
Those are not versioned files, just your local cache.
Comment 11 fordfrog 2007-08-28 16:33:59 UTC
Yeah, but what surprises me is the fact that the 'clean' target creates these files and does not remove them. I run the
'clean' task to clean the source tree so it does not contain any pregenerated stuff :-)

Anyway removing the ser files makes apidocs compile in my case so I think this bug can be closed.
Comment 12 Jesse Glick 2007-08-28 17:49:49 UTC
'clean' just removes typical build products. 'real-clean' and 'cvs-clean' remove more. The cache files should be
automatically regenerated anyway whenever any relevant metadata changes.