- add descriptions of the different sections

- add .Xr's to the intro pages
- little cleanup

ok millert@

1 files changed, 58 insertions, 22 deletions

diff --git a/usr.bin/man/man.1 b/usr.bin/man/man.1
index 9d69f265702..ba9b77ec91b 100644
--- a/usr.bin/man/man.1
+++ b/usr.bin/man/man.1
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: man.1,v 1.18 2003/06/03 02:56:12 millert Exp $
+.\"	$OpenBSD: man.1,v 1.19 2003/08/08 07:54:13 jmc Exp $
 .\"
 .\" Copyright (c) 1989, 1990, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -73,30 +73,30 @@ you are interested in, for instance
 .Pp
 .Nm man Fl k Em mount
 .Pp
-will list all man-pages which contain your
+will list all man pages which contain your
 .Ar keyword
 in the
 .Em NAME
 line of the man page;
 in this case a list much like this:
-.Bd -literal -offset xx
-amd (8) - automatically mount file systems
-amq (8) - automounter query tool
-mount (8) - mount file systems
-mount, unmount (2) - mount or dismount a filesystem
-mount_ados (8) - mount an AmigaDOS file system
-mount_cd9660 (8) - mount an ISO-9660 filesystem
-mount_ext2fs (8) - mount a ext2fs file system
-mount_fdesc (8) - mount the file-descriptor file system
-mount_ffs, mount_ufs (8) - mount a Berkeley Fast File System
-mount_kernfs (8) - mount the /kern file system
-mount_procfs (8) - mount the process file system
-mount_umap (8) - sample file system layer
-mount_union (8) - mount union filesystems
-mount_xfs (8) - mount the xfs filesystem
-mountd (8) - service remote NFS mount requests
-newfs, mount_mfs (8) - construct a new file system
-umount (8) - unmount file systems
+.Bd -literal
+amd (8) \- automatically mount file systems
+amq (8) \- automounter query tool
+mount (8) \- mount file systems
+mount, unmount (2) \- mount or dismount a filesystem
+mount_ados (8) \- mount an AmigaDOS file system
+mount_cd9660 (8) \- mount an ISO-9660 filesystem
+mount_ext2fs (8) \- mount a ext2fs file system
+mount_fdesc (8) \- mount the file-descriptor file system
+mount_ffs, mount_ufs (8) \- mount a Berkeley Fast File System
+mount_kernfs (8) \- mount the /kern file system
+mount_procfs (8) \- mount the process file system
+mount_umap (8) \- sample file system layer
+mount_union (8) \- mount union filesystems
+mount_xfs (8) \- mount the xfs filesystem
+mountd (8) \- service remote NFS mount requests
+newfs, mount_mfs (8) \- construct a new file system
+umount (8) \- unmount file systems
 \&...
 .Ed
 .It Fl a
@@ -194,13 +194,40 @@ The optional
 argument restricts the directories that
 .Nm
 will search.
+The currently available sections are:
+.Pp
+.Bl -tag -width "3p " -offset indent -compact
+.It 1
+General commands
+.Pq tools and utilities .
+.It 2
+System calls and error numbers.
+.It 3
+Libraries.
+.It 3p
+.Xr perl 1
+programmer's reference guide.
+.It 4
+Device drivers.
+.It 5
+File formats.
+.It 6
+Games.
+.It 7
+Miscellaneous.
+.It 8
+System maintenance and operation commands.
+.It 9
+Kernel internals.
+.El
+.Pp
 The
 .Nm
 configuration file (see
 .Xr man.conf 5 )
 specifies the possible
 .Ar section
-values that are currently available.
+values, and their search order.
 If only a single argument is specified or if the first argument is
 not a valid section,
 .Nm
@@ -247,9 +274,18 @@ default man configuration file
 .El
 .Sh SEE ALSO
 .Xr apropos 1 ,
+.Xr intro 1 ,
 .Xr whatis 1 ,
 .Xr whereis 1 ,
-.Xr man.conf 5
+.Xr intro 2 ,
+.Xr intro 3 ,
+.Xr intro 4 ,
+.Xr intro 5 ,
+.Xr man.conf 5 ,
+.Xr intro 6 ,
+.Xr intro 7 ,
+.Xr intro 8 ,
+.Xr intro 9
 .Sh HISTORY
 A
 .Nm