a start at fleshing this out

1 files changed, 116 insertions, 46 deletions

diff --git a/share/man/man3/intro.3 b/share/man/man3/intro.3
index ce621df08ea..321b0835362 100644
--- a/share/man/man3/intro.3
+++ b/share/man/man3/intro.3
@@ -50,17 +50,11 @@ Other libraries, such as the math library,
 must be indicated at compile time with the
 .Fl l
 option of the compiler.
-.\" .Pp
-.\" A subset of the
-.\" .Xr libc functions
-.\" are available from Fortran;
-.\" they are described separately in
-.\" .Xr intro 3f .
 .Pp
 The various libraries (followed by the loader flag):
 .Bl -tag -width "libc (-lc)"
 .It Xr libc Pq Fl l Ns Ar c
-Standard C library functions. 
+Standard C library functions.
 When using the C compiler
 .Xr cc 1 ,
 it is not necessary
@@ -85,11 +79,7 @@ Reentrant C library. Contains POSIX 1003.1c
 API and thread scheduler, as well as all of the functions
 found in
 .Xr libc .
-.It Xo
-.Xr libcurses
-.Pf ( Fl l Ns Ar curses
-.Fl l Ns Ar termcap )
-.Xc
+.It Xr libcurses Pq Fl l Ns Ar curses
 Terminal independent screen management routines
 for two dimensional non-bitmap display terminals.
 (See
@@ -103,57 +93,137 @@ a number of system call interfaces provided in previous releases of
 have been included for source code compatibility.
 Use of these routines should, for the most part, be avoided.
 The manual page entry for each compatibility routine
-indicates the proper interface to use. 
-.\" .It Xr libkvm
+indicates the proper interface to use.
+.It Xr libkvm Pq Fl l Ns Ar kvm
+Kernel virtual interface library.  For more information, see
+.Xr kvm 3 .
 .It Xr libl Pq Fl l Ns Ar l
 The library for
 .Xr lex 1 .
-.\" .It Xr libln
 .It Xr libm Pq Fl l Ns Ar m
 The math library,
-.Em libm .
-.\" The math library is loaded as needed by the Pascal compiler
-.\" .Xr pc 1 ,
-.\" but not by the C compiler which requires the
-.\" .Fl l Ns Ar m
-.\" flag.
-.\" (See
-.\" .Xr math 3 . )
-.\" .It Xr libmp Pq Fl l Ns Ar mp
-.\" .It Xr libom
-.\" Old math library.
-.\" .It Xr libplot Pq Fl l Ns Ar plot
-.\" Device independent plotting functions. 
-.\" (See
-.\" .Xr plot 3 . )
-.\" .It Xr libplotf77 Pq Fl l Ns Ar plotf77
-.\" The device independent plotting functions for fortran. 
-.\" (See
-.\" .Xr plot 3 . )
-.\" .It Xr libresolv Pq Fl l Ns Ar resolv
-.\" Routines for network address resolution.
+.Em libm .  See
+.Xr math 3 .
 .It Xr libtermcap Pq Fl l Ns Ar termcap
 The terminal independent operation library package. (See
 .Xr termcap 3 . )
-.\" .It libvt0.a
-.It Xr liby Pq Fl l Ns Ar y
-The library for
-.Xr yacc 1 .
 .El
 .Sh FILES
-.Bl -tag -width /usr/lib/libm_p.a -compact
+.Bl -tag -width /usr/lib/libgnumalloc.a -compact
+.It Pa /usr/lib/libacl.a
+.It Pa /usr/lib/libbfd.a
 .It Pa /usr/lib/libc.a
 C library
+.It Pa /usr/lib/libc_r.a
+reentrant C library (see
+.Xr pthreads 3 )
+.It Pa /usr/lib/libcom_err.a
+.It Pa /usr/lib/libcompat.a
+4.3 compatibility library
+.It Pa /usr/lib/libcrypto.a
+.Xr ssl 8
+support library.
+.It Pa /usr/lib/libcurses++.a
+C++
+.Xr curses 3
+library.
+.It Pa /usr/lib/libcurses.a
+.Xr curses 3
+library.
+.It Pa /usr/lib/libdes.a
+.It Pa /usr/lib/libedit.a
+.It Pa /usr/lib/libfl.a
+.It Pa /usr/lib/libform.a
+.It Pa /usr/lib/libg2c.a
+.It Pa /usr/lib/libgmp.a
+.It Pa /usr/lib/libiberty.a
+.It Pa /usr/lib/libkadm.a
+.Xr kerberos 1
+support library.
+.It Pa /usr/lib/libkafs.a
+.Xr afsd 8
+support library.
+.It Pa /usr/lib/libkdb.a
+.It Pa /usr/lib/libkeycap.a
+.It Pa /usr/lib/libkeynote.a
+.It Pa /usr/lib/libkrb.a
+.It Pa /usr/lib/libkvm.a
+.Xr kvm 3
+kernel virtual memory access library.
+.It Pa /usr/lib/libl.a
 .It Pa /usr/lib/libm.a
-math library
-.It Pa /usr/lib/libc_p.a
-C library compiled for profiling
-.It Pa /usr/lib/libm_p.a
-math library compiled for profiling
+.Xr math 3
+library.
+.It Pa /usr/lib/libmenu.a
+.It Pa /usr/lib/libmmalloc.a
+.It Pa /usr/lib/libobjc.a
+.It Pa /usr/lib/libocurses.a
+The
+.Xr ocurses 3
+library is compatible with the
+.Em curses
+library provided in 4.3.
+.It Pa /usr/lib/libopcodes.a
+.It Pa /usr/lib/libossaudio.a
+.It Pa /usr/lib/libotermcap.a
+4.3-compatible termcap library.
+For use with
+.Xo
+.Xr libocurses
+.Pf ( ie. Fl l Ns Ar ocurses
+.Fl l Ns Ar otermcap )
+.Xc
+.It Pa /usr/lib/libpanel.a
+.Xr panel 3
+library for use with
+.Xo
+.Xr libcurses
+.Pf ( ie. Fl l Ns Ar panel
+.Fl l Ns Ar curses )
+.Xc
+.It Pa /usr/lib/libpcap.a
+.Xr pcap 3
+library.
+.It Pa /usr/lib/libreadline.a
+.It Pa /usr/lib/libresolv.a
+The
+.Xr resolver 3
+routines are included in
+.Em libc .
+For legacy applications,
+this library contains only those functions.
+.It Pa /usr/lib/librpcsvc.a
+A library generated by
+.Xr rpcgen 1
+containing stub functions for many common
+.Xr rpc 3
+protocols.
+.It Pa /usr/lib/libskey.a
+A support library for the
+.Xr skey 1
+authentication toolkit.
+.It Pa /usr/lib/libssl.a
+.Xr ssl 8
+support library.
+.It Pa /usr/lib/libstdc++.a
+.It Pa /usr/lib/libtelnet.a
+.It Pa /usr/lib/libtermcap.a
+.It Pa /usr/lib/libtermlib.a
+.It Pa /usr/lib/libutil.a
+.It Pa /usr/lib/libwrap.a
+.It Pa /usr/lib/liby.a
+.It Pa /usr/lib/libz.a
+.Pp
+.It Pa /usr/lib/libm_i387.a
+.It Pa /usr/lib/libi386.a
 .El
+.Pp
+Must talk about shared libraries, _p profiled libraries and how to tell the
+C compiler to use them, and any other issues.
 .Sh SEE ALSO
 .Xr cc 1 ,
 .Xr ld 1 ,
+.Xr ld.so 1 ,
 .Xr nm 1 ,
 .Xr intro 2 ,
 .Xr math 3 ,