Convert S June/89 NA Values to Current S-PLUS NA Values.

DESCRIPTION:
Converts NA values in objects created with the AT&T June/89 release of S, to NA values as defined in version 2.x or higher of S-PLUS. The value of NA converted to is also that used in the AT&T August/91 release of S. NA's created with S-PLUS version 2.x need no conversion for S-PLUS 3.0.

USAGE:
Splus FIX.NA [data_directory]
fix.NA(x, oldNA="2146435072")

REQUIRED ARGUMENTS:
x:
an S object created with the June/89 release of AT&T S.

OPTIONAL ARGUMENTS:
oldNA:
character string specifying the integer representation of the old NA value. This argument does not usually need to be specified.
data_directory:
name of the data directory to convert. The default is .Data.

VALUE:
The function fix.NA returns an object like x with all NAs converted. The original x is unaltered. The utility FIX.NA processes all objects in data_directory.

SIDE EFFECTS:
The utility FIX.NA leaves a backup copy of data_directory in data_directory.bak.

EXAMPLES:
  attach("my.ATT.S.objects", pos=2)
  x <- fix.NA(get("x", where=2))
  detach(2)
  # now a converted version of x exists on the working directory.
  # or do an entire S working directory at once, from the shell:
% Splus FIX.NA my.ATT.S.objects
% mv my.ATT.S.objects my.Splus.objects

WARNING:
fix.NA and FIX.NA should not be run on anything except S objects created with the AT&T June/89 release of S. NA's created with S-PLUS version 2.x need no conversion for S-PLUS 3.0. To convert S-PLUS 1.x datasets, see old2newNA.