Positional cues or not

Marcin 'Qrczak' Kowalczyk qrczak@knm.org.pl
12 Feb 2001 14:53:38 GMT


Mon, 12 Feb 2001 13:52:19 +0000, malcolm-hs@cs.york.ac.uk <malcolm-hs@cs.york.ac.uk> pisze:

> So, on balance, it looks like we really need special doc comments
> so tools don't get confused.

Maybe.

But if it didn't require special comments, large pieces of code could
be already written clearly enough to generate documentation from them,
even if they were not intended for automatic extraction, with at most
some minor tweaks.

I hope it can work well without special comments.

-- 
 __("<  Marcin Kowalczyk * qrczak@knm.org.pl http://qrczak.ids.net.pl/
 \__/
  ^^                      SYGNATURA ZASTĘPCZA
QRCZAK