From owner-cvs-all  Mon Aug  6  5:17:53 2001
Delivered-To: cvs-all@freebsd.org
Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP
	id F0D7D37B403; Mon,  6 Aug 2001 05:17:47 -0700 (PDT)
	(envelope-from murray@FreeBSD.org)
Received: (from murray@localhost)
	by freefall.freebsd.org (8.11.4/8.11.4) id f76CHl104150;
	Mon, 6 Aug 2001 05:17:47 -0700 (PDT)
	(envelope-from murray)
Message-Id: <200108061217.f76CHl104150@freefall.freebsd.org>
From: Murray Stokely <murray@FreeBSD.org>
Date: Mon, 6 Aug 2001 05:17:47 -0700 (PDT)
To: cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org
Subject: cvs commit: doc/en_US.ISO8859-1/books/handbook/serialcomms chapter.sgml
X-FreeBSD-CVS-Branch: HEAD
Sender: owner-cvs-all@FreeBSD.ORG
Precedence: bulk
List-ID: <cvs-all.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20cvs-all>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20cvs-all>
X-Loop: FreeBSD.ORG

murray      2001/08/06 05:17:47 PDT

  Modified files:
    en_US.ISO8859-1/books/handbook/serialcomms chapter.sgml 
  Log:
  First step of a major overhaul of this chapter.  Split into multiple
  commits to make it slightly easier on the translation teams.
  
    * Add a standard synopsis
    * Remove references to FreeBSD 1.1.5.1 and FreeBSD 1.1.  Document
      the behavior of 4.x / 5.x and ignore the paleontology.
    * Move <indexterm>s around so that printed output looks better.
    * Reference other chapters in the Handbook instead of duplicating
      information.
    * Rephrase many sentences to be more concise.
    * <filename> -> <command>
    * Refer to the text as "this chapter" instead of "this document"
    * Refer to manual pages consistently.
    * Turns a couple of question and answer entries into more formal
      paragraphs.
    * Don't intersperse example commands inside paragraphs as often.
      Instead, talk about something and then provide an example.
    * Mark up contributors in <sectNinfo>.
    * Remove synopsis-like information from one of the individual
      sections, since this has been expanded at the front of the
      chapter.
    * Mark up keys in <keycode>
    * Remove acknowledgments section.  This is inappropriate for a book
      chapter and the acknowledged person has been moved to the
      <sectNinfo> as an additional contributor.
    * Remove "information integrated from FAQ", that describes much of
      our documentation.
    * Remove troubleshooting entry about needing to be in a specific
      group to run tip or cu, since this is no longer the case.
  
  PR:		19481
  
  Revision  Changes    Path
  1.35      +140 -249  doc/en_US.ISO8859-1/books/handbook/serialcomms/chapter.sgml


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe cvs-all" in the body of the message