46 |
@end menu |
@end menu |
47 |
@end ifclear |
@end ifclear |
48 |
|
|
49 |
|
First of all: the installation of @previewlatex{} under @w{MS Windows} |
50 |
|
is a bit special, so we are covering this separately in |
51 |
|
@ifset rawfile |
52 |
|
the file @file{INSTALL.windows}. |
53 |
|
@end ifset |
54 |
|
@ifclear rawfile |
55 |
|
@xref{Installation under MS Windows}. |
56 |
|
@end ifclear |
57 |
|
|
58 |
@ifset rawfile |
@ifset rawfile |
59 |
@node Prerequisites |
@node Prerequisites |
60 |
@chapter Prerequisites |
@chapter Prerequisites |
66 |
@end ifclear |
@end ifclear |
67 |
|
|
68 |
@itemize @bullet |
@itemize @bullet |
69 |
@item A recent version of @w{Emacs 21}, alternatively XEmacs |
@item A recent version of Emacs, alternatively XEmacs |
70 |
|
|
71 |
The first version known to work with @previewlatex{} is @w{Emacs 21.1}. |
@w{Emacs 20} is no longer supported, and neither is XEmacs with a |
72 |
Since @previewlatex{} heavily exercises newer features, getting the |
version of @code{xemacs-base} older than 1.84 (released in sumo from |
73 |
latest release is a good idea. Developer versions of @w{Emacs 22} are |
02/02/2004). Using @previewlatex{} requires a version of Emacs compiled |
74 |
mostly preferable to the released versions of @w{Emacs 21} due to |
with image support. This means that @w{Emacs 21} will work only in the |
75 |
performance and handling reasons, and are mandatory for any platform |
version for X11: for Windows and MacOSX, you need to use @w{Emacs 22} |
76 |
except basic X11 toolkits. XEmacs (21.4.15 or later, but not the |
(which is not yet released) or a developer version. Since the developer |
77 |
withdrawn 21.4.16) is supported nominally, but is not particularly |
version is quite stable by now and features four more years of |
78 |
recommended because of handling, image quality and stability reasons. |
development and bugfixes, we recommend its use even for X11-based |
79 |
|
platforms. You can get it here: |
80 |
|
|
81 |
|
@table @b |
82 |
|
@item Windows |
83 |
|
Precompiled versions are available from @uref{http://www.crasseux.com} |
84 |
|
and @uref{http://nqmacs.sf.net}. |
85 |
|
@item MacOSX |
86 |
|
A precompiled version including an installer as well as preinstalled |
87 |
|
versions of @AUCTeX{} and @previewlatex{} is available from |
88 |
|
@uref{http://yaced.sf.net}. A different port (without @AUCTeX{} and |
89 |
|
@previewlatex{}) is |
90 |
|
@uref{http://www.apple.com/downloads/macosx/unix_open_source/carbonemacspackage.html}. |
91 |
|
Some changes and patches attempt to make Emacs behave more in line with |
92 |
|
MacOSX. |
93 |
|
@item Debian Linux |
94 |
|
@uref{http://sadleder.de/debian/} |
95 |
|
@item Fedora Linux |
96 |
|
@uref{http://people.redhat.com/petersen/emacs/} |
97 |
|
@item Self-compiled |
98 |
|
Compiling Emacs yourself requires a C compiler and a number of tools and |
99 |
|
development libraries. Details are beyond the scope of this manual. |
100 |
|
Instructions for checking out the source code can be found at |
101 |
|
@uref{http://savannah.gnu.org/cvs/?group=emacs}. |
102 |
|
@end table |
103 |
|
|
104 |
|
Supporting XEmacs (version 21.4.15, 21.4.17 or later) in a satisfactory |
105 |
|
manner has proven to be difficult, partly because of technical |
106 |
|
shortcomings, partly because fixing problems exposed by @AUCTeX{} is not |
107 |
|
important to XEmacs developers. |
108 |
|
|
|
There is additional information for Windows installations in |
|
|
@ifset rawfile |
|
|
the file @file{INSTALL.windows}. |
|
|
@end ifset |
|
|
@ifclear rawfile |
|
|
@xref{Installation under MS Windows}. |
|
|
@end ifclear |
|
109 |
@ifclear embedded |
@ifclear embedded |
110 |
@item A working @AUCTeX{} installation |
@item A working @AUCTeX{} installation |
111 |
|
|
241 |
|
|
242 |
If you use the @code{--without-texmf-dir} option, the @TeX{}-related |
If you use the @code{--without-texmf-dir} option, the @TeX{}-related |
243 |
files will be kept in the Emacs Lisp tree, and at runtime the |
files will be kept in the Emacs Lisp tree, and at runtime the |
244 |
@var{TEXINPUTS} environment variable will be made to point there. You |
@env{TEXINPUTS} environment variable will be made to point there. You |
245 |
can install those files into your own @TeX{} tree at some later time |
can install those files into your own @TeX{} tree at some later time |
246 |
with @kbd{@key{M-x} preview-install-styles @key{RET}}. |
with @kbd{@key{M-x} preview-install-styles @key{RET}}. |
247 |
|
|
325 |
variety if your Emacs installation provides it. In that case it should |
variety if your Emacs installation provides it. In that case it should |
326 |
be automatically loaded on startup and nothing else needs to be done. |
be automatically loaded on startup and nothing else needs to be done. |
327 |
If not, it should at least have been placed somewhere in your |
If not, it should at least have been placed somewhere in your |
328 |
@var{load-path}. You can then load it with |
@code{load-path}. You can then load it with |
329 |
|
|
330 |
@example |
@example |
331 |
(load "preview-latex.el" nil t t) |
(load "preview-latex.el" nil t t) |