Mercurial > hg > xemacs-beta
annotate etc/InstallGuide @ 1315:70921960b980
[xemacs-hg @ 2003-02-20 08:19:28 by ben]
check in makefile fixes et al
Makefile.in.in: Major surgery. Move all stuff related to building anything in the
src/ directory into src/. Simplify the dependencies -- everything
in src/ is dependent on the single entry `src' in MAKE_SUBDIRS.
Remove weirdo targets like `all-elc[s]', dump-elc[s], etc.
mule/mule-msw-init.el: Removed.
Delete this file.
mule/mule-win32-init.el: New file, with stuff from mule-msw-init.el -- not just for MS Windows
native, boys and girls!
bytecomp.el: Change code inserted to catch trying to load a Mule-only .elc
file in a non-Mule XEmacs. Formerly you got the rather cryptic
"The required feature `mule' cannot be provided". Now you get
"Loading this file requires Mule support".
finder.el: Remove dependency on which directory this function is invoked
from.
update-elc.el: Don't mess around with ../src/BYTECOMPILE_CHANGE. Now that
Makefile.in.in and xemacs.mak are in sync, both of them use
NEEDTODUMP and the other one isn't used.
dumped-lisp.el: Rewrite in terms of `list' and `nconc' instead of assemble-list, so
we can have arbitrary forms, not just `when-feature'.
very-early-lisp.el: Nuke this file.
finder-inf.el, packages.el, update-elc.el, update-elc-2.el, loadup.el, make-docfile.el: Eliminate references to very-early-lisp.
msw-glyphs.el: Comment clarification.
xemacs.mak: Add macros DO_TEMACS, DO_XEMACS, and a few others; this macro
section is now completely in sync with src/Makefile.in.in. Copy
check-features, load-shadows, and rebuilding finder-inf.el from
src/Makefile.in.in. The main build/dump/recompile process is now
synchronized with src/Makefile.in.in. Change `WARNING' to `NOTE'
and `error checking' to `error-checking' TO avoid tripping
faux warnings and errors in the VC++ IDE.
Makefile.in.in: Major surgery. Move all stuff related to building anything in the
src/ directory from top-level Makefile.in.in to here. Simplify
the dependencies. Rearrange into logical subsections.
Synchronize the main compile/dump/build-elcs section with
xemacs.mak, which is already clean and in good working order.
Remove weirdo targets like `all-elc[s]', dump-elc[s], etc. Add
additional levels of macros \(e.g. DO_TEMACS, DO_XEMACS,
TEMACS_BATCH, XEMACS_BATCH, XEMACS_BATCH_PACKAGES) to factor out
duplicated stuff. Clean up handling of "HEAP_IN_DATA" (Cygwin) so
it doesn't need to ignore the return value from dumping. Add
.NO_PARALLEL since various aspects of building and dumping must be
serialized but do not always have dependencies between them
(this is impossible in some cases). Everything related to src/
now gets built in one pass in this directory by just running
`make' (except the Makefiles themselves and config.h, paths.h,
Emacs.ad.h, and other generated .h files).
console.c: Update list of possibly valid console types.
emacs.c: Rationalize the specifying and handling of the type of the first
frame. This was originally prompted by a workspace in which I got
GTK to compile under C++ and in the process fixed it so it could
coexist with X in the same build -- hence, a combined
TTY/X/MS-Windows/GTK build is now possible under Cygwin. (However,
you can't simultaneously *display* more than one kind of device
connection -- but getting that to work is not that difficult.
Perhaps a project for a bored grad student. I (ben) would do it
but don't see the use.) To make sense of this, I added new
switches that can be used to specifically indicate the window
system: -x [aka --use-x], -tty \[aka --use-tty], -msw [aka
--use-ms-windows], -gtk [aka --use-gtk], and -gnome [aka
--use-gnome, same as --use-gtk]. -nw continues as an alias for
-tty. When none have been given, XEmacs checks for other
parameters implying particular device types (-t -> tty, -display
-> x [or should it have same treatment as DISPLAY below?]), and
has ad-hoc logic afterwards: if env var DISPLAY is set, use x (or
gtk? perhaps should check whether gnome is running), else MS
Windows if it exsits, else TTY if it exists, else stream, and you
must be running in batch mode. This also fixes an existing bug
whereby compiling with no x, no mswin, no tty, when running non-
interactively (e.g. to dump) I get "sorry, must have TTY support".
emacs.c: Turn on Vstack_trace_on_error so that errors are debuggable even
when occurring extremely early in reinitialization.
emacs.c: Try to make sure that the user can see message output under
Windows (i.e. it doesn't just disappear right away) regardless of
when it occurs, e.g. in the middle of creating the first frame.
emacs.c: Define new function `emacs-run-status', indicating whether XEmacs
is noninteractive or interactive, whether raw,
post-dump/pdump-load or run-temacs, whether we are dumping,
whether pdump is in effect.
event-stream.c: It's "mommas are fat", not "momas are fat".
Fix other typo.
event-stream.c: Conditionalize in_menu_callback check on HAVE_MENUBARS,
because it won't exist on w/o menubar support,
lisp.h: More hackery on RETURN_NOT_REACHED. Cygwin v3.2 DOES complain here
if RETURN_NOT_REACHED() is blank, as it is for GCC 2.5+. So make it
blank only for GCC 2.5 through 2.999999999999999.
Declare Vstack_trace_on_error.
profile.c: Need to include "profile.h" to fix warnings.
sheap.c: Don't fatal() when need to rerun Make, just stderr_out() and exit(0).
That way we can distinguish between a dumping failing expectedly
(due to lack of stack space, triggering another dump) and unexpectedly,
in which case, we want to stop building. (or go on, if -K is given)
syntax.c, syntax.h: Use ints where they belong, and enum syntaxcode's where they belong,
and fix warnings thereby.
syntax.h: Fix crash caused by an edge condition in the syntax-cache macros.
text.h: Spacing fixes.
xmotif.h: New file, to get around shadowing warnings.
EmacsManager.c, event-Xt.c, glyphs-x.c, gui-x.c, input-method-motif.c, xmmanagerp.h, xmprimitivep.h: Include xmotif.h.
alloc.c: Conditionalize in_malloc on ERROR_CHECK_MALLOC.
config.h.in, file-coding.h, fileio.c, getloadavg.c, select-x.c, signal.c, sysdep.c, sysfile.h, systime.h, text.c, unicode.c: Eliminate HAVE_WIN32_CODING_SYSTEMS, use WIN32_ANY instead.
Replace defined (WIN32_NATIVE) || defined (CYGWIN) with WIN32_ANY.
lisp.h: More futile attempts to walk and chew gum at the same time when
dealing with subr's that don't return.
author | ben |
---|---|
date | Thu, 20 Feb 2003 08:19:44 +0000 |
parents | 9ad43877534d |
children |
rev | line source |
---|---|
179 | 1 Introduction |
2 | |
3 Thank you for downloading XEmacs. We of the XEmacs development team | |
4 believe user satisfaction is our number one priority, and we hope that | |
5 you will be pleased with the power of our editor. Please follow all | |
6 of the instructions in order to enjoy a quick and easy installation. | |
7 | |
8 | |
9 Getting Started | |
10 | |
11 In this guide, information which you will need to supply will be enclosed in | |
12 angle brackets, <like this>. Commands which you will have to enter will be | |
13 indented, | |
14 | |
15 like this. | |
16 | |
17 You will need to provide a loading directory, in which to load the | |
18 material from tape (/tmp/xemacs is recommended), and a permanent | |
19 installation directory (/usr/local/xemacs is recommended). | |
20 | |
21 | |
22 Loading From Tape | |
23 | |
24 First create and change directory to the loading directory: | |
25 | |
26 mkdir <working directory> | |
27 cd <working directory> | |
28 | |
29 Now you are ready to load the software from tape. | |
30 | |
31 The specific device name needed to load the tape varies with hardware vendors, | |
32 and may be found in Appendix A, "Vendors and Device Names". | |
33 | |
34 Load the software from tape: | |
35 | |
36 tar xvf /dev/<device name> | |
37 | |
38 You have now loaded all of the software from tape, and are ready to compile and | |
39 install the XEmacs Text Editor. | |
40 | |
41 | |
42 Compiling and Installing the XEmacs Editor | |
43 | |
44 Compiling and installing the libraries is handled by a user-friendly shell | |
45 script. You will need to provide some information to the script, such as your | |
46 organization name and registration number. To run the script, type | |
47 | |
48 /bin/sh xemacs/xemacs.install -d <installation directory> | |
49 | |
50 Follow the script's directions, and provide the information which it prompts | |
51 for. | |
52 | |
53 When the script prompts you for the directory in which the distribution files | |
54 are located, you will find that you are unable to provide it with any directory | |
55 which the script will deem satisfactory. That is because it is necessary to | |
56 order the following additional parts which are necessary to continue with the | |
57 installation: | |
58 | |
59 Part Number Qty Name Price | |
60 | |
61 GM-96-3026 1 Goat, male 1000.00 | |
62 CB-13-2395 1 Candle, black 50.00 | |
63 CG-63-6376 1 Chalk dust container 10.00 | |
64 IB-89-3335 5 Incense sticks 5.00 | |
65 DE-44-8846 1 Dagger, ebon, curved 500.00 | |
66 AS-87-2319 1 Altar, silver 10000.00 | |
67 | |
68 Wait until the additional parts arrive; you will be ready to continue the | |
69 installation the next Friday the 13th at midnight. | |
70 | |
71 | |
72 Ritual for Successfully Completing Installation | |
73 | |
74 Stand in front of the computer. Pour out the chalk dust in an inscribed | |
75 pentagram around you; be sure that it is without breaks. Set an incense stick | |
76 at each of the five corners, the altar in front of the computer, and the candle | |
77 in front of the altar. | |
78 | |
79 Light each of the incense sticks and the candles, chanting in a low voice: | |
80 | |
81 Daemons and spirits of the netherworld | |
82 Forces of all that is chaotic and mysterious | |
83 Essence of Netscape and MicroSoft | |
84 | |
85 I am coming here to appease you | |
86 I offer you this goat | |
87 That my software may work | |
88 | |
89 I bind you here | |
90 Do not make my system crash | |
91 Let the software install as advertised | |
92 | |
93 Place the goat on the altar, and slaughter it with the dagger. | |
94 | |
95 May this goat feed you | |
96 Sate your lust for blood | |
97 Into it may your mischief fly | |
98 Not my computer | |
99 Make the software work | |
100 For this is the only way | |
101 | |
102 Then spit into the computer's ventilation slots. This will complete different | |
103 circuits inside the computer, causing its motherboard and cards to function in | |
104 ways that the engineers never intended, thereby making your system compatible | |
105 with our libraries. | |
106 | |
107 Reboot your computer. The installation is now complete. | |
108 | |
109 [This has undergone a minor rewrite for XEmacs. It originally | |
110 appeared on rec.humor.funny courtesy of jonathan seth hayward | |
111 <jhayward@students.uiuc.edu>, and is included by permission of the | |
112 author]. |