who needs this kind of documentation?
http://hackage.haskell.org/packages/archive/tfp/0.2/doc/html/Types-Data-Num-Decimal-Literals.html
The code below is shown under 'Source' links
in that documentation. I don't understand it,
but it seems everything is generated automatically.
What should the author do to avoid those comments?
Older versions of haddock used to define a CPP constant that
could be used to tweak the code for haddock. Since newer
versions nominally support every feature that GHC supports,
that CPP support was dropped.
(a) it would be nice if haddock still identified itself via CPP,
just like GHC does. Then users would at least have the
option to work around current limitations / bugs in haddock,
as well as present tweaked presentations of their interfaces.
(b) it seems sensible for haddock to provide two options for
handling template Haskell code:
- document the TH code
- document the code generated by TH
In this case, the first option would seem more suited.
Claus
module Types.Data.Num.Decimal.Literals where
import Types.Data.Num.Decimal.Literals.TH
import Types.Data.Num.Decimal.Digits
import Types.Data.Num.Ops
$( decLiteralsD "D" "d" (-1) (1) )
--
___
Haskell-Cafe mailing list
Haskell-Cafe@haskell.org
http://www.haskell.org/mailman/listinfo/haskell-cafe
___
Haskell-Cafe mailing list
Haskell-Cafe@haskell.org
http://www.haskell.org/mailman/listinfo/haskell-cafe