annotate doc/lispintro/README @ 105180:112414938e89

*** empty log message ***
author Nick Roberts <nickrob@snap.net.nz>
date Thu, 24 Sep 2009 12:29:39 +0000
parents cb5d2387102c
children 864345ea94cf
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
100974
cb5d2387102c Add 2009 to copyright years.
Glenn Morris <rgm@gnu.org>
parents: 95952
diff changeset
1 Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009
83944
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2 Free Software Foundation, Inc.
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3 See the end of the file for license conditions.
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6 This directory contains the source of the "Introduction to Programming
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7 in Emacs Lisp" written by Robert J. Chassell, bob@gnu.org. This
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8 manual is an elementary introduction to programming in Emacs Lisp for
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9 people who are not programmers, and who are not necessarily interested
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
10 in programming, but who do want to customize or extend their computing
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
11 environment.
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
12
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
13 This third edition of 2006 Oct 31 updates the previous editions to GNU
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
14 Emacs 22.
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
15
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
16 The Texinfo source file `emacs-lisp-intro.texi', formats without
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
17 reported error using `pdfeTeXk', Version 3.141592-1.21a-2.2 (Web2C
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
18 7.5.4) and texinfo.tex version 2006-08-26.17 started by `texi2dvi'
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
19 version 4.8, and with `makeinfo' version 4.8.
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
20
95952
c0051a1e40a2 Remove out-of-date and irrelevant information on size on .eps files.
Glenn Morris <rgm@gnu.org>
parents: 95034
diff changeset
21 This directory contains the following Encapsulated PostScript figures:
83944
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
22
95952
c0051a1e40a2 Remove out-of-date and irrelevant information on size on .eps files.
Glenn Morris <rgm@gnu.org>
parents: 95034
diff changeset
23 cons-1.eps, cons-2.eps, cons-2a.eps, cons-3.eps, cons-4.eps, cons-5.eps
c0051a1e40a2 Remove out-of-date and irrelevant information on size on .eps files.
Glenn Morris <rgm@gnu.org>
parents: 95034
diff changeset
24 drawers.eps, lambda-1.eps, lambda-2.eps, lambda-3.eps
83944
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
25
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
26 See the beginning of the `emacs-lisp-intro.texi' file for appropriate
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
27 settings. These figures are not necessary; they are merely nice to
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
28 look at --- without them you get the same figures printed with ASCII
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
29 characters.
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
30
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
31 Whether and how you print PostScript depends on your site. You not
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
32 only need to set 'print-postscript-figures' before creating the .dvi
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
33 file, but then must convert the .dvi file to .ps with a 'dvips' or
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
34 equivalent command.
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
35
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
36 On some systems you will see an error message when `psfig.tex' is
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
37 loaded for the last two .eps files:
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
38
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
39 ! No room for a new \write .
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
40
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
41 If this happens, try `epsf.tex' instead of `psfig.tex', or try typing
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
42 RET at the error; the formatting may continue successfully.
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
43
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
44 Or else find the section that says:
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
45
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
46 @c !!! Clear print-postscript-figures if the computer formatting this
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
47 @c document is too small and cannot handle all the diagrams and figures.
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
48 @c clear print-postscript-figures
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
49
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
50 and change the file so it reads: @clear print-postscript-figures
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
51 This will prevent TeX from attempting to load the last few .eps files.
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
52
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
53 You will find additional instructions on formatting in the beginning
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
54 of the Texinfo file 'emacs-lisp-intro.texi'. Best Wishes!
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
55
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
56 2006 Oct 31
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
57 Robert J. Chassell, bob@gnu.org
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
58
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
59
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
60 This file is part of GNU Emacs.
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
61
95034
38ec81da0a8b Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 87649
diff changeset
62 GNU Emacs is free software: you can redistribute it and/or modify
83944
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
63 it under the terms of the GNU General Public License as published by
95034
38ec81da0a8b Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 87649
diff changeset
64 the Free Software Foundation, either version 3 of the License, or
38ec81da0a8b Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 87649
diff changeset
65 (at your option) any later version.
83944
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
66
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
67 GNU Emacs is distributed in the hope that it will be useful,
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
68 but WITHOUT ANY WARRANTY; without even the implied warranty of
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
69 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
70 GNU General Public License for more details.
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
71
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
72 You should have received a copy of the GNU General Public License
95034
38ec81da0a8b Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 87649
diff changeset
73 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.