Added missing section numbers to a bunch of .Xr macros, or

converted them into .Fn macros where appropriate.  Also fixed
up some minor formatting problems.

lib/libc/compat-43/sigvec.2

@@ -102,9 +102,9 @@ must arrange to restore the previous context itself.
 When a signal is delivered to a process a new signal mask is
 installed for the duration of the process' signal handler
 (or until a
-.Xr sigblock
+.Xr sigblock 2
 or
-.Xr sigsetmask
+.Xr sigsetmask 2
 call is made).
 This mask is formed by taking the current signal mask,
 adding the signal to be delivered, and 

lib/libc/gen/crypt.3

@@ -54,7 +54,7 @@
 .Fn des_cipher "const char *in" "char *out" "long salt" "int count"
 .Sh DESCRIPTION
 The
-.Xr crypt
+.Fn crypt
 function
 performs password encryption.
 It is derived from the

lib/libc/gen/ctermid.3

@@ -80,7 +80,7 @@ The current implementation detects no error conditions.
 .Xr ttyname 3
 .Sh STANDARDS
 The
-.Xr ctermid
+.Fn ctermid
 function conforms to
 .St -p1003.1-88 .
 .Sh BUGS

lib/libc/gen/exec.3

@@ -65,7 +65,7 @@ new process image.
 The functions described in this manual page are front-ends for the function
 .Xr execve 2 .
 (See the manual page for
-.Xr execve
+.Xr execve 2
 for detailed information about the replacement of the current process.)
 .Pp
 The initial argument for these functions is the pathname of a file which
@@ -148,7 +148,7 @@ used.
 In addition, certain errors are treated specially.
 .Pp
 If permission is denied for a file (the attempted
-.Xr execve
+.Fn execve
 returned
 .Er EACCES ) ,
 these functions will continue searching the rest of
@@ -159,7 +159,7 @@ set to
 .Er EACCES .
 .Pp
 If the header of a file isn't recognized (the attempted
-.Xr execve
+.Fn execve
 returned
 .Er ENOEXEC ) ,
 these functions will execute the shell with the path of
@@ -167,7 +167,7 @@ the file as its first argument.
 (If this attempt fails, no further searching is done.)
 .Pp
 If the file is currently busy (the attempted
-.Xr execve
+.Fn execve
 returned
 .Er ETXTBUSY ) ,
 these functions will sleep for several seconds,
@@ -179,7 +179,7 @@ executes a file with the program tracing facilities enabled (see
 .Xr ptrace 2 ) .
 .Sh RETURN VALUES
 If any of the
-.Xr exec
+.Fn exec
 functions returns, an error will have occurred.
 The return value is \-1, and the global variable
 .Va errno

lib/libc/gen/getmntinfo.3

@@ -48,7 +48,7 @@ The
 .Fn getmntinfo
 function
 returns an array of
-.Xr statfs
+.Fn statfs
 structures describing each currently mounted file system (see
 .Xr statfs 2 ) .
 .Pp

lib/libc/gen/getpagesize.3

@@ -47,8 +47,7 @@ returns the number of bytes in a page.
 Page granularity is the granularity of many of the memory
 management calls.
 .Pp
-The page size is a 
-.Xr system
+The page size is a system
 page size and may not be the same as the underlying
 hardware page size.
 .Sh SEE ALSO

lib/libc/gen/glob.3

@@ -220,7 +220,8 @@ to provide globbing from directories stored on tape.
 Pre-process the pattern string to expand 
 .Ql {pat,pat,...} 
 strings like 
