Correct some man page xrefs, and some other minor changes to bring some

man pages up to mdoc guidelines and fix some minor formatting glitches.
Also fixed a number of man pages to not abuse the .Xr macro to
display functions and path names and a lot of other junk.

3 files changed, 23 insertions, 14 deletions

diff --git a/share/man/man7/clocks.7 b/share/man/man7/clocks.7
index 7c3babf346c6..fa6abe578eec 100644
--- a/share/man/man7/clocks.7
+++ b/share/man/man7/clocks.7
@@ -25,7 +25,7 @@
 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.\" $Id: clocks.7,v 1.1 1996/04/05 08:51:22 joerg Exp $
+.\" $Id: clocks.7,v 1.2 1996/04/07 21:12:10 mpp Exp $
 .\" "
 .Dd April 1, 1996
 .Os
@@ -52,8 +52,11 @@ happens to be 128.  It isn't directly available to applications.
 The clock reported by
 .Xr clock 3 .
 This is a virtual clock with a frequency that happens to be 128.  It's
-actual frequency is given by the macro CLOCKS_PER_SEC.  Note that
-CLOCKS_PER_SEC may be floating point.  Don't use 
+actual frequency is given by the macro 
+.Dv CLOCKS_PER_SEC .  
+Note that
+.Dv CLOCKS_PER_SEC
+may be floating point.  Don't use 
 .Fn clock
 in new programs under FreeBSD.  It is feeble compared with
 .Xr getrusage 2 .
@@ -64,13 +67,15 @@ and throwing away information and resolution.
 The clock reported by
 .Xr times 3 .
 This is a virtual clock with a frequency that happens to be 128.  It's
-actual frequency is given by the macro CLK_TCK (deprecated; don't use)
-and by 
+actual frequency is given by the macro
+.Dv CLK_TCK
+(deprecated; don't use) and by 
 .Fn sysconf SC_CLK_TCK
 and by
 .Xr sysctl 3 .
-Note that its frequency may be different from CLOCKS_PER_SEC.  Don't
-use 
+Note that its frequency may be different from
+.Dv CLOCKS_PER_SEC .
+Don't use 
 .Xr times 3
 in new programs under FreeBSD.  It is feeble compared with
 .Xr gettimeofday 2
diff --git a/share/man/man7/environ.7 b/share/man/man7/environ.7
index e969e3c7e435..1b222210f601 100644
--- a/share/man/man7/environ.7
+++ b/share/man/man7/environ.7
@@ -54,7 +54,8 @@ The size of the block units used by several commands, most notably
 .Xr du 1
 and
 .Xr ls 1 .
-BLOCKSIZE may be specified in units of a byte by specifying a number, 
+.Ev BLOCKSIZE 
+may be specified in units of a byte by specifying a number, 
 in units of a kilobyte by specifying a number followed by ``K'' or
 ``k'', in units of a megabyte by specifying a number followed by ``M''
 or ``m'' and in units of a gigabyte by specifying a number followed
@@ -72,9 +73,9 @@ A user's login directory, set by
 from the password file
 .Xr passwd  5  .
 .It Ev LANG
-This variable configure all programs which use
+This variable configures all programs which use
 .Xr setlocale 3
-to specified locale.
+to use the specified locale.
 .It Ev PATH
 The sequence of directories, separated by colons, searched by
 .Xr csh  1  ,
@@ -82,7 +83,8 @@ The sequence of directories, separated by colons, searched by
 .Xr system  3  ,
 .Xr execvp  3 ,
 etc, when looking for an executable file.
-PATH is set to ``/usr/bin:/bin'' initially by
+.Ev PATH 
+is set to ``/usr/bin:/bin'' initially by
 .Xr login  1  .
 .It Ev PRINTER
 The name of the default printer to be used by
@@ -103,7 +105,9 @@ which may exploit special terminal capabilities.  See
 .Pq Xr termcap 5
 for a list of terminal types.
 .It Ev TERMCAP
-The string describing the terminal in TERM, or, if
+The string describing the terminal in
+.Ev TERM , 
+or, if
 it begins with a '/', the name of the termcap file.
 See
 .Ev TERMPATH
@@ -134,7 +138,7 @@ Setting this variable will make them use another directory.
 .It Ev TZ
 The timezone to use when displaying dates.
 The normal format is a pathname relative to
-.Dq /usr/share/zoneinfo .
+.Dq Pa /usr/share/zoneinfo .
 For example, the command
 .Dq env TZ=US/Pacific date
 displays the current time in California.
diff --git a/share/man/man7/hier.7 b/share/man/man7/hier.7
index 3013278dd524..c7f1eb691d9b 100644
--- a/share/man/man7/hier.7
+++ b/share/man/man7/hier.7
@@ -76,7 +76,7 @@ see
 .It Li mtree/ 
 mtree configuration files;
 see
-.Xr mtree 1
+.Xr mtree 8
 .It Li namedb/ 
 named configuration files;
 see