summaryrefslogtreecommitdiffstats
path: root/doc/expr.n
diff options
context:
space:
mode:
authordkf <donal.k.fellows@manchester.ac.uk>2007-10-30 14:21:51 (GMT)
committerdkf <donal.k.fellows@manchester.ac.uk>2007-10-30 14:21:51 (GMT)
commitb8cc0555e4a6f0b2c271a0ac7e79b336600ab693 (patch)
tree77936c7b4f5275df9c18cb6d17ea16a11b1e4da6 /doc/expr.n
parent225f9b14ff3fc2dc6fde1d46866e63e00c2c6690 (diff)
downloadtcl-b8cc0555e4a6f0b2c271a0ac7e79b336600ab693.zip
tcl-b8cc0555e4a6f0b2c271a0ac7e79b336600ab693.tar.gz
tcl-b8cc0555e4a6f0b2c271a0ac7e79b336600ab693.tar.bz2
Clear up what's going on a bit more. [Bug 1811803]
Diffstat (limited to 'doc/expr.n')
-rw-r--r--doc/expr.n28
1 files changed, 18 insertions, 10 deletions
diff --git a/doc/expr.n b/doc/expr.n
index a64431c..17b83e6 100644
--- a/doc/expr.n
+++ b/doc/expr.n
@@ -6,7 +6,7 @@
'\" See the file "license.terms" for information on usage and redistribution
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
'\"
-'\" RCS: @(#) $Id: expr.n,v 1.29 2007/10/29 11:28:50 dkf Exp $
+'\" RCS: @(#) $Id: expr.n,v 1.30 2007/10/30 14:21:52 dkf Exp $
'\"
.so man.macros
.TH expr n 8.5 Tcl "Tcl Built-In Commands"
@@ -17,7 +17,6 @@ expr \- Evaluate an expression
.SH SYNOPSIS
\fBexpr \fIarg \fR?\fIarg arg ...\fR?
.BE
-
.SH DESCRIPTION
.PP
Concatenates \fIarg\fRs (adding separator spaces between them),
@@ -210,11 +209,18 @@ not needed to determine the outcome. For example, in the command
.CS
\fBexpr {$v ? [a] : [b]}\fR
.CE
-only one of \fB[a]\fR or \fB[b]\fR will actually be evaluated,
+only one of
+.QW \fB[a]\fR
+or
+.QW \fB[b]\fR
+will actually be evaluated,
depending on the value of \fB$v\fR. Note, however, that this is
only true if the entire expression is enclosed in braces; otherwise
-the Tcl parser will evaluate both \fB[a]\fR and \fB[b]\fR before
-invoking the \fBexpr\fR command.
+the Tcl parser will evaluate both
+.QW \fB[a]\fR
+and
+.QW \fB[b]\fR
+before invoking the \fBexpr\fR command.
.SS "MATH FUNCTIONS"
.PP
.VS 8.5
@@ -229,6 +235,11 @@ is the same in every way as the processing of:
.CS
\fBexpr {[tcl::mathfunc::sin [expr {$x+$y}]]}\fR
.CE
+which in turn is the same as the processing of:
+.CS
+\fBtcl::mathfunc::sin [expr {$x+$y}]\fR
+.CE
+.PP
The executor will search for \fBtcl::mathfunc::sin\fR using the usual
rules for resolving functions in namespaces. Either
\fB::tcl::mathfunc::sin\fR or \fB[namespace
@@ -382,16 +393,13 @@ Generate a random integer in the range 0..99 inclusive:
.CS
set randNum [\fBexpr\fR { int(100 * rand()) }]
.CE
-
.SH "SEE ALSO"
array(n), for(n), if(n), mathfunc(n), namespace(n), proc(n), string(n), Tcl(n), while(n)
-
.SH KEYWORDS
arithmetic, boolean, compare, expression, fuzzy comparison
-
.SH COPYRIGHT
+.ni
Copyright (c) 1993 The Regents of the University of California.
-.br
Copyright (c) 1994-2000 Sun Microsystems Incorporated.
-.br
Copyright (c) 2005 by Kevin B. Kenny <kennykb@acm.org>. All rights reserved.
+.fi