[Haddock] Haddock markup support for properties
david.waern at gmail.com
Fri Apr 27 09:55:27 BST 2012
2012/4/27 Simon Hengel <sol at typeful.net>:
> (CCing the Haddock mailing list, Kazu Yamamoto and Simon Marlow)
> Hi David,
> Kazu Yamamoto is adding support for QuickCheck properties to doctest.
> So we need to decide on concrete syntax for properties in Haddock
> comments. Previously we designated `prop>' for that. Do you still
> think this is a good choice?
> Here is an example from .
> prop> isSearchPathSeparator a == (a == searchPathSeparator)
> I'm asking because we recently discussed whether we need something akin
> to JavaDoc's @, e.g. %. If we would intend to introduce something like
> that, then using %prop for properties may be an option.
> %prop isSearchPathSeparator a == (a == searchPathSeparator)
I think a prompt (...>) looks better when there's code to the right. I
suppose if we add JavaDoc-like attributes later we could make an
attribute for properties. So I'd go with the former for now.
More information about the Haddock