From owner-svn-src-all@FreeBSD.ORG  Sat Jun 13 01:49:46 2009
Return-Path: <owner-svn-src-all@FreeBSD.ORG>
Delivered-To: svn-src-all@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 52230106568A;
	Sat, 13 Jun 2009 01:49:46 +0000 (UTC)
	(envelope-from brde@optusnet.com.au)
Received: from mail03.syd.optusnet.com.au (mail03.syd.optusnet.com.au
	[211.29.132.184])
	by mx1.freebsd.org (Postfix) with ESMTP id C6CAB8FC1F;
	Sat, 13 Jun 2009 01:49:45 +0000 (UTC)
	(envelope-from brde@optusnet.com.au)
Received: from c122-106-159-184.carlnfd1.nsw.optusnet.com.au
	(c122-106-159-184.carlnfd1.nsw.optusnet.com.au [122.106.159.184])
	by mail03.syd.optusnet.com.au (8.13.1/8.13.1) with ESMTP id
	n5D1ngHr025694
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO);
	Sat, 13 Jun 2009 11:49:44 +1000
Date: Sat, 13 Jun 2009 11:49:42 +1000 (EST)
From: Bruce Evans <brde@optusnet.com.au>
X-X-Sender: bde@delplex.bde.org
To: John Baldwin <jhb@freebsd.org>
In-Reply-To: <200906121813.n5CIDY1c089109@svn.freebsd.org>
Message-ID: <20090613113554.E22985@delplex.bde.org>
References: <200906121813.n5CIDY1c089109@svn.freebsd.org>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed
Cc: svn-src-head@freebsd.org, svn-src-all@freebsd.org,
	src-committers@freebsd.org
Subject: Re: svn commit: r194071 - head/lib/libutil
X-BeenThere: svn-src-all@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: "SVN commit messages for the entire src tree \(except for &quot;
	user&quot; and &quot; projects&quot; \)" <svn-src-all.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/svn-src-all>,
	<mailto:svn-src-all-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/svn-src-all>
List-Post: <mailto:svn-src-all@freebsd.org>
List-Help: <mailto:svn-src-all-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/svn-src-all>,
	<mailto:svn-src-all-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sat, 13 Jun 2009 01:49:46 -0000

On Fri, 12 Jun 2009, John Baldwin wrote:

> Log:
>  - Note that these interfaces require <sys/user.h> for the structure
>    definitions.

This should be noted somewhere other than in the synopsis.  Struct
definitions may or may not be needed for using a function, but one
place where they are certainly not needed is for calling a function
(unless the API involves complete structs or the public header is
missing a forward declaration).

Bruce