[BACK]Return to mail.1 CVS log [TXT][DIR] Up to [local] / src / usr.bin / mail

Diff for /src/usr.bin/mail/mail.1 between version 1.42 and 1.43

version 1.42, 2003/09/04 22:14:42 version 1.43, 2004/04/19 10:17:18
Line 40 
Line 40 
 .Sh SYNOPSIS  .Sh SYNOPSIS
 .Nm mail  .Nm mail
 .Bk -words  .Bk -words
 .Op Fl iInv  .Op Fl Iinv
 .Op Fl s Ar subject  
 .Op Fl c Ar list  
 .Op Fl b Ar list  .Op Fl b Ar list
   .Op Fl c Ar list
   .Op Fl s Ar subject
 .Ar to-addr Op Ar ...  .Ar to-addr Op Ar ...
 .Op Fl Ar sendmail-options Op Ar ...  .Op Fl Ar sendmail-options Op Ar ...
 .Ek  .Ek
 .Nm mail  .Nm mail
 .Op Fl iInNv  .Op Fl IiNnv
 .Fl f  .Fl f
 .Op Ar name  .Op Ar name
 .Nm mail  .Nm mail
 .Op Fl iInNv  .Op Fl IiNnv
 .Op Fl u Ar user  .Op Fl u Ar user
 .Sh DESCRIPTION  .Sh DESCRIPTION
 .Nm mail  .Nm mail
 is an intelligent mail processing system which has  is an intelligent mail processing system which has
 a command syntax reminiscent of  a command syntax reminiscent of
 .Xr \&ed 1  .Xr ed 1
 with lines replaced by messages.  with lines replaced by messages.
 .Pp  .Pp
 The options are as follows:  The options are as follows:
 .Bl -tag -width Ds  .Bl -tag -width Ds
 .It Fl v  .It Fl b Ar list
 Verbose mode.  Send blind carbon copies to
 The details of  .Ar list .
 delivery are displayed on the user's terminal.  .It Fl c Ar list
 .It Fl i  Send carbon copies to
 Ignore tty interrupt signals.  .Ar list
 This is  of users.
 particularly useful when using  .Ar list
   should be a comma separated list of names.
   .It Fl f Op Ar name
   Read in the contents of your mailbox
   (or the specified file
   .Ar name )
   for processing; when you quit,
 .Nm mail  .Nm mail
 on noisy phone lines.  writes undeleted messages back to this file.
 .It Fl I  .It Fl I
 Forces  Forces
 .Nm mail  .Nm mail
 to run in interactive mode, even when input is not a terminal.  to run in interactive mode, even when input is not a terminal.
 In particular, the special  In particular, the special
 .Ic \&~  .Ic ~
 command character, used when sending mail, is only available interactively.  command character, used when sending mail, is only available interactively.
   .It Fl i
   Ignore tty interrupt signals.
   This is
   particularly useful when using
   .Nm mail
   on noisy phone lines.
   .It Fl N
   Inhibits initial display of message headers
   when reading mail or editing a mail folder.
 .It Fl n  .It Fl n
 Inhibits reading  Inhibits reading
 .Pa /etc/mail.rc  .Pa /etc/mail.rc
 upon startup.  upon startup.
 .It Fl N  
 Inhibits initial display of message headers  
 when reading mail or editing a mail folder.  
 .It Fl s Ar subject  .It Fl s Ar subject
 Specify subject on command line  Specify subject on command line
 (only the first argument after the  (only the first argument after the
 .Fl s  .Fl s
 flag is used as a subject; be careful to quote subjects  flag is used as a subject; be careful to quote subjects
 containing spaces).  containing spaces).
 .It Fl c Ar list  
 Send carbon copies to  
 .Ar list  
 of users.  
 .Ar list  
 should be a comma separated list of names.  
 .It Fl b Ar list  
 Send blind carbon copies to  
 .Ar list .  
 .It Fl f Ar name  
 Read in the contents of your mailbox  
 (or the specified file  
 .Ar name )  
 for processing; when you quit,  
 .Nm mail  
 writes undeleted messages back to this file.  
 .It Fl u Ar user  .It Fl u Ar user
 Is equivalent to:  Is equivalent to:
 .Pp  .Pp
 .Dl $ mail -f /var/mail/user  .Dl $ mail -f /var/mail/user
 .Pp  .Pp
 except that locking is done.  except that locking is done.
   .It Fl v
   Verbose mode.
   The details of
   delivery are displayed on the user's terminal.
 .El  .El
 .Ss Startup actions  .Ss Startup actions
 At startup time,  At startup time,
