[AUCTeX-diffs] Changes to auctex/doc/intro.texi,v

[Ralf Angeli]

CVSROOT:        /cvsroot/auctex
Module name:    auctex
Changes by:     Ralf Angeli <angeli>    08/10/13 06:38:18

Index: intro.texi
===================================================================
RCS file: /cvsroot/auctex/auctex/doc/intro.texi,v
retrieving revision 1.31
retrieving revision 1.32
diff -u -b -r1.31 -r1.32
--- intro.texi  27 Mar 2006 21:32:23 -0000      1.31
+++ intro.texi  13 Oct 2008 06:38:18 -0000      1.32
@@ -1,69 +1,87 @@
 @include macros.texi
 @ifset rawfile
address@hidden none
+This is the README file for the AUCTeX distribution.
+
address@hidden
+Copyright (C) 2008 Free Software Foundation, Inc.
+
+Copying and distribution of this file, with or without modification, are
+permitted in any medium without royalty provided the copyright notice
+and this notice are preserved.
address@hidden quotation
+
 @chapheading Introduction to @AUCTeX{}
address@hidden
 @end ifset
 
 @ifclear rawfile
address@hidden Introduction, Installation, Copying, top
address@hidden Introduction to @AUCTeX{}
address@hidden Summary
address@hidden Overview of @AUCTeX{}
 @end ifclear
 
 @ifset rawfile
-This file
+This file gives a brief overview of what @AUCTeX{} is.  It is
address@hidden an attempt to document @AUCTeX{}.  Real documentation for
address@hidden is available in the manual, which should be available as an
+info file after installation.
 @end ifset
address@hidden rawfile
-This section of the @AUCTeX{} manual
address@hidden ifclear
-gives a brief overview of what @AUCTeX{} is.  It is @strong{not} an
-attempt to document @AUCTeX{}.  Real documentation for @AUCTeX{} is
-available in the
+
address@hidden is a comprehensive customizable integrated environment for
+writing input files for @TeX{}, @LaTeX{}, @ConTeXt{}, Texinfo, and
address@hidden using Emacs or XEmacs.
+
+It supports you in the insertion of macros, environments, and sectioning
+commands by providing completion alternatives and prompting for
+parameters.  It automatically indents your text as you type it and lets
+you format a whole file at once.  The outlining and folding facilities
+provide you with a focused and clean view of your text.
+
address@hidden lets you process your source files by running @TeX{} and
+related tools (such as output filters, post processors for generating
+indices and bibliographies, and viewers) from inside Emacs.  @AUCTeX{}
+lets you browse through the errors @TeX{} reported, while it moves the
+cursor directly to the reported error, and displays some documentation
+for that particular error.  This will even work when the document is
+spread over several files.
+
+One component of @AUCTeX{} that @LaTeX{} users will find attractive is
address@hidden, a combination of folding and in-source previewing
+that provides true ``What You See Is What You Get'' experience in your
+sourcebuffer, while letting you retain full control.
 @ifset rawfile
-manual, which should be available as an info file after installation.
+For more information, see further below.
 @end ifset
address@hidden rawfile
-rest of the manual.
address@hidden ifclear
-
address@hidden Installation
 
-Read the
+More detailed information about the features and usage of @AUCTeX{} can
+be found in the
 @ifset rawfile
address@hidden or @file{INSTALL.windows} file
address@hidden manual.  You can access it from within Emacs by typing
address@hidden i d m auctex @key{RET}}.  If you prefer the standalone info
+reader, issue the command @code{info auctex} in a terminal.
 @end ifset
 @ifclear rawfile
-section @ref{Installation}, or @ref{Installation under MS Windows},
+remainder of this manual.
 @end ifclear
-respectively for comprehensive information about how to install
address@hidden
 
