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

Diff for /src/usr.bin/msgs/Attic/msgs.1 between version 1.14 and 1.15

version 1.14, 2003/06/03 02:56:13 version 1.15, 2003/10/04 21:55:12
Line 38 
Line 38 
 .Nd system messages and junk mail program  .Nd system messages and junk mail program
 .Sh SYNOPSIS  .Sh SYNOPSIS
 .Nm msgs  .Nm msgs
 .Op Fl fhlpqr  .Op Fl fhlopqr
 .Op Ar number  .Op Oo Fl Oc Ar number
 .Op Ar \-number  
 .Nm msgs  .Nm msgs
 .Op Fl s  .Op Fl s
 .Nm msgs  .Nm msgs
 .Op Fl c Op Ar days  .Op Fl c Op Fl Ns Ar days
 .Sh DESCRIPTION  .Sh DESCRIPTION
 .Nm msgs  .Nm msgs
 is used to read system messages.  is used to read system messages.
Line 56 
Line 55 
 of the system.  of the system.
 .Pp  .Pp
 The options are as follows:  The options are as follows:
 .Bl -tag -width Ds  .Bl -tag -width "-number"
   .It Fl c Fl Ns Ar days
   The
   .Fl c
   option is used for performing cleanup on
   .Pa /var/msgs .
   An entry with the
   .Fl c
   option should be placed in the system
   .Xr crontab 5
   to run every night.
   This will remove all messages over 21 days old.
   The optional
   .Fl Ns Ar days
   argument may be specified on the command line to override the default.
 .It Fl f  .It Fl f
 Do not say  Do not say
 .Dq \&No new messages.  .Dq \&No new messages.
 This is useful in a  This is useful in a
 .Pa .login  .Pa .login
 file since this is often the case here.  file since this is often the case here.
   .It Fl h
   Print the first part of messages only.
   .It Fl l
   Causes only locally originated messages to be reported.
   .It Fl o
   By default,
   .Nm
   exits when there are no more messages to read.
   If the
   .Fl o
   flag is specified,
   the user will be given the chance to save or read messages again.
   .It Fl p
   Pipe long messages through the program specified by the
   .Ev PAGER
   environment variable.
   If
   .Ev PAGER
   is null or not defined,
   .Xr more 1
   is used.
 .It Fl q  .It Fl q
 Queries whether there are messages, printing  Queries whether there are messages, printing
 .Dq There are new messages.  .Dq There are new messages.
 if there are.  if there are.
 The command  The command
 .Ic msgs \-q  .Ic msgs -q
 is often used in login scripts.  is often used in login scripts.
 .It Fl h  
 Print the first part of messages only.  
 .It Fl r  .It Fl r
 Disables the ability to save messages or enter the mailer.  Disables the ability to save messages or enter the mailer.
 It is assumed that the  It is assumed that the
 .Ev PAGER  .Ev PAGER
 environment is set to something secure.  environment is set to something secure.
 .It Fl l  .It Fl s
 Causes only locally originated messages to be reported.  The
   .Fl s
   option is used for setting up the posting of messages.
   The line
   .Pp
   .Dl msgs: \&"| /usr/bin/msgs -s\&"
   .Pp
   should be included in
   .Pa /etc/mail/aliases
   (see
   .Xr newaliases 8 )
   to enable posting of messages.
 .It Ar number  .It Ar number
 A message number can be given  A message number can be given
 on the command line, causing  on the command line, causing
 .Nm msgs  .Nm msgs
 to start at the specified message rather than at the next message  to start at the specified message rather than at the next message
 indicated by your  indicated by your
 .Pa \&.msgsrc  .Pa .msgsrc
 file.  file.
 Thus  Thus
 .Pp  .Pp
 .Dl msgs \-h 1  .Dl msgs -h 1
 .Pp  .Pp
 prints the first part of all messages.  prints the first part of all messages.
 .It Ar \-number  .It Fl Ns Ar number
 Start  Start
 .Ar number  .Ar number
 messages back from the one indicated in the  messages back from the one indicated in the
 .Pa \&.msgsrc  .Pa .msgsrc
 file, useful for reviews of recent messages.  file; useful for reviews of recent messages.
 .It Fl p  
 Pipe long messages through the program specified by the  
 .Ev PAGER  
 environment variable.  
 If  
 .Ev PAGER  
 is null or not defined,  
 .Xr more 1  
 is used.  
 .El  .El
 .Pp  .Pp
 .Nm msgs  .Nm msgs
