This is the configuration menu for Pine with selected annotations derived from the help screens. You reach this menu from the Main Menu, by choosing S for Setup and C for Config.

Type ? to get the help dialog for each feature.

The results of this configuration dialog are written to a file in your home directory called .pinerc. You can edit it directly, but you should be very careful and back it up before you mess with it. Here's an example

personal-name = <No Value Set: using "John Coleman">

This value is used to determine the full name part of the "From" address on messages you send. If unset, Unix Pine will obtain your full name from the system password file.

user-domain = <Value is Fixed: using "pantheon.yale.edu">

smtp-server = <Value is Fixed: using "">

nntp-server = <No Value Set: using "news.yale.edu">

inbox-path = <No Value Set: using "/var/mail/jcoleman">

folder-collections = mail/[ ]

Folder collections are "places" to store folders. They roughly correspond to a filesystem " directory". Pine will normally provide you with one folder collection by default. Using this option, you may specify additional collections. These collections may be local or remote, but they must correspond to a pre-existing filesystem directory, i.e. Pine will not create any directory other than the original default.

The first folder collection listed here is the default collection for the Save command -- the place various folders are put unless you specify otherwise.

A valid local collection is just the specification of a directory on the local system followed by square brackets.

news-collections = <No Value Set: using "*{news.yale.edu/nntp}[]">

This is like Read-Message-Folder, only more general. You may archive any of the folders in your incoming collection. This is a list of folder pairs, with the first separated from the second in the pair by a space. The first folder in a pair is the folder you want to archive, and the second folder is the folder that read messages from the first should be moved to. Depending on how you define the "auto-move-read-messages" setting in the "feature-list", you may or may not be asked when you leave the first folder if you want read messages to be moved to the second folder. In either case, moving the messages means they will be deleted from the first folder.

If these are not path names, they will be in the default collection for saves. Any valid folder specification, local or remote (via IMAP), is allowed. There is no default.

pruned-folders = repair

This variable allows you to define a list of one or more folders that Pine will offer to prune for you in the same way it automatically offers to prune your "sent-mail" folder each month.

That is, once a month for each folder listed, Pine will offer to move the contents of the folder to a new folder of the same name but with the previous month's date appended. Pine will then look for any such date-appended folder names created for a previous month, and offer each one it finds for deletion.

If you decline the first offer, no mail is moved and no new folder is created.

Folders listed are assumed to exist, and the archive folders will be created, in the first collection defined by the "folder-collections" variable.

default-fcc = <No Value Set: using "sent-mail">

This value specifies where a copy of outgoing mail should be saved. If this is not a path name, it will be in the default collection for saves. Any valid folder specification, local or IMAP, is allowed. This default folder carbon copy only applies when the fcc-rule-name (see later in this configuration screen) is set to use the default folder. Unix Pine default is normally "sent-mail" in the default folder collection.

To suppress saving of outgoing mail, set: default-fcc=""

default-saved-msg-folder = <No Value Set: using "saved-messages">

This option determines the default folder name for Saves... If this is not a path name, it will be in the default collection for saves. Any valid folder specification, local or IMAP, is allowed. This default folder only applies when the saved-msg-name-rule (see later in this configuration screen) doesn't override it. Unix Pine default is normally " saved-messages" in the default folder collection.

postponed-folder = <No Value Set: using "postponed-msgs">

read-message-folder = INBOX.read

By virtue of specifying a folder name here, Pine will be configured to save all messages which you have read during a session into the designated "read messages" folder. This allows you to more easily distinguish between your really new email (in your INBOX) and those which you have already read. Depending on how you define the "auto-move-read-messages" setting in the "feature-list", you may or may not be asked when you quit Pine if you want read messages to be moved to this folder. In either case, moving the messages means they will be deleted from your INBOX.

If this is not a path name, it will be in the default collection for saves. Any valid folder specification, local or remote (via IMAP), is allowed. There is no default for the name of the read message folder.

signature-file = <No Value Set: using ".signature">

To create or edit your signature file choose Setup from the Main Menu and then select S for Signature (Main/Setup/Signature). This puts you into the Signature Editor where you can enter a *few* lines of text containing your identity and affiliation.

