Dokumentation in der jre-Library finden

[beastofchaos]

Halo Leute,
Ich muss zu meinem Riesenprojekt(über 100 Klassen, über 25 000 Zeilen) endlich mal eine Dokumentation schreiben, bevor ich darüber ein BLL in meinem Abi schreiben kann.

Jetzt dachte ich mir, ich schaue mir ein paar "Dokumentations-Regel" von den Klassen aus der Library an, um ein paar nützliche Sachen abzukupfern 🙂

Wenn ich in Eclipse über eine Klasse wie z.B. Point mit der Maus fahre sehe ich auch in einem ToolTip die JavaDoc dazu, doch wenn ich "open Declaration" drücke, sehe ich den Code ohne Dokumentation. Ich meine früher schon mal die Dokumentation im richtigen Programm-Code gesehen zu haben. Was soll ich machen?

Eclipse-Version: "Helios Service Release 2"
Eingebundene Library: "JRE System Library [JavaSE-1.7]"

Unter "Properties - Java Build Path - Libraries - Add Library - Execution enviroment" kann ich zwischen folgenden wählen:

CDC-1.0/Foundation-1.0 (jre7)
CDC-1.1/Foundation-1.0 (jre7)
J2SE-1.2 (jre7)
J2SE-1.3 (jre7)
J2SE-1.4 (jre7)
J2SE-1.5 (jre7)
JavaSE-1.6 (jre7)
JavaSE-1.7 (jre7)
JRE-1.1 (jre7)
OSGi/Minimum-1.0 (jre7)
OSGi/Minimum-1.1 (jre7)
OSGi/Minimum-1.2 (jre7)


Ich hatte vor ein paar Minuten noch "jre6", aber da war das nicht anders.
Was soll ich tun?

Freu mich auf schnelle Hilfe,
Gruß, Thomas

 

[HelgeW]

Hi,

schaue Dir mal den Source von Java direkt an, dort findest Du jede Menge Doku und wie es geschrieben werden soll.
=> Java SE Downloads

 

[beastofchaos]

Hab jetzt mal "Java SE 7 Documentation" runtergeladen, aber damit hab ich einfach die Dokumentation lokal.
Bloß weiß ich immer noch nicht, wie ich die jdk-Version bekomme mit dem Java-Code zur Dokumentation.

 

[Xeonkryptos]

Die Dokumentation mit Code findest du im JDK-Ordner auf deinem PC! Im JDK-Ordner existiert ein zip-Archiv namens src. Dort ist alles, was du brauchst vorhanden.

 

[HelgeW]

Du solltest den Source runter laden, da dort drin die Dokumentation steckt...also noch mal auf Start 🙂

 

[HelgeW]

Die Dokumentation mit Code findest du im JDK-Ordner auf deinem PC!

Das ist natürlich auch eine schöne Stelle :toll:

 

[Clayn]

Aber auch nur wenn man die src-files mitinstalliert hat

 

[Xeonkryptos]

Aber auch nur wenn man die src-files mitinstalliert hat

Das sollte man natürlich gemacht haben.

 

[beastofchaos]

Wenn ich also in Eclipse "Add External JARs" auswähle und src.zip auswähle. Steht links im Package Explorer "Referenced Library" -> src.zip. Und darunter sind alle möglichen Java.Packaged, ABER ich kann die wiederum nicht öffnen bzw. die Ordner werden weiß (= leer) angezeigt.

Wie implementier ich jetzt diesen Ordner src richtig?? 🙂

 

[Firephoenix]

Warum nicht einfach das jdk installieren, in eclipse unter preferences->java->installed JREs->add->standard vm->installiertes jdk auswählen->haken bei jdk setzen fertig

wieder in die preferences->java->wieder zu installed JREs->unterpunkt execution environments, bei zum passenden JavaSE (ich nehme mal an das du das verwendest) bei compatible JREs das jdk auswählen, dann kannst du ganz normal von allen projekten die die JRE System Library benutzen direkt in den Java-source vom jdk springen, inklusive javadoc.
(ist auch beim entwickeln selbst mal ganz nett wenn man mal kurz nachschauen kann was unter der haube passiert).
Gruß