179 |
specify the location of its @file{tex-site.el} file so that it can be |
specify the location of its @file{tex-site.el} file so that it can be |
180 |
found during compilation. |
found during compilation. |
181 |
|
|
182 |
@item --with-texmf-dir=@var{/dir}@*--with-tex-dir=@var{/dir} |
@item --with-texmf-dir=@var{/dir}@*--without-texmf-dir |
183 |
Both of these options can be used to specify the location to install the |
@cindex preview-install-styles |
184 |
preview @TeX{} files. They are not necessary for most @TeX{} installs, |
This option is used for specifying a @acronym{TDS}-compliant directory |
185 |
but may be used if you don't like the directory that configure is |
hierarchy. Using @code{--with-texmf-dir=@var{/dir}} you can specify |
|
suggesting. Using @code{--with-texmf-dir=@var{/dir}} you can specify |
|
186 |
where the @TeX{} @acronym{TDS} directory hierarchy resides, and the |
where the @TeX{} @acronym{TDS} directory hierarchy resides, and the |
187 |
@TeX{} files will be installed in @file{@var{/dir}/tex/latex/preview/}. |
@TeX{} files will get installed in |
188 |
|
@file{@var{/dir}/tex/latex/preview/}. |
189 |
|
|
190 |
|
If you use the @code{--without-texmf-dir} option, the @TeX{}-related |
191 |
|
files will be kept in the Emacs Lisp tree, and at runtime the |
192 |
|
@var{TEXINPUTS} environment variable will be made to point there. You |
193 |
|
can install those files into your own @TeX{} tree at some later time |
194 |
|
with @kbd{@key{M-x} preview-install-styles @key{RET}}. |
195 |
|
|
196 |
|
@item --with-tex-dir=@var{/dir} |
197 |
If you want to specify an exact directory for the preview @TeX{} files, |
If you want to specify an exact directory for the preview @TeX{} files, |
198 |
use @code{--with-tex-dir=@var{/dir}}. In this case, the files will be |
use @code{--with-tex-dir=@var{/dir}}. In this case, the files will be |
199 |
placed in @file{@var{/dir}}. |
placed in @file{@var{/dir}}, and you'll also need the following option: |
200 |
|
|
201 |
@item --with-doc-dir=@var{/dir} |
@item --with-doc-dir=@var{/dir} |
202 |
This option may be used to specify where the @TeX{} documentation goes. |
This option may be used to specify where the @TeX{} documentation goes. |
291 |
system might be used by more than one user, with different preferences. |
system might be used by more than one user, with different preferences. |
292 |
The use of packages should in general not impact performance negatively |
The use of packages should in general not impact performance negatively |
293 |
if a user chooses not to employ it, but should be as convenient as |
if a user chooses not to employ it, but should be as convenient as |
294 |
possible. For example, the policy with regard to @AUCTeX{} typically has |
possible. |
295 |
been to @emph{refrain} from activating it automatically when it is |
|
296 |
installed as a package. This is reasonable because |
@previewlatex{} does not affect operation of @AUCTeX{} apart from using |
297 |
|
a menu and keybindings unless you exercise its features. The |
298 |
@itemize @bullet |
recommended invocation (see above), also provided in the autogenerated |
299 |
@item Emacs comes with a simpler default @TeX{} mode with different |
file @file{preview-latex.el}, will delay loading and activating |
300 |
keybindings. Some users might prefer that. |
@previewlatex{} until the first @LaTeX{} file gets loaded. For this |
301 |
@item @AUCTeX{} is activated via @code{(require 'tex-site)}. Once this |
reason, should a user decide that he does not want to get |
302 |
has happened, it is not possible to get back the original @TeX{} mode. |
@previewlatex{} loaded and activated, placing the line |
|
A site-wide default would for this reason be hard to override. |
|
|
@end 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 |
|
|
@LaTeX{} file gets loaded. For this reason, should a user decide that |
|
|
he does not want to get @previewlatex{} loaded and activated, placing |
|
|
the line |
|
303 |
|
|
304 |
@lisp |
@lisp |
305 |
(remove-hook 'LaTeX-mode-hook 'LaTeX-preview-setup) |
(remove-hook 'LaTeX-mode-hook 'LaTeX-preview-setup) |
320 |
the tarball distribution, suitable for recent RedHat systems, that |
the tarball distribution, suitable for recent RedHat systems, that |
321 |
should do just that. |
should do just that. |
322 |
|
|
323 |
|
If your package is intended as an XEmacs package or to accompany a |
324 |
|
precompiled version of Emacs, you might not know which @TeX{} system |
325 |
|
will be available when @previewlatex{} gets used. In this case you |
326 |
|
should build using the @code{--without-texmf-dir} option described |
327 |
|
previously. |
328 |
|
|
329 |
@node Advice for non-privileged users |
@node Advice for non-privileged users |
330 |
@section Installation for non-privileged users |
@section Installation for non-privileged users |
331 |
|
|