[gs-cvs] rev 8321 - trunk/gs/doc

[giles at ghostscript.com]

Author: giles
Date: 2007-10-25 18:08:04 -0700 (Thu, 25 Oct 2007)
New Revision: 8321

Modified:
   trunk/gs/doc/Use.htm
Log:
Document how to use -dTTYPAUSE with -dSAFER. Bug 687988.


Modified: trunk/gs/doc/Use.htm
===================================================================
--- trunk/gs/doc/Use.htm	2007-10-25 22:14:22 UTC (rev 8320)
+++ trunk/gs/doc/Use.htm	2007-10-26 01:08:04 UTC (rev 8321)
@@ -2520,10 +2520,19 @@
 
 <dl>
 <dt><b><tt>-dTTYPAUSE</tt></b>
-<dd>Causes Ghostscript to read a character from <b><tt>/dev/tty</tt></b>,
+<dd>
+Causes Ghostscript to read a character from <b><tt>/dev/tty</tt></b>,
 rather than standard input, at the end of each page.  This may be useful if
 input is coming from a pipe.  Note that <b><tt>-dTTYPAUSE</tt></b>
 overrides <b><tt>-dNOPAUSE</tt></b>.
+
+Also note that <tt>-dTTYPAUSE</tt> requires openning the terminal 
+device directly, and may cause problems in combination with -dSAFER. 
+Permission errors  can be avoided by adding the device to the permitted 
+reading list before invoking safer mode. For example:
+<tt>gs -dTTYPAUSE -dDELAYSAFER 
+-c '<< /PermitFileReading [ (/dev/tty)] >>
+setuserparams .locksafe' -dSAFER</tt>
 </dl>
 
 <h4><a name="Output_selection_parameters"></a>Device and output selection parameters</h4>