-The installation routine tries to make the modes provided by @AUCTeX{}
-the default for all supported file types.  If this does not happen in
-your case, add
address@hidden
-(load "auctex.el" nil t t)
address@hidden lisp
-to your init file and consult the section
address@hidden is written entirely in Emacs Lisp, and hence you can easily
+add new features for your own needs.  It is a GNU project and
+distributed under the `GNU General Public License Version 3'.
+
+The most recent version is always available at
address@hidden://ftp.gnu.org/pub/gnu/auctex/}.
+
+WWW users may want to check out the @AUCTeX{} page at
address@hidden://www.gnu.org/software/auctex/}.
+
+For comprehensive information about how to install @AUCTeX{}
 @ifset rawfile
-about loading the package in the @file{INSTALL} file.
+read the file @file{INSTALL} or @file{INSTALL.windows}, respectively.
 @end ifset
 @ifclear rawfile
address@hidden the package}.
address@hidden, or @ref{Installation under MS Windows},
+respectively.
 @end ifclear
 
-If you want to change the modes for which it is operative instead of the
-default, use
address@hidden
address@hidden customize-variable RET TeX-modes RET}
address@hidden example
-
-If you want to remove a preinstalled @AUCTeX{} completely before any of
-its modes have been used,
address@hidden
-(unload-feature 'tex-site)
address@hidden example
-should accomplish that.
-
 If you are considering upgrading @AUCTeX{}, the recent changes are
 described in
 @ifset rawfile
@@ -73,65 +91,8 @@
 @ref{Changes}.
 @end ifclear
 
address@hidden Features
-
address@hidden is a comprehensive customizable integrated environment for
-writing input files for @TeX{}/@LaTeX{}/@ConTeXt{}/Texinfo using Emacs
-or XEmacs.
-
-It lets you process your source files by running @TeX{} and related
-tools (such as output filters, post processors for generating indices
-and bibliographies, and viewers) from inside Emacs.  @AUCTeX{} lets you
-browse through the errors @TeX{} reported, while it moves the cursor
-directly to the reported error, and displays some documentation for that
-particular error.  This will even work when the document is spread over
-several files.
-
-One component of @AUCTeX{} that @LaTeX{} users will find attractive is
address@hidden, a combination of folding and in-source previewing
-that provides true ``What You See Is What You Get'' experience in your
-sourcebuffer, while letting you retain full control.  @previewlatex{}
-comes with its own manual, see @ref{Top, , preview-latex,
-preview-latex, The @previewlatex{} Manual}.
address@hidden rawfile
-For more information, see further below.
address@hidden ifset
-
address@hidden automatically indents your address@hidden', not only as you
-write it --- you can also let it indent and format an entire document.
-It has a special outline feature, which can greatly help you `getting an
-overview' of a document.
-
-Apart from these special features, @AUCTeX{} provides a large range of
-handy Emacs macros, which in several different ways can help you write
-your documents fast and painlessly.
-
-All features of @AUCTeX{} are documented using the GNU Emacs online
-documentation system.  That is, documentation for any command is just
-a key click away!
-
address@hidden is written entirely in Emacs-Lisp, and hence you can easily
-add new features for your own needs.  It has become recently a GNU
-project.  @AUCTeX{} is distributed under the `GNU General Public License
-Version 2'.
-
address@hidden Availability
-
-The most recent version is always available at
-
address@hidden
address@hidden://ftp.gnu.org/pub/gnu/auctex/}
address@hidden flushright
-
-WWW users may want to check out the @AUCTeX{} page at
-
address@hidden
address@hidden://www.gnu.org/software/auctex/}
address@hidden flushright
-
address@hidden Contacts
-
-Various mailing lists exist.
+If you want to discuss @AUCTeX{} with other users or its developers,
+there are several mailing lists you can use.
 
 Send a mail with the subject ``subscribe'' to
 @email{auctex-request@@gnu.org} in order to join the general discussion
@@ -139,8 +100,7 @@
 In a similar way, you can subscribe to the @email{info-auctex@@gnu.org}
 list for just getting important announcements about @AUCTeX{}.  The list
 @email{bug-auctex@@gnu.org} is for bug reports which you should usually
-file with the @kbd{M-x TeX-submit-bug-report RET} command.
-
-If you want to address the developers of @AUCTeX{} themselves with
-technical issues, they can be found on the discussion list
+file with the @kbd{M-x TeX-submit-bug-report @key{RET}} command.  If you
+want to address the developers of @AUCTeX{} themselves with technical
+issues, they can be found on the discussion list
 @email{auctex-devel@@gnu.org}.