annotate README @ 306:9ea74add5d37 r21-0b51

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