Re: Building documentation from comments

[porton@ex-code.com (Victor Porton)]

In article <x7vvg3914ma.fsf@smaug.pushface.org>,
	Simon Wright <simon@pushface.org> writes:
> porton@ex-code.com (Victor Porton) writes:
> 
>> P.S. May be the best solution would be if I would find time to
>> modify Booch source in such the way that it would become fully
>> compatible with AdaBrowse. Is Boch author here? Would you include my
>> changes in the next release and continue to follow my policy for
>> compatibility with AdaBrowse?
> 
> I guess that depends on how much work it is, for how much gain. At the

We just need to develop a simple "standard" of commenting compatible
with AdaBrowse and follow it.

The main problem with comments in the current Booch is that some of
these have empty lines within them, but these should be replaced by
"--" lines (with nothing after "--"). Comments also should be a little 
reordered. It is all.