I just found this comment declaration in some xcode sample project:
/*!
@property masterVolume
@abstract Sets the master volume
*/
@property float masterVolume;
The comment is green as usual, the @property and @ abstract are dark green. If I remove the exclamation mark, they have the same green. What the heck does that mean?
C++ comments start with /* and end with */. For example − /* This is a comment */ /* C++ comments can also * span multiple lines */ A comment can also start with //, extending to the end of the line. For example − #include <iostream> using namespace std; main() { cout << "Hello World"; // prints Hello World return 0; }
The only purpose it serves in HTML is to introduce comments.
You can comment out one or more lines of code in any C/C++ editor view. The leading characters // are added to the beginning of each line when commenting one or more lines of code. You can also block comment multiple lines of code using the characters /* */ .
This element is used to add a comment to an HTML document. An HTML comment begins with <! –– and the comment closes with ––> . HTML comments are visible to anyone that views the page source code, but are not rendered when the HTML document is rendered by a browser.
To make transition from headerdoc a bit simpler, appledoc (tool to generate documentation from code so you save time in documentation) also accepts headerdoc style multiline comments:
/*! Comment */
Source
If you love us? You can donate to us via Paypal or buy me a coffee so we can maintain and grow! Thank you!
Donate Us With