summaryrefslogtreecommitdiffstats
path: root/doc/unset.n
diff options
context:
space:
mode:
Diffstat (limited to 'doc/unset.n')
-rw-r--r--doc/unset.n18
1 files changed, 6 insertions, 12 deletions
diff --git a/doc/unset.n b/doc/unset.n
index 2cfc63e..09f2ce6 100644
--- a/doc/unset.n
+++ b/doc/unset.n
@@ -5,7 +5,7 @@
'\"
'\" See the file "license.terms" for information on usage and redistribution
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
-'\"
+'\"
.TH unset n 8.4 Tcl "Tcl Built-In Commands"
.so man.macros
.BS
@@ -13,7 +13,7 @@
.SH NAME
unset \- Delete variables
.SH SYNOPSIS
-\fBunset \fR?\fB\-nocomplain\fR? ?\fB\-\-\fR? ?\fIname name name ...\fR?
+\fBunset \fR?\fI\-nocomplain\fR? ?\fI\-\-\fR? ?\fIname name name ...\fR?
.BE
.SH DESCRIPTION
.PP
@@ -25,21 +25,19 @@ element is removed without affecting the rest of the array.
If a \fIname\fR consists of an array name with no parenthesized
index, then the entire array is deleted.
The \fBunset\fR command returns an empty string as result.
-If \fB\-nocomplain\fR is specified as the first argument, any possible
+If \fI\-nocomplain\fR is specified as the first argument, any possible
errors are suppressed. The option may not be abbreviated, in order to
-disambiguate it from possible variable names. The option \fB\-\-\fR
+disambiguate it from possible variable names. The option \fI\-\-\fR
indicates the end of the options, and should be used if you wish to
remove a variable with the same name as any of the options.
-If an error occurs during variable deletion, any variables after the named one
-causing the error are not
+If an error occurs, any variables after the named one causing the error
+are not
deleted. An error can occur when the named variable does not exist, or the
name refers to an array element but the variable is a scalar, or the name
refers to a variable in a non-existent namespace.
.SH EXAMPLE
-.PP
Create an array containing a mapping from some numbers to their
squares and remove the array elements for non-prime numbers:
-.PP
.CS
array set squares {
1 1 6 36
@@ -62,7 +60,3 @@ parray squares
set(n), trace(n), upvar(n)
.SH KEYWORDS
remove, variable
-'\" Local Variables:
-'\" mode: nroff
-'\" fill-column: 78
-'\" End: