2 |
@ifset rawfile |
@ifset rawfile |
3 |
@c documentencoding is used by makeinfo in our --no-headers output. |
@c documentencoding is used by makeinfo in our --no-headers output. |
4 |
@documentencoding ISO-8859-1 |
@documentencoding ISO-8859-1 |
5 |
@node Known problems, Problems with Ghostscript, (dir), (dir) |
@node Known problems,,(dir),(dir) |
6 |
@top Known problems |
@top Known problems |
7 |
|
|
8 |
@end ifset |
@end ifset |
18 |
* Problems with Ghostscript:: |
* Problems with Ghostscript:: |
19 |
* Font problems with Dvips:: |
* Font problems with Dvips:: |
20 |
* Emacs problems:: |
* Emacs problems:: |
|
* AUCTeX prior to 11.0:: |
|
21 |
* Too small bounding boxes:: |
* Too small bounding boxes:: |
22 |
* x-symbol interoperation:: |
* x-symbol interoperation:: |
23 |
* Middle-clicks paste instead of toggling:: |
* Middle-clicks paste instead of toggling:: |
30 |
if at all possible. |
if at all possible. |
31 |
|
|
32 |
@ifset rawfile |
@ifset rawfile |
33 |
@node Problems with Ghostscript, Font problems with Dvips, Known problems , Known problems |
@node Problems with Ghostscript |
34 |
@chapter Problems with Ghostscript |
@chapter Problems with Ghostscript |
35 |
@raisesections |
@raisesections |
36 |
@end ifset |
@end ifset |
37 |
@ifclear rawfile |
@ifclear rawfile |
38 |
@node Problems with Ghostscript, Font problems with Dvips, Known problems , Known problems |
@node Problems with Ghostscript |
39 |
@section Problems with Ghostscript |
@section Problems with Ghostscript |
40 |
@end ifclear |
@end ifclear |
41 |
|
|
83 |
complain to your suppliers if either Emacs or Ghostscript fail to |
complain to your suppliers if either Emacs or Ghostscript fail to |
84 |
properly accommodate this format. |
properly accommodate this format. |
85 |
|
|
86 |
@node Font problems with Dvips, Emacs problems, Problems with Ghostscript, Known problems |
@node Font problems with Dvips |
87 |
@section Font problems with Dvips |
@section Font problems with Dvips |
88 |
Some fonts have been reported to produce wrong characters with |
Some fonts have been reported to produce wrong characters with |
89 |
@previewlatex{}. @previewlatex{} calls Dvips by default with the option |
@previewlatex{}. @previewlatex{} calls Dvips by default with the option |
111 |
unless your version of Dvips has a long-standing bug in its |
unless your version of Dvips has a long-standing bug in its |
112 |
implementation fixed (only very recent versions of Dvips have). |
implementation fixed (only very recent versions of Dvips have). |
113 |
|
|
114 |
@node Emacs problems, AUCTeX prior to 11.0, Font problems with Dvips, Known problems |
@node Emacs problems |
115 |
@section Emacs problems |
@section Emacs problems |
116 |
|
|
117 |
@itemize @bullet |
@itemize @bullet |
118 |
@item GNU Emacs versions prior to 21.1 |
@item GNU Emacs versions |
119 |
|
|
120 |
Don't use them. 20.x will not work, 21.0.x were prereleases, anyway. |
Don't use Emacsen older than 21.3 on X11-based systems. On most other |
121 |
|
systems, you'll need at least @w{Emacs 22.1} or one of the developer |
122 |
|
versions leading up to it. Details can be found in |
123 |
|
@ifset rawfile |
124 |
|
in the @file{INSTALL} file. |
125 |
|
@end ifset |
126 |
|
@ifclear rawfile |
127 |
|
@ref{Prerequisites,,,auctex,the @AUCTeX{} manual}. |
128 |
|
@end ifclear |
129 |
|
|
130 |
@item Emacsen on Windows operating systems |
@item Emacsen on Windows operating systems |
131 |
|
|
132 |
As of GNU Emacs 21.2, no image support is available in Emacs under |
For @w{Emacs 21}, no image support is available in Emacs under Windows. |
133 |
Windows. Without images, @previewlatex{} is useless. The current |
Without images, @previewlatex{} is useless. The current @acronym{CVS} |
134 |
@acronym{CVS} version of Emacs available from |
version of Emacs available from |
135 |
@uref{http://savannah.gnu.org/projects/emacs} now supports images |
@uref{http://savannah.gnu.org/projects/emacs} now supports images |
136 |
including the @acronym{PNG} format, so @w{Emacs 22} should work out of |
including the @acronym{PNG} format, so @w{Emacs 22} should work out of |
137 |
the box once it is released. Another option for Windows users might be |
the box once it is released. Precompiled versions are available from |
138 |
to try XEmacs. @previewlatex{} has successfully been installed with |
@uref{http://crasseux.com/emacs} and @uref{http://nqmacs.sf.net}. |
|
recent @acronym{CVS} versions of @w{GNU Emacs}, and both Cygwin XEmacs |
|
|
and the native Windows XEmacs. |
|
139 |
|
|
140 |
See |
For detailed installation instructions for Windows, see |
141 |
@ifset rawfile |
@ifset rawfile |
142 |
the file @file{INSTALL.windows} |
the file @file{INSTALL.windows} |
143 |
@end ifset |
@end ifset |
144 |
@ifclear rawfile |
@ifclear rawfile |
145 |
@ref{Installation under MS Windows} |
@ref{Installation under MS Windows,,,auctex,the @AUCTeX{} manual}. |
146 |
@end ifclear |
@end ifclear |
|
for detailed installation instructions for this platform. |
|
147 |
|
|
148 |
@item XEmacs |
@item XEmacs |
149 |
|
|
161 |
in the 2002-03-12 sumo tarball. |
in the 2002-03-12 sumo tarball. |
162 |
@end itemize |
@end itemize |
163 |
|
|
164 |
@node AUCTeX prior to 11.0, Too small bounding boxes, Emacs problems, Known problems |
@node Too small bounding boxes |
|
@section @AUCTeX{} prior to 11.0 |
|
|
|
|
|
@AUCTeX{} versions up to and including 10.0g have a bug in the |
|
|
calculation of the offsets for the start of a region. This affects |
|
|
@kbd{C-c C-r} commands where the start of the region does not lie on the |
|
|
start of a line. It also affects regeneration of single previews. To |
|
|
correct this, apply the patch in @file{patches/auctex-10.patch}. It |
|
|
might be more prudent to install a more recent version of @AUCTeX{}, |
|
|
however. |
|
|
|
|
|
@node Too small bounding boxes, x-symbol interoperation, AUCTeX prior to 11.0, Known problems |
|
165 |
@section Too small bounding boxes |
@section Too small bounding boxes |
166 |
The bounding box of a preview is determined by the @LaTeX{} package |
The bounding box of a preview is determined by the @LaTeX{} package |
167 |
using the pure @TeX{} bounding boxes. If there is material extending |
using the pure @TeX{} bounding boxes. If there is material extending |
168 |
outside of the @TeX{} box, that material will be missing from the |
outside of the @TeX{} box, that material will be missing from the |
169 |
preview image. For example this happens for the label-showing boxes from |
preview image. This happens for the label-showing boxes from |
170 |
the @code{showkeys} package (which has its own variant in |
the @code{showkeys} package. This particular problem can be |
171 |
@previewlatex{}). Should this happen to you, try setting |
circumvented by using the @code{showlabels} option of the preview |
172 |
|
package. |
173 |
|
|
174 |
|
In general, you should try to fix the problem in the @TeX{} code, like |
175 |
|
avoiding drawing outside of the picture with PSTricks. |
176 |
|
|
177 |
|
One possible remedy is to set |
178 |
@code{preview-fast-conversion} to `Off' |
@code{preview-fast-conversion} to `Off' |
179 |
@ifset rawfile |
@ifset rawfile |
180 |
(see the manual). |
(see the manual). |
182 |
@ifclear rawfile |
@ifclear rawfile |
183 |
(@pxref{The Emacs interface}). |
(@pxref{The Emacs interface}). |
184 |
@end ifclear |
@end ifclear |
185 |
The conversion will take slightly more time, but instead |
The conversion will take more time, but will then use the bounding boxes |
186 |
use the bounding boxes from the @acronym{EPS} files generated by Dvips. |
from @acronym{EPS} files generated by Dvips. |
187 |
|
|
188 |
Dvips generally does not miss things, but it does not understand |
Dvips generally does not miss things, but it does not understand |
189 |
PostScript constructs like @code{\resizebox} or @code{\rotate} commands, |
PostScript constructs like @code{\resizebox} or @code{\rotate} commands, |
197 |
@end ifclear |
@end ifclear |
198 |
which will tag the corners of the included @TeX{} box. This will mostly |
which will tag the corners of the included @TeX{} box. This will mostly |
199 |
be convenient for @emph{pure} PostScript stuff like that created by |
be convenient for @emph{pure} PostScript stuff like that created by |
200 |
PStricks, which Dvips would otherwise reserve no space for. |
PSTricks, which Dvips would otherwise reserve no space for. |
201 |
|
|
202 |
@node x-symbol interoperation, Middle-clicks paste instead of toggling, Too small bounding boxes, Known problems |
@node x-symbol interoperation |
203 |
@section x-symbol interoperation |
@section x-symbol interoperation |
204 |
|
|
205 |
Thanks to the work of Christoph Wedler, starting with version |
Thanks to the work of Christoph Wedler, starting with version |
214 |
few input methods handy especially for dealing with math. Take a look at |
few input methods handy especially for dealing with math. Take a look at |
215 |
@uref{http://x-symbol.sourceforge.net}. |
@uref{http://x-symbol.sourceforge.net}. |
216 |
|
|
217 |
x-symbol versions up to 4.5.1-beta at least require an 8bit-clean LaTeX |
x-symbol versions up to 4.5.1-beta at least require an 8bit-clean @TeX{} |
218 |
implementation (with regard to error messages) for cooperation with |
implementation (meaning that its terminal output should not use |
219 |
|
@samp{^^}-started escape sequences) for cooperation with |
220 |
@previewlatex{}. Later versions may get along without it, like |
@previewlatex{}. Later versions may get along without it, like |
221 |
@previewlatex{} does now. |
@previewlatex{} does now. |
222 |
|
|
226 |
@code{LaTeX-command-style} by replacing the command @code{latex} with |
@code{LaTeX-command-style} by replacing the command @code{latex} with |
227 |
@code{latex -translate-file=cp8bit}. |
@code{latex -translate-file=cp8bit}. |
228 |
|
|
229 |
@node Middle-clicks paste instead of toggling, , x-symbol interoperation, Known problems |
@node Middle-clicks paste instead of toggling |
230 |
@section Middle-clicks paste instead of toggling |
@section Middle-clicks paste instead of toggling |
231 |
|
|
232 |
This is probably the fault of your favorite package. @file{flyspell.el} |
This is probably the fault of your favorite package. @file{flyspell.el} |
233 |
and @file{mouse-drag.el} are known to be affected in versions before |
and @file{mouse-drag.el} are known to be affected in versions before |
234 |
@w{Emacs 21.3}. Upgrade to the most recent version. |
@w{Emacs 21.3}. Upgrade to the most recent version. What version of |
235 |
|
XEmacs might contain the fixes is unknown. |
236 |
|
|
237 |
@file{isearch.el} also shows this effect while searches are in progress, |
@file{isearch.el} also shows this effect while searches are in progress, |
238 |
but the code is such a complicated mess that no patch is in sight. |
but the code is such a complicated mess that no patch is in sight. |