From wblock@wonkity.com  Sun Jul 18 04:40:58 2004
Return-Path: <wblock@wonkity.com>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 086E016A4CE
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 18 Jul 2004 04:40:58 +0000 (GMT)
Received: from wonkity.com (wonkity.com [65.173.111.5])
	by mx1.FreeBSD.org (Postfix) with ESMTP id A4D7243D41
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 18 Jul 2004 04:40:57 +0000 (GMT)
	(envelope-from wblock@wonkity.com)
Received: from speedy.wonkity.com (speedy [10.0.0.7])
	by wonkity.com (8.12.11/8.12.11) with ESMTP id i6I4evIu019429
	for <FreeBSD-gnats-submit@freebsd.org>; Sat, 17 Jul 2004 22:40:57 -0600 (MDT)
	(envelope-from wblock@speedy.wonkity.com)
Received: from speedy.wonkity.com (speedy.wonkity.com [127.0.0.1])
	by speedy.wonkity.com (8.12.11/8.12.11) with ESMTP id i6I4evuj057290
	for <FreeBSD-gnats-submit@freebsd.org>; Sat, 17 Jul 2004 22:40:57 -0600 (MDT)
	(envelope-from wblock@speedy.wonkity.com)
Received: (from wblock@localhost)
	by speedy.wonkity.com (8.12.11/8.12.11/Submit) id i6I4evCo057289;
	Sat, 17 Jul 2004 22:40:57 -0600 (MDT)
	(envelope-from wblock)
Message-Id: <200407180440.i6I4evCo057289@speedy.wonkity.com>
Date: Sat, 17 Jul 2004 22:40:57 -0600 (MDT)
From: Warren Block <wblock@wonkity.com>
Reply-To: Warren Block <wblock@wonkity.com>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: PATCH-Serial comms chapter has wrong acronym for Transmit Data
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         69225
>Category:       docs
>Synopsis:       PATCH-Serial comms chapter has wrong acronym for Transmit Data
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Jul 18 04:50:25 GMT 2004
>Closed-Date:    Mon Jul 19 13:32:33 GMT 2004
>Last-Modified:  Mon Jul 19 13:40:14 GMT 2004
>Originator:     Warren Block
>Release:        FreeBSD 4.10-STABLE i386
>Organization:
>Environment:
System: FreeBSD speedy 4.10-STABLE FreeBSD 4.10-STABLE #0: Thu May 27 20:32:57 MDT 2004 root@speedy:/usr/obj/usr/src/sys/SPEEDY i386


	
>Description:
Serial comms chapter acronym for serial transmit data line is wrong, fix for tenses.

>How-To-Repeat:
Search for <acronym>SD in the serial comms chapter.

>Fix:

Apply this patch:

--- /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>
 	  
 	  <listitem>
-	    <para>Received Data (<acronym>RD</acronym>)</para>
+	    <para>Receive Data (<acronym>RD</acronym>)</para>
 	  </listitem>
 	  
 	  <listitem>

>Release-Note:
>Audit-Trail:

From: Giorgos Keramidas <keramida@ceid.upatras.gr>
To: Warren Block <wblock@wonkity.com>
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:53:35 +0300

 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?
 
 - Giorgos
 

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

From: Giorgos Keramidas <keramida@FreeBSD.org>
To: Marc Fonvieille <blackend@FreeBSD.org>
Cc: bug-followup@FreeBSD.org
Subject: Re: docs/69225: PATCH-Serial comms chapter has wrong acronym for Transmit Data
Date: Sun, 18 Jul 2004 16:04:53 +0300

 On 2004-07-18 14:54, Marc Fonvieille <blackend@FreeBSD.org> wrote:
 > [snip]
 > So I'd keep the description but I'd s/SD/TD which is correct.
 
 Cool!  Thanks for the explanation too, I didn't read the original text
 very carefully and this was much needed.
 
 Go for it :)
 
State-Changed-From-To: open->closed 
State-Changed-By: blackend 
State-Changed-When: Mon Jul 19 13:30:04 GMT 2004 
State-Changed-Why:  
I s/SD/TD and s/TxD/TD s/RxD/RD for consistency. 
I kept the line description with the "ed" since it's the one used in the 
UTI V24 recommendation.  Thanks. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=69225 

From: Marc Fonvieille <blackend@FreeBSD.org>
To: bug-followup@FreeBSD.org
Cc: freebsd-doc@FreeBSD.org
Subject: Re: docs/69225: PATCH-Serial comms chapter has wrong acronym for Transmit Data
Date: Mon, 19 Jul 2004 15:38:05 +0200

 On Mon, Jul 19, 2004 at 01:32:32PM +0000, Marc Fonvieille wrote:
 > Synopsis: PATCH-Serial comms chapter has wrong acronym for Transmit Data
 > 
 > State-Changed-From-To: open->closed
 > State-Changed-By: blackend
 > State-Changed-When: Mon Jul 19 13:30:04 GMT 2004
 > State-Changed-Why: 
 > I s/SD/TD and s/TxD/TD s/RxD/RD for consistency.
 > I kept the line description with the "ed" since it's the one used in the
 > UTI V24 recommendation.  Thanks.
 >
 
 grr I meant ITU (International Telecommunication Union).
>Unformatted:
