1 12/22/85  forum request:  write, w
  2 
  3 Syntax:  w trans_specs {-control_args}
  4 
  5 
  6 Function:
  7 Write the selected transactions into a segment.
  8 
  9 
 10 Arguments:
 11 trans_specs
 12    are transaction specifiers which determine the transactions to be
 13    written.  Use the forum request "help trans_specs" for more
 14    information on transaction specifiers.
 15 
 16 
 17 Control arguments:
 18 -brief, -bf
 19    suppresses the message about how many transactions were written.
 20 -by_chain
 21    specifies that transactions are to be grouped by transaction chain.
 22 -extend
 23    specifies that the selected transactions be written be added to the
 24    end of a segment. (Default)
 25 -fill, -fi
 26    specifies that all transactions be filled when written.
 27 -format, -fmt
 28    specifies that transactions are to be written in a formatted fashion
 29    which includes page breaks. See "Notes on formatting" below.
 30 
 31 
 32 -include_deleted, -idl
 33    selects transactions even if they have been deleted. See "Notes"
 34    below. Default is -only_non_deleted.
 35 -initial
 36    only writes transactions which are first in transaction chains.
 37 -line_length LENGTH, -ll LENGTH
 38    specifies that transactions are to be filled to LENGTH characters.
 39    (Default = 72)
 40 -long, -lg
 41    print a message showing how many transactions were written.
 42    (Default)
 43 -meeting meeting_name, -mtg meeting_name
 44    indicates that the specified transactions are to be selected from
 45    the meeting_name meeting.  The default is to select transactions
 46    from the current meeting.
 47 
 48 
 49 -no_fill, -nfi
 50    specifies that transactions not be filled when written.
 51 -no_format, -nfmt
 52    specifies that transactions are to be written with no page breaks,
 53    headers, or footers. (Default)
 54 -no_header, -nhe
 55    suppresses both transaction headers and trailers from
 56    being written to the output file.
 57 -no_separator, -nsep
 58    specifies that transactions are to be written out with only a single
 59    blank line between them.
 60 -only_deleted, -odl
 61    select only deleted transactions. See "Notes" below. Default is
 62    -only_non_deleted.
 63 -only_non_deleted, -ondl
 64    select only non-deleted transactions. (Default)
 65 
 66 
 67 -pathname PATH, -pn PATH
 68    specifies that the transactions selected be written to the segment
 69    identified by PATH. If the entryname portion of PATH does not
 70    contain the ".trans" suffix, it will be added.
 71 -page_length LENGTH, -pl LENGTH
 72    specifies that LENGTH lines be printed on each page. LENGTH includes
 73    the page header and footer. This control argument is only applicable
 74    if -formatted is given. (Default = 60)
 75 -reverse, -rv
 76    causes transactions to be written in the reverse order that they
 77    were given in the transaction specifier.
 78 
 79 
 80 -trailer_format TYPE, -tfmt TYPE
 81    specifies the format of the trailer line printed by the print
 82    and write requests after each transaction.   TYPE must be one of:
 83 
 84    none
 85       no trailer is printed.
 86    number, nb
 87       a trailer containing the transaction number is printed.
 88    more
 89       a trailer containing the transaction number is printed.  If there
 90       is a subsequent transaction in the same chain, "(more)" is
 91       also printed.
 92    references, refs
 93       a trailer containing the transaction number and the numbers of
 94       the previous and next transaction is printed.  (Default)
 95 
 96 
 97 -separator string, -sep string
 98    writes string to the output segment after each transaction. string
 99    is an ioa_ control string of up to 256 characters. (Default: "^|")
100 -truncate, -tc
101    specifies that the segment be truncated before the transactions
102    are written to it.
103 
104 
105 List of transaction specification control arguments:
106 -after DT, -af DT
107    selects transactions entered on or after the the date specified.
108    The time of day is ignored.
109 -after_time DT, -aft DT
110    selects transactions entered after the date_time specified.
111 -before DT, -be DT
112    selects transactions entered before the date specified. The time
113    of day is ignored.
114 -before_time DT, -bet DT
115    selects transactions entered before the date_time specified.
116 -between DT1 DT2, -bt DT1 DT2
117    selects transactions entered between the dates specified,
118    inclusive.  The times of day are ignored.
119 
120 
121 -between_time DT1 DT2, -btt DT1 DT2
122    selects transactions entered between the date_times specified,
123    inclusive.
124 -date DT, -dt DT
125    selects transactions entered on the day specified.
126 -from Person_id, -fm Person_id
127    selects transactions entered by the participant named Person_id.
128 -subject /regexp/, -sj /regexp/
129    selects transactions whose subjects match the given regular
130    expression.
131 -text /regexp/, -tx /regexp/
132    selects transactions whose subjects match the given regular
133    expression.
134 
135 
136 Notes:
137 If no pathname is given, the selected transactions are written to a
138 segment in the working directory with the entryname
139 meeting_name.trans.  The user's current transaction index will be set
140 to the last transaction written.
141 
142 In order to write a deleted transaction, the user must either be the
143 chairman of the meeting, or the author of the deleted transaction.
144 
145 
146 Notes on formatting:
147 Formatted output consists of a page header containing the current date
148 and time, the name of the meeting, and the page number; and a footer
149 containing the subject of the first transaction on the page.  The
150 header and footer are separated from the text by a line of underscores
151 and a blank line.  Tramsactions are only split across pages if they are
152 longer than one page.  If a transaction does not fit on the remainder
153 of the current page, a new page is always created.  The -separator
154 control argument may not be used when formatting output.