William F Pokorny <ano### [at] anonymousorg> wrote:

> I don't myself use 'open-indicator to close-indicator' block style
> comments - as a rule.

On a side note, the block style commenting is very useful for processing other
content in
...pov-files. For example literate programming.

/*$redlines
......
*/

can be a explanation, tutorial, block that goes with a macro below it, while

#macro redlines(thickness, roundness, ...)
/*:redlines(thickness, roundness, ...)
parameters:
thickness (float): ....
roundness (float): ....

result:
......
*/

........macro code

#end

can be used for documentation of that macro. All information goes in the .pov
file and with a proper untangle software one could extract the documentation and
a tutorial.

ingo

Post a reply to this message