global-address-book = <No Value Set: using ""System-wide Addressbook" ...">

address-book = <No Value Set: using ".addressbook">

feature-list =

Feature Name

[ ] allow-talk

[ ] assume-slow-link

[ ] auto-move-read-msgs

This feature controls an aspect of Pine's behavior upon quitting. If set, and the "read-message-folder" variable is also set, then Pine will automatically transfer all read messages to the designated folder and mark them as deleted in the INBOX. Messages in the INBOX marked with an "N" (meaning New, or unseen) are not affected.

[ ] auto-open-next-unread

This feature controls the behavior of the TAB key when traversing folders in the optional "incoming-folders" collection or in optional "news-collections". When the TAB (Next New) key is pressed, and there are no more unseen messages in the current (incoming message or news) folder, Pine will search the list of folders in the current collection for one containing New or Recent (new since the last time the folder was opened) messages. Normally, when such a folder is found, Pine will ask whether you wish to open the folder. If this feature is set, Pine will automatically open the folder without prompting.

[ ] auto-zoom-after-select

This feature affects the behavior of the Select command. If set, the select command will automatically perform a zoom after the select is complete.

[ ] auto-unzoom-after-apply

This feature affects the behavior of the Apply command. If set, and if you are currently looking at a Zoomed Index view of selected messages, the Apply command will do the operation you specify, but then will implicitly do an "UnZoom", so that you will automatically be back in the normal Index view after the Apply.

[ ] compose-cut-from-cursor

This feature controls the behavior of the Control-K command in the composer. If set, ^K will cut from the current cursor position to the end of the line, rather than cutting the entire line.

[ ] compose-maps-delete-key-to-ctrl-d

[ ] compose-rejects-unqualified-addrs

[ ] compose-send-offers-first-filter

[ ] compose-sets-newsgroup-without-confirm

[ ] delete-skips-deleted

This feature controls an aspect of Pine's Delete command. If set, this feature will cause the Delete command to advance past other messages that are marked deleted. In other words, pressing "D" will both mark the current message deleted and advance to the next message that is not marked deleted.

[ ] disable-keymenu

[ ] enable-8bit-esmtp-negotiation

[ ] enable-8bit-nntp-posting

[ ] enable-aggregate-command-set

Setting this feature enables the commands and subcommands that relate to performing operations on more than one message at a time. We call these "aggregate operations". In particular, the "; Select", "A Apply", and "Z Zoom" commands are enabled by this feature. Select is used to "tag" one or more messages meeting the specified criteria. Apply can then be used to apply any message command to all of the selected/tagged messages. Further, the Zoom command allows you to toggle the Folder Index view between just those Selected and all messages in the folder.

This feature also enables the "^X" subcommand in the FOLDER INDEX WhereIs command which causes all messages matching the WhereIs argument to become selected.

[ ] enable-alternate-editor-cmd

If this feature is set, and the "editor" variable is not set, entering the ^_ (Control-underscore) key while composing a message will prompt you for the name of the editor you would like to use. If the environment variable $EDITOR is set, this value will be offered as a default. If "editor" variable is set, the ^_ key will activate the specified editor without prompting, in which case it is not necessary to set the "enable-alternate-editor-cmd" feature.

[ ] enable-alternate-editor-implicitly

If this feature and the "editor" variable are both set, Pine will automatically activate the specified editor when the cursor is moved from the header of the message being composed into the message text. For replies, the alternate editor will be activated immediately. If this feature is set but the "editor" variable is not set, then Pine will automatically ask for the name of an alternate editor when the cursor is moved out of the header being composed, or if a reply is being done.

[ ] enable-bounce-cmd

Setting this feature enables the "B Bounce" command, which will prompt for an address and *remail* the message to the new recipient. This command is used to re-direct messages that you have received in error, or need to be redirected for some other reason (e.g. list moderation). The final recipient will see a header indicating that you have Resent the msg, but the message's From: header will show the original author of the message, and replies to it will go back to that author, and not to you.

[ ] enable-cruise-mode

his feature affects Pine's behavior when you hit the "Space Bar" at the end of a displayed message. Typically, Pine complains that the end of the text has already been reached. Setting this feature causes such keystrokes to be interpreted as if the "Tab" key had been hit, thus taking you to the next "interesting" message, or scanning ahead to the next incoming folder with "interesting" messages.