-.Xr csh 1. The pattern 
+.Xr csh 1 .
+The pattern 
 .Ql {}
 is left unexpanded for historical reasons
 .Xr (Csh 1 

lib/libc/gen/popen.3

@@ -170,9 +170,9 @@ The
 .Fn popen
 argument
 always calls
-.Xr sh ,
+.Xr sh 1 ,
 never calls
-.Xr csh .
+.Xr csh 1 .
 .Sh HISTORY
 A
 .Fn popen

lib/libc/gen/signal.3

@@ -193,7 +193,7 @@ Otherwise, \-1 is returned and  the global variable
 .Va errno
 is set to indicate the error.
 .Sh ERRORS
-.Xr Signal
+.Fn Signal
 will fail and no action will take place if one of the
 following occur:
 .Bl -tag -width [EINVAL]

lib/libc/gen/sleep.3

@@ -70,7 +70,7 @@ A similar but less compatible function can be obtained with a single
 .Xr select 2 ;
 such a function would not restart after signals, but would not interfere
 with other uses of
-.Xr setitimer .
+.Xr setitimer 2 .
 .Sh RETURN VALUES
 .Sh SEE ALSO
 .Xr setitimer 2 ,

lib/libc/gen/syslog.3

@@ -139,12 +139,12 @@ one or more of the following values:
 If
 .Fn syslog
 cannot pass the message to
-.Xr syslogd
+.Xr syslogd 8
 it will attempt to write the message to the console
 .Pq Dq Pa /dev/console.
 .It Dv LOG_NDELAY 
 Open the connection to
-.Xr syslogd
+.Xr syslogd 8
 immediately.
 Normally the open is delayed until the first message is logged.
 Useful for programs that need to manage the order in which file

lib/libc/gen/unvis.3

@@ -100,7 +100,7 @@ to zero.  Call
 with each successive byte, along with a pointer
 to this integer, and a pointer to a destination character.
 The
-.Xr unvis
+.Fn unvis
 function
 has several return codes that must be handled properly.  They are:
 .Bl -tag -width UNVIS_VALIDPUSH

lib/libc/locale/isupper.3

@@ -69,6 +69,6 @@ returns non-zero if the character tests true.
 .Xr ascii 7
 .Sh STANDARDS
 The
-.Xr isupper
+.Fn isupper
 function conforms to
 .St -ansiC .

lib/libc/stdio/fopen.3

@@ -142,7 +142,7 @@ The original stream (if it exists) is closed.
 The
 .Fa mode
 argument is used just as in the
-.Xr fopen
+.Fn fopen
 function.
 The primary use of the
 .Fn freopen

lib/libc/stdio/scanf.3

@@ -200,7 +200,7 @@ the next pointer must be a pointer to
 .Em int .
 .It Cm D
 Equivalent to
-.Xr ld ;
+.Cm ld ;
 this exists only for backwards compatibility.
 .It Cm i
 Matches an optionally signed integer;
@@ -221,7 +221,7 @@ the next pointer must be a pointer to
 .Em unsigned int .
 .It Cm O
 Equivalent to
-.Xr lo ;
+.Cm lo ;
 this exists for backwards compatibility.
 .It Cm u
 Matches an optionally signed decimal integer;

lib/libc/stdio/stdio.3

@@ -151,7 +151,7 @@ function.
 The
 .Nm stdio
 library is a part of the library
-.Xr libc
+.Nm libc
 and routines are automatically loaded as needed by the compilers
 .Xr cc 1
 and
@@ -192,15 +192,15 @@ without first removing their current definitions with
 .Dv stdin ,
 .Dv stdout .
 Function versions of the macro functions
-.Xr feof ,
-.Xr ferror ,
-.Xr clearerr ,
-.Xr fileno ,
-.Xr getc ,
-.Xr getchar ,
-.Xr putc ,
+.Fn feof ,
+.Fn ferror ,
+.Fn clearerr ,
+.Fn fileno ,
+.Fn getc ,
+.Fn getchar ,
+.Fn putc ,
 and
-.Xr putchar
+.Fn putchar
 exist and will be used if the macros
 definitions are explicitly removed.
 .Sh SEE ALSO
@@ -211,9 +211,9 @@ definitions are explicitly removed.
 .Sh BUGS
 The standard buffered functions do not interact well with certain other
 library and system functions, especially
-.Xr vfork
+.Xr vfork 2
 and
-.Xr abort .
+.Xr abort 3 .
 .Sh STANDARDS
 The
 .Nm stdio

lib/libc/stdio/tmpnam.3

@@ -201,7 +201,7 @@ Second, most historic implementations provide only a limited number
 of possible temporary file names (usually 26) before file names will
 start being recycled.
 Third, the System V implementations of these functions (and of
-.Xr mktemp )
+.Xr mktemp 3 )
 use the
 .Xr access 2
 function to determine whether or not the temporary file may be created.

