The ProvideX Builder adds the ability to use C-Style block comments to ProvideX programming. These are special comments that span multiple lines of the source file that are not included as part of the tokenized program. This feature allows more detailed documentation to be placed in the source file(s) without increasing (or affecting) the size of the tokenized program.
Two levels of nested comments are supported to allow commenting of a block of program code and include any C-style block comments.
Original source file:
Now, the lines 8-10 will be placed into a C-style block comment. The block comment on the end of line 3 will be included within this block comment and will not stop it from working.
The logic to set the color of the comments does not understand the nesting of block comments and therefore does not show the nested comment as the builder understands it.
The code that will be excluded from the tokenized program has been highlighted in this example.
Modified source file:
Tokenized program:
Allow use of C-style block comments in source files that use line numbers. The begin C-style block comment (/*) and the end C-style block comment (*/) must be part of the standard ProvideX comment line so that it falls within the current source code rules.
Source file:
Tokenized program:
Next Section: Include Files