1 5/23/84  forum request:  unchain
 2 
 3 Syntax:  unchain trans_specs {-control_args}
 4 
 5 
 6 Function:
 7 Removes specified transactions from their transaction chains and
 8 optionally changes their subjects.
 9 
10 
11 Arguments:
12 trans_specs
13    are transaction specifiers which determine the transactions to be
14    modified.  Use the forum request "help trans_specs" for more
15    information on transaction specifiers.
16 
17 
18 Control arguments:
19 -include_deleted, -idl
20    selects transactions even if they have been deleted. Default is
21    -only_non_deleted.
22 -initial
23    only selects transactions which are first in transaction chains.
24 -only_deleted, -odl
25    select only deleted transactions.  Default is -only_non_deleted.
26 -only_non_deleted, -ondl
27    select only non-deleted transactions. (Default)
28 -new_subject new_subject, -newsj new_subject
29    changes the subjects of all of the selected transactions to
30    new_subject.
31 
32 
33 List of transaction specification control arguments:
34 -after DT, -af DT
35    selects transactions entered on or after the the date specified.
36    The time of day is ignored.
37 -after_time DT, -aft DT
38    selects transactions entered after the date_time specified.
39 -before DT, -be DT
40    selects transactions entered before the date specified. The time
41    of day is ignored.
42 -before_time DT, -bet DT
43    selects transactions entered before the date_time specified.
44 -between DT1 DT2, -bt DT1 DT2
45    selects transactions entered between the dates specified,
46    inclusive.  The times of day are ignored.
47 
48 
49 -between_time DT1 DT2, -btt DT1 DT2
50    selects transactions entered between the date_times specified,
51    inclusive.
52 -date DT, -dt DT
53    selects transactions entered on the day specified.
54 -from Person_id, -fm Person_id
55    selects transactions entered by the participant named Person_id.
56 -subject /regexp/, -sj /regexp/
57    selects transactions whose subjects match the given regular
58    expression.
59 -text /regexp/, -tx /regexp/
60    selects transactions whose text match the given regular
61    expression.
62 
63 
64 Notes:
65 This request requires chairman access to the meeting.
66 
67 
68 Example:
69 To remove the last transaction in the meeting from its transaction chain
70 and change its subject to "Radios", enter
71 
72    unchain last -new_subject Radios