diff options
| author | dkf <dkf@noemail.net> | 2002-07-01 10:50:21 (GMT) |
|---|---|---|
| committer | dkf <dkf@noemail.net> | 2002-07-01 10:50:21 (GMT) |
| commit | 3ad570d02a595c82cbc19eeef8432f333263d019 (patch) | |
| tree | 4d4c228faf33f8d52837b041b989f0c424f04946 /doc/concat.n | |
| parent | c384894414c7137b0334b67e6ca0e3d08468b7be (diff) | |
| download | tcl-3ad570d02a595c82cbc19eeef8432f333263d019.zip tcl-3ad570d02a595c82cbc19eeef8432f333263d019.tar.gz tcl-3ad570d02a595c82cbc19eeef8432f333263d019.tar.bz2 | |
Documented the *real* behaviour of [concat]
FossilOrigin-Name: 45000cc6a77257a16551afa04079cbc3dc400980
Diffstat (limited to 'doc/concat.n')
| -rw-r--r-- | doc/concat.n | 21 |
1 files changed, 14 insertions, 7 deletions
diff --git a/doc/concat.n b/doc/concat.n index c04eaf0..52f4094 100644 --- a/doc/concat.n +++ b/doc/concat.n @@ -5,10 +5,10 @@ '\" See the file "license.terms" for information on usage and redistribution '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. '\" -'\" RCS: @(#) $Id: concat.n,v 1.3 2000/09/07 14:27:46 poenitz Exp $ +'\" RCS: @(#) $Id: concat.n,v 1.4 2002/07/01 10:50:21 dkf Exp $ '\" .so man.macros -.TH concat n "" Tcl "Tcl Built-In Commands" +.TH concat n 8.3 Tcl "Tcl Built-In Commands" .BS '\" Note: do not modify the .SH NAME line immediately below! .SH NAME @@ -19,12 +19,11 @@ concat \- Join lists together .SH DESCRIPTION .PP -This command treats each argument as a list and concatenates them +This command joins each of its arguments together with spaces after +trimming leading and trailing spaces from each of them. If all the +arguments are lists, this has the same effect as concatenating them into a single list. -It also eliminates leading and trailing spaces in the \fIarg\fR's -and adds a single separator space between \fIarg\fR's. -It permits any number of arguments. For example, -the command +It permits any number of arguments. For example, the command .CS \fBconcat a b {c d e} {f {g h}}\fR .CE @@ -32,6 +31,14 @@ will return .CS \fBa b c d e f {g h}\fR .CE +as its result, and +.CS +\fBconcat " a b {c " d " e} f"\fR +.CE +will return +.CS +\fBa b {c d e} f\fR +.CE as its result. .PP If no \fIarg\fRs are supplied, the result is an empty string. |