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 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@gmail.com, mtr1966@hotpop.com
MSN: ttmrichter@hotmail.com, mtr1966@hotmail.com; YIM:
michael_richter_1966; AIM: YanJiahua1966; ICQ: 241960658; Jabber:
mtr1966@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