The end of line version could be:
--# DOC -- Documentation goes here... --
Sorry, that breaks Haskell'98. --# is a valid operator symbol.
yes, I always loved that particular change in Haskell 98. not.
But, some people clearly prefer a style which is easier on the eye, in which case the {--- -} and --- are fine by me.
Triple dashes are nice because they * have low visual density (not too obtrusive) * look the same for nested/end-of-line varieties without breaking H'98
I think we're arriving at a consensus here. Anyone object? Cheers, Simon
Simon Marlow
But, some people clearly prefer a style which is easier on the eye, in which case the {--- -} and --- are fine by me.
Triple dashes are nice because they * have low visual density (not too obtrusive) * look the same for nested/end-of-line varieties without breaking H'98
I think we're arriving at a consensus here. Anyone object?
It is the smallest evil of all the explicit tag solutions. The text formatting problem outlined in my previous message remains. But I guess, we can always have a pre-processor that converts files documented using positional cues only into the standard format with explicit tags. Cheers, Manuel
participants (2)
-
Manuel M. T. Chakravarty -
Simon Marlow