(lw_separator_p): Add `--:space' with the same
[bpt/emacs.git] / lisp / ps-print.el
index 62faf44..4e6f022 100644 (file)
@@ -1,23 +1,27 @@
-;;; ps-print.el --- Jim's Pretty-Good PostScript Generator for Emacs 19.
+;;; ps-print.el --- Print text from the buffer as PostScript
 
-;; Copyright (C) 1993, 1994, 1995, 1996 Free Software Foundation, Inc.
+;; Copyright (C) 1993, 94, 95, 96, 97, 98, 1999 Free Software Foundation, Inc.
 
-;; Author:     Jim Thompson (was <thompson@wg2.waii.com>)
-;; Maintainer: Jacques Duthen <duthen@club-internet.fr>
-;; Keywords:   print, PostScript
-;; Time-stamp: <97/01/09 13:52:08 duthen>
-;; Version:    3.04
+;; Author:     Jim Thompson (was <thompson@wg2.waii.com>)
+;; Author:     Jacques Duthen (was <duthen@cegelec-red.fr>)
+;; Author:     Vinicius Jose Latorre <vinicius@cpqd.com.br>
+;; Author:     Kenichi Handa <handa@etl.go.jp> (multi-byte characters)
+;; Maintainer: Kenichi Handa <handa@etl.go.jp> (multi-byte characters)
+;; Maintainer: Vinicius Jose Latorre <vinicius@cpqd.com.br>
+;; Keywords:   print, PostScript
+;; Time-stamp: <99/02/19 11:47:32 vinicius>
+;; Version:    4.1.4
 
-(defconst ps-print-version "3.04"
-  "ps-print.el, v 3.04 <97/01/09 duthen>
+(defconst ps-print-version "4.1.4"
+  "ps-print.el, v 4.1.4 <99/02/19 vinicius>
 
-Jack's last change version -- this file may have been edited as part of
+Vinicius's last change version -- this file may have been edited as part of
 Emacs without changes to the version number.  When reporting bugs,
 please also report the version of Emacs, if any, that ps-print was
 distributed with.
 
 Please send all bug fixes and enhancements to
-       Jacques Duthen <duthen@cegelec-red.fr>.
+       Vinicius Jose Latorre <vinicius@cpqd.com.br>.
 ")
 
 ;; This file is part of GNU Emacs.
@@ -46,17 +50,24 @@ Please send all bug fixes and enhancements to
 ;;
 ;; This package provides printing of Emacs buffers on PostScript
 ;; printers; the buffer's bold and italic text attributes are
-;; preserved in the printer output.  Ps-print is intended for use with
+;; preserved in the printer output.  ps-print is intended for use with
 ;; Emacs 19 or Lucid Emacs, together with a fontifying package such as
 ;; font-lock or hilit.
 ;;
+;; ps-print uses the same face attributes defined through font-lock or hilit
+;; to print a PostScript file, but some faces are better seeing on the screen
+;; than on paper, specially when you have a black/white PostScript printer.
+;;
+;; ps-print allows a remap of face to another one that it is better to print,
+;; for example, the face font-lock-comment-face (if you are using font-lock)
+;; could have bold or italic attribute when printing, besides foreground color.
+;; This remap improves printing look (see How Ps-Print Maps Faces).
+;;
 ;;
 ;; Using ps-print
 ;; --------------
 ;;
-;; The Commands
-;;
-;; Ps-print provides eight commands for generating PostScript images
+;; ps-print provides eight commands for generating PostScript images
 ;; of Emacs buffers:
 ;;
 ;;        ps-print-buffer
@@ -89,8 +100,8 @@ Please send all bug fixes and enhancements to
 ;; otherwise be wasted on banner pages, and to make it easier to find
 ;; your output at the printer (it's easier to pick up one 50-page
 ;; printout than to find 50 single-page printouts).
-;; 
-;; Ps-print has a hook in the `kill-emacs-hooks' so that you won't
+;;
+;; ps-print has a hook in the `kill-emacs-hook' so that you won't
 ;; accidentally quit from Emacs while you have unprinted PostScript
 ;; waiting in the spool buffer.  If you do attempt to exit with
 ;; spooled PostScript, you'll be asked if you want to print it, and if
@@ -166,14 +177,20 @@ Please send all bug fixes and enhancements to
 ;; command is used to send the PostScript images to the printer, and
 ;; what arguments to give the command.  These are analogous to
 ;; `lpr-command' and `lpr-switches'.
+;;
 ;; Make sure that they contain appropriate values for your system;
 ;; see the usage notes below and the documentation of these variables.
 ;;
+;; The variable `ps-printer-name' determine the name of a local printer for
+;; printing PostScript files.
+;;
 ;; NOTE: `ps-lpr-command' and `ps-lpr-switches' take their initial values
 ;;       from the variables `lpr-command' and `lpr-switches'.  If you have
 ;;       `lpr-command' set to invoke a pretty-printer such as `enscript',
 ;;       then ps-print won't work properly.  `ps-lpr-command' must name
 ;;       a program that does not format the files it prints.
+;;       `ps-printer-name' takes its initial value from the variable
+;;       `printer-name'.
 ;;
 ;;
 ;; The Page Layout
@@ -192,7 +209,7 @@ Please send all bug fixes and enhancements to
 ;; of the printing on the page:
 ;; nil means `portrait' mode, non-nil means `landscape' mode.
 ;; There is no oblique mode yet, though this is easy to do in ps.
-
+;;
 ;; In landscape mode, the text is NOT scaled: you may print 70 lines
 ;; in portrait mode and only 50 lignes in landscape mode.
 ;; The margins represent margins in the printed paper:
@@ -257,15 +274,15 @@ Please send all bug fixes and enhancements to
 ;; Headers
 ;; -------
 ;;
-;; Ps-print can print headers at the top of each column; the default
-;; headers contain the following four items: on the left, the name of
-;; the buffer and, if the buffer is visiting a file, the file's
-;; directory; on the right, the page number and date of printing.
-;; The default headers look something like this:
+;; ps-print can print headers at the top of each column or at the top
+;; of each page; the default headers contain the following four items:
+;; on the left, the name of the buffer and, if the buffer is visiting
+;; a file, the file's directory; on the right, the page number and
+;; date of printing.  The default headers look something like this:
 ;;
 ;;     ps-print.el                                         1/21
 ;;     /home/jct/emacs-lisp/ps/new                     94/12/31
