cleanup of typos in section 7 man pages;

mdoc.samples(7): ok millert@

6 files changed, 82 insertions, 81 deletions

diff --git a/share/man/man7/intro.7 b/share/man/man7/intro.7
index d14277da561..99382515acc 100644
--- a/share/man/man7/intro.7
+++ b/share/man/man7/intro.7
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: intro.7,v 1.7 2002/06/08 23:01:21 millert Exp $
+.\"	$OpenBSD: intro.7,v 1.8 2003/04/13 11:06:21 jmc Exp $
 .\"	$NetBSD: intro.7,v 1.3 1994/11/30 19:07:15 jtc Exp $
 .\"
 .\" Copyright (c) 1983, 1990, 1993
@@ -47,39 +47,39 @@ The manual pages in section 7 section contain miscellaneous documentation.
 .It Xr ascii
 Map of ASCII character set.
 .It Xr des_modes
-Variants of the DES algorithm
+Variants of the DES algorithm.
 .It Xr environ
 User environment.
 .It Xr groff_char
-Groff character names
+Groff character names.
 .It Xr groff_mm
-Groff mm macros
+Groff mm macros.
 .It Xr groff_mmse
-Svenska mm macro for groff
+Svenska mm macro for groff.
 .It Xr groff_msafer
-Groff -msafer macros
+Groff -msafer macros.
 .It Xr hier
 File system hierarchy.
 .It Xr hostname
 Hostname resolution rules.
 .It Xr kgdb
-Remote kernel debugging with gdb
+Remote kernel debugging with gdb.
 .It Xr library-specs
-Shared library name specifications
+Shared library name specifications.
 .It Xr mailaddr
 Mail addressing description.
 .It Xr man
-Troff `an' macros to support generation of man pages
+Troff `an' macros to support generation of man pages.
 .It Xr mdoc
 Troff macros to typeset manual pages.
 .It Xr mdoc.samples
 Guide to writing manual pages.
 .It Xr me
-Troff macros for formatting papers
+Troff macros for formatting papers.
 .It Xr mirroring-ports
 How to build a mirror for ports distfiles.
 .It Xr ms
-Troff ms macros
+Troff ms macros.
 .It Xr operator
 C operator precedence.
 .It Xr packages
@@ -89,13 +89,13 @@ Binary package names specifications.
 .It Xr ports
 Contributed applications.
 .It Xr re_format
-POSIX 1003.2 regular expressions
+POSIX 1003.2 regular expressions.
 .It Xr securelevel
-The securelevel kernel state and its effects
+The securelevel kernel state and its effects.
 .It Xr symlink
-Symbolic link handling
+Symbolic link handling.
 .It Xr term
-Conventions for naming terminal types
+Conventions for naming terminal types.
 .El
 .Sh HISTORY
 An
diff --git a/share/man/man7/kgdb.7 b/share/man/man7/kgdb.7
index 47d38aee24c..cbd645867bf 100644
--- a/share/man/man7/kgdb.7
+++ b/share/man/man7/kgdb.7
@@ -1,4 +1,4 @@
-.\"     $OpenBSD: kgdb.7,v 1.5 2001/10/01 12:58:23 hugh Exp $
+.\"     $OpenBSD: kgdb.7,v 1.6 2003/04/13 11:06:21 jmc Exp $
 .\"
 .\" Copyright (c) 2001 Hugh Graham
 .\"
@@ -62,7 +62,9 @@ on the target system.
 On the control system, run gdb on the kernel just copied.
 .It
 Issue the command "target remote /dev/<serial port>" within gdb.
-The target system should enter kgdb at this point.
+The target system should enter
+.Nm
+at this point.
 .It
 Debug as normal and detach when done, the target should resume normal operation.
 .El
diff --git a/share/man/man7/library-specs.7 b/share/man/man7/library-specs.7
index edd13b0e880..48916dd7407 100644
--- a/share/man/man7/library-specs.7
+++ b/share/man/man7/library-specs.7
@@ -1,4 +1,4 @@
-.\" $OpenBSD: library-specs.7,v 1.2 2001/11/26 10:29:42 mpech Exp $
+.\" $OpenBSD: library-specs.7,v 1.3 2003/04/13 11:06:21 jmc Exp $
 .\"
 .\" Copyright (c) 2001 Marc Espie
 .\"
