1 10/20/83  read_mail request:  print_header, prhe
  2 
  3 Syntax:  prhe {message_specifiers} {-selection_args} {-control_args}
  4 
  5 
  6 Function:  prints the message headers of the selected messages.
  7 
  8 
  9 Arguments:
 10 message_specifiers
 11    identifies which message headers are to be printed.  If no
 12    message_specifiers and no selection_args are specified, the header
 13    of the current message is printed.  For more information on message
 14    specifiers, type:
 15          help message_specifiers.gi
 16 
 17 
 18 Control arguments:
 19 -long, -lg
 20    specifies that the print_header request is to display all
 21    information from the message header including network tracing
 22    information even if some of the information is redundant.  (Ie: if
 23    the From, Sender, and Delivery-By fields are all equal, this option
 24    will force the print_header request to display all three fields).
 25 -default, -dft
 26    specifies that the print_header request is to display all
 27    information from the message header including user-defined fields
 28    while excluding the message trace and redundant information.
 29    (Default)
 30 
 31 
 32 -brief, -bf
 33    specifies that the print_header request is to display the minimal
 34    amount of information from the message header.  The date and authors
 35    are always displayed; the subject is displayed if it isn't blank;
 36    the number of recipients is displayed either if there is more than
 37    one recipient or the user is not the sole recipient of the message;
 38    if the message was ever forwarded with comments, these comments will
 39    be displayed.
 40 
 41 -include_deleted, -idl
 42    includes all messages in the mailbox whether or not they have been
 43    deleted when processing message_specifiers and selection_args to
 44    determine which message headers will be printed.
 45 -only_deleted, -odl
 46    includes only those messages which have been deleted.
 47 -only_non_deleted, -ondl
 48    includes only those messages which have not been deleted.  (Default)
 49 
 50 
 51 -delete, -dl
 52    marks the specified messages for deletion on exit from read_mail if
 53    all message headers are successfully printed.
 54 -no_delete, -ndl
 55    does not mark the messages for deletion.  (Default)
 56 -reverse, -rv
 57    prints the message headers in descending numeric order.
 58 -no_reverse, -nrv
 59    prints the message headers in ascending numeric order.  (Default)
 60 
 61 
 62 List of message selection control arguments:
 63    The following control arguments are used to further refine the
 64    list of message headers to be printed.  For more detailed
 65    information, type:
 66          help selection_control_args.gi
 67 
 68 -case_sensitive, -cs
 69    causes subject selections and qedx regular expression searches for
 70    author and recipient selections to be case sensitive.  (Default)
 71 -non_case_sensitive, -ncs
 72    causes subject selections and qedx regular expression searches for
 73    author and recipient selections to be case insensitive.
 74 
 75 
 76 -subject STR,
 77 -subject /STR/,
 78 -sj STR,
 79 -sj /STR/
 80    selects any messages whose Subject field contains STR.
 81 -in_reply_to STR,
 82 -in_reply_to /STR/,
 83 -irt STR,
 84 -irt /STR/
 85    selects any messages whose In-Reply-To field contains STR.
 86 
 87 
 88 -between DT1 DT2, -bt DT1 DT2
 89    selects any messages which were created between the dates DT1 and
 90    DT2 inclusively.
 91 -after DT, -af DT
 92    selects any messages which were created on or after the date
 93    specified by DT.
 94 -before DT, -be DT
 95    selects any messages which were created before the date specified
 96    by DT.
 97 -date DT, -dt DT
 98    selects any messages which were created on the date specified by DT.
 99 
100 
101 -between_time DT1 DT2, -btt DT1 DT2
102    selects any messages which were created between the date/times
103    specified by DT1 and DT2 inclusively.
104 -before_time DT, -bet DT
105    selects any messages which were created before the date/time
106    specified by DT.
107 -after_time DT, -aft DT
108    selects any messages which were created after the date/time
109    specified by DT.
110 
111 
112 -from address,
113 -from /STR/,
114 -fm address,
115 -fm /STR/
116    selects any messages whose From field either contains the specified
117    address or matches the given qedx regular expression.
118 -reply_to address,
119 -reply_to /STR/,
120 -rpt address,
121 -rpt /STR/
122    selects any messages whose Reply-To field either contains the
123    specified address or matches the given qedx regular expression.
124 
125 
126 -recipient address,
127 -recipient /STR/,
128 -rcp address,
129 -rcp /STR/
130    selects any messages whose To, cc, bcc, or Redistributed-To fields
131    either contains the specified address or matches the given qedx
132    regular expression.
133 -to address, -to /STR/
134    selects any messages whose To field either contains the specified
135    address or matches the given regular expression.
136 -cc address, -cc /STR/
137    selects any messages whose cc field either contains the specified
138    address or matches the given qedx regular expression.
139 
140 
141 -bcc address, -bcc /STR/
142    selects any messages whose bcc field either contains the specified
143    address or matches the given qedx regular expression.
144 -forwarded_to address,
145 -forwarded_to /STR/,
146 -fwdt address,
147 -fwdt /STR/
148    selects any messages whose Redistributed-To field either contains
149    the specified address or matches the given qedx regular expression.
150 
151 
152 Notes:
153 This request will acknowledge any messages requiring acknowledgement
154 unless -no_acknowledge is specified on the read_mail command line.
155 
156 For more detailed information on message headers, type:
157       help message_format.gi