[ ] enable-cruise-mode-delete

This feature modifies the behavior of Pine's "enable-cruise-mode" feature. Setting this feature causes pine to implicitly delete read messages when it moves on to display the next "Interesting" message. NOTE: Beware when enabling this feature AND the "expunge-without-confirm" feature.

[ ] enable-dot-files

When this feature is set, files beginning with dot (".") will be visible in the file browser. For example, you'll be able to select them when using the browser to add an attachment to a message.

[ ] enable-dot-folders

[ ] enable-flag-cmd

Setting this feature enables the "* Flag" command which allows you to manipulate the status flags associated with a message. By default, Flag will set the "Important" flag, which results in an asterisk being displayed in column one of the FOLDER INDEX for such messages.

[ ] enable-flag-screen-implicitly

The feature modifies the behavior of the "* Flag" command (provided it too is enabled). By default, when the "* Flag" command is selected, Pine offers a prompt to set one of several flags and also offers the option of entering the detailed flag manipulation screen via the "^T" key. Enabling this feature causes Pine to immediately enter the detailed flag screen rather than first offer the simple prompt.

[ ] enable-full-header-cmd

This feature enables the "H Full Headers" command which toggles between the display of all headers in the message and the normal edited view of headers. The Full Header command also controls which headers are included for Export, Pipe, Print, Forward, and Reply functions. (For Reply, the Full Header mode will respect the "include-headers-in-reply" feature setting.)

[ ] enable-goto-in-file-browser

This feature modifies the behavior of Pine's file browser. Setting this feature causes Pine to offer the "G Goto" command in the file browser.

This command allows you to explicitly set the displayed directory. Pine's default behavior requires you to visit each related directory when between two distant directories.

[ ] enable-incoming-folders

If set, this feature defines a pseudo-folder collection called "INCOMING MESSAGE FOLDERS". Initially, the only folder included in this collection will be your INBOX, which will no longer show up in your default saved-message folder collection. You may add more folders to the Incoming Message Folders collection by using the "A Add" command in the FOLDER LIST screen. You will be prompted for the host the folder is stored on (which defaults to the same host used for your INBOX), a nickname, and the actual folder name. Once a set of Incoming Message Folders are defined, the TAB key (in FOLDER INDEX or MESSAGE TEXT screens) may be used to scan the folders for those with Recent messages. NOTE: Pine does not do "delivery filtering"; this is the province of other programs such as "filter" or "procmail". Pine's Incoming Message Folders collection provides a convenient way to access multiple incoming folders, once they are created by other programs.

[ ] enable-jump-shortcut

Setting this feature will allow you to enter a number (followed by RETURN) and jump to that message number, when in the FOLDER INDEX or MESSAGE TEXT screens. In other words, it obviates the need for typing the "J" for the Jump command.

[ ] enable-mail-check-cue

[ ] enable-mouse-in-xterm

[ ] enable-newmail-in-xterm-icon

[ ] enable-suspend

Setting this feature will allow you to type ^Z (Control Z) and temporarily suspend Pine.

[ ] enable-tab-completion

This feature enables the TAB key when at a prompt for a filename. In this case, TAB will cause the partial name already entered to be automatically completed, provided the partial name is unambiguous.

[ ] enable-unix-pipe-cmd

This feature enables the "| Pipe" command that sends the current message to the specified Unix command for external processing.

[ ] enable-verbose-smtp-posting

[ ] expanded-view-of-addressbooks

If multiple address books (either personal or global) are defined, and y wish to have them all expanded implicitly upon entering the ADDRESS BOOK screen, then set this feature.

[ ] expanded-view-of-distribution-lists

If this feature is set, then distribution lists in the address book screen will be expanded automatically.

[ ] expanded-view-of-folders

If multiple folder collections are defined, and you wish to have them all expanded implicitly upon entering the FOLDER LIST screen, then set this feature.

[ ] expunge-without-confirm

This features controls an aspect of Pine's eXpunge command. If set, you will not be prompted to confirm your intent before the expunge takes place.

[ ] fcc-on-bounce

