#43 mix remarks and code on the same line

[Frans Slothouber]

This was part of [ 769043 ].

The idea is to mix remarks and code on the same line
(thanks to David White for this idea).

For instance:

/****s* SuperLib/SnuFactor
* FUNCTION
* Structure for the SnuFactor
* ATTRIBUTES
*/

struct SnuFactor {
long qF /* qF -- gives the quality factor of the snu
factor */
long snu /* snu -- gives the snu factor in degrees */
}

/******/

This would result in:

FUNCTION
Structure for the SnuFactor
ATTRIBUTES
qF -- gives the quality factor of the snu factor
snu -- gives the snu factor in degrees