From owner-freebsd-net@FreeBSD.ORG  Thu May 31 17:16:02 2012
Return-Path: <owner-freebsd-net@FreeBSD.ORG>
Delivered-To: freebsd-net@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 2CE9C1065670;
	Thu, 31 May 2012 17:16:02 +0000 (UTC)
	(envelope-from seanbru@yahoo-inc.com)
Received: from mrout1-b.corp.bf1.yahoo.com (mrout1-b.corp.bf1.yahoo.com
	[98.139.253.104])
	by mx1.freebsd.org (Postfix) with ESMTP id CD9818FC0C;
	Thu, 31 May 2012 17:16:01 +0000 (UTC)
Received: from [IPv6:::1] (rideseveral.corp.yahoo.com [10.73.160.231])
	by mrout1-b.corp.bf1.yahoo.com (8.14.4/8.14.4/y.out) with ESMTP id
	q4VHFbLG006574; Thu, 31 May 2012 10:15:38 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=yahoo-inc.com;
	s=cobra; t=1338484539;
	bh=bsD8JsT/BP/+fD2W7Ajn2j1DJxxFAv73mXmyfmD5MZc=;
	h=Subject:From:To:Cc:In-Reply-To:References:Content-Type:Date:
	Message-ID:Mime-Version:Content-Transfer-Encoding;
	b=o2X/Pv6QaZrX1LrUjDeqZXVfwuLQK+dsLeDSKX6jypi4x9z5V2ggtvPyagQYxtVM0
	BrZblcj+tQ+sKTUn756qFO6DKL+6WOu7bYZwogkpjsXQvsM3kbV9nv0qvK206SLphn
	Wozqt+Ep16NW9NTiARwFaLHkEE+pxpu1mT87tNV8=
From: Sean Bruno <seanbru@yahoo-inc.com>
To: Warren Block <wblock@wonkity.com>
In-Reply-To: <alpine.BSF.2.00.1205310628200.81499@wonkity.com>
References: <1338424909.9051.12.camel@powernoodle-l7.corp.yahoo.com>
	<alpine.BSF.2.00.1205310628200.81499@wonkity.com>
Content-Type: text/plain; charset="UTF-8"
Date: Thu, 31 May 2012 10:15:37 -0700
Message-ID: <1338484537.2985.8.camel@powernoodle-l7.corp.yahoo.com>
Mime-Version: 1.0
X-Mailer: Evolution 2.32.1 FreeBSD GNOME Team Port 
Content-Transfer-Encoding: 7bit
X-Milter-Version: master.31+4-gbc07cd5+
X-CLX-ID: 484538000
Cc: "freebsd-net@freebsd.org" <freebsd-net@freebsd.org>
Subject: Re: bce(4) man page updates
X-BeenThere: freebsd-net@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Networking and TCP/IP with FreeBSD <freebsd-net.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-net>,
	<mailto:freebsd-net-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-net>
List-Post: <mailto:freebsd-net@freebsd.org>
List-Help: <mailto:freebsd-net-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-net>,
	<mailto:freebsd-net-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 31 May 2012 17:16:02 -0000

On Thu, 2012-05-31 at 05:46 -0700, Warren Block wrote:
> On Wed, 30 May 2012, Sean Bruno wrote:
> 
> > Was trolling around inside of bce(4) and the Broadcom docs today and
> > made the following update to the man page.  Thoughts?
> >
> > Sean
> >
> > http://people.freebsd.org/~sbruno/bce_man.txt
> 
> Nice!
> 
> Just minor suggestions.
> 
> The two "whether or not" sentences ought to be just "Enable/Disable ..." 
> like the rest.
> 
> A couple of "Cannot be assigned the value 0" sentences can be simpler as 
> "Cannot be set to 0" if that doesn't change the meaning.
> 
> "Valid values are in the range from 0-256." can be simpler as
> "Values from 0-256 are valid."
> 
> Many "The default value is" which could be simplified to "The default 
> is", or added to the end of a previous sentence as an aside:
> "Values from 0-100 are valid (default 18)."


Indeed.  Much more gooder wordingness.  Updated!

http://people.freebsd.org/~sbruno/bce_man.txt

Sean