diff options
| author | dkf <donal.k.fellows@manchester.ac.uk> | 2002-07-01 10:50:21 (GMT) |
|---|---|---|
| committer | dkf <donal.k.fellows@manchester.ac.uk> | 2002-07-01 10:50:21 (GMT) |
| commit | 453df7044062f9f79fff8b0a578fc2ade81bb829 (patch) | |
| tree | 4d4c228faf33f8d52837b041b989f0c424f04946 /doc | |
| parent | 709a7e7751a27b75931a97852c27b342871e3c68 (diff) | |
| download | tcl-453df7044062f9f79fff8b0a578fc2ade81bb829.zip tcl-453df7044062f9f79fff8b0a578fc2ade81bb829.tar.gz tcl-453df7044062f9f79fff8b0a578fc2ade81bb829.tar.bz2 | |
Documented the *real* behaviour of [concat]
Diffstat (limited to 'doc')
| -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. |