Prima metodi Java abbiamo qualcosa di simile:Cosa sono chiamate docstring in java?
/**
* 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) {
...
}
Questo ha un nome (come docstring in Python)?
No, javadoc è lo strumento che li elabora. Sono chiamati commenti del doc. –
@seanizer è ovviamente il motivo per cui le pagine generate utilizzando lo strumento javadoc vengono in genere chiamate "javadoc" e persino perché Eclipse e altri IDE hanno viste specifiche chiamate "Javadoc" utilizzate per visualizzare solo quei "commenti doc". – Riduidel
hey, io chiamo JavaDocs me stesso, ma non è il nome ufficiale. E il documento ufficiale dietro il link * tu * fornito ha il titolo "Come scrivere commenti di un documento per lo strumento Javadoc", non "Come scrivere commenti Javadoc" –