.\"	@(MHWARNING).\" @(#)$Id: popi.rf,v 1.1 1992/02/06 22:46:24 jromine Exp $.SC POPI 1.NApopi \- POP initiator.SYpopi\%[+folder]\%[\-host\ host] \%[\-user\ user]\%[\-apop] \%[\-noapop]\%[\-rpop] \%[\-norpop]@BEGIN: BPOP\%[\-auto] \%[\-noauto]\%[\-mshproc\ program]@END: BPOP\%[\-form\ formatfile]\%[\-format\ string]\%[\-width\ columns]\%[\-help].DE\fIpopi\fR is an interactive program that implements the client sideof the Post Office Protocol (version 3).When invoked,\fIpopi\fR establishes a POP connection,and enters a command loop.The user may type most of the normal POP commands,with a couple of additions:The commands that \fIpop\fR currently supports are:.sp 1.in +.5idele msg .brlast.brlist [msg].brnoop.brquit.brretr msg.brrset.brscan.brstat.brtop@BEGIN: BPOP.brmsh@END: BPOP.in -.5i.spThe \fIretr\fR command retrieves a message into the folder specifiedon the command line.The \fIscan\fR command downloads an MH format-string to the server(as determined from the `\-form\ formatfile' and `\-format switches),so that future invocations of the \fIlist\fR command will include ascan listing.The \fIquit\fR command terminates \fIpopi\fR,as does typing CTRL\-D.@BEGIN: BPOPThe \fImsh\fR command invokes the \fImshproc\fR.To override the default \fImshproc\fR and the profile entry,use the `\-mshproc\ program' switch.The `\-auto' switch causes \fIpopi\fR to invoke the \fImshproc\fR directly,and thence terminate when the \fImshproc\fR terminates.@END: BPOPThe `\-host\ host' switch specifies the POP server to use.If the `\-user\ user' switch is not given,then the current username is used.Normally,\fIpopi\fR will prompt for a password to use.However,if the `\-apop' switch is given,\fIpopi\fR will generate authentication credentials to providefor origin authentication and replay protection,but which do not involve sending a password in the clear over the network.Otherwise,if the `\-rpop' switch is given,then \fIpopi\fR will try to use a \*(lqtrusted\*(rq connection(ala the BSD r-commands)..Fi^$HOME/\&.mh\(ruprofile~^The user profile^@(MHETCPATH)/mtstailor~^tailor file.Pr^Path:~^To determine the user's MH directory.Ps^Msg\-Protect:~^To set mode when creating a new `file'@BEGIN: BPOP.Ps^mshproc:~^Program to read a given BBoard@END: BPOP.Samsh(1).De`+folder' defaults to \*(lqinbox\*(rq.Ds`\-noapop'.Ds`\-norpop'@BEGIN: BPOP.Ds`\-auto'@END: BPOP.Ds`\-format' defaulted as described above.Ds`\-width' defaulted to the width of the terminal.CoThe folder into which messages are being incorporated will become thecurrent folder.The current message is unchanged..BuThe argument to the `\-format' switch must be interpreted as a single tokenby the shell that invokes \fIinc\fR.Therefore,one must usually place the argument to this switch inside double\-quotes..En