-;; 
+;;
 ;; When printing on duplex printers, left and right are reversed so
 ;; that the page numbers are toward the outside (cf. `ps-spool-duplex').
 ;;
@@ -274,8 +291,11 @@ Please send all bug fixes and enhancements to
 ;; To turn off the header's gaudy framing box,
 ;; set `ps-print-header-frame' to nil.
 ;;
+;; To print only one header at the top of each page,
+;; set `ps-print-only-one-header' to t.
+;;
 ;; The font family and size of text in the header are determined
-;; by the variables `ps-header-font-family', `ps-header-font-size' and 
+;; by the variables `ps-header-font-family', `ps-header-font-size' and
 ;; `ps-header-title-font-size' (see below).
 ;;
 ;; The variable `ps-header-line-pad' determines the portion of a header
@@ -330,68 +350,200 @@ Please send all bug fixes and enhancements to
 ;;
 ;; Note that Curly has the PostScript string delimiters inside his
 ;; quotes -- those aren't misplaced lisp delimiters!
+;;
 ;; Without them, PostScript would attempt to call the undefined
 ;; function Curly, which would result in a PostScript error.
+;;
 ;; Since most printers don't report PostScript errors except by
 ;; aborting the print job, this kind of error can be hard to track down.
+;;
 ;; Consider yourself warned!
 ;;
 ;;
+;; PostScript Prologue Header
+;; --------------------------
+;;
+;; It is possible to add PostScript prologue header comments besides that
+;; ps-print generates by setting the variable `ps-print-prologue-header'.
+;;
+;; `ps-print-prologue-header' may be a string or a symbol function which
+;; returns a string.  Note that this string is inserted on PostScript prologue
+;; header section which is used to define some document characteristic through
+;; PostScript special comments, like "%%Requirements: jog\n".
+;;
+;; By default `ps-print-prologue-header' is nil.
+;;
+;; ps-print always inserts the %%Requirements: comment, so if you need to insert
+;; more requirements put them first in `ps-print-prologue-header' using the
+;; "%%+" comment.  For example, if you need to set numcopies to 3 and jog on
+;; requirements and set %%LanguageLevel: to 2, do:
+;;
+;; (setq ps-print-prologue-header
+;;       "%%+ numcopies(3) jog\n%%LanguageLevel: 2\n")
+;;
+;; The duplex requirement is inserted by ps-print (see section Duplex Printers).
+;;
+;; Do not forget to terminate the string with "\n".
+;;
+;; For more information about PostScript document comments, see:
+;;    PostScript Language Reference Manual (2nd edition)
+;;    Adobe Systems Incorporated
+;;    Appendix G: Document Structuring Conventions -- Version 3.0
+;;
+;;
 ;; Duplex Printers
 ;; ---------------
 ;;
 ;; If you have a duplex-capable printer (one that prints both sides of
 ;; the paper), set `ps-spool-duplex' to t.
-;; Ps-print will insert blank pages to make sure each buffer starts
+;; ps-print will insert blank pages to make sure each buffer starts
 ;; on the correct side of the paper.
 ;; Don't forget to set `ps-lpr-switches' to select duplex printing
 ;; for your printer.
 ;;
-;; 
-;; Font managing
+;;
+;; Control And 8-bit Characters
+;; ----------------------------
+;;
+;; The variable `ps-print-control-characters' specifies whether you want to see
+;; a printable form for control and 8-bit characters, that is, instead of
+;; sending, for example, a ^D (\004) to printer, it is sent the string "^D".
+;;
+;; Valid values for `ps-print-control-characters' are:
+;;
+;;  8-bit           This is the value to use when you want an ASCII encoding of
+;;                  any control or non-ASCII character. Control characters are
+;;                  encoded as "^D", and non-ASCII characters have an
+;;                  octal encoding.
+;;
+;;  control-8-bit   This is the value to use when you want an ASCII encoding of
+;;                  any control character, whether it is 7 or 8-bit.
+;;                  European 8-bits accented characters are printed according
+;;                  the current font.
+;;
+;;  control         Only ASCII control characters have an ASCII encoding.
+;;                  European 8-bits accented characters are printed according
+;;                  the current font.
+;;
+;;  nil             No ASCII encoding. Any character is printed according the
+;;                  current font.
+;;
+;; Any other value is treated as nil.
+;;
+;; The default is `control-8-bit'.
+;;
+;; Characters TAB, NEWLINE and FORMFEED are always treated by ps-print engine.
+;;
+;;
+;; Printing Multi-byte Buffer
+;; --------------------------
+;;
+;; See ps-mule.el for documentation.
+;;
+;;
+;; Line Number
+;; -----------
+;;
+;; The variable `ps-line-number' specifies whether to number each line;
+;; non-nil means do so.  The default is nil (don't number each line).
+;;
+;;
+;; Zebra Stripes
+;; -------------
+;;
+;; Zebra stripes are a kind of background that appear "underneath" the text
+;; and can make the text easier to read.  They look like this:
+;;
+;; XXXXXXXXXXXXXXXXXXXXXXXX
+;; XXXXXXXXXXXXXXXXXXXXXXXX
+;; XXXXXXXXXXXXXXXXXXXXXXXX
+;;
+;;
+;;
+;; XXXXXXXXXXXXXXXXXXXXXXXX
+;; XXXXXXXXXXXXXXXXXXXXXXXX
+;; XXXXXXXXXXXXXXXXXXXXXXXX
+;;
+;; The blocks of X's represent rectangles filled with a light gray color.
+;; Each rectangle extends all the way across the page.
+;;
+;; The height, in lines, of each rectangle is controlled by
+;; the variable `ps-zebra-stripe-height', which is 3 by default.
+;; The distance between stripes equals the height of a stripe.
+;;
+;; The variable `ps-zebra-stripes' controls whether to print zebra stripes.
+;; Non-nil means yes, nil means no.  The default is nil.
+;;
+;; See also section How Ps-Print Has A Text And/Or Image On Background.
+;;
+;;
+;; Hooks
+;; -----
+;;
+;; ps-print has the following hook variables:
+;;
+;; `ps-print-hook'
+;;    It is evaluated once before any printing process.  This is the right
+;;    place to initialize ps-print global data.
+;;    For an example, see section Adding a New Font Family.
+;;
+;; `ps-print-begin-page-hook'
+;;    It is evaluated on each real beginning of page, that is, ps-print
+;;    considers each beginning of column as a beginning of page, and a real
+;;    beginning of page is when the beginning of column coincides with a
+;;    paper change on your printer.
+;;
+;; `ps-print-begin-column-hook'
+;;    It is evaluated on each beginning of column, except in the beginning
+;;    of column that `ps-print-begin-page-hook' is evaluated.
+;;
+;;
+;; Font Managing
 ;; -------------
 ;;
-;; Ps-print now knows rather precisely some fonts:
-;; the variable `ps-font-info-database' contains information
-;; for a list of font families (currently mainly `Courier' `Helvetica'
-;; `Times' `Palatino' `Helvetica-Narrow' `NewCenturySchlbk').
-;; Each font family contains the font names for standard, bold, italic
-;; and bold-italic characters, a reference size (usually 10) and the
-;; corresponding line height, width of a space and average character width.
-;; 
-;; The variable `ps-font-family' determines which font family
-;; is to be used for ordinary text.
-;; If its value does not correspond to a known font family,
-;; an error message is printed into the `*Messages*' buffer,
-;; which lists the currently available font families.
-;;
-;; The variable `ps-font-size' determines the size (in points)
-;; of the font for ordinary text, when generating Postscript.
-;; Its value is a float.
-;;
-;; Similarly, the variable `ps-header-font-family' determines
-;; which font family is to be used for text in the header.
-;; The variable `ps-header-font-size' determines the font size,
-;; in points, for text in the header.
-;; The variable `ps-header-title-font-size' determines the font size,
-;; in points, for the top line of text in the header.
-;;
-;;
-;; Adding a new font family
+;; ps-print now knows rather precisely some fonts: the variable
+;; `ps-font-info-database' contains information for a list of font families
+;; (currently mainly `Courier' `Helvetica' `Times' `Palatino' `Helvetica-Narrow'
+;; `NewCenturySchlbk').  Each font family contains the font names for standard,
+;; bold, italic and bold-italic characters, a reference size (usually 10) and
+;; the corresponding line height, width of a space and average character width.
+;;
+;; The variable `ps-font-family' determines which font family is to be used for
+;; ordinary text.  If its value does not correspond to a known font family, an
+;; error message is printed into the `*Messages*' buffer, which lists the
+;; currently available font families.
+;;
+;; The variable `ps-font-size' determines the size (in points) of the font for
+;; ordinary text, when generating PostScript.  Its value is a float or a cons of
+;; floats which has the following form:
+;;
+;;    (LANDSCAPE-SIZE . PORTRAIT-SIZE)
+;;
+;; Similarly, the variable `ps-header-font-family' determines which font family
+;; is to be used for text in the header.
+;;
+;; The variable `ps-header-font-size' determines the font size, in points, for
+;; text in the header (similar to `ps-font-size').
+;;
+;; The variable `ps-header-title-font-size' determines the font size, in points,
+;; for the top line of text in the header (similar to `ps-font-size').
+;;
+;;
+;; Adding a New Font Family
 ;; ------------------------
 ;;
 ;; To use a new font family, you MUST first teach ps-print
-;; this font, ie add its information to `ps-font-info-database',
+;; this font, i.e., add its information to `ps-font-info-database',
 ;; otherwise ps-print cannot correctly place line and page breaks.
 ;;
-;; For example, assuming `Helvetica' is unkown,
+;; For example, assuming `Helvetica' is unknown,
 ;; you first need to do the following ONLY ONCE:
 ;;
 ;; - create a new buffer
 ;; - generate the PostScript image to a file (C-u M-x ps-print-buffer)
 ;; - open this file and find the line:
 ;;     `% 3 cm 20 cm moveto  10 /Courier ReportFontInfo  showpage'
-;; - delete the leading `%' (which is the Postscript comment character)
+;; - delete the leading `%' (which is the PostScript comment character)
 ;; - replace in this line `Courier' by the new font (say `Helvetica')
 ;;   to get the line:
 ;;     `3 cm 20 cm moveto  10 /Helvetica ReportFontInfo  showpage'
@@ -403,11 +555,17 @@ Please send all bug fixes and enhancements to
 ;;
 ;; - Add these values to the `ps-font-info-database':
 ;;   (setq ps-font-info-database
-;;      (append
-;;       '((Helvetica ; the family name
-;;         "Helvetica" "Helvetica-Bold" "Helvetica-Oblique" "Helvetica-BoldOblique"
-;;         10.0 11.56 2.78 5.09243))
-;;       ps-font-info-database))
+;;        (append
+;;         '((Helvetica                        ; the family key
+;;            (fonts (normal      . "Helvetica")
+;;                   (bold        . "Helvetica-Bold")
+;;                   (italic      . "Helvetica-Oblique")
+;;                   (bold-italic . "Helvetica-BoldOblique"))
+;;            (size . 10.0)
+;;            (line-height . 11.56)
+;;            (space-width . 2.78)
+;;            (avg-char-width . 5.09243)))
+;;         ps-font-info-database))
 ;; - Now you can use this font family with any size:
 ;;     (setq ps-font-family 'Helvetica)
 ;; - if you want to use this family in another emacs session, you must
@@ -416,24 +574,53 @@ Please send all bug fixes and enhancements to
 ;;     (setq ps-font-info-database (append ...)))
 ;;   if you don't want to load ps-print, you have to copy the whole value:
 ;;     (setq ps-font-info-database '(<your stuff> <the standard stuff>))
-;;   or, if you can wait until the `ps-print-hook' is implemented, do:
-;;      (add-hook 'ps-print-hook '(setq ps-font-info-database (append ...)))
-;;      This does not work yet, since there is no `ps-print-hook' yet.
+;;   or, use `ps-print-hook' (see section Hooks):
+;;     (add-hook 'ps-print-hook
+;;               '(lambda () (setq ps-font-info-database (append ...))))
 ;;
 ;; You can create new `mixed' font families like:
-;;     (my-mixed-family
-;;      "Courier-Bold" "Helvetica"
-;;      "Zapf-Chancery-MediumItalic" "NewCenturySchlbk-BoldItalic"
-;;      10.0 10.55 6.0 6.0)
+;;      (my-mixed-family
+;;       (fonts (normal               . "Courier-Bold")
+;;              (bold                 . "Helvetica")
+;;              (italic               . "Zapf-Chancery-MediumItalic")
+;;              (bold-italic          . "NewCenturySchlbk-BoldItalic")
+;;              (w3-table-hack-x-face . "LineDrawNormal"))
+;;       (size . 10.0)
+;;       (line-height . 10.55)
+;;       (space-width . 6.0)
+;;       (avg-char-width . 6.0))
+;;
 ;; Now you can use your new font family with any size:
 ;;     (setq ps-font-family 'my-mixed-family)
 ;;
+;; Note that on above example the `w3-table-hack-x-face' entry refers to
+;; a face symbol, so when printing this face it'll be used the font
+;; `LineDrawNormal'.  If the face  `w3-table-hack-x-face'  is remapped to
+;; use bold and/or italic attribute, the corresponding entry (bold, italic
+;; or bold-italic) will be used instead of `w3-table-hack-x-face' entry.
+;;
+;; Note also that the font family entry order is irrelevant, so the above
+;; example could also be written:
+;;      (my-mixed-family
+;;       (size . 10.0)
+;;       (fonts (w3-table-hack-x-face . "LineDrawNormal")
+;;              (bold                 . "Helvetica")
+;;              (bold-italic          . "NewCenturySchlbk-BoldItalic")
+;;              (italic               . "Zapf-Chancery-MediumItalic")
+;;              (normal               . "Courier-Bold"))
+;;       (avg-char-width . 6.0)
+;;       (space-width . 6.0)
+;;       (line-height . 10.55))
+;;
+;; Despite the note above, it is recommended that some convention about
+;; entry order be used.
+;;
 ;; You can get information on all the fonts resident in YOUR printer
 ;; by uncommenting the line:
 ;;     % 3 cm 20 cm moveto  ReportAllFontInfo           showpage
 ;;
-;; The postscript file should be sent to YOUR postscript printer.
-;; If you send it to ghostscript or to another postscript printer,
+;; The PostScript file should be sent to YOUR PostScript printer.
+;; If you send it to ghostscript or to another PostScript printer,
 ;; you may get slightly different results.
 ;; Anyway, as ghostscript fonts are autoload, you won't get
 ;; much font info.
@@ -447,20 +634,21 @@ Please send all bug fixes and enhancements to
 ;; always right.  For example, you might want to map colors into faces
 ;; so that blue faces print in bold, and red faces in italic.
 ;;
-;; It is possible to force ps-print to consider specific faces bold or
-;; italic, no matter what font they are displayed in, by setting the
-;; variables `ps-bold-faces' and `ps-italic-faces'.  These variables
-;; contain lists of faces that ps-print should consider bold or
-;; italic; to set them, put code like the following into your .emacs
-;; file:
+;; It is possible to force ps-print to consider specific faces bold,
+;; italic or underline, no matter what font they are displayed in, by setting
+;; the variables `ps-bold-faces', `ps-italic-faces' and `ps-underlined-faces'.
+;; These variables contain lists of faces that ps-print should consider bold,
+;; italic or underline; to set them, put code like the following into your
+;; .emacs file:
 ;;
-;;     (setq ps-bold-faces '(my-blue-face))
+;;      (setq ps-bold-faces '(my-blue-face))
 ;;      (setq ps-italic-faces '(my-red-face))
+;;      (setq ps-underlined-faces '(my-green-face))
 ;;
 ;; Faces like bold-italic that are both bold and italic should go in
 ;; *both* lists.
 ;;
-;; Ps-print keeps internal lists of which fonts are bold and which are
+;; ps-print keeps internal lists of which fonts are bold and which are
 ;; italic; these lists are built the first time you invoke ps-print.
 ;; For the sake of efficiency, the lists are built only once; the same
 ;; lists are referred in later invocations of ps-print.
@@ -469,13 +657,15 @@ Please send all bug fixes and enhancements to
 ;; get out of sync, if a face changes, or if new faces are added.  To
 ;; get the lists back in sync, you can set the variable
 ;; `ps-build-face-reference' to t, and the lists will be rebuilt the
-;; next time ps-print is invoked.
+;; next time ps-print is invoked.  If you need that the lists always be
+;; rebuilt when ps-print is invoked, set the variable
+;; `ps-always-build-face-reference' to t.
 ;;
 ;;
 ;; How Ps-Print Deals With Color
 ;; -----------------------------
 ;;
-;; Ps-print detects faces with foreground and background colors
+;; ps-print detects faces with foreground and background colors
 ;; defined and embeds color information in the PostScript image.
 ;; The default foreground and background colors are defined by the
 ;; variables `ps-default-fg' and `ps-default-bg'.
@@ -483,6 +673,84 @@ Please send all bug fixes and enhancements to
 ;; To turn off color output, set `ps-print-color-p' to nil.
 ;;
 ;;
+;; How Ps-Print Maps Faces
+;; -----------------------
+;;
+;; As ps-print uses PostScript to print buffers, it is possible to have
+;; other attributes associated with faces. So the new attributes used
+;; by ps-print are:
+;;
+;;   strikeout - like underline, but the line is in middle of text.
+;;   overline  - like underline, but the line is over the text.
+;;   shadow    - text will have a shadow.
+;;   box       - text will be surrounded by a box.
+;;   outline   - print characters as hollow outlines.
+;;
+;; See the documentation for `ps-extend-face'.
+;;
+;; Let's, for example, remap font-lock-keyword-face to another foreground color
+;; and bold attribute:
+;;
+;;    (ps-extend-face '(font-lock-keyword-face "RoyalBlue" nil bold) 'MERGE)
+;;
+;; If you want to use a new face, define it first with `defface',
+;; and then call `ps-extend-face' to specify how to print it.
+;;
+;;
+;; How Ps-Print Has A Text And/Or Image On Background
+;; --------------------------------------------------
+;;
+;; ps-print can print texts and/or EPS PostScript images on background; it is
+;; possible to define the following text attributes: font name, font size,
+;; initial position, angle, gray scale and pages to print.
+;;
+;; It has the following EPS PostScript images attributes: file name containing
+;; the image, initial position, X and Y scales, angle and pages to print.
+;;
+;; See documentation for `ps-print-background-text' and
+;; `ps-print-background-image'.
+;;
+;; For example, if we wish to print text "preliminary" on all pages and text
+;; "special" on page 5 and from page 11 to page 17, we could specify:
+;;
+;; (setq ps-print-background-text
+;;       '(("preliminary")
+;;         ("special"
+;;          "LeftMargin" "BottomMargin PrintHeight add" ; X and Y position
+;;                                      ; (upper left corner)
+;;          nil nil nil
+;;          "PrintHeight neg PrintPageWidth atan" ; angle
+;;          5 (11 . 17))                ; page list
+;;         ))
+;;
+;; Similarly, we could print image "~/images/EPS-image1.ps" on all pages and
+;; image "~/images/EPS-image2.ps" on page 5 and from page 11 to page 17, we
+;; specify:
+;;
+;; (setq ps-print-background-image
+;;       '(("~/images/EPS-image1.ps"
+;;          "LeftMargin" "BottomMargin") ; X and Y position (lower left corner)
+;;         ("~/images/EPS-image2.ps"
+;;          "LeftMargin" "BottomMargin PrintHeight 2 div add" ; X and Y position
+;;                                      ; (upper left corner)
+;;          nil nil nil
+;;          5 (11 . 17))                ; page list
+;;         ))
+;;
+;; If it is not possible to read (or does not exist) an image file, that file
+;; is ignored.
+;;
+;; The printing order is:
+;;
+;;    1. Print zebra stripes
+;;    2. Print background texts that it should be on all pages
+;;    3. Print background images that it should be on all pages
+;;    4. Print background texts only for current page (if any)
+;;    5. Print background images only for current page (if any)
+;;    6. Print header
+;;    7. Print buffer text (with faces, if specified) and line number
+;;
+;;
 ;; Utilities
 ;; ---------
 ;;
@@ -494,16 +762,17 @@ Please send all bug fixes and enhancements to
 ;; left and right margins and the font size.  On UN*X systems, do:
 ;; pr -t file | awk '{printf "%3d %s\n", length($0), $0}' | sort -r | head
 ;; to determine the longest lines of your file.
-;; Then, the command `ps-line-lengths' will give you the correspondance
+;; Then, the command `ps-line-lengths' will give you the correspondence
 ;; between a line length (number of characters) and the maximum font
 ;; size which doesn't wrap such a line with the current ps-print setup.
 ;;
 ;; The commands `ps-nb-pages-buffer' and `ps-nb-pages-region' display
-;; the correspondance between a number of pages and the maximum font
+;; the correspondence between a number of pages and the maximum font
 ;; size which allow the number of lines of the current buffer or of
 ;; its current region to fit in this number of pages.
-;; Note: line folding is not taken into account in this process
-;; and could change the results.
+;;
+;; NOTE: line folding is not taken into account in this process and could
+;;       change the results.
 ;;
 ;;
 ;; New since version 1.5
@@ -520,15 +789,46 @@ Please send all bug fixes and enhancements to
 ;; New since version 2.8
 ;; ---------------------
 ;;
+;; [vinicius] 980922 Vinicius Jose Latorre <vinicius@cpqd.com.br>
+;;
+;; PostScript prologue header comment insertion.
+;; Skip invisible text better.
+;;
+;; [keinichi] 980819 Kein'ichi Handa <handa@etl.go.jp>
+;;
+;; Multi-byte buffer handling.
+;;
+;; [vinicius] 980306 Vinicius Jose Latorre <vinicius@cpqd.com.br>
+;;
+;; Skip invisible text.
+;;
+;; [vinicius] 971130 Vinicius Jose Latorre <vinicius@cpqd.com.br>
+;;
+;; Hooks: `ps-print-hook', `ps-print-begin-page-hook' and
+;; `ps-print-begin-column-hook'.
+;; Put one header per page over the columns.
+;; Better database font management.
+;; Better control characters handling.
+;;
+;; [vinicius] 971121 Vinicius Jose Latorre <vinicius@cpqd.com.br>
+;;
+;; Dynamic evaluation at print time of `ps-lpr-switches'.
+;; Handle control characters.
+;; Face remapping.
+;; New face attributes.
+;; Line number.
+;; Zebra stripes.
+;; Text and/or image on background.
+;;
 ;; [jack] 960517 Jacques Duthen <duthen@cegelec-red.fr>
 ;;
-;; Font familiy and float size for text and header.
+;; Font family and float size for text and header.
 ;; Landscape mode.
 ;; Multiple columns.
 ;; Tools for page setup.
 ;;
 ;;
-;; Known bugs and limitations of ps-print:
+;; Known bugs and limitations of ps-print
 ;; --------------------------------------
 ;;
 ;; Although color printing will work in XEmacs 19.12, it doesn't work
@@ -540,38 +840,33 @@ Please send all bug fixes and enhancements to
 ;; Automatic font-attribute detection doesn't work well, especially
 ;; with hilit19 and older versions of get-create-face.  Users having
 ;; problems with auto-font detection should use the lists
-;; `ps-italic-faces' and `ps-bold-faces' and/or turn off automatic
-;; detection by setting `ps-auto-font-detect' to nil.
+;; `ps-italic-faces', `ps-bold-faces' and `ps-underlined-faces' and/or
+;; turn off automatic detection by setting `ps-auto-font-detect' to nil.
 ;;
 ;; Automatic font-attribute detection doesn't work with XEmacs 19.12
-;; in tty mode; use the lists `ps-italic-faces' and `ps-bold-faces'
-;; instead.
+;; in tty mode; use the lists `ps-italic-faces', `ps-bold-faces' and
+;; `ps-underlined-faces' instead.
 ;;
 ;; Still too slow; could use some hand-optimization.
 ;;
-;; ASCII Control characters other than tab, linefeed and pagefeed are
-;; not handled.
-;;
 ;; Default background color isn't working.
 ;;
 ;; Faces are always treated as opaque.
 ;;
 ;; Epoch and Emacs 18 not supported.  At all.
 ;;
-;; Fixed-pitch fonts work better for line folding, but are not required.  
+;; Fixed-pitch fonts work better for line folding, but are not required.
 ;;
 ;; `ps-nb-pages-buffer' and `ps-nb-pages-region' don't take care
 ;; of folding lines.
 ;;
 ;;
-;; Things to change:
+;; Things to change
 ;; ----------------
 ;;
-;; Add `ps-print-hook' (I don't know how to do that (yet!)).
-;; Add 4-up capability (really needed?).
-;; Add line numbers (should not be too hard).
+;; 2-up and 4-up capabilities.
+;; Avoid page break inside a paragraph.
 ;; Add `ps-non-bold-faces' and `ps-non-italic-faces' (should be easy).
-;; Put one header per page over the columns (easy but needed?).
 ;; Improve the memory management for big files (hard?).
 ;; `ps-nb-pages-buffer' and `ps-nb-pages-region' should take care
 ;; of folding lines.
@@ -579,6 +874,39 @@ Please send all bug fixes and enhancements to
 ;;
 ;; Acknowledgements
 ;; ----------------
+;;
+;; Thanks to Kein'ichi Handa <handa@etl.go.jp> for multi-byte buffer handling.
+;;
+;; Thanks to Matthew O Persico <Matthew.Persico@lazard.com> for line number on
+;; empty columns.
+;;
+;; Thanks to Theodore Jump <tjump@cais.com> for adjust PostScript code order on
+;; last page.
+;;
+;; Thanks to Roland Ducournau <ducour@lirmm.fr> for
+;; `ps-print-control-characters' variable documentation.
+;;
+;; Thanks to Marcus G Daniels <marcus@cathcart.sysc.pdx.edu> for a better
+;; database font management.
+;;
+;; Thanks to Martin Boyer <gamin@videotron.ca> for some ideas on putting one
+;; header per page over the columns and correct line numbers when printing a
+;; region.
+;;
+;; Thanks to Steven L Baur <steve@miranova.com> for dynamic evaluation at
+;; print time of `ps-lpr-switches'.
+;;
+;; Thanks to Kevin Rodgers <kevinr@ihs.com> for handling control characters
+;; (his code was severely modified, but the main idea was kept).
+;;
+;; Thanks to some suggestions on:
+;;  * Face color map: Marco Melgazzi <marco@techie.com>
+;;  * XEmacs compatibility: William J. Henney <will@astrosmo.unam.mx>
+;;  * Check `ps-paper-type': Sudhakar Frederick <sfrederi@asc.corp.mot.com>
+;;
+;; Thanks to Jacques Duthen <duthen@cegelec-red.fr> (Jack) for the 3.4 version
+;; I started from. [vinicius]
+;;
 ;; Thanks to Jim Thompson <?@?> for the 2.8 version I started from.
 ;; [jack]
 ;;
@@ -607,19 +935,27 @@ Please send all bug fixes and enhancements to
 
 ;;; Code:
 
-(eval-when-compile
-  (require 'cl))
-
 (unless (featurep 'lisp-float-type)
   (error "`ps-print' requires floating point support"))
 
+;; For Emacs 20.2 and the earlier version.
+(eval-and-compile
+  (and (string< mule-version "4.0")
+       (progn
+        (defun set-buffer-multibyte (arg)
+          (setq enable-multibyte-characters arg))
+        (defun string-as-unibyte (arg) arg)
+        (defun string-as-multibyte (arg) arg)
+        (defun charset-after (&optional arg)
+          (char-charset (char-after arg))))))
+
 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 ;; User Variables:
 
 ;;; Interface to the command system
 
 (defgroup ps-print nil
-  "Postscript generator for Emacs 19"
+  "PostScript generator for Emacs 19"
   :prefix "ps-"
   :group 'wp)
 
@@ -661,8 +997,66 @@ Please send all bug fixes and enhancements to
   :group 'faces)
 
 
+(defcustom ps-print-prologue-header nil
+  "*PostScript prologue header comments besides that ps-print generates.
+
+`ps-print-prologue-header' may be a string or a symbol function which
+returns a string.  Note that this string is inserted on PostScript prologue
+header section which is used to define some document characteristic through
+PostScript special comments, like \"%%Requirements: jog\\n\".
+
+ps-print always inserts the %%Requirements: comment, so if you need to insert
+more requirements put them first in `ps-print-prologue-header' using the
+\"%%+\" comment.  For example, if you need to set numcopies to 3 and jog on
+requirements and set %%LanguageLevel: to 2, do:
+
+(setq ps-print-prologue-header
+      \"%%+ numcopies(3) jog\\n%%LanguageLevel: 2\\n\")
+
+The duplex requirement is inserted by ps-print (see `ps-spool-duplex').
+
+Do not forget to terminate the string with \"\\n\".
+
+For more information about PostScript document comments, see:
+   PostScript Language Reference Manual (2nd edition)
+   Adobe Systems Incorporated
+   Appendix G: Document Structuring Conventions -- Version 3.0"
+  :type '(choice string symbol (other :tag "nil" nil))
+  :group 'ps-print)
+
+(defcustom ps-printer-name (and (boundp 'printer-name)
+                               printer-name)
+  "*The name of a local printer for printing PostScript files.
+
+On Unix-like systems, a string value should be a name understood by
+lpr's -P option; a value of nil means use the value of `printer-name'
+instead.  Any other value will be ignored.
+
+On MS-DOS and MS-Windows systems, a string value is taken as the name of
+the printer device or port to which PostScript files are written,
+provided `ps-lpr-command' is \"\".  By default it is the same as
+`printer-name'; typical non-default settings would be \"LPT1\" to
+\"LPT3\" for parallel printers, or \"COM1\" to \"COM4\" or \"AUX\" for
+serial printers, or \"//hostname/printer\" for a shared network printer.
+You can also set it to a name of a file, in which case the output gets
+appended to that file.  \(Note that `ps-print' package already has
+facilities for printing to a file, so you might as well use them instead
+of changing the setting of this variable.\)  If you want to silently
+discard the printed output, set this to \"NUL\"."
+  :type '(choice (file :tag "Name")
+                (const :tag "Default" nil))
+  :group 'ps-print)
+
 (defcustom ps-lpr-command lpr-command
-  "*The shell command for printing a PostScript file."
+  "*Name of program for printing a PostScript file.
+
+On MS-DOS and MS-Windows systems, if the value is an empty string then
+Emacs will write directly to the printer port named by `ps-printer-name'.
+The programs `print' and `nprint' (the standard print programs on Windows
+NT and Novell Netware respectively) are handled specially, using
+`ps-printer-name' as the destination for output; any other program is
+treated like `lpr' except that an explicit filename is given as the last
+argument."
   :type 'string
   :group 'ps-print)
 
@@ -671,6 +1065,12 @@ Please send all bug fixes and enhancements to
   :type '(repeat string)
   :group 'ps-print)
 
+(defcustom ps-print-region-function nil
+  "Function to call to print the region on a PostScript printer.
+See definition of `ps-do-despool' for calling conventions."
+  :type 'function
+  :group 'ps-print)
+
 ;;; Page layout
 
 ;; All page dimensions are in PostScript points.
@@ -712,25 +1112,166 @@ see `ps-paper-type'."
                       (number :tag "Height")))
   :group 'ps-print)
 
+;;;###autoload
 (defcustom ps-paper-type 'letter
   "*Specifies the size of paper to format for.
 Should be one of the paper types defined in `ps-page-dimensions-database', for
 example `letter', `legal' or `a4'."
   :type '(symbol :validate (lambda (wid)
-                            (if (assq (widget-value wid) ps-page-dimensions-database)
+                            (if (assq (widget-value wid)
+                                      ps-page-dimensions-database)
                                 nil
                               (widget-put wid :error "Unknown paper size")
                               wid)))
   :group 'ps-print)
 
-(defcustom ps-landscape-mode 'nil
+(defcustom ps-landscape-mode nil
   "*Non-nil means print in landscape mode."
   :type 'boolean
   :group 'ps-print)
 
+(defcustom ps-print-control-characters 'control-8-bit
+  "*Specifies the printable form for control and 8-bit characters.
+That is, instead of sending, for example, a ^D (\004) to printer,
+it is sent the string \"^D\".
+
+Valid values are:
+
+  `8-bit'         This is the value to use when you want an ASCII encoding of
+                 any control or non-ASCII character.  Control characters are
+                 encoded as \"^D\", and non-ASCII characters have an
+                 octal encoding.
+
+  `control-8-bit' This is the value to use when you want an ASCII encoding of
+                 any control character, whether it is 7 or 8-bit.
+                 European 8-bits accented characters are printed according
+                 the current font.
+
+  `control'       Only ASCII control characters have an ASCII encoding.
+                 European 8-bits accented characters are printed according
+                 the current font.
+
+  nil             No ASCII encoding.  Any character is printed according the
+                 current font.
+
+Any other value is treated as nil."
+  :type '(choice (const 8-bit) (const control-8-bit)
+                (const control) (other :tag "nil" nil))
+  :group 'ps-print)
+
 (defcustom ps-number-of-columns (if ps-landscape-mode 2 1)
   "*Specifies the number of columns"
-  :type 'integer
+  :type 'number
+  :group 'ps-print)
+
+(defcustom ps-zebra-stripes nil
+  "*Non-nil means print zebra stripes.
+See also documentation for `ps-zebra-stripe-height'."
+  :type 'boolean
+  :group 'ps-print)
+
+(defcustom ps-zebra-stripe-height 3
+  "*Number of zebra stripe lines.
+See also documentation for `ps-zebra-stripes'."
+  :type 'number
+  :group 'ps-print)
+
+(defcustom ps-line-number nil
+  "*Non-nil means print line number."
+  :type 'boolean
+  :group 'ps-print)
+
+(defcustom ps-print-background-image nil
+  "*EPS image list to be printed on background.
+
+The elements are:
+
+   (FILENAME X Y XSCALE YSCALE ROTATION PAGES...)
+
+FILENAME is a file name which contains an EPS image or some PostScript
+programming like EPS.
+FILENAME is ignored, if it doesn't exist or is read protected.
+
+X and Y are relative positions on paper to put the image.
+If X and Y are nil, the image is centralized on paper.
+
+XSCALE and YSCALE are scale factor to be applied to image before printing.
+If XSCALE and YSCALE are nil, the original size is used.
+
+ROTATION is the image rotation angle; if nil, the default is 0.
+
+PAGES designates the page to print background image.
+PAGES may be a number or a cons cell (FROM . TO) designating FROM page
+to TO page.
+If PAGES is nil, print background image on all pages.
+
+X, Y, XSCALE, YSCALE and ROTATION may be a floating point number,
+an integer number or a string. If it is a string, the string should contain
+PostScript programming that returns a float or integer value.
+
+For example, if you wish to print an EPS image on all pages do:
+
+   '((\"~/images/EPS-image.ps\"))"
+  :type '(repeat (list file
+                      (choice :tag "X" number string (const nil))
+                      (choice :tag "Y" number string (const nil))
+                      (choice :tag "X Scale" number string (const nil))
+                      (choice :tag "Y Scale" number string (const nil))
+                      (choice :tag "Rotation" number string (const nil))
+                      (repeat :tag "Pages" :inline t
+                              (radio integer
+                                     (cons :tag "Range"
+                                           (integer :tag "From")
+                                           (integer :tag "To"))))))
+  :group 'ps-print)
+
+(defcustom ps-print-background-text nil
+  "*Text list to be printed on background.
+
+The elements are:
+
+   (STRING X Y FONT FONTSIZE GRAY ROTATION PAGES...)
+
+STRING is the text to be printed on background.
+
+X and Y are positions on paper to put the text.
+If X and Y are nil, the text is positioned at lower left corner.
+
+FONT is a font name to be used on printing the text.
+If nil, \"Times-Roman\" is used.
+
+FONTSIZE is font size to be used, if nil, 200 is used.
+
+GRAY is the text gray factor (should be very light like 0.8).
+If nil, the default is 0.85.
+
+ROTATION is the text rotation angle; if nil, the angle is given by
+the diagonal from lower left corner to upper right corner.
+
+PAGES designates the page to print background text.
+PAGES may be a number or a cons cell (FROM . TO) designating FROM page
+to TO page.
+If PAGES is nil, print background text on all pages.
+
+X, Y, FONTSIZE, GRAY and ROTATION may be a floating point number,
+an integer number or a string. If it is a string, the string should contain
+PostScript programming that returns a float or integer value.
+
+For example, if you wish to print text \"Preliminary\" on all pages do:
+
+   '((\"Preliminary\"))"
+  :type '(repeat (list string
+                      (choice :tag "X" number string (const nil))
+                      (choice :tag "Y" number string (const nil))
+                      (choice :tag "Font" string (const nil))
+                      (choice :tag "Fontsize" number string (const nil))
+                      (choice :tag "Gray" number string (const nil))
+                      (choice :tag "Rotation" number string (const nil))
+                      (repeat :tag "Pages" :inline t
+                              (radio integer
+                                     (cons :tag "Range"
+                                           (integer :tag "From")
+                                           (integer :tag "To"))))))
   :group 'ps-print)
 
 ;;; Horizontal layout
@@ -802,21 +1343,29 @@ customizable by changing variables `ps-left-header' and
   :type 'boolean
   :group 'ps-print-header)
 
+(defcustom ps-print-only-one-header nil
+  "*Non-nil means print only one header at the top of each page.
+This is useful when printing more than one column, so it is possible
+to have only one header over all columns or one header per column.
+See also `ps-print-header'."
+  :type 'boolean
+  :group 'ps-print-header)
+
 (defcustom ps-print-header-frame t
   "*Non-nil means draw a gaudy frame around the header."
   :type 'boolean
   :group 'ps-print-header)
 
 (defcustom ps-header-lines 2
-  "*Number of lines to display in page header, when generating Postscript."
+  "*Number of lines to display in page header, when generating PostScript."
   :type 'integer
   :group 'ps-print-header)
 (make-variable-buffer-local 'ps-header-lines)
 
 (defcustom ps-show-n-of-n t
   "*Non-nil means show page numbers as N/M, meaning page N of M.
-Note: page numbers are displayed as part of headers, see variable
-`ps-print-headers'."
+NOTE: page numbers are displayed as part of headers,
+      see variable `ps-print-headers'."
   :type 'boolean
   :group 'ps-print-header)
 
@@ -835,110 +1384,185 @@ the left on even-numbered pages."
 
 (defcustom ps-font-info-database
   '((Courier                           ; the family key
-     "Courier" "Courier-Bold" "Courier-Oblique" "Courier-BoldOblique"
-     10.0 10.55 6.0     6.0)
+     (fonts (normal      . "Courier")
+           (bold        . "Courier-Bold")
+           (italic      . "Courier-Oblique")
+           (bold-italic . "Courier-BoldOblique"))
+     (size . 10.0)
+     (line-height . 10.55)
+     (space-width . 6.0)
+     (avg-char-width . 6.0))
     (Helvetica                         ; the family key
-     "Helvetica" "Helvetica-Bold" "Helvetica-Oblique" "Helvetica-BoldOblique"
-     10.0 11.56 2.78    5.09243)
+     (fonts (normal      . "Helvetica")
+           (bold        . "Helvetica-Bold")
+           (italic      . "Helvetica-Oblique")
+           (bold-italic . "Helvetica-BoldOblique"))
+     (size . 10.0)
+     (line-height . 11.56)
+     (space-width . 2.78)
+     (avg-char-width . 5.09243))
     (Times
-     "Times-Roman" "Times-Bold" "Times-Italic" "Times-BoldItalic"
-     10.0 11.0  2.5     4.71432)
+     (fonts (normal      . "Times-Roman")
+           (bold        . "Times-Bold")
+           (italic      . "Times-Italic")
+           (bold-italic . "Times-BoldItalic"))
+     (size . 10.0)
+     (line-height . 11.0)
+     (space-width . 2.5)
+     (avg-char-width . 4.71432))
     (Palatino
-     "Palatino-Roman" "Palatino-Bold" "Palatino-Italic" "Palatino-BoldItalic"
-     10.0 12.1  2.5     5.08676)
+     (fonts (normal      . "Palatino-Roman")
+           (bold        . "Palatino-Bold")
+           (italic      . "Palatino-Italic")
+           (bold-italic . "Palatino-BoldItalic"))
+     (size . 10.0)
+     (line-height . 12.1)
+     (space-width . 2.5)
+     (avg-char-width . 5.08676))
     (Helvetica-Narrow
-     "Helvetica-Narrow" "Helvetica-Narrow-Bold"
-     "Helvetica-Narrow-Oblique" "Helvetica-Narrow-BoldOblique"
-     10.0 11.56 2.2796  4.17579)
+     (fonts (normal      . "Helvetica-Narrow")
+           (bold        . "Helvetica-Narrow-Bold")
+           (italic      . "Helvetica-Narrow-Oblique")
+           (bold-italic . "Helvetica-Narrow-BoldOblique"))
+     (size . 10.0)
+     (line-height . 11.56)
+     (space-width . 2.2796)
+     (avg-char-width . 4.17579))
     (NewCenturySchlbk
-     "NewCenturySchlbk-Roman" "NewCenturySchlbk-Bold"
-     "NewCenturySchlbk-Italic" "NewCenturySchlbk-BoldItalic"
-     10.0 12.15 2.78    5.31162)
+     (fonts (normal      . "NewCenturySchlbk-Roman")
+           (bold        . "NewCenturySchlbk-Bold")
+           (italic      . "NewCenturySchlbk-Italic")
+           (bold-italic . "NewCenturySchlbk-BoldItalic"))
+     (size . 10.0)
+     (line-height . 12.15)
+     (space-width . 2.78)
+     (avg-char-width . 5.31162))
     ;; got no bold for the next ones
     (AvantGarde-Book
-     "AvantGarde-Book" "AvantGarde-Book"
-     "AvantGarde-BookOblique" "AvantGarde-BookOblique"
-     10.0 11.77 2.77    5.45189)
+     (fonts (normal . "AvantGarde-Book")
+           (italic . "AvantGarde-BookOblique"))
+     (size . 10.0)
+     (line-height . 11.77)
+     (space-width . 2.77)
+     (avg-char-width . 5.45189))
     (AvantGarde-Demi
-     "AvantGarde-Demi" "AvantGarde-Demi"
-     "AvantGarde-DemiOblique" "AvantGarde-DemiOblique"
-     10.0 12.72 2.8     5.51351)
+     (fonts (normal . "AvantGarde-Demi")
+           (italic . "AvantGarde-DemiOblique"))
+     (size . 10.0)
+     (line-height . 12.72)
+     (space-width . 2.8)
+     (avg-char-width . 5.51351))
     (Bookman-Demi
-     "Bookman-Demi" "Bookman-Demi"
-     "Bookman-DemiItalic" "Bookman-DemiItalic"
-     10.0 11.77 3.4     6.05946)
+     (fonts (normal . "Bookman-Demi")
+           (italic . "Bookman-DemiItalic"))
+     (size . 10.0)
+     (line-height . 11.77)
+     (space-width . 3.4)
+     (avg-char-width . 6.05946))
     (Bookman-Light
-     "Bookman-Light" "Bookman-Light"
-     "Bookman-LightItalic" "Bookman-LightItalic"
-     10.0 11.79 3.2     5.67027)
+     (fonts (normal . "Bookman-Light")
+           (italic . "Bookman-LightItalic"))
+     (size . 10.0)
+     (line-height . 11.79)
+     (space-width . 3.2)
+     (avg-char-width . 5.67027))
     ;; got no bold and no italic for the next ones
     (Symbol
-     "Symbol" "Symbol" "Symbol" "Symbol"
-     10.0 13.03 2.5     3.24324)
+     (fonts (normal . "Symbol"))
+     (size . 10.0)
+     (line-height . 13.03)
+     (space-width . 2.5)
+     (avg-char-width . 3.24324))
     (Zapf-Dingbats
-     "Zapf-Dingbats" "Zapf-Dingbats" "Zapf-Dingbats" "Zapf-Dingbats"
-     10.0  9.63 2.78    2.78)
+     (fonts (normal . "Zapf-Dingbats"))
+     (size . 10.0)
+     (line-height . 9.63)
+     (space-width . 2.78)
+     (avg-char-width . 2.78))
     (Zapf-Chancery-MediumItalic
-     "Zapf-Chancery-MediumItalic" "Zapf-Chancery-MediumItalic"
-     "Zapf-Chancery-MediumItalic" "Zapf-Chancery-MediumItalic"
-     10.0 11.45 2.2     4.10811)
-)
+     (fonts (normal . "Zapf-Chancery-MediumItalic"))
+     (size . 10.0)
+     (line-height . 11.45)
+     (space-width . 2.2)
+     (avg-char-width . 4.10811))
+    )
   "*Font info database: font family (the key), name, bold, italic, bold-italic,
 reference size, line height, space width, average character width.
 To get the info for another specific font (say Helvetica), do the following:
 - create a new buffer
 - generate the PostScript image to a file (C-u M-x ps-print-buffer)
