/[auctex]/auctex/preview/doc/install.texi
ViewVC logotype

Diff of /auctex/preview/doc/install.texi

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.56 by dak, Sun Apr 10 23:21:44 2005 UTC revision 1.57 by dak, Mon Apr 11 09:01:31 2005 UTC
# Line 179  If @AUCTeX{} is installed in a non-stand Line 179  If @AUCTeX{} is installed in a non-stand
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.
# Line 283  served best according to their intention Line 291  served best according to their intention
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)
# Line 322  For @acronym{RPM} files we include a @fi Line 320  For @acronym{RPM} files we include a @fi
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    

Legend:
Removed from v.1.56  
changed lines
  Added in v.1.57

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26