This is the help file for PINE, which is used by OPLIN for Telnet e-mail sessions. PINE 3.95 HELP FOR MAIN MENU In addition to this general help on Pine, Release Notes on the current Pine version are also available from the MAIN MENU. Press R to browse the release notes. These include changes since the last release, notes for PC-Pine, configuration information, the history of the Pineproject, credits, and legal notices. Pine files and documentation are available via FTP or WWW: ftp://ftp.cac.washington.edu/pine http://www.cac.washington.edu/pine For a copy of the current Pine "Frequently Asked Questions" (FAQ) list, send an empty message to pine-faq@cac.washington.edu --or, if it is available at your site, use the Setup/Update command under the Main Menu. If you would like to print *all* of Pine's internal help text for a little light bedtime reading, then press Z now. (This assumes that the copy of Pine you are using has been properly configured for printing at your site.) OTHER COMMANDS: The "Other Commands" function changes the keys you see at the bottom of any screen. In some cases there are 3 different pages of keys which it toggles through. ALL COMMANDS ARE ACTIVE, even if they are not currently showing at the bottom of your screen. In other words, you NEVER need to prefix a command key with the 'O' key. CONTROL KEY: When composing mail and in a few other places in Pine you have to use Control keys which means pressing the control key and the letter indicated at the same time. This is usually shown with a "^" in front of the letter. On some systems, certain control characters are intercepted before they get to Pine. As a work-around, you can press the ESCAPE key twice followed by the desired key. For example, if Control-O (^O) does not work on your system, try typing "ESC ESC O". PAGING UP/DOWN: The "+" and "-" keys are used for moving to the next or previous page. The space bar is a synonym for "+". You may also use PAGING UP/DOWN: The "+" and "-" keys are used for moving to the next or previous page. The space bar is a synonym for "+". You may also use Ctrl-V to page down and Ctrl-Y to page up as you do in the message composer. On screens with a WhereIs (search) command, W or Ctrl-W followed by Ctrl-V will move to the bottom of the message or list, and W or Ctrl-W followed by Ctrl-Y will move to the top of the message or list. RETURN KEY: The return key is usually a synonym for a frequently used command. When viewing a message, there is currently not a default command, so RETURN does nothing; when in the index, it is synonymous with "view msg". In the key menu at the bottom of the screen, whatever is enclosed in square brackets [] is the same as the return key. CONTROL KEYS NOT USED BY PINE: Most commands in Pine are single letters, with --we hope-- some mnemonic value, but in places where Pine is expecting text input, e.g. in the composer or at prompts for file/folder names, control keys must be used for editing and navigation functions. Pine has used nearly all the control keys available. There are, however, certain control keys that are reserved by other programs or for technical reasons. Pine does not use any of these keys: Ctrl-S Used by Unix as "stop output" Ctrl-Q Used by Unix as "resume output" Ctrl-] Often used by Telnet as escape key Ctrl-\ Often used by Unix as "Abort" ESC Conflicts with sequences used for arrow keys NOTE: by default, Pine treats Ctrl-S or Ctrl-Q (sometimes known as XOFF and XON), as normal characters, even though Pine does not use them. However, the printer, modem, or communication software you are using may be configured for "software flow control" which means that XON/XOFF must be treated as special characters by the operating system. If you see messages such as "^X not defined for this screen", then your system is probably using software flow control. In this case you will need to set the "preserve-start-stop-characters" feature. If you *do* set this feature, be advised that if you accidentally hit a Ctrl-S, Pine will mysteriously freeze up with no warning. In this case, try typing a Ctrl-Q and see if that puts things right. Printing via the "attached-to-ansi" option will automatically enable software flow-control handling for the duration of the printing. REPAINTING THE SCREEN: Sometimes what is displayed on the screen will be incorrect due to noise on the phone line or other causes and you will want to repaint the whole screen to make it correct. You can use the Ctrl-L command to do this. It never hurts to do it when in doubt. --------------- | Status Line | --------------- The top line of the screen is Pine's status line. It will always display the current version of Pine and will also convey information about the status of the program. This is where you look to find out what collection, folder and message number is active. If the top line says "READONLY" it means that the open folder (typically your INBOX) is "locked" by another mail session -- most likely a more recent session of Pine has taken the INBOX lock. If the top line says "CLOSED" it means that you are trying to access a folder on a remote mail server, and for some reason, communication with the mail server has either been lost, or never successfully established. This can be a result of trying to open a non-existent folder, or one stored on an invalid or non-operational server, or it can mean that Pine has been suspended for more that 30 minutes while accessing a remote mail server. General Pine Commands MAIN MENU Screen Commands --------------------- ------------------------- ? Show help text O Show all Other available commands C Compose a message P Select Previous command up on menu I FOLDER INDEX screen N Select Next command down on menu L FOLDER LIST screen R Display Pine Release Notes A ADDRESS BOOK screen K Lock Keyboard S SETUP functions G Goto a specified folder Q Quit Pine NOTE: The availability of certain commands (e.g. some of the options under SETUP) is determined by Pine configuration files and system capabilities. At some sites, certain commands may not be available due to security or support concerns. The "COMPOSE MESSAGE" command (available on MAIN MENU, FOLDER LIST, FOLDER INDEX, and MESSAGE TEXT screens) takes you into the Pine message composer and permits you to create and send a new message. The "FOLDER INDEX" command (available on MAIN MENU, FOLDER LIST, and MESSAGE TEXT screens) takes you to the FOLDER INDEX screen which displays a summary caption for each message in the currently-open folder. One message will be highlighted; this is the "Current" message. The message commands available from this screen (e.g. View, Reply, Forward, Delete, Print, Save, etc) apply to the current message. The "FOLDER LIST" command (available on MAIN MENU, FOLDER INDEX, and MESSAGE TEXT screens) takes you to the FOLDER LIST screen which displays the names of all your message folders and allows you to view, rename, delete, and add folders. You can open (view) a different folder than the one currently open by highlighting the desired one (using the arrow keys or their control-key equivalents) and pressing RETURN. If you have multiple folder collections defined (see the Help text for the FOLDER LIST screen to learn more about Collections), you may need to press RETURN to expand the collection and display all of the folders in it. The "ADDRESS BOOK" command (available only from the MAIN MENU) takes you to the ADDRESS BOOK management screen. From here, your personal address book(s) may be updated. The "SETUP" command (available only from the MAIN MENU) prompts you for one of several configuration screens, including the SETUP CONFIGURATION screen, by which you may activate optional Pine features. Also available from the Main Menu, but only displayed on the Key Menus at the bottom of the screen, are the following commands: The "Goto" command (available on MAIN MENU, FOLDER LIST, FOLDER INDEX, and MESSAGE TEXT screens) lets you jump directly to a new folder without having to use the Folder List display. It will prompt you for the name of the desired folder and, if you have multiple folder collections defined, allow you to rotate through them. However, if the folder is outside of your defined collections, you are going to have to enter the exact folder location using the correct syntax for a remote folder and/or the fully-qualified path name. The "Release Notes" command displays information about this version of Pine, as well as historical and legal notes. The "Keyboard Lock" command allows your Pine session to be protected during a temporary absence from your terminal. The "Report Bug" command does the obvious thing; please see section (10) below. This command is also available from any help screen (including this one.) ------------------------ | Command Line Options | ------------------------ Possible Starting Arguments for Pine program: Argument Meaning
... Go directly into composer with given address -a Special anonymous mode for UWIN* -c Context # for interpreting -f argument 0=none, 1=incoming, 2=deflt coll'n, 3=next coll'n -d n Debug - set debug level to 'n' -f Folder - open in default collection -F File - open and view text -h Help - give this list of options -F File - open and view text -h Help - give this list of options -i Index - Go directly to index, bypassing main menu -I Initial keystrokes to be executed -k Keys - Force use of function keys -l List - Expand List of folder collections by default -n Entry in index to begin on -nr Special restricted mode for UWIN* -o ReadOnly - Open first folder read-only -p Use in place of .pinerc file -P Use in place of pine.conf file -r Restricted/demo mode -z Suspend - allow use of ^Z suspension -sort Sort - Specify sort order of Folder Index: (Subject, OrderedSubj, Arrival, Date, From, Size, /reverse) -conf Configuration - Output fresh global config to stdout -create_lu Create auxiliary look-up file and sort by . For creating global addrbk. -pinerc Configuration - Put fresh pinerc config in -