<?xml version="1.0" encoding="ISO-8859-1"?><html xmlns="http://www.w3.org/1999/xhtml" xmlns:xh="http://www.w3.org/1999/xhtml" xmlns:axle="http://www.cs.odu.edu/~zeil/axle" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:ns0="http://www.cs.odu.edu/~zeil/axle" mode="ignore" id="pine" ns0:xlinkuri="open/pine.dbk" ns0:xpath="//*[@id='pine']" ns0:page="pine"><head><title>The PINE E-mail program</title><link type="text/css" href="_axle/docbookstyle.css" rel="stylesheet"/><link type="text/css" href="_axle/cppformat.css" rel="stylesheet"/><link type="text/css" href="_axle/overrides.css" rel="stylesheet"/><script src="_axle/docbook.js"/><script>function gotoNext() {}
function gotoPrev() {}
function gotoUp() {}
</script><xhtml:link xmlns:xhtml="http://www.w3.org/1999/xhtml" rel="stylesheet" href="_axle/navigation.css" type="text/css"/><xhtml:script xmlns:xhtml="http://www.w3.org/1999/xhtml" src="_axle/navigation.js"/></head><body><table width="100%" class="navigationBar"><tr class="navigationBar"><td class="navigationBar"/><td width="5%" class="navigationBar"><a class="navigationBar" title="CS252 Home" href="http://cocoon.cs.odu.edu:80/cocoon/~cs252/directory/announcements.html"><img class="navigationBar" src="_axle/home.gif" alt="CS252 Home"/></a></td><td width="5%" class="navigationBar"><a class="navigationBar" title="discuss this page" href="http://cocoon.cs.odu.edu:80/cocoon/~cs252/forum/getXPath/open/pine/pine.html"><img class="navigationBar" src="_axle/forum.gif" alt="discuss this page"/></a></td></tr></table><br/><div class="info_article"><div class="title_article">The PINE E-mail program</div><div class="author_article"><span class="firstname">Steven</span> <span class="othername" role="mi">J</span> <span class="surname">Zeil</span></div><div class="affiliation">
        <span class="orgname">Old Dominion University</span>
        <span class="orgdiv">Dept. of Computer Science</span>
      </div><table width="100%"><tr><td align="left"><span class="copyright">©<span class="year">2000-2006</span> <span class="holder">Steven J. Zeil, Old Dominion University</span></span></td><td/><td align="right"><span class="date">Jul. 16, 2005</span></td></tr></table></div>
  
  <div class="epigraph">
    <p class="para" align="center">
              (A printable version of this document is available 
              <a url="allPages.html" href="allPages.html">here</a>.)
            </p>
  </div>
  <p class="para"><span class="code">pine</span> is a popular program for e-mail on our system. It is
menu-driven, includes a substantial built-in help system, and can
process and send MIME mail. It can be used over a text-based (e.g.,
telnet) connection with no loss of features.</p>
  <p class="para">To run <span class="code">pine</span>, make sure that you have correctly identified your
<a href="../loggingin/#termtypes">terminal kind</a>. Then give the command
<div class="screen"><span class="userinput">
   pine
</span></div></p>
  <p class="para">You should see a menu resembling <a href="#pinemain">Figure 1: <span class="title_xref">Pine Main Menu</span></a>.
<div class="figure" id="pinemain"><p class="para"><div class="programlisting">
PINE 3.90   MAIN MENU                            Folder: INBOX  22 Messages   


       ?     HELP               -  Get help using Pine

       C     COMPOSE MESSAGE    -  Compose and send/post a message

       I     FOLDER INDEX       -  View messages in current folder

       L     FOLDER LIST        -  Select a folder OR news group to view

       A     ADDRESS BOOK       -  Update address book

       S     SETUP              -  Configure or update Pine

       Q     QUIT               -  Exit the Pine program
</div></p><div class="info_figure"><div class="title_figure">Figure 1: Pine Main Menu</div></div></div>
If you get a garbled screen instead, you probably have not set your
<a href="../loggingIn/#termtypes">terminal kind</a> correctly.</p>
  <p class="para">The most important choices are <span class="quote">
      &#8220;C&#8221;
    </span> to compose a message and send it