Line 163 
Line 163 
 Moving among the messages is much like moving between lines in  Moving among the messages is much like moving between lines in
 .Xr ed 1 ;  .Xr ed 1 ;
 you may use  you may use
 .Ic \&+  .Ic +
 and  and
 .Ic \&-  .Ic -
 to shift forwards and backwards, or simply enter a message number to move  to shift forwards and backwards, or simply enter a message number to move
 directly.  directly.
 .Ss Disposing of mail  .Ss Disposing of mail
Line 202 
Line 202 
 .Ic delete 1\-5  .Ic delete 1\-5
 deletes messages 1 through 5.  deletes messages 1 through 5.
 The special name  The special name
 .Sq \&*  .Sq *
 addresses all messages and  addresses all messages and
 .Sq \&$  .Sq $
 addresses  addresses
 the last message; thus the command  the last message; thus the command
 .Ic top  .Ic top
 which prints the first few lines of a message could be used in  which prints the first few lines of a message could be used in
 .Ic top \&*  .Ic top *
 to print the first few lines of all messages.  to print the first few lines of all messages.
 .Ss Replying to or originating mail  .Ss Replying to or originating mail
 You can use the  You can use the
Line 260 
Line 260 
 .Dl alias cohorts bill ozalp jkf mark kridle@ucbcory  .Dl alias cohorts bill ozalp jkf mark kridle@ucbcory
 .Pp  .Pp
 in the file  in the file
 .Pa \&.mailrc  .Pa .mailrc
 in your home directory.  in your home directory.
 The current list of such aliases can be displayed with the  The current list of such aliases can be displayed with the
 .Ic alias  .Ic alias
Line 312 
Line 312 
 good messages at all,  good messages at all,
 .Nm mail  .Nm mail
 types  types
 .Dq Li \&No applicable messages  .Dq \&No applicable messages
 and  and
 aborts the command.  aborts the command.
 .Bl -tag -width delete  .Bl -tag -width delete
 .It Ic \&\-  .It Ic -
 Print out the preceding message.  Print out the preceding message.
 If given a numeric  If given a numeric
 argument  argument
Line 444 
Line 444 
 your  your
 .Ar mbox  .Ar mbox
 file, and  file, and
 \&+\&folder means a file in your folder  +folder means a file in your folder
 directory.  directory.
 .It Ic from  .It Ic from
 .Pq Ic f  .Pq Ic f
Line 454 
Line 454 
 Lists the current range of headers, which is an 18\-message group.  Lists the current range of headers, which is an 18\-message group.
 If  If
 a  a
 .Ql \&+  .Ql +
 argument is given, the next 18\-message group is printed; if  argument is given, the next 18\-message group is printed; if
 a  a
 .Ql \&\-  .Ql -
 argument is given, the previous 18\-message group is printed.  argument is given, the previous 18\-message group is printed.
 .It Ic help  .It Ic help
 A synonym for  A synonym for
Line 513 
Line 513 
 .Ic hold  .Ic hold
 option set.  option set.
 .It Ic more  .It Ic more
 .Pq Ic \mo  .Pq Ic \&mo
 Takes a message list and invokes the pager on that list.  Takes a message list and invokes the pager on that list.
 .It Ic next  .It Ic next
 .Pq Ic n  .Pq Ic n
 (like  (like
 .Ic \&+  .Ic +
 or  or
 .Tn CR )  .Tn CR )
 Goes to the next message in sequence and types it.  Goes to the next message in sequence and types it.
