how to create function description / definition in java [duplicate]

Question

Is there someone here can give me idea or informations on how to create a functions definition, same to what we got when we write the signature of a function and than we press ctrl + space, in other world, like this :

File file = new File    ( and when we pressed ctrl+space we got as showing in the picture bellow)

I googled a lot but i didn't found any solutions, thanks if someone here can help me.

Answer 1

Read about the Javadoc.

Look the File class source for an example:

/**
 * Creates a new <code>File</code> instance by converting the given
 * pathname string into an abstract pathname.  If the given string is
 * the empty string, then the result is the empty abstract pathname.
 *
 * @param   pathname  A pathname string
 * @throws  NullPointerException
 *          If the <code>pathname</code> argument is <code>null</code>
 */