annotate etc/InstallGuide @ 4995:8431b52e43b1

Move the various map* functions to C; add #'map-into. src/ChangeLog addition: 2010-01-31 Aidan Kehoe <kehoea@parhasard.net> Move #'mapcar*, #'mapcan, #'mapc, #'map, #'mapl, #'mapcon to C; extend #'mapvector, #'mapconcat, #'mapcar to support more SEQUENCES; have them all error with circular lists. * fns.c (Fsubseq): Call CHECK_SEQUENCE here; Flength can return from the debugger if it errors with a non-sequence, leading to a crash in Fsubseq if sequence really is *not* a sequence. (mapcarX): Rename mapcar1 to mapcarX; rework it comprehensively to take an optional lisp output argument, and a varying number of sequences. Special-case a single list argument, as we used to, saving its elements in the stack space for the results before calling FUNCTION, so FUNCTION can corrupt the list all it wants. dead_wrong_type_argument() in the other cases if we encounter a non-cons where we expected a cons. (Fmapconcat): Accept further SEQUENCES after separator here. Special-case the idiom (mapconcat 'identity SEQUENCE), don't even funcall. (FmapcarX): Rename this from Fmapcar. Accept optional SEQUENCES. (Fmapvector): Accept optional SEQUENCES. (Fmapcan, Fmapc, Fmap): Move these here from cl-extra.el. (Fmap_into): New function, as specified by Common Lisp. (maplist): New function, the guts of the implementation of Fmaplist and Fmapl. (Fmaplist, Fmapl, Fmapcon): Move these from cl-extra.el. (syms_of_fns): Add a few needed symbols here, for the type tests used by #'map. Add the new subrs, with aliases for #'mapc-internal and #'mapcar. * general-slots.h: Declare Qcoerce here, now it's used in both indent.c and fns.c * indent.c (syms_of_indent): Qcoerce is gone from here. * lisp.h: Add ARRAYP(), SEQUENCEP(), and the corresponding CHECK_* macros. Declare Fbit_vector, Fstring, FmapcarX, now other files need to use them. * data.c (Farrayp, Fsequencep): Use ARRAYP and SEQUENCEP, just added to lisp.h * buffer.c (Fbuffer_list): Now Fmapcar has been renamed FmapcarX and takes MANY arguments, update this function to reflect that. lisp/ChangeLog addition: 2010-01-31 Aidan Kehoe <kehoea@parhasard.net> * cl.el (mapcar*): Delete; this is now in fns.c. Use #'mapc, not #'mapc-internal in a couple of places. * cl-macs.el (mapc, mapcar*, map): Delete these compiler macros now the corresponding functions are in fns.c; there's no run-time advantage to the macros. * cl-extra.el (coerce): Extend the possible conversions here a little; it's not remotely comprehensive yet, though it does allow running slightly more Common Lisp code than previously. (cl-mapcar-many): Delete. (map, maplist, mapc, mapl, mapcan, mapcon): Move these to fns.c. * bytecomp.el (byte-compile-maybe-mapc): Use #'mapc itself, not #'mapc-internal, now the former is in C. (mapcar*): Use #'byte-compile-maybe-mapc as this function's byte-compile method, now a #'mapc that can take more than one sequence is in C. * obsolete.el (cl-mapc): Move this compatibility alias to this file. * update-elc.el (do-autoload-commands): Use #'mapc, not #'mapc-internal here.
author Aidan Kehoe <kehoea@parhasard.net>
date Sun, 31 Jan 2010 18:29:48 +0000
parents 9ad43877534d
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
179
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
1 Introduction
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
2
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
3 Thank you for downloading XEmacs. We of the XEmacs development team
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
4 believe user satisfaction is our number one priority, and we hope that
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
5 you will be pleased with the power of our editor. Please follow all
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
6 of the instructions in order to enjoy a quick and easy installation.
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
7
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
8
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
9 Getting Started
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
10
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
11 In this guide, information which you will need to supply will be enclosed in
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
12 angle brackets, <like this>. Commands which you will have to enter will be
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
13 indented,
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
14
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
15 like this.
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
16
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
17 You will need to provide a loading directory, in which to load the
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
18 material from tape (/tmp/xemacs is recommended), and a permanent
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
19 installation directory (/usr/local/xemacs is recommended).
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
20
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
21
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
22 Loading From Tape
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
23
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
24 First create and change directory to the loading directory:
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
25
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
26 mkdir <working directory>
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
27 cd <working directory>
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
28
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
29 Now you are ready to load the software from tape.
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
30
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
31 The specific device name needed to load the tape varies with hardware vendors,
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
32 and may be found in Appendix A, "Vendors and Device Names".
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
33
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
34 Load the software from tape:
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
35
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
36 tar xvf /dev/<device name>
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
37
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
38 You have now loaded all of the software from tape, and are ready to compile and
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
39 install the XEmacs Text Editor.
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
40
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
41
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
42 Compiling and Installing the XEmacs Editor
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
43
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
44 Compiling and installing the libraries is handled by a user-friendly shell
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
45 script. You will need to provide some information to the script, such as your
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
46 organization name and registration number. To run the script, type
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
47
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
48 /bin/sh xemacs/xemacs.install -d <installation directory>
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
49
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
50 Follow the script's directions, and provide the information which it prompts
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
51 for.
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
52
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
53 When the script prompts you for the directory in which the distribution files
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
54 are located, you will find that you are unable to provide it with any directory
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
55 which the script will deem satisfactory. That is because it is necessary to
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
56 order the following additional parts which are necessary to continue with the
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
57 installation:
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
58
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
59 Part Number Qty Name Price
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
60
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
61 GM-96-3026 1 Goat, male 1000.00
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
62 CB-13-2395 1 Candle, black 50.00
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
63 CG-63-6376 1 Chalk dust container 10.00
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
64 IB-89-3335 5 Incense sticks 5.00
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
65 DE-44-8846 1 Dagger, ebon, curved 500.00
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
66 AS-87-2319 1 Altar, silver 10000.00
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
67
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
68 Wait until the additional parts arrive; you will be ready to continue the
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
69 installation the next Friday the 13th at midnight.
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
70
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
71
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
72 Ritual for Successfully Completing Installation
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
73
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
74 Stand in front of the computer. Pour out the chalk dust in an inscribed
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
75 pentagram around you; be sure that it is without breaks. Set an incense stick
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
76 at each of the five corners, the altar in front of the computer, and the candle
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
77 in front of the altar.
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
78
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
79 Light each of the incense sticks and the candles, chanting in a low voice:
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
80
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
81 Daemons and spirits of the netherworld
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
82 Forces of all that is chaotic and mysterious
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
83 Essence of Netscape and MicroSoft
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
84
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
85 I am coming here to appease you
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
86 I offer you this goat
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
87 That my software may work
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
88
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
89 I bind you here
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
90 Do not make my system crash
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
91 Let the software install as advertised
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
92
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
93 Place the goat on the altar, and slaughter it with the dagger.
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
94
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
95 May this goat feed you
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
96 Sate your lust for blood
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
97 Into it may your mischief fly
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
98 Not my computer
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
99 Make the software work
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
100 For this is the only way
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
101
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
102 Then spit into the computer's ventilation slots. This will complete different
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
103 circuits inside the computer, causing its motherboard and cards to function in
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
104 ways that the engineers never intended, thereby making your system compatible
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
105 with our libraries.
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
106
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
107 Reboot your computer. The installation is now complete.
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
108
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
109 [This has undergone a minor rewrite for XEmacs. It originally
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
110 appeared on rec.humor.funny courtesy of jonathan seth hayward
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
111 <jhayward@students.uiuc.edu>, and is included by permission of the
9ad43877534d Import from CVS: tag r20-3b16
cvs
parents:
diff changeset
112 author].