[src/trunk]: src/lib/libutil Remove the list of functions in the libutil libr...

[jruoho <jruoho%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/9d42f9c4d38a
branches:  trunk
changeset: 754565:9d42f9c4d38a
user:      jruoho <jruoho%NetBSD.org@localhost>
date:      Tue May 04 07:07:12 2010 +0000

description:
Remove the list of functions in the libutil library.

While such lists are nice, they are doomed to be repeatedly out of date due
maintenance costs related to manual updates. Ideally there should be a
common routine to auto-generate these, but in the meantime, just point to
the directory where libutil is implemented.

diffstat:

 lib/libutil/util.3 |  67 ++++++++---------------------------------------------
 1 files changed, 11 insertions(+), 56 deletions(-)

diffs (93 lines):

diff -r 16ca4b9ed927 -r 9d42f9c4d38a lib/libutil/util.3
--- a/lib/libutil/util.3        Tue May 04 06:53:35 2010 +0000
+++ b/lib/libutil/util.3        Tue May 04 07:07:12 2010 +0000
@@ -1,4 +1,4 @@
-.\"     $NetBSD: util.3,v 1.19 2009/04/11 17:26:32 joerg Exp $
+.\"     $NetBSD: util.3,v 1.20 2010/05/04 07:07:12 jruoho Exp $
 .\"
 .\" Copyright (c) 2001 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd November 17, 2008
+.Dd May 4, 2010
 .Dt UTIL 3
 .Os
 .Sh NAME
@@ -46,60 +46,14 @@
 .Nx Ns -specific
 and are not portable.
 Their use should be restricted.
+.Pp
 Declarations for these functions may be obtained from the include file
-.Pa \*[Lt]util.h\*[Gt] .
-.Sh LIST OF FUNCTIONS
-.Bl -column ".Xr sockaddr_snprintf 3" -compact
-.It Sy Name    Description
-.It Xr disklabel_dkcksum 3 Ta compute the checksum for a disklabel
-.It Xr disklabel_scan 3 Ta scan a buffer for a valid disklabel
-.It Xr forkpty 3 Ta tty utility function
-.It Xr getbootfile 3 Ta get the name of the booted kernel file
-.It Xr getlabeloffset 3 Ta get the sector number and offset of the disklabel
-.It Xr getlabelsector 3 Ta get the sector number and offset of the disklabel
-.It Xr getmaxpartitions 3 Ta get the maximum number of partitions allowed per disk
-.It Xr getrawpartition 3 Ta get the system ``raw'' partition
-.It Xr login 3 Ta login utility function
-.It Xr login_cap 3 Ta query login.conf database about a user class
-.It Xr login_close 3 Ta query login.conf database about a user class
-.It Xr login_getcapbool 3 Ta query login.conf database about a user class
-.It Xr login_getcapnum 3 Ta query login.conf database about a user class
-.It Xr login_getcapsize 3 Ta query login.conf database about a user class
-.It Xr login_getcapstr 3 Ta query login.conf database about a user class
-.It Xr login_getcaptime 3 Ta query login.conf database about a user class
-.It Xr login_getclass 3 Ta query login.conf database about a user class
-.It Xr login_tty 3 Ta tty utility function
-.It Xr loginx 3 Ta login utility function
-.It Xr logout 3 Ta login utility function
-.It Xr logoutx 3 Ta login utility function
-.It Xr logwtmp 3 Ta login utility function
-.It Xr logwtmpx 3 Ta login utility function
-.It Xr opendisk 3 Ta open a disk partition
-.It Xr openpty 3 Ta tty utility function
-.It Xr pidfile 3 Ta write a daemon pid file
-.It Xr pidlock 3 Ta locks based on files containing PIDs
-.It Xr pw_abort 3 Ta passwd file update function
-.It Xr pw_copy 3 Ta utility function for interactive passwd file updates
-.It Xr pw_edit 3 Ta utility function for interactive passwd file updates
-.It Xr pw_error 3 Ta utility function for interactive passwd file updates
-.It Xr pw_getconf 3 Ta password encryption configuration access function
-.It Xr pw_getprefix 3 Ta passwd file update function
-.It Xr pw_init 3 Ta utility function for interactive passwd file updates
-.It Xr pw_lock 3 Ta passwd file update function
-.It Xr pw_mkdb 3 Ta passwd file update function
-.It Xr pw_prompt 3 Ta utility function for interactive passwd file updates
-.It Xr pw_scan 3 Ta utility function for interactive passwd file updates
-.It Xr pw_setprefix 3 Ta passwd file update function
-.It Xr secure_path 3 Ta determine if a file appears to be ``secure''
-.It Xr setclasscontext 3 Ta query login.conf database about a user class
-.It Xr setusercontext 3 Ta query login.conf database about a user class
-.It Xr snprintb 3 Ta bitmask output conversion
-.It Xr sockaddr_snprintf 3 Ta socket address formatting function
-.It Xr ttyaction 3 Ta ttyaction utility function
-.It Xr ttylock 3 Ta locks based on files containing PIDs
-.It Xr ttymsg 3 Ta ttymsg utility function
-.It Xr ttyunlock 3 Ta locks based on files containing PIDs
-.El
+.In util.h .
+The
+.Nm
+library and the associated functions are implemented within the
+.Pa /usr/src/lib/libutil
+directory.
 .Sh FILES
 .Bl -tag -width /usr/lib/libutil_p.a -compact
 .It Pa /usr/lib/libutil.a
@@ -110,4 +64,5 @@
 static util library compiled for profiling
 .El
 .Sh SEE ALSO
-.Xr efun 3
+.Xr efun 3 ,
+.Xr intro 3