Subject: Re: library man pages
To: Perry E. Metzger <perry@piermont.com>
From: Jason Thorpe <thorpej@nas.nasa.gov>
List: tech-userlevel
Date: 01/10/1998 10:38:16
On Sat, 10 Jan 1998 13:16:32 -0500 
 "Perry E. Metzger" <perry@piermont.com> wrote:

 > I believe we should fix the man pages to indicate what library every
 > documented function is in. (We might as well do libc functions, too,
 > for completeness.)

 > NAME
 >      pw_lock - passwd file update function
 > 
 > SYNOPSIS
 >      #include <util.h>
 > 
 >      int
 >      pw_lock(int retries);

...why not put this in the SYNOPSIS section, along with the include file
that exports the interface?

I'd also suggest mentioning the library ONLY if it is not in libc (i.e.
would not be pulled in by "cc" by default).

Jason R. Thorpe                                       thorpej@nas.nasa.gov
NASA Ames Research Center                            Home: +1 408 866 1912
NAS: M/S 258-6                                       Work: +1 650 604 0935
Moffett Field, CA 94035                             Pager: +1 415 428 6939