README for tar file containing "An Introduction to Programming in Emacs Lisp" This second edition updates the previous editions to GNU Emacs 21. 2001 Nov 20 Robert J. Chassell, bob@gnu.org This is an elementary introduction to programming in Emacs Lisp for people who are not programmers, and who are not necessarily interested in programming, but who do want to customize or extend their computing environment. The compressed tar file, `intro-emacs-lisp-2.00.tar.gz', contains the Texinfo source file for `emacs-lisp-intro.texi'. You may convert this Texinfo file to various formats, to typeset it to print, or read it online. This tar file contains: emacs-lisp-intro.texi approx 770 kilobytes, second edition, 2001 Nov 20, with settings to print for `smallbook' which works well with all sizes of paper and no included PostScript figures (uses ASCII figures instead)o This Texinfo source file, `emacs-lisp-intro.texi', formats without error using TeX version 3.14159, `kpathsea' version 3.3.1, `texinfo.tex' version 2001-05-24.08, and `makeinfo' version 4.0b. Also, this tar file contains the following optional Encapsulated Post Script figures. chest-of-drawers-diagram.eps 7129 bytes cons-cell-diagram1.eps 12136 cons-cell-diagram2.eps 12523 cons-cell-diagram2a.eps 12420 cons-cell-diagram3.eps 12984 cons-cell-diagram4.eps 13866 cons-cell-diagram5.eps 12986 lambda-diagram1.eps 10252 lambda-diagram2.eps 10278 lambda-diagram3.eps 10275 See the beginning of the `emacs-lisp-intro.texi' file for appropriate settings. These figures are not necessary; they are merely nice to look at --- without them you get the same figures printed with ASCII characters. Whether and how you print PostScript depends on your site. You not only need to set 'print-postscript-figures' before creating the .dvi file, but then must convert the .dvi file to .ps with a 'dvips' or equivalent command. On some systems you will see an error message when `psfig.tex' is loaded for the last two .eps files: ! No room for a new \write . If this happens, try `epsf.tex' instead of `psfig.tex', or try typing RET at the error; the formatting may continue successfully. Or else find the section that says: @c !!! Clear print-postscript-figures if the computer formatting this @c document is too small and cannot handle all the diagrams and figures. @c clear print-postscript-figures and change the file so it reads: @clear print-postscript-figures This will prevent TeX from attempting to load the last few .eps files. Here are the instructions on formatting that you will find in the beginning of the Texinfo file 'emacs-lisp-intro.texi'. Best Wishes! @c ================ Included Figures ================ @c Set print-postscript-figures if you print PostScript figures. @c If you clear this, the ten figures will be printed as ASCII diagrams. @c (This is not relevant to Info, since Info only handles ASCII.) @c Your site may require editing changes to print PostScript; in this @c case, search for `print-postscript-figures' and make appropriate changes. @c ================ How to Create an Info file ================ @c If you have `makeinfo' installed, run the following command @c makeinfo emacs-lisp-intro.texi @c or, if you want a single, large Info file, and no paragraph indents: @c makeinfo --no-split --paragraph-indent=0 --verbose emacs-lisp-intro.texi @c After creating the Info file, edit your Info `dir' file, if the @c START-INFO-DIR-ENTRY section below does not enable your system to @c install the manual automatically. @c (The `dir' file is often in the `/usr/local/info/' directory.) @c ================ How to Create an HTML file ================ @c To convert to HTML format @c makeinfo --html --no-split --verbose emacs-lisp-intro.texi @c ================ How to Print a Book in Various Sizes ================ @c This book can be printed in any of three different sizes. @c In the above header, set @-commands appropriately. @c 7 by 9.25 inches: @c @smallbook @c @clear largebook @c 8.5 by 11 inches: @c @c smallbook @c @set largebook @c European A4 size paper: @c @c smallbook @c @afourpaper @c @set largebook @c ================ How to Typeset and Print ================ @c If you do not include PostScript figures, run either of the @c following command sequences, or similar commands suited to your @c system: @c texi2dvi emacs-lisp-intro.texi @c lpr -d emacs-lisp-intro.dvi @c or else: @c tex emacs-lisp-intro.texi @c texindex emacs-lisp-intro.?? @c tex emacs-lisp-intro.texi @c lpr -d emacs-lisp-intro.dvi @c If you include the PostScript figures, you must convert the .dvi @c file to a .ps file before printing. Run either of the @c following command sequences, or one similar: @c @c dvips -f < emacs-lisp-intro.dvi > emacs-lisp-intro.ps @c @c or else: @c @c postscript -p < emacs-lisp-intro.dvi > emacs-lisp-intro.ps @c @c (Note: if you edit the book so as to change the length of the @c table of contents, you may have to change the value of `pageno' below.) @c Remember that TeX places the Table of Contents at the end of the @c print run; you need to put those pages in front of the Preface. @c ================ End of Formatting Sections ================