2016-01-01 09:16:19 +00:00
|
|
|
|
Copyright (C) 2001-2016 Free Software Foundation, Inc.
|
2010-12-03 14:45:09 +00:00
|
|
|
|
See the end of the file for license conditions.
|
|
|
|
|
|
|
|
|
|
|
|
|
2016-07-24 15:33:29 +00:00
|
|
|
|
This directory tree holds version 25.1 of GNU Emacs, the extensible,
|
2010-12-03 14:45:09 +00:00
|
|
|
|
customizable, self-documenting real-time display editor.
|
|
|
|
|
|
|
|
|
|
|
|
The file INSTALL in this directory says how to build and install GNU
|
|
|
|
|
|
Emacs on various systems, once you have unpacked or checked out the
|
|
|
|
|
|
entire Emacs file tree.
|
|
|
|
|
|
|
|
|
|
|
|
See the file etc/NEWS for information on new features and other
|
|
|
|
|
|
user-visible changes in recent versions of Emacs.
|
|
|
|
|
|
|
|
|
|
|
|
The file etc/PROBLEMS contains information on many common problems that
|
|
|
|
|
|
occur in building, installing and running Emacs.
|
|
|
|
|
|
|
2015-11-14 04:49:17 +00:00
|
|
|
|
The file CONTRIBUTE contains information on contributing to Emacs as a
|
|
|
|
|
|
developer.
|
|
|
|
|
|
|
2010-12-03 14:45:09 +00:00
|
|
|
|
You may encounter bugs in this release. If you do, please report
|
|
|
|
|
|
them; your bug reports are valuable contributions to the FSF, since
|
|
|
|
|
|
they allow us to notice and fix problems on machines we don't have, or
|
|
|
|
|
|
in code we don't use often. Please send bug reports to the mailing
|
|
|
|
|
|
list bug-gnu-emacs@gnu.org. If possible, use M-x report-emacs-bug.
|
|
|
|
|
|
|
|
|
|
|
|
See the "Bugs" section of the Emacs manual for more information on how
|
2015-04-19 21:40:51 +00:00
|
|
|
|
to report bugs. (The file 'BUGS' in this directory explains how you
|
2010-12-03 14:45:09 +00:00
|
|
|
|
can find and read that section using the Info files that come with
|
2014-01-12 01:35:51 +00:00
|
|
|
|
Emacs.) For a list of mailing lists related to Emacs, see
|
|
|
|
|
|
<http://savannah.gnu.org/mail/?group=emacs>. For the complete
|
|
|
|
|
|
list of GNU mailing lists, see <http://lists.gnu.org/>.
|
2010-12-03 14:45:09 +00:00
|
|
|
|
|
2015-04-19 21:40:51 +00:00
|
|
|
|
The 'etc' subdirectory contains several other files, named in capital
|
2010-12-03 14:45:09 +00:00
|
|
|
|
letters, which you might consider looking at when installing GNU
|
|
|
|
|
|
Emacs.
|
|
|
|
|
|
|
2015-04-19 21:40:51 +00:00
|
|
|
|
The file 'configure' is a shell script to acclimate Emacs to the
|
2010-12-03 14:45:09 +00:00
|
|
|
|
oddities of your processor and operating system. It creates the file
|
2015-04-19 21:40:51 +00:00
|
|
|
|
'Makefile' (a script for the 'make' program), which automates the
|
2010-12-03 14:45:09 +00:00
|
|
|
|
process of building and installing Emacs. See INSTALL for more
|
|
|
|
|
|
detailed information.
|
|
|
|
|
|
|
2015-04-19 21:40:51 +00:00
|
|
|
|
The file 'configure.ac' is the input used by the autoconf program to
|
|
|
|
|
|
construct the 'configure' script.
|
2012-09-10 01:03:27 +00:00
|
|
|
|
|
2015-04-19 21:40:51 +00:00
|
|
|
|
The shell script 'autogen.sh' generates 'configure' and other files by
|
2012-09-10 01:03:27 +00:00
|
|
|
|
running the GNU build tools autoconf and automake, which in turn use
|
|
|
|
|
|
GNU m4 and Perl. If you want to use it, you will need to install
|
|
|
|
|
|
recent versions of these build tools. This should be needed only if
|
2015-04-19 21:40:51 +00:00
|
|
|
|
you edit files like 'configure.ac' that specify Emacs's autobuild
|
2012-09-10 01:03:27 +00:00
|
|
|
|
procedure.
|
2010-12-03 14:45:09 +00:00
|
|
|
|
|
2015-04-19 21:40:51 +00:00
|
|
|
|
The file 'Makefile.in' is a template used by 'configure' to create
|
|
|
|
|
|
'Makefile'.
|
2010-12-03 14:45:09 +00:00
|
|
|
|
|
2015-04-19 21:40:51 +00:00
|
|
|
|
The file 'make-dist' is a shell script to build a distribution tar
|
2010-12-03 14:45:09 +00:00
|
|
|
|
file from the current Emacs tree, containing only those files
|
|
|
|
|
|
appropriate for distribution. If you make extensive changes to Emacs,
|
|
|
|
|
|
this script will help you distribute your version to others.
|
|
|
|
|
|
|
|
|
|
|
|
There are several subdirectories:
|
|
|
|
|
|
|
2015-04-19 21:40:51 +00:00
|
|
|
|
'src' holds the C code for Emacs (the Emacs Lisp interpreter and
|
2010-12-03 14:45:09 +00:00
|
|
|
|
its primitives, the redisplay code, and some basic editing
|
|
|
|
|
|
functions).
|
2015-04-19 21:40:51 +00:00
|
|
|
|
'lisp' holds the Emacs Lisp code for Emacs (most everything else).
|
|
|
|
|
|
'leim' holds the original source files for the generated files
|
Move runtime leim lisp files to lisp/leim directory
This allows us to reuse much of the lisp build and installation machinery,
rather than duplicating it.
* Makefile.in (abs_builddir, leimdir): Remove.
(buildlisppath, SUBDIR, COPYDIR, COPYDESTS): No more leim directory.
(epaths-force-w32): No longer set BLD.
(leim): Remove.
(install-arch-indep): No longer run or install leim.
(mostlyclean, clean): No longer run leim rule.
(bootstrap-clean): Change leim target.
(maintainer-clean): Add leim.
(check-declare): Remove leim.
* README: Update for leim changes.
* configure.ac (leimdir): Remove.
(standardlisppath): No more leimdir.
* make-dist: Update for files from leim/ now being in lisp/leim/.
* doc/lispref/loading.texi (Library Search):
* doc/lispref/os.texi (Startup Summary): No more leim directory.
* leim/Makefile.in (leimdir): New variable.
(TIT_GB, TIT_BIG5, MISC, changed.tit, changed.misc)
(${leimdir}/leim-list.el, ${leimdir}/ja-dic/ja-dic.el):
Generate in $leimdir.
(all): Remove compilation, add ja-dic.
(leim-list.el): Now PHONY.
(setwins, compile-targets, compile-main, clean, mostlyclean)
(extraclean): Remove.
(bootstrap-clean): Delete all generated files.
* leim/README: Update for moved leim/ directory.
* leim/leim-ext.el (ucs-input-activate, hangul-input-method-activate):
Remove manual autoloads; now in loaddefs.el.
Disable byte-compile, version-control, autoloads in the output.
* lisp/Makefile.in (setwins_for_subdirs): Skip leim/ directory.
(compile-main): Depend on lisp/leim rule.
(leim): New rule.
* lisp/loadup.el: Move leim-list.el to leim/ subdirectory.
* lisp/startup.el (normal-top-level): No more leim directory.
* lisp/international/ja-dic-cnv.el (skkdic-convert):
Disable version-control and autoloads in output files.
* lisp/international/titdic-cnv.el (titdic-convert, miscdic-convert):
Disable version-control and autoloads in output files.
* lisp/leim/quail: Move here from ../leim.
* lisp/leim/quail/hangul.el (hangul-input-method-activate):
Add autoload cookie.
(generated-autoload-load-name): Set file-local value.
* lisp/leim/quail/uni-input.el (ucs-input-activate): Add autoload cookie.
(generated-autoload-load-name): Set file-local value.
* nt/README.W32:
* nt/addpm.c (env_vars):
* nt/epaths.nt (PATH_LOADSEARCH, PATH_DUMPLOADSEARCH):
* nt/paths.h (PATH_LOADSEARCH): No more leim directory.
* src/Makefile.in (leimdir): Now in lisp source directory.
($(leimdir)/leim-list.el): Just use ../leim .
* src/epaths.in (PATH_DUMPLOADSEARCH):
* src/lread.c (load_path_default):
* src/nsterm.m (ns_load_path): No more leim directory.
* .bzrignore: Update for relocated leim files.
2013-11-27 06:15:06 +00:00
|
|
|
|
in lisp/leim. These form the library of Emacs input methods,
|
|
|
|
|
|
required to type international characters that can't be
|
|
|
|
|
|
directly produced by your keyboard.
|
2015-04-19 21:40:51 +00:00
|
|
|
|
'lib' holds source code for libraries used by Emacs and its utilities
|
|
|
|
|
|
'lib-src' holds the source code for some utility programs for use by or
|
2010-12-03 14:45:09 +00:00
|
|
|
|
with Emacs, like movemail and etags.
|
2015-04-19 21:40:51 +00:00
|
|
|
|
'etc' holds miscellaneous architecture-independent data files Emacs
|
2010-12-03 14:45:09 +00:00
|
|
|
|
uses, like the tutorial text and tool bar images.
|
2015-04-19 21:40:51 +00:00
|
|
|
|
The contents of the 'lisp', 'leim', 'info', and 'doc'
|
2010-12-03 14:45:09 +00:00
|
|
|
|
subdirectories are architecture-independent too.
|
2015-04-19 21:40:51 +00:00
|
|
|
|
'info' holds the Info documentation tree for Emacs.
|
|
|
|
|
|
'doc/emacs' holds the source code for the Emacs Manual. If you modify the
|
|
|
|
|
|
manual sources, you will need the 'makeinfo' program to produce
|
|
|
|
|
|
an updated manual. 'makeinfo' is part of the GNU Texinfo
|
2010-12-03 14:45:09 +00:00
|
|
|
|
package; you need a suitably recent version of Texinfo.
|
2015-04-19 21:40:51 +00:00
|
|
|
|
'doc/lispref' holds the source code for the Emacs Lisp reference manual.
|
|
|
|
|
|
'doc/lispintro' holds the source code for the Introduction to Programming
|
2010-12-03 14:45:09 +00:00
|
|
|
|
in Emacs Lisp manual.
|
2015-04-19 21:40:51 +00:00
|
|
|
|
'msdos' holds configuration files for compiling Emacs under MS-DOS.
|
|
|
|
|
|
'nextstep' holds instructions and some other files for compiling the
|
2010-12-03 14:45:09 +00:00
|
|
|
|
Nextstep port of Emacs, for GNUstep and Mac OS X Cocoa.
|
2015-04-19 21:40:51 +00:00
|
|
|
|
'nt' holds various command files and documentation files that pertain
|
2010-12-03 14:45:09 +00:00
|
|
|
|
to building and running Emacs on Windows 9X/ME/NT/2000/XP.
|
2015-04-19 21:40:51 +00:00
|
|
|
|
'test' holds tests for various aspects of Emacs's functionality.
|
2010-12-03 14:45:09 +00:00
|
|
|
|
|
|
|
|
|
|
Building Emacs on non-Posix platforms requires tools that aren't part
|
|
|
|
|
|
of the standard distribution of the OS. The platform-specific README
|
|
|
|
|
|
files and installation instructions should list the required tools.
|
|
|
|
|
|
|
2011-01-25 04:03:31 +00:00
|
|
|
|
|
|
|
|
|
|
NOTE ON COPYRIGHT YEARS
|
|
|
|
|
|
|
|
|
|
|
|
In copyright notices where the copyright holder is the Free Software
|
|
|
|
|
|
Foundation, then where a range of years appears, this is an inclusive
|
|
|
|
|
|
range that applies to every year in the range. For example: 2005-2008
|
|
|
|
|
|
represents the years 2005, 2006, 2007, and 2008.
|
|
|
|
|
|
|
2010-12-03 14:45:09 +00:00
|
|
|
|
|
|
|
|
|
|
This file is part of GNU Emacs.
|
|
|
|
|
|
|
|
|
|
|
|
GNU Emacs is free software: you can redistribute it and/or modify
|
|
|
|
|
|
it under the terms of the GNU General Public License as published by
|
|
|
|
|
|
the Free Software Foundation, either version 3 of the License, or
|
|
|
|
|
|
(at your option) any later version.
|
|
|
|
|
|
|
|
|
|
|
|
GNU Emacs is distributed in the hope that it will be useful,
|
|
|
|
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
|
|
GNU General Public License for more details.
|
|
|
|
|
|
|
|
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
|
|
|
|
along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
|