Please enter the commit message for your changes. Lines starting

[eos/base.git] / util / src / TclTk / tcl8.6.4 / doc / split.n

diff --git a/util/src/TclTk/tcl8.6.4/doc/split.n b/util/src/TclTk/tcl8.6.4/doc/split.n
deleted file mode 100644 (file)
index f1c66d0..0000000
--- a/util/src/TclTk/tcl8.6.4/doc/split.n
+++ /dev/null
@@ -1,93 +0,0 @@
-'\"
-'\" Copyright (c) 1993 The Regents of the University of California.
-'\" Copyright (c) 1994-1996 Sun Microsystems, Inc.
-'\"
-'\" See the file "license.terms" for information on usage and redistribution
-'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
-'\" 
-.TH split n "" Tcl "Tcl Built-In Commands"
-.so man.macros
-.BS
-'\" Note:  do not modify the .SH NAME line immediately below!
-.SH NAME
-split \- Split a string into a proper Tcl list
-.SH SYNOPSIS
-\fBsplit \fIstring \fR?\fIsplitChars\fR?
-.BE
-.SH DESCRIPTION
-.PP
-Returns a list created by splitting \fIstring\fR at each character
-that is in the \fIsplitChars\fR argument.
-Each element of the result list will consist of the
-characters from \fIstring\fR that lie between instances of the
-characters in \fIsplitChars\fR.
-Empty list elements will be generated if \fIstring\fR contains
-adjacent characters in \fIsplitChars\fR, or if the first or last
-character of \fIstring\fR is in \fIsplitChars\fR.
-If \fIsplitChars\fR is an empty string then each character of
-\fIstring\fR becomes a separate element of the result list.
-\fISplitChars\fR defaults to the standard white-space characters.
-.SH EXAMPLES
-.PP
-Divide up a USENET group name into its hierarchical components:
-.PP
-.CS
-\fBsplit\fR "comp.lang.tcl" .
-      \fI\(-> comp lang tcl\fR
-.CE
-.PP
-See how the \fBsplit\fR command splits on \fIevery\fR character in
-\fIsplitChars\fR, which can result in information loss if you are not
-careful:
-.PP
-.CS
-\fBsplit\fR "alpha beta gamma" "temp"
-      \fI\(-> al {ha b} {} {a ga} {} a\fR
-.CE
-.PP
-Extract the list words from a string that is not a well-formed list:
-.PP
-.CS
-\fBsplit\fR "Example with {unbalanced brace character"
-      \fI\(-> Example with \e{unbalanced brace character\fR
-.CE
-.PP
-Split a string into its constituent characters
-.PP
-.CS
-\fBsplit\fR "Hello world" {}
-      \fI\(-> H e l l o { } w o r l d\fR
-.CE
-.SS "PARSING RECORD-ORIENTED FILES"
-.PP
-Parse a Unix /etc/passwd file, which consists of one entry per line,
-with each line consisting of a colon-separated list of fields:
-.PP
-.CS
-## Read the file
-set fid [open /etc/passwd]
-set content [read $fid]
-close $fid
-
-## Split into records on newlines
-set records [\fBsplit\fR $content "\en"]
-
-## Iterate over the records
-foreach rec $records {
-
-    ## Split into fields on colons
-    set fields [\fBsplit\fR $rec ":"]
-
-    ## Assign fields to variables and print some out...
-    lassign $fields \e
-            userName password uid grp longName homeDir shell
-    puts "$longName uses [file tail $shell] for a login shell"
-}
-.CE
-.SH "SEE ALSO"
-join(n), list(n), string(n)
-.SH KEYWORDS
-list, split, string
-'\" Local Variables:
-'\" mode: nroff
-'\" End: