Fix markup errors.

Consistency: Make sure "KEYWORDS" section appears after "SEE ALSO".

11 files changed, 31 insertions, 28 deletions

diff --git a/ChangeLog b/ChangeLog
index 0b65cc1..a7b61dd 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,11 @@
+2007-12-10  Joe English  <jenglish@users.sourceforge.net>
+
+	* doc/string.n, doc/UniCharIsAlpha.3: Fix markup errors.
+	* doc/CrtCommand.3, doc/CrtMathFnc.3, doc/FileSystem.3,
+	doc/GetStdChan.3, doc/OpenFileChnl.3, doc/SetChanErr.3,
+	doc/eval.n, doc/filename.n: Consistency: Move "KEYWORDS"
+	section after "SEE ALSO".
+
 2007-12-10  Daniel Steffen  <das@users.sourceforge.net>
 
 	* tools/genStubs.tcl:		fix numerous issues handling 'macosx',
diff --git a/doc/CrtCommand.3 b/doc/CrtCommand.3
index c4e042a..ac7a151 100644
--- a/doc/CrtCommand.3
+++ b/doc/CrtCommand.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: CrtCommand.3,v 1.12 2005/05/10 18:33:54 kennykb Exp $
+'\" RCS: @(#) $Id: CrtCommand.3,v 1.13 2007/12/10 16:20:10 jenglish Exp $
 '\" 
 .so man.macros
 .TH Tcl_CreateCommand 3 "" Tcl "Tcl Library Procedures"
