aboutsummaryrefslogtreecommitdiff
path: root/pkg/language/doc/keep.hlp
blob: 11935af0606a38f79c989246b2c89122041327bd (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
.help keep Feb86 language
.ih
NAME
keep -- keep memory after task termination
.ih
USAGE
keep
.ih
DESCRIPTION
Normally when a script task terminates any tasks, packages, environment
variables, etc. defined during the execution of that task are discarded
(in other words, the memory used by the task is freed).
The \fIkeep\fR command instructs the CL to retain the definitions after
script termination.  Only one level of "keep" is achieved, e.g.,
if a script with a keep is called from a higher level script, then when
the higher level script terminates the task definitions will still be lost
(unless this higher level script also uses \fIkeep\fR).
.ih
EXAMPLE
1. The most common use for \fIkeep\fR is to retain a set of definitions
in a script task.

.nf
	set	pkdir = "home$hebrew/"
	task	aleph, beth, kaph = hebrew.cl

	keep
.fi
.ih
SEE ALSO
task, package
.endhelp