.!---------------------------------------------------------------------- .! .! File: pine.rnh .! .! 25-Jul-1997 (MN) .! 04-Aug-1997 .! .! Runofff source for (Open)VMS online help, converted from pine.1. .! .! Build: $ RUNOFF pine.rnh .! $ LIBRARY/HELP/INSERT pine.hlp .! .!---------------------------------------------------------------------- .noflags .lm2;.rm72 .indent -2 1 pine .br PINE Version 3.91 .sk;.lm+2 Read and send electronic mail with an easy user interface. .sk;.lm-2 SYNTAX .sk;.literal pine [-r] [-k] [-z] [-h] [-l] [-conf] [-f folder ] [-d debug-level ] [-n message-num ] [-sort order ] [-i keystrokes ] [-p config-file ] [-P config-file ] [ address , address ] .end literal;.sk .!---------------------------------------------------------------------- .indent -2 2 DESCRIPTION .br Pine is a mail user agent designed primarily for novice users, though it's full-featured enough for processing large amounts of mail. Pine is completely interactive and runs on 80x24 or larger terminals, making use of the full screen. Some of the design principles were to keep things simple and straight-forward with a limited number of well selected features; to provide the user with a menu to pick commands from; to be forgiving of mistakes so the user can learn while doing without fear of disaster, and to provide immediate feedback to the user for each command. Pine has its own tightly integrated pager for scrolling though incoming messages and its own editor (Pico) for composing messages. .sk Pine uses the c-client library to access mail files. The c-client acts as a switch between different mail file formats/drivers. Currently it understands Berkeley mail files, Tenex mail files, the IMAP2bis protocol, and NetNews. IMAP2bis is the Interactive Mail Access Protocol described in RFC 1176 and modified by the IMAP2bis draft paper. With an IMAP server such as imapd running on a central host users can access their e-mail from many different hosts on the network without having to login to the central host. .sk Outgoing mail is usually handed off to sendmail, but it can also be posted directly via SMTP when configured to do so in the .pinerc file or the global pine.conf file. (SMTP is the Simple Mail Transfer Protocol defined in RFC-822). .sk Pine also supports MIME, The Multipurpose Internet Mail Extensions defined in RFC-1341. This allows Pine to send and receive multipart and multimedia e-mail. Pine meets the minimal MIME compliance requirements and is able to view most parts of any received MIME message and to save all parts to files, whatever their format. On the composing side, the focus of the MIME implementation has been to allow users to attach files to messages so they can transfer arbitrary messages, rather than on creating true multimedia e-mail with graphics and sounds. This allows UNIX Pine and PC-Pine users to mail spread sheets and other such files back and forth. Pine will recognize a few of the multimedia formats such as GIF files. When they are attached they are tagged as being images and if Pine is running on an X-terminal it will call xloadimage or xv to display them. .sk .!---------------------------------------------------------------------- .indent -2 2 OPTIONS .br -d .sk;.lm+2 debug-level Debugging will be output to the .pine-debugX file at level debug-level (0-9). A debug-level of 0 turns debugging off for the session. .sk;.lm-2 -f .sk;.lm+2 folder Open named folder (in place of INBOX) on startup. .sk;.lm-2 -i .sk;.lm+2 Initial (comma separated list of) keystrokes which Pine should execute on startup. If no keystrokes are specified, Pine starts up in the FOLDER INDEX screen. .sk;.lm-2 -k .sk;.lm+2 Use function keys for commands. .sk;.lm-2 -l .sk;.lm+2 When displaying folder list, expand all collections. .sk;.lm-2 -n .sk;.lm+2 Pine will start up with the specified message number being the current message. .sk;.lm-2 -p .sk;.lm+2 Use the named file as the configuration file instead of .pinerc. .sk;.lm-2 -P .sk;.lm+2 Use the named file as the configuration file instead of the regular system-wide configuration file pine.conf . .sk;.lm-2 -r .sk;.lm+2 Go into restricted demo mode. Pine will only send mail to itself and functions like save and export are restricted. .sk;.lm-2 -sort .sk;.lm+2 Sort the display of the index of the folder in one of the following orders: arrival, subject, from, date, size, or reverse. Arrival order is the default. Any sort may be reversed by adding /reverse to it. Reverse by itself is the same as arrival/reverse. .sk;.lm-2 -z .sk;.lm+2 Enable ^Z or SIGTSTP so pine may be suspended. .sk;.lm-2
.sk;.lm+2 Send mail to
. This will cause Pine to go directly into the message composer. .sk;.lm-2 -h .sk;.lm+2 Print out help on the possible flags and arguments that can be give in Pine. .sk;.lm-2 -conf .sk;.lm+2 Produce a sample/fresh copy of the system Pine configuration file on the standard output. This is distinct from the per user .pinerc file. .sk;.lm-2 .!---------------------------------------------------------------------- .indent -2 2 FEATURES .br This documentation is not intended to be complete. The help screens in Pine constitute the main documentation. There are also some technical notes with the source. A general overview of features includes: .sk;.lm+2 View, save, export, delete, print, reply and forward incoming mail. .sk Compose message in a simple editor with word wrap and spelling checker. A message under composition may be temporarily postponed while other work in Pine is being done. .sk Full screen selection and management of mail folders. .sk Address book to keep a list of long or frequently used addresses. Distribution lists are available and may refer to other lists or entries as many levels deep as desired. Address book entries can be taken from incoming mail without retyping them. .sk New mail checking and notification occurs automatically every thirty seconds. .sk On-line, context-sensitive help screens. .sk;.lm-2 .!---------------------------------------------------------------------- .indent -2 2 FILES .br .literal Unix /usr/spool/mail/xxxx Folder for incoming mail ~/.addressbook ASCII address book file ~/mail Directory of mail folders ~/.pine-debugx Diagnostic log for debugging ~/.pinerc The user pine configuration file /usr/local/lib/pine.info Local pointer to system administrator /usr/local/lib/pine.conf System wide pine configuration file /tmp/.\usr\spool\mail\xxxx Read/write per folder/mailbox lock files VMS SYS$LOGIN:.PINERC The user pine configuration file SYS$LOGIN:.ADDRBOOK ASCII address book file SYS$LOGIN:.PINE-DEBUGx Diagnostic log for debugging PINE_CONF_DIR:PINE-CONF.FIXED System wide pine configuration file PINE_CONF_DIR:PINE.CONF Default user configuration file .end literal .sk .!---------------------------------------------------------------------- .indent -2 2 SEE_ALSO .br pico .sk .!---------------------------------------------------------------------- .indent -2 2 AUTHORS .br Mike Seibel, Steve Hubert, David Miller, and Mark Crispin, with contributions on the design from many others .sk .!----------------------------------------------------------------------