As mentioned in section See clunky-implementation, the initial
implementation of this literate-programming system is delicate at
best.
1. Environment-commands should be on lines of their own, and preferably
start in column 1; the latter is especially important for verbatim
environments.
2. The line numbers reported with errors stand a fair chance of being
wrong or even laughably irrelevant. LaTeX doesn't report errors in
terms of their original source anyway at all... (urgh)
3. `\Define'-itions (incl. the built-in ones for Haskell,
LaTeX, etc.) are expanded inside `\tr' and friends.
4. You can get confused `\items' (in enumerations, etc.) if you have:
right bracket on the same line -------------------^
The solution (and it's better style anyway) is to put `\items' on
lines of their own. This is a vestige of the implementation...
5. Don't put `\index' commands inside footnotes. There are probably
some other related restrictions... (ToDo)
6. Tabs in code will be expanded to spaces. This matters only if you
have tabs in string constants, or some such (which you shouldn't,
because it's hard for the reader of your code to see what you've done;
use `\t' or the equivalent).
7. If you use the cross-referencing (`-D', I think), you have the
annoying feature of cross-referencing to things very near by, even on
the same page. I don't know how to stop this.