Javadoc

Vielleicht sind die Kommentare fehlerhaft? Wie schauen sie denn aus?

Mich würds zum Beispiel interessieren.
Also wie hast es jetzt hinbekommen?

thx
fabb

import java.util.*;
/**
*    some javadoc info for the class
* @author killingspree
* @version 0.01
*/
public class Test {


    /**
    * some javadoc info for the method
    */
    public static void main(String args[]) {
        // some none javadoc comment
    }


    /*
    *     also not javadoc
    */
}

danch
javadoc Test.java
ausführen

voilá

anmerkung: der @author Tag wird per default nicht ins javadoc übernommen.

http://java.sun.com/j2se/javadoc/w…ents/index.html

google bemühen, lesen (auch wenns englisch ist). zugegebenerweise, die beispiele sind teilweise beschissen, aber man kanns damit auf jeden fall lernen...

mfg,
flo

Auch im Buch von Schiedermeier ist es gut erklärt (es gibt sogar eine eigenes Kapitel dazu)

ja, aber leider ist es beim schiedermeier unvollständig und nur mit ungenügenden bespielen. deshalb die sun-gschichte anschauen

Hab auch eine weile gesucht, bin dann draufgekommen nicht die Art der Kommentrare im Programm selbst war der Fehler sondern, der javadoc-Aufruf selbst, so ist bei mir dann das rausgekommen was ich wollte:

Zitat

javadoc -private -author -version AsciiReader.java

Zitat von Angabe 1. Runde

Schreiben Sie Ihr Programm möglichst allgemein und kommentieren Sie es gut. Die Kommentare im Programm gelten als Dokumentation. Die Dokumentation Ihrer Programme wird ebenfalls beurteilt. Es ist erlaubt/erwünscht die Kommentare javadoc-konform zu erstellen.

Bin gerade noch ein bisschen verwirrt.
Das javadoc-tool generiert einige Dateien im Hauptverzeichnis,
wo sich auch die Calculator.java (in meinem Fall) befindet.

Großteils *.html Dateien. Sollen wir javadoc ausführen und die
komplette Dokumentation mitabgeben, oder sollen wir nur die
Calculator.java (oder eben ascii) archivieren und abschicken,
so dass die Dokumentation dann von dem Prüfer erstellt werden kann?

Freundliche Grüße,
Aster