1 8/6/83  forum request:  list, ls
  2 
  3 Syntax:  ls {trans_specs} {-control_args}
  4 
  5 
  6 Syntax as an active request:  [ls {trans_specs} {-control_args}]
  7 
  8 
  9 Function:
 10 Print the transaction number, author, subject, and date/time  of
 11 specified transactions on the user's terminal.  As an active function,
 12 it returns a list of numbers of selected transactions.
 13 
 14 
 15 Arguments:
 16 trans_specs
 17    are transaction specifiers which determine the transactions to be
 18    listed.  Use the forum request "help trans_specs" for more
 19    information on transaction specifiers.  If no transaction specifiers
 20    are supplied, all transactions are listed.
 21 
 22 
 23 Control arguments:
 24 -brief, -bf
 25    prints an abbreviated summary of the transaction.
 26 -by_chain
 27    specifies that transactions are to be grouped by transaction chain.
 28 -fill, -fi
 29    causes filling of listed transactions in order to obtain the line
 30    count. Not valid if invoked as an active request.
 31 -header, -he
 32    prints the header. (Default)
 33 -include_deleted, -idl
 34    lists transactions even if they have been deleted. See "Notes"
 35    below. Default is -only_non_deleted.
 36 -inhibit_error, -ihe
 37    do not print an error if no transactions are selected. Only valid
 38    if invoked as an active request.
 39 
 40 
 41 -initial
 42    only lists transactions which are first in transaction chains.
 43 -long, -lg
 44    prints a complete summary of the transaction.  (Default)
 45 -long_subject, -lgsj
 46    inhibits truncation of summary lines. The subject of the transaction
 47    will be wrapped to the next line if it is longer than the terminal
 48    width.
 49 -meeting meeting_name, -mtg meeting_name
 50    indicates that the specified transactions are to be selected from
 51    the meeting_name meeting.  The default is to select transactions
 52    from the current meeting.
 53 -no_fill, -nfi
 54    suppresses filling of transactions in order to obtain the line
 55    count.  Not valid if invoked as an active request.  (Default)
 56 
 57 
 58 -no_header, -nhe
 59    suppresses printing of the header.  Not valid if invoked as an
 60    active request.
 61 -no_inhibit_error, -nihe
 62    print an error if no transactions are selected. Only valid
 63    if invoked as an active request. (Default)
 64 -no_update, -nud
 65    causes the list request to not update the current transaction index.
 66    Not valid if invoked as an active request.
 67 -only_deleted, -odl
 68    list only deleted transactions. See "Notes" below. Default is
 69    -only_non_deleted.
 70 -only_non_deleted, -ondl
 71    list only non-deleted transactions. (Default)
 72 
 73 
 74 -output_file PATH, -of PATH
 75    directs the output of the list request to the file named by PATH.
 76    Not valid if invoked as an active request.
 77 -reverse, -rv
 78    causes transactions to be listed in the reverse order that they were
 79    given in the transaction specifier.
 80 -update, -ud
 81    causes the current transaction index to be set to the index of the
 82    first transaction listed unless the current transaction is among
 83    those listed.  Not valid if invoked as an active request. (Default)
 84 
 85 
 86 List of transaction specification control arguments:
 87 -after DT, -af DT
 88    selects transactions entered on or after the the date specified.
 89    The time of day is ignored.
 90 -after_time DT, -aft DT
 91    selects transactions entered after the date_time specified.
 92 -before DT, -be DT
 93    selects transactions entered before the date specified. The time
 94    of day is ignored.
 95 -before_time DT, -bet DT
 96    selects transactions entered before the date_time specified.
 97 -between DT1 DT2, -bt DT1 DT2
 98    selects transactions entered between the dates specified,
 99    inclusive.  The times of day are ignored.
100 
101 
102 -between_time DT1 DT2, -btt DT1 DT2
103    selects transactions entered between the date_times specified,
104    inclusive.
105 -date DT, -dt DT
106    selects transactions entered on the day specified.
107 -from Person_id, -fm Person_id
108    selects transactions entered by the participant named Person_id.
109 -subject /regexp/, -sj /regexp/
110    selects transactions whose subjects match the given regular
111    expression.
112 -text /regexp/, -tx /regexp/
113    selects transactions whose text match the given regular
114    expression.
115 
116 
117 Notes:
118 In order to list a deleted transaction, the user must either be the
119 chairman of the meeting, or the author of the deleted transaction.