.BG
.VE $Header: /usr3/s/current/s/.help/RCS/dump,v 1.2 83/12/30 19:27:59 rab Exp $
.FN dump
.TL
dump: Dump Datasets to a File
.CS
dump(list, file, pos)
.PP
.AG list
character vector of the names of the S datasets to dump.
Typically, this is the result of the `list' function.
.AG file
character name of file where datasets are to be dumped.
Default "dumpdata".
.AG pos
position on search list from which datasets are to be taken.
Default 0, use first dataset with the correct name
encountered on search list.
.PP
The use of `dump' is usually to dump datasets for transmission to
another machine, or for archive purposes. One useful technique is to
dump all the data under a prefix; e.g., when you want to share the
data on a specific project with someone on another machine.
.PP
The function `restore' is used to recreate datasets written by `dump'.
The functions `dump' and `restore' are not affected by the current prefix.
.EX
dump(list("longley.*"),"longleydump") #all longley.*

dump(list(pos=2),"dbdump",pos=2) #the WHOLE save directory
       #  need to use pos= for both dump( ) and list( )
.KW basic*
.KW data management
.KW output
.KW write
.KW file
.WR
