1 10/17/84  value_delete, vdl
 2 
 3 Syntax as a command:  vdl {name} {-control_args}
 4 
 5 
 6 Function: causes one or more names not to have defined values, as set
 7 by value_set or value_get -call.
 8 
 9 
10 Arguments:
11 name
12    is a character string.  It can be -name STR to specify a name
13    beginning with a minus sign, to distinguish it from a control
14    argument.  (See "Notes.")
15 
16 
17 Control arguments:
18 -all, -a
19    deletes data values set by value_$set_data as well as other values.
20 -brief, -bf
21    suppresses the warning message "No match for starname."
22 -data
23    deletes values set by value_$set_data, which you can list by giving
24    -all or -data to value_list.  (Default: delete values set by
25    value_set or value_$set)
26 
27 
28 -exclude STR, -ex STR
29    deletes all existing values except those for names that match STR.
30    If STR is surrounded by slashes (/), it is interpreted as a qedx
31    regular expression to match names; otherwise, it is interpreted as a
32    starname.  Only per-process values are deleted if you supply
33    -perprocess, and only permanent ones if you give -permanent.  (See
34    "Notes.")
35 -long, -lg
36    allows the warning message "No match for starname."  (Default)
37 
38 
39 -match STR
40    deletes all existing values for names that match STR.  If STR is
41    surrounded by slashes, it is interpreted as a qedx regular
42    expression to match names; otherwise, it is interpreted as a
43    starname.  Only per-process values are deleted if you supply
44    -perprocess, and only permanent ones if you give -permanent.  (See
45    "Notes.")
46 
47 
48 -pathname path, -pn path
49    specifies a value segment other than the current default one,
50    without changing the default (see "Notes on Value Segment").
51 -permanent, -perm
52    deletes only values stored in the value segment.
53 -perprocess, -pp
54    deletes only per-process values.  The default is to delete the
55    per-process value if one exists, otherwise to delete any permanent
56    value.
57 
58 
59 Access required: You require rw access on the value segment except for
60 per-process values.
61 
62 
63 Notes: The -match and -exclude control arguments are applied in the
64 order specified.  Successive -match control arguments add to the set of
65 names processed (union), and successive -exclude control arguments
66 narrow down the set (intersection).  They are incompatible with the
67 name argument and can appear multiple times together.  (See
68 "Examples.")
69 
70 See value_defined, value_get, value_list, value_path, value_set, and
71 value_set_path.
72 
73 
74 Notes on value segment: The value segment searched is either the one
75 specified by -pathname or the current default value segment.  The
76 default segment is initially
77    [home_dir]>[user name].value
78 but you can change it by value_set_path.  Use of -pathname does not
79 change the default segment.