Javadoc erstellen aus Klassen verteilt in Unterordnern

[Alex77]

Mit Javadoc kann ich mehrere Klassen dokumentieren. Z.B.:

javaodc -sourcepath\src\*

Aber wie mache ich es, wenn im Ordner 'src' erst einmal nur weitere Unterordner sind. Also in 'src' keine '.java' enthalten ist, sondern nur in den vielen Unterordnern die .java sind?

Also laut
http://java.sun.com/j2se/1.5.0/docs/tooldocs/windows/javadoc.html#sourcepath
geht es nur, wenn ich wirklich alle einzelnen Unterordner manuell angebe. Aber da tipp ich mich kaputt.

Geht das nicht auch anders?

 

[Beni]

Ja: man nimmt eine IDE wie z.B. Eclipse oder Netbeans und klickt dort auf einen Knopf der dann alles automatisch erledigt :wink:

Bei grösseren Projekten lohnt sich auch ANT, das kann gleich noch andere nette Dinge tun wie Code kompilieren, JARs generieren...

 

[Illuvatar]

Die Option -subpackages wird dir vermutlich weiterhelfen. Also, wenn du z.B. in src zwei Ordner "de" und "com" hast und dadrin noch viele weitere Ordner, dann geht das einfach mit "-subpackages de -subpackages com".

(Bin grad nicht ganz sicher, vielleicht kann oder sogar muss man das auch zusammenfassen, d.h. "-subpackages de com")

 

[maki]

Bei größeren Projekten nimmt man Maven 2 und bekommt noch eine nette Projekt Seite

 

[Alex77]

Vielen Dank für Eure Antworten.
Jedoch scheint mir noch nicht ganz geholfen zu sein. Habe wohl auch eine unzureichende Frage gestellt.

Ich will Folgendes:
In der JMF Api sollen noch allerlei Hilfen zu finden sein, die in der Standard-API-Dok nicht zu finden sind. Daher rät das Buch von Eidenberger dazu Javadoc über die JMF-Source laufen zu lassen.

Diese kann ich in Netbeans einbinden als Library einbinden (die Source als ZIP Datei oder als JAR). Allerdings kann ich dann hierfür mit Netbeans scheinbar kein javadoc erstellen lassen. Als Projekt kann ich es scheinbar auch nicht einbinden... . Kann nur selbst schon vorhandenes Javadoc einbinden und dann per Kontextmenü "show javadoc" anzeigen lassen. Aber ich will es ja selbst erstellen.

Aber auch die J2SE Api enthält wohl noch unveröffentlichtes. Z.B. "ReflectionUtils" -> mit 's' am Ende. Wird von EventHandler benutzt, um aus übergebenen Strings Membervariablen abzufragen und daraus eine Getter-Methode zu formen... . Na ja, egal.

Wie kann ich also die Source-Pakete von J2SE und JMF selber per Javadoc durchlaufen lassen?

Habe es mit

javadoc -subpackages jmf\src

probiert. Damit läuft er jetzt tatsächlich alle Verzeichnisse durch und zeigt jedoch 41 Fehler an und erstellt daher nichts.