Mercurial > emacs
annotate README @ 63027:b5c7398b1750
*** empty log message ***
author | Luc Teirlinck <teirllm@auburn.edu> |
---|---|
date | Sat, 04 Jun 2005 22:33:53 +0000 |
parents | aac0a33f5772 |
children | a00170090600 35ba943c8399 |
rev | line source |
---|---|
59996
aac0a33f5772
Change release version from 21.4 to 22.1 throughout.
Kim F. Storm <storm@cua.dk>
parents:
50934
diff
changeset
|
1 This directory tree holds version 22.0.50 of GNU Emacs, the extensible, |
25856 | 2 customizable, self-documenting real-time display editor. |
3 | |
4 You may encounter bugs in this release. If you do, please report | |
5 them; your bug reports are valuable contributions to the FSF, since | |
6 they allow us to notice and fix problems on machines we don't have, or | |
7 in code we don't use often. See the file BUGS for more information on | |
8 how to report bugs. | |
9 | |
36122
e6572f8d3aa8
Document that Texinfo 4.0 or later is required for producing the manual.
Eli Zaretskii <eliz@gnu.org>
parents:
36104
diff
changeset
|
10 See the file etc/NEWS for information on new features and other |
36792
f4f0878e1455
Minor changes from Kim Storm <storm@filanet.dk>.
Eli Zaretskii <eliz@gnu.org>
parents:
36541
diff
changeset
|
11 user-visible changes in recent versions of Emacs. |
25856 | 12 |
13 The file INSTALL in this directory says how to bring up GNU Emacs on | |
36792
f4f0878e1455
Minor changes from Kim Storm <storm@filanet.dk>.
Eli Zaretskii <eliz@gnu.org>
parents:
36541
diff
changeset
|
14 various systems, once you have loaded the entire subtree of this |
f4f0878e1455
Minor changes from Kim Storm <storm@filanet.dk>.
Eli Zaretskii <eliz@gnu.org>
parents:
36541
diff
changeset
|
15 directory. |
25856 | 16 |
17 The file etc/PROBLEMS contains information on many common problems that | |
18 occur in building, installing and running Emacs. | |
19 | |
20 Reports of bugs in Emacs should be sent to the mailing list | |
21 bug-gnu-emacs@gnu.org. See the "Bugs" section of the Emacs | |
22 manual for more information on how to report bugs. (The file `BUGS' | |
23 in this directory explains how you can find and read that section | |
24 using the Info files that come with Emacs.) See `etc/MAILINGLISTS' | |
25 for more information on mailing lists relating to GNU packages. | |
26 | |
36792
f4f0878e1455
Minor changes from Kim Storm <storm@filanet.dk>.
Eli Zaretskii <eliz@gnu.org>
parents:
36541
diff
changeset
|
27 The `etc' subdirectory contains several other files, named in capital |
f4f0878e1455
Minor changes from Kim Storm <storm@filanet.dk>.
Eli Zaretskii <eliz@gnu.org>
parents:
36541
diff
changeset
|
28 letters, which you might consider looking at when installing GNU |
f4f0878e1455
Minor changes from Kim Storm <storm@filanet.dk>.
Eli Zaretskii <eliz@gnu.org>
parents:
36541
diff
changeset
|
29 Emacs. |
25856 | 30 |
31 The file `configure' is a shell script to acclimate Emacs to the | |
32 oddities of your processor and operating system. It creates the file | |
33 `Makefile' (a script for the `make' program), which automates the | |
34 process of building and installing Emacs. See INSTALL for more | |
35 detailed information. | |
36 | |
37 The file `configure.in' is the input used by the autoconf program to | |
36268 | 38 construct the `configure' script. Since Emacs has some configuration |
39 requirements that autoconf can't meet directly, and for historical | |
40 reasons, `configure.in' uses an unholy marriage of custom-baked | |
41 configuration code and autoconf macros. If you want to rebuild | |
42 `configure' from `configure.in', you will need to install a recent | |
43 version of autoconf and GNU m4. | |
36122
e6572f8d3aa8
Document that Texinfo 4.0 or later is required for producing the manual.
Eli Zaretskii <eliz@gnu.org>
parents:
36104
diff
changeset
|
44 |
25856 | 45 The file `Makefile.in' is a template used by `configure' to create |
46 `Makefile'. | |
47 | |
48 The file `make-dist' is a shell script to build a distribution tar | |
49 file from the current Emacs tree, containing only those files | |
50 appropriate for distribution. If you make extensive changes to Emacs, | |
51 this script will help you distribute your version to others. | |
52 | |
53 There are several subdirectories: | |
54 | |
42214
515351759218
Add info about the `leim' directory
Eli Zaretskii <eliz@gnu.org>
parents:
41438
diff
changeset
|
55 `src' holds the C code for Emacs (the Emacs Lisp interpreter and |
49600
23a1cea22d13
Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
47784
diff
changeset
|
56 its primitives, the redisplay code, and some basic editing |
42214
515351759218
Add info about the `leim' directory
Eli Zaretskii <eliz@gnu.org>
parents:
41438
diff
changeset
|
57 functions). |
515351759218
Add info about the `leim' directory
Eli Zaretskii <eliz@gnu.org>
parents:
41438
diff
changeset
|
58 `lisp' holds the Emacs Lisp code for Emacs (most everything else). |
49600
23a1cea22d13
Trailing whitespace deleted.
Juanma Barranquero <lekktu@gmail.com>
parents:
47784
diff
changeset
|
59 `leim' holds the library of Emacs input methods, Lisp code and |
42214
515351759218
Add info about the `leim' directory
Eli Zaretskii <eliz@gnu.org>
parents:
41438
diff
changeset
|
60 auxiliary data files required to type international characters |
515351759218
Add info about the `leim' directory
Eli Zaretskii <eliz@gnu.org>
parents:
41438
diff
changeset
|
61 which can't be directly produced by your keyboard. |
515351759218
Add info about the `leim' directory
Eli Zaretskii <eliz@gnu.org>
parents:
41438
diff
changeset
|
62 `lib-src' holds the source code for some utility programs for use by or |
515351759218
Add info about the `leim' directory
Eli Zaretskii <eliz@gnu.org>
parents:
41438
diff
changeset
|
63 with Emacs, like movemail and etags. |
515351759218
Add info about the `leim' directory
Eli Zaretskii <eliz@gnu.org>
parents:
41438
diff
changeset
|
64 `etc' holds miscellaneous architecture-independent data files |
515351759218
Add info about the `leim' directory
Eli Zaretskii <eliz@gnu.org>
parents:
41438
diff
changeset
|
65 Emacs uses, like the tutorial text and the Zippy the Pinhead |
515351759218
Add info about the `leim' directory
Eli Zaretskii <eliz@gnu.org>
parents:
41438
diff
changeset
|
66 quote database. The contents of the `lisp', `leim', `info', |
515351759218
Add info about the `leim' directory
Eli Zaretskii <eliz@gnu.org>
parents:
41438
diff
changeset
|
67 `man', `lispref', and `lispintro' subdirectories are |
515351759218
Add info about the `leim' directory
Eli Zaretskii <eliz@gnu.org>
parents:
41438
diff
changeset
|
68 architecture-independent too. |
515351759218
Add info about the `leim' directory
Eli Zaretskii <eliz@gnu.org>
parents:
41438
diff
changeset
|
69 `info' holds the Info documentation tree for Emacs. |
515351759218
Add info about the `leim' directory
Eli Zaretskii <eliz@gnu.org>
parents:
41438
diff
changeset
|
70 `man' holds the source code for the Emacs Manual. If you modify the |
515351759218
Add info about the `leim' directory
Eli Zaretskii <eliz@gnu.org>
parents:
41438
diff
changeset
|
71 manual sources, you will need the `makeinfo' program to produce |
515351759218
Add info about the `leim' directory
Eli Zaretskii <eliz@gnu.org>
parents:
41438
diff
changeset
|
72 an updated manual. `makeinfo' is part of the GNU Texinfo |
46404
24100426242b
Mention Texinfo 4.2 needed.
Richard M. Stallman <rms@gnu.org>
parents:
45511
diff
changeset
|
73 package; you need version 4.2 or later of Texinfo. |
42214
515351759218
Add info about the `leim' directory
Eli Zaretskii <eliz@gnu.org>
parents:
41438
diff
changeset
|
74 `lispref' holds the source code for the Emacs Lisp reference manual. |
41438 | 75 `lispintro' holds the source code for the Introduction to Programming |
76 in Emacs Lisp manual. | |
25856 | 77 |
42214
515351759218
Add info about the `leim' directory
Eli Zaretskii <eliz@gnu.org>
parents:
41438
diff
changeset
|
78 `msdos' holds configuration files for compiling Emacs under MSDOG. |
515351759218
Add info about the `leim' directory
Eli Zaretskii <eliz@gnu.org>
parents:
41438
diff
changeset
|
79 `vms' holds instructions and useful files for running Emacs under VMS. |
515351759218
Add info about the `leim' directory
Eli Zaretskii <eliz@gnu.org>
parents:
41438
diff
changeset
|
80 `nt' holds various command files and documentation files that pertain |
515351759218
Add info about the `leim' directory
Eli Zaretskii <eliz@gnu.org>
parents:
41438
diff
changeset
|
81 to building and running Emacs on Windows 9X/ME/NT/2000/XP. |
515351759218
Add info about the `leim' directory
Eli Zaretskii <eliz@gnu.org>
parents:
41438
diff
changeset
|
82 `mac' holds instructions, sources, and other useful files for building |
515351759218
Add info about the `leim' directory
Eli Zaretskii <eliz@gnu.org>
parents:
41438
diff
changeset
|
83 and running Emacs on the Mac. |
36122
e6572f8d3aa8
Document that Texinfo 4.0 or later is required for producing the manual.
Eli Zaretskii <eliz@gnu.org>
parents:
36104
diff
changeset
|
84 |
e6572f8d3aa8
Document that Texinfo 4.0 or later is required for producing the manual.
Eli Zaretskii <eliz@gnu.org>
parents:
36104
diff
changeset
|
85 Building Emacs on non-Posix platforms requires to install tools |
e6572f8d3aa8
Document that Texinfo 4.0 or later is required for producing the manual.
Eli Zaretskii <eliz@gnu.org>
parents:
36104
diff
changeset
|
86 that aren't part of the standard distribution of the OS. The |
e6572f8d3aa8
Document that Texinfo 4.0 or later is required for producing the manual.
Eli Zaretskii <eliz@gnu.org>
parents:
36104
diff
changeset
|
87 platform-specific README files and installation instructions should |
e6572f8d3aa8
Document that Texinfo 4.0 or later is required for producing the manual.
Eli Zaretskii <eliz@gnu.org>
parents:
36104
diff
changeset
|
88 list the required tools. |
47784
a51c8430272f
Add info on VMS versions.
Richard M. Stallman <rms@gnu.org>
parents:
46404
diff
changeset
|
89 |
a51c8430272f
Add info on VMS versions.
Richard M. Stallman <rms@gnu.org>
parents:
46404
diff
changeset
|
90 VMS info: |
a51c8430272f
Add info on VMS versions.
Richard M. Stallman <rms@gnu.org>
parents:
46404
diff
changeset
|
91 |
a51c8430272f
Add info on VMS versions.
Richard M. Stallman <rms@gnu.org>
parents:
46404
diff
changeset
|
92 Emacs 19.x and above do not compile out of the box on OpenVMS. |
a51c8430272f
Add info on VMS versions.
Richard M. Stallman <rms@gnu.org>
parents:
46404
diff
changeset
|
93 Richard Levitte <levitte@lp.se> is distributing and maintaining a |
a51c8430272f
Add info on VMS versions.
Richard M. Stallman <rms@gnu.org>
parents:
46404
diff
changeset
|
94 version of Emacs (currently based on version 19.28, but soon moving to |
a51c8430272f
Add info on VMS versions.
Richard M. Stallman <rms@gnu.org>
parents:
46404
diff
changeset
|
95 19.34 and then 20.1) that compiles and works on OpenVMS 5.5 and above |
a51c8430272f
Add info on VMS versions.
Richard M. Stallman <rms@gnu.org>
parents:
46404
diff
changeset
|
96 on both VAX and Alpha architectures. For more information see |
a51c8430272f
Add info on VMS versions.
Richard M. Stallman <rms@gnu.org>
parents:
46404
diff
changeset
|
97 |
a51c8430272f
Add info on VMS versions.
Richard M. Stallman <rms@gnu.org>
parents:
46404
diff
changeset
|
98 http://vms.gnu.org/software/released1/emacs.html#get_emacs_1928_kit |
a51c8430272f
Add info on VMS versions.
Richard M. Stallman <rms@gnu.org>
parents:
46404
diff
changeset
|
99 |
a51c8430272f
Add info on VMS versions.
Richard M. Stallman <rms@gnu.org>
parents:
46404
diff
changeset
|
100 There is also some effort going on with Emacs 21. Source code is |
a51c8430272f
Add info on VMS versions.
Richard M. Stallman <rms@gnu.org>
parents:
46404
diff
changeset
|
101 available at ftp://ftp.nvg.ntnu.no/pub/vms/emacs/. Look for most |
a51c8430272f
Add info on VMS versions.
Richard M. Stallman <rms@gnu.org>
parents:
46404
diff
changeset
|
102 recent stuff with ls -lta. |
a51c8430272f
Add info on VMS versions.
Richard M. Stallman <rms@gnu.org>
parents:
46404
diff
changeset
|
103 |
a51c8430272f
Add info on VMS versions.
Richard M. Stallman <rms@gnu.org>
parents:
46404
diff
changeset
|
104 It is a working "development" version (editing and much more works). |
a51c8430272f
Add info on VMS versions.
Richard M. Stallman <rms@gnu.org>
parents:
46404
diff
changeset
|
105 More developers are needed; contact roart@nvg.ntnu.no. |