The available options are shown below.
Specifies the file name for your Pine address book. The default is PINE.ADDRESSBOOK. This file always resides in the PMDF_INIT: directory. Note that this option is not presented as such from within Pine. Though you can set the option manually by editting your Pine resource file, more commonly the option is controlled by using the
address-bookAddressbook menu from under theSETUPmenu.Specifies the ordering rule by which an address book will be presented. The choices are:
addrbook-sort-ruledont-sort,fullname-with-lists-last,fullname,nickname-with-lists-last, andnickname. The default isfullname-with-lists-last.This option allows you to specify the format to use when displaying the addressbook.
addressbook-formatsThis option provides a place for you to list alternative email addresses you may have. If set, the option affects the behavior of the Reply command and the
alt-addresses+symbol in theMESSAGE INDEX, which denotes that a message has been addressed specifically to you. With respect to Reply, thereply-to-alloption will exclude addresses listed here.This option is normally not settable by user, being set in the PINE.CONF-FIXED file by the PMDF system manager.
bugs-addressThis option is normally not settable by user, being set in the PINE.CONF-FIXED file by the PMDF system manager.
bugs-fullnameSpecifies the character set which you are using for eight bit characters when composing your messages. Note that if your message includes only seven bit characters, it will be labelled as
character-setUS-ASCII; thecharacter-setoption is only consulted if your message contains eight bit characters. If eight bit characters are used in your message, this value will be used to label your character set. The default, if this option is not set in your personal Pine resource file, will be the value, typicallyDEC-MCS, selected in the system-wide PINE.CONF file by the PMDF system manager.This value specifies the maximum columns the auto-wrapped lines will have in the Pine Composer. The normal default is
composer-wrap-column74.You may add your own custom headers to all outgoing messages. Each header you specify here must include the header tag (Reply-To:, Approved:, etc.) and may optionally include a value for that header. If you want to see these custom headers each time you compose a message, you must add them to your default composer headers list (see below), otherwise they become part of the rich header set which you only see when you press the rich header (Ctrl/R) command.
customized-hdrsSpecifies a list of header lines to appear by default when you are in the composer. If you use this option, then only the header lines listed here will appear in the composer unless the CTRL/R, rich header, command is invoked. So, remember to always put
default-composer-hdrsTo,From,Subjectheader lines here. For example,default-composer-hdrs=To,Cc,Attchmnt,Subject,Reply-to"Fcc" stands for Folder Carbon Copy. This option specifies a folder in which to automatically file copies of messages you send. The default is
default-fcc""which disables this option. To enable automatically saving copies of your sent messages, explicitly setdefault-fcc=foldernamewherefoldernameis the name of the folder in which you wish to save copies of sent messages, e.g.,default-fcc=SENTMAILOr to save copies of only specified sent messages, do not setdefault-fccand instead use the CTRL/R, Rich header command, while composing your message and fill in the Fcc: header line with the name of a folder. If your VMS MAIL profile has COPY_SELF on send or reply, Pine will automatically put your own address on the Cc: line. That is not the same as Fcc:, however, because the Cc: copy is sent to you as regular new mail, whereas, Fcc: puts a copy directly into a folder.This option determines the default folder name for "save message" operations, which may be overriden by the
default-saved-msg-foldersaved-msg-name-ruleoption. If not explicitly set, the default value MAIL is assumed on OpenVMS, to correspond to the normal VMS MAIL behavior of saving read messages to the OpenVMS MAIL folder named MAIL. Any valid folder collection, local or IMAP, may be specified.This option defines a list of text-filtering commands (programs or scripts) that may be used to filter text portions of received messages and then cause some desired action (
display-filterse.g., presentation in theMESSAGE TEXTdisplay screen, exporting to a text file, etc.). For security reasons, the full path name of the filter command must be specified.This option has no effect in PMDF Pine.
download-commandThis option has no effect in PMDF Pine.
download-command-prefixSpecifies a DCL command to use to invoke your editor; e.g.,
editoreditor=EDIT/EDTThe system-wide default alternate editor is EDIT/TPU.If all of the To:, Cc: and Newsgroups: fields are empty when sending a message, Pine will put the value of this option in the To: address, so as to avoid problems with some mailers which mishandle empty headers.
empty-header-messageDetermines the default folder name for Fcc: copies. Use one of the following:
fcc-name-ruledefault-fcc,by-recipient,last-fcc-used,by-nickname,by-nick-then-recip, orcurrent-folder. The default isdefault-fccwhich specifies that the folder name specified with thedefault-fccoption is used.Specifies a list of features to enable. The default system-wide features are:
feature-listfeature-list=enable-aggregate-command-set, enable-alternate-editor-cmd, enable-bounce-cmd, enable-flag-cmd, enable-full-header-cmd, enable-jump-shortcut, enable-suspend, enable-tab-completionfeature-listis additive: first the system-wide features are established and then your settings are established on top of the system-wide settings. To disable a feature set by the system-wide defaults, specify the feature name to be disabled withno-prepended to its name. For examplefeature-list=no-enable-jump-shortcut, no-enable-suspendThe available features and their usages are shown in Table 6-1 .
Table 6-1 Available Pine feature-listfeaturesComposer Preferences compose-cut-from-cursorThis feature controls the behavior of the Ctrl/K command in the composer. If set, Ctrl/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-dThis feature affects the behavior of the DELETE key. If set, Delete will be equivalent to Ctrl/D, and delete the current character. Normally Pine defines the Delete key to be equivalent to Ctrl/H, which deletes the previous character. compose-rejects-unqualified-addrsIf set, addresses without an @ hostpart will be rejected unless they match an addressbook nickname.compose-send-offers-first-filterIf you have sending-filtersconfigured, setting this feature will cause the first filter in thesending-filterslist to be offered as the default instead of unfiltered, the usual default.enable-alternate-editor-cmdEnables the CTRL/_ command which invokes the alternate editor. enable-alternate-editor-implicitlyWhen set, the alternate editor will be automatically invoked when composing messages. enable-search-and-replaceThis feature modifies the behavior of Pine's composer. Setting this feature causes Pine to offer the "Ctrl/R Replace" subcommand, which allows you to search and replace text strings in a message you are composing, inside the "Ctrl/W Where is" command. enable-sigdashesThis feature enables support for the common USENET news convention of preceding a message signature with the special line consisting of the three characters " --" ( i.e., dash, dash, and space). When enabled and asignature-fileexists, Pine will insert the special line before including the file's text (unless the special line already exists somewhere in the file's text). In addition, when you Reply or Followup to a message containing one of these special lines and choose to include its text, Pine will observe the convention of not including text beyond the special line in your reply. See alsostrip-from-sigdashes-on-replyfor a related feature.quell-dead-letter-on-cancelThis feature affects Pine's behavior when you cancel a message being composed. Pine's usual behavior is to write the canceled message to a file named DEAD.LETTER in your home directory. Under some conditions (some routine), this can introduce a noticeable delay. Setting this feature will cause Pine NOT to write canceled compositions into the file. NOTE: Enabling this feature means no record of canceled messages is maintained. quell-user-lookup-in-passwd-fileHas no effect in PMDF Pine. Reply Preferences enable-reply-indent-string-editingThis feature affects the Reply command's "Include original message in Reply?" prompt. When enabled, it causes the "Edit Indent String" sub-command to appear which allows you to edit the string Pine would otherwise use to denote included text from the message being replied to. Thus, you can change Pine's default message quote character (usually an angle bracket) on a per message basis. Note that the configuration option reply-indent-stringmay be used to change what appears as the default string to be edited.include-attachments-in-replyIf set, MIME attachments from a message being replied to will automatically be included in the reply. include-header-in-replyIf set, header lines from a message being replied to will be included in the reply. include-text-in-replyIf set, the content of a message being replied to will automatically be included in the reply. reply-always-uses-replyThis 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). 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! signature-at-bottomInsert your signature at the bottom of the message instead of at the top in a reply or new message. strip-from-sigdashes-on-replyThis feature doesn't do anything if the feature enable-sigdashesis turned on. However, if theenable-sigdashesfeature is not turned on, then turning on this feature enables support for the convention of not including text beyond the sigdashes line when Replying or Following up to a message and including the text of that message. In other words, this is a way to turn on the signature stripping behavior without also turning on the dashes-adding behavior.Sending Preferences enable-8bit-esmtp-negotiationHas no effect in PMDF Pine. enable-delivery-status-notificationThis feature affects the behavior of Pine's mail sending. If set, this feature enables a subcommand in the composer's "Send?" confirmation prompt. The subcommand allows you to tell Pine to request the type of Delivery Status Notification (DSN) which you would like. You may request a delivery receipt upon successful delivery of your message, control whether you are notified regarding delays or failure in delivering the message, and control whether the entire contents of your message or just the headers will be returned in any failure notification. If you don't enable the DSN feature or if you don't turn it on for a particular message, the default is that you will be notified about failures, you might be notified about delays, and you won't be notified about successes. You will usually receive the full message back when there is a failure. If you turn on the DSNOpts the default is to return as much information as possible to you. That is, by default, the Success and Delay options are turned on and the full message will be returned on failure. enable-verbose-smtp-postingHas no effect in PMDF Pine fcc-on-bounceThis 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. fcc-only-without-confirmThis features controls an aspect of Pine's composer. The only time this feature will be used is if you attempt to send mail which has no recipients but does have an Fcc. Normally, Pine will ask if you really mean to copy the message only to the Fcc. That is, it asks if you really meant to have no recipients. If this feature is set, you will not be prompted to confirm your intent to make only a copy of a message with no recipients. fcc-without-attachmentsThis features controls the way FCC's (File Carbon Copies) are made of the messages you send. Normally, Pine saves an exact copy of your message as it was sent. When this feature is enabled, the "body" of the message you send (the text you type in the composer) is preserved in the copy as before; however all attachments are replaced with text explaining what had been sent rather than the attachments themselves. This feature also affects Pine's "Send ?" confirmation prompt in that a new "^F Fcc Attchmnts" option becomes available which allows you to interactively set whether or not attachments are saved to the Fcc'd copy. use-sender-not-x-senderNormally Pine adds a header line labeled X-Sender:, if the sender is different from the From: line. The standard specifies that this header line should be labeled Sender, not X-Sender:. Setting this feature causes Sender to be used instead of X-Sender:. Folder Preferences combined-subdirectory-displayThis feature affects the Folder List screen when the combined-folder-displayfeature is enabled. Normally, selecting a directory from the Folder List takes you into a new screen displaying only the contents of that directory. Enabling this feature will cause the contents of the selected directory to be displayed within the boundaries of the collection it is a part of. All previously displayed collections will remain in the screen.combined-folder-displayThis feature affects the folder list display screens. Normally, each folder list is viewed within its collection only. This command allows folder lists to be viewed within a single screen that combines the contents of all collections. When this feature is set, the setting of the feature expanded-view-of-foldershas an effect.enable-dot-foldersWhen this feature is set, folders beginning with dot or period ( .) may be added and viewed.enable-incoming-foldersIf set, this feature defines a pseudo-folder collection name "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-messagefolder collection. You may add more folders to the "INCOMING MESSAGE FOLDERS" collection by using theAdd command of theFOLDER LISTmenu.enable-good-list-modeThis option is always enabled, whether marked or not, in PMDF Pine, as it causes Pine to adhere to the IMAP standard. expanded-view-of-foldersHave folder lists pre-expanded in FOLDER LISTmenu.quell-empty-directoriesThis feature causes Pine to remove from the display any directories that do not contain at least one file or directory. This can be useful to prevent overly cluttered folder lists when a collection is stored on a server that treats all names as both a folder and a directory. separate-folder-and-directory-entriesThis feature affects folder collections wherein a folder and directory can have the same name. By default, Pine displays them only once, denoting that it is both a folder and directory by appending the folder name with the hierarchy character enclosed in square brackets. Enabling this feature will cause Pine to display such names separately marking the name representing a directory with a trailing hierarchy delimiter (typically the slash, /, character). The feature also alters the command set slightly. By default, the right-arrow descends into the directory, while hitting the Return key will cause the folder by that name to be opened. With this feature set, the Return key will open the highlighted folder, or enter the highlighted directory.single-column-folder-listThis feature controls an aspect of Pine's FOLDER LISTscreen. If set, the folders will be listed one per line instead of several per line in theFOLDER LISTdisplay.vertical-folder-listThis feature controls an aspect of Pine's FOLDER LISTscreen. If set, the folders will be listed alphabetically down the columns rather than across the columns as is the default.Address Book Preferences combined-addrbook-displayThis feature affects the address book display screens. Normally, expanding an address book from the ADDRESS BOOK LIST screen will cause the remaining address books and directory servers to disappear from the screen, leaving only the entries of the expanded address book. If this feature is set, then the other address books will remain on the screen, so that all of the address books can be present at once. When this feature is set, the setting of the feature expanded-view-of-addressbookshas an effect.expanded-view-of-addressbooksHave multiple address books expanded when entering the ADDRESS BOOKmenu.expanded-view-of-distribution-listsIf this feature is set, then distribution lists in the address book screen will always be expanded automatically. ldap-result-to-addrbook-addIf both the Directory option use-implicitly-from-composerand this feature are set, then when an implicit directory lookup is done from the composer you will automatically be prompted to add the result of the directory lookup to your address book.Message Index Preferences auto-open-next-unreadAutomatically opens the next folder in the incoming-foldersornews-collectionscollections which contain unread mail.delete-skips-deletedWhen set, the Delete command will skip to the next undeleted message.enable-cruise-modeThis 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-deleteThis feature modifies the behavior of Pine's enable-cruise-modefeature. Setting this feature causes Pine to implicitly delete read messages when it moves on to display the next "interesting" message. Beware when enabling this feature and theexpunge-without-confirmfeature!tab-visits-next-new-message-onlyThis feature affects Pine's behavior when using the TAB key to move from one message to the next. Pine's usual behavior is to select the next unread message or message flagged as "Important". Setting this feature causes Pine to skip the messages flagged as important, and select unread messages exclusively. Tab behavior when there are no new messages left to select remains unchanged. Viewer Preferences enable-msg-view-attachmentsThis feature modifies the behavior of Pine's MESSAGE TEXTscreen. Setting this feature causes Pine to present attachments in boldface. The first available attachment is displayed in inverse. This is the "selected" attachment. Pressing RETURN will cause Pine to display the selected attachment. Use the arrow keys to change which of the attachments displayed in boldface is the current selection.enable-msg-view-urlsThis feature modifies the behavior of Pine's MESSAGE TEXTscreen. Setting this feature causes Pine to select possible URLs from the displayed text and display them in boldface for selection.enable-msg-view-web-hostnamesThis feature modifies the behavior of Pine's MESSAGE TEXTscreen. Setting this feature causes Pine to select possible web hostnames from the displayed text and display them in boldface for selection. This can be useful when you receive messages referencing World Wide Web sites without the use of complete URLs; for example, specifying only "www.washington.edu/pine/" (which will not become a selectable item by setting theenable-msg-view-urlsoption) rather than explicitly specifying "http://www.washington.edu/pine/".enable-msg-view-addressesThis feature modifies the behavior of Pine's MESSAGE TEXTscreen. Setting this feature causes Pine to select possible email addresses from the displayed text and display them in boldface for selection.enable-msg-view-forced-arrowsThis feature modifies Up and Down arrow key behavior in Pine's MESSAGE TEXTscreen when selectable Attachments, URL's, or web-hostnames are presented. Pine's usual behavior is to move to the next or previous selectable item if currently displayed or simply to adjust the screen view by one line. Setting this feature causes the UP and Down arrow key to behave as if no selectable items were present in the message.pass-control-characters-as-isThis feature controls how certain characters contained in messages are displayed. If set, all characters in a message will be sent to the screen. Normally, control characters are automatically suppressed in order to avoid inadvertently changing terminal setup parameters. News Preferences compose-sets-newsgroup-without-confirmWhen set, if you enter the composer while reading a news group, you will not be prompted as to whether you intend the message to be posted to the current newsgroup or not: it will be posted. enable-8bit-nntp-postingThis feature affects Pine's behavior when posting news. The Internet standard for exchanging USENET news messages (RFC 1036) specifies that USENET messages should conform to Internet mail standards and contain only 7bit characters, but much of the news transport software in use today is capable of successfully sending messages containing 8bit characters. Hence, many people believe that it is appropriate to send 8bit news messages without any MIME encoding. Moreover, there is no Internet standard for explicitly negotiating 8bit transfer, as there is for Internet email. Therefore, Pine provides the option of posting unencoded 8bit news messages, though not as the default. Setting this feature will turn OFF Pine's MIME encoding of newsgroup postings that contain 8bit characters. Note that articles may cross a path or pass through news transport software that is unsafe or even hostile to 8bit characters. At best this will only cause the posting to become garbled. The safest way to transmit 8bit characters is to leave Pine's MIME encoding turned on, but recipients who lack MIME-aware tools are often annoyed when they receive MIME-encoded messages. news-approximates-new-statusIf set, all messages after the last deleted message will show up as new messages in a news group. news-deletes-across-groupsThis feature controls what Pine does when you delete a message in a newsgroup that appears in more than one newsgroup. Such a message is sometimes termed a "crossposting" in that it was posted across several newsgroups. Pine's default behavior when you delete such a message is to remove only the copy in the current newsgroup from view when you use the "Exclude" command or the next time you visit the newsgroup. Enabling this feature causes Pine to remove every occurrence of the message from all newsgroups it appears in and to which you are subscribed. Note that as currently implemented, enabling this feature may increase the time it takes the Expunge command and newsgroup closing to complete. news-offers-catchup-on-closeThis feature controls what Pine does as it closes a newsgroup. When set, Pine will offer to delete all messages from the newsgroup as you are quitting Pine or opening a new folder. news-post-without-validationNNTP server is not queried as news groups are entered for posting. Validation can cause long delays on a slow link. news-read-in-newsrc-orderThe presentation order of the news groups will be what is in the NEWSRC. file. Printer Preferences enable-print-via-y-commandThis feature modifies the behavior of Pine's Print command. By default, Pine's print command is available by pressing the %key. (This command is a substantial change from Pine versions before 4.00 -- where the print command wasY---based on numerous complaints about printing being invoked inadvertently, sinceYalso means "Yes".) This feature is provided for compatibility with the prior behavior of Pine; enabling this feature will cause Pine to recognize both the old command,Yfor "Prynt", as well the new%method for invoking printing. Note that key menu labels are not changed as a result of enabling this feature.print-offers-custom-cmd-promptWhen this feature is set, the print command will have an additional subcommand called "C CustomPrint". If selected, you will have the opportunity to enter any system print command --instead of being restricted to using those that have been previously configured in the printer setup menu. print-includes-from-lineHas no effect in PMDF Pine print-index-enabledThis feature controls the behavior of the Print command when in the MESSAGE INDEXscreen. If set, the print command will give you a prompt asking if you wish to print the message index, or the currently highlighted message. If not set, the message will be printed.print-formfeed-between-messagesSetting this feature causes a formfeed to be printed between messages when printing multiple messages (via the "Apply Print" command). Advanced Command Preferences enable-aggregate-command-setEnables the following aggregate commands: ;(Select),Apply, andZoom.enable-arrow-navigationThis feature controls the behavior of the left and right arrow keys. If set, the left and right arrow keys will operate like the usual navigation keys <and>. If you set this feature, and do not like the changed behavior of the up/down arrow keys when navigating through theFOLDER LISTscreen -- first from column to column, if more than one folder is displayed per row, and then from row to row---you may either also wish to set the featureenable-arrow-navigation-relaxed,single-column-folder-list, or use the Ctrl/P and Ctrl/N commands (instead of up/down arrow) keys to move up/down the list of folders in each column.enable-arrow-navigation-relaxedThis feature controls the behavior of the left, right, up and down arrow keys in the FOLDER LIST screen when the enable-arrow-navigationfeature is enabled. Normally, when theenable-arrow-navigationfeature is set, the left and right arrow keys in the Folder List screen strictly track the commands bound to the<and>keys, and the up and down arrow keys move the highlight bar to the previous and next folder or directory name. When enabled, this feature returns the left, right, up and down arrow keys' functionality in theFOLDER LISTscreen to what it was before enablingenable-arrow-navigation. In other words, left and right arrows move the highlight bar to the left or right, and the up and down arrows move it up or down.enable-bounce-cmdEnables the Bounce command.enable-exit-via-lessthan-commandIf this feature is set, then on screens where there is an "Exit" command but no <command, the<key will perform the same function as the Exit command.enable-flag-cmdEnables you to set the status flags associated with a message. You can flag a message as being new (unread), deleted, answered, or important (marked in VMS MAIL). enable-flag-screen-implicitlyThe 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 Ctrl/T key. Enabling this feature causes Pine to immediately enter the detailed flag screen rather than first offer the simple prompt. enable-full-header-cmdEnables the HdrMode command which allows you to see a message in its entirety.enable-goto-in-file-browserThis 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 intermediate directory when moving between two distant directories. enable-jump-shortcutWhen set, allows you to type just a message number to jump to that message. enable-partial-match-listsThis feature affects the subcommands available when Saving, or when Opening a new folder. If set, the subcommand Ctrl/X ListMatches will be available. This command allows you to type in a substring of the folder you are looking for and when you type Ctrl/X it will display all folders which contain that substring in their names. enable-tab-completionEnables TAB completion for folder opening and saving. enable-unix-pipe-cmdHas no effect in PMDF Pine. Advanced User Preferences allow-talkBy default, permission for others to "talk" to your terminal is turned off when you are running Pine. When this feature is set, permission is instead turned on. If enabled, you may see unexpected messages in the middle of your Pine screen from someone attempting to contact you via the "talk" program. If you do enable this feature and see a "talk" message, you must suspend or quit Pine before you can respond. assume-slow-linkIf set, use screen optimizations to reduce the time taken to update the screen. auto-move-read-msgsIf set Pine will automatically move all read messages to the read-message-folderwhen you quit. Moved messages are marked for deletion. This feature has no effect if noread-message-folderis set.auto-unzoom-after-applyThis 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. auto-zoom-after-selectThis feature affects the behavior of the Select command. If set, the select command will automatically perform a zoom after the select is complete. confirm-role-even-for-defaultIf you have roles, when you Reply to or Forward a message, or Compose a new message, Pine will search through your roles for one which matches. Normally, if no matches are found you will be placed into the composer with no opportunity to select a role. If this feature is set, then you will be asked to confirm that you don't want a role. disable-keymenuIf this feature is set the command key menu that normally appears on the bottom two lines of the screen will not usually be there. disable-take-last-comma-firstNormally, when TakeAddr is used to copy an address from a message into an address book entry, Pine will attempt to rewrite the full name of the address in the form Last, Firstinstead of
First LastIt does this because many people find it useful to sort by Last name instead of First name. If this feature is set, then the TakeAddr command will not attempt to reverse the name in this manner.enable-dot-filesWhen this feature is set, files beginning with a dot or period ( .) 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-fast-recent-testThis feature controls the behavior of the TAB key when traversing folders in the optional incoming-folderscollection or in optional news-collections. When the TAB (Next New) key is pressed, the default behavior is to explicitly examine the status of the folder for the number of recent messages (messages delivered since the last time it was viewed). Depending on the size and number of messages in the folder, this test can be time consuming. Enabling this feature will cause Pine to only test for the existence of any recent messages rather than the obtain the count. This is much faster in many cases. The downside is that you're not given the number of recent messages when prompted to view the next folder.enable-mail-check-cueThis feature causes an asterisk to appear in the upper left-hand corner of the screen whenever Pine checks for new mail, and two asterisks whenever Pine saves (checkpoints) the state of the current mailbox to disk. enable-mouse-in-xtermHas no effect in PMDF Pine. enable-newmail-in-xterm-iconHas no effect in PMDF Pine. enable-rules-under-takeNormally, the Take command takes addresses from a message and helps you put them into your Address Book. If you use Rules for Indexcolors, Roles, Filtering, or Scoring; you may find it useful to be able to Take information from a message's headers and put it into a new Rule. When this feature is set, you will be given an extra prompt which gives you the choice to Take into the Address Book or Take into a rule. enable-suspendEnables CTRL/Z as a command to spawn a subprocess. expunge-without-confirmWill not ask for confirmation when expunging. expunge-without-confirm-everywherehis 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. This feature sets this behavior for all folders, unlike the expunge-without-confirmfeature which works only for incoming folders.preserve-start-stop-charactersControls how CTRL/S and CTRL/Q are interpreted when input to Pine. quell-folder-internal-msgHas no effect in PMDF Pine. quell-lock-failure-warningsHas no effect in PMDF Pine. quell-status-message-beepingThis 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. quit-without-confirmDisables Pine's exit confirmation prompt. save-will-not-deleteIf set, the Save command will not mark the message as deleted after it is copied to the destination folder.save-will-advanceIf set, the Save command will advance you to the next message.save-will-quote-leading-fromsIf set, the Save command will add a leading > character in front of message lines beginning with From. This is not useful when saving to a VMS MAIL folder.select-without-confirmIf this option is set, then for the Save,Export, andGoto commands (for which you can use CTRL/T to get a list of folders) the selected folder name will be used without confirmation.show-cursorThis feature controls an aspect of Pine's displays. If set, the system cursor will move to convenient locations in the displays. For example, to the beginning of the status field of the highlighted index line, or to the highlighted word after a successful WhereIs command. It is intended to draw your attention to an "interesting" spot on the screen. show-plain-text-internallyThis feature modifies the method Pine uses to display Text/Plain MIME attachments from the Attachment Index screen. Normally, the "View" command searches for any externally defined (usually via the mailcap file) viewer, and displays the selected text within that viewer. Enabling this feature causes Pine to ignore any external viewer settings and always display text with Pine's internal viewer. show-selected-in-boldfaceAggregate selected messages will be shown in bold face instead of having an "X" in the first column of the index. try-alternative-authentication-driver-firstThis feature controls how Pine provides authentication credentials to the IMAP server you are connecting to. Normally, Pine and the server negotiate the most secure method to exchange such information. However, some methods aren't available for negotiation, and thus require pre-configuration (typically, per server) on Pine's part. This feature allows Pine to implicitly try an alternative to the default methods that may have been added to Pine when it was built. use-current-dirUse the current directory instead of the home directory for Export, AttachmentSave, CTRL/R Include File, and CTRL/J Attach File.use-subshell-for-suspendThis feature affects Pine's behavior when process suspension is enabled and then activated via the Ctrl/Z key. Pine suspension allows one to temporarily interact with the operating system command shell without quitting Pine, and then subsequently resume the still-active Pine session. When the enable-suspendfeature is set and subsequently the Ctrl/Z key is pressed, Pine will normally suspend itself and return temporary control to Pine's parent shell process. However, if this feature is set, Pine will instead create an inferior subshell process. This is useful when the parent process is not intended to be used interactively.
+Not settable from theSETUPmenu
Specifies a list of one or more collections where mail is stored and can be read with Pine. The first collection in the list is the default collection for Save operations. The system-wide default is
folder-collectionsfolder-collections=[]which specifies the default mail file on your local system. See Section 6.4.1 for further details on the use of this option. Note that this option is not presented as such from within Pine. Though you can set the option manually by editting your Pine resource file, more commonly the option is controlled by using theL(collectionList) option from under theSETUPmenu.This option controls the order in which folder list entries will be presented in the
folder-sort-ruleFOLDER LISTscreen. The default isalphabetical.You can specify a folder in which you will be storing form letters: messages that you have composed that are intended to be sent in their original form repeatedly.
form-letter-folderYou can specify the name of one or more files containing readonly global address books, which can be shared by several or all users. OpenVMS file protections are honored and can be used to limit access. Note that this option is not presented as such from within Pine. Though you can set the option manually by editting your Pine resource file, more commonly the option is controlled by using the
global-address-bookAddressbook menu from under theSETUPmenu.This value affects Pine's behavior when you use the Goto command. The default is
goto-default-ruleinbox-or-folder-in-recent-collection.Any value set with this option is ignored. Your mailcap file is used instead.
image-viewerNormally no value should be specified for this option. The default is INBOX which is interpreted as the VMS MAIL NEWMAIL folder. Unexpected results may occur if any folder other than INBOX is specified. However, one sort of setting which is allowable, (though seldom used), is to point this option at a remote POP3 server. In this case, POP3 access to the new messages on the remote system will be used. The syntax is
inbox-pathinbox-path={pop3servername/POP3}INBOXto log in under the same username, orinbox-path={pop3servername/POP3/USER=username}INBOXto log in to the remote POP3 server under a different username. When logging in under a different username, you may be prompted to enter a password upon accessing the folder. Note that new mail broadcast notifications are not performed while doing POP access; you must exit and reenter Pine in order to receive such new mail notifications.This is a generalization of
incoming-archive-foldersread-message-folder.This value affects Pine's behavior when opening the
incoming-startup-ruleINBOXfolder or one of theINCOMING MESSAGE FOLDERSfolders. By default the value isfirst-unseen, which means that when theINBOXfolder or another incoming folder is first opened, the current message is set to the first unseen message which has not been marked deleted, or the last message if all of the messages have been seen previously.This option specifies the format in which the folder index is displayed. The display format can be specified by listing special tokens in the order you want them displayed. The tokens available include STATUS, FULLSTATUS, MSGNO, DATE, SIZE, DESCRIPSIZE, SUBJECT, FROMORTO, FROM, and TO. The tokens are separated by spaces.
index-formatSpecifies a comma-separated list of commands (keystrokes) which Pine executes on startup. Items in this list are usually just characters. Special values include:
initial-keystroke-listFunction and character keys may not be mixed in the list despite the fact that you can, in some cases, mix them while interactively running Pine. You can always use all character keys in the startup list even if you are using function keys normally, or vice versa.
SPACE, CR Space character and carriage return key F1--F12 Function keys F1 through F12 UP, DOWN, LEFT, RIGHT Up, down, left, and right cursor keys This option is used to record the year and month when you were last asked by Pine whether to automatically prune those folders specified with the
last-time-prune-questionedpruned-foldersoption. The recording format is YYY.MM as an offset from 1900; e.g., 100.6 specifies June, 2000. Note that if you manually set this option to a time in the future, then Pine will leave your messages alone and not ask you again about pruning your folders until one month past the specified time is reached. No value for this option should be set in the system-wide configuration file. Note that this option is not presented from within Pine, for instance, from within theSETUPmenu'sConfig screen, since it is normally an internal option automatically updated by Pine. So if you wish to set this option explicitly, you must do so by manually editting your Pine resource file.This option is controlled by Pine and is used to track the version of Pine last used. Whenever Pine detects a difference between the recorded version number and that of the currently running version, it outputs a new version message. This option should not be set in the system-wide configuration file. Note that this option is not presented from within Pine, for instance, from within the
last-version-usedSETUPmenu'sConfig screen, since it is normally an internal option automatically updated by Pine.This option specifies how often, in seconds, Pine should check for new mail. The default is 150 seconds. Specify a 0 value if you don't want Pine to check for new mail automatically.
mail-check-intervalThis variable is used to replace Pine's default mailcap file search path. It takes one or more file names (full paths must be specified) in which to look for mail capability data. The default for PMDF Pine if this variable is not specified is PMDF_INIT:MAILCAP.
mailcap-search-pathThis variable is used to replace Pine's default MIME.TYPES file search path. It takes one or more file names (full paths must be specified) in which to look for file-name-extension to MIME type mapping data. The default for PMDF Pine if this variable is not specified is PMDF_INIT:MIME.TYPES.
mimetype-search-pathHas no effect in PMDF Pine.
news-active-file-pathThis option has a format very similar to the
news-collectionsfolder-collectionsoption. With it, you can specify a collection label as well as the name of the NNTP system; e.g.,news-collections=Good-news *{news.host/nntp}[]As a target of the GotoFldr command, you can specify a news address in the format of*{news.host:port/nntp}newsgroup.foo.barHowever, the port number can not be specified with thenews-collectionsoption. Note that this option is not presented as such from within Pine. Though you can set the option manually by editting your Pine resource file, more commonly the option is controlled by using theL(collectionList) option from under theSETUPmenu.Has no effect in PMDF Pine.
news-spool-directoryThis option overrides the default name Pine uses for your "newsrc" news status and subscription file. If set, Pine will take this value as the full pathname for the desired newsrc file. If this option is not set, PMDF Pine looks for the file NEWSRC. in the PMDF_INIT: directory. (By default, PMDF_INIT is a logical which translates to SYS$LOGIN. Users wishing to keep their Pine and other PMDF initialization files elsewhere can redefine the PMDF_INIT logical.)
newsrc-pathSpecifies the TCP/IP host name of your NNTP server for new posting and news collections.
nntp-serverYour personal name to appear in outgoing mail; i.e., the personal name field to use in your return address. If not specified, the personal name set in your VMS MAIL profile will be used. This option should not be specified in the system-wide configuration file.
personal-nameSpecifies a DCL command to use to print messages. This option corresponds to item 3 in the printer menu and can be set from within Pine using the printer setup menu. This option should not be set in the system-wide configuration file. OpenVMS print queues often have a dollar sign, $, in their name. Note that, as described above in Section 6.6.1 , the dollar sign is a special character in the Pine resource file and must be quoted with a backslash character, \. So if, for instance, you wish to define your personal print command to print to a queue named NEARBY$PRINTER, set the option as
personal-print-commandpersonal-print-command=PRINT/QUEUE=NEARBY\$PRINTERSpecifies the name of the folder where postponed message are kept. This folder can be looked at just like any other folder, and you can also delete messages from it. However, when you are continuing a postponed message, the operations are limited to just selecting the message you want to continue. Canceling such a message will result in its deletion from the postponed folder.
postponed-folderSpecifies the Pine printer setting and must be one of
printerattached-to-ansi,
attached-to-ansi-no-formfeed, the value of thepersonal-print-commandoption, or PRINT/DELETE (the standard OpenVMS print command). This option should not be set in the system-wide configuration file.You can specify a list of folders which Pine will offer to prune for you once a month.
pruned-foldersSpecifies a folder to file read messages to upon exiting Pine. If set, then upon exiting Pine you will be prompted as to whether read messages from the INBOX folder should be moved to the
read-message-folderread-message-folder. The default value for this option is MAIL.When you reply to a message, and the original message is included in the reply, the text of the original message is indented and prefixed by this character string. Usually set to "
reply-indent-string>".This option is used to customize the content of the introduction line that is included when replying to a message and including the original message in the reply. The normal default (what you will get if you delete this variable) looks something like:
reply-leadinOn Sat, 24 Oct 1998, Fred Flintstone wrote:where the day of the week is only included if it is available in the original message.Determines the default folder to save messages to. The value
saved-msg-name-ruledefault-folderspecifies that saved messages be filed to the MAIL folder. If the valueby-senderis specified, then Pine will offer to file the message to a folder with the same name as the message's sender. If the valuelast-folder-usedis specified, then Pine will offer to file the message to whatever folder you used last.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.
scroll-marginThis option defines a list of text-filtering commands (programs and scripts) that may be selectively invoked to process a message just before it is sent. If set, the Composer's Ctrl/X (Send) command will allow you to select which filter (or none) to apply to the message before it is sent. For security reasons, the full path of the filter program must be specified.
sending-filtersSpecifies a signature file, the contents of which is to be appended to messages as a signature. It typically contains information such as your name, email address and organizational affiliation. Pine adds the signature into the message as soon as you enter the composer so you can choose to remove it or edit it on a message by message basis. Signature file placement in message replies is controlled by the
signature-filesignature-at-bottomsetting in the feature list. The default name for the signature file is PINE.SIGNATURE. This file always resides in your PMDF_INIT: directory.Specifies the ordering to use to sort message directory listings. Any ordering other than the default chronological (
sort-keyarrival) ordering is likely to be slow.Instead of invoking the SPELL command, the value of this option will name a different command to be invoked when CTRL/T command is used in the Pine Composer.
spellerIf this is set to a positive number, it causes the cursor to move to the status line whenever a status message is printed and pause there for this many seconds. It will probably only be useful if the
status-message-displayshow-cursorfeature is also turned on.This option has no effect in PMDF Pine.
upload-commandThis option has no effect in PMDF Pine.
upload-command-prefixThis option affects Pine's handling of URLs that are found in messages you read. Normally, only URLs Pine can handle directly are automatically offered for selection in the "Message Text" screen. When one or more applications capable of deciphering URLs on their command line are added here, Pine will choose the first available to display URLs it cannot handle directly.
url-viewersThis option is not user settable, though system managers can set it on a system wide basis in the PINE.CONF-FIXED file.
user-domainYou may change the default list of headers that are viewed by listing the headers you want to view here. If the headers listed are present in the message, then they will be shown. The order of the headers you list will be honored. If the special value
viewer-hdrsall-exceptis included as the first header in theviewer-hdrslist, then all headers in the message except those in the list will be shown. The values are all case insensitive.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-overlapviewer-overlapvariable 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 is2.