Building GroovyDoc Runs Out of Heap Space

Or just set ANT_OPTS=-Xmx512m as per the release docs.

That is definitely a "hideous hack". Yuk

I guess we just have to replace the groovydoc tag with a java tag so as to get a new VM with more memory.

Should be fixed - a little hard to tell with the build broken at the moment but runs fine locally for me. Assigning to 1.6-beta-1 for now as I guess that will be the first 1.6 release. Needs to be merged to 1.5.2 as well.

The fix works for me so closing this.

However, the fix is in trunk and definitely needs back-merging to the 1_5_X branch.

I still have this problem. My sources are Groovy + Java mixed and have about 800 KB. Exception ocours even If I set ANT_OPTS=-Xms1000M. I can provide sources and build script on request to replicate problem.

Stack trace:

BUILD FAILED
java.lang.OutOfMemoryError: Java heap space
at groovyjarjarantlr.ANTLRStringBuffer.append(ANTLRStringBuffer.java:36)
at groovyjarjarantlr.CharScanner.append(CharScanner.java:64)
at groovyjarjarantlr.CharScanner.consume(CharScanner.java:82)
at groovyjarjarantlr.CharScanner.match(CharScanner.java:205)
at org.codehaus.groovy.antlr.java.JavaLexer.mSL_COMMENT(JavaLexer.java:1142)
at org.codehaus.groovy.antlr.java.JavaLexer.nextToken(JavaLexer.java:401)
at org.codehaus.groovy.antlr.java.JavaLexer$1.nextToken(JavaLexer.java:98)
at groovyjarjarantlr.TokenBuffer.fill(TokenBuffer.java:69)
at groovyjarjarantlr.TokenBuffer.LA(TokenBuffer.java:80)
at groovyjarjarantlr.LLkParser.LA(LLkParser.java:52)
at org.codehaus.groovy.antlr.java.JavaRecognizer.compilationUnit(JavaRecognizer.java:304)
at org.codehaus.groovy.tools.groovydoc.GroovyRootDocBuilder.parseJava(GroovyRootDocBuilder.java:89)
at org.codehaus.groovy.tools.groovydoc.GroovyRootDocBuilder.getClassDocsFromSingleSource(GroovyRootDocBuilder.java:74)
at org.codehaus.groovy.tools.groovydoc.GroovyRootDocBuilder.processFile(GroovyRootDocBuilder.java:188)
at org.codehaus.groovy.tools.groovydoc.GroovyRootDocBuilder.buildTree(GroovyRootDocBuilder.java:156)
at org.codehaus.groovy.tools.groovydoc.GroovyDocTool.add(GroovyDocTool.java:63)
at org.codehaus.groovy.ant.Groovydoc.execute(Groovydoc.java:369)
at org.apache.tools.ant.UnknownElement.execute(UnknownElement.java:288)
at sun.reflect.GeneratedMethodAccessor3.invoke(Unknown Source)
at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
at java.lang.reflect.Method.invoke(Method.java:597)
at org.apache.tools.ant.dispatch.DispatchUtils.execute(DispatchUtils.java:106)
at org.apache.tools.ant.Task.perform(Task.java:348)
at org.apache.tools.ant.Target.execute(Target.java:357)
at org.apache.tools.ant.Target.performTasks(Target.java:385)
at org.apache.tools.ant.Project.executeSortedTargets(Project.java:1337)
at org.apache.tools.ant.Project.executeTarget(Project.java:1306)
at org.apache.tools.ant.helper.DefaultExecutor.executeTargets(DefaultExecutor.java:41)
at org.apache.tools.ant.Project.executeTargets(Project.java:1189)
at org.apache.tools.ant.Main.runBuild(Main.java:758)
at org.apache.tools.ant.Main.startAnt(Main.java:217)
at org.apache.tools.ant.launch.Launcher.run(Launcher.java:257)

I am using Groovy 1.6.0

Are you setting -Xmx too or just -Xms? I am not sure what happens if you only set one of these - one would hope it adjusts both but I haven't checked the doco. It might be useful to append/paste/attach your groovydoc task from ant too.

