diff options
Diffstat (limited to 'elpa/auctex-13.1.3/doc/intro.texi')
-rw-r--r-- | elpa/auctex-13.1.3/doc/intro.texi | 106 |
1 files changed, 106 insertions, 0 deletions
diff --git a/elpa/auctex-13.1.3/doc/intro.texi b/elpa/auctex-13.1.3/doc/intro.texi new file mode 100644 index 0000000..0bbf739 --- /dev/null +++ b/elpa/auctex-13.1.3/doc/intro.texi @@ -0,0 +1,106 @@ +@include macros.texi +@ifset rawfile +@paragraphindent none +This is the README file for the AUCTeX distribution. + +@quotation +Copyright (C) 2008, 2017, 2018 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. +@end quotation + +@chapheading Introduction to @AUCTeX{} +@end ifset + +@ifclear rawfile +@node Summary +@chapter Overview of @AUCTeX{} +@end ifclear + +@ifset rawfile +This file 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 manual, which should be available as an +info file after installation. +@end ifset + +@AUCTeX{} is a comprehensive customizable integrated environment for +writing input files for @TeX{}, @LaTeX{}, @ConTeXt{}, Texinfo, and +doc@TeX{} using Emacs. + +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. + +@AUCTeX{} 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 +@previewlatex{}, 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 +For more information, see further below. +@end ifset + +More detailed information about the features and usage of @AUCTeX{} can +be found in the +@ifset rawfile +@AUCTeX{} manual. You can access it from within Emacs by typing +@kbd{C-h 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 +remainder of this manual. +@end ifclear + +@AUCTeX{} 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 +@url{https://ftp.gnu.org/pub/gnu/auctex/}. + +WWW users may want to check out the @AUCTeX{} page at +@url{https://www.gnu.org/software/auctex/}. + +For comprehensive information about how to install @AUCTeX{} +@ifset rawfile +read the file @file{INSTALL} or @file{INSTALL.windows}, respectively. +@end ifset +@ifclear rawfile +@xref{Installation}, or @ref{Installation under MS Windows}, +respectively. +@end ifclear + +If you are considering upgrading @AUCTeX{}, the recent changes are +described in +@ifset rawfile +the @file{CHANGES} file. +@end ifset +@ifclear rawfile +@ref{Changes}. +@end ifclear + +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 +list for @AUCTeX{}. Articles should be sent to @email{auctex@@gnu.org}. +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 @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}. |