1 8/7/86  forum request:  rechain
 2 
 3 Syntax:  rechain trans_specs -to new_chain_spec {-control_args}
 4 
 5 
 6 Function:
 7 Removes specified transactions from their transaction chains and
 8 places them in another transaction chain, optionally changing their
 9 subjects.
10 
11 
12 Arguments:
13 trans_specs
14    are transaction specifiers which determine the transactions to be
15    modified.  Use the forum request "help trans_specs" for more
16    information on transaction specifiers.
17 
18 
19 Control arguments:
20 -to new_chain_spec
21    places the specified transactions in the chain containing the
22    transaction specified by new_chain_spec  The transactions will be
23    placed in the new chain in chronological order.  This control
24    argument is required.
25 -include_deleted, -idl
26    selects transactions even if they have been deleted. Default is
27    -only_non_deleted.
28 -initial
29    only selects transactions which are first in transaction chains.
30 -only_deleted, -odl
31    select only deleted transactions.  Default is -only_non_deleted.
32 -only_non_deleted, -ondl
33    select only non-deleted transactions. (Default)
34 
35 
36 -new_subject {new_subject}, -newsj {new_subject}
37    If new_subject is specified, the subjects of all of the transactions
38    selected by trans_specs will be changed to new_subject.  If it is
39    not given, then the subjects will be changed to the subject of the
40    transaction specified by -to.  If this control argument is not
41    given, the subjects of the transactions are left unchanged.
42 
43 
44 List of transaction specification control arguments:
45 -after DT, -af DT
46    selects transactions entered on or after the the date specified.
47    The time of day is ignored.
48 -after_time DT, -aft DT
49    selects transactions entered after the date_time specified.
50 -before DT, -be DT
51    selects transactions entered before the date specified. The time
52    of day is ignored.
53 -before_time DT, -bet DT
54    selects transactions entered before the date_time specified.
55 -between DT1 DT2, -bt DT1 DT2
56    selects transactions entered between the dates specified,
57    inclusive.  The times of day are ignored.
58 
59 
60 -between_time DT1 DT2, -btt DT1 DT2
61    selects transactions entered between the date_times specified,
62    inclusive.
63 -date DT, -dt DT
64    selects transactions entered on the day specified.
65 -from Person_id, -fm Person_id
66    selects transactions entered by the participant named Person_id.
67 -subject /regexp/, -sj /regexp/
68    selects transactions whose subjects match the given regular
69    expression.
70 -text /regexp/, -tx /regexp/
71    selects transactions whose text match the given regular
72    expression.
73 
74 
75 Notes:
76 This request requires chairman access to the meeting.
77 
78 
79 Examples:
80 To place the current transaction in chain containing transaction 34, type
81 
82    rechain -to 34
83 
84 To place all of the transactions in the current chain in the chain
85 containing transaction 45, and to change their subjects to the same
86 subject as transaction 45, enter
87 
88    rechain aref -to 45 -new_subject