X-Git-Url: http://git.marmaro.de/?p=mmh;a=blobdiff_plain;f=man%2Fmsgchk.man;h=1b9843b6c0ba16e6573f79f4cc1a68827492e8f8;hp=2f1fed5bba5b8237dde6bda9e77a3ab4b38786e5;hb=363190329760d38060e89956206583831b0d084d;hpb=cfc525a9b85207225cb4071d1d3b01e8d1db2424 diff --git a/man/msgchk.man b/man/msgchk.man index 2f1fed5..1b9843b 100644 --- a/man/msgchk.man +++ b/man/msgchk.man @@ -1,114 +1,99 @@ .\" .\" %nmhwarning% -.\" $Id$ .\" -.\" include the -mh macro file -.so %etcdir%/tmac.h -.\" -.TH MSGCHK %manext1% MH.6.8 [%nmhversion%] +.TH MSGCHK %manext1% "%nmhdate%" MH.6.8 [%nmhversion%] .SH NAME msgchk \- check for messages .SH SYNOPSIS -.in +.5i -.ti -.5i -msgchk -\%[\-date] \%[\-nodate] -\%[\-notify\ all/mail/nomail] -.br -\%[\-nonotify\ all/mail/nomail] -.br -%nmhbeginpop% -\%[\-host\ hostname] -\%[\-user\ username] -\%[\-kpop] -\%[\-sasl] -\%[\-saslmech \mechanism] -.br -%nmhendpop% -\%[users\ ...] -\%[\-version] -\%[\-help] -.in -.5i +.HP 5 +.na +.B msgchk +.RB [ \-date " | " \-nodate ] +.RB [ \-notify +all/mail/nomail ] +.RB [ \-nonotify +all/mail/nomail ] +.RI [ users +\&... ] +.RB [ \-version ] +.RB [ \-help ] +.ad .SH DESCRIPTION -The \fImsgchk\fR program checks all known mail drops for mail waiting -for you. For those drops which have mail for you, \fImsgchk\fR will +The +.B msgchk +program checks all known mail drops for mail waiting +for you. For those drops which have mail for you, +.B msgchk +will indicate if it believes that you have seen the mail in question before. - -The `\-notify\ type' switch indicates under what circumstances -\fImsgchk\fR should produce a message. The default is `\-notify\ all' -which says that \fImsgchk\fR should always report the status of the +.PP +The +.B \-notify +.I type +switch indicates under what circumstances +.B msgchk +should produce a message. The default is +.B \-notify +.I all +which says that +.B msgchk +should always report the status of the users maildrop. Other values for `type' include `mail' which says that -\fImsgchk\fR should report the status of waiting mail; and, `nomail' -which says that \fImsgchk\fR should report the status of empty maildrops. -The `\-nonotify\ type' switch has the inverted sense, so -`\-nonotify\ all' directs \fImsgchk\fR to never report the status of -maildrops. This is useful if the user wishes to check \fImsgchk\fR's -exit status. A non\-zero exit status indicates that mail was \fBnot\fR +.B msgchk +should report the status of waiting mail; and, `nomail' +which says that +.B msgchk +should report the status of empty maildrops. +The +.B \-nonotify +.I type +switch has the inverted sense, so +.B \-nonotify +.I all +directs +.B msgchk +to never report the status of +maildrops. This is useful if the user wishes to check +.BR msgchk 's +exit status. A non\-zero exit status indicates that mail was +.B not waiting for at least one of the indicated users. - -If \fImsgchk\fR produces output, then the `\-date' switch directs -\fImsgchk\fR to print out the last date mail was read, if this can +.PP +If +.B msgchk +produces output, then the +.B \-date +switch directs +.B msgchk +to print out the last date mail was read, if this can be determined. -%nmhbeginpop% - -.Uh "Using POP" -\fImsgchk\fR will normally check all the local mail drops, but if -the option \*(lqpophost:\*(rq is set in the mts configuration file -\*(lqmts.conf\*(rq, or if the `\-host\ hostname' switch is given, -\fImsgchk\fR will query this POP service host as to the status of -mail waiting. - -The default is for \fImsgchk\fR to assume that your account name -on the POP server is the same as your current username. To specify -a different username, use the `\-user\ username' switch. - -When using POP, you will normally need to type the password for -your account on the POP server, in order to retrieve your messages. -It is possible to automate this process by creating a \*(lq.netrc\*(rq -file containing your login account information for this POP server. -For each POP server, this file should have a line of the following -form. Replace the words mypopserver, mylogin, and mypassword with -your own account information. - -machine mypopserver login mylogin password mypassword - -This \*(lq.netrc\*(rq file should be owned and readable only by -you. -For debugging purposes, there is also a switch `\-snoop', which will -allow you to watch the POP transaction take place between you and the -POP server. - -If nmh has been compiled with KPOP #defined, the `\-kpop' switch will allow -\fImsgchk\fR to use Kerberized POP rather than standard POP3 on a given -invocation. If POPSERVICE was also #defined to "kpop", \fImsgchk\fR will be -hardwired to always use KPOP. - -If nmh has been compiled with SASL support, the `\-sasl' switch will enable -the use of SASL authentication. Depending on the SASL mechanism used, this -may require an additional password prompt from the user (but the -\*(lq.netrc\*(rq file can be used to store this password). The -`\-saslmech' switch can be used to select a particular SASL mechanism. - -If SASL authentication is successful, \fIinc\fR will attempt to negotiate -a security layer for session encryption. Encrypted traffic is labelled -with `(encrypted)' and `(decrypted)' when viewing the POP transaction -with the `\-snoop' switch. -%nmhendpop% -.Fi -^$HOME/\&.mh\(ruprofile~^The user profile +.SH FILES +.fc ^ ~ +.nf +.ta \w'%etcdir%/ExtraBigFileName 'u +^$HOME/.mmh/profile~^The user profile ^%etcdir%/mts.conf~^nmh mts configuration file ^%mailspool%/$USER~^Location of mail drop -.Pr +.fi + +.SH "PROFILE COMPONENTS" +.fc ^ ~ +.nf +.ta 2.4i +.ta \w'ExtraBigProfileName 'u None -.Sa +.fi + +.SH "SEE ALSO" inc(1) -.De -`user' defaults to the current user -.Ds -`\-date' -.Ds -`\-notify\ all' -.Co + +.SH DEFAULTS +.nf +.RB ` user "' defaults to the current user" +.RB ` \-date ' +.RB ` "\-notify\ all" ' +.fi + +.SH CONTEXT None -.En