Positional cues or not

[Marcin 'Qrczak' Kowalczyk]

On Tue, 13 Feb 2001, Simon Marlow wrote:

> 	--# DOC

This is not a legal comment but an operator.

I like ---

One problem with documentation comments: sometimes they are before the
definition of the commented thing, but sometimes after. They are before
functions (which are long) but might come aftre type definitions (which
are short). We should probably require them to come before. This has
sometimes the effect that the comment repeats the name of the commented
thing.

-- 
Marcin 'Qrczak' Kowalczyk