Date: Thu, 23 Jan 2003 19:29:56 +0100 (CET) From: Stefan Bethke <stb@lassitu.de> To: FreeBSD-gnats-submit@FreeBSD.org Subject: docs/47411: Printing chapter of handbook explains functionality removed 6 years ago Message-ID: <200301231829.h0NITuAS095261@schlepper.zs64.net>
index | next in thread | raw e-mail
>Number: 47411
>Category: docs
>Synopsis: Printing chapter of handbook explains functionality removed 6 years ago
>Confidential: no
>Severity: non-critical
>Priority: medium
>Responsible: freebsd-doc
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: doc-bug
>Submitter-Id: current-users
>Arrival-Date: Thu Jan 23 10:30:00 PST 2003
>Closed-Date:
>Last-Modified:
>Originator: Stefan Bethke
>Release: n/a
>Organization:
>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:
n/a
>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>
>Release-Note:
>Audit-Trail:
>Unformatted:
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
help
Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200301231829.h0NITuAS095261>