PostScript Variables: fix doc.

2 files changed, 40 insertions, 7 deletions

diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog
index 1ab00228952..57ea99cef21 100644
--- a/doc/emacs/ChangeLog
+++ b/doc/emacs/ChangeLog
@@ -1,3 +1,7 @@
+2008-12-14  vinicius Jose Latorre  <viniciusjl@ig.com.br>
+
+        * misc.texi (PostScript Variables): Fix doc.
+
 2008-12-10  Chong Yidong  <cyd@stupidchicken.com>
 
         * programs.texi (Program Modes): Mention Ruby mode.
diff --git a/doc/emacs/misc.texi b/doc/emacs/misc.texi
index 4b2ee402073..18c7ecfb6f3 100644
--- a/doc/emacs/misc.texi
+++ b/doc/emacs/misc.texi
@@ -1760,15 +1760,17 @@ faces used in the text by means of PostScript features.
 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 @@ command prints the entire buffer; the other, just the region.  The
 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 @@ buffer, and using @code{ps-print-buffer-with-faces}.
 @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 color information; on black-and-white printers, colors are emulated
 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