2 .\" @(#)$Id: popi.rf,v 1.1 1992/02/06 22:46:24 jromine Exp $
9 \%[\-host\ host] \%[\-user\ user]
10 \%[\-apop] \%[\-noapop]
11 \%[\-rpop] \%[\-norpop]
13 \%[\-auto] \%[\-noauto]
14 \%[\-mshproc\ program]
16 \%[\-form\ formatfile]
21 \fIpopi\fR is an interactive program that implements the client side
22 of the Post Office Protocol (version 3).
25 \fIpopi\fR establishes a POP connection,
26 and enters a command loop.
27 The user may type most of the normal POP commands,
28 with a couple of additions:
29 The commands that \fIpop\fR currently supports are:
57 The \fIretr\fR command retrieves a message into the folder specified
59 The \fIscan\fR command downloads an MH format-string to the server
60 (as determined from the `\-form\ formatfile' and `\-format switches),
61 so that future invocations of the \fIlist\fR command will include a
63 The \fIquit\fR command terminates \fIpopi\fR,
64 as does typing CTRL\-D.
67 The \fImsh\fR command invokes the \fImshproc\fR.
68 To override the default \fImshproc\fR and the profile entry,
69 use the `\-mshproc\ program' switch.
70 The `\-auto' switch causes \fIpopi\fR to invoke the \fImshproc\fR directly,
71 and thence terminate when the \fImshproc\fR terminates.
74 The `\-host\ host' switch specifies the POP server to use.
75 If the `\-user\ user' switch is not given,
76 then the current username is used.
78 \fIpopi\fR will prompt for a password to use.
80 if the `\-apop' switch is given,
81 \fIpopi\fR will generate authentication credentials to provide
82 for origin authentication and replay protection,
83 but which do not involve sending a password in the clear over the network.
85 if the `\-rpop' switch is given,
86 then \fIpopi\fR will try to use a \*(lqtrusted\*(rq connection
87 (ala the BSD r-commands).
89 ^$HOME/\&.mh\(ruprofile~^The user profile
90 ^@(MHETCPATH)/mtstailor~^tailor file
92 ^Path:~^To determine the user's MH directory
94 ^Msg\-Protect:~^To set mode when creating a new `file'
97 ^mshproc:~^Program to read a given BBoard
102 `+folder' defaults to \*(lqinbox\*(rq
112 `\-format' defaulted as described above
114 `\-width' defaulted to the width of the terminal
116 The folder into which messages are being incorporated will become the
118 The current message is unchanged.
120 The argument to the `\-format' switch must be interpreted as a single token
121 by the shell that invokes \fIinc\fR.
123 one must usually place the argument to this switch inside double\-quotes.