Note that there are some explanatory texts on larger screens.

plurals
  1. PO
    primarykey
    data
    text
    <p>The <code>/** */</code> comments are <a href="http://en.wikipedia.org/wiki/Javadoc" rel="nofollow">javadoc</a> comments, more details <a href="http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html" rel="nofollow">here</a>:</p> <blockquote> <p>Documentation comments (doc comments) </p> <p>The special comments in the Java source code that are delimited by the /** ... */ delimiters. These comments are processed by the Javadoc tool to generate the API docs.</p> </blockquote> <p>Their specific formatting lets some tools build the API documentation like <a href="http://docs.oracle.com/javase/7/docs/api/" rel="nofollow">the one you see of the standard package</a> but also, if you run it, of your own code. It lets you describe in a formal way the arguments, what is returned, etc.</p> <p>Not only is this documentation presented to you when you generate it (as HTML or in another format), it's also presented in IDE like Eclipse in multiple ways, for example when your mouse hovers some names. It's an important good practice to write in javadoc the important information needed by the users of your methods and class (and no more than what's useful).</p> <hr> <p>It's good to mention that <code>/* */</code> is useful not only for commenting-out multiple lines. Consider a situation when you want to comment-out something inside an <code>if</code> condition:</p> <pre><code>if(a==b &amp;&amp; c == d) </code></pre> <p>Then if you want to remove <code>a==b</code> and put it back later on, you can't use <code>//</code> because it'll comment-out the whole line after it, so you do:</p> <pre><code>if(/*a==b &amp;&amp;*/ c == d) </code></pre> <p>By the way, this has nothing to do with Eclipse, that's a Java feature.</p>
    singulars
    1. This table or related slice is empty.
    plurals
    1. This table or related slice is empty.
    1. This table or related slice is empty.
    1. This table or related slice is empty.
    1. This table or related slice is empty.
    1. VO
      singulars
      1. This table or related slice is empty.
    2. VO
      singulars
      1. This table or related slice is empty.
    3. VO
      singulars
      1. This table or related slice is empty.
    1. This table or related slice is empty.
 

Querying!

 
Guidance

SQuiL has stopped working due to an internal error.

If you are curious you may find further information in the browser console, which is accessible through the devtools (F12).

Reload