JavaDoc per Batch?

[Matflasch]

Hi,

Javadoc kann man aus z.B. Eclipse ja wunderbar aufrufen. Jedoch wenn man eine riesen Klassenstruktur hat und alle gleichzeitig mit Javadoc erstellen will, dann gibt das ein riesen Problem. Ich habe extra schon 500mb zugewiesen, da bei 200 und 300mb jeweils ein OutOfMemory kam. Jedoch dauert es nun auch schon locker 30 Minuten.
Das ist aus Eclipse schon ein wenig blöd, da würde ich lieber ne Batch Datei laufen lassen.

Mein Problem ist aber folgendens:
Die Paketstruktur ist so tief...
de
de.name
de.name.standards
de.name.standards.beans
de.name.standards.model

... dass ich nicht weiss, wie ich das mit JavaDoc auf einmal machen soll. Die Unterordnet werden ja nicht mit einbezogen, oder ich habe etwas grundsätzlich falsch gemacht... :/

Wie könnte man die Docs leicht aus ner Batch Datei erstellen? (Bin nicht so der Batch Profi....)

Und generell habe ich noch eine Frage dazu: Würde bei einem Aufruf aus einer Batch Datei auch die OutOfMemoy Exception kommen? Oder liegt das daran, dass ich es aus Eclipse starte(denke ich)?

Mfg, Matflasch

 

[foobar]

http://ant.apache.org/

 

[Bleiglanz]

eclipse fragt doch eh, ob du ein ant-skript erstellen willst

 

[Matflasch]

Ant?

Was muss ich denn genau machen?

- Rechtsklick auf mein Java-Projekt -> Export -> Javadoc
- Java-Projekt auswählen, Zielpfad setzen, weiter
- Basic Options etc..., weiter
- VM Options: -J-Xmx768m, 'Save the settings of this javadoc export as an ant script:', pfad setzen, finisch...

Ok, dann habe ich das Ant-Script und er startet Javadoc (was ewig dauert).

'ant -buildfile build.xml' funktioniert nicht so wirklich

Wollte das eigentlich rekursiv mit javadoc in einem Batch script machen, weil sonst viel zu viel speicher gebraucht wird und das System dann lange Zeit nicht zu gebrauchen ist...

Aber das mit Ant... ist das effektiver als es aus Eclipse raus zu starten?

Mfg, Matflasch

 

[Illuvatar]

mach einfach

javadoc -subpackages de

, das tut, mach ich auch öfters so

 

[Matflasch]

javadoc -subpackages de
javadoc: invalid flag: -subpackages

Das ganze ist unter Windows, falls das nen Unterschied macht?

Man is das schwer ne Doku zu erstellen

 

[Illuvatar]

Höh? Welche Javaversion? Ich hab 5.0.

usage: javadoc [options] [packagenames] [sourcefiles] [@files]
-overview <file> Read overview documentation from HTML file
-public Show only public classes and members
-protected Show protected/public classes and members (default)
-package Show package/protected/public classes and members
-private Show all classes and members
-help Display command line options and exit
-doclet <class> Generate output via alternate doclet
-docletpath <path> Specify where to find doclet class files
-sourcepath <pathlist> Specify where to find source files
-classpath <pathlist> Specify where to find user class files
-exclude <pkglist> Specify a list of packages to exclude
-subpackages <subpkglist> Specify subpackages to recursively load
-breakiterator Compute 1st sentence with BreakIterator
-bootclasspath <pathlist> Override location of class files loaded
by the bootstrap class loader
...

 

[Matflasch]

Hab auch grad im Inet gefunden, dass es dabei sein sollte.

Ich habe in Eclipse die Java-Version: 1.4.2_05-b04
Allerdings war dort JavaDoc nicht dabei. Auf dem Rechner hier war aber noch Websphere 5.1 drauf, mit kA was für ner Java-Version, da war JavaDoc dabei, das hatte ich dann mal genommen.
In Eclipse habe ich das auch angegeben und nen paar Packages (also net so viele...) macht er einwandfrei, daher muss es ja gehen...
Nur wird das wohl noch net unterstützt...

Java 1.5 / 5 kann ich aus technischen Gründen nicht installieren. Dann muss ich mir wohl was anderes einfallen lassen....
Also doch das Batch Script

Edit:
JavaDoc ist bei Websphere 5.1, Java Version:J2RE 1.3.1 IBM J9 build 20030702 (JIT enabled) dabei, welches ich nutze.