Comments on: How To Navigate Your Code:

By: Magnus

Magnus — Tue, 09 Mar 2010 07:29:05 +0000

I believe you can use some HTML tags in the text, so, maybe would work for your double-dashes?

Otherwise I can recommend the markup plugin.

By: Andrea Vezzosi

Andrea Vezzosi — Wed, 24 Jun 2009 04:27:15 +0000

It creates separate documentations for the library and the executables, e.g one at dist/doc/html/haddock/index.html and the other at dist/doc/html/haddock/haddock/index.html.
Maybe that’s not the best outcome and we should create an aggregate index?

By: haddock2009

haddock2009 — Tue, 23 Jun 2009 23:42:18 +0000

Andrea: Interesting! –internal has the same problems as ignore-exports (of course, because it uses that feature). –executables *only* documents the executable and I don’t see how to make it document the library too? (there’s both an executable and a library in haddock.cabal). I’m using:

> cabal –version

cabal-install version 0.6.2

using version 1.6.0.3 of the Cabal library

By: Andrea Vezzosi

Andrea Vezzosi — Tue, 23 Jun 2009 23:21:04 +0000

have you seen the –internal and –executables options? with them you shouldn’t need to mangle the .cabal file

By: haddock2009

haddock2009 — Tue, 23 Jun 2009 22:39:37 +0000

P.S.
1. how do I quote literal text in WordPress (so it doesn’t turn dash-dash into long dash, for example)?

2. Of course ignore-exports is quite faithful to what it claims to do (matching the Haskell98 effect of omitting the export list), but I was pleasantly surprised to find a feature that did even something vaguely like what I wanted

3. This is increasing my code-reading/comprehension speed tenfold, I wish I’d thought of it earlier