@@ -36,13 +36,13 @@ Each
 item in the port tree conforms to
 .Sq lib_specs:[pkgspec]:directory[,-subpackage][,flavor ...][:target] ,
 where
-.Sq lib_specs ,
+.Sq lib_specs
 is a comma-separated list of
 .Sq lib_spec
 of the form:
 .Sq libname[.major[.minor]] .
 .Pp
-All libraries that a port needs must be mentioned in that list, either 
+All libraries that a port needs must be mentioned in that list, either
 directly or indirectly through recursive dependencies (except, of course,
 for system libraries).
 .Pp
@@ -56,8 +56,8 @@ augmented, and by bumping the major number each time the interface changes.
 Note that adding functions to a library is an interface augmentation.
 Removing functions is an interface change.
 .Pp
-The major.minor components of the library specification are used only as a build
-time check.
+The major.minor components of the library specification are used only as a
+build-time check.
 Any library which is more recent than the given major.minor version will
 do.
 If the minor component is left empty, any minor will do.
@@ -65,9 +65,9 @@ If both components are left empty, any version will do.
 If a specific major number is needed, use the form
 .Sq libname.=major[.minor] .
 .Pp
-The 
+The
 .Sq pkgspec
-part is always checked, both a build-time, and at
+part is always checked, both at build-time, and at
 .Xr pkg_add 1
 time.
 If
diff --git a/share/man/man7/mdoc.7 b/share/man/man7/mdoc.7
index d28af8667e2..0a0d7741214 100644
--- a/share/man/man7/mdoc.7
+++ b/share/man/man7/mdoc.7
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: mdoc.7,v 1.24 2002/12/06 02:36:24 marc Exp $
+.\"	$OpenBSD: mdoc.7,v 1.25 2003/04/13 11:06:21 jmc Exp $
 .\"
 .\" Copyright (c) 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -306,8 +306,8 @@ Produces
 .It Li \&Ev Ta Yes Ta Yes Ta "Environment variable."
 .It Li \&Fa Ta Yes Ta Yes Ta "Function argument."
 .It Li \&Fd Ta \&No Ta \&No Ta "Function declaration."
-.It Li \&Ft Ta Yes Ta Yes Ta "Function type."
 .It Li \&Fn Ta Yes Ta Yes Ta "Function call (also .Fo and .Fc)."
+.It Li \&Ft Ta Yes Ta Yes Ta "Function type."
 .It Li \&Ic Ta Yes Ta Yes Ta "Interactive command."
 .It Li \&Li Ta Yes Ta Yes Ta "Literal text."
 .It Li \&Nd Ta \&No Ta \&No Ta "Command description."
diff --git a/share/man/man7/mdoc.samples.7 b/share/man/man7/mdoc.samples.7
index 549fcce8de9..7cf9e09a247 100644
--- a/share/man/man7/mdoc.samples.7
+++ b/share/man/man7/mdoc.samples.7
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: mdoc.samples.7,v 1.39 2003/02/25 08:51:31 jmc Exp $
+.\"	$OpenBSD: mdoc.samples.7,v 1.40 2003/04/13 11:06:21 jmc Exp $
 .\"	$NetBSD: mdoc.samples.7,v 1.5 1996/04/03 20:17:34 jtc Exp $
 .\"
 .\" Copyright (c) 1990, 1993
@@ -126,7 +126,7 @@ outlined as follows:
 .It
 .Tn "TITLE MACROS"
 .It
-.Tn "INTRODUCTION OF MANUAL AND GENERAL TEXT DOMAINS"
+.Tn "INTRODUCTION TO MANUAL AND GENERAL TEXT DOMAINS"
 .Bl -tag -width flag -compact -offset indent
 .It "What's in a name..." .
 .It "General Syntax" .
@@ -139,7 +139,7 @@ outlined as follows:
 .It "Configuration Declarations (section four only)" .
 .It "Command Modifier" .
 .It "Defined Variables" .
-.It "Errno (Section two only)" .
+.It "Errno (section two only)" .
 .It "Environment Variables" .
 .It "Function Argument" .
 .It "Function Declaration" .
