"Chris G. Demetriou" writes:
> quick example from Digital UNIX (not necessarily 'right', but another
> system, and one which documents the libraries that things are in):

I personally like the look of this "and it is has a precedent".

.pm

> getpwent(3)                                                       getpwent(3)
> 
> NAME
> 
>   endpwent, fgetpwent, getpwent, getpwnam, getpwuid, putpwent, setpwent,
>   setpwfile, endpwent_r, fgetpwent_r, getpwent_r, getpwnam_r, getpwuid_r,
>   setpwent_r - Access user attribute information in the user database
> 
> LIBRARY
> 
>   Standard C Library (libc.so, libc.a)
> 
> SYNOPSIS
> 
>   #include <pwd.h>
> 
>   void endpwent(void);
> 
> [ ... ]
> 
> 
> 
> 
> "It's a thought."
> 
> 
> 
> cgd