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

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

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

revision 1.49 by angeli, Sun Apr 10 16:28:59 2005 UTC revision 1.50 by dak, Sat May 21 02:27:23 2005 UTC
# Line 2  Line 2 
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
# Line 18  newer versions of the problematic softwa Line 18  newer versions of the problematic softwa
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::  
# Line 31  information interesting to us and send i Line 30  information interesting to us and send i
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    
# Line 84  permanent time scale, the best choice is Line 83  permanent time scale, the best choice is
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
# Line 112  rendered as @samp{@pounds{}} (British Po Line 111  rendered as @samp{@pounds{}} (British Po
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    
# Line 157  version 1.81 or above of the @file{edit- Line 161  version 1.81 or above of the @file{edit-
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).
# Line 183  the @code{showkeys} package (which has i Line 182  the @code{showkeys} package (which has i
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,
# Line 198  the @code{psfixbb} package option to pre Line 197  the @code{psfixbb} package option to pre
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
# Line 215  tokens and subscripts to a more readable Line 214  tokens and subscripts to a more readable
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    
# Line 226  environment or, as a last resort, custom Line 226  environment or, as a last resort, custom
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.

Legend:
Removed from v.1.49  
changed lines
  Added in v.1.50

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