/**/ | |
Type | keyword |
Dictionary | LCS |
Library | LiveCode Script |
Syntax |
|
Synonyms | /*,*/ |
Summary | |
Introduced | 2.0 |
OS | mac, windows, linux, ios, android |
Platforms | desktop, server, mobile |
Example |
|
Related | Keyword: --, line Glossary: line, handler, comment, delimit, block comment, execute, script |
Description | Anything between /* and */ is treated as a comment and is ignored by LiveCode when executing the handler. Comments are useful for documenting and explaining your code, either for others who might need to read and modify it, or for yourself. (The code may be clear in your mind now, but in six months, you'll be glad you included comments.) The block comments created by /**/ differ from the line comments created by -- because a block comment can span multiple lines, as well as a single line or part of a line. (A comment marked by -- extends only to the end of the line.) A comment that starts with /* does not end until */, even if there are several lines in between. Comments can be placed anywhere in a script--inside handlers or outside all handlers. In a long script with many handlers, it may be useful to divide the handlers into sections. Each section can start with a comment containing the section name and any other useful information. This practice helps you keep long scripts organized. Similarly, a lengthy handler can be made more readable by explanatory comments. Comments can contain any text, including line of LiveCode scripting. If the code is within a comment, it's ignored. You can temporarily remove sections of code for debugging by putting those sections inside a comment. |