Return to Tcl_Merge.man CVS log

Up to [Research Unix] / researchv10no / cmd / worm / scsi / tcl

Annotation of researchv10no/cmd/worm/scsi/tcl/Tcl_Merge.man, revision 1.1.1.1

1.1       root        1: '\" Copyright 1989 Regents of the University of California
                      2: '\" Permission to use, copy, modify, and distribute this
                      3: '\" documentation for any purpose and without fee is hereby
                      4: '\" granted, provided that this notice appears in all copies.
                      5: '\" The University of California makes no representations about
                      6: '\" the suitability of this material for any purpose.  It is
                      7: '\" provided "as is" without express or implied warranty.
                      8: '\" 
                      9: '\" $Header: /sprite/src/lib/tcl/RCS/Tcl_Merge.man,v 1.2 89/03/24 14:16:16 ouster Exp $ SPRITE (Berkeley)
                     10: '\" 
                     11: .so \*(]ltmac.sprite
                     12: .HS Tcl_Merge tcl
                     13: .BS
                     14: .SH NAME
                     15: Tcl_Merge \- generate a Tcl list from a collection of strings
                     16: .SH SYNOPSIS
                     17: .nf
                     18: \fB#include <tcl.h>\fR
                     19: .sp
                     20: char *
                     21: \fBTcl_Merge\fR(\fIargc, argv\fR)
                     22: .SH ARGUMENTS
                     23: .AP int argc in
                     24: Number of strings.
                     25: .AP char *argv[] in
                     26: Array of strings to combine into list.  Must have \fIargc\fR entries.
                     27: .BE
                     28: 
                     29: .SH DESCRIPTION
                     30: .PP
                     31: \fBTcl_Merge\fR is a utility procedure used by several of the Tcl commands.
                     32: Given a collection of strings, it generates a result string
                     33: that has proper list structure, such that the \fBindex\fR
                     34: Tcl command may be used to extract out the original strings.
                     35: In order to do this, \fBTcl_Merge\fR may have to add braces
                     36: and/or backslashes.  The result string is dynamically allocated
                     37: using \fBmalloc()\fR;  the caller must eventually release the space
                     38: using \fBfree()\fR.
                     39: 
                     40: .SH KEYWORDS
                     41: list, strings

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.