Title:  How do I insert, attach, and detach files using Pine?

Question:
How do I insert, attach, and detach files using Pine?

Answer:
Using Pine, you can insert or attach files when you send email messages. 
You can also use it to detach files from messages sent to you. Before you
can send a file, whether by attachment or insertion, it must reside on
your account. If it's not on your account you'll have to upload it first,
which is a topic covered elsewhere. 

Once the file resides on your account, you can start Pine. Then you have
the choice of inserting the file into a message or attaching it to a
message. When you receive a message with an attached file you might have
the option of viewing it directly. You'll always be given the option of
saving the attachment. This is all outlined below in horrifying detail. 

INSERTING A PLAIN TEXT FILE 

To insert a plain text file into the body of an email message: 

    1. Type C to compose a new email message. 

    2. Fill in the message header information (the To: and Subject:
       fields). 

    3. Move the cursor below the Message Text line and type whatever
       message you like. 

    4. At the point where you want to insert a plain text file into your
       message, press ^R for Read File.

    5. At the prompt, you can either: 

       A. Type the name of the text file you want to insert. 

       or 

       B. Press ^T. 

       The ^T option lets you look through your files and directories so
       you can select the file you want to insert. 

    6. Once you specify a file using one of the above methods, press
       {enter}. 

       Pine inserts the file into the body of the email message. 


ATTACHING A FILE 

You can also attach non-text files and plain text files to Pine email
messages. Non-text files include formatted word processing files,
spreadsheet files, graphic files, and even sound and image files. 

To attach a file to an email message: 

    1. Type C to compose a new email message. 

    2. Fill in the message header information (the To: and Subject:
       fields). 

    3. While the cursor is still in the message header, press ^J.  This
       invokes Pine's "Attach" command, which is presented in amongst the
       other commands at the bottom of Pine's screen. 

    4. At the resulting prompt, you can either: 

       A. Type the name of the file you want to attach. 

       or 

       B. Press ^T. 

       The ^T option lets you look through your files and directories so
       you can select the file you want to attach. 

    5. After you specify a file, using one of the above methods, press
       {enter}. 

    6. At the "Attachment comment:" prompt, you can either: 

       A. Type a few words describing the file and press {enter}. 

       or 

       B. If you do not want to add a comment, press {enter}. 

       Once you have added a comment, Pine displays the attachment's 
       filename and your comment in the Attachment header field. You 
       can attach several files to a single email message by repeating 
       steps 3-6. 

When you are finished attaching files, you can type a subject and a message
or send just the attached file(s). 


DETACHING A FILE 

When you receive an email message containing an attachment, you can save
the attachment to a file. 

To save an attachment as a file: 

    1. Select the message containing the attachment from Pine's Folder Index
       screen and type V or press {enter} to view it. 

    2. From the Message Text screen, type V to "ViewAttch."

       Pine lists any text in the body of the email message as attachment
       number one. All subsequent attachment numbers are the files that
       have been attached to this message. 

    3. Now, from the "Attachment Index" screen select the appropriate
       attachment.

    4. When you have selected the attachment you want to save, type S
       to "Save" the attachment to a file on your account. 

       (Note that you can also select "View" in some cases, but this
       depends on the type of file and the setup of the system you are
       using.)

    5. At the "Copy attachment to file in home directory:" prompt, you
       can either: 

       A. Type a filename for the attachment. 

          or 

       B. Type nothing. 

       By default, Pine will use the attachment's original filename. 

    6. Press {enter}. 

       Pine saves the attachment as a file. Now you can then use the
       appropriate program to view or process the file.