[Emacs-diffs] emacs/doc/emacs ChangeLog misc.texi

[Vinicius Jose Latorre]

CVSROOT:        /sources/emacs
Module name:    emacs
Changes by:     Vinicius Jose Latorre <viniciusjl>      08/12/14 12:14:32

Modified files:
        doc/emacs      : ChangeLog misc.texi 

Log message:
        PostScript Variables: fix doc.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/emacs/ChangeLog?cvsroot=emacs&r1=1.249&r2=1.250
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/emacs/misc.texi?cvsroot=emacs&r1=1.17&r2=1.18

Patches:
Index: ChangeLog
===================================================================
RCS file: /sources/emacs/emacs/doc/emacs/ChangeLog,v
retrieving revision 1.249
retrieving revision 1.250
diff -u -b -r1.249 -r1.250
--- ChangeLog   10 Dec 2008 19:01:46 -0000      1.249
+++ ChangeLog   14 Dec 2008 12:14:30 -0000      1.250
@@ -1,3 +1,7 @@
+2008-12-14  vinicius Jose Latorre  <address@hidden>
+
+       * misc.texi (PostScript Variables): Fix doc.
+
 2008-12-10  Chong Yidong  <address@hidden>
 
        * programs.texi (Program Modes): Mention Ruby mode.

Index: misc.texi
===================================================================
RCS file: /sources/emacs/emacs/doc/emacs/misc.texi,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -b -r1.17 -r1.18
--- misc.texi   10 Dec 2008 07:56:52 -0000      1.17
+++ misc.texi   14 Dec 2008 12:14:31 -0000      1.18
@@ -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.
address@hidden 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
address@hidden, 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.
+
address@hidden 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
address@hidden, 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