.BG
.FN reload
.TL
Quit and Restart S
.CS
reload()
.SE
This function attempts to save the current context of S, quits
from S, restarts and establishes the saved context.
The purpose is to recover memory and reduce the size of an S process
that has grown large because of a long period of computation.
It should appear that nothing has changed as a result of the
reloading; in particular, the contents of frame `0', including options and
search list, are preserved.
One exception is that graphics devices are shut down and not restarted,
since there is no way to guarantee that restarting the device would
be harmless (for example, `postscript' might overwrite the output file).
.PP
This function will be called automatically whenever the memory usage exceeds
one half of `options("memory")'.
You can call it explicitly if you believe your process is slowing down
because of accumulating memory.
.SH WARNING
Because of recent improvements in S memory management, `reload' should
not be needed much anymore.
Also, it appears to be broken on some machines.
For the present, it has been deactivated and simply prints a warning
message.
.WR
