From owner-freebsd-doc@FreeBSD.ORG  Sat Feb 20 09:40:02 2010
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@hub.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 1B81E1065672
	for <freebsd-doc@hub.freebsd.org>; Sat, 20 Feb 2010 09:40:02 +0000 (UTC)
	(envelope-from gnats@FreeBSD.org)
Received: from freefall.freebsd.org (freefall.freebsd.org
	[IPv6:2001:4f8:fff6::28])
	by mx1.freebsd.org (Postfix) with ESMTP id D2D608FC16
	for <freebsd-doc@hub.freebsd.org>; Sat, 20 Feb 2010 09:40:01 +0000 (UTC)
Received: from freefall.freebsd.org (localhost [127.0.0.1])
	by freefall.freebsd.org (8.14.3/8.14.3) with ESMTP id o1K9e1o4088967
	for <freebsd-doc@freefall.freebsd.org>; Sat, 20 Feb 2010 09:40:01 GMT
	(envelope-from gnats@freefall.freebsd.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.14.3/8.14.3/Submit) id o1K9e19I088966;
	Sat, 20 Feb 2010 09:40:01 GMT (envelope-from gnats)
Resent-Date: Sat, 20 Feb 2010 09:40:01 GMT
Resent-Message-Id: <201002200940.o1K9e19I088966@freefall.freebsd.org>
Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer)
Resent-To: freebsd-doc@FreeBSD.org
Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org,
	"G. Paul Ziemba" <p-fbsd-bugs@ziemba.us>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 57EC21065670
	for <freebsd-gnats-submit@FreeBSD.org>;
	Sat, 20 Feb 2010 09:32:40 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21])
	by mx1.freebsd.org (Postfix) with ESMTP id 463E18FC14
	for <freebsd-gnats-submit@FreeBSD.org>;
	Sat, 20 Feb 2010 09:32:40 +0000 (UTC)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.14.3/8.14.3) with ESMTP id o1K9Wend035749
	for <freebsd-gnats-submit@FreeBSD.org>; Sat, 20 Feb 2010 09:32:40 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.3/8.14.3/Submit) id o1K9WdNx035748;
	Sat, 20 Feb 2010 09:32:39 GMT (envelope-from nobody)
Message-Id: <201002200932.o1K9WdNx035748@www.freebsd.org>
Date: Sat, 20 Feb 2010 09:32:39 GMT
From: "G. Paul Ziemba" <p-fbsd-bugs@ziemba.us>
To: freebsd-gnats-submit@FreeBSD.org
X-Send-Pr-Version: www-3.1
Cc: 
Subject: docs/144127: termios(4) man page wrongly claims CCTS_OFLOW/CRTSCTS
	is unused
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sat, 20 Feb 2010 09:40:02 -0000


>Number:         144127
>Category:       docs
>Synopsis:       termios(4) man page wrongly claims CCTS_OFLOW/CRTSCTS is unused
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sat Feb 20 09:40:01 UTC 2010
>Closed-Date:
>Last-Modified:
>Originator:     G. Paul Ziemba
>Release:        8.X
>Organization:
>Environment:
FreeBSD foo.ziemba.us 8.0-STABLE FreeBSD 8.0-STABLE #2: Fri Dec 11 16:36:37 PST 2009     root@hairball:/usr/obj/usr/src/sys/GPZ-091127  i386
>Description:
termios(4) says:
"The CCTS_OFLOW (CRTSCTS) flag is currently unused."

Yet code in /usr/src/sys/dev/uart/uart_tty.c references CCTS_OFLOW and as far as I know, it works. Hasn't it worked forever?
>How-To-Repeat:

>Fix:
Proposed replacement text:

    If CCTS_OFLOW (CRTSCTS) is set, transmission is stopped when CTS is lowered and resumed when CTS is raised.

Maybe similar treatment is warranted for CRTS_IFLOW?

>Release-Note:
>Audit-Trail:
>Unformatted: