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

Michael T. Richter ttmrichter at gmail.com
Sun Dec 31 05:13:31 EST 2006

```On Sat, 2006-30-12 at 02:57 -0500, Cale Gibbard wrote:
> 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.

It appears to be the same markup used in the GHC compiler source code
(which does not bode well for my future reading of the GHC source
either).  Running it on the darcs source code generates several dozen
pages (I'm not exaggerating!) of error messages and no dvi, ps or pdf
files.  Playing around with various command line options doesn't help.
Running it on the GHC source code generates simpler error messages, but
error messages nonetheless.  Then it dumps me in some kind of
interactive mode.  Here's some sample output:

=====8<=====
This is pdfeTeX, Version 3.141592-1.21a-2.2 (Web2C 7.5.4)
entering extended mode
(./CgCon.lhs
LaTeX2e <2003/12/01>
Babel <v3.8d> and hyphenation patterns for american, french, german,
ngerman, b
ahasa, basque, bulgarian, catalan, croatian, czech, danish, dutch,
esperanto, e
stonian, finnish, greek, icelandic, irish, italian, latin, magyar,
norsk, polis
h, portuges, romanian, russian, serbian, slovak, slovene, spanish,
swedish, tur
kish, ukrainian, nohyphenation, loaded.
! Undefined control sequence.
l.4 \section
[CgCon]{Code generation for constructors}
?
=====8<=====

I don't know LaTeX (if that's what this is) at all and I don't know
Haskell sufficiently comfortably to actually distinguish reliably
between LaTeX code and Haskell, so the direct .lhs source code is
basically useless to me.  What's the trick people use to read it?

--
Michael T. Richter
Email: ttmrichter at gmail.com, mtr1966 at hotpop.com
MSN: ttmrichter at hotmail.com, mtr1966 at hotmail.com; YIM:
michael_richter_1966; AIM: YanJiahua1966; ICQ: 241960658; Jabber:
mtr1966 at jabber.cn

"Thanks to the Court's decision, only clean Indians or colored people
other than Kaffirs, can now travel in the trams." --Mahatma Gandhi
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 191 bytes
Desc: This is a digitally signed message part
Url : http://www.haskell.org/pipermail/haskell-cafe/attachments/20061231/4794893b/attachment.bin
```

More information about the Haskell-Cafe mailing list