106802
|
1 Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009,
|
|
2 2010 Free Software Foundation, Inc.
|
75769
|
3 See the end of the file for license conditions.
|
75587
|
4
|
|
5
|
107492
|
6 This directory tree holds version 23.1.94 of GNU Emacs, the extensible,
|
25856
|
7 customizable, self-documenting real-time display editor.
|
|
8
|
74308
|
9 The file INSTALL in this directory says how to build and install GNU
|
|
10 Emacs on various systems, once you have unpacked or checked out the
|
|
11 entire Emacs file tree.
|
25856
|
12
|
36122
e6572f8d3aa8
Document that Texinfo 4.0 or later is required for producing the manual.
Eli Zaretskii <eliz@gnu.org>
diff
changeset
|
13 See the file etc/NEWS for information on new features and other
|
36792
|
14 user-visible changes in recent versions of Emacs.
|
25856
|
15
|
|
16 The file etc/PROBLEMS contains information on many common problems that
|
|
17 occur in building, installing and running Emacs.
|
|
18
|
74308
|
19 You may encounter bugs in this release. If you do, please report
|
|
20 them; your bug reports are valuable contributions to the FSF, since
|
|
21 they allow us to notice and fix problems on machines we don't have, or
|
106802
|
22 in code we don't use often. Please send bug reports to the mailing
|
|
23 list bug-gnu-emacs@gnu.org. If possible, use M-x report-emacs-bug.
|
74308
|
24
|
|
25 See the "Bugs" section of the Emacs manual for more information on how
|
|
26 to report bugs. (The file `BUGS' in this directory explains how you
|
|
27 can find and read that section using the Info files that come with
|
|
28 Emacs.) See `etc/MAILINGLISTS' for more information on mailing lists
|
|
29 relating to GNU packages.
|
25856
|
30
|
36792
|
31 The `etc' subdirectory contains several other files, named in capital
|
|
32 letters, which you might consider looking at when installing GNU
|
|
33 Emacs.
|
25856
|
34
|
|
35 The file `configure' is a shell script to acclimate Emacs to the
|
|
36 oddities of your processor and operating system. It creates the file
|
|
37 `Makefile' (a script for the `make' program), which automates the
|
|
38 process of building and installing Emacs. See INSTALL for more
|
|
39 detailed information.
|
|
40
|
|
41 The file `configure.in' is the input used by the autoconf program to
|
36268
|
42 construct the `configure' script. Since Emacs has some configuration
|
|
43 requirements that autoconf can't meet directly, and for historical
|
|
44 reasons, `configure.in' uses an unholy marriage of custom-baked
|
|
45 configuration code and autoconf macros. If you want to rebuild
|
|
46 `configure' from `configure.in', you will need to install a recent
|
|
47 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>
diff
changeset
|
48
|
25856
|
49 The file `Makefile.in' is a template used by `configure' to create
|
|
50 `Makefile'.
|
|
51
|
|
52 The file `make-dist' is a shell script to build a distribution tar
|
|
53 file from the current Emacs tree, containing only those files
|
|
54 appropriate for distribution. If you make extensive changes to Emacs,
|
|
55 this script will help you distribute your version to others.
|
|
56
|
|
57 There are several subdirectories:
|
|
58
|
42214
|
59 `src' holds the C code for Emacs (the Emacs Lisp interpreter and
|
49600
|
60 its primitives, the redisplay code, and some basic editing
|
42214
|
61 functions).
|
|
62 `lisp' holds the Emacs Lisp code for Emacs (most everything else).
|
49600
|
63 `leim' holds the library of Emacs input methods, Lisp code and
|
42214
|
64 auxiliary data files required to type international characters
|
|
65 which can't be directly produced by your keyboard.
|
|
66 `lib-src' holds the source code for some utility programs for use by or
|
|
67 with Emacs, like movemail and etags.
|
|
68 `etc' holds miscellaneous architecture-independent data files
|
|
69 Emacs uses, like the tutorial text and the Zippy the Pinhead
|
|
70 quote database. The contents of the `lisp', `leim', `info',
|
|
71 `man', `lispref', and `lispintro' subdirectories are
|
|
72 architecture-independent too.
|
|
73 `info' holds the Info documentation tree for Emacs.
|
84412
|
74 `doc/emacs' holds the source code for the Emacs Manual. If you modify the
|
42214
|
75 manual sources, you will need the `makeinfo' program to produce
|
|
76 an updated manual. `makeinfo' is part of the GNU Texinfo
|
78651
|
77 package; you need version 4.6 or later of Texinfo.
|
84412
|
78 `doc/lispref' holds the source code for the Emacs Lisp reference manual.
|
|
79 `doc/lispintro' holds the source code for the Introduction to Programming
|
|
80 in Emacs Lisp manual.
|
42214
|
81 `msdos' holds configuration files for compiling Emacs under MSDOG.
|
98459
|
82 `nextstep' holds instructions and some other files for compiling the
|
98512
|
83 Nextstep port of Emacs, for GNUstep and Mac OS X Cocoa.
|
42214
|
84 `nt' holds various command files and documentation files that pertain
|
|
85 to building and running Emacs on Windows 9X/ME/NT/2000/XP.
|
92341
|
86 `test' holds tests for various aspects of Emacs's functionality.
|
36122
e6572f8d3aa8
Document that Texinfo 4.0 or later is required for producing the manual.
Eli Zaretskii <eliz@gnu.org>
diff
changeset
|
87
|
e6572f8d3aa8
Document that Texinfo 4.0 or later is required for producing the manual.
Eli Zaretskii <eliz@gnu.org>
diff
changeset
|
88 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>
diff
changeset
|
89 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>
diff
changeset
|
90 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>
diff
changeset
|
91 list the required tools.
|
75769
|
92
|
|
93
|
|
94 This file is part of GNU Emacs.
|
|
95
|
94719
|
96 GNU Emacs is free software: you can redistribute it and/or modify
|
75769
|
97 it under the terms of the GNU General Public License as published by
|
94719
|
98 the Free Software Foundation, either version 3 of the License, or
|
|
99 (at your option) any later version.
|
75769
|
100
|
|
101 GNU Emacs is distributed in the hope that it will be useful,
|
|
102 but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
103 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
104 GNU General Public License for more details.
|
|
105
|
|
106 You should have received a copy of the GNU General Public License
|
94719
|
107 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
|