summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authordkf <donal.k.fellows@manchester.ac.uk>2005-04-06 09:34:00 (GMT)
committerdkf <donal.k.fellows@manchester.ac.uk>2005-04-06 09:34:00 (GMT)
commit19065f3a40a4a114c483f22a1f0854da82b01097 (patch)
treec3d34489d35decc424048c0463d1c1d92687c909
parent099c96d96279845168dd26eb18b74eaae3c3fac5 (diff)
downloadtcl-19065f3a40a4a114c483f22a1f0854da82b01097.zip
tcl-19065f3a40a4a114c483f22a1f0854da82b01097.tar.gz
tcl-19065f3a40a4a114c483f22a1f0854da82b01097.tar.bz2
Change some .TP macros to .IP to work around *roff formatter bugs.
-rw-r--r--ChangeLog6
-rw-r--r--doc/re_syntax.n42
2 files changed, 22 insertions, 26 deletions
diff --git a/ChangeLog b/ChangeLog
index 679e259..20af680 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2005-04-06 Donal K. Fellows <dkf@users.sf.net>
+
+ * doc/re_syntax.n: Change some uses of .TP to .IP to work around
+ bugs in various *roff implementations. Also reworded the atom
+ descriptions slightly.
+
2005-04-05 Don Porter <dgp@users.sourceforge.net>
* generic/tclExecute.c (ExprSrandFunc): Replaced incursions into the
diff --git a/doc/re_syntax.n b/doc/re_syntax.n
index cb5e32a..de584c0 100644
--- a/doc/re_syntax.n
+++ b/doc/re_syntax.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: re_syntax.n,v 1.6 2005/01/05 16:38:54 dkf Exp $
+'\" RCS: @(#) $Id: re_syntax.n,v 1.7 2005/04/06 09:34:04 dkf Exp $
'\"
.so man.macros
.TH re_syntax n "8.1" Tcl "Tcl Built-In Commands"
@@ -48,7 +48,7 @@ an empty branch matches the empty string.
.PP
A quantified atom is an \fIatom\fR possibly followed
by a single \fIquantifier\fR.
-Without a quantifier, it matches a match for the atom.
+Without a quantifier, it matches a single match for the atom.
The quantifiers,
and what a so-quantified atom matches, are:
.RS 2
@@ -85,43 +85,33 @@ permissible values from 0 to 255 inclusive.
.PP
An atom is one of:
.RS 2
-.TP 6
-\fB(\fIre\fB)\fR
-(where \fIre\fR is any regular expression) matches a match for
-\fIre\fR, with the match noted for possible reporting
-.TP
-\fB(?:\fIre\fB)\fR
+.IP \fB(\fIre\fB)\fR 6
+matches a match for \fIre\fR (\fIre\fR is any regular expression) with
+the match noted for possible reporting
+.IP \fB(?:\fIre\fB)\fR
as previous, but does no reporting (a ``non-capturing'' set of
parentheses)
-.TP
-\fB()\fR
+.IP \fB()\fR
matches an empty string, noted for possible reporting
-.TP
-\fB(?:)\fR
+.IP \fB(?:)\fR
matches an empty string, without reporting
-.TP
-\fB[\fIchars\fB]\fR
+.IP \fB[\fIchars\fB]\fR
a \fIbracket expression\fR, matching any one of the \fIchars\fR (see
\fBBRACKET EXPRESSIONS\fR for more detail)
-.TP
-\fB.\fR
+.IP \fB.\fR
matches any single character
-.TP
-\fB\e\fIk\fR
-(where \fIk\fR is a non-alphanumeric character) matches that character
-taken as an ordinary character, e.g. \e\e matches a backslash
+.IP \fB\e\fIk\fR
+matches the non-alphanumeric character \fIk\fR
+taken as an ordinary character, e.g. \fB\e\e\fR matches a backslash
character
-.TP
-\fB\e\fIc\fR
+.IP \fB\e\fIc\fR
where \fIc\fR is alphanumeric (possibly followed by other characters),
an \fIescape\fR (AREs only), see \fBESCAPES\fR below
-.TP
-\fB{\fR
+.IP \fB{\fR
when followed by a character other than a digit, matches the
left-brace character `\fB{\fR'; when followed by a digit, it is the
beginning of a \fIbound\fR (see above)
-.TP
-\fIx\fR
+.IP \fIx\fR
where \fIx\fR is a single character with no other significance,
matches that character.
.RE