1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155
|
README for tar file containing "Programming in Emacs Lisp: An Introduction"
This edition, 1.05 of 21 October 1997, only corrects typographical
errors in the previous editions, 1.01, 1.02, 1.03, and 1.04.
There are no other changes.
21 October 1997
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.
The tar file, `intro-emacs-lisp-1.05.tar', contains the Texinfo
source file for `emacs-lisp-intro.texi'. You may convert this Texinfo
file to Info to read online or typeset it to print.
This tar file contains:
emacs-lisp-intro.texi
approx 670 kilobytes Edition 1.05 21 Oct 1995
with settings for default 8.5 by 11 inch printing,
and no included PostScript figures (uses 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.
This Texinfo source file, `emacs-lisp-intro.texi', formats without
error using TeX version 3.14159 and `texinfo.tex' version 2.196, and
`makeinfo' version 1.67. Unless you change it, the source file does
not format with the obsolete `texinfo.tex' version 2.108.
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 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. 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/lib/emacs/man/' to where ever you have put the files.
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.
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.)
@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 Note: unless you change it, this file does not format with the
@c obsolete `texinfo.tex 2.108'; use a more recent version. This file
@c formats without error using `TeX 3.1415' and `texinfo.tex 2.145'.
@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 ================
|