This feature controls an aspect of Pine's behavior when bouncing a message. If set, normal FCC ("File Carbon Copy") processing will be done, just as if you had composed a message to the address you are bouncing to. If not set, no FCC of the message will be saved.

[ ] include-attachments-in-reply

This feature controls an aspect of Pine's Reply command. If set, any MIME attachments that were part of the original message will automatically be included in the Reply.

[ ] include-header-in-reply

This feature controls an aspect of Pine's Reply command. If set, and the original message is being included in the reply, then headers from that message will also be part of the reply.

[ ] include-text-in-reply

This feature controls an aspect of Pine's Reply command. Normally, Pine will ask whether you wish to include the original message in your reply. If this feature is set, the original message will be included in the reply automatically, without prompting.

[ ] news-approximates-new-status

[ ] news-post-without-validation

[ ] news-read-in-newsrc-order

[ ] pass-control-characters-as-is

[ ] preserve-start-stop-characters

[ ] print-offers-custom-cmd-prompt

[ ] print-includes-from-line

[ ] print-index-enabled

[ ] print-formfeed-between-messages

[ ] quell-dead-letter-on-cancel

[ ] quell-lock-failure-warnings

[ ] quell-status-message-beeping

This feature affects Pine's behavior when it displays status message (e.g., Error complaints, New mail warnings, etc). Setting this feature will not affect the display of such messages, but will cause those that emit a beep to become silent.

[ ] quell-user-lookup-in-passwd-file

[ ] quit-without-confirm

This feature controls whether or not Pine will ask for confirmation when a Quit command is received.

[ ] reply-always-uses-reply-to

This feature controls an aspect of Pine's Reply command. If set, Pine will not prompt when a message being replied to contains a "Reply-To:" header value, but will simply use its value (as opposed to using the "From:" field's value).

Note: Using the "Reply-To:" address is usually the preferred behavior, however, some mailing list managers choose to place the list's address in the "Reply-To:" field of any message sent out to the list. In such cases, this feature makes it all too easy for personal replies to be inadvertently sent to the entire mail list, so be careful!

[ ] save-will-quote-leading-froms

[ ] save-will-not-delete

This feature controls one aspect of the Save command. If set, Save will not mark the message "deleted" (its default behavior) after it has been copied to the designated folder.

[ ] save-will-advance

This feature controls one aspect of the Save command. If set, Save will (in addition to copying the current message to the designated folder) also advance to the next message.

[ ] select-without-confirm

This feature controls an aspect of Pine's Save, Export, and Goto commands. These commands all take text input to specify the name of the folder or file to be used, but allow you to press ^T for a list of possible names. If set, the selected name will be used immediately, without further opportunity to confirm or edit the name.

[ ] show-cursor

[ ] show-selected-in-boldface

This feature controls an aspect of Pine's aggregate operation commands; in particular, the Select and WhereIs commands. Select and WhereIs (with the ^X subcommand) will search the current folder for messages meeting a specified criteria, and "tag" the resulting messages with an "X" in the first column of the applicable lines in the FOLDER INDEX. If this feature is set, instead of using the "X" to denote a selected message, Pine will attempt to display those index lines in boldface. Whether this is preferable to the "X" will depend on personal taste and the type of terminal being used.

[ ] signature-at-bottom

This feature controls an aspect of Pine's Reply command. If this feature is set, and the original message is being included in the reply, then the contents of your signature file (if any) will be inserted after the included message, and the cursor will also be positioned after the included text.

[ ] single-column-folder-list

This feature controls an aspect of Pine's folder list screen. If set, the folders will be listed one per line instead of several per line in the folder list display.

[ ] tab-visits-next-new-message-only

[ ] use-current-dir

[ ] use-sender-not-x-sender

[ ] use-subshell-for-suspend

 

initial-keystroke-list = <No Value Set>

The initial keystroke --or command-- list option lets you start Pine at any place you like. Whatever keystrokes you specify here will be executed by Pine upon startup as a macro. The words SPACE, TAB, DOWN, UP, LEFT, and RIGHT indicate the pressing of those keys. CR indicates the pressing of the RETURN key. F1 through F12 represent the function keys. For example, to view message 1 on startup, you would specify i,j,1,CR,v.