Line 610 
Line 610 
 .Ic save  .Ic save
 or when automatically saving to  or when automatically saving to
 .Ar mbox .  .Ar mbox .
 .pl +1  
 .It Ic saveretain  .It Ic saveretain
 .Ic saveretain  .Ic saveretain
 is to  is to
Line 697 
Line 696 
 You can move  You can move
 .Nm mail Ns 's  .Nm mail Ns 's
 attention forward to the next window with the  attention forward to the next window with the
 .Ic \&z  .Ic z
 command.  command.
 Also, you can move to the previous window by using  Also, you can move to the previous window by using
 .Ic \&z\&\- .  .Ic z- .
 .El  .El
 .Ss Tilde/escapes  .Ss Tilde/escapes
 Here is a summary of the tilde escapes,  Here is a summary of the tilde escapes,
Line 714 
Line 713 
 by the option  by the option
 .Ic escape .  .Ic escape .
 .Bl -tag -width Ds  .Bl -tag -width Ds
 .It Ic \&~! Ns Ar command  .It Ic ~! Ns Ar command
 Execute the indicated shell command, then return to the message.  Execute the indicated shell command, then return to the message.
 .It Ic \&~b Ns Ar name ...  .It Ic ~b Ns Ar name ...
 Add the given names to the list of carbon copy recipients but do not make  Add the given names to the list of carbon copy recipients but do not make
 the names visible in the Cc: line ("blind" carbon copy).  the names visible in the Cc: line ("blind" carbon copy).
 .It Ic \&~c Ns Ar name ...  .It Ic ~c Ns Ar name ...
 Add the given names to the list of carbon copy recipients.  Add the given names to the list of carbon copy recipients.
 .It Ic \&~d  .It Ic ~d
 Read the file  Read the file
 .Pa dead.letter  .Pa dead.letter
 from your home directory into the message.  from your home directory into the message.
 .It Ic \&~e  .It Ic ~e
 Invoke the text editor on the message collected so far.  Invoke the text editor on the message collected so far.
 After the  After the
 editing session is finished, you may continue appending text to the  editing session is finished, you may continue appending text to the
 message.  message.
 .It Ic \&~f Ns Ar messages  .It Ic ~f Ns Ar messages
 Read the named messages into the message being sent.  Read the named messages into the message being sent.
 If no messages are specified, read in the current message.  If no messages are specified, read in the current message.
 Message headers currently being ignored (by the  Message headers currently being ignored (by the
Line 738 
Line 737 
 or  or
 .Ic retain  .Ic retain
 command) are not included.  command) are not included.
 .It Ic \&~F Ns Ar messages  .It Ic ~F Ns Ar messages
 Identical to  Identical to
 .Ic \&~f ,  .Ic ~f ,
 except all message headers are included.  except all message headers are included.
 .It Ic \&~h  .It Ic ~h
 Edit the message header fields by typing each one in turn and allowing  Edit the message header fields by typing each one in turn and allowing
 the user to append text to the end or modify the field by using the  the user to append text to the end or modify the field by using the
 current terminal erase and kill characters.  current terminal erase and kill characters.
 .It Ic \&~m Ns Ar messages  .It Ic ~m Ns Ar messages
 Read the named messages into the message being sent, indented by a  Read the named messages into the message being sent, indented by a
 tab or by the value of  tab or by the value of
 .Va indentprefix .  .Va indentprefix .