-- open this file and delete the leading `%' (which is the Postscript
+- open this file and delete the leading `%' (which is the PostScript
   comment character) from the line
-       `% 3 cm 20 cm moveto  10 /Courier ReportFontInfo  showpage'
+          `% 3 cm 20 cm moveto  10 /Courier ReportFontInfo  showpage'
   to get the line
-       `3 cm 20 cm moveto  10 /Helvetica ReportFontInfo  showpage'
+          `3 cm 20 cm moveto  10 /Helvetica ReportFontInfo  showpage'
 - add the values to `ps-font-info-database'.
 You can get all the fonts of YOUR printer using `ReportAllFontInfo'."
   :type '(repeat (list :tag "Font Definition"
-                      (symbol :tag "Font")
-                      (string :tag "Name")
-                      (string :tag "Bold")
-                      (string :tag "Italic")
-                      (string :tag "Bold-Italic")
-                      (number :tag "Reference Size")
-                      (number :tag "Line Height")
-                      (number :tag "Space Width")
-                      (number :tag "Average Character Width")))
+                      (symbol :tag "Font Family")
+                      (cons :format "%v"
+                            (const :format "" fonts)
+                            (repeat :tag "Faces"
+                                    (cons (choice (const normal)
+                                                  (const bold)
+                                                  (const italic)
+                                                  (const bold-italic)
+                                                  (symbol :tag "Face"))
+                                          (string :tag "Font Name"))))
+                      (cons :format "%v"
+                            (const :format "" size)
+                            (number :tag "Reference Size"))
+                      (cons :format "%v"
+                            (const :format "" line-height)
+                            (number :tag "Line Height"))
+                      (cons :format "%v"
+                            (const :format "" space-width)
+                            (number :tag "Space Width"))
+                      (cons :format "%v"
+                            (const :format "" avg-char-width)
+                            (number :tag "Average Character Width"))))
   :group 'ps-print-font)
 
 (defcustom ps-font-family 'Courier
-  "Font family name for ordinary text, when generating Postscript."
+  "*Font family name for ordinary text, when generating PostScript."
   :type 'symbol
   :group 'ps-print-font)
 
-(defcustom ps-font-size   (if ps-landscape-mode 7 8.5)
-  "Font size, in points, for ordinary text, when generating Postscript."
-  :type 'number
+(defcustom ps-font-size   '(7 . 8.5)
+  "*Font size, in points, for ordinary text, when generating PostScript."
+  :type '(choice (number :tag "Text Size")
+                (cons :tag "Landscape/Portrait"
+                      (number :tag "Landscape Text Size")
+                      (number :tag "Portrait Text Size")))
   :group 'ps-print-font)
 
 (defcustom ps-header-font-family      'Helvetica
-  "Font family name for text in the header, when generating Postscript."
+  "*Font family name for text in the header, when generating PostScript."
   :type 'symbol
   :group 'ps-print-font)
 
-(defcustom ps-header-font-size       (if ps-landscape-mode 10 12)
-  "Font size, in points, for text in the header, when generating Postscript."
-  :type 'number
+(defcustom ps-header-font-size       '(10 . 12)
+  "*Font size, in points, for text in the header, when generating PostScript."
+  :type '(choice (number :tag "Header Size")
+                (cons :tag "Landscape/Portrait"
+                      (number :tag "Landscape Header Size")
+                      (number :tag "Portrait Header Size")))
   :group 'ps-print-font)
 
-(defcustom ps-header-title-font-size (if ps-landscape-mode 12 14)
-  "Font size, in points, for the top line of text in the header,
-when generating Postscript."
-  :type 'number
+(defcustom ps-header-title-font-size '(12 . 14)
+  "*Font size, in points, for the top line of text in header, in PostScript."
+  :type '(choice (number :tag "Header Title Size")
+                (cons :tag "Landscape/Portrait"
+                      (number :tag "Landscape Header Title Size")
+                      (number :tag "Portrait Header Title Size")))
   :group 'ps-print-font)
 
 ;;; Colors
 
-(defcustom ps-print-color-p (or (fboundp 'x-color-values)   ; Emacs
-                               (fboundp 'pixel-components) ; XEmacs
-                                       ; xemacs
-; Printing color requires x-color-values.
+;; Printing color requires x-color-values.
+(defcustom ps-print-color-p (or (fboundp 'x-color-values) ; Emacs
+                               (fboundp 'color-instance-rgb-components))
+                                       ; XEmacs
   "*If non-nil, print the buffer's text in color."
   :type 'boolean
   :group 'ps-print-color)
@@ -955,7 +1579,7 @@ when generating Postscript."
 
 (defcustom ps-auto-font-detect t
   "*Non-nil means automatically detect bold/italic face attributes.
-nil means rely solely on the lists `ps-bold-faces', `ps-italic-faces',
+If nil, we rely solely on the lists `ps-bold-faces', `ps-italic-faces',
 and `ps-underlined-faces'."
   :type 'boolean
   :group 'ps-print-font)
@@ -968,36 +1592,36 @@ and `ps-underlined-faces'."
       font-lock-keyword-face
       font-lock-warning-face))
   "*A list of the \(non-bold\) faces that should be printed in bold font.
-This applies to generating Postscript."
+This applies to generating PostScript."
   :type '(repeat face)
   :group 'ps-print-face)
 
 (defcustom ps-italic-faces
   (unless ps-print-color-p
     '(font-lock-variable-name-face
+      font-lock-type-face
       font-lock-string-face
       font-lock-comment-face
       font-lock-warning-face))
   "*A list of the \(non-italic\) faces that should be printed in italic font.
-This applies to generating Postscript."
+This applies to generating PostScript."
   :type '(repeat face)
   :group 'ps-print-face)
 
 (defcustom ps-underlined-faces
   (unless ps-print-color-p
     '(font-lock-function-name-face
-      font-lock-type-face
-      font-lock-reference-face
+      font-lock-constant-face
       font-lock-warning-face))
   "*A list of the \(non-underlined\) faces that should be printed underlined.
-This applies to generating Postscript."
+This applies to generating PostScript."
   :type '(repeat face)
   :group 'ps-print-face)
 
 (defcustom ps-left-header
   (list 'ps-get-buffer-name 'ps-header-dirpart)
   "*The items to display (each on a line) on the left part of the page header.
-This applies to generating Postscript.
+This applies to generating PostScript.
 
 The value should be a list of strings and symbols, each representing an
 entry in the PostScript array HeaderLinesLeft.
@@ -1012,18 +1636,18 @@ values, the value should be a string to be inserted into the array.
 In either case, function or variable, the string value has PostScript
 string delimiters added to it."
   :type '(repeat (choice string symbol))
-  :group ps-print-header)
+  :group 'ps-print-header)
 (make-variable-buffer-local 'ps-left-header)
 
 (defcustom ps-right-header
   (list "/pagenumberstring load" 'time-stamp-mon-dd-yyyy 'time-stamp-hh:mm:ss)
   "*The items to display (each on a line) on the right part of the page header.
-This applies to generating Postscript.
+This applies to generating PostScript.
 
 See the variable `ps-left-header' for a description of the format of
 this variable."
   :type '(repeat (choice string symbol))
-  :group ps-print-header)
+  :group 'ps-print-header)
 (make-variable-buffer-local 'ps-right-header)
 
 (defcustom ps-razzle-dazzle t
@@ -1031,15 +1655,17 @@ this variable."
   :type 'boolean
   :group 'ps-print)
 
-(defvar ps-adobe-tag "%!PS-Adobe-1.0\n"
+(defcustom ps-adobe-tag "%!PS-Adobe-3.0\n"
   "*Contains the header line identifying the output as PostScript.
 By default, `ps-adobe-tag' contains the standard identifier.  Some
-printers require slightly different versions of this line.")
+printers require slightly different versions of this line."
+  :type 'string
+  :group 'ps-print)
 
 (defcustom ps-build-face-reference t
   "*Non-nil means build the reference face lists.
 
-Ps-print sets this value to nil after it builds its internal reference
+ps-print sets this value to nil after it builds its internal reference
 lists of bold and italic faces.  By settings its value back to t, you
 can force ps-print to rebuild the lists the next time you invoke one
 of the ...-with-faces commands.
@@ -1055,7 +1681,7 @@ about its setting, though."
 
 If this variable is non-nil, ps-print will rebuild its internal
 reference lists of bold and italic faces *every* time one of the
--with-faces commands is called.  Most users shouldn't need to set this
+...-with-faces commands is called.  Most users shouldn't need to set this
 variable."
   :type 'boolean
   :group 'ps-print-face)
@@ -1067,19 +1693,15 @@ variable."
 (defun ps-print-buffer (&optional filename)
   "Generate and print a PostScript image of the buffer.
 
-When called with a numeric prefix argument (C-u), prompts the user for
-the name of a file to save the PostScript image in, instead of sending
-it to the printer.
+Interactively, when you use a prefix argument (C-u), the command
+prompts the user for a file name, and saves the PostScript image
+in that file instead of sending it to the printer.
 
-More specifically, the FILENAME argument is treated as follows: if it
+Noninteractively, the argument FILENAME is treated as follows: if it
 is nil, send the image to the printer.  If FILENAME is a string, save
-the PostScript image in a file with that name.  If FILENAME is a
-number, prompt the user for the name of the file to save in."
-
+the PostScript image in a file with that name."
   (interactive (list (ps-print-preprint current-prefix-arg)))
-  (ps-generate (current-buffer) (point-min) (point-max)
-              'ps-generate-postscript)
-  (ps-do-despool filename))
+  (ps-print-without-faces (point-min) (point-max) filename))
 
 
 ;;;###autoload
@@ -1089,20 +1711,15 @@ Like `ps-print-buffer', but includes font, color, and underline
 information in the generated image.  This command works only if you
 are using a window system, so it has a way to determine color values."
   (interactive (list (ps-print-preprint current-prefix-arg)))
-  (ps-generate (current-buffer) (point-min) (point-max)
-              'ps-generate-postscript-with-faces)
-  (ps-do-despool filename))
+  (ps-print-with-faces (point-min) (point-max) filename))
 
 
 ;;;###autoload
 (defun ps-print-region (from to &optional filename)
   "Generate and print a PostScript image of the region.
 Like `ps-print-buffer', but prints just the current region."
-
   (interactive (list (point) (mark) (ps-print-preprint current-prefix-arg)))
-  (ps-generate (current-buffer) from to
-              'ps-generate-postscript)
-  (ps-do-despool filename))
+  (ps-print-without-faces from to filename t))
 
 
 ;;;###autoload
@@ -1111,11 +1728,8 @@ Like `ps-print-buffer', but prints just the current region."
 Like `ps-print-region', but includes font, color, and underline
 information in the generated image.  This command works only if you
 are using a window system, so it has a way to determine color values."
-
   (interactive (list (point) (mark) (ps-print-preprint current-prefix-arg)))
-  (ps-generate (current-buffer) from to
-              'ps-generate-postscript-with-faces)
-  (ps-do-despool filename))
+  (ps-print-with-faces from to filename t))
 
 
 ;;;###autoload
@@ -1126,8 +1740,7 @@ local buffer to be sent to the printer later.
 
 Use the command `ps-despool' to send the spooled images to the printer."
   (interactive)
-  (ps-generate (current-buffer) (point-min) (point-max)
-              'ps-generate-postscript))
+  (ps-spool-without-faces (point-min) (point-max)))
 
 
 ;;;###autoload
@@ -1138,10 +1751,8 @@ information in the generated image.  This command works only if you
 are using a window system, so it has a way to determine color values.
 
 Use the command `ps-despool' to send the spooled images to the printer."
-
   (interactive)
-  (ps-generate (current-buffer) (point-min) (point-max)
-              'ps-generate-postscript-with-faces))
+  (ps-spool-with-faces (point-min) (point-max)))
 
 
 ;;;###autoload
@@ -1151,8 +1762,7 @@ Like `ps-spool-buffer', but spools just the current region.
 
 Use the command `ps-despool' to send the spooled images to the printer."
   (interactive "r")
-  (ps-generate (current-buffer) from to
-              'ps-generate-postscript))
+  (ps-spool-without-faces from to t))
 
 
 ;;;###autoload
@@ -1164,27 +1774,25 @@ are using a window system, so it has a way to determine color values.
 
 Use the command `ps-despool' to send the spooled images to the printer."
   (interactive "r")
-  (ps-generate (current-buffer) from to
-              'ps-generate-postscript-with-faces))
+  (ps-spool-with-faces from to t))
 
 ;;;###autoload
 (defun ps-despool (&optional filename)
   "Send the spooled PostScript to the printer.
 
-When called with a numeric prefix argument (C-u), prompt the user for
-the name of a file to save the spooled PostScript in, instead of sending
-it to the printer.
+Interactively, when you use a prefix argument (C-u), the command
+prompts the user for a file name, and saves the spooled PostScript
+image in that file instead of sending it to the printer.
 
-More specifically, the FILENAME argument is treated as follows: if it
+Noninteractively, the argument FILENAME is treated as follows: if it
 is nil, send the image to the printer.  If FILENAME is a string, save
-the PostScript image in a file with that name.  If FILENAME is a
-number, prompt the user for the name of the file to save in."
+the PostScript image in a file with that name."
   (interactive (list (ps-print-preprint current-prefix-arg)))
   (ps-do-despool filename))
 
 ;;;###autoload
 (defun ps-line-lengths ()
-  "*Display the correspondance between a line length and a font size,
+  "Display the correspondence between a line length and a font size,
 using the current ps-print setup.
 Try: pr -t file | awk '{printf \"%3d %s\n\", length($0), $0}' | sort -r | head"
   (interactive)
@@ -1192,78 +1800,112 @@ Try: pr -t file | awk '{printf \"%3d %s\n\", length($0), $0}' | sort -r | head"
 
 ;;;###autoload
 (defun ps-nb-pages-buffer (nb-lines)
-  "*Display an approximate correspondance between a font size and the number
-of pages the current buffer would require to print
-using the current ps-print setup."
+  "Display number of pages to print this buffer, for various font heights.
+The table depends on the current ps-print setup."
   (interactive (list (count-lines (point-min) (point-max))))
   (ps-nb-pages nb-lines))
 
 ;;;###autoload
 (defun ps-nb-pages-region (nb-lines)
-  "*Display an approximate correspondance between a font size and the number
-of pages the current region would require to print
-using the current ps-print setup."
+  "Display number of pages to print the region, for various font heights.
+The table depends on the current ps-print setup."
   (interactive (list (count-lines (mark) (point))))
   (ps-nb-pages nb-lines))
 
 ;;;###autoload
 (defun ps-setup ()
-  "*Return the current setup"
-  (format "
- (setq ps-print-color-p  %s
-      ps-lpr-command    \"%s\"
+  "Return the current PostScript-generation setup."
+  (format
+   "
+\(setq ps-print-color-p  %s
+      ps-lpr-command    %S
       ps-lpr-switches   %s
-
-      ps-paper-type       '%s
-      ps-landscape-mode   %s
-      ps-number-of-columns %s
-
-      ps-left-margin   %s
-      ps-right-margin  %s
-      ps-inter-column  %s
-      ps-bottom-margin %s
-      ps-top-margin    %s
-      ps-header-offset %s
-      ps-header-line-pad    %s
-      ps-print-header       %s
-      ps-print-header-frame %s
-      ps-header-lines       %s
-      ps-show-n-of-n        %s
-      ps-spool-duplex       %s
-
-      ps-font-family             '%s
-      ps-font-size               %s
-      ps-header-font-family      '%s
-      ps-header-font-size        %s
-      ps-header-title-font-size  %s)
+      ps-printer-name   %S
+
+      ps-paper-type          %s
+      ps-landscape-mode      %s
+      ps-number-of-columns   %s
+
+      ps-zebra-stripes       %s
+      ps-zebra-stripe-height %s
+      ps-line-number         %s
+
+      ps-print-control-characters %s
+
+      ps-print-background-image %s
+
+      ps-print-background-text %s
+
+      ps-print-prologue-header %s
+
+      ps-left-margin           %s
+      ps-right-margin          %s
+      ps-inter-column          %s
+      ps-bottom-margin         %s
+      ps-top-margin            %s
+      ps-header-offset         %s
+      ps-header-line-pad       %s
+      ps-print-header          %s
+      ps-print-only-one-header %s
+      ps-print-header-frame    %s
+      ps-header-lines          %s
+      ps-show-n-of-n           %s
+      ps-spool-duplex          %s
+
+      ps-multibyte-buffer       %s
+      ps-font-family            %s
+      ps-font-size              %s
+      ps-header-font-family     %s
+      ps-header-font-size       %s
+      ps-header-title-font-size %s)
 "
-  ps-print-color-p
-  ps-lpr-command
-  ps-lpr-switches
-  ps-paper-type
-  ps-landscape-mode
-  ps-number-of-columns
-  ps-left-margin
-  ps-right-margin
-  ps-inter-column
-  ps-bottom-margin
-  ps-top-margin
-  ps-header-offset
-  ps-header-line-pad
-  ps-print-header
-  ps-print-header-frame
-  ps-header-lines
-  ps-show-n-of-n
-  ps-spool-duplex
-  ps-font-family
-  ps-font-size
-  ps-header-font-family
-  ps-header-font-size
-  ps-header-title-font-size))
+   ps-print-color-p
+   ps-lpr-command
+   (ps-print-quote ps-lpr-switches)
+   ps-printer-name
+   (ps-print-quote ps-paper-type)
+   ps-landscape-mode
+   ps-number-of-columns
+   ps-zebra-stripes
+   ps-zebra-stripe-height
+   ps-line-number
+   (ps-print-quote ps-print-control-characters)
+   (ps-print-quote ps-print-background-image)
+   (ps-print-quote ps-print-background-text)
+   (ps-print-quote ps-print-prologue-header)
+   ps-left-margin
+   ps-right-margin
+   ps-inter-column
+   ps-bottom-margin
+   ps-top-margin
+   ps-header-offset
+   ps-header-line-pad
+   ps-print-header
+   ps-print-only-one-header
+   ps-print-header-frame
+   ps-header-lines
+   ps-show-n-of-n
+   ps-spool-duplex
+   (ps-print-quote ps-multibyte-buffer)        ; see `ps-mule.el'
+   (ps-print-quote ps-font-family)
+   (ps-print-quote ps-font-size)
+   (ps-print-quote ps-header-font-family)
+   (ps-print-quote ps-header-font-size)
+   (ps-print-quote ps-header-title-font-size)))
 
 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 ;; Utility functions and variables:
 
+(defun ps-print-quote (sym)
+  (cond ((null sym)
+        nil)
+       ((or (symbolp sym) (listp sym))
+        (format "'%S" sym))
+       ((stringp sym)
+        (format "%S" sym))
+       (t
+        sym)))
+
 (defvar ps-print-emacs-type
   (cond ((string-match "XEmacs" emacs-version) 'xemacs)
        ((string-match "Lucid" emacs-version) 'lucid)
@@ -1277,36 +1919,22 @@ using the current ps-print setup."
   (require 'faces))                    ; face-font, face-underline-p,
                                        ; x-font-regexp
 
-(require 'time-stamp)
-
-(defvar ps-font nil
-  "Font family name for ordinary text, when generating Postscript.")
-
-(defvar ps-font-bold nil
-  "Font family name for bold text, when generating Postscript.")
+;; Return t if the device (which can be changed during an emacs session)
+;; can handle colors.
+;; This is function is not yet implemented for GNU emacs.
+(cond ((and (eq ps-print-emacs-type 'xemacs)
+           (>= emacs-minor-version 12)) ; xemacs
+       (defun ps-color-device ()
+        (eq (device-class) 'color))
+       )
 
-(defvar ps-font-italic nil
-  "Font family name for italic text, when generating Postscript.")
+      (t                               ; emacs
+       (defun ps-color-device ()
+        t)
+       ))
 
-(defvar ps-font-bold-italic nil
-  "Font family name for bold italic text, when generating Postscript.")
 
-(defvar ps-avg-char-width nil
-  "The average width, in points, of a character, for generating Postscript.
-This is the value that ps-print uses to determine the length,
-x-dimension, of the text it has printed, and thus affects the point at
-which long lines wrap around.")
-
-(defvar ps-space-width nil
-  "The width of a space character, for generating Postscript.
-This value is used in expanding tab characters.")
-
-(defvar ps-line-height nil
-  "The height of a line, for generating Postscript.
-This is the value that ps-print uses to determine the height,
-y-dimension, of the lines of text it has printed, and thus affects the
-point at which page-breaks are placed.
-The line-height is *not* the same as the point size of the font.")
+(require 'time-stamp)
 
 (defvar ps-print-prologue-1
   "% ISOLatin1Encoding stolen from ps_init.ps in GhostScript 2.6.1.4:
@@ -1358,7 +1986,7 @@ StandardEncoding 46 82 getinterval aload pop
 
 /reencodeFontISO { %def
   dup
-  length 5 add dict    % Make a new font (a new dict the same size
+  length 12 add dict   % Make a new font (a new dict the same size
                        % as the old one) with room for our new symbols.
 
   begin                        % Make the new font the current dictionary.
@@ -1369,8 +1997,10 @@ StandardEncoding 46 82 getinterval aload pop
     } forall           % Copy each of the symbols from the old dictionary
                        % to the new one except for the font ID.
 
-    /Encoding ISOLatin1Encoding def    % Override the encoding with
+    currentdict /FontType get 0 ne {
+      /Encoding ISOLatin1Encoding def  % Override the encoding with
                                        % the ISOLatin1 encoding.
+    } if
 
     % Use the font's bounding box to determine the ascent, descent,
     % and overall height; don't forget that these values have to be
@@ -1388,33 +2018,30 @@ StandardEncoding 46 82 getinterval aload pop
 %             |    |   v Descent (usually < 0)
 % (x1 y1) --> +----+ - -
 
-    FontBBox                           % -- x1 y1 x2 y2
-    FontMatrix transform /Ascent  exch def pop
-    FontMatrix transform /Descent exch def pop
+    currentdict /FontType get 0 ne {
+      /FontBBox load aload pop                 % -- x1 y1 x2 y2
+      FontMatrix transform /Ascent  exch def pop
+      FontMatrix transform /Descent exch def pop
+    } {
+      /PrimaryFont FDepVector 0 get def
+      PrimaryFont /FontBBox get aload pop
+      PrimaryFont /FontMatrix get transform /Ascent exch def pop
+      PrimaryFont /FontMatrix get transform /Descent exch def pop
+    } ifelse
+
     /FontHeight Ascent Descent sub def % use `sub' because descent < 0
 
     % Define these in case they're not in the FontInfo
-    % (also, here they're easier to get to.
-    /UnderlinePosition  1 def
-    /UnderlineThickness 1 def
-
-    % Get the underline position and thickness if they're defined.
-    currentdict /FontInfo known {
-      FontInfo
-
-      dup /UnderlinePosition known {
-       dup /UnderlinePosition get
-       0 exch FontMatrix transform exch pop
-       /UnderlinePosition exch def
-      } if
-
-      dup /UnderlineThickness known {
-       /UnderlineThickness get
-       0 exch FontMatrix transform exch pop
-       /UnderlineThickness exch def
-      } if
-
-    } if
+    % (also, here they're easier to get to).
+    /UnderlinePosition  Descent 0.70 mul def
+    /OverlinePosition   Descent UnderlinePosition sub Ascent add def
+    /StrikeoutPosition  Ascent 0.30 mul def
+    /LineThickness      FontHeight 0.05 mul def
+    /Xshadow            FontHeight  0.08 mul def
+    /Yshadow            FontHeight -0.09 mul def
+    /SpaceBackground    Descent neg UnderlinePosition add def
+    /XBox               Descent neg def
+    /YBox               LineThickness 0.7 mul def
 
     currentdict                % Leave the new font on the stack
     end                        % Stop using the font as the current dictionary.
@@ -1428,11 +2055,18 @@ StandardEncoding 46 82 getinterval aload pop
 
 /F {                                   % Font selection
   findfont
-  dup /Ascent             get /Ascent             exch def
-  dup /Descent            get /Descent            exch def
-  dup /FontHeight         get /FontHeight         exch def
-  dup /UnderlinePosition  get /UnderlinePosition  exch def
-  dup /UnderlineThickness get /UnderlineThickness exch def
+  dup /Ascent            get /Ascent            exch def
+  dup /Descent           get /Descent           exch def
+  dup /FontHeight        get /FontHeight        exch def
+  dup /UnderlinePosition get /UnderlinePosition exch def
+  dup /OverlinePosition  get /OverlinePosition  exch def
+  dup /StrikeoutPosition get /StrikeoutPosition exch def
+  dup /LineThickness     get /LineThickness     exch def
+  dup /Xshadow           get /Xshadow           exch def
+  dup /Yshadow           get /Yshadow           exch def
+  dup /SpaceBackground   get /SpaceBackground   exch def
+  dup /XBox              get /XBox              exch def
+  dup /YBox              get /YBox              exch def
   setfont
 } def
 
@@ -1441,7 +2075,10 @@ StandardEncoding 46 82 getinterval aload pop
 /bg false def
 /BG {
   dup /bg exch def
-  { mark 4 1 roll ] /bgcolor exch def } if
+  {mark 4 1 roll ]}
+  {[ 1.0 1.0 1.0 ]}
+  ifelse
+  /bgcolor exch def
 } def
 
 %  B    width    C
@@ -1467,22 +2104,6 @@ StandardEncoding 46 82 getinterval aload pop
   grestore
 } def
 
-/dobackgroundstring {                  % string --
-  stringwidth pop
-  dobackground
-} def
-
-/dounderline {                         % fromx fromy --
-  currentpoint
-  gsave
-    UnderlineThickness setlinewidth
-    4 2 roll
-    UnderlinePosition add moveto
-    UnderlinePosition add lineto
-    stroke
-  grestore
-} def
-
 /eolbg {                               % dobackground until right margin
   PrintWidth                           % -- x-eol
   currentpoint pop                     % -- cur-x
@@ -1490,57 +2111,238 @@ StandardEncoding 46 82 getinterval aload pop
   dobackground
 } def
 
-/eolul {                               % idem for underline
-  PrintWidth                           % -- x-eol
-  currentpoint exch pop                        % -- x-eol cur-y
-  dounderline
-} def
+/PLN {PrintLineNumber {doLineNumber}if} def
 
 /SL {                                  % Soft Linefeed
   bg { eolbg } if
-  ul { eolul } if
   0  currentpoint exch pop LineHeight sub  moveto
 } def
 
-/HL /SL load def                       % Hard Linefeed
-
-/sp1 { currentpoint 3 -1 roll } def
+/HL {SL PLN} def                       % Hard Linefeed
 
 % Some debug
 /dcp { currentpoint exch 40 string cvs print (, ) print = } def
-/dp { print 2 copy
-   exch 40 string cvs print (, ) print = } def
-
-/S {
-  bg { dup dobackgroundstring } if
-  ul { sp1 } if
-  show
-  ul { dounderline } if
-} def
+/dp { print 2 copy  exch 40 string cvs print (, ) print = } def
 
 /W {
-  ul { sp1 } if
   ( ) stringwidth      % Get the width of a space in the current font.
   pop                  % Discard the Y component.
   mul                  % Multiply the width of a space
                        % by the number of spaces to plot
   bg { dup dobackground } if
   0 rmoveto
-  ul { dounderline } if
+} def
+
+/Effect 0 def
+/EF {/Effect exch def} def
+
+% stack:  string  |-  --
+% effect: 1  - underline  2   - strikeout  4  - overline
+%         8  - shadow     16  - box        32 - outline
+/S {
+  /xx currentpoint dup Descent add /yy exch def
+  Ascent add /YY exch def def
+  dup stringwidth pop xx add /XX exch def
+  Effect 8 and 0 ne {
+    /yy yy Yshadow add def
+    /XX XX Xshadow add def
+  } if
+  bg {
+    true
+    Effect 16 and 0 ne
+      {SpaceBackground doBox}
+      {xx yy XX YY doRect}
+    ifelse
+  } if                                                 % background
+  Effect 16 and 0 ne {false 0 doBox}if                 % box
+  Effect 8  and 0 ne {dup doShadow}if                  % shadow
+  Effect 32 and 0 ne
+    {true doOutline}                                   % outline
+    {show}                                             % normal text
+  ifelse
+  Effect 1  and 0 ne {UnderlinePosition Hline}if       % underline
+  Effect 2  and 0 ne {StrikeoutPosition Hline}if       % strikeout
+  Effect 4  and 0 ne {OverlinePosition  Hline}if       % overline
+} bind def
+
+% stack:  position  |-  --
+/Hline {
+  currentpoint exch pop add dup
+  gsave
+  newpath
+  xx exch moveto
+  XX exch lineto
+  closepath
+  LineThickness setlinewidth stroke
+  grestore
+} bind def
+
+% stack:  fill-or-not delta  |-  --
+/doBox {
+  /dd exch def
+  xx XBox sub dd sub yy YBox sub dd sub
+  XX XBox add dd add YY YBox add dd add
+  doRect
+} bind def
+
+% stack:  fill-or-not lower-x lower-y upper-x upper-y  |-  --
+/doRect {
+  /rYY exch def
+  /rXX exch def
+  /ryy exch def
+  /rxx exch def
+  gsave
+  newpath
+  rXX rYY moveto
+  rxx rYY lineto
+  rxx ryy lineto
+  rXX ryy lineto
+  closepath
+  % top of stack: fill-or-not
+    {FillBgColor}
+    {LineThickness setlinewidth stroke}
+  ifelse
+  grestore
+} bind def
+
+% stack:  string  |-  --
+/doShadow {
+  gsave
+  Xshadow Yshadow rmoveto
+  false doOutline
+  grestore
+} bind def
+
+/st 1 string def
+
+% stack:  string fill-or-not  |-  --
+/doOutline {
+  /-fillp- exch def
+  /-ox- currentpoint /-oy- exch def def
+  gsave
+  LineThickness setlinewidth
+  {
+    st 0 3 -1 roll put
+    st dup true charpath
+    -fillp- {gsave FillBgColor grestore}if
+    stroke stringwidth
+    -oy- add /-oy- exch def
+    -ox- add /-ox- exch def
+    -ox- -oy- moveto
+  } forall
+  grestore
+  -ox- -oy- moveto
+} bind def
+
+% stack:  --
+/FillBgColor {bgcolor aload pop setrgbcolor fill} bind def
+
+/L0 6 /Times-Italic DefFont
+
+% stack:  --
+/doLineNumber {
+  /LineNumber where
+  {
+    pop
+    currentfont
+    gsave
+    0.0 0.0 0.0 setrgbcolor
+    /L0 findfont setfont
+    LineNumber Lines ge
+      {(end      )}
+      {LineNumber 6 string cvs (      ) strcat}
+    ifelse
+    dup stringwidth pop neg 0 rmoveto
+    show
+    grestore
+    setfont
+    /LineNumber LineNumber 1 add def
+  } if
+} def
+
+% stack: --
+/printZebra {
+  gsave
+  0.985 setgray
+  /double-zebra ZebraHeight ZebraHeight add def
+  /yiter double-zebra LineHeight mul neg def
+  /xiter PrintWidth InterColumn add def
+  NumberOfColumns {LinesPerColumn doColumnZebra xiter 0 rmoveto}repeat
+  grestore
+} def
+
+% stack:  lines-per-column |- --
+/doColumnZebra {
+  gsave
+  dup double-zebra idiv {ZebraHeight doZebra 0 yiter rmoveto}repeat
+  double-zebra mod
+  dup 0 le {pop}{dup ZebraHeight gt {pop ZebraHeight}if doZebra}ifelse
+  grestore
+} def
+
+% stack:  zebra-height (in lines) |- --
+/doZebra {
+  /zh exch 0.05 sub LineHeight mul def
+  gsave
+  0 LineHeight 0.65 mul rmoveto
+  PrintWidth 0 rlineto
+  0 zh neg rlineto
+  PrintWidth neg 0 rlineto
+  0 zh rlineto
+  fill
+  grestore
+} def
+
+% tx ty rotation xscale yscale xpos ypos BeginBackImage
+/BeginBackImage {
+  /-save-image- save def
+  /showpage {}def
+  translate
+  scale
+  rotate
+  translate
+} def
+
+/EndBackImage {
+  -save-image- restore
+} def
+
+% string fontsize fontname rotation gray xpos ypos ShowBackText
+/ShowBackText {
+  gsave
+  translate
+  setgray
+  rotate
+  findfont exch dup /-offset- exch -0.25 mul def scalefont setfont
+  0 -offset- moveto
+  /-saveLineThickness- LineThickness def
+  /LineThickness 1 def
+  false doOutline
+  /LineThickness -saveLineThickness- def
+  grestore
 } def
 
 /BeginDoc {
+  % ---- Remember space width of the normal text font `f0'.
+  /SpaceWidth /f0 findfont setfont ( ) stringwidth pop def
   % ---- save the state of the document (useful for ghostscript!)
   /docState save def
   % ---- [jack] Kludge: my ghostscript window is 21x27.7 instead of 21x29.7
-  /JackGhostscript where {
-    pop 1 27.7 29.7 div scale
-  } if
-  LandscapeMode {
-    % ---- translate to bottom-right corner of Portrait page
-    LandscapePageHeight 0 translate
-    90 rotate
-    } if
+  /JackGhostscript where {pop 1 27.7 29.7 div scale}if
+  % ---- [andrewi] set PageSize based on chosen dimensions
+%  /setpagedevice where {
+%    pop
+%    1 dict dup
+%    /PageSize [ PrintPageWidth LeftMargin add RightMargin add
+%               LandscapePageHeight ] put
+%    setpagedevice
+%  }{
+    LandscapeMode {
+      % ---- translate to bottom-right corner of Portrait page
+      LandscapePageHeight 0 translate
+      90 rotate
+    }if
+%  }ifelse
   /ColumnWidth PrintWidth InterColumn add def
   % ---- translate to lower left corner of TEXT
   LeftMargin BottomMargin translate
@@ -1564,17 +2366,28 @@ StandardEncoding 46 82 getinterval aload pop
   /columnState save def
 } def
 
+/PrintHeaderWidth PrintOnlyOneHeader{PrintPageWidth}{PrintWidth}ifelse def
+
 /BeginPage {
+  % ---- when 1st column, print all background effects
+  ColumnIndex 1 eq {
+  0 PrintStartY moveto                 % move to where printing will start
+  Zebra {printZebra}if
+  printGlobalBackground
+  printLocalBackground
+  } if
   PrintHeader {
-    PrintHeaderFrame { HeaderFrame } if
-    HeaderText
+    PrintOnlyOneHeader{ColumnIndex 1 eq}{true}ifelse {
+      PrintHeaderFrame {HeaderFrame}if
+      HeaderText
+    } if
   } if
   0 PrintStartY moveto                 % move to where printing will start
+  PLN
 } def
 
 /EndPage {
   bg { eolbg } if
-  ul { eolul } if
 } def
 
 /EndDSCPage {
@@ -1593,10 +2406,6 @@ StandardEncoding 46 82 getinterval aload pop
   } ifelse
 } def
 
-/ul false def
-
-/UL { /ul exch def } def
-
 /SetHeaderLines {                      % nb-lines --
   /HeaderLines exch def
   % ---- bottom up
@@ -1624,10 +2433,10 @@ StandardEncoding 46 82 getinterval aload pop
 } def
 
 /HeaderFramePath {
-  PrintWidth    0                      rlineto
-  0             HeaderHeight           rlineto
-  PrintWidth neg 0                     rlineto
-  0             HeaderHeight neg       rlineto
+  PrintHeaderWidth     0                       rlineto
+  0                    HeaderHeight            rlineto
+  PrintHeaderWidth neg 0                       rlineto
+  0                    HeaderHeight neg        rlineto
 } def
 
 /HeaderFrame {
@@ -1697,7 +2506,7 @@ StandardEncoding 46 82 getinterval aload pop
     gsave
       dup xcheck { exec } if
       dup stringwidth pop
-      PrintWidth exch sub HeaderPad 2 mul sub 0 rmoveto
+      PrintHeaderWidth exch sub HeaderPad 2 mul sub 0 rmoveto
       show
     grestore
     0 HeaderLineHeight neg rmoveto
@@ -1774,72 +2583,337 @@ StandardEncoding 46 82 getinterval aload pop
 (defvar ps-output-head nil)
 (defvar ps-output-tail nil)
 
+(defvar ps-page-postscript 0)
 (defvar ps-page-count 0)
-(defvar ps-showpage-count 0)
+(defvar ps-showline-count 1)
+
+(defvar ps-control-or-escape-regexp nil)
+
+(defvar ps-background-pages nil)
+(defvar ps-background-all-pages nil)
+(defvar ps-background-text-count 0)
+(defvar ps-background-image-count 0)
 
 (defvar ps-current-font 0)
-(defvar ps-current-underline-p nil)
-(defvar ps-default-color (if ps-print-color-p ps-default-fg)) ; black
+(defvar ps-default-color (and ps-print-color-p ps-default-fg)) ; black
 (defvar ps-current-color ps-default-color)
 (defvar ps-current-bg nil)
 
 (defvar ps-razchunk 0)
 
+(defvar ps-color-p nil)
 (defvar ps-color-format
   (if (eq ps-print-emacs-type 'emacs)
 
-    ;;Emacs understands the %f format; we'll
-    ;;use it to limit color RGB values to
-    ;;three decimals to cut down some on the
-    ;;size of the PostScript output.
-    "%0.3f %0.3f %0.3f"
+      ;; Emacs understands the %f format; we'll use it to limit color RGB
+      ;; values to three decimals to cut down some on the size of the
+      ;; PostScript output.
+      "%0.3f %0.3f %0.3f"
 
-    ;; Lucid emacsen will have to make do with
-    ;; %s (princ) for floats.
+    ;; Lucid emacsen will have to make do with %s (princ) for floats.
     "%s %s %s"))
 
 ;; These values determine how much print-height to deduct when headers
 ;; are turned on.  This is a pretty clumsy way of handling it, but
 ;; it'll do for now.
 
-(defvar ps-header-font)
-(defvar ps-header-title-font)
-
-(defvar ps-header-line-height)
-(defvar ps-header-title-line-height)
 (defvar ps-header-pad 0
-  "Vertical and horizontal space in points (1/72 inch) between the header frame
-and the text it contains.")
+  "Vertical and horizontal space between the header frame and the text.
+This is in units of points (1/72 inch).")
 
 ;; Define accessors to the dimensions list.
 
 (defmacro ps-page-dimensions-get-width  (dims) `(nth 0 ,dims))
 (defmacro ps-page-dimensions-get-height (dims) `(nth 1 ,dims))
 
-(defvar ps-landscape-page-height)
+(defvar ps-landscape-page-height nil)
 
 (defvar ps-print-width nil)
 (defvar ps-print-height nil)
 
-(defvar ps-height-remaining)
-(defvar ps-width-remaining)
-
-(defvar ps-ref-bold-faces nil)
-(defvar ps-ref-italic-faces nil)
-(defvar ps-ref-underlined-faces nil)
+(defvar ps-height-remaining nil)
+(defvar ps-width-remaining nil)
 
 (defvar ps-print-color-scale nil)
 
+(defvar ps-font-size-internal nil)
+(defvar ps-header-font-size-internal nil)
+(defvar ps-header-title-font-size-internal nil)
+
+\f
+;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
+;; Internal Variables
+
+
+(defvar ps-print-face-extension-alist nil
+  "Alist of symbolic faces *WITH* extension features (box, outline, etc).
+An element of this list has the following form:
+
+   (FACE . [BITS FG BG])
+
+   FACE is a symbol denoting a face name
+   BITS is a bit vector, where each bit correspond
+      to a feature (bold, underline, etc)
+      (see documentation for `ps-print-face-map-alist')
+   FG foreground color (string or nil)
+   BG background color (string or nil)
+
+Don't change this list directly; instead,
+use `ps-extend-face' and `ps-extend-face-list'.
+See documentation for `ps-extend-face' for valid extension symbol.")
+
+
+(defvar ps-print-face-alist nil
+  "Alist of symbolic faces *WITHOUT* extension features (box, outline, etc).
+
+An element of this list has the same form as an element of
+`ps-print-face-extension-alist'.
+
+Don't change this list directly; this list is used by `ps-face-attributes',
+`ps-map-face' and `ps-build-reference-face-lists'.")
+
+
+(defconst ps-print-face-map-alist
+  '((bold        . 1)
+    (italic      . 2)
+    (underline   . 4)
+    (strikeout   . 8)
+    (overline    . 16)
+    (shadow      . 32)
+    (box         . 64)
+    (outline     . 128))
+  "Alist of all features and the corresponding bit mask.
+Each symbol correspond to one bit in a bit vector.")
+
+\f
+;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
+;; Remapping Faces
+
+
+;;;###autoload
+(defun ps-extend-face-list (face-extension-list &optional merge-p)
+  "Extend face in `ps-print-face-extension-alist'.
+
+If optional MERGE-P is non-nil, extensions in FACE-EXTENSION-LIST are merged
+with face extension in `ps-print-face-extension-alist'; otherwise, overrides.
+
+The elements in FACE-EXTENSION-LIST is like those for `ps-extend-face'.
+
+See `ps-extend-face' for documentation."
+  (while face-extension-list
+    (ps-extend-face (car face-extension-list) merge-p)
+    (setq face-extension-list (cdr face-extension-list))))
+
+
+;;;###autoload
+(defun ps-extend-face (face-extension &optional merge-p)
+  "Extend face in `ps-print-face-extension-alist'.
+
+If optional MERGE-P is non-nil, extensions in FACE-EXTENSION list are merged
+with face extensions in `ps-print-face-extension-alist'; otherwise, overrides.
+
+The elements of FACE-EXTENSION list have the form:
+
+   (FACE-NAME FOREGROUND BACKGROUND EXTENSION...)
+
+FACE-NAME is a face name symbol.
+
+FOREGROUND and BACKGROUND may be nil or a string that denotes the
+foreground and background colors respectively.
+
+EXTENSION is one of the following symbols:
+   bold      - use bold font.
+   italic    - use italic font.
+   underline - put a line under text.
+   strikeout - like underline, but the line is in middle of text.
+   overline  - like underline, but the line is over the text.
+   shadow    - text will have a shadow.
+   box       - text will be surrounded by a box.
+   outline   - print characters as hollow outlines.
+
+If EXTENSION is any other symbol, it is ignored."
+  (let* ((face-name  (nth 0 face-extension))
+        (foreground (nth 1 face-extension))
+        (background (nth 2 face-extension))
+        (ps-face (cdr (assq face-name ps-print-face-extension-alist)))
+        (face-vector (or ps-face (vector 0 nil nil)))
+        (face-bit (ps-extension-bit face-extension)))
+    ;; extend face
+    (aset face-vector 0 (if merge-p
+                           (logior (aref face-vector 0) face-bit)
+                         face-bit))
+    (and foreground (stringp foreground) (aset face-vector 1 foreground))
+    (and background (stringp background) (aset face-vector 2 background))
+    ;; if face does not exist, insert it
+    (or ps-face
+       (setq ps-print-face-extension-alist
+             (cons (cons face-name face-vector)
+                   ps-print-face-extension-alist)))))
+
+
+(defun ps-extension-bit (face-extension)
+  (let ((face-bit 0))
+    ;; map valid symbol extension to bit vector
+    (setq face-extension (cdr (cdr face-extension)))
+    (while (setq face-extension (cdr face-extension))
+      (setq face-bit (logior face-bit
+                            (or (cdr (assq (car face-extension)
+                                           ps-print-face-map-alist))
+                                0))))
+    face-bit))
+
+\f
+;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
+;; Adapted from font-lock:
+;; Originally face attributes were specified via `font-lock-face-attributes'.
+;; Users then changed the default face attributes by setting that variable.
+;; However, we try and be back-compatible and respect its value if set except
+;; for faces where M-x customize has been used to save changes for the face.
+
+(defun ps-font-lock-face-attributes ()
+  (and (boundp 'font-lock-mode) (symbol-value 'font-lock-mode)
+       (boundp 'font-lock-face-attributes)
+       (let ((face-attributes font-lock-face-attributes))
+        (while face-attributes
+          (let* ((face-attribute
+                  (car (prog1 face-attributes
+                         (setq face-attributes (cdr face-attributes)))))
+                 (face (car face-attribute)))
+            ;; Rustle up a `defface' SPEC from a
+            ;; `font-lock-face-attributes' entry.
+            (unless (get face 'saved-face)
+              (let ((foreground (nth 1 face-attribute))
+                    (background (nth 2 face-attribute))
+                    (bold-p (nth 3 face-attribute))
+                    (italic-p (nth 4 face-attribute))
+                    (underline-p (nth 5 face-attribute))
+                    face-spec)
+                (when foreground
+                  (setq face-spec (cons ':foreground
+                                        (cons foreground face-spec))))
+                (when background
+                  (setq face-spec (cons ':background
+                                        (cons background face-spec))))
+                (when bold-p
+                  (setq face-spec (append '(:bold t) face-spec)))
+                (when italic-p
+                  (setq face-spec (append '(:italic t) face-spec)))
+                (when underline-p
+                  (setq face-spec (append '(:underline t) face-spec)))
+                (custom-declare-face face (list (list t face-spec)) nil)
+                )))))))
+
+\f
+;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
+;; Internal functions and variables
+
+
+(make-local-hook 'ps-print-hook)
+(make-local-hook 'ps-print-begin-page-hook)
+(make-local-hook 'ps-print-begin-column-hook)
+
+
+(defun ps-print-without-faces (from to &optional filename region-p)
+  (ps-spool-without-faces from to region-p)
+  (ps-do-despool filename))
+
+
+(defun ps-spool-without-faces (from to &optional region-p)
+  (run-hooks 'ps-print-hook)
+  (ps-printing-region region-p)
+  (ps-generate (current-buffer) from to 'ps-generate-postscript))
+
+
+(defun ps-print-with-faces (from to &optional filename region-p)
+  (ps-spool-with-faces from to region-p)
+  (ps-do-despool filename))
+
+
+(defun ps-spool-with-faces (from to &optional region-p)
+  (run-hooks 'ps-print-hook)
+  (ps-printing-region region-p)
+  (ps-generate (current-buffer) from to 'ps-generate-postscript-with-faces))
+
+
+(defsubst ps-count-lines (from to)
+  (+ (count-lines from to)
+     (save-excursion
+       (goto-char to)
+       (if (= (current-column) 0) 1 0))))
+
+
+(defvar ps-printing-region nil
+  "Variable used to indicate if ps-print is printing a region.
+If non-nil, it is a cons, the car of which is the line number
+where the region begins, and its cdr is the total number of lines
+in the buffer.  Formatting functions can use this information
+to print the original line number (and not the number of lines printed),
+and to indicate in the header that the printout is of a partial file.")
+
+
+(defun ps-printing-region (region-p)
+  (setq ps-printing-region
+       (and region-p
+            (cons (ps-count-lines (point-min) (region-beginning))
+                  (ps-count-lines (point-min) (point-max))))))
+
+\f
 ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 ;; Internal functions
 
+(defsubst ps-font-alist (font-sym)
+  (get font-sym 'fonts))
+
+(defun ps-font (font-sym font-type)
+  "Font family name for text of `font-type', when generating PostScript."
+  (let* ((font-list (ps-font-alist font-sym))
+        (normal-font (cdr (assq 'normal font-list))))
+    (while (and font-list (not (eq font-type (car (car font-list)))))
+      (setq font-list (cdr font-list)))
+    (or (cdr (car font-list)) normal-font)))
+
+(defun ps-fonts (font-sym)
+  (mapcar 'cdr (ps-font-alist font-sym)))
+
+(defun ps-font-number (font-sym font-type)
+  (or (ps-alist-position font-type (ps-font-alist font-sym))
+      0))
+
+(defsubst ps-line-height (font-sym)
+  "The height of a line, for generating PostScript.
+This is the value that ps-print uses to determine the height,
+y-dimension, of the lines of text it has printed, and thus affects the
+point at which page-breaks are placed.
+The line-height is *not* the same as the point size of the font."
+  (get font-sym 'line-height))
+
+(defsubst ps-title-line-height (font-sym)
+  "The height of a `title' line, for generating PostScript.
+This is the value that ps-print uses to determine the height,
+y-dimension, of the lines of text it has printed, and thus affects the
+point at which page-breaks are placed.
+The title-line-height is *not* the same as the point size of the font."
+  (get font-sym 'title-line-height))
+
+(defsubst ps-space-width (font-sym)
+  "The width of a space character, for generating PostScript.
+This value is used in expanding tab characters."
+  (get font-sym 'space-width))
+
+(defsubst ps-avg-char-width (font-sym)
+  "The average width, in points, of a character, for generating PostScript.
+This is the value that ps-print uses to determine the length,
+x-dimension, of the text it has printed, and thus affects the point at
+which long lines wrap around."
+  (get font-sym 'avg-char-width))
+
 (defun ps-line-lengths-internal ()
-  "Display the correspondance between a line length and a font size,
+  "Display the correspondence between a line length and a font size,
 using the current ps-print setup.
 Try: pr -t file | awk '{printf \"%3d %s\n\", length($0), $0}' | sort -r | head"
   (let ((buf (get-buffer-create "*Line-lengths*"))
-       (ifs ps-font-size)              ; initial font size
-       (icw ps-avg-char-width)         ; initial character width
+       (ifs ps-font-size-internal)     ; initial font size
+       (icw (ps-avg-char-width 'ps-font-for-text)) ; initial character width
        (print-width (progn (ps-get-page-dimensions)
                            ps-print-width))
        (ps-setup (ps-setup))           ; setup for the current buffer
@@ -1856,28 +2930,28 @@ Try: pr -t file | awk '{printf \"%3d %s\n\", length($0), $0}' | sort -r | head"
     (setq cw-min     (/ (* icw fs-min) ifs)
          nb-cpl-max (floor (/ print-width cw-min))
          cw-max     (/ (* icw fs-max) ifs)
-         nb-cpl-min (floor (/ print-width cw-max)))
-    (setq nb-cpl nb-cpl-min)
+         nb-cpl-min (floor (/ print-width cw-max))
+         nb-cpl     nb-cpl-min)
     (set-buffer buf)
     (goto-char (point-max))
-    (if (not (bolp)) (insert "\n"))
-    (insert ps-setup)
-    (insert "nb char per line / font size\n")
+    (or (bolp) (insert "\n"))
+    (insert ps-setup
+           "nb char per line / font size\n")
     (while (<= nb-cpl nb-cpl-max)
-      (setq cw     (/ print-width (float nb-cpl))
-           fs     (/ (* ifs cw) icw))
+      (setq cw (/ print-width (float nb-cpl))
+           fs (/ (* ifs cw) icw))
       (insert (format "%3s %s\n" nb-cpl fs))
       (setq nb-cpl (1+ nb-cpl)))
     (insert "\n")
     (display-buffer buf 'not-this-window)))
 
 (defun ps-nb-pages (nb-lines)
-  "Display an approximate correspondance between a font size and the number
-of pages the number of lines would require to print
-using the current ps-print setup."
+  "Display correspondence between font size and the number of pages.
+The correspondence is based on having NB-LINES lines of text,
+and on the current ps-print setup."
   (let ((buf (get-buffer-create "*Nb-Pages*"))
-       (ifs ps-font-size)              ; initial font size
-       (ilh ps-line-height)            ; initial line height
+       (ifs ps-font-size-internal)     ; initial font size
+       (ilh (ps-line-height 'ps-font-for-text)) ; initial line height
        (page-height (progn (ps-get-page-dimensions)
                            ps-print-height))
        (ps-setup (ps-setup))           ; setup for the current buffer
@@ -1899,14 +2973,14 @@ using the current ps-print setup."
          nb-page-min (ceiling (/ (float nb-lines) nb-lpp-max))
          lh-max      (/ (* ilh fs-max) ifs)
          nb-lpp-min  (floor (/ page-height lh-max))
-         nb-page-max (ceiling (/ (float nb-lines) nb-lpp-min)))
-    (setq nb-page nb-page-min)
+         nb-page-max (ceiling (/ (float nb-lines) nb-lpp-min))
+         nb-page     nb-page-min)
     (set-buffer buf)
     (goto-char (point-max))
-    (if (not (bolp)) (insert "\n"))
-    (insert ps-setup)
-    (insert (format "%d lines\n" nb-lines))
-    (insert "nb page / font size\n")
+    (or (bolp) (insert "\n"))
+    (insert ps-setup
+           (format "%d lines\n" nb-lines)
+           "nb page / font size\n")
     (while (<= nb-page nb-page-max)
       (setq nb-lpp (ceiling (/ nb-lines (float nb-page)))
            lh     (/ page-height nb-lpp)
@@ -1916,59 +2990,23 @@ using the current ps-print setup."
     (insert "\n")
     (display-buffer buf 'not-this-window)))
 
-(defun ps-select-font ()
-  "Choose the font name and size (scaling data)."
-  (let ((assoc (assq ps-font-family ps-font-info-database))
-       l fn fb fi bi sz lh sw aw)
-    (if (null assoc)
-       (error "Don't have data to scale font %s. Known fonts families are %s"
-              ps-font-family
-              (mapcar 'car ps-font-info-database)))
-    (setq l  (cdr assoc)
-         fn (prog1 (car l) (setq l (cdr l))) ; need `pop'
-         fb (prog1 (car l) (setq l (cdr l)))
-         fi (prog1 (car l) (setq l (cdr l)))
-         bi (prog1 (car l) (setq l (cdr l)))
-         sz (prog1 (car l) (setq l (cdr l)))
-         lh (prog1 (car l) (setq l (cdr l)))
-         sw (prog1 (car l) (setq l (cdr l)))
-         aw (prog1 (car l) (setq l (cdr l))))
-
-    (setq ps-font             fn)
-    (setq ps-font-bold        fb)
-    (setq ps-font-italic      fi)
-    (setq ps-font-bold-italic bi)
-    ;; These data just need to be rescaled:
-    (setq ps-line-height    (/ (* lh ps-font-size) sz))
-    (setq ps-space-width    (/ (* sw ps-font-size) sz))
-    (setq ps-avg-char-width (/ (* aw ps-font-size) sz))
-    ps-font-family))
-
-(defun ps-select-header-font ()
-  "Choose the font name and size (scaling data) for the header."
-  (let ((assoc (assq ps-header-font-family ps-font-info-database))
-       l fn fb fi bi sz lh sw aw)
-    (if (null assoc)
+;; macros used in `ps-select-font'
+(defmacro ps-lookup (key) `(cdr (assq ,key font-entry)))
+(defmacro ps-size-scale (key) `(/ (* (ps-lookup ,key) font-size) size))
+
+(defun ps-select-font (font-family sym font-size title-font-size)
+  (let ((font-entry (cdr (assq font-family ps-font-info-database))))
+    (or font-entry
        (error "Don't have data to scale font %s. Known fonts families are %s"
-              ps-font-family
+              font-family
               (mapcar 'car ps-font-info-database)))
-    (setq l  (cdr assoc)
-         fn (prog1 (car l) (setq l (cdr l))) ; need `pop'
-         fb (prog1 (car l) (setq l (cdr l)))
-         fi (prog1 (car l) (setq l (cdr l)))
-         bi (prog1 (car l) (setq l (cdr l)))
-         sz (prog1 (car l) (setq l (cdr l)))
-         lh (prog1 (car l) (setq l (cdr l)))
-         sw (prog1 (car l) (setq l (cdr l)))
-         aw (prog1 (car l) (setq l (cdr l))))
-
-    ;; Font name
-    (setq ps-header-font             fn)
-    (setq ps-header-title-font       fb)
-    ;; Line height: These data just need to be rescaled:
-    (setq ps-header-title-line-height (/ (* lh ps-header-title-font-size) sz))
-    (setq ps-header-line-height       (/ (* lh ps-header-font-size)       sz))
-    ps-header-font-family))
+    (let ((size (ps-lookup 'size)))
+      (put sym 'fonts (ps-lookup 'fonts))
+      (put sym 'space-width (ps-size-scale 'space-width))
+      (put sym 'avg-char-width (ps-size-scale 'avg-char-width))
+      (put sym 'line-height (ps-size-scale 'line-height))
+      (put sym 'title-line-height
+          (/ (* (ps-lookup 'line-height) title-font-size) size)))))
 
 (defun ps-get-page-dimensions ()
   (let ((page-dimensions (cdr (assq ps-paper-type ps-page-dimensions-database)))
@@ -1978,10 +3016,14 @@ using the current ps-print setup."
       (error "`ps-paper-type' must be one of:\n%s"
             (mapcar 'car ps-page-dimensions-database)))
      ((< ps-number-of-columns 1)
-      (error "The number of columns %d should not be negative")))
+      (error "The number of columns %d should be positive"
+            ps-number-of-columns)))
 
-    (ps-select-font)
-    (ps-select-header-font)
+    (ps-select-font ps-font-family 'ps-font-for-text
+                   ps-font-size-internal ps-font-size-internal)
+    (ps-select-font ps-header-font-family 'ps-font-for-header
+                   ps-header-font-size-internal
+                   ps-header-title-font-size-internal)
 
     (setq page-width  (ps-page-dimensions-get-width  page-dimensions)
          page-height (ps-page-dimensions-get-height page-dimensions))
@@ -1997,11 +3039,10 @@ using the current ps-print setup."
     ;; | lm | text | ic | text | ic | text | rm |
     ;; page-width == lm  +  n * pw  +  (n - 1) * ic  +  rm
     ;; => pw == (page-width - lm -rm - (n - 1) * ic) / n
-    (setq ps-print-width
-         (/ (- page-width
-               ps-left-margin ps-right-margin
-               (* (1- ps-number-of-columns) ps-inter-column))
-            ps-number-of-columns))
+    (setq ps-print-width (/ (- page-width
+                              ps-left-margin ps-right-margin
+                              (* (1- ps-number-of-columns) ps-inter-column))
+                           ps-number-of-columns))
     (if (<= ps-print-width 0)
        (error "Bad horizontal layout:
 page-width           == %s
@@ -2032,17 +3073,16 @@ page-height == bm + print-height + tm
               ps-print-height))
     ;; If headers are turned on, deduct the height of the header from
     ;; the print height.
-    (cond
-     (ps-print-header
-      (setq ps-header-pad
-           (* ps-header-line-pad ps-header-title-line-height))
-      (setq ps-print-height
-           (- ps-print-height
-              ps-header-offset
-              ps-header-pad
-              ps-header-title-line-height
-              (* ps-header-line-height (- ps-header-lines 1))
-              ps-header-pad))))
+    (if ps-print-header
+       (setq ps-header-pad   (* ps-header-line-pad
+                                (ps-title-line-height 'ps-font-for-header))
+             ps-print-height (- ps-print-height
+                                ps-header-offset
+                                ps-header-pad
+                                (ps-title-line-height 'ps-font-for-header)
+                                (* (ps-line-height 'ps-font-for-header)
+                                   (1- ps-header-lines))
+                                ps-header-pad)))
     (if (<= ps-print-height 0)
        (error "Bad vertical layout:
 ps-top-margin    == %s
@@ -2057,46 +3097,87 @@ page-height == bm + print-height + tm - ho - hh
               ps-header-offset
               ps-header-pad
               (+ ps-header-pad
-                 ps-header-title-line-height
-                 (* ps-header-line-height (- ps-header-lines 1))
+                 (ps-title-line-height 'ps-font-for-header)
+                 (* (ps-line-height 'ps-font-for-header)
+                    (1- ps-header-lines))
                  ps-header-pad)
               ps-print-height))))
 
 (defun ps-print-preprint (&optional filename)
-  (if (and filename
-          (or (numberp filename)
-              (listp filename)))
-      (let* ((name (concat (buffer-name) ".ps"))
-            (prompt (format "Save PostScript to file: (default %s) "
-                            name))
-            (res (read-file-name prompt default-directory name nil)))
-       (if (file-directory-p res)
-           (expand-file-name name (file-name-as-directory res))
-         res))))
+  (and filename
+       (or (numberp filename)
+          (listp filename))
+       (let* ((name   (concat (file-name-nondirectory (or (buffer-file-name)
+                                                         (buffer-name)))
+                             ".ps"))
+             (prompt (format "Save PostScript to file: (default %s) " name))
+             (res    (read-file-name prompt default-directory name nil)))
+        (while (cond ((not (file-writable-p res))
+                      (ding)
+                      (setq prompt "is unwritable"))
+                     ((file-exists-p res)
+                      (setq prompt "exists")
+                      (not (y-or-n-p (format "File `%s' exists; overwrite? "
+                                             res))))
+                     (t nil))
+          (setq res (read-file-name
+                     (format "File %s; save PostScript to file: " prompt)
+                     (file-name-directory res) nil nil
+                     (file-name-nondirectory res))))
+        (if (file-directory-p res)
+            (expand-file-name name (file-name-as-directory res))
+          res))))
 
 ;; The following functions implement a simple list-buffering scheme so
 ;; that ps-print doesn't have to repeatedly switch between buffers
-;; while spooling.  The functions ps-output and ps-output-string build
-;; up the lists; the function ps-flush-output takes the lists and
+;; while spooling.  The functions `ps-output' and `ps-output-string' build
+;; up the lists; the function `ps-flush-output' takes the lists and
 ;; insert its contents into the spool buffer (*PostScript*).
 
+(defvar ps-string-escape-codes
+  (let ((table (make-vector 256 nil))
+       (char ?\000))
+    ;; control characters
+    (while (<= char ?\037)
+      (aset table char (format "\\%03o" char))
+      (setq char (1+ char)))
+    ;; printable characters
+    (while (< char ?\177)
+      (aset table char (format "%c" char))
+      (setq char (1+ char)))
+    ;; DEL and 8-bit characters
+    (while (<= char ?\377)
+      (aset table char (format "\\%o" char))
+      (setq char (1+ char)))
+    ;; Override ASCII formatting characters with named escape code:
+    (aset table ?\n "\\n")             ; [NL] linefeed
+    (aset table ?\r "\\r")             ; [CR] carriage return
+    (aset table ?\t "\\t")             ; [HT] horizontal tab
+    (aset table ?\b "\\b")             ; [BS] backspace
+    (aset table ?\f "\\f")             ; [NP] form feed
+    ;; Escape PostScript escape and string delimiter characters:
+    (aset table ?\\ "\\\\")
+    (aset table ?\( "\\(")
+    (aset table ?\) "\\)")
+    table)
+  "Vector used to map characters to PostScript string escape codes.")
+
 (defun ps-output-string-prim (string)
   (insert "(")                         ;insert start-string delimiter
   (save-excursion                      ;insert string
-    (insert string))
-
+    (insert (string-as-unibyte string)))
   ;; Find and quote special characters as necessary for PS
-  (while (re-search-forward "[()\\]" nil t)
-    (save-excursion
-      (forward-char -1)
-      (insert "\\")))
-
+  ;; This skips everything except control chars, non-ASCII chars, (, ) and \.
+  (while (progn (skip-chars-forward " -'*-[]-~") (not (eobp)))
+    (let ((special (following-char)))
+      (delete-char 1)
+      (insert (aref ps-string-escape-codes special))))
   (goto-char (point-max))
   (insert ")"))                                ;insert end-string delimiter
 
 (defun ps-init-output-queue ()
-  (setq ps-output-head (list ""))
-  (setq ps-output-tail ps-output-head))
+  (setq ps-output-head '("")
+       ps-output-tail ps-output-head))
 
 (defun ps-output (&rest args)
   (setcdr ps-output-tail args)
@@ -2106,32 +3187,45 @@ page-height == bm + print-height + tm - ho - hh
 (defun ps-output-string (string)
   (ps-output t string))
 
+(defun ps-output-list (the-list)
+  (mapcar 'ps-output the-list))
+
+;; Output strings in the list ARGS in the PostScript prologue part.
+(defun ps-output-prologue (args)
+  (ps-output 'prologue (if (stringp args) (list args) args)))
+
 (defun ps-flush-output ()
   (save-excursion
     (set-buffer ps-spool-buffer)
     (goto-char (point-max))
     (while ps-output-head
       (let ((it (car ps-output-head)))
-       (if (not (eq t it))
-           (insert it)
+       (cond
+        ((eq t it)
+         (setq ps-output-head (cdr ps-output-head))
+         (ps-output-string-prim (car ps-output-head)))
+        ((eq 'prologue it)
          (setq ps-output-head (cdr ps-output-head))
-         (ps-output-string-prim (car ps-output-head))))
+         (save-excursion
+           (search-backward "\nBeginDoc")
+           (forward-char 1)
+           (apply 'insert (car ps-output-head))))
+        (t
+         (insert it))))
       (setq ps-output-head (cdr ps-output-head))))
   (ps-init-output-queue))
 
 (defun ps-insert-file (fname)
   (ps-flush-output)
-
   ;; Check to see that the file exists and is readable; if not, throw
-  ;; and error.
-  (if (not (file-readable-p fname))
+  ;; an error.
+  (or (file-readable-p fname)
       (error "Could not read file `%s'" fname))
-
   (save-excursion
     (set-buffer ps-spool-buffer)
     (goto-char (point-max))
     (insert-file fname)))
-    
+
 ;; These functions insert the arrays that define the contents of the
 ;; headers.
 
@@ -2166,70 +3260,272 @@ page-height == bm + print-height + tm - ho - hh
        (while (and (< count ps-header-lines)
                    (setq contents (cdr contents)))
          (ps-generate-header-line "/h1" (car contents))
-         (setq count (+ count 1)))
+         (setq count (1+ count)))
        (ps-output "] def\n"))))
 
 (defun ps-output-boolean (name bool)
   (ps-output (format "/%s %s def\n" name (if bool "true" "false"))))
 
-(defun ps-begin-file ()
-  (ps-get-page-dimensions)
-  (setq ps-showpage-count 0)
-
-  (ps-output ps-adobe-tag)
-  (ps-output "%%Title: " (buffer-name) "\n") ;Take job name from name of
-                                       ;first buffer printed
-  (ps-output "%%Creator: " (user-full-name) "\n")
-  (ps-output "%%CreationDate: " 
-            (time-stamp-hh:mm:ss) " " (time-stamp-mon-dd-yyyy) "\n")
-  (ps-output "%% DocumentFonts: "
-            ps-font " " ps-font-bold " " ps-font-italic " "
-            ps-font-bold-italic " "
-            ps-header-font " " ps-header-title-font "\n")
-  (ps-output "%%Pages: (atend)\n")
-  (ps-output "%%EndComments\n\n")
 
-  (ps-output-boolean "LandscapeMode"             ps-landscape-mode)
-  (ps-output (format "/NumberOfColumns %d def\n" ps-number-of-columns))
+(defun ps-background-pages (page-list func)
+  (if page-list
+      (mapcar
+       '(lambda (pages)
+         (let ((start (if (consp pages) (car pages) pages))
+               (end   (if (consp pages) (cdr pages) pages)))
+           (and (integerp start) (integerp end) (<= start end)
+                (add-to-list 'ps-background-pages (vector start end func)))))
+       page-list)
+    (setq ps-background-all-pages (cons func ps-background-all-pages))))
 
-  (ps-output (format "/LandscapePageHeight %s def\n" ps-landscape-page-height))
-  (ps-output (format "/PrintWidth   %s def\n" ps-print-width))
-  (ps-output (format "/PrintHeight  %s def\n" ps-print-height))
 
-  (ps-output (format "/LeftMargin   %s def\n" ps-left-margin))
-  (ps-output (format "/RightMargin  %s def\n" ps-right-margin)) ; not used
-  (ps-output (format "/InterColumn  %s def\n" ps-inter-column))
+(defun ps-get-boundingbox ()
+  (save-excursion
+    (set-buffer ps-spool-buffer)
+    (save-excursion
+      (if (re-search-forward
+          "^%%BoundingBox:\\s-+\\([0-9.]+\\)\\s-+\\([0-9.]+\\)\\s-+\\([0-9.]+\\)\\s-+\\([0-9.]+\\)"
+          nil t)
+         (vector (string-to-number     ; lower x
+                  (buffer-substring (match-beginning 1) (match-end 1)))
+                 (string-to-number     ; lower y
+                  (buffer-substring (match-beginning 2) (match-end 2)))
+                 (string-to-number     ; upper x
+                  (buffer-substring (match-beginning 3) (match-end 3)))
+                 (string-to-number     ; upper y
+                  (buffer-substring (match-beginning 4) (match-end 4))))
+       (vector 0 0 0 0)))))
+
+
+;; Emacs understands the %f format; we'll use it to limit color RGB values
+;; to three decimals to cut down some on the size of the PostScript output.
+;; Lucid emacsen will have to make do with %s (princ) for floats.
+
+(defvar ps-float-format (if (eq ps-print-emacs-type 'emacs)
+                           "%0.3f "    ; emacs
+                         "%s "))       ; Lucid emacsen
+
+
+(defun ps-float-format (value &optional default)
+  (let ((literal (or value default)))
+    (if literal
+       (format (if (numberp literal)
+                   ps-float-format
+                 "%s ")
+               literal)
+      " ")))
+
+
+(defun ps-background-text ()
+  (mapcar
+   '(lambda (text)
+      (setq ps-background-text-count (1+ ps-background-text-count))
+      (ps-output (format "/ShowBackText-%d {\n" ps-background-text-count))
+      (ps-output-string (nth 0 text))  ; text
+      (ps-output
+       "\n"
+       (ps-float-format (nth 4 text) 200.0) ; font size
+       (format "/%s " (or (nth 3 text) "Times-Roman")) ; font name
+       (ps-float-format (nth 6 text)
+                       "PrintHeight PrintPageWidth atan") ; rotation
+       (ps-float-format (nth 5 text) 0.85) ; gray
+       (ps-float-format (nth 1 text) "0") ; x position
+       (ps-float-format (nth 2 text) "BottomMargin") ; y position
+       "\nShowBackText} def\n")
+      (ps-background-pages (nthcdr 7 text) ; page list
+                          (format "ShowBackText-%d\n"
+                                  ps-background-text-count)))
+   ps-print-background-text))
+
+
+(defun ps-background-image ()
+  (mapcar
+   '(lambda (image)
+      (let ((image-file (expand-file-name (nth 0 image))))
+       (if (file-readable-p image-file)
+           (progn
+             (setq ps-background-image-count (1+ ps-background-image-count))
+             (ps-output
+              (format "/ShowBackImage-%d {\n--back-- " ps-background-image-count)
+              (ps-float-format (nth 5 image) 0.0) ; rotation
+              (ps-float-format (nth 3 image) 1.0) ; x scale
+              (ps-float-format (nth 4 image) 1.0) ; y scale
+              (ps-float-format (nth 1 image) ; x position
+                               "PrintPageWidth 2 div")
+              (ps-float-format (nth 2 image) ; y position
+                               "PrintHeight 2 div BottomMargin add")
+              "\nBeginBackImage\n")
+             (ps-insert-file image-file)
+             ;; coordinate adjustment to centralize image
+             ;; around x and y position
+             (let ((box (ps-get-boundingbox)))
+               (save-excursion
+                 (set-buffer ps-spool-buffer)
+                 (save-excursion
+                   (if (re-search-backward "^--back--" nil t)
+                       (replace-match
+                        (format "%s %s"
+                                (ps-float-format
+                                 (- (+ (/ (- (aref box 2) (aref box 0)) 2.0)
+                                       (aref box 0))))
+                                (ps-float-format
+                                 (- (+ (/ (- (aref box 3) (aref box 1)) 2.0)
+                                       (aref box 1)))))
+                        t)))))
+             (ps-output "\nEndBackImage} def\n")
+             (ps-background-pages (nthcdr 6 image) ; page list
+                                  (format "ShowBackImage-%d\n"
+                                          ps-background-image-count))))))
+   ps-print-background-image))
+
+
+(defun ps-background (page-number)
+  (let (has-local-background)
+    (mapcar '(lambda (range)
+              (and (<= (aref range 0) page-number)
+                   (<= page-number (aref range 1))
+                   (if has-local-background
+                       (ps-output (aref range 2))
+                     (setq has-local-background t)
+                     (ps-output "/printLocalBackground {\n"
+                                (aref range 2)))))
+           ps-background-pages)
+    (and has-local-background (ps-output "} def\n"))))
+
+
+;; Return a list of the distinct elements of LIST.
+;; Elements are compared with `equal'.
+(defun ps-remove-duplicates (list)
+  (let (new (tail list))
+    (while tail
+      (or (member (car tail) new)
+         (setq new (cons (car tail) new)))
+      (setq tail (cdr tail)))
+    (nreverse new)))
+
+
+;; Find the first occurrence of ITEM in LIST.
+;; Return the index of the matching item, or nil if not found.
+;; Elements are compared with `eq'.
+(defun ps-alist-position (item list)
+  (let ((tail list) (index 0) found)
+    (while tail
+      (if (setq found (eq (car (car tail)) item))
+         (setq tail nil)
+       (setq index (1+ index)
+             tail (cdr tail))))
+    (and found index)))
 
-  (ps-output (format "/BottomMargin %s def\n" ps-bottom-margin))
-  (ps-output (format "/TopMargin    %s def\n" ps-top-margin)) ; not used
-  (ps-output (format "/HeaderOffset %s def\n" ps-header-offset))
-  (ps-output (format "/HeaderPad    %s def\n" ps-header-pad))
-  
-  (ps-output-boolean "PrintHeader"      ps-print-header)
-  (ps-output-boolean "PrintHeaderFrame" ps-print-header-frame)
-  (ps-output-boolean "ShowNofN"         ps-show-n-of-n)
-  (ps-output-boolean "Duplex"           ps-spool-duplex)
 
-  (ps-output (format "/LineHeight   %s def\n" ps-line-height))
+(defun ps-begin-file ()
+  (ps-get-page-dimensions)
+  (setq ps-page-postscript 0
+       ps-background-text-count 0
+       ps-background-image-count 0
+       ps-background-pages nil
+       ps-background-all-pages nil)
+
+  (ps-output ps-adobe-tag
+            "%%Title: " (buffer-name)  ; Take job name from name of
+                                       ; first buffer printed
+            "\n%%Creator: " (user-full-name)
+            " (using ps-print v" ps-print-version
+            ")\n%%CreationDate: "
+            (time-stamp-hh:mm:ss) " " (time-stamp-mon-dd-yyyy)
+            "\n%%Orientation: "
+            (if ps-landscape-mode "Landscape" "Portrait")
+            "\n%%DocumentNeededResources: font Times-Roman Times-Italic\n%%+ font "
+            (mapconcat 'identity
+                       (ps-remove-duplicates
+                        (append (ps-fonts 'ps-font-for-text)
+                                (list (ps-font 'ps-font-for-header 'normal)
+                                      (ps-font 'ps-font-for-header 'bold))))
+                       "\n%%+ font ")
+            "\n%%Pages: (atend)\n%%Requirements:"
+            (if ps-spool-duplex " duplex\n" "\n"))
+
+  (let ((comments (if (functionp ps-print-prologue-header)
+                     (funcall ps-print-prologue-header)
+                   ps-print-prologue-header)))
+    (and (stringp comments)
+        (ps-output comments)))
+
+  (ps-output "%%EndComments\n\n%%BeginPrologue\n\n")
+
+  (ps-output-boolean "LandscapeMode"             ps-landscape-mode)
+  (ps-output (format "/NumberOfColumns %d def\n" ps-number-of-columns)
+
+            (format "/LandscapePageHeight %s def\n" ps-landscape-page-height)
+            (format "/PrintPageWidth      %s def\n"
+                    (- (* (+ ps-print-width ps-inter-column)
+                          ps-number-of-columns)
+                       ps-inter-column))
+            (format "/PrintWidth   %s def\n" ps-print-width)
+            (format "/PrintHeight  %s def\n" ps-print-height)
+
+            (format "/LeftMargin   %s def\n" ps-left-margin)
+            (format "/RightMargin  %s def\n" ps-right-margin) ; not used
+            (format "/InterColumn  %s def\n" ps-inter-column)
+
+            (format "/BottomMargin %s def\n" ps-bottom-margin)
+            (format "/TopMargin    %s def\n" ps-top-margin) ; not used
+            (format "/HeaderOffset %s def\n" ps-header-offset)
+            (format "/HeaderPad    %s def\n" ps-header-pad))
+
+  (ps-output-boolean "PrintHeader"        ps-print-header)
+  (ps-output-boolean "PrintOnlyOneHeader" ps-print-only-one-header)
+  (ps-output-boolean "PrintHeaderFrame"   ps-print-header-frame)
+  (ps-output-boolean "ShowNofN"           ps-show-n-of-n)
+  (ps-output-boolean "Duplex"             ps-spool-duplex)
+
+  (let ((line-height (ps-line-height 'ps-font-for-text)))
+    (ps-output (format "/LineHeight   %s def\n" line-height)
+              (format "/LinesPerColumn %d def\n"
+                      (round (/ (+ ps-print-height
+                                   (* line-height 0.45))
+                                line-height)))))
+
+  (ps-output-boolean "Zebra" ps-zebra-stripes)
+  (ps-output-boolean "PrintLineNumber" ps-line-number)
+  (ps-output (format "/ZebraHeight %d def\n" ps-zebra-stripe-height))
+
+  (ps-background-text)
+  (ps-background-image)
+  (setq ps-background-all-pages (nreverse ps-background-all-pages)
+       ps-background-pages (nreverse ps-background-pages))
 
   (ps-output ps-print-prologue-1)
 
+  (ps-output "/printGlobalBackground {\n")
+  (ps-output-list ps-background-all-pages)
+  (ps-output "} def\n/printLocalBackground {\n} def\n")
+
   ;; Header fonts
-  (ps-output                           ; /h0 14 /Helvetica-Bold Font
-   (format "/h0 %s /%s DefFont\n" ps-header-title-font-size ps-header-title-font))
-  (ps-output                           ; /h1 12 /Helvetica Font
-   (format "/h1 %s /%s DefFont\n" ps-header-font-size       ps-header-font))
+  (ps-output (format "/h0 %s (%s) cvn DefFont\n" ; /h0 14 /Helvetica-Bold DefFont
+                    ps-header-title-font-size-internal
+                    (ps-font 'ps-font-for-header 'bold))
+            (format "/h1 %s (%s) cvn DefFont\n" ; /h1 12 /Helvetica DefFont
+                    ps-header-font-size-internal
+                    (ps-font 'ps-font-for-header 'normal)))
 
   (ps-output ps-print-prologue-2)
 
   ;; Text fonts
-  (ps-output (format "/f0 %s /%s DefFont\n" ps-font-size ps-font))
-  (ps-output (format "/f1 %s /%s DefFont\n" ps-font-size ps-font-bold))
-  (ps-output (format "/f2 %s /%s DefFont\n" ps-font-size ps-font-italic))
-  (ps-output (format "/f3 %s /%s DefFont\n" ps-font-size ps-font-bold-italic))
-
-  (ps-output "\nBeginDoc\n\n")
-  (ps-output "%%EndPrologue\n"))
+  (let ((font (ps-font-alist 'ps-font-for-text))
+       (i 0))
+    (while font
+      (ps-output (format "/f%d %s (%s) cvn DefFont\n"
+                        i
+                        ps-font-size-internal
+                        (ps-font 'ps-font-for-text (car (car font)))))
+      (setq font (cdr font)
+           i (1+ i))))
+
+  (let ((font-entry (cdr (assq ps-font-family ps-font-info-database))))
+    (ps-output (format "/SpaceWidthRatio %f def\n"
+                      (/ (ps-lookup 'space-width) (ps-lookup 'size)))))
+
+  (ps-output "\n%%EndPrologue\n\n%%BeginSetup\nBeginDoc\n%%EndSetup\n"))
 
 (defun ps-header-dirpart ()
   (let ((fname (buffer-file-name)))
@@ -2247,36 +3543,90 @@ page-height == bm + print-height + tm - ho - hh
    ;; Indulge Jack this other little easter egg:
    ((string= (buffer-name) "sokoban.el")
     "Super! C'est sokoban.el!")
-   (t (buffer-name))))
+   (t (concat
+       (and ps-printing-region "Subset of: ")
+       (buffer-name)
+       (and (buffer-modified-p) " (unsaved)")))))
+
+
+(defun ps-get-font-size (font-sym)
+  (let ((font-size (symbol-value font-sym)))
+    (cond ((numberp font-size)
+          font-size)
+         ((and (consp font-size)
+               (numberp (car font-size))
+               (numberp (cdr font-size)))
+          (if ps-landscape-mode
+              (car font-size)
+            (cdr font-size)))
+         (t
+          (error "Invalid font size `%S' for `%S'" font-size font-sym)))))
+
 
 (defun ps-begin-job ()
-  (setq ps-page-count 0))
+  (save-excursion
+    (set-buffer ps-spool-buffer)
+    (goto-char (point-max))
+    (and (re-search-backward "^%%Trailer$" nil t)
+        (delete-region (match-beginning 0) (point-max))))
+  (setq ps-showline-count (if ps-printing-region (car ps-printing-region) 1)
+       ps-page-count 0
+       ps-font-size-internal        (ps-get-font-size 'ps-font-size)
+       ps-header-font-size-internal (ps-get-font-size 'ps-header-font-size)
+       ps-header-title-font-size-internal
+       (ps-get-font-size 'ps-header-title-font-size)
+       ps-control-or-escape-regexp
+       (cond ((eq ps-print-control-characters '8-bit)
+              (string-as-unibyte "[\000-\037\177-\377]"))
+             ((eq ps-print-control-characters 'control-8-bit)
+              (string-as-unibyte "[\000-\037\177-\237]"))
+             ((eq ps-print-control-characters 'control)
+              "[\000-\037\177]")
+             (t "[\t\n\f]"))))
+
+(defmacro ps-page-number ()
+  `(1+ (/ (1- ps-page-count) ps-number-of-columns)))
 
 (defun ps-end-file ()
-  (ps-output "\nEndDoc\n\n")
-  (ps-output "%%Trailer\n")
-  (ps-output (format "%%%%Pages: %d\n" (1+ (/ (1- ps-page-count)
-                                             ps-number-of-columns)))))
+  (ps-output "\n%%Trailer\n%%Pages: "
+            (format "%d" ps-page-postscript)
+            "\n\nEndDoc\n\n%%EOF\n"))
+
 
 (defun ps-next-page ()
   (ps-end-page)
   (ps-flush-output)
   (ps-begin-page))
 
-(defun ps-begin-page (&optional dummypage)
+(defun ps-header-page ()
+  ;; set total line and page number when printing has finished
+  ;; (see `ps-generate')
+  (if (prog1
+         (zerop (mod ps-page-count ps-number-of-columns))
+       (setq ps-page-count (1+ ps-page-count)))
+      ;; Print only when a new real page begins.
+      (progn
+       (setq ps-page-postscript (1+ ps-page-postscript))
+       (ps-output (format "\n%%%%Page: %d %d\n"
+                          ps-page-postscript ps-page-postscript))
+       (ps-output "/Lines 0 def\n/PageCount 0 def\nBeginDSCPage\n")
+       (ps-background ps-page-postscript)
+       (run-hooks 'ps-print-begin-page-hook))
+    ;; Print when any other page begins.
+    (ps-output "/Lines 0 def\n/PageCount 0 def\nBeginDSCPage\n")
+    (run-hooks 'ps-print-begin-column-hook)))
+
+(defun ps-begin-page ()
   (ps-get-page-dimensions)
-  (setq ps-width-remaining  ps-print-width)
-  (setq ps-height-remaining ps-print-height)
+  (setq ps-width-remaining  ps-print-width
+       ps-height-remaining ps-print-height)
 
-  ;; Print only when a new real page begins.
-  (when (zerop (mod ps-page-count ps-number-of-columns))
-    (ps-output (format "\n%%%%Page: %d %d\n"
-                      (1+ (/ ps-page-count ps-number-of-columns))
-                      (1+ (/ ps-page-count ps-number-of-columns)))))
+  (ps-header-page)
 
-  (ps-output "BeginDSCPage\n")
-  (ps-output (format "/PageNumber %d def\n" (incf ps-page-count)))
-  (ps-output "/PageCount 0 def\n")
+  (ps-output (format "/LineNumber %d def\n" ps-showline-count)
+            (format "/PageNumber %d def\n" (if ps-print-only-one-header
+                                               (ps-page-number)
+                                             ps-page-count)))
 
   (when ps-print-header
     (ps-generate-header "HeaderLinesLeft"    ps-left-header)
@@ -2284,46 +3634,37 @@ page-height == bm + print-height + tm - ho - hh
     (ps-output (format "%d SetHeaderLines\n" ps-header-lines)))
 
   (ps-output "BeginPage\n")
-  (ps-set-font      ps-current-font)
-  (ps-set-bg        ps-current-bg)
-  (ps-set-color     ps-current-color)
-  (ps-set-underline ps-current-underline-p))
+  (ps-set-font  ps-current-font)
+  (ps-set-bg    ps-current-bg)
+  (ps-set-color ps-current-color)
+  (ps-mule-begin-page))
 
 (defun ps-end-page ()
-  (setq ps-showpage-count (+ 1 ps-showpage-count))
-  (ps-output "EndPage\n")
-  (ps-output "EndDSCPage\n"))
+  (ps-output "EndPage\nEndDSCPage\n"))
 
 (defun ps-dummy-page ()
-  (setq ps-showpage-count (+ 1 ps-showpage-count))
-  (ps-output "%%Page: " (format "- %d\n" ps-showpage-count)
-            "BeginDSCPage
-/PrintHeader false def
+  (ps-header-page)
+  (ps-output "/PrintHeader false def
 BeginPage
 EndPage
 EndDSCPage\n"))
-           
+
 (defun ps-next-line ()
-  (if (< ps-height-remaining ps-line-height)
-      (ps-next-page)
-    (setq ps-width-remaining  ps-print-width)
-    (setq ps-height-remaining (- ps-height-remaining ps-line-height))
-    (ps-hard-lf)))
+  (setq ps-showline-count (1+ ps-showline-count))
+  (let ((lh (ps-line-height 'ps-font-for-text)))
+    (if (< ps-height-remaining lh)
+       (ps-next-page)
+      (setq ps-width-remaining  ps-print-width
+           ps-height-remaining (- ps-height-remaining lh))
+      (ps-output "HL\n"))))
 
 (defun ps-continue-line ()
-  (if (< ps-height-remaining ps-line-height)
-      (ps-next-page)
-    (setq ps-width-remaining  ps-print-width)
-    (setq ps-height-remaining (- ps-height-remaining ps-line-height))
-    (ps-soft-lf)))
-
-;; [jack] Why hard and soft ?
-
-(defun ps-hard-lf ()
-  (ps-output "HL\n"))
-
-(defun ps-soft-lf ()
-  (ps-output "SL\n"))
+  (let ((lh (ps-line-height 'ps-font-for-text)))
+    (if (< ps-height-remaining lh)
+       (ps-next-page)
+      (setq ps-width-remaining  ps-print-width
+           ps-height-remaining (- ps-height-remaining lh))
+      (ps-output "SL\n"))))
 
 (defun ps-find-wrappoint (from to char-width)
   (let ((avail (truncate (/ ps-width-remaining char-width)))
@@ -2333,17 +3674,19 @@ EndDSCPage\n"))
       (cons (+ from avail) ps-width-remaining))))
 
 (defun ps-basic-plot-string (from to &optional bg-color)
-  (let* ((wrappoint (ps-find-wrappoint from to ps-avg-char-width))
+  (let* ((wrappoint (ps-find-wrappoint from to
+                                      (ps-avg-char-width 'ps-font-for-text)))
         (to (car wrappoint))
-        (string (buffer-substring from to)))
+        (string (buffer-substring-no-properties from to)))
+    (ps-mule-prepare-ascii-font string)
     (ps-output-string string)
     (ps-output " S\n")
     wrappoint))
 
 (defun ps-basic-plot-whitespace (from to &optional bg-color)
-  (let* ((wrappoint (ps-find-wrappoint from to ps-space-width))
+  (let* ((wrappoint (ps-find-wrappoint from to
+                                      (ps-space-width 'ps-font-for-text)))
         (to (car wrappoint)))
-
     (ps-output (format "%d W\n" (- to from)))
     wrappoint))
 
@@ -2352,246 +3695,365 @@ EndDSCPage\n"))
     (let* ((wrappoint (funcall plotfunc from to bg-color))
           (plotted-to (car wrappoint))
           (plotted-width (cdr wrappoint)))
-      (setq from plotted-to)
-      (setq ps-width-remaining (- ps-width-remaining plotted-width))
+      (setq from plotted-to
+           ps-width-remaining (- ps-width-remaining plotted-width))
       (if (< from to)
          (ps-continue-line))))
   (if ps-razzle-dazzle
       (let* ((q-todo (- (point-max) (point-min)))
             (q-done (- (point) (point-min)))
             (chunkfrac (/ q-todo 8))
-            (chunksize (if (> chunkfrac 1000) 1000 chunkfrac)))
+            (chunksize (min chunkfrac 1000)))
        (if (> (- q-done ps-razchunk) chunksize)
-           (let (foo)
+           (progn
              (setq ps-razchunk q-done)
-             (setq foo
-                   (if (< q-todo 100)
-                       (/ (* 100 q-done) q-todo)
-                     (/ q-done (/ q-todo 100))))
-             (message "Formatting...%3d%%" foo))))))
+             (message "Formatting...%3d%%"
+                      (if (< q-todo 100)
+                          (/ (* 100 q-done) q-todo)
+                        (/ q-done (/ q-todo 100)))
+                      ))))))
+
+(defvar ps-last-font nil)
 
 (defun ps-set-font (font)
-  (setq ps-current-font font)
-  (ps-output (format "/f%d F\n" ps-current-font)))
+  (setq ps-last-font (format "f%d" (setq ps-current-font font)))
+  (ps-output (format "/%s F\n" ps-last-font)))
 
 (defun ps-set-bg (color)
   (if (setq ps-current-bg color)
-      (ps-output (format ps-color-format (nth 0 color) (nth 1 color)
-                        (nth 2 color))
+      (ps-output (format ps-color-format
+                        (nth 0 color) (nth 1 color) (nth 2 color))
                 " true BG\n")
     (ps-output "false BG\n")))
 
 (defun ps-set-color (color)
-  (if (setq ps-current-color color)
-      nil
-    (setq ps-current-color ps-default-fg))
-  (ps-output (format ps-color-format (nth 0 ps-current-color)
+  (setq ps-current-color (or color ps-default-fg))
+  (ps-output (format ps-color-format
+                    (nth 0 ps-current-color)
                     (nth 1 ps-current-color) (nth 2 ps-current-color))
             " FG\n"))
 
-(defun ps-set-underline (underline-p)
-  (ps-output (if underline-p "true" "false") " UL\n")
-  (setq ps-current-underline-p underline-p))
 
-(defun ps-plot-region (from to font fg-color &optional bg-color underline-p)
+(defvar ps-current-effect 0)
+
 
+(defun ps-plot-region (from to font &optional fg-color bg-color effects)
   (if (not (equal font ps-current-font))
       (ps-set-font font))
-  
+
   ;; Specify a foreground color only if one's specified and it's
   ;; different than the current.
   (if (not (equal fg-color ps-current-color))
       (ps-set-color fg-color))
-  
+
   (if (not (equal bg-color ps-current-bg))
       (ps-set-bg bg-color))
-  
-  ;; Toggle underlining if different.
-  (if (not (equal underline-p ps-current-underline-p))
-      (ps-set-underline underline-p))
+
+  ;; Specify effects (underline, overline, box, etc)
+  (cond
+   ((not (integerp effects))
+    (ps-output "0 EF\n")
+    (setq ps-current-effect 0))
+   ((/= effects ps-current-effect)
+    (ps-output (number-to-string effects) " EF\n")
+    (setq ps-current-effect effects)))
 
   ;; Starting at the beginning of the specified region...
   (save-excursion
     (goto-char from)
 
     ;; ...break the region up into chunks separated by tabs, linefeeds,
-    ;; and pagefeeds, and plot each chunk.
+    ;; pagefeeds, control characters, and plot each chunk.
     (while (< from to)
-      (if (re-search-forward "[\t\n\f]" to t)
-          (let ((match (char-after (match-beginning 0))))
-            (cond
-            ((= match ?\t)
-             (let ((linestart
-                    (save-excursion (beginning-of-line) (point))))
-               (ps-plot 'ps-basic-plot-string from (- (point) 1)
-                        bg-color)
+      (if (re-search-forward ps-control-or-escape-regexp to t)
+         ;; region with some control characters or some multi-byte characters
+         (let* ((match-point (match-beginning 0))
+                (match (char-after match-point)))
+           (when (< from match-point)
+             (ps-mule-set-ascii-font)
+             (ps-plot 'ps-basic-plot-string from match-point bg-color))
+           (cond
+            ((= match ?\t)             ; tab
+             (let ((linestart (line-beginning-position)))
                (forward-char -1)
                (setq from (+ linestart (current-column)))
-               (if (re-search-forward "[ \t]+" to t)
-                   (ps-plot 'ps-basic-plot-whitespace
-                            from (+ linestart (current-column))
-                            bg-color))))
-
-            ((= match ?\n)
-             (ps-plot 'ps-basic-plot-string from (- (point) 1)
-                      bg-color)
-             (ps-next-line)
-             )
-
-            ((= match ?\f)
-             (ps-plot 'ps-basic-plot-string from (- (point) 1)
-                      bg-color)
-             (ps-next-page)))
-            (setq from (point)))
-        (ps-plot 'ps-basic-plot-string from to bg-color)
-        (setq from to)))))
+               (when (re-search-forward "[ \t]+" to t)
+                 (ps-mule-set-ascii-font)
+                 (ps-plot 'ps-basic-plot-whitespace
+                          from (+ linestart (current-column))
+                          bg-color))))
+
+            ((= match ?\n)             ; newline
+             (ps-next-line))
+
+            ((= match ?\f)             ; form feed
+             ;; do not skip page if previous character is NEWLINE and
+             ;; it is a beginning of page.
+             (or (and (= (char-after (1- match-point)) ?\n)
+                      (= ps-height-remaining ps-print-height))
+                 (ps-next-page)))
+
+            ((> match 255)             ; a multi-byte character
+             (let ((charset (char-charset match)))
+               (or (eq charset 'composition)
+                   (while (eq (charset-after) charset)
+                     (forward-char 1)))
+               (ps-plot 'ps-mule-plot-string match-point (point) bg-color)))
+                                       ; characters from ^@ to ^_ and
+            (t                         ; characters from 127 to 255
+             (ps-control-character match)))
+           (setq from (point)))
+       ;; region without control characters nor multi-byte characters
+       (ps-mule-set-ascii-font)
+       (ps-plot 'ps-basic-plot-string from to bg-color)
+       (setq from to)))))
+
+(defvar ps-string-control-codes
+  (let ((table (make-vector 256 nil))
+       (char ?\000))
+    ;; control character
+    (while (<= char ?\037)
+      (aset table char (format "^%c" (+ char ?@)))
+      (setq char (1+ char)))
+    ;; printable character
+    (while (< char ?\177)
+      (aset table char (format "%c" char))
+      (setq char (1+ char)))
+    ;; DEL
+    (aset table char "^?")
+    ;; 8-bit character
+    (while (<= (setq char (1+ char)) ?\377)
+      (aset table char (format "\\%o" char)))
+    table)
+  "Vector used to map characters to a printable string.")
+
+(defun ps-control-character (char)
+  (let* ((str (aref ps-string-control-codes char))
+        (from (1- (point)))
+        (len (length str))
+        (to (+ from len))
+        (char-width (ps-avg-char-width 'ps-font-for-text))
+        (wrappoint (ps-find-wrappoint from to char-width)))
+    (if (< (car wrappoint) to)
+       (ps-continue-line))
+    (setq ps-width-remaining (- ps-width-remaining (* len char-width)))
+    (ps-mule-prepare-ascii-font str)
+    (ps-output-string str)
+    (ps-output " S\n")))
 
 (defun ps-color-value (x-color-value)
   ;; Scale 16-bit X-COLOR-VALUE to PostScript color value in [0, 1] interval.
   (/ x-color-value ps-print-color-scale))
 
-(defun ps-color-values (x-color)
-  (cond ((fboundp 'x-color-values)
-        (x-color-values x-color))
-       ((fboundp 'pixel-components)
-        (pixel-components x-color))
-       (t (error "No available function to determine X color values."))))
+
+(cond ((eq ps-print-emacs-type 'emacs)  ; emacs
+
+       (defun ps-color-values (x-color)
+        (if (fboundp 'x-color-values)
+            (x-color-values x-color)
+          (error "No available function to determine X color values.")))
+       )
+                                       ; xemacs
+                                       ; lucid
+      (t                               ; epoch
+       (defun ps-color-values (x-color)
+        (cond ((fboundp 'x-color-values)
+               (x-color-values x-color))
+              ((and (fboundp 'color-instance-rgb-components)
+                    (ps-color-device))
+               (color-instance-rgb-components
+                (if (color-instance-p x-color)
+                    x-color
+                  (make-color-instance
+                   (if (color-specifier-p x-color)
+                       (color-name x-color)
+                     x-color)))))
+              (t (error "No available function to determine X color values."))))
+       ))
+
 
 (defun ps-face-attributes (face)
-  (let ((differs (face-differs-from-default-p face)))
-    (list (memq face ps-ref-bold-faces)
-         (memq face ps-ref-italic-faces)
-         (memq face ps-ref-underlined-faces)
-         (and differs (face-foreground face))
-         (and differs (face-background face)))))
+  "Return face attribute vector.
+
+If FACE is not in `ps-print-face-extension-alist' or in
+`ps-print-face-alist', insert it on `ps-print-face-alist' and
+return the attribute vector.
+
+If FACE is not a valid face name, it is used default face."
+  (cdr (or (assq face ps-print-face-extension-alist)
+          (assq face ps-print-face-alist)
+          (let* ((the-face (if (facep face) face 'default))
+                 (new-face (ps-screen-to-bit-face the-face)))
+            (or (and (eq the-face 'default)
+                     (assq the-face ps-print-face-alist))
+                (setq ps-print-face-alist (cons new-face ps-print-face-alist)))
+            new-face))))
+
 
 (defun ps-face-attribute-list (face-or-list)
   (if (listp face-or-list)
-      (let (bold-p italic-p underline-p foreground background face-attr face)
+      ;; list of faces
+      (let ((effects 0)
+           foreground background face-attr)
        (while face-or-list
-         (setq face (car face-or-list))
-         (setq face-attr (ps-face-attributes face))
-         (setq bold-p (or bold-p (nth 0 face-attr)))
-         (setq italic-p (or italic-p (nth 1 face-attr)))
-         (setq underline-p (or underline-p (nth 2 face-attr)))
-         (if foreground
-             nil
-           (setq foreground (nth 3 face-attr)))
-         (if background
-             nil
-           (setq background (nth 4 face-attr)))
+         (setq face-attr (ps-face-attributes (car face-or-list))
+               effects (logior effects (aref face-attr 0)))
+         (or foreground (setq foreground (aref face-attr 1)))
+         (or background (setq background (aref face-attr 2)))
          (setq face-or-list (cdr face-or-list)))
-       (list bold-p italic-p underline-p foreground background))
-
+       (vector effects foreground background))
+    ;; simple face
     (ps-face-attributes face-or-list)))
 
+
+(defconst ps-font-type (vector nil 'bold 'italic 'bold-italic))
+
+
 (defun ps-plot-with-face (from to face)
-  (if face
-      (let* ((face-attr (ps-face-attribute-list face))
-            (bold-p (nth 0 face-attr))
-            (italic-p (nth 1 face-attr))
-            (underline-p (nth 2 face-attr))
-            (foreground (nth 3 face-attr))
-            (background (nth 4 face-attr))
-            (fg-color (if (and ps-print-color-p foreground)
-                          (mapcar 'ps-color-value
-                                  (ps-color-values foreground))
-                        ps-default-color))
-            (bg-color (if (and ps-print-color-p background)
-                          (mapcar 'ps-color-value
-                                  (ps-color-values background)))))
-       (ps-plot-region from to
-                       (cond ((and bold-p italic-p) 3)
-                             (italic-p 2)
-                             (bold-p 1)
-                             (t 0))
-;                      (or fg-color '(0.0 0.0 0.0))
-                       fg-color
-                       bg-color underline-p))
-    (goto-char to)))
-
-
-(defun ps-emacs-face-kind-p (face kind kind-regex kind-list)
-  (let ((frame-font (face-font face))
-       (face-defaults (face-font face t)))
-    (or
-     ;; Check FACE defaults:
-     (and (listp face-defaults)
-         (memq kind face-defaults))
-
-     ;; Check the user's preferences
-     (memq face kind-list))))
+  (cond
+   ((null face)                                ; print text with null face
+    (ps-plot-region from to 0))
+   ((eq face 'emacs--invisible--face)) ; skip invisible text!!!
+   (t                                  ; otherwise, text has a valid face
+    (let* ((face-bit   (ps-face-attribute-list face))
+          (effect     (aref face-bit 0))
+          (foreground (aref face-bit 1))
+          (background (aref face-bit 2))
+          (fg-color (if (and ps-color-p foreground)
+                        (mapcar 'ps-color-value
+                                (ps-color-values foreground))
+                      ps-default-color))
+          (bg-color (and ps-color-p background
+                         (mapcar 'ps-color-value
+                                 (ps-color-values background)))))
+      (ps-plot-region
+       from to
+       (ps-font-number 'ps-font-for-text
+                      (or (aref ps-font-type (logand effect 3))
+                          face))
+       fg-color bg-color (lsh effect -2)))))
+  (goto-char to))
+
 
 (defun ps-xemacs-face-kind-p (face kind kind-regex kind-list)
-  (let* ((frame-font (or (face-font face) (face-font 'default)))
-        (kind-cons (assq kind (x-font-properties frame-font)))
+  (let* ((frame-font (or (face-font-instance face)
+                        (face-font-instance 'default)))
+        (kind-cons (and frame-font
+                        (assq kind
+                              (font-instance-properties frame-font))))
         (kind-spec (cdr-safe kind-cons))
         (case-fold-search t))
-
     (or (and kind-spec (string-match kind-regex kind-spec))
        ;; Kludge-compatible:
        (memq face kind-list))))
 
-(defun ps-face-bold-p (face)
-  (if (eq ps-print-emacs-type 'emacs)
-      (ps-emacs-face-kind-p face 'bold "-\\(bold\\|demibold\\)-"
-                         ps-bold-faces)
-    (ps-xemacs-face-kind-p face 'WEIGHT_NAME "bold\\|demibold"
-                          ps-bold-faces)))
 
-(defun ps-face-italic-p (face)
-  (if (eq ps-print-emacs-type 'emacs)
-      (ps-emacs-face-kind-p face 'italic "-[io]-" ps-italic-faces)
-    (or
-     (ps-xemacs-face-kind-p face 'ANGLE_NAME "i\\|o" ps-italic-faces)
-     (ps-xemacs-face-kind-p face 'SLANT "i\\|o" ps-italic-faces))))
+(cond ((eq ps-print-emacs-type 'emacs)  ; emacs
+
+       (defun ps-face-bold-p (face)
+        (or (face-bold-p face)
+            (memq face ps-bold-faces)))
+
+       (defun ps-face-italic-p (face)
+        (or (face-italic-p face)
+            (memq face ps-italic-faces)))
+       )
+                                       ; xemacs
+                                       ; lucid
+      (t                               ; epoch
+       (defun ps-face-bold-p (face)
+        (ps-xemacs-face-kind-p face 'WEIGHT_NAME "bold\\|demibold"
+                               ps-bold-faces))
+
+       (defun ps-face-italic-p (face)
+        (or (ps-xemacs-face-kind-p face 'ANGLE_NAME "i\\|o" ps-italic-faces)
+            (ps-xemacs-face-kind-p face 'SLANT "i\\|o" ps-italic-faces)))
+       ))
+
 
 (defun ps-face-underlined-p (face)
   (or (face-underline-p face)
       (memq face ps-underlined-faces)))
 
+
 ;; Ensure that face-list is fbound.
 (or (fboundp 'face-list) (defalias 'face-list 'list-faces))
 
+
 (defun ps-build-reference-face-lists ()
+  ;; Ensure that face database is updated with faces on
+  ;; `font-lock-face-attributes' (obsolete stuff)
+  (ps-font-lock-face-attributes)
+  ;; Now, rebuild reference face lists
+  (setq ps-print-face-alist nil)
   (if ps-auto-font-detect
-      (let ((faces (face-list))
-           the-face)
-       (setq ps-ref-bold-faces nil
-             ps-ref-italic-faces nil
-             ps-ref-underlined-faces nil)
-       (while faces
-         (setq the-face (car faces))
-         (if (ps-face-italic-p the-face)
-             (setq ps-ref-italic-faces
-                   (cons the-face ps-ref-italic-faces)))
-         (if (ps-face-bold-p the-face)
-             (setq ps-ref-bold-faces
-                   (cons the-face ps-ref-bold-faces)))
-         (if (ps-face-underlined-p the-face)
-             (setq ps-ref-underlined-faces
-                   (cons the-face ps-ref-underlined-faces)))
-         (setq faces (cdr faces))))
-    (setq ps-ref-bold-faces ps-bold-faces)
-    (setq ps-ref-italic-faces ps-italic-faces)
-    (setq ps-ref-underlined-faces ps-underlined-faces))
+      (mapcar 'ps-map-face (face-list))
+    (mapcar 'ps-set-face-bold ps-bold-faces)
+    (mapcar 'ps-set-face-italic ps-italic-faces)
+    (mapcar 'ps-set-face-underline ps-underlined-faces))
   (setq ps-build-face-reference nil))
 
-(defun ps-mapper (extent list)
-  (nconc list (list (list (extent-start-position extent) 'push extent)
-                    (list (extent-end-position extent) 'pull extent)))
-  nil)
 
-(defun ps-extent-sorter (a b)
-  (< (extent-priority a) (extent-priority b)))
+(defun ps-set-face-bold (face)
+  (ps-set-face-attribute face 1))
+
+(defun ps-set-face-italic (face)
+  (ps-set-face-attribute face 2))
+
+(defun ps-set-face-underline (face)
+  (ps-set-face-attribute face 4))
+
+
+(defun ps-set-face-attribute (face effect)
+  (let ((face-bit (cdr (ps-map-face face))))
+    (aset face-bit 0 (logior (aref face-bit 0) effect))))
+
+
+(defun ps-map-face (face)
+  (let* ((face-map (ps-screen-to-bit-face face))
+        (ps-face-bit (cdr (assq (car face-map) ps-print-face-alist))))
+    (if ps-face-bit
+       ;; if face exists, merge both
+       (let ((face-bit (cdr face-map)))
+         (aset ps-face-bit 0 (logior (aref ps-face-bit 0) (aref face-bit 0)))
+         (or (aref ps-face-bit 1) (aset ps-face-bit 1 (aref face-bit 1)))
+         (or (aref ps-face-bit 2) (aset ps-face-bit 2 (aref face-bit 2))))
+      ;; if face does not exist, insert it
+      (setq ps-print-face-alist (cons face-map ps-print-face-alist)))
+    face-map))
+
+
+(defun ps-screen-to-bit-face (face)
+  (cons face
+       (vector (logior (if (ps-face-bold-p face) 1 0) ; bold
+                       (if (ps-face-italic-p face) 2 0) ; italic
+                       (if (ps-face-underlined-p face) 4 0)) ; underline
+               (face-foreground face)
+               (face-background face))))
+
+
+(cond ((not (eq ps-print-emacs-type 'emacs))
+                                       ; xemacs
+                                       ; lucid
+                                       ; epoch
+       (defun ps-mapper (extent list)
+        (nconc list (list (list (extent-start-position extent) 'push extent)
+                          (list (extent-end-position extent) 'pull extent)))
+        nil)
+
+       (defun ps-extent-sorter (a b)
+        (< (extent-priority a) (extent-priority b)))
+       ))
+
 
 (defun ps-print-ensure-fontified (start end)
-  (if (and (boundp 'lazy-lock-mode) lazy-lock-mode)
-      (if (fboundp 'lazy-lock-fontify-region)
-          (lazy-lock-fontify-region start end) ; the new
-        (lazy-lock-fontify-buffer))))         ; the old
+  (and (boundp 'lazy-lock-mode) (symbol-value 'lazy-lock-mode)
+       (lazy-lock-fontify-region start end)))
 
 (defun ps-generate-postscript-with-faces (from to)
+  ;; Some initialization...
+  (setq ps-current-effect 0)
+
   ;; Build the reference lists of faces if necessary.
   (if (or ps-always-build-face-reference
          ps-build-face-reference)
@@ -2601,274 +4063,342 @@ EndDSCPage\n"))
   ;; Set the color scale.  We do it here instead of in the defvar so
   ;; that ps-print can be dumped into emacs.  This expression can't be
   ;; evaluated at dump-time because X isn't initialized.
-  (setq ps-print-color-scale
-       (if ps-print-color-p
-           (float (car (ps-color-values "white")))
-         1.0))
+  (setq ps-color-p           (and ps-print-color-p (ps-color-device))
+       ps-print-color-scale (if ps-color-p
+                                (float (car (ps-color-values "white")))
+                              1.0))
   ;; Generate some PostScript.
   (save-restriction
     (narrow-to-region from to)
+    (ps-print-ensure-fontified from to)
     (let ((face 'default)
          (position to))
-      (ps-print-ensure-fontified from to)
-      (cond ((or (eq ps-print-emacs-type 'lucid)
-                (eq ps-print-emacs-type 'xemacs))
-          ;; Build the list of extents...
-          (let ((a (cons 'dummy nil))
-                record type extent extent-list)
-            (map-extents 'ps-mapper nil from to a)
-            (setq a (sort (cdr a) 'car-less-than-car))
-          
-            (setq extent-list nil)
-          
-            ;; Loop through the extents...
-            (while a
-              (setq record (car a))
-            
-              (setq position (car record))
-              (setq record (cdr record))
-            
-              (setq type (car record))
-              (setq record (cdr record))
-            
-              (setq extent (car record))
-            
-              ;; Plot up to this record.
-              ;; XEmacs 19.12: for some reason, we're getting into a
-              ;; situation in which some of the records have
-              ;; positions less than 'from'.  Since we've narrowed
-              ;; the buffer, this'll generate errors.  This is a
-              ;; hack, but don't call ps-plot-with-face unless from >
-              ;; point-min.
-              (if (and (>= from (point-min))
-                       (<= position (point-max)))
-                  (ps-plot-with-face from position face))
-            
-              (cond
-               ((eq type 'push)
-                (if (extent-face extent)
-                    (setq   extent-list (sort (cons extent extent-list)
-                                              'ps-extent-sorter))))
-             
-               ((eq type 'pull)
-                (setq extent-list (sort (delq extent extent-list)
-                                        'ps-extent-sorter))))
-            
-              (setq face
-                    (if extent-list
-                        (extent-face (car extent-list))
-                      'default))
-            
-              (setq from position)
-              (setq a (cdr a)))))
-
-           ((eq ps-print-emacs-type 'emacs)
-            (let ((property-change from)
-                  (overlay-change from))
-              (while (< from to)
-                (if (< property-change to) ; Don't search for property change
+      (cond
+       ((or (eq ps-print-emacs-type 'lucid)
+           (eq ps-print-emacs-type 'xemacs))
+       ;; Build the list of extents...
+       (let ((a (cons 'dummy nil))
+             record type extent extent-list)
+         (map-extents 'ps-mapper nil from to a)
+         (setq a (sort (cdr a) 'car-less-than-car)
+               extent-list nil)
+
+         ;; Loop through the extents...
+         (while a
+           (setq record (car a)
+
+                 position (car record)
+                 record (cdr record)
+
+                 type (car record)
+                 record (cdr record)
+
+                 extent (car record))
+
+           ;; Plot up to this record.
+           ;; XEmacs 19.12: for some reason, we're getting into a
+           ;; situation in which some of the records have
+           ;; positions less than 'from'.  Since we've narrowed
+           ;; the buffer, this'll generate errors.  This is a
+           ;; hack, but don't call ps-plot-with-face unless from >
+           ;; point-min.
+           (and (>= from (point-min)) (<= position (point-max))
+                (ps-plot-with-face from position face))
+
+           (cond
+            ((eq type 'push)
+             (and (extent-face extent)
+                  (setq extent-list (sort (cons extent extent-list)
+                                          'ps-extent-sorter))))
+
+            ((eq type 'pull)
+             (setq extent-list (sort (delq extent extent-list)
+                                     'ps-extent-sorter))))
+
+           (setq face (if extent-list
+                          (extent-face (car extent-list))
+                        'default)
+                 from position
+                 a (cdr a)))))
+
+       ((eq ps-print-emacs-type 'emacs)
+       (let ((property-change from)
+             (overlay-change from)
+             (save-buffer-invisibility-spec buffer-invisibility-spec)
+             (buffer-invisibility-spec nil))
+         (while (< from to)
+           (and (< property-change to) ; Don't search for property change
                                        ; unless previous search succeeded.
-                    (setq property-change
-                          (next-property-change from nil to)))
-                (if (< overlay-change to) ; Don't search for overlay change
+                (setq property-change (next-property-change from nil to)))
+           (and (< overlay-change to)  ; Don't search for overlay change
                                        ; unless previous search succeeded.
-                    (setq overlay-change
-                          (min (next-overlay-change from) to)))
-                (setq position
-                      (min property-change overlay-change))
-                ;; The code below is not quite correct,
-                ;; because a non-nil overlay invisible property
-                ;; which is inactive according to the current value
-                ;; of buffer-invisibility-spec nonetheless overrides
-                ;; a face text property.
-                (setq face
-                      (cond ((let ((prop (get-text-property from 'invisible)))
-                               ;; Decide whether this invisible property
-                               ;; really makes the text invisible.
-                               (if (eq buffer-invisibility-spec t)
-                                   (not (null prop))
-                                 (or (memq prop buffer-invisibility-spec)
-                                     (assq prop buffer-invisibility-spec))))
-                             nil)
-                            ((get-text-property from 'face))
-                            (t 'default)))
-                (let ((overlays (overlays-at from))
-                      (face-priority -1)) ; text-property
-                  (while overlays
-                    (let* ((overlay (car overlays))
-                           (overlay-face (overlay-get overlay 'face))
-                           (overlay-invisible (overlay-get overlay 'invisible))
-                           (overlay-priority (or (overlay-get overlay
-                                                              'priority)
-                                                 0)))
-                      (if (and (or overlay-invisible overlay-face)
-                               (> overlay-priority face-priority))
-                          (setq face (cond ((if (eq buffer-invisibility-spec t)
-                                                (not (null overlay-invisible))
-                                              (or (memq overlay-invisible buffer-invisibility-spec)
-                                                  (assq overlay-invisible buffer-invisibility-spec)))
-                                            nil)
-                                           ((and face overlay-face)))
-                                face-priority overlay-priority)))
-                    (setq overlays (cdr overlays))))
-                ;; Plot up to this record.
-                (ps-plot-with-face from position face)
-                (setq from position)))))
-      (ps-plot-with-face from to face))))  
+                (setq overlay-change (min (next-overlay-change from) to)))
+           (setq position (min property-change overlay-change))
+           ;; The code below is not quite correct,
+           ;; because a non-nil overlay invisible property
+           ;; which is inactive according to the current value
+           ;; of buffer-invisibility-spec nonetheless overrides
+           ;; a face text property.
+           (setq face
+                 (cond ((let ((prop (get-text-property from 'invisible)))
+                          ;; Decide whether this invisible property
+                          ;; really makes the text invisible.
+                          (if (eq save-buffer-invisibility-spec t)
+                              (not (null prop))
+                            (or (memq prop save-buffer-invisibility-spec)
+                                (assq prop save-buffer-invisibility-spec))))
+                        'emacs--invisible--face)
+                       ((get-text-property from 'face))
+                       (t 'default)))
+           (let ((overlays (overlays-at from))
+                 (face-priority -1))   ; text-property
+             (while (and overlays
+                         (not (eq face 'emacs--invisible--face)))
+               (let* ((overlay (car overlays))
+                      (overlay-invisible (overlay-get overlay 'invisible))
+                      (overlay-priority (or (overlay-get overlay 'priority)
+                                            0)))
+                 (and (> overlay-priority face-priority)
+                      (setq face
+                            (cond ((if (eq save-buffer-invisibility-spec t)
+                                       (not (null overlay-invisible))
+                                     (or (memq overlay-invisible
+                                               save-buffer-invisibility-spec)
+                                         (assq overlay-invisible
+                                               save-buffer-invisibility-spec)))
+                                   'emacs--invisible--face)
+                                  ((overlay-get overlay 'face))
+                                  (t face))
+                            face-priority overlay-priority)))
+               (setq overlays (cdr overlays))))
+           ;; Plot up to this record.
+           (ps-plot-with-face from position face)
+           (setq from position)))))
+      (ps-plot-with-face from to face))))
 
 (defun ps-generate-postscript (from to)
   (ps-plot-region from to 0 nil))
 
 (defun ps-generate (buffer from to genfunc)
-  (let ((from (min to from))
-       (to (max to from))
-       ;; This avoids trouble if chars with read-only properties
-       ;; are copied into ps-spool-buffer.
-       (inhibit-read-only t))
-    (save-restriction
-      (narrow-to-region from to)
-      (if ps-razzle-dazzle
-         (message "Formatting...%3d%%" (setq ps-razchunk 0)))
-      (set-buffer buffer)
-      (setq ps-source-buffer buffer)
-      (setq ps-spool-buffer (get-buffer-create ps-spool-buffer-name))
-      (ps-init-output-queue)
-      (let (safe-marker completed-safely needs-begin-file)
-       (unwind-protect
-           (progn
-             (set-buffer ps-spool-buffer)
-           
-             ;; Get a marker and make it point to the current end of the
-             ;; buffer,  If an error occurs, we'll delete everything from
-             ;; the end of this marker onwards.
-             (setq safe-marker (make-marker))
-             (set-marker safe-marker (point-max))
-           
-             (goto-char (point-min))
-             (if (looking-at (regexp-quote "%!PS-Adobe-1.0"))
-                 nil
-               (setq needs-begin-file t))
-             (save-excursion
-               (set-buffer ps-source-buffer)
-               (if needs-begin-file (ps-begin-file))
-               (ps-begin-job)
-               (ps-begin-page))
-             (set-buffer ps-source-buffer)
-             (funcall genfunc from to)
-             (ps-end-page)
-           
-             (if (and ps-spool-duplex
-                      (= (mod ps-page-count 2) 1))
-                 (ps-dummy-page))
-             (ps-flush-output)
-           
-             ;; Back to the PS output buffer to set the page count
-             (set-buffer ps-spool-buffer)
-             (goto-char (point-max))
-             (while (re-search-backward "^/PageCount 0 def$" nil t)
-               (replace-match (format "/PageCount %d def" ps-page-count) t))
-
-             ;; Setting this variable tells the unwind form that the
-             ;; the postscript was generated without error.
-             (setq completed-safely t))
-
-         ;; Unwind form: If some bad mojo occurred while generating
-         ;; postscript, delete all the postscript that was generated.
-         ;; This protects the previously spooled files from getting
-         ;; corrupted.
-         (if (and (markerp safe-marker) (not completed-safely))
+  (save-excursion
+    (let ((from (min to from))
+         (to (max to from))
+         ;; This avoids trouble if chars with read-only properties
+         ;; are copied into ps-spool-buffer.
+         (inhibit-read-only t))
+      (save-restriction
+       (narrow-to-region from to)
+       (and ps-razzle-dazzle
+            (message "Formatting...%3d%%" (setq ps-razchunk 0)))
+       (setq ps-source-buffer buffer
+             ps-spool-buffer (get-buffer-create ps-spool-buffer-name))
+       (ps-init-output-queue)
+       (let (safe-marker completed-safely needs-begin-file)
+         (unwind-protect
              (progn
                (set-buffer ps-spool-buffer)
-               (delete-region (marker-position safe-marker) (point-max))))))
-
-      (if ps-razzle-dazzle
-         (message "Formatting...done")))))
-
+               (set-buffer-multibyte nil)
+
+               ;; Get a marker and make it point to the current end of the
+               ;; buffer,  If an error occurs, we'll delete everything from
+               ;; the end of this marker onwards.
+               (setq safe-marker (make-marker))
+               (set-marker safe-marker (point-max))
+
+               (goto-char (point-min))
+               (or (looking-at (regexp-quote ps-adobe-tag))
+                   (setq needs-begin-file t))
+               (save-excursion
+                 (set-buffer ps-source-buffer)
+                 (ps-begin-job)
+                 (when needs-begin-file
+                   (ps-begin-file)
+                   (ps-mule-initialize))
+                 (ps-mule-begin-job from to)
+                 (ps-begin-page))
+               (set-buffer ps-source-buffer)
+               (funcall genfunc from to)
+               (ps-end-page)
+
+               (and ps-spool-duplex (= (mod ps-page-count 2) 1)
+                    (ps-dummy-page))
+               (ps-end-file)
+               (ps-flush-output)
+
+               ;; Back to the PS output buffer to set the page count
+               (let ((total-lines (if ps-printing-region
+                                      (cdr ps-printing-region)
+                                    (ps-count-lines (point-min) (point-max))))
+                     (total-pages (if ps-print-only-one-header
+                                      (ps-page-number)
+                                    ps-page-count)))
+                 (set-buffer ps-spool-buffer)
+                 (goto-char (point-min))
+                 (while (re-search-forward "^/Lines 0 def\n/PageCount 0 def$"
+                                           nil t)
+                   (replace-match (format "/Lines %d def\n/PageCount %d def"
+                                          total-lines total-pages) t)))
+
+               ;; Setting this variable tells the unwind form that the
+               ;; the PostScript was generated without error.
+               (setq completed-safely t))
+
+           ;; Unwind form: If some bad mojo occurred while generating
+           ;; PostScript, delete all the PostScript that was generated.
+           ;; This protects the previously spooled files from getting
+           ;; corrupted.
+           (and (markerp safe-marker) (not completed-safely)
+                (progn
+                  (set-buffer ps-spool-buffer)
+                  (delete-region (marker-position safe-marker) (point-max))))))
+
+       (and ps-razzle-dazzle (message "Formatting...done"))))))
+
+
+;; to avoid compilation gripes.
+(defvar dos-ps-printer nil)
+
+
+;; Permit dynamic evaluation at print time of `ps-lpr-switches'.
 (defun ps-do-despool (filename)
   (if (or (not (boundp 'ps-spool-buffer))
          (not (symbol-value 'ps-spool-buffer)))
       (message "No spooled PostScript to print")
-    (ps-end-file)
-    (ps-flush-output)
     (if filename
        (save-excursion
-         (if ps-razzle-dazzle
-             (message "Saving..."))
+         (and ps-razzle-dazzle (message "Saving..."))
          (set-buffer ps-spool-buffer)
          (setq filename (expand-file-name filename))
-         (write-region (point-min) (point-max) filename)
-         (if ps-razzle-dazzle
-             (message "Wrote %s" filename)))
+         (let ((coding-system-for-write 'raw-text-unix))
+           (write-region (point-min) (point-max) filename))
+         (and ps-razzle-dazzle (message "Wrote %s" filename)))
       ;; Else, spool to the printer
-      (if ps-razzle-dazzle
-         (message "Printing..."))
+      (and ps-razzle-dazzle (message "Printing..."))
       (save-excursion
        (set-buffer ps-spool-buffer)
-       (if (and (eq system-type 'ms-dos) (stringp dos-ps-printer))
-           (write-region (point-min) (point-max) dos-ps-printer t 0)
-         (let ((binary-process-input t)) ; for MS-DOS
-           (apply 'call-process-region
-                  (point-min) (point-max) ps-lpr-command nil
-                  (if (fboundp 'start-process) 0 nil)
-                  nil
-                  ps-lpr-switches))))
-      (if ps-razzle-dazzle
-         (message "Printing...done")))
+       (let* ((coding-system-for-write 'raw-text-unix)
+              (ps-printer-name (or ps-printer-name
+                                   (and (boundp 'printer-name)
+                                        printer-name)))
+              (ps-lpr-switches
+               (append
+                (and (stringp ps-printer-name)
+                     (list (concat "-P" ps-printer-name)))
+                ps-lpr-switches)))
+         (apply (or ps-print-region-function 'call-process-region)
+                (point-min) (point-max) ps-lpr-command nil
+                (and (fboundp 'start-process) 0)
+                nil
+                (ps-flatten-list       ; dynamic evaluation
+                 (mapcar 'ps-eval-switch ps-lpr-switches)))))
+      (and ps-razzle-dazzle (message "Printing...done")))
     (kill-buffer ps-spool-buffer)))
 
+;; Dynamic evaluation
+(defun ps-eval-switch (arg)
+  (cond ((stringp arg) arg)
+       ((functionp arg) (apply arg nil))
+       ((symbolp arg) (symbol-value arg))
+       ((consp arg) (apply (car arg) (cdr arg)))
+       (t nil)))
+
+;; `ps-flatten-list' is defined here (copied from "message.el" and
+;; enhanced to handle dotted pairs as well) until we can get some
+;; sensible autoloads, or `flatten-list' gets put somewhere decent.
+
+;; (ps-flatten-list '((a . b) c (d . e) (f g h) i . j))
+;; => (a b c d e f g h i j)
+
+(defun ps-flatten-list (&rest list)
+  (ps-flatten-list-1 list))
+
+(defun ps-flatten-list-1 (list)
+  (cond ((null list) nil)
+       ((consp list) (append (ps-flatten-list-1 (car list))
+                             (ps-flatten-list-1 (cdr list))))
+       (t (list list))))
+
 (defun ps-kill-emacs-check ()
   (let (ps-buffer)
-    (if (and (setq ps-buffer (get-buffer ps-spool-buffer-name))
-            (buffer-modified-p ps-buffer))
-       (if (y-or-n-p "Unprinted PostScript waiting; print now? ")
-           (ps-despool)))
-    (if (and (setq ps-buffer (get-buffer ps-spool-buffer-name))
-            (buffer-modified-p ps-buffer))
-       (if (yes-or-no-p "Unprinted PostScript waiting; exit anyway? ")
-           nil
-         (error "Unprinted PostScript")))))
-
-(if (fboundp 'add-hook)
-    (funcall 'add-hook 'kill-emacs-hook 'ps-kill-emacs-check)
-  (if kill-emacs-hook
-      (message "Won't override existing kill-emacs-hook")
-    (setq kill-emacs-hook 'ps-kill-emacs-check)))
-
+    (and (setq ps-buffer (get-buffer ps-spool-buffer-name))
+        (buffer-modified-p ps-buffer)
+        (y-or-n-p "Unprinted PostScript waiting; print now? ")
+        (ps-despool))
+    (and (setq ps-buffer (get-buffer ps-spool-buffer-name))
+        (buffer-modified-p ps-buffer)
+        (not (yes-or-no-p "Unprinted PostScript waiting; exit anyway? "))
+        (error "Unprinted PostScript"))))
+
+(cond ((fboundp 'add-hook)
+       (funcall 'add-hook 'kill-emacs-hook 'ps-kill-emacs-check))
+      (kill-emacs-hook
+       (message "Won't override existing `kill-emacs-hook'"))
+      (t
+       (setq kill-emacs-hook 'ps-kill-emacs-check)))
+
+\f
+;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
 ;;; Sample Setup Code:
 
 ;; This stuff is for anybody that's brave enough to look this far,
-;; and able to figure out how to use it.  It isn't really part of ps-
-;; print, but I'll leave it here in hopes it might be useful:
-
-;; WARNING!!! The following code is *sample* code only. Don't use it
-;; unless you understand what it does!
+;; and able to figure out how to use it.  It isn't really part of
+;; ps-print, but I'll leave it here in hopes it might be useful:
+
+;; WARNING!!! The following code is *sample* code only.
+;; Don't use it unless you understand what it does!
+
+(defmacro ps-prsc ()
+  `(if (eq ps-print-emacs-type 'emacs) [f22] 'f22))
+(defmacro ps-c-prsc ()
+  `(if (eq ps-print-emacs-type 'emacs) [C-f22] '(control f22)))
+(defmacro ps-s-prsc ()
+  `(if (eq ps-print-emacs-type 'emacs) [S-f22] '(shift f22)))
+
+;; A hook to bind to `rmail-mode-hook' to locally bind prsc and set the
+;; `ps-left-headers' specially for mail messages.
+(defun ps-rmail-mode-hook ()
+  (local-set-key (ps-prsc) 'ps-rmail-print-message-from-summary)
+  (setq ps-header-lines 3
+       ps-left-header
+       ;; The left headers will display the message's subject, its
+       ;; author, and the name of the folder it was in.
+       '(ps-article-subject ps-article-author buffer-name)))
 
-(defmacro ps-prsc () (list 'if (list 'eq 'ps-print-emacs-type ''emacs)
-                          [f22] ''f22))
-(defmacro ps-c-prsc () (list 'if (list 'eq 'ps-print-emacs-type ''emacs)
-                            [C-f22]
-                            ''(control f22)))
-(defmacro ps-s-prsc () (list 'if (list 'eq 'ps-print-emacs-type ''emacs)
-                            [S-f22]
-                            ''(shift f22)))
+;; See `ps-gnus-print-article-from-summary'.  This function does the
+;; same thing for rmail.
+(defun ps-rmail-print-message-from-summary ()
+  (interactive)
+  (ps-print-message-from-summary 'rmail-summary-buffer "RMAIL"))
+
+;; Used in `ps-rmail-print-article-from-summary',
+;; `ps-gnus-print-article-from-summary' and `ps-vm-print-message-from-summary'.
+(defun ps-print-message-from-summary (summary-buffer summary-default)
+  (let ((ps-buf (or (and (boundp summary-buffer)
+                        (symbol-value summary-buffer))
+                   summary-default)))
+    (and (get-buffer ps-buf)
+        (save-excursion
+          (set-buffer ps-buf)
+          (ps-spool-buffer-with-faces)))))
 
 ;; Look in an article or mail message for the Subject: line.  To be
-;; placed in ps-left-headers.
+;; placed in `ps-left-headers'.
 (defun ps-article-subject ()
   (save-excursion
     (goto-char (point-min))
     (if (re-search-forward "^Subject:[ \t]+\\(.*\\)$" nil t)
-       (buffer-substring (match-beginning 1) (match-end 1))
+       (buffer-substring-no-properties (match-beginning 1) (match-end 1))
       "Subject ???")))
 
 ;; Look in an article or mail message for the From: line.  Sorta-kinda
 ;; understands RFC-822 addresses and can pull the real name out where
-;; it's provided.  To be placed in ps-left-headers.
+;; it's provided.  To be placed in `ps-left-headers'.
 (defun ps-article-author ()
   (save-excursion
     (goto-char (point-min))
     (if (re-search-forward "^From:[ \t]+\\(.*\\)$" nil t)
-       (let ((fromstring (buffer-substring (match-beginning 1) (match-end 1))))
+       (let ((fromstring (buffer-substring-no-properties (match-beginning 1)
+                                                         (match-end 1))))
          (cond
 
           ;; Try first to match addresses that look like
@@ -2885,83 +4415,77 @@ EndDSCPage\n"))
           (t fromstring)))
       "From ???")))
 
-;; A hook to bind to gnus-Article-prepare-hook.  This will set the ps-
-;; left-headers specially for gnus articles.  Unfortunately, gnus-
-;; article-mode-hook is called only once, the first time the *Article*
+;; A hook to bind to `gnus-article-prepare-hook'.  This will set the
+;; `ps-left-headers' specially for gnus articles.  Unfortunately,
+;; `gnus-article-mode-hook' is called only once, the first time the *Article*
 ;; buffer enters that mode, so it would only work for the first time
 ;; we ran gnus.  The second time, this hook wouldn't get set up.  The
-;; only alternative is gnus-article-prepare-hook.
+;; only alternative is `gnus-article-prepare-hook'.
 (defun ps-gnus-article-prepare-hook ()
-  (setq ps-header-lines 3)
-  (setq ps-left-header
+  (setq ps-header-lines 3
+       ps-left-header
        ;; The left headers will display the article's subject, its
        ;; author, and the newsgroup it was in.
-       (list 'ps-article-subject 'ps-article-author 'gnus-newsgroup-name)))
+       '(ps-article-subject ps-article-author gnus-newsgroup-name)))
 
-;; A hook to bind to vm-mode-hook to locally bind prsc and set the ps-
-;; left-headers specially for mail messages.  This header setup would
-;; also work, I think, for RMAIL.
+;; A hook to bind to `vm-mode-hook' to locally bind prsc and set the
+;; `ps-left-headers' specially for mail messages.
 (defun ps-vm-mode-hook ()
   (local-set-key (ps-prsc) 'ps-vm-print-message-from-summary)
-  (setq ps-header-lines 3)
-  (setq ps-left-header
+  (setq ps-header-lines 3
+       ps-left-header
        ;; The left headers will display the message's subject, its
        ;; author, and the name of the folder it was in.
-       (list 'ps-article-subject 'ps-article-author 'buffer-name)))
+       '(ps-article-subject ps-article-author buffer-name)))
 
 ;; Every now and then I forget to switch from the *Summary* buffer to
 ;; the *Article* before hitting prsc, and a nicely formatted list of
 ;; article subjects shows up at the printer.  This function, bound to
 ;; prsc for the gnus *Summary* buffer means I don't have to switch
 ;; buffers first.
+;; sb:  Updated for Gnus 5.
 (defun ps-gnus-print-article-from-summary ()
   (interactive)
-  (if (get-buffer "*Article*")
-      (save-excursion
-       (set-buffer "*Article*")
-       (ps-spool-buffer-with-faces))))
+  (ps-print-message-from-summary 'gnus-article-buffer "*Article*"))
 
-;; See ps-gnus-print-article-from-summary.  This function does the
+;; See `ps-gnus-print-article-from-summary'.  This function does the
 ;; same thing for vm.
 (defun ps-vm-print-message-from-summary ()
   (interactive)
-  (if (and (boundp 'vm-mail-buffer) (symbol-value 'vm-mail-buffer))
-      (save-excursion
-       (set-buffer (symbol-value 'vm-mail-buffer))
-       (ps-spool-buffer-with-faces))))
+  (ps-print-message-from-summary 'vm-mail-buffer ""))
 
-;; A hook to bind to bind to gnus-summary-setup-buffer to locally bind
+;; A hook to bind to bind to `gnus-summary-setup-buffer' to locally bind
 ;; prsc.
 (defun ps-gnus-summary-setup ()
   (local-set-key (ps-prsc) 'ps-gnus-print-article-from-summary))
 
 ;; Look in an article or mail message for the Subject: line.  To be
-;; placed in ps-left-headers.
+;; placed in `ps-left-headers'.
 (defun ps-info-file ()
   (save-excursion
     (goto-char (point-min))
     (if (re-search-forward "File:[ \t]+\\([^, \t\n]*\\)" nil t)
-       (buffer-substring (match-beginning 1) (match-end 1))
+       (buffer-substring-no-properties (match-beginning 1) (match-end 1))
       "File ???")))
 
 ;; Look in an article or mail message for the Subject: line.  To be
-;; placed in ps-left-headers.
+;; placed in `ps-left-headers'.
 (defun ps-info-node ()
   (save-excursion
     (goto-char (point-min))
     (if (re-search-forward "Node:[ \t]+\\([^,\t\n]*\\)" nil t)
-       (buffer-substring (match-beginning 1) (match-end 1))
+       (buffer-substring-no-properties (match-beginning 1) (match-end 1))
       "Node ???")))
 
 (defun ps-info-mode-hook ()
   (setq ps-left-header
        ;; The left headers will display the node name and file name.
-       (list 'ps-info-node 'ps-info-file)))
+       '(ps-info-node ps-info-file)))
 
 ;; WARNING! The following function is a *sample* only, and is *not*
 ;; meant to be used as a whole unless you understand what the effects
-;; will be!  (In fact, this is a copy of Jim's setup for ps-print -- I'd
-;; be very surprised if it was useful to *anybody*, without
+;; will be!  (In fact, this is a copy of Jim's setup for ps-print --
+;; I'd be very surprised if it was useful to *anybody*, without
 ;; modification.)
 
 (defun ps-jts-ps-setup ()
@@ -2973,10 +4497,10 @@ EndDSCPage\n"))
   (add-hook 'vm-mode-hook 'ps-vm-mode-hook)
   (add-hook 'vm-mode-hooks 'ps-vm-mode-hook)
   (add-hook 'Info-mode-hook 'ps-info-mode-hook)
-  (setq ps-spool-duplex t)
-  (setq ps-print-color-p nil)
-  (setq ps-lpr-command "lpr")
-  (setq ps-lpr-switches '("-Jjct,duplex_long"))
+  (setq ps-spool-duplex t
+       ps-print-color-p nil
+       ps-lpr-command "lpr"
+       ps-lpr-switches '("-Jjct,duplex_long"))
   'ps-jts-ps-setup)
 
 ;; WARNING! The following function is a *sample* only, and is *not*
@@ -2986,12 +4510,12 @@ EndDSCPage\n"))
 ;; without modification.)
 
 (defun ps-jack-setup ()
-  (setq ps-print-color-p  'nil
+  (setq ps-print-color-p  nil
        ps-lpr-command    "lpr"
-       ps-lpr-switches   (list)
+       ps-lpr-switches   nil
 
-       ps-paper-type       'a4
-       ps-landscape-mode   't
+       ps-paper-type        'a4
+       ps-landscape-mode    t
        ps-number-of-columns 2
 
        ps-left-margin   (/ (* 72  1.0) 2.54) ;  1.0 cm
@@ -3014,6 +4538,45 @@ EndDSCPage\n"))
        ps-header-title-font-size  8)
   'ps-jack-setup)
 
+\f
+;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
+;; To make this file smaller, some commands go in a separate file.
+;; But autoload them here to make the separation invisible.
+
+(autoload 'ps-mule-prepare-ascii-font "ps-mule"
+  "Setup special ASCII font for STRING.
+STRING should contain only ASCII characters.")
+
+(autoload 'ps-mule-set-ascii-font     "ps-mule"
+  "Adjust current font if current charset is not ASCII.")
+
+(autoload 'ps-mule-plot-string        "ps-mule"
+  "Generate PostScript code for ploting characters in the region FROM and TO.
+
+It is assumed that all characters in this region belong to the same charset.
+
+Optional argument BG-COLOR specifies background color.
+
+Returns the value:
+
+       (ENDPOS . RUN-WIDTH)
+
+Where ENDPOS is the end position of the sequence and RUN-WIDTH is the width of
+the sequence.")
+
+(autoload 'ps-mule-initialize         "ps-mule"
+  "Initialize global data for printing multi-byte characters.")
+
+(autoload 'ps-mule-begin-job          "ps-mule"
+  "Start printing job for multi-byte chars between FROM and TO.
+This checks if all multi-byte characters in the region are printable or not.")
+
+(autoload 'ps-mule-begin-page         "ps-mule"
+  "Initialize multi-byte charset for printing current page.")
+
+\f
+;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
+
 (provide 'ps-print)
 
 ;;; ps-print.el ends here