Restriction: You cannot pre-type into the composer with the initial keystroke list.

default-composer-hdrs = <No Value Set>

You can decide which headers you want visible when composing outgoing email using this option. You can specify any of the regular set, any rich header or any custom header which you have already defined. If you use this setting at all, you must specify all the headers you want to see, you can't just add to the regular header set. The default set is To:, Cc:, Attchmnt:, and Subject:.

Note that the "Newsgroups:" header will be abbreviated in the Composer display, but should be spelled-in-full here.

customized-hdrs = <No Value Set>

viewer-hdrs = <No Value Set>

You may change the default list of headers that are viewed by listing the headers you want to view here. If the headers in your "viewer-hdrs" list are present in the message, then they will be shown. The order of the headers you list will be honored. If the special value "all-except" is included as the first header in the "viewer-hdrs" list, then all headers in the message except those in the list will be shown. The values are all case insensitive.

Note that once you put anything in the "viewer-hdrs" list, then the original default headers are ignored. So, if you just wanted to add the header Organization to the list, you'd have to list Organization plus all of the other headers originally in the default list. If you just included Organization and nothing else, then you'd see only the Organization header, nothing else.

The default list of headers includes: From, Resent-From, To, Resent-To, Cc, Resent-cc, Bcc, Newsgroups, Followup-To, Date, Resent-Date,Subject, Resent-Subject, and Reply-To.

saved-msg-name-rule =

This option determines the default folder name when saving (i.e. using the Save option) a message. Choose one of the following: default-folder, last-folder-used, by-from, by-sender, by-recipient, by-nick-of-from, by-nick-of-sender, by-nick-of-recip, by-fcc-of-from, by-fcc-of-sender, by-fcc-of-recip, by-nick-of-from-then-from, by-nick-of-sender-then-sender, by-nick-of-recip-then-recip, by-fcc-of-from-then-from, by-fcc-of-sender-then-sender, or by-fcc-of-recip-then-recip.

The default option is "default-folder", which is the folder called "saved-messages" in Unix Pine and "savemail" in PC-Pine. To change the default folder, modify the variable called "default-saved-msg-folder".

Choosing any of the "by-" options cause Pine to attempt to get the chosen option's value for the message being saved. For example, if "by-from" is chosen, Pine attempts to get the value of who the messagechosen option's value for the message being saved. For example, if "by-from" is chosen, Pine attempts to get the value of who the message came from (i.e. the from address). Pine then attempts to save the message to a folder matching that value. If "by-from" is chosen and no value is obtained, Pine uses "by-sender". The opposite is also true. If "by-recipient" was chosen and the message was posted to a newsgroup, Pine will use the newsgroup name.

If any of the "by-nick" options are chosen, the resulting address is looked up in the user's address book and if found, the nickname for that entry is used. Similarly, if any of the "by-fcc" options are chosen, the fcc from the corresponding address book entry is used. If no value is found in the address book, then if the chosen option ends with the "then-from", "then-sender", or "then-recip" suffix, Pine reverts to the same behavior as "by-from", "by-sender" or "by-recipient" depending on which option was specified. If the chosen option doesn't end with one of the "then-" suffixes, then Pine reverts to the default folder when no match is found in the address book.

Rule Values
( ) by-from
( ) by-nick-of-from
( ) by-nick-of-from-then-from
( ) by-fcc-of-from
( ) by-fcc-of-from-then-from
( ) by-sender
( ) by-nick-of-sender
( ) by-nick-of-sender-then-sender
( ) by-fcc-of-sender
( ) by-fcc-of-sender-then-sender
( ) by-recipient
( ) by-nick-of-recip
( ) by-nick-of-recip-then-recip
( ) by-fcc-of-recip
( ) by-fcc-of-recip-then-recip
( ) last-folder-used
(*) default-folder

fcc-name-rule =

This option determines the default name for folder carbon copy. Choose one: default-fcc, last-fcc-used, by-recipient, by-nickname, by-nick-then-recip, or current-folder.

Normal default is "default-fcc", the value of which is set in the "default-fcc" variable as specified earlier in this configuration.

The option "last-fcc-used" puts the folder that was last used in the fcc field.

