Positional cues or not

[Marcin 'Qrczak' Kowalczyk]

On Mon, 12 Feb 2001, John Meacham wrote:

> Another reason to use a distinctive document style is that comments
> are often used to do things like block out unwanted code, or comment
> out blocks which are not needed in hugs say but are in ghc (under the
> presumption someone will go in and edit it later).

These are always {- -}. I would use end-of-line comments for all kinds of
documentation.

We have more choices than the number of introducing dashes:

-- This is Manuel's style of comments.
-- Note the empty comment below:
--
foo :: Some -> Interesting -> Type

For example we could simply decide that a documentation comment must come
just before the type signature, without intervening all-whitespace line.
Comments for larger blocks of definitions have at least one empty line
after them and would be skipped.

-- 
Marcin 'Qrczak' Kowalczyk