From owner-freebsd-doc@FreeBSD.ORG  Sun Jul 18 13:00:38 2004
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@hub.freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 1D48F16A4D1
	for <freebsd-doc@hub.freebsd.org>;
	Sun, 18 Jul 2004 13:00:38 +0000 (GMT)
Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 7534643D48
	for <freebsd-doc@hub.freebsd.org>;
	Sun, 18 Jul 2004 13:00:26 +0000 (GMT)
	(envelope-from gnats@FreeBSD.org)
Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1])
	by freefall.freebsd.org (8.12.11/8.12.11) with ESMTP id i6ID0QAk032697
	for <freebsd-doc@freefall.freebsd.org>; Sun, 18 Jul 2004 13:00:26 GMT
	(envelope-from gnats@freefall.freebsd.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.12.11/8.12.11/Submit) id i6ID0QXA032696;
	Sun, 18 Jul 2004 13:00:26 GMT
	(envelope-from gnats)
Date: Sun, 18 Jul 2004 13:00:26 GMT
Message-Id: <200407181300.i6ID0QXA032696@freefall.freebsd.org>
To: freebsd-doc@FreeBSD.org
From: Marc Fonvieille <blackend@FreeBSD.org>
Subject: Re: docs/69225: PATCH-Serial comms chapter has wrong acronym for
	Transmit Data
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
Reply-To: Marc Fonvieille <blackend@FreeBSD.org>
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: Sun, 18 Jul 2004 13:00:38 -0000

The following reply was made to PR docs/69225; it has been noted by GNATS.

From: Marc Fonvieille <blackend@FreeBSD.org>
To: Giorgos Keramidas <keramida@ceid.upatras.gr>
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/69225: PATCH-Serial comms chapter has wrong acronym for Transmit Data
Date: Sun, 18 Jul 2004 14:54:39 +0200

 On Sun, Jul 18, 2004 at 12:00:52PM +0000, Giorgos Keramidas wrote:
 >  On 2004-07-17 22:40, Warren Block <wblock@wonkity.com> wrote:
 >  > --- /usr/doc/en_US.ISO8859-1/books/handbook/serialcomms/chapter.sgml	Sat Jul 17 06:22:19 2004
 >  > +++ chapter.sgml	Sat Jul 17 22:37:04 2004
 >  > @@ -978,11 +978,11 @@
 >  >
 >  >  	<itemizedlist>
 >  >  	  <listitem>
 >  > -	    <para>Transmitted Data (<acronym>SD</acronym>)</para>
 >  > +	    <para>Transmit Data (<acronym>TD</acronym>)</para>
 >  >  	  </listitem>
 >  
 >  Actually, the LED that shows transmit line activity in my modem is
 >  labelled "SD".  Perhaps, we should change the description text to "Sent
 >  Data" instead?
 >
 
 SD is on the modem, the text is talking about a RS232 cable: "A standard
 RS-232C serial cable should suffice as long as all of the normal signals
 are wired:"
 
 I'd change SD for TD which is the correct term in our case (or TxD, but
 in this case RD must be changed for RxD).  TD is the data transmitted by
 the DTE (our computer) to the DCE (modem), RD is data to DTE from DCE.
 These descriptions come from a time where half duplex was common.
 s/Transmitted/Transmit/ etc. is not mandatory, in fact both versions are
 used.  So I'd keep the description but I'd s/SD/TD which is correct.
 
 Marc