The option "by-nickname" means that it will use the nickname from your address book that matches the first address in the To line. If there is no match, it will use the value of the "default-fcc" variable.

The option "by-recipient" means it will form a folder name based on the left hand side of the first address in the To line.The option "by-nick-then-recip" means that it will use the matching nickname from your address book if there is one, otherwise it will extract the recipient name from the address and use that (like by-recipient).

The option "current-folder" causes a copy to be written to the currently open folder, unless that is the INBOX. In the case where the current folder is the INBOX, the "default-fcc" is used instead.

Note that whatever the fcc specified by the rule here, it will be over-ridden by any fcc entries you have in your address book.

Rule Values
(*) default-fcc
( ) last-fcc-used
( ) by-recipient
( ) by-nickname
( ) by-nick-then-recip
( ) current-folder

sort-key =

This option determines the order in which messages will be displayed in the Folder Index screen. Choose from:
Date -- Sort folders according to the date and time they were sent. On a folder like INBOX, sorting by "Date" should be almost identical to sorting by "Arrival".
Arrival -- Sort messages into the order in which they arrived.
From -- Sort messages by the name of the author of the message. Messages with the same author are grouped together. Groups of messages are then put into alphabetical order according to message author.
Subject -- Sort messages by subject. Messages with the same subject are grouped together. Pine ignores leading "Re:" and "re:" and trailing "(fwd)" when determining the likeness and alphabetical order of subject lines. Groups of messages are put into alphabetical order according to subject.
OrderedSubj -- Grouping of all messages with the same subject together is done in the same way as sort by subject. With "OrderedSubj" however, groups of messages are put into date order according to the oldest message on a given subject. This sorting provides pseudo threading of messages.
ReverseDate -- Like "Date" but the newest message is first.
ReverseArrival -- Like "Arrival" but the newest message is first.
ReverseFrom -- Like "From" but groups of messages are ordered in reverse alphabetical order (Z-A).
ReverseSubject -- Like "Subject" but groups of messages are ordered in reverse alphabetical order (Z-A).
ReverseOrderedSubj -- Like "OrderedSubj" but groups of messages are ordered with the newest groups first (according to the first message of each group).

Normal default is "arrival".

Sort Options
( ) Date
( ) Arrival
( ) From
( ) Subject
( ) OrderedSubj
( ) To
( ) Cc

( ) siZe
(*) Reverse Date
( ) Reverse Arrival
( ) Reverse From
( ) Reverse Subject
( ) Reverse OrderedSubj
( ) Reverse To
( ) Reverse Cc
( ) Reverse siZe

addrbook-sort-rule =

This option controls the order in which address book entries will be presented. Choose one of the following:

fullname use fullname field, lists mixed in
fullname-with-lists-last use fullname field, but put lists at end
nickname use nickname field, lists mixed in
nickname-with-lists-last use nickname field, but put lists at end
dont-sort don't change order of file

The normal default is "fullname-with-lists-last".
Rule Values
(*) fullname-with-lists-last
( ) fullname
( ) nickname-with-lists-last
( ) nickname
( ) dont-sort

goto-default-rule =

This value affects Pine's behavior when you use the Goto command. Pine's usual behavior has two parts. If your current folder is "Inbox", Pine will offer the last open folder as the default. If the current folder is other than "Inbox", "Inbox" is offered as the default.

There are three possible values for this option. The default just described:

inbox-or-folder-in-recent-collection

The second accepted value is a variation on the default which again offers "Inbox" if it isn't currently open, but otherwise offers the most recent folder in the first collection found in the "FOLDER LIST" screen. It's called:

inbox-or-folder-in-first-collection The last accepted value simply causes the most recently opened folder to be offered as the default regardless of the currently opened folder. It's called:

most-recent-folder

NOTE: The default while a newsgroup is open remains the same; the last open newsgroup.

Rule Values
(*) inbox-or-folder-in-recent-collection
( ) inbox-or-folder-in-first-collection
( ) most-recent-folder

character-set = <No Value Set>

