C99 allows //-style comments, C89 does not. So, to translate: C99: printf(“C%d\n”,(int)(90-(-4.5 /*Some comment stuff*/ -4.5))); // Outputs: 99 C89: printf(“C%d\n”,(int)(90-(-4.5/ -4.5))); /* so we get 90-1 or 89 */
There is no new standard for comments in HTML5. The only valid comment syntax is still <!– –>. From section 8.1.6 of W3C HTML5: Comments must start with the four character sequence U+003C LESS-THAN SIGN, U+0021 EXCLAMATION MARK, U+002D HYPHEN-MINUS, U+002D HYPHEN-MINUS (<!–). The <! syntax originates in SGML DTD markup, which is not part … Read more
POD is the official way to do multi line comments in Perl, see Multi-line comments in perl code and Better ways to make multi-line comments in Perl for more detail. From faq.perl.org[perlfaq7] How can I comment out a large block of Perl code? The quick-and-dirty way to comment out more than one line of Perl … Read more
Absolutely pointless – you’re better off without this kind of crap cluttering your code: /** * Sets the foo. * * @param foo the foo to set */ public void setFoo(float foo); Very useful, if warranted: /** * Foo is the adjustment factor used in the Bar-calculation. It has a default * value depending on … Read more
Pure JSP comments look like this: <%– Comment –%> So if you want to retain the “=“.you could do something like: <%–= map.size() –%> The key thing is that <%= defines the beginning of an expression, in which you can’t leave the body empty, but you could do something like this instead if the pure … Read more
As a general rule, I use the same DRY (Don’t Repeat Yourself) principle as with code: on interface, document the interface on implementation, document the implementation specifics Java specific: when documenting the implementation, use {@inheritDoc} tag to “include” javadocs from the interface. For more information: Official javadoc documentation Some unofficial advice.
Use a single # sign # like this One character seems pretty minimal 😉 Also: ### This block comment (useful for ©-Copyright info) also gets passed on to the browsers HTML /* like this! */ ###
Use a trick: concatenate the string from two pieces. This way, the closing tag is cut in two, and is not a valid closing tag anymore. ‘?>’ –> ‘?’.’>’ In your code: $string = preg_replace(‘#<br\s*/?’.’>(?:\s*<br\s*/?’.’>)+#i’, ‘<br />’, $string); This will make // comments work. For /* */ comments to work, you’d have to split the … Read more
Functions: /** * Does something interesting * * @param Place $where Where something interesting takes place * @param integer $repeat How many times something interesting should happen * * @throws Some_Exception_Class If something interesting cannot happen * @author Monkey Coder <mcoder@facebook.com> * @return Status */ Classes: /** * Short description for class * * Long … Read more
Several ways: # Comment — Comment /* Comment */ Remember to put the space after –. See the documentation.