[Haskell-cafe] Literate Haskell source files. How do I turn them into something I can read?

[Cale Gibbard]

On 30/12/06, Michael T. Richter <ttmrichter at gmail.com> wrote:
>
>  I'm trying to wrap my mind around the darcs source code as a preliminary to looking into GHC's guts.  All of darcs is written as .lhs files which have bizarre mark-up in them which distracts me from the actual Haskell source I'm trying to figure out and get used to.  Apparently the GHC compiler can take .lhs files, strip them with "unlit" (a utility which I finally found buried deep in the GHC installation -- off-path) and then compile them normally.  The problem I have is that unlit leaves behind instead these huge gaping (and highly distracting) stretches of whitespace while it takes out the markup.
>
>  Are there any tools which I can use to render .lhs files readable?  I'm fine with having them converted into documented source (i.e. source code embedded in documentation) or as pure Haskell source (but without the huge whitespace gaps) -- but I can't figure out how to get either.

Assuming that it's LaTeX-based literate source, you usually run
pdflatex on it to get a pdf of the code, but I'm not familiar with the
darcs code in particular, and whether anything special needs to be
done, or whether they have a specialised build for that.

 - Cale