From owner-freebsd-doc Wed May 8 3:30:10 2002 Delivered-To: freebsd-doc@hub.freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21]) by hub.freebsd.org (Postfix) with ESMTP id 8B44337B407 for ; Wed, 8 May 2002 03:30:03 -0700 (PDT) Received: (from gnats@localhost) by freefall.freebsd.org (8.11.6/8.11.6) id g48AU3k69254; Wed, 8 May 2002 03:30:03 -0700 (PDT) (envelope-from gnats) Date: Wed, 8 May 2002 03:30:03 -0700 (PDT) Message-Id: <200205081030.g48AU3k69254@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org Cc: From: Peter Pentchev Subject: Re: docs/37839: Improve man page for quotactl(2) Reply-To: Peter Pentchev Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org The following reply was made to PR docs/37839; it has been noted by GNATS. From: Peter Pentchev To: "Michael R. Wayne" Cc: bug-followup@FreeBSD.org Subject: Re: docs/37839: Improve man page for quotactl(2) Date: Wed, 8 May 2002 13:21:04 +0300 On Tue, May 07, 2002 at 10:46:20AM -0700, Michael R. Wayne wrote: > > >Number: 37839 > >Category: docs > >Synopsis: Improve man page for quotactl(2) > >Originator: Michael R. Wayne > >Description: > The documentation for quotactl is not specific enough to avoid confusion. > This became clear when quotas inadvertently became disabled on a filesystem > and quotactl failed with EINVAL. Several people on -hackers had speculations, > none were accurate. > The current man page states > Cmd or the command type is invalid > But this does not accurately reflect the code. > >How-To-Repeat: > See above. > >Fix: > Apply the following 1 line patch: > > *** /usr/src/lib/libc/sysquotactl.2.ORIG Tue May 7 13:41:19 2002 > --- /usr/src/lib/libc/sysquotactl.2 Tue May 7 13:41:39 2002 > *************** > *** 166,171 **** > --- 166,172 ---- > .It Bq Er EINVAL > .Fa Cmd > or the command type is invalid. > + Q_GETQUOTA returns EINVAL if quotas are not currently enabled for this filesystem. > .It Bq Er EACCES > In > .Dv Q_QUOTAON , How about the attached little improvement to the mark-up? Other than that, your wording sounds right to me. G'luck, Peter -- Peter Pentchev roam@ringlet.net roam@FreeBSD.org PGP key: http://people.FreeBSD.org/~roam/roam.key.asc Key fingerprint FDBA FD79 C26F 3C51 C95E DF9E ED18 B68D 1619 4553 The rest of this sentence is written in Thailand, on Index: src/lib/libc/sys/quotactl.2 =================================================================== RCS file: /home/ncvs/src/lib/libc/sys/quotactl.2,v retrieving revision 1.17 diff -u -r1.17 quotactl.2 --- src/lib/libc/sys/quotactl.2 1 Oct 2001 16:09:02 -0000 1.17 +++ src/lib/libc/sys/quotactl.2 8 May 2002 10:17:23 -0000 @@ -166,6 +166,10 @@ .It Bq Er EINVAL .Fa Cmd or the command type is invalid. +.Dv Q_GETQUOTA +returns +.Er EINVAL +if quotas are not currently enabled for this filesystem. .It Bq Er EACCES In .Dv Q_QUOTAON , To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message