Re: [AUCTeX] [RFC] Do not distribute a package for Windows

[Mosè Giordano]

Hi Arash,

2017-01-09 10:39 GMT+01:00 Arash Esbati :
> Mosč Giordano  writes:
>
>> 2017-01-08 19:49 GMT+01:00 Arash Esbati :
>
>>> 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?

Thanks for taking care of this, your changes look good to me.

Side comment.  Since AUCTeX is in GNU ELPA and this repository is
activated by default, the installation procedure could be further
simplified to

M-x package-install RET auctex RET

However, the current procedure makes sure that the latest version of
the package is grabbed (otherwise one may end up with an old one), so
in the end maybe it's better to stick with current procedure.

Let's hope that this will help people that want to install the package!

Bye,
Mosè

___
auctex mailing list
auctex@gnu.org
https://lists.gnu.org/mailman/listinfo/auctex

Re: [AUCTeX] [RFC] Do not distribute a package for Windows

[Arash Esbati]

Mosè Giordano  writes:

> 2017-01-08 19:49 GMT+01:00 Arash Esbati :

>> 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
auctex@gnu.org
https://lists.gnu.org/mailman/listinfo/auctex