[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[AUCTeX-diffs] Changes to auctex/doc/install.texi
From: |
David Kastrup |
Subject: |
[AUCTeX-diffs] Changes to auctex/doc/install.texi |
Date: |
Sun, 01 May 2005 16:36:32 -0400 |
Index: auctex/doc/install.texi
diff -u auctex/doc/install.texi:1.28 auctex/doc/install.texi:1.29
--- auctex/doc/install.texi:1.28 Thu Apr 28 01:44:59 2005
+++ auctex/doc/install.texi Sun May 1 20:36:30 2005
@@ -62,13 +62,13 @@
@itemize @bullet
@item A recent version of @w{Emacs 21}, alternatively @w{XEmacs 21}.
-Support for @w{Emacs 20} has been dropped in favor of getting more
-important work done. For XEmacs, you need at least version 1.84 of the
address@hidden package (released on 01/27/2004) or a sumo tarball
-dated 02/02/2004 or newer for compiling @AUCTeX{} because of non-trivial
-changes in @file{easy-mmode.el}: please use the XEmacs package system
-for upgrading if necessary. The current developers don't have the
-resources for providing backward compatibility to earlier versions.
+Support for @w{Emacs 20} has been dropped. For XEmacs, you need at
+least version 1.84 of the @code{xemacs-base} package (released on
+01/27/2004) or a sumo tarball dated 02/02/2004 or newer for compiling
address@hidden because of non-trivial changes in @file{easy-mmode.el}:
+please use the XEmacs package system for upgrading if necessary. The
+current developers don't have the resources for providing backward
+compatibility to earlier versions.
@item A working @LaTeX{} installation
@@ -78,10 +78,11 @@
@item The @code{texinfo} package
-This is needed for building the documentation. If you don't have this,
-or you have a too old version of it (try building and you'll find out),
-you may download a separate tar file with the prebuilt documentation
-from Savannah and install it over the main unpacked tar archive.
+Strictly speaking, you can get away without it if you are building
+from the distribution tarball, have not modified any files and don't
+need a printed version of the manual: the pregenerated info file is
+included in the tarball.
+
@end itemize
@ignore
@@ -113,6 +114,19 @@
help it out with one of these options:
@table @code
address@hidden address@hidden/usr/local}
+All automatic placements for package components will be chosen from
+sensible existing hierarchies below this. Only if no workable
+placement can be found there, in some cases an alternative search will
+be made in a prefix deduced from a suitable binary.
+
address@hidden/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.
+
@item address@hidden/path/to/emacs}]
If you are using a pretest which isn't in your @code{$PATH}, or
@command{configure} is not finding the right Emacs executable, you can
@@ -123,24 +137,30 @@
the name of the right XEmacs executable can be specified, complete with
path if necessary.
address@hidden address@hidden/dir}
-This tells where to install the lisp files, note that most of @AUCTeX{}
-will be installed in a subdirectory. Normally, this option is
-unnecessary, but may be used if you don't like the directory that
-configure is suggesting.
-
@item address@hidden/dir}
-This tells where to install the XEmacs Package. Again, this option is
-normally unnecessary, but may be used if you don't like the directory
-that configure is suggesting, and you know that XEmacs regards the
-directory you specify as a package directory.
-
-If you are installing @AUCTeX{} for a single user, and you have
-installed no XEmacs packages as that user before, then @command{configure}
-may try to install @AUCTeX{} in the systemwide package directory
-(that it cannot write to), causing installation to fail. In that case,
-a good value for this option is @file{~/.xemacs/xemacs-packages}, as
-XEmacs looks there for per-user packages by default.
+This XEmacs-only option configures the directory for XEmacs packages. A
+typical user-local setting would be @file{~/.xemacs/xemacs-packages}.
+If this directory exists and is below @var{prefix}, it should be
+detected automatically. This will install and activate the package.
+Emacs uses a different installation scheme:
+
address@hidden address@hidden/dir}
+This Emacs-only option specifies the location of the @file{site-lisp}
+directory within @samp{load-path} under which the files will get
+installed (the bulk will get installed in a subdirectory).
address@hidden/configure} should figure this out by itself.
+
address@hidden address@hidden
+This is the name of the startup file. If @var{lispdir} contains a
+subdirectory @file{site-start.d}, @var{startfile} defaults to
address@hidden/auctex.el}, and @file{site-start.el} should
+load it automatically. Please be aware that you must not move the
address@hidden after installation since other files are found
address@hidden to it.
+
address@hidden address@hidden
+This is the directory where the bulk of the package gets located. The
+startfile adds this into @var{load-path}.
@item address@hidden/dir}
You can use this option to specify the directory containing
@@ -154,6 +174,32 @@
describe them here; a short description of each is available, using
@code{--help}.
address@hidden --disable-preview
+This disables configuration and installation of @previewlatex{}. This
+option is not actually recommended. If your Emacs does not support
+images, you should really upgrade to a newer version. Distributors
+should, if possible, refrain from distributing @AUCTeX{} and
address@hidden separately in order to avoid confusion and upgrade
+hassles if users install partial packages on their own.
+
address@hidden --with-preview-startfile
address@hidden --without-texmf-dir
address@hidden --with-texmf-dir
address@hidden --with-tex-dir
address@hidden --with-doc-dir
+
+Those options are explained in
address@hidden rawfile
+the file @file{preview/INSTALL}.
address@hidden ifset
address@hidden rawfile
address@hidden,,,preview-latex,The @previewlatex{} Manual}.
address@hidden ifclear
+
+In a nutshell, if you don't want changes in your @LaTeX{} installation
+and not want to make the @LaTeX{} style files of @previewlatex{}
+available outside of Emacs and nothing installed outside of the Emacs
+tree, then you'll specify @samp{--without-texmf-dir}.
@end table
@node Build/install
@@ -356,7 +402,7 @@
need to do anything at all; the info files should be immediately
visible. However, you might want to set @samp{INFOPATH} anyway, for the
sake of standalone readers outside of XEmacs. (The info files in XEmacs
-are normally in @file{~/.xemacs/xemacs-packages/info}.)
+are normally in something like @file{~/.xemacs/xemacs-packages/info}.)
@ifclear rawfile
@node Installation under MS Windows
- [AUCTeX-diffs] Changes to auctex/doc/install.texi,
David Kastrup <=