Bring Back Dumped Objects

DESCRIPTION:
Puts data objects into the local directory that were put into a file with data.dump.

USAGE:
data.restore(file, print=F)

REQUIRED ARGUMENTS:
file:
character string, interpreted as a file name.

OPTIONAL ARGUMENTS:
print:
If TRUE, print a single line summary of each object, just before it is restored from the file.

SIDE EFFECTS:
all data objects stored on file are placed in the local directory. A summary of the objects is printed if print is TRUE.

DETAILS:
Normally, the file supplied to data.restore was previously created (maybe on another machine) by a call to data.dump.

NOTE:
This function is not affected by the current search list.

SEE ALSO:
data.dump, restore, source .

EXAMPLES:
data.dump(ls(),file="all.data")
data.restore("all.data")