From owner-freebsd-doc@FreeBSD.ORG  Tue May 27 03:55:24 2014
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org
 [IPv6:2001:1900:2254:206a::19:1])
 (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits))
 (No client certificate requested)
 by hub.freebsd.org (Postfix) with ESMTPS id B014ED1F
 for <freebsd-doc@freebsd.org>; Tue, 27 May 2014 03:55:24 +0000 (UTC)
Received: from wonkity.com (wonkity.com [67.158.26.137])
 (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
 (Client CN "wonkity.com", Issuer "wonkity.com" (not verified))
 by mx1.freebsd.org (Postfix) with ESMTPS id 5C1902919
 for <freebsd-doc@freebsd.org>; Tue, 27 May 2014 03:55:24 +0000 (UTC)
Received: from wonkity.com (localhost [127.0.0.1])
 by wonkity.com (8.14.8/8.14.8) with ESMTP id s4R3tMZK089404
 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=NO);
 Mon, 26 May 2014 21:55:22 -0600 (MDT)
 (envelope-from wblock@wonkity.com)
Received: from localhost (wblock@localhost)
 by wonkity.com (8.14.8/8.14.8/Submit) with ESMTP id s4R3tMB5089401;
 Mon, 26 May 2014 21:55:22 -0600 (MDT)
 (envelope-from wblock@wonkity.com)
Date: Mon, 26 May 2014 21:55:22 -0600 (MDT)
From: Warren Block <wblock@wonkity.com>
To: Ryan Stone <rysto32@gmail.com>
Subject: Re: SR-IOV Patch Series 3/7: manual pages
In-Reply-To: <CAFMmRNw39DLx=uyDUm1GkGYG0+n6EA0t9R0eKNjYNRFFna243g@mail.gmail.com>
Message-ID: <alpine.BSF.2.00.1405262146320.89362@wonkity.com>
References: <CAFMmRNw39DLx=uyDUm1GkGYG0+n6EA0t9R0eKNjYNRFFna243g@mail.gmail.com>
User-Agent: Alpine 2.00 (BSF 1167 2008-08-23)
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII
X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3
 (wonkity.com [127.0.0.1]); Mon, 26 May 2014 21:55:23 -0600 (MDT)
Cc: freebsd-doc@freebsd.org
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.18
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: Tue, 27 May 2014 03:55:24 -0000

For iovctl.8, I see is the use of "your".  We try to avoid using "you" 
and "your", which is an informal style:
http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/book.html#writing-style-tips

   See the manual page for your PF driver for documentation of
   configuration parameters that are specific to your hardware.

"Documentation of" is redundant, too, so:

   See the PF driver manual page for configuration parameters specific to
   particular hardware.

(I have not really looked at the markup.  The cross reference (.Xr) to 
iovctl.conf seems correct but rendered as plain text here.  Maybe a 
local thing.)