From owner-freebsd-fs@FreeBSD.ORG Tue Jul 12 10:50:14 2011 Return-Path: Delivered-To: freebsd-fs@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 3E17F106566B for ; Tue, 12 Jul 2011 10:50:14 +0000 (UTC) (envelope-from brde@optusnet.com.au) Received: from mail01.syd.optusnet.com.au (mail01.syd.optusnet.com.au [211.29.132.182]) by mx1.freebsd.org (Postfix) with ESMTP id CBD1A8FC17 for ; Tue, 12 Jul 2011 10:50:13 +0000 (UTC) Received: from c122-106-165-191.carlnfd1.nsw.optusnet.com.au (c122-106-165-191.carlnfd1.nsw.optusnet.com.au [122.106.165.191]) by mail01.syd.optusnet.com.au (8.13.1/8.13.1) with ESMTP id p6CAo97D010546 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Tue, 12 Jul 2011 20:50:10 +1000 Date: Tue, 12 Jul 2011 20:50:09 +1000 (EST) From: Bruce Evans X-X-Sender: bde@besplex.bde.org To: Benjamin Kaduk In-Reply-To: Message-ID: <20110712202759.H1311@besplex.bde.org> References: <10589627.445480.1310418556785.JavaMail.root@erie.cs.uoguelph.ca> MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed Cc: FreeBSD FS Subject: Re: request for review of exports.5 update X-BeenThere: freebsd-fs@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Filesystems List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 12 Jul 2011 10:50:14 -0000 On Mon, 11 Jul 2011, Benjamin Kaduk wrote: > Hi Rick, > > On Mon, 11 Jul 2011, Rick Macklem wrote: > >> Hi, >> >> I've added a few sentences to the exports.5 man page in an effort >> to try and clarify how NFSv4 exports work. >> >> If anyone would like to comment on these changes, it would be >> appreciated. Ideally, you are familiar with the FreeBSD /etc/exports >> file, but not w.r.t. NFSv4. >> ... > >> +.Xr mountd 8 >> +daemon and not the kernel. >> +As such, it only applies to NFSv2, NFSv3 mounts and only w.r.t. the > > The comma between v2 and v3 is not really right and should be replaced by > "and"; the mdoc gurus seem to want to put the trailing "the" on the next > line in a case like this. Also, there is a rule against contractions (e.g., "it's"), so there is presumably a rule against nonstandard abbreviations (e.g., "w.r.t."). Currently, "w.r.t" is only used once, in 1 man page, and was presumably written there by Rick :-) (mount_nfs.8 and the link to it). This use shows an apparent syntactical complication related to "the" in the above -- it also has "the" on the same line, but for some reason it has "\&" after "w.r.t.". The briefer and even more informal abbreviation "wrt" is not used in any man page. But "with respect to" is used 2445 times (but many are duplicates due to links). BTW, does anyone know a good way of not seeing duplicates in commands like "zgrep -r wrt /usr/share/man"? find(1) doesn't seem to have any flag to suppress duplicates. du(1) has to know how to not count duplicates internally. I think it as special code for this and there is no special support for this in fts(3). Recently I have been annoyed by duplicates under .svn. I want to type a simple grep -r or "find . | xargs grep" without any complicated pattern for the file names and not see multiple copies. Bruce