code documentation

[Sam S. <sd...@gn...>]

Vladimir,

Please follow the common format (UP stands for "Unterprogram"):
/* UP: brief description
  > 1st input parameter
  > 2nd input parameter
  < return value */
Do not forget to list global variables accessed and modified, including STACK.

See src/CodingStyle and older Bruno's code (not mine! :-) for examples.

Thanks.
Sam.