Bug 47410

  >Submitter-Id:	current-users
  >Originator:	Stefan Bethke
  >Organization:	
  >Confidential:	no
  >Synopsis:	Printing chapter of handbook explains functionality removed  
 6 years ago
  >Severity:	non-critical
  >Priority:	medium
  >Category:	docs
  >Class:		doc-bug
  >Release:	FreeBSD 4.6-STABLE i386
  >Environment:
  >Description:
 	Section 11.3.1.4.5. Configuring Spooler Communication Parameters
 	documents the fc#, fs#, xc#, and xs# printcap(5) capabilities, which
 	were removed over six years ago:
 	http://www.freebsd.org/cgi/cvsweb.cgi/src/usr.sbin/lpr/lpr/ 
 printcap.5#rev1.2
 	http://www.freebsd.org/cgi/cvsweb.cgi/src/usr.sbin/lpr/common_source/ 
 common.c#rev1.3
 
  >How-To-Repeat:
  >Fix:
 
 Index: chapter.sgml
 ===================================================================
 RCS file:  
 /home/ncvs/doc/en_US.ISO8859-1/books/handbook/printing/chapter.sgml,v
 retrieving revision 1.65
 diff -u -r1.65 chapter.sgml
 --- chapter.sgml	12 Jan 2003 18:31:45 -0000	1.65
 +++ chapter.sgml	23 Jan 2003 17:33:07 -0000
 @@ -1256,78 +1256,41 @@
   		  <replaceable>bps-rate</replaceable>, where
   		  <replaceable>bps-rate</replaceable> can be 50, 75, 110,
   		  134, 150, 200, 300, 600, 1200, 1800, 2400, 4800, 9600,
 -		  19200, or 38400 bits-per-second.</para>
 +		  19200, 38400, 57600, or 115200 bits-per-second.</para>
   	      </listitem>
   	    </varlistentry>
 
   	    <varlistentry>
 -	       
 <term><literal>fc#<replaceable>clear-bits</replaceable></literal></term>
 +	       
 <term><literal>ms#<replaceable>stty-mode</replaceable></literal></term>
 
   	      <listitem>
 -		<para>Clears the flag bits
 -		  <replaceable>clear-bits</replaceable> in the
 -		  <replaceable>sgttyb</replaceable> structure after
 -		  opening the device.</para>
 +                <para>Sets the options for the terminal device after
 +                  opening the device. &man.stty.1; explains the  
 available
 +                  options.</para>
   	      </listitem>
   	    </varlistentry>
 
 -	    <varlistentry>
 -	       
 <term><literal>fs#<replaceable>set-bits</replaceable></literal></term>
 -
 -	      <listitem>
 -		<para>Sets the flag bits
 -		  <replaceable>set-bits</replaceable> in the
 -		  <replaceable>sgttyb</replaceable> structure.</para>
 -	      </listitem>
 -	    </varlistentry>
 -
 -	    <varlistentry>
 -	       
 <term><literal>xc#<replaceable>clear-bits</replaceable></literal></term>
 -
 -	      <listitem>
 -		<para>Clears local mode bits
 -		  <replaceable>clear-bits</replaceable> after opening the
 -		  device.</para>
 -	      </listitem>
 -	    </varlistentry>
 -
 -	    <varlistentry>
 -	       
 <term><literal>xs#<replaceable>set-bits</replaceable></literal></term>
 -
 -	      <listitem>
 -		<para>Sets local mode bits
 -		  <replaceable>set-bits</replaceable>.</para>
 -	      </listitem>
 -	    </varlistentry>
 -	  </variablelist>
 -
 -	  <para>For more information on the bits for the
 -	    <literal>fc</literal>, <literal>fs</literal>,
 -	    <literal>xc</literal>, and <literal>xs</literal> capabilities,
 -	    see the file
 -	    <filename>/usr/include/sys/ioctl_compat.h</filename>.</para>
 -
 -	  <para>When <application>LPD</application> opens the device
 -	    specified by the
 -	    <literal>lp</literal> capability, it reads the flag bits in
 -	    the <literal>sgttyb</literal> structure; it clears any bits in
 -	    the <literal>fc</literal> capability, then sets bits in the
 -	    <literal>fs</literal> capability, then applies the resultant
 -	    setting.  It does the same for the local mode bits as
 -	    well.</para>
 -
 -	  <para>Let us add to our example printer on the sixth serial
 -	    port.  We will set the bps rate to 38400.  For the flag bits,
 -	    we will set the <literal>TANDEM</literal>,
 -	    <literal>ANYP</literal>, <literal>LITOUT</literal>,
 -	    <literal>FLUSHO</literal>, and <literal>PASS8</literal> flags.
 -	    For the local mode bits, we will set the
 -	    <literal>LITOUT</literal> and <literal>PASS8</literal>
 -	    flags:</para>
 +	  <para>When <application>LPD</application> opens the device  
 specified by
 +	    the <literal>lp</literal> capability, it sets the characteristics  
 of
 +	    the device to those specified with the <literal>ms#</literal>
 +	    capability. Of particular interest will be the
 +	    <literal>parenb</literal>, <literal>parodd</literal>,
 +	    <literal>cs5</literal>, <literal>cs6</literal>,
 +	    <literal>cs7</literal>, <literal>cs8</literal>,
 +	    <literal>cstopb</literal>, <literal>crtscts</literal>, and
 +	    <literal>ixon</literal> modes, which are explained in the  
 &man.stty.1;
 +	    manual page.</para>
 +
 +	  <para>Let us add to our example printer on the sixth serial port. We
 +	    will set the bps rate to 38400. For the mode, we will set no  
 parity
 +	    with <literal>-parenb</literal>, 8-bit characters with
 +	    <literal>cs8</literal>, no modem control with
 +	    <literal>clocal</literal> and hardware flow control with
 +	    <literal>crtscts</literal>:</para>
 
   	  <programlisting>bamboo|ps|PS|S|panasonic|Panasonic KX-P4455  
 PostScript v51.4:\
           :sh:sd=/var/spool/lpd/bamboo:\
 -        :lp=/dev/ttyd5:fs#0x82000c1:xs#0x820:</programlisting>
 +        :lp=/dev/ttyd5:ms#-parenb cs8 clocal crtscts:</programlisting>
   	</sect4>
 
   	<sect4 id="printing-textfilter">
 @@ -1396,7 +1359,7 @@
 
   bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\
           :sh:sd=/var/spool/lpd/bamboo:\
 -        :lp=/dev/ttyd5:fs#0x82000e1:xs#0x820:\
 +        :lp=/dev/ttyd5:ms#-parenb cs8 clocal crtscts:\
           :if=/usr/local/libexec/if-simple:</programlisting>
   	</sect4>
 
 @@ -2167,7 +2130,7 @@
 
   bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\
           :sh:sd=/var/spool/lpd/bamboo:\
 -        :lp=/dev/ttyd5:fs#0x82000e1:xs#0x820:rw:\
 +        :lp=/dev/ttyd5:ms#-parenb cs8 clocal crtscts:rw:\
           :if=/usr/local/libexec/psif:\
           :df=/usr/local/libexec/psdf:</programlisting>
 
 @@ -3292,7 +3255,7 @@
 
   bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\
           :sh:sd=/var/spool/lpd/bamboo:sc:\
 -        :lp=/dev/ttyd5:fs#0x82000e1:xs#0x820:rw:\
 +        :lp=/dev/ttyd5:ms#-parenb cs8 clocal crtscts:rw:\
           :if=/usr/local/libexec/psif:\
           :df=/usr/local/libexec/psdf:</programlisting>
 
 @@ -3368,7 +3331,7 @@
 
   bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\
           :sh:sd=/var/spool/lpd/bamboo:sc:rg=artists:\
 -        :lp=/dev/ttyd5:fs#0x82000e1:xs#0x820:rw:\
 +        :lp=/dev/ttyd5:ms#-parenb cs8 clocal crtscts:rw:\
           :if=/usr/local/libexec/psif:\
           :df=/usr/local/libexec/psdf:</programlisting>
 
 @@ -3443,7 +3406,7 @@
   #
   bamboo|ps|PS|S|panasonic|Panasonic KX-P4455 PostScript v51.4:\
           :sh:sd=/var/spool/lpd/bamboo:sc:rg=artists:mx#5000:\
 -        :lp=/dev/ttyd5:fs#0x82000e1:xs#0x820:rw:\
 +        :lp=/dev/ttyd5:ms#-parenb cs8 clocal crtscts:rw:\
           :if=/usr/local/libexec/psif:\
           :df=/usr/local/libexec/psdf:</programlisting>
 
 @@ -3530,7 +3493,7 @@
 
                 <programlisting>bamboo|ps|PS|S|panasonic|Panasonic  
 KX-P4455 PostScript v51.4:\
           :sh:sd=/var/spool/lpd/bamboo:sc:rg=artists:mx#5000:\
 -        :lp=/dev/ttyd5:fs#0x82000e1:xs#0x820:rw:mx#5000:\
 +        :lp=/dev/ttyd5:ms#-parenb cs8 clocal crtscts:rw:mx#5000:\
           :if=/usr/local/libexec/psif:\
           :df=/usr/local/libexec/psdf:</programlisting>