dpans2texi.el converts the TeX sources of the draft ANSI Common Lisp standard (dpANS) to the Texinfo format.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
AUTHORS
COPYING
ChangeLog
INSTALL
Makefile
Makefile.am
Makefile.in
NEWS
README
aclocal.m4
ansicl.css
ansicl.texi
appendix-implem-defined.tex
appendix-portability.tex
appendix-removed.tex
chap-0-edit-history.tex
chap-0.tex
chap-1.tex
chap-10.tex
chap-11.tex
chap-12.tex
chap-13.tex
chap-14.tex
chap-15.tex
chap-16.tex
chap-17.tex
chap-18.tex
chap-19.tex
chap-2.tex
chap-20.tex
chap-21.tex
chap-22.tex
chap-23.tex
chap-24.tex
chap-25.tex
chap-26.tex
chap-3.tex
chap-4.tex
chap-5.tex
chap-6.tex
chap-7.tex
chap-8.tex
chap-9.tex
chap-a.tex
concept-args.tex
concept-arrays.tex
concept-bvl.tex
concept-change-class.tex
concept-characters.tex
concept-cl-symbols.tex
concept-classes.tex
concept-compile.tex
concept-conditions.tex
concept-conformance.tex
concept-conses.tex
concept-decls.tex
concept-definitions.tex
concept-deprecated.tex
concept-destruction.tex
concept-environment.tex
concept-eval.tex
concept-exits.tex
concept-extensions.tex
concept-filenames.tex
concept-files.tex
concept-format.tex
concept-gfs-and-methods.tex
concept-glossary.tex
concept-hash-tables.tex
concept-history.tex
concept-logical-pathnames.tex
concept-loop.tex
concept-macro-chars.tex
concept-meta-objects.tex
concept-numbers.tex
concept-objects.tex
concept-organization.tex
concept-packages.tex
concept-pathnames.tex
concept-places.tex
concept-pprint.tex
concept-print.tex
concept-reader-algorithm.tex
concept-reader.tex
concept-references.tex
concept-reinit.tex
concept-sequences.tex
concept-slots.tex
concept-streams.tex
concept-strings.tex
concept-subsets.tex
concept-symbols.tex
concept-syntax.tex
concept-systems.tex
concept-tests.tex
concept-tokens.tex
concept-traversal.tex
concept-type-intro.tex
concept-types.tex
config.log
config.status
configure
configure.ac
dict-arrays.tex
dict-characters.tex
dict-conditions.tex
dict-conses.tex
dict-environment.tex
dict-eval-compile.tex
dict-files.tex
dict-flow.tex
dict-hash-tables.tex
dict-iteration.tex
dict-numbers.tex
dict-objects.tex
dict-packages.tex
dict-pathnames.tex
dict-printer.tex
dict-reader.tex
dict-sequences.tex
dict-streams.tex
dict-strings.tex
dict-structures.tex
dict-symbols.tex
dict-system-construction.tex
dict-types.tex
dp.texi
dpans2texi.el
dph.texi
dpi.texi
elisp-comp
install-sh
missing
robots.txt
robots.txt.1
setup-amfont.tex
setup-aux.tex
setup-boxfig.tex
setup-cmfont.tex
setup-document.tex
setup-figures.tex
setup-for-toc.tex
setup-options.tex
setup-sections-for-toc.tex
setup-sections.tex
setup-tables.tex
setup-terms.tex
setup-title.tex
setup-version.tex
setup.tex

README

                                 dpans2texi.el

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

   The purpose is to take advantage of the superior qualities of the Info
   reader in Emacs compared with other formats, viz.
     * Single-key index lookup with completion: i.
     * Single-key full text regexp search: s
     * Convenient symbol lookup from source code: C-h C-i

   There are [3]various existing ways to do the latter, though, by
   opening a web browser at the right spot in the [4]Common Lisp
   HyperSpec. But this means leaving Emacs ... a Bad Thing(TM).

   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 [5]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.

   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 [8]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

     * You need Texinfo 4.7 (released 10-04-2004) or later.
     * Get dpans2texi-1.03.tar.gz and unpack the tarball.
     * Run ./configure
     * Run make wget to download the .tex files with wget (or download
       them directly from [10]parcftp.xerox.com/pub/cl/dpANS3 and
       [11]parcftp.xerox.com/pub/cl/dpANS3R to the same directory).
     * Build the info files with make, and finally install them in your
       Info directory with make install
     * To use C-h C-i in Lisp mode to look up the symbol at point in the
       spec, add the following to your .emacs file:
   (require 'info-look)
   (info-lookup-add-help
    :mode 'lisp-mode
    :regexp "[^][()'\" \t\n]+"
    :ignore-case t
    :doc-spec '(("(ansicl)Symbol Index" nil nil nil)))
     * Run make html if you want a HTML version. You can also produce
       Docbook and XML versions with the xml and docbook targets.

  Problems

   Bugs in Texinfo and Emacs rather than the converter as such:
     * Backreferences from the list of figures are broken in Info.
     * makeinfo crashes on the XML, Docbook and HTML targets on Mac OS X.
     * Emacs on Mac OS X doesn't display all characters even though the
       font does contain them.

References

   2. http://texinfo.org/
   3. http://www.cliki.net/CLHS
   4. http://www.lispworks.com/reference/HyperSpec/Front/index.htm
   5. http://www.gnu.org/software/emacs/manual/html_node/International.html
   8. ftp://ftp.ma.utexas.edu/pub/gcl/gcl-info+texi.tgz
  10. ftp://parcftp.xerox.com/pub/cl/dpANS3
  11. ftp://parcftp.xerox.com/pub/cl/dpANS3R