From owner-cvs-src@FreeBSD.ORG Thu Jun 1 16:50:52 2006 Return-Path: X-Original-To: cvs-src@freebsd.org Delivered-To: cvs-src@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 5ECC216A4EB; Thu, 1 Jun 2006 16:50:52 +0000 (UTC) (envelope-from bde@zeta.org.au) Received: from mailout1.pacific.net.au (mailout1.pacific.net.au [61.8.0.84]) by mx1.FreeBSD.org (Postfix) with ESMTP id 5AD8843D4C; Thu, 1 Jun 2006 16:50:51 +0000 (GMT) (envelope-from bde@zeta.org.au) Received: from mailproxy1.pacific.net.au (mailproxy1.pacific.net.au [61.8.0.86]) by mailout1.pacific.net.au (Postfix) with ESMTP id 24A21527C92; Fri, 2 Jun 2006 02:50:50 +1000 (EST) Received: from katana.zip.com.au (katana.zip.com.au [61.8.7.246]) by mailproxy1.pacific.net.au (8.13.4/8.13.4/Debian-3sarge1) with ESMTP id k51GolYG025799; Fri, 2 Jun 2006 02:50:48 +1000 Date: Fri, 2 Jun 2006 02:50:47 +1000 (EST) From: Bruce Evans X-X-Sender: bde@delplex.bde.org To: John Baldwin In-Reply-To: <200606010858.39417.jhb@freebsd.org> Message-ID: <20060602023102.J34761@delplex.bde.org> References: <200605311315.k4VDFUhD093628@repoman.freebsd.org> <20060601094950.GU21998@submonkey.net> <20060601100126.GA43737@FreeBSD.org> <200606010858.39417.jhb@freebsd.org> MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed Cc: Maxim Konovalov , Alexey Dokuchaev , src-committers@freebsd.org, cvs-src@freebsd.org, cvs-all@freebsd.org, Greg 'groggy' Lehey , Ceri Davies Subject: Re: cvs commit: src/sys/ufs/ufs ufs_vnops.c X-BeenThere: cvs-src@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: CVS commit messages for the src tree List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 01 Jun 2006 16:51:07 -0000 On Thu, 1 Jun 2006, John Baldwin wrote: > On Thursday 01 June 2006 06:01, Alexey Dokuchaev wrote: >> On Thu, Jun 01, 2006 at 10:49:50AM +0100, Ceri Davies wrote: >>> @@ -69,6 +69,10 @@ >>> the file must be open for writing. >>> .Sh RETURN VALUES >>> .Rv -std >>> +If the file to be modified is not a directory or >>> +a regular file, the >>> +.Fn truncate >>> +call will return the value 0. >> >> Doesn't "value of 0" sound better? > > Not to me, though I can't explain why. I think the phrase "X will return the > value Y" is common in man pages though. "will return" sounds strange to be. Normal is "Upon successful completion, the value 0 is returned...". This is part of what ".Rv -std" expands to. POSIX says "Upon successful completion, ftruncate( ) shall return 0...". The POSIX wording is better. "the value 0" says nothing more than "0", and "returns" is clearer than "is returned". Saying "the value 0" is apparently a hack to give the clause a subject (or is it an object? -- I think the value is the object convoluted to a subject or vice versa). FreeBSD has a deshallify.sh script to adjust the POSIX wording. It does s/shall return/returns/. Bruce