[Haskell-cafe] haddock backends

[Roman Cheplyaka]

* Mateusz Kowalczyk <fuuzetsu at fuuzetsu.co.uk> [2014-01-07 02:52:12+0000]
> * This touches on frequently overlooked problem: Haddock targets more
>   than just the HTML back-end. We also have the LaTeX back-end and the
>   Hoogle back-end. This is why we don't allow things like verbatim
>   HTML in the markup, it doesn't make sense for anything but HTML.
>   Admittedly, LaTeX back-end could just generate the maths itself but
>   we then suddenly have to change the ‘verbatim’ block to the ‘LaTeX’
>   block. It's also unclear how Hoogle back-end would deal with this.
>   Even if we add the ‘LaTeX structure‘ to Haddock, I'm afraid that it
>   might end up with people just writing LaTeX for their documentation
>   which is useless for anyone not using that back-end.

I see no reason why haddock should have a hoogle backend, as opposed to
hoogle using the GHC API directly. It's just a hack that exists for
historical reasons.

Other than that, HTML is the only backend really in use at the moment,
I believe.

Roman
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 836 bytes
Desc: Digital signature
URL: <http://www.haskell.org/pipermail/haskell-cafe/attachments/20140107/53b92e3b/attachment.sig>