annotate README @ 68:0b7f3b634cf2 r19-16-pre9

Import from CVS: tag r19-16-pre9
author cvs
date Mon, 13 Aug 2007 09:00:03 +0200
parents ee648375d8d6
children 131b0175ea99
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
50
ee648375d8d6 Import from CVS: tag r19-16b91
cvs
parents: 44
diff changeset
1 This directory tree holds version 19.16 of XEmacs, the extensible,
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2 customizable, self-documenting real-time display editor.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
4 See the file `etc/NEWS' for information on new features and other
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
5 user-visible changes since the last version of XEmacs.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
6
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
7 The file INSTALL in this directory says how to bring up XEmacs on
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
8 Unix, once you have loaded the entire subtree of this directory.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
9
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
10 The file PROBLEMS contains information on many common problems that
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
11 occur in building, installing and running XEmacs.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
12
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
13 Reports of bugs in XEmacs should be posted to the newsgroup
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
14 comp.emacs.xemacs or sent to the mailing list xemacs@xemacs.org. See
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
15 the "Bugs" section of the XEmacs manual for more information on how to
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
16 report bugs. (The file `BUGS' in this directory explains how you can
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
17 find and read that section using the Info files that come with
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
18 XEmacs.) See `etc/MAILINGLISTS' for more information on mailing lists
44
8d2a9b52c682 Import from CVS: tag r19-15prefinal
cvs
parents: 22
diff changeset
19 relating to XEmacs and other GNU products. You should also read part
8d2a9b52c682 Import from CVS: tag r19-15prefinal
cvs
parents: 22
diff changeset
20 II of the XEmacs FAQ, the latest version of which is available on the
8d2a9b52c682 Import from CVS: tag r19-15prefinal
cvs
parents: 22
diff changeset
21 World Wide Web at:
8d2a9b52c682 Import from CVS: tag r19-15prefinal
cvs
parents: 22
diff changeset
22 http://www.xemacs.org/faq/
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
23
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
24 The file `configure' is a shell script to acclimate XEmacs to the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
25 oddities of your processor and operating system. It will create a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
26 file named `Makefile' (a script for the `make' program), which helps
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
27 automate the process of building and installing emacs. See INSTALL
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
28 for more detailed information.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
29
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
30 The file `configure.in' is the input used by the autoconf program to
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
31 construct the `configure' script. Since XEmacs has configuration
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
32 requirements that autoconf can't meet, `configure.in' uses an unholy
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
33 marriage of custom-baked configuration code and autoconf macros; it
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
34 may be wise to avoid rebuilding `configure' from `configure.in' when
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
35 possible.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
36
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
37 The file `Makefile.in' is a template used by `configure' to create
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
38 `Makefile'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
39
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
40 There are several subdirectories:
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
41
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
42 `src' holds the C code for Emacs (the XEmacs Lisp interpreter and its
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
43 primitives, the redisplay code, and some basic editing functions).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
44 `lisp' holds the Emacs Lisp code for XEmacs (most everything else).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
45 `lib-src' holds the source code for some utility programs for use by
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
46 or with XEmacs, like movemail and etags.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
47 `etc' holds miscellaneous architecture-independent data files
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
48 XEmacs uses, like the tutorial text and the Zippy the Pinhead quote
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
49 database. The contents of the `lisp', `info' and `man'
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
50 subdirectories are architecture-independent too.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
51 `lwlib' holds the C code for the toolkit objects used by XEmacs.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
52
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
53 `info' holds the Info documentation tree for XEmacs.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
54 `man' holds the source code for the XEmacs manual.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
55
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
56 `msdos' holds configuration files for compiling XEmacs under MSDOG.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
57 See the file etc/MSDOS for more information.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
58 `vms' holds instructions and useful files for running XEmacs under VMS.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
59 (not supported)