lib/libc/stdlib/random.3

@@ -64,11 +64,16 @@ The period of this random number generator is very large, approximately
 .if n 16*((2**31)\(mi1).
 .Pp
 The
-.Fn random Ns / Fn srandom
-have (almost) the same calling sequence and initialization properties as
-.Xr rand 3 Ns / Xr srand 3 .
+.Fn random 
+and
+.Fn srandom
+functions have (almost) the same calling sequence and initialization properties as the
+.Xr rand 3
+and
+.Xr srand 3
+functions.
 The difference is that
-.Xr rand
+.Xr rand 3
 produces a much less random sequence \(em in fact, the low dozen bits
 generated by rand go through a cyclic pattern.  All the bits generated by
 .Fn random

lib/libc/stdtime/ctime.3

@@ -89,9 +89,9 @@ environmental variable (see
 The function
 .Fn localtime
 uses
-.Xr tzset
+.Xr tzset 3
 to initialize time conversion information if
-.Xr tzset
+.Xr tzset 3
 has not already been called by the process.
 .Pp
 After filling in the tm structure,

lib/libc/sys/_exit.2

@@ -53,7 +53,7 @@ This may entail delays, for example, waiting for output to drain;
 a process in this state may not be killed, as it is already dying.
 .It
 If the parent process of the calling process has an outstanding
-.Xr wait
+.Xr wait 2
 call
 or catches the
 .Dv SIGCHLD

lib/libc/sys/brk.2

@@ -94,7 +94,7 @@ it will not be possible to set the break
 beyond the
 .Em rlim_max
 value returned from a call to
-.Xr getrlimit ,
+.Xr getrlimit 2 ,
 e.g.
 .Dq qetext + rlp\(->rlim_max.
 (see
@@ -114,7 +114,7 @@ otherwise -1 with
 .Va errno
 set to indicate why the allocation failed.
 .Sh ERRORS
-.Xr Sbrk
+.Fn Sbrk
 will fail and no additional memory will be allocated if
 one of the following are true:
 .Bl -tag -width [ENOMEM]
@@ -139,7 +139,7 @@ Setting the break may fail due to a temporary lack of
 swap space.  It is not possible to distinguish this
 from a failure caused by exceeding the maximum size of
 the data segment without consulting 
-.Xr getrlimit .
+.Xr getrlimit 2 .
 .Sh HISTORY
 A
 .Nm

lib/libc/sys/close.2

@@ -78,7 +78,7 @@ of the descriptors can be rearranged with
 or deleted with
 .Fn close
 before the
-.Xr execve
+.Xr execve 2
 is attempted, but if some of these descriptors will still
 be needed if the execve fails, it is necessary to arrange for them
 to be closed if the execve succeeds.

lib/libc/sys/fcntl.2

@@ -128,9 +128,9 @@ flags are as follows:
 .Bl -tag -width O_NONBLOCKX
 .It Dv O_NONBLOCK
 Non-blocking I/O; if no data is available to a
-.Xr read
+.Xr read 2
 call, or if a
-.Xr write
+.Xr write 2
 operation would block,
 the read or write call returns -1 with the error
 .Er EAGAIN .

lib/libc/sys/fork.2

@@ -59,9 +59,9 @@ for instance, file pointers in file objects are shared between
 the child and the parent, so that an
 .Xr lseek 2
 on a descriptor in the child process can affect a subsequent
-.Xr read
+.Xr read 2
 or
-.Xr write
+.Xr write 2
 by the parent.
 This descriptor copying is also used by the shell to
 establish standard input and output for newly created processes

lib/libc/sys/getrlimit.2

@@ -60,7 +60,7 @@ parameter is one of the following:
 .Bl -tag -width RLIMIT_FSIZEAA
 .It Li RLIMIT_CORE
 The largest size (in bytes)
-.Xr core
+.Xr core 5
 file that may be created.
 .It Li RLIMIT_CPU
 The maximum amount of cpu time (in seconds) to be used by

lib/libc/sys/getsockopt.2

@@ -30,7 +30,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\"	@(#)getsockopt.2	8.3 (Berkeley) 4/19/94
-.\"	$Id: getsockopt.2,v 1.3 1996/01/22 00:01:59 julian Exp $
+.\"	$Id: getsockopt.2,v 1.4 1996/02/11 22:34:21 mpp Exp $
 .\"
 .Dd November 3, 1995
 .Dt GETSOCKOPT 2
@@ -190,7 +190,7 @@ is performed.
 If the socket promises reliable delivery of data and
 .Dv SO_LINGER is set,
 the system will block the process on the 
-.Xr close
+.Xr close 2
 attempt until it is able to transmit the data or until it decides it
 is unable to deliver the information (a timeout period, termed the
 linger interval, is specified in the
@@ -201,7 +201,7 @@ is requested).
 If
 .Dv SO_LINGER
 is disabled and a 
-.Xr close
+.Xr close 2
 is issued, the system will process the close in a manner that allows
 the process to continue as quickly as possible.
 .Pp
@@ -215,9 +215,9 @@ With protocols that support out-of-band data, the
 option
 requests that out-of-band data be placed in the normal data input queue
 as received; it will then be accessible with
-.Xr recv
+.Xr recv 2
 or
-.Xr read
+.Xr read 2
 calls without the
 .Dv MSG_OOB
 flag.

lib/libc/sys/intro.2

@@ -497,7 +497,7 @@ as the group,
 but is in a different process group.
 Note that when a process exits, the parent process for its children
 is changed to be
-.Xr init ,
+.Nm init ,
 which is in a separate session.
 Not all members of an orphaned process group are necessarily orphaned
 processes (those whose creating process has exited).

lib/libc/sys/open.2

@@ -136,7 +136,7 @@ When a new file is created it is given the group of the directory
 which contains it.
 .Pp
 The new descriptor is set to remain open across
-.Xr execve
+.Xr execve 2
 system calls; see
 .Xr close 2
 and

lib/libc/sys/rfork.2

@@ -82,7 +82,7 @@ will sleep, if necessary, until required process resources are available.
 .Pp
 .Fn Fork
 can be implemented as a call to
-.Xr rfork "RFFDG|RFPROC"
+.Fn rfork "RFFDG|RFPROC"
 but isn't for backwards compatibility.
 .Sh ERRORS
 .Fn Rfork

lib/libc/sys/stat.2

@@ -256,7 +256,7 @@ depend on the time stamps being contiguous (in calls to
 .Xr symlink 7
 .Sh BUGS
 Applying
-.Xr fstat
+.Fn fstat
 to a socket (and thus to a pipe)
 returns a zeroed buffer,
 except for the blocksize field,

lib/libc/sys/utimes.2

@@ -82,7 +82,7 @@ and the effective user ID of the process does not
 match the owner of the file, and is not the super-user, and write
 access is denied.
 .It Bq Er EFAULT
-.Xr File
+.Fa File
 or
 .Fa times
 points outside the process's allocated address space.

lib/libc/sys/vfork.2

@@ -57,7 +57,7 @@ control until a call to
 .Xr execve 2
 or an exit (either by a call to
 .Xr exit 3
-or abnormally.)
+or abnormally).
 The parent process is suspended while the child is using its resources.
 .Pp
 .Fn Vfork
@@ -66,7 +66,7 @@ the parent's context.
 .Pp
 .Fn Vfork
 can normally be used just like
-.Xr fork .
+.Xr fork 2 .
 It does not work, however, to return while running in the childs context
 from the procedure that called
 .Fn vfork