I still have this ussue. Now you can replicate this problem. Checkout my project from SVN:
svn checkout http://opencoeli.googlecode.com/svn/trunk/ opencoeli-read-only

and run ant:
ant doc

This is stack trace:

Microsoft Windows XP [Version 5.1.2600]
(C) Copyright 1985-2001 Microsoft Corp.

Buildfile: build.xml

doc:
[Groovydoc] Loading source files for [org\opencoeli\catalog\BufferedIterator.java, org\opencoeli\catalog\Catalog.groovy,
org\opencoeli\catalog\CatalogByArea.groovy, org\opencoeli\catalog\CatalogById.groovy, org\opencoeli\catalog\CatalogImpo
rt.groovy, org\opencoeli\catalog\CatalogUtil.groovy, org\opencoeli\catalog\EmptyCatalog.groovy, org\opencoeli\catalog\Em
ptyIterator.groovy, org\opencoeli\catalog\ListCatalog.groovy, org\opencoeli\catalog\ProgressIterator.groovy, org\opencoe
li\catalog\QueryByArea.groovy, org\opencoeli\catalog\TranslatingIterator.groovy, org\opencoeli\catalog\importer\ConstelB
oundaryImport.groovy, org\opencoeli\catalog\importer\ConstelImport.groovy, org\opencoeli\catalog\importer\ConstelLineImp
ort.groovy, org\opencoeli\catalog\importer\FixedWidthParser.java, org\opencoeli\catalog\importer\HDtoTycho2CrossId.groov
y, org\opencoeli\catalog\importer\HygStarCatalogImport.groovy, org\opencoeli\catalog\importer\HyperledaImport.groovy, or
g\opencoeli\catalog\importer\MilkyWayImport.groovy, org\opencoeli\catalog\importer\NgcIcCatalogImport.groovy, org\openco
eli\catalog\importer\Sky2000Import.groovy, org\opencoeli\catalog\importer\Tycho2Import.groovy, org\opencoeli\catalog\imp
orter\Tycho2ImportUtil.java, org\opencoeli\catalog\importer\Ucac1Import.java, org\opencoeli\catalog\importer\URLSet.groo
vy, org\opencoeli\catalog\importer\UsnoA2Import.java, org\opencoeli\context\Adaptee.java, org\opencoeli\context\Adapter.
java, org\opencoeli\context\AdapterManager.java, org\opencoeli\context\BeanNameResolver.groovy, org\opencoeli\context\Co
eliBootstrap.groovy, org\opencoeli\context\ContextFactory.groovy, org\opencoeli\context\Description.groovy, org\opencoel
i\context\Fork.java, org\opencoeli\context\GroovyMetadataReaderFactory.java, org\opencoeli\context\PluginTestBean.groovy
, org\opencoeli\context\Progress.groovy, org\opencoeli\context\Saveable.groovy, org\opencoeli\context\SettingsStore.groo
vy, org\opencoeli\data\Asterism.groovy, org\opencoeli\data\CoeliArea.groovy, org\opencoeli\data\CoeliAreaIpix.groovy, or
g\opencoeli\data\CoeliAreaIpixKey.groovy, org\opencoeli\data\CoeliLine.groovy, org\opencoeli\data\CoeliObject.groovy, or
g\opencoeli\data\CoeliObjectId.groovy, org\opencoeli\data\CoeliReference.groovy, org\opencoeli\data\Constel.groovy, org\
opencoeli\data\ConstelBoundary.groovy, org\opencoeli\data\ConstelLine.groovy, org\opencoeli\data\DarkNebula.groovy, org\
opencoeli\data\EmissionNebula.groovy, org\opencoeli\data\FlatObject.groovy, org\opencoeli\data\Galaxy.groovy, org\openco
eli\data\GalaxyPart.groovy, org\opencoeli\data\GlobularCluster.groovy, org\opencoeli\data\MagnitudeSystem.java, org\open
coeli\data\MilkyWayPixel.groovy, org\opencoeli\data\Nebula.groovy, org\opencoeli\data\OpenCluster.groovy, org\opencoeli\
data\PlanetaryNebula.groovy, org\opencoeli\data\RaDePoint.java, org\opencoeli\data\ReflectionNebula.groovy, org\opencoel
i\data\Star.groovy, org\opencoeli\data\StarMagnitude.groovy, org\opencoeli\data\StorageCatalogRecord.groovy, org\opencoe
li\data\SupernovaRemnant.groovy, org\opencoeli\data\Vector2d.java, org\opencoeli\data\Vector3d.java, org\opencoeli\gui\C
oeliApp.groovy, org\opencoeli\gui\Form.groovy, org\opencoeli\gui\GuiPaintListener.groovy, org\opencoeli\gui\JpqlConsole.
groovy, org\opencoeli\gui\JpqlConsoleFrame.groovy, org\opencoeli\gui\MapGuiHelper.groovy, org\opencoeli\gui\MapNavigatio
nFrame.groovy, org\opencoeli\gui\ObjectSelectedListener.groovy, org\opencoeli\gui\ObjectSelectionPainter.groovy, org\ope
ncoeli\gui\XmlDetailFrame.groovy, org\opencoeli\gui\beans\CoeliStatusBar.groovy, org\opencoeli\gui\beans\DataMenu.groovy
, org\opencoeli\gui\beans\FileMenu.groovy, org\opencoeli\gui\beans\MainFrame.groovy, org\opencoeli\gui\beans\MainMenuBar
.groovy, org\opencoeli\gui\beans\MapMenu.groovy, org\opencoeli\gui\beans\WindowMenu.groovy, org\opencoeli\gui\frames\det
ail\CoeliObjectDetail.groovy, org\opencoeli\gui\frames\detail\DefaultProperty.java, org\opencoeli\gui\frames\detail\Deta
ilFrame.groovy, org\opencoeli\gui\frames\detail\DetailFrameContributor.groovy, org\opencoeli\gui\frames\detail\MapDetail
Frame.groovy, org\opencoeli\gui\frames\detail\StarDetail.groovy, org\opencoeli\gui\map\SkyviewDialog.groovy, org\opencoe
li\gui\map\SkyviewGuiHook.groovy, org\opencoeli\gui\map\SkyviewLutsCellRenderer.groovy, org\opencoeli\gui\popup\CenterMa
pOnObject.groovy, org\opencoeli\gui\popup\PopupMenuContributed.groovy, org\opencoeli\gui\popup\PopupMenuContributor.groo
vy, org\opencoeli\gui\settings\DataHelperSettingsPage.groovy, org\opencoeli\gui\settings\GeneralSettingsPage.groovy, org
\opencoeli\gui\settings\MultiFormDialog.groovy, org\opencoeli\gui\settings\SettingsDialog.groovy, org\opencoeli\gui\sett
ings\SettingsPage.groovy, org\opencoeli\gui\settings\URLSetSettings.groovy, org\opencoeli\gui\util\CoeliCellRenderer.gro
ovy, org\opencoeli\gui\util\CoeliDialog.groovy, org\opencoeli\gui\util\CoeliTableModel.groovy, org\opencoeli\gui\util\Fo
xtrot.groovy, org\opencoeli\gui\util\GroovyAction.groovy, org\opencoeli\gui\util\IntegerTextField.java, org\opencoeli\gu
i\util\SplashWindow.java, org\opencoeli\gui\util\SU.java, org\opencoeli\index\BitManipulation.java, org\opencoeli\index\
HealpixException.java, org\opencoeli\index\HealpixUtil.java, org\opencoeli\index\PixTools.java, org\opencoeli\index\Regi
on.java, org\opencoeli\index\longset\AbstractLongCollection.java, org\opencoeli\index\longset\AbstractLongList.java, org
\opencoeli\index\longset\AbstractLongSet.java, org\opencoeli\index\longset\DefaultLongHashFunction.java, org\opencoeli\i
ndex\longset\Exceptions.java, org\opencoeli\index\longset\LongArrayDeque.java, org\opencoeli\index\longset\LongArrayList
.java, org\opencoeli\index\longset\LongArrayStack.java, org\opencoeli\index\longset\LongChainedHashSet.java, org\opencoe
li\index\longset\LongCollection.java, org\opencoeli\index\longset\LongComparator.java, org\opencoeli\index\longset\LongD
eque.java, org\opencoeli\index\longset\LongHashFunction.java, org\opencoeli\index\longset\LongIterator.java, org\opencoe
li\index\longset\LongList.java, org\opencoeli\index\longset\LongListIterator.java, org\opencoeli\index\longset\LongOpenH
ashSet.java, org\opencoeli\index\longset\LongRange.java, org\opencoeli\index\longset\LongRangeSet.java, org\opencoeli\in
dex\longset\LongSet.java, org\opencoeli\index\longset\LongSortedSet.java, org\opencoeli\index\longset\LongStack.java, or
g\opencoeli\index\longset\Primes.java, org\opencoeli\index\longset\UnmodifiableLongCollection.java, org\opencoeli\index\
longset\UnmodifiableLongList.java, org\opencoeli\index\longset\UnmodifiableLongSet.java, org\opencoeli\map\AssertingCanv
as.groovy, org\opencoeli\map\CoeliLayer.java, org\opencoeli\map\CoeliPainter.java, org\opencoeli\map\ColorResolver.groov
y, org\opencoeli\map\CoordinateGridPainter.groovy, org\opencoeli\map\DarkBlueColorResolver.groovy, org\opencoeli\map\Dat
aHelper.groovy, org\opencoeli\map\LabelUtil.java, org\opencoeli\map\MapControl.groovy, org\opencoeli\map\MapFeature.groo
vy, org\opencoeli\map\MapRefreshListener.groovy, org\opencoeli\map\PainterResolver.groovy, org\opencoeli\map\PaintListen
er.groovy, org\opencoeli\map\PaintMixin.groovy, org\opencoeli\map\ProjectionMixin.groovy, org\opencoeli\map\WCSBuilder.g
roovy, org\opencoeli\map\painter\AsterismPainter.groovy, org\opencoeli\map\painter\ConstelBoundaryPainter.groovy, org\op
encoeli\map\painter\ConstelLinePainter.groovy, org\opencoeli\map\painter\ConstelPainter.groovy, org\opencoeli\map\painte
r\CoordinatePainter.groovy, org\opencoeli\map\painter\DefaultPainterResolver.groovy, org\opencoeli\map\painter\EmissionN
ebulaPainter.groovy, org\opencoeli\map\painter\GalaxyPainter.groovy, org\opencoeli\map\painter\GlobularClusterPainter.gr
oovy, org\opencoeli\map\painter\MilkyWayPainter.groovy, org\opencoeli\map\painter\OpenClusterPainter.groovy, org\opencoe
li\map\painter\PainterUtil.groovy, org\opencoeli\map\painter\PlanetaryNebulaPainter.groovy, org\opencoeli\map\painter\Re
flectionNebulaPainter.groovy, org\opencoeli\map\painter\StarPainter.groovy, org\opencoeli\map\painter\SupernovaRemaintPa
inter.groovy, org\opencoeli\map\painter\UnknownPainter.groovy, org\opencoeli\map\skyview\CoeliSkyviewImager.java, org\op
encoeli\map\skyview\SkyviewMemento.groovy, org\opencoeli\map\skyview\SkyviewPainter.groovy, org\opencoeli\map\skyview\Sk
yviewUtil.groovy, org\opencoeli\storage\AbstractDb4oCatalog.groovy, org\opencoeli\storage\Db4oManager.groovy, org\openco
eli\storage\Db4oStorage.groovy, org\opencoeli\storage\EntityManagerFab.groovy, org\opencoeli\storage\IdMerger.groovy, or
g\opencoeli\storage\ImportLevel1.groovy, org\opencoeli\storage\JpaStorage.groovy, org\opencoeli\storage\MemoryStorage.gr
oovy, org\opencoeli\storage\Storage.groovy, org\opencoeli\storage\StorageAreaCatalog.groovy, org\opencoeli\storage\Stora
geCatalogById.groovy, org\opencoeli\storage\StorageCatalogManager.groovy, org\opencoeli\storage\StorageMilkyWayCatalog.g
roovy, org\opencoeli\storage\StorageObjectCatalog.groovy, org\opencoeli\storage\StorageStarCatalog.groovy, org\opencoeli
\util\Arc.java, org\opencoeli\util\CircumArea.java, org\opencoeli\util\CoeliUtil.groovy, org\opencoeli\util\ColorUtil.ja
va, org\opencoeli\util\Decoder.java, org\opencoeli\util\Format.java, org\opencoeli\util\Geometry.java, org\opencoeli\uti
l\GreekLetters.groovy, org\opencoeli\util\Join.java, org\opencoeli\util\MagUtil.groovy, org\opencoeli\util\Minimax.java,
org\opencoeli\util\StreamSkipTimer.java]

