Document %z and %t size modifiers for 'format' and 'scan'

2 files changed, 23 insertions, 21 deletions

diff --git a/doc/format.n b/doc/format.n
index 78fd352..f762f7a 100644
--- a/doc/format.n
+++ b/doc/format.n
@@ -14,7 +14,6 @@ format \- Format a string in the style of sprintf
 .SH SYNOPSIS
 \fBformat \fIformatString \fR?\fIarg arg ...\fR?
 .BE
-
 .SH INTRODUCTION
 .PP
 This command generates a formatted string in a fashion similar to the
@@ -127,15 +126,15 @@ then the next argument to the \fBformat\fR command determines the precision;
 it must be a numeric string.
 .SS "OPTIONAL SIZE MODIFIER"
 .PP
-The fifth part of a conversion specifier is a size modifier,
-which must be \fBll\fR, \fBh\fR, \fBl\fR, \fBz\fR, \fBt\fR, or \fBL\fR.
-If it is \fBll\fR it specifies that an integer value is taken
-without truncation for conversion to a formatted substring.
-If it is \fBh\fR it specifies that an integer value is
-truncated to a 16-bit range before converting.  This option is rarely useful.
-If it is \fBl\fR (or \fBj\fR or \fBq\fR) it specifies that the integer value
-is truncated to the same range as that produced by the \fBwide()\fR
-function of the \fBexpr\fR command (at least a 64-bit range).
+The fifth part of a conversion specifier is a size modifier, which must
+be \fBh\fR, \fBl\fR, \fBq\fR, \fBj\fR, \fBz\fR, \fBt\fR,
+\fBll\fR, or \fBL\fR.  If it is \fBll\fR it specifies that an integer
+value is taken without truncation for conversion to a formatted
+substring.  If it is \fBh\fR it specifies that an integer value is
+truncated to a 16-bit range before converting.  This option is rarely
+useful.  If it is \fBl\fR (or \fBj\fR or \fBq\fR) it specifies that the
+integer value is truncated to the same range as that produced by the
+\fBwide()\fR function of the \fBexpr\fR command (at least a 64-bit range).
 If it is \fBz\fR or \fBt\fR it specifies that the integer value is
 truncated to the range determined by the value of the \fBpointerSize\fR
 element of the \fBtcl_platform\fR array.
diff --git a/doc/scan.n b/doc/scan.n
index 46bfb91..a64afcc 100644
--- a/doc/scan.n
+++ b/doc/scan.n
@@ -73,17 +73,20 @@ The size modifier field is used only when scanning a substring into
 one of Tcl's integer values.  The size modifier field dictates the
 integer range acceptable to be stored in a variable, or, for the inline
 case, in a position in the result list.
-The syntactically valid values for the size modifier are \fBh\fR, \fBL\fR,
-\fBl\fR, \fBz\fR, \fBt\fR, and \fBll\fR.  The \fBh\fR size
-modifier value is equivalent
-to the absence of a size modifier in the the conversion specifier.
-Either one indicates the integer range to be stored is limited to the range
-determined by the value of the \fBwordSize\fR element of the \fBtcl_platform\fR
-array).  The \fBL\fR, \fBq\fR or \fBj\fR size modifiers are equivalent to the
-\fBl\fR size modifier. Either of them indicates the integer range to be stored is
-limited to the same range produced by the \fBwide()\fR function of
-the \fBexpr\fR command.  The \fBll\fR size modifier indicates that
-the integer range to be stored is unlimited.
+The syntactically valid values for the size modifier are \fBh\fR,
+\fBl\fR, \fBq\fR, \fBj\fR, \fBz\fR, \fBt\fR, \fBll\fR, and \fBL\fR.
+The \fBh\fR size modifier value is equivalent to the absence of a size
+modifier in the the conversion specifier.  Either one indicates the
+integer range to be stored is limited to the range determined by the
+value of the \fBwordSize\fR element of the \fBtcl_platform\fR array).
+The \fBL\fR, \fBq\fR or \fBj\fR size modifiers are equivalent to the
+\fBl\fR size modifier. Either of them indicates the integer range to
+be stored is limited to the same range produced by the \fBwide()\fR
+function of the \fBexpr\fR command.  The \fBll\fR size modifier
+indicates that the integer range to be stored is unlimited.
+The \fBz\fR and \fBt\fR modifiers indicate the integer range to be
+the same as for either \fBh\fR or \fBl\fR, depending on the
+value of the \fBpointerSize\fR element of the \fBtcl_platform\fR array.
 .SS "MANDATORY CONVERSION CHARACTER"
 .PP
 The following conversion characters are supported: