[AUCTeX-diffs] Changes to auctex/preview/doc/install.texi

[David Kastrup]

Index: auctex/preview/doc/install.texi
diff -u auctex/preview/doc/install.texi:1.56 
auctex/preview/doc/install.texi:1.57
--- auctex/preview/doc/install.texi:1.56        Sun Apr 10 23:21:44 2005
+++ auctex/preview/doc/install.texi     Mon Apr 11 09:01:31 2005
@@ -179,16 +179,24 @@
 specify the location of its @file{tex-site.el} file so that it can be
 found during compilation.
 
address@hidden address@hidden/address@hidden@var{/dir}
-Both of these options can be used to specify the location to install the
-preview @TeX{} files.  They are not necessary for most @TeX{} installs,
-but may be used if you don't like the directory that configure is
-suggesting.  Using @address@hidden/dir}} you can specify
address@hidden address@hidden/address@hidden
address@hidden preview-install-styles
+This option is used for specifying a @acronym{TDS}-compliant directory
+hierarchy.  Using @address@hidden/dir}} you can specify
 where the @TeX{} @acronym{TDS} directory hierarchy resides, and the
address@hidden files will be installed in 
@address@hidden/dir}/tex/latex/preview/}.
address@hidden files will get installed in
address@hidden@var{/dir}/tex/latex/preview/}.
+
+If you use the @code{--without-texmf-dir} option, the @TeX{}-related
+files will be kept in the Emacs Lisp tree, and at runtime the
address@hidden environment variable will be made to point there.  You
+can install those files into your own @TeX{} tree at some later time
+with @address@hidden preview-install-styles @key{RET}}.
+
address@hidden address@hidden/dir}
 If you want to specify an exact directory for the preview @TeX{} files,
 use @address@hidden/dir}}. In this case, the files will be
-placed in @address@hidden/dir}}.
+placed in @address@hidden/dir}}, and you'll also need the following option:
 
 @item address@hidden/dir}
 This option may be used to specify where the @TeX{} documentation goes.
@@ -283,25 +291,15 @@
 system might be used by more than one user, with different preferences.
 The use of packages should in general not impact performance negatively
 if a user chooses not to employ it, but should be as convenient as
-possible. For example, the policy with regard to @AUCTeX{} typically has
-been to @emph{refrain} from activating it automatically when it is
-installed as a package.  This is reasonable because
-
address@hidden @bullet
address@hidden Emacs comes with a simpler default @TeX{} mode with different
-keybindings.  Some users might prefer that.
address@hidden @AUCTeX{} is activated via @code{(require 'tex-site)}.  Once this
-has happened, it is not possible to get back the original @TeX{} mode.
-A site-wide default would for this reason be hard to override.
address@hidden itemize
-
-In contrast, @previewlatex{} does not affect operation of @AUCTeX{}
-unless you exercise its features.  The recommended invocation (see
-above), also provided in the autogenerated file @file{preview-latex.el},
-will delay loading and activating @previewlatex{} until the first
address@hidden file gets loaded.  For this reason, should a user decide that
-he does not want to get @previewlatex{} loaded and activated, placing
-the line
+possible.
+
address@hidden does not affect operation of @AUCTeX{} apart from using
+a menu and keybindings unless you exercise its features.  The
+recommended invocation (see above), also provided in the autogenerated
+file @file{preview-latex.el}, will delay loading and activating
address@hidden until the first @LaTeX{} file gets loaded.  For this
+reason, should a user decide that he does not want to get
address@hidden loaded and activated, placing the line
 
 @lisp
 (remove-hook 'LaTeX-mode-hook 'LaTeX-preview-setup)
@@ -322,6 +320,12 @@
 the tarball distribution, suitable for recent RedHat systems, that
 should do just that.
 
+If your package is intended as an XEmacs package or to accompany a
+precompiled version of Emacs, you might not know which @TeX{} system
+will be available when @previewlatex{} gets used.  In this case you
+should build using the @code{--without-texmf-dir} option described
+previously.
+
 @node Advice for non-privileged users
 @section Installation for non-privileged users