to someone, and <span class="quote">
      &#8220;I&#8221;
    </span> to view an index of messages sent to you.</p>
  <p class="formalpara"><span class="title_formalpara">Sending Messages: </span></p>
  <p class="para">Type <span class="quote">
      &#8220;C&#8221;
    </span> to compose a message to send to someone.  You should see a
screen resembling <a href="#pinecompose">Figure 2: <span class="title_xref">Sending mail with Pine</span></a>.
<div class="figure" id="pinecompose"><p class="para"><div class="programlisting">
To      : 
Cc      : 
Attchmnt: 
Subject : 
----- Message Text -----







^G Get Help  ^X Send      ^R Rich Hdr  ^Y PrvPg/Top ^K Cut Line  ^O Postpone  
^C Cancel    ^D Del Char  ^J Attach    ^V NxtPg/End ^U UnDel Line^T To AddrBk 
</div></p><div class="info_figure"><div class="title_figure">Figure 2: Sending mail with Pine</div></div></div>
One thing to note is the list of possible commands in the lower two
lines of the screen.  In almost any context, <span class="code">pine</span> will list the
commands available to you, including a command to get
<span class="quote">
      &#8220;help&#8221;
    </span> information.</p>
  <p class="para">Use your up/down arrow keys to select the <span class="quote">
      &#8220;To:&#8221;
    </span> line at the top of
the screen. Here you can enter the e-mail address you want to send a
message to. Just below that, on the <span class="quote">
      &#8220;CC:&#8221;
    </span> line, you can add the
e-mail addresses of any other people to whom you would like copies of your
message sent. Two lines down is the <span class="quote">
      &#8220;Subject:&#8221;
    </span> line. Although you
are not required to put anything here, proper e-mail <span class="quote">
      &#8220;etiquette&#8221;
    </span> calls
for all messages to carry a useful entry in the <span class="quote">
      &#8220;Subject:&#8221;
    </span> line.</p>
  <p class="para">Finally, move the cursor below the <span class="quote">
      &#8220;Message Text&#8221;
    </span> line, and you can
begin typing your message.</p>
  <p class="para">When you are done and are ready to send your message, type ^X to
send it.</p>
  <p class="para">A common variation on this procedure is when you need to send someone
a copy of a file as part of your message. For example, if you are
sending your instructor a question about some code you are writing,
you might want to include the code in question as part of the
message.  Pine provides two ways to do this.  The easiest is to go up
to the <span class="quote">
      &#8220;Attchmnt:&#8221;
    </span> line near the top of the screen. Any file names
you type on this line will be <span class="quote">
      &#8220;attached&#8221;
    </span> to the final message when
it is sent (i.e., a copy is sent --- your original files will be
untouched). Alternatively, while you are typing your message you can ^R to insert a file directly into the text of your message.</p>
  <p class="para">Some points to keep in mind when deciding which approach to use are:
<div class="variablelist"><dl><dt class="varlistentry"><span class="term">Attachment:</span></dt><dd class="varlistitem">  
<div class="itemizedlist"><ul><li>Recipient of message must be using <span class="code">pine</span> or some other
MIME-capable mail program.</li><li>Can be used to send non-text files (e.g., programs, graphics,
etc) as well as standard text.</li><li>Can send multiple files without confusion. File names are
preserved as part of the attachment.</li></ul></div></dd><dt class="varlistentry"><span class="term">^R</span></dt><dd class="varlistitem">  
<div class="itemizedlist"><ul><li>Recipient of message can use any mail program.</li><li>Can only be used to send text files.</li><li>File names are lost. If you try to include more than one file in
a message, the boundaries between the files are likely to be unclear
to the reader.</li></ul></div></dd></dl></div></p>
  <p class="formalpara"><span class="title_formalpara">Receiving Messages: </span></p>
  <p class="para">From the main menu screen, type <span class="quote">
      &#8220;I&#8221;
    </span> to get a list of the messages in
your system <span class="quote">
      &#8220;mail-box&#8221;
    </span>.  It will look something like <a href="#pineindex">Figure 3: <span class="title_xref">Reading mail with Pine</span></a>.
