Pine At FNAL - Fermi-specific documentation on folder config values

Pine At FNAL 5/17/99 - Michael Stolz

* A careful look at some of the configuration *
* parameters most likely to affect you. *

Pine parameters can be set either thru pine's own 'Setup' menu option, or by using your favorite editor. There are several instances where the 'Setup' menu option is unable to do what is needed. If you cannot find a way to modify certain parameters thru the pine Setup Menu, your only other option is to modify the pine configuration via your favorite editor.

For most changes, this document will give examples using both methods, but editing the .pinerc file is the only guaranteed way of making all possible changes.

All examples point to imapserver1.fnal.gov, if your mail is on a different machine, you will need to make the appropriate adjustments.

There are several important variables within the .pinerc file which determine where pine will look for your mail folders. Each variable will be explained and discussed, and examples for some common 'multiple-variable' scenarios included afterwards.

inbox-path=
This parameter points to your primary inbox location. If there is no set value, it uses your Unix system default area (often /usr/mail). Your primary inbox is the location where your mail arrives *before* you have actually read it.

A value of 'inbox-path={imapserver1.fnal.gov}inbox' will set your primary inbox to be imapserver1.

If you are already redirecting your new mail to another location (typically done thru a .maildelivery file) you will want to change your inbox-path= parameter to point to the same location.

If you have redirected mail to your #mh-style inbox, you would change this value to: inbox-path=#mh/inbox .

A value of 'inbox-path=nsmail/Inbox' will set your primary inbox to be Netscape's default inbox.

incoming-folders=
This parameter lists all additional mail inboxes you want to be able to see via pine. Multiple values should be separated with commas. Entries that are included in this parameter are *in addition* to your primary inbox as defined by the inbox-path= parameter (above).

Examples include:
   #mh/inbox - mh-style inbox (as defined by the file .mh_profile)
   nsmail/Inbox - the default Netscape inbox
   {imapserver1.fnal.gov}inbox - the imapserver inbox

folder-collections=
This parameter lists all mail folder collections you want to be able to see via pine. Folder collections normally consist of those mail folders that are *not* inbox folders. Multiple values should be separated with commas. Pine v4_05 will display both a mail folder (sent-mail), and a drill-down folder (sent-mail/). The latter allows you to have a heirarchy of nested folders within your folder collection.

Examples include:
#mh #mh/[], - mh-style folder collection (defined by the file .mh_profile)
   mail mail/[], - the default pine folder collection
   nsmail nsmail/[], - the default Netscape folder collection
   {imapserver1.fnal.gov}[] - the imapserver folder collection

read-message-folder=
The Fermi v4_05 version of pine has been configured to automatically move your newly read mail to a 'read-messages' folder within your home area. You can change the name of this folder by making use of this parameter or, if you are using the imapserver, you can tell pine to *not* move your new mail at all. An example of the first option would be: 'read-message-folder=in-process', and an example of turning this automatic move off would be: 'read-message-folder=""'. Do NOT turn this automatic move off unless you are also defining the imapserver as your primary inbox!

news-collections=
The Fermi v4_05 version of pine has been configured to automatically make Usenet news readable, and it appears as another mail collection area. Some pine users are not interested in reading Usenet news, and may want pine to take them directly to their primary folder colection. To prevent the nntp new server from showing up as a folder collection set: news-collections="" . If the user has only a single mail folder collection, pine will skip the 'list' of folder collections it normally offers the user, and will immedeiately the user to the folder list for the primary folder collection.

By editor, modify the variables in your .pinerc file as follows:

# To make the imapserver your exclusive mail home

   inbox-path ={imapserver1.fnal.gov}inbox
   folder-collections="Mail on imapserver1.fnal.gov" {imapserver1.fnal.gov}[]
   read-message-folder=""

# To make the imapserver your secondary mail home

   incoming-folders={imapserver1.fnal.gov}inbox
   folder-collections=mail mail/[],
       "Mail on imapserver1" {imapserver1.fnal.gov}[]

# If you are already using mh-style mail folders to store your local
# mail, you would add the imapserver as follows:

   incoming-folders=#mh/inbox,
       {imapserver1.fnal.gov}inbox 
   folder-collections=#mh #mh/[],
       "Mail on imapserver1" {imapserver1.fnal.gov}[]

# If you are also using Netscape on your local Unix box for reading mail,
# you can access the Netscape default folders by adding the following lines:

- to incoming-folders= -add-
       , nsmail/Inbox
- to folder-collections= -add-
       , nsmail nsmail/[]

***

Via pine's 'Setup' menu option, modify the variables in your .pinerc file as follows:

# To make the imapserver your exclusive mail home in the SETUP CONFIGURATION window,

inbox-path                 = {imapserver1.fnal.gov}inbox 
read-message-folder        =  - (use a 'space' to get this)

# from main menu, select S(etup), then L(collectionList), then A(dd Cltn)
# in the FOLDER COLLECTION EDIT window, set:

Nickname : Mail on imapserver1.fnal.gov
Server : imapserver1.fnal.gov 
Path : 
View :

# you will need to remove other collectionLists if they exist

# To prevent the nntp new server from showing up as a folder collection -
# *this cannot be done from within pine*

# To make the imapserver your secondary mail home *follow the steps
# listed above, but do NOT remove preexisting folder collections*

# If you are also using Netscape on your local Unix box for reading mail, you
# can access the Netscape default folders by making the following changes:

# from main menu, select S(etup), then L(collectionList), then A(dd Cltn)
# in the FOLDER COLLECTION EDIT window, set:

Nickname : nsmail 
Server : nsmail/
Path : 
View :