X-Git-Url: https://code.delx.au/gnu-emacs/blobdiff_plain/3604d9bde1ae7dd531dc97a646b49618e28e5702..0ab7b23ae0a12669fef7f5939fbb0161f29280a2:/README diff --git a/README b/README index 151fdfecee..de4ee24fc5 100644 --- a/README +++ b/README @@ -1,9 +1,8 @@ -Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 - Free Software Foundation, Inc. +Copyright (C) 2001-2012 Free Software Foundation, Inc. See the end of the file for license conditions. -This directory tree holds version 22.2.92 of GNU Emacs, the extensible, +This directory tree holds version 24.1.50 of GNU Emacs, the extensible, customizable, self-documenting real-time display editor. The file INSTALL in this directory says how to build and install GNU @@ -19,10 +18,8 @@ occur in building, installing and running Emacs. 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 for released -versions of Emacs sent to the mailing list bug-gnu-emacs@gnu.org. -Please send bug reports for pretest versions of Emacs, and versions -from the Savannah.gnu.org repository, to emacs-pretest-bugs@gnu.org. +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 to report bugs. (The file `BUGS' in this directory explains how you @@ -40,12 +37,12 @@ oddities of your processor and operating system. It creates the file process of building and installing Emacs. See INSTALL for more detailed information. -The file `configure.in' is the input used by the autoconf program to +The file `configure.ac' is the input used by the autoconf program to construct the `configure' script. Since Emacs has some configuration requirements that autoconf can't meet directly, and for historical -reasons, `configure.in' uses an unholy marriage of custom-baked +reasons, `configure.ac' uses an unholy marriage of custom-baked configuration code and autoconf macros. If you want to rebuild -`configure' from `configure.in', you will need to install a recent +`configure' from `configure.ac', you will need to install a recent version of autoconf and GNU m4. The file `Makefile.in' is a template used by `configure' to create @@ -65,41 +62,47 @@ There are several subdirectories: `leim' holds the library of Emacs input methods, Lisp code and auxiliary data files required to type international characters which can't be directly produced by your keyboard. +`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 with Emacs, like movemail and etags. -`etc' holds miscellaneous architecture-independent data files - Emacs uses, like the tutorial text and the Zippy the Pinhead - quote database. The contents of the `lisp', `leim', `info', - `man', `lispref', and `lispintro' subdirectories are - architecture-independent too. +`etc' holds miscellaneous architecture-independent data files Emacs + uses, like the tutorial text and tool bar images. + The contents of the `lisp', `leim', `info', and `doc' + subdirectories are architecture-independent too. `info' holds the Info documentation tree for Emacs. -`man' holds the source code for the Emacs Manual. If you modify the +`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 - package; you need version 4.6 or later of Texinfo. -`lispref' holds the source code for the Emacs Lisp reference manual. -`lispintro' holds the source code for the Introduction to Programming - in Emacs Lisp manual. - + package; you need a suitably recent version of Texinfo. +`doc/lispref' holds the source code for the Emacs Lisp reference manual. +`doc/lispintro' holds the source code for the Introduction to Programming + in Emacs Lisp manual. `msdos' holds configuration files for compiling Emacs under MSDOG. -`vms' holds instructions and useful files for running Emacs under VMS. +`nextstep' holds instructions and some other files for compiling the + Nextstep port of Emacs, for GNUstep and Mac OS X Cocoa. `nt' holds various command files and documentation files that pertain to building and running Emacs on Windows 9X/ME/NT/2000/XP. -`mac' holds instructions, sources, and other useful files for building - and running Emacs on the Mac. +`test' holds tests for various aspects of Emacs's functionality. + + 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. + + +NOTE ON COPYRIGHT YEARS - Building Emacs on non-Posix platforms requires to install 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. +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. This file is part of GNU Emacs. -GNU Emacs is free software; you can redistribute it and/or modify +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, or (at your option) -any later version. +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 @@ -107,6 +110,4 @@ 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; see the file COPYING. If not, write to the -Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, -Boston, MA 02110-1301, USA. +along with GNU Emacs. If not, see .