1999-08-20 Jeff Hobbs <hobbs@scriptics.com>

	* doc/*: fixed various nroff bugs in man pages [Bug: 2503 2588]

17 files changed, 74 insertions, 74 deletions

diff --git a/doc/CrtChannel.3 b/doc/CrtChannel.3
index dc0f91b..7ee17b9 100644
--- a/doc/CrtChannel.3
+++ b/doc/CrtChannel.3
@@ -4,7 +4,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\"
-'\" RCS: @(#) $Id: CrtChannel.3,v 1.3 1999/04/16 00:46:30 stanton Exp $
+'\" RCS: @(#) $Id: CrtChannel.3,v 1.4 1999/08/21 19:40:47 hobbs Exp $
 .so man.macros
 .TH Tcl_CreateChannel 3 8.0 Tcl "Tcl Library Procedures"
 .BS
@@ -256,7 +256,7 @@ For some device types, the blocking and nonblocking behavior can be
 implemented by the underlying operating system; for other device types, the
 behavior must be emulated in the channel driver.
 
-.SH CLOSEPROC AND CLOSE2PROC
+.SH "CLOSEPROC AND CLOSE2PROC"
 .PP
 The \fIcloseProc\fR field contains the address of a function called by the
 generic layer to clean up driver-related information when the channel is
diff --git a/doc/CrtInterp.3 b/doc/CrtInterp.3
index 360ff77..c8e69ef 100644
--- a/doc/CrtInterp.3
+++ b/doc/CrtInterp.3
@@ -5,7 +5,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: CrtInterp.3,v 1.3 1999/06/24 21:15:13 jpeek Exp $
+'\" RCS: @(#) $Id: CrtInterp.3,v 1.4 1999/08/21 19:40:47 hobbs Exp $
 '\" 
 .so man.macros
 .TH Tcl_CreateInterp 3 7.5 Tcl "Tcl Library Procedures"
@@ -124,8 +124,8 @@ All uses of interpreters in Tcl and Tk have already been protected.
 Extension writers should ensure that their code also properly protects any
 additional interpreters used, as described above.
 
-.SH KEYWORDS
-command, create, delete, interpreter
-
 .SH "SEE ALSO"
 Tcl_Preserve(3), Tcl_Release(3)
+
+.SH KEYWORDS
+command, create, delete, interpreter
diff --git a/doc/CrtSlave.3 b/doc/CrtSlave.3
index 940ae57..bad9e81 100644
--- a/doc/CrtSlave.3
+++ b/doc/CrtSlave.3
@@ -4,7 +4,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: CrtSlave.3,v 1.2 1998/09/14 18:39:47 stanton Exp $
+'\" RCS: @(#) $Id: CrtSlave.3,v 1.3 1999/08/21 19:40:47 hobbs Exp $
 '\" 
 .so man.macros
 .TH Tcl_CreateSlave 3 7.6 Tcl "Tcl Library Procedures"
@@ -170,7 +170,7 @@ created by \fBTcl_CreateSlave\fR) between \fIslaveInterp\fR and
 \fItargetInterp\fR. Any two interpreters can be used, without any
 restrictions on how they are related.
 .PP
-\fBTcl_CreateAliasObj\fR is similar to \fBTcl_CreateAliasObj\fR except 
+\fBTcl_CreateAliasObj\fR is similar to \fBTcl_CreateAlias\fR except 
 that it takes a vector of objects to pass as additional arguments instead
 of a vector of strings.
 .VE
diff --git a/doc/Encoding.3 b/doc/Encoding.3
index 020edf7..22c6cf4 100644
--- a/doc/Encoding.3
+++ b/doc/Encoding.3
@@ -4,7 +4,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: Encoding.3,v 1.5 1999/07/29 23:17:49 redman Exp $
+'\" RCS: @(#) $Id: Encoding.3,v 1.6 1999/08/21 19:40:47 hobbs Exp $
 '\" 
 .so man.macros
 .TH Tcl_GetEncoding 3 "8.1" Tcl "Tcl Library Procedures"
@@ -382,7 +382,7 @@ files.  If this value is not NULL, the \fBTclpInitLibraryPath\fR routine
 appends the path to the head of the search path, and uses this path as
 the first place to look into when trying to locate the encoding file.
 
-.SH ENCODING FILES
+.SH "ENCODING FILES"
 Space would prohibit precompiling into Tcl every possible encoding
 algorithm, so many encodings are stored on disk as dynamically-loadable
 encoding files.  This behavior also allows the user to create additional
diff --git a/doc/ListObj.3 b/doc/ListObj.3
index c36bdfe..5a88c3d 100644
--- a/doc/ListObj.3
+++ b/doc/ListObj.3
@@ -4,7 +4,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: ListObj.3,v 1.2 1998/09/14 18:39:49 stanton Exp $
+'\" RCS: @(#) $Id: ListObj.3,v 1.3 1999/08/21 19:40:47 hobbs Exp $
 '\" 
 .so man.macros
 .TH Tcl_ListObj 3 8.0 Tcl "Tcl Library Procedures"
@@ -74,9 +74,7 @@ and \fBTcl_ListObjReplace\fR will insert into \fIlistPtr\fR.
 For \fBTcl_SetListObj\fR,
 the number of Tcl objects to insert into \fIobjPtr\fR.
 .VS
-.TP 
-Tcl_Obj	*CONST \fIobjv\fR[]	(in)
-.
+.AP Tcl_Obj	"*CONST\ objv[]" in
 An array of pointers to objects.
 \fBTcl_NewListObj\fR will insert these objects into a new list object
 and \fBTcl_ListObjReplace\fR will insert them into an existing \fIlistPtr\fR.
diff --git a/doc/OpenFileChnl.3 b/doc/OpenFileChnl.3
index 42d3d0e..d0d751a 100644
--- a/doc/OpenFileChnl.3
+++ b/doc/OpenFileChnl.3
@@ -4,7 +4,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\"
-'\" RCS: @(#) $Id: OpenFileChnl.3,v 1.6 1999/08/19 02:58:34 hobbs Exp $
+'\" RCS: @(#) $Id: OpenFileChnl.3,v 1.7 1999/08/21 19:40:47 hobbs Exp $
 .so man.macros
 .TH Tcl_OpenFileChannel 3 8.3 Tcl "Tcl Library Procedures"
 .BS
@@ -362,7 +362,7 @@ when all calls to \fBTcl_RegisterChannel\fR have been matched by
 corresponding calls to \fBTcl_UnregisterChannel\fR.
 
 .VS 8.1 br
-.SH TCL_READCHARS AND TCL_READ
+.SH "TCL_READCHARS AND TCL_READ"
 .PP
 \fBTcl_ReadChars\fR consumes bytes from \fIchannel\fR, converting the bytes
 to UTF-8 based on the channel's encoding and storing the produced data in 
@@ -411,7 +411,7 @@ of \fBTcl_Read\fR is the number of bytes, up to \fItoRead\fR, written in
 Its contents are valid from the zeroth position up to and excluding the
 position indicated by the return value.  
 
-.SH TCL_GETSOBJ AND TCL_GETS
+.SH "TCL_GETSOBJ AND TCL_GETS"
 .PP
 \fBTcl_GetsObj\fR consumes bytes from \fIchannel\fR, converting the bytes to
 UTF-8 based on the channel's encoding, until a full line of input has been
@@ -438,7 +438,7 @@ of input unavailability.
 characters are appended to the appended to the dynamic string given by
 \fIdsPtr\fR rather than a Tcl object.
 
-.SH TCL_WRITECHARS, TCL_WRITEOBJ, AND TCL_WRITE
+.SH "TCL_WRITECHARS, TCL_WRITEOBJ, AND TCL_WRITE"
 .PP
 \fBTcl_WriteChars\fR accepts \fIbytesToWrite\fR bytes of character data at
 \fIcharBuf\fR.  The UTF-8 characters in the buffer are converted to the
diff --git a/doc/ParseCmd.3 b/doc/ParseCmd.3
index 2a180a6..61759bb 100644
--- a/doc/ParseCmd.3
+++ b/doc/ParseCmd.3
@@ -4,7 +4,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: ParseCmd.3,v 1.2 1999/04/16 00:46:32 stanton Exp $
+'\" RCS: @(#) $Id: ParseCmd.3,v 1.3 1999/08/21 19:40:47 hobbs Exp $
 '\" 
 .so man.macros
 .TH Tcl_ParseCommand 3 8.1 Tcl "Tcl Library Procedures"
@@ -179,7 +179,7 @@ If an error occurs while evaluating the tokens (such as a reference to
 a non-existent variable) then the return value is NULL and an error
 message is left in \fIinterp\fR's result.
 
-.SH  TCL_PARSE STRUCTURE
+.SH "TCL_PARSE STRUCTURE"
 .PP
 \fBTcl_ParseCommand\fR, \fBTcl_ParseExpr\fR, \fBTcl_ParseBraces\fR,
 \fBTcl_ParseQuotedString\fR, and \fBTcl_ParseVarName\fR
diff --git a/doc/SetResult.3 b/doc/SetResult.3
index 1fed065..c8b8a87 100644
--- a/doc/SetResult.3
+++ b/doc/SetResult.3
@@ -5,7 +5,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: SetResult.3,v 1.3 1999/03/10 05:52:45 stanton Exp $
+'\" RCS: @(#) $Id: SetResult.3,v 1.4 1999/08/21 19:40:47 hobbs Exp $
 '\" 
 .so man.macros
 .TH Tcl_SetResult 3 7.5 Tcl "Tcl Library Procedures"
@@ -117,7 +117,7 @@ and the result is left as a empty string.
 \fBTcl_AddErrorInfo\fR, \fBTcl_AddObjErrorInfo\fR,
 and \fBTcl_SetErrorCode\fR.
 
-.SH OLD STRING PROCEDURES
+.SH "OLD STRING PROCEDURES"
 .PP
 Use of the following procedures is deprecated
 since they manipulate the Tcl result as a string.
@@ -170,7 +170,7 @@ change \fIinterp->result\fR or clear error state.
 \fBTcl_FreeResult\fR is most commonly used when a procedure
 is about to replace one result value with another.
 
-.SH DIRECT ACCESS TO INTERP->RESULT IS DEPRECATED
+.SH "DIRECT ACCESS TO INTERP->RESULT IS DEPRECATED"
 .PP
 It used to be legal for programs to
 directly read and write \fIinterp->result\fR
@@ -181,7 +181,7 @@ Programs should always read the result
 using the procedures \fBTcl_GetObjResult\fR or \fBTcl_GetStringResult\fR,
 and write the result using \fBTcl_SetObjResult\fR or \fBTcl_SetResult\fR.
 
-.SH THE TCL_FREEPROC ARGUMENT TO TCL_SETRESULT
+.SH "THE TCL_FREEPROC ARGUMENT TO TCL_SETRESULT"
 .PP
 \fBTcl_SetResult\fR's \fIfreeProc\fR argument specifies how 
 the Tcl system is to manage the storage for the \fIstring\fR argument.
diff --git a/doc/Thread.3 b/doc/Thread.3
index e31860e..9e473b8 100644
--- a/doc/Thread.3
+++ b/doc/Thread.3
@@ -5,7 +5,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: Thread.3,v 1.6 1999/05/06 19:14:41 stanton Exp $
+'\" RCS: @(#) $Id: Thread.3,v 1.7 1999/08/21 19:40:48 hobbs Exp $
 '\" 
 .so man.macros
 .TH Threads 3 "8.1" Tcl "Tcl Library Procedures"
@@ -124,7 +124,7 @@ upon first use.
 The mutexes and condition variables are
 cleaned up by process exit handlers.  Thread local storage is
 reclaimed during \fBTcl_FinalizeThread\fR.
-.SH CREATING THREADS
+.SH "CREATING THREADS"
 The API to create threads is not finalized at this time.
 There are private facilities to create threads that contain a new
 Tcl interpreter, and to send scripts among threads.
diff --git a/doc/WrongNumArgs.3 b/doc/WrongNumArgs.3
index 30157d9..8cda3f4 100644
--- a/doc/WrongNumArgs.3
+++ b/doc/WrongNumArgs.3
@@ -4,7 +4,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: WrongNumArgs.3,v 1.2 1998/09/14 18:39:51 stanton Exp $
+'\" RCS: @(#) $Id: WrongNumArgs.3,v 1.3 1999/08/21 19:40:48 hobbs Exp $
 '\" 
 .so man.macros
 .TH Tcl_WrongNumArgs 3 8.0 Tcl "Tcl Library Procedures"
@@ -24,8 +24,7 @@ in its result object.
 .AP int objc in
 Number of leading arguments from \fIobjv\fR to include in error
 message.
-.TP
-Tcl_Obj	*CONST \fIobjv\fR[]	(in)
+.AP Tcl_Obj "*CONST\ objv[]" in
 Arguments to command that had the wrong number of arguments.
 .AP char *message in
 Additional error information to print after leading arguments
diff --git a/doc/dde.n b/doc/dde.n
index 1406f9d..2ce319c 100644
--- a/doc/dde.n
+++ b/doc/dde.n
@@ -4,7 +4,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: dde.n,v 1.3 1999/06/26 22:41:52 redman Exp $
+'\" RCS: @(#) $Id: dde.n,v 1.4 1999/08/21 19:40:48 hobbs Exp $
 '\" 
 .so man.macros
 .TH dde n 8.1 Tcl "Tcl Built-In Commands"
@@ -48,7 +48,7 @@ set of commands.
 .TP
 \fBdde servername \fR?\fItopic\fR?
 \fBdde servername\fR registers the interpreter as a DDE server with
-the service name TclEval and the topic name specified byt \fItopic\fR.
+the service name \fBTclEval\fR and the topic name specified by \fItopic\fR.
 If no \fItopic\fR is given, \fBdde servername\fR returns the name
 of the current topic or the empty string if it is not registered as a service.
 .TP
@@ -92,10 +92,12 @@ is returned.
 \fBdde eval \fItopic cmd \fR?\fIarg arg ...\fR?
 \fBdde eval\fR evaluates a command and its arguments using the
 interpreter specified by \fItopic\fR. The DDE service must be the
-"TclEval" service.  This command can be used to replace send on Windows.
+\fBTclEval\fR service.  This command can be used to replace send on
+Windows.
 .SH "DDE AND TCL"
-A Tcl interpreter always has a service name of "TclEval". Each
-different interp of all running Tcl applications should a unique
+A Tcl interpreter always has a service name of \fBTclEval\fR.  Each
+different interpreter of all running Tcl applications must be
+given a unique
 name specified by \fBdde servername\fR. Each interp is available as a
 DDE topic only if the \fBdde servername\fR command was used to set the
 name of the topic for each interp. So a \fBdde services TclEval {}\fR
@@ -106,11 +108,11 @@ When Tcl processes a \fBdde execute\fR command, the data for the
 execute is run as a script in the interp named by the topic of the
 \fBdde execute\fR command.
 .PP
-When Tcl processes a \fBdde request\fR command, it returns the value of
-the variable given in the dde command in the context of the interp
-named by the dde topic. Tcl reserves the variable "$TCLEVAL$EXECUTE$RESULT"
-for internal use, and \fBdde request\fR commands for that variable
-will give unpredictable results.
+When Tcl processes a \fBdde request\fR command, it returns the value of the
+variable given in the dde command in the context of the interp named by the
+dde topic. Tcl reserves the variable \fB$TCLEVAL$EXECUTE$RESULT\fR for
+internal use, and \fBdde request\fR commands for that variable will give
+unpredictable results.
 .PP
 An external application which wishes to run a script in Tcl should have
 that script store its result in a variable, run the \fBdde execute\fR
@@ -124,8 +126,7 @@ without adding the \fB&\fR to place the process in the background).
 If for any reason the event queue is not flushed, DDE commands may
 hang until the event queue is flushed.  This can create a deadlock
 situation.
-.SH KEYWORDS
-application, dde, name, remote execution
 .SH "SEE ALSO"
 tk, winfo, send
-
+.SH KEYWORDS
+application, dde, name, remote execution
diff --git a/doc/filename.n b/doc/filename.n
index dd82a86..9d36214 100644
--- a/doc/filename.n
+++ b/doc/filename.n
@@ -4,7 +4,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: filename.n,v 1.2 1998/09/14 18:39:52 stanton Exp $
+'\" RCS: @(#) $Id: filename.n,v 1.3 1999/08/21 19:40:48 hobbs Exp $
 '\" 
 .so man.macros
 .TH filename n 7.5 Tcl "Tcl Built-In Commands"
@@ -26,7 +26,7 @@ Instead, portable scripts must use the \fBfile split\fR and \fBfile
 join\fR commands to manipulate file names (see the \fBfile\fR manual
 entry for more details).
 
-.SH PATH TYPES
+.SH "PATH TYPES"
 .PP
 File names are grouped into three general types based on the starting point
 for the path used to specify the file: absolute, relative, and
@@ -39,7 +39,7 @@ current volume, or relative to the current directory of the specified
 volume.  The \fBfile pathtype\fR command can be used to determine the
 type of a given path.
 
-.SH PATH SYNTAX
+.SH "PATH SYNTAX"
 .PP
 The rules for native names depend on the value reported in the Tcl
 array element \fBtcl_platform(platform)\fR:
@@ -163,7 +163,7 @@ Volume-relative path to a file \fBfoo\fR in the root directory of the current
 volume.
 .RE
 
-.SH TILDE SUBSTITUTION
+.SH "TILDE SUBSTITUTION"
 .PP
 In addition to the file name rules described above, Tcl also supports
 \fIcsh\fR-style tilde substitution.  If a file name starts with a
@@ -181,7 +181,7 @@ use a tilde followed by a user name will generate an error.  File
 names that have a tilde without a user name will be substituted using
 the \fB$HOME\fR environment variable, just like for Unix.
 
-.SH PORTABILITY ISSUES
+.SH "PORTABILITY ISSUES"
 .PP
 Not all file systems are case sensitive, so scripts should avoid code
 that depends on the case of characters in a file name.  In addition,
diff --git a/doc/glob.n b/doc/glob.n
index 47c4e50..7857868 100644
--- a/doc/glob.n
+++ b/doc/glob.n
@@ -5,7 +5,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: glob.n,v 1.3 1999/04/16 00:46:35 stanton Exp $
+'\" RCS: @(#) $Id: glob.n,v 1.4 1999/08/21 19:40:48 hobbs Exp $
 '\" 
 .so man.macros
 .TH glob n 8.1 Tcl "Tcl Built-In Commands"
@@ -71,7 +71,7 @@ Second, \fBglob\fR only returns the names of files that actually
 exist;  in csh no check for existence is made unless a pattern
 contains a ?, *, or [] construct.
 
-.SH PORTABILITY ISSUES
+.SH "PORTABILITY ISSUES"
 .PP
 Unlike other Tcl commands that will accept both network and native
 style names (see the \fBfilename\fR manual entry for details on how
diff --git a/doc/interp.n b/doc/interp.n
index d714f4d..31c7ec0 100644
--- a/doc/interp.n
+++ b/doc/interp.n
@@ -4,7 +4,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: interp.n,v 1.3 1998/09/14 18:39:53 stanton Exp $
+'\" RCS: @(#) $Id: interp.n,v 1.4 1999/08/21 19:40:48 hobbs Exp $
 '\" 
 .so man.macros
 .TH interp n 7.6 Tcl "Tcl Built-In Commands"
@@ -375,21 +375,23 @@ A safe interpreter is created with exactly the following set of
 built-in commands:
 .DS
 .ta 1.2i 2.4i 3.6i
-\fBafter	append	array	break
-case	catch	clock	close
-concat	continue	eof	error
-eval	expr	fblocked	fileevent
-flush	for	foreach	format
-gets	global	history	if
-incr	info	interp	join
-lappend	lindex	linsert	list
-llength	lower	lrange	lreplace
-lsearch	lsort	package	pid
-proc	puts	read	rename
-return	scan	seek	set
-split	string	subst	switch
-tell	trace	unset	update
-uplevel	upvar	vwait	while\fR
+\fBafter	append	array	binary
+break	case	catch	clock
+close	concat	continue	eof
+error	eval	expr	fblocked
+fcopy	fileevent	flush	for
+foreach	format	gets	global
+history	if	incr	info
+interp	join	lappend	lindex
+linsert	list	llength	lower
+lrange	lreplace	lsearch	lsort
+namespace	package	pid	proc
+puts	read	regexp	regsub
+rename	return	scan	seek
+set	split	string	subst
+switch	tell	trace	unset
+update	uplevel	upvar	variable
+vwait	while\fR
 .DE
 .VS ""  BR
 The following commands are hidden by \fBinterp create\fR when it
diff --git a/doc/msgcat.n b/doc/msgcat.n
index 0ddd7ce..02f4085 100644
--- a/doc/msgcat.n
+++ b/doc/msgcat.n
@@ -198,11 +198,11 @@ format "In location %2\\\\$s we produced %1\\\\$d units" $num $city
 Similarly, positional parameters can be used with \fBscan\fR to
 extract values from internationalized strings.
 
-.SH "SEE ALSO"
-format(n), scan(n), namespace(n), package(n)
-
 .SH CREDITS
 .PP
 The message catalog code was developed by Mark Harrison.
+
+.SH "SEE ALSO"
+format(n), scan(n), namespace(n), package(n)
 .SH KEYWORDS
 internationalization, i18n, localization, l10n, message, text, translation
diff --git a/doc/resource.n b/doc/resource.n
index 428591b..292d62d 100644
--- a/doc/resource.n
+++ b/doc/resource.n
@@ -3,7 +3,7 @@
 '\"
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
-'\" RCS: @(#) $Id: resource.n,v 1.4 1999/04/16 00:46:36 stanton Exp $
+'\" RCS: @(#) $Id: resource.n,v 1.5 1999/08/21 19:40:48 hobbs Exp $
 '\" 
 .so man.macros
 .TH resource n 8.0 Tcl "Tcl Built-In Commands"
@@ -145,11 +145,11 @@ always searched or returned in preference to numbers.  For example,
 the \fBresource list\fR command will return names if they exist or
 numbers if the name is NULL.
 
-.SH "SEE ALSO"
-open
-
 .SH "PORTABILITY ISSUES"
 The resource command is only available on Macintosh.
 
+.SH "SEE ALSO"
+open
+
 .SH KEYWORDS
 open, resource
diff --git a/doc/socket.n b/doc/socket.n
index d73883f..8c269db 100644
--- a/doc/socket.n
+++ b/doc/socket.n
@@ -5,7 +5,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\"
-'\" RCS: @(#) $Id: socket.n,v 1.4 1999/04/16 00:46:36 stanton Exp $
+'\" RCS: @(#) $Id: socket.n,v 1.5 1999/08/21 19:40:48 hobbs Exp $
 .so man.macros
 .TH socket n 8.0 Tcl "Tcl Built-In Commands"
 .BS
@@ -101,7 +101,7 @@ event loop, for example by invoking the \fBvwait\fR command or
 calling the C procedure \fBTcl_DoOneEvent\fR, then no connections
 will be accepted.
 
-.SH CONFIGURATION OPTIONS
+.SH "CONFIGURATION OPTIONS"
 The \fBfconfigure\fR command can be used to query several readonly
 configuration options for socket channels:
 .VS 8.0.5