changeset 100420:35441f217a4c

PostScript Variables: fix doc.

--- a/doc/emacs/ChangeLog	Sun Dec 14 03:27:10 2008 +0000
+++ b/doc/emacs/ChangeLog	Sun Dec 14 12:14:30 2008 +0000
@@ -1,3 +1,7 @@
[phone]  vinicius Jose Latorre  <[e-mail]>
+
+	* misc.texi (PostScript Variables): Fix doc.
+
 2008-12-10  Chong Yidong  <[e-mail]>
 
 	* programs.texi (Program Modes): Mention Ruby mode.

--- a/doc/emacs/misc.texi	Sun Dec 14 03:27:10 2008 +0000
+++ b/doc/emacs/misc.texi	Sun Dec 14 12:14:30 2008 +0000
@@ -1760,15 +1760,17 @@
 Print hardcopy of the current region in PostScript form, showing the
 faces used in the text.
 @item M-x ps-spool-buffer
-Generate PostScript for the current buffer text.
+Generate and spool a PostScript image for the current buffer text.
 @item M-x ps-spool-region
-Generate PostScript for the current region.
+Generate and spool a PostScript image for the current region.
 @item M-x ps-spool-buffer-with-faces
-Generate PostScript for the current buffer, showing the faces used.
+Generate and spool a PostScript image for the current buffer, showing the faces used.
 @item M-x ps-spool-region-with-faces
-Generate PostScript for the current region, showing the faces used.
+Generate and spool a PostScript image for the current region, showing the faces used.
+@item M-x ps-despool
+Send the spooled PostScript to the printer.
 @item M-x handwrite
-Generates/prints PostScript for the current buffer as if handwritten.
+Generate/print PostScript for the current buffer as if handwritten.
 @end table
 
 @findex ps-print-region
@@ -1781,7 +1783,17 @@
 corresponding @samp{-with-faces} commands,
 @code{ps-print-buffer-with-faces} and @code{ps-print-region-with-faces},
 use PostScript features to show the faces (fonts and colors) in the text
-properties of the text being printed.
+properties of the text being printed.  The @samp{-with-faces} commands only
+work if they are used in a window system, so it has a way to determine color
+values.
+
+  Interactively, when you use a prefix argument (@kbd{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.
+
+  Noninteractively, the argument @var{filename} is treated as follows: if it is
+@code{nil}, send the image to the printer.  If @var{filename} is a string, save
+the PostScript image in a file with that name.
 
   If you are using a color display, you can print a buffer of program
 code with color highlighting by turning on Font-Lock mode in that
@@ -1791,10 +1803,24 @@
 @findex ps-spool-buffer
 @findex ps-spool-region-with-faces
 @findex ps-spool-buffer-with-faces
-  The commands whose names have @samp{spool} instead of @samp{print}
+  The commands whose names have @samp{spool} instead of @samp{print},
 generate the PostScript output in an Emacs buffer instead of sending
 it to the printer.
 
+  Use the command @code{ps-despool} to send the spooled images to the printer.
+
+@findex ps-despool
+  This command sends the PostScript generated by  @samp{-spool-} commands (see
+commands above) to the printer.
+
+  Interactively, when you use a prefix argument (@kbd{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.
+
+  Noninteractively, the argument @var{filename} is treated as follows: if it is
+@code{nil}, send the image to the printer.  If @var{filename} is a string, save
+the PostScript image in a file with that name.
+
 @findex handwrite
 @cindex handwriting
 @kbd{M-x handwrite} is more frivolous.  It generates a PostScript
@@ -1835,6 +1861,9 @@
 with shades of gray.  This might produce illegible output, even if your
 screen colors only use shades of gray.
 
+  Alternatively, you can set @code{ps-print-color-p} to @code{black-white} to
+print colors on black/white printers.
+
 @vindex ps-use-face-background
   By default, PostScript printing ignores the background colors of the
 faces, unless the variable @code{ps-use-face-background} is