aboutsummaryrefslogtreecommitdiffstats
path: root/docs/source/lang/comments.rst
diff options
context:
space:
mode:
authorMarti Bolivar <mbolivar@mit.edu>2010-12-03 20:18:00 -0500
committerMarti Bolivar <mbolivar@mit.edu>2010-12-03 20:18:00 -0500
commit5ceac644e90c929e77f05d357d1d35d45e673fac (patch)
tree18c76f6117942fa46391fbbd8bd24e2c759c4895 /docs/source/lang/comments.rst
parente5b1e44a8ae8c593456f4b4734f05c9065f6f07b (diff)
downloadlibrambutan-5ceac644e90c929e77f05d357d1d35d45e673fac.tar.gz
librambutan-5ceac644e90c929e77f05d357d1d35d45e673fac.zip
cleaning up previous commits.
note that addition of new files under docs/source/lang/api and docs/source/lang/cpp which were just copies of files in docs/source/lang/ imply that change history is lost to git.
Diffstat (limited to 'docs/source/lang/comments.rst')
-rw-r--r--docs/source/lang/comments.rst67
1 files changed, 0 insertions, 67 deletions
diff --git a/docs/source/lang/comments.rst b/docs/source/lang/comments.rst
deleted file mode 100644
index c5f118a..0000000
--- a/docs/source/lang/comments.rst
+++ /dev/null
@@ -1,67 +0,0 @@
-.. highlight:: cpp
-
-.. _lang-comments:
-
-Comments
-========
-
-Comments are lines in the program that are used to inform yourself or
-others about the way the program works. They are ignored by the
-compiler, and not exported to the processor, so they don't take up any
-space in RAM or Flash.
-
-One use for comments is to help you understand (or remember) how your
-program works, or to inform others how your program works. There are
-two different ways of making comments.
-
-.. _lang-comments-singleline:
-
-**Single line comment**: Anything following two slashes, ``//``, until
-the end of the line, is a comment::
-
- x = 5; // the rest of this line is a comment
-
-.. _lang-comments-multiline:
-
-**Multi-line comment**: Anything in between a pair of ``/*`` and ``*/``
-is a comment::
-
- /* <-- a slash-star begins a multi-line comment
-
- all of this in the multi-line comment - you can use it to comment
- out whole blocks of code
-
- if (gwb == 0){ // single line comment is OK inside a multi-line comment
- x = 3;
- }
-
- // don't forget the "closing" star-slash - they have to be balanced:
- */
-
-Note that it's okay to use single-line comments within a multi-line
-comment, but you can't use multi-line comments within a multi-line
-comment. Here's an example::
-
- /* ok, i started a multi-line comment
-
- x = 3; /* this next star-slash ENDS the multi-line comment: */
-
- x = 4; // this line is outside of the multi-line comment
-
- // next line is also outside of the comment, and causes a compile error:
- */
-
-Programming Tip
----------------
-
-When experimenting with code, "commenting out" parts of your program
-is a convenient way to remove lines that may be buggy. This leaves
-the lines in the code, but turns them into comments, so the compiler
-just ignores them. This can be especially useful when trying to locate
-a problem, or when a program refuses to compile and the compiler error
-is cryptic or unhelpful.
-
-
-
-
-.. include:: cc-attribution.txt