From owner-freebsd-doc@FreeBSD.ORG  Wed Nov 17 22:27:32 2004
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@freebsd.org
Received: by hub.freebsd.org (Postfix, from userid 815)
	id 5675416A4D0; Wed, 17 Nov 2004 22:27:32 +0000 (GMT)
Date: Wed, 17 Nov 2004 22:27:32 +0000
From: Murray Stokely <murray@freebsd.org>
To: Joel Dahl <joel@automatvapen.se>
Message-ID: <20041117222732.GA96501@hub.freebsd.org>
References: <200408201640.i7KGePeA034000@freefall.freebsd.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <200408201640.i7KGePeA034000@freefall.freebsd.org>
User-Agent: Mutt/1.4.1i
X-GPG-Key-ID: 1024D/0E451F7D
X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B  3CB5 B4D7 10A2 0E45 1F7D
cc: freebsd-doc@FreeBSD.org
Subject: Re: docs/70583: [PATCH] Update freebsd-glossary
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.1
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: Wed, 17 Nov 2004 22:27:32 -0000

Hi Joel, thanks for the submissions.  I've noticed that many of your
submissions don't use a serial comma so they stick out when compared
with the rest of our documentation set.

Please see :
http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/writing-style.html#WRITING-STYLE-GUIDE

>         <glossterm>Unix File System Version 2</glossterm>
>         <acronym>UFS2</acronym>
>         <glossdef>
>  -        <para></para>
>  +        <para>An extension to <acronym>UFS1</acronym>, introduced in
>  +	  &os; 5-CURRENT. <acronym>UFS2</acronym> adds 64 bit block
>  +	  pointers (breaking the 1T barrier), support for extended file
>  +	  storage, and a few other things.

extended file attributes, and other enhancements. ?


>  +	  </para>
>         </glossdef>
>     </glossdiv>
>  @@ -1762,7 +1775,10 @@
>         <glossterm>Virtual Private Network</glossterm>
>         <acronym>VPN</acronym>
>         <glossdef>
>  -        <para></para>
>  +        <para>A way to use a public telecommunication
>  +	  infrastructure, such as the Internet, to provide remote
>  +	  users with a secure connection to their organizations

organization's ?

Murray