Mosè Giordano <[email protected]> writes:
> 2017-01-08 19:49 GMT+01:00 Arash Esbati <[email protected]>:
>> Before I write some text: If I get it right, one can have
>> (package-initialize) in his .emacs and then the sentence from "1.3 Quick
>> Start" does not apply anymore. Is this correct?
>
> One must *not* manually load AUCTeX when it's installed via ELPA, no
> matter if `package-initialize' is called or not. Indeed, this is
> sometimes another source of ambiguity for newcomers.
Thanks for the clarification. What do you think about the change
attached?
diff --git a/doc/install.texi b/doc/install.texi
index d814cca..dfe3126 100644
--- a/doc/install.texi
+++ b/doc/install.texi
@@ -12,11 +12,17 @@
@chapter Installing @AUCTeX{}
@end ifclear
-The simplest way of installing @AUCTeX{} is by using the Emacs package
-manager integrated in Emacs 24 and greater (@acronym{ELPA}). Simply do
-@kbd{M-x package-list-packages RET}, mark the auctex package for
-installation with @kbd{i}, and hit @kbd{x} to execute the installation
-procedure. That's all.
+The modern and strongly recommended way of installing @AUCTeX{} is by
+using the Emacs package manager integrated in Emacs 24 and greater
+(@acronym{ELPA}). Simply do @kbd{M-x list-packages RET}, mark the
+auctex package for installation with @kbd{i}, and hit @kbd{x} to execute
+the installation procedure. That's all. This installation procedure
+has several advantages. Besides being platform and @acronym{OS}
+independent, you will receive intermediate releases between major
+@AUCTeX{} releases conveniently. For past @acronym{ELPA} releases, see
+@url{https://elpa.gnu.org/packages/auctex.html}. Once the installation
+is completed, you can skip the rest of this section and proceed to
+@ref{Quick Start}.
The remainder of this section is about installing @AUCTeX{} from a
release tarball or from a checkout of the @AUCTeX{} repository.
diff --git a/doc/quickstart.texi b/doc/quickstart.texi
index b382018..20d89c3 100644
--- a/doc/quickstart.texi
+++ b/doc/quickstart.texi
@@ -18,7 +18,8 @@ as well, @ref{Installation}. We also assume that you are familiar with
the way keystrokes are written in Emacs manuals. If not, have a look at
the Emacs Tutorial in the Help menu.
-If @AUCTeX{} is installed, you might still need to activate it, by
+If @AUCTeX{} is installed in any other way than from the Emacs package
+manager (@acronym{ELPA}), you might still need to activate it, by
inserting
@lisp
@@ -27,10 +28,16 @@ inserting
in your user init file.@footnote{This usually is a file in your home
directory called @file{.emacs} if you are utilizing GNU Emacs or
-@file{.xemacs/init.el} if you are using XEmacs.} If you've installed
-@AUCTeX{} from the Emacs package manager (ELPA), you must not have this
-line in your user init file. The installation procedure already cares
-about loading @AUCTeX{} correctly.
+@file{.xemacs/init.el} if you are using XEmacs.}
+
+If @AUCTeX{} is installed from @acronym{ELPA}, the installation
+procedure already cares about loading @AUCTeX{} correctly and you
+@strong{must not} have the line above in your init file. Note that this
+also applies if you have the following line in your init file
+
+@lisp
+(package-initialize)
+@end lisp
In order to get support for many of the @LaTeX{} packages you will use
in your documents, you should enable document parsing as well, which can
Best, Arash
_______________________________________________
auctex mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/auctex