Line 131 
Line 165 
 .It Ic n  .It Ic n
 Skip this message  Skip this message
 and go on to the next message.  and go on to the next message.
 .It Ic \&-  .It Ic -
 Redisplay the last message.  Redisplay the last message.
 .It Ic q  .It Ic q
 Drop out of  Drop out of
Line 143 
Line 177 
 Append the current message to the file  Append the current message to the file
 .Pa Messages  .Pa Messages
 in the current directory;  in the current directory;
 .Sq s\-  .Sq s-
 will save the previously displayed message.  will save the previously displayed message.
 An  An
 .Sq s  .Sq s
 or  or
 .Sq s\-  .Sq s-
 may be followed by a space and a file name to receive the message replacing  may be followed by a space and a file name to receive the message replacing
 the default  the default
 .Dq Messages .  .Dq Messages .
Line 174 
Line 208 
 and  and
 .Ic s  .Ic s
 all accept a numeric argument in place of the  all accept a numeric argument in place of the
 .Sq \&- .  .Sq - .
 .Pp  .Pp
 .Nm msgs  .Nm msgs
 keeps track of the next message you will see by a number in the file  keeps track of the next message you will see by a number in the file
 .Pa \&.msgsrc  .Pa .msgsrc
 in your home directory.  in your home directory.
 In the directory  In the directory
 .Pa /var/msgs  .Pa /var/msgs
Line 190 
Line 224 
 so that  so that
 .Nm msgs  .Nm msgs
 can quickly determine if there are no messages for you.  can quickly determine if there are no messages for you.
 If the contents of  .\" If the contents of
 .Pa bounds  .\" .Pa bounds
 is incorrect it can be fixed by removing it;  .\" is incorrect it can be fixed by removing it;
 .Nm msgs  .\" .Nm msgs
 will make a new  .\" will make a new
 .Pa bounds  .\" .Pa bounds
 file the next time it is run.  .\" file the next time it is run.
 .Pp  .Pp
 The  
 .Fl s  
 option is used for setting up the posting of messages.  
 The line  
 .Pp  
 .Dl msgs: \&"\&| /usr/bin/msgs \-s\&"  
 .Pp  
 should be included in  
 .Pa /etc/mail/aliases  
 (see  
 .Xr newaliases 8 )  
 to enable posting of messages.  
 .Pp  
 The  
 .Fl c  
 option is used for performing cleanup on  
 .Pa /var/msgs .  
 An entry with the  
 .Fl c  
 option should be placed in  
 .Pa /etc/crontab  
 to run every night.  
 This will remove all messages over 21 days old.  
 A different expiration may be specified on the command line to override  
 the default.  
 .Pp  
 Within  Within
 .Nm msgs  .Nm msgs
 you can also go to any specific message by typing its number when  you can also go to any specific message by typing its number when
Line 251 
Line 259 
 .Xr mail 1 ,  .Xr mail 1 ,
 .Xr more 1 ,  .Xr more 1 ,
 .Xr aliases 5 ,  .Xr aliases 5 ,
 .\".Xr crontab 5 ,  .Xr crontab 5 ,
 .Xr newaliases 8  .Xr newaliases 8
 .Sh HISTORY  .Sh HISTORY
 The  The
Legend:
Removed from v.1.14  
changed lines
  Added in v.1.15