monnier pushed a commit to branch externals/auctex in repository elpa. commit 01f50af361c432aa8bbb9c39ebf44b6ad8162168 Author: Tassilo Horn <t...@gnu.org> Date: Wed Jun 26 12:16:47 2013 +0200
Remove warnings and docs for ancient preview problems. * doc/preview-problems.texi: Rename "Known problems" section to "Known problems with preview-latex" in rawfile export. Delete sections "Problems with Ghostscript" and "Emacs problems" because those are basically ruled out when using the prerequisites documented in the manual. * doc/install.texi: Don't link to ghostscript specific preview-latex problems section because that has been removed. * doc/Makefile.in (DISTTEXTS, ../PROBLEMS.preview): Rename PROBLEMS to PROBLEMS.preview since it only deals with preview-latex problems. * Makefile.in (DISTTEXTS): Use PROBLEMS.preview instead of PROBLEMS. * preview/Makefile.in (use-hint): Don't warn about problems with overly obsolete packages. --- .gitignore | 4 +- ChangeLog | 18 +++++++ Makefile.in | 2 +- doc/Makefile.in | 4 +- doc/install.texi | 9 +--- doc/preview-problems.texi | 108 ++------------------------------------------ preview/ChangeLog | 5 ++ preview/Makefile.in | 6 +-- 8 files changed, 36 insertions(+), 120 deletions(-) diff --git a/.gitignore b/.gitignore index c59a184..d663413 100644 --- a/.gitignore +++ b/.gitignore @@ -39,4 +39,6 @@ preview/latex/prshowbox.def preview/latex/prshowlabels.def preview/latex/prtightpage.def preview/latex/prtracingall.def -preview/preview-latex.el \ No newline at end of file +preview/preview-latex.el +PROBLEMS.preview + diff --git a/ChangeLog b/ChangeLog index c97ae75..1e9ac5c 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,21 @@ +2013-06-26 Tassilo Horn <t...@gnu.org> + + * doc/preview-problems.texi: Rename "Known problems" section to + "Known problems with preview-latex" in rawfile export. Delete + sections "Problems with Ghostscript" and "Emacs problems" because + those are basically ruled out when using the prerequisites + documented in the manual. + + * doc/install.texi: Don't link to ghostscript specific + preview-latex problems section because that has been removed. + + * doc/Makefile.in (DISTTEXTS, ../PROBLEMS.preview): Rename + PROBLEMS to PROBLEMS.preview since it only deals with + preview-latex problems. + + * Makefile.in (DISTTEXTS): Use PROBLEMS.preview instead of + PROBLEMS. + 2013-06-24 Tassilo Horn <t...@gnu.org> * doc/Makefile.in (DISTTEXTS): Add ../PROBLEMS. diff --git a/Makefile.in b/Makefile.in index 3009b55..e2d7e32 100644 --- a/Makefile.in +++ b/Makefile.in @@ -137,7 +137,7 @@ STYLEELC = $(STYLESRC:.el=.elc) CLEANFILES = $(AUCELC) $(STYLEELC) $(MULEELC) DISTCLEANFILES = Makefile tex-site.el tex-site.el.out auctex.el \ auto-loads.el config.* -DISTTEXTS = FAQ INSTALL INSTALL.windows README TODO PROBLEMS +DISTTEXTS = FAQ INSTALL INSTALL.windows README TODO PROBLEMS.preview NOSEARCH = style/.nosearch diff --git a/doc/Makefile.in b/doc/Makefile.in index ceb956c..40e40ce 100644 --- a/doc/Makefile.in +++ b/doc/Makefile.in @@ -52,7 +52,7 @@ PREVIEWTEXIFILES = copying.texi preview-faq.texi macros.texi \ preview-dtxdoc.texi preview-latex.texi preview-problems.texi \ preview-readme.texi preview-todo.texi version.texi DISTTEXTS = ../README ../INSTALL ../TODO ../INSTALL.windows ../FAQ ../CHANGES \ - ../PROBLEMS + ../PROBLEMS.preview all: dist @@ -181,7 +181,7 @@ install-preview: preview-latex.info $(MAKEINFO) $(MAKEINFO_PLAIN) faq.texi --output $@ $(MAKEINFO) $(MAKEINFO_PLAIN) --number-sections preview-faq.texi --output - >> $@ -../PROBLEMS: preview-problems.texi macros.texi +../PROBLEMS.preview: preview-problems.texi macros.texi $(MAKEINFO) $(MAKEINFO_PLAIN) --number-sections preview-problems.texi --output $@ # clean diff --git a/doc/install.texi b/doc/install.texi index dd3eb5e..e5e5e0a 100644 --- a/doc/install.texi +++ b/doc/install.texi @@ -125,14 +125,7 @@ The default configuration of @AUCTeX{} is tailored for te@TeX{} or This is needed for operation of @previewlatex{} in both @acronym{DVI} and @acronym{PDF} mode. Most versions of Ghostscript nowadays in use -should work fine (version 7.0 and newer). If you encounter problems, -check -@ifset rawfile -the @file{PROBLEMS} file. -@end ifset -@ifclear rawfile -@ref{Problems with Ghostscript,,,preview-latex,the @previewlatex{} manual}. -@end ifclear +should work fine (version 7.0 and newer). @item The @code{texinfo} package diff --git a/doc/preview-problems.texi b/doc/preview-problems.texi index a039351..d01ca8e 100644 --- a/doc/preview-problems.texi +++ b/doc/preview-problems.texi @@ -3,7 +3,7 @@ @c documentencoding is used by makeinfo in our --no-headers output. @documentencoding ISO-8859-1 @node Known problems,,(dir),(dir) -@top Known problems +@top Known problems with preview-latex @end ifset @c ----------------------- @@ -15,9 +15,7 @@ other software. Some of the known problems can be solved by moving to newer versions of the problematic software or by simple patches. @menu -* Problems with Ghostscript:: * Font problems with Dvips:: -* Emacs problems:: * Too small bounding boxes:: * x-symbol interoperation:: * Middle-clicks paste instead of toggling:: @@ -30,61 +28,15 @@ information interesting to us and send it to the if at all possible. @ifset rawfile -@node Problems with Ghostscript -@chapter Problems with Ghostscript +@node Font problems with Dvips +@chapter Font problems with Dvips @raisesections @end ifset @ifclear rawfile -@node Problems with Ghostscript -@section Problems with Ghostscript -@end ifclear - -Most of the problems encountered come from interaction with Ghostscript. -It is a good idea to have a fairly recent version of Ghostscript -installed. One problem occurs if you have specified the wrong -executable under Windows: the command line version of Ghostscript is -called @file{GSWIN32C.EXE}, not @file{GSWIN32.EXE}. - -When Ghostscript fails, the necessary information and messages from -Ghostscript go somewhere. If Ghostscript fails before starting to -process images, you'll find the information at the end of the process -buffer you can see with @kbd{C-c C-l}. If Ghostscript fails while -processing a particular image, this image will be tagged with clickable -buttons for the error description and for the corresponding source file. - -The default options configurable with - -@display -@kbd{M-x customize-variable @key{RET} preview-gs-options @key{RET}} -@end display -@vindex preview-gs-options -@noindent -include the options @option{-dTextAlphaBits=4} and -@option{-dGraphicsAlphaBits=4}. These options have been reported to -make Ghostscript 5.50 fail, but should work under Ghostscript 6.51 and -later. If you are experiencing problems, it might help to customize -them away. Of course, this also takes away the joy of antialiasing, so -upgrading Ghostscript might not be the worst idea after all. - -The device names have changed over time, so when using an old -Ghostscript, you may have problems with the devices demanded by the -customizable variable @code{preview-image-creators}. -@vindex preview-image-creators -In that case, make sure they fit your version of Ghostscript, at least -the entry corresponding to the current value of -@code{preview-image-type}. -@vindex preview-image-type -While not being best in file size and image quality, setting -@code{preview-image-creators} to @code{jpeg} should probably be one of -the best bets for the purpose of checking basic operation, since that -device name has not changed in quite some time. But @acronym{JPEG} is -not intended for text, but for photographic images. On a more -permanent time scale, the best choice is to use @acronym{PNG} and -complain to your suppliers if either Emacs or Ghostscript fail to -properly accommodate this format. - @node Font problems with Dvips @section Font problems with Dvips +@end ifclear + Some fonts have been reported to produce wrong characters with @previewlatex{}. @previewlatex{} calls Dvips by default with the option @option{-Pwww} in order to get scalable fonts for nice results. If you @@ -111,56 +63,6 @@ rendered as @samp{@pounds{}} (British Pounds sign) in several fonts, unless your version of Dvips has a long-standing bug in its implementation fixed (only very recent versions of Dvips have). -@node Emacs problems -@section Emacs problems - -@itemize @bullet -@item GNU Emacs versions - -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 -@ifset rawfile -in the @file{INSTALL} file. -@end ifset -@ifclear rawfile -@ref{Prerequisites,,,auctex,the @AUCTeX{} manual}. -@end ifclear - -@item Emacsen on Windows operating systems - -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. Precompiled versions are available from -@uref{http://crasseux.com/emacs} and @uref{http://nqmacs.sf.net}. - -For detailed installation instructions for Windows, see -@ifset rawfile -the file @file{INSTALL.windows} -@end ifset -@ifclear rawfile -@ref{Installation under MS Windows,,,auctex,the @AUCTeX{} manual}. -@end ifclear - -@item XEmacs - -There is are two larger problems known with older XEmacs releases. One -leads to seriously mispositioned baselines and previews hanging far -above other text on the same line. This should be fixed as of -XEmacs-21.4.9. - -The other core bug causes a huge delay when XEmacs's idea of the state of -processes (like ghostscript) is wrong, and can lead to nasty spurious -error messages. It should be fixed in version 21.4.8. - -Previews will only remain from one session to the next if you have -version 1.81 or above of the @file{edit-utils} package, first released -in the 2002-03-12 sumo tarball. -@end itemize - @node Too small bounding boxes @section Too small bounding boxes The bounding box of a preview is determined by the @LaTeX{} package diff --git a/preview/ChangeLog b/preview/ChangeLog index 07ade79..6565b91 100644 --- a/preview/ChangeLog +++ b/preview/ChangeLog @@ -1,3 +1,8 @@ +2013-06-26 Tassilo Horn <t...@gnu.org> + + * Makefile.in (use-hint): Don't warn about problems with overly + obsolete packages. + 2013-04-08 Tassilo Horn <t...@gnu.org> * latex/preview.dtx: Fix date format which got converted from diff --git a/preview/Makefile.in b/preview/Makefile.in index 35d472a..c8b058c 100644 --- a/preview/Makefile.in +++ b/preview/Makefile.in @@ -98,11 +98,7 @@ install: install-texmf install-el install-nosearch install-images \ use-hint: @echo "Installation completed." @echo - @echo "Please read the PROBLEMS file if you use" - @echo "a) AUCTeX with a version less than 11.0" - @echo "b) GNU Emacs with a version less than 21.2" - @echo " OR XEmacs with a version less than 21.4.9" - @echo "c) Ghostscript with a version less than 6.51" + @echo "Read the PROBLEMS file if you experience problems." @echo "Please use M-x preview-report-bug if you experience any" @echo "problems not mentioned in there."