README for tar file containing "Programming in Emacs Lisp: An Introduction"

9 March 1995
Robert J. Chassell, bob@gnu.ai.mit.edu

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.

'emacs-lisp-intro.texi' is a Texinfo source file.  You may convert it
to Info to read on line or typeset it to print.

This tar file contains:

    emacs-lisp-intro.texi      

                    669,622 bytes    Edition 1.00    28 February 1995
                    with settings for default 8.5 by 11 inch printing,
                    and no included PostScript figures (use ascii
                    figures instead)


In smallbook format, which I prefer even when printing on 8.5 by 11
inch paper, this manual prints to 276 pages; however I have set this
to print in the standard 8.5 by 11 inch size.  You may want to change this.

Also, this tar file contains the following optional Encapsulated Post
Script figures.

    chest-of-drawers-diagram.eps    11876 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          13867 
    cons-cell-diagram5.eps          12986 
    lambda-diagram1.eps             10252 
    lambda-diagram2.eps             10276 
    lambda-diagram3.eps             10271 

See the beginning of the 'emacs-lisp-intro.texi' file for appropriate
settings.  The PostScript figures are not necessary, merely nice to
look at --- without the Postscript you get the same figures printed
with ascii characters.

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.  You may also have to edit the paths for the included .eps
files in 'emacs-lisp-intro.texi' to change the location from
'/usr/local/emacs/man/' to whereever you have put the 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 ================ Size to Print Book ================

@c This manual 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              @set largebook

@c     European A4 size paper:   
@c              @afourpaper
@c              @set largebook

@c ================ How to Create an Info file ================

@c If you have `makeinfo' installed, run the following command  
@c (where  %  is the shell prompt): 

@c     % makeinfo emacs-lisp-intro.texi

@c or else, inside of GNU Emacs, find the `emacs-lisp-intro.texi' 
@c and then run: 

@c     M-x texinfo-format-buffer

@c After creating the Info file, edit your Info `dir' file
@c appropriately. (The `dir' file is often in the `/usr/local/info/'
@c directory; you can use the START-INFO-DIR-ENTRY information below.)

@c ================ How to Create an HTML file ================

@c To convert to HTML format, apply `texi2html' or 
@c similar command to the `emacs-lisp-intro.texi' file.

@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 ================ End of Formatting Sections ================
