-- SetKeepDoc.tioga
-- last edited by: L. Stewart, December 12, 1983 5:21 pm
name  SetKeep:
<<syntax>>
<<SetKeep keep {pattern}*>>
<<Keep should be a positive integer.  A keep value of 0 leaves the current keep alone, but does the keep processing of deleting any 
versions that are not in use and which are inconsistant with the existing keep value.>>
<<description>>
<<Set the FS keep parameter of local files.  SetKeep will actually delete on the spot any versions of the file which are not in use 
and which would not be retained given the new value of keep.  This command is an interface to FS.SetKeep.>>
<<examples>>
<<% SetKeep 2 /ivy/stewart/temp/w1aw.txt
 ... FS.Error[Can't set the keep on a GName.]
% >>
<<SetKeep doesn't work for remote files (they have no FS keep property).>>
<<% SetKeep 2 Test3.cm
% >>
<<warnings>>
<<One cannot call SetKeep using a name that has a version number!  I'm not sure why.  Consequently, using a pattern doesn't make 
sense yet.>>
<<stop/undo >>
<<Click the STOP! button.>>
<<implementation >>
<<FSFileCommandsImpl.mesa in CommandTool.df>>
<<contact>>
<<L. C. Stewart <Stewart.pa>>>
<<keyword hints>>
<<
help button info man>>
<<keywords>>
<<
to be supplied by the Index Czar>>