In a traditional "pointful" definition of a function in Haskell, the names of the function parameters can provide documentation of what the argument is for:
f num_oranges = ...
In point-free style, that opportunity for documentation goes away.
However, if the function has a type signature, then each type element of the signature can be annotated with documentation stating what it is. The feature already exists in Haddock, though it is not too frequently used.
f :: Int -- ^ The 'Int' argument
-> Float -- ^ The 'Float' argument
-> IO () -- ^ The return value
No comments :
Post a Comment