.BG
.VE $Header: /usr3/s/current/s/.help/RCS/rm,v 1.2 83/12/30 19:33:37 rab Exp $
.FN rm
.TL
rm: Remove Datasets from a Data Directory
.CS
rm(arg1, arg2, ..., list=, print=, pos=, value=)
.PP
.AG argi
datasets to be removed. Note that the arguments must
actually correspond to datasets in a data directory; i.e., the
argument is just a data-set name. Compare argument `list'.
Missing values (NAs) are allowed.
.AG list=
character vector of the names of datasets to be removed.
The advantage over explicitly naming the datasets as above
is that the datasets need not be accessed. Typically, the
`list=' argument is used to remove many datasets at once,
such as all the datasets under a prefix (see the example
below).
.AG print=
should names of removed datasets be printed?
Default FALSE.
.AG pos=
position in the data directory search list of the data directory from
which the datasets should be removed. Default 1 (the work directory).
.AG value=
the value that the function should return.  Useful in macros
that generate temporary datasets that should be removed.
This allows the `rm' function to be the last function in the
macro, and to return a value.
.RT
the `value=' argument, if given.
.EX
rm(x,y,z) #remove datasets x,y,z
rm(list=list("wages.*")) #remove anything in work directory
             # whose name starts with "wages."
rm(list=list("wages.*",pos=2),pos=2)  #same for save directory
rm(wages.x,pos=2) #remove wages.x from save directory
rm($Tx,value=$Tx) #remove $Tx and return its value
.KW basic*
.KW data management
.WR
