annotate doc/lispintro/README @ 88070:56fdf8176009

*** empty log message ***
author Alan Mackenzie <acm@muc.de>
date Tue, 29 Jan 2008 20:33:38 +0000
parents 107ccd98fa12
children 38ec81da0a8b
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
87649
107ccd98fa12 Merge from emacs--rel--22
Miles Bader <miles@gnu.org>
parents: 83944
diff changeset
1 Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008
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
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
21 Also, this tar file contains the following optional Encapsulated Post
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
22 Script figures.
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
23
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
24 drawers.eps 7129 bytes
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
25 cons-1.eps 12136
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
26 cons-2.eps 12523
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
27 cons-2a.eps 12420
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
28 cons-3.eps 12984
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
29 cons-4.eps 13866
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
30 cons-5.eps 12986
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
31 lambda-1.eps 10252
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
32 lambda-2.eps 10278
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
33 lambda-3.eps 10275
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
34
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
35 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
36 settings. These figures are not necessary; they are merely nice to
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
37 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
38 characters.
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
39
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
40 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
41 only need to set 'print-postscript-figures' before creating the .dvi
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
42 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
43 equivalent command.
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
44
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
45 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
46 loaded for the last two .eps files:
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
47
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
48 ! No room for a new \write .
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 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
51 RET at the error; the formatting may continue successfully.
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 Or else find the section that says:
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
54
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
55 @c !!! Clear print-postscript-figures if the computer formatting this
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
56 @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
57 @c clear print-postscript-figures
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 and change the file so it reads: @clear print-postscript-figures
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
60 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
61
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
62 You will find additional instructions on formatting in the beginning
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
63 of the Texinfo file 'emacs-lisp-intro.texi'. Best Wishes!
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
64
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
65 2006 Oct 31
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
66 Robert J. Chassell, bob@gnu.org
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
67
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
68
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
69 This file is part of GNU Emacs.
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
70
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
71 GNU Emacs is free software; you can redistribute it and/or modify
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
72 it under the terms of the GNU General Public License as published by
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
73 the Free Software Foundation; either version 3, or (at your option)
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
74 any later version.
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
75
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
76 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
77 but WITHOUT ANY WARRANTY; without even the implied warranty of
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
78 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
79 GNU General Public License for more details.
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
80
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
81 You should have received a copy of the GNU General Public License
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
82 along with GNU Emacs; see the file COPYING. If not, write to the
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
83 Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
08cd8fafddd8 Move here from ../../lispintro/
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
84 Boston, MA 02110-1301, USA.