POV-Ray : Newsgroups : povray.general : subtle problem with /*...*/ comment block : Re: subtle problem with /*...*/ comment block Server Time
2 Jan 2025 10:14:49 EST (-0500)
  Re: subtle problem with /*...*/ comment block  
From: William F Pokorny
Date: 22 Dec 2024 04:34:57
Message: <6767dd41$1@news.povray.org>
On 12/21/24 09:42, Kenneth wrote:
> BTW: In the world of computing, is there an actual standardized*name* for
>      /*  or  */   ??

I'm not aware of a standard name.

I wonder what our own POV-Ray documentation says about comments. Ah, 
it's pretty basic - no name for the style. Ref:

https://wiki.povray.org/content/Reference:Comments

I don't myself use 'open-indicator to close-indicator' block style 
comments - as a rule. Rather the single line forms like '//' - even for 
multiple line comments. Editors like vim handle vim handle multi-line // 
comment blocks reasonably well.

Where I need to 'turn off' a block of code - or switch between options - 
while working I'll use the following over a /*..*/ block style comment:

#if (0)   // ????
   ...
#end

or

#if (0)   // ????
   ...
#else
   ...
#end

Changing the '0' to '1' to 'turn on' code again or to flip between 
versions of code under test.

The "????" string is my personal 'hook' to be sure I later clean up 
temporary debug or development actions like this.

FWIW. Coding styles are varied and are affected too by the coding 
environment (the editor used, etc.).

Bill P.


Post a reply to this message

Copyright 2003-2023 Persistence of Vision Raytracer Pty. Ltd.