Bevor Java-Methoden haben wir so etwas wie:Wie werden Docstrings in Java aufgerufen?
/**
* Takes a number and returns its square root.
* @param x The value to square.
* @return The square root of the given number.
*/
public float getSqrt(float x) {
...
}
Enthält diese einen Namen (wie Docstrings in Python) haben?
Nein, Javadoc ist das Werkzeug, das sie verarbeitet. Sie werden als Doc-Kommentare bezeichnet. –
@seanizer, das ist offensichtlich, warum Seiten, die mit dem Javadoc-Tool erstellt wurden, normalerweise "Javadoc" genannt werden und warum Eclipse und andere IDEs spezielle Ansichten namens "Javadoc" haben, die nur diese "Doc-Kommentare" anzeigen. – Riduidel
hey, ich nenne sie selbst JavaDocs, aber das ist nicht der offizielle Name. Und das offizielle Dokument hinter dem Link * you * hat den Titel "Wie schreibe ich Doc Kommentare für das Javadoc Tool", nicht "Wie schreibe ich Javadoc Kommentare" –