From owner-freebsd-bugs  Sun Aug 10 02:00:12 1997
Return-Path: <owner-freebsd-bugs>
Received: (from root@localhost)
          by hub.freebsd.org (8.8.5/8.8.5) id CAA11657
          for bugs-outgoing; Sun, 10 Aug 1997 02:00:12 -0700 (PDT)
Received: (from gnats@localhost)
          by hub.freebsd.org (8.8.5/8.8.5) id CAA11640;
          Sun, 10 Aug 1997 02:00:09 -0700 (PDT)
Resent-Date: Sun, 10 Aug 1997 02:00:09 -0700 (PDT)
Resent-Message-Id: <199708100900.CAA11640@hub.freebsd.org>
Resent-From: gnats (GNATS Management)
Resent-To: freebsd-bugs
Resent-Reply-To: FreeBSD-gnats@FreeBSD.ORG, doogie@anet-stl.com
Received: from forbidden-donut.anet-stl.com (forbidden-donut.anet-stl.com [206.114.203.17])
          by hub.freebsd.org (8.8.5/8.8.5) with ESMTP id BAA11277
          for <FreeBSD-gnats-submit@freebsd.org>; Sun, 10 Aug 1997 01:55:29 -0700 (PDT)
Received: (from doogie@localhost)
	by forbidden-donut.anet-stl.com (8.8.7/8.8.5) id DAA26899;
	Sun, 10 Aug 1997 03:52:45 GMT
Message-Id: <199708100352.DAA26899@forbidden-donut.anet-stl.com>
Date: Sun, 10 Aug 1997 03:52:45 GMT
From: doogie@anet-stl.com
Reply-To: doogie@anet-stl.com
To: FreeBSD-gnats-submit@FreeBSD.ORG
X-Send-Pr-Version: 3.2
Subject: docs/4261: quotactl manpage is misleading; correct bad references
Sender: owner-freebsd-bugs@FreeBSD.ORG
X-Loop: FreeBSD.org
Precedence: bulk


>Number:         4261
>Category:       docs
>Synopsis:       quotactl manpage is misleading; correct bad references
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-bugs
>State:          open
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Aug 10 02:00:08 PDT 1997
>Last-Modified:
>Originator:     doogie@anet-stl.com
>Organization:
ANET St. Louis
>Release:        FreeBSD 3.0-CURRENT i386
>Environment:

     The quotactl() function call appeared in 4.3BSD-Reno.

>Description:

The quotactl manpage is misleading about what to supply for a second
argument. It lists several possible arguments but mentions only very
vaguely that these may need to be combined using the QCMD macro in
/usr/include/ufs/ufs/quota.h, with USRQUOTA or GRPQUOTA.

Also it references <ufs/quota.h> in a few places, when it should mention
<ufs/ufs/quota.h>. 

>How-To-Repeat:

Try to code something using quotactl based on the manpage. Ugh. 

>Fix:
	
Include something like this on the manpage: 

"The Q_GETQUOTA, Q_SETQUOTA and Q_SETUSE commands must be used in
conjunction with the QCMD macro and the definitions USRQUOTA and GRPQUOTA
(defined in <ufs/ufs/quota.h>) to specify operations involving user and
group quotas, respectively. See ufs/ufs/quota.h for details. 

>Audit-Trail:
>Unformatted: