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 ================