dpans2texi.el

dpans2texi.el converts the TeX sources of the draft ANSI Common Lisp standard (dpANS) to the Texinfo format.

The purpose is to take advantage of the superior qualities of the Info reader in Emacs compared with other formats, viz.

There are various existing ways to do the latter, though, by opening a web browser at the right spot in the Common Lisp HyperSpec. But this means leaving Emacs ... a Bad Thing™.

Some of the information conveyed by the selection of fonts in the hard-copy version is lost in the translation to Texinfo. I've also made frivolous use of Unicode characters to represent various glyphs — you might need to supplement your fontset to avoid empty boxes in Emacs.

As a side effect of using Texinfo you can also produce a HTML version. This wasn't really a target, but I think the result is quite decent nevertheless.

I won't distribute the converted files, as the draft doesn't grant me permission to do so. So, you need to run the converter on the original TeX files yourself. But here's one example to show what the HTML version looks like: 1.4.1 Notational Conventions, and a screen shot of an Info node in Emacs progn.png.

Caveat: The translation may have introduced errors, please report discrepancies with the hard-copy version.

Q: Why didn't you just use Bill Schelter's Texinfo rendition?
A: Good question! I didn't learn about it until I had finished most of my converter, so I might as well do the rest. I think my version is a bit more polished (I also had the advantage of some handy new Texinfo commands introduced since 1994). Besides, having a converter means that it's fairly easy to customize aspects of the conversion to your preference.

Installation

Problems

Bugs in Texinfo and Emacs rather than the converter as such:


To my main page