@@ -168,10 +168,10 @@ outlined as follows:
 .It "Enclosure/Quoting Macros"
 .Bl -tag -width flag -compact -offset indent
 .It "Angle Bracket Quote/Enclosure" .
-.It "Bracket Quotes/Enclosure" .
+.It "Bracket Quote/Enclosure" .
 .It "Double Quote macro/Enclosure" .
 .It "Parenthesis Quote/Enclosure" .
-.It "Single Quotes/Enclosure" .
+.It "Single Quote/Enclosure" .
 .It "Prefix Macro" .
 .El
 .It "Extended Arguments" .
@@ -352,11 +352,11 @@ to the following macros which need
 it the most:
 .Pp
 .Bl -tag -width 4n -offset indent -compact
-.It Li \&Cd
-Configuration declaration (section 4
-.Sx SYNOPSIS )
 .It Li \&Bl
 Begin list (for the width specifier).
+.It Li \&Cd
+Configuration declaration (section 4
+.Sx SYNOPSIS ) .
 .It Li \&Em
 Emphasized text.
 .It Li \&Fn
@@ -578,12 +578,12 @@ or for a locally produced set
 .Pp
 .Dl \&.Os CS Department
 .Pp
-The 
+The
 .Ox
 default,
 .Ql \&.Os
 without an argument, has been defined as
-.Ox 2.7
+.Ox 3.3
 in the site specific file
 .Pa /usr/share/tmac/mdoc/doc-common .
 It really should default to
@@ -593,7 +593,7 @@ Note, if the
 macro is not present, the bottom left corner of the page
 will be ugly.
 .El
-.Sh INTRODUCTION OF MANUAL AND GENERAL TEXT DOMAINS
+.Sh INTRODUCTION TO MANUAL AND GENERAL TEXT DOMAINS
 .Ss What's in a name...
 The manual domain macro names are derived from the day to day
 informal language used to describe commands, subroutines and related
@@ -768,7 +768,7 @@ The result is:
 .Pp
 .Dl Li sptr, ptr),
 .Pp
-The punctuation is not recognized and all is output in the
+The punctuation is not recognized and everything is output in the
 literal font.
 If the punctuation is separated by a leading white space:
 .Pp
@@ -873,8 +873,7 @@ produced by:
 .Ss Command Modifier
 The command modifier is identical to the
 .Ql \&.Fl
-(flag) command with the exception
-the
+(flag) command with the exception that the
 .Ql \&.Cm
 macro does not assert a dash
 in front of every argument.
@@ -1044,7 +1043,7 @@ macro without any arguments results
 in a dash representing stdin/stdout.
 Note that giving
 .Ql \&.Fl
-a single dash, will result in two dashes.
+a single dash will result in two dashes.
 The
 .Ql \&.Fl
 macro is parsed and is callable.
@@ -1243,7 +1242,7 @@ command keyword in
 the
 .Ql \&.Ic
 macro should be used.
-While the
+While
 .Ql \&.Ic
 is nearly identical
 to
@@ -2353,7 +2352,7 @@ The above was produced by:
 Begin-display.
 The
 .Ql \&.Bd
-display must be ended with the
+display must end with the
 .Ql \&.Ed
 macro.
 Displays may be nested within displays and lists, but may
@@ -2809,7 +2808,7 @@ This is sufficient for the internal register names also.
 .\" w[0-9]		width tag/label stack
 .\" .Ed
 .\" .Pp
-If a non-escaped register name is given in the argument list of a request
+If a non-escaped register name is given in the argument list of a request,
 unpredictable behavior will occur.
 In general, any time huge portions
 of text do not appear where expected in the output, or small strings
diff --git a/share/man/man7/packages-specs.7 b/share/man/man7/packages-specs.7
index a6dbb04f344..d55154d1dca 100644
--- a/share/man/man7/packages-specs.7
+++ b/share/man/man7/packages-specs.7
@@ -1,4 +1,4 @@
-.\" $OpenBSD: packages-specs.7,v 1.4 2001/11/17 10:46:09 espie Exp $
+.\" $OpenBSD: packages-specs.7,v 1.5 2003/04/13 11:06:21 jmc Exp $
 .\"
 .\" Copyright (c) 2001 Marc Espie
 .\"
