Before Java methods we have something like:
/**
* 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) {开发者_JS百科
...
}
Does this have a name (like docstrings in Python)?
Actually, they are called document comments and javadoc is a tool to generate those comments into HTML.
You can find the structure of the Javadoc comment in Wikipedia (for example).
Yup, it's called javadoc.
精彩评论