From owner-freebsd-doc@FreeBSD.ORG  Mon Dec 24 22:08:11 2012
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52])
 by hub.freebsd.org (Postfix) with ESMTP id 8F77B1EA
 for <freebsd-doc@freebsd.org>; Mon, 24 Dec 2012 22:08:11 +0000 (UTC)
 (envelope-from bjk@freebsd.org)
Received: from freefall.freebsd.org (freefall.freebsd.org
 [IPv6:2001:1900:2254:206c::16:87])
 by mx1.freebsd.org (Postfix) with ESMTP id 708AB8FC12
 for <freebsd-doc@freebsd.org>; Mon, 24 Dec 2012 22:08:11 +0000 (UTC)
Received: from freefall.freebsd.org (localhost [127.0.0.1])
 by freefall.freebsd.org (8.14.5/8.14.5) with ESMTP id qBOM8Bis095494
 for <freebsd-doc@freebsd.org>; Mon, 24 Dec 2012 22:08:11 GMT
 (envelope-from bjk@freebsd.org)
Received: from localhost (bjk@localhost)
 by freefall.freebsd.org (8.14.5/8.14.5/Submit) with ESMTP id qBOM8Bb1095491
 for <freebsd-doc@freebsd.org>; Mon, 24 Dec 2012 22:08:11 GMT
 (envelope-from bjk@freebsd.org)
X-Authentication-Warning: freefall.freebsd.org: bjk owned process doing -bs
Date: Mon, 24 Dec 2012 22:08:11 +0000 (UTC)
From: Benjamin Kaduk <bjk@freebsd.org>
To: freebsd-doc@freebsd.org
Subject: confusing sentence in hardware notes boilerplate
Message-ID: <alpine.BSF.2.00.1212242202380.95209@freefall.freebsd.org>
User-Agent: Alpine 2.00 (BSF 1167 2008-08-23)
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/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: Mon, 24 Dec 2012 22:08:11 -0000

I was going over the various release notes documents to do some editing, 
and spent entirely too much time trying to understand a sentence at the 
top of the hardware notes, which has been there since r172098 by bmah in 
2007.  I think that adding a word per below helps the readability, but I 
am no longer an impartial reader (having read the sentence too much).
Thoughts?

-Ben

Index: article.xml
===================================================================
--- article.xml	(revision 244663)
+++ article.xml	(working copy)
@@ -53,7 +53,7 @@
      <para>This document contains the hardware compatibility notes for
        &os; &release.current;.  It lists the hardware platforms
        supported by &os;, as well as the various types of hardware
-      devices (storage controllers, network interfaces, and so on),
+      devices supported (storage controllers, network interfaces, and so on),
        along with known working instances of these devices.</para>
    </sect1>