BUILD FAILED
java.lang.OutOfMemoryError: Java heap space
at groovyjarjarantlr.ANTLRStringBuffer.append(ANTLRStringBuffer.java:36)
at groovyjarjarantlr.CharScanner.append(CharScanner.java:64)
at groovyjarjarantlr.CharScanner.consume(CharScanner.java:82)
at groovyjarjarantlr.CharScanner.match(CharScanner.java:205)
at org.codehaus.groovy.antlr.java.JavaLexer.mSL_COMMENT(JavaLexer.java:1142)
at org.codehaus.groovy.antlr.java.JavaLexer.nextToken(JavaLexer.java:401)
at org.codehaus.groovy.antlr.java.JavaLexer$1.nextToken(JavaLexer.java:98)
at groovyjarjarantlr.TokenBuffer.fill(TokenBuffer.java:69)
at groovyjarjarantlr.TokenBuffer.LA(TokenBuffer.java:80)
at groovyjarjarantlr.LLkParser.LA(LLkParser.java:52)
at org.codehaus.groovy.antlr.java.JavaRecognizer.compilationUnit(JavaRecognizer.java:304)
at org.codehaus.groovy.tools.groovydoc.GroovyRootDocBuilder.parseJava(GroovyRootDocBuilder.java:89)
at org.codehaus.groovy.tools.groovydoc.GroovyRootDocBuilder.getClassDocsFromSingleSource(GroovyRootDocBuilder.ja
va:74)
at org.codehaus.groovy.tools.groovydoc.GroovyRootDocBuilder.processFile(GroovyRootDocBuilder.java:188)
at org.codehaus.groovy.tools.groovydoc.GroovyRootDocBuilder.buildTree(GroovyRootDocBuilder.java:156)
at org.codehaus.groovy.tools.groovydoc.GroovyDocTool.add(GroovyDocTool.java:63)
at org.codehaus.groovy.ant.Groovydoc.execute(Groovydoc.java:369)
at org.apache.tools.ant.UnknownElement.execute(UnknownElement.java:288)
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)
at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
at java.lang.reflect.Method.invoke(Method.java:597)
at org.apache.tools.ant.dispatch.DispatchUtils.execute(DispatchUtils.java:106)
at org.apache.tools.ant.Task.perform(Task.java:348)
at org.apache.tools.ant.Target.execute(Target.java:357)
at org.apache.tools.ant.Target.performTasks(Target.java:385)
at org.apache.tools.ant.Project.executeSortedTargets(Project.java:1337)
at org.apache.tools.ant.Project.executeTarget(Project.java:1306)
at org.apache.tools.ant.helper.DefaultExecutor.executeTargets(DefaultExecutor.java:41)
at org.apache.tools.ant.Project.executeTargets(Project.java:1189)
at org.apache.tools.ant.Main.runBuild(Main.java:758)
at org.apache.tools.ant.Main.startAnt(Main.java:217)

Total time: 9 seconds

@Jan, there is a source file org.opencoeli.util.GeometrySystem.java which has all of its lines commented out. If you remove the comments or delete the file, the OOM goes away.

It would be great if you could submit a separate Jira with just that file (pasted in or as an attachment) so we can track down why this edge case is causing problems. If you don't have time, I will attempt to do it in a few days.