[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[AUCTeX-diffs] Changes to auctex/preview/doc/problems.texi
From: |
David Kastrup |
Subject: |
[AUCTeX-diffs] Changes to auctex/preview/doc/problems.texi |
Date: |
Fri, 20 May 2005 22:27:27 -0400 |
Index: auctex/preview/doc/problems.texi
diff -u auctex/preview/doc/problems.texi:1.49
auctex/preview/doc/problems.texi:1.50
--- auctex/preview/doc/problems.texi:1.49 Sun Apr 10 16:28:59 2005
+++ auctex/preview/doc/problems.texi Sat May 21 02:27:23 2005
@@ -2,7 +2,7 @@
@ifset rawfile
@c documentencoding is used by makeinfo in our --no-headers output.
@documentencoding ISO-8859-1
address@hidden Known problems, Problems with Ghostscript, (dir), (dir)
address@hidden Known problems,,(dir),(dir)
@top Known problems
@end ifset
@@ -18,7 +18,6 @@
* Problems with Ghostscript::
* Font problems with Dvips::
* Emacs problems::
-* AUCTeX prior to 11.0::
* Too small bounding boxes::
* x-symbol interoperation::
* Middle-clicks paste instead of toggling::
@@ -31,12 +30,12 @@
if at all possible.
@ifset rawfile
address@hidden Problems with Ghostscript, Font problems with Dvips, Known
problems , Known problems
address@hidden Problems with Ghostscript
@chapter Problems with Ghostscript
@raisesections
@end ifset
@ifclear rawfile
address@hidden Problems with Ghostscript, Font problems with Dvips, Known
problems , Known problems
address@hidden Problems with Ghostscript
@section Problems with Ghostscript
@end ifclear
@@ -84,7 +83,7 @@
complain to your suppliers if either Emacs or Ghostscript fail to
properly accommodate this format.
address@hidden Font problems with Dvips, Emacs problems, Problems with
Ghostscript, Known problems
address@hidden Font problems with Dvips
@section Font problems with Dvips
Some fonts have been reported to produce wrong characters with
@previewlatex{}. @previewlatex{} calls Dvips by default with the option
@@ -112,34 +111,39 @@
unless your version of Dvips has a long-standing bug in its
implementation fixed (only very recent versions of Dvips have).
address@hidden Emacs problems, AUCTeX prior to 11.0, Font problems with Dvips,
Known problems
address@hidden Emacs problems
@section Emacs problems
@itemize @bullet
address@hidden GNU Emacs versions prior to 21.1
address@hidden GNU Emacs versions
-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
+systems, you'll need at least @w{Emacs 22.1} or one of the developer
+versions leading up to it. Details can be found in
address@hidden rawfile
+in the @file{INSTALL} file.
address@hidden ifset
address@hidden rawfile
address@hidden,,,auctex,the @AUCTeX{} manual}.
address@hidden ifclear
@item Emacsen on Windows operating systems
-As of GNU Emacs 21.2, no image support is available in Emacs under
-Windows. Without images, @previewlatex{} is useless. The current
address@hidden version of Emacs available from
+For @w{Emacs 21}, no image support is available in Emacs under Windows.
+Without images, @previewlatex{} is useless. The current @acronym{CVS}
+version of Emacs available from
@uref{http://savannah.gnu.org/projects/emacs} now supports images
including the @acronym{PNG} format, so @w{Emacs 22} should work out of
-the box once it is released. Another option for Windows users might be
-to try XEmacs. @previewlatex{} has successfully been installed with
-recent @acronym{CVS} versions of @w{GNU Emacs}, and both Cygwin XEmacs
-and the native Windows XEmacs.
+the box once it is released. Precompiled versions are available from
address@hidden://crasseux.com/emacs} and @uref{http://nqmacs.sf.net}.
-See
+For detailed installation instructions for Windows, see
@ifset rawfile
the file @file{INSTALL.windows}
@end ifset
@ifclear rawfile
address@hidden under MS Windows}
address@hidden under MS Windows,,,auctex,the @AUCTeX{} manual}.
@end ifclear
-for detailed installation instructions for this platform.
@item XEmacs
@@ -157,25 +161,20 @@
in the 2002-03-12 sumo tarball.
@end itemize
address@hidden AUCTeX prior to 11.0, Too small bounding boxes, Emacs problems,
Known problems
address@hidden @AUCTeX{} prior to 11.0
-
address@hidden versions up to and including 10.0g have a bug in the
-calculation of the offsets for the start of a region. This affects
address@hidden 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.
-
address@hidden Too small bounding boxes, x-symbol interoperation, AUCTeX prior
to 11.0, Known problems
address@hidden Too small bounding boxes
@section Too small bounding boxes
The bounding box of a preview is determined by the @LaTeX{} package
using the pure @TeX{} bounding boxes. If there is material extending
outside of the @TeX{} box, that material will be missing from the
-preview image. For example this happens for the label-showing boxes from
-the @code{showkeys} package (which has its own variant in
address@hidden). Should this happen to you, try setting
+preview image. This happens for the label-showing boxes from
+the @code{showkeys} package. This particular problem can be
+circumvented by using the @code{showlabels} option of the preview
+package.
+
+In general, you should try to fix the problem in the @TeX{} code, like
+avoiding drawing outside of the picture with PSTricks.
+
+One possible remedy is to set
@code{preview-fast-conversion} to `Off'
@ifset rawfile
(see the manual).
@@ -183,8 +182,8 @@
@ifclear rawfile
(@pxref{The Emacs interface}).
@end ifclear
-The conversion will take slightly more time, but instead
-use the bounding boxes from the @acronym{EPS} files generated by Dvips.
+The conversion will take more time, but will then use the bounding boxes
+from @acronym{EPS} files generated by Dvips.
Dvips generally does not miss things, but it does not understand
PostScript constructs like @code{\resizebox} or @code{\rotate} commands,
@@ -198,9 +197,9 @@
@end ifclear
which will tag the corners of the included @TeX{} box. This will mostly
be convenient for @emph{pure} PostScript stuff like that created by
-PStricks, which Dvips would otherwise reserve no space for.
+PSTricks, which Dvips would otherwise reserve no space for.
address@hidden x-symbol interoperation, Middle-clicks paste instead of
toggling, Too small bounding boxes, Known problems
address@hidden x-symbol interoperation
@section x-symbol interoperation
Thanks to the work of Christoph Wedler, starting with version
@@ -215,8 +214,9 @@
few input methods handy especially for dealing with math. Take a look at
@uref{http://x-symbol.sourceforge.net}.
-x-symbol versions up to 4.5.1-beta at least require an 8bit-clean LaTeX
-implementation (with regard to error messages) for cooperation with
+x-symbol versions up to 4.5.1-beta at least require an 8bit-clean @TeX{}
+implementation (meaning that its terminal output should not use
address@hidden escape sequences) for cooperation with
@previewlatex{}. Later versions may get along without it, like
@previewlatex{} does now.
@@ -226,12 +226,13 @@
@code{LaTeX-command-style} by replacing the command @code{latex} with
@code{latex -translate-file=cp8bit}.
address@hidden Middle-clicks paste instead of toggling, , x-symbol
interoperation, Known problems
address@hidden Middle-clicks paste instead of toggling
@section Middle-clicks paste instead of toggling
This is probably the fault of your favorite package. @file{flyspell.el}
and @file{mouse-drag.el} are known to be affected in versions before
address@hidden 21.3}. Upgrade to the most recent version.
address@hidden 21.3}. Upgrade to the most recent version. What version of
+XEmacs might contain the fixes is unknown.
@file{isearch.el} also shows this effect while searches are in progress,
but the code is such a complicated mess that no patch is in sight.
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [AUCTeX-diffs] Changes to auctex/preview/doc/problems.texi,
David Kastrup <=