@@ -38,12 +38,12 @@ stem-version[-flavors]
 .Pp
 The
 .Ar stem
-part identifies the package. 
-It may contain some dashes, but its form is mostly conventional. 
+part identifies the package.
+It may contain some dashes, but its form is mostly conventional.
 For instance, japanese packages usually
 start with a
 .Sq ja
-prefix, e.g., 
+prefix, e.g.,
 .Qq ja-kterm-6.2.0 .
 .Pp
 The
@@ -57,26 +57,26 @@ It is highly recommended that all packages have a version number.
 Normally, the version number directly matches the original software
 distribution version number, or release date.
 In case there are substantial changes in the
-.Ox 
+.Ox
 package, a patch level marker should be appended, e.g.,
 .Sq p1 ,
 .Sq p2 ...
 For example, assuming that the screen package for release 2.8 was
 named
-.Qq screen-2.9.8 
-and that an important security patch led to a newer package, 
-the new package would be called 
+.Qq screen-2.9.8
+and that an important security patch led to a newer package,
+the new package would be called
 .Qq screen-2.9.8p1 .
 Obviously, these specific markers are reserved for
 .Ox
 purposes.
 .Pp
 Flavored packages will also contain a list of flavors after the version
-identifier, in a canonical order determined by 
+identifier, in a canonical order determined by
 .Ev FLAVORS
-in the corresponding port's 
+in the corresponding port's
 .Pa Makefile .
-For instance, kterm has an xaw3d flavor: 
+For instance, kterm has an xaw3d flavor:
 .Qq ja-kterm-xaw3d .
 .Pp
 Note that, to uniquely identify the version part, no flavor shall ever
@@ -91,19 +91,19 @@ normally not possible to install two packages with the same
 .Pp
 Note that the
 .Ar stem
-ends at the 
+ends at the
 .Ar version
 part.
-So, for instance, 
+So, for instance,
 .Qq kdelibs-1.1.2
 and
 .Qq kdelibs-2.1.1
-conflict. 
+conflict.
 But
 .Qq openldap-2.0.7
 and
 .Qq openldap-client-2.0.7
-don't. 
+don't.
 Neither do
 .Qq qt-1.45
 and
@@ -119,8 +119,8 @@ is found).
 The corresponding package name is also used as a package specification,
 unless a more specific specification has been given.
 .Pp
-Package specifications are extended package names, that may use 
-.Xr sh 1 
+Package specifications are extended package names, that may use
+.Xr sh 1
 -style wildcards, like
 .Sq *
 or
@@ -145,16 +145,16 @@ For instance, in
 LIB_DEPENDS=aa.1.2::graphics/aalib
 .Ed
 .Pp
-both 
-.Qq aalib-1.2 
-and 
-.Qq aalib-1.2-no_x11 
+both
+.Qq aalib-1.2
+and
+.Qq aalib-1.2-no_x11
 will do.
-To restrict the specification to packages that match flavor 
+To restrict the specification to packages that match flavor
 .Sq f ,
 append
 .Sq -f .
-To restrict the specification to packages that do not match flavor 
+To restrict the specification to packages that do not match flavor
 .Sq f ,
 append
 .Sq -!f .
@@ -173,25 +173,25 @@ Resolution occurs at
 .Xr pkg_add 1
 time, and all dependencies are tracked only as far as needed.
 .Pp
-For instance, if package 
-.Qq foo 
-depends on either 
-.Qq bar 
-or 
-.Qq fuzz , 
-and 
-.Qq bar 
+For instance, if package
+.Qq foo
+depends on either
+.Qq bar
+or
+.Qq fuzz ,
+and
+.Qq bar
 depends
-on 
+on
 .Qq toughluck ,
 .Xr pkg_add 1
-will first check whether 
-.Qq bar 
-or 
+will first check whether
+.Qq bar
+or
 .Qq fuzz
 is installed.
-If either is there, the 
-.Qq toughluck 
+If either is there, the
+.Qq toughluck
 dependency will never be examined.
 It would only be used in the case where neither
 .Qq bar