Line 757 
Line 756 
 or  or
 .Ic retain  .Ic retain
 command) are not included.  command) are not included.
 .It Ic \&~M Ns Ar messages  .It Ic ~M Ns Ar messages
 Identical to  Identical to
 .Ic \&~m ,  .Ic ~m ,
 except all message headers are included.  except all message headers are included.
 .It Ic \&~p  .It Ic ~p
 Print out the message collected so far, prefaced by the message header  Print out the message collected so far, prefaced by the message header
 fields.  fields.
 .It Ic \&~q  .It Ic ~q
 Abort the message being sent, copying the message to  Abort the message being sent, copying the message to
 .Pa dead.letter  .Pa dead.letter
 in your home directory if  in your home directory if
 .Ic save  .Ic save
 is set.  is set.
 .It Ic \&~r Ns Ar filename  .It Ic ~r Ns Ar filename
 Read the named file into the message.  Read the named file into the message.
 .It Ic \&~s Ns Ar string  .It Ic ~s Ns Ar string
 Cause the named string to become the current subject field.  Cause the named string to become the current subject field.
 .It Ic \&~\&t Ns Ar name ...  .It Ic ~t Ns Ar name ...
 Add the given names to the direct recipient list.  Add the given names to the direct recipient list.
 .It Ic \&~\&v  .It Ic ~v
 Invoke an alternate editor (defined by the  Invoke an alternate editor (defined by the
 .Ev VISUAL  .Ev VISUAL
 option) on the  option) on the
Line 785 
Line 784 
 screen editor.  screen editor.
 After you quit the editor, you may resume appending  After you quit the editor, you may resume appending
 text to the end of your message.  text to the end of your message.
 .It Ic \&~w Ns Ar filename  .It Ic ~w Ns Ar filename
 Write the message onto the named file.  Write the message onto the named file.
 .It Ic \&~\&| Ns Ar command  .It Ic ~| Ns Ar command
 Pipe the message through the command as a filter.  Pipe the message through the command as a filter.
 If the command gives  If the command gives
 no output or terminates abnormally, retain the original text of the  no output or terminates abnormally, retain the original text of the
Line 797 
Line 796 
 is often used as  is often used as
 .Ic command  .Ic command
 to rejustify the message.  to rejustify the message.
 .It Ic \&~: Ns Ar mail-command  .It Ic ~: Ns Ar mail-command
 Execute the given mail command.  Execute the given mail command.
 Not all commands, however, are allowed.  Not all commands, however, are allowed.
 .It Ic \&~~ Ns Ar string  .It Ic ~~ Ns Ar string
 Insert the string of text in the message prefaced by a single ~.  Insert the string of text in the message prefaced by a single ~.
 If  If
 you have changed the escape character, then you should double  you have changed the escape character, then you should double
Line 965 
Line 964 
 Pathname of the text editor to use in the  Pathname of the text editor to use in the
 .Ic edit  .Ic edit
 command and  command and
 .Ic \&~e  .Ic ~e
 escape.  escape.
 If not defined, then a default editor is used.  If not defined, then a default editor is used.
 .It Ev LISTER  .It Ev LISTER
Line 995 
Line 994 
 Pathname of the text editor to use in the  Pathname of the text editor to use in the
 .Ic visual  .Ic visual
 command and  command and
 .Ic \&~v  .Ic ~v
 escape.  escape.
 .It Va crt  .It Va crt
 The valued option  The valued option
Line 1035 
Line 1034 
 If not defined, then outgoing mail is not so saved.  If not defined, then outgoing mail is not so saved.
 .It Ar indentprefix  .It Ar indentprefix
 String used by the  String used by the
 .Ic \&~m  .Ic ~m
 tilde escape for indenting messages, in place of the normal tab character  tilde escape for indenting messages, in place of the normal tab character
 .Pq Sq ^I  .Pq Sq ^I
 Be sure to quote the value if it contains  Be sure to quote the value if it contains
Line 1087 
Line 1086 
 .Xr mail.local 8 ,  .Xr mail.local 8 ,
 .Xr newaliases 8 ,  .Xr newaliases 8 ,
 .Xr sendmail 8  .Xr sendmail 8
 .Rs  .Pp
 .%T "The Mail Reference Manual"  "The Mail Reference Manual",
 .Re  .Pa /usr/share/doc/usd/07.mail/ .
 .Sh HISTORY  .Sh HISTORY
 A  A
 .Nm mail  .Nm mail
Legend:
Removed from v.1.42  
changed lines
  Added in v.1.43