On Thu, Apr 4, 2013 at 7:49 PM, Johan Tibell <johan.tib...@gmail.com> wrote:
> Hi all, > > Haddock's current markup language leaves something to be desired once > you want to write more serious documentation (e.g. several paragraphs > of introductory text at the top of the module doc). Several features > are lacking (bold text, links that render as text instead of URLs, > inline HTML). > > I suggest that we implement an alternative haddock syntax that's a > superset of Markdown. It's a superset in the sense that we still want > to support linkifying Haskell identifiers, etc. Modules that want to > use the new syntax (which will probably be incompatible with the > current syntax) can set: > > {-# HADDOCK Markdown #-} > > on top of the source file. > > Ticket: http://trac.haskell.org/haddock/ticket/244 > > -- Johan > > _______________________________________________ > Haskell-Cafe mailing list > Haskell-Cafe@haskell.org > http://www.haskell.org/mailman/listinfo/haskell-cafe > +1 In case it can be useful in any way for this project, my markdown package[1] is certainly available for scavenging, though we'd likely want to refactor it to not use conduit (I can't imagine conduit being a good dependency for Haddock). [1] http://hackage.haskell.org/package/markdown
_______________________________________________ Haskell-Cafe mailing list Haskell-Cafe@haskell.org http://www.haskell.org/mailman/listinfo/haskell-cafe