@@ -137,7 +137,6 @@ typedef void Tcl_CmdDeleteProc(
 .CE
 The \fIclientData\fR argument will be the same as the \fIclientData\fR
 argument passed to \fBTcl_CreateCommand\fR.
-.PP
 
 .SH "SEE ALSO"
 Tcl_CreateObjCommand, Tcl_DeleteCommand, Tcl_GetCommandInfo, Tcl_SetCommandInfo, Tcl_GetCommandName, Tcl_SetObjResult
diff --git a/doc/CrtMathFnc.3 b/doc/CrtMathFnc.3
index 1ade285..82ba388 100644
--- a/doc/CrtMathFnc.3
+++ b/doc/CrtMathFnc.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: CrtMathFnc.3,v 1.15 2007/10/28 14:17:38 dkf Exp $
+'\" RCS: @(#) $Id: CrtMathFnc.3,v 1.16 2007/12/10 16:20:10 jenglish Exp $
 '\" 
 .so man.macros
 .TH Tcl_CreateMathFunc 3 8.4 Tcl "Tcl Library Procedures"
@@ -151,8 +151,8 @@ pointed to by \fIargTypesPointer\fR.
 the math functions defined in the interpreter whose name matches
 \fIpattern\fR.  The returned object has a reference count of zero.
 
-.SH KEYWORDS
-expression, mathematical function
-
 .SH "SEE ALSO"
 expr(n), info(n), Tcl_CreateObjCommand(3), Tcl_Free(3), Tcl_NewListObj(3)
+
+.SH KEYWORDS
+expression, mathematical function
diff --git a/doc/FileSystem.3 b/doc/FileSystem.3
index 3498a9b..74b5045 100644
--- a/doc/FileSystem.3
+++ b/doc/FileSystem.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: FileSystem.3,v 1.60 2007/10/28 14:17:38 dkf Exp $
+'\" RCS: @(#) $Id: FileSystem.3,v 1.61 2007/12/10 16:20:10 jenglish Exp $
 '\" 
 .so man.macros
 .TH Filesystem 3 8.4 Tcl "Tcl Library Procedures"
@@ -1550,8 +1550,7 @@ typedef int Tcl_FSChdirProc(
 The \fBTcl_FSChdirProc\fR changes the applications current working
 directory to the value specified in \fIpathPtr\fR. The function returns
 -1 on error or 0 on success.
-
-.SH KEYWORDS
-stat, access, filesystem, vfs, virtual
 .SH "SEE ALSO"
 cd(n), file(n), load(n), open(n), pwd(n), unload(n)
+.SH KEYWORDS
+stat, access, filesystem, vfs, virtual
diff --git a/doc/GetStdChan.3 b/doc/GetStdChan.3
index ed6adde..9376728 100644
--- a/doc/GetStdChan.3
+++ b/doc/GetStdChan.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: GetStdChan.3,v 1.6 2006/06/06 20:06:57 dgp Exp $
+'\" RCS: @(#) $Id: GetStdChan.3,v 1.7 2007/12/10 16:20:28 jenglish Exp $
 '\" 
 .so man.macros
 .TH Tcl_GetStdChannel 3 7.5 Tcl "Tcl Library Procedures"
@@ -78,7 +78,6 @@ standard error being last.
 .PP
 See \fBTcl_StandardChannels\fR for a general treatise about standard
 channels and the behaviour of the Tcl library with regard to them.
-.PP
 
 .SH "SEE ALSO"
 Tcl_Close(3), Tcl_CreateChannel(3), Tcl_Main(3), tclsh(1)
diff --git a/doc/OpenFileChnl.3 b/doc/OpenFileChnl.3
index 83e5e05..85b18b2 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.34 2007/10/29 11:28:50 dkf Exp $
+'\" RCS: @(#) $Id: OpenFileChnl.3,v 1.35 2007/12/10 16:20:28 jenglish Exp $
 .so man.macros
 .TH Tcl_OpenFileChannel 3 8.3 Tcl "Tcl Library Procedures"
 .BS
@@ -247,8 +247,6 @@ leaves an error message in \fIinterp\fR's result after any error.
 As of Tcl 8.4, the object-based API \fBTcl_FSOpenFileChannel\fR should 
 be used in preference to \fBTcl_OpenFileChannel\fR wherever possible.
 .PP
-
-.PP
 The newly created channel is not registered in the supplied interpreter; to
 register it, use \fBTcl_RegisterChannel\fR, described below.
 If one of the standard channels, \fBstdin, stdout\fR or \fBstderr\fR was
diff --git a/doc/SetChanErr.3 b/doc/SetChanErr.3
index 11b32ea..fa8eb58 100644
--- a/doc/SetChanErr.3
+++ b/doc/SetChanErr.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: SetChanErr.3,v 1.2 2006/04/12 02:35:06 das Exp $
+'\" RCS: @(#) $Id: SetChanErr.3,v 1.3 2007/12/10 16:20:28 jenglish Exp $
 .so man.macros
 .TH Tcl_SetChannelError 3 8.5 Tcl "Tcl Library Procedures"
 .BS
@@ -146,7 +146,6 @@ leave all their error information in the interpreter result.
 .IP \fBTcl_Close\fR
 .IP \fBTcl_UnregisterChannel\fR
 .IP \fBTcl_UnstackChannel\fR
-.PP
 
 .SH "SEE ALSO"
 Tcl_Close(3), Tcl_OpenFileChannel(3), Tcl_SetErrno(3)
diff --git a/doc/UniCharIsAlpha.3 b/doc/UniCharIsAlpha.3
index a53cacf..5e947c6 100644
--- a/doc/UniCharIsAlpha.3
+++ b/doc/UniCharIsAlpha.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: UniCharIsAlpha.3,v 1.3 2004/10/07 14:44:35 dkf Exp $
+'\" RCS: @(#) $Id: UniCharIsAlpha.3,v 1.4 2007/12/10 16:20:28 jenglish Exp $
 '\" 
 .so man.macros
 .TH Tcl_UniCharIsAlpha 3 "8.1" Tcl "Tcl Library Procedures"
@@ -64,7 +64,7 @@ with the various routines.
 Note: A Tcl_UniChar is a Unicode character represented as an unsigned,
 fixed-size quantity.
 
-.SH CHARACTER CLASSES
+.SH "CHARACTER CLASSES"
 .PP
 \fBTcl_UniCharIsAlnum\fR tests if the character is an alphanumeric Unicode character.
 .PP
diff --git a/doc/eval.n b/doc/eval.n
index 139b65d..5bd65b2 100644
--- a/doc/eval.n
+++ b/doc/eval.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: eval.n,v 1.8 2007/02/18 18:42:54 dkf Exp $
+'\" RCS: @(#) $Id: eval.n,v 1.9 2007/12/10 16:20:28 jenglish Exp $
 '\" 
 .so man.macros
 .TH eval n "" Tcl "Tcl Built-In Commands"
@@ -77,8 +77,8 @@ set var [linsert $var 0 {*}$args]
 .CE
 .VE 8.5
 
-.SH KEYWORDS
-concatenate, evaluate, script
-
 .SH "SEE ALSO"
 catch(n), concat(n), error(n), interp(n), list(n), namespace(n), subst(n), tclvars(n), uplevel(n)
+
+.SH KEYWORDS
+concatenate, evaluate, script
diff --git a/doc/filename.n b/doc/filename.n
index 2c2c68d..886691e 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.18 2007/10/29 01:42:18 dkf Exp $
+'\" RCS: @(#) $Id: filename.n,v 1.19 2007/12/10 16:20:28 jenglish Exp $
 '\" 
 .so man.macros
 .TH filename n 7.5 Tcl "Tcl Built-In Commands"
@@ -173,8 +173,8 @@ Furthermore, a file name consisting only of dots
 or dots with trailing characters
 .QW .....abc
 is illegal.
+.SH "SEE ALSO"
+file(n), glob(n)
 .SH KEYWORDS
 current directory, absolute file name, relative file name,
 volume-relative file name, portability
-.SH "SEE ALSO"
-file(n), glob(n)
diff --git a/doc/string.n b/doc/string.n
index 4e769eb..fb2e027 100644
--- a/doc/string.n
+++ b/doc/string.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: string.n,v 1.41 2007/10/29 11:28:50 dkf Exp $
+.\" RCS: @(#) $Id: string.n,v 1.42 2007/12/10 16:20:28 jenglish Exp $
 .\" 
 .so man.macros
 .TH string n 8.1 Tcl "Tcl Built-In Commands"
@@ -272,7 +272,8 @@ when matching case-sensitively (since
 falls between the
 .QW Z
 and
-.QW a ), with \fB\-nocase\fR this is considered like {[A\-Za\-z]} (and
+.QW a ),
+with \fB\-nocase\fR this is considered like {[A\-Za\-z]} (and
 probably what was meant in the first place).
 .IP \fB\e\fIx\fR 10
 Matches the single character \fIx\fR.  This provides a way of avoiding