<div class="figure" id="pineindex"><p class="para"><div class="programlisting">
  PINE 3.90   FOLDER INDEX                 Folder: INBOX  Message 5 of 5      

+ A 1   Nov  6 JohnDoe@elsewhere. (34,483) Looking for volunteers
+   2   Nov  8 JohnDoe@elsewhere.  (2,472) Still need volunteers
    3   Nov 13 MaryJones@aol.com   (4,310) Conference on Programming
    4   Nov 20 Root                (1,432) Re: your account
    5   Nov 22 Professor Z           (747) Overdue Homework




? Help       M Main Menu  P PrevMsg     - PrevPage    D Delete      R Reply
O OTHER CMDS V [ViewMsg]  N NextMsg   Spc NextPage    U Undelete    F Forward

</div></p><div class="info_figure"><div class="title_figure">Figure 3: Reading mail with Pine</div></div></div>
The plus signs in front of some messages indicate that you have
already read them.  The <span class="quote">
      &#8220;A&#8221;
    </span> in front of message 1 indicates that you
have already sent an answer to that message.</p>
  <p class="para">Using your up/down arrow keys, you can select any of these messages
and then type <span class="quote">
      &#8220;V&#8221;
    </span> to view the message.</p>
  <p class="para">While viewing messages, refer to the bottom two lines of your screen
for the commands to page up/down through long messages, to compose and
send replies to a message, to <span class="quote">
      &#8220;forward&#8221;
    </span> a copy of the message to
someone else, or to return to the main menu (see <a href="#pinemain">Figure 1: <span class="title_xref">Pine Main Menu</span></a>).</p>
  <p class="para">If the message you are viewing is a MIME style message with attached
files, another <span class="quote">
      &#8220;V&#8221;
    </span> command will allow you to view these files (if
they are text, graphics, etc) or to save them in a directory of your
choice. Also, the <span class="quote">
      &#8220;E&#8221;
    </span> (Export) command will allow you to save the
text of the current message in a file even if it is not a MIME
message.</p>
  <p class="formalpara"><span class="title_formalpara">Folders: </span></p>
  <p class="para">After you have read some messages and try to exit from <span class="code">pine</span>,
<span class="code">pine</span> will ask if you wish it to move your read messages out of
your system mail-box (called the <span class="quote">
      &#8220;INBOX&#8221;
    </span>) into a <span class="quote">
      &#8220;read-messages
folder&#8221;
    </span>. A <span class="emphasis">folder</span> is simply a container that can hold mail
messages. <span class="code">Pine</span> treats your system mail-box as simply a special
form of folder.  To see a list of your folders and to select one in
which you want to view messages, use the <span class="quote">
      &#8220;L&#8221;
    </span> command from the
<span class="code">pine</span> main menu.</p>
  <p class="para">Moving read messages out of your system mail-box into another folder
is often a good idea.  It eases strain on the system resource area
used for incoming e-mail. It means that when you enter  <span class="code">pine</span>
and immediately hit the <span class="quote">
      &#8220;I&#8221;
    </span> key, you see your new mail right way
instead of having it mixed in with old stuff.  Finally, you can
organize your saved mail by creating your own folders to save messages
in. For example, you might have a folder for each class you are
taking, to keep e-mail about different classes in separate
containers. You can create new folders from inside the <span class="quote">
      &#8220;L&#8221;
    </span>
command. To move a mail message that you are viewing into a folder,
use the <span class="quote">
      &#8220;S&#8221;
    </span> save command.</p>
<br/><table width="100%" class="navigationBar"><tr class="navigationBar"><td class="navigationBar"/><td width="5%" class="navigationBar"><a class="navigationBar" title="CS252 Home" href="http://cocoon.cs.odu.edu:80/cocoon/~cs252/directory/announcements.html"><img class="navigationBar" src="_axle/home.gif" alt="CS252 Home"/></a></td><td width="5%" class="navigationBar"><a class="navigationBar" title="discuss this page" href="http://cocoon.cs.odu.edu:80/cocoon/~cs252/forum/getXPath/open/pine/pine.html"><img class="navigationBar" src="_axle/forum.gif" alt="discuss this page"/></a></td></tr></table></body></html>