home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / pine421.zip / pine.hlp < prev    next >
Text File  |  1999-11-17  |  663KB  |  17,539 lines

  1. # $Id: pine.hlp,v 4.540 1999/11/17 17:56:02 mikes Exp $
  2. #
  3. #           T H E   P I N E    M E S S A G E   S Y S T E M
  4. #
  5. #   Laurence Lundblade, Mike Seibel, Mark Crispin, Steve Hubert,
  6. #      Sheryl Erez, David Miller, Stefan Kramer
  7. #   Networks & Distributed Computing
  8. #   Computing & Communications
  9. #   University of Washington
  10. #   Administration Building, Box 351208
  11. #   Seattle, Washington, 98195, USA
  12. #
  13. #   Email: pine@cac.washington.edu
  14. #
  15. #   Pine and Pico are trademarks of the University of Washington.
  16. #   Pine, Pico and Pilot Copyright 1989-1999  University of Washington
  17. #
  18. #   Additional legal notices are in the Release Notes below or
  19. #   at http://www.washington.edu/pine/legal.html
  20. #
  21. #   Pine was originally based in part on The Elm Mail System:
  22. #
  23. #    ***********************************************************************
  24. #    *       The Elm Mail System  -  Revision: 2.13                        *
  25. #    *                                                                     *
  26. #    *       Copyright (c) 1986, 1987 Dave Taylor                          *
  27. #    *       Copyright (c) 1988, 1989 USENET Community Trust               *
  28. #    ***********************************************************************
  29. #
  30. #
  31.          Help text for the Pine mailer
  32.  
  33. This file is in a format created to be turned into text strings in a C
  34. program.
  35.  
  36. NOTE-NOTE-NOTE-NOTE-NOTE-NOTE-NOTE-NOTE-NOTE-NOTE-NOTE-NOTE-NOTE-NOTE
  37.  
  38.      If you are familiar with versions of this file PRIOR to 
  39.      Pine 4.00 forget what you know.  No more '{' sensitivity.
  40.      No more escaping double-quote character.
  41.  
  42. NOTE-NOTE-NOTE-NOTE-NOTE-NOTE-NOTE-NOTE-NOTE-NOTE-NOTE-NOTE-NOTE-NOTE
  43.  
  44. There are two shell scripts that run on this.  Cmplhelp.sh is the
  45. first and turns this into a C file (helptext.c) of text strings that
  46. are compiled and linked. The other program, cmplhlp2.sh, turns this
  47. into a .h file (helptext.h) with extern string definitions of the
  48. strings in the .c file.  The code that actually processes these files
  49. while pine is running is in help.c
  50.  
  51. The lines with "===== xxxx ====" divide the different help screens.  The
  52. xxx is the name of the variable that strings will be put in, which are
  53. also declared in helptext.h.
  54.  
  55. # is a comment
  56.  
  57. Help text screen text can be either plain text OR HTML.  The latter is
  58. denoted by the first line starting with "<HTML>".  The former is simply
  59. displayed as it's formatted here.
  60.  
  61. HTML is limited to simple formatting ala HTML 2.0.  No forms, or tables.
  62. In addition a small set of tools are are available to customize the HTML
  63. screen's text:
  64.  
  65. 1a)  Default and function key bindings are separated like this:
  66.  
  67. <!--chtml if pinemode="function_key"-->
  68.     Function key bindings here
  69. <!--chtml else-->
  70.     Default key bindings here
  71. <!--chtml endif-->
  72.  
  73.  
  74. 1b)  A way to distinguish HTML text that is to be displayed when
  75.      pine is running vs. when the text is served up outside Pine
  76.      (someday) can be done via:
  77.  
  78. <!--chtml if pinemode="running"-->
  79.    Text displayed when viewed within a running pine session
  80. <!--chtml else-->
  81.    Text displayed when HTML viewed outside pine (using chtml aware server)
  82. <!--chtml endif-->
  83.  
  84. 1c)  A way to distinguish HTML text that is to be displayed under
  85.      PC-Pine vs. not is available via:
  86.  
  87. <!--chtml if pinemode="os_windows"-->
  88.    Text displayed under PC-Pine
  89. <!--chtml else-->
  90.    Text displayed otherwise
  91. <!--chtml endif-->
  92.  
  93. WARNING ABOUT CHTML "if-else-endif" CLAUSES: They don't nest.
  94.  
  95. 2a) Several "server side include" commented elements are supported:
  96.  
  97. <!--#include file="textfile"--> 
  98.  
  99. The file "textfile" will be inserted into the HTML text directly.
  100. Pine does no formatting of the text.  At some point we might want to
  101. look at the first line for <HTML> but not today.
  102.  
  103. 2b) Various bits of Pine's running state can be inserted into the
  104. HTML text as well using the special comment:
  105.  
  106. <!--#echo var="variable"--> 
  107.  
  108. Where "variable" is one of either:
  109.  
  110.     PINE_VERSION
  111.     PINE_COMPILE_DATE
  112.     PINE_TODAYS_DATE
  113.     _LOCAL_FULLNAME_
  114.     _LOCAL_ADDRESS_
  115.     _BUGS_FULLNAME_
  116.     _BUGS_ADDRESS_
  117.     CURRENT_DIR
  118.     HOME_DIR
  119.  
  120. 3) The URL scheme "X-Pine-Gripe:" is available to insert links to
  121.    pine's composer such that various debugging data can be attached to the
  122.    message. Aside from normal email addresses, this can be set to
  123.    either "_LOCAL_ADDRESS_" for the configured local help address, or
  124.    "_BUGS_ADDRESS_" for the configured local bug reporting address.
  125.    Aside from the special tokens above, the default behavior only differs
  126.    from "mailto:" by the insertion of a special Subject: prefix that
  127.    consists of a randomly-generated token for tracking purposes.
  128.    Several optional parameters can be included to control what is
  129.    attached or offered for attachment to the message:
  130.  
  131.         ?config  --  Automatically attaches the user's configuration
  132.                      information to the trouble report
  133.         ?keys    --  Automatically attaches the user's most recent
  134.                      keystrokes
  135.         ?curmsg  --  Causes the user to get an offer to attach the
  136.                      current message to the trouble report
  137.         ?local   --  Automatically attaches the result of the script 
  138.                      defined by VAR_BUGS_EXTRAS
  139.  
  140. For HTML-format sections, the help screen dividers  "===== xxxx ====" must 
  141. contain one and only one space after the first and before the second set of 
  142. equal signs.
  143.  
  144. Note to authors of this file: to mark sections that need further revision, 
  145. please use the text string on the following line consistently so that it is 
  146. easy to find those places again in this file:
  147. *revision needed*
  148.  
  149. NOTE: Several sections of help text which weren't being used were removed
  150. at RCS version number 4.122.  In particular, there were some placeholders
  151. with help text for the config screen and the composer that didn't have any
  152. reasonable place to be called from.
  153.  
  154. ============= h_news =================
  155. <HTML>
  156. <HEAD>
  157. <TITLE>RELEASE NOTES for Pine</TITLE>
  158. </HEAD>
  159. <BODY>                 
  160. <H1>Pine Release Notes</H1>
  161. <CENTER>Version <!--#echo var="PINE_VERSION"-->
  162. <!--chtml if pinemode="running"-->
  163. (built <!--#echo var=PINE_COMPILE_DATE-->)
  164. <!--chtml endif-->
  165. <BR>University of Washington</CENTER><P>
  166.  
  167. <P>
  168. Pine® is the University of Washington's "Program for Internet
  169. News and Email". It is intended to be an easy-to-use program for
  170. sending, receiving, and filing Internet electronic mail messages and
  171. bulletin board (Netnews) messages.  There are versions that will run on
  172. many different flavors of the Unix® operating system, as well as a
  173. version with GUI amenities for 32-bit flavors of Microsoft Windows (95,
  174. 98, and NT).
  175.  
  176.  
  177. <H2>New in Pine <!--#echo var="PINE_VERSION"--></H2>
  178.  
  179. Version <!--#echo var="PINE_VERSION"--> is mainly intended to fix
  180. bugs introduced in previous versions.
  181. <P>
  182. Bugs that have been addressed in this release include:
  183. <P>
  184. <UL>
  185.   <LI> '<A HREF="h_flag_new">N</A>' flag not preserved across sessions
  186.   <LI> 'N' flag not cleared when messages containing non-text pieces viewed
  187.   <LI> <A HREF="h_index_cmd_sort">Sort</A> failure using non-UW IMAP servers
  188.   <LI> Linux port: failure to recognize resized display
  189.   <LI> Problems with quoted /user= argument in
  190.        <A HREF="h_config_smtp_server">smtp-server</A> config
  191.   <LI> Transient (e.g., mistyped password) authentication failures
  192.        not reported
  193.   <LI> Rare cases of deleted header lines reappearing after ^X in Composer
  194.   <LI> Customized headers Bcc, To, Cc and Lcc not shown when posting news
  195.   <LI> Problem with role pattern vs. color patterns in a file
  196.   <LI> Problem with color display vs. single line scrolling
  197.   <LI> Last line of one-page message not displayed in rare cases
  198.   <LI> Text in Reply/Forward of encapsulated multipart/alternative
  199.        and signed missing
  200.   <LI> Failure to recognize <A HREF="h_special_list_commands">list management</A> headers in sorted folder
  201.   <LI> Attachments sometimes marked for deletion when <A HREF="h_rules_score">scoring</A> in use
  202.   <LI> Delayed notification of messages filtered from Inbox to current folder
  203.   <LI> WhereIs to start or end of Folder List screen didn't
  204.   <LI> PC-Pine crash selecting text from secondary window
  205.   <LI> PC-Pine instances of "FOLDER CLOSED DUE TO ACCESS ERROR"
  206. </UL>
  207.  
  208. <P>
  209. General improvements include:
  210.  
  211. <P>
  212. <UL>
  213.   <LI> <A HREF="h_rules_filter">Filter</A> performance and interface tuning:
  214.    <UL>
  215.     <LI> User-Interface changes to avoid accidental deletion of mail
  216.     <LI> Action Folders local to PC-Pine no longer require double-backslashes
  217.     <LI> Improved expunge performance with filters enabled
  218.    </UL>
  219.   <LI> NNTP performance improvements in MESSAGE INDEX screen
  220.   <LI> Role Command (<A HREF="h_role_select">#</A>) improvements
  221.   <LI> Improved display of addresses containing comma in personal name
  222.   <LI> Numerous Text/HTML parser improvements
  223.   <LI> Continued help text improvements
  224. </UL>
  225.  
  226. <P>
  227. Additional details on changes in this (and previous) versions of Pine
  228. may be found at the following URL:
  229. <P>
  230. <CENTER><SAMP><A HREF="http://www.washington.edu/pine/changes.html">http://www.washington.edu/pine/changes.html</A></SAMP></CENTER>
  231. <P>
  232.  
  233. <HR WIDTH="75%"><P>
  234.  
  235. <H2>Getting Help</H2>
  236. <DL>
  237. <DT>Online Help</DT>
  238. <DD>
  239. Every Pine screen and command has associated help text
  240. accesseible via the "?" key (or Ctrl-G in text-input contexts).
  241. </DD>
  242.  
  243. <DT>Web Help</DT>
  244. <DD>
  245. The most current source of information about Pine,
  246. including new version availability, is the web page at
  247. <P>
  248. <CENTER><SAMP><A HREF="http://www.washington.edu/pine/">http://www.washington.edu/pine/</A></SAMP></CENTER>
  249. </DD>
  250. </DL>
  251.  
  252. Frequently Asked Questions (and answers) may be found at the following
  253. URL:
  254. <P>
  255. <CENTER><SAMP><A HREF="http://www.washington.edu/pine/faq/">http://www.washington.edu/pine/faq/</A></SAMP></CENTER>
  256. <P>
  257. Some topics of current interest include:
  258. <UL>
  259. <P><LI> Information on <A HREF="h_info_on_locking">Folder Locking</A>
  260. <P><LI> Information on <A HREF="h_info_on_mbox">Missing mail and the mbox driver</A>
  261. <P><LI> Information on <A HREF="h_composer_cntxt_path">Folder Namespaces</A>
  262. <P>
  263. </UL>
  264.  
  265. <HR WIDTH="75%"><P>
  266.  
  267. <H2>Additional Information</H2>
  268.  
  269. General Pine configuration information can be found
  270. <A HREF="h_news_config">here</A>.
  271. <P>
  272. Pine is also avilable for Windows 32-bit environments.  More information
  273. on PC-Pine can be found <A HREF="h_news_pcpine">here</A>.
  274. <P>
  275. <P> 
  276. Pine was developed by the Office of Computing & Communications at
  277. the University of Washington in Seattle.  A more complete list of
  278. principal players and key contributors can be found on the credits Web
  279. page at
  280.  
  281. <P>
  282. <CENTER><A HREF="http://www.washington.edu/pine/credits.html">http://www.washington.edu/pine/credits</A></CENTER>
  283.  
  284. <P>
  285. Pine and Pico are trademarks of the University of Washington.
  286.  
  287. <P>
  288. Pine, Pico and Pilot Copyright 1989-1999 University of Washington
  289.  
  290. <P>
  291. Additional legal notices can be found <A HREF="h_news_legal">here</A>
  292. or at the web URL:
  293.  
  294. <P>
  295. <CENTER><A HREF="http://www.washington.edu/pine/legal.html">http://www.washington.edu/pine/legal</A></CENTER>
  296.  
  297. <P>
  298. <End of Release Notes>
  299. </BODY>
  300. </HTML>
  301. ====== h_news_pcpine ======
  302. <HTML>
  303. <HEAD>
  304. <TITLE>PC-Pine Notes</TITLE>
  305. </HEAD>
  306. <BODY>
  307. <H1>PC-Pine Notes</H1>
  308.  
  309. PC-Pine <!--#echo var="PINE_VERSION"--> is available for 32-bit
  310. Windows only.  While it is not a full GUI Windows
  311. application, it supports numerous GUI amenities, including:
  312. tool bar, scroll bar, pull-down menus, pop-up menus,
  313. expanded mouse support, etc.
  314.  
  315. <H2>New in PC-Pine 4.20</H2>
  316. <UL>
  317.   <LI> Built-in SSL support -- initiated via
  318.        <A HREF="h_valid_folder_names">/SSL</A> option in
  319.        bracketed server-name
  320.   <LI> More presentable startup
  321.   <LI> Current folder displayed in window title and icon text
  322.   <LI> Configurable input cursor shape
  323.   <LI> Context sensitive mouse cursor shape
  324.   <LI> Mouse vanishes while typing in composer and text input prompts
  325.   <LI> Window and Taskbar icon turn red with new mail notification
  326.     <BR>("<A HREF="h_config_tray_icon">enable-tray-icon</A>"
  327.         added for backward compatibility)
  328.   <LI> Selected URL offered for Pasting to clipboard in popup menu
  329.   <LI> Paste popup menu available in text input prompts
  330.   <LI> Ctrl-Shift-F accelerator added for WhereIs
  331.   <LI> Open folder no longer required before message sending
  332. </UL>
  333. <P>
  334. <B>New in PC-Pine 4.00:</B>
  335. <P>
  336. <UL>
  337.  <LI>Built-in LDAP directory service support.
  338. <P>
  339.  <LI>Remote addressbook support.  The addressbook can be stored on an
  340. IMAP server, so it can be accessed from different computers running
  341. Unix Pine or PC-Pine <!--#echo var="PINE_VERSION"-->.  See Setup/AddressBooks screen for more details.
  342. <P>
  343.  <LI>POP support (though not in traditional offline mode).
  344. <P>
  345.  <LI>Built-in spell checking.
  346. <P>
  347.  <LI>Integration with Windows registry simplifies configuration
  348. for attachment viewing and sending.
  349. <P>
  350.  <LI>Full READ-WRITE access to local Unix-style folders.
  351. <P>
  352. <H2>Problems with INBOX CLOSED DUE TO ACCESS ERROR messages</H2>
  353.  
  354. We have recently discovered that a combination of bugs in TCP/IP
  355. implementations can lead to these errors.  In particular, a problem
  356. with Microsoft's WINSOCK used by PC-Pine and a different problem with
  357. many Unix TCP implementations affecting IMAP server behavior may lead to
  358. this error.  A workaround is to change the mail-check-interval in the
  359. pinerc file on your PC from the default value of 150 seconds to 50
  360. seconds.
  361. <P>
  362. </UL>
  363. Additional notes:
  364. <P>
  365. <UL>
  366. <LI>
  367. While message folders may be either local or remote, Pine's support
  368. files must, generally speaking, be located on your PC's local disk.
  369. These files include Pine's configuration file (PINERC), signature file
  370. (PINE.SIG), interrupted message folder, and debug files.  Two files that 
  371. are by default also located on your PC's local disk <B>may</B> be instead 
  372. located on a remote host:
  373. <P>
  374. <OL>
  375.  <LI>  The postponed messages folder can be <A
  376.  HREF="h_config_postponed_folder">defined in the Setup/Config</A> to be
  377.  on an IMAP server.  This allows it to be accessible from both Unix
  378.  Pine and PC-Pine thus allowing you to, for example, begin composing a
  379.  message in Unix Pine, postpone it, and resume its composition later
  380.  with PC-Pine, provided that <B>both</B> Pine configurations specify the
  381.  <B>same</B> postponed messages folder location.  For example:
  382.  <P>
  383.  <CENTER><SAMP>{myIMAPhost.myschool.k12.wa.us}mail/postponed</SAMP></CENTER>
  384.  
  385.  <LI>It's also possible, depending on your local system configuration, to
  386.  arrange remote access to your NEWSRC as well.  The advantage, as with
  387.  the postponed message folder, is that both Unix Pine and PC-Pine can
  388.  refer to the same information. See the Main Menu's help text section on
  389.  "<A HREF="main_menu_tx#read_news">Reading News</A>"
  390.  for more information.
  391. </OL>
  392.  
  393. <P>
  394. <LI> The PC-Pine message folder format is based on byte-counts for maximum
  395.  efficiency, so they must not be edited. The format is non-standard, but
  396.  conversion utilities would not be difficult. This format is supported in
  397.  Unix Pine as well.
  398.  
  399. </UL>
  400.  
  401. <P>
  402. <End of PC-Pine Notes>
  403. </BODY>
  404. </HTML>
  405. ====== h_news_config ======
  406. <HTML>
  407. <HEAD>
  408. <TITLE>Pine Configuration</TITLE>
  409. </HEAD>
  410. <BODY>
  411. <H1>Pine Configuration</H1>
  412.  
  413. <H2>Configuration precedence</H2>
  414.  
  415. There are several levels of Pine configuration.  Configuration values at
  416. a given level override corresponding values at lower levels.  In order of
  417. increasing precedence:
  418. <P>
  419. <UL>
  420.  <LI> built-in defaults
  421.  <LI> system-wide
  422. <!--chtml if pinemode="os_windows"-->
  423.       config file from command line or provided
  424.       by "PINECONF" environment variable
  425. <!--chtml else-->
  426.       pine.conf file
  427. <!--chtml endif-->
  428.  <LI> personal 
  429. <!--chtml if pinemode="os_windows"-->
  430.       PINERC
  431. <!--chtml else-->
  432.       .pinerc
  433. <!--chtml endif-->
  434.       file (may be set via built-in Setup/Config menu.)
  435.  <LI> command-line options
  436.  <!--chtml if pinemode="os_windows"--><!--chtml else-->
  437.  <LI> system-wide pine.conf.fixed file<!--chtml endif-->
  438. </UL>
  439. <P>
  440. There is one exception to the rule that configuration values are replaced
  441. by the value of the same option in a higher-precedence file:
  442. the feature-list variable has values that are additive, but can be
  443. negated by prepending "no-" in front of an individual feature name.
  444. Note, this is done automatically for you when you change these values via
  445. the Setup/Config command.
  446.  
  447. <H2>File name defaults</H2>
  448.  
  449. Notes:<P>
  450.  
  451. <BR> <exe dir> = directory where pine.exe found.
  452. <BR> <pinerc dir> = directory where pinerc found.
  453. <BR> # = default file name is overridable in pinerc.
  454. <BR> $HOME, if not explicitly set, defaults to root of the current drive.
  455. <BR> $MAILCAPS, if set, is used in lieu of the default mailcap search paths.
  456. <BR> + between the mailcap paths implies that the two files are combined.
  457. <BR> ; between other default paths implies that the first one found is used.
  458. </P>
  459. Pine looks for most support files in the same directory it finds its
  460. personal configuration file (pinerc).  The -p command-line flag may be
  461. used to specify a particular path name for the pinerc file.  If a
  462. pinerc file does not exist, it will be created (if directory permissions
  463. allow).  In PC-Pine, if -p or $PINERC are not defined, Pine will look
  464. in $HOME\PINE and the directory containing the PINE.EXE.  If a PINERC
  465. file does not exist in either one, it will create one in the first of those
  466. two directories that is writable.  In detail:
  467. <PRE>
  468.  
  469. PC-Pine:
  470.  
  471.  executable     <DOS search path>\pine.exe
  472.  help index     <exe dir>\pine.ndx
  473.  help text      <exe dir>\pine.hlp
  474.  
  475.  pers config    $PINERC  ;  $HOME\pine\pinerc  ;  <exe dir>\pinerc
  476.  global cfg     $PINECONF
  477.  
  478.  password       <pinerc dir>\pine.pwd
  479.  debug          <pinerc dir>\pinedebg.txt
  480.  crash          <pinerc dir>\pinecrsh.txt
  481.  signature#     <pinerc dir>\pine.sig
  482.  addressbook#   <pinerc dir>\addrbook
  483.  addrbook lu    <pinerc dir>\addrbook.lu    (appends .lu to addrbk name.)
  484.  mailcap#       <pinerc dir>\mailcap  +  <exe dir>\mailcap
  485.  mimetypes#     <pinerc dir>\mimetype +  <exe dir>\mimetype
  486.  newsrc#        $HOME\newsrc (if exists, else) <pinerc dir>\newsrc
  487.  sentmail#      $HOME\mail\sentmail.mtx
  488.  postponed#     $HOME\mail\postpond.mtx
  489.  interrupted    $HOME\mail\intruptd
  490.  
  491. Unix Pine:
  492.  
  493.  executable     <Unix search path>/pine
  494.  persnl cfg     ~/.pinerc
  495.  global cfg     /usr/local/lib/pine.conf
  496.  fixed cfg      /usr/local/lib/pine.conf.fixed
  497.  local help     /usr/local/lib/pine.info
  498.  
  499.  interrupted    ~/.pine-interrupted-mail
  500.  debug          ~/.pine-debugN
  501.  crash        ~/.pine-crash
  502.  newsrc#        ~/.newsrc
  503.  signature#     <pinerc dir>/.signature
  504.  addressbook#   <pinerc dir>/.addressbook
  505.  addrbook lu    <pinerc dir>/.addressbook.lu  (appends .lu to addrbk name.)
  506.  postponed#     ~/mail/postponed-msgs
  507.  sentmail#      ~/mail/sent-mail
  508.  mailcap#       ~/.mailcap + /etc/mailcap
  509.                            + /usr/etc/mailcap + /usr/local/etc/mailcap
  510.  mimetypes#     ~/.mime.types + /etc/mime.types + /usr/local/lib/mime.types
  511.  
  512.  news-spool    varies across Unix flavors, e.g. /usr/spool/news or /var/news
  513.  active-news    varies across Unix flavors, e.g. /usr/lib/news/active
  514.  lock files     /tmp/.\usr\spool\mail\xxxx
  515.  inbox          /usr/spool/mail/xxxx
  516.  password       /etc/passwd
  517.  
  518. Unix Pine and PC-Pine:
  519.  
  520.  .ab*           remote addressbook support files
  521.  a[1-9]*        temporary (while Pine is running) addressbook files
  522.  
  523. </PRE>
  524.  
  525. <H2>Mailcap files</H2>
  526.  
  527. Pine honors the mailcap configuration system for specifying external
  528. programs for handling attachments.  The mailcap file maps MIME attachment
  529. types to the external programs loaded on your system which can display
  530. and/or print the file.  A sample mailcap file comes bundled with the Pine
  531. distribution.  It includes comments which explain the syntax you need to
  532. use for mailcap.  With the mailcap file, any program (mail readers,
  533. newsreaders, WWW clients) can use the same configuration for handling
  534. MIME-encoded data.
  535.  
  536. <H2>MIME-Types files</H2>
  537.  
  538. Pine uses mime-types files (.mime.types or MIMETYPE) to determine
  539. what Content-Type to use for labeling an attached file, based on
  540. the file extension.  That is, this file provides a mapping between
  541. filename extensions and MIME content-types.
  542.  
  543. <H2>Environment variables</H2>
  544.  
  545. PC-Pine uses the following environment variables:
  546. <DL>
  547. <DT>PINERC</DT>
  548. <DD>Optional path to pinerc file.</DD>
  549. <DT>PINECONF</DT>
  550. <DD>Optional path to global pine config file.</DD>
  551. <DT>HOME</DT>
  552. <DT>TMP or TEMP</DT>
  553. <DT>COMSPEC</DT>
  554. <DT>MAILCAPS</DT>
  555. <DD>A <B>semicolon</B> delimited list of path names to mailcap files.</DD>
  556. <DT>USER_DICTIONARY</DT>
  557. <DD>Used to specify the file to contain the user's spell check
  558. dictionary.  The default is <SAMP>DICT.U</SAMP> in the same
  559. directory as the <SAMP>SPELL32.DLL</SAMP></DD>
  560. </DL>
  561.  
  562. Unix Pine uses the following environment variables:
  563. <DL>
  564. <DT>TERM</DT>
  565. <DD>Tells Pine what kind of terminal is being used.</DD>
  566. <DT>DISPLAY</DT>
  567. <DD>Determines if Pine will try to display IMAGE attachments.</DD>
  568. <DT>SHELL</DT>
  569. <DD>If not set, default is "/bin/sh".</DD>
  570. <DT>MAILCAPS</DT>
  571. <DD>A <B>colon</B> delimited list of path names to mailcap files.</DD>
  572. </DL>
  573.  
  574. <P>
  575. <End of Configuration Notes>
  576. </BODY>
  577. </HTML>
  578. ====== h_news_legal ======
  579. <html>
  580. <head>
  581. <TITLE>Pine Legal Notices</TITLE>
  582. </head>
  583. <body>
  584.  
  585. <H1>Pine Legal Notices</H1>
  586.  
  587. Pine and Pico are registered trademarks of the University of Washington.
  588. No commercial use of these trademarks may be made without prior written
  589. permission of the University of Washington.
  590. <P>
  591. Pine, Pico, and Pilot software and its included text are Copyright
  592. 1989-1999 by the University of Washington. 
  593. <P>
  594. Use of Pine/Pico/Pilot:  You may compile and execute these programs for
  595. any purpose, including commercial, without paying anything to the
  596. University of Washington, provided that the legal notices are maintained
  597. intact and honored.
  598. <P>
  599. Local modification of this release is permitted as follows, or by mutual
  600. agreement: In order to reduce confusion and facilitate debugging, we
  601. request that locally modified versions be denoted by appending the letter
  602. "L" to the current version number, and that the local changes be
  603. enumerated in the integral release notes and associated documentation.
  604. <P>
  605. Redistribution of this release is permitted as follows, or by mutual
  606. agreement:<BR>
  607.  (a) In free-of-charge or at-cost distributions by non-profit concerns;<BR>
  608.  (b) In free-of-charge distributions by for-profit concerns;<BR>
  609.  (c) Inclusion in a CD-ROM collection of free-of-charge, shareware, or
  610.       non-proprietary software for which a fee may be charged for the 
  611.       packaged distribution.
  612. <P>
  613. Redistribution of binary versions is further constrained by license agreements
  614. for incorporated libraries from third parties, e.g. LDAP, GSSAPI.
  615. <P>
  616. The University of Washington encourages unrestricted distribution of 
  617. individual patches to the Pine
  618. system.  By "patches" we mean "difference" files 
  619. that can be applied
  620. to the University of Washington Pine source distribution in order to 
  621. accomplish bug fixes, minor
  622. enhancements, or adaptation to new operating systems.  Submission of these
  623. patches to University of Washington for possible inclusion in future 
  624. Pine versions is also
  625. encouraged.
  626. <P>
  627. The above permissions are hereby granted, provided that the Pine and Pico
  628. copyright and trademark notices appear in all copies and that both the
  629. above copyright notice and this permission notice appear in supporting
  630. documentation, and that the name of the University of Washington not be
  631. used in advertising or publicity pertaining to distribution of the
  632. software without specific, prior written permission.  This software is
  633. made available "as is", and
  634. <P>
  635. THE UNIVERSITY OF WASHINGTON DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED,
  636. WITH REGARD TO THIS SOFTWARE, INCLUDING WITHOUT LIMITATION ALL IMPLIED
  637. WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, AND IN
  638. NO EVENT SHALL THE UNIVERSITY OF WASHINGTON BE LIABLE FOR ANY SPECIAL,
  639. INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
  640. LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, TORT
  641. (INCLUDING NEGLIGENCE) OR STRICT LIABILITY, ARISING OUT OF OR IN
  642. CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 
  643.  
  644.  
  645.  
  646. <P>
  647. <End of Pine Legal Notices>
  648. </BODY>
  649. </HTML>
  650. ===== h_news_bugs =====
  651. <HTML>
  652. <HEAD>
  653. <TITLE>Bug fixes in <!--#echo var="PINE_VERSION"--></TITLE>
  654. </HEAD>
  655. <BODY>
  656.  
  657. <H1>Bug Fixes in <!--#echo var="PINE_VERSION"--></H1>
  658.  
  659. The bugs found, reported and fixed in this version of Pine include:
  660. <P>
  661. <UL>
  662. <LI> fixed Fcc: vs. ^T vs. file existence confusion
  663. <LI> fixed hang when mail-check-interval set to zero
  664. <LI> Tab completion made more consistent
  665. <LI> fixed to allow attaching file names containing commas
  666. <LI> Selected in Folder List preserved in all cases
  667. <LI> improved accuracy of NextNew processing
  668. <LI> adjacent folder becomes selected when Folder List entry deleted
  669. <LI> leading newlines suppressed with empty reply-leadin
  670. <LI> Role processing now applies to Forward command
  671. <LI> Role processing now applies to mailto: handling
  672. <LI> folder list's disappearing INBOX
  673. <LI> text paging preserved when screen resized
  674. <LI> PC-Pine failure to cache large (> 16k) fetches
  675. <LI> potential loss of postponed message when INBOX open failed
  676. <LI> potential loss of .interrupted-mail when telnet session lost
  677. <LI> crash when From address deleted from postponed message
  678. <LI> LOGIN referral failure
  679. <LI> safer method used to spin bar in wait indicator
  680. <LI> improved listmode performance in newsgroup selection
  681. <LI> zoomed Message Index now printable
  682. <LI> bug causing incorrect Message Index after sort
  683. </UL>
  684.  
  685. <P>
  686. <End of Fixed Bug List>
  687. </BODY>
  688. </HTML>
  689. ===== h_info_on_mbox =====
  690. <HTML>
  691. <HEAD>
  692. <TITLE>Information on mbox driver</TITLE>
  693. </HEAD>
  694. <BODY>
  695. <H1>Information on "Missing Mail" and the "mbox" driver</H1>
  696.  
  697. Beginning with Pine 4.00 (but also with earlier versions of the
  698. University of Washington's imapd server), a new INBOX access method is
  699. available as part of the standard configuration.  It is called the
  700. "mbox" driver and it works like this:<P>
  701.  
  702. <P>
  703. <BLOCKQUOTE>
  704. If the file "mbox" exists in the user's home directory, and
  705. is in Unix mailbox format, then when INBOX is opened this file will be
  706. selected as INBOX instead of the mail spool file.  Messages will be
  707. automatically transferred from the mail spool file into the mbox
  708. file. Beginning with Pine 4.01, a message is displayed whenever Pine
  709. copies messages from the system mail spool directory to the mbox
  710. file.
  711. </BLOCKQUOTE>
  712.  
  713. <P>
  714. The advantage of this method is that, after new mail has been copied
  715. from the system mail spool, all subsequent access is confined to the
  716. user's home directory, which is desirable on some systems.  However, a
  717. possible disadvantage is that mail tools other than those from the
  718. University of Washington will not know to look for mail in the user's
  719. mbox file.  For example, POP or IMAP servers other than those from the
  720. University of Washington, and many "new mail notification"
  721. programs may not work as expected with this driver enabled.<P>
  722.  
  723. To disable this behavior, either remove/rename the "mbox"
  724. file or find the "disable-these-drivers=" variable in your
  725. Pine configuration file and add "mbox" to it.  You must
  726. manually edit the config file so that you see the following:<P>
  727. disable-these-drivers=mbox
  728.  
  729. <P>
  730. <End of help on this topic>
  731. </BODY>
  732. </HTML>
  733. ===== h_info_on_locking =====
  734. <HTML>
  735. <HEAD>
  736. <TITLE>FAQs on Pine Locking</TITLE>
  737. </HEAD>
  738. <BODY>
  739. <H1>What Systems Managers Need to Know about Pine File Locking</H1>
  740.  
  741. There is an extensive section on locking in the Pine technical notes;
  742. this information is intended to provide answers to some common questions:<P>
  743. <OL>
  744. <LI> Why did locking change in Pine 4.00?<BR>
  745. The actual locking mechanisms did not change in 4.00.
  746. What changed is that when one particular locking mechanism used by Pine 
  747. fails, Pine now issues a warning message.  Prior to 4.00, the locking
  748. failure would occur, but no warning was issued.<P>
  749.  
  750. <LI> Is this what the "Mailbox vulnerable" message is about?<BR>
  751. Yes.  It means that Pine was unable to create a lockfile in the
  752. spool directory, generally because of overly restrictive protections on the
  753. spool directory.  The correct permissions on the spool directory for
  754. running Pine are 1777, i.e. read-write-execute permission for everyone,
  755. with the sticky-bit set, so only owners of a file can delete them.<P>
  756.  
  757. <LI> Why does Pine require that the mail spool directory have 1777
  758.    protections?<BR>
  759. Pine was designed to run without special privileges.  This means that in
  760. order to create a lockfile in the spool directory, it is necessary to have
  761. the spool directory permissions be world-writable.<P>
  762.  
  763. <LI> Can't you create the lockfile somewhere else?<BR>
  764. No.  The lockfile in question must be in the mail spool directory, because
  765. that's where the mail delivery program expects to find it, and the purpose
  766. of the file is to coordinate access between the mail client (Pine) and the
  767. mail delivery program.<P>
  768.  
  769. <LI> Isn't having the spool directory world-writable a big security risk?<BR>
  770. No.  Remember that the individual mail files in the spool directory are
  771. NOT world-writable, only the containing directory.  Setting the "sticky
  772. bit" -- indicated by the "1" before the "777" mode 
  773. -- means that only the owner of the file (or root) can delete files in the 
  774. directory.  So the only bad behavior that is invited by the 1777 mode is that 
  775. anyone could
  776. create a random file in the spool directory.  If the spool directory is
  777. under quota control along with home directories, there is little incentive
  778. for anyone to do this, and even without quotas a periodic scan for
  779. non-mail files usually takes care of the problem.  <P>
  780.  
  781. <LI> Why not run Pine as setgid mail?<BR>
  782. Pine was never designed to run with privileges, and to do so introduces a
  783. significant security vulnerability.  For example, if a user suspends Pine,
  784. the resulting shell will have group privileges.  This is one example of
  785. why we strongly recommend against running Pine as a privileged program.
  786. In addition, a "privileged mailer " paradigm would mean that normal 
  787. users
  788. could not test Pine versions or other mailers that had not been installed
  789. by the system administrators.<P>
  790.  
  791.  
  792. <LI> Are there any alternatives to creating .lock files in the spool dir?<BR>
  793. There are, but they all have different sets of tradeoffs, and not all will
  794. work on all systems.  Some examples:<UL>
  795.  <LI> Use lock system calls.  Works fine on a few systems, provided mail
  796.    spool is local.   Doesn't work reliably if NFS is used.
  797.    Doesn't work unless <B>all</B> the mail programs accessing the spool dir
  798.    use the same calls.
  799.  <LI> Deliver mail to user's home directory.  An excellent solution, highly
  800.    recommended -- but one which is incompatible with some "legacy" 
  801. mail tools that always look in the spool directory for the mail.
  802. </UL><P>
  803.  
  804. <LI> Are these spool directory lock files the only kinds of locks used by
  805.    Pine?<BR>
  806. No.  Pine also creates lockfiles in the /tmp directory.  For normal Unix
  807. mailbox format folders, these are used to coordinate access between
  808. multiple Pine sessions.  <P>
  809.  
  810. <LI> What about the 
  811. <A HREF="h_config_quell_lock_failure_warnings">"quell-lock-failure-warnings"</A> feature added in Pine 4.01?<BR>
  812. This is for people who are content to live dangerously, or who have
  813. specific knowledge that the spool directory lockfiles are superfluous on
  814. their system (because both Pine and the mail delivery program are using 
  815. system call file locking in a context that works reliably, e.g. not NFS.)<P>
  816.  
  817. <LI> Where can I find more details on how Pine locking works?<BR>
  818. See the Pine Technical Notes.<P>
  819.  
  820. </OL>
  821. <P>
  822. <End of help on this topic>
  823. </BODY>
  824. </HTML>
  825. ===== h_finding_help ====
  826. <HTML>
  827. <HEAD>
  828. <TITLE>Finding more information and requesting help</TITLE>
  829. </HEAD>
  830. <BODY>
  831. <H1>Places to Look for More Answers</H1>
  832. If you have questions about or problems with Pine that you cannot resolve 
  833. after consulting the program's internal, context-sensitive help screens, here 
  834. are additional information resources that you may find helpful:
  835. <P>
  836. <UL>
  837.   <LI> Pine's internal <A HREF="h_news">Release Notes</A>.  They contain a 
  838. listing of changes in Pine <!--#echo var="PINE_VERSION"-->
  839.   since the last version, which may be useful for you to be aware of, 
  840. <B>especially</B> if a "problem" you are encountering is actually 
  841. a change in the way an aspect of Pine works.  There, you will also find notes 
  842. on Pine configuration.<P>
  843.  
  844.   <LI> The Pine Information Center (maintained by the University of
  845.        Washington) World Wide Web site contains, among other things
  846.        <UL>
  847.        <LI>a collection of Frequently Asked Questions (and answers!) about Pine
  848.        <LI>an overview of the basics for beginning Pine users
  849.        <LI>Technical Notes for systems administrators
  850.        <LI>archives (including a searchable index) of the pine-info 
  851. mailing list, on which matters of interest to systems/email administrators,
  852. developers, trainers, user support personnel, and others involved with Pine 
  853. messaging on a "technical" level are discussed.
  854. </UL>
  855.     The Pine Information Center can be accessed with a WWW browser at:<P>
  856.         <CENTER><A HREF="http://www.washington.edu/pine/">http://www.washington.edu/pine/</A></CENTER>  
  857. </UL>
  858. <P><HR WIDTH="75%">
  859. <H1>Requesting help</H1>
  860. If the internal help, the Release Notes, the Pine Information Center, and your 
  861. local online and print resources do not help you resolve a problem, please
  862. start by contacting your local computer support staff and asking for help.
  863. <p>
  864. This is especially true if:
  865. <ul>
  866.   <li>You suddenly have trouble sending or receiving mail.
  867.   <li>You receive a "disk quota exceeded" message.
  868.   <li>You have forgotten your password.
  869.   <li>You think your account may have been compromised.
  870.   <li>You need help viewing an attachment.
  871.   <li>You need to know how to configure your:
  872.       <A HREF="h_config_nntp_server">NNTP (news) server</A>, 
  873.       <A HREF="h_config_smtp_server">SMTP (sending mail) server</A>, 
  874.       <A HREF="h_config_ldap_server">LDAP (directory lookup) server</A>, or
  875.       <A HREF="h_config_inbox_path">INBOX (incoming mail) path</A>.
  876.   <li>You want to know what alternative editors or spellcheckers you may be able to use.
  877.   <li>You want to block email from a particular person.
  878.   <li>You're going on vacation and need to autorespond to incoming mail.
  879.   <li>You want to automatically file or filter incoming messages.
  880. </ul>
  881.  
  882. In all of these cases,
  883. you should contact <B>your</B> support staff, because <B>only they</B> 
  884. will be able to assist you effectively. Your support staff may be, depending on who 
  885. provides you with the email account you use Pine with, for example:<UL>
  886. <LI> the computing help desk of (a department of) your university, school, 
  887. employer, ... ; or
  888. <LI> the customer service center of your Internet Service Provider; or
  889. <LI> the friendly volunteer helpers of your Freenet; or
  890. <LI> the person who setup your computer and internet connection.
  891. </UL>
  892.  
  893. Due to the large number of Pine installations worldwide, and because we
  894. receive no funding for it, the Pine development team <B>cannot provide 
  895. individual support services outside the University of Washington</B>.
  896. <P>
  897. If you have no local computing support to turn to, the worldwide <b>comp.mail.pine</b>
  898. newsgroup can be a valuable source of information and assistance for Pine 
  899. user issues.
  900. <P>
  901. For systems/email administrators, developers, trainers, user support
  902. personnel, and others involved with Pine messaging on a "technical"
  903. level, the mailing list pine-info is available; for information on
  904. subscribing and posting to it, see
  905. <P>
  906. <CENTER><A HREF="http://www.washington.edu/pine/pine-info/subscribing.html">http://www.washington.edu/pine/pine-info/subscribing.html</A></CENTER>
  907. <P>
  908.  
  909. Regardless of whom you are asking for help with Pine, remember 
  910. to provide as much detail as you can about the
  911. nature of any problem you are encountering, such as
  912. <UL>
  913. <LI>when it first occurred;
  914. <LI>what, if anything, happened that might have brought it about;
  915. <LI>whether it still persists;
  916. <LI>whether it is reproducible, and if so, how;
  917. <LI>what, if anything, you already tried to solve it.
  918. </UL> 
  919. It may also be helpful if you specify what version of Pine you are using 
  920. <!--chtml if pinemode="running"-->
  921. -- this is <!--#echo var="PINE_VERSION"--> --
  922. <!--chtml endif-->
  923. and on what system, and when the copy of Pine you are using was created
  924. <!--chtml if pinemode="running"-->
  925. -- for this copy: <!--#echo var=PINE_COMPILE_DATE-->
  926. <!--chtml endif-->
  927.  
  928. <!--chtml if pinemode="running"-->
  929. <P>   
  930. When the Pine program you are currently using was installed, a support
  931. contact email address may have been set up; in that case, you can simply select
  932. this link now to send a message to it:<BR>
  933. <A HREF="X-Pine-Gripe:_LOCAL_ADDRESS_?local"><!--#echo var="_LOCAL_FULLNAME_"--></A><P>
  934. <!--chtml endif-->
  935. <!--chtml if [ -r /usr/local/lib/pine.info ]-->
  936. <HR WIDTH="75%">Local Support Contacts:<P>
  937. <!--#include file="/usr/local/lib/pine.info"-->
  938. <HR WIDTH="75%">
  939. <!--chtml endif-->
  940. <P> 
  941. <End of help on this topic>
  942. </BODY>
  943. </HTML>
  944. ===== new_user_greeting ======
  945. <HTML>
  946. <HEAD>
  947. <TITLE>NEW USER GREETING</TITLE>
  948. </HEAD>
  949. <BODY>
  950. <CENTER><<<This message will appear only once>>></CENTER>
  951. <BR>
  952. <H1>Welcome to Pine ... a Program for Internet News and Email</H1>
  953. We hope you will explore Pine's many capabilities. From the Main Menu,
  954. select Setup/Config to see many of the options available to you. Also note
  955. that all screens have context-sensitive help text available.<P>
  956. <!--chtml if pinemode="phone_home"-->
  957. SPECIAL REQUEST:
  958. This software is made available world-wide as a public service of the
  959. University of Washington in Seattle.  In order to justify continuing
  960. development, it is helpful to have an idea of how many people are using
  961. Pine.  Are you willing to be counted as a Pine user?  Pressing 
  962. <A HREF="X-Pine-Phone-Home:">Return</A>
  963. will send an anonymous (meaning, your real email address will not be revealed) 
  964. message to the Pine development team at the University of Washington for 
  965. purposes of tallying.
  966. <P>
  967. <!--To Exit this screen and continue your Pine session press "E".-->
  968. <!--chtml else-->
  969. To Exit this screen and continue your Pine session press "Return".
  970. <!--chtml endif-->
  971. <CENTER>Pine is a trademark of the University of Washington.</CENTER>
  972. </BODY>
  973. </HTML>
  974. ===== new_version_greeting ======
  975. <HTML>
  976. <HEAD>
  977. <TITLE>NEW VERSION GREETING</TITLE>
  978. </HEAD>
  979. <BODY>
  980. <CENTER><<<This message will appear only once>>></CENTER>
  981. <BR>
  982. <H1>Welcome to Pine version <!--#echo var="PINE_VERSION"-->!</H1>
  983. Your Pine configuration file indicates that you may not have used 
  984. this version of Pine before.  This version's significant changes are
  985. documented in the Release Notes, which may be viewed by pressing 
  986. "R" now or while in the Main Menu.
  987. <P>
  988. <!--chtml if pinemode="phone_home"-->
  989. SPECIAL REQUEST: 
  990. This software is made available world-wide as a public service of the
  991. University of Washington in Seattle.  In order to justify continuing
  992. development, it is helpful to have an idea of how many people are using
  993. Pine.  Are you willing to be counted as a Pine user?  Pressing 
  994. <A HREF="X-Pine-Phone-Home:">Return</A>
  995. will send an anonymous (meaning, your real email address will not be revealed) 
  996. message to the Pine development team at the University of Washington for 
  997. purposes of tallying.
  998.  
  999. <!--To Exit this screen and continue your Pine session press "E".-->
  1000. <!--chtml else-->
  1001. To Exit this screen and continue your Pine session press "Return".
  1002. <!--chtml endif-->
  1003. <P>
  1004. <CENTER>Pine is a trademark of the University of Washington.</CENTER>
  1005. </BODY>
  1006. </HTML>
  1007.  
  1008. ===== main_menu_tx ======
  1009. <HTML>
  1010. <HEAD>
  1011. <TITLE>GENERAL INFORMATION ON THE PINE MESSAGE SYSTEM</TITLE>
  1012. </HEAD>
  1013. <BODY>
  1014. <H1>GENERAL INFORMATION ON THE PINE MESSAGE SYSTEM</H1>
  1015. <CENTER>Version <!--#echo var="PINE_VERSION"-->
  1016. <!--chtml if pinemode="running"-->
  1017. (built <!--#echo var=PINE_COMPILE_DATE-->)
  1018. <!--chtml endif-->
  1019. <BR>University of Washington</CENTER>
  1020.  
  1021. <H2>TABLE OF CONTENTS</H2>
  1022. <OL>
  1023.   <LI> <A HREF="#intro">Introduction</A>
  1024.   <LI> <A HREF="#pine_help">Pine Help</A>
  1025. <!--chtml if [ -r /usr/local/lib/pine.info ]-->
  1026.   <LI> <A HREF="#local_support">Local Support Contacts</A>
  1027. <!--chtml endif-->
  1028.   <LI> <A HREF="#giving_cmds">Giving Commands in Pine</A>
  1029.   <LI> <A HREF="#status_line">Status Line</A>
  1030.   <LI> <A HREF="#main_menu">Main Menu</A>
  1031.  
  1032.   <li> <a href="#addressbooks">Address Books</a>
  1033.   <li> <a href="#ldap">LDAP</a>
  1034.   <li> <a href="#index">Index of Messages</a>
  1035.   <li> <a href="#messages">Reading Messages</a>
  1036.   <li> <a href="#compose">Composing Messages</a>
  1037.   <li> <a href="#collection">Collection List</a>
  1038.   <li> <a href="#folders">Folder List</a>
  1039.   <li> <a href="#color">Color</a>
  1040.   <li> <a href="#roles">Roles</a>
  1041.   <li> <a href="#filtering">Filtering</a>
  1042.   <li> <a href="#patterns">Patterns</a>
  1043.  
  1044.   <LI> <A HREF="#cmd_line">Command Line Options</A>
  1045.   <LI> <A HREF="#pine_conf">Pine Configuration</A>
  1046.   <LI> <A HREF="#read_news">Reading News</A>
  1047.   <LI> <A HREF="#probs">Reporting Problems</A>
  1048.  
  1049.   <li> <a href="h_help_index">Index to Pine's Online Help</a>
  1050. </OL>
  1051.  
  1052. <H2><A NAME="intro">Introduction</A></H2>
  1053.  
  1054. Pine® is the University of Washington's "Program for Internet
  1055. News and Email".  It is intended to be an easy-to-use program for
  1056. sending, receiving, and filing Internet electronic mail messages and
  1057. bulletin board (Netnews/Usenet) messages. Pine supports the following
  1058. Internet protocols and specifications: SMTP (Simple Mail Transport Protocol), 
  1059. NNTP (Network News Transport Protocol), MIME (Multipurpose Internet Mail 
  1060. Extensions), and IMAP (Internet Message Access Protocol).<p>
  1061.  
  1062. Although originally designed for inexperienced email users, Pine has
  1063. evolved to support many advanced features.  There are an ever-growing
  1064. number of configuration and personal-preference options, though which of
  1065. them are available to you is determined by your local system managers. 
  1066.  
  1067. <H3>WHAT PINE DOES...</H3>
  1068.  
  1069. Pine is a "mail user agent" (MUA), which is a program that
  1070. allows you to
  1071. compose and read messages using Internet mail standards.  (Whether you
  1072. can correspond with others on the Internet depends on whether or not your
  1073. computer is connected to the Internet.)  Pine also allows reading and
  1074. posting messages on the Internet "net news" system, provided
  1075. that your site operates a suitable news server.
  1076.  
  1077. <H3>WHAT PINE DOES <EM>NOT</EM> DO...</H3>
  1078.  
  1079. A "mail user agent" such as Pine is just one part of a
  1080. messaging system. Here are some things that are <B>not</B> done by Pine,
  1081. but require other programs:<P>
  1082. <UL>
  1083.  <LI> Actual relaying of email... which is done by "message transfer 
  1084. agents".
  1085.  <LI> Vacation messages... automatically responding to incoming messages
  1086.  <LI> Anything to do with "talk"... which has nothing to do with 
  1087. email.
  1088.  <LI> Anything to do with "irc"... which has nothing to do with email.
  1089.  <LI> List processing... resending one message to a list of recipients.
  1090. </UL>
  1091.  
  1092. <H2><A NAME="pine_help">Pine Help</A></H2>
  1093.  
  1094. Pine help is generally context-sensitive. In other words, each Pine screen you 
  1095. use will have its own help text, explaining the choices available for that
  1096. screen. This general help section, on the other hand, attempts to give an 
  1097. overall picture of what Pine is capable of doing, as well as pointers to 
  1098. additional help sections about specific topics.<p>
  1099.  
  1100. In addition to this general help on Pine, <A HREF="h_news">Release Notes</A>
  1101. on the current Pine version are also available from the MAIN MENU: Press
  1102. <!--chtml if pinemode="function_key"-->
  1103. "F9"
  1104. <!--chtml else-->
  1105. "R"
  1106. <!--chtml endif-->
  1107. to browse the release notes.  These include changes since the last release,
  1108. notes for PC-Pine, configuration information, the history of the Pine
  1109. project, credits, and legal notices.
  1110.  
  1111. Pine files and documentation are available via FTP or WWW:
  1112. <P>
  1113. <CENTER><SAMP><A 
  1114. HREF="ftp://ftp.cac.washington.edu/pine/">ftp://ftp.cac.washington.edu/pine/</A>
  1115. </SAMP></CENTER>
  1116. or
  1117. <CENTER><SAMP><A 
  1118. HREF="http://www.washington.edu/pine/">http://www.washington.edu/pine/</A></SAMP
  1119. ></CENTER>
  1120. <P>
  1121. For a copy of the current Pine "Frequently Asked Questions"
  1122. (FAQ) list, send an empty message to
  1123. <A HREF="mailto:pine-faq@cac.washington.edu">pine-faq@cac.washington.edu</A>.
  1124. <P>
  1125.  
  1126. If you would like to print <EM>all</EM> of Pine's internal help text for
  1127. a little light bedtime reading, then press
  1128. <!--chtml if pinemode="function_key"-->
  1129. "F12"
  1130. <!--chtml else-->
  1131. "Z"
  1132. <!--chtml endif-->
  1133. now.  (This assumes that the
  1134. copy of Pine you are using has been properly configured for printing
  1135. at your site.)
  1136.  
  1137.  
  1138. <!--chtml if [ -r /usr/local/lib/pine.info ]-->
  1139. <H2><A NAME="local_support">Local Support Contacts</A></H2>
  1140. <!--#include file="/usr/local/lib/pine.info"-->
  1141. <!--chtml endif-->
  1142.  
  1143. <H2><A NAME="giving_cmds">Giving Commands in Pine</A></H2>
  1144.  
  1145. The bottom two lines of the screen are always used to list the
  1146. commands you can give.  You press the keys that are highlighted to give
  1147. the command.  The commands for getting help and going back to the main
  1148. menu are always present (except when viewing help as you are now).
  1149. <!--chtml if pinemode="function_key"-->
  1150. <!--chtml else-->
  1151. <p>
  1152. Pressing O (meaning "Other Commands") changes the keys
  1153. you see at the bottom of any screen. In some cases there are 3 different
  1154. sets of keys that can be seen by using the O key. <EM>All commands are 
  1155. active</EM>, even if they are not currently showing at the bottom of your 
  1156. screen. In other words, you <EM>never</EM> need to press the O key, except to 
  1157. remind yourself of the proper key to press to perform an operation.
  1158.  
  1159. <H3>Control Key Commands</H3>
  1160. When composing mail, and in a few other places, in Pine you
  1161. have to use Control keys. This means pressing the Control key (usually labeled 
  1162. "Ctrl") and the
  1163. letter indicated at the same time.  Usually, this is shown with a
  1164. "^" in front of the letter.  On some systems, certain control
  1165. characters are intercepted before they get to Pine.  As a work-around,
  1166. you can press the ESCAPE key twice followed by the desired key.  For
  1167. example, if Ctrl-O (^O) does not work on your system, try typing
  1168. "ESC ESC O".
  1169. <!--chtml endif-->
  1170. <H3>Paging Up and Down</H3>
  1171. The "+" and "-" keys are used for
  1172. moving to the next or previous page.  The space bar is a synonym for
  1173. "+".  You may also use Ctrl-V to page down and Ctrl-Y to page
  1174. up as you do in the message composer.  On screens with a WhereIs (search)
  1175. command, W or Ctrl-W followed by Ctrl-V will move to the bottom of the
  1176. message or list, and W or Ctrl-W followed by Ctrl-Y will move to the top
  1177. of the message or list.
  1178.  
  1179. <H3>Return Key</H3>
  1180. The return key is usually a synonym for a frequently used
  1181. command.  When viewing a message, there is currently not a default
  1182. command, so RETURN does nothing; when in the index, it is synonymous with
  1183. "view msg". In the key menu at the bottom of the screen, whatever is
  1184. enclosed in square brackets [] is the same as the return key.
  1185.  
  1186. <H3>Control Keys Not Used By Pine</H3>
  1187. Most commands in Pine are single letters, with -- we hope -- some mnemonic 
  1188. value, but in places where Pine is expecting text input, e.g. in the composer or 
  1189. at prompts for file/folder names, control keys must be used for editing and 
  1190. navigation functions.
  1191. <P>
  1192.  
  1193. Pine has used nearly all the control keys available.  There are, however,
  1194. certain control keys that are reserved by other programs or for technical
  1195. reasons.  Pine does not use any of these keys:
  1196. <DL>
  1197.  <DT>Ctrl-S</DT> <DD>Used by Unix as "stop output"</DD>
  1198.  <DT>Ctrl-Q</DT> <DD>Used by Unix as "resume output"</DD>
  1199.  <DT>Ctrl-]</DT> <DD>Often used by Telnet as escape key</DD>
  1200.  <DT>Ctrl-\</DT> <DD>Often used by Unix as "Abort"</DD>
  1201. </DL>
  1202. <P>
  1203. Note: Ctrl-S and Ctrl-Q can be subject to 
  1204. <A HREF="h_special_xon_xoff">special handling</A>.
  1205. <P>
  1206. In addition, while the ESC key alone is not used for command input,
  1207. Pine will recognize two consecutive ESC key presses followed by a letter 
  1208. key as a substitute for control key input.  For example, the control key
  1209. <SAMP>Ctrl-X</SAMP> can alternatively be entered using the
  1210. three keystrokes: <SAMP>ESC ESC x</SAMP>.
  1211. This is useful if the communication program you are using
  1212. (e.g. Telnet) has its own, conflicting, idea of what certain control
  1213. characters mean.
  1214.  
  1215.  
  1216. <H3>Repainting the Screen</H3>
  1217. Sometimes what is displayed on the screen will be
  1218. incorrect due to noise on the phone line or other causes and you will want
  1219. to repaint the whole screen to make it correct.  You can use the Ctrl-L
  1220. command to do this.  It never hurts to do it when in doubt.
  1221.  
  1222.  
  1223. <H2><A NAME="status_line">Status Line</A></H2>
  1224.  
  1225. The top line of the screen is Pine's status line.  It will always display
  1226. the current version of Pine and will also convey information about the
  1227. status of the program.  This is where you look to find out what
  1228. collection, folder and message number is active.
  1229. <P>
  1230.  
  1231. If the top line says "READONLY" it means that the open folder
  1232. (typically your INBOX) is "locked" by another mail session --
  1233. most likely a more recent session of Pine has taken the INBOX lock.
  1234. <P>
  1235.  
  1236. If the top line says "CLOSED" it means that you are trying to
  1237. access a
  1238. folder on a remote mail server, and for some reason, communication with
  1239. the mail server has either been lost, or never successfully established.
  1240. This can be a result of trying to open a non-existent folder, or one
  1241. stored on an invalid or non-operational server, or it can mean that Pine
  1242. has been suspended for more that 30 minutes while accessing a remote mail
  1243. server.
  1244.  
  1245.  
  1246. <H2><A NAME="main_menu">Main Menu</a></h2>
  1247.  
  1248. <p>The Main Menu lists Pine's main options. The key or keys you must type to 
  1249. enter your
  1250. choice are to the left of each option or command name. You can usually type 
  1251. either
  1252. uppercase or lowercase letters, and you should not press <Return>.</p>
  1253.  
  1254. <p>From the Main Menu you can choose to read online help, write (compose) and 
  1255. send a
  1256. message, look at an index of your mail messages, open or maintain your mail 
  1257. folders, update
  1258. your address book, configure Pine, and quit Pine. There are additional options 
  1259. listed at
  1260. the bottom of the screen as well.</p>
  1261.  
  1262. <h3>Main Menu Commands</H3>
  1263. Pine main menu lists the most common Pine functions. A <a
  1264. href="h_main_menu_commands">full list of these
  1265. commands</a> and what they do is available.
  1266.  
  1267.  
  1268. <H2><A NAME="addressbooks">Address Books</a></h2>
  1269. <p>As you use email, you can build a list of your regular email correspondents 
  1270. in your Pine
  1271. Address Book. At the Pine Main Menu, press A to see the Address Book List 
  1272. screen. Your
  1273. personal address book will be highlighted. Press <Return> to view it. You can 
  1274. use the
  1275. address book to store email addresses for individuals or groups, to create 
  1276. easily
  1277. remembered "nicknames" for these addresses, and to quickly retrieve an email 
  1278. address when
  1279. you are composing a message. </p>
  1280.  
  1281. <p>There are two ways to add addresses to your address book: you can add them 
  1282. manually or take them from messages (by pressing T to access the Take command). 
  1283. With either method, you specify nicknames for your correspondents. A single 
  1284. address book entry (or nickname) can point to just one email address, or, it can
  1285. point to more than one. When it points to more than one, it is called a 
  1286. distribution list. Each distribution list has a nickname, a full name, and a 
  1287. list of addresses. These
  1288. addresses may be actual addresses, other nicknames in your address book, or 
  1289. other
  1290. distribution lists. </p>
  1291.  
  1292. <p>Additional information is available in Pine's online help:</p>
  1293. <ul>
  1294.   <li><a href="h_abook_opened">The Pine Address Book</a></li>
  1295. </ul>
  1296.  
  1297. <H2><A NAME="ldap">LDAP</a></h2>
  1298. <p>LDAP (Lightweight Directory Access Protocol) is a standard means of accessing 
  1299. an organization's shared
  1300. directories. Essentially, using LDAP, Pine is able to find email addresses in 
  1301. large address
  1302. books, rather like the White Pages provided by the phone company. As a Pine 
  1303. user, it is not
  1304. necessary to know much about how this works, only how to use it and how to 
  1305. configure
  1306. it.</p>
  1307.  
  1308. More information on configuring LDAP is available in Pine's online help:
  1309. <ul>
  1310.   <li><a href="h_direct_config">Setup LDAP Directory Servers</a></li>
  1311. </ul>
  1312.  
  1313. <p>Additional help on using LDAP in Pine is also available:</p>
  1314. <ul>
  1315.   <li><a href="h_ldap_view">LDAP Response View Explained</a></li>
  1316. </ul>
  1317.  
  1318.  
  1319. <H2><A NAME="index">Index of Messages</A></H2>
  1320.  
  1321. <p>In Pine's message index, the selected message is highlighted. The first 
  1322. column on the
  1323. left is blank, or shows a "+" if the message was sent directly to you (i.e., it 
  1324. is not a
  1325. copy or from a list). </p>
  1326.  
  1327. <p>The second column may be blank, or it may contain:</p>
  1328. <ul>
  1329.   <li>"N" if the message is new (unread), </li>
  1330.   <li>"A" if you have answered the message (using the Reply command), </li>
  1331.   <li>"D" if you have marked the message for deletion.</li>
  1332. </ul>
  1333.  
  1334. <p>
  1335. Note: If you answer a message as well as mark it deleted (in either order), 
  1336. you will only see the "D".</p>
  1337.  
  1338. <p>The rest of the columns in the message line show you the message
  1339. number, date sent, sender, size, and subject. For details, press ? (Help).  
  1340. Most of the commands you need to handle your messages are visible at the
  1341. bottom of the screen, and you can press O (OTHER CMDS) to see additional
  1342. commands that are available. You do not need to see these "other commands"
  1343. on the screen to use them. That is, you never need to press O as a prefix
  1344. for any other command. </p>
  1345.  
  1346. <p>Additional information is available in Pine's online help:</p>
  1347. <ul>
  1348.   <li><a href="h_mail_index">Message Index Commands</a></li>
  1349. </ul>
  1350.  
  1351.  
  1352. <H2><A NAME="messages">Reading Messages</A></H2>
  1353.  
  1354. <p>The message text screen shows you the text of the message along with
  1355. its header. If a message has attachments, those will be listed (but not
  1356. displayed) also.  The top bar displays information about the currently
  1357. open message, folder and collection.  You see the name of the collection
  1358. (if there is one) in angle brackets, then the name of the folder, then the
  1359. message number and finally the position within the current message (in
  1360. percent). If the message is marked for deletion "DEL" will appear in the
  1361. upper right as well. </p>
  1362.  
  1363. <p>As with every Pine screen, the bottom two lines show you the commands 
  1364. available.</p>
  1365.  
  1366. <p>Additional information is available in Pine's online help:</p>
  1367. <ul>
  1368.   <li><a href="h_mail_view">Message Text Screen</a></li>
  1369.   <li><a href="h_attachment_screen">Attachment Index Screen Explained</a></li>
  1370.   <li><a href="h_mail_text_add_view">Attachment View Screen Explained</a></li>
  1371. </ul>
  1372.  
  1373.  
  1374. <H2><A NAME="compose">Composing Messages</A></H2>
  1375.  
  1376. <p>To write a message, press C (Compose). You see the Compose Message
  1377. screen, which is divided into two parts: the header area and the message
  1378. text area. The header area is where information on the recipient (the To:
  1379. field) and the subject line go, while the message text area contains the
  1380. actual text of the email message. Different commands are available to you
  1381. when your cursor is in different areas on this screen. To see additional
  1382. help on commands in either the message text or header area, type
  1383. <Control>G (Get help).</p>
  1384.  
  1385. <p>To move around, use the arrow keys or Ctrl-N (Next line) and Ctrl-P 
  1386. (Previous line); to correct typing errors, use <Backspace> or <Delete>. </p>
  1387.  
  1388. <p>The following information from Pine's online help should prove useful:</p>
  1389.  
  1390. <ul>
  1391.   <li><a href="h_composer_to">Message Header Commands</a></li>
  1392.   <li><a href="h_compose_richhdr">Rich Header Command</a></li>
  1393.   <li><a href="h_composer">Composer Commands</a></li>
  1394.   <li><a href="h_edit_nav_commands">Composer Editing Commands</a></li>
  1395.   <li><a href="h_compose_send">Send Command</a></li>
  1396.   <li><a href="h_compose_spell">Spell Check Command</a></li>
  1397. </ul>
  1398.  
  1399.  
  1400. <H2><A NAME="collection">Collection List</A></H2>
  1401. <p>Collection lists are Pine's way of organizing groups of folders. Each
  1402. "collection" can reside on a different server, for example, and contain a
  1403. different group of mail folders.<p>
  1404.  
  1405. <p>For more information on this, see:</p>
  1406. <ul>
  1407.   <li><a href="h_what_are_collections">Folder Collections Explained</a></li>
  1408. </ul>
  1409. <p>Additional information relating to collection lists is also available in 
  1410. Pine's online
  1411. help:</p>
  1412. <ul>
  1413.   <li><a href="h_collection_maint">Setup Collection List Screen</a></li>
  1414.   <li><a href="h_collection_screen">Collection List Screen</a></li>
  1415. </ul>
  1416.  
  1417.  
  1418. <H2><A NAME="folder">Folders</A></H2>
  1419.  
  1420. <p>Messages can quickly accumulate in your INBOX folder. If you use email
  1421. often, you soon could have hundreds. You need to delete messages you do
  1422. not want, and you can use folders to organize messages you wish to save. A
  1423. folder is a collection of one or more messages that are stored (just like
  1424. the messages in your INBOX) so you can access and manage them.</p>
  1425.  
  1426. <p>You can organize your email messages into different folders by topic,
  1427. correspondent, date, or any other category that is meaningful to you. You
  1428. can create your own folders, and Pine automatically provides three: </p>
  1429. <ul>
  1430.  
  1431.   <li>The INBOX folder: messages sent to you are listed in this folder.
  1432.       When you first start Pine and go to the Message Index screen, you are
  1433. looking at the list of messages in your INBOX folder. Every incoming
  1434. message remains in your INBOX until you delete it or save it in another
  1435. folder. </li>
  1436.   <li>The sent-mail folder: copies of messages you send are stored in this 
  1437. folder. This is
  1438. convenient if you cannot remember whether you actually sent a message and want 
  1439. to check, or
  1440. if you want to send a message again.</li>
  1441.   <li>The saved-messages folder: copies of messages you save are stored in this 
  1442. folder
  1443. unless you choose to save them to other folders you create yourself.</li>
  1444. </ul>
  1445.  
  1446. <p>More information about folders is available in Pine's online help:</p>
  1447. <ul>
  1448.   <li><a href="h_folder_open">Explanation of Folder Selection</a></li>
  1449.   <li><a href="h_folder_maint">Help for Folder List</a></li>
  1450.   <li><a href="h_common_folders">Folder List Commands</a></li>
  1451.   <li><a href="h_valid_folder_names">Explanation of Valid Folder Names</a></li>
  1452.   <li><a href="h_folder_fcc">Folder Select for Fcc ("sent-mail") 
  1453. Explained</a></li>
  1454.   <li><a href="h_folder_save">Folder Select for Save Explained</a></li>
  1455. </ul>
  1456.  
  1457.  
  1458. <H2><A NAME="color">Color</A></H2>
  1459. <P>
  1460. If the terminal emulator you are using is capable of displaying color or if
  1461. you are using PC-Pine, then it is possible to set up Pine so that various
  1462. parts of the display will be shown in colors you configure. This is done
  1463. using the Setup Color screen, available from the Main Menu by selecting
  1464. the Setup command followed by "K" for Kolor.
  1465.  
  1466. <P>
  1467. For example, you may color things like the titlebar, the current item,
  1468. the keymenu, and the status messages.
  1469. You may also color lines in the index, and headers and quoted text in the
  1470. MESSAGE VIEW screen.
  1471. You use the Color Setup screen for configuring most of this, but you must
  1472. use the IndexColor setup for coloring index lines.
  1473. That is available from the Main Menu under Setup/Rules/IndexColor.
  1474.  
  1475. <P>
  1476. The following entries in Pine's online help provide additional information 
  1477. about how to use color:
  1478. <UL>
  1479.   <LI> <A HREF="h_color_setup">Color Setup screen</A>
  1480.   <LI> <A HREF="h_rules_incols">Index Line Color</A>
  1481.   <LI> <A HREF="h_config_quote_color">quoted text</A> in message view
  1482.   <LI> <A HREF="h_config_customhdr_pattern">text associated with user-defined headers</A> in message view
  1483. </UL>
  1484.  
  1485. <H2><A NAME="roles">Roles</A></H2>
  1486. <p>You may play different roles depending on who you are replying to. For
  1487. example, if you are replying to a message addressed to help-desk you may
  1488. be acting as a Help Desk Worker. That role may require that you use a
  1489. different return address and/or a different signature.</p>
  1490.  
  1491. <p>The following entries in Pine's online help provide additional information 
  1492. about how to
  1493. use roles:</p>
  1494. <ul>
  1495.   <li><a href="h_rules_roles">Setup Roles Screen</a></li>
  1496.   <li><a href="h_role_select">Roles Screen</a></li>
  1497. </ul>
  1498.  
  1499. <H2><A NAME="filtering">Filtering</A></H2>
  1500. <P>
  1501. The software which actually delivers mail (the stuff that happens
  1502. before Pine is involved) for you is in a better position to do mail filtering
  1503. than Pine itself.
  1504. If possible, you may want to look into using that sort of mail filtering to
  1505. deliver mail to different folders, delete it, or forward it.
  1506. However, if you'd like Pine to help with this, Pine's filtering is for you.
  1507.  
  1508. <P>
  1509. Filtering is a way to automatically move certain messages from one folder
  1510. to another or to automatically delete messages.
  1511. Pine doesn't have the ability to forward mail to another address.
  1512.  
  1513. <P>
  1514. The following entries in Pine's online help provide additional information 
  1515. about how to use filtering:
  1516. <UL>
  1517.   <LI> <A HREF="h_rules_filter">Filtering Setup screen</A>
  1518. </UL>
  1519.  
  1520. <H2><A NAME="patterns">Patterns</A></H2>
  1521. <P>
  1522. Patterns are used with Roles, Filtering, Index Coloring,
  1523. and Scoring so it may help you to understand exactly how Patterns work.
  1524. The following entries in Pine's online help provide information 
  1525. about using Patterns:
  1526. <UL>
  1527.   <LI> <A HREF="h_rule_patterns">Patterns</A>
  1528. </UL>
  1529.  
  1530.  
  1531. <H2><A NAME="cmd_line">Command Line Options</A></H2>
  1532.  
  1533. Pine accepts a number of command line arguments, allowing you, for
  1534. example, to start Pine and immediately access a particular folder. A <a
  1535. href="h_command_line_options">full list</a> is available.
  1536.  
  1537. <H2><A NAME="pine_conf">Pine Configuration</A></H2>
  1538.  
  1539. Unless it has been administratively disabled, the Setup command on the
  1540. MAIN MENU has a "Config" subcommand which will allow you to modify
  1541. Pine's behavior by setting or unsetting various features, defining folder
  1542. collections, etc.  These settings are stored in your personal
  1543. "pinerc" configuration file, but on shared systems these settings
  1544. may be over-ridden by a system-wide control file (due to local site
  1545. security or support policies).  A global pine configuration file can also
  1546. be used to set default values for all Pine users on a particular system.
  1547.  
  1548. <H2><A NAME="read_news">Reading News</A></H2>
  1549.  
  1550. <H3>Background</h3>
  1551. Pine can read and post to Internet (or USENET) newsgroups, using the same 
  1552. commands as for mail. Similar to mailing lists but existing on a larger scale, 
  1553. Usenet newsgroups allow groups of people with common interests to discuss 
  1554. particular topics. You might find newsgroups related to your career, or you 
  1555. might wish to check out the online discussion among the fans of your favorite 
  1556. television show. 
  1557.  
  1558. <h3>Configuring Pine for Reading News</h3> Pine often arrives
  1559. pre-configured by your system administrator to automatically access the
  1560. newsgroups offered by your organization, Internet Service Provider, or
  1561. school. PC-Pine users, and those attempting to customize Unix Pine, will
  1562. need additional details on <a href="h_configuring_news">how to
  1563. configure Pine to read news</a>.
  1564.  
  1565. <h3>Accessing Newsgroups</h3>
  1566. The first step in reading news is to access the newsgroups collections
  1567. screen from Pine. If everything is configured properly, you should be able
  1568. to do this by first typing L (folder List), then selecting the folder
  1569. collection listed as "News." The actual name of this collection may differ
  1570. from system to system.
  1571.  
  1572. <h3>Subscribing to Newsgroups</h3>
  1573.  
  1574. Once you have accessed the news collection, you need to subscribe to a
  1575. newsgroup that interests you. Subscribing to a newsgroup means that Pine
  1576. will keep a record of the newsgroups in which you are interested and which
  1577. articles in those newsgroups have been read.
  1578.  
  1579. <h3>Using Newsgroups</h3> 
  1580. Pine uses the similar commands to read news as to read mail. For example,
  1581. the D command marks messages as Deleted (or "Dismissed," if you prefer),
  1582. and the R command Replies to a news posting. Basically, Pine allows you to
  1583. read news as if it were mail, so you don't need to change the way you
  1584. interact with Pine.
  1585. <p>
  1586. There is also additional Pine help available on 
  1587. <A HREF="h_reading_news">how to use Pine to read news</A>.
  1588.  
  1589. <H2><A NAME="probs">Reporting Problems</A></H2>
  1590.  
  1591. There are now literally millions of Pine users in over 50 countries.
  1592. The Pine development team has no funding to provide support to anyone
  1593. outside of the University of Washington.  However, we certainly want Pine
  1594. to be the best tool it can be, so we do want to know about problems. We
  1595. ask that you first read the relevant help screens and then seek
  1596. assistance from your own local support staff.  Once you are sure that your
  1597. difficulty is not a local configuration problem, you might look at the
  1598. help section explaining where to look for
  1599. <A HREF="h_finding_help">more information</A> and where to 
  1600. get assistance.
  1601. <P>
  1602.  
  1603. Please note: Pine has been adapted to several other operating systems
  1604. besides those directly supported by the University of Washington; see:
  1605. <P>
  1606. <CENTER><A HREF="http://www.washington.edu/pine/overview/non-UW.html">http://www.washington.edu/pine/overview/non-UW.html</A></CENTER>
  1607.  
  1608. <P>
  1609. Inquiries about these other ports (e.g., VMS and AmigaDOS) should be
  1610. directed to the individual or group that did the adaptation. 
  1611. <P>
  1612.  
  1613. <ADDRESS>
  1614.    Pine Development Team <pine@cac.washington.edu><BR>
  1615.    Computing & Communications<BR>
  1616.    University of Washington<BR>
  1617.    Seattle, WA 98195<BR>
  1618. </ADDRESS>
  1619.  
  1620. <P>
  1621. <End of help on this topic>
  1622. </BODY>
  1623. </HTML>
  1624. ===== h_main_menu_commands ======
  1625. <HTML>
  1626. <HEAD>
  1627. <TITLE>MAIN MENU COMMANDS</TITLE>
  1628. </HEAD>
  1629. <BODY>
  1630. <H1>MAIN MENU COMMANDS</H1>
  1631.  
  1632. <!--chtml if pinemode="function_key"-->
  1633.  Available Commands --
  1634.  Group 1           Available Commands -- Group 2<BR>
  1635.  ------------------------------
  1636.           --------------------
  1637. ----------<BR>
  1638.  F1  Show this help text                 F1  Show this help text<BR>
  1639.  F2  Show all other available commands   F2  Show other commands<BR>
  1640.  F3  Quit Pine<BR>
  1641.  F4  Execute current MAIN MENU command   F4  <A 
  1642. HREF="h_common_compose">Compose</A> a message<BR>
  1643.  F5  Select previous command up on menu  F5  <A 
  1644. HREF="h_common_folders">FOLDER LIST</A> screen<BR>
  1645.  F6  Select next command down on menu    F6  <A 
  1646. HREF="h_common_goto">Goto</A> a specified folder<BR>
  1647.                                         
  1648.  F7  <A 
  1649. HREF="h_common_index">MESSAGE INDEX</A> screen<BR>
  1650.                                         
  1651.  F8  <A 
  1652. HREF="h_main_journal">Journal</A> of status messages<BR>
  1653.  F9  Display <A 
  1654. HREF="h_main_release_notes">Release Notes</A> notes          F9  <A 
  1655. HREF="h_main_setup">SETUP</A> menus<BR>
  1656.  F10 <A 
  1657. HREF="h_main_kblock">Lock Keyboard</A>                       F10 <A 
  1658. HREF="h_main_addrbook">ADDRESS BOOK</A> screen<BR>
  1659.                                         
  1660.  F11 <A 
  1661. HREF="h_common_role">Compose message using a role</a><BR>
  1662. <!--chtml else-->
  1663.  General Pine Commands           Main Menu Screen Commands<BR>
  1664.  ---------------------
  1665.            --------------
  1666. -----------<BR>
  1667.  ?  Show Help Text               O  Show all Other available commands<BR>
  1668.  C  <A 
  1669. HREF="h_common_compose">Compose</A> a message            P  Select Previous
  1670.  command up on menu<BR>
  1671.  I  <A 
  1672. HREF="h_common_index">MESSAGE INDEX</A> screen    
  1673.      N  Select Next command do
  1674. wn on menu<BR>
  1675.  L  <A 
  1676. HREF="h_common_folders">FOLDER LIST</A> screen    
  1677.        R  Display Pine <A 
  1678. HREF="h_main_release_notes">Release Notes</A><BR>
  1679.  A  <A 
  1680. HREF="h_main_addrbook">ADDRESS BOOK</A> screen    
  1681.       K  <A 
  1682. HREF="h_main_kblock">Lock Keyboard</A><BR>
  1683.  S  <A 
  1684. HREF="h_main_setup">SETUP</A> functions      
  1685.         G  <A 
  1686. HREF="h_common_goto">Goto</A> a specified folder<BR>
  1687.  Q  Quit Pine                    J 
  1688.  <A HREF="h_main_journal">Journal</A> of status messages<BR>
  1689.                                  #  <A 
  1690. HREF="h_common_role">Compose message using a role</a><BR>
  1691. <!--chtml endif-->
  1692.  
  1693. <P>
  1694. NOTE:
  1695. <OL>
  1696.  <LI>For help on a particular command, hilite the bold text associated
  1697. with it above and hit Return.
  1698.  <LI> The availability of certain commands (e.g. some of the options under
  1699. SETUP) is determined by Pine configuration files and system capabilities.
  1700. At some sites, certain commands may not be available due to security or
  1701. support concerns.
  1702. </OL>
  1703. <P>
  1704. <End of help on this topic>
  1705. </BODY>
  1706. </HTML>
  1707.  
  1708. ===== h_command_line_options ======
  1709. <HTML>
  1710. <HEAD>
  1711. <TITLE>COMMAND LINE OPTIONS</TITLE>
  1712. </HEAD>
  1713. <BODY>
  1714. <H1>COMMAND LINE OPTIONS</H1>
  1715. Possible starting arguments for Pine:
  1716. <DL>
  1717.  
  1718. <DT><I>addrs...</I></DT>
  1719. <DD>Go directly into composer sending to given address
  1720. Standard input redirection is allowed with addresses.
  1721. </DD>
  1722.  
  1723. <DT>-attach <I>file</I></DT>
  1724. <DD>
  1725. Go directly into composer with given file
  1726. </DD>
  1727.  
  1728. <DT>-attachlist <I>file-list</I></DT>
  1729. <DT>-attach_and_delete <I>file</I></DT>
  1730. <DD>
  1731. Go to composer, attach file, delete when finished<BR>
  1732. Note: Attach options can't be used it -f, -F, or -url
  1733. added to Attachment list.  Attachlist must be the last
  1734. option on the command line
  1735. </DD>
  1736.  
  1737. <DT>-bail</DT>
  1738. <DD>
  1739. Exit if pinerc file doesn't already exist
  1740. </DD>
  1741.  
  1742. <DT>-f <I>folder</I></DT>
  1743. <DD>
  1744. Folder - give folder name to open
  1745. </DD>
  1746.  
  1747. <DT>-c <I>number</I></DT>
  1748. <DD>
  1749. Context - which context to apply to -f arg
  1750. </DD>
  1751.  
  1752. <DT>-F <I>file</I></DT>
  1753. <DD>
  1754. File - give file name to open and page through
  1755. </DD>
  1756.  
  1757. <DT>-h</DT>
  1758. <DD>
  1759. Help - give this list of options
  1760. </DD>
  1761.  
  1762. <DT>-k</DT>
  1763. <DD>
  1764. Keys - Force use of function keys
  1765. </DD>
  1766.  
  1767. <DT>-z</DT>
  1768. <DD>
  1769. Suspend - allow use of ^Z suspension
  1770. </DD>
  1771.  
  1772. <DT>-r</DT>
  1773. <DD>
  1774. Restricted - can only send mail to oneself
  1775. </DD>
  1776.  
  1777. <DT>-sort <I>sort</I></DT>
  1778. <DD>
  1779. Sort - Set initial <I>sort</I> order to:
  1780. subject, arrival, date, from, size, /reverse
  1781. </DD>
  1782.  
  1783. <DT>-i</DT>
  1784. <DD>
  1785. Index - Go directly to index, bypassing main menu
  1786. </DD>
  1787.  
  1788. <DT>-I <I>keystroke_list</I></DT>
  1789. <DD>
  1790. Initial keystrokes to be executed
  1791. </DD>
  1792.  
  1793. <DT>-n <I>number</I></DT>
  1794. <DD>
  1795. Entry in index to begin on
  1796. </DD>
  1797.  
  1798. <DT>-o</DT>
  1799. <DD>
  1800. ReadOnly - Open first folder read-only
  1801. </DD>
  1802.  
  1803. <DT>-conf</DD>
  1804. <DD>
  1805. Configuration - Print out fresh global configuration
  1806. </DD>
  1807.  
  1808. <DT>-pinerc <I>file</I></DT>
  1809. <DD>
  1810. Configuration - Put fresh pinerc configuration in <I>file</I>
  1811. </DD>
  1812.  
  1813. <DT>-p <I>pinerc</I></DT>
  1814. <DD>
  1815. Use alternate .pinerc file
  1816. </DD>
  1817.  
  1818. <DT>-P <I>pine.conf</I></DT>
  1819. <DD>
  1820. Use pine.conf file for default settings
  1821. </DD>
  1822.  
  1823. <DT>-url <I>url</I></DT>
  1824. <DD>
  1825. Open the given URL<BR>
  1826. Note: Can't be used with -f, -F, or -attach
  1827. </DD>
  1828.  
  1829. <DT>-create_lu <I>abook_file</I> <I>ab_sort_type</I></DT>
  1830. <DD>
  1831. create .lu file from script
  1832. </DD>
  1833.  
  1834. <DT>-nr</DT>
  1835. <DD>
  1836. Special mode for UWIN*
  1837. </DD>
  1838.  
  1839. <DT>-a</DT>
  1840. <DD>
  1841. Special anonymous mode for UWIN*
  1842. </DD>
  1843.  
  1844. <!--chtml if pinemode="os_windows"-->
  1845. <DT>-registry <I>cmd</I></DT>
  1846. <DD>
  1847. Where cmd is set,clear,dump
  1848. </DD>
  1849. <!--chtml endif-->
  1850. <DT>-<I>option</I>=<I>value</I></DT>
  1851. <DD>
  1852. Assign <I>value</I> to the pinerc option <I>option</I><BR>
  1853.                  e.g. -signature-file=sig1<BR>
  1854.                  (Note: feature-list is additive)
  1855. </DD>
  1856. </DL>
  1857.  
  1858. When compiled with debugging enabled, these commands are also available:
  1859.  
  1860. <DL>
  1861. <DT>-d <I>n</I></DT>
  1862. <DD>
  1863. Set debug level to <I>n</I>
  1864. </DD>
  1865.  
  1866. <DT>-d <I>keywords...</I></DT>
  1867. <DD>
  1868. where <I>keywords</I> can be: flush, timestamp, imap=0..4, numfiles=0..31, or verbose=0..9<BR>
  1869. Note: two or more can be specified if separated by commas (but no spaces).
  1870. </DD>
  1871. </DL>
  1872.  
  1873.  
  1874. <BR>
  1875. <BR>
  1876. <BR>
  1877. <PRE>
  1878.     * UWIN = University of Washington Information Navigator
  1879. </PRE>
  1880.  
  1881. <P>
  1882. <End of help on this topic>
  1883. </BODY>
  1884. </HTML>
  1885. ===== h_configuring_news ======
  1886. <HTML>
  1887. <HEAD>
  1888. <TITLE>CONFIGURING NEWS</TITLE>
  1889. </HEAD>
  1890. <BODY>
  1891. <H1>CONFIGURING NEWS</H1>
  1892. Pine can access news folders in any one of three different ways:
  1893. <DL>
  1894. <DT>REMOTE NNTP</DT>
  1895. <DD>Using the Network News Transport Protocol (NNTP) to
  1896. access news on a remote news server.  In this case the newsrc file is
  1897. stored on the machine where Pine is running.
  1898.  
  1899. <P>
  1900. To specify a remote news-collection accessed via NNTP use the
  1901. SETUP/collectionList screen's "Add" command.  Set the
  1902. Server: value to the NNTP server's hostname appended with the
  1903. communication method "/service=NNTP", and set the Path:
  1904. value to the "#news." namespace (without the quotes).  See
  1905. the "<A HREF="h_composer_cntxt_server">Server:</A>" field's
  1906. help text for a more complete explanation of access method, and the
  1907. "<A HREF="h_composer_cntxt_path">Path:</A>" field's help
  1908. text for a more complete explanation of "namespace".
  1909.  
  1910. <DT>REMOTE IMAP</DT>
  1911. <DD>Using the Internet Message Access Protocol (IMAP) to
  1912. access news on a remote news server.  In this case, your newsrc file is
  1913. stored on the news server, in your home directory, so you must have an
  1914. account on the news server, but you would be running Pine on a different
  1915. machine.  The news server must be running an IMAPd server process. 
  1916.  
  1917. <P>
  1918. To specify a remote news-collection accessed via IMAP use the
  1919. SETUP/collectionList screen's "Add" command.  Set the
  1920. Server: value to the IMAP server's hostname, and set the Path: value
  1921. to the "#news." namespace (without the quotes).  See the
  1922. "<A HREF="h_composer_cntxt_path">Path:</A>" field's help
  1923. text for a more complete explanation of "namespace".
  1924.  
  1925. </DD>
  1926.  
  1927. <DT>LOCAL</DT>
  1928. <DD>Using local file access to the news database.  In this
  1929. case, your newsrc file is stored on the news server, in your home
  1930. directory, so you must have an account on the news server, and you would
  1931. be running Pine on the same machine.
  1932.  
  1933. <P>
  1934. To specify a local news-collection use the SETUP/collectionList
  1935. screen's "Add" command.  Leave the Server: value blank, and
  1936. set the Path: value to the "#news." namespace (without the
  1937. quotes).  See the "<A HREF="h_composer_cntxt_path">Path:</A>"
  1938. field's help text for a more complete explanation of "namespace".
  1939.  
  1940. </DD>
  1941. </DL>
  1942.  
  1943. <P>
  1944.  
  1945. NOTE: Should no news-collection be defined as above, Pine will
  1946. automatically create one using the Setup/Config screen's
  1947. "nntp-server" variable's value if defined.  The collection
  1948. will be created as a "Remote NNTP" as described above.
  1949.  
  1950. <P>
  1951.  
  1952. If you are a PC-Pine user, either option 1 (NNTP) or option 2 (IMAP) is
  1953. possible.  If you don't have an account on the news server, or if the news
  1954. server is not running an IMAP daemon, then you must use NNTP.  (If you are not
  1955. sure, ask your service provider, university, or company for help.)  In
  1956. this case, your Unix .newsrc file can be transferred to your PC.  A good
  1957. place to put it would be in the same directory as your PINERC file, under
  1958. the name \NEWSRC, but you can 
  1959. <A HREF="h_config_newsrc_path">specify a different location</A>
  1960. via Pine's Setup/Config screen.
  1961.  
  1962. <P>
  1963. A future version of PC-Pine will be able to access and update a .newsrc
  1964. file stored on a Unix host, so that it will be possible to alternate
  1965. between PC-Pine and Unix-based newsreaders.
  1966.  
  1967. <P>
  1968. <End of help on this topic>
  1969. </BODY>
  1970. </HTML>
  1971.  
  1972. ===== h_reading_news ======
  1973. <HTML>
  1974. <HEAD>
  1975. <TITLE>READING NEWS</TITLE>
  1976. </HEAD>
  1977. <BODY>
  1978. <H1>READING NEWS</H1>
  1979.  
  1980. Pine uses the almost same commands for manipulating news folders as for
  1981. mail folders.  This means, for example, that when you are done with a
  1982. message, you would use "D" to mark it as Deleted (or Dismissed,
  1983. if you prefer.)  This "mail-like" behavior differs from that of
  1984. most newsreaders, wherein a message is implicitly dismissed after you have
  1985. looked at it once. We strongly believe that Pine should offer as much
  1986. consistency as possible between mail and news, so the mail paradigm --
  1987. wherein a message does not magically disappear without explicit action by
  1988. the user -- is used for news as well. <P>
  1989.  
  1990. If you answer a message in a news folder, the index view will show the
  1991. "A" flag as usual; but the industry standard file Pine uses to
  1992. keep track of what news as been read has no way of storing this flag, so
  1993. it will not be preserved across sessions.  The Deleted flag is the only
  1994. one that is preserved when you leave and the return to a newsgroup.  As an
  1995. additional note on replies, when you Reply to a newsgroup message and say
  1996. you want to reply to all recipients, Pine will ask if you want to post the
  1997. message to all the newsgroups listed in the original message. <P>
  1998.  
  1999. If you would like Pine to mark more-or-less recent news messages as
  2000. "New", then set the
  2001. <A HREF="h_config_news_uses_recent">"news-approximates-new-status"</A>
  2002. feature.  This will cause messages after the last one you have marked as
  2003. Deleted to appear with "N" status in the MESSAGE INDEX.  The
  2004. "N" status often makes it easier to distinguish later news
  2005. articles from those you've previously seen, but not yet disposed of via
  2006. the "D" key.  Note that this is an approximation, not an exact
  2007. record of which messages you have not seen.
  2008. <P>
  2009.  
  2010. A frequent operation in news-reading is "catching up" -- that
  2011. is, getting rid of all the messages in the newsgroup so that you can
  2012. "start fresh."  The easiest way to do this in Pine is via the
  2013. Select command.  You would enter the following four keystrokes:
  2014. <tt>;aad</tt> to select all messaged, and then apply the delete (or
  2015. dismiss) command to all of them. Note that the <A
  2016. HREF="h_config_enable_agg_ops">"enable-aggregate-command-set"</A>
  2017. feature must be enabled before you can use the Select command.
  2018.  
  2019. <P>
  2020. <End of help on this topic>
  2021. </BODY>
  2022. </HTML>
  2023.  
  2024. ====== h_help_index ======
  2025. <HTML>
  2026. <HEAD>
  2027. <TITLE>Help Index</TITLE>
  2028. </HEAD>
  2029. <BODY>
  2030. <H1>Help Index</H1>
  2031. <ul>
  2032. <li><a href="h_abook_top">ADDRESS BOOK LIST COMMANDS</a>
  2033. <li><a href="h_main_addrbook">Address Book Command</a>
  2034. <li><a href="h_abook_view">Address Book View Explained</a>
  2035. <li><a href="h_abook_select_listmode">Address Listmode Selection from Composer Explained</a>
  2036. <li><a href="h_abook_select_checks">Address Selection from Composer Explained</a>
  2037. <li><a href="h_composer_abook_comment">Addressbook Comment Explained</a>
  2038. <li><a href="h_composer_abook_fcc">Addressbook Fcc Explained</a>
  2039. <li><a href="h_composer_abook_add_folder">Addressbook Folder Name Field Explained</a>
  2040. <li><a href="h_composer_abook_full">Addressbook Fullname Explained</a>
  2041. <li><a href="h_composer_abook_add_nick">Addressbook NickName Field Explained</a>
  2042. <li><a href="h_composer_abook_nick">Addressbook Nickname Explained</a>
  2043. <li><a href="h_abook_select_addr">Addressbook Selection Explained</a>
  2044. <li><a href="h_abook_select_top">Addressbook Selection Navigation Explained</a>
  2045. <li><a href="h_composer_abook_add_server">Addressbook Server Name Field Explained</a>
  2046. <li><a href="h_compose_alted">Alt Editor Command</a>
  2047. <li><a href="h_index_cmd_apply">Apply Command</a>
  2048. <li><a href="h_attachment_screen">Attachment Index Screen Explained</a>
  2049. <li><a href="h_mail_text_att_view">Attachment View Screen Explained</a>
  2050. <li><a href="h_composer_browse">BROWSER</a>
  2051. <li><a href="h_common_bounce">Bounce Command</a>
  2052. <li><a href="h_collection_screen">COLLECTION LIST screen</a>
  2053. <li><a href="h_composer_ctrl_j">COMPOSER ATTACH</a>
  2054. <li><a href="h_composer">COMPOSER COMMANDS</a>
  2055. <li><a href="h_composer_custom_addr">CUSTOMIZED HEADER FIELD</a>
  2056. <li><a href="h_composer_custom_free">CUSTOMIZED HEADER FIELD</a>
  2057. <li><a href="h_compose_cancel">Cancel Command</a>
  2058. <li><a href="h_composer_cntxt_nick">Collection Nickname Explained</a>
  2059. <li><a href="h_composer_cntxt_path">Collection Path: Explained</a>
  2060. <li><a href="h_composer_cntxt_server">Collection Server: Explained</a>
  2061. <li><a href="h_composer_cntxt_view">Collection View: Explained</a>
  2062. <li><a href="h_common_compose">Compose Command</a>
  2063. <li><a href="h_edit_nav_cmds">Composer Editing Commands Explained</a>
  2064. <li><a href="h_common_conditional_cmds">Conditional Commands</a>
  2065. <li><a href="h_reply_token_conditionals">Conditional Inclusion of Text for Reply-Leadin, Signatures, and Templates</a>
  2066. <li><a href="h_common_delete">Delete and Undelete Commands</a>
  2067. <li><a href="h_composer_qserv_cn">Directory Query Form Explained</a>
  2068. <li><a href="h_special_list_commands">Email List Commands Explained</a>
  2069. <li><a href="h_composer_search">Explanation of Composer Whereis Command </a>
  2070. <li><a href="h_folder_open">Explanation of Folder Selection</a>
  2071. <li><a href="h_special_xon_xoff">Explanation of Pine's XOFF/XON Handling</a>
  2072. <li><a href="h_valid_folder_names">Explanation of Valid Folder Names</a>
  2073. <li><a href="h_index_cmd_expunge">Expunge/Exclude Command</a>
  2074. <li><a href="h_info_on_locking">FAQs on Pine Locking</a>
  2075. <li><a href="h_config_change_from">FEATURE: allow-changing-from</a>
  2076. <li><a href="h_config_auto_read_msgs">FEATURE: auto-move-read-msgs</a>
  2077. <li><a href="h_config_auto_open_unread">FEATURE: auto-open-next-unread</a>
  2078. <li><a href="h_config_combined_abook_display">FEATURE: combined-addrbook-display</a>
  2079. <li><a href="h_config_combined_folder_display">FEATURE: combined-folder-display</a>
  2080. <li><a href="h_config_combined_subdir_display">FEATURE: combined-subdirectory-display</a>
  2081. <li><a href="h_config_compose_rejects_unqual">FEATURE: compose-rejects-unqualified-addrs</a>
  2082. <li><a href="h_config_send_filter_dflt">FEATURE: compose-send-offers-first-filter</a>
  2083. <li><a href="h_config_confirm_role">FEATURE: confirm-role-even-for-default</a>
  2084. <li><a href="h_config_8bit_smtp">FEATURE: enable-8bit-to-smtp-server</a>
  2085. <li><a href="h_config_enable_agg_ops">FEATURE: enable-aggregate-command-set</a>
  2086. <li><a href="h_config_enable_alt_ed">FEATURE: enable-alternate-editor-cmd</a>
  2087. <li><a href="h_config_alt_ed_now">FEATURE: enable-alternate-editor-implicitly</a>
  2088. <li><a href="h_config_arrow_nav">FEATURE: enable-arrow-navigation</a>
  2089. <li><a href="h_config_relaxed_arrow_nav">FEATURE: enable-arrow-navigation-relaxed</a>
  2090. <li><a href="h_config_enable_color">FEATURE: enable-color</a>
  2091. <li><a href="h_config_cruise_mode">FEATURE: enable-cruise-mode</a>
  2092. <li><a href="h_config_cruise_mode_delete">FEATURE: enable-cruise-mode-delete</a>
  2093. <li><a href="h_config_fast_recent">FEATURE: enable-fast-recent-test</a>
  2094. <li><a href="h_config_enable_full_hdr">FEATURE: enable-full-header-cmd</a>
  2095. <li><a href="h_config_enable_incoming">FEATURE: enable-incoming-folders</a>
  2096. <li><a href="h_config_lame_list_mode">FEATURE: enable-lame-list-mode</a>
  2097. <li><a href="h_config_enable_view_addresses">FEATURE: enable-msg-view-addresses</a>
  2098. <li><a href="h_config_enable_view_url">FEATURE: enable-msg-view-urls</a>
  2099. <li><a href="h_config_enable_view_web_host">FEATURE: enable-msg-view-web-hostnames</a>
  2100. <li><a href="h_config_prefix_editing">FEATURE: enable-reply-indent-string-editing</a>
  2101. <li><a href="h_config_sigdashes">FEATURE: enable-sigdashes</a>
  2102. <!--chtml if pinemode="os_windows"-->
  2103. <li><a href="h_config_tray-icon">FEATURE: enable-tray-icon</a>
  2104. <!--chtml endif-->
  2105. <li><a href="h_config_can_suspend">FEATURE: enable-suspend</a>
  2106. <li><a href="h_config_enable_pipe">FEATURE: enable-unix-pipe-cmd</a>
  2107. <li><a href="h_config_verbose_post">FEATURE: enable-verbose-smtp-posting</a>
  2108. <li><a href="h_config_expanded_addrbooks">FEATURE: expanded-view-of-addressbooks</a>
  2109. <li><a href="h_config_expanded_folders">FEATURE: expanded-view-of-folders</a>
  2110. <li><a href="h_config_auto_expunge">FEATURE: expunge-without-confirm</a>
  2111. <li><a href="h_config_full_auto_expunge">FEATURE: expunge-without-confirm-everywhere</a>
  2112. <li><a href="h_config_auto_fcc_only">FEATURE: fcc-only-without-confirm</a>
  2113. <li><a href="h_config_no_fcc_attach">FEATURE: fcc-without-attachments</a>
  2114. <li><a href="h_config_add_ldap">FEATURE: ldap-result-to-addrbook-add</a>
  2115. <li><a href="h_config_news_cross_deletes">FEATURE: news-deletes-across-groups</a>
  2116. <li><a href="h_config_read_in_newsrc_order">FEATURE: news-read-in-newsrc-order</a>
  2117. <li><a href="h_config_quell_dead_letter">FEATURE: quell-dead-letter-on-cancel</a>
  2118. <li><a href="h_config_quell_empty_dirs">FEATURE: quell-empty-directories</a>
  2119. <li><a href="h_config_quell_folder_internal_msg">FEATURE: quell-folder-internal-msg</a>
  2120. <li><a href="h_config_quell_lock_failure_warnings">FEATURE: quell-lock-failure-warnings</a>
  2121. <li><a href="h_config_no_part_fetch">FEATURE: quell-partial-fetching</a>
  2122. <li><a href="h_config_quell_beeps">FEATURE: quell-status-message-beeping</a>
  2123. <li><a href="h_config_quell_local_lookup">FEATURE: quell-user-lookup-in-passwd-file</a>
  2124. <li><a href="h_config_separate_fold_dir_view">FEATURE: separate-folder-and-directory-display</a>
  2125. <li><a href="h_config_textplain_int">FEATURE: show-plain-text-internally</a>
  2126. <li><a href="h_config_select_in_bold">FEATURE: show-selected-in-boldface</a>
  2127. <li><a href="h_config_strip_sigdashes">FEATURE: strip-from-sigdashes-on-reply</a>
  2128. <li><a href="h_config_tcap_wins">FEATURE: termdef-takes-precedence</a>
  2129. <li><a href="h_config_alt_auth">FEATURE: try-alternative-authentication-driver-first</a>
  2130. <li><a href="h_config_use_current_dir">FEATURE: use-current-dir</a>
  2131. <li><a href="h_config_suspend_spawns">FEATURE: use-subshell-for-suspend</a>
  2132. <li><a href="h_finding_help">Finding more information and requesting help</a>
  2133. <li><a href="h_common_flag">Flag Command</a>
  2134. <li><a href="h_what_are_collections">Folder Collections Explained</a>
  2135. <li><a href="h_common_folders">Folder List Command</a>
  2136. <li><a href="h_folder_fcc">Folder Select for Fcc Explained</a>
  2137. <li><a href="h_folder_save">Folder Select for Save Explained</a>
  2138. <li><a href="main_menu_tx">GENERAL INFORMATION ON THE PINE MESSAGE SYSTEM</a>
  2139. <li><a href="h_pine_for_windows">GETTING HELP IN PINE</a>
  2140. <li><a href="h_common_goto">Goto Command</a>
  2141. <li><a href="h_common_hdrmode">HdrMode Command</a>
  2142. <li><a href="h_special_help_nav">Help Text Navigation Explained</a>
  2143. <li><a href="h_folder_maint">Help for Folder List</a>
  2144. <li><a href="h_composer_ins_m">INSERT MESSAGE</a>
  2145. <li><a href="h_composer_ins">INSERT TEXT FILE</a>
  2146. <li><a href="h_address_format">INTERNET EMAIL ADDRESS FORMAT</a>
  2147. <li><a href="h_info_on_mbox">Information on mbox driver</a>
  2148. <li><a href="h_config_role_inick">Initialize Values From Role Explained</a>
  2149. <li><a href="h_main_journal">Journal Command</a>
  2150. <li><a href="h_common_jump">Jump Command</a>
  2151. <li><a href="h_compose_justify">Justify Command</a>
  2152. <li><a href="h_main_kblock">Keyboard Lock Command</a>
  2153. <li><a href="h_config_ldap_opts_nosub">LDAP FEATURE: disable-ad-hoc-space-substitution</a>
  2154. <li><a href="h_config_ldap_opts_rhs">LDAP FEATURE: lookup-addrbook-contents</a>
  2155. <li><a href="h_config_ldap_opts_ref">LDAP FEATURE: save-search-criteria-not-result</a>
  2156. <li><a href="h_config_ldap_opts_impl">LDAP FEATURE: use-implicitly-from-composer</a>
  2157. <li><a href="h_config_ldap_cust">LDAP OPTION: Custom-Search-Filter</a>
  2158. <li><a href="h_config_ldap_email_attr">LDAP OPTION: EmailAttribute</a>
  2159. <li><a href="h_config_ldap_gn_attr">LDAP OPTION: GivennameAttribute</a>
  2160. <li><a href="h_config_ldap_cn_attr">LDAP OPTION: NameAttribute</a>
  2161. <li><a href="h_config_ldap_searchrules">LDAP OPTION: Search-Rule</a>
  2162. <li><a href="h_config_ldap_searchtypes">LDAP OPTION: Search-Type</a>
  2163. <li><a href="h_config_ldap_size">LDAP OPTION: Sizelimit</a>
  2164. <li><a href="h_config_ldap_sn_attr">LDAP OPTION: SurnameAttribute</a>
  2165. <li><a href="h_config_ldap_time">LDAP OPTION: Timelimit</a>
  2166. <li><a href="h_config_ldap_server">LDAP OPTION: ldap-server</a>
  2167. <li><a href="h_config_ldap_nick">LDAP OPTION: nickname</a>
  2168. <li><a href="h_config_ldap_port">LDAP OPTION: port</a>
  2169. <li><a href="h_config_ldap_base">LDAP OPTION: search-base</a>
  2170. <li><a href="h_ldap_view">LDAP Response View Explained</a>
  2171. <li><a href="h_mail_index">MESSAGE INDEX COMMANDS</a>
  2172. <li><a href="h_mail_view">MESSAGE TEXT SCREEN</a>
  2173. <li><a href="h_compose_markcutpaste">Mark, Cut and Paste Commands</a>
  2174. <li><a href="h_common_index">Message Index Command</a>
  2175. <li><a href="new_user_greeting">NEW USER GREETING</a>
  2176. <li><a href="new_version_greeting">NEW VERSION GREETING</a>
  2177. <li><a href="h_folder_subscribe">Newsgroup Subcribe Screen explained</a>
  2178. <li><a href="h_folder_postnews">Newsgroup selecting for Posting explained</a>
  2179. <li><a href="h_common_nextnew">NextNew Command</a>
  2180. <li><a href="h_abook_select_nick">Nickname Selection Explained</a>
  2181. <li><a href="h_config_ab_sort_rule">OPTION: Address-Book-Sort-Rule</a>
  2182. <li><a href="h_config_abook_formats">OPTION: Addressbook-Formats</a>
  2183. <li><a href="h_config_alt_addresses">OPTION: Alt-Addresses</a>
  2184. <li><a href="h_config_bold_slctbl">OPTION: Bold</a>
  2185. <li><a href="h_config_char_set">OPTION: Character-Set</a>
  2186. <li><a href="h_config_composer_wrap_column">OPTION: Composer-Wrap-Column</a>
  2187. <li><a href="h_config_custom_hdrs">OPTION: Customized-Headers</a>
  2188. <li><a href="h_config_dflt_color">OPTION: Default Color</a>
  2189. <li><a href="h_config_default_fcc">OPTION: Default-FCC (File Carbon Copy)</a>
  2190. <li><a href="h_config_def_save_folder">OPTION: Default-Saved-Msg-Folder</a>
  2191. <li><a href="h_config_display_filters">OPTION: Display-Filters</a>
  2192. <li><a href="h_config_download_cmd">OPTION: Download-command</a>
  2193. <li><a href="h_config_download_prefix">OPTION: Download-command-prefix</a>
  2194. <li><a href="h_config_editor">OPTION: Editor</a>
  2195. <li><a href="h_config_empty_hdr_msg">OPTION: Empty-Header-Message</a>
  2196. <li><a href="h_config_fcc_rule">OPTION: FCC-Name-Rule</a>
  2197. <li><a href="h_config_fld_sort_rule">OPTION: Folder-Sort-Rule</a>
  2198. <li><a href="h_config_form_folder">OPTION: Form-Letter-Folder</a>
  2199. <li><a href="h_config_inbox_path">OPTION: Inbox-Path</a>
  2200. <li><a href="h_config_archived_folders">OPTION: Incoming-Archive-Folders</a>
  2201. <li><a href="h_config_index_color">OPTION: Index Colors</a>
  2202. <li><a href="h_config_index_format">OPTION: Index-Format</a>
  2203. <li><a href="h_config_keylabel_color">OPTION: KeyLabel Color</a>
  2204. <li><a href="h_config_keyname_color">OPTION: KeyName Color</a>
  2205. <li><a href="h_config_prune_date">OPTION: Last-Time-Prune Question</a>
  2206. <li><a href="h_config_nntp_server">OPTION: NNTP-Server</HEAD></a>
  2207. <li><a href="h_config_normal_color">OPTION: Normal Color</a>
  2208. <li><a href="h_config_postponed_folder">OPTION: Postponed-Folder</a>
  2209. <li><a href="h_config_prompt_color">OPTION: Prompt Color</a>
  2210. <li><a href="h_config_quote_color">OPTION: Quote Colors</a>
  2211. <li><a href="h_config_read_message_folder">OPTION: Read-Message-Folder</a>
  2212. <li><a href="h_config_reply_indent_string">OPTION: Reply-Indent-String</a>
  2213. <li><a href="h_config_reply_intro">OPTION: Reply-Leadin</a>
  2214. <li><a href="h_config_reverse_color">OPTION: Reverse Color</a>
  2215. <li><a href="h_config_incol">OPTION: Index Line Color</a>
  2216. <li><a href="h_config_smtp_server">OPTION: SMTP-Server</a>
  2217. <li><a href="h_config_saved_msg_name_rule">OPTION: Saved-Msg-Name-Rule</a>
  2218. <li><a href="h_config_scroll_margin">OPTION: Scroll-margin</a>
  2219. <li><a href="h_config_slctbl_color">OPTION: Selectable Item Color</a>
  2220. <li><a href="h_config_sending_filter">OPTION: Sending-Filters</a>
  2221. <li><a href="h_config_sort_key">OPTION: Sort-Key</a>
  2222. <li><a href="h_config_speller">OPTION: Speller</a>
  2223. <li><a href="h_config_status_color">OPTION: Status Color</a>
  2224. <li><a href="h_config_status_msg_delay">OPTION: Status-Message-Delay</a>
  2225. <li><a href="h_config_title_color">OPTION: Title Color</a>
  2226. <li><a href="h_config_upload_cmd">OPTION: Upload-command</a>
  2227. <li><a href="h_config_upload_prefix">OPTION: Upload-command-prefix</a>
  2228. <li><a href="h_config_domain_name">OPTION: Use-Only-Domain-Name</a>
  2229. <li><a href="h_config_user_dom">OPTION: User-Domain</a>
  2230. <li><a href="h_config_customhdr_pattern">OPTION: Viewer Header Color Pattern</a>
  2231. <li><a href="h_config_customhdr_color">OPTION: Viewer Header Colors</a>
  2232. <li><a href="h_config_viewer_headers">OPTION: Viewer-Headers</a>
  2233. <li><a href="h_config_file_dir">OPTION: file-directory</a>
  2234. <li><a href="h_config_goto_default">OPTION: goto-default-rule</a>
  2235. <li><a href="h_config_inc_startup">OPTION: incoming-startup-rule</a>
  2236. <li><a href="h_config_mailcap_path">OPTION: mailcap-search-path</a>
  2237. <li><a href="h_config_newsrc_path">OPTION: newsrc-path</a>
  2238. <li><a href="h_config_signature_file">OPTION: signature-file</a>
  2239. <li><a href="h_config_browser">OPTION: url-viewers</a>
  2240. <li><a href="h_news_pcpine">PC-Pine Notes</a>
  2241. <li><a href="h_news_config">Pine Configuration</a>
  2242. <li><a href="h_news_legal">Pine Legal Notices</a>
  2243. <li><a href="h_pipe_command">Pipe Command SubOptions</a>
  2244. <li><a href="h_common_pipe">Pipe Command</a>
  2245. <li><a href="h_common_postpone">Postpone Command</a>
  2246. <li><a href="h_common_print">Print Command</a>
  2247. <li><a href="h_news">RELEASE NOTES for Pine</a>
  2248. <li><a href="h_role_select">ROLES SCREEN</a>
  2249. <li><a href="h_compose_readfile">Read File Command</a>
  2250. <li><a href="h_main_release_notes">Release Notes Command</a>
  2251. <li><a href="h_common_reply">Reply and Forward Commands</a>
  2252. <li><a href="h_compose_richhdr">Rich Header Command</a>
  2253. <li><a href="h_config_role_ccpat">Role Cc Pattern Explained</a>
  2254. <li><a href="h_common_role">Role Command</a>
  2255. <li><a href="h_config_role_composeuse">Role Compose Use Explained</a>
  2256. <li><a href="h_config_role_fldr_type">Role Current Folder Type Explained</a>
  2257. <li><a href="h_config_role_forwarduse">Role Forward Use Explained</a>
  2258. <li><a href="h_config_role_frompat">Role From Pattern Explained</a>
  2259. <li><a href="h_config_role_newspat">Role News Pattern Explained</a>
  2260. <li><a href="h_config_role_nick">Role Nickname Explained</a>
  2261. <li><a href="h_config_role_replyuse">Role Reply Use Explained</a>
  2262. <li><a href="h_config_role_senderpat">Role Sender Pattern Explained</a>
  2263. <li><a href="h_config_role_setfcc">Role Set Fcc Action Explained</a>
  2264. <li><a href="h_config_role_setfrom">Role Set From Action Explained</a>
  2265. <li><a href="h_config_role_setreplyto">Role Set Reply-To Action Explained</a>
  2266. <li><a href="h_config_role_setsig">Role Set Sig Action Explained</a>
  2267. <li><a href="h_config_role_settempl">Role Set Template Action Explained</a>
  2268. <li><a href="h_config_role_subjpat">Role Subject Pattern Explained</a>
  2269. <li><a href="h_config_role_topat">Role To Pattern Explained</a>
  2270. <li><a href="h_address_display">SEARCH RESULTS INDEX</a>
  2271. <li><a href="h_address_select">SEARCH RESULTS INDEX</a>
  2272. <li><a href="h_simple_index">SELECT POSTPONED MESSAGE</a>
  2273. <li><a href="h_abook_config">SETUP ADDRESS BOOKS SCREEN</a>
  2274. <li><a href="h_collection_maint">SETUP COLLECTION LIST screen</a>
  2275. <li><a href="h_color_setup">SETUP COLOR COMMANDS</a>
  2276. <li><a href="h_direct_config">SETUP LDAP DIRECTORY SERVERS SCREEN</a>
  2277. <li><a href="h_rules_roles">SETUP ROLES SCREEN</a>
  2278. <li><a href="h_rules_incols">SETUP INDEX COLORS SCREEN</a>
  2279. <li><a href="h_rules_filter">SETUP FILTERING SCREEN</a>
  2280. <li><a href="h_rules_score">SETUP SCORING SCREEN</a>
  2281. <li><a href="h_common_save">Save and Export Commands</a>
  2282. <li><a href="h_index_cmd_select">Selecting: Select and WhereIs/Select</a>
  2283. <li><a href="h_compose_send">Send Command</a>
  2284. <li><a href="h_main_setup">Setup Command</a>
  2285. <li><a href="h_composer_sigedit">Signature Editor Commands Explained</a>
  2286. <li><a href="h_simple_text_view">Simple Text View Screen Explained</a>
  2287. <li><a href="h_index_cmd_sort">Sort Command</a>
  2288. <li><a href="h_compose_spell">Spell Check Command</a>
  2289. <li><a href="h_common_suspend">Suspend Command</a>
  2290. <li><a href="h_composer_attachment">THE MESSAGE COMPOSER'S ATTCHMNT FIELD</a>
  2291. <li><a href="h_composer_bcc">THE MESSAGE COMPOSER'S BCC FIELD</a>
  2292. <li><a href="h_composer_cc">THE MESSAGE COMPOSER'S CC FIELD</a>
  2293. <li><a href="h_composer_from">THE MESSAGE COMPOSER'S FROM FIELD</a>
  2294. <li><a href="h_composer_lcc">THE MESSAGE COMPOSER'S LCC FIELD</a>
  2295. <li><a href="h_composer_news">THE MESSAGE COMPOSER'S NEWSGRPS LINE</a>
  2296. <li><a href="h_composer_reply_to">THE MESSAGE COMPOSER'S REPLY-TO FIELD</a>
  2297. <li><a href="h_composer_to">THE MESSAGE COMPOSER'S TO FIELD</a>
  2298. <li><a href="h_abook_opened">THE PINE ADDRESS BOOK</a>
  2299. <li><a href="h_abook_select_nicks_take">Take Address Nickname Selection Explained</a>
  2300. <li><a href="h_takeaddr_screen">Take Address Screen Explained</a>
  2301. <li><a href="h_common_take">TakeAddr Command</a>
  2302. <li><a href="h_index_tokens">Tokens for Index and Replying</a>
  2303. <li><a href="h_whatis_vcard">VCARD EXPLAINED</a>
  2304. <li><a href="h_view_cmd_hilite">View Hilite and Next item/Previous item</a>
  2305. <li><a href="h_view_cmd_viewattch">ViewAttch Command</a>
  2306. <li><a href="h_index_cmd_whereis">WhereIs Command</a>
  2307. <li><a href="h_view_cmd_whereis">WhereIs Command</a>
  2308. <li><a href="h_index_cmd_zoom">ZoomMode Command</a>
  2309. <li><a href="h_config_browser_xterm">url-viewers and X windows applications</a>
  2310. </UL>
  2311.  
  2312. <P>
  2313. <End of Help Index>
  2314. </BODY>
  2315. </HTML>
  2316.  
  2317.  
  2318. ============== h_special_xon_xoff =============
  2319. <HTML>
  2320. <HEAD>
  2321. <TITLE>Explanation of Pine's XOFF/XON Handling</TITLE>
  2322. </HEAD>
  2323. <BODY>
  2324. <H1>XOFF/XON Handling within Pine</H1>
  2325.  
  2326. By default, Pine treats Ctrl-S or Ctrl-Q (sometimes known as XOFF
  2327. and XON) as normal characters, even though Pine does not use them.
  2328. However, the printer, modem, or communication software you are using may
  2329. be configured for "software flow control," which means that
  2330. XON/XOFF must be treated as special characters by the operating system.
  2331. If you see messages such as "^X not defined for this screen",
  2332. then your system is probably using software flow control. In this case
  2333. you will need to set the
  2334. <A HREF="h_config_preserve_start_stop">"preserve-start-stop-characters"</A>
  2335. feature.
  2336. <P>
  2337. If you <EM>do</EM> set this
  2338. feature, be advised that if you accidentally hit a Ctrl-S, Pine will
  2339. mysteriously freeze up with no warning.  In this case, try typing a Ctrl-Q
  2340. and see if that puts things right.  Printing via the
  2341. "attached-to-ansi" option will automatically enable software
  2342. flow-control handling for the duration of the printing.
  2343. <P>
  2344. <End of help on this topic>
  2345. </BODY>
  2346. </HTML>
  2347. ============= h_special_help_nav =============
  2348. <HTML>
  2349. <HEAD>
  2350. <TITLE>Help Text Navigation Explained</TITLE>
  2351. </HEAD>
  2352. <BODY>
  2353. <H1>Help Text Navigation Explained</H1>
  2354.  
  2355. Pine contains extensive context-sensitive help text.   At any point, 
  2356. pressing the "?" key will bring up a page of help text
  2357. explaining the options available to you.  You can leave the help
  2358. text screen and return to normal Pine operation by pressing
  2359. the
  2360. <!--chtml if pinemode="function_key"-->
  2361. F3 function
  2362. <!--chtml else-->
  2363. "E"
  2364. <!--chtml endif-->
  2365. key to Exit Help at any time.
  2366.  
  2367. <P>
  2368. Within the help screen you might find a word or phrase displayed in 
  2369. inverse text and others displayed in bold typeface.  Such words and
  2370. phrases are used to tell you Pine has more information available on
  2371. the topic they describe.
  2372. The inverted text is the "selected" topic.  
  2373. Use the arrow keys, Ctrl-F, and Ctrl-B to change which of the phrases
  2374. displayed in bold type
  2375. is "selected".
  2376. Hit the Return key to display the information Pine has available on that
  2377. topic.  While viewing such additional information, the 
  2378. <!--chtml if pinemode="function_key"-->
  2379. F3 function
  2380. <!--chtml else-->
  2381. "P"
  2382. <!--chtml endif-->
  2383. key will return you to the previous help screen, and the
  2384. <!--chtml if pinemode="function_key"-->
  2385. F2 function
  2386. <!--chtml else-->
  2387. "E"
  2388. <!--chtml endif-->
  2389. key will Exit the Help system altogether.
  2390.  
  2391. <P>
  2392. When you are finished reading this help text, you can press the
  2393. <!--chtml if pinemode="function_key"-->
  2394. F3 function
  2395. <!--chtml else-->
  2396. "P"
  2397. <!--chtml endif-->
  2398. key to return to the previously displayed help text.
  2399.  
  2400. <P>
  2401. <End of help on this topic>
  2402. </BODY>
  2403. </HTML>
  2404. ============= h_special_list_commands =============
  2405. <HTML>
  2406. <HEAD>
  2407. <TITLE>Email List Commands Explained</TITLE>
  2408. </HEAD>
  2409. <BODY>
  2410. <H1>Email List Commands Explained</H1>
  2411.  
  2412. Electonic mail lists provide a way for like-minded users to join in
  2413. discussions on topics of interest.  The email list itself is 
  2414. represented by a
  2415. single address that participants send messages to when they have
  2416. something of interest to share with other members of the list.  The
  2417. receiving computer then, either automatically or after review by the
  2418. list's owner (or moderator), sends a copy of that message to each
  2419. member of the list.
  2420.  
  2421. <P>
  2422. Usually, subscribing and unsubscribing is done by sending requests in
  2423. an email message to a special address setup to handle managing list
  2424. membership.  Often this is the name of the list followed by
  2425. <I>-request</I>.  This address is almost <EM>never</EM> the same as
  2426. the address used to send messages to the list.
  2427.  
  2428. <P>
  2429. Unfortunately, email list participation commands are more a matter
  2430. of convention than standard, and thus may vary from list to list.
  2431. Increasingly, list management software is adding information to
  2432. the copy of the postings as they're copied to the list members that
  2433. explains how to do the various list management functions.
  2434.  
  2435. <P>
  2436. Pine will recognize this information and offer the management commands
  2437. they represent in a simple display. One or more of the following
  2438. operations will be made available:
  2439.  
  2440. <DL>
  2441. <DT>Help</DT>
  2442. <DD>
  2443. A method to get help on subscribing, unsubscribing, 
  2444. an explanation of what the list is about, or special instructions
  2445. for participation.  This may be in the form of a reply in response
  2446. to an email message, or instructions on how to connect to a Web site.
  2447. </DD>
  2448.  
  2449. <DT>Unsubscribe</DT>
  2450. <DD>
  2451. A method to get your email addressed removed from the list of
  2452. recipients of the email list.
  2453. </DD>
  2454.  
  2455. <DT>Subscribe</DT>
  2456. <DD>
  2457. A method to get your email address added to the list of recipients
  2458. of the email list.  It may be in the form of a message sent to 
  2459. a special address or you may be connected to a web site.
  2460. <DD>
  2461. </DD>
  2462.  
  2463. <DT>Post</DT>
  2464. <DD>
  2465. A method used to post to the email list.  However, it might also 
  2466. indicate that no posting is allowed directly to the list.
  2467. </DD>
  2468.  
  2469. <DT>Owner</DT>
  2470. <DD>
  2471. A method to contact the list owner for special questions you might
  2472. have regarding the list.
  2473. </DD>
  2474.  
  2475. <DT>Archive</DT>
  2476. <DD>
  2477. A method to view an archive of previous messages posted to the list.
  2478. This may be in the form of a mail folder on a remote computer, an
  2479. IMAP mailbox or even a Web site.
  2480. </DD>
  2481. </DL>
  2482.  
  2483. <P>
  2484. <End of help on this topic>
  2485. </BODY>
  2486. </HTML>
  2487. ============= h_mail_index =============
  2488. <HTML>
  2489. <HEAD>
  2490. <TITLE>MESSAGE INDEX COMMANDS</TITLE>
  2491. </HEAD>
  2492. <BODY>                 
  2493. <H1>MESSAGE INDEX COMMANDS</H1>
  2494. <!--chtml if pinemode="function_key"-->
  2495. Available  Commands -- Group 1         Available Commands -- Group 2<BR>
  2496. -------------------------------        -----------------------------<BR>
  2497. F1  Show Help Text                     F1  Show Help Text<BR>
  2498. F2  Toggle to see more commands        F2  Toggle to see more commands<BR>
  2499. F3  <A HREF="h_common_folders">FOLDER LIST</A> Screen                 F3  MAIN MENU Screen<BR>
  2500. F4  View current message               F4  Quit Pine<BR>
  2501. F5  Move to previous message           F5  <A HREF="h_common_compose">Compose</A> a message<BR>
  2502. F6  Move to next message               F6  <A HREF="h_common_goto">Goto</A> a specified folder<BR>
  2503. F7  Show previous screen of messages   F7  <A HREF="h_common_nextnew">Next new</A> message<BR>
  2504. F8  Show next screen of messages       F8  <A HREF="h_index_cmd_whereis">Whereis</A><BR>
  2505. F9  <A HREF="h_common_delete">Mark message for deletion</A>          F9  <A HREF="h_common_print">Print</A> message<BR>
  2506. F10 <A HREF="h_common_delete">Undelete</A> (remove delete mark)      F10 <A HREF="h_common_take">Take Address</A> into address book<BR>
  2507. F11 <A HREF="h_common_reply">Reply</A> to message                   F11 <A HREF="h_common_save">Save</A> message into an email folder<BR>
  2508. F12 <A HREF="h_common_reply">Forward</A> message                    F12 <A HREF="h_common_save">Export</A> message into a plain file<BR>
  2509. <BR>
  2510. Available Commands -- Group 3<BR>
  2511. -----------------------------<BR>
  2512. F3  <A HREF="h_index_cmd_expunge">Expunge/Exclude</A>    F7 <A HREF="h_index_cmd_sort">Sort</A> order of index  F10 <A HREF="h_common_bounce">Bounce</A> (remail) msg<BR>
  2513. F5  <A HREF="h_index_cmd_select">Select</A>             F8 <A HREF="h_common_jump">Jump</A> to message      F11 <A HREF="h_common_flag">Flag</A> message as important<BR>
  2514. F6  <A HREF="h_index_cmd_apply">Apply</A>              F9 <A HREF="h_common_hdrmode">Full Header Mode</A>     F12 <A HREF="h_common_pipe">Pipe</A> to a Unix command<BR>
  2515. <BR>
  2516. Available Commands -- Group 4<BR>
  2517. -----------------------------<BR>
  2518. F3  Select Current     F4  <A HREF="h_index_cmd_zoom">Zoom</A>                F5  COLLECTION LIST Screen
  2519. F6  <A HREF="h_common_role">Compose using a role</A><BR>
  2520. <BR>
  2521. <!--chtml else-->
  2522. Navigating the List of Messages            Operations on the Current Message<BR>
  2523. -------------------------------            ---------------------------------<BR>
  2524.  P   Move to the previous message          >  View                 %  <A HREF="h_common_print">Print</A><BR>
  2525.  N   Move to the next message              R  <A HREF="h_common_reply">Reply</A> to message     F  <A HREF="h_common_reply">Forward</A><BR>
  2526.  -   Show previous screen of messages      D  <A HREF="h_common_delete">Mark for deletion</A><BR>
  2527. Spc  Show next screen of messages          U  <A HREF="h_common_delete">Undelete</A> (remove deletion mark)<BR>
  2528.  J   <A HREF="h_common_jump">Jump</A> to a specific message            T  <A HREF="h_common_take">Take Address</A> into Address Book<BR>
  2529.  W   <A HREF="h_index_cmd_whereis">Whereis</A> -- search for a               S  <A HREF="h_common_save">Save</A> into an email folder<BR>
  2530.      specific message                      E  <A HREF="h_common_save">Export</A> as a plain text file<BR>
  2531. Tab  <A HREF="h_common_nextnew">Next new</A> message                      B  <A HREF="h_common_bounce">Bounce</A>              *  <A HREF="h_common_flag">Flag</A><BR>
  2532.                                            |  <A HREF="h_common_pipe">Pipe</A> to a Unix Command<BR>
  2533. Miscellaneous Operations<BR>
  2534. ------------------------<BR>
  2535.  G   <A HREF="h_common_goto">Goto</A> a specified folder     General Pine Commands<BR>
  2536.  $   <A HREF="h_index_cmd_sort">Sort</A> order of index         ---------------------<BR>
  2537.  H   <A HREF="h_common_hdrmode">Full header mode</A>            O  Show all other available commands<BR>
  2538.  X   <A HREF="h_index_cmd_expunge">Expunge/Exclude</A>             ?  Show Help text     Q Quit Pine<BR>
  2539.  Z   <A HREF="h_index_cmd_zoom">Zoom</A>                        M  MAIN MENU Screen   < <A HREF="h_common_folders">FOLDER LIST</A> Screen<BR>
  2540.  ;   <A HREF="h_index_cmd_select">Select</A>     A <A HREF="h_index_cmd_apply">Apply</A>          C  <A HREF="h_common_compose">Compose</A> a new message<BR>
  2541.  :   Select Current              #  <A HREF="h_common_role">Compose using a role</A><BR>
  2542.                                  L  COLLECTION LIST Screen<BR>
  2543. <!--chtml endif-->
  2544. <P>
  2545.  
  2546. NOTE:
  2547. <OL>
  2548.  <LI>For help on a particular command, hilite the bold text associated
  2549. with it above and hit Return.
  2550.  <LI>Availability of certain commands depends on <A HREF="h_common_conditional_cmds">feature settings</A>.
  2551. </OL>
  2552.  
  2553. <H2>Description of the MESSAGE INDEX Screen</H2>
  2554.  
  2555. The MESSAGE INDEX displays summary information from each
  2556. message in the current folder.
  2557. This is useful if you want to quickly
  2558. scan new messages, or find a particular message without having to go
  2559. through the text of each message, or to quickly get rid of junk
  2560. messages, etc.
  2561. The current message is always highlighted.
  2562. Each line of the MESSAGE INDEX contains the following columns (by default -- 
  2563. you can change this with the 
  2564. "<A HREF="h_config_index_format">Index-Format</A>" option
  2565. in the SETUP CONFIGURATION screen): <P>
  2566. <DL>
  2567.  <DT>STATUS:</DT>
  2568.  <DD> The markings on the left side of the message tell you about its
  2569. status.  You may see one or more of the following codes on any given
  2570. message:
  2571. <UL>
  2572.   <LI> "D" for Deleted.  You have marked this message for deletion but not
  2573.      yet eXpunged the folder.
  2574.   <LI> "N" for New.  You have not looked at the text of the message yet.
  2575.   <LI> "A" for Answered.  Any time you reply to a message it is considered
  2576.      to be answered.
  2577.   <LI> "+" for direct-to-you.  The "+" indicates that a message was sent
  2578.     directly to your account, your copy is not part of a cc: or a
  2579.     mailing list.
  2580.   <LI> "X" for selected.  You have selected the message by using the
  2581.     "select" command.  (Some systems may optionally allow selected
  2582.     messages to be denoted by the index line being displayed in bold
  2583.     type.)
  2584.   <LI> "*" for Important.  You have previously used the "Flag" command
  2585.       to mark this message as "important".
  2586. </UL></DD><P>
  2587.  
  2588.  <DT>NUMBER:</DT>
  2589.  <DD>Messages in a folder are numbered, from one through the number
  2590. of messages in the folder, to help you know where you are in the folder.</DD><P>
  2591.  
  2592.  
  2593.  <DT>DATE SENT:</DT>
  2594.  <DD>The date the message was sent.  By default, messages are
  2595. ordered by arrival time, not by date sent.  Most of the time, arrival time
  2596. and date sent (effectively departure time) are similar.  Sometimes,
  2597. however, the index will appear to be out of order because a message took a
  2598. long time in delivery.</DD><P>
  2599.  
  2600.  
  2601.  <DT>SENDER:</DT>
  2602.  <DD>The name or email address of the sender.  If you are the sender,
  2603. then the recipient's name is shown here.  In Newsgroups, if you are
  2604. the sender and there are no email recipients, the newsgroup name will be
  2605. listed. </DD><P>
  2606.  
  2607.  
  2608.  <DT>SIZE:</DT>
  2609.  <DD>The number in parentheses is the number of characters in the message.</DD><P>
  2610.  
  2611.  
  2612.  <DT>SUBJECT:</DT>
  2613.  <DD>As much of the message's subject line as will fit on the screen.</DD>
  2614. </DL>
  2615.  
  2616. <P><UL>
  2617. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  2618. </UL>
  2619. <P>
  2620. <End of help on this topic>
  2621. </BODY>
  2622. </HTML>
  2623. ============= h_mail_view ========================
  2624. <HTML>
  2625. <HEAD>
  2626. <TITLE>MESSAGE TEXT SCREEN</TITLE>
  2627. </HEAD>
  2628. <BODY>
  2629. <H1>MESSAGE TEXT SCREEN</H1>
  2630. <!--chtml if pinemode="function_key"-->
  2631. Available  Commands -- Group  1        Available Commands -- Group 2<BR>
  2632. -------------------------------        ------------------------------<BR>
  2633. F1  Show Help Text                     F1  Show Help Text<BR>
  2634. F2  Toggle to see more commands        F2  Toggle to see more commands<BR>
  2635. F3  <A HREF="h_common_index">MESSAGE INDEX</A> Screen               F3  MAIN MENU Screen<BR>
  2636. F4  <A HREF="h_view_cmd_viewattch">View attachment</A>                    F4  Quit Pine<BR>
  2637. F5  Display previous message           F5  <A HREF="h_common_folders">FOLDER LIST</A> Screen<BR>
  2638. F6  Display next message               F6  <A HREF="h_common_goto">Goto</A> a specified folder<BR>
  2639. F7  Previous screen of this message    F7  <A HREF="h_common_compose">Compose</A> message<BR>
  2640. F8  Next screen of this message        F8  <A HREF="h_view_cmd_whereis">Whereis</A><BR>
  2641. F9  <A HREF="h_common_delete">Mark message for deletion</A>          F9  <A HREF="h_common_print">Print</A> message<BR>
  2642. F10 <A HREF="h_common_delete">Undelete</A> (remove delete mark)      F10 <A HREF="h_common_take">Take Address</A> into address book<BR>
  2643. F11 <A HREF="h_common_reply">Reply</A> to message                   F11 <A HREF="h_common_save">Save</A> message into an email folder<BR>
  2644. F12 <A HREF="h_common_reply">Forward</A>                            F12 <A HREF="h_common_save">Export</A> message into a plain file<BR>
  2645. <BR>
  2646. Available Commands -- Group 3<BR>
  2647. ------------------------------<BR>
  2648. F1  Show Help Text<BR>
  2649. F2  Toggle to see more commands<BR>
  2650. F3  <A HREF="h_view_cmd_hilite">View hilited</A><BR>
  2651. F4  Select current message<BR>
  2652. F5  Previous selectable item<BR>
  2653. F6  Next selectable item<BR>
  2654. F7  <A HREF="h_common_jump">Jump</A> to message number<BR>
  2655. F8  <A HREF="h_common_nextnew">Next new</A> message<BR>
  2656. F9  <A HREF="h_common_hdrmode">Display full headers</A><BR>
  2657. F10 <A HREF="h_common_bounce">Bounce</A> message<BR>
  2658. F11 <A HREF="h_common_flag">Flag</A> message<BR>
  2659. F12 <A HREF="h_common_pipe">Pipe</A> to a Unix command<BR>
  2660. Available Commands -- Group 4<BR>
  2661. F5  <A HREF="h_common_role">Compose using a role</A><BR>
  2662. <!--chtml else-->
  2663. Operations on the Current Message<BR>
  2664. ---------------------------------<BR>
  2665. <BR>
  2666.  -   Show previous page of this msg    S  <A HREF="h_common_save">Save</A> into an email folder<BR>
  2667. Spc  Show next page of this msg        E  <A HREF="h_common_save">Export</A> as a plain text file<BR>
  2668.  >   <A HREF="h_view_cmd_viewattch">View attachment</A>                   B  <A HREF="h_common_bounce">Bounce</A><BR>
  2669.  R   <A HREF="h_common_reply">Reply</A> to message                  F  <A HREF="h_common_reply">Forward</A> message<BR>
  2670.  D   <A HREF="h_common_delete">Mark for deletion</A>                Ret View <A HREF="h_view_cmd_hilite">hilited</A> item<BR>
  2671.  U   <A HREF="h_common_delete">Undelete</A> (remove deletion mark)  ^F  Select next <A HREF="h_view_cmd_hilite">hilited</A> item in message<BR>
  2672.  T   <A HREF="h_common_take">Take Address</A> into Address Book   ^B  Select previous <A HREF="h_view_cmd_hilite">hilited</A> item<BR>
  2673.  %   <A HREF="h_common_print">Print</A>                             *  <A HREF="h_common_flag">Flag</A> message<BR>
  2674.  W   <A HREF="h_view_cmd_whereis">Whereis</A>: search for text in msg   |  <A HREF="h_common_pipe">Pipe</A> to a Unix command<BR>
  2675. <BR>
  2676. Navigating the List of Messages      Other Commands<BR>
  2677. -------------------------------      ----------------------------<BR>
  2678.  P     Display previous message      G   <A HREF="h_common_goto">Goto</A> a specified folder<BR>
  2679.  N     Display next message          H   <A HREF="h_common_hdrmode">Full header mode</A> on/off<BR>
  2680.  J     <A HREF="h_common_jump">Jump</A> to a specific message    :   Select Current message<BR>
  2681. Tab    <A HREF="h_common_nextnew">Next new</A> message<BR>
  2682. <BR>
  2683. General Pine Commands<BR>
  2684. ---------------------<BR>
  2685.  O  Show all other available commands<BR>
  2686.  ?  Show Help text        Q Quit Pine<BR>
  2687.  M  MAIN MENU Screen      L <A HREF="h_common_folders">FOLDER LIST</A> Screen (or COLLECTION LIST Screen)<BR>
  2688.  <  <A HREF="h_common_index">MESSAGE INDEX</A> Screen  C <A HREF="h_common_compose">Compose</A> a new message<BR>
  2689.                           # <A HREF="h_common_role">Compose using a role</A><BR>
  2690. <!--chtml endif-->
  2691. <P>
  2692.  
  2693. NOTE:
  2694. <OL>
  2695.  <LI>For help on a particular command, hilite the bold text associated
  2696. with it above and hit Return.
  2697.  <LI>Availability of certain commands depends on <A HREF="h_common_conditional_cmds">feature settings</A>.
  2698. </OL>
  2699.  
  2700. <H2>Description of the MESSAGE TEXT Screen</H2>
  2701.  
  2702. The top line of the view message screen displays status
  2703. information about the currently open collection and folder and about the
  2704. current message.  It shows the name of the collection in angle brackets
  2705. and then the name of the folder.  The line also displays the number
  2706. of messages in the folder, the number of the current message and the
  2707. percentage of the current message that has been displayed on the screen.
  2708. If the message is marked for deletion "DEL" will appear in the upper
  2709. right corner.
  2710. If the message has been answered (but not deleted) "ANS" will show
  2711. in the corner.
  2712. <P>
  2713.  
  2714. NOTE: to rapidly move to the end of a message, hit the
  2715. <!--chtml if pinemode="function_key"-->F8<!--chtml else-->W<!--chtml endif-->
  2716. (or Ctrl-W) key followed
  2717. by Ctrl-V.  Similarly,
  2718. <!--chtml if pinemode="function_key"-->F8<!--chtml else-->W<!--chtml endif-->
  2719. followed by Ctrl-Y will take you to the beginning of
  2720. a message.
  2721.  
  2722. <H2>Explanation of Alternate Character Sets</H2>
  2723.  
  2724. Pine attempts to stay out of the way so that it won't prevent you from
  2725. viewing mail in any character set.  It will simply send the message to
  2726. your display device.  If the device is capable of displaying the
  2727. message as it was written it will do so.  If not, the display may be
  2728. partially or totally incorrect.  If the message is marked as being in
  2729. a character set other than "US-ASCII" and it is a character
  2730. set that is different from the set you have indicated with the
  2731. <A HREF="h_config_char_set">"character-set"</A>
  2732. variable in your configuration, then a warning message will be printed
  2733. to your screen at the beginning of the message display.<P>
  2734.  
  2735. In all cases Pine requires that the display device can handle the
  2736. character set.  For example, most X-terminals will display the ISO-8859-1
  2737. character set if the right font is selected.  VT220's and higher also
  2738. display ISO-8859-1.  Displays for other characters sets are less common.
  2739. <P>
  2740.  
  2741. Pine usually suppresses display of control characters in order to avoid
  2742. characters which may change terminal setup parameters.
  2743. If this is a problem for you, the
  2744. "<A HREF="h_config_pass_control">pass-control-characters-as-is</A>"
  2745. feature can be used to turn this behavior off.
  2746.  
  2747. <P><UL>
  2748. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  2749. </UL>
  2750. <P>
  2751. <End of help on this topic>
  2752. </BODY>
  2753. </HTML>
  2754. ======= h_index_cmd_select =======
  2755. <HTML>
  2756. <HEAD>
  2757. <TITLE>Selecting: Select and WhereIs/Select</TITLE>
  2758. </HEAD>
  2759. <BODY>
  2760. <H1>Selecting: Select and WhereIs/Select</H1>
  2761.  
  2762. Aggregate operations give you the ability to process a group of messages
  2763. at once.  Acting on multiple messages requires two steps: (1) selecting a
  2764. set of messages and then (2) applying a command to that set. The first
  2765. part is handled by the select command.  Select allows you to
  2766. select messages based on their status (read, answered, etc.), contents
  2767. (including fielded selections on header lines) or date.  You also get
  2768. certain quick options to select a specific message or range of messages,
  2769. to select the current message or to select all messages.
  2770. <P>
  2771.  
  2772. After you have an initial selection, the select command changes.  It gives
  2773. you selection "alteration" options: unselect all, unselect current,
  2774. broaden (implements a logical OR), and narrow (implements a logical AND).
  2775. You are allowed to use select as many times as you need to get the
  2776. selected set right.
  2777. <P>
  2778.  
  2779. Also, starting with Pine 4.00, the WhereIs command has a new feature 
  2780. (Ctrl-X) to
  2781. select all the messages which match the WhereIs search. WhereIs searches
  2782. through just the text which appears on the MESSAGE INDEX screen.
  2783. <P>
  2784.  
  2785. The availability of the aggregate operations commands is determined by the
  2786. <A HREF="h_config_enable_agg_ops">"enable-aggregate-command-set"</A>
  2787. feature-list option in your Pine
  2788. configuration.
  2789. The features
  2790. <A HREF="h_config_auto_zoom">"auto-zoom-after-select"</A>
  2791. and
  2792. <A HREF="h_config_select_wo_confirm">"select-without-confirm"</A>
  2793. affect the behavior of the Select command.
  2794.  
  2795. <P>
  2796. <End of help on this topic>
  2797. </BODY>
  2798. </HTML>
  2799. ======= h_index_cmd_apply =======
  2800. <HTML>
  2801. <HEAD>
  2802. <TITLE>Apply Command</TITLE>
  2803. </HEAD>
  2804. <BODY>
  2805. <H1>Apply Command</H1>
  2806.  
  2807. Apply
  2808. (<!--chtml if pinemode="function_key"-->F6<!--chtml else-->A<!--chtml endif-->)
  2809. is the second step of most aggregate operations.  Apply
  2810. becomes active any time there is a defined set of selected messages.  The
  2811. following commands can be applied to a selected message set: delete,
  2812. undelete, reply, forward,
  2813. <!--chtml if pinemode="os_windows"-->
  2814. <!--chtml else--> 
  2815. pipe,
  2816. <!--chtml endif-->
  2817. print, take address, save, export, bounce, and flag.
  2818. <P>
  2819.  
  2820. The behavior of some of these commands in an aggregate sense is not easy to
  2821. explain.  Try them out to see what they do.
  2822. The feature
  2823. <A HREF="h_config_auto_unzoom">"auto-unzoom-after-apply"</A>
  2824. affects the behavior of the Apply command.
  2825.  
  2826. <P>
  2827. <End of help on this topic>
  2828. </BODY>
  2829. </HTML>
  2830. ======= h_index_cmd_zoom =======
  2831. <HTML>
  2832. <HEAD>
  2833. <TITLE>ZoomMode Command</TITLE>
  2834. </HEAD>
  2835. <BODY>
  2836. <H1>ZoomMode Command</H1>
  2837.  
  2838. Another action you might want to take on a set of selected messages is to
  2839. zoom in on them.  Like apply, zoom only becomes active when messages have
  2840. been selected.
  2841. ZoomMode
  2842. (<!--chtml if pinemode="function_key"-->F3<!--chtml else-->Z<!--chtml endif-->)
  2843. is a toggle command which allows you to
  2844. zoom-in (and only see the selected messages) and zoom-out (to see all
  2845. messages in the folder).  Neither apply nor zoom removes the markings which
  2846. define the selected set; you need to use a select command in order
  2847. to do that.
  2848.  
  2849. <P>
  2850. <End of help on this topic>
  2851. </BODY>
  2852. </HTML>
  2853. ======= h_index_cmd_sort =======
  2854. <HTML>
  2855. <HEAD>
  2856. <TITLE>Sort Command</TITLE>
  2857. </HEAD>
  2858. <BODY>
  2859. <H1>Sort Command</H1>
  2860.  
  2861. In Pine's generic configuration, messages are presented in the order in
  2862. which they arrive.  This default can be changed in the SETUP CONFIGURATION 
  2863. with the "<A HREF="h_config_sort_key">Sort-Key</A>" option.
  2864. You can also re-sort the folder on demand with the sort
  2865. (<!--chtml if pinemode="function_key"-->F7<!--chtml else-->$<!--chtml endif-->)
  2866. command.
  2867. Your sorting options are:
  2868. <P>
  2869. <UL>
  2870.  <LI> <A HREF="h_index_sort_arrival">A</A>rrival
  2871.  <LI> <A HREF="h_index_sort_date">D</A>ate
  2872.  <LI> <A HREF="h_index_sort_subj">S</A>ubject
  2873.  <LI> <A HREF="h_index_sort_ordsubj">O</A>rderedSubject
  2874.  <LI> <A HREF="h_index_sort_from">F</A>rom
  2875.  <LI> si<A HREF="h_index_sort_size">Z</A>e
  2876.  <LI> scor<A HREF="h_index_sort_score">E</A>,
  2877.  <LI> <A HREF="h_index_sort_to">T</A>o
  2878.  <LI> <A HREF="h_index_sort_cc">C</A>c
  2879. </UL>
  2880.  
  2881. <P>
  2882. The Reverse option will toggle the order the index is currently
  2883. sorted by, but will not change the relative sort order.
  2884.  
  2885. <P>
  2886. Sorting a folder does not actually rearrange the way the folder is saved,
  2887. it just re-arranges how the messages are presented to you.  This means
  2888. that Pine has to do the work of sorting every time you change sort order.
  2889. Sometimes, especially with PC-Pine or with large folders, this could take
  2890. a while.
  2891.  
  2892. <P>
  2893. <End of help on this topic>
  2894. </BODY>
  2895. </HTML>
  2896. ======= h_index_sort_arrival =======
  2897. <HTML>
  2898. <HEAD>
  2899. <TITLE>SORT OPTION: Arrival</TITLE>
  2900. </HEAD>
  2901. <BODY>
  2902. <H1>SORT OPTION: Arrival</H1>
  2903.  
  2904. The <EM>Arrival</EM> sort option arranges messages in the MESSAGE INDEX
  2905. in the order that they exist in the folder.  This is usually the same as the
  2906. order in which they arrived.  This option is comparable to not sorting
  2907. the messages at all.
  2908.  
  2909. <P>
  2910. <End of help on this topic>
  2911. </BODY>
  2912. </HTML>
  2913. ======= h_index_sort_date =======
  2914. <HTML>
  2915. <HEAD>
  2916. <TITLE>SORT OPTION: Date</TITLE>
  2917. </HEAD>
  2918. <BODY>
  2919. <H1>SORT OPTION: Date</H1>
  2920.  
  2921. The <EM>Date</EM> sort option arranges messages in the MESSAGE INDEX
  2922. according to the date and time they were
  2923. sent.
  2924.  
  2925. <P>
  2926. On a folder like INBOX, sorting by "Date" should be almost
  2927. identical to sorting by "Arrival".
  2928.  
  2929. <P>
  2930. <End of help on this topic>
  2931. </BODY>
  2932. </HTML>
  2933. ======= h_index_sort_subj =======
  2934. <HTML>
  2935. <HEAD>
  2936. <TITLE>SORT OPTION: Subject</TITLE>
  2937. </HEAD>
  2938. <BODY>
  2939. <H1>SORT OPTION: Subject</H1>
  2940.  
  2941. The <EM>Subject</EM> sort option arranges messages in the MESSAGE INDEX
  2942. by subject. 
  2943.  
  2944. <P>
  2945. Messages with the same subject are
  2946. first grouped together, and then the groups of like-subject messages
  2947. are arranged alphabetically.
  2948.  
  2949. <P>
  2950. Pine ignores leading "Re:" and
  2951. "re:" and trailing "(fwd)" when determining the
  2952. likeness and alphabetical order of subject lines.
  2953.  
  2954. <P>
  2955. <End of help on this topic>
  2956. </BODY>
  2957. </HTML>
  2958. ======= h_index_sort_ordsubj =======
  2959. <HTML>
  2960. <HEAD>
  2961. <TITLE>SORT OPTION: OrderedSubject</TITLE>
  2962. </HEAD>
  2963. <BODY>
  2964. <H1>SORT OPTION: OrderedSubject</H1>
  2965.  
  2966. The <EM>OrderedSubject</EM> sort option arranges messages in the
  2967. MESSAGE INDEX by grouping all messages with the same subject
  2968. together, similar to sort by <A HREF="h_index_sort_subj">S</A>ubject.
  2969.  
  2970. <P>
  2971. However, <EM>OrderedSubj</EM> then arranges the groups of like-subject
  2972. messages by the date of the oldest message in the group.
  2973.  
  2974. <P>
  2975. This sort method provides for pseudo threading of conversations within
  2976. a folder.
  2977.  
  2978. <P>
  2979. <End of help on this topic>
  2980. </BODY>
  2981. </HTML>
  2982. ======= h_index_sort_from =======
  2983. <HTML>
  2984. <HEAD>
  2985. <TITLE>SORT OPTION: From</TITLE>
  2986. </HEAD>
  2987. <BODY>
  2988. <H1>SORT OPTION: From</H1>
  2989.  
  2990. The <EM>From</EM> sort option arranges messages in the MESSAGE INDEX
  2991. by the name of the author of the message.
  2992.  
  2993. <P>
  2994. Messages with the same author are grouped together. Groups of
  2995. messages are then put into alphabetical order according to message
  2996. author.
  2997.  
  2998. <P>
  2999. <End of help on this topic>
  3000. </BODY>
  3001. </HTML>
  3002. ======= h_index_sort_size =======
  3003. <HTML>
  3004. <HEAD>
  3005. <TITLE>SORT OPTION: Size</TITLE>
  3006. </HEAD>
  3007. <BODY>
  3008. <H1>SORT OPTION: Size</H1>
  3009.  
  3010. The <EM>Size</EM> sort option arranges messages in the MESSAGE INDEX
  3011. by their relative sizes.
  3012.  
  3013. <P>
  3014. <End of help on this topic>
  3015. </BODY>
  3016. </HTML>
  3017. ======= h_index_sort_score =======
  3018. <HTML>
  3019. <HEAD>
  3020. <TITLE>SORT OPTION: Score</TITLE>
  3021. </HEAD>
  3022. <BODY>
  3023. <H1>SORT OPTION: Score</H1>
  3024.  
  3025. The <EM>Score</EM> sort option arranges messages in the MESSAGE INDEX
  3026. by their scores.
  3027.  
  3028. <P>
  3029. Messages with the same score are sorted in arrival order.
  3030. Scores are something you create using the
  3031. <A HREF="h_rules_score">"SETUP SCORING"</A> screen.
  3032.  
  3033. <P>
  3034. <End of help on this topic>
  3035. </BODY>
  3036. </HTML>
  3037. ======= h_index_sort_to =======
  3038. <HTML>
  3039. <HEAD>
  3040. <TITLE>SORT OPTION: To</TITLE>
  3041. </HEAD>
  3042. <BODY>
  3043. <H1>SORT OPTION: To</H1>
  3044.  
  3045. The <EM>To</EM> sort option arranges messages in the MESSAGE INDEX 
  3046. by the names of the recipients of the message.
  3047.  
  3048. <P>
  3049. Messages with the same recipients are grouped together. Groups of
  3050. messages are then put into alphabetical order according to message
  3051. recipients.
  3052.  
  3053. <P>
  3054. <End of help on this topic>
  3055. </BODY>
  3056. </HTML>
  3057. ======= h_index_sort_cc =======
  3058. <HTML>
  3059. <HEAD>
  3060. <TITLE>SORT OPTION: Cc</TITLE>
  3061. </HEAD>
  3062. <BODY>
  3063. <H1>SORT OPTION: Cc</H1>
  3064.  
  3065. The <EM>Cc</EM> sort option arranges messages in the MESSAGE INDEX by
  3066. the names of the carbon copy addresses of the message.
  3067.  
  3068. <P>
  3069. <End of help on this topic>
  3070. </BODY>
  3071. </HTML>
  3072. ======= h_index_cmd_whereis =======
  3073. <HTML>
  3074. <HEAD>
  3075. <TITLE>WhereIs Command</TITLE>
  3076. </HEAD>
  3077. <BODY>
  3078. <H1>WhereIs Command</H1>
  3079.  
  3080. The WhereIs
  3081. (<!--chtml if pinemode="function_key"-->F8<!--chtml else-->W<!--chtml endif-->)
  3082. command lets you search the MESSAGE INDEX for a word.  It scans
  3083. through whatever you see, usually the name of the author and the subject
  3084. line.  WhereIs has special features to let you "find" the beginning of the
  3085. index (Ctrl-Y -- first message) or the end of the index (Ctrl-V -- last
  3086. message).  WhereIs can also be used as a quick way to select messages; see
  3087. below for more information on this.  Note that WhereIs does not see the 
  3088. "X" in column one of Index entries for "selected" messages
  3089. so it can't be used to search for selected messages (use "Zoom").
  3090.  
  3091. <P>
  3092. <End of help on this topic>
  3093. </BODY>
  3094. </HTML>
  3095. ======= h_view_cmd_whereis =======
  3096. <HTML>
  3097. <HEAD>
  3098. <TITLE>WhereIs Command</TITLE>
  3099. </HEAD>
  3100. <BODY>
  3101. <H1>WhereIs Command</H1>
  3102.  
  3103. The WhereIs
  3104. (<!--chtml if pinemode="function_key"-->F8<!--chtml else-->W<!--chtml endif-->)
  3105. command does a "find in current message" operation.  You
  3106. type in text and Pine will try to find it in the message you are
  3107. reading.  You can also use WhereIs to jump to the beginning (Ctrl-Y)
  3108. or end (Ctrl-V) of the message.
  3109. That is, to rapidly move to the end of a message, hit the 
  3110. <!--chtml if pinemode="function_key"-->F8<!--chtml else-->W<!--chtml endif-->
  3111. (or Ctrl-W) key followed
  3112. by Ctrl-V.  Similarly,
  3113. <!--chtml if pinemode="function_key"-->F8<!--chtml else-->W<!--chtml endif-->
  3114. followed by Ctrl-Y will take you to the beginning of a message.
  3115.  
  3116. <P>
  3117. <End of help on this topic>
  3118. </BODY>
  3119. </HTML>
  3120. ======= h_view_cmd_hilite =======
  3121. <HTML>
  3122. <HEAD>
  3123. <TITLE>View Hilite and Next item/Previous item</TITLE>
  3124. </HEAD>
  3125. <BODY>
  3126. <H1>View Hilite and Next item/Previous item</H1>
  3127.  
  3128. Sometimes messages may be in the form of formatted HTML text
  3129. or they may contain URLs or Web server hostnames.
  3130. When any of the features
  3131. <A HREF="h_config_enable_view_url">"enable-msg-view-urls"</A>,
  3132. <A HREF="h_config_enable_view_web_host">"enable-msg-view-web-hostnames"</A>,
  3133. <A HREF="h_config_enable_view_attach">"enable-msg-view-attachments"</A>,
  3134. or
  3135. <A HREF="h_config_enable_view_addresses">"enable-msg-view-addresses"</A>
  3136. are enabled, Pine will represent such selectable items in the text
  3137. in bold typeface.  One of the selectable items will be displayed in
  3138. inverse video (hilited).  This is the "currently selected" item.
  3139. Press the Return key to view the currently selected item.
  3140. <P>
  3141.  
  3142. The Up and Down Arrows keys can be used to change the selected item
  3143. (also see the feature
  3144. <A HREF="h_config_enable_view_arrows">"enable-msg-view-forced-arrows"</A>).
  3145. If there are no selectable items in the direction of the arrow you
  3146. pressed, Pine will scroll the display in that direction until one
  3147. becomes visible.  To "jump" forwards/backwards among selectable 
  3148. items in the message text, use the Previous and Next item commands,
  3149. <!--chtml if pinemode="function_key"-->F5 and F6
  3150. <!--chtml else-->^B and Ctrl-F<!--chtml endif-->.
  3151.  
  3152. <P>
  3153. <End of help on this topic>
  3154. </BODY>
  3155. </HTML>
  3156. ======= h_view_cmd_viewattch =======
  3157. <HTML>
  3158. <HEAD>
  3159. <TITLE>ViewAttch Command</TITLE>
  3160. </HEAD>
  3161. <BODY>
  3162. <H1>ViewAttch Command</H1>
  3163.  
  3164.  
  3165. The View/Save Attachment
  3166. (<!--chtml if pinemode="function_key"-->F4<!--chtml else-->V<!--chtml endif-->)
  3167. command allows you to handle MIME attachments to a message you have
  3168. received.  Pine shows you a list of the message attachments -- you just
  3169. choose the attachment you want.  You may either view or save the
  3170. selected attachment.
  3171.  
  3172. <P>
  3173. Because many attachments require external programs for display, there
  3174. is some system configuration that has to happen before you can
  3175. actually display attachments.  Hopefully much of that will have been
  3176. done already by your system administrator.  MIME configuration is
  3177. handled with the "mailcap" configuration file.  (See the section 
  3178. on configuration in the
  3179. <A HREF="h_news">release notes</A> for more information.)
  3180.  
  3181. <P>
  3182. <End of help on this topic>
  3183. </BODY>
  3184. </HTML>
  3185. ======= h_index_cmd_expunge =======
  3186. <HTML>
  3187. <HEAD>
  3188. <TITLE>Expunge/Exclude Command</TITLE>
  3189. </HEAD>
  3190. <BODY>
  3191. <H1>Expunge/Exclude Command</H1>
  3192.  
  3193. Expunge/Exclude
  3194. (<!--chtml if pinemode="function_key"-->F3<!--chtml else-->X<!--chtml endif-->)
  3195. is the command Pine uses to actually remove all messages
  3196. marked for deletion.  With regular email files, expunge literally deletes
  3197. the text from the current folder.  With newsgroups or shared mailboxes,
  3198. you don't have permission to actually remove the message, so it is an
  3199. exclude -- Pine removes the message from your view of the folder even
  3200. though it is not technically gone.
  3201. <P>
  3202.  
  3203. The configuration features
  3204. <A HREF="h_config_auto_expunge">"expunge-without-confirm"</A>
  3205. and
  3206. <A HREF="h_config_full_auto_expunge">"expunge-without-confirm-everywhere"</A>
  3207. affect the behavior of the Expunge command.
  3208.  
  3209. <P>
  3210. <End of help on this topic>
  3211. </BODY>
  3212. </HTML>
  3213. ======= h_common_compose =======
  3214. <HTML>
  3215. <HEAD>
  3216. <TITLE>Compose Command</TITLE>
  3217. </HEAD>
  3218. <BODY>
  3219. <H1>Compose Command</H1>
  3220.  
  3221. The Compose command takes you into the Pine message composer where you
  3222. can start a new message for sending.  This is where you type in the
  3223. message's text and specify its recipient list (the "To:"
  3224. address), where copies should be directed (e.g., "Fcc",
  3225. "Cc:" or "Bcc:"), and which files, if any, should
  3226. be attached to the message.
  3227.  
  3228. <P>
  3229. When you type this command, Pine will also automatically check for any
  3230. interrupted (i.e., a message that was being composed when your modem
  3231. or network connection was broken) or previously postponed messages and
  3232. offer you a chance to continue working on those.
  3233.  
  3234. <P>
  3235. <UL>   
  3236. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  3237. </UL><P>
  3238. <End of help on this topic>
  3239. </BODY>
  3240. </HTML>
  3241. ======= h_common_index =======
  3242. <HTML>
  3243. <HEAD>
  3244. <TITLE>Message Index Command</TITLE>
  3245. </HEAD>
  3246. <BODY>
  3247. <H1>Message Index Command</H1>
  3248.  
  3249. The Index command takes you to the MESSAGE INDEX screen which displays a
  3250. summary caption for each message in the currently-open folder. One
  3251. message will be highlighted; this is the "Current" message.
  3252. The message commands available from this screen (e.g. View, Reply,
  3253. Forward, Delete, Print, Save, etc) apply to the current message.
  3254.  
  3255. <P>
  3256. <End of help on this topic>
  3257. </BODY>
  3258. </HTML>
  3259. ======= h_common_folders =======
  3260. <HTML>
  3261. <HEAD>
  3262. <TITLE>Folder List Command</TITLE>
  3263. </HEAD>
  3264. <BODY>
  3265. <H1>Folder List Command</H1>
  3266.  
  3267. This Folder List command takes you to the FOLDER LIST screen which displays
  3268. the names of all your message folders and allows you to view, rename,
  3269. delete, and add folders.  You can open (view) a different folder than the
  3270. one currently open by highlighting the desired one (using the arrow keys
  3271. or their control-key equivalents) and pressing RETURN.
  3272.  
  3273. <P>
  3274. If you have multiple folder collections defined (see the Help text for
  3275. the FOLDER LIST screen to learn more about Collections), you may need
  3276. to press Return to expand the collection and display all of the
  3277. folders in it.
  3278.  
  3279. <P>
  3280. <End of help on this topic>
  3281. </BODY>
  3282. </HTML>
  3283. ======= h_main_addrbook =======
  3284. <HTML>
  3285. <HEAD>
  3286. <TITLE>Address Book Command</TITLE>
  3287. </HEAD>
  3288. <BODY>
  3289. <H1>Address Book Command</H1>
  3290.  
  3291. This command, available only from the MAIN MENU, takes you
  3292. to the ADDRESS BOOK management screen.  From here, your personal address
  3293. book(s) may be updated.
  3294.  
  3295. <P>
  3296. <End of help on this topic>
  3297. </BODY>
  3298. </HTML>
  3299. ======= h_main_setup =======
  3300. <HTML>
  3301. <HEAD>
  3302. <TITLE>Setup Command</TITLE>
  3303. </HEAD>
  3304. <BODY>
  3305. <H1>Setup Command</H1>
  3306.  
  3307. The Setup command, available only from the MAIN MENU, prompts you for
  3308. one of several configuration screens, including the SETUP CONFIGURATION 
  3309. screen, by which you may activate optional Pine features.
  3310.  
  3311. <P>
  3312. <End of help on this topic>
  3313. </BODY>
  3314. </HTML>
  3315. ======= h_main_release_notes =======
  3316. <HTML>
  3317. <HEAD>
  3318. <TITLE>Release Notes Command</TITLE>
  3319. </HEAD>
  3320. <BODY>
  3321. <H1>Release Notes Command</H1>
  3322.  
  3323. This command displays information about Pine <!--#echo var="PINE_VERSION"-->,
  3324. as well as pointers to further information such as history and legal notes.
  3325.  
  3326. <P>
  3327. <End of help on this topic>
  3328. </BODY>
  3329. </HTML>
  3330. ======= h_main_kblock =======
  3331. <HTML>
  3332. <HEAD>
  3333. <TITLE>Keyboard Lock Command</TITLE>
  3334. </HEAD>
  3335. <BODY>
  3336. <H1>Keyboard Lock Command</H1>
  3337.  
  3338. This command allows your Pine session to be protected
  3339. during a temporary absence from your terminal.
  3340.  
  3341. <P>
  3342. <End of help on this topic>
  3343. </BODY>
  3344. </HTML>
  3345. ======= h_main_journal =======
  3346. <HTML>
  3347. <HEAD>
  3348. <TITLE>Journal Command</TITLE>
  3349. </HEAD>
  3350. <BODY>
  3351. <H1>Journal Command</H1>
  3352.  
  3353. This command displays a list of all the status messages Pine has
  3354. displayed (on the third line from the bottom of the screen). This may
  3355. be useful if a message disappeared before you had a chance to read it.
  3356.  
  3357. <P>
  3358. <End of help on this topic>
  3359. </BODY>
  3360. </HTML>
  3361. ======= h_common_role =======
  3362. <HTML>
  3363. <HEAD>
  3364. <TITLE>Role Command</TITLE>
  3365. </HEAD>
  3366. <BODY>
  3367. <H1>Role Command</H1>
  3368.  
  3369. The Role command is similar to the Compose command except that it starts
  3370. off by letting you select a <A HREF="h_rules_roles">role</A>
  3371. to be used for the composition.
  3372. You may set up alternate roles by using the Setup command.
  3373.  
  3374. <P>
  3375. <End of help on this topic>
  3376. </BODY>
  3377. </HTML>
  3378. ======= h_common_conditional_cmds =======
  3379. <HTML>
  3380. <HEAD>
  3381. <TITLE>Conditional Commands</TITLE>
  3382. </HEAD>
  3383. <BODY>
  3384. <H1>Conditional Commands</H1>
  3385.  
  3386. The presence or absence of certain commands, particularly in the
  3387. MESSAGE INDEX and MESSAGE TEXT screens, is determined by
  3388. whether or not specific features are set in your Pine configuration.  
  3389. (You can access the SETUP CONFIGURATION screen, where they are found, from 
  3390. Pine's MAIN MENU.)  To see if a desired command's availability is
  3391. conditioned on a feature setting, see the command's help text (hilite
  3392. the phrase associated with the command and hit Return).
  3393.  
  3394. <P>
  3395. Also note that some
  3396. commands may be administratively disabled by your system manager;
  3397. if they don't work, please check with your local help desk.
  3398.  
  3399. <P>
  3400. <UL>   
  3401. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  3402. </UL><P>
  3403. <End of help on this topic>
  3404. </BODY>
  3405. </HTML>
  3406. ======= h_common_pipe =======
  3407. <HTML>
  3408. <HEAD>
  3409. <TITLE>Pipe Command</TITLE>
  3410. </HEAD>
  3411. <BODY>
  3412. <H1>Pipe Command</H1>
  3413.  
  3414. Pipe
  3415. (<!--chtml if pinemode="function_key"-->F12<!--chtml else-->|<!--chtml endif-->)
  3416. allows you to send a message to a specified Unix command for external
  3417. processing.
  3418. This command's availability is controlled by the
  3419. <A HREF="h_config_enable_pipe">"enable-unix-pipe-cmd"</A> 
  3420. feature.
  3421. By default, the processed text of the message is sent to the command
  3422. you specify and the output is captured by Pine and shown to you.
  3423. When you run the pipe command, there are some sub-commands which may be
  3424. used to alter this behavior.
  3425. These sub-commands are described <A HREF="h_pipe_command">here</A>.
  3426.  
  3427. <P>
  3428. <End of help on this topic>
  3429. </BODY>
  3430. </HTML>
  3431. ======= h_common_goto =======
  3432. <HTML>
  3433. <HEAD>
  3434. <TITLE>Goto Command</TITLE>
  3435. </HEAD>
  3436. <BODY>
  3437. <H1>Goto Command</H1>
  3438.  
  3439. Goto
  3440. (<!--chtml if pinemode="function_key"-->F6<!--chtml else-->G<!--chtml endif-->)
  3441. is the command which lets you bypass Pine's folder selection screens
  3442. and jump directly to a new folder.  You can select any folder in the
  3443. world: one in your current collection, one in a different collection or
  3444. one in a collection you've never even used before.
  3445. <P>
  3446.  
  3447. Pine will help you as much as possible to narrow in on the folder you want.
  3448. However, if the folder is outside of your defined collections, you are
  3449. going to have to enter the exact folder location using the correct
  3450. <A HREF="h_valid_folder_names">syntax</A>
  3451. for a remote folder and/or fully-qualified path name.
  3452.  
  3453. <P>
  3454. <End of help on this topic>
  3455. </BODY>
  3456. </HTML>
  3457. ======= h_common_nextnew =======
  3458. <HTML>
  3459. <HEAD>
  3460. <TITLE>NextNew Command</TITLE>
  3461. </HEAD>
  3462. <BODY>
  3463. <H1>NextNew Command</H1>
  3464.  
  3465. When you press the TAB key, Pine advances to the next
  3466. "interesting" message.  When you are using Pine to read
  3467. email, that message is the next message in the current folder which you have
  3468. not read before or which you have previously marked
  3469. "Important" via the Flag command.  When reading news
  3470. folders, the next "interesting" message is the next one
  3471. which you have not yet deleted.
  3472. <P>
  3473.  
  3474. The NextNew command's behavior is affected by the configuration features
  3475. <A HREF="h_config_auto_open_unread">"auto-open-next-unread"</A>
  3476. and
  3477. <A HREF="h_config_tab_new_only">"tab-visits-next-new-message-only"</A>.
  3478.  
  3479. <P>
  3480. <End of help on this topic>
  3481. </BODY>
  3482. </HTML>
  3483. ======= h_common_jump =======
  3484. <HTML>
  3485. <HEAD>
  3486. <TITLE>Jump Command</TITLE>
  3487. </HEAD>
  3488. <BODY>
  3489. <H1>Jump Command</H1>
  3490.  
  3491. This is Pine's way of allowing you to go straight to a specific message.
  3492. Just press "J" and then enter the message number.  Pine can also be
  3493. configured such that typing in any number automatically jumps you to that
  3494. message 
  3495. (<A HREF="h_config_enable_jump">"enable-jump-shortcut"</A> 
  3496. in the SETUP CONFIGURATION).
  3497.  
  3498. <P>
  3499. <End of help on this topic>
  3500. </BODY>
  3501. </HTML>
  3502. ======= h_common_flag =======
  3503. <HTML>
  3504. <HEAD>
  3505. <TITLE>Flag Command</TITLE>
  3506. </HEAD>
  3507. <BODY>
  3508. <H1>Flag Command</H1>
  3509.  
  3510. Flag
  3511. (<!--chtml if pinemode="function_key"-->F11<!--chtml else-->*<!--chtml endif-->)
  3512. is the command which allows users to manipulate the status flags which
  3513. appear on the left side of the MESSAGE INDEX screen.  The most common
  3514. use of this is to mark a message as important. This is something of a
  3515. note to yourself to get back to that message.  You can also use the
  3516. flag command to set (or unset) the flags which indicate that a message
  3517. is new, answered, or deleted.<P>
  3518.  
  3519. The availability of the flag command is determined by the
  3520. <A HREF="h_config_enable_flag">"enable-flag-cmd"</A>
  3521. feature in your Pine configuration. Also, it is possible that Flag could be
  3522. administratively disabled by your system manager; if it doesn't work,
  3523. please check with your local help desk before reporting a bug.
  3524.  
  3525. <P>
  3526. <End of help on this topic>
  3527. </BODY>
  3528. </HTML>
  3529. ======= h_common_hdrmode =======
  3530. <HTML>
  3531. <HEAD>
  3532. <TITLE>HdrMode Command</TITLE>
  3533. </HEAD>
  3534. <BODY>
  3535. <H1>HdrMode Command</H1>
  3536.  
  3537. Every email message comes with some header lines that you normally
  3538. don't see (and don't want to see).
  3539. These include anywhere from 3-20 lines (or more) added by the
  3540. Internet mail transport system to record the route your message took,
  3541. for diagnostic purposes.
  3542. These are normally of no import and simply
  3543. add clutter, so Pine suppresses them in the MESSAGE TEXT display.
  3544. This also includes other non-standard headers the message may contain.
  3545. If you want to see these headers, there is a way to reveal them.
  3546. <P>
  3547.  
  3548. The Header Mode
  3549. (<!--chtml if pinemode="function_key"-->F9<!--chtml else-->H<!--chtml endif-->)
  3550. command is a toggle which controls Pine's handling of these header
  3551. lines.  Normally, full headers is "off" and you only see a
  3552. few lines about who a message is to and who it is from.  When you
  3553. press
  3554. (<!--chtml if pinemode="function_key"-->F9<!--chtml else-->H<!--chtml endif-->)
  3555. to turn full headers on, Pine will show you
  3556. the normal header lines as well as delivery headers, comment headers,
  3557. MIME headers, and any other headers present.
  3558. <P>
  3559.  
  3560. Several different Pine commands honor the header mode -- it affects how
  3561. messages are displayed, how they appear in forward and reply email, how
  3562. they are printed, how they are saved, and how they are exported.
  3563. <!--chtml if pinemode="os_windows"-->
  3564. <!--chtml else--> 
  3565. The pipe command is also affected.
  3566. <!--chtml endif-->
  3567. <P>
  3568.  
  3569. The presence or absence of the Header Mode command is determined by the
  3570. <A HREF="h_config_enable_full_hdr">"enable-full-header-cmd"</A>
  3571. feature-list option in your Pine configuration.
  3572.  
  3573. <P>
  3574. <UL>   
  3575. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  3576. </UL><P>
  3577. <End of help on this topic>
  3578. </BODY>
  3579. </HTML>
  3580. ======= h_common_print =======
  3581. <HTML>
  3582. <HEAD>
  3583. <TITLE>Print Command</TITLE>
  3584. </HEAD>
  3585. <BODY>
  3586. <H1>Print Command</H1>
  3587.  
  3588. The Print
  3589. (<!--chtml if pinemode="function_key"-->F9<!--chtml else-->%<!--chtml endif-->)
  3590. command allows you to print a copy of a message.
  3591. There are many SETUP CONFIGURATION features which affect the
  3592. Print command, including
  3593. <A HREF="h_config_enable_y_print">"enable-print-via-y-command"</A>,
  3594. <A HREF="h_config_print_index">"print-index-enabled"</A>,
  3595. <A HREF="h_config_custom_print">"print-offers-custom-cmd-prompt"</A>,
  3596. <A HREF="h_config_print_from">"print-includes-from-line"</A>, and
  3597. <A HREF="h_config_ff_between_msgs">"print-formfeed-between-messages"</A>.
  3598. You set up for printing by using the Printer option of the Setup command
  3599. on the MAIN MENU.
  3600. <P>
  3601.  
  3602. <P>
  3603. <End of help on this topic>
  3604. </BODY>
  3605. </HTML>
  3606. ======= h_common_take =======
  3607. <HTML>
  3608. <HEAD>
  3609. <TITLE>TakeAddr Command</TITLE>
  3610. </HEAD>
  3611. <BODY>
  3612. <H1>TakeAddr Command</H1>
  3613.  
  3614.  
  3615. With the Take Address
  3616. (<!--chtml if pinemode="function_key"-->F10<!--chtml else-->T<!--chtml endif-->)
  3617. command, you can extract email addresses from an
  3618. incoming message and save them in an address book.  This is an easy way
  3619. to add to your address book and avoid having to remember the email
  3620. addresses of the people who write to you.
  3621. <P>
  3622.  
  3623. If the message is just to you individually, then you will only need to
  3624. provide a nickname.  If the message contains more than one email address,
  3625. then you will see an address
  3626. selection screen which lets you choose the address you want to save into
  3627. your address book, or lets you choose several of them add to a
  3628. personal distribution list.
  3629. <P>
  3630.  
  3631. Once you've added an entry to your address book, you can use it from the
  3632. message composer by typing the nickname of the entry into one of the
  3633. header fields (for example, into the To: field), or you can use ^T from
  3634. the header field to select the entry from your address book.
  3635. <P>
  3636.  
  3637. If the configuration feature
  3638. <A HREF="h_config_enable_role_take">"enable-rules-under-take"</A>
  3639. is set, the behavior of the Take command is altered slightly.
  3640.  
  3641. <P>
  3642. <End of help on this topic>
  3643. </BODY>
  3644. </HTML>
  3645. ======= h_common_save =======
  3646. <HTML>
  3647. <HEAD>
  3648. <TITLE>Save and Export Commands</TITLE>
  3649. </HEAD>
  3650. <BODY>
  3651. <H1>Save and Export Commands</H1>
  3652.  
  3653. Save
  3654. (<!--chtml if pinemode="function_key"-->F11<!--chtml else-->S<!--chtml endif-->)
  3655. and Export
  3656. (<!--chtml if pinemode="function_key"-->F12<!--chtml else-->E<!--chtml endif-->)
  3657. are the two alternatives Pine gives you to keep a copy of the message
  3658. you are reading. If you want to keep the message within Pine's email
  3659. world, use "save"; if you want to use the message in another
  3660. program, use "export".
  3661. <P>
  3662.  
  3663. When you save a message, it is put into an existing folder or into a new
  3664. folder in one of your existing folder collections.  The message stays in
  3665. email format and can be read by Pine again.  Pine may use a special format
  3666. for its mail folders -- never edit a Pine folder by hand or with any
  3667. program other than Pine.  The exact behavior of the save command can be
  3668. configured with the
  3669. <A HREF="h_config_quote_all_froms">"save-will-quote-leading-froms"</A>,
  3670. <A HREF="h_config_save_wont_delete">"save-will-not-delete"</A>,
  3671. and 
  3672. <A HREF="h_config_save_advances">"save-will-advance"</A>
  3673. feature list settings.
  3674. <P>
  3675.  
  3676. When you use export, the message is placed in a plain text file in your
  3677. home directory 
  3678. <!--chtml if pinemode="running"-->
  3679. (which, in the present configuration of your system, is
  3680.  "<!--#echo var="HOME_DIR"-->") 
  3681. <!--chtml endif-->
  3682. or current working directory
  3683. <!--chtml if pinemode="running"-->
  3684. (which, at least for your current Pine "session," 
  3685. is "<!--#echo var="CURRENT_DIR"-->") 
  3686. <!--chtml endif-->, depending on the
  3687. <A HREF="h_config_use_current_dir">"use-current-dir"</A>
  3688. configuration setting.  In the normal case, only minimal
  3689. headers are exported with the message; however, if the full header mode 
  3690. (whose availability must be enabled  by setting the feature 
  3691. <A HREF="h_config_enable_full_hdr">"enable-full-header-cmd"</A>
  3692. in SETUP CONFIGURATION) is
  3693. toggled on, then complete headers are exported along with the message
  3694. text. (If you have any <A HREF="h_config_display_filters">Display-Filters</A>
  3695. defined, they may affect the contents of the exported file.)
  3696.  
  3697. <P>
  3698. <End of help on this topic>
  3699. </BODY>
  3700. </HTML>
  3701. ======= h_common_bounce =======
  3702. <HTML>
  3703. <HEAD>
  3704. <TITLE>Bounce Command</TITLE>
  3705. </HEAD>
  3706. <BODY>
  3707. <H1>Bounce Command</H1>
  3708.  
  3709. The Bounce 
  3710. (<!--chtml if pinemode="function_key"-->F10<!--chtml else-->B<!--chtml endif-->)
  3711. command allows you to re-send, or "remail", a
  3712. message, as if you were never in the loop.  It is analogous to crossing
  3713. out your address on a postal letter, writing a different address on the
  3714. envelope, and putting it into the mailbox. Bounce is used primarily to
  3715. redirect email which was sent to you in error.
  3716. Also, some owners of email
  3717. lists need the bounce command to handle list traffic.
  3718. Bounce is not anonymous.
  3719. A ReSent-From header is added to the message so that the recipient may
  3720. tell that you Bounced it to them.
  3721. <P>
  3722.  
  3723. The presence or absence of the Bounce command is determined by the
  3724. <A HREF="h_config_enable_bounce">"enable-bounce-cmd"</A>
  3725. feature in your Pine configuration.
  3726. The feature
  3727. <A HREF="h_config_fcc_on_bounce">"fcc-on-bounce"</A>
  3728. affects the behavior of the Bounce command.
  3729. Also, it is possible that Bounce could be
  3730. administratively disabled by your system manager; if it doesn't work,
  3731. please check with your local help desk before reporting a bug.
  3732.  
  3733. <P>
  3734. <End of help on this topic>
  3735. </BODY>
  3736. </HTML>
  3737. ======= h_common_reply =======
  3738. <HTML>
  3739. <HEAD>
  3740. <TITLE>Reply and Forward Commands</TITLE>
  3741. </HEAD>
  3742. <BODY>
  3743.  
  3744. <H1>Reply and Forward Commands</H1>
  3745.  
  3746. Replying 
  3747. (<!--chtml if pinemode="function_key"-->F11<!--chtml else-->R<!--chtml endif-->)
  3748. and Forwarding 
  3749. (<!--chtml if pinemode="function_key"-->F12<!--chtml else-->F<!--chtml endif-->)
  3750. are your two alternatives for following up on the
  3751. message you are reading.  You would use reply if you want to get email
  3752. back to the author of the message and/or the other people who have
  3753. already seen it.  You use forward if you want somebody new to see the
  3754. message.
  3755. <P>
  3756.  
  3757. In the normal case, the only thing that you must supply when forwarding a
  3758. message is the name/email address of the new recipient.
  3759. Pine will include the text of the forwarded message.
  3760. Pine will also include any attachments to the message.
  3761. There is space above the forwarded text for you to include additional comments.
  3762. <P>
  3763.  
  3764. When replying, you usually have to answer some questions.
  3765. If the message is to multiple people and/or specified with a Reply-To: header,
  3766. then you will have to decide who should get the reply.
  3767. You also need to decide whether or not to include the previous
  3768. message in your reply.
  3769. Some of this is configurable.
  3770. Specifically, see the
  3771. <A HREF="h_config_include_header">"include-header-in-reply"</A>,
  3772. <A HREF="h_config_auto_include_reply">"include-text-in-reply"</A>,
  3773. <A HREF="h_config_attach_in_reply">"include-attachments-in-reply"</A>,
  3774. and
  3775. <A HREF="h_config_auto_reply_to">"reply-always-uses-reply-to"</A>
  3776. configuration features.
  3777. <P>
  3778.  
  3779. Both the Reply and Forward commands react to the full header mode toggle.
  3780. If the full header mode is on, then all the header and delivery lines are
  3781. included with the text of the message in your reply/forward.
  3782. <P>
  3783.  
  3784. Other configuration features which affect the Reply command are
  3785. <A HREF="h_config_sig_at_bottom">"signature-at-bottom"</A>,
  3786. <A HREF="h_config_sigdashes">"enable-sigdashes"</A>, and
  3787. <A HREF="h_config_strip_sigdashes">"strip-from-sigdashes-on-reply"</A>.
  3788.  
  3789. <P>
  3790. <End of help on this topic>
  3791. </BODY>
  3792. </HTML>
  3793. ======= h_common_delete =======
  3794. <HTML>
  3795. <HEAD>
  3796. <TITLE>Delete and Undelete Commands</TITLE>
  3797. </HEAD>
  3798. <BODY>
  3799. <H1>Delete and Undelete Commands</H1>
  3800.  
  3801. Delete 
  3802. (<!--chtml if pinemode="function_key"-->F9<!--chtml else-->D<!--chtml endif-->)
  3803. and Undelete 
  3804. (<!--chtml if pinemode="function_key"-->F10<!--chtml else-->U<!--chtml endif-->)
  3805. allow you to change the Deleted flag for the current message.
  3806. Delete marks a message Deleted (turns on the Deleted flag) and Undelete
  3807. removes the mark.
  3808. In the MESSAGE INDEX, deleted messages have a "D" in the status field
  3809. at the left hand edge of the index line.
  3810. When viewing a deleted message, the letters "DEL" will be present
  3811. in the upper right hand corner of the screen.
  3812. Delete simply <EM>marks</EM> a message Deleted, it does not actually
  3813. get rid of the message.
  3814. The eXpunge command (available from the MESSAGE INDEX screen) actually
  3815. removes all of the deleted messages in a folder.
  3816. Once a message is eXpunged, it can't be retrieved.
  3817. <P>
  3818.  
  3819. The Delete command is affected by the setting of the configuration feature
  3820. <A HREF="h_config_del_skips_del">"delete-skips-deleted"</A>.
  3821.  
  3822. <P>
  3823. <End of help on this topic>
  3824. </BODY>
  3825. </HTML>
  3826. ======= h_common_postpone =======
  3827. <HTML>
  3828. <HEAD>
  3829. <TITLE>Postpone Command</TITLE>
  3830. </HEAD>
  3831. <BODY>
  3832. <H1>Postpone Command</H1>
  3833.  
  3834. The postpone
  3835. <!--chtml if pinemode="function_key"-->(F11)<!--chtml else-->(^O)<!--chtml endif-->
  3836. command allows you to temporarily stop working on the current
  3837. message so you may read
  3838. other messages or compose another message.  When you want to resume a
  3839. message later, start to compose and answer "yes" to the
  3840. "Continue postponed composition?" question.  You may
  3841. postpone as many messages as you like.
  3842.  
  3843. <P>
  3844. Note: If a <A HREF="h_config_form_folder">form-letter-folder</A> is defined
  3845. in the Setup/Config screen, then the Postpone command will prompt you for
  3846. the folder in which to store your outgoing message.
  3847.  
  3848. <P>
  3849. <End of help on this topic>
  3850. </BODY>
  3851. </HTML>
  3852. ======= h_compose_cancel =======
  3853. <HTML>
  3854. <HEAD>
  3855. <TITLE>Cancel Command</TITLE>
  3856. </HEAD>
  3857. <BODY>
  3858. <H1>Cancel Command</H1>
  3859.  
  3860. Cancel
  3861. <!--chtml if pinemode="function_key"-->
  3862. (F2)
  3863. <!--chtml else-->
  3864. (^C) 
  3865. <!--chtml endif-->
  3866.  
  3867. The Cancel command returns you to Pine's normal mail processing and
  3868. causes the message currently under composition to be thrown out.
  3869. The message text <EM>will be lost</EM>.
  3870.  
  3871. <P>
  3872. Note: Unless the <A HREF="h_config_quell_dead_letter">quell-dead-letter-on-cancel</A> has been set, the text of the most recent composition cancelled
  3873. will be preserved in the file named
  3874. <!--chtml if pinemode="os_windows"-->
  3875. "DEADLETR".
  3876. <!--chtml else-->
  3877. "dead.letter" in your home directory.
  3878. <!--chtml endif-->
  3879. If you unintentionally cancel a message, look there for its text.
  3880.  
  3881. <P>
  3882. <End of help on this topic>
  3883. </BODY>
  3884. </HTML>
  3885. ======= h_compose_richhdr =======
  3886. <HTML>
  3887. <HEAD>
  3888. <TITLE>Rich Header Command</TITLE>
  3889. </HEAD>
  3890. <BODY>
  3891. <H1>Rich Header Command</H1>
  3892.  
  3893. The Rich Header command allows you to toggle between the list of 
  3894. all message headers available for editing and those that are most
  3895. common.
  3896.  
  3897. <P>
  3898. You would use this toggle to expose, for example, the "Bcc:" or
  3899. "Fcc:" header which aren't usually necessary to set (and thus
  3900. not displayed by default), but are sometimes helpful.
  3901.  
  3902. <P>
  3903. <End of help on this topic>
  3904. </BODY>
  3905. </HTML>
  3906. ======= h_compose_send =======
  3907. <HTML>
  3908. <HEAD>
  3909. <TITLE>Send Command</TITLE>
  3910. </HEAD>
  3911. <BODY>
  3912. <H1>Send Command</H1>
  3913.  
  3914. The Send command
  3915. <!--chtml if pinemode="function_key"-->
  3916. (F3)
  3917. <!--chtml else-->
  3918. (^X) 
  3919. <!--chtml endif-->
  3920. tells Pine you are finished composing.
  3921. Before actually sending it, though, Pine will ask you to confirm 
  3922. your intention, and, at the same time, redisplayed the message text
  3923. with the recipients at the top of the screen to give you the opportunity
  3924. to review and verify that the message is addressed to the people
  3925. you intended.
  3926.  
  3927. <P>
  3928. This confirmation prompt may also offer, depending
  3929. on your particular Setup/Config, options allowing you to set
  3930. <A HREF="h_config_compose_dsn">delivery status notifications</A>,
  3931. include attachments in the "Fcc" (if you had previously
  3932. specified that they <A HREF="h_config_no_fcc_attach">exclude attachments</A>, 
  3933. observe details of the
  3934. <A HREF="h_config_verbose_post">message submission process</A>,
  3935. or choose the utility though which the
  3936. <A HREF="h_config_sending_filter">outgoing text should first pass</A>.
  3937.  
  3938. <P>
  3939. <End of help on this topic>
  3940. </BODY>
  3941. </HTML>
  3942. ======= h_compose_markcutpaste =======
  3943. <HTML>
  3944. <HEAD>
  3945. <TITLE>Mark, Cut and Paste Commands</TITLE>
  3946. </HEAD>
  3947. <BODY>
  3948. <H1>Mark, Cut and Paste Commands</H1>
  3949.  
  3950. You can define a "block" of text, which can subsequently
  3951.  be deleted or
  3952. copied as a unit, by setting a mark at the start of the block (Ctrl-^) and
  3953. then moving the cursor to the end of the desired text block.  You can then
  3954. "cut" the block out 
  3955. <!--chtml if pinemode="function_key"-->
  3956. "F9",
  3957. <!--chtml else-->
  3958. "Ctrl-K",
  3959. <!--chtml endif-->
  3960. move the cursor, and "paste" it
  3961. <!--chtml if pinemode="function_key"-->
  3962. "F10",
  3963. <!--chtml else-->
  3964. "Ctrl-U",
  3965. <!--chtml endif-->
  3966. in the new location.  Also, you can paste more than once, allowing you
  3967. to use this feature to copy a block of text.<P>
  3968.  
  3969. If you press 
  3970. <!--chtml if pinemode="function_key"-->
  3971. "F9"
  3972. <!--chtml else-->
  3973. "^K"
  3974. <!--chtml endif-->
  3975. without having marked anything, Pine will delete
  3976. a single line.  If you delete a group of lines together, Pine keeps them
  3977. in the same buffer, so 
  3978. <!--chtml if pinemode="function_key"-->
  3979. F10
  3980. <!--chtml else-->
  3981. ^U
  3982. <!--chtml endif-->
  3983. will restore them as a block.  About
  3984. terminology:  Mark is shown as "^^".  The first "^" means you should
  3985. hold down the "Control" key on your keyboard.  The second "^" means
  3986. "type the character ^".
  3987.  
  3988. <P>
  3989. <End of help on this topic>
  3990. </BODY>
  3991. </HTML>
  3992. ======= h_compose_justify =======
  3993. <HTML>
  3994. <HEAD>
  3995. <TITLE>Justify Command</TITLE>
  3996. </HEAD>
  3997. <BODY>
  3998. <H1>Justify Command</H1>
  3999.  
  4000. The Justify
  4001. <!--chtml if pinemode="function_key"-->
  4002. (F4)
  4003. <!--chtml else-->
  4004. (^J) 
  4005. <!--chtml endif-->
  4006. command reformats the text in the paragraph the cursor is in.
  4007. Paragraphs are separated by one blank line or a line beginning with a space.
  4008. This is useful when you have been editing a paragraph and the lines become
  4009. uneven.  The text is left aligned or justified and the right is ragged.  If
  4010. the text is already justified as typed with auto-wrap, no justification will
  4011. be done.
  4012.  
  4013. <P>
  4014. When composing a reply containing included text, the justify command
  4015. will reformat text to the right of the 
  4016. "<A HREF="h_config_reply_indent_string">reply-indent-string</A>",
  4017. adding or removing indented lines as needed.  Paragraphs are separated
  4018. by a blank line, a line containing only the reply-indent-string, or a
  4019. line containing the indent string and one or more blank spaces.
  4020. Included text that was previously indented (or "quoted") is
  4021. not preserved.
  4022.  
  4023. <P>
  4024. <End of help on this topic>
  4025. </BODY>
  4026. </HTML>
  4027. ======= h_compose_spell =======
  4028. <HTML>
  4029. <HEAD>
  4030. <TITLE>Spell Check Command</TITLE>
  4031. </HEAD>
  4032. <BODY>
  4033. <H1>Spell Check Command</H1>
  4034.  
  4035. The "To Spell"
  4036. <!--chtml if pinemode="function_key"-->
  4037. (F12)
  4038. <!--chtml else-->
  4039. (^T) 
  4040. <!--chtml endif-->
  4041. command calls an external spell checking program to look over the
  4042. message you are composing.  By default, Pine uses the simple Unix
  4043. spell checker.
  4044.  
  4045. <P>
  4046. Under the default configuration, there are no suggested alternative
  4047. spellings, but Pine
  4048. will show you the "incorrect" word and let you fix it or
  4049. move on.  If a word is misspelled more than once, then you will be
  4050. prompted to confirm the correction of each occurrence of it.  Lines
  4051. beginning with "> " (included messages) will not be checked.
  4052.  
  4053. <P>
  4054. If your system has a spell checking utility that does offer alternatives
  4055. or otherwise improves on the default, the Setup/Config Menu's
  4056. "<A HREF="h_config_speller">speller</A>" option will tell
  4057. Pine to use it instead.
  4058.  
  4059. <P>
  4060. <End of help on this topic>
  4061. </BODY>
  4062. </HTML>
  4063. ======= h_compose_alted =======
  4064. <HTML>
  4065. <HEAD>
  4066. <TITLE>Alt Editor Command</TITLE>
  4067. </HEAD>
  4068. <BODY>
  4069. <H1>Alt Editor Command</H1>
  4070.  
  4071. The "Alt Editor" command's availability depends on the
  4072. Setup/Config variable "<A HREF="h_config_editor">editor</A>".
  4073.  
  4074. <P>
  4075. When the variable specifies a valid editor on your system, this
  4076. command will launch it with the current text of your message
  4077. already filled in.
  4078.  
  4079. <P>
  4080. <End of help on this topic>
  4081. </BODY>
  4082. </HTML>
  4083. ======= h_compose_readfile =======
  4084. <HTML>
  4085. <HEAD>
  4086. <TITLE>Read File Command</TITLE>
  4087. </HEAD>
  4088. <BODY>
  4089. <H1>Read File Command</H1>
  4090.  
  4091. The "Read File"
  4092. <!--chtml if pinemode="function_key"-->
  4093. (F5)
  4094. <!--chtml else-->
  4095. (^R) 
  4096. <!--chtml endif-->
  4097. command allows you to copy in text from an existing file. You will be
  4098. prompted for the name of a file to be inserted into the message.  The file
  4099. name is relative to your home directory 
  4100. <!--chtml if pinemode="running"-->
  4101. (which, in the present configuration of your system, is
  4102.  "<!--#echo var="HOME_DIR"-->") 
  4103. <!--chtml endif-->
  4104. or current working directory
  4105. <!--chtml if pinemode="running"-->
  4106. (which, at least for your current Pine "session," 
  4107. is "<!--#echo var="CURRENT_DIR"-->") 
  4108. <!--chtml endif-->, depending on the
  4109. <A HREF="h_config_use_current_dir">"use-current-dir"</A>
  4110. configuration setting; or, the file name must be specified as a full path name 
  4111. <!--chtml if pinemode="os_windows"-->
  4112. -- for example: "A:\PAPER.TXT"
  4113. <!--chtml else-->
  4114. -- for example: "/tmp/wisdom-of-the-day"
  4115. <!--chtml endif-->
  4116. (without the quotation marks).
  4117.  
  4118. <P>
  4119. The file will be inserted where the cursor is located.  <B>The
  4120. file to be read must be on the same system as Pine.</B> If you use Pine on a
  4121. Unix machine but have files on a PC or Mac, the files must be transferred
  4122. to the system Pine is running on before they can be read.  Please ask your
  4123. local computer support people about the correct way to transfer a file to 
  4124. your Pine system.
  4125.  
  4126. <P>
  4127. <End of help on this topic>
  4128. </BODY>
  4129. </HTML>
  4130. ======= h_config_tray_icon =======
  4131. <HTML>
  4132. <HEAD>
  4133. <TITLE>OPTION: enable-tray-icon</TITLE>
  4134. </HEAD>
  4135. <BODY>
  4136. <H1>OPTION: enable-tray-icon</H1>
  4137.  
  4138. This option restores a behavior of previous versions of PC-Pine.
  4139. These
  4140. versions, when started, installed a PC-Pine icon in the notification 
  4141. tray of Window's Taskbar.  The primary use of this icon was to indicate
  4142. new mail arrival by turning red (while the Taskbar icon remained green).
  4143.  
  4144. <P>
  4145. Rather than add another icon to the Taskbar, this version of PC-Pine will 
  4146. color its Taskbar entry's icon red (as well as the icon in the Window
  4147. Title).  This feature is only provided for backwards compatibility.
  4148.  
  4149. <P>
  4150. <End of help on this topic>
  4151. </BODY>
  4152. </HTML>
  4153. ======= h_common_suspend =======
  4154. <HTML>
  4155. <HEAD>
  4156. <TITLE>Suspend Command</TITLE>
  4157. </HEAD>
  4158. <BODY>
  4159. <H1>Suspend Command</H1>
  4160.  
  4161. With the <A HREF="h_config_can_suspend">enable-suspend</A> feature
  4162. enabled, you can, at almost any time, temporarily halt your Pine session,
  4163. <!--chtml if pinemode="os_windows"-->
  4164. minimizing it into an icon.
  4165. <!--chtml else-->
  4166. and return to your system prompt.
  4167. <!--chtml endif-->
  4168.  
  4169. <P>
  4170. <End of help on this topic>
  4171. </BODY>
  4172. </HTML>
  4173. ======= h_pipe_command =======
  4174. <HTML>
  4175. <HEAD>
  4176. <TITLE>Pipe Command SubOptions</TITLE>
  4177. </HEAD>
  4178. <BODY>
  4179. <H1>Pipe Command SubOptions</H1>
  4180.  
  4181. By default, when you use the Pipe command, the processed text of the
  4182. message is sent to the Unix command
  4183. you specify and the output is captured by Pine and shown to you.
  4184. There are some sub-commands which may be used to alter this behavior.
  4185. These are toggles which switch the behavior between two possibilities.
  4186. They can be combined in any way you wish.
  4187. They are:
  4188. <DL>
  4189.    <DT>Shown Text or Raw Text</DT>
  4190.    <DD>This option toggles between sending the shown (processed) text
  4191. of the message to the Unix command, and sending the
  4192. raw (unprocessed) text of the message to the Unix command.
  4193. The default is to send the shown text.
  4194. The raw version of the message will contain all of the headers and any
  4195. MIME encoding that the message contains.
  4196. You can experiment with this option by piping to something simple like the
  4197. Unix "cat" command.
  4198.    </DD>
  4199.    <DT>Captured Output or Free Output</DT>
  4200.    <DD>This option toggles between having Pine capture the output of
  4201. the Unix pipe command for display, and not capturing it.
  4202. If the command you are piping to is a filter which will produce output
  4203. you want to view, then you want to capture that output
  4204. for display (the default).
  4205. If the Unix command doesn't produce output or handles the display itself,
  4206. then you want free output.
  4207.    </DD>
  4208.    <DT>No Delimiter or With Delimiter</DT>
  4209.    <DD>This option controls whether or not a Unix mailbox style delimiter
  4210. will come before the text of the message.
  4211. This is the delmiter used in the common Unix mailbox format.
  4212. It's the single line which begins with the five characters
  4213. "From" followed by a <SPACE> character.
  4214. You'll usually only want to include this if the Unix command requires
  4215. input in the format of a traditional Unix mailbox file.
  4216.    </DD>
  4217.    <DT>To Same Pipe or To Individual Pipes</DT>
  4218.    <DD>This option only shows up if you are running an aggregate
  4219. pipe command.
  4220. That is, the command was Apply Pipe, not just Pipe.
  4221. You have the option of piping all of the selected messages through a
  4222. single pipe to a single instance of the Unix command,
  4223. or piping each individual message through a separate pipe to separate
  4224. instances of the Unix command.
  4225. The default is that all of the output will go through a single pipe
  4226. to a single instance of the command.
  4227. You can try this option with a command like "less", with Free
  4228. Output enabled.
  4229.    </DD>
  4230. </DL>
  4231.  
  4232. <P>
  4233. <End of help on this topic>
  4234. </BODY>
  4235. </HTML>
  4236. ============= h_simple_index ========================
  4237. <HTML>
  4238. <HEAD>
  4239. <TITLE>SELECT POSTPONED MESSAGE</TITLE>
  4240. </HEAD>
  4241. <BODY>
  4242. <H1>POSTPONED MESSAGE SELECTION COMMANDS</H1>
  4243. <!--chtml if pinemode="function_key"-->
  4244. <PRE>
  4245. Navigating the List of Messages               General Pine Commands
  4246. -------------------------------               ---------------------
  4247.  F5   Move to previous message                 F1   Show this help text
  4248.  F6   Move to next message
  4249.  F7   Show previous screen of messages
  4250.  F8   Show next screen of messages
  4251.  
  4252. Message Selection Commands
  4253. --------------------------
  4254.  F3   Exit the Message Select menu (canceling Send command)
  4255.  F4   Select the currently highlighted message
  4256.  F9   Mark the currently highlighted message as deleted
  4257.  F10  Undelete (remove deletion mark from) the highlighted message
  4258. </PRE>
  4259. <!--chtml else-->
  4260. <PRE>
  4261. Navigating the List of Messages               General Pine Commands
  4262. -------------------------------               ---------------------
  4263.   P  Move to previous message                  ?  Show this help text
  4264.   N  Move to next message
  4265.   -  Show previous screen of messages
  4266.  Spc Show next screen of messages
  4267.  
  4268. Message Selection Commands
  4269. --------------------------
  4270.   E  Exit the Message Select menu (canceling Send command)
  4271.   S  Select the currently highlighted message
  4272.   D  Mark the currently highlighted message as deleted
  4273.   U  Undelete (remove deletion mark from) the highlighted message
  4274. </PRE>
  4275. <!--chtml endif-->
  4276. <P>
  4277. <H2>Description of the Select Postponed Message Screen</H2>
  4278.  
  4279. This screen allows you to select one of several previously postponed
  4280. messages in order to continue composition.  Your options are very limited
  4281. -- the screen is not meant to let you manipulate these messages.  However,
  4282. you may now delete messages from this list.  Once you choose a message,
  4283. Pine reads it in and puts you into the regular message composer.
  4284. <P>
  4285.  
  4286. Messages do not stay in this postponed state automatically.  If you select
  4287. a message and then want to postpone it again, use the normal postpone
  4288. (Ctrl-O) command in the composer.
  4289. <P>
  4290.  
  4291. If you exit this screen without selecting a message, the Compose command
  4292. which got you here is canceled.  Other than messages explicitly marked
  4293. "Deleted", no messages will be removed.
  4294.  
  4295. <P>
  4296. <End of help on this topic>
  4297. </BODY>
  4298. </HTML>
  4299. ============= h_collection_screen ========================
  4300. <HTML>
  4301. <HEAD>
  4302. <TITLE>COLLECTION LIST screen</TITLE>
  4303. </HEAD>
  4304. <BODY>
  4305. <H1>COLLECTION LIST screen</H1>
  4306.  
  4307. The COLLECTION LIST screen is used to select one of your  
  4308. collection definitions to display the folders they contain.  See
  4309. <A HREF="h_what_are_collections">Folder Collections Explained</A> for 
  4310. detailed explanation of collections.<P>
  4311.  
  4312. To manage your collection definitions (Add, Change, Delete, etc.), use
  4313. the <A HREF="h_collection_maint">Setup/collectionList</A> command on Pine's
  4314. MAIN MENU.
  4315.  
  4316. <P>
  4317. <End of help on this topic>
  4318. </BODY>
  4319. </HTML>
  4320. ============= h_collection_maint ========================
  4321. <HTML>
  4322. <HEAD>
  4323. <TITLE>SETUP COLLECTION LIST screen</TITLE>
  4324. </HEAD>
  4325. <BODY>
  4326. <H1>SETUP COLLECTION LIST screen</H1>
  4327.  
  4328. The SETUP COLLECTION LIST screen lets you manage your collection
  4329. definitions.  See 
  4330. <A HREF="h_what_are_collections">Folder Collections Explained</A> 
  4331. for detailed explanation of collections.<P>
  4332.  
  4333. Maintenance commands include:
  4334. <DL>
  4335. <DT>Change
  4336. <!--chtml if pinemode="function_key"-->
  4337. (F4)
  4338. <!--chtml else-->
  4339. (C)
  4340. <!--chtml endif-->
  4341. </DT>
  4342.  
  4343. <DD>Modify attributes of the selected collection definition.
  4344.  
  4345. <DT>Add Cltn
  4346. <!--chtml if pinemode="function_key"-->
  4347. (F9)
  4348. <!--chtml else-->
  4349. (A)
  4350. <!--chtml endif-->
  4351. </DT>
  4352.  
  4353. <DD>Create a new collection definition.
  4354. </DD>
  4355.  
  4356. <DT>Del Cltn
  4357. <!--chtml if pinemode="function_key"-->
  4358. (F10)
  4359. <!--chtml else-->
  4360. (D)
  4361. <!--chtml endif-->
  4362. </DT>
  4363.  
  4364. <DD>Delete the selected collection definition.<BR>
  4365. NOTE: The folders and directories referred to by the
  4366. collection definition are <EM>NOT</EM> deleted.  Folders must
  4367. be deleted, if that's what you wish to do, from the 
  4368. <A HREF="h_folder_maint">FOLDER LIST screen</A>, which shows the 
  4369. individual folders in a collection.
  4370. </DD>
  4371.  
  4372. <DT>Shuffle
  4373. <!--chtml if pinemode="function_key"-->
  4374. (F11)
  4375. <!--chtml else-->
  4376. ($)
  4377. <!--chtml endif-->
  4378. </DT>
  4379.  
  4380. <DD>Change the order of the displayed collections.  Pine will offer
  4381. to move the currently selected collection one position UP
  4382. or DOWN.
  4383. </DD>
  4384. </DL>
  4385.  
  4386. <P>
  4387. <End of help on this topic>
  4388. </BODY>
  4389. </HTML>
  4390. ============ h_what_are_collections ==========
  4391. <HTML>
  4392. <HEAD>
  4393. <TITLE>Folder Collections Explained</TITLE>
  4394. </HEAD>
  4395. <BODY>
  4396. <H1>Folder Collections Explained</H1>
  4397.  
  4398.  
  4399. Those of you with simple mail configurations will just see a list of all the
  4400. folders you have when choosing FOLDER LIST from Pine's MAIN MENU.  
  4401. The special folders for INBOX, sent mail and saved messages
  4402. will appear at the top of the list.  All others are in alphabetical order.
  4403. <P>
  4404. If you
  4405. or your system administrator have defined more than one collection or if
  4406. you have a collection (for newsgroups or email folders) defined on your 
  4407. system, then you will see the COLLECTION LIST screen first when choosing 
  4408. FOLDER LIST from Pine's MAIN MENU.  (This selection level is new in Pine 4.00; 
  4409. previous versions showed all folder 
  4410. collections on the FOLDER LIST screen, with a "Select Here to See
  4411. Expanded List" button to reveal the folders in them.)
  4412. <P>
  4413. <H2>Why have multiple folder collections?</H2>
  4414. <P>
  4415. For Pine users who only maintain email folders (and not too many) on one host, 
  4416. a single folder collection is probably sufficient.<P>
  4417.  
  4418. However, people who have more than one email account - for example, one 
  4419. at their university, and one with their personal Internet Service Provider - 
  4420. will have different sets of folders on different hosts, and they may want to
  4421. access them all from the same installation of Pine, rather than use different 
  4422. software and/or log into other hosts to manipulate messages in different 
  4423. accounts.  (If in doubt whether one of your email accounts can be accessed 
  4424. with Pine, contact the technical support people for that account.)  Even people
  4425. who have only one email account on one host, but have dozens or
  4426. hundreds of email folders, may want to arrange these folders together in a 
  4427. meaningful way.<BR>
  4428. That is where multiple collections come in.
  4429.  
  4430. <H2>Types of Collections</H2>
  4431. <DL>
  4432. <DT>INCOMING FOLDERS</DT>
  4433. <DD>"Incoming Message Folders" 
  4434. is a special collection typically used to supplement your single INBOX.  
  4435. All the folders here are meant to be ones that receive incoming messages, 
  4436. which you intend to check more or less frequently.  
  4437. You may have multiple folders like this because you or your systems 
  4438. administrator have set up an external program (because this is not a 
  4439. function of Pine!) to filter incoming 
  4440. email messages into different folders, based on certain criteria such as 
  4441. sender, recipient, or subject; or because you have multiple accounts and 
  4442. wish to check their INBOXes easily.  This collection is established by 
  4443. setting the 
  4444. <A HREF="h_config_enable_incoming">"enable-incoming-folders"</A>
  4445. feature in the SETUP CONFIGURATION screen, which is accessed from the 
  4446. MAIN MENU.
  4447. </DD>
  4448.  
  4449. <DT>NEWS</DT>
  4450. <DD>You can also define a collection specifically for
  4451. newsgroups.  Pine does this for you implicitly when you 
  4452. <A HREF="h_config_nntp_server">define an NNTP Server</A>
  4453. in your Pine configuration.  The news collection appears last in the 
  4454. COLLECTION LIST (though you can shuffle it up in the order of presentation),
  4455. and Pine knows not to save messages there.
  4456. </DD>
  4457.  
  4458. <DT>DEFAULT COLLECTION</DT>
  4459. <DD>This is the default collection for your saved and sent messages folders.
  4460. </DD>
  4461. </DL>
  4462.  
  4463. <P>
  4464.  
  4465. <H2>Defining Collections</H2>
  4466. <P>
  4467. In the absence of any folder-collection definitions, Pine will assume a
  4468. single default folder collection.
  4469. <!--chtml if pinemode="os_windows"-->
  4470. <!--chtml else-->
  4471. If necessary, Pine will create the directory
  4472. "mail" in your Unix home directory 
  4473. to hold your folders.
  4474. <!--chtml endif-->
  4475. <P>
  4476. You can use the 
  4477. <A HREF="h_collection_maint">Setup/collectionList screen</A>, called up from 
  4478. the MAIN MENU, to manage your collection list.  
  4479. <P>
  4480. <End of help on this topic>
  4481. </BODY>
  4482. </HTML>
  4483. ===== h_role_select =====
  4484. <HTML>
  4485. <HEAD>
  4486. <TITLE>ROLES SCREEN</TITLE>
  4487. </HEAD>
  4488. <BODY>
  4489. <H1>ROLES SCREEN</H1>
  4490. <H2>ROLES COMMANDS</H2>
  4491. <!--chtml if pinemode="function_key"-->
  4492. <PRE>
  4493. Available  Commands                        
  4494. -------------------------------            
  4495. F1  Show Help Text
  4496. F3  Back to MAIN Pine menu
  4497. F4  Select a role to use in composition
  4498. F5  Move to previous role
  4499. F6  Move to next role
  4500. F7  Previous page of roles
  4501. F8  Next page of roles
  4502. F12 Whereis (search role nicknames)
  4503. </PRE>
  4504. <!--chtml else-->
  4505. <PRE>
  4506. Navigation                     General Pine Commands
  4507. -----------------------        ---------------------
  4508.  P  Prev Role                     ?  Display this help text
  4509.  N  Next Role                     E  Back to MAIN Pine menu
  4510.  -  Previous page
  4511. Spc Next page
  4512.  W  WhereIs (search for word in role nicknames)
  4513.  
  4514. Select Role Commands
  4515. ------------------------------------------------
  4516.  C  Compose using highlighted role
  4517. </PRE>
  4518. <!--chtml endif-->
  4519.  
  4520. <H2>Description of the Roles Screen</H2>
  4521.  
  4522. With this screen you select a role to be used in the composition of a
  4523. message.
  4524. Use the Previous and Next commands to highlight the role you wish to
  4525. use.
  4526. When you type C you will be placed in the composer using the highlighted role.
  4527. <P>
  4528. You don't have any non-default <A HREF="h_rules_roles">roles</A>
  4529. available unless you set them up.
  4530. You may do so by using the Setup/Rules command on the main menu.
  4531. <P><UL>
  4532. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  4533. </UL>
  4534. <P>
  4535. <End of help on this topic>
  4536. </BODY>
  4537. </HTML>
  4538. ===== h_role_nick_select =====
  4539. <HTML>
  4540. <HEAD>
  4541. <TITLE>ROLE NICKNAME SCREEN</TITLE>
  4542. </HEAD>
  4543. <BODY>
  4544. <H1>ROLE NICKNAME SCREEN</H1>
  4545. <H2>COMMANDS</H2>
  4546. <!--chtml if pinemode="function_key"-->
  4547. <PRE>
  4548. Available  Commands                        
  4549. -------------------------------            
  4550. F1  Show Help Text
  4551. F3  Back to MAIN Pine menu
  4552. F4  Select highlighted role
  4553. F5  Move to previous role
  4554. F6  Move to next role
  4555. F7  Previous page of roles
  4556. F8  Next page of roles
  4557. F12 Whereis (search role nicknames)
  4558. </PRE>
  4559. <!--chtml else-->
  4560. <PRE>
  4561. Navigation                     General Pine Commands
  4562. -----------------------        ---------------------
  4563.  P  Prev Role                     ?  Display this help text
  4564.  N  Next Role                     E  Back to MAIN Pine menu
  4565.  -  Previous page
  4566. Spc Next page
  4567.  W  WhereIs (search for word in role nicknames)
  4568.  
  4569. Select Role Commands
  4570. ------------------------------------------------
  4571.  S  Select highlighted role
  4572. </PRE>
  4573. <!--chtml endif-->
  4574.  
  4575. <H2>Description of the Role Nicknames Screen</H2>
  4576.  
  4577. This screen helps you select one of your role nicknames.
  4578. Use the Previous and Next commands to highlight the role you wish to
  4579. use.
  4580. <P>
  4581. You don't have any non-default <A HREF="h_rules_roles">roles</A>
  4582. available unless you set them up.
  4583. You may do so by using the Setup/Rules command on the main menu.
  4584. <P><UL>
  4585. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  4586. </UL>
  4587. <P>
  4588. <End of help on this topic>
  4589. </BODY>
  4590. </HTML>
  4591. ======== h_rule_patterns =============
  4592. <HTML>
  4593. <HEAD>
  4594. <TITLE>PATTERNS</TITLE>
  4595. </HEAD>
  4596. <BODY>
  4597. <H1>PATTERNS</H1>
  4598. Patterns are used with Roles, Filtering, Index Coloring,
  4599. and Scoring.
  4600. Patterns are compared with a message to see if there is a match.
  4601. For Filtering, the messages being checked are all the messages in the
  4602. folder, one at a time.
  4603. For Index Line Coloring, each message which is visible on the screen is
  4604. checked for matches with the Index Coloring Patterns.
  4605. Roles are used with the Reply, Forward, and Compose commands.
  4606. For Reply, the message used to compare the Pattern with is the message
  4607. being replied to;
  4608. for Forward, the message used to compare the Pattern with is the message
  4609. being forwarded;
  4610. and for Compose, there is no message, so the parts of the Pattern which depend
  4611. on a message (everything other than Current Folder Type)
  4612. are not used.
  4613. Only the Current Folder Type matters for Compose.
  4614. For Scoring, the message being scored is compared with all of the Score
  4615. Patterns, and the Score Values from the ones that match are added together to 
  4616. get the message's score.
  4617. <P>
  4618. Each Pattern has several possible pieces, all of which are optional.
  4619. There are six predefined header patterns called the To, From, Sender, Cc, News,
  4620. and Subject patterns.
  4621. Besides those six predefined header patterns, you may add
  4622. additional header patterns with header fieldnames of your choosing.
  4623. You add an extra header pattern by placing the cursor on one of the
  4624. patterns while in the role editor and using the "eXtraHdr" command.
  4625. The Recip pattern is a header pattern which stands for Recipient (To OR Cc)
  4626. and the Partic pattern is a header pattern which stands for
  4627. Participant (To OR Cc OR From).
  4628. (Defining the Recip pattern does not have the same effect as defining both
  4629. the To and Cc patterns. Recip is To OR Cc, not To AND Cc.)
  4630. Similar to the header patterns is the AllText pattern.
  4631. Instead of comparing this pattern's text against only the contents of
  4632. a particular header field, the text for the AllText pattern is compared
  4633. with text anywhere in the message's header or body.
  4634. The "Current Folder Type" and the "Score Interval" are
  4635. also part of the Pattern, although the "Score Interval" is not used
  4636. when checking for matches for Scoring.
  4637. <P>
  4638. In order for there to be a match, all of the defined parts of the Pattern
  4639. must match the message.
  4640.  
  4641. <H2>Parts of a Pattern</H2>
  4642.  
  4643. <H3>Header patterns</H3>
  4644.  
  4645. A header pattern is simply text which is searched for in the corresponding
  4646. header field.
  4647. For example, if a Pattern has a From header pattern with the value
  4648. "@company.com", then only messages which have a From header
  4649. which contains the text "@company.com" will be possible
  4650. matches.
  4651. Matches don't have to be exact.
  4652. For example, if the relevant field of a message contains the text
  4653. "mailbox@domain" somewhere
  4654. in it, then header patterns of "box", or "x@d", or
  4655. "mailbox@domain" are all matches.
  4656. <P>
  4657. All parts of the Pattern must match so, for example,
  4658. if a message matches a defined
  4659. From pattern, it still must be checked against the other parts of the
  4660. Pattern which have been defined.
  4661. The To header pattern is a slightly special case.
  4662. If the message being checked has a Resent-To header, the addresses
  4663. there are used in place of the addresses in the To header.
  4664. This is only true for the To header.
  4665. Resent-cc and Resent-From headers are never used unless you add them
  4666. with the eXtraHdrs command.
  4667. <P>
  4668. If you want to check for the presence of a header field but don't care
  4669. about its value, then
  4670. the empty pattern which you get by entering a pair of
  4671. double quotes ("") should match any message which
  4672. has the corresponding header field.
  4673.  
  4674. <H3><A NAME="pattern_alltext">AllText patterns</A></H3>
  4675.  
  4676. AllText patterns are just like header patterns except that the text is
  4677. searched for anywhere in the message's headers or body, not just in the
  4678. contents of a particular header field.
  4679. <P>
  4680. If there is more than one header pattern or AllText pattern
  4681. for which you want to take the
  4682. same action there is a shorthand notation which may be used.
  4683. Any of these patterns may be a comma-separated list of patterns instead of
  4684. just a single pattern.
  4685. If any one of the patterns in the list matches the message
  4686. then it is considered a match.
  4687. For example, if "company1" and "company2" both required
  4688. you to use the same role when replying to messages, you might have
  4689. a To pattern which looks like
  4690. <P>
  4691. <CENTER><SAMP>company1.com,company2.com</SAMP></CENTER>
  4692. <P>
  4693. This means that if the mail you are replying to was addressed to
  4694. either "anything@company1.com" or "anything@company2.com",
  4695. then this Pattern is a match and the same actions will be taken.
  4696. <P>
  4697. A technicality: Since comma is the character used to separate multiple values
  4698. in a header or AllText pattern field, you have to escape comma with a
  4699. backslash (\) if you want to include a literal comma in one of those fields.
  4700. The same is true for the backslash character itself, which must be escaped
  4701. with another backslash to make it literal.
  4702. It's unlikely you'll ever need to enter a literal comma or backslash in
  4703. any of the patterns.
  4704.  
  4705. <H3><A NAME="pattern_current_folder">Current Folder Type</A></H3>
  4706.  
  4707. The "Current Folder Type" may be set to one of four different
  4708. values: "Any", "News", "Email", or
  4709. "Specific".
  4710. If the value is set to "News", then the
  4711. Pattern will only match if the currently open folder is a newsgroup.
  4712. The value "Email" only matches if the current folder is not news and
  4713. the value "Any" causes any folder to match.
  4714. If the value of "Current Folder Type" is set to "Specific",
  4715. then you must fill in a value for "Folder", which is on the line
  4716. below the "Specific" line.
  4717. In this case you will only get a match if the currently open folder is
  4718. the specific folder you list.
  4719. You may give a comma-separated list of folders instead of just a single
  4720. folder name, in which case the Pattern will match if the open folder is
  4721. any one of the folders in the list.
  4722. The name of each folder in the list may be either "INBOX",
  4723. the technical specification
  4724. of the folder (like what appears in your configuration file) or, if the
  4725. folder is one of your incoming folders, it may be the nickname you've given
  4726. the folder.
  4727. Here are a couple samples of specific folder names:
  4728. <P>
  4729. <CENTER><SAMP>{monet.art.nowhere.edu}mail/art-class</SAMP></CENTER>
  4730. <P>
  4731. <CENTER><SAMP>{news.myisp.com/nntp}#news.comp.mail.pine</SAMP></CENTER>
  4732. <P>
  4733. <CENTER><SAMP>mail/local-folder</SAMP></CENTER>
  4734. <P>
  4735. When reading a newsgroup, there may be a performance penalty
  4736. incurred when collecting the information necessary to check whether
  4737. or not a Pattern matches a message.
  4738. For this reason, the default Current Folder Type is set to "Email".
  4739. If you have Patterns with a Current Folder Type of either
  4740. "Any" or "News" and those Patterns are used for
  4741. Index Line Coloring or Scoring, you may experience
  4742. slower screen redrawing in the MESSAGE INDEX screen when in a newsgroup.
  4743.  
  4744. <H3><A NAME="pattern_score_interval">Score Interval</A></H3>
  4745.  
  4746. The "Score Interval" may be set to an interval of message
  4747. scores which should be considered a match.
  4748. Like the other parts of the Pattern, if it is unset it will be ignored.
  4749. The Score Interval looks like
  4750. <P>
  4751. <CENTER><SAMP>(min_score,max_score)</SAMP></CENTER>
  4752. <P>
  4753. where "min_score" and "max_score" are integers between
  4754. -32000 and 32000.
  4755. The special values "-INF" and "INF" may be used for
  4756. the min and max values to represent negative and positive infinity.
  4757. <P>
  4758. When there is a Score Interval defined, it is a match if the score for
  4759. the message is contained in the interval.
  4760. The interval includes both endpoints.
  4761. The score for a message is calculated by looking at every Score rule defined and
  4762. adding up the Score Values for the ones which match the message.
  4763. When deciding whether or not a Pattern matches a message for purposes of
  4764. calculating the score, the Score Interval is ignored.
  4765. <P>
  4766. <End of help on this topic>
  4767. </BODY>
  4768. </HTML>
  4769. ===== h_rules_roles =====
  4770. <HTML>
  4771. <HEAD>
  4772. <TITLE>SETUP ROLES SCREEN</TITLE>
  4773. </HEAD>
  4774. <BODY>
  4775. <H1>SETUP ROLES SCREEN</H1>
  4776. <H2>SETUP ROLES COMMANDS</H2>
  4777. <!--chtml if pinemode="function_key"-->
  4778. <PRE>
  4779. Available  Commands -- Group 1         Available Commands -- Group 2   
  4780. -------------------------------        ------------------------------  
  4781. F1  Show Help Text                      F1  Show Help Text             
  4782. F2  See commands in next group          F2  See commands in next group
  4783. F3  Back to MAIN Pine menu
  4784. F4  Change configuration for role
  4785. F5  Move to previous role               F5  Include file in role config
  4786. F6  Move to next role                   F6  Exclude file from config
  4787. F7  Previous page of roles
  4788. F8  Next page of roles
  4789. F9  Add new role
  4790. F10 Delete existing role
  4791. F11 Shuffle the order of roles
  4792. F12 Whereis (search role nicknames)
  4793. </PRE>
  4794. <!--chtml else-->
  4795. <PRE>
  4796. Navigation                     General Pine Commands
  4797. -----------------------        ---------------------
  4798.  P  Prev Role                     ?  Display this help text
  4799.  N  Next Role                     E  Back to MAIN Pine menu
  4800.  -  Previous page
  4801. Spc Next page
  4802.  W  WhereIs (search for word in role nicknames)
  4803.  
  4804. Setup Roles Commands
  4805. ------------------------------------------------
  4806.  A  Add new role                  $  Shuffle the order of roles
  4807.  D  Delete existing role          C  Change configuration for hilited role
  4808.  I  Include file in role config   X  Exclude file from role config
  4809. </PRE>
  4810. <!--chtml endif-->
  4811.  
  4812. <H2>Description of the Setup Roles Screen</H2>
  4813.  
  4814. This screen lets you add, delete, modify, or change the order of the rules
  4815. which determine the role you are playing when composing
  4816. a message.
  4817. <P>
  4818. You may play different roles depending on who you are replying to.
  4819. For example, if you are replying to a message addressed to help-desk you
  4820. may be acting as a Help Desk Worker.
  4821. That role may require that you use a different return address and/or
  4822. a different signature.
  4823. <P>
  4824. Roles are optional.
  4825. If you set up roles they work like this:  Each role has a set of
  4826. "Uses", which indicate whether or not a role is eligible to be
  4827. considered for a particular use; a "Pattern",
  4828. which is used to decide which of the eligible roles is used; and a set
  4829. of "Actions", which are taken when that role is used.
  4830. When you reply to a message, the message you are replying to is compared
  4831. with the Patterns of the roles marked as eligible for use when replying.
  4832. The comparisons start with the first eligible role and keep going until there
  4833. is a match.
  4834. If a match is found, the matching role's Actions are taken.
  4835.  
  4836. <H2>Role Uses</H2>
  4837.  
  4838. There are three types of use to be configured;
  4839. one for Replying, one for Forwarding, and one for Composing.
  4840. These indicate whether or not you want a role to be considered when you
  4841. type the Reply, Forward, or Compose commands.
  4842. (The Role command is an alternate form of the Compose command, and it is
  4843. not affected by these settings.)
  4844. Each of these Use types has three possible values.
  4845. The value "Never"
  4846. means that the role will never be considered as a candidate for use with
  4847. the corresponding command.
  4848. For example, if you set a role's Reply Use to Never, then when you Reply to
  4849. a message, that role won't even be considered.
  4850. (That isn't quite true. If the message you are replying to matches some other
  4851. role which requires confirmation,
  4852. then there will be a ^T command available which allows you to select a role
  4853. from all of your roles, not just the reply-eligible roles.)
  4854. <P>
  4855.  
  4856. The options "With confirmation" and "Without confirmation"
  4857. both mean that you do want to consider this role when using the corresponding
  4858. command.
  4859. For either of these settings the role's Pattern will
  4860. be checked to see if it matches the message.
  4861. For Reply Use, the message used to compare the Pattern with is the message
  4862. being replied to.
  4863. For Forward Use, the message used to compare the Pattern with is the message
  4864. being forwarded.
  4865. For Compose Use, there is no message, so the parts of the Pattern which depend
  4866. on a message (everything other than Current Folder Type) are ignored.
  4867. In all cases, the Current Folder Type is checked if defined, and the
  4868. Score Interval is checked if defined.
  4869. If there is a match then this role will either be used without confirmation
  4870. or will be the default when confirmation is asked for, depending on
  4871. which of the two options is selected.
  4872. If confirmation is requested, you will have a chance to
  4873. choose No Role instead of the offered role, or to
  4874. change the role to any one of your other roles (with the ^T command).
  4875.  
  4876. <H2>Role Patterns</H2>
  4877.  
  4878. In order to determine whether or not a message matches a role the message is
  4879. compared with the Role's Pattern.
  4880. These Patterns are the same for use with Roles, Filtering, Index Coloring,
  4881. and Scoring, so are described in only one place,
  4882. "<A HREF="h_rule_patterns">here</A>".
  4883. <P>
  4884. Since header patterns and AllText patterns which are unset are ignored,
  4885. a role which has all header patterns unset, the AllText pattern unset,
  4886. the Score Interval unset, and the Current Folder Type set to
  4887. "Any" may be used as a default role.
  4888. It should be put last in the list of roles since the matching
  4889. starts at the beginning and proceeds until one of the roles is a match.
  4890. If no roles at all match, then Pine will
  4891. use its regular methods of defining the role.
  4892. If you wanted to, you could define a different "default" role
  4893. for Replying, Forwarding, and Composing by setting the
  4894. "Use" fields appropriately.
  4895.  
  4896. <H2>Role Actions</H2>
  4897.  
  4898. Once a role match is found, the role's Actions are taken.
  4899. For each role there are several possible actions that may be defined.
  4900. They are actions to set the From address, the Reply-To address,
  4901. the Fcc, the Signature file, and the Template file.
  4902.  
  4903. <H3>Set From</H3>
  4904.  
  4905. The From address is the address used on the From line of the message
  4906. you are sending.
  4907.  
  4908. <H3>Set Reply-To</H3>
  4909.  
  4910. The Reply-To address is the address used on the Reply-To line of the message
  4911. you are sending.
  4912. You don't need a Reply-To address unless it is different from the From address.
  4913.  
  4914. <H3>Set Fcc</H3>
  4915.  
  4916. The Fcc is used as the Fcc for the message you are sending.
  4917.  
  4918. <H3>Set Signature</H3>
  4919.  
  4920. The Signature is the name of a file to be used as the signature file when
  4921. this role is being used.
  4922. If the name of the file has a vertical bar following it (|)
  4923. then it is assumed that the file is a program that should be run to
  4924. produce the signature.
  4925.  
  4926. <H3>Set Template</H3>
  4927.  
  4928. A Template is the name of a file to be included in the message when this
  4929. role is being used.
  4930. If the name of the file has a vertical bar following it (|)
  4931. then it is assumed that the file is a program that should be run to
  4932. produce the template.
  4933.  
  4934. <P>
  4935. Both signature files and template files (or the output of signature programs
  4936. and template file programs) may contain special tokens
  4937. which are replaced with contents
  4938. which depend on the message being replied to or forwarded.
  4939. See the help for the individual fields inside the role editor for more
  4940. information on tokens.
  4941.  
  4942. <P>
  4943. If any of the actions are left unset, then the action depends on what
  4944. is present in the "Initialize settings using role" field.
  4945. If you've listed the nickname of another one of your roles there, then the
  4946. corresponding action from that role will be used here.
  4947. If that action is also blank, or if there is no nickname specified,
  4948. then Pine will do whatever it normally does to set these actions.
  4949. This depends on other configuration options and features you've set.
  4950.  
  4951. <H2>Command Descriptions</H2>
  4952.  
  4953. <H3>Add</H3>
  4954.  
  4955. The Add command is used to add a new role definition to your set of
  4956. roles.
  4957. The new role will be added before the highlighted role.
  4958.  
  4959. <H3>Delete</H3>
  4960.  
  4961. The Delete command deletes the currently highlighted role.
  4962.  
  4963. <H3>Change</H3>
  4964.  
  4965. The Change command lets you edit the nickname, Uses, Pattern,
  4966. and Actions of the currently highlighted role.
  4967.  
  4968. <H3>Shuffle</H3>
  4969.  
  4970. The Shuffle command allows you to change the order of the roles.
  4971. You may move the currently highlighted role up or down in the list.
  4972. The order of the roles is important since the roles are tested for a
  4973. match starting with the first role and continuing until a match is found.
  4974. You should place the roles with more specific Patterns near the beginning
  4975. of the list, and those with more general Patterns near the end so that
  4976. the more specific matches will happen when appropriate.
  4977.  
  4978. <H3>IncludeFile</H3>
  4979.  
  4980. The IncludeFile command allows you to add a roles file to your configuration.
  4981. Usually, your roles will be contained in your Pine configuration file.
  4982. If you wish, some or all of your roles may be stored in a separate file.
  4983. If a roles file already exists (maybe it was made by somebody else using
  4984. Pine), you may insert it before the currently highlighted role.
  4985. You may also insert an empty file or a file which does not yet exist.
  4986. Once you have an empty roles file in your configuration, you may use
  4987. the Shuffle command to move roles into it.
  4988. In fact, that's the only way to get the initial role into the file.
  4989.  
  4990. <H3>eXcludeFile</H3>
  4991.  
  4992. The eXcludeFile command removes a roles file from your roles configuration.
  4993. A limitation of the program is that in order to exclude a roles file
  4994. that file must have at least one role
  4995. in it, otherwise you won't be able to highlight a line in the file.
  4996. So you may have to add a dummy role to the file in order to exclude the file.
  4997. <P><UL>
  4998. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  4999. </UL>
  5000. <P>
  5001. <End of help on this topic>
  5002. </BODY>
  5003. </HTML>
  5004. ===== h_rules_incols =====
  5005. <HTML>
  5006. <HEAD>
  5007. <TITLE>SETUP INDEX LINE COLORS SCREEN</TITLE>
  5008. </HEAD>
  5009. <BODY>
  5010. <H1>SETUP INDEX LINE COLORS SCREEN</H1>
  5011. <H2>SETUP INDEX LINE COLORS COMMANDS</H2>
  5012. <!--chtml if pinemode="function_key"-->
  5013. <PRE>
  5014. Available  Commands -- Group 1         Available Commands -- Group 2   
  5015. -------------------------------        ------------------------------  
  5016. F1  Show Help Text                      F1  Show Help Text             
  5017. F2  See commands in next group          F2  See commands in next group
  5018. F3  Back to MAIN Pine menu
  5019. F4  Change configuration for rule
  5020. F5  Move to previous rule               F5  Include file in rule config
  5021. F6  Move to next rule                   F6  Exclude file from config
  5022. F7  Previous page of rules
  5023. F8  Next page of rules
  5024. F9  Add new rule
  5025. F10 Delete existing rule
  5026. F11 Shuffle the order of rules
  5027. F12 Whereis (search rule nicknames)
  5028. </PRE>
  5029. <!--chtml else-->
  5030. <PRE>
  5031. Navigation                     General Pine Commands
  5032. -----------------------        ---------------------
  5033.  P  Prev rule                     ?  Display this help text
  5034.  N  Next rule                     E  Back to MAIN Pine menu
  5035.  -  Previous page
  5036. Spc Next page
  5037.  W  WhereIs (search for word in rule nicknames)
  5038.  
  5039. Setup Index Color Commands
  5040. ------------------------------------------------
  5041.  A  Add new rule                  $  Shuffle the order of rules
  5042.  D  Delete existing rule          C  Change configuration for hilited rule
  5043.  I  Include file in rule config   X  Exclude file from rule config
  5044. </PRE>
  5045. <!--chtml endif-->
  5046.  
  5047. <H2>Description of the Setup Index Line Colors Screen</H2>
  5048.  
  5049. Index Line Color causes lines in the MESSAGE INDEX screen to be colored.
  5050. This action is only available if your terminal is capable of displaying
  5051. color and color display has been enabled with the
  5052. <A HREF="h_config_color_style">Color-Style</A> option within the
  5053. Setup Color screen.
  5054. (In PC-Pine, color is always enabled so there is no option to turn on.)
  5055. This screen lets you add, delete, modify, or change the order of the rules
  5056. which cause the lines in the MESSAGE INDEX to be displayed in different
  5057. colors.
  5058. <P>
  5059. Each rule has a "Pattern",
  5060. which is used to decide which of the rules is used; and the color which
  5061. is used if the Pattern matches a particular message.
  5062.  
  5063. <H2>Rule Patterns</H2>
  5064.  
  5065. In order to determine whether or not a message matches a rule the message is
  5066. compared with the rule's Pattern.
  5067. These Patterns are the same for use with Roles, Filtering, Index Coloring,
  5068. and Scoring, so are described in only one place,
  5069. "<A HREF="h_rule_patterns">here</A>".
  5070.  
  5071. <P>
  5072. If none of the Index Color rules is a match for a particular index line,
  5073. then the color used is set using
  5074. the <A HREF="h_color_setup">Setup Kolor</A> screen.
  5075.  
  5076. <H2>Index Line Color</H2>
  5077.  
  5078. This is the color that index lines are colored when there is a matching
  5079. Pattern.
  5080. This colors the whole index line, except possibly the status letters
  5081. which may be colored separately using
  5082. the <A HREF="h_color_setup">Setup Kolor</A> screen.
  5083.  
  5084. <H2>Command Descriptions</H2>
  5085.  
  5086. <H3>Add</H3>
  5087.  
  5088. The Add command is used to add a new rule definition to your set of
  5089. rules.
  5090. The new rule will be added before the highlighted rule.
  5091.  
  5092. <H3>Delete</H3>
  5093.  
  5094. The Delete command deletes the currently highlighted rule.
  5095.  
  5096. <H3>Change</H3>
  5097.  
  5098. The Change command lets you edit the nickname, Pattern,
  5099. and Index Line Color of the currently highlighted rule.
  5100.  
  5101. <H3>Shuffle</H3>
  5102.  
  5103. The Shuffle command allows you to change the order of the rules.
  5104. You may move the currently highlighted rule up or down in the list.
  5105. The order of the rules is important since the rules are tested for a
  5106. match starting with the first rule and continuing until a match is found.
  5107. You should place the rules with more specific Patterns near the beginning
  5108. of the list, and those with more general Patterns near the end so that
  5109. the more specific matches will happen when appropriate.
  5110.  
  5111. <H3>IncludeFile</H3>
  5112.  
  5113. The IncludeFile command allows you to add a rules file to your configuration.
  5114. Usually, your rules will be contained in your Pine configuration file.
  5115. If you wish, some or all of your rules may be stored in a separate file.
  5116. If a rules file already exists (maybe it was made by somebody else using
  5117. Pine), you may insert it before the currently highlighted rule.
  5118. You may also insert an empty file or a file which does not yet exist.
  5119. Once you have an empty rules file in your configuration, you may use
  5120. the Shuffle command to move rules into it.
  5121. In fact, that's the only way to get the initial rule into the file.
  5122.  
  5123. <H3>eXcludeFile</H3>
  5124.  
  5125. The eXcludeFile command removes a rules file from your rules configuration.
  5126. A limitation of the program is that in order to exclude a rules file
  5127. that file must have at least one rule
  5128. in it, otherwise you won't be able to highlight a line in the file.
  5129. So you may have to add a dummy rule to the file in order to exclude the file.
  5130. <P><UL>
  5131. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  5132. </UL>
  5133. <P>
  5134. <End of help on this topic>
  5135. </BODY>
  5136. </HTML>
  5137. ===== h_rules_filter =====
  5138. <HTML>
  5139. <HEAD>
  5140. <TITLE>SETUP FILTERING SCREEN</TITLE>
  5141. </HEAD>
  5142. <BODY>
  5143. <H1>SETUP FILTERING SCREEN</H1>
  5144. <H2>SETUP FILTERING COMMANDS</H2>
  5145. <!--chtml if pinemode="function_key"-->
  5146. <PRE>
  5147. Available  Commands -- Group 1         Available Commands -- Group 2   
  5148. -------------------------------        ------------------------------  
  5149. F1  Show Help Text                      F1  Show Help Text             
  5150. F2  See commands in next group          F2  See commands in next group
  5151. F3  Back to MAIN Pine menu
  5152. F4  Change configuration for filter
  5153. F5  Move to previous filter             F5  Include file in filter config
  5154. F6  Move to next filter                 F6  Exclude file from config
  5155. F7  Previous page of filters
  5156. F8  Next page of filters
  5157. F9  Add new filter
  5158. F10 Delete existing filter
  5159. F11 Shuffle the order of filters
  5160. F12 Whereis (search filter nicknames)
  5161. </PRE>
  5162. <!--chtml else-->
  5163. <PRE>
  5164. Navigation                     General Pine Commands
  5165. -----------------------        ---------------------
  5166.  P  Prev Filter                   ?  Display this help text
  5167.  N  Next Filter                   E  Back to MAIN Pine menu
  5168.  -  Previous page
  5169. Spc Next page
  5170.  W  WhereIs (search for word in filter nicknames)
  5171.  
  5172. Setup Filters Commands
  5173. ------------------------------------------------
  5174.  A  Add new filter                $  Shuffle the order of filters
  5175.  D  Delete existing filter        C  Change configuration for hilited filter
  5176.  I  Include file in filter config X  Exclude file from filter config
  5177. </PRE>
  5178. <!--chtml endif-->
  5179.  
  5180. <H2>Description of the Setup Filtering Screen</H2>
  5181.  
  5182. This screen lets you add, delete, modify, or change the order of the rules
  5183. which determine the filtering Pine does on folders you view.
  5184. <P>
  5185. The software which actually delivers mail (the stuff that happens
  5186. before Pine is involved) for you is in a better position to do mail filtering
  5187. than Pine itself.
  5188. If possible, you may want to look into using that sort of mail filtering to
  5189. deliver mail to different folders, delete it, or forward it.
  5190. However, if you'd like Pine to help with this, Pine's filtering is for you.
  5191. <P>
  5192. Filtering is a way to automatically move certain messages from one folder
  5193. to another or to delete messages.
  5194. Pine doesn't have the ability to forward mail to another address.
  5195. <P>
  5196. Each filtering rule has a "Pattern" and a "Filter Action".
  5197. When a folder is opened, or when new mail arrives in an open folder, each
  5198. message is compared with the Patterns of your filtering rules.
  5199. The comparisons start with the first rule and keep going until there
  5200. is a match.
  5201. If a match is found, the message is either deleted or moved, depending on
  5202. the setting of the Filter Action.
  5203.  
  5204. <P>
  5205. <EM>NOTE:</EM>
  5206. When setting up a Pattern used to only delete messages,
  5207. it is recommended that you test the Pattern first with a "Move"
  5208. folder specified in
  5209. case unintended matches occur.  Messages that are deleted will be removed 
  5210. from the folder and <EM>unrecoverable</EM> from within Pine after the
  5211. next Expunge command or once the folder being filtered has been closed.
  5212.  
  5213. <H2>Filter Patterns</H2>
  5214.  
  5215. In order to determine whether or not a message matches a filter the message is
  5216. compared with the Filter's Pattern.
  5217. These Patterns are the same for use with Roles, Filtering, Index Coloring,
  5218. and Scoring, so are described in only one place,
  5219. "<A HREF="h_rule_patterns">here</A>".
  5220. <P>
  5221. Since filtering is a potentially destructive action, if you have a filtering
  5222. Pattern with nothing other than Current Folder Type set, that filtering
  5223. rule is ignored.
  5224.  
  5225. <H2>Filter Action</H2>
  5226.  
  5227. Once a filter match is found for a particular message, that message is
  5228. either deleted or moved into the folders listed.
  5229. In the case of "Move", Folder may be set to
  5230. more than one folder name by listing the folders separated with commas.
  5231. The message will be saved to each of the folders listed and then deleted
  5232. from the current folder.
  5233.  
  5234. <H2>Command Descriptions</H2>
  5235.  
  5236. <H3>Add</H3>
  5237.  
  5238. The Add command is used to add a new filter definition to your set of
  5239. filters.
  5240. The new filter will be added before the highlighted filter.
  5241.  
  5242. <H3>Delete</H3>
  5243.  
  5244. The Delete command deletes the currently highlighted filter.
  5245.  
  5246. <H3>Change</H3>
  5247.  
  5248. The Change command lets you edit the nickname, Pattern,
  5249. and Folder of the currently highlighted filter.
  5250.  
  5251. <H3>Shuffle</H3>
  5252.  
  5253. The Shuffle command allows you to change the order of the filters.
  5254. You may move the currently highlighted filter up or down in the list.
  5255. The order of the filters is important since the filters are tested for a
  5256. match starting with the first filter and continuing until a match is found.
  5257. You should place the filters with more specific Patterns near the beginning
  5258. of the list, and those with more general Patterns near the end so that
  5259. the more specific matches will happen when appropriate.
  5260.  
  5261. <H3>IncludeFile</H3>
  5262.  
  5263. The IncludeFile command allows you to add a filters file to your configuration.
  5264. Usually, your filters will be contained in your Pine configuration file.
  5265. If you wish, some or all of your filters may be stored in a separate file.
  5266. If a filters file already exists (maybe it was made by somebody else using
  5267. Pine), you may insert it before the currently highlighted filter.
  5268. You may also insert an empty file or a file which does not yet exist.
  5269. Once you have an empty filters file in your configuration, you may use
  5270. the Shuffle command to move filters into it.
  5271. In fact, that's the only way to get the initial filter into the file.
  5272.  
  5273. <H3>eXcludeFile</H3>
  5274.  
  5275. The eXcludeFile command removes a filters file from your filters configuration.
  5276. A limitation of the program is that in order to exclude a filters file
  5277. that file must have at least one filter
  5278. in it, otherwise you won't be able to highlight a line in the file.
  5279. So you may have to add a dummy filter to the file in order to exclude the file.
  5280. <P><UL>
  5281. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  5282. </UL>
  5283. <P>
  5284. <H3>Performance Considerations</H3>
  5285. The number and type of patterns being tested can 
  5286. adversely effect performance.  Issues to be aware
  5287. of include:
  5288. <P>
  5289. <UL>
  5290.   <LI> The more filters you have defined the longer it will take to run down
  5291. the list.  Deleting unused filters is a good idea.
  5292.   <LI>Filtering in newsgroups served by an NNTP server will be slow
  5293. if your patterns include tests other than "From:"
  5294. or "Subject:".
  5295.   <LI> Filtering a folder served by an IMAP server
  5296. based on protocol versions prior to 4.
  5297. </UL>
  5298. <P>
  5299. <End of help on this topic>
  5300. </BODY>
  5301. </HTML>
  5302. ===== h_rules_score =====
  5303. <HTML>
  5304. <HEAD>
  5305. <TITLE>SETUP SCORING SCREEN</TITLE>
  5306. </HEAD>
  5307. <BODY>
  5308. <H1>SETUP SCORING SCREEN</H1>
  5309. <H2>SETUP SCORING COMMANDS</H2>
  5310. <!--chtml if pinemode="function_key"-->
  5311. <PRE>
  5312. Available  Commands -- Group 1         Available Commands -- Group 2   
  5313. -------------------------------        ------------------------------  
  5314. F1  Show Help Text                      F1  Show Help Text             
  5315. F2  See commands in next group          F2  See commands in next group
  5316. F3  Back to MAIN Pine menu
  5317. F4  Change configuration for rule
  5318. F5  Move to previous rule               F5  Include file in rule config
  5319. F6  Move to next rule                   F6  Exclude file from config
  5320. F7  Previous page of rules
  5321. F8  Next page of rules
  5322. F9  Add new rule
  5323. F10 Delete existing rule
  5324. F11 Shuffle the order of rules
  5325. F12 Whereis (search rule nicknames)
  5326. </PRE>
  5327. <!--chtml else-->
  5328. <PRE>
  5329. Navigation                     General Pine Commands
  5330. -----------------------        ---------------------
  5331.  P  Prev rule                     ?  Display this help text
  5332.  N  Next rule                     E  Back to MAIN Pine menu
  5333.  -  Previous page
  5334. Spc Next page
  5335.  W  WhereIs (search for word in rule nicknames)
  5336.  
  5337. Setup Scoring Commands
  5338. ------------------------------------------------
  5339.  A  Add new rule                  $  Shuffle the order of rules
  5340.  D  Delete existing rule          C  Change configuration for hilited rule
  5341.  I  Include file in rule config   X  Exclude file from rule config
  5342. </PRE>
  5343. <!--chtml endif-->
  5344.  
  5345. <H2>Description of the Setup Scoring Screen</H2>
  5346.  
  5347. Most people will not use scores at all, but if you do use them, here's how
  5348. they work in Pine.
  5349. Using this screen, you may define Scoring rules.
  5350. The score for a message is calculated by looking at every Score rule defined
  5351. and adding up the Score Values for the ones which match the message.
  5352. If there are no matches for a message, it has a score of zero.
  5353. Message scores may be used a couple of ways in Pine.
  5354.  
  5355. <H3>Sorting by Score</H3>
  5356.  
  5357. One of the methods you may use to sort message indexes is to sort by
  5358. score.
  5359. The scores of all the messages in a folder will be calculated and then
  5360. the index will be ordered by placing the messages in order of ascending or
  5361. descending score.
  5362.  
  5363. <H3>Scores for use in Patterns</H3>
  5364.  
  5365. The Patterns used for Roles, Index Line Coloring, and Filtering have a
  5366. category labeled "Score Interval".
  5367. When a message is being compared with a Pattern to check for a match, if
  5368. the Score Interval is set only messages which have a score somewhere in
  5369. the interval are a match.
  5370.  
  5371. <H2>Scoring Rule Patterns</H2>
  5372.  
  5373. In order to determine whether or not a message matches a scoring rule
  5374. the message is compared with the rule's Pattern.
  5375. These Patterns are the same for use with Roles, Filtering, Index Coloring,
  5376. and Scoring, so are described in only one place,
  5377. "<A HREF="h_rule_patterns">here</A>".
  5378.  
  5379. <P>
  5380. Actually, Scoring rule Patterns are slightly different from the other types of
  5381. Patterns because Scoring rule Patterns don't contain a Score Interval.
  5382. In other words, when calculating the score for a message, which is done
  5383. by looking at the Scoring rule Patterns, scores aren't used.
  5384.  
  5385. <H2>Score Value</H2>
  5386.  
  5387. This is the value that will be added to the score for a message if the
  5388. rule's Pattern is a match.
  5389. Each individual Score Value is an integer between -100 and 100, and the
  5390. values from matching rules are added together to get a message's score.
  5391.  
  5392. <H2>Command Descriptions</H2>
  5393.  
  5394. <H3>Add</H3>
  5395.  
  5396. The Add command is used to add a new scoring rule definition.
  5397. The new rule will be added before the highlighted rule.
  5398.  
  5399. <H3>Delete</H3>
  5400.  
  5401. The Delete command deletes the currently highlighted scoring rule.
  5402.  
  5403. <H3>Change</H3>
  5404.  
  5405. The Change command lets you edit the nickname, Pattern,
  5406. and Score Value of the currently highlighted scoring rule.
  5407.  
  5408. <H3>Shuffle</H3>
  5409.  
  5410. The Shuffle command allows you to change the order of the scoring rules.
  5411. You may move the currently highlighted rule up or down in the list.
  5412. The order of the rules is important since the rules are tested for a
  5413. match starting with the first rule and continuing until a match is found.
  5414. You should place the rules with more specific Patterns near the beginning
  5415. of the list, and those with more general Patterns near the end so that
  5416. the more specific matches will happen when appropriate.
  5417.  
  5418. <H3>IncludeFile</H3>
  5419.  
  5420. The IncludeFile command allows you to add a rules file to your configuration.
  5421. Usually, your rules will be contained in your Pine configuration file.
  5422. If you wish, some or all of your rules may be stored in a separate file.
  5423. If a rules file already exists (maybe it was made by somebody else using
  5424. Pine), you may insert it before the currently highlighted rule.
  5425. You may also insert an empty file or a file which does not yet exist.
  5426. Once you have an empty rules file in your configuration, you may use
  5427. the Shuffle command to move rules into it.
  5428. In fact, that's the only way to get the initial rule into the file.
  5429.  
  5430. <H3>eXcludeFile</H3>
  5431.  
  5432. The eXcludeFile command removes a rules file from your rules configuration.
  5433. A limitation of the program is that in order to exclude a rules file
  5434. that file must have at least one rule
  5435. in it, otherwise you won't be able to highlight a line in the file.
  5436. So you may have to add a dummy rule to the file in order to exclude the file.
  5437. <P><UL>
  5438. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  5439. </UL>
  5440. <P>
  5441. <End of help on this topic>
  5442. </BODY>
  5443. </HTML>
  5444. ===== h_direct_config =====
  5445. <HTML>
  5446. <HEAD>
  5447. <TITLE>SETUP LDAP DIRECTORY SERVERS SCREEN</TITLE>
  5448. </HEAD>
  5449. <BODY>
  5450. <H1>SETUP LDAP DIRECTORY SERVERS SCREEN</H1>
  5451. <H2>SETUP LDAP DIRECTORY SERVERS COMMANDS</H2>
  5452. <!--chtml if pinemode="function_key"-->
  5453. <PRE>
  5454. Available  Commands                        
  5455. -------------------------------            
  5456. F1  Show Help Text                         
  5457. F3  Back to MAIN Pine menu                 
  5458. F4  Change configuration for directory server  
  5459. F5  Move to previous directory server          
  5460. F6  Move to next directory server              
  5461. F7  Previous page of directory servers         
  5462. F8  Next page of directory servers
  5463. F9  Add new directory server
  5464. F10 Delete existing directory server
  5465. F11 Shuffle the order of directory servers
  5466. F12 Whereis (search directory server titles)   
  5467. </PRE>
  5468. <!--chtml else-->
  5469. <PRE>
  5470. Navigation                     General Pine Commands
  5471. -----------------------        ---------------------
  5472.  P  Prev Directory Server         ?  Display this help text
  5473.  N  Next Directory Server         E  Back to MAIN Pine menu
  5474.  -  Previous page
  5475. Spc Next page
  5476.  W  WhereIs (search for word in directory server titles)
  5477.  
  5478. Setup LDAP Directory Server Commands
  5479. ------------------------------------------------
  5480.  A  Add new directory server      $  Shuffle the order of directory servers
  5481.  D  Delete existing dir server    C  Change configuration for hilited server
  5482. </PRE>
  5483. <!--chtml endif-->
  5484.  
  5485. <H2>Description of the Setup LDAP Directory Servers Screen</H2>
  5486.  
  5487. This screen lets you add, delete, modify, or change the order of your
  5488. directory servers. You may also set some optional behavior for each server.
  5489. The "Add Dir" command brings up a blank form to 
  5490. fill in. You will have to supply at least the name of the LDAP server.
  5491. You will often have to supply a search base to be used with that server,
  5492. as well. Once the form has been brought up on your screen, there is help
  5493. available for each of the options you may set.
  5494. <P>
  5495. The "Del Dir" command allows you to remove a directory server
  5496. from your configuration.
  5497. <P>
  5498. The "Change" command is similar to the "Add Dir" command.
  5499. The difference is that instead of bringing up a form for a new server
  5500. configuration, you are changing the configuration of an existing entry.
  5501. For example, you might want to correct a typing error, change a
  5502. nickname, or change one of the options set for that server.
  5503. <P>
  5504. The "Shuffle" command is used to change the order of directory
  5505. servers.
  5506. <P><UL>
  5507. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  5508. </UL>
  5509. <P>
  5510. <End of help on this topic>
  5511. </BODY>
  5512. </HTML>
  5513. ============= h_address_display ========================
  5514. <HTML>
  5515. <HEAD>
  5516. <TITLE>SEARCH RESULTS INDEX</TITLE>
  5517. </HEAD>
  5518. <BODY>
  5519. <H1>SEARCH RESULTS INDEX</H1>
  5520. This screen shows the results, if any, of your Directory Server search.  
  5521. Commands (besides those for screen navigation) are:
  5522. <DL>
  5523. <DT>View
  5524. <!--chtml if pinemode="function_key"-->
  5525. (F4)
  5526. <!--chtml else-->
  5527. (V)
  5528. <!--chtml endif-->
  5529. </DT>
  5530. <DD>See the full information for the selected entry.
  5531.  
  5532. <DT>Compose
  5533. <!--chtml if pinemode="function_key"-->
  5534. (F9)
  5535. <!--chtml else-->
  5536. (C)
  5537. <!--chtml endif--></DT>
  5538. <DD>Compose a message with the selected entry as the recipient.
  5539.  
  5540. <DT>Role
  5541. <!--chtml if pinemode="function_key"-->
  5542. (F2)
  5543. <!--chtml else-->
  5544. (#)
  5545. <!--chtml endif--></DT>
  5546. <DD>Compose a message with the selected entry as the recipient. This differs
  5547. from Compose in that you may select a role before beginning your composition.
  5548.  
  5549. <DT>Forward
  5550. <!--chtml if pinemode="function_key"-->
  5551. (F10)
  5552. <!--chtml else-->
  5553. (F)
  5554. <!--chtml endif--></DT>
  5555. <DD>Send the full information for the selected entry as an 
  5556. email message to someone else.
  5557.  
  5558. <DT>Save
  5559. <!--chtml if pinemode="function_key"-->
  5560. (F11)
  5561. <!--chtml else-->
  5562. (S)
  5563. <!--chtml endif-->
  5564. </DT>
  5565. <DD>Save to your address book:
  5566. <UL>
  5567. <LI>the result of the search (as just found through your query) for the 
  5568. selected entry; or 
  5569. <LI>the selected entry for repeated Directory Server searching when used 
  5570. in the future.
  5571. </UL>
  5572. or<BR>
  5573. Export to a file (external to Pine):
  5574. <UL>
  5575. <LI>the full information for the selected entry; or
  5576. <LI>the email address from the selected entry; or
  5577. <LI>the selected entry in <A HREF="h_whatis_vcard">vCard</A> format.
  5578. </UL>
  5579. <DT>WhereIs
  5580. <!--chtml if pinemode="function_key"-->
  5581. (F12)
  5582. <!--chtml else-->
  5583. (W)
  5584. <!--chtml endif-->
  5585. </DT>
  5586. <DD>Search for text in the SEARCH RESULTS INDEX screen. (Searches only the 
  5587. displayed text, not the full records for each entry.)  
  5588. </DL>
  5589. <End of help on this topic>
  5590. </BODY>
  5591. </HTML>
  5592. ============= h_address_select ========================
  5593. <HTML>
  5594. <HEAD>
  5595. <TITLE>SEARCH RESULTS INDEX</TITLE>
  5596. </HEAD>
  5597. <BODY>
  5598. <H1>SEARCH RESULTS INDEX</H1>
  5599. This screen shows the results, if any, of your Directory Server search.  
  5600. Commands (besides those for screen navigation) are:
  5601. <DL>
  5602. <DT>Select
  5603. </DT>
  5604. <DD>Select this entry for use.
  5605.  
  5606. <DT>ExitSelect
  5607. <DD>Exit without selecting any of the entries.
  5608.  
  5609. <DT>WhereIs
  5610. </DT>
  5611. <DD>Search for text in the SEARCH RESULTS INDEX screen. (Searches only the 
  5612. displayed text, not the full records for each entry.)  
  5613. </DL>
  5614. <End of help on this topic>
  5615. </BODY>
  5616. </HTML>
  5617. ===== h_folder_maint =====
  5618. <HTML>
  5619. <HEAD>
  5620. <TITLE>Help for Folder List</TITLE>
  5621. </HEAD>
  5622. <BODY>
  5623. <H1>FOLDER LIST COMMANDS</H1>
  5624. <!--chtml if pinemode="function_key"-->
  5625. <PRE>
  5626. Available Commands -- Group 1        Available Commands -- Group 2
  5627. -------------------------------      ------------------------------
  5628. F1  Show Help Text                    F1  Show Help Text               
  5629. F2  See commands in next group        F2  See commands in next group  
  5630. F3  MAIN MENU Screen                  F3  Quit Pine                    
  5631. F4  Select folder and view it         F4  MAIN MENU Screen
  5632. F5  Move to previous folder
  5633. F6  Move to next folder               F6  Specify a folder to go to
  5634. F7  Show previous screen of listing   F7  Show MESSAGE INDEX of current folder
  5635. F8  Show next screen of listing       F8  Compose a message
  5636. F9  Add a new folder                  F9  Print folder listing
  5637. F10 Delete selected folder
  5638. F11 Rename selected folder
  5639. F12 Whereis (search folder names)
  5640.  
  5641. Available Commands -- Group 3
  5642. F8  Compose a message using roles
  5643. </PRE>
  5644. <!--chtml else-->
  5645. <PRE>
  5646. Navigating the Folder Screen            Operations on the Selected Folder
  5647. ----------------------------            ---------------------------------
  5648.  P   Move to previous folder              V  View Index of selected folder
  5649.  N   Move to next folder                  D  Delete
  5650.  -   Show previous page of listing        R  Rename
  5651. Spc  Show next page of listing
  5652.  
  5653. FOLDER LIST Screen Commands              General Pine Command
  5654. ---------------------------              ---------------------
  5655.  A  Add a folder                          O  Show all other available commands
  5656.  G  Specify a folder to go to             ?  Show Help text
  5657.  I  Show MESSAGE INDEX of current folder  M  MAIN MENU Screen
  5658.  W  Whereis (search folder names)         Q  Quit Pine
  5659.  %  Print folder listing                  C  Compose a message
  5660.                                           #  Compose a message using roles
  5661. </PRE>
  5662. <!--chtml endif-->
  5663. These commands are only available in the FOLDER LIST screen if the 
  5664. <A HREF="h_config_enable_agg_ops">"enable-aggregate-command-set" 
  5665. feature</A> is set in the SETUP CONFIGURATION screen:<DL>
  5666. <DT>Select:</DT>
  5667. <DD>Select folders by certain criteria:<UL>
  5668. <LI>All: of limited use, since there is no Apply command.
  5669. <LI>by Property: <UL>
  5670.     <LI>folder contains messages not yet seen 
  5671.     <LI>folder contains new messages
  5672.     <LI>folder contains exactly as many, more, or fewer messages 
  5673. than a given number
  5674.     </UL>
  5675. <LI>by Text: <UL>
  5676.     <LI>contained in name of folder (Name Select)
  5677.     <LI>contained in messages in folder (Content Select)
  5678.     </UL>
  5679. </UL></DD>
  5680.  
  5681. <DT>Select current:</DT>
  5682. <DD>Select the folder the cursor is on.  (Can be used to "manually" 
  5683. add one or more folders to a set created with the Select command described 
  5684. above.)</DD>
  5685. <DT>Zoom mode:</DT>
  5686. <DD>Toggles display of only selected folders or all folders on and off.</DD>
  5687. </DL>
  5688. <!-- In all folder collections except Incoming-Folders:
  5689. However, once you go to a folder's MESSAGE INDEX screen, the selection you 
  5690. made in the FOLDER LIST screen is no longer retained.  -->
  5691. <P>
  5692. <CENTER>Description of the FOLDER LIST Screen</CENTER>
  5693.  
  5694. The purpose of the FOLDER LIST screen is to help you browse and manage
  5695. the folders and directories (also known as "hierarchy")
  5696. contained within a collection.
  5697.  
  5698. <P>
  5699. Folders and directories are arranged alphabetically across lines of
  5700. the screen.  Directories, if present, are denoted by a special
  5701. character at the end of the name known as the hierarchy delimiter
  5702. (typically, "/").  By default, folders and directories are
  5703. mixed together.  The
  5704. "<A HREF="h_config_fld_sort_rule">Folder-Sort-Rule</A>"
  5705. configuration option can be used to group directories toward the 
  5706. beginning or end of the list.
  5707.  
  5708. <P>
  5709. The Next/Prev Page commands help browse the list, the Next/Prev Fldr
  5710. commands change the "selected" (i.e., highlighted) folder or
  5711. directory, and the View Fldr/Dir commands will "open" the
  5712. selected item.  Folder and directory management is provided via the
  5713. Rename, Delete and Add commands.
  5714.  
  5715. <P><CENTER>About Folders</CENTER>
  5716. What are Folders?<P>
  5717.  
  5718. Folders are simply files where messages are kept.  Every message has to be
  5719. in a folder.  Most every Pine user starts out with 3 folders: an INBOX, a
  5720. folder for sent mail and a folder for saved messages.<P>
  5721.  
  5722. You may create as many other folders as you wish.  They must be given
  5723. names that can be filenames on the filesystem.  
  5724. <!--chtml if pinemode="os_windows"-->
  5725. Normally PC-Pine folders are
  5726. automatically given the filename extension ".MTX" (which stands
  5727. for Mailbox-text).  The extension is suppressed from FOLDER LIST
  5728. displays, and should not be entered when typing a folder name at a
  5729. Save or Goto prompt.  The use of the MTX extension can be overridden
  5730. by the Setup/Configuration option 
  5731. <A HREF="h_config_folder_extension">folder-extension</A>, 
  5732. which may be useful when accessing
  5733. saved-message folders on a Unix host via SMB or NFS.  PC-Pine can
  5734. understand the normal Unix mail folder format, but can only open those
  5735. folders READ-ONLY.
  5736. <!--chtml else-->
  5737. <!--chtml endif-->
  5738. <P>
  5739.  
  5740. You can move messages from one folder to another by opening the original
  5741. folder and saving messages into the other folder just as you can save
  5742. message from your INBOX to any other folder.<P>
  5743.  
  5744. Folders are typically just files in the filesystem.  However, the files
  5745. which are
  5746. folders have some special formatting in them (so that Pine knows where one
  5747. message ends and another begins) and should <EM>not</EM> be edited outside of
  5748. Pine.  If you want copies of your messages in text files that you can edit
  5749. or otherwise manipulate, use the Export command to copy them from Pine into
  5750. your regular file area.
  5751.  
  5752. <P>
  5753. FOR MORE INFORMATION: See the section on
  5754. <A HREF="h_valid_folder_names">Valid Folder Names</A>.
  5755. <P>
  5756. <CENTER>About Directories</CENTER>
  5757. <P>
  5758. A directory is simply a container used to group folders within a
  5759. folder list.  You can create as many directories as you like.  And 
  5760. directories can even contain directories themselves.
  5761.  
  5762. <P>
  5763. SPECIAL NOTES: When accessing folders on an IMAP server, it is important
  5764. to note that not all IMAP servers support directories.  If you find that
  5765. the Add command fails to offer the "Create Directory" subcommand,
  5766. then it's likely that directories are not supported by the server serving
  5767. in that collection.
  5768.  
  5769. <P>
  5770. Similarly, servers that do provide for directories may not do so in
  5771. the same way.  On some servers, for example, each folder name you
  5772. create is at the same time capable of being a directory.  When this
  5773. happens, Pine will display both the folder name and the name of the
  5774. directory (with trailing hierarchy delimiter) in the folder list.
  5775.  
  5776. <P>
  5777. Another issue with IMAP access, though with a much smaller set of servers,
  5778. is that not all servers accept the request to list out the available
  5779. folders and directories in the same way.  If you find yourself having
  5780. trouble viewing folders on your server, you might investigate the
  5781. "<A HREF="h_config_lame_list_mode">enable-lame-list-mode</A>"
  5782. feature.
  5783. <P>
  5784. <UL>
  5785. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  5786. </UL>
  5787. <P>
  5788. <End of help on this topic>
  5789. </BODY>
  5790. </HTML>
  5791. ========= h_valid_folder_names ========
  5792. <HTML>
  5793. <HEAD>
  5794. <TITLE>Explanation of Valid Folder Names</TITLE>
  5795. </HEAD>
  5796. <BODY>
  5797. <H1>Folder Name Syntax Explained</H1>
  5798.  
  5799. Once your folder collections are defined, you can usually refer to
  5800. folders by their simple (unqualified) name, or pick from a FOLDER LIST
  5801. display.  However, understanding the complete syntax for folder names,
  5802. both local and remote, is handy when using the Goto command and when
  5803. you are adding new folder collections via the Setups/collectionList screen.
  5804.  
  5805. <P>
  5806. Local folder names depend on the operating system used by the computer 
  5807. running Pine, as well as the configuration of that system.  For example,
  5808. "C:\PINE\FOLDERS\OCT-94" might exist on a PC, and
  5809. "~/mail/september-1994" might be a reasonable folder name on Unix.
  5810. <!--chtml endif-->
  5811.  
  5812. <P>
  5813. Pine users have the option of using folders which are stored on some other
  5814. computer.  Pine accesses remote folders via IMAP (the Internet Message
  5815. Access Protocol), or in the case of news, via NNTP (the Network News
  5816. Transport Protocol).  To be able to access remote folders in Pine, the
  5817. remote host must be running the appropriate server software (imapd or
  5818. nntpd) and you must correctly specify the name of the folder to Pine,
  5819. including the domain name of the remote machine. For example,
  5820. <P>
  5821. <CENTER><SAMP>{monet.art.nowhere.edu}INBOX</SAMP></CENTER>
  5822. <P>
  5823. could be a remote folder specification, and so could
  5824. <P>
  5825. <CENTER><SAMP>{unixhost.art.nowhere.edu}~/mail/september-1994</SAMP></CENTER>
  5826. and
  5827. <P>
  5828. <CENTER><SAMP>{winhost.art.nowhere.edu}\mymail\SEP-94</SAMP></CENTER>
  5829. <P>
  5830. Note that in the case of remote folders, the directory/file path in the specification is 
  5831. determined by the operating system of the remote computer, <B>not</B> by
  5832. the operating system of the computer on which you are running Pine.
  5833. <P>
  5834. As you can tell, the name of the computer is in {} brackets
  5835. followed immediately by the name of the folder.  If, as in these
  5836. examples, there is no remote access protocol specified, then IMAP is
  5837. assumed.  See the Setup/collectionList Add or Change command's
  5838. <A HREF="h_composer_cntxt_server">Server:</A>
  5839. help text for a more detailed look at what options can be placed
  5840. between the brackets.
  5841.  
  5842. <P>
  5843. To the right of the brackets when a server name is present, or at the
  5844. start of the foldername if no server is present, the sharp sign,
  5845. "#", holds special meaning.  It indicates a folder name
  5846. outside the area reserved for your personal folders.  In fact, it's
  5847. used indicate that both the name of the folder, and a special phrase
  5848. telling Pine how to interpret the name follows.
  5849.  
  5850. <P>
  5851. So, for example, Pine can be used to access a newsgroup that might be 
  5852. available on your computer using:
  5853. <P>
  5854. <CENTER><SAMP>#news.comp.mail.pine</SAMP></CENTER>
  5855. <P>
  5856. The sharp sign indicates the folder name is outside your personal
  5857. folder area.  The "news." phrase after it tells Pine to 
  5858. interpret the remainder of the name as a newsgroup.
  5859.  
  5860. <P>
  5861. Similarly, to access a newsgroup on your IMAP server, you might
  5862. use something like:
  5863. <P>
  5864. <CENTER><SAMP>{wharhol.art.nowhere.edu}#news.comp.mail.misc</SAMP></CENTER>
  5865.  
  5866. <P>
  5867. There are a number of such special phrases (or "namespaces")
  5868. available.  For a more detailed explanation see the Setup/collectionList
  5869. Add or Change command's <A HREF="h_composer_cntxt_path">Path:</A> help text.
  5870.  
  5871. <P>
  5872. Note that "INBOX" has special meaning in both local and remote folder
  5873. names.  The name INBOX refers to your "principal incoming
  5874. message folder" and will be mapped to the actual file name used for your
  5875. INBOX on any given host.  Therefore, a name like
  5876. "{xxx.art.nowhere.edu}INBOX" refers to whatever file is used to
  5877. store incoming mail for you on that particular host.
  5878.  
  5879. <P>
  5880. <End of help on this topic>
  5881. </BODY>
  5882. </HTML>
  5883. ============= h_whatis_vcard ========================
  5884. <HTML>
  5885. <HEAD>
  5886. <TITLE>VCARD EXPLAINED</TITLE>
  5887. </HEAD>
  5888. <BODY>
  5889. <H1>What is the vCard format?</H1>
  5890. A "vCard" is a sort of electronic business card, for exchanging 
  5891. information about and among people and organizations electronically.  
  5892. More information about vCard can be found (as of May 1998) on the WWW site 
  5893. of the Internet Mail Consortium at the URL:
  5894. <P>
  5895. <CENTER><A HREF="http://www.imc.org/pdi/">http://www.imc.org/pdi/</A></CENTER>
  5896. <P>
  5897. <End of help on this topic>
  5898. </BODY>
  5899. </HTML>
  5900. ===== h_folder_open =====
  5901. <HTML>
  5902. <HEAD>
  5903. <TITLE>Explanation of Folder Selection</TITLE>
  5904. </HEAD>
  5905. <BODY>
  5906. <BR>
  5907. <BR>
  5908. This screen is designed to allow you to quickly and easily survey your
  5909. folders and select one to open.
  5910. <!--chtml if pinemode="function_key"-->
  5911. <PRE>
  5912. Navigating the List of Folders             General Pine Commands
  5913. ------------------------------             ---------------------
  5914.  P   Move to previous folder               ?   Show this help text
  5915.  N   Move to next folder
  5916.  -   Show previous screen of folders
  5917. Spc  Show next screen of folders
  5918.  W   WhereIs (search folder names)
  5919.  
  5920. Folder Selection Commands
  5921. -------------------------
  5922.  E   Exit the Folder Select menu (without selecting a folder)
  5923.  S   Select the currently highlighted folder
  5924. </PRE>
  5925. <!--chtml else-->
  5926. <PRE>
  5927. Navigating the List of Folders             General Pine Commands
  5928. ------------------------------             ---------------------
  5929. F5   Move to previous folder               F1  Show this help text
  5930. F6   Move to next folder
  5931. F7   Show previous screen of folders
  5932. F8   Show next screen of folders
  5933. F12  WhereIs (search folder names)
  5934.  
  5935. Folder Selection Commands
  5936. -------------------------
  5937. F3   Exit the Folder Select menu (without selecting a folder)
  5938. F4   Select the currently highlighted folder
  5939. </PRE>
  5940. <!--chtml endif-->
  5941. <P>
  5942. FOR MORE INFORMATION: See the section on
  5943. <A HREF="h_valid_folder_names">Valid Folder Names</A>.
  5944. <P>
  5945. <End of help on this topic>
  5946. </BODY>
  5947. </HTML>
  5948. ===== h_folder_subscribe =====
  5949. <HTML>
  5950. <HEAD>
  5951. <TITLE>Newsgroup Subcribe Screen explained</TITLE>
  5952. </HEAD>
  5953. <BODY>
  5954. <H1>FOLDER SUBSCRIBE HELP</H1>
  5955.  
  5956. This screen is designed to help you subscribe to newsgroups you are
  5957. not currently subscribed to.  The screen display is a list of all
  5958. available newsgroups (or possibly a partial list if you specified a
  5959. partial name when entering the screen).  Groups you have already
  5960. subscribed to have the letters "SUB" next to them.  You may
  5961. select a single new group to subscribe to by moving the cursor to that
  5962. group and pressing "S" or carriage return.  Alternatively,
  5963. you may change into ListMode with the "ListMode" command.
  5964. The display will change slightly so that each group has a checkbox in
  5965. front of it.  Use the cursor and the Set/Unset command to place an
  5966. "X" in front of each newsgroup you wish to subscribe to.
  5967. <P>
  5968.  
  5969. When you are finished marking groups, the "Subscribe"
  5970. command will subscribe you to those groups you have marked.  Note, you
  5971. may not unsubscribe to groups with this command.  Instead of the
  5972. "A" "Subscribe" command, use the "D"
  5973. UnSbscrbe command.
  5974. <P>
  5975.  
  5976. <!--chtml if pinemode="function_key"-->
  5977. <PRE>
  5978. Navigating the List of Newsgroups          General Pine Commands
  5979. ---------------------------------          ---------------------
  5980. F5   Move to previous group                F1   Show this help text
  5981. F6   Move to next group
  5982. F7   Show previous screen of groups
  5983. F8   Show next screen of groups
  5984. F12  WhereIs (search group names)
  5985. F9   Use ListMode
  5986.  
  5987. Group Selection Commands
  5988. -------------------------
  5989. F3  Exit the News Subscribe menu (without selecting any groups)
  5990. F4  Subscribe to the currently highlighted newsgroup
  5991. </PRE>
  5992. <!--chtml else-->
  5993. <PRE>
  5994. Navigating the List of Newsgroups          General Pine Commands
  5995. ---------------------------------          ---------------------
  5996.  P   Move to previous group                ?   Show this help text
  5997.  N   Move to next group
  5998.  -   Show previous screen of groups
  5999. Spc  Show next screen of groups
  6000.  W   WhereIs (search group names)
  6001.  L   Use ListMode
  6002.  
  6003. Group Selection Commands
  6004. -------------------------
  6005.  E   Exit the News Subscribe menu (without selecting any groups)
  6006.  S   Subscribe to the currently highlighted newsgroup
  6007. </PRE>
  6008. <!--chtml endif-->
  6009. <P>
  6010. When in ListMode, there is an additional command for marking groups to
  6011. subscribe to:
  6012. <P>
  6013. <!--chtml if pinemode="function_key"-->
  6014. <PRE>
  6015. ListMode Commands
  6016. -------------------------
  6017. F9  Set or unset the highlighted group
  6018. </PRE>
  6019. <!--chtml else-->
  6020. <PRE>
  6021. ListMode Commands
  6022. -------------------------
  6023. X   Set or unset the highlighted group
  6024. </PRE>
  6025. <!--chtml endif-->
  6026. <P>
  6027. <End of help on this topic>
  6028. </BODY>
  6029. </HTML>
  6030. ===== h_folder_postnews =====
  6031. <HTML>
  6032. <HEAD>
  6033. <TITLE>Newsgroup selecting for Posting explained</TITLE>
  6034. </HEAD>
  6035. <BODY>
  6036. This screen is designed to allow you to quickly and easily survey
  6037. the available newsgroups and select one to post news to.
  6038. <P>
  6039. <!--chtml if pinemode="function_key"-->
  6040. <PRE>
  6041. Navigating the List of Newsgroups          General Pine Commands
  6042. ---------------------------------          ---------------------
  6043. F5   Move to previous group                F1  Show this help text
  6044. F6   Move to next group
  6045. F7   Show previous screen of groups
  6046. F8   Show next screen of groups
  6047. F12  WhereIs (search group names)
  6048.  
  6049. Group Selection Commands
  6050. -------------------------
  6051. F3   Exit the Selection menu (without selecting a group)
  6052. F4   Select the currently highlighted newsgroup
  6053. </PRE>
  6054. <!--chtml else-->
  6055. <PRE>
  6056. Navigating the List of Newsgroups          General Pine Commands
  6057. ---------------------------------          ---------------------
  6058.  P   Move to previous group                ?  Show this help text
  6059.  N   Move to next group
  6060.  -   Show previous screen of groups
  6061. Spc  Show next screen of groups
  6062.  W   WhereIs (search group names)
  6063.  
  6064. Group Selection Commands
  6065. -------------------------
  6066.  E   Exit the Selection menu (without selecting a group)
  6067.  S   Select the currently highlighted newsgroup
  6068. </PRE>
  6069. <!--chtml endif-->
  6070. <P>
  6071. <End of help on this topic>
  6072. </BODY>
  6073. </HTML>
  6074. ===== h_folder_save =====
  6075. <HTML>
  6076. <HEAD>
  6077. <TITLE>Folder Select for Save Explained</TITLE>
  6078. </HEAD>
  6079. <BODY>
  6080. This screen is designed to allow you to quickly and easily survey your
  6081. folders and select one to use for saving the current message.
  6082. <P>
  6083.  
  6084. <!--chtml if pinemode="function_key"-->
  6085. <PRE>
  6086. Navigating the List of Folders             General Pine Commands
  6087. ------------------------------             ---------------------
  6088. F5   Move to previous folder               F1  Show this help text
  6089. F6   Move to next folder
  6090. F7   Show previous screen of folders
  6091. F8   Show next screen of folders
  6092. F12  WhereIs (search folder names)
  6093.  
  6094. Folder Selection Commands
  6095. -------------------------
  6096. F3   Exit the Folder Select menu (without selecting a folder)
  6097. F4   Select the currently highlighted folder
  6098. </PRE>
  6099. <!--chtml else-->
  6100. <PRE>
  6101. Navigating the List of Folders             General Pine Commands
  6102. ------------------------------             ---------------------
  6103.  P   Move to previous folder               ?  Show this help text
  6104.  N   Move to next folder
  6105.  -   Show previous screen of folders
  6106. Spc  Show next screen of folders
  6107.  W   WhereIs (search folder names)
  6108.  
  6109. Folder Selection Commands
  6110. -------------------------
  6111.  E   Exit the Folder Select menu (without selecting a folder)
  6112.  S   Select the currently highlighted folder
  6113. </PRE>
  6114. <!--chtml endif-->
  6115. <P>
  6116. FOR MORE INFORMATION: See the section on
  6117. <A HREF="h_valid_folder_names">Valid Folder Names</A>.
  6118. <P>
  6119. <End of help on this topic>
  6120. </BODY>
  6121. </HTML>
  6122. ===== h_folder_fcc =====
  6123. <HTML>
  6124. <HEAD>
  6125. <TITLE>Folder Select for Fcc Explained</TITLE>
  6126. </HEAD>
  6127. <BODY>
  6128. This screen is designed to allow you to quickly and easily survey your
  6129. folders and select one to use as the file carbon copy (fcc) for the
  6130. current message.
  6131. <P>
  6132.  
  6133. <!--chtml if pinemode="function_key"-->
  6134. <PRE>
  6135. Navigating the List of Folders             General Pine Commands
  6136. ------------------------------             ---------------------
  6137. F5   Move to previous folder               F1  Show this help text
  6138. F6   Move to next folder
  6139. F7   Show previous screen of folders
  6140. F8   Show next screen of folders
  6141. F12  WhereIs (search folder names)
  6142.  
  6143. Folder Selection Commands
  6144. -------------------------
  6145. F3   Exit the Folder Select menu (without selecting a folder)
  6146. F4   Select the currently highlighted folder
  6147. </PRE>
  6148. <!--chtml else-->
  6149. <PRE>
  6150. Navigating the List of Folders             General Pine Commands
  6151. ------------------------------             ---------------------
  6152.  P   Move to previous folder               ?  Show this help text
  6153.  N   Move to next folder
  6154.  -   Show previous screen of folders
  6155. Spc  Show next screen of folders
  6156.  W   WhereIs (search folder names)
  6157.  
  6158. Folder Selection Commands
  6159. -------------------------
  6160.  E   Exit the Folder Select menu (without selecting a folder)
  6161.  S   Select the currently highlighted folder
  6162. </PRE>
  6163. <!--chtml endif-->
  6164. <P>
  6165. FOR MORE INFORMATION: See the section on
  6166. <A HREF="h_valid_folder_names">Valid Folder Names</A>.
  6167. <P>
  6168. <End of help on this topic>
  6169. </BODY>
  6170. </HTML>
  6171. ===== h_folder_pattern_roles =====
  6172. <HTML>
  6173. <HEAD>
  6174. <TITLE>Folder Select for Current Folder Explained</TITLE>
  6175. </HEAD>
  6176. <BODY>
  6177. This screen is designed to allow you to quickly and easily survey your
  6178. folders and select one to use as the specific Current Folder
  6179. in a Pattern.
  6180. <P>
  6181.  
  6182. <!--chtml if pinemode="function_key"-->
  6183. <PRE>
  6184. Navigating the List of Folders             General Pine Commands
  6185. ------------------------------             ---------------------
  6186. F5   Move to previous folder               F1  Show this help text
  6187. F6   Move to next folder
  6188. F7   Show previous screen of folders
  6189. F8   Show next screen of folders
  6190. F12  WhereIs (search folder names)
  6191.  
  6192. Folder Selection Commands
  6193. -------------------------
  6194. F3   Exit the Folder Select menu (without selecting a folder)
  6195. F4   Select the currently highlighted folder
  6196. </PRE>
  6197. <!--chtml else-->
  6198. <PRE>
  6199. Navigating the List of Folders             General Pine Commands
  6200. ------------------------------             ---------------------
  6201.  P   Move to previous folder               ?  Show this help text
  6202.  N   Move to next folder
  6203.  -   Show previous screen of folders
  6204. Spc  Show next screen of folders
  6205.  W   WhereIs (search folder names)
  6206.  
  6207. Folder Selection Commands
  6208. -------------------------
  6209.  E   Exit the Folder Select menu (without selecting a folder)
  6210.  S   Select the currently highlighted folder
  6211. </PRE>
  6212. <!--chtml endif-->
  6213. <P>
  6214. FOR MORE INFORMATION: See the section on
  6215. <A HREF="h_valid_folder_names">Valid Folder Names</A>.
  6216. <P>
  6217. <End of help on this topic>
  6218. </BODY>
  6219. </HTML>
  6220. ===== h_folder_action_roles =====
  6221. <HTML>
  6222. <HEAD>
  6223. <TITLE>Folder Select Explained</TITLE>
  6224. </HEAD>
  6225. <BODY>
  6226. This screen is designed to allow you to quickly and easily survey your
  6227. folders and select one to use as the folder into which messages
  6228. matching this filter will be moved.
  6229. <P>
  6230.  
  6231. <!--chtml if pinemode="function_key"-->
  6232. <PRE>
  6233. Navigating the List of Folders             General Pine Commands
  6234. ------------------------------             ---------------------
  6235. F5   Move to previous folder               F1  Show this help text
  6236. F6   Move to next folder
  6237. F7   Show previous screen of folders
  6238. F8   Show next screen of folders
  6239. F12  WhereIs (search folder names)
  6240.  
  6241. Folder Selection Commands
  6242. -------------------------
  6243. F3   Exit the Folder Select menu (without selecting a folder)
  6244. F4   Select the currently highlighted folder
  6245. </PRE>
  6246. <!--chtml else-->
  6247. <PRE>
  6248. Navigating the List of Folders             General Pine Commands
  6249. ------------------------------             ---------------------
  6250.  P   Move to previous folder               ?  Show this help text
  6251.  N   Move to next folder
  6252.  -   Show previous screen of folders
  6253. Spc  Show next screen of folders
  6254.  W   WhereIs (search folder names)
  6255.  
  6256. Folder Selection Commands
  6257. -------------------------
  6258.  E   Exit the Folder Select menu (without selecting a folder)
  6259.  S   Select the currently highlighted folder
  6260. </PRE>
  6261. <!--chtml endif-->
  6262. <P>
  6263. FOR MORE INFORMATION: See the section on
  6264. <A HREF="h_valid_folder_names">Valid Folder Names</A>.
  6265. <P>
  6266. <End of help on this topic>
  6267. </BODY>
  6268. </HTML>
  6269. ===== h_abook_config =====
  6270. <HTML>
  6271. <HEAD>
  6272. <TITLE>SETUP ADDRESS BOOKS SCREEN</TITLE>
  6273. </HEAD>
  6274. <BODY>
  6275. <H1>SETUP ADDRESS BOOKS SCREEN</H1>
  6276. <H2>SETUP ADDRESS BOOKS COMMANDS</H2>
  6277. <!--chtml if pinemode="function_key"-->
  6278. <PRE>
  6279. Available  Commands                        
  6280. -------------------------------            
  6281. F1  Show Help Text                         
  6282. F3  Back to MAIN Pine menu                 
  6283. F4  Change configuration for address book  
  6284. F5  Move to previous address book          
  6285. F6  Move to next address book              
  6286. F7  Previous page of address books         
  6287. F8  Next page of address books             
  6288. F9  Add new address book                   
  6289. F10 Delete existing address book           
  6290. F11 Shuffle the order of address books     
  6291. F12 Whereis (search address book titles)   
  6292. </PRE>
  6293. <!--chtml else-->
  6294. <PRE>
  6295. Navigation                     General Pine Commands
  6296. -----------------------        ---------------------
  6297.  P  Prev Address Book             ?  Display this help text
  6298.  N  Next Address Book             E  Back to MAIN Pine menu
  6299.  -  Previous page
  6300. Spc Next page
  6301.  W  WhereIs (search for word in address book titles)
  6302.  
  6303. Setup Address Books Commands
  6304. ------------------------------------------------
  6305.  A  Add new address book          $  Shuffle the order of address books
  6306.  D  Delete existing address book  C  Change configuration for address book
  6307. </PRE>
  6308. <!--chtml endif-->
  6309.  
  6310. <H2>Description of the Setup Address Books Screen</H2>
  6311.  
  6312. This screen lets you add, delete, modify, or change the order of your
  6313. address books.  The "Add Abook" command brings up a blank form to 
  6314. fill in.  If you are adding a remote address book on an IMAP server
  6315. you should fill in the name of the IMAP server.  Otherwise, leave
  6316. that field blank.  (Note that remote IMAP address books are a Pine
  6317. concept and are unlikely to interoperate with other mail clients.)
  6318. For a remote address book, fill in the name of the remote folder
  6319. in the Folder field.  This should be a folder which is used only for
  6320. this one purpose, not a general purpose folder you expect to store
  6321. messages in.
  6322. <P>If you are adding a local address book, fill in the
  6323. Folder Name field with a local file name (e.g., .addressbook).
  6324. <P>
  6325. <B>Please note:</B> Remote address books stored on an IMAP server are 
  6326. of an entirely different format (namely, a special-purpose 
  6327. "mail folder") than that of the local addressbook familiar 
  6328. to Pine users.  Therefore, 
  6329. you cannot use "add a remote address book" to make an existing 
  6330. Pine .addressbook file you may have on a remote IMAP server accessible to 
  6331. Pine running on a different host.  
  6332. <P>
  6333.  
  6334. The "Del Abook" command allows you to remove an address book
  6335. from your configuration.  It will also ask you if you wish to remove
  6336. the data for that address book, which would erase all traces of the
  6337. address book if you answer Yes.
  6338. <P>
  6339.  
  6340. The "Change" command is similar to the "Add Abook" command.
  6341. The difference is that instead of adding a new address book to your
  6342. configuration, you are changing the configuration of an existing entry.
  6343. For example, you might want to correct a typing error or change a
  6344. nickname.  The "Change" command is not a move command.  If you
  6345. change the folder name or server name the data will not be moved for you.
  6346. <P>
  6347.  
  6348. The "Shuffle" command is used for two purposes.  If you shuffle
  6349. an address book toward another address book in the same group then
  6350. the order of those two address books will be swapped.  If you shuffle
  6351. the last Personal address book down towards the Global address book
  6352. section, it will become a Global address book.  If you shuffle
  6353. the first Global address book up it will become a Personal address
  6354. book.  The main difference between Personal and Global address
  6355. books is that Global address books are forced read-only.
  6356. <P><UL>
  6357. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  6358. </UL>
  6359. <P>
  6360. <End of help on this topic>
  6361. </BODY>
  6362. </HTML>
  6363. ===== h_abook_top =====
  6364. <HTML>
  6365. <HEAD>
  6366. <TITLE>ADDRESS BOOK LIST COMMANDS</TITLE>
  6367. </HEAD>
  6368. <BODY>
  6369. <H1>ADDRESS BOOK LIST COMMANDS</H1>
  6370. <!--chtml if pinemode="function_key"-->
  6371. <PRE>
  6372. Available  Commands -- Group 1         Available Commands -- Group 2
  6373. -------------------------------        ------------------------------
  6374. F1  Show Help Text                      F1  Show Help Text
  6375. F2  See commands in next group          F2  See commands in next group
  6376. F3  Exit to Main Menu                   F3  Quit Pine
  6377. F4  View/Edit selected address book
  6378. F5  Move to previous address book       F5  FOLDER LIST screen
  6379. F6  Move to next address book           F6  Specify a folder to go to
  6380. F7  Previous page                       F7  MESSAGE INDEX screen
  6381. F8  Next page                           F9  Print list of address books
  6382. F12 Whereis (search for word)
  6383. </PRE>
  6384. <!--chtml else-->
  6385. <PRE>
  6386. Navigation                       General Pine Commands
  6387. -----------------------          ---------------------
  6388.  P  Previous Entry                ?  Display this help text
  6389.  N  Next Entry                    O  Show all other available commands
  6390.  -  Previous page                 <  Back to MAIN Pine menu
  6391. Spc Next page                     Q  Quit Pine
  6392.  W  WhereIs (search for word)     L  FOLDER LIST screen
  6393.                   G  Specify a folder to go to
  6394. Address Book Commands             I  MESSAGE INDEX screen
  6395. ------------------------------------------------
  6396.  >  View/Edit selected address book
  6397.           or
  6398.  >  Search on selected directory server
  6399.  
  6400.  %  Print list of address books and directory servers
  6401. </PRE>
  6402. <!--chtml endif-->
  6403.  
  6404. <H2>Description of the Address Book List Screen</H2>
  6405.  
  6406. From this screen you may choose which address book you wish to view
  6407. or edit. For more information on address books, view one of your
  6408. address books (with
  6409. <!--chtml if pinemode="function_key"-->
  6410. F4
  6411. <!--chtml else-->
  6412. ">"
  6413. <!--chtml endif-->)
  6414. and see the Help Text there.<P>
  6415.  
  6416. You may also choose a directory server on which to search for entries.
  6417. You do that by highlighting the directory server line and using
  6418. <!--chtml if pinemode="function_key"-->
  6419. F4
  6420. <!--chtml else-->
  6421. ">"
  6422. <!--chtml endif-->.<P>
  6423.  
  6424. If you wish to define new address books or directory servers go to the Main
  6425. menu and choose Setup. You may then either choose to setup AddressBooks or
  6426. Directory (among other things). It's possible that the Directory option
  6427. will not be there if the Pine you are using does not contain LDAP directory
  6428. lookup functionality.
  6429.  
  6430. <P><UL>
  6431. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  6432. </UL><P>
  6433. <End of help on this topic>
  6434. </BODY>
  6435. </HTML>
  6436. ===== h_abook_opened =====
  6437. <HTML>
  6438. <HEAD>
  6439. <TITLE>THE PINE ADDRESS BOOK</TITLE>
  6440. </HEAD>
  6441. <BODY>
  6442. <H1>THE PINE ADDRESS BOOK</H1>
  6443. <H2>ADDRESS BOOK COMMANDS</H2>
  6444. <PRE>
  6445. <!--chtml if pinemode="function_key"-->
  6446. Available  Commands -- Group 1         Available Commands -- Group 2   
  6447. -------------------------------        ------------------------------  
  6448. F1  Show Help Text                      F1  Show Help Text             
  6449. F2  See commands in next group          F2  See commands in next group
  6450. F3  Exit this screen                    F3  Quit Pine                  
  6451. F4  View/Edit selected entry            F4  Go to MAIN menu screen     
  6452. F5  Move to previous entry              F5  FOLDER LIST screen         
  6453. F6  Move to next entry                  F6  Specify a folder to go to  
  6454. F7  Previous page of address book       F7  MESSAGE INDEX screen        
  6455. F8  Next page of address book           F8  Compose to entry using roles
  6456. F9  Add new entry to address book       F9  Print address book         
  6457. F10 Delete selected entry               F10 TakeAddr to another addrbook
  6458. F11 Compose to selected entry           F11 Save or Export addrbook selections
  6459. F12 Whereis (search address book)       F12 Forward entry by mail       
  6460.  
  6461. Available Commands -- Group 3                                           
  6462. ------------------------------                                          
  6463. F3  Select                              F6  Zoom (or unZoom)            
  6464. F5  Select Current                      F7  Apply Command to Selection  
  6465. <!--chtml else-->
  6466. Address Book Navigation        General Pine Commands
  6467. -----------------------        ---------------------
  6468.  P  Prev Address                  ?  Display this help text
  6469.  N  Next Address                  O  Show all other available commands
  6470.  -  Previous page of address book M  Back to MAIN menu
  6471. Spc Next page of address book     Q  Quit Pine
  6472.  W  WhereIs (search for word      C  Compose message to selected addr
  6473.      or name in address book)     #  Compose to addr using roles
  6474.  <  To List of Address Books if   L  FOLDER LIST screen
  6475.      more than one, else to MAIN  G  Specify a folder to go to
  6476.                                   I  MESSAGE INDEX screen
  6477.  
  6478. Address Book Commands
  6479. ----------------------------------------------------
  6480.  >  View/Update selected entry    D  Delete selected entries
  6481.  %  Print address book            S  Save or Export address book selections
  6482.  F  Forward entries by mail       @  Add new entry to address book
  6483.  
  6484.  ;  Select command                Z  Toggle Zoom Mode
  6485.  :  Select highlighted entry      A  Apply command to selected entries
  6486.  
  6487. <!--chtml endif-->
  6488. </PRE>
  6489. Note:  The presence or absence of the final four commands above is
  6490. controlled by the option 
  6491. <A HREF="h_config_enable_agg_ops">"enable-aggregate-command-set"</A>
  6492. which you may turn on in the SETUP CONFIGURATION screen.
  6493. <P>
  6494.  
  6495. <H2>Description of the Address Book Screen</H2>
  6496.  
  6497. This screen lets you edit and manage entries in your address book.  It
  6498. also acts as a short-cut for composing messages to people in the address
  6499. book.  When, from this screen, you press <!--chtml if pinemode="function_key"-->F11<!--chtml else-->"C"<!--chtml endif--> for ComposeTo, the
  6500. message starts "pre-addressed" to whatever address book entry is
  6501. currently selected.  If you use the <!--chtml if pinemode="function_key"-->F8<!--chtml else-->"#"<!--chtml endif--> for Role, you may first select a
  6502. role to use in your composition.
  6503. <P>
  6504. Pine's address book helps you keep a list of addresses you send email to so
  6505. you do not have to remember addresses that are often complex.  Each entry
  6506. in the address book has five fields, all of them optional.  The three
  6507. elements which are usually visible on the ADDRESS BOOK display, are: <DL>
  6508.  
  6509.     <P><DT>NICKNAME: <DD>A short easy-to-remember label to identify the entry.
  6510.     This is what you type in as you are addressing the message in the
  6511.     composer.  If there is a matching entry in your address book(s),
  6512.     Pine will extract the corresponding FullName and Address fields to
  6513.     generate the actual address for your message.
  6514.  
  6515.     <P><DT>FULLNAME: <DD>A longer field where you can put the full name 
  6516. of the
  6517.     person or organization.  Usually the full names are put in last
  6518.     name first so they sort nicely in alphabetical order.  Whatever
  6519.     you put as the name here will appear on the message when it is
  6520.     finally delivered.  Examples:<PRE>
  6521.        Garcia Marquez, Gabriel
  6522.        Henscheid, Eckhard
  6523.        Pine-Info mailing list
  6524.        Library materials renewal requests
  6525.        Kim An-guk
  6526.        "George III, King of Great Britain, 1738-1820"
  6527. </PRE>
  6528. (In the second-to-last example, no comma is used in the name so that 
  6529. the family name appears first in the address book and when the entry is 
  6530. used in the composer.
  6531. In the last example, retaining the commas is intended; 
  6532. double-quotation marks surround the name to 
  6533. prevent the transposition of its parts when the entry is used in 
  6534. the composer.)
  6535.  
  6536.     <P><DT>ADDRESS: <DD>This is the actual email address itself.  This must be
  6537.     a valid Internet address that conforms to the Internet message
  6538.     header standard, RFC-822.  (See also <A HREF="h_address_format">Explanation of Address formats</A>.)</DL>
  6539.  
  6540. The two fields which aren't usually visible are:<DL>
  6541.  
  6542.   <P><DT>FCC: <DD>The name of the folder you would like a copy of any outgoing
  6543.     message to this address to be saved in.  If this field is set, and
  6544.     this address is the first one in the message's To: header, then
  6545.     Pine will use this folder name for the FCC in lieu of the normal
  6546.     FCC folder name.
  6547.  
  6548.   <P><DT>COMMENTS: <DD>This field contains arbitrary text for your convenience.
  6549.     </DL>
  6550. <P>
  6551. Due to screen width limitations, these last two fields do not show up in
  6552. the normal ADDRESS BOOK display.  You may select the 
  6553. "View/Update" command to
  6554. view or modify them.  You may use the configuration variable
  6555. <A HREF="h_config_abook_formats">"addressbook-formats"</A>
  6556. to add these fields to your ADDRESS BOOK 
  6557. display, or to modify the format of the display.
  6558.  
  6559. <H2>Sorting the Address book</H2>
  6560.  
  6561. By default, address book entries are sorted alphabetically on the full
  6562. name with distribution lists sorted to the end.  Sorting can be changed by
  6563. resetting the address book sort rule in the Pine SETUP CONFIGURATION screen
  6564. --assuming you have "write" permission for the address book file.
  6565. <P>
  6566. Unlike the sorting of folders (which only changes presentation), sorting an
  6567. address book actually changes the file as it is kept on the computer.  For
  6568. this reason you won't be able to sort a shared or system-wide address
  6569. book.
  6570.  
  6571. <H2>Adding New Entries</H2>
  6572.  
  6573. The easiest way to add new entries to your address book is to use the
  6574. "TakeAddr" command when viewing a message.
  6575. This command allows you to take addresses from the header and body of the
  6576. message and put them into your address book, without having to type
  6577. them in.
  6578. <P>
  6579.  
  6580. To add a new entry from within the address book screen, use the AddNew
  6581. (<!--chtml if pinemode="function_key"-->F9<!--chtml else-->"@"<!--chtml endif-->) command.
  6582. Use this command both for adding a simple alias and for adding a
  6583. distribution list.
  6584.  
  6585. <H2>Distribution Lists</H2>
  6586.  
  6587. Address book entries can be simple cases of aliases (a single nickname is linked
  6588. to a single email address) or distribution lists (a single nickname
  6589. pointing at more than one email address).  Each distribution list has a
  6590. nickname, a full name and a list of addresses.  The addresses may be
  6591. actual addresses or they may be other nicknames in your address book.
  6592. They may even refer to other distribution lists.
  6593. There's really no difference between a simple alias and a distribution list,
  6594. other than the number of addresses.
  6595. Therefore, you can turn a simple alias with one address into a distribution
  6596. list simply by adding more addresses.
  6597. To add entries to an existing list or alias
  6598. use the View/Update (<!--chtml if pinemode="function_key"-->F4<!--chtml else-->">"<!--chtml endif-->) command.  Delete (<!--chtml if pinemode="function_key"-->F10<!--chtml else-->"D"<!--chtml endif-->) will delete
  6599. a single address from the list if the cursor is placed on the address;
  6600. it will delete the entire distribution list if the cursor is on the
  6601. nickname/fullname line.  View/Update may also be used to delete addresses
  6602. from a list.
  6603. <P>
  6604. Address field entries in distribution lists may take any one of three
  6605. forms: a nickname existing in any of the defined address books, a normal
  6606. address of the form "jsmith@art.nowhere.edu", or a complete
  6607. fullname/address combination, e.g. "John Smith
  6608. <jsmith@art.nowhere.edu>".
  6609. <P>
  6610. Distribution lists in Pine address books can only be used by the person or
  6611. people who have access to that address book.  They are not usually used to
  6612. implement discussion groups, but can be used to facilitate small
  6613. discussion groups if all the participants have access to the same shared
  6614. address book.
  6615.  
  6616. <H2>FCC and Comments</H2>
  6617.  
  6618. As mentioned above, each entry in the address book also has two other optional
  6619. fields, fcc and comments.  The command to look at or change either of these
  6620. is the same View/Update command used for all of the fields (<!--chtml if pinemode="function_key"-->F4<!--chtml else-->">"<!--chtml endif-->).  The
  6621. comments field is just for your own use.  The fcc field overrides the
  6622. default fcc if this address is the first one on the To line.  The WhereIs
  6623. command may be used to search for particular strings in the address book,
  6624. including fields which are not visible (like comment and fcc by default).
  6625.  
  6626. <H2>Aggregate Operations</H2>
  6627.  
  6628. If the feature
  6629. <A HREF="h_config_enable_agg_ops">"enable-aggregate-command-set"</A>
  6630. is turned on, then the four commands "Select",
  6631. "Select Current", "Zoom", and "Apply"
  6632. are available.  The two selection commands allow you to mark a set of
  6633. address book entries as being selected.  If you have more than one address
  6634. book, the selections may be in more than one of those address books.
  6635. The "Zoom" command will toggle between displaying only the selected
  6636. messages and all the messages.  The "Apply" command allows you to
  6637. apply one of the regular address book commands to all of the selected
  6638. entries.  Usually the address book commands apply to only the entry
  6639. highlighted by the cursor.  The "Apply" command works with the
  6640. commands "ComposeTo", "Delete", "Print", 
  6641. "Save", "Forward", and "Role".
  6642.  
  6643. <H2>Exporting and Forwarding Address book entries</H2>
  6644.  
  6645. Under the save option, when you use the Export (<!--chtml if pinemode="function_key"-->F11<!--chtml else-->"X"<!--chtml endif-->) command, the currently highlighted
  6646. address book entry is placed in a plain text file in your home directory
  6647. <!--chtml if pinemode="running"-->
  6648. (which, in the present configuration of your system, is
  6649.  "<!--#echo var="HOME_DIR"-->") 
  6650. <!--chtml endif-->
  6651. or current working directory
  6652. <!--chtml if pinemode="running"-->
  6653. (which, at least for your current Pine "session," 
  6654. is "<!--#echo var="CURRENT_DIR"-->") 
  6655. <!--chtml endif-->, depending on the 
  6656. <A HREF="h_config_use_current_dir">"use-current-dir"</A>
  6657. configuration setting.  If you have some entries selected and use the
  6658. Apply (<!--chtml if pinemode="function_key"-->F7<!--chtml else-->"A"<!--chtml endif-->) Export command, all of the selected addresses will be
  6659. placed in the text file.
  6660. <P>
  6661. When you use the Forward (<!--chtml if pinemode="function_key"-->F12<!--chtml else-->"F"<!--chtml endif-->) command, the currently highlighted
  6662. address book entry is placed in a special attachment and you are put into
  6663. the composer.  You can fill in some comments in the body of the message,
  6664. if you'd like, and send it to somebody else who uses Pine.  The recipient
  6665. may use the TakeAddr command on that message to insert the address book
  6666. entry you sent in their own address book.  If you have some entries
  6667. selected and use the Apply Forward command all of the selected entries
  6668. will be forwarded in a single message.  In Pine 4.00 or later you may
  6669. use Apply (<!--chtml if pinemode="function_key"-->F7<!--chtml else-->"A"<!--chtml endif-->) Forward to forward a copy of an entire address book.
  6670. The recipient must be using Pine 4 in order to receive this correctly.
  6671. One way for the recipient to handle this might be to create an empty
  6672. address book and then "Take" your forwarded address book entries into
  6673. that empty address book.
  6674.  
  6675. <H2>Multiple and/or Site-Wide Address books</H2>
  6676.  
  6677. You may have more than one personal address book.  In addition, there may
  6678. be one or more global address books.  This capability allows you to have
  6679. multiple personal address books (some of which may be shared) and it also
  6680. allows system administrators to implement site-wide address books that
  6681. contain entries for users on multiple machines within the organization.
  6682. <P><DL>
  6683. <DT>Searching. 
  6684.   <DD> If you enter a nickname when composing a message, your
  6685.   personal address books will be searched through in order, and then the
  6686.   global address book(s) searched. If more than one address book has an entry
  6687.   for the nickname, Pine uses the first one that it finds, so an entry in
  6688.   your personal address book would override a global address book entry. If
  6689.   after searching all the address books there is still no match, (Unix) Pine
  6690.   then searches the local host password file on the assumption that you have
  6691.   entered a local user name rather than an address book nickname.
  6692.   You may change the search order of your address books with the <!--chtml if pinemode="function_key"-->F3<!--chtml else-->$<!--chtml endif--> Shuffle
  6693.   command, but global address books are always searched after personal
  6694.   address books.
  6695.  
  6696.   <P><DT>Defining. 
  6697.   <DD> You define multiple personal address books in the 
  6698.   <A HREF="h_abook_config">SETUP AddressBooks</A> screen.  
  6699.   You can add as many as you like.  Global address books are usually
  6700.   site-wide address books defined by the System administrator, but
  6701.   you may define global address books of your own just like you define
  6702.   personal address books.
  6703.  
  6704.   <P><DT>Creating and updating. 
  6705.   <DD> Personal address books are normally created empty
  6706.   and populated by explicit additions from within Pine, e.g. via the
  6707.   TakeAddr command.  Unlike personal address books, global address books may
  6708.   not be modified/updated from within Pine; that is, they are Read-Only.
  6709.   Thus, global address books are created, populated and updated outside of
  6710.   Pine. They might be hand-edited, generated by a program from another
  6711.   database, or by copying an existing address book.  They might also be
  6712.   some other user's personal address book, and so be modified normally by
  6713.   that user but accessed Read-Only by you.  See the Pine Technical
  6714.   Notes document (included in the Pine distribution) for more information on
  6715.   this.
  6716.  
  6717.   <P><DT>Accessing.  
  6718.   <DD>There are two different types of address books in Pine.
  6719.   A local address book is stored in a regular file and the normal file
  6720.   access permissions apply.  A remote address book is stored on an IMAP
  6721.   server in a special folder which contains only messages pertaining to
  6722.   that address book.  The last message in the remote folder contains a
  6723.   copy of the address book data, and that data is copied to a local cache
  6724.   file in your home directory.  From there it is accessed just like a local
  6725.   address book.  The name of the cache file is kept track of in a special
  6726.   file called the "remote-abook-metafile", the name of which is stored in
  6727.   your Pine configuration file the first time you use a remote address book.
  6728.   Just as local Pine address books use a format that only Pine understands,
  6729.   remote Pine address books do the same and other mail reading programs
  6730.   are unlikely to be able to understand them.<P>
  6731.   While global address books are explicitly intended to be shared, there is
  6732.   nothing to prevent you from sharing a personal address book with other
  6733.   Pine users. This might be useful in the case of a small workgroup.
  6734.   However, it is recommended that updates to shared personal address books
  6735.   be done when other Pine users are not accessing the address book. Pine
  6736.   does not do any file-locking to manage concurrent updates to the
  6737.   addressbook, but it does check to see if the file has been modified before
  6738.   making any changes.  Consequently, inadvertent concurrent updates will
  6739.   only cause other Pine users to have to restart their address book
  6740.   operation, which will cause Pine to re-open the updated file.
  6741.  
  6742.   <P><DT>Converting to Remote.  
  6743.   <DD>The easiest way to convert an existing local
  6744.   address book into a remote address book is to create an empty new remote
  6745.   address book with the "Add Abook" command in the SETUP Addressbook screen.
  6746.   After you have added the empty
  6747.   remote address book, go into the screen for the address book you wish
  6748.   to copy and "Select" "All".  This selects every entry in that
  6749.   address book.  Then type the command "Apply Save".
  6750.   You will be asked for the address book to save to.  You may use ^P and ^N
  6751.   to get to the new empty address book, then hit RETURN and the addresses
  6752.   will be copied.
  6753.   At this point you'll probably want to unselect all the entries in the local
  6754.   address book before proceeding. You do that with
  6755.   "Select" "unselect All".
  6756.  
  6757. </DL>
  6758. <UL>
  6759. <LI><A HREF="h_address_format">Explanation of Address formats</A>
  6760. </UL>
  6761. <P><UL>
  6762. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  6763. </UL>
  6764. <P>
  6765. <End of help on this topic>
  6766. </BODY>
  6767. </HTML>
  6768. ===== h_abook_select_addr =====
  6769. <HTML>
  6770. <HEAD>
  6771. <TITLE>Addressbook Selection Explained</TITLE>
  6772. </HEAD>
  6773. <BODY>
  6774. <H1>SELECT ADDRESS</H1>
  6775. <!--chtml if pinemode="function_key"-->
  6776. <PRE>
  6777. Navigating the List of Messages               General Pine Commands
  6778. -------------------------------               ---------------------
  6779. F5   Move to previous entry                   F1  Show this help text
  6780. F6   Move to next entry
  6781. F7   Show previous screen of address book
  6782. F8   Show next screen of address book
  6783. F12  WhereIs (search through address book)
  6784.  
  6785. Address Selection Commands
  6786. --------------------------
  6787. F3   Exit the Address Select screen (without selecting an address)
  6788. F4   Select the currently highlighted entry
  6789. </PRE>
  6790. <!--chtml else-->
  6791. <PRE>
  6792. Navigating the List of Messages               General Pine Commands
  6793. -------------------------------               ---------------------
  6794.  P   Move to previous entry                   ?  Show this help text
  6795.  N   Move to next entry
  6796.  -   Show previous screen of address book
  6797. Spc  Show next screen of address book
  6798.  W   WhereIs (search through address book)
  6799.  
  6800. Address Selection Commands
  6801. --------------------------
  6802.  E   Exit the Address Select screen (without selecting an address)
  6803.  S   Select the currently highlighted entry
  6804. </PRE>
  6805. <!--chtml endif-->
  6806. <P>
  6807.  
  6808. This screen is designed to let you easily scan your address book(s) in
  6809. order to select an entry for the message you are composing.  You cannot
  6810. edit your address book in any way at this time, for address book
  6811. maintenance, select the address book command when not composing a message.
  6812. <P>
  6813.  
  6814. If you are composing a message and know the nickname of the person/list you
  6815. want, you can bypass this screen by simply typing in the nickname on the
  6816. appropriate header line (To:, Cc:, etc.)  Exiting this screen without
  6817. selecting an entry does not cancel your message.
  6818. <P>
  6819.  
  6820. FOR MORE INFORMATION on addressing see
  6821. <A HREF="h_address_format">Explanation of Address formats</A>, and the
  6822. <A HREF="h_abook_opened">Address Book Screen's</A>
  6823. help text.
  6824. <P>
  6825. <End of help on this topic>
  6826. </BODY>
  6827. </HTML>
  6828. ===== h_abook_select_top =====
  6829. <HTML>
  6830. <HEAD>
  6831. <TITLE>Addressbook Selection Navigation Explained</TITLE>
  6832. </HEAD>
  6833. <BODY>
  6834. <H1>NAVIGATING WHILE SELECTING ADDRESSES</H1>
  6835. <!--chtml if pinemode="function_key"-->
  6836. <PRE>
  6837. Navigating the List of Address Books       General Pine Commands
  6838. -------------------------------            ---------------------
  6839. F4   View the highlighted address book
  6840. F5   Move to previous address book         F1  Show this help text
  6841. F6   Move to next address book
  6842. F7   Show previous screen of address books
  6843. F8   Show next screen of address books
  6844. F12  WhereIs (search through address books)
  6845.  
  6846. Address Selection Commands
  6847. --------------------------
  6848. F3   Exit the Address Select screen (without selecting an address)
  6849. F4   Select the currently selected entries (if using ListMode)
  6850. F9   Change to ListMode
  6851. </PRE>
  6852. <!--chtml else-->
  6853. <PRE>
  6854. Navigating the List of Address Books       General Pine Commands
  6855. -------------------------------            ---------------------
  6856.  >   View the highlighted address book
  6857.  P   Move to previous address book         ?  Show this help text
  6858.  N   Move to next address book
  6859.  -   Show previous screen of address books
  6860. Spc  Show next screen of address books
  6861.  W   WhereIs (search through address books)
  6862.  
  6863. Address Selection Commands
  6864. --------------------------
  6865.  E   Exit the Address Select screen (without selecting an address)
  6866.  S   Select the currently selected entries (if using ListMode)
  6867.  L   Change to ListMode
  6868. </PRE>
  6869. <!--chtml endif-->
  6870. <P>
  6871.  
  6872. This screen is designed to let you easily scan your address book(s) in
  6873. order to select entries for the message you are composing.  You cannot
  6874. edit your address book in any way at this time.  For address book
  6875. maintenance, select the address book command when not composing a message.
  6876. <P>
  6877.  
  6878. If you are composing a message and know the nickname of the person/list you
  6879. want, you can bypass this screen by simply typing in the nickname on the
  6880. appropriate header line (To:, Cc:, etc.)  Exiting this screen without
  6881. selecting an entry does not cancel your message.
  6882. <P>
  6883.  
  6884. The ListMode command will add a column at the left edge of the screen.
  6885. You mark the entries which you wish to select with the "X" command.
  6886. This allows you to choose more than one entry at a time.
  6887. <P>
  6888.  
  6889. An alternative method of composing a message to entries in your
  6890. address book(s) is to first use the "Select" command from
  6891. the address book maintenance screen and then the "Apply"
  6892. "ComposeTo" command to start the composer composing to the
  6893. selected entries.
  6894. <P>
  6895.  
  6896. FOR MORE INFORMATION on addressing see
  6897. <A HREF="h_address_format">Explanation of Address formats</A>, and the
  6898. <A HREF="h_abook_opened">Address Book Screen's</A>
  6899. help text.
  6900. <P>
  6901. <End of help on this topic>
  6902. </BODY>
  6903. </HTML>
  6904. ===== h_abook_select_listmode =====
  6905. <HTML>
  6906. <HEAD>
  6907. <TITLE>Address Listmode Selection from Composer Explained</TITLE>
  6908. </HEAD>
  6909. <BODY>
  6910. <H1>COMPOSER: SELECT ADDRESSES</H1>
  6911. <!--chtml if pinemode="function_key"-->
  6912. <PRE>
  6913. Navigating the List of Messages                 General Pine Commands
  6914. -------------------------------                 ---------------------
  6915. F5   Move to previous entry                     F1  Show this help text
  6916. F6   Move to next entry
  6917. F7   Show previous screen of address book
  6918. F8   Show next screen of address book
  6919. F12  WhereIs (search through address book)
  6920.  
  6921. Address Selection Commands
  6922. --------------------------
  6923. F3   Exit the Address Select screen (without selecting an address)
  6924. F4   Select the currently highlighted entry
  6925. F9   Change to ListMode
  6926. </PRE>
  6927. <!--chtml else-->
  6928. <PRE>
  6929. Navigating the List of Messages                 General Pine Commands
  6930. -------------------------------                 ---------------------
  6931.  P   Move to previous entry                     ?  Show this help text
  6932.  N   Move to next entry
  6933.  -   Show previous screen of address book
  6934. Spc  Show next screen of address book
  6935.  W   WhereIs (search through address book)
  6936.  
  6937. Address Selection Commands
  6938. --------------------------
  6939.  E   Exit the Address Select screen (without selecting an address)
  6940.  S   Select the currently highlighted entry
  6941.  L   Change to ListMode
  6942. </PRE>
  6943. <!--chtml endif-->
  6944. <P>
  6945.  
  6946. This screen is designed to let you easily scan your address book(s) in
  6947. order to select entries for the message you are composing.  You cannot
  6948. edit your address book in any way at this time, for address book
  6949. maintenance, select the address book command when not composing a message.
  6950. <P>
  6951.  
  6952. If you are composing a message and know the nickname of the person/list you
  6953. want, you can bypass this screen by simply typing in the nickname on the
  6954. appropriate header line (To:, Cc:, etc.)  Exiting this screen without
  6955. selecting an entry does not cancel your message.
  6956. <P>
  6957.  
  6958. The ListMode command will add a column at the left edge of the screen.
  6959. You mark the entries which you wish to select with the "X" command.
  6960. This allows you to choose more than one entry at a time.
  6961. <P>
  6962.  
  6963. An alternative method of composing a message to entries in your
  6964. address book(s) is to first use the "Select" command from
  6965. the address book maintenance screen and then the "Apply"
  6966. "ComposeTo" command to start the composer composing to the
  6967. selected entries.
  6968. <P>
  6969.  
  6970. FOR MORE INFORMATION on addressing see
  6971. <A HREF="h_address_format">Explanation of Address formats</A>, and the
  6972. <A HREF="h_abook_opened">Address Book Screen's</A>
  6973. help text.
  6974. <P>
  6975. <End of help on this topic>
  6976. </BODY>
  6977. </HTML>
  6978. ===== h_abook_select_checks =====
  6979. <HTML>
  6980. <HEAD>
  6981. <TITLE>Address Selection from Composer Explained</TITLE>
  6982. </HEAD>
  6983. <BODY>
  6984. <H1>COMPOSER: SELECT ADDRESSES</H1>
  6985. <!--chtml if pinemode="function_key"-->
  6986. <PRE>
  6987. Navigating the List of Messages                 General Pine Commands
  6988. -------------------------------                 ---------------------
  6989. F5   Move to previous entry                     F1  Show this help text
  6990. F6   Move to next entry
  6991. F7   Show previous screen of address book
  6992. F8   Show next screen of address book
  6993. F12  WhereIs (search through address book)
  6994.  
  6995. Address Selection Commands
  6996. --------------------------
  6997. F3   Exit the Address Select screen (without selecting an address)
  6998. F4   Select the currently highlighted entry
  6999. F9   Set or Unset the highlighted entry
  7000. </PRE>
  7001. <!--chtml else-->
  7002. <PRE>
  7003. Navigating the List of Messages                 General Pine Commands
  7004. -------------------------------                 ---------------------
  7005.  P   Move to previous entry                     ?  Show this help text
  7006.  N   Move to next entry
  7007.  -   Show previous screen of address book
  7008. Spc  Show next screen of address book
  7009.  W   WhereIs (search through address book)
  7010.  
  7011. Address Selection Commands
  7012. --------------------------
  7013.  E   Exit the Address Select screen (without selecting an address)
  7014.  S   Select the currently highlighted entry
  7015.  X   Set or Unset the highlighted entry
  7016. </PRE>
  7017. <!--chtml endif-->
  7018. <P>
  7019.  
  7020. Mark the entries you wish to select with the "X Set/Unset"
  7021. command.  Type "S Select" to select all of the entries you
  7022. have marked, just as if you had typed them in by hand.
  7023. <P>
  7024.  
  7025. An alternative method of composing a message to entries in your
  7026. address book(s) is to first use the "Select" command from
  7027. the address book maintenance screen and then the "Apply"
  7028. "ComposeTo" command to start the composer composing to the
  7029. selected entries.
  7030. <P>
  7031.  
  7032. FOR MORE INFORMATION on addressing see
  7033. <A HREF="h_address_format">Explanation of Address formats</A>, and the
  7034. <A HREF="h_abook_opened">Address Book Screen's</A>
  7035. help text.
  7036. <P>
  7037. <End of help on this topic>
  7038. </BODY>
  7039. </HTML>
  7040. ===== h_abook_select_nicks_take =====
  7041. <HTML>
  7042. <HEAD>
  7043. <TITLE>Take Address Nickname Selection Explained</TITLE>
  7044. </HEAD>
  7045. <BODY>
  7046. <H1>TAKEADDR: SELECT NICKNAME</H1>
  7047. <!--chtml if pinemode="function_key"-->
  7048. <PRE>
  7049. Navigating the List of Messages                 General Pine Commands
  7050. -------------------------------                 ---------------------
  7051. F5   Move to previous entry                     F1  Show this help text
  7052. F6   Move to next entry
  7053. F7   Show previous screen of address book
  7054. F8   Show next screen of address book
  7055. F12  WhereIs (search through address book)
  7056.  
  7057. Message Selection Commands
  7058. --------------------------
  7059. F3   Exit the Nickname Select screen (without selecting an address)
  7060. F4   Select the currently highlighted entry
  7061. </PRE>
  7062. <!--chtml else-->
  7063. <PRE>
  7064. Navigating the List of Messages                 General Pine Commands
  7065. -------------------------------                 ---------------------
  7066.  P   Move to previous entry                     ?  Show this help text
  7067.  N   Move to next entry
  7068.  -   Show previous screen of address book
  7069. Spc  Show next screen of address book
  7070.  W   WhereIs (search through address book)
  7071.  
  7072. Message Selection Commands
  7073. --------------------------
  7074.  E   Exit the Nickname Select screen (without selecting an address)
  7075.  S   Select the currently highlighted entry
  7076. </PRE>
  7077. <!--chtml endif-->
  7078. <P>
  7079.  
  7080. This screen is designed to let you modify or add to an existing
  7081. address book entry.  You have already selected the name(s) and
  7082. address(es) through "Take Address".  This screen simply lets
  7083. you scan your address books and select the nickname to be
  7084. changed/augmented.  If you want to add a new entry, then you are in
  7085. the wrong place-- Select "Exit" command.
  7086. <P>
  7087.  
  7088. FOR MORE INFORMATION on addressing see
  7089. <A HREF="h_address_format">Explanation of Address formats</A>, and the
  7090. <A HREF="h_abook_opened">Address Book Screen's</A>
  7091. help text.
  7092. <P>
  7093. <End of help on this topic>
  7094. </BODY>
  7095. </HTML>
  7096. ===== h_abook_select_nick =====
  7097. <HTML>
  7098. <HEAD>
  7099. <TITLE>Nickname Selection Explained</TITLE>
  7100. </HEAD>
  7101. <BODY>
  7102. <H1>SELECT NICKNAME</H1>
  7103. <!--chtml if pinemode="function_key"-->
  7104. <PRE>
  7105. Navigating the List of Messages                 General Pine Commands
  7106. -------------------------------                 ---------------------
  7107. F5   Move to previous entry                     F1  Show this help text
  7108. F6   Move to next entry
  7109. F7   Show previous screen of address book
  7110. F8   Show next screen of address book
  7111. F12  WhereIs (search through address book)
  7112.  
  7113. Message Selection Commands
  7114. --------------------------
  7115. F3   Exit the Nickname Select screen (without selecting an address)
  7116. F4   Select the currently highlighted entry
  7117. </PRE>
  7118. <!--chtml else-->
  7119. <PRE>
  7120. Navigating the List of Messages                 General Pine Commands
  7121. -------------------------------                 ---------------------
  7122.  P   Move to previous entry                     ?  Show this help text
  7123.  N   Move to next entry
  7124.  -   Show previous screen of address book
  7125. Spc  Show next screen of address book
  7126.  W   WhereIs (search through address book)
  7127.  
  7128. Message Selection Commands
  7129. --------------------------
  7130.  E   Exit the Nickname Select screen (without selecting an address)
  7131.  S   Select the currently highlighted entry
  7132. </PRE>
  7133. <!--chtml endif-->
  7134. <P>
  7135.  
  7136. This screen is designed to let you look at the nicknames in your address
  7137. books before choosing a new one.
  7138. <P>
  7139.  
  7140. FOR MORE INFORMATION on addressing see
  7141. <A HREF="h_address_format">Explanation of Address formats</A>, and the
  7142. <A HREF="h_abook_opened">Address Book Screen's</A>
  7143. help text.
  7144. <P>
  7145. <End of help on this topic>
  7146. </BODY>
  7147. </HTML>
  7148. ===== h_takeaddr_screen =====
  7149. <HTML>
  7150. <HEAD>
  7151. <TITLE>Take Address Screen Explained</TITLE>
  7152. </HEAD>
  7153. <BODY>
  7154. <H1>TAKE ADDRESS COMMANDS</H1>
  7155. <!--chtml if pinemode="function_key"-->
  7156. <PRE>
  7157. Navigating the List of Addresses       Address Selection Commands        
  7158. --------------------------------       --------------------------        
  7159.  F5  Move to previous entry            F3  Exit without taking address
  7160.  F6  Move to next entry                F4  Take current address(es)
  7161.  F7  Show previous page of address list
  7162.  F8  Show next page of address list
  7163.  F2  WhereIs (search list)
  7164.                    --------------
  7165. Mode Toggle            F9  Set/Unset current address
  7166. -----------            F10 Set all
  7167.  F12 Toggle between List and single mode       F11 Unset all
  7168. </PRE>
  7169. <!--chtml else-->
  7170. <PRE>
  7171. Navigating the List of Addresses       Address Selection Commands
  7172. --------------------------------       --------------------------
  7173.  P  Move to previous entry              <  Exit without taking address
  7174.  N  Move to next entry                  T  Take address
  7175.  -  Show previous page of address list
  7176. Spc Show next page of address list
  7177.  W  WhereIs (search list)              List Mode
  7178.                        ---------
  7179. Single Mode                             X  Set/Unset current address
  7180. -----------                             A  Set all addresses
  7181.  L  Switch to list mode                 U  Unset all addresses
  7182.                     S  Switch to single mode
  7183. </PRE>
  7184. <!--chtml endif-->
  7185.  
  7186. <H2>Description of the Take Address Screen</H2>
  7187.  
  7188. This screen is designed to let you select one or more address/name
  7189. combinations from the current message into your address book.  The
  7190. cursor is initially placed on the line with the message author.  Other
  7191. lines include the names of people and/or mailing lists who also
  7192. received the message.  Other people "involved" in the
  7193. message (e.g. the person named as Reply-To:) are also listed here.
  7194. <P>
  7195.  
  7196. The simple case is adding a new, single entry into your address book. To
  7197. do this, simply highlight the correct line and press 
  7198. <!--chtml if pinemode="function_key"-->
  7199. F4.
  7200. <!--chtml else-->
  7201. "T".
  7202. <!--chtml endif-->
  7203. To create a new list or add to an existing list, switch the screen display
  7204. into List Mode by pressing
  7205. <!--chtml if pinemode="function_key"-->
  7206. F12.
  7207. <!--chtml else-->
  7208. "L".
  7209. <!--chtml endif-->
  7210. In List Mode, you select the
  7211. group of addresses you wish to manipulate by marking them with an
  7212. "X".
  7213. The Set/Unset
  7214. <!--chtml if pinemode="function_key"-->
  7215. (F9)
  7216. <!--chtml else-->
  7217. ("X")
  7218. <!--chtml endif-->
  7219. command will turn the "X" on for the
  7220. highlighted address if it was off or turn it off if it was previously on.
  7221. The SetAll command will select all of the addresses, and the UnSetAll
  7222. command will turn off all the selections.  Once you've gotten the
  7223. selection the way you want it, you may create a new list by pressing
  7224. <!--chtml if pinemode="function_key"-->
  7225. F4.
  7226. <!--chtml else-->
  7227. "T".
  7228. <!--chtml endif-->
  7229. <P>
  7230.  
  7231. In both the simple and list cases, after choosing to take the address,
  7232. you will be asked for the nickname of the entry.  Typing in a new name
  7233. creates the new entry/list.  Entering an existing nickname will replace
  7234. the entry (simple case) or add to the list (list case).  Alternatively,
  7235. you can press Ctrl-T at the nickname prompt and select an existing
  7236. nickname from your address book.
  7237. <P>
  7238.  
  7239. You will normally start in Single Mode, unless you used the Apply command
  7240. to startup the TakeAddr screen, in which case you will start in List Mode.
  7241. You may switch between the two modes at any time.  If you've already
  7242. selected several addresses in List Mode, those will be remembered when you
  7243. switch to Single Mode and then back to List Mode.  The set of addresses
  7244. that are pre-selected when you start in List Mode are the From addresses
  7245. of all of the messages you are operating on.  You may, of course, easily
  7246. erase those selections with the UnSetAll command.
  7247. <P>
  7248.  
  7249. If you have more than one writable address book, you will be prompted for
  7250. the name of the address book you wish to add the new entry to before
  7251. anything else. You can use ^N and ^P to choose among the defined address
  7252. books, or type in the address book name.
  7253. <P>
  7254.  
  7255. FOR MORE INFORMATION on addressing see
  7256. <A HREF="h_address_format">Explanation of Address formats</A>, and the
  7257. <A HREF="h_abook_opened">Address Book Screen's</A>
  7258. help text.
  7259. <P>
  7260. <End of help on this topic>
  7261. </BODY>
  7262. </HTML>
  7263. ============= h_abook_view ========================
  7264. <HTML>
  7265. <HEAD>
  7266. <TITLE>Address Book View Explained</TITLE>
  7267. </HEAD>
  7268. <BODY>
  7269. This function allows you to view the contents of an address book entry. You
  7270. can only view one entry at a time.
  7271. <P>
  7272. <DL>
  7273. <DT>Help
  7274. <!--chtml if pinemode="function_key"-->
  7275. (F1)
  7276. <!--chtml else-->
  7277. (?)
  7278. <!--chtml endif-->
  7279. </DT>
  7280. <DD>
  7281. Display this help text.
  7282.  
  7283. <DT>Abook
  7284. <!--chtml if pinemode="function_key"-->
  7285. (F3)
  7286. <!--chtml else-->
  7287. (<)
  7288. <!--chtml endif-->
  7289. </DT>
  7290. <DD>
  7291. Go back to index of address book entries.
  7292.  
  7293. <DT>Update
  7294. <!--chtml if pinemode="function_key"-->
  7295. (F4)
  7296. <!--chtml else-->
  7297. (U)
  7298. <!--chtml endif-->
  7299. </DT>
  7300. <DD>
  7301. Update (modify) this entry.
  7302.  
  7303. <DT>ComposeTo
  7304. <!--chtml if pinemode="function_key"-->
  7305. (F5)
  7306. <!--chtml else-->
  7307. (C)
  7308. <!--chtml endif-->
  7309. </DT>
  7310. <DD>Compose a message to the address(es) in this entry.
  7311.  
  7312. <DT>Role
  7313. <!--chtml if pinemode="function_key"-->
  7314. (F6)
  7315. <!--chtml else-->
  7316. (#)
  7317. <!--chtml endif-->
  7318. </DT>
  7319. <DD>Compose a message to the address(es) in this entry using roles.
  7320.  
  7321. <DT>Prev Page
  7322. <!--chtml if pinemode="function_key"-->
  7323. (F7)
  7324. <!--chtml else-->
  7325. (-)
  7326. <!--chtml endif-->
  7327. </DT>
  7328. <DD>
  7329. Show the previous page of the current entry.
  7330.  
  7331. <DT>Next Page
  7332. <!--chtml if pinemode="function_key"-->
  7333. (F8)
  7334. <!--chtml else-->
  7335. (Space)
  7336. <!--chtml endif-->
  7337. </DT>
  7338. <DD>
  7339. Show the next page of the current entry.
  7340.  
  7341. <DT>Print
  7342. <!--chtml if pinemode="function_key"-->
  7343. (F9)
  7344. <!--chtml else-->
  7345. (%)
  7346. <!--chtml endif-->
  7347. </DT>
  7348. <DD>Print the current entry.  You can select the
  7349. printer or the print command via the "Setup" command
  7350. on the Main menu.
  7351.  
  7352. <DT>WhereIs
  7353. <!--chtml if pinemode="function_key"-->
  7354. (F10)
  7355. <!--chtml else-->
  7356. (W)
  7357. <!--chtml endif-->
  7358. </DT>
  7359. <DD>Search the entry for a string of letters.  If it is
  7360. found, move to it.  The string can be one word or a phrase.
  7361. If there are multiple occurrences, the cursor moves to the
  7362. first occurrence beyond the current cursor position.
  7363.  
  7364. <DT>Fwd Email
  7365. <!--chtml if pinemode="function_key"-->
  7366. (F11)
  7367. <!--chtml else-->
  7368. (F)
  7369. <!--chtml endif-->
  7370. </DT>
  7371. <DD>Begin composition of a new mail message with the displayed
  7372. text already inserted in the message body.
  7373.  
  7374. </DL>
  7375. <P>
  7376. <End of help on this topic>
  7377. </BODY>
  7378. </HTML>
  7379. ============= h_ldap_view ========================
  7380. <HTML>
  7381. <HEAD>
  7382. <TITLE>LDAP Response View Explained</TITLE>
  7383. </HEAD>
  7384. <BODY>
  7385. This function allows you to view the contents of a directory entry. You
  7386. can only view one entry at a time.
  7387. <P>
  7388. <DL>
  7389. <DT>Help
  7390. <!--chtml if pinemode="function_key"-->
  7391. (F1)
  7392. <!--chtml else-->
  7393. (?)
  7394. <!--chtml endif-->
  7395. </DT>
  7396. <DD>
  7397. Display this help text.
  7398.  
  7399. <DT>Results Index
  7400. <!--chtml if pinemode="function_key"-->
  7401. (F3)
  7402. <!--chtml else-->
  7403. (<)
  7404. <!--chtml endif-->
  7405. </DT>
  7406. <DD>Go back to index of search results.
  7407.  
  7408. <DT>ComposeTo
  7409. <!--chtml if pinemode="function_key"-->
  7410. (F5)
  7411. <!--chtml else-->
  7412. (C)
  7413. <!--chtml endif-->
  7414. </DT>
  7415. <DD>Compose a message to the address(es) in this entry.
  7416.  
  7417. <DT>Role
  7418. <!--chtml if pinemode="function_key"-->
  7419. (F6)
  7420. <!--chtml else-->
  7421. (#)
  7422. <!--chtml endif-->
  7423. </DT>
  7424. <DD>Compose a message to the address(es) in this entry using roles.
  7425.  
  7426. <DT>Prev Page
  7427. <!--chtml if pinemode="function_key"-->
  7428. (F7)
  7429. <!--chtml else-->
  7430. (-)
  7431. <!--chtml endif-->
  7432. </DT>
  7433. <DD>
  7434. Show the previous page of the current entry.
  7435.  
  7436. <DT>Next Page
  7437. <!--chtml if pinemode="function_key"-->
  7438. (F8)
  7439. <!--chtml else-->
  7440. (Space)
  7441. <!--chtml endif-->
  7442. </DT>
  7443. <DD>
  7444. Show the next page of the current entry.
  7445.  
  7446. <DT>Print
  7447. <!--chtml if pinemode="function_key"-->
  7448. (F9)
  7449. <!--chtml else-->
  7450. (%)
  7451. <!--chtml endif-->
  7452. </DT>
  7453. <DD>Print the current entry on paper.  You can select the
  7454. printer or the print command via the "Setup" command
  7455. on the Main menu.
  7456.  
  7457. <DT>WhereIs
  7458. <!--chtml if pinemode="function_key"-->
  7459. (F10)
  7460. <!--chtml else-->
  7461. (W)
  7462. <!--chtml endif-->
  7463. </DT>
  7464. <DD>Search the entry for a string of letters.  If it is
  7465. found, move to it.  The string can be one word or a phrase.
  7466. If there are multiple occurrences, the cursor moves to the
  7467. first occurrence beyond the current cursor position.
  7468.  
  7469. <DT>Fwd Email
  7470. <!--chtml if pinemode="function_key"-->
  7471. (F11)
  7472. <!--chtml else-->
  7473. (F)
  7474. <!--chtml endif-->
  7475. </DT>
  7476. <DD>Begin composition of a new mail message with the displayed
  7477. text already inserted in the message body.
  7478.  
  7479. <DT>Save
  7480. <!--chtml if pinemode="function_key"-->
  7481. (F12)
  7482. <!--chtml else-->
  7483. (S)
  7484. <!--chtml endif-->
  7485. </DT>
  7486. <DD>Save the displayed entry to one of your address books or export
  7487. it to a file.
  7488. </DL>
  7489. <P>
  7490. <End of help on this topic>
  7491. </BODY>
  7492. </HTML>
  7493. ===== h_attachment_screen =====
  7494. <HTML>
  7495. <HEAD>
  7496. <TITLE>Attachment Index Screen Explained</TITLE>
  7497. </HEAD>
  7498. <BODY>
  7499. The "ATTACHMENT INDEX" displays a list of the current
  7500. message's attachments, and allows various operations on them.  The
  7501. first attachment is usually the message text, but does not include the
  7502. header portion of the message.
  7503. <P>
  7504. Available commands include:
  7505. <P>
  7506. <DL>
  7507.  
  7508. <DT>Help</DT>
  7509. <DD>Show this help text.
  7510.  
  7511. <DT>Msg #<I>num</I></DT>
  7512. <DD>Leave this screen without displaying or saving any attachments.
  7513.  
  7514. <DT>View</DT>
  7515. <DD>View the currently selected attachment.
  7516.  
  7517. <DT>Prev Attach</DT>
  7518. <DD>Move to previous attachment.
  7519.  
  7520. <DT>Next Attach</DT>
  7521. <DD>Move to next attachment.
  7522.  
  7523. <DT>Prev Page</DT>
  7524. <DD>Previous page of the listed attachments.
  7525.  
  7526. <DT>Next Page</DT>
  7527. <DD>Next page of the listed attachments.
  7528.  
  7529. <DT>Delete</DT>
  7530. <DD>Mark the currently selected attachment for Deletion.  The delete
  7531. flag <EM>only</EM> has effect when saving the message to a folder.
  7532. Attachments marked for deletion are exluded from the messsage when
  7533. it is saved.  In addition, the delete mark <EM>only</EM> applies to
  7534. this Pine session.
  7535.  
  7536. <DT>Undelete</DT>
  7537. <DD>Turn off the Delete flag for the selected attachment.
  7538.  
  7539. <DT>Save</DT>
  7540. <DD>Save the selected attachment to a file.  If the attachment is of
  7541. type "RFC822/Message", then the attachment will be saved to
  7542. the specified mail folder.
  7543.  
  7544. <DT>Export</DT>
  7545. <DD>If the attachment is of
  7546. type "RFC822/Message", then "Export" is used to
  7547. copy the message to a file in the same way this command works on 
  7548. messages in the MESSAGE INDEX and MESSAGE TEXT screens.
  7549.  
  7550. <DT>Pipe</DT>
  7551. <DD>Pipe the attachment contents into a UNIX command (if enabled).
  7552. A description of the Pipe sub-commands is  <A HREF="h_pipe_command">here</A>.
  7553.  
  7554. <DT>WhereIs</DT>
  7555. <DD>Find a matching string in the attachment list.
  7556.  
  7557. <DT>AboutAttch</DT>
  7558. <DD>Examine various aspects of the selected attachment.
  7559.  
  7560. <DT>Print</DT>
  7561. <DD>Print the selected attachment.
  7562.  
  7563. <DT>Forward</DT>
  7564. <DD>Forward the selected attachment as an attachment.
  7565. </DL>
  7566.  
  7567. <P>
  7568.  
  7569. All attachments can be saved or piped into a UNIX command, but some may
  7570. not be readily displayed by either Pine or an external tool.  In such
  7571. cases, the reason why the message cannot be displayed is displayed on
  7572. Pine's message line.
  7573. <P>
  7574. <End of help on this topic>
  7575. </BODY>
  7576. </HTML>
  7577. ============= h_mail_text_att_view ========================
  7578. <HTML>
  7579. <HEAD>
  7580. <TITLE>Attachment View Screen Explained</TITLE>
  7581. </HEAD>
  7582. <BODY>
  7583. This function allows you to view the contents of a text attachment. You
  7584. can only view one attachment at a time.
  7585. <P>
  7586. Available commands include:
  7587. <P>
  7588. <DL>
  7589.  
  7590. <DT>Help</DT>
  7591. <DD>Display this help text
  7592.  
  7593. <DT>AttchIndex</DT>
  7594. <DD>Leave viewer and return to the "ATTACHMENT INDEX" screen
  7595.  
  7596. <DT>Prev Page</DT>
  7597. <DD>Show the previous page of the current attachment.
  7598.  
  7599. <DT>Next Page</DT>
  7600. <DD>Show the next page of the current attachment by pressing the space bar.
  7601.  
  7602. <DT>Delete</DT>
  7603. <DD>Mark the viewed attachment for Deletion.  The delete
  7604. flag <EM>only</EM> has affect when saving the message to a folder.
  7605. Attachments marked for deletion are exluded from the messsage when
  7606. it is saved.  In addition, the delete mark <EM>only</EM> applies to
  7607. this Pine session.
  7608.  
  7609. <DT>Undelete</DT>
  7610. <DD>Turn off the Delete flag for the selected attachment.
  7611.  
  7612. <DT>Save</DT>
  7613. <DD>Copy the current attachment to a file.  If you just enter
  7614. a filename, the attachment will be saved with that name in
  7615. your home directory 
  7616. <!--chtml if pinemode="running"-->
  7617. (which, in the present configuration of your system, is
  7618.  "<!--#echo var="HOME_DIR"-->") 
  7619. <!--chtml endif-->
  7620. or current working directory
  7621. <!--chtml if pinemode="running"-->
  7622. (which, at least for your current Pine "session," 
  7623. is "<!--#echo var="CURRENT_DIR"-->") 
  7624. <!--chtml endif-->, depending on the
  7625. <A HREF="h_config_use_current_dir">"use-current-dir"</A>
  7626. configuration setting.  You may enter the full
  7627. path and filename to save it in another directory instead.
  7628.  
  7629. <DT>Export</DT>
  7630. <DD>If the attachment is of
  7631. type "RFC822/Message", then "Export" is used to
  7632. copy the message to a file in the same way this command works on 
  7633. messages in the MESSAGE INDEX and MESSAGE TEXT screens.
  7634. (If you have any <A HREF="h_config_display_filters">Display-Filters</A>
  7635. defined, they may affect the contents of the exported file.)
  7636.  
  7637. <DT>Pipe</DT>
  7638. <DD>Pipe the attachment contents into a UNIX command (if enabled)
  7639.  
  7640. <DT>WhereIs</DT>
  7641. <DD>Search the attachment for a string of letters.  If it is
  7642. found, move to it.  The string can be one word or a phrase.
  7643. If there are multiple occurrences, the cursor moves to the
  7644. first occurrence beyond the current cursor position.
  7645.  
  7646. <DT>Print</DT>
  7647. <DD>Print the current attachment on paper.  You can select the
  7648. printer or the print command via the "Setup" command
  7649. on the Main menu.
  7650.  
  7651. <DT>Forward</DT>
  7652. <DD>Forward the selected attachment as an attachment.
  7653. </DL>
  7654. <P>
  7655. <End of help on this topic>
  7656. </BODY>
  7657. </HTML>
  7658. ============= h_simple_text_view ==============
  7659. <HTML>
  7660. <HEAD>
  7661. <TITLE>Simple Text View Screen Explained</TITLE>
  7662. </HEAD>
  7663. <BODY>
  7664.  
  7665. The following commands are available on this screen:
  7666. <P>
  7667. <DL>
  7668. <DT>Help</DT>
  7669. <DD>Show this help text
  7670.  
  7671. <DT>Exit</DT>
  7672. <DD>Exit Viewer, and go back to mail processing
  7673.  
  7674. <DT>Prev Page</DT>
  7675. <DD>Show the previous page text
  7676.  
  7677. <DT>Next Page</DT>
  7678. <DD>Show the next page of text by pressing the space bar
  7679.  
  7680. <DT>Print</DT>
  7681. <DD>Print the displayed text on paper.  You can select the
  7682. printer or the print command via the "Setup" command
  7683. on the Main menu.
  7684.  
  7685. <DT>Fwd Email</DT>
  7686. <DD>Begin composition of a new mail message with the displayed
  7687. text already inserted in the message body.
  7688.  
  7689. <DT>Save</DT>
  7690. <DD>Copy the displayed text to a file.  If you just enter
  7691. a filename, the attachment will be saved with that name in
  7692. your 
  7693. home directory 
  7694. <!--chtml if pinemode="running"-->
  7695. (which, in the present configuration of your system, is
  7696.  "<!--#echo var="HOME_DIR"-->") 
  7697. <!--chtml endif-->
  7698. or current working directory
  7699. <!--chtml if pinemode="running"-->
  7700. (which, at least for your current Pine "session," 
  7701. is "<!--#echo var="CURRENT_DIR"-->") 
  7702. <!--chtml endif-->, depending on the
  7703. <A HREF="h_config_use_current_dir">"use-current-dir"</A>
  7704. configuration setting.   You may enter the full
  7705. path and filename to save it in another directory instead.
  7706.  
  7707. <DT>WhereIs</DT>
  7708. <DD>Search the attachment for a string of letters.  If it is
  7709. found, move to it.  The string can be one word or a phrase.
  7710. If there are multiple occurrences, the cursor moves to the
  7711. first occurrence beyond the current cursor position.
  7712. </DL>
  7713. <P>
  7714. <End of help on this topic>
  7715. </BODY>
  7716. </HTML>
  7717. ======= h_pine_for_windows ========
  7718. <HTML>
  7719. <HEAD>
  7720. <TITLE>GETTING HELP IN PINE</TITLE>
  7721. </HEAD>
  7722. <BODY>
  7723. <H1>Getting Help In PC-Pine</H1>
  7724. PC-Pine offers specific help for every screen via the 
  7725. <!--chtml if pinemode="function_key"-->
  7726. "F1" key.
  7727. <!--chtml else-->
  7728. "?" or "^G"
  7729. keys.  (The Ctrl-G key is used in contexts where "?" would be
  7730. mistaken as text being entered.)
  7731. <!--chtml endif-->
  7732. <P>
  7733.  
  7734. The <A HREF="main_menu_tx">MAIN MENU</A> help 
  7735. <!--chtml if pinemode="function_key"-->
  7736. ("F1")
  7737. <!--chtml else-->
  7738. ("?") 
  7739. <!--chtml endif-->
  7740. provides a general overview of Pine, as
  7741. well as information specific to that screen.  There is also a
  7742. "<A HREF="h_news">Release Notes</A>" command available
  7743. from the MAIN MENU.
  7744.  
  7745. <P>
  7746. Although this version of Pine is for Microsoft Windows, it is not what
  7747. native Windows users would consider a full
  7748. "Graphical User Interface" application.
  7749.  
  7750. <P>
  7751. However, it does make available many of the controls such users are
  7752. accustom to such as scrollbars, menu and toolbars.
  7753.  
  7754. <P>
  7755. In addition, it offers considerable mouse support.  For example,
  7756. screens with selectable items (such as messages in the MESSAGE INDEX,
  7757. or hyperlinks and URLs in MESSAGE TEXT when the suitable
  7758. "enable-msg-view-*" features are enabled) can be
  7759. highlighted with a single click or chosen with a double click.
  7760. Similarly, menu items on the bottom of the screen can be executed by
  7761. placing the mouse on them and single clicking.
  7762.  
  7763. <P>
  7764. Further, PC-Pine provides context-sensitive pop-up menus that offer
  7765. convenient short-cuts when selecting or navigating PC-Pines screens.
  7766. For example, a right-button click on a message in the MESSAGE INDEX
  7767. brings up a menu offering to, among other things, View the selected
  7768. message in a separate window.  A similar menu's offered when
  7769. right-button clicking on selectable attachments (if the
  7770. "enable-msg-view-attachments" feature is enabled.
  7771.  
  7772. <P>
  7773. Pop-ups also allow for convenient Copying of text onto the clipboard.
  7774. Use the drag the mouse with the left-button down to select text, and then
  7775. the right-button pop-up to copy it onto the clipboard.
  7776.  
  7777. <P>
  7778. Similarly, you can Cut/Copy/Paste in the compser using this same
  7779. method.  In addtion, if you move the mouse above the top or below the
  7780. bottom of the window while selecting text the message text will
  7781. scroll.  Shift-Click will extend an existing selection.
  7782.  
  7783. <P>
  7784. <End of help on this topic>
  7785. </BODY>
  7786. </HTML>
  7787. ===== h_composer =====
  7788. <HTML>
  7789. <HEAD>
  7790. <TITLE>COMPOSER COMMANDS</TITLE>
  7791. </HEAD>
  7792. <BODY>
  7793. <H1>COMPOSER COMMANDS</H1>
  7794.  
  7795. CURSOR MOTION KEYS                     |EDITING KEYS<BR>
  7796.   ^B (Left Arrow)   Back character     | ^D       Delete current character<BR>
  7797.   ^F (Right Arrow)  Forward character  | ^H (DEL) Delete previous character<BR>
  7798.   ^P (Up Arrow)     Previous line      | ^^       Set a <A HREF="h_compose_markcutpaste">mark</A><BR>
  7799.   ^N (Down Arrow)   Next line          | <!--chtml if pinemode="function_key"-->F9<!--chtml else-->^K<!--chtml endif-->       <A HREF="h_compose_markcutpaste">Cut</A> marked text or<BR>
  7800.   ^A                Beginning of line  |           delete current line<BR>
  7801.   ^E                End of line        | <!--chtml if pinemode="function_key"-->F10<!--chtml else-->^U<!--chtml endif-->       <A HREF="h_compose_markcutpaste">Paste</A> text, undelete lines<BR>
  7802.   ^Y                Previous page      |           cut with ^K, or unjustify<BR>
  7803.   ^V                Next page          |-------------------------------------<BR>
  7804.   ^@ (Ctrl-SPACE)   Next word          |SCREEN/COMPOSITION COMMANDS<BR>
  7805. ---------------------------------------| <!--chtml if pinemode="function_key"-->F6<!--chtml else-->^W<!--chtml endif-->       <A HREF="h_composer_search">Whereis</A> (search for string)<BR>
  7806. MESSAGE COMMANDS | GENERAL COMMANDS    | <!--chtml if pinemode="function_key"-->F12<!--chtml else-->^T <!--chtml endif-->      <A HREF="h_compose_spell">Spell checker</A><BR>
  7807.  <!--chtml if pinemode="function_key"-->F3<!--chtml else-->^C<!--chtml endif-->   <A HREF="h_compose_cancel">Cancel</A>     |  <!--chtml if pinemode="function_key"-->F1<!--chtml else-->^G<!--chtml endif-->    Get help     | <!--chtml if pinemode="function_key"-->F4<!--chtml else-->^J<!--chtml endif-->       <A HREF="h_compose_justify">Justify</A> paragraph<BR>
  7808.  <!--chtml if pinemode="function_key"-->F11<!--chtml else-->^O <!--chtml endif-->  <A HREF="h_common_postpone">Postpone</A>   |  ^Z    <A HREF="h_common_suspend">Suspend</A>      | ^L       Redraw Screen<BR>
  7809.  <!--chtml if pinemode="function_key"-->F2<!--chtml else-->^X<!--chtml endif-->   <A HREF="h_compose_send">Send</A>       |  <!--chtml if pinemode="function_key"-->F6<!--chtml else-->^_<!--chtml endif-->    <A HREF="h_compose_alted">Alt. editor</A>  | <!--chtml if pinemode="function_key"-->F5<!--chtml else-->^R<!--chtml endif-->       <A HREF="h_compose_readfile">Read in a file</A><BR>
  7810.  
  7811. <P>
  7812. NOTE:
  7813. <OL>
  7814.  <LI>For help on a particular command, hilite the bold text associated
  7815. with it above and hit Return.
  7816.  <LI> The availability of certain commands
  7817. is determined by Pine configuration files and system capabilities.
  7818. At some sites, certain commands may not be available due to security or
  7819. support concerns.
  7820.  <LI>Pine does not use the following keys:  Ctrl-S, Ctrl-Q, Ctrl-],
  7821. Ctrl-\, ESC.
  7822.  <LI>For special handling of Ctrl-S and Ctrl-Q see special comments regarding
  7823. <A HREF="h_special_xon_xoff">"XOFF/XON"</A>.
  7824. </OL>
  7825.  
  7826. <P>
  7827. HINT: To move rapidly to the bottom of a message you are composing,
  7828. enter ^W^V.  To go to the top, ^W^Y.  These can be used in conjunction
  7829. with the Mark and Cut commands to eliminate large amounts of unwanted
  7830. text in a Reply.
  7831.  
  7832. <H2>Description of Composer</H2>
  7833.  
  7834. Pine has a built-in editing program which allows you to compose messages
  7835. without having to leave Pine.  The editor is designed to be very simple to
  7836. use so that you can get started writing email right away.
  7837.  
  7838. <P>
  7839. Messages are usually just text, about 80 columns wide.  Using upper and
  7840. lower case is encouraged.  On some systems the size limit of the message
  7841. is about 100,000 characters, which is about 2,000 lines.  You can include
  7842. punctuation and special characters found on most keyboards, but you can't
  7843. include characters with diacritical marks and certain special symbols.
  7844.  
  7845. <P>
  7846. Text automatically wraps as you type past the end of a line so you do not
  7847. have to hit return.  Using the
  7848. "<A HREF="h_compose_justify">Justify</A>" command,
  7849. you can also reformat text explicitly, perhaps after you have
  7850. deleted some text.
  7851.  
  7852. <P>
  7853. You can include other text files with the 
  7854. "<A HREF="h_compose_readfile">Read File</A>" command
  7855. which will prompt you for the name of the file to insert at the
  7856. current cursor postion.
  7857.  
  7858. <P>
  7859. <UL>
  7860. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  7861. </UL>
  7862. <P>
  7863. <End of help on this topic>
  7864. </BODY>
  7865. </HTML>
  7866. ====== h_composer_browse =====
  7867. <HTML>
  7868. <HEAD>
  7869. <TITLE>BROWSER</TITLE>
  7870. </HEAD>
  7871. <BODY>
  7872. <H1>BROWSER</H1>
  7873. This screen lets you browse your files and directories.  To go to another 
  7874. directory (identified by "(dir)"), move the cursor to it and 
  7875. choose "Select" (the default choice on the menu); 
  7876. or choose "Goto" and enter the name of the directory.
  7877. <!--chtml if pinemode="os_windows"-->
  7878. <!--chtml else--> 
  7879. In Unix Pine, you may use 
  7880. "~" to refer to your home directory or "~user" to refer 
  7881. to another's home directory.  
  7882. <!--chtml endif--><P>
  7883. To select a file, move the cursor to it and 
  7884. choose "Select" (the default choice on the menu).  
  7885. <P>
  7886. <UL>
  7887. <LI>Note <B>if</B> you are currently using the BROWSER for choosing a file for 
  7888. inclusion in the 
  7889. message body (that is, you chose "Read File" with the cursor under 
  7890. the 
  7891. "----- Message Text -----" line
  7892. while composing, then "To Files"):  Since the file 
  7893. selected will become part of the message text, it must be in a format 
  7894. suitable for that (Pine does not check!), such as a plain text file.
  7895. Files of other formats (for example, graphics, databases, software 
  7896. programs) should be 
  7897. <B>attached</B> to the message instead --
  7898. by moving the cursor in the COMPOSE MESSAGE screen into the 
  7899. message header area and pressing 
  7900. <!--chtml if pinemode="function_key"-->
  7901. F6.
  7902. <!--chtml else-->
  7903. Ctrl-J.
  7904. <!--chtml endif--> 
  7905.  
  7906. <P><LI>
  7907. Note <B>if</B> you are currently using the BROWSER for saving a message 
  7908. attachment, or exporting a message, to a file: You can use the Add command to 
  7909. provide the name for a new file to save/export to, and then select that name 
  7910. to use it for the save/export operation.  Back at the prompt 
  7911. "EXPORT: Copy message to file in ..." hit Enter, then choose 
  7912. either Overwrite or Append (it doesn't make a difference, since the file is 
  7913. so far empty).  Note: If you cancel the 
  7914. operation at that point, the file created with the Add command will remain 
  7915. 0 bytes in size.
  7916.  
  7917. </UL>
  7918. <P><UL>
  7919. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  7920. </UL>
  7921. <P>
  7922. <End of help on this topic>
  7923. </BODY>
  7924. </HTML>
  7925. ====== h_composer_ins =====
  7926. <HTML>
  7927. <HEAD>
  7928. <TITLE>INSERT TEXT FILE</TITLE>
  7929. </HEAD>
  7930. <BODY>
  7931. <H1>INSERT TEXT FILE</H1>
  7932.  
  7933. Use this function to insert a text file into your message. The file name
  7934. given can be an absolute file path name for your system
  7935. <!--chtml if pinemode="os_windows"-->
  7936. (for example, "H:\SIGFILES\FULLINFO.TXT"), a file
  7937. with a relative pathname, or simply a file name without
  7938. drive or directory specification.  
  7939. <!--chtml else-->
  7940. (for example, "/tmp/exported.earlier" on Unix hosts), 
  7941. a file in your home directory, or a file path relative to your 
  7942. home directory.  In Unix Pine, you may use "~" to refer to 
  7943. your home directory or "~user" to refer to another
  7944. account's home directory.
  7945. <!--chtml endif-->
  7946. <P>
  7947. No wild card characters may be used.  
  7948. The file must reside on the system running Pine.
  7949. <P>
  7950. If the 
  7951. <A HREF="h_config_use_current_dir">"use-current-dir"</A>
  7952. feature is set, names are relative to your current working directory 
  7953. <!--chtml if pinemode="running"-->
  7954. (which, at least for your current Pine "session," 
  7955. is "<!--#echo var="CURRENT_DIR"-->") 
  7956. <!--chtml endif-->
  7957. rather than your home directory
  7958. <!--chtml if pinemode="running"-->
  7959. (which, in the present configuration of your system, is
  7960.  "<!--#echo var="HOME_DIR"-->") 
  7961. <!--chtml endif-->
  7962. .
  7963. <P><UL>
  7964. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  7965. </UL>
  7966. <P>
  7967. <End of help on this topic>
  7968. </BODY>
  7969. </HTML>
  7970. ====== h_composer_ins_m =====
  7971. <HTML>
  7972. <HEAD>
  7973. <TITLE>INSERT MESSAGE</TITLE>
  7974. </HEAD>
  7975. <BODY>
  7976. <H1>INSERT MESSAGE</H1>
  7977.  
  7978. Type in the number of a message in the currently open folder to insert it
  7979. into your message.
  7980. <P><UL>
  7981. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  7982. </UL>
  7983. <P>
  7984. <End of help on this topic>
  7985. </BODY>
  7986. </HTML>
  7987. ====== h_composer_search =====
  7988. <HTML>
  7989. <HEAD>
  7990. <TITLE>Explanation of Composer Whereis Command </TITLE>
  7991. </HEAD>
  7992. <BODY>
  7993. <H1>Help For Whereis Command</H1>
  7994.  
  7995. Whereis is used to search the message for a word or part of a word.
  7996. When searching in the composer, only the message part of your mail is
  7997. searched, and the cursor is put on the first occurrence appearing
  7998. after the location of the cursor.  The search will wrap to the
  7999. beginning of the message when it no longer finds matches in the
  8000. remainder of the message.
  8001.  
  8002. To search for the same string a second time, press 
  8003. <!--chtml if pinemode="function_key"-->
  8004. "F6"
  8005. <!--chtml else-->
  8006. "^W"
  8007. <!--chtml endif-->
  8008. to begin search and then just press RETURN to accept the previous
  8009. search string shown in square brackets rather than entering a new
  8010. search string.<P>
  8011.  
  8012. The "Search" prompt has several sub-command available:
  8013.  
  8014. <DL>
  8015. <DT>Get Help</DT>
  8016. <DD> Takes you to this help page.
  8017.  
  8018. <DT>Cancel</DT>
  8019. <DD> Cancels the prompt.  No search takes place.
  8020.  
  8021. <DT>First Line</DT>
  8022. <DD> Takes you back to the composer with the cursor on the first character
  8023. of the first line of text.
  8024.  
  8025. <DT>Last Line</DT>
  8026. <DD> Takes you back to the composer with the cursor on the last character
  8027. of the last line of text.
  8028.  
  8029. <DT>Replace (Optional)</DT>
  8030. <DD> This sub-command is enabled by the 
  8031. <A HREF="h_config_enable_search_and_repl">"enable-search-and-replace"</A>
  8032. feature; see its help screen for details on how replacing works.
  8033.  
  8034. </DL>
  8035.  
  8036. <End of help on this topic>
  8037. </BODY>
  8038. </HTML>
  8039. ======= h_composer_to ====
  8040. <HTML>
  8041. <HEAD>
  8042. <TITLE>THE MESSAGE COMPOSER'S TO FIELD</TITLE>
  8043. </HEAD>
  8044. <BODY>
  8045. <H1>THE MESSAGE COMPOSER'S TO FIELD</H1>
  8046.  
  8047. <H2>The "To:" field</H2>
  8048. The address you enter here must be a valid email address which is reachable
  8049. from your site. 
  8050.  
  8051. <H2>Email Address Format</H2>
  8052. You may enter a full name and email address, 
  8053. <!--chtml if pinemode="os_windows"-->
  8054. <!--chtml else-->
  8055. a local (meaning, on the same 
  8056. host as the one you are running Pine on) username that Pine will
  8057. complete for you, 
  8058. <!--chtml endif-->
  8059. the nickname of someone in a 
  8060. <A HREF="h_abook_opened">Pine Address Book</A>, or a local
  8061. mail alias defined by your system administrator.  When you move the cursor
  8062. out of this field, the nicknames will be expanded to the addresses in your
  8063. address book, and the local usernames will be expanded to include the 
  8064. persons' actual names.  You may enter as many addresses as you wish, but they 
  8065. must be separated by commas.  You can move around this and other header fields
  8066. with the arrow keys and use many of the usual composer editing keys.
  8067. <P>
  8068. <UL>
  8069. <LI><A HREF="h_address_format">Explanation of Address formats</A>
  8070. </UL>
  8071.  
  8072. <P>
  8073. <H2>MESSAGE HEADER COMMANDS</H2>
  8074. <!--chtml if pinemode="function_key"-->
  8075. CURSOR MOTION KEYS----------------------|EDITING KEYS-------------------------<BR>
  8076. ^B (Left Arrow)    Back character       | ^D       Delete current character<BR>
  8077. ^F (Right Arrow)   Forward character    | ^H (DEL) Delete previous character<BR>
  8078. ^P (Up Arrow)      Previous line        |<BR>
  8079. ^N (Down Arrow)    Next line            | F9       Cut marked text or<BR>
  8080. ^A                 Beginning of line    |            delete current line<BR>
  8081. ^E                 End of line          | F10      Undelete line(s)<BR>
  8082. F7                 Previous page        | ^W       <A HREF="h_composer_search">Whereis</A> (search text)<BR>
  8083. F8                 Next page            |-------------------------------------<BR>
  8084. ^@ (Ctrl-SPACE)    Next word            |SCREEN/COMPOSITION COMMANDS<BR>
  8085. ----------------------------------------|<BR>
  8086. MESSAGE COMMANDS  | GENERAL COMMANDS    | F12    To Addressbook/Browser<BR>
  8087. F3   <A HREF="h_compose_cancel">Cancel</A>       |  F1    Get help     | F4     Attach File<BR>
  8088. F11  <A HREF="h_common_postpone">Postpone</A>     |  ^Z    <A HREF="h_common_suspend">Suspend</A>      | ^L     Redraw Screen<BR>
  8089. F2   <A HREF="h_compose_send">Send</A>         |                     | F5     <A HREF="h_compose_richhdr">Rich Headers</A><BR>
  8090. <!--chtml else-->
  8091. CURSOR MOTION KEYS----------------------|EDITING KEYS-------------------------<BR>
  8092. ^B (Left Arrow)    Back character       | ^D       Delete current character<BR>
  8093. ^F (Right Arrow)   Forward character    | ^H (DEL) Delete previous character<BR>
  8094. ^P (Up Arrow)      Previous line        | <BR>
  8095. ^N (Down Arrow)    Next line            | ^K       Cut marked text or<BR>
  8096. ^A                 Beginning of line    |            delete current line<BR>
  8097. ^E                 End of line          | ^U       Undelete line(s)<BR>
  8098. ^Y                 Previous page        |<BR>
  8099. ^V                 Next page            |-------------------------------------<BR>
  8100. ^@ (Ctrl-SPACE)    Next word            |SCREEN/COMPOSITION COMMANDS<BR>
  8101. ----------------------------------------|<BR>
  8102. MESSAGE COMMANDS  | GENERAL COMMANDS    | ^T     To Addressbook/Browser<BR>
  8103. ^C   <A HREF="h_compose_cancel">Cancel</A>       |  ^G    Get help     | ^J     Attach File<BR>
  8104. ^O   <A HREF="h_common_postpone">Postpone</A>     |  ^Z    <A HREF="h_common_suspend">Suspend</A>      | ^L     Redraw Screen<BR>
  8105. ^X   <A HREF="h_compose_send">Send</A>         |                     | ^R     <A HREF="h_compose_richhdr">Rich Headers</A><BR>
  8106. <!--chtml endif-->
  8107.  
  8108. <P>
  8109. NOTE:
  8110. <OL>
  8111.  <LI>For help on a particular command, hilite the bold text associated
  8112. with it above and hit Return.
  8113.  <LI> The availability of certain commands 
  8114. is determined by Pine configuration files and system capabilities.
  8115. At some sites, certain commands may not be available due to security or
  8116. support concerns.
  8117. </OL>
  8118.  
  8119. <P>
  8120. <UL>   
  8121. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  8122. </UL><P>
  8123. <End of help on this topic>
  8124. </BODY>
  8125. </HTML>
  8126. ======= h_composer_cc ====
  8127. <HTML>
  8128. <HEAD>
  8129. <TITLE>THE MESSAGE COMPOSER'S CC FIELD</TITLE>
  8130. </HEAD>
  8131. <BODY>
  8132. <H1>THE MESSAGE COMPOSER'S CC FIELD</H1>
  8133. The Cc: field is just like the To: field, except it is used for addressees
  8134. that you wish to send a "carbon" copy to.  That is, the message is 
  8135. not directly meant directly "for" these recipients, but you wanted 
  8136. them to see the message.  The only difference the recipients see is that their 
  8137. name is in the Cc: field, rather than the To: field.
  8138. <P>
  8139. For help with Cc: field editing
  8140. commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
  8141. <P>
  8142. <UL>
  8143. <LI><A HREF="h_address_format">Explanation of Address formats</A>
  8144. </UL>
  8145. <P>
  8146. <UL>   
  8147. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  8148. </UL><P>
  8149. <End of help on this topic>
  8150. </BODY>
  8151. </HTML>
  8152. ======= h_composer_bcc ====
  8153. <HTML>
  8154. <HEAD>
  8155. <TITLE>THE MESSAGE COMPOSER'S BCC FIELD</TITLE>
  8156. </HEAD>
  8157. <BODY>
  8158. <H1>THE MESSAGE COMPOSER'S BCC FIELD</H1>
  8159. The "Bcc:" (Blind carbon copy) header is used when you wish to send 
  8160. a copy of the message to one or more people whose addresses you do not
  8161. wish disclosed, either to reduce clutter or for confidentiality.
  8162. <P>
  8163. The format of the Bcc: field is just the same as the To: and Cc: fields in
  8164. the way the addresses are entered.  The recipients listed here will
  8165. receive a copy of the message, but --assuming your site's mail transport
  8166. software is properly configured-- their addresses will not show up in the
  8167. headers of the message, as delivered to all of the recipients.  The To:
  8168. and Cc:  recipients will not know a copy was sent to the Bcc: recipients.
  8169. <P>
  8170. Note: if there is no To: or Cc: or Lcc: address in the message, Pine
  8171. will automatically generate and place in the To: field a pseudo-address of 
  8172.   "Undisclosed recipients: ;"
  8173. or whatever string has been specified in the 
  8174. <A HREF="h_config_empty_hdr_msg">"empty-header-message"</A>
  8175. variable.
  8176. <P>
  8177. The reason for this is to avoid embarrassment caused by some Internet
  8178. mail transfer software that interprets a "missing" To: header as 
  8179. an error and replaces it with an Apparently-to: header that may contain
  8180. the addresses you entered on the Bcc: line.  In addition, it may be
  8181. less disconcerting to Bcc: recipients to see <B>something</B> in the To: field.
  8182. <P>
  8183. You can manipulate what text ends up on the (originally) empty To:
  8184. field.  Just remember to put a colon and semicolon at the end of the
  8185. field, which is a special notation denoting that it is not a real address.
  8186. <P>
  8187. For information on message header editing
  8188. commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
  8189. <P>
  8190. <UL>
  8191. <LI><A HREF="h_address_format">Explanation of Address formats</A>
  8192. </UL>
  8193. <P>
  8194. <UL>   
  8195. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  8196. </UL><P>
  8197. <End of help on this topic>
  8198. </BODY>
  8199. </HTML>
  8200. ======= h_composer_lcc ====
  8201. <HTML>
  8202. <HEAD>
  8203. <TITLE>THE MESSAGE COMPOSER'S LCC FIELD</TITLE>
  8204. </HEAD>
  8205. <BODY>
  8206. <H1>THE MESSAGE COMPOSER'S LCC FIELD</H1>
  8207. The "Lcc:" (List carbon copy) header is intended to be used when
  8208. you wish to send a message to a list of people but avoid having all
  8209. of their addresses visible, in order to reduce clutter when the
  8210. message is received.
  8211. <P>
  8212. It is similar to the 
  8213. <A HREF="h_composer_bcc">"Bcc" (Blind carbon copy) header</A> 
  8214. in that individual
  8215. addressees are hidden, but Lcc is designed to work specifically with
  8216. distribution lists you have created in your 
  8217. <A HREF="h_abook_opened">Pine Address Book</A>.  Placing
  8218. the nickname of the list on the Lcc line will result in the full name of
  8219. your Pine Address Book list being placed on the To: line of the message,
  8220. using a special notation that distinguishes it from a real address. You
  8221. must leave the To: line blank for your list name to appear there.
  8222. <P>
  8223. For example, if you have this list entered in your Address Book:<PRE>
  8224.  
  8225.     largo         Key Largo List       DISTRIBUTION LIST:
  8226.                        bogie@mgm.com
  8227.                        lauren@mgm.com
  8228.                        walter@mgm.com</PRE>
  8229.  
  8230.  
  8231. and you enter "largo" on the Lcc: line while composing a message, 
  8232. the result is:<PRE>
  8233.  
  8234.     To      : Key Largo List: ;
  8235.     Cc      :
  8236.     Bcc     :
  8237.     Fcc     : sent-mail
  8238.     Lcc     : Key Largo List <bogie@mgm.com>,
  8239.           lauren@mgm.com,
  8240.           walter@mgm.com
  8241.     Subject :</PRE>
  8242.  
  8243. Each recipient listed on the Lcc: line receives a copy of the message
  8244. without their address being visible (as though they were listed on the
  8245. Bcc: line). The colon-semicolon notation used to put the full-name of the
  8246. list on the To: line is a special address format that doesn't specify any
  8247. actual addressees, but does give some information to the recipients of the
  8248. message.
  8249. <P>
  8250. Note: if after entering an LCC, you delete the list name that is placed
  8251. on the To: line, then recipients will see <PRE>
  8252.        To: Undisclosed recipients: ;</PRE>
  8253.  
  8254. (or whatever string is defined in the 
  8255. <A HREF="h_config_empty_hdr_msg">"empty-header-message"</A>
  8256. variable) just as in the BCC case. 
  8257. <P>
  8258. For help with Lcc: field editing
  8259. commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
  8260. <P>
  8261. <UL>
  8262. <LI><A HREF="h_address_format">Explanation of Address formats</A>
  8263. </UL>
  8264. <P>
  8265. <UL>   
  8266. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  8267. </UL><P>
  8268. <End of help on this topic>
  8269. </BODY>
  8270. </HTML>
  8271. ======= h_composer_from =======
  8272. <HTML>
  8273. <HEAD>
  8274. <TITLE>THE MESSAGE COMPOSER'S FROM FIELD</TITLE>
  8275. </HEAD>
  8276. <BODY>
  8277. <H1>THE MESSAGE COMPOSER'S FROM FIELD</H1>
  8278.  
  8279. This header carries your return address.  It is the address toward which
  8280. replies (and often, future unrelated correspondence) will be directed,
  8281. unless you have <A HREF="h_config_custom_hdrs">defined an optional 
  8282. "Reply-To:" header</A> in the SETUP CONFIGURATION screen.  Make 
  8283. sure this address is correct.
  8284. <P>
  8285. For help with message header editing
  8286. commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
  8287. <P>
  8288. <UL>
  8289. <LI><A HREF="h_address_format">Explanation of Address formats</A>
  8290. </UL>
  8291. <P>
  8292. <UL>   
  8293. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  8294. </UL><P>
  8295. <End of help on this topic>
  8296. </BODY>
  8297. </HTML>
  8298. ======= h_composer_reply_to =======
  8299. <HTML>
  8300. <HEAD>
  8301. <TITLE>THE MESSAGE COMPOSER'S REPLY-TO FIELD</TITLE>
  8302. </HEAD>
  8303. <BODY>
  8304. <H1>THE MESSAGE COMPOSER'S REPLY-TO FIELD</H1>
  8305.  
  8306. Most people should not need this header. The Reply-To: header is used in
  8307. cases where you would like replies to your messages to be directed to an
  8308. address other than your normal "From:" address.  This is atypical, 
  8309. but can happen when you use multiple machines and do not have the same account
  8310. name on each one, or when you wish to direct certain replies to accounts
  8311. or folders designated for specific classes of correspondence.
  8312. <P>
  8313. For help with message header editing
  8314. commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
  8315. <P>
  8316. <UL>
  8317. <LI><A HREF="h_address_format">Explanation of Address formats</A>
  8318. </UL>
  8319.  
  8320. <P>
  8321. <UL>   
  8322. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  8323. </UL><P>
  8324. <End of help on this topic>
  8325. </BODY>
  8326. </HTML>
  8327. ======= h_composer_custom_addr ====
  8328. <HTML>
  8329. <HEAD>
  8330. <TITLE>CUSTOMIZED HEADER FIELD</TITLE>
  8331. </HEAD>
  8332. <BODY>
  8333. <H1>CUSTOMIZED HEADER FIELD</H1>
  8334. This is a customized header, i.e. not one that is part of Pine's normal
  8335. set of Compose headers.
  8336. <P>
  8337. For help with message header editing
  8338. commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
  8339. <P>
  8340. <UL>
  8341. <LI><A HREF="h_address_format">Explanation of Address formats</A>
  8342. </UL>
  8343. <P>
  8344. <UL>   
  8345. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  8346. </UL><P>
  8347. <End of help on this topic>
  8348. </BODY>
  8349. </HTML>
  8350. ======= h_composer_custom_free ====
  8351. <HTML>
  8352. <HEAD>
  8353. <TITLE>CUSTOMIZED HEADER FIELD</TITLE>
  8354. </HEAD>
  8355. <BODY>
  8356. <H1>CUSTOMIZED HEADER FIELD</H1>
  8357. This is a customized header, i.e. not one that is part of Pine's normal
  8358. set of Compose headers.
  8359. <P>
  8360. This field consists of arbitrary text.
  8361. <P>
  8362. For help with message header editing
  8363. commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
  8364. <P>
  8365. <UL>   
  8366. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  8367. </UL><P>
  8368. <End of help on this topic>
  8369. </BODY>
  8370. </HTML>
  8371. ====== h_composer_news =====
  8372. <HTML>
  8373. <HEAD>
  8374. <TITLE>THE MESSAGE COMPOSER'S NEWSGRPS LINE</TITLE>
  8375. </HEAD>
  8376. <BODY>
  8377. <h1>THE MESSAGE COMPOSER'S NEWSGRPS LINE</h1>
  8378. Use the newsgroups line to specify any and all USENET newsgroups to which
  8379. your message should be posted.  When composing a message from scratch, this
  8380. line may be hidden.  If so, just press the rich headers command
  8381. (<!--chtml if pinemode="function_key"-->F5<!--chtml else-->^R<!--chtml endif-->)
  8382. to make it visible.
  8383. <P>
  8384. <EM>Be aware</EM> that when you post to a newsgroup thousands of
  8385. people will be reading your message.  Also, you or your system manager
  8386. must have defined a "nntp-server" in your Pine configuration
  8387. in order for you to be able to post.
  8388. <P>
  8389. For help with message header editing
  8390. commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
  8391. <P><UL>
  8392. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  8393. </UL>
  8394. <P>
  8395. <End of help on this topic>
  8396. </BODY>
  8397. </HTML>
  8398. ======= h_composer_fcc ====
  8399. <html>
  8400. <header>
  8401. <title>THE MESSAGE COMPOSER'S FCC FIELD</title>
  8402. </header>
  8403. <body>
  8404. <h1>THE MESSAGE COMPOSER'S FCC FIELD</h1>
  8405. The FCC (File Carbon Copy) specifies the folder used to keep a copy of
  8406. each outgoing message.  The default value can be configured with the
  8407. "default-fcc" and "fcc-name-rule" options.  You can change or remove
  8408. the file carbon copy on any message you send by editing the FCC header.<p>
  8409.  
  8410. You may type ^T to get a list of all your folders and select one to use as
  8411. the FCC for this message.<p>
  8412.  
  8413. For help with message header editing
  8414. commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
  8415. <p>
  8416. <UL>   
  8417. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  8418. </UL><P>
  8419. <End of help on this topic>
  8420. ======= h_composer_subject ====
  8421. <html>
  8422. <header>
  8423. <title>THE MESSAGE COMPOSER'S SUBJECT FIELD</title>
  8424. </header>
  8425. <body>
  8426. <h1>THE MESSAGE COMPOSER'S SUBJECT FIELD</h1>
  8427.  
  8428. The subject header provides a place to enter a few words that summarize
  8429. the topic of the message you are sending.  You may leave this line blank,
  8430. but it is considered a courtesy to use a meaningful subject.<p>
  8431.  
  8432. For help with message header editing
  8433. commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
  8434. <P>
  8435. <UL>   
  8436. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  8437. </UL><P>
  8438. <End of help on this topic>
  8439. ======= h_composer_attachment ====
  8440. <HTML>
  8441. <HEAD>
  8442. <TITLE>THE MESSAGE COMPOSER'S ATTCHMNT FIELD</TITLE>
  8443. </HEAD>
  8444. <BODY>
  8445. <H1>THE MESSAGE COMPOSER'S ATTCHMNT FIELD</H1>
  8446.  
  8447. The "Attchmnt:" field is where you specify what file or
  8448. files you'd like attached to
  8449. the message you are composing.  Those files must reside on the machine
  8450. running Pine. If your file is on a PC or Mac and you run Pine with an
  8451. account on a Unix machine, you'll have to transfer it before attaching it.
  8452. Contact local computer support people for assistance with transferring.
  8453.  
  8454. <P>
  8455. The file name
  8456. given can be an absolute file path name for your system
  8457. <!--chtml if pinemode="os_windows"-->
  8458. (for example, "H:\SIGFILES\FULLINFO.TXT"), a file
  8459. with a relative pathname, or simply a file name without
  8460. drive or directory specification.  
  8461. <!--chtml else-->
  8462. (for example, "/tmp/exported.earlier" on Unix hosts), 
  8463. a file in your home directory, or a file path relative to your 
  8464. home directory.  In Unix Pine, you may use "~" to refer to 
  8465. your home directory or "~user" to refer to another
  8466. account's home directory.
  8467. <!--chtml endif--><P>
  8468. No wild card characters may be used.
  8469. <P>If the 
  8470. <A HREF="h_config_use_current_dir">"use-current-dir"</A>
  8471. feature is set, names are relative to your current working directory 
  8472. <!--chtml if pinemode="running"-->
  8473. (which, at least for your current Pine "session," 
  8474. is "<!--#echo var="CURRENT_DIR"-->") 
  8475. <!--chtml endif-->
  8476. rather than your home directory
  8477. <!--chtml if pinemode="running"-->
  8478. (which, in the present configuration of your system, is
  8479.  "<!--#echo var="HOME_DIR"-->") 
  8480. <!--chtml endif-->
  8481. .
  8482. <P>
  8483. Pine uses MIME encoding for attachments, so binaries and files of any
  8484. length can safely be delivered to any MIME-capable mail reading program.
  8485. If you send an attachment to someone who does not have a MIME-capable mail
  8486. reading program yet, then the main message text will be readable, but
  8487. attachments (even attachments which are just plain text) are not.
  8488. <P>
  8489.  
  8490. Typing the filename on the Attchmnt: line achieves the same
  8491. result as using the 
  8492. <!--chtml if pinemode="function_key"-->
  8493. F6
  8494. <!--chtml else-->
  8495. Ctrl-J
  8496. <!--chtml endif--> command.
  8497. <P>
  8498.  
  8499. If you Forward a message with attachments, you may delete them from your
  8500. Forwarded message by editing the Attchmnt header line.
  8501. <P>
  8502.  
  8503. For help with message header editing
  8504. commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
  8505. <P>
  8506. <UL>   
  8507. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  8508. </UL><P>
  8509. <End of help on this topic>
  8510. </BODY>
  8511. </HTML>
  8512. ======= h_composer_ctrl_j ====
  8513. <HTML>
  8514. <HEAD>
  8515. <TITLE>COMPOSER ATTACH</TITLE>
  8516. </HEAD>
  8517. <BODY>
  8518. After the
  8519. <!--chtml if pinemode="function_key"-->
  8520. F6
  8521. <!--chtml else-->
  8522. Ctrl-J
  8523. <!--chtml endif--> command:
  8524. At the "File to attach:" prompt, enter the name of the 
  8525. existing file to attach to your message.  
  8526. If the 
  8527. <A HREF="h_config_enable_tab_complete">"enable-tab-completion"</A>
  8528. feature is set in SETUP CONFIGURATION, 
  8529. you need only enter the beginning of the filename (enough of it to uniquely 
  8530. identify the file) and press TAB to complete it.
  8531.  
  8532. Or, press ^T to use the BROWSER screen for 
  8533. selecting the file.  <P>
  8534. For more information on attaching files, see the help screen for the 
  8535. composer's 
  8536. <A HREF="h_composer_attachment">Attchmnt: field</A>, which is normally hidden,
  8537. but can be revealed using the 
  8538. <!--chtml if pinemode="function_key"-->
  8539. F5
  8540. <!--chtml else-->
  8541. Ctrl-R
  8542. <!--chtml endif--> 
  8543. command with the cursor positioned above the
  8544. "----- Message Text -----" line in the COMPOSE MESSAGE screen.
  8545. <P>
  8546. <End of help on this topic>
  8547. </BODY>
  8548. </HTML>
  8549. ======= h_edit_nav_cmds =========
  8550. <HTML>
  8551. <HEAD>
  8552. <TITLE>Composer Editing Commands Explained</TITLE>
  8553. </HEAD>
  8554. <BODY>
  8555. <H1>EDITING and NAVIGATION COMMANDS</H1>
  8556. <!--chtml if pinemode="function_key"-->
  8557. <PRE>
  8558. CURSOR MOTION KEYS----------------------|EDITING KEYS-------------------------
  8559. ^B (Left Arrow)    Back character       | ^D       Delete current character
  8560. ^F (Right Arrow)   Forward character    | ^H (DEL) Delete previous character
  8561. ^P (Up Arrow)      Previous line        |
  8562. ^N (Down Arrow)    Next line            | F9       Cut marked text or
  8563. ^A                 Beginning of line    |            delete current line
  8564. ^E                 End of line          | F10      Undelete line(s)
  8565. F7                 Previous page        |
  8566. F8                 Next page            |-------------------------------------
  8567. ^@ (Ctrl-SPACE)    Next word            | MISCELLANEOUS COMMANDS
  8568. ----------------------------------------|
  8569. EXIT COMMANDS    |  GENERAL COMMANDS    | F12    To Addressbook
  8570. F3   Cancel      |   F1    Get help     | F12    RichView (expand lists)
  8571. F2  eXit/save    |   ^Z    Suspend      | ^L     Redraw Screen
  8572. </PRE>
  8573. <!--chtml else-->
  8574. <PRE>
  8575. CURSOR MOTION KEYS----------------------|EDITING KEYS-------------------------
  8576. ^B (Left Arrow)    Back character       | ^D       Delete current character
  8577. ^F (Right Arrow)   Forward character    | ^H (DEL) Delete previous character
  8578. ^P (Up Arrow)      Previous line        |
  8579. ^N (Down Arrow)    Next line            | ^K       Cut marked text or
  8580. ^A                 Beginning of line    |            delete current line
  8581. ^E                 End of line          | ^U       Undelete line(s)
  8582. ^Y                 Previous page        |
  8583. ^V                 Next page            |-------------------------------------
  8584. ^@ (Ctrl-SPACE)    Next word            | MISCELLANEOUS COMMANDS
  8585. ----------------------------------------|
  8586. EXIT COMMANDS    |  GENERAL COMMANDS    | ^T     To Addressbook
  8587. ^C   Cancel      |   ^G    Get help     | ^R     RichView  (expand lists)
  8588. ^X   eXit/save   |   ^Z    Suspend      | ^L     Redraw Screen
  8589. </PRE>
  8590. <!--chtml endif-->
  8591. <End of help on this topic>
  8592. </BODY>
  8593. </HTML>
  8594. ===== h_composer_sigedit =====
  8595. <HTML>
  8596. <HEAD>
  8597. <TITLE>Signature Editor Commands Explained</TITLE>
  8598. </HEAD>
  8599. <BODY>
  8600. <H1>SIGNATURE EDITOR COMMANDS</H1>
  8601. <!--chtml if pinemode="function_key"-->
  8602. <PRE>
  8603. CURSOR MOTION KEYS                     |EDITING KEYS
  8604.   ^B (Left Arrow)   Back character     | ^D       Delete current character
  8605.   ^F (Right Arrow)  Forward character  | ^H (DEL) Delete previous character
  8606.   ^P (Up Arrow)     Previous line      | ^^       Set a mark
  8607.   ^N (Down Arrow)   Next line          | F9       Cut marked text or
  8608.   ^A                Beginning of line  |           delete current line
  8609.   ^E                End of line        | F10       Paste text, undelete lines
  8610.   F7                Previous page      |           cut with ^K, or unjustify
  8611.   F8                Next page          |-------------------------------------
  8612.   ^@ (Ctrl-SPACE)   Next word          |SCREEN/COMPOSITION COMMANDS
  8613. ---------------------------------------| F6       Whereis (search for string)
  8614. MESSAGE COMMANDS | GENERAL COMMANDS    | F12      Spell checker
  8615.  F3   Cancel     |  F1    Get help     | F4       Justify paragraph
  8616.                  |  ^Z    Suspend      | ^L       Redraw Screen
  8617.  F2   Send       |  F6    Alt. editor  | F5       Read in a file
  8618. </PRE>
  8619. <!--chtml else-->
  8620. <PRE>
  8621. CURSOR MOTION KEYS                     |EDITING KEYS
  8622.   ^B (Left Arrow)   Back character     | ^D       Delete current character
  8623.   ^F (Right Arrow)  Forward character  | ^H (DEL) Delete previous character
  8624.   ^P (Up Arrow)     Previous line      | ^^       Set a mark
  8625.   ^N (Down Arrow)   Next line          | ^K       Cut marked text or
  8626.   ^A                Beginning of line  |           delete current line
  8627.   ^E                End of line        | ^U        Paste text, undelete lines
  8628.   ^Y                Previous page      |           cut with ^K, or unjustify
  8629.   ^V                Next page          |-------------------------------------
  8630.   ^@ (Ctrl-SPACE)   Next word          |SCREEN/COMPOSITION COMMANDS
  8631. ---------------------------------------| ^W       <A HREF="h_composer_search">Whereis</A> (search text)
  8632. MESSAGE COMMANDS | GENERAL COMMANDS    | ^T       Spell checker
  8633.  ^C   Cancel     |  ^G    Get help     | ^J       <A HREF="h_compose_justify">Justify</A> paragraph
  8634.                  |  ^Z    <A HREF="h_common_suspend">Suspend</A>      | ^L       Redraw Screen
  8635.  ^X   Send       |  ^_    Alt. editor  | ^R       Read in a file
  8636. </PRE>
  8637. <!--chtml endif-->
  8638.  
  8639. NOTE: The presence or absence of the following commands is determined
  8640. by "feature-list" options in your Pine configuration.  Also,
  8641. some of these commands may be administratively disabled by your system
  8642. manager; if they don't work, please check with your local help desk
  8643. before reporting a bug.
  8644. <P>
  8645. <UL>
  8646.  <LI>Suspend (suspends Pine and gives a system prompt)
  8647.  <LI>Alternate editor (allows you to compose with your own editor)
  8648. </UL>
  8649. <P>
  8650.  
  8651. Pine does not use the following keys:  Ctrl-S, Ctrl-Q, Ctrl-],
  8652. Ctrl-\, ESC
  8653. <P>
  8654.  
  8655. NOTE: For special handling of Ctrl-S and Ctrl-Q see special comments regarding
  8656. <A HREF="h_special_xon_xoff">"XOFF/XON"</A>.
  8657. <P>
  8658. <End of help on this topic>
  8659. </BODY>
  8660. </HTML>
  8661. ======= h_composer_abook_nick =======
  8662. <HTML>
  8663. <HEAD>
  8664. <TITLE>Addressbook Nickname Explained</TITLE>
  8665. </HEAD>
  8666. <BODY>
  8667. This is a short nickname for this address book entry.  If it is used in
  8668. place of an address from the composer, the composer will fill in the
  8669. address(es) for the entry that matches the nickname. 
  8670. <P>
  8671.  
  8672. Look <A HREF="h_edit_nav_cmds">here</A>
  8673. to see the available Editing and Navigation commands.
  8674. <P>
  8675. <End of help on this topic>
  8676. </BODY>
  8677. </HTML>
  8678. ======= h_composer_abook_full =======
  8679. <HTML>
  8680. <HEAD>
  8681. <TITLE>Addressbook Fullname Explained</TITLE>
  8682. </HEAD>
  8683. <BODY>
  8684. This is the full name field for this entry.  If this is going to be a
  8685. distribution list (more than one address), it should be a descriptive
  8686. phrase describing the list.  It will be included in the mail header if you
  8687. put the list in the To: or CC: field, or in the To: line if you put the
  8688. list in the Lcc: field.  It's OK to leave this field blank (and OK to
  8689. leave any of the other fields blank, too). If this address book entry is
  8690. going to be a simple entry with just one address, then this field is the
  8691. person's name. When you send mail to this entry, this is the field to the
  8692. left of the brackets. That is, it is the most readable part of the 
  8693. address. For example, in the sample address:
  8694. <PRE>
  8695.        John Doe <jdoe@some.domain>
  8696. </PRE>
  8697. "John Doe" is the full name field. If you are sorting your address book
  8698. with one of the options that uses full names, then it might be useful to
  8699. enter the full name as "Last, First", for example:
  8700. <PRE>
  8701.        Doe, John
  8702. </PRE>
  8703. so that it will be sorted using Doe instead of John. This will be changed
  8704. back into John Doe when you use it.
  8705. <P>
  8706. Look <A HREF="h_edit_nav_cmds">here</A>
  8707. to see the available Editing and Navigation commands.
  8708. <P>
  8709. <End of help on this topic>
  8710. </BODY>
  8711. </HTML>
  8712. ======= h_composer_abook_fcc =======
  8713. <HTML>
  8714. <HEAD>
  8715. <TITLE>Addressbook Fcc Explained</TITLE>
  8716. </HEAD>
  8717. <BODY>
  8718. If this entry is the first one in the To: line of an outgoing message,
  8719. this field will be used for the Fcc (File Carbon Copy) instead of whatever
  8720. you would normally get (which depends on which
  8721. <A HREF="h_config_saved_msg_name_rule">"saved-msg-name-rule"</A>
  8722. you've chosen). 
  8723. <P>
  8724. If this field consists of two double quotes ("") that tells Pine
  8725. that you don't want any Fcc associated with this entry.
  8726. <P>
  8727. Look <A HREF="h_edit_nav_cmds">here</A>
  8728. to see the available Editing and Navigation commands.
  8729. <P>
  8730. <End of help on this topic>
  8731. </BODY>
  8732. </HTML>
  8733. ====== h_config_combined_abook_display =====
  8734. <HTML>
  8735. <HEAD>
  8736. <TITLE>FEATURE: combined-addrbook-display</TITLE>
  8737. </HEAD>
  8738. <BODY>
  8739. <H1>FEATURE: combined-addrbook-display</H1>
  8740.  
  8741. This feature affects the address book display screens.
  8742. Normally, expanding an address book from the ADDRESS BOOK LIST screen
  8743. will cause the remaining address books and directory servers to disappear
  8744. from the screen, leaving only the entries of the expanded address book.
  8745. If this feature is set, then the other address books will remain on the screen,
  8746. so that all of the address books can be present at once.
  8747.  
  8748. <P>
  8749. The way that commands work won't be changed.
  8750. For example, the Select All command will select all of the entries in the
  8751. current address book, not all of the entries in all of the address books.
  8752. The WhereIs command will change a little.
  8753. It will search through all of the text on the screen plus all of the entries
  8754. from expanded address books.
  8755.  
  8756. <P>
  8757. When this feature is set, the setting of the feature
  8758. <A HREF="h_config_expanded_addrbooks">"expanded-view-of-addressbooks"</A>
  8759. has an effect.
  8760. <P>
  8761. <End of help on this topic>
  8762. </BODY>
  8763. </HTML>
  8764. ====== h_config_expanded_addrbooks =====
  8765. <HTML>
  8766. <HEAD>
  8767. <TITLE>FEATURE: expanded-view-of-addressbooks</TITLE>
  8768. </HEAD>
  8769. <BODY>
  8770. <H1>FEATURE: expanded-view-of-addressbooks</H1>
  8771.  
  8772. If multiple address books (either personal or global) are defined, and you
  8773. wish to have them all expanded implicitly upon entering the ADDRESS BOOK
  8774. screen, then set this feature. This feature will have no effect unless the
  8775. feature
  8776. <A HREF="h_config_combined_abook_display">"combined-addrbook-display"</A>
  8777. is also set.
  8778. <P>
  8779. <End of help on this topic>
  8780. </BODY>
  8781. </HTML>
  8782. ====== h_config_combined_folder_display =====
  8783. <HTML>
  8784. <HEAD>
  8785. <TITLE>FEATURE: combined-folder-display</TITLE>
  8786. </HEAD>
  8787. <BODY>
  8788. <H1>FEATURE: combined-folder-display</H1>
  8789.  
  8790. This feature affects the folder list display screens.
  8791. Normally, each folder list is viewed within its collection only.  This
  8792. command allows folder lists to be viewed within a single screen that
  8793. combines the contents of all collections.
  8794.  
  8795. <P>
  8796. The way that commands work won't be changed.
  8797. For example, the Select All command will select all of the folders in the
  8798. current collection, not all of the entries in all of the collections.
  8799. The WhereIs command will change a little.
  8800. It will search through all of the folders in the current collection as well
  8801. as all the folder in any other expanded collection.
  8802.  
  8803. <P>
  8804. When this feature is set, the setting of the feature
  8805. <A HREF="h_config_expanded_folders">"expanded-view-of-folders"</A>
  8806. has an effect.
  8807. <P>
  8808. <End of help on this topic>
  8809. </BODY>
  8810. </HTML>
  8811. ====== h_config_combined_subdir_display =====
  8812. <HTML>
  8813. <HEAD>
  8814. <TITLE>FEATURE: combined-subdirectory-display</TITLE>
  8815. </HEAD>
  8816. <BODY>
  8817. <H1>FEATURE: combined-subdirectory-display</H1>
  8818.  
  8819. This feature affects the Folder List screen when
  8820. the
  8821. <A HREF="h_config_combined_folder_display">"combined-folder-display"</A>
  8822. feature is enabled.  Normally, selecting a directory from the Folder
  8823. List takes you into a new screen displaying only the contents of
  8824. that directory.
  8825.  
  8826. <P>
  8827. Enabling this feature will cause the contents of the selected
  8828. directory to be
  8829. displayed within the boundaries of the "Collection" it
  8830. is a part of.  All previously displayed collections will remain
  8831. in the screen.
  8832.  
  8833. <P>
  8834. The way that commands work won't be changed.
  8835. For example, the Select All command will select all of the folders in the
  8836. directory, as opposed to all of the entries in all of the collections.
  8837. The WhereIs command will change a little.
  8838. It will search through all of the folders in the current collection as well
  8839. as all the folder in any other expanded collection.
  8840.  
  8841. <P>
  8842. <End of help on this topic>
  8843. </BODY>
  8844. </HTML>
  8845. ====== h_config_separate_fold_dir_view =====
  8846. <HTML>
  8847. <HEAD>
  8848. <TITLE>FEATURE: separate-folder-and-directory-display</TITLE>
  8849. </HEAD>
  8850. <BODY>
  8851. <H1>FEATURE: separate-folder-and-directory-display</H1>
  8852.  
  8853. This feature affects folder collections wherein a folder
  8854. and directory can have the same name.  By default, Pine displays them
  8855. only once, denoting that it is both a folder and directory by appending
  8856. the folder name with the hierarchy character enclosed
  8857. in square brackets.
  8858.  
  8859.  
  8860. <P>
  8861. Enabling this feature will cause Pine to display such names
  8862. separately marking the name representing a directory with a trailing
  8863. hierarchy delimiter (typically the slash, "/", character).
  8864.  
  8865. <P>
  8866. The feature also alters the command set slightly.  By default, the
  8867. right-arrow descends into the directory, while hitting the Return key will
  8868. cause the folder by that name to be opened.
  8869.  
  8870. <P>
  8871. With this feature set, the Return key will open the hilited folder, or
  8872. enter the hilited directory.
  8873.  
  8874. <P>
  8875. <End of help on this topic>
  8876. </BODY>
  8877. </HTML>
  8878. ====== h_config_expanded_folders =====
  8879. <HTML>
  8880. <HEAD>
  8881. <TITLE>FEATURE: expanded-view-of-folders</TITLE>
  8882. </HEAD>
  8883. <BODY>
  8884. <H1>FEATURE: expanded-view-of-folders</H1>
  8885.  
  8886. If multiple folder collections are defined, and you
  8887. wish to have them all expanded implicitly upon entering the FOLDER LIST
  8888. screen, then set this feature. This feature will have no effect unless the
  8889. feature
  8890. <A HREF="h_config_combined_folder_display">"combined-folder-display"</A>
  8891. is also set.
  8892. <P>
  8893. <End of help on this topic>
  8894. </BODY>
  8895. </HTML>
  8896. ======= h_config_ldap_server =======
  8897. <HTML>
  8898. <HEAD>
  8899. <TITLE>LDAP OPTION: ldap-server</TITLE>
  8900. </HEAD>
  8901. <BODY>
  8902. <H1>LDAP OPTION: ldap-server</H1>
  8903. This is the name of the host where an LDAP server is running.
  8904. <P>
  8905. To find out whether your organization has its own LDAP server, 
  8906. contact its computing support staff.
  8907. <P><UL>
  8908. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  8909. </UL>
  8910. <P>
  8911. <End of help on this topic>
  8912. </BODY>
  8913. </HTML>
  8914. ======= h_config_ldap_base =======
  8915. <HTML>
  8916. <HEAD>
  8917. <TITLE>LDAP OPTION: search-base</TITLE>
  8918. </HEAD>
  8919. <BODY>
  8920. <H1>LDAP OPTION: search-base</H1>
  8921.  
  8922. This is the search base to be used on this server.  It functions as a filter 
  8923. by restricting your searches in the LDAP server database
  8924. to the specified contents of the specified fields.  Without it, searches 
  8925. submitted to this directory server may fail.  It might be something
  8926. like:
  8927.  
  8928. <PRE>
  8929.       O = <Your Organization Name>, C = US
  8930. </PRE>
  8931. or it might be blank.  
  8932. (Some LDAP servers actually ignore anything specified here.)
  8933. <P>
  8934. If in doubt what parameters you should specify here, 
  8935. contact the maintainers of the LDAP server.
  8936. <P><UL>
  8937. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  8938. </UL>
  8939. <P>
  8940. <End of help on this topic>
  8941. </BODY>
  8942. </HTML>
  8943. ======= h_config_ldap_port =======
  8944. <HTML>
  8945. <HEAD>
  8946. <TITLE>LDAP OPTION: port</TITLE>
  8947. </HEAD>
  8948. <BODY>
  8949. <H1>LDAP OPTION: port</H1>
  8950.  
  8951. This is the TCP port number to be used with this LDAP server. If you leave
  8952. this blank port 389 will be used.
  8953. <P>
  8954. <End of help on this topic>
  8955. </BODY>
  8956. </HTML>
  8957. ======= h_config_ldap_nick =======
  8958. <HTML>
  8959. <HEAD>
  8960. <TITLE>LDAP OPTION: nickname</TITLE>
  8961. </HEAD>
  8962. <BODY>
  8963. <H1>LDAP OPTION: nickname</H1>
  8964.  
  8965. This is a nickname to be used in displays. If you don't supply a
  8966. nickname the server name
  8967. (<A HREF="h_config_ldap_server">"ldap-server"</A>)
  8968. will be used instead.  This option is strictly for your convenience.
  8969. <P>
  8970. <End of help on this topic>
  8971. </BODY>
  8972. </HTML>
  8973. ======= h_config_ldap_opts_impl =======
  8974. <HTML>
  8975. <HEAD>
  8976. <TITLE>LDAP FEATURE: use-implicitly-from-composer</TITLE>
  8977. </HEAD>
  8978. <BODY>
  8979. <H1>LDAP FEATURE: use-implicitly-from-composer</H1>
  8980.  
  8981. Set this to have lookups done to this server implicitly from the composer.
  8982. If an address doesn't look like a fully-qualified address, it will be looked
  8983. up in your address books, and if it doesn't match a nickname there, then it
  8984. will be looked up on the LDAP servers which have this feature set.
  8985. Also see the LDAP feature
  8986. <A HREF="h_config_ldap_opts_rhs">"lookup-addrbook-contents"</A>
  8987. and the Setup/Config feature
  8988. <A HREF="h_config_add_ldap">"ldap-result-to-addrbook-add"</A>.
  8989. <P>
  8990. <End of help on this topic>
  8991. </BODY>
  8992. </HTML>
  8993. ====== h_config_ldap_opts_rhs =====
  8994. <HTML>
  8995. <HEAD>
  8996. <TITLE>LDAP FEATURE: lookup-addrbook-contents</TITLE>
  8997. </HEAD>
  8998. <BODY>
  8999. <H1>LDAP FEATURE: lookup-addrbook-contents</H1>
  9000.  
  9001. Normally implicit LDAP lookups from the composer are done only for the
  9002. strings you type in from the composer screen. In other words, you type in
  9003. something in the To or CC field and press return, then the string is looked up.
  9004. First that string is looked up in your address books. If a match is found
  9005. there, then the results of that match are looked up again. If you place
  9006. a string in your address book that you want to have looked up on the LDAP
  9007. directory server, you need to turn on this feature. If you set this feature
  9008. for a server, you almost always will also want to set the
  9009. <A HREF="h_config_ldap_opts_impl">"use-implicitly-from-composer"</A>
  9010. feature. An example might serve to best illustrate this feature.
  9011. <P>
  9012. If an LDAP lookup of "William Clinton" normally returns an
  9013. entry with an
  9014. address of pres@whitehouse.gov, then you might put an entry in your address
  9015. book that looks like:
  9016. <PRE>
  9017.     Nickname     Address
  9018.     bill         "William Clinton"
  9019. </PRE>
  9020. Now, when you type "bill" into an
  9021. address field in the composer Pine will
  9022. find the "bill" entry in your address book.
  9023. It will replace "bill" with
  9024. "William Clinton".
  9025. It will then search for an entry with that nickname
  9026. in your address book and not find one. If this feature
  9027. is set, Pine will then attempt to lookup
  9028. "William Clinton" on the LDAP server and find the entry with address
  9029. pres@whitehouse.gov.
  9030. <P>
  9031. A better way to accomplish the same thing is probably to use the feature
  9032. <A HREF="h_config_ldap_opts_ref">"save-search-criteria-not-result"</A>.
  9033. <P>
  9034. <End of help on this topic>
  9035. </BODY>
  9036. </HTML>
  9037. ====== h_config_ldap_opts_ref =====
  9038. <HTML>
  9039. <HEAD>
  9040. <TITLE>LDAP FEATURE: save-search-criteria-not-result</TITLE>
  9041. </HEAD>
  9042. <BODY>
  9043. <H1>LDAP FEATURE: save-search-criteria-not-result</H1>
  9044.  
  9045. Normally when you save the results of an LDAP directory lookup to your
  9046. address book the results of the lookup are saved. If this feature is set
  9047. and the entry being saved was found on this directory server, then the
  9048. search criteria is saved instead of the results of the search. When this
  9049. address book entry is used in the future, instead of copying the results
  9050. from the address book the directory lookup will be done again. This could
  9051. be useful if the copied result might become stale because the data on
  9052. the directory server changes (for example, the entry's email address changes).
  9053. You probably don't want to set this feature if the server is at all slow or
  9054. unreliable.
  9055. <P>
  9056. The way this actually works is that instead of saving the email address
  9057. in your address book, Pine saves enough information to look up the same
  9058. directory entry again. In particular, it saves the server name and the
  9059. distinguished name of the entry. It's possible that the server administrators
  9060. might change the format of distinguished names on the server, or that the
  9061. entry might be removed from the server. If Pine notices this, you will be warned
  9062. and a backup copy of the email address will be used. You may want to create
  9063. a new entry in this case, since you will get the annoying warning every
  9064. time you use the old entry. You may do that by Saving the entry to a new
  9065. nickname in the same address book. You will be asked whether or not you
  9066. want to use the backup email address.
  9067. <P>
  9068. A related feature in the Setup/Config screen is
  9069. <A HREF="h_config_add_ldap">"ldap-result-to-addrbook-add"</A>.
  9070. <P>
  9071. <End of help on this topic>
  9072. </BODY>
  9073. </HTML>
  9074. ======= h_config_ldap_opts_nosub =======
  9075. <HTML>
  9076. <HEAD>
  9077. <TITLE>LDAP FEATURE: disable-ad-hoc-space-substitution</TITLE>
  9078. </HEAD>
  9079. <BODY>
  9080. <H1>LDAP FEATURE: disable-ad-hoc-space-substitution</H1>
  9081.  
  9082. Spaces in your input are normally handled specially.
  9083. Each space character is replaced
  9084. by
  9085. <PRE>
  9086.      * <SPACE>
  9087. </PRE>
  9088. in the search query (but not by "* <SPACE> *").
  9089. The reason this is done is so the input string
  9090. <PRE>
  9091.      Greg Donald
  9092. </PRE>
  9093. (which is converted to "Greg* Donald") will match
  9094. the names "Greg Donald",
  9095. "Gregory Donald", "Greg F. Donald", and
  9096. "Gregory F Donald"; but it won't match "Greg McDonald".
  9097. If the "Search-Rule" you were using was "begins-with",
  9098. then it would also match the name "Greg Donaldson".
  9099. <P>
  9100. Turning on this feature will disable this substitution.
  9101. <P>
  9102. <End of help on this topic>
  9103. </BODY>
  9104. </HTML>
  9105. ====== h_config_ldap_searchtypes =======
  9106. <HTML>
  9107. <HEAD>
  9108. <TITLE>LDAP OPTION: Search-Type</TITLE>
  9109. </HEAD>
  9110. <BODY>
  9111. <H1>LDAP OPTION: Search-Type</H1>
  9112.  
  9113. This affects the way that LDAP searches are done.
  9114. In particular, this tells the server where to look for the string to be matched.
  9115. If set to "name" then the string that is being searched for will
  9116. be compared with the string in the
  9117. "Name" field on the server
  9118. (technically, it is the "commonname" field on the server).
  9119. "Surname" means we're looking for a
  9120. match in the "Surname" field on the
  9121. server (actually the "sn" field).
  9122. "Givenname" really is "givenname"
  9123. and "email" is the electronic mail address (this is actually the field
  9124. called "mail" or "electronicmail" on the server).
  9125. The other three types are combinations of
  9126. the types listed so far. "Name-or-email"
  9127. means the string should appear
  9128. in either the "name" field OR the "email" field.
  9129. Likewise, "surname-or-givenname"
  9130. means "surname" OR "givenname"
  9131. and "sur-or-given-or-name-or-email" means the obvious thing.
  9132. <P>
  9133. This search TYPE is combined with the
  9134. search <A HREF="h_config_ldap_searchrules">RULE</A>
  9135. to form the actual search query.
  9136. <P>
  9137. The usual default value for this
  9138. option is "sur-or-given-or-name-or-email".
  9139. This type of search may be slow on some servers.
  9140. Try "name-or-email", which is often
  9141. faster, or just "name" if the performance seems to be a problem.
  9142. <P>
  9143. Some servers have been configured with different attribute names for
  9144. these four fields.
  9145. In other words, instead of using the attribute name "mail"
  9146. for the email address field, the server might be configured to use something
  9147. else, for example, "rfc822mail" or "internetemailaddress".
  9148. Pine can be configured to use these different attribute names by using
  9149. the four configuration options:
  9150. <P><UL>
  9151. <LI><A HREF="h_config_ldap_email_attr">"EmailAttribute"</A>
  9152. </UL>
  9153. <P><UL>
  9154. <LI><A HREF="h_config_ldap_cn_attr">"NameAttribute"</A>
  9155. </UL>
  9156. <P><UL>
  9157. <LI><A HREF="h_config_ldap_sn_attr">"SurnameAttribute"</A>
  9158. </UL>
  9159. <P><UL>
  9160. <LI><A HREF="h_config_ldap_gn_attr">"GivennameAttribute"</A>
  9161. </UL>
  9162. <P>
  9163. <End of help on this topic>
  9164. </BODY>
  9165. </HTML>
  9166. ====== h_config_ldap_searchrules =======
  9167. <HTML>
  9168. <HEAD>
  9169. <TITLE>LDAP OPTION: Search-Rule</TITLE>
  9170. </HEAD>
  9171. <BODY>
  9172. <H1>LDAP OPTION: Search-Rule</H1>
  9173.  
  9174. This affects the way that LDAP searches are done.
  9175. If set to "equals" then
  9176. only exact matches count.
  9177. "Contains" means that the string you type in
  9178. is a substring of what you are matching against.
  9179. "Begins-with" and "ends-with"
  9180. mean that the string starts or ends with the string you type in.
  9181. <P>
  9182. Spaces in your input are normally handled specially, but you can turn that
  9183. special handling off with the
  9184. <A HREF="h_config_ldap_opts_nosub">"disable-ad-hoc-space-substitution"</A>
  9185. feature.
  9186. <P>
  9187. The usual default value for this option is "begins-with".
  9188. <P>
  9189. <End of help on this topic>
  9190. </BODY>
  9191. </HTML>
  9192. ======= h_config_ldap_email_attr =======
  9193. <HTML>
  9194. <HEAD>
  9195. <TITLE>LDAP OPTION: EmailAttribute</TITLE>
  9196. </HEAD>
  9197. <BODY>
  9198. <H1>LDAP OPTION: EmailAttribute</H1>
  9199.  
  9200. This is the name of the attribute which is searched for when looking for
  9201. an email address. The default value for this option is "mail" or
  9202. "electronicmail".
  9203. If the server you are using uses a different attribute name for the email
  9204. address, put that attribute name here.
  9205. <P>
  9206. This will affect the search filter used if your Search-Type is one that
  9207. contains a search for "email".
  9208. It will also cause the attribute value matching this attribute name to be used
  9209. as the email address when you look up an entry from the composer.
  9210. <P>
  9211. <End of help on this topic>
  9212. </BODY>
  9213. </HTML>
  9214. ======= h_config_ldap_sn_attr =======
  9215. <HTML>
  9216. <HEAD>
  9217. <TITLE>LDAP OPTION: SurnameAttribute</TITLE>
  9218. </HEAD>
  9219. <BODY>
  9220. <H1>LDAP OPTION: SurnameAttribute</H1>
  9221.  
  9222. This is the name of the attribute which is searched for when looking for
  9223. the surname of the entry. The default value for this option is "sn".
  9224. If the server you are using uses a different attribute name for the surname,
  9225. put that attribute name here.
  9226. This will affect the search filter used if your Search-Type is one that
  9227. contains a search for "surname".
  9228. <P>
  9229. <End of help on this topic>
  9230. </BODY>
  9231. </HTML>
  9232. ======= h_config_ldap_gn_attr =======
  9233. <HTML>
  9234. <HEAD>
  9235. <TITLE>LDAP OPTION: GivennameAttribute</TITLE>
  9236. </HEAD>
  9237. <BODY>
  9238. <H1>LDAP OPTION: GivennameAttribute</H1>
  9239.  
  9240. This is the name of the attribute which is searched for when looking for
  9241. the given name of the entry. The default value for this option is "givenname".
  9242. If the server you are using uses a different attribute name for the given name,
  9243. put that attribute name here.
  9244. This will affect the search filter used if your Search-Type is one that
  9245. contains a search for "givenname".
  9246. <P>
  9247. <End of help on this topic>
  9248. </BODY>
  9249. </HTML>
  9250. ======= h_config_ldap_cn_attr =======
  9251. <HTML>
  9252. <HEAD>
  9253. <TITLE>LDAP OPTION: NameAttribute</TITLE>
  9254. </HEAD>
  9255. <BODY>
  9256. <H1>LDAP OPTION: NameAttribute</H1>
  9257.  
  9258. This is the name of the attribute which is searched for when looking for
  9259. the name of the entry. The default value for this option is "cn", which
  9260. stands for common name.
  9261. If the server you are using uses a different attribute name for the name,
  9262. put that attribute name here.
  9263. This will affect the search filter used if your Search-Type is one that
  9264. contains a search for "name".
  9265. <P>
  9266. <End of help on this topic>
  9267. </BODY>
  9268. </HTML>
  9269. ======= h_config_ldap_time =======
  9270. <HTML>
  9271. <HEAD>
  9272. <TITLE>LDAP OPTION: Timelimit</TITLE>
  9273. </HEAD>
  9274. <BODY>
  9275. <H1>LDAP OPTION: Timelimit</H1>
  9276.  
  9277. This places a limit on the number of seconds the LDAP search will continue.
  9278. The default is 30 seconds. A value of 0 means no limit. Note that some servers
  9279. may place limits of their own on searches.
  9280. <P>
  9281. <End of help on this topic>
  9282. </BODY>
  9283. </HTML>
  9284. ======= h_config_ldap_size =======
  9285. <HTML>
  9286. <HEAD>
  9287. <TITLE>LDAP OPTION: Sizelimit</TITLE>
  9288. </HEAD>
  9289. <BODY>
  9290. <H1>LDAP OPTION: Sizelimit</H1>
  9291.  
  9292. This places a limit on the number of entries returned by the LDAP server.
  9293. A value of 0 means no limit. The default is 0. Note that some servers
  9294. may place limits of their own on searches.
  9295. <P>
  9296. <End of help on this topic>
  9297. </BODY>
  9298. </HTML>
  9299. ======= h_config_ldap_cust =======
  9300. <HTML>
  9301. <HEAD>
  9302. <TITLE>LDAP OPTION: Custom-Search-Filter</TITLE>
  9303. </HEAD>
  9304. <BODY>
  9305. <H1>LDAP OPTION: Custom-Search-Filter</H1>
  9306.  
  9307. This one is for advanced users only! If you define this, then the
  9308. "Search-Type" and "Search-Rule" defined are both ignored.
  9309. However, the feature
  9310. <A HREF="h_config_ldap_opts_nosub">"disable-ad-hoc-space-substitution"</A>
  9311. is still in effect.
  9312. That is, the space substitution will take place even in a custom filter unless
  9313. you disable it.
  9314. <P>
  9315. If your LDAP service stops working and you suspect it might be because
  9316. of your custom filter, just delete this filter and try using the
  9317. "Search-Type" and "Search-Rule" instead.
  9318. Another option that sometimes causes trouble is the
  9319. <A HREF="h_config_ldap_base">"search-base"</A> option.
  9320. <P>
  9321. This variable may be set to the string representation of an LDAP search
  9322. filter (see RFC1960). In the places where you want the address string to be
  9323. substituted in, put a '%s' in this filter string. Here are some examples:
  9324. <P>
  9325. A "Search-Type" of "name" with "Search-Rule" of "begins-with"
  9326. is equivalent to the "custom-search-filter"
  9327. <PRE>
  9328.      (cn=%s*)
  9329. </PRE>
  9330. When you try to match against the string "string" the program replaces
  9331. the "%s" with "string" (without the quotes). You may have multiple "%s"'s and
  9332. they will all be replaced with the string. There is a limit of 10 "%s"'s.
  9333. <P>
  9334. A "Search-Type" of "name-or-email" with "Search-Rule"
  9335. of "contains" is equivalent to
  9336. <PRE>
  9337.      (|(cn=*%s*)(mail=*%s*))
  9338. </PRE>
  9339. <P>
  9340. If your server uses a different attribute <EM>name</EM> than
  9341. Pine uses by default,
  9342. (for example, it uses "rfc822mail" instead of "mail"),
  9343. then you may be able to use one or more of the four attribute configuration
  9344. options instead of defining a custom filter:
  9345. <P><UL>
  9346. <LI><A HREF="h_config_ldap_email_attr">"EmailAttribute"</A>
  9347. </UL>
  9348. <P><UL>
  9349. <LI><A HREF="h_config_ldap_cn_attr">"NameAttribute"</A>
  9350. </UL>
  9351. <P><UL>
  9352. <LI><A HREF="h_config_ldap_sn_attr">"SurnameAttribute"</A>
  9353. </UL>
  9354. <P><UL>
  9355. <LI><A HREF="h_config_ldap_gn_attr">"GivennameAttribute"</A>
  9356. </UL>
  9357. <P>
  9358. <End of help on this topic>
  9359. </BODY>
  9360. </HTML>
  9361. ======= h_composer_abook_comment =======
  9362. <HTML>
  9363. <HEAD>
  9364. <TITLE>Addressbook Comment Explained</TITLE>
  9365. </HEAD>
  9366. <BODY>
  9367. This is a comment to help you remember what this entry is. The WhereIs
  9368. command searches comments so that it is easier to find an entry with a comment
  9369. you know about attached to it. This field is not used in the outgoing message.
  9370. <P>
  9371. Look <A HREF="h_edit_nav_cmds">here</A>
  9372. to see the available Editing and Navigation commands.
  9373. <P>
  9374. <End of help on this topic>
  9375. </BODY>
  9376. </HTML>
  9377. ======= h_composer_abook_addrs =======
  9378.  
  9379. This is a list of addresses to send to when sending to this address book
  9380. entry.  Each member of the list may be an address or another nickname from
  9381. any of your address books.  If it is an address, it is OK to include the
  9382. full name field as well as the electronic address portion of that address.
  9383. For example, the following are all legitimate entries in this field:
  9384.  
  9385.      john               (a nickname in your address book)
  9386.      jdoe@some.domain
  9387.      John Doe <jdoe@some.domain>
  9388.  
  9389. The addresses should be listed separated by commas, just like you would
  9390. enter them from the composer.
  9391.  
  9392. The only difference between a distribution list and a simple entry with a
  9393. single address, is that a distribution list has more than one address   
  9394. listed in the Addresses: field, whereas a simple personal entry has just  
  9395. one address.
  9396.  
  9397. For individual address book entries, if there is a full name in the
  9398. Fullname: field (filling in the Fullname: field is not required), it is
  9399. used.  If the full name is specified in the Address: field and not in the
  9400. Fullname: field, then the full name from the Address: field is used.
  9401.  
  9402. If you type the nickname of a distribution list from one of your address 
  9403. books in the Lcc: field, then the full name of that list is used in the  
  9404. To: field.  If you put a list in the To: or Cc: fields, that list will be
  9405. expanded into all of its addresses.  If the list has a full name, then
  9406. that will appear at the beginning of the addresses.
  9407.  
  9408. Sewing Club <john@somewhere>, nancy@something.else, Sal <sal@here.there>
  9409.  
  9410. If the first address in the distribution list also has a full name, then
  9411. the list full name and that full name are combined into something like the
  9412. following:
  9413.  
  9414. Sewing Club -- John Smith <john@somewhere>
  9415.  
  9416. If you specify a list via Lcc, the full name is used in the To: line.  If
  9417. you specify a list in the To: or Cc: fields, then it uses the same method
  9418. as for individual entries for filling in the full name.
  9419.  
  9420. For help with editing and navigation commands, check the Help for the
  9421. Nickname: field.
  9422.  
  9423. <End of help on this topic>
  9424. ======= h_config_role_nick =======
  9425. <HTML>
  9426. <HEAD>
  9427. <TITLE>Nickname Explained</TITLE>
  9428. </HEAD>
  9429. <BODY>
  9430. <H1>Nickname Explained</H1>
  9431.  
  9432. This is a nickname to help you.
  9433. You should have a different nickname for each role you define.
  9434. The nickname will be used in the SETUP ROLE RULES screen to allow you to
  9435. pick a role to edit.
  9436. It will also be used when you send a message to let you know you are
  9437. sending with a different role than you use by default, and
  9438. it will be useful for choosing a role when composing with the Role command
  9439. or when composing with one of the Role Uses set to With Confirmation.
  9440. This field is not used in the outgoing message.
  9441. <P>
  9442. Look <A HREF="h_edit_nav_cmds">here</A>
  9443. to see the available Editing and Navigation commands.
  9444. <P>
  9445. <End of help on this topic>
  9446. </BODY>
  9447. </HTML>
  9448. ======= h_config_score_nick =======
  9449. <HTML>
  9450. <HEAD>
  9451. <TITLE>Nickname Explained</TITLE>
  9452. </HEAD>
  9453. <BODY>
  9454. <H1>Nickname Explained</H1>
  9455.  
  9456. This is a nickname to help you.
  9457. You should have a different nickname for each scoring rule you define.
  9458. The nickname will be used in the SETUP SCORING RULES screen to allow you to
  9459. pick a rule to edit.
  9460. <P>
  9461. Look <A HREF="h_edit_nav_cmds">here</A>
  9462. to see the available Editing and Navigation commands.
  9463. <P>
  9464. <End of help on this topic>
  9465. </BODY>
  9466. </HTML>
  9467. ======= h_config_incol_nick =======
  9468. <HTML>
  9469. <HEAD>
  9470. <TITLE>Nickname Explained</TITLE>
  9471. </HEAD>
  9472. <BODY>
  9473. <H1>Nickname Explained</H1>
  9474.  
  9475. This is a nickname to help you.
  9476. You should have a different nickname for each color rule you define.
  9477. The nickname will be used in the SETUP INDEX COLOR RULES screen to allow you to
  9478. pick a rule to edit.
  9479. <P>
  9480. Look <A HREF="h_edit_nav_cmds">here</A>
  9481. to see the available Editing and Navigation commands.
  9482. <P>
  9483. <End of help on this topic>
  9484. </BODY>
  9485. </HTML>
  9486. ======= h_config_filt_nick =======
  9487. <HTML>
  9488. <HEAD>
  9489. <TITLE>Nickname Explained</TITLE>
  9490. </HEAD>
  9491. <BODY>
  9492. <H1>Nickname Explained</H1>
  9493.  
  9494. This is a nickname to help you.
  9495. You should have a different nickname for each filtering rule you define.
  9496. The nickname will be used in the SETUP FILTERING RULES screen to allow you to
  9497. pick a rule to edit.
  9498. <P>
  9499. Look <A HREF="h_edit_nav_cmds">here</A>
  9500. to see the available Editing and Navigation commands.
  9501. <P>
  9502. <End of help on this topic>
  9503. </BODY>
  9504. </HTML>
  9505. ======= h_config_role_topat =======
  9506. <HTML>
  9507. <HEAD>
  9508. <TITLE>To Pattern Explained</TITLE>
  9509. </HEAD>
  9510. <BODY>
  9511. <H1>To Pattern Explained</H1>
  9512.  
  9513. If this pattern is non-blank, then for this role to be considered a
  9514. match, at least one of the recipients from
  9515. the To line of the message being replied to or forwarded
  9516. must match this pattern.
  9517. In the case of the Compose command, this pattern and the other header
  9518. patterns are ignored.
  9519. If this pattern is a comma-separated list of patterns, then at least one of the
  9520. recipients must match at least one of the patterns.
  9521. (Any other non-blank parts of the Pattern must match, too.)
  9522. If the message being replied to or forwarded has a Resent-To header line,
  9523. then that is used in place of the To line.
  9524. <P>
  9525. You may choose an address from your address book with the
  9526. "T" command.
  9527. <P>
  9528. If you wish to have a header pattern which is not one of the six standard
  9529. header patterns, you may add it with the "eXtraHdr" command.
  9530. <P>
  9531. If you leave all of the header patterns, the AllText pattern, and the
  9532. Score Interval blank, and set the Current Folder Type to Any,
  9533. that matches any message.
  9534. <P>
  9535. Look <A HREF="h_edit_nav_cmds">here</A>
  9536. to see the available Editing and Navigation commands.
  9537. <P>
  9538. <End of help on this topic>
  9539. </BODY>
  9540. </HTML>
  9541. ======= h_config_score_topat =======
  9542. <HTML>
  9543. <HEAD>
  9544. <TITLE>To Pattern Explained</TITLE>
  9545. </HEAD>
  9546. <BODY>
  9547. <H1>To Pattern Explained</H1>
  9548.  
  9549. If this pattern is non-blank, then for this scoring rule to be considered a
  9550. match, at least one of the recipients from
  9551. the To line of the message being scored must match this pattern.
  9552. If this pattern is a comma-separated list of patterns, then at least one of the
  9553. recipients must match at least one of the patterns.
  9554. (Any other non-blank parts of the Pattern must match, too.)
  9555. If the message has a Resent-To header line,
  9556. then that is used in place of the To line.
  9557. <P>
  9558. You may choose an address from your address book with the
  9559. "T" command.
  9560. <P>
  9561. If you wish to have a header pattern which is not one of the six standard
  9562. header patterns, you may add it with the "eXtraHdr" command.
  9563. <P>
  9564. Look <A HREF="h_edit_nav_cmds">here</A>
  9565. to see the available Editing and Navigation commands.
  9566. <P>
  9567. <End of help on this topic>
  9568. </BODY>
  9569. </HTML>
  9570. ======= h_config_incol_topat =======
  9571. <HTML>
  9572. <HEAD>
  9573. <TITLE>To Pattern Explained</TITLE>
  9574. </HEAD>
  9575. <BODY>
  9576. <H1>To Pattern Explained</H1>
  9577.  
  9578. If this pattern is non-blank, then for this rule to be considered a
  9579. match, at least one of the recipients from
  9580. the To line of the message from the index must match this pattern.
  9581. If this pattern is a comma-separated list of patterns, then at least one of the
  9582. recipients must match at least one of the patterns.
  9583. (Any other non-blank parts of the Pattern must match, too.)
  9584. If the message has a Resent-To header line,
  9585. then that is used in place of the To line.
  9586. <P>
  9587. You may choose an address from your address book with the
  9588. "T" command.
  9589. <P>
  9590. If you wish to have a header pattern which is not one of the six standard
  9591. header patterns, you may add it with the "eXtraHdr" command.
  9592. <P>
  9593. Look <A HREF="h_edit_nav_cmds">here</A>
  9594. to see the available Editing and Navigation commands.
  9595. <P>
  9596. <End of help on this topic>
  9597. </BODY>
  9598. </HTML>
  9599. ======= h_config_filt_topat =======
  9600. <HTML>
  9601. <HEAD>
  9602. <TITLE>To Pattern Explained</TITLE>
  9603. </HEAD>
  9604. <BODY>
  9605. <H1>To Pattern Explained</H1>
  9606.  
  9607. If this pattern is non-blank, then for this rule to be considered a
  9608. match, at least one of the recipients from
  9609. the To line of the message being considered for filtering must match this pattern.
  9610. If this pattern is a comma-separated list of patterns, then at least one of the
  9611. recipients must match at least one of the patterns.
  9612. (Any other non-blank parts of the Pattern must match, too.)
  9613. If the message has a Resent-To header line,
  9614. then that is used in place of the To line.
  9615. <P>
  9616. You may choose an address from your address book with the
  9617. "T" command.
  9618. <P>
  9619. If you wish to have a header pattern which is not one of the six standard
  9620. header patterns, you may add it with the "eXtraHdr" command.
  9621. <P>
  9622. Look <A HREF="h_edit_nav_cmds">here</A>
  9623. to see the available Editing and Navigation commands.
  9624. <P>
  9625. <End of help on this topic>
  9626. </BODY>
  9627. </HTML>
  9628. ======= h_config_role_frompat =======
  9629. <HTML>
  9630. <HEAD>
  9631. <TITLE>From Pattern Explained</TITLE>
  9632. </HEAD>
  9633. <BODY>
  9634. <H1>From Pattern Explained</H1>
  9635.  
  9636. This is just like the To pattern except that it is compared with
  9637. the address in the From header of the message
  9638. instead of the addresses from the To header.
  9639. <P>
  9640. Look <A HREF="h_edit_nav_cmds">here</A>
  9641. to see the available Editing and Navigation commands.
  9642. <P>
  9643. <End of help on this topic>
  9644. </BODY>
  9645. </HTML>
  9646. ======= h_config_role_senderpat =======
  9647. <HTML>
  9648. <HEAD>
  9649. <TITLE>Sender Pattern Explained</TITLE>
  9650. </HEAD>
  9651. <BODY>
  9652. <H1>Sender Pattern Explained</H1>
  9653.  
  9654. This is just like the To pattern except that it is compared with
  9655. the address from the Sender header of the message
  9656. instead of the addresses from the To header.
  9657. <P>
  9658. Look <A HREF="h_edit_nav_cmds">here</A>
  9659. to see the available Editing and Navigation commands.
  9660. <P>
  9661. <End of help on this topic>
  9662. </BODY>
  9663. </HTML>
  9664. ======= h_config_role_ccpat =======
  9665. <HTML>
  9666. <HEAD>
  9667. <TITLE>Cc Pattern Explained</TITLE>
  9668. </HEAD>
  9669. <BODY>
  9670. <H1>Cc Pattern Explained</H1>
  9671.  
  9672. This is just like the To pattern except that it is compared with
  9673. the addresses from the Cc header of the message
  9674. instead of the addresses from the To header.
  9675. <P>
  9676. Look <A HREF="h_edit_nav_cmds">here</A>
  9677. to see the available Editing and Navigation commands.
  9678. <P>
  9679. <End of help on this topic>
  9680. </BODY>
  9681. </HTML>
  9682. ======= h_config_role_recippat =======
  9683. <HTML>
  9684. <HEAD>
  9685. <TITLE>Recipient Pattern Explained</TITLE>
  9686. </HEAD>
  9687. <BODY>
  9688. <H1>Recipient Pattern Explained</H1>
  9689.  
  9690. This is just like the To pattern except that it is compared with
  9691. the addresses from both the To header and the Cc header of the
  9692. message instead of just the addresses from the To header.
  9693. It's equivalent to having two different rules;
  9694. one with a To pattern and the other with the same Cc pattern.
  9695. <P>
  9696. Look <A HREF="h_edit_nav_cmds">here</A>
  9697. to see the available Editing and Navigation commands.
  9698. <P>
  9699. <End of help on this topic>
  9700. </BODY>
  9701. </HTML>
  9702. ======= h_config_role_particpat =======
  9703. <HTML>
  9704. <HEAD>
  9705. <TITLE>Participant Pattern Explained</TITLE>
  9706. </HEAD>
  9707. <BODY>
  9708. <H1>Participant Pattern Explained</H1>
  9709.  
  9710. This is just like the To pattern except that it is compared with
  9711. the addresses from the To header, the Cc header, and the From header of the
  9712. message instead of just the addresses from the To header.
  9713. It's equivalent to having three different rules;
  9714. one with a To pattern, another with the same Cc pattern, and another with
  9715. the same From pattern.
  9716. <P>
  9717. Look <A HREF="h_edit_nav_cmds">here</A>
  9718. to see the available Editing and Navigation commands.
  9719. <P>
  9720. <End of help on this topic>
  9721. </BODY>
  9722. </HTML>
  9723. ======= h_config_role_newspat =======
  9724. <HTML>
  9725. <HEAD>
  9726. <TITLE>News Pattern Explained</TITLE>
  9727. </HEAD>
  9728. <BODY>
  9729. <H1>News Pattern Explained</H1>
  9730.  
  9731. If this pattern is non-blank, then for this rule to be considered a
  9732. match, at least one of the newsgroups from
  9733. the Newsgroups line of the message must match this pattern.
  9734. If this pattern is a comma-separated list of patterns, then at least one of the
  9735. newsgroups must match at least one of the patterns.
  9736. (Any other non-blank parts of the Pattern must match, too.)
  9737. <P>
  9738. Look <A HREF="h_edit_nav_cmds">here</A>
  9739. to see the available Editing and Navigation commands.
  9740. <P>
  9741. <End of help on this topic>
  9742. </BODY>
  9743. </HTML>
  9744. ======= h_config_role_subjpat =======
  9745. <HTML>
  9746. <HEAD>
  9747. <TITLE>Subject Pattern Explained</TITLE>
  9748. </HEAD>
  9749. <BODY>
  9750. <H1>Subject Pattern Explained</H1>
  9751.  
  9752. This is similar to the other parts of the Pattern.
  9753. It is compared with
  9754. the contents from the Subject of the message.
  9755. <P>
  9756. If you enter non-ASCII characters in this field then the search will be
  9757. done using the character set you have defined with the
  9758. <A HREF="h_config_char_set">"character-set"</A>
  9759. configuration variable.
  9760. (The truly sophisticated may use an alternate character set for a search
  9761. by entering the MIME encoding of the header string here.)
  9762. <P>
  9763. If you wish to have a header pattern which is not one of the six standard
  9764. header patterns, you may add it with the "eXtraHdr" command.
  9765. <P>
  9766. Look <A HREF="h_edit_nav_cmds">here</A>
  9767. to see the available Editing and Navigation commands.
  9768. <P>
  9769. <End of help on this topic>
  9770. </BODY>
  9771. </HTML>
  9772. ======= h_config_role_alltextpat =======
  9773. <HTML>
  9774. <HEAD>
  9775. <TITLE>AllText Pattern Explained</TITLE>
  9776. </HEAD>
  9777. <BODY>
  9778. <H1>AllText Pattern Explained</H1>
  9779.  
  9780. This is similar to the header patterns.
  9781. Instead of comparing with text in a particular header field it 
  9782. is compared with all of the text in the message header and body.
  9783. <P>
  9784. If you enter non-ASCII characters in this field then the search will be
  9785. done using the character set you have defined with the
  9786. <A HREF="h_config_char_set">"character-set"</A>
  9787. configuration variable.
  9788. (The truly sophisticated may use an alternate character set for a search
  9789. by entering the MIME encoding of the header string here.)
  9790. <P>
  9791. It is possible that you may notice degraded performance when using
  9792. AllText Patterns.
  9793. <P>
  9794. Look <A HREF="h_edit_nav_cmds">here</A>
  9795. to see the available Editing and Navigation commands.
  9796. <P>
  9797. <End of help on this topic>
  9798. </BODY>
  9799. </HTML>
  9800. ======= h_config_role_arbpat =======
  9801. <HTML>
  9802. <HEAD>
  9803. <TITLE>Extra Header Patterns Explained</TITLE>
  9804. </HEAD>
  9805. <BODY>
  9806. <H1>Extra Header Patterns Explained</H1>
  9807.  
  9808. The header patterns which come after the Subject pattern but before the AllText
  9809. pattern are extra header patterns which you have added to a rule's Pattern.
  9810. These are just like the other header patterns except that
  9811. the contents of the particular header listed on the left hand side will
  9812. be used for comparisons.
  9813. <P>
  9814. The "eXtraHdr" command may be used to add more of these
  9815. header patterns to the rule you are editing.
  9816. <P>
  9817. The "RemoveHdr" command may be used to delete the highlighted
  9818. extra header pattern from the rule you are editing.
  9819. <P>
  9820. If you enter non-ASCII characters in this field then the search will be
  9821. done using the character set you have defined with the
  9822. <A HREF="h_config_char_set">"character-set"</A>
  9823. configuration variable.
  9824. (The truly sophisticated may use an alternate character set for a search
  9825. by entering the MIME encoding of the header string here.)
  9826. <P>
  9827. Look <A HREF="h_edit_nav_cmds">here</A>
  9828. to see the available Editing and Navigation commands.
  9829. <P>
  9830. <End of help on this topic>
  9831. </BODY>
  9832. </HTML>
  9833. ======= h_config_role_scorei =======
  9834. <HTML>
  9835. <HEAD>
  9836. <TITLE>Score Interval Explained</TITLE>
  9837. </HEAD>
  9838. <BODY>
  9839. <H1>Score Interval Explained</H1>
  9840.  
  9841. The Score Interval, if defined, is part of the Pattern.
  9842. If you use this, it should be set to something like:
  9843. <P>
  9844. <CENTER><SAMP>(min_score,max_score)</SAMP></CENTER>
  9845. <P>
  9846. where "min_score" and "max_score" are integers between
  9847. -32000 and 32000.
  9848. The special values "-INF" and "INF" may be used for
  9849. the min and max values.
  9850. These represent negative and positive infinity.
  9851. <P>
  9852. When there is a Score Interval defined, it is a match if the score for
  9853. the message is contained in the interval.
  9854. The interval includes both endpoints.
  9855. The score for a message is calculated by looking at every scoring rule
  9856. defined and adding up the Score Values for the rules which match the message.
  9857. Scoring rules are created using the
  9858. <A HREF="h_rules_score">"SETUP SCORING"</A> screen.
  9859.  
  9860. <P>
  9861. Look <A HREF="h_edit_nav_cmds">here</A>
  9862. to see the available Editing and Navigation commands.
  9863. <P>
  9864. <End of help on this topic>
  9865. </BODY>
  9866. </HTML>
  9867. ======= h_config_role_fldr_type =======
  9868. <HTML>
  9869. <HEAD>
  9870. <TITLE>Current Folder Type Explained</TITLE>
  9871. </HEAD>
  9872. <BODY>
  9873. <H1>Current Folder Type Explained</H1>
  9874.  
  9875. The Current Folder Type is part of the role's Pattern.
  9876. It refers to the type of the currently open folder, which is the folder
  9877. you were last looking at from the MESSAGE INDEX or MESSAGE TEXT screen.
  9878. In order for a role to be considered a match, the current folder must
  9879. be of the type you set here.
  9880. The three types "Any", "News", and "Email" are
  9881. all what you might think.
  9882. <P>
  9883. If the Current Folder Type for a role's Pattern is set to "News", for
  9884. example, then
  9885. that role will only be a match if the current folder is a newsgroup and
  9886. the rest of the Pattern matches.
  9887. The value "Specific" may be used when you want to limit the match
  9888. to a specific folder (not just a specific type of folder), or to a list of
  9889. specific folders.
  9890. <P>
  9891. In order to match a specific folder you Select the "Specific"
  9892. button <EM>AND</EM> fill in
  9893. the name (or comma-separated list of names) of
  9894. the folder in the "Folder" field.
  9895. If the current folder is any of the folders in the list, that is considered
  9896. a match.
  9897. The name of each folder in the list may be either "INBOX",
  9898. the technical specification
  9899. of the folder (like what appears in your configuration file) or, if the
  9900. folder is one of your incoming folders, it may be the nickname you've given
  9901. the folder.
  9902. Here are a couple samples of specific folder names:
  9903. <P>
  9904. <CENTER><SAMP>{monet.art.nowhere.edu}mail/art-class</SAMP></CENTER>
  9905. <P>
  9906. <CENTER><SAMP>{news.myisp.com/nntp}#news.comp.mail.pine</SAMP></CENTER>
  9907. <P>
  9908. The easiest way to fill in the "Folder" field is to use
  9909. the "T" command which is available when the "Folder" line is
  9910. hilighted, or to use the "Take" command with the configuration
  9911. feature
  9912. <A HREF="h_config_enable_role_take">"enable-rules-under-take"</A>
  9913. turned on.
  9914. Note that you won't be able to edit the "Folder" line unless the
  9915. Current Folder Type is set to "Specific", and any value that
  9916. "Folder" has is ignored unless the type
  9917. is set to "Specific".
  9918. <P>
  9919. When reading a newsgroup, there may be a performance penalty
  9920. incurred when collecting the information necessary to check a Pattern.
  9921. For this reason, the default Current Folder Type is set to "Email".
  9922. <P>
  9923. Look <A HREF="h_edit_nav_cmds">here</A>
  9924. to see the available Editing and Navigation commands.
  9925. <P>
  9926. <End of help on this topic>
  9927. </BODY>
  9928. </HTML>
  9929. ======= h_config_filt_rule_type =======
  9930. <HTML>
  9931. <HEAD>
  9932. <TITLE>Filter Action Explained</TITLE>
  9933. </HEAD>
  9934. <BODY>
  9935. <H1>Filter Action Explained</H1>
  9936.  
  9937. The Filter Action specifies the action to be taken when the Pattern is a
  9938. match.
  9939. It may be set to either "Delete" or "Move".
  9940. If it is set to "Delete", then the message which matches the
  9941. Pattern will be deleted from the open folder.
  9942. <P>
  9943. If it is set to "Move", then the name of the folder to which
  9944. the matching message should be moved is given in the Folder field on the
  9945. next line of the screen.
  9946. A list of folders separated by commas may be given, in which case the
  9947. message will be copied to all of the folders in the list before it is
  9948. deleted.
  9949. <P>
  9950. The easiest way to fill in the "Folder" field is to use
  9951. the T command which is available when the "Folder" line is
  9952. hilighted.
  9953. Note that you won't be able to edit the "Folder" line unless the
  9954. Filter Action is set to "Move", and any value that
  9955. "Folder" has is ignored unless the type
  9956. is set to "Move".
  9957. <P>
  9958. Look <A HREF="h_edit_nav_cmds">here</A>
  9959. to see the available Editing and Navigation commands.
  9960. <P>
  9961. <End of help on this topic>
  9962. </BODY>
  9963. </HTML>
  9964. ======= h_config_score_fldr_type =======
  9965. <HTML>
  9966. <HEAD>
  9967. <TITLE>Current Folder Type Explained</TITLE>
  9968. </HEAD>
  9969. <BODY>
  9970. <H1>Current Folder Type Explained</H1>
  9971.  
  9972. The Current Folder Type is part of the scoring rule's Pattern.
  9973. It refers to the type of the folder which
  9974. the message being scored is in.
  9975. In order for a rule to be considered a match, the current folder must
  9976. be of the type you set here.
  9977. The three types "Any", "News", and "Email" are
  9978. all what you might think.
  9979. <P>
  9980. If the Current Folder Type for a Pattern is set to "News", for
  9981. example, then
  9982. that Pattern will only match if the current folder is a newsgroup and
  9983. the rest of the Pattern matches.
  9984. The value "Specific" may be used when you want to limit the match
  9985. to a specific folder (not just a specific type of folder), or to a list of
  9986. specific folders.
  9987. <P>
  9988. In order to match a specific folder you Select the "Specific"
  9989. button <EM>AND</EM> fill in
  9990. the name (or comma-separated list of names) of
  9991. the folder in the "Folder" field.
  9992. If the current folder is any of the folders in the list, that is considered
  9993. a match.
  9994. The name of each folder in the list may be either "INBOX", the technical specification
  9995. of the folder (like what appears in your configuration file) or, if the
  9996. folder is one of your incoming folders, it may be the nickname you've given
  9997. the folder.
  9998. Here are a couple samples of specific folder names:
  9999. <P>
  10000. <CENTER><SAMP>{monet.art.nowhere.edu}mail/art-class</SAMP></CENTER>
  10001. <P>
  10002. <CENTER><SAMP>{news.myisp.com/nntp}#news.comp.mail.pine</SAMP></CENTER>
  10003. <P>
  10004. The easiest way to fill in the "Folder" field is to use
  10005. the T command which is available when the "Folder" line is
  10006. hilighted.
  10007. Note that you won't be able to edit the "Folder" line unless the
  10008. Current Folder Type is set to "Specific", and any value that
  10009. "Folder" has is ignored unless the type
  10010. is set to "Specific".
  10011. <P>
  10012. When reading a newsgroup, there may be a performance penalty
  10013. incurred when collecting the information necessary to check a Pattern.
  10014. For this reason, the default Current Folder Type is set to "Email".
  10015. For example, if you have Index Line Coloring rules which have Score Intervals
  10016. defined then the scores for all the visible messages will need to be calculated.
  10017. If some of your Scoring rules have 
  10018. a Current Folder Type of
  10019. "Any" or "News" this may cause the MESSAGE INDEX
  10020. screen to draw more slowly when in a newsgroup.
  10021. <P>
  10022. Look <A HREF="h_edit_nav_cmds">here</A>
  10023. to see the available Editing and Navigation commands.
  10024. <P>
  10025. <End of help on this topic>
  10026. </BODY>
  10027. </HTML>
  10028. ======= h_config_incol_fldr_type =======
  10029. <HTML>
  10030. <HEAD>
  10031. <TITLE>Current Folder Type Explained</TITLE>
  10032. </HEAD>
  10033. <BODY>
  10034. <H1>Current Folder Type Explained</H1>
  10035.  
  10036. The Current Folder Type is part of the Line Coloring rule's Pattern.
  10037. It refers to the type of the folder for which the MESSAGE INDEX is
  10038. being viewed.
  10039. In order for a rule to be considered a match, the current folder must
  10040. be of the type you set here.
  10041. The three types "Any", "News", and "Email" are
  10042. all what you might think.
  10043. <P>
  10044. If the Current Folder Type for a Pattern is set to "News", for
  10045. example, then
  10046. that Pattern will only match if the current folder is a newsgroup and
  10047. the rest of the Pattern matches.
  10048. The value "Specific" may be used when you want to limit the match
  10049. to a specific folder (not just a specific type of folder), or to a list of
  10050. specific folders.
  10051. <P>
  10052. In order to match a specific folder you Select the "Specific"
  10053. button <EM>AND</EM> fill in
  10054. the name (or comma-separated list of names) of
  10055. the folder in the "Folder" field.
  10056. If the current folder is any of the folders in the list, that is considered
  10057. a match.
  10058. The name of each folder in the list may be either "INBOX", the technical specification
  10059. of the folder (like what appears in your configuration file) or, if the
  10060. folder is one of your incoming folders, it may be the nickname you've given
  10061. the folder.
  10062. Here are a couple samples of specific folder names:
  10063. <P>
  10064. <CENTER><SAMP>{monet.art.nowhere.edu}mail/art-class</SAMP></CENTER>
  10065. <P>
  10066. <CENTER><SAMP>{news.myisp.com/nntp}#news.comp.mail.pine</SAMP></CENTER>
  10067. <P>
  10068. The easiest way to fill in the "Folder" field is to use
  10069. the T command which is available when the "Folder" line is
  10070. hilighted.
  10071. Note that you won't be able to edit the "Folder" line unless the
  10072. Current Folder Type is set to "Specific", and any value that
  10073. "Folder" has is ignored unless the type
  10074. is set to "Specific".
  10075. <P>
  10076. When reading a newsgroup, there may be a performance penalty
  10077. incurred when collecting the information necessary to check a Pattern.
  10078. For this reason, the default Current Folder Type is set to "Email".
  10079. For example, a rule with a non-Normal Index Line Color
  10080. and a Current Folder Type of
  10081. "Any" or "News" may cause the MESSAGE INDEX
  10082. screen to draw more slowly when in a newsgroup.
  10083. <P>
  10084. Look <A HREF="h_edit_nav_cmds">here</A>
  10085. to see the available Editing and Navigation commands.
  10086. <P>
  10087. <End of help on this topic>
  10088. </BODY>
  10089. </HTML>
  10090. ======= h_config_filt_fldr_type =======
  10091. <HTML>
  10092. <HEAD>
  10093. <TITLE>Current Folder Type Explained</TITLE>
  10094. </HEAD>
  10095. <BODY>
  10096. <H1>Current Folder Type Explained</H1>
  10097.  
  10098. The Current Folder Type is part of the Filtering rule's Pattern.
  10099. It refers to the type of the folder for which the filtering is being done.
  10100. In order for a rule to be considered a match, the current folder must
  10101. be of the type you set here.
  10102. The three types "Any", "News", and "Email" are
  10103. all what you might think.
  10104. <P>
  10105. If the Current Folder Type for a Pattern is set to "News", for
  10106. example, then
  10107. that Pattern will only match if the current folder is a newsgroup and
  10108. the rest of the Pattern matches.
  10109. The value "Specific" may be used when you want to limit the match
  10110. to a specific folder (not just a specific type of folder), or to a list of
  10111. specific folders.
  10112. <P>
  10113. In order to match a specific folder you Select the "Specific"
  10114. button <EM>AND</EM> fill in
  10115. the name (or comma-separated list of names) of
  10116. the folder in the "Folder" field.
  10117. If the current folder is any of the folders in the list, that is considered
  10118. a match.
  10119. The name of each folder in the list may be either "INBOX", the technical specification
  10120. of the folder (like what appears in your configuration file) or, if the
  10121. folder is one of your incoming folders, it may be the nickname you've given
  10122. the folder.
  10123. Here are a couple samples of specific folder names:
  10124. <P>
  10125. <CENTER><SAMP>{monet.art.nowhere.edu}mail/art-class</SAMP></CENTER>
  10126. <P>
  10127. <CENTER><SAMP>{news.myisp.com/nntp}#news.comp.mail.pine</SAMP></CENTER>
  10128. <P>
  10129. The easiest way to fill in the "Folder" field is to use
  10130. the T command which is available when the "Folder" line is
  10131. hilighted.
  10132. Note that you won't be able to edit the "Folder" line unless the
  10133. Current Folder Type is set to "Specific", and any value that
  10134. "Folder" has is ignored unless the type
  10135. is set to "Specific".
  10136. <P>
  10137. When reading a newsgroup, there may be a performance penalty
  10138. incurred when collecting the information necessary to check a Pattern.
  10139. For this reason, the default Current Folder Type is set to "Email".
  10140. For example, a rule with a Current Folder Type of either
  10141. "Any" or "News" may cause the filtering to happen
  10142. more slowly when opening a newsgroup.
  10143. <P>
  10144. Look <A HREF="h_edit_nav_cmds">here</A>
  10145. to see the available Editing and Navigation commands.
  10146. <P>
  10147. <End of help on this topic>
  10148. </BODY>
  10149. </HTML>
  10150. ======= h_config_role_inick =======
  10151. <HTML>
  10152. <HEAD>
  10153. <TITLE>Initialize Values From Role Explained</TITLE>
  10154. </HEAD>
  10155. <BODY>
  10156. <H1>Initialize Values From Role Explained</H1>
  10157.  
  10158. This is a power user feature.
  10159. You will usually want to leave this field empty.
  10160. The value of this field is the nickname of another one of your roles.
  10161. The five Action values which begin with the word "Set" and the index
  10162. line color from that other role
  10163. are used as the initial values of the Action items for this role.
  10164. If you put something in any of the action fields for this role, that will
  10165. override whatever was in the corresponding field of the initializer role.
  10166. The fields affected by this field are the fields labeled
  10167. "Set From",
  10168. "Set Reply-To",
  10169. "Set Fcc",
  10170. "Set Signature",
  10171. "Set Template", and "Index Line Color".
  10172. <P>
  10173. You might use this field if the "Action" part of one of your roles
  10174. is something you want to use in more than one role.
  10175. Instead of filling in those action values again for each role, you
  10176. may give the nickname of the role where the values are filled in.
  10177. It's just a shortcut way to define Role Actions.
  10178. <P>
  10179. Here's an example to help explain how this works.
  10180. Suppose you have a role with nickname "role1" and role1 has
  10181. (among other things)
  10182. <P>
  10183. <CENTER><SAMP>Set Signature = sig_file1</SAMP></CENTER>
  10184. <P>
  10185. set.
  10186. If in "role2" you set "Initialize settings using role" to
  10187. "role1", then role2 will inherit the Set Signature value
  10188. from role1 by default (and any of the other inheritable action values
  10189. that are set).
  10190. So if role2 had
  10191. <P>
  10192. <CENTER><SAMP>Set Signature =</SAMP></CENTER>
  10193. <P>
  10194. defined, the signature file used with role2 would be "sig-file1".
  10195. However, if role2 had
  10196. <P>
  10197. <CENTER><SAMP>Set Signature = sig_file2</SAMP></CENTER>
  10198. <P>
  10199. defined, then the signature file used with role2 would be "sig-file2".
  10200. <P>
  10201. If you wish,
  10202. you may choose a nickname from your list of roles by using the
  10203. "T" command.
  10204. <P>
  10205. Look <A HREF="h_edit_nav_cmds">here</A>
  10206. to see the available Editing and Navigation commands.
  10207. <P>
  10208. <End of help on this topic>
  10209. </BODY>
  10210. </HTML>
  10211. ======= h_config_role_setfrom =======
  10212. <HTML>
  10213. <HEAD>
  10214. <TITLE>Set From Explained</TITLE>
  10215. </HEAD>
  10216. <BODY>
  10217. <H1>Set From Explained</H1>
  10218.  
  10219. This describes part of the action to be taken if the Pattern for this
  10220. role is a match.
  10221. This field consists of a single address which will be used as the From
  10222. address on the message you are sending.
  10223. This should be a fully-qualified address like
  10224. <P>
  10225. <CENTER><SAMP>Full Name <user@domain></SAMP></CENTER>
  10226. <P>
  10227. or just
  10228. <P>
  10229. <CENTER><SAMP>user@domain</SAMP></CENTER>
  10230. <P>
  10231. If you wish,
  10232. you may choose an address from your address book with the
  10233. "T" command.
  10234. <P>
  10235. If this is left blank, then your normal From address will be used.
  10236. <P>
  10237. Look <A HREF="h_edit_nav_cmds">here</A>
  10238. to see the available Editing and Navigation commands.
  10239. <P>
  10240. <End of help on this topic>
  10241. </BODY>
  10242. </HTML>
  10243. ======= h_config_role_setreplyto =======
  10244. <HTML>
  10245. <HEAD>
  10246. <TITLE>Set Reply-To Explained</TITLE>
  10247. </HEAD>
  10248. <BODY>
  10249. <H1>Set Reply-To Explained</H1>
  10250.  
  10251. This describes part of the action to be taken if the Pattern for this
  10252. role is a match.
  10253. This field consists of a single address which will be used as the Reply-To
  10254. address on the message you are sending.
  10255. This may be a fully-qualified address like
  10256. <P>
  10257. <CENTER><SAMP>Full Name <user@domain></SAMP></CENTER>
  10258. <P>
  10259. or just
  10260. <P>
  10261. <CENTER><SAMP>user@domain</SAMP></CENTER>
  10262. <P>
  10263. If you wish,
  10264. you may choose an address from your address book with the
  10265. "T" command.
  10266. <P>
  10267. If this is left blank, then there won't be a Reply-To address unless
  10268. you have configured one specially with the
  10269. "<A HREF="h_config_custom_hdrs">Customized-Headers</A>"
  10270. configuration option.
  10271. <P>
  10272. Look <A HREF="h_edit_nav_cmds">here</A>
  10273. to see the available Editing and Navigation commands.
  10274. <P>
  10275. <End of help on this topic>
  10276. </BODY>
  10277. </HTML>
  10278. ======= h_config_role_setfcc =======
  10279. <HTML>
  10280. <HEAD>
  10281. <TITLE>Set Fcc Explained</TITLE>
  10282. </HEAD>
  10283. <BODY>
  10284. <H1>Set Fcc Explained</H1>
  10285.  
  10286. This describes part of the action to be taken if the Pattern for this
  10287. role is a match.
  10288. This field consists of a single folder name which will be used in
  10289. the Fcc field of the message you are sending.
  10290. You may put anything here that you would normally type into the Fcc
  10291. field from the composer.
  10292. <P>
  10293. In addition, an fcc of "" (two double quotation marks) means
  10294. no Fcc.
  10295. <P>
  10296. A blank field here means that Pine will use its normal rules for deciding
  10297. the default value of the Fcc field.
  10298. For many roles, perhaps most, it may make more sense for you to use the
  10299. other Pine facilities for setting the Fcc.
  10300. In particular, if you want the Fcc to depend on who you are sending the
  10301. message to then the <A HREF="h_config_fcc_rule">"fcc-name-rule"</A>
  10302. is probably more useful.
  10303. In that case, you would want to leave the Fcc field here blank.
  10304. However, if you have a role that depends on who the message you are replying
  10305. to was From, or what address that message was sent to;
  10306. then it might make sense to set the Fcc for that role here.
  10307. <P>
  10308. If you wish,
  10309. you may choose a folder from your folder collections by using the
  10310. "T" command.
  10311. <P>
  10312. Look <A HREF="h_edit_nav_cmds">here</A>
  10313. to see the available Editing and Navigation commands.
  10314. <P>
  10315. <End of help on this topic>
  10316. </BODY>
  10317. </HTML>
  10318. ======= h_config_role_setsig =======
  10319. <HTML>
  10320. <HEAD>
  10321. <TITLE>Set Signature Explained</TITLE>
  10322. </HEAD>
  10323. <BODY>
  10324. <H1>Set Signature Explained</H1>
  10325.  
  10326. This describes part of the action to be taken if the Pattern for this
  10327. role is a match.
  10328. This field consists of a filename which will be used as the signature
  10329. file when using this role.
  10330. <P>
  10331. If the filename is followed by a vertical bar (|) then instead
  10332. of reading the contents of the file the file is assumed to be a
  10333. program which will produce the text to be used on its standard output.
  10334. The program can't have any arguments and doesn't receive any input from Pine,
  10335. but the rest of the processing works as if the contents came from a file.
  10336. <P>
  10337. If you type "F" you may edit the contents of the file (as opposed to
  10338. the name of the file) you have specified.
  10339. If you type "T" you may use a browser to choose an existing filename.
  10340. <P>
  10341. Besides containing regular text, a signature file may also
  10342. contain (or a signature program may produce) tokens which are replaced with text
  10343. which depends on the message you are replying to or forwarding.
  10344. The tokens all look like _word_ (a word surrounded by underscores).
  10345. For example, if the token
  10346. <P>
  10347. <CENTER><SAMP>_DATE_</SAMP></CENTER>
  10348. <P>
  10349. is included in the text of the signature file, then when you reply to
  10350. or forward a message, the token will be replaced with the actual date
  10351. the message you are replying to or forwarding was sent.
  10352. <P>
  10353. If you use a role which has a signature file for a plain composition
  10354. (that is, not a reply or forward) then there is no original message, so
  10355. any tokens which depend on the message will be replaced with nothing.
  10356. So if you want a signature file to be useful for new compositions it
  10357. shouldn't include any of the tokens which depend on the message being
  10358. replied to or forwarded.
  10359. <P>
  10360. The list of available tokens is
  10361. <A HREF="h_index_tokens">here</A>.
  10362. <P>
  10363. Actually, for the adventurous, there is a way to conditionally include text based
  10364. on whether or not a token would result in specific replacement text.
  10365. For example, you could include some text based on whether or not
  10366. the _NEWS_ token would result in any newsgroups if it was used.
  10367. It's explained in detail
  10368. <A HREF="h_reply_token_conditionals">here</A>.
  10369. <P>
  10370. In the very unlikely event that you want to include a literal token in
  10371. a signature file, you must precede it with a backslash character.
  10372. For example, to include the literal text _DATE_ you must actually use
  10373. \_DATE_.
  10374. It is not possible to have a literal backslash followed by an expanded token.
  10375. <P>
  10376. A blank field here means that Pine will use its normal rules for deciding
  10377. which file (if any) to use for the signature file.
  10378. <P>
  10379. Look <A HREF="h_edit_nav_cmds">here</A>
  10380. to see the available Editing and Navigation commands.
  10381. <P>
  10382. <End of help on this topic>
  10383. </BODY>
  10384. </HTML>
  10385. ======= h_config_role_settempl =======
  10386. <HTML>
  10387. <HEAD>
  10388. <TITLE>Set Template Explained</TITLE>
  10389. </HEAD>
  10390. <BODY>
  10391. <H1>Set Template Explained</H1>
  10392.  
  10393. This describes part of the action to be taken if the Pattern for this
  10394. role is a match.
  10395. This field consists of a filename which will be used as the template
  10396. file when using this role.
  10397. The template file is a file which is included at the top of the message you
  10398. are composing.
  10399. <P>
  10400. If the filename is followed by a vertical bar (|) then instead
  10401. of reading the contents of the file the file is assumed to be a
  10402. program which will produce the text to be used on its standard output.
  10403. The program can't have any arguments and doesn't receive any input from Pine,
  10404. but the rest of the processing works as if the contents came from a file.
  10405. <P>
  10406. If you type "F" you may edit the contents of the file (as opposed to
  10407. the name of the file) you have specified.
  10408. If you type "T" you may use a browser to choose an existing filename.
  10409. <P>
  10410. Besides containing regular text, the template file may also
  10411. contain (or a template file program may produce) tokens which are replaced with text
  10412. which depends on the message you are replying to or forwarding.
  10413. The tokens all look like _word_ (a word surrounded by underscores).
  10414. For example, if the token
  10415. <P>
  10416. <CENTER><SAMP>_DATE_</SAMP></CENTER>
  10417. <P>
  10418. is included in the text of the template file, then when you reply to
  10419. or forward a message, the token will be replaced with the actual date
  10420. the message you are replying to or forwarding was sent.
  10421. <P>
  10422. If you use a role which has a template file for a plain composition
  10423. (that is, not a reply or forward) then there is no original message, so
  10424. any tokens which depend on the message will be replaced with nothing.
  10425. So if you want a template file to be useful for new compositions it
  10426. shouldn't include any of the tokens which depend on the message being
  10427. replied to or forwarded.
  10428. <P>
  10429. The list of available tokens is
  10430. <A HREF="h_index_tokens">here</A>.
  10431. <P>
  10432. Actually, for the adventurous, there is a way to conditionally include text based
  10433. on whether or not a token would result in specific replacement text.
  10434. For example, you could include some text based on whether or not
  10435. the _NEWS_ token would result in any newsgroups if it was used.
  10436. It's explained in detail
  10437. <A HREF="h_reply_token_conditionals">here</A>.
  10438. <P>
  10439. In the very unlikely event that you want to include a literal token in
  10440. a template file, you must precede it with a backslash character.
  10441. For example, to include the literal text _DATE_ you must actually use
  10442. \_DATE_.
  10443. It is not possible to have a literal backslash followed by an expanded token.
  10444. <P>
  10445. A blank template field means that Pine will not use a template file when
  10446. this role is being used.
  10447. <P>
  10448. Look <A HREF="h_edit_nav_cmds">here</A>
  10449. to see the available Editing and Navigation commands.
  10450. <P>
  10451. <End of help on this topic>
  10452. </BODY>
  10453. </HTML>
  10454. ======= h_config_role_scoreval =======
  10455. <HTML>
  10456. <HEAD>
  10457. <TITLE>Score Value Explained</TITLE>
  10458. </HEAD>
  10459. <BODY>
  10460. <H1>Score Value Explained</H1>
  10461.  
  10462. A message's score is the sum of the Score Values from all of the Scoring rules
  10463. with Patterns which match the message.
  10464. The value you give here is the Score Value associated with this rule.
  10465. A Score Value is an integer between -100 and 100, with the default
  10466. value of zero.
  10467. <P>
  10468. Look <A HREF="h_edit_nav_cmds">here</A>
  10469. to see the available Editing and Navigation commands.
  10470. <P>
  10471. <End of help on this topic>
  10472. </BODY>
  10473. </HTML>
  10474. ======= h_config_role_replyuse =======
  10475. <HTML>
  10476. <HEAD>
  10477. <TITLE>Reply Use Explained</TITLE>
  10478. </HEAD>
  10479. <BODY>
  10480. <H1>Reply Use Explained</H1>
  10481.  
  10482. This option determines how this particular role will be used when Replying
  10483. to a message.
  10484. There are three possible values for this option.
  10485. The value "Never"
  10486. means that this role will not be a candidate for use when Replying.
  10487. The role's Pattern will not be checked for a match, however the role will
  10488. be available to be manually switched to if there is a confirmation prompt.
  10489. <P>
  10490.  
  10491. The options "With confirmation" and "Without confirmation"
  10492. mean that you do want to consider this role when Replying.
  10493. For either of these settings, the role's Pattern will be compared with
  10494. the message being replied to.
  10495. If there is a match then this role will either be used without confirmation
  10496. or will be the default when confirmation is asked for, depending on
  10497. which of the two options is selected.
  10498. If confirmation is requested, you will also have a chance to
  10499. manually change the role to any one of your other roles.
  10500. <P>
  10501.  
  10502. You won't be prompted for confirmation if none of your role Patterns
  10503. match the message being replied to.
  10504. This is independent of the value of the current option.
  10505. The <A HREF="h_config_confirm_role">confirm-role-even-for-default</A>
  10506. feature may be used to change this behavior.
  10507. <P>
  10508. <End of help on this topic>
  10509. </BODY>
  10510. </HTML>
  10511. ======= h_config_role_forwarduse =======
  10512. <HTML>
  10513. <HEAD>
  10514. <TITLE>Forward Use Explained</TITLE>
  10515. </HEAD>
  10516. <BODY>
  10517. <H1>Forward Use Explained</H1>
  10518.  
  10519. This option determines how this particular role will be used when Forwarding
  10520. a message.
  10521. There are three possible values for this option.
  10522. The value "Never"
  10523. means that this role will not be a candidate for use when Forwarding.
  10524. The role's Pattern will not be checked for a match, however the role will
  10525. be available to be manually switched to if there is a confirmation prompt.
  10526. <P>
  10527.  
  10528. The options "With confirmation" and "Without confirmation"
  10529. mean that you do want to consider this role when Forwarding.
  10530. For either of these settings, the role's Pattern will be compared with
  10531. the message being forwarded.
  10532. If there is a match then this role will either be used without confirmation
  10533. or will be the default when confirmation is asked for, depending on
  10534. which of the two options is selected.
  10535. If confirmation is requested, you will also have a chance to
  10536. manually change the role to any one of your other roles.
  10537. <P>
  10538.  
  10539. You won't be prompted for confirmation if none of your role Patterns
  10540. match the message being forwarded.
  10541. This is independent of the value of the current option.
  10542. The <A HREF="h_config_confirm_role">confirm-role-even-for-default</A>
  10543. feature may be used to change this behavior.
  10544. <P>
  10545. <End of help on this topic>
  10546. </BODY>
  10547. </HTML>
  10548. ======= h_config_role_composeuse =======
  10549. <HTML>
  10550. <HEAD>
  10551. <TITLE>Compose Use Explained</TITLE>
  10552. </HEAD>
  10553. <BODY>
  10554. <H1>Compose Use Explained</H1>
  10555.  
  10556. This option determines how this particular role will be used when Composing
  10557. a new message using the "Compose" command.
  10558. This does not affect what happens when using the "Role" command
  10559. to compose a new message.
  10560. The "Role" command allows you to select a role from all of the
  10561. roles you have defined, regardless of what Uses you've assigned to those
  10562. roles.
  10563. <P>
  10564.  
  10565. There are three possible values for this option.
  10566. The value "Never"
  10567. means that this role will not be a candidate for use when Composing.
  10568. The role's Current Folder Type will not be checked for a match, however the role
  10569. will be available to be manually switched to if there is a confirmation prompt.
  10570. <P>
  10571.  
  10572. The options "With confirmation" and "Without confirmation"
  10573. mean that you do want to consider this role when Composing.
  10574. For either of these settings,
  10575. the role's Current Folder Type will be checked (since there is no message
  10576. to compare with, the rest of the Pattern is considered a match).
  10577. If there is a match then this role will either be used without confirmation
  10578. or will be the default when confirmation is asked for, depending on
  10579. which of the two options is selected.
  10580. If confirmation is requested, you will also have a chance to
  10581. manually change the role to any one of your other roles.
  10582. <P>
  10583.  
  10584. When using the Compose command the role checking is a little different
  10585. because there is no message being replied to or forwarded.
  10586. Because of this the Current Folder Type is checked but the header pattern
  10587. fields, the AllText pattern, and the Score Interval are all ignored.
  10588. A role is considered to be a match if it is a candidate for Compose Use and
  10589. its Current Folder Type matches the currently open folder.
  10590. This could be useful if you want to set a role based on the folder you
  10591. are reading, or the type of folder you are reading.
  10592. <P>
  10593.  
  10594. You won't be prompted for confirmation if none of your role Patterns
  10595. are a match.
  10596. This is independent of the value of the current option.
  10597. The <A HREF="h_config_confirm_role">confirm-role-even-for-default</A>
  10598. feature may be used to change this behavior.
  10599. <P>
  10600. <End of help on this topic>
  10601. </BODY>
  10602. </HTML>
  10603. ======= h_config_filter_folder =======
  10604. <HTML>
  10605. <HEAD>
  10606. <TITLE>Filter Folder Explained</TITLE>
  10607. </HEAD>
  10608. <BODY>
  10609. <H1>Filter Folder Explained</H1>
  10610.  
  10611. When the Filter Action is set to "Move",
  10612. the folder or folders specified here will be used to store messages matching
  10613. the provided pattern.
  10614.  
  10615. <P>
  10616. If you set the Filter Action to "Move" you must give a folder name
  10617. here.
  10618.  
  10619. <P>
  10620. If you wish,
  10621. you may choose a folder from your folder collections by using the
  10622. "T" command.
  10623. <P>
  10624. Look <A HREF="h_edit_nav_cmds">here</A>
  10625. to see the available Editing and Navigation commands.
  10626. <P>
  10627. <End of help on this topic>
  10628. </BODY>
  10629. </HTML>
  10630. ======= h_index_tokens =======
  10631. <HTML>
  10632. <HEAD>
  10633. <TITLE>Tokens for Index and Replying</TITLE>
  10634. </HEAD>
  10635. <BODY>
  10636.  
  10637. This set of special tokens may be used in the
  10638. <A HREF="h_config_index_format">"Index-Format" option</A>,
  10639. in the <A HREF="h_config_reply_intro">"Reply-Leadin" option</A>,
  10640. in signature files,
  10641. and in template files used in
  10642. <A HREF="h_rules_roles">"roles"</A>.
  10643. Some of them aren't available in all situations.
  10644. <P>
  10645. The tokens are used as they appear below for the "Index-Format"
  10646. option, but they must be surrounded by underscores for the
  10647. "Reply-Leadin" option and in signature and template files.
  10648. <P>
  10649. <P>
  10650.  
  10651. <H1><EM>Tokens Available for all Cases</EM></H1>
  10652.  
  10653. <DL>
  10654. <DT>DATE</DT>
  10655. <DD>
  10656. This token represents the date on which the message was sent, according
  10657. to the "Date" header field.
  10658. It has the format MMM DD. For example, "Oct 23".
  10659. </DD>
  10660.  
  10661. <DT>SMARTDATE</DT>
  10662. <DD>
  10663. This token represents the date on which the message was sent, according
  10664. to the "Date" header field.
  10665. It is "Today" if the message was sent today,
  10666. "Yesterday" for yesterday,
  10667. "Wednesday" if it was last Wednesday, and so on. If the
  10668. message is from more than six months ago it includes the year, as well.
  10669. There is no adjustment made for different time zones, so you'll get
  10670. the day the message was sent according to the time zone the sender
  10671. was in.
  10672. </DD>
  10673.  
  10674. <DT>LONGDATE</DT>
  10675. <DD>
  10676. This token represents the date on which the message was sent, according
  10677. to the "Date" header field.
  10678. It has the format MMM DD, YYYY. For example, "Oct 23, 1999".
  10679. </DD>
  10680.  
  10681. <DT>DATEISO</DT>
  10682. <DD>
  10683. This token represents the date on which the message was sent, according
  10684. to the "Date" header field.
  10685. It has the format YYYY-MM-DD. For example, "1998-10-23".
  10686. </DD>
  10687.  
  10688. <DT>SHORTDATEISO</DT>
  10689. <DD>
  10690. This token represents the date on which the message was sent, according
  10691. to the "Date" header field.
  10692. It has the format YY-MM-DD. For example, "98-10-23".
  10693. </DD>
  10694.  
  10695. <DT>SHORTDATE1</DT>
  10696. <DD>
  10697. This token represents the date on which the message was sent, according
  10698. to the "Date" header field.
  10699. It has the format MM/DD/YY. For example, "10/23/98".
  10700. </DD>
  10701.  
  10702. <DT>SHORTDATE2</DT>
  10703. <DD>
  10704. This token represents the date on which the message was sent, according
  10705. to the "Date" header field.
  10706. It has the format DD/MM/YY. For example, "23/10/98".
  10707. </DD>
  10708.  
  10709. <DT>SHORTDATE3</DT>
  10710. <DD>
  10711. This token represents the date on which the message was sent, according
  10712. to the "Date" header field.
  10713. It has the format DD.MM.YY. For example, "23.10.98".
  10714. </DD>
  10715.  
  10716. <DT>SHORTDATE4</DT>
  10717. <DD>
  10718. This token represents the date on which the message was sent, according
  10719. to the "Date" header field.
  10720. It has the format YY.MM.DD. For example, "98.10.23".
  10721. </DD>
  10722.  
  10723. <DT>TIME24</DT>
  10724. <DD>
  10725. This token represents the time at which the message was sent, according
  10726. to the "Date" header field.
  10727. There is no adjustment made for different time zones, so you'll get
  10728. the time the message was sent according to the time zone the sender
  10729. was in.
  10730. It has the format HH:MM. For example, "17:28".
  10731. </DD>
  10732.  
  10733. <DT>TIME12</DT>
  10734. <DD>
  10735. This token represents the time at which the message was sent, according
  10736. to the "Date" header field.
  10737. This time is for a 12 hour clock.
  10738. It has the format HH:MMpm.
  10739. For example, "5:28pm" or "11:13am".
  10740. </DD>
  10741.  
  10742. <DT>TIMEZONE</DT>
  10743. <DD>
  10744. This token represents the numeric timezone from
  10745. the "Date" header field.
  10746. It has the format [+-]HHMM. For example, "-0800".
  10747. </DD>
  10748.  
  10749. <DT>SUBJECT</DT>
  10750. <DD>
  10751. This token represents the Subject the sender gave the message.
  10752. </DD>
  10753.  
  10754. <DT>FROM</DT>
  10755. <DD>
  10756. This token represents the personal name (or email address if the name
  10757. is unavailable) of the person specified in the message's "From:"
  10758. header field.
  10759. </DD>
  10760.  
  10761. <DT>SENDER</DT>
  10762. <DD>
  10763. This token represents the personal name (or email address) of the person
  10764. listed in the message's "Sender:" header field.
  10765. </DD>
  10766.  
  10767. <DT>TO</DT>
  10768. <DD>
  10769. This token represents the personal names (or email addresses if the names
  10770. are unavailable) of the persons specified in the
  10771. message's "To:" header field.
  10772. </DD>
  10773.  
  10774. <DT>NEWSANDTO</DT>
  10775. <DD>
  10776. This token represents the newsgroups from the
  10777. message's "Newsgroups:" header field <EM>and</EM>
  10778. the personal names (or email addresses if the names
  10779. are unavailable) of the persons specified in the
  10780. message's "To:" header field.
  10781. </DD>
  10782.  
  10783. <DT>TOANDNEWS</DT>
  10784. <DD>
  10785. Same as "NEWSANDTO" except in the opposite order.
  10786. </DD>
  10787.  
  10788. <DT>NEWS</DT>
  10789. <DD>
  10790. This token represents the newsgroups from the
  10791. message's "Newsgroups:" header field.
  10792. </DD>
  10793.  
  10794. <DT>CC</DT>
  10795. <DD>
  10796. This token represents the personal names (or email addresses if the names
  10797. are unavailable) of the persons specified in the
  10798. message's "Cc:" header field.
  10799. </DD>
  10800.  
  10801. <DT>RECIPS</DT>
  10802. <DD>
  10803. This token represents the personal names (or email addresses if the names
  10804. are unavailable) of the persons specified in both the
  10805. message's "To:" header field and
  10806. the message's "Cc:" header field.
  10807. </DD>
  10808.  
  10809. <DT>NEWSANDRECIPS</DT>
  10810. <DD>
  10811. This token represents the newsgroups from the
  10812. message's "Newsgroups:" header field <EM>and</EM>
  10813. the personal names (or email addresses if the names
  10814. are unavailable) of the persons specified in the
  10815. message's "To:" and "Cc:" header fields.
  10816. </DD>
  10817.  
  10818. <DT>RECIPSANDNEWS</DT>
  10819. <DD>
  10820. Same as "NEWSANDRECIPS" except in the opposite order.
  10821. </DD>
  10822.  
  10823. <DT>MONTHABBREV</DT>
  10824. <DD>
  10825. This token represents the month the message was sent, according
  10826. to the "Date" header field.
  10827. For example, "Oct".
  10828. </DD>
  10829.  
  10830. </DL>
  10831.  
  10832. <P>
  10833. <H1><EM>Tokens Available Only for Index-Format</EM></H1>
  10834.  
  10835. <DL>
  10836. <DT>MSGNO</DT>
  10837. <DD>
  10838. This token represents the message's current position in the folder which,
  10839. of course, may change as the folder is sorted or new mail arrives.
  10840. </DD>
  10841.  
  10842. <DT>STATUS</DT>
  10843. <DD>
  10844. This token represents a three character wide field displaying various
  10845. aspects of the message's state.
  10846. The first character is either blank,
  10847. a '*' for message marked Important, or a '+' indicating a message
  10848. addressed directly to you (as opposed to your having received it via a
  10849. mailing list, for example).
  10850. The second character is typically blank,
  10851. though the arrow cursor may occupy it if the 
  10852. "<A HREF="h_config_force_low_speed">assume-slow-link</A>"
  10853. feature is set, or you actually are on a slow link.
  10854. The third character is either '<A HREF="h_flag_deleted">D</A>',
  10855. '<A HREF="h_flag_answered">A</A>',
  10856. '<A HREF="h_flag_new">N</A>' or blank.
  10857. </DD>
  10858.  
  10859. <DT>FULLSTATUS</DT>
  10860. <DD>
  10861. This token represents a less abbreviated alternative
  10862. to the "STATUS" field.
  10863. It is six characters wide.
  10864. The first character is '+' or blank, the
  10865. second blank, the third either '*' or blank, the fourth
  10866. '<A HREF="h_flag_new">N</A>' or blank,
  10867. the fifth '<A HREF="h_flag_answered">A</A>'
  10868. or blank, and the sixth character is
  10869. either '<A HREF="h_flag_deleted">D</A>' or
  10870. blank.
  10871. </DD>
  10872.  
  10873. <DT>IMAPSTATUS</DT>
  10874. <DD>
  10875. This token represents an even less abbreviated alternative to the
  10876. "FULLSTATUS" field.
  10877. It differs in only the fourth character which is
  10878. either an 'N' if the message is new to this folder since the last time
  10879. it was opened <EM>and</EM> it has not been viewed, an 'R' if the message
  10880. is new to the folder and has been viewed (Recent), a 'U' if the message is not 
  10881. new to the folder since it was last opened <EM>but</EM> has not been
  10882. viewed (Unseen), or a blank if the message has been in the folder since it was
  10883. last opened and has been viewed.
  10884. </DD>
  10885.  
  10886. <DT>SIZE</DT>
  10887. <DD>
  10888. This token represents the total size, in bytes, of the message.
  10889. </DD>
  10890.  
  10891. <DT>DESCRIPSIZE</DT>
  10892. <DD>
  10893. This token is intended to represent a more useful description of the
  10894. message than just its size, but it isn't very useful at this point.
  10895. The plus sign in this view means there are attachments.
  10896. Note that including this token in
  10897. the "Index-Format" could slow down the
  10898. display a little while Pine collects the necessary information.
  10899. </DD>
  10900.  
  10901. <DT>ATT</DT>
  10902. <DD>
  10903. This is a one column wide field which represents the number of attachments
  10904. a message has. It will be blank if there are no attachments, a single
  10905. digit for one to nine attachments, or an asterisk for more than nine.
  10906. Note that including this token in
  10907. the "Index-Format" could slow down the
  10908. display a little while Pine collects the necessary information.
  10909. </DD>
  10910.  
  10911. <DT>FROMORTO</DT>
  10912. <DD>
  10913. This token represents <EM>either</EM> the personal name (or email address) of
  10914. the person listed in the message's "From:" header
  10915. field, <EM>or</EM>, if that address is yours or one of your
  10916. <A HREF="h_config_alt_addresses">alternate addresses</A>,
  10917. the first person specified in the
  10918. message's "To:" header field
  10919. with the prefix "To: " prepended.
  10920. </DD>
  10921. </DL>
  10922.  
  10923. <P>
  10924. <H1><EM>Tokens Available for all but Index-Format</EM></H1>
  10925.  
  10926. <DL>
  10927. <DT>ADDRESS</DT>
  10928. <DD>
  10929. This is similar to the "FROM" token, only it is always the
  10930. email address, never the personal name.
  10931. For example, "mailbox@domain".
  10932. </DD>
  10933.  
  10934. <DT>MAILBOX</DT>
  10935. <DD>
  10936. This is the same as the "ADDRESS" except that the 
  10937. domain part of the address is left off.
  10938. For example, "mailbox".
  10939. </DD>
  10940.  
  10941. <DT>DAYDATE</DT>
  10942. <DD>
  10943. This token represents the date on which the message was sent, according
  10944. to the "Date" header field.
  10945. It looks like "Sat, 24 Oct 1999" unless the day of
  10946. the week is not available, in which case it looks like
  10947. "24 Oct 1999".
  10948. </DD>
  10949.  
  10950. <DT>DAY</DT>
  10951. <DD>
  10952. This token represents the day of the month on which the message was sent,
  10953. according to the "Date" header field.
  10954. For example, "24" or "9".
  10955. </DD>
  10956.  
  10957. <DT>DAY2DIGIT</DT>
  10958. <DD>
  10959. This token represents the day of the month on which the message was sent,
  10960. according to the "Date" header field.
  10961. For example, "24" or "09".
  10962. </DD>
  10963.  
  10964. <DT>MONTHLONG</DT>
  10965. <DD>
  10966. This token represents the month in which the message was sent, according
  10967. to the "Date" header field.
  10968. For example, "October".
  10969. </DD>
  10970.  
  10971. <DT>MONTH</DT>
  10972. <DD>
  10973. This token represents the month in which the message was sent, according
  10974. to the "Date" header field.
  10975. For example, "10" or "9".
  10976. </DD>
  10977.  
  10978. <DT>MONTH2DIGIT</DT>
  10979. <DD>
  10980. This token represents the month in which the message was sent, according
  10981. to the "Date" header field.
  10982. For example, "10" or "09".
  10983. </DD>
  10984.  
  10985. <DT>YEAR</DT>
  10986. <DD>
  10987. This token represents the year the message was sent, according
  10988. to the "Date" header field.
  10989. For example, "1999" or "2001".
  10990. </DD>
  10991.  
  10992. <DT>YEAR2DIGIT</DT>
  10993. <DD>
  10994. This token represents the year the message was sent, according
  10995. to the "Date" header field.
  10996. For example, "99" or "01".
  10997. </DD>
  10998.  
  10999. <DT>MSGID</DT>
  11000. <DD>
  11001. This token represents the message ID of the message.
  11002. </DD>
  11003.  
  11004. <DT>CURDATE</DT>
  11005. <DD>
  11006. This token represents the current date.
  11007. It has the format MMM DD. For example, "Oct 23".
  11008. </DD>
  11009.  
  11010. <DT>CURDATEISO</DT>
  11011. <DD>
  11012. This token represents the current date.
  11013. It has the format YYYY-MM-DD. For example, "1998-10-23".
  11014. </DD>
  11015.  
  11016. <DT>CURDATEISOS</DT>
  11017. <DD>
  11018. This token represents the current date.
  11019. It has the format YY-MM-DD. For example, "98-10-23".
  11020. </DD>
  11021.  
  11022. <DT>CURTIME24</DT>
  11023. <DD>
  11024. This token represents the current time.
  11025. It has the format HH:MM. For example, "17:28".
  11026. </DD>
  11027.  
  11028. <DT>CURTIME12</DT>
  11029. <DD>
  11030. This token represents the current time.
  11031. This time is for a 12 hour clock.
  11032. It has the format HH:MMpm.
  11033. For example, "5:28pm" or "11:13am".
  11034. </DD>
  11035. </DL>
  11036.  
  11037. <P>
  11038. <H1><EM>Token Available Only for Templates and Signatures</EM></H1>
  11039.  
  11040. <DL>
  11041. <DT>CURSORPOS</DT>
  11042. <DD>
  11043. This token is different from the others.
  11044. When it is replaced it is replaced with nothing, but it sets a Pine
  11045. internal variable which tells the composer to start with the cursor
  11046. positioned at the position where this token was.
  11047. If both the template file and the signature file contain
  11048. a "CURSORPOS" token, then the position in the template file
  11049. is used.
  11050. If there is a template file and neither it nor the signature file contains
  11051. a "CURSORPOS" token, then the cursor is positioned
  11052. after the end of the contents of the
  11053. template file when the composer starts up.
  11054. </DD>
  11055. </DL>
  11056.  
  11057. <P>
  11058. <End of help on this topic>
  11059. </BODY>
  11060. </HTML>
  11061. ======= h_reply_token_conditionals =======
  11062. <HTML>
  11063. <HEAD>
  11064. <TITLE>Conditional Inclusion of Text for Reply-Leadin, Signatures, and Templates</TITLE>
  11065. </HEAD>
  11066. <BODY>
  11067.  
  11068. Conditional text inclusion may be used with
  11069. the <A HREF="h_config_reply_intro">"Reply-Leadin" option</A>,
  11070. in signature files, and in template files used in
  11071. <A HREF="h_rules_roles">"roles"</A>.
  11072. It may <EM>not</EM> be used with the
  11073. "Index-Format" option.
  11074.  
  11075. <P>
  11076. There is a limited if-else capability for including text.
  11077. The if-else condition is based
  11078. on whether or not a given token would result in replacement text you
  11079. specify.
  11080. The syntax of this conditional inclusion is
  11081. <P>
  11082. <CENTER><SAMP>_token_(match_this, if_matched [ , if_not_matched ] )</SAMP></CENTER>
  11083. <P>
  11084. The left parenthesis must follow the underscore immediately, with no
  11085. intervening space.
  11086. It means the token is expanded and the results of that expansion are
  11087. compared against the "match_this" argument.
  11088. If there is an exact match, then the "if_matched" text is used
  11089. as the replacement text.
  11090. Otherwise, the "if_not_matched" text is used.
  11091. One of the most useful values for the "match_this" argument is
  11092. the empty string, "".
  11093. In that case the expansion is compared against the empty string.
  11094. <P>
  11095. Here's an example to make it clearer.
  11096. This text could be included in one of your template files:
  11097. <P>
  11098. <CENTER><SAMP>_NEWS_("", "I'm replying to email", "I'm replying to news")</SAMP></CENTER>
  11099. <P>
  11100. If that is included in a template file which you are using while replying
  11101. to a message (because you chose to use the role it was part of),
  11102. and that message has a newsgroup header and a newsgroup in that header,
  11103. then the text
  11104. <P>
  11105. <CENTER><SAMP>I'm replying to news</SAMP></CENTER>
  11106. <P>
  11107. will be included in the message you are about to compose.
  11108. On the other hand, if the message you are replying to does not have
  11109. a newsgroup, then the text
  11110. <P>
  11111. <CENTER><SAMP>I'm replying to email</SAMP></CENTER>
  11112. <P>
  11113. would be included instead.
  11114. This would also work in signature files and in
  11115. the "Reply-Leadin" option.
  11116. If the "match_this", "if_matched",
  11117. or "if_not_matched" arguments contain
  11118. spaces, parentheses, or commas;
  11119. they have to be quoted with double quotation marks (like in the example
  11120. above).
  11121. If you want to include a literal quote (") in the text you must escape the
  11122. quote by preceding it with a backslash (\) character.
  11123. If you want to include a literal backslash character you must escape it
  11124. by preceding it with another backslash.
  11125. <P>
  11126. The comma followed by "if_not_matched" is optional.
  11127. If there is no "if_not_matched"
  11128. present then no text is included if the not_matched case is true.
  11129. Here's another example:
  11130. <P>
  11131. <CENTER><SAMP>_NEWS_("", "", "This msg was seen in group: _NEWS_.")</SAMP></CENTER>
  11132. <P>
  11133. Here you can see that tokens may appear inside
  11134. the "if_matched" or "if_not_matched" arguments.
  11135. The same is true for tokens with the conditional parentheses.
  11136. They may appear inside the "if_matched" or "if_not_matched",
  11137. though you do have to be careful to get the quoting and escaping of
  11138. nested double quotes correct.
  11139. If this was in the signature file being used and you were replying to a message
  11140. sent to comp.mail.pine the resulting text would be:
  11141. <P>
  11142. <CENTER><SAMP>This msg was seen in group: comp.mail.pine.</SAMP></CENTER>
  11143. <P>
  11144. If you were replying to a message which wasn't sent to any newsgroup the
  11145. resulting text would be a single blank line.
  11146. The reason you'd get a blank line is because the end of the line is
  11147. outside of the conditional, so is always included.
  11148. If you wanted to get rid of that blank line you could do so by moving
  11149. the end of line inside the conditional.
  11150. In other words, it's ok to have multi-line
  11151. "if_matched" or "if_not_matched" arguments.
  11152. The text just continues until the next double quotation, even if it's not
  11153. on the same line.
  11154. <P>
  11155. Here's one more (contrived) example illustrating a matching argument
  11156. which is not the empty string.
  11157. <P>
  11158. <CENTER><SAMP>_SMARTDATE_("Today", _SMARTDATE_, "On _DATE_") _FROM_ wrote:</SAMP></CENTER>
  11159. <P>
  11160. If this was the value of your "Reply-Leadin" option and you
  11161. were replying to
  11162. a message which was sent today, then the value of the "Reply-Leadin"
  11163. would be
  11164. <P>
  11165. <CENTER><SAMP>Today Fred Flintstone wrote:</SAMP></CENTER>
  11166. <P>
  11167. But if you were replying to a message sent on Oct. 27 (and that wasn't
  11168. today) you would get
  11169. <P>
  11170. <CENTER><SAMP>On Oct 27 Fred Flintstone wrote:</SAMP></CENTER>
  11171. <P>
  11172.  
  11173. <End of help on this topic>
  11174. </BODY>
  11175. </HTML>
  11176. ======= h_composer_cntxt_nick =======
  11177. <HTML>
  11178. <HEAD>
  11179. <TITLE>Collection Nickname Explained</TITLE>
  11180. </HEAD>
  11181. <BODY>
  11182. <H1>Collection Edit Help -- Nickname Field</H1>
  11183.  
  11184. This field is provided so you can add a short nickname to use when
  11185. referring to this collection within Pine.  Spaces are allowed, and
  11186. you don't need to use double-quotes.  However, the double-quote
  11187. character is not allowed.
  11188. <P>
  11189. Look <A HREF="h_edit_nav_cmds">here</A>
  11190. to see the available Editing and Navigation commands.
  11191. <P>
  11192. <End of help on this topic>
  11193. </BODY>
  11194. </HTML>
  11195. ======= h_composer_cntxt_server =======
  11196. <HTML>
  11197. <HEAD>
  11198. <TITLE>Collection Server: Explained</TITLE>
  11199. </HEAD>
  11200. <BODY>
  11201. <H1>Collection Edit Help -- Server Field</H1>
  11202.  
  11203. This collection's "Server:" definition indicates the
  11204. hostname of the server providing access to the folders in this
  11205. collection.  It's a good idea to use the host's fully qualified
  11206. network name.  However, IP addresses are allowed if it's delimited
  11207. with square-brackets (e.g., [127.0.0.1]).
  11208.  
  11209. <P>
  11210. Additionally, an optional network port number can be supplied by appending
  11211. the server name with a colon, ":", followed by the port number
  11212. on the server to connect to.  By default, the IMAP port number, 143, is used.
  11213.  
  11214. <P>
  11215. Besides server name and optional port number, various parameters can
  11216. be supplied as well that alter Pine's interaction with the server.  A
  11217. parameter is supplied by appending the server's name with a slash,
  11218. "/", character followed by the parameter's name and,
  11219. depending on the particular parameter, the value assigned to that
  11220. name.  Currently supported parameters include:
  11221.  
  11222. <DL>
  11223. <DT>User</DT>
  11224. <DD>This parameter requires an associated value, and is intended to
  11225. provide the username identifier with which to establish the server
  11226. connection.  An example might be: "/user=katie"
  11227. </DD>
  11228. <DT>Service</DT>
  11229. <DD>This parameter requires an associated value.  The default value is
  11230. "IMAP" which indicates communication with the server based
  11231. on the IMAP4.1 protocol (defined in RFC 2060 -- see 
  11232. <A HREF="http://www.imap.org/docs/rfc2060.html">http://www.imap.org/docs/rfc2060.html</A>).</DD>
  11233.  </DL>
  11234.  
  11235. Other values include:
  11236.  <DL>
  11237.  <DT>NNTP</DT>
  11238.  <DD>This value indicates communication with the server takes place via
  11239. the Network News Transfer Protocol.  Use this to define a collection
  11240. of newsgroups on a remote news server.  So, "/service=NNTP"
  11241. (without the quotes) is the way to specify NNTP access.
  11242.  </DD>
  11243.  <DT>POP3</DT>
  11244.  <DD>This value indicates communication with the server takes place via the
  11245. Post Office Protocol 3 protocol.  Note that there are several important issues
  11246. to consider when selecting this option:
  11247. <OL>
  11248.  <LI> POP3 provides access to only your INBOX.  In other words,
  11249. secondary folders such as your "saved-messages" are inaccessible.
  11250.  <LI> Pine's implementation of POP3 does not follow the traditional POP
  11251. model and will leave your mail on the server.
  11252.  <LI> Pine's implementation of POP3 is not fully supported and,
  11253. as such, has known limitations and inefficiencies.
  11254. </OL>
  11255. </DD>
  11256.  
  11257.  
  11258. <DT>Anonymous</DT>
  11259. <DD>This is a unary parameter indicating that the connection be
  11260. established use "public" authentication credentials.
  11261. </DD>
  11262. <DT>Secure</DT>
  11263. <DD>This is a unary parameter indicating that the connection use the
  11264. most secure authentication method mutually supported by Pine and the
  11265. server.  Pine is capable of authenticating connections to 
  11266. the server using several methods.  By default, Pine will attempt each
  11267. method until either a connection is established or the
  11268. list of methods is exhausted.  This parameter causes Pine to fail 
  11269. the connection if the first (generally most "secure") method
  11270. fails.
  11271. </DD>
  11272. <!--chtml if pinemode="os_windows"-->
  11273. <DT>SSL</DT>
  11274. <DD>
  11275. This is a unary parameter indicating communication with the server should 
  11276. take place over a Secure Socket Layer connection.  The server must support
  11277. this method, and be prepared to accept connections on the appropriate
  11278. port.
  11279. </DD>
  11280. <!--chtml endif-->
  11281. <DT>Debug</DT>
  11282. <DD>This is a unary parameter indicating that the connection be established
  11283. in a verbose mode.  Basically, it causes Pine to log the communication with
  11284. the server in Pine's debug file.
  11285. </DD>
  11286. </DL>
  11287. <P>
  11288.  
  11289. Parameters names are <EM>not</EM> case sensitive.
  11290.  
  11291. <P>
  11292. <End of help on this topic>
  11293. </BODY>
  11294. </HTML>
  11295. ======= h_composer_cntxt_path =======
  11296. <HTML>
  11297. <HEAD>
  11298. <TITLE>Collection Path: Explained</TITLE>
  11299. </HEAD>
  11300. <BODY>
  11301. <H1>Collection Edit Help -- Path Field</H1>
  11302.  
  11303. The collection's "Path:" definition indicates the location
  11304. of the folders in this collection.  If the path or any of its components
  11305. do not exist, Pine will prompt you for their creation when exiting the
  11306. Add/Change screen.
  11307.  
  11308. <P> 
  11309. By default the path is interpreted as defining a section of your personal
  11310. folder area.  This area and how you specify it are defined by the
  11311. server, if one is specified in the collection, or, typically, the home
  11312. directory if no server is defined.
  11313.  
  11314. <P>
  11315. To define a collection outside the default "area", prefix
  11316. the path with the "namespace" to use when interpreting the
  11317. given path.  If a namespace is specified, the Path begins with the
  11318. sharp, "#", character followed by the name of the namespace
  11319. and then the namespace's path-element-delimiter.  Aside from the
  11320. path's format, namespaces can also imply access rights, content
  11321. policy, audience, location, and, occasionally, access methods.
  11322.  
  11323. <P>
  11324. Each server exports its own set (possibly of size one) of 
  11325. namespaces.  Hence, it's likely communication with your server's
  11326. administrator will be required for specific configurations.  Some of
  11327. the more common namespaces, however, include:
  11328.  
  11329. <DL>
  11330. <DT>#news.</DT>
  11331. <DD>This specifies a set of folders in the newsgroup namespace.  Newsgroup
  11332. names are hierarchically defined with each level delimited by a period.
  11333. </DD>
  11334. <DT>#public/</DT>
  11335. <DD>This specifies a folder area that the server may export to the general
  11336. public.
  11337. </DD>
  11338. <DT>#shared/</DT>
  11339. <DD>This specifies a folder area that the folder may export to groups
  11340. of users.
  11341. </DD>
  11342. <DT>#ftp/</DT>
  11343. <DD>This specifies a folder area that is the same as that it may have 
  11344. exported via the "File Transfer Protocol".
  11345. </DD>
  11346. <DT>#mh/</DT>
  11347. <DD>This specifies the personal folder area associated with folders
  11348. and directories that were created using the MH message handling system.
  11349. </DD>
  11350. </DL>
  11351. <P>
  11352.  
  11353. In addition, the server may support access to other user's folders,
  11354. provided you have suitable permissions.  Common methods use a prefix
  11355. of either "~<VAR>user</VAR>/", or "/<VAR>user</VAR>/" to
  11356. indicate the root of the other user's folder area.
  11357.  
  11358. <P>
  11359. No, nothing's simple.
  11360.  
  11361. <P>
  11362. <End of help on this topic>
  11363. </BODY>
  11364. </HTML>
  11365. ======= h_composer_cntxt_view =======
  11366. <HTML>
  11367. <HEAD>
  11368. <TITLE>Collection View: Explained</TITLE>
  11369. </HEAD>
  11370. <BODY>
  11371. <H1>Collection Edit Help -- View Field</H1>
  11372.  
  11373. The collection's "View:" definition provides a way to limit
  11374. the displayed list of folders within a collection.  By default, only
  11375. folders that contain the specified characters anywhere in their name
  11376. are shown in the collection's folder list.
  11377.  
  11378. <P>
  11379. Additionally, you can use a wildcard character to better control
  11380. the list of folders selected for display.  The wildcard specifier is
  11381. the star, "*", character.
  11382.  
  11383. <P>
  11384. So, for example, to define a collection of all folders ending with
  11385. "c", you'd specify a view of "*c" (without the
  11386. quote characters!).  Or, similarly, to define a collection of folders
  11387. whose names start with "a" and end with "z", you'd
  11388. specify a view of "a*z".
  11389.  
  11390. <P>
  11391. <End of help on this topic>
  11392. </BODY>
  11393. </HTML>
  11394. ======= h_composer_abook_add_server =======
  11395. <HTML>
  11396. <HEAD>
  11397. <TITLE>Addressbook Server Name Field Explained</TITLE>
  11398. </HEAD>
  11399. <BODY>
  11400. This field should be left blank if the address book is stored in a regular
  11401. file on this system.  If it is a remote address book stored on an IMAP
  11402. server then this is the name of that IMAP server.
  11403. <P>
  11404. Look <A HREF="h_edit_nav_cmds">here</A>
  11405. to see the available Editing and Navigation commands.
  11406. <P>
  11407. <End of help on this topic>
  11408. </BODY>
  11409. </HTML>
  11410. ======= h_composer_abook_add_folder =======
  11411. <HTML>
  11412. <HEAD>
  11413. <TITLE>Addressbook Folder Name Field Explained</TITLE>
  11414. </HEAD>
  11415. <BODY>
  11416. For a remote address book (one for which the Server Name is filled in)
  11417. this is the name of a folder on the remote server. The address book data
  11418. will be stored in this folder. This folder should be used only for
  11419. storing this single address book, not for other address books or for
  11420. other messages.
  11421. <P>
  11422. For a local address book (one for which the Server Name is not filled in)
  11423. this is the name of a file in which the address book will be stored.
  11424. The file is in the same directory as the Pine configuration file.
  11425. <P>
  11426. Look <A HREF="h_edit_nav_cmds">here</A>
  11427. to see the available Editing and Navigation commands.
  11428. <P>
  11429. <End of help on this topic>
  11430. </BODY>
  11431. </HTML>
  11432. ======= h_composer_abook_add_nick =======
  11433. <HTML>
  11434. <HEAD>
  11435. <TITLE>Addressbook NickName Field Explained</TITLE>
  11436. </HEAD>
  11437. <BODY>
  11438. This is just an optional nickname for this address book. If present, it
  11439. is used in some of the displays and error messages in the address book
  11440. maintenance screens. It is for your convenience only and serves no
  11441. other purpose.
  11442. <P>
  11443. Look <A HREF="h_edit_nav_cmds">here</A>
  11444. to see the available Editing and Navigation commands.
  11445. <P>
  11446. <End of help on this topic>
  11447. </BODY>
  11448. </HTML>
  11449. ======= h_composer_qserv_cn =======
  11450. <HTML>
  11451. <HEAD>
  11452. <TITLE>Directory Query Form Explained</TITLE>
  11453. </HEAD>
  11454. <BODY>
  11455.  
  11456. Fill in as many of these fields as you wish to narrow down your
  11457. search. All the fields you fill in must match in order for an entry
  11458. to be returned. You may use the wildcard character "*" in
  11459. any of the fields, it matches any zero or more characters at that
  11460. point in the string. There are no implicit wildcards, so the match is
  11461. exact unless you include wildcards.
  11462. <P>
  11463.  
  11464. Note that if an attribute isn't present at all, then the match will fail.
  11465. For example, if a server doesn't support the Locality attribute, then no
  11466. matter what you put in the Locality field (other than leaving it empty)
  11467. the search will fail.
  11468. <P>
  11469.  
  11470. This field, the Common Name field, is typically a person's full name.
  11471. <P>
  11472.  
  11473. <H1>EDITING and NAVIGATION COMMANDS</H1>
  11474. <!--chtml if pinemode="function_key"-->
  11475. <PRE>
  11476. CURSOR MOTION KEYS----------------------|EDITING KEYS-------------------------
  11477. ^B (Left Arrow)    Back character       | ^D       Delete current character
  11478. ^F (Right Arrow)   Forward character    | ^H (DEL) Delete previous character
  11479. ^P (Up Arrow)      Previous line        |
  11480. ^N (Down Arrow)    Next line            | F9       Cut marked text or
  11481. ^A                 Beginning of line    |            delete current line
  11482. ^E                 End of line          | F10      Undelete line(s)
  11483. F7                 Previous page        |
  11484. F8                 Next page            |-------------------------------------
  11485. ^@ (Ctrl-SPACE)    Next word            | MISCELLANEOUS COMMANDS
  11486. ----------------------------------------|
  11487. EXIT COMMANDS    |  GENERAL COMMANDS    | F5    Restore previous search
  11488. F2   Cancel      |   F1    Get help     |
  11489. F3   Search      |   ^Z    Suspend      | ^L    Redraw Screen
  11490. </PRE>
  11491. <!--chtml else-->
  11492. <PRE>
  11493. CURSOR MOTION KEYS----------------------|EDITING KEYS-------------------------
  11494. ^B (Left Arrow)    Back character       | ^D       Delete current character
  11495. ^F (Right Arrow)   Forward character    | ^H (DEL) Delete previous character
  11496. ^P (Up Arrow)      Previous line        |
  11497. ^N (Down Arrow)    Next line            | ^K       Cut marked text or
  11498. ^A                 Beginning of line    |            delete current line
  11499. ^E                 End of line          | ^U       Undelete line(s)
  11500. ^Y                 Previous page        |
  11501. ^V                 Next page            |-------------------------------------
  11502. ^@ (Ctrl-SPACE)    Next word            | MISCELLANEOUS COMMANDS
  11503. ----------------------------------------|
  11504. EXIT COMMANDS    |  GENERAL COMMANDS    | ^R     Restore previous search
  11505. ^C   Cancel      |   ^G    Get help     |
  11506. ^X   Search      |   ^Z    Suspend      | ^L     Redraw Screen
  11507. </PRE>
  11508. <!--chtml endif-->
  11509. <P><UL>
  11510. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  11511. </UL><P>
  11512. <End of help on this topic>
  11513. </BODY>
  11514. </HTML>
  11515. ======= h_composer_qserv_sn =======
  11516.  
  11517. The Surname is usually the family name of a person.
  11518.  
  11519. <End of help on this topic>
  11520. ======= h_composer_qserv_gn =======
  11521.  
  11522. This is the part of a person's name which isn't the surname or initials.
  11523.  
  11524. <End of help on this topic>
  11525. ======= h_composer_qserv_mail =======
  11526.  
  11527. This is the email address of a person.
  11528.  
  11529. <End of help on this topic>
  11530. ======= h_composer_qserv_org =======
  11531.  
  11532. This is the organization a person belongs to.
  11533.  
  11534. <End of help on this topic>
  11535. ======= h_composer_qserv_unit =======
  11536.  
  11537. This is the organizational unit a person belongs to.
  11538.  
  11539. <End of help on this topic>
  11540. ======= h_composer_qserv_country =======
  11541.  
  11542. This is the country a person belongs to.
  11543.  
  11544. <End of help on this topic>
  11545. ======= h_composer_qserv_state =======
  11546.  
  11547. This is the state a person belongs to.
  11548.  
  11549. <End of help on this topic>
  11550. ======= h_composer_qserv_locality =======
  11551.  
  11552. This is the locality a person belongs to.
  11553.  
  11554. <End of help on this topic>
  11555. ======= h_composer_qserv_custom =======
  11556.  
  11557. This one is for advanced users only! If you put something in this field,
  11558. then the rest of the fields are ignored.
  11559.  
  11560. This field may be set to the string representation of an LDAP search
  11561. filter (see RFC1960). Here are some examples:
  11562.  
  11563. To search for an entry with a surname equal to "clinton" you could set
  11564. the custom filter to:
  11565.  
  11566.      (sn=clinton)
  11567.     
  11568. This is equivalent to putting "clinton" in the SurName field.
  11569. To search for an entry which has a surname which begins with "clint" and
  11570. has a givenname equal to "william" you could use:
  11571.  
  11572.      (&(sn=clint*)(givenname=william))
  11573.     
  11574. This is equivalent to setting the SurName field to "clint*" and the
  11575. GivenName field to "william".
  11576. To search for an entry where either the common name OR the email address
  11577. contains "abcde" you could use:
  11578.  
  11579.      (|(cn=*abcde*)(mail=*abcde*))
  11580.  
  11581. That isn't equivalent to anything you can do by setting the other fields
  11582. because of the OR.
  11583.  
  11584. <End of help on this topic>
  11585. ======= h_composer_qserv_qq =======
  11586.  
  11587. This one is a little different from the rest of the categories.  It causes
  11588. a search to be formed from the configured search filter that you filled
  11589. in when you added the directory server to your configuration. It can also
  11590. be combined with the other fields if you'd like.
  11591.  
  11592. <End of help on this topic>
  11593. ======= h_address_format =======
  11594. <HTML>
  11595. <HEAD>
  11596. <TITLE>INTERNET EMAIL ADDRESS FORMAT</TITLE>
  11597. </HEAD>
  11598. <BODY>
  11599. <H1>INTERNET EMAIL ADDRESS FORMAT</H1>
  11600.  
  11601. A valid email address on the Internet has a username, an "@" sign, 
  11602. and then a domain, with no spaces.  
  11603. For example, jsmith@art.nowhere.edu might be the email address
  11604. of a person  
  11605. with the username "jsmith" who has an account in the domain
  11606. "art.nowhere.edu".  The number of dot-separated segments on the 
  11607. right of the "@" sign can vary - a shorter example would be 
  11608. isabelle@elsewhere.edu (the shortest possible form: here, only the 
  11609. organization's domain is specified after the "@" sign); a longer 
  11610. example would be 
  11611.  jsingh@shakti.edutech.nowhere.edu
  11612. (here, the name of the host "shakti" in the domain 
  11613. edutech.nowhere.edu is also specified).  
  11614. <P>  
  11615. If you do not know the exact email address of someone you want to write 
  11616. to, ask them what it is using other means of communication than email; or 
  11617. use the tools for 
  11618. finding people's addresses that are available on the Internet.  See, 
  11619. for example, the World Wide Web site:
  11620. <P>
  11621. <CENTER><A HREF="http://www.washington.edu/nic/addresses">http://www.washington.edu/nic/addresses</A></CENTER>
  11622. <P>
  11623. If you are sending to someone on the same system as you are, you can leave
  11624. the "@" sign and all the information to its right off of the 
  11625. address, and Pine will fill it in automatically, 
  11626. unless the feature 
  11627. <A HREF="h_config_compose_rejects_unqual">"compose-rejects-unqualified-addrs"</A> is set in SETUP CONFIGURATION.  Sometimes you can also
  11628. abbreviate the right part of the address if you are at the same domain.<P>
  11629.  
  11630. When an email address you send a message to is not reachable -- either because 
  11631. it is simply an incorrect address, or because email can temporarily not be 
  11632. delivered to it due to a technical problem on the way to or at the recipient's 
  11633. end -- you will almost always get an error notification email message back.
  11634. <P>
  11635. If you encounter problems with, or have questions about, email delivery or
  11636. email address syntax, contact your local network computing consultants.
  11637. <P><UL>
  11638. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  11639. </UL>
  11640. <P>
  11641. <End of help on this topic>
  11642. </BODY>
  11643. </HTML>
  11644. ======= h_flag_important =======
  11645. <html>
  11646. <title>STATUS FLAG: Important</title>
  11647. <body>
  11648. <h1>STATUS FLAG: Important</h1>
  11649.  
  11650.  
  11651. The <EM>Important</EM> flag, indicated by an asterisk in Pine's
  11652. MESSAGE INDEX
  11653. screen, can only be set by the user, and is intended to be used in
  11654. whatever fashion makes sense to you.  You are the only one that can set or
  11655. clear it. 
  11656.  
  11657. <P>
  11658. <End of help on this topic>
  11659. </BODY>
  11660. </HTML>
  11661. ======= h_flag_new =======
  11662. <html>
  11663. <title>STATUS FLAG: New</title>
  11664. <body>
  11665. <h1>STATUS FLAG: New</h1>
  11666.  
  11667.  
  11668. The <EM>New</EM> flag, indicated by the letter 'N' in Pine's
  11669. MESSAGE INDEX screen,
  11670. is automatically set when messages are delivered to your Inbox (or other
  11671. folder specified outside of Pine).  Likewise, it is cleared automatically
  11672. the first time you read the message it is associated with.
  11673.  
  11674. <P>
  11675. Sometimes it's helpful in prioritizing your mail.  For example, perhaps
  11676. a message isn't weighty enough to assign it an <A HREF="h_flag_important">Important</A> flag, but
  11677. you'd like to be reminded of it next time you read mail.  This can be done
  11678. easily by <A HREF="h_common_flag">explicitly</A> resetting the <EM>New</EM> flag.
  11679.  
  11680.  
  11681. <P>
  11682. <End of help on this topic>
  11683. </BODY>
  11684. </HTML>
  11685. ======= h_flag_answered =======
  11686. <html>
  11687. <title>STATUS FLAG: Answered</title>
  11688. <body>
  11689. <h1>STATUS FLAG: Answered</h1>
  11690.  
  11691. The <EM>Answered</EM> flag, indicated by the letter 'A' in Pine's
  11692. MESSAGE INDEX
  11693. screen, is automatically set when you reply to a message.  This flag is not
  11694. automatically cleared.
  11695.  
  11696. <P>
  11697. <End of help on this topic>
  11698. </BODY>
  11699. </HTML>
  11700. ======= h_flag_deleted =======
  11701. <html>
  11702. <title>STATUS FLAG: Deleted</title>
  11703. <body>
  11704. <h1>STATUS FLAG: Deleted</h1>
  11705.  
  11706. The <EM>Deleted</EM> flag, indicated by the letter 'D' in Pine's
  11707. MESSAGE INDEX
  11708. screen, is set when you use the ""D Delete" command.
  11709. It is cleared
  11710. when you use the "U Undelete" command.
  11711.  
  11712. <P>
  11713. Messages marked with this flag will be permanently removed from
  11714. the folder when you issue the <A HREF="h_index_cmd_expunge">Expunge</A>
  11715. command, or
  11716. when you indicate acceptance of their removal upon leaving the folder.
  11717.  
  11718. <P>
  11719. Note, there can be other actions implicit in the
  11720. "D Delete" command,
  11721. such as advancing to the next message, that may be momentarily undesirable.
  11722. For this reason, it's sometimes useful to set or clear the <EM>Deleted</EM>
  11723. flag <A HREF="h_common_flag">explicitly</A>.
  11724.  
  11725. <P>
  11726. <End of help on this topic>
  11727. </BODY>
  11728. </HTML>
  11729. ====== h_config_pers_name ======
  11730. <html>
  11731. <title>OPTION: Personal-Name</title>
  11732. <body>
  11733. <h1>OPTION: Personal-Name</h1>
  11734.  
  11735. This value is used to determine the full name part of the "From" address
  11736. on messages you send.
  11737. <!--chtml if pinemode="os_windows"-->
  11738.  PC-Pine requires that this be set in order to properly construct the "From" address.
  11739. <!--chtml else-->
  11740.  If unset, Unix Pine will obtain your full name from
  11741.  the system password file. PC-Pine, on the other hand, requires that this be set.
  11742. <!--chtml endif-->
  11743. <P><UL>
  11744. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  11745. </UL><P>
  11746. <End of help on this topic>
  11747. </BODY>
  11748. </HTML>
  11749. ====== h_config_pruned_folders ======
  11750. <html>
  11751. <header>
  11752. <title>OPTION: Pruned-folders</title>
  11753. </header>
  11754. <body>
  11755. <h1>OPTION: Pruned-folders</h1>
  11756.  
  11757. This variable allows you to define a list of one or more folders that
  11758. Pine will offer to prune for you in the same way it automatically offers
  11759. to prune your "sent-mail" folder each month.<p>
  11760.  
  11761. That is, once a month for each folder listed, Pine will offer to move
  11762. the contents of the folder to a new folder of the same name but with
  11763. the previous month's date appended.  Pine will then look for any such
  11764. date-appended folder names created for a previous month, and offer each
  11765. one it finds for deletion.<p>
  11766.  
  11767. If you decline the first offer, no mail is moved and no new folder is
  11768. created.<p>
  11769.  
  11770. Folders listed are assumed to exist, and the archive folders will be created,
  11771. in the first collection defined by the "folder-collections" variable.<p>
  11772.  
  11773. <UL>   
  11774. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  11775. </UL><P>
  11776. <End of help on this topic>
  11777. </body>
  11778. </html>
  11779. ====== h_config_upload_cmd ======
  11780. <HTML>
  11781. <HEAD>
  11782. <TITLE>OPTION: Upload-command</TITLE>
  11783. </HEAD>
  11784. <BODY>
  11785. <H1>OPTION: Upload-command</H1>
  11786.  
  11787. This option affects the behavior of the Composer's "Read File" 
  11788. (^R in the message body) and "Attach File" (^J in the header) 
  11789. commands.  It specifies
  11790. a Unix program name, and any necessary command line arguments, that Pine can
  11791. use to transfer files from your personal computer into messages that you are
  11792. composing.<P>
  11793.  
  11794. <B>Note:</B> this facility is intended for use with serial line transfer 
  11795. protocols, such as kermit, xmodem, or zmodem.  It is <B>not</B> intended
  11796. to work with TCP/IP file transfer programs such as ftp.<P>
  11797.  
  11798. If a program is specified, the commands listed above are modified to offer a
  11799. subcommand (^Y) to activate the transfer.  Obviously, the Unix program
  11800. specified here must match the transfer program or protocol available on the
  11801. personal computer.<P>
  11802.  
  11803. Pine expects to exchange uploaded data via a file on your Unix system.  When
  11804. the specified upload program finishes, Pine expects the uploaded data to be
  11805. contained in this file.<P>
  11806.  
  11807. When upload is invoked via the "Read File" subcommand, Pine 
  11808. generates a
  11809. temporary file name that it will pass to the specified Unix program.  Pine
  11810. will read the resulting uploaded text from this file and then delete it when
  11811. the upload command is finished.<P>
  11812.  
  11813. When upload is invoked via the "Attach File" subcommand, Pine will 
  11814. prompt
  11815. you for the name of the file that is to contain the uploaded information that
  11816. it is to attach.  Pine will attach this file to the composition, but will
  11817. <B>not</B> delete this file after the upload command is finished.<P>
  11818.  
  11819. The special token "_FILE_" may be included among the Unix program's 
  11820. command
  11821. line arguments.  Pine will replace this symbol with the name of the file
  11822. being used to exchange the uploaded information.  This token allows you to
  11823. position the file name where it is required in the Unix program's command
  11824. line arguments.<P>
  11825.  
  11826. If the "_FILE_" token is not present in the specified command, the
  11827. temporary file's name is automatically appended to the specified Unix
  11828. program.  In other words, you don't need to use "_FILE_" if it is the
  11829. <B>last</B> command line argument.
  11830. <P><UL>
  11831. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  11832. </UL><P>
  11833. <End of help on this topic>
  11834. </BODY>
  11835. </HTML>
  11836. ====== h_config_upload_prefix ======
  11837. <HTML>
  11838. <HEAD>
  11839. <TITLE>OPTION: Upload-command-prefix</TITLE>
  11840. </HEAD>
  11841. <BODY>
  11842. <H1>OPTION: Upload-command-prefix</H1>
  11843.  
  11844. This option is used in conjunction with the Upload-command option.
  11845. It defines text to be written to the terminal emulator (via standard output)
  11846. immediately prior to starting upload command.  This is useful for
  11847. integrated serial line file transfer agents that permit command passing
  11848. (e.g., Kermit's APC method).<P>
  11849.  
  11850. The special token "_FILE_" may be included in the string specification.
  11851. That symbol will be replaced with the (Pine-created) name of the temporary
  11852. file in which Pine will expect to find the uploaded file.
  11853. <P><UL>
  11854. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  11855. </UL><P>
  11856. <End of help on this topic>
  11857. </BODY>
  11858. </HTML>
  11859. ====== h_config_download_cmd ======
  11860. <HTML>
  11861. <HEAD>
  11862. <TITLE>OPTION: Download-command</TITLE>
  11863. </HEAD>
  11864. <BODY>
  11865. <H1>OPTION: Download-command</H1>
  11866.  
  11867. This option affects the behavior of the Export command.  It specifies a Unix
  11868. program name, and any necessary command line arguments, that Pine can use to
  11869. transfer the exported message to your personal computer's disk.<P>
  11870. Note: this facility is intended for use with serial line transfer 
  11871. protocols, such as kermit, xmodem, or zmodem.  It is <B>not</B> intended
  11872. to work with TCP/IP file transfer programs such as ftp.<P>
  11873. If a program is specified, the Export command is modified to offer a
  11874. subcommand (^V) to activate the transfer (in lieu of saving it to
  11875.  the machine where Pine is running).  Obviously, the Unix program
  11876. specified here must match the transfer program or protocol available on the
  11877. personal computer.<P>
  11878.  
  11879. When this subcommand is selected and before Pine invokes the specified Unix
  11880. program, Pine will create a temporary file containing the text of the
  11881. exported message.  Pine uses this file to pass the exported message text to
  11882. the specified Unix program.<P>
  11883.  
  11884. The special token "_FILE_" may be included among the Unix program's command
  11885. line arguments.  Pine will replace this symbol with the temporary file's name
  11886. before executing the Unix program.  This token allows you to position the
  11887. file name where it is required in the Unix program's command line arguments.
  11888. <P>
  11889. If the "_FILE_" token is not present in the specified command, the
  11890. temporary file's name is automatically appended to the specified Unix
  11891. program.  In other words, you don't need to use "_FILE_" if it is the
  11892. <B>last</B> command line argument.
  11893. <P><UL>
  11894. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  11895. </UL><P>
  11896. <End of help on this topic>
  11897. </BODY>
  11898. </HTML>
  11899. ====== h_config_download_prefix ======
  11900. <HTML>
  11901. <HEAD>
  11902. <TITLE>OPTION: Download-command-prefix</TITLE>
  11903. </HEAD>
  11904. <BODY>
  11905. <H1>OPTION: Download-command-prefix</H1>
  11906.  
  11907. This option is used in conjunction with the Download-command option.
  11908. It defines text to be written to the terminal emulator (via standard output)
  11909. immediately prior to starting the download command.  This is useful for
  11910. integrated serial line file transfer agents that permit command passing
  11911. (e.g., Kermit's APC method).
  11912. <P>
  11913. The special token "_FILE_" may be included in the string 
  11914. specification.
  11915. That symbol will be replaced with the (Pine-created) name of the temporary
  11916. file into which Pine will place the message to be downloaded.
  11917. <P><UL>
  11918. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  11919. </UL><P>
  11920. <End of help on this topic>
  11921. </BODY>
  11922. </HTML>
  11923. ====== h_config_mailcap_path ======
  11924. <HTML>
  11925. <HEAD>
  11926. <TITLE>OPTION: mailcap-search-path</TITLE>
  11927. </HEAD>
  11928. <BODY>
  11929. <H1>OPTION: mailcap-search-path</H1>
  11930. This variable is used to replace Pine's default mailcap file search path.
  11931. It takes one or more file names (full paths must be specified) in which to
  11932. look for mail capability data.  The default search path can be found in the
  11933. <A HREF="h_news">release notes</A> (accessible via the "R" command 
  11934. from the main menu).
  11935. If there is more than one file name listed, list members should be delimited
  11936. by 
  11937. <!--chtml if pinemode="os_windows"-->
  11938. a semi-colon (;) under Windows; for example:<PRE>
  11939.         C:\MYCONFIG\MAILCAP.TXT;H:\NETCONFIG\MAILCAP.TXT
  11940. </PRE>
  11941. <!--chtml else-->
  11942. a colon (:) under UNIX; for example:<PRE>
  11943.         ~/.mailcap:/etc/mailcap:/usr/etc/mailcap:/usr/local/etc/mailcap
  11944. </PRE>
  11945. <!--chtml endif-->
  11946. <P><UL>
  11947. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  11948. </UL>
  11949. <P>
  11950. <End of help on this topic>
  11951. </BODY>
  11952. </HTML>
  11953. ====== h_config_mimetype_path ======
  11954.         OPTION: mimetype-search-path
  11955.  
  11956. This variable is used to replace Pine's default mime.types file search path.
  11957. It takes one or more file names (full paths must be specified) in which to
  11958. look for file-name-extension to MIME type mapping data.  The default search
  11959. path can be found in the release notes ("R" command off the main menu).
  11960.  
  11961. If there is more than one file name listed, list members should be delimited
  11962. by a colon (:) under UNIX and a semi-colon (;) under Windows.
  11963.  
  11964. <End of help on this topic>
  11965. ====== h_config_set_att_ansi ======
  11966.         OPTION: Set printer to attached ansi printer
  11967.  
  11968. Type "S" to set your printer to "attached-to-ansi".
  11969. It is OK to include "attached-to-ansi" in your personal list below.
  11970.  
  11971. <End of help on this topic>
  11972. ====== h_config_set_att_ansi2 ======
  11973.         OPTION: Set printer to attached ansi printer (no formfeed)
  11974.  
  11975. Type "S" to set your printer to "attached-to-ansi-no-formfeed".
  11976. It is OK to include "attached-to-ansi-no-formfeed" in your personal
  11977. list below.
  11978.  
  11979. This is the same as the "attached-to-ansi" option except that a
  11980. formfeed character will not be appended to the end of the print job.
  11981. If your printer already ejects the paper by itself at the end of the
  11982. job, you may prefer the "no-formfeed" form of this printer so that you
  11983. don't get an extra blank page between print jobs.
  11984.  
  11985. <End of help on this topic>
  11986. ====== h_config_set_stand_print ======
  11987.         OPTION: Set default printer
  11988.  
  11989. Move to the printer you want and type "S" to set it to be your
  11990. default printer.  This list is not modifiable by you and has been
  11991. set up by the system administrators.  If there is more than one printer
  11992. listed in the Command List, you will be able to cycle through that
  11993. whole list at the time you print, starting with your default.
  11994. It is OK to include entries from this Standard list in your personal
  11995. list below.
  11996.  
  11997. <End of help on this topic>
  11998. ====== h_config_set_custom_print ======
  11999.         OPTION: Set default printer
  12000.  
  12001. You may add as many print commands as you want to your personal list.
  12002. Specify one of them as your default printer by moving to the printer
  12003. you want and typing "S".  If there is more than one printer listed
  12004. in the Command List, you will be able to cycle through that list at
  12005. the time you print, starting with your default.  It is OK to include
  12006. entries from the Standard list above or to include the command
  12007. "attached-to-ansi" or "attached-to-ansi-no-formfeed" as one of the
  12008. entries here.
  12009.  
  12010. <End of help on this topic>
  12011. ====== h_config_user_id =====
  12012. <html>
  12013. <head>
  12014. <title>OPTION: User-Identification</title>
  12015. </head>
  12016. <body>
  12017. <h1>OPTION: User-Identification</h1>
  12018. This value is used as part of the "From" address on messages you send.
  12019. It is also the default login name for remote IMAP server access.  Set this
  12020. to the username part you want to appear on outgoing email.
  12021.  
  12022. <UL>   
  12023. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  12024. </UL><P>
  12025. <End of help on this topic>
  12026. </body>
  12027. </html>
  12028. ====== h_config_user_dom =====
  12029. <HTML>
  12030. <HEAD>
  12031. <TITLE>OPTION: User-Domain</TITLE>
  12032. </HEAD>
  12033. <BODY>
  12034. <H1>OPTION: User-Domain</H1>
  12035. This value specifies the domain part (right-hand side) of your return
  12036. address on outgoing email and is also used as the default domain for email
  12037. composed to a local user.
  12038. <!--chtml if pinemode="os_windows"-->
  12039.  This value is required for PC-Pine. If you are unsure as to what this should be,
  12040.  contact your local help desk, system administrator, or Internet Service Provider.
  12041. <!--chtml else-->
  12042.  If unset, Unix Pine will obtain the domain from
  12043.  the system.  Often this value will be set for your whole site by the
  12044.  system administrator.<P>
  12045. <!--chtml endif-->
  12046. If you set this, see also the <A HREF="h_config_quell_local_lookup">
  12047. "quell-user-lookup-in-passwd-file"</A> feature.
  12048. <P><UL>
  12049. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  12050. </UL><P>
  12051. <End of help on this topic>
  12052. </BODY>
  12053. </HTML>
  12054. ====== h_config_smtp_server =====
  12055. <HTML>
  12056. <HEAD>
  12057. <TITLE>OPTION: SMTP-Server</TITLE>
  12058. </HEAD>
  12059. <BODY>
  12060. <H1>OPTION: SMTP-Server</H1>
  12061. This value specifies the name of one or more SMTP 
  12062. (Simple Mail Transfer Protocol) servers for sending mail. 
  12063. <!--chtml if pinemode="os_windows"-->
  12064. You must have an SMTP server for use with PC-Pine.  SMTP servers are
  12065. normally set up by a system administrator for use by all members of a given
  12066. campus or department.  Contact your local help desk to ask what SMTP
  12067. servers you should use.  
  12068. <P><UL>
  12069. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  12070. </UL>
  12071. <!--chtml else-->
  12072. Unix Pine users do not need to use an SMTP server
  12073. and can leave this blank.
  12074. <!--chtml endif-->
  12075. <P>
  12076. <End of help on this topic>
  12077. </BODY>
  12078. </HTML>
  12079. ====== h_config_nntp_server =====
  12080. <HTML>
  12081. <HEAD>
  12082. <TITLE>OPTION: NNTP-Server</TITLE></HEAD>
  12083. <BODY>
  12084. <H1>OPTION: NNTP-Server</H1>
  12085.  
  12086. This value specifies the name of the NNTP (Network News Transfer Protocol)
  12087. server for reading and posting USENET news.  NNTP servers are normally
  12088. set up by a system administrator for use by all members of a given campus
  12089. or department.  Contact your local help desk to ask what NNTP servers you
  12090. should use.  
  12091. <!--chtml if pinemode="os_windows"--><!--chtml else-->
  12092. Often Unix Pine users will find that this variable has been
  12093. set for the whole system (and they don't have to worry about it).  
  12094. <!--chtml endif-->
  12095. When you
  12096. define an NNTP server here, Pine implicitly defines a news collection for
  12097. you, assuming that server as the news server and assuming that you will
  12098. use the NNTP protocol and a local newsrc configuration file for reading
  12099. news.  For more about reading news with Pine, see the 
  12100. <A HREF="h_news">release notes</A>.
  12101. <P><UL>
  12102. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  12103. </UL><P>
  12104. <End of help on this topic>
  12105. </BODY>
  12106. </HTML>
  12107. ====== h_config_inbox_path =====
  12108. <HTML>
  12109. <HEAD>
  12110. <TITLE>OPTION: Inbox-Path</TITLE>
  12111. </HEAD>
  12112. <BODY>
  12113. <H1>OPTION: Inbox-Path</H1>
  12114.  
  12115. This value overrides the default value of your INBOX name/path/location.
  12116. <!--chtml if pinemode="os_windows"-->
  12117. PC-Pine users must specify an inbox path and it must be a folder on an
  12118. IMAP server.  
  12119. <!--chtml else-->
  12120. Unix and VMS Pine users will often find that this variable
  12121. has been pre-configured by your system administrator.  
  12122. <!--chtml endif-->
  12123. You may be able to specify an alternate INBOX which is either a local folder 
  12124. or a folder on an IMAP server.
  12125. <P>
  12126. A typical remote inbox-path entry would be: {monet.art.nowhere.edu}INBOX
  12127. where "monet.art.nowhere.edu" is replaced by the name of your IMAP
  12128. mail server.
  12129. <P>
  12130. See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
  12131. details on the syntax of folder definitions.
  12132. <P><UL>
  12133. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  12134. </UL><P>
  12135. <End of help on this topic>
  12136. </BODY>
  12137. </HTML>
  12138. ====== h_config_default_fcc =====
  12139. <HTML>
  12140. <HEAD>
  12141. <TITLE>OPTION: Default-FCC (File Carbon Copy)</TITLE>
  12142. </HEAD>
  12143. <BODY>
  12144. <H1>OPTION: Default-FCC (File Carbon Copy)</H1>
  12145.  
  12146. This value specifies where a copy of outgoing mail should be saved.  If
  12147. this is not a path name, it will be in the default collection for saves.
  12148. Any valid folder specification, local or IMAP, is allowed.  This default
  12149. folder carbon copy only applies when the 
  12150. <A HREF="h_config_fcc_rule">"fcc-name-rule"</A> 
  12151. is set to use the default folder.  
  12152. <!--chtml if pinemode="os_windows"-->
  12153. PC-Pine default is "SENTMAIL" (normally stored as SENTMAIL.MTX)
  12154. <!--chtml else-->
  12155. Unix Pine default
  12156. is normally "sent-mail" in the default folder collection. 
  12157. <!--chtml endif-->
  12158. <P>
  12159. If you access your email through an IMAP server, especially if you often switch between Un$
  12160. and PC-Pine, or between various desktop email systems, you may want to set this to a folde$
  12161. IMAP server (remember that in order to later access this remote folder through Pine, it
  12162. must be in a folder collection. See <A HREF="h_what_are_collections">Folder Collections Explained</a>
  12163. for more information). An example:<p>
  12164. <CENTER><SAMP>{monet.art.nowhere.edu}mail/sent-mail</SAMP></CENTER>
  12165. <P>
  12166. To suppress saving of outgoing mail, set: default-fcc=""
  12167. <P>
  12168. See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
  12169. details on the syntax of folder definitions.
  12170. <P>
  12171. <UL>   
  12172. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  12173. </UL><P>
  12174. <End of help on this topic>
  12175. </BODY>
  12176. </HTML>
  12177. ====== h_config_def_save_folder =====
  12178. <HTML>
  12179. <HEAD>
  12180. <TITLE>OPTION: Default-Saved-Msg-Folder</TITLE>
  12181. </HEAD>
  12182. <BODY>
  12183. <H1>OPTION: Default-Saved-Msg-Folder</H1>
  12184.  
  12185. This option determines the default folder name for save-message operations 
  12186. ("saves").
  12187. <P>
  12188. If this is not a path name, it will be in the default collection for saves.
  12189. Any valid folder specification, local or IMAP, is allowed.  This default
  12190. folder only applies when the <A HREF="h_config_saved_msg_name_rule">"
  12191. saved-msg-name-rule"</A> doesn't override it.  
  12192. <!--chtml if pinemode="os_windows"-->
  12193. PC-Pine default is "SAVEMAIL" (normally stored as SAVEMAIL.MTX).
  12194. <!--chtml else-->
  12195. Unix Pine default
  12196. is normally "saved-messages" in the default folder collection.
  12197. <!--chtml endif-->
  12198. If you access your email through an IMAP server, especially if you often switch between Un$
  12199. and PC-Pine, or between various desktop email systems, you may want to set this to a folde$
  12200. IMAP server (remember that in order to later access this remote folder through Pine, it
  12201. must be in a folder collection. See <A HREF="h_what_are_collections">Folder Collections Explained</a>
  12202. for more information). An example:<p>
  12203. <CENTER><SAMP>{monet.art.nowhere.edu}mail/saved-messages</SAMP></CENTER>
  12204. <P>
  12205. See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
  12206. details on the syntax of folder definitions.
  12207. <P>
  12208. <UL>   
  12209. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  12210. </UL><P>
  12211. <End of help on this topic>
  12212. </BODY>
  12213. </HTML>
  12214. ====== h_config_postponed_folder =====
  12215. <HTML>
  12216. <HEAD>
  12217. <TITLE>OPTION: Postponed-Folder</TITLE>
  12218. </HEAD>
  12219. <BODY>
  12220. <H1>OPTION: Postponed-Folder</H1>
  12221. This value overrides the default name for the folder where postponed
  12222. messages are saved.  If this is not a path name, it will be in the default
  12223. collection for message Saves.  Any valid folder specification, local or
  12224. remote, is allowed. 
  12225. PC-Pine default
  12226. is "POSTPOND" (stored as POSTPOND.MTX).
  12227. The Unix Pine default is normally "postponed-msgs"
  12228. in the default collection. 
  12229. <P>
  12230. Tip: If you are using different installations of (PC-)Pine -- for example, PC-Pine on your personal
  12231. computer at home, and Unix Pine on campus -- you can postpone a composition begun with one Pine and
  12232. resume it later with the other if you set this option to the <B>same folder on the same IMAP host</B>
  12233. in all Pine copies you use. 
  12234. (Remember that in order to later access this remote folder through Pine, it must be in a folder
  12235. collection. See <A HREF="h_what_are_collections">Folder Collections Extensions Explained</a>
  12236. for more information). An
  12237. example:<p> 
  12238. <CENTER><SAMP>{monet.art.nowhere.edu}mail/postponed-msgs</SAMP></CENTER>
  12239. <P>
  12240. See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
  12241. details on the syntax of folder definitions.
  12242. <P>
  12243. <UL>   
  12244. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  12245. </UL><P>
  12246. <End of help on this topic>
  12247. </BODY>
  12248. </HTML>
  12249. ====== h_config_read_message_folder =====
  12250. <HTML>
  12251. <HEAD>
  12252. <TITLE>OPTION: Read-Message-Folder</TITLE>
  12253. </HEAD>
  12254. <BODY>
  12255. <H1>OPTION: Read-Message-Folder</H1>
  12256.  
  12257. By virtue of specifying a folder name here, Pine will be configured to
  12258. save all messages which you have read during a session into the designated
  12259. "read messages" folder.  This allows you to more easily distinguish
  12260. between your really new email (in your INBOX) and those which you have
  12261. already read.  Depending on how you define the 
  12262. <A HREF="h_config_auto_read_msgs">"auto-move-read-messages"</A>
  12263. setting, you may or may not be asked when you quit
  12264. Pine if you want read messages to be moved to this folder.  In either
  12265. case, moving the messages means they will be deleted from your INBOX.
  12266. <P>
  12267. If this is not a path name, it will be in the default collection for
  12268. saves.  Any valid folder specification, local or remote (via IMAP), is
  12269. allowed.  There is no default for the name of the read message folder.
  12270. <P>
  12271. See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
  12272. details on the syntax of folder definitions.
  12273. <P>
  12274. <UL>   
  12275. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  12276. </UL><P>
  12277. <End of help on this topic>
  12278. </BODY>
  12279. </HTML>
  12280. ====== h_config_form_folder =====
  12281. <HTML>
  12282. <HEAD>
  12283. <TITLE>OPTION: Form-Letter-Folder</TITLE>
  12284. </HEAD>
  12285. <BODY>
  12286. <H1>OPTION: Form-Letter-Folder</H1>
  12287.  
  12288. A "Form-Letter-Folder" is a mail folder that is intended to
  12289. contain messages that you have composed and that are intended to be
  12290. sent in their original form repeatedly.
  12291.  
  12292. <P>
  12293. Setting this variable will alter Pine's usual behavior when you
  12294. execute the Compose command.  Normally, Pine offers a chance to
  12295. continue a postponed or interrupted message should one or the other
  12296. exist.  When this variable is set to a folder name that exists, Pine
  12297. will also offer the chance to select a message from the folder to
  12298. insert into the composer (much like when continuing a postponed message).
  12299. The difference, however, is that Pine will not automatically delete
  12300. the selected message from the Form Letter Folder.
  12301. <P>
  12302. Setting this variable will also affect Pine's behavior when you
  12303. Postpone a message from the composer.  Normally, Pine simply stashes
  12304. the message away in your
  12305. "<A HREF="h_config_postponed_folder">Postponed-Folder</A>".
  12306. Regardless of the specified folder's existence, Pine will ask which
  12307. folder you intend the message to be stored in.  Choose the
  12308. "F" option to store the message in your Form Letter Folder.
  12309. This is the most common way to add a message to the folder.
  12310.  
  12311. <P>
  12312. Another method of adding messages to the folder is via the Pine
  12313. composer's <SAMP>Fcc:</SAMP> field.  If you are sending a message that
  12314. you expect to send in the same form again, you can enter the Form
  12315. Letter Folder's name in this field.  Pine, as usual, will copy the
  12316. message as it's sent.  Note, when you later select this message from 
  12317. your Form Letter Folder, it will have the same recipients as the original
  12318. message.
  12319.  
  12320. <P>
  12321. To delete a message from the Form Letter Folder, you can either select
  12322. the folder from a suitable FOLDER LIST screen, or use the Delete
  12323. command in the MESSAGE INDEX offered when selecting from the folder as
  12324. part of the Compose command.  You can delete a Form Letter Folder just
  12325. as any other folder from a suitable FOLDER LIST screen.
  12326.  
  12327. <P>
  12328. You may find that the <A HREF="h_rules_roles">"Roles"</A>
  12329. facility introduced in Pine 4.10 can be used
  12330. to replace the Form Letter Folder.
  12331.  
  12332. <P>
  12333. See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
  12334. details on the syntax of folder definitions.
  12335.  
  12336. <P>
  12337. <UL>   
  12338. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  12339. </UL><P>
  12340. <End of help on this topic>
  12341. </BODY>
  12342. </HTML>
  12343. ====== h_config_archived_folders =====
  12344. <HTML>
  12345. <HEAD>
  12346. <TITLE>OPTION: Incoming-Archive-Folders</TITLE>
  12347. </HEAD>
  12348. <BODY>
  12349. <H1>OPTION: Incoming-Archive-Folders</H1>
  12350.  
  12351. This is like
  12352. <A HREF="h_config_read_message_folder">Read-Message-Folder</A>,
  12353. only more general.  You may archive
  12354. any of the folders in your incoming collection.  This is a list of folder
  12355. pairs, with the first separated from the second in the pair by a space.
  12356. The first folder in a pair is the folder you want to archive, and the
  12357. second folder is the folder that read messages from the first should be
  12358. moved to.  Depending on how you define the
  12359. <A HREF="h_config_auto_read_msgs">"auto-move-read-messages"</A>
  12360. setting, you may or may not be asked when you
  12361. leave the first folder if you want read messages to be moved to the
  12362. second folder.  In either case, moving the messages means they will be
  12363. deleted from the first folder.
  12364. <P>
  12365. The name of the first folder in each pair can be either the technical
  12366. specification of the folder (like what appears in your configuration file)
  12367. or (much easier) the nickname that you gave the folder when you made it
  12368. an incoming folder.
  12369. <p>
  12370. For example:<p>
  12371. <CENTER><SAMP>{monet.art.nowhere.edu}inbox {monet.art.nowhere.edu}mail/inbox-archive</SAMP></CENTER>
  12372. <p>or, using nicknames:<p>
  12373. <CENTER><SAMP>inbox inbox-archive</SAMP></CENTER>
  12374. <P>
  12375. If these are not path names, they will be in the default collection for
  12376. saves. Any valid folder specification, local or remote (via IMAP), is
  12377. allowed. There is no default.
  12378. <P>
  12379. See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
  12380. details on the syntax of folder definitions.
  12381. <P>
  12382. <UL>   
  12383. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  12384. </UL><P>
  12385. <End of help on this topic>
  12386. </BODY>
  12387. </HTML>
  12388. ====== h_config_newsrc_path ======
  12389. <HTML>
  12390. <HEAD>
  12391. <TITLE>OPTION: newsrc-path</TITLE>
  12392. </HEAD>
  12393. <BODY>
  12394. <H1>OPTION: newsrc-path</H1>
  12395.  
  12396. This option overrides the default name Pine uses for your "newsrc" news
  12397. status and subscription file.  If set, Pine will take this value as the
  12398. full pathname for the desired newsrc file.<P>
  12399.  
  12400. If this option is <B>not</B> set, 
  12401. <!--chtml if pinemode="os_windows"-->
  12402. PC-Pine looks first for $HOME\NEWSRC (where $HOME defaults to the root
  12403. of the current drive, e.g. "C:\") and then it looks in the same
  12404. directory as your pinerc file for NEWSRC.
  12405. <!--chtml else-->
  12406. Unix Pine looks for the file ~/.newsrc (that is, the file named .newsrc in 
  12407. your account's home directory).
  12408. <!--chtml endif-->
  12409. <P><UL>
  12410. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  12411. </UL>
  12412. <P>
  12413. <End of help on this topic>
  12414. </BODY>
  12415. </HTML>
  12416. ====== h_config_signature_file =====
  12417. <HTML>
  12418. <HEAD>
  12419. <TITLE>OPTION: signature-file</TITLE>
  12420. </HEAD>
  12421. <BODY>
  12422. <H1>OPTION: signature-file</H1>
  12423.  
  12424. This is the name of a file which will be automatically inserted into
  12425. outgoing messages.
  12426. It typically contains information such as your
  12427. name, email address and organizational affiliation.
  12428. Pine adds the
  12429. signature into the message as soon as you enter the composer so you
  12430. can choose to remove it or edit it on a message by message basis.
  12431. Signature file placement in message replies is controlled by the
  12432. "<A HREF="h_config_sig_at_bottom">signature-at-bottom</A>"
  12433. setting in the feature list.
  12434. <P>
  12435.  
  12436. The default file name is
  12437. <!--chtml if pinemode="os_windows"-->
  12438. "PINE.SIG" in the same directory as your PINERC file.
  12439. <!--chtml else-->
  12440. ".signature".
  12441. <!--chtml endif-->
  12442. The signature file must be kept on the local system, not a remote
  12443. IMAP server.
  12444. <P>
  12445.  
  12446. To create or edit your signature file choose Setup from the Main Menu
  12447. and then select S for Signature (Main/Setup/Signature).
  12448. This puts you
  12449. into the Signature Editor where you can enter a <EM>few</EM> lines of
  12450. text containing your identity and affiliation.
  12451.  
  12452. <P>
  12453. If the filename is followed by a vertical bar (|) then instead
  12454. of reading the contents of the file the file is assumed to be a
  12455. program which will produce the text to be used on its standard output.
  12456. The program can't have any arguments and doesn't receive any input from Pine,
  12457. but the rest of the processing works as if the contents came from a file.
  12458.  
  12459. <P>
  12460. Besides regular text, the signature file may also contain
  12461. (or a signature program may produce) tokens which
  12462. are replaced with text which usually depends on the message you are replying
  12463. to or forwarding.
  12464. For example, if the signature file contains the token
  12465. <P>
  12466. <CENTER><SAMP>_DATE_</SAMP></CENTER>
  12467. <P>
  12468. anywhere in the text, then that token is replaced by the date
  12469. the message you are replying to or forwarding was sent.
  12470. If it contains
  12471. <P>
  12472. <CENTER><SAMP>_CURDATE_</SAMP></CENTER>
  12473. <P>
  12474. that is replaced with the current date.
  12475. The first is an example of a token which depends on the message you
  12476. are replying to (or forwarding) and the second is an example which
  12477. doesn't depend on anything other than the current date.
  12478. You have to be a little careful with this facility since tokens which
  12479. depend on the message you are replying to or forwarding will be replaced
  12480. by nothing in the case where you are composing a new message from scratch.
  12481. The use of <A HREF="h_rules_roles">"roles"</A> may help you
  12482. in this respect.
  12483. It allows you to use different signature files in different cases.
  12484. <P>
  12485.  
  12486. The list of tokens available for use in the signature file is
  12487. <A HREF="h_index_tokens">here</A>.
  12488. <P>
  12489.  
  12490. Instead of, or along with the use of "roles" to give you
  12491. different signature files in different situations, there is also
  12492. a way to conditionally include text based
  12493. on whether or not a token would result in specific replacement text.
  12494. For example, you could include some text based on whether or not
  12495. the _NEWS_ token would result in any newsgroups if it was used.
  12496. This is explained in detail
  12497. <A HREF="h_reply_token_conditionals">here</A>.
  12498. This isn't for the faint of heart.
  12499. <P>
  12500. In the very unlikely event that you want to include a literal token
  12501. in the signature you must precede it with a backslash character.
  12502. For example,
  12503. <P>
  12504. <CENTER><SAMP>\_DAYDATE_ = _DAYDATE_</SAMP></CENTER>
  12505. <P>
  12506. would produce something like
  12507. <P>
  12508. <CENTER><SAMP>_DAYDATE_ = Sat, 24 Oct 1998</SAMP></CENTER>
  12509. <P>
  12510. It is not possible to have a literal backslash followed by an expanded token.
  12511. <P>
  12512. <UL>   
  12513. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  12514. </UL><P>
  12515. <End of help on this topic>
  12516. </BODY>
  12517. </HTML>
  12518. ====== h_config_init_cmd_list =====
  12519. <html>
  12520. <header>
  12521. <title>OPTION: Initial-Keystroke-List</title>
  12522. </header>
  12523. <body
  12524. <h1>OPTION: Initial-Keystroke-List</h1>
  12525.  
  12526. The initial keystroke--or command--list option lets you start Pine at
  12527. any place you like.  Whatever keystrokes you specify here will be executed
  12528. by Pine upon startup as a macro.  The words SPACE, TAB, DOWN, UP, LEFT, and
  12529. RIGHT indicate the pressing of those keys.  CR indicates the pressing of
  12530. the RETURN key.  F1 through F12 represent the function keys, and ^ followed
  12531. by a character indicates that key pressed along with the control key (in
  12532. other words, ^P means Ctrl-P).  A string delimited by double-quotes (")
  12533. will be expanded into the individual keystrokes (excluding the double-quote 
  12534. characters).  For example, to view message 1 on startup, you would specify 
  12535. i,j,1,CR,v.<p>
  12536.  
  12537. Restrictions: You cannot pre-type into the composer with the initial
  12538. keystroke list, and you cannot mix function key commands with letter
  12539. commands.<p>
  12540.  
  12541. <UL>   
  12542. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  12543. </UL><P>
  12544. <End of help on this topic>
  12545. </body>
  12546. </html>
  12547. ====== h_config_comp_hdrs =====
  12548. <html>
  12549. <header>
  12550. <title>OPTION: Default-Composer-Headers</title>
  12551. </header>
  12552. <body>
  12553. <h1>OPTION: Default-Composer-Headers</h1>
  12554.  
  12555. You can decide which headers you want visible when composing outgoing
  12556. email using this option.  You can specify any of the regular set, any rich
  12557. header or any custom header which you have already defined.  If you use
  12558. this setting at all, you must specify all the headers you want to see, you
  12559. can't just add to the regular header set.  The default set is To:, Cc:,
  12560. Attchmnt:, and Subject:.<p>
  12561.  
  12562. Note that the "Newsgroups:" header will be abbreviated in the Composer
  12563. display, but should be spelled out in full here.<p>
  12564. <UL>   
  12565. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  12566. </UL><P>
  12567. <End of help on this topic>
  12568. </body>
  12569. </html>
  12570. ====== h_config_custom_hdrs =====
  12571. <HTML>
  12572. <HEAD>
  12573. <TITLE>OPTION: Customized-Headers</TITLE>
  12574. </HEAD>
  12575. <BODY>
  12576. <H1>OPTION: Customized-Headers</H1>
  12577.  
  12578. You may add your own custom headers to all outgoing messages.  Each header
  12579. you specify here must include the header tag 
  12580. (<A HREF="h_composer_reply_to">Reply-To:</A>, Approved:, etc.)
  12581. and may optionally include a value for that header.  If you want to see
  12582. these custom headers each time you compose a message, you must add them to
  12583. your <A HREF="h_config_comp_hdrs">default composer headers</A> list, 
  12584. otherwise they become part
  12585. of the rich header set which you only see when you press the rich header
  12586. <!--chtml if pinemode="function_key"-->(F5)
  12587. <!--chtml else-->(Ctrl-R)<!--chtml endif--> command.
  12588. Here's an example which shows how you might set your Reply-To address.
  12589. <P>
  12590. <CENTER><SAMP>Reply-To: Full Name <user@domain></SAMP></CENTER>
  12591. <P>
  12592. or just
  12593. <P>
  12594. <CENTER><SAMP>Reply-To: user@domain</SAMP></CENTER>
  12595. <P>
  12596. <P><UL>
  12597. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  12598. </UL>
  12599. <P>
  12600. <End of help on this topic>
  12601. </BODY>
  12602. </HTML>
  12603. ====== h_config_viewer_headers =====
  12604. <HTML>
  12605. <HEAD>
  12606. <TITLE>OPTION: Viewer-Headers</TITLE>
  12607. </HEAD>
  12608. <BODY>
  12609. <H1>OPTION: Viewer-Headers</H1>
  12610.  
  12611. You may change the default list of headers that are viewed by listing
  12612. the headers you want to view here.  If the headers in your
  12613. "viewer-hdrs" list are present in the message, then they
  12614. will be shown.  The order of the headers you list will be honored.  If
  12615. the special value "all-except" is included as the first
  12616. header in the "viewer-hdrs" list, then all headers in the
  12617. message except those in the list will be shown.  The values are all
  12618. case insensitive.
  12619.  
  12620. <P>
  12621. Note that once you put anything in the "viewer-hdrs" list,
  12622. then the original default headers are ignored.  So, if you just wanted
  12623. to add the header Organization to the list, you would have to list
  12624. Organization plus all of the other headers originally in the default
  12625. list.  If you just included Organization and nothing else, then you
  12626. would see only the Organization header, nothing else.
  12627.  
  12628. <P>
  12629. The default list of headers includes:
  12630. <UL>
  12631.   <LI>From
  12632.   <LI>Resent-From
  12633.   <LI>To
  12634.   <LI>Resent-To
  12635.   <LI>Cc
  12636.   <LI>Resent-cc
  12637.   <LI>Bcc
  12638.   <LI>Newsgroups
  12639.   <LI>Followup-To
  12640.   <LI>Date
  12641.   <LI>Resent-Date
  12642.   <LI>Subject
  12643.   <LI>Resent-Subject
  12644.   <LI>Reply-To
  12645. </UL>
  12646.  
  12647. <P>
  12648. <UL>   
  12649. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  12650. </UL><P>
  12651. <End of help on this topic>
  12652. </BODY>
  12653. </HTML>
  12654. ====== h_config_saved_msg_name_rule =====
  12655. <HTML>
  12656. <HEAD>
  12657. <TITLE>OPTION: Saved-Msg-Name-Rule</TITLE>
  12658. </HEAD>
  12659. <BODY>
  12660. <H1>OPTION: Saved-Msg-Name-Rule</H1>
  12661.  
  12662. This option determines the default folder name when saving (i.e. using
  12663. the Save option) a message.  Choose one of the following:
  12664. default-folder, last-folder-used, by-from, by-sender, by-recipient,
  12665. by-nick-of-from, by-nick-of-sender, by-nick-of-recip, by-fcc-of-from,  
  12666. by-fcc-of-sender, by-fcc-of-recip, by-nick-of-from-then-from,
  12667. by-nick-of-sender-then-sender, by-nick-of-recip-then-recip,
  12668. by-fcc-of-from-then-from,  by-fcc-of-sender-then-sender,
  12669. or by-fcc-of-recip-then-recip.
  12670.  
  12671. <P>
  12672. The default option is "default-folder", which is the folder
  12673. called "saved-messages" in Unix Pine and
  12674. "savemail" in PC-Pine.  To change the default folder, modify
  12675. the variable called "default-saved-msg-folder".
  12676.  
  12677. <P>
  12678. Choosing any of the "by-" options cause Pine to attempt to
  12679. get the chosen option's value for the message being saved.  For
  12680. example, if "by-from" is chosen, Pine attempts to get the
  12681. value of who the message came from (i.e. the from address).  Pine then
  12682. attempts to save the message to a folder matching that value. If
  12683. "by-from" is chosen and no value is obtained, Pine uses
  12684. "by-sender". The opposite is also true.  If
  12685. "by-recipient" was chosen and the message was posted to a
  12686. newsgroup, Pine will use the newsgroup name.
  12687.  
  12688. <P>
  12689. If any of the "by-nick" options are chosen, the resulting
  12690. address is looked up in the user's address book and if found, the
  12691. nickname for that entry is used.
  12692. Only simple address book entries are checked, not distribution lists.
  12693. Similarly, if any of the
  12694. "by-fcc" options are chosen, the fcc from the corresponding
  12695. address book entry is used.
  12696. If no value is found in the address book,
  12697. then if the chosen option ends with the "then-from",
  12698. "then-sender", or "then-recip" suffix, Pine
  12699. reverts to the same behavior as "by-from",
  12700. "by-sender" or "by-recipient" depending on which
  12701. option was specified.
  12702. If the chosen option doesn't end with one of
  12703. the "then-" suffixes, then Pine reverts to the default
  12704. folder when no match is found in the address book.
  12705.  
  12706. <P>
  12707. Choosing the option called "last-folder-used", causes Pine
  12708. to save to the folder that you saved to the last time you saved a
  12709. message.  The first time you save a message in a Pine session, Pine
  12710. attempts to save the message to the default folder.
  12711.  
  12712. <P>
  12713. <UL>   
  12714. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  12715. </UL><P>
  12716. <End of help on this topic>
  12717. </BODY>
  12718. </HTML>
  12719. ====== h_config_fcc_rule =====
  12720. <HTML>
  12721. <HEAD>
  12722. <TITLE>OPTION: FCC-Name-Rule</TITLE>
  12723. </HEAD>
  12724. <BODY>
  12725. <H1>OPTION: FCC-Name-Rule</H1>
  12726.  
  12727. This option determines the default name for folder carbon copy. Choose
  12728. one:
  12729.  
  12730. <DL>
  12731. <DT>default-fcc</DT>
  12732. <DD>This is the normal default, the value of which is set in the
  12733. "default-fcc" variable as specified earlier in this
  12734. configuration.
  12735. </DD>
  12736.  
  12737. <DT>last-fcc-used</DT>
  12738. <DD> Causes Pine to use the folder that was last
  12739. used in the fcc field
  12740. </DD>
  12741.  
  12742. <DT>by-nickname</DT>
  12743. <DD>Means that Pine will use the nickname
  12744. from your address book that matches the first address in the To line.
  12745. If there is no match, it will use the value of the
  12746. "default-fcc" variable.
  12747. </DD>
  12748.  
  12749. <DT>by-recipient</DT>
  12750. <DD>Means Pine will form a folder name
  12751. based on the left hand side of the first address in the To line.
  12752. </DD>
  12753.  
  12754. <DT>by-nick-then-recip</DT>
  12755. <DD>Means that it will use the
  12756. matching nickname from your address book if there is one, otherwise it
  12757. will extract the recipient name from the address and use that (like
  12758. by-recipient).
  12759. </DD>
  12760.  
  12761. <DT>current-folder</DT>
  12762. <DD>Causes a copy to be written to
  12763. the currently open folder, unless that is the INBOX.  In the case
  12764. where the current folder is the INBOX, the "default-fcc" is
  12765. used instead.
  12766. </DD>
  12767. </DL>
  12768.  
  12769. <P>
  12770. Note: Whatever the fcc specified by the rule here, it will be
  12771. over-ridden by any fcc entries you have in your address book.
  12772.  
  12773. <P>
  12774. <UL>   
  12775. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  12776. </UL><P>
  12777. <End of help on this topic>
  12778. </BODY>
  12779. </HTML>
  12780. ====== h_config_sort_key =====
  12781. <HTML>
  12782. <HEAD>
  12783. <TITLE>OPTION: Sort-Key</TITLE>
  12784. </HEAD>
  12785. <BODY>
  12786. <H1>OPTION: Sort-Key</H1>
  12787.  
  12788. This option determines the order in which messages will be displayed in
  12789. the MESSAGE INDEX screen.  Choose from:
  12790. <P>
  12791. <UL>
  12792.  <LI> <A HREF="h_index_sort_arrival">Arrival</A>
  12793.  <LI> <A HREF="h_index_sort_date">Date</A>
  12794.  <LI> <A HREF="h_index_sort_subj">Subject</A>
  12795.  <LI> <A HREF="h_index_sort_ordsubj">OrderedSubj</A>
  12796.  <LI> <A HREF="h_index_sort_from">From</A>
  12797.  <LI> <A HREF="h_index_sort_size">Size</A>
  12798.  <LI> <A HREF="h_index_sort_score">Score</A>
  12799.  <LI> <A HREF="h_index_sort_to">To</A>
  12800.  <LI> <A HREF="h_index_sort_cc">Cc</A>
  12801. </UL>
  12802.  
  12803. <P>
  12804. Each type of sort may also be reversed.
  12805. Normal default is by "Arrival".
  12806.  
  12807. <P>
  12808. <UL>   
  12809. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  12810. </UL><P>
  12811. <End of help on this topic>
  12812. </BODY>
  12813. </HTML>
  12814. ====== h_config_fld_sort_rule =====
  12815. <HTML>
  12816. <HEAD>
  12817. <TITLE>OPTION: Folder-Sort-Rule</TITLE>
  12818. </HEAD>
  12819. <BODY>
  12820. <H1>OPTION: Folder-Sort-Rule</H1>
  12821.  
  12822. This option controls the order in which folder list entries will be
  12823. presented in the FOLDER LIST screen.  Choose one of the following:
  12824.  
  12825. <DL>
  12826. <DT>Alphabetical</DT>
  12827. <DD>sort by alphabetical name independent of type
  12828. </DD>
  12829.  
  12830. <DT>Alpha-with-dirs-last</DT>
  12831. <DD>sort by alphabetical name grouping directory entries
  12832. to the end of the list
  12833. </DD>
  12834.  
  12835. <DT>Alpha-with-dirs-first</DT>
  12836. <DD>sort by alphabetical name grouping directory entries
  12837. to the start of the list
  12838. </DD>
  12839. </DL>
  12840.  
  12841. The normal default is "Alphabetical".
  12842.  
  12843. <P>
  12844. <UL>   
  12845. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  12846. </UL><P>
  12847. <End of help on this topic>
  12848. </BODY>
  12849. </HTML>
  12850. ====== h_config_ab_sort_rule =====
  12851. <HTML>
  12852. <HEAD>
  12853. <TITLE>OPTION: Address-Book-Sort-Rule</TITLE>
  12854. </HEAD>
  12855. <BODY>
  12856. <H1>OPTION: Address-Book-Sort-Rule</H1>
  12857.  
  12858. This option controls the order in which address book entries will be
  12859. presented.  Choose one of the following:
  12860.  
  12861. <DL>
  12862. <DT>fullname</DT>
  12863. <DD>use fullname field, lists mixed in
  12864. </DD>
  12865.  
  12866. <DT>fullname-with-lists-last</DT>
  12867. <DD>use fullname field, but put lists at end
  12868. </DD>
  12869.  
  12870. <DT>nickname</DT>
  12871. <DD>use nickname field, lists mixed in
  12872. </DD>
  12873.  
  12874. <DT>nickname-with-lists-last</DT>
  12875. <DD>use nickname field, but put lists at end
  12876. </DD>
  12877.  
  12878. <DT>dont-sort</DT>
  12879. <DD>don't change order of file
  12880. </DD>
  12881. </DL>
  12882.  
  12883. <P>
  12884. The normal default is "fullname-with-lists-last".
  12885.  
  12886. <P>
  12887. <UL>   
  12888. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  12889. </UL><P>
  12890. <End of help on this topic>
  12891. </BODY>
  12892. </HTML>
  12893. ====== h_config_char_set =====
  12894. <HTML>
  12895. <HEAD>
  12896. <TITLE>OPTION: Character-Set</TITLE>
  12897. </HEAD>
  12898. <BODY>
  12899. <H1>OPTION: Character-Set</H1>
  12900.  
  12901. The character-set configuration option is used for both displaying
  12902. and sending messages.
  12903.  
  12904. <P>
  12905. When displaying a message, Pine compares this setting to the character
  12906. set specified in the message.  If they do not match, then Pine places
  12907. a comment in the displayed text (enclosed in square-brackets) indicating
  12908. that some characters may not be displayed correctly.
  12909.  
  12910. <P>
  12911. When sending a message the text typed in the composer and all text
  12912. attachments are labeled with the character set specified by this option.
  12913.  
  12914. <P>
  12915. The default value for this option is "US-ASCII".
  12916. <!--chtml if pinemode="os_windows"-->
  12917. The value you choose for this option should be consistent with 
  12918. your system's Regional Settings.
  12919. <!--chtml else-->
  12920. The value you choose for this option should reflect the character
  12921. set supported by the terminal or emulator Pine is using for its display
  12922. since that device is responsible for rendering the non-US-ASCII
  12923. characters.  Similarly, how you input 8-bit characters is a function
  12924. of the display device, and not something Pine can provide.  You'll need
  12925. to consult the terminal (or emulator) documention for input instruction.
  12926. <!--chtml endif-->
  12927. Typical values for this option might include
  12928. "ISO-8859-<I>N</I>", where <I>N</I> might be a number
  12929. between 1 and 9, or 13, or 15.
  12930.  
  12931. <P>
  12932. If this option is set to something other than "US-ASCII",
  12933. then its value will be used to label text you send that contains
  12934. non US-ASCII (sometimes called "8-bit") characters.  However,
  12935. if the text does <EM>not</EM> contain any such characters, it will be
  12936. labeled as "US-ASCII", independent of this option's value.
  12937.  
  12938. <P>
  12939. If this option is <EM>not</EM> set and the message text you are sending
  12940. or any text attachments are found to contain non US-ASCII 
  12941. (or "8-bit") characters, then Pine will do one of two things.
  12942. In the case of reply/forward, apply the character set
  12943. label of the original text to the outgoing message's text.
  12944. In the case of an original composition, where the 8-bit
  12945. characters were likely inserted via file or message
  12946. inclusion, Pine will label the text as "X-UNKNOWN".
  12947.  
  12948. <P>
  12949. <UL>   
  12950. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  12951. </UL><P>
  12952. <End of help on this topic>
  12953. </BODY>
  12954. </HTML>
  12955. ====== h_config_editor =====
  12956. <HTML>
  12957. <HEAD>
  12958. <TITLE>OPTION: Editor</TITLE>
  12959. </HEAD>
  12960. <BODY>
  12961. <H1>OPTION: Editor</H1>
  12962. Editor specifies the program invoked by ^_ in the Composer. This is
  12963. normally an alternative to Pine's internal composer (Pico).  You could use
  12964. this setting to specify an alternate editor to use occasionally or if you
  12965. have a favorite editor and want to use it all the time (see the 
  12966. <A HREF="h_config_alt_ed_now">"enable-alternate-editor-implicitly"</A> setting).  <P>
  12967. If you specify multiple editors for this option, ^_ will invoke the first one 
  12968. of those specified that exists and is executable.  When specifying a program 
  12969. for use here, make sure that the format of the text it saves -- which, when 
  12970. you exit it, will become the message body in Pine -- is appropriate 
  12971. for the body of an email message; avoid proprietary formats that may result in 
  12972. a message body that the recipient of your message will be unable to decipher.
  12973. <P>
  12974. <!--chtml if pinemode="os_windows"-->
  12975. <!--chtml else-->
  12976. If you are in doubt about what editors are available on your system, or which 
  12977. of them may be appropriate for specification here, ask your local computing 
  12978. support staff.  
  12979. <!--chtml endif-->
  12980. <P><UL>
  12981. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  12982. </UL>
  12983. <P>
  12984. <End of help on this topic>
  12985. </BODY>
  12986. </HTML>
  12987. ====== h_config_speller =====
  12988. <HTML>
  12989. <HEAD>
  12990. <TITLE>OPTION: Speller</TITLE>
  12991. </HEAD>
  12992. <BODY>
  12993. <H1>OPTION: Speller</H1>
  12994.  
  12995. This option affects the behavior of the ^T (spell check) command in the
  12996. Composer.  It specifies the program invoked by ^T in the Composer.  By
  12997. default, Pine uses the system's "spell" command.  Pine will use the
  12998. command defined by this option (if any) instead.  When invoking the
  12999. spell-checking program, Pine appends a tempfile name (where the message is
  13000. passed) to the command line. Pine expects the speller to correct the
  13001. spelling in that file. When you exit from that program Pine will read the
  13002. tempfile back into the composer.
  13003.  
  13004. <P>
  13005. If this option is not set, then the system's "spell" command is used.
  13006. The spell command does not work the same as the alternate speller.
  13007. It produces a list of misspelled words on its standard output, instead.
  13008. Don't set this speller option to the standard Unix spell command.
  13009. That won't work. If you want to use the standard Unix spell command,
  13010. set the speller option to nothing.
  13011.  
  13012. <P>
  13013. <UL>   
  13014. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  13015. </UL><P>
  13016. <End of help on this topic>
  13017. </BODY>
  13018. </HTML>
  13019. ====== h_config_display_filters =====
  13020. <HTML>
  13021. <HEAD>
  13022. <TITLE>OPTION: Display-Filters</TITLE>
  13023. </HEAD>
  13024. <BODY>
  13025. <H1>OPTION: Display-Filters</H1>
  13026.  
  13027. This option defines a list of text-filtering commands (programs or
  13028. scripts) that may be used to filter text portions of received messages
  13029. prior to their use (e.g., presentation in the "MESSAGE TEXT"
  13030. display screen, exporting to a text file).  
  13031. For security reasons, the full path name of the
  13032. filter command must be specified.
  13033.  
  13034. <P>
  13035. The command is executed and the message is piped into its standard input. 
  13036. The standard output of the command is read back by Pine.  The
  13037. "_TMPFILE_" token (see below) overrides this default behavior. 
  13038.  
  13039. <P> 
  13040. The filter's use is based on the configured "trigger" string.  The
  13041. format of a filter definition is:
  13042.  
  13043. <P>   
  13044. <CENTER><trigger> <command> <arguments></CENTER>
  13045.  
  13046. <P>
  13047. You can specify as many filters as you wish, separating them with a comma.  
  13048. Each filter can have only one trigger and command.  Thus, two trigger 
  13049. strings which invoke the same command require separate filter 
  13050. specifications. 
  13051.  
  13052. <P> 
  13053. The "trigger" is simply text that, if found in the message,
  13054. will invoke the associated command.  If the trigger contains any space
  13055. characters, it must be placed within quotes.  Likewise, should you
  13056. wish a filter to be invoked unconditionally, define the trigger as the
  13057. null string, "" (two consecutive double-quote characters).  If the
  13058. trigger string is found anywhere in the text of the message the filter
  13059. is invoked.  Placing the trigger text within the tokens defined below
  13060. changes where within the text the trigger must be before considering
  13061. it a match.
  13062.  
  13063. <P>  
  13064. Trigger Modifying Tokens:
  13065. <DL>
  13066. <DT>_CHARSET(<VAR>string</VAR>)_</DT>
  13067. <DD>This token tells Pine to invoke the supplied command
  13068. if the text is in a character set matching <VAR>string</VAR>
  13069. (e.g., ISO-8859-2 or ISO-2022-JP).
  13070. </DD>
  13071.  
  13072.  
  13073. <DT>_LEADING(<VAR>string</VAR>)_</DT>
  13074. <DD>This token tells Pine to invoke the supplied command
  13075. if the enclosed <VAR>string</VAR> is found to be the first
  13076. non-whitespace text.
  13077. <BR>NOTE: Quotes are necessary if <VAR>string</VAR> contains
  13078. the space character.
  13079. </DD>
  13080.  
  13081. <DT>_BEGINNING(<VAR>string</VAR>)_</DT>
  13082. <DD>This token tells Pine to invoke the supplied command
  13083. if the enclosed <VAR>string</VAR> is found at the beginning
  13084. of any line in the text.
  13085. <BR>NOTE: Quotes are necessary if <VAR>string</VAR> contains
  13086. the space character.
  13087. </DD>
  13088. </DL>
  13089.  
  13090. <P>
  13091. The "command" and "arguments" portion is simply
  13092. the command line to be invoked if the trigger string is found.  Below
  13093. are tokens that Pine will recognize and replace with special values
  13094. when the command is actually invoked.
  13095.  
  13096. <P>
  13097. Command Modifying Tokens:
  13098.  
  13099. <DL>
  13100. <DT>_TMPFILE_</DT>
  13101. <DD>When the command is executed, this token is 
  13102. replaced with the path and name of the temporary 
  13103. file containing the text to be filtered.  Pine 
  13104. expects the filter to replace this data with the 
  13105. filter's result.
  13106.  
  13107. <P>
  13108. NOTE: Use of this token implies that the text to 
  13109. be filtered is not piped into standard input of the 
  13110. executed command and its standard output is ignored. 
  13111. Pine restores the tty modes before invoking the
  13112. filter in case the filter interacts with the user
  13113. via its own standard input and output.  
  13114. </DD>
  13115.                         
  13116. <DT>_RESULTFILE_</DT>
  13117. <DD>When the command is executed, this token is 
  13118. replaced with the path and name of a temporary 
  13119. file intended to contain a status message from the 
  13120. filter.  Pine displays this in the message status 
  13121. field. 
  13122. </DD>
  13123.  
  13124. <DT>_DATAFILE_</DT>
  13125. <DD>When the command is executed, this token is 
  13126. replaced with the path and name of a temporary 
  13127. file that Pine creates once per session and deletes 
  13128. upon exit.  The file is intended to be used by the 
  13129. filter to store state information between instances 
  13130. of the filter.
  13131. </DD>
  13132.    
  13133. <DT>_PREPENDKEY_</DT>
  13134. <DD>When the command is executed, this token indicates that a random
  13135. number will be passed down the input stream before the message text.
  13136. This number could be used as a session key.  It is sent in this way to
  13137. improve security.  The number is unique to the current Pine session
  13138. and is only generated once per session.
  13139. </DD>
  13140. </DL>
  13141.  
  13142. <P>
  13143. Performance caveat/considerations:
  13144. <BR>
  13145. Testing for the trigger and invoking the filter doesn't come for free.
  13146. There is overhead associated with searching for the trigger string, testing
  13147. for the filter's existence and actually piping the text through the filter.
  13148. The impact can be reduced if the Trigger Modifying Tokens above are 
  13149. employed.
  13150. <P>
  13151. <End of help on this topic>
  13152. </BODY>
  13153. </HTML>
  13154. ====== h_config_sending_filter =====
  13155. <HTML>
  13156. <HEAD>
  13157. <TITLE>OPTION: Sending-Filters</TITLE>
  13158. </HEAD>
  13159. <BODY>
  13160. <H1>OPTION: Sending-Filters</H1>
  13161.       
  13162. This option defines a list of text-filtering commands (programs and
  13163. scripts) that may be selectively invoked to process a message just before
  13164. it is sent.  If set, the Composer's ^X (Send) command will allow you to
  13165. select which filter (or none) to apply to the message before it is sent. 
  13166. For security reasons, the full path of the filter program must be
  13167. specified. 
  13168.  
  13169. <P>
  13170. Command Modifying Tokens:
  13171.  
  13172. <DL>
  13173. <DT>_RECIPIENTS_</DT>
  13174. <DD>When the command is executed, this token is replaced 
  13175. with the space delimited list of recipients of the 
  13176. message being sent. 
  13177. </DD>
  13178.         
  13179. <DT>_TMPFILE_</DT>
  13180. <DD>
  13181. When the command is executed, this token is 
  13182. replaced with the path and name of the temporary 
  13183. file containing the text to be filtered.  Pine 
  13184. expects the filter to replace this data with the 
  13185. filter's result.
  13186.  
  13187. <P>
  13188. NOTE: Use of this token implies that the text to 
  13189. be filtered is not piped into standard input of the 
  13190. executed command and its standard output is ignored. 
  13191. Pine restores the tty modes before invoking the
  13192. filter in case the filter interacts with the user
  13193. via its own standard input and output.  
  13194. </DD>
  13195.                         
  13196. <DT>_RESULTFILE_</DT>
  13197. <DD>When the command is executed, this token is 
  13198. replaced with the path and name of a temporary 
  13199. file intended to contain a status message from the 
  13200. filter.  Pine displays this in the message status 
  13201. field. 
  13202. </DD>
  13203.  
  13204. <DT>_DATAFILE_</DT>
  13205. <DD>When the command is executed, this token is replaced 
  13206. in the command line with the path and name of a 
  13207. temporary file that Pine creates once per session 
  13208. and deletes upon exit.  The file is intended to be 
  13209. used by the filter to store state information between 
  13210. instances of the filter.
  13211. </DD>
  13212.    
  13213. <DT>_PREPENDKEY_</DT>
  13214. <DD>When the command is executed, this token indicates 
  13215. that a random number will be passed down the input 
  13216. stream before the message text.  This number could 
  13217. be used as a session key.  It is sent in this way 
  13218. to improve security.  The number is unique to the 
  13219. current Pine session and is only generated once per 
  13220. session. 
  13221. </DD>
  13222.  
  13223. <DT>_INCLUDEALLHDRS_</DT>
  13224. <DD>When the command is executed, this token indicates 
  13225. that the headers of the message will be passed down the input stream
  13226. before the message text.
  13227. </DD>
  13228.  
  13229. <DT>_MIMETYPE_</DT>
  13230. <DD>When the command is executed, this token is replaced in the
  13231. command name with a temporary file name used to accept any new MIME
  13232. Content-Type information necessitated by the output of the filter.
  13233. Upon the filter's exit, if the file contains new MIME type
  13234. information, Pine verifies its format and replaces the outgoing
  13235. message's MIME type information with that contained in the file. This
  13236. is basically a cheap way of sending something other than Text/Plain.
  13237. </DD>
  13238. </DL>
  13239.  
  13240. <P>   
  13241. NOTE: Only the body text, which is visible in the Composer, is piped
  13242. through this filter.  Attachments are not sent to the filter.
  13243.  
  13244. <P>
  13245. <UL>   
  13246. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  13247. </UL><P>
  13248. <End of help on this topic>
  13249. </BODY>
  13250. </HTML>
  13251. ====== h_config_alt_addresses =====
  13252. <HTML>
  13253. <HEAD>
  13254. <TITLE>OPTION: Alt-Addresses</TITLE>
  13255. </HEAD>
  13256. <BODY>
  13257. <H1>OPTION: Alt-Addresses</H1>
  13258.  
  13259. This option provides a place for you to list alternative email addresses
  13260. you may have.  If set, the option affects the behavior of the Reply
  13261. command and the "+" symbol in the MESSAGE INDEX, which denotes that
  13262. a message has been addressed specifically to you.
  13263.  
  13264. <P>
  13265. With respect to Reply, the reply-to-all option will exclude addresses
  13266. listed here.
  13267.  
  13268. <P>
  13269. <UL>   
  13270. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  13271. </UL><P>
  13272. <End of help on this topic>
  13273. </BODY>
  13274. </HTML>
  13275. ====== h_config_abook_formats =====
  13276. <HTML>
  13277. <HEAD>
  13278. <TITLE>OPTION: Addressbook-Formats</TITLE>
  13279. </HEAD>
  13280. <BODY>
  13281. <H1>OPTION: Addressbook-Formats</H1>
  13282.  
  13283. This option specifies the format that address books are displayed in.
  13284. Normally, address books are displayed with the nicknames in the first
  13285. column, the fullnames in the second column, and addresses in the third
  13286. column.  The system figures out reasonable defaults for the widths of
  13287. the columns.  An address book may be given a different format by
  13288. listing special tokens in the order you want them to display.  The
  13289. possible tokens are NICKNAME, FULLNAME, ADDRESS, FCC, and COMMENT.
  13290. So, for example, to get the default behavior you could list
  13291.  
  13292. <P>
  13293. <CENTER>addressbook-formats=NICKNAME FULLNAME ADDRESS</CENTER>
  13294.  
  13295. <P>
  13296. (You can also use the token DEFAULT to get the default behavior for
  13297. an address book format.)
  13298.  
  13299. <P>
  13300. The tokens are separated by spaces.  "Addressbook-formats"
  13301. is a list, so if you have more than one address book you may have a
  13302. separate format for each by putting its format at the corresponding
  13303. location in the "addressbook-formats" list.
  13304.  
  13305. <P>
  13306.  
  13307. Listed first are the personal address books, then the global address
  13308. books.  So, if you have two personal address books and one global
  13309. address book, you may have up to three formats in the
  13310. "addressbook-formats" list.  If
  13311. "addressbook-formats" doesn't have as many elements as there
  13312. are address books, the last element is used repeatedly.
  13313.  
  13314. <P>
  13315.  
  13316. Each of the tokens may also be optionally followed by parentheses with
  13317. either a number or a percentage inside the parentheses.  For example,
  13318. <SAMP>FULLNAME(13)</SAMP> means to allocate 13 characters of space to
  13319. the fullnames column, <SAMP>FULLNAME(20%)</SAMP> means to allocate 20%
  13320. of the available space (the screen width minus the space for
  13321. inter-column spaces) to the fullnames column, while plain
  13322. <SAMP>FULLNAME</SAMP> means the system will attempt to figure out a
  13323. reasonable number of columns.
  13324.  
  13325. <P>
  13326. There are always 2 spaces between every column, so if you use
  13327. fixed column widths (like 13) you should remember to take that into
  13328. account.
  13329.  
  13330. <P>
  13331. <UL>   
  13332. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  13333. </UL><P>
  13334. <End of help on this topic>
  13335. </BODY>
  13336. </HTML>
  13337. ====== h_config_index_format =====
  13338. <HTML>
  13339. <HEAD>
  13340. <TITLE>OPTION: Index-Format</TITLE>
  13341. </HEAD>
  13342. <BODY>
  13343. <H1>OPTION: Index-Format</H1>
  13344.  
  13345. This option is used to customize the content of lines in the
  13346. <A HREF="h_mail_index">MESSAGE INDEX screen</A>.  Each line is intended 
  13347. to convey some amount of immediately relevant information about each 
  13348. message in the current folder.
  13349. <P>
  13350.  
  13351. Pine provides a pre-defined set of informational fields with
  13352. reasonable column widths automatically computed.  You can, however,
  13353. replace this default set by listing special tokens in the order you
  13354. want them displayed.
  13355. <P>
  13356.  
  13357. The list of available tokens is
  13358. <A HREF="h_index_tokens">here</A>.
  13359. <P>
  13360.  
  13361. Spaces are used to separate listed tokens.  Additionally, you can
  13362. specify how much of the screen's width the taken's associated data
  13363. should occupy on the index line by appending the token with a pair of
  13364. parentheses enclosing either a number or percentage.  For example,
  13365. "SUBJECT(13)" means to allocate 13 characters of space to the subject
  13366. column, and "SUBJECT(20%)" means to
  13367. allocate 20% of the available space
  13368. to the subjects column, while plain "SUBJECT" means the system will
  13369. attempt to figure out a reasonable amount of space.
  13370. <P>
  13371.  
  13372. There is always one space between every pair of columns, so if you use fixed
  13373. column widths (like 13) you should remember to take that into account.
  13374. Several of the fields are virtually fixed-width, so it doesn't make
  13375. much sense to specify the width for them.  The fields STATUS,
  13376. FULLSTATUS, IMAPSTATUS, MSGNO, the DATE fields, SIZE,
  13377. and DESCRIPSIZE all fall into that category.
  13378. You <EM>may</EM> specify widths for those if you wish, but
  13379. you're probably better off letting the system pick those widths.  <P>
  13380.  
  13381. <P>
  13382. The default is equivalent to:
  13383.  
  13384. <P>
  13385. <CENTER><SAMP>index-format=STATUS MSGNO DATE FROMORTO(33%) SIZE SUBJECT(67%)</SAMP></CENTER>
  13386.  
  13387. <P>
  13388. This means that the four fields without percentages will be allocated
  13389. first, and then 33% and 67% of the <EM>remaining</EM> space will go to
  13390. the from and subject fields.  If one of those two fields is specified
  13391. as a percentage and the other is left for the system to choose, then
  13392. the percentage is taken as an absolute percentage of the screen, not
  13393. of the space remaining after allocating the first four columns.  It
  13394. doesn't usually make sense to do it that way.  If you leave off all
  13395. the widths, then the subject and from fields (if both are present) are
  13396. allocated space in a 2 to 1 ratio, which is almost exactly the same as
  13397. the default.
  13398.  
  13399. <P>
  13400. What you are most likely to do with this configuration option is to
  13401. specify which fields appear at all, which order they appear in, and the
  13402. percentage of screen that is used for the from and subject fields if you
  13403. don't like the 2 to 1 default.
  13404.  
  13405. <P>
  13406. <UL>   
  13407. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  13408. </UL><P>
  13409. <End of help on this topic>
  13410. </BODY>
  13411. </HTML>
  13412. ====== h_config_reply_intro =====
  13413. <HTML>
  13414. <HEAD>
  13415. <TITLE>OPTION: Reply-Leadin</TITLE>
  13416. </HEAD>
  13417. <BODY>
  13418. <H1>OPTION: Reply-Leadin</H1>
  13419.  
  13420. This option is used to customize the content of the introduction line
  13421. that is included when replying to a message and including the original
  13422. message in the reply.
  13423. The normal default (what you will get if you delete this variable) looks
  13424. something like:
  13425. <P>
  13426. <CENTER><SAMP>On Sat, 24 Oct 1998, Fred Flintstone wrote:</SAMP></CENTER>
  13427. <P>
  13428. where the day of the week is only included if it is available in the
  13429. original message.
  13430. You can replace this default with text of your own.
  13431. The text may contain tokens which are replaced with text
  13432. which depends on the message you are replying to.
  13433. For example, the default is equivalent to:
  13434. <P>
  13435. <CENTER><SAMP>On _DAYDATE_, _FROM_ wrote:</SAMP></CENTER>
  13436. <P>
  13437.  
  13438. Since this variable includes regular text mixed with special tokens
  13439. the tokens have to be surrounded by underscore characters.
  13440. For example, to use the token "<SAMP>DATE</SAMP>"
  13441. you would need to use "<SAMP>_DATE_</SAMP>",
  13442. not "<SAMP>DATE</SAMP>".
  13443. <P>
  13444. The list of available tokens is
  13445. <A HREF="h_index_tokens">here</A>.
  13446.  
  13447. <P>
  13448. For the adventurous, there is a way to conditionally include text based
  13449. on whether or not a token would result in specific replacement text.
  13450. For example, you could include some text based on whether or not
  13451. the _NEWS_ token would result in any newsgroups if it was used.
  13452. It's explained in detail
  13453. <A HREF="h_reply_token_conditionals">here</A>.
  13454.  
  13455. <P>
  13456. If your "Reply-Leadin" turns out to be longer
  13457. than 80 characters when replying to a particular message, it is shortened.
  13458.  
  13459. <P>
  13460. In the very unlikely event that you want to include a literal token
  13461. in the introduction line you must precede it with a backslash character.
  13462. For example,
  13463. <P>
  13464. <CENTER><SAMP>\_DAYDATE_ = _DAYDATE_</SAMP></CENTER>
  13465. <P>
  13466. would produce something like
  13467. <P>
  13468. <CENTER><SAMP>_DAYDATE_ = Sat, 24 Oct 1998</SAMP></CENTER>
  13469. <P>
  13470. It is not possible to have a literal backslash followed by an expanded token.
  13471. <P>
  13472. <UL>   
  13473. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  13474. </UL><P>
  13475. <End of help on this topic>
  13476. </BODY>
  13477. </HTML>
  13478. ====== h_config_composer_wrap_column =====
  13479. <HTML>
  13480. <HEAD>
  13481. <TITLE>OPTION: Composer-Wrap-Column</TITLE>
  13482. </HEAD>
  13483. <BODY>
  13484. <H1>OPTION: Composer-Wrap-Column</H1>
  13485.  
  13486.  
  13487. This option specifies an aspect of Pine's Composer.  This gives the
  13488. maximum width that auto-wrapped lines will have.  It's also the maximum
  13489. width of lines justified using the <A HREF="h_compose_justify">^J
  13490. Justify</A> command.  The normal default
  13491. is "74".  The largest allowed setting is normally "80"
  13492. in order to
  13493. prevent very long lines from being sent in outgoing mail.  When the mail
  13494. is actually sent, trailing spaces will be stripped off of each line.
  13495.  
  13496. <P>
  13497. <UL>   
  13498. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  13499. </UL><P>
  13500. <End of help on this topic>
  13501. </BODY>
  13502. </HTML>
  13503. ====== h_config_viewer_overlap =====
  13504. <html>
  13505. <header>
  13506. <title>OPTION: Viewer-Overlap</title>
  13507. </header>
  13508. <body>
  13509. <h1>OPTION: Viewer-Overlap</h1>
  13510.  
  13511. This option specifies an aspect of Pine's Message Viewing screen.  When
  13512. the space bar is used to page forward in a message, the number of lines
  13513. specified by the "viewer-overlap" variable will be repeated from the
  13514. bottom of the screen.  That is, if this was set to two lines, then the
  13515. bottom two lines of the screen would be repeated on the top of the next
  13516. screen.  The normal default value is "2".<p>
  13517. <UL>   
  13518. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  13519. </UL><P>
  13520. <End of help on this topic>
  13521. </body>
  13522. </html>
  13523. ====== h_config_scroll_margin =====
  13524. <HTML>
  13525. <HEAD>
  13526. <TITLE>OPTION: Scroll-margin</TITLE>
  13527. </HEAD>
  13528. <BODY>
  13529. <H1>OPTION: Scroll-margin</H1>
  13530.  
  13531. This option controls when Pine's line-by-line scrolling occurs.
  13532. Typically, when a selected item is at the top or bottom screen edge
  13533. and the UP or DOWN (and Ctrl-P or Ctrl-N) keys are struck, the
  13534. displayed items are scrolled down or up by a single line.
  13535.  
  13536. <P>
  13537. This option allows you to tell Pine the number of lines from the top and
  13538. bottom screen edge that line-by-line paging should occcur.  For example,
  13539. setting this value to one (1) will cause Pine to scroll the display
  13540. vertically when you move to select an item on the display's top or
  13541. bottom edge.
  13542.  
  13543. <P>
  13544. By default, this variable is zero, indicating that scrolling happens
  13545. when you move up or down to select an item immediately off the display's
  13546. top or bottom edge.
  13547.  
  13548. <P>
  13549. <UL>   
  13550. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  13551. </UL><P>
  13552. <End of help on this topic>
  13553. </BODY>
  13554. </HTML>
  13555. ====== h_config_reply_indent_string =====
  13556. <HTML>
  13557. <HEAD>
  13558. <TITLE>OPTION: Reply-Indent-String</TITLE>
  13559. </HEAD>
  13560. <BODY>
  13561. <H1>OPTION: Reply-Indent-String</H1>
  13562.  
  13563. This option specifies an aspect of Pine's Reply command.
  13564. When a message is replied to and the text of the message is included, the
  13565. included text usually has the string "> " prepended
  13566. to each line indicating it is quoted text.
  13567. (In case you haven't seen this before, "string" is a technical term
  13568. which means chunk of text.)
  13569.  
  13570. <P>
  13571. This option specifies a different value for that string.
  13572. If you wish to use a string which begins or ends with a space,
  13573. enclose the string in double quotes.
  13574.  
  13575. <P>
  13576. Besides simple text, the prepended string can be based
  13577. on the message being replied to.
  13578. The following tokens are substituted for the message's corresponding value:
  13579.  
  13580. <DL>
  13581. <DT>_FROM_</DT>
  13582. <DD>This token gets replaced with the message sender's "username".
  13583. </DD>
  13584.  
  13585. <DT>_NICK_</DT>
  13586. <DD>This token gets replaced with the nickname of the message sender's
  13587. address as found in your addressbook.
  13588. If no addressbook entry is found,
  13589. Pine replaces the characters "_NICK_" with nothing.
  13590. </DD>
  13591.  
  13592. <DT>_INIT_</DT>
  13593. <DD>This token gets replaced with the initials of the sender of the message.
  13594. </DD>
  13595.  
  13596. </DL>
  13597.  
  13598. NOTE: When the
  13599. <A HREF="h_config_prefix_editing">"enable-reply-indent-string-editing"</A>
  13600. feature is enabled, you are given the opportunity to edit the string, whether 
  13601. it is the default or one automatically generated using the above tokens.
  13602. <P>
  13603. <UL>   
  13604. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  13605. </UL><P>
  13606. <End of help on this topic>
  13607. </BODY>
  13608. </HTML>
  13609. ====== h_config_empty_hdr_msg =====
  13610. <HTML>
  13611. <HEAD>
  13612. <TITLE>OPTION: Empty-Header-Message</TITLE>
  13613. </HEAD>
  13614. <BODY>
  13615. <H1>OPTION: Empty-Header-Message</H1>
  13616.  
  13617. When sending, if all of the To, Cc, and Newsgroups fields are empty,
  13618. Pine will put a special address in the To line.  The default value is:
  13619.  
  13620. <P>
  13621. <CENTER><SAMP>Undisclosed recipients: ;</SAMP></CENTER>
  13622.  
  13623. <P>
  13624. The reason for this is to avoid embarrassment caused by some Internet
  13625. mail transfer software that interprets a "missing"
  13626. <SAMP>To:</SAMP> header as an error and replaces it with an
  13627. <SAMP>Apparently-to:</SAMP> header that may contain the addresses you
  13628. entered on the <SAMP>Bcc:</SAMP> line, defeating the purpose of the
  13629. Bcc.  You may change the part of this message that comes before the
  13630. ": ;" by setting the "empty-header-message"
  13631. variable to something else.
  13632.  
  13633. <P>
  13634. The normal default is "Undisclosed recipients".
  13635.  
  13636. <P>
  13637. <UL>   
  13638. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  13639. </UL><P>
  13640. <End of help on this topic>
  13641. </BODY>
  13642. </HTML>
  13643. ====== h_config_status_msg_delay =====
  13644. <HTML>
  13645. <HEAD>
  13646. <TITLE>OPTION: Status-Message-Delay</TITLE>
  13647. </HEAD>
  13648. <BODY>
  13649. <H1>OPTION: Status-Message-Delay</H1>
  13650.  
  13651. If this is set to a positive number, it causes the cursor to move to the
  13652. status line whenever a status message is printed and pause there for this
  13653. many seconds.  It will probably only be useful if the 
  13654. <A HREF="h_config_show_cursor">"show-cursor"</A> feature is also turned on.
  13655. <P>
  13656. <UL>   
  13657. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  13658. </UL><P>
  13659. <End of help on this topic>
  13660. </BODY>
  13661. </HTML>
  13662. ====== h_config_mailcheck =====
  13663. <html>
  13664. <header>
  13665. <title>OPTION: Mail-Check-Interval</title>
  13666. </header>
  13667. <body>
  13668. <h1>OPTION: Mail-Check-Interval</h1>
  13669.  
  13670. This options specifies, in seconds, how often Pine will check for new
  13671. mail.  If set to zero, new-mail checking is disabled.  There is a minimum
  13672. value, normally 15 seconds.<p>
  13673. <UL>   
  13674. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  13675. </UL><P>
  13676. <End of help on this topic>
  13677. </body>
  13678. </html>
  13679. ====== h_config_news_active =====
  13680. <html>
  13681. <header>
  13682. <title>OPTION: News-Active-File-Path</title>
  13683. </header>
  13684. <body>
  13685. <h1>OPTION: News-Active-File-Path</h1>
  13686.  
  13687. This option tells Pine where to look for the "active file" for newsgroups
  13688. when accessing news locally, rather than via NNTP.  The default path is
  13689. usually "/usr/lib/news/active".<p>
  13690. <UL>   
  13691. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  13692. </UL><P>
  13693. <End of help on this topic>
  13694. </body>
  13695. </html>
  13696. ====== h_config_news_spool =====
  13697. <html>
  13698. <header>
  13699. <title>OPTION: News-Spool-Directory</title>
  13700. </header>
  13701. <body>
  13702. <h1>OPTION: News-Spool-Directory</h1>
  13703. This option tells Pine where to look for the "news spool" for newsgroups
  13704. when accessing news locally, rather than via NNTP.  The default path is
  13705. usually "/usr/spool/news".<p>
  13706. <UL>   
  13707. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  13708. </UL><P>
  13709. <End of help on this topic>
  13710. </body>
  13711. </html>
  13712. ====== h_config_image_viewer =====
  13713. <html>
  13714. <header>
  13715. <title>OPTION: Image-Viewer</title>
  13716. </header>
  13717. <body>
  13718. <h1>OPTION: Image-Viewer</h1>
  13719. <body>
  13720. This option specifies the program Pine should call to view MIME
  13721. attachments of type IMAGE (e.g. GIF or TIFF).  The Image Viewer setting is
  13722. no longer needed, but remains for backward compatibility.  The more
  13723. general method for associating external printing and viewing programs with
  13724. specific MIME data types is to use the system's (or your personal)
  13725. "mailcap" configuration file.<p>
  13726. <UL>   
  13727. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  13728. </UL><P>
  13729. <End of help on this topic>
  13730. </body>
  13731. </html>
  13732. ====== h_config_domain_name =====
  13733. <HTML>
  13734. <HEAD>
  13735. <TITLE>OPTION: Use-Only-Domain-Name</TITLE>
  13736. </HEAD>
  13737. <BODY>
  13738. <H1>OPTION: Use-Only-Domain-Name</H1>
  13739.  
  13740. This option is used only if the 
  13741. <A HREF="h_config_user_dom">"user-domain"</A> option is <B>not</B> 
  13742. set.  If set to "Yes" (and user-domain is not used), then Pine 
  13743. strips the hostname from your return ("From") address and when 
  13744. completing unqualified addresses that you enter into the composer.
  13745. <P>
  13746. If you set this, see also the <A HREF="h_config_quell_local_lookup">
  13747. "quell-user-lookup-in-passwd-file"</A> feature.
  13748.  
  13749.  
  13750. <!--chtml if pinemode="os_windows"-->
  13751. <P>This option is not applicable to PC-Pine.
  13752. <!--chtml else-->
  13753. <P>
  13754. <!--chtml endif-->
  13755. <UL>
  13756. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  13757. </UL>
  13758. <P>
  13759. <End of help on this topic>
  13760. </BODY>
  13761. </HTML>
  13762. ====== h_config_prune_date =====
  13763. <HTML>
  13764. <HEAD>
  13765. <TITLE>OPTION: Last-Time-Prune Question</TITLE>
  13766. </HEAD>
  13767. <BODY>
  13768. <H1>OPTION: Last-Time-Prune Question</H1>
  13769.  
  13770. This value records the last time you were asked about deleting old
  13771. sent-mail. It is set automatically by Pine at the beginning of each
  13772. month. If you wish to suppress the monthly sent-mail pruning feature, set
  13773. this to a date in the future.  This value is relative to the year 1900, so 
  13774. to set this, for example, to October 2005, use 105.10; to set it to 
  13775. May 1999, to 99.05.
  13776.  
  13777. <P>
  13778. <UL>   
  13779. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  13780. </UL><P>
  13781. <End of help on this topic>
  13782. </BODY>
  13783. </HTML>
  13784. ====== h_config_goto_default =====
  13785. <HTML>
  13786. <HEAD>
  13787. <TITLE>OPTION: goto-default-rule</TITLE>
  13788. </HEAD>
  13789. <BODY>
  13790. <H1>OPTION: goto-default-rule</H1>
  13791.  
  13792. This value affects Pine's behavior when you use the Goto command.
  13793. Pine's usual behavior has two parts.  If your current folder is
  13794. "Inbox", Pine will offer the last open folder as the
  13795. default.  If the current folder is other than "Inbox",
  13796. "Inbox" is offered as the default.
  13797.  
  13798. <P>
  13799. The available options include:
  13800.  
  13801. <DL>
  13802.  
  13803.  <DT>folder-in-first-collection</DT>
  13804.  
  13805.  <DD> Pine will offer the most recently visited folder in the default
  13806. collection found in the "Collection List" screen as the default.
  13807. </DD>
  13808.  
  13809.  <DT> inbox-or-folder-in-first-collection</DT>
  13810.  
  13811.  <DD> If the current folder is "Inbox",
  13812. Pine will offer the most recently visited folder in the
  13813. default collection found in the "Collection List" screen.
  13814. If the current folder is other than "Inbox",
  13815. "Inbox" is offered as the default.
  13816. </DD>
  13817.  
  13818.  <DT> inbox-or-folder-in-recent-collection</DT>
  13819.  
  13820.  <DD> This is Pine's default behavior.
  13821. If the current folder is "Inbox",
  13822. Pine will offer the last open
  13823. folder as the default.
  13824. If the current folder is other than "Inbox",
  13825. "Inbox" is offered as the default.
  13826. </DD>
  13827.  
  13828.  <DT> first-collection-with-inbox-default</DT>
  13829.  
  13830.  <DD> Instead of offering the most recently visited folder in the default
  13831. collection, the default collection is offered but with "Inbox" as
  13832. the default folder.
  13833. If you type in a folder name it will be in the default collection.
  13834. If you simply accept the default, however, your "Inbox" will be opened.
  13835. </DD>
  13836.  
  13837.  <DT> most-recent-folder</DT>
  13838.  
  13839.  <DD> The last accepted value simply causes the most recently opened
  13840. folder to be offered as the default regardless of the currently opened
  13841. folder.
  13842. </DD>
  13843. </DL>
  13844.  
  13845. <P>
  13846. NOTE: The default while a newsgroup is open remains the same; the last
  13847. open newsgroup.
  13848.  
  13849. <P>
  13850. <UL>   
  13851. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  13852. </UL><P>
  13853. <End of help on this topic>
  13854. </BODY>
  13855. </HTML>
  13856. ====== h_config_inc_startup =====
  13857. <HTML>
  13858. <HEAD>
  13859. <TITLE>OPTION: incoming-startup-rule</TITLE>
  13860. </HEAD>
  13861. <BODY>
  13862. <H1>OPTION: incoming-startup-rule</H1>
  13863.  
  13864. This value affects Pine's behavior when opening the "INBOX" or 
  13865. one of the "INCOMING MESSAGE FOLDERS".  By default, when the 
  13866. "INBOX" or another
  13867. incoming folder is first opened, the current message is set to the first
  13868. unseen message which has not been marked deleted, or the last message if
  13869. all of the messages have been seen previously.
  13870.  
  13871. <P>
  13872. The four possible values for this option are:
  13873.  
  13874. <DL>
  13875. <DT>first-unseen</DT>
  13876. <DD>This is the default described above.
  13877. </DD>
  13878.  
  13879. <DT>first-recent</DT>
  13880. <DD>Similar to the default, but rather than starting on the first
  13881. unseen message Pine starts you on the first <EM>recent</EM> message.
  13882. A message is recent if it arrived since the last time the folder was
  13883. open.  This value causes the current message to be set to the first
  13884. recent and undeleted message if there is one, otherwise the last
  13885. message in the folder.
  13886. </DD>
  13887.  
  13888. <DT>First</DT>
  13889. <DD>Simply starts you on the <EM>first</EM> undeleted message in the folder.
  13890. If all messages are deleted you start on the last message.
  13891. </DD>
  13892.  
  13893. <DT>Last</DT>
  13894. <DD>Simply starts you on the <EM>last</EM> undeleted message in the folder
  13895. If all messages are deleted you start on the last message.
  13896. </DD>
  13897. </DL>
  13898.  
  13899. <P>
  13900. NOTE:  For newsgroups in the incoming collection, "first-unseen" and
  13901. "first-recent" are the same and are affected by whether or not the
  13902. feature 
  13903. <A HREF="h_config_news_uses_recent">"news-approximates-new-status"</A> is turned on.  
  13904.  
  13905. <P>
  13906. <UL>   
  13907. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  13908. </UL><P>
  13909. <End of help on this topic>
  13910. </BODY>
  13911. </HTML>
  13912. ====== h_config_browser =====
  13913. <HTML>
  13914. <HEAD>
  13915. <TITLE>OPTION: url-viewers</TITLE>
  13916. </HEAD>
  13917. <BODY>
  13918. <H1>OPTION: url-viewers</H1>
  13919. <!--chtml if pinemode="os_windows"-->
  13920. PC-Pine users do not need to enter anything here, unless:<UL>
  13921. <LI> they want to override, for use with Pine, the application defined
  13922. in the Windows operating system for handling URLs; or
  13923. <LI> they are (planning on) using the same configuration file with 
  13924. Unix Pine.
  13925. </UL><HR><P>
  13926. <!--chtml endif-->
  13927. This option affects Pine's handling of URLs that are found in 
  13928. messages you read.  Normally, only URLs Pine can handle directly
  13929. are automatically offered for selection in the "Message
  13930. Text" screen.  When one or more applications
  13931. capable of deciphering URLs on their command line are added here, Pine
  13932. will choose the first available to display URLs it cannot handle directly.
  13933. A viewer's availability is based on its being specified with a <B>full
  13934. directory path</B> and the evaluation of any optionally supplied
  13935. parameters described below.
  13936.  
  13937. <P>
  13938. Additionally, to support various connection methods and applications, each
  13939. entry in this list can optionally begin with one or more of
  13940. the following special tokens.  The allowed tokens include:
  13941.  
  13942. <P>
  13943. <DL>
  13944. <DT>_TEST(<VAR>test-string</VAR>)_</DT>
  13945. <DD>
  13946. The <VAR>test-string</VAR> is a shell command that Pine will run to
  13947. evaluate a viewer's availability.  The command specified by the test
  13948. string is run and if its resulting exit status is non-zero, Pine will
  13949. not consider the associated viewer for use.
  13950. </DD>
  13951.  
  13952. <DT>_SCHEME(<VAR>scheme-list</VAR>)_</DT>
  13953. <DD>
  13954. The <VAR>scheme-list</VAR> is a list of one or more (comma-delimited)
  13955. URL schemes that are to be used with the associated viewer.  This is
  13956. the way to configure Pine to recognize URLs other than the built-in set.
  13957. <P>
  13958. It can also be used to override Pine's built-in handlers.
  13959. For example, you could specify "news" in the <VAR>scheme-list</VAR>,
  13960. and Pine would use (provided it passed all other criteria) the associated
  13961. viewer when it encounterd a URL of the form "news:comp.mail.pine".
  13962.  
  13963. </DD>
  13964. </DL>
  13965.  
  13966. <P>
  13967. By default, Pine will simply append a space character followed by the
  13968. selected URL prior to launching the command in your specified SHELL.  You can
  13969. optionally specify where in the command the selected URL should appear
  13970. by using the "_URL_" token.  All occurrences found in the command
  13971. will be replaced with the selected URL before the command is handed
  13972. to the shell.  If such replacement occurs, the default appending of the
  13973. selected URL does not take place.
  13974.  
  13975. <P>
  13976. NOTE: If the viewer you specify has any command-line arguments,
  13977. including the "_URL_" token, you will need to add a
  13978. double-quote character before the command path and after the last
  13979. argument (see the "lynx" example below).
  13980.  
  13981. <P>
  13982. So, here are some example entries:
  13983. <PRE>
  13984. url-viewers = _TEST("test -n '${DISPLAY}'")_  /usr/local/bin/netscape
  13985.               "/usr/local/bin/lynx _URL_"
  13986.               C:\BIN\NETSCAPE.BAT
  13987. </PRE>
  13988. <P>
  13989. This example shows that for the first viewer in the list to be used
  13990. the environment variable "DISPLAY" must be defined.  If it
  13991. is, then the path and file "/usr/local/bin/netscape" must exist.  
  13992. If neither condition is met,
  13993. then the path and file "/usr/local/bin/lynx" must exist.  
  13994. If it does, then the "_URL_" token is replaced by the selected URL. 
  13995. If the path to "lynx" is invalid,
  13996. then the final path and file C:\BIN\NETSCAPE.BAT must exist.  
  13997. Note that the last
  13998. entry is a DOS/Windows path.  This is one way to support Pine running
  13999. on more than one architecture with the same configuration file.<P>
  14000. <P>
  14001. <!--chtml if pinemode="os_windows"-->
  14002. <!--chtml else-->
  14003. Note that depending on the type of browser used and the method of 
  14004. its invocation (such as whether it will open in a separate window) from
  14005. the MESSAGE TEXT screen, the browser may "supplant" 
  14006. the MESSAGE TEXT screen, and you will have to quit the browser to return to 
  14007. it (for example, when using Lynx; to exit Lynx, use the "Q" command).
  14008. In other words, launching the browser from Pine may make Pine 
  14009. "disappear" (although it is still "running")
  14010. until you close the browser again.<P>  
  14011. <UL><LI><A HREF="h_config_browser_xterm">Defining url-viewers in an X windows 
  14012. environment: for advanced users and  systems administrators</A>
  14013. </UL>
  14014. <!--chtml endif-->
  14015. <P>If you are unsure what browsers are available on your system or how to 
  14016. specify them in Pine's url-viewers option for best usability, contact your 
  14017. local computing support staff.
  14018. <P><UL>
  14019. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  14020. </UL>
  14021. <P>
  14022. <End of help on this topic>
  14023. </BODY>
  14024. </HTML>
  14025. ====== h_config_browser_xterm =====
  14026. <HTML>
  14027. <HEAD>
  14028. <TITLE>url-viewers and X windows applications</TITLE>
  14029. </HEAD>
  14030. <BODY>
  14031. <H1>Defining url-viewers in an X windows 
  14032. environment: for advanced users and  systems administrators</H1>
  14033. If you are using Pine with an X-terminal (emulator) and want to define an 
  14034. X windows-based application in url-viewers, 
  14035. you may want to do so in a manner that causes any <B>already</B> 
  14036. invoked viewer application to be used for viewing URLs you select from Pine 
  14037. messages, and a <B>new</B> URL-viewer process to be 
  14038. started <B>only</B> if the same application has <B>not already</B> 
  14039. been launched -- for one reason, to avoid file-locking contentions among 
  14040. multiple invocations of the same URL-viewer application.  
  14041. (The example entries set in the help screen for the "url-viewers" 
  14042. option does not do this.)  A method of doing that would be:<OL>
  14043. <LI> use 
  14044. the _TEST(<VAR>test-string</VAR>)_ token in the <B>first</B> entry to 
  14045. check (using commands appropriate for your Unix shell
  14046. in place of <VAR>test-string</VAR>) for the presence of a 
  14047. lockfile created by the URL-viewer application -- which implies that the 
  14048. application is already running, though this is not foolproof. 
  14049. Following that in the same url-viewers entry, specify the 
  14050. application with its appropriate command line option(s) to 
  14051. show the URL selected from the Pine message in an already open window of 
  14052. that application, or perhaps in a new window of that application.  
  14053.  
  14054. <LI> In the 
  14055. <B>second</B> entry for the url-viewers option, specify the same 
  14056. application without those command line options, but this time using the 
  14057. _TEST(...)_ token to check whether the environment variable "DISPLAY"
  14058. is defined.
  14059. <LI> If you may be using Pine (with the same .pinerc file) outside of the X 
  14060. windows environment (for instance, using VT-100 terminal emulation), you 
  14061. may wish to specify a non-X windows URL-viewer application such as Lynx
  14062. as the last entry.
  14063. </OL><BR>
  14064. How exactly you define your url-viewers entries to do this will depend on 
  14065. the command shell, the URL-viewer application(s), and possibly the specific 
  14066. version of the latter, you are using.  
  14067. <P>
  14068. Relevant command 
  14069. line options for the Netscape browser for showing URLs (selected from Pine) 
  14070. when Netscape is already running are discussed in the document
  14071. "Remote Control of UNIX Netscape" 
  14072. found at the URL (as of 12 Aug. 1998):
  14073. <P>
  14074.  
  14075. <CENTER><A HREF="http://home.netscape.com/newsref/std/x-remote.html">http://home.netscape.com/newsref/std/x-remote.html</A></CENTER>
  14076.  
  14077. <P>(If the URL-viewer application is 
  14078. <B>not</B> running on the same host as Pine, but being launched from an 
  14079. applications server, you may not be able to use the command line options for 
  14080. using an existing invocation of the application in Pine's url-viewers entry.)
  14081. <P>
  14082. <!--chtml if this-method="shown-to-work"-->
  14083. An example using the Korn shell and the Netscape browser (first entry wrapped 
  14084. because of its length, but should all appear on one line):
  14085. <P>
  14086. url-viewers = _TEST("test -L /myhomedir/.netscape/lock")_ "/usr/local/bin/netscape -remote 'openURL(_URL_,  new-window)' &"<BR>
  14087.  
  14088. _TEST("test -n '${DISPLAY}'")_ "/usr/local/bin/netscape &"<BR>
  14089.               "/usr/local/bin/lynx '_URL_'"
  14090. <P>
  14091. <!--chtml endif-->
  14092. <P>
  14093. <UL>   
  14094. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  14095. </UL><P>
  14096. <End of help on this topic>
  14097. </BODY>
  14098. </HTML>
  14099. ====== h_config_enable_full_hdr =====
  14100. <HTML>
  14101. <HEAD>
  14102. <TITLE>FEATURE: enable-full-header-cmd</TITLE>
  14103. </HEAD>
  14104. <BODY>
  14105. <H1>FEATURE: enable-full-header-cmd</H1>
  14106.  
  14107. This feature enables the "H Full Headers" command which toggles between
  14108. the display of all headers in the message and the normal edited view of
  14109. headers.  The Full Header command also controls which headers are included
  14110. for Export, Pipe, Print, Forward, and Reply functions.  (For Reply, the
  14111. Full Header mode will respect the
  14112. <A HREF="h_config_include_header">"include-headers-in-reply"</A>
  14113. feature setting.)
  14114. <P>
  14115. <UL>   
  14116. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  14117. </UL><P>
  14118. <End of help on this topic>
  14119. </BODY>
  14120. </HTML>
  14121. ====== h_config_enable_pipe =====
  14122. <HTML>
  14123. <HEAD>
  14124. <TITLE>FEATURE: enable-unix-pipe-cmd</TITLE>
  14125. </HEAD>
  14126. <BODY>
  14127. <H1>FEATURE: enable-unix-pipe-cmd</H1>
  14128.  
  14129. This feature enables the "| Pipe" command that sends the current message
  14130. to the specified Unix command for external processing.  Not available on
  14131. PC-Pine.
  14132. <P>
  14133.  
  14134. A short description of how the pipe command works is given
  14135. <A HREF="h_pipe_command">here</A>.
  14136.  
  14137. <P>
  14138. <UL>   
  14139. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  14140. </UL><P>
  14141. <End of help on this topic>
  14142. </BODY>
  14143. </HTML>
  14144. ====== h_config_enable_tab_complete =====
  14145.         FEATURE: enable-tab-completion
  14146.  
  14147. This feature enables the TAB key when at a prompt for a filename. In this
  14148. case, TAB will cause the partial name already entered to be automatically
  14149. completed, provided the partial name is unambiguous.
  14150.  
  14151. <End of help on this topic>
  14152. ====== h_config_quit_wo_confirm =====
  14153.          FEATURE: quit-without-confirm
  14154.  
  14155. This feature controls whether or not Pine will ask for confirmation when a
  14156. Quit command is received.
  14157.  
  14158. <End of help on this topic>
  14159. ====== h_config_enable_jump =====
  14160.          FEATURE: enable-jump-shortcut
  14161.  
  14162. Setting this feature will allow you to enter a number (followed by RETURN)
  14163. and jump to that message number, when in the MESSAGE INDEX or MESSAGE TEXT
  14164. screens.  In other words, it obviates the need for typing the "J" for the
  14165. Jump command.
  14166.  
  14167. <End of help on this topic>
  14168. ====== h_config_enable_alt_ed =====
  14169. <HTML>
  14170. <HEAD>
  14171. <TITLE>FEATURE: enable-alternate-editor-cmd</TITLE>
  14172. </HEAD>
  14173. <BODY>
  14174. <H1>FEATURE: enable-alternate-editor-cmd</H1>
  14175.  
  14176. If this feature is set, and the 
  14177. <A HREF="h_config_editor">"editor"</A> option
  14178. <B>is not</B> set, entering
  14179. the ^_ (Ctrl-underscore) key while composing a message will prompt you
  14180. for the name of the editor you would like to use.
  14181. <P>
  14182. If the environment variable $EDITOR is set, its value will be offered as
  14183. a default.
  14184. <P>
  14185. If the <A HREF="h_config_editor">"editor"</A> option
  14186. <B>is</B> set, the ^_ key will activate the specified
  14187. editor without prompting, in which case it is not necessary to
  14188. set the "enable-alternate-editor-cmd" feature.  
  14189. <P>
  14190. <UL>   
  14191. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  14192. </UL><P>
  14193. <End of help on this topic>
  14194. </BODY>
  14195. </HTML>
  14196. ====== h_config_alt_ed_now =====
  14197. <HTML>
  14198. <HEAD>
  14199. <TITLE>FEATURE: enable-alternate-editor-implicitly</TITLE>
  14200. </HEAD>
  14201. <BODY>
  14202. <H1>FEATURE: enable-alternate-editor-implicitly</H1>
  14203.  
  14204. If this feature and the <A HREF="h_config_editor">"editor"</A>
  14205. variable are both set, Pine will
  14206. automatically activate the specified editor when the cursor is moved from
  14207. the header of the message being composed into the message text.  For
  14208. replies, the alternate editor will be activated immediately.  If this
  14209. feature is set but the "editor" variable is not set, then Pine will
  14210. automatically ask for the name of an alternate editor when the cursor
  14211. is moved out of the header being composed, or if a reply is being done.
  14212.  
  14213. <P><UL>
  14214. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  14215. </UL>
  14216. <P>
  14217. <End of help on this topic>
  14218. </BODY>
  14219. </HTML>
  14220. ====== h_config_enable_bounce =====
  14221.          FEATURE: enable-bounce-cmd
  14222.  
  14223. Setting this feature enables the "B Bounce" command, which will prompt
  14224. for an address and *remail* the message to the new recipient.  This command
  14225. is used to re-direct messages that you have received in error, or need to
  14226. be redirected for some other reason (e.g. list moderation).  The final
  14227. recipient will see a header indicating that you have Resent the msg, but
  14228. the message's From: header will show the original author of the message,
  14229. and replies to it will go back to that author, and not to you.
  14230.  
  14231. <End of help on this topic>
  14232. ====== h_config_enable_agg_ops =====
  14233. <HTML>
  14234. <HEAD>
  14235. <TITLE>FEATURE: enable-aggregate-command-set</TITLE>
  14236. </HEAD>
  14237. <BODY>
  14238. <H1>FEATURE: enable-aggregate-command-set</H1>
  14239. Setting this feature enables the commands and subcommands that relate to
  14240. performing operations on more than one message at a time.  We call these
  14241. "aggregate operations".  In particular, the 
  14242. <!--chtml if pinemode="function_key"-->"F5
  14243. <!--chtml else-->";
  14244. <!--chtml endif--> Select", 
  14245.  
  14246. <!--chtml if pinemode="function_key"-->
  14247. "F6
  14248. <!--chtml else-->
  14249. "A 
  14250. <!--chtml endif-->
  14251. Apply", and 
  14252. <!--chtml if pinemode="function_key"-->
  14253. "F4
  14254. <!--chtml else-->
  14255. "Z 
  14256. <!--chtml endif-->
  14257. Zoom" commands are enabled by this feature.  Select is used to
  14258. "tag" one or more messages meeting the specified criteria.  Apply can
  14259. then be used to apply any message command to all of the selected/tagged
  14260. messages.  Further, the Zoom command allows you to toggle the MESSAGE INDEX
  14261. view between just those Selected and all messages in the folder.
  14262. <P>
  14263. This feature also enables the 
  14264. <!--chtml if pinemode="function_key"-->
  14265. "F7" 
  14266. <!--chtml else-->
  14267. "^X" 
  14268. <!--chtml endif-->
  14269.  
  14270. subcommand in the MESSAGE INDEX 
  14271. WhereIs command which causes all messages matching the WhereIs argument to 
  14272. become selected; and the Select, Select Current, and ZoomMode commands in the
  14273. <A HREF="h_folder_maint">FOLDER LIST screen</A>.
  14274. <P>
  14275. <UL>   
  14276. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  14277. </UL><P>
  14278. <End of help on this topic>
  14279. </BODY>
  14280. </HTML>
  14281.  
  14282. ====== h_config_enable_flag =====
  14283.          FEATURE: enable-flag-cmd
  14284.  
  14285. Setting this feature enables the "* Flag" command which allows you to
  14286. manipulate the status flags associated with a message.  By default, Flag
  14287. will set the "Important" flag, which results in an asterisk being
  14288. displayed in column one of the MESSAGE INDEX for such messages.
  14289.  
  14290. <End of help on this topic>
  14291. ====== h_config_flag_screen_default =====
  14292.          FEATURE: enable-flag-screen-implicitly
  14293.  
  14294. The feature modifies the behavior of the "* Flag" command (provided it
  14295. too is enabled).  By default, when the "* Flag" command is selected,
  14296. Pine offers a prompt to set one of several flags and also offers the
  14297. option of entering the detailed flag manipulation screen via the "^T"
  14298. key. Enabling this feature causes Pine to immediately enter the detailed
  14299. flag screen rather than first offer the simple prompt.
  14300.  
  14301. <End of help on this topic>
  14302. ====== h_config_can_suspend =====
  14303. <HTML>
  14304. <HEAD>
  14305. <TITLE>FEATURE: enable-suspend</TITLE>
  14306. </HEAD>
  14307. <BODY>
  14308. <H1>FEATURE: enable-suspend</H1>
  14309.  
  14310. Setting this feature will allow you to type ^Z (Control Z) to 
  14311. <!--chtml if pinemode="os_windows"-->
  14312. minimize Pine into its icon, bringing into focus whatever
  14313. application is running behind the PC-Pine window.
  14314. <!--chtml else-->
  14315. temporarily suspend Pine.
  14316.  
  14317. <P>
  14318. This does not exit Pine, but puts it in the background to watch
  14319. for new mail and such.  Normally, you type a command, such
  14320. as "fg" at your system prompt to return to your Pine session.
  14321.  
  14322. <P>
  14323. The <A HREF="h_config_suspend_spawns">use-subshell-for-suspend</A> feature
  14324. adjusts whether Pine is placed into the background of the shell its 
  14325. running in or starts a news shell.
  14326. <!--chtml endif-->
  14327.  
  14328. <P>
  14329. <UL>   
  14330. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  14331. </UL><P>
  14332. <End of help on this topic>
  14333. </BODY>
  14334. </HTML>
  14335. ====== h_config_take_lastfirst ======
  14336.          FEATURE: disable-take-last-comma-first
  14337.  
  14338. Normally, when TakeAddr is used to copy an address from a message into
  14339. an address book entry, Pine will attempt to rewrite the full name of the
  14340. address in the form
  14341.  
  14342.        Last, First
  14343.  
  14344. instead of
  14345.  
  14346.        First Last
  14347.  
  14348. It does this because many people find it useful to sort by Last name instead
  14349. of First name.  If this feature is set, then the TakeAddr command will
  14350. not attempt to reverse the name in this manner.
  14351.  
  14352. <End of help on this topic>
  14353. ====== h_config_print_from ======
  14354.          FEATURE: print-includes-from-line
  14355.  
  14356. If this feature is set, then the Berkeley-mail style From line is included
  14357. at the start of each message that is printed.  This line looks something
  14358. like the following, with the address replaced by the address from the
  14359. From line of the message being printed:
  14360.  
  14361.    From user@domain.somewhere.com Mon May 13 14:11:06 1998
  14362.  
  14363. <End of help on this topic>
  14364. ====== h_config_expanded_distlists ======
  14365.          FEATURE: expanded-view-of-distribution-lists
  14366.  
  14367. If this feature is set, then distribution lists in the address book
  14368. screen will always be expanded automatically.
  14369.  
  14370. <End of help on this topic>
  14371. ====== h_config_compose_news_wo_conf ======
  14372.          FEATURE: compose-sets-newsgroup-without-confirm
  14373.  
  14374. This feature controls one aspect of Pine's Composer.  If you enter the
  14375. composer while reading a newsgroup, you will normally be prompted to
  14376. determine whether you intend the new message to be posted to the current
  14377. newsgroup or not.  If this feature is set, Pine will not prompt you
  14378. in this situation, and will assume that you do indeed wish to post
  14379. to the newsgroup you are reading.
  14380.  
  14381. <End of help on this topic>
  14382. ====== h_config_compose_rejects_unqual ======
  14383. <HTML>
  14384. <HEAD>
  14385. <TITLE>FEATURE: compose-rejects-unqualified-addrs</TITLE>
  14386. </HEAD>
  14387. <BODY>
  14388. <H1>FEATURE: compose-rejects-unqualified-addrs</H1>
  14389.  
  14390. This feature controls one aspect of the message composer; in particular,
  14391. what happens when an unqualified name is entered into an address header.
  14392. If set, unqualified names entered as addresses will be treated as errors
  14393. unless they match an addressbook nickname.  Pine will not attempt to turn
  14394. them into complete addresses by adding your local domain.<P>
  14395.  
  14396. A complete (fully qualified) address is one containing a username followed
  14397. by an "@" ("at") symbol, followed by a domain name (e.g.
  14398. "jsmith@nowhere.edu").  An unqualified name is one <B>without</B> 
  14399. the "@" symbol and domain name (e.g. "jsmith"). 
  14400.  
  14401. (See also <A HREF="h_address_format">Explanation of Address formats</A>.)
  14402.  
  14403. <P>
  14404.  
  14405. When you enter a fully qualified address, Pine does not interpret or
  14406. modify it, but simply passes it on to the mail-transport-agent (MTA) for
  14407. your system.  Pine conforms to the Internet standards governing message
  14408. headers and will not send an unqualifed name to the MTA.  Therefore, when
  14409. you enter an unqualified name, Pine will normally attempt to turn it into
  14410. a fully qualified address, first by checking to see if you have entered a
  14411. matching nickname in your addressbook, or failing that, by simply adding
  14412. your own domain to the name entered.  So if your address is
  14413. "jsmith@nowhere.edu" and you enter "fred", then (assuming 
  14414. "fred" is not a nickname in your addressbook), Pine will turn 
  14415. that into "fred@nowhere.edu".<P>
  14416.  
  14417. There are situations where it is not desirable for Pine to interpret such
  14418. unqualified names as valid (local) addresses.  For example, if "fred"
  14419. turned out to be a typo (intended to be an addressbook nickname), but
  14420. there actually was a "fred" in your local domain, the message might 
  14421. be mis-delivered without your realizing it.  In order to reduce the likelihood
  14422. of such accidents, setting this feature will cause Pine to treat such
  14423. addresses as errors, and require that you explicitly enter the full local
  14424. address (e.g. "fred@nowhere.edu") or correct the name so that it 
  14425. matches an address book nickname.<P>
  14426.  
  14427. Consider this a safety feature against mis-directed mail.
  14428. <P>
  14429. <UL>   
  14430. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  14431. </UL><P>
  14432. <End of help on this topic>
  14433. </BODY>
  14434. </HTML>
  14435. ====== h_config_quell_local_lookup ======
  14436. <HTML>
  14437. <HEAD>
  14438. <TITLE>FEATURE: quell-user-lookup-in-passwd-file</TITLE>
  14439. </HEAD>
  14440. <BODY>
  14441. <H1>FEATURE: quell-user-lookup-in-passwd-file</H1>
  14442.  
  14443. This feature controls an aspect of Pine's Composer, and if needed, will
  14444. usually be set by your system manager in Pine's system-wide configuration
  14445. file. Specifically, if this feature is set, Pine will not attempt to look
  14446. in the system password file to find a Full Name for the entered address.
  14447. <P>
  14448. Normally, names you enter into address fields (e.g. To: or Cc:) are
  14449. checked against your address book(s) to see if they match an address book
  14450. nickname.  Failing that, (in Unix Pine) the name is then checked against
  14451. the Unix password file.  If the entered name matches a username in the
  14452. system password file, Pine extracts the corresponding Full Name information
  14453. for that individual, and adds that to the address being entered.
  14454. <P>
  14455. However, password file matching can have surprising (incorrect) results if
  14456. other users of the system do not receive mail at the domain you are using.
  14457. That is, if either the 
  14458. <A HREF="h_config_user_dom">"user-domain"</A> or 
  14459. <A HREF="h_config_domain_name">"use-only-domain-name"</A>
  14460. option
  14461. is set such that the administrative domain of other users on the system
  14462. isn't accurately reflected, Pine should be told that a passwd file match
  14463. is coincidental, and Full Name info will be incorrect.  For example, a
  14464. personal name from the password file could get falsely paired with the
  14465. entered name as it is turned into an address in the configured domain.
  14466. <P>
  14467. If you are seeing this behavior, enabling this feature will prevent Unix
  14468. Pine from looking up names in the password file to find the Full Name
  14469. for incomplete addresses you enter.<P>
  14470. <UL>
  14471. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  14472. </UL>
  14473. <P>
  14474. <End of help on this topic>
  14475. </BODY>
  14476. </HTML>
  14477. ====== h_config_preserve_start_stop ======
  14478.          FEATURE: preserve-start-stop-characters
  14479.  
  14480. This feature controls how special control key characters, typically
  14481. Ctrl-S and Ctrl-Q, are interpreted when input to Pine.  These characters
  14482. are known as the "start" and "stop" characters and are sometimes used in
  14483. communications paths to control data flow between devices that operate at
  14484. different speeds.
  14485.  
  14486. By default, Pine turns the system's handling of these special characters
  14487. off except during printing.  However, if you see Pine reporting input errors
  14488. such as:
  14489.  
  14490.             [ Command "^Q" not defined for this screen. ]
  14491.  
  14492. and, at the same time, see your display become garbled, then it is likely
  14493. that setting this option will solve the problem.  Be aware, though, that
  14494. enabling this feature will also cause Pine to ostensibly "hang" 
  14495. whenever the Ctrl-S key combination is entered as the system is now
  14496. interpreting such input as a "stop output" command.  To "start
  14497. output"  again, simply type Ctrl-Q. 
  14498.  
  14499. <End of help on this topic>
  14500. ====== h_config_enable_incoming ======
  14501. <HTML>
  14502. <HEAD>
  14503. <TITLE>FEATURE: enable-incoming-folders</TITLE>
  14504. </HEAD>
  14505. <BODY>
  14506. <H1>FEATURE: enable-incoming-folders</H1>
  14507.  
  14508. Pine's Incoming Message Folders collection
  14509. provides a convenient way to access multiple incoming folders.
  14510. It is also useful if you have accounts on multiple computers.
  14511. <P>
  14512.  
  14513. If set, this feature defines a pseudo-folder collection called
  14514. "INCOMING MESSAGE FOLDERS".  Initially, the only folder included
  14515. in this collection will be your INBOX, which will no longer show up in
  14516. your Default folder collection.
  14517. <P>
  14518.  
  14519. You may add more folders to the Incoming Message Folders collection by
  14520. using the
  14521. <!--chtml if pinemode="function_key"-->
  14522. "F10
  14523. <!--chtml else-->
  14524. "A
  14525. <!--chtml endif-->
  14526. Add" command in the FOLDER LIST screen.  You will be prompted for
  14527. the host the folder is stored on (which defaults to the same host used
  14528. for your INBOX), a nickname, and the actual folder name.  Once a set
  14529. of Incoming Message Folders are defined, the TAB key (in MESSAGE INDEX
  14530. or MESSAGE TEXT screens) may be used to scan the folders for those
  14531. with Recent messages.  If you add more folders to
  14532. your Incoming-Folders collection, turning this feature back off will have
  14533. no effect.
  14534. <P>
  14535. NOTE: Normally the software which actually delivers mail (the stuff that happens
  14536. before Pine is involved) is in a better position to do delivery filtering
  14537. than is Pine itself.
  14538. If possible, you may want to look at programs such as
  14539. "filter" or "procmail", which are examples of delivery
  14540. filtering programs.
  14541. If you'd prefer to have Pine do the filtering for you, you may set that
  14542. up.
  14543. Look <A HREF="h_rules_filter">here</A> for help with Pine filtering.
  14544. <P>
  14545. <UL>   
  14546. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  14547. </UL><P>
  14548. <End of help on this topic>
  14549. </BODY>
  14550. </HTML>
  14551. ====== h_config_attach_in_reply ======
  14552.          FEATURE: include-attachments-in-reply
  14553.  
  14554. This feature controls an aspect of Pine's Reply command. If set, any MIME
  14555. attachments that were part of the original message will automatically be
  14556. included in the Reply.
  14557.  
  14558. <End of help on this topic>
  14559. ====== h_config_include_header =====
  14560.          FEATURE: include-header-in-reply
  14561.  
  14562. This feature controls an aspect of Pine's Reply command. If set, and the
  14563. original message is being included in the reply, then headers from that
  14564. message will also be part of the reply.
  14565.  
  14566. <End of help on this topic>
  14567. ====== h_config_sig_at_bottom =====
  14568.         FEATURE: signature-at-bottom
  14569.  
  14570. This feature controls an aspect of Pine's Reply command.  If this feature
  14571. is set, and the original message is being included in the reply, then the
  14572. contents of your signature file (if any) will be inserted after the included
  14573. message.
  14574.  
  14575. This feature does not affect the results of a Forward command.
  14576.  
  14577. <End of help on this topic>
  14578. ====== h_config_sigdashes =====
  14579. <HTML>
  14580. <HEAD>
  14581. <TITLE>FEATURE: enable-sigdashes</TITLE>
  14582. </HEAD>
  14583. <BODY>
  14584. <H1>FEATURE: enable-sigdashes</H1>
  14585.  
  14586. This feature enables support for the common USENET news convention 
  14587. of preceding a message signature with the special line consisting of 
  14588. the three characters "-- " (i.e., dash, dash, and space).
  14589.  
  14590. <P>
  14591. When enabled and a
  14592. "<A HREF="h_config_signature_file">signature-file</A>" exists,
  14593. Pine will insert the special line before including the file's text (unless
  14594. the special line already exists somewhere in the file's text).
  14595.  
  14596. <P>
  14597. In addition, when you Reply or Followup to a message containing one of
  14598. these special lines and choose to include its text, Pine will observe
  14599. the convention of not including text beyond the special line in your
  14600. reply.
  14601.  
  14602. <P>
  14603. See also "<a href="h_config_strip_sigdashes">strip-from-sigdashes-on-reply</a>"
  14604. for a related feature.
  14605.  
  14606. <P>
  14607. <UL>   
  14608. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  14609. </UL><P>
  14610. <End of help on this topic>
  14611. </BODY>
  14612. </HTML>
  14613. ====== h_config_strip_sigdashes =====
  14614. <HTML>
  14615. <HEAD>
  14616. <TITLE>FEATURE: strip-from-sigdashes-on-reply</TITLE>
  14617. </HEAD>
  14618. <BODY>
  14619. <H1>FEATURE: strip-from-sigdashes-on-reply</H1>
  14620.  
  14621. This feature doesn't do anything if the feature
  14622. "<A HREF="h_config_sigdashes">enable-sigdashes</A>" is turned on.
  14623. However, if the "enable-sigdashes" feature is not turned on,
  14624. then turning on this feature enables support for the convention
  14625. of not including text beyond the sigdashes line when Replying or Following
  14626. up to a message and including the text of that message.
  14627. <P>
  14628. In other words, this is a way to turn on the signature stripping behavior
  14629. without also turning on the dashes-adding behavior.
  14630. <P>
  14631. <UL>   
  14632. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  14633. </UL><P>
  14634. <End of help on this topic>
  14635. </BODY>
  14636. </HTML>
  14637. ====== h_config_sub_lists =====
  14638. <HTML>
  14639. <HEAD>
  14640. <TITLE>FEATURE: enable-partial-match-lists</TITLE>
  14641. </HEAD>
  14642. <BODY>
  14643. <H1>FEATURE: enable-partial-match-lists</H1>
  14644.  
  14645. This feature affects the subcommands available when Saving, 
  14646. or when Opening a new folder. If set, the subcommand ^X ListMatches will be
  14647. available. This command allows you to type in a substring of the folder
  14648. you are looking for and when you type ^X it will display all folders
  14649. which contain that substring in their names.
  14650.  
  14651. <P>
  14652. <End of help on this topic>
  14653. </BODY>
  14654. </HTML>
  14655. ====== h_config_use_sender_not_x =====
  14656. <HTML>
  14657. <HEAD>
  14658. <TITLE>FEATURE: use-sender-not-X-Sender</TITLE>
  14659. </HEAD>
  14660. <BODY>
  14661. <H1>FEATURE: use-sender-not-X-Sender</H1>
  14662.  
  14663. Normally Pine adds a header line labeled X-Sender, if the sender is
  14664. different from the From: line.  The standard specifies that this header
  14665. line should be labeled Sender, not X-Sender.  Setting this feature causes
  14666. Sender to be used instead of X-Sender.
  14667.  
  14668. <P>
  14669. <End of help on this topic>
  14670. </BODY>
  14671. </HTML>
  14672. ====== h_config_use_fk =====
  14673. <HTML>
  14674. <HEAD>
  14675. <TITLE>FEATURE: use-function-keys</TITLE>
  14676. </HEAD>
  14677. <BODY>
  14678. <H1>FEATURE: use-function-keys</H1>
  14679.  
  14680. This feature specifies that Pine will respond to function keys instead of
  14681. the normal single-letter commands. In this mode, the key menus at the
  14682. bottom of each screen will show function key designations instead of the
  14683. normal mnemonic key.
  14684.  
  14685. <P>
  14686. <End of help on this topic>
  14687. </BODY>
  14688. </HTML>
  14689. ====== h_config_compose_maps_del =====
  14690. <HTML>
  14691. <HEAD>
  14692. <TITLE>FEATURE: compose-maps-delete-key-to-ctrl-d</TITLE>
  14693. </HEAD>
  14694. <BODY>
  14695. <H1>FEATURE: compose-maps-delete-key-to-ctrl-d</H1>
  14696.  
  14697. This feature affects the behavior of the DELETE key.
  14698. If set, Delete will be equivalent to ^D, and delete
  14699. the current character.  Normally Pine defines the Delete key
  14700. to be equivalent to ^H, which deletes the <EM>previous</EM>
  14701. character.
  14702.  
  14703. <P>
  14704. <End of help on this topic>
  14705. </BODY>
  14706. </HTML>
  14707. ====== h_config_compose_bg_post =====
  14708. <HTML>
  14709. <HEAD>
  14710. <TITLE>FEATURE: enable-background-sending</TITLE>
  14711. </HEAD>
  14712. <BODY>
  14713. <H1>FEATURE: enable-background-sending</H1>
  14714.  
  14715. This feature affects the behavior of Pine's mail sending.  If set, this
  14716. feature enables a subcommand in the composer's "Send?" confirmation
  14717. prompt.  The subcommand allows you to tell Pine to handle the actual
  14718. posting in the background.  While this feature usually allows posting
  14719. to appear to happen very fast, it has no affect on the actual delivery
  14720. time it takes a message to arrive at its destination.
  14721.  
  14722. <P>
  14723. Please Note:
  14724. OL>
  14725.  <LI>This feature isn't supported on all systems.  All DOS and Windows,
  14726.        as well as several Unix ports, do not recognize this feature.
  14727.  <LI>Error handling is significantly different when this feature is
  14728.         enabled.  Any message posting failure results in the message
  14729.         being appended to your "Interrupted" mail folder.  When you
  14730.         type the <A HREF="h_common_compose">C</A>ompose command,
  14731.     Pine will notice this folder and
  14732.         offer to extract any messages contained.  Upon continuing a 
  14733.         failed message, Pine will display the nature of the failure 
  14734.         in the status message line.
  14735.  <LI> <EM>WARNING</EM>: Under extreme conditions, it is possible
  14736.     for message data to
  14737.         get lost.  <EM>Do</EM> <EM>not</EM> enable this feature
  14738.     if you typically run close to any sort of disk-space limits or quotas.
  14739. </OL>
  14740. <P>
  14741. <End of help on this topic>
  14742. </BODY>
  14743. </HTML>
  14744. ====== h_config_compose_dsn =====
  14745. <HTML>
  14746. <HEAD>
  14747. <TITLE>FEATURE: enable-delivery-status-notification</TITLE>
  14748. </HEAD>
  14749. <BODY>
  14750. <H1>FEATURE: enable-delivery-status-notification</H1>
  14751.  
  14752. This feature affects the behavior of Pine's mail sending.  If set, this
  14753. feature enables a subcommand in the composer's "Send?" confirmation
  14754. prompt.  The subcommand allows you to tell Pine to request the type of
  14755. Delivery Status Notification (DSN) which you would like.  Most users will
  14756. be happy with the default, and need not enable this feature.
  14757.  
  14758. <P>
  14759. Turning on this feature and then turning on the DSNOpts from the send
  14760. prompt reveals four on-off toggles at the bottom of the screen.
  14761. The "X" command toggles between NoErrRets and ErrRets.  NoErrRets requests
  14762. that no notification be returned to you, even if there is a delivery
  14763. failure.  The "D" key toggles between Delay and NoDelay.  This tells the
  14764. server that you are willing (or not) to receive delay notifications, which
  14765. happen when there is an unusual delay at some mail server (in that mail
  14766. server's opinion).  The "S" key toggles between Success and NoSuccess.
  14767. Success requests that you be sent a DSN message when the message is
  14768. successfully delivered to the recipients mailbox.  Setting NoErrRets will
  14769. automatically turn off Delay and Success notification, and will flip the
  14770. toggles to show that.  Similarly, turning on Delay and/or Success will
  14771. automatically toggle the "X" key to ErrRets.  The fourth command, the
  14772. "H" key, toggles between RetHdrs and RetFull.  RetFull requests that
  14773. the full message be returned in any failed DSN.  RetHdrs requests that
  14774. only the headers be returned in any failed DSN.  Notice that this command
  14775. applies only to failed delivery status reports.  For delay or success
  14776. reports, the full message is never returned, only the headers are returned.
  14777.  
  14778. <P>
  14779. If you don't enable the DSN feature or if you don't turn it on for a
  14780. particular message, the default is that you will be notified about failures,
  14781. you might be notified about delays, and you won't be notified about
  14782. successes.  You will usually receive the full message back when there is
  14783. a failure.
  14784.  
  14785. <P>
  14786. If you turn on the DSNOpts the default is to return as much information as
  14787. possible to you.  That is, by default, the Success and Delay options are
  14788. turned on and the full message will be returned on failure.
  14789.  
  14790. <P>
  14791. The sending prompt will display the current DSN request (if any) in a
  14792. shorthand form.  It will be:
  14793.  
  14794. <P><CENTER>[Never]</CENTER>
  14795.  
  14796. <P>
  14797. if you have requested NoErrRets.  Otherwise, it will look something like:
  14798.  
  14799. <P><CENTER>[FDS-Hdrs]</CENTER>
  14800.  
  14801. <P>
  14802. The "F" will always be there, indicating that you will be notified
  14803. of failures.  (Pine doesn't provide a way to request no failure notification
  14804. and at the same time request either success or delay notification.  The only
  14805. way to request no failure notifications is to request no notifications at
  14806. all with NoErrRets.)  The "D" and/or "S" will be present if you have
  14807. requested Delay and/or Success notification.  If one of those is missing,
  14808. that means you are requesting no notification of the corresponding type.
  14809. After the dash it will say either Hdrs or Full.  Hdrs means to return only
  14810. the headers and Full means to return the full message (applies to
  14811. failure notifications only).
  14812.  
  14813. <P>
  14814. NOTE: This feature relies on your system's mail transport agent or
  14815. configured "smtp-server" having the negotiation mechanism introduced in
  14816. "Extended SMTP" (ESMTP) and the specific extension called
  14817. "Delivery Status Notification" (DSN).  If the mail tranport agent you
  14818. are using doesn't support DSN, a short warning will be shown to you on
  14819. the message line at the bottom of the screen after you send your message,
  14820. but your message will have been sent anyway.
  14821.  
  14822. <P>
  14823. Note that DSNs don't provide a mechanism to request read receipts.  That
  14824. is, if you request notification on success you are notified when the
  14825. message is delivered to the mailbox, not when the message is read.
  14826.  
  14827. <P>
  14828. ESMTP allows for graceful migration to upgraded mail transfer agents, but
  14829. it is possible that this feature might cause problems for some servers. 
  14830.  
  14831. <P>
  14832. <End of help on this topic>
  14833. </BODY>
  14834. </HTML>
  14835. ====== h_config_auto_zoom =====
  14836. <HTML>
  14837. <HEAD>
  14838. <TITLE>FEATURE: auto-zoom-after-select</TITLE>
  14839. </HEAD>
  14840. <BODY>
  14841. <H1>FEATURE: auto-zoom-after-select</H1>
  14842.  
  14843. This feature affects the behavior of the Select command.
  14844. If set, the select command will automatically perform a zoom
  14845. after the select is complete.
  14846.  
  14847. <P>
  14848. <End of help on this topic>
  14849. </BODY>
  14850. </HTML>
  14851. ====== h_config_auto_unzoom =====
  14852. <HTML>
  14853. <HEAD>
  14854. <TITLE>FEATURE: auto-unzoom-after-apply</TITLE>
  14855. </HEAD>
  14856. <BODY>
  14857. <H1>FEATURE: auto-unzoom-after-apply</H1>
  14858.  
  14859. This feature affects the behavior of the Apply command.  If set, and if
  14860. you are currently looking at a Zoomed Index view of selected messages,
  14861. the Apply command will do the operation you specify, but then will
  14862. implicitly do an "UnZoom", so that you will automatically be back in
  14863. the normal Index view after the Apply. 
  14864.  
  14865. <P>
  14866. <End of help on this topic>
  14867. </BODY>
  14868. </HTML>
  14869. ====== h_config_fast_recent =====
  14870. <HTML>
  14871. <HEAD>
  14872. <TITLE>FEATURE: enable-fast-recent-test</TITLE>
  14873. </HEAD>
  14874. <BODY>
  14875. <H1>FEATURE: enable-fast-recent-test</H1>
  14876.  
  14877. This feature controls the behavior of the TAB key when traversing folders
  14878. in the optional 
  14879. <A HREF="h_config_enable_incoming">"incoming-folders" collection</A> 
  14880. or in optional news-collections.
  14881.  
  14882. <P>
  14883. When the TAB (Next New) key is pressed, the default behavior is to
  14884. explicitly examine the status of the folder for the number of recent
  14885. messages (messages delivered since the last time it was viewed).
  14886. Depending on the size and number of messages in the folder, this test
  14887. can be time consuming.
  14888.  
  14889. <P>
  14890. Enabling this feature will cause Pine to only test for the existence of
  14891. any recent messages rather than the obtain the count.  This is much faster
  14892. in many cases.  The downside is that you're not given the number of recent
  14893. messages when prompted to view the next folder.
  14894.  
  14895. <P>
  14896. <UL>   
  14897. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  14898. </UL><P>
  14899. <End of help on this topic>
  14900. </BODY>
  14901. </HTML>
  14902. ====== h_config_arrow_nav =====
  14903. <HTML>
  14904. <HEAD>
  14905. <TITLE>FEATURE: enable-arrow-navigation</TITLE>
  14906. </HEAD>
  14907. <BODY>
  14908. <H1>FEATURE: enable-arrow-navigation</H1>
  14909.  
  14910. This feature controls the behavior of the left and right arrow keys.
  14911. If set, the left and right arrow keys will operate like the usual
  14912. navigation keys < and >.
  14913.  
  14914. <P>
  14915. If you set this feature, and do not like the changed behavior of the up/down 
  14916. arrow 
  14917. keys when navigating through the FOLDER LIST screen -- 
  14918. <B>first</B> from column to column, if more than one folder is 
  14919. displayed per row, 
  14920. and <B>then</B> from row to row -- you may either also wish to set the feature 
  14921. "<A HREF="h_config_relaxed_arrow_nav">enable-arrow-navigation-relaxed</A>", 
  14922. "<A HREF="h_config_single_list">single-column-folder-list</A>", or
  14923. use the ^P/^N (instead of up/down arrow) keys to move up/down the list of 
  14924. folders in each column.
  14925. <P>
  14926. <UL>   
  14927. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  14928. </UL><P>
  14929. <End of help on this topic>
  14930. </BODY>
  14931. </HTML>
  14932. ====== h_config_relaxed_arrow_nav =====
  14933. <HTML>
  14934. <HEAD>
  14935. <TITLE>FEATURE: enable-arrow-navigation-relaxed</TITLE>
  14936. </HEAD>
  14937. <BODY>
  14938. <H1>FEATURE: enable-arrow-navigation-relaxed</H1>
  14939.  
  14940. This feature controls the behavior of the left, right, up and down
  14941. arrow keys in the FOLDER LIST screen when the "<A
  14942. HREF="h_config_arrow_nav">enable-arrow-navigation</A>" feature is
  14943. enabled.
  14944.  
  14945. <P>
  14946. Normally, when the "enable-arrow-navigation" feature is set,
  14947. the left and right arrow keys in the Folder List screen strictly
  14948. track the commands bound to the '<' and '>' keys, and the up
  14949. and down arrow keys move the hilite bar to the previous and next
  14950. folder or directory name.
  14951.  
  14952. <P>
  14953.  
  14954. When enabled, this feature returns the left, right, up and down
  14955. arrow keys' functionality in the FOLDER LIST screen to what it was
  14956. before enabling
  14957. "enable-arrow-navigation".  In other words, left and right
  14958. arrows move the hilite bar to the left or right, and the up and
  14959. down arrows move it up or down.
  14960.  
  14961.  
  14962. <P>
  14963. <UL>   
  14964. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  14965. </UL><P>
  14966. <End of help on this topic>
  14967. </BODY>
  14968. </HTML>
  14969. ====== h_config_del_from_dot =====
  14970. <HTML>
  14971. <HEAD>
  14972. <TITLE>FEATURE: compose-cut-from-cursor</TITLE>
  14973. </HEAD>
  14974. <BODY>
  14975. <H1>FEATURE: compose-cut-from-cursor</H1>
  14976.  
  14977. This feature controls the behavior of the Ctrl-K command in the composer.
  14978. If set, ^K will cut from the current cursor position to the end of the line,
  14979. rather than cutting the entire line.
  14980.  
  14981. <P>
  14982. <End of help on this topic>
  14983. </BODY>
  14984. </HTML>
  14985. ====== h_config_print_index =====
  14986. <HTML>
  14987. <HEAD>
  14988. <TITLE>FEATURE: print-index-enabled</TITLE>
  14989. </HEAD>
  14990. <BODY>
  14991. <H1>FEATURE: print-index-enabled</H1>
  14992.  
  14993. This feature controls the behavior of the Print command when in the
  14994. MESSAGE INDEX screen.  If set, the print command will give you a prompt
  14995. asking if you wish to print the message index, or the currently highlighted
  14996. message. If not set, the message will be printed.
  14997.  
  14998. <P>
  14999. <End of help on this topic>
  15000. </BODY>
  15001. </HTML>
  15002. ====== h_config_allow_talk =====
  15003. <HTML>
  15004. <HEAD>
  15005. <TITLE>FEATURE: allow-talk</TITLE>
  15006. </HEAD>
  15007. <BODY>
  15008. <H1>FEATURE: allow-talk</H1>
  15009.  
  15010. By default, permission for others to "talk" to your terminal is turned
  15011. off when you are running Pine.  When this feature is set, permission is
  15012. instead turned on.  If enabled, you may see unexpected messages in the
  15013. middle of your Pine screen from someone attempting to contact you via the
  15014. "talk" program.
  15015.  
  15016. <P>
  15017. NOTE: The "talk" program has nothing to do with Pine or email.  The 
  15018. talk daemon on your system will attempt to print a message on your screen 
  15019. when someone else is trying to contact you.  If you wish to see these
  15020. messages while you are running Pine, you should enable this feature.
  15021.  
  15022. <P>
  15023. If you do enable this feature and see a "talk" message, you must 
  15024. suspend or quit Pine before you can respond.
  15025.  
  15026. <P>
  15027. <End of help on this topic>
  15028. </BODY>
  15029. </HTML>
  15030. ====== h_config_send_filter_dflt =====
  15031. <HTML>
  15032. <HEAD>
  15033. <TITLE>FEATURE: compose-send-offers-first-filter</TITLE>
  15034. </HEAD>
  15035. <BODY>
  15036. <H1>FEATURE: compose-send-offers-first-filter</H1>
  15037. If you have <A HREF="h_config_sending_filter">"sending-filters"</A> 
  15038. configured, setting this feature will cause
  15039. the first filter in the sending-filters list to be offered as the default
  15040. instead of unfiltered, the usual default.
  15041. <P>
  15042. <UL>   
  15043. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  15044. </UL><P>
  15045. <End of help on this topic>
  15046. </BODY>
  15047. </HTML>
  15048. ====== h_config_custom_print =====
  15049.         FEATURE: print-offers-custom-cmd-prompt
  15050.  
  15051. When this feature is set, the print command will have an additional
  15052. subcommand called "C CustomPrint".  If selected, you will have
  15053. the opportunity to enter any system print command --instead of being 
  15054. restricted to using those that have been previously configured in the 
  15055. printer setup menu.
  15056.  
  15057. <End of help on this topic>
  15058. ====== h_config_enable_dot_files =====
  15059.         FEATURE: enable-dot-files
  15060.  
  15061. When this feature is set, files beginning with dot (".") will be
  15062. visible in the file browser.  For example, you'll be able to select them
  15063. when using the browser to add an attachment to a message.
  15064.  
  15065. <End of help on this topic>
  15066. ====== h_config_enable_dot_folders =====
  15067.         FEATURE: enable-dot-folders
  15068.  
  15069. When this feature is set, folders beginning with dot (".") may be added
  15070. and viewed.
  15071.  
  15072. <End of help on this topic>
  15073. ====== h_config_ff_between_msgs =====
  15074.         FEATURE: print-formfeed-between-messages
  15075.  
  15076. Setting this feature causes a formfeed to be printed between messages when
  15077. printing multiple messages (with Apply Print command).
  15078.  
  15079. <End of help on this topic>
  15080. ====== h_config_blank_keymenu =====
  15081.         FEATURE: disable-keymenu
  15082.  
  15083. If this feature is set the command key menu that normally appears on the
  15084. bottom two lines of the screen will not usually be there.  Asking for
  15085. help with ^G or ? will cause the key menu to appear instead of causing
  15086. the help message to come up.  If you want to actually see the help text,
  15087. another ^G or ? will show it to you.  After the key menu has popped
  15088. up with the help key it will remain there for an O for Other command but
  15089. disappear if any other command is typed.
  15090.  
  15091. <End of help on this topic>
  15092. ====== h_config_enable_mouse =====
  15093.         FEATURE: enable-mouse-in-xterm
  15094.  
  15095. This feature controls whether or not an X terminal mouse can be used with
  15096. Pine.  If set, and the $DISPLAY variable indicates that an X terminal is
  15097. being used, the left mouse button on the mouse can be used to select text
  15098. or commands.
  15099.  
  15100. Note: if this feature is set, the behavior of X terminal cut-and-paste is
  15101. also modified.  It is necessary to hold the shift key down while clicking
  15102. left or middle mouse buttons for the normal xterm cut/paste operations. 
  15103.  
  15104. <End of help on this topic>
  15105. ====== h_config_enable_xterm_newmail =====
  15106.         FEATURE: enable-newmail-in-xterm-icon
  15107.  
  15108. This feature controls whether or not Pine will attempt to announce new
  15109. mail arrival when it is running in an X terminal window and that window
  15110. is iconified.  If set, and the $DISPLAY variable indicates that an X
  15111. terminal is being used, Pine will send appropriate escape sequences to
  15112. the X terminal to modify the label on Pine's icon to indicate that new
  15113. mail has arrived. 
  15114.  
  15115. <End of help on this topic>
  15116. ====== h_config_prefix_editing =====
  15117. <HTML>
  15118. <HEAD>
  15119. <TITLE>FEATURE: enable-reply-indent-string-editing</TITLE>
  15120. </HEAD>
  15121. <BODY>
  15122. <H1>FEATURE: enable-reply-indent-string-editing</H1>
  15123.  
  15124. This feature affects the Reply command's "Include original message
  15125. in Reply?" prompt.  When enabled, it causes the
  15126. "Edit Indent String" sub-command to appear which allows 
  15127. you to edit the string Pine would otherwise use to denote included 
  15128. text from the message being replied to.<P>
  15129.  
  15130. Thus, you can change Pine's default message quote character (usually
  15131. an angle bracket) on a per message basis. So you could change your quoted message to
  15132. look, for example, like this:<p>
  15133.  
  15134. <pre>On Tues, 26 Jan 1999, John Q. Smith wrote:
  15135.  
  15136. John: I just wanted to say hello and to congratulate you
  15137. John: on a job well done!</pre><p>
  15138.  
  15139. The configuration option
  15140. <A HREF="h_config_reply_indent_string">"Reply-Indent-String"</A>
  15141. may be used to change what appears as the default string to be edited.
  15142. <P>
  15143. NOTE: Edited reply-indent-strings only apply to the message
  15144. currently being replied to.
  15145. <P>
  15146. <UL>   
  15147. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  15148. </UL><P>
  15149. <End of help on this topic>
  15150. </BODY>
  15151. </HTML>
  15152. ====== h_config_enable_search_and_repl =====
  15153.         FEATURE: enable-search-and-replace
  15154.  
  15155. This feature modifies the behavior of Pine's composer.  Setting this
  15156. feature causes Pine to offer the "^R Replace" subcommand, which
  15157. allows you to search and replace text strings in a message you are composing, 
  15158. inside the "^W Where is" command.  
  15159.  
  15160. To search and replace text, first enter the text to be replaced at the 
  15161. "Search: " prompt.  Then, rather than pressing Enter to just search for that
  15162. text, press ^R, which turns the prompt into 
  15163.  
  15164. Search (to replace): 
  15165.  
  15166. and then press Enter.  The cursor will highlight the first occurrence 
  15167. of the text string you entered, and the prompt will show: 
  15168.  
  15169. Replace "<your text string>" with : 
  15170.  
  15171. where <your text string> is what you entered at the previous prompt;
  15172. here, enter the replacement text.  To only replace the highlighted 
  15173. occurrence, simply press Enter now; to replace all occurrences in the 
  15174. message, press ^X (Repl All), then Enter.  You will then be asked to confirm 
  15175. each replacement.
  15176.  
  15177. The command ^R toggles between "Replace" and "Don't Replace"; its subcommand
  15178. ^X toggles between "Replace All" and "Replace One."
  15179.  
  15180. If you previously searched for text in a message, it will be offered for 
  15181. reuse as part of the prompt, shown in [ ] brackets.
  15182.  
  15183. <End of help on this topic>
  15184. ====== h_config_enable_view_attach =====
  15185.         FEATURE: enable-msg-view-attachments
  15186.  
  15187. This feature modifies the behavior of Pine's MESSAGE TEXT screen.
  15188. Setting this feature causes Pine to present attachments in boldface.
  15189. The first available attachment is displayed in inverse.  This is the
  15190. "selected" attachment.  Pressing RETURN will cause Pine to display
  15191. the selected attachment.  Use the arrow keys to change which of the
  15192. attachments displayed in boldface is the current selection.
  15193.  
  15194. Speaking of arrow keys, the Up and Down Arrows will select the next
  15195. and previous attachments if one is available on the screen for selection.
  15196. Otherwise, they will simply adjust the viewed text one line up or down.
  15197.  
  15198. Similarly, when selectable items are present in a message, the Ctrl-F
  15199. key can be used to select the next item in the message independent
  15200. of which portion of the viewed message is currently displayed. The
  15201. Ctrl-B key can be used to select the previous item in the same way.
  15202.  
  15203. <End of help on this topic>
  15204. ====== h_config_enable_y_print =====
  15205.         FEATURE: enable-print-via-y-command
  15206.  
  15207. This feature modifies the behavior of Pine's Print command.
  15208.  
  15209. By default, Pine's print command is available by pressing the "%" key.  
  15210. (This command is a substantial change from Pine versions before 4.00 -- 
  15211. where the print command was "Y" -- based on numerous complaints about 
  15212. printing being invoked inadvertently, since Y also means "Yes.")  
  15213.  
  15214. This feature is supplied to mitigate any disruption or anxiety users 
  15215. might feel as a result of this change.  
  15216.  
  15217. Enabling this feature will cause Pine to recognize both the old
  15218. command, "Y" for Prynt, as well the new "%" method for invoking
  15219. printing.  Note, key menu labels are not changed as a result of
  15220. enabling this feature.
  15221.  
  15222. <End of help on this topic>
  15223. ====== h_config_enable_lessthan_exit =====
  15224.         FEATURE: enable-exit-via-lessthan-command
  15225.  
  15226. If this feature is set, then on screens where there is an Exit command
  15227. but no < command, the < key will perform the same function as the Exit
  15228. command.
  15229.  
  15230. <End of help on this topic>
  15231. ====== h_config_enable_view_url =====
  15232. <HTML>
  15233. <HEAD>
  15234. <TITLE>FEATURE: enable-msg-view-urls</TITLE>
  15235. </HEAD>
  15236. <BODY>
  15237. <H1>FEATURE: enable-msg-view-urls</H1>
  15238. This feature modifies the behavior of Pine's MESSAGE TEXT screen.
  15239. Setting this feature causes Pine to select possible URLs from the
  15240. displayed text and display them in boldface for selection.
  15241. <P>
  15242. The first available URL is displayed in inverse.  This is the
  15243. "selected" URL.  Pressing RETURN will cause Pine to display
  15244. the selected URL via either built-in means as with mailto:, imap:,
  15245. news:, and nntp:, or via an external application as defined
  15246. by the <A HREF="h_config_browser">"url-viewer"</A> 
  15247. variable.
  15248. <P>
  15249. Use the arrow keys to change which of the URLs displayed in boldface
  15250. is the current selection.
  15251. <P>
  15252. Speaking of arrow keys, the Up and Down Arrows will select the next
  15253. and previous URL if one is available on the screen for selection (unless 
  15254. you have set the feature 
  15255. <A HREF="h_config_enable_view_arrows">"enable-msg-view-forced-arrows"</A>).
  15256. Otherwise, they will simply adjust the viewed text one line up or down.
  15257. <P>
  15258. Similarly, when selectable items are present in a message, the Ctrl-F
  15259. key can be used to select the next item in the message independent
  15260. of which portion of the viewed message is currently displayed. The
  15261. Ctrl-B key can be used to select the previous item in the same way.
  15262. <P>
  15263. <UL>   
  15264. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  15265. </UL><P>
  15266. <End of help on this topic>
  15267. </BODY>
  15268. </HTML>
  15269. ====== h_config_enable_view_web_host =====
  15270. <HTML>
  15271. <HEAD>
  15272. <TITLE>FEATURE: enable-msg-view-web-hostnames</TITLE>
  15273. </HEAD>
  15274. <BODY>
  15275. <H1>FEATURE: enable-msg-view-web-hostnames</H1>
  15276.  
  15277. This feature modifies the behavior of Pine's MESSAGE TEXT screen.
  15278. Setting this feature causes Pine to select possible web hostnames
  15279. from the displayed text and display them in boldface for selection.  
  15280. This can be useful when you receive messages referencing World Wide Web 
  15281. sites without the use of complete URLs; for example, specifying only 
  15282. "www.washington.edu/pine/" (which will <B>not</B> become a 
  15283. selectable 
  15284. item by setting <A HREF="h_config_enable_view_url">"enable-msg-view-urls"</A>) 
  15285. rather than explicitly
  15286. "http://www.washington.edu/pine/".  
  15287. <P>
  15288. The first available hostname is displayed in inverse.  This is the
  15289. "selected" hostname.  Pressing RETURN will cause Pine to display
  15290. the selected hostname via an external application as defined
  15291. by the <A HREF="h_config_browser">"url-viewer"</A> 
  15292. variable.
  15293. <P>
  15294. Use the arrow keys (unless you have set the feature 
  15295. <A HREF="h_config_enable_view_arrows">"enable-msg-view-forced-arrows"</A>) 
  15296. to change which of the hostnames displayed in
  15297. boldface is the current selection.
  15298. <P>
  15299. Similarly, when selectable web hostnames are present in a message, the Ctrl-F
  15300. key can be used to select the next web hostname in the message independent
  15301. of which portion of the viewed message is currently displayed. The
  15302. Ctrl-B key can be used to select the previous web hostnames in the same way.
  15303. <P>
  15304. <UL>   
  15305. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  15306. </UL><P>
  15307. <End of help on this topic>
  15308. </BODY>
  15309. </HTML>
  15310. ====== h_config_enable_view_addresses =====
  15311. <HTML>
  15312. <HEAD>
  15313. <TITLE>FEATURE: enable-msg-view-addresses</TITLE>
  15314. </HEAD>
  15315. <BODY>
  15316. <H1>FEATURE: enable-msg-view-addresses</H1>
  15317.  
  15318. This feature modifies the behavior of Pine's MESSAGE TEXT screen.
  15319. Setting this feature causes Pine to select possible email addresses
  15320. from the displayed text and display them in boldface for selection.  
  15321.  
  15322. <P>
  15323. The first available email address is displayed in inverse.  This is the
  15324. "selected" address.  Pressing RETURN will cause Pine to enter
  15325. the message composition screen with the To: field filled in with the
  15326. selected address.
  15327. <P>
  15328. Use the arrow keys (unless you have set the feature 
  15329. <A HREF="h_config_enable_view_arrows">"enable-msg-view-forced-arrows"</A>) 
  15330. to change which of the hostnames displayed in
  15331. boldface is the current selection.
  15332. <P>
  15333. Similarly, when selectable web hostnames are present in a message, the Ctrl-F
  15334. key can be used to select the next web hostname in the message independent
  15335. of which portion of the viewed message is currently displayed. The
  15336. Ctrl-B key can be used to select the previous web hostnames in the same way.
  15337. <P>
  15338. <UL>   
  15339. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  15340. </UL><P>
  15341. <End of help on this topic>
  15342. </BODY>
  15343. </HTML>
  15344. ====== h_config_enable_view_arrows =====
  15345.         FEATURE: enable-msg-view-forced-arrows
  15346.  
  15347. This feature modifies Up and Down arrow key behavior in Pine's
  15348. MESSAGE TEXT screen when selectable Attachments, URL's, or
  15349. web-hostnames are presented. Pine's usual behavior is to move to
  15350. the next or previous selectable item if currently displayed or
  15351. simply to adjust the screen view by one line.
  15352.  
  15353. Setting this feature causes the UP and Down arrow key to behave as
  15354. if no selectable items were present in the message.
  15355.  
  15356. Note, the Ctrl-F (next selectable item) and Ctrl-B (previous selectable
  15357. item) functionality is unchanged.
  15358.  
  15359. <End of help on this topic>
  15360. ====== h_config_pass_control =====
  15361.         FEATURE: pass-control-characters-as-is
  15362.  
  15363. This feature controls how certain characters contained in messages are
  15364. displayed.  If set, all characters in a message will be sent to the
  15365. screen.  Normally, control characters are automatically suppressed in
  15366. order to avoid inadvertently changing terminal setup parameters.
  15367.  
  15368. <End of help on this topic>
  15369. ====== h_config_fcc_on_bounce =====
  15370.         FEATURE: fcc-on-bounce
  15371.  
  15372. This feature controls an aspect of Pine's behavior when bouncing a
  15373. message. If set, normal FCC ("File Carbon Copy") processing will be
  15374. done, just as if you had composed a message to the address you are
  15375. bouncing to.  If not set, no FCC of the message will be saved. 
  15376.  
  15377. <End of help on this topic>
  15378. ====== h_config_show_cursor =====
  15379.         FEATURE: show-cursor
  15380.  
  15381. This feature controls an aspect of Pine's displays.  If set, the system
  15382. cursor will move to convenient locations in the displays.  For example,
  15383. to the beginning of the status field of the highlighted index line, or
  15384. to the highlighted word after a successful WhereIs command.  It is intended
  15385. to draw your attention to an "interesting" spot on the screen.
  15386.  
  15387. <End of help on this topic>
  15388. ====== h_config_single_list =====
  15389.         FEATURE: single-column-folder-list
  15390.  
  15391. This feature controls an aspect of Pine's FOLDER LIST screen.  If set,
  15392. the folders will be listed one per line instead of several per line
  15393. in the FOLDER LIST display.
  15394.  
  15395. <End of help on this topic>
  15396. ====== h_config_vertical_list =====
  15397.         FEATURE: vertical-folder-list
  15398.  
  15399. This feature controls an aspect of Pine's FOLDER LIST screen.  If set,
  15400. the folders will be listed alphabetically down the columns rather
  15401. than across the columns as is the default.
  15402.  
  15403. <End of help on this topic>
  15404. ====== h_config_verbose_post =====
  15405. <HTML>
  15406. <HEAD>
  15407. <TITLE>FEATURE: enable-verbose-smtp-posting</TITLE>
  15408. </HEAD>
  15409. <BODY>
  15410. <H1>FEATURE: enable-verbose-smtp-posting</H1>
  15411. This feature controls an aspect of Pine's message sending.  When enabled,
  15412. Pine will send a VERB (i.e., VERBose) command early in the posting process
  15413. intended to cause the SMTP server to provide a more detailed account of
  15414. the transaction.  This feature is typically only useful to system
  15415. administrators and other support personel as an aid in troublshooting
  15416. problems.
  15417. <P>
  15418. Note, this feature relies on a specific capability of the system's mail
  15419. transport agent or configured 
  15420. <A HREF="h_config_smtp_server">"smtp-server"</A>.  
  15421. It is possible that this
  15422. feature will cause problems for some tranport agents, and may result in
  15423. sending failure.  In addition, as the verbose output comes from the mail
  15424. transport agent, it is likely to vary from one system to another. 
  15425. <P><UL>
  15426. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  15427. </UL><P>
  15428. <End of help on this topic>
  15429. </BODY>
  15430. </HTML>
  15431. ====== h_config_auto_reply_to =====
  15432.         FEATURE: reply-always-uses-reply-to
  15433.  
  15434. This feature controls an aspect of Pine's Reply command.  If set, Pine
  15435. will not prompt when a message being replied to contains a "Reply-To:"
  15436. header value, but will simply use its value (as opposed to using the
  15437. "From:" field's value).
  15438.  
  15439. Note: Using the "Reply-To:" address is usually the preferred behavior,
  15440. however, some mailing list managers choose to place the list's address in
  15441. the "Reply-To:" field of any message sent out to the list.  In such
  15442. cases, this feature makes it all too easy for personal replies to be
  15443. inadvertently sent to the entire mail list, so be careful! 
  15444.  
  15445. <End of help on this topic>
  15446. ====== h_config_del_skips_del =====
  15447.         FEATURE: delete-skips-deleted
  15448.  
  15449. This feature controls an aspect of Pine's Delete command.  If set, this
  15450. feature will cause the Delete command to advance past other messages that
  15451. are marked deleted.  In other words, pressing "D" will both mark the
  15452. current message deleted and advance to the next message that is not marked
  15453. deleted.
  15454.  
  15455. <End of help on this topic>
  15456. ====== h_config_auto_expunge =====
  15457. <HTML>
  15458. <HEAD>
  15459. <TITLE>FEATURE: expunge-without-confirm</TITLE>
  15460. </HEAD>
  15461. <BODY>
  15462. <H1>FEATURE: expunge-without-confirm</H1>
  15463. This features controls an aspect of Pine's eXpunge command.  If set, you
  15464. will <B>not</B> be prompted to confirm your intent before the expunge takes 
  15465. place.
  15466. Actually, this is only true for the INBOX folder and for folders in the
  15467. Incoming Folders collection. See the feature
  15468. <A HREF="h_config_full_auto_expunge">"expunge-without-confirm-everywhere"</A>.
  15469. <P>
  15470. <UL>   
  15471. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  15472. </UL><P>
  15473. <End of help on this topic>
  15474. </BODY>
  15475. </HTML>
  15476. ====== h_config_full_auto_expunge =====
  15477. <HTML>
  15478. <HEAD>
  15479. <TITLE>FEATURE: expunge-without-confirm-everywhere</TITLE>
  15480. </HEAD>
  15481. <BODY>
  15482. <H1>FEATURE: expunge-without-confirm-everywhere</H1>
  15483. This features controls an aspect of Pine's eXpunge command.  If set, you
  15484. will <B>not</B> be prompted to confirm your intent before the expunge 
  15485. takes place.  This feature sets this behavior for all folders, unlike the
  15486. <A HREF="h_config_auto_expunge">"expunge-without-confirm"</A>
  15487. feature which works only for incoming folders.
  15488. <P>
  15489. <UL>   
  15490. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  15491. </UL><P>
  15492. <End of help on this topic>
  15493. </BODY>
  15494. </HTML>
  15495. ====== h_config_auto_read_msgs =====
  15496. <HTML>
  15497. <HEAD>
  15498. <TITLE>FEATURE: auto-move-read-msgs</TITLE>
  15499. </HEAD>
  15500. <BODY>
  15501. <H1>FEATURE: auto-move-read-msgs</H1>
  15502. This feature controls an aspect of Pine's behavior upon quitting.  If set,
  15503. and the 
  15504. <A HREF="h_config_read_message_folder">"read-message-folder"</A>
  15505. option is also set, then Pine will
  15506. automatically transfer all read messages to the designated folder and mark
  15507. them as deleted in the INBOX.  Messages in the INBOX marked with an 
  15508. "N" (meaning New, or unseen) are not affected.
  15509. <P>
  15510. <UL>   
  15511. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  15512. </UL><P>
  15513. <End of help on this topic>
  15514. </BODY>
  15515. </HTML>
  15516. ====== h_config_auto_fcc_only =====
  15517. <HTML>
  15518. <HEAD>
  15519. <TITLE>FEATURE: fcc-only-without-confirm</TITLE>
  15520. </HEAD>
  15521. <BODY>
  15522. <H1>FEATURE: fcc-only-without-confirm</H1>
  15523. This features controls an aspect of Pine's composer.
  15524. The only time this feature will be used is if you attempt to send mail
  15525. which has no recipients but does have an Fcc.
  15526. Normally, Pine will ask if you really mean to copy the message only to
  15527. the Fcc.
  15528. That is, it asks if you really meant to have no recipients.
  15529. If this feature is set, you
  15530. will <B>not</B> be prompted to confirm your intent to make only a copy
  15531. of a message with no recipients.
  15532. <P>
  15533. <UL>   
  15534. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  15535. </UL><P>
  15536. <End of help on this topic>
  15537. </BODY>
  15538. </HTML>
  15539. ====== h_config_no_fcc_attach =====
  15540. <HTML>
  15541. <HEAD>
  15542. <TITLE>FEATURE: fcc-without-attachments</TITLE>
  15543. </HEAD>
  15544. <BODY>
  15545. <H1>FEATURE: fcc-without-attachments</H1>
  15546.  
  15547. This features controls the way FCC's (File Carbon Copies) are
  15548. made of the messages you send.
  15549.  
  15550. <P>
  15551. Normally, Pine saves an exact copy of your message as it was sent.
  15552. When this feature is enabled, the "body" of the message
  15553. you send (the text you type in the composer) is preserved in the 
  15554. copy as before, however all attachments are replaced with text
  15555. explaining what had been sent rather than the attachments themselves.
  15556.  
  15557. <P>
  15558. This feature also affects Pine's "Send ?" confirmation prompt
  15559. in that a new "^F Fcc Attchmnts" option becomes available which
  15560. allows you to interactively set whether or not attachments are saved
  15561. to the Fcc'd copy.
  15562.  
  15563. <P>
  15564. <UL>   
  15565. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  15566. </UL><P>
  15567. <End of help on this topic>
  15568. </BODY>
  15569. </HTML>
  15570. ====== h_config_read_in_newsrc_order =====
  15571. <HTML>
  15572. <HEAD>
  15573. <TITLE>FEATURE: news-read-in-newsrc-order</TITLE>
  15574. </HEAD>
  15575. <BODY>
  15576. <H1>FEATURE: news-read-in-newsrc-order</H1>
  15577. This feature controls the order in which newsgroups will be presented.  If
  15578. set, they will be presented in the same order as they occur in your 
  15579. <!--chtml if pinemode="os_windows"-->
  15580. "NEWSRC"
  15581. <!--chtml else-->
  15582. ".newsrc"
  15583. <!--chtml endif-->
  15584. file (the default location of which can be changed with the 
  15585. <A HREF="h_config_newsrc_path">"newsrc-path"</A> option).  
  15586. <P>
  15587. If not set, the newsgroups will be presented in alphabetical order.
  15588. <P>
  15589. <UL>   
  15590. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  15591. </UL><P>
  15592. <End of help on this topic>
  15593. </BODY>
  15594. </HTML>
  15595. ====== h_config_post_wo_validation =====
  15596.         FEATURE: news-post-without-validation
  15597.  
  15598. This feature controls whether the NNTP server is queried as newsgroups
  15599. are entered for posting.  Validation over slow links (e.g. dialup using
  15600. SLIP or PPP) can cause delays.  Set this feature to eliminate such delays.
  15601.  
  15602. <End of help on this topic>
  15603. ====== h_config_confirm_role =====
  15604. <HTML>
  15605. <HEAD>
  15606. <TITLE>FEATURE: confirm-role-even-for-default</TITLE>
  15607. </HEAD>
  15608. <BODY>
  15609. <H1>FEATURE: confirm-role-even-for-default</H1>
  15610.  
  15611. If you have roles, when you Reply to or Forward a message, or Compose
  15612. a new message, Pine
  15613. will search through your roles for one which matches.
  15614. Normally, if no matches are found you will be placed into the composer
  15615. with no opportunity to select a role.
  15616. If this feature is set, then you will be asked to confirm that you don't
  15617. want a role.
  15618. This will give you the opportunity to select a role (with the ^T command).
  15619. If you confirm no role with a Return, you will be placed in
  15620. the composer with no role.
  15621. You may also confirm with either an "N" or a "Y".
  15622. These behave the same as if you pressed the Return.
  15623. (The "N" and "Y" answers are available because they
  15624. match what you might type if there was a role match.)
  15625. <P>
  15626. If you are using the alternate form of the Compose command called
  15627. "Role", then all of your roles will be available to you,
  15628. independent of the value of this feauture and of the values set for all of
  15629. Reply Use, Forward Use, and Compose Use.
  15630. <P>
  15631. <UL>   
  15632. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  15633. </UL><P>
  15634. <End of help on this topic>
  15635. </BODY>
  15636. </HTML>
  15637. ====== h_config_news_cross_deletes =====
  15638. <HTML>
  15639. <HEAD>
  15640. <TITLE>FEATURE: news-deletes-across-groups</TITLE>
  15641. </HEAD>
  15642. <BODY>
  15643. <H1>FEATURE: news-deletes-across-groups</H1>
  15644.  
  15645. This feature controls what Pine does when you delete a message in a
  15646. newsgroup that appears in more than one newsgroup.  Such a message
  15647. is sometimes termed a "crossposting" in that it was posted
  15648. across several newsgroups.
  15649.  
  15650. <P>
  15651. Pine's default behavior when you delete such a message is to remove
  15652. only the copy in the current newsgroup from view when you use the
  15653. "Exclude" command or the next time you visit the newsgroup.
  15654.  
  15655. <P>
  15656. Enabling this feature causes Pine to remove every occurrence of the
  15657. message from all newsgroups it appears in and to which you are
  15658. subscribed.
  15659.  
  15660. <P>
  15661. NOTE: As currently implemented, enabling this feature may increase the
  15662. time it takes the Expunge command and newsgroup closing to complete.
  15663.  
  15664. <P>
  15665. <UL>   
  15666. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  15667. </UL><P>
  15668. <End of help on this topic>
  15669. </BODY>
  15670. </HTML>
  15671. ====== h_config_news_catchup =====
  15672. <HTML>
  15673. <HEAD>
  15674. <TITLE>FEATURE: news-offers-catchup-on-close</TITLE>
  15675. </HEAD>
  15676. <BODY>
  15677. <H1>FEATURE: news-offers-catchup-on-close</H1>
  15678.  
  15679. This feature controls what Pine does as it closes a newsgroup.
  15680. When set, Pine will offer to delete all messages from the newsgroup
  15681. as you are quitting Pine or opening a new folder.
  15682.  
  15683. <P>
  15684. This feature is useful if you typically read all the interesting messages
  15685. in a newsgroup each time you open it.  This feature saves you from
  15686. having to delete each message in a newsgroup as you read it or from
  15687. selecting all the messages and doing an
  15688. <A HREF="h_config_enable_agg_ops">aggregate delete</A> before you
  15689. move on to the next folder or newsgroup.
  15690.  
  15691. <P>
  15692. <UL>   
  15693. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  15694. </UL><P>
  15695. <End of help on this topic>
  15696. </BODY>
  15697. </HTML>
  15698. ====== h_config_select_wo_confirm =====
  15699.         FEATURE: select-without-confirm
  15700.  
  15701. This feature controls an aspect of Pine's Save, Export, and Goto commands.
  15702. These commands all take text input to specify the name of the folder or
  15703. file to be used, but allow you to press ^T for a list of possible names.
  15704. If set, the selected name will be used immediately, without further
  15705. opportunity to confirm or edit the name.
  15706.  
  15707. <End of help on this topic>
  15708. ====== h_config_use_current_dir =====
  15709. <HTML>
  15710. <HEAD>
  15711. <TITLE>FEATURE: use-current-dir</TITLE>
  15712. </HEAD>
  15713. <BODY>
  15714. <H1>FEATURE: use-current-dir</H1>
  15715.  
  15716. This feature controls an aspect of several commands. 
  15717. If set, your "current working directory" 
  15718. <!--chtml if pinemode="running"-->
  15719. (which, at least for your current Pine "session," 
  15720. is "<!--#echo var="CURRENT_DIR"-->") 
  15721. <!--chtml endif-->
  15722. will be used instead of your home directory 
  15723. <!--chtml if pinemode="running"-->
  15724. (which, in the present configuration of your system, is
  15725.  "<!--#echo var="HOME_DIR"-->") 
  15726. <!--chtml endif-->
  15727. for all of the following operations:<UL>
  15728.     <LI> Export in the MESSAGE INDEX and MESSAGE TEXT screens
  15729.     <LI> Attachment Save in the MESSAGE TEXT and ATTACHMENT TEXT screens
  15730.     <LI> <!--chtml if pinemode="function_key"-->F4
  15731.          <!--chtml else-->Ctrl-R
  15732.          <!--chtml endif--> file inclusion in the COMPOSER
  15733.     <LI> <!--chtml if pinemode="function_key"-->F5
  15734.          <!--chtml else-->Ctrl-J
  15735.          <!--chtml endif--> file attachment in the COMPOSER
  15736. </UL>
  15737. <!--chtml if pinemode="os_windows"-->
  15738. <P>
  15739. If you are starting PC-Pine from a desktop icon or the Start menu, 
  15740. you can set the "current drive" 
  15741. by specifying it in the "Start in:" 
  15742. box found in the Shortcut tab of the Properties.  
  15743. <!--chtml endif-->
  15744. <P>
  15745. <UL>   
  15746. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  15747. </UL>
  15748.  
  15749. <P>
  15750. <End of help on this topic>
  15751. </BODY>
  15752. </HTML>
  15753. ====== h_config_save_wont_delete =====
  15754. <HTML>
  15755. <HEAD>
  15756. <TITLE>FEATURE: save-will-not-delete</TITLE>
  15757. </HEAD>
  15758. <BODY>
  15759. <H1>FEATURE: save-will-not-delete</H1>
  15760.  
  15761. This feature controls one aspect of the Save command.  If set, Save will
  15762. not mark the message "deleted" (its default behavior) after
  15763. it has been copied to the designated folder.
  15764.  
  15765. <P>
  15766. <End of help on this topic>
  15767. </BODY>
  15768. </HTML>
  15769. ====== h_config_save_advances =====
  15770. <HTML>
  15771. <HEAD>
  15772. <TITLE>FEATURE: save-will-advance</TITLE>
  15773. </HEAD>
  15774. <BODY>
  15775. <H1>FEATURE: save-will-advance</H1>
  15776.  
  15777. This feature controls one aspect of the Save command.  If set, Save will
  15778. (in addition to copying the current message to the designated folder) also
  15779. advance to the next message.
  15780.  
  15781. <P>
  15782. <End of help on this topic>
  15783. </BODY>
  15784. </HTML>
  15785. ====== h_config_force_low_speed =====
  15786. <HTML>
  15787. <HEAD>
  15788. <TITLE>FEATURE: assume-slow-link</TITLE>
  15789. </HEAD>
  15790. <BODY>
  15791. <H1>FEATURE: assume-slow-link</H1>
  15792.  
  15793. This feature affects Pine's display routines.  If set, the normal
  15794. inverse-video cursor (used to highlight the current item in a list) will be
  15795. replaced by an "arrow" cursor and other
  15796. screen update optimizations for
  15797. low-speed links (e.g. 2400 bps dialup connections) will be activated.
  15798.  
  15799. <P>
  15800. <End of help on this topic>
  15801. </BODY>
  15802. </HTML>
  15803. ====== h_config_show_delay_cue =====
  15804. <HTML>
  15805. <HEAD>
  15806. <TITLE>FEATURE: enable-mail-check-cue</TITLE>
  15807. </HEAD>
  15808. <BODY>
  15809. <H1>FEATURE: enable-mail-check-cue</H1>
  15810.  
  15811. If set, this feature will cause an asterisk to appear in the upper
  15812. left-hand corner of the screen whenever Pine checks for new mail.
  15813. Two asterisks whenever Pine saves (checkpoints) the state of the current
  15814. mailbox to disk.
  15815.  
  15816. <!--chtml if pinemode="os_windows"-->
  15817. <P>
  15818. In addtion, PC-Pine will display a less-than symbol, '<', when 
  15819. it is trying to open a network connection (e.g, to open your INBOX
  15820. on an IMAP
  15821. server) or read from the network connection.  A greater-than symbol,
  15822. will be displayed when PC-Pine is trying to write to the network
  15823. connection (e.g, sending a command to your IMAP server).
  15824. <!--chtml endif-->
  15825.  
  15826. <P>
  15827. <End of help on this topic>
  15828. </BODY>
  15829. </HTML>
  15830. ====== h_config_color_style =====
  15831. <HTML>
  15832. <HEAD>
  15833. <TITLE>OPTION: Color-Style</TITLE>
  15834. </HEAD>
  15835. <BODY>
  15836. <H1>OPTION: Color-Style</H1>
  15837.  
  15838. If the terminal or terminal emulator you are using is capable of displaying
  15839. colors, this option controls whether or not color will be used in Pine.
  15840. If you turn color on and things are set up correctly,
  15841. you should see color appear on the screen immmediately.
  15842. Modern terminal emulators are usually capable of displaying colors.
  15843. <P>
  15844. The available options include:
  15845. <P>
  15846.  
  15847. <DL>
  15848. <DT>no-color</DT>
  15849. <DD>Don't use color.
  15850. </DD>
  15851.  
  15852. <DT>use-termdef</DT>
  15853. <DD>In order to decide if your terminal is capable of color, Pine looks in
  15854. the terminal capabilities database, TERMINFO or TERMCAP, depending on
  15855. how Pine was compiled.
  15856. This is a good option to choose if you switch between a color and a non-color
  15857. terminal with the same Pine configuration.
  15858. Pine will know to use color on the color terminal because it is described
  15859. in the termcap entry, and Pine will know to use black and white on the
  15860. non-color terminal.
  15861. The Pine Technical Notes
  15862. <CENTER><SAMP><A HREF="http://www.washington.edu/pine/tech-notes/">http://www.washington.edu/pine/tech-notes/</A></SAMP></CENTER>
  15863. have more information on configuring a TERMCAP or TERMINFO
  15864. entry for color Pine.
  15865. This is usually something a system administrator does.
  15866. </DD>
  15867.  
  15868. <DT>force-ansi-8color</DT>
  15869. <DD>Because setting up a termcap entry is confusing and because the
  15870. terminal capabilities database is often not correctly configured for color,
  15871. this choice and the next may be easier for you to use.
  15872. If your terminal emulator responds to ANSI color escape sequences, which
  15873. many do, this option will cause Pine to believe your terminal will respond
  15874. to the escape sequences which produce eight different foreground and background
  15875. colors.
  15876. The escape sequences used to set the foreground colors are
  15877.  
  15878.   <P><CENTER>ESC [ 3 <color_number> m</CENTER><P>
  15879.  
  15880. where the color_number is an ASCII digit between 0 and 7.
  15881. The numbers 0 through 7 should correspond to the colors black, red, green,
  15882. yellow, blue, magenta, cyan, and white.
  15883. Some terminal emulators use a pre-ANSI scheme which swaps
  15884. the colors blue and red and the colors yellow and cyan.
  15885. This will cause the default colors to be different, but other than that
  15886. things should work fine.
  15887. The escape sequences used to set the background colors are the same
  15888. as for the foreground colors except a "4" replaces the "3".
  15889. </DD>
  15890.  
  15891. <DT>force-ansi-16color</DT>
  15892. <DD>Many terminal emulators know about the same eight colors above
  15893. plus eight more.
  15894. This option attempts to use all 16 colors.
  15895. The same escape sequences as for the eight-color terminal are used
  15896. for the first eight colors.
  15897. The escape sequences used to set foreground colors 8-15 are the same as
  15898. for 0-7 except the "3" is replaced with a "9".
  15899. The background color sequences for colors 8-15 are the same as for 0-7
  15900. except the "4" is replaced with "10".
  15901. You can tell if the 16 colors are working by turning on this option
  15902. and then going into one of the color configuration screens, for example,
  15903. the configuration screen for Normal Color.
  15904. If you see 16 different colors to select from, it's working.
  15905. </DD>
  15906. </DL>
  15907.  
  15908. <P>
  15909. The normal default is "no-color".
  15910. <P>
  15911.  
  15912. Once you've turned on color you may set the
  15913. colors of many objects on the screen individually.
  15914. For example, you may add colors to the status letters on the MESSAGE
  15915. INDEX page.
  15916. Most categories of color which Pine supports are configurable here.
  15917. For example, "Normal Color"
  15918. is the color used to display most of the text in Pine, and
  15919. "Reverse Color" is used to display highlighted text, such as the
  15920. current message in the MESSAGE INDEX.
  15921. <P>
  15922. Lines in the MESSAGE INDEX may also be colored.
  15923. Use Setup Rules to get to the Indexcolor configuration screen.
  15924. <P>
  15925.  
  15926. <UL>   
  15927. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  15928. </UL><P>
  15929. <End of help on this topic>
  15930. </BODY>
  15931. </HTML>
  15932. ====== h_config_auto_open_unread =====
  15933. <HTML>
  15934. <HEAD>
  15935. <TITLE>FEATURE: auto-open-next-unread</TITLE>
  15936. </HEAD>
  15937. <BODY>
  15938. <H1>FEATURE: auto-open-next-unread</H1>
  15939.  
  15940. This feature controls the behavior of the TAB key when traversing folders
  15941. in the optional 
  15942. <A HREF="h_config_enable_incoming">"incoming-folders" collection</A> 
  15943. or in optional news-collections.
  15944. <P>
  15945. When the TAB (Next New) key is pressed, and there
  15946. are no more unseen messages in the current (incoming message or news)
  15947. folder, Pine will search the list of folders in the current collection for
  15948. one containing New or Recent (new since the last time the folder was
  15949. opened) messages.  Normally, when such a folder is found, Pine will ask
  15950. whether you wish to open the folder.  If this feature is set, Pine will
  15951. automatically open the folder without prompting.<P>
  15952.  
  15953. <UL>   
  15954. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  15955. </UL><P>
  15956. <End of help on this topic>
  15957. </BODY>
  15958. </HTML>
  15959. ====== h_config_auto_include_reply =====
  15960.          FEATURE: include-text-in-reply
  15961.  
  15962. This feature controls an aspect of Pine's Reply command.  Normally, Pine
  15963. will ask whether you wish to include the original message in your reply.
  15964. If this feature is set, the original message will be included in the reply
  15965. automatically, without prompting.
  15966.  
  15967. <End of help on this topic>
  15968. ====== h_config_select_in_bold =====
  15969. <HTML>
  15970. <HEAD>
  15971. <TITLE>FEATURE: show-selected-in-boldface</TITLE>
  15972. </HEAD>
  15973. <BODY>
  15974. <H1>FEATURE: show-selected-in-boldface</H1>
  15975.  
  15976. This feature controls an aspect of Pine's 
  15977. <A HREF="h_config_enable_agg_ops">"aggregate operation"</A>
  15978. commands; in
  15979. particular, the Select and WhereIs commands. Select and WhereIs (with the
  15980. ^X subcommand) will search the current folder for messages meeting a
  15981. specified criteria, and "tag" the resulting messages with an 
  15982. "X" in the
  15983. first column of the applicable lines in the MESSAGE INDEX.  If this feature
  15984. is set, instead of using the "X" to denote a selected message, 
  15985. Pine will
  15986. attempt to display those index lines in boldface. Whether this is
  15987. preferable to the "X" will depend on personal taste and the type of
  15988. terminal being used.
  15989. <P>
  15990. <UL>   
  15991. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  15992. </UL><P>
  15993. <End of help on this topic>
  15994. </BODY>
  15995. </HTML>
  15996. ====== h_config_alt_auth =====
  15997. <HTML>
  15998. <HEAD>
  15999. <TITLE>FEATURE: try-alternative-authentication-driver-first</TITLE>
  16000. </HEAD>
  16001. <BODY>
  16002. <H1>FEATURE: try-alternative-authentication-driver-first</H1>
  16003.  
  16004. This feature controls how Pine provides authentication credentials
  16005. to the IMAP server you are connecting to.  Normally, Pine and the server
  16006. negotiate the most secure method to exchange such information.
  16007.  
  16008. <P>
  16009. However, some methods aren't available for negotiation, and thus
  16010. require pre-configuration (typically, per server) on Pine's part.
  16011. This feature allows Pine to implicitly try an alternative to the
  16012. default methods that may have been added to Pine when it was built.
  16013.  
  16014. <P>
  16015. <UL>   
  16016. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  16017. </UL><P>
  16018. <End of help on this topic>
  16019. </BODY>
  16020. </HTML>
  16021. ====== h_config_file_dir ======
  16022. <HTML>
  16023. <HEAD>
  16024. <TITLE>OPTION: file-directory</TITLE>
  16025. </HEAD>
  16026. <BODY>
  16027. <H1>OPTION: file-directory</H1>
  16028.  
  16029. This value affects the Composer's "^J Attach" command, 
  16030. the Attachment Index Screen's "S Save" command, and the
  16031. Message Index's "E Export" command.
  16032.  
  16033. <P>
  16034. Normally, when a filename is supplied that lacks a leading "path"
  16035. component, Pine assumes the file exists in the user's home directory.
  16036. Under Windows operating systems, this definition isn't always clear.  This 
  16037. feature allows you to explictly set where Pine should look for files
  16038. without a leading path.
  16039.  
  16040. <P>
  16041. NOTE: this feature's value is ignored if either 
  16042. <A HREF="h_config_use_current_dir">use-current-dir</A> feature
  16043. is set or the PINERC has a value for the "operating-dir" variable.
  16044.  
  16045. <P>
  16046. <UL>   
  16047. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  16048. </UL><P>
  16049. <End of help on this topic>
  16050. </BODY>
  16051. </HTML>
  16052. ====== h_config_disable_password_cmd =====
  16053.         FEATURE: disable-password-cmd
  16054.  
  16055. This feature is intended for use by system managers who wish to globally
  16056. disable Pine's password-changing command (Main/Setup/Password) at sites
  16057. where it is inappropriate.
  16058.  
  16059. <End of help on this topic>
  16060. ====== h_config_disable_kblock_cmd =====
  16061.         FEATURE: disable-kblock-cmd
  16062.  
  16063. This feature is intended for use by system managers who wish to globally
  16064. disable the keyboard lock command (Main/KBlock).
  16065.  
  16066. <End of help on this topic>
  16067. ====== h_config_quote_all_froms =====
  16068.         FEATURE: save-will-quote-leading-froms
  16069.  
  16070. This feature controls an aspect of the Save command (and also the way
  16071. outgoing messages are saved to an FCC folder).  If set, Pine will add
  16072. a leading ">" character in front of message lines beginning with "From" 
  16073. when they are saved to another folder, including lines syntactically
  16074. distinguishable from the type of message separator line commonly used on
  16075. Unix systems.
  16076.  
  16077. The default behavior is that a ">" will be prepended only to lines
  16078. beginning with "From " that might otherwise be confused with a message
  16079. separator line on Unix systems.  If pine is the only mail program you use,
  16080. this default is reasonable.  If another program you use has trouble
  16081. displaying a message with an unquoted "From " saved by Pine, you should
  16082. enable this feature.  This feature only applies to the common Unix mailbox
  16083. format that uses message separator lines beginning with "From ".  If
  16084. Pine has been configured to use a different mailbox format (possibly
  16085. incompatible with other mail programs), then this issue does not arise,
  16086. and the feature is irrelevant.
  16087.  
  16088. <End of help on this topic>
  16089. ====== h_config_normal_color =====
  16090. <HTML>
  16091. <HEAD>
  16092. <TITLE>OPTION: Normal Color</TITLE>
  16093. </HEAD>
  16094. <BODY>
  16095. <H1>OPTION: Normal Color</H1>
  16096.  
  16097. Sets the color Pine normally uses.
  16098. The foreground color is the color of the actual character and the
  16099. background color is the color of the area behind the character.
  16100. <P>
  16101. <A HREF="h_color_setup">Descriptions of the available commands</A>
  16102. <P>
  16103. Look <A HREF="h_edit_nav_cmds">here</A>
  16104. to see the available Editing and Navigation commands.
  16105. <P>
  16106. <End of help on this topic>
  16107. </BODY>
  16108. </HTML>
  16109.  
  16110. <End of help on this topic>
  16111. ====== h_config_reverse_color =====
  16112. <HTML>
  16113. <HEAD>
  16114. <TITLE>OPTION: Reverse Color</TITLE>
  16115. </HEAD>
  16116. <BODY>
  16117. <H1>OPTION: Reverse Color</H1>
  16118.  
  16119. Sets the color Pine uses for reverse video characters.
  16120. The foreground color is the color of the actual character and the
  16121. background color is the color of the area behind the character.
  16122. <P>
  16123. <A HREF="h_color_setup">Descriptions of the available commands</A>
  16124. <P>
  16125. Look <A HREF="h_edit_nav_cmds">here</A>
  16126. to see the available Editing and Navigation commands.
  16127. <P>
  16128. <End of help on this topic>
  16129. </BODY>
  16130. </HTML>
  16131. ====== h_config_title_color =====
  16132. <HTML>
  16133. <HEAD>
  16134. <TITLE>OPTION: Title Color</TITLE>
  16135. </HEAD>
  16136. <BODY>
  16137. <H1>OPTION: Title Color</H1>
  16138.  
  16139. Sets the color Pine uses for the titlebar (the top line on the screen).
  16140. The foreground color is the color of the actual character and the
  16141. background color is the color of the area behind the character.
  16142. By default, the Title Color is the same as the Reverse Color.
  16143. <P>
  16144. <A HREF="h_color_setup">Descriptions of the available commands</A>
  16145. <P>
  16146. Look <A HREF="h_edit_nav_cmds">here</A>
  16147. to see the available Editing and Navigation commands.
  16148. <P>
  16149. <End of help on this topic>
  16150. </BODY>
  16151. </HTML>
  16152. ====== h_config_status_color =====
  16153. <HTML>
  16154. <HEAD>
  16155. <TITLE>OPTION: Status Color</TITLE>
  16156. </HEAD>
  16157. <BODY>
  16158. <H1>OPTION: Status Color</H1>
  16159.  
  16160. Sets the color Pine uses for status messages written to the message
  16161. line near the bottom of the screen.
  16162. The foreground color is the color of the actual character and the
  16163. background color is the color of the area behind the character.
  16164. By default, the Status Color is the same as the Reverse Color.
  16165. <P>
  16166. <A HREF="h_color_setup">Descriptions of the available commands</A>
  16167. <P>
  16168. Look <A HREF="h_edit_nav_cmds">here</A>
  16169. to see the available Editing and Navigation commands.
  16170. <P>
  16171. <End of help on this topic>
  16172. </BODY>
  16173. </HTML>
  16174. ====== h_config_index_color =====
  16175. <HTML>
  16176. <HEAD>
  16177. <TITLE>OPTION: Index Colors</TITLE>
  16178. </HEAD>
  16179. <BODY>
  16180. <H1>OPTION: Index Colors</H1>
  16181.  
  16182. You may add color to the single character symbols which give the status
  16183. of each message in the MESSAGE INDEX.
  16184. By default the characters "+", "*", "D",
  16185. "A", and "N" show up near the left hand side of the
  16186. screen depending on whether the message is addressed to you, and whether
  16187. the message is marked Important, is Deleted, is Answered, or is New.
  16188. The color for each of those characters may be specified by setting the
  16189. "Index-to-me" Symbol Color,
  16190. the "Index-important" Symbol Color,
  16191. the "Index-deleted" Symbol Color,
  16192. the "Index-answered" Symbol Color,
  16193. and the "Index-new" Symbol Color.
  16194. There are also two other symbol colors called "Index-recent"
  16195. and "Index-unseen".
  16196. These two colors will only be used if you have configured your
  16197. "<A HREF="h_config_index_format">Index-Format</A>" option
  16198. to include the "IMAPSTATUS" token.
  16199. <P>
  16200. Besides coloring the message status symbols, you may also color the
  16201. entire index line.
  16202. This is done by using the
  16203. <A HREF="h_rules_incols">SETUP INDEX LINE COLORS</A> screen.
  16204. <P>
  16205. <A HREF="h_color_setup">Descriptions of the available commands</A>
  16206. <P>
  16207. Look <A HREF="h_edit_nav_cmds">here</A>
  16208. to see the available Editing and Navigation commands.
  16209. <P>
  16210. <End of help on this topic>
  16211. </BODY>
  16212. </HTML>
  16213. ====== h_config_keylabel_color =====
  16214. <HTML>
  16215. <HEAD>
  16216. <TITLE>OPTION: KeyLabel Color</TITLE>
  16217. </HEAD>
  16218. <BODY>
  16219. <H1>OPTION: KeyLabel Color</H1>
  16220.  
  16221. Sets the color Pine uses for the labels of the keys in the two-line
  16222. menu at the bottom of the screen.
  16223. For example, some of the screens have a "P PrevMsg" command.
  16224. This option sets the color used when displaying "PrevMsg".
  16225. The foreground color is the color of the actual character and the
  16226. background color is the color of the area behind the character.
  16227. By default, the KeyLabel Color is the same as the Normal Color.
  16228. <P>
  16229. <A HREF="h_color_setup">Descriptions of the available commands</A>
  16230. <P>
  16231. Look <A HREF="h_edit_nav_cmds">here</A>
  16232. to see the available Editing and Navigation commands.
  16233. <P>
  16234. <End of help on this topic>
  16235. </BODY>
  16236. </HTML>
  16237. ====== h_config_keyname_color =====
  16238. <HTML>
  16239. <HEAD>
  16240. <TITLE>OPTION: KeyName Color</TITLE>
  16241. </HEAD>
  16242. <BODY>
  16243. <H1>OPTION: KeyName Color</H1>
  16244.  
  16245. Sets the color Pine uses for the names of the keys in the two-line
  16246. menu at the bottom of the screen.
  16247. For example, some of the screens have a "P PrevMsg" command.
  16248. This option sets the color used when displaying the "P".
  16249. The foreground color is the color of the actual character and the
  16250. background color is the color of the area behind the character.
  16251. By default, the KeyName Color is the same as the Reverse Color.
  16252. <P>
  16253. <A HREF="h_color_setup">Descriptions of the available commands</A>
  16254. <P>
  16255. Look <A HREF="h_edit_nav_cmds">here</A>
  16256. to see the available Editing and Navigation commands.
  16257. <P>
  16258. <End of help on this topic>
  16259. </BODY>
  16260. </HTML>
  16261. ====== h_config_slctbl_color =====
  16262. <HTML>
  16263. <HEAD>
  16264. <TITLE>OPTION: Selectable Item Color</TITLE>
  16265. </HEAD>
  16266. <BODY>
  16267. <H1>OPTION: Selectable Item Color</H1>
  16268.  
  16269. Sets the color Pine uses for selectable items, such as URLs.
  16270. The foreground color is the color of the actual character and the
  16271. background color is the color of the area behind the character.
  16272. By default, the Selectable Item Color is the same as the Normal Color,
  16273. except that it is bold.
  16274. <P>
  16275. <A HREF="h_color_setup">Descriptions of the available commands</A>
  16276. <P>
  16277. Look <A HREF="h_edit_nav_cmds">here</A>
  16278. to see the available Editing and Navigation commands.
  16279. <P>
  16280. <End of help on this topic>
  16281. </BODY>
  16282. </HTML>
  16283. ====== h_config_quote_color =====
  16284. <HTML>
  16285. <HEAD>
  16286. <TITLE>OPTION: Quote Colors</TITLE>
  16287. </HEAD>
  16288. <BODY>
  16289. <H1>OPTION: Quote Colors</H1>
  16290.  
  16291. Sets the colors Pine uses for coloring quoted text in the MESSAGE TEXT
  16292. screen.
  16293. If a line begins with a > character (or space followed by >)
  16294. it is considered a quote.
  16295. That line will be given the Quote1 Color (first level quote).
  16296. If there is a second level of quoting then the Quote2 Color will be used.
  16297. Pine considers there to be a second level of quoting if that first > is
  16298. followed by another > (or space followed by >).
  16299. If there are characters other than whitespace and > signs, then it isn't
  16300. considered another level of quoting.
  16301. Similarly, if there is a third level of quoting the Quote3 Color will be
  16302. used.
  16303. If there are more levels after that the Quote Colors are reused.
  16304. If you define all three colors then it would repeat like Color1, Color2, Color3,
  16305. Color1, Color2, Color3, ...
  16306. If you only define the first two it would be
  16307. Color1, Color2, Color1, Color2, ...
  16308. If you define only the Quote1 Color, then the entire quote would be that
  16309. color regardless of the quoting levels.
  16310. If you define a Quote Color to be the same as the Normal Color, that's treated
  16311. the same as if you didn't define it at all.
  16312. By default, the Quote Colors are the same as the Normal Color.
  16313. <P>
  16314. <A HREF="h_color_setup">Descriptions of the available commands</A>
  16315. <P>
  16316. Look <A HREF="h_edit_nav_cmds">here</A>
  16317. to see the available Editing and Navigation commands.
  16318. <P>
  16319. <End of help on this topic>
  16320. </BODY>
  16321. </HTML>
  16322. ====== h_config_prompt_color =====
  16323. <HTML>
  16324. <HEAD>
  16325. <TITLE>OPTION: Prompt Color</TITLE>
  16326. </HEAD>
  16327. <BODY>
  16328. <H1>OPTION: Prompt Color</H1>
  16329.  
  16330. Sets the color Pine uses for confirmation prompts and questions which
  16331. appear in the status line near the bottom of the screen.
  16332. The foreground color is the color of the actual character and the
  16333. background color is the color of the area behind the character.
  16334. By default, the Prompt Color is the same as the Reverse Color.
  16335. <P>
  16336. <A HREF="h_color_setup">Descriptions of the available commands</A>
  16337. <P>
  16338. Look <A HREF="h_edit_nav_cmds">here</A>
  16339. to see the available Editing and Navigation commands.
  16340. <P>
  16341. <End of help on this topic>
  16342. </BODY>
  16343. </HTML>
  16344. ====== h_config_incol =====
  16345. <HTML>
  16346. <HEAD>
  16347. <TITLE>OPTION: Index Line Color</TITLE>
  16348. </HEAD>
  16349. <BODY>
  16350. <H1>OPTION: Index Line Color</H1>
  16351.  
  16352. This option is used to set the color of a line in the index when the
  16353. message for that line matches the Pattern.
  16354. This colors the whole index line, except possibly the status letters
  16355. which may be colored separately using the
  16356. <A HREF="h_color_setup">Setup Kolor</A> screen.
  16357. The foreground color is the color of the actual characters and the
  16358. background color is the color of the area behind the characters.
  16359. <P>
  16360. <A HREF="h_color_setup">Descriptions of the available commands</A>
  16361. <P>
  16362. Look <A HREF="h_edit_nav_cmds">here</A>
  16363. to see the available Editing and Navigation commands.
  16364. <P>
  16365. <End of help on this topic>
  16366. </BODY>
  16367. </HTML>
  16368. ====== h_config_dflt_color =====
  16369. <HTML>
  16370. <HEAD>
  16371. <TITLE>OPTION: Default Color</TITLE>
  16372. </HEAD>
  16373. <BODY>
  16374. <H1>OPTION: Default Color</H1>
  16375.  
  16376. Setting default will cause the color to be the default color.
  16377. Unsetting default is normally done by choosing a color, but in some cases
  16378. you may want to declare the current default color to be your non-default
  16379. choice.
  16380. For example, the default Title Color is the same as the Reverse Color.
  16381. Whenever the Reverse Color changes the Title Color will also change, unless
  16382. you've changed it or unset the default box.
  16383. <P>
  16384. <A HREF="h_color_setup">Descriptions of the available commands</A>
  16385. <P>
  16386. Look <A HREF="h_edit_nav_cmds">here</A>
  16387. to see the available Editing and Navigation commands.
  16388. <P>
  16389. <End of help on this topic>
  16390. </BODY>
  16391. </HTML>
  16392. ====== h_config_bold_slctbl =====
  16393. <HTML>
  16394. <HEAD>
  16395. <TITLE>OPTION: Bold</TITLE>
  16396. </HEAD>
  16397. <BODY>
  16398. <H1>OPTION: Bold</H1>
  16399.  
  16400. The color for this particular section may have the Bold attribute turned
  16401. on or off.
  16402. Setting bold will cause the characters to be bold.
  16403. <P>
  16404. <A HREF="h_color_setup">Descriptions of the available commands</A>
  16405. <P>
  16406. Look <A HREF="h_edit_nav_cmds">here</A>
  16407. to see the available Editing and Navigation commands.
  16408. <P>
  16409. <End of help on this topic>
  16410. </BODY>
  16411. </HTML>
  16412. ====== h_config_customhdr_color =====
  16413. <HTML>
  16414. <HEAD>
  16415. <TITLE>OPTION: Viewer Header Colors</TITLE>
  16416. </HEAD>
  16417. <BODY>
  16418. <H1>OPTION: Viewer Header Colors</H1>
  16419.  
  16420. Sets the color Pine uses for header fields in the MESSAGE TEXT screen.
  16421. For example, you may set the color of the Subject header or the From header.
  16422. The foreground color is the color of the actual character and the
  16423. background color is the color of the area behind the character.
  16424. <P>
  16425. For Header Colors,
  16426. there is an additional line on the
  16427. screen labeled "Pattern to match".
  16428. If you leave that blank, then the whole field for that header will
  16429. be colored.
  16430. However, if you give a pattern to match, the coloring will only take place
  16431. if there is a match for that pattern in the value of the field.
  16432. For example, if you are working on a color for the Subject header and
  16433. you fill in a pattern of "important", then only Subjects which
  16434. contain the word "important" will be colored.
  16435. <P>
  16436. If the pattern you enter is a comma-separated list of patterns, then coloring
  16437. happens if any of those patterns matches.
  16438. <P>
  16439. <A HREF="h_color_setup">Descriptions of the available commands</A>
  16440. <P>
  16441. Look <A HREF="h_edit_nav_cmds">here</A>
  16442. to see the available Editing and Navigation commands.
  16443. <P>
  16444. <End of help on this topic>
  16445. </BODY>
  16446. </HTML>
  16447. ====== h_config_customhdr_pattern =====
  16448. <HTML>
  16449. <HEAD>
  16450. <TITLE>OPTION: Viewer Header Color Pattern</TITLE>
  16451. </HEAD>
  16452. <BODY>
  16453. <H1>OPTION: Viewer Header Color Pattern</H1>
  16454.  
  16455. If you leave this blank, then the whole field for the header will
  16456. be colored.
  16457. If you give a pattern to match, the coloring will only take place
  16458. if there is a match for that pattern in the value of the field.
  16459. For example, if you are working on a color for the Subject header and
  16460. you fill in a pattern of "important", then only Subjects which
  16461. contain the word "important" will be colored.
  16462. <P>
  16463. For address headers (like From and To) and for the Newsgroups header,
  16464. a pattern match will cause only the matched addresses or newsgroups to be
  16465. colored.
  16466. If there is no pattern to match, then all of the addresses or newsgroups
  16467. in the relevant header will be colored.
  16468. <P>
  16469. The matching pattern may be a comma-separated list of patterns to match
  16470. instead of a single pattern.
  16471. For example, you could use the pattern "important,urgent" which would
  16472. cause a match if either the word "important" or the word
  16473. "urgent" appeared in the value of the header.
  16474. You could list several comma-separated email addresses in the Header
  16475. From Color pattern so that those addresses will be colored when any of
  16476. them appear in the From header.
  16477. <P>
  16478. To add a new matching pattern or change the existing pattern use the 
  16479. <!--chtml if pinemode="function_key"-->
  16480. "F4"
  16481. <!--chtml else-->
  16482. "C"
  16483. <!--chtml endif-->
  16484. "Change" command which is available when the "Pattern to
  16485. match" line is hilighted.
  16486. The
  16487. <!--chtml if pinemode="function_key"-->
  16488. "F10"
  16489. <!--chtml else-->
  16490. "D"
  16491. <!--chtml endif-->
  16492. "Delete" command may be used to quickly remove all patterns
  16493. for a particular header.
  16494. <P>
  16495. <End of help on this topic>
  16496. </BODY>
  16497. </HTML>
  16498. ====== h_color_setup =====
  16499. <HTML>
  16500. <HEAD>
  16501. <TITLE>SETUP COLOR COMMANDS</TITLE>
  16502. </HEAD>
  16503. <BODY>
  16504. <H1>SETUP COLOR COMMANDS</H1>
  16505. <!--chtml if pinemode="function_key"-->
  16506. <PRE>
  16507. Available Commands -- Group 1
  16508. -------------------------------
  16509. F1  Display this help text
  16510. F2  Show other available commands
  16511. F3  Exit to Main Menu
  16512. F4  Select the highlighted foreground or background color
  16513. F5  Move to previous line
  16514. F6  Move to next line
  16515. F7  Previous page
  16516. F8  Next page
  16517. F9  Add a config section for a header field
  16518. F10 Restore all default colors (for all sections)
  16519. F11 Print color configuration screen
  16520. F12 Whereis (search for word)
  16521.  
  16522. Available Commands -- Group 2
  16523. -------------------------------
  16524. F1  Display this help text
  16525. F2  Show other available commands
  16526. F5  Delete config section for highlighted header field
  16527. F6  Shuffle the order of Header Color sections
  16528. </PRE>
  16529. <!--chtml else-->
  16530. <PRE>
  16531. General commands
  16532. -------------------------------------------------
  16533.  ?  Display this help text     E  Exit back to Main Menu
  16534.  P  Previous Line              N  Next Line
  16535.  -  Previous page             Spc Next page
  16536.  W  WhereIs (search for word)  %  Print color configuration screen
  16537.  
  16538. Color Setup Commands
  16539. ------------------------------------------------
  16540.  *  Select the highlighted foreground or background color
  16541.  A  Add a config section for a header field
  16542.  D  Delete config section for highlighted header field
  16543.  R  Restore all default colors (for all sections)
  16544.  $  Shuffle the order of Header Color sections
  16545. </PRE>
  16546. <!--chtml endif-->
  16547.  
  16548. <H2>Description of the Setup Color Screen</H2>
  16549.  
  16550. From this screen you may turn on color and set the colors of
  16551. various parts of the Pine display.
  16552. For help on turning on color move your cursor into the Color Style section
  16553. at the top of the Setup Color screen and ask for help.
  16554.  
  16555. <P>
  16556. Each section of the rest of the color setup screen has a title
  16557. which describes briefly what effect the setting will have.
  16558. For example, the Status Color section sets the color for status messages.
  16559. Read the help in each section for a description of the effect of setting
  16560. the color for that section.
  16561. Highlight the section you want to change by moving the cursor into it, then
  16562. select the foreground and background colors desired by using the Next and
  16563. Prev keys to highlight the color, and the * command to select it.
  16564. <P>
  16565. To set a color to its default value, set the X in the Default line at
  16566. the bottom of the list of colors.
  16567. Most colors default to being the same as either the Normal Color or the
  16568. Reverse Color.
  16569. See the help for the particular color section to see which.
  16570. <P>
  16571.  
  16572. Besides coloring the specific fields that Pine knows about, you may also
  16573. color specific header fields when viewing a message in the MESSAGE TEXT
  16574. screen.
  16575. For example, you may color the Subject header a particular color.
  16576. There are a few commands for use with headers.
  16577. The "AddHeader" command adds a section to the color
  16578. configuration screen which allows you to set the color for that header.
  16579. You'll be asked for the name of the header field you want to color.
  16580. If you wanted to color the Subject, you would answer
  16581. with the word "subject".
  16582. Once you've added a header field, the color setting works just like the
  16583. other color fields, except that there is an additional line on the
  16584. config screen labeled "Pattern to match".
  16585. If you leave that blank, then the whole field for that header will always
  16586. be colored.
  16587. However, if you give a pattern to match, the coloring will only take place
  16588. if there is a match for that pattern in the value of the field.
  16589. For example, if you are working on a color for the Subject header and
  16590. you fill in a pattern of "important", then only Subjects which
  16591. contain the word "important" will be colored.
  16592. <P>
  16593. The "DeleteHdr" command removes a header section from the
  16594. configuration altogether.
  16595. The "Shuffle" command changes the order of header sections.
  16596. This is only necessary if you use header sections with pattern fields.
  16597. For example, if you have two Subject sections, one with one pattern and
  16598. another with another pattern, and the subject for a particular message
  16599. happens to match both, then the color from the first match is used.
  16600. <P>
  16601.  
  16602. The command "RestoreDefs" will restore all of the default colors.
  16603. Each section will change to the default value used for that section when
  16604. color is first enabled.
  16605. When you restore all default colors the color settings for the Header Colors
  16606. will be unset (since that's the default), but the header fields you've
  16607. added will remain so that you may easily reset them.
  16608. In order to get rid of them completely you'd have to use
  16609. the "DeleteHdr" command.
  16610.  
  16611. <P><UL>
  16612. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  16613. </UL><P>
  16614. <End of help on this topic>
  16615. </BODY>
  16616. </HTML>
  16617. ====== h_config_news_uses_recent ======
  16618.         FEATURE: news-approximates-new-status
  16619.  
  16620. This feature causes certain messages to be marked as "New" in the
  16621. MESSAGE INDEX of newsgroups.
  16622.  
  16623. When opening a newsgroup, Pine will consult your "newsrc" file and
  16624. determine the last message you have previously disposed of via the "D"
  16625. key.  If this feature is set, any subsequent messages will be shown in the
  16626. Index with an "N", and the first of these messages will be highlighted.
  16627. Although this is only an approximation of true "New" or "unseen"
  16628. status, it provides a useful cue to distinguish more-or-less recent
  16629. messages from those you have seen previously, but are not yet ready to
  16630. mark deleted.
  16631.  
  16632. Background: your "newsrc" file (used to store message status information
  16633. for newsgroups) is only capable of storing a single flag, and Pine uses
  16634. this to record whether or not you are "done with" a message, as
  16635. indicated by marking the message as "Deleted".  Unfortunately, this
  16636. means that Pine has no way to record exactly which messages you have
  16637. previously seen, so it normally does not show the "N" status flag for
  16638. any messages in a newsgroup. This feature enables a starting
  16639. *approximation* of seen/unseen status that may be useful.
  16640.  
  16641. <End of help on this topic>
  16642. ====== h_config_suspend_spawns =====
  16643. <HTML>
  16644. <HEAD>
  16645. <TITLE>FEATURE: use-subshell-for-suspend</TITLE>
  16646. </HEAD>
  16647. <BODY>
  16648. <H1>FEATURE: use-subshell-for-suspend</H1>
  16649.  
  16650. This feature affects Pine's behavior when process suspension is enabled
  16651. and then activated via the Ctrl-Z key.  Pine suspension allows one to
  16652. temporarily interact with the operating system command "shell" 
  16653. without
  16654. quitting Pine, and then subsequently resume the still-active Pine session.
  16655. <P>
  16656.  
  16657. When the <A HREF="h_config_can_suspend">"enable-suspend"</A> feature
  16658. is set and subsequently the Ctrl-Z key
  16659. is pressed, Pine will normally suspend itself and return temporary control
  16660. to Pine's parent shell process.  However, if this feature is set, Pine
  16661. will instead create an inferior subshell process.  This is useful when the
  16662. parent process is not intended to be used interactively.  Examples include
  16663. invoking Pine via the -e argument of the Unix "xterm" program, 
  16664. or via a menu system.<P>
  16665.  
  16666. Note that one typically resumes a suspended Pine by entering the Unix
  16667. "fg" command, but if this feature is set, it will be necessary to
  16668. enter the "exit" command instead.
  16669. <P>
  16670. <UL>   
  16671. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  16672. </UL><P>
  16673. <End of help on this topic>
  16674. </BODY>
  16675. </HTML>
  16676. ====== h_config_8bit_smtp =====
  16677. <HTML>
  16678. <HEAD>
  16679. <TITLE>FEATURE: enable-8bit-to-smtp-server</TITLE>
  16680. </HEAD>
  16681. <BODY>
  16682. <H1>FEATURE: enable-8bit-to-smtp-server</H1>
  16683. This feature affects Pine's behavior when sending mail.  Internet standards
  16684. require that all electronic mail messages traversing the global Internet
  16685. consist of 7bit ASCII characters unless a pair of cooperating mail 
  16686. transfer agents explicitly agree to allow 8bit messages.  In general, 
  16687. then, exchanging messages in non-ASCII characters requires MIME encoding.
  16688. <P>
  16689. However, there are now Internet standards that allow for unencoded 8bit
  16690. exchange of messages between cooperating systems.  Setting this feature
  16691. tells Pine to try to negotiate unencoded 8bit transmission during the
  16692. sending process.  Should the negotiation fail, Pine will fall back to its
  16693. ordinary encoding rules. 
  16694. <P>
  16695. Note, this feature relies on your system's mail transport agent or
  16696. configured <A HREF="h_config_smtp_server">"smtp-server"</A>
  16697. having the negotiation mechanism introduced in
  16698. "Extended SMTP" (ESMTP) and the specific extension called
  16699. "8BITMIME". 
  16700. <P>
  16701. ESMTP allows for graceful migration to upgraded mail transfer agents, but
  16702. it is possible that this feature might cause problems for some servers. 
  16703. <P><UL>
  16704. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  16705. </UL>
  16706. <P><End of help on this topic>
  16707. </BODY>
  16708. </HTML>
  16709. ====== h_config_8bit_nntp =====
  16710.         FEATURE: enable-8bit-nntp-posting
  16711.  
  16712. This feature affects Pine's behavior when posting news.  
  16713.  
  16714. The Internet standard for exchanging USENET news messages (RFC-1036)
  16715. specifies that USENET messages should conform to Internet mail standards
  16716. and contain only 7bit characters, but much of the news transport software
  16717. in use today is capable of successfully sending messages containing 8bit
  16718. characters.  Hence, many people believe that it is appropriate to send 8bit
  16719. news messages without any MIME encoding.
  16720.  
  16721. Moreover, there is no Internet standard for explicitly negotiating 8bit
  16722. transfer, as there is for Internet email.  Therefore, Pine provides the
  16723. option of posting unencoded 8bit news messages, though not as the default.
  16724. Setting this feature will turn OFF Pine's MIME encoding of newsgroup
  16725. postings that contain 8bit characters. 
  16726.  
  16727. Note, articles may cross a path or pass through news transport software
  16728. that is unsafe or even hostile to 8bit characters.  At best this will only
  16729. cause the posting to become garbled.  The safest way to transmit 8bit
  16730. characters is to leave Pine's MIME encoding turned on, but recipients
  16731. who lack MIME-aware tools are often annoyed when they receive MIME-encoded 
  16732. messages.
  16733.  
  16734. <End of help on this topic>
  16735. ====== h_config_tab_new_only =====
  16736.         FEATURE: tab-visits-next-new-message-only
  16737.  
  16738. This feature affects Pine's behavior when using the TAB key to move from
  16739. one message to the next.  Pine's usual behavior is to select the next
  16740. unread message or message flagged as "Important".
  16741.  
  16742. Setting this feature causes Pine to skip the messages flagged as important,
  16743. and select unread messages exclusively.  Tab behavior when there are no
  16744. new messages left to select remains unchanged.
  16745.  
  16746. <End of help on this topic>
  16747. ====== h_config_quell_dead_letter =====
  16748. <HTML>
  16749. <HEAD>
  16750. <TITLE>FEATURE: quell-dead-letter-on-cancel</TITLE>
  16751. </HEAD>
  16752. <BODY>
  16753. <H1>FEATURE: quell-dead-letter-on-cancel</H1>
  16754.  
  16755. This feature affects Pine's behavior when you cancel a message being
  16756. composed.  Pine's usual behavior is to write the canceled message to
  16757. a file named 
  16758. <!--chtml if pinemode="os_windows"-->
  16759. "DEADLETR",
  16760. <!--chtml else-->
  16761. "dead.letter" in your home directory,
  16762. <!--chtml endif-->
  16763. overwriting any previous message. Under
  16764. some conditions (some routine), this can introduce a noticeable delay.
  16765. Setting this feature will cause Pine NOT to write canceled compositions
  16766. into the file.
  16767. <P>
  16768. NOTE: Enabling this feature means NO record of canceled messages is
  16769. maintained.
  16770. <P>
  16771. <UL>   
  16772. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  16773. </UL><P>
  16774. <End of help on this topic>
  16775. </BODY>
  16776. </HTML>
  16777. ====== h_config_quell_beeps =====
  16778. <HTML>
  16779. <HEAD>
  16780. <TITLE>FEATURE: quell-status-message-beeping</TITLE>
  16781. </HEAD>
  16782. <BODY>
  16783. <H1>FEATURE: quell-status-message-beeping</H1>
  16784.  
  16785. This feature affects Pine's behavior when it displays status message
  16786. (e.g., Error complaints, New mail warnings, etc).  Setting this feature
  16787. will not affect the display of such messages, but will cause those that
  16788. emit a beep to become silent.
  16789.  
  16790. <P>
  16791. <UL>   
  16792. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  16793. </UL><P>
  16794. <End of help on this topic>
  16795. </BODY>
  16796. </HTML>
  16797. ====== h_config_quell_lock_failure_warnings =====
  16798. <HTML>
  16799. <HEAD>
  16800. <TITLE>FEATURE: quell-lock-failure-warnings</TITLE>
  16801. </HEAD>
  16802. <BODY>
  16803. <H1>FEATURE: quell-lock-failure-warnings</H1>
  16804.  
  16805. This feature affects Pine's behavior when it encounters a problem
  16806. acquiring a mail folder lock.  Typically, a secondary file associated
  16807. with the mail folder being opened is created as part of the locking
  16808. process.  On some systems, such file creation has been administratively
  16809. precluded by the system configuration.
  16810. <P>
  16811. Pine issues a warning when such failures occur, which can become bothersome
  16812. if the system is configured to disallow such actions.  Setting this
  16813. feature causes Pine to remain silent when this part of lock creation fails.
  16814. <P>
  16815. WARNING: systems that have been configured in a way that precludes locking
  16816. introduce some risk of mail folder corruption when more than one program
  16817. attempts to modify the mail folder.  This is most likely to occur to one's
  16818. INBOX or other incoming message folder. 
  16819. <P>
  16820. See also <A HREF="h_info_on_locking">"What Systems Managers Need to Know about Pine File Locking"</A>.
  16821. <P>
  16822. <UL>   
  16823. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  16824. </UL><P>
  16825. <End of help on this topic>
  16826. </BODY>
  16827. </HTML>
  16828. ====== h_config_enable_role_take ======
  16829. <HTML>
  16830. <HEAD>
  16831. <TITLE>FEATURE: enable-rules-under-take</TITLE>
  16832. </HEAD>
  16833. <BODY>
  16834. <H1>FEATURE: enable-rules-under-take</H1>
  16835. Normally, the Take command takes addresses from a message and helps you
  16836. put them into your Address Book.
  16837. If you use Rules for Indexcolors, Roles, Filtering, or Scoring;
  16838. you may find it useful
  16839. to be able to Take information from a message's headers and put it into
  16840. a new Rule.
  16841. When this feature is set, you will be given an extra prompt which gives
  16842. you the choice to Take into the Address Book or Take into a rule.
  16843. <P><UL>
  16844. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  16845. </UL>
  16846. <P>
  16847. <End of help on this topic>
  16848. </BODY>
  16849. </HTML>
  16850. ====== h_config_quell_folder_internal_msg ======
  16851. <HTML>
  16852. <HEAD>
  16853. <TITLE>FEATURE: quell-folder-internal-msg</TITLE>
  16854. </HEAD>
  16855. <BODY>
  16856. <H1>FEATURE: quell-folder-internal-msg</H1>
  16857. This feature determines whether or not Pine will create 
  16858. "pseudo messages" in folders that are in standard Unix or 
  16859. MMDF format. <P> 
  16860.  
  16861. Pine will normally create these pseudo messages when they are not already
  16862. present in a standard Unix or MMDF folder.  Their purpose is to record
  16863. certain mailbox state data needed for correct IMAP and POP server
  16864. operation, and also for Pine to be able to mark messages as Answered when
  16865. the Reply has been postponed.<P>
  16866.  
  16867. Sites which do not use IMAP/POP for remote mail access, and which need to
  16868. support mail tools that are adversely affected by the presence of the
  16869. pseudo-messages (e.g. some mail notification tools) may enable this
  16870. feature to tell Pine not to create them.  Note that Pine's 
  16871. "Answered" flag
  16872. capability will be adversely affected if this is done.<P>
  16873.  
  16874. Note too that, even if this feature is enabled, Pine will not remove
  16875. pseudo-messages when it encounters them (e.g. those created by UW's imapd
  16876. or ipopd servers.) This feature has no effect on folders that are not in
  16877. standard Unix or MMDF format, as pseudo-messages are not needed in the
  16878. other formats to record mailbox state information.
  16879. <P><UL>
  16880. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  16881. </UL>
  16882. <P>
  16883. <End of help on this topic>
  16884. </BODY>
  16885. </HTML>
  16886. ====== h_config_quell_empty_dirs ======
  16887. <HTML>
  16888. <HEAD>
  16889. <TITLE>FEATURE: quell-empty-directories</TITLE>
  16890. </HEAD>
  16891. <BODY>
  16892. <H1>FEATURE: quell-empty-directories</H1>
  16893.  
  16894. This feature causes Pine to remove from the display any directories
  16895. that do not contain at least one file or directory.  This can be useful
  16896. to prevent overly cluttered folder lists when a collection is stored on
  16897. a server that treats all names as both a folder and a directory.
  16898.  
  16899. <P>
  16900. Note, enabling this feature can cause surprising behavior!  For example,
  16901. you can still use Add to create a directory, but unless you immediately
  16902. enter that directory and create a folder, that newly created directory
  16903. may not be displayed next time you enter the folder list.
  16904.  
  16905. <P>
  16906. <UL>   
  16907. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  16908. </UL><P>
  16909. <End of help on this topic>
  16910. </BODY>
  16911. </HTML>
  16912. ====== h_config_no_part_fetch =====
  16913. <HTML>
  16914. <HEAD>
  16915. <TITLE>FEATURE: quell-partial-fetching</TITLE>
  16916. </HEAD>
  16917. <BODY>
  16918. <H1>FEATURE: quell-partial-fetching</H1>
  16919.  
  16920. This feature affects the way Pine interacts with IMAP 4rev1 mail servers.
  16921. By default, when a large message or attachment is viewed or saved, Pine
  16922. asks the server for message data in segments.  This allows the command 
  16923. that caused the request to be interrupted.
  16924.  
  16925. <P>
  16926. Testing has shown that, while extremely rare, it is possible for such
  16927. requests to cause some servers distress.  If you're having trouble
  16928. viewing or saving large messages, then you might try listing this feature
  16929. in your pinerc's feature list.
  16930.  
  16931. <P>
  16932. <UL>   
  16933. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  16934. </UL><P>
  16935. <End of help on this topic>
  16936. </BODY>
  16937. </HTML>
  16938. ====== h_config_change_from =====
  16939. <HTML>
  16940. <HEAD>
  16941. <TITLE>FEATURE: allow-changing-from</TITLE>
  16942. </HEAD>
  16943. <BODY>
  16944. <H1>FEATURE: allow-changing-from</H1>
  16945.  
  16946. This feature affects Pine's handling of the "From:" header field
  16947. in the "<A HREF="h_config_custom_hdrs">Customized-Headers</A>" configuration
  16948. option.
  16949.  
  16950. <P>
  16951. By default, Pine restricts the use of this field in order to minimize the
  16952. risk of misconfiguration (e.g., sending mail that can't be replied to).
  16953. When this feature is added to your pinerc's feature list, the field,
  16954. when configured, becomes editable in the composer.
  16955.  
  16956. <P>
  16957. Note that many sites restrict the use of this feature in order to reduce the chance
  16958. of falsified addresses and misdirected mail.
  16959. <P>
  16960. <UL>   
  16961. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  16962. </UL><P>
  16963. <End of help on this topic>
  16964. </BODY>
  16965. </HTML>
  16966. ====== h_config_tcap_wins =====
  16967. <HTML>
  16968. <HEAD>
  16969. <TITLE>FEATURE: termdef-takes-precedence</TITLE>
  16970. </HEAD>
  16971. <BODY>
  16972. <H1>FEATURE: termdef-takes-precedence</H1>
  16973.  
  16974. This feature may affect Pine's low-level input routines.  Termcap (or
  16975. terminfo, depending on how your copy of Pine was compiled and linked)
  16976. is the name of the database which describes terminal capabilities.  In
  16977. particular, it describes the sequences of characters that various keys
  16978. will emit.
  16979.  
  16980. <P>
  16981. An example would be the Up Arrow key on the keyboard.  Up
  16982. Arrow is not a distinct character on most Unix systems.  When you press
  16983. the Up Arrow key a short sequence of characters are produced.  This
  16984. sequence is supposed to be described in the termcap database by the
  16985. "ku" capability (or by the "kcuu1" capability if you
  16986. are using terminfo instead of termcap).
  16987.  
  16988. <P>
  16989. By default, Pine defines some terminal
  16990. escape sequences that are commonly used.  For example, the sequence
  16991. "ESC O A" is recognized as an Up Arrow key.  The sequence
  16992. "ESC [ A"
  16993. is also recognized as an Up Arrow key.  These are chosen because common
  16994. terminals like VT100's or ANSI standard terminals produce these
  16995. sequences when you press the Up Arrow key.
  16996.  
  16997. <P>
  16998. If your system's termcap
  16999. (terminfo) database assigns some other function to the sequence
  17000. "ESC O A"
  17001. it is usually ignored by Pine.  Also, if your termcap (terminfo)
  17002. database assigns a sequence which doesn't begin with an escape
  17003. character (<SAMP>ESC</SAMP>) it is usually ignored by Pine.
  17004. This usually works fine
  17005. because most terminals emit the escape sequences that Pine has defined
  17006. by default.  We have also found that it is usually better to have these
  17007. defaults take precedence over the definitions contained in the database
  17008. because the defaults are more likely to be correct than the database.
  17009.  
  17010. <P>
  17011. There are some terminals where this breaks down.  If you want Pine to
  17012. believe the definitions given in your termcap (terminfo) database in
  17013. preference to the defaults the Pine itself sets up, then you may turn
  17014. this feature on.  Then, sequences of characters which are defined in
  17015. both termcap (terminfo) and in Pine's set of defaults will be
  17016. interpreted the way that termcap (terminfo) says they should be
  17017. interpreted.  Also, if your terminal capabilities database assigns a
  17018. sequence which doesn't begin with escape, it will not be ignored.
  17019.  
  17020. <P>
  17021. <UL>   
  17022. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  17023. </UL><P>
  17024. <End of help on this topic>
  17025. </BODY>
  17026. </HTML>
  17027. ====== h_config_cruise_mode =====
  17028. <HTML>
  17029. <HEAD>
  17030. <TITLE>FEATURE: enable-cruise-mode</TITLE>
  17031. </HEAD>
  17032. <BODY>
  17033. <H1>FEATURE: enable-cruise-mode</H1>
  17034.  
  17035. This feature affects Pine's behavior when you hit the
  17036. "Space Bar" at
  17037. the end of a displayed message.  Typically, Pine complains that the end
  17038. of the text has already been reached.  Setting this feature causes such
  17039. keystrokes to be interpreted as if the "Tab" key had been hit, thus
  17040. taking you to the next "interesting" message,
  17041. or scanning ahead to the 
  17042. next incoming folder with "interesting" messages.
  17043.  
  17044. <P>
  17045. <UL>   
  17046. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  17047. </UL><P>
  17048. <End of help on this topic>
  17049. </BODY>
  17050. </HTML>
  17051. ====== h_config_cruise_mode_delete =====
  17052. <HTML>
  17053. <HEAD>
  17054. <TITLE>FEATURE: enable-cruise-mode-delete</TITLE>
  17055. </HEAD>
  17056. <BODY>
  17057. <H1>FEATURE: enable-cruise-mode-delete</H1>
  17058.  
  17059. This feature modifies the behavior of Pine's 
  17060. <A HREF="h_config_cruise_mode">"enable-cruise-mode"</A> feature.  
  17061. Setting this feature causes Pine to implicitly delete read
  17062. messages when it moves on to display the next "interesting" message.
  17063. <P>
  17064. NOTE: Beware when enabling this feature AND the 
  17065. <A HREF="h_config_auto_expunge">"expunge-without-confirm"</A> 
  17066. feature.
  17067. <P>
  17068. <UL>   
  17069. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  17070. </UL><P>
  17071. <End of help on this topic>
  17072. </BODY>
  17073. </HTML>
  17074. ====== h_config_allow_goto =====
  17075.         FEATURE: enable-goto-in-file-browser
  17076.  
  17077. This feature modifies the behavior of Pine's file browser.  Setting this
  17078. feature causes Pine to offer the "G Goto" command in the file browser.
  17079.  
  17080. This command allows you to explicitly set the displayed directory.  Pine's
  17081. default behavior requires you to visit each intermediate directory when moving
  17082. between two distant directories.
  17083.  
  17084. <End of help on this topic>
  17085. ====== h_config_add_ldap =====
  17086. <HTML>
  17087. <HEAD>
  17088. <TITLE>FEATURE: ldap-result-to-addrbook-add</TITLE>
  17089. </HEAD>
  17090. <BODY>
  17091. <H1>FEATURE: ldap-result-to-addrbook-add</H1>
  17092.  
  17093. If both the Directory option
  17094. <A HREF="h_config_ldap_opts_impl">"use-implicitly-from-composer"</A>  
  17095. and this feature are set,
  17096. then when an implicit directory lookup is done from the
  17097. composer you will automatically be prompted to add the result of the
  17098. directory lookup to your address book.
  17099. <P>
  17100. <UL>   
  17101. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  17102. </UL><P>
  17103. <End of help on this topic>
  17104. </BODY>
  17105. </HTML>
  17106. ====== h_config_lame_list_mode =====
  17107. <HTML>
  17108. <HEAD>
  17109. <TITLE>FEATURE: enable-lame-list-mode</TITLE>
  17110. </HEAD>
  17111. <BODY>
  17112. <H1>FEATURE: enable-lame-list-mode</H1>
  17113.  
  17114. This feature modifies the method Pine uses to ask your IMAP
  17115. server for folder names to display in the the FOLDER LIST screen.
  17116. It is intended to compensate for a small set of IMAP servers that
  17117. are programmed to ignore a part of the request, and thus respond
  17118. to Pine's query with nonsensical results.
  17119. <P>
  17120.  
  17121. If you find that Pine is erroneously displaying blank folder lists,
  17122. try enabling this feature.
  17123. <P>
  17124.  
  17125. NOTE: Enabling this feature has consequences for the Goto and Save
  17126. commands.  Many servers allow access to folders outside the area
  17127. reserved for your personal folders via some reserved character,
  17128. typically '#' (sharp), '~' (tilde) or '/' (slash).  This mechanism
  17129. allows, at the Goto and Save prompts, quick access to folders
  17130. outside your personal folder collection without requiring a specific
  17131. collection definition.  This behavior will generally not be available
  17132. when this feature is enabled.
  17133.  
  17134. <P>
  17135. <UL>   
  17136. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  17137. </UL><P>
  17138. <End of help on this topic>
  17139. </BODY>
  17140. </HTML>
  17141. ====== h_config_textplain_int =====
  17142. <HTML>
  17143. <HEAD>
  17144. <TITLE>FEATURE: show-plain-text-internally</TITLE>
  17145. </HEAD>
  17146. <BODY>
  17147. <H1>FEATURE: show-plain-text-internally</H1>
  17148.  
  17149. This feature modifies the method Pine uses to display Text/Plain
  17150. MIME attachments from the Attachment Index screen.  Normally, the
  17151. "View" command searches for any externally defined (usually
  17152. via the
  17153. "<A HREF="h_config_mailcap_path">Mailcap</A>" file) viewer,
  17154. and displays the selected text within that viewer.
  17155.  
  17156. <P>
  17157. Enabling this feature causes Pine to ignore any external viewer
  17158. settings and always display text with Pine's internal viewer.
  17159.  
  17160. <P>
  17161. <UL>   
  17162. <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
  17163. </UL><P>
  17164. <End of help on this topic>
  17165. </BODY>
  17166. </HTML>
  17167. ====== h_config_role_undo =====
  17168. Yes, remember changes and exit back to list of roles; No, discard changes
  17169. made in this screen; ^C, cancel exit and stay in this config screen.
  17170. ====== h_config_undo =====
  17171. Yes, save changes and exit; No, exit without saving any changes made since
  17172. entering this CONFIGURATION screen; ^C, cancel exit and stay in config screen.
  17173. ====== h_os_index_whereis =====
  17174. Enter ^V or ^Y to go immediately to the last or first message in the index.
  17175. Or, enter the match string followed by RETURN.
  17176. ====== h_os_index_whereis_agg =====
  17177. Enter ^V or ^Y to go immediately to the last or first message in the index,
  17178. Or, enter the match string followed by RETURN (or ^X to select all matches).
  17179. =========== h_oe_add_full ==================
  17180. Type the full name of the person being added and press the RETURN key.
  17181. Press ^C to cancel addition.
  17182. =========== h_oe_add_nick ==================
  17183. Type a short nickname and press RETURN.  A nickname is a short easy-to-
  17184. remember word, name or initials like "joe", or "wcfields."  ^C to cancel.
  17185. ========== h_oe_add_addr ================
  17186. Type the e-mail address and press RETURN.
  17187. Press ^C to cancel addition.
  17188. ========== h_oe_crlst_full ==============
  17189. Type a long name or description for the list that you are creating and
  17190. press RETURN.  Press ^C to cancel creation of list.
  17191. =========== h_oe_crlst_nick =============
  17192. Type a nickname (short, easy-to-remember name or single word) for the list
  17193. you are creating and press RETURN.  Press ^C to cancel.
  17194. ========== h_oe_crlst_addr ==============
  17195. Type an e-mail address, or a nickname already in the address book that you
  17196. want to be part of this list and press RETURN.
  17197. ========== h_oe_adlst_addr =============
  17198. Type an e-mail address or a nickname already in the address book that you
  17199. want to add to this list and press RETURN.
  17200. ========== h_oe_editab_nick ============
  17201. Change the nickname using the arrow keys and delete key.  Press RETURN
  17202. when done.  Press ^C to cancel editing and leave the nickname as it was.
  17203. ========== h_oe_editab_full ============
  17204. Change the full name using the arrow keys and delete key.  Press RETURN
  17205. when done.  Press ^C to cancel editing and leave the full name as it was.
  17206. ========== h_oe_editab_addr ============
  17207. Change the address using the arrow keys and delete key.  Press RETURN
  17208. when done.  Press ^C to cancel editing and leave the address as it was.
  17209. ========== h_oe_editab_fcc ============
  17210. Change the fcc using the arrow keys and delete key.  Press RETURN when
  17211. done.  Press ^C to cancel editing and leave the fcc as it was.
  17212. ========== h_oe_editab_comment ============
  17213. Change the comment field using the arrow keys and delete key.  Press RETURN
  17214. when done.  Press ^C to cancel editing and leave the comment as it was.
  17215. ====== h_ab_forward =====
  17216. Yes, expand nicknames and qualify local names with your current domain name;
  17217. No, leave nicknames and local names as is;  ^C, cancel.
  17218. ========== h_ab_export ==========
  17219. Type the name of a file to write the addresses into and
  17220. press RETURN.  You may also specify an absolute path.  Use ^C to cancel.
  17221. ========== h_ab_edit_a_field ==========
  17222. Edit any of the fields of the currently selected entry by typing one of the
  17223. letters at the bottom of the screen.  Press ^C to cancel edit.
  17224. ====== h_ab_del_data_revert =====
  17225. Press B to completely delete addrbook and revert to default, C to delete config
  17226. and revert while leaving data, or D to only delete data (make it empty).
  17227. ====== h_ab_del_data_modify =====
  17228. Press B to completely delete addrbook, C to delete configuration while leaving
  17229. data, or D to delete data (make it empty) but leave config. ^C to cancel.
  17230. ====== h_ab_del_config_modify =====
  17231. Yes, remove this address book from my configuration.
  17232. No, make no changes now.
  17233. ====== h_ab_del_config_revert =====
  17234. Yes, remove this address book from my config and revert to default.
  17235. No, make no changes now.
  17236. ====== h_ab_del_default =====
  17237. Yes, remove this default address book from my configuration.
  17238. No, make no changes now.
  17239. ====== h_ab_really_delete =====
  17240. Yes, delete the actual contents of the address book, not just the 
  17241. configuration.  No, don't delete the data after all, cancel and start over.
  17242. ====== h_ab_del_ignore =====
  17243. Press I to ignore all the default address books for this category.  Press R to
  17244. remove this one address book and add the others to your personal list.
  17245. ====== h_ab_del_dir_ignore =====
  17246. Press I to ignore all the default directory servers for this category.
  17247. Press R to remove this one server and add the others to your personal list.
  17248. ====== h_ab_copy_dups =====
  17249. Yes, overwrite the existing entry.
  17250. No, skip duplicates but save the rest. Press ^C to cancel.
  17251. ====== h_ab_export_vcard =====
  17252. A, export list of addresses to file.
  17253. V, export as much vCard information as possible to file. ^C to cancel.
  17254. ====== h_ab_text_or_vcard =====
  17255. Text, start composer with displayed text already included.
  17256. VCard, start composer with address book entry attached as a vCard. ^C cancels.
  17257. ====== h_ab_backup_or_ldap =====
  17258. Backup, copy email address from entry and allow editing of it.
  17259. LDAP, copy LDAP search criteria, do not allow editing of it. ^C cancels.
  17260. ====== h_ldap_text_or_vcard =====
  17261. Text: export displayed text for selected entry. Address: export only the
  17262. email address. VCard: export entry in vCard format. ^C cancels.
  17263. ====== h_ab_save_exp =====
  17264. Save, save entry or entries to an address book.
  17265. Export, save to file outside of pine. ^C cancels save.
  17266. ====== h_ab_add =====
  17267. A, add a brand new entry to this address book.
  17268. E, edit the entry which is currently highlighted. ^C to cancel.
  17269. ====== h_ab_shuf =====
  17270. U, swap order of highlighted address book and the one above it.
  17271. D, swap order of highlighted address book and the one below it. ^C to cancel.
  17272. ====== h_ab_shuf_up =====
  17273. U, swap order of highlighted address book and the one above it.
  17274. Press ^C to cancel.
  17275. ====== h_ab_shuf_down =====
  17276. D, swap order of highlighted address book and the one below it.
  17277. Press ^C to cancel.
  17278. ====== h_role_shuf =====
  17279. U, swap order of highlighted rule and the one above it.
  17280. D, swap order of highlighted rule and the one below it. ^C to cancel.
  17281. ====== h_role_shuf_up =====
  17282. U, swap order of highlighted rule and the one above it.
  17283. Press ^C to cancel.
  17284. ====== h_role_shuf_down =====
  17285. D, swap order of highlighted rule and the one below it.
  17286. Press ^C to cancel.
  17287. ====== h_dir_shuf =====
  17288. U, swap order of highlighted directory and the one above it.
  17289. D, swap order of highlighted directory and the one below it. ^C to cancel.
  17290. ====== h_dir_shuf_up =====
  17291. U, swap order of highlighted directory and the one above it.
  17292. Press ^C to cancel.
  17293. ====== h_dir_shuf_down =====
  17294. D, swap order of highlighted directory and the one below it.
  17295. Press ^C to cancel.
  17296. ====== h_hdrcolor_shuf =====
  17297. U, swap order of highlighted Header Color and the one above it.
  17298. D, swap order of highlighted Header Color and the one below it. ^C to cancel.
  17299. ====== h_hdrcolor_shuf_up =====
  17300. U, swap order of highlighted Header Color and the one above it.
  17301. Press ^C to cancel.
  17302. ====== h_hdrcolor_shuf_down =====
  17303. D, swap order of highlighted Header Color and the one below it.
  17304. Press ^C to cancel.
  17305. ========== h_oe_editab_al ============
  17306. Change the address using the arrow keys and delete key.  Press RETURN
  17307. when done.  Press ^C to cancel editing and leave the address as it was.
  17308. ========== h_dir_comp_search ===============
  17309. Type a string to look for just like you would in the composer. Your configured
  17310. rules for the servers with the implicit flag set will be used.
  17311. ========== h_oe_searchab ===============
  17312. Type the word or name you want to search for and press RETURN.  If you press
  17313. RETURN without entering anything the word in [] will be searched for.
  17314. ========== h_oe_save ==========
  17315. Type the name of the folder you want to save the message in and press RETURN.
  17316. Press ^T to get a list of your folders.  Press ^C to cancel saving this mail.
  17317. ========== h_oe_chooseabook ==========
  17318. Choose the address book you want to save the new entry in.
  17319. Use ^N or ^P to change address books.  ^C to cancel.
  17320. ========== h_oe_takeaddr ==========
  17321. Edit the e-mail address using the arrow and delete keys.  Press RETURN
  17322. when done.  Press ^C to cancel adding this entry to the address book.
  17323. ========== h_oe_take_replace ==========
  17324. Press R to replace the old entry with this new data.  You will still have
  17325. another chance to cancel.  N to enter another nickname.  ^C to cancel now.
  17326. ========== h_oe_take_replace_or_add ==========
  17327. Press R to replace the old entry.  Press A to add the selected addresses to
  17328. the old existing list.  N to enter another nickname. ^C to cancel now.
  17329. ========== h_oe_takename ==========
  17330. Edit the full name to be correct using the arrow and delete keys.  Press RETURN
  17331. when done.  Press ^C to cancel adding this entry to the address book.
  17332. ========== h_oe_takenick ==========
  17333. Type a nickname (short easy-to-remember name, initials or single word) for this
  17334. entry in the address book and press RETURN.  Press ^C to cancel addition.
  17335. ========== h_oe_jump ==========
  17336. Type the number of the message number you want to jump to and press
  17337. RETURN.  Press ^C if you want to cancel jumping to another message.
  17338. ========== h_oe_broach ==========
  17339. Type the name of the folder you want to open and press RETURN.  Press ^P/^N
  17340. to go to the previous/next collections in the list.  Press ^C to cancel goto.
  17341. ========== h_oe_foldsearch ==========
  17342. Type the text you want to search for in foldernames and press RETURN.  If you
  17343. press RETURN without entering anything, any text in [] will be searched for.
  17344. ========== h_oe_foldadd ==========
  17345. Type the name of the folder you want to add and press RETURN.  Press ^C to
  17346. cancel adding a new folder.
  17347. ========== h_oe_foldrename ==========
  17348. Change the old name of the folder to the new name using the arrow and
  17349. delete keys and press RETURN.  Press ^C to cancel rename.
  17350. ========== h_oe_login ==========
  17351. Enter your login name for the host you are opening the mailbox on.  Just press
  17352. RETURN to use your login from this host as is, or edit it with delete key.
  17353. ========== h_oe_passwd ==========
  17354. Type your password for the host and login shown as part of the prompt.
  17355. Press ^C to cancel opening folder.
  17356. ========== h_oe_choosep ==========
  17357. Enter the number associated with the printer you want to select.  Press ^C to
  17358. cancel the printer selection.  The current selection is highlighted.
  17359. ========== h_oe_customp ==========
  17360. Type the name of the Unix print command and press RETURN.  Press ^C to
  17361. cancel the printer selection.
  17362. ========== h_oe_searchview ==========
  17363. Type the word or name you want to search for and press RETURN.  If you press
  17364. RETURN without entering anything the word in [] will be searched for.
  17365. ========== h_oe_keylock ==========
  17366. The keyboard is in use and locked by another user.  Only that user can
  17367. unlock this keyboard by typing the password.
  17368. ========== h_oe_export ==========
  17369. Type the name of a file to write into and press RETURN.
  17370. You may also specify an absolute path.  Use ^C to cancel.
  17371. ========== h_wt_expire ==========
  17372. At the beginning of each month Pine offers to rename your current sent-mail
  17373. folder to one named for the month so you have a sent-mail folder for each month
  17374. ========== h_wt_delete_old ==========
  17375. It is the beginning of the month, and we need to conserve disk
  17376. space.  Please delete any sent-mail that you do not need.
  17377. ========== h_select_sort ==========
  17378. Select the order for sorting the index by typing the capitalized letter.
  17379. Arrival is by arrival in your mailbox; Date is by time/day message was sent.
  17380. ========== h_mini_setup ==========
  17381. Select one of the setup tasks by typing the capitalized letter.
  17382. ========== h_sticky_personal_name ==========
  17383. Type in your name as you want it to appear on outgoing email.  This entry
  17384. will be saved into your Pine configuration file.
  17385. ========== h_sticky_inbox ============
  17386. INBOX syntax is usually {complete.machine.name}INBOX
  17387. This entry will be saved in your Pine configuration file.
  17388. ========== h_sticky_smtp ============
  17389. The name of the computer on your campus which relays your outgoing email
  17390. to the Internet.  This entry will be saved in your Pine configuration file.
  17391. ========== h_sticky_user_id ==========
  17392. The username or login-id part of your email address.  This entry will be
  17393. saved in your Pine configuration file.
  17394. ========== h_sticky_domain ==========
  17395. The domain part of your email address, NOT the name of your PC.  This
  17396. entry will be saved in your Pine configuration file.
  17397. ========== h_bounce =========
  17398. Enter the address or nickname of the intended recipient.  Pine will resend
  17399. the message, which will retain the original author's From: address.
  17400. ========== h_incoming_add_folder_host =========
  17401. Enter RETURN if the folder is on the machine where Pine is running;
  17402. otherwise enter the host name of the mail server, or ^X if same as INBOX.
  17403. ========== h_incoming_add_folder_name =========
  17404. Enter the name of the desired folder. Pine will attempt to create this
  17405. folder on the previously specified mail server.
  17406. ========== h_incoming_add_folder_nickname =========
  17407. Enter an (optional) nickname that will be used in lieu of the actual
  17408. host and folder names in the FOLDER LIST display.
  17409. ========== h_anon_forward ==========
  17410. Enter the address of your intended recipient, or ^C to cancel.
  17411. Example: jsmith@somewhere.edu
  17412. ========== h_news_subscribe ==========
  17413. Enter the name of the newsgroup to which you wish to subscribe,
  17414. or ^C to cancel.  Example: comp.mail.pine
  17415. ========== h_pipe_msg ==========
  17416. Enter the name of the Unix command to which you wish to send this
  17417. message, or ^C to cancel.
  17418. ========== h_pipe_attach ==========
  17419. Enter the name of the Unix command to which you wish to send this
  17420. attachment, or ^C to cancel.
  17421. ========== h_select_by_num ==========
  17422. Enter a list of numbers (or number range(s)), or ^C to cancel.  The messages
  17423. corresponding to the numbers will be selected.  Example: 2-5,7-9,11,19
  17424. ========== h_select_txt_from ==========
  17425. Messages with From: headers containing the entered string will be selected.
  17426. ^C to cancel. ^G again to see original options.
  17427. ========== h_select_txt_not_from ==========
  17428. Messages without From: headers containing the entered string will be selected.
  17429. ^C to cancel. ^G again to see original options.
  17430. ========== h_select_txt_to ==========
  17431. Messages with To: headers containing the entered string will be selected.
  17432. ^C to cancel. ^G again to see original options.
  17433. ========== h_select_txt_not_to ==========
  17434. Messages without To: headers containing the entered string will be selected.
  17435. ^C to cancel. ^G again to see original options.
  17436. ========== h_select_txt_cc ==========
  17437. Messages with Cc: headers containing the entered string will be selected.
  17438. ^C to cancel. ^G again to see original options.
  17439. ========== h_select_txt_not_cc ==========
  17440. Messages without Cc: headers containing the entered string will be selected.
  17441. ^C to cancel. ^G again to see original options.
  17442. ========== h_select_txt_subj ==========
  17443. Messages with Subject: headers containing the entered string will be selected.
  17444. ^C to cancel.  ^X enters Subject: line of current message.
  17445. ========== h_select_txt_not_subj ==========
  17446. Messages without Subject headers containing the entered string will be selected.
  17447. ^C to cancel.  ^X enters Subject: line of current message.
  17448. ========== h_select_txt_all ==========
  17449. All messages containing the entered string will be selected.  Headers and body,
  17450. but not encoded attachments, will be compared.  Enter ^C to cancel.
  17451. ========== h_select_txt_not_all ==========
  17452. All messages which don't contain the entered string will be selected.  Headers
  17453. and body, but not encoded attachments, will be compared.  Enter ^C to cancel.
  17454. ========== h_select_txt_recip ==========
  17455. Messages with Cc: or To: headers containing the entered string will be selected.
  17456. ^C to cancel. ^G again to see original options.
  17457. ========== h_select_txt_not_recip ==========
  17458. Messages without Cc: or To: headers containing the string will be selected.
  17459. ^C to cancel. ^G again to see original options.
  17460. ========== h_select_txt_partic ==========
  17461. Messages with Cc, To, or From headers containing the string will be selected.
  17462. ^C to cancel. ^G again to see original options.
  17463. ========== h_select_txt_not_partic ==========
  17464. Messages without Cc, To, or From headers containing the string will be selected.
  17465. ^C to cancel. ^G again to see original options.
  17466. ========== h_select_date ==========
  17467. If typed, date must be in DD-MMM-YYYY format, where MMM is three-letter 
  17468. abbreviation of month. ^P/^N also changes date. ^X enters date of current msg.
  17469. ========== h_attach_index_whereis ==========
  17470. Enter some text that appears in the Attachment Index entry for the desired
  17471. attachment.  The first attachment containing that text will be highlighted.
  17472. ========== h_kb_lock ==========
  17473. Keystrokes entered here (up to a RETURN) comprise a password that must
  17474. be entered again later in order to unlock the keyboard.
  17475. ========== h_config_whereis ==========
  17476. To move quickly to a particular line, enter a search string or
  17477. ^C to cancel.
  17478. ========== h_config_edit_scorei ==========
  17479. Enter interval in the form (min,max). -INF and INF may be used to represent
  17480. -infinity and infinity. ^C to cancel change. RETURN to accept change.
  17481. ========== h_config_add ==========
  17482. Enter desired value; use normal editing keys to modify (e.g. ^K, ^D).  Just
  17483. pressing RETURN sets the Empty Value (this turns off any global default).
  17484. ========== h_config_add_custom_color ==========
  17485. Enter a header fieldname. For example, "subject" or "from".
  17486.  
  17487. ========== h_config_add_pat_hdr ==========
  17488. Enter a header fieldname. For example, "reply-to" or "organization" or
  17489. any fieldname you want which isn't included already.
  17490. ========== h_config_print_opt_choice ==========
  17491. You may edit either the initialization string (characters printed before
  17492. printing starts) or the trailer string.  Choose one or ^C to cancel.
  17493. ========== h_config_print_init ==========
  17494. Enter a C-style string for this.  You may use common backslash escapes like
  17495. \\n for newline, \\ooo for octal character, and \\xhh for hex character.
  17496. ========== h_config_change ==========
  17497. Edit the existing value using arrow keys, ^K to delete entire entry, ^D to
  17498. delete current (highlighted) character, etc.  Enter ^C to cancel change.
  17499. ========== h_config_replace_add ==========
  17500. Replace ignores the current default, Add places the current default in your
  17501. editing buffer as if you had typed it in.
  17502. ========== h_config_insert_after ==========
  17503. Enter a nickname for this print command.  (InsertBefore puts the new item
  17504. before the current line, InsertAfter puts it after the current line.)
  17505. ========== h_config_print_cmd ==========
  17506. Enter command to be executed for the printer.  Use normal editing keys
  17507. to modify, ^C to cancel, carriage return to accept current value.
  17508. ========== h_config_role_del ==========
  17509. Answering Yes will remove this rule completely from your rules list.
  17510. ========== h_config_role_addfile ==========
  17511. Type the name of a file to add to your configuration. You don't need to
  17512. use a file, you may add rules directly (with Add) without using a file.
  17513. ========== h_config_role_delfile ==========
  17514. Answering Yes will remove this rule file completely from your rules list.
  17515. The rules data file itself will not be removed.
  17516. ========== h_config_print_del ==========
  17517. Answering Yes will remove this printer completely from your printer list.
  17518. ========== h_config_print_name_cmd ==========
  17519. You may edit the Nickname of this printer, the Command to be executed when
  17520. printing, or change the Options associated with this printer.
  17521. ========== h_send_fcc_only ==========
  17522. Yes, copy message to Fcc only and send to NO recipients.
  17523. No, return to composer.
  17524. ========== h_send_prompt ==========
  17525. Yes, send the message.
  17526. No or ^C, return to composer.
  17527. ========== h_send_prompt_dsn ==========
  17528. Yes, send the message.  No or ^C, return to composer.
  17529. What's DSNOpts? See enable-delivery-status-notification in config screen.
  17530. ========== h_role_confirm ==========
  17531. Yes, use displayed role. No, compose without a role.
  17532. ^C, cancel the message. ^T, select a role from your other eligible roles.
  17533. ========== h_norole_confirm ==========
  17534. Return, compose without a role.
  17535. ^C, cancel the message. ^T, select a role from your eligible roles.
  17536. ========== h_custom_print ==========
  17537. Enter a Unix command that accepts its data on standard input.
  17538. Pine will display any information the command sends to standard output.
  17539.