annotate lispintro/README @ 80257:11e84af22e25

*** empty log message ***
author Alan Mackenzie <acm@muc.de>
date Sat, 01 Mar 2008 09:02:47 +0000
parents a8fd89a466fd
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
79749
a8fd89a466fd Add 2008 to copyright years.
Glenn Morris <rgm@gnu.org>
parents: 78256
diff changeset
1 Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008
75587
68cfc1db0d26 Add copyright and permissions notices.
Glenn Morris <rgm@gnu.org>
parents: 73587
diff changeset
2 Free Software Foundation, Inc.
75774
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75587
diff changeset
3 See the end of the file for license conditions.
75587
68cfc1db0d26 Add copyright and permissions notices.
Glenn Morris <rgm@gnu.org>
parents: 73587
diff changeset
4
68cfc1db0d26 Add copyright and permissions notices.
Glenn Morris <rgm@gnu.org>
parents: 73587
diff changeset
5
73587
c84b73607df3 Removed INSTALL MANIFEST since those files are now irrelevant.
Robert J. Chassell <bob@rattlesnake.com>
parents: 49600
diff changeset
6 This directory contains the source of the "Introduction to Programming
41423
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
7 in Emacs Lisp" written by Robert J. Chassell, bob@gnu.org. This
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
8 manual is an elementary introduction to programming in Emacs Lisp for
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
9 people who are not programmers, and who are not necessarily interested
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
10 in programming, but who do want to customize or extend their computing
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
11 environment.
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
12
73587
c84b73607df3 Removed INSTALL MANIFEST since those files are now irrelevant.
Robert J. Chassell <bob@rattlesnake.com>
parents: 49600
diff changeset
13 This third edition of 2006 Oct 31 updates the previous editions to GNU
c84b73607df3 Removed INSTALL MANIFEST since those files are now irrelevant.
Robert J. Chassell <bob@rattlesnake.com>
parents: 49600
diff changeset
14 Emacs 22.
41423
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
15
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
16 The Texinfo source file `emacs-lisp-intro.texi', formats without
73587
c84b73607df3 Removed INSTALL MANIFEST since those files are now irrelevant.
Robert J. Chassell <bob@rattlesnake.com>
parents: 49600
diff changeset
17 reported error using `pdfeTeXk', Version 3.141592-1.21a-2.2 (Web2C
c84b73607df3 Removed INSTALL MANIFEST since those files are now irrelevant.
Robert J. Chassell <bob@rattlesnake.com>
parents: 49600
diff changeset
18 7.5.4) and texinfo.tex version 2006-08-26.17 started by `texi2dvi'
c84b73607df3 Removed INSTALL MANIFEST since those files are now irrelevant.
Robert J. Chassell <bob@rattlesnake.com>
parents: 49600
diff changeset
19 version 4.8, and with `makeinfo' version 4.8.
41423
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
20
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
21 Also, this tar file contains the following optional Encapsulated Post
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
22 Script figures.
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
23
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
24 drawers.eps 7129 bytes
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
25 cons-1.eps 12136
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
26 cons-2.eps 12523
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
27 cons-2a.eps 12420
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
28 cons-3.eps 12984
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
29 cons-4.eps 13866
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
30 cons-5.eps 12986
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
31 lambda-1.eps 10252
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
32 lambda-2.eps 10278
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
33 lambda-3.eps 10275
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
34
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
35 See the beginning of the `emacs-lisp-intro.texi' file for appropriate
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
36 settings. These figures are not necessary; they are merely nice to
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
37 look at --- without them you get the same figures printed with ASCII
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
38 characters.
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
39
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
40 Whether and how you print PostScript depends on your site. You not
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
41 only need to set 'print-postscript-figures' before creating the .dvi
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
42 file, but then must convert the .dvi file to .ps with a 'dvips' or
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
43 equivalent command.
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
44
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
45 On some systems you will see an error message when `psfig.tex' is
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
46 loaded for the last two .eps files:
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
47
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
48 ! No room for a new \write .
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
49
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
50 If this happens, try `epsf.tex' instead of `psfig.tex', or try typing
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
51 RET at the error; the formatting may continue successfully.
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
52
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
53 Or else find the section that says:
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
54
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
55 @c !!! Clear print-postscript-figures if the computer formatting this
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
56 @c document is too small and cannot handle all the diagrams and figures.
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
57 @c clear print-postscript-figures
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
58
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
59 and change the file so it reads: @clear print-postscript-figures
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
60 This will prevent TeX from attempting to load the last few .eps files.
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
61
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
62 You will find additional instructions on formatting in the beginning
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
63 of the Texinfo file 'emacs-lisp-intro.texi'. Best Wishes!
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
64
73587
c84b73607df3 Removed INSTALL MANIFEST since those files are now irrelevant.
Robert J. Chassell <bob@rattlesnake.com>
parents: 49600
diff changeset
65 2006 Oct 31
41423
c3a5027a4fb2 Modified for the inclusion in the Emacs distribution.
Eli Zaretskii <eliz@gnu.org>
parents:
diff changeset
66 Robert J. Chassell, bob@gnu.org
75774
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75587
diff changeset
67
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75587
diff changeset
68
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75587
diff changeset
69 This file is part of GNU Emacs.
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75587
diff changeset
70
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75587
diff changeset
71 GNU Emacs is free software; you can redistribute it and/or modify
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75587
diff changeset
72 it under the terms of the GNU General Public License as published by
78256
ee787fc40e93 Switch license to GPLv3 or later.
Glenn Morris <rgm@gnu.org>
parents: 75774
diff changeset
73 the Free Software Foundation; either version 3, or (at your option)
75774
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75587
diff changeset
74 any later version.
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75587
diff changeset
75
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75587
diff changeset
76 GNU Emacs is distributed in the hope that it will be useful,
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75587
diff changeset
77 but WITHOUT ANY WARRANTY; without even the implied warranty of
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75587
diff changeset
78 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75587
diff changeset
79 GNU General Public License for more details.
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75587
diff changeset
80
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75587
diff changeset
81 You should have received a copy of the GNU General Public License
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75587
diff changeset
82 along with GNU Emacs; see the file COPYING. If not, write to the
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75587
diff changeset
83 Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
dc23aaa67696 Switch to standard GPL text for license.
Glenn Morris <rgm@gnu.org>
parents: 75587
diff changeset
84 Boston, MA 02110-1301, USA.