Pine is one of a number of mail agents available under Unix. A mail agent is
the technical term that refers to a program that you can use to send or
read electronic mail. Other mail agents available on the Unix systems at
UNCA include: mail, emacs, and Xmailtool. The remainder of this
document will be focused on using Pine under Unix, at the end we will
describe some minor changes found when using the DOS version.
Pine was developed at the University of Washington as a follow on product to the Elm mail system. The goals set forth in the development of Pine were:
To accomplish the first goal, Pine uses a menu based interface. Pine always presents all possible choices to the users based on where on where you are in Pine. Each menu choice is prefixed with a single letter, pressing that letter invokes that menu item. The primary menu in Pine is called the "MAIN MENU". This menu is displayed when you invoke pine, from this menu you can send mail, read mail, or configure Pine to your personal preferences.
Figure 1. The Pine Main Menu _______________________________________________________________________________ PINE 3.05 MAIN MENU Folder:inbox 17 Messages ? HELP - Get help using Pine C COMPOSE - Compose and send a message I MAIL INDEX - Read mail in current folder F FOLDERS - Open a different mail folder A ADDRESSES - Update your address book O OTHER - Use other functions Q QUIT - Exit the Pine mail program [Folder "inbox" opened with 17 messages] ? Help Q Quit F Folders O Other C Compose I Mail Index A Addresses _______________________________________________________________________________The top line of the menu describes the version of Pine being used, in this case version 3.05; the particular Pine menu you are in; the name of the mail folder you are using; and the number of messages to be read. This line will appear in all of the Pine menus, the only item that will change is the name of the menu. If you ever get confused within Pine, refer to this line to find which menu you are using. Following the top line is a list of menu choices available, each choice is prefixed with a single character which when typed invokes that choice. For example, pressing the question mark character on the keyboard causes pine to display the help menus. The bottom of the screen gives a simple summary of the commands available. Finally, pine is not case sensitive when referring to the menu choices and will accept both the lower and upper case character.
The Pine Help Menu
As noted above pressing the question mark character "?" will invoke
the help menu. Help in Pine is context based, meaning you will receive
different help screens based on what menu you were in when you
requested help. When in the main menu the help menu is a 25 page Pine
User's Guide describing different features of Pine. Many of the
features described are more advanced features of Pine that will only
confuse the first-time user. However, as with all Pine menus the help
menu will list the choices available to the user at the bottom of the
screen. In this case the following appears
M Main Menu E Exit Help - Prev Page L Print SPACE Next Page W Where isOut of context on the screen, this seems confusing. On the screen the choices M, E, -, L, W, and SPACE are highlighted in reverse video. Selecting "M" takes you out of the help menu and back to the main menu. Selecting "E" takes you of help and returns you back to the menu you were at when you selected help (in our case that was the main menu, however help is available from any menu. The word "SPACE" refers to the space bar, pressing the space bar displays the next page of the help text, likewise pressing the minus key "-" displays the previous page. Pressing the character "L" causes Pine to print out the help text on your default printer. If you would like to get more information than this document provides on using pine that is the best
The Pine Compose Menu
Pressing the letter "C" will invoke the compose message menu. This menu is used for sending electronic mail to other users (possibly including yourself). Once the compose menu is selected Pine brings up a new menu named "Compose Message." The menu you receive is found below in Figure 2.
Figure 2. The Pine Compose Message Menu _______________________________________________________________________________ PINE 3.05 COMPOSE MESSAGE Folder:inbox 17 Messages To : Cc : Attchmnt: Subject : ----- Message Text ----- Jack Suess UMBC Academic Computing Internet: Jack@umbc.edu Standard Disclaimer: Bitnet: Jack@umbc The opinions expressed above are mine and ATT: 410.455.2582 not my employers. ^G Get Help ^C Cancel ^R Rich Hdr ^K Del Line ^O Postpone ^X Send ^D Del Char ^J Attach ^U UnDel Lin^T To AddrBk ______________________________________________________________________________
The compose message menu is really divided into two distinct parts. The top four lines, above the line "----- Message Text -----", are referred to as the message header. Below that line you are in what is referred to as the "Message Text" portion of the message. The menu options displayed at the bottom of the screen are dependent on whether you are above or below the "----- Message Text -----" line. Above the line you have the options shown above, below the line you have a different set of options described below. At any time within the compose message menu you can move back and forth between the message header and message text areas. In fact, often when writing the message you will decide it useful to add another recipient to the mail message. if so, you can use the arrow (or sometimes called cursor) keys to position the cursor back to the "To" or "Cc" prompt and add the new user.
The message header lines define whom to send the mail too as well the subject line and file attachments to include. The "To" prompt is where you list the recipients of your mail message. The "Cc" prompt is where you specify a carbon-copy of the message to be sent to related parties. The "attachment" prompt is where you may specify files to be sent as attachments to the recipients, this will be described in more detail later in the document. Finally, the subject line is where you give a brief description of the topic of the message.
With many messages you don't care to "Cc" others or add file attachments, to bypass these lines you may either press the return key or use the arrow key to move to the next line. Once you have entered a subject line and pressed return the cursor moves below the line "----- Message Text -----" and you have entered the mail message editor which will be described in the next section.
When in the message header (the lines above "----- Message Text -----") a number of options appear. You will notice that some of the options appear as two characters, for example "^G" for get help. The "^" refers to the control key. On some keyboards this key is labeled "Control", on others it is labeled "Ctrl". In either case "^G" implies you press down the control key, keep it depressed and then press the key that follows, in this case "G". The control key is functioning like the shift key, meaning by itself it does nothing, only when pressed in conjunction with another character does it have an affect.
While many sub-menus inside the compose menu are beyond the scope of this document a few are important. Below is a summary:
^G Get Help ^C Cancel ^R Read File ^Y Prev Pg ^K Del Line ^O Postpone ^X Send ^J Justify ^_ Alt Edit ^V Next Pg ^U UnDel Lin ^T To SpellAs discussed above, all commands starting with "^" refer to using the control key, thus "^G" means hold down the control key and press the letter "G". The Pine editor Pico can be used outside of Pine for any text editing work you need to do. To invoke the Pico editor at the Unix prompt enter the command "pico filename", where filename is the name of the file you wish to edit.
Pico supports the arrow or cursor keys for moving in the file. Thus you can use the up, down, left, and right arrows. Below is a summary of the pico commands:
Reading Your Mail, the Mail Index Menu.
The Mail Index menu lists the messages waiting to be read. By default the
messages are listed in Chronological order, oldest to most recent. This
order is configurable within Pine, for example messages may be sorted in
reverse chronological order, by subject, by size, or by username.
Figure 3, shown below, is representative of the Mail Index menu.
Figure 3. The Mail Index Menu ______________________________________________________________________________ PINE 3.05 MAIL INDEX Folder:inbox Message 1 of 4 N 1 Sep 10 email@example.com (6,182) N 2 Sep 10 firstname.lastname@example.org (4,075) N 3 Sep 10 email@example.com (2,069) N 4 Sep 10 firstname.lastname@example.org (2,972) ? Help M Main Menu P Prev Msg - Prev Page F Forward D Delete O OTHER CMDS V View Mail N Next Msg SPACE Next Page R Reply S Save ______________________________________________________________________________Messages flagged with a "N" on the left hand side signify new messages that have not been read yet. Messages where the left side of the message number is blank represent messages that have been read before but are awaiting some action. Pine will leave messages in your Inbox until you explicitly tell Pine to do something with that message. Your choices are too delete or save the message. Leaving messages in your Mail Index is a useful way of keeping a "todo" list.
Upon entering the Mail Index Menu the default action is to view the first unread message. Pressing the return key causes Pine to read the first unread message. Pine will display one screen at a time of the message, pressing the space bar instructs pine to display the next screen. If you wish to read a specific message in your Mail Index you may either use the up and down arrow keys or press "N" for next message and "P" for previous message. As you move within the Mail Index the message you have selected is highlighted.
Once you have selected the message there are a number of things you may do with the message. These are summarized below:
When replying or forwarding mail to another user Pine will prompt you regarding whether to include the original message in the reply. Pine uses the standard Compose Message menu we described previously when replying or forwarding mail.
The Pine Folder Maintenance Menu.
In the previous section we briefly discussed mail folders. Mail folders
allow you to organize electronic mail you have received in a logical
fashion for future reference. From the Main Menu, selecting "F" involves
the Folder Maintenance menu. Figure 4. is an example of the display
that a beginning user might have.
Figure 4. The Folder Maintenance Menu ______________________________________________________________________________ inbox sent-mail saved-messages accounts acounts addresses afs ansys apple asa bio bsd ? Help M Main Menu G Go to Fldr - Prev Page A Add D Delete O Open L Print SPACE Next Page R Rename W Where is ______________________________________________________________________________Generally folders are displayed alphabetically; however there are three exceptions to this. The inbox folder is where new mail is saved, selecting this folder is the same as selecting the Mail Index option from the main menu. The other two folders "sent-mail" and "saved-messages" are automatically created by Pine on your behalf. Pine records a copy of every outgoing message in the folder "sent-mail", in essence you are automatically carbon-copying yourself on outgoing mail. The folder "saved-messages" is the default folder to save mail in when you select the Save Message option from within the Mail Index menu (described in the previous section).
To select a folder to read use the arrow keys to select the folder. The left arrow moves you a folder to the left, right moves to the right, up and down arrow keys move up and down. As you select a folder it will be highlighted, press return when you have the folder you would like to select.
Once a folder has been selected Pine automatically invokes the Mail Index Menu is invoked using that folder. All commands available in the Mail Index Menu are now available. You can print, delete, reply, or forward messages.
The Address Book.
Since email addresses are often long and in many cases difficult to
remember Pine provides an easy to use address book. The address book is
selected by entering the letter "A" at the Main Menu. There are two
types of addresses, individual and list. A list is where you define a
group of email addresses to be a single name. An individual address can
refer to only one email address.
Creating a signature file.
Pine automatically includes a file named .signature
into your message text. Generally, this file should be no more than
four lines and contain how to reach you. Below is a sample one that I
Jack Suess UMBC Academic Computing Internet: Jack@umbc.edu Standard Disclaimer: Bitnet: Jack@umbc The opinions expressed above are mine and ATT: 410.455.2582 not my employers.Create the .signature file in your default directory using the pico editor by entering the Unix command "pico .signature". If you want to change the name of the file used for your signature file edit the file
# Name of file to read signature out of for inclusion in outgoing mail signature-file=Place the name of the file you wish to use after the equal sign.
By default pine places the signature at the beginning of replies and forwarded
messages. If you do not want this behavior edit the
Electronic Mail Addresses.
A note on email addressing here at UNCA. Students and faculty who have unix
accounts receive mail using
Others at UNCA have accounts on the VAX and have e-mail addresses
email@example.com. You will
find that you need to communicate with people are at other institutions.
For internet mail addresses all you need to do is specify the full
email address of the recipient.
At UNCA, we have an online phonebook available via gopher to find
people within the University
of North Carolina Asheville system.
Using Attachments in Pine
Pine supports a standard known as MIME. MIME allows file attachments to be sent through mail. These file attachments can be files with binary character data, such as Word Perfect files, programs, data files, or Graphics output. The easiest method of sending a file attachment is to include the name of the file on the Attachment prompt when Composing a message. You may include as many files as wish, each will be sent as a separate attachment.
When you reading a mail message inside the Mail Index menu you may enter the
"A" to handle an attachment sent to you.
Pine will ask which attachment you wish to view or save. Enter the number
of the attachment and press return.
Then you will be prompted whether to view or save the attachment. In general,
you will not be able to view attachments and should just select save. Then
you will be prompted for the name of the file to save this under.
Forwarding Mail to Another Account.
Often faculty and students have more than one computer account. It is wise to
have all mail forwarded to one account where you read mail instead of trying
to sign on and manage multiple email accounts. This is easily done on Unix
by creating a file in your account named
To forward your mail from one location to another, sign onto the machines
you want mail forwarded from and create a file named
file should have one line which is the email address where you want to
forward your mail. A valid forward file would contain one line and look
"firstname.lastname@example.org". On the VAX you
enter the mail utility via the command
set forward "IN%""email@example.com"".