The character set is used primarily to mark outgoing email appropriately. Set it to whatever character set you might use to compose messages. Whenever you actually send a message, Pine checks it to see if it is, in fact, US-ASCII (a subset of the other sets allowable). If it is US-ASCII, the outgoing message will be marked as such no matter what you have set as your character set. Normal default is US-ASCII. Typical alternatives include ISO-8859-x, where x is a number between 1 and 9.

editor = vi

Editor specifies the program invoked by ^_ in the Composer. This is normally an alternative to Pine's internal composer (Pico). You could use this setting to specify an alternate editor to use occasionally or if you have a favorite editor and want to use it all the time (see the "enable- alternate-editor-implicitly" setting).

speller = <No Value Set>

This option affects the behavior of the ^T (spell check) command in the Composer. It specifies the program invoked by ^T in the Composer. By default, Pine uses the system's "spell" command. Pine will use the command defined by this option (if any) instead. When invoking the spell-checking program, Pine appends a tempfile name (where the message is passed) to the command line. composer-wrap-column = <No Value Set: using "74"> This option specifies an aspect of Pine's Composer. This gives the maximum width that auto-wrapped lines will have. It's also the maximum width of lines justified using the ^J Justify command. The normal default is "74". The largest allowed setting is normally "80" in order to prevent very long lines from being sent in outgoing mail. When the mail is actually sent, trailing spaces will be stripped off of each line. reply-indent-string = <No Value Set: using "> "> This variable specifies an aspect of Pine's Reply command. When a message is replied to and the text of the message is included, that text usually has the string "> " prepended to each line to indicate quoting.

This variable specifies a different value for that string. If you wish to use a string which begins or ends with a space, enclose the string in double quotes.

You can also include the sender's name in the prepended string. The first occurrence of "_FROM_" in the reply-indent-string will be replaced with the "username" portion of the address being replied to.

The normal default is "> ".

empty-header-message = <No Value Set: using "Undisclosed recipients">

When sending, if all of the To, Cc, and Newsgroups fields are empty, Pine will put a special address in the To line. The default value is "Undisclosed recipients: ;". The reason for this is to avoid embarrassment caused by some Internet mail transfer software that interprets a "missing" To: header as an error and replaces it with an Apparently-to: header that may contain the addresses you entered on the Bcc: line, defeating the purpose of the Bcc. You may change the part of this message that comes before the ": ;" by setting the "Empty-Header-Message" variable to something else.

The normal default is "Undisclosed recipients".

image-viewer = <No Value Set>

use-only-domain-name = No

display-filters = <No Value Set>

sending-filters = <No Value Set>

alt-addresses = <No Value Set>

addressbook-formats = <No Value Set>

This option specifies the format that address books are displayed in. Normally, address books are displayed with the nicknames in the first column, the fullnames in the second column, and addresses in the third column. The system figures out reasonable defaults for the widths of the columns. An address book may be given a different format by listing special tokens in the order you want them to display. The possible tokens are NICKNAME, FULLNAME, ADDRESS, FCC, and COMMENT. So, for example, to get the default behavior you could list

addressbook-formats=NICKNAME FULLNAME ADDRESS

(You can also use the token DEFAULT to get the default behavior for an address book format.)

The tokens are separated by spaces. "Addressbook-formats" is a list, so if you have more than one address book you may have a separate format for each by putting its format at the corresponding location in the"addressbook-formats" list. Listed first are the personal address books, then the global address books. So, if you have two personal address books and one global address book, you may have up to three formats in the "addressbook-formats" list. If "addressbook-formats" doesn't have as many elements as there are address books, the last element is used repeatedly. Each of the tokens may also be optionally followed by parentheses with either a number or a percentage inside the parentheses. For example, FULLNAME(13) means to allocate 13 characters of space to the fullnames column, FULLNAME(20%) means to allocate 20% of the available space (the screen width minus the space for inter-column spaces) to the fullnames column, while plain FULLNAME means the system will attempt to figure out a reasonable number of columns. There are always 2 spaces between every column, so if you use fixed column widths (like 13) you should remember to take that into account.

index-format = <No Value Set>

