mirror of
https://github.com/eclipse-cdt/cdt
synced 2025-04-22 22:22:11 +02:00
76 lines
No EOL
3.1 KiB
HTML
76 lines
No EOL
3.1 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
|
|
<html lang="en">
|
|
|
|
<head>
|
|
<meta http-equiv="Content-Language" content="en-us">
|
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
|
<title>Comments</title>
|
|
<link rel="stylesheet" type="text/css" href="../help.css">
|
|
</head>
|
|
|
|
<body>
|
|
<div role="main">
|
|
<h1>Comments</h1>
|
|
<p>Comments are lines in a source file that have been marked to be ignored by the compiler.
|
|
Two styles of comments are supported by current C/C++ compilers:</p>
|
|
<ul>
|
|
<li><samp>/* C style comment (block comment) */</samp></li>
|
|
<li><samp>// C++ style comment (line comment)</samp></li>
|
|
</ul>
|
|
|
|
<h2>Line Comment</h2>
|
|
<p>You can quickly comment out one or more lines of code by inserting the leading
|
|
characters <samp>//</samp> at the beginning of the line. To do so, select the line
|
|
(or lines) of code you want to comment out and press <strong>CTRL+/</strong> (slash).</p>
|
|
|
|
<h2>Line Uncomment</h2>
|
|
<p>To uncomment select the line (or lines) of code, and press <strong>CTRL+/</strong>
|
|
(slash) again.
|
|
|
|
<p><strong>Tip:</strong> The characters <samp>/* */</samp> on lines that are
|
|
already commented out, are not affected when you comment and uncomment code using line comment.</p>
|
|
|
|
<h2>Block Comment</h2>
|
|
<p>You can comment out selected block of code with C style comment <samp>/* */</samp>. To do so, select
|
|
the block of code you want to comment out and press <strong>CTRL+Shift+/</strong> (slash).</p>
|
|
|
|
<h2>Block Uncomment</h2>
|
|
<p>To uncomment select the code inside commented out block, and press <strong>CTRL+SHIFT+\</strong> (backslash).
|
|
|
|
|
|
<h2>Multiline comment template</h2>
|
|
<p>You can use the Content Assist feature to insert a multi-line comment before a function.
|
|
In the C++ editor, type <span class="typewriter">com</span> then press <strong>Ctrl+Space</strong>.
|
|
Select <span class="typewriter">default multiline comment</span> template and press <strong>Enter</strong>.
|
|
The following code is entered at the cursor location:
|
|
<br><pre>
|
|
/*
|
|
* author userid
|
|
*
|
|
* To change this generated comment edit the template variable "comment":
|
|
* Window > Preferences > C/C++ > Editor > Templates.
|
|
*/
|
|
</pre>
|
|
|
|
To change the default comment click <strong>Window > Preferences > C/C++ > Code Style > Code Templates</strong>. For more information see the
|
|
<a href="cdt_c_content_assist.htm">Content Assist</a> section.
|
|
|
|
<p><img src="../images/ngconcepts.gif" ALT="Related concepts" width="143" height="21">
|
|
<br>
|
|
<a href="cdt_c_content_assist.htm">Content Assist and code completion</a></p>
|
|
<p><img src="../images/ngtasks.gif" ALT="Related tasks" width="143" height="21">
|
|
<br>
|
|
<a href="../tasks/cdt_t_cust_cpp_editor.htm">Customizing the C++ editor</a><br>
|
|
<a href="../tasks/cdt_t_comment_out.htm">Commenting out code</a></p>
|
|
<p><img src="../images/ngref.gif" ALT="Related reference" width="143" height="21">
|
|
<br>
|
|
<a href="../reference/cdt_o_ceditor_pref.htm">C/C++ editor preferences</a></p>
|
|
|
|
<p>
|
|
<img src="../images/rh03_04.gif" ALT="Red Hat Copyright Statement"><br>
|
|
<img src="../images/ng00_04a.gif" ALT=" IBM Copyright Statement" >
|
|
</p>
|
|
</div>
|
|
</body>
|
|
|
|
</html> |