Comments (Scripting): Difference between revisions
>MrNicNac Added leveled comments. |
>NXTBoy No hyphens there |
||
Line 22: | Line 22: | ||
This is an example | This is an example | ||
of a block comment. | of a block comment. | ||
]] | |||
</pre>}} | </pre>}} | ||
Line 32: | Line 32: | ||
--[=[ | --[=[ | ||
This is a level 1 comment. | This is a level 1 comment. | ||
]=] | |||
</pre> | </pre> | ||
Line 39: | Line 39: | ||
--[==[ | --[==[ | ||
This is a level 2 comment. | This is a level 2 comment. | ||
]==] | |||
</pre>}} | </pre>}} | ||
Revision as of 20:19, 2 January 2011
Comments
What are Comments?
Comments are exactly what they sound like, they're comments. They are there just for organizing code and such. Lua will not do anything with these comments.
Single-line Comments
A comment starts anywhere with a double hyphen (--) and runs until the end of the line:
-- This is an example of a comment
Comments do not appear in the output window. They are mostly to help the programmer understand what a section of code is for in long, complicated scripts.
Block Comments
Lua also offers block comments, which start with the first double brackets and run until the corresponding double brackets:
--[[ This is an example of a block comment. ]]
Leveled Comments
Leveled comments are comments that have different levels of toleration for lower-leveled comments, such as the above block comment.
--[=[ This is a level 1 comment. ]=]
Below is a level 2 comment, there is no limit to what level a comment is on. But a level 1 comment cannot hold a level 2 or higher, and so forth...
--[==[ This is a level 2 comment. ]==]
Notice how this comment is on more than one line. In the first example, it is limited to one line.