From 3c655230d2517d091d6af9835031cbc5d665dccb Mon Sep 17 00:00:00 2001
From: Glenn Morris <rgm@gnu.org>
Date: Mon, 12 Dec 2016 17:17:34 -0500
Subject: [PATCH] Obsolete gs.el

* lisp/gs.el: Move to lisp/obsolete.  (Bug#1524)
* doc/lispref/display.texi (Image Formats): Remove postscript.
(PostScript Images): Remove section.
* doc/lispref/elisp.texi: Update menu.
---
 doc/lispref/display.texi  | 32 ++------------------------------
 doc/lispref/elisp.texi    |  1 -
 lisp/{ => obsolete}/gs.el |  5 ++++-
 3 files changed, 6 insertions(+), 32 deletions(-)
 rename lisp/{ => obsolete}/gs.el (97%)

diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi
index 851baa31f30..945a701fcb2 100644
--- a/doc/lispref/display.texi
+++ b/doc/lispref/display.texi
@@ -4779,7 +4779,6 @@ displayed (@pxref{Display Feature Testing}).
 * Image Descriptors::   How to specify an image for use in @code{:display}.
 * XBM Images::          Special features for XBM format.
 * XPM Images::          Special features for XPM format.
-* PostScript Images::   Special features for PostScript format.
 * ImageMagick Images::  Special features available through ImageMagick.
 * SVG Images::          Creating and manipulating SVG images.
 * Other Image Types::   Various other formats are supported.
@@ -4804,12 +4803,12 @@ to modify the set of known names for these dynamic libraries.
   Supported image formats (and the required support libraries) include
 PBM and XBM (which do not depend on support libraries and are always
 available), XPM (@code{libXpm}), GIF (@code{libgif} or
-@code{libungif}), PostScript (@code{gs}), JPEG (@code{libjpeg}), TIFF
+@code{libungif}), JPEG (@code{libjpeg}), TIFF
 (@code{libtiff}), PNG (@code{libpng}), and SVG (@code{librsvg}).
 
   Each of these image formats is associated with an @dfn{image type
 symbol}.  The symbols for the above formats are, respectively,
-@code{pbm}, @code{xbm}, @code{xpm}, @code{gif}, @code{postscript},
+@code{pbm}, @code{xbm}, @code{xpm}, @code{gif},
 @code{jpeg}, @code{tiff}, @code{png}, and @code{svg}.
 
   Furthermore, if you build Emacs with ImageMagick
@@ -5122,33 +5121,6 @@ the name of a color as it appears in the image file, and @var{color}
 specifies the actual color to use for displaying that name.
 @end table
 
-@node PostScript Images
-@subsection PostScript Images
-@cindex postscript images
-
-  To use PostScript for an image, specify image type @code{postscript}.
-This works only if you have Ghostscript installed.  You must always use
-these three properties:
-
-@table @code
-@item :pt-width @var{width}
-The value, @var{width}, specifies the width of the image measured in
-points (1/72 inch).  @var{width} must be an integer.
-
-@item :pt-height @var{height}
-The value, @var{height}, specifies the height of the image in points
-(1/72 inch).  @var{height} must be an integer.
-
-@item :bounding-box @var{box}
-The value, @var{box}, must be a list or vector of four integers, which
-specifying the bounding box of the PostScript image, analogous to the
-@samp{BoundingBox} comment found in PostScript files.
-
-@example
-%%BoundingBox: 22 171 567 738
-@end example
-@end table
-
 @node ImageMagick Images
 @subsection ImageMagick Images
 @cindex ImageMagick images
diff --git a/doc/lispref/elisp.texi b/doc/lispref/elisp.texi
index 4a53a0cd364..494e8fcb6c3 100644
--- a/doc/lispref/elisp.texi
+++ b/doc/lispref/elisp.texi
@@ -1472,7 +1472,6 @@ Images
 * Image Descriptors::       How to specify an image for use in @code{:display}.
 * XBM Images::              Special features for XBM format.
 * XPM Images::              Special features for XPM format.
-* PostScript Images::       Special features for PostScript format.
 * ImageMagick Images::      Special features available through ImageMagick.
 * Other Image Types::       Various other formats are supported.
 * Defining Images::         Convenient ways to define an image for later use.
diff --git a/lisp/gs.el b/lisp/obsolete/gs.el
similarity index 97%
rename from lisp/gs.el
rename to lisp/obsolete/gs.el
index 7ab3d8b3ca5..c4cdcebff8e 100644
--- a/lisp/gs.el
+++ b/lisp/obsolete/gs.el
@@ -4,6 +4,7 @@
 
 ;; Maintainer: emacs-devel@gnu.org
 ;; Keywords: internal
+;; Obsolete-since: 26.1
 
 ;; This file is part of GNU Emacs.
 
@@ -22,7 +23,9 @@
 
 ;;; Commentary:
 
-;; This code is experimental.  Don't use it.
+;; This code is experimental.  Don't use it.  Try imagemagick images instead.
+;; When this file is removed from Emacs, associated code in image.c
+;; can be removed too (HAVE_GHOSTSCRIPT).
 
 ;;; Code:
 
-- 
2.39.2