9 date 92.02.06.22.46.24; author jromine; state Exp;
31 \%[\-host\ host] \%[\-user\ user]
32 \%[\-apop] \%[\-noapop]
33 \%[\-rpop] \%[\-norpop]
35 \%[\-auto] \%[\-noauto]
36 \%[\-mshproc\ program]
38 \%[\-form\ formatfile]
43 \fIpopi\fR is an interactive program that implements the client side
44 of the Post Office Protocol (version 3).
47 \fIpopi\fR establishes a POP connection,
48 and enters a command loop.
49 The user may type most of the normal POP commands,
50 with a couple of additions:
51 The commands that \fIpop\fR currently supports are:
79 The \fIretr\fR command retrieves a message into the folder specified
81 The \fIscan\fR command downloads an MH format-string to the server
82 (as determined from the `\-form\ formatfile' and `\-format switches),
83 so that future invocations of the \fIlist\fR command will include a
85 The \fIquit\fR command terminates \fIpopi\fR,
86 as does typing CTRL\-D.
89 The \fImsh\fR command invokes the \fImshproc\fR.
90 To override the default \fImshproc\fR and the profile entry,
91 use the `\-mshproc\ program' switch.
92 The `\-auto' switch causes \fIpopi\fR to invoke the \fImshproc\fR directly,
93 and thence terminate when the \fImshproc\fR terminates.
96 The `\-host\ host' switch specifies the POP server to use.
97 If the `\-user\ user' switch is not given,
98 then the current username is used.
100 \fIpopi\fR will prompt for a password to use.
102 if the `\-apop' switch is given,
103 \fIpopi\fR will generate authentication credentials to provide
104 for origin authentication and replay protection,
105 but which do not involve sending a password in the clear over the network.
107 if the `\-rpop' switch is given,
108 then \fIpopi\fR will try to use a \*(lqtrusted\*(rq connection
109 (ala the BSD r-commands).
111 ^$HOME/\&.mh\(ruprofile~^The user profile
112 ^@@(MHETCPATH)/mtstailor~^tailor file
114 ^Path:~^To determine the user's MH directory
116 ^Msg\-Protect:~^To set mode when creating a new `file'
119 ^mshproc:~^Program to read a given BBoard
124 `+folder' defaults to \*(lqinbox\*(rq
134 `\-format' defaulted as described above
136 `\-width' defaulted to the width of the terminal
138 The folder into which messages are being incorporated will become the
140 The current message is unchanged.
142 The argument to the `\-format' switch must be interpreted as a single token
143 by the shell that invokes \fIinc\fR.
145 one must usually place the argument to this switch inside double\-quotes.