[elpa] externals/auctex 12f7a21 18/67: Add suggestions for non-privileged installation

[Tassilo Horn]

branch: externals/auctex
commit 12f7a21de2cbdb650efecd839f3a5727e4228bb4
Author: Ikumi Keita <address@hidden>
Commit: Ikumi Keita <address@hidden>

    Add suggestions for non-privileged installation
    
    * doc/install.texi (Configure): Reorganize a paragraph and add @ref's.
    (Installation for non-privileged users): Add paragraphs to suggest to
    supply options "--with-lispdir" and "--with-texmf-dir" etc. to
    configure when installing AUCTeX under the user's home directory.
    ; (Prerequisites): Wrap the word "OS" with @acronym.
    ; * doc/auctex.texi (Adding Support for Macros): Fix typo.
    ; * doc/wininstall.texi (Detailed Installation Instructions): Fix path.
---
 doc/auctex.texi     |  2 +-
 doc/install.texi    | 40 +++++++++++++++++++++++++++++++++-------
 doc/wininstall.texi |  4 ++--
 3 files changed, 36 insertions(+), 10 deletions(-)

diff --git a/doc/auctex.texi b/doc/auctex.texi
index 96161b5..f23e1a1 100644
--- a/doc/auctex.texi
+++ b/doc/auctex.texi
@@ -5076,7 +5076,7 @@ point inside braces.  Otherwise, each argument of this 
function should
 match an argument of the @TeX{} macro.  What is done depends on the argument
 type.
 
-If a macro is defined multiple times, @AUCTeX{} will chose the one with
+If a macro is defined multiple times, @AUCTeX{} will choose the one with
 the longest definition (i.e. the one with the most arguments).
 
 Thus, to overwrite
diff --git a/doc/install.texi b/doc/install.texi
index d45d1d2..e39fd52 100644
--- a/doc/install.texi
+++ b/doc/install.texi
@@ -124,10 +124,10 @@ should work fine (version 7.0 and newer).
 @item GNU make
 
 Recent @AUCTeX{} uses GNU make specific capabilities in the Makefiles.
-If your OS's default @command{make} command is not GNU make, you have to
-obtain it in order to build @AUCTeX{} by yourself.  GNU make is
-sometimes provided under the name @command{gmake} in your OS's binary
-package system.
+If your @acronym{OS}'s default @command{make} command is not GNU make,
+you have to obtain it in order to build @AUCTeX{} by yourself.  GNU make
+is sometimes provided under the name @command{gmake} in your
address@hidden's binary package system.
 
 @item The @code{texinfo} package
 
@@ -178,9 +178,13 @@ binary.
 @file{/usr/local} is the default @var{prefix}, intended to be suitable
 for a site-wide installation.  If you are packaging this as an
 operating system component for distribution, the setting @file{/usr}
-will probably be the right choice.  If you are planning to install the
-package as a single non-priviledged user, you will typically set
address@hidden to your home directory.
+will probably be the right choice.  See @ref{Advice for package
+providers} for detail.
+
+If you are planning to install the package as a single non-priviledged
+user, you will typically set @var{prefix} to your home directory.
+Consult @ref{Advice for non-privileged users} for addtional
+instructions.
 
 @item address@hidden/path/to/emacs}]
 If you are using a pretest which isn't in your @code{$PATH}, or
@@ -434,10 +438,32 @@ directory.  In that way, resulting binaries will be 
installed under the
 personal software, since the prefix argument is supported by most
 @file{configure} scripts.
 
+You often need to specify @option{--with-lispdir} option as well.
+If you haven't installed Emacs under your home directory and use Emacs
+installed in system directories, the @file{configure} script might not
+be able to figure out suitable place to install lisp files under your
+home directory.  In that case, the @file{configure} script would
+silently choose, by default, the @file{site-lisp} directory within
address@hidden for the place, where administration privileges are
+usually required to put relevant files.  Thus you will have to tell
+the @file{configure} script explicitly where to put those files by,
+e.g., @address@hidden/home/myself/share/emacs/site-lisp}}.
+
 You'll have to add something like
 @file{/home/myself/share/emacs/site-lisp} to your @code{load-path}
 variable, if it isn't there already.
 
+In addition, you will have to tell @file{configure} script where to
+install @TeX{}-related files such as @file{preview.sty} if
address@hidden isn't disabled.  It is enough to specify
address@hidden@file{$HOME/texmf}} for most typical cases, but
+you have to create the direcotry @file{$HOME/texmf} in advance if it
+doesn't exist.  If this prescription doesn't work, consider using one or
+more of the options @address@hidden/dir}},
address@hidden, @address@hidden/dir}} and
address@hidden@var{/dir}}.  See @ref{Configure} for detail of
+these options.
+
 Now here is another thing to ponder: perhaps you want to make it easy
 for other users to share parts of your personal Emacs configuration.  In
 general, you can do this by writing @samp{~myself/} anywhere where you
diff --git a/doc/wininstall.texi b/doc/wininstall.texi
index f91f0ef..5289ab6 100644
--- a/doc/wininstall.texi
+++ b/doc/wininstall.texi
@@ -320,8 +320,8 @@ You can always use
 in order to customize more stuff, or use the @samp{Customize} menu.
 
 @item
-Load @file{preview/circ.tex} into Emacs and see if you get the
address@hidden menu. Try using it to @LaTeX{} the file.
+Load @file{circ.tex} into Emacs and see if you get the @samp{Command}
+menu. Try using it to @LaTeX{} the file.
 
 @item
 Check whether the @samp{Preview} menu is available in this file.  Use it