This option specifies the format that folder indexes are displayed in. Normally, the system figures out reasonable defaults for the widths of the columns of the index display. A non-standard display format can be used by listing special tokens in the order you want them to display. The tokens are STATUS, FULLSTATUS, MSGNO, DATE, SIZE, DESCRIPSIZE, SUBJECT, FROMORTO, FROM, and TO. The tokens are separated by spaces. Each of the tokens may also be optionally followed by parentheses with either a number or a percentage inside the parentheses. For example, SUBJECT(13) means to allocate 13 characters of space to the subject column, SUBJECT(20%) means to allocate 20% of the available space to the subjects column, while plain SUBJECT means the system will attempt to figure out a reasonable amount of space. There is always one space between every column, so if you use fixed column widths (like 13) you should remember to take that into account. Several of the fields are virtually fixed-width, so it doesn't make much sense to specify the width for them. The fields STATUS, FULLSTATUS, MSGNO, DATE, SIZE, and DESCRIPSIZE all fall into that category. You *may* specify widths for those if youwish, but you're probably better off letting the system pick those widths. FROMORTO just means it will list the From address unless it is you, in which case it will list the TO address. The default is equivalent to:

index-format=STATUS MSGNO DATE FROMORTO(33%) SIZE SUBJECT(67%)

This means that the four fields without percentages will be allocated first, and then 33% and 67% of the *remaining* space will go to the from and subject fields. If one of those two fields is specified as a percentage and the other is left for the system to choose, then the percentage is taken as an absolute percentage of the screen, not of the space remaining after allocating the first four columns. It doesn't usually make sense to do it that way. If you leave off all the widths, then the subject and from fields (if both are present) are allocated space in a 2 to 1 ratio, which is almost exactly the same as the default.

The token FROM is like FROMORTO, except that it always shows the Fromaddress, even if it is you. TO always shows the first address from the TO line, or the first newsgroup if there is no To. SENDER can be used to show the Sender of the message, as opposed to what is in the From line.

STATUS is three characters wide, with the first column showing '*' for messages marked Important, or '+' for messages addressed to you, or nothing. The second column is blank (and is sometimes used for the cursor) and the third column shows the letter 'D' if the message is deleted, or 'A' if it is answered (but not deleted), or 'N' if it is new (but not deleted or answered). FULLSTATUS is an alternate form of the STATUS field. It is six characters wide. The first column is '+' or blank, the third column is '*' or blank, the fourth column is 'N' or blank, the fifth column is 'A' or blank, and the sixth column is 'D' or blank.

DESCRIPSIZE is intended to be a more useful description of the message than just its size in bytes, but it isn't very useful at this point. Theplus sign in the DESCRIPSIZE view means there are attachments.

What you are most likely to do with this configuration option is to specify which fields appear at all, which order they appear in, and the percentage of screen that is used for the from and subject fields if you don't like the 2 to 1 default.

viewer-overlap = <No Value Set: using "2">

This option specifies an aspect of Pine's Message Viewing screen. When the space bar is used to page forward in a message, the number of lines specified by the "viewer-overlap" variable will be repeated from the bottom of the screen. That is, if this was set to two lines, then the bottom two lines of the screen would be repeated on the top of the next screen. The normal default value is "2". scroll-margin = <No Value Set: using "0"> This option controls when Pine's line-by-line scrolling occurs. Typically, when a selected item is at the top or bottom screen edge and the UP or DOWN (and Ctrl-P or Ctrl-N) keys are struck, the displayed items are scrolled down or up by a single line.

This option allows you to tell Pine the number of lines from the top and bottom screen edge that line-by-line paging should occcur. For example, setting this value to one (1) will cause Pine to scroll the display vertically when you move to select an item on the display's top or bottom edge.

By default, this variable is zero, indicating that scrolling happens when you move up or down to select an item immediately off the display's top or bottom edge.

status-message-delay = <No Value Set: using "0">

mail-check-interval = 15

This options specifies, in seconds, how often Pine will check for new mail. If set to zero, new-mail checking is disabled. There is a minimum value, normally 15 seconds.

newsrc-path = <No Value Set>

news-active-file-path = <No Value Set>

news-spool-directory = <No Value Set>

upload-command = <No Value Set>

upload-command-prefix = <No Value Set>

download-command = <No Value Set>

download-command-prefix = <No Value Set>

mailcap-search-path = <No Value Set>

mimetype-search-path = <No Value Set: using "/usr/local/lib/mime.types">