[elpa] 140/299: Remove warnings and docs for ancient preview problems.

[Stefan Monnier]

monnier pushed a commit to branch externals/auctex
in repository elpa.

commit 01f50af361c432aa8bbb9c39ebf44b6ad8162168
Author: Tassilo Horn <address@hidden>
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  <address@hidden>
+
+       * 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  <address@hidden>
 
        * 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 
address@hidden 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
address@hidden rawfile
-the @file{PROBLEMS} file.
address@hidden ifset
address@hidden rawfile
address@hidden with Ghostscript,,,preview-latex,the @previewlatex{} manual}.
address@hidden 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)
address@hidden Known problems
address@hidden 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
address@hidden Problems with Ghostscript
address@hidden Problems with Ghostscript
address@hidden Font problems with Dvips
address@hidden Font problems with Dvips
 @raisesections
 @end ifset
 @ifclear rawfile
address@hidden Problems with Ghostscript
address@hidden Problems with Ghostscript
address@hidden 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
-
address@hidden
address@hidden customize-variable @key{RET} preview-gs-options @key{RET}}
address@hidden display
address@hidden preview-gs-options
address@hidden
-include the options @option{-dTextAlphaBits=4} and
address@hidden  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}.
address@hidden preview-image-creators
-In that case, make sure they fit your version of Ghostscript, at least
-the entry corresponding to the current value of
address@hidden
address@hidden preview-image-type
-While not being best in file size and image quality, setting
address@hidden 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
address@hidden 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 @address@hidden (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).
 
address@hidden Emacs problems
address@hidden Emacs problems
-
address@hidden @bullet
address@hidden 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
address@hidden rawfile
-in the @file{INSTALL} file.
address@hidden ifset
address@hidden rawfile
address@hidden,,,auctex,the @AUCTeX{} manual}.
address@hidden ifclear
-
address@hidden 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
address@hidden://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
address@hidden://crasseux.com/emacs} and @uref{http://nqmacs.sf.net}.
-
-For detailed installation instructions for Windows, see
address@hidden rawfile
-the file @file{INSTALL.windows}
address@hidden ifset
address@hidden rawfile
address@hidden under MS Windows,,,auctex,the @AUCTeX{} manual}.
address@hidden ifclear
-
address@hidden 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.
address@hidden 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  <address@hidden>
+
+       * Makefile.in (use-hint): Don't warn about problems with overly
+       obsolete packages.
+
 2013-04-08  Tassilo Horn  <address@hidden>
 
        * 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."