pith/pine.hlp

   1 # $Id: pine.hlp 1266 2009-07-14 18:39:12Z hubert@u.washington.edu $
   2 #
   3 #        T H E   A L P I N E    M E S S A G E   S Y S T E M
   4 #
   5 #/* ========================================================================
   6 # * Copyright 2013-2014 Eduardo Chappa
   7 # * Copyright 2006-2008 University of Washington
   8 # *
   9 # * Licensed under the Apache License, Version 2.0 (the "License");
  10 # * you may not use this file except in compliance with the License.
  11 # * You may obtain a copy of the License at
  12 # *
  13 # *     http://www.apache.org/licenses/LICENSE-2.0
  14 # *
  15 # * ========================================================================
  16 # */
  17 #
  18          Help text for the Alpine mailer
  19
  20 This file is in a format created to be turned into text strings in a C
  21 program.
  22
  23 There are two shell scripts that run on this.  Cmplhelp.sh is the
  24 first and turns this into a C file (helptext.c) of text strings that
  25 are compiled and linked. The other program, cmplhlp2.sh, turns this
  26 into a .h file (helptext.h) with extern string definitions of the
  27 strings in the .c file.  The code that actually processes these files
  28 while alpine is running is in help.c
  29
  30 The lines with "===== xxxx ====" divide the different help screens.  The
  31 xxx is the name of the variable that strings will be put in, which are
  32 also declared in helptext.h.
  33
  34 # is a comment
  35
  36 Help text screen text can be either plain text OR HTML.  The latter is
  37 denoted by the first line starting with "<HTML>".  The former is simply
  38 displayed as it's formatted here.
  39
  40 HTML is limited to simple formatting ala HTML 2.0.  No forms, or tables.
  41 In addition a small set of tools are are available to customize the HTML
  42 screen's text:
  43
  44 1a)  Default and function key bindings are separated like this:
  45
  46 <!--chtml if pinemode="function_key"-->
  47         Function key bindings here
  48 <!--chtml else-->
  49         Default key bindings here
  50 <!--chtml endif-->
  51
  52
  53 1b)  A way to distinguish HTML text that is to be displayed when
  54      pine is running vs. when the text is served up outside Alpine
  55      (someday) can be done via:
  56
  57 <!--chtml if pinemode="running"-->
  58    Text displayed when viewed within a running pine session
  59 <!--chtml else-->
  60    Text displayed when HTML viewed outside pine (using chtml aware server)
  61 <!--chtml endif-->
  62
  63 1c)  A way to distinguish HTML text that is to be displayed under
  64      PC-Alpine vs. not is available via:
  65
  66 <!--chtml if pinemode="os_windows"-->
  67    Text displayed under PC-Alpine
  68 <!--chtml else-->
  69    Text displayed otherwise
  70 <!--chtml endif-->
  71
  72 WARNING ABOUT CHTML "if-else-endif" CLAUSES: They don't nest.
  73
  74 2a) Several "server side include" commented elements are supported:
  75
  76 <!--#include file="textfile"-->
  77
  78 The file "textfile" will be inserted into the HTML text directly.
  79 Alpine does no formatting of the text.  At some point we might want to
  80 look at the first line for <HTML> but not today.
  81
  82 2b) Various bits of Alpine's running state can be inserted into the
  83 HTML text as well using the special comment:
  84
  85 <!--#echo var="variable"-->
  86
  87 Where "variable" is one of either:
  88
  89     ALPINE_VERSION
  90     ALPINE_REVISION
  91     ALPINE_COMPILE_DATE
  92     ALPINE_TODAYS_DATE
  93     C_CLIENT_VERSION
  94     _LOCAL_FULLNAME_
  95     _LOCAL_ADDRESS_
  96     _BUGS_FULLNAME_
  97     _BUGS_ADDRESS_
  98     CURRENT_DIR
  99     HOME_DIR
 100     PINE_CONF_PATH
 101     PINE_CONF_FIXED_PATH
 102     PINE_INFO_PATH
 103     MAIL_SPOOL_PATH
 104     MAIL_SPOOL_LOCK_PATH
 105     VAR_<VARNAME> - where <VARNAME> is config variable name
 106     FEAT_<FEATURENAME> - where <FEATURENAME> is config feature name
 107
 108 3) The URL scheme "X-Alpine-Gripe:" is available to insert links to
 109    pine's composer such that various debugging data can be attached to the
 110    message. Aside from normal email addresses, this can be set to
 111    either "_LOCAL_ADDRESS_" for the configured local help address, or
 112    "_BUGS_ADDRESS_" for the configured local bug reporting address.
 113    Aside from the special tokens above, the default behavior only differs
 114    from "mailto:" by the insertion of a special Subject: prefix that
 115    consists of a randomly-generated token for tracking purposes.
 116    Several optional parameters can be included to control what is
 117    attached or offered for attachment to the message:
 118
 119         ?config  --  Automatically attaches the user's configuration
 120                      information to the trouble report
 121         ?keys    --  Automatically attaches the user's most recent
 122                      keystrokes
 123         ?curmsg  --  Causes the user to get an offer to attach the
 124                      current message to the trouble report
 125         ?local   --  Automatically attaches the result of the script
 126                      defined by VAR_BUGS_EXTRAS
 127
 128 For HTML-format sections, the help screen dividers  "===== xxxx ====" must
 129 contain one and only one space after the first and before the second set of
 130 equal signs.
 131
 132 Note to authors of this file: to mark sections that need further revision,
 133 please use the text string on the following line consistently so that it is
 134 easy to find those places again in this file:
 135 *revision needed*
 136
 137 NOTE: Several sections of help text which weren't being used were removed
 138 at RCS version number 4.122.  In particular, there were some placeholders
 139 with help text for the config screen and the composer that didn't have any
 140 reasonable place to be called from.
 141 Dummy change to get revision in pine.hlp
 142 ============= h_revision =================
 143 Alpine Commit 66 2014-12-07 19:42:29
 144 ============= h_news =================
 145 <HTML>
 146 <HEAD>
 147 <TITLE>RELEASE NOTES for Alpine</TITLE>
 148 </HEAD>
 149 <BODY>
 150 <H1>Alpine Release Notes</H1>
 151 <DIV ALIGN=CENTER>
 152 Version <!--#echo var="ALPINE_VERSION"--> (<!--#echo var="ALPINE_REVISION"-->)
 153 <BR>
 154 <!--chtml if pinemode="running"-->
 155 (built <!--#echo var=ALPINE_COMPILE_DATE-->)
 156 <!--chtml endif-->
 157
 158 <BR>
 159 <BR>Copyright 2013-2014 Eduardo Chappa
 160 <BR>Copyright 2006-2008 University of Washington
 161 </DIV>
 162
 163 <P>
 164 Alpine is an &quot;Alternatively Licensed Program for Internet
 165 News and Email&quot; produced until 2009 by the University of Washington.
 166 It is intended to be an easy-to-use program for
 167 sending, receiving, and filing Internet electronic mail messages and
 168 bulletin board (Netnews) messages.  Alpine is designed to run on a wide
 169 variety of Unix&reg; operating systems.  A version for Microsoft Windows&reg;
 170 is available as is a world wide web based version designed to run under the
 171 Apache web server.
 172
 173
 174 <H2>New in Alpine <!--#echo var="ALPINE_VERSION"--> (<!--#echo var="ALPINE_REVISION"-->)</H2>
 175
 176 Version <!--#echo var="ALPINE_VERSION"--> (<!--#echo var="ALPINE_REVISION"-->)
 177 addresses bugs found in previous releases and has a few additions as well.
 178
 179 <P>
 180 Additions include:
 181 <P>
 182
 183 <UL>
 184   <LI> Upgrade UW-IMAP to Panda IMAP from
 185        <A HREF="https://github.com/jonabbey/panda-imap">https://github.com/jonabbey/panda-imap</A>.
 186   <LI> S/MIME: Add screen to manage certificates.
 187   <LI> S/MIME: Signatures are validated using the user's certificates instead
 188        of the ones included in the message. Behavior can be disabled by
 189        disabling the option <A href="h_config_smime_use_cert_store">
 190         <!--#echo var="FEAT_smime-use-storey-only"--></A>, which is enabled
 191        by default.
 192   <LI> S/MIME: sign messages using intermediate certificates when needed
 193        and possible.
 194   <LI> S/MIME: validation of certificates for servers that modify signed
 195        content.
 196   <LI> S/MIME: signed and encrypted messages will be signed first and
 197        encrypted second, so that they can be decoded by other clients.
 198   <LI> S/MIME: add the sender certificate to the list of certificates in
 199        encrypted messages to make it possible for the sender to decrypt
 200        the message they sent.
 201   <LI> S/MIME: When transferring certificates to a local container, create
 202        container with default names PublicContainer, PrivateContainer and
 203        CAContainer, as appropriate for these files, unless the user has
 204        provided some other names.
 205   <LI> S/MIME: Forwarding a message will include the signed part as part
 206        of the text and not as a multipart message, just as the reply
 207        command does.
 208   <LI> HTML: Style tag in body of html message causes Alpine to not write
 209        its content until a new &lt;/style&gt;
 210   <LI> HTML: &lt;BR&gt;, &lt;BR /&gt;, and &lt;BR/&gt; are considered
 211        the same inline tag; the same is valid for the &lt;HR&gt; tag.
 212   <LI> Add support to selective expunge through a subcommand of the
 213        select-apply commands. Read more in the <A
 214        HREF="h_index_cmd_expunge">help</A> for the expunge command.
 215   <LI> Pico: New subcommand of the search command, allows to reverse the
 216        direction of search.
 217   <LI> Unix Alpine: If a password file is defined, and S/MIME is enabled,
 218        the key and certificate used to encrypt the password file are saved
 219        in the ~/.alpine-smime/.pwd directory, or in the directory specified
 220        by the -pwdcertdir command line option.
 221        <A HREF="h_password_file_support">Learn more</A>.
 222   <LI> Add /tls1, /tls1_1, /tls1_2 and /dtls1 to the definition of a
 223        server to use different ways to connect using ssl, for
 224        example {server.com/tls1} will attempt to connect to
 225        server.com at the ssl imap port (port 993) and establish a
 226        connection using TLSv1. These flags can be used in
 227        conjunction with the /ssl flag, the ssl flag is redundant.
 228        Conversely, however, the /ssl flag does not imply any of
 229        these flags; the /ssl flag means SSLv3 or, if not available,
 230        SSLv2 in the SSL port.
 231   <LI> Alpine does not attempt to automatically reopen a collection
 232        that was not opened due to cancellation by the user.
 233        Instead, the user must try to open it explicitly.
 234   <LI> Alpine searches for a certificate that matches an email address in
 235        all addresses in a certificate (instead of just the first
 236        one) but when it tries to unlock the certificate, it asks
 237        for the password for the first email address in that
 238        certificate.
 239   <LI> Style tag in body of html message causes Alpine to not write its content
 240        until a new &lt;/style&gt;
 241   <LI> Experimental: Write the content-type of a message in
 242        lowercase, as some non-compliant servers do not understand
 243        uppercase content-type, such as those of GMX.de.
 244   <LI> Experimental: Do not send the RSET command before attempting
 245        to send a message, as this causes a delay in some evily managed
 246        servers.
 247   <LI> Opening a folder updates recent count in maildrops (this
 248        already works for other types of folders)
 249   <LI> Automatically redraw screen after opening an attachment
 250        instead of simply clearing it.
 251   <LI> Pico: Justification works without need of a predefined quote
 252        string. This allows justification of blocks of text that are
 253        indented with spaces.
 254   <LI> Decode the name of attachment names, so they can be written as part
 255        of the description of the part.
 256   <LI> Check bounds and tie strings off to improve security. Contributed
 257        by James Jerkins.
 258   <LI> Replace tabs by spaces in From and Subject fields to control for
 259        size in screen of these fields. Change only in index screen display.
 260   <LI> Aggregate operations allows bouncing a list of messages using a role.
 261        Suggested by Ulf-Dietrich Braumann.
 262   <LI> Makefile: Add $(LIBINTL) to the flags to link rpdump, rpload,
 263      alpined and alpineldap because MAC OSX 10.8 x86_64 needs it. Reported by
 264      Charles M. Register.
 265 </UL>
 266
 267
 268 <P>
 269 Bugs that have been addressed include:
 270 <UL>
 271   <LI> Fix _INIT_ token for reply quote string to include support for 8-bit
 272        in personal names. Reported by Lev Gorenstein.
 273   <LI> When writing the .pinerc file, lines were truncated if they were longer
 274        than 10,000 characters. This could cause data corruption, so now lines
 275        are allowed to be of any length.
 276   <LI> In Unix Alpine (but not in MAC OSX) fix a problem that made Alpine
 277        remove attachments before they were open by a mailcap viewer. It
 278        requires that the user has an equivalent to a command such as "ps
 279        auxww" to list the list of processes, and check if there is any
 280        program using the attachment. The default is "/bin/ps auxww", but
 281        it can be changed at compile time with the option --with-ps-cmd.
 282        See the help of the variable
 283        <a href="h_config_psleep"><!--#echo var="VAR_mailcap-check-interval"--></a>
 284        for more information.
 285   <LI> S/MIME: signed messages that contained an attachment would not validate.
 286   <LI> S/MIME: signed and encrypted messages from Thunderbird would not
 287        validate. Thanks to Andreas Schamanek for testing, debugging and
 288        advising during the process of fixing this problem.
 289   <LI> S/MIME: Forwarding messages with multipart content-type failed to be signed
 290        with &quot;Error writing pipe&quot; message. Reported by Andreas Schamanek
 291        and Stefan Mueller.
 292   <LI> S/MIME: Certificates are lost when using a pinerc file outside of the
 293        home directory.
 294   <LI> S/MIME: Accessing the S/MIME configuration screen would deinitialize
 295        SMIME making it not possible to sign or encrypt messages.
 296   <LI> S/MIME: Forwarding a signed message might make the body contain mime
 297        information that is not part of the body, and hence making the body
 298        of the message seem wrong.
 299   <LI> S/MIME Alpine would compute incorrectly the signature of a message
 300        that contains 8bit if the option "Enable 8bit ESMTP Negotiation" is
 301        enabled, the message contains 8bit characters and the smtp server
 302        supports 8bit sending.
 303   <LI> When replying to several messages, subject will be decoded first,
 304        and then stripped from re/fwd before they are compared to determine
 305        the subject of the replied message.
 306   <LI> Crash when tcp connection to NNTP server was lost after connection
 307        had been established, but lost immediately afterwards.
 308   <LI> Crash with message &quot;lock when already locked&quot;, when painting
 309        an index was based on scores that needed information from a remote
 310        addressbook in the same server as the folder opened. Reported by
 311        Peter Koellner.
 312   <LI> Crash in message/rfc822 attachments encoded in base64.
 313   <LI> Postponed messages whose content-type is text/html, text/enriched and
 314        text/richtext are sent with that content-type, even though, after
 315        resuming composition, Alpine had changed its type to text/plain.
 316   <LI> Alpine cannot handle correctly some characters in the Windows-1256
 317        character set, which might lead to a crash or a corruption in the
 318        screen. Work was done to contain the bug. A more complete fix will
 319        be done in a future release. Reported by Professor Robert Funnell.
 320   <LI> WebAlpine: add _GNU_SOURCE to make pubcookie build.
 321   <LI> WebAlpine: fail to build with debug disabled. Fix from Sam Hathaway.
 322   <LI> Save command did not warn of existence of a message with a deleted
 323        attachment in an aggregate save, unless cursor was positioned on a message
 324        with a deleted attachment. Reported by Florian Herzig.
 325   <LI> Transformation of UTF-8 to MUTF7 was not being done when creating a folder
 326        in an IMAP server.
 327   <LI> DATE tokens were not internally transformed to UTF-8, which made their
 328        values not appear complete in the screen. Reported by Werner Scheinast.
 329   <LI> Fixes to configure script so that it will not require PAM for every system.
 330   <LI> Fix to configure script so that it will use CPPFLAGS instead of
 331        CPPCFLAGS, and so the --with-ssl-include-dir option take effect
 332        during the build. Fix by Ulf-Dietrich Braumann.
 333   <LI> Fix in WebAlpine: do not use deprecated dereference in pointer,
 334        needs to use tcl_getstringresult() instead. Reported by
 335        Ulf-Dietrich Braumann.
 336   <LI> Quoted string in URL Viewers configuration variable were not
 337        unquoted before passing to viewer.
 338   <LI> Fix in configure script to detect location of tcl library; add
 339        /usr/local in FreeBSD and fix a bug in configure script that used
 340        $alpine_TCLINC instead of $alpine_TCLINC/tcl.h. Reported and fixed
 341        by Werner Scheinast.
 342   <LI> Move SSL configurations from UW-IMAP to configure script, and
 343        update OpenSSL configuration for Mac OS X.
 344   <LI> Remove -lregex from linker flags when building --with-supplied-regex.
 345   <LI> When the download of an attachment is interrumpted, Alpine stills
 346      caches what was downloaded, making the download incomplete for
 347      subsequent calls of Alpine attempting to open the attachment. In the
 348      future, Alpine will not cache any downloaded part of the attachment
 349      when it is interrupted.
 350 </UL>
 351 <P>
 352
 353
 354 <P>
 355 Version 2.11 addresses bugs found in previous releases and has a few
 356 additions as well.
 357
 358 <P>
 359 Additions include:
 360 <P>
 361
 362 <UL>
 363    <LI> Alpine requires version 1.0.1c of Openssl to build.
 364    <LI> Increase encryption of S/MIME encrypted messages.
 365    <LI> Pico: Improvements in justification of paragraphs: lines that begin
 366 with a quote string, followed by a space were considered individual paragraphs,
 367 now they are considered part of a paragraph. Based on earlier joint work
 368 with Jeff Franklin.
 369    <LI> Unix Alpine: Allow local .pinerc file to be a symbolic link.
 370    <LI> Experimental extended support of recognition of UTF-8 in urls based on
 371 information from <A HREF="http://url.spec.whatwg.org">http://url.spec.whatwg.org</A>.
 372    <LI> Added recognition of ws and wss URIs.
 373    <LI> Add ability to <A HREF="h_config_folder_color">color folder names</A>,
 374  <A HREF="h_config_directory_color">directory names</A>,
 375  and <A HREF="h_config_folder_list_color">text</A> in the FOLDER SCREEN.
 376    <LI> Add the ability to <A HREF="h_config_indextoken_color">color any token</A>
 377 used in the display of the INDEX SCREEN.
 378    <LI> New option <A HREF="h_config_preserve_field"><!--#echo var="FEAT_preserve-original-fields"--></A>
 379 that adds the ability to preserve To: and Cc: fields when replying to a
 380 message, as specified by original sender.
 381    <LI> Add a _SILENT_ token to the <A HREF="h_config_display_filters">list of tokens</A>
 382  for a display filter, so that Alpine will not redraw the screen when it is unnecessary.
 383    <LI> Quota command includes subcommands for printing, forwarding, etc.
 384 </UL>
 385
 386 <P>
 387 Bugs that have been addressed include:
 388 <P>
 389 <UL>
 390   <LI> Crash when a non-compliant SMTP server closes a connection without a QUIT command.
 391   <LI> Crash when resizing the screen in a configuration screen.
 392   <LI> Do not bail out during a tcp timeout, instead close connection and avoid crash.
 393   <LI> Do not use a shell to open a browser.
 394   <LI> Configure script did not test for crypto or pam libraries.
 395   <LI> Configure script attempted to build web component, even if header file tcl.h was not present.
 396   <LI> Change Cygwin directory separator to &quot;/&quot;.
 397   <LI> Alpine could set List- headers, contrary to RFC 2369.
 398 </UL>
 399
 400 <P>
 401 Version 2.10 addresses bugs found in previous releases and has a few
 402 additions as well.
 403
 404 <P>
 405 Additions include:
 406 <P>
 407
 408 <UL>
 409    <LI> Quota report for IMAP folders that support it (press the &quot;@&quot; command in the index screen of such folder).
 410    <LI> Search a folder for the content of any header with the &quot;;&quot; command.
 411    <LI> Foreign characters are decoded correctly in IMAP folder names.
 412    <LI> Question about breaking connection to slow servers includes their name.
 413    <LI> Internal x-alpine-help: resource locator for sending links to internal help.
 414    <LI> OpenSuse: Alpine find location of OpenSSL certificates.
 415    <LI> Cygwin: Alpine builds without need of patch.
 416    <LI> Recognition of proper mime type for docx, xlsx, and pptx files.
 417    <LI> When composing a message, Alpine will create a new thread when the subject is erased.
 418    <LI> Add support for strong encryption of password file when S/MIME is built in.
 419 </UL>
 420
 421 <P>
 422 Bugs that have been addressed include:
 423 <P>
 424
 425 <UL>
 426    <LI> Alpine will close a folder after confirming with user their intention and not reopen it.
 427    <LI> Double allocation of memory in Pico.
 428    <LI> Alpine does not give warning of message sent and posted upon receipt by email of message posted in newsgroup.
 429    <LI> Handling of STYLE html parameter may make Alpine not display the content of a message.
 430    <LI> Not recognition of environment variables in some options.
 431    <LI> Not display of login prompt during initial keystrokes.
 432    <LI> justification of long urls breaks them.
 433    <LI> Incorrect New Mail message when envelope is not available.
 434    <LI> Incorrect display of PREFDATE, PREFDATETIME and PREFTIME tokens.
 435    <LI> Crash when resizing the screen after display of LDAP search.
 436    <LI> Crash when redrawing screen while opening a remote folder collection.
 437    <LI> Infinite loop in scrolltool function during notification of new mail.
 438    <LI> No repaint of the screen after midnight was done when the SMARTDATE token is used in the index screen.
 439    <LI> No display of signed and encrypted S/MIME messages.
 440    <LI> Alpine will not build with OpenSSL.
 441    <LI> Crash for double locking in calls to c-client.
 442    <LI> Bad recognition of mime-encoded text may make Alpine not print the subject of a message.
 443    <LI> Ignore the references header when threading messages
 444    <LI> No update of colors in index screen after update to addressbook.
 445 </UL>
 446
 447 <P>
 448 Version 2.01 addresses bugs found in previous releases and has a few
 449 additions as well.
 450
 451 <P>
 452 Additions include:
 453 <P>
 454
 455 <UL>
 456    <LI> Fixed non-ASCII web alpine handling
 457    <LI> Added web alpine help.
 458    <LI> Allow web alpine inbox on second IMAP server.
 459    <LI> Allow web alpine config reset after bad inbox-path gets set.
 460    <LI> Added web alpine ability to create group contact from contact list members.
 461    <LI> Backed out web alpine coercing of default sort-key of arrival to date/reverse.
 462    <LI> Tidied up web alpine script layout.
 463    <LI> Fixed web alpine status message ordering
 464    <LI> Added web alpine Fcc setting via Contacts in Compose
 465    <LI> Fixed web alpine autodraft attachment issues
 466    <LI> Fixed web alpine problems with recent count maintenance
 467    <LI> Fixed web alpine newmail arrival display in message list
 468    <LI> Added web alpine confirmation to folder create for Move/Copy
 469    <LI> Added web alpine user-domain support
 470    <LI> Fixed web alpine to support INBOX-within-a-collection deletion
 471 </UL>
 472
 473 <P>
 474 Bugs that have been addressed include:
 475 <P>
 476
 477 <UL>
 478    <LI> In web alpine fixed delete all selected within a search result to reorient
 479         correctly to whole-mailbox message list.
 480    <LI> Fixed web alpine delete in view page to be sensitive to sort
 481    <LI> Fixed web alpine open of folder within directory from folder manager page.
 482    <LI> Fixed web alpine open of folder within directory from left column's recent cache.
 483    <LI> Fixed web alpine problems with spaces in special folder names like Drafts
 484    <LI> Fixed web alpine adding contacts from message list and view
 485    <LI> Fixed web alpine create of non-existent fcc
 486    <LI> Remove mistakenly left debugger statement in web alpine javascript.
 487    <LI> Some UNIX alpine build problems fixed
 488    <LI> Crash in pico and pilot when nl_langinfo returned something unrecognizable
 489         or NULL. Add recognition of "646" to nl_langinfo wrapper. This is returned
 490         by locale charmap call on some Solaris 8 systems.
 491    <LI> MacOS Keychain logins were not working correctly with generic host names, like
 492         imap.gmail.com, as opposed to specific instances like rx-in-209.google.com, causing
 493         new password requests when not needed
 494    <LI> Possible crash in WhereIs command while in FOLDER LIST when cursor is located on the
 495         last folder in the list
 496    <LI> Change to S/MIME get_x509_subject_email so that X509v3 alternative names are
 497         looked for along with the email address
 498    <LI> Changes to configure to get spellcheck options with work with arguments.
 499    <LI> Add change from Mark Crispin of panda.com to at least minimally handle non-ascii hostname
 500         returned by gethostname (iPhone can do this)
 501    <LI> Fixed a bug that prevents a filter that moves a message into a local folder
 502         from also setting the DELETE flag in that moved message. Fix from Eduardo Chappa.
 503    <LI> Changed size of shellpath in open_system_pipe from 32 to MAXPATH. Fix from
 504         Jake Scott of marganstanley.com.
 505    <LI> Buffer overflow bug in c-client's tmail/dmail, fix from Mark Crispin. This
 506         is not used in alpine.
 507    <LI> Imapd server crash from unguarded fs_give in IDLE code, fix from Crispin.
 508         Apparently this causes RIM Blackberry BIS service problems. This is not
 509         used in alpine.
 510    <LI> Tmail uninitialized pointer fix from Neil Hoggarth. Not used in alpine.
 511    <LI> Buffer overflow possibility in RFC822BUFFER routines in c-client library.
 512         Fix from Ludwig Nussel of SUSE and from Crispin.
 513    <LI> Include whole filename in export filename history
 514    <LI> Fix display bug in pico when Replace command is canceled. Fix from Eduardo Chappa.
 515 </UL>
 516
 517 <P>
 518 Version 2.00
 519 addressed bugs found in previous releases and had a few additions as well.
 520 <P>
 521 Additions included:
 522 <P>
 523
 524 <UL>
 525    <LI> Redesigned Web Alpine interface
 526    <LI> Experimental <A HREF="h_mainhelp_smime">S/MIME support</A> added
 527         in UNIX versions of Alpine
 528    <LI> Attempt to include the attachment filename as part of the name of the
 529         temporary file used when viewing an attachment with an external program.
 530         Add some randomness to that filename to make it hard to predict the filename.
 531         Add a filename extension, usually derived from the type/subtype, to the
 532         temporary filename. This was previously done only on Windows and MacOS X.
 533    <LI> Enhance address completion in the composer (TAB command) so that it looks
 534         through nicknames, fullnames, and addresses from the address book; addresses
 535         from the message being viewed, if any; and the results from
 536         <A HREF="h_direct_config">LDAP Directory Server</A>
 537         lookups for all of the defined directory servers that have the
 538         <A HREF="h_config_ldap_opts_impl">&quot;Use-Implicitly-From-Composer&quot;</A>
 539         feature set.
 540    <LI> Make the default character set setting more liberal in what it will accept
 541         from the UNIX nl_langinfo call and the various values of LANG seen in the wild
 542    <LI> Remove the Alpine revision number from the titlebar in released versions
 543         while leaving it there in snapshot versions
 544    <LI> Add a <A HREF="h_config_quell_asterisks">feature</A> to suppress the
 545         display of asterisks when you type a password for Alpine
 546    <LI> Add line wrapping when displaying <EM>PRE</EM> formatted sections of HTML
 547    <LI> When the
 548         <A HREF="h_config_dates_to_local"><!--#echo var="FEAT_convert-dates-to-localtime"--></A>
 549         feature is turned on convert not only the dates in the index screen but also
 550         the dates in the MESSAGE VIEW
 551 </UL>
 552
 553 <P>
 554 Bugs addressed in the 2.00 release included:
 555 <P>
 556
 557 <UL>
 558    <LI> Crash when using tab-completion for selecting a Save filename
 559    <LI> Make Web Alpine help text images relative for more portability
 560    <LI> Fixed attach save of html parts in Web Alpine
 561    <LI> Viewing, printing, exporting, replying, and bouncing of message
 562         digests was broken. Replying and bouncing should not have been
 563         allowed at all for digests. It would be nice to have a more standard
 564         index-like view of a message digest but that has not been addressed
 565         with this minor bug fix.
 566    <LI> Adjust wrapping of HTML messages so that the margins specified by
 567         <A HREF="h_config_viewer_margin_left"><!--#echo var="VAR_viewer-margin-left"--></A> and
 568         <A HREF="h_config_viewer_margin_right"><!--#echo var="VAR_viewer-margin-right"--></A>
 569         are observed correctly
 570    <LI> Interrupt of WhereIs command in index was broken
 571    <LI> The <A HREF="h_config_unk_char_set"><!--#echo var="VAR_unknown-character-set"--></A>
 572         option did not work correctly interpreting unknown characters in message headers
 573    <LI> Long address lines could cause blank continuation lines
 574    <LI> Save to a local default INBOX failed if the primary collection was also local,
 575         which it is by default. The save went to  ~/mail/inbox instead.
 576    <LI> Make a default save folder of &quot;inbox&quot; always mean the real
 577         inbox, not the inbox in the primary collection
 578    <LI> Address book entries with lots of addresses would be truncated when
 579         entered in the composer with a screen size wider than 270 or so charcters
 580    <LI> Some fields in the index screen were truncated when the screen width was
 581         wider than 256 characters
 582    <LI> Crash when TABing to next folder, the next folder with new mail is a POP
 583         folder, and there is a more than 10 minute pause between typing the TAB
 584         and typing the Yes
 585 </UL>
 586
 587 <P>
 588 Version 1.10(962)
 589 addressed bugs found in previous releases and had a few additions as well.
 590 <P>
 591 Additions included:
 592 <P>
 593
 594 <UL>
 595    <LI> Add the possibility of setting a default role
 596         (see <A HREF="h_role_select">Roles Screen</A>)
 597         which may be convenient if your work flow involves acting in one
 598         role for a while then switching to another role and staying in the
 599         new role for another period of time
 600    <LI> When Saving and the IMAP server problem &quot;Message to save shrank!&quot;
 601         is encountered, ask the user if he or she wants to continue with the
 602         risky Save anyway instead of aborting. This may be helpful if your
 603         IMAP server is broken in this way but be aware that it is possible there
 604         was a real error instead of just a broken server implementation.
 605    <LI> Some configure adjustments for Kerberos detection and
 606         for SCO OpenServer 5 support
 607    <LI> Hide INBOX in a collection if it also appears as an
 608         <A HREF="h_config_enable_incoming">Incoming Folder</A>
 609    <LI> Show asterisks for feedback when the user is typing a password
 610    <LI> Performance improvement for threading of large folders
 611    <LI> Previously, the search used to find
 612         Pattern matches containing To patterns searched for both To
 613         and Resent-To headers. The relatively complicated search this
 614         produces causes problems when using some deficient IMAP servers.
 615         Now the default is to look only for To headers and ignore the
 616         presence of Resent-To. The previous behavior may be restored
 617         with the <A HREF="h_config_use_resentto"><!--#echo var="FEAT_use-resent-to-in-rules"--></A> feature.
 618    <LI> Add an
 619         <A HREF="h_config_unk_char_set"><!--#echo var="VAR_unknown-character-set"--></A>
 620         to help with reading malformed unlabeled messages
 621    <LI><A HREF="h_config_suppress_user_agent"><!--#echo var="FEAT_suppress-user-agent-when-sending"--></A> option added
 622    <LI> Map some Shift-LeftArrow escape sequences to LeftArrow
 623    <LI> Add feature <A HREF="h_config_warn_if_fcc_blank"><!--#echo var="FEAT_warn-if-blank-fcc"--></A>
 624 </UL>
 625
 626 <P>
 627 Bugs addressed in the 1.10(962) release included:
 628 <P>
 629
 630 <UL>
 631    <LI> Crash when encountering certain errors from an SMTP server
 632    <LI> Crash in composer caused by overflow in replace_pat()
 633    <LI> Hang when authenticating to an SMTP server that fails with a
 634         &quot;connection disconnected&quot; error
 635    <LI> Bug in handling of trailing tab character in flowed text
 636    <LI> Security enhancement for mailcap parameter substitution
 637    <LI> <A HREF="h_config_strip_sigdashes"><!--#echo var="FEAT_strip-from-sigdashes-on-reply"--></A>
 638         did not work if the message being replied to was not flowed text
 639         and <A HREF="h_config_quell_flowed_text"><!--#echo var="FEAT_quell-flowed-text"--></A>
 640         was not turned on
 641    <LI> Don't allow printer to be changed through hidden config screen
 642         if system administrator didn't want it to be allowed
 643    <LI> Attempts are sometimes made to set the Forwarded flag when alpine
 644         should know that it won't work, causing error messages to appear
 645    <LI> A <A HREF="h_config_reply_indent_string"><!--#echo var="VAR_reply-indent-string"--></A>
 646         of double-quote double-quote didn't work right
 647    <LI> Quoting wasn't being done to protect special characters from the
 648         MacOS X shell when
 649         <A HREF="h_config_browser"><!--#echo var="VAR_url-viewers"--></A>
 650         was not defined
 651    <LI> On MacOS X message attachments should be shown internally instead of
 652         being shown using the Mail application
 653    <LI> When replying to a message with a charset of X-UNKNOWN Alpine would
 654         sometimes set the outgoing charset to X-UNKNOWN, making the result
 655         unreadable
 656    <LI> When the sending of a message failed lines with leading spaces had one
 657         additional space inserted in each of those lines when the user
 658         was returned to the composer
 659    <LI> The <A HREF="h_index_cmd_whereis">WhereIs</A> command missed some index lines
 660         that contained non-ascii characters because it was truncating the
 661         line being searched so that it was shorter than what was visible on
 662         the screen
 663    <LI> When composing, an attachment with a long name that causes wrapping in
 664         just the wrong place would generate an error and cause the send
 665         of the attachment to fail
 666    <LI> After calling the file browser to attach a file in the composer, a resize
 667         of the window when back in the composer would redraw the last screen that
 668         had been shown in the browser instead of the current composer screen
 669    <LI> Possible crash in index screen when encountering unparseable addresses
 670         or when using one of the PRIORITY tokens or the HEADER token in the
 671         <a href="h_config_index_format"><!--#echo var="VAR_index-format"--></a>
 672    <LI> Problems with Header Color editing if the configuration option
 673         <a href="h_config_customhdr_color"><!--#echo var="VAR_viewer-hdr-colors"--></a>
 674         was inadvertently changed to the Empty Value in the hidden config screen
 675    <LI> When resuming the final postponed message from an Exchange server the user
 676         could get a certificate validation failure because alpine was trying
 677         to validate the canonical name of the folder instead of the name the
 678         user used
 679    <LI> Windows line endings in a mimetypes file on a Unix system cause a
 680         failure to find a match
 681    <LI> Make matching of extension names case independent in mimetypes files
 682    <LI> Windows dialog boxes for entering text were not working correctly
 683    <LI> Replying to or Forwarding multipart/alternative messages which had a
 684         single text/html part did not work well
 685    <LI> Printing the print confirmation page caused a crash
 686    <LI> A To line with a long, quoted personal name could display incorrectly
 687         if it was close to the same width as the screen
 688    <LI> When <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
 689         and <A HREF="h_config_incoming_checking_total"><!--#echo var="FEAT_incoming-checking-includes-total"--></A>
 690         are turned on hide (0/0) when the folder is empty
 691    <LI> Folder completion while Saving didn't work if the collection being
 692         saved to was the local home directory
 693 </UL>
 694
 695 <P>
 696 Version 1.00
 697 was an evolutionary release based on
 698 <A HREF="http://www.washington.edu/pine/">Pine</A>, which was also
 699 developed at the University of Washington.
 700 It is upwards-compatible for existing Pine users.
 701
 702 <P>
 703 Changes included:
 704 <P>
 705 <UL>
 706    <LI> Ground-up reorganization of source code around addition
 707         of "pith/" core routine library.
 708    <LI> Fundamental improvement in Alpine's internal text handling, which
 709         is now based exclusively on Unicode. This allows displaying incoming
 710         messages and producing outgoing messages in many different languages.
 711    <LI> Ground-up reorganization of build and install procedures
 712         based on GNU Build System's autotools. NOTE, the included IMAP library
 713         build is not based on autotools, so some features will not work. However,
 714         it should get built automatically during the Alpine build process.
 715    <LI> Web-based version included built on TCL designed to run under
 716         a suitable CGI-supporting web server such as Apache.
 717 </UL>
 718
 719 <P>
 720
 721 Details on changes in previous (prerelease) versions of Alpine
 722 may be found at the following URL:
 723 <P>
 724 <CENTER><SAMP><A HREF="http://patches.freeiz.com/alpine/release/">http://patches.freeiz.com/alpine/release/</A></SAMP></CENTER>
 725 <P>
 726
 727 <HR WIDTH="75%"><P>
 728
 729 <H2>Getting Help</H2>
 730 <DL>
 731 <DT>Online Help</DT>
 732 <DD>
 733 Every Alpine screen and command has associated help text
 734 accessible via the &quot;?&quot; key (or Ctrl-G in text-input contexts).
 735 </DD>
 736
 737 <DT>Web Help</DT>
 738 <DD>
 739 The most current source of information about Alpine,
 740 including new version availability, is the web page at
 741 <P>
 742 <CENTER><SAMP><A HREF="http://patches.freeiz.com/alpine/">http://patches.freeiz.com/alpine/</A></SAMP></CENTER>
 743 </DD>
 744 </DL>
 745
 746 Frequently Asked Questions (and answers) may be found at the following
 747 URL:
 748 <P>
 749 <CENTER><SAMP><A HREF="http://www.washington.edu/alpine/faq/">http://www.washington.edu/alpine/faq/</A></SAMP></CENTER>
 750 <P>
 751
 752 <HR WIDTH="75%"><P>
 753
 754 <H2>Additional Information</H2>
 755
 756 General Alpine configuration information can be found
 757 <A HREF="h_news_config">here</A>.
 758 <P>
 759 This is revision (<!--#echo var="ALPINE_REVISION"-->) of the Alpine software.
 760 Alpine mailbox and <A HREF="https://github.com/jonabbey/panda-imap/">IMAP</A> server
 761 access is provided by the IMAP Toolkit Environment (c-client library)
 762 version <!--#echo var="C_CLIENT_VERSION"-->.
 763 <P>
 764 Alpine was developed until 2009 by the Office of Computing
 765 &amp; Communications at the University of Washington in Seattle.
 766 Since then, the effort of developing Alpine has been continued by
 767 a community of volunteers who make good software even better!
 768
 769 <P>
 770 Alpine Copyright 2013-2014 Eduardo Chappa,
 771 <BR> Copyright 2006-2008 University of Washington.
 772
 773 <P>
 774 Additional legal notices can be found <A HREF="h_news_legal">here</A>,
 775 or instead you can find the Apache License, version 2.0 at the web URL:
 776
 777 <P>
 778 <CENTER><A HREF="http://www.apache.org/licenses/LICENSE-2.0">http://www.apache.org/licenses/LICENSE-2.0</A></CENTER>
 779
 780 <P>
 781 &lt;End of Release Notes&gt;
 782 </BODY>
 783 </HTML>
 784 ====== h_password_file_support ======
 785 <HTML>
 786 <HEAD>
 787 <TITLE>Encryption for Password File Support Explained</TITLE>
 788 </HEAD>
 789 <BODY>
 790 <H1>Encryption for Password File Support Explained</H1>
 791
 792 Index<BR>
 793 <OL>
 794 <LI><A HREF="#content">Explanation</A>
 795 <LI><A HREF="#example">Example</A>
 796 </OL>
 797
 798 <P><A NAME="content">Unix Alpine Only.</A>
 799
 800 <P> If your version of Alpine has been built with password file support
 801 then you can use a special file to save your passwords, and avoid typing
 802 them every time you open a connection to a remote server.
 803
 804 <P> If your version of Alpine was built with SMIME support, and you have a
 805 public certificate/private key pair, then Alpine will use such pair to
 806 encrypt your password file. If you have more than one key/certificate
 807 pair, Alpine will pick the first pair that it finds that works. You can also
 808 select a pair, and the way to do this is explained below.
 809
 810 <P> Once a pair has been chosen, it will be copied to the directory
 811 ~/.alpine-smime/.pwd, and from then on, Alpine will use the pair found in
 812 that directory. The first time this process is done, this directory will
 813 be created, a key/certificate pair will be copied to it, and this pair
 814 will be used in the future to encrypt and decrypt your password file. You
 815 can create this directory and copy any key/certificate pair there. You
 816 can add a self-signed certificate there, if you like, and you can let
 817 this certificate expire. This will not affect the encryption and decryption
 818 of the password file.
 819
 820 <P> If you prefer not to use the directory ~/.alpine-smime/.pwd to save
 821 your key/certificate pair, you can specify a different one with the
 822 -pwdcertdir command line option in Alpine. If the directory specified by
 823 this option is not found or there is no valid key/certificate pair there,
 824 Alpine will fail to encrypt and decrypt your password file. In other words,
 825 Alpine will not initialize this directory for you.
 826
 827 <P> Alpine does not care about the names of the key and certificates in
 828 this directory, but the private key must have &quot;.key&quot; extension
 829 and your public certificate must have the &quot;.crt&quot; extension. The
 830 name of the private key will be used in the prompt when you are asked
 831 to unlock your key to decrypt your password.
 832
 833 <P><A NAME="example">An example follows</A>
 834
 835 <P>Assume you have a private key called peter@address.com.key in your,
 836 ~/.alpine-smime/private directory, and a public certificate called
 837 peter@address.com.crt in your ~/.alpine-smime/public directory, and these
 838 are your only key/certificate pair.
 839
 840 <P> When Alpine starts for the first time, without command line options,
 841 it will check if the directory ~/.alpine-smime/.pwd exists, and if not,
 842 it will create it. Then it will go through your keys and certificates and
 843 find a pair that it can use, and copy the files peter@address.com.key,
 844 and peter@address.com.crt to the ~/.alpine-smime/.pwd directory. Alternatively
 845 you can do the same by copying these files by yourself. This can be done
 846 with the sequence of commands
 847
 848 <PRE>
 849 mkdir ~/.alpine-smime/.pwd
 850 cp ~/.alpine-smime/private/peter@address.com.key ~/.alpine-smime/.pwd
 851 cp ~/.alpine-smime/public/peter@address.com.crt ~/.alpine-smime/.pwd
 852 </PRE>
 853
 854 <P> When Alpine starts, you will be asked the password to unlock your
 855 private key with the prompt.
 856
 857 <PRE>
 858 Enter password of key &lt;peter@address.com&gt; to unlock password file:
 859 </PRE>
 860
 861 <P> If you prefer to use different names for your private and public keys
 862 in the ~/.alpine-smime/.pwd directory, you can do so, but you must
 863 preserve the extension of the files. For example, you can use the names
 864 private_key.key and public_cert.crt instead. In this case, the prompt you
 865 will see when you are asked to unlock your private key will read
 866
 867 <PRE>
 868 Enter password of key &lt;private_key&gt; to unlock password file:
 869 </PRE>
 870
 871 <P>Observe that you do not need to use an existing key/certificate pair,
 872 and that you can create a new private key/public certificate pair to
 873 encrypt and decrypt your password. However, once one is used, Alpine does
 874 not provide a mechanism to switch the encryption and decryption files to
 875 another key/certificate pair. This will be implemented in a future
 876 release of Alpine.
 877
 878 <P>
 879 &lt;End of help&gt;
 880 </BODY>
 881 </HTML>
 882 ====== h_tls_failure_details ======
 883 <HTML>
 884 <HEAD>
 885 <TITLE>Certificate Validation Details</TITLE>
 886 </HEAD>
 887 <BODY>
 888 <H1>Certificate Validation Details</H1>
 889
 890 This screen gives details as to why the certificate validation failed: the
 891 name of the desired server system; the reason for failure; and the name on
 892 the certificate.  This is primarily of interest to experts.
 893
 894 <P>
 895 &lt;End of help&gt;
 896 </BODY>
 897 </HTML>
 898 ====== h_tls_failure ======
 899 <HTML>
 900 <HEAD>
 901 <TITLE>TLS or SSL Failure</TITLE>
 902 </HEAD>
 903 <BODY>
 904 <H1>TLS or SSL Failure</H1>
 905
 906 An attempt was made to establish a secure, encrypted connection to the
 907 server system using either Transport Layer Security (TLS) or the older
 908 Secure Sockets Layer (SSL).  This attempt failed.
 909
 910 <P>
 911 You should contact your server system management for more assistance.
 912 The problem is probably at the server system and not in Alpine or your local
 913 system.  The text in this screen may be helpful for the server system
 914 management in debugging the problem,
 915
 916 <P>
 917 &lt;End of help&gt;
 918 </BODY>
 919 </HTML>
 920 ====== h_tls_validation_failure ======
 921 <HTML>
 922 <HEAD>
 923 <TITLE>TLS and SSL Certificate Validation Failures</TITLE>
 924 </HEAD>
 925 <BODY>
 926 <H1>TLS and SSL Certificate Validation Failures</H1>
 927
 928 An attempt was made to establish a secure, encrypted connection to the
 929 server system using either Transport Layer Security (TLS) or the older
 930 Secure Sockets Layer (SSL).
 931
 932 <P>
 933 An important part of this procedure is server certificate validation.  A
 934 server certificate is an &quot;electronic identification card&quot; for the server
 935 system that is signed by a well-known certificate authority (CA).  Alpine
 936 compares the server system identity in the server certificate with the
 937 name of the server system to which it is trying to connect.  Alpine also
 938 verifies that the CA signature is authentic.
 939
 940 <P>
 941 Some common failure conditions are:
 942 <P>
 943
 944 <UL>
 945   <LI> [UNIX Alpine] Self signed certificate.  This means that the server system
 946 signed its own certificate.  This does not necessarily indicate anything
 947 bad; the server operators may simply have elected to not purchase a
 948 signed certificate from a certificate authority.
 949
 950   <LI> [UNIX Alpine] Unable to get local issuer certificate.  This means that
 951 the signature on the server system is from an unknown certificate authority.
 952 It can also mean that no certificate authority certificates have been
 953 installed on the local UNIX system.
 954
 955   <LI> [PC Alpine] Self-signed certificate or untrusted authority.  This is
 956 the same as either of the above two conditions in UNIX Alpine.  Note that
 957 Windows systems typically have a full set of certificate authority
 958 certificates installed, so it is more likely to be a self-signed
 959 certificate than an unknown certificate authority.
 960
 961   <LI> Server name does not match certificate.  This means that the server
 962 presented a proper signed certificate for a name other than the desired
 963 name.
 964 </UL>
 965
 966 <P>
 967 Any of these conditions can indicate that you are being attacked and have
 968 been directed to an imposter server that will record your password and
 969 your private mail messages.  It can also mean something innocuous.
 970
 971 <P>
 972 If you are certain that the problem is innocuous, you can append the
 973 option
 974
 975 <P>
 976 <CENTER><SAMP>/novalidate-cert</SAMP></CENTER>
 977 <P>
 978
 979 to the server system name where it appears in your configuration (e.g. the
 980 <A HREF="h_config_inbox_path"><!--#echo var="VAR_inbox-path"--></A>,
 981 a folder-collection, or a news or SMTP server).  This will
 982 disable certificate validation.  On the other hand, if you are attacked,
 983 you will get no warning if you do this.
 984
 985 <P>
 986 &lt;End of Cert Validation Failures help&gt;
 987 </BODY>
 988 </HTML>
 989 ====== h_release_tlscerts ======
 990 <HTML>
 991 <HEAD>
 992 <TITLE>TLS and SSL usage note</TITLE>
 993 </HEAD>
 994 <BODY>
 995 <H1>TLS and SSL usage note</H1>
 996
 997 <P>
 998 When using Alpine from Unix or Windows 2000,
 999 server certificates must be signed by a trusted certificate authority.
1000 You may relax this requirement (at the cost of some security) by using
1001 the
1002 <A HREF="h_folder_server_syntax">NoValidate-Cert</A>
1003 modifier in the mailbox name.
1004
1005 <P>
1006 <CENTER><SAMP>{foo.example.com/novalidate-cert}INBOX</SAMP></CENTER>
1007 <P>
1008
1009 The fully-qualified host name of the server should be used
1010 so that it matches the host name in the server certificate.
1011 <P>
1012 Here is an example of a host specification that directs Alpine to use
1013 the SSL port (993) and an encrypted data stream.
1014 <P>
1015 <CENTER><SAMP>{foo.example.com/ssl}INBOX</SAMP></CENTER>
1016 <P>
1017 &lt;End of TLS usage help&gt;
1018 </BODY>
1019 </HTML>
1020 ====== h_news_config ======
1021 <HTML>
1022 <HEAD>
1023 <TITLE>Alpine Configuration</TITLE>
1024 </HEAD>
1025 <BODY>
1026 <H1>Alpine Configuration</H1>
1027
1028 <H2>Using Environment Variables</H2>
1029
1030 The values of Alpine configuration options may include environment variables
1031 that are replaced by the value of the variable at the time Alpine is run
1032 (and also at the time the config option is changed).
1033 The syntax to use environment variables is a subset of the common Unix
1034 shell dollar-syntax.
1035 For example, if
1036
1037 <P><CENTER><SAMP>$VAR</SAMP></CENTER><P>
1038
1039 appears in the value of an Alpine configuration option it is looked up in the
1040 environent (using getenv(&quot;VAR&quot;)) and its
1041 looked-up value replaces the <SAMP>$VAR</SAMP> part of the option value.
1042 To include a literal dollar sign you may precede the dollar sign with another
1043 dollar sign.
1044 In other words, if the text
1045
1046 <P><CENTER><SAMP>$$text</SAMP></CENTER><P>
1047
1048 is the value of a configuration option, it will be expanded to
1049
1050 <P><CENTER><SAMP>$text</SAMP></CENTER><P>
1051
1052 and no environment lookup will be done.
1053 For Unix Alpine it will also work to use a backslash character to
1054 escape the special meaning of the dollar sign, but $$ is preferable since
1055 it works for both PC-Alpine and Unix Alpine, allowing the configuration option
1056 to be in a shared configuration file.
1057 <P>
1058
1059 This all sounds more complicated than it actually is.
1060 An example may make it clearer.
1061 Unfortunately, the way in which environment variables are set is OS-dependent
1062 and command shell-dependent.
1063 In some Unix command shells you may use
1064
1065 <P><CENTER><SAMP>PERSNAME="Fred Flintstone"</SAMP></CENTER><P>
1066    <CENTER><SAMP>export PERSNAME</SAMP></CENTER><P>
1067
1068 Now, if you use Alpine's Setup/Config screen to set
1069
1070 <P><CENTER><SAMP><!--#echo var="VAR_personal-name"-->=$PERSNAME</SAMP></CENTER><P>
1071
1072 the <SAMP>$PERSNAME</SAMP> would be replaced by <SAMP>Fred Flintstone</SAMP>
1073 so that this would be equivalent to
1074
1075 <P><CENTER><SAMP><!--#echo var="VAR_personal-name"-->=Fred Flintstone</SAMP></CENTER><P>
1076
1077 Note, environment variable substitution happens after configuration
1078 options that are lists are split into the separate elements of the list,
1079 so a single environment variable can't contain a list of values.
1080
1081 <P>
1082 The environment variable doesn't have to be the only thing
1083 after the equal sign.
1084 However, if the name of the variable is not at the end of the line or
1085 followed by a space (so that you can tell where the variable name ends),
1086 it must be enclosed in curly braces like
1087
1088 <P><CENTER><SAMP>${VAR}</SAMP></CENTER><P>
1089
1090 It is always ok to use the braces even if you don't need to.
1091 <P>
1092 It is also possible to set a default value for an environment variable.
1093 This default value will be used if the environment variable is not
1094 set (that is, if getenv(&quot;VAR&quot;) returns NULL).
1095 The syntax used to set a default value is
1096
1097 <P><CENTER><SAMP>${VAR:-default value}</SAMP></CENTER><P>
1098
1099 If the config file contains
1100
1101 <P><CENTER><SAMP>personal-name=${VAR:-Fred Flintstone}</SAMP></CENTER><P>
1102
1103 then when Alpine is run <SAMP>VAR</SAMP> will be looked up in the environment.
1104 If <SAMP>VAR</SAMP> is found then <SAMP>personal-name</SAMP> will have
1105 the value that <SAMP>VAR</SAMP> was set to, otherwise,
1106 <SAMP>personal-name</SAMP> will be set to <SAMP>Fred Flintstone</SAMP>,
1107 the default value.
1108 (Note that the variable is called &quot;personal-name&quot; in the config
1109 file but is displayed in the config screen as
1110 &quot;<!--#echo var="VAR_personal-name"-->&quot;.
1111 In general, the value that goes into a config file is never exactly the
1112 same as the value you see on the screen.)
1113
1114 <P>
1115 An example where an environment variable might be useful is the
1116 variable <SAMP>Inbox-Path</SAMP> in the global configuration file.
1117 Suppose most users used the server
1118
1119 <P><CENTER><SAMP>imapserver.example.com</SAMP></CENTER><P>
1120
1121 but that there were some exceptions who used
1122
1123 <P><CENTER><SAMP>altimapserver.example.com</SAMP></CENTER><P>
1124
1125 In this case, the system manager might include the following line in
1126 the systemwide default Alpine configuration file
1127
1128 <P><CENTER><SAMP>Inbox-Path=${IMAPSERVER:-imapserver.example.com}</SAMP></CENTER><P>
1129
1130 For the exceptional users adding
1131
1132 <P><CENTER><SAMP>IMAPSERVER=altimapserver.example.com</SAMP></CENTER><P>
1133
1134 to their environment should work.
1135 <P>
1136 Another example might be the case where a user has to use a different
1137 SMTP server from work and from home.
1138 The setup might be something as simple as
1139
1140 <P><CENTER><SAMP>smtp-server=$SMTP</SAMP></CENTER><P>
1141
1142 or perhaps a default value could be given.
1143 Note that, as mentioned above, the variable <SAMP>SMTP</SAMP> cannot contain
1144 a list of SMTP servers.
1145 <P>
1146
1147 <H2>Configuration precedence</H2>
1148
1149 There are several levels of Alpine configuration.  Configuration values at
1150 a given level override corresponding values at lower levels.  In order of
1151 increasing precedence:
1152 <P>
1153 <UL>
1154  <LI> built-in defaults
1155  <LI> system-wide
1156 <!--chtml if pinemode="os_windows"-->
1157       config file from command line or provided
1158       by "PINECONF" environment variable
1159 <!--chtml else-->
1160       pine.conf file
1161 <!--chtml endif-->
1162  <LI> personal configuration file
1163  <LI> personal exceptions configuration file
1164  <LI> command-line options
1165  <!--chtml if pinemode="os_windows"--><!--chtml else-->
1166  <LI> system-wide pine.conf.fixed file<!--chtml endif-->
1167 </UL>
1168 <P>
1169 The values in both the personal configuration file and the
1170 <A HREF="h_config_exceptions">exceptions</A>
1171 configuration file may be set using the Setup command.
1172 Setup/Config is the command to change most of the personal configuration
1173 options.
1174 The other Setup subcommands are also used to change the configuration,
1175 for example, Setup/AddressBook, Setup/Rules, and so on.
1176 Changing the personal exceptions configuration is very similar.
1177 To change a value in the Config screen you would use the command
1178 Setup/eXceptions/Config.
1179 Likewise for the other Setup subcommands (Setup/eXceptions/Rules and so on).
1180 <P>
1181 There are a couple exceptions to the rule that configuration values are replaced
1182 by the value of the same option in a higher-precedence file.
1183 The Feature-List variable has values that are additive, but can be
1184 negated by prepending &quot;no-&quot; in front of an individual feature name.
1185 So for features, each individual feature's value is replaced by the value
1186 of the same feature in a higher-precedence file.
1187 Note that this is done automatically for you when you change these values via
1188 the Setup/Config command.
1189 The other exception to the <EM>replace</EM> semantics happens when you
1190 use <A HREF="h_config_inheritance">configuration inheritance</A>
1191 for option lists.
1192 <P>
1193
1194 <H2>File name defaults</H2>
1195
1196 Notes:<P>
1197
1198 <BR> &lt;exe dir&gt; = directory where pine.exe found.
1199 <BR> &lt;pinerc dir&gt; = directory where pinerc found.
1200 <BR> # = default file name is overridable in pinerc.
1201 <BR> $HOME, if not explicitly set, defaults to root of the current drive.
1202 <BR> $MAILCAPS, if set, is used in lieu of the default mailcap search paths.
1203 <BR> + between the mailcap paths implies that the two files are combined.
1204 <BR> ; between other default paths implies that the first one found is used.
1205 </P>
1206 Alpine looks for most support files in the same directory it finds its
1207 personal configuration file (pinerc).  The -p command-line flag may be
1208 used to specify a particular path name for the pinerc file.  If a
1209 pinerc file does not exist, it will be created (if directory permissions
1210 allow).  In PC-Alpine, if -p or $PINERC are not defined, Alpine will look
1211 in $HOME&#92;PINE and the directory containing the PINE.EXE.  If a PINERC
1212 file does not exist in either one, it will create one in the first of those
1213 two directories that is writable.  In detail:
1214 <PRE>
1215
1216 PC-Alpine:
1217
1218  executable     &lt;DOS search path&gt;&#92;pine.exe
1219  help index     &lt;exe dir&gt;&#92;pine.ndx
1220  help text      &lt;exe dir&gt;&#92;pine.hlp
1221
1222  pers config    $PINERC  ;  $HOME&#92;pine&#92;PINERC  ;  &lt;exe dir&gt;&#92;PINERC
1223  except config  $PINERCEX ; $HOME&#92;pine&#92;PINERCEX  ;  &lt;exe dir&gt;&#92;PINERCEX
1224  global cfg     $PINECONF
1225
1226  debug          &lt;pinerc dir&gt;&#92;pinedebg.txtN
1227  crash          &lt;pinerc dir&gt;&#92;pinecrsh.txt
1228  signature#     &lt;pinerc dir&gt;&#92;pine.sig
1229  addressbook#   &lt;pinerc dir&gt;&#92;addrbook
1230  mailcap#       &lt;pinerc dir&gt;&#92;mailcap  +  &lt;exe dir&gt;&#92;mailcap
1231  mimetypes#     &lt;pinerc dir&gt;&#92;mimetype +  &lt;exe dir&gt;&#92;mimetype
1232  newsrc#        $HOME&#92;newsrc (if exists, else) &lt;pinerc dir&gt;&#92;newsrc
1233  sentmail#      $HOME&#92;mail&#92;sentmail.mtx
1234  postponed#     $HOME&#92;mail&#92;postpond.mtx
1235  interrupted    $HOME&#92;mail&#92;intruptd
1236
1237 Unix Alpine:
1238
1239  executable     &lt;Unix search path&gt;/pine
1240  persnl cfg     ~/.pinerc
1241  except cfg     ~/.pinercex
1242  global cfg     <!--#echo var="PINE_CONF_PATH"-->
1243  fixed cfg      <!--#echo var="PINE_CONF_FIXED_PATH"-->
1244  local help     <!--#echo var="PINE_INFO_PATH"-->
1245
1246  interrupted    ~/.pine-interrupted-mail
1247  debug          ~/.pine-debugN
1248  crash          ~/.pine-crash
1249  newsrc#        ~/.newsrc
1250  signature#     &lt;pinerc dir&gt;/.signature
1251  addressbook#   &lt;pinerc dir&gt;/.addressbook
1252  postponed#     ~/mail/postponed-msgs
1253  sentmail#      ~/mail/sent-mail
1254  mailcap#       ~/.mailcap + /etc/mailcap
1255                            + /usr/etc/mailcap + /usr/local/etc/mailcap
1256  mimetypes#     ~/.mime.types + /etc/mime.types + /usr/local/lib/mime.types
1257
1258  news-spool     varies across Unix flavors, e.g. /var/spool/news or /usr/spool/news
1259  active-news    varies across Unix flavors, e.g. /usr/lib/news/active
1260  lock files     /tmp/.<!--#echo var="MAIL_SPOOL_LOCK_PATH"-->
1261  inbox          <!--#echo var="MAIL_SPOOL_PATH"-->
1262  password       /etc/passwd
1263
1264 Unix Alpine and PC-Alpine:
1265
1266  .ab*           remote addressbook support files
1267  a[1-9]*        temporary (while Alpine is running) addressbook files
1268
1269 </PRE>
1270 <P>
1271
1272 <H2>Mailcap files</H2>
1273
1274 Alpine honors the mailcap configuration system for specifying external
1275 programs for handling attachments.  The mailcap file maps MIME attachment
1276 types to the external programs loaded on your system that can display
1277 and/or print the file.  A sample mailcap file comes bundled with the Alpine
1278 distribution.  It includes comments that explain the syntax you need to
1279 use for mailcap.  With the mailcap file, any program (mail readers,
1280 newsreaders, WWW clients) can use the same configuration for handling
1281 MIME-encoded data.
1282 <P>
1283
1284 <H2>MIME-Types files</H2>
1285
1286 Alpine uses mime-types files (.mime.types or MIMETYPE) to determine
1287 what Content-Type to use for labeling an attached file, based on
1288 the file extension.  That is, this file provides a mapping between
1289 filename extensions and MIME content-types.
1290 <P>
1291
1292 <H2>Environment variables</H2>
1293
1294 PC-Alpine uses the following environment variables:
1295 <DL>
1296 <DT>PINERC</DT>
1297 <DD>Optional path to pinerc file.</DD>
1298 <DT>PINERCEX</DT>
1299 <DD>Optional path to personal exceptions configuration file.</DD>
1300 <DT>PINECONF</DT>
1301 <DD>Optional path to global pine config file.</DD>
1302 <DT>HOME</DT>
1303 <DT>TMPDIR, TMP, or TEMP</DT>
1304 <DT>COMSPEC</DT>
1305 <DT>MAILCAPS</DT>
1306 <DD>A <B>semicolon</B> delimited list of path names to mailcap files.</DD>
1307 <DT>USER_DICTIONARY</DT>
1308 <DD>Used to specify the file to contain the user's spell check
1309 dictionary.  The default is <SAMP>DICT.U</SAMP> in the same
1310 directory as the <SAMP>SPELL32.DLL</SAMP></DD>
1311 </DL>
1312
1313 Unix Alpine uses the following environment variables:
1314 <DL>
1315 <DT>TERM</DT>
1316 <DD>Tells Alpine what kind of terminal is being used.</DD>
1317 <DT>DISPLAY</DT>
1318 <DD>Determines if Alpine will try to display IMAGE attachments.</DD>
1319 <DT>SHELL</DT>
1320 <DD>If not set, default is &quot;/bin/sh&quot;.</DD>
1321 <DT>TMPDIR, TMP, or TEMP</DT>
1322 <DT>MAILCAPS</DT>
1323 <DD>A <B>colon</B> delimited list of path names to mailcap files.</DD>
1324 </DL>
1325 <!--chtml if pinemode="os_windows"-->
1326 <P>
1327 <H2>Common PC-Alpine Configuration Problems</H2>
1328
1329 <H3>Configuration settings aren't being saved</H3>
1330
1331 <P>This problem can happen if you run pine from one directory and
1332 then decide to move your pine directory to another location.  PC-Alpine
1333 stores certain variables, including the configuration location, in the
1334 Windows Registry (which you shouldn't ever need to manually edit).  There
1335 are a couple of ways to go about removing or resetting the values in the
1336 registry.
1337
1338 <P>
1339 1) Run PC-Alpine's registry value deletion command.  This can be done by
1340 running: &quot;&lt;your&nbsp;pine&nbsp;directory&gt;&#92;pine.exe&nbsp;-registry&nbsp;clear&quot; from the DOS
1341 prompt. You could create a shortcut to pine.exe and change the &quot;Target&quot;
1342 value to the above command.
1343
1344 <P>
1345 2) Tell PC-Alpine where to look for the configuration file.  Configuration
1346 information is stored in a file called the PINERC.  With the &quot;-p&nbsp;PINERC&quot;
1347 option, you can tell PC-Alpine the location of your pinerc.  An example of
1348 this would be to run: &quot;&lt;your&nbsp;pine&nbsp;directory&gt;&#92;pine.exe&nbsp;-p&nbsp;C:&#92;pine&#92;mypinerc&quot;.
1349 Again, you can use the DOS prompt or the shortcut method explained in (1).
1350
1351 <P>
1352 Additionally, there is the &quot;-registry&nbsp;set&quot; option, which will actively
1353 set registry values to the current setting, and is therefore useful with
1354 the &quot;-p&nbsp;PINERC&quot; option.
1355
1356 <!--chtml endif-->
1357 <P>
1358 &lt;End of Configuration Notes&gt;
1359 </BODY>
1360 </HTML>
1361 ====== h_news_legal ======
1362 <html>
1363 <head>
1364 <TITLE>Alpine Legal Notices</TITLE>
1365 </head>
1366 <body>
1367
1368 <H1>Alpine Legal Notices</H1>
1369
1370 Alpine and its constituent programs are covered by the Apache License Version 2.0.
1371
1372
1373 <P>
1374 &lt;End of Alpine Legal Notices&gt;
1375 </BODY>
1376 </HTML>
1377 ===== h_info_on_mbox =====
1378 <HTML>
1379 <HEAD>
1380 <TITLE>Information on mbox driver</TITLE>
1381 </HEAD>
1382 <BODY>
1383 <H1>Information on &quot;Missing Mail&quot; and the &quot;mbox&quot; driver</H1>
1384
1385 Beginning with Pine 4.00 (Pine came before Alpine)
1386 a new INBOX access method is
1387 available as part of the standard configuration.  It is called the
1388 &quot;mbox&quot; driver and it works like this:<P>
1389
1390 <P>
1391 <BLOCKQUOTE>
1392 If the file &quot;mbox&quot; exists in the user's home directory, and
1393 is in Unix mailbox format, then when INBOX is opened this file will be
1394 selected as INBOX instead of the mail spool file.  Messages will be
1395 automatically transferred from the mail spool file into the mbox
1396 file.
1397 </BLOCKQUOTE>
1398
1399 <P>
1400 The advantage of this method is that, after new mail has been copied
1401 from the system mail spool, all subsequent access is confined to the
1402 user's home directory, which is desirable on some systems.  However, a
1403 possible disadvantage is that mail tools other than those from the
1404 University of Washington will not know to look for mail in the user's
1405 mbox file.  For example, POP or IMAP servers other than those from the
1406 University of Washington, and many &quot;new mail notification&quot;
1407 programs may not work as expected with this driver enabled.<P>
1408
1409 To disable this behavior, either remove/rename the &quot;mbox&quot;
1410 file or find the <A HREF="h_config_disable_drivers"><!--#echo var="VAR_disable-these-drivers"--></A>
1411 option in Setup/Config
1412 and add &quot;mbox&quot; to it:
1413 <P>
1414 <CENTER><SAMP><!--#echo var="VAR_disable-these-drivers"-->=mbox</SAMP></CENTER>
1415 <P>
1416 &lt;End of help on this topic&gt;
1417 </BODY>
1418 </HTML>
1419 ===== h_info_on_locking =====
1420 <HTML>
1421 <HEAD>
1422 <TITLE>FAQs on Alpine Locking</TITLE>
1423 </HEAD>
1424 <BODY>
1425 <H1>What Systems Managers Need to Know about Alpine File Locking</H1>
1426
1427 There is an extensive section on locking in the Alpine technical notes;
1428 this information is intended to provide answers to some common questions:<P>
1429 <OL>
1430 <LI> Why did locking change in Pine 4.00?<BR>
1431 The actual locking mechanisms did not change in 4.00.
1432 What changed is that when one particular locking mechanism used by Alpine
1433 fails, Alpine now issues a warning message.  Prior to Pine 4.00, the locking
1434 failure would occur, but no warning was issued.<P>
1435
1436 <LI> Is this what the &quot;Mailbox vulnerable&quot; message is about?<BR>
1437 Yes.  It means that Alpine was unable to create a lockfile in the
1438 spool directory, generally because of overly restrictive protections on the
1439 spool directory.  The correct permissions on the spool directory for
1440 running Alpine are 1777, i.e. read-write-execute permission for everyone,
1441 with the sticky-bit set, so only owners of a file can delete them.<P>
1442
1443 <LI> Why does Alpine require that the mail spool directory have 1777
1444    protections?<BR>
1445 Alpine was designed to run without special privileges.  This means that in
1446 order to create a lockfile in the spool directory, it is necessary to have
1447 the spool directory permissions be world-writable.<P>
1448
1449 <LI> Can't you create the lockfile somewhere else?<BR>
1450 No.  The lockfile in question must be in the mail spool directory, because
1451 that's where the mail delivery program expects to find it, and the purpose
1452 of the file is to coordinate access between the mail client (Alpine) and the
1453 mail delivery program.<P>
1454
1455 <LI> Isn't having the spool directory world-writable a big security risk?<BR>
1456 No.  Remember that the individual mail files in the spool directory are
1457 NOT world-writable, only the containing directory.  Setting the &quot;sticky
1458 bit&quot; -- indicated by the &quot;1&quot; before the &quot;777&quot; mode
1459 -- means that only the owner of the file (or root) can delete files in the
1460 directory.  So the only bad behavior that is invited by the 1777 mode is that
1461 anyone could
1462 create a random file in the spool directory.  If the spool directory is
1463 under quota control along with home directories, there is little incentive
1464 for anyone to do this, and even without quotas a periodic scan for
1465 non-mail files usually takes care of the problem.  <P>
1466
1467 <LI> Why not run Alpine as setgid mail?<BR>
1468 Alpine was never designed to run with privileges, and to do so introduces a
1469 significant security vulnerability.  For example, if a user suspends Alpine,
1470 the resulting shell will have group privileges.  This is one example of
1471 why we strongly recommend against running Alpine as a privileged program.
1472 In addition, a &quot;privileged mailer &quot paradigm would mean that normal
1473 users
1474 could not test Alpine versions or other mailers that had not been installed
1475 by the system administrators.<P>
1476
1477
1478 <LI> Are there any alternatives to creating .lock files in the spool dir?<BR>
1479 There are, but they all have different sets of tradeoffs, and not all will
1480 work on all systems.  Some examples:<UL>
1481  <LI> Use lock system calls.  Works fine on a few systems, provided mail
1482    spool is local.   Doesn't work reliably if NFS is used.
1483    Doesn't work unless <B>all</B> the mail programs accessing the spool dir
1484    use the same calls.
1485  <LI> Deliver mail to user's home directory.  An excellent solution, highly
1486    recommended -- but one which is incompatible with some &quot;legacy&quot;
1487 mail tools that always look in the spool directory for the mail.
1488 </UL><P>
1489
1490 <LI> Are these spool directory lock files the only kinds of locks used by
1491    Alpine?<BR>
1492 No.  Alpine also creates lockfiles in the /tmp directory.  For normal Unix
1493 mailbox format folders, these are used to coordinate access between
1494 multiple Alpine sessions.  <P>
1495
1496 <LI> What about the
1497 <A HREF="h_config_quell_lock_failure_warnings">&quot;<!--#echo var="FEAT_quell-lock-failure-warnings"-->&quot;</A> feature added in Pine 4.01?<BR>
1498 This is for people who are content to live dangerously, or who have
1499 specific knowledge that the spool directory lockfiles are superfluous on
1500 their system (because both Alpine and the mail delivery program are using
1501 system call file locking in a context that works reliably, e.g. not NFS.)<P>
1502
1503 <LI> Where can I find more details on how Alpine locking works?<BR>
1504 See the Alpine Technical Notes.<P>
1505
1506 </OL>
1507 <P>
1508 &lt;End of help on this topic&gt;
1509 </BODY>
1510 </HTML>
1511 ===== h_finding_help ====
1512 <HTML>
1513 <HEAD>
1514 <TITLE>Finding more information and requesting help</TITLE>
1515 </HEAD>
1516 <BODY>
1517 <H1>Places to Look for More Answers</H1>
1518 If you have questions about or problems with Alpine that you cannot resolve
1519 after consulting the program's internal, context-sensitive help screens, here
1520 are additional information resources that you may find helpful:
1521 <P>
1522 <UL>
1523   <LI> Alpine's top-level <A HREF="main_menu_tx">MAIN MENU HELP</A>.<P>
1524
1525   <LI> Alpine's <A HREF="h_help_index">Help Index</A>.<P>
1526
1527   <LI> Alpine's internal <A HREF="h_news">Release Notes</A>.  They contain a
1528 listing of changes in Alpine <!--#echo var="ALPINE_VERSION"-->
1529   since the last version, which may be useful for you to be aware of,
1530 <B>especially</B> if a &quot;problem&quot; you are encountering is actually
1531 a change in the way an aspect of Alpine works.  There, you will also find notes
1532 on Alpine configuration.<P>
1533
1534   <LI> The main site for Alpine contains information on configuring and solving problems
1535        with Alpine, it can be found at
1536
1537 <CENTER><A HREF="http://patches.freeiz.com/alpine/">http://patches.freeiz.com/alpine/</A></CENTER>
1538
1539   <LI> The Alpine Information Center (maintained by the University of
1540            Washington) World Wide Web site contains, among other things
1541            <UL>
1542            <LI>a collection of Frequently Asked Questions (and answers!) about Alpine
1543            <LI>an overview of the basics for beginning Alpine users
1544            <LI>Technical Notes for systems administrators
1545            <LI>archives (including a searchable index) of the alpine-info
1546 mailing list, on which matters of interest to systems/email administrators,
1547 developers, trainers, user support personnel, and others involved with Alpine
1548 messaging on a &quot;technical&quot; level are discussed.
1549 </UL>
1550         The Alpine Information Center can be accessed with a WWW browser at:<P>
1551             <CENTER><A HREF="http://www.washington.edu/alpine/">http://www.washington.edu/alpine/</A></CENTER>
1552 </UL>
1553 <P><HR WIDTH="75%">
1554 <H1>Requesting help</H1>
1555 If the internal help, the Release Notes, the Alpine Information Center, and your
1556 local online and print resources do not help you resolve a problem, please
1557 start by contacting your local computer support staff and asking for help.
1558 <p>
1559 This is especially true if:
1560 <ul>
1561   <li>You suddenly have trouble sending or receiving mail.
1562   <li>You receive a "disk quota exceeded" message.
1563   <li>You have forgotten your password.
1564   <li>You think your account may have been compromised.
1565   <li>You need help viewing an attachment.
1566   <li>You need to know how to configure your:
1567       <A HREF="h_config_nntp_server">NNTP (news) server</A>,
1568       <A HREF="h_config_smtp_server">SMTP (sending mail) server</A>,
1569       <A HREF="h_config_ldap_server">LDAP (directory lookup) server</A>, or
1570       <A HREF="h_config_inbox_path">INBOX (incoming mail) path</A>.
1571   <li>You want to know what alternative editors or spellcheckers you may be able to use.
1572   <li>You want to block email from a particular person.
1573   <li>You're going on vacation and need to autorespond to incoming mail.
1574   <li>You want to automatically file or filter incoming messages.
1575 </ul>
1576
1577 In all of these cases,
1578 you should contact <B>your</B> support staff, because <B>only they</B>
1579 will be able to assist you effectively. Your support staff may be, depending on who
1580 provides you with the email account you use Alpine with, for example:<UL>
1581 <LI> the computing help desk of (a department of) your university, school,
1582 employer, ... ; or
1583 <LI> the customer service center of your Internet Service Provider; or
1584 <LI> the friendly volunteer helpers of your Freenet; or
1585 <LI> the person who setup your computer and internet connection.
1586 </UL>
1587
1588 Due to the large number of Alpine installations worldwide, and because we
1589 receive no funding for it, the University of Washington <B>cannot provide
1590 individual support services outside the University of Washington</B>.
1591 <P>
1592 If you have no local computing support to turn to, the worldwide <b>comp.mail.pine</b>
1593 newsgroup can be a valuable source of information and assistance for Alpine
1594 user issues.
1595 <P>
1596 For systems/email administrators, developers, trainers, user support
1597 personnel, and others involved with Alpine messaging on a &quot;technical&quot;
1598 level, the mailing list alpine-info is available; for information on
1599 subscribing and posting to it, see
1600 <P>
1601 <CENTER><A HREF="http://www.washington.edu/alpine/alpine-info/subscribing.html">http://www.washington.edu/alpine/alpine-info/subscribing.html</A></CENTER>
1602 <P>
1603
1604 Regardless of whom you are asking for help with Alpine, remember
1605 to provide as much detail as you can about the
1606 nature of any problem you are encountering, such as
1607 <UL>
1608 <LI>when it first occurred;
1609 <LI>what, if anything, happened that might have brought it about;
1610 <LI>whether it still persists;
1611 <LI>whether it is reproducible, and if so, how;
1612 <LI>what, if anything, you already tried to solve it.
1613 </UL>
1614 It may also be helpful if you specify what version of Alpine you are using
1615 <!--chtml if pinemode="running"-->
1616 -- this is <!--#echo var="ALPINE_VERSION"--> --
1617 <!--chtml endif-->
1618 and on what system, and when the copy of Alpine you are using was created
1619 <!--chtml if pinemode="running"-->
1620 -- for this copy: <!--#echo var=ALPINE_COMPILE_DATE-->
1621 <!--chtml endif-->
1622
1623 <!--chtml if pinemode="running"-->
1624 <P>
1625 When the Alpine program you are currently using was installed, a support
1626 contact email address may have been set up; in that case, you can simply select
1627 this link now to send a message to it:<BR>
1628 <A HREF="X-Alpine-Gripe:_LOCAL_ADDRESS_?local"><!--#echo var="_LOCAL_FULLNAME_"--></A><P>
1629 <!--chtml endif-->
1630 <!--chtml if [ -r PINE_INFO_PATH ]-->
1631 <HR WIDTH="75%">Local Support Contacts:<P>
1632 <!--#include file="PINE_INFO_PATH"-->
1633 <HR WIDTH="75%">
1634 <!--chtml endif-->
1635 <P>
1636 &lt;End of help on this topic&gt;
1637 </BODY>
1638 </HTML>
1639 ===== new_user_greeting ======
1640 <HTML>
1641 <HEAD>
1642 <TITLE>NEW USER GREETING</TITLE>
1643 </HEAD>
1644 <BODY>
1645 <CENTER>&lt;&lt;&lt;This message will appear only once&gt;&gt;&gt;</CENTER>
1646 <BR>
1647 <H1>Welcome to Alpine ... a Program for Internet News and Email</H1>
1648 We hope you will explore Alpine's many capabilities. From the MAIN MENU,
1649 select Setup/Config to see many of the options available to you. Also note
1650 that all screens have context-sensitive help text available.<P>
1651 <!--chtml if pinemode="phone_home"-->
1652 SPECIAL REQUEST:
1653 This software was originally created and maintained as a public
1654 service by the University of Washington until 2009; updates are made
1655 available as a public service of the Alpine community. It is always
1656 helpful to have an idea of how many users are using Alpine. Are you
1657 willing to be counted as an Alpine user? Pressing
1658 <A HREF="X-Alpine-Phone-Home:">Return</A>
1659 will send an anonymous (meaning, your real email address will not be revealed)
1660 message to the Alpine developers for purposes of tallying.
1661 <P>
1662 <!--To Exit this screen and continue your Alpine session press "E".-->
1663 <!--chtml else-->
1664 To Exit this screen and continue your Alpine session press "Return".
1665 <!--chtml endif-->
1666 </BODY>
1667 </HTML>
1668 ===== new_alpine_user_greeting ======
1669 <HTML>
1670 <HEAD>
1671 <TITLE>NEW ALPINE USER GREETING</TITLE>
1672 </HEAD>
1673 <BODY>
1674 <CENTER>&lt;&lt;&lt;This message will appear only once&gt;&gt;&gt;</CENTER>
1675 <BR>
1676 <H1>Welcome to Alpine ... a Program for Internet News and Email</H1>
1677 Your Alpine configuration file indicates that you may have used Pine before
1678 but not Alpine.
1679 If you are familiar with the way Pine works, you should be comfortable
1680 using Alpine.
1681 Your Pine configuration file is automatically used for Alpine.
1682 The Release Notes may be viewed by pressing
1683 &quot;R&quot; now or while in the MAIN MENU.
1684 <P>
1685 <!--chtml if pinemode="phone_home"-->
1686 SPECIAL REQUEST:
1687 This software was originally created and maintained as a public
1688 service by the University of Washington until 2009; updates are made
1689 available as a public service of the Alpine community. It is always
1690 helpful to have an idea of how many users are using Alpine. Are you
1691 willing to be counted as an Alpine user? Pressing
1692 <A HREF="X-Alpine-Phone-Home:">Return</A>
1693 will send an anonymous (meaning, your real email address will not be revealed)
1694 message to the Alpine developers for purposes of tallying.
1695 <P>
1696 <!--To Exit this screen and continue your Alpine session press "E".-->
1697 <!--chtml else-->
1698 To Exit this screen and continue your Alpine session press "Return".
1699 <!--chtml endif-->
1700 </BODY>
1701 </HTML>
1702 ===== new_version_greeting ======
1703 <HTML>
1704 <HEAD>
1705 <TITLE>NEW VERSION GREETING</TITLE>
1706 </HEAD>
1707 <BODY>
1708 <CENTER>&lt;&lt;&lt;This message will appear only once&gt;&gt;&gt;</CENTER>
1709 <BR>
1710 <H1>Welcome to Alpine version <!--#echo var="ALPINE_VERSION"-->!</H1>
1711 Your Alpine configuration file indicates that you may not have used
1712 this version of Alpine before.  This version's significant changes are
1713 documented in the Release Notes, which may be viewed by pressing
1714 &quot;R&quot; now or while in the MAIN MENU.
1715 <P>
1716 <!--chtml if pinemode="phone_home"-->
1717 SPECIAL REQUEST:
1718 This software was originally created and maintained as a public
1719 service by the University of Washington until 2009; updates are made
1720 available as a public service of the Alpine community. It is always
1721 helpful to have an idea of how many users are using Alpine. Are you
1722 willing to be counted as an Alpine user? Pressing
1723 <A HREF="X-Alpine-Phone-Home:">Return</A>
1724 will send an anonymous (meaning, your real email address will not be revealed)
1725 message to the Alpine developers for purposes of tallying.
1726 <P>
1727 <!--To Exit this screen and continue your Alpine session press "E".-->
1728 <!--chtml else-->
1729 To Exit this screen and continue your Alpine session press "Return".
1730 <!--chtml endif-->
1731 </BODY>
1732 </HTML>
1733
1734 ===== main_menu_tx ======
1735 <HTML>
1736 <HEAD>
1737 <TITLE>GENERAL INFORMATION ON THE ALPINE MESSAGE SYSTEM</TITLE>
1738 </HEAD>
1739 <BODY>
1740 <H1>GENERAL INFORMATION ON THE ALPINE MESSAGE SYSTEM</H1>
1741 <DIV ALIGN=CENTER>
1742 Version <!--#echo var="ALPINE_VERSION"-->
1743 <!--chtml if pinemode="running"-->
1744 <BR>(built <!--#echo var=ALPINE_COMPILE_DATE-->)
1745 <!--chtml endif-->
1746 </DIV>
1747 <CENTER>Copyright 2013-2014 Eduardo Chappa,
1748 <BR>Copyright 2006-2008 University of Washington.
1749 </CENTER>
1750
1751 <P>
1752 When you are viewing a help screen, there may be links to
1753 other topics highlighted (in Reverse video) in the text.
1754 Here is an example.
1755 The word &quot;Introduction&quot; in the TABLE OF CONTENTS below should be
1756 highlighted.
1757 If you type carriage return (or V for View Link, see the commands at the
1758 bottom of the screen) you will be taken to a new help screen to view the
1759 Introduction.
1760 The commands at the bottom of the screen should then include
1761 &quot;P Prev Help&quot;.
1762 If you type &quot;P&quot; you will end up back here.
1763 If you type &quot;E&quot; for Exit, you will be back out of help and returned
1764 to the place you were in Alpine when you entered Help.
1765 In this case, you would go back to the MAIN MENU.
1766 There are also other links that are highlighted in bold (or the color used
1767 by your terminal to display bold).
1768 The items after the Introduction in the TABLE OF CONTENTS are all examples
1769 of such links.
1770 In order to view those links, you first have to make the link you want
1771 to view the current link.
1772 The &quot;NextLink&quot; and &quot;PrevLink&quot; commands
1773 (see bottom of screen) can do that for you.
1774 <P>
1775
1776 <H2>TABLE OF CONTENTS</H2>
1777 <OL>
1778   <LI> <A HREF="h_mainhelp_intro">Introduction</A>
1779   <LI> <A HREF="h_mainhelp_pinehelp">Alpine Help</A>
1780 <!--chtml if [ -r PINE_INFO_PATH ]-->
1781   <LI> <A HREF="h_mainhelp_localsupport">Local Support Contacts</A>
1782 <!--chtml endif-->
1783   <LI> <A HREF="h_mainhelp_cmds">Giving Commands in Alpine</A>
1784   <LI> <A HREF="h_mainhelp_config">Alpine Configuration</A>
1785   <LI> <A HREF="h_mainhelp_status">Titlebar Line</A>
1786   <LI> <A HREF="h_mainhelp_mainmenu">Main Menu</A>
1787   <LI> <A HREF="h_mainhelp_index">Index of Messages</A>
1788   <LI> <A HREF="h_mainhelp_reading">Reading Messages</A>
1789   <LI> <A HREF="h_mainhelp_composing">Composing Messages</A>
1790   <LI> <A HREF="h_mainhelp_readingnews">Reading News</A>
1791   <LI> <A HREF="h_mainhelp_abooks">Address Books</A>
1792   <LI> <A HREF="h_mainhelp_ldap">LDAP Directories</A>
1793   <LI> <A HREF="h_mainhelp_folders">Folders</A>
1794   <LI> <A HREF="h_mainhelp_collections">Collection Lists</A>
1795   <LI> <A HREF="h_mainhelp_aggops">Aggregate Operations</A>
1796   <LI> <A HREF="h_mainhelp_color">Color Setup</A>
1797   <LI> <A HREF="h_mainhelp_filtering">Filtering</A>
1798   <LI> <A HREF="h_mainhelp_roles">Roles</A>
1799   <LI> <A HREF="h_mainhelp_patterns">Patterns</A>
1800   <LI> <A HREF="h_mainhelp_keywords">Keywords (or Flags, or Labels)</A>
1801   <LI> <A HREF="h_mainhelp_mouse">Using a Mouse</A>
1802   <LI> <A HREF="h_mainhelp_cmdlineopts">Command Line Options</A>
1803   <LI> <A HREF="h_mainhelp_securing">Securing Your Alpine Session</A>
1804   <LI> <A HREF="h_mainhelp_smime">S/MIME</A>
1805   <LI> <A HREF="h_mainhelp_problems">Reporting Problems</A>
1806   <LI> <A HREF="X-Alpine-Config:">Show Supported Options in this Alpine</A>
1807   <LI> <A HREF="h_help_index">Index to Alpine's Online Help</A>
1808 </OL>
1809
1810 <P>
1811 &lt;End of help on this topic&gt;
1812 </BODY>
1813 </HTML>
1814 ===== h_mainhelp_intro ======
1815 <HTML>
1816 <HEAD>
1817 <TITLE>Introduction</TITLE>
1818 </HEAD>
1819 <BODY>
1820 <H1>Introduction</H1>
1821
1822 Alpine is an &quot;Alternatively Licensed Program for Internet
1823 News and Email&quot; produced until 2009 by the University of Washington.
1824 It is intended to be an easy-to-use program for
1825 sending, receiving, and filing Internet electronic mail messages and
1826 bulletin board (Netnews/Usenet) messages. Alpine supports the following
1827 Internet protocols and specifications: SMTP (Simple Mail Transport Protocol),
1828 NNTP (Network News Transport Protocol), MIME (Multipurpose Internet Mail
1829 Extensions), IMAP (Internet Message Access Protocol), and LDAP (Lightweight
1830 Directory Access Protocol).<p>
1831
1832 Although originally designed for inexperienced email users, Alpine has
1833 evolved to support many advanced features.  There are an ever-growing
1834 number of configuration and personal-preference options, though which of
1835 them are available to you is determined by your local system managers.
1836
1837 <H2>WHAT ALPINE DOES...</H2>
1838
1839 Alpine is a &quot;mail user agent&quot; (MUA), which is a program that
1840 allows you to
1841 compose and read messages using Internet mail standards.  (Whether you
1842 can correspond with others on the Internet depends on whether or not your
1843 computer is connected to the Internet.)  Alpine also allows reading and
1844 posting messages on the Internet &quot;net news&quot; system, provided
1845 that your site operates a suitable news server.
1846
1847 <H2>WHAT ALPINE DOES NOT DO...</H2>
1848
1849 A &quot;mail user agent&quot; such as Alpine is just one part of a
1850 messaging system. Here are some things that are <B>not</B> done by Alpine,
1851 but require other programs:<P>
1852 <UL>
1853  <LI> Actual relaying of email... which is done by &quot;message transfer
1854 agents&quot;.
1855  <LI> Vacation messages... automatically responding to incoming messages
1856  <LI> Anything to do with &quot;talk&quot;... which has nothing to do with
1857 email.
1858  <LI> Anything to do with &quot;irc&quot;... which has nothing to do with email.
1859  <LI> List processing... resending one message to a list of recipients.
1860 </UL>
1861
1862 <P>
1863 &lt;End of help on this topic&gt;
1864 </BODY>
1865 </HTML>
1866
1867 ===== h_mainhelp_pinehelp ======
1868 <HTML>
1869 <HEAD>
1870 <TITLE>Alpine Help</TITLE>
1871 </HEAD>
1872 <BODY>
1873 <H1>Alpine Help</H1>
1874
1875 Alpine help is generally context-sensitive. In other words, each Alpine screen you
1876 use will have its own help text, explaining the choices available for that
1877 screen. This general help section, on the other hand, attempts to give an
1878 overall picture of what Alpine is capable of doing, as well as pointers to
1879 additional help sections about specific topics.<p>
1880
1881 Much of the help text contains links to further help topics, similar to
1882 how the World Wide Web works.
1883 You may choose a link to view using the &quot;NextLink&quot; and
1884 &quot;PrevLink&quot; commands to change the link that is highlighted.
1885 The &quot;View Link&quot; command will then show you the highlighted link.
1886 Similar to the Back button in a web browser, the &quot;Prev Help&quot; command
1887 will return you to where you were before viewing the link, and &quot;Exit Help&quot
1888 will return you to the location in Alpine before you asked for help.
1889 For example, if you are reading this text in Alpine you may return to the
1890 help table of contents with the &quot;Prev Help&quot; command or you may view the
1891 Release notes link in the next paragraph and then return here with
1892 &quot;Prev Help&quot;.
1893 <P>
1894
1895 In addition to this general help on Alpine, <A HREF="h_news">Release Notes</A>
1896 on the current Alpine version are also available from the MAIN MENU: Press
1897 <!--chtml if pinemode="function_key"-->
1898 &quot;F9&quot;
1899 <!--chtml else-->
1900 &quot;R&quot;
1901 <!--chtml endif-->
1902 to browse the release notes.  These include changes since the last release,
1903 configuration information, the history of the Alpine
1904 project, credits, and legal notices.
1905
1906 Alpine releases are available via the world wide web at
1907 <P>
1908 <CENTER><SAMP><A
1909 HREF="http://patches.freeiz.com/alpine/release/">http://patches.freeiz.com/alpine/release/</A></SAMP
1910 ></CENTER>
1911 <P>
1912
1913 If you would like to print <EM>all</EM> of Alpine's internal help text
1914 (not recommended) for a little light bedtime reading, then press
1915 <!--chtml if pinemode="function_key"-->
1916 &quot;F12&quot;
1917 <!--chtml else-->
1918 &quot;Z&quot;
1919 <!--chtml endif-->
1920 now.  (This assumes that the
1921 copy of Alpine you are using has been properly configured for printing
1922 at your site.)
1923 <P>
1924 &lt;End of help on this topic&gt;
1925 </BODY>
1926 </HTML>
1927 ===== h_mainhelp_localsupport ======
1928 <HTML>
1929 <HEAD>
1930 <TITLE>Local Support Contacts</TITLE>
1931 </HEAD>
1932 <BODY>
1933 <H1>Local Support Contacts</H1>
1934
1935 <!--chtml if [ -r PINE_INFO_PATH ]-->
1936 <!--#include file="PINE_INFO_PATH"-->
1937 <!--chtml else-->
1938 No Local Support Contacts configured.
1939 <!--chtml endif-->
1940
1941 <P>
1942 &lt;End of help on this topic&gt;
1943 </BODY>
1944 </HTML>
1945
1946 ===== h_mainhelp_cmds ======
1947 <HTML>
1948 <HEAD>
1949 <TITLE>Giving Commands in Alpine</TITLE>
1950 </HEAD>
1951 <BODY>
1952 <H1>Giving Commands in Alpine</H1>
1953
1954 Unless configured otherwise
1955 (<A HREF="h_config_blank_keymenu"><!--#echo var="FEAT_disable-keymenu"--></A>)
1956 the bottom two lines of the screen are always used to list the
1957 commands you can give.  You press the keys that are highlighted to give
1958 the command.  The commands for getting help and going back to the main
1959 menu are always present (except when viewing help as you are now).
1960 <!--chtml if pinemode="function_key"-->
1961 <!--chtml else-->
1962 <p>
1963 Pressing O (meaning &quot;Other Commands&quot;) changes the keys
1964 you see at the bottom of any screen. In some cases there are 3 or
1965 even 4 different
1966 sets of keys that can be seen by using the O key. <EM>All commands are
1967 active</EM>, even if they are not currently showing at the bottom of your
1968 screen. In other words, you <EM>never</EM> need to press the O key, except to
1969 remind yourself of the proper key to press to perform an operation.
1970
1971 <H2>Control Key Commands</H2>
1972 When composing mail, and in a few other places, in Alpine you
1973 have to use Control keys. This means pressing the Control key (usually labeled
1974 &quot;Ctrl&quot;) and the
1975 letter indicated at the same time.  Usually, this is shown with a
1976 &quot;^&quot; in front of the letter.  On some systems, certain control
1977 characters are intercepted before they get to Alpine.  As a work-around,
1978 you can press the ESCAPE key twice followed by the desired key.  For
1979 example, if Ctrl-O (^O) does not work on your system, try typing
1980 &quot;ESC ESC O&quot;.
1981 <!--chtml endif-->
1982 <H2>Paging Up and Down</H2>
1983 The &quot;+&quot; and &quot;-&quot; keys are used for
1984 moving to the next or previous page.  The space bar is a synonym for
1985 &quot;+&quot;.  You may also use Ctrl-V to page down and Ctrl-Y to page
1986 up as you do in the message composer.  On screens with a WhereIs (search)
1987 command, W or Ctrl-W followed by Ctrl-V will move to the bottom of the
1988 message or list, and W or Ctrl-W followed by Ctrl-Y will move to the top
1989 of the message or list.
1990
1991 <H2>Return Key</H2>
1992 The return key is usually a synonym for a frequently used
1993 command.  When viewing a message, there is currently not a default
1994 command, so RETURN does nothing; when in the index, it is synonymous with
1995 &quot;view msg&quot;. In the key menu at the bottom of the screen, whatever is
1996 enclosed in square brackets [] is the same as the return key.
1997
1998 <H2>Control Keys Not Used By Alpine</H2>
1999 Most commands in Alpine are single letters, with -- we hope -- some mnemonic
2000 value, but in places where Alpine is expecting text input, e.g. in the composer or
2001 at prompts for file/folder names, control keys must be used for editing and
2002 navigation functions.
2003 <P>
2004
2005 Alpine has used nearly all the control keys available.  There are, however,
2006 certain control keys that are reserved by other programs or for technical
2007 reasons.  Alpine does not use any of these keys:
2008 <DL>
2009  <DT>Ctrl-S</DT> <DD>Used by Unix as &quot;stop output&quot;</DD>
2010  <DT>Ctrl-Q</DT> <DD>Used by Unix as &quot;resume output&quot;</DD>
2011  <DT>Ctrl-]</DT> <DD>Often used by Telnet as escape key</DD>
2012 </DL>
2013 <P>
2014 Note: Ctrl-S and Ctrl-Q can be subject to
2015 <A HREF="h_special_xon_xoff">special handling</A>.
2016 <P>
2017 In addition, while the ESC key alone is not used for command input,
2018 Alpine will recognize two consecutive ESC key presses followed by a letter
2019 key as a substitute for control key input.  For example, the control key
2020 <SAMP>Ctrl-X</SAMP> can alternatively be entered using the
2021 three keystrokes: <SAMP>ESC&nbsp;ESC&nbsp;x</SAMP>.
2022 This is useful if the communication program you are using
2023 (e.g. Telnet) has its own, conflicting, idea of what certain control
2024 characters mean.
2025
2026
2027 <H2>Repainting the Screen</H2>
2028 Sometimes what is displayed on the screen will be
2029 incorrect due to noise on the phone line or other causes and you will want
2030 to repaint the whole screen to make it correct.  You can use the Ctrl-L
2031 command to do this.  It never hurts to do it when in doubt.
2032
2033 <P>
2034 &lt;End of help on this topic&gt;
2035 </BODY>
2036 </HTML>
2037 ===== h_mainhelp_status ======
2038 <HTML>
2039 <HEAD>
2040 <TITLE>Titlebar Line</TITLE>
2041 </HEAD>
2042 <BODY>
2043 <H1>Titlebar Line</H1>
2044
2045 The top line of the screen is Alpine's titlebar line.  It will always display
2046 the current version of Alpine and will also convey information about the
2047 status of the program.  This is where you look to find out what
2048 collection, folder and message number is active and where you are in Alpine.
2049 <P>
2050
2051 If the titlebar line says &quot;READONLY&quot; it means that the open folder
2052 (typically your INBOX) is &quot;locked&quot; by another mail session --
2053 most likely a more recent session of Alpine has taken the INBOX lock.
2054 <P>
2055
2056 If the titlebar line says &quot;CLOSED&quot; it means that you are trying to
2057 access a
2058 folder on a remote mail server, and for some reason, communication with
2059 the mail server has either been lost, or never successfully established.
2060 This can be a result of trying to open a non-existent folder, or one
2061 stored on an invalid or non-operational server, or it can mean that Alpine
2062 has been suspended for more that 30 minutes while accessing a remote mail
2063 server.
2064
2065 <P>
2066 &lt;End of help on this topic&gt;
2067 </BODY>
2068 </HTML>
2069 ===== h_mainhelp_mainmenu ======
2070 <HTML>
2071 <HEAD>
2072 <TITLE>Main Menu</TITLE>
2073 </HEAD>
2074 <BODY>
2075 <H1>Main Menu</H1>
2076
2077 The Main Menu lists Alpine's main options.
2078 The key or keys you must type to enter your
2079 choice are to the left of each option or command name.
2080 You can type either uppercase or lowercase letters,
2081 and you should not press &lt;Return&gt; after typing the
2082 letter (unless you are specifically asking for the default,
2083 highlighted command).
2084 <P>
2085
2086 From the Main Menu you can choose to read online help, write (compose) and
2087 send a message, look at an index of your mail messages, open or maintain
2088 your mail folders, update your address book, configure Alpine, and quit Alpine.
2089 There are additional options listed at
2090 the bottom of the screen as well.
2091
2092 <P>
2093 The Help command usually returns context-sensitive help information.
2094 However, in the Main Menu you get the most general help, which includes
2095 a Table of Contents.
2096 The last entry in the Table of Contents is an Index of help topics,
2097 so this is a good place to go if you are having trouble finding how
2098 to do something.
2099
2100 <H2>Main Menu Commands</H2>
2101 The Alpine main menu lists the most common Alpine functions. A <a
2102 href="h_main_menu_commands">full list of these
2103 commands</a> and what they do is available.
2104 <P>
2105 &lt;End of help on this topic&gt;
2106 </BODY>
2107 </HTML>
2108 ===== h_mainhelp_abooks ======
2109 <HTML>
2110 <HEAD>
2111 <TITLE>Address Books</TITLE>
2112 </HEAD>
2113 <BODY>
2114 <H1>Address Books</H1>
2115
2116
2117 As you use email, you can build a list of your regular email correspondents
2118 in your Alpine
2119 Address Book. At the Alpine MAIN MENU, press A to see the Address Book List
2120 screen. Your
2121 personal address book will be highlighted. Press &lt;Return&gt; to view it.
2122 You can use the address book to store email addresses for individuals or
2123 groups, to create easily
2124 remembered &quot;nicknames&quot; for these addresses, and to quickly retrieve an email
2125 address when you are composing a message.
2126 <P>
2127 There are two ways to add addresses to your address book: you can add them
2128 manually or take them from messages (by pressing T to access the Take command).
2129 With either method, you specify nicknames for your correspondents. A single
2130 address book entry (or nickname) can point to just one email address, or, it can
2131 point to more than one. When it points to more than one, it is called a
2132 distribution list. Each distribution list has a nickname, a full name, and a
2133 list of addresses. These
2134 addresses may be actual addresses, other nicknames in your address book, or
2135 other
2136 distribution lists.
2137
2138 <P>
2139 Additional information is available in Alpine's online help:
2140 <ul>
2141   <li><a href="h_abook_opened">The Alpine Address Book</a></li>
2142 </ul>
2143 <P>
2144 &lt;End of help on this topic&gt;
2145 </BODY>
2146 </HTML>
2147 ===== h_mainhelp_ldap ======
2148 <HTML>
2149 <HEAD>
2150 <TITLE>LDAP</TITLE>
2151 </HEAD>
2152 <BODY>
2153 <H1>LDAP</H1>
2154
2155 LDAP (Lightweight Directory Access Protocol) is a standard means of accessing
2156 an organization's shared
2157 directories. Essentially, using LDAP, Alpine is able to find email addresses in
2158 large address
2159 books, rather like the White Pages provided by the phone company. As an Alpine
2160 user, it is not
2161 necessary to know much about how this works, only how to use it and how to
2162 configure
2163 it.
2164 <P>
2165 More information on configuring LDAP is available in Alpine's online help:
2166 <ul>
2167   <li><a href="h_direct_config">Setup LDAP Directory Servers</a></li>
2168 </ul>
2169 <P>
2170 Additional help on using LDAP in Alpine is also available:
2171 <ul>
2172   <li><a href="h_ldap_view">LDAP Response View Explained</a></li>
2173 </ul>
2174 <P>
2175 &lt;End of help on this topic&gt;
2176 </BODY>
2177 </HTML>
2178 ===== h_mainhelp_index ======
2179 <HTML>
2180 <HEAD>
2181 <TITLE>Index of Messages</TITLE>
2182 </HEAD>
2183 <BODY>
2184 <H1>Index of Messages</H1>
2185
2186 In Alpine's message index, the selected message is highlighted. The first
2187 column on the left is blank, shows a &quot;+&quot; if the message was
2188 sent directly to you (i.e., it is not a
2189 copy or from a list), or a &quot;-&quot; if you were explicitly Cc'd.
2190 <P>
2191 The second column may be blank, or it may contain:
2192 <ul>
2193   <li>"N" if the message is new (unread), </li>
2194   <li>"A" if you have answered the message (using the Reply command), </li>
2195   <li>"D" if you have marked the message for deletion.</li>
2196 </ul>
2197
2198 <P>
2199 Note: If you answer a message as well as mark it deleted (in either order),
2200 you will only see the &quot;D&quot;.
2201
2202 <P>
2203 The rest of the columns in the message line show you the message
2204 number, date sent, sender, size, and subject. For details, press ? (Help).
2205 The behavior and appearance of the Index screen is highly configurable.
2206 In the Setup/Config screen search (with the WhereIs command) for options
2207 that contain the words &quot;index&quot; or &quot;thread&quot; to see
2208 many of the configuration possibilities.
2209 In particular, the
2210 &quot;<A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A>&quot;
2211 option may be used to configure the look of the standard MESSAGE INDEX lines
2212 in many different ways.
2213 Find <!--#echo var="VAR_index-format"--> in the Setup/Config screen and
2214 read the help text there for more information.
2215 <P>
2216 Most of the commands you need to handle your messages are visible at the
2217 bottom of the screen, and you can press O (OTHER CMDS) to see additional
2218 commands that are available.
2219 You do not need to see these &quot;other commands&quot;
2220 on the screen to use them. That is, you never need to press O as a prefix
2221 for any other command.
2222
2223 <P>
2224 Additional information is available in Alpine's online help:
2225 <ul>
2226   <li><a href="h_mail_index">Message Index Commands</a></li>
2227 </ul>
2228 <P>
2229 &lt;End of help on this topic&gt;
2230 </BODY>
2231 </HTML>
2232 ===== h_mainhelp_reading ======
2233 <HTML>
2234 <HEAD>
2235 <TITLE>Reading Messages</TITLE>
2236 </HEAD>
2237 <BODY>
2238 <H1>Reading Messages</H1>
2239
2240 The message text screen shows you the text of the message along with
2241 its header. If a message has attachments, those will be listed (but not
2242 displayed) also.  The titlebar line displays information about the currently
2243 open message, folder and collection.  You see the name of the collection
2244 (if there is one) in angle brackets, then the name of the folder, then the
2245 message number and finally the position within the current message (in
2246 percent). If the message is marked for deletion
2247 &quot;DEL&quot; will appear in the
2248 upper right as well.
2249
2250 <P>
2251 As with every Alpine screen, the bottom two lines show you the commands
2252 available.
2253
2254 <P>Additional information is available in Alpine's online help:
2255 <ul>
2256   <li><a href="h_mail_view">Message Text Screen</a></li>
2257   <li><a href="h_attachment_screen">Attachment Index Screen Explained</a></li>
2258   <li><a href="h_mail_text_att_view">Attachment View Screen Explained</a></li>
2259 </ul>
2260 <P>
2261 &lt;End of help on this topic&gt;
2262 </BODY>
2263 </HTML>
2264 ===== h_mainhelp_composing ======
2265 <HTML>
2266 <HEAD>
2267 <TITLE>Composing Messages</TITLE>
2268 </HEAD>
2269 <BODY>
2270 <H1>Composing Messages</H1>
2271
2272 To write a message, press C (Compose). You see the Compose Message
2273 screen, which is divided into two parts: the header area and the message
2274 text area. The header area is where information on the recipient (the To:
2275 field) and the subject line go, while the message text area contains the
2276 actual text of the email message. Different commands are available to you
2277 when your cursor is in different areas on this screen. To see additional
2278 help on commands in either the message text or header area, type
2279 <Control>G (Get help).
2280
2281 <P>
2282 To move around, use the arrow keys or Ctrl-N (Next line) and Ctrl-P
2283 (Previous line); to correct typing errors, use &lt;Backspace&gt; or &lt;Delete&gt;.
2284
2285 <P>The following information from Alpine's online help may prove useful:
2286 <ul>
2287   <li><a href="h_composer_to">Message Header Commands</a></li>
2288   <li><a href="h_compose_richhdr">Rich Header Command</a></li>
2289   <li><a href="h_composer">Composer Commands</a></li>
2290   <li><a href="h_edit_nav_cmds">Composer Editing Commands</a></li>
2291   <li><a href="h_config_change_your_from">Changing your From Address</a></li>
2292   <li><a href="h_compose_send">Send Command</a></li>
2293   <li><a href="h_compose_spell">Spell Check Command</a></li>
2294 </ul>
2295 <P>
2296 &lt;End of help on this topic&gt;
2297 </BODY>
2298 </HTML>
2299 ===== h_mainhelp_collections ======
2300 <HTML>
2301 <HEAD>
2302 <TITLE>Collection Lists</TITLE>
2303 </HEAD>
2304 <BODY>
2305 <H1>Collection Lists</H1>
2306
2307 Collection lists are Alpine's way of organizing groups of folders. Each
2308 "collection" can reside on a different server, for example, and contain a
2309 different group of mail folders.
2310
2311 <P>
2312 For more information on this, see:
2313 <ul>
2314   <li><a href="h_what_are_collections">Folder Collections Explained</a></li>
2315 </ul>
2316 <P>
2317 Additional information relating to collection lists is also available in
2318 Alpine's online
2319 help:
2320 <ul>
2321   <li><a href="h_collection_maint">Setup Collection List Screen</a></li>
2322   <li><a href="h_collection_screen">Collection List Screen</a></li>
2323 </ul>
2324 <P>
2325 &lt;End of help on this topic&gt;
2326 </BODY>
2327 </HTML>
2328 ===== h_mainhelp_folders ======
2329 <HTML>
2330 <HEAD>
2331 <TITLE>Folders</TITLE>
2332 </HEAD>
2333 <BODY>
2334 <H1>Folders</H1>
2335
2336 Messages can quickly accumulate in your INBOX folder. If you use email
2337 often, you soon could have hundreds. You need to delete messages you do
2338 not want, and you can use folders to organize messages you wish to save. A
2339 folder is a collection of one or more messages that are stored (just like
2340 the messages in your INBOX) so you can access and manage them.
2341
2342 <P>
2343 You can organize your email messages into different folders by topic,
2344 correspondent, date, or any other category that is meaningful to you. You
2345 can create your own folders, and Alpine automatically provides three:
2346 <ul>
2347   <li>The INBOX folder: messages sent to you are listed in this folder.
2348       When you first start Alpine and go to the Message Index screen, you are
2349 looking at the list of messages in your INBOX folder. Every incoming
2350 message remains in your INBOX until you delete it or save it in another
2351 folder. </li>
2352   <li>The sent-mail folder: copies of messages you send are stored in this
2353 folder. This is
2354 convenient if you cannot remember whether you actually sent a message and want
2355 to check, or
2356 if you want to send a message again.</li>
2357   <li>The saved-messages folder: copies of messages you save are stored in this
2358 folder
2359 unless you choose to save them to other folders you create yourself.</li>
2360 </ul>
2361
2362 <P>
2363 More information about folders is available in Alpine's online help:
2364 <ul>
2365   <li><a href="h_folder_open">Explanation of Folder Selection</a></li>
2366   <li><a href="h_folder_maint">Help for Folder List</a></li>
2367   <li><a href="h_valid_folder_names">Explanation of Valid Folder Names</a></li>
2368   <li><a href="h_folder_fcc">Folder Select for Fcc ("sent-mail")
2369 Explained</a></li>
2370   <li><a href="h_folder_save">Folder Select for Save Explained</a></li>
2371 </ul>
2372 <P>
2373 &lt;End of help on this topic&gt;
2374 </BODY>
2375 </HTML>
2376 ===== h_mainhelp_color ======
2377 <HTML>
2378 <HEAD>
2379 <TITLE>Color</TITLE>
2380 </HEAD>
2381 <BODY>
2382 <H1>Color</H1>
2383
2384 If the terminal emulator you are using is capable of displaying color or if
2385 you are using PC-Alpine, then it is possible to set up Alpine so that various
2386 parts of the display will be shown in colors you configure. This is done
2387 using the Setup Color screen, available from the MAIN MENU by selecting
2388 the Setup command followed by &quot;K&quot; for Kolor (because &quot;C&quot;
2389 stands for Config in this context).
2390
2391 <P>
2392 For example, you may color things like the titlebar, the current item,
2393 the keymenu, and the status messages.
2394 You may also color lines in the index, and headers and quoted text in the
2395 MESSAGE TEXT screen.
2396 You use the Color Setup screen for configuring most of this, but you must
2397 use the IndexColor setup for coloring whole index lines.
2398 These are available from the MAIN MENU under Setup/Kolor and Setup/Rules/IndexColor.
2399
2400 <P>
2401 The following entries in Alpine's online help provide additional information
2402 about how to use color:
2403 <UL>
2404   <LI> <A HREF="h_color_setup">Color Setup screen</A>
2405   <LI> <A HREF="h_rules_incols">Index Line Color</A>
2406   <LI> <A HREF="h_config_quote_color">quoted text</A> in message view
2407   <LI> <A HREF="h_config_customhdr_pattern">text associated with user-defined headers</A> in message view
2408 </UL>
2409 <P>
2410 &lt;End of help on this topic&gt;
2411 </BODY>
2412 </HTML>
2413 ===== h_mainhelp_mouse ======
2414 <HTML>
2415 <HEAD>
2416 <TITLE>Using a Mouse</TITLE>
2417 </HEAD>
2418 <BODY>
2419 <H1>Using a Mouse</H1>
2420
2421 If you are using PC-Alpine mouse support is turned on automatically.
2422 If you are using UNIX Alpine within an X terminal window or within
2423 a terminal emulator that supports an xterm-style mouse, then you may
2424 turn on support for the mouse with the feature
2425 <A HREF="h_config_enable_mouse"><!--#echo var="FEAT_enable-mouse-in-xterm"--></A>.
2426 For UNIX Alpine you will also need to set the $DISPLAY environment variable.
2427 <P>
2428 PC-Alpine offers considerable mouse support.  You can view what is
2429 &quot;clickable&quot; by dragging your mouse over any screen; when the
2430 arrow cursor changes into a hand, you found something. Mouse-click
2431 possibilities include navigating between screens and folders and
2432 double-clicking on hyperlinks to open your Web browser.
2433 Context-sensitive pop-up menus appear with a right-click on your PC-Alpine
2434 screen.  Examples of right-click options include &quot;copy&quot; after
2435 selecting text to copy and &quot;View in New Window&quot; when you click
2436 on a particular message in the Message Index. The menu choices available
2437 to you will vary based upon what screen is open, where on the screen your
2438 cursor is located, and even what action you have already taken.
2439 Within a folder, you may set the &quot;Important&quot; flag on any
2440 message.
2441 <P>
2442 X terminal mouse support is more limited but still quite powerful.
2443 As with PC-Alpine, clicking on any of the commands in the keymenu at
2444 the bottom of the screen will execute that command as if you typed it.
2445 Double-clicking on a link, for example the link to the
2446 <!--#echo var="FEAT_enable-mouse-in-xterm"--> feature in the paragraph above,
2447 will take you to that link.
2448 Double-clicking on an index line will view the message, and so on.
2449 <P>
2450 &lt;End of help on this topic&gt;
2451 </BODY>
2452 </HTML>
2453 ===== h_mainhelp_keywords ======
2454 <HTML>
2455 <HEAD>
2456 <TITLE>Keywords</TITLE>
2457 </HEAD>
2458 <BODY>
2459 <H1>Keywords</H1>
2460
2461 Within a folder, you may set the &quot;Important&quot; flag on any
2462 message.
2463 This doesn't have any system-defined meaning and is only called
2464 the Important flag because many users use it to signify that a message
2465 is important to them in some way.
2466 <P>
2467 You may also define your own set of keywords.
2468 You might know these as user defined flags or as labels.
2469 These are similar to the Important flag but you choose the names for yourself.
2470 <P>
2471 Alpine will only display keywords that
2472 have been added by you in the Flag Details screen or
2473 that have been configured by you using the Setup/Config option
2474 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>.
2475 Keywords set by other means (for example, by another email client) will not
2476 show up in Alpine unless you configure Alpine to know about them.
2477 They will show up in the Flag Details screen, but will not show up, for example,
2478 in the index line.
2479
2480 <P>
2481 The following entries in Alpine's online help provide additional information
2482 about how to use keywords:
2483 <ul>
2484   <li><A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--> config option</A></li>
2485   <li><A HREF="h_common_flag">Flag command to set keywords</A></li>
2486 </ul>
2487 <P>
2488 &lt;End of help on this topic&gt;
2489 </BODY>
2490 </HTML>
2491 ===== h_mainhelp_roles ======
2492 <HTML>
2493 <HEAD>
2494 <TITLE>Roles</TITLE>
2495 </HEAD>
2496 <BODY>
2497 <H1>Roles</H1>
2498
2499 You may play different roles depending on who you are replying to. For
2500 example, if you are replying to a message addressed to help-desk you may
2501 be acting as a Help Desk Worker. That role may require that you use a
2502 different return address and/or a different signature.
2503
2504 <P>
2505 To configure roles, go to the MAIN MENU and use the Setup command
2506 followed by &quot;Rules&quot; and then &quot;Roles&quot;.
2507 The following entries in Alpine's online help provide additional information
2508 about how to
2509 use roles:
2510 <ul>
2511   <li><a href="h_rules_roles">Setup Roles Screen</a></li>
2512   <li><a href="h_role_select">Roles Screen</a></li>
2513 </ul>
2514 <P>
2515 &lt;End of help on this topic&gt;
2516 </BODY>
2517 </HTML>
2518 ===== h_mainhelp_filtering ======
2519 <HTML>
2520 <HEAD>
2521 <TITLE>Filtering</TITLE>
2522 </HEAD>
2523 <BODY>
2524 <H1>Filtering</H1>
2525
2526 The software that actually delivers mail (the stuff that happens
2527 before Alpine is involved) for you is in a better position to do mail filtering
2528 than Alpine itself.
2529 If possible, you may want to look into using that sort of mail filtering to
2530 deliver mail to different folders, delete it, or forward it.
2531 However, if you'd like Alpine to help with this, Alpine's filtering is for you.
2532
2533 <P>
2534 Filtering is a way to automatically move certain messages from one folder
2535 to another or to automatically delete messages.
2536 You may also automatically set the state (Important, New, Deleted, Answered) of messages
2537 and set <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> for messages.
2538 Alpine doesn't have the ability to forward mail to another address or
2539 to deliver vacation messages.
2540
2541 <P>
2542 To configure filtering, go to the MAIN MENU and use the Setup command
2543 followed by &quot;Rules&quot; and then &quot;Filters&quot;.
2544 The following entries in Alpine's online help provide additional information
2545 about how to use filtering:
2546 <UL>
2547   <LI> <A HREF="h_rules_filter">Filtering Setup screen</A>
2548 </UL>
2549 <P>
2550 &lt;End of help on this topic&gt;
2551 </BODY>
2552 </HTML>
2553 ===== h_mainhelp_patterns ======
2554 <HTML>
2555 <HEAD>
2556 <TITLE>Patterns</TITLE>
2557 </HEAD>
2558 <BODY>
2559 <H1>Patterns</H1>
2560
2561 Patterns are used with Roles, Filtering, Index Coloring,
2562 Scoring, Other Rules, and Search Rules, so it may help you to understand exactly how Patterns work.
2563 The following entries in Alpine's online help provide information
2564 about using Patterns:
2565 <UL>
2566   <LI> <A HREF="h_rule_patterns">Patterns</A>
2567 </UL>
2568 <P>
2569 &lt;End of help on this topic&gt;
2570 </BODY>
2571 </HTML>
2572 ===== h_mainhelp_cmdlineopts ======
2573 <HTML>
2574 <HEAD>
2575 <TITLE>Command Line Options</TITLE>
2576 </HEAD>
2577 <BODY>
2578 <H1>Command Line Options</H1>
2579
2580 Alpine accepts a number of command line arguments, allowing you, for
2581 example, to start Alpine and immediately access a particular folder.
2582 Many of these arguments overlap with options in the Alpine configuration file.
2583 If there is a difference, then an option set on the command line takes
2584 precedence.
2585 Alpine expects command line arguments (other than addresses) to be
2586 preceded by a &quot;-&quot; (dash) as normally used by UNIX programs.
2587 A <a href="h_command_line_options">full list</a> of command line
2588 possibilities is available.
2589 <P>
2590 &lt;End of help on this topic&gt;
2591 </BODY>
2592 </HTML>
2593 ===== h_mainhelp_config ======
2594 <HTML>
2595 <HEAD>
2596 <TITLE>Alpine Configuration</TITLE>
2597 </HEAD>
2598 <BODY>
2599 <H1>Alpine Configuration</H1>
2600
2601 Unless it has been administratively disabled, the Setup command on the
2602 MAIN MENU has several subcommands that allow you to modify Alpine's behavior.
2603 The possible subcommands are for general Configuration settings,
2604 Printer settings, Changing your Password, Signature setup,
2605 AddressBook setup, Collection Lists setup, Rules (including Roles, Filters,
2606 Scores, Search, Indexcolor, and Other rules), LDAP Directory setup,
2607 and Color configuration.
2608 In particular, the &quot;Config&quot; subcommand has many features you may
2609 set or unset and many other configuration variables that may be set to change
2610 the way Alpine works.
2611 Every one of the hundreds of options available in that configuration settings
2612 screen has help text associated with it.
2613 You may read that text by moving the cursor to highlight the option and then
2614 typing the Help command.
2615 <P>
2616 These settings are stored in your personal
2617 &quot;pinerc&quot; configuration file (or, optionally, they may be stored
2618 <A HREF="h_config_remote_config">remotely</A>),
2619 but on shared systems these settings
2620 may be over-ridden by a system-wide control file (due to local site
2621 security or support policies).  A global pine configuration file can also
2622 be used to set default values for all Alpine users on a particular system.
2623 Power users may be interested in splitting their personal configuration
2624 data into two pieces, a generic piece and
2625 <A HREF="h_config_exceptions">exceptions</A> which apply to
2626 a particular platform.
2627 They may also be interested in <A HREF="h_config_inheritance">configuration inheritance</A>.
2628 General Alpine configuration information can be found
2629 <A HREF="h_news_config">here</A>.
2630 <P>
2631 &lt;End of help on this topic&gt;
2632 </BODY>
2633 </HTML>
2634 ===== h_mainhelp_aggops ======
2635 <HTML>
2636 <HEAD>
2637 <TITLE>Aggregate Operations</TITLE>
2638 </HEAD>
2639 <BODY>
2640 <H1>Aggregate Operations</H1>
2641
2642 When you are in the MESSAGE INDEX, the available commands
2643 (for example, Delete, Undelete, Save, Reply, and so on)
2644 normally act on a single message.
2645 So, for example, if you press the Delete command, the currently highlighted
2646 message is marked Deleted.
2647 These commands that normally act on a single message may be applied to
2648 several messages at once instead.
2649 <P>
2650 By default this feature is turned on, but it could be administratively turned
2651 off to reduce complexity.
2652 The feature
2653 <A HREF="h_config_enable_agg_ops"><!--#echo var="FEAT_enable-aggregate-command-set"--></A>
2654 in the Setup/Config screen is used to turn it off or on.
2655 When this feature is turned on, the four commands &quot;Select&quot;,
2656 &quot;SelectCur&quot;, &quot;ZoomMode&quot;, and &quot;Apply&quot;
2657 are available.
2658 The two selection commands allow you to mark a set of
2659 messages as being &quot;selected&quot;.
2660 The &quot;ZoomMode&quot; command will toggle between
2661 displaying only the selected messages and displaying all the messages.
2662 The &quot;Apply&quot; command allows you to
2663 apply one of the regular MESSAGE INDEX commands to all of the selected
2664 messages instead of to only the highlighted message.
2665 <P>
2666 An example aggregate operation would be to catch up when reading
2667 a news group.
2668 That is, get rid of all the messages in the news group so that you can
2669 start fresh.
2670 The easiest way to do this in Alpine is to use aggregate operations.
2671 You want to Delete all of the messages in the group.
2672 You could start at the top and type &quot;D&quot; once for every message.
2673 A much faster method is to first Select all of the messages in the group,
2674 and then Delete all of them.
2675 This would take four keystrokes:
2676 <P>
2677 <CENTER><SAMP>; a (to select all messages)</SAMP></CENTER>
2678 <BR>
2679 <CENTER><SAMP>a d (to delete all selected messages)</SAMP></CENTER>
2680 <P>
2681 Another use of Select is to use it for searching for a particular message
2682 or set of messages in a large folder.
2683 You may know that the message was From a certain user.
2684 You could select all messages from that user to start, and use Zoom to
2685 look at only those messages.
2686 If there were still too many messages to look at you could Narrow the
2687 set of messages further by selecting from all of those messages only
2688 the ones that were after a certain date, or contained a particular phrase
2689 in the Subject, or were too a particular address, and so on.
2690 That may be the end of what you are doing, or you may want to use Apply to
2691 Save or Forward or Print all of the selected messages.
2692 <P>
2693 Some related help topics are
2694 <UL>
2695 <LI> <A HREF="h_index_cmd_select">Selecting: Select and WhereIs/Select</A>,
2696 <LI> <A HREF="h_config_enable_agg_ops"><!--#echo var="FEAT_enable-aggregate-command-set"--></A>,
2697 <LI> <A HREF="h_config_auto_unselect"><!--#echo var="FEAT_auto-unselect-after-apply"--></A>.
2698 <LI> <A HREF="h_config_auto_unzoom"><!--#echo var="FEAT_auto-unzoom-after-apply"--></A>,
2699 <LI> <A HREF="h_config_auto_zoom"><!--#echo var="FEAT_auto-zoom-after-select"--></A>, and
2700 <LI> <A HREF="h_config_select_wo_confirm"><!--#echo var="FEAT_select-without-confirm"--></A>.
2701 </UL>
2702 <P>
2703 &lt;End of help on this topic&gt;
2704 </BODY>
2705 </HTML>
2706 ===== h_mainhelp_readingnews ======
2707 <HTML>
2708 <HEAD>
2709 <TITLE>Reading News</TITLE>
2710 </HEAD>
2711 <BODY>
2712 <H1>Reading News</H1>
2713
2714 <H2>Background</H2>
2715 Alpine can read and post to Internet (or USENET) newsgroups, using the same
2716 commands as for mail. Similar to mailing lists but existing on a larger scale,
2717 Usenet newsgroups allow groups of people with common interests to discuss
2718 particular topics. You might find newsgroups related to your career, or you
2719 might wish to check out the online discussion among the fans of your favorite
2720 television show.
2721
2722 <H2>Configuring Alpine for Reading News</H2>
2723 Alpine often arrives
2724 pre-configured by your system administrator to automatically access the
2725 newsgroups offered by your organization, Internet Service Provider, or
2726 school. PC-Alpine users, and those attempting to customize Unix Alpine, will
2727 need additional details on <a href="h_configuring_news">how to
2728 configure Alpine to read news</a>.
2729
2730 <H2>Accessing Newsgroups</H2>
2731 The first step in reading news is to access the newsgroups collections
2732 screen from Alpine. If everything is configured properly, you should be able
2733 to do this by first typing L (folder List), then selecting the folder
2734 collection listed as "News." The actual name of this collection may differ
2735 from system to system.
2736
2737 <H2>Subscribing to Newsgroups</H2>
2738
2739 Once you have accessed the news collection, you need to subscribe to a
2740 newsgroup that interests you. Subscribing to a newsgroup means that Alpine
2741 will keep a record of the newsgroups in which you are interested and which
2742 articles in those newsgroups have been read.
2743
2744 <H2>Using Newsgroups</H2>
2745 Alpine uses the similar commands to read news as to read mail. For example,
2746 the D command marks messages as Deleted (or "Dismissed," if you prefer),
2747 and the R command Replies to a news posting. Basically, Alpine allows you to
2748 read news as if it were mail, so you don't need to change the way you
2749 interact with Alpine.
2750 <P>
2751 There is also additional Alpine help available on
2752 <A HREF="h_reading_news">how to use Alpine to read news</A>.
2753 <P>
2754 &lt;End of help on this topic&gt;
2755 </BODY>
2756 </HTML>
2757 ===== h_mainhelp_securing ======
2758 <HTML>
2759 <HEAD>
2760 <TITLE>Securing your Alpine Session</TITLE>
2761 </HEAD>
2762 <BODY>
2763 <H1>Securing your Alpine Session</H1>
2764
2765 By default, Alpine will attempt to connect to an IMAP server on the normal
2766 IMAP service port (143).
2767 If the Alpine you are using has been built to
2768 support &quot;Transport Layer Security&quot; (TLS)
2769 and &quot;Secure Sockets Layer&quot; (SSL)
2770 (check by clicking <A HREF="X-Alpine-Config:">here</A>),
2771 and the server offers the STARTTLS capability, then a secure (encrypted)
2772 session will be established.
2773 <P>
2774 When you are connected to a remote folder the titlebar will contain a plus sign
2775 in the far right column if the connection is encrypted using TLS or SSL.
2776 Similarly, when you are being prompted for a password a plus sign will appear in the prompt
2777 if the connection is encrypted.
2778
2779 <H2>More Information on Alpine with SSL and TLS</H2>
2780 <UL>
2781 <LI> <A HREF="h_release_tlscerts">TLS and SSL Usage Note</A> </LI>
2782 <LI> <A HREF="h_folder_server_syntax">/SSL</A> option for older servers which support port 993 SSL but not TLS </LI>
2783 <LI> <A HREF="h_config_alt_auth"><!--#echo var="FEAT_try-alternative-authentication-driver-first"--></A> feature </LI>
2784 <LI> <A HREF="h_config_quell_ssl_largeblocks"><!--#echo var="FEAT_quell-ssl-largeblocks"--></A> PC-Alpine feature for working around OS SSL-problems</A> </LI>
2785 </UL>
2786 <H2>Here are some other security-related features and options</H2>
2787 <P>
2788 <UL>
2789 <LI> <A HREF="h_config_disable_password_caching"><!--#echo var="FEAT_disable-password-caching"--></A> feature to disable password caching </LI>
2790 <LI> <A HREF="h_config_mailcap_params"><!--#echo var="FEAT_enable-mailcap-param-substitution"--></A> feature </LI>
2791 <LI> <A HREF="h_config_disable_auths"><!--#echo var="VAR_disable-these-authenticators"--></A> option </LI>
2792 </UL>
2793 <P>
2794 &lt;End of help on this topic&gt;
2795 </BODY>
2796 </HTML>
2797 ===== h_mainhelp_problems ======
2798 <HTML>
2799 <HEAD>
2800 <TITLE>Reporting Problems</TITLE>
2801 </HEAD>
2802 <BODY>
2803 <H1>Reporting Problems</H1>
2804
2805 We ask that you first read the relevant help screens and then seek
2806 assistance from your own local support staff.  Once you are sure that your
2807 difficulty is not a local configuration problem, you might look at the
2808 help section explaining where to look for
2809 <A HREF="h_finding_help">more information</A> and where to
2810 get assistance.
2811 <P>
2812
2813 <ADDRESS>
2814    Eduardo Chappa &lt;chappa@gmx.com&gt;
2815 </ADDRESS>
2816
2817 <P>
2818 &lt;End of help on this topic&gt;
2819 </BODY>
2820 </HTML>
2821 ===== h_main_menu_commands ======
2822 <HTML>
2823 <HEAD>
2824 <TITLE>MAIN MENU COMMANDS</TITLE>
2825 </HEAD>
2826 <BODY>
2827 <H1>MAIN MENU COMMANDS</H1>
2828
2829 <!--chtml if pinemode="function_key"-->
2830 &nbsp;Available&nbsp;Commands&nbsp;--
2831 &nbsp;Group&nbsp;1&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;2<BR>
2832 &nbsp;------------------------------
2833 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;--------------------
2834 ----------<BR>
2835 &nbsp;F1&nbsp;&nbsp;Show&nbsp;this&nbsp;help&nbsp;text&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F1&nbsp;&nbsp;Show&nbsp;this&nbsp;help&nbsp;text<BR>
2836 &nbsp;F2&nbsp;&nbsp;Show&nbsp;all&nbsp;other&nbsp;available&nbsp;commands&nbsp;&nbsp;&nbsp;F2&nbsp;&nbsp;Show&nbsp;other&nbsp;commands<BR>
2837 &nbsp;F3&nbsp;&nbsp;Quit&nbsp;Alpine<BR>
2838 &nbsp;F4&nbsp;&nbsp;Execute&nbsp;current&nbsp;MAIN&nbsp;MENU&nbsp;command&nbsp;&nbsp;&nbsp;F4&nbsp;&nbsp;<A
2839 HREF="h_common_compose">Compose</A>&nbsp;a&nbsp;message<BR>
2840 &nbsp;F5&nbsp;&nbsp;Select&nbsp;previous&nbsp;command&nbsp;up&nbsp;on&nbsp;menu&nbsp;&nbsp;F5&nbsp;&nbsp;<A
2841 HREF="h_common_folders">FOLDER&nbsp;LIST</A>&nbsp;screen<BR>
2842 &nbsp;F6&nbsp;&nbsp;Select&nbsp;next&nbsp;command&nbsp;down&nbsp;on&nbsp;menu&nbsp;&nbsp;&nbsp;&nbsp;F6&nbsp;&nbsp;<A
2843 HREF="h_common_goto">Goto</A>&nbsp;a&nbsp;specified&nbsp;folder<BR>
2844 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
2845 &nbsp;F7&nbsp;&nbsp;<A
2846 HREF="h_common_index">MESSAGE&nbsp;INDEX</A>&nbsp;screen<BR>
2847 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
2848 &nbsp;F8&nbsp;&nbsp;<A
2849 HREF="h_main_journal">Journal</A>&nbsp;of&nbsp;status&nbsp;messages<BR>
2850 &nbsp;F9&nbsp;&nbsp;Display&nbsp;<A
2851 HREF="h_main_release_notes">Release&nbsp;Notes</A>&nbsp;notes&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F9&nbsp;&nbsp;<A
2852 HREF="h_main_setup">SETUP</A>&nbsp;menus<BR>
2853 &nbsp;F10&nbsp;<A
2854 HREF="h_main_kblock">Lock&nbsp;Keyboard</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F10&nbsp;<A
2855 HREF="h_main_addrbook">ADDRESS&nbsp;BOOK</A>&nbsp;screen<BR>
2856 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
2857 &nbsp;F11&nbsp;<A
2858 HREF="h_common_role">Compose&nbsp;message&nbsp;using&nbsp;a&nbsp;role</a><BR>
2859 <!--chtml else-->
2860 &nbsp;General&nbsp;Alpine&nbsp;Commands&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Main&nbsp;Menu&nbsp;Screen&nbsp;Commands<BR>
2861 &nbsp;---------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;--------------------------<BR>
2862 &nbsp;?&nbsp;&nbsp;Show&nbsp;Help&nbsp;Text&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;O&nbsp;&nbsp;Show&nbsp;all&nbsp;Other&nbsp;available&nbsp;commands<BR>
2863 &nbsp;C&nbsp;&nbsp;<A
2864 HREF="h_common_compose">Compose</A>&nbsp;a&nbsp;message&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;P&nbsp;&nbsp;Select&nbsp;Previous&nbsp;command&nbsp;up&nbsp;on&nbsp;menu<BR>
2865 &nbsp;I&nbsp;&nbsp;<A
2866 HREF="h_common_index">MESSAGE&nbsp;INDEX</A>&nbsp;screen&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;N&nbsp;&nbsp;Select&nbsp;Next&nbsp;command&nbsp;down&nbsp;on&nbsp;menu<BR>
2867 &nbsp;L&nbsp;&nbsp;<A
2868 HREF="h_common_folders">FOLDER&nbsp;LIST</A>&nbsp;screen&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;R&nbsp;&nbsp;Display&nbsp;Alpine&nbsp;<A HREF="h_main_release_notes">Release&nbsp;Notes</A><BR>
2869 &nbsp;A&nbsp;&nbsp;<A
2870 HREF="h_main_addrbook">ADDRESS&nbsp;BOOK</A>&nbsp;screen&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;K&nbsp;&nbsp;<A
2871 HREF="h_main_kblock">Lock&nbsp;Keyboard</A><BR>
2872 &nbsp;S&nbsp;&nbsp;<A
2873 HREF="h_main_setup">SETUP</A>&nbsp;functions&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;G&nbsp;&nbsp;<A
2874 HREF="h_common_goto">Goto</A>&nbsp;a&nbsp;specified&nbsp;folder<BR>
2875 &nbsp;Q&nbsp;&nbsp;Quit&nbsp;Alpine&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;J&nbsp;&nbsp;<A HREF="h_main_journal">Journal</A>&nbsp;of&nbsp;status&nbsp;messages<BR>
2876 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;&nbsp;<A
2877 HREF="h_common_role">Compose&nbsp;message&nbsp;using&nbsp;a&nbsp;role</a><BR>
2878 <!--chtml endif-->
2879
2880 <P>
2881 NOTE:
2882 <OL>
2883  <LI>For help on a particular command, highlight the bold text associated
2884 with it above and hit Return.
2885  <LI> The availability of certain commands (e.g. some of the options under
2886 SETUP) is determined by Alpine configuration files and system capabilities.
2887 At some sites, certain commands may not be available due to security or
2888 support concerns.
2889 </OL>
2890 <P>
2891 &lt;End of help on this topic&gt;
2892 </BODY>
2893 </HTML>
2894
2895 ===== h_command_line_options ======
2896 <HTML>
2897 <HEAD>
2898 <TITLE>COMMAND LINE OPTIONS</TITLE>
2899 </HEAD>
2900 <BODY>
2901 <H1>COMMAND LINE OPTIONS</H1>
2902 Possible starting arguments for Alpine:
2903
2904 <DL COMPACT>
2905
2906 <DT> <EM>[addresses]</EM>
2907
2908 <DD> Send-to:  If you give <EM>Alpine</EM> an argument or arguments which
2909 do not begin with a dash, <EM>Alpine</EM> treats them as email addresses.
2910 <EM>Alpine</EM> will startup in
2911 the composer with a message started to the addresses specified.
2912 Once the message is sent, the <EM>Alpine</EM> session closes.
2913 Standard input redirection is allowed.
2914 Separate multiple addresses with a space between them.
2915 Addresses are placed in the &quot;To&quot; field only.
2916 <P>
2917
2918 <DT> &lt; <EM>file</EM>
2919
2920 <DD> <EM>Alpine</EM> will startup in the composer with <EM>file</EM> read
2921 into the body of the message.
2922 Once the message is sent, the <EM>Alpine</EM> session closes.
2923 <P>
2924
2925 <DT> -attach <EM>file</EM>
2926
2927 <DD> Go directly into composer with given file attached.
2928 <P>
2929
2930 <DT> -attachlist <EM>file-list</EM>
2931
2932 <DD> Go directly into composer with given files attached.
2933 This must be the last option on the command line.
2934 <P>
2935
2936 <DT> -attach_and_delete <EM>file</EM>
2937
2938 <DD> Go directly into composer with given file attached, delete when finished.
2939 <P>
2940
2941 <DT> -aux <EM>local_directory</EM>
2942
2943 <DD> <EM>PC-Alpine</EM> only.
2944 This tells <EM>PC-Alpine</EM> the local directory to use for storing auxiliary
2945 files, like debug files, address books, and signature files.  The pinerc may
2946 be local or remote.
2947 <P>
2948
2949 <DT> -bail
2950
2951 <DD> If the personal configuration file doesn't already exist, exit.
2952 This might be useful if the configuration file is accessed using some
2953 remote filesystem protocol. If the remote mount is missing this will cause
2954 <EM>Alpine</EM> to quit instead of creating a new pinerc.
2955 <P>
2956
2957 <DT> -c <EM>n</EM>
2958
2959 <DD> When used with the <CODE>-f</CODE> option, apply the <EM>n</EM>th context.
2960 This is used when there are multiple folder collections (contexts) and you
2961 want to open a folder not in the primary collection.
2962 <P>
2963
2964 <DT> -conf
2965
2966 <DD> Configuration: Prints a sample system configuration file to the
2967 screen or standard output. To generate an initial system configuration
2968 file, execute
2969
2970 <PRE><CODE>
2971                 pine -conf > <!--#echo var="PINE_CONF_PATH"-->
2972 </CODE></PRE>
2973 <P>
2974
2975 To generate a system configuration file using settings from an old
2976 system configuration file, execute
2977
2978 <PRE><CODE>
2979                 pine -P old-pine.conf -conf > <!--#echo var="PINE_CONF_PATH"-->
2980 </CODE></PRE>
2981 <P>
2982 A system configuration file is not required.
2983 <P>
2984
2985 <DT> -copy_abook &lt;<EM>local_abook_file</EM>&gt; &lt;<EM>remote_abook_folder</EM>&gt;
2986
2987 <DD> Copy an address book file to a remote address book folder.
2988 If the remote folder doesn't exist, it will be created.
2989 If it exists but the first message in the folder isn't a remote address
2990 book header message, the copy will be aborted.
2991 This flag will not usually be used by a user.
2992 Instead, the user will create a remote address book from within <EM>Alpine</EM>
2993 and copy entries from the local address book by using aggregate Save in
2994 the address book screen.
2995 <P>
2996
2997 <DT> -copy_pinerc &lt;<EM>local_pinerc_file</EM>&gt; &lt;<EM>remote_pinerc_folder</EM>&gt;
2998
2999 <DD> Copy a pinerc configuration file to a remote pinerc folder.
3000 If the remote folder doesn't exist, it will be created.
3001 If it exists but the first message in the folder isn't a remote pinerc
3002 header message, the copy will be aborted.
3003 This flag may be useful to users who already have a local pinerc file and
3004 would like to convert it to a remote pinerc folder and use that instead.
3005 This gives a way to bootstrap that conversion without having to manually
3006 reset all of the variables in the remote pinerc folder.
3007 <P>
3008
3009 <DT> -d <EM>debug-level</EM>
3010
3011 <DD> Debug Level:  Sets the level of debugging information written by
3012 <EM>Alpine</EM>.
3013 <EM>debug-level</EM> can be set to any integer 0-9.
3014 A debug level of 0 turns off debugging for the session.
3015 (Actually there are some levels higher than 9, but you probably don't
3016 want to see them.)
3017 <P>
3018
3019 <DT> -d <EM>keywords</EM>
3020
3021 <DD> You may use a more detailed version of the debugging flag to set
3022 the debug level in separate parts of <EM>Alpine</EM>.
3023 The possibilities are flush, timestamp, imap=0..4, tcp, numfiles=0..31, and
3024 verbose=0..9.
3025 <EM>Flush</EM> causes debugging information to be flushed immediately to
3026 the debug file as it is written.
3027 <EM>Verbose</EM> is the general debugging verbosity level.
3028 <EM>Timestamp</EM> causes timestamps to be added to the debug file, which
3029 is useful when you are trying to figure out what is responsible for delays.
3030 <EM>Numfiles</EM> sets the number of debug files saved.
3031 <EM>Imap</EM> sets the debug level for the debugging statements related
3032 to the conversation with the IMAP server, and more generally, for the
3033 debugging related to <EM>Alpine</EM>'s interaction with the C-Client library.
3034 <EM>Tcp</EM> turns on some TCP/IP debugging.
3035 <P>
3036
3037 <DT> -f <EM>folder</EM>
3038
3039 <DD> Startup folder:  <EM>Alpine</EM> will open this folder in place
3040 of the standard INBOX.
3041 <P>
3042
3043 <DT> -F <EM>file</EM>
3044
3045 <DD> Open named text file for viewing and forwarding.
3046 <P>
3047
3048 <DT> -h
3049
3050 <DD> Help:  Prints the list of available command-line arguments to the
3051 screen.
3052 <P>
3053
3054 <DT> -i
3055
3056 <DD> <EM>Alpine</EM> will start up in the FOLDER INDEX
3057 screen instead of the MAIN MENU.
3058 <P>
3059
3060 Configuration equivalent:  <EM><!--#echo var="VAR_initial-keystroke-list"-->=i</EM>.
3061 <P>
3062
3063 <DT> -I <EM>a,b,c,...</EM>
3064
3065 <DD> Initial Keystrokes:  <EM>Alpine</EM> will execute this comma-separated
3066 sequence of commands upon startup.
3067 This allows users to get <EM>Alpine</EM> to start in any
3068 of its menus/screens.
3069 You cannot include any input to the composer in the initial keystrokes.
3070 The key &lt;Return&gt; is represented by a ``CR'' in
3071 the keystroke list; the spacebar is designated by the letters ``SPACE''.
3072 Control keys are two character sequences beginning with ``^'', such as
3073 ``^I''.
3074 A tab character is ``TAB''.
3075 Function keys are ``F1'' - ``F12'' and the arrow keys are ``UP'',
3076 ``DOWN'', ``LEFT'', and ``RIGHT''.
3077 A restriction is that you can't mix function keys and character keys in this
3078 list even though you can, in some cases, mix them when running <EM>Alpine</EM>.
3079 A user can always use only <EM>character</EM> keys in the startup list even
3080 if he or she is using <EM>function</EM> keys normally, or vice versa.
3081 If an element in this list is a string of characters surrounded by double
3082 quotes (&quot;) then it will be expanded into the individual characters in
3083 the string, excluding the double quotes.
3084 <P>
3085
3086 Configuration equivalent:  <EM><!--#echo var="VAR_initial-keystroke-list"--></EM>
3087 <P>
3088
3089 <DT> -install
3090
3091 <DD> For <EM>PC-Alpine</EM> only, this option prompts the user for
3092 some basic information to help with getting properly set up.
3093 <P>
3094
3095 <DT> -k
3096
3097 <DD> Function-Key Mode:  When invoked in this way, <EM>Alpine</EM> expects
3098 the input of commands to be function-keys.
3099 Otherwise, commands are linked to the regular character keys.
3100 <P>
3101
3102 Configuration equivalent:  <EM><!--#echo var="FEAT_use-function-keys"--></EM> included in
3103 <EM>Feature-List</EM>.
3104 <P>
3105
3106 <DT> -n <EM>n</EM>
3107
3108 <DD> Message-Number:  When specified, <EM>Alpine</EM> starts up in the
3109 FOLDER INDEX screen with the current message being the specified
3110 message number.
3111 <P>
3112
3113 <DT> -nosplash
3114
3115 <DD> <EM>PC-Alpine</EM> only.
3116 This tells <EM>PC-Alpine</EM> not to display the splash screen upon startup.
3117 This may be helpful for certain troubleshooting or terminal server scenarios.
3118 <P>
3119
3120 <DT> -o <EM>folder</EM>
3121
3122 <DD> Opens the INBOX (or a folder specified via the -f argument) ReadOnly.
3123 <P>
3124
3125 <DT> -p <EM>pinerc</EM>
3126
3127 <DD> Uses the named file as the personal configuration file instead of
3128 <EM>~/.pinerc</EM> or the default PINERC search sequence <EM>PC-Alpine</EM> uses.
3129 Alpinerc may be either a local file or a remote configuration folder.
3130 <P>
3131
3132 <DT> -P <EM>pinerc</EM>
3133
3134 <DD> Uses the named file as the system wide configuration file instead of
3135 <EM><!--#echo var="PINE_CONF_PATH"--></EM> on UNIX, or nothing on <EM>PC-Alpine</EM>.
3136 Alpinerc may be either a local file or a remote configuration folder.
3137 <P>
3138
3139 <DT> -passfile <EM>passfile</EM>
3140
3141 <DD> This tells <EM>Alpine</EM> what file should be used as the password file.
3142 This should be a fully-qualified filename.
3143 <P>
3144
3145 <DT> -pinerc <EM>file</EM>
3146
3147 <DD> Output fresh pinerc configuration to <EM>file</EM>, preserving the
3148 settings of variables that the user has made.
3149 Use <EM>file</EM> set to ``-'' to make output go to standard out.
3150 <P>
3151
3152 <DT> -r
3153
3154 <DD> Restricted Mode:  For UNIX <EM>Alpine</EM> only.
3155 <EM>Alpine</EM> in restricted mode can only send email to itself.
3156 Save and export are limited.
3157 <P>
3158
3159 <DT> -registry <EM>cmd</EM>
3160
3161 <DD> For <EM>PC-Alpine</EM> only, this option affects the values of
3162 <EM>Alpine</EM>'s registry entries.
3163 Possible values for <EM>cmd</EM> are set, clear, and dump.
3164 <EM>Set</EM> will always reset <EM>Alpine</EM>'s registry
3165 entries according to its current settings.
3166 <EM>Clear</EM> will clear the registry values.
3167 <EM>Clearsilent</EM> will clear the registry values without any dialogs.
3168 <EM>Dump</EM> will display the values of current registry settings.
3169 Note that the dump command is currently disabled.
3170 Without the -registry option, <EM>PC-Alpine</EM> will write values into
3171 the registry only if there currently aren't any values set.
3172 <P>
3173
3174 <DT> -sort <EM>key</EM>
3175
3176 <DD> Sort-Key:  Specifies the order messages will be displayed in for the
3177 FOLDER INDEX screen.
3178 <EM>Key</EM> can have the following values:
3179 arrival, date, subject, orderedsubj, thread, from, size, score, to, cc,
3180 arrival/reverse, date/reverse, subject/reverse, orderedsubj/reverse, thread/reverse,
3181 from/reverse, size/reverse, score/reverse, to/reverse, and cc/reverse.
3182 The default value is &quot;arrival&quot;.
3183 The <EM>key</EM> value reverse is equivalent to arrival/reverse.
3184 <P>
3185
3186 Configuration equivalent:  <EM><!--#echo var="VAR_sort-key"--></EM>.
3187 <P>
3188
3189 <DT> -uninstall
3190
3191 <DD> For <EM>PC-Alpine</EM> only, this option removes references to Alpine
3192 in Windows settings.  The registry settings are removed and
3193 the password cache is cleared.
3194 <P>
3195
3196 <DT> -url <EM>url</EM>
3197
3198 <DD> Open the given URL.
3199 <P>
3200
3201 <DT> -v
3202
3203 <DD> Version:  Print version information to the screen.
3204 <P>
3205
3206 <DT> -x <EM>exceptions_config</EM>
3207
3208 <DD> Configuration settings in the exceptions configuration override your normal
3209 default settings.
3210 <EM>Exceptions_config</EM> may be either a local file or a remote Alpine configuration folder.
3211 <P>
3212
3213 <DT> -z
3214
3215 <DD> Enable Suspend:  When run with this flag, the key sequence ctrl-z
3216 will suspend the <EM>Alpine</EM> session.
3217 <P>
3218
3219 Configuration equivalent:  <EM><!--#echo var="FEAT_enable-suspend"--></EM> included in
3220 <EM>Feature-List</EM>.
3221 <P>
3222
3223 <DT> -<EM>option</EM>=<EM>value</EM>
3224
3225 <DD> Assign <EM>value</EM> to the config option <EM>option</EM>.
3226 For example, <EM>-signature-file=sig1</EM> or
3227 <EM>-Feature-List=signature-at-bottom</EM>.
3228 Note:  Feature-List values are
3229 additive and features may be preceded with no- to turn them off.
3230 Also, as a special case, the &quot;Feature-List=&quot; part of that may be
3231 omitted. For example, <EM>-signature-at-bottom</EM> is equivalent to
3232 <EM>-Feature-List=signature-at-bottom</EM>.
3233 <P>
3234
3235 </DL>
3236 <P>
3237 &lt;End of help on this topic&gt;
3238 </BODY>
3239 </HTML>
3240 ===== h_configuring_news ======
3241 <HTML>
3242 <HEAD>
3243 <TITLE>CONFIGURING NEWS</TITLE>
3244 </HEAD>
3245 <BODY>
3246 <H1>CONFIGURING NEWS</H1>
3247 Alpine can access news folders in any one of three different ways:
3248 <DL>
3249 <DT>REMOTE NNTP</DT>
3250 <DD>Using the Network News Transport Protocol (NNTP) to
3251 access news on a remote news server.  In this case the newsrc file is
3252 stored on the machine where Alpine is running.
3253
3254 <P>
3255 To specify a remote news-collection accessed via NNTP use the
3256 SETUP/collectionList screen's &quot;Add&quot; command.  Set the
3257 Server: value to the NNTP server's hostname appended with the
3258 communication method &quot;/service=NNTP&quot;, and set the Path:
3259 value to the &quot;#news.&quot; namespace (without the quotes).  See
3260 the &quot;<A HREF="h_composer_cntxt_server">Server:</A>&quot; field's
3261 help text for a more complete explanation of access method, and the
3262 &quot;<A HREF="h_composer_cntxt_path">Path:</A>&quot; field's help
3263 text for a more complete explanation of &quot;namespace&quot;.
3264 <P>
3265 Instead of specifying a news-collection, you may simply set the
3266 <A HREF="h_config_nntp_server">NNTP Server</A>
3267 option, which will cause Alpine to create a default news-collection for you.
3268 Another NNTP option that may be of interest is
3269 <A HREF="h_config_nntprange"><!--#echo var="VAR_nntp-range"--></A>.
3270
3271 <DT>REMOTE IMAP</DT>
3272 <DD>Using the Internet Message Access Protocol (IMAP) to
3273 access news on a remote news server.  In this case, your newsrc file is
3274 stored on the news server, in your home directory, so you must have an
3275 account on the news server, but you would be running Alpine on a different
3276 machine.  The news server must be running an IMAPd server process.
3277
3278 <P>
3279 To specify a remote news-collection accessed via IMAP use the
3280 SETUP/collectionList screen's &quot;Add&quot; command.  Set the
3281 Server: value to the IMAP server's hostname, and set the Path: value
3282 to the &quot;#news.&quot; namespace (without the quotes).  See the
3283 &quot;<A HREF="h_composer_cntxt_path">Path:</A>&quot; field's help
3284 text for a more complete explanation of &quot;namespace&quot;.
3285
3286 </DD>
3287
3288 <DT>LOCAL</DT>
3289 <DD>Using local file access to the news database.  In this
3290 case, your newsrc file is stored on the news server, in your home
3291 directory, so you must have an account on the news server, and you would
3292 be running Alpine on the same machine.
3293
3294 <P>
3295 To specify a local news-collection use the SETUP/collectionList
3296 screen's &quot;Add&quot; command.  Leave the Server: value blank, and
3297 set the Path: value to the &quot;#news.&quot; namespace (without the
3298 quotes).  See the &quot;<A HREF="h_composer_cntxt_path">Path:</A>&quot;
3299 field's help text for a more complete explanation of &quot;namespace&quot;.
3300
3301 </DD>
3302 </DL>
3303
3304 <P>
3305
3306 NOTE: Should no news-collection be defined as above, Alpine will
3307 automatically create one using the Setup/Config screen's
3308 &quot;<!--#echo var="VAR_nntp-server"-->&quot; variable's value if defined.  The collection
3309 will be created as a &quot;Remote NNTP&quot; as described above.
3310
3311 <P>
3312
3313 If you are a PC-Alpine user, either option 1 (NNTP) or option 2 (IMAP) is
3314 possible.  If you don't have an account on the news server, or if the news
3315 server is not running an IMAP daemon, then you must use NNTP.  (If you are not
3316 sure, ask your service provider, university, or company for help.)  In
3317 this case, your Unix .newsrc file can be transferred to your PC.  A good
3318 place to put it would be in the same directory as your PINERC file, under
3319 the name NEWSRC, but you can
3320 <A HREF="h_config_newsrc_path">specify a different location</A>
3321 via Alpine's Setup/Config screen.
3322
3323 <P>
3324 Other configuration features related to news are
3325 <A HREF="h_config_8bit_nntp"><!--#echo var="FEAT_enable-8bit-nntp-posting"--></A>.
3326 <A HREF="h_config_compose_news_wo_conf"><!--#echo var="FEAT_compose-sets-newsgroup-without-confirm"--></A>,
3327 <A HREF="h_config_news_uses_recent"><!--#echo var="FEAT_news-approximates-new-status"--></A>,
3328 <A HREF="h_config_news_cross_deletes"><!--#echo var="FEAT_news-deletes-across-groups"--></A>,
3329 <A HREF="h_config_news_catchup"><!--#echo var="FEAT_news-offers-catchup-on-close"--></A>,
3330 <A HREF="h_config_post_wo_validation"><!--#echo var="FEAT_news-post-without-validation"--></A>,
3331 <A HREF="h_config_read_in_newsrc_order"><!--#echo var="FEAT_news-read-in-newsrc-order"--></A>, and
3332 <A HREF="h_config_quell_post_prompt"><!--#echo var="FEAT_quell-extra-post-prompt"--></A>.
3333
3334 <P>
3335 &lt;End of help on this topic&gt;
3336 </BODY>
3337 </HTML>
3338 ===== h_reading_news ======
3339 <HTML>
3340 <HEAD>
3341 <TITLE>READING NEWS</TITLE>
3342 </HEAD>
3343 <BODY>
3344 <H1>READING NEWS</H1>
3345
3346 Alpine uses almost the same commands for manipulating news folders as for
3347 mail folders.  This means, for example, that when you are done with a
3348 message, you would use &quot;D&quot; to mark it as Deleted (or Dismissed,
3349 if you prefer.)  This &quot;mail-like&quot; behavior differs from that of
3350 most newsreaders, wherein a message is implicitly dismissed after you have
3351 looked at it once. We strongly believe that Alpine should offer as much
3352 consistency as possible between mail and news, so the mail paradigm --
3353 wherein a message does not magically disappear without explicit action by
3354 the user -- is used for news as well. <P>
3355
3356 If you answer a message in a news folder, the index view will show the
3357 &quot;A&quot; flag as usual; but the industry standard file Alpine uses to
3358 keep track of what news as been read has no way of storing this flag, so
3359 it will not be preserved across sessions.  The Deleted flag is the only
3360 one that is preserved when you leave and then return to a newsgroup.  As an
3361 additional note on replies, when you Reply to a newsgroup message and say
3362 you want to reply to all recipients, Alpine will ask if you want to post the
3363 message to all the newsgroups listed in the original message. <P>
3364
3365 If you would like Alpine to mark more-or-less recent news messages as
3366 &quot;New&quot;, then set the
3367 <A HREF="h_config_news_uses_recent">&quot;<!--#echo var="FEAT_news-approximates-new-status"-->&quot;</A>
3368 feature (which is set by default).  This will cause messages after the last one you have marked as
3369 Deleted to appear with &quot;N&quot; status in the MESSAGE INDEX.  The
3370 &quot;N&quot; status often makes it easier to distinguish later news
3371 articles from those you've previously seen, but not yet disposed of via
3372 the &quot;D&quot; key.  Note that this is an approximation, not an exact
3373 record of which messages you have not seen.
3374 <P>
3375
3376 A frequent operation in news-reading is &quot;catching up&quot; -- that
3377 is, getting rid of all the messages in the newsgroup so that you can
3378 &quot;start fresh.&quot;  The easiest way to do this in Alpine is via the
3379 Select command.  You would enter the following four keystrokes:
3380 <tt>;aad</tt> to select all messaged, and then apply the delete (or
3381 dismiss) command to all of them.
3382
3383 <P>
3384 There are also additional details on
3385 <A HREF="h_configuring_news">configuring news</a>.
3386
3387 <P>
3388 &lt;End of help on this topic&gt;
3389 </BODY>
3390 </HTML>
3391 ====== h_help_index ======
3392 <HTML>
3393 <HEAD>
3394 <TITLE>Help Index</TITLE>
3395 </HEAD>
3396 <BODY>
3397 <H1>Help Index</H1>
3398 <ul>
3399 <li><a href="h_mainhelp_abooks">Address Books</a></li>
3400 <li><a href="h_abook_top">ADDRESS BOOK LIST COMMANDS</a>
3401 <li><a href="h_main_addrbook">Address Book Command</a>
3402 <li><a href="h_abook_view">Address Book View Explained</a>
3403 <li><a href="h_compose_addrcomplete">Address Completion</a>
3404 <li><a href="h_abook_select_listmode">Address Listmode Selection from Composer Explained</a>
3405 <li><a href="h_abook_select_checks">Address Selection from Composer Explained</a>
3406 <li><a href="h_composer_abook_comment">Addressbook Comment Explained</a>
3407 <li><a href="h_composer_abook_fcc">Addressbook Fcc Explained</a>
3408 <li><a href="h_composer_abook_add_folder">Addressbook Folder Name Field Explained</a>
3409 <li><a href="h_composer_abook_full">Addressbook Fullname Explained</a>
3410 <li><a href="h_composer_abook_add_nick">Addressbook NickName Field Explained</a>
3411 <li><a href="h_composer_abook_nick">Addressbook Nickname Explained</a>
3412 <li><a href="h_abook_select_addr">Addressbook Selection Explained</a>
3413 <li><a href="h_abook_select_top">Addressbook Selection Navigation Explained</a>
3414 <li><a href="h_composer_abook_add_server">Addressbook Server Name Field Explained</a>
3415 <li><a href="h_mainhelp_aggops">Aggregate Operations</a>
3416 <li><a href="h_mainhelp_config">Alpine Configuration</a>
3417 <li><a href="h_mainhelp_pinehelp">Alpine Help</a>
3418 <li><a href="h_news_legal">Alpine Legal Notices</a>
3419 <li><a href="h_compose_alted">Alt Editor Command</a>
3420 <li><a href="h_index_cmd_apply">Apply Command</a>
3421 <li><a href="h_attachment_screen">Attachment Index Screen Explained</a>
3422 <li><a href="h_mail_text_att_view">Attachment View Screen Explained</a>
3423 <li><a href="h_mainhelp_filtering">Blocking Messages</a>
3424 <li><a href="h_composer_browse">BROWSER</a>
3425 <li><a href="h_common_bounce">Bounce Command</a>
3426 <li><a href="h_compose_cancel">Cancel Command</a>
3427 <li><a href="h_config_change_your_from">Changing your From Address</a>
3428 <li><a href="h_collection_screen">COLLECTION LIST screen</a>
3429 <li><a href="h_mainhelp_color">Color</a>
3430 <li><a href="h_composer_ctrl_j">COMPOSER ATTACH</a>
3431 <li><a href="h_composer">COMPOSER COMMANDS</a>
3432 <li><a href="h_mainhelp_composing">Composing Messages</a>
3433 <li><a href="h_mainhelp_collections">Collection Lists</a>
3434 <li><a href="h_composer_cntxt_nick">Collection Nickname Explained</a>
3435 <li><a href="h_composer_cntxt_path">Collection Path: Explained</a>
3436 <li><a href="h_composer_cntxt_server">Collection Server: Explained</a>
3437 <li><a href="h_composer_cntxt_view">Collection View: Explained</a>
3438 <li><a href="h_mainhelp_cmdlineopts">Command Line Options</a>
3439 <li><a href="h_common_compose">Compose Command</a>
3440 <li><a href="h_edit_nav_cmds">Composer Editing Commands Explained</a>
3441 <li><a href="h_common_conditional_cmds">Conditional Commands</a>
3442 <li><a href="h_reply_token_conditionals">Conditional Inclusion of Text for <!--#echo var="VAR_reply-leadin"-->, Signatures, and Templates</a>
3443 <li><a href="h_mainhelp_config">Configuration</a>
3444 <li><a href="h_composer_custom_free">CUSTOMIZED HEADER FIELD</a>
3445 <li><a href="h_config_dflt_color">Default Color</a>
3446 <li><a href="h_common_delete">Delete and Undelete Commands</a>
3447 <li><a href="h_composer_qserv_cn">Directory Query Form Explained</a>
3448 <li><a href="h_special_list_commands">Email List Commands Explained</a>
3449 <li><a href="h_composer_search">Explanation of Composer Whereis Command </a>
3450 <li><a href="h_folder_open">Explanation of Folder Selection</a>
3451 <li><a href="h_special_xon_xoff">Explanation of Alpine's XOFF/XON Handling</a>
3452 <li><a href="h_valid_folder_names">Explanation of Valid Folder Names</a>
3453 <li><a href="h_ge_export">Export File Selection</a>
3454 <li><a href="h_ge_allparts">Export Message File Selection</a>
3455 <li><a href="h_index_cmd_expunge">Expunge/Exclude Command</a>
3456 <li><a href="h_info_on_locking">FAQs on Alpine Locking</a>
3457 <li><a href="h_config_allow_chg_from">FEATURE: <!--#echo var="FEAT_allow-changing-from"--></a>
3458 <li><a href="h_config_allow_talk">FEATURE: <!--#echo var="FEAT_allow-talk"--></a>
3459 <li><a href="h_config_alt_compose_menu">FEATURE: <!--#echo var="FEAT_alternate-compose-menu"--></a>
3460 <li><a href="h_config_alt_role_menu">FEATURE: <!--#echo var="FEAT_alternate-role-menu"--></a>
3461 <li><a href="h_config_force_low_speed">FEATURE: <!--#echo var="FEAT_assume-slow-link"--></a>
3462 <li><a href="h_config_auto_read_msgs">FEATURE: <!--#echo var="FEAT_auto-move-read-msgs"--></a>
3463 <li><a href="h_config_auto_open_unread">FEATURE: <!--#echo var="FEAT_auto-open-next-unread"--></a>
3464 <li><a href="h_config_auto_unselect">FEATURE: <!--#echo var="FEAT_auto-unselect-after-apply"--></a>
3465 <li><a href="h_config_auto_unzoom">FEATURE: <!--#echo var="FEAT_auto-unzoom-after-apply"--></a>
3466 <li><a href="h_config_auto_zoom">FEATURE: <!--#echo var="FEAT_auto-zoom-after-select"--></a>
3467 <li><a href="h_config_use_boring_spinner">FEATURE: <!--#echo var="FEAT_busy-cue-spinner-only"--></a>
3468 <li><a href="h_config_check_mail_onquit">FEATURE: <!--#echo var="FEAT_check-newmail-when-quitting"--></a>
3469 <li><a href="h_config_combined_abook_display">FEATURE: <!--#echo var="FEAT_combined-addrbook-display"--></a>
3470 <li><a href="h_config_combined_folder_display">FEATURE: <!--#echo var="FEAT_combined-folder-display"--></a>
3471 <li><a href="h_config_combined_subdir_display">FEATURE: <!--#echo var="FEAT_combined-subdirectory-display"--></a>
3472 <li><a href="h_config_cancel_confirm">FEATURE: <!--#echo var="FEAT_compose-cancel-confirm-uses-yes"--></a>
3473 <li><a href="h_config_lame_list_mode">FEATURE: <!--#echo var="FEAT_enable-lame-list-mode"--></a>
3474 <li><a href="h_config_compose_rejects_unqual">FEATURE: <!--#echo var="FEAT_compose-rejects-unqualified-addrs"--></a>
3475 <li><a href="h_config_send_filter_dflt">FEATURE: <!--#echo var="FEAT_compose-send-offers-first-filter"--></a>
3476 <li><a href="h_config_compose_news_wo_conf">FEATURE: <!--#echo var="FEAT_compose-sets-newsgroup-without-confirm"--></a>
3477 <li><a href="h_config_del_from_dot">FEATURE: <!--#echo var="FEAT_compose-cut-from-cursor"--></a>
3478 <li><a href="h_config_compose_maps_del">FEATURE: <!--#echo var="FEAT_compose-maps-delete-key-to-ctrl-d"--></a>
3479 <li><a href="h_config_confirm_role">FEATURE: <!--#echo var="FEAT_confirm-role-even-for-default"--></a>
3480 <li><a href="h_config_tab_no_prompt">FEATURE: <!--#echo var="FEAT_continue-tab-without-confirm"--></a>
3481 <li><a href="h_config_dates_to_local">FEATURE: <!--#echo var="FEAT_convert-dates-to-localtime"--></a>
3482 <li><a href="h_config_copy_to_to_from">FEATURE: <!--#echo var="FEAT_copy-to-address-to-from-if-it-is-us"--></a>
3483 <li><a href="h_config_del_skips_del">FEATURE: <!--#echo var="FEAT_delete-skips-deleted"--></a>
3484 <li><a href="h_config_disable_config_cmd">FEATURE: <!--#echo var="FEAT_disable-config-cmd"--></a>
3485 <li><a href="h_config_disable_index_locale_dates">FEATURE: <!--#echo var="FEAT_disable-index-locale-dates"--></a>
3486 <li><a href="h_config_disable_kb_lock">FEATURE: <!--#echo var="FEAT_disable-keyboard-lock-cmd"--></a>
3487 <li><a href="h_config_blank_keymenu">FEATURE: <!--#echo var="FEAT_disable-keymenu"--></a>
3488 <li><a href="h_config_disable_password_caching">FEATURE: <!--#echo var="FEAT_disable-password-caching"--></a>
3489 <li><a href="h_config_disable_password_cmd">FEATURE: <!--#echo var="FEAT_disable-password-cmd"--></a>
3490 <li><a href="h_config_disable_pipes_in_sigs">FEATURE: <!--#echo var="FEAT_disable-pipes-in-sigs"--></a>
3491 <li><a href="h_config_disable_pipes_in_templates">FEATURE: <!--#echo var="FEAT_disable-pipes-in-templates"--></a>
3492 <li><a href="h_config_disable_regex">FEATURE: <!--#echo var="FEAT_disable-regular-expression-matching-for-alternate-addresses"--></a>
3493 <li><a href="h_config_disable_roles_setup">FEATURE: <!--#echo var="FEAT_disable-roles-setup-cmd"--></a>
3494 <li><a href="h_config_disable_roles_sigedit">FEATURE: <!--#echo var="FEAT_disable-roles-sig-edit"--></a>
3495 <li><a href="h_config_disable_roles_templateedit">FEATURE: <!--#echo var="FEAT_disable-roles-template-edit"--></a>
3496 <li><a href="h_config_input_history">FEATURE: <!--#echo var="FEAT_disable-save-input-history"--></a>
3497 <li><a href="h_config_disable_collate">FEATURE: <!--#echo var="FEAT_disable-setlocale-collate"--></a>
3498 <li><a href="h_config_disable_shared">FEATURE: <!--#echo var="FEAT_disable-shared-namespaces"--></a>
3499 <li><a href="h_config_disable_signature_edit">FEATURE: <!--#echo var="FEAT_disable-signature-edit-cmd"--></a>
3500 <li><a href="h_config_take_fullname">FEATURE: <!--#echo var="FEAT_disable-take-fullname-in-addresses"--></a>
3501 <li><a href="h_config_take_lastfirst">FEATURE: <!--#echo var="FEAT_disable-take-last-comma-first"--></a>
3502 <li><a href="h_config_disable_reset_disp">FEATURE: <!--#echo var="FEAT_disable-terminal-reset-for-display-filters"--></a>
3503 <li><a href="h_config_disable_sender">FEATURE: <!--#echo var="FEAT_disable-sender"--></a>
3504 <li><a href="h_config_quell_dead_letter">FEATURE: <!--#echo var="FEAT_quell-dead-letter-on-cancel"--></a>
3505 <li><a href="h_config_quell_flowed_text">FEATURE: <!--#echo var="FEAT_quell-flowed-text"--></a>
3506 <li><a href="h_downgrade_multipart_to_text">FEATURE: <!--#echo var="FEAT_downgrade-multipart-to-text"--></a>
3507 <li><a href="h_config_8bit_smtp">FEATURE: <!--#echo var="FEAT_enable-8bit-esmtp-negotiation"--></a>
3508 <li><a href="h_config_8bit_nntp">FEATURE: <!--#echo var="FEAT_enable-8bit-nntp-posting"--></a>
3509 <li><a href="h_config_enable_agg_ops">FEATURE: <!--#echo var="FEAT_enable-aggregate-command-set"--></a>
3510 <li><a href="h_config_enable_alt_ed">FEATURE: <!--#echo var="FEAT_enable-alternate-editor-cmd"--></a>
3511 <li><a href="h_config_alt_ed_now">FEATURE: <!--#echo var="FEAT_enable-alternate-editor-implicitly"--></a>
3512 <li><a href="h_config_arrow_nav">FEATURE: <!--#echo var="FEAT_enable-arrow-navigation"--></a>
3513 <li><a href="h_config_relaxed_arrow_nav">FEATURE: <!--#echo var="FEAT_enable-arrow-navigation-relaxed"--></a>
3514 <li><a href="h_config_compose_bg_post">FEATURE: <!--#echo var="FEAT_enable-background-sending"--></a>
3515 <li><a href="h_config_enable_bounce">FEATURE: <!--#echo var="FEAT_enable-bounce-cmd"--></a>
3516 <li><a href="h_config_cruise_mode">FEATURE: <!--#echo var="FEAT_enable-cruise-mode"--></a>
3517 <li><a href="h_config_cruise_mode_delete">FEATURE: <!--#echo var="FEAT_enable-cruise-mode-delete"--></a>
3518 <li><a href="h_config_compose_dsn">FEATURE: <!--#echo var="FEAT_enable-delivery-status-notification"--></a>
3519 <li><a href="h_config_enable_dot_files">FEATURE: <!--#echo var="FEAT_enable-dot-files"--></a>
3520 <li><a href="h_config_enable_lessthan_exit">FEATURE: <!--#echo var="FEAT_enable-exit-via-lessthan-command"--></a>
3521 <li><a href="h_config_fast_recent">FEATURE: <!--#echo var="FEAT_enable-fast-recent-test"--></a>
3522 <li><a href="h_config_enable_flag">FEATURE: <!--#echo var="FEAT_enable-flag-cmd"--></a>
3523 <li><a href="h_config_flag_screen_default">FEATURE: <!--#echo var="FEAT_enable-flag-screen-implicitly"--></a>
3524 <li><a href="h_config_flag_screen_kw_shortcut">FEATURE: <!--#echo var="FEAT_enable-flag-screen-keyword-shortcut"--></a>
3525 <li><a href="h_config_enable_full_hdr_and_text">FEATURE: <!--#echo var="FEAT_enable-full-header-and-text"--></a>
3526 <li><a href="h_config_enable_full_hdr">FEATURE: <!--#echo var="FEAT_enable-full-header-cmd"--></a>
3527 <li><a href="h_config_allow_goto">FEATURE: <!--#echo var="FEAT_enable-goto-in-file-browser"--></a>
3528 <li><a href="h_config_enable_dot_folders">FEATURE: <!--#echo var="FEAT_enable-dot-folders"--></a>
3529 <li><a href="h_config_enable_incoming">FEATURE: <!--#echo var="FEAT_enable-incoming-folders"--></a>
3530 <li><a href="h_config_enable_incoming_checking">FEATURE: <!--#echo var="FEAT_enable-incoming-folders-checking"--></a>
3531 <li><a href="h_config_enable_jump">FEATURE: <!--#echo var="FEAT_enable-jump-shortcut"--></a>
3532 <li><a href="h_config_show_delay_cue">FEATURE: <!--#echo var="FEAT_enable-mail-check-cue"--></a>
3533 <li><a href="h_config_mailcap_params">FEATURE: <!--#echo var="FEAT_enable-mailcap-param-substitution"--></a>
3534 <li><a href="h_config_enable_mouse">FEATURE: <!--#echo var="FEAT_enable-mouse-in-xterm"--></a>
3535 <li><a href="h_config_enable_view_addresses">FEATURE: <!--#echo var="FEAT_enable-msg-view-addresses"--></a>
3536 <li><a href="h_config_enable_view_attach">FEATURE: <!--#echo var="FEAT_enable-msg-view-attachments"--></a>
3537 <li><a href="h_config_enable_view_arrows">FEATURE: <!--#echo var="FEAT_enable-msg-view-forced-arrows"--></a>
3538 <li><a href="h_config_enable_view_url">FEATURE: <!--#echo var="FEAT_enable-msg-view-urls"--></a>
3539 <li><a href="h_config_enable_view_web_host">FEATURE: <!--#echo var="FEAT_enable-msg-view-web-hostnames"--></a>
3540 <li><a href="h_config_enable_mulnewsrcs">FEATURE: <!--#echo var="FEAT_enable-multiple-newsrcs"--></a>
3541 <li><a href="h_config_enable_xterm_newmail">FEATURE: <!--#echo var="FEAT_enable-newmail-in-xterm-icon"--></a>
3542 <li><a href="h_config_enable_newmail_short_text">FEATURE: <!--#echo var="FEAT_enable-newmail-short-text-in-icon"--></a>
3543 <li><a href="h_config_sub_lists">FEATURE: <!--#echo var="FEAT_enable-partial-match-lists"--></a>
3544 <li><a href="h_config_enable_y_print">FEATURE: <!--#echo var="FEAT_enable-print-via-y-command"--></a>
3545 <li><a href="h_config_prefix_editing">FEATURE: <!--#echo var="FEAT_enable-reply-indent-string-editing"--></a>
3546 <li><a href="h_config_enable_search_and_repl">FEATURE: <!--#echo var="FEAT_enable-search-and-replace"--></a>
3547 <li><a href="h_config_sigdashes">FEATURE: <!--#echo var="FEAT_enable-sigdashes"--></a>
3548 <li><a href="h_config_new_thread_blank_subject">FEATURE: <!--#echo var="FEAT_new-thread-on-blank-subject"--></a>
3549 <li><a href="h_config_can_suspend">FEATURE: <!--#echo var="FEAT_enable-suspend"--></a>
3550 <li><a href="h_config_enable_tab_complete">FEATURE: <!--#echo var="FEAT_enable-tab-completion"--></a>
3551 <li><a href="h_config_enable_take_export">FEATURE: <!--#echo var="FEAT_enable-take-export"--></a>
3552 <li><a href="h_config_enable_role_take">FEATURE: <!--#echo var="FEAT_enable-rules-under-take"--></a>
3553 <li><a href="h_config_tray_icon">FEATURE: <!--#echo var="FEAT_enable-tray-icon"--></a>
3554 <li><a href="h_config_enable_pipe">FEATURE: <!--#echo var="FEAT_enable-unix-pipe-cmd"--></a>
3555 <li><a href="h_config_verbose_post">FEATURE: <!--#echo var="FEAT_enable-verbose-smtp-posting"--></a>
3556 <li><a href="h_config_expanded_addrbooks">FEATURE: <!--#echo var="FEAT_expanded-view-of-addressbooks"--></a>
3557 <li><a href="h_config_expanded_distlists">FEATURE: <!--#echo var="FEAT_expanded-view-of-distribution-lists"--></a>
3558 <li><a href="h_config_expanded_folders">FEATURE: <!--#echo var="FEAT_expanded-view-of-folders"--></a>
3559 <li><a href="h_config_expose_hidden_config">FEATURE: <!--#echo var="FEAT_expose-hidden-config"--></a>
3560 <li><a href="h_config_expunge_manually">FEATURE: <!--#echo var="FEAT_expunge-only-manually"--></a>
3561 <li><a href="h_config_auto_expunge">FEATURE: <!--#echo var="FEAT_expunge-without-confirm"--></a>
3562 <li><a href="h_config_full_auto_expunge">FEATURE: <!--#echo var="FEAT_expunge-without-confirm-everywhere"--></a>
3563 <li><a href="h_config_no_fcc_attach">FEATURE: <!--#echo var="FEAT_fcc-without-attachments"--></a>
3564 <li><a href="h_config_force_arrow">FEATURE: <!--#echo var="FEAT_force-arrow-cursor"--></a>
3565 <li><a href="h_config_forward_as_attachment">FEATURE: <!--#echo var="FEAT_forward-as-attachment"--></a>
3566 <li><a href="h_config_preserve_field">FEATURE: <!--#echo var="FEAT_preserve-original-fields"--></a>
3567 <li><a href="h_config_quell_empty_dirs">FEATURE: <!--#echo var="FEAT_quell-empty-directories"--></a>
3568 <li><a href="h_config_hide_nntp_path">FEATURE: <!--#echo var="FEAT_hide-nntp-path"--></a>
3569 <li><a href="h_config_attach_in_reply">FEATURE: <!--#echo var="FEAT_include-attachments-in-reply"--></a>
3570 <li><a href="h_config_fcc_on_bounce">FEATURE: <!--#echo var="FEAT_fcc-on-bounce"--></a>
3571 <li><a href="h_config_include_header">FEATURE: <!--#echo var="FEAT_include-header-in-reply"--></a>
3572 <li><a href="h_config_auto_include_reply">FEATURE: <!--#echo var="FEAT_include-text-in-reply"--></a>
3573 <li><a href="h_config_incoming_checking_total">FEATURE: <!--#echo var="FEAT_incoming-checking-includes-total"--></a>
3574 <li><a href="h_config_incoming_checking_recent">FEATURE: <!--#echo var="FEAT_incoming-checking-uses-recent"--></a>
3575 <li><a href="h_config_add_ldap">FEATURE: <!--#echo var="FEAT_ldap-result-to-addrbook-add"--></a>
3576 <li><a href="h_config_maildrops_preserve_state">FEATURE: <!--#echo var="FEAT_maildrops-preserve-state"--></a>
3577 <li><a href="h_config_mark_fcc_seen">FEATURE: <!--#echo var="FEAT_mark-fcc-seen"--></a>
3578 <li><a href="h_config_mark_for_cc">FEATURE: <!--#echo var="FEAT_mark-for-cc"--></a>
3579 <li><a href="h_config_mulnews_as_typed">FEATURE: <!--#echo var="FEAT_mult-newsrc-hostnames-as-typed"--></a>
3580 <li><a href="h_config_news_uses_recent">FEATURE: <!--#echo var="FEAT_news-approximates-new-status"--></a>
3581 <li><a href="h_config_news_cross_deletes">FEATURE: <!--#echo var="FEAT_news-deletes-across-groups"--></a>
3582 <li><a href="h_config_news_catchup">FEATURE: <!--#echo var="FEAT_news-offers-catchup-on-close"--></a>
3583 <li><a href="h_config_post_wo_validation">FEATURE: <!--#echo var="FEAT_news-post-without-validation"--></a>
3584 <li><a href="h_config_read_in_newsrc_order">FEATURE: <!--#echo var="FEAT_news-read-in-newsrc-order"--></a>
3585 <li><a href="h_config_nntp_search_uses_overview">FEATURE: <!--#echo var="FEAT_nntp-search-uses-overview"--></a>
3586 <li><a href="h_config_thread_sorts_by_arrival">FEATURE: <!--#echo var="FEAT_thread-sorts-by-arrival"--></a>
3587 <li><a href="h_config_expunge_inbox">FEATURE: <!--#echo var="FEAT_offer-expunge-of-inbox"--></a>
3588 <li><a href="h_config_expunge_stayopens">FEATURE: <!--#echo var="FEAT_offer-expunge-of-stayopen-folders"--></a>
3589 <li><a href="h_config_pass_c1_control">FEATURE: <!--#echo var="FEAT_pass-c1-control-characters-as-is"--></a>
3590 <li><a href="h_config_pass_control">FEATURE: <!--#echo var="FEAT_pass-control-characters-as-is"--></a>
3591 <li><a href="h_config_predict_nntp_server">FEATURE: <!--#echo var="FEAT_predict-nntp-server"--></a>
3592 <li><a href="h_config_prefer_plain_text">FEATURE: <!--#echo var="FEAT_prefer-plain-text"--></a>
3593 <li><a href="h_config_preopen_stayopens">FEATURE: <!--#echo var="FEAT_preopen-stayopen-folders"--></a>
3594 <li><a href="h_config_preserve_start_stop">FEATURE: <!--#echo var="FEAT_preserve-start-stop-characters"--></a>
3595 <li><a href="h_config_quell_folder_internal_msg">FEATURE: <!--#echo var="FEAT_quell-folder-internal-msg"--></a>
3596 <li><a href="h_config_quell_checks_comp">FEATURE: <!--#echo var="FEAT_quell-mailchecks-composing-except-inbox"--></a>
3597 <li><a href="h_config_quell_checks_comp_inbox">FEATURE: <!--#echo var="FEAT_quell-mailchecks-composing-inbox"--></a>
3598 <li><a href="h_config_quell_partial">FEATURE: <!--#echo var="FEAT_quell-partial-fetching"--></a>
3599 <li><a href="h_config_quell_local_lookup">FEATURE: <!--#echo var="FEAT_quell-user-lookup-in-passwd-file"--></a>
3600 <li><a href="h_config_ff_between_msgs">FEATURE: <!--#echo var="FEAT_print-formfeed-between-messages"--></a>
3601 <li><a href="h_config_print_from">FEATURE: <!--#echo var="FEAT_print-includes-from-line"--></a>
3602 <li><a href="h_config_print_index">FEATURE: <!--#echo var="FEAT_print-index-enabled"--></a>
3603 <li><a href="h_config_custom_print">FEATURE: <!--#echo var="FEAT_print-offers-custom-cmd-prompt"--></a>
3604 <li><a href="h_config_prune_uses_iso">FEATURE: <!--#echo var="FEAT_prune-uses-yyyy-mm"--></a>
3605 <li><a href="h_config_quell_personal_name_prompt">FEATURE: <!--#echo var="FEAT_quell-personal-name-prompt"--></a>
3606 <li><a href="h_config_quell_ssl_largeblocks">FEATURE: <!--#echo var="FEAT_quell-ssl-largeblocks"--></a>
3607 <li><a href="h_config_quell_user_id_prompt">FEATURE: <!--#echo var="FEAT_quell-user-id-prompt"--></a>
3608 <li><a href="h_config_quit_wo_confirm">FEATURE: <!--#echo var="FEAT_quit-without-confirm"--></a>
3609 <li><a href="h_config_quote_replace_noflow">FEATURE: <!--#echo var="FEAT_quote-replace-nonflowed"--></a>
3610 <li><a href="h_config_next_thrd_wo_confirm">FEATURE: <!--#echo var="FEAT_next-thread-without-confirm"--></a>
3611 <li><a href="h_config_auto_reply_to">FEATURE: <!--#echo var="FEAT_reply-always-uses-reply-to"--></a>
3612 <li><a href="h_config_inbox_no_confirm">FEATURE: <!--#echo var="FEAT_return-to-inbox-without-confirm"--></a>
3613 <li><a href="h_config_save_aggregates">FEATURE: <!--#echo var="FEAT_save-aggregates-copy-sequence"--></a>
3614 <li><a href="h_config_save_part_wo_confirm">FEATURE: <!--#echo var="FEAT_save-partial-msg-without-confirm"--></a>
3615 <li><a href="h_config_save_advances">FEATURE: <!--#echo var="FEAT_save-will-advance"--></a>
3616 <li><a href="h_config_save_wont_delete">FEATURE: <!--#echo var="FEAT_save-will-not-delete"--></a>
3617 <li><a href="h_config_quote_all_froms">FEATURE: <!--#echo var="FEAT_save-will-quote-leading-froms"--></a>
3618 <li><a href="h_config_scramble_message_id">FEATURE: <!--#echo var="FEAT_scramble-message-id"--></a>
3619 <li><a href="h_config_select_wo_confirm">FEATURE: <!--#echo var="FEAT_select-without-confirm"--></a>
3620 <li><a href="h_config_auto_fcc_only">FEATURE: <!--#echo var="FEAT_fcc-only-without-confirm"--></a>
3621 <li><a href="h_config_send_wo_confirm">FEATURE: <!--#echo var="FEAT_send-without-confirm"--></a>
3622 <li><a href="h_config_separate_fold_dir_view">FEATURE: <!--#echo var="FEAT_separate-folder-and-directory-entries"--></a>
3623 <li><a href="h_config_show_cursor">FEATURE: <!--#echo var="FEAT_show-cursor"--></a>
3624 <li><a href="h_config_textplain_int">FEATURE: <!--#echo var="FEAT_show-plain-text-internally"--></a>
3625 <li><a href="h_config_select_in_bold">FEATURE: <!--#echo var="FEAT_show-selected-in-boldface"--></a>
3626 <li><a href="h_config_show_sort">FEATURE: <!--#echo var="FEAT_show-sort"--></a>
3627 <li><a href="h_config_single_list">FEATURE: <!--#echo var="FEAT_single-column-folder-list"--></a>
3628 <li><a href="h_config_sig_at_bottom">FEATURE: <!--#echo var="FEAT_signature-at-bottom"--></a>
3629 <li><a href="h_config_slash_coll_entire">FEATURE: <!--#echo var="FEAT_slash-collapses-entire-thread"--></a>
3630 <li><a href="h_config_sort_fcc_alpha">FEATURE: <!--#echo var="FEAT_sort-default-fcc-alpha"--></a>
3631 <li><a href="h_config_sort_save_alpha">FEATURE: <!--#echo var="FEAT_sort-default-save-alpha"--></a>
3632 <li><a href="h_config_always_spell_check">FEATURE: <!--#echo var="FEAT_spell-check-before-sending"--></a>
3633 <li><a href="h_config_winpos_in_config">FEATURE: <!--#echo var="FEAT_store-window-position-in-config"--></a>
3634 <li><a href="h_config_strip_sigdashes">FEATURE: <!--#echo var="FEAT_strip-from-sigdashes-on-reply"--></a>
3635 <li><a href="h_config_strip_ws_before_send">FEATURE: <!--#echo var="FEAT_strip-whitespace-before-send"--></a>
3636 <li><a href="h_config_quells_asterisks">FEATURE: <!--#echo var="FEAT_suppress-asterisks-in-password-prompt"--></a>
3637 <li><a href="h_config_quell_attach_ext_warn">FEATURE: <!--#echo var="FEAT_quell-attachment-extension-warn"--></a>
3638 <li><a href="h_config_quell_attach_extra_prompt">FEATURE: <!--#echo var="FEAT_quell-attachment-extra-prompt"--></a>
3639 <li><a href="h_config_no_bezerk_zone">FEATURE: <!--#echo var="FEAT_quell-berkeley-format-timezone"--></a>
3640 <li><a href="h_config_quell_charset_warning">FEATURE: <!--#echo var="FEAT_quell-charset-warning"--></a>
3641 <li><a href="h_config_quell_content_id">FEATURE: <!--#echo var="FEAT_quell-content-id"--></a>
3642 <li><a href="h_config_quell_post_prompt">FEATURE: <!--#echo var="FEAT_quell-extra-post-prompt"--></a>
3643 <li><a href="h_config_quell_filtering_done_message">FEATURE: <!--#echo var="FEAT_quell-filtering-done-message"--></a>
3644 <li><a href="h_config_quell_filtering_messages">FEATURE: <!--#echo var="FEAT_quell-filtering-messages"--></a>
3645 <li><a href="h_config_quell_full_hdr_reset">FEATURE: <!--#echo var="FEAT_quell-full-header-auto-reset"--></a>
3646 <li><a href="h_config_quell_imap_env">FEATURE: <!--#echo var="FEAT_quell-imap-envelope-update"--></a>
3647 <li><a href="h_config_quell_lock_failure_warnings">FEATURE: <!--#echo var="FEAT_quell-lock-failure-warnings"--></a>
3648 <li><a href="h_config_quell_domain_warn">FEATURE: <!--#echo var="FEAT_quell-maildomain-warning"--></a>
3649 <li><a href="h_config_quell_news_env">FEATURE: <!--#echo var="FEAT_quell-news-envelope-update"--></a>
3650 <li><a href="h_config_quell_host_after_url">FEATURE: <!--#echo var="FEAT_quell-server-after-link-in-html"--></a>
3651 <li><a href="h_config_quell_beeps">FEATURE: <!--#echo var="FEAT_quell-status-message-beeping"--></a>
3652 <li><a href="h_config_quell_tz_comment">FEATURE: <!--#echo var="FEAT_quell-timezone-comment-when-sending"--></a>
3653 <li><a href="h_config_suppress_user_agent">FEATURE: <!--#echo var="FEAT_suppress-user-agent-when-sending"--></a>
3654 <li><a href="h_config_tab_checks_recent">FEATURE: <!--#echo var="FEAT_tab-checks-recent"--></a>
3655 <li><a href="h_config_tab_uses_unseen">FEATURE: <!--#echo var="FEAT_tab-uses-unseen-for-next-folder"--></a>
3656 <li><a href="h_config_tab_new_only">FEATURE: <!--#echo var="FEAT_tab-visits-next-new-message-only"--></a>
3657 <li><a href="h_config_termcap_wins">FEATURE: <!--#echo var="FEAT_termdef-takes-precedence"--></a>
3658 <li><a href="h_config_color_thrd_import">FEATURE: <!--#echo var="FEAT_thread-index-shows-important-color"--></a>
3659 <li><a href="h_config_alt_auth">FEATURE: <!--#echo var="FEAT_try-alternative-authentication-driver-first"--></a>
3660 <li><a href="h_config_unsel_wont_advance">FEATURE: <!--#echo var="FEAT_unselect-will-not-advance"--></a>
3661 <li><a href="h_config_use_current_dir">FEATURE: <!--#echo var="FEAT_use-current-dir"--></a>
3662 <li><a href="h_config_use_fk">FEATURE: <!--#echo var="FEAT_use-function-keys"--></a>
3663 <li><a href="h_config_use_reg_start_for_stayopen">FEATURE: <!--#echo var="FEAT_use-regular-startup-rule-for-stayopen-folders"--></a>
3664 <li><a href="h_config_use_resentto">FEATURE: <!--#echo var="FEAT_use-resent-to-in-rules"--></a>
3665 <li><a href="h_config_use_sender_not_x">FEATURE: <!--#echo var="FEAT_use-sender-not-x-sender"--></a>
3666 <li><a href="h_config_suspend_spawns">FEATURE: <!--#echo var="FEAT_use-subshell-for-suspend"--></a>
3667 <li><a href="h_config_use_system_translation">FEATURE: Use System Translation</a>
3668 <li><a href="h_config_vertical_list">FEATURE: <!--#echo var="FEAT_vertical-folder-list"--></a>
3669 <li><a href="h_config_warn_if_fcc_blank">FEATURE: <!--#echo var="FEAT_warn-if-blank-fcc"--></a>
3670 <li><a href="h_config_warn_if_subj_blank">FEATURE: <!--#echo var="FEAT_warn-if-blank-subject"--></a>
3671 <li><a href="h_config_warn_if_no_to_or_cc">FEATURE: <!--#echo var="FEAT_warn-if-blank-to-and-cc-and-newsgroups"--></a>
3672 <li><a href="h_mainhelp_filtering">Filtering</a>
3673 <li><a href="h_finding_help">Finding more information and requesting help</a>
3674 <li><a href="h_common_flag">Flag Command</a>
3675 <li><a href="h_config_quell_flowed_text">Flowed Text</a>
3676 <li><a href="h_mainhelp_folders">Folders</a>
3677 <li><a href="h_what_are_collections">Folder Collections Explained</a>
3678 <li><a href="h_common_folders">Folder List Command</a>
3679 <li><a href="h_folder_fcc">Folder Select for Fcc Explained</a>
3680 <li><a href="h_folder_save">Folder Select for Save Explained</a>
3681 <li><a href="h_folder_server_syntax">Folder Server Name Syntax</a>
3682 <li><a href="h_config_change_your_from">From Address, Changing</a>
3683 <li><a href="main_menu_tx">GENERAL INFORMATION ON THE ALPINE MESSAGE SYSTEM</a>
3684 <li><a href="h_pine_for_windows">GETTING HELP IN ALPINE</a>
3685 <li><a href="h_common_goto">Goto Command</a>
3686 <li><a href="h_common_hdrmode">HdrMode Command</a>
3687 <li><a href="h_mainhelp_pinehelp">Help</a>
3688 <li><a href="h_special_help_nav">Help Text Navigation Explained</a>
3689 <li><a href="h_folder_maint">Help for Folder List</a>
3690 <li><a href="h_valid_folder_names">IMAP</a>
3691 <li><a href="h_ge_import">Import File Selection</a>
3692 <li><a href="h_mainhelp_index">Index of Messages</a>
3693 <li><a href="h_composer_ins_m">INSERT MESSAGE</a>
3694 <li><a href="h_composer_ins">INSERT TEXT FILE</a>
3695 <li><a href="h_address_format">INTERNET EMAIL ADDRESS FORMAT</a>
3696 <li><a href="h_info_on_mbox">Information on mbox driver</a>
3697 <li><a href="h_mainhelp_intro">Introduction</a>
3698 <li><a href="h_main_journal">Journal Command</a>
3699 <li><a href="h_common_jump">Jump Command</a>
3700 <li><a href="h_compose_justify">Justify Command</a>
3701 <li><a href="h_main_kblock">Keyboard Lock Command</a>
3702 <li><a href="h_mainhelp_keywords">Keywords (or Flags, or Labels)</a>
3703 <li><a href="h_mainhelp_ldap">LDAP</a>
3704 <li><a href="h_config_ldap_opts_tls">LDAP FEATURE: Attempt-TLS-On-Connection</a>
3705 <li><a href="h_config_ldap_opts_nosub">LDAP FEATURE: Disable-Ad-Hoc-Space-Substitution</a>
3706 <li><a href="h_config_ldap_opts_rhs">LDAP FEATURE: Lookup-Addrbook-Contents</a>
3707 <li><a href="h_config_ldap_opts_tlsmust">LDAP FEATURE: Require-TLS-On-Connection</a>
3708 <li><a href="h_config_ldap_opts_ref">LDAP FEATURE: Save-Search-Criteria-Not-Result</a>
3709 <li><a href="h_config_ldap_opts_impl">LDAP FEATURE: Use-Implicitly-From-Composer</a>
3710 <li><a href="h_config_ldap_binddn">LDAP OPTION: Bind-DN</a>
3711 <li><a href="h_config_ldap_cust">LDAP OPTION: Custom-Search-Filter</a>
3712 <li><a href="h_config_ldap_email_attr">LDAP OPTION: EmailAttribute</a>
3713 <li><a href="h_config_ldap_gn_attr">LDAP OPTION: GivennameAttribute</a>
3714 <li><a href="h_config_ldap_server">LDAP OPTION: <!--#echo var="VAR_ldap-servers"--></a>
3715 <li><a href="h_config_ldap_cn_attr">LDAP OPTION: NameAttribute</a>
3716 <li><a href="h_config_ldap_nick">LDAP OPTION: Nickname</a>
3717 <li><a href="h_config_ldap_port">LDAP OPTION: Port</a>
3718 <li><a href="h_config_ldap_base">LDAP OPTION: Search-Base</a>
3719 <li><a href="h_config_ldap_searchrules">LDAP OPTION: Search-Rule</a>
3720 <li><a href="h_config_ldap_searchtypes">LDAP OPTION: Search-Type</a>
3721 <li><a href="h_config_ldap_size">LDAP OPTION: Sizelimit</a>
3722 <li><a href="h_config_ldap_sn_attr">LDAP OPTION: SurnameAttribute</a>
3723 <li><a href="h_config_ldap_time">LDAP OPTION: Timelimit</a>
3724 <li><a href="h_ldap_view">LDAP Response View Explained</a>
3725 <li><a href="h_maildrop">Mail Drop: What is it?</a>
3726 <li><a href="h_mainhelp_mainmenu">MAIN MENU</a>
3727 <li><a href="h_mail_index">MESSAGE INDEX COMMANDS</a>
3728 <li><a href="h_mail_view">MESSAGE TEXT SCREEN</a>
3729 <li><a href="h_compose_markcutpaste">Mark, Cut and Paste Commands</a>
3730 <li><a href="h_common_index">Message Index Command</a>
3731 <li><a href="h_mainhelp_mouse">Mouse</a>
3732 <li><a href="h_mainhelp_aggops">Multiple Message Operations</a>
3733 <li><a href="new_user_greeting">NEW USER GREETING</a>
3734 <li><a href="new_version_greeting">NEW VERSION GREETING</a>
3735 <li><a href="h_mainhelp_readingnews">News Reading</a>
3736 <li><a href="h_folder_subscribe">Newsgroup Subcribe Screen explained</a>
3737 <li><a href="h_folder_postnews">Newsgroup selecting for Posting explained</a>
3738 <li><a href="h_common_nextnew">NextNew Command</a>
3739 <li><a href="h_abook_select_nick">Nickname Selection Explained</a>
3740 <li><a href="h_mainhelp_readingnews">NNTP</a>
3741 <li><a href="h_config_address_book">OPTION: <!--#echo var="VAR_address-book"--></a>
3742 <li><a href="h_config_abook_formats">OPTION: <!--#echo var="VAR_addressbook-formats"--></a>
3743 <li><a href="h_config_ab_sort_rule">OPTION: <!--#echo var="VAR_addrbook-sort-rule"--></a></a>
3744 <li><a href="h_config_alt_addresses">OPTION: <!--#echo var="VAR_alt-addresses"--></a>
3745 <li><a href="h_config_active_msg_interval">OPTION: <!--#echo var="VAR_busy-cue-rate"--></a>
3746 <li><a href="h_config_color_style">OPTION: Color Style</a>
3747 <li><a href="h_config_wordseps">OPTION: <!--#echo var="VAR_composer-word-separators"--></a>
3748 <li><a href="h_config_composer_wrap_column">OPTION: <!--#echo var="VAR_composer-wrap-column"--></a>
3749 <li><a href="h_config_index_color_style">OPTION: <!--#echo var="VAR_current-indexline-style"--></a>
3750 <li><a href="h_config_cursor_style">OPTION: Cursor Style</a>
3751 <li><a href="h_config_custom_hdrs">OPTION: <!--#echo var="VAR_customized-hdrs"--></a>
3752 <li><a href="h_config_deadlets">OPTION: <!--#echo var="VAR_dead-letter-files"--></a>
3753 <li><a href="h_config_comp_hdrs">OPTION: <!--#echo var="VAR_default-composer-hdrs"--></a>
3754 <li><a href="h_config_default_fcc">OPTION: <!--#echo var="VAR_default-fcc"--></a>
3755 <li><a href="h_config_def_save_folder">OPTION: <!--#echo var="VAR_default-saved-msg-folder"--></a>
3756 <li><a href="h_config_disable_auths">OPTION: <!--#echo var="VAR_disable-these-authenticators"--></a>
3757 <li><a href="h_config_disable_drivers">OPTION: <!--#echo var="VAR_disable-these-drivers"--></a>
3758 <li><a href="h_config_char_set">OPTION: Display Character Set</a>
3759 <li><a href="h_config_display_filters">OPTION: <!--#echo var="VAR_display-filters"--></a>
3760 <li><a href="h_config_download_cmd">OPTION: <!--#echo var="VAR_download-command"--></a>
3761 <li><a href="h_config_download_prefix">OPTION: <!--#echo var="VAR_download-command-prefix"--></a>
3762 <li><a href="h_config_editor">OPTION: <!--#echo var="VAR_editor"--></a>
3763 <li><a href="h_config_empty_hdr_msg">OPTION: <!--#echo var="VAR_empty-header-message"--></a>
3764 <li><a href="h_config_fcc_rule">OPTION: <!--#echo var="VAR_fcc-name-rule"--></a>
3765 <li><a href="h_config_file_dir">OPTION: File Directory</a>
3766 <li><a href="h_config_folder_spec">OPTION: <!--#echo var="VAR_folder-collections"--></a>
3767 <li><a href="h_config_reopen_rule">OPTION: <!--#echo var="VAR_folder-reopen-rule"--></a>
3768 <li><a href="h_config_fld_sort_rule">OPTION: <!--#echo var="VAR_folder-sort-rule"--></a>
3769 <li><a href="h_config_font_char_set">OPTION: Font Character Set</a>
3770 <li><a href="h_config_font_name">OPTION: Font Name</a>
3771 <li><a href="h_config_font_size">OPTION: Font Size</a>
3772 <li><a href="h_config_font_style">OPTION: Font Style</a>
3773 <li><a href="h_config_form_folder">OPTION: <!--#echo var="VAR_form-letter-folder"--></a>
3774 <li><a href="h_config_glob_addrbook">OPTION: <!--#echo var="VAR_global-address-book"--></a>
3775 <li><a href="h_config_goto_default">OPTION: <!--#echo var="VAR_goto-default-rule"--></a>
3776 <li><a href="h_config_header_general_color">OPTION: Header General Color</a>
3777 <li><a href="h_config_image_viewer">OPTION: <!--#echo var="VAR_image-viewer"--></a>
3778 <li><a href="h_config_inbox_path">OPTION: <!--#echo var="VAR_inbox-path"--></a>
3779 <li><a href="h_config_archived_folders">OPTION: <!--#echo var="VAR_incoming-archive-folders"--></a>
3780 <li><a href="h_config_psleep">OPTION: <!--#echo var="VAR_mailcap-check-interval"--></a>
3781 <li><a href="h_config_incoming_interv">OPTION: <!--#echo var="VAR_incoming-check-interval"--></a>
3782 <li><a href="h_config_incoming_second_interv">OPTION: <!--#echo var="VAR_incoming-check-interval-secondary"--></a>
3783 <li><a href="h_config_incoming_list">OPTION: <!--#echo var="VAR_incoming-check-list"--></a>
3784 <li><a href="h_config_incoming_timeo">OPTION: <!--#echo var="VAR_incoming-check-timeout"--></a>
3785 <li><a href="h_config_incoming_folders">OPTION: <!--#echo var="VAR_incoming-folders"--></a>
3786 <li><a href="h_config_inc_startup">OPTION: <!--#echo var="VAR_incoming-startup-rule"--></a>
3787 <li><a href="h_config_incunseen_color">OPTION: Incoming Unseen Color</a>
3788 <li><a href="h_config_index_arrow_color">OPTION: Index Arrow Color</a>
3789 <li><a href="h_config_index_color">OPTION: Index Colors</a>
3790 <li><a href="h_config_index_format">OPTION: <!--#echo var="VAR_index-format"--></a>
3791 <li><a href="h_config_index_from_color">OPTION: Index From Color</a>
3792 <li><a href="h_config_index_opening_color">OPTION: Index Opening Color</a>
3793 <li><a href="h_config_index_pri_color">OPTION: Index Priority Symbol Colors</a>
3794 <li><a href="h_config_index_subject_color">OPTION: Index Subject Color</a>
3795 <li><a href="h_config_init_cmd_list">OPTION: <!--#echo var="VAR_initial-keystroke-list"--></a>
3796 <li><a href="h_config_key_char_set">OPTION: Keyboard Character Set</a>
3797 <li><a href="h_config_keylabel_color">OPTION: KeyLabel Color</a>
3798 <li><a href="h_config_keyname_color">OPTION: KeyName Color</a>
3799 <li><a href="h_config_keywords">OPTION: <!--#echo var="VAR_keywords"--></a>
3800 <li><a href="h_config_kw_color">OPTION: Keyword Colors</a>
3801 <li><a href="h_config_kw_braces">OPTION: <!--#echo var="VAR_keyword-surrounding-chars"--></a>
3802 <li><a href="h_config_prune_date">OPTION: <!--#echo var="VAR_last-time-prune-questioned"--></a>
3803 <li><a href="h_config_last_vers">OPTION: <!--#echo var="VAR_last-version-used"--></a>
3804 <li><a href="h_config_literal_sig">OPTION: <!--#echo var="VAR_literal-signature"--></a>
3805 <li><a href="h_config_mailcheck">OPTION: <!--#echo var="VAR_mail-check-interval"--></a>
3806 <li><a href="h_config_mailchecknoncurr">OPTION: <!--#echo var="VAR_mail-check-interval-noncurrent"--></a>
3807 <li><a href="h_config_mailcap_path">OPTION: <!--#echo var="VAR_mailcap-search-path"--></a>
3808 <li><a href="h_config_maildropcheck">OPTION: <!--#echo var="VAR_maildrop-check-minimum"--></a>
3809 <li><a href="h_config_maxremstream">OPTION: <!--#echo var="VAR_max-remote-connections"--></a>
3810 <li><a href="h_config_metamsg_color">OPTION: Meta-Message Color</a>
3811 <li><a href="h_config_mimetype_path">OPTION: <!--#echo var="VAR_mimetype-search-path"--></a>
3812 <li><a href="h_config_new_ver_quell">OPTION: <!--#echo var="VAR_new-version-threshold"--></a>
3813 <li><a href="h_config_fifopath">OPTION: NewMail FIFO Path</a>
3814 <li><a href="h_config_newmailwidth">OPTION: <!--#echo var="VAR_newmail-window-width"--></a>
3815 <li><a href="h_config_news_active">OPTION: <!--#echo var="VAR_news-active-file-path"--></a>
3816 <li><a href="h_config_news_spec">OPTION: <!--#echo var="VAR_news-collections"--></a>
3817 <li><a href="h_config_news_spool">OPTION: <!--#echo var="VAR_news-spool-directory"--></a>
3818 <li><a href="h_config_newsrc_path">OPTION: <!--#echo var="VAR_newsrc-path"--></a>
3819 <li><a href="h_config_nntprange">OPTION: <!--#echo var="VAR_nntp-range"--></a>
3820 <li><a href="h_config_nntp_server">OPTION: <!--#echo var="VAR_nntp-server"--></HEAD></a>
3821 <li><a href="h_config_normal_color">OPTION: Normal Color</a>
3822 <li><a href="h_config_opening_sep">OPTION: <!--#echo var="VAR_opening-text-separator-chars"--></a>
3823 <li><a href="h_config_oper_dir">OPTION: <!--#echo var="VAR_operating-dir"--></a>
3824 <li><a href="h_config_pat_old">OPTION: Patterns</a>
3825 <li><a href="h_config_pat_filts">OPTION: <!--#echo var="VAR_patterns-filters2"--></a>
3826 <li><a href="h_config_pat_other">OPTION: <!--#echo var="VAR_patterns-other"--></a>
3827 <li><a href="h_config_pat_roles">OPTION: <!--#echo var="VAR_patterns-roles"--></a>
3828 <li><a href="h_config_pat_scores">OPTION: <!--#echo var="VAR_patterns-scores2"--></a>
3829 <li><a href="h_config_pers_name">OPTION: <!--#echo var="VAR_personal-name"--></a>
3830 <li><a href="h_config_print_cat">OPTION: <!--#echo var="VAR_personal-print-category"--></a>
3831 <li><a href="h_config_print_command">OPTION: <!--#echo var="VAR_personal-print-command"--></a>
3832 <li><a href="h_config_post_char_set">OPTION: <!--#echo var="VAR_posting-character-set"--></a>
3833 <li><a href="h_config_postponed_folder">OPTION: <!--#echo var="VAR_postponed-folder"--></a>
3834 <li><a href="h_config_print_font_char_set">OPTION: Print-Font-Char-Set</a>
3835 <li><a href="h_config_print_font_name">OPTION: Print-Font-Name</a>
3836 <li><a href="h_config_print_font_size">OPTION: Print-Font-Size</a>
3837 <li><a href="h_config_print_font_style">OPTION: Print-Font-Style</a>
3838 <li><a href="h_config_printer">OPTION: Printer</a>
3839 <li><a href="h_config_prompt_color">OPTION: Prompt Color</a>
3840 <li><a href="h_config_pruned_folders">OPTION: <!--#echo var="VAR_pruned-folders"--></a>
3841 <li><a href="h_config_pruning_rule">OPTION: <!--#echo var="VAR_pruning-rule"--></a>
3842 <li><a href="h_config_quote_color">OPTION: Quote Colors</a>
3843 <li><a href="h_config_quote_replace_string">OPTION: <!--#echo var="VAR_quote-replace-string"--></a>
3844 <li><a href="h_config_quote_suppression">OPTION: <!--#echo var="VAR_quote-suppression-threshold"--></a>
3845 <li><a href="h_config_read_message_folder">OPTION: <!--#echo var="VAR_read-message-folder"--></a>
3846 <li><a href="h_config_remote_abook_history">OPTION: <!--#echo var="VAR_remote-abook-history"--></a>
3847 <li><a href="h_config_abook_metafile">OPTION: <!--#echo var="VAR_remote-abook-metafile"--></a>
3848 <li><a href="h_config_remote_abook_validity">OPTION: <!--#echo var="VAR_remote-abook-validity"--></a>
3849 <li><a href="h_config_reply_indent_string">OPTION: <!--#echo var="VAR_reply-indent-string"--></a>
3850 <li><a href="h_config_reply_intro">OPTION: <!--#echo var="VAR_reply-leadin"--></a>
3851 <li><a href="h_config_reverse_color">OPTION: Reverse Color</a>
3852 <li><a href="h_config_rshcmd">OPTION: <!--#echo var="VAR_rsh-command"--></a>
3853 <li><a href="h_config_rsh_open_timeo">OPTION: <!--#echo var="VAR_rsh-open-timeout"--></a>
3854 <li><a href="h_config_rshpath">OPTION: <!--#echo var="VAR_rsh-path"--></a>
3855 <li><a href="h_config_saved_msg_name_rule">OPTION: <!--#echo var="VAR_saved-msg-name-rule"--></a>
3856 <li><a href="h_config_scroll_margin">OPTION: <!--#echo var="VAR_scroll-margin"--></a>
3857 <li><a href="h_config_slctbl_color">OPTION: Selectable Item Color</a>
3858 <li><a href="h_config_sending_filter">OPTION: <!--#echo var="VAR_sending-filters"--></a>
3859 <li><a href="h_config_sendmail_path">OPTION: <!--#echo var="VAR_sendmail-path"--></a>
3860 <li><a href="h_config_signature_color">OPTION: Signature Color</a>
3861 <li><a href="h_config_signature_file">OPTION: <!--#echo var="VAR_signature-file"--></a>
3862 <li><a href="h_config_smtp_server">OPTION: <!--#echo var="VAR_smtp-server"--></a>
3863 <li><a href="h_config_sort_key">OPTION: <!--#echo var="VAR_sort-key"--></a>
3864 <li><a href="h_config_speller">OPTION: <!--#echo var="VAR_speller"--></a>
3865 <li><a href="h_config_sshcmd">OPTION: <!--#echo var="VAR_ssh-command"--></a>
3866 <li><a href="h_config_ssh_open_timeo">OPTION: <!--#echo var="VAR_ssh-open-timeout"--></a>
3867 <li><a href="h_config_sshpath">OPTION: <!--#echo var="VAR_ssh-path"--></a>
3868 <li><a href="h_config_status_color">OPTION: Status Color</a>
3869 <li><a href="h_config_status_msg_delay">OPTION: <!--#echo var="VAR_status-message-delay"--></a>
3870 <li><a href="h_config_permlocked">OPTION: <!--#echo var="VAR_stay-open-folders"--></a>
3871 <li><a href="h_config_tcp_open_timeo">OPTION: <!--#echo var="VAR_tcp-open-timeout"--></a>
3872 <li><a href="h_config_tcp_query_timeo">OPTION: <!--#echo var="VAR_tcp-query-timeout"--></a>
3873 <li><a href="h_config_tcp_readwarn_timeo">OPTION: <!--#echo var="VAR_tcp-read-warning-timeout"--></a>
3874 <li><a href="h_config_tcp_writewarn_timeo">OPTION: <!--#echo var="VAR_tcp-write-warning-timeout"--></a>
3875 <li><a href="h_config_thread_disp_style">OPTION: <!--#echo var="VAR_threading-display-style"--></a>
3876 <li><a href="h_config_thread_exp_char">OPTION: <!--#echo var="VAR_threading-expanded-character"--></a>
3877 <li><a href="h_config_thread_index_style">OPTION: <!--#echo var="VAR_threading-index-style"--></a>
3878 <li><a href="h_config_thread_indicator_char">OPTION: <!--#echo var="VAR_threading-indicator-character"--></a>
3879 <li><a href="h_config_thread_lastreply_char">OPTION: <!--#echo var="VAR_threading-lastreply-character"--></a>
3880 <li><a href="h_config_title_color">OPTION: Title Color</a>
3881 <li><a href="h_config_titleclosed_color">OPTION: Title Closed Color</a>
3882 <li><a href="h_config_titlebar_color_style">OPTION: <!--#echo var="VAR_titlebar-color-style"--></a>
3883 <li><a href="h_config_unk_char_set">OPTION: <!--#echo var="VAR_unknown-character-set"--></a>
3884 <li><a href="h_config_upload_cmd">OPTION: <!--#echo var="VAR_upload-command"--></a>
3885 <li><a href="h_config_upload_prefix">OPTION: <!--#echo var="VAR_upload-command-prefix"--></a>
3886 <li><a href="h_config_browser">OPTION: <!--#echo var="VAR_url-viewers"--></a>
3887 <li><a href="h_config_domain_name">OPTION: <!--#echo var="VAR_use-only-domain-name"--></a>
3888 <li><a href="h_config_user_dom">OPTION: <!--#echo var="VAR_user-domain"--></a>
3889 <li><a href="h_config_user_id">OPTION: <!--#echo var="VAR_user-id"--></a>
3890 <li><a href="h_config_user_input_timeo">OPTION: <!--#echo var="VAR_user-input-timeout"--></a>
3891 <li><a href="h_config_viewer_headers">OPTION: <!--#echo var="VAR_viewer-hdrs"--></a>
3892 <li><a href="h_config_customhdr_pattern">OPTION: Viewer Header Color Pattern</a>
3893 <li><a href="h_config_customhdr_color">OPTION: <!--#echo var="VAR_viewer-hdr-colors"--></a>
3894 <li><a href="h_config_viewer_margin_left">OPTION: <!--#echo var="VAR_viewer-margin-left"--></a>
3895 <li><a href="h_config_viewer_margin_right">OPTION: <!--#echo var="VAR_viewer-margin-right"--></a>
3896 <li><a href="h_config_viewer_overlap">OPTION: <!--#echo var="VAR_viewer-overlap"--></a>
3897 <li><a href="h_config_window_position">OPTION: Window-Position</a>
3898 <li><a href="h_mainhelp_patterns">Patterns</a>
3899 <li><a href="h_config_role_abookfrom">PATTERNS: Address in Address Book</a>
3900 <li><a href="h_config_role_age">PATTERNS: Age Interval</a>
3901 <li><a href="h_config_role_alltextpat">PATTERNS: AllText Pattern</a>
3902 <li><a href="h_config_role_bom">PATTERNS: Beginning of Month</a>
3903 <li><a href="h_config_role_boy">PATTERNS: Beginning of Year</a>
3904 <li><a href="h_config_role_bodytextpat">PATTERNS: BodyText Pattern</a>
3905 <li><a href="h_config_role_cat_cmd">PATTERNS: Categorizer Command</a>
3906 <li><a href="h_config_role_cat_cmd_example">PATTERNS: Categorizer Command Example</a>
3907 <li><a href="h_config_role_ccpat">PATTERNS: Cc Pattern</a>
3908 <li><a href="h_config_role_cat_limit">PATTERNS: Character Limit</a>
3909 <li><a href="h_config_role_charsetpat">PATTERNS: Character Set Pattern</a>
3910 <li><a href="h_config_role_comment">PATTERNS: Comment</a>
3911 <li><a href="h_config_role_fldr_type">PATTERNS: Current Folder Type</a>
3912 <li><a href="h_config_role_cat_status">PATTERNS: Exit Status Interval</a>
3913 <li><a href="h_config_role_arbpat">PATTERNS: Extra Headers Pattern</a>
3914 <li><a href="h_config_role_frompat">PATTERNS: From Pattern</a>
3915 <li><a href="h_config_role_keywordpat">PATTERNS: Keyword Pattern</a>
3916 <li><a href="h_config_role_stat_ans">PATTERNS: Message Answered Status</a>
3917 <li><a href="h_config_role_stat_del">PATTERNS: Message Deleted Status</a>
3918 <li><a href="h_config_role_stat_imp">PATTERNS: Message Important Status</a>
3919 <li><a href="h_config_role_stat_new">PATTERNS: Message New Status</a>
3920 <li><a href="h_config_role_stat_recent">PATTERNS: Message Recent Status</a>
3921 <li><a href="h_config_role_newspat">PATTERNS: News Pattern</a>
3922 <li><a href="h_config_role_nick">PATTERNS: Nickname</a>
3923 <li><a href="h_config_role_particpat">PATTERNS: Participant Pattern</a>
3924 <li><a href="h_config_role_stat_8bitsubj">PATTERNS: Raw 8-bit in Subject</a>
3925 <li><a href="h_config_role_recippat">PATTERNS: Recipient Pattern</a>
3926 <li><a href="h_config_role_scorei">PATTERNS: Score Interval</a>
3927 <li><a href="h_config_role_senderpat">PATTERNS: Sender Pattern</a>
3928 <li><a href="h_config_role_size">PATTERNS: Size Interval</a>
3929 <li><a href="h_config_role_subjpat">PATTERNS: Subject Pattern</a>
3930 <li><a href="h_config_role_topat">PATTERNS: To Pattern</a>
3931 <li><a href="h_config_filt_opts_nonterm">PATTERNS FEATURE: Dont-Stop-Even-if-Rule-Matches</a>
3932 <li><a href="h_config_filt_opts_notdel">PATTERNS FEATURE: Move-Only-if-Not-Deleted</a>
3933 <li><a href="h_config_filt_opts_sentdate">PATTERNS FEATURE: Use-Date-Header-For-Age</a>
3934 <li><a href="h_config_filt_rule_type">PATTERNS FILTER ACTION: Filter Action</a>
3935 <li><a href="h_config_filter_kw_clr">PATTERNS FILTER ACTION: Clear These Keywords</a>
3936 <li><a href="h_config_filt_stat_ans">PATTERNS FILTER ACTION: Set Answered Status</a>
3937 <li><a href="h_config_filt_stat_del">PATTERNS FILTER ACTION: Set Deleted Status</a>
3938 <li><a href="h_config_filt_stat_imp">PATTERNS FILTER ACTION: Set Important Status</a>
3939 <li><a href="h_config_filt_stat_new">PATTERNS FILTER ACTION: Set New Status</a>
3940 <li><a href="h_config_filter_kw_set">PATTERNS FILTER ACTION: Set These Keywords</a>
3941 <li><a href="h_config_incol">PATTERNS INDEXCOLOR ACTION: Index Line Color</a>
3942 <li><a href="h_config_set_index_format">PATTERNS OTHER ACTION: Set Index Format</a>
3943 <li><a href="h_config_perfolder_sort">PATTERNS OTHER ACTION: Set Sort Order</a>
3944 <li><a href="h_config_other_startup">PATTERNS OTHER ACTION: Set Startup Rule</a>
3945 <li><a href="h_config_role_inick">PATTERNS ROLE ACTION: Initialize Values From Role</a>
3946 <li><a href="h_config_role_setfcc">PATTERNS ROLE ACTION: Set Fcc</a>
3947 <li><a href="h_config_role_setfrom">PATTERNS ROLE ACTION: Set From</a>
3948 <li><a href="h_config_role_setlitsig">PATTERNS ROLE ACTION: Set Literal Signature</a>
3949 <li><a href="h_config_role_setotherhdr">PATTERNS ROLE ACTION: Set Other Headers</a>
3950 <li><a href="h_config_role_setreplyto">PATTERNS ROLE ACTION: Set Reply-To</a>
3951 <li><a href="h_config_role_setsig">PATTERNS ROLE ACTION: Set Signature</a>
3952 <li><a href="h_config_role_settempl">PATTERNS ROLE ACTION: Set Template</a>
3953 <li><a href="h_config_role_usenntp">PATTERNS ROLE ACTION: Use NNTP Server</a>
3954 <li><a href="h_config_role_usesmtp">PATTERNS ROLE ACTION: Use SMTP Server</a>
3955 <li><a href="h_config_role_scoreval">PATTERNS SCORE ACTION: Score Value</a>
3956 <li><a href="h_config_role_scorehdrtok">PATTERNS SCORE ACTION: Score Value From Header</a>
3957 <li><a href="h_config_role_composeuse">PATTERNS USE: Compose Use</a>
3958 <li><a href="h_config_role_forwarduse">PATTERNS USE: Forward Use</a>
3959 <li><a href="h_config_role_replyuse">PATTERNS USE: Reply Use</a>
3960 <li><a href="h_pipe_command">Pipe Command SubOptions</a>
3961 <li><a href="h_common_pipe">Pipe Command</a>
3962 <li><a href="h_valid_folder_names">POP</a>
3963 <li><a href="h_common_postpone">Postpone Command</a>
3964 <li><a href="h_common_print">Print Command</a>
3965 <li><a href="h_mainhelp_readingnews">Reading News</a>
3966 <li><a href="h_news">RELEASE NOTES for Alpine</a>
3967 <li><a href="h_mainhelp_roles">Roles</a>
3968 <li><a href="h_role_select">ROLES SCREEN</a>
3969 <li><a href="h_compose_readfile">Read File Command</a>
3970 <li><a href="h_mainhelp_reading">Reading Messages</a>
3971 <li><a href="h_main_release_notes">Release Notes Command</a>
3972 <li><a href="h_common_reply">Reply and Forward Commands</a>
3973 <li><a href="h_compose_richhdr">Rich Header Command</a>
3974 <li><a href="h_common_role">Role Command</a>
3975 <li><a href="h_mainhelp_smime">S/MIME</a>
3976 <li><a href="h_index_cmd_select">Searching for Messages</a>
3977 <li><a href="h_address_display">SEARCH RESULTS INDEX</a>
3978 <li><a href="h_address_select">SEARCH RESULTS INDEX</a>
3979 <li><a href="h_simple_index">SELECT POSTPONED MESSAGE</a>
3980 <li><a href="h_abook_config">SETUP ADDRESS BOOKS SCREEN</a>
3981 <li><a href="h_collection_maint">SETUP COLLECTION LIST screen</a>
3982 <li><a href="h_color_setup">SETUP COLOR COMMANDS</a>
3983 <li><a href="h_direct_config">SETUP LDAP DIRECTORY SERVERS SCREEN</a>
3984 <li><a href="h_rules_roles">SETUP ROLES SCREEN</a>
3985 <li><a href="h_rules_incols">SETUP INDEX COLORS SCREEN</a>
3986 <li><a href="h_rules_filter">SETUP FILTERING SCREEN</a>
3987 <li><a href="h_rules_score">SETUP SCORING SCREEN</a>
3988 <li><a href="h_common_save">Save and Export Commands</a>
3989 <li><a href="h_mainhelp_securing">Securing Your Alpine Session</a>
3990 <li><a href="h_index_cmd_select">Selecting: Select and WhereIs/Select</a>
3991 <li><a href="h_compose_send">Send Command</a>
3992 <li><a href="h_folder_server_syntax">Server Name Syntax</a>
3993 <li><a href="h_main_setup">Setup Command</a>
3994 <li><a href="X-Alpine-Config:">Show Supported Options in this Alpine</a>
3995 <li><a href="h_composer_sigedit">Signature Editor Commands Explained</a>
3996 <li><a href="h_simple_text_view">Simple Text View Screen Explained</a>
3997 <li><a href="h_mainhelp_smime">S/MIME</a>
3998 <li><a href="h_config_smime_dont_do_smime">S/MIME FEATURE: <!--#echo var="FEAT_smime-dont-do-smime"--></a>
3999 <li><a href="h_config_smime_encrypt_by_default">S/MIME FEATURE: <!--#echo var="FEAT_smime-encrypt-by-default"--></a>
4000 <li><a href="h_config_smime_remember_passphrase">S/MIME FEATURE: <!--#echo var="FEAT_smime-remember-passphrase"--></a>
4001 <li><a href="h_config_smime_sign_by_default">S/MIME FEATURE: <!--#echo var="FEAT_smime-sign-by-default"--></a>
4002 <li><a href="h_config_smime_use_cert_store">S/MIME FEATURE: <!--#echo var="FEAT_smime-use-store-only"--></a>
4003 <li><a href="h_config_smime_pubcerts_in_keychain">S/MIME FEATURE: <!--#echo var="FEAT_publiccerts-in-keychain"--></a>
4004 <li><a href="h_config_smime_cacertcon">S/MIME OPTION: <!--#echo var="VAR_smime-cacert-container"--></a>
4005 <li><a href="h_config_smime_cacertdir">S/MIME OPTION: <!--#echo var="VAR_smime-cacert-directory"--></a>
4006 <li><a href="h_config_smime_privkeycon">S/MIME OPTION: <!--#echo var="VAR_smime-private-key-container"--></a>
4007 <li><a href="h_config_smime_privkeydir">S/MIME OPTION: <!--#echo var="VAR_smime-private-key-directory"--></a>
4008 <li><a href="h_config_smime_pubcertcon">S/MIME OPTION: <!--#echo var="VAR_smime-public-cert-container"--></a>
4009 <li><a href="h_config_smime_pubcertdir">S/MIME OPTION: <!--#echo var="VAR_smime-public-cert-directory"--></a>
4010 <li><a href="h_config_smime_transfer_cacert_to_con">S/MIME: Transfer CA Certs to Container</a>
4011 <li><a href="h_config_smime_transfer_cacert_to_dir">S/MIME: Transfer CA Certs to Directory</a>
4012 <li><a href="h_config_smime_transfer_priv_to_con">S/MIME: Transfer Private Keys to Container</a>
4013 <li><a href="h_config_smime_transfer_priv_to_dir">S/MIME: Transfer Private Keys to Directory</a>
4014 <li><a href="h_config_smime_transfer_pub_to_con">S/MIME: Transfer Public Certs to Container</a>
4015 <li><a href="h_config_smime_transfer_pub_to_dir">S/MIME: Transfer Public Certs to Directory</a>
4016 <li><a href="h_config_smime_public_certificates">S/MIME: Manage Public Certificates</a>
4017 <li><a href="h_config_smime_private_keys">S/MIME: Manage Private Keys</a>
4018 <li><a href="h_config_smime_certificate_authorities">S/MIME: Manage Certificate Authorities</a>
4019 <li><a href="h_index_cmd_sort">Sort Command</a>
4020 <li><a href="h_compose_spell">Spell Check Command</a>
4021 <li><a href="h_common_suspend">Suspend Command</a>
4022 <li><a href="h_compose_addrcomplete">THE MESSAGE COMPOSER'S ADDRESS COMPLETION</a>
4023 <li><a href="h_composer_attachment">THE MESSAGE COMPOSER'S ATTCHMNT FIELD</a>
4024 <li><a href="h_composer_bcc">THE MESSAGE COMPOSER'S BCC FIELD</a>
4025 <li><a href="h_composer_cc">THE MESSAGE COMPOSER'S CC FIELD</a>
4026 <li><a href="h_composer_from">THE MESSAGE COMPOSER'S FROM FIELD</a>
4027 <li><a href="h_composer_lcc">THE MESSAGE COMPOSER'S LCC FIELD</a>
4028 <li><a href="h_composer_news">THE MESSAGE COMPOSER'S NEWSGRPS LINE</a>
4029 <li><a href="h_composer_reply_to">THE MESSAGE COMPOSER'S REPLY-TO FIELD</a>
4030 <li><a href="h_composer_to">THE MESSAGE COMPOSER'S TO FIELD</a>
4031 <li><a href="h_abook_opened">THE ALPINE ADDRESS BOOK</a>
4032 <li><a href="h_abook_select_nicks_take">Take Address Nickname Selection Explained</a>
4033 <li><a href="h_takeaddr_screen">Take Address Screen Explained</a>
4034 <li><a href="h_common_take">TakeAddr Command</a>
4035 <li><a href="h_mainhelp_status">Titlebar Line</a>
4036 <li><a href="h_index_tokens">Tokens for Index and Replying</a>
4037 <li><a href="h_config_usenone_color">Use None Color</a>
4038 <li><a href="h_config_usenormal_color">Use Normal Color</a>
4039 <li><a href="h_config_usetransparent_color">Use Transparent Color</a>
4040 <li><a href="h_whatis_vcard">VCARD EXPLAINED</a>
4041 <li><a href="h_view_cmd_hilite">View Hilite and Next item/Previous item</a>
4042 <li><a href="h_view_cmd_viewattch">ViewAttch Command</a>
4043 <li><a href="h_index_cmd_whereis">WhereIs Command</a>
4044 <li><a href="h_view_cmd_whereis">WhereIs Command</a>
4045 <li><a href="h_index_cmd_zoom">ZoomMode Command</a>
4046 <li><a href="h_config_browser_xterm"><!--#echo var="VAR_url-viewers"--> and X windows applications</a>
4047 </UL>
4048
4049 <P>
4050 &lt;End of Help Index&gt;
4051 </BODY>
4052 </HTML>
4053
4054
4055 ============== h_config_remote_config =============
4056 <HTML>
4057 <HEAD>
4058 <TITLE>Remote Configuration</TITLE>
4059 </HEAD>
4060 <BODY>
4061 <H1>Remote Configuration</H1>
4062
4063 You may use the command line argument &quot;-p pinerc&quot; to tell
4064 Alpine to use a non-default configuration file.
4065 There are two types of storage for configuration information.
4066 <EM>Local</EM> configuration files are used by default.
4067 These are just regular files on the UNIX system or on the PC.
4068 The file &quot;<CODE>.pinerc</CODE>&quot; is the default for Unix Alpine and the
4069 file &quot;<CODE>PINERC</CODE>&quot; is the default for PC-Alpine.
4070 <EM>Remote</EM> configuration folders are stored on an IMAP server.
4071 The advantage of using a remote configuration is that the same information
4072 may be accessed from multiple platforms.
4073 For example, if you use one computer at work and another at home, the same
4074 configuration could be used from both places.
4075 A configuration change from one place would be seen in both places.
4076 To use a remote configuration you simply give a
4077 <A HREF="h_valid_folder_names">remote folder name</A>
4078 as the argument to the &quot;-p&quot; command line option.
4079 The command line might look something like:
4080 <P>
4081 <CENTER><SAMP>pine -p {my.imap.server}remote_pinerc</SAMP></CENTER>
4082 <P>
4083 If there are special characters in the command shell you use, you may need to
4084 quote the last argument (to protect the curly braces from the shell).
4085 The command might look like:
4086 <P>
4087 <CENTER><SAMP>pine -p &quot;{my.imap.server}remote_pinerc&quot;</SAMP></CENTER>
4088 <P>
4089 You should choose a folder name for a folder that does not yet exist.
4090 It will be created containing an empty configuration.
4091 Do not use a folder that you wish to store regular mail messages in.
4092 <P>
4093 The Setup/RemoteConfigSetup command will help you convert from a local
4094 configuration to a remote configuration.
4095 It will create a remote configuration for you and copy your current local
4096 configuration to it.
4097 It will also help you convert local address books into remote address books
4098 and local signature files into literal signatures contained in the
4099 remote configuration file.
4100 <P>
4101 If the Setup/RemoteConfigSetup command doesn't do what you want, you
4102 may copy a local pinerc file to a remote configuration folder by hand
4103 by using the command line option &quot;-copy_pinerc&quot;.
4104 <P>
4105 Another command line option, which is somewhat related to remote
4106 configuration, is the option &quot;-x exceptions_config&quot;.
4107 The configuration settings in the exceptions configuration override
4108 your default settings.
4109 It may be useful to store the default configuration (the -p argument) remotely
4110 and to have the exceptions configuration stored in a local file.
4111 You might put generic configuration information in the remote configuration
4112 and platform-specific configuration on each platform in the exceptions
4113 configuration.
4114 The arguments to the &quot;-p&quot; and &quot;-x&quot; options
4115 can be either remote folders or local files.
4116 <P>
4117 There is another command line argument that works only with PC-Alpine and
4118 which may prove useful when using a remote configuration.
4119 The option &quot;-aux local_directory&quot; allows you to tell PC-Alpine where
4120 to store your local auxiliary files.
4121 This only has an effect if your configuration file is remote.
4122 Some examples of auxiliary files are debug files, address book files, and
4123 signature files.
4124 <P>
4125 &lt;End of help on this topic&gt;
4126 </BODY>
4127 </HTML>
4128 ============== h_config_exceptions =============
4129 <HTML>
4130 <HEAD>
4131 <TITLE>Generic and Exceptional Configuration</TITLE>
4132 </HEAD>
4133 <BODY>
4134 <H1>Generic and Exceptional Configuration</H1>
4135
4136 If you use Alpine from more than one platform it may be convenient
4137 to split your configuration information into two pieces, a generic piece
4138 and exceptions that apply to a particular platform.
4139 For example, suppose you use Alpine from home and from work.
4140 Most of your configuration settings are probably the
4141 same in both locations, so those settings belong in the generic settings
4142 configuration.
4143 However, you may use a different SMTP server and INBOX
4144 from home than you do from work.
4145 The
4146 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>
4147 and
4148 <A HREF="h_config_inbox_path">&quot;<!--#echo var="VAR_inbox-path"-->&quot;</A>
4149 options could be
4150 part of your exceptional configuration so that they could be different in the
4151 two places.
4152 <P>
4153 The command line option &quot;-x exceptions_config&quot;
4154 may be used to split your configuration into generic and exceptional pieces.
4155 &quot;Exceptions_config&quot; may be either local or remote.
4156 The regular Alpine configuration file will contain the generic data, and
4157 &quot;exceptions_config&quot; will contain the exceptional data.
4158 <P>
4159 For Unix Alpine, if you don't have a &quot;-x&quot; command line option,
4160 Alpine will look for the file &quot;<CODE>.pinercex</CODE>&quot;
4161 in the same local directory that the regular config file is located in (usually
4162 the Unix home directory).
4163 If the regular config file is remote (because the command line option
4164 &quot;-p remote_config&quot; was used) then Unix Alpine looks in the Unix home
4165 directory for &quot;<CODE>.pinercex</CODE>&quot;.
4166 If the file does not already exist then no exceptions will be used.
4167 You can force exceptions to be used by using the &quot;-x&quot; option or
4168 by creating an empty &quot;<CODE>.pinercex</CODE>&quot; file.
4169 <P>
4170 For PC-Alpine, if you don't have a &quot;-x&quot; command line option,
4171 PC-Alpine will use the value of the
4172 environment variable <CODE>$PINERCEX</CODE>.
4173 If that is not set, PC-Alpine will look for
4174 the local file &quot;<CODE>PINERCEX</CODE>&quot;
4175 in the same local directory that the regular config file is located in.
4176 If the regular config file is remote (because the command line option
4177 &quot;-p remote_config&quot; was used) then PC-Alpine looks in the
4178 local directory specified by the &quot;-aux local_directory&quot; command
4179 line argument, or the directory <CODE>$HOME&#92;PINE</CODE>, or
4180 in the <CODE>&lt;PINE.EXE </CODE>directory<CODE>&gt;</CODE>.
4181 <P>
4182 When you have an exception configuration there is a new command
4183 in the Alpine Setup screen, Setup/eXceptions.
4184 It toggles between exceptions and the regular configuration.
4185 This is the usual way to make changes in your exceptional configuration data.
4186 For example, you would type &quot;S&quot; for Setup, &quot;X&quot; for
4187 eXception, then follow that with one of the Setup commands, like &quot;C&quot;
4188 for Config or &quot;K&quot; for Kolor.
4189 <P>
4190 For most people, splitting the configuration information into two pieces is
4191 going to be most useful if the generic information is accessed
4192 <A HREF="h_config_remote_config">remotely</A>).
4193 That data will be the same no matter where you access it from and if you
4194 change it that change will show up everywhere.
4195 The exceptional data will most commonly be in a local file, so that the
4196 contents may easily be different on each computing platform used.
4197 <P>
4198 If you already have a local configuration file with settings you like
4199 you may find that the command Setup/RemoteConfigSetup is useful
4200 in helping you convert to a remote configuration.
4201 The command line flag &quot;-copy_pinerc&quot;
4202 may also be useful.
4203 <P>
4204 &lt;End of help on this topic&gt;
4205 </BODY>
4206 </HTML>
4207 ============== h_config_inheritance =============
4208 <HTML>
4209 <HEAD>
4210 <TITLE>Configuration Inheritance</TITLE>
4211 </HEAD>
4212 <BODY>
4213 <H1>Configuration Inheritance</H1>
4214
4215 Configuration inheritance is a power user feature.
4216 It is confusing and not completely supported by the configuration
4217 user interface.
4218 We start with an explanation of how configuration works in hopes of making
4219 it easier to describe how inheritance works.
4220 <P>
4221 Alpine uses a hierarchy of configuration values from different locations.
4222 There are five ways in which each configuration option (configuration
4223 variable) can be set.
4224 In increasing order of precedence they are:
4225 <P>
4226 <OL>
4227 <LI> the system-wide configuration file.
4228
4229 <LI> the personal configuration file
4230
4231 <LI> the personal exceptions file
4232
4233 <LI> a command line argument
4234
4235 <LI> the system-wide <EM>fixed</EM> configuration file (Unix Alpine only)
4236 </OL>
4237 <P>
4238 The fixed configuration file is normally
4239 <CODE><!--#echo var="PINE_CONF_FIXED_PATH"--></CODE>.
4240 <P>
4241 The system-wide configuration file is normally
4242 <CODE><!--#echo var="PINE_CONF_PATH"--></CODE> for Unix Alpine and is normally not
4243 set for PC-Alpine.
4244 For PC-Alpine, if the environment variable <EM>$PINECONF</EM> is set, that
4245 is used for the system-wide configuration.
4246 This location can be set or changed on the command line with the -P flag.
4247 The system-wide configuration file can be either a local file or a
4248 remote configuration folder.
4249 <P>
4250 For Unix Alpine, the personal configuration file is normally the file
4251 <CODE>.pinerc</CODE> in the user's home directory.
4252 This can be changed with the -p command line flag.
4253 For PC-Alpine, the personal configuration file is in
4254 <CODE>$PINERC</CODE> or <CODE>&lt;AlpineRC registry value&gt;</CODE> or
4255 <CODE>$HOME&#92;PINE&#92;PINERC</CODE> or
4256 <CODE>&lt;PINE.EXE </CODE>dir<CODE>&gt;&#92;PINERC</CODE>.
4257 This can be changed with the -p command line flag.
4258 If -p is used, the configuration data may be in a local file or a remote config
4259 folder.
4260 <P>
4261 For Unix Alpine, the personal exceptions configuration file is named
4262 <CODE>.pinercex</CODE> and is in the same directory as the personal
4263 configuration file, if that configuration file is not remote, and is in
4264 the home directory if the personal configuration file is remote.
4265 If the file exists, then exceptions are turned on.
4266 If it doesn't, then you are not using exceptions.
4267 Alternatively, you may change the location of the exceptions configuration
4268 by using the command line argument &quot;-x &lt;exceptions_config&gt;&quot;.
4269 Like the personal configuration data, exceptions_config may be
4270 either local or remote.
4271 <P>
4272 For PC-Alpine, the personal exceptions configuration file is named
4273 <CODE>PINERCEX</CODE> and is in the same directory as the personal
4274 configuration file unless the personal configuration file is remote.
4275 In that case, it is in the local directory specfied by the
4276 &quot;-aux local_directory&quot; command line argument.
4277 (In the case that the personal configuration is remote and there is no
4278 &quot;-aux&quot; command line argument, Alpine searches for
4279 a PINERCEX file in the directory <CODE>$HOME&#92;PINE</CODE> and
4280 the directory <CODE>&lt;PINE.EXE </CODE>dir<CODE>&gt;</CODE>.)
4281 If the file exists, then exceptions are turned on.
4282 If it doesn't, then you are not using exceptions.
4283 You may change the location of the exceptions configuration
4284 by using the command line argument &quot;-x &lt;exceptions_config&gt;&quot;.
4285 or with the
4286 environment variable <CODE>$PINERCEX</CODE> (if there is no &quot;-x&quot;
4287 option).
4288 <P>
4289 To reiterate, the value of a configuration option is taken from the
4290 last location in the list above in which it is set.
4291 Or, thinking about it slightly differently, a default value for an option
4292 is established in the system-wide configuration file (or internally by Alpine
4293 if there is no value in the system-wide file).
4294 That default remains in effect until and unless it is overridden by a value in a
4295 location further down the list, in which case a new &quot;default&quot;
4296 value is established.
4297 As we continue down the list of locations we either retain the
4298 value at each step or establish a new value.
4299 The value that is still set after going through the whole list of
4300 configuration locations is the one that is used.
4301 <P>
4302 So, for example, if an option is set in the system-wide configuration
4303 file and in the personal configuration file, but is not set in the
4304 exceptions, on the command line, or in the fixed file; then the value
4305 from the personal configuration file is the one that is used.
4306 Or, if it is set in the system-wide config, in the personal config, not
4307 in the exceptions, but is set on the command line; then the value
4308 on the command line is used.
4309 <P>
4310 Finally we get to inheritance.
4311 For configuration options that are lists, like &quot;<!--#echo var="VAR_smtp-server"-->&quot; or
4312 &quot;<!--#echo var="VAR_incoming-folders"-->&quot;,
4313 the inheritance mechanism makes it possible to <EM>combine</EM>
4314 the values from different locations instead of <EM>replacing</EM> the value.
4315 This is true of all configuration lists other than the &quot;Feature-List&quot;,
4316 for which you may already set whatever you want at
4317 any configuration location (by using the &quot;no-&quot; prefix if
4318 necessary).
4319 <P>
4320 To use inheritance, set the first item in a configuration list to the
4321 token &quot;INHERIT&quot;, without the quotes.
4322 If the first item is &quot;INHERIT&quot;,
4323 then instead of replacing the default value established so far, the rest of
4324 the list is appended to the default value established so far and that is
4325 the new value.
4326 <P>
4327 Here is an example which may make it clearer. Suppose we have:
4328 <P>
4329 <PRE>
4330  System-wide config :   smtp-server = smtp1.corp.com, smtp2.corp.com
4331  Personal config    :   smtp-server = INHERIT, mysmtp.home
4332  Exceptions config  :   smtp-server = &lt;No Value Set&gt;
4333  Command line       :   smtp-server = &lt;No Value Set&gt;
4334  Fixed config       :   smtp-server = &lt;No Value Set&gt;
4335 </PRE>
4336 <P>
4337
4338 This would result in an effective smtp-server option of
4339 <P>
4340 <PRE>
4341  smtp-server = smtp1.corp.com, smtp2.corp.com, mysmtp.home
4342 </PRE>
4343 <P>
4344 The &quot;INHERIT&quot; token can be used in any of the configuration files
4345 and the effect cascades.
4346 For example, if we change the above example to:
4347 <P>
4348 <PRE>
4349  System-wide config :   smtp-server = smtp1.corp.com, smtp2.corp.com
4350  Personal config    :   smtp-server = INHERIT, mysmtp.home
4351  Exceptions config  :   smtp-server = INHERIT, yoursmtp.org
4352  Command line       :   smtp-server = &lt;No Value Set&gt;
4353  Fixed config       :   smtp-server = &lt;No Value Set&gt;
4354 </PRE>
4355 <P>
4356
4357 This would result in:
4358 <P>
4359 <PRE>
4360  smtp-server = smtp1.corp.com, smtp2.corp.com, mysmtp.home, yoursmtp.org
4361 </PRE>
4362 <P>
4363 Unset variables are skipped over (the default value is carried forward) so
4364 that, for example:
4365 <P>
4366 <PRE>
4367  System-wide config :   smtp-server = smtp1.corp.com, smtp2.corp.com
4368  Personal config    :   smtp-server = &lt;No Value Set&gt;
4369  Exceptions config  :   smtp-server = INHERIT, yoursmtp.org
4370  Command line       :   smtp-server = &lt;No Value Set&gt;
4371  Fixed config       :   smtp-server = &lt;No Value Set&gt;
4372 </PRE>
4373 <P>
4374
4375 produces:
4376 <P>
4377 <PRE>
4378  smtp-server = smtp1.corp.com, smtp2.corp.com, yoursmtp.org
4379 </PRE>
4380 <P>
4381
4382 If any later configuration location has a value set (for a particular list
4383 option) which does <EM>not</EM> begin with &quot;INHERIT&quot;,
4384 then that value replaces whatever value has been defined up to that point.
4385 In other words, that cancels out any previous inheritance.
4386 <P>
4387 <PRE>
4388  System-wide config :   smtp-server = smtp1.corp.com, smtp2.corp.com
4389  Personal config    :   smtp-server = INHERIT, mysmtp.org
4390  Exceptions config  :   smtp-server = yoursmtp.org
4391  Command line       :   smtp-server = &lt;No Value Set&gt;
4392  Fixed config       :   smtp-server = &lt;No Value Set&gt;
4393 </PRE>
4394 <P>
4395
4396 results in:
4397 <P>
4398 <PRE>
4399  smtp-server = yoursmtp.org
4400 </PRE>
4401 <P>
4402
4403 For some configuration options, like &quot;<!--#echo var="VAR_viewer-hdr-colors"-->&quot; or
4404 &quot;<!--#echo var="VAR_patterns-roles"-->&quot;, it is
4405 difficult to insert the value &quot;INHERIT&quot; into the list of values
4406 for the option using the normal Setup tools.
4407 In other words, the color setting screen (for example) does not
4408 provide a way to input the text &quot;INHERIT&quot; as the first
4409 item in the <!--#echo var="VAR_viewer-hdr-colors"--> option.
4410 The way to do this is to either edit the pinerc file directly and manually
4411 insert it, or turn
4412 on the <A HREF="h_config_expose_hidden_config"><!--#echo var="FEAT_expose-hidden-config"--></A>
4413 feature and insert it using the Setup/Config screen.
4414 <P>
4415 &lt;End of help on this topic&gt;
4416 </BODY>
4417 </HTML>
4418 ============== h_special_xon_xoff =============
4419 <HTML>
4420 <HEAD>
4421 <TITLE>Explanation of Alpine's XOFF/XON Handling</TITLE>
4422 </HEAD>
4423 <BODY>
4424 <H1>XOFF/XON Handling within Alpine</H1>
4425
4426 By default, Alpine treats Ctrl-S or Ctrl-Q (sometimes known as XOFF
4427 and XON) as normal characters, even though Alpine does not use them.
4428 However, the printer, modem, or communication software you are using may
4429 be configured for &quot;software flow control,&quot; which means that
4430 XON/XOFF must be treated as special characters by the operating system.
4431 If you see messages such as &quot;^S not defined for this screen&quot;,
4432 then your system is probably using software flow control. In this case
4433 you will need to set the
4434 <A HREF="h_config_preserve_start_stop">&quot;<!--#echo var="FEAT_preserve-start-stop-characters"-->&quot;</A>
4435 feature.
4436 <P>
4437 If you <EM>do</EM> set this
4438 feature, be advised that if you accidentally hit a Ctrl-S, Alpine will
4439 mysteriously freeze up with no warning.  In this case, try typing a Ctrl-Q
4440 and see if that puts things right.  Printing via the
4441 &quot;attached-to-ansi&quot; or
4442 &quot;attached-to-wyse&quot;
4443 option will automatically enable software
4444 flow-control handling for the duration of the printing.
4445 <P>
4446 &lt;End of help on this topic&gt;
4447 </BODY>
4448 </HTML>
4449 ============= h_special_help_nav =============
4450 <HTML>
4451 <HEAD>
4452 <TITLE>Help Text Navigation Explained</TITLE>
4453 </HEAD>
4454 <BODY>
4455 <H1>Help Text Navigation Explained</H1>
4456
4457 Alpine contains extensive context-sensitive help text.   At any point,
4458 pressing the &quot;?&quot; key will bring up a page of help text
4459 explaining the options available to you.  You can leave the help
4460 text screen and return to normal Alpine operation by pressing
4461 the
4462 <!--chtml if pinemode="function_key"-->
4463 F3 function
4464 <!--chtml else-->
4465 &quot;E&quot;
4466 <!--chtml endif-->
4467 key to Exit Help at any time.
4468
4469 <P>
4470 Within the help screen you might find a word or phrase displayed in
4471 inverse text and others displayed in bold typeface.  Such words and
4472 phrases are used to tell you Alpine has more information available on
4473 the topic they describe.
4474 The inverted text is the &quot;selected&quot; topic.
4475 Use the arrow keys, Ctrl-F, and Ctrl-B to change which of the phrases
4476 displayed in bold type
4477 is &quot;selected&quot;.
4478 Hit the Return key to display the information Alpine has available on that
4479 topic.  While viewing such additional information, the
4480 <!--chtml if pinemode="function_key"-->
4481 F3 function
4482 <!--chtml else-->
4483 &quot;P&quot;
4484 <!--chtml endif-->
4485 key will return you to the previous help screen, and the
4486 <!--chtml if pinemode="function_key"-->
4487 F2 function
4488 <!--chtml else-->
4489 &quot;E&quot;
4490 <!--chtml endif-->
4491 key will Exit the Help system altogether.
4492
4493 <P>
4494 The "N" command will tell you the internal name of the help text you are
4495 reading each time, so that you can send this name in the text of a message
4496 and create a direct link to that internal help using the x-pine-help URL
4497 scheme. For example, the direct link to this item is
4498 x-pine-help:h_special_help_nav. If you add this text to a message, then
4499 a person using Pine to read such message would have a direct link to this
4500 help text.
4501
4502 <P>
4503 When you are finished reading this help text, you can press the
4504 <!--chtml if pinemode="function_key"-->
4505 F3 function
4506 <!--chtml else-->
4507 &quot;P&quot;
4508 <!--chtml endif-->
4509 key to return to the previously displayed help text.
4510
4511 <P>
4512 &lt;End of help on this topic&gt;
4513 </BODY>
4514 </HTML>
4515 ============= h_special_list_commands =============
4516 <HTML>
4517 <HEAD>
4518 <TITLE>Email List Commands Explained</TITLE>
4519 </HEAD>
4520 <BODY>
4521 <H1>Email List Commands Explained</H1>
4522
4523 Electonic mail lists provide a way for like-minded users to join in
4524 discussions on topics of interest.  The email list itself is
4525 represented by a
4526 single address that participants send messages to when they have
4527 something of interest to share with other members of the list.  The
4528 receiving computer then, either automatically or after review by the
4529 list's owner (or moderator), sends a copy of that message to each
4530 member of the list.
4531
4532 <P>
4533 Usually, subscribing and unsubscribing is done by sending requests in
4534 an email message to a special address setup to handle managing list
4535 membership.  Often this is the name of the list followed by
4536 <I>-request</I>.  This address is almost <EM>never</EM> the same as
4537 the address used to send messages to the list.
4538
4539 <P>
4540 Unfortunately, email list participation commands are more a matter
4541 of convention than standard, and thus may vary from list to list.
4542 Increasingly, list management software is adding information to
4543 the copy of the postings as they're copied to the list members that
4544 explains how to do the various list management functions.
4545
4546 <P>
4547 Alpine will recognize this information and offer the management commands
4548 they represent in a simple display. One or more of the following
4549 operations will be made available:
4550
4551 <DL>
4552 <DT>Help</DT>
4553 <DD>
4554 A method to get help on subscribing, unsubscribing,
4555 an explanation of what the list is about, or special instructions
4556 for participation.  This may be in the form of a reply in response
4557 to an email message, or instructions on how to connect to a Web site.
4558 </DD>
4559
4560 <DT>Unsubscribe</DT>
4561 <DD>
4562 A method to get your email addressed removed from the list of
4563 recipients of the email list.
4564 </DD>
4565
4566 <DT>Subscribe</DT>
4567 <DD>
4568 A method to get your email address added to the list of recipients
4569 of the email list.  It may be in the form of a message sent to
4570 a special address or you may be connected to a web site.
4571 <DD>
4572 </DD>
4573
4574 <DT>Post</DT>
4575 <DD>
4576 A method used to post to the email list.  However, it might also
4577 indicate that no posting is allowed directly to the list.
4578 </DD>
4579
4580 <DT>Owner</DT>
4581 <DD>
4582 A method to contact the list owner for special questions you might
4583 have regarding the list.
4584 </DD>
4585
4586 <DT>Archive</DT>
4587 <DD>
4588 A method to view an archive of previous messages posted to the list.
4589 This may be in the form of a mail folder on a remote computer, an
4590 IMAP mailbox or even a Web site.
4591 </DD>
4592 </DL>
4593
4594 <P>
4595 &lt;End of help on this topic&gt;
4596 </BODY>
4597 </HTML>
4598 ============= h_quota_command =============
4599 <HTML>
4600 <HEAD>
4601 <TITLE>Quota Screen Explained</TITLE>
4602 </HEAD>
4603 <BODY>
4604 <H1>Quota Screen Explained</H1>
4605
4606 <P> This screen summarizes the quota report for this mailbox in the
4607 IMAP server. For each resource that you have a quota, this reports summarizes
4608 its use and limit.
4609
4610 <P> Your IMAP server administrator may have set a quota based either on
4611 the total size of your mailbox (STORAGE), or the number of messages in
4612 your mailbox (MESSAGES), or some other criteria. This will be reported
4613 to you indicating the type of quota, its total use and its limit.
4614
4615 <P> The report for STORAGE is reported in kibibytes (KiB). One kibibyte is
4616 1024 bytes. Each of the characters that you see in this help text is one
4617 byte, and this help text is about 1 kibibyte in size. Small messages sent
4618 by Alpine are normally less than 4 kibibytes in size (which includes
4619 headers and text). Other email programs may send messages with bigger
4620 sizes when they send messages, since they send plain text and an
4621 alternative part in HTML.
4622
4623 <P> A convenient way to save space for the STORAGE type of quota is by
4624 deleting attachments. This is done on each individual message by pressing
4625 the &quot;V&quot; command while reading the message text, then moving the cursor
4626 to the position of the attachment that is to be deleted, then pressing
4627 &quot;D&quot; to delete such attachment, going back to reading the
4628 message with the &quot;&lt;&quot; command and pressing &quot;S&quot; to
4629 save the message in the same folder you are reading from. The saved
4630 message will not have the attachment that was marked deleted. Now you
4631 can delete and expunge the message with the unwanted attachment.
4632
4633 <P>
4634 &lt;End of help on this topic&gt;
4635 </BODY>
4636 </HTML>
4637 ============= h_mail_thread_index =============
4638 <HTML>
4639 <HEAD>
4640 <TITLE>THREAD INDEX COMMANDS</TITLE>
4641 </HEAD>
4642 <BODY>
4643 <H1>THREAD INDEX COMMANDS</H1>
4644 <!--chtml if pinemode="function_key"-->
4645 Available&nbsp;&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;1&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;2<BR>
4646 -------------------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;-----------------------------<BR>
4647 F1&nbsp;&nbsp;Show&nbsp;Help&nbsp;Text&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F1&nbsp;&nbsp;Show&nbsp;Help&nbsp;Text<BR>
4648 F2&nbsp;&nbsp;Toggle&nbsp;to&nbsp;see&nbsp;more&nbsp;commands&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F2&nbsp;&nbsp;Toggle&nbsp;to&nbsp;see&nbsp;more&nbsp;commands<BR>
4649 F3&nbsp;&nbsp;<A HREF="h_common_folders">FOLDER&nbsp;LIST</A>&nbsp;Screen&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F3&nbsp;&nbsp;MAIN&nbsp;MENU&nbsp;Screen<BR>
4650 F4&nbsp;&nbsp;View&nbsp;current&nbsp;thread&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F4&nbsp;&nbsp;Quit&nbsp;Alpine<BR>
4651 F5&nbsp;&nbsp;Move&nbsp;to&nbsp;previous&nbsp;thread&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F5&nbsp;&nbsp;<A HREF="h_common_compose">Compose</A>&nbsp;a&nbsp;message<BR>
4652 F6&nbsp;&nbsp;Move&nbsp;to&nbsp;next&nbsp;thread&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F6&nbsp;&nbsp;<A HREF="h_common_goto">Goto</A>&nbsp;a&nbsp;specified&nbsp;folder<BR>
4653 F7&nbsp;&nbsp;Show&nbsp;previous&nbsp;screen&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F7&nbsp;&nbsp;<A HREF="h_common_nextnew">Next&nbsp;new</A>&nbsp;thread<BR>
4654 F8&nbsp;&nbsp;Show&nbsp;next&nbsp;screen&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F8&nbsp;&nbsp;<A HREF="h_index_cmd_whereis">Whereis</A><BR>
4655 F9&nbsp;&nbsp;<A HREF="h_common_delete">Mark&nbsp;thread&nbsp;for&nbsp;deletion</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F9&nbsp;&nbsp;<A HREF="h_common_print">Print</A>&nbsp;index<BR>
4656 F10&nbsp;<A HREF="h_common_delete">Undelete</A>&nbsp;(remove&nbsp;delete&nbsp;mark)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F10&nbsp;<A HREF="h_common_take">Take&nbsp;Address</A>&nbsp;into&nbsp;address&nbsp;book<BR>
4657 F11&nbsp;<A HREF="h_common_reply">Reply</A>&nbsp;to&nbsp;thread&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F11&nbsp;<A HREF="h_common_save">Save</A>&nbsp;messages&nbsp;into&nbsp;an&nbsp;email&nbsp;folder<BR>
4658 F12&nbsp;<A HREF="h_common_reply">Forward</A>&nbsp;messages&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F12&nbsp;<A HREF="h_common_save">Export</A>&nbsp;messages&nbsp;into&nbsp;a&nbsp;plain&nbsp;file<BR>
4659 <BR>
4660 Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;3<BR>
4661 -----------------------------<BR>
4662 F3&nbsp;&nbsp;<A HREF="h_index_cmd_expunge">Expunge</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F7&nbsp;<A HREF="h_index_cmd_sort">Sort</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F10&nbsp;<A HREF="h_common_bounce">Bounce</A>&nbsp;(remail)&nbsp;msg<BR>
4663 F5&nbsp;&nbsp;<A HREF="h_index_cmd_select">Select</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F8&nbsp;<A HREF="h_common_jump">Jump</A>&nbsp;to&nbsp;thread&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F11&nbsp;<A HREF="h_common_flag">Flag</A>&nbsp;messages&nbsp;as&nbsp;important<BR>
4664 F6&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F9&nbsp;<A HREF="h_common_hdrmode">Full&nbsp;Header&nbsp;Mode</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F12&nbsp;<A HREF="h_common_pipe">Pipe</A>&nbsp;to&nbsp;a&nbsp;Unix&nbsp;command<BR>
4665 <BR>
4666 Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;4<BR>
4667 -----------------------------<BR>
4668 F3&nbsp;&nbsp;Select&nbsp;Current&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F4&nbsp;&nbsp;<A HREF="h_index_cmd_zoom">Zoom</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F5&nbsp;&nbsp;COLLECTION&nbsp;LIST&nbsp;Screen
4669 F6&nbsp;&nbsp;<A HREF="h_common_role">Compose&nbsp;using&nbsp;a&nbsp;role</A><BR>
4670 <BR>
4671 <!--chtml else-->
4672 Navigating&nbsp;the&nbsp;List&nbsp;of&nbsp;Threads&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Operations&nbsp;on&nbsp;the&nbsp;Current&nbsp;Thread<BR>
4673 -------------------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;---------------------------------<BR>
4674 &nbsp;P&nbsp;&nbsp;&nbsp;Move&nbsp;to&nbsp;the&nbsp;previous&nbsp;thread&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&gt;&nbsp;&nbsp;View&nbsp;Thread&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;%&nbsp;&nbsp;<A HREF="h_common_print">Print</A><BR>
4675 &nbsp;N&nbsp;&nbsp;&nbsp;Move&nbsp;to&nbsp;the&nbsp;next&nbsp;thread&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;R&nbsp;&nbsp;<A HREF="h_common_reply">Reply</A>&nbsp;to&nbsp;thread&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F&nbsp;&nbsp;<A HREF="h_common_reply">Forward</A><BR>
4676 &nbsp;-&nbsp;&nbsp;&nbsp;Show&nbsp;previous&nbsp;screen&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;D&nbsp;&nbsp;<A HREF="h_common_delete">Mark&nbsp;thread&nbsp;for&nbsp;deletion</A><BR>
4677 Spc&nbsp;&nbsp;(space&nbsp;bar)&nbsp;Show&nbsp;next&nbsp;screen&nbsp;&nbsp;&nbsp;&nbsp;U&nbsp;&nbsp;<A HREF="h_common_delete">Undelete</A>&nbsp;(remove&nbsp;deletion&nbsp;mark)<BR>
4678 &nbsp;J&nbsp;&nbsp;&nbsp;<A HREF="h_common_jump">Jump</A>&nbsp;to&nbsp;a&nbsp;specific&nbsp;thread&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;T&nbsp;&nbsp;<A HREF="h_common_take">Take&nbsp;Address</A>&nbsp;into&nbsp;Address&nbsp;Book<BR>
4679 &nbsp;W&nbsp;&nbsp;&nbsp;<A HREF="h_index_cmd_whereis">Whereis</A>&nbsp;--&nbsp;search&nbsp;for&nbsp;a&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;S&nbsp;&nbsp;<A HREF="h_common_save">Save</A>&nbsp;into&nbsp;an&nbsp;email&nbsp;folder<BR>
4680 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;specific&nbsp;thread&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;E&nbsp;&nbsp;<A HREF="h_common_save">Export</A>&nbsp;as&nbsp;a&nbsp;plain&nbsp;text&nbsp;file<BR>
4681 Tab&nbsp;&nbsp;<A HREF="h_common_nextnew">Next&nbsp;new</A>&nbsp;thread&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;B&nbsp;&nbsp;<A HREF="h_common_bounce">Bounce</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*&nbsp;&nbsp;<A HREF="h_common_flag">Flag</A><BR>
4682 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;<A HREF="h_common_pipe">Pipe</A>&nbsp;to&nbsp;a&nbsp;Unix&nbsp;Command<BR>
4683 <BR>
4684 Miscellaneous&nbsp;Operations&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;General&nbsp;Alpine&nbsp;Commands<BR>
4685 ------------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;---------------------<BR>
4686 &nbsp;G&nbsp;&nbsp;&nbsp;<A HREF="h_common_goto">Goto</A>&nbsp;a&nbsp;specified&nbsp;folder&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;O&nbsp;&nbsp;Show&nbsp;all&nbsp;other&nbsp;available&nbsp;commands<BR>
4687 &nbsp;$&nbsp;&nbsp;&nbsp;<A HREF="h_index_cmd_sort">Sort</A>&nbsp;order&nbsp;of&nbsp;index&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;?&nbsp;&nbsp;Show&nbsp;Helptext&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Q&nbsp;Quit&nbsp;Alpine<BR>
4688 &nbsp;H&nbsp;&nbsp;&nbsp;<A HREF="h_common_hdrmode">Full&nbsp;header&nbsp;mode</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;M&nbsp;&nbsp;MAIN&nbsp;MENU&nbsp;Screen&nbsp;&nbsp;&nbsp;&lt;&nbsp;<A HREF="h_common_folders">FOLDER&nbsp;LIST</A>&nbsp;Screen<BR>
4689 &nbsp;X&nbsp;&nbsp;&nbsp;<A HREF="h_index_cmd_expunge">Expunge/Exclude</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;C&nbsp;&nbsp;<A HREF="h_common_compose">Compose</A>&nbsp;a&nbsp;new&nbsp;message<BR>
4690 &nbsp;Z&nbsp;&nbsp;&nbsp;<A HREF="h_index_cmd_zoom">Zoom</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;&nbsp;<A HREF="h_common_role">Compose&nbsp;using&nbsp;a&nbsp;role</A><BR>
4691 &nbsp;;&nbsp;&nbsp;&nbsp;<A HREF="h_index_cmd_select">Select</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;A&nbsp;<A HREF="h_index_cmd_apply">Apply</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;L&nbsp;&nbsp;COLLECTION&nbsp;LIST&nbsp;Screen<BR>
4692 &nbsp;:&nbsp;&nbsp;&nbsp;Select&nbsp;Messages&nbsp;in&nbsp;Current&nbsp;Thread<BR>
4693 <!--chtml endif-->
4694 <P>
4695
4696 NOTE:
4697 <OL>
4698  <LI>For help on a particular command, highlight the bold text associated
4699 with it above and hit Return.
4700  <LI>Availability of certain commands depends on <A HREF="h_common_conditional_cmds">feature settings</A>.
4701 </OL>
4702
4703 <H2>Description of the THREAD INDEX Screen</H2>
4704
4705 The THREAD INDEX displays summary information from each
4706 thread (conversation) in the current folder.
4707 This is useful if you want to quickly
4708 scan new threads, or find a particular thread without having to go
4709 through the text of each message, or to quickly get rid of junk
4710 threads, etc.
4711 The current thread is always highlighted.
4712 Each line of the THREAD INDEX contains the following columns: <P>
4713 <DL>
4714  <DT>STATUS:</DT>
4715  <DD> The markings on the left side of the thread tell you about its
4716 status.  You may see one or more of the following codes on any given
4717 thread:
4718 <UL>
4719   <LI> &quot;D&quot; for Deleted. All of the messages in this thread are marked for deletion but not yet eXpunged from the folder.
4720   <LI> &quot;A&quot; for Answered. All of the messages in this thread are marked answered.
4721   <LI> &quot;N&quot; for New. At least one message in the thread is New (you haven't looked at it yet).
4722   <LI> &quot;+&quot; for direct-to-you. The &quot;+&quot; indicates that a message in the thread was sent directly to your account, your copy is not part of a cc: or a mailing list.
4723   <LI> &quot;-&quot; for cc-to-you. The &quot;-&quot; indicates that a
4724         message in the thread was sent to you as a cc:. This symbol will only show up if
4725         the feature
4726         &quot;<A HREF="h_config_mark_for_cc"><!--#echo var="FEAT_mark-for-cc"--></A>&quot; is turned on (which is the default).
4727   <LI> &quot;X&quot; for selected.  You have selected at least one message in the thread by using the
4728         &quot;select&quot; command.  (Some systems may optionally allow selected
4729         messages to be denoted by the index line being displayed in bold
4730         type instead.)
4731   <LI> &quot;*&quot; for Important.  You have previously used the &quot;Flag&quot; command
4732       to mark at least one message in this thread as &quot;important&quot;.
4733 </UL></DD><P>
4734
4735  <DT>THREAD NUMBER:</DT>
4736  <DD>Threads in a folder are numbered, from one through the number
4737 of threads in the folder, to help you know where you are in the folder.
4738 </DD><P>
4739
4740  <DT>DATE STARTED:</DT>
4741  <DD>The date the thread was started. This is actually from the Date header
4742 of the first message in the thread. It doesn't take different time zones
4743 into account.</DD><P>
4744
4745  <DT>WHO STARTED THE THREAD:</DT>
4746  <DD>This is usually the name of the sender of the first message in the thread, taken from
4747 the From header of the message.
4748 If there is no personal name given in that
4749 address, then the email address is used instead.
4750 If the message is from you (or from one of your
4751 <A HREF="h_config_alt_addresses">alternate addresses</A>),
4752 then the recipient's name is shown here instead, with the characters
4753 &quot;To: &quot; inserted before the name.
4754 (The idea of this is that if you started the thread you would rather see who
4755 the mail was sent to instead of that the mail was from you.)
4756 In Newsgroups, if you are
4757 the sender and there are no email recipients, the newsgroup name will be
4758 listed after the &quot;To: &quot;.
4759 </DD><P>
4760
4761  <DT>SIZE:</DT>
4762  <DD>The number in parentheses is the number of messages in the thread.</DD><P>
4763
4764  <DT>SUBJECT:</DT>
4765  <DD>As much of the thread's subject line as will fit on the screen.
4766 This is the subject of the first message in the thread.</DD>
4767 </DL>
4768
4769 <P><UL>
4770 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
4771 </UL>
4772 <P>
4773 &lt;End of help on this topic&gt;
4774 </BODY>
4775 </HTML>
4776 ============= h_mail_index =============
4777 <HTML>
4778 <HEAD>
4779 <TITLE>MESSAGE INDEX COMMANDS</TITLE>
4780 </HEAD>
4781 <BODY>
4782 <H1>MESSAGE INDEX COMMANDS</H1>
4783 <!--chtml if pinemode="function_key"-->
4784 Available&nbsp;&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;1&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;2<BR>
4785 -------------------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;-----------------------------<BR>
4786 F1&nbsp;&nbsp;Show&nbsp;Help&nbsp;Text&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F1&nbsp;&nbsp;Show&nbsp;Help&nbsp;Text<BR>
4787 F2&nbsp;&nbsp;Toggle&nbsp;to&nbsp;see&nbsp;more&nbsp;commands&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F2&nbsp;&nbsp;Toggle&nbsp;to&nbsp;see&nbsp;more&nbsp;commands<BR>
4788 F3&nbsp;&nbsp;<A HREF="h_common_folders">FOLDER&nbsp;LIST</A>&nbsp;Screen&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F3&nbsp;&nbsp;MAIN&nbsp;MENU&nbsp;Screen<BR>
4789 F4&nbsp;&nbsp;View&nbsp;current&nbsp;message&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F4&nbsp;&nbsp;Quit&nbsp;Alpine<BR>
4790 F5&nbsp;&nbsp;Move&nbsp;to&nbsp;previous&nbsp;message&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F5&nbsp;&nbsp;<A HREF="h_common_compose">Compose</A>&nbsp;a&nbsp;message<BR>
4791 F6&nbsp;&nbsp;Move&nbsp;to&nbsp;next&nbsp;message&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F6&nbsp;&nbsp;<A HREF="h_common_goto">Goto</A>&nbsp;a&nbsp;specified&nbsp;folder<BR>
4792 F7&nbsp;&nbsp;Show&nbsp;previous&nbsp;screen&nbsp;of&nbsp;messages&nbsp;&nbsp;&nbsp;F7&nbsp;&nbsp;<A HREF="h_common_nextnew">Next&nbsp;new</A>&nbsp;message<BR>
4793 F8&nbsp;&nbsp;Show&nbsp;next&nbsp;screen&nbsp;of&nbsp;messages&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F8&nbsp;&nbsp;<A HREF="h_index_cmd_whereis">Whereis</A><BR>
4794 F9&nbsp;&nbsp;<A HREF="h_common_delete">Mark&nbsp;message&nbsp;for&nbsp;deletion</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F9&nbsp;&nbsp;<A HREF="h_common_print">Print</A>&nbsp;message<BR>
4795 F10&nbsp;<A HREF="h_common_delete">Undelete</A>&nbsp;(remove&nbsp;delete&nbsp;mark)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F10&nbsp;<A HREF="h_common_take">Take&nbsp;Address</A>&nbsp;into&nbsp;address&nbsp;book<BR>
4796 F11&nbsp;<A HREF="h_common_reply">Reply</A>&nbsp;to&nbsp;message&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F11&nbsp;<A HREF="h_common_save">Save</A>&nbsp;message&nbsp;into&nbsp;an&nbsp;email&nbsp;folder<BR>
4797 F12&nbsp;<A HREF="h_common_reply">Forward</A>&nbsp;message&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F12&nbsp;<A HREF="h_common_save">Export</A>&nbsp;message&nbsp;into&nbsp;a&nbsp;plain&nbsp;file<BR>
4798 <BR>
4799 Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;3<BR>
4800 -----------------------------<BR>
4801 F3&nbsp;&nbsp;<A HREF="h_index_cmd_expunge">Expunge/Exclude</A>&nbsp;&nbsp;&nbsp;&nbsp;F7&nbsp;<A HREF="h_index_cmd_sort">Sort</A>&nbsp;order&nbsp;of&nbsp;index&nbsp;&nbsp;F10&nbsp;<A HREF="h_common_bounce">Bounce</A>&nbsp;(remail)&nbsp;msg<BR>
4802 F5&nbsp;&nbsp;<A HREF="h_index_cmd_select">Select</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F8&nbsp;<A HREF="h_common_jump">Jump</A>&nbsp;to&nbsp;message&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F11&nbsp;<A HREF="h_common_flag">Flag</A>&nbsp;message&nbsp;as&nbsp;important<BR>
4803 F6&nbsp;&nbsp;<A HREF="h_index_cmd_apply">Apply</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F9&nbsp;<A HREF="h_common_hdrmode">Full&nbsp;Header&nbsp;Mode</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F12&nbsp;<A HREF="h_common_pipe">Pipe</A>&nbsp;to&nbsp;a&nbsp;Unix&nbsp;command<BR>
4804 <BR>
4805 Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;4<BR>
4806 -----------------------------<BR>
4807 F3&nbsp;&nbsp;Select&nbsp;Current&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F4&nbsp;&nbsp;<A HREF="h_index_cmd_zoom">Zoom</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F5&nbsp;&nbsp;COLLECTION&nbsp;LIST&nbsp;Screen
4808 F6&nbsp;&nbsp;<A HREF="h_common_role">Compose using a role</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F10&nbsp;<A HREF="h_index_collapse_expand">Collapse/Expand</A>&nbsp;Thread<BR>
4809 <BR>
4810 <!--chtml else-->
4811 Navigating&nbsp;the&nbsp;List&nbsp;of&nbsp;Messages&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Operations&nbsp;on&nbsp;the&nbsp;Current&nbsp;Message<BR>
4812 -------------------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;---------------------------------<BR>
4813 &nbsp;P&nbsp;&nbsp;&nbsp;Move&nbsp;to&nbsp;the&nbsp;previous&nbsp;message&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&gt;&nbsp;&nbsp;View&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;%&nbsp;&nbsp;<A HREF="h_common_print">Print</A><BR>
4814 &nbsp;N&nbsp;&nbsp;&nbsp;Move&nbsp;to&nbsp;the&nbsp;next&nbsp;message&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;R&nbsp;&nbsp;<A HREF="h_common_reply">Reply</A>&nbsp;to&nbsp;message&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F&nbsp;&nbsp;<A HREF="h_common_reply">Forward</A><BR>
4815 &nbsp;-&nbsp;&nbsp;&nbsp;Show&nbsp;previous&nbsp;screen&nbsp;of&nbsp;messages&nbsp;&nbsp;&nbsp;&nbsp;D&nbsp;&nbsp;<A HREF="h_common_delete">Mark&nbsp;for&nbsp;deletion</A><BR>
4816 Spc&nbsp;&nbsp;(space&nbsp;bar)&nbsp;Show&nbsp;next&nbsp;screen&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;U&nbsp;&nbsp;<A HREF="h_common_delete">Undelete</A>&nbsp;(remove&nbsp;deletion&nbsp;mark)<BR>
4817 &nbsp;J&nbsp;&nbsp;&nbsp;<A HREF="h_common_jump">Jump</A>&nbsp;to&nbsp;a&nbsp;specific&nbsp;message&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;T&nbsp;&nbsp;<A HREF="h_common_take">Take&nbsp;Address</A>&nbsp;into&nbsp;Address&nbsp;Book<BR>
4818 &nbsp;W&nbsp;&nbsp;&nbsp;<A HREF="h_index_cmd_whereis">Whereis</A>&nbsp;--&nbsp;search&nbsp;for&nbsp;a&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;S&nbsp;&nbsp;<A HREF="h_common_save">Save</A>&nbsp;into&nbsp;an&nbsp;email&nbsp;folder<BR>
4819 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;specific&nbsp;message&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;E&nbsp;&nbsp;<A HREF="h_common_save">Export</A>&nbsp;as&nbsp;a&nbsp;plain&nbsp;text&nbsp;file<BR>
4820 Tab&nbsp;&nbsp;<A HREF="h_common_nextnew">Next&nbsp;new</A>&nbsp;message&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;B&nbsp;&nbsp;<A HREF="h_common_bounce">Bounce</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*&nbsp;&nbsp;<A HREF="h_common_flag">Flag</A><BR>
4821 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;<A HREF="h_common_pipe">Pipe</A>&nbsp;to&nbsp;a&nbsp;Unix&nbsp;Command<BR>
4822 Miscellaneous&nbsp;Operations<BR>
4823 ------------------------<BR>
4824 &nbsp;G&nbsp;&nbsp;&nbsp;<A HREF="h_common_goto">Goto</A>&nbsp;a&nbsp;specified&nbsp;folder&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;General&nbsp;Alpine&nbsp;Commands<BR>
4825 &nbsp;$&nbsp;&nbsp;&nbsp;<A HREF="h_index_cmd_sort">Sort</A>&nbsp;order&nbsp;of&nbsp;index&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;---------------------<BR>
4826 &nbsp;H&nbsp;&nbsp;&nbsp;<A HREF="h_common_hdrmode">Full&nbsp;header&nbsp;mode</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;O&nbsp;&nbsp;Show&nbsp;all&nbsp;other&nbsp;available&nbsp;commands<BR>
4827 &nbsp;X&nbsp;&nbsp;&nbsp;<A HREF="h_index_cmd_expunge">Expunge/Exclude</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;?&nbsp;&nbsp;Show&nbsp;Help&nbsp;text&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Q&nbsp;Quit&nbsp;Alpine<BR>
4828 &nbsp;Z&nbsp;&nbsp;&nbsp;<A HREF="h_index_cmd_zoom">Zoom</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;M&nbsp;&nbsp;MAIN&nbsp;MENU&nbsp;Screen&nbsp;&nbsp;&nbsp;&lt;&nbsp;<A HREF="h_common_folders">FOLDER&nbsp;LIST</A>&nbsp;Screen<BR>
4829 &nbsp;;&nbsp;&nbsp;&nbsp;<A HREF="h_index_cmd_select">Select</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;A&nbsp;<A HREF="h_index_cmd_apply">Apply</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;C&nbsp;&nbsp;<A HREF="h_common_compose">Compose</A>&nbsp;a&nbsp;new&nbsp;message<BR>
4830 &nbsp;:&nbsp;&nbsp;&nbsp;Select&nbsp;Current&nbsp;message&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;&nbsp;<A HREF="h_common_role">Compose using a role</A><BR>
4831 &nbsp;/&nbsp;&nbsp;&nbsp;<A HREF="h_index_collapse_expand">Collapse/Expand</A>&nbsp;Thread&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;L&nbsp;&nbsp;COLLECTION&nbsp;LIST&nbsp;Screen<BR>
4832 <!--chtml endif-->
4833 <P>
4834
4835 NOTE:
4836 <OL>
4837  <LI>For help on a particular command, highlight the bold text associated
4838 with it above and hit Return.
4839  <LI>Availability of certain commands depends on <A HREF="h_common_conditional_cmds">feature settings</A>.
4840 </OL>
4841
4842 <H2>Description of the MESSAGE INDEX Screen</H2>
4843
4844 The MESSAGE INDEX displays summary information from each
4845 message in the current folder.
4846 This is useful if you want to quickly
4847 scan new messages, or find a particular message without having to go
4848 through the text of each message, or to quickly get rid of junk
4849 messages, etc.
4850 <P>
4851 The current message is always highlighted
4852 and many commands operate on the current message.
4853 For example, the Delete command will delete the current message.
4854 If the folder is sorted by either Threads or OrderedSubject, then, depending
4855 on some of your configuration settings, a single line in the index may
4856 refer to an entire thread or to a subthread.
4857 If that is the case, then the commands that normally operate on the current
4858 message will operate on the thread or subthread instead.
4859 For example, the Delete command will delete the whole collapsed thread
4860 instead of just a single message.
4861 <P>
4862 Each line of the MESSAGE INDEX contains the following columns (by default --
4863 you can change this with the
4864 &quot;<A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A>&quot; option
4865 in the SETUP CONFIGURATION screen): <P>
4866 <DL>
4867  <DT>STATUS:</DT>
4868  <DD> The markings on the left side of the message tell you about its
4869 status.  You may see one or more of the following codes on any given
4870 message:
4871 <UL>
4872   <LI> &quot;D&quot; for Deleted.  You have marked this message for deletion but not
4873          yet eXpunged the folder.
4874   <LI> &quot;N&quot; for New.  You have not looked at the text of the message yet.
4875   <LI> &quot;A&quot; for Answered.  Any time you reply to a message it is considered
4876          to be answered.
4877   <LI> &quot;F&quot; for Forwarded.  Similar to Answered, this is set whenever you
4878          forward a message.
4879   <LI> &quot;+&quot; for direct-to-you.  The &quot;+&quot; indicates that a message was sent
4880         directly to your account, your copy is not part of a cc: or a
4881         mailing list.
4882   <LI> &quot;-&quot; for cc-to-you. The &quot;-&quot; indicates that a
4883         message was sent to you as a cc:. This symbol will only show up if
4884         the feature
4885         &quot;<A HREF="h_config_mark_for_cc"><!--#echo var="FEAT_mark-for-cc"--></A>&quot; is turned on (which is the default).
4886   <LI> &quot;X&quot; for selected.  You have selected the message by using the
4887         &quot;select&quot; command.  (Some systems may optionally allow selected
4888         messages to be denoted by the index line being displayed in bold
4889         type.)
4890   <LI> &quot;*&quot; for Important.  You have previously used the &quot;Flag&quot; command
4891       to mark this message as &quot;important&quot;.
4892 </UL></DD><P>
4893
4894  <DT>MESSAGE NUMBER:</DT>
4895  <DD>Messages in a folder are numbered, from one through the number
4896 of messages in the folder, to help you know where you are in the folder.
4897 These numbers are always in increasing order, even if you sort the folder
4898 in a different way.</DD><P>
4899
4900  <DT>DATE SENT:</DT>
4901  <DD>The date the message was sent.  By default, messages are
4902 ordered by arrival time, not by date sent.  Most of the time, arrival time
4903 and date sent (effectively departure time) are similar.  Sometimes,
4904 however, the index will appear to be out of order because a message took a
4905 long time in delivery or because the sender is in a different time
4906 zone than you are. This date is just the date from the Date header
4907 field in the message.</DD><P>
4908
4909  <DT>WHO SENT THE MESSAGE:</DT>
4910  <DD>This is usually the name of the sender of the message, taken from
4911 the From header of the message.
4912 If there is no personal name given in that
4913 address, then the email address is used instead.
4914 If the message is from you (or from one of your
4915 <A HREF="h_config_alt_addresses">alternate addresses</A>),
4916 then the recipient's name is shown here instead, with the characters
4917 &quot;To: &quot; inserted before the name.
4918 (The idea of this is that if you sent the mail you would rather see who
4919 the mail was sent to instead of that the mail was from you.
4920 This behavior may be changed by modifying the <!--#echo var="VAR_index-format"--> option mentioned
4921 above.
4922 In particular, use the FROM token or the FROMORTONOTNEWS token
4923 in place of the FROMORTO token.)
4924 In Newsgroups, if you are
4925 the sender and there are no email recipients, the newsgroup name will be
4926 listed after the &quot;To: &quot;. </DD><P>
4927
4928  <DT>SIZE:</DT>
4929  <DD>The number in parentheses is the number of characters in the message.
4930 It may have a suffix of K, M, or G which means the number should be
4931 multiplied by one thousand, one million, or one billion to get the
4932 size of the message.</DD><P>
4933
4934  <DT>SUBJECT:</DT>
4935  <DD>As much of the message's subject line as will fit on the screen.</DD>
4936 </DL>
4937
4938 <P><UL>
4939 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
4940 </UL>
4941 <P>
4942 &lt;End of help on this topic&gt;
4943 </BODY>
4944 </HTML>
4945 ============= h_mail_view ========================
4946 <HTML>
4947 <HEAD>
4948 <TITLE>MESSAGE TEXT SCREEN</TITLE>
4949 </HEAD>
4950 <BODY>
4951 <H1>MESSAGE TEXT SCREEN</H1>
4952 <!--chtml if pinemode="function_key"-->
4953 Available&nbsp;&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;&nbsp;1&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;2<BR>
4954 -------------------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;------------------------------<BR>
4955 F1&nbsp;&nbsp;Show&nbsp;Help&nbsp;Text&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F1&nbsp;&nbsp;Show&nbsp;Help&nbsp;Text<BR>
4956 F2&nbsp;&nbsp;Toggle&nbsp;to&nbsp;see&nbsp;more&nbsp;commands&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F2&nbsp;&nbsp;Toggle&nbsp;to&nbsp;see&nbsp;more&nbsp;commands<BR>
4957 F3&nbsp;&nbsp;<A HREF="h_common_index">MESSAGE&nbsp;INDEX</A>&nbsp;Screen&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F3&nbsp;&nbsp;MAIN&nbsp;MENU&nbsp;Screen<BR>
4958 F4&nbsp;&nbsp;<A HREF="h_view_cmd_viewattch">View&nbsp;attachment</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F4&nbsp;&nbsp;Quit&nbsp;Alpine<BR>
4959 F5&nbsp;&nbsp;Display&nbsp;previous&nbsp;message&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F5&nbsp;&nbsp;<A HREF="h_common_folders">FOLDER&nbsp;LIST</A>&nbsp;Screen<BR>
4960 F6&nbsp;&nbsp;Display&nbsp;next&nbsp;message&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F6&nbsp;&nbsp;<A HREF="h_common_goto">Goto</A>&nbsp;a&nbsp;specified&nbsp;folder<BR>
4961 F7&nbsp;&nbsp;Previous&nbsp;screen&nbsp;of&nbsp;this&nbsp;message&nbsp;&nbsp;&nbsp;&nbsp;F7&nbsp;&nbsp;<A HREF="h_common_compose">Compose</A>&nbsp;message<BR>
4962 F8&nbsp;&nbsp;Next&nbsp;screen&nbsp;of&nbsp;this&nbsp;message&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F8&nbsp;&nbsp;<A HREF="h_view_cmd_whereis">Whereis</A><BR>
4963 F9&nbsp;&nbsp;<A HREF="h_common_delete">Mark&nbsp;message&nbsp;for&nbsp;deletion</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F9&nbsp;&nbsp;<A HREF="h_common_print">Print</A>&nbsp;message<BR>
4964 F10&nbsp;<A HREF="h_common_delete">Undelete</A>&nbsp;(remove&nbsp;delete&nbsp;mark)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F10&nbsp;<A HREF="h_common_take">Take&nbsp;Address</A>&nbsp;into&nbsp;address&nbsp;book<BR>
4965 F11&nbsp;<A HREF="h_common_reply">Reply</A>&nbsp;to&nbsp;message&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F11&nbsp;<A HREF="h_common_save">Save</A>&nbsp;message&nbsp;into&nbsp;an&nbsp;email&nbsp;folder<BR>
4966 F12&nbsp;<A HREF="h_common_reply">Forward</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F12&nbsp;<A HREF="h_common_save">Export</A>&nbsp;message&nbsp;into&nbsp;a&nbsp;plain&nbsp;file<BR>
4967 <BR>
4968 Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;3<BR>
4969 ------------------------------<BR>
4970 F1&nbsp;&nbsp;Show&nbsp;Help&nbsp;Text<BR>
4971 F2&nbsp;&nbsp;Toggle&nbsp;to&nbsp;see&nbsp;more&nbsp;commands<BR>
4972 F3&nbsp;&nbsp;<A HREF="h_view_cmd_hilite">View&nbsp;hilited</A><BR>
4973 F4&nbsp;&nbsp;Select&nbsp;current&nbsp;message<BR>
4974 F5&nbsp;&nbsp;Previous&nbsp;selectable&nbsp;item<BR>
4975 F6&nbsp;&nbsp;Next&nbsp;selectable&nbsp;item<BR>
4976 F7&nbsp;&nbsp;<A HREF="h_common_jump">Jump</A>&nbsp;to&nbsp;message&nbsp;number<BR>
4977 F8&nbsp;&nbsp;<A HREF="h_common_nextnew">Next&nbsp;new</A>&nbsp;message<BR>
4978 F9&nbsp;&nbsp;<A HREF="h_common_hdrmode">Display&nbsp;full&nbsp;headers</A><BR>
4979 F10&nbsp;<A HREF="h_common_bounce">Bounce</A>&nbsp;message<BR>
4980 F11&nbsp;<A HREF="h_common_flag">Flag</A>&nbsp;message<BR>
4981 F12&nbsp;<A HREF="h_common_pipe">Pipe</A>&nbsp;to&nbsp;a&nbsp;Unix&nbsp;command<BR>
4982 Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;4<BR>
4983 F5&nbsp;&nbsp;<A HREF="h_common_role">Compose using a role</A><BR>
4984 <!--chtml else-->
4985 Operations&nbsp;on&nbsp;the&nbsp;Current&nbsp;Message<BR>
4986 ---------------------------------<BR>
4987 <BR>
4988 &nbsp;-&nbsp;&nbsp;&nbsp;Show&nbsp;previous&nbsp;page&nbsp;of&nbsp;this&nbsp;msg&nbsp;&nbsp;&nbsp;&nbsp;S&nbsp;&nbsp;<A HREF="h_common_save">Save</A>&nbsp;into&nbsp;an&nbsp;email&nbsp;folder<BR>
4989 Spc&nbsp;&nbsp;(space&nbsp;bar)&nbsp;Show&nbsp;next&nbsp;page&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;E&nbsp;&nbsp;<A HREF="h_common_save">Export</A>&nbsp;as&nbsp;a&nbsp;plain&nbsp;text&nbsp;file<BR>
4990 &nbsp;&gt;&nbsp;&nbsp;&nbsp;<A HREF="h_view_cmd_viewattch">View&nbsp;attachment</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;B&nbsp;&nbsp;<A HREF="h_common_bounce">Bounce</A><BR>
4991 &nbsp;R&nbsp;&nbsp;&nbsp;<A HREF="h_common_reply">Reply</A>&nbsp;to&nbsp;message&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;F&nbsp;&nbsp;<A HREF="h_common_reply">Forward</A>&nbsp;message<BR>
4992 &nbsp;D&nbsp;&nbsp;&nbsp;<A HREF="h_common_delete">Mark&nbsp;for&nbsp;deletion</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Ret&nbsp;View&nbsp;<A HREF="h_view_cmd_hilite">hilited</A>&nbsp;item<BR>
4993 &nbsp;U&nbsp;&nbsp;&nbsp;<A HREF="h_common_delete">Undelete</A>&nbsp;(remove&nbsp;deletion&nbsp;mark)&nbsp;&nbsp;^F&nbsp;&nbsp;Select&nbsp;next&nbsp;<A HREF="h_view_cmd_hilite">hilited</A>&nbsp;item&nbsp;in&nbsp;message<BR>
4994 &nbsp;T&nbsp;&nbsp;&nbsp;<A HREF="h_common_take">Take&nbsp;Address</A>&nbsp;into&nbsp;Address&nbsp;Book&nbsp;&nbsp;&nbsp;^B&nbsp;&nbsp;Select&nbsp;previous&nbsp;<A HREF="h_view_cmd_hilite">hilited</A>&nbsp;item<BR>
4995 &nbsp;%&nbsp;&nbsp;&nbsp;<A HREF="h_common_print">Print</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;*&nbsp;&nbsp;<A HREF="h_common_flag">Flag</A>&nbsp;message<BR>
4996 &nbsp;W&nbsp;&nbsp;&nbsp;<A HREF="h_view_cmd_whereis">Whereis</A>:&nbsp;search&nbsp;for&nbsp;text&nbsp;in&nbsp;msg&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;<A HREF="h_common_pipe">Pipe</A>&nbsp;to&nbsp;a&nbsp;Unix&nbsp;command<BR>
4997 <BR>
4998 Navigating&nbsp;the&nbsp;List&nbsp;of&nbsp;Messages&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Other&nbsp;Commands<BR>
4999 -------------------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;----------------------------<BR>
5000 &nbsp;P&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Display&nbsp;previous&nbsp;message&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;G&nbsp;&nbsp;&nbsp;<A HREF="h_common_goto">Goto</A>&nbsp;a&nbsp;specified&nbsp;folder<BR>
5001 &nbsp;N&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Display&nbsp;next&nbsp;message&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;H&nbsp;&nbsp;&nbsp;<A HREF="h_common_hdrmode">Full&nbsp;header&nbsp;mode</A>&nbsp;on/off<BR>
5002 &nbsp;J&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="h_common_jump">Jump</A>&nbsp;to&nbsp;a&nbsp;specific&nbsp;message&nbsp;&nbsp;&nbsp;&nbsp;:&nbsp;&nbsp;&nbsp;Select&nbsp;Current&nbsp;message<BR>
5003 Tab&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="h_common_nextnew">Next&nbsp;new</A>&nbsp;message&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;A&nbsp;&nbsp;&nbsp;<A HREF="h_config_prefer_plain_text">Toggle&nbsp;Prefer&nbsp;Plain&nbsp;Text</A><BR>
5004 <BR>
5005 General&nbsp;Alpine&nbsp;Commands<BR>
5006 ---------------------<BR>
5007 &nbsp;O&nbsp;&nbsp;Show&nbsp;all&nbsp;other&nbsp;available&nbsp;commands<BR>
5008 &nbsp;?&nbsp;&nbsp;Show&nbsp;Help&nbsp;text&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Q&nbsp;Quit&nbsp;Alpine<BR>
5009 &nbsp;M&nbsp;&nbsp;MAIN&nbsp;MENU&nbsp;Screen&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;L&nbsp;<A HREF="h_common_folders">FOLDER&nbsp;LIST</A>&nbsp;Screen&nbsp;(or&nbsp;COLLECTION&nbsp;LIST&nbsp;Screen)<BR>
5010 &nbsp;&lt;&nbsp;&nbsp;<A HREF="h_common_index">MESSAGE&nbsp;INDEX</A>&nbsp;Screen&nbsp;&nbsp;C&nbsp;<A HREF="h_common_compose">Compose</A>&nbsp;a&nbsp;new&nbsp;message<BR>
5011 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;#&nbsp;<A HREF="h_common_role">Compose&nbsp;using&nbsp;a&nbsp;role</A><BR>
5012 <!--chtml endif-->
5013 <P>
5014
5015 NOTE:
5016 <OL>
5017  <LI>For help on a particular command, highlight the bold text associated
5018 with it above and hit Return.
5019  <LI>Availability of certain commands depends on <A HREF="h_common_conditional_cmds">feature settings</A>.
5020 </OL>
5021
5022 <H2>Description of the MESSAGE TEXT Screen</H2>
5023
5024 The top line of the view message screen displays status
5025 information about the currently open collection and folder and about the
5026 current message.  It shows the name of the collection in angle brackets
5027 and then the name of the folder.  The line also displays the number
5028 of messages in the folder, the number of the current message and the
5029 percentage of the current message that has been displayed on the screen.
5030 If the message is marked for deletion &quot;DEL&quot; will appear in the upper
5031 right corner.
5032 If the message has been answered (but not deleted) &quot;ANS&quot; will show
5033 in the corner.
5034 <P>
5035
5036 NOTE: to rapidly move to the end of a message, hit the
5037 <!--chtml if pinemode="function_key"-->F8<!--chtml else-->W<!--chtml endif-->
5038 (or Ctrl-W) key followed
5039 by Ctrl-V.  Similarly,
5040 <!--chtml if pinemode="function_key"-->F8<!--chtml else-->W<!--chtml endif-->
5041 followed by Ctrl-Y will take you to the beginning of
5042 a message.
5043
5044 <H2>Explanation of Alternate Character Sets</H2>
5045
5046 Alpine attempts to stay out of the way so that it won't prevent you from
5047 viewing mail in any character set.  It will simply send the message to
5048 your display device.  If the device is capable of displaying the
5049 message as it was written it will do so.  If not, the display may be
5050 partially or totally incorrect.
5051 If the message contains characters that are not representable in your
5052 <A HREF="h_config_char_set">&quot;Display Character Set&quot;</A>
5053 variable in your configuration, then a warning message will be printed
5054 to your screen at the beginning of the message display.
5055 It is probably best to use UNIX Alpine in a terminal emulator
5056 capable of displaying UTF-8 characters.
5057 See <A HREF="h_config_char_set">Display Character Set</A> for a little
5058 more information about character set settings.
5059
5060 <P><UL>
5061 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
5062 </UL>
5063 <P>
5064 &lt;End of help on this topic&gt;
5065 </BODY>
5066 </HTML>
5067 ======= h_index_cmd_select =======
5068 <HTML>
5069 <HEAD>
5070 <TITLE>Selecting: Select and WhereIs/Select</TITLE>
5071 </HEAD>
5072 <BODY>
5073 <H1>Selecting: Select and WhereIs/Select</H1>
5074
5075 Aggregate operations give you the ability to process a group of messages
5076 at once.  Acting on multiple messages requires two steps: (1) selecting a
5077 set of messages and then; (2) applying a command to that set. The first
5078 part is handled by the select command.  Select allows you to
5079 select messages based on their status (read, answered, etc.), contents,
5080 date, size, or keywords.
5081 You may also select based on one of your Rules or based on threads,
5082 and there are quick options to select a specific message or range of messages,
5083 to select the current message, or to select all messages.
5084 <P>
5085
5086 We describe the various selection criteria briefly:
5087 <P>
5088
5089 <DL>
5090 <DT>select All</DT>
5091 <DD> Marks all the messages in the folder as selected.
5092 </DD>
5093
5094 <DT>select Cur</DT>
5095 <DD> Selects the currently highlighted message or currently highlighted
5096 set of messages if in a threaded view.
5097 </DD>
5098
5099 <DT>select by Number</DT>
5100 <DD> Select by message number. This may be a comma-separated list instead or
5101 a single entry.
5102 Each element in the list may be either a single message number or a range
5103 of numbers with a dash between the lowest and highest member of the range.
5104 Some examples are 7 to select only message number 7; 2-5 to select messages
5105 2 through 5; and 2-5,7-9,11 to select messages 2, 3, 4, 5, 7, 8, 9, and 11.
5106 The word &quot;end&quot; may be used as a substitute for the highest numbered
5107 message in the folder.
5108 If in a separate thread index where the numbers refer to threads instead of
5109 to messages, then you will be selecting all of the messages in the
5110 referenced threads instead of selecting by message number.
5111 </DD>
5112
5113 <DT>select by Date</DT>
5114 <DD> Select by either the date stored in the Date headers of each message,
5115 or by the date when the messages arrived.
5116 This does not adjust for different time zones, but just checks to see what
5117 day the message was sent on.
5118 You may type in a date. If you do, the date should be in the form
5119 <P><SAMP><CENTER>DD-Mon-YYYY</CENTER></SAMP><P>
5120 For example,
5121 <P><SAMP><CENTER>24-Nov-2004</CENTER></SAMP><P>
5122 or
5123 <P><SAMP><CENTER>09-Nov-2004</CENTER></SAMP><P>
5124 If the date you want is close to the current date, it is probably
5125 easier to use the &quot;^P&nbsp;Prev Day&quot; or &quot;^N&nbsp;Next Day&quot; commands to change the default date that
5126 is displayed, instead of typing in the date yourself.
5127 Or, the &quot;^X&nbsp;Cur Msg&quot; command may be used to fill in
5128 the date of the currently highlighted message.
5129 <P>
5130 There are six possible settings that are selected using the
5131 &quot;^W&nbsp;Toggle When&quot; command.
5132 Three of them select messages based on the Date headers.
5133 They are &quot;SENT SINCE&quot;, &quot;SENT BEFORE&quot;,
5134 and &quot;SENT ON&quot;.
5135 SINCE is all messages with the selected date or later.
5136 BEFORE is all messages earlier than the selected date (not including the day
5137 itself).
5138 ON is all messages sent on the selected date.
5139 The other three select messages in the same way but they use the arrival
5140 times of the messages instead of the Date headers included in the messages.
5141 Those three are &quot;ARRIVED SINCE&quot;, &quot;ARRIVED BEFORE&quot;,
5142 and &quot;ARRIVED ON&quot;.
5143 When you save a message from one folder to another the arrival time is
5144 preserved.
5145 </DD>
5146
5147 <DT>select by Text</DT>
5148 <DD> Selects messages based on the message contents.
5149 This allows you to select a set of messages based on whether or not the
5150 message headers or message body contain specified text.
5151 You may look for text in the Subject, the From header,
5152 the To header, or the Cc header.
5153 You may also choose Recipient, which searches for the text in
5154 either the To or the Cc header;
5155 or Participant, which means To or Cc or From.
5156 Besides those specific header searches, you may also search the entire
5157 header and text of the message with &quot;All Text&quot;, or just the
5158 body of the message.
5159 <P>
5160 To search for the absence of text, first type the &quot;! Not&quot; command
5161 before typing the specific type of text search.
5162 For example, you could type &quot;!&quot; followed by &quot;S&quot; to
5163 search for all messages that do not contain a particular word in their
5164 Subjects.
5165 <P>
5166 If you choose a Subject search, you may use the subject from the current
5167 message by typing the &quot;^X Cur Subject&quot; command.
5168 You may then edit it further if you wish.
5169 For example, you might select the subject of a reply and edit the
5170 &quot;Re:&nbsp;&quot; off of the front of it in order to search for
5171 the original message being replied to.
5172 All of the other header searches allow you to use addresses from the
5173 headers of the current message if you want to.
5174 You may use the &quot;^T Cur To&quot;, &quot;^R Cur From&quot;, or
5175 &quot;^W Cur Cc&quot;.
5176 In each case, if there is more than one address, only the first is offered.
5177 </DD>
5178
5179 <DT>select by Status</DT>
5180 <DD> Selects messages based on their status.
5181 You may select all New, Important, Deleted, Answered, Recent, or Unseen
5182 messages.
5183 Or, if you first type the &quot;! Not&quot; command, you get not New,
5184 or not Important, and so on.
5185 If you select Deleted messages, you will get all messages with their
5186 Deleted flag set.
5187 Likewise for Important messages, all messages that you have flagged as
5188 being Important with the
5189 <A HREF="h_common_flag">Flag</A> command.
5190 The &quot;New&quot; and &quot;Answered&quot; choices are a little bit odd
5191 because they try to match what you see on the screen by default.
5192 &quot;New&quot; is a shorthand for messages that are Unseen, Undeleted,
5193 and Unanswered.
5194 If you have looked at the message, or deleted it, or answered it; then it
5195 is not considered &quot;New &quot;.
5196 &quot;!&nbsp;New&quot; is the opposite of &quot;New&quot;.
5197 <P>
5198 &quot;Answered&quot; is another one that is a little different.
5199 It means that the message has been Answered <EM>and</EM> is not deleted.
5200 And to make it even more confusing, &quot;!&nbsp;Answered&quot; is not
5201 the opposite of &quot;Answered&quot;!
5202 Instead, &quot;!&nbsp;Answered&quot; stands for messages that are
5203 both Unanswered <EM>and</EM> not deleted.
5204 <P>
5205 The other two types were added later because the special nature of the
5206 New flag was not what was wanted by all users.
5207 New does match what you see in the index by default, but if you use
5208 the IMAPSTATUS or SHORTIMAPSTATUS token in the
5209 &quot;<A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A>&quot; it may not
5210 be exactly what you want.
5211 &quot;Unseen&quot; simply selects all unseen messages, whether or not
5212 they are deleted or answered, and
5213 &quot;Recent&quot; selects all of the messages that have been added to
5214 the folder since you started this Alpine session.
5215 (That's not technically quite true. If there are multiple mail clients
5216 reading an IMAP mailbox, each message will be marked as Recent in only
5217 one of the client's sessions.)
5218 </DD>
5219
5220 <DT>select by siZe</DT>
5221 <DD> Selects messages based on their size being smaller than or larger
5222 than the size you specify.
5223 The size is the number of bytes.
5224 You may use the suffix &quot;K&quot; or &quot;k&quot; to mean 1,000 times
5225 the number.
5226 For example, 7K is the same as 7000.
5227 The suffix &quot;M&quot; or &quot;m&quot; means 1,000,000 times the number,
5228 and the suffix &quot;G&quot; or &quot;g&quot; means 1,000,000,000 times.
5229 Use the &quot;^W&quot; command to toggle back and forth between Smaller
5230 and Larger.
5231 </DD>
5232
5233 <DT>select by Keyword</DT>
5234 <DD> Selects messages that either have or do not have
5235 (using the &quot;!&nbsp;Not&quot; command)
5236 a particular <A HREF="h_config_keywords">Keyword</A> set.
5237 One way to select a keyword is to use the &quot;^T&nbsp;To&nbsp;List&quot;
5238 command to select one from your list of keywords.
5239 The
5240 <A HREF="h_config_flag_screen_kw_shortcut"><!--#echo var="FEAT_enable-flag-screen-keyword-shortcut"--></A> option allows selecting by Keyword initials if set.
5241 </DD>
5242
5243 <DT>select by Rule</DT>
5244 <DD> Selects messages that either match or don't match
5245 (using the &quot;!&nbsp;Not&quot; command)
5246 one of the Rules you have defined.
5247 The most likely method of filling in the Rule is to use the
5248 &quot;^T&nbsp;To&nbsp;List&quot;
5249 command to select one of your Rules.
5250 All of the Rules you have defined will be in the list, including
5251 Rules for Searching, Indexcolors, Filtering, Roles, Score setting, and Other.
5252 They may not all make sense for this purpose, but they are all there for
5253 flexibility.
5254 You might find it useful to define some rules solely for the purpose
5255 of being used by the Select command.
5256 There is a special category for such Rules. They are called Search Rules.
5257 <P>
5258 Unfortunately, Alpine does not allow all possible Rules to be defined.
5259 For example, there is no logical OR operation.
5260 OR is accomplished in the Filter Rules or the other types of Rules by
5261 simply defining two rules, one that matches the first part of the OR
5262 and another that matches the second part.
5263 But you can't do that here, since you only have a single Rule to work with.
5264 Likewise, the order of Rules is usually important.
5265 For example, if the first Filter Rule (or Indexcolor rule or ...) matches
5266 a message, then that stops the search for a further match.
5267 This means that you may be confused if you try to use Select by Rule to
5268 check your Filter rules because the order is important when filtering but
5269 is not considered here.
5270 </DD>
5271
5272 <DT>select by tHread</DT>
5273 <DD> Selects all of the messages in the current thread.
5274 </DD>
5275 </DL>
5276
5277 After you have an initial selection, the next and subsequent selection
5278 commands modify the selection.
5279 The select command changes. It first gives
5280 you selection &quot;alteration&quot; options: &quot;unselect All&quot;,
5281 &quot;unselect Current&quot;,
5282 &quot;Broaden selection&quot; (implements a logical OR), and
5283 &quot;Narrow selection&quot; (implements a logical AND).
5284 After you choose either Broaden or Narrow, you then choose one of the
5285 selection criteria listed above (by Text or Number or ...).
5286 You may use select as many times as you wish to get the selected set right.
5287 <P>
5288
5289 The WhereIs command has a feature (Ctrl-X) to
5290 select all the messages that match the WhereIs search. WhereIs searches
5291 through just the text that appears on the MESSAGE INDEX screen.
5292 This method is often slower than using the select command itself, unless the
5293 line you are looking for is not too far away in the index.
5294 <P>
5295
5296 The availability of the aggregate operations commands is determined by the
5297 <A HREF="h_config_enable_agg_ops">&quot;<!--#echo var="FEAT_enable-aggregate-command-set"-->&quot;</A>
5298 Feature-List option in your Alpine
5299 configuration, which defaults to set.
5300 The features
5301 <A HREF="h_config_auto_zoom">&quot;<!--#echo var="FEAT_auto-zoom-after-select"-->&quot;</A>
5302 and
5303 <A HREF="h_config_select_wo_confirm">&quot;<!--#echo var="FEAT_select-without-confirm"-->&quot;</A>
5304 affect the behavior of the Select command.
5305
5306 <P>
5307 &lt;End of help on this topic&gt;
5308 </BODY>
5309 </HTML>
5310 ======= h_select_rule =======
5311 <HTML>
5312 <HEAD>
5313 <TITLE>Select: Rule</TITLE>
5314 </HEAD>
5315 <BODY>
5316 <H1>Select: Rule</H1>
5317
5318 You are selecting messages that either match or don't match
5319 one of the Rules you have defined.
5320 You may either type the nickname of the Rule at the prompt, or use the
5321 &quot;^T&nbsp;To&nbsp;List&quot;
5322 command to select one of your Rules.
5323 All of the Rules you have defined will be in the list, including
5324 Rules for Indexcolors, Filtering, Roles, Score setting, and Other.
5325 They may not all make sense for this purpose, but they are all there for
5326 flexibility.
5327 Rules may be added by using the Setup/Rules screen off of the main Alpine
5328 menu.
5329 <P>
5330 Unfortunately, Alpine does not allow all possible Rules to be defined.
5331 For example, there is no logical OR operation.
5332 OR is accomplished in the Filter Rules or the other types of Rules by
5333 simply defining two rules, one that matches the first part of the OR
5334 and another that matches the second part.
5335 But you can't do that here, since you only have a single Rule to work with.
5336 Likewise, the order of Rules is usually important.
5337 For example, if the first Filter Rule (or Indexcolor rule or ...) matches
5338 a message, then that stops the search for a further match.
5339 This means that you may be confused if you try to use Select by Rule to
5340 check your Filter rules because the order is important when filtering but
5341 is not considered here.
5342
5343 <P>
5344 &lt;End of help on this topic&gt;
5345 </BODY>
5346 </HTML>
5347 ======= h_select_text =======
5348 <HTML>
5349 <HEAD>
5350 <TITLE>Select: Text</TITLE>
5351 </HEAD>
5352 <BODY>
5353 <H1>Select: Text</H1>
5354
5355 You are selecting messages based on the contents of the message.
5356 This allows you to select a set of messages based on whether or not the
5357 message headers or message body contain specified text.
5358 You may look for text in the Subject, the From header,
5359 the To header, or the Cc header.
5360 You may also choose Recipient, which searches for the text in
5361 either the To or the Cc header;
5362 or Participant, which means either the To header, or the Cc header,
5363 or the From header.
5364 Besides those specific header searches, you may also search the entire
5365 header and text of the message with &quot;All Text&quot;, or just the
5366 body of the message with &quot;Body&quot;.
5367 <P>
5368 To search for the absence of text, first type the &quot;!&nbsp;Not&quot; command
5369 before typing the specific type of text search.
5370 For example, you could type &quot;!&quot; followed by &quot;S&quot; to
5371 search for all messages that do not contain a particular word in their
5372 Subjects.
5373 <P>
5374 If you choose a Subject search, you may use the subject from the current
5375 message by typing the &quot;^X Cur Subject&quot; command.
5376 You may then edit it further if you wish.
5377 For example, you might select the subject of a reply and edit the
5378 &quot;Re:&nbsp;&quot; off of the front of it in order to search for
5379 the original message being replied to.
5380 All of the other header searches allow you to use addresses from the
5381 headers of the current message if you want to.
5382 You may use the &quot;^T Cur To&quot;, &quot;^R Cur From&quot;, or
5383 &quot;^W Cur Cc&quot;.
5384 In each case, if there is more than one address, only the first is offered.
5385
5386 <P>
5387 &lt;End of help on this topic&gt;
5388 </BODY>
5389 </HTML>
5390 ======= h_select_status =======
5391 <HTML>
5392 <HEAD>
5393 <TITLE>Select: Status</TITLE>
5394 </HEAD>
5395 <BODY>
5396 <H1>Select: Status</H1>
5397
5398 You are selecting messages based on the status of the message.
5399 For example, whether or not the message has been marked Deleted or Important,
5400 or whether or not it has been Answered or is New.
5401 If you first type the &quot;!&nbsp;Not&quot; command, you will get the
5402 opposite: not Deleted, not Important, and so on.
5403 <P>
5404 If you select Deleted messages, you will get all messages with their
5405 Deleted flag set.
5406 Likewise for Important messages, all messages that you have flagged as
5407 being Important with the
5408 <A HREF="h_common_flag">Flag</A> command.
5409 The &quot;New&quot; and &quot;Answered&quot; choices are a little bit odd
5410 because they try to match what you see on the screen by default.
5411 &quot;New&quot; is a shorthand for messages that are Unseen, Undeleted,
5412 and Unanswered.
5413 If you have looked at the message, or deleted it, or answered it; then it
5414 is not considered &quot;New &quot;.
5415 &quot;!&nbsp;New&quot; is the opposite of &quot;New&quot;.
5416 <P>
5417 &quot;Answered&quot; is another one that is a little different.
5418 It means that the message has been Answered <EM>and</EM> is not deleted.
5419 And to make it even more confusing, &quot;!&nbsp;Answered&quot; is not
5420 the opposite of &quot;Answered&quot;!
5421 Instead, &quot;!&nbsp;Answered&quot; stands for messages that are
5422 both Unanswered <EM>and</EM> not deleted.
5423 <P>
5424 (The New and Answered options may seem counter-intuitive.
5425 The reason it is done this way is
5426 because, by default, a Deleted message will show up with the &quot;D&quot;
5427 symbol in the MAIL INDEX screen even if it is New or Answered.
5428 The Delete symbol overrides the New and Answered symbols, because you
5429 usually don't care about the message anymore once you've deleted it.
5430 Similarly, you usually only care about whether a message is Answered or
5431 not if it is not Deleted.
5432 Once it is Deleted you've put it out of your mind.)
5433 <P>
5434 The other two options were added later because the special nature of the
5435 New flag was not what was wanted by all users.
5436 New does match what you see in the index by default, but if you use
5437 the IMAPSTATUS or SHORTIMAPSTATUS token in the
5438 &quot;<A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A>&quot; it may not
5439 be exactly what you expect.
5440 &quot;Unseen&quot; simply selects all unseen messages, whether or not
5441 they are deleted or answered, and
5442 &quot;Recent&quot; selects all of the messages that have been added to
5443 the folder since you started this Alpine session.
5444 (That's not technically quite true. If there are multiple mail clients
5445 reading an IMAP mailbox, each message will be marked as Recent in only
5446 one of the client's sessions.
5447 That behavior can be convenienent for some purposes, like filtering, but
5448 it isn't usually what you expect when selecting.)
5449
5450 <P>
5451 &lt;End of help on this topic&gt;
5452 </BODY>
5453 </HTML>
5454 ======= h_index_cmd_apply =======
5455 <HTML>
5456 <HEAD>
5457 <TITLE>Apply Command</TITLE>
5458 </HEAD>
5459 <BODY>
5460 <H1>Apply Command</H1>
5461
5462 Apply
5463 (<!--chtml if pinemode="function_key"-->F6<!--chtml else-->A<!--chtml endif-->)
5464 is the second step of most aggregate operations.  Apply
5465 becomes active any time there is a defined set of selected messages.  The
5466 following commands can be applied to a selected message set: delete,
5467 undelete, reply, forward,
5468 <!--chtml if pinemode="os_windows"-->
5469 <!--chtml else-->
5470 pipe,
5471 <!--chtml endif-->
5472 print, take address, save, export, bounce, and flag.
5473 <P>
5474
5475 The behavior of some of these commands in an aggregate sense is not easy to
5476 explain.  Try them out to see what they do.
5477 The feature
5478 <A HREF="h_config_auto_unzoom">&quot;<!--#echo var="FEAT_auto-unzoom-after-apply"-->&quot;</A>
5479 affects the behavior of the Apply command, as does the feature
5480 <A HREF="h_config_auto_unselect">&quot;<!--#echo var="FEAT_auto-unselect-after-apply"-->&quot;</A>.
5481
5482 <P>
5483 &lt;End of help on this topic&gt;
5484 </BODY>
5485 </HTML>
5486 ======= h_index_cmd_zoom =======
5487 <HTML>
5488 <HEAD>
5489 <TITLE>ZoomMode Command</TITLE>
5490 </HEAD>
5491 <BODY>
5492 <H1>ZoomMode Command</H1>
5493
5494 Another action you might want to take on a set of selected messages is to
5495 zoom in on them.  Like apply, zoom only becomes active when messages have
5496 been selected.
5497 ZoomMode
5498 (<!--chtml if pinemode="function_key"-->F3<!--chtml else-->Z<!--chtml endif-->)
5499 is a toggle command that allows you to
5500 zoom-in (and only see the selected messages) and zoom-out (to see all
5501 messages in the folder).  Neither apply nor zoom removes the markings that
5502 define the selected set; you need to use a select command in order
5503 to do that.
5504
5505 <P>
5506 &lt;End of help on this topic&gt;
5507 </BODY>
5508 </HTML>
5509 ======= h_index_collapse_expand =======
5510 <HTML>
5511 <HEAD>
5512 <TITLE>Collapse/Expand Command</TITLE>
5513 </HEAD>
5514 <BODY>
5515 <H1>Collapse/Expand Command</H1>
5516
5517 The Collapse/Expand command is only available from the MESSAGE INDEX screen when
5518 the folder is sorted by either Threads or OrderedSubject, and the
5519 <A HREF="h_config_thread_disp_style"><!--#echo var="VAR_threading-display-style"--></A>
5520 is set to something other than &quot;none&quot;.
5521 By default, this command collapses or expands the subthread that starts at
5522 the currently highlighted message, if any.
5523 If the subthread is already collapsed, then this command expands it.
5524 If the subthread is expanded, then this command collapses it.
5525 If there are no more messages below the current message in the
5526 thread tree (that is, there are no replies to the current message) then
5527 this command does nothing.
5528
5529 <P>
5530 The behavior of this command is affected by the option
5531 <A HREF="h_config_slash_coll_entire">&quot;<!--#echo var="FEAT_slash-collapses-entire-thread"-->&quot;</A>.
5532 Normally, this command Collapses or Expands the subthread that
5533 starts at the currently highlighted message.
5534 If the above option is set, then this command Collapses or Expands the
5535 entire current thread instead of just the subthread.
5536 The current thread is simply the top-level thread that contains the
5537 current message.
5538
5539 <P>
5540 &lt;End of help on this topic&gt;
5541 </BODY>
5542 </HTML>
5543 ======= h_index_cmd_sort =======
5544 <HTML>
5545 <HEAD>
5546 <TITLE>Sort Command</TITLE>
5547 </HEAD>
5548 <BODY>
5549 <H1>Sort Command</H1>
5550
5551 In Alpine's generic configuration, messages are presented in the order in
5552 which they arrive.  This default can be changed in the SETUP CONFIGURATION
5553 with the &quot;<A HREF="h_config_sort_key"><!--#echo var="VAR_sort-key"--></A>&quot; option.
5554 You can also re-sort the folder on demand with the sort
5555 (<!--chtml if pinemode="function_key"-->F7<!--chtml else-->$<!--chtml endif-->)
5556 command.
5557 Your sorting options are:
5558 <P>
5559 <UL>
5560  <LI> <A HREF="h_index_sort_arrival">A</A>rrival
5561  <LI> <A HREF="h_index_sort_date">D</A>ate
5562  <LI> <A HREF="h_index_sort_subj">S</A>ubject
5563  <LI> <A HREF="h_index_sort_ordsubj">O</A>rderedSubject
5564  <LI> t<A HREF="h_index_sort_thread">H</A>read
5565  <LI> <A HREF="h_index_sort_from">F</A>rom
5566  <LI> si<A HREF="h_index_sort_size">Z</A>e
5567  <LI> scor<A HREF="h_index_sort_score">E</A>,
5568  <LI> <A HREF="h_index_sort_to">T</A>o
5569  <LI> <A HREF="h_index_sort_cc">C</A>c
5570 </UL>
5571
5572 <P>
5573 The Reverse option will toggle the order the index is currently
5574 sorted by, but will not change the relative sort order.
5575
5576 <P>
5577 Sorting a folder does not actually rearrange the way the folder is saved,
5578 it just re-arranges how the messages are presented to you.  This means
5579 that Alpine has to do the work of sorting every time you change sort order.
5580 Sometimes, especially with PC-Alpine or with large folders, this could take
5581 a while.
5582
5583 <P>
5584 &lt;End of help on this topic&gt;
5585 </BODY>
5586 </HTML>
5587 ======= h_index_sort_default =======
5588 <HTML>
5589 <HEAD>
5590 <TITLE>SORT OPTION: Default</TITLE>
5591 </HEAD>
5592 <BODY>
5593 <H1>SORT OPTION: Default</H1>
5594
5595 The <EM>Default</EM> sort option just means to use the default sort order
5596 set in the
5597 <li><a href="h_config_sort_key"><!--#echo var="VAR_sort-key"--></a>
5598 option in Setup/Config.
5599
5600 <P>
5601 &lt;End of help on this topic&gt;
5602 </BODY>
5603 </HTML>
5604 ======= h_index_sort_arrival =======
5605 <HTML>
5606 <HEAD>
5607 <TITLE>SORT OPTION: Arrival</TITLE>
5608 </HEAD>
5609 <BODY>
5610 <H1>SORT OPTION: Arrival</H1>
5611
5612 The <EM>Arrival</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX
5613 in the order that they exist in the folder.  This is usually the same as the
5614 order in which they arrived.  This option is comparable to not sorting
5615 the messages at all.
5616
5617 <P>
5618 &lt;End of help on this topic&gt;
5619 </BODY>
5620 </HTML>
5621 ======= h_index_sort_date =======
5622 <HTML>
5623 <HEAD>
5624 <TITLE>SORT OPTION: Date</TITLE>
5625 </HEAD>
5626 <BODY>
5627 <H1>SORT OPTION: Date</H1>
5628
5629 The <EM>Date</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX
5630 according to the date and time they were
5631 sent.
5632
5633 <P>
5634 On a folder like INBOX, sorting by &quot;Date&quot; should be almost
5635 identical to sorting by &quot;Arrival&quot;.
5636
5637 <P>
5638 &lt;End of help on this topic&gt;
5639 </BODY>
5640 </HTML>
5641 ======= h_index_sort_subj =======
5642 <HTML>
5643 <HEAD>
5644 <TITLE>SORT OPTION: Subject</TITLE>
5645 </HEAD>
5646 <BODY>
5647 <H1>SORT OPTION: Subject</H1>
5648
5649 The <EM>Subject</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX
5650 by subject.
5651
5652 <P>
5653 Messages with the same subject are
5654 first grouped together, and then the groups of like-subject messages
5655 are arranged alphabetically.
5656
5657 <P>
5658 Alpine ignores leading &quot;Re:&quot; and
5659 &quot;re:&quot; and trailing &quot;(fwd)&quot; when determining the
5660 likeness and alphabetical order of subject lines.
5661
5662 <P>
5663 &lt;End of help on this topic&gt;
5664 </BODY>
5665 </HTML>
5666 ======= h_index_sort_ordsubj =======
5667 <HTML>
5668 <HEAD>
5669 <TITLE>SORT OPTION: OrderedSubject</TITLE>
5670 </HEAD>
5671 <BODY>
5672 <H1>SORT OPTION: OrderedSubject</H1>
5673
5674 The <EM>OrderedSubject</EM> sort option arranges messages in the
5675 MESSAGE&nbsp;INDEX by grouping all messages with the same subject
5676 together, similar to sort by <A HREF="h_index_sort_subj">S</A>ubject.
5677
5678 <P>
5679 However, <EM>OrderedSubj</EM> then arranges the groups of like-subject
5680 messages by the date of the oldest message in the group.
5681
5682 <P>
5683 This sort method provides for pseudo threading of conversations within
5684 a folder.
5685 You may want to try sorting by Thread instead.
5686
5687 <P>
5688 &lt;End of help on this topic&gt;
5689 </BODY>
5690 </HTML>
5691 ======= h_index_sort_thread =======
5692 <HTML>
5693 <HEAD>
5694 <TITLE>SORT OPTION: Thread</TITLE>
5695 </HEAD>
5696 <BODY>
5697 <H1>SORT OPTION: Thread</H1>
5698
5699 The <EM>Thread</EM> sort option arranges messages in the
5700 MESSAGE&nbsp;INDEX by grouping all messages that indicate
5701 they are part of a conversation (discussion thread) taking
5702 place within a mailbox or newsgroup.  This indication is
5703 based on information in the message's header -- specifically
5704 its <tt>References:</tt>, <tt>Message-ID:</tt>, and <tt>Subject:</tt> fields.
5705
5706 <P>
5707 &lt;End of help on this topic&gt;
5708 </BODY>
5709 </HTML>
5710 ======= h_index_sort_from =======
5711 <HTML>
5712 <HEAD>
5713 <TITLE>SORT OPTION: From</TITLE>
5714 </HEAD>
5715 <BODY>
5716 <H1>SORT OPTION: From</H1>
5717
5718 The <EM>From</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX
5719 by the name of the author of the message.
5720
5721 <P>
5722 Messages with the same author are grouped together. Groups of
5723 messages are then put into alphabetical order according to message
5724 author.
5725
5726 <P>
5727 &lt;End of help on this topic&gt;
5728 </BODY>
5729 </HTML>
5730 ======= h_index_sort_size =======
5731 <HTML>
5732 <HEAD>
5733 <TITLE>SORT OPTION: Size</TITLE>
5734 </HEAD>
5735 <BODY>
5736 <H1>SORT OPTION: Size</H1>
5737
5738 The <EM>Size</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX
5739 by their relative sizes.
5740
5741 <P>
5742 &lt;End of help on this topic&gt;
5743 </BODY>
5744 </HTML>
5745 ======= h_index_sort_score =======
5746 <HTML>
5747 <HEAD>
5748 <TITLE>SORT OPTION: Score</TITLE>
5749 </HEAD>
5750 <BODY>
5751 <H1>SORT OPTION: Score</H1>
5752
5753 The <EM>Score</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX
5754 by their scores.
5755
5756 <P>
5757 Messages with the same score are sorted in arrival order.
5758 Scores are something you create using the
5759 <A HREF="h_rules_score">&quot;SETUP SCORING&quot;</A> screen.
5760
5761 <P>
5762 &lt;End of help on this topic&gt;
5763 </BODY>
5764 </HTML>
5765 ======= h_index_sort_to =======
5766 <HTML>
5767 <HEAD>
5768 <TITLE>SORT OPTION: To</TITLE>
5769 </HEAD>
5770 <BODY>
5771 <H1>SORT OPTION: To</H1>
5772
5773 The <EM>To</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX
5774 by the names of the recipients of the message.
5775
5776 <P>
5777 Messages with the same recipients are grouped together. Groups of
5778 messages are then put into alphabetical order according to message
5779 recipients.
5780
5781 <P>
5782 &lt;End of help on this topic&gt;
5783 </BODY>
5784 </HTML>
5785 ======= h_index_sort_cc =======
5786 <HTML>
5787 <HEAD>
5788 <TITLE>SORT OPTION: Cc</TITLE>
5789 </HEAD>
5790 <BODY>
5791 <H1>SORT OPTION: Cc</H1>
5792
5793 The <EM>Cc</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX by
5794 the names of the carbon copy addresses of the message.
5795
5796 <P>
5797 &lt;End of help on this topic&gt;
5798 </BODY>
5799 </HTML>
5800 ======= h_index_cmd_whereis =======
5801 <HTML>
5802 <HEAD>
5803 <TITLE>WhereIs Command</TITLE>
5804 </HEAD>
5805 <BODY>
5806 <H1>WhereIs Command</H1>
5807
5808 The WhereIs
5809 (<!--chtml if pinemode="function_key"-->F8<!--chtml else-->W<!--chtml endif-->)
5810 command lets you search the MESSAGE INDEX for a word.
5811 It scans through whatever you see, usually the name of the author
5812 and the Subject line.
5813 WhereIs has special subcommands to let you find the beginning of the
5814 index (Ctrl-Y -- first message)
5815 or the end of the index (Ctrl-V -- last message).
5816 <P>
5817 Note that WhereIs only searches through the visible text on the screen.
5818 For example, if only part of the Subject of a message is shown because it
5819 is long, then only the visible portion of the Subject is searched.
5820 Also note that WhereIs does not &quot;see&quot; the
5821 &quot;X&quot; in column one of Index entries for selected messages
5822 so it can't be used to search for
5823 selected messages (use &quot;Zoom&quot; instead).
5824 <P>
5825 If the feature
5826 <A HREF="h_config_enable_agg_ops">&quot;<!--#echo var="FEAT_enable-aggregate-command-set"-->&quot;</A>
5827 is turned on,
5828 WhereIs can also be used as a quick way to select messages that match the
5829 string being searched for.
5830 Instead of typing carriage return to search for the next match, type
5831 Ctrl-X to select all matches.
5832 Once again, this only selects matches that are (or would be if the right
5833 index line was on the screen) visible.
5834 Truncated From lines or Subjects will cause matches to be missed.
5835 Although WhereIs is sometimes convenient for quick matching, the Select
5836 command is usually more powerful and usually faster.
5837
5838 <P>
5839 &lt;End of help on this topic&gt;
5840 </BODY>
5841 </HTML>
5842 ======= h_view_cmd_whereis =======
5843 <HTML>
5844 <HEAD>
5845 <TITLE>WhereIs Command</TITLE>
5846 </HEAD>
5847 <BODY>
5848 <H1>WhereIs Command</H1>
5849
5850 The WhereIs
5851 (<!--chtml if pinemode="function_key"-->F8<!--chtml else-->W<!--chtml endif-->)
5852 command does a &quot;find in current message&quot; operation.  You
5853 type in text and Alpine will try to find it in the message you are
5854 reading.  WhereIs also has subcommands to jump to the beginning (Ctrl-Y)
5855 or end (Ctrl-V) of the message.
5856 That is, to rapidly move to the end of a message, hit the
5857 <!--chtml if pinemode="function_key"-->F8<!--chtml else-->W<!--chtml endif-->
5858 (or Ctrl-W) key followed
5859 by Ctrl-V.  Similarly,
5860 <!--chtml if pinemode="function_key"-->F8<!--chtml else-->W<!--chtml endif-->
5861 followed by Ctrl-Y will take you to the beginning of a message.
5862
5863 <P>
5864 &lt;End of help on this topic&gt;
5865 </BODY>
5866 </HTML>
5867 ======= h_view_cmd_hilite =======
5868 <HTML>
5869 <HEAD>
5870 <TITLE>View Hilite and Next item/Previous item</TITLE>
5871 </HEAD>
5872 <BODY>
5873 <H1>View Hilite and Next item/Previous item</H1>
5874
5875 Sometimes messages may be in the form of formatted HTML text
5876 or they may contain URLs or Web server hostnames.
5877 When any of the features
5878 <A HREF="h_config_enable_view_url">&quot;<!--#echo var="FEAT_enable-msg-view-urls"-->&quot;</A>,
5879 <A HREF="h_config_enable_view_web_host">&quot;<!--#echo var="FEAT_enable-msg-view-web-hostnames"-->&quot;</A>,
5880 <A HREF="h_config_enable_view_attach">&quot;<!--#echo var="FEAT_enable-msg-view-attachments"-->&quot;</A>,
5881 or
5882 <A HREF="h_config_enable_view_addresses">&quot;<!--#echo var="FEAT_enable-msg-view-addresses"-->&quot;</A>
5883 are enabled, Alpine will represent such selectable items in the text
5884 in bold typeface.  One of the selectable items will be displayed in
5885 inverse video (highlighted).  This is the &quot;currently selected&quot; item.
5886 Press the Return key to view the currently selected item.
5887 <P>
5888
5889 The Up and Down Arrows keys can be used to change the selected item
5890 (also see the feature
5891 <A HREF="h_config_enable_view_arrows">&quot;<!--#echo var="FEAT_enable-msg-view-forced-arrows"-->&quot;</A>).
5892 If there are no selectable items in the direction of the arrow you
5893 pressed, Alpine will scroll the display in that direction until one
5894 becomes visible.  To &quot;jump&quot; forwards/backwards among selectable
5895 items in the message text, use the Previous and Next item commands,
5896 <!--chtml if pinemode="function_key"-->F5 and F6
5897 <!--chtml else-->^B and ^F<!--chtml endif-->.
5898
5899 <P>
5900 &lt;End of help on this topic&gt;
5901 </BODY>
5902 </HTML>
5903 ======= h_view_cmd_viewattch =======
5904 <HTML>
5905 <HEAD>
5906 <TITLE>ViewAttch Command</TITLE>
5907 </HEAD>
5908 <BODY>
5909 <H1>ViewAttch Command</H1>
5910
5911
5912 The View/Save Attachment
5913 (<!--chtml if pinemode="function_key"-->F4<!--chtml else-->V<!--chtml endif-->)
5914 command allows you to handle MIME attachments to a message you have
5915 received.  Alpine shows you a list of the message attachments -- you just
5916 choose the attachment you want.  You may either view or save the
5917 selected attachment.
5918
5919 <P>
5920 Because many attachments require external programs for display, there
5921 is some system configuration that has to happen before you can
5922 actually display attachments.  Hopefully much of that will have been
5923 done already by your system administrator.  MIME configuration is
5924 handled with the &quot;mailcap&quot; configuration file.  (See the section
5925 on configuration in the
5926 <A HREF="h_news">release notes</A> for more information.)
5927
5928 <P>
5929 &lt;End of help on this topic&gt;
5930 </BODY>
5931 </HTML>
5932 ======= h_index_cmd_expunge =======
5933 <HTML>
5934 <HEAD>
5935 <TITLE>Expunge/Exclude Command</TITLE>
5936 </HEAD>
5937 <BODY>
5938 <H1>Expunge/Exclude Command</H1>
5939
5940 Expunge/Exclude
5941 (<!--chtml if pinemode="function_key"-->F3<!--chtml else-->X<!--chtml endif-->)
5942 is the command Alpine uses to actually remove all messages
5943 marked for deletion.  With regular email files, expunge literally deletes
5944 the text from the current folder.  With newsgroups or shared mailboxes,
5945 you don't have permission to actually remove the message, so it is an
5946 exclude -- Alpine removes the message from your view of the folder even
5947 though it is not technically gone.
5948
5949 <P> A selective expunge command is available in IMAP folders that support
5950 the UID EXPUNGE extension in <A
5951 HREF="http://tools.ietf.org/html/rfc4315">RFC 4315</A> as well as for all
5952 other folders (local folders in all formats, POP3 inbox, and newsgroups)
5953 as a subcommand of the apply command. If some selected messages are marked
5954 deleted, then the apply command will offer the eXpunge command, which when
5955 executed will only expunge those messages that are selected and deleted.
5956
5957 <P>
5958 Observe that the expunge command (when not used from the apply command)
5959 will expunge/exclude all deleted messages from the folder, and so all
5960 messages marked deleted will be expunged, regardless of if they are
5961 selected or not. In other words, there is no protection against
5962 potentially expunging more messages than only those that have been
5963 selected and deleted.
5964 <P>
5965
5966 The configuration features
5967 <A HREF="h_config_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm"-->&quot;</A>
5968 and
5969 <A HREF="h_config_full_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm-everywhere"-->&quot;</A>
5970 affect the behavior of the Expunge command.
5971
5972 <P>
5973 &lt;End of help on this topic&gt;
5974 </BODY>
5975 </HTML>
5976 ======= h_common_compose =======
5977 <HTML>
5978 <HEAD>
5979 <TITLE>Compose Command</TITLE>
5980 </HEAD>
5981 <BODY>
5982 <H1>Compose Command</H1>
5983
5984 The Compose command takes you into the Alpine message composer where you
5985 can start a new message for sending.  This is where you type in the
5986 message's text and specify its recipient list (the &quot;To:&quot;
5987 address), where copies should be directed (e.g., &quot;Fcc&quot;,
5988 &quot;Cc:&quot; or &quot;Bcc:&quot;), and which files, if any, should
5989 be attached to the message.
5990
5991 <P>
5992 When you type this command, Alpine will also automatically check for any
5993 interrupted (i.e., a message that was being composed when your modem
5994 or network connection was broken) or previously postponed messages and
5995 offer you a chance to continue working on those.
5996
5997 <P>
5998 <UL>
5999 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
6000 </UL><P>
6001 &lt;End of help on this topic&gt;
6002 </BODY>
6003 </HTML>
6004 ======= h_common_index =======
6005 <HTML>
6006 <HEAD>
6007 <TITLE>Message Index Command</TITLE>
6008 </HEAD>
6009 <BODY>
6010 <H1>Message Index Command</H1>
6011
6012 The Index command takes you to the MESSAGE INDEX screen that displays a
6013 summary caption for each message in the currently-open folder. One
6014 message will be highlighted; this is the &quot;Current&quot; message.
6015 The message commands available from this screen (e.g. View, Reply,
6016 Forward, Delete, Print, Save, etc) apply to the current message.
6017
6018 <P>
6019 &lt;End of help on this topic&gt;
6020 </BODY>
6021 </HTML>
6022 ======= h_common_folders =======
6023 <HTML>
6024 <HEAD>
6025 <TITLE>Folder List Command</TITLE>
6026 </HEAD>
6027 <BODY>
6028 <H1>Folder List Command</H1>
6029
6030 This Folder List command takes you to the FOLDER LIST screen that displays
6031 the names of all your message folders and allows you to view, rename,
6032 delete, and add folders.  You can open (view) a different folder than the
6033 one currently open by highlighting the desired one (using the arrow keys
6034 or their control-key equivalents) and pressing RETURN.
6035
6036 <P>
6037 If you have multiple folder collections defined (see the Help text for
6038 the FOLDER LIST screen to learn more about Collections), you may need
6039 to press Return to expand the collection and display all of the
6040 folders in it.
6041
6042 <P>
6043 &lt;End of help on this topic&gt;
6044 </BODY>
6045 </HTML>
6046 ======= h_main_addrbook =======
6047 <HTML>
6048 <HEAD>
6049 <TITLE>Address Book Command</TITLE>
6050 </HEAD>
6051 <BODY>
6052 <H1>Address Book Command</H1>
6053
6054 This command, available only from the MAIN MENU, takes you
6055 to the ADDRESS BOOK management screen.  From here, your personal address
6056 book(s) may be updated.
6057
6058 <P>
6059 &lt;End of help on this topic&gt;
6060 </BODY>
6061 </HTML>
6062 ======= h_main_setup =======
6063 <HTML>
6064 <HEAD>
6065 <TITLE>Setup Command</TITLE>
6066 </HEAD>
6067 <BODY>
6068 <H1>Setup Command</H1>
6069
6070 The Setup command, available only from the MAIN MENU, prompts you for
6071 one of several configuration screens, including the SETUP CONFIGURATION
6072 screen, by which you may activate optional Alpine features.
6073
6074 <P>
6075 &lt;End of help on this topic&gt;
6076 </BODY>
6077 </HTML>
6078 ======= h_main_release_notes =======
6079 <HTML>
6080 <HEAD>
6081 <TITLE>Release Notes Command</TITLE>
6082 </HEAD>
6083 <BODY>
6084 <H1>Release Notes Command</H1>
6085
6086 This command displays information about Alpine <!--#echo var="ALPINE_VERSION"-->,
6087 as well as pointers to further information such as history and legal notes.
6088
6089 <P>
6090 &lt;End of help on this topic&gt;
6091 </BODY>
6092 </HTML>
6093 ======= h_main_kblock =======
6094 <HTML>
6095 <HEAD>
6096 <TITLE>Keyboard Lock Command</TITLE>
6097 </HEAD>
6098 <BODY>
6099 <H1>Keyboard Lock Command</H1>
6100
6101 This command allows your Alpine session to be protected
6102 during a temporary absence from your terminal.
6103
6104 <P>
6105 &lt;End of help on this topic&gt;
6106 </BODY>
6107 </HTML>
6108 ======= h_main_journal =======
6109 <HTML>
6110 <HEAD>
6111 <TITLE>Journal Command</TITLE>
6112 </HEAD>
6113 <BODY>
6114 <H1>Journal Command</H1>
6115
6116 This command displays a list of all the status messages Alpine has
6117 displayed (on the third line from the bottom of the screen). This may
6118 be useful if a message disappeared before you had a chance to read it.
6119
6120 <P>
6121 &lt;End of help on this topic&gt;
6122 </BODY>
6123 </HTML>
6124 ======= h_common_role =======
6125 <HTML>
6126 <HEAD>
6127 <TITLE>Role Command</TITLE>
6128 </HEAD>
6129 <BODY>
6130 <H1>Role Command</H1>
6131
6132 The Role command is similar to the Compose command except that it starts
6133 off by letting you select a <A HREF="h_rules_roles">role</A>
6134 to be used for the composition.
6135 You may set up alternate roles by using Setup/Rules/Roles.
6136
6137 <P>
6138 &lt;End of help on this topic&gt;
6139 </BODY>
6140 </HTML>
6141 ======= h_common_conditional_cmds =======
6142 <HTML>
6143 <HEAD>
6144 <TITLE>Conditional Commands</TITLE>
6145 </HEAD>
6146 <BODY>
6147 <H1>Conditional Commands</H1>
6148
6149 The presence or absence of certain commands, particularly in the
6150 MESSAGE INDEX and MESSAGE TEXT screens, is determined by
6151 whether or not specific features are set in your Alpine configuration.
6152 (You can access the SETUP CONFIGURATION screen, where they are found, from
6153 Alpine's MAIN MENU.)  To see if a desired command's availability is
6154 conditioned on a feature setting, see the command's help text (highlight
6155 the phrase associated with the command and hit Return).
6156
6157 <P>
6158 Also note that some
6159 commands may be administratively disabled by your system manager;
6160 if they don't work, please check with your local help desk.
6161
6162 <P>
6163 <UL>
6164 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
6165 </UL><P>
6166 &lt;End of help on this topic&gt;
6167 </BODY>
6168 </HTML>
6169 ======= h_common_pipe =======
6170 <HTML>
6171 <HEAD>
6172 <TITLE>Pipe Command</TITLE>
6173 </HEAD>
6174 <BODY>
6175 <H1>Pipe Command</H1>
6176
6177 Pipe
6178 (<!--chtml if pinemode="function_key"-->F12<!--chtml else-->|<!--chtml endif-->)
6179 allows you to send a message to a specified Unix command for external
6180 processing.
6181 This command's availability is controlled by the
6182 <A HREF="h_config_enable_pipe">&quot;<!--#echo var="FEAT_enable-unix-pipe-cmd"-->&quot;</A>
6183 feature.
6184 By default, the processed text of the message is sent to the command
6185 you specify and the output is captured by Alpine and shown to you.
6186 When you run the pipe command, there are some sub-commands which may be
6187 used to alter this behavior.
6188 These sub-commands are described <A HREF="h_pipe_command">here</A>.
6189
6190 <P>
6191 &lt;End of help on this topic&gt;
6192 </BODY>
6193 </HTML>
6194 ======= h_common_goto =======
6195 <HTML>
6196 <HEAD>
6197 <TITLE>Goto Command</TITLE>
6198 </HEAD>
6199 <BODY>
6200 <H1>Goto Command</H1>
6201
6202 Goto
6203 (<!--chtml if pinemode="function_key"-->F6<!--chtml else-->G<!--chtml endif-->)
6204 is the command that lets you bypass Alpine's folder selection screens
6205 and jump directly to a new folder.  You can select any folder in the
6206 world: one in your current collection, one in a different collection or
6207 one in a collection you've never even used before.
6208 <P>
6209
6210 Alpine will help you as much as possible to narrow in on the folder you want.
6211 However, if the folder is outside of your defined collections, you are
6212 going to have to enter the exact folder location using the correct
6213 <A HREF="h_valid_folder_names">syntax</A>
6214 for a remote folder and/or fully-qualified path name.
6215
6216 <P>
6217 &lt;End of help on this topic&gt;
6218 </BODY>
6219 </HTML>
6220 ======= h_common_nextnew =======
6221 <HTML>
6222 <HEAD>
6223 <TITLE>NextNew Command</TITLE>
6224 </HEAD>
6225 <BODY>
6226 <H1>NextNew Command</H1>
6227
6228 When you press the TAB key, Alpine advances to the next
6229 &quot;interesting&quot; message.
6230 This will be the next message you have not seen before, or the next message
6231 you have flagged Important, whichever comes first.
6232 Unread messages that have been deleted are not considered interesting.
6233 (A note about reading news. Alpine expects you to &quot;Delete&quot; news
6234 articles after you have read them if you want to remove them from future
6235 consideration. See <A HREF="h_mainhelp_readingnews">Reading News</A> for
6236 more information.)
6237
6238 <P>
6239 The NextNew command is affected by the feature
6240 <A HREF="h_config_tab_new_only">&quot;<!--#echo var="FEAT_tab-visits-next-new-message-only"-->&quot;</A>,
6241 which causes Alpine to only consider Unread messages interesting, not messages
6242 flagged Important.
6243
6244 <P>
6245 This command behaves a little differently when it finds there are no more
6246 interesting messages left in the current folder.
6247 If the current folder is one of your Incoming Message Folders
6248 (<A HREF="h_config_enable_incoming">&quot;<!--#echo var="FEAT_enable-incoming-folders"-->&quot;</A>)
6249 or it is a newsgroup, then Alpine will try to find the next folder or
6250 newsgroup that contains <EM>Recent</EM> messages and will ask you
6251 if you want to open that folder.
6252 This behavior may be modified by using the
6253 <A HREF="h_config_tab_uses_unseen">&quot;<!--#echo var="FEAT_tab-uses-unseen-for-next-folder"-->&quot;</A>
6254 feature that causes Alpine to look for Unseen messages instead of Recent
6255 messages.
6256 The NextNew command's behavior is also affected by the configuration features
6257 <A HREF="h_config_auto_open_unread">&quot;<!--#echo var="FEAT_auto-open-next-unread"-->&quot;</A>,
6258 and
6259 <A HREF="h_config_tab_no_prompt">&quot;<!--#echo var="FEAT_continue-tab-without-confirm"-->&quot;</A>.
6260
6261 <P>
6262 &lt;End of help on this topic&gt;
6263 </BODY>
6264 </HTML>
6265 ======= h_common_jump =======
6266 <HTML>
6267 <HEAD>
6268 <TITLE>Jump Command</TITLE>
6269 </HEAD>
6270 <BODY>
6271 <H1>Jump Command</H1>
6272
6273 This is Alpine's way of allowing you to go straight to a specific message.
6274 Just press &quot;J&quot; and then enter the message number.  By default, Alpine is also
6275 configured such that typing in any number automatically jumps you to that
6276 message
6277 (<A HREF="h_config_enable_jump">&quot;<!--#echo var="FEAT_enable-jump-shortcut"-->&quot;</A>
6278 in the SETUP CONFIGURATION).
6279
6280 <P>
6281 &lt;End of help on this topic&gt;
6282 </BODY>
6283 </HTML>
6284 ======= h_common_flag =======
6285 <HTML>
6286 <HEAD>
6287 <TITLE>Flag Command</TITLE>
6288 </HEAD>
6289 <BODY>
6290 <H1>Flag Command</H1>
6291
6292 Flag
6293 (<!--chtml if pinemode="function_key"-->F11<!--chtml else-->*<!--chtml endif-->)
6294 is the command that allows users to manipulate the status flags that
6295 appear on the left side of the MESSAGE INDEX screen.  The most common
6296 use of this is to mark a message as important. This is something of a
6297 note to yourself to get back to that message.  You may also use the
6298 flag command to set (or unset) the flags that indicate that a message
6299 is new, answered, deleted, or forwarded.<P>
6300
6301 Provided the mail server supports it,
6302 you may also manipulate user-defined keywords
6303 for a message using the flag command.
6304 These keywords will be available if you use the Flag Details screen that you
6305 can get to after typing the
6306 Flag (<!--chtml if pinemode="function_key"-->F11<!--chtml else-->*<!--chtml endif-->)
6307 command.
6308 They will be listed after the Important, New, Answered, Deleted , and Forwarded flags,
6309 which are always present.
6310 You may add new keywords by using the Add KW command from the Flag Details screen
6311 or by defining them in the <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in the Setup/Config screen.
6312
6313 The availability of the flag command is determined by the
6314 <A HREF="h_config_enable_flag">&quot;<!--#echo var="FEAT_enable-flag-cmd"-->&quot;</A>
6315 feature in your Alpine configuration. Also, it is possible that Flag could be
6316 administratively disabled by your system manager; if it doesn't work,
6317 please check with your local help desk before reporting a bug.
6318 The behavior of the flag command may be modified by the
6319 <A HREF="h_config_flag_screen_default">&quot;<!--#echo var="FEAT_enable-flag-screen-implicitly"-->&quot;</A> option or the
6320 <A HREF="h_config_flag_screen_kw_shortcut">&quot;<!--#echo var="FEAT_enable-flag-screen-keyword-shortcut"-->&quot;</A> option.
6321
6322 <P>
6323 &lt;End of help on this topic&gt;
6324 </BODY>
6325 </HTML>
6326 ======= h_common_hdrmode =======
6327 <HTML>
6328 <HEAD>
6329 <TITLE>HdrMode Command</TITLE>
6330 </HEAD>
6331 <BODY>
6332 <H1>HdrMode Command</H1>
6333
6334 Every email message comes with some header lines that you normally
6335 don't see (and don't want to see).
6336 These include anywhere from 3-20 lines (or more) added by the
6337 Internet mail transport system to record the route your message took,
6338 for diagnostic purposes.
6339 These are normally of no import and simply
6340 add clutter, so Alpine suppresses them in the MESSAGE TEXT display.
6341 This also includes other non-standard headers the message may contain.
6342 If you want to see these headers, there is a way to reveal them.
6343 <P>
6344
6345 The Header Mode
6346 (<!--chtml if pinemode="function_key"-->F9<!--chtml else-->H<!--chtml endif-->)
6347 command is a toggle that controls Alpine's handling of these header
6348 lines.  Normally, full headers is &quot;off&quot; and you only see a
6349 few lines about who a message is to and who it is from.  When you
6350 press
6351 (<!--chtml if pinemode="function_key"-->F9<!--chtml else-->H<!--chtml endif-->)
6352 to turn full headers on, Alpine will show you
6353 the normal header lines as well as delivery headers, comment headers,
6354 MIME headers, and any other headers present.
6355 <P>
6356
6357 Several different Alpine commands honor the header mode -- it affects how
6358 messages are displayed, how they appear in forward and reply email, how
6359 they are printed, how they are saved, and how they are exported.
6360 <!--chtml if pinemode="os_windows"-->
6361 <!--chtml else-->
6362 The pipe command is also affected.
6363 <!--chtml endif-->
6364 <P>
6365
6366 The presence or absence of the Header Mode command is determined by the
6367 <A HREF="h_config_enable_full_hdr">&quot;<!--#echo var="FEAT_enable-full-header-cmd"-->&quot;</A>
6368 Feature-List option in your Alpine configuration.
6369
6370 <P>
6371 If you have also turned on the
6372 <A HREF="h_config_quote_suppression">&quot;Quote Suppression&quot;</A>
6373 option then the HdrMode command actually rotates through three states
6374 instead of just two.
6375 The first is the normal view with long quotes suppressed.
6376 The second is the normal view but with the long quotes included.
6377 The last enables the display of all headers in the message.
6378 When using Export, Pipe, Print, Forward, or Reply the quotes are
6379 never suppressed, so the first two states are identical.
6380
6381 <P>
6382 The behavior of the Header Mode command may be altered slightly by
6383 turning on the
6384 <A HREF="h_config_quell_full_hdr_reset">&quot;<!--#echo var="FEAT_quell-full-header-auto-reset"-->&quot;</A>
6385 Feature-List option in your Alpine configuration.
6386 In particular, it will cause the Header Mode to be persistent when moving
6387 from message to message instead of resetting to the default for each message.
6388
6389 <P>
6390 <UL>
6391 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
6392 </UL><P>
6393 &lt;End of help on this topic&gt;
6394 </BODY>
6395 </HTML>
6396 ======= h_common_print =======
6397 <HTML>
6398 <HEAD>
6399 <TITLE>Print Command</TITLE>
6400 </HEAD>
6401 <BODY>
6402 <H1>Print Command</H1>
6403
6404 The Print
6405 (<!--chtml if pinemode="function_key"-->F9<!--chtml else-->%<!--chtml endif-->)
6406 command allows you to print a copy of a message.
6407 There are many SETUP CONFIGURATION features that affect the
6408 Print command, including
6409 <A HREF="h_config_enable_y_print">&quot;<!--#echo var="FEAT_enable-print-via-y-command"-->&quot;</A>,
6410 <A HREF="h_config_print_index">&quot;<!--#echo var="FEAT_print-index-enabled"-->&quot;</A>,
6411 <A HREF="h_config_custom_print">&quot;<!--#echo var="FEAT_print-offers-custom-cmd-prompt"-->&quot;</A>,
6412 <A HREF="h_config_print_from">&quot;<!--#echo var="FEAT_print-includes-from-line"-->&quot;</A>, and
6413 <A HREF="h_config_ff_between_msgs">&quot;<!--#echo var="FEAT_print-formfeed-between-messages"-->&quot;</A>.
6414 You set up for printing by using the Printer option of the Setup command
6415 on the MAIN MENU.
6416 <P>
6417
6418 <P>
6419 &lt;End of help on this topic&gt;
6420 </BODY>
6421 </HTML>
6422 ======= h_common_take =======
6423 <HTML>
6424 <HEAD>
6425 <TITLE>TakeAddr Command</TITLE>
6426 </HEAD>
6427 <BODY>
6428 <H1>TakeAddr Command</H1>
6429
6430
6431 With the Take Address
6432 (<!--chtml if pinemode="function_key"-->F10<!--chtml else-->T<!--chtml endif-->)
6433 command, you can extract email addresses from an
6434 incoming message and save them in an address book.  This is an easy way
6435 to add to your address book and avoid having to remember the email
6436 addresses of the people who write to you.
6437 <P>
6438
6439 If the message is just to you individually, then you will only need to
6440 provide a nickname.  If the message contains more than one email address,
6441 then you will see an address
6442 selection screen that lets you choose the address you want to save into
6443 your address book, or lets you choose several of them add to a
6444 personal distribution list.
6445 <P>
6446
6447 Once you've added an entry to your address book, you can use it from the
6448 message composer by typing the nickname of the entry into one of the
6449 header fields (for example, into the To: field), or you can use ^T from
6450 the header field to select the entry from your address book.
6451 <P>
6452
6453 If the configuration feature
6454 <A HREF="h_config_enable_role_take">&quot;<!--#echo var="FEAT_enable-rules-under-take"-->&quot;</A>
6455 is set, the behavior of the Take command is altered slightly.
6456
6457 <P>
6458 &lt;End of help on this topic&gt;
6459 </BODY>
6460 </HTML>
6461 ======= h_ge_import =======
6462 <HTML>
6463 <HEAD>
6464 <TITLE>Import File Selection</TITLE>
6465 </HEAD>
6466 <BODY>
6467 <H1>Import File Selection</H1>
6468
6469 You are importing a file that you previously
6470 exported from Alpine.
6471 You are now being asked for the name of that file.
6472 The easiest way to select a file is probably with the &quot;^T&quot;
6473 &quot;To Files&quot; command.
6474 Alternatively, you may type in a file name.
6475 It may be an absolute pathname.
6476 Otherwise, it is a file located in your home directory
6477 or current working directory
6478 <!--chtml if pinemode="running"-->
6479 (which, at least for your current Alpine &quot;session,&quot;
6480 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
6481 <!--chtml endif-->, depending on the
6482 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A> option.
6483 In any case, you finish by typing a carriage return to accept the
6484 file name that is displayed.
6485 When the feature
6486 <A HREF="h_config_enable_tab_complete">&quot;<!--#echo var="FEAT_enable-tab-completion"-->&quot;</A>
6487 is turned on you may use TAB to complete partially typed in names.
6488 <P>
6489 You may cancel the import operation by typing &quot;^C&quot; after exiting
6490 this help.
6491 <P>
6492 &lt;End of help on this topic&gt;
6493 </BODY>
6494 </HTML>
6495 ======= h_ge_allparts =======
6496 <HTML>
6497 <HEAD>
6498 <TITLE>Export Message File Selection</TITLE>
6499 </HEAD>
6500 <BODY>
6501 <H1>Export Message File Selection</H1>
6502
6503 You are Exporting a message from an Alpine mail folder
6504 to a plain text file.
6505 You also have the option of exporting all of the attachments associated
6506 with the message.
6507 You are now being asked for the name of the file to export <EM>to</EM>.
6508 The easiest way to select a file is probably with the &quot;^T&quot;
6509 &quot;To Files&quot; subcommand.
6510 After returning from that subcommand you will still be allowed to
6511 edit the name you have selected.
6512 Alternatively, you may type in a file name.
6513 It may be an absolute pathname.
6514 Otherwise, it is a file located in your home directory
6515 or current working directory
6516 <!--chtml if pinemode="running"-->
6517 (which, at least for your current Alpine &quot;session,&quot;
6518 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
6519 <!--chtml endif-->, depending on the
6520 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A> option.
6521 In any case, you finish by typing a carriage return to accept the
6522 file name that is displayed.
6523 When the feature
6524 <A HREF="h_config_enable_tab_complete">&quot;<!--#echo var="FEAT_enable-tab-completion"-->&quot;</A>
6525 is turned on you may use TAB to complete partially typed in names.
6526 <P>
6527 The message you are exporting appears to have some attachments.
6528 If you wish to save <EM>all</EM> of the attachments at once,
6529 type the &quot;^P&quot; &quot;AllParts&quot; command to turn on
6530 saving of the attachments.
6531 You may turn it back off by typing &quot;^P&quot; again, which will now
6532 be labeled &quot;NoAllParts&quot; instead.
6533 If you want to save the parts the command displayed should be
6534 &quot;NoAllParts&quot;!
6535 When you choose to save attachments like this, the attachments will be saved
6536 in a newly created directory.
6537 That directory will have the same name as the file name you choose here,
6538 with the letters &quot;.d&quot; appended.
6539 If that directory already exists, then the letters &quot;.d_1&quot; will
6540 be tried, then &quot;.d_2&quot; and so on until a name that doesn't exist
6541 is found.
6542 For example, if you select the file name
6543 <P>
6544 <CENTER><SAMP>filename</SAMP></CENTER>
6545 <P>
6546 to export the message to, then the directory used for the attachments will be
6547 <P>
6548 <CENTER><SAMP>filename.d</SAMP></CENTER>
6549 <P>
6550 or perhaps
6551 <P>
6552 <CENTER><SAMP>filename.d_&lt;n&gt;</SAMP></CENTER>
6553 <P>
6554 The attachments will then be put into files inside that directory.
6555 The names for the attachment files will be derived from the attachments
6556 if possible.
6557 This is done in the same way as the default values are derived if you
6558 save them one at a time.
6559 (The &quot;filename&quot; parameter from the Content-Disposition header
6560 is the first choice. If that doesn't exist, the &quot;name&quot;
6561 parameter from the Content-Type header is used.)
6562 If a name for a particular attachment is not available, then the
6563 part number of the attachment is used, with the characters &quot;part_&quot;
6564 prepended.
6565 An example of that would be
6566 <P>
6567 <CENTER><SAMP>part_2.1</SAMP></CENTER>
6568 <P>
6569 If you want to save only some of the attachments or if you want more control
6570 over the directory and filename where an attachment is saved you may
6571 cancel out of this command and View the attachment list.
6572 From there you can save each attachment individually.
6573 <P>
6574 You may cancel the Export operation by typing &quot;^C&quot; after exiting
6575 this help.
6576 <P>
6577 &lt;End of help on this topic&gt;
6578 </BODY>
6579 </HTML>
6580 ======= h_ge_export =======
6581 <HTML>
6582 <HEAD>
6583 <TITLE>Export File Selection</TITLE>
6584 </HEAD>
6585 <BODY>
6586 <H1>Export File Selection</H1>
6587
6588 You are Exporting or Saving something from within the Alpine world
6589 (a message, an attachment, etc.)
6590 to a plain text file.
6591 You are now being asked for the name of the file to export <EM>to</EM>.
6592 The easiest way to select a file is probably with the &quot;^T&quot;
6593 &quot;To Files&quot; subcommand.
6594 After returning from that subcommand you will still be allowed to
6595 edit the name you have selected.
6596 Alternatively, you may type in a file name.
6597 It may be an absolute pathname.
6598 Otherwise, it is a file located in your home directory
6599 or current working directory
6600 <!--chtml if pinemode="running"-->
6601 (which, at least for your current Alpine &quot;session,&quot;
6602 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
6603 <!--chtml endif-->, depending on the
6604 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A> option.
6605 In any case, you finish by typing a carriage return to accept the
6606 file name that is displayed.
6607 When the feature
6608 <A HREF="h_config_enable_tab_complete">&quot;<!--#echo var="FEAT_enable-tab-completion"-->&quot;</A>
6609 is turned on you may use TAB to complete partially typed in names.
6610 <P>
6611 If the object you are exporting is a message with some attachments,
6612 you may wish to save all of the attachments by typing the &quot;^P&quot;
6613 &quot;AllParts&quot; command to turn on saving of the attachments.
6614 This subcommand will only be visible if the message actually has attachments.
6615 You may also View the attachment list and save individual attachments from
6616 there.
6617 <P>
6618 You may cancel the Export operation by typing &quot;^C&quot; after exiting
6619 this help.
6620 <P>
6621 &lt;End of help on this topic&gt;
6622 </BODY>
6623 </HTML>
6624 ======= h_common_save =======
6625 <HTML>
6626 <HEAD>
6627 <TITLE>Save and Export Commands</TITLE>
6628 </HEAD>
6629 <BODY>
6630 <H1>Save and Export Commands</H1>
6631
6632 Save
6633 (<!--chtml if pinemode="function_key"-->F11<!--chtml else-->S<!--chtml endif-->)
6634 and Export
6635 (<!--chtml if pinemode="function_key"-->F12<!--chtml else-->E<!--chtml endif-->)
6636 are the two alternatives Alpine gives you to keep a copy of the message
6637 you are reading. If you want to keep the message within Alpine's email
6638 world, use &quot;Save&quot;; if you want to use the message in another
6639 program, use &quot;Export&quot;.
6640 <P>
6641
6642 When you Save a message, it is put into an existing folder or into a new
6643 folder in one of your existing folder collections.  The message stays in
6644 email format and can be read by Alpine again.  Alpine may use a special format
6645 for its mail folders -- never edit an Alpine folder by hand or with any
6646 program other than Alpine.  The exact behavior of the Save command can be
6647 configured with the
6648 <A HREF="h_config_quote_all_froms">&quot;<!--#echo var="FEAT_save-will-quote-leading-froms"-->&quot;</A>,
6649 <A HREF="h_config_save_wont_delete">&quot;<!--#echo var="FEAT_save-will-not-delete"-->&quot;</A>,
6650 and
6651 <A HREF="h_config_save_advances">&quot;<!--#echo var="FEAT_save-will-advance"-->&quot;</A>
6652 feature list settings.
6653 The name of the folder offered as a default is controlled by the option
6654 <A HREF="h_config_saved_msg_name_rule">&quot;<!--#echo var="VAR_saved-msg-name-rule"-->&quot;</A>.
6655 <P>
6656
6657 When you use Export, the message is placed in a plain text file in your
6658 home directory
6659 <!--chtml if pinemode="running"-->
6660 (which, in the present configuration of your system, is
6661  &quot;<!--#echo var="HOME_DIR"-->&quot;)
6662 <!--chtml endif-->
6663 or current working directory
6664 <!--chtml if pinemode="running"-->
6665 (which, at least for your current Alpine &quot;session,&quot;
6666 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
6667 <!--chtml endif-->, depending on the
6668 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
6669 configuration setting.  In the normal case, only minimal
6670 headers are exported with the message; however, if the full header mode
6671 (whose availability may be disabled  by setting the feature
6672 <A HREF="h_config_enable_full_hdr">&quot;<!--#echo var="FEAT_enable-full-header-cmd"-->&quot;</A>
6673 in SETUP CONFIGURATION) is
6674 toggled on, then complete headers are exported along with the message
6675 text. (If you have any <A HREF="h_config_display_filters"><!--#echo var="VAR_display-filters"--></A>
6676 defined, they may affect the contents of the exported file.)
6677
6678 <P>
6679 &lt;End of help on this topic&gt;
6680 </BODY>
6681 </HTML>
6682 ======= h_common_bounce =======
6683 <HTML>
6684 <HEAD>
6685 <TITLE>Bounce Command</TITLE>
6686 </HEAD>
6687 <BODY>
6688 <H1>Bounce Command</H1>
6689
6690 The Bounce
6691 (<!--chtml if pinemode="function_key"-->F10<!--chtml else-->B<!--chtml endif-->)
6692 command allows you to re-send, or &quot;remail&quot;, a
6693 message, as if you were never in the loop.  It is analogous to crossing
6694 out your address on a postal letter, writing a different address on the
6695 envelope, and putting it into the mailbox. Bounce is used primarily to
6696 redirect email that was sent to you in error.
6697 Also, some owners of email
6698 lists need the bounce command to handle list traffic.
6699 Bounce is not anonymous.
6700 A ReSent-From header is added to the message so that the recipient may
6701 tell that you Bounced it to them.
6702 <P>
6703
6704 The presence or absence of the Bounce command is determined by the
6705 <A HREF="h_config_enable_bounce">&quot;<!--#echo var="FEAT_enable-bounce-cmd"-->&quot;</A>
6706 feature in your Alpine configuration.
6707 The feature
6708 <A HREF="h_config_fcc_on_bounce">&quot;<!--#echo var="FEAT_fcc-on-bounce"-->&quot;</A>
6709 affects the behavior of the Bounce command.
6710 Also, it is possible that Bounce could be
6711 administratively disabled by your system manager; if it doesn't work,
6712 please check with your local help desk before reporting a bug.
6713
6714 <P>
6715 &lt;End of help on this topic&gt;
6716 </BODY>
6717 </HTML>
6718 ======= h_common_reply =======
6719 <HTML>
6720 <HEAD>
6721 <TITLE>Reply and Forward Commands</TITLE>
6722 </HEAD>
6723 <BODY>
6724
6725 <H1>Reply and Forward Commands</H1>
6726
6727 Replying
6728 (<!--chtml if pinemode="function_key"-->F11<!--chtml else-->R<!--chtml endif-->)
6729 and Forwarding
6730 (<!--chtml if pinemode="function_key"-->F12<!--chtml else-->F<!--chtml endif-->)
6731 are your two alternatives for following up on the
6732 message you are reading.  You would use reply if you want to get email
6733 back to the author of the message and/or the other people who have
6734 already seen it.  You use forward if you want somebody new to see the
6735 message.
6736 <P>
6737
6738 In the normal case, the only thing that you must supply when forwarding a
6739 message is the name/email address of the new recipient.
6740 Alpine will include the text of the forwarded message.
6741 Alpine will also include any attachments to the message.
6742 There is space above the forwarded text for you to include additional comments.
6743 <P>
6744
6745 When replying, you usually have to answer some questions.
6746 If the message is to multiple people and/or specified with a Reply-To: header,
6747 then you will have to decide who should get the reply.
6748 You also need to decide whether or not to include the previous
6749 message in your reply.
6750 Some of this is configurable.
6751 Specifically, see the
6752 <A HREF="h_config_include_header">&quot;<!--#echo var="FEAT_include-header-in-reply"-->&quot;</A>,
6753 <A HREF="h_config_auto_include_reply">&quot;<!--#echo var="FEAT_include-text-in-reply"-->&quot;</A>,
6754 <A HREF="h_config_attach_in_reply">&quot;<!--#echo var="FEAT_include-attachments-in-reply"-->&quot;</A>,
6755 and
6756 <A HREF="h_config_auto_reply_to">&quot;<!--#echo var="FEAT_reply-always-uses-reply-to"-->&quot;</A>
6757 configuration features.
6758 <P>
6759
6760 Both the Reply and Forward commands react to the full header mode toggle.
6761 If the full header mode is on, then all the header and delivery lines are
6762 included with the text of the message in your reply/forward.
6763 <P>
6764
6765 Other configuration features that affect the Reply command are
6766 <A HREF="h_config_sig_at_bottom">&quot;<!--#echo var="FEAT_signature-at-bottom"-->&quot;</A>,
6767 <A HREF="h_config_sigdashes">&quot;<!--#echo var="FEAT_enable-sigdashes"-->&quot;</A>, and
6768 <A HREF="h_config_strip_sigdashes">&quot;<!--#echo var="FEAT_strip-from-sigdashes-on-reply"-->&quot;</A>.
6769
6770 <P>
6771 &lt;End of help on this topic&gt;
6772 </BODY>
6773 </HTML>
6774 ======= h_common_delete =======
6775 <HTML>
6776 <HEAD>
6777 <TITLE>Delete and Undelete Commands</TITLE>
6778 </HEAD>
6779 <BODY>
6780 <H1>Delete and Undelete Commands</H1>
6781
6782 Delete
6783 (<!--chtml if pinemode="function_key"-->F9<!--chtml else-->D<!--chtml endif-->)
6784 and Undelete
6785 (<!--chtml if pinemode="function_key"-->F10<!--chtml else-->U<!--chtml endif-->)
6786 allow you to change the Deleted flag for the current message.
6787 Delete marks a message Deleted (turns on the Deleted flag) and Undelete
6788 removes the mark.
6789 In the MESSAGE INDEX, deleted messages have a &quot;D&quot; in the status field
6790 at the left hand edge of the index line.
6791 When viewing a deleted message, the letters &quot;DEL&quot; will be present
6792 in the upper right hand corner of the screen.
6793 Delete simply <EM>marks</EM> a message Deleted, it does not actually
6794 get rid of the message.
6795 The eXpunge command (available from the MESSAGE INDEX screen) actually
6796 removes all of the deleted messages in a folder.
6797 Once a message is eXpunged, it can't be retrieved.
6798 <P>
6799
6800 The Delete command is affected by the setting of the configuration feature
6801 <A HREF="h_config_del_skips_del">&quot;<!--#echo var="FEAT_delete-skips-deleted"-->&quot;</A>.
6802
6803 <P>
6804 &lt;End of help on this topic&gt;
6805 </BODY>
6806 </HTML>
6807 ======= h_common_postpone =======
6808 <HTML>
6809 <HEAD>
6810 <TITLE>Postpone Command</TITLE>
6811 </HEAD>
6812 <BODY>
6813 <H1>Postpone Command</H1>
6814
6815 The postpone
6816 <!--chtml if pinemode="function_key"-->(F11)<!--chtml else-->(^O)<!--chtml endif-->
6817 command allows you to temporarily stop working on the current
6818 message so you may read
6819 other messages or compose another message.  When you want to resume a
6820 message later, start to compose and answer &quot;yes&quot; to the
6821 &quot;Continue postponed composition?&quot; question.  You may
6822 postpone as many messages as you like.
6823
6824 <P>
6825 Note: If a <A HREF="h_config_form_folder"><!--#echo var="VAR_form-letter-folder"--></A> is defined
6826 in the Setup/Config screen, then the Postpone command will prompt you for
6827 the folder in which to store your outgoing message.
6828
6829 <P>
6830 &lt;End of help on this topic&gt;
6831 </BODY>
6832 </HTML>
6833 ======= h_compose_cancel =======
6834 <HTML>
6835 <HEAD>
6836 <TITLE>Cancel Command</TITLE>
6837 </HEAD>
6838 <BODY>
6839 <H1>Cancel Command</H1>
6840
6841 Cancel
6842 <!--chtml if pinemode="function_key"-->
6843 (F2)
6844 <!--chtml else-->
6845 (^C)
6846 <!--chtml endif-->
6847
6848 The Cancel command returns you to Alpine's normal mail processing and
6849 causes the message currently under composition to be thrown out.
6850 The message text <EM>will be lost</EM>.
6851
6852 <P>
6853 Note: Unless the <A HREF="h_config_quell_dead_letter"><!--#echo var="FEAT_quell-dead-letter-on-cancel"--></A> has been set, the text of the most recent composition cancelled
6854 will be preserved in the file named
6855 <!--chtml if pinemode="os_windows"-->
6856 &quot;DEADLETR&quot;.
6857 <!--chtml else-->
6858 &quot;dead.letter&quot; in your home directory.
6859 <!--chtml endif-->
6860 If you unintentionally cancel a message, look there for its text.
6861
6862 <P>
6863 &lt;End of help on this topic&gt;
6864 </BODY>
6865 </HTML>
6866 ======= h_compose_addrcomplete =======
6867 <HTML>
6868 <HEAD>
6869 <TITLE>Address Completion</TITLE>
6870 </HEAD>
6871 <BODY>
6872 <H1>Address Completion</H1>
6873
6874 When entering addresses in the address fields of the composer (To, Cc, etc.)
6875 the TAB key may be used to help complete the address.
6876 Type a partial nickname and tap the TAB key to complete the typing.
6877 The unambiguous part of the name will be filled in automatically.
6878 Typing TAB twice in succession will bring up a selection list of possibilities,
6879 making it easy to find and choose the correct address.
6880
6881 <P>
6882 The matching algorithm is rather ad hoc.
6883 The search starts with a search of your address book.
6884 It counts as a match if the nickname, address, or fullname field of an
6885 entry begins with the text typed in so far. It is also a match if
6886 a later word in the fullname (for example, the middle name or last name)
6887 begins with the entered text.
6888 <P>
6889 Next comes an LDAP search.
6890 The search will happen for any servers that have the
6891 <A HREF="h_config_ldap_opts_impl">&quot;Use-Implicitly-From-Composer&quot;</A>
6892 feature set. You can set or unset the feature for each server independently
6893 in the Setup/Directory screen.
6894 <P>
6895 Finally, if you are replying to or forwarding a message, that message is
6896 searched for likely candidate addresses that match the typed-in text.
6897
6898 <P>
6899 &lt;End of help on this topic&gt;
6900 </BODY>
6901 </HTML>
6902 ======= h_compose_richhdr =======
6903 <HTML>
6904 <HEAD>
6905 <TITLE>Rich Header Command</TITLE>
6906 </HEAD>
6907 <BODY>
6908 <H1>Rich Header Command</H1>
6909
6910 The Rich Header command allows you to toggle between the list of
6911 all message headers available for editing and those that are most
6912 common.
6913
6914 <P>
6915 Use this toggle to expose headers that are not normally visible by
6916 default.
6917 This set usually includes the
6918 &quot;Bcc:&quot;,
6919 &quot;Fcc:&quot;,
6920 &quot;Lcc:&quot;,
6921 and &quot;Newsgroups&quot;
6922 headers.
6923 If you are posting to a newsgroup the set of defaults is a little different.
6924 Obviously, in that case, the Newsgroups header is of interest so is not
6925 hidden.
6926 For news posting the hidden set includes the
6927 &quot;To:&quot;,
6928 &quot;Cc:&quot;,
6929 &quot;Bcc:&quot;,
6930 &quot;Fcc:&quot;,
6931 and &quot;Lcc:&quot;
6932 headers.
6933 You won't normally want to edit these, which is why they are hidden,
6934 but it is sometimes useful to be able to set them manually.
6935
6936 <P>
6937 The default sets of headers listed above can be altered.
6938 Any header that you have added to the
6939 <A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A>
6940 option, but not to the
6941 <A HREF="h_config_comp_hdrs"><!--#echo var="VAR_default-composer-hdrs"--></A>
6942 option will appear when you use the Rich Headers command to
6943 make the Rich Headers visible.
6944 (Headers listed in the <!--#echo var="VAR_default-composer-hdrs"--> list will be visible
6945 even without toggling the Rich Headers command.)
6946
6947 <P>
6948 &lt;End of help on this topic&gt;
6949 </BODY>
6950 </HTML>
6951 ======= h_compose_send =======
6952 <HTML>
6953 <HEAD>
6954 <TITLE>Send Command</TITLE>
6955 </HEAD>
6956 <BODY>
6957 <H1>Send Command</H1>
6958
6959 The Send command
6960 <!--chtml if pinemode="function_key"-->
6961 (F3)
6962 <!--chtml else-->
6963 (^X)
6964 <!--chtml endif-->
6965 tells Alpine you are finished composing.
6966 Before actually sending it, though, Alpine will ask you to confirm
6967 your intention, and, at the same time, redisplayed the message text
6968 with the recipients at the top of the screen to give you the opportunity
6969 to review and verify that the message is addressed to the people
6970 you intended.
6971 <P>
6972 If the feature
6973 <A HREF="h_config_send_wo_confirm">&quot;<!--#echo var="FEAT_send-without-confirm"-->&quot;</A> is set,
6974 then this confirmation prompt and any options it allows are skipped.
6975
6976 <P>
6977 This confirmation prompt may also offer, depending
6978 on your particular Setup/Config, options allowing you to set
6979 <A HREF="h_config_compose_dsn">delivery status notifications</A>,
6980 include attachments in the &quot;Fcc&quot; (if you had previously
6981 specified that they <A HREF="h_config_no_fcc_attach">exclude attachments</A>,
6982 observe details of the
6983 <A HREF="h_config_verbose_post">message submission process</A>,
6984 choose the filter through which the
6985 <A HREF="h_config_sending_filter">outgoing text should first pass</A>,
6986 or turn of flowed text generation.
6987
6988 <P>
6989 &lt;End of help on this topic&gt;
6990 </BODY>
6991 </HTML>
6992 ======= h_compose_markcutpaste =======
6993 <HTML>
6994 <HEAD>
6995 <TITLE>Mark, Cut and Paste Commands</TITLE>
6996 </HEAD>
6997 <BODY>
6998 <H1>Mark, Cut and Paste Commands</H1>
6999
7000 You can define a &quot;block&quot; of text, which can subsequently
7001  be deleted or
7002 copied as a unit, by setting a mark at the start of the block (Ctrl-^) and
7003 then moving the cursor to the end of the desired text block.  You can then
7004 &quot;cut&quot; the block out
7005 <!--chtml if pinemode="function_key"-->
7006 &quot;F9&quot;,
7007 <!--chtml else-->
7008 &quot;Ctrl-K&quot;,
7009 <!--chtml endif-->
7010 move the cursor, and &quot;paste&quot; it
7011 <!--chtml if pinemode="function_key"-->
7012 &quot;F10&quot;,
7013 <!--chtml else-->
7014 &quot;Ctrl-U&quot;,
7015 <!--chtml endif-->
7016 in the new location.  Also, you can paste more than once, allowing you
7017 to use this feature to copy a block of text.<P>
7018
7019 If you press
7020 <!--chtml if pinemode="function_key"-->
7021 &quot;F9&quot;
7022 <!--chtml else-->
7023 &quot;^K&quot;
7024 <!--chtml endif-->
7025 without having marked anything, Alpine will delete
7026 a single line.  If you delete a group of lines together, Alpine keeps them
7027 in the same buffer, so
7028 <!--chtml if pinemode="function_key"-->
7029 F10
7030 <!--chtml else-->
7031 ^U
7032 <!--chtml endif-->
7033 will restore them as a block.  About
7034 terminology:  Mark is shown as &quot;^^&quot;.  The first &quot;^&quot; means you should
7035 hold down the &quot;Control&quot; key on your keyboard.  The second &quot;^&quot; means
7036 &quot;type the character ^&quot;.
7037
7038 <P>
7039 &lt;End of help on this topic&gt;
7040 </BODY>
7041 </HTML>
7042 ======= h_compose_justify =======
7043 <HTML>
7044 <HEAD>
7045 <TITLE>Justify Command</TITLE>
7046 </HEAD>
7047 <BODY>
7048 <H1>Justify Command</H1>
7049
7050 The Justify
7051 <!--chtml if pinemode="function_key"-->
7052 (F4)
7053 <!--chtml else-->
7054 (^J)
7055 <!--chtml endif-->
7056 command reformats the text in the paragraph the cursor is in.
7057 Paragraphs are separated by one blank line or a line beginning with a space.
7058 This is useful when you have been editing a paragraph and the lines become
7059 uneven.  The text is left aligned or justified and the right is ragged.  If
7060 the text is already justified as typed with auto-wrap, no justification will
7061 be done.
7062
7063 <P>
7064 If you have set a <A HREF="h_compose_markcutpaste">mark</A> to select a
7065 block of text, the Justify command is modified.
7066 Instead of automatically justifying the current paragraph you will be
7067 asked if you want to justify the paragraph, justify the selected region,
7068 or adjust the quote level of the selected region.
7069 Adjusting the quote level only works if you are using standard
7070 &quot;&gt;&nbsp;&quot; or &quot;&gt;&quot; quotes, which is the default if you haven't
7071 changed &quot;<A HREF="h_config_reply_indent_string"><!--#echo var="VAR_reply-indent-string"--></A>&quot;.
7072
7073 <P>
7074 When composing a reply containing included text, the justify command
7075 will reformat text to the right of the
7076 &quot;<A HREF="h_config_reply_indent_string"><!--#echo var="VAR_reply-indent-string"--></A>&quot;,
7077 adding or removing indented lines as needed.  Paragraphs are separated
7078 by a blank line, a line containing only the <!--#echo var="VAR_reply-indent-string"-->, or a
7079 line containing the indent string and one or more blank spaces.
7080 Included text that was previously indented (or &quot;quoted&quot;) is
7081 not preserved.
7082
7083 <P>
7084 Because of the introduction of <A HREF="h_config_quell_flowed_text">Flowed Text</A>
7085 in 1999 and its wide-spread adoption since then, you will usually be better off if you
7086 use the standard
7087 &quot;&gt;&nbsp;&quot; or &quot;&gt;&quot; quotes.
7088
7089 <P>
7090 &lt;End of help on this topic&gt;
7091 </BODY>
7092 </HTML>
7093 ======= h_compose_spell =======
7094 <HTML>
7095 <HEAD>
7096 <TITLE>Spell Check Command</TITLE>
7097 </HEAD>
7098 <BODY>
7099 <H1>Spell Check Command</H1>
7100
7101 The &quot;To Spell&quot;
7102 <!--chtml if pinemode="function_key"-->
7103 (F12)
7104 <!--chtml else-->
7105 (^T)
7106 <!--chtml endif-->
7107 command calls an external spell checking program to look over the
7108 message you are composing.  By default, Alpine uses
7109 <P>
7110 <CENTER><SAMP>aspell --dont-backup --mode=email check</SAMP></CENTER>
7111 <P>
7112 if it knows where to find &quot;aspell&quot;.
7113 If there is no &quot;aspell&quot; command available but the command &quot;ispell&quot; is available
7114 then the command used is
7115 <P>
7116 <CENTER><SAMP>ispell -l</SAMP></CENTER>
7117 <P>
7118 Otherwise, the ancient &quot;spell&quot; command is used.
7119 <P>
7120 For PC-Alpine, you must install the aspell library code that you
7121 may get from
7122 <A HREF="http://aspell.net/win32/">http://aspell.net/win32/</A>.
7123
7124 <P>
7125 &lt;End of help on this topic&gt;
7126 </BODY>
7127 </HTML>
7128 ======= h_compose_alted =======
7129 <HTML>
7130 <HEAD>
7131 <TITLE>Alt Editor Command</TITLE>
7132 </HEAD>
7133 <BODY>
7134 <H1>Alt Editor Command</H1>
7135
7136 The &quot;Alt Editor&quot; command's availability depends on the
7137 Setup/Config variable &quot;<A HREF="h_config_editor"><!--#echo var="VAR_editor"--></A>&quot;.
7138
7139 <P>
7140 When the variable specifies a valid editor on your system, this
7141 command will launch it with the current text of your message
7142 already filled in.
7143
7144 <P>
7145 &lt;End of help on this topic&gt;
7146 </BODY>
7147 </HTML>
7148 ======= h_compose_readfile =======
7149 <HTML>
7150 <HEAD>
7151 <TITLE>Read File Command</TITLE>
7152 </HEAD>
7153 <BODY>
7154 <H1>Read File Command</H1>
7155
7156 The &quot;Read File&quot;
7157 <!--chtml if pinemode="function_key"-->
7158 (F5)
7159 <!--chtml else-->
7160 (^R)
7161 <!--chtml endif-->
7162 command allows you to copy in text from an existing file. You will be
7163 prompted for the name of a file to be inserted into the message.  The file
7164 name is relative to your home directory
7165 <!--chtml if pinemode="running"-->
7166 (which, in the present configuration of your system, is
7167  &quot;<!--#echo var="HOME_DIR"-->&quot;)
7168 <!--chtml endif-->
7169 or current working directory
7170 <!--chtml if pinemode="running"-->
7171 (which, at least for your current Alpine &quot;session,&quot;
7172 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
7173 <!--chtml endif-->, depending on the
7174 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
7175 configuration setting; or, the file name must be specified as a full path name
7176 <!--chtml if pinemode="os_windows"-->
7177 -- for example: &quot;A:&#92;PAPER.TXT&quot;
7178 <!--chtml else-->
7179 -- for example: &quot;/tmp/wisdom-of-the-day&quot;
7180 <!--chtml endif-->
7181 (without the quotation marks).
7182
7183 <P>
7184 The file will be inserted where the cursor is located.  <B>The
7185 file to be read must be on the same system as Alpine.</B> If you use Alpine on a
7186 Unix machine but have files on a PC or Mac, the files must be transferred
7187 to the system Alpine is running on before they can be read.  Please ask your
7188 local computer support people about the correct way to transfer a file to
7189 your Alpine system.
7190
7191 <P>
7192 &lt;End of help on this topic&gt;
7193 </BODY>
7194 </HTML>
7195 ======= h_config_tray_icon =======
7196 <HTML>
7197 <HEAD>
7198 <TITLE>FEATURE: <!--#echo var="FEAT_enable-tray-icon"--></TITLE>
7199 </HEAD>
7200 <BODY>
7201 <H1>FEATURE: <!--#echo var="FEAT_enable-tray-icon"--></H1>
7202
7203 PC-Alpine only.
7204 <P>
7205 This option restores a behavior of previous versions of PC-Alpine.
7206 These
7207 versions, when started, installed a PC-Alpine icon in the notification
7208 tray of Window's Taskbar.  The primary use of this icon was to indicate
7209 new mail arrival by turning red (while the Taskbar icon remained green).
7210 Additionally, the icon now changes to yellow to signify that a mail folder
7211 has been closed unexpectedly.
7212
7213 <P>
7214 Rather than add another icon to the Taskbar, this version of PC-Alpine will
7215 color its Taskbar entry's icon red (as well as the icon in the Window
7216 Title).  This feature is only provided for backwards compatibility.
7217
7218 <P>
7219 &lt;End of help on this topic&gt;
7220 </BODY>
7221 </HTML>
7222 ======= h_common_suspend =======
7223 <HTML>
7224 <HEAD>
7225 <TITLE>Suspend Command</TITLE>
7226 </HEAD>
7227 <BODY>
7228 <H1>Suspend Command</H1>
7229
7230 With the <A HREF="h_config_can_suspend"><!--#echo var="FEAT_enable-suspend"--></A> feature
7231 enabled, you can, at almost any time, temporarily halt your Alpine session,
7232 <!--chtml if pinemode="os_windows"-->
7233 minimizing it into an icon.
7234 <!--chtml else-->
7235 and return to your system prompt.
7236 <!--chtml endif-->
7237
7238 <P>
7239 &lt;End of help on this topic&gt;
7240 </BODY>
7241 </HTML>
7242 ======= h_pipe_command =======
7243 <HTML>
7244 <HEAD>
7245 <TITLE>Pipe Command SubOptions</TITLE>
7246 </HEAD>
7247 <BODY>
7248 <H1>Pipe Command SubOptions</H1>
7249
7250 By default, when you use the Pipe command, the processed text of the
7251 message is sent to the Unix command
7252 you specify and the output is captured by Alpine and shown to you.
7253 (This command is available in PC-Alpine, as well, but there aren't many
7254 Windows commands that work well with piping.)
7255 There are some sub-commands that may be used to alter this behavior.
7256 These are toggles that switch the behavior between two possibilities.
7257 They can be combined in any way you wish.
7258 <P>
7259 By default, the prompt at the bottom of the screen looks like
7260 <P>
7261 <CENTER><SAMP>Pipe message 37 to :</SAMP></CENTER>
7262 <P>
7263 or
7264 <P>
7265 <CENTER><SAMP>Pipe messages to :</SAMP></CENTER>
7266 <P>
7267 if you are piping more than one message.
7268 <P>
7269 The sub-command options are:
7270 <DL>
7271    <DT>Shown Text or Raw Text</DT>
7272    <DD>This option toggles between sending the shown (processed) text
7273 of the message to the Unix command, and sending the
7274 raw (unprocessed) text of the message to the Unix command.
7275 The default is to send the shown text.
7276 The raw version of the message will contain all of the headers and any
7277 MIME encoding that the message contains.
7278 If you've selected the Raw Text then the prompt will have the additional word
7279 &quot;RAW&quot; in it, like
7280 <P>
7281 <CENTER><SAMP>Pipe RAW messages to :</SAMP></CENTER>
7282 <P>
7283 You can experiment with this option by piping to something simple like the
7284 Unix &quot;cat&quot; command.
7285    </DD>
7286    <DT>Captured Output or Free Output</DT>
7287    <DD>This option toggles between having Alpine capture the output of
7288 the Unix pipe command for display, and not capturing it.
7289 If the command you are piping to is a filter that will produce output
7290 you want to view, then you want to capture that output
7291 for display (the default).
7292 If the Unix command doesn't produce output or handles the display itself,
7293 then you want free output.
7294 When you've selected the Free Output option the prompt will change to
7295 <P>
7296 <CENTER><SAMP>Pipe messages to (uncaptured) :</SAMP></CENTER>
7297 <P>
7298    </DD>
7299    <DT>No Delimiter or With Delimiter</DT>
7300    <DD>This option controls whether or not a Unix mailbox style delimiter
7301 will come before the text of the message.
7302 This is the delimiter used in the common Unix mailbox format.
7303 It's the single line that begins with the five characters
7304 &quot;From&quot; followed by a &lt;SPACE&gt; character.
7305 You'll usually only want to include this if the Unix command requires
7306 input in the format of a traditional Unix mailbox file.
7307 When you've selected the With Delimiter option the prompt will change to
7308 <P>
7309 <CENTER><SAMP>Pipe messages to (delimited) :</SAMP></CENTER>
7310 <P>
7311    </DD>
7312    <DT>To Same Pipe or To Individual Pipes</DT>
7313    <DD>This option only shows up if you are running an aggregate
7314 pipe command.
7315 That is, the command was Apply Pipe, not just Pipe.
7316 You have the option of piping all of the selected messages through a
7317 single pipe to a single instance of the Unix command,
7318 or piping each individual message through a separate pipe to separate
7319 instances of the Unix command.
7320 The default is that all of the output will go through a single pipe
7321 to a single instance of the command.
7322 You can try this option with a command like &quot;less&quot;, with Free
7323 Output enabled.
7324 When you've selected the Individual Pipes option the prompt will change to
7325 <P>
7326 <CENTER><SAMP>Pipe messages to (new pipe) :</SAMP></CENTER>
7327 <P>
7328    </DD>
7329 </DL>
7330
7331 <P>
7332 As mentioned earlier, the options can be combined in any way you wish.
7333 You may leave them all off, turn them all on, or turn some of them on
7334 and some of them off.
7335 If you use the pipe command a second time in the same session the default
7336 options will be what you used the last time.
7337
7338 <P>
7339 &lt;End of help on this topic&gt;
7340 </BODY>
7341 </HTML>
7342 ========== h_emptydir_subfolder_name =========
7343 <HTML>
7344 <HEAD>
7345 <TITLE>ENTER SUBFOLDER NAME</TITLE>
7346 </HEAD>
7347 <BODY>
7348 <H1>Enter Subfolder Name</H1>
7349
7350 <P>
7351 This is the name of a new subfolder in the directory you are creating.
7352 Because empty directories are hidden and therefore not useful, you must also
7353 create a subfolder in the directory you are creating in order that the
7354 directory remains visible.
7355 <P>
7356 Alternatively, you may turn off the configuration feature
7357 <A HREF="h_config_quell_empty_dirs"><!--#echo var="FEAT_quell-empty-directories"--></A>
7358 so that empty directories remain visible.
7359 If you do that, you will not be required to create the subfolder when you
7360 create a directory.
7361
7362 <P>
7363 &lt;End of help on this topic&gt;
7364 </BODY>
7365 </HTML>
7366 ========== h_incoming_add_folder_name =========
7367 <HTML>
7368 <HEAD>
7369 <TITLE>ENTER FOLDER NAME</TITLE>
7370 </HEAD>
7371 <BODY>
7372 <H1>Enter Folder Name</H1>
7373
7374 <P>
7375 This is the name of the folder on the previously specified server.
7376 By default the folder name is interpreted as defining a section of your personal
7377 folder area.  This area and how you specify it are defined by the
7378 server, if one is specified.
7379
7380 <P>
7381 To define a folder outside the default area, prefix
7382 the path with the namespace to use when interpreting the
7383 given path.  If a namespace is specified, the folder name begins with the
7384 sharp (#) character followed by the name of the namespace
7385 and then the namespace's path-element-delimiter.  Aside from the
7386 name's format, namespaces can also imply access rights, content
7387 policy, audience, location, and, occasionally, access methods.
7388
7389 <P>
7390 Each server exports its own set (possibly of size one) of
7391 namespaces.
7392 For a more detailed explanation read about
7393 <A HREF="h_folder_name_namespaces">Namespaces</A>.
7394
7395 <P>
7396 To specify the default for INBOX on the server you can usually just enter
7397 &quot;INBOX&quot;, and the server will understand the special meaning of
7398 that word.
7399
7400 <P>
7401 &lt;End of help on this topic&gt;
7402 </BODY>
7403 </HTML>
7404 ========== h_incoming_add_folder_host =========
7405 <HTML>
7406 <HEAD>
7407 <TITLE>ENTER INCOMING FOLDER SERVER</TITLE>
7408 </HEAD>
7409 <BODY>
7410 <H1>Enter Incoming Folder Server</H1>
7411
7412 You are being asked for the name of the server for use with this incoming
7413 folder.
7414 If the folder is on the machine where Alpine is running, then just enter
7415 RETURN without typing a server name.
7416
7417 <P>
7418 If the folder is on an IMAP server then type the server's name followed
7419 by RETURN.
7420 You may use the ^X command if the server is the same as the server that
7421 the INBOX is on.
7422
7423 <P>
7424 You may have to add optional extra information to the server name.
7425 For example, if the IMAP server is using a non-standard port number you
7426 would specify that by appending a colon (:) followed by the port number
7427 to the server name
7428
7429 <P>
7430 <CENTER><SAMP>foo.example.com:port</SAMP></CENTER>
7431 <P>
7432
7433 or you may need to specify a different protocol if the server is not an
7434 IMAP server. For example:
7435
7436 <P>
7437 <CENTER><SAMP>foo.example.com/pop3</SAMP></CENTER>
7438 <P>
7439
7440 for a POP server or
7441
7442 <P>
7443 <CENTER><SAMP>foo.example.com/nntp</SAMP></CENTER>
7444 <P>
7445
7446 for an NNTP news server.
7447 For an explanation of all of the possibilities, see
7448 <A HREF="h_folder_server_syntax">Server Name Syntax</A>
7449 for folders.
7450
7451 <P>
7452 There is a special command (^W) if you want to set up a folder that gets its
7453 mail from a
7454 <A HREF="h_maildrop">Mail Drop</A>.
7455 If you type that command, you will be prompted for the information for
7456 both the Mail Drop folder and the destination folder.
7457
7458 <P>
7459 &lt;End of help on this topic&gt;
7460 </BODY>
7461 </HTML>
7462 ========== h_incoming_add_inbox =========
7463 <HTML>
7464 <HEAD>
7465 <TITLE>ENTER INBOX SERVER</TITLE>
7466 </HEAD>
7467 <BODY>
7468 <H1>Enter INBOX Server</H1>
7469
7470 You are being asked for the name of the server for use with
7471 the INBOX folder.
7472 Type the server's name followed by RETURN.
7473
7474 <P>
7475 You may have to add optional extra information to the server name.
7476 For example, if the server is using a non-standard port number you
7477 would specify that by appending a colon (:) followed by the port number
7478 to the server name
7479
7480 <P>
7481 <CENTER><SAMP>foo.example.com:port</SAMP></CENTER>
7482 <P>
7483
7484 or you may need to specify a different protocol if the server is not an
7485 IMAP server. For example:
7486
7487 <P>
7488 <CENTER><SAMP>foo.example.com/pop3</SAMP></CENTER>
7489 <P>
7490
7491 for a POP server.
7492 <P>
7493
7494 For an explanation of all of the possibilities, see
7495 <A HREF="h_folder_server_syntax">Server Name Syntax</A>
7496 for folders.
7497
7498 <P>
7499 If the INBOX folder is on the machine where Alpine is running, then just enter
7500 RETURN without typing a server name.
7501
7502 <P>
7503 There is a special command (^W) if you want to set up a folder that gets its
7504 mail from a
7505 <A HREF="h_maildrop">Mail Drop</A>.
7506 If you type that command, you will be prompted for the information for
7507 both the Mail Drop folder and the destination folder, which will be used
7508 as your INBOX folder.
7509
7510 <P>
7511 &lt;End of help on this topic&gt;
7512 </BODY>
7513 </HTML>
7514 ========== h_incoming_add_maildrop_destn =========
7515 <HTML>
7516 <HEAD>
7517 <TITLE>ENTER DESTINATION SERVER</TITLE>
7518 </HEAD>
7519 <BODY>
7520 <H1>Enter Destination Server</H1>
7521
7522 You are being asked for the name of the server where the destination
7523 folder is for use with this Mail Drop incoming folder.
7524 That is, you are using a Mail Drop for this incoming folder and
7525 you've already entered
7526 the server and folder name for the Mail Drop.
7527 Now you need to enter the server for the destination folder
7528 where the mail should be copied to.
7529 Mail will come from the Mail Drop and be copied to the destination folder.
7530
7531 <P>
7532 Type the server's name followed by RETURN.
7533 If the folder is local to this computer, just type RETURN without entering
7534 a server name.
7535
7536 <P>
7537 You may have to add optional extra information to the server name.
7538 For example, if the server is using a non-standard port number you
7539 would specify that by appending a colon (:) followed by the port number
7540 to the server name
7541
7542 <P>
7543 <CENTER><SAMP>foo.example.com:port</SAMP></CENTER>
7544 <P>
7545
7546 For an explanation of all of the possibilities, see
7547 <A HREF="h_folder_server_syntax">Server Name Syntax</A>
7548 for folders.
7549
7550 <P>
7551 &lt;End of help on this topic&gt;
7552 </BODY>
7553 </HTML>
7554 ========== h_inbox_add_maildrop_destn =========
7555 <HTML>
7556 <HEAD>
7557 <TITLE>ENTER DESTINATION SERVER</TITLE>
7558 </HEAD>
7559 <BODY>
7560 <H1>Enter Destination Server</H1>
7561
7562 You are being asked for the name of the server where the destination
7563 folder is for use with your Mail Drop INBOX.
7564 That is, you are using a Mail Drop for your INBOX and you've already entered
7565 the server and folder name for the Mail Drop.
7566 Now you need to enter the server for the destination folder
7567 where the mail should be copied to.
7568 Mail will come from the Mail Drop and be copied to the destination folder.
7569
7570 <P>
7571 Type the server's name followed by RETURN.
7572 If the folder is local to this computer, just type RETURN without entering
7573 a server name.
7574
7575 <P>
7576 You may have to add optional extra information to the server name.
7577 For example, if the server is using a non-standard port number you
7578 would specify that by appending a colon (:) followed by the port number
7579 to the server name
7580
7581 <P>
7582 <CENTER><SAMP>foo.example.com:port</SAMP></CENTER>
7583 <P>
7584
7585 For an explanation of all of the possibilities, see
7586 <A HREF="h_folder_server_syntax">Server Name Syntax</A>
7587 for folders.
7588
7589 <P>
7590 &lt;End of help on this topic&gt;
7591 </BODY>
7592 </HTML>
7593 ========== h_inbox_add_maildrop =========
7594 <HTML>
7595 <HEAD>
7596 <TITLE>ENTER MAILDROP SERVER</TITLE>
7597 </HEAD>
7598 <BODY>
7599 <H1>Enter Mail Drop Server</H1>
7600
7601 You are being asked for the name of the Mail Drop server for use with
7602 your INBOX.
7603
7604 <P>
7605 Type the server's name followed by RETURN.
7606
7607 <P>
7608 You may have to add optional extra information to the server name.
7609 For example, if the server is using a non-standard port number you
7610 would specify that by appending a colon (:) followed by the port number
7611 to the server name
7612
7613 <P>
7614 <CENTER><SAMP>foo.example.com:port</SAMP></CENTER>
7615 <P>
7616
7617 or you may need to specify a different protocol if the server is not an
7618 IMAP server. For example:
7619
7620 <P>
7621 <CENTER><SAMP>foo.example.com/pop3</SAMP></CENTER>
7622 <P>
7623
7624 for a POP server or
7625
7626 <P>
7627 <CENTER><SAMP>foo.example.com/nntp</SAMP></CENTER>
7628 <P>
7629
7630 for an NNTP news server.
7631 For an explanation of all of the possibilities, see
7632 <A HREF="h_folder_server_syntax">Server Name Syntax</A>
7633 for folders.
7634
7635 <P>
7636 &lt;End of help on this topic&gt;
7637 </BODY>
7638 </HTML>
7639 ========== h_incoming_add_maildrop =========
7640 <HTML>
7641 <HEAD>
7642 <TITLE>ENTER MAILDROP SERVER</TITLE>
7643 </HEAD>
7644 <BODY>
7645 <H1>Enter Mail Drop Server</H1>
7646
7647 You are being asked for the name of the Mail Drop server for use with
7648 this incoming folder.
7649
7650 <P>
7651 Type the server's name followed by RETURN.
7652 You may use the ^X command if the server is the same as the server that
7653 the INBOX is on.
7654
7655 <P>
7656 You may have to add optional extra information to the server name.
7657 For example, if the server is using a non-standard port number you
7658 would specify that by appending a colon (:) followed by the port number
7659 to the server name
7660
7661 <P>
7662 <CENTER><SAMP>foo.example.com:port</SAMP></CENTER>
7663 <P>
7664
7665 or you may need to specify a different protocol if the server is not an
7666 IMAP server. For example:
7667
7668 <P>
7669 <CENTER><SAMP>foo.example.com/pop3</SAMP></CENTER>
7670 <P>
7671
7672 for a POP server or
7673
7674 <P>
7675 <CENTER><SAMP>foo.example.com/nntp</SAMP></CENTER>
7676 <P>
7677
7678 for an NNTP news server.
7679 For an explanation of all of the possibilities, see
7680 <A HREF="h_folder_server_syntax">Server Name Syntax</A>
7681 for folders.
7682
7683 <P>
7684 If the Mail Drop folder is on the machine where Alpine is running, then just enter
7685 RETURN without typing a server name.
7686
7687 <P>
7688 &lt;End of help on this topic&gt;
7689 </BODY>
7690 </HTML>
7691 ========== h_maildrop =========
7692 <HTML>
7693 <HEAD>
7694 <TITLE>WHAT IS A MAIL DROP?</TITLE>
7695 </HEAD>
7696 <BODY>
7697 <H1>What is a Mail Drop?</H1>
7698
7699 In some situaions it may make sense to have your mail delivered to one
7700 folder (the Mail Drop) and then when you want to read mail that has been
7701 delivered to the Mail Drop folder Alpine will move it to another
7702 destination folder.
7703 Often the Mail Drop will be a remote folder and messages will be moved from
7704 there to a local destination folder.
7705
7706 <P>
7707 One example where this might make sense is if the Mail Drop folder is accessible
7708 only with the POP protocol.
7709 You could designate your POP inbox as the Mail Drop folder and have Alpine move
7710 mail from there to a local (on the same machine Alpine is running on)
7711 destination folder, where you'll read it.
7712
7713 <P>
7714 A Mail Drop may only be used as your Inbox or as an
7715 <A HREF="h_config_enable_incoming">&quot;Incoming folder&quot;</A>.
7716
7717 <P>
7718 There is no attempt to synchronize the contents of the destination folder
7719 with the contents of the Mail Drop folder.
7720 All that happens is that all of the messages in the Mail Drop folder are
7721 copied to the destination folder and then they are deleted and expunged (if possible)
7722 from the Mail Drop folder.
7723 The next time a check for new mail is made, any messages in the Mail
7724 Drop folder are once again copied to the destination folder and deleted
7725 and expunged from the Mail Drop folder.
7726 (If the Mail Drop folder is a news group, then the messages can't be
7727 expunged from the newsgroup. Instead, only Recent messages are copied from
7728 the newsgroup to the destination folder.)
7729
7730 <P>
7731 Configuration of a Mail Drop is a little different from configuration of
7732 a folder that does not use a Mail Drop because you have to specify two
7733 folder names instead of one.
7734 The two folders may be any types of folders that Alpine can normally use.
7735 They don't have to be a remote folder and a local folder, that is
7736 simply the most common usage.
7737 When you use a Mail Drop folder Alpine will periodically re-open the Mail
7738 Drop to check for new mail.
7739 The new-mail checks will happen at the frequency set with the
7740 <A HREF="h_config_mailcheck"><!--#echo var="VAR_mail-check-interval"--></A> option,
7741 but with a minimum time
7742 (<A HREF="h_config_maildropcheck"><!--#echo var="VAR_maildrop-check-minimum"--></A>)
7743 between checks.
7744 Because of this minimum you may notice that new mail does not
7745 appear promptly when you expect it.
7746 The reason for this is to protect the server from over-zealous opening and
7747 closing of the Mail Drop folder.
7748 If the user initiates the check by typing ^L (Ctrl-L) or the Next command when at
7749 the end of the folder index, then the check will happen, regardless of how
7750 long it has been since the previous check.
7751 <P>
7752 If there is new mail, that mail will be copied to the destination folder
7753 and then will be deleted from the Mail Drop.
7754 Note that using a Mail Drop with a local destination folder does not make
7755 sense if you read mail from more than one machine, because the mail is
7756 downloaded to the destination folder (which is accessible from only one
7757 machine) and deleted from the Mail Drop.
7758 <P>
7759 The feature <A HREF="h_config_maildrops_preserve_state"><!--#echo var="FEAT_maildrops-preserve-state"--></A> modifies the operation of Mail Drops.
7760
7761 <P>
7762 The actual syntax used by Alpine for a folder that uses a Mail Drop is:
7763
7764 <P>
7765 <CENTER><SAMP>#move&lt;DELIM&gt;&lt;MailDropFolder&gt;&lt;DELIM&gt;&lt;DestinationFolder&gt;</SAMP></CENTER>
7766 <P>
7767 The brackets are not literal.
7768 <P>
7769 <CENTER><SAMP>&lt;DELIM&gt;</SAMP></CENTER>
7770 <P>
7771 is a single character that does not appear in the MailDropFolder name.
7772 If the name doesn't contain spaces then it can be a space character.
7773 The two folder names are full technical
7774 <A HREF="h_valid_folder_names">folder names</A>
7775 as used by Alpine.
7776 Here are a couple examples to give you an idea what is being talked about:
7777
7778 <P>
7779 <CENTER><SAMP>#move&nbsp;{popserver.example.com/pop3}inbox&nbsp;localfolder</SAMP></CENTER>
7780 <P>
7781 <CENTER><SAMP>#move+{nntpserver.example.com/nntp}#news.comp.mail.pine+local&nbsp;folder</SAMP></CENTER>
7782 <P>
7783
7784 A #move folder may only be used as an
7785 <A HREF="h_config_enable_incoming">&quot;Incoming folder&quot;</A> or
7786 an Inbox.
7787 When you are in the FOLDER LIST of Incoming Message Folders (after turning
7788 on the
7789 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="FEAT_enable-incoming-folders"-->&quot;</A>
7790 option)
7791 the Add command has a subcommand &quot;Use Mail Drop&quot;
7792 which may be helpful for defining the folder in your Alpine configuration.
7793 The same is true when you edit the
7794 <A HREF="h_config_inbox_path"><!--#echo var="VAR_inbox-path"--></A>
7795 option in Setup/Config.
7796 Each of these configuration methods will also create the DestinationFolder
7797 if it doesn't already exist.
7798 If you are having problems, make sure the DestinationFolder exists.
7799
7800 <P>
7801 &lt;End of help on this topic&gt;
7802 </BODY>
7803 </HTML>
7804 ========== h_save =========
7805 <HTML>
7806 <HEAD>
7807 <TITLE>CHOOSE A FOLDER TO SAVE INTO</TITLE>
7808 </HEAD>
7809 <BODY>
7810 <H1>Choose a Folder to Save Into</H1>
7811
7812 After Exiting from this help text,
7813 type the name of the folder you want to save into and press RETURN.
7814 <P>
7815 Press ^T to get a list of your folders to choose from.
7816 Press ^C to cancel the Save.
7817 <P>
7818 If you have Folder Collections defined you may use
7819 Ctrl-P (Previous collection) and Ctrl-N (Next collection) to switch
7820 the collection being saved to.
7821 <P>
7822 If Tab Completion is enabled (it is enabled by default)
7823 you may type a Tab character to have Alpine complete the folder name for you.
7824 <P>
7825 If Partial Match Lists is enabled (it is enabled by default) you may type
7826 Ctrl-X to get a list of matches to the prefix you've typed in so far.
7827 <P>
7828 If the Ctrl-R subcommand is present that means you can decide to Delete or
7829 not Delete the message you are saving after you save it.
7830 The label on that key gives the action to switch to.
7831 If it says Delete and you type Ctrl-R the label displayed will change to
7832 No Delete and the source message will be deleted after the save. If it
7833 says No Delete and you type Ctrl-R the label displayed will change to
7834 Delete and the message will not be deleted.
7835 You can control the default for the Delete parameter with the
7836 configuration feature <!--#echo var="FEAT_save-will-not-delete"-->.
7837 <P>
7838 Similarly, if the Ctrl-W subcommand is present that means you can decide
7839 to Preserve the order of the messages being saved or not.
7840 If it is labeled Preserve Order and you type Ctrl-W, the resulting Saved messages
7841 will be in the same order as you see them in the source folder now.
7842 The opposite action (which is usually the default) is that you don't care
7843 about the order.
7844 The Saved messages may or may not be in the same order in the destination folder.
7845 There may be a performance penalty for choosing to save the messages in order.
7846 You can control the default for the Preserve Order parameter with the
7847 configuration feature
7848 <!--#echo var="FEAT_save-aggregates-copy-sequence"-->.
7849
7850 <P>
7851 If you haven't disabled the Save Input History and you've already done a
7852 Save earlier in this session then you may use the Up and Down arrows to retrieve
7853 a folder name used in a previous Save.
7854
7855 <P>
7856 &lt;End of help on this topic&gt;
7857 </BODY>
7858 </HTML>
7859 ============= h_simple_index ========================
7860 <HTML>
7861 <HEAD>
7862 <TITLE>SELECT POSTPONED MESSAGE</TITLE>
7863 </HEAD>
7864 <BODY>
7865 <H1>POSTPONED MESSAGE SELECTION COMMANDS</H1>
7866 <!--chtml if pinemode="function_key"-->
7867 <PRE>
7868 Navigating the List of Messages               General Alpine Commands
7869 -------------------------------               -----------------------
7870  F5   Move to previous message                 F1   Show this help text
7871  F6   Move to next message
7872  F7   Show previous screen of messages
7873  F8   Show next screen of messages
7874
7875 Message Selection Commands
7876 --------------------------
7877  F3   Exit the Message Select menu (canceling Send command)
7878  F4   Select the currently highlighted message
7879  F9   Mark the currently highlighted message as deleted
7880  F10  Undelete (remove deletion mark from) the highlighted message
7881 </PRE>
7882 <!--chtml else-->
7883 <PRE>
7884 Navigating the List of Messages               General Alpine Commands
7885 -------------------------------               -----------------------
7886   P  Move to previous message                  ?  Show this help text
7887   N  Move to next message
7888   -  Show previous screen of messages
7889  Spc (space bar) Show next screen of messages
7890
7891 Message Selection Commands
7892 --------------------------
7893   E  Exit the Message Select menu (canceling Send command)
7894   S  Select the currently highlighted message
7895   D  Mark the currently highlighted message as deleted
7896   U  Undelete (remove deletion mark from) the highlighted message
7897 </PRE>
7898 <!--chtml endif-->
7899 <P>
7900 <H2>Description of the Select Postponed Message Screen</H2>
7901
7902 This screen allows you to select one of several previously postponed
7903 messages in order to continue composition.  Your options are very limited
7904 -- the screen is not meant to let you manipulate these messages.  However,
7905 you may now delete messages from this list.  Once you choose a message,
7906 Alpine reads it in and puts you into the regular message composer.
7907 <P>
7908
7909 Messages do not stay in this postponed state automatically.  If you select
7910 a message and then want to postpone it again, use the normal postpone
7911 (Ctrl-O) command in the composer.
7912 <P>
7913
7914 If you exit this screen without selecting a message, the Compose command
7915 that got you here is canceled.  Other than messages explicitly marked
7916 &quot;Deleted&quot;, no messages will be removed.
7917
7918 <P>
7919 &lt;End of help on this topic&gt;
7920 </BODY>
7921 </HTML>
7922 ============= h_collection_screen ========================
7923 <HTML>
7924 <HEAD>
7925 <TITLE>COLLECTION LIST screen</TITLE>
7926 </HEAD>
7927 <BODY>
7928 <H1>COLLECTION LIST screen</H1>
7929
7930 The COLLECTION LIST screen is used to select one of your
7931 collection definitions to display the folders they contain.  See
7932 <A HREF="h_what_are_collections">Folder Collections Explained</A> for
7933 detailed explanation of collections.<P>
7934
7935 To manage your collection definitions (Add, Change, Delete, etc.), use
7936 the <A HREF="h_collection_maint">Setup/collectionList</A> command on Alpine's
7937 MAIN MENU.
7938
7939 <P>
7940 &lt;End of help on this topic&gt;
7941 </BODY>
7942 </HTML>
7943 ============= h_collection_maint ========================
7944 <HTML>
7945 <HEAD>
7946 <TITLE>SETUP COLLECTION LIST screen</TITLE>
7947 </HEAD>
7948 <BODY>
7949 <H1>SETUP COLLECTION LIST screen</H1>
7950
7951 The SETUP COLLECTION LIST screen lets you manage your collection
7952 definitions.  See
7953 <A HREF="h_what_are_collections">Folder Collections Explained</A>
7954 for detailed explanation of collections.<P>
7955
7956 Maintenance commands include:
7957 <DL>
7958 <DT>Change
7959 <!--chtml if pinemode="function_key"-->
7960 (F4)
7961 <!--chtml else-->
7962 (C)
7963 <!--chtml endif-->
7964 </DT>
7965
7966 <DD>Modify attributes of the selected collection definition.
7967
7968 <DT>Add Cltn
7969 <!--chtml if pinemode="function_key"-->
7970 (F9)
7971 <!--chtml else-->
7972 (A)
7973 <!--chtml endif-->
7974 </DT>
7975
7976 <DD>Create a new collection definition.
7977 </DD>
7978
7979 <DT>Del Cltn
7980 <!--chtml if pinemode="function_key"-->
7981 (F10)
7982 <!--chtml else-->
7983 (D)
7984 <!--chtml endif-->
7985 </DT>
7986
7987 <DD>Delete the selected collection definition.<BR>
7988 NOTE: The folders and directories referred to by the
7989 collection definition are <EM>NOT</EM> deleted.  Folders must
7990 be deleted, if that's what you wish to do, from the
7991 <A HREF="h_folder_maint">FOLDER LIST screen</A>, which shows the
7992 individual folders in a collection.
7993 </DD>
7994
7995 <DT>Shuffle
7996 <!--chtml if pinemode="function_key"-->
7997 (F11)
7998 <!--chtml else-->
7999 ($)
8000 <!--chtml endif-->
8001 </DT>
8002
8003 <DD>Change the order of the displayed collections.  Alpine will offer
8004 to move the currently selected collection one position UP
8005 or DOWN.
8006 </DD>
8007 </DL>
8008
8009 <P>
8010 &lt;End of help on this topic&gt;
8011 </BODY>
8012 </HTML>
8013 ============ h_what_are_collections ==========
8014 <HTML>
8015 <HEAD>
8016 <TITLE>Folder Collections Explained</TITLE>
8017 </HEAD>
8018 <BODY>
8019 <H1>Folder Collections Explained</H1>
8020
8021
8022 Those of you with simple mail configurations will just see a list of all the
8023 folders you have when choosing FOLDER LIST from Alpine's MAIN MENU.
8024 The special folders for INBOX, sent mail and saved messages
8025 will appear at the top of the list.  All others are in alphabetical order.
8026 <P>
8027 If you
8028 or your system administrator have defined more than one collection or if
8029 you have a collection (for newsgroups or email folders) defined on your
8030 system, then you will see the COLLECTION LIST screen first when choosing
8031 FOLDER LIST from Alpine's MAIN MENU.
8032 <P>
8033 <H2>Why have multiple folder collections?</H2>
8034 <P>
8035 For Alpine users who only maintain email folders (and not too many) on one host,
8036 a single folder collection is probably sufficient.<P>
8037
8038 However, people who have more than one email account - for example, one
8039 at their university, and one with their personal Internet Service Provider -
8040 will have different sets of folders on different hosts, and they may want to
8041 access them all from the same installation of Alpine, rather than use different
8042 software and/or log into other hosts to manipulate messages in different
8043 accounts.  (If in doubt whether one of your email accounts can be accessed
8044 with Alpine, contact the technical support people for that account.)  Even people
8045 who have only one email account on one host, but have dozens or
8046 hundreds of email folders, may want to arrange these folders together in a
8047 meaningful way.<BR>
8048 That is where multiple collections come in.
8049
8050 <H2>Types of Collections</H2>
8051 <DL>
8052 <DT>INCOMING FOLDERS</DT>
8053 <DD>&quot;Incoming Message Folders&quot;
8054 is a special collection typically used to supplement your single INBOX.
8055 All the folders here are meant to be ones that receive incoming messages,
8056 which you intend to check more or less frequently.
8057 You may have multiple folders like this because you or your systems
8058 administrator have set up an external program or you may have set up
8059 Alpine to filter incoming
8060 messages into different folders, based on certain criteria such as
8061 sender, recipient, or subject; or because you have multiple accounts and
8062 wish to check their INBOXes easily.  This collection is established by
8063 setting the
8064 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="FEAT_enable-incoming-folders"-->&quot;</A>
8065 feature in the SETUP CONFIGURATION screen, which is accessed from the
8066 MAIN MENU.
8067 </DD>
8068
8069 <DT>NEWS</DT>
8070 <DD>You can also define a collection specifically for
8071 newsgroups.  Alpine does this for you implicitly when you
8072 <A HREF="h_config_nntp_server">define an NNTP Server</A>
8073 in your Alpine configuration.  The news collection appears last in the
8074 COLLECTION LIST (though you can shuffle it up in the order of presentation),
8075 and Alpine knows not to save messages there.
8076 </DD>
8077
8078 <DT>DEFAULT COLLECTION</DT>
8079 <DD>This is the default collection for your saved and sent messages folders.
8080 </DD>
8081 </DL>
8082
8083 <P>
8084
8085 <H2>Defining Collections</H2>
8086 <P>
8087 In the absence of any folder-collection definitions, Alpine will assume a
8088 single default folder collection.
8089 <!--chtml if pinemode="os_windows"-->
8090 <!--chtml else-->
8091 If necessary, Alpine will create the directory
8092 &quot;mail&quot; in your Unix home directory
8093 to hold your folders.
8094 <!--chtml endif-->
8095 <P>
8096 You can use the
8097 <A HREF="h_collection_maint">Setup/collectionList screen</A>, called up from
8098 the MAIN MENU, to manage your collection list.
8099 <P>
8100 &lt;End of help on this topic&gt;
8101 </BODY>
8102 </HTML>
8103 ===== h_select_address_screen =====
8104 <HTML>
8105 <HEAD>
8106 <TITLE>SELECT AN ADDRESS SCREEN</TITLE>
8107 </HEAD>
8108 <BODY>
8109 <H1>SELECT AN ADDRESS SCREEN</H1>
8110 <H2>COMMANDS</H2>
8111 <!--chtml if pinemode="function_key"-->
8112 <PRE>
8113 Available  Commands
8114 -------------------------------
8115 F1  Show Help Text
8116 F3  Exit without selecting anything
8117 F4  Select the highlighted address
8118 F5  Move highlight to previous address
8119 F6  Move highlight to next address
8120 F7  Previous page of addresses
8121 F8  Next page of addresses
8122 F11 Print
8123 F12 WhereIs
8124 </PRE>
8125 <!--chtml else-->
8126 <PRE>
8127 Navigation                     General Alpine Commands
8128 -------------------------      -----------------------
8129  P  Prev Address                ?  Display this help text
8130  N  Next Address                E  Exit without selecting anything
8131  -  Previous page               %  Print
8132 Spc (space bar) Next page
8133  W  WhereIs
8134
8135 Select Command
8136 ------------------------------------------------
8137  S  Select the highlighted address
8138 </PRE>
8139 <!--chtml endif-->
8140
8141 <H2>Description of the Select Address Screen</H2>
8142
8143 This screen gives you an easy way to select an address from all of
8144 the address book entries that match the prefix typed so far.
8145
8146 <P><UL>
8147 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
8148 </UL>
8149 <P>
8150 &lt;End of help on this topic&gt;
8151 </BODY>
8152 </HTML>
8153 ===== h_select_rule_screen =====
8154 <HTML>
8155 <HEAD>
8156 <TITLE>SELECT A RULE SCREEN</TITLE>
8157 </HEAD>
8158 <BODY>
8159 <H1>SELECT A RULE SCREEN</H1>
8160 <H2>COMMANDS</H2>
8161 <!--chtml if pinemode="function_key"-->
8162 <PRE>
8163 Available  Commands
8164 -------------------------------
8165 F1  Show Help Text
8166 F3  Exit without selecting anything
8167 F4  Select the highlighted rule
8168 F5  Move highlight to previous rule
8169 F6  Move highlight to next rule
8170 F7  Previous page of rules
8171 F8  Next page of rules
8172 F11 Print
8173 F12 WhereIs
8174 </PRE>
8175 <!--chtml else-->
8176 <PRE>
8177 Navigation                     General Alpine Commands
8178 -------------------------      -----------------------
8179  P  Prev Rule                   ?  Display this help text
8180  N  Next Rule                   E  Exit without selecting anything
8181  -  Previous page               %  Print
8182 Spc (space bar) Next page
8183  W  WhereIs
8184
8185 Select Command
8186 ------------------------------------------------
8187  S  Select the highlighted rule
8188 </PRE>
8189 <!--chtml endif-->
8190
8191 <H2>Description of the Select Rule Screen</H2>
8192
8193 This screen just gives you an easy way to select a rule from all of your
8194 defined rules.
8195 The list of rules presented is the list of nicknames of all of the rules
8196 defined using Setup/Rules.
8197 For selecting messages, it is likely that the Indexcolor rules and possibly
8198 the Roles rules will be most useful.
8199 The others are there also, in case you find a use for them.
8200 <P>
8201 In order for this to be useful for selecting messages, the nicknames of
8202 the rules have to be different.
8203 Alpine actually just gets the nickname of the rule that you select and then
8204 looks up that rule using the nickname.
8205 So if there are duplicate nicknames, the first rule that has that
8206 nickname will be used.
8207
8208 <P><UL>
8209 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
8210 </UL>
8211 <P>
8212 &lt;End of help on this topic&gt;
8213 </BODY>
8214 </HTML>
8215 ===== h_select_priority_screen =====
8216 <HTML>
8217 <HEAD>
8218 <TITLE>SELECT A PRIORITY SCREEN</TITLE>
8219 </HEAD>
8220 <BODY>
8221 <H1>SELECT A PRIORITY SCREEN</H1>
8222 <H2>COMMANDS</H2>
8223 <!--chtml if pinemode="function_key"-->
8224 <PRE>
8225 Available  Commands
8226 -------------------------------
8227 F1  Show Help Text
8228 F3  Exit without selecting anything
8229 F4  Select the highlighted priority
8230 F5  Move highlight to previous priority
8231 F6  Move highlight to next priority
8232 F7  Previous page of priorities
8233 F8  Next page of priorities
8234 F11 Print
8235 F12 WhereIs
8236 </PRE>
8237 <!--chtml else-->
8238 <PRE>
8239 Navigation                     General Alpine Commands
8240 -------------------------      -----------------------
8241  P  Prev Priority               ?  Display this help text
8242  N  Next Priority               E  Exit without selecting anything
8243  -  Previous page               %  Print
8244 Spc (space bar) Next page
8245  W  WhereIs
8246
8247 Select Command
8248 ------------------------------------------------
8249  S  Select the highlighted priority
8250 </PRE>
8251 <!--chtml endif-->
8252
8253 <H2>Description of the Select Priority Screen</H2>
8254
8255 This screen gives you a way to select a priority for the message you are sending.
8256 This priority will be placed in the non-standard X-Priority header of your outgoing mail.
8257 Some mail programs will display an indication of the priority level to
8258 the recipient of the message, some will ignore it.
8259 Even in cases where the mail programs of both the sender and the recipient
8260 agree on the meaning of this header, keep in mind that it is
8261 something that the sender sets so it is only an indication
8262 of the priority that the sender attaches to the mail.
8263 Alpine can be made to display an indication of this priority in incoming
8264 messages by use of one of the tokens
8265 (<A HREF="h_index_tokens">Tokens for Index and Replying</A>)
8266 PRIORITY, PRIORITYALPHA, or PRIORITY! in the
8267 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option.
8268
8269 <P><UL>
8270 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
8271 </UL>
8272 <P>
8273 &lt;End of help on this topic&gt;
8274 </BODY>
8275 </HTML>
8276 ===== h_select_keyword_screen =====
8277 <HTML>
8278 <HEAD>
8279 <TITLE>SELECT A KEYWORD SCREEN</TITLE>
8280 </HEAD>
8281 <BODY>
8282 <H1>SELECT A KEYWORD SCREEN</H1>
8283 <H2>COMMANDS</H2>
8284 <!--chtml if pinemode="function_key"-->
8285 <PRE>
8286 Available  Commands
8287 -------------------------------
8288 F1  Show Help Text
8289 F3  Exit without selecting anything
8290 F4  Select the highlighted keyword
8291 F5  Move highlight to previous keyword
8292 F6  Move highlight to next keyword
8293 F7  Previous page of keywords
8294 F8  Next page of keywords
8295 F11 Print
8296 F12 WhereIs
8297 </PRE>
8298 <!--chtml else-->
8299 <PRE>
8300 Navigation                     General Alpine Commands
8301 -------------------------      -----------------------
8302  P  Prev Keyword                ?  Display this help text
8303  N  Next Keyword                E  Exit without selecting anything
8304  -  Previous page               %  Print
8305 Spc (space bar) Next page
8306  W  WhereIs
8307
8308 Select Command
8309 ------------------------------------------------
8310  S  Select the highlighted keyword
8311 </PRE>
8312 <!--chtml endif-->
8313
8314 <H2>Description of the Select Keyword Screen</H2>
8315
8316 This screen just gives you an easy way to select a keyword.
8317 The list of keywords presented is the list of all keywords defined in your
8318 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option.
8319 If you have given a keyword a nickname, that nickname is displayed
8320 instead of the actual keyword.
8321
8322 <P><UL>
8323 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
8324 </UL>
8325 <P>
8326 &lt;End of help on this topic&gt;
8327 </BODY>
8328 </HTML>
8329 ===== h_select_charset_screen =====
8330 <HTML>
8331 <HEAD>
8332 <TITLE>SELECT A CHARACTER SET SCREEN</TITLE>
8333 </HEAD>
8334 <BODY>
8335 <H1>SELECT A CHARACTER SET SCREEN</H1>
8336 <H2>COMMANDS</H2>
8337 <!--chtml if pinemode="function_key"-->
8338 <PRE>
8339 Available  Commands
8340 -------------------------------
8341 F1  Show Help Text
8342 F3  Exit without selecting anything
8343 F4  Select the highlighted character set
8344 F5  Move highlight to previous character set
8345 F6  Move highlight to next character set
8346 F7  Previous page of character sets
8347 F8  Next page of character sets
8348 F11 Print
8349 F12 WhereIs
8350 </PRE>
8351 <!--chtml else-->
8352 <PRE>
8353 Navigation                     General Alpine Commands
8354 -------------------------      -----------------------
8355  P  Prev Character Set          ?  Display this help text
8356  N  Next Character Set          E  Exit without selecting anything
8357  -  Previous page               %  Print
8358 Spc (space bar) Next page
8359  W  WhereIs
8360
8361 Select Command
8362 ------------------------------------------------
8363  S  Select the highlighted character set
8364 </PRE>
8365 <!--chtml endif-->
8366
8367 <H2>Description of the Select A Character Set Screen</H2>
8368
8369 This screen just gives you an easy way to select a character set from the
8370 set of character sets Alpine knows about.
8371 The list presented will vary slightly depending on what option you are
8372 selecting the character set for.
8373
8374 <P><UL>
8375 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
8376 </UL>
8377 <P>
8378 &lt;End of help on this topic&gt;
8379 </BODY>
8380 </HTML>
8381 ===== h_select_multcharsets_screen =====
8382 <HTML>
8383 <HEAD>
8384 <TITLE>SELECT CHARACTER SETS SCREEN</TITLE>
8385 </HEAD>
8386 <BODY>
8387 <H1>SELECT CHARACTER SETS SCREEN</H1>
8388 <H2>COMMANDS</H2>
8389 <!--chtml if pinemode="function_key"-->
8390 <PRE>
8391 Available  Commands
8392 -------------------------------
8393 F1  Show Help Text
8394 F3  Exit without selecting anything
8395 F4  Select the highlighted charset (or chosen charsets in ListMode)
8396 F5  Move highlight to previous charset
8397 F6  Move highlight to next charset
8398 F7  Previous page of charsets
8399 F8  Next page of charsets
8400 F9  Toggle choices when using ListMode
8401 F10 Turn on/off ListMode (makes it easy to choose multiple charsets)
8402 F11 Print
8403 F12 WhereIs
8404 </PRE>
8405 <!--chtml else-->
8406 <PRE>
8407 Navigation                     General Alpine Commands
8408 -------------------------      -----------------------
8409  P  Prev Charset                ?  Display this help text
8410  N  Next Charset                E  Exit without selecting anything
8411  -  Previous page               %  Print
8412 Spc (space bar) Next page
8413  W  WhereIs
8414
8415 Select Command
8416 ------------------------------------------------
8417  S  Select the highlighted charset (or chosen charsets in ListMode)
8418  L  Turn on ListMode (makes it easy to choose multiple charsets)
8419  1  Turn off ListMode
8420  X  Toggle choices when using ListMode
8421 </PRE>
8422 <!--chtml endif-->
8423
8424 <H2>Description of the Select Character Set Screen</H2>
8425
8426 This screen just gives you an easy way to select a character set or a list of
8427 character sets.
8428 The list of character sets presented is the list of all character sets known to
8429 Alpine.
8430 You may select other character sets by typing them in directly.
8431
8432 <P><UL>
8433 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
8434 </UL>
8435 <P>
8436 &lt;End of help on this topic&gt;
8437 </BODY>
8438 </HTML>
8439 ===== h_select_multkeyword_screen =====
8440 <HTML>
8441 <HEAD>
8442 <TITLE>SELECT KEYWORDS SCREEN</TITLE>
8443 </HEAD>
8444 <BODY>
8445 <H1>SELECT KEYWORDS SCREEN</H1>
8446 <H2>COMMANDS</H2>
8447 <!--chtml if pinemode="function_key"-->
8448 <PRE>
8449 Available  Commands
8450 -------------------------------
8451 F1  Show Help Text
8452 F3  Exit without selecting anything
8453 F4  Select the highlighted keyword (or chosen keywords in ListMode)
8454 F5  Move highlight to previous keyword
8455 F6  Move highlight to next keyword
8456 F7  Previous page of keywords
8457 F8  Next page of keywords
8458 F9  Toggle choices when using ListMode
8459 F10 Turn on/off ListMode (makes it easy to choose multiple keywords)
8460 F11 Print
8461 F12 WhereIs
8462 </PRE>
8463 <!--chtml else-->
8464 <PRE>
8465 Navigation                     General Alpine Commands
8466 -------------------------      -----------------------
8467  P  Prev Keyword                ?  Display this help text
8468  N  Next Keyword                E  Exit without selecting anything
8469  -  Previous page               %  Print
8470 Spc (space bar) Next page
8471  W  WhereIs
8472
8473 Select Command
8474 ------------------------------------------------
8475  S  Select the highlighted keyword (or chosen keywords in ListMode)
8476  L  Turn on ListMode (makes it easy to choose multiple keywords)
8477  1  Turn off ListMode
8478  X  Toggle choices when using ListMode
8479 </PRE>
8480 <!--chtml endif-->
8481
8482 <H2>Description of the Select Keyword Screen</H2>
8483
8484 This screen just gives you an easy way to select a keyword or a list of
8485 keywords.
8486 The list of keywords presented is the list of all keywords defined in your
8487 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option.
8488 If you have given a keyword a nickname, that nickname is displayed
8489 instead of the actual keyword.
8490
8491 <P><UL>
8492 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
8493 </UL>
8494 <P>
8495 &lt;End of help on this topic&gt;
8496 </BODY>
8497 </HTML>
8498 ===== h_select_incoming_to_monitor =====
8499 <HTML>
8500 <HEAD>
8501 <TITLE>SELECT FOLDERS TO CHECK SCREEN</TITLE>
8502 </HEAD>
8503 <BODY>
8504 <H1>SELECT FOLDERS TO CHECK SCREEN</H1>
8505 <H2>COMMANDS</H2>
8506 <!--chtml if pinemode="function_key"-->
8507 <PRE>
8508 Available  Commands
8509 -------------------------------
8510 F1  Show Help Text
8511 F3  Exit without selecting anything
8512 F4  Select the marked folders
8513 F5  Move highlight to previous folder
8514 F6  Move highlight to next folder
8515 F7  Previous page of folders
8516 F8  Next page of folders
8517 F9  Toggle choices on or off
8518 F11 Print
8519 F12 WhereIs
8520 </PRE>
8521 <!--chtml else-->
8522 <PRE>
8523 Navigation                     General Alpine Commands
8524 -------------------------      -----------------------
8525  P  Prev Folder                 ?  Display this help text
8526  N  Next Folder                ^C  exit without changing anything
8527  -  Previous page               %  Print
8528 Spc (space bar) Next page
8529  W  WhereIs
8530
8531 Select Command
8532 ------------------------------------------------
8533  S  Select the marked folders
8534  X  Toggle choices on or off
8535 </PRE>
8536 <!--chtml endif-->
8537
8538 <H2>Description of the Select Folders to Check Screen</H2>
8539
8540 This screen is only useful if the feature
8541 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
8542 is set.
8543 By default, when you set that feature all of your incoming folders
8544 will be checked periodically for Unseen messages.
8545 By using this screen, you may restrict the set of monitored folders to
8546 a subset of all of the incoming folders.
8547 <P>
8548 Mark the folders you want to monitor for Unseen messages with
8549 an &quot;X&quot;.
8550 When you've finished marking all your selections use the Select
8551 command to register your choices.
8552 To return to the default of checking all incoming folders
8553 delete all folders or unmark all folders.
8554
8555 <P><UL>
8556 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
8557 </UL>
8558 <P>
8559 &lt;End of help on this topic&gt;
8560 </BODY>
8561 </HTML>
8562 ===== h_role_select =====
8563 <HTML>
8564 <HEAD>
8565 <TITLE>ROLES SCREEN</TITLE>
8566 </HEAD>
8567 <BODY>
8568 <H1>ROLES SCREEN</H1>
8569 <H2>ROLES COMMANDS</H2>
8570 <!--chtml if pinemode="function_key"-->
8571 <PRE>
8572 Available  Commands
8573 -------------------------------
8574 F1  Show Help Text
8575 F3  Exit without a selection
8576 F4  Select a role to use in composition
8577 F5  Move to previous role
8578 F6  Move to next role
8579 F7  Previous page of roles
8580 F8  Next page of roles
8581 F11 Change Default Role
8582 F12 Whereis (search role nicknames)
8583 </PRE>
8584 <!--chtml else-->
8585 <PRE>
8586 Navigation                     General Alpine Commands
8587 -------------------------      -----------------------
8588  P  Prev Role                     ?  Display this help text
8589  N  Next Role                     E  Exit without a selection
8590  -  Previous page
8591 Spc (space bar) Next page
8592  W  WhereIs (search for word in role nicknames)
8593
8594 Select Role Commands
8595 ------------------------------------------------
8596  [Return]  Select highlighted role
8597  D         Change Default Role
8598 </PRE>
8599 <!--chtml endif-->
8600
8601 <H2>Description of the Roles Screen</H2>
8602
8603 With this screen you select a role to be used in the composition of a
8604 message.
8605 Use the Previous and Next commands to highlight the role you wish to
8606 use.
8607 When you type carriage return you will be placed in the composer using the highlighted role.
8608 <P>
8609 You don't have any non-default <A HREF="h_rules_roles">roles</A>
8610 available unless you set them up.
8611 You may do so by using the Setup/Rules command on the MAIN MENU.
8612 <P>
8613 By using the D command, you may set a default role that will persist until
8614 you change it or until you exit Alpine.
8615 The D command toggles through three states: set the default role, unset the
8616 default role, and leave the default role as it is.
8617 <P><UL>
8618 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
8619 </UL>
8620 <P>
8621 &lt;End of help on this topic&gt;
8622 </BODY>
8623 </HTML>
8624 ===== h_role_abook_select =====
8625 <HTML>
8626 <HEAD>
8627 <TITLE>SELECT ADDRESS BOOK SCREEN</TITLE>
8628 </HEAD>
8629 <BODY>
8630 <H1>SELECT ADDRESS BOOK SCREEN</H1>
8631 <H2>COMMANDS</H2>
8632 <!--chtml if pinemode="function_key"-->
8633 <PRE>
8634 Available  Commands
8635 -------------------------------
8636 F1  Show Help Text
8637 F3  Exit screen without selecting anything
8638 F4  Select highlighted address book
8639 F5  Move to previous address book
8640 F6  Move to next address book
8641 F7  Previous page of address books
8642 F8  Next page of address books
8643 F12 Whereis
8644 </PRE>
8645 <!--chtml else-->
8646 <PRE>
8647 Navigation                     General Alpine Commands
8648 -------------------------      -----------------------
8649  P  Previous addrbook          ?  Display this help text
8650  N  Next addrbook
8651  -  Previous page
8652 Spc (space bar) Next page
8653  W  WhereIs
8654
8655 Select Role Commands
8656 ------------------------------------------------
8657  S  Select highlighted address book
8658  E  Exit screen without selecting anything
8659 </PRE>
8660 <!--chtml endif-->
8661
8662 <H2>Description of the Select Address Book Screen</H2>
8663
8664 This screen helps you select one of your address books.
8665 Use the Previous and Next commands to highlight the address book you wish to
8666 select.
8667 <P><UL>
8668 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
8669 </UL>
8670 <P>
8671 &lt;End of help on this topic&gt;
8672 </BODY>
8673 </HTML>
8674 ======== h_rule_patterns =============
8675 <HTML>
8676 <HEAD>
8677 <TITLE>PATTERNS</TITLE>
8678 </HEAD>
8679 <BODY>
8680 <H1>PATTERNS</H1>
8681 Patterns are used with Roles, Filtering, Index Coloring,
8682 Scoring, Other Rules, and Search Rules.
8683 Patterns are compared with a message to see if there is a match.
8684 For Filtering, the messages being checked are all the messages in the
8685 folder, one at a time.
8686 For Index Line Coloring, each message that is visible on the screen is
8687 checked for matches with the Index Coloring Patterns.
8688 Roles are used with the Reply, Forward, and Compose commands.
8689 For Reply, the message used to compare the Pattern with is the message
8690 being replied to;
8691 for Forward, the message used to compare the Pattern with is the message
8692 being forwarded;
8693 and for Compose, there is no message, so the parts of the Pattern that depend
8694 on a message (everything other than Current Folder Type and the
8695 Beginning of Month and Year)
8696 are not used.
8697 Only the Current Folder Type matters for Compose (plus the Beginning of
8698 Month or Year, which you wouldn't usually use for a Role).
8699 For Scoring, the message being scored is compared with all of the Score
8700 Patterns, and the Score Values from the ones that match are added together to
8701 get the message's score.
8702 For Other Rules, there is no message. Only the Current Folder Type is checked
8703 for Other Rules.
8704 <P>
8705 Each Pattern has several possible parts, all of which are optional.
8706 In order for there to be a match, <EM>ALL</EM> of the
8707 <EM>defined</EM> parts of the Pattern must match the message.
8708 If a part is not defined it is considered a match, but note that a filtering
8709 Pattern must have at least one defined part or it will be ignored.
8710 For example, if the To pattern is not defined it will be
8711 displayed as
8712 <P>
8713 <CENTER>To pattern = &lt;No Value Set&gt;</CENTER>
8714 <P>
8715 That is considered a match because it is not defined.
8716 This means that the Pattern with nothing defined is a match if the
8717 Current Folder Type matches, but there is an exception that was mentioned
8718 in the previous paragraph.
8719 Because filtering is a potentially destructive action, filtering Patterns
8720 with nothing other than Current Folder Type defined are ignored.
8721 If you really want a filtering Pattern to match all messages (subject to
8722 Current Folder Type) the best way to do it is to define a Score interval
8723 that includes all possible scores.
8724 This would be the score interval <SAMP>(-INF,INF)</SAMP>.
8725 This can be used even if you haven't defined any rules to Set Scores.
8726 <P>
8727 There are six predefined header patterns called the To, From, Sender, Cc, News,
8728 and Subject patterns.
8729 Besides those six predefined header patterns, you may add
8730 additional header patterns with header fieldnames of your choosing.
8731 You add an extra header pattern by placing the cursor on one of the
8732 patterns while in the role editor and using the &quot;eXtraHdr&quot; command.
8733 The Recip pattern is a header pattern that stands for Recipient (To OR Cc)
8734 and the Partic pattern is a header pattern that stands for
8735 Participant (From OR To OR Cc).
8736 (Defining the Recip pattern does not have the same effect as defining both
8737 the To and Cc patterns. Recip is To <EM>OR</EM> Cc, not To <EM>AND</EM> Cc.)
8738 Similar to the header patterns are the AllText pattern and the BodyText pattern.
8739 Instead of comparing this pattern's text against only the contents of
8740 a particular header field, the text for the AllText pattern is compared
8741 with text anywhere in the message's header or body, and the text for the
8742 BodyText pattern is compared with text anywhere in the message's body.
8743 <P>
8744 Any of the header patterns, the AllText pattern, or the BodyText pattern may be negated with the
8745 &quot;!&quot; &quot;toggle NOT&quot; command.
8746 You can tell that <EM>NOT</EM> has been turned on by looking for the character
8747 &quot;!&quot; at the beginning of the pattern line.
8748 When the &quot;!&quot; is present, it reverses the meaning of the match.
8749 That is, if the pattern matches then it is considered to NOT be a match, and
8750 if it does not match it is considered to be a match.
8751 <P>
8752 Don't make the mistake of putting the &quot;!&quot; in the data field for
8753 a pattern.
8754 For example, if you type the characters &quot;!urgent&quot; into the Subject
8755 pattern, the pattern will look like:
8756 <P>
8757 <PRE>
8758  Subject pattern = !urgent
8759 </PRE>
8760 <P>
8761 This means you want to match the 7 character sequence &quot;!urgent&quot;.
8762 In order to match messages that do not have &quot;urgent&quot; in
8763 their Subject field, first type the characters &quot;urgent&quot; followed
8764 by carriage return for the value of the Subject pattern, then negate it
8765 by typing the &quot;!&quot; command.
8766 It should look like
8767 <P>
8768 <PRE>
8769  ! Subject pattern = urgent
8770 </PRE>
8771 <P>
8772 The contents of each of these header patterns (or the AllText or BodyText patterns) may
8773 be a complete email address, part of an address, or a random set of
8774 characters to match against.
8775 It may also be a list of such patterns, which means you
8776 are looking for a match against the first pattern in the list <EM>OR</EM>
8777 the second pattern <EM>OR</EM> the third and so on.
8778 For example, a Subject pattern equal to
8779 <P>
8780 <PRE>
8781  Subject pattern = urgent
8782                    emergency
8783                    alert
8784 </PRE>
8785 <P>
8786 would match all messages with a subject that contained at least one
8787 of those words.
8788 It would also match subjects containing the words &quot;alerts&quot; or
8789 &quot;Urgently&quot;.
8790 <P>
8791 The same example with &quot;NOT&quot; turned on would be
8792 <P>
8793 <PRE>
8794  ! Subject pattern = urgent
8795                      emergency
8796                      alert
8797 </PRE>
8798 <P>
8799 which would match all messages with a subject that did <EM>NOT</EM> contain any of
8800 those words.
8801 You can use the &quot;Add Value&quot; command to add new words to the list,
8802 or you can enter them as a comma-separated list.
8803 <P>
8804 (It is not possible to specify two patterns that must <EM>BOTH</EM> be
8805 present for a match.
8806 It is only possible to specify that <EM>EITHER</EM> pattern1 <EM>OR</EM>
8807 pattern2 must be present,
8808 and that is exactly what using a list does.)
8809 <P>
8810 The &quot;Current Folder Type&quot; and the &quot;Score Interval&quot; are
8811 also part of the Pattern, although the &quot;Score Interval&quot; is not used
8812 when checking for matches for Scoring.
8813 There are five similar settings that relate to the status of the message.
8814 These settings rely on the message being New or not, Deleted or not,
8815 Answered or not, Important or not, and Recent or not.
8816 There are also some other miscellaneous settings.
8817 The first is the Age of the message in days.
8818 Another is the Size of the message, in bytes.
8819 The third is a setting that detects whether or not the Subject of a
8820 message contains raw 8-bit characters (unencoded characters with the most
8821 significant bit set).
8822 There is a setting that detects whether or not this is the first time
8823 Alpine has been run this month (doesn't depend on individual messages),
8824 and another that detects whether or not this is the first time Alpine has
8825 been run this year.
8826 Other parts of the Pattern detect whether or not the From address of a
8827 message appears in your address book, whether or not certain keywords
8828 are set for a message, and whether or not certain character sets are
8829 used in a message.
8830
8831 <H2>Parts of a Pattern</H2>
8832
8833 <H3>Header patterns</H3>
8834
8835 A header pattern is simply text that is searched for in the corresponding
8836 header field.
8837 For example, if a Pattern has a From header pattern with the value
8838 &quot;@company.com&quot;, then only messages that have a From header
8839 that contains the text &quot;@company.com&quot; will be possible
8840 matches.
8841 Matches don't have to be exact.
8842 For example, if the relevant field of a message contains the text
8843 &quot;mailbox@domain&quot; somewhere
8844 in it, then header patterns of &quot;box&quot;, or &quot;x@d&quot;, or
8845 &quot;mailbox@domain&quot; are all matches.
8846 <P>
8847 All parts of the Pattern must match so, for example,
8848 if a message matches a defined
8849 From pattern, it still must be checked against the other parts of the
8850 Pattern that have been defined.
8851 The To header pattern is a slightly special case.
8852 If the message being checked has a Resent-To header
8853 and the feature <A HREF="h_config_use_resentto"><!--#echo var="FEAT_use-resent-to-in-rules"--></A> is turned on, the addresses
8854 there are used in place of the addresses in the To header.
8855 This is only true for the To header.
8856 Resent-cc and Resent-From headers are never used unless you add them
8857 with the eXtraHdrs command.
8858 <P>
8859 The meaning of a header pattern may be negated with the
8860 &quot;!&quot; &quot;toggle NOT&quot; command.
8861 You can tell that <EM>NOT</EM> has been turned on by looking for the character
8862 &quot;!&quot; at the beginning of the pattern line.
8863 It would look something like
8864 <P>
8865 <PRE>
8866  ! From pattern = susan@example.com
8867 </PRE>
8868 <P>
8869 When the &quot;!&quot; is present, it reverses the meaning of the match.
8870 <P>
8871 If you want to check for the presence of a header field but don't care
8872 about its value, then
8873 the empty pattern that you get by entering a pair of
8874 double quotes (&quot;&quot;) should match any message that
8875 has the corresponding header field.
8876
8877 <H3><A NAME="pattern_alltext">AllText patterns</A></H3>
8878
8879 AllText patterns are just like header patterns except that the text is
8880 searched for anywhere in the message's headers or body, not just in the
8881 contents of a particular header field.
8882 <P>
8883
8884 <H3><A NAME="pattern_bodytext">BodyText patterns</A></H3>
8885
8886 BodyText patterns are just like header patterns except that the text is
8887 searched for anywhere in the message's body, not just in the
8888 contents of a particular header field.
8889 <P>
8890
8891 If there is more than one header pattern or AllText pattern or BodyText pattern
8892 for which you want to take the
8893 same action there is a shorthand notation that may be used.
8894 Any of these patterns may be a list of patterns instead of
8895 just a single pattern.
8896 If any one of the patterns in the list matches the message
8897 then it is considered a match.
8898 For example, if &quot;company1&quot; and &quot;company2&quot; both required
8899 you to use the same role when replying to messages, you might have
8900 a To pattern that looks like
8901 <P>
8902 <PRE>
8903  To pattern = company1.com
8904               company2.com
8905 </PRE>
8906 <P>
8907 This means that if the mail you are replying to was addressed to
8908 either &quot;anything@company1.com&quot; or &quot;anything@company2.com&quot;,
8909 then this Pattern is a match and the same actions will be taken.
8910 <P>
8911 The meaning of an AllText or BodyText pattern may be negated with the
8912 &quot;!&quot; &quot;toggle NOT&quot; command.
8913 You can tell that <EM>NOT</EM> has been turned on by looking for the character
8914 &quot;!&quot; at the beginning of the pattern line.
8915 When the &quot;!&quot; is present, it reverses the meaning of the match.
8916 <P>
8917 A technicality: Since comma is the character used to separate multiple values
8918 in any of the fields that may have multiple values (such as header patterns,
8919 AllText patterns, BodyText patterns, keywords, folder lists, and so on),
8920 you must escape comma with a
8921 backslash (&#92;) if you want to include a literal comma in one of those fields.
8922 In other words, if you type a backslash followed by a comma it will
8923 be interpreted as a comma by Alpine, instead of as a separator between
8924 pattern values.
8925 All other backslashes (those not followed by a comma) are literal
8926 backslashes and should not be escaped.
8927 It's unlikely you'll ever need to enter a literal comma or backslash in
8928 any of the patterns.
8929
8930 <H3><A NAME="pattern_current_folder">Current Folder Type</A></H3>
8931
8932 The &quot;Current Folder Type&quot; may be set to one of four different
8933 values: &quot;Any&quot;, &quot;News&quot;, &quot;Email&quot;, or
8934 &quot;Specific&quot;.
8935 If the value is set to &quot;News&quot;, then the
8936 Pattern will only match if the currently open folder is a newsgroup.
8937 The value &quot;Email&quot; only matches if the current folder is not news and
8938 the value &quot;Any&quot; causes any folder to match.
8939 If the value of &quot;Current Folder Type&quot; is set to &quot;Specific&quot;,
8940 then you must fill in a value for &quot;Folder&quot;, which is on the line
8941 below the &quot;Specific&quot; line.
8942 In this case you will only get a match if the currently open folder is
8943 the specific folder you list.
8944 You may give a list of folders instead of just a single
8945 folder name, in which case the Pattern will match if the open folder is
8946 any one of the folders in the list.
8947 The name of each folder in the list may be either &quot;INBOX&quot;,
8948 the technical specification
8949 of the folder (like what appears in your configuration file) or, if the
8950 folder is one of your incoming folders, it may be the nickname you've given
8951 the folder.
8952 Here are some samples of specific folder names:
8953 <P>
8954 <CENTER><SAMP>{monet.art.example.com}mail/art-class</SAMP></CENTER>
8955 <P>
8956 <CENTER><SAMP>{news.example.com/nntp}#news.comp.mail.pine</SAMP></CENTER>
8957 <P>
8958 <CENTER><SAMP>mail/local-folder</SAMP></CENTER>
8959 <P>
8960 The easiest way to fill in the &quot;Folder&quot; field is to use
8961 the &quot;T&quot; command that is available when the &quot;Folder&quot; line is
8962 highlighted, or to use the &quot;Take&quot; command with the configuration
8963 feature
8964 <A HREF="h_config_enable_role_take">&quot;<!--#echo var="FEAT_enable-rules-under-take"-->&quot;</A>
8965 turned on.
8966 <P>
8967 When reading a newsgroup, there may be a performance penalty
8968 incurred when collecting the information necessary to check whether
8969 or not a Pattern matches a message.
8970 For this reason, the default Current Folder Type is set to &quot;Email&quot;.
8971 If you have Patterns with a Current Folder Type of either
8972 &quot;Any&quot; or &quot;News&quot; and those Patterns are used for
8973 Index Line Coloring or Scoring, you may experience
8974 slower screen redrawing in the MESSAGE INDEX screen when in a newsgroup.
8975
8976 <H3><A NAME="pattern_age_interval">Age Interval</A></H3>
8977
8978 The &quot;Age Interval&quot; may be set to an interval of message
8979 ages that should be considered a match.
8980 Like the other parts of the Pattern, if it is unset it will be ignored.
8981 The Age Interval looks like
8982 <P>
8983 <CENTER><SAMP>(min_age,max_age)</SAMP></CENTER>
8984 <P>
8985 where &quot;min_age&quot; and &quot;max_age&quot; are integers greater
8986 than or equal to zero.
8987 The special value &quot;INF&quot; may be used for
8988 the max value. It represents infinity.
8989 <P>
8990 Actually, this option may be defined as a list of intervals instead
8991 of just a single interval.
8992 The list is separated by commas.
8993 It can look like
8994 <P>
8995 <CENTER><SAMP>(min_age1,max_age1),(min_age2,max_age2),...</SAMP></CENTER>
8996 <P>
8997 When there is an Age Interval defined, it is a match if the age, in days, of
8998 the message is contained in any of the intervals.
8999 The intervals include both endpoints.
9000 <P>
9001 Even though this option is called Age, it isn't actually
9002 the <EM>age</EM> of the message.
9003 Instead, it is how many days ago the message arrived in one of your folders.
9004 If the current time is a little past midnight, then a message that arrived
9005 just before midnight arrived yesterday, even though the message is only
9006 a few minutes old.
9007 By default, the date being used is not the date in the Date
9008 header of the message.
9009 It is the date that the message arrived in one of your folders.
9010 When you Save a message from one folder to another that arrival date
9011 is preserved.
9012 If you would like to use the date in the Date header that is possible.
9013 Turn on the option
9014 <A HREF="h_config_filt_opts_sentdate">&quot;Use-Date-Header-For-Age&quot;</A>
9015 near the bottom of the rule definition.
9016 A value of 0 is today, 1 is yesterday, 2 is the day before yesterday, and so on.
9017
9018 <H3><A NAME="pattern_size_interval">Size Interval</A></H3>
9019
9020 The &quot;Size Interval&quot; may be set to an interval of message
9021 sizes that should be considered a match.
9022 Like the other parts of the Pattern, if it is unset it will be ignored.
9023 The Size Interval looks like
9024 <P>
9025 <CENTER><SAMP>(min_size,max_size)</SAMP></CENTER>
9026 <P>
9027 where &quot;min_size&quot; and &quot;max_size&quot; are integers greater
9028 than or equal to zero.
9029 The special value &quot;INF&quot; may be used for
9030 the max value. It represents infinity.
9031 <P>
9032 Actually, this option may be defined as a list of intervals instead
9033 of just a single interval.
9034 The list is separated by commas.
9035 It can look like
9036 <P>
9037 <CENTER><SAMP>(min_size1,max_size1),(min_size2,max_size2),...</SAMP></CENTER>
9038 <P>
9039 When there is a Size Interval defined, it is a match if the size, in bytes, of
9040 the message is contained in any of the intervals.
9041 The intervals include both endpoints.
9042
9043 <H3><A NAME="pattern_score_interval">Score Interval</A></H3>
9044
9045 The &quot;Score Interval&quot; may be set to an interval of message
9046 scores that should be considered a match.
9047 Like the other parts of the Pattern, if it is unset it will be ignored.
9048 The Score Interval looks like
9049 <P>
9050 <CENTER><SAMP>(min_score,max_score)</SAMP></CENTER>
9051 <P>
9052 where &quot;min_score&quot; and &quot;max_score&quot; are positive or
9053 negative integers, with min_score less than or equal to max_score.
9054 The special values &quot;-INF&quot; and &quot;INF&quot; may be used for
9055 the min and max values to represent negative and positive infinity.
9056 <P>
9057 Actually, a list of intervals may be used if you wish.
9058 A list would look like
9059 <P>
9060 <CENTER><SAMP>(min_score1,max_score1),(min_score2,max_score2),...</SAMP></CENTER>
9061 <P>
9062 When there is a Score Interval defined, it is a match if the score for
9063 the message is contained in any of the intervals in the list.
9064 The intervals include the endpoints.
9065 The score for a message is calculated by looking at every Score rule defined and
9066 adding up the Score Values for the ones that match the message.
9067 When deciding whether or not a Pattern matches a message for purposes of
9068 calculating the score, the Score Interval is ignored.
9069
9070 <H3><A NAME="pattern_message_status">Message Status</A></H3>
9071
9072 There are five separate message status settings.
9073 By default, all five are set to the value &quot;Don't care&quot;, which
9074 will match any message.
9075 The value &quot;Yes&quot; means that the particular status must be true
9076 for a match, and the value &quot;No&quot; means that the particular
9077 status must not be true for a match.
9078 For example, one of the five Message Status settings is whether a message
9079 is marked Important or not.
9080 A &quot;Yes&quot; means that the message must be Important to be
9081 considered a match and &quot;No&quot; means that the message must not be
9082 Important to be considered a match.
9083 The same is true of the other four message status settings that depend
9084 on whether or not the message is New; whether the message has
9085 been Answered or not; whether the message has been Deleted or not, and
9086 whether the message is Recent or not.
9087 <P>
9088 The nomenclature for New and Recent is a bit confusing:
9089 <P>
9090 New means that the message is Unseen.
9091 It could have been in your mailbox for a long time but if you haven't looked
9092 at it, it is still considered New.
9093 That matches the default Alpine index display that shows an N for such a
9094 message.
9095 <P>
9096 Recent means that the message was added to this folder since the last time
9097 you opened the folder.
9098 Alpine also shows an N by default for these types of messages.
9099 If you were to run two copies of Alpine that opened a folder one right after
9100 the other, a message would only show up as Recent in (at most) the first
9101 Alpine session.
9102
9103 <H3><A NAME="pattern_message_keywords">Message Keywords</A></H3>
9104
9105 Keywords are similar to Message Status, but they are chosen by the user.
9106 Provided the mail server allows for it, you may add a set of possible keywords
9107 to a folder and then you may set those keywords or not for each message
9108 in the folder (see <A HREF="h_common_flag">Flag Command</A>).
9109 The syntax of this part of the Pattern is similar to the header patterns.
9110 It is a list of keywords.
9111 The Keyword part of the Pattern is a match if the message has any of
9112 the keywords in the list set.
9113 Like other parts of the Pattern, if this is unset it will be ignored.
9114
9115 <H3><A NAME="pattern_message_charsets">Message Character Sets</A></H3>
9116
9117 A message may use one or more character sets.
9118 This part of the Pattern matches messages that make use of one or more of
9119 the character sets specified in the pattern.
9120 It will be considered a match if a message uses any of the character
9121 sets in the list you give here.
9122
9123 <P>
9124 Besides actual character set names (for example, ISO-8859-7, KOI8-R, or
9125 GB2312) you may also use some shorthand names that Alpine provides.
9126 These names are more understandable shorthand names for sets of
9127 character set names.
9128 Two examples are &quot;Cyrillic&quot; and &quot;Greek&quot;.
9129 Selecting one of these shorthand names is equivalent to selecting all of
9130 the character sets that make up the set.
9131 You can see all of these shorthand names and the lists of character sets
9132 they stand for by typing the &quot;T&quot; command with the Character
9133 Set pattern highlighted.
9134 The syntax of this part of the Pattern is similar to the header patterns
9135 and the Message Keywords pattern.
9136 It is a list of character sets (or shorthand names).
9137 The Character Set part of the Pattern is a match if the message uses any
9138 of the character sets in the list.
9139 Like other parts of the Pattern, if this is unset it will be ignored.
9140
9141 <H3><A NAME="pattern_8bit_subject">Raw 8-bit in Subject</A></H3>
9142
9143 It seems that lots of unwanted email contains unencoded 8-bit characters
9144 in the Subject.
9145 Normally, characters with the 8th bit set are not allowed in the Subject
9146 header unless they are MIME-encoded.
9147 This option gives you a way to match messages that have Subjects that
9148 contain unencoded 8-bit characters.
9149 By default, the value of this option is &quot;Don't care&quot;, which
9150 will match any message.
9151 The value &quot;Yes&quot; means that there must be raw 8-bit characters in
9152 the Subject of the message in order for there to be a match,
9153 and the value &quot;No&quot; is the opposite.
9154 Setting this option will affect performance in large folders because the
9155 subject of each message in the folder has to be checked.
9156
9157 <H3><A NAME="pattern_bom">Beginning of Month</A></H3>
9158
9159 This option gives you a way to take some action once per month.
9160 By default, the value of this option is &quot;Don't care&quot;, which
9161 will always match.
9162 The value &quot;Yes&quot; means that this must be the first time Alpine has
9163 been run this month in order to count as a match,
9164 and the value &quot;No&quot; is the opposite.
9165
9166 <H3><A NAME="pattern_boy">Beginning of Year</A></H3>
9167
9168 This option gives you a way to take some action once per year.
9169 By default, the value of this option is &quot;Don't care&quot;, which
9170 will always match.
9171 The value &quot;Yes&quot; means that this must be the first time Alpine has
9172 been run this year in order to count as a match,
9173 and the value &quot;No&quot; is the opposite.
9174
9175 <H3><A NAME="pattern_abookfrom">Address in Address Books</A></H3>
9176
9177 This option gives you a way to match messages that have an address
9178 that is in one of your address books.
9179 Only the simple entries in your address books are searched.
9180 Address book distribution lists are ignored!
9181 By default, the value of this option is &quot;Don't care&quot;, which
9182 will match any message.
9183 The value &quot;Yes, in any address book&quot; means the address
9184 from the message must be in at least one of your
9185 address books in order to be a match.
9186 The value &quot;No, not in any address book&quot;
9187 means none of the addresses may
9188 be in any of your address books in order to be a match.
9189 The values &quot;Yes, in specific address books&quot; and
9190 &quot;No, not in any of specific address books&quot; are similar but instead
9191 of depending on all address books you are allowed to give a list of address
9192 books to look in.
9193 The addresses from the message that are checked for are determined by the
9194 setting you have for &quot;Types of addresses to check for in address book&quot;.
9195 If you set this to &quot;From&quot; the From address from the message will
9196 be looked up in the address book.
9197 If you set it to only &quot;To&quot; then the To addresses will be used.
9198 If any of the To addresses are in the address book then it is considered
9199 a match for &quot;Yes&quot; or not a match for &quot;No&quot;.
9200 You could set it to both From and To, in which case all of the From and To
9201 addresses are used.
9202 The &quot;Reply-To&quot; and &quot;Sender&quot; cases are a little unusual.
9203 Due to deficiencies in our tools, Reply-To uses the Reply-To address if it
9204 exists or the From address if there is no Reply-To address.
9205 Same for the Sender address.
9206 Setting this option may affect performance in large folders because the
9207 From and Reply-To of each message in the folder have to be checked.
9208
9209 <H3><A NAME="pattern_categorizer">Categorizer Command</A></H3>
9210
9211 This is a command that is run with its standard input set to the message
9212 being checked and its standard output discarded.
9213 The full directory path should be specified.
9214 The command will be run and then its exit status will be checked against
9215 the Exit Status Interval, which defaults to just the value zero.
9216 If the exit status of the command falls in the interval, it is considered
9217 a match, otherwise it is not a match.
9218 <P>
9219
9220 This option may actually be a list of commands.
9221 The first one that exists and is executable is used.
9222 That makes it possible to use the same configuration with Unix Alpine and
9223 PC-Alpine.
9224 <P>
9225
9226 If none of the commands in the list exists and is executable then the rule
9227 is <EM>not</EM> a match.
9228 If it is possible that the command may not exist, you should be careful
9229 to structure your rules so that nothing destructive
9230 happens when the command does not exist.
9231 For example, you might have a filter that filters away spam when there is
9232 a match but does nothing when there is not a match.
9233 That would continue to work correctly if the command didn't exist.
9234 However, if you have a filter that filters away spam when there is not
9235 a match and keeps it when there is a match, that would filter everything
9236 if the categorizer command didn't exist.
9237 <P>
9238 Here is an <A HREF="h_config_role_cat_cmd_example">example</A>
9239 setup for the bogofilter filter.
9240
9241 <P>
9242 &lt;End of help on this topic&gt;
9243 </BODY>
9244 </HTML>
9245 ===== h_rules_roles =====
9246 <HTML>
9247 <HEAD>
9248 <TITLE>SETUP ROLES SCREEN</TITLE>
9249 </HEAD>
9250 <BODY>
9251 <H1>SETUP ROLES SCREEN</H1>
9252 <H2>SETUP ROLES COMMANDS</H2>
9253 <!--chtml if pinemode="function_key"-->
9254 <PRE>
9255 Available  Commands -- Group 1         Available Commands -- Group 2
9256 -------------------------------        ------------------------------
9257 F1  Show Help Text                      F1  Show Help Text
9258 F2  See commands in next group          F2  See commands in next group
9259 F3  Back to MAIN Alpine menu
9260 F4  Change configuration for role
9261 F5  Move to previous role               F5  Include file in role config
9262 F6  Move to next role                   F6  Exclude file from config
9263 F7  Previous page of roles
9264 F8  Next page of roles
9265 F9  Add new role                        F9  Replicate existing role
9266 F10 Delete existing role
9267 F11 Shuffle the order of roles
9268 F12 Whereis (search role nicknames)
9269 </PRE>
9270 <!--chtml else-->
9271 <PRE>
9272 Navigation                     General Alpine Commands
9273 -------------------------      -----------------------
9274  P  Prev Role                     ?  Display this help text
9275  N  Next Role                     E  Back to MAIN Alpine menu
9276  -  Previous page
9277 Spc (space bar) Next page
9278  W  WhereIs (search for word in role nicknames)
9279
9280 Setup Roles Commands
9281 ------------------------------------------------
9282  A  Add new role                  $  Shuffle the order of roles
9283  D  Delete existing role          C  Change configuration for highlighted role
9284  R  Replicate existing role
9285  I  Include file in role config   X  Exclude file from role config
9286 </PRE>
9287 <!--chtml endif-->
9288
9289 <H2>Description of the Setup Roles Screen</H2>
9290
9291 This screen lets you add, delete, modify, or change the order of the rules
9292 that determine the role you are playing when composing a message.
9293 <P>
9294 You may play different roles depending on who you are replying to.
9295 For example, if you are replying to a message addressed to help-desk you
9296 may be acting as a Help Desk Worker.
9297 That role may require that you use a different return address and/or
9298 a different signature.
9299 <P>
9300 Roles are optional.
9301 If you set up roles they work like this:  Each role has a set of
9302 &quot;Uses&quot;, which indicate whether or not a role is eligible to be
9303 considered for a particular use; a &quot;Pattern&quot;,
9304 which is used to decide which of the eligible roles is used; and a set
9305 of &quot;Actions&quot;, which are taken when that role is used.
9306 When you reply to a message, the message you are replying to is compared
9307 with the Patterns of the roles marked as eligible for use when replying.
9308 The comparisons start with the first eligible role and keep going until there
9309 is a match.
9310 If a match is found, the matching role's Actions are taken.
9311 <P>
9312 It is also possible to set a default role and to change that role during
9313 your Alpine session.
9314 When you start Alpine no default role will be set.
9315 You may set or change the current default role by using the &quot;D&quot;
9316 command in the role selection screen.
9317 You'll see that screen while composing a message and being asked to select
9318 a role.
9319 An easy way to get to that screen is to use the <A HREF="h_common_role">Role Command</A> to
9320 compose a message.
9321 You may find a default role useful if you normally perform the duties of one
9322 of your roles for a while, then you switch to another role and stay in the
9323 new role for another period of time.
9324 It may be easier than using the Role Command to select the role each time you
9325 compose a message.
9326
9327 <H2>Role Uses</H2>
9328
9329 There are three types of use to be configured;
9330 one for Replying, one for Forwarding, and one for Composing.
9331 These indicate whether or not you want a role to be considered when you
9332 type the Reply, Forward, or Compose commands.
9333 (The Role command is an alternate form of the Compose command, and it is
9334 not affected by these settings.)
9335 Each of these Use types has three possible values.
9336 The value &quot;Never&quot;
9337 means that the role will never be considered as a candidate for use with
9338 the corresponding command.
9339 For example, if you set a role's Reply Use to Never, then when you Reply to
9340 a message, that role won't even be considered.
9341 (That isn't quite true. If the message you are replying to matches some other
9342 role that requires confirmation,
9343 then there will be a ^T command available which allows you to select a role
9344 from all of your roles, not just the reply-eligible roles.)
9345 <P>
9346
9347 The options &quot;With confirmation&quot; and &quot;Without confirmation&quot;
9348 both mean that you do want to consider this role when using the corresponding
9349 command.
9350 For either of these settings the role's Pattern will
9351 be checked to see if it matches the message.
9352 For Reply Use, the message used to compare the Pattern with is the message
9353 being replied to.
9354 For Forward Use, the message used to compare the Pattern with is the message
9355 being forwarded.
9356 For Compose Use, there is no message, so the parts of the Pattern that depend
9357 on a message (everything other than Current Folder Type) are ignored.
9358 In all cases, the Current Folder Type is checked if defined.
9359 If there is a match then this role will either be used without confirmation
9360 or will be the default when confirmation is asked for, depending on
9361 which of the two options is selected.
9362 If confirmation is requested, you will have a chance to
9363 choose No Role instead of the offered role, or to
9364 change the role to any one of your other roles (with the ^T command).
9365
9366 <H2>Role Patterns</H2>
9367
9368 In order to determine whether or not a message matches a role the message is
9369 compared with the Role's Pattern.
9370 These Patterns are the same for use with Roles, Filtering, Index Coloring,
9371 Scoring, Other Rules, and Search Rules, so are described in only one place,
9372 &quot;<A HREF="h_rule_patterns">here</A>&quot;.
9373 <P>
9374 Since header patterns, AllText patterns, and BodyText patterns that are unset are ignored,
9375 a role that has all header patterns unset, the AllText pattern unset,
9376 the BodyText pattern unset,
9377 the Score Interval unset, and the Current Folder Type set to
9378 &quot;Any&quot; may be used as a default role.
9379 It should be put last in the list of roles since the matching
9380 starts at the beginning and proceeds until one of the roles is a match.
9381 If no roles at all match, then Alpine will
9382 use its regular methods of defining the role.
9383 If you wanted to, you could define a different &quot;default&quot; role
9384 for Replying, Forwarding, and Composing by setting the
9385 &quot;Use&quot; fields appropriately.
9386
9387 <H2>Role Actions</H2>
9388
9389 Once a role match is found, the role's Actions are taken.
9390 For each role there are several possible actions that may be defined.
9391 They are actions to set the From address, the Reply-To address,
9392 the Fcc, the Signature, the Template file, and Other Headers.
9393
9394 <H3>Set From</H3>
9395
9396 The From address is the address used on the From line of the message
9397 you are sending.
9398
9399 <H3>Set Reply-To</H3>
9400
9401 The Reply-To address is the address used on the Reply-To line of the message
9402 you are sending.
9403 You don't need a Reply-To address unless it is different from the From address.
9404
9405 <H3>Set Other Headers</H3>
9406
9407 If you want to set the value of the From or Reply-To headers, use
9408 the specific fields &quot;Set From&quot; or &quot;Set Reply-To&quot;.
9409 If you want to set the values of other headers, use this field.
9410 This field is similar to the
9411 <A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A> configuration option.
9412 Each header you specify here must include the header tag
9413 (&quot;To:&quot;, &quot;Approved:&quot;, etc.)
9414 and may optionally include a value for that header.
9415 It is different from the <!--#echo var="VAR_customized-hdrs"--> in that the value you give
9416 for a header here will replace any value that already exists.
9417 For example, if you are Replying to a message there will be at least one
9418 address in the To header (the address you are Replying to).
9419 However, if you Reply using a role that sets the To header, that role's
9420 To header value will be used instead.
9421
9422 <H3>Set Fcc</H3>
9423
9424 The Fcc is used as the Fcc for the message you are sending.
9425
9426 <H3>Set Signature or Set LiteralSig</H3>
9427
9428 The Signature is the name of a file to be used as the signature file when
9429 this role is being used.
9430 If the name of the file has a vertical bar following it (|)
9431 then it is assumed that the file is a program that should be run to
9432 produce the signature.
9433 If the LiteralSig is set, then it is used instead of the signature file.
9434 LiteralSig is just a different way to store the signature.
9435 It is stored in the pine configuration file instead of in a separate
9436 signature file.
9437 If the <A HREF="h_config_literal_sig"><!--#echo var="VAR_literal-signature"--></A> option is defined
9438 either in the role or as the default signature in the Setup/Config screen,
9439 then the signature file is ignored.
9440
9441 <H3>Set Template</H3>
9442
9443 A Template is the name of a file to be included in the message when this
9444 role is being used.
9445 If the name of the file has a vertical bar following it (|)
9446 then it is assumed that the file is a program that should be run to
9447 produce the template.
9448
9449 <P>
9450 Both signature files and template files may be stored remotely on an IMAP
9451 server.
9452 In order to do that you just give the file a remote name.
9453 This works just like the regular
9454 <A HREF="h_config_signature_file"><!--#echo var="VAR_signature-file"--></A>
9455 option that is configured from the Setup/Configuration screen.
9456 A remote signature file name might look like:
9457 <P>
9458 <CENTER><SAMP>{myimaphost.myschool.k12.wa.us}mail/sig3</SAMP></CENTER>
9459 <P>
9460 Once you have named the remote signature or template file you create its
9461 contents by using the &quot;F&quot; &quot;editFile&quot; command when the
9462 cursor is on the &quot;Set Signature&quot; or &quot;Set Template&quot;
9463 line of the role editor.
9464
9465 <P>
9466 Both signature files and template files (or the output of signature programs
9467 and template file programs) may contain special tokens
9468 that are replaced with contents
9469 that depend on the message being replied to or forwarded.
9470 See the help for the individual fields inside the role editor for more
9471 information on tokens.
9472
9473 <H3>Use SMTP Server</H3>
9474
9475 If this field has a value, then it will be used as the SMTP server
9476 to send mail when this role is being used (unless the SMTP server variable
9477 is set in the system-wide fixed configuration file).
9478 It has the same semantics as the
9479 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>
9480 variable in the Setup/Config screen.
9481 When you postpone the composition this SMTP server list will be saved
9482 with the postponed composition and it cannot be changed later.
9483 Because of that, you may want to make this a list of SMTP servers
9484 with the preferred server at the front of the list and alternate servers
9485 later in the list.
9486
9487 <P>
9488 If any of the actions are left unset, then the action depends on what
9489 is present in the &quot;Initialize settings using role&quot; field.
9490 If you've listed the nickname of another one of your roles there, then the
9491 corresponding action from that role will be used here.
9492 If that action is also blank, or if there is no nickname specified,
9493 then Alpine will do whatever it normally does to set these actions.
9494 This depends on other configuration options and features you've set.
9495
9496 <H2>Command Descriptions</H2>
9497
9498 <H3>Add</H3>
9499
9500 The Add command is used to add a new role definition to your set of
9501 roles.
9502 The new role will be added after the highlighted role.
9503
9504 <H3>Delete</H3>
9505
9506 The Delete command deletes the currently highlighted role.
9507
9508 <H3>Change</H3>
9509
9510 The Change command lets you edit the nickname, Uses, Pattern,
9511 and Actions of the currently highlighted role.
9512
9513 <H3>Shuffle</H3>
9514
9515 The Shuffle command allows you to change the order of the roles.
9516 You may move the currently highlighted role up or down in the list.
9517 The order of the roles is important since the roles are tested for a
9518 match starting with the first role and continuing until a match is found.
9519 You should place the roles with more specific Patterns near the beginning
9520 of the list, and those with more general Patterns near the end so that
9521 the more specific matches will happen when appropriate.
9522
9523 <H3>Replicate</H3>
9524
9525 The Replicate command is used to copy an existing role and modify it.
9526 The new role will be added after the highlighted role.
9527
9528 <H3>IncludeFile</H3>
9529
9530 The IncludeFile command allows you to add a roles file to your configuration.
9531 Usually, your roles will be contained in your Alpine configuration file.
9532 If you wish, some or all of your roles may be stored in a separate file.
9533 If a roles file already exists (maybe it was made by somebody else using
9534 Alpine), you may insert it before the currently highlighted role.
9535 You may also insert an empty file or a file that does not yet exist.
9536 Once you have an empty roles file in your configuration, you may use
9537 the Shuffle command to move roles into it.
9538 In fact, that's the only way to get the initial role into the file.
9539
9540 <H3>eXcludeFile</H3>
9541
9542 The eXcludeFile command removes a roles file from your roles configuration.
9543 A limitation of the program is that in order to exclude a roles file
9544 that file must have at least one role
9545 in it, otherwise you won't be able to highlight a line in the file.
9546 So you may have to add a dummy role to the file in order to exclude the file.
9547 <P><UL>
9548 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
9549 </UL>
9550 <P>
9551 &lt;End of help on this topic&gt;
9552 </BODY>
9553 </HTML>
9554 ===== h_rules_other =====
9555 <HTML>
9556 <HEAD>
9557 <TITLE>SETUP OTHER RULES SCREEN</TITLE>
9558 </HEAD>
9559 <BODY>
9560 <H1>SETUP OTHER RULES SCREEN</H1>
9561 <H2>SETUP OTHER RULES COMMANDS</H2>
9562 <!--chtml if pinemode="function_key"-->
9563 <PRE>
9564 Available  Commands -- Group 1         Available Commands -- Group 2
9565 -------------------------------        ------------------------------
9566 F1  Show Help Text                      F1  Show Help Text
9567 F2  See commands in next group          F2  See commands in next group
9568 F3  Back to MAIN Alpine menu
9569 F4  Change configuration for rule
9570 F5  Move to previous rule               F5  Include file in rule config
9571 F6  Move to next rule                   F6  Exclude file from config
9572 F7  Previous page of rules
9573 F8  Next page of rules
9574 F9  Add new rule                        F9  Replicate existing rule
9575 F10 Delete existing rule
9576 F11 Shuffle the order of rules
9577 F12 Whereis (search rule nicknames)
9578 </PRE>
9579 <!--chtml else-->
9580 <PRE>
9581 Navigation                     General Alpine Commands
9582 -------------------------      -----------------------
9583  P  Prev rule                     ?  Display this help text
9584  N  Next rule                     E  Back to MAIN Alpine menu
9585  -  Previous page
9586 Spc (space bar) Next page
9587  W  WhereIs (search for word in rule nicknames)
9588
9589 Setup Other Rules Commands
9590 ------------------------------------------------
9591  A  Add new rule                  $  Shuffle the order of rules
9592  D  Delete existing rule          C  Change configuration for highlighted rule
9593  R  Replicate existing rule
9594  I  Include file in rule config   X  Exclude file from rule config
9595 </PRE>
9596 <!--chtml endif-->
9597
9598 <H2>Description of the Setup Other Rules Screen</H2>
9599
9600 This is where you may set various actions that do not fit well into the
9601 other Rules categories.
9602
9603 <H2>Patterns</H2>
9604
9605 Other Rules are a little different from the rest of the Rules because
9606 they depend only on the current folder, and not on a particular message.
9607 In order to determine whether or not a rule's actions should be applied
9608 the current folder is compared with the rule's Pattern, which consists
9609 of only the Current Folder Type.
9610 Current Folder Type works the same for Other Rules as it does for Roles,
9611 Filtering, Index Coloring, and Scoring.
9612 Keep in mind that the only part of the Pattern that applies to Other
9613 Rules is the Current Folder Type when looking at the description of
9614 Patterns given
9615 &quot;<A HREF="h_rule_patterns">here</A>&quot;.
9616
9617 <H2>The Actions</H2>
9618
9619 <H3>Set Sort Order</H3>
9620
9621 When you enter a new folder, these rules will be checked to see if you
9622 have set a sort order that is different from your default sort order.
9623 The default is set in the Setup/Config screen with
9624 the &quot;<A HREF="h_config_sort_key"><!--#echo var="VAR_sort-key"--></A>&quot; option.
9625 If the Sort Order action is set, then the folder will be displayed sorted in
9626 that sort order instead of in the default order.
9627 <P>
9628 A possible point of confusion arises when you change the configuration
9629 of the Sort Order for the currently open folder.
9630 The folder will normally be re-sorted when you go back to viewing the
9631 index.
9632 However, if you have manually sorted the folder with the
9633 Sort
9634 (<!--chtml if pinemode="function_key"-->F7<!--chtml else-->$<!--chtml endif-->)
9635 command, then it will not be re-sorted until the next time it is opened.
9636
9637 <H3>Set Index Format</H3>
9638
9639 When you enter a new folder, these rules will be checked to see if you
9640 have set an Index Format that is different from your default Index Format,
9641 which is set with the
9642 <A HREF="h_config_index_format">&quot;<!--#echo var="VAR_index-format"-->&quot;</A> option.
9643 If so, the index will be displayed with this format instead of the default.
9644
9645 <H3>Set Startup Rule</H3>
9646
9647 When you enter a new folder, these rules will be checked to see if you
9648 have set a startup rule that is different from the default startup rule.
9649 The default for incoming folders is set in the Setup/Config screen with
9650 the &quot;<!--#echo var="VAR_incoming-startup-rule"-->&quot; option.
9651 The default for folders other than INBOX that are not part of your
9652 incoming collection
9653 (see <A HREF="h_config_enable_incoming"><!--#echo var="FEAT_enable-incoming-folders"--></A> feature)
9654 is to start with the last message in the folder.
9655 If the Startup Rule is set to something other than &quot;default&quot;,
9656 then the rule will determine which message will be the current message when
9657 the folder is first opened.
9658 <P>
9659 The various startup rule possibilities work the same here as they do in
9660 the incoming collection, so check
9661 <A HREF="h_config_inc_startup"><!--#echo var="VAR_incoming-startup-rule"--></A>
9662 for more help.
9663
9664 <H2>Command Descriptions</H2>
9665
9666 <H3>Add</H3>
9667
9668 The Add command is used to add a new rule definition to your set of
9669 rules.
9670 The new rule will be added after the highlighted rule.
9671
9672 <H3>Delete</H3>
9673
9674 The Delete command deletes the currently highlighted rule.
9675
9676 <H3>Change</H3>
9677
9678 The Change command lets you edit the nickname, Pattern,
9679 and Action of the currently highlighted rule.
9680
9681 <H3>Shuffle</H3>
9682
9683 The Shuffle command allows you to change the order of the rules.
9684 You may move the currently highlighted rule up or down in the list.
9685 The order of the rules is important since the rules are tested for a
9686 match starting with the first rule and continuing until a match is found.
9687 You should place the rules with more specific Patterns near the beginning
9688 of the list, and those with more general Patterns near the end so that
9689 the more specific matches will happen when appropriate.
9690
9691 <H3>Replicate</H3>
9692
9693 The Replicate command is used to copy an existing rule definition and modify it.
9694 The new rule will be added after the highlighted rule.
9695
9696 <H3>IncludeFile</H3>
9697
9698 The IncludeFile command allows you to add a rules file to your configuration.
9699 Usually, your rules will be contained in your Alpine configuration file.
9700 If you wish, some or all of your rules may be stored in a separate file.
9701 If a rules file already exists (maybe it was made by somebody else using
9702 Alpine), you may insert it before the currently highlighted rule.
9703 You may also insert an empty file or a file that does not yet exist.
9704 Once you have an empty rules file in your configuration, you may use
9705 the Shuffle command to move rules into it.
9706 In fact, that's the only way to get the initial rule into the file.
9707
9708 <H3>eXcludeFile</H3>
9709
9710 The eXcludeFile command removes a rules file from your rules configuration.
9711 A limitation of the program is that in order to exclude a rules file
9712 that file must have at least one rule
9713 in it, otherwise you won't be able to highlight a line in the file.
9714 So you may have to add a dummy rule to the file in order to exclude the file.
9715 <P><UL>
9716 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
9717 </UL>
9718 <P>
9719 &lt;End of help on this topic&gt;
9720 </BODY>
9721 </HTML>
9722 ===== h_rules_srch =====
9723 <HTML>
9724 <HEAD>
9725 <TITLE>SETUP SEARCH RULES SCREEN</TITLE>
9726 </HEAD>
9727 <BODY>
9728 <H1>SETUP SEARCH RULES SCREEN</H1>
9729 <H2>SETUP SEARCH RULES COMMANDS</H2>
9730 <!--chtml if pinemode="function_key"-->
9731 <PRE>
9732 Available  Commands -- Group 1         Available Commands -- Group 2
9733 -------------------------------        ------------------------------
9734 F1  Show Help Text                      F1  Show Help Text
9735 F2  See commands in next group          F2  See commands in next group
9736 F3  Back to MAIN Alpine menu
9737 F4  Change configuration for rule
9738 F5  Move to previous rule               F5  Include file in rule config
9739 F6  Move to next rule                   F6  Exclude file from config
9740 F7  Previous page of rules
9741 F8  Next page of rules
9742 F9  Add new rule                        F9  Replicate existing rule
9743 F10 Delete existing rule
9744 F11 Shuffle the order of rules
9745 F12 Whereis (search rule nicknames)
9746 </PRE>
9747 <!--chtml else-->
9748 <PRE>
9749 Navigation                     General Alpine Commands
9750 -------------------------      -----------------------
9751  P  Prev rule                     ?  Display this help text
9752  N  Next rule                     E  Back to MAIN Alpine menu
9753  -  Previous page
9754 Spc (space bar) Next page
9755  W  WhereIs (search for word in rule nicknames)
9756
9757 Setup Search Rules Commands
9758 ------------------------------------------------
9759  A  Add new rule                  $  Shuffle the order of rules
9760  D  Delete existing rule          C  Change configuration for highlighted rule
9761  R  Replicate existing rule
9762  I  Include file in rule config   X  Exclude file from rule config
9763 </PRE>
9764 <!--chtml endif-->
9765
9766 <H2>Description of the Setup Search Rules Screen</H2>
9767
9768 One of the commands that becomes available when that feature is turned on
9769 is the &quot;; Select&quot; command, which is used in the MESSAGE INDEX
9770 screen to select a set of messages.
9771 One way of selecting messages is to use a Rule.
9772 All of the messages that match (or don't match if you wish)
9773 a Rule's Pattern will be selected.
9774 <P>
9775 Any of your Rules may be used for this purpose.
9776 You might already have Rules set up for filtering, index line color, scores, or roles;
9777 and you may use any of those Rules with the Select command.
9778 However, you might find it more convenient to set up a separate set of Rules
9779 just for this purpose without having to worry about what other effects
9780 they may cause.
9781 That is the purpose of these Select Rules.
9782
9783 <P>
9784 Each rule has a &quot;Pattern&quot;
9785 that is used to decide which messages are selected when you use it with
9786 the Select command.
9787
9788 <H2>Patterns</H2>
9789
9790 In order to determine whether or not a message should be selected
9791 the message is compared with the rule's Pattern.
9792 These Patterns are the same for use with Roles, Filtering, Index Coloring,
9793 Scoring, Other Rules, and Search Rules, so are described in only one place,
9794 &quot;<A HREF="h_rule_patterns">here</A>&quot;.
9795
9796 <H2>Command Descriptions</H2>
9797
9798 <H3>Add</H3>
9799
9800 The Add command is used to add a new rule definition to your set of
9801 rules.
9802 The new rule will be added after the highlighted rule.
9803
9804 <H3>Delete</H3>
9805
9806 The Delete command deletes the currently highlighted rule.
9807
9808 <H3>Change</H3>
9809
9810 The Change command lets you edit the nickname and Pattern
9811 of the currently highlighted rule.
9812
9813 <H3>Shuffle</H3>
9814
9815 The Shuffle command allows you to change the order of the rules.
9816 This affects only the order they are presented in when you use the
9817 ^T subcommand of the Select by Rule command.
9818 You may move the currently highlighted rule up or down in the list.
9819
9820 <H3>Replicate</H3>
9821
9822 The Replicate command is used to copy an existing rule definition and modify it.
9823 The new rule will be added after the highlighted rule.
9824
9825 <H3>IncludeFile</H3>
9826
9827 The IncludeFile command allows you to add a rules file to your configuration.
9828 Usually, your rules will be contained in your Alpine configuration file.
9829 If you wish, some or all of your rules may be stored in a separate file.
9830 If a rules file already exists (maybe it was made by somebody else using
9831 Alpine), you may insert it before the currently highlighted rule.
9832 You may also insert an empty file or a file that does not yet exist.
9833 Once you have an empty rules file in your configuration, you may use
9834 the Shuffle command to move rules into it.
9835 In fact, that's the only way to get the initial rule into the file.
9836
9837 <H3>eXcludeFile</H3>
9838
9839 The eXcludeFile command removes a rules file from your rules configuration.
9840 A limitation of the program is that in order to exclude a rules file
9841 that file must have at least one rule
9842 in it, otherwise you won't be able to highlight a line in the file.
9843 So you may have to add a dummy rule to the file in order to exclude the file.
9844 <P><UL>
9845 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
9846 </UL>
9847 <P>
9848 &lt;End of help on this topic&gt;
9849 </BODY>
9850 </HTML>
9851 ===== h_rules_incols =====
9852 <HTML>
9853 <HEAD>
9854 <TITLE>SETUP INDEX LINE COLORS SCREEN</TITLE>
9855 </HEAD>
9856 <BODY>
9857 <H1>SETUP INDEX LINE COLORS SCREEN</H1>
9858 <H2>SETUP INDEX LINE COLORS COMMANDS</H2>
9859 <!--chtml if pinemode="function_key"-->
9860 <PRE>
9861 Available  Commands -- Group 1         Available Commands -- Group 2
9862 -------------------------------        ------------------------------
9863 F1  Show Help Text                      F1  Show Help Text
9864 F2  See commands in next group          F2  See commands in next group
9865 F3  Back to MAIN Alpine menu
9866 F4  Change configuration for rule
9867 F5  Move to previous rule               F5  Include file in rule config
9868 F6  Move to next rule                   F6  Exclude file from config
9869 F7  Previous page of rules
9870 F8  Next page of rules
9871 F9  Add new rule                        F9  Replicate existing rule
9872 F10 Delete existing rule
9873 F11 Shuffle the order of rules
9874 F12 Whereis (search rule nicknames)
9875 </PRE>
9876 <!--chtml else-->
9877 <PRE>
9878 Navigation                     General Alpine Commands
9879 -------------------------      -----------------------
9880  P  Prev rule                     ?  Display this help text
9881  N  Next rule                     E  Back to MAIN Alpine menu
9882  -  Previous page
9883 Spc (space bar) Next page
9884  W  WhereIs (search for word in rule nicknames)
9885
9886 Setup Index Color Commands
9887 ------------------------------------------------
9888  A  Add new rule                  $  Shuffle the order of rules
9889  D  Delete existing rule          C  Change configuration for highlighted rule
9890  R  Replicate existing rule
9891  I  Include file in rule config   X  Exclude file from rule config
9892 </PRE>
9893 <!--chtml endif-->
9894
9895 <H2>Description of the Setup Index Line Colors Screen</H2>
9896
9897 Index Line Color causes lines in the MESSAGE INDEX screen to be colored.
9898 This action is only available if your terminal is capable of displaying
9899 color and color display has been enabled with the
9900 <A HREF="h_config_color_style">Color Style</A> option within the
9901 Setup Color screen.
9902 (In PC-Alpine, color is always enabled so there is no option to turn on.)
9903 This screen lets you add, delete, modify, or change the order of the rules
9904 that cause the lines in the MESSAGE INDEX to be displayed in different
9905 colors.
9906 <P>
9907 Each rule has a &quot;Pattern&quot;,
9908 which is used to decide which of the rules is used; and the color that
9909 is used if the Pattern matches a particular message.
9910
9911 <H2>Index Color Patterns</H2>
9912
9913 In order to determine whether or not a message matches an Index Color Rule
9914 the message is compared with the rule's Pattern.
9915 These Patterns are the same for use with Roles, Filtering, Index Coloring,
9916 Scoring, Other Rules, and Search Rules, so are described in only one place,
9917 &quot;<A HREF="h_rule_patterns">here</A>&quot;.
9918
9919 <P>
9920 If none of the Index Color rules is a match for a particular index line,
9921 then the color used is set using
9922 the <A HREF="h_color_setup">Setup Kolor</A> screen.
9923
9924 <H2>Index Line Color</H2>
9925
9926 This is the color that index lines are colored when there is a matching
9927 Pattern.
9928 This colors the whole index line, except possibly the status letters,
9929 which may be colored separately using
9930 the <A HREF="h_color_setup">Setup Kolor</A> screen.
9931
9932 <H2>Command Descriptions</H2>
9933
9934 <H3>Add</H3>
9935
9936 The Add command is used to add a new rule definition to your set of
9937 rules.
9938 The new rule will be added after the highlighted rule.
9939
9940 <H3>Delete</H3>
9941
9942 The Delete command deletes the currently highlighted rule.
9943
9944 <H3>Change</H3>
9945
9946 The Change command lets you edit the nickname, Pattern,
9947 and Index Line Color of the currently highlighted rule.
9948
9949 <H3>Shuffle</H3>
9950
9951 The Shuffle command allows you to change the order of the rules.
9952 You may move the currently highlighted rule up or down in the list.
9953 The order of the rules is important since the rules are tested for a
9954 match starting with the first rule and continuing until a match is found.
9955 You should place the rules with more specific Patterns near the beginning
9956 of the list, and those with more general Patterns near the end so that
9957 the more specific matches will happen when appropriate.
9958
9959 <H3>Replicate</H3>
9960
9961 The Replicate command is used to copy an existing rule definition and modify it.
9962 The new rule will be added after the highlighted rule.
9963
9964 <H3>IncludeFile</H3>
9965
9966 The IncludeFile command allows you to add a rules file to your configuration.
9967 Usually, your rules will be contained in your Alpine configuration file.
9968 If you wish, some or all of your rules may be stored in a separate file.
9969 If a rules file already exists (maybe it was made by somebody else using
9970 Alpine), you may insert it before the currently highlighted rule.
9971 You may also insert an empty file or a file that does not yet exist.
9972 Once you have an empty rules file in your configuration, you may use
9973 the Shuffle command to move rules into it.
9974 In fact, that's the only way to get the initial rule into the file.
9975
9976 <H3>eXcludeFile</H3>
9977
9978 The eXcludeFile command removes a rules file from your rules configuration.
9979 A limitation of the program is that in order to exclude a rules file
9980 that file must have at least one rule
9981 in it, otherwise you won't be able to highlight a line in the file.
9982 So you may have to add a dummy rule to the file in order to exclude the file.
9983 <P><UL>
9984 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
9985 </UL>
9986 <P>
9987 &lt;End of help on this topic&gt;
9988 </BODY>
9989 </HTML>
9990 ===== h_rules_filter =====
9991 <HTML>
9992 <HEAD>
9993 <TITLE>SETUP FILTERING SCREEN</TITLE>
9994 </HEAD>
9995 <BODY>
9996 <H1>SETUP FILTERING SCREEN</H1>
9997 <H2>SETUP FILTERING COMMANDS</H2>
9998 <!--chtml if pinemode="function_key"-->
9999 <PRE>
10000 Available  Commands -- Group 1         Available Commands -- Group 2
10001 -------------------------------        ------------------------------
10002 F1  Show Help Text                      F1  Show Help Text
10003 F2  See commands in next group          F2  See commands in next group
10004 F3  Back to MAIN Alpine menu
10005 F4  Change configuration for filter
10006 F5  Move to previous filter             F5  Include file in filter config
10007 F6  Move to next filter                 F6  Exclude file from config
10008 F7  Previous page of filters
10009 F8  Next page of filters
10010 F9  Add new filter                      F9  Replicate existing filter
10011 F10 Delete existing filter
10012 F11 Shuffle the order of filters
10013 F12 Whereis (search filter nicknames)
10014 </PRE>
10015 <!--chtml else-->
10016 <PRE>
10017 Navigation                     General Alpine Commands
10018 -------------------------      -----------------------
10019  P  Prev Filter                   ?  Display this help text
10020  N  Next Filter                   E  Back to MAIN Alpine menu
10021  -  Previous page
10022 Spc (space bar) Next page
10023  W  WhereIs (search for word in filter nicknames)
10024
10025 Setup Filters Commands
10026 ------------------------------------------------
10027  A  Add new filter                $  Shuffle the order of filters
10028  D  Delete existing filter        C  Change configuration for highlighted filter
10029  R  Replicate existing filter
10030  I  Include file in filter config X  Exclude file from filter config
10031 </PRE>
10032 <!--chtml endif-->
10033
10034 <H2>Description of the Setup Filtering Screen</H2>
10035
10036 This screen lets you add, delete, modify, or change the order of the rules
10037 that determine the filtering Alpine does on folders you view.
10038 <P>
10039 The software that actually delivers mail (the stuff that happens
10040 before Alpine is involved) for you is in a better position to do mail filtering
10041 than Alpine itself.
10042 If possible, you may want to look into using that sort of mail filtering to
10043 deliver mail to different folders, delete it, or forward it.
10044 However, if you'd like Alpine to help with this, Alpine's filtering is for you.
10045 <P>
10046 Filtering is a way to automatically move certain messages from one folder
10047 to another or to delete messages.
10048 It can also be used to set message status (Important, Deleted, New,
10049 Answered) and to set <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> for messages.
10050 Alpine doesn't have the ability to forward mail to another address or
10051 to deliver vacation messages.
10052 <P>
10053 Each filtering rule has a &quot;Pattern&quot; and a &quot;Filter Action&quot;.
10054 When a folder is opened, when new mail arrives in an open folder, or
10055 when mail is Expunged from a folder; each
10056 message is compared with the Patterns of your filtering rules.
10057 The comparisons start with the first rule and keep going until there
10058 is a match.
10059 If a match is found, the message may be deleted or moved, depending on
10060 the setting of the Filter Action.
10061 If the message is not deleted, it may have its status altered.
10062
10063 <P>
10064 <EM>NOTE:</EM>
10065 When setting up a Pattern used to delete messages,
10066 it is recommended that you test the Pattern first with a &quot;Move&quot;
10067 folder specified in
10068 case unintended matches occur.  Messages that are deleted will be removed
10069 from the folder and <EM>unrecoverable</EM> from within Alpine after the
10070 next Expunge command or once the folder being filtered has been closed.
10071
10072 <H2>Filter Patterns</H2>
10073
10074 In order to determine whether or not a message matches a filter the message is
10075 compared with the Filter's Pattern.
10076 These Patterns are the same for use with Roles, Filtering, Index Coloring,
10077 Scoring, Other Rules, and Search Rules, so are described in only one place,
10078 &quot;<A HREF="h_rule_patterns">here</A>&quot;.
10079 <P>
10080 Since filtering is a potentially destructive action, if you have a filtering
10081 Pattern with nothing other than Current Folder Type set, that filtering
10082 rule is ignored.
10083
10084 <H2>Filter Actions</H2>
10085
10086 Once a filter match is found for a particular message, there are some actions
10087 that may be taken.
10088 First, the message may have its status changed.
10089 This is the same message status that you can manipulate manually using the
10090 <a href="h_common_flag">Flag Command</a>.
10091 There are always four elements of message status that you can control.
10092 You can set or clear the Important status, the New status, the Deleted
10093 status, and the Answered status.
10094 Of course, if the filter is going to delete the message,
10095 then there is no point in setting message status.
10096 You may also be able to set user-defined keywords for a message.
10097 Read a little about keywords in the help text for the
10098 <A HREF="h_common_flag">Flag</A> command.
10099 <P>
10100 Second, the filter may delete or move the message.
10101 Deleting the message marks it Deleted and removes it from view.
10102 It is effectively gone forever (though it technically is still there until
10103 the next expunge command, which may happen implicitly).
10104 Moving the message moves it from the open folder into the folder
10105 listed on the &quot;Folder List&quot; line of the filter configuration.
10106 If you list more than one folder name (separated by commas) then the message
10107 will be copied to each of those folders.
10108 In any case, if &quot;Delete&quot; or &quot;Move&quot; is set then the
10109 message is removed from the current folder.
10110 If you just want to set the messages status without deleting it from
10111 the folder, then set the filter action to
10112 &quot;Just Set Message Status&quot;.
10113 <P>
10114 (There is no way to do a Copy instead of a Move, due to the difficulties
10115 involved in keeping track of whether or not a message has
10116 already been copied.)
10117
10118 <H2>Command Descriptions</H2>
10119
10120 <H3>Add</H3>
10121
10122 The Add command is used to add a new filter definition to your set of
10123 filters.
10124 The new filter will be added after the highlighted filter.
10125
10126 <H3>Delete</H3>
10127
10128 The Delete command deletes the currently highlighted filter.
10129
10130 <H3>Change</H3>
10131
10132 The Change command lets you edit the nickname, Pattern,
10133 and Folder of the currently highlighted filter.
10134
10135 <H3>Shuffle</H3>
10136
10137 The Shuffle command allows you to change the order of the filters.
10138 You may move the currently highlighted filter up or down in the list.
10139 The order of the filters is important since the filters are tested for a
10140 match starting with the first filter and continuing until a match is found.
10141 You should place the filters with more specific Patterns near the beginning
10142 of the list, and those with more general Patterns near the end so that
10143 the more specific matches will happen when appropriate.
10144
10145 <H3>Replicate</H3>
10146
10147 The Replicate command is used to copy an existing filter and modify it.
10148 The new filter will be added after the highlighted filter.
10149
10150 <H3>IncludeFile</H3>
10151
10152 The IncludeFile command allows you to add a filters file to your configuration.
10153 Usually, your filters will be contained in your Alpine configuration file.
10154 If you wish, some or all of your filters may be stored in a separate file.
10155 If a filters file already exists (maybe it was made by somebody else using
10156 Alpine), you may insert it before the currently highlighted filter.
10157 You may also insert an empty file or a file that does not yet exist.
10158 Once you have an empty filters file in your configuration, you may use
10159 the Shuffle command to move filters into it.
10160 In fact, that's the only way to get the initial filter into the file.
10161
10162 <H3>eXcludeFile</H3>
10163
10164 The eXcludeFile command removes a filters file from your filters configuration.
10165 A limitation of the program is that in order to exclude a filters file
10166 that file must have at least one filter
10167 in it, otherwise you won't be able to highlight a line in the file.
10168 So you may have to add a dummy filter to the file in order to exclude the file.
10169 <P><UL>
10170 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
10171 </UL>
10172 <P>
10173 <H3>Performance Considerations</H3>
10174 The number and type of patterns being tested can
10175 adversely effect performance.  Issues to be aware
10176 of include:
10177 <P>
10178 <UL>
10179   <LI> The more filters you have defined the longer it will take to run down
10180 the list.  Deleting unused filters is a good idea.
10181   <LI> Filtering in newsgroups served by an NNTP server will be slow
10182 if your patterns include tests other than &quot;From:&quot;
10183 or &quot;Subject:&quot;.
10184 </UL>
10185 <P>
10186 &lt;End of help on this topic&gt;
10187 </BODY>
10188 </HTML>
10189 ===== h_rules_score =====
10190 <HTML>
10191 <HEAD>
10192 <TITLE>SETUP SCORING SCREEN</TITLE>
10193 </HEAD>
10194 <BODY>
10195 <H1>SETUP SCORING SCREEN</H1>
10196 <H2>SETUP SCORING COMMANDS</H2>
10197 <!--chtml if pinemode="function_key"-->
10198 <PRE>
10199 Available  Commands -- Group 1         Available Commands -- Group 2
10200 -------------------------------        ------------------------------
10201 F1  Show Help Text                      F1  Show Help Text
10202 F2  See commands in next group          F2  See commands in next group
10203 F3  Back to MAIN Alpine menu
10204 F4  Change configuration for rule
10205 F5  Move to previous rule               F5  Include file in rule config
10206 F6  Move to next rule                   F6  Exclude file from config
10207 F7  Previous page of rules
10208 F8  Next page of rules
10209 F9  Add new rule                        F9  Replicate existing rule
10210 F10 Delete existing rule
10211 F11 Shuffle the order of rules
10212 F12 Whereis (search rule nicknames)
10213 </PRE>
10214 <!--chtml else-->
10215 <PRE>
10216 Navigation                     General Alpine Commands
10217 -------------------------      -----------------------
10218  P  Prev rule                     ?  Display this help text
10219  N  Next rule                     E  Back to MAIN Alpine menu
10220  -  Previous page
10221 Spc (space bar) Next page
10222  W  WhereIs (search for word in rule nicknames)
10223
10224 Setup Scoring Commands
10225 ------------------------------------------------
10226  A  Add new rule                  $  Shuffle the order of rules
10227  D  Delete existing rule          C  Change configuration for highlighted rule
10228  R  Replicate existing rule
10229  I  Include file in rule config   X  Exclude file from rule config
10230 </PRE>
10231 <!--chtml endif-->
10232
10233 <H2>Description of the Setup Scoring Screen</H2>
10234
10235 Most people will not use scores at all, but if you do use them, here's how
10236 they work in Alpine.
10237 Using this screen, you may define Scoring rules.
10238 The score for a message is calculated by looking at every Score rule defined
10239 and adding up the Score Values for the ones that match the message.
10240 If there are no matches for a message, it has a score of zero.
10241 Message scores may be used a couple of ways in Alpine.
10242
10243 <H3>Sorting by Score</H3>
10244
10245 One of the methods you may use to sort message indexes is to sort by
10246 score.
10247 The scores of all the messages in a folder will be calculated and then
10248 the index will be ordered by placing the messages in order of ascending or
10249 descending score.
10250
10251 <H3>Scores for use in Patterns</H3>
10252
10253 The Patterns used for Roles, Index Line Coloring, and Filtering have a
10254 category labeled &quot;Score Interval&quot;.
10255 When a message is being compared with a Pattern to check for a match, if
10256 the Score Interval is set only messages that have a score somewhere in
10257 the interval are a match.
10258
10259 <H2>Scoring Rule Patterns</H2>
10260
10261 In order to determine whether or not a message matches a scoring rule
10262 the message is compared with the rule's Pattern.
10263 These Patterns are the same for use with Roles, Filtering, Index Coloring,
10264 Scoring, Other Rules, and Search Rules, so are described in only one place,
10265 &quot;<A HREF="h_rule_patterns">here</A>&quot;.
10266
10267 <P>
10268 Actually, Scoring rule Patterns are slightly different from the other types of
10269 Patterns because Scoring rule Patterns don't contain a Score Interval.
10270 In other words, when calculating the score for a message, which is done
10271 by looking at the Scoring rule Patterns, scores aren't used.
10272
10273 <H2>Score Value</H2>
10274
10275 This is the value that will be added to the score for a message if the
10276 rule's Pattern is a match.
10277 Each individual Score Value is an integer between -100 and 100, and the
10278 values from matching rules are added together to get a message's score.
10279 There is also a way to extract the value from a particular header of each
10280 message. See the help text for Score Value for further information.
10281
10282 <H2>Command Descriptions</H2>
10283
10284 <H3>Add</H3>
10285
10286 The Add command is used to add a new scoring rule definition.
10287 The new rule will be added after the highlighted rule.
10288
10289 <H3>Delete</H3>
10290
10291 The Delete command deletes the currently highlighted scoring rule.
10292
10293 <H3>Change</H3>
10294
10295 The Change command lets you edit the nickname, Pattern,
10296 and Score Value of the currently highlighted scoring rule.
10297
10298 <H3>Shuffle</H3>
10299
10300 The Shuffle command allows you to change the order of the scoring rules.
10301 You may move the currently highlighted rule up or down in the list.
10302 The order of the rules is important since the rules are tested for a
10303 match starting with the first rule and continuing until a match is found.
10304 You should place the rules with more specific Patterns near the beginning
10305 of the list, and those with more general Patterns near the end so that
10306 the more specific matches will happen when appropriate.
10307
10308 <H3>Replicate</H3>
10309
10310 The Replicate command is used to copy an existing rule and modify it.
10311 The new rule will be added after the highlighted rule.
10312
10313 <H3>IncludeFile</H3>
10314
10315 The IncludeFile command allows you to add a rules file to your configuration.
10316 Usually, your rules will be contained in your Alpine configuration file.
10317 If you wish, some or all of your rules may be stored in a separate file.
10318 If a rules file already exists (maybe it was made by somebody else using
10319 Alpine), you may insert it before the currently highlighted rule.
10320 You may also insert an empty file or a file that does not yet exist.
10321 Once you have an empty rules file in your configuration, you may use
10322 the Shuffle command to move rules into it.
10323 In fact, that's the only way to get the initial rule into the file.
10324
10325 <H3>eXcludeFile</H3>
10326
10327 The eXcludeFile command removes a rules file from your rules configuration.
10328 A limitation of the program is that in order to exclude a rules file
10329 that file must have at least one rule
10330 in it, otherwise you won't be able to highlight a line in the file.
10331 So you may have to add a dummy rule to the file in order to exclude the file.
10332 <P><UL>
10333 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
10334 </UL>
10335 <P>
10336 &lt;End of help on this topic&gt;
10337 </BODY>
10338 </HTML>
10339 ===== h_direct_config =====
10340 <HTML>
10341 <HEAD>
10342 <TITLE>SETUP LDAP DIRECTORY SERVERS SCREEN</TITLE>
10343 </HEAD>
10344 <BODY>
10345 <H1>SETUP LDAP DIRECTORY SERVERS SCREEN</H1>
10346 <H2>SETUP LDAP DIRECTORY SERVERS COMMANDS</H2>
10347 <!--chtml if pinemode="function_key"-->
10348 <PRE>
10349 Available  Commands
10350 -------------------------------
10351 F1  Show Help Text
10352 F3  Back to MAIN Alpine menu
10353 F4  Change configuration for directory server
10354 F5  Move to previous directory server
10355 F6  Move to next directory server
10356 F7  Previous page of directory servers
10357 F8  Next page of directory servers
10358 F9  Add new directory server
10359 F10 Delete existing directory server
10360 F11 Shuffle the order of directory servers
10361 F12 Whereis (search directory server titles)
10362 </PRE>
10363 <!--chtml else-->
10364 <PRE>
10365 Navigation                     General Alpine Commands
10366 -------------------------      -----------------------
10367  P  Prev Directory Server         ?  Display this help text
10368  N  Next Directory Server         E  Back to MAIN Alpine menu
10369  -  Previous page
10370 Spc (space bar) Next page
10371  W  WhereIs (search for word in directory server titles)
10372
10373 Setup LDAP Directory Server Commands
10374 ------------------------------------------------
10375  A  Add new directory server      $  Shuffle the order of directory servers
10376  D  Delete existing dir server    C  Change configuration for highlighted server
10377 </PRE>
10378 <!--chtml endif-->
10379
10380 <H2>Description of the Setup LDAP Directory Servers Screen</H2>
10381
10382 This screen lets you add, delete, modify, or change the order of your
10383 directory servers. You may also set some optional behavior for each server.
10384 The &quot;Add Dir&quot; command brings up a blank form to
10385 fill in. You will have to supply at least the name of the LDAP server.
10386 You will often have to supply a search base to be used with that server,
10387 as well. Once the form has been brought up on your screen, there is help
10388 available for each of the options you may set.
10389 <P>
10390 The &quot;Del Dir&quot; command allows you to remove a directory server
10391 from your configuration.
10392 <P>
10393 The &quot;Change&quot; command is similar to the &quot;Add Dir&quot; command.
10394 The difference is that instead of bringing up a form for a new server
10395 configuration, you are changing the configuration of an existing entry.
10396 For example, you might want to correct a typing error, change a
10397 nickname, or change one of the options set for that server.
10398 <P>
10399 The &quot;Shuffle&quot; command is used to change the order of directory
10400 servers.
10401 <P><UL>
10402 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
10403 </UL>
10404 <P>
10405 &lt;End of help on this topic&gt;
10406 </BODY>
10407 </HTML>
10408 ============= h_address_display ========================
10409 <HTML>
10410 <HEAD>
10411 <TITLE>SEARCH RESULTS INDEX</TITLE>
10412 </HEAD>
10413 <BODY>
10414 <H1>SEARCH RESULTS INDEX</H1>
10415 This screen shows the results, if any, of your Directory Server search.
10416 Commands (besides those for screen navigation) are:
10417 <DL>
10418 <DT>View
10419 <!--chtml if pinemode="function_key"-->
10420 (F4)
10421 <!--chtml else-->
10422 (V)
10423 <!--chtml endif-->
10424 </DT>
10425 <DD>See the full information for the selected entry.
10426
10427 <DT>Compose
10428 <!--chtml if pinemode="function_key"-->
10429 (F9)
10430 <!--chtml else-->
10431 (C)
10432 <!--chtml endif--></DT>
10433 <DD>Compose a message with the selected entry as the recipient.
10434
10435 <DT>Role
10436 <!--chtml if pinemode="function_key"-->
10437 (F2)
10438 <!--chtml else-->
10439 (#)
10440 <!--chtml endif--></DT>
10441 <DD>Compose a message with the selected entry as the recipient. This differs
10442 from Compose in that you may select a role before beginning your composition.
10443
10444 <DT>Forward
10445 <!--chtml if pinemode="function_key"-->
10446 (F10)
10447 <!--chtml else-->
10448 (F)
10449 <!--chtml endif--></DT>
10450 <DD>Send the full information for the selected entry as an
10451 email message to someone else.
10452
10453 <DT>Save
10454 <!--chtml if pinemode="function_key"-->
10455 (F11)
10456 <!--chtml else-->
10457 (S)
10458 <!--chtml endif-->
10459 </DT>
10460 <DD>Save to your address book:
10461 <UL>
10462 <LI>the result of the search (as just found through your query) for the
10463 selected entry; or
10464 <LI>the selected entry for repeated Directory Server searching when used
10465 in the future.
10466 </UL>
10467 or<BR>
10468 Export to a file (external to Alpine):
10469 <UL>
10470 <LI>the full information for the selected entry; or
10471 <LI>the email address from the selected entry; or
10472 <LI>the selected entry in <A HREF="h_whatis_vcard">vCard</A> format.
10473 </UL>
10474 <DT>WhereIs
10475 <!--chtml if pinemode="function_key"-->
10476 (F12)
10477 <!--chtml else-->
10478 (W)
10479 <!--chtml endif-->
10480 </DT>
10481 <DD>Search for text in the SEARCH RESULTS INDEX screen. (Searches only the
10482 displayed text, not the full records for each entry.)
10483 </DL>
10484 &lt;End of help on this topic&gt;
10485 </BODY>
10486 </HTML>
10487 ============= h_address_select ========================
10488 <HTML>
10489 <HEAD>
10490 <TITLE>SEARCH RESULTS INDEX</TITLE>
10491 </HEAD>
10492 <BODY>
10493 <H1>SEARCH RESULTS INDEX</H1>
10494 This screen shows the results, if any, of your Directory Server search.
10495 Commands (besides those for screen navigation) are:
10496 <DL>
10497 <DT>Select
10498 </DT>
10499 <DD>Select this entry for use.
10500
10501 <DT>ExitSelect
10502 <DD>Exit without selecting any of the entries.
10503
10504 <DT>WhereIs
10505 </DT>
10506 <DD>Search for text in the SEARCH RESULTS INDEX screen. (Searches only the
10507 displayed text, not the full records for each entry.)
10508 </DL>
10509 &lt;End of help on this topic&gt;
10510 </BODY>
10511 </HTML>
10512 ===== h_folder_maint =====
10513 <HTML>
10514 <HEAD>
10515 <TITLE>Help for Folder List</TITLE>
10516 </HEAD>
10517 <BODY>
10518 <H1>FOLDER LIST COMMANDS</H1>
10519 <!--chtml if pinemode="function_key"-->
10520 <PRE>
10521 Available Commands -- Group 1        Available Commands -- Group 2
10522 -------------------------------      ------------------------------
10523 F1  Show Help Text                    F1  Show Help Text
10524 F2  See commands in next group        F2  See commands in next group
10525 F3  MAIN MENU Screen                  F3  Quit Alpine
10526 F4  Select folder and view it         F4  MAIN MENU Screen
10527 F5  Move to previous folder
10528 F6  Move to next folder               F6  Specify a folder to go to
10529 F7  Show previous screen of listing   F7  Show MESSAGE INDEX of current folder
10530 F8  Show next screen of listing       F8  Compose a message
10531 F9  Add a new folder                  F9  Print folder listing
10532 F10 Delete selected folder
10533 F11 Rename selected folder
10534 F12 Whereis (search folder names)
10535
10536 Available Commands -- Group 3
10537 F1  Show Help Text
10538 F2  See commands in next group
10539 F5  Go to next new message
10540     (or count recent messages if <A HREF="h_config_tab_checks_recent"><!--#echo var="FEAT_tab-checks-recent"--></A> is set)
10541 F8  Compose a message using roles
10542 F9  Export folder to a file
10543 F10 Import the file back to a folder
10544 </PRE>
10545 <!--chtml else-->
10546 <PRE>
10547 Navigating the Folder Screen            Operations on the Selected Folder
10548 ----------------------------            ---------------------------------
10549  P   Move to previous folder              V  View Index of selected folder
10550  N   Move to next folder                  D  Delete
10551  -   Show previous page of listing        R  Rename
10552 Spc  (space bar) Show next page           E  Export to file
10553                                           U  Import from file to folder
10554
10555 FOLDER LIST Screen Commands              General Alpine Command
10556 ---------------------------              -----------------------
10557  A  Add a folder                          O  Show all other available commands
10558  G  Specify a folder to go to             ?  Show Help text
10559  I  Show MESSAGE INDEX of current folder  M  MAIN MENU Screen
10560  W  Whereis (search folder names)         Q  Quit Alpine
10561  %  Print folder listing                  C  Compose a message
10562                                           #  Compose a message using roles
10563 </PRE>
10564 <!--chtml endif-->
10565 <P>
10566 These commands are only available in the FOLDER LIST screen when the
10567 <A HREF="h_config_enable_agg_ops">&quot;<!--#echo var="FEAT_enable-aggregate-command-set"-->&quot;
10568 feature</A> is set in the SETUP CONFIGURATION screen:<DL>
10569 <DT>Select:</DT>
10570 <DD>Select folders by certain criteria:<UL>
10571 <LI>All: of limited use, since there is no Apply command.
10572 <LI>by Property: <UL>
10573         <LI>folder contains messages not yet seen
10574         <LI>folder contains new messages
10575         <LI>folder contains exactly as many, more, or fewer messages
10576 than a given number
10577         </UL>
10578 <LI>by Text: <UL>
10579         <LI>contained in name of folder (Name Select)
10580         <LI>contained in messages in folder (Content Select)
10581         </UL>
10582 </UL></DD>
10583
10584 <DT>Select current:</DT>
10585 <DD>Select the folder the cursor is on.  (Can be used to &quot;manually&quot;
10586 add one or more folders to a set created with the Select command described
10587 above.)</DD>
10588 <DT>Zoom mode:</DT>
10589 <DD>Toggles display of only selected folders or all folders on and off.</DD>
10590 </DL>
10591 <P>
10592 If the feature
10593 <A HREF="h_config_tab_checks_recent">&quot;<!--#echo var="FEAT_tab-checks-recent"-->&quot;</A>
10594 is set then the TAB key will display the number of recent messages and
10595 the total number of messages in the highlighted folder.
10596 <P>
10597 The &quot;Export&quot; command causes the lowest common denominator style
10598 mailbox to be written to a file.
10599 If the file already exists, you are asked if you want to delete it.
10600 If you say No, then the operation is aborted.
10601 Export might be a reasonable way to store a backup or an archival copy of
10602 a folder.
10603 The exported-to file is a local file on the system where you are running Alpine.
10604 The &quot;Import&quot; command is the opposite of the Export command.
10605 It reads a file created by Export and asks where it should save it in your
10606 folders.
10607 This could be a new folder or an existing folder.
10608 If the folder already exists, the messages from the exported file will be
10609 appended to the folder.
10610 <P>
10611 <CENTER>Description of the FOLDER LIST Screen</CENTER>
10612
10613 The purpose of the FOLDER LIST screen is to help you browse and manage
10614 the folders and directories (also known as &quot;hierarchy&quot;)
10615 contained within a collection.
10616
10617 <P>
10618 Folders and directories are arranged alphabetically across lines of
10619 the screen.  Directories, if present, are denoted by a special
10620 character at the end of the name known as the hierarchy delimiter
10621 (typically, &quot;/&quot;).  By default, folders and directories are
10622 mixed together.  The
10623 "<A HREF="h_config_fld_sort_rule"><!--#echo var="VAR_folder-sort-rule"--></A>"
10624 configuration option can be used to group directories toward the
10625 beginning or end of the list.
10626
10627 <P>
10628 The Next/Prev Page commands help browse the list, the Next/Prev Fldr
10629 commands change the &quot;selected&quot; (i.e., highlighted) folder or
10630 directory, and the View Fldr/Dir commands will &quot;open&quot; the
10631 selected item.  Folder and directory management is provided via the
10632 Rename, Delete and Add commands.
10633
10634 <P><CENTER>About Folders</CENTER>
10635 What are Folders?<P>
10636
10637 Folders are simply files where messages are kept.  Every message has to be
10638 in a folder.  Most every Alpine user starts out with 3 folders: an INBOX, a
10639 folder for sent mail and a folder for saved messages.<P>
10640
10641 You may create as many other folders as you wish.  They must be given
10642 names that can be filenames on the filesystem.
10643 <P>
10644
10645 You can move messages from one folder to another by opening the original
10646 folder and saving messages into the other folder just as you can save
10647 message from your INBOX to any other folder.<P>
10648
10649 Folders are typically just files in the filesystem.  However, the files
10650 that are
10651 folders have some special formatting in them (so that Alpine knows where one
10652 message ends and another begins) and should <EM>not</EM> be edited outside of
10653 Alpine.  If you want copies of your messages in text files that you can edit
10654 or otherwise manipulate, use the Export command to copy them from Alpine into
10655 your regular file area.
10656
10657 <P>
10658 FOR MORE INFORMATION: See the section on
10659 <A HREF="h_valid_folder_names">Valid Folder Names</A>.
10660 <P>
10661 <CENTER>About Directories</CENTER>
10662 <P>
10663 A directory is simply a container used to group folders within a
10664 folder list.  You can create as many directories as you like.  And
10665 directories can even contain directories themselves.
10666
10667 <P>
10668 SPECIAL NOTES: When accessing folders on an IMAP server, it is important
10669 to note that not all IMAP servers support directories.  If you find that
10670 the Add command fails to offer the &quot;Create Directory&quot; subcommand,
10671 then it's likely that directories are not supported by the server serving
10672 in that collection.
10673
10674 <P>
10675 Similarly, servers that do provide for directories may not do so in
10676 the same way.  On some servers, for example, each folder name you
10677 create is at the same time capable of being a directory.  When this
10678 happens, Alpine will display both the folder name and the name of the
10679 directory (with trailing hierarchy delimiter) in the folder list.
10680
10681 <P>
10682 Another issue with IMAP access, though with a much smaller set of servers,
10683 is that not all servers accept the request to list out the available
10684 folders and directories in the same way.  If you find yourself having
10685 trouble viewing folders on your server, you might investigate the
10686 &quot;<A HREF="h_config_lame_list_mode"><!--#echo var="FEAT_enable-lame-list-mode"--></A>&quot;
10687 feature.
10688 <P>
10689 <UL>
10690 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
10691 </UL>
10692 <P>
10693 &lt;End of help on this topic&gt;
10694 </BODY>
10695 </HTML>
10696 ========= h_valid_folder_names ========
10697 <HTML>
10698 <HEAD>
10699 <TITLE>Explanation of Valid Folder Names</TITLE>
10700 </HEAD>
10701 <BODY>
10702 <H1>Folder Name Syntax Explained</H1>
10703
10704 Once your folder collections are defined, you can usually refer to
10705 folders by their simple (unqualified) name, or pick from a FOLDER LIST
10706 display.  However, understanding the complete syntax for folder names,
10707 both local and remote, is handy when using the Goto command and when
10708 you are adding new folder collections via the Setups/collectionList screen.
10709 <P>
10710 An Alpine folder name looks like
10711
10712 <P>
10713 <CENTER><SAMP>[{&lt;remote-specification&gt;}][#&lt;namespace&gt;]&lt;namespace-specific-part&gt;</SAMP></CENTER>
10714 <P>
10715
10716 The square brackets ([]) mean that the part is optional.
10717
10718 <P>
10719 If there is no remote-specification, then the folder name is interpreted
10720 locally on the computer running Alpine.
10721 Local folder names depend on the operating system used by the computer
10722 running Alpine, as well as the configuration of that system.  For example,
10723 &quot;C:&#92;PINE&#92;FOLDERS&#92;OCT-94&quot; might exist on a PC, and
10724 &quot;~/mail/september-1994&quot; might be a reasonable folder name on a
10725 system running Unix.
10726
10727 <P>
10728 Alpine users have the option of using folders that are stored on some other
10729 computer.  Alpine accesses remote folders via IMAP (the Internet Message
10730 Access Protocol), or in the case of news, via NNTP (the Network News
10731 Transport Protocol).  To be able to access remote folders in Alpine, the
10732 remote host must be running the appropriate server software (imapd or
10733 nntpd) and you must correctly specify the name of the folder to Alpine,
10734 including the domain name of the remote machine. For example,
10735 <P>
10736 <CENTER><SAMP>&#123;monet.art.example.com}INBOX</SAMP></CENTER>
10737 <P>
10738 could be a remote folder specification, and so could
10739 <P>
10740 <CENTER><SAMP>&#123;unixhost.art.example.com}~/mail/september-1994</SAMP></CENTER>
10741 and
10742 <P>
10743 <CENTER><SAMP>&#123;winhost.art.example.com}&#92;mymail&#92;SEP-94</SAMP></CENTER>
10744 <P>
10745 Note that in the case of remote folders, the directory/file path in the specification is
10746 determined by the operating system of the remote computer, <B>not</B> by
10747 the operating system of the computer on which you are running Alpine.
10748 <P>
10749 As you can tell, the name of the computer is in &#123;} brackets
10750 followed immediately by the name of the folder.  (In each of these cases the
10751 optional namespace is missing.)  If, as in these
10752 examples, there is no remote access protocol specified, then IMAP is
10753 assumed.  Check
10754 <A HREF="h_folder_server_syntax">here</A>
10755 for a more detailed look at what options can be placed between the brackets.
10756 If there are no brackets at all, then the folder name is interpreted locally
10757 on the computer on which you are running Alpine.
10758
10759 <P>
10760 To the right of the brackets when a server name is present, or at the
10761 start of the foldername if no server is present, the sharp sign,
10762 &quot;#&quot;, holds special meaning.  It indicates a folder name
10763 outside the area reserved for your personal folders.  In fact, it's
10764 used to indicate both the name of the folder, and a special phrase
10765 telling Alpine how to interpret the name that follows.
10766
10767 <P>
10768 So, for example, Alpine can be used to access a newsgroup that might be
10769 available on your computer using:
10770 <P>
10771 <CENTER><SAMP>#news.comp.mail.pine</SAMP></CENTER>
10772 <P>
10773 The sharp sign indicates the folder name is outside your personal
10774 folder area.  The &quot;news.&quot; phrase after it tells Alpine to
10775 interpret the remainder of the name as a newsgroup.
10776
10777 <P>
10778 Similarly, to access a newsgroup on your IMAP server, you might
10779 use something like:
10780 <P>
10781 <CENTER><SAMP>&#123;wharhol.art.example.com}#news.comp.mail.misc</SAMP></CENTER>
10782
10783 <P>
10784 There are a number of such special phrases (or &quot;namespaces&quot;)
10785 available.  For a more detailed explanation read about
10786 <A HREF="h_folder_name_namespaces">Namespaces</A>.
10787
10788 <P>
10789 Note that &quot;INBOX&quot; has special meaning in both local and remote folder
10790 names.  The name INBOX refers to your &quot;principal incoming
10791 message folder&quot; and will be mapped to the actual file name used for your
10792 INBOX on any given host.  Therefore, a name like
10793 &quot;&#123;xxx.art.example.com}INBOX&quot; refers to whatever file is used to
10794 store incoming mail for you on that particular host.
10795
10796 <P>
10797 &lt;End of help on this topic&gt;
10798 </BODY>
10799 </HTML>
10800 ======= h_folder_name_namespaces =======
10801 <HTML>
10802 <HEAD>
10803 <TITLE>FOLDER NAME NAMESPACES EXPLAINED</TITLE>
10804 </HEAD>
10805 <BODY>
10806 <H1>Folder Name Namespaces Explained</H1>
10807
10808 An Alpine folder name looks like
10809
10810 <P>
10811 <CENTER><SAMP>[{&lt;remote-specification&gt;}][#&lt;namespace&gt;][&lt;namespace-specific-part&gt;]</SAMP></CENTER>
10812 <P>
10813
10814 The local part of a folder name has an optional &quot;Namespace&quot; which
10815 tells Alpine how to interpret the rest of the name.
10816
10817 <P>
10818 By default the folder name is interpreted as defining a section of your personal
10819 folder area.  This area and how you specify it are defined by the
10820 server, if one is specified, or, typically, the home
10821 directory, if no server is defined.
10822
10823 <P>
10824 If a namespace is specified, it begins with the
10825 sharp, &quot;#&quot;, character followed by the name of the namespace
10826 and then the namespace's path-element-delimiter.  Aside from the
10827 path's format, namespaces can also imply access rights, content
10828 policy, audience, location, and, occasionally, access methods.
10829
10830 <P>
10831 Each server exports its own set (possibly of size one) of
10832 namespaces.  Hence, it's likely communication with your server's
10833 administrator will be required for specific configurations.  Some of
10834 the more common namespaces, however, include:
10835
10836 <DL>
10837 <DT>#news.</DT>
10838 <DD>This specifies a set of folders in the newsgroup namespace.  Newsgroup
10839 names are hierarchically defined with each level delimited by a period.
10840 <P>
10841 <CENTER><SAMP>#news.comp.mail.pine</SAMP></CENTER>
10842 <P>
10843 </DD>
10844 <DT>#public/</DT>
10845 <DD>This specifies a folder area that the server may export to the general
10846 public.
10847 </DD>
10848 <DT>#shared/</DT>
10849 <DD>This specifies a folder area that the server may export to groups
10850 of users.
10851 </DD>
10852 <DT>#ftp/</DT>
10853 <DD>This specifies a folder area that is the same as that it may have
10854 exported via the &quot;File Transfer Protocol&quot;.
10855 </DD>
10856 <DT>#mh/</DT>
10857 <DD>This specifies the personal folder area associated with folders
10858 and directories that were created using the MH message handling system.
10859 </DD>
10860 <DT>#move/</DT>
10861 <DD>This namespace is interpreted locally by Alpine. It has an unusual interpretation and format.
10862 <P>
10863 <CENTER><SAMP>#move&lt;DELIM&gt;&lt;MailDropFolder&gt;&lt;DELIM&gt;&lt;DestinationFolder&gt;</SAMP></CENTER>
10864 <P>
10865 The #move namespace is followed by two folder names separated by a delimiter
10866 character.
10867 The delimiter character may be any character that does not appear in
10868 the MailDropFolder name.
10869 The meaning of #move is that mail will be copied from the MailDropFolder to
10870 the DestinationFolder and then deleted (if possible) from the MailDropFolder.
10871 Periodic checks at frequency
10872 <A HREF="h_config_mailcheck"><!--#echo var="VAR_mail-check-interval"--></A>, but with a minimum
10873 time between checks set by
10874 <A HREF="h_config_maildropcheck"><!--#echo var="VAR_maildrop-check-minimum"--></A>,
10875 are made for new mail arriving in the MailDropFolder.
10876 An example that copies mail from a POP inbox to a local folder follows
10877 <P>
10878 <CENTER><SAMP>#move+{popserver.example.com/pop3/ssl}inbox+local folder</SAMP></CENTER>
10879 <P>
10880 To you it appears that mail is being delivered to the local folder when it
10881 is copied from the MailDropFolder, and you read mail from the local folder.
10882 <P>
10883 Note that if the DestinationFolder does not exist then the messages are not
10884 copied from the MailDropFolder.
10885 A #move folder may only be used as an
10886 <A HREF="h_config_enable_incoming">&quot;Incoming folder&quot;</A> or
10887 an Inbox.
10888 When you are in the FOLDER LIST of Incoming Message Folders (after turning
10889 on the
10890 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="FEAT_enable-incoming-folders"-->&quot;</A>
10891 option)
10892 the Add command has a subcommand &quot;Use Mail Drop&quot;
10893 which may be helpful for defining the folder in your Alpine configuration.
10894 The same is true when you edit the
10895 <A HREF="h_config_inbox_path"><!--#echo var="VAR_inbox-path"--></A>
10896 option in Setup/Config.
10897 Each of these configuration methods will also create the DestinationFolder
10898 if it doesn't already exist.
10899 If you are having problems, make sure the DestinationFolder exists.
10900 You may find some more useful information about Mail Drops at
10901 <A HREF="h_maildrop">What is a Mail Drop?</A>.
10902 </DD>
10903 </DL>
10904 <P>
10905
10906 In addition, the server may support access to other user's folders,
10907 provided you have suitable permissions.  Common methods use a prefix
10908 of either &quot;~<VAR>user</VAR>/&quot;, or &quot;/<VAR>user</VAR>/&quot; to
10909 indicate the root of the other user's folder area.
10910
10911 <P>
10912 No, nothing's simple.
10913
10914 <P>
10915 &lt;End of help on this topic&gt;
10916 </BODY>
10917 </HTML>
10918 ============= h_whatis_vcard ========================
10919 <HTML>
10920 <HEAD>
10921 <TITLE>VCARD EXPLAINED</TITLE>
10922 </HEAD>
10923 <BODY>
10924 <H1>What is the vCard format?</H1>
10925 A &quot;vCard&quot; is a sort of electronic business card, for exchanging
10926 information about and among people and organizations electronically.
10927 More information about vCard can be found (as of May 1998) on the WWW site
10928 of the Internet Mail Consortium at the URL:
10929 <P>
10930 <CENTER><A HREF="http://www.imc.org/pdi/">http://www.imc.org/pdi/</A></CENTER>
10931 <P>
10932 &lt;End of help on this topic&gt;
10933 </BODY>
10934 </HTML>
10935 ===== h_folder_open =====
10936 <HTML>
10937 <HEAD>
10938 <TITLE>Explanation of Folder Selection</TITLE>
10939 </HEAD>
10940 <BODY>
10941 <BR>
10942 <BR>
10943 This screen is designed to allow you to quickly and easily survey your
10944 folders and select one to open.
10945 <!--chtml if pinemode="function_key"-->
10946 <PRE>
10947 Navigating the List of Folders             General Alpine Commands
10948 ------------------------------             -----------------------
10949  P   Move to previous folder               ?   Show this help text
10950  N   Move to next folder
10951  -   Show previous screen of folders
10952 Spc  (space bar) Show next screen
10953  W   WhereIs (search folder names)
10954
10955 Folder Selection Commands
10956 -------------------------
10957  E   Exit the Folder Select menu (without selecting a folder)
10958  S   Select the currently highlighted folder
10959 </PRE>
10960 <!--chtml else-->
10961 <PRE>
10962 Navigating the List of Folders             General Alpine Commands
10963 ------------------------------             -----------------------
10964 F5   Move to previous folder               F1  Show this help text
10965 F6   Move to next folder
10966 F7   Show previous screen of folders
10967 F8   Show next screen of folders
10968 F12  WhereIs (search folder names)
10969
10970 Folder Selection Commands
10971 -------------------------
10972 F3   Exit the Folder Select menu (without selecting a folder)
10973 F4   Select the currently highlighted folder
10974 </PRE>
10975 <!--chtml endif-->
10976 <P>
10977 FOR MORE INFORMATION: See the section on
10978 <A HREF="h_valid_folder_names">Valid Folder Names</A>.
10979 <P>
10980 &lt;End of help on this topic&gt;
10981 </BODY>
10982 </HTML>
10983 ===== h_folder_subscribe =====
10984 <HTML>
10985 <HEAD>
10986 <TITLE>Newsgroup Subcribe Screen explained</TITLE>
10987 </HEAD>
10988 <BODY>
10989 <H1>FOLDER SUBSCRIBE HELP</H1>
10990
10991 This screen is designed to help you subscribe to newsgroups you are
10992 not currently subscribed to.  The screen display is a list of all
10993 available newsgroups (or possibly a partial list if you specified a
10994 partial name when entering the screen).  Groups you have already
10995 subscribed to have the letters &quot;SUB&quot; next to them.  You may
10996 select a single new group to subscribe to by moving the cursor to that
10997 group and pressing &quot;S&quot; or carriage return.  Alternatively,
10998 you may change into ListMode with the &quot;ListMode&quot; command.
10999 The display will change slightly so that each group has a checkbox in
11000 front of it.  Use the cursor and the Set/Unset command to place an
11001 &quot;X&quot; in front of each newsgroup you wish to subscribe to.
11002 <P>
11003
11004 When you are finished marking groups, the &quot;Subscribe&quot;
11005 command will subscribe you to those groups you have marked.  Note, you
11006 may not unsubscribe to groups with this command.  Instead of the
11007 &quot;A&quot; &quot;Subscribe&quot; command, use the &quot;D&quot;
11008 UnSbscrbe command.
11009 <P>
11010
11011 <!--chtml if pinemode="function_key"-->
11012 <PRE>
11013 Navigating the List of Newsgroups          General Alpine Commands
11014 ---------------------------------          -----------------------
11015 F5   Move to previous group                F1   Show this help text
11016 F6   Move to next group
11017 F7   Show previous screen of groups
11018 F8   Show next screen of groups
11019 F12  WhereIs (search group names)
11020 F9   Use ListMode
11021
11022 Group Selection Commands
11023 -------------------------
11024 F3  Exit the News Subscribe menu (without selecting any groups)
11025 F4  Subscribe to the currently highlighted newsgroup
11026 </PRE>
11027 <!--chtml else-->
11028 <PRE>
11029 Navigating the List of Newsgroups          General Alpine Commands
11030 ---------------------------------          -----------------------
11031  P   Move to previous group                ?   Show this help text
11032  N   Move to next group
11033  -   Show previous screen of groups
11034 Spc  (space bar) Show next screen
11035  W   WhereIs (search group names)
11036  L   Use ListMode
11037
11038 Group Selection Commands
11039 -------------------------
11040  E   Exit the News Subscribe menu (without selecting any groups)
11041  S   Subscribe to the currently highlighted newsgroup
11042 </PRE>
11043 <!--chtml endif-->
11044 <P>
11045 When in ListMode, there is an additional command for marking groups to
11046 subscribe to:
11047 <P>
11048 <!--chtml if pinemode="function_key"-->
11049 <PRE>
11050 ListMode Commands
11051 -------------------------
11052 F9  Set or unset the highlighted group
11053 </PRE>
11054 <!--chtml else-->
11055 <PRE>
11056 ListMode Commands
11057 -------------------------
11058 X   Set or unset the highlighted group
11059 </PRE>
11060 <!--chtml endif-->
11061 <P>
11062 &lt;End of help on this topic&gt;
11063 </BODY>
11064 </HTML>
11065 ===== h_folder_postnews =====
11066 <HTML>
11067 <HEAD>
11068 <TITLE>Newsgroup selecting for Posting explained</TITLE>
11069 </HEAD>
11070 <BODY>
11071 This screen is designed to allow you to quickly and easily survey
11072 the available newsgroups and select one to post news to.
11073 <P>
11074 <!--chtml if pinemode="function_key"-->
11075 <PRE>
11076 Navigating the List of Newsgroups          General Alpine Commands
11077 ---------------------------------          -----------------------
11078 F5   Move to previous group                F1  Show this help text
11079 F6   Move to next group
11080 F7   Show previous screen of groups
11081 F8   Show next screen of groups
11082 F12  WhereIs (search group names)
11083
11084 Group Selection Commands
11085 -------------------------
11086 F3   Exit the Selection menu (without selecting a group)
11087 F4   Select the currently highlighted newsgroup
11088 </PRE>
11089 <!--chtml else-->
11090 <PRE>
11091 Navigating the List of Newsgroups          General Alpine Commands
11092 ---------------------------------          -----------------------
11093  P   Move to previous group                ?  Show this help text
11094  N   Move to next group
11095  -   Show previous screen of groups
11096 Spc  (space bar) Show next screen of groups
11097  W   WhereIs (search group names)
11098
11099 Group Selection Commands
11100 -------------------------
11101  E   Exit the Selection menu (without selecting a group)
11102  S   Select the currently highlighted newsgroup
11103 </PRE>
11104 <!--chtml endif-->
11105 <P>
11106 &lt;End of help on this topic&gt;
11107 </BODY>
11108 </HTML>
11109 ===== h_folder_save =====
11110 <HTML>
11111 <HEAD>
11112 <TITLE>Folder Select for Save Explained</TITLE>
11113 </HEAD>
11114 <BODY>
11115 This screen is designed to allow you to quickly and easily survey your
11116 folders and select one to use for saving the current message.
11117 <P>
11118
11119 <!--chtml if pinemode="function_key"-->
11120 <PRE>
11121 Navigating the List of Folders             General Alpine Commands
11122 ------------------------------             -----------------------
11123 F5   Move to previous folder               F1  Show this help text
11124 F6   Move to next folder
11125 F7   Show previous screen of folders
11126 F8   Show next screen of folders
11127 F12  WhereIs (search folder names)
11128
11129 Folder Selection Commands
11130 -------------------------
11131 F3   Exit the Folder Select menu (without selecting a folder)
11132 F4   Select the currently highlighted folder
11133 F11  AddNew folder (just like Select, but you type in a new folder name)
11134 </PRE>
11135 <!--chtml else-->
11136 <PRE>
11137 Navigating the List of Folders             General Alpine Commands
11138 ------------------------------             -----------------------
11139  P   Move to previous folder               ?  Show this help text
11140  N   Move to next folder
11141  -   Show previous screen of folders
11142 Spc  (space bar) Show next screen of folders
11143  W   WhereIs (search folder names)
11144
11145 Folder Selection Commands
11146 -------------------------
11147  E   Exit the Folder Select menu (without selecting a folder)
11148  S   Select the currently highlighted folder
11149  A   AddNew folder (just like Select, but you type in a new folder name)
11150 </PRE>
11151 <!--chtml endif-->
11152 <P>
11153 FOR MORE INFORMATION: See the section on
11154 <A HREF="h_valid_folder_names">Valid Folder Names</A>.
11155 <P>
11156 &lt;End of help on this topic&gt;
11157 </BODY>
11158 </HTML>
11159 ===== h_folder_fcc =====
11160 <HTML>
11161 <HEAD>
11162 <TITLE>Folder Select for Fcc Explained</TITLE>
11163 </HEAD>
11164 <BODY>
11165 This screen is designed to allow you to quickly and easily survey your
11166 folders and select one to use as the file carbon copy (fcc) for the
11167 current message.
11168 <P>
11169
11170 <!--chtml if pinemode="function_key"-->
11171 <PRE>
11172 Navigating the List of Folders             General Alpine Commands
11173 ------------------------------             -----------------------
11174 F5   Move to previous folder               F1  Show this help text
11175 F6   Move to next folder
11176 F7   Show previous screen of folders
11177 F8   Show next screen of folders
11178 F12  WhereIs (search folder names)
11179
11180 Folder Selection Commands
11181 -------------------------
11182 F3   Exit the Folder Select menu (without selecting a folder)
11183 F4   Select the currently highlighted folder
11184 F11  AddNew folder (just like Select, but you type in a new folder name)
11185 </PRE>
11186 <!--chtml else-->
11187 <PRE>
11188 Navigating the List of Folders             General Alpine Commands
11189 ------------------------------             -----------------------
11190  P   Move to previous folder               ?  Show this help text
11191  N   Move to next folder
11192  -   Show previous screen of folders
11193 Spc  (space bar) Show next screen of folders
11194  W   WhereIs (search folder names)
11195
11196 Folder Selection Commands
11197 -------------------------
11198  E   Exit the Folder Select menu (without selecting a folder)
11199  S   Select the currently highlighted folder
11200  A   AddNew folder (just like Select, but you type in a new folder name)
11201 </PRE>
11202 <!--chtml endif-->
11203 <P>
11204 FOR MORE INFORMATION: See the section on
11205 <A HREF="h_valid_folder_names">Valid Folder Names</A>.
11206 <P>
11207 &lt;End of help on this topic&gt;
11208 </BODY>
11209 </HTML>
11210 ===== h_folder_pattern_roles =====
11211 <HTML>
11212 <HEAD>
11213 <TITLE>Folder Select for Current Folder Explained</TITLE>
11214 </HEAD>
11215 <BODY>
11216 This screen is designed to allow you to quickly and easily survey your
11217 folders and select one to use as the specific Current Folder
11218 in a Pattern.
11219 <P>
11220
11221 <!--chtml if pinemode="function_key"-->
11222 <PRE>
11223 Navigating the List of Folders             General Alpine Commands
11224 ------------------------------             -----------------------
11225 F5   Move to previous folder               F1  Show this help text
11226 F6   Move to next folder
11227 F7   Show previous screen of folders
11228 F8   Show next screen of folders
11229 F12  WhereIs (search folder names)
11230
11231 Folder Selection Commands
11232 -------------------------
11233 F3   Exit the Folder Select menu (without selecting a folder)
11234 F4   Select the currently highlighted folder
11235 F11  AddNew folder (just like Select, but you type in a new folder name)
11236 </PRE>
11237 <!--chtml else-->
11238 <PRE>
11239 Navigating the List of Folders             General Alpine Commands
11240 ------------------------------             -----------------------
11241  P   Move to previous folder               ?  Show this help text
11242  N   Move to next folder
11243  -   Show previous screen of folders
11244 Spc  (space bar) Show next screen of folders
11245  W   WhereIs (search folder names)
11246
11247 Folder Selection Commands
11248 -------------------------
11249  E   Exit the Folder Select menu (without selecting a folder)
11250  S   Select the currently highlighted folder
11251  A   AddNew folder (just like Select, but you type in a new folder name)
11252 </PRE>
11253 <!--chtml endif-->
11254 <P>
11255 FOR MORE INFORMATION: See the section on
11256 <A HREF="h_valid_folder_names">Valid Folder Names</A>.
11257 <P>
11258 &lt;End of help on this topic&gt;
11259 </BODY>
11260 </HTML>
11261 ===== h_folder_stayopen_folders =====
11262 <HTML>
11263 <HEAD>
11264 <TITLE>Folder Select Explained</TITLE>
11265 </HEAD>
11266 <BODY>
11267 This screen is designed to allow you to quickly and easily survey your
11268 folders and select one to use as a Stay-Open folder.
11269 <P>
11270
11271 <!--chtml if pinemode="function_key"-->
11272 <PRE>
11273 Navigating the List of Folders             General Alpine Commands
11274 ------------------------------             -----------------------
11275 F5   Move to previous folder               F1  Show this help text
11276 F6   Move to next folder
11277 F7   Show previous screen of folders
11278 F8   Show next screen of folders
11279 F12  WhereIs (search folder names)
11280
11281 Folder Selection Commands
11282 -------------------------
11283 F3   Exit the Folder Select menu (without selecting a folder)
11284 F4   Select the currently highlighted folder
11285 F11  AddNew folder (just like Select, but you type in a new folder name)
11286 </PRE>
11287 <!--chtml else-->
11288 <PRE>
11289 Navigating the List of Folders             General Alpine Commands
11290 ------------------------------             -----------------------
11291  P   Move to previous folder               ?  Show this help text
11292  N   Move to next folder
11293  -   Show previous screen of folders
11294 Spc  (space bar) Show next screen of folders
11295  W   WhereIs (search folder names)
11296
11297 Folder Selection Commands
11298 -------------------------
11299  E   Exit the Folder Select menu (without selecting a folder)
11300  S   Select the currently highlighted folder
11301  A   AddNew folder (just like Select, but you type in a new folder name)
11302 </PRE>
11303 <!--chtml endif-->
11304 <P>
11305 FOR MORE INFORMATION: See the section on
11306 <A HREF="h_valid_folder_names">Valid Folder Names</A>.
11307 <P>
11308 &lt;End of help on this topic&gt;
11309 </BODY>
11310 </HTML>
11311 ===== h_folder_action_roles =====
11312 <HTML>
11313 <HEAD>
11314 <TITLE>Folder Select Explained</TITLE>
11315 </HEAD>
11316 <BODY>
11317 This screen is designed to allow you to quickly and easily survey your
11318 folders and select one to use as the folder into which messages
11319 matching this filter will be moved.
11320 <P>
11321
11322 <!--chtml if pinemode="function_key"-->
11323 <PRE>
11324 Navigating the List of Folders             General Alpine Commands
11325 ------------------------------             -----------------------
11326 F5   Move to previous folder               F1  Show this help text
11327 F6   Move to next folder
11328 F7   Show previous screen of folders
11329 F8   Show next screen of folders
11330 F12  WhereIs (search folder names)
11331
11332 Folder Selection Commands
11333 -------------------------
11334 F3   Exit the Folder Select menu (without selecting a folder)
11335 F4   Select the currently highlighted folder
11336 F11  AddNew folder (just like Select, but you type in a new folder name)
11337 </PRE>
11338 <!--chtml else-->
11339 <PRE>
11340 Navigating the List of Folders             General Alpine Commands
11341 ------------------------------             -----------------------
11342  P   Move to previous folder               ?  Show this help text
11343  N   Move to next folder
11344  -   Show previous screen of folders
11345 Spc  (space bar) Show next screen of folders
11346  W   WhereIs (search folder names)
11347
11348 Folder Selection Commands
11349 -------------------------
11350  E   Exit the Folder Select menu (without selecting a folder)
11351  S   Select the currently highlighted folder
11352  A   AddNew folder (just like Select, but you type in a new folder name)
11353 </PRE>
11354 <!--chtml endif-->
11355 <P>
11356 FOR MORE INFORMATION: See the section on
11357 <A HREF="h_valid_folder_names">Valid Folder Names</A>.
11358 <P>
11359 &lt;End of help on this topic&gt;
11360 </BODY>
11361 </HTML>
11362 ===== h_abook_config =====
11363 <HTML>
11364 <HEAD>
11365 <TITLE>SETUP ADDRESS BOOKS SCREEN</TITLE>
11366 </HEAD>
11367 <BODY>
11368 <H1>SETUP ADDRESS BOOKS SCREEN</H1>
11369 <H2>SETUP ADDRESS BOOKS COMMANDS</H2>
11370 <!--chtml if pinemode="function_key"-->
11371 <PRE>
11372 Available  Commands
11373 -------------------------------
11374 F1  Show Help Text
11375 F3  Back to MAIN Alpine menu
11376 F4  Change configuration for address book
11377 F5  Move to previous address book
11378 F6  Move to next address book
11379 F7  Previous page of address books
11380 F8  Next page of address books
11381 F9  Add new address book
11382 F10 Delete existing address book
11383 F11 Shuffle the order of address books
11384 F12 Whereis (search address book titles)
11385 </PRE>
11386 <!--chtml else-->
11387 <PRE>
11388 Navigation                     General Alpine Commands
11389 -----------------------        -----------------------
11390  P  Prev Address Book           ?  Display this help text
11391  N  Next Address Book           E  Back to MAIN Alpine menu
11392  -  Previous page
11393 Spc (space bar) Next page
11394  W  WhereIs (search for word in address book titles)
11395
11396 Setup Address Books Commands
11397 ------------------------------------------------
11398  A  Add new address book          $  Shuffle the order of address books
11399  D  Delete existing address book  C  Change configuration for address book
11400 </PRE>
11401 <!--chtml endif-->
11402
11403 <H2>Description of the Setup Address Books Screen</H2>
11404
11405 This screen lets you add, delete, modify, or change the order of your
11406 address books.  The &quot;Add Abook&quot; command brings up a blank form to
11407 fill in.  If you are adding a remote address book on an IMAP server
11408 you should fill in the name of the IMAP server.  Otherwise, leave
11409 that field blank.  (Note that remote IMAP address books are an Alpine
11410 concept and are unlikely to interoperate with other mail clients.)
11411 For a remote address book, fill in the name of the remote folder
11412 in the Folder field.  This should be a folder that is used only for
11413 this one purpose, not a general purpose folder you expect to store
11414 messages in.
11415 <P>If you are adding a local address book, fill in the
11416 Folder Name field with a local file name (e.g., .addressbook).
11417 <P>
11418 <B>Please note:</B> Remote address books stored on an IMAP server are
11419 of an entirely different format (namely, a special-purpose
11420 &quot;mail folder&quot;) than that of the local addressbook familiar
11421 to Alpine users.  Therefore,
11422 you cannot use &quot;add a remote address book&quot; to make an existing
11423 Alpine .addressbook file you may have on a remote IMAP server accessible to
11424 Alpine running on a different host.
11425 <P>
11426
11427 The &quot;Del Abook&quot; command allows you to remove an address book
11428 from your configuration.  It will also ask you if you wish to remove
11429 the data for that address book, which would erase all traces of the
11430 address book if you answer Yes.
11431 <P>
11432
11433 The &quot;Change&quot; command is similar to the &quot;Add Abook&quot; command.
11434 The difference is that instead of adding a new address book to your
11435 configuration, you are changing the configuration of an existing entry.
11436 For example, you might want to correct a typing error or change a
11437 nickname.  The &quot;Change&quot; command is not a move command.  If you
11438 change the folder name or server name the data will not be moved for you.
11439 <P>
11440
11441 The &quot;Shuffle&quot; command is used for two purposes.  If you shuffle
11442 an address book toward another address book in the same group then
11443 the order of those two address books will be swapped.  If you shuffle
11444 the last Personal address book down towards the Global address book
11445 section, it will become a Global address book.  If you shuffle
11446 the first Global address book up it will become a Personal address
11447 book.  The main difference between Personal and Global address
11448 books is that Global address books are forced read-only.
11449 <P><UL>
11450 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
11451 </UL>
11452 <P>
11453 &lt;End of help on this topic&gt;
11454 </BODY>
11455 </HTML>
11456 ===== h_abook_top =====
11457 <HTML>
11458 <HEAD>
11459 <TITLE>ADDRESS BOOK LIST COMMANDS</TITLE>
11460 </HEAD>
11461 <BODY>
11462 <H1>ADDRESS BOOK LIST COMMANDS</H1>
11463 <!--chtml if pinemode="function_key"-->
11464 <PRE>
11465 Available  Commands -- Group 1         Available Commands -- Group 2
11466 -------------------------------        ------------------------------
11467 F1  Show Help Text                      F1  Show Help Text
11468 F2  See commands in next group          F2  See commands in next group
11469 F3  Exit to MAIN MENU                   F3  Quit Alpine
11470 F4  View/Edit selected address book
11471 F5  Move to previous address book       F5  FOLDER LIST screen
11472 F6  Move to next address book           F6  Specify a folder to go to
11473 F7  Previous page                       F7  MESSAGE INDEX screen
11474 F8  Next page                           F9  Print list of address books
11475 F12 Whereis (search for word)
11476 </PRE>
11477 <!--chtml else-->
11478 <PRE>
11479 Navigation                       General Alpine Commands
11480 -----------------------          -----------------------
11481  P  Previous Entry                ?  Display this help text
11482  N  Next Entry                    O  Show all other available commands
11483  -  Previous page                 &lt;  Back to MAIN Alpine menu
11484 Spc (space bar) Next page         Q  Quit Alpine
11485  W  WhereIs (search for word)     L  FOLDER LIST screen
11486                                   G  Specify a folder to go to
11487 Address Book Commands             I  MESSAGE INDEX screen
11488 ------------------------------------------------
11489  &gt;  View/Edit selected address book
11490               or
11491  &gt;  Search on selected directory server
11492
11493  %  Print list of address books and directory servers
11494 </PRE>
11495 <!--chtml endif-->
11496
11497 <H2>Description of the Address Book List Screen</H2>
11498
11499 From this screen you may choose which address book you wish to view
11500 or edit. For more information on address books, view one of your
11501 address books (with
11502 <!--chtml if pinemode="function_key"-->
11503 F4
11504 <!--chtml else-->
11505 &quot;&gt;&quot;
11506 <!--chtml endif-->)
11507 and see the Help Text there.<P>
11508
11509 You may also choose a directory server on which to search for entries.
11510 You do that by highlighting the directory server line and using
11511 <!--chtml if pinemode="function_key"-->
11512 F4
11513 <!--chtml else-->
11514 &quot;&gt;&quot;
11515 <!--chtml endif-->.<P>
11516
11517 If you wish to define new address books or directory servers go to the Main
11518 menu and choose Setup. You may then either choose to setup AddressBooks or
11519 Directory (among other things). It's possible that the Directory option
11520 will not be there if the Alpine you are using does not contain LDAP directory
11521 lookup functionality.
11522
11523 <P><UL>
11524 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
11525 </UL><P>
11526 &lt;End of help on this topic&gt;
11527 </BODY>
11528 </HTML>
11529 ===== h_abook_opened =====
11530 <HTML>
11531 <HEAD>
11532 <TITLE>THE ALPINE ADDRESS BOOK</TITLE>
11533 </HEAD>
11534 <BODY>
11535 <H1>THE ALPINE ADDRESS BOOK</H1>
11536 <H2>ADDRESS BOOK COMMANDS</H2>
11537 <PRE>
11538 <!--chtml if pinemode="function_key"-->
11539 Available  Commands -- Group 1         Available Commands -- Group 2
11540 -------------------------------        ------------------------------
11541 F1  Show Help Text                      F1  Show Help Text
11542 F2  See commands in next group          F2  See commands in next group
11543 F3  Exit this screen                    F3  Quit Alpine
11544 F4  View/Edit selected entry            F4  Go to MAIN MENU screen
11545 F5  Move to previous entry              F5  FOLDER LIST screen
11546 F6  Move to next entry                  F6  Specify a folder to go to
11547 F7  Previous page of address book       F7  MESSAGE INDEX screen
11548 F8  Next page of address book           F8  Compose to entry using roles
11549 F9  Add new entry to address book       F9  Print address book
11550 F10 Delete selected entry               F10 TakeAddr to another addrbook
11551 F11 Compose to selected entry           F11 Save or Export addrbook selections
11552 F12 Whereis (search address book)       F12 Forward entry by mail
11553
11554 Available Commands -- Group 3
11555 ------------------------------
11556 F3  Select                              F6  Zoom (or unZoom)
11557 F5  Select Current                      F7  Apply Command to Selection
11558 <!--chtml else-->
11559 Address Book Navigation        General Alpine Commands
11560 -----------------------        -----------------------
11561  P  Prev Address                  ?  Display this help text
11562  N  Next Address                  O  Show all other available commands
11563  -  Previous page of address book M  Back to MAIN MENU
11564 Spc (space bar) Next page         Q  Quit Alpine
11565  W  WhereIs (search for word      C  Compose message to selected addr
11566      or name in address book)     #  Compose to addr using roles
11567  &lt;  To List of Address Books if   L  FOLDER LIST screen
11568      more than one, else to MAIN  G  Specify a folder to go to
11569                                   I  MESSAGE INDEX screen
11570
11571 Address Book Commands
11572 ----------------------------------------------------
11573  &gt;  View/Update selected entry    D  Delete selected entries
11574  %  Print address book            S  Save or Export address book selections
11575  F  Forward entries by mail       @  Add new entry to address book
11576
11577  ;  Select command                Z  Toggle Zoom Mode
11578  :  Select highlighted entry      A  Apply command to selected entries
11579
11580 <!--chtml endif-->
11581 </PRE>
11582 Note:  The presence or absence of the final four commands above is
11583 controlled by the option
11584 <A HREF="h_config_enable_agg_ops">&quot;<!--#echo var="FEAT_enable-aggregate-command-set"-->&quot;</A>.
11585 <P>
11586
11587 <H2>Description of the Address Book Screen</H2>
11588
11589 This screen lets you edit and manage entries in your address book.  It
11590 also acts as a short-cut for composing messages to people in the address
11591 book.  When, from this screen, you press <!--chtml if pinemode="function_key"-->F11<!--chtml else-->&quot;C&quot;<!--chtml endif--> for ComposeTo, the
11592 message starts &quot;pre-addressed&quot; to whatever address book entry is
11593 currently selected.  If you use the <!--chtml if pinemode="function_key"-->F8<!--chtml else-->&quot;#&quot;<!--chtml endif--> for Role, you may first select a
11594 role to use in your composition.
11595 <P>
11596 Alpine's address book helps you keep a list of addresses you send email to so
11597 you do not have to remember addresses that are often complex.  Each entry
11598 in the address book has five fields, all of them optional.  The three
11599 elements that are usually visible on the ADDRESS BOOK display, are: <DL>
11600
11601         <P><DT>NICKNAME: <DD>A short easy-to-remember label to identify the entry.
11602         This is what you type in as you are addressing the message in the
11603         composer.  If there is a matching entry in your address book(s),
11604         Alpine will extract the corresponding FullName and Address fields to
11605         generate the actual address for your message.
11606
11607         <P><DT>FULLNAME: <DD>A longer field where you can put the full name
11608 of the
11609         person or organization.  Usually the full names are put in last
11610         name first so they sort nicely in alphabetical order.  Whatever
11611         you put as the name here will appear on the message when it is
11612         finally delivered.  Examples:<PRE>
11613            Garcia Marquez, Gabriel
11614            Henscheid, Eckhard
11615            Alpine-Info mailing list
11616            Library materials renewal requests
11617            Kim An-guk
11618            &quot;George III, King of Great Britain, 1738-1820&quot;
11619 </PRE>
11620 (In the second-to-last example, no comma is used in the name so that
11621 the family name appears first in the address book and when the entry is
11622 used in the composer.
11623 In the last example, retaining the commas is intended;
11624 double-quotation marks surround the name to
11625 prevent the transposition of its parts when the entry is used in
11626 the composer.)
11627
11628         <P><DT>ADDRESS: <DD>This is the actual email address itself.  This must be
11629         a valid Internet address that conforms to the Internet message
11630         header standard, RFC-822.  (See also <A HREF="h_address_format">Explanation of Address formats</A>.)</DL>
11631
11632 The two fields that aren't usually visible are:<DL>
11633
11634   <P><DT>FCC: <DD>The name of the folder you would like a copy of any outgoing
11635         message to this address to be saved in.  If this field is set, and
11636         this address is the first one in the message's To: header, then
11637         Alpine will use this folder name for the FCC in lieu of the normal
11638         FCC folder name.
11639
11640   <P><DT>COMMENTS: <DD>This field contains arbitrary text for your convenience.
11641         </DL>
11642 <P>
11643 Due to screen width limitations, these last two fields do not show up in
11644 the normal ADDRESS BOOK display.  You may select the
11645 &quot;View/Update&quot; command to
11646 view or modify them.  You may use the configuration variable
11647 <A HREF="h_config_abook_formats">&quot;<!--#echo var="VAR_addressbook-formats"-->&quot;</A>
11648 to add these fields to your ADDRESS BOOK
11649 display, or to modify the format of the display.
11650
11651 <H2>Sorting the Address book</H2>
11652
11653 By default, address book entries are sorted alphabetically on the full
11654 name with distribution lists sorted to the end.  Sorting can be changed by
11655 resetting the address book sort rule in the Alpine SETUP CONFIGURATION screen
11656 --assuming you have &quot;write&quot; permission for the address book file.
11657 <P>
11658 Unlike the sorting of folders (which only changes presentation), sorting an
11659 address book actually changes the file as it is kept on the computer.  For
11660 this reason you won't be able to sort a shared or system-wide address
11661 book.
11662
11663 <H2>Adding New Entries</H2>
11664
11665 The easiest way to add new entries to your address book is to use the
11666 &quot;TakeAddr&quot; command when viewing a message.
11667 This command allows you to take addresses from the header and body of the
11668 message and put them into your address book, without having to type
11669 them in.
11670 <P>
11671
11672 To manually add a new entry from within the address book screen, use the AddNew
11673 (<!--chtml if pinemode="function_key"-->F9<!--chtml else-->&quot;@&quot;<!--chtml endif-->) command.
11674 Use this command both for adding a simple alias and for adding a
11675 distribution list.
11676
11677 <H2>Distribution Lists</H2>
11678
11679 Address book entries can be simple cases of aliases (a single nickname is linked
11680 to a single email address) or distribution lists (a single nickname
11681 pointing at more than one email address).  Each distribution list has a
11682 nickname, a full name and a list of addresses.  The addresses may be
11683 actual addresses or they may be other nicknames in your address book.
11684 They may even refer to other distribution lists.
11685 There's really no difference between a simple alias and a distribution list,
11686 other than the number of addresses.
11687 Therefore, you can turn a simple alias with one address into a distribution
11688 list simply by adding more addresses.
11689 To add entries to an existing list or alias
11690 use the View/Update (<!--chtml if pinemode="function_key"-->F4<!--chtml else-->&quot;&gt;&quot;<!--chtml endif-->) command.  Delete (<!--chtml if pinemode="function_key"-->F10<!--chtml else-->&quot;D&quot;<!--chtml endif-->) will delete
11691 a single address from the list if the cursor is placed on the address;
11692 it will delete the entire distribution list if the cursor is on the
11693 nickname/fullname line.  View/Update may also be used to delete addresses
11694 from a list.
11695 <P>
11696 Address field entries in distribution lists may take any one of three
11697 forms: a nickname existing in any of the defined address books, a normal
11698 address of the form &quot;jsmith@art.example.com&quot;, or a complete
11699 fullname/address combination, e.g. &quot;John Smith
11700 &lt;jsmith@art.example.com&gt;&quot;.
11701 <P>
11702 Distribution lists in Alpine address books can only be used by the person or
11703 people who have access to that address book.  They are not usually used to
11704 implement discussion groups, but can be used to facilitate small
11705 discussion groups if all the participants have access to the same shared
11706 address book.
11707
11708 <H2>FCC and Comments</H2>
11709
11710 As mentioned above, each entry in the address book also has two other optional
11711 fields, Fcc and Comments.  The command to look at or change either of these
11712 is the same View/Update command used for all of the fields (<!--chtml if pinemode="function_key"-->F4<!--chtml else-->&quot;&gt;&quot;<!--chtml endif-->).  The
11713 Comments field is just for your own use.  The Fcc field overrides the
11714 default Fcc if this address is the first one on the To line.  The WhereIs
11715 command may be used to search for particular strings in the address book,
11716 including fields that are not visible (like Comment and Fcc by default).
11717
11718 <H2>Aggregate Operations</H2>
11719
11720 If the feature
11721 <A HREF="h_config_enable_agg_ops">&quot;<!--#echo var="FEAT_enable-aggregate-command-set"-->&quot;</A>
11722 is turned on (the default), then the four commands &quot;Select&quot;,
11723 &quot;Select Current&quot;, &quot;Zoom&quot;, and &quot;Apply&quot;
11724 are available.  The two selection commands allow you to mark a set of
11725 address book entries as being selected.  If you have more than one address
11726 book, the selections may be in more than one of those address books.
11727 The &quot;Zoom&quot; command will toggle between displaying only the selected
11728 entries and all of the entries.  The &quot;Apply&quot; command allows you to
11729 apply one of the regular address book commands to all of the selected
11730 entries.  Usually the address book commands apply to only the entry
11731 highlighted by the cursor.  The &quot;Apply&quot; command works with the
11732 commands &quot;ComposeTo&quot;, &quot;Delete&quot;, &quot;Print&quot;,
11733 &quot;Save&quot;, &quot;Forward&quot;, and &quot;Role&quot;.
11734
11735 <H2>Exporting and Forwarding Address book entries</H2>
11736
11737 Under the save option, when you use the Export (<!--chtml if pinemode="function_key"-->F11<!--chtml else-->&quot;X&quot;<!--chtml endif-->) command, the currently highlighted
11738 address book entry is placed in a plain text file in your home directory
11739 <!--chtml if pinemode="running"-->
11740 (which, in the present configuration of your system, is
11741  &quot;<!--#echo var="HOME_DIR"-->&quot;)
11742 <!--chtml endif-->
11743 or current working directory
11744 <!--chtml if pinemode="running"-->
11745 (which, at least for your current Alpine &quot;session,&quot;
11746 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
11747 <!--chtml endif-->, depending on the
11748 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
11749 configuration setting.  If you have some entries selected and use the
11750 Apply (<!--chtml if pinemode="function_key"-->F7<!--chtml else-->&quot;A&quot;<!--chtml endif-->) Export command, all of the selected addresses will be
11751 placed in the text file.
11752 <P>
11753 When you use the Forward (<!--chtml if pinemode="function_key"-->F12<!--chtml else-->&quot;F&quot;<!--chtml endif-->) command, the currently highlighted
11754 address book entry is placed in a special attachment and you are put into
11755 the composer.  You can fill in some comments in the body of the message,
11756 if you'd like, and send it to somebody else who uses Alpine.  The recipient
11757 may use the TakeAddr command on that message to insert the address book
11758 entry you sent in their own address book.  If you have some entries
11759 selected and use the Apply Forward command all of the selected entries
11760 will be forwarded in a single message.  You may
11761 use Apply (<!--chtml if pinemode="function_key"-->F7<!--chtml else-->&quot;A&quot;<!--chtml endif-->) Forward to forward a copy of an entire address book.
11762 The recipient must be using Alpine in order to receive this correctly.
11763 One way for the recipient to handle this might be to create an empty
11764 address book and then &quot;Take&quot; your forwarded address book entries into
11765 that empty address book.
11766
11767 <H2>Multiple and/or Site-Wide Address books</H2>
11768
11769 You may have more than one personal address book.  In addition, there may
11770 be one or more global address books.  This capability allows you to have
11771 multiple personal address books (some of which may be shared) and it also
11772 allows system administrators to implement site-wide address books that
11773 contain entries for users on multiple machines within the organization.
11774 <P><DL>
11775 <DT>Searching
11776   <DD> If you enter a nickname when composing a message, your
11777   personal address books will be searched through in order, and then the
11778   global address book(s) searched. If more than one address book has an entry
11779   for the nickname, Alpine uses the first one that it finds, so an entry in
11780   your personal address book would override a global address book entry. If
11781   after searching all the address books there is still no match, (Unix) Alpine
11782   then searches the local host password file on the assumption that you have
11783   entered a local user name rather than an address book nickname.
11784   You may change the search order of your address books with the <!--chtml if pinemode="function_key"-->F3<!--chtml else-->$<!--chtml endif--> Shuffle
11785   command, but global address books are always searched after personal
11786   address books.
11787
11788   <P><DT>Tab completion
11789   <DD> If the
11790   <A HREF="h_config_enable_tab_complete"><!--#echo var="FEAT_enable-tab-completion"--></A>
11791   feature is turned on (the default) then the Tab key may be used
11792   in the composer to complete partially typed nicknames in the To
11793   or Cc lines. You type the first few letters of a nickname and then
11794   press the Tab key. It there is only one nickname that matches it will
11795   be filled in by Alpine. If there is more than one the unambiguous part
11796   of the nicknames will be filled in. For example, if your address book or
11797   books contains only the two entries &quot;barley&quot; and &quot;barbecue&quot;
11798   beginning with the letters &quot;ba&quot;, then if you type &quot;ba&quot;
11799   followed by a Tab character Alpine will fill in &quot;bar&quot; and stop.
11800   If you then type a second Tab character you will be presented with a list
11801   of matching nicknames to select from. Alternatively, you could type another
11802   &quot;b&quot; resulting in &quot;barb&quot; and then a Tab would fill
11803   in the entire &quot;barbecue&quot; entry.
11804
11805   <P><DT>Defining
11806   <DD> You define multiple personal address books in the
11807   <A HREF="h_abook_config">SETUP AddressBooks</A> screen, which you may reach
11808   from the MAIN MENU.
11809   You may add as many as you like.  Global address books are usually
11810   site-wide address books defined by the System administrator, but
11811   you may define global address books of your own just like you define
11812   personal address books.
11813
11814   <P><DT>Creating and updating
11815   <DD> Personal address books are normally created empty
11816   and populated by explicit additions from within Alpine, e.g. via the
11817   TakeAddr command.  Unlike personal address books, global address books may
11818   not be modified/updated from within Alpine; that is, they are Read-Only.
11819   Thus, global address books are created, populated and updated outside of
11820   Alpine. They might be hand-edited, generated by a program from another
11821   database, or by copying an existing address book.  They might also be
11822   some other user's personal address book, and so be modified normally by
11823   that user but accessed Read-Only by you.  See the Alpine Technical
11824   Notes document (included in the Alpine distribution) for more information on
11825   this.
11826
11827   <P><DT>Accessing
11828   <DD>There are two different types of address books in Alpine.
11829   A local address book is stored in a regular file and the normal file
11830   access permissions apply.  A remote address book is stored on an IMAP
11831   server in a special folder that contains only messages pertaining to
11832   that address book.  The last message in the remote folder contains a
11833   copy of the address book data, and that data is copied to a local cache
11834   file in your home directory.  From there it is accessed just like a local
11835   address book.  The name of the cache file is kept track of in a special
11836   file called the
11837   <A HREF="h_config_abook_metafile"><!--#echo var="VAR_remote-abook-metafile"--></A>,
11838   the name of which is stored in
11839   your Alpine configuration file the first time you use a remote address book.
11840   Just as local Alpine address books use a format that only Alpine understands,
11841   remote Alpine address books do the same and other mail reading programs
11842   are unlikely to be able to understand them.<P>
11843   While global address books are explicitly intended to be shared, there is
11844   nothing to prevent you from sharing a personal address book with other
11845   Alpine users. This might be useful in the case of a small workgroup.
11846   However, it is recommended that updates to shared personal address books
11847   be done when other Alpine users are not accessing the address book. Alpine
11848   does not do any file-locking to manage concurrent updates to the
11849   addressbook, but it does check to see if the file has been modified before
11850   making any changes.  Consequently, inadvertent concurrent updates will
11851   only cause other Alpine users to have to restart their address book
11852   operation, which will cause Alpine to reopen the updated file.
11853
11854   <P><DT>Converting to Remote
11855   <DD>The easiest way to convert an existing local
11856   address book into a remote address book is to create an empty new remote
11857   personal address book by typing &quot;A&quot; to execute the
11858   &quot;Add Pers Abook&quot; command in the SETUP Addressbook screen.
11859   Make sure you add a <EM>personal</EM> address book, not a <EM>global</EM>
11860   address book.
11861   After you have added the empty
11862   remote address book, go into the screen for the address book you wish
11863   to copy and &quot;Select&quot; &quot;All&quot;.
11864   This selects every entry in that
11865   address book.  Then type the command &quot;Apply Save&quot;.
11866   You will be asked for the address book to save to.  You may use ^P and ^N
11867   to get to the new empty address book, then hit RETURN and the addresses
11868   will be copied.
11869   At this point you'll probably want to unselect all the entries in the local
11870   address book before proceeding. You do that with
11871   &quot;Select&quot; &quot;unselect All&quot;.
11872
11873 </DL>
11874 <UL>
11875 <LI><A HREF="h_address_format">Explanation of Address formats</A>
11876 </UL>
11877 <P><UL>
11878 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
11879 </UL>
11880 <P>
11881 &lt;End of help on this topic&gt;
11882 </BODY>
11883 </HTML>
11884 ===== h_abook_select_addr =====
11885 <HTML>
11886 <HEAD>
11887 <TITLE>Addressbook Selection Explained</TITLE>
11888 </HEAD>
11889 <BODY>
11890 <H1>SELECT ADDRESS</H1>
11891 <!--chtml if pinemode="function_key"-->
11892 <PRE>
11893 Navigating the List of Messages               General Alpine Commands
11894 -------------------------------               -----------------------
11895 F5   Move to previous entry                   F1  Show this help text
11896 F6   Move to next entry
11897 F7   Show previous screen of address book
11898 F8   Show next screen of address book
11899 F12  WhereIs (search through address book)
11900
11901 Address Selection Commands
11902 --------------------------
11903 F3   Exit the Address Select screen (without selecting an address)
11904 F4   Select the currently highlighted entry
11905 </PRE>
11906 <!--chtml else-->
11907 <PRE>
11908 Navigating the List of Messages               General Alpine Commands
11909 -------------------------------               -----------------------
11910  P   Move to previous entry                    ?  Show this help text
11911  N   Move to next entry
11912  -   Show previous screen of address book
11913 Spc  (space bar) Show next screen of address book
11914  W   WhereIs (search through address book)
11915
11916 Address Selection Commands
11917 --------------------------
11918  E   Exit the Address Select screen (without selecting an address)
11919  S   Select the currently highlighted entry
11920 </PRE>
11921 <!--chtml endif-->
11922 <P>
11923
11924 This screen is designed to let you easily scan your address book(s) in
11925 order to select an entry for the message you are composing.  You cannot
11926 edit your address book in any way at this time, for address book
11927 maintenance, select the address book command when not composing a message.
11928 <P>
11929
11930 If you are composing a message and know the nickname of the person/list you
11931 want, you can bypass this screen by simply typing in the nickname on the
11932 appropriate header line (To:, Cc:, etc.)  Exiting this screen without
11933 selecting an entry does not cancel your message.
11934 <P>
11935
11936 FOR MORE INFORMATION on addressing see
11937 <A HREF="h_address_format">Explanation of Address formats</A>, and the
11938 <A HREF="h_abook_opened">Address Book Screen's</A>
11939 help text.
11940 <P>
11941 &lt;End of help on this topic&gt;
11942 </BODY>
11943 </HTML>
11944 ===== h_abook_select_top =====
11945 <HTML>
11946 <HEAD>
11947 <TITLE>Addressbook Selection Navigation Explained</TITLE>
11948 </HEAD>
11949 <BODY>
11950 <H1>NAVIGATING WHILE SELECTING ADDRESSES</H1>
11951 <!--chtml if pinemode="function_key"-->
11952 <PRE>
11953 Navigating the List of Address Books       General Alpine Commands
11954 ------------------------------------       -----------------------
11955 F4   View the highlighted address book
11956 F5   Move to previous address book         F1  Show this help text
11957 F6   Move to next address book
11958 F7   Show previous screen of address books
11959 F8   Show next screen of address books
11960 F12  WhereIs (search through address books)
11961
11962 Address Selection Commands
11963 --------------------------
11964 F3   Exit the Address Select screen (without selecting an address)
11965 F4   Select the currently selected entries (if using ListMode)
11966 F9   Change to ListMode
11967 </PRE>
11968 <!--chtml else-->
11969 <PRE>
11970 Navigating the List of Address Books       General Alpine Commands
11971 ------------------------------------       -----------------------
11972  &gt;   View the highlighted address book
11973  P   Move to previous address book         ?  Show this help text
11974  N   Move to next address book
11975  -   Show previous screen of address books
11976 Spc  (space bar) Show next screen of address books
11977  W   WhereIs (search through address books)
11978
11979 Address Selection Commands
11980 --------------------------
11981  E   Exit the Address Select screen (without selecting an address)
11982  S   Select the currently selected entries (if using ListMode)
11983  L   Change to ListMode
11984 </PRE>
11985 <!--chtml endif-->
11986 <P>
11987
11988 This screen is designed to let you easily scan your address book(s) in
11989 order to select entries for the message you are composing.  You cannot
11990 edit your address book in any way at this time.  For address book
11991 maintenance, select the address book command when not composing a message.
11992 <P>
11993
11994 If you are composing a message and know the nickname of the person/list you
11995 want, you can bypass this screen by simply typing in the nickname on the
11996 appropriate header line (To:, Cc:, etc.)  Exiting this screen without
11997 selecting an entry does not cancel your message.
11998 <P>
11999
12000 The ListMode command will add a column at the left edge of the screen.
12001 You mark the entries that you wish to select with the &quot;X&quot; command.
12002 This allows you to choose more than one entry at a time.
12003 <P>
12004
12005 An alternative method of composing a message to entries in your
12006 address book(s) is to first use the &quot;Select&quot; command from
12007 the address book maintenance screen and then the &quot;Apply&quot;
12008 &quot;ComposeTo&quot; command to start the composer composing to the
12009 selected entries.
12010 <P>
12011
12012 FOR MORE INFORMATION on addressing see
12013 <A HREF="h_address_format">Explanation of Address formats</A>, and the
12014 <A HREF="h_abook_opened">Address Book Screen's</A>
12015 help text.
12016 <P>
12017 &lt;End of help on this topic&gt;
12018 </BODY>
12019 </HTML>
12020 ===== h_abook_select_listmode =====
12021 <HTML>
12022 <HEAD>
12023 <TITLE>Address Listmode Selection from Composer Explained</TITLE>
12024 </HEAD>
12025 <BODY>
12026 <H1>COMPOSER: SELECT ADDRESSES</H1>
12027 <!--chtml if pinemode="function_key"-->
12028 <PRE>
12029 Navigating the List of Messages                 General Alpine Commands
12030 -------------------------------                 -----------------------
12031 F5   Move to previous entry                     F1  Show this help text
12032 F6   Move to next entry
12033 F7   Show previous screen of address book
12034 F8   Show next screen of address book
12035 F12  WhereIs (search through address book)
12036
12037 Address Selection Commands
12038 --------------------------
12039 F3   Exit the Address Select screen (without selecting an address)
12040 F4   Select the currently highlighted entry
12041 F9   Change to ListMode
12042 </PRE>
12043 <!--chtml else-->
12044 <PRE>
12045 Navigating the List of Messages                 General Alpine Commands
12046 -------------------------------                 -----------------------
12047  P   Move to previous entry                     ?  Show this help text
12048  N   Move to next entry
12049  -   Show previous screen of address book
12050 Spc  (space bar) Show next screen of address book
12051  W   WhereIs (search through address book)
12052
12053 Address Selection Commands
12054 --------------------------
12055  E   Exit the Address Select screen (without selecting an address)
12056  S   Select the currently highlighted entry
12057  L   Change to ListMode
12058 </PRE>
12059 <!--chtml endif-->
12060 <P>
12061
12062 This screen is designed to let you easily scan your address book(s) in
12063 order to select entries for the message you are composing.  You cannot
12064 edit your address book in any way at this time, for address book
12065 maintenance, select the address book command when not composing a message.
12066 <P>
12067
12068 If you are composing a message and know the nickname of the person/list you
12069 want, you can bypass this screen by simply typing in the nickname on the
12070 appropriate header line (To:, Cc:, etc.)  Exiting this screen without
12071 selecting an entry does not cancel your message.
12072 <P>
12073
12074 The ListMode command will add a column at the left edge of the screen.
12075 You mark the entries that you wish to select with the &quot;X&quot; command.
12076 This allows you to choose more than one entry at a time.
12077 <P>
12078
12079 An alternative method of composing a message to entries in your
12080 address book(s) is to first use the &quot;Select&quot; command from
12081 the address book maintenance screen and then the &quot;Apply&quot;
12082 &quot;ComposeTo&quot; command to start the composer composing to the
12083 selected entries.
12084 <P>
12085
12086 FOR MORE INFORMATION on addressing see
12087 <A HREF="h_address_format">Explanation of Address formats</A>, and the
12088 <A HREF="h_abook_opened">Address Book Screen's</A>
12089 help text.
12090 <P>
12091 &lt;End of help on this topic&gt;
12092 </BODY>
12093 </HTML>
12094 ===== h_abook_select_checks =====
12095 <HTML>
12096 <HEAD>
12097 <TITLE>Address Selection from Composer Explained</TITLE>
12098 </HEAD>
12099 <BODY>
12100 <H1>COMPOSER: SELECT ADDRESSES</H1>
12101 <!--chtml if pinemode="function_key"-->
12102 <PRE>
12103 Navigating the List of Messages                 General Alpine Commands
12104 -------------------------------                 -----------------------
12105 F5   Move to previous entry                     F1  Show this help text
12106 F6   Move to next entry
12107 F7   Show previous screen of address book
12108 F8   Show next screen of address book
12109 F12  WhereIs (search through address book)
12110
12111 Address Selection Commands
12112 --------------------------
12113 F3   Exit the Address Select screen (without selecting an address)
12114 F4   Select the currently highlighted entry
12115 F8   Either Sets or Unsets all entries in this address book
12116 F9   Set or Unset the highlighted entry
12117 </PRE>
12118 <!--chtml else-->
12119 <PRE>
12120 Navigating the List of Messages                 General Alpine Commands
12121 -------------------------------                 -----------------------
12122  P   Move to previous entry                     ?  Show this help text
12123  N   Move to next entry
12124  -   Show previous screen of address book
12125 Spc  (space bar) Show next screen of address book
12126  W   WhereIs (search through address book)
12127
12128 Address Selection Commands
12129 --------------------------
12130  E   Exit the Address Select screen (without selecting an address)
12131  S   Select the currently highlighted entry
12132  X   Set or Unset the highlighted entry
12133  A   Either Sets or Unsets all entries in this address book
12134 </PRE>
12135 <!--chtml endif-->
12136 <P>
12137
12138 Mark the entries you wish to select with the &quot;X Set/Unset&quot;
12139 command.  Type &quot;S Select&quot; to select all of the entries you
12140 have marked, just as if you had typed them in by hand.
12141 <P>
12142
12143 An alternative method of composing a message to entries in your
12144 address book(s) is to first use the &quot;Select&quot; command from
12145 the address book maintenance screen and then the &quot;Apply&quot;
12146 &quot;ComposeTo&quot; command to start the composer composing to the
12147 selected entries.
12148 <P>
12149
12150 FOR MORE INFORMATION on addressing see
12151 <A HREF="h_address_format">Explanation of Address formats</A>, and the
12152 <A HREF="h_abook_opened">Address Book Screen's</A>
12153 help text.
12154 <P>
12155 &lt;End of help on this topic&gt;
12156 </BODY>
12157 </HTML>
12158 ===== h_abook_select_nicks_take =====
12159 <HTML>
12160 <HEAD>
12161 <TITLE>Take Address Nickname Selection Explained</TITLE>
12162 </HEAD>
12163 <BODY>
12164 <H1>TAKEADDR: SELECT NICKNAME</H1>
12165 <!--chtml if pinemode="function_key"-->
12166 <PRE>
12167 Navigating the List of Messages                 General Alpine Commands
12168 -------------------------------                 -----------------------
12169 F5   Move to previous entry                     F1  Show this help text
12170 F6   Move to next entry
12171 F7   Show previous screen of address book
12172 F8   Show next screen of address book
12173 F12  WhereIs (search through address book)
12174
12175 Message Selection Commands
12176 --------------------------
12177 F3   Exit the Nickname Select screen (without selecting an address)
12178 F4   Select the currently highlighted entry
12179 </PRE>
12180 <!--chtml else-->
12181 <PRE>
12182 Navigating the List of Messages                 General Alpine Commands
12183 -------------------------------                 -----------------------
12184  P   Move to previous entry                     ?  Show this help text
12185  N   Move to next entry
12186  -   Show previous screen of address book
12187 Spc  (space bar) Show next screen of address book
12188  W   WhereIs (search through address book)
12189
12190 Message Selection Commands
12191 --------------------------
12192  E   Exit the Nickname Select screen (without selecting an address)
12193  S   Select the currently highlighted entry
12194 </PRE>
12195 <!--chtml endif-->
12196 <P>
12197
12198 This screen is designed to let you modify or add to an existing
12199 address book entry.  You have already selected the name(s) and
12200 address(es) through &quot;Take Address&quot;.  This screen simply lets
12201 you scan your address books and select the nickname to be
12202 changed/augmented.  If you want to add a new entry, then you are in
12203 the wrong place-- Select &quot;Exit&quot; command.
12204 <P>
12205
12206 FOR MORE INFORMATION on addressing see
12207 <A HREF="h_address_format">Explanation of Address formats</A>, and the
12208 <A HREF="h_abook_opened">Address Book Screen's</A>
12209 help text.
12210 <P>
12211 &lt;End of help on this topic&gt;
12212 </BODY>
12213 </HTML>
12214 ===== h_abook_select_nick =====
12215 <HTML>
12216 <HEAD>
12217 <TITLE>Nickname Selection Explained</TITLE>
12218 </HEAD>
12219 <BODY>
12220 <H1>SELECT NICKNAME</H1>
12221 <!--chtml if pinemode="function_key"-->
12222 <PRE>
12223 Navigating the List of Messages                 General Alpine Commands
12224 -------------------------------                 -----------------------
12225 F5   Move to previous entry                     F1  Show this help text
12226 F6   Move to next entry
12227 F7   Show previous screen of address book
12228 F8   Show next screen of address book
12229 F12  WhereIs (search through address book)
12230
12231 Message Selection Commands
12232 --------------------------
12233 F3   Exit the Nickname Select screen (without selecting an address)
12234 F4   Select the currently highlighted entry
12235 </PRE>
12236 <!--chtml else-->
12237 <PRE>
12238 Navigating the List of Messages                 General Alpine Commands
12239 -------------------------------                 -----------------------
12240  P   Move to previous entry                     ?  Show this help text
12241  N   Move to next entry
12242  -   Show previous screen of address book
12243 Spc  (space bar) Show next screen of address book
12244  W   WhereIs (search through address book)
12245
12246 Message Selection Commands
12247 --------------------------
12248  E   Exit the Nickname Select screen (without selecting an address)
12249  S   Select the currently highlighted entry
12250 </PRE>
12251 <!--chtml endif-->
12252 <P>
12253
12254 This screen is designed to let you look at the nicknames in your address
12255 books before choosing a new one.
12256 <P>
12257
12258 FOR MORE INFORMATION on addressing see
12259 <A HREF="h_address_format">Explanation of Address formats</A>, and the
12260 <A HREF="h_abook_opened">Address Book Screen's</A>
12261 help text.
12262 <P>
12263 &lt;End of help on this topic&gt;
12264 </BODY>
12265 </HTML>
12266 ===== h_takeaddr_screen =====
12267 <HTML>
12268 <HEAD>
12269 <TITLE>Take Address Screen Explained</TITLE>
12270 </HEAD>
12271 <BODY>
12272 <H1>TAKE ADDRESS COMMANDS</H1>
12273 <!--chtml if pinemode="function_key"-->
12274 <PRE>
12275 Navigating the List of Addresses       Address Selection Commands
12276 --------------------------------       --------------------------
12277  F5  Move to previous entry            F3  Exit without taking address
12278  F6  Move to next entry                F4  Take current address(es)
12279  F7  Show previous page of address list
12280  F8  Show next page of address list
12281  F2  WhereIs (search list)
12282                                --------------
12283 Mode Toggle            F9  Set/Unset current address
12284 -----------            F10 Set all
12285  F12 Toggle between List and single mode       F11 Unset all
12286 </PRE>
12287 <!--chtml else-->
12288 <PRE>
12289 Navigating the List of Addresses       Address Selection Commands
12290 --------------------------------       --------------------------
12291  P  Move to previous entry              &lt;  Exit without taking address
12292  N  Move to next entry                  T  Take address
12293  -  Show previous page of address list
12294 Spc (space bar) Show next page of address list
12295  W  WhereIs (search list)              List Mode
12296                                        ---------
12297 Single Mode                             X  Set/Unset current address
12298 -----------                             A  Set all addresses
12299  L  Switch to list mode                 U  Unset all addresses
12300                                         S  Switch to single mode
12301 </PRE>
12302 <!--chtml endif-->
12303
12304 <H2>Description of the Take Address Screen</H2>
12305
12306 This screen is designed to let you select one or more address/name
12307 combinations from the current message and put them into your address book.
12308 The cursor is initially placed on the line with the message author.
12309 Other lines include the names of people and/or mailing lists who also
12310 received the message.  Other people &quot;involved&quot; in the
12311 message (e.g. the person named as Reply-To:) are also listed here.
12312 <P>
12313
12314 The simple case is adding a new, single entry into your address book. To
12315 do this, simply highlight the correct line and press
12316 <!--chtml if pinemode="function_key"-->
12317 F4.
12318 <!--chtml else-->
12319 &quot;T&quot;.
12320 <!--chtml endif-->
12321 To create a new list or add to an existing list, switch the screen display
12322 into List Mode by pressing
12323 <!--chtml if pinemode="function_key"-->
12324 F12.
12325 <!--chtml else-->
12326 &quot;L&quot;.
12327 <!--chtml endif-->
12328 In List Mode, you select the
12329 group of addresses you wish to manipulate by marking them with an
12330 &quot;X&quot;.
12331 The Set/Unset
12332 <!--chtml if pinemode="function_key"-->
12333 (F9)
12334 <!--chtml else-->
12335 (&quot;X&quot;)
12336 <!--chtml endif-->
12337 command will turn the &quot;X&quot; on for the
12338 highlighted address if it was off or turn it off if it was previously on.
12339 The SetAll command will select all of the addresses, and the UnSetAll
12340 command will turn off all the selections.  Once you've gotten the
12341 selection the way you want it, you may create a new list by pressing
12342 <!--chtml if pinemode="function_key"-->
12343 F4.
12344 <!--chtml else-->
12345 &quot;T&quot;.
12346 <!--chtml endif-->
12347 <P>
12348
12349 In both the simple and list cases, after choosing to take the address,
12350 you will be asked for the nickname of the entry.  Typing in a new name
12351 creates the new entry/list.  Entering an existing nickname will replace
12352 the entry (simple case) or add to the list (list case).  Alternatively,
12353 you can press Ctrl-T at the nickname prompt and select an existing
12354 nickname from your address book.
12355 <P>
12356
12357 You will normally start in Single Mode, unless you used the Apply command
12358 to startup the TakeAddr screen, in which case you will start in List Mode.
12359 You may switch between the two modes at any time.  If you've already
12360 selected several addresses in List Mode, those will be remembered when you
12361 switch to Single Mode and then back to List Mode.  The set of addresses
12362 that are pre-selected when you start in List Mode are the From addresses
12363 of all of the messages you are operating on.  You may, of course, easily
12364 erase those selections with the UnSetAll command.
12365 <P>
12366
12367 If you have more than one writable address book, you will be prompted for
12368 the name of the address book you wish to add the new entry to before
12369 anything else. You can use ^N and ^P to choose among the defined address
12370 books, or type in the address book name.
12371 <P>
12372
12373 FOR MORE INFORMATION on addressing see
12374 <A HREF="h_address_format">Explanation of Address formats</A>, and the
12375 <A HREF="h_abook_opened">Address Book Screen's</A>
12376 help text.
12377 <P>
12378 &lt;End of help on this topic&gt;
12379 </BODY>
12380 </HTML>
12381 ===== h_takeexport_screen =====
12382 <HTML>
12383 <HEAD>
12384 <TITLE>Take Export Screen Explained</TITLE>
12385 </HEAD>
12386 <BODY>
12387 <H1>TAKE EXPORT COMMANDS</H1>
12388 <!--chtml if pinemode="function_key"-->
12389 <PRE>
12390 Navigating the List of Addresses       Address Selection Commands
12391 --------------------------------       --------------------------
12392  F5  Move to previous entry            F3  Exit without taking address
12393  F6  Move to next entry                F4  Take current address(es)
12394  F7  Show previous page of address list
12395  F8  Show next page of address list
12396  F2  WhereIs (search list)
12397                                --------------
12398 Mode Toggle            F9  Set/Unset current address
12399 -----------            F10 Set all
12400  F12 Toggle between List and single mode       F11 Unset all
12401 </PRE>
12402 <!--chtml else-->
12403 <PRE>
12404 Navigating the List of Addresses       Address Selection Commands
12405 --------------------------------       --------------------------
12406  P  Move to previous entry              &lt;  Exit without taking address
12407  N  Move to next entry                  T  Take address
12408  -  Show previous page of address list
12409 Spc (space bar) Show next page of address list
12410  W  WhereIs (search list)              List Mode
12411                                        ---------
12412 Single Mode                             X  Set/Unset current address
12413 -----------                             A  Set all addresses
12414  L  Switch to list mode                 U  Unset all addresses
12415                                         S  Switch to single mode
12416 </PRE>
12417 <!--chtml endif-->
12418
12419 <H2>Description of the Take Export Screen</H2>
12420
12421 This screen is designed to let you select one or more addresses
12422 from the current message and put them into a file.
12423 Only the user@domain_name part of each address is put into the file.
12424 <P>
12425
12426 To put a single entry into a file simply highlight the correct line and press
12427 <!--chtml if pinemode="function_key"-->
12428 F4.
12429 <!--chtml else-->
12430 &quot;T&quot;.
12431 <!--chtml endif-->
12432 To put more than one entry into a file
12433 switch the screen display
12434 into List Mode by pressing
12435 <!--chtml if pinemode="function_key"-->
12436 F12.
12437 <!--chtml else-->
12438 &quot;L&quot;.
12439 <!--chtml endif-->
12440 In List Mode, you select the
12441 group of addresses you wish to manipulate by marking them with an
12442 &quot;X&quot;.
12443 The Set/Unset
12444 <!--chtml if pinemode="function_key"-->
12445 (F9)
12446 <!--chtml else-->
12447 (&quot;X&quot;)
12448 <!--chtml endif-->
12449 command will turn the &quot;X&quot; on for the
12450 highlighted address if it was off or turn it off if it was previously on.
12451 The SetAll command will select all of the addresses, and the UnSetAll
12452 command will turn off all the selections.  Once you've gotten the
12453 selection the way you want it, you may put the addresses in a file by typing
12454 <!--chtml if pinemode="function_key"-->
12455 F4.
12456 <!--chtml else-->
12457 &quot;T&quot;.
12458 <!--chtml endif-->
12459 <P>
12460
12461 You will be asked for the name of a file to put the addresses in.
12462 If the file already exists, you will be asked whether you want to Overwrite
12463 (replace) the contents of the file or Append to the contents of the file.
12464 <P>
12465
12466 &lt;End of help on this topic&gt;
12467 </BODY>
12468 </HTML>
12469 ============= h_abook_view ========================
12470 <HTML>
12471 <HEAD>
12472 <TITLE>Address Book View Explained</TITLE>
12473 </HEAD>
12474 <BODY>
12475 This function allows you to view the contents of an address book entry. You
12476 can only view one entry at a time.
12477 <P>
12478 <DL>
12479 <DT>Help
12480 <!--chtml if pinemode="function_key"-->
12481 (F1)
12482 <!--chtml else-->
12483 (?)
12484 <!--chtml endif-->
12485 </DT>
12486 <DD>
12487 Display this help text.
12488
12489 <DT>Abook
12490 <!--chtml if pinemode="function_key"-->
12491 (F3)
12492 <!--chtml else-->
12493 (&lt;)
12494 <!--chtml endif-->
12495 </DT>
12496 <DD>
12497 Go back to index of address book entries.
12498
12499 <DT>Update
12500 <!--chtml if pinemode="function_key"-->
12501 (F4)
12502 <!--chtml else-->
12503 (U)
12504 <!--chtml endif-->
12505 </DT>
12506 <DD>
12507 Update (modify) this entry.
12508
12509 <DT>ComposeTo
12510 <!--chtml if pinemode="function_key"-->
12511 (F5)
12512 <!--chtml else-->
12513 (C)
12514 <!--chtml endif-->
12515 </DT>
12516 <DD>Compose a message to the address(es) in this entry.
12517
12518 <DT>Role
12519 <!--chtml if pinemode="function_key"-->
12520 (F6)
12521 <!--chtml else-->
12522 (#)
12523 <!--chtml endif-->
12524 </DT>
12525 <DD>Compose a message to the address(es) in this entry using roles.
12526
12527 <DT>Prev Page
12528 <!--chtml if pinemode="function_key"-->
12529 (F7)
12530 <!--chtml else-->
12531 (-)
12532 <!--chtml endif-->
12533 </DT>
12534 <DD>
12535 Show the previous page of the current entry.
12536
12537 <DT>Next Page
12538 <!--chtml if pinemode="function_key"-->
12539 (F8)
12540 <!--chtml else-->
12541 (Space)
12542 <!--chtml endif-->
12543 </DT>
12544 <DD>
12545 Show the next page of the current entry.
12546
12547 <DT>Print
12548 <!--chtml if pinemode="function_key"-->
12549 (F9)
12550 <!--chtml else-->
12551 (%)
12552 <!--chtml endif-->
12553 </DT>
12554 <DD>Print the current entry.  You can select the
12555 printer or the print command via the &quot;Setup&quot; command
12556 on the MAIN MENU.
12557
12558 <DT>WhereIs
12559 <!--chtml if pinemode="function_key"-->
12560 (F10)
12561 <!--chtml else-->
12562 (W)
12563 <!--chtml endif-->
12564 </DT>
12565 <DD>Search the entry for a string of letters.  If it is
12566 found, move to it.  The string can be one word or a phrase.
12567 If there are multiple occurrences, the cursor moves to the
12568 first occurrence beyond the current cursor position.
12569
12570 <DT>Fwd Email
12571 <!--chtml if pinemode="function_key"-->
12572 (F11)
12573 <!--chtml else-->
12574 (F)
12575 <!--chtml endif-->
12576 </DT>
12577 <DD>Begin composition of a new mail message with the displayed
12578 text already inserted in the message body.
12579
12580 </DL>
12581 <P>
12582 &lt;End of help on this topic&gt;
12583 </BODY>
12584 </HTML>
12585 ============= h_ldap_view ========================
12586 <HTML>
12587 <HEAD>
12588 <TITLE>LDAP Response View Explained</TITLE>
12589 </HEAD>
12590 <BODY>
12591 This function allows you to view the contents of a directory entry. You
12592 can only view one entry at a time.
12593 <P>
12594 <DL>
12595 <DT>Help
12596 <!--chtml if pinemode="function_key"-->
12597 (F1)
12598 <!--chtml else-->
12599 (?)
12600 <!--chtml endif-->
12601 </DT>
12602 <DD>
12603 Display this help text.
12604
12605 <DT>Results Index
12606 <!--chtml if pinemode="function_key"-->
12607 (F3)
12608 <!--chtml else-->
12609 (&lt;)
12610 <!--chtml endif-->
12611 </DT>
12612 <DD>Go back to index of search results.
12613
12614 <DT>ComposeTo
12615 <!--chtml if pinemode="function_key"-->
12616 (F5)
12617 <!--chtml else-->
12618 (C)
12619 <!--chtml endif-->
12620 </DT>
12621 <DD>Compose a message to the address(es) in this entry.
12622
12623 <DT>Role
12624 <!--chtml if pinemode="function_key"-->
12625 (F6)
12626 <!--chtml else-->
12627 (#)
12628 <!--chtml endif-->
12629 </DT>
12630 <DD>Compose a message to the address(es) in this entry using roles.
12631
12632 <DT>Prev Page
12633 <!--chtml if pinemode="function_key"-->
12634 (F7)
12635 <!--chtml else-->
12636 (-)
12637 <!--chtml endif-->
12638 </DT>
12639 <DD>
12640 Show the previous page of the current entry.
12641
12642 <DT>Next Page
12643 <!--chtml if pinemode="function_key"-->
12644 (F8)
12645 <!--chtml else-->
12646 (Space)
12647 <!--chtml endif-->
12648 </DT>
12649 <DD>
12650 Show the next page of the current entry.
12651
12652 <DT>Print
12653 <!--chtml if pinemode="function_key"-->
12654 (F9)
12655 <!--chtml else-->
12656 (%)
12657 <!--chtml endif-->
12658 </DT>
12659 <DD>Print the current entry on paper.  You can select the
12660 printer or the print command via the &quot;Setup&quot; command
12661 on the MAIN MENU.
12662
12663 <DT>WhereIs
12664 <!--chtml if pinemode="function_key"-->
12665 (F10)
12666 <!--chtml else-->
12667 (W)
12668 <!--chtml endif-->
12669 </DT>
12670 <DD>Search the entry for a string of letters.  If it is
12671 found, move to it.  The string can be one word or a phrase.
12672 If there are multiple occurrences, the cursor moves to the
12673 first occurrence beyond the current cursor position.
12674
12675 <DT>Fwd Email
12676 <!--chtml if pinemode="function_key"-->
12677 (F11)
12678 <!--chtml else-->
12679 (F)
12680 <!--chtml endif-->
12681 </DT>
12682 <DD>Begin composition of a new mail message with the displayed
12683 text already inserted in the message body.
12684
12685 <DT>Save
12686 <!--chtml if pinemode="function_key"-->
12687 (F12)
12688 <!--chtml else-->
12689 (S)
12690 <!--chtml endif-->
12691 </DT>
12692 <DD>Save the displayed entry to one of your address books or export
12693 it to a file.
12694 </DL>
12695 <P>
12696 &lt;End of help on this topic&gt;
12697 </BODY>
12698 </HTML>
12699 ===== h_attachment_screen =====
12700 <HTML>
12701 <HEAD>
12702 <TITLE>Attachment Index Screen Explained</TITLE>
12703 </HEAD>
12704 <BODY>
12705 The &quot;ATTACHMENT INDEX&quot; displays a list of the current
12706 message's attachments, and allows various operations on them.  The
12707 first attachment is usually the message text, but does not include the
12708 header portion of the message.
12709 <P>
12710 Available commands include:
12711 <P>
12712 <DL>
12713
12714 <DT>Help</DT>
12715 <DD>Show this help text.
12716
12717 <DT>Msg #<I>num</I></DT>
12718 <DD>Leave this screen without displaying or saving any attachments.
12719
12720 <DT>View</DT>
12721 <DD>View the currently selected attachment.
12722
12723 <DT>Prev Attach</DT>
12724 <DD>Move to previous attachment.
12725
12726 <DT>Next Attach</DT>
12727 <DD>Move to next attachment.
12728
12729 <DT>Prev Page</DT>
12730 <DD>Previous page of the listed attachments.
12731
12732 <DT>Next Page</DT>
12733 <DD>Next page of the listed attachments.
12734
12735 <DT>Delete</DT>
12736 <DD>Mark the currently selected attachment for Deletion.
12737 This does not modify the current message by deleting the attachment from
12738 it, but instead the delete flag <EM>only</EM> has an effect when saving
12739 the message to a folder.
12740 Attachments marked for deletion are not copied to the destination folder
12741 along with the rest of the message when it is saved.
12742 It is ok for the destination folder to be the same as the current folder.
12743 In addition, the delete mark <EM>only</EM> applies to this Alpine session.
12744
12745 <DT>Undelete</DT>
12746 <DD>Turn off the Delete flag for the selected attachment.
12747
12748 <DT>Save</DT>
12749 <DD>Save the selected attachment to a file.  If the attachment is of
12750 type &quot;RFC822/Message&quot;, then the attachment will be saved to
12751 the specified mail folder.
12752
12753 <DT>Export</DT>
12754 <DD>If the attachment is of
12755 type &quot;RFC822/Message&quot;, then &quot;Export&quot; is used to
12756 copy the message to a file in the same way this command works on
12757 messages in the MESSAGE INDEX and MESSAGE TEXT screens.
12758
12759 <DT>Pipe</DT>
12760 <DD>Pipe the attachment contents into a UNIX command (if enabled).
12761 A description of the Pipe sub-commands is  <A HREF="h_pipe_command">here</A>.
12762
12763 <DT>WhereIs</DT>
12764 <DD>Find a matching string in the attachment list.
12765
12766 <DT>AboutAttch</DT>
12767 <DD>Examine various aspects of the selected attachment.
12768
12769 <DT>Print</DT>
12770 <DD>Print the selected attachment.
12771
12772 <DT>Forward</DT>
12773 <DD>Forward the selected attachment as an attachment.
12774 </DL>
12775
12776 <P>
12777
12778 All attachments can be saved or piped into a UNIX command, but some may
12779 not be readily displayed by either Alpine or an external tool.  In such
12780 cases, the reason why the message cannot be displayed is displayed on
12781 Alpine's message line.
12782 <P>
12783 &lt;End of help on this topic&gt;
12784 </BODY>
12785 </HTML>
12786 ============= h_mail_text_att_view ========================
12787 <HTML>
12788 <HEAD>
12789 <TITLE>Attachment View Screen Explained</TITLE>
12790 </HEAD>
12791 <BODY>
12792 This function allows you to view the contents of a text attachment. You
12793 can only view one attachment at a time.
12794 <P>
12795 Available commands include:
12796 <P>
12797 <DL>
12798
12799 <DT>Help</DT>
12800 <DD>Display this help text
12801
12802 <DT>AttchIndex</DT>
12803 <DD>Leave viewer and return to the &quot;ATTACHMENT INDEX&quot; screen
12804
12805 <DT>Prev Page</DT>
12806 <DD>Show the previous page of the current attachment.
12807
12808 <DT>Next Page</DT>
12809 <DD>Show the next page of the current attachment by pressing the space bar.
12810
12811 <DT>Delete</DT>
12812 <DD>Mark the viewed attachment for Deletion.  The delete
12813 flag <EM>only</EM> has affect when saving the message to a folder.
12814 Attachments marked for deletion are exluded from the messsage when
12815 it is saved.  In addition, the delete mark <EM>only</EM> applies to
12816 this Alpine session.
12817
12818 <DT>Undelete</DT>
12819 <DD>Turn off the Delete flag for the selected attachment.
12820
12821 <DT>Save</DT>
12822 <DD>Copy the current attachment to a file.  If you just enter
12823 a filename, the attachment will be saved with that name in
12824 your home directory
12825 <!--chtml if pinemode="running"-->
12826 (which, in the present configuration of your system, is
12827  &quot;<!--#echo var="HOME_DIR"-->&quot;)
12828 <!--chtml endif-->
12829 or current working directory
12830 <!--chtml if pinemode="running"-->
12831 (which, at least for your current Alpine &quot;session,&quot;
12832 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
12833 <!--chtml endif-->, depending on the
12834 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
12835 configuration setting.  You may enter the full
12836 path and filename to save it in another directory instead.
12837
12838 <DT>Export</DT>
12839 <DD>If the attachment is of
12840 type &quot;RFC822/Message&quot;, then &quot;Export&quot; is used to
12841 copy the message to a file in the same way this command works on
12842 messages in the MESSAGE INDEX and MESSAGE TEXT screens.
12843 (If you have any <A HREF="h_config_display_filters"><!--#echo var="VAR_display-filters"--></A>
12844 defined, they may affect the contents of the exported file.)
12845
12846 <DT>Pipe</DT>
12847 <DD>Pipe the attachment contents into a UNIX command (if enabled)
12848
12849 <DT>WhereIs</DT>
12850 <DD>Search the attachment for a string of letters.  If it is
12851 found, move to it.  The string can be one word or a phrase.
12852 If there are multiple occurrences, the cursor moves to the
12853 first occurrence beyond the current cursor position.
12854
12855 <DT>Print</DT>
12856 <DD>Print the current attachment on paper.  You can select the
12857 printer or the print command via the &quot;Setup&quot; command
12858 on the MAIN MENU.
12859
12860 <DT>Forward</DT>
12861 <DD>Forward the selected attachment as an attachment.
12862 </DL>
12863 <P>
12864 &lt;End of help on this topic&gt;
12865 </BODY>
12866 </HTML>
12867 ============= h_journal ==============
12868 <HTML>
12869 <HEAD>
12870 <TITLE>Recent Message Journal Explained</TITLE>
12871 </HEAD>
12872 <BODY>
12873
12874 The following commands are available on this screen:
12875 <P>
12876 <DL>
12877 <DT>Help</DT>
12878 <DD>Show this help text
12879
12880 <DT>Exit</DT>
12881 <DD>Exit Viewer, and go back to mail processing
12882
12883 <DT>Prev Page</DT>
12884 <DD>Show the previous page text
12885
12886 <DT>Next Page</DT>
12887 <DD>Show the next page of text by pressing the space bar
12888
12889 <DT>Print</DT>
12890 <DD>Print the displayed text on paper.  You can select the
12891 printer or the print command via the &quot;Setup&quot; command
12892 on the MAIN MENU.
12893
12894 <DT>Fwd Email</DT>
12895 <DD>Begin composition of a new mail message with the displayed
12896 text already inserted in the message body.
12897
12898 <DT>Save</DT>
12899 <DD>Copy the displayed text to a file.  If you just enter
12900 a filename, the text will be saved with that name in
12901 your
12902 home directory
12903 <!--chtml if pinemode="running"-->
12904 (which, in the present configuration of your system, is
12905  &quot;<!--#echo var="HOME_DIR"-->&quot;)
12906 <!--chtml endif-->
12907 or current working directory
12908 <!--chtml if pinemode="running"-->
12909 (which, at least for your current Alpine &quot;session,&quot;
12910 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
12911 <!--chtml endif-->, depending on the
12912 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
12913 configuration setting.   You may enter the full
12914 path and filename to save it in another directory instead.
12915
12916 <DT>WhereIs</DT>
12917 <DD>Search the text for a string of letters.  If it is
12918 found, move to it.  The string can be one word or a phrase.
12919 If there are multiple occurrences, the cursor moves to the
12920 first occurrence beyond the current cursor position.
12921 </DL>
12922 <P>
12923 &lt;End of help on this topic&gt;
12924 </BODY>
12925 </HTML>
12926 ============= h_debugjournal ==============
12927 <HTML>
12928 <HEAD>
12929 <TITLE>Debug Journal Explained</TITLE>
12930 </HEAD>
12931 <BODY>
12932
12933 The following commands are available on this screen:
12934 <P>
12935 <DL>
12936 <DT>Help</DT>
12937 <DD>Show this help text
12938
12939 <DT>Exit</DT>
12940 <DD>Exit Viewer, and go back to mail processing
12941
12942 <DT>Timestamps</DT>
12943 <DD>Turn on or off timestamps.
12944
12945 <DT>DebugView</DT>
12946 <DD>Set the level of debugging you want to see. The level may be any number
12947 in the range 0-9. Higher numbers show more debugging detail. Note that the
12948 debugging information has already been captured. This setting just causes the
12949 debugging information that you see to be filtered. If you set this to
12950 the number &quot;5&quot; then you will be shown all of the debugging information
12951 at levels 5 and below.
12952 It's actually a bit more complicated than that. A fixed amount of memory
12953 is used to store the debug information.
12954 Since the amount of memory used is limited the debugging information
12955 has to be trimmed back when it gets too large.
12956
12957 <DT>Prev Page</DT>
12958 <DD>Show the previous page text
12959
12960 <DT>Next Page</DT>
12961 <DD>Show the next page of text by pressing the space bar
12962
12963 <DT>Print</DT>
12964 <DD>Print the displayed text on paper.  You can select the
12965 printer or the print command via the &quot;Setup&quot; command
12966 on the MAIN MENU.
12967
12968 <DT>Fwd Email</DT>
12969 <DD>Begin composition of a new mail message with the displayed
12970 text already inserted in the message body.
12971
12972 <DT>Save</DT>
12973 <DD>Copy the displayed text to a file.  If you just enter
12974 a filename, the text will be saved with that name in
12975 your
12976 home directory
12977 <!--chtml if pinemode="running"-->
12978 (which, in the present configuration of your system, is
12979  &quot;<!--#echo var="HOME_DIR"-->&quot;)
12980 <!--chtml endif-->
12981 or current working directory
12982 <!--chtml if pinemode="running"-->
12983 (which, at least for your current Alpine &quot;session,&quot;
12984 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
12985 <!--chtml endif-->, depending on the
12986 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
12987 configuration setting.   You may enter the full
12988 path and filename to save it in another directory instead.
12989
12990 <DT>WhereIs</DT>
12991 <DD>Search the text for a string of letters.  If it is
12992 found, move to it.  The string can be one word or a phrase.
12993 If there are multiple occurrences, the cursor moves to the
12994 first occurrence beyond the current cursor position.
12995 </DL>
12996 <P>
12997 &lt;End of help on this topic&gt;
12998 </BODY>
12999 </HTML>
13000 ============= h_simple_text_view ==============
13001 <HTML>
13002 <HEAD>
13003 <TITLE>Simple Text View Screen Explained</TITLE>
13004 </HEAD>
13005 <BODY>
13006
13007 The following commands are available on this screen:
13008 <P>
13009 <DL>
13010 <DT>Help</DT>
13011 <DD>Show this help text
13012
13013 <DT>Exit</DT>
13014 <DD>Exit Viewer, and go back to mail processing
13015
13016 <DT>Prev Page</DT>
13017 <DD>Show the previous page text
13018
13019 <DT>Next Page</DT>
13020 <DD>Show the next page of text by pressing the space bar
13021
13022 <DT>Print</DT>
13023 <DD>Print the displayed text on paper.  You can select the
13024 printer or the print command via the &quot;Setup&quot; command
13025 on the MAIN MENU.
13026
13027 <DT>Fwd Email</DT>
13028 <DD>Begin composition of a new mail message with the displayed
13029 text already inserted in the message body.
13030
13031 <DT>Save</DT>
13032 <DD>Copy the displayed text to a file.  If you just enter
13033 a filename, the attachment will be saved with that name in
13034 your
13035 home directory
13036 <!--chtml if pinemode="running"-->
13037 (which, in the present configuration of your system, is
13038  &quot;<!--#echo var="HOME_DIR"-->&quot;)
13039 <!--chtml endif-->
13040 or current working directory
13041 <!--chtml if pinemode="running"-->
13042 (which, at least for your current Alpine &quot;session,&quot;
13043 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
13044 <!--chtml endif-->, depending on the
13045 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
13046 configuration setting.   You may enter the full
13047 path and filename to save it in another directory instead.
13048
13049 <DT>WhereIs</DT>
13050 <DD>Search the attachment for a string of letters.  If it is
13051 found, move to it.  The string can be one word or a phrase.
13052 If there are multiple occurrences, the cursor moves to the
13053 first occurrence beyond the current cursor position.
13054 </DL>
13055 <P>
13056 &lt;End of help on this topic&gt;
13057 </BODY>
13058 </HTML>
13059 ======= h_pine_for_windows ========
13060 <HTML>
13061 <HEAD>
13062 <TITLE>GETTING HELP IN PC-ALPINE</TITLE>
13063 </HEAD>
13064 <BODY>
13065 <H1>Getting Help In PC-Alpine</H1>
13066
13067 <P>
13068 PC-Alpine offers general and specific help text. From the <A
13069 HREF="main_menu_tx">MAIN MENU</A>, you will find an overview in the MAIN
13070 MENU HELP and the <A HREF="h_news">Release Notes</A>.  On all screens,
13071 specific help for that screen is available from the toolbar Help menu or
13072 with the
13073 <!--chtml if pinemode="function_key"-->
13074 &quot;F1&quot; key.
13075 <!--chtml else-->
13076 &quot;?&quot; or &quot;Ctrl-G&quot; keys. &quot;Ctrl-G&quot; is used where
13077 typing &quot;?&quot; would be mistaken as entering text.
13078 <!--chtml endif-->
13079
13080 <P>
13081 Although this version of Alpine is for Microsoft Windows, it is not
13082 considered a full &quot;Graphical User Interface&quot; application.
13083 Yet, many of the controls that Windows users are accustomed to seeing,
13084 such as scrollbars and toolbars, are available.
13085
13086 <P>
13087 PC-Alpine offers considerable mouse support.  You can view what is
13088 &quot;click-able&quot; by dragging your mouse over any screen; when the
13089 arrow cursor changes into a hand, you found something. Mouse-click
13090 possibilities include navigating between screens and folders and
13091 double-clicking on hyperlinks to open your Web browser.
13092 Context-sensitive pop-up menus appear with a right-click on your PC-Alpine
13093 screen.  Examples of right-click options include &quot;copy&quot; after
13094 selecting text to copy and &quot;View in New Window&quot; when you click
13095 on a particular message in the Message Index. The menu choices available
13096 to you will vary based upon what screen is open, where on the screen your
13097 cursor is located, and even what action you have already taken.
13098
13099 <P>
13100 &lt;End of help on this topic&gt;
13101 </BODY>
13102 </HTML>
13103 ===== h_composer =====
13104 <HTML>
13105 <HEAD>
13106 <TITLE>COMPOSER COMMANDS</TITLE>
13107 </HEAD>
13108 <BODY>
13109 <H1>COMPOSER COMMANDS</H1>
13110
13111 CURSOR&nbsp;MOTION&nbsp;KEYS&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|EDITING&nbsp;KEYS<BR>
13112 &nbsp;&nbsp;^B&nbsp;(Left&nbsp;Arrow)&nbsp;&nbsp;&nbsp;Back&nbsp;character&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;^D&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Delete&nbsp;current&nbsp;character<BR>
13113 &nbsp;&nbsp;^F&nbsp;(Right&nbsp;Arrow)&nbsp;&nbsp;Forward&nbsp;character&nbsp;&nbsp;|&nbsp;^H&nbsp;(DEL)&nbsp;Delete&nbsp;previous&nbsp;character<BR>
13114 &nbsp;&nbsp;^P&nbsp;(Up&nbsp;Arrow)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Previous&nbsp;line&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;^^&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set&nbsp;a&nbsp;<A HREF="h_compose_markcutpaste">mark</A><BR>
13115 &nbsp;&nbsp;^N&nbsp;(Down&nbsp;Arrow)&nbsp;&nbsp;&nbsp;Next&nbsp;line&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;<!--chtml if pinemode="function_key"-->F9<!--chtml else-->^K<!--chtml endif-->&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="h_compose_markcutpaste">Cut</A>&nbsp;marked&nbsp;text&nbsp;or<BR>
13116 &nbsp;&nbsp;^A&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Beginning&nbsp;of&nbsp;line&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;delete&nbsp;current&nbsp;line<BR>
13117 &nbsp;&nbsp;^E&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;End&nbsp;of&nbsp;line&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;<!--chtml if pinemode="function_key"-->F10<!--chtml else-->^U<!--chtml endif-->&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="h_compose_markcutpaste">Paste</A>&nbsp;text,&nbsp;undelete&nbsp;lines<BR>
13118 &nbsp;&nbsp;^Y&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Previous&nbsp;page&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;cut&nbsp;with&nbsp;^K,&nbsp;or&nbsp;unjustify<BR>
13119 &nbsp;&nbsp;^V&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Next&nbsp;page&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|-------------------------------------<BR>
13120 &nbsp;&nbsp;^@&nbsp;(Ctrl-SPACE)&nbsp;&nbsp;&nbsp;Next&nbsp;word&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|SCREEN/COMPOSITION&nbsp;COMMANDS<BR>
13121 ---------------------------------------|&nbsp;<!--chtml if pinemode="function_key"-->F6<!--chtml else-->^W<!--chtml endif-->&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="h_composer_search">Whereis</A>&nbsp;(search&nbsp;for&nbsp;string)<BR>
13122 MESSAGE&nbsp;COMMANDS&nbsp;|&nbsp;GENERAL&nbsp;COMMANDS&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;<!--chtml if pinemode="function_key"-->F12<!--chtml else-->^T&nbsp;<!--chtml endif-->&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="h_compose_spell">Spell&nbsp;checker</A><BR>
13123 &nbsp;<!--chtml if pinemode="function_key"-->F3<!--chtml else-->^C<!--chtml endif-->&nbsp;&nbsp;&nbsp;<A HREF="h_compose_cancel">Cancel</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;<!--chtml if pinemode="function_key"-->F1<!--chtml else-->^G<!--chtml endif-->&nbsp;&nbsp;&nbsp;&nbsp;Get&nbsp;help&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;<!--chtml if pinemode="function_key"-->F4<!--chtml else-->^J<!--chtml endif-->&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="h_compose_justify">Justify</A>&nbsp;paragraph<BR>
13124 &nbsp;<!--chtml if pinemode="function_key"-->F11<!--chtml else-->^O&nbsp;<!--chtml endif-->&nbsp;&nbsp;<A HREF="h_common_postpone">Postpone</A>&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;^Z&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="h_common_suspend">Suspend</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;^L&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Redraw&nbsp;Screen<BR>
13125 &nbsp;<!--chtml if pinemode="function_key"-->F2<!--chtml else-->^X<!--chtml endif-->&nbsp;&nbsp;&nbsp;<A HREF="h_compose_send">Send</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;<!--chtml if pinemode="function_key"-->F6<!--chtml else-->^_<!--chtml endif-->&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="h_compose_alted">Alt.&nbsp;editor</A>&nbsp;&nbsp;|&nbsp;<!--chtml if pinemode="function_key"-->F5<!--chtml else-->^R<!--chtml endif-->&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="h_compose_readfile">Read&nbsp;in&nbsp;a&nbsp;file</A><BR>
13126
13127 <P>
13128 NOTE:
13129 <OL>
13130  <LI>For help on a particular command, highlight the bold text associated
13131 with it above and hit Return.
13132  <LI> The availability of certain commands
13133 is determined by Alpine configuration files and system capabilities.
13134 At some sites, certain commands may not be available due to security or
13135 support concerns.
13136  <LI>Alpine does not use the following keys:  Ctrl-S, Ctrl-Q, Ctrl-],
13137 Ctrl-&#92;, ESC.
13138  <LI>For special handling of Ctrl-S and Ctrl-Q see special comments regarding
13139 <A HREF="h_special_xon_xoff">&quot;XOFF/XON&quot;</A>.
13140 </OL>
13141
13142 <P>
13143 HINT: To move rapidly to the bottom of a message you are composing,
13144 enter ^W^V.  To go to the top, ^W^Y.  These can be used in conjunction
13145 with the Mark and Cut commands to eliminate large amounts of unwanted
13146 text in a Reply.
13147
13148 <H2>Description of Composer</H2>
13149
13150 Alpine has a built-in editing program that allows you to compose messages
13151 without having to leave Alpine.  The editor is designed to be very simple to
13152 use so that you can get started writing email right away.
13153
13154 <P>
13155 Messages are usually just text, about 80 columns wide.  Using upper and
13156 lower case is encouraged.  On some systems the size limit of the message
13157 is about 100,000 characters, which is about 2,000 lines.  You can include
13158 punctuation and special characters found on most keyboards, but you can't
13159 include characters with diacritical marks and certain special symbols.
13160
13161 <P>
13162 Text automatically wraps as you type past the end of a line so you do not
13163 have to hit return.  Using the
13164 &quot;<A HREF="h_compose_justify">Justify</A>&quot; command,
13165 you can also reformat text explicitly, perhaps after you have
13166 deleted some text.
13167
13168 <P>
13169 You can include other text files with the
13170 &quot;<A HREF="h_compose_readfile">Read File</A>&quot; command,
13171 which will prompt you for the name of the file to insert at the
13172 current cursor postion.
13173
13174 <P>
13175 <UL>
13176 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
13177 </UL>
13178 <P>
13179 &lt;End of help on this topic&gt;
13180 </BODY>
13181 </HTML>
13182 ====== h_composer_browse =====
13183 <HTML>
13184 <HEAD>
13185 <TITLE>BROWSER</TITLE>
13186 </HEAD>
13187 <BODY>
13188 <H1>BROWSER</H1>
13189 This screen lets you browse your files and directories.  To go to another
13190 directory (identified by &quot;(dir)&quot;), move the cursor to it and
13191 choose &quot;Select&quot; (the default choice on the menu);
13192 or choose &quot;Goto&quot; and enter the name of the directory.
13193 <!--chtml if pinemode="os_windows"-->
13194 <!--chtml else-->
13195 In Unix Alpine, you may use
13196 &quot;~&quot; to refer to your home directory or &quot;~user&quot; to refer
13197 to another's home directory.
13198 <!--chtml endif--><P>
13199 To select a file, move the cursor to it and
13200 choose &quot;Select&quot; (the default choice on the menu).
13201 <P>
13202 <UL>
13203 <LI>Note <B>if</B> you are currently using the BROWSER for choosing a file for
13204 inclusion in the
13205 message body (that is, you chose &quot;Read File&quot; with the cursor under
13206 the
13207 &quot;----- Message Text -----&quot; line
13208 while composing, then &quot;To Files&quot;):  Since the file
13209 selected will become part of the message text, it must be in a format
13210 suitable for that (Alpine does not check!), such as a plain text file.
13211 Files of other formats (for example, graphics, databases, software
13212 programs) should be
13213 <B>attached</B> to the message instead --
13214 by moving the cursor in the COMPOSE MESSAGE screen into the
13215 message header area and pressing
13216 <!--chtml if pinemode="function_key"-->
13217 F6.
13218 <!--chtml else-->
13219 Ctrl-J.
13220 <!--chtml endif-->
13221
13222 <P><LI>
13223 Note <B>if</B> you are currently using the BROWSER for saving a message
13224 attachment, or exporting a message, to a file: You can use the Add command to
13225 provide the name for a new file to save/export to, and then select that name
13226 to use it for the save/export operation.  Back at the prompt
13227 &quot;EXPORT: Copy message to file in ...&quot; hit Enter, then choose
13228 either Overwrite or Append (it doesn't make a difference, since the file is
13229 so far empty).  Note: If you cancel the
13230 operation at that point, the file created with the Add command will remain
13231 0 bytes in size.
13232
13233 </UL>
13234 <P><UL>
13235 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
13236 </UL>
13237 <P>
13238 &lt;End of help on this topic&gt;
13239 </BODY>
13240 </HTML>
13241 ====== h_composer_ins =====
13242 <HTML>
13243 <HEAD>
13244 <TITLE>INSERT TEXT FILE</TITLE>
13245 </HEAD>
13246 <BODY>
13247 <H1>INSERT TEXT FILE</H1>
13248
13249 Use this function to insert a text file. The file name
13250 given can be an absolute file path name for your system
13251 <!--chtml if pinemode="os_windows"-->
13252 (for example, &quot;H:&#92;SIGFILES&#92;FULLINFO.TXT&quot;), a file
13253 with a relative pathname, or simply a file name without
13254 drive or directory specification.
13255 <!--chtml else-->
13256 (for example, &quot;/tmp/exported.earlier&quot; on Unix hosts),
13257 a file in your home directory, or a file path relative to your
13258 home directory.  In Unix Alpine, you may use &quot;~&quot; to refer to
13259 your home directory or &quot;~user&quot; to refer to another
13260 account's home directory.
13261 <!--chtml endif-->
13262 <P>
13263 No wild card characters may be used.
13264 The file must reside on the system running Alpine.
13265 <P>
13266 If the
13267 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
13268 feature is set, names are relative to your current working directory
13269 <!--chtml if pinemode="running"-->
13270 (which, at least for your current Alpine &quot;session,&quot;
13271 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
13272 <!--chtml endif-->
13273 rather than your home directory
13274 <!--chtml if pinemode="running"-->
13275 (which, in the present configuration of your system, is
13276  &quot;<!--#echo var="HOME_DIR"-->&quot;)
13277 <!--chtml endif-->
13278 .
13279 <P><UL>
13280 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
13281 </UL>
13282 <P>
13283 &lt;End of help on this topic&gt;
13284 </BODY>
13285 </HTML>
13286 ====== h_composer_ins_m =====
13287 <HTML>
13288 <HEAD>
13289 <TITLE>INSERT MESSAGE</TITLE>
13290 </HEAD>
13291 <BODY>
13292 <H1>INSERT MESSAGE</H1>
13293
13294 Type in the number of a message in the currently open folder to insert it
13295 into your message.
13296 <P><UL>
13297 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
13298 </UL>
13299 <P>
13300 &lt;End of help on this topic&gt;
13301 </BODY>
13302 </HTML>
13303 ====== h_composer_search =====
13304 <HTML>
13305 <HEAD>
13306 <TITLE>Explanation of Composer Whereis Command </TITLE>
13307 </HEAD>
13308 <BODY>
13309 <H1>Help For Whereis Command</H1>
13310
13311 Whereis is used to search the message for a word or part of a word.
13312 When searching in the composer, only the message part of your mail is
13313 searched, and the cursor is put on the first occurrence appearing
13314 after the location of the cursor.  The search will wrap to the
13315 beginning of the message when it no longer finds matches in the
13316 remainder of the message.
13317
13318 To search for the same string a second time, press
13319 <!--chtml if pinemode="function_key"-->
13320 &quot;F6&quot;
13321 <!--chtml else-->
13322 &quot;^W&quot;
13323 <!--chtml endif-->
13324 to begin search and then just press RETURN to accept the previous
13325 search string shown in square brackets rather than entering a new
13326 search string.<P>
13327
13328 The &quot;Search&quot; prompt has several sub-command available:
13329
13330 <DL>
13331 <DT>Get Help</DT>
13332 <DD> Takes you to this help page.
13333
13334 <DT>Cancel</DT>
13335 <DD> Cancels the prompt.  No search takes place.
13336
13337 <DT>First Line</DT>
13338 <DD> Takes you back to the composer with the cursor on the first character
13339 of the first line of text.
13340
13341 <DT>Last Line</DT>
13342 <DD> Takes you back to the composer with the cursor on the last character
13343 of the last line of text.
13344
13345 <DT>Replace (Optional)</DT>
13346 <DD> This sub-command is enabled by the
13347 <A HREF="h_config_enable_search_and_repl">&quot;<!--#echo var="FEAT_enable-search-and-replace"-->&quot;</A>
13348 feature (which is on by default); see its help screen for details on how replacing works.
13349
13350 </DL>
13351
13352 &lt;End of help on this topic&gt;
13353 </BODY>
13354 </HTML>
13355 ====== h_sigedit_search =====
13356 <HTML>
13357 <HEAD>
13358 <TITLE>Explanation of Whereis Command </TITLE>
13359 </HEAD>
13360 <BODY>
13361 <H1>Help For Whereis Command</H1>
13362
13363 Whereis is used to search for a word or part of a word.
13364 When searching the cursor is put on the first occurrence appearing
13365 after the location of the cursor.  The search will wrap to the
13366 beginning of the signature when it no longer finds matches in the
13367 remainder of the signature.
13368
13369 To search for the same string a second time, press
13370 <!--chtml if pinemode="function_key"-->
13371 &quot;F6&quot;
13372 <!--chtml else-->
13373 &quot;^W&quot;
13374 <!--chtml endif-->
13375 to begin search and then just press RETURN to accept the previous
13376 search string shown in square brackets rather than entering a new
13377 search string.<P>
13378
13379 The &quot;Search&quot; prompt has several sub-command available:
13380
13381 <DL>
13382 <DT>Get Help</DT>
13383 <DD> Takes you to this help page.
13384
13385 <DT>Cancel</DT>
13386 <DD> Cancels the prompt.  No search takes place.
13387
13388 <DT>First Line</DT>
13389 <DD> Takes you back to the composer with the cursor on the first character
13390 of the first line of text.
13391
13392 <DT>Last Line</DT>
13393 <DD> Takes you back to the composer with the cursor on the last character
13394 of the last line of text.
13395
13396 <DT>Replace (Optional)</DT>
13397 <DD> This sub-command is enabled by the
13398 <A HREF="h_config_enable_search_and_repl">&quot;<!--#echo var="FEAT_enable-search-and-replace"-->&quot;</A>
13399 feature (which is on by default); see its help screen for details on how replacing works.
13400
13401 </DL>
13402
13403 &lt;End of help on this topic&gt;
13404 </BODY>
13405 </HTML>
13406 ======= h_composer_to ====
13407 <HTML>
13408 <HEAD>
13409 <TITLE>THE MESSAGE COMPOSER'S TO FIELD</TITLE>
13410 </HEAD>
13411 <BODY>
13412 <H1>THE MESSAGE COMPOSER'S TO FIELD</H1>
13413
13414 <H2>The &quot;To:&quot; field</H2>
13415 The address you enter here must be a valid email address that is reachable
13416 from your site.
13417
13418 <H2>Email Address Format</H2>
13419 You may enter a full name and email address,
13420 <!--chtml if pinemode="os_windows"-->
13421 <!--chtml else-->
13422 a local (meaning, on the same
13423 host as the one you are running Alpine on) username that Alpine will
13424 complete for you,
13425 <!--chtml endif-->
13426 the nickname of someone in a
13427 <A HREF="h_abook_opened">Alpine Address Book</A>, or a local
13428 mail alias defined by your system administrator.  When you move the cursor
13429 out of this field, the nicknames will be expanded to the addresses in your
13430 address book, and the local usernames will be expanded to include the
13431 persons' actual names.  You may enter as many addresses as you wish, but they
13432 must be separated by commas.  You can move around this and other header fields
13433 with the arrow keys and use many of the usual composer editing keys.
13434 <P>
13435 <UL>
13436 <LI><A HREF="h_address_format">Explanation of Address formats</A>
13437 </UL>
13438
13439 <P>
13440 <H2>MESSAGE HEADER COMMANDS</H2>
13441 <!--chtml if pinemode="function_key"-->
13442 CURSOR&nbsp;MOTION&nbsp;KEYS----------------------|EDITING&nbsp;KEYS-------------------------<BR>
13443 ^B&nbsp;(Left&nbsp;Arrow)&nbsp;&nbsp;&nbsp;&nbsp;Back&nbsp;character&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;^D&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Delete&nbsp;current&nbsp;character<BR>
13444 ^F&nbsp;(Right&nbsp;Arrow)&nbsp;&nbsp;&nbsp;Forward&nbsp;character&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;^H&nbsp;(DEL)&nbsp;Delete&nbsp;previous&nbsp;character<BR>
13445 ^P&nbsp;(Up&nbsp;Arrow)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Previous&nbsp;line&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|<BR>
13446 ^N&nbsp;(Down&nbsp;Arrow)&nbsp;&nbsp;&nbsp;&nbsp;Next&nbsp;line&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;F9&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Cut&nbsp;marked&nbsp;text&nbsp;or<BR>
13447 ^A&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Beginning&nbsp;of&nbsp;line&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;delete&nbsp;current&nbsp;line<BR>
13448 ^E&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;End&nbsp;of&nbsp;line&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;F10&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Undelete&nbsp;line(s)<BR>
13449 F7&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Previous&nbsp;page&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;^W&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="h_composer_search">Whereis</A>&nbsp;(search&nbsp;text)<BR>
13450 F8&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Next&nbsp;page&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|-------------------------------------<BR>
13451 ^@&nbsp;(Ctrl-SPACE)&nbsp;&nbsp;&nbsp;&nbsp;Next&nbsp;word&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|SCREEN/COMPOSITION&nbsp;COMMANDS<BR>
13452 ----------------------------------------|<BR>
13453 MESSAGE&nbsp;COMMANDS&nbsp;&nbsp;|&nbsp;GENERAL&nbsp;COMMANDS&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;F12&nbsp;&nbsp;&nbsp;&nbsp;To&nbsp;Addressbook/Browser<BR>
13454 F3&nbsp;&nbsp;&nbsp;<A HREF="h_compose_cancel">Cancel</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;F1&nbsp;&nbsp;&nbsp;&nbsp;Get&nbsp;help&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;F4&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Attach&nbsp;File<BR>
13455 F11&nbsp;&nbsp;<A HREF="h_common_postpone">Postpone</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;^Z&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="h_common_suspend">Suspend</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;^L&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Redraw&nbsp;Screen<BR>
13456 F2&nbsp;&nbsp;&nbsp;<A HREF="h_compose_send">Send</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;F5&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="h_compose_richhdr">Rich&nbsp;Headers</A><BR>
13457 <!--chtml else-->
13458 CURSOR&nbsp;MOTION&nbsp;KEYS----------------------|EDITING&nbsp;KEYS-------------------------<BR>
13459 ^B&nbsp;(Left&nbsp;Arrow)&nbsp;&nbsp;&nbsp;&nbsp;Back&nbsp;character&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;^D&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Delete&nbsp;current&nbsp;character<BR>
13460 ^F&nbsp;(Right&nbsp;Arrow)&nbsp;&nbsp;&nbsp;Forward&nbsp;character&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;^H&nbsp;(DEL)&nbsp;Delete&nbsp;previous&nbsp;character<BR>
13461 ^P&nbsp;(Up&nbsp;Arrow)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Previous&nbsp;line&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;<BR>
13462 ^N&nbsp;(Down&nbsp;Arrow)&nbsp;&nbsp;&nbsp;&nbsp;Next&nbsp;line&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;^K&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Cut&nbsp;marked&nbsp;text&nbsp;or<BR>
13463 ^A&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Beginning&nbsp;of&nbsp;line&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;delete&nbsp;current&nbsp;line<BR>
13464 ^E&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;End&nbsp;of&nbsp;line&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;^U&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Undelete&nbsp;line(s)<BR>
13465 ^Y&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Previous&nbsp;page&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|<BR>
13466 ^V&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Next&nbsp;page&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|-------------------------------------<BR>
13467 ^@&nbsp;(Ctrl-SPACE)&nbsp;&nbsp;&nbsp;&nbsp;Next&nbsp;word&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|SCREEN/COMPOSITION&nbsp;COMMANDS<BR>
13468 ----------------------------------------|&nbsp;^R&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="h_compose_richhdr">Rich&nbsp;Headers</A><BR>
13469 MESSAGE&nbsp;COMMANDS&nbsp;&nbsp;|&nbsp;GENERAL&nbsp;COMMANDS&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;^T&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;To&nbsp;Addressbook/Browser<BR>
13470 ^C&nbsp;&nbsp;&nbsp;<A HREF="h_compose_cancel">Cancel</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;^G&nbsp;&nbsp;&nbsp;&nbsp;Get&nbsp;help&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;^J&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Attach&nbsp;File<BR>
13471 ^O&nbsp;&nbsp;&nbsp;<A HREF="h_common_postpone">Postpone</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;^Z&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="h_common_suspend">Suspend</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;^L&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Redraw&nbsp;Screen<BR>
13472 ^X&nbsp;&nbsp;&nbsp;<A HREF="h_compose_send">Send</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;TAB&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="h_compose_addrcomplete">Address&nbsp;Completion</A><BR>
13473 <!--chtml endif-->
13474
13475 <P>
13476 NOTE:
13477 <OL>
13478  <LI>For help on a particular command, highlight the bold text associated
13479 with it above and hit Return.
13480  <LI> The availability of certain commands
13481 is determined by Alpine configuration files and system capabilities.
13482 At some sites, certain commands may not be available due to security or
13483 support concerns.
13484 </OL>
13485
13486 <P>
13487 <UL>
13488 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
13489 </UL><P>
13490 &lt;End of help on this topic&gt;
13491 </BODY>
13492 </HTML>
13493 ======= h_composer_cc ====
13494 <HTML>
13495 <HEAD>
13496 <TITLE>THE MESSAGE COMPOSER'S CC FIELD</TITLE>
13497 </HEAD>
13498 <BODY>
13499 <H1>THE MESSAGE COMPOSER'S CC FIELD</H1>
13500 The Cc: field is just like the To: field, except it is used for addressees
13501 that you wish to send a &quot;carbon&quot; copy to.  That is, the message is
13502 not directly meant directly &quot;for&quot; these recipients, but you wanted
13503 them to see the message.  The only difference the recipients see is that their
13504 name is in the Cc: field, rather than the To: field.
13505 <P>
13506 For help with Cc: field editing
13507 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
13508 <P>
13509 <UL>
13510 <LI><A HREF="h_address_format">Explanation of Address formats</A>
13511 </UL>
13512 <P>
13513 <UL>
13514 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
13515 </UL><P>
13516 &lt;End of help on this topic&gt;
13517 </BODY>
13518 </HTML>
13519 ======= h_composer_bcc ====
13520 <HTML>
13521 <HEAD>
13522 <TITLE>THE MESSAGE COMPOSER'S BCC FIELD</TITLE>
13523 </HEAD>
13524 <BODY>
13525 <H1>THE MESSAGE COMPOSER'S BCC FIELD</H1>
13526 The &quot;Bcc:&quot; (Blind carbon copy) header is used when you wish to send
13527 a copy of the message to one or more people whose addresses you do not
13528 wish disclosed, either to reduce clutter or for confidentiality.
13529 <P>
13530 The format of the Bcc: field is just the same as the To: and Cc: fields in
13531 the way the addresses are entered.  The recipients listed here will
13532 receive a copy of the message, but --assuming your site's mail transport
13533 software is properly configured-- their addresses will not show up in the
13534 headers of the message, as delivered to all of the recipients.  The To:
13535 and Cc:  recipients will not know a copy was sent to the Bcc: recipients.
13536 <P>
13537 Note: if there is no To: or Cc: or Lcc: address in the message, Alpine
13538 will automatically generate and place in the To: field a pseudo-address of
13539   &quot;undisclosed-recipients: ;&quot;
13540 or whatever string has been specified in the
13541 <A HREF="h_config_empty_hdr_msg">&quot;<!--#echo var="VAR_empty-header-message"-->&quot;</A>
13542 variable.
13543 <P>
13544 The reason for this is to avoid embarrassment caused by some Internet
13545 mail transfer software that interprets a &quot;missing&quot; To: header as
13546 an error and replaces it with an Apparently-to: header that may contain
13547 the addresses you entered on the Bcc: line.  In addition, it may be
13548 less disconcerting to Bcc: recipients to see <B>something</B> in the To: field.
13549 <P>
13550 You can manipulate what text ends up on the (originally) empty To:
13551 field.  Just remember to put a colon and semicolon at the end of the
13552 field, which is a special notation denoting that it is not a real address.
13553 <P>
13554 For information on message header editing
13555 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
13556 <P>
13557 <UL>
13558 <LI><A HREF="h_address_format">Explanation of Address formats</A>
13559 </UL>
13560 <P>
13561 <UL>
13562 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
13563 </UL><P>
13564 &lt;End of help on this topic&gt;
13565 </BODY>
13566 </HTML>
13567 ======= h_composer_lcc ====
13568 <HTML>
13569 <HEAD>
13570 <TITLE>THE MESSAGE COMPOSER'S LCC FIELD</TITLE>
13571 </HEAD>
13572 <BODY>
13573 <H1>THE MESSAGE COMPOSER'S LCC FIELD</H1>
13574 The &quot;Lcc:&quot; (List carbon copy) header is intended to be used when
13575 you wish to send a message to a list of people but avoid having all
13576 of their addresses visible, in order to reduce clutter when the
13577 message is received.
13578 <P>
13579 It is similar to the
13580 <A HREF="h_composer_bcc">&quot;Bcc&quot; (Blind carbon copy) header</A>
13581 in that individual
13582 addressees are hidden, but Lcc is designed to work specifically with
13583 distribution lists you have created in your
13584 <A HREF="h_abook_opened">Alpine Address Book</A>.  Placing
13585 the nickname of the list on the Lcc line will result in the full name of
13586 your Alpine Address Book list being placed on the To: line of the message,
13587 using a special notation that distinguishes it from a real address. You
13588 must leave the To: line blank for your list name to appear there.
13589 <P>
13590 For example, if you have this list entered in your Address Book:<PRE>
13591
13592         largo         Key Largo List       DISTRIBUTION LIST:
13593                                            bogie@mgm.com
13594                                            lauren@mgm.com
13595                                            walter@mgm.com</PRE>
13596
13597
13598 and you enter &quot;largo&quot; on the Lcc: line while composing a message,
13599 the result is:<PRE>
13600
13601         To      : Key Largo List: ;
13602         Cc      :
13603         Bcc     :
13604         Fcc     : sent-mail
13605         Lcc     : Key Largo List &lt;bogie@mgm.com&gt;,
13606                   lauren@mgm.com,
13607                   walter@mgm.com
13608         Subject :</PRE>
13609
13610 Each recipient listed on the Lcc: line receives a copy of the message
13611 without their address being visible (as though they were listed on the
13612 Bcc: line). The colon-semicolon notation used to put the full-name of the
13613 list on the To: line is a special address format that doesn't specify any
13614 actual addressees, but does give some information to the recipients of the
13615 message.
13616 <P>
13617 Note: if after entering an LCC, you delete the list name that is placed
13618 on the To: line, then recipients will see <PRE>
13619        To: undisclosed-recipients: ;</PRE>
13620
13621 (or whatever string is defined in the
13622 <A HREF="h_config_empty_hdr_msg">&quot;<!--#echo var="VAR_empty-header-message"-->&quot;</A>
13623 variable) just as in the BCC case.
13624 <P>
13625 For help with Lcc: field editing
13626 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
13627 <P>
13628 <UL>
13629 <LI><A HREF="h_address_format">Explanation of Address formats</A>
13630 </UL>
13631 <P>
13632 <UL>
13633 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
13634 </UL><P>
13635 &lt;End of help on this topic&gt;
13636 </BODY>
13637 </HTML>
13638 ======= h_composer_from =======
13639 <HTML>
13640 <HEAD>
13641 <TITLE>THE MESSAGE COMPOSER'S FROM FIELD</TITLE>
13642 </HEAD>
13643 <BODY>
13644 <H1>THE MESSAGE COMPOSER'S FROM FIELD</H1>
13645
13646 This header carries your return address.  It is the address toward which
13647 replies (and often, future unrelated correspondence) will be directed,
13648 unless you have <A HREF="h_config_custom_hdrs">defined an optional
13649 &quot;Reply-To:&quot; header</A> in the SETUP CONFIGURATION screen.  Make
13650 sure this address is correct.
13651 <P>
13652 For help with message header editing
13653 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
13654 <P>
13655 <UL>
13656 <LI><A HREF="h_address_format">Explanation of Address formats</A>
13657 </UL>
13658 <P>
13659 <UL>
13660 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
13661 </UL><P>
13662 &lt;End of help on this topic&gt;
13663 </BODY>
13664 </HTML>
13665 ======= h_composer_reply_to =======
13666 <HTML>
13667 <HEAD>
13668 <TITLE>THE MESSAGE COMPOSER'S REPLY-TO FIELD</TITLE>
13669 </HEAD>
13670 <BODY>
13671 <H1>THE MESSAGE COMPOSER'S REPLY-TO FIELD</H1>
13672
13673 Most people should not need this header. The Reply-To: header is used in
13674 cases where you would like replies to your messages to be directed to an
13675 address other than your normal &quot;From:&quot; address.  This is atypical,
13676 but can happen when you use multiple machines and do not have the same account
13677 name on each one, or when you wish to direct certain replies to accounts
13678 or folders designated for specific classes of correspondence.
13679 <P>
13680 For help with message header editing
13681 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
13682 <P>
13683 <UL>
13684 <LI><A HREF="h_address_format">Explanation of Address formats</A>
13685 </UL>
13686
13687 <P>
13688 <UL>
13689 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
13690 </UL><P>
13691 &lt;End of help on this topic&gt;
13692 </BODY>
13693 </HTML>
13694 ======= h_composer_custom_addr ====
13695 <HTML>
13696 <HEAD>
13697 <TITLE>CUSTOMIZED HEADER FIELD</TITLE>
13698 </HEAD>
13699 <BODY>
13700 <H1>CUSTOMIZED HEADER FIELD</H1>
13701 This is a customized header, i.e. not one that is part of Alpine's normal
13702 set of Compose headers.
13703 <P>
13704 For help with message header editing
13705 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
13706 <P>
13707 <UL>
13708 <LI><A HREF="h_address_format">Explanation of Address formats</A>
13709 </UL>
13710 <P>
13711 <UL>
13712 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
13713 </UL><P>
13714 &lt;End of help on this topic&gt;
13715 </BODY>
13716 </HTML>
13717 ======= h_composer_custom_free ====
13718 <HTML>
13719 <HEAD>
13720 <TITLE>CUSTOMIZED HEADER FIELD</TITLE>
13721 </HEAD>
13722 <BODY>
13723 <H1>CUSTOMIZED HEADER FIELD</H1>
13724 This is a customized header, i.e. not one that is part of Alpine's normal
13725 set of Compose headers.
13726 <P>
13727 This field consists of arbitrary text.
13728 <P>
13729 For help with message header editing
13730 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
13731 <P>
13732 <UL>
13733 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
13734 </UL><P>
13735 &lt;End of help on this topic&gt;
13736 </BODY>
13737 </HTML>
13738 ====== h_composer_news =====
13739 <HTML>
13740 <HEAD>
13741 <TITLE>THE MESSAGE COMPOSER'S NEWSGRPS LINE</TITLE>
13742 </HEAD>
13743 <BODY>
13744 <h1>THE MESSAGE COMPOSER'S NEWSGRPS LINE</h1>
13745 Use the newsgroups line to specify any and all USENET newsgroups to which
13746 your message should be posted.  When composing a message from scratch, this
13747 line may be hidden.  If so, just press the rich headers command
13748 (<!--chtml if pinemode="function_key"-->F5<!--chtml else-->^R<!--chtml endif-->)
13749 to make it visible.
13750 <P>
13751 <EM>Be aware</EM> that when you post to a newsgroup thousands of
13752 people will be reading your message.  Also, you or your system manager
13753 must have defined an &quot;<!--#echo var="VAR_nntp-server"-->&quot; in your Alpine configuration
13754 in order for you to be able to post.
13755 <P>
13756 For help with message header editing
13757 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
13758 <P><UL>
13759 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
13760 </UL>
13761 <P>
13762 &lt;End of help on this topic&gt;
13763 </BODY>
13764 </HTML>
13765 ======= h_composer_fcc ====
13766 <HTML>
13767 <HEADER>
13768 <TITLE>THE MESSAGE COMPOSER'S FCC FIELD</TITLE>
13769 </HEADER>
13770 <BODY>
13771 <H1>THE MESSAGE COMPOSER'S FCC FIELD</H1>
13772 The FCC (File Carbon Copy) specifies the folder used to keep a copy of
13773 each outgoing message.  The default value can be configured with the
13774 &quot;<!--#echo var="VAR_default-fcc"-->&quot; and &quot;<!--#echo var="VAR_fcc-name-rule"-->&quot; options.  You can change or remove
13775 the file carbon copy on any message you send by editing the FCC header.<p>
13776
13777 You may type ^T to get a list of all your folders and select one to use as
13778 the FCC for this message.<P>
13779
13780 For help with message header editing
13781 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
13782 <P>
13783 <UL>
13784 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
13785 </UL><P>
13786 &lt;End of help on this topic&gt;
13787 </BODY>
13788 </HTML>
13789 ======= h_composer_subject ====
13790 <HTML>
13791 <HEADER>
13792 <TITLE>THE MESSAGE COMPOSER'S SUBJECT FIELD</TITLE>
13793 </HEADER>
13794 <BODY>
13795 <H1>THE MESSAGE COMPOSER'S SUBJECT FIELD</H1>
13796
13797 The subject header provides a place to enter a few words that summarize
13798 the topic of the message you are sending.  You may leave this line blank,
13799 but it is considered a courtesy to use a meaningful subject.<p>
13800
13801 For help with message header editing
13802 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
13803 <P>
13804 <UL>
13805 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
13806 </UL><P>
13807 &lt;End of help on this topic&gt;
13808 </BODY>
13809 </HTML>
13810 ======= h_composer_attachment ====
13811 <HTML>
13812 <HEAD>
13813 <TITLE>THE MESSAGE COMPOSER'S ATTCHMNT FIELD</TITLE>
13814 </HEAD>
13815 <BODY>
13816 <H1>THE MESSAGE COMPOSER'S ATTCHMNT FIELD</H1>
13817
13818 The &quot;Attchmnt:&quot; field is where you specify what file or
13819 files you'd like attached to
13820 the message you are composing.  Those files must reside on the machine
13821 running Alpine. If your file is on a PC or Mac and you run Alpine with an
13822 account on a Unix machine, you'll have to transfer it before attaching it.
13823 Contact local computer support people for assistance with transferring.
13824
13825 <P>
13826 The file name
13827 given can be an absolute file path name for your system
13828 <!--chtml if pinemode="os_windows"-->
13829 (for example, &quot;H:&#92;SIGFILES&#92;FULLINFO.TXT&quot;), a file
13830 with a relative pathname, or simply a file name without
13831 drive or directory specification.
13832 <!--chtml else-->
13833 (for example, &quot;/tmp/exported.earlier&quot; on Unix hosts),
13834 a file in your home directory, or a file path relative to your
13835 home directory.  In Unix Alpine, you may use &quot;~&quot; to refer to
13836 your home directory or &quot;~user&quot; to refer to another
13837 account's home directory.
13838 <!--chtml endif--><P>
13839 No wild card characters may be used.
13840 <P>If the
13841 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
13842 feature is set, names are relative to your current working directory
13843 <!--chtml if pinemode="running"-->
13844 (which, at least for your current Alpine &quot;session,&quot;
13845 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
13846 <!--chtml endif-->
13847 rather than your home directory
13848 <!--chtml if pinemode="running"-->
13849 (which, in the present configuration of your system, is
13850  &quot;<!--#echo var="HOME_DIR"-->&quot;)
13851 <!--chtml endif-->
13852 .
13853 <P>
13854 Alpine uses MIME encoding for attachments, so binaries and files of any
13855 length can safely be delivered to any MIME-capable mail reading program.
13856 If you send an attachment to someone who does not have a MIME-capable mail
13857 reading program yet, then the main message text will be readable, but
13858 attachments (even attachments that are just plain text) are not.
13859 <P>
13860
13861 Typing the filename on the Attchmnt: line achieves the same
13862 result as using the
13863 <!--chtml if pinemode="function_key"-->
13864 F6
13865 <!--chtml else-->
13866 Ctrl-J
13867 <!--chtml endif--> command.
13868 <P>
13869
13870 If you Forward a message with attachments, you may delete them from your
13871 Forwarded message by editing the Attchmnt header line.
13872 <P>
13873
13874 For help with message header editing
13875 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
13876 <P>
13877 <UL>
13878 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
13879 </UL><P>
13880 &lt;End of help on this topic&gt;
13881 </BODY>
13882 </HTML>
13883 ======= h_composer_ctrl_j ====
13884 <HTML>
13885 <HEAD>
13886 <TITLE>COMPOSER ATTACH</TITLE>
13887 </HEAD>
13888 <BODY>
13889 After the
13890 <!--chtml if pinemode="function_key"-->
13891 F6
13892 <!--chtml else-->
13893 Ctrl-J
13894 <!--chtml endif--> command:
13895 At the &quot;File to attach:&quot; prompt, enter the name of the
13896 existing file to attach to your message.
13897 When the feature
13898 <A HREF="h_config_enable_tab_complete">&quot;<!--#echo var="FEAT_enable-tab-completion"-->&quot;</A>
13899 is set
13900 you need only enter the beginning of the filename (enough of it to uniquely
13901 identify the file) and press TAB to complete it.
13902
13903 Or, press ^T to use the BROWSER screen for
13904 selecting the file.  <P>
13905 For more information on attaching files, see the help screen for the
13906 composer's
13907 <A HREF="h_composer_attachment">Attchmnt: field</A>, which is normally hidden,
13908 but can be revealed using the
13909 <!--chtml if pinemode="function_key"-->
13910 F5
13911 <!--chtml else-->
13912 Ctrl-R
13913 <!--chtml endif-->
13914 command with the cursor positioned above the
13915 &quot;----- Message Text -----&quot; line in the COMPOSE MESSAGE screen.
13916 <P>
13917 &lt;End of help on this topic&gt;
13918 </BODY>
13919 </HTML>
13920 ======= h_edit_nav_cmds =========
13921 <HTML>
13922 <HEAD>
13923 <TITLE>Composer Editing Commands Explained</TITLE>
13924 </HEAD>
13925 <BODY>
13926 <H1>EDITING and NAVIGATION COMMANDS</H1>
13927 <!--chtml if pinemode="function_key"-->
13928 <PRE>
13929 CURSOR MOTION KEYS----------------------|EDITING KEYS-------------------------
13930 ^B (Left Arrow)    Back character       | ^D       Delete current character
13931 ^F (Right Arrow)   Forward character    | ^H (DEL) Delete previous character
13932 ^P (Up Arrow)      Previous line        |
13933 ^N (Down Arrow)    Next line            | F9       Cut marked text or
13934 ^A                 Beginning of line    |            delete current line
13935 ^E                 End of line          | F10      Undelete line(s)
13936 F7                 Previous page        |
13937 F8                 Next page            |-------------------------------------
13938 ^@ (Ctrl-SPACE)    Next word            | MISCELLANEOUS COMMANDS
13939 ----------------------------------------|
13940 EXIT COMMANDS    |  GENERAL COMMANDS    | F12    To Addressbook
13941 F3   Cancel      |   F1    Get help     | F12    RichView (expand lists)
13942 F2  eXit/save    |   ^Z    Suspend      | ^L     Redraw Screen
13943 </PRE>
13944 <!--chtml else-->
13945 <PRE>
13946 CURSOR MOTION KEYS----------------------|EDITING KEYS-------------------------
13947 ^B (Left Arrow)    Back character       | ^D       Delete current character
13948 ^F (Right Arrow)   Forward character    | ^H (DEL) Delete previous character
13949 ^P (Up Arrow)      Previous line        |
13950 ^N (Down Arrow)    Next line            | ^K       Cut marked text or
13951 ^A                 Beginning of line    |            delete current line
13952 ^E                 End of line          | ^U       Undelete line(s)
13953 ^Y                 Previous page        |
13954 ^V                 Next page            |-------------------------------------
13955 ^@ (Ctrl-SPACE)    Next word            | MISCELLANEOUS COMMANDS
13956 ----------------------------------------|
13957 EXIT COMMANDS    |  GENERAL COMMANDS    | ^T     To Addressbook
13958 ^C   Cancel      |   ^G    Get help     | ^R     RichView  (expand lists)
13959 ^X   eXit/save   |   ^Z    Suspend      | ^L     Redraw Screen
13960 </PRE>
13961 <!--chtml endif-->
13962 &lt;End of help on this topic&gt;
13963 </BODY>
13964 </HTML>
13965 ===== h_composer_sigedit =====
13966 <HTML>
13967 <HEAD>
13968 <TITLE>Signature Editor Commands Explained</TITLE>
13969 </HEAD>
13970 <BODY>
13971 <H1>SIGNATURE EDITOR COMMANDS</H1>
13972 <!--chtml if pinemode="function_key"-->
13973 <PRE>
13974 CURSOR MOTION KEYS                     |EDITING KEYS
13975   ^B (Left Arrow)   Back character     | ^D       Delete current character
13976   ^F (Right Arrow)  Forward character  | ^H (DEL) Delete previous character
13977   ^P (Up Arrow)     Previous line      | ^^       Set a mark
13978   ^N (Down Arrow)   Next line          | F9       Cut marked text or
13979   ^A                Beginning of line  |           delete current line
13980   ^E                End of line        | F10       Paste text, undelete lines
13981   F7                Previous page      |           cut with ^K, or unjustify
13982   F8                Next page          |-------------------------------------
13983   ^@ (Ctrl-SPACE)   Next word          |SCREEN/COMPOSITION COMMANDS
13984 ---------------------------------------| F6       Whereis (search for string)
13985 MESSAGE COMMANDS | GENERAL COMMANDS    | F12      Spell checker
13986  F3   Cancel     |  F1    Get help     | F4       Justify paragraph
13987                  |  ^Z    Suspend      | ^L       Redraw Screen
13988  F2   Send       |  F6    Alt. editor  | F5       Read in a file
13989 </PRE>
13990 <!--chtml else-->
13991 <PRE>
13992 CURSOR MOTION KEYS                     |EDITING KEYS
13993   ^B (Left Arrow)   Back character     | ^D       Delete current character
13994   ^F (Right Arrow)  Forward character  | ^H (DEL) Delete previous character
13995   ^P (Up Arrow)     Previous line      | ^^       Set a mark
13996   ^N (Down Arrow)   Next line          | ^K       Cut marked text or
13997   ^A                Beginning of line  |           delete current line
13998   ^E                End of line        | ^U        Paste text, undelete lines
13999   ^Y                Previous page      |           cut with ^K, or unjustify
14000   ^V                Next page          |-------------------------------------
14001   ^@ (Ctrl-SPACE)   Next word          |SCREEN/COMPOSITION COMMANDS
14002 ---------------------------------------| ^W       <A HREF="h_composer_search">Whereis</A> (search text)
14003 MESSAGE COMMANDS | GENERAL COMMANDS    | ^T       Spell checker
14004  ^C   Cancel     |  ^G    Get help     | ^J       <A HREF="h_compose_justify">Justify</A> paragraph
14005                  |  ^Z    <A HREF="h_common_suspend">Suspend</A>      | ^L       Redraw Screen
14006  ^X   Send       |  ^_    Alt. editor  | ^R       Read in a file
14007 </PRE>
14008 <!--chtml endif-->
14009
14010 NOTE: The presence or absence of the following commands is determined
14011 by &quot;Feature-List&quot; options in your Alpine configuration.  Also,
14012 some of these commands may be administratively disabled by your system
14013 manager; if they don't work, please check with your local help desk
14014 before reporting a bug.
14015 <P>
14016 <UL>
14017  <LI>Suspend (suspends Alpine and gives a system prompt)
14018  <LI>Alternate editor (allows you to compose with your own editor)
14019 </UL>
14020 <P>
14021
14022 Alpine does not use the following keys:  Ctrl-S, Ctrl-Q, Ctrl-],
14023 Ctrl-&#92;, ESC
14024 <P>
14025
14026 NOTE: For special handling of Ctrl-S and Ctrl-Q see special comments regarding
14027 <A HREF="h_special_xon_xoff">&quot;XOFF/XON&quot;</A>.
14028 <P>
14029 &lt;End of help on this topic&gt;
14030 </BODY>
14031 </HTML>
14032 ===== h_composer_commentedit =====
14033 <HTML>
14034 <HEAD>
14035 <TITLE>Comment Editor Commands Explained</TITLE>
14036 </HEAD>
14037 <BODY>
14038 <H1>COMMENT EDITOR COMMANDS</H1>
14039 <!--chtml if pinemode="function_key"-->
14040 <PRE>
14041 CURSOR MOTION KEYS                     |EDITING KEYS
14042   ^B (Left Arrow)   Back character     | ^D       Delete current character
14043   ^F (Right Arrow)  Forward character  | ^H (DEL) Delete previous character
14044   ^P (Up Arrow)     Previous line      | ^^       Set a mark
14045   ^N (Down Arrow)   Next line          | F9       Cut marked text or
14046   ^A                Beginning of line  |           delete current line
14047   ^E                End of line        | F10       Paste text, undelete lines
14048   F7                Previous page      |           cut with ^K, or unjustify
14049   F8                Next page          |-------------------------------------
14050   ^@ (Ctrl-SPACE)   Next word          |SCREEN/COMPOSITION COMMANDS
14051 ---------------------------------------| F6       Whereis (search for string)
14052 MESSAGE COMMANDS | GENERAL COMMANDS    | F12      Spell checker
14053  F3   Cancel     |  F1    Get help     | F4       Justify paragraph
14054                  |  ^Z    Suspend      | ^L       Redraw Screen
14055  F2   Send       |  F6    Alt. editor  | F5       Read in a file
14056 </PRE>
14057 <!--chtml else-->
14058 <PRE>
14059 CURSOR MOTION KEYS                     |EDITING KEYS
14060   ^B (Left Arrow)   Back character     | ^D       Delete current character
14061   ^F (Right Arrow)  Forward character  | ^H (DEL) Delete previous character
14062   ^P (Up Arrow)     Previous line      | ^^       Set a mark
14063   ^N (Down Arrow)   Next line          | ^K       Cut marked text or
14064   ^A                Beginning of line  |           delete current line
14065   ^E                End of line        | ^U        Paste text, undelete lines
14066   ^Y                Previous page      |           cut with ^K, or unjustify
14067   ^V                Next page          |-------------------------------------
14068   ^@ (Ctrl-SPACE)   Next word          |SCREEN/COMPOSITION COMMANDS
14069 ---------------------------------------| ^W       <A HREF="h_composer_search">Whereis</A> (search text)
14070 MESSAGE COMMANDS | GENERAL COMMANDS    | ^T       Spell checker
14071  ^C   Cancel     |  ^G    Get help     | ^J       <A HREF="h_compose_justify">Justify</A> paragraph
14072                  |  ^Z    <A HREF="h_common_suspend">Suspend</A>      | ^L       Redraw Screen
14073  ^X   Send       |  ^_    Alt. editor  | ^R       Read in a file
14074 </PRE>
14075 <!--chtml endif-->
14076
14077 NOTE: The presence or absence of the following commands is determined
14078 by &quot;Feature-List&quot; options in your Alpine configuration.  Also,
14079 some of these commands may be administratively disabled by your system
14080 manager; if they don't work, please check with your local help desk
14081 before reporting a bug.
14082 <P>
14083 <UL>
14084  <LI>Suspend (suspends Alpine and gives a system prompt)
14085  <LI>Alternate editor (allows you to compose with your own editor)
14086 </UL>
14087 <P>
14088
14089 Alpine does not use the following keys:  Ctrl-S, Ctrl-Q, Ctrl-],
14090 Ctrl-&#92;, ESC
14091 <P>
14092
14093 NOTE: For special handling of Ctrl-S and Ctrl-Q see special comments regarding
14094 <A HREF="h_special_xon_xoff">&quot;XOFF/XON&quot;</A>.
14095 <P>
14096 &lt;End of help on this topic&gt;
14097 </BODY>
14098 </HTML>
14099 ======= h_composer_abook_nick =======
14100 <HTML>
14101 <HEAD>
14102 <TITLE>Addressbook Nickname Explained</TITLE>
14103 </HEAD>
14104 <BODY>
14105 This is a short nickname for this address book entry.  If it is used in
14106 place of an address from the composer, the composer will fill in the
14107 address(es) for the entry that matches the nickname.
14108 <P>
14109
14110 Look <A HREF="h_edit_nav_cmds">here</A>
14111 to see the available Editing and Navigation commands.
14112 <P>
14113 &lt;End of help on this topic&gt;
14114 </BODY>
14115 </HTML>
14116 ======= h_composer_abook_full =======
14117 <HTML>
14118 <HEAD>
14119 <TITLE>Addressbook Fullname Explained</TITLE>
14120 </HEAD>
14121 <BODY>
14122 This is the full name field for this entry.  If this is going to be a
14123 distribution list (more than one address), it should be a descriptive
14124 phrase describing the list.  It will be included in the mail header if you
14125 put the list in the To: or CC: field, or in the To: line if you put the
14126 list in the Lcc: field.  It's OK to leave this field blank (and OK to
14127 leave any of the other fields blank, too). If this address book entry is
14128 going to be a simple entry with just one address, then this field is the
14129 person's name. When you send mail to this entry, this is the field to the
14130 left of the brackets. That is, it is the most readable part of the
14131 address. For example, in the sample address:
14132 <PRE>
14133        John Doe &lt;jdoe@some.domain&gt;
14134 </PRE>
14135 "John Doe" is the full name field. If you are sorting your address book
14136 with one of the options that uses full names, then it might be useful to
14137 enter the full name as "Last, First", for example:
14138 <PRE>
14139        Doe, John
14140 </PRE>
14141 so that it will be sorted using Doe instead of John. This will be changed
14142 back into John Doe when you use it.
14143 <P>
14144 Look <A HREF="h_edit_nav_cmds">here</A>
14145 to see the available Editing and Navigation commands.
14146 <P>
14147 &lt;End of help on this topic&gt;
14148 </BODY>
14149 </HTML>
14150 ======= h_composer_abook_fcc =======
14151 <HTML>
14152 <HEAD>
14153 <TITLE>Addressbook Fcc Explained</TITLE>
14154 </HEAD>
14155 <BODY>
14156 If this entry is the first one in the To: line of an outgoing message,
14157 this field will be used for the Fcc (File Carbon Copy) instead of whatever
14158 you would normally get (which depends on which
14159 <A HREF="h_config_saved_msg_name_rule">&quot;<!--#echo var="VAR_saved-msg-name-rule"-->&quot;</A>
14160 you've chosen).
14161 <P>
14162 If this field consists of two double quotes (&quot;&quot;) that tells Alpine
14163 that you don't want any Fcc associated with this entry.
14164 <P>
14165 Look <A HREF="h_edit_nav_cmds">here</A>
14166 to see the available Editing and Navigation commands.
14167 <P>
14168 &lt;End of help on this topic&gt;
14169 </BODY>
14170 </HTML>
14171 ====== h_config_combined_abook_display =====
14172 <HTML>
14173 <HEAD>
14174 <TITLE>FEATURE: <!--#echo var="FEAT_combined-addrbook-display"--></TITLE>
14175 </HEAD>
14176 <BODY>
14177 <H1>FEATURE: <!--#echo var="FEAT_combined-addrbook-display"--></H1>
14178
14179 This feature affects the address book display screens.
14180 Normally, expanding an address book from the ADDRESS BOOK LIST screen
14181 will cause the remaining address books and directory servers to disappear
14182 from the screen, leaving only the entries of the expanded address book.
14183 If this feature is set, then the other address books will remain on the screen,
14184 so that all of the address books can be present at once.
14185
14186 <P>
14187 The way that commands work won't be changed.
14188 For example, the Select All command will select all of the entries in the
14189 current address book, not all of the entries in all of the address books.
14190 The WhereIs command will change a little.
14191 It will search through all of the text on the screen plus all of the entries
14192 from expanded address books.
14193
14194 <P>
14195 When this feature is set, the setting of the feature
14196 <A HREF="h_config_expanded_addrbooks">&quot;<!--#echo var="FEAT_expanded-view-of-addressbooks"-->&quot;</A>
14197 has an effect.
14198 <P>
14199 &lt;End of help on this topic&gt;
14200 </BODY>
14201 </HTML>
14202 ====== h_config_titlebar_color_style =====
14203 <HTML>
14204 <HEAD>
14205 <TITLE>OPTION: <!--#echo var="VAR_titlebar-color-style"--></TITLE>
14206 </HEAD>
14207 <BODY>
14208 <H1>OPTION: <!--#echo var="VAR_titlebar-color-style"--></H1>
14209
14210 This option affects the colors used to display the titlebar (the top
14211 line on the screen) when viewing a message.
14212
14213 <P>
14214 The available options include:
14215 <P>
14216
14217 <DL>
14218 <DT>default</DT>
14219 <DD>The color of the titlebar will be the color you set for the
14220 <A HREF="h_config_title_color">Title Color</A>.
14221 The Title Color may be set by using the
14222 <A HREF="h_color_setup">Setup Kolor</A> screen.
14223 </DD>
14224
14225 <DT>indexline</DT>
14226 <DD>The color of the titlebar will be the same as the color of the
14227 index line corresponding to the message being viewed.
14228 The rules that determine what color the index line will be may be set
14229 up by going to the Setup/Rules/Indexcolor screen.
14230 If the index line for a message is not colored explicitly by the
14231 Indexcolor rules, then the titlebar will be colored the same as for
14232 the &quot;default&quot; option above (which is not the same color that
14233 the index line itself will have).
14234 </DD>
14235
14236 <DT>reverse-indexline</DT>
14237 <DD>This is similar to the &quot;indexline&quot; option except the
14238 foreground and background colors from the corresponding index line will
14239 be reversed.
14240 For example, if the index line color is red letters on a white background,
14241 then the titlebar will be white letters on a red background.
14242 If the index line for a message is not colored explicitly by the
14243 Indexcolor rules, then the titlebar will be colored the same as for
14244 the &quot;default&quot; option above (which is not the same color that
14245 the index line itself will have).
14246 </DD>
14247 </DL>
14248
14249 <P>
14250
14251 <UL>
14252 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14253 </UL><P>
14254 &lt;End of help on this topic&gt;
14255 </BODY>
14256 </HTML>
14257 ====== h_config_index_color_style =====
14258 <HTML>
14259 <HEAD>
14260 <TITLE>OPTION: <!--#echo var="VAR_current-indexline-style"--></TITLE>
14261 </HEAD>
14262 <BODY>
14263 <H1>OPTION: <!--#echo var="VAR_current-indexline-style"--></H1>
14264
14265 This option affects the colors used to display the current line in the
14266 MESSAGE INDEX screen.
14267 If you do not have Index Color Rules defined, then this option will
14268 have no effect in the index.
14269 Those Rules may be defined by going to the Setup/Rules/Indexcolor screen.
14270 <P>
14271 If the option
14272 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
14273 is turned on and the
14274 <A HREF="h_config_incunseen_color">Incoming Unseen Color</A>
14275 is set to something other than the default, then
14276 this option also affects the color used to display the current folder
14277 in the Incoming FOLDER LIST screen.
14278
14279 <P>
14280 The available options include:
14281 <P>
14282
14283 <DL>
14284 <DT>flip-colors</DT>
14285 <DD>This is the default.
14286 If an index line is colored because it matches one of your
14287 Index Color Rules, then its colors will be reversed when it is the currently
14288 highlighted line.
14289 For example, if the line is normally red text on a blue background, then
14290 when it is the current line it will be drawn as blue text on a red background.
14291 <P>
14292 The rest of the option values all revert to this flip-colors behavior if
14293 there is no Reverse Color defined.
14294 </DD>
14295
14296 <DT>reverse</DT>
14297 <DD>With this option the Reverse color is always used to highlight the
14298 current line.
14299 </DD>
14300
14301 <DT>reverse-fg</DT>
14302 <DD>The foreground part of the Reverse Color is used to highlight
14303 the current line.
14304 If this would cause the text to be unreadable (because the foreground and
14305 background colors are the same) or if it would cause no change in the
14306 color of the index line, then the colors are flipped instead.
14307 <P>
14308 Some people think this works particularly well if you use different
14309 background colors to emphasize &quot;interesting&quot; lines,
14310 but always with the same Normal foreground color,
14311 and you use a different foreground color for the Reverse Color.
14312 </DD>
14313
14314 <DT>reverse-fg-no-ambiguity</DT>
14315 <DD>With the &quot;reverse-fg&quot; rule above, it is possible that
14316 the resulting color will be exactly the same as the regular Reverse
14317 Color.
14318 That can lead to some possible confusion because an
14319 &quot;interesting&quot;
14320 line that is the current line will be displayed exactly the same as a
14321 non-interesting line that is current.
14322 You can't tell whether the line is just a regular current line or if it is
14323 an &quot;interesting&quot; current line by looking at the color.
14324 Setting the option to this value removes that ambiguity.
14325 It is the same as the &quot;reverse-fg&quot; setting unless the resulting
14326 interesting current line would look just like a non-interesting current line.
14327 In that case, the interesting line's colors are simply flipped (like in the
14328 default behavior).
14329 <P>
14330 As an alternative way to preserve the line's interestingness in this case,
14331 you may find that using both a different foreground and a different
14332 background color for the interesting line will help.
14333 </DD>
14334
14335 <DT>reverse-bg</DT>
14336 <DD>The background part of the Reverse Color is used to highlight
14337 the current line.
14338 If this would cause the text to be unreadable (because the foreground and
14339 background colors are the same) or if it would cause no change in the
14340 color of the index line, then the colors are flipped instead.
14341 <P>
14342 Some people think this works particularly well if you use different
14343 foreground colors to emphasize &quot;interesting&quot; lines,
14344 but always with the same Normal background color,
14345 and you use a different background color for the Reverse Color.
14346 </DD>
14347
14348 <DT>reverse-bg-no-ambiguity</DT>
14349 <DD>As with the &quot;reverse-fg&quot; case, the &quot;reverse-bg&quot;
14350 rule may also result in a color that is exactly the same as the regular
14351 Reverse Color.
14352 Setting the option to this value removes that ambiguity.
14353 It is the same as the &quot;reverse-bg&quot; setting unless the resulting
14354 current line has the same color as the Reverse Color.
14355 In that case, the interesting line's colors are simply flipped (like in the
14356 default behavior).
14357 </DD>
14358 </DL>
14359
14360 <P>
14361
14362 <UL>
14363 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14364 </UL><P>
14365 &lt;End of help on this topic&gt;
14366 </BODY>
14367 </HTML>
14368 ====== h_config_expanded_addrbooks =====
14369 <HTML>
14370 <HEAD>
14371 <TITLE>FEATURE: <!--#echo var="FEAT_expanded-view-of-addressbooks"--></TITLE>
14372 </HEAD>
14373 <BODY>
14374 <H1>FEATURE: <!--#echo var="FEAT_expanded-view-of-addressbooks"--></H1>
14375
14376 If multiple address books (either personal or global) are defined, and you
14377 wish to have them all expanded implicitly upon entering the ADDRESS BOOK
14378 screen, then set this feature. This feature will have no effect unless the
14379 feature
14380 <A HREF="h_config_combined_abook_display">&quot;<!--#echo var="FEAT_combined-addrbook-display"-->&quot;</A>
14381 is also set.
14382 <P>
14383 &lt;End of help on this topic&gt;
14384 </BODY>
14385 </HTML>
14386 ====== h_config_combined_folder_display =====
14387 <HTML>
14388 <HEAD>
14389 <TITLE>FEATURE: <!--#echo var="FEAT_combined-folder-display"--></TITLE>
14390 </HEAD>
14391 <BODY>
14392 <H1>FEATURE: <!--#echo var="FEAT_combined-folder-display"--></H1>
14393
14394 This feature affects the folder list display screens.
14395 Normally, each folder list is viewed within its collection only.  This
14396 command allows folder lists to be viewed within a single screen that
14397 combines the contents of all collections.
14398
14399 <P>
14400 The way that commands work won't be changed.
14401 For example, the Select All command will select all of the folders in the
14402 current collection, not all of the entries in all of the collections.
14403 The WhereIs command will change a little.
14404 It will search through all of the folders in the current collection as well
14405 as all the folder in any other expanded collection.
14406
14407 <P>
14408 When this feature is set, the setting of the feature
14409 <A HREF="h_config_expanded_folders">&quot;<!--#echo var="FEAT_expanded-view-of-folders"-->&quot;</A>
14410 has an effect.
14411 <P>
14412 &lt;End of help on this topic&gt;
14413 </BODY>
14414 </HTML>
14415 ====== h_config_combined_subdir_display =====
14416 <HTML>
14417 <HEAD>
14418 <TITLE>FEATURE: <!--#echo var="FEAT_combined-subdirectory-display"--></TITLE>
14419 </HEAD>
14420 <BODY>
14421 <H1>FEATURE: <!--#echo var="FEAT_combined-subdirectory-display"--></H1>
14422
14423 This feature affects the Folder List screen when
14424 the
14425 <A HREF="h_config_combined_folder_display">&quot;<!--#echo var="FEAT_combined-folder-display"-->&quot;</A>
14426 feature is enabled.  Normally, selecting a directory from the Folder
14427 List takes you into a new screen displaying only the contents of
14428 that directory.
14429
14430 <P>
14431 Enabling this feature will cause the contents of the selected
14432 directory to be
14433 displayed within the boundaries of the &quot;Collection&quot; it
14434 is a part of.  All previously displayed collections will remain
14435 in the screen.
14436
14437 <P>
14438 The way that commands work won't be changed.
14439 For example, the Select All command will select all of the folders in the
14440 directory, as opposed to all of the entries in all of the collections.
14441 The WhereIs command will change a little.
14442 It will search through all of the folders in the current collection as well
14443 as all the folder in any other expanded collection.
14444
14445 <P>
14446 &lt;End of help on this topic&gt;
14447 </BODY>
14448 </HTML>
14449 ====== h_config_separate_fold_dir_view =====
14450 <HTML>
14451 <HEAD>
14452 <TITLE>FEATURE: <!--#echo var="FEAT_separate-folder-and-directory-entries"--></TITLE>
14453 </HEAD>
14454 <BODY>
14455 <H1>FEATURE: <!--#echo var="FEAT_separate-folder-and-directory-entries"--></H1>
14456
14457 This feature affects folder collections wherein a folder
14458 and directory can have the same name.  By default, Alpine displays them
14459 only once, denoting that it is both a folder and directory by appending
14460 the folder name with the hierarchy character enclosed
14461 in square brackets.
14462
14463
14464 <P>
14465 Enabling this feature will cause Alpine to display such names
14466 separately marking the name representing a directory with a trailing
14467 hierarchy delimiter (typically the slash, &quot;/&quot;, character).
14468
14469 <P>
14470 The feature also alters the command set slightly.  By default, the
14471 right-arrow descends into the directory, while hitting the Return key will
14472 cause the folder by that name to be opened.
14473
14474 <P>
14475 With this feature set, the Return key will open the highlighted folder, or
14476 enter the highlighted directory.
14477
14478 <P>
14479 &lt;End of help on this topic&gt;
14480 </BODY>
14481 </HTML>
14482 ====== h_config_expanded_folders =====
14483 <HTML>
14484 <HEAD>
14485 <TITLE>FEATURE: <!--#echo var="FEAT_expanded-view-of-folders"--></TITLE>
14486 </HEAD>
14487 <BODY>
14488 <H1>FEATURE: <!--#echo var="FEAT_expanded-view-of-folders"--></H1>
14489
14490 If multiple folder collections are defined, and you
14491 wish to have them all expanded implicitly upon entering the FOLDER LIST
14492 screen, then set this feature. This feature will have no effect unless the
14493 feature
14494 <A HREF="h_config_combined_folder_display">&quot;<!--#echo var="FEAT_combined-folder-display"-->&quot;</A>
14495 is also set.
14496 <P>
14497 &lt;End of help on this topic&gt;
14498 </BODY>
14499 </HTML>
14500 ======= h_config_ldap_server =======
14501 <HTML>
14502 <HEAD>
14503 <TITLE>LDAP OPTION: <!--#echo var="VAR_ldap-servers"--></TITLE>
14504 </HEAD>
14505 <BODY>
14506 <H1>LDAP OPTION: <!--#echo var="VAR_ldap-servers"--></H1>
14507 This is the name of the host where an LDAP server is running.
14508 For redundancy, this may be a space-delimited set of server names, in which
14509 case the first server that answers is used.
14510 Each of the server names may be optionally followed by
14511 a colon and a port number.
14512 If this form is used then the port number configured below in the
14513 <EM>port</EM> field is not used.
14514 <P>
14515 To find out whether your organization has its own LDAP server,
14516 contact its computing support staff.
14517 <P><UL>
14518 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14519 </UL>
14520 <P>
14521 &lt;End of help on this topic&gt;
14522 </BODY>
14523 </HTML>
14524 ======= h_config_ldap_base =======
14525 <HTML>
14526 <HEAD>
14527 <TITLE>LDAP OPTION: Search-Base</TITLE>
14528 </HEAD>
14529 <BODY>
14530 <H1>LDAP OPTION: Search-Base</H1>
14531
14532 This is the search base to be used on this server.  It functions as a filter
14533 by restricting your searches in the LDAP server database
14534 to the specified contents of the specified fields.  Without it, searches
14535 submitted to this directory server may fail.  It might be something
14536 like:
14537
14538 <PRE>
14539       O = &lt;Your Organization Name&gt;, C = US
14540 </PRE>
14541 or it might be blank.
14542 (Some LDAP servers actually ignore anything specified here.)
14543 <P>
14544 If in doubt what parameters you should specify here,
14545 contact the maintainers of the LDAP server.
14546 <P><UL>
14547 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14548 </UL>
14549 <P>
14550 &lt;End of help on this topic&gt;
14551 </BODY>
14552 </HTML>
14553 ======= h_config_ldap_port =======
14554 <HTML>
14555 <HEAD>
14556 <TITLE>LDAP OPTION: Port</TITLE>
14557 </HEAD>
14558 <BODY>
14559 <H1>LDAP OPTION: Port</H1>
14560
14561 This is the TCP port number to be used with this LDAP server. If you leave
14562 this blank port 389 will be used.
14563 <P>
14564 &lt;End of help on this topic&gt;
14565 </BODY>
14566 </HTML>
14567 ======= h_config_ldap_nick =======
14568 <HTML>
14569 <HEAD>
14570 <TITLE>LDAP OPTION: Nickname</TITLE>
14571 </HEAD>
14572 <BODY>
14573 <H1>LDAP OPTION: Nickname</H1>
14574
14575 This is a nickname to be used in displays. If you don't supply a
14576 nickname the server name
14577 (<A HREF="h_config_ldap_server">&quot;<!--#echo var="VAR_ldap-servers"-->&quot;</A>)
14578 will be used instead.  This option is strictly for your convenience.
14579 <P>
14580 &lt;End of help on this topic&gt;
14581 </BODY>
14582 </HTML>
14583 ======= h_config_ldap_binddn =======
14584 <HTML>
14585 <HEAD>
14586 <TITLE>LDAP OPTION: Bind-DN</TITLE>
14587 </HEAD>
14588 <BODY>
14589 <H1>LDAP OPTION: Bind-DN</H1>
14590
14591 You may need to authenticate to the LDAP server before you are able to use it.
14592 This is the Distinguished Name to bind to when authenticating to this server.
14593 Try leaving this blank until you know you need it.
14594 <P>
14595 Alpine only knows about LDAP Simple authentication.
14596 It does not attempt LDAP SASL authentication.
14597 The DN and password will be sent in the clear unless TLS encryption is
14598 being used on this connection.
14599 Because of this, you may want to set the LDAP feature
14600 <A HREF="h_config_ldap_opts_tls">&quot;Attempt-TLS-On-Connection&quot;</A>
14601 or the feature
14602 <A HREF="h_config_ldap_opts_tlsmust">&quot;Require-TLS-On-Connection&quot;</A>
14603 if you are going to be providing a password.
14604 <P><UL>
14605 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14606 </UL>
14607 <P>
14608 &lt;End of help on this topic&gt;
14609 </BODY>
14610 </HTML>
14611 ======= h_config_ldap_opts_impl =======
14612 <HTML>
14613 <HEAD>
14614 <TITLE>LDAP FEATURE: Use-Implicitly-From-Composer</TITLE>
14615 </HEAD>
14616 <BODY>
14617 <H1>LDAP FEATURE: Use-Implicitly-From-Composer</H1>
14618
14619 Set this to have lookups done to this server implicitly from the composer.
14620 If an address doesn't look like a fully-qualified address, it will be looked
14621 up in your address books, and if it doesn't match a nickname there, then it
14622 will be looked up on the LDAP servers that have this feature set.
14623 The lookups will also be done when using the address completion feature
14624 (TAB command) in the composer if any of the serves have this feature set.
14625 Also see the LDAP feature
14626 <A HREF="h_config_ldap_opts_rhs">&quot;Lookup-Addrbook-Contents&quot;</A>
14627 and the Setup/Config feature
14628 <A HREF="h_config_add_ldap">&quot;<!--#echo var="FEAT_ldap-result-to-addrbook-add"-->&quot;</A>.
14629 <P>
14630 &lt;End of help on this topic&gt;
14631 </BODY>
14632 </HTML>
14633 ======= h_config_ldap_opts_tls =======
14634 <HTML>
14635 <HEAD>
14636 <TITLE>LDAP FEATURE: Attempt-TLS-On-Connection</TITLE>
14637 </HEAD>
14638 <BODY>
14639 <H1>LDAP FEATURE: Attempt-TLS-On-Connection</H1>
14640
14641 When connecting to this server Alpine will attempt to use TLS encryption
14642 on the connection.
14643 Also see the closely related feature
14644 <A HREF="h_config_ldap_opts_tlsmust">&quot;Require-TLS-On-Connection&quot;</A>
14645 <P>
14646 &lt;End of help on this topic&gt;
14647 </BODY>
14648 </HTML>
14649 ======= h_config_ldap_opts_tlsmust =======
14650 <HTML>
14651 <HEAD>
14652 <TITLE>LDAP FEATURE: Require-TLS-On-Connection</TITLE>
14653 </HEAD>
14654 <BODY>
14655 <H1>LDAP FEATURE: Require-TLS-On-Connection</H1>
14656
14657 When connecting to this server Alpine will attempt to use TLS encryption
14658 on the connection.
14659 If the StartTLS operation fails then the connection will not be used.
14660 <P>
14661 &lt;End of help on this topic&gt;
14662 </BODY>
14663 </HTML>
14664 ====== h_config_ldap_opts_rhs =====
14665 <HTML>
14666 <HEAD>
14667 <TITLE>LDAP FEATURE: Lookup-Addrbook-Contents</TITLE>
14668 </HEAD>
14669 <BODY>
14670 <H1>LDAP FEATURE: Lookup-Addrbook-Contents</H1>
14671
14672 Normally implicit LDAP lookups from the composer are done only for the
14673 strings you type in from the composer screen. In other words, you type in
14674 something in the To or CC field and press return, then the string is looked up.
14675 First that string is looked up in your address books. If a match is found
14676 there, then the results of that match are looked up again. If you place
14677 a string in your address book that you want to have looked up on the LDAP
14678 directory server, you need to turn on this feature. If you set this feature
14679 for a server, you almost always will also want to set the
14680 <A HREF="h_config_ldap_opts_impl">&quot;Use-Implicitly-From-Composer&quot;</A>
14681 feature. An example might serve to best illustrate this feature.
14682 <P>
14683 If an LDAP lookup of &quot;William Clinton&quot; normally returns an
14684 entry with an
14685 address of pres@whitehouse.gov, then you might put an entry in your address
14686 book that looks like:
14687 <P>
14688 <CENTER><SAMP>Nickname = bill</SAMP></CENTER><BR>
14689 <CENTER><SAMP>Address = &quot;William Clinton&quot;</SAMP></CENTER>
14690 <P>
14691 Now, when you type &quot;bill&quot; into an
14692 address field in the composer Alpine will
14693 find the &quot;bill&quot; entry in your address book.
14694 It will replace &quot;bill&quot; with
14695 &quot;William Clinton&quot;.
14696 It will then search for an entry with that nickname
14697 in your address book and not find one. If this feature
14698 is set, Alpine will then attempt to lookup
14699 &quot;William Clinton&quot; on the LDAP server and find the entry with address
14700 pres@whitehouse.gov.
14701 <P>
14702 A better way to accomplish the same thing is probably to use the feature
14703 <A HREF="h_config_ldap_opts_ref">&quot;Save-Search-Criteria-Not-Result&quot;</A>.
14704 <P>
14705 &lt;End of help on this topic&gt;
14706 </BODY>
14707 </HTML>
14708 ====== h_config_ldap_opts_ref =====
14709 <HTML>
14710 <HEAD>
14711 <TITLE>LDAP FEATURE: Save-Search-Criteria-Not-Result</TITLE>
14712 </HEAD>
14713 <BODY>
14714 <H1>LDAP FEATURE: Save-Search-Criteria-Not-Result</H1>
14715
14716 Normally when you save the results of an LDAP directory lookup to your
14717 address book the results of the lookup are saved. If this feature is set
14718 and the entry being saved was found on this directory server, then the
14719 search criteria is saved instead of the results of the search. When this
14720 address book entry is used in the future, instead of copying the results
14721 from the address book the directory lookup will be done again. This could
14722 be useful if the copied result might become stale because the data on
14723 the directory server changes (for example, the entry's email address changes).
14724 You probably don't want to set this feature if the server is at all slow or
14725 unreliable.
14726 <P>
14727 The way this actually works is that instead of saving the email address
14728 in your address book, Alpine saves enough information to look up the same
14729 directory entry again. In particular, it saves the server name and the
14730 distinguished name of the entry. It's possible that the server administrators
14731 might change the format of distinguished names on the server, or that the
14732 entry might be removed from the server. If Alpine notices this, you will be warned
14733 and a backup copy of the email address will be used. You may want to create
14734 a new entry in this case, since you will get the annoying warning every
14735 time you use the old entry. You may do that by Saving the entry to a new
14736 nickname in the same address book. You will be asked whether or not you
14737 want to use the backup email address.
14738 <P>
14739 A related feature in the Setup/Config screen is
14740 <A HREF="h_config_add_ldap">&quot;<!--#echo var="FEAT_ldap-result-to-addrbook-add"-->&quot;</A>.
14741 <P>
14742 &lt;End of help on this topic&gt;
14743 </BODY>
14744 </HTML>
14745 ======= h_config_ldap_opts_nosub =======
14746 <HTML>
14747 <HEAD>
14748 <TITLE>LDAP FEATURE: Disable-Ad-Hoc-Space-Substitution</TITLE>
14749 </HEAD>
14750 <BODY>
14751 <H1>LDAP FEATURE: Disable-Ad-Hoc-Space-Substitution</H1>
14752
14753 Spaces in your input are normally handled specially.
14754 Each space character is replaced
14755 by
14756 <P>
14757 <CENTER><SAMP>*&nbsp;&lt;SPACE&gt;</SAMP></CENTER>
14758 <P>
14759 in the search query (but not by &quot;* &lt;SPACE&gt; *&quot;).
14760 The reason this is done is so the input string
14761 <P>
14762 <CENTER><SAMP>Greg Donald</SAMP></CENTER>
14763 <P>
14764 (which is converted to &quot;Greg* Donald&quot;) will match
14765 the names &quot;Greg Donald&quot;,
14766 &quot;Gregory Donald&quot;, &quot;Greg F. Donald&quot;, and
14767 &quot;Gregory F Donald&quot;; but it won't match &quot;Greg McDonald&quot;.
14768 If the &quot;Search-Rule&quot; you were using was &quot;begins-with&quot;,
14769 then it would also match the name &quot;Greg Donaldson&quot;.
14770 <P>
14771 Turning on this feature will disable this substitution.
14772 <P>
14773 &lt;End of help on this topic&gt;
14774 </BODY>
14775 </HTML>
14776 ====== h_config_ldap_searchtypes =======
14777 <HTML>
14778 <HEAD>
14779 <TITLE>LDAP OPTION: Search-Type</TITLE>
14780 </HEAD>
14781 <BODY>
14782 <H1>LDAP OPTION: Search-Type</H1>
14783
14784 This affects the way that LDAP searches are done.
14785 In particular, this tells the server where to look for the string to be matched.
14786 If set to &quot;name&quot; then the string that is being searched for will
14787 be compared with the string in the
14788 &quot;Name&quot; field on the server
14789 (technically, it is the &quot;commonname&quot; field on the server).
14790 &quot;Surname&quot; means we're looking for a
14791 match in the &quot;Surname&quot; field on the
14792 server (actually the &quot;sn&quot; field).
14793 &quot;Givenname&quot; really is &quot;givenname&quot;
14794 and &quot;email&quot; is the electronic mail address (this is actually the field
14795 called &quot;mail&quot; or &quot;electronicmail&quot; on the server).
14796 The other three types are combinations of
14797 the types listed so far. &quot;Name-or-email&quot;
14798 means the string should appear
14799 in either the &quot;name&quot; field OR the &quot;email&quot; field.
14800 Likewise, &quot;surname-or-givenname&quot;
14801 means &quot;surname&quot; OR &quot;givenname&quot;
14802 and &quot;sur-or-given-or-name-or-email&quot; means the obvious thing.
14803 <P>
14804 This search TYPE is combined with the
14805 search <A HREF="h_config_ldap_searchrules">RULE</A>
14806 to form the actual search query.
14807 <P>
14808 The usual default value for this
14809 option is &quot;sur-or-given-or-name-or-email&quot;.
14810 This type of search may be slow on some servers.
14811 Try &quot;name-or-email&quot;, which is often
14812 faster, or just &quot;name&quot; if the performance seems to be a problem.
14813 <P>
14814 Some servers have been configured with different attribute names for
14815 these four fields.
14816 In other words, instead of using the attribute name &quot;mail&quot;
14817 for the email address field, the server might be configured to use something
14818 else, for example, &quot;rfc822mail&quot; or &quot;internetemailaddress&quot;.
14819 Alpine can be configured to use these different attribute names by using
14820 the four configuration options:
14821 <P><UL>
14822 <LI><A HREF="h_config_ldap_email_attr">&quot;EmailAttribute&quot;</A>
14823 </UL>
14824 <P><UL>
14825 <LI><A HREF="h_config_ldap_cn_attr">&quot;NameAttribute&quot;</A>
14826 </UL>
14827 <P><UL>
14828 <LI><A HREF="h_config_ldap_sn_attr">&quot;SurnameAttribute&quot;</A>
14829 </UL>
14830 <P><UL>
14831 <LI><A HREF="h_config_ldap_gn_attr">&quot;GivennameAttribute&quot;</A>
14832 </UL>
14833 <P>
14834 &lt;End of help on this topic&gt;
14835 </BODY>
14836 </HTML>
14837 ====== h_config_ldap_searchrules =======
14838 <HTML>
14839 <HEAD>
14840 <TITLE>LDAP OPTION: Search-Rule</TITLE>
14841 </HEAD>
14842 <BODY>
14843 <H1>LDAP OPTION: Search-Rule</H1>
14844
14845 This affects the way that LDAP searches are done.
14846 If set to &quot;equals&quot; then
14847 only exact matches count.
14848 &quot;Contains&quot; means that the string you type in
14849 is a substring of what you are matching against.
14850 &quot;Begins-with&quot; and &quot;ends-with&quot;
14851 mean that the string starts or ends with the string you type in.
14852 <P>
14853 Spaces in your input are normally handled specially, but you can turn that
14854 special handling off with the
14855 <A HREF="h_config_ldap_opts_nosub">&quot;Disable-Ad-Hoc-Space-Substitution&quot;</A>
14856 feature.
14857 <P>
14858 The usual default value for this option is &quot;begins-with&quot;.
14859 <P>
14860 &lt;End of help on this topic&gt;
14861 </BODY>
14862 </HTML>
14863 ======= h_config_ldap_email_attr =======
14864 <HTML>
14865 <HEAD>
14866 <TITLE>LDAP OPTION: EmailAttribute</TITLE>
14867 </HEAD>
14868 <BODY>
14869 <H1>LDAP OPTION: EmailAttribute</H1>
14870
14871 This is the name of the attribute that is searched for when looking for
14872 an email address. The default value for this option is &quot;mail&quot; or
14873 &quot;electronicmail&quot;.
14874 If the server you are using uses a different attribute name for the email
14875 address, put that attribute name here.
14876 <P>
14877 This will affect the search filter used if your Search-Type is one that
14878 contains a search for &quot;email&quot;.
14879 It will also cause the attribute value matching this attribute name to be used
14880 as the email address when you look up an entry from the composer.
14881 <P>
14882 &lt;End of help on this topic&gt;
14883 </BODY>
14884 </HTML>
14885 ======= h_config_ldap_sn_attr =======
14886 <HTML>
14887 <HEAD>
14888 <TITLE>LDAP OPTION: SurnameAttribute</TITLE>
14889 </HEAD>
14890 <BODY>
14891 <H1>LDAP OPTION: SurnameAttribute</H1>
14892
14893 This is the name of the attribute that is searched for when looking for
14894 the surname of the entry. The default value for this option is &quot;sn&quot;.
14895 If the server you are using uses a different attribute name for the surname,
14896 put that attribute name here.
14897 This will affect the search filter used if your Search-Type is one that
14898 contains a search for &quot;surname&quot;.
14899 <P>
14900 &lt;End of help on this topic&gt;
14901 </BODY>
14902 </HTML>
14903 ======= h_config_ldap_gn_attr =======
14904 <HTML>
14905 <HEAD>
14906 <TITLE>LDAP OPTION: GivennameAttribute</TITLE>
14907 </HEAD>
14908 <BODY>
14909 <H1>LDAP OPTION: GivennameAttribute</H1>
14910
14911 This is the name of the attribute that is searched for when looking for
14912 the given name of the entry. The default value for this option is &quot;givenname&quot;.
14913 If the server you are using uses a different attribute name for the given name,
14914 put that attribute name here.
14915 This will affect the search filter used if your Search-Type is one that
14916 contains a search for &quot;givenname&quot;.
14917 <P>
14918 &lt;End of help on this topic&gt;
14919 </BODY>
14920 </HTML>
14921 ======= h_config_ldap_cn_attr =======
14922 <HTML>
14923 <HEAD>
14924 <TITLE>LDAP OPTION: NameAttribute</TITLE>
14925 </HEAD>
14926 <BODY>
14927 <H1>LDAP OPTION: NameAttribute</H1>
14928
14929 This is the name of the attribute that is searched for when looking for
14930 the name of the entry. The default value for this option is &quot;cn&quot;, which
14931 stands for common name.
14932 If the server you are using uses a different attribute name for the name,
14933 put that attribute name here.
14934 This will affect the search filter used if your Search-Type is one that
14935 contains a search for &quot;name&quot;.
14936 <P>
14937 &lt;End of help on this topic&gt;
14938 </BODY>
14939 </HTML>
14940 ======= h_config_ldap_time =======
14941 <HTML>
14942 <HEAD>
14943 <TITLE>LDAP OPTION: Timelimit</TITLE>
14944 </HEAD>
14945 <BODY>
14946 <H1>LDAP OPTION: Timelimit</H1>
14947
14948 This places a limit on the number of seconds the LDAP search will continue.
14949 The default is 30 seconds. A value of 0 means no limit. Note that some servers
14950 may place limits of their own on searches.
14951 <P>
14952 &lt;End of help on this topic&gt;
14953 </BODY>
14954 </HTML>
14955 ======= h_config_ldap_size =======
14956 <HTML>
14957 <HEAD>
14958 <TITLE>LDAP OPTION: Sizelimit</TITLE>
14959 </HEAD>
14960 <BODY>
14961 <H1>LDAP OPTION: Sizelimit</H1>
14962
14963 This places a limit on the number of entries returned by the LDAP server.
14964 A value of 0 means no limit. The default is 0. Note that some servers
14965 may place limits of their own on searches.
14966 <P>
14967 &lt;End of help on this topic&gt;
14968 </BODY>
14969 </HTML>
14970 ======= h_config_ldap_cust =======
14971 <HTML>
14972 <HEAD>
14973 <TITLE>LDAP OPTION: Custom-Search-Filter</TITLE>
14974 </HEAD>
14975 <BODY>
14976 <H1>LDAP OPTION: Custom-Search-Filter</H1>
14977
14978 This one is for advanced users only! If you define this, then the
14979 &quot;Search-Type&quot; and &quot;Search-Rule&quot; defined are both ignored.
14980 However, the feature
14981 <A HREF="h_config_ldap_opts_nosub">&quot;Disable-Ad-Hoc-Space-Substitution&quot;</A>
14982 is still in effect.
14983 That is, the space substitution will take place even in a custom filter unless
14984 you disable it.
14985 <P>
14986 If your LDAP service stops working and you suspect it might be because
14987 of your custom filter, just delete this filter and try using the
14988 &quot;Search-Type&quot; and &quot;Search-Rule&quot; instead.
14989 Another option that sometimes causes trouble is the
14990 <A HREF="h_config_ldap_base">&quot;Search-Base&quot;</A> option.
14991 <P>
14992 This variable may be set to the string representation of an LDAP search
14993 filter (see RFC1960). In the places where you want the address string to be
14994 substituted in, put a '%s' in this filter string. Here are some examples:
14995 <P>
14996 A &quot;Search-Type&quot; of &quot;name&quot; with &quot;Search-Rule&quot; of &quot;begins-with&quot;
14997 is equivalent to the &quot;Custom-Search-Filter&quot;
14998 <PRE>
14999      (cn=%s*)
15000 </PRE>
15001 When you try to match against the string &quot;string&quot; the program replaces
15002 the &quot;%s&quot; with &quot;string&quot; (without the quotes). You may have multiple &quot;%s&quot;'s and
15003 they will all be replaced with the string. There is a limit of 10 &quot;%s&quot;'s.
15004 <P>
15005 A &quot;Search-Type&quot; of &quot;name-or-email&quot; with &quot;Search-Rule&quot;
15006 of &quot;contains&quot; is equivalent to
15007 <PRE>
15008      (|(cn=*%s*)(mail=*%s*))
15009 </PRE>
15010 <P>
15011 If your server uses a different attribute <EM>name</EM> than
15012 Alpine uses by default,
15013 (for example, it uses &quot;rfc822mail&quot; instead of &quot;mail&quot;),
15014 then you may be able to use one or more of the four attribute configuration
15015 options instead of defining a custom filter:
15016 <P><UL>
15017 <LI><A HREF="h_config_ldap_email_attr">&quot;EmailAttribute&quot;</A>
15018 </UL>
15019 <P><UL>
15020 <LI><A HREF="h_config_ldap_cn_attr">&quot;NameAttribute&quot;</A>
15021 </UL>
15022 <P><UL>
15023 <LI><A HREF="h_config_ldap_sn_attr">&quot;SurnameAttribute&quot;</A>
15024 </UL>
15025 <P><UL>
15026 <LI><A HREF="h_config_ldap_gn_attr">&quot;GivennameAttribute&quot;</A>
15027 </UL>
15028 <P>
15029 &lt;End of help on this topic&gt;
15030 </BODY>
15031 </HTML>
15032 ======= h_composer_abook_comment =======
15033 <HTML>
15034 <HEAD>
15035 <TITLE>Addressbook Comment Explained</TITLE>
15036 </HEAD>
15037 <BODY>
15038 This is a comment to help you remember what this entry is. The WhereIs
15039 command searches comments so that it is easier to find an entry with a comment
15040 you know about attached to it. This field is not used in the outgoing message.
15041 <P>
15042 Look <A HREF="h_edit_nav_cmds">here</A>
15043 to see the available Editing and Navigation commands.
15044 <P>
15045 &lt;End of help on this topic&gt;
15046 </BODY>
15047 </HTML>
15048 ======= h_composer_abook_addrs =======
15049 <HTML>
15050 <HEAD>
15051 <TITLE>Addressbook Lists</TITLE>
15052 </HEAD>
15053 <BODY>
15054 <H1>Addressbook Lists</H1>
15055
15056 This is a list of addresses to send to when sending to this address book
15057 entry.  Each member of the list may be an address or another nickname from
15058 any of your address books.  If it is an address, it is OK to include the
15059 full name field as well as the electronic address portion of that address.
15060 For example, the following are all legitimate entries in this field:
15061
15062 <DL><DT>&nbsp;</DT>
15063 <DD>john&nbsp;&nbsp;&nbsp;&nbsp;(a nickname in your address book)
15064 <DD>jdoe@some.domain
15065 <DD>John Doe &lt;jdoe@some.domain&gt;
15066 </DL>
15067
15068 The addresses should be listed separated by commas, just like you would
15069 enter them from the composer.
15070
15071 <P>
15072
15073 The only difference between a distribution list and a simple entry with a
15074 single address, is that a distribution list has more than one address
15075 listed in the Addresses: field, whereas a simple personal entry has just
15076 one address.
15077
15078 <P>
15079
15080 For individual address book entries, if there is a full name in the
15081 Fullname: field (filling in the Fullname: field is not required), it is
15082 used.  If the full name is specified in the Address: field and not in the
15083 Fullname: field, then the full name from the Address: field is used.
15084
15085 <P>
15086
15087 If you type the nickname of a distribution list from one of your address
15088 books in the Lcc: field, then the full name of that list is used in the
15089 To: field.  If you put a list in the To: or Cc: fields, that list will be
15090 expanded into all of its addresses.  If the list has a full name, then
15091 that will appear at the beginning of the addresses.
15092
15093 <DL><DT>&nbsp;</DT>
15094 <DD>Sewing Club &lt;john@somewhere&gt;, nancy@something.else, Sal
15095 &lt;sal@here.there&gt;
15096 </DL>
15097
15098 If the first address in the distribution list also has a full name, then
15099 the list full name and that full name are combined into something like the
15100 following:
15101
15102 <DL><DT>&nbsp;</DT>
15103 <DD>Sewing Club -- John Smith &lt;john@somewhere&gt;
15104 </DL>
15105
15106
15107 If you specify a list via Lcc, the full name is used in the To: line.  If
15108 you specify a list in the To: or Cc: fields, then it uses the same method
15109 as for individual entries for filling in the full name.
15110
15111 <P>
15112
15113 For help with editing and navigation commands, check the Help for the
15114 Nickname: field.
15115
15116 <P>
15117 &lt;End of help on this topic&gt;
15118 </BODY>
15119 </HTML>
15120 ======= h_config_role_nick =======
15121 <HTML>
15122 <HEAD>
15123 <TITLE>Nickname Explained</TITLE>
15124 </HEAD>
15125 <BODY>
15126 <H1>Nickname Explained</H1>
15127
15128 This is a nickname to help you.
15129 You should have a different nickname for each role you define.
15130 The nickname will be used in the SETUP ROLE RULES screen to allow you to
15131 pick a role to edit.
15132 It will also be used when you send a message to let you know you are
15133 sending with a different role than you use by default, and
15134 it will be useful for choosing a role when composing with the Role command
15135 or when composing with one of the Role Uses set to With Confirmation.
15136 This field is not used in the outgoing message.
15137 <P>
15138 Look <A HREF="h_edit_nav_cmds">here</A>
15139 to see the available Editing and Navigation commands.
15140 <P>
15141 &lt;End of help on this topic&gt;
15142 </BODY>
15143 </HTML>
15144 ======= h_config_role_comment =======
15145 <HTML>
15146 <HEAD>
15147 <TITLE>Comment Explained</TITLE>
15148 </HEAD>
15149 <BODY>
15150 <H1>Comment Explained</H1>
15151
15152 This is a comment to help you.
15153 This comment does not play any functional role, it is simply an optional
15154 comment to help you remember what the rule is for.
15155 <P>
15156 Look <A HREF="h_edit_nav_cmds">here</A>
15157 to see the available Editing and Navigation commands.
15158 <P>
15159 &lt;End of help on this topic&gt;
15160 </BODY>
15161 </HTML>
15162 ======= h_config_other_nick =======
15163 <HTML>
15164 <HEAD>
15165 <TITLE>Nickname Explained</TITLE>
15166 </HEAD>
15167 <BODY>
15168 <H1>Nickname Explained</H1>
15169
15170 This is a nickname to help you.
15171 You should have a different nickname for each rule you define.
15172 The nickname will be used in the SETUP OTHER RULES screen to allow you to
15173 pick a rule to edit.
15174 <P>
15175 Look <A HREF="h_edit_nav_cmds">here</A>
15176 to see the available Editing and Navigation commands.
15177 <P>
15178 &lt;End of help on this topic&gt;
15179 </BODY>
15180 </HTML>
15181 ======= h_config_score_nick =======
15182 <HTML>
15183 <HEAD>
15184 <TITLE>Nickname Explained</TITLE>
15185 </HEAD>
15186 <BODY>
15187 <H1>Nickname Explained</H1>
15188
15189 This is a nickname to help you.
15190 You should have a different nickname for each scoring rule you define.
15191 The nickname will be used in the SETUP SCORING RULES screen to allow you to
15192 pick a rule to edit.
15193 <P>
15194 Look <A HREF="h_edit_nav_cmds">here</A>
15195 to see the available Editing and Navigation commands.
15196 <P>
15197 &lt;End of help on this topic&gt;
15198 </BODY>
15199 </HTML>
15200 ======= h_config_incol_nick =======
15201 <HTML>
15202 <HEAD>
15203 <TITLE>Nickname Explained</TITLE>
15204 </HEAD>
15205 <BODY>
15206 <H1>Nickname Explained</H1>
15207
15208 This is a nickname to help you.
15209 You should have a different nickname for each color rule you define.
15210 The nickname will be used in the SETUP INDEX COLOR RULES screen to allow you to
15211 pick a rule to edit.
15212 <P>
15213 Look <A HREF="h_edit_nav_cmds">here</A>
15214 to see the available Editing and Navigation commands.
15215 <P>
15216 &lt;End of help on this topic&gt;
15217 </BODY>
15218 </HTML>
15219 ======= h_config_filt_nick =======
15220 <HTML>
15221 <HEAD>
15222 <TITLE>Nickname Explained</TITLE>
15223 </HEAD>
15224 <BODY>
15225 <H1>Nickname Explained</H1>
15226
15227 This is a nickname to help you.
15228 You should have a different nickname for each filtering rule you define.
15229 The nickname will be used in the SETUP FILTERING RULES screen to allow you to
15230 pick a rule to edit.
15231 <P>
15232 Look <A HREF="h_edit_nav_cmds">here</A>
15233 to see the available Editing and Navigation commands.
15234 <P>
15235 &lt;End of help on this topic&gt;
15236 </BODY>
15237 </HTML>
15238 ======= h_config_score_topat =======
15239 <HTML>
15240 <HEAD>
15241 <TITLE>&quot;To:&quot; Pattern Explained</TITLE>
15242 </HEAD>
15243 <BODY>
15244 <H1>&quot;To:&quot; Pattern Explained</H1>
15245
15246 Any text you enter as the &quot;To pattern&quot;
15247 will be compared to the recipients from the To: line of
15248 the message being scored.
15249 When the text you entered matches
15250 all or part of the To: line of a message, then the Score Value
15251 you have specified will be added to the score for the message.
15252 (Any other non-blank parts of the Pattern must match, too.)
15253 <P>
15254
15255 You may enter a complete email address, part of an address, or a
15256 list of addresses or partial addresses.
15257 For example:
15258 <P>
15259
15260 <PRE>
15261  To pattern = friend@public.com
15262
15263  To pattern = rated.net
15264
15265  To pattern = xxx@adults.com
15266               admin@msn.com
15267               fool@motleyfool.com
15268 </PRE>
15269
15270 <P>
15271 Each of those are valid To patterns.
15272 <P>
15273
15274 Messages match those patterns if any of the
15275 addresses in the To: line of the message contains the pattern.
15276 If the pattern is a list of patterns
15277 (like the last example above) then it is a match if any of the patterns in
15278 the list match any of the addresses in the To: line.
15279 (It is not possible to specify two addresses that must <EM>BOTH</EM> be
15280 present for a match.
15281 It is only possible to specify that <EM>EITHER</EM> address1 <EM>OR</EM>
15282 address2 must be present.
15283 That is exactly what using a list does.)
15284 <P>
15285
15286 Some messages may be &quot;bounced&quot; to you, and will
15287 have a &quot;Resent-To:&quot; header line.
15288 If the message contains a Resent-To: line
15289 and the feature <A HREF="h_config_use_resentto"><!--#echo var="FEAT_use-resent-to-in-rules"--></A> is turned on,
15290 Alpine will look for
15291 matches to your &quot;To patterns&quot; there, and <EM>NOT</EM> in
15292 the original To: line.
15293 <P>
15294
15295 When entering a pattern, you may choose an address from your address book
15296 with the &quot;T&quot; command.
15297 <P>
15298
15299 It is possible to add a <EM>NOT</EM> to the To Pattern meaning with the
15300 &quot;!&quot; &quot;toggle NOT&quot; command.
15301 This changes the meaning of the To pattern so that it has the opposite meaning.
15302 It will be considered a match if there are no matches between the
15303 addresses in the To: line and the list of To patterns.
15304 <P>
15305 Don't make the mistake of putting the &quot;!&quot; in the data field for
15306 the pattern.
15307 For example, if you type the characters &quot;!frizzle&quot; into the To
15308 pattern, the pattern will look like:
15309 <P>
15310 <PRE>
15311  To pattern = !frizzle
15312 </PRE>
15313 <P>
15314 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
15315 In order to match messages that do not have &quot;frizzle&quot; in
15316 their To field, first type the characters &quot;frizzle&quot; followed
15317 by carriage return for the value of the To pattern, then negate it
15318 by typing the &quot;!&quot; command.
15319 It should end up looking like
15320 <P>
15321 <PRE>
15322  ! To pattern = frizzle
15323 </PRE>
15324 <P>
15325 You are not limited to using the six standard header patterns that are
15326 normally shown (To, From, Sender, Cc, News, and Subject).
15327 You may add any other header to a Pattern by
15328 using the &quot;eXtraHdr&quot; command to specify a different
15329 message header line; and then the Add or Change command to fill in
15330 a pattern for the new header line, just like you would for a standard header.
15331 <P>
15332 A technicality: Since comma is the character used to separate multiple
15333 values in a pattern field, you have to escape comma with a backslash (&#92;) if
15334 you want to include a literal comma in the field.
15335 In other words, if you type a backslash followed by a comma it will
15336 be interpreted as a comma by Alpine, instead of as a separator between
15337 pattern values.
15338 All other backslashes are literal backslashes and should not be escaped.
15339 <P>
15340 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
15341 for more information on Patterns.
15342 <P>
15343 Look <A HREF="h_edit_nav_cmds">here</A>
15344 to see the available Editing and Navigation commands.
15345 <P>
15346 &lt;End of help on this topic&gt;
15347 </BODY>
15348 </HTML>
15349 ======= h_config_incol_topat =======
15350 <HTML>
15351 <HEAD>
15352 <TITLE>&quot;To:&quot; Pattern Explained</TITLE>
15353 </HEAD>
15354 <BODY>
15355 <H1>&quot;To:&quot; Pattern Explained</H1>
15356
15357 Any text you enter as the &quot;To pattern&quot;
15358 will be compared to the recipients from the To: lines of
15359 the messages in the index.
15360 When the text you entered matches
15361 all or part of the To: line of a message, then the Index Line Color you have
15362 specified will be used for that line in the index.
15363 (Any other non-blank parts of the Pattern must match, too.)
15364 <P>
15365
15366 You may enter a complete email address, part of an address, or a
15367 list of addresses or partial addresses.
15368 For example:
15369 <P>
15370
15371 <PRE>
15372  To pattern = friend@public.com
15373  To pattern = rated.net
15374  To pattern = xxx@adults.com
15375               admin@msn.com
15376               fool@motleyfool.com
15377 </PRE>
15378
15379 <P>
15380 Each of those are valid To patterns.
15381 <P>
15382
15383 Messages match those patterns if any of the
15384 addresses in the To: line of the message contains the pattern.
15385 If the pattern is a list of patterns
15386 (like the last example above) then it is a match if any of the patterns in
15387 the list match any of the addresses in the To: line.
15388 (It is not possible to specify two addresses that must <EM>BOTH</EM> be
15389 present for a match.
15390 It is only possible to specify that <EM>EITHER</EM> address1 <EM>OR</EM>
15391 address2 must be present.
15392 That is exactly what using a list does.)
15393 <P>
15394
15395 Some messages may be &quot;bounced&quot; to you, and will
15396 have a &quot;Resent-To:&quot; header line.
15397 If the message contains a Resent-To: line
15398 and the feature <A HREF="h_config_use_resentto"><!--#echo var="FEAT_use-resent-to-in-rules"--></A> is turned on,
15399 Alpine will look for
15400 matches to your &quot;To patterns&quot; there, and <EM>NOT</EM> in
15401 the original To: line.
15402 <P>
15403
15404 When entering a pattern, you may choose an address from your address book
15405 with the &quot;T&quot; command.
15406 <P>
15407
15408 It is possible to add a <EM>NOT</EM> to the To Pattern meaning with the
15409 &quot;!&quot; &quot;toggle NOT&quot; command.
15410 This changes the meaning of the To pattern so that it has the opposite meaning.
15411 It will be considered a match if there are no matches between the
15412 addresses in the To: line and the list of To patterns.
15413 <P>
15414 Don't make the mistake of putting the &quot;!&quot; in the data field for
15415 the pattern.
15416 For example, if you type the characters &quot;!frizzle&quot; into the To
15417 pattern, the pattern will look like:
15418 <P>
15419 <PRE>
15420  To pattern = !frizzle
15421 </PRE>
15422 <P>
15423 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
15424 In order to match messages that do not have &quot;frizzle&quot; in
15425 their To field, first type the characters &quot;frizzle&quot; followed
15426 by carriage return for the value of the To pattern, then negate it
15427 by typing the &quot;!&quot; command.
15428 It should end up looking like
15429 <P>
15430 <PRE>
15431  ! To pattern = frizzle
15432 </PRE>
15433 <P>
15434
15435 You are not limited to using the six standard header patterns that are
15436 normally shown (To, From, Sender, Cc, News, and Subject).
15437 You may add any other header to a Pattern by
15438 using the &quot;eXtraHdr&quot; command to specify a different
15439 message header line; and then the Add or Change command to fill in
15440 a pattern for the new header line, just like you would for a standard header.
15441 <P>
15442 A technicality: Since comma is the character used to separate multiple
15443 values in a pattern field, you have to escape comma with a backslash (&#92;) if
15444 you want to include a literal comma in the field.
15445 In other words, if you type a backslash followed by a comma it will
15446 be interpreted as a comma by Alpine, instead of as a separator between
15447 pattern values.
15448 All other backslashes are literal backslashes and should not be escaped.
15449 <P>
15450 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
15451 for more information on Patterns.
15452 <P>
15453 Look <A HREF="h_edit_nav_cmds">here</A>
15454 to see the available Editing and Navigation commands.
15455 <P>
15456 &lt;End of help on this topic&gt;
15457 </BODY>
15458 </HTML>
15459 ======= h_config_other_topat =======
15460 <HTML>
15461 <HEAD>
15462 <TITLE>&quot;To:&quot; Pattern Explained</TITLE>
15463 </HEAD>
15464 <BODY>
15465 <H1>&quot;To:&quot; Pattern Explained</H1>
15466
15467 For some of the OTHER RULES actions, there is no message that is being
15468 compared against.
15469 If that is the case, then only the Current Folder Type is checked.
15470 In particular, this To pattern is ignored.
15471 Actions that fall into this category include both
15472 Sort Order and Index Format.
15473 <P>
15474 A technicality: Since comma is the character used to separate multiple
15475 values in a pattern field, you have to escape comma with a backslash (&#92;) if
15476 you want to include a literal comma in the field.
15477 In other words, if you type a backslash followed by a comma it will
15478 be interpreted as a comma by Alpine, instead of as a separator between
15479 pattern values.
15480 All other backslashes are literal backslashes and should not be escaped.
15481 <P>
15482 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
15483 for more information on Patterns.
15484 <P>
15485 Look <A HREF="h_edit_nav_cmds">here</A>
15486 to see the available Editing and Navigation commands.
15487 <P>
15488 &lt;End of help on this topic&gt;
15489 </BODY>
15490 </HTML>
15491 ======= h_config_filt_topat =======
15492 <HTML>
15493 <HEAD>
15494 <TITLE>&quot;To:&quot; Pattern Explained</TITLE>
15495 </HEAD>
15496 <BODY>
15497 <H1>&quot;To:&quot; Pattern Explained</H1>
15498
15499 Any text you enter as the &quot;To pattern&quot;
15500 will be compared to the recipients from the To: line of
15501 messages when Alpine opens folders.
15502 When the text you entered matches
15503 all or part of the To: line of a message, then the Filter Action you have
15504 specified will be carried out.
15505 (Any other non-blank parts of the Pattern must match, too.)
15506 <P>
15507
15508 You may enter a complete email address, part of an address, or a
15509 list of addresses or partial addresses.
15510 For example:
15511 <P>
15512
15513 <PRE>
15514  To pattern = friend@public.com
15515  To pattern = rated.net
15516  To pattern = xxx@adults.com
15517               admin@msn.com
15518               fool@motleyfool.com
15519 </PRE>
15520
15521 <P>
15522 Each of those are valid To patterns.
15523 <P>
15524
15525 Messages match those patterns if any of the
15526 addresses in the To: line of the message contains the pattern.
15527 If the pattern is a list of patterns
15528 (like the last example above) then it is a match if any of the patterns in
15529 the list match any of the addresses in the To: line.
15530 (It is not possible to specify two addresses that must <EM>BOTH</EM> be
15531 present for a match.
15532 It is only possible to specify that <EM>EITHER</EM> address1 <EM>OR</EM>
15533 address2 must be present.
15534 That is exactly what using a list does.)
15535 <P>
15536
15537 Some messages may be &quot;bounced&quot; to you, and will
15538 have a &quot;Resent-To:&quot; header line.
15539 If the message contains a Resent-To: line
15540 and the feature <A HREF="h_config_use_resentto"><!--#echo var="FEAT_use-resent-to-in-rules"--></A> is turned on,
15541 Alpine will look for
15542 matches to your &quot;To patterns&quot; there, and <EM>NOT</EM> in
15543 the original To: line.
15544 <P>
15545
15546 When entering a pattern, you may choose an address from your address book
15547 with the &quot;T&quot; command.
15548 <P>
15549
15550 It is possible to add a <EM>NOT</EM> to the To Pattern meaning with the
15551 &quot;!&quot; &quot;toggle NOT&quot; command.
15552 This changes the meaning of the To pattern so that it has the opposite meaning.
15553 It will be considered a match if there are no matches between the
15554 addresses in the To: line and the list of To patterns.
15555 <P>
15556 Don't make the mistake of putting the &quot;!&quot; in the data field for
15557 the pattern.
15558 For example, if you type the characters &quot;!frizzle&quot; into the To
15559 pattern, the pattern will look like:
15560 <P>
15561 <PRE>
15562  To pattern = !frizzle
15563 </PRE>
15564 <P>
15565 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
15566 In order to match messages that do not have &quot;frizzle&quot; in
15567 their To field, first type the characters &quot;frizzle&quot; followed
15568 by carriage return for the value of the To pattern, then negate it
15569 by typing the &quot;!&quot; command.
15570 It should end up looking like
15571 <P>
15572 <PRE>
15573  ! To pattern = frizzle
15574 </PRE>
15575 <P>
15576
15577 You are not limited to using the six standard header patterns that are
15578 normally shown (To, From, Sender, Cc, News, and Subject).
15579 You may add any other header to a Pattern by
15580 using the &quot;eXtraHdr&quot; command to specify a different
15581 message header line; and then the Add or Change command to fill in
15582 a pattern for the new header line, just like you would for a standard header.
15583 <P>
15584 A technicality: Since comma is the character used to separate multiple
15585 values in a pattern field, you have to escape comma with a backslash (&#92;) if
15586 you want to include a literal comma in the field.
15587 In other words, if you type a backslash followed by a comma it will
15588 be interpreted as a comma by Alpine, instead of as a separator between
15589 pattern values.
15590 All other backslashes are literal backslashes and should not be escaped.
15591 <P>
15592 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
15593 for more information on Patterns.
15594 <P>
15595 Look <A HREF="h_edit_nav_cmds">here</A>
15596 to see the available Editing and Navigation commands.
15597 <P>
15598 &lt;End of help on this topic&gt;
15599 </BODY>
15600 </HTML>
15601 ======= h_config_role_topat =======
15602 <HTML>
15603 <HEAD>
15604 <TITLE>&quot;To:&quot; Pattern Explained</TITLE>
15605 </HEAD>
15606 <BODY>
15607 <H1>&quot;To:&quot; Pattern Explained</H1>
15608
15609 Any text you enter as the &quot;To pattern&quot;
15610 will be compared to the recipients from the To: line of
15611 the message being replied to or forwarded.
15612 (Any other non-blank parts of the Pattern must match, too.)
15613 In the case of the Compose command, this pattern and the other header
15614 patterns are ignored.
15615 <P>
15616
15617 You may enter a complete email address, part of an address, or a
15618 list of addresses or partial addresses.
15619 For example:
15620 <P>
15621
15622 <PRE>
15623  To pattern = friend@public.com
15624  To pattern = rated.net
15625  To pattern = xxx@adults.com
15626               admin@msn.com
15627               fool@motleyfool.com
15628 </PRE>
15629
15630 <P>
15631 Each of those are valid To patterns.
15632 <P>
15633
15634 Messages match those patterns if any of the
15635 addresses in the To: line of the message contains the pattern.
15636 If the pattern is a list of patterns
15637 (like the last example above) then it is a match if any of the patterns in
15638 the list match any of the addresses in the To: line.
15639 (It is not possible to specify two addresses that must <EM>BOTH</EM> be
15640 present for a match.
15641 It is only possible to specify that <EM>EITHER</EM> address1 <EM>OR</EM>
15642 address2 must be present.
15643 That is exactly what using a list does.)
15644 <P>
15645
15646 Some messages may be &quot;bounced&quot; to you, and will
15647 have a &quot;Resent-To:&quot; header line.
15648 If the message contains a Resent-To: line
15649 and the feature <A HREF="h_config_use_resentto"><!--#echo var="FEAT_use-resent-to-in-rules"--></A> is turned on,
15650 Alpine will look for
15651 matches to your &quot;To patterns&quot; there, and <EM>NOT</EM> in
15652 the original To: line.
15653 <P>
15654
15655 When entering a pattern, you may choose an address from your address book
15656 with the &quot;T&quot; command.
15657 <P>
15658
15659 It is possible to add a <EM>NOT</EM> to the To Pattern meaning with the
15660 &quot;!&quot; &quot;toggle NOT&quot; command.
15661 This changes the meaning of the To pattern so that it has the opposite meaning.
15662 It will be considered a match if there are no matches between the
15663 addresses in the To: line and the list of To patterns.
15664 <P>
15665 Don't make the mistake of putting the &quot;!&quot; in the data field for
15666 the pattern.
15667 For example, if you type the characters &quot;!frizzle&quot; into the To
15668 pattern, the pattern will look like:
15669 <P>
15670 <PRE>
15671  To pattern = !frizzle
15672 </PRE>
15673 <P>
15674 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
15675 In order to match messages that do not have &quot;frizzle&quot; in
15676 their To field, first type the characters &quot;frizzle&quot; followed
15677 by carriage return for the value of the To pattern, then negate it
15678 by typing the &quot;!&quot; command.
15679 It should end up looking like
15680 <P>
15681 <PRE>
15682  ! To pattern = frizzle
15683 </PRE>
15684 <P>
15685
15686 You are not limited to using the six standard header patterns that are
15687 normally shown (To, From, Sender, Cc, News, and Subject).
15688 You may add any other header to a Pattern by
15689 using the &quot;eXtraHdr&quot; command to specify a different
15690 message header line; and then the Add or Change command to fill in
15691 a pattern for the new header line, just like you would for a standard header.
15692 <P>
15693 A technicality: Since comma is the character used to separate multiple
15694 values in a pattern field, you have to escape comma with a backslash (&#92;) if
15695 you want to include a literal comma in the field.
15696 In other words, if you type a backslash followed by a comma it will
15697 be interpreted as a comma by Alpine, instead of as a separator between
15698 pattern values.
15699 All other backslashes are literal backslashes and should not be escaped.
15700 <P>
15701 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
15702 for more information on Patterns.
15703 <P>
15704 Look <A HREF="h_edit_nav_cmds">here</A>
15705 to see the available Editing and Navigation commands.
15706 <P>
15707 &lt;End of help on this topic&gt;
15708 </BODY>
15709 </HTML>
15710 ======= h_config_role_frompat =======
15711 <HTML>
15712 <HEAD>
15713 <TITLE>&quot;From:&quot; Pattern Explained</TITLE>
15714 </HEAD>
15715 <BODY>
15716 <H1>&quot;From:&quot; Pattern Explained</H1>
15717
15718 This is just like the &quot;To pattern&quot; except that it is compared with
15719 the address in the From: line of the message
15720 instead of the addresses from the To: line.
15721 See the help for the To pattern for more information on header patterns.
15722 <P>
15723 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
15724 for more information on Patterns.
15725 <P>
15726 Look <A HREF="h_edit_nav_cmds">here</A>
15727 to see the available Editing and Navigation commands.
15728 <P>
15729 &lt;End of help on this topic&gt;
15730 </BODY>
15731 </HTML>
15732 ======= h_config_role_senderpat =======
15733 <HTML>
15734 <HEAD>
15735 <TITLE>&quot;Sender:&quot; Pattern Explained</TITLE>
15736 </HEAD>
15737 <BODY>
15738 <H1>&quot;Sender:&quot; Pattern Explained</H1>
15739
15740 This is just like the &quot;To pattern&quot; except that it is compared with
15741 the address from the Sender: line of the message
15742 instead of the addresses from the To: line.
15743 See the help for the To pattern for more information on header patterns.
15744 <P>
15745 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
15746 for more information on Patterns.
15747 <P>
15748 Look <A HREF="h_edit_nav_cmds">here</A>
15749 to see the available Editing and Navigation commands.
15750 <P>
15751 &lt;End of help on this topic&gt;
15752 </BODY>
15753 </HTML>
15754 ======= h_config_role_ccpat =======
15755 <HTML>
15756 <HEAD>
15757 <TITLE>&quot;Cc:&quot; Pattern Explained</TITLE>
15758 </HEAD>
15759 <BODY>
15760 <H1>&quot;Cc:&quot; Pattern Explained</H1>
15761
15762 This is just like the &quot;To pattern&quot; except that it is compared with
15763 the addresses from the Cc: line of the message
15764 instead of the addresses from the To: line.
15765 See the help for the To pattern for more information on header patterns.
15766 <P>
15767 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
15768 for more information on Patterns.
15769 <P>
15770 Look <A HREF="h_edit_nav_cmds">here</A>
15771 to see the available Editing and Navigation commands.
15772 <P>
15773 &lt;End of help on this topic&gt;
15774 </BODY>
15775 </HTML>
15776 ======= h_config_role_recippat =======
15777 <HTML>
15778 <HEAD>
15779 <TITLE>Recipient Pattern Explained</TITLE>
15780 </HEAD>
15781 <BODY>
15782 <H1>Recipient Pattern Explained</H1>
15783
15784 This is just like the &quot;To pattern&quot; except that it is compared with
15785 the addresses from both the To: line and the Cc: line of the
15786 message instead of just the addresses from the To: line.
15787 In other words, it is considered a match if the pattern matches
15788 <EM>EITHER</EM> an address in the To: line <EM>OR</EM> an address
15789 in the Cc: line.
15790 (Notice that defining the Recipient pattern does not have the same
15791 effect as defining both the To and Cc patterns.
15792 Recipient is To <EM>OR</EM> Cc; not To <EM>AND</EM> Cc.
15793 It is equivalent to having two different rules;
15794 one with a To pattern and the other with the same Cc pattern.)
15795 <P>
15796 A technicality: Since comma is the character used to separate multiple
15797 values in a pattern field, you have to escape comma with a backslash (&#92;) if
15798 you want to include a literal comma in the field.
15799 In other words, if you type a backslash followed by a comma it will
15800 be interpreted as a comma by Alpine, instead of as a separator between
15801 pattern values.
15802 All other backslashes are literal backslashes and should not be escaped.
15803 <P>
15804 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
15805 for more information on Patterns.
15806 <P>
15807 Look <A HREF="h_edit_nav_cmds">here</A>
15808 to see the available Editing and Navigation commands.
15809 <P>
15810 &lt;End of help on this topic&gt;
15811 </BODY>
15812 </HTML>
15813 ======= h_config_role_particpat =======
15814 <HTML>
15815 <HEAD>
15816 <TITLE>Participant Pattern Explained</TITLE>
15817 </HEAD>
15818 <BODY>
15819 <H1>Participant Pattern Explained</H1>
15820
15821 This is just like the &quot;To pattern&quot; except that it is compared with
15822 the addresses from the From: line, the To: line, and the Cc: line of the
15823 message instead of just the addresses from the To: line.
15824 In other words, it is considered a match if the pattern matches
15825 <EM>EITHER</EM> an address in the From: line, <EM>OR</EM> an address
15826 in the To: line, <EM>OR</EM> an address in the Cc: line.
15827 (Notice that defining the Participant pattern does not have the same
15828 effect as defining all of the From, To, and Cc patterns.
15829 Participant is From <EM>OR</EM> To <EM>OR</EM> Cc; not
15830 From <EM>AND</EM> To <EM>AND</EM> Cc.
15831 It is equivalent to having three different rules;
15832 one with a From pattern, another with the same To pattern, and a third with
15833 the same Cc pattern.)
15834 <P>
15835 A technicality: Since comma is the character used to separate multiple
15836 values in a pattern field, you have to escape comma with a backslash (&#92;) if
15837 you want to include a literal comma in the field.
15838 In other words, if you type a backslash followed by a comma it will
15839 be interpreted as a comma by Alpine, instead of as a separator between
15840 pattern values.
15841 All other backslashes are literal backslashes and should not be escaped.
15842 <P>
15843 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
15844 for more information on Patterns.
15845 <P>
15846 Look <A HREF="h_edit_nav_cmds">here</A>
15847 to see the available Editing and Navigation commands.
15848 <P>
15849 &lt;End of help on this topic&gt;
15850 </BODY>
15851 </HTML>
15852 ======= h_config_role_newspat =======
15853 <HTML>
15854 <HEAD>
15855 <TITLE>News Pattern Explained</TITLE>
15856 </HEAD>
15857 <BODY>
15858 <H1>News Pattern Explained</H1>
15859
15860 If this pattern is non-blank, then for this rule to be considered a
15861 match, at least one of the newsgroups from
15862 the Newsgroups line of the message must match this pattern.
15863 If this pattern is a list of patterns, then at least one of the
15864 newsgroups must match at least one of the patterns.
15865 (Any other non-blank parts of the Pattern must match, too.)
15866 <P>
15867 It is possible to add a <EM>NOT</EM> to the News Pattern meaning with the
15868 &quot;!&quot; &quot;toggle NOT&quot; command.
15869 This changes the meaning of the News pattern so that it has the opposite meaning.
15870 It will be considered a match if there are no matches between the
15871 addresses in the Newsgroups: line and the list of News patterns.
15872 <P>
15873 Don't make the mistake of putting the &quot;!&quot; in the data field for
15874 the pattern.
15875 For example, if you type the characters &quot;!frizzle&quot; into the News
15876 pattern, the pattern will look like:
15877 <P>
15878 <PRE>
15879  News pattern = !frizzle
15880 </PRE>
15881 <P>
15882 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
15883 In order to match messages that do not have &quot;frizzle&quot; in
15884 their Newsgroups header, first type the characters &quot;frizzle&quot; followed
15885 by carriage return for the value of the News pattern, then negate it
15886 by typing the &quot;!&quot; command.
15887 It should end up looking like
15888 <P>
15889 <PRE>
15890  ! News pattern = frizzle
15891 </PRE>
15892 <P>
15893 A technicality: Since comma is the character used to separate multiple
15894 values in a pattern field, you have to escape comma with a backslash (&#92;) if
15895 you want to include a literal comma in the field.
15896 In other words, if you type a backslash followed by a comma it will
15897 be interpreted as a comma by Alpine, instead of as a separator between
15898 pattern values.
15899 All other backslashes are literal backslashes and should not be escaped.
15900 <P>
15901
15902 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
15903 for more information on Patterns.
15904 <P>
15905 Look <A HREF="h_edit_nav_cmds">here</A>
15906 to see the available Editing and Navigation commands.
15907 <P>
15908 &lt;End of help on this topic&gt;
15909 </BODY>
15910 </HTML>
15911 ======= h_config_role_subjpat =======
15912 <HTML>
15913 <HEAD>
15914 <TITLE>&quot;Subject:&quot; Pattern Explained</TITLE>
15915 </HEAD>
15916 <BODY>
15917 <H1>&quot;Subject:&quot; Pattern Explained</H1>
15918
15919 This is similar to the other parts of the Pattern.
15920 It is compared with
15921 the contents from the Subject of the message.
15922 <P>
15923 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
15924 for more information on Patterns.
15925 <P>
15926 It is possible to add a <EM>NOT</EM> to the Subject Pattern meaning with the
15927 &quot;!&quot; &quot;toggle NOT&quot; command.
15928 This changes the meaning of the Subject pattern so that it has the opposite meaning.
15929 It will be considered a match if there are no matches between the
15930 text in the Subject: line and the list of Subject patterns.
15931 <P>
15932
15933 If you wish to have a header pattern that is not one of the six standard
15934 header patterns, you may add it with the &quot;eXtraHdr&quot; command.
15935 <P>
15936 A technicality: Since comma is the character used to separate multiple
15937 values in a pattern field, you have to escape comma with a backslash (&#92;) if
15938 you want to include a literal comma in the field.
15939 In other words, if you type a backslash followed by a comma it will
15940 be interpreted as a comma by Alpine, instead of as a separator between
15941 pattern values.
15942 All other backslashes are literal backslashes and should not be escaped.
15943 <P>
15944 Look <A HREF="h_edit_nav_cmds">here</A>
15945 to see the available Editing and Navigation commands.
15946 <P>
15947 &lt;End of help on this topic&gt;
15948 </BODY>
15949 </HTML>
15950 ======= h_config_role_alltextpat =======
15951 <HTML>
15952 <HEAD>
15953 <TITLE>AllText Pattern Explained</TITLE>
15954 </HEAD>
15955 <BODY>
15956 <H1>AllText Pattern Explained</H1>
15957
15958 This is similar to the header patterns.
15959 Instead of comparing with text in a particular header field it
15960 is compared with all of the text in the message header and body.
15961 <P>
15962 It is possible to add a <EM>NOT</EM> to the AllText Pattern meaning with the
15963 &quot;!&quot; &quot;toggle NOT&quot; command.
15964 This changes the meaning of the AllText pattern so that it has the opposite meaning.
15965 It will be considered a match if there are no matches between the
15966 text of the message and the list of AllText patterns.
15967 <P>
15968 Don't make the mistake of putting the &quot;!&quot; in the data field for
15969 the pattern.
15970 For example, if you type the characters &quot;!frizzle&quot; into the AllText
15971 pattern, the pattern will look like:
15972 <P>
15973 <PRE>
15974  AllText pattern = !frizzle
15975 </PRE>
15976 <P>
15977 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
15978 In order to match messages that do not have &quot;frizzle&quot; in
15979 the text of the message, first type the characters &quot;frizzle&quot; followed
15980 by carriage return for the value of the AllText pattern, then negate it
15981 by typing the &quot;!&quot; command.
15982 It should end up looking like
15983 <P>
15984 <PRE>
15985  ! AllText pattern = frizzle
15986 </PRE>
15987 <P>
15988 It is possible that you may notice degraded performance when using
15989 AllText Patterns.
15990 <P>
15991 A technicality: Since comma is the character used to separate multiple
15992 values in a pattern field, you have to escape comma with a backslash (&#92;) if
15993 you want to include a literal comma in the field.
15994 In other words, if you type a backslash followed by a comma it will
15995 be interpreted as a comma by Alpine, instead of as a separator between
15996 pattern values.
15997 All other backslashes are literal backslashes and should not be escaped.
15998 <P>
15999 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16000 for more information on Patterns.
16001 <P>
16002 Look <A HREF="h_edit_nav_cmds">here</A>
16003 to see the available Editing and Navigation commands.
16004 <P>
16005 &lt;End of help on this topic&gt;
16006 </BODY>
16007 </HTML>
16008 ======= h_config_role_bodytextpat =======
16009 <HTML>
16010 <HEAD>
16011 <TITLE>BodyText Pattern Explained</TITLE>
16012 </HEAD>
16013 <BODY>
16014 <H1>BodyText Pattern Explained</H1>
16015
16016 This is similar to the header patterns.
16017 Instead of comparing with text in a particular header field it
16018 is compared with all of the text in the message body.
16019 <P>
16020 It is possible to add a <EM>NOT</EM> to the BodyText Pattern meaning with the
16021 &quot;!&quot; &quot;toggle NOT&quot; command.
16022 This changes the meaning of the BodyText pattern so that it has the opposite meaning.
16023 It will be considered a match if there are no matches between the
16024 text of the body of the message and the list of BodyText patterns.
16025 <P>
16026 Don't make the mistake of putting the &quot;!&quot; in the data field for
16027 the pattern.
16028 For example, if you type the characters &quot;!frizzle&quot; into the BodyText
16029 pattern, the pattern will look like:
16030 <P>
16031 <PRE>
16032  BdyText pattern = !frizzle
16033 </PRE>
16034 <P>
16035 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
16036 In order to match messages that do not have &quot;frizzle&quot; in
16037 their BodyText, first type the characters &quot;frizzle&quot; followed
16038 by carriage return for the value of the BodyText pattern, then negate it
16039 by typing the &quot;!&quot; command.
16040 It should end up looking like
16041 <P>
16042 <PRE>
16043  ! BodyText pattern = frizzle
16044 </PRE>
16045 <P>
16046 It is possible that you may notice degraded performance when using
16047 BodyText Patterns.
16048 <P>
16049 A technicality: Since comma is the character used to separate multiple
16050 values in a pattern field, you have to escape comma with a backslash (&#92;) if
16051 you want to include a literal comma in the field.
16052 In other words, if you type a backslash followed by a comma it will
16053 be interpreted as a comma by Alpine, instead of as a separator between
16054 pattern values.
16055 All other backslashes are literal backslashes and should not be escaped.
16056 <P>
16057 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16058 for more information on Patterns.
16059 <P>
16060 Look <A HREF="h_edit_nav_cmds">here</A>
16061 to see the available Editing and Navigation commands.
16062 <P>
16063 &lt;End of help on this topic&gt;
16064 </BODY>
16065 </HTML>
16066 ======= h_config_role_charsetpat =======
16067 <HTML>
16068 <HEAD>
16069 <TITLE>Character Set Pattern Explained</TITLE>
16070 </HEAD>
16071 <BODY>
16072 <H1>Character Set Pattern Explained</H1>
16073
16074 A message may use one or more character sets.
16075 This part of the Pattern matches messages that make use of
16076 certain specified character sets.
16077 It will be considered a match if a message uses any of the character
16078 sets in the list you give here.
16079
16080 <P>
16081 When filling in a value for this field, you may use
16082 the &quot;T&quot; command, which presents you with a large list of
16083 possible character sets to choose from.
16084 You may also just type in the name of a character set, and it need not
16085 be one that Alpine knows about.
16086
16087 <P>
16088 Besides actual character set names (for example, ISO-8859-7, KOI8-R, or
16089 GB2312) you may also use some shorthand names that Alpine provides.
16090 These names are more understandable shorthand names for sets of
16091 character set names.
16092 Two examples are &quot;Cyrillic&quot; and &quot;Greek&quot;.
16093 Selecting one of these shorthand names is equivalent to selecting all of
16094 the character sets that make up the set.
16095 You can see all of these shorthand names and the lists of character sets
16096 they stand for by typing the &quot;T&quot; command.
16097
16098 <P>
16099 For the purposes of this Pattern,
16100 Alpine will search through a message for all of the text parts and
16101 collect the character sets declared for each part.
16102 It will also look in the Subject line for a character set used there.
16103 Alpine does not actually look at the text of the message or the text
16104 of the Subject to determine if a declared character set is actually
16105 used, it looks only at the declarations themselves in the MIME part headers
16106 and in the Subject.
16107
16108 <P>
16109 It is possible to add a <EM>NOT</EM> to the Character Set Pattern meaning with the
16110 &quot;!&quot; &quot;toggle NOT&quot; command.
16111 This changes the meaning of the Character Set pattern so that
16112 it has the opposite meaning.
16113 It will be considered a match if none of the character sets in the
16114 list are used in a message.
16115 <P>
16116 Don't make the mistake of putting the &quot;!&quot; in the data field for
16117 the pattern.
16118 For example, if you type the characters &quot;!GB2312&quot; into the
16119 Character Set pattern, the pattern will look like:
16120 <P>
16121 <PRE>
16122  Charset pattern = !GB2312
16123 </PRE>
16124 <P>
16125 This means you want to match the 7 character sequence &quot;!GB2312&quot;.
16126 In order to match messages that do not have the
16127 character set &quot;GB2312&quot;
16128 set, first type the characters &quot;GB2312&quot; followed
16129 by carriage return for the value of the Character Set pattern, then negate it
16130 by typing the &quot;!&quot; command.
16131 It should end up looking like
16132 <P>
16133 <PRE>
16134  ! Charset pattern = GB2312
16135 </PRE>
16136 <P>
16137 A technicality: Since comma is the character used to separate multiple
16138 values in a pattern field, you have to escape comma with a backslash (&#92;) if
16139 you want to include a literal comma in the field.
16140 In other words, if you type a backslash followed by a comma it will
16141 be interpreted as a comma by Alpine, instead of as a separator between
16142 pattern values.
16143 All other backslashes are literal backslashes and should not be escaped.
16144 <P>
16145 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16146 for more information on Patterns.
16147 <P>
16148 Look <A HREF="h_edit_nav_cmds">here</A>
16149 to see the available Editing and Navigation commands.
16150 <P>
16151 &lt;End of help on this topic&gt;
16152 </BODY>
16153 </HTML>
16154 ======= h_config_role_keywordpat =======
16155 <HTML>
16156 <HEAD>
16157 <TITLE>Keyword Pattern Explained</TITLE>
16158 </HEAD>
16159 <BODY>
16160 <H1>Keyword Pattern Explained</H1>
16161
16162 A folder may have user-defined keywords.
16163 These are similar to the Important flag, which the user may set using the
16164 Flag command.
16165 The difference is that the Important flag is always present for each folder.
16166 User-defined keywords are picked by the user.
16167 You may add new keywords by defining them in the
16168 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in the Setup/Config screen.
16169 After you have added a potential keyword with the <!--#echo var="VAR_keywords"--> option,
16170 the Flag command may be used to set or clear the keyword on individual messages.
16171 If you have given a keyword a nickname when configuring it,
16172 that nickname may be used instead of the actual keyword.
16173
16174 <P>
16175 When filling in a value for this field, it may be easiest to use
16176 the &quot;T&quot; command, which presents you with a list of the keywords
16177 you have defined to choose from.
16178
16179 <P>
16180 This part of the Pattern matches messages with certain keywords set.
16181 It will be considered a match if a message has any of the keywords in the
16182 list set.
16183 A keyword that you have not defined using the
16184 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in the Setup/Config screen
16185 will not be a match.
16186
16187 <P>
16188 It is possible to add a <EM>NOT</EM> to the Keyword Pattern meaning with the
16189 &quot;!&quot; &quot;toggle NOT&quot; command.
16190 This changes the meaning of the Keyword pattern so that it has the opposite meaning.
16191 It will be considered a match if none of the keywords in the list are set
16192 for a message.
16193 A keyword that you have not defined using the
16194 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in the Setup/Config screen
16195 will not be a match, so a <EM>NOT</EM> of that keyword does match.
16196 <P>
16197 Don't make the mistake of putting the &quot;!&quot; in the data field for
16198 the pattern.
16199 For example, if you type the characters &quot;!frizzle&quot; into the Keyword
16200 pattern, the pattern will look like:
16201 <P>
16202 <PRE>
16203  Keyword pattern = !frizzle
16204 </PRE>
16205 <P>
16206 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
16207 In order to match messages that do not have the keyword &quot;frizzle&quot;
16208 set, first type the characters &quot;frizzle&quot; followed
16209 by carriage return for the value of the Keyword pattern, then negate it
16210 by typing the &quot;!&quot; command.
16211 It should end up looking like
16212 <P>
16213 <PRE>
16214  ! Keyword pattern = frizzle
16215 </PRE>
16216 <P>
16217 A technicality: Since comma is the character used to separate multiple
16218 values in a pattern field, you have to escape comma with a backslash (&#92;) if
16219 you want to include a literal comma in the field.
16220 In other words, if you type a backslash followed by a comma it will
16221 be interpreted as a comma by Alpine, instead of as a separator between
16222 pattern values.
16223 All other backslashes are literal backslashes and should not be escaped.
16224 <P>
16225 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16226 for more information on Patterns.
16227 <P>
16228 Look <A HREF="h_edit_nav_cmds">here</A>
16229 to see the available Editing and Navigation commands.
16230 <P>
16231 &lt;End of help on this topic&gt;
16232 </BODY>
16233 </HTML>
16234 ======= h_config_role_arbpat =======
16235 <HTML>
16236 <HEAD>
16237 <TITLE>Extra Header Patterns Explained</TITLE>
16238 </HEAD>
16239 <BODY>
16240 <H1>Extra Header Patterns Explained</H1>
16241
16242 The header patterns that come after the Participant pattern but before the
16243 AllText pattern are extra header patterns that you have added to a rule's
16244 Pattern. These are just like the other header patterns except that
16245 the contents of the particular header listed on the left hand side will
16246 be used for comparisons.
16247 <P>
16248 The &quot;eXtraHdr&quot; command may be used to add more of these
16249 header patterns to the rule you are editing.
16250 <P>
16251 The &quot;RemoveHdr&quot; command may be used to delete the highlighted
16252 extra header pattern from the rule you are editing.
16253 <P>
16254 It is possible to add a <EM>NOT</EM> to the Extra Header Pattern meaning with the
16255 &quot;!&quot; &quot;toggle NOT&quot; command.
16256 This changes the meaning of the pattern so that it has the opposite meaning.
16257 It will be considered a match if there are no matches between the
16258 text in the header line and the list of patterns.
16259 <P>
16260 Don't make the mistake of putting the &quot;!&quot; in the data field for
16261 the pattern.
16262 For example, if you type the characters &quot;!frizzle&quot; into the
16263 pattern, the pattern will look like:
16264 <P>
16265 <PRE>
16266  Xyz pattern = !frizzle
16267 </PRE>
16268 <P>
16269 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
16270 In order to match messages that do not have &quot;frizzle&quot; in
16271 their Xyz field, first type the characters &quot;frizzle&quot; followed
16272 by carriage return for the value of the pattern, then negate it
16273 by typing the &quot;!&quot; command.
16274 It should end up looking like
16275 <P>
16276 <PRE>
16277  ! Xyz pattern = frizzle
16278 </PRE>
16279
16280 <P>
16281 A technicality: Since comma is the character used to separate multiple
16282 values in a pattern field, you have to escape comma with a backslash (&#92;) if
16283 you want to include a literal comma in the field.
16284 In other words, if you type a backslash followed by a comma it will
16285 be interpreted as a comma by Alpine, instead of as a separator between
16286 pattern values.
16287 All other backslashes are literal backslashes and should not be escaped.
16288 <P>
16289 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16290 for more information on Patterns.
16291 <P>
16292 Look <A HREF="h_edit_nav_cmds">here</A>
16293 to see the available Editing and Navigation commands.
16294 <P>
16295 &lt;End of help on this topic&gt;
16296 </BODY>
16297 </HTML>
16298 ======= h_config_role_cat_cmd =======
16299 <HTML>
16300 <HEAD>
16301 <TITLE>Categorizer Command Explained</TITLE>
16302 </HEAD>
16303 <BODY>
16304 <H1>Categorizer Command Explained</H1>
16305
16306 This is a command that is run with its standard input set to the message
16307 being checked and its standard output discarded.
16308 The full directory path should be specified.
16309 The command will be run and then its exit status will be checked against
16310 the Exit Status Interval, which defaults to just the value zero.
16311 If the exit status of the command falls in the interval, it is considered
16312 a match, otherwise it is not a match.
16313 <P>
16314
16315 This option may actually be a list of commands.
16316 The first one that exists and is executable is used.
16317 That makes it possible to use the same configuration with Unix Alpine and
16318 PC-Alpine.
16319 <P>
16320
16321 If none of the commands in the list exists and is executable then the rule
16322 is <EM>not</EM> a match.
16323 If it is possible that the command may not exist, you should be careful
16324 to structure your rules so that nothing destructive
16325 happens when the command does not exist.
16326 For example, you might have a filter that filters away spam when there is
16327 a match but does nothing when there is not a match.
16328 That would cause no harm if the command didn't exist.
16329 However, if you have a filter that filters away spam when there is not
16330 a match and keeps it when there is a match, that would filter everything
16331 if the categorizer command didn't exist.
16332 <P>
16333 Here is an <A HREF="h_config_role_cat_cmd_example">example</A>
16334 setup for the bogofilter filter.
16335
16336 <P>
16337 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16338 for more information on Patterns.
16339 <P>
16340 Look <A HREF="h_edit_nav_cmds">here</A>
16341 to see the available Editing and Navigation commands.
16342 <P>
16343 &lt;End of help on this topic&gt;
16344 </BODY>
16345 </HTML>
16346 ======= h_config_role_cat_cmd_example =======
16347 <HTML>
16348 <HEAD>
16349 <TITLE>Categorizer Command Example</TITLE>
16350 </HEAD>
16351 <BODY>
16352 <H1>Categorizer Command Example</H1>
16353
16354 Bogofilter
16355 (<A HREF="http://bogofilter.sourceforge.net/">http://bogofilter.sourceforge.net/</A>)
16356 is a mail filter that attempts to classify mail as spam or
16357 non-spam using statistical analysis of the message content.
16358 When run with no arguments and a message as standard input, it exits with
16359 exit status 0 if it thinks a message is spam and 1 if it thinks
16360 it is not spam.
16361 To use bogofilter as your Categorizer Command you would simply set Command to
16362 the pathname of the bogofilter program.
16363 For example,
16364 <P>
16365 <CENTER><SAMP>Command = /usr/local/bin/bogofilter</SAMP></CENTER>
16366 <P>
16367 Exit status of zero is what you are interested in, so you'd set the
16368 Exit Status Interval to
16369 <P>
16370 <CENTER><SAMP>Exit Status Interval = (0,0)</SAMP></CENTER>
16371 <P>
16372
16373 In order to prevent downloading an entire huge message to check for spam, you
16374 might want to set the Character Limit to a few thousand characters (the
16375 assumption being that the spam will reveal itself in those characters)
16376 <P>
16377 <CENTER><SAMP>Character Limit = 50000</SAMP></CENTER>
16378 <P>
16379
16380 You would probably use bogofilter in an Alpine Filter Rule, and have the action
16381 be to move the message to a spam folder.
16382 It would usually be wise to also check the &quot;Message is Recent&quot;
16383 part of the rule so that messages are only checked when they first arrive,
16384 and to restrict the Current Folder Type to just your INBOX.
16385 The reason for checking only Recent messages is to save the time it takes
16386 to run bogofilter on each message.
16387 As an experiment, you might start out by using this in an Indexcolor Rule
16388 instead of a Filter Rule.
16389 In that case, you probably wouldn't check the Recent checkbox.
16390 <P>
16391 The use described above assumes that you are somehow maintaining bogofilter's
16392 database of words associated with spam and non-spam messages.
16393 One way to start your database would be to select a bunch of spam messages
16394 in Alpine (you might Save spam messages to a special folder or use Alpine's
16395 Select command to select several) and then Apply
16396 (<A HREF="h_config_enable_agg_ops"><!--#echo var="FEAT_enable-aggregate-command-set"--></A>)
16397 a pipe command to the spam messages.
16398 For example, you could have a shell script or an alias
16399 called <EM>this_is_spam</EM>, which would simply be the command
16400 <P>
16401 <CENTER><SAMP>bogofilter -s</SAMP></CENTER>
16402 <P>
16403
16404 It is probably best to use the pipe command's Raw Text, With Delimiter,
16405 and Free Output options,
16406 which are at the bottom of the screen when you type the pipe command.
16407 That's because bogofilter expects the raw message as input, and uses
16408 the Delimiters to tell when a new message starts.
16409 You would not need to use a separate pipe for each message, because
16410 bogofilter can handle multiple messages at once.
16411 <P>
16412 Similarly, you would select a group of non-spam messages
16413 and run them through a <EM>this_is_nonspam</EM> script
16414 that was something like
16415 <P>
16416 <CENTER><SAMP>bogofilter -n</SAMP></CENTER>
16417 <P>
16418
16419 For the more adventurous, the next step might be to automate the upkeep of
16420 the bogofilter database.
16421 It might make more sense to have bogofilter be part of the delivery process,
16422 but it is also possible to do it entirely from within Alpine.
16423 Instead of using just plain &quot;bogofilter&quot; as the Categorizer Command,
16424 the &quot;-u&quot; argument will cause bogofilter to update the database.
16425 <P>
16426 <CENTER><SAMP>Command = /usr/local/bin/bogofilter -u</SAMP></CENTER>
16427 <P>
16428 You'd want a couple more aliases or shell scripts called something like
16429 <EM>change_to_spam</EM>
16430 <P>
16431 <CENTER><SAMP>bogofilter -Ns</SAMP></CENTER>
16432 <P>
16433 and
16434 <EM>change_to_nonspam</EM>
16435 <P>
16436 <CENTER><SAMP>bogofilter -Sn</SAMP></CENTER>
16437 <P>
16438 When you run across a message in your INBOX that should have been
16439 classified as spam you would pipe it to the change_to_spam script, and
16440 when you run across a message in your spam folder that should have been
16441 left in your INBOX you would pipe it through change_to_nonspam.
16442
16443 <P>
16444 There is a technical problem with this approach.
16445 Alpine may check your filters more than once.
16446 In particular, every time you start Alpine the filters will be checked for
16447 each message.
16448 Also, if you have any filters that depend on message state (New, Deleted, etc.)
16449 then Alpine will recheck for matches in messages that have changed state
16450 at the time you close the folder and before expunging.
16451 This is usually ok.
16452 However, in this case it is a problem because the command
16453 <P>
16454 <CENTER><SAMP>Command = /usr/local/bin/bogofilter -u</SAMP></CENTER>
16455 <P>
16456 has the side effect of updating the database.
16457 So you run the risk of updating the database multiple times for a single
16458 message instead of updating it just once per message.
16459 There are some ways to work around this problem.
16460 What you need is a way to mark the message after you have run the filter.
16461 One way to mark messages is with the use of a keyword (say &quot;Bogo&quot;).
16462 Besides having the filter move the message to a spam folder, also have it
16463 set the Bogo keyword.
16464 (Note that you will have to set up the &quot;Bogo&quot; keyword in the
16465 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in Setup/Config.)
16466 This rule can only set the Bogo keyword for the messages that it matches.
16467 You will also need to add a second rule right after this one that
16468 matches all the messages that don't have the Bogo keyword set
16469 (put the keyword in the Keyword pattern and toggle
16470 the Not with the ! command)
16471 and takes the action of setting it.
16472 Then change the &quot;bogofilter -u&quot; rule so that it won't be a match
16473 (and so it won't re-run the bogofilter command) if the keyword is already
16474 set.
16475 <P>
16476 What you will end up with is a rule that runs &quot;bogofilter -u&quot;
16477 on all messages that don't have the Bogo keyword set.
16478 This will have the side effect of inserting that message in the bogofilter
16479 database, match or not.
16480 If this rule matches (it is spam), the Bogo keyword will be set and
16481 the message will be moved to a spam folder.
16482 If it does not match, the
16483 following rule will mark the message by turning on the keyword.
16484 This second rule should be a non-terminating
16485 (<A HREF="h_config_filt_opts_nonterm">Dont-Stop-Even-if-Rule-Matches</A>)
16486 rule so that it doesn't stop the filtering process before the rest of
16487 your rules are consulted.
16488
16489 <P>
16490 In summary, the first rule is something like
16491 <PRE>
16492   Nickname          = bogofilter -u rule
16493   Current Folder Type =
16494                (*) Specific
16495                    Folder = INBOX
16496
16497   ! Keyword pattern = Bogo
16498
16499   External Categorizer Commands =
16500        Command              = /usr/local/bin/bogofilter -u
16501        Exit Status Interval = (0,0)
16502        Character Limit      = <No Value Set: using "-1">  (optionally set this)
16503
16504   Filter Action =
16505        (*) Move
16506            Folder = spam
16507
16508   Set These Keywords   = Bogo
16509 </PRE>
16510 <P>
16511 and the following rule is
16512 <PRE>
16513   Nickname          = Set Bogo Keyword
16514   Current Folder Type =
16515                (*) Specific
16516                    Folder = INBOX
16517
16518   ! Keyword pattern = Bogo
16519
16520   Filter Action =
16521        (*) Just Set Message Status
16522
16523   Set These Keywords   = Bogo
16524
16525   Features =
16526       [X]  dont-stop-even-if-rule-matches
16527 </PRE>
16528 <P>
16529 If it is possible for you to insert bogofilter in the delivery process instead
16530 of having it called from Alpine you could prevent having to wait
16531 for the bogofilter processing while you read your mail.
16532 You would have bogofilter add a header to the message at the time of delivery
16533 that identified it as spam or nonspam.
16534 With this method, you could avoid using a Categorizer Command while running Alpine,
16535 and just match on the header instead.
16536 You might still want to use the scripts mentioned above to initialize the
16537 database or to re-classify wrongly classified messages.
16538
16539 <P>
16540 Finally, it isn't for the faint-hearted,
16541 but it is also possible to run bogofilter from PC-Alpine.
16542 You can install Cygwin from
16543 <A HREF="http://www.cygwin.com/">http://www.cygwin.com/</A> and
16544 then compile bogofilter in the cygwin environment, and run it from
16545 within PC-Alpine.
16546 You would end up with a Categorizer command that looked something like
16547 <P>
16548 <CENTER><SAMP>Command = C:&#92;cygwin&#92;bin&#92;bogofilter.exe -u</SAMP></CENTER>
16549 <P>
16550 Note that the &quot;.exe&quot; extension is explicit,
16551 and that the bogofilter.exe executable should be in the same directory
16552 as cygwin1.dll.
16553
16554 <P>
16555 &lt;End of help on this topic&gt;
16556 </BODY>
16557 </HTML>
16558 ======= h_config_role_cat_status =======
16559 <HTML>
16560 <HEAD>
16561 <TITLE>Exit Status Interval Explained</TITLE>
16562 </HEAD>
16563 <BODY>
16564 <H1>Exit Status Interval Explained</H1>
16565
16566 The categorizer command is run and the result is the exit status of
16567 that command.
16568 If that exit status falls in the Exit Status Interval
16569 then it is considered a match, otherwise it is not a match.
16570 Of course for the entire rule to match, it must also be checked against
16571 the other defined parts of the Pattern.
16572 <P>
16573 The Exit Status Interval defaults to the single value 0 (zero).
16574 If you define it, it should be set to something like:
16575 <P>
16576 <CENTER><SAMP>(min_exit_value,max_exit_value)</SAMP></CENTER>
16577 <P>
16578 where &quot;min_exit_value&quot; and &quot;max_exit_value&quot; are integers.
16579 The special values &quot;INF&quot; and &quot;-INF&quot; may be used for large
16580 positive and negative integers.
16581 <P>
16582 Actually, a list of intervals may be used if you wish.
16583 A list would look like
16584 <P>
16585 <CENTER><SAMP>(min_exit_value1,max_exit_value1),(min_exit_value2,max_exit_value2),...</SAMP></CENTER>
16586 <P>
16587 When there is an Exit Status Interval defined, it is a match if the exit status
16588 of the categorizer command is contained in any of the intervals.
16589 The intervals include both endpoints.
16590 <P>
16591 The default interval is
16592 <P>
16593 <CENTER><SAMP>(0,0)</SAMP></CENTER>
16594 <P>
16595 and it matches only if the command exits with exit status equal to zero.
16596
16597 <P>
16598 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16599 for more information on Patterns.
16600 <P>
16601 Look <A HREF="h_edit_nav_cmds">here</A>
16602 to see the available Editing and Navigation commands.
16603 <P>
16604 &lt;End of help on this topic&gt;
16605 </BODY>
16606 </HTML>
16607 ======= h_config_role_cat_limit =======
16608 <HTML>
16609 <HEAD>
16610 <TITLE>Character Limit Explained</TITLE>
16611 </HEAD>
16612 <BODY>
16613 <H1>Character Limit Explained</H1>
16614
16615 Setting this option makes it possible to limit how much of the message
16616 is made available to the categorizer command as input.
16617 The default value (-1) means that the entire message is fed to the
16618 command.
16619 A value of 0 (zero) means that only the headers of the message are
16620 made available.
16621 A positive integer means that the headers plus that many characters from
16622 the body of the message are passed to the categorizer.
16623
16624 <P>
16625 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16626 for more information on Patterns.
16627 <P>
16628 Look <A HREF="h_edit_nav_cmds">here</A>
16629 to see the available Editing and Navigation commands.
16630 <P>
16631 &lt;End of help on this topic&gt;
16632 </BODY>
16633 </HTML>
16634 ======= h_config_role_age =======
16635 <HTML>
16636 <HEAD>
16637 <TITLE>Age Interval Explained</TITLE>
16638 </HEAD>
16639 <BODY>
16640 <H1>Age Interval Explained</H1>
16641
16642 The Age Interval, if defined, is part of the Pattern.
16643 If you use this, it should be set to something like:
16644 <P>
16645 <CENTER><SAMP>(min_age,max_age)</SAMP></CENTER>
16646 <P>
16647 where &quot;min_age&quot; and &quot;max_age&quot; are non-negative integers.
16648 The special value &quot;INF&quot; may be used for the max value.
16649 It represents infinity.
16650 <P>
16651 In rare cases it may be useful to use the more general form of the value,
16652 which is a comma-separated list of intervals.
16653 It would look something like:
16654 <P>
16655 <CENTER><SAMP>(min_age1,max_age1),(min_age2,max_age2),...</SAMP></CENTER>
16656 <P>
16657 When there is an Age Interval defined, it is a match if the age, in days, of
16658 the message is contained in the interval.
16659 The interval includes both endpoints.
16660 If the option is set to a list of intervals then it is a match if the
16661 age of the message is contained in any of the intervals.
16662 <P>
16663 Even though this option is called Age, it isn't actually
16664 the <EM>age</EM> of the message.
16665 Instead, it is how many days ago the message arrived in one of your folders.
16666 If the current time is a little past midnight, then a message that arrived
16667 just before midnight arrived yesterday, even though the message is only
16668 a few minutes old.
16669 By default, the date being used is not the date in the Date
16670 header of the message.
16671 It is the date that the message arrived in one of your folders.
16672 When you Save a message from one folder to another that arrival date
16673 is preserved.
16674 If you would like to use the date in the Date header that is possible.
16675 Turn on the option
16676 <A HREF="h_config_filt_opts_sentdate">&quot;Use-Date-Header-For-Age&quot;</A>
16677 near the bottom of the rule definition.
16678 <P>
16679 A value of 0 is today, 1 is yesterday, 2 is the day before yesterday, and so on.
16680 The age interval
16681 <P>
16682 <CENTER><SAMP>(2,2)</SAMP></CENTER>
16683 <P>
16684 matches all messages that arrived on the day before yesterday.
16685 The interval
16686 <P>
16687 <CENTER><SAMP>(180,INF)</SAMP></CENTER>
16688 <P>
16689 matches all messages that arrived at least 180 days before today.
16690 The interval
16691 <P>
16692 <CENTER><SAMP>(0,1)</SAMP></CENTER>
16693 <P>
16694 matches all messages that arrived today or yesterday.
16695
16696 <P>
16697 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16698 for more information on Patterns.
16699 <P>
16700 Look <A HREF="h_edit_nav_cmds">here</A>
16701 to see the available Editing and Navigation commands.
16702 <P>
16703 &lt;End of help on this topic&gt;
16704 </BODY>
16705 </HTML>
16706 ======= h_config_role_size =======
16707 <HTML>
16708 <HEAD>
16709 <TITLE>Size Interval Explained</TITLE>
16710 </HEAD>
16711 <BODY>
16712 <H1>Size Interval Explained</H1>
16713
16714 The Size Interval, if defined, is part of the Pattern.
16715 If you use this, it should be set to something like:
16716 <P>
16717 <CENTER><SAMP>(min_size,max_size)</SAMP></CENTER>
16718 <P>
16719 where &quot;min_size&quot; and &quot;max_size&quot; are non-negative integers.
16720 The special value &quot;INF&quot; may be used for the max value.
16721 It represents infinity.
16722 <P>
16723 In rare cases it may be useful to use the more general form of the value,
16724 which is a comma-separated list of intervals.
16725 It would look something like:
16726 <P>
16727 <CENTER><SAMP>(min_size1,max_size1),(min_size2,max_size2),...</SAMP></CENTER>
16728 <P>
16729 When there is a Size Interval defined, it is a match if the size of
16730 the message is contained in the interval.
16731 The interval includes both endpoints.
16732 If the option is set to a list of intervals then it is a match if the
16733 size of the message is contained in any of the intervals.
16734 <P>
16735 The size interval
16736 <P>
16737 <CENTER><SAMP>(10000,50000)</SAMP></CENTER>
16738 <P>
16739 matches all messages with sizes greater than or equal to 10000, and less
16740 than or equal to 50000.
16741 The interval
16742 <P>
16743 <CENTER><SAMP>(100000,INF)</SAMP></CENTER>
16744 <P>
16745 matches all messages with sizes greater than or equal to 100000.
16746
16747 <P>
16748 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16749 for more information on Patterns.
16750 <P>
16751 Look <A HREF="h_edit_nav_cmds">here</A>
16752 to see the available Editing and Navigation commands.
16753 <P>
16754 &lt;End of help on this topic&gt;
16755 </BODY>
16756 </HTML>
16757 ======= h_config_role_scorei =======
16758 <HTML>
16759 <HEAD>
16760 <TITLE>Score Interval Explained</TITLE>
16761 </HEAD>
16762 <BODY>
16763 <H1>Score Interval Explained</H1>
16764
16765 The Score Interval, if defined, is part of the Pattern.
16766 If you use this, it should be set to something like:
16767 <P>
16768 <CENTER><SAMP>(min_score,max_score)</SAMP></CENTER>
16769 <P>
16770 where &quot;min_score&quot; and &quot;max_score&quot; are integers between
16771 -32000 and 32000.
16772 The special values &quot;-INF&quot; and &quot;INF&quot; may be used for
16773 the min and max values.
16774 These represent negative and positive infinity.
16775 <P>
16776 Actually, the value may be a list of intervals rather than just a
16777 single interval if that is useful.
16778 The elements of the list are separated by commas like:
16779 <P>
16780 <CENTER><SAMP>(min_score1,max_score1),(min_score2,max_score2),...</SAMP></CENTER>
16781 <P>
16782 When there is a Score Interval defined, it is a match if the score for
16783 the message is contained in any of the intervals.
16784 The intervals include both endpoints.
16785 The score for a message is calculated by looking at every scoring rule
16786 defined and adding up the Score Values for the rules that match the message.
16787 Scoring rules are created using the
16788 <A HREF="h_rules_score">&quot;SETUP SCORING&quot;</A> screen.
16789
16790 <P>
16791 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16792 for more information on Patterns.
16793 <P>
16794 Look <A HREF="h_edit_nav_cmds">here</A>
16795 to see the available Editing and Navigation commands.
16796 <P>
16797 &lt;End of help on this topic&gt;
16798 </BODY>
16799 </HTML>
16800 ======= h_config_role_fldr_type =======
16801 <HTML>
16802 <HEAD>
16803 <TITLE>Current Folder Type Explained</TITLE>
16804 </HEAD>
16805 <BODY>
16806 <H1>Current Folder Type Explained</H1>
16807
16808 The Current Folder Type is part of the role's Pattern.
16809 It refers to the type of the currently open folder, which is the folder
16810 you were last looking at from the MESSAGE INDEX or MESSAGE TEXT screen.
16811 In order for a role to be considered a match, the current folder must
16812 be of the type you set here.
16813 The three types &quot;Any&quot;, &quot;News&quot;, and &quot;Email&quot; are
16814 all what you might think.
16815 <P>
16816 If the Current Folder Type for a role's Pattern is set to &quot;News&quot;, for
16817 example, then
16818 that role will only be a match if the current folder is a newsgroup and
16819 the rest of the Pattern matches.
16820 The value &quot;Specific&quot; may be used when you want to limit the match
16821 to a specific folder (not just a specific type of folder), or to a list of
16822 specific folders.
16823 <P>
16824 In order to match a specific folder you Select the &quot;Specific&quot;
16825 button <EM>AND</EM> fill in
16826 the name (or list of names) of
16827 the folder in the &quot;Folder List&quot; field.
16828 If the current folder is any of the folders in the list, that is considered
16829 a match.
16830 The name of each folder in the list may be either &quot;INBOX&quot;,
16831 the technical specification
16832 of the folder (like what appears in your configuration file) or, if the
16833 folder is one of your incoming folders, it may be the nickname you've given
16834 the folder.
16835 Here are a couple samples of specific folder names:
16836 <P>
16837 <CENTER><SAMP>{monet.art.example.com}mail/art-class</SAMP></CENTER>
16838 <P>
16839 <CENTER><SAMP>{news.example.com/nntp}#news.comp.mail.pine</SAMP></CENTER>
16840 <P>
16841 The easiest way to fill in the &quot;Folder List&quot; field is to use
16842 the &quot;T&quot; command that is available when the &quot;Folder List&quot; line is
16843 highlighted, or to use the &quot;Take&quot; command with the configuration
16844 feature
16845 <A HREF="h_config_enable_role_take">&quot;<!--#echo var="FEAT_enable-rules-under-take"-->&quot;</A>
16846 turned on.
16847 Note that you won't be able to edit the &quot;Folder List&quot; line unless the
16848 Current Folder Type is set to &quot;Specific&quot;, and any value that
16849 &quot;Folder List&quot; has is ignored unless the type
16850 is set to &quot;Specific&quot;.
16851 <P>
16852 When reading a newsgroup, there may be a performance penalty
16853 incurred when collecting the information necessary to check a Pattern.
16854 For this reason, the default Current Folder Type is set to &quot;Email&quot;.
16855 <P>
16856 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16857 for more information on Patterns.
16858 <P>
16859 Look <A HREF="h_edit_nav_cmds">here</A>
16860 to see the available Editing and Navigation commands.
16861 <P>
16862 &lt;End of help on this topic&gt;
16863 </BODY>
16864 </HTML>
16865 ======= h_config_filt_rule_type =======
16866 <HTML>
16867 <HEAD>
16868 <TITLE>Filter Action Explained</TITLE>
16869 </HEAD>
16870 <BODY>
16871 <H1>Filter Action Explained</H1>
16872
16873 The Filter Action specifies the action to be taken when the Pattern is a
16874 match.
16875 It may be set to &quot;Delete&quot; &quot;Move&quot;, or
16876 &quot;Just Set Message Status&quot;.
16877 <P>
16878 If it is set to &quot;Delete&quot;, then the message that matches the
16879 Pattern will be deleted from the open folder.
16880 <P>
16881 If it is set to &quot;Move&quot;, then the name of the folder to which
16882 the matching message should be moved is given in the &quot;Folder List&quot; field on the
16883 next line of the screen.
16884 A list of folders separated by commas may be given, in which case the
16885 message will be copied to all of the folders in the list before it is
16886 deleted.
16887 <P>
16888 If it is set to neither of those two values (it is set to the value
16889 labeled &quot;Just Set Message Status&quot;) then the message status
16890 setting will happen
16891 but the message will not be deleted or moved.
16892 <P>
16893 If you are Moving a message you may also set Message Status if you wish.
16894 <P>
16895 The easiest way to fill in the &quot;Folder List&quot; field is to use
16896 the T command that is available when the &quot;Folder List&quot; line is
16897 highlighted.
16898 Note that you won't be able to edit the &quot;Folder List&quot; line unless the
16899 Filter Action is set to &quot;Move&quot;, and any value that
16900 &quot;Folder List&quot; has is ignored unless the type
16901 is set to &quot;Move&quot;.
16902 <P>
16903 There are a few tokens that may be used in the names in the Folder List.
16904 They are all related to the date on which the filtering is taking place.
16905 The tokens are words surrounded by underscores.
16906 For example, if you want your filter to move messages to a folder named
16907 <P><CENTER><SAMP>abc-year-mon</SAMP></CENTER><P>
16908 you could specify the folder as
16909 <P><CENTER><SAMP>abc-_CURYEAR_-_CURMONTHABBREV_</SAMP></CENTER><P>
16910 which would result in a file named something like
16911 <P><CENTER><SAMP>abc-2004-oct</SAMP></CENTER><P>
16912 or
16913 <P><CENTER><SAMP>abc-_CURYEAR2DIGIT_-_CURMONTH2DIGIT_</SAMP></CENTER><P>
16914 which would result in a file named something like
16915 <P><CENTER><SAMP>abc-04-10</SAMP></CENTER><P>
16916 The available tokens are listed
16917 <A HREF="h_index_tokens">here</A>.
16918 <P>
16919 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16920 for more information on Patterns.
16921 <P>
16922 Look <A HREF="h_edit_nav_cmds">here</A>
16923 to see the available Editing and Navigation commands.
16924 <P>
16925 &lt;End of help on this topic&gt;
16926 </BODY>
16927 </HTML>
16928 ======= h_config_score_fldr_type =======
16929 <HTML>
16930 <HEAD>
16931 <TITLE>Current Folder Type Explained</TITLE>
16932 </HEAD>
16933 <BODY>
16934 <H1>Current Folder Type Explained</H1>
16935
16936 The Current Folder Type is part of the scoring rule's Pattern.
16937 It refers to the type of the folder that
16938 the message being scored is in.
16939 In order for a rule to be considered a match, the current folder must
16940 be of the type you set here.
16941 The three types &quot;Any&quot;, &quot;News&quot;, and &quot;Email&quot; are
16942 all what you might think.
16943 <P>
16944 If the Current Folder Type for a Pattern is set to &quot;News&quot;, for
16945 example, then
16946 that Pattern will only match if the current folder is a newsgroup and
16947 the rest of the Pattern matches.
16948 The value &quot;Specific&quot; may be used when you want to limit the match
16949 to a specific folder (not just a specific type of folder), or to a list of
16950 specific folders.
16951 <P>
16952 In order to match a specific folder you Select the &quot;Specific&quot;
16953 button <EM>AND</EM> fill in
16954 the name (or list of names) of
16955 the folder in the &quot;Folder List&quot; field.
16956 If the current folder is any of the folders in the list, that is considered
16957 a match.
16958 The name of each folder in the list may be either &quot;INBOX&quot;, the technical specification
16959 of the folder (like what appears in your configuration file) or, if the
16960 folder is one of your incoming folders, it may be the nickname you've given
16961 the folder.
16962 Here are a couple samples of specific folder names:
16963 <P>
16964 <CENTER><SAMP>{monet.art.example.com}mail/art-class</SAMP></CENTER>
16965 <P>
16966 <CENTER><SAMP>{news.example.com/nntp}#news.comp.mail.pine</SAMP></CENTER>
16967 <P>
16968 The easiest way to fill in the &quot;Folder List&quot; field is to use
16969 the T command that is available when the &quot;Folder List&quot; line is
16970 highlighted.
16971 Note that you won't be able to edit the &quot;Folder List&quot; line unless the
16972 Current Folder Type is set to &quot;Specific&quot;, and any value that
16973 &quot;Folder List&quot; has is ignored unless the type
16974 is set to &quot;Specific&quot;.
16975 <P>
16976 When reading a newsgroup, there may be a performance penalty
16977 incurred when collecting the information necessary to check a Pattern.
16978 For this reason, the default Current Folder Type is set to &quot;Email&quot;.
16979 For example, if you have Index Line Coloring rules that have Score Intervals
16980 defined then the scores for all the visible messages will need to be calculated.
16981 If some of your Scoring rules have
16982 a Current Folder Type of
16983 &quot;Any&quot; or &quot;News&quot; this may cause the MESSAGE INDEX
16984 screen to draw more slowly when in a newsgroup.
16985 <P>
16986 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16987 for more information on Patterns.
16988 <P>
16989 Look <A HREF="h_edit_nav_cmds">here</A>
16990 to see the available Editing and Navigation commands.
16991 <P>
16992 &lt;End of help on this topic&gt;
16993 </BODY>
16994 </HTML>
16995 ======= h_config_other_fldr_type =======
16996 <HTML>
16997 <HEAD>
16998 <TITLE>Current Folder Type Explained</TITLE>
16999 </HEAD>
17000 <BODY>
17001 <H1>Current Folder Type Explained</H1>
17002
17003 The Current Folder Type is part of the rule's Pattern.
17004 It refers to the type of the folder being viewed.
17005 In order for a rule to be considered a match, the current folder must
17006 be of the type you set here.
17007 The three types &quot;Any&quot;, &quot;News&quot;, and &quot;Email&quot; are
17008 all what you might think.
17009 <P>
17010 If the Current Folder Type for a Pattern is set to &quot;News&quot;, for
17011 example, then
17012 that Pattern will only match if the current folder is a newsgroup.
17013 The value &quot;Specific&quot; may be used when you want to limit the match
17014 to a specific folder (not just a specific type of folder), or to a list of
17015 specific folders.
17016 <P>
17017 In order to match a specific folder you Select the &quot;Specific&quot;
17018 button <EM>AND</EM> fill in
17019 the name (or list of names) of
17020 the folder in the &quot;Folder List&quot; field.
17021 If the current folder is any of the folders in the list, that is considered
17022 a match.
17023 The name of each folder in the list may be either &quot;INBOX&quot;, the technical specification
17024 of the folder (like what appears in your configuration file) or, if the
17025 folder is one of your incoming folders, it may be the nickname you've given
17026 the folder.
17027 Here are a couple samples of specific folder names:
17028 <P>
17029 <CENTER><SAMP>{monet.art.example.com}mail/art-class</SAMP></CENTER>
17030 <P>
17031 <CENTER><SAMP>{news.example.com/nntp}#news.comp.mail.pine</SAMP></CENTER>
17032 <P>
17033 The easiest way to fill in the &quot;Folder List&quot; field is to use
17034 the T command that is available when the &quot;Folder List&quot; line is
17035 highlighted.
17036 Note that you won't be able to edit the &quot;Folder List&quot; line unless the
17037 Current Folder Type is set to &quot;Specific&quot;, and any value that
17038 &quot;Folder List&quot; has is ignored unless the type
17039 is set to &quot;Specific&quot;.
17040 <P>
17041 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17042 for more information on Patterns.
17043 <P>
17044 Look <A HREF="h_edit_nav_cmds">here</A>
17045 to see the available Editing and Navigation commands.
17046 <P>
17047 &lt;End of help on this topic&gt;
17048 </BODY>
17049 </HTML>
17050 ======= h_config_incol_fldr_type =======
17051 <HTML>
17052 <HEAD>
17053 <TITLE>Current Folder Type Explained</TITLE>
17054 </HEAD>
17055 <BODY>
17056 <H1>Current Folder Type Explained</H1>
17057
17058 The Current Folder Type is part of the Line Coloring rule's Pattern.
17059 It refers to the type of the folder for which the MESSAGE INDEX is
17060 being viewed.
17061 In order for a rule to be considered a match, the current folder must
17062 be of the type you set here.
17063 The three types &quot;Any&quot;, &quot;News&quot;, and &quot;Email&quot; are
17064 all what you might think.
17065 <P>
17066 If the Current Folder Type for a Pattern is set to &quot;News&quot;, for
17067 example, then
17068 that Pattern will only match if the current folder is a newsgroup and
17069 the rest of the Pattern matches.
17070 The value &quot;Specific&quot; may be used when you want to limit the match
17071 to a specific folder (not just a specific type of folder), or to a list of
17072 specific folders.
17073 <P>
17074 In order to match a specific folder you Select the &quot;Specific&quot;
17075 button <EM>AND</EM> fill in
17076 the name (or list of names) of
17077 the folder in the &quot;Folder List&quot; field.
17078 If the current folder is any of the folders in the list, that is considered
17079 a match.
17080 The name of each folder in the list may be either &quot;INBOX&quot;, the technical specification
17081 of the folder (like what appears in your configuration file) or, if the
17082 folder is one of your incoming folders, it may be the nickname you've given
17083 the folder.
17084 Here are a couple samples of specific folder names:
17085 <P>
17086 <CENTER><SAMP>{monet.art.example.com}mail/art-class</SAMP></CENTER>
17087 <P>
17088 <CENTER><SAMP>{news.example.com/nntp}#news.comp.mail.pine</SAMP></CENTER>
17089 <P>
17090 The easiest way to fill in the &quot;Folder List&quot; field is to use
17091 the T command that is available when the &quot;Folder List&quot; line is
17092 highlighted.
17093 Note that you won't be able to edit the &quot;Folder List&quot; line unless the
17094 Current Folder Type is set to &quot;Specific&quot;, and any value that
17095 &quot;Folder List&quot; has is ignored unless the type
17096 is set to &quot;Specific&quot;.
17097 <P>
17098 When reading a newsgroup, there may be a performance penalty
17099 incurred when collecting the information necessary to check a Pattern.
17100 For this reason, the default Current Folder Type is set to &quot;Email&quot;.
17101 For example, a rule with a non-Normal Index Line Color
17102 and a Current Folder Type of
17103 &quot;Any&quot; or &quot;News&quot; may cause the MESSAGE INDEX
17104 screen to draw more slowly when in a newsgroup.
17105 <P>
17106 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17107 for more information on Patterns.
17108 <P>
17109 Look <A HREF="h_edit_nav_cmds">here</A>
17110 to see the available Editing and Navigation commands.
17111 <P>
17112 &lt;End of help on this topic&gt;
17113 </BODY>
17114 </HTML>
17115 ======= h_config_filt_fldr_type =======
17116 <HTML>
17117 <HEAD>
17118 <TITLE>Current Folder Type Explained</TITLE>
17119 </HEAD>
17120 <BODY>
17121 <H1>Current Folder Type Explained</H1>
17122
17123 The Current Folder Type is part of the Filtering rule's Pattern.
17124 It refers to the type of the folder for which the filtering is being done.
17125 In order for a rule to be considered a match, the current folder must
17126 be of the type you set here.
17127 The three types &quot;Any&quot;, &quot;News&quot;, and &quot;Email&quot; are
17128 all what you might think.
17129 <P>
17130 If the Current Folder Type for a Pattern is set to &quot;News&quot;, for
17131 example, then
17132 that Pattern will only match if the current folder is a newsgroup and
17133 the rest of the Pattern matches.
17134 The value &quot;Specific&quot; may be used when you want to limit the match
17135 to a specific folder (not just a specific type of folder), or to a list of
17136 specific folders.
17137 <P>
17138 In order to match a specific folder you Select the &quot;Specific&quot;
17139 button <EM>AND</EM> fill in
17140 the name (or list of names) of
17141 the folder in the &quot;Folder List&quot; field.
17142 If the current folder is any of the folders in the list, that is considered
17143 a match.
17144 The name of each folder in the list may be either &quot;INBOX&quot;, the technical specification
17145 of the folder (like what appears in your configuration file) or, if the
17146 folder is one of your incoming folders, it may be the nickname you've given
17147 the folder.
17148 Here are a couple samples of specific folder names:
17149 <P>
17150 <CENTER><SAMP>{monet.art.example.com}mail/art-class</SAMP></CENTER>
17151 <P>
17152 <CENTER><SAMP>{news.example.com/nntp}#news.comp.mail.pine</SAMP></CENTER>
17153 <P>
17154 The easiest way to fill in the &quot;Folder List&quot; field is to use
17155 the T command that is available when the &quot;Folder List&quot; line is
17156 highlighted.
17157 Note that you won't be able to edit the &quot;Folder List&quot; line unless the
17158 Current Folder Type is set to &quot;Specific&quot;, and any value that
17159 &quot;Folder List&quot; has is ignored unless the type
17160 is set to &quot;Specific&quot;.
17161 <P>
17162 When reading a newsgroup, there may be a performance penalty
17163 incurred when collecting the information necessary to check a Pattern.
17164 For this reason, the default Current Folder Type is set to &quot;Email&quot;.
17165 For example, a rule with a Current Folder Type of either
17166 &quot;Any&quot; or &quot;News&quot; may cause the filtering to happen
17167 more slowly when opening a newsgroup.
17168 <P>
17169 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17170 for more information on Patterns.
17171 <P>
17172 Look <A HREF="h_edit_nav_cmds">here</A>
17173 to see the available Editing and Navigation commands.
17174 <P>
17175 &lt;End of help on this topic&gt;
17176 </BODY>
17177 </HTML>
17178 ======= h_config_role_stat_imp =======
17179 <HTML>
17180 <HEAD>
17181 <TITLE>Message Important Status Explained</TITLE>
17182 </HEAD>
17183 <BODY>
17184 <H1>Message Important Status Explained</H1>
17185
17186 This part of the Pattern may have one of three possible values.
17187 The default value is &quot;Don't care&quot;, which matches any message.
17188 The other two values are &quot;Yes&quot;, which means the message must be
17189 flagged &quot;Important&quot; in order to be a match; or &quot;No&quot;, which
17190 means the message must <EM>not</EM> be flagged &quot;Important&quot; in order
17191 to be a match.
17192 <P>
17193 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17194 for more information on Patterns.
17195 <P>
17196 Look <A HREF="h_edit_nav_cmds">here</A>
17197 to see the available Editing and Navigation commands.
17198 <P>
17199 &lt;End of help on this topic&gt;
17200 </BODY>
17201 </HTML>
17202 ======= h_config_role_stat_new =======
17203 <HTML>
17204 <HEAD>
17205 <TITLE>Message New Status Explained</TITLE>
17206 </HEAD>
17207 <BODY>
17208 <H1>Message New Status Explained</H1>
17209
17210 This part of the Pattern may have one of three possible values.
17211 The default value is &quot;Don't care&quot;, which matches any message.
17212 The other two values are &quot;Yes&quot;, which means the message must be
17213 &quot;New&quot; in order to be a match; or &quot;No&quot;, which
17214 means the message must <EM>not</EM> be &quot;New&quot; in order
17215 to be a match.
17216 &quot;New&quot; is the same as <EM>Unseen</EM> and not &quot;New&quot; is the
17217 same as <EM>Seen</EM>.
17218 <P>
17219 The nomenclature for New and Recent is a bit confusing:
17220 <P>
17221 New means that the message is Unseen.
17222 It could have been in your mailbox for a long time but if you haven't looked
17223 at it, it is still considered New.
17224 That matches the default Alpine index display that shows an N for such a
17225 message.
17226 <P>
17227 Recent means that the message was added to this folder since the last time
17228 you opened the folder.
17229 Alpine also shows an N by default for these types of messages.
17230 If you were to run two copies of Alpine that opened a folder one right after
17231 the other, a message would only show up as Recent in (at most) the first
17232 Alpine session.
17233 <P>
17234 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17235 for more information on Patterns.
17236 <P>
17237 Look <A HREF="h_edit_nav_cmds">here</A>
17238 to see the available Editing and Navigation commands.
17239 <P>
17240 &lt;End of help on this topic&gt;
17241 </BODY>
17242 </HTML>
17243 ======= h_config_role_stat_recent =======
17244 <HTML>
17245 <HEAD>
17246 <TITLE>Message Recent Status Explained</TITLE>
17247 </HEAD>
17248 <BODY>
17249 <H1>Message Recent Status Explained</H1>
17250
17251 This part of the Pattern may have one of three possible values.
17252 The default value is &quot;Don't care&quot;, which matches any message.
17253 The other two values are &quot;Yes&quot;, which means the message must be
17254 &quot;Recent&quot; in order to be a match; or &quot;No&quot;, which
17255 means the message must <EM>not</EM> be &quot;Recent&quot; in order
17256 to be a match.
17257 &quot;Recent&quot; means that the message was added to the folder since
17258 the last time the folder was opened.
17259 If more than one mail client has the folder opened, the message will
17260 appear to be &quot;Recent&quot; to only one of the clients.
17261 <P>
17262 The nomenclature for New and Recent is a bit confusing:
17263 <P>
17264 New means that the message is Unseen.
17265 It could have been in your mailbox for a long time but if you haven't looked
17266 at it, it is still considered New.
17267 That matches the default Alpine index display that shows an N for such a
17268 message.
17269 <P>
17270 Recent means that the message was added to this folder since the last time
17271 you opened the folder.
17272 Alpine also shows an N by default for these types of messages.
17273 If you were to run two copies of Alpine that opened a folder one right after
17274 the other, a message would only show up as Recent in (at most) the first
17275 Alpine session.
17276 <P>
17277 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17278 for more information on Patterns.
17279 <P>
17280 Look <A HREF="h_edit_nav_cmds">here</A>
17281 to see the available Editing and Navigation commands.
17282 <P>
17283 &lt;End of help on this topic&gt;
17284 </BODY>
17285 </HTML>
17286 ======= h_config_role_stat_del =======
17287 <HTML>
17288 <HEAD>
17289 <TITLE>Message Deleted Status Explained</TITLE>
17290 </HEAD>
17291 <BODY>
17292 <H1>Message Deleted Status Explained</H1>
17293
17294 This part of the Pattern may have one of three possible values.
17295 The default value is &quot;Don't care&quot;, which matches any message.
17296 The other two values are &quot;Yes&quot;, which means the message must be
17297 marked &quot;Deleted&quot; in order to be a match; or &quot;No&quot;, which
17298 means the message must <EM>not</EM> be marked &quot;Deleted&quot; in order
17299 to be a match.
17300 <P>
17301 If you are thinking of using this part of the Pattern as a way to prevent
17302 messages from being filtered more than once in a Filter Pattern,
17303 take a look at the Filter Option
17304 <A HREF="h_config_filt_opts_notdel">&quot;Move-Only-if-Not-Deleted&quot;</A>
17305 instead.
17306 It should work better than using this field since it will hide the filtered
17307 messages even if they are already Deleted.
17308 That option is at the bottom of the Filter configuration screen.
17309 <P>
17310 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17311 for more information on Patterns.
17312 <P>
17313 Look <A HREF="h_edit_nav_cmds">here</A>
17314 to see the available Editing and Navigation commands.
17315 <P>
17316 &lt;End of help on this topic&gt;
17317 </BODY>
17318 </HTML>
17319 ======= h_config_role_stat_ans =======
17320 <HTML>
17321 <HEAD>
17322 <TITLE>Message Answered Status Explained</TITLE>
17323 </HEAD>
17324 <BODY>
17325 <H1>Message Answered Status Explained</H1>
17326
17327 This part of the Pattern may have one of three possible values.
17328 The default value is &quot;Don't care&quot;, which matches any message.
17329 The other two values are &quot;Yes&quot;, which means the message must be
17330 marked &quot;Answered&quot; in order to be a match; or &quot;No&quot;, which
17331 means the message must <EM>not</EM> be marked &quot;Answered&quot; in order
17332 to be a match.
17333 <P>
17334 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17335 for more information on Patterns.
17336 <P>
17337 Look <A HREF="h_edit_nav_cmds">here</A>
17338 to see the available Editing and Navigation commands.
17339 <P>
17340 &lt;End of help on this topic&gt;
17341 </BODY>
17342 </HTML>
17343 ======= h_config_role_abookfrom =======
17344 <HTML>
17345 <HEAD>
17346 <TITLE>Address in Address Book Explained</TITLE>
17347 </HEAD>
17348 <BODY>
17349 <H1>Address in Address Book Explained</H1>
17350
17351 This option gives you a way to match messages that contain an address
17352 that is in one of your address books.
17353 Only the simple entries in your address books are searched.
17354 Address book distribution lists are ignored!
17355 <P>
17356 This part of the Pattern may have one of five possible values.
17357 The default value is &quot;Don't care&quot;, which matches any message.
17358 The value &quot;Yes, in any address book&quot; means at least one of the addresses
17359 from the message must be in at least one of your
17360 address books in order to be a match.
17361 The value &quot;No, not in any address book&quot;
17362 means none of the addresses may
17363 be in any of your address books in order to be a match.
17364 <P>
17365 The values &quot;Yes, in specific address books&quot; and
17366 &quot;No, not in any of specific address books&quot; are similar but instead
17367 of depending on all address books you are allowed to give a list of address
17368 books to look in.
17369 Usually this would be a single address book but it may be a
17370 list of address books as well.
17371 For each of these &quot;specific&quot; address book options you Select which
17372 of the Specific options you want (Yes or No) <EM>AND</EM> fill in the
17373 name (or list of names) of the address book in the
17374 &quot;Abook List&quot; field.
17375 The names to be used are those that appear in the ADDRESS BOOK LIST screen.
17376 The easiest way to fill in the Abook List field it to use
17377 the &quot;T&quot; command that is available when the &quot;Abook List&quot;
17378 line is highlighted.
17379 Note that you won't be able to edit the &quot;Abook List&quot; line unless the
17380 option is set to one of the two &quot;Specific&quot;, values.
17381 <P>
17382 The addresses from the message that are checked for are determined by the
17383 setting you have for &quot;Types of addresses to check for in address book&quot;.
17384 If you set this to &quot;From&quot; the From address from the message will
17385 be looked up in the address book.
17386 If you set it to &quot;To&quot; instead then the To addresses will be used.
17387 If any of the To addresses are in the address book then it is considered
17388 a match for &quot;Yes&quot; or not a match for &quot;No&quot;.
17389 You could set it to both From and To, in which case all of the From and To
17390 addresses are used.
17391 The &quot;Reply-To&quot; and &quot;Sender&quot; cases are a little unusual.
17392 Due to deficiencies in our tools, Reply-To uses the Reply-To address if it
17393 exists or the From address if there is no Reply-To address.
17394 Same for the Sender address.
17395 <P>
17396 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17397 for more information on Patterns.
17398 <P>
17399 Look <A HREF="h_edit_nav_cmds">here</A>
17400 to see the available Editing and Navigation commands.
17401 <P>
17402 &lt;End of help on this topic&gt;
17403 </BODY>
17404 </HTML>
17405 ======= h_config_inabook_from =======
17406 <HTML>
17407 <HEAD>
17408 <TITLE>From</TITLE>
17409 </HEAD>
17410 <BODY>
17411 <H1>From</H1>
17412
17413 Setting the From line will cause the address from the From header line
17414 of the message to be checked for in the address book.
17415 <P>
17416 &lt;End of help on this topic&gt;
17417 </BODY>
17418 </HTML>
17419 ======= h_config_inabook_replyto =======
17420 <HTML>
17421 <HEAD>
17422 <TITLE>Reply-To</TITLE>
17423 </HEAD>
17424 <BODY>
17425 <H1>Reply-To</H1>
17426
17427 Setting the Reply-To line will cause the address from the Reply-To header line
17428 of the message to be checked for in the address book.
17429 However, if there is no Reply-To header line in the message the From header
17430 line will be used instead.
17431 We understand this is dumb but we don't have an easy way around it.
17432 <P>
17433 &lt;End of help on this topic&gt;
17434 </BODY>
17435 </HTML>
17436 ======= h_config_inabook_sender =======
17437 <HTML>
17438 <HEAD>
17439 <TITLE>Sender</TITLE>
17440 </HEAD>
17441 <BODY>
17442 <H1>Sender</H1>
17443
17444 Setting the Sender line will cause the address from the Sender header line
17445 of the message to be checked for in the address book.
17446 However, if there is no Sender header line in the message the From header
17447 line will be used instead.
17448 We understand this is dumb but we don't have an easy way around it.
17449 <P>
17450 &lt;End of help on this topic&gt;
17451 </BODY>
17452 </HTML>
17453 ======= h_config_inabook_to =======
17454 <HTML>
17455 <HEAD>
17456 <TITLE>To</TITLE>
17457 </HEAD>
17458 <BODY>
17459 <H1>To</H1>
17460
17461 Setting the To line will cause the address from the To header line
17462 of the message to be checked for in the address book.
17463 <P>
17464 &lt;End of help on this topic&gt;
17465 </BODY>
17466 </HTML>
17467 ======= h_config_inabook_cc =======
17468 <HTML>
17469 <HEAD>
17470 <TITLE>CC</TITLE>
17471 </HEAD>
17472 <BODY>
17473 <H1>CC</H1>
17474
17475 Setting the CC line will cause the address from the CC header line
17476 of the message to be checked for in the address book.
17477 <P>
17478 &lt;End of help on this topic&gt;
17479 </BODY>
17480 </HTML>
17481 ======= h_config_role_stat_8bitsubj =======
17482 <HTML>
17483 <HEAD>
17484 <TITLE>Raw 8-bit in Subject Explained</TITLE>
17485 </HEAD>
17486 <BODY>
17487 <H1>Raw 8-bit in Subject Explained</H1>
17488
17489 It seems that lots of unwanted email contains unencoded 8-bit characters
17490 in the Subject.
17491 Normally, characters with the 8th bit set are not allowed in the Subject
17492 header unless they are MIME-encoded.
17493 This option gives you a way to match messages that have Subjects that
17494 contain unencoded 8-bit characters.
17495 <P>
17496 This part of the Pattern may have one of three possible values.
17497 The default value is &quot;Don't care&quot;, which matches any message.
17498 The other two values are &quot;Yes&quot;, which means the Subject of
17499 the message must contain unencoded 8-bit characters (characters with the
17500 most significant bit set)
17501 in order to be a match; or &quot;No&quot;, which
17502 means the Subject must <EM>not</EM>
17503 contain unencoded 8-bit characters in order to be a match.
17504 <P>
17505 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17506 for more information on Patterns.
17507 <P>
17508 Look <A HREF="h_edit_nav_cmds">here</A>
17509 to see the available Editing and Navigation commands.
17510 <P>
17511 &lt;End of help on this topic&gt;
17512 </BODY>
17513 </HTML>
17514 ======= h_config_role_bom =======
17515 <HTML>
17516 <HEAD>
17517 <TITLE>Beginning of Month</TITLE>
17518 </HEAD>
17519 <BODY>
17520 <H1>Beginning of Month</H1>
17521
17522 This option gives you a limited ability to take different actions depending on whether
17523 this is the first time Alpine has been run this month or not.
17524 Though it would be nice to have such an option available, this is not the
17525 same as whether or not this is the first time a paricular folder has been
17526 opened this month.
17527 If you want some action (probably Filtering) to take place in a folder each
17528 month, then you will need to be sure that the folder is opened during the
17529 first Alpine session of the month in order for this option to be helpful.
17530 <P>
17531 This part of the Pattern may have one of three possible values.
17532 The default value is &quot;Don't care&quot;, which matches any message.
17533 The other two values are &quot;Yes&quot;, which means this is the first
17534 time Alpine has been run this month;
17535 or &quot;No&quot;, which
17536 means this is not the first time Alpine has been run this month.
17537 <P>
17538 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17539 for more information on Patterns.
17540 <P>
17541 Here are some technical details.
17542 The way that Alpine decides if it is the beginning of the month or not is
17543 to compare today's date with the date stored in the
17544 <A HREF="h_config_prune_date"><!--#echo var="VAR_last-time-prune-questioned"--></A>
17545 variable in the config file.
17546 If the month of today's date is later than the month stored in the variable,
17547 then this is considered to be the first time you have run Alpine this month, and
17548 that turns the Beginning of the Month option on.
17549 <P>
17550 Look <A HREF="h_edit_nav_cmds">here</A>
17551 to see the available Editing and Navigation commands.
17552 <P>
17553 &lt;End of help on this topic&gt;
17554 </BODY>
17555 </HTML>
17556 ======= h_config_role_boy =======
17557 <HTML>
17558 <HEAD>
17559 <TITLE>Beginning of Year</TITLE>
17560 </HEAD>
17561 <BODY>
17562 <H1>Beginning of Year</H1>
17563
17564 This option gives you a limited ability to take different actions depending on whether
17565 this is the first time Alpine has been run this year or not.
17566 Though it would be nice to have such an option available, this is not the
17567 same as whether or not this is the first time a paricular folder has been
17568 opened this year.
17569 If you want some action (probably Filtering) to take place in a folder each
17570 year, then you will need to be sure that the folder is opened during the
17571 first Alpine session of the year in order for this option to be helpful.
17572 <P>
17573 This part of the Pattern may have one of three possible values.
17574 The default value is &quot;Don't care&quot;, which matches any message.
17575 The other two values are &quot;Yes&quot;, which means this is the first
17576 time Alpine has been run this year;
17577 or &quot;No&quot;, which
17578 means this is not the first time Alpine has been run this year.
17579 <P>
17580 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17581 for more information on Patterns.
17582 <P>
17583 Here are some technical details.
17584 The way that Alpine decides if it is the beginning of the year or not is
17585 to compare today's date with the date stored in the
17586 <A HREF="h_config_prune_date"><!--#echo var="VAR_last-time-prune-questioned"--></A>
17587 variable in the config file.
17588 If the year of today's date is later than the year stored in the variable,
17589 then this is considered to be the first time you have run Alpine this year, and
17590 that turns the Beginning of the Year option on.
17591 <P>
17592 Look <A HREF="h_edit_nav_cmds">here</A>
17593 to see the available Editing and Navigation commands.
17594 <P>
17595 &lt;End of help on this topic&gt;
17596 </BODY>
17597 </HTML>
17598 ======= h_config_role_inick =======
17599 <HTML>
17600 <HEAD>
17601 <TITLE>Initialize Values From Role Explained</TITLE>
17602 </HEAD>
17603 <BODY>
17604 <H1>Initialize Values From Role Explained</H1>
17605
17606 This is a power user feature.
17607 You will usually want to leave this field empty.
17608 The value of this field is the nickname of another one of your roles.
17609 The Action values from that other role
17610 are used as the initial values of the Action items for this role.
17611 If you put something in any of the action fields for this role, that will
17612 override whatever was in the corresponding field of the initializer role.
17613 <P>
17614 You might use this field if the &quot;Action&quot; part of one of your roles
17615 is something you want to use in more than one role.
17616 Instead of filling in those action values again for each role, you
17617 may give the nickname of the role where the values are filled in.
17618 It's just a shortcut way to define Role Actions.
17619 <P>
17620 Here's an example to help explain how this works.
17621 Suppose you have a role with nickname &quot;role1&quot; and role1 has
17622 (among other things)
17623 <P>
17624 <CENTER><SAMP>Set Reply-To = The Pres &lt;president@example.com&gt;</SAMP></CENTER>
17625 <P>
17626 set.
17627 If in &quot;role2&quot; you set &quot;Initialize settings using role&quot; to
17628 &quot;role1&quot;, then role2 will inherit the Set Reply-To value
17629 from role1 by default (and any of the other inheritable action values
17630 that are set).
17631 So if role2 had
17632 <P>
17633 <CENTER><SAMP>Set Reply-To = &lt;No Value Set&gt;</SAMP></CENTER>
17634 <P>
17635 defined, the Reply-To used with role2 would be &quot;The Pres &lt;president@example.com&gt;&quot;
17636 However, if role2 had
17637 <P>
17638 <CENTER><SAMP>Set Reply-To = VP &lt;vicepresident@example.com&gt;</SAMP></CENTER>
17639 <P>
17640 defined, then the Reply-To used with role2 would be &quot;VP &lt;vicepresident@example.com&gt;&quot; instead.
17641 <P>
17642 If you wish,
17643 you may choose a nickname from your list of roles by using the
17644 &quot;T&quot; command.
17645 If the role you are using to initialize also has a role it initializes from,
17646 then that initialization happens first.
17647 That is, inheritance works as expected with the grandparent and
17648 great-grandparent (and so on) roles having the expected effect.
17649 <P>
17650 Look <A HREF="h_edit_nav_cmds">here</A>
17651 to see the available Editing and Navigation commands.
17652 <P>
17653 &lt;End of help on this topic&gt;
17654 </BODY>
17655 </HTML>
17656 ======= h_config_role_setfrom =======
17657 <HTML>
17658 <HEAD>
17659 <TITLE>Set From Explained</TITLE>
17660 </HEAD>
17661 <BODY>
17662 <H1>Set From Explained</H1>
17663
17664 This describes part of the action to be taken if the Pattern for this
17665 role is a match.
17666 This field consists of a single address that will be used as the From
17667 address on the message you are sending.
17668 This should be a fully-qualified address like
17669 <P>
17670 <CENTER><SAMP>Full Name &lt;user@domain&gt;</SAMP></CENTER>
17671 <P>
17672 or just
17673 <P>
17674 <CENTER><SAMP>user@domain</SAMP></CENTER>
17675 <P>
17676 If you wish,
17677 you may choose an address from your address book with the
17678 &quot;T&quot; command.
17679 <P>
17680 If this is left blank, then your normal From address will be used.
17681 <P>
17682 You may also find it useful to add the changed From address to the
17683 <a href="h_config_alt_addresses"><!--#echo var="VAR_alt-addresses"--></a>
17684 configuration option.
17685 <P>
17686 Look <A HREF="h_edit_nav_cmds">here</A>
17687 to see the available Editing and Navigation commands.
17688 <P>
17689 &lt;End of help on this topic&gt;
17690 </BODY>
17691 </HTML>
17692 ======= h_config_role_setreplyto =======
17693 <HTML>
17694 <HEAD>
17695 <TITLE>Set Reply-To Explained</TITLE>
17696 </HEAD>
17697 <BODY>
17698 <H1>Set Reply-To Explained</H1>
17699
17700 This describes part of the action to be taken if the Pattern for this
17701 role is a match.
17702 This field consists of a single address that will be used as the Reply-To
17703 address on the message you are sending.
17704 This may be a fully-qualified address like
17705 <P>
17706 <CENTER><SAMP>Full Name &lt;user@domain&gt;</SAMP></CENTER>
17707 <P>
17708 or just
17709 <P>
17710 <CENTER><SAMP>user@domain</SAMP></CENTER>
17711 <P>
17712 If you wish,
17713 you may choose an address from your address book with the
17714 &quot;T&quot; command.
17715 <P>
17716 If this is left blank, then there won't be a Reply-To address unless
17717 you have configured one specially with the
17718 "<A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A>"
17719 configuration option.
17720 <P>
17721 Look <A HREF="h_edit_nav_cmds">here</A>
17722 to see the available Editing and Navigation commands.
17723 <P>
17724 &lt;End of help on this topic&gt;
17725 </BODY>
17726 </HTML>
17727 ======= h_config_role_setfcc =======
17728 <HTML>
17729 <HEAD>
17730 <TITLE>Set Fcc Explained</TITLE>
17731 </HEAD>
17732 <BODY>
17733 <H1>Set Fcc Explained</H1>
17734
17735 This describes part of the action to be taken if the Pattern for this
17736 role is a match.
17737 This field consists of a single folder name that will be used in
17738 the Fcc field of the message you are sending.
17739 You may put anything here that you would normally type into the Fcc
17740 field from the composer.
17741 <P>
17742 In addition, an fcc of &quot;&quot; (two double quotation marks) means
17743 no Fcc.
17744 <P>
17745 A blank field here means that Alpine will use its normal rules for deciding
17746 the default value of the Fcc field.
17747 For many roles, perhaps most, it may make more sense for you to use the
17748 other Alpine facilities for setting the Fcc.
17749 In particular, if you want the Fcc to depend on who you are sending the
17750 message to then the <A HREF="h_config_fcc_rule">&quot;<!--#echo var="VAR_fcc-name-rule"-->&quot;</A>
17751 is probably more useful.
17752 In that case, you would want to leave the Fcc field here blank.
17753 However, if you have a role that depends on who the message you are replying
17754 to was From, or what address that message was sent to;
17755 then it might make sense to set the Fcc for that role here.
17756 <P>
17757 If you wish,
17758 you may choose a folder from your folder collections by using the
17759 &quot;T&quot; command.
17760 <P>
17761 Look <A HREF="h_edit_nav_cmds">here</A>
17762 to see the available Editing and Navigation commands.
17763 <P>
17764 &lt;End of help on this topic&gt;
17765 </BODY>
17766 </HTML>
17767 ======= h_config_role_usesmtp =======
17768 <HTML>
17769 <HEAD>
17770 <TITLE>Use SMTP Server Explained</TITLE>
17771 </HEAD>
17772 <BODY>
17773 <H1>Use SMTP Server Explained</H1>
17774
17775 This describes part of the action to be taken if the Pattern for this
17776 role is a match.
17777 If this field has a value, then it will be used as the SMTP server
17778 to send mail when this role is being used (unless the SMTP server variable
17779 is set in the system-wide fixed configuration file).
17780 It has the same semantics as the
17781 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>
17782 variable in the Setup/Config screen.
17783 <P>
17784 If you are using this to post from home when you are at home and from
17785 work when you are at work you need to be careful about postponing messages.
17786 When you postpone a composition that was using a role with this variable
17787 set, the SMTP server list will be saved
17788 with the postponed composition.
17789 It cannot be changed later.
17790 Because of this, you may want to make this a list of SMTP servers
17791 with the preferred server at the front of the list and alternate servers
17792 later in the list.
17793 In your &quot;Home&quot; role you would put the home SMTP server first and
17794 the work SMTP server last.
17795 In your &quot;Work&quot; role you would put the work SMTP server first and
17796 the home SMTP server last.
17797 Then if you start a composition as &quot;Work&quot;, postpone
17798 it, and then later resume it from home the work SMTP server will fail but
17799 the home SMTP server later in the list will succeed.
17800 <P>
17801 You may be able to simplify things by making the regular
17802 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>
17803 variable in the Setup/Config screen a list instead of using roles
17804 to set the SMTP server.
17805
17806 <P>
17807 Look <A HREF="h_edit_nav_cmds">here</A>
17808 to see the available Editing and Navigation commands.
17809 <P>
17810 &lt;End of help on this topic&gt;
17811 </BODY>
17812 </HTML>
17813 ======= h_config_role_usenntp =======
17814 <HTML>
17815 <HEAD>
17816 <TITLE>Use NNTP Server Explained</TITLE>
17817 </HEAD>
17818 <BODY>
17819 <H1>Use NNTP Server Explained</H1>
17820
17821 This describes part of the action to be taken if the Pattern for this
17822 role is a match.
17823 If this field has a value, then it will be used as the NNTP server
17824 to post to newsgroups when this role is being used (unless the NNTP server
17825 variable
17826 is set in the system-wide fixed configuration file).
17827 It has the same semantics as the
17828 <A HREF="h_config_nntp_server">&quot;<!--#echo var="VAR_nntp-server"-->&quot;</A>
17829 variable in the Setup/Config screen.
17830 <P>
17831 This role setting can facilitate posting to the right nntp server for someone
17832 who reads news from various news sources.  The feature
17833 <A HREF="h_config_predict_nntp_server">&quot;<!--#echo var="FEAT_predict-nntp-server"-->&quot;</A>
17834 allows for setting the correct <!--#echo var="VAR_nntp-server"--> without having to individually
17835 set a role for that <!--#echo var="VAR_nntp-server"-->, but for greater flexibility, setting
17836 nntp servers for roles may be more desirable for some people.
17837 <P>
17838 If you are using this to post from home when you are at home and from
17839 work when you are at work you need to be careful about postponing messages.
17840 When you postpone a composition that was using a role with this variable
17841 set, the NNTP server list will be saved
17842 with the postponed composition.
17843 It cannot be changed later.
17844 Because of this, you may want to make this a list of NNTP servers
17845 with the preferred server at the front of the list and alternate servers
17846 later in the list.
17847 In your &quot;Home&quot; role you would put the home NNTP server first and
17848 the work NNTP server last.
17849 In your &quot;Work&quot; role you would put the work NNTP server first and
17850 the home NNTP server last.
17851 Then if you start a composition as &quot;Work&quot;, postpone
17852 it, and then later resume it from home the work NNTP server will fail but
17853 the home NNTP server later in the list will succeed.
17854 <P>
17855 You may be able to simplify things by making the regular
17856 <A HREF="h_config_nntp_server">&quot;<!--#echo var="VAR_nntp-server"-->&quot;</A>
17857 variable in the Setup/Config screen a list instead of using roles
17858 to set the NNTP server.
17859
17860 <P>
17861 Look <A HREF="h_edit_nav_cmds">here</A>
17862 to see the available Editing and Navigation commands.
17863 <P>
17864 &lt;End of help on this topic&gt;
17865 </BODY>
17866 </HTML>
17867 ======= h_config_role_setotherhdr =======
17868 <HTML>
17869 <HEAD>
17870 <TITLE>Set Other Headers Explained</TITLE>
17871 </HEAD>
17872 <BODY>
17873 <H1>Set Other Headers Explained</H1>
17874
17875 This describes part of the action to be taken if the Pattern for this
17876 role is a match.
17877 This field gives you a way to set values for headers besides
17878 &quot;From&quot; and &quot;Reply-To&quot;.
17879 If you want to set either of those, use the specific
17880 &quot;Set From&quot; and &quot;Set Reply-To&quot; settings above.
17881 <P>
17882 This field is similar to the
17883 "<A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A>" option.
17884 Each header you specify here must include the header tag
17885 (&quot;To:&quot;, &quot;Approved:&quot;, etc.)
17886 and may optionally include a value for that header.
17887 In order to see these headers when you compose using this role you
17888 must use the rich header
17889 <!--chtml if pinemode="function_key"-->(F5)
17890 <!--chtml else-->(Ctrl-R)<!--chtml endif--> command.
17891 Here's an example that shows how you might set the To address.
17892 <P>
17893 <CENTER><SAMP>Set Other Hdrs = To: Full Name &lt;user@domain&gt;</SAMP></CENTER>
17894 <P>
17895 Headers set in this way are different from headers set with the
17896 <!--#echo var="VAR_customized-hdrs"--> option in that the value you give for a header here
17897 will replace any value that already exists.
17898 For example, if you are Replying to a message there will already be at
17899 least one address in the To header (the address you are Replying to).
17900 However, if you Reply using a role that sets the To header, that role's
17901 To header value will be used instead.
17902 <P>
17903 Limitation: Because commas are used to separate the list of
17904 Other Headers, it is not possible to have the value of a
17905 header contain a comma;
17906 nor is there currently an &quot;escape&quot; mechanism provided
17907 to make this work.
17908 <P>
17909 Look <A HREF="h_edit_nav_cmds">here</A>
17910 to see the available Editing and Navigation commands.
17911 <P>
17912 &lt;End of help on this topic&gt;
17913 </BODY>
17914 </HTML>
17915 ======= h_config_role_setlitsig =======
17916 <HTML>
17917 <HEAD>
17918 <TITLE>Set Literal Signature Explained</TITLE>
17919 </HEAD>
17920 <BODY>
17921 <H1>Set Literal Signature Explained</H1>
17922
17923 This describes part of the action to be taken if the Pattern for this
17924 role is a match.
17925 This field contains the actual text for your signature, as opposed to
17926 the name of a file containing your signature.
17927 If this is defined it takes precedence over any value set in the
17928 &quot;Set Signature&quot; field.
17929 <P>
17930 This is simply a different way to store the signature.
17931 The signature is stored inside your Alpine configuration file instead of in
17932 a separate file.
17933 Tokens work the same way they do with
17934 <A HREF="h_config_role_setsig">Set Signature</A>, so refer to the
17935 help text there for more information.
17936 <P>
17937
17938 The two character sequence &#92;n (backslash followed by
17939 the character n) will be used to signify a line-break in your signature.
17940 You don't have to enter the &#92;n, but it will be visible in the
17941 CHANGE THIS ROLE RULE window after you are done editing the signature.
17942 <P>
17943 Look <A HREF="h_edit_nav_cmds">here</A>
17944 to see the available Editing and Navigation commands.
17945 <P>
17946 &lt;End of help on this topic&gt;
17947 </BODY>
17948 </HTML>
17949 ======= h_config_role_setsig =======
17950 <HTML>
17951 <HEAD>
17952 <TITLE>Set Signature Explained</TITLE>
17953 </HEAD>
17954 <BODY>
17955 <H1>Set Signature Explained</H1>
17956
17957 This describes part of the action to be taken if the Pattern for this
17958 role is a match.
17959 <P>
17960 If either the default <A HREF="h_config_literal_sig"><!--#echo var="VAR_literal-signature"--></A>
17961 option from Setup/Config
17962 or the &quot;Set LiteralSig&quot; option for this role are defined,
17963 then this option will be ignored.
17964 You can tell that that is the case because the value of this
17965 option will show up as
17966 <P>
17967 <CENTER><SAMP>&lt;Ignored: using LiteralSig instead&gt;</SAMP></CENTER>
17968 <P>
17969 You may either use all Literal Signatures (signatures stored in your
17970 configuration file) throughout Alpine, or all signature files.
17971 You can't mix the two.
17972 <P>
17973 This field consists of a filename that will be used as the signature
17974 file when using this role.
17975 <P>
17976 If the filename is followed by a vertical bar (|) then instead
17977 of reading the contents of the file the file is assumed to be a
17978 program that will produce the text to be used on its standard output.
17979 The program can't have any arguments and doesn't receive any input from Alpine,
17980 but the rest of the processing works as if the contents came from a file.
17981 <P>
17982 Instead of storing the data in a local file, the
17983 signature data may be stored remotely in an IMAP folder.
17984 In order to do this,
17985 you must use a remote name for the signature.
17986 A remote signature name might look like:
17987 <P>
17988 <CENTER><SAMP>{myimaphost.myschool.k12.wa.us}mail/sig3</SAMP></CENTER>
17989 <P>
17990
17991 The syntax used here is the same as the syntax used for a remote
17992 <A HREF="h_config_signature_file"><!--#echo var="VAR_signature-file"--></A>.
17993 Note that you may not access an existing signature file remotely,
17994 you have to create a new <EM>folder</EM> that contains the signature data.
17995 If the name you use here for the signature data is a remote name, then when
17996 you edit the file using the &quot;F&quot; command the data will
17997 be saved remotely in the folder.
17998 You aren't required to do anything special to create the folder, it
17999 gets created if you use a remote name.
18000
18001 <P>
18002 If you type &quot;F&quot; you may edit the contents of the file (as opposed to
18003 the name of the file) you have specified.
18004 If you type &quot;T&quot; you may use a browser to choose an existing filename.
18005 <P>
18006 Besides containing regular text, a signature file may also
18007 contain (or a signature program may produce) tokens that are replaced with text
18008 that depends on the message you are replying to or forwarding.
18009 The tokens all look like _word_ (a word surrounded by underscores).
18010 For example, if the token
18011 <P>
18012 <CENTER><SAMP>_DATE_</SAMP></CENTER>
18013 <P>
18014 is included in the text of the signature file, then when you reply to
18015 or forward a message, the token will be replaced with the actual date
18016 the message you are replying to or forwarding was sent.
18017 <P>
18018 If you use a role that has a signature file for a plain composition
18019 (that is, not a reply or forward) then there is no original message, so
18020 any tokens that depend on the message will be replaced with nothing.
18021 So if you want a signature file to be useful for new compositions it
18022 shouldn't include any of the tokens that depend on the message being
18023 replied to or forwarded.
18024 <P>
18025 The list of available tokens is
18026 <A HREF="h_index_tokens">here</A>.
18027 <P>
18028 Actually, for the adventurous, there is a way to conditionally include text based
18029 on whether or not a token would result in specific replacement text.
18030 For example, you could include some text based on whether or not
18031 the _NEWS_ token would result in any newsgroups if it was used.
18032 It's explained in detail
18033 <A HREF="h_reply_token_conditionals">here</A>.
18034 <P>
18035 In the very unlikely event that you want to include a literal token in
18036 a signature file, you must precede it with a backslash character.
18037 For example, to include the literal text _DATE_ you must actually use
18038 &#92;_DATE_.
18039 It is not possible to have a literal backslash followed by an expanded token.
18040 <P>
18041 A blank field here means that Alpine will use its normal rules for deciding
18042 which file (if any) to use for the signature file.
18043 <P>
18044 An alternate method for storing the signature is available in
18045 <A HREF="h_config_role_setlitsig">Set Literal Signature</A>.
18046 <P>
18047 Look <A HREF="h_edit_nav_cmds">here</A>
18048 to see the available Editing and Navigation commands.
18049 <P>
18050 &lt;End of help on this topic&gt;
18051 </BODY>
18052 </HTML>
18053 ======= h_config_role_settempl =======
18054 <HTML>
18055 <HEAD>
18056 <TITLE>Set Template Explained</TITLE>
18057 </HEAD>
18058 <BODY>
18059 <H1>Set Template Explained</H1>
18060
18061 This describes part of the action to be taken if the Pattern for this
18062 role is a match.
18063 This field consists of a filename that will be used as the template
18064 file when using this role.
18065 The template file is a file that is included at the top of the message you
18066 are composing.
18067 <P>
18068 If the filename is followed by a vertical bar (|) then instead
18069 of reading the contents of the file the file is assumed to be a
18070 program that will produce the text to be used on its standard output.
18071 The program can't have any arguments and doesn't receive any input from Alpine,
18072 but the rest of the processing works as if the contents came from a file.
18073 <P>
18074 Instead of storing the data in a local file, the
18075 template may be stored remotely in an IMAP folder.
18076 In order to do this,
18077 you must use a remote name for the template.
18078 A remote template name might look like:
18079 <P>
18080 <CENTER><SAMP>{myimaphost.myschool.k12.wa.us}mail/templ3</SAMP></CENTER>
18081 <P>
18082
18083 The syntax used here is the same as the syntax used for a remote
18084 <A HREF="h_config_signature_file"><!--#echo var="VAR_signature-file"--></A>.
18085 Note that you may not access an existing template file remotely,
18086 you have to create a new <EM>folder</EM> that contains the template data.
18087 If the name you use here for the template is a remote name, then when
18088 you edit the file using the &quot;F&quot; command the data will
18089 be saved remotely in the folder.
18090 You aren't required to do anything special to create the folder, it
18091 gets created if you use a remote name.
18092 <P>
18093 If you type &quot;F&quot; you may edit the contents of the file (as opposed to
18094 the name of the file) you have specified.
18095 If you type &quot;T&quot; you may use a browser to choose an existing filename.
18096 <P>
18097 Besides containing regular text, the template file may also
18098 contain (or a template file program may produce) tokens that are replaced with text
18099 that depends on the message you are replying to or forwarding.
18100 The tokens all look like _word_ (a word surrounded by underscores).
18101 For example, if the token
18102 <P>
18103 <CENTER><SAMP>_DATE_</SAMP></CENTER>
18104 <P>
18105 is included in the text of the template file, then when you reply to
18106 or forward a message, the token will be replaced with the actual date
18107 the message you are replying to or forwarding was sent.
18108 <P>
18109 If you use a role that has a template file for a plain composition
18110 (that is, not a reply or forward) then there is no original message, so
18111 any tokens that depend on the message will be replaced with nothing.
18112 So if you want a template file to be useful for new compositions it
18113 shouldn't include any of the tokens that depend on the message being
18114 replied to or forwarded.
18115 <P>
18116 The list of available tokens is
18117 <A HREF="h_index_tokens">here</A>.
18118 <P>
18119 Actually, for the adventurous, there is a way to conditionally include text based
18120 on whether or not a token would result in specific replacement text.
18121 For example, you could include some text based on whether or not
18122 the _NEWS_ token would result in any newsgroups if it was used.
18123 It's explained in detail
18124 <A HREF="h_reply_token_conditionals">here</A>.
18125 <P>
18126 In the very unlikely event that you want to include a literal token in
18127 a template file, you must precede it with a backslash character.
18128 For example, to include the literal text _DATE_ you must actually use
18129 &#92;_DATE_.
18130 It is not possible to have a literal backslash followed by an expanded token.
18131 <P>
18132 A blank template field means that Alpine will not use a template file when
18133 this role is being used.
18134 <P>
18135 Look <A HREF="h_edit_nav_cmds">here</A>
18136 to see the available Editing and Navigation commands.
18137 <P>
18138 &lt;End of help on this topic&gt;
18139 </BODY>
18140 </HTML>
18141 ======= h_config_filt_stat_imp =======
18142 <HTML>
18143 <HEAD>
18144 <TITLE>Set Important Status Explained</TITLE>
18145 </HEAD>
18146 <BODY>
18147 <H1>Set Important Status Explained</H1>
18148
18149 This describes part of the action to be taken if the Pattern for this
18150 filter is a match.
18151 If set to &quot;Don't change it&quot; then this does nothing.
18152 If set to &quot;Set this state&quot; then the Important flag is set
18153 for the matching message.
18154 If set to &quot;Clear this state&quot; then the Important flag is cleared
18155 for the matching message.
18156 The important flag usually causes an asterisk to show up in the MESSAGE
18157 INDEX.
18158 It may also be useful when selecting a set of messages
18159 with the Select command.
18160 <P>
18161 Look <A HREF="h_edit_nav_cmds">here</A>
18162 to see the available Editing and Navigation commands.
18163 <P>
18164 &lt;End of help on this topic&gt;
18165 </BODY>
18166 </HTML>
18167 ======= h_config_filt_stat_new =======
18168 <HTML>
18169 <HEAD>
18170 <TITLE>Set New Status Explained</TITLE>
18171 </HEAD>
18172 <BODY>
18173 <H1>Set New Status Explained</H1>
18174
18175 This describes part of the action to be taken if the Pattern for this
18176 filter is a match.
18177 If set to &quot;Don't change it&quot; then this does nothing.
18178 If set to &quot;Set this state&quot; then the
18179 matching message is marked New.
18180 If set to &quot;Clear this state&quot; then the
18181 matching message is marked Seen.
18182 <P>
18183 Look <A HREF="h_edit_nav_cmds">here</A>
18184 to see the available Editing and Navigation commands.
18185 <P>
18186 &lt;End of help on this topic&gt;
18187 </BODY>
18188 </HTML>
18189 ======= h_config_filt_stat_ans =======
18190 <HTML>
18191 <HEAD>
18192 <TITLE>Set Answered Status Explained</TITLE>
18193 </HEAD>
18194 <BODY>
18195 <H1>Set Answered Status Explained</H1>
18196
18197 This describes part of the action to be taken if the Pattern for this
18198 filter is a match.
18199 If set to &quot;Don't change it&quot; then this does nothing.
18200 If set to &quot;Set this state&quot; then the Answered flag is set
18201 for the matching message.
18202 If set to &quot;Clear this state&quot; then the Answered flag is cleared
18203 for the matching message.
18204 <P>
18205 Look <A HREF="h_edit_nav_cmds">here</A>
18206 to see the available Editing and Navigation commands.
18207 <P>
18208 &lt;End of help on this topic&gt;
18209 </BODY>
18210 </HTML>
18211 ======= h_config_filt_stat_del =======
18212 <HTML>
18213 <HEAD>
18214 <TITLE>Set Deleted Status Explained</TITLE>
18215 </HEAD>
18216 <BODY>
18217 <H1>Set Deleted Status Explained</H1>
18218
18219 This describes part of the action to be taken if the Pattern for this
18220 filter is a match.
18221 If set to &quot;Don't change it&quot; then this does nothing.
18222 If set to &quot;Set this state&quot; then the
18223 matching message is marked Deleted.
18224 If set to &quot;Clear this state&quot; then the
18225 matching message is marked UnDeleted.
18226 <P>
18227 You should not use this option unless you are prepared to have matching
18228 messages expunged from the folder permanently.
18229 For example, if you type the Expunge command, this filter is applied
18230 before the expunge, so matching messages will be marked Deleted and then
18231 will be permanently expunged from the folder.
18232 However, since the index isn't redrawn in between the time that the message
18233 is marked Deleted and the time that you are asked to expunge, the only
18234 indication that you are expunging the message comes in the number of messages
18235 being expunged.
18236 The same thing may happen when you close a folder.
18237 It is also possible that an expunge not initiated by you will
18238 delete matching messages.
18239 <P>
18240 Look <A HREF="h_edit_nav_cmds">here</A>
18241 to see the available Editing and Navigation commands.
18242 <P>
18243 &lt;End of help on this topic&gt;
18244 </BODY>
18245 </HTML>
18246 ======= h_config_role_scoreval =======
18247 <HTML>
18248 <HEAD>
18249 <TITLE>Score Value Explained</TITLE>
18250 </HEAD>
18251 <BODY>
18252 <H1>Score Value Explained</H1>
18253
18254 A message's score is the sum of the Score Values from all of the Scoring rules
18255 with Patterns that match the message.
18256 The value you give here is the Score Value associated with this rule.
18257 A Score Value is an integer between -100 and 100, with the default
18258 value of zero.
18259 <P>
18260 Alternatively, if the
18261 <A HREF="h_config_role_scorehdrtok">&quot;Score From Header&quot;</A>
18262 field is defined
18263 (on the line right below the &quot;Score Value&quot; field)
18264 then the &quot;Score Value&quot; is ignored and
18265 the &quot;Score From Header&quot; field is used instead.
18266 <P>
18267 Look <A HREF="h_edit_nav_cmds">here</A>
18268 to see the available Editing and Navigation commands.
18269 <P>
18270 &lt;End of help on this topic&gt;
18271 </BODY>
18272 </HTML>
18273 ======= h_config_role_scorehdrtok =======
18274 <HTML>
18275 <HEAD>
18276 <TITLE>Score Value From Header Explained</TITLE>
18277 </HEAD>
18278 <BODY>
18279 <H1>Score Value From Header Explained</H1>
18280
18281 This option provides a way to use a number that appears in the headers of your
18282 messages as the message's score, or as a component of that score.
18283 If this field is defined then it is used instead of the &quot;Score Value&quot;.
18284 The idea behind this option is that there may be a score embedded in the
18285 headers of messages that has already been calculated outside of Alpine.
18286 For example, messages delivered to you may contain an &quot;X-Spam&quot; header and
18287 somewhere in that header there is a score.
18288 <P>
18289 The value for this option is the name of the header followed by parentheses
18290 with two arguments inside:
18291 <P>
18292 <CENTER><SAMP>HeaderName(field_number,field_separators)</SAMP></CENTER>
18293 <P>
18294 No space is allowed between the comma and the start of the field_separators.
18295 It would be interpreted as the first separator if it was there.
18296 Field 0 is the whole line, Field 1 is the data up to the first separator, Field 2
18297 starts after that and goes to the second separator, and so on.
18298 It's easier to explain with examples.
18299 <P>
18300 <CENTER><SAMP>X-Spam(2,&quot;&nbsp;&quot;)</SAMP></CENTER>
18301 <P>
18302 In the above example the header that is used is the &quot;X-Spam&quot; header.
18303 The value of that header (the part after the colon and the space) is split
18304 into fields separated by spaces.
18305 <P>
18306 <CENTER><SAMP>Field1 &lt;space&gt; Field2 &lt;space&gt; Field3 ...</SAMP></CENTER>
18307 <P>
18308 The second field is selected and converted to an integer. It only makes sense
18309 if Field2 really is an integer.
18310 <P>
18311 Here's an example of a SpamAssassin header.
18312 The exact look of the header will vary, but if your incoming mail
18313 contains headers that look like the following
18314 <P>
18315 <CENTER><SAMP>X-Spam-Status: Yes, hits=10.6 tagged_above=-999.0 required=7.0 tests=BAYE...</SAMP></CENTER>
18316 <P>
18317 you might want to use the hits value as a score.
18318 Since the score is an integer value you can't make use of the decimal part of
18319 the number, but
18320 you might split off the hits=10 part as a score by using the characters &quot;=&quot;
18321 and &quot;.&quot; as your separators.
18322 <P>
18323 <CENTER><SAMP>X-Spam-Status(2,&quot;=.&quot;)</SAMP></CENTER>
18324 <P>
18325 The first field starts with the Y in Yes and goes until the &quot;=&quot; after
18326 hits.
18327 The second field is &quot;10&quot; so the score value would be 10.
18328 <P>
18329 Another example we've seen has headers that look like
18330 <P>
18331 <CENTER><SAMP>X-Spam: Gauge=IIIIIII, Probability=7%, Report=...</SAMP></CENTER>
18332 <P>
18333 Because there are two equals before the 7% the value
18334 <P>
18335 <CENTER><SAMP>X-Spam(3,&quot;=%&quot;)</SAMP></CENTER>
18336 <P>
18337 should capture the probability as the score.
18338 <P>
18339 The Score From Header scoring value actually works just like the
18340 regular Score Value in that the rest of the pattern has to match before
18341 it is used and the scores from all the different scoring rules that
18342 match for a particular message are added together.
18343 When using the Score From Header method it may (or may not) make sense to
18344 use only a single scoring rule with a pattern that matches every message.
18345 <P>
18346 Look <A HREF="h_edit_nav_cmds">here</A>
18347 to see the available Editing and Navigation commands.
18348 <P>
18349 &lt;End of help on this topic&gt;
18350 </BODY>
18351 </HTML>
18352 ======= h_config_role_replyuse =======
18353 <HTML>
18354 <HEAD>
18355 <TITLE>Reply Use Explained</TITLE>
18356 </HEAD>
18357 <BODY>
18358 <H1>Reply Use Explained</H1>
18359
18360 This option determines how this particular role will be used when Replying
18361 to a message.
18362 There are three possible values for this option.
18363 The value &quot;Never&quot;
18364 means that this role will not be a candidate for use when Replying.
18365 The role's Pattern will not be checked for a match, however the role will
18366 be available to be manually switched to if there is a confirmation prompt.
18367 <P>
18368
18369 The options &quot;With confirmation&quot; and &quot;Without confirmation&quot;
18370 mean that you do want to consider this role when Replying.
18371 For either of these settings, the role's Pattern will be compared with
18372 the message being replied to.
18373 If there is a match then this role will either be used without confirmation
18374 or will be the default when confirmation is asked for, depending on
18375 which of the two options is selected.
18376 If confirmation is requested, you will also have a chance to
18377 manually change the role to any one of your other roles.
18378 <P>
18379
18380 You won't be prompted for confirmation if none of your role Patterns
18381 match the message being replied to.
18382 This is independent of the value of the current option.
18383 The <A HREF="h_config_confirm_role"><!--#echo var="FEAT_confirm-role-even-for-default"--></A>
18384 feature may be used to change this behavior.
18385 <P>
18386 &lt;End of help on this topic&gt;
18387 </BODY>
18388 </HTML>
18389 ======= h_config_role_forwarduse =======
18390 <HTML>
18391 <HEAD>
18392 <TITLE>Forward Use Explained</TITLE>
18393 </HEAD>
18394 <BODY>
18395 <H1>Forward Use Explained</H1>
18396
18397 This option determines how this particular role will be used when Forwarding
18398 a message.
18399 There are three possible values for this option.
18400 The value &quot;Never&quot;
18401 means that this role will not be a candidate for use when Forwarding.
18402 The role's Pattern will not be checked for a match, however the role will
18403 be available to be manually switched to if there is a confirmation prompt.
18404 <P>
18405
18406 The options &quot;With confirmation&quot; and &quot;Without confirmation&quot;
18407 mean that you do want to consider this role when Forwarding.
18408 For either of these settings, the role's Pattern will be compared with
18409 the message being forwarded.
18410 If there is a match then this role will either be used without confirmation
18411 or will be the default when confirmation is asked for, depending on
18412 which of the two options is selected.
18413 If confirmation is requested, you will also have a chance to
18414 manually change the role to any one of your other roles.
18415 <P>
18416
18417 You won't be prompted for confirmation if none of your role Patterns
18418 match the message being forwarded.
18419 This is independent of the value of the current option.
18420 The <A HREF="h_config_confirm_role"><!--#echo var="FEAT_confirm-role-even-for-default"--></A>
18421 feature may be used to change this behavior.
18422 <P>
18423 &lt;End of help on this topic&gt;
18424 </BODY>
18425 </HTML>
18426 ======= h_config_role_composeuse =======
18427 <HTML>
18428 <HEAD>
18429 <TITLE>Compose Use Explained</TITLE>
18430 </HEAD>
18431 <BODY>
18432 <H1>Compose Use Explained</H1>
18433
18434 This option determines how this particular role will be used when Composing
18435 a new message using the &quot;Compose&quot; command.
18436 This does not affect what happens when using the &quot;Role&quot; command
18437 to compose a new message.
18438 The &quot;Role&quot; command allows you to select a role from all of the
18439 roles you have defined, regardless of what Uses you've assigned to those
18440 roles.
18441 <P>
18442
18443 There are three possible values for this option.
18444 The value &quot;Never&quot;
18445 means that this role will not be a candidate for use when Composing.
18446 The role's Current Folder Type will not be checked for a match, however the role
18447 will be available to be manually switched to if there is a confirmation prompt.
18448 <P>
18449
18450 The options &quot;With confirmation&quot; and &quot;Without confirmation&quot;
18451 mean that you do want to consider this role when Composing.
18452 For either of these settings,
18453 the role's Current Folder Type will be checked (since there is no message
18454 to compare with, the rest of the Pattern is considered a match).
18455 If there is a match then this role will either be used without confirmation
18456 or will be the default when confirmation is asked for, depending on
18457 which of the two options is selected.
18458 If confirmation is requested, you will also have a chance to
18459 manually change the role to any one of your other roles.
18460 <P>
18461
18462 When using the Compose command the role checking is a little different
18463 because there is no message being replied to or forwarded.
18464 Because of this the Current Folder Type is checked but the header pattern
18465 fields, the AllText pattern, the BodyText pattern, and the Score Interval are all ignored.
18466 A role is considered to be a match if it is a candidate for Compose Use and
18467 its Current Folder Type matches the currently open folder.
18468 This could be useful if you want to set a role based on the folder you
18469 are reading, or the type of folder you are reading.
18470 <P>
18471
18472 You won't be prompted for confirmation if none of your role Patterns
18473 are a match.
18474 This is independent of the value of the current option.
18475 The <A HREF="h_config_confirm_role"><!--#echo var="FEAT_confirm-role-even-for-default"--></A>
18476 feature may be used to change this behavior.
18477 <P>
18478 &lt;End of help on this topic&gt;
18479 </BODY>
18480 </HTML>
18481 ======= h_config_filter_folder =======
18482 <HTML>
18483 <HEAD>
18484 <TITLE>Filter Folder Explained</TITLE>
18485 </HEAD>
18486 <BODY>
18487 <H1>Filter Folder Explained</H1>
18488
18489 When the Filter Action is set to &quot;Move&quot;,
18490 the folder or folders specified here will be used to store messages matching
18491 the provided pattern.
18492
18493 <P>
18494 If you set the Filter Action to &quot;Move&quot; you must give a folder name
18495 here.
18496
18497 <P>
18498 If you wish,
18499 you may choose a folder from your folder collections by using the
18500 &quot;T&quot; command.
18501 <P>
18502 Besides regular text, the folder name may also contain
18503 tokens that are replaced with text representing the current date
18504 when you run Alpine.
18505 For example, if the folder name you use is
18506 <P>
18507 <CENTER><SAMP>abc-_CURYEAR_-_CURMONTHABBREV_</SAMP></CENTER>
18508 <P>
18509 that is replaced with something like
18510 <P>
18511 <CENTER><SAMP>abc-2004-oct</SAMP></CENTER>
18512 <P>
18513 Or,
18514 <P>
18515 <CENTER><SAMP>abc-_CURYEAR2DIGIT_-_CURMONTH2DIGIT_</SAMP></CENTER>
18516 <P>
18517 becomes
18518 <P>
18519 <CENTER><SAMP>abc-04-10</SAMP></CENTER>
18520 <P>
18521 The token names must be surrounded by underscores in order to be recognized
18522 as tokens.
18523 The tokens that may be used are those that are derived from the current date.
18524 They're listed near the bottom of the list of tokens give
18525 <A HREF="h_index_tokens">here</A>.
18526 <P>
18527 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18528 for more information on Patterns.
18529 <P>
18530 Look <A HREF="h_edit_nav_cmds">here</A>
18531 to see the available Editing and Navigation commands.
18532 <P>
18533 &lt;End of help on this topic&gt;
18534 </BODY>
18535 </HTML>
18536 ======= h_config_filter_kw_set =======
18537 <HTML>
18538 <HEAD>
18539 <TITLE>Set These Keywords Explained</TITLE>
18540 </HEAD>
18541 <BODY>
18542 <H1>Set These Keywords Explained</H1>
18543
18544 This describes part of the action to be taken if the Pattern for this
18545 filter is a match.
18546 Read a little about keywords in the help text for the
18547 <A HREF="h_common_flag">Flag</A> command.
18548 This option is a list of keywords that will be Set when there is a match.
18549 If you wish, you may choose keywords from the list of keywords you have
18550 defined with the &quot;T&quot; command.
18551 You may add new keywords by defining them in the
18552 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in the Setup/Config screen.
18553 If you have given a keyword a nickname when configuring it,
18554 that nickname may be used instead of the actual keyword.
18555
18556 <P>
18557 Look <A HREF="h_edit_nav_cmds">here</A>
18558 to see the available Editing and Navigation commands.
18559 <P>
18560 &lt;End of help on this topic&gt;
18561 </BODY>
18562 </HTML>
18563 ======= h_config_filter_kw_clr =======
18564 <HTML>
18565 <HEAD>
18566 <TITLE>Clear These Keywords Explained</TITLE>
18567 </HEAD>
18568 <BODY>
18569 <H1>Clear These Keywords Explained</H1>
18570
18571 This describes part of the action to be taken if the Pattern for this
18572 filter is a match.
18573 Read a little about keywords in the help text for the
18574 <A HREF="h_common_flag">Flag</A> command.
18575 This option is a list of keywords that will be Cleared when there is a match.
18576 If you wish, you may choose keywords from the list of keywords you have
18577 defined with the &quot;T&quot; command.
18578 You may add new keywords by defining them in the
18579 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in the Setup/Config screen.
18580 If you have given a keyword a nickname when configuring it,
18581 that nickname may be used instead of the actual keyword.
18582
18583 <P>
18584 Look <A HREF="h_edit_nav_cmds">here</A>
18585 to see the available Editing and Navigation commands.
18586 <P>
18587 &lt;End of help on this topic&gt;
18588 </BODY>
18589 </HTML>
18590 ======= h_index_tokens =======
18591 <HTML>
18592 <HEAD>
18593 <TITLE>Tokens for Index and Replying</TITLE>
18594 </HEAD>
18595 <BODY>
18596
18597 This set of special tokens may be used in the
18598 <A HREF="h_config_index_format">&quot;<!--#echo var="VAR_index-format"-->&quot;</A> option,
18599 in the <A HREF="h_config_reply_intro">&quot;<!--#echo var="VAR_reply-leadin"-->&quot;</A> option,
18600 in signature files,
18601 in template files used in
18602 <A HREF="h_rules_roles">&quot;roles&quot;</A>, and in the folder name
18603 that is the target of a Filter Rule.
18604 Some of them aren't available in all situations.
18605 <P>
18606 The tokens are used as they appear below for the &quot;<!--#echo var="VAR_index-format"-->&quot;
18607 option, but they must be surrounded by underscores for the
18608 &quot;<!--#echo var="VAR_reply-leadin"-->&quot; option, in signature and template files,
18609 and in the target of Filter Rules.
18610 <P>
18611 <P>
18612
18613 <H1><EM>Tokens Available for all Cases (except Filter Rules)</EM></H1>
18614
18615 <DL>
18616 <DT>SUBJECT</DT>
18617 <DD>
18618 This token represents the Subject the sender gave the message.
18619 Alternatives for use in the index screen are
18620 SUBJKEY, SUBJKEYINIT, SUBJECTTEXT, SUBJKEYTEXT, and SUBJKEYINITTEXT.
18621 You may color the subject text in the MESSAGE INDEX screen differently by using the
18622 <A HREF="h_config_index_subject_color">Index Subject Color</A> and the
18623 <A HREF="h_config_index_opening_color">Index Opening Color</A>
18624 options available from
18625 the <A HREF="h_color_setup">Setup Kolor</A> screen.
18626 </DD>
18627
18628 <DT>FROM</DT>
18629 <DD>
18630 This token represents the personal name (or email address if the name
18631 is unavailable) of the person specified in the message's &quot;From:&quot;
18632 header field.
18633 You may color the from text in the MESSAGE INDEX screen differently by using the
18634 <A HREF="h_config_index_from_color">Index From Color</A>
18635 option available from
18636 the <A HREF="h_color_setup">Setup Kolor</A> screen.
18637 </DD>
18638
18639 <DT>ADDRESS</DT>
18640 <DD>
18641 This is similar to the &quot;FROM&quot; token, only it is always the
18642 email address, never the personal name.
18643 For example, &quot;mailbox@domain&quot;.
18644 </DD>
18645
18646 <DT>MAILBOX</DT>
18647 <DD>
18648 This is the same as the &quot;ADDRESS&quot; except that the
18649 domain part of the address is left off.
18650 For example, &quot;mailbox&quot;.
18651 </DD>
18652
18653 <DT>SENDER</DT>
18654 <DD>
18655 This token represents the personal name (or email address) of the person
18656 listed in the message's &quot;Sender:&quot; header field.
18657 </DD>
18658
18659 <DT>TO</DT>
18660 <DD>
18661 This token represents the personal names (or email addresses if the names
18662 are unavailable) of the persons specified in the
18663 message's &quot;To:&quot; header field.
18664 </DD>
18665
18666 <DT>NEWSANDTO</DT>
18667 <DD>
18668 This token represents the newsgroups from the
18669 message's &quot;Newsgroups:&quot; header field <EM>and</EM>
18670 the personal names (or email addresses if the names
18671 are unavailable) of the persons specified in the
18672 message's &quot;To:&quot; header field.
18673 </DD>
18674
18675 <DT>TOANDNEWS</DT>
18676 <DD>
18677 Same as &quot;NEWSANDTO&quot; except in the opposite order.
18678 </DD>
18679
18680 <DT>NEWS</DT>
18681 <DD>
18682 This token represents the newsgroups from the
18683 message's &quot;Newsgroups:&quot; header field.
18684 </DD>
18685
18686 <DT>CC</DT>
18687 <DD>
18688 This token represents the personal names (or email addresses if the names
18689 are unavailable) of the persons specified in the
18690 message's &quot;Cc:&quot; header field.
18691 </DD>
18692
18693 <DT>RECIPS</DT>
18694 <DD>
18695 This token represents the personal names (or email addresses if the names
18696 are unavailable) of the persons specified in both the
18697 message's &quot;To:&quot; header field and
18698 the message's &quot;Cc:&quot; header field.
18699 </DD>
18700
18701 <DT>NEWSANDRECIPS</DT>
18702 <DD>
18703 This token represents the newsgroups from the
18704 message's &quot;Newsgroups:&quot; header field <EM>and</EM>
18705 the personal names (or email addresses if the names
18706 are unavailable) of the persons specified in the
18707 message's &quot;To:&quot; and &quot;Cc:&quot; header fields.
18708 </DD>
18709
18710 <DT>RECIPSANDNEWS</DT>
18711 <DD>
18712 Same as &quot;NEWSANDRECIPS&quot; except in the opposite order.
18713 </DD>
18714
18715 <DT>INIT</DT>
18716 <DD>
18717 This token represents the initials from the personal name
18718 of the person specified in the message's &quot;From:&quot;
18719 header field.
18720 If there is no personal name, it is blank.
18721 </DD>
18722
18723 <DT>DATE</DT>
18724 <DD>
18725 This token represents the date on which the message was sent, according
18726 to the &quot;Date&quot; header field.
18727 It has the format MMM DD. For example, &quot;Oct 23&quot;.
18728 The feature
18729 <A HREF="h_config_dates_to_local"><!--#echo var="FEAT_convert-dates-to-localtime"--></A>,
18730 which adjusts for the timezone the message was sent from,
18731 may have an effect on the value of this token as well as the values of
18732 all of the other DATE or TIME tokens.
18733 Some of the DATE and TIME tokens are displayed in a locale-specific
18734 way unless the option
18735 <A HREF="h_config_disable_index_locale_dates"><!--#echo var="FEAT_disable-index-locale-dates"--></A> is set.
18736 </DD>
18737
18738 <DT>SMARTDATE</DT>
18739 <DD>
18740 This token represents the date on which the message was sent, according
18741 to the &quot;Date&quot; header field.
18742 It is &quot;Today&quot; if the message was sent today,
18743 &quot;Yesterday&quot; for yesterday,
18744 &quot;Wednesday&quot; if it was last Wednesday, and so on. If the
18745 message is from last year and is more than six months old it includes the year, as well.
18746 See the SMARTDATE alternatives below, as well.
18747 </DD>
18748
18749 <DT>SMARTTIME</DT>
18750 <DD>
18751 This token represents the most relevant elements of the date on which
18752 the message was sent (according to the &quot;Date&quot; header field),
18753 in a compact form. If the message was sent today, only the time is used
18754 (e.g. &quot;9:22am&quot;, &quot;10:07pm&quot;); if it was sent during
18755 the past week, the day of the week and the hour are used
18756 (e.g. &quot;Wed09am&quot;, &quot;Thu10pm&quot;); other dates are
18757 given as date, month, and year (e.g. &quot;23Aug00&quot;,
18758 &quot;9Apr98&quot;).
18759 </DD>
18760
18761 <DT>SMARTDATETIME</DT>
18762 <DD>
18763 This is a combination of SMARTDATE and SMARTTIME.
18764 It is SMARTDATE unless the SMARTDATE value is &quot;Today&quot;, in which
18765 case it is SMARTTIME.
18766 See the SMARTDATETIME alternatives below, as well.
18767 </DD>
18768
18769 <DT>DATEISO</DT>
18770 <DD>
18771 This token represents the date on which the message was sent, according
18772 to the &quot;Date&quot; header field.
18773 It has the format YYYY-MM-DD. For example, &quot;1998-10-23&quot;.
18774 </DD>
18775
18776 <DT>SHORTDATEISO</DT>
18777 <DD>
18778 This token represents the date on which the message was sent, according
18779 to the &quot;Date&quot; header field.
18780 It has the format YY-MM-DD. For example, &quot;98-10-23&quot;.
18781 </DD>
18782
18783 <DT>SHORTDATE1</DT>
18784 <DD>
18785 This token represents the date on which the message was sent, according
18786 to the &quot;Date&quot; header field.
18787 It has the format MM/DD/YY. For example, &quot;10/23/98&quot;.
18788 </DD>
18789
18790 <DT>SHORTDATE2</DT>
18791 <DD>
18792 This token represents the date on which the message was sent, according
18793 to the &quot;Date&quot; header field.
18794 It has the format DD/MM/YY. For example, &quot;23/10/98&quot;.
18795 </DD>
18796
18797 <DT>SHORTDATE3</DT>
18798 <DD>
18799 This token represents the date on which the message was sent, according
18800 to the &quot;Date&quot; header field.
18801 It has the format DD.MM.YY. For example, &quot;23.10.98&quot;.
18802 </DD>
18803
18804 <DT>SHORTDATE4</DT>
18805 <DD>
18806 This token represents the date on which the message was sent, according
18807 to the &quot;Date&quot; header field.
18808 It has the format YY.MM.DD. For example, &quot;98.10.23&quot;.
18809 </DD>
18810
18811 <DT>LONGDATE</DT>
18812 <DD>
18813 This token represents the date on which the message was sent, according
18814 to the &quot;Date&quot; header field.
18815 It has the format MMM DD, YYYY. For example, &quot;Oct 23, 1998&quot;.
18816 </DD>
18817
18818 <DT>SMARTDATE alternatives</DT>
18819 <DD>
18820 There are several versions of SMARTDATE that are all the same except
18821 for the way they format dates far in the past.
18822 SMARTDATE formats the date using the information from your locale settings
18823 to format the date string. It may end up formatting dates so that they look
18824 like DATEISO tokens, or SHORTDATE2 tokens, or something else entirely.
18825 The feature
18826 <A HREF="h_config_dates_to_local"><!--#echo var="FEAT_convert-dates-to-localtime"--></A>
18827 may have an affect on the values of these tokens.
18828 If you want more control you may use one of the following.
18829   <DL>
18830   <DT>SMARTDATE</DT> <DD>If the option
18831 <A HREF="h_config_disable_index_locale_dates"><!--#echo var="FEAT_disable-index-locale-dates"--></A> is not set
18832 then this will be locale specific. Control this with the
18833 LC_TIME locale setting on a UNIX system. On Windows
18834 the Regional Options control panel may be used to set the Short date
18835 format. At the programming level, the strftime routine is what Alpine
18836 uses to print the date.
18837 If the <!--#echo var="FEAT_disable-index-locale-dates"--> option is set then this is equivalent
18838 to SMARTDATES1.</DD>
18839   <DT>SMARTDATEISO</DT> <DD>DATEISO format. See text above.</DD>
18840   <DT>SMARTDATESHORTISO</DT> <DD>SHORTDATEISO format.</DD>
18841   <DT>SMARTDATES1</DT> <DD>SHORTDATE1 format.</DD>
18842   <DT>SMARTDATES2</DT> <DD>SHORTDATE2 format.</DD>
18843   <DT>SMARTDATES3</DT> <DD>SHORTDATE3 format.</DD>
18844   <DT>SMARTDATES4</DT> <DD>SHORTDATE4 format.</DD>
18845   </DL>
18846 </DD>
18847
18848 <DT>SMARTDATETIME alternatives</DT>
18849 <DD>
18850 There are several versions of SMARTDATETIME that are all very similar.
18851 The ones that end in 24 use a 24-hour clock for Today's messages instead
18852 of a 12-hour clock.
18853 The other variation is
18854 for the way they format dates far in the past.
18855 SMARTDATETIME and SMARTDATETIME24 format the date using the information from your locale settings
18856 to format the date string. It may end up formatting dates so that they look
18857 like DATEISO tokens, or SHORTDATE2 tokens, or something else entirely.
18858 The feature
18859 <A HREF="h_config_dates_to_local"><!--#echo var="FEAT_convert-dates-to-localtime"--></A>
18860 may have an affect on the values of these tokens.
18861 The possible choices are:
18862   <DL>
18863   <DT>SMARTDATETIME</DT> <DD>If the option
18864 <A HREF="h_config_disable_index_locale_dates"><!--#echo var="FEAT_disable-index-locale-dates"--></A> is not set
18865 then this will be locale specific. Control this with the
18866 LC_TIME locale setting on a UNIX system. On Windows
18867 the Regional Options control panel may be used to set the Short date
18868 format. At the programming level, the strftime routine is what Alpine
18869 uses to print the date.
18870 If the <!--#echo var="FEAT_disable-index-locale-dates"--> option is set then this is equivalent
18871 to SMARTDATETIMES1.</DD>
18872   <DT>SMARTDATETIME24</DT> <DD>Use TIME24 for Today</DD>
18873   <DT>SMARTDATETIMEISO</DT> <DD>DATEISO format. See text above.</DD>
18874   <DT>SMARTDATETIMEISO24</DT> <DD>Use TIME24 for Today</DD>
18875   <DT>SMARTDATETIMESHORTISO</DT> <DD>SHORTDATEISO format.</DD>
18876   <DT>SMARTDATETIMESHORTISO24</DT> <DD>Use TIME24 for Today</DD>
18877   <DT>SMARTDATETIMES1</DT> <DD>SHORTDATE1 format.</DD>
18878   <DT>SMARTDATETIMES124</DT> <DD>Use TIME24 for Today</DD>
18879   <DT>SMARTDATETIMES2</DT> <DD>SHORTDATE2 format.</DD>
18880   <DT>SMARTDATETIMES224</DT> <DD>Use TIME24 for Today</DD>
18881   <DT>SMARTDATETIMES3</DT> <DD>SHORTDATE3 format.</DD>
18882   <DT>SMARTDATETIMES324</DT> <DD>Use TIME24 for Today</DD>
18883   <DT>SMARTDATETIMES4</DT> <DD>SHORTDATE4 format.</DD>
18884   <DT>SMARTDATETIMES424</DT> <DD>Use TIME24 for Today</DD>
18885   </DL>
18886 </DD>
18887
18888 <DT>DAYDATE</DT>
18889 <DD>
18890 This token represents the date on which the message was sent, according
18891 to the &quot;Date&quot; header field.
18892 It looks like &quot;Sat, 23 Oct 1998&quot;.
18893 This token is never converted in any locale-specific way.
18894 </DD>
18895
18896 <DT>PREFDATE</DT>
18897 <DD>
18898 This token represents the date on which the message was sent, according
18899 to the &quot;Date&quot; header field.
18900 It is your operating system's idea of the preferred date representation for the current locale.
18901 Internally it uses the %x version of the date from the strftime routine.
18902 </DD>
18903
18904 <DT>PREFTIME</DT>
18905 <DD>
18906 This token represents the time at which the message was sent, according
18907 to the &quot;Date&quot; header field.
18908 It is the preferred time representation for the current locale.
18909 Internally it uses the %X version of the time from the strftime routine.
18910 </DD>
18911
18912 <DT>PREFDATETIME</DT>
18913 <DD>
18914 This token represents the date and time at which the message was sent, according
18915 to the &quot;Date&quot; header field.
18916 It is the preferred date and time representation for the current locale.
18917 Internally it uses the %c version of the time from the strftime routine.
18918 </DD>
18919
18920 <DT>DAY</DT>
18921 <DD>
18922 This token represents the day of the month on which the message was sent,
18923 according to the &quot;Date&quot; header field.
18924 For example, &quot;23&quot; or &quot;9&quot;.
18925 </DD>
18926
18927 <DT>DAY2DIGIT</DT>
18928 <DD>
18929 This token represents the day of the month on which the message was sent,
18930 according to the &quot;Date&quot; header field.
18931 For example, &quot;23&quot; or &quot;09&quot;.
18932 It is always 2 digits.
18933 </DD>
18934
18935 <DT>DAYORDINAL</DT>
18936 <DD>
18937 This token represents the ordinal number that is the day of
18938 the month on which the message was sent,
18939 according to the &quot;Date&quot; header field.
18940 For example, &quot;23rd&quot; or &quot;9th&quot;.
18941 </DD>
18942
18943 <DT>DAYOFWEEK</DT>
18944 <DD>
18945 This token represents the day of the week on which the message was sent,
18946 according to the &quot;Date&quot; header field.
18947 For example, &quot;Sunday&quot; or &quot;Wednesday&quot;.
18948 </DD>
18949
18950 <DT>DAYOFWEEKABBREV</DT>
18951 <DD>
18952 This token represents the day of the week on which the message was sent,
18953 according to the &quot;Date&quot; header field.
18954 For example, &quot;Sun&quot; or &quot;Wed&quot;.
18955 </DD>
18956
18957 <DT>MONTHABBREV</DT>
18958 <DD>
18959 This token represents the month the message was sent, according
18960 to the &quot;Date&quot; header field.
18961 For example, &quot;Oct&quot;.
18962 </DD>
18963
18964 <DT>MONTHLONG</DT>
18965 <DD>
18966 This token represents the month in which the message was sent, according
18967 to the &quot;Date&quot; header field.
18968 For example, &quot;October&quot;.
18969 </DD>
18970
18971 <DT>MONTH</DT>
18972 <DD>
18973 This token represents the month in which the message was sent, according
18974 to the &quot;Date&quot; header field.
18975 For example, &quot;10&quot; or &quot;9&quot;.
18976 </DD>
18977
18978 <DT>MONTH2DIGIT</DT>
18979 <DD>
18980 This token represents the month in which the message was sent, according
18981 to the &quot;Date&quot; header field.
18982 For example, &quot;10&quot; or &quot;09&quot;.
18983 It is always 2 digits.
18984 </DD>
18985
18986 <DT>YEAR</DT>
18987 <DD>
18988 This token represents the year the message was sent, according
18989 to the &quot;Date&quot; header field.
18990 For example, &quot;1998&quot; or &quot;2001&quot;.
18991 </DD>
18992
18993 <DT>YEAR2DIGIT</DT>
18994 <DD>
18995 This token represents the year the message was sent, according
18996 to the &quot;Date&quot; header field.
18997 For example, &quot;98&quot; or &quot;01&quot;.
18998 It is always 2 digits.
18999 </DD>
19000
19001 <DT>TIME24</DT>
19002 <DD>
19003 This token represents the time at which the message was sent, according
19004 to the &quot;Date&quot; header field.
19005 There is no adjustment made for different time zones, so you'll get
19006 the time the message was sent according to the time zone the sender
19007 was in.
19008 It has the format HH:MM. For example, &quot;17:28&quot;.
19009 </DD>
19010
19011 <DT>TIME12</DT>
19012 <DD>
19013 This token represents the time at which the message was sent, according
19014 to the &quot;Date&quot; header field.
19015 This time is for a 12 hour clock.
19016 It has the format HH:MMpm.
19017 For example, &quot;5:28pm&quot; or &quot;11:13am&quot;.
19018 </DD>
19019
19020 <DT>TIMEZONE</DT>
19021 <DD>
19022 This token represents the numeric timezone from
19023 the &quot;Date&quot; header field.
19024 It has the format [+-]HHMM. For example, &quot;-0800&quot;.
19025 </DD>
19026
19027 </DL>
19028
19029 <P>
19030 <H1><EM>Tokens Available Only for <!--#echo var="VAR_index-format"--></EM></H1>
19031
19032 <DL>
19033 <DT>MSGNO</DT>
19034 <DD>
19035 This token represents the message's current position in the folder that,
19036 of course, may change as the folder is sorted or new mail arrives.
19037 </DD>
19038
19039 <DT>STATUS</DT>
19040 <DD>
19041 This token represents a three character wide field displaying various
19042 aspects of the message's state.
19043 The first character is either blank,
19044 a '*' for message marked Important, or a '+' indicating a message
19045 addressed directly to you (as opposed to your having received it via a
19046 mailing list, for example).
19047 When the feature
19048 &quot;<A HREF="h_config_mark_for_cc"><!--#echo var="FEAT_mark-for-cc"--></A>&quot;
19049 is set, if the first character would have been
19050 blank then it will instead be a '-' if the message is cc'd to you.
19051 The second character is typically blank,
19052 though the arrow cursor may occupy it if either the
19053 &quot;<A HREF="h_config_force_low_speed"><!--#echo var="FEAT_assume-slow-link"--></A>&quot;
19054 or the
19055 &quot;<A HREF="h_config_force_arrow"><!--#echo var="FEAT_force-arrow-cursor"--></A>&quot; feature
19056 is set (or you actually are on a slow link).
19057 The third character is either '<A HREF="h_flag_deleted">D</A>' (Deleted),
19058 '<A HREF="h_flag_answered">A</A>' (Answered),
19059 '<A HREF="h_flag_forwarded">F</A>' (Forwarded),
19060 '<A HREF="h_flag_new">N</A>' (New), or blank.
19061 <P>
19062 If you are using a threaded view of the index and this message is at the
19063 top of a collapsed portion of a thread,
19064 then this token refers to all of the messages in the collapsed portion of
19065 the thread instead of just the top message.
19066 The first character will be a '*' if <EM>any</EM> of the messages in the thread
19067 are marked Important, else a '+' if any of the messages are addressed
19068 to you, else a '-' if any of the messages are cc'd to you.
19069 The third character will be a 'D' if <EM>all</EM> of the messages
19070 in the collapsed thread are marked deleted,
19071 an 'A' if <EM>all</EM> of the messages
19072 in the collapsed thread are marked answered,
19073 it will be an 'N' if any of
19074 the messages are undeleted and unseen, and it will be blank otherwise.
19075 </DD>
19076
19077 <DT>FULLSTATUS</DT>
19078 <DD>
19079 This token represents a less abbreviated alternative
19080 to the &quot;STATUS&quot; token.
19081 It is six characters wide.
19082 The first character is '+', '-', or blank, the
19083 second blank, the third either '*' or blank, the fourth
19084 '<A HREF="h_flag_new">N</A>' or blank,
19085 the fifth '<A HREF="h_flag_answered">A</A>'
19086 or blank, and the sixth character is
19087 either '<A HREF="h_flag_deleted">D</A>' or
19088 blank.
19089 <P>
19090 If you are using a threaded view of the index and this message is at the
19091 top of a collapsed portion of a thread,
19092 then this token refers to all of the messages in the collapsed portion of
19093 the thread instead of just the top message.
19094 The first character is '+', '-', or blank depending on whether <EM>any</EM>
19095 of the messages in the collapsed thread are addressed to you or cc'd to you.
19096 The third character will be '*' if any of the messages are marked
19097 Important.
19098 The fourth character will be 'N' if all of the messages in the thread
19099 are New, else 'n' if some of the messages in the thread are New, else blank.
19100 The fifth character will be 'A' or 'a' or blank, and the sixth character
19101 will be 'D' or 'd' or blank.
19102 </DD>
19103
19104 <DT>IMAPSTATUS</DT>
19105 <DD>
19106 This token represents an even less abbreviated alternative to the
19107 &quot;STATUS&quot; token.
19108 It differs from &quot;FULLSTATUS&quot; in only the fourth character, which is
19109 an 'N' if the message is new to this folder since the last time
19110 it was opened <EM>and</EM> it has not been viewed, an 'R' (Recent) if the message
19111 is new to the folder and has been viewed, a 'U' (Unseen) if the message is not
19112 new to the folder since it was last opened <EM>but</EM> has not been
19113 viewed, or a blank if the message has been in the folder since it was
19114 last opened and has been viewed.
19115 <P>
19116 If you are using a threaded view of the index and this message is at the
19117 top of a collapsed portion of a thread,
19118 then the fourth character will be
19119 'N' if all of the messages in the thread are unseen and recent;
19120 else 'n' if some of the messages in the thread are unseen and recent;
19121 else 'U' if all of the messages in the thread are unseen and not recent;
19122 else 'u' if some of the messages in the thread are unseen and not recent;
19123 else 'R' if all of the messages in the thread are seen and recent;
19124 else 'r' if some of the messages in the thread are seen and recent;
19125 else blank.
19126 </DD>
19127
19128 <DT>SHORTIMAPSTATUS</DT>
19129 <DD>
19130 This is the same as the last four of the six characters of IMAPSTATUS,
19131 so the '+' To Me information will be missing.
19132 </DD>
19133
19134 <DT>SIZE</DT>
19135 <DD>
19136 This token represents the total size, in bytes, of the message.
19137 If a &quot;K&quot; (Kilobyte)
19138 follows the number, the size is approximately 1,000
19139 times that many bytes (rounded to the nearest 1,000).
19140 If an &quot;M&quot; (Megabyte) follows the number, the size is approximately
19141 1,000,000 times that many bytes.
19142 Commas are not used in this field.
19143 This field is seven characters wide, including the enclosing parentheses.
19144 Sizes are rounded when &quot;K&quot; or &quot;M&quot; is present.
19145 The progression of sizes used looks like:
19146
19147 <P>
19148 <CENTER><SAMP>0 1 ... 9999 10K ... 999K 1.0M ... 99.9M 100M ... 2000M</SAMP></CENTER>
19149 <P>
19150 </DD>
19151
19152 <DT>SIZECOMMA</DT>
19153 <DD>
19154 This token represents the total size, in bytes, of the message.
19155 If a &quot;K&quot; (Kilobyte)
19156 follows the number, the size is approximately 1,000
19157 times that many bytes (rounded to the nearest 1,000).
19158 If an &quot;M&quot; (Megabyte) follows the number, the size is approximately
19159 1,000,000 times that many bytes.
19160 Commas are used if the number shown is 1,000 or greater.
19161 The SIZECOMMA field is one character wider than the SIZE field.
19162 Sizes are rounded when &quot;K&quot; or &quot;M&quot; is present.
19163 The progression of sizes used looks like:
19164
19165 <P>
19166 <CENTER><SAMP>0 1 ... 99,999 100K ... 9,999K 10.0M ... 999.9M 1,000M ... 2,000M</SAMP></CENTER>
19167 <P>
19168 </DD>
19169
19170 <DT>KSIZE</DT>
19171 <DD>
19172 This token represents the total size of the message, expressed in
19173 kilobytes or megabytes, as most appropriate.
19174 These are 1,024 byte kilobytes and 1,024 x 1,024 byte megabytes.
19175 The progression of sizes used looks like:
19176
19177 <P>
19178 <CENTER><SAMP>0K 1K ... 1023K 1.0M ... 99.9M 100M ... 2047M</SAMP></CENTER>
19179 <P>
19180 </DD>
19181
19182 <DT>SIZENARROW</DT>
19183 <DD>
19184 This token represents the total size, in bytes, of the message.
19185 If a &quot;K&quot; (Kilobyte)
19186 follows the number, the size is approximately 1,000
19187 times that many bytes.
19188 If an &quot;M&quot; (Megabyte) follows the number, the size is approximately
19189 1,000,000 times that many bytes.
19190 If a &quot;G&quot; (Gigabyte) follows the number, the size is approximately
19191 1,000,000,000 times that many bytes.
19192 This field uses only five characters of screen width, including the enclosing
19193 parentheses.
19194 The progression of sizes used looks like:
19195
19196 <P>
19197 <CENTER><SAMP>0 1 ... 999 1K ... 99K .1M ... .9M 1M ... 99M .1G ... .9G 1G 2G</SAMP></CENTER>
19198 <P>
19199 </DD>
19200
19201 <DT>DESCRIPSIZE</DT>
19202 <DD>
19203 This token is intended to represent a more useful description of the
19204 message than just its size, but it isn't very useful at this point.
19205 The plus sign in this view means there are attachments.
19206 Note that including this token in
19207 the &quot;<!--#echo var="VAR_index-format"-->&quot; could slow down the
19208 display a little while Alpine collects the necessary information.
19209 </DD>
19210
19211 <DT>SUBJKEY</DT>
19212 <DD>
19213 This token is the same as the SUBJECT token unless keywords are set for
19214 the message.
19215 In that case, a list of keywords enclosed in braces will be prepended to
19216 the subject of the message.
19217 Only those keywords that you have defined in your
19218 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option
19219 in Setup/Config are considered in the list.
19220 In other words, keywords that have been set by some other means, perhaps
19221 by another email program, won't show up unless included in
19222 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>.
19223 Having this set in the <!--#echo var="VAR_index-format"--> will also cause the keywords to be
19224 prepended to the subject in the MESSAGE TEXT screen.
19225 If you have given a keyword a nickname
19226 (<A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>), that nickname is displayed
19227 instead of the actual keyword.
19228 The <A HREF="h_config_kw_braces"><!--#echo var="VAR_keyword-surrounding-chars"--></A>
19229 option may be used to modify this token slightly.
19230 It is also possible to color keywords in the index using the
19231 Setup/Kolor screen (<A HREF="h_config_kw_color">Keyword Colors</A>).
19232 </DD>
19233
19234 <DT>SUBJKEYINIT</DT>
19235 <DD>
19236 This token is the same as the SUBJKEY token except that instead of
19237 prepending a list of keywords to the subject, a list of first initials
19238 of keywords will be prepended instead.
19239 For example, if a message has the keywords <EM>Work</EM> and <EM>Now</EM>
19240 set (or Work and Now are the Alpine nicknames of keywords that are set)
19241 then the SUBJKEY token would cause a result like
19242 <P>
19243 <CENTER><SAMP>{Work Now} actual subject</SAMP></CENTER>
19244 <P>
19245 whereas the SUBJKEYINIT token would give
19246 <P>
19247 <CENTER><SAMP>{WN} actual subject</SAMP></CENTER>
19248 <P>
19249 Only those keywords that you have defined in your
19250 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option
19251 in Setup/Config are considered in the list.
19252 In other words, keywords that have been set by some other means, perhaps
19253 by another email program, won't show up unless included in
19254 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>.
19255 The <A HREF="h_config_kw_braces"><!--#echo var="VAR_keyword-surrounding-chars"--></A>
19256 option may be used to modify this token slightly.
19257 It is also possible to color keywords in the index using the
19258 Setup/Kolor screen (<A HREF="h_config_kw_color">Keyword Colors</A>).
19259 </DD>
19260
19261 <DT>SUBJECTTEXT</DT>
19262 <DD>
19263 Same as SUBJECT but if there is room in the Subject field for more text,
19264 the opening part of the text of the message is displayed after the subject.
19265 The time needed to fetch the text may cause a performance problem
19266 which can, of course, be avoided by using the SUBJECT version of
19267 the Subject instead.
19268 You may color this opening text differently by using the
19269 <A HREF="h_config_index_opening_color">Index Opening Color</A> option available from
19270 the <A HREF="h_color_setup">Setup Kolor</A> screen.
19271 You may adjust the characters that are displayed between the Subject and the
19272 opening text with the option
19273 <A HREF="h_config_opening_sep"><!--#echo var="VAR_opening-text-separator-chars"--></A>.
19274 </DD>
19275
19276 <DT>SUBJKEYTEXT</DT>
19277 <DD>
19278 Same as SUBJKEY but with the opening message text.
19279 </DD>
19280
19281 <DT>OPENINGTEXT</DT>
19282 <DD>
19283 This is similar to SUBJECTTEXT.
19284 Instead of combining the Subject and the opening text in a single
19285 field in the index screen this token allows you to allocate a
19286 separate column just for the opening text of the message.
19287 The time needed to fetch this text may cause a performance problem.
19288 You may color this opening text differently by using the
19289 <A HREF="h_config_index_opening_color">Index Opening Color</A> option available from
19290 the <A HREF="h_color_setup">Setup Kolor</A> screen.
19291 </DD>
19292
19293 <DT>OPENINGTEXTNQ</DT>
19294 <DD>
19295 This is very similar to OPENINGTEXT.
19296 The NQ stands for No Quotes.
19297 The only difference is that quoted text (lines beginning with &gt;) is deleted.
19298 For some messages this may be confusing.
19299 For example, a message might have a line preceding some quoted
19300 text that reads something like &quot;On May 8th person A said.&quot;
19301 That no longer makes sense after the quoted text is deleted and it
19302 will appear that person A said whatever the text after the quote
19303 is, even though that is really person B talking.
19304 </DD>
19305
19306 <DT>SUBJKEYINITTEXT</DT>
19307 <DD>
19308 Same as SUBJKEYINIT but with the opening message text.
19309 </DD>
19310
19311 <DT>KEY</DT>
19312 <DD>
19313 This is a space-delimited list of keywords that are set for the message.
19314 Only those keywords that you have defined in your
19315 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option
19316 in Setup/Config are considered in the list.
19317 In other words, keywords that have been set by some other means, perhaps
19318 by another email program, won't show up unless included in
19319 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>.
19320 If you have given a keyword a nickname
19321 (<A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>), that nickname is displayed
19322 instead of the actual keyword.
19323 It is also possible to color keywords in the index using the
19324 Setup/Kolor screen (<A HREF="h_config_kw_color">Keyword Colors</A>).
19325 This token defaults to an arbitrary width of 5.
19326 You should set it to whatever width suits you using something
19327 like KEY(17) in the <!--#echo var="VAR_index-format"-->.
19328 </DD>
19329
19330 <DT>KEYINIT</DT>
19331 <DD>
19332 This is a list of keyword initials that are set for the message.
19333 If you have given a keyword a nickname
19334 (<A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>), the initial of that nickname
19335 is displayed instead of the initial of the actual keyword.
19336 It is also possible to color keyword initials in the index using the
19337 Setup/Kolor screen (<A HREF="h_config_kw_color">Keyword Colors</A>).
19338 This token defaults to an arbitrary width of 2.
19339 You should set it to whatever width suits you using something
19340 like KEYINIT(3) in the <!--#echo var="VAR_index-format"-->.
19341 </DD>
19342
19343 <DT>PRIORITY</DT>
19344 <DD>
19345 The X-Priority header is a non-standard header that is used in a
19346 somewhat standard way by many mail programs.
19347 Alpine expects the value of this header to be a digit with a value
19348 from 1 to 5, with 1 being the highest priority and 5 the lowest priority.
19349 Since this priority is something that the sender sets it is only an indication
19350 of the priority that the sender attaches to the mail and it is therefore almost
19351 totally unreliable for use as a filtering criterion.
19352 This token will display the numeric value of the priority if it is between
19353 1 and 5.
19354 It will be suppressed (blank) if the value is 3, which is normal priority.
19355 This token may be colored with the
19356 <A HREF="h_config_index_pri_color">Index Priority Symbol Colors</A>.
19357 </DD>
19358
19359 <DT>PRIORITYALPHA</DT>
19360 <DD>
19361 This is a more verbose interpretation of the X-Priority field.
19362 Once again nothing is displayed unless the value of the field
19363 is 1, 2, 4, or 5.
19364 The values displayed for those values are:
19365 <P>
19366 <TABLE>
19367 <TR> <TD>1</TD> <TD>Highest</TD> </TR>
19368 <TR> <TD>2</TD> <TD>High</TD> </TR>
19369 <TR> <TD>4</TD> <TD>Low</TD> </TR>
19370 <TR> <TD>5</TD> <TD>Lowest</TD> </TR>
19371 </TABLE>
19372 <P>
19373 This token may be colored with the
19374 <A HREF="h_config_index_pri_color">Index Priority Symbol Colors</A>.
19375 </DD>
19376
19377 <DT>PRIORITY!</DT>
19378 <DD>
19379 This is a one character, non-numeric version of the X-Priority field.
19380 If the value of the X-Priority header is 1 or 2 an exclamation
19381 point is displayed.
19382 If the value is 4 or 5 a &quot;v&quot; (think down arrow) is displayed.
19383 This token may be colored with the
19384 <A HREF="h_config_index_pri_color">Index Priority Symbol Colors</A>.
19385 </DD>
19386
19387 <DT>ATT</DT>
19388 <DD>
19389 This is a one column wide field that represents the number of attachments
19390 a message has. It will be blank if there are no attachments, a single
19391 digit for one to nine attachments, or an asterisk for more than nine.
19392 Note that including this token in
19393 the &quot;<!--#echo var="VAR_index-format"-->&quot; could slow down the
19394 display a little while Alpine collects the necessary information.
19395 </DD>
19396
19397 <DT>FROMORTO</DT>
19398 <DD>
19399 This token represents <EM>either</EM> the personal name (or email address) of
19400 the person listed in the message's &quot;From:&quot; header
19401 field, <EM>or</EM>, if that address is yours or one of your
19402 <A HREF="h_config_alt_addresses">alternate addresses</A>,
19403 the first person specified in the
19404 message's &quot;To:&quot; header field
19405 with the prefix &quot;To: &quot; prepended.
19406 If the from address is yours and there is also no &quot;To&quot; address,
19407 Alpine will use the address on the &quot;Cc&quot; line.
19408 If there is no address there, either, Alpine will look for a newsgroup name
19409 from the &quot;Newsgroups&quot; header field and put
19410 that after the &quot;To: &quot; prefix.
19411 </DD>
19412
19413 <DT>FROMORTONOTNEWS</DT>
19414 <DD>
19415 This is almost the same as <EM>FROMORTO</EM>.
19416 The difference is that newsgroups aren't considered.
19417 When a message is from you, doesn't have a To or Cc, and does have
19418 a Newsgroups header; this token will be your name instead of the name
19419 of the newsgroup (like it would be with FROMORTO).
19420 </DD>
19421
19422 <DT>TEXT</DT>
19423 <DD>
19424 This is a different sort of token.
19425 It allows you to display a label within each index line.
19426 It will be the same fixed text for each line.
19427 It is different from all the other tokens in that there is no space column
19428 displayed after this token.
19429 Instead, it is butted up against the following field.
19430 It also has a different syntax.
19431 The text to display is given following a colon after the
19432 word &quot;TEXT&quot;.
19433 For example,
19434 <P>
19435 <CENTER><SAMP>TEXT:abc=</SAMP></CENTER>
19436 <P>
19437 would insert the literal text &quot;abc=&quot; (without the quotes)
19438 into the index display line.
19439 You must quote the text if it includes space characters, like
19440 <P>
19441 <CENTER><SAMP>TEXT:&quot;abc&nbsp;=&nbsp;&quot;</SAMP></CENTER>
19442 <P>
19443 </DD>
19444
19445 <DT>HEADER</DT>
19446 <DD>
19447 This allows you to display the text from a particular header line in the
19448 message.
19449 The syntax for this token is substantially different from all the others
19450 in order that you might be able to display a portion of the text following
19451 a particular header.
19452 The header name you are interested in is given following a colon
19453 after the word &quot;HEADER&quot;.
19454 For example,
19455 <P>
19456 <CENTER><SAMP>HEADER:X-Spam</SAMP></CENTER>
19457 <P>
19458 would display the text of the X-Spam header, if any.
19459 Like for other index tokens a width field may (and probably should)
19460 follow this.
19461 <P>
19462 <CENTER><SAMP>HEADER:X-Spam(10)</SAMP></CENTER>
19463 <P>
19464 displays the first ten characters of the X-Spam header.
19465 Unlike other index tokens, the syntax for HEADER is more flexible.
19466 An optional second argument comes after a comma inside the parentheses.
19467 It specifies the &quot;field&quot; number.
19468 By default, the field separator is a space character.
19469 No extra space characters are allowed in the argument list.
19470 <P>
19471 <CENTER><SAMP>HEADER:X-Spam(10,2)</SAMP></CENTER>
19472 <P>
19473 would display the second field, left-justified, in a 10 character
19474 wide field.
19475 The second field would consist of all the text after the first space
19476 up to the next space or the end of the header.
19477 The default field number is zero, which stands for the entire line.
19478 There is also an optional third argument that is a list of field
19479 separators. It defaults to a space character.
19480 The example
19481 <P>
19482 <CENTER><SAMP>HEADER:X-Spam(10,2,:%&nbsp;)</SAMP></CENTER>
19483 <P>
19484 would cause the field separators to be any of colon, percent,
19485 or space (there is a space character between the percent and the
19486 right parenthesis).
19487 The first field runs from the start of the header value up to the first
19488 colon, percent, or space; the second goes from there to the next; and so on.
19489 In order to use a comma character as a field separator you must escape
19490 it by preceding it with a backslash (&#92;).
19491 The same is true of the backslash character itself.
19492 There is one further optional argument.
19493 It is an R or an L to specify right or left adjustment of the text
19494 within the field.
19495 The default is to left justify, however if you are displaying numbers
19496 you might prefer to right justify.
19497 <P>
19498 Here's an example of a SpamAssassin header.
19499 The exact look of the header will vary, but if your incoming mail
19500 contains headers that look like the following
19501 <P>
19502 <CENTER><SAMP>X-Spam-Status: Yes, hits=10.6 tagged_above=-999.0 required=7.0 tests=BAYE...</SAMP></CENTER>
19503 <P>
19504 you might want to display the hits value.
19505 The first field starts with the Y in Yes.
19506 To get what you're interested in you might use &quot;=&quot; and
19507 space as the field separators and display the third field, like
19508 <P>
19509 <CENTER><SAMP>HEADER:X-Spam-Status(4,3,=&nbsp;)</SAMP></CENTER>
19510 <P>
19511 or maybe you would break at the dot instead
19512 <P>
19513 <CENTER><SAMP>HEADER:X-Spam-Status(2,2,=.,R)</SAMP></CENTER>
19514 <P>
19515 Another example we've seen has headers that look like
19516 <P>
19517 <CENTER><SAMP>X-Spam: Gauge=IIIIIII, Probability=7%, Report=...</SAMP></CENTER>
19518 <P>
19519 Because there are two equals and a comma before the 7% and a comma
19520 after it, the token
19521 <P>
19522 <CENTER><SAMP>HEADER:X-Spam(3,4,=&#92;,,R)</SAMP></CENTER>
19523 <P>
19524 should display the probability (for example 7% or 83%) right justified
19525 in a 3-wide field.
19526 </DD>
19527
19528 <DT>ARROW</DT>
19529 <DD>
19530 This gives an alternative way to display the current message in the
19531 MESSAGE INDEX screen.
19532 Usually the current message is indicated by the line being shown in
19533 reverse video.
19534 Instead, if the ARROW token is included in your <!--#echo var="VAR_index-format"-->,
19535 the current line will include an &quot;arrow&quot; that
19536 looks like
19537 <P>
19538 <CENTER><SAMP>-&gt;</SAMP></CENTER>
19539 <P>
19540 in the ARROW token's field.
19541 For all of the non-current messages, the ARROW field will be filled
19542 with blanks.
19543 If you use the fixed-field width feature the length of the &quot;arrow&quot;
19544 may be adjusted.
19545 The arrow will be drawn as width-1 dashes followed by a greater than sign.
19546 For example, if you use ARROW(3) you will get
19547 <P>
19548 <CENTER><SAMP>--&gt;</SAMP></CENTER>
19549 <P>
19550 and ARROW(1) will give you just
19551 <P>
19552 <CENTER><SAMP>&gt;</SAMP></CENTER>
19553 <P>
19554 It is also possible to set the color of the ARROW field.
19555 By default (and for non-current messages) the arrow is colored the same
19556 as the index line it is part of.
19557 You may set it to be another color with the
19558 <A HREF="h_config_index_arrow_color">Index Arrow Color</A> option available from
19559 the <A HREF="h_color_setup">Setup Kolor</A> screen.
19560 </DD>
19561
19562 <DT>SCORE</DT>
19563 <DD>
19564 This gives the
19565 <a href="h_rules_score">score</a>
19566 of each message.
19567 This will be six columns wide to accomodate the widest possible score.
19568 You will probably want to use the <!--#echo var="VAR_index-format"--> fixed-field width feature
19569 to limit the width of the field to the widest score that
19570 you use (e.g. SCORE(3) if your scores are always between 0 and 999).
19571 If you have not defined any score rules the scores will all be zero.
19572 If any of your score rules contain AllText or BodyText patterns
19573 then including SCORE in the <!--#echo var="VAR_index-format"-->
19574 may slow down the display of the MESSAGE INDEX screen.
19575 </DD>
19576 </DL>
19577
19578 <P>
19579 <H1><EM>Tokens Available for all but <!--#echo var="VAR_index-format"--></EM></H1>
19580
19581 <DL>
19582 <DT>CURNEWS</DT>
19583 <DD>
19584 This token represents the current newsgroup if there is one.
19585 For example, &quot;comp.mail.pine&quot;.
19586 </DD>
19587
19588 <DT>MSGID</DT>
19589 <DD>
19590 This token represents the message ID of the message.
19591 This token does not work with Filter Rule folder names.
19592 </DD>
19593
19594 <DT>CURDATE</DT>
19595 <DD>
19596 This token represents the current date.
19597 It has the format MMM DD. For example, &quot;Oct 23&quot;.
19598 </DD>
19599
19600 <DT>CURDATEISO</DT>
19601 <DD>
19602 This token represents the current date.
19603 It has the format YYYY-MM-DD. For example, &quot;1998-10-23&quot;.
19604 </DD>
19605
19606 <DT>CURDATEISOS</DT>
19607 <DD>
19608 This token represents the current date.
19609 It has the format YY-MM-DD. For example, &quot;98-10-23&quot;.
19610 </DD>
19611
19612 <DT>CURPREFDATE</DT>
19613 <DD>
19614 This token represents the current date.
19615 It is your operating system's idea of the preferred date representation for the current locale.
19616 Internally it uses the %x version of the date from the strftime routine.
19617 </DD>
19618
19619 <DT>CURPREFTIME</DT>
19620 <DD>
19621 This token represents the current time.
19622 It is the preferred time representation for the current locale.
19623 Internally it uses the %X version of the time from the strftime routine.
19624 </DD>
19625
19626 <DT>CURPREFDATETIME</DT>
19627 <DD>
19628 This token represents the current date and time.
19629 It is the preferred date and time representation for the current locale.
19630 Internally it uses the %c version of the time from the strftime routine.
19631 </DD>
19632
19633 <DT>CURTIME24</DT>
19634 <DD>
19635 This token represents the current time.
19636 It has the format HH:MM. For example, &quot;17:28&quot;.
19637 </DD>
19638
19639 <DT>CURTIME12</DT>
19640 <DD>
19641 This token represents the current time.
19642 This time is for a 12 hour clock.
19643 It has the format HH:MMpm.
19644 For example, &quot;5:28pm&quot; or &quot;11:13am&quot;.
19645 </DD>
19646
19647 <DT>CURDAY</DT>
19648 <DD>
19649 This token represents the current day of the month.
19650 For example, &quot;23&quot; or &quot;9&quot;.
19651 </DD>
19652
19653 <DT>CURDAY2DIGIT</DT>
19654 <DD>
19655 This token represents the current day of the month.
19656 For example, &quot;23&quot; or &quot;09&quot;.
19657 It is always 2 digits.
19658 </DD>
19659
19660 <DT>CURDAYOFWEEK</DT>
19661 <DD>
19662 This token represents the current day of the week.
19663 For example, &quot;Sunday&quot; or &quot;Wednesday&quot;.
19664 </DD>
19665
19666 <DT>CURDAYOFWEEKABBREV</DT>
19667 <DD>
19668 This token represents the current day of the week.
19669 For example, &quot;Sun&quot; or &quot;Wed&quot;.
19670 </DD>
19671
19672 <DT>CURMONTH</DT>
19673 <DD>
19674 This token represents the current month.
19675 For example, &quot;10&quot; or &quot;9&quot;.
19676 </DD>
19677
19678 <DT>CURMONTH2DIGIT</DT>
19679 <DD>
19680 This token represents the current month.
19681 For example, &quot;10&quot; or &quot;09&quot;.
19682 It is always 2 digits.
19683 </DD>
19684
19685 <DT>CURMONTHLONG</DT>
19686 <DD>
19687 This token represents the current month.
19688 For example, &quot;October&quot;.
19689 </DD>
19690
19691 <DT>CURMONTHABBREV</DT>
19692 <DD>
19693 This token represents the current month.
19694 For example, &quot;Oct&quot;.
19695 </DD>
19696
19697 <DT>CURYEAR</DT>
19698 <DD>
19699 This token represents the current year.
19700 For example, &quot;1998&quot; or &quot;2001&quot;.
19701 </DD>
19702
19703 <DT>CURYEAR2DIGIT</DT>
19704 <DD>
19705 This token represents the current year.
19706 For example, &quot;98&quot; or &quot;01&quot;.
19707 It is always 2 digits.
19708 </DD>
19709
19710 <DT>LASTMONTH</DT>
19711 <DD>
19712 This token represents last month.
19713 For example, if this is November (the 11th month),
19714 it is equal to &quot;10&quot; or if this is October (the 10th month),
19715 it is &quot;9&quot;.
19716 It is possible that this and the other tokens beginning with LASTMONTH
19717 below could be useful when used with a Filtering Rule that
19718 has the &quot;Beginning of Month&quot; option set.
19719 </DD>
19720
19721 <DT>LASTMONTH2DIGIT</DT>
19722 <DD>
19723 This token represents last month.
19724 For example, if this is November (the 11th month),
19725 it is equal to &quot;10&quot; or if this is October (the 10th month),
19726 it is &quot;09&quot;.
19727 It is always 2 digits.
19728 </DD>
19729
19730 <DT>LASTMONTHLONG</DT>
19731 <DD>
19732 This token represents last month.
19733 For example, if this is November the value is &quot;October&quot;.
19734 </DD>
19735
19736 <DT>LASTMONTHABBREV</DT>
19737 <DD>
19738 This token represents last month.
19739 For example, if this is November the value is &quot;Oct&quot;.
19740 </DD>
19741
19742 <DT>LASTMONTHYEAR</DT>
19743 <DD>
19744 This token represents what the year was a month ago.
19745 For example, if this is October, 1998, it is &quot;1998&quot;.
19746 If this is January, 1998, it is &quot;1997&quot;.
19747 </DD>
19748
19749 <DT>LASTMONTHYEAR2DIGIT</DT>
19750 <DD>
19751 This token represents what the year was a month ago.
19752 For example, if this is October, 1998, it is &quot;98&quot;.
19753 If this is January, 1998, it is &quot;97&quot;.
19754 </DD>
19755
19756 <DT>LASTYEAR</DT>
19757 <DD>
19758 This token represents last year.
19759 For example, if this is 1998, it equals &quot;1997&quot;.
19760 It is possible that this
19761 could be useful when used with a Filtering Rule that
19762 has the &quot;Beginning of Year&quot; option set.
19763 </DD>
19764
19765 <DT>LASTYEAR2DIGIT</DT>
19766 <DD>
19767 This token represents last year.
19768 For example, if this is 1998, it equals &quot;97&quot;.
19769 It is always 2 digits.
19770 </DD>
19771
19772 <DT>ROLENICK</DT>
19773 <DD>
19774 This token represents the nickname of the
19775 role currently being used.  If no role is being used,
19776 then no text will be printed for this token.
19777 This token does not work with Filter Rule folder names.
19778 </DD>
19779 </DL>
19780
19781 <P>
19782 <H1><EM>Token Available Only for <!--#echo var="VAR_reply-leadin"--></EM></H1>
19783 See the help for the
19784 <A HREF="h_config_reply_intro">&quot;<!--#echo var="VAR_reply-leadin"-->&quot;</A> option
19785 to see why you might want to use this.
19786 Since the <!--#echo var="VAR_reply-leadin"--> contains free text this token
19787 must be surrounded by underscores when used.
19788
19789 <DL>
19790 <DT>NEWLINE</DT>
19791 <DD>
19792 This is an end of line marker.
19793 </DD>
19794 </DL>
19795
19796 <P>
19797 <H1><EM>Token Available Only for Templates and Signatures</EM></H1>
19798
19799 <DL>
19800 <DT>CURSORPOS</DT>
19801 <DD>
19802 This token is different from the others.
19803 When it is replaced it is replaced with nothing, but it sets an Alpine
19804 internal variable that tells the composer to start with the cursor
19805 positioned at the position where this token was.
19806 If both the template file and the signature file contain
19807 a &quot;CURSORPOS&quot; token, then the position in the template file
19808 is used.
19809 If there is a template file and neither it nor the signature file contains
19810 a &quot;CURSORPOS&quot; token, then the cursor is positioned
19811 after the end of the contents of the
19812 template file when the composer starts up.
19813 </DD>
19814 </DL>
19815
19816 <P>
19817 &lt;End of help on this topic&gt;
19818 </BODY>
19819 </HTML>
19820 ======= h_reply_token_conditionals =======
19821 <HTML>
19822 <HEAD>
19823 <TITLE>Conditional Inclusion of Text for <!--#echo var="VAR_reply-leadin"-->, Signatures, and Templates</TITLE>
19824 </HEAD>
19825 <BODY>
19826 <H1>Conditional Inclusion of Text for <!--#echo var="VAR_reply-leadin"-->, Signatures, and Templates</H1>
19827
19828 Conditional text inclusion may be used with
19829 the <A HREF="h_config_reply_intro">&quot;<!--#echo var="VAR_reply-leadin"-->&quot;</A> option,
19830 in signature files, and in template files used in
19831 <A HREF="h_rules_roles">&quot;roles&quot;</A>.
19832 It may <EM>not</EM> be used with the
19833 <A HREF="h_config_index_format">&quot;<!--#echo var="VAR_index-format"-->&quot;</A> option.
19834
19835 <P>
19836 There is a limited if-else capability for including text.
19837 The if-else condition is based
19838 on whether or not a given token would result in replacement text you
19839 specify.
19840 The syntax of this conditional inclusion is
19841 <P>
19842 <CENTER><SAMP>_token_(match_this, if_matched [ , if_not_matched ] )</SAMP></CENTER>
19843 <P>
19844 The left parenthesis must follow the underscore immediately, with no
19845 intervening space.
19846 It means the token is expanded and the results of that expansion are
19847 compared against the &quot;match_this&quot; argument.
19848 If there is an exact match, then the &quot;if_matched&quot; text is used
19849 as the replacement text.
19850 Otherwise, the &quot;if_not_matched&quot; text is used.
19851 One of the most useful values for the &quot;match_this&quot; argument is
19852 the empty string, &quot;&quot;.
19853 In that case the expansion is compared against the empty string.
19854 <P>
19855 Here's an example to make it clearer.
19856 This text could be included in one of your template files:
19857 <P>
19858 <CENTER><SAMP>_NEWS_(&quot;&quot;, &quot;I'm replying to email&quot;, &quot;I'm replying to news&quot;)</SAMP></CENTER>
19859 <P>
19860 If that is included in a template file that you are using while replying
19861 to a message (because you chose to use the role it was part of),
19862 and that message has a newsgroup header and a newsgroup in that header,
19863 then the text
19864 <P>
19865 <CENTER><SAMP>I'm replying to news</SAMP></CENTER>
19866 <P>
19867 will be included in the message you are about to compose.
19868 On the other hand, if the message you are replying to does not have
19869 a newsgroup, then the text
19870 <P>
19871 <CENTER><SAMP>I'm replying to email</SAMP></CENTER>
19872 <P>
19873 would be included instead.
19874 This would also work in signature files and in
19875 the &quot;<!--#echo var="VAR_reply-leadin"-->&quot; option.
19876 If the &quot;match_this&quot;, &quot;if_matched&quot;,
19877 or &quot;if_not_matched&quot; arguments contain
19878 spaces, parentheses, or commas;
19879 they have to be quoted with double quotation marks (like in the example
19880 above).
19881 If you want to include a literal quote (&quot;) in the text you must escape the
19882 quote by preceding it with a backslash (&#92;) character.
19883 If you want to include a literal backslash character you must escape it
19884 by preceding it with another backslash.
19885 <P>
19886 The comma followed by &quot;if_not_matched&quot; is optional.
19887 If there is no &quot;if_not_matched&quot;
19888 present then no text is included if the not_matched case is true.
19889 Here's another example:
19890 <P>
19891 <CENTER><SAMP>_NEWS_(&quot;&quot;, &quot;&quot;, &quot;This msg was seen in group: _NEWS_.&quot;)</SAMP></CENTER>
19892 <P>
19893 Here you can see that tokens may appear in the arguments.
19894 The same is true for tokens with the conditional parentheses.
19895 They may appear in arguments,
19896 though you do have to be careful to get the quoting and escaping of
19897 nested double quotes correct.
19898 If this was in the signature file being used and you were replying to a message
19899 sent to comp.mail.pine the resulting text would be:
19900 <P>
19901 <CENTER><SAMP>This msg was seen in group: comp.mail.pine.</SAMP></CENTER>
19902 <P>
19903 If you were replying to a message that wasn't sent to any newsgroup the
19904 resulting text would be a single blank line.
19905 The reason you'd get a blank line is because the end of the line is
19906 outside of the conditional, so is always included.
19907 If you wanted to get rid of that blank line you could do so by moving
19908 the end of line inside the conditional.
19909 In other words, it's ok to have multi-line
19910 &quot;if_matched&quot; or &quot;if_not_matched&quot; arguments in your
19911 template file.
19912 The text just continues until the next double quotation, even if it's not
19913 on the same line.
19914 <P>
19915 Here's an example for use in the &quot;<!--#echo var="VAR_reply-leadin"-->&quot;:
19916 <P>
19917 <CENTER><SAMP>On _DAYDATE_, _FROM__CURNEWS_(&quot;&quot;, &quot;&quot;, &quot;seen in _CURNEWS_,&quot;) wrote</SAMP></CENTER>
19918 <P>
19919 If this was in your <!--#echo var="VAR_reply-leadin"--> and you were replying to a message
19920 while reading the newsgroup comp.mail.pine the resulting text would be:
19921 <P>
19922 <CENTER><SAMP>On Sat, 24 Oct 1998, Fred Flintstone, seen in comp.mail.pine, wrote:</SAMP></CENTER>
19923 <P>
19924 If you were replying to a message while reading an email folder instead
19925 of a newsgroup the resulting leadin text would be
19926 <P>
19927 <CENTER><SAMP>On Sat, 24 Oct 1998, Fred Flintstone wrote:</SAMP></CENTER>
19928 <P>
19929 Here's one more (contrived) example illustrating a matching argument
19930 that is not the empty string.
19931 <P>
19932 <CENTER><SAMP>_SMARTDATE_("Today", _SMARTDATE_, "On _DATE_") _FROM_ wrote:</SAMP></CENTER>
19933 <P>
19934 If this was the value of your &quot;<!--#echo var="VAR_reply-leadin"-->&quot; option and you
19935 were replying to
19936 a message that was sent today, then the value of the &quot;<!--#echo var="VAR_reply-leadin"-->&quot;
19937 would be
19938 <P>
19939 <CENTER><SAMP>Today Fred Flintstone wrote:</SAMP></CENTER>
19940 <P>
19941 But if you were replying to a message sent on Oct. 27 (and that wasn't
19942 today) you would get
19943 <P>
19944 <CENTER><SAMP>On Oct 27 Fred Flintstone wrote:</SAMP></CENTER>
19945 <P>
19946
19947 &lt;End of help on this topic&gt;
19948 </BODY>
19949 </HTML>
19950 ======= h_composer_cntxt_nick =======
19951 <HTML>
19952 <HEAD>
19953 <TITLE>Collection Nickname Explained</TITLE>
19954 </HEAD>
19955 <BODY>
19956 <H1>Collection Edit Help -- Nickname Field</H1>
19957
19958 This field is provided so you can add a short nickname to use when
19959 referring to this collection within Alpine.  Spaces are allowed, and
19960 you don't need to use double-quotes.  However, the double-quote
19961 character is not allowed.
19962 <P>
19963 Look <A HREF="h_edit_nav_cmds">here</A>
19964 to see the available Editing and Navigation commands.
19965 <P>
19966 &lt;End of help on this topic&gt;
19967 </BODY>
19968 </HTML>
19969 ======= h_folder_server_syntax =======
19970 <HTML>
19971 <HEAD>
19972 <TITLE>Server Name Syntax</TITLE>
19973 </HEAD>
19974 <BODY>
19975 <H1>Server Name Syntax</H1>
19976
19977 This help describes the syntax that may be used for server names
19978 that may be associated with remote folders or SMTP servers.
19979
19980 <P>
19981 A server name is the hostname of the server.
19982 It's a good idea to use the host's fully-qualified network name.
19983
19984 <P>
19985 <CENTER><SAMP>foo.example.com</SAMP></CENTER>
19986 <P>
19987
19988 However, IP addresses are allowed if surrounded
19989 with square-brackets.
19990
19991 <P>
19992 <CENTER><SAMP>[127.0.0.1]</SAMP></CENTER>
19993 <P>
19994
19995 An optional network port number may be supplied by appending
19996 a colon (:) followed by the port number
19997 to the server name.
19998 By default, the IMAP port number, 143, is used.
19999
20000 <P>
20001 <CENTER><SAMP>foo.example.com:port</SAMP></CENTER>
20002 <P>
20003
20004 Besides server name and optional port number, various other optional
20005 parameters may be supplied that alter Alpine's interaction with the server.
20006 A parameter is supplied by appending a slash (/) character followed by
20007 the parameter's name and,
20008 depending on the particular parameter, the value assigned to that
20009 name, to the server name (and optional port number).
20010 Parameter names are <EM>not</EM> case sensitive.
20011 Currently supported parameters include:
20012
20013 <DL>
20014
20015 <DT>User</DT>
20016 <DD>This parameter requires an associated value, and is intended to
20017 provide the username identifier with which to establish the server
20018 connection.
20019 If your SMTP server offers SMTP AUTH authentication, adding this
20020 parameter to the
20021 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>
20022 option will cause Alpine to attempt to authenticate to the server using the
20023 supplied username.
20024 Similarly, if your NNTP server offers NNTP &quot;AUTHINFO SASL&quot;
20025 or &quot;AUTHINFO USER&quot; authentication, adding this parameter to the
20026 <A HREF="h_config_nntp_server"><!--#echo var="VAR_nntp-server"--></A>
20027 option (or to the server name for any folder collection using NNTP)
20028 will cause Alpine to attempt
20029 to authenticate to the server using the supplied username.
20030 An example might be:
20031
20032 <P>
20033 <CENTER><SAMP>/user=katie</SAMP></CENTER>
20034 <P>
20035
20036 </DD>
20037
20038 <DT>TLS</DT>
20039 <DD>
20040 Normally, when a new connection is made an attempt is made to
20041 negotiate a secure (encrypted) session using Transport Layer Security (TLS).
20042 If that fails then a non-encrypted connection will be attempted instead.
20043 This is a unary parameter indicating communication with the server must
20044 take place over a TLS connection. If the attempt to use TLS fails then
20045 this parameter will cause the connection to fail instead of falling
20046 back to an unsecure connection.
20047
20048 <P>
20049 <CENTER><SAMP>/tls</SAMP></CENTER>
20050 <P>
20051
20052 </DD>
20053
20054 <DT>SSL</DT>
20055 <DD>
20056 This is a unary parameter indicating communication with the server should
20057 take place over a Secure Socket Layer connection.  The server must support
20058 this method, and be prepared to accept connections on the appropriate
20059 port (993 by default).
20060 Alpine must be linked with an SSL library for this option to be operational.
20061
20062 <P>
20063 <CENTER><SAMP>/ssl</SAMP></CENTER>
20064 <P>
20065
20066 </DD>
20067
20068 <DT>TLS1</DT>
20069 <DD>
20070 This parameter indicates that the connection to the server will be made
20071 over the SSL port, but using the TLSv1 protocol, instead of the usual
20072 SSLv3 or SSLv2 protocols.
20073 Alpine must be linked with an SSL library for this option to be operational.
20074
20075 <P>
20076 <CENTER><SAMP>/tls1</SAMP></CENTER>
20077 <P>
20078
20079 </DD>
20080
20081 <DT>DTLS1</DT>
20082 <DD>
20083 This parameter indicates that the connection to the server will be made
20084 over the SSL port, but using the DTLSv1 protocol, instead of the usual
20085 SSLv3 or SSLv2 protocols.
20086 Alpine must be linked with an SSL library for this option to be operational.
20087
20088 <P>
20089 <CENTER><SAMP>/dtls1</SAMP></CENTER>
20090 <P>
20091
20092 </DD>
20093
20094 <DT>TLS1_1</DT>
20095 <DD>
20096 This parameter indicates that the connection to the server will be made
20097 over the SSL port, but using the TLSv1.1 protocol, instead of the usual
20098 SSLv3 or SSLv2 protocols.
20099 Alpine must be linked with an SSL library for this option to be operational.
20100
20101 <P>
20102 <CENTER><SAMP>/tls1_1</SAMP></CENTER>
20103 <P>
20104
20105 </DD>
20106
20107 <DT>TLS1_2</DT>
20108 <DD>
20109 This parameter indicates that the connection to the server will be made
20110 over the SSL port, but using the TLSv1.2 protocol, instead of the usual
20111 SSLv3 or SSLv2 protocols.
20112 Alpine must be linked with an SSL library for this option to be operational.
20113
20114 <P>
20115 <CENTER><SAMP>/tls1_2</SAMP></CENTER>
20116 <P>
20117
20118 </DD>
20119
20120
20121 <DT>NoValidate-Cert</DT>
20122 <DD>Do not validate certificates (for TLS or SSL connections) from the server.
20123 This is needed if the server uses self-signed certificates or if Alpine
20124 cannot validate the certificate for some other known reason.
20125 <P>
20126 </DD>
20127
20128 <DT>Anonymous</DT>
20129 <DD>This is a unary parameter (that means it does not have a value)
20130 indicating that the connection be logged in as
20131 &quot;anonymous&quot; rather than a specific user.
20132 Not all servers offer anonymous
20133 access; those which do generally only offer read-only access to certain
20134 &quot;public&quot; folders.
20135
20136 <P>
20137 <CENTER><SAMP>/anonymous</SAMP></CENTER>
20138 <P>
20139
20140 </DD>
20141
20142 <DT>Secure</DT>
20143 <DD>This is a unary parameter indicating that the connection use the
20144 most secure authentication method mutually supported by Alpine and the
20145 server.
20146 Alpine is capable of authenticating connections to
20147 the server using several methods.
20148 By default, Alpine will attempt each
20149 method until either a connection is established or the
20150 list of methods is exhausted.
20151 This parameter causes Alpine to instead fail
20152 the connection if the first (generally most &quot;secure&quot;) method fails.
20153
20154 <P>
20155 <CENTER><SAMP>/secure</SAMP></CENTER>
20156 <P>
20157
20158 </DD>
20159
20160 <DT>Submit</DT>
20161 <DD>This is a unary parameter for use with the
20162 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A> option.
20163 It indicates that the connection should be made to the Submit server
20164 (<A HREF="http://www.ietf.org/rfc/rfc2476.txt">RFC 3676</A>)
20165 (port 587) instead of the SMTP port (25).
20166 At the time this help was written the submit option was equivalent to
20167 specifying port 587.
20168
20169 <P>
20170 <CENTER><SAMP>/submit</SAMP></CENTER>
20171 <P>
20172 or
20173 <P>
20174 <CENTER><SAMP>host:587</SAMP></CENTER>
20175 <P>
20176
20177 </DD>
20178
20179 <DT>Debug</DT>
20180 <DD>This is a unary parameter indicating that the connection be established
20181 in a verbose mode.  Basically, it causes Alpine to log the communication with
20182 the server in Alpine's debug file.
20183 Normally, the pine -d command-line flag would be used instead.
20184 <P>
20185 </DD>
20186
20187 <DT>NoRsh</DT>
20188 <DD>By default, Alpine attempts to login using &quot;rsh&quot;,
20189 the UNIX remote shell program.
20190 Including &quot;NoRsh&quot; will cause connections to this server to skip
20191 the &quot;rsh&quot; attempt.
20192 This might be useful to avoid long timeouts caused by rsh firewalls, for
20193 example.
20194 <P>
20195 </DD>
20196
20197 <DT>Loser</DT>
20198 <DD>This option makes sense only for IMAP servers that do not perform
20199 a SEARCH command correctly. If your filtering rules
20200 fail to filter some messages, that should have been filtered, then this
20201 option will make Alpine download all data necessary to perform that search.
20202 There is a performance penalty when using this option. Downloading the
20203 data to perfom the search will take longer than requesting the IMAP
20204 server to perform the filtering, but the filtering will be done correctly.
20205 <P>
20206 </DD>
20207
20208
20209 <DT>Service</DT>
20210 <DD>This parameter requires an associated value.  The default value is
20211 &quot;IMAP&quot; which indicates communication with the server based
20212 on the IMAP4rev1 protocol (defined in RFC 3501 -- see
20213 <A HREF="http://www.imap.org/docs/rfc3501.html">http://www.imap.org/docs/rfc3501.html</A>).</DD>
20214
20215 Other service values include:
20216  <DL>
20217  <DT>NNTP</DT>
20218  <DD>This value indicates communication with the server takes place via
20219 the Network News Transfer Protocol.  Use this to define a collection
20220 of newsgroups on a remote news server.  So
20221
20222 <P>
20223 <CENTER><SAMP>/service=NNTP</SAMP></CENTER>
20224 <P>
20225 or just
20226 <P>
20227 <CENTER><SAMP>/NNTP</SAMP></CENTER>
20228 <P>
20229
20230 is the way to specify NNTP access.
20231 <P>
20232  </DD>
20233
20234  <DT>POP3</DT>
20235  <DD>This value indicates communication with the server takes place via the
20236 Post Office Protocol 3 protocol.
20237
20238 <P>
20239 <CENTER><SAMP>/service=POP3</SAMP></CENTER>
20240 <P>
20241 or just
20242 <P>
20243 <CENTER><SAMP>/POP3</SAMP></CENTER>
20244 <P>
20245
20246 Note that there are several important issues
20247 to consider when selecting this option:
20248 <OL>
20249  <LI> POP3 provides access to only your INBOX.  In other words,
20250 secondary folders such as your &quot;saved-messages&quot; are inaccessible.
20251  <LI> Alpine's implementation of POP3 does not follow the traditional POP
20252 model and will leave your mail on the server. Refer to the
20253 <A HREF="h_maildrop">Mail Drop</A> functionality for a possible way around this problem.
20254  <LI> See the discussion about new-mail checking in <A HREF="h_config_reopen_rule">&quot;<!--#echo var="VAR_folder-reopen-rule"-->&quot;</A>.
20255 </OL>
20256 </DD>
20257 </DL>
20258 </DL>
20259
20260 <P>
20261 Note that it is possible to include more than one parameter in a server
20262 specification by concatenating the parameters. For example:
20263
20264 <P>
20265 <CENTER><SAMP>foo.example.com:port/user=katie/novalidate-cert/debug</SAMP></CENTER>
20266 <P>
20267
20268 <P>
20269 &lt;End of help on this topic&gt;
20270 </BODY>
20271 </HTML>
20272 ======= h_composer_cntxt_server =======
20273 <HTML>
20274 <HEAD>
20275 <TITLE>Collection Server: Explained</TITLE>
20276 </HEAD>
20277 <BODY>
20278 <H1>Collection Edit Help -- Server Field</H1>
20279
20280 This collection's &quot;Server:&quot; definition indicates the
20281 hostname of the server providing access to the folders in this
20282 collection.
20283 The syntax of this server name is the same as for other server names used
20284 in remote folder names in
20285 Alpine and is described
20286 <A HREF="h_folder_server_syntax">here</A>.
20287
20288 <P>
20289 &lt;End of help on this topic&gt;
20290 </BODY>
20291 </HTML>
20292 ======= h_composer_cntxt_path =======
20293 <HTML>
20294 <HEAD>
20295 <TITLE>Collection Path: Explained</TITLE>
20296 </HEAD>
20297 <BODY>
20298 <H1>Collection Edit Help -- Path Field</H1>
20299
20300 The collection's &quot;Path:&quot; definition indicates the location
20301 of the folders in this collection.  If the path or any of its components
20302 do not exist, Alpine will prompt you for their creation when exiting the
20303 Add/Change screen.
20304
20305 <P>
20306 By default the path is interpreted as defining a section of your personal
20307 folder area.  This area and how you specify it are defined by the
20308 server, if one is specified in the collection, or, typically, the home
20309 directory if no server is defined.
20310
20311 <P>
20312 To define a collection outside the default &quot;area&quot;, prefix
20313 the path with the &quot;namespace&quot; to use when interpreting the
20314 given path.  If a namespace is specified, the Path begins with the
20315 sharp, &quot;#&quot;, character followed by the name of the namespace
20316 and then the namespace's path-element-delimiter.  Aside from the
20317 path's format, namespaces can also imply access rights, content
20318 policy, audience, location, and, occasionally, access methods.
20319
20320 <P>
20321 Each server exports its own set (possibly of size one) of
20322 namespaces.  Hence, it's likely communication with your server's
20323 administrator will be required for specific configurations.  Some of
20324 the more common namespaces, however, include:
20325
20326 <DL>
20327 <DT>#news.</DT>
20328 <DD>This specifies a set of folders in the newsgroup namespace.  Newsgroup
20329 names are hierarchically defined with each level delimited by a period.
20330 </DD>
20331 <DT>#public/</DT>
20332 <DD>This specifies a folder area that the server may export to the general
20333 public.
20334 </DD>
20335 <DT>#shared/</DT>
20336 <DD>This specifies a folder area that the folder may export to groups
20337 of users.
20338 </DD>
20339 <DT>#ftp/</DT>
20340 <DD>This specifies a folder area that is the same as that it may have
20341 exported via the &quot;File Transfer Protocol&quot;.
20342 </DD>
20343 <DT>#mh/</DT>
20344 <DD>This specifies the personal folder area associated with folders
20345 and directories that were created using the MH message handling system.
20346 </DD>
20347 </DL>
20348 <P>
20349
20350 In addition, the server may support access to other user's folders,
20351 provided you have suitable permissions.  Common methods use a prefix
20352 of either &quot;~<VAR>user</VAR>/&quot;, or &quot;/<VAR>user</VAR>/&quot; to
20353 indicate the root of the other user's folder area.
20354
20355 <P>
20356 No, nothing's simple.
20357
20358 <P>
20359 &lt;End of help on this topic&gt;
20360 </BODY>
20361 </HTML>
20362 ======= h_composer_cntxt_view =======
20363 <HTML>
20364 <HEAD>
20365 <TITLE>Collection View: Explained</TITLE>
20366 </HEAD>
20367 <BODY>
20368 <H1>Collection Edit Help -- View Field</H1>
20369
20370 The collection's &quot;View:&quot; definition provides a way to limit
20371 the displayed list of folders within a collection.  By default, only
20372 folders that contain the specified characters anywhere in their name
20373 are shown in the collection's folder list.
20374
20375 <P>
20376 Additionally, you can use a wildcard character to better control
20377 the list of folders selected for display.  The wildcard specifier is
20378 the star, &quot;*&quot;, character.
20379
20380 <P>
20381 So, for example, to define a collection of all folders ending with
20382 &quot;c&quot;, you'd specify a view of &quot;*c&quot; (without the
20383 quote characters!).  Or, similarly, to define a collection of folders
20384 whose names start with &quot;a&quot; and end with &quot;z&quot;, you'd
20385 specify a view of &quot;a*z&quot;.
20386
20387 <P>
20388 &lt;End of help on this topic&gt;
20389 </BODY>
20390 </HTML>
20391 ======= h_composer_abook_add_server =======
20392 <HTML>
20393 <HEAD>
20394 <TITLE>Addressbook Server Name Field Explained</TITLE>
20395 </HEAD>
20396 <BODY>
20397 This field should be left blank if the address book is stored in a regular
20398 file on this system.  If it is a remote address book stored on an IMAP
20399 server then this is the name of that IMAP server.
20400 <P>
20401 Look <A HREF="h_edit_nav_cmds">here</A>
20402 to see the available Editing and Navigation commands.
20403 <P>
20404 &lt;End of help on this topic&gt;
20405 </BODY>
20406 </HTML>
20407 ======= h_composer_abook_add_folder =======
20408 <HTML>
20409 <HEAD>
20410 <TITLE>Addressbook Folder Name Field Explained</TITLE>
20411 </HEAD>
20412 <BODY>
20413 For a remote address book (one for which the Server Name is filled in)
20414 this is the name of a folder on the remote server. The address book data
20415 will be stored in this folder. This folder should be used only for
20416 storing this single address book, not for other address books or for
20417 other messages.
20418 <P>
20419 For a local address book (one for which the Server Name is not filled in)
20420 this is the name of a file in which the address book will be stored.
20421 The file is in the same directory as the Alpine configuration file if the
20422 configuration file is local.
20423 If the configuration file is remote, then this will be in the home directory
20424 for Unix Alpine and in the directory specified by the
20425 &quot;-aux local_directory&quot; command line argument.
20426 <P>
20427 Look <A HREF="h_edit_nav_cmds">here</A>
20428 to see the available Editing and Navigation commands.
20429 <P>
20430 &lt;End of help on this topic&gt;
20431 </BODY>
20432 </HTML>
20433 ======= h_composer_abook_add_nick =======
20434 <HTML>
20435 <HEAD>
20436 <TITLE>Addressbook NickName Field Explained</TITLE>
20437 </HEAD>
20438 <BODY>
20439 This is just an optional nickname for this address book. If present, it
20440 is used in some of the displays and error messages in the address book
20441 maintenance screens. It is for your convenience only and serves no
20442 other purpose.
20443 <P>
20444 Look <A HREF="h_edit_nav_cmds">here</A>
20445 to see the available Editing and Navigation commands.
20446 <P>
20447 &lt;End of help on this topic&gt;
20448 </BODY>
20449 </HTML>
20450 ======= h_composer_qserv_cn =======
20451 <HTML>
20452 <HEAD>
20453 <TITLE>Directory Query Form Explained</TITLE>
20454 </HEAD>
20455 <BODY>
20456
20457 Fill in as many of these fields as you wish to narrow down your
20458 search. All the fields you fill in must match in order for an entry
20459 to be returned. You may use the wildcard character &quot;*&quot; in
20460 any of the fields, it matches any zero or more characters at that
20461 point in the string. There are no implicit wildcards, so the match is
20462 exact unless you include wildcards.
20463 <P>
20464
20465 Note that if an attribute isn't present at all, then the match will fail.
20466 For example, if a server doesn't support the Locality attribute, then no
20467 matter what you put in the Locality field (other than leaving it empty)
20468 the search will fail.
20469 <P>
20470
20471 This field, the Common Name field, is typically a person's full name.
20472 <P>
20473
20474 <H1>EDITING and NAVIGATION COMMANDS</H1>
20475 <!--chtml if pinemode="function_key"-->
20476 <PRE>
20477 CURSOR MOTION KEYS----------------------|EDITING KEYS-------------------------
20478 ^B (Left Arrow)    Back character       | ^D       Delete current character
20479 ^F (Right Arrow)   Forward character    | ^H (DEL) Delete previous character
20480 ^P (Up Arrow)      Previous line        |
20481 ^N (Down Arrow)    Next line            | F9       Cut marked text or
20482 ^A                 Beginning of line    |            delete current line
20483 ^E                 End of line          | F10      Undelete line(s)
20484 F7                 Previous page        |
20485 F8                 Next page            |-------------------------------------
20486 ^@ (Ctrl-SPACE)    Next word            | MISCELLANEOUS COMMANDS
20487 ----------------------------------------|
20488 EXIT COMMANDS    |  GENERAL COMMANDS    | F5    Restore previous search
20489 F2   Cancel      |   F1    Get help     |
20490 F3   Search      |   ^Z    Suspend      | ^L    Redraw Screen
20491 </PRE>
20492 <!--chtml else-->
20493 <PRE>
20494 CURSOR MOTION KEYS----------------------|EDITING KEYS-------------------------
20495 ^B (Left Arrow)    Back character       | ^D       Delete current character
20496 ^F (Right Arrow)   Forward character    | ^H (DEL) Delete previous character
20497 ^P (Up Arrow)      Previous line        |
20498 ^N (Down Arrow)    Next line            | ^K       Cut marked text or
20499 ^A                 Beginning of line    |            delete current line
20500 ^E                 End of line          | ^U       Undelete line(s)
20501 ^Y                 Previous page        |
20502 ^V                 Next page            |-------------------------------------
20503 ^@ (Ctrl-SPACE)    Next word            | MISCELLANEOUS COMMANDS
20504 ----------------------------------------|
20505 EXIT COMMANDS    |  GENERAL COMMANDS    | ^R     Restore previous search
20506 ^C   Cancel      |   ^G    Get help     |
20507 ^X   Search      |   ^Z    Suspend      | ^L     Redraw Screen
20508 </PRE>
20509 <!--chtml endif-->
20510 <P><UL>
20511 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
20512 </UL><P>
20513 &lt;End of help on this topic&gt;
20514 </BODY>
20515 </HTML>
20516 ======= h_composer_qserv_sn =======
20517
20518 The Surname is usually the family name of a person.
20519
20520 <End of help on this topic>
20521 ======= h_composer_qserv_gn =======
20522
20523 This is the part of a person's name that isn't the surname or initials.
20524
20525 <End of help on this topic>
20526 ======= h_composer_qserv_mail =======
20527
20528 This is the email address of a person.
20529
20530 <End of help on this topic>
20531 ======= h_composer_qserv_org =======
20532
20533 This is the organization a person belongs to.
20534
20535 <End of help on this topic>
20536 ======= h_composer_qserv_unit =======
20537
20538 This is the organizational unit a person belongs to.
20539
20540 <End of help on this topic>
20541 ======= h_composer_qserv_country =======
20542
20543 This is the country a person belongs to.
20544
20545 <End of help on this topic>
20546 ======= h_composer_qserv_state =======
20547
20548 This is the state a person belongs to.
20549
20550 <End of help on this topic>
20551 ======= h_composer_qserv_locality =======
20552
20553 This is the locality a person belongs to.
20554
20555 <End of help on this topic>
20556 ======= h_composer_qserv_custom =======
20557
20558 This one is for advanced users only! If you put something in this field,
20559 then the rest of the fields are ignored.
20560
20561 This field may be set to the string representation of an LDAP search
20562 filter (see RFC1960). Here are some examples:
20563
20564 To search for an entry with a surname equal to "clinton" you could set
20565 the custom filter to:
20566
20567      (sn=clinton)
20568
20569 This is equivalent to putting "clinton" in the SurName field.
20570 To search for an entry that has a surname that begins with "clint" and
20571 has a givenname equal to "william" you could use:
20572
20573      (&(sn=clint*)(givenname=william))
20574
20575 This is equivalent to setting the SurName field to "clint*" and the
20576 GivenName field to "william".
20577 To search for an entry where either the common name OR the email address
20578 contains "abcde" you could use:
20579
20580      (|(cn=*abcde*)(mail=*abcde*))
20581
20582 That isn't equivalent to anything you can do by setting the other fields
20583 because of the OR.
20584
20585 <End of help on this topic>
20586 ======= h_composer_qserv_qq =======
20587
20588 This one is a little different from the rest of the categories.  It causes
20589 a search to be formed from the configured search filter that you filled
20590 in when you added the directory server to your configuration. It can also
20591 be combined with the other fields if you'd like.
20592
20593 <End of help on this topic>
20594 ======= h_address_format =======
20595 <HTML>
20596 <HEAD>
20597 <TITLE>INTERNET EMAIL ADDRESS FORMAT</TITLE>
20598 </HEAD>
20599 <BODY>
20600 <H1>INTERNET EMAIL ADDRESS FORMAT</H1>
20601
20602 A valid email address on the Internet has a username, an &quot;@&quot; sign,
20603 and then a domain, with no spaces.
20604 For example, jsmith@art.example.com might be the email address
20605 of a person
20606 with the username &quot;jsmith&quot; who has an account in the domain
20607 &quot;art.example.com&quot;.  The number of dot-separated segments on the
20608 right of the &quot;@&quot; sign can vary - a shorter example would be
20609 isabelle@elsewhere.edu (the shortest possible form: here, only the
20610 organization's domain is specified after the &quot;@&quot; sign); a longer
20611 example would be
20612  jsingh@shakti.edutech.example.com
20613 (here, the name of the host &quot;shakti&quot; in the domain
20614 edutech.example.com is also specified).
20615 <P>
20616 If you do not know the exact email address of someone you want to write
20617 to, ask them what it is using other means of communication than email; or
20618 use the tools for
20619 finding people's addresses that are available on the Internet.
20620 <P>
20621 If you are sending to someone on the same system as you are, you can leave
20622 the &quot;@&quot; sign and all the information to its right off of the
20623 address, and Alpine will fill it in automatically,
20624 unless the feature
20625 <A HREF="h_config_compose_rejects_unqual">&quot;<!--#echo var="FEAT_compose-rejects-unqualified-addrs"-->&quot;</A> is set in SETUP CONFIGURATION.
20626 <P>
20627
20628 When an email address you send a message to is not reachable -- either because
20629 it is simply an incorrect address, or because email can temporarily not be
20630 delivered to it due to a technical problem on the way to or at the recipient's
20631 end -- you will almost always get an error notification email message back.
20632 <P>
20633 If you encounter problems with, or have questions about, email delivery or
20634 email address syntax, contact your local network computing consultants.
20635 <P><UL>
20636 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
20637 </UL>
20638 <P>
20639 &lt;End of help on this topic&gt;
20640 </BODY>
20641 </HTML>
20642 ======= h_flag_user_flag =======
20643 <HTML>
20644 <HEAD>
20645 <TITLE>STATUS FLAG: User Defined Keyword</TITLE>
20646 </HEAD>
20647 <BODY>
20648 <H1>STATUS FLAG: User Defined Keyword</h1>
20649
20650 This is a keyword that is defined for this folder.
20651 It was most likely defined by the owner of the folder.
20652 Alpine will not set or clear this flag on its own.
20653
20654 <P><UL>
20655 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
20656 </UL><P>
20657 &lt;End of help on this topic&gt;
20658 </BODY>
20659 </HTML>
20660 ======= h_flag_important =======
20661 <html>
20662 <title>STATUS FLAG: Important</title>
20663 <body>
20664 <h1>STATUS FLAG: Important</h1>
20665
20666
20667 The <EM>Important</EM> flag, indicated by an asterisk in Alpine's
20668 MESSAGE&nbsp;INDEX
20669 screen, can only be set by the user, and is intended to be used in
20670 whatever fashion makes sense to you.  You are the only one that can set or
20671 clear it.
20672
20673 <P>
20674 &lt;End of help on this topic&gt;
20675 </BODY>
20676 </HTML>
20677 ======= h_flag_new =======
20678 <html>
20679 <title>STATUS FLAG: New</title>
20680 <body>
20681 <h1>STATUS FLAG: New</h1>
20682
20683
20684 The <EM>New</EM> flag, indicated by the letter 'N' in Alpine's
20685 MESSAGE&nbsp;INDEX screen,
20686 is automatically set when messages are delivered to your Inbox (or other
20687 folder specified outside of Alpine).  Likewise, it is cleared automatically
20688 the first time you read the message it is associated with.
20689
20690 <P>
20691 Sometimes it's helpful in prioritizing your mail.  For example, perhaps
20692 a message isn't weighty enough to assign it an <A HREF="h_flag_important">Important</A> flag, but
20693 you'd like to be reminded of it next time you read mail.  This can be done
20694 easily by <A HREF="h_common_flag">explicitly</A> resetting the <EM>New</EM> flag.
20695
20696
20697 <P>
20698 &lt;End of help on this topic&gt;
20699 </BODY>
20700 </HTML>
20701 ======= h_flag_answered =======
20702 <html>
20703 <title>STATUS FLAG: Answered</title>
20704 <body>
20705 <h1>STATUS FLAG: Answered</h1>
20706
20707 The <EM>Answered</EM> flag, indicated by the letter 'A' in Alpine's
20708 MESSAGE&nbsp;INDEX
20709 screen, is automatically set when you reply to a message.  This flag is not
20710 automatically cleared.
20711
20712 <P>
20713 &lt;End of help on this topic&gt;
20714 </BODY>
20715 </HTML>
20716 ======= h_flag_forwarded =======
20717 <html>
20718 <title>STATUS FLAG: Forwarded</title>
20719 <body>
20720 <h1>STATUS FLAG: Forwarded</h1>
20721
20722 The <EM>Forwarded</EM> flag, indicated by the letter 'F' in Alpine's
20723 MESSAGE&nbsp;INDEX
20724 screen, is automatically set when you forward a message.  This flag is not
20725 automatically cleared.
20726
20727 <P>
20728 &lt;End of help on this topic&gt;
20729 </BODY>
20730 </HTML>
20731 ======= h_flag_deleted =======
20732 <html>
20733 <title>STATUS FLAG: Deleted</title>
20734 <body>
20735 <h1>STATUS FLAG: Deleted</h1>
20736
20737 The <EM>Deleted</EM> flag, indicated by the letter 'D' in Alpine's
20738 MESSAGE&nbsp;INDEX
20739 screen, is set when you use the &quot;"D&nbsp;Delete&quot; command.
20740 It is cleared
20741 when you use the &quot;U&nbsp;Undelete&quot; command.
20742
20743 <P>
20744 Messages marked with this flag will be permanently removed from
20745 the folder when you issue the <A HREF="h_index_cmd_expunge">Expunge</A>
20746 command, or
20747 when you indicate acceptance of their removal upon leaving the folder.
20748
20749 <P>
20750 Note, there can be other actions implicit in the
20751 &quot;D&nbsp;Delete&quot; command,
20752 such as advancing to the next message, that may be momentarily undesirable.
20753 For this reason, it's sometimes useful to set or clear the <EM>Deleted</EM>
20754 flag <A HREF="h_common_flag">explicitly</A>.
20755
20756 <P>
20757 &lt;End of help on this topic&gt;
20758 </BODY>
20759 </HTML>
20760 ====== h_config_incoming_timeo ======
20761 <HTML>
20762 <HEAD>
20763 <TITLE>OPTION: <!--#echo var="VAR_incoming-check-timeout"--></TITLE>
20764 </HEAD>
20765 <BODY>
20766 <H1>OPTION: <!--#echo var="VAR_incoming-check-timeout"--></H1>
20767
20768 This option has no effect unless the feature
20769 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
20770 is set, which in turn has no effect unless
20771 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
20772 is set.
20773 <P>
20774 Sets the time in seconds that Alpine will
20775 attempt to open a network connection used for monitoring for Unseen
20776 messages in Incoming Folders. The default is 5.
20777 If a connection has not completed within this many seconds Alpine will
20778 give up and consider it a failed connection.
20779 <P>
20780 <UL>
20781 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
20782 </UL><P>
20783 &lt;End of help on this topic&gt;
20784 </BODY>
20785 </HTML>
20786 ====== h_config_psleep ======
20787 <HTML>
20788 <HEAD>
20789 <TITLE>OPTION: <!--#echo var="VAR_mailcap-check-interval"--> (UNIX Alpine only)</TITLE>
20790 </HEAD>
20791 <BODY>
20792 <H1>OPTION: <!--#echo var="VAR_mailcap-check-interval"--> (UNIX Alpine only)</H1>
20793
20794 <P>
20795 In the good old days a mailcap viewer was used to examine an
20796 attachment before saving it, and after viewing the attachment control
20797 would return to the operating system when the viewer was closed. Therefore,
20798 when the mailcap viewer returned control to the operating system, it
20799 could be assumed that the user who opened the attachment was done
20800 examining it, and the copy of the attachment that was used, could be removed.
20801
20802 <P>
20803 However, today this assumption is not longer valid. Some viewers return
20804 control to the operating system before they actually read the attachment
20805 to be examined. This causes Alpine to delete the attachment before it
20806 is read by the viewer, causing the viewer to fail opening the attachment.
20807
20808 <P>
20809 In order to work around this problem, Alpine checks, after the viewer has
20810 returned control to the operating system, if there is any process that is
20811 using the attachment. This variable controls the number of seconds that
20812 must elapse between checks. Once it is found that no process is using the
20813 attachment, this is removed.
20814
20815 <P>
20816 The minimum value for this variable is 60 (checks will be made once per
20817 minute), and the maximum value is 600 (checks will be made once every 10
20818 minutes). The default value is 60.
20819
20820 <P>
20821 <UL>
20822 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
20823 </UL><P>
20824 &lt;End of help on this topic&gt;
20825 </BODY>
20826 </HTML>
20827 ====== h_config_incoming_interv ======
20828 <HTML>
20829 <HEAD>
20830 <TITLE>OPTION: <!--#echo var="VAR_incoming-check-interval"--></TITLE>
20831 </HEAD>
20832 <BODY>
20833 <H1>OPTION: <!--#echo var="VAR_incoming-check-interval"--></H1>
20834
20835 This option has no effect unless the feature
20836 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
20837 is set, which in turn has no effect unless
20838 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
20839 is set.
20840 <P>
20841 This option specifies, in seconds, how often Alpine will check
20842 for new mail and state changes in Incoming Folders when Incoming Folders
20843 Checking is turned on.
20844 The default is 3 minutes (180).
20845 This value applies only to folders that are local to the system that
20846 Alpine is running on or that are accessed using the IMAP protocol.
20847 The similar option
20848 <A HREF="h_config_incoming_second_interv"><!--#echo var="VAR_incoming-check-interval-secondary"--></A>
20849 applies to all other monitored folders.
20850 <P>
20851 <UL>
20852 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
20853 </UL><P>
20854 &lt;End of help on this topic&gt;
20855 </BODY>
20856 </HTML>
20857 ====== h_config_incoming_second_interv ======
20858 <HTML>
20859 <HEAD>
20860 <TITLE>OPTION: <!--#echo var="VAR_incoming-check-interval-secondary"--></TITLE>
20861 </HEAD>
20862 <BODY>
20863 <H1>OPTION: <!--#echo var="VAR_incoming-check-interval-secondary"--></H1>
20864
20865 This option has no effect unless the feature
20866 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
20867 is set, which in turn has no effect unless
20868 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
20869 is set.
20870 <P>
20871 This option together with the option
20872 <A HREF="h_config_incoming_interv"><!--#echo var="VAR_incoming-check-interval"--></A>
20873 specifies, in seconds, how often Alpine will check
20874 for new mail and state changes in Incoming Folders when Incoming Folders
20875 Checking is turned on.
20876 The default for this option is 3 minutes (180).
20877 For folders that are local to this system or
20878 that are accessed using the IMAP protocol
20879 the value of the option
20880 <A HREF="h_config_incoming_interv"><!--#echo var="VAR_incoming-check-interval"--></A>
20881 is used.
20882 For all other monitored folders, the value of this option is used.
20883 <P>
20884 The reason there are two separate options is because it is usually
20885 less expensive to check local and IMAP folders than it is to check
20886 other types, like POP or NNTP folders.
20887 You may want to set this secondary value to a higher number than
20888 the primary check interval.
20889 <P>
20890 <UL>
20891 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
20892 </UL><P>
20893 &lt;End of help on this topic&gt;
20894 </BODY>
20895 </HTML>
20896 ====== h_config_incoming_list ======
20897 <HTML>
20898 <HEAD>
20899 <TITLE>OPTION: <!--#echo var="VAR_incoming-check-list"--></TITLE>
20900 </HEAD>
20901 <BODY>
20902 <H1>OPTION: <!--#echo var="VAR_incoming-check-list"--></H1>
20903
20904 This option has no effect unless the feature
20905 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
20906 is set, which in turn has no effect unless
20907 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
20908 is set.
20909 <P>
20910 When monitoring the Incoming Message Folders for Unseen messages Alpine will
20911 normally monitor all Incoming Folders.
20912 You may use this option to restrict the list of monitored folders to a
20913 subset of all Incoming Folders.
20914 <P>
20915 <UL>
20916 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
20917 </UL><P>
20918 &lt;End of help on this topic&gt;
20919 </BODY>
20920 </HTML>
20921 ====== h_config_pers_name ======
20922 <HTML>
20923 <HEAD>
20924 <TITLE>OPTION: <!--#echo var="VAR_personal-name"--></TITLE>
20925 </HEAD>
20926 <BODY>
20927 <H1>OPTION: <!--#echo var="VAR_personal-name"--></H1>
20928
20929 This value is used to determine the full name part of the "From" address
20930 on messages you send.
20931 <!--chtml if pinemode="os_windows"-->
20932  PC-Alpine requires that this be set in order to properly construct the "From" address.
20933 <!--chtml else-->
20934  If unset, Unix Alpine will obtain your full name from
20935  the system password file. PC-Alpine, on the other hand, requires that this be set.
20936 <!--chtml endif-->
20937 <P>
20938 If you want to change the value of what gets included in the From header
20939 in messages you send (other than just the Personal Name)
20940 look <A HREF="h_config_change_your_from">here</A> for a description.
20941 <P><UL>
20942 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
20943 </UL><P>
20944 &lt;End of help on this topic&gt;
20945 </BODY>
20946 </HTML>
20947 ====== h_config_pruned_folders ======
20948 <html>
20949 <header>
20950 <title>OPTION: <!--#echo var="VAR_pruned-folders"--></title>
20951 </header>
20952 <body>
20953 <h1>OPTION: <!--#echo var="VAR_pruned-folders"--></h1>
20954
20955 This variable allows you to define a list of one or more folders that
20956 Alpine will offer to prune for you in the same way it automatically offers
20957 to prune your "sent-mail" folder each month.
20958 Each folder in this list must be a folder in your default folder collection
20959 (the first folder collection if you have more than one), and it is just
20960 the relative name of the folder in the collection, not the fully-qualified name.
20961 It is similar to sent-mail.
20962 Instead of something like
20963 <P>
20964 <CENTER><SAMP><!--#echo var="VAR_pruned-folders"-->={servername}mail/folder</SAMP></CENTER>
20965 <P>
20966 the correct value to use would be
20967 <P>
20968 <CENTER><SAMP>folder</SAMP></CENTER>
20969 <P>
20970 There is an assumption here that your first collection is the folders in
20971 <P>
20972 <CENTER><SAMP>{servername}mail</SAMP></CENTER>
20973 <P>
20974
20975 Once a month, for each folder listed, Alpine will offer to move
20976 the contents of the folder to a new folder of the same name but with
20977 the previous month's date appended.  Alpine will then look for any such
20978 date-appended folder names created for a previous month, and offer each
20979 one it finds for deletion.
20980 <P>
20981
20982 If you decline the first offer, no mail is moved and no new folder is
20983 created.
20984 <P>
20985
20986 The new folders will be created
20987 in your default folder collection.
20988 <P>
20989
20990 <UL>
20991 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
20992 </UL><P>
20993 &lt;End of help on this topic&gt;
20994 </body>
20995 </html>
20996 ====== h_config_upload_cmd ======
20997 <HTML>
20998 <HEAD>
20999 <TITLE>OPTION: <!--#echo var="VAR_upload-command"--></TITLE>
21000 </HEAD>
21001 <BODY>
21002 <H1>OPTION: <!--#echo var="VAR_upload-command"--></H1>
21003
21004 This option affects the behavior of the Composer's &quot;Read File&quot;
21005 (^R in the message body) and &quot;Attach File&quot; (^J in the header)
21006 commands.  It specifies
21007 a Unix program name, and any necessary command line arguments, that Alpine can
21008 use to transfer files from your personal computer into messages that you are
21009 composing.<P>
21010
21011 <B>Note:</B> this facility is intended for use with serial line transfer
21012 protocols, such as kermit, xmodem, or zmodem.  It is <B>not</B> intended
21013 to work with TCP/IP file transfer programs such as ftp.<P>
21014
21015 If a program is specified, the commands listed above are modified to offer a
21016 subcommand (^Y) to activate the transfer.  Obviously, the Unix program
21017 specified here must match the transfer program or protocol available on the
21018 personal computer.<P>
21019
21020 Alpine expects to exchange uploaded data via a file on your Unix system.  When
21021 the specified upload program finishes, Alpine expects the uploaded data to be
21022 contained in this file.<P>
21023
21024 When upload is invoked via the &quot;Read File&quot; subcommand, Alpine
21025 generates a
21026 temporary file name that it will pass to the specified Unix program.  Alpine
21027 will read the resulting uploaded text from this file and then delete it when
21028 the upload command is finished.<P>
21029
21030 When upload is invoked via the &quot;Attach File&quot; subcommand, Alpine will
21031 prompt
21032 you for the name of the file that is to contain the uploaded information that
21033 it is to attach.  Alpine will attach this file to the composition, but will
21034 <B>not</B> delete this file after the upload command is finished.<P>
21035
21036 The special token &quot;_FILE_&quot; may be included among the Unix program's
21037 command
21038 line arguments.  Alpine will replace this symbol with the name of the file
21039 being used to exchange the uploaded information.  This token allows you to
21040 position the file name where it is required in the Unix program's command
21041 line arguments.<P>
21042
21043 If the &quot;_FILE_&quot; token is not present in the specified command, the
21044 temporary file's name is automatically appended to the specified Unix
21045 program.  In other words, you don't need to use &quot;_FILE_&quot; if it is the
21046 <B>last</B> command line argument.
21047 <P><UL>
21048 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21049 </UL><P>
21050 &lt;End of help on this topic&gt;
21051 </BODY>
21052 </HTML>
21053 ====== h_config_upload_prefix ======
21054 <HTML>
21055 <HEAD>
21056 <TITLE>OPTION: <!--#echo var="VAR_upload-command-prefix"--></TITLE>
21057 </HEAD>
21058 <BODY>
21059 <H1>OPTION: <!--#echo var="VAR_upload-command-prefix"--></H1>
21060
21061 This option is used in conjunction with the <!--#echo var="VAR_upload-command"--> option.
21062 It defines text to be written to the terminal emulator (via standard output)
21063 immediately prior to starting upload command.  This is useful for
21064 integrated serial line file transfer agents that permit command passing
21065 (e.g., Kermit's APC method).<P>
21066
21067 The special token &quot;_FILE_&quot; may be included in the string specification.
21068 That symbol will be replaced with the (Alpine-created) name of the temporary
21069 file in which Alpine will expect to find the uploaded file.
21070 <P><UL>
21071 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21072 </UL><P>
21073 &lt;End of help on this topic&gt;
21074 </BODY>
21075 </HTML>
21076 ====== h_config_download_cmd ======
21077 <HTML>
21078 <HEAD>
21079 <TITLE>OPTION: <!--#echo var="VAR_download-command"--></TITLE>
21080 </HEAD>
21081 <BODY>
21082 <H1>OPTION: <!--#echo var="VAR_download-command"--></H1>
21083
21084 This option affects the behavior of the Export command.  It specifies a Unix
21085 program name, and any necessary command line arguments, that Alpine can use to
21086 transfer the exported message to your personal computer's disk.<P>
21087 Note: this facility is intended for use with serial line transfer
21088 protocols, such as kermit, xmodem, or zmodem.  It is <B>not</B> intended
21089 to work with TCP/IP file transfer programs such as ftp.<P>
21090 If a program is specified, the Export command is modified to offer a
21091 subcommand (^V) to activate the transfer (in lieu of saving it to
21092  the machine where Alpine is running).  Obviously, the Unix program
21093 specified here must match the transfer program or protocol available on the
21094 personal computer.<P>
21095
21096 When this subcommand is selected and before Alpine invokes the specified Unix
21097 program, Alpine will create a temporary file containing the text of the
21098 exported message.  Alpine uses this file to pass the exported message text to
21099 the specified Unix program.<P>
21100
21101 The special token &quot;_FILE_&quot; may be included among the Unix program's command
21102 line arguments.  Alpine will replace this symbol with the temporary file's name
21103 before executing the Unix program.  This token allows you to position the
21104 file name where it is required in the Unix program's command line arguments.
21105 <P>
21106 If the &quot;_FILE_&quot; token is not present in the specified command, the
21107 temporary file's name is automatically appended to the specified Unix
21108 program.  In other words, you don't need to use &quot;_FILE_&quot; if it is the
21109 <B>last</B> command line argument.
21110 <P><UL>
21111 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21112 </UL><P>
21113 &lt;End of help on this topic&gt;
21114 </BODY>
21115 </HTML>
21116 ====== h_config_download_prefix ======
21117 <HTML>
21118 <HEAD>
21119 <TITLE>OPTION: <!--#echo var="VAR_download-command-prefix"--></TITLE>
21120 </HEAD>
21121 <BODY>
21122 <H1>OPTION: <!--#echo var="VAR_download-command-prefix"--></H1>
21123
21124 This option is used in conjunction with the <!--#echo var="VAR_download-command"--> option.
21125 It defines text to be written to the terminal emulator (via standard output)
21126 immediately prior to starting the download command.  This is useful for
21127 integrated serial line file transfer agents that permit command passing
21128 (e.g., Kermit's APC method).
21129 <P>
21130 The special token &quot;_FILE_&quot; may be included in the string
21131 specification.
21132 That symbol will be replaced with the (Alpine-created) name of the temporary
21133 file into which Alpine will place the message to be downloaded.
21134 <P><UL>
21135 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21136 </UL><P>
21137 &lt;End of help on this topic&gt;
21138 </BODY>
21139 </HTML>
21140 ====== h_config_mailcap_path ======
21141 <HTML>
21142 <HEAD>
21143 <TITLE>OPTION: <!--#echo var="VAR_mailcap-search-path"--></TITLE>
21144 </HEAD>
21145 <BODY>
21146 <H1>OPTION: <!--#echo var="VAR_mailcap-search-path"--></H1>
21147 This variable is used to replace Alpine's default mailcap file search path.
21148 It takes one or more file names (full paths must be specified) in which to
21149 look for mail capability data.  The default search path can be found in this
21150 <A HREF="h_news_config">Alpine Configuration</A> help, near the bottom.
21151 If there is more than one file name listed, list members should be delimited
21152 by
21153 <!--chtml if pinemode="os_windows"-->
21154 a semi-colon (;) under Windows; for example:<PRE>
21155         C:&#92;MYCONFIG&#92;MAILCAP.TXT;H:&#92;NETCONFIG&#92;MAILCAP.TXT
21156 </PRE>
21157 <!--chtml else-->
21158 a colon (:) under UNIX; for example:<PRE>
21159         ~/.mailcap:/etc/mailcap:/usr/etc/mailcap:/usr/local/etc/mailcap
21160 </PRE>
21161 <!--chtml endif-->
21162 <P><UL>
21163 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21164 </UL>
21165 <P>
21166 &lt;End of help on this topic&gt;
21167 </BODY>
21168 </HTML>
21169 ====== h_config_mimetype_path ======
21170 <HTML>
21171 <HEAD>
21172 <TITLE>OPTION: <!--#echo var="VAR_mimetype-search-path"--></TITLE>
21173 </HEAD>
21174 <BODY>
21175 <H1>OPTION: <!--#echo var="VAR_mimetype-search-path"--></H1>
21176
21177 This variable is used to replace Alpine's default mime.types file search path.
21178 It takes one or more file names (full paths must be specified) in which to
21179 look for file-name-extension to MIME type mapping data.  The default search
21180 path can be found in this
21181 <A HREF="h_news_config">Alpine Configuration</A> help.
21182
21183 <P>
21184
21185 If there is more than one file name listed, list members should be delimited
21186 by a colon (:) under UNIX and a semi-colon (;) under Windows.
21187 <P>
21188 &lt;End of help on this topic&gt;
21189 </BODY></HTML>
21190 ====== h_config_set_att_ansi ======
21191 <HTML><HEAD>
21192 <TITLE>OPTION: Set printer to attached ansi printer</TITLE>
21193 </HEAD>
21194 <BODY>
21195 <H1>OPTION: Set printer to attached ansi printer</H1>
21196
21197 Type "S" to set your printer to "attached-to-ansi".<BR>
21198 It is OK to include "attached-to-ansi" in your personal list below.
21199 <P>
21200 &lt;End of help on this topic&gt;
21201 </BODY></HTML>
21202 ====== h_config_set_att_ansi2 ======
21203 <HTML><HEAD>
21204 <TITLE>OPTION: Set printer to attached ansi printer (no formfeed)</TITLE>
21205 </HEAD>
21206 <BODY>
21207 <H1>OPTION: Set printer to attached ansi printer (no formfeed)</H1>
21208
21209 Type "S" to set your printer to "attached-to-ansi-no-formfeed".<BR>
21210 It is OK to include "attached-to-ansi-no-formfeed" in your personal
21211 list below.
21212
21213 <P>
21214
21215 This is the same as the "attached-to-ansi" option except that a
21216 formfeed character will not be appended to the end of the print job.
21217 If your printer already ejects the paper by itself at the end of the
21218 job, you may prefer the "no-formfeed" form of this printer so that you
21219 don't get an extra blank page between print jobs.
21220 <P>
21221
21222 &lt;End of help on this topic&gt;
21223 </BODY></HTML>
21224 ====== h_config_set_att_wyse ======
21225 <HTML><HEAD>
21226 <TITLE>OPTION: Set printer to attached Wyse60 printer</TITLE>
21227 </HEAD>
21228 <BODY>
21229 <H1>OPTION: Set printer to attached Wyse60 printer</H1>
21230
21231 Type "S" to set your printer to "attached-to-wyse".<BR>
21232 It is OK to include "attached-to-wyse" in your personal list below.
21233 <P>
21234 This is very similar to "attached-to-ansi".
21235 The only difference is in the control characters sent to turn the printer
21236 on and off.
21237 The ansi version of the printer uses ESC LEFT_BRACKET 5 i
21238 to turn on the printer and ESC LEFT_BRACKET 4 i
21239 to turn it off.
21240 The Wyse version uses Ctrl-R for on, and Ctrl-T for off.
21241 &lt;End of help on this topic&gt;
21242 </BODY></HTML>
21243 ====== h_config_set_att_wyse2 ======
21244 <HTML><HEAD>
21245 <TITLE>OPTION: Set printer to attached Wyse60 printer (no formfeed)</TITLE>
21246 </HEAD>
21247 <BODY>
21248 <H1>OPTION: Set printer to attached Wyse60 printer (no formfeed)</H1>
21249
21250 Type "S" to set your printer to "attached-to-wyse-no-formfeed".<BR>
21251 It is OK to include "attached-to-wyse-no-formfeed" in your personal
21252 list below.
21253
21254 <P>
21255
21256 This is the same as the "attached-to-wyse" option except that a
21257 formfeed character will not be appended to the end of the print job.
21258 If your printer already ejects the paper by itself at the end of the
21259 job, you may prefer the "no-formfeed" form of this printer so that you
21260 don't get an extra blank page between print jobs.
21261 <P>
21262
21263 &lt;End of help on this topic&gt;
21264 </BODY></HTML>
21265 ====== h_config_set_stand_print ======
21266 <HTML>
21267 <HEAD>
21268 <TITLE>OPTION: Set default printer</TITLE>
21269 </HEAD>
21270 <H1>OPTION: Set default printer</H1>
21271 <BODY>
21272 Move to the printer you want and type "S" to set it to be your
21273 default printer.  This list is not modifiable by you and has been
21274 set up by the system administrators.  If there is more than one printer
21275 listed in the Command List, you will be able to cycle through that
21276 whole list at the time you print, starting with your default.
21277 It is OK to include entries from this Standard list in your personal
21278 list below.
21279 <P>
21280 &lt;End of help on this topic&gt;
21281 </BODY>
21282 </HTML>
21283 ====== h_config_set_custom_print ======
21284 <HTML>
21285 <HEAD>
21286 <TITLE>OPTION: Set default printer</TITLE>
21287 </HEAD>
21288 <H1>OPTION: Set default printer</H1>
21289 <BODY>
21290 You may add as many print commands as you want to your personal list.
21291 Specify one of them as your default printer by moving to the printer
21292 you want and typing "S".  If there is more than one printer listed
21293 in the Command List, you will be able to cycle through that list at
21294 the time you print, starting with your default.  It is OK to include
21295 entries from the Standard list above or to include the command
21296 "attached-to-ansi", "attached-to-ansi-no-formfeed", "attached-to-wyse", or
21297 "attached-to-wyse-no-formfeed" as one of the entries here.
21298 <P>
21299 &lt;End of help on this topic&gt;
21300 </BODY>
21301 </HTML>
21302 ====== h_config_user_id =====
21303 <HTML>
21304 <HEAD>
21305 <TITLE>OPTION: <!--#echo var="VAR_user-id"--></TITLE>
21306 </HEAD>
21307 <BODY>
21308 <H1>OPTION: <!--#echo var="VAR_user-id"--></H1>
21309
21310 This value is used as part of the "From" address on messages you send.
21311 It is also the default login name for remote IMAP server access.  Set this
21312 to the username part you want to appear on outgoing email.
21313 <P>
21314 If you want to change the value of what gets included in the From header
21315 in messages you send (other than just the User ID)
21316 look <A HREF="h_config_change_your_from">here</A> for a description.
21317
21318 <P><UL>
21319 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21320 </UL><P>
21321 &lt;End of help on this topic&gt;
21322 </BODY>
21323 </HTML>
21324 ====== h_config_user_dom =====
21325 <HTML>
21326 <HEAD>
21327 <TITLE>OPTION: <!--#echo var="VAR_user-domain"--></TITLE>
21328 </HEAD>
21329 <BODY>
21330 <H1>OPTION: <!--#echo var="VAR_user-domain"--></H1>
21331
21332 This value specifies the domain part (right-hand side) of your return
21333 address on outgoing email and is also used as the default domain for email
21334 composed to a local user.
21335 <!--chtml if pinemode="os_windows"-->
21336  This value is required for PC-Alpine. If you are unsure as to what this should be,
21337  contact your local help desk, system administrator, or Internet Service Provider.
21338 <!--chtml else-->
21339  If unset, Unix Alpine will obtain the domain from
21340  the system.  Often this value will be set for your whole site by the
21341  system administrator.<P>
21342 <!--chtml endif-->
21343 If you set this, see also the <A HREF="h_config_quell_local_lookup">
21344 &quot;<!--#echo var="FEAT_quell-user-lookup-in-passwd-file"-->&quot;</A> feature.
21345 <P>
21346 If you want to change the value of what gets included in the From header
21347 in messages you send (other than just the User Domain)
21348 look <A HREF="h_config_change_your_from">here</A> for a description.
21349 <P><UL>
21350 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21351 </UL><P>
21352 &lt;End of help on this topic&gt;
21353 </BODY>
21354 </HTML>
21355 ====== h_config_smtp_server =====
21356 <HTML>
21357 <HEAD>
21358 <TITLE>OPTION: <!--#echo var="VAR_smtp-server"--></TITLE>
21359 </HEAD>
21360 <BODY>
21361 <H1>OPTION: <!--#echo var="VAR_smtp-server"--></H1>
21362 This value specifies the name of one or more SMTP
21363 (Simple Mail Transfer Protocol) servers for sending mail.
21364 <!--chtml if pinemode="os_windows"-->
21365 You must have an SMTP server for use with PC-Alpine.
21366 SMTP servers are
21367 normally set up by a system administrator for use by all members of a given
21368 campus or department.
21369 Contact your local help desk to ask what SMTP
21370 servers you should use.
21371 <!--chtml else-->
21372 Unix Alpine users may not need to set an SMTP server.
21373 Alpine will attempt to execute the program (usually sendmail) that is used
21374 to insert mail into the mail system.
21375 If this works for you, you may leave this option blank.
21376 If there is an SMTP server running on the Unix host you may be able to
21377 improve sending performance slightly by setting the SMTP server option
21378 to &quot;localhost&quot; or to the actual name of the Unix host.
21379 <P>
21380 If the Unix host doesn't work the way Alpine was expecting you will need to
21381 set the value of this option.
21382 SMTP servers are
21383 normally set up by a system administrator for use by all members of a given
21384 campus or department.
21385 Contact your local help desk to ask what SMTP
21386 servers you should use.
21387 <!--chtml endif-->
21388 <P>
21389 Your SMTP server may offer SMTP AUTH authentication.
21390 It may even require it.
21391 If your SMTP server offers SMTP AUTH authentication you may specify a
21392 &quot;user&quot; name parameter to cause Alpine to attempt to authenticate.
21393 This parameter requires an associated value,
21394 the username identifier with which to establish the server
21395 connection.
21396 An example might be:
21397
21398 <P>
21399 <CENTER><SAMP>smtpserver.example.com/user=katie</SAMP></CENTER>
21400 <P>
21401
21402 If AUTH authentication is offered by the server, this will cause Alpine to
21403 attempt to use it.
21404 If AUTH authentication is not offered by the server, this will cause Alpine
21405 to fail sending with an error similar to:
21406
21407 <P>
21408 <CENTER><SAMP>Error: SMTP authentication not available</SAMP></CENTER>
21409 <P>
21410
21411 Another type of authentication that is used by some ISPs is called
21412 &quot;POP before SMTP&quot; or &quot;IMAP before SMTP&quot;,
21413 which means that you have to authenticate
21414 yourself to the POP or IMAP server by opening a mailbox before you
21415 can send mail.
21416 To do this, you usually only have to open your INBOX.
21417
21418 <P>
21419 You may tell Alpine to use the
21420 <A HREF="http://www.ietf.org/rfc/rfc2476.txt">Message Submission</A>
21421 port (587) instead of the SMTP port (25) by including the &quot;submit&quot;
21422 parameter
21423 in this option.
21424 At this time &quot;/submit&quot; is simply equivalent to specifying
21425 port 587, though it may imply more than that at some point in the future.
21426 Some ISPs are blocking port 25 in order to reduce the amount of spam
21427 being sent to their users.
21428 You may find that the submit option allows you to get around such a block.
21429
21430 <P>
21431 <CENTER><SAMP>smtpserver.example.com/submit</SAMP></CENTER>
21432 <P>
21433
21434 To specify any non-standard port number on the SMTP server you may follow
21435 the hostname with a colon followed by the portnumber.
21436
21437 <P>
21438 <CENTER><SAMP>smtpserver.example.com:12345</SAMP></CENTER>
21439 <P>
21440
21441 Normally, when a connection is made to the Smtp-Server Alpine will attempt
21442 to negotiate a secure (encrypted) session using Transport Layer Security (TLS).
21443 If that fails then a non-encrypted connection will be attempted instead.
21444 You may specify that a TLS connection is required if you wish.
21445 If you append &quot;/tls&quot; to the name then the connection will fail
21446 instead of falling back to a non-secure connection.
21447
21448 <P>
21449 <CENTER><SAMP>smtpserver.example.com/tls</SAMP></CENTER>
21450 <P>
21451
21452
21453 For more details about server name possibilities see
21454 <A HREF="h_folder_server_syntax">Server Name Syntax</A>.
21455 <P>
21456
21457 <UL>
21458 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21459 </UL>
21460 <P>
21461 &lt;End of help on this topic&gt;
21462 </BODY>
21463 </HTML>
21464 ====== h_config_nntp_server =====
21465 <HTML>
21466 <HEAD>
21467 <TITLE>OPTION: <!--#echo var="VAR_nntp-server"--></TITLE></HEAD>
21468 <BODY>
21469 <H1>OPTION: <!--#echo var="VAR_nntp-server"--></H1>
21470
21471 This value specifies the name of one or more NNTP
21472 (Network News Transfer Protocol)
21473 servers for reading and posting USENET news.
21474 NNTP servers are normally
21475 set up by a system administrator for use by all members of a given campus
21476 or department.
21477 Contact your local help desk to ask what NNTP servers you should use.
21478 <!--chtml if pinemode="os_windows"--><!--chtml else-->
21479 Often Unix Alpine users will find that this variable has been
21480 set for the whole system (and they don't have to worry about it).
21481 <!--chtml endif-->
21482 When you define an NNTP server here, Alpine implicitly defines a news
21483 collection for you, assuming that server as the news server and assuming
21484 that you will use the NNTP protocol and a local newsrc configuration file
21485 for reading news.
21486 For more about reading news with Alpine, see
21487 <A HREF="h_reading_news">how to use Alpine to read news</A>.
21488 <P>
21489 Your NNTP server may offer NNTP &quot;AUTHINFO SASL&quot;
21490 or &quot;AUTHINFO USER&quot; authentication.
21491 It may even require it.
21492 If your NNTP server does offer such authentication you may specify a user name
21493 parameter to cause Alpine to attempt to authenticate.
21494 The same is true for the server name in a folder collection that uses NNTP.
21495 This parameter requires an associated value,
21496 the username identifier with which to establish the server connection.
21497 An example might be:
21498
21499 <P>
21500 <CENTER><SAMP>nntpserver.example.com/user=katie</SAMP></CENTER>
21501 <P>
21502
21503 If authentication is offered by the server, this will cause Alpine to
21504 attempt to use it.
21505 If authentication is not offered by the server, this will cause Alpine
21506 to fail with an error similar to:
21507
21508 <P>
21509 <CENTER><SAMP>Error: NNTP authentication not available</SAMP></CENTER>
21510 <P>
21511 For more details about the server name possibilities see
21512 <A HREF="h_folder_server_syntax">Server Name Syntax</A>.
21513 <P><UL>
21514 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21515 </UL><P>
21516 &lt;End of help on this topic&gt;
21517 </BODY>
21518 </HTML>
21519 ====== h_config_inbox_path =====
21520 <HTML>
21521 <HEAD>
21522 <TITLE>OPTION: <!--#echo var="VAR_inbox-path"--></TITLE>
21523 </HEAD>
21524 <BODY>
21525 <H1>OPTION: <!--#echo var="VAR_inbox-path"--></H1>
21526
21527 This value overrides the default value of your INBOX name/path/location.
21528 <!--chtml if pinemode="os_windows"-->
21529 PC-Alpine users must specify an inbox path and it must be a folder on an
21530 IMAP server.
21531 <!--chtml else-->
21532 Unix and VMS Alpine users will often find that this variable
21533 has been pre-configured by your system administrator.
21534 <!--chtml endif-->
21535 You may be able to specify an alternate INBOX that is either a local folder
21536 or a folder on an IMAP server.
21537 <P>
21538 A typical remote <!--#echo var="VAR_inbox-path"--> entry would be: &#123;monet.art.example.com}INBOX
21539 where &quot;monet.art.example.com&quot; is replaced by the name of your IMAP
21540 mail server.
21541 <P>
21542 See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
21543 details on the syntax of folder definitions.
21544 <P>
21545 See <A HREF="h_info_on_mbox">Missing mail and the mbox driver</A> if your
21546 mail is disappearing.
21547 <P><UL>
21548 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21549 </UL><P>
21550 &lt;End of help on this topic&gt;
21551 </BODY>
21552 </HTML>
21553 ====== h_config_change_your_from =====
21554 <HTML>
21555 <HEAD>
21556 <TITLE>How to Change your From Address</TITLE>
21557 </HEAD>
21558 <BODY>
21559 <H1>How to Change your From Address</H1>
21560
21561 If the From address that Alpine includes in mail that you send is not correct,
21562 you may want to configure a different default value for the From address.
21563 You may follow these directions to change the default:
21564
21565 <P>
21566 <UL>
21567   <LI> Go to the Main Alpine Menu
21568   <LI> From there type the Setup Command
21569   <LI> From there type the Config Command
21570 </UL>
21571
21572 <P>
21573 You've probably already seen this SETUP CONFIGURATION screen.
21574 If not, there are many options you may want to set here.
21575 To set the value of the From header you may use the
21576 <A href="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A> option.
21577 Find it by scrolling down a few pages or use the WhereIs command to
21578 search for &quot;customized&quot;.
21579 You may want to read the help text associated with the option.
21580 <P>
21581 To add a custom From header, type the Add command and enter the
21582 full header line, including the leading &quot;From:&nbsp;&quot;.
21583 For example:
21584 <P>
21585 <CENTER><SAMP>From: Full Name &lt;user@example.com&gt;</SAMP></CENTER>
21586 <P>
21587 Now exit the Setup command and try sending mail to yourself to see
21588 what the From line looks like.
21589 <P>
21590 When you are in the composer you may edit the custom From line by typing
21591 Ctrl-R while your cursor is in the headers of the message and then moving
21592 to the From line and editing.
21593 If you want to leave the default value the same but add the possibility
21594 of being able to edit the header when you compose, add just the header
21595 name without a value.
21596 For example:
21597 <P>
21598 <CENTER><SAMP>From:</SAMP></CENTER>
21599 <P>
21600 If you change your From address you may also find it useful to add the
21601 changed From address to the
21602 <a href="h_config_alt_addresses"><!--#echo var="VAR_alt-addresses"--></a>
21603 configuration option.
21604 <P>
21605 <UL>
21606 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21607 </UL><P>
21608 &lt;End of help on this topic&gt;
21609 </BODY>
21610 </HTML>
21611 ====== h_config_default_fcc =====
21612 <HTML>
21613 <HEAD>
21614 <TITLE>OPTION: <!--#echo var="VAR_default-fcc"--></TITLE>
21615 </HEAD>
21616 <BODY>
21617 <H1>OPTION: <!--#echo var="VAR_default-fcc"--></H1>
21618
21619 This value specifies where a copy of outgoing mail should be saved.  If
21620 this is not a path name, it will be in the default collection for saves.
21621 Any valid folder specification, local or IMAP, is allowed.  This default
21622 folder carbon copy only applies when the
21623 <A HREF="h_config_fcc_rule">&quot;<!--#echo var="VAR_fcc-name-rule"-->&quot;</A>
21624 is set to use the default folder.
21625 <!--chtml if pinemode="os_windows"-->
21626 PC-Alpine default is &quot;SENTMAIL&quot; (normally stored as SENTMAIL.MTX)
21627 <!--chtml else-->
21628 Unix Alpine default
21629 is normally &quot;sent-mail&quot; in the default folder collection.
21630 <!--chtml endif-->
21631 <P>
21632 If you access your email through an IMAP server, especially if you often switch between Unix Alpine
21633 and PC-Alpine, or between various desktop email systems, you may want to set this to a folder on your
21634 IMAP server (remember that in order to later access this remote folder through Alpine, it
21635 must be in a folder collection. See <A HREF="h_what_are_collections">Folder Collections Explained</a>
21636 for more information). An example:<p>
21637 <CENTER><SAMP>{monet.art.example.com}mail/sent-mail</SAMP></CENTER>
21638 <P>
21639 To suppress saving of outgoing mail, set: <!--#echo var="VAR_default-fcc"-->=&quot;&quot;
21640 <P>
21641 See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
21642 details on the syntax of folder definitions.
21643 <P>
21644 <UL>
21645 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21646 </UL><P>
21647 &lt;End of help on this topic&gt;
21648 </BODY>
21649 </HTML>
21650 ====== h_config_def_save_folder =====
21651 <HTML>
21652 <HEAD>
21653 <TITLE>OPTION: <!--#echo var="VAR_default-saved-msg-folder"--></TITLE>
21654 </HEAD>
21655 <BODY>
21656 <H1>OPTION: <!--#echo var="VAR_default-saved-msg-folder"--></H1>
21657
21658 This option determines the default folder name for save-message operations
21659 (&quot;saves&quot;).
21660 <P>
21661 If this is not a path name, it will be in the default collection for saves.
21662 Any valid folder specification, local or IMAP, is allowed.  This default
21663 folder only applies when the
21664 <A HREF="h_config_saved_msg_name_rule">&quot;<!--#echo var="VAR_saved-msg-name-rule"-->&quot;</A>
21665 doesn't override it.
21666 <!--chtml if pinemode="os_windows"-->
21667 PC-Alpine default is &quot;SAVEMAIL&quot; (normally stored as SAVEMAIL.MTX).
21668 <!--chtml else-->
21669 Unix Alpine default
21670 is normally &quot;saved-messages&quot; in the default folder collection.
21671 <!--chtml endif-->
21672 If you access your email through an IMAP server, especially if you often switch between Unix
21673 and PC-Alpine, or between various desktop email systems, you may want to set this to a folder on an
21674 IMAP server (remember that in order to later access this remote folder through Alpine, it
21675 should be in a folder collection. See <A HREF="h_what_are_collections">Folder Collections Explained</a>
21676 for more information). An example:<p>
21677 <CENTER><SAMP>{monet.art.example.com}mail/saved-messages</SAMP></CENTER>
21678 <P>
21679 See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
21680 details on the syntax of folder definitions.
21681 <P>
21682 <UL>
21683 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21684 </UL><P>
21685 &lt;End of help on this topic&gt;
21686 </BODY>
21687 </HTML>
21688 ====== h_config_postponed_folder =====
21689 <HTML>
21690 <HEAD>
21691 <TITLE>OPTION: <!--#echo var="VAR_postponed-folder"--></TITLE>
21692 </HEAD>
21693 <BODY>
21694 <H1>OPTION: <!--#echo var="VAR_postponed-folder"--></H1>
21695
21696 This value overrides the default name for the folder where postponed
21697 messages are saved.  If this is not a path name, it will be in the default
21698 collection for message Saves.  Any valid folder specification, local or
21699 remote, is allowed.
21700 PC-Alpine default
21701 is &quot;POSTPOND&quot; (stored as POSTPOND.MTX).
21702 The Unix Alpine default is normally &quot;postponed-msgs&quot;
21703 in the default collection.
21704 <P>
21705 Tip: If you are using different installations of (PC-)Alpine -- for example, PC-Alpine on your personal
21706 computer at home, and Unix Alpine on campus -- you can postpone a composition begun with one Alpine and
21707 resume it later with the other if you set this option to the <B>same folder on the same IMAP host</B>
21708 in all Alpine copies you use.
21709 (Remember that in order to later access this remote folder through Alpine, it must be in a folder
21710 collection. See <A HREF="h_what_are_collections">Folder Collections Extensions Explained</a>
21711 for more information). An
21712 example:<p>
21713 <CENTER><SAMP>{monet.art.example.com}mail/postponed-msgs</SAMP></CENTER>
21714 <P>
21715 See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
21716 details on the syntax of folder definitions.
21717 <P>
21718 <UL>
21719 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21720 </UL><P>
21721 &lt;End of help on this topic&gt;
21722 </BODY>
21723 </HTML>
21724 ====== h_config_read_message_folder =====
21725 <HTML>
21726 <HEAD>
21727 <TITLE>OPTION: <!--#echo var="VAR_read-message-folder"--></TITLE>
21728 </HEAD>
21729 <BODY>
21730 <H1>OPTION: <!--#echo var="VAR_read-message-folder"--></H1>
21731
21732 By virtue of specifying a folder name here, Alpine will be configured to
21733 save all messages that you have read during a session into the designated
21734 &quot;read messages&quot; folder.  This allows you to more easily distinguish
21735 between your really new email (in your INBOX) and those that you have
21736 already read.  Depending on how you define the
21737 <A HREF="h_config_auto_read_msgs">&quot;auto-move-read-messages&quot;</A>
21738 setting, you may or may not be asked when you quit
21739 Alpine if you want read messages to be moved to this folder.  In either
21740 case, moving the messages means they will be deleted from your INBOX.
21741 <P>
21742 If this is not a path name, it will be in the default collection for
21743 saves.  Any valid folder specification, local or remote (via IMAP), is
21744 allowed.  There is no default for the name of the read message folder.
21745 <P>
21746 See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
21747 details on the syntax of folder definitions.
21748 <P>
21749 <UL>
21750 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21751 </UL><P>
21752 &lt;End of help on this topic&gt;
21753 </BODY>
21754 </HTML>
21755 ====== h_config_form_folder =====
21756 <HTML>
21757 <HEAD>
21758 <TITLE>OPTION: <!--#echo var="VAR_form-letter-folder"--></TITLE>
21759 </HEAD>
21760 <BODY>
21761 <H1>OPTION: <!--#echo var="VAR_form-letter-folder"--></H1>
21762
21763 A &quot;<!--#echo var="VAR_form-letter-folder"-->&quot; is a mail folder that is intended to
21764 contain messages that you have composed and that are intended to be
21765 sent in their original form repeatedly.
21766
21767 <P>
21768 Setting this variable will alter Alpine's usual behavior when you
21769 execute the Compose command.  Normally, Alpine offers a chance to
21770 continue a postponed or interrupted message should one or the other
21771 exist.  When this variable is set to a folder name that exists, Alpine
21772 will also offer the chance to select a message from the folder to
21773 insert into the composer (much like when continuing a postponed message).
21774 The difference, however, is that Alpine will not automatically delete
21775 the selected message from the Form Letter Folder.
21776 <P>
21777 Setting this variable will also affect Alpine's behavior when you
21778 Postpone a message from the composer.  Normally, Alpine simply stashes
21779 the message away in your
21780 &quot;<A HREF="h_config_postponed_folder"><!--#echo var="VAR_postponed-folder"--></A>&quot;.
21781 Regardless of the specified folder's existence, Alpine will ask which
21782 folder you intend the message to be stored in.  Choose the
21783 &quot;F&quot; option to store the message in your Form Letter Folder.
21784 This is the most common way to add a message to the folder.
21785
21786 <P>
21787 Another method of adding messages to the folder is via the Alpine
21788 composer's <SAMP>Fcc:</SAMP> field.  If you are sending a message that
21789 you expect to send in the same form again, you can enter the Form
21790 Letter Folder's name in this field.  Alpine, as usual, will copy the
21791 message as it's sent.  Note, when you later select this message from
21792 your Form Letter Folder, it will have the same recipients as the original
21793 message.
21794
21795 <P>
21796 To delete a message from the Form Letter Folder, you can either select
21797 the folder from a suitable FOLDER LIST screen, or use the Delete
21798 command in the MESSAGE INDEX offered when selecting from the folder as
21799 part of the Compose command.  You can delete a Form Letter Folder just
21800 as any other folder from a suitable FOLDER LIST screen.
21801
21802 <P>
21803 You may find that the <A HREF="h_rules_roles">&quot;Roles&quot;</A>
21804 facility can be used
21805 to replace the Form Letter Folder.
21806
21807 <P>
21808 See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
21809 details on the syntax of folder definitions.
21810
21811 <P>
21812 <UL>
21813 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21814 </UL><P>
21815 &lt;End of help on this topic&gt;
21816 </BODY>
21817 </HTML>
21818 ====== h_config_archived_folders =====
21819 <HTML>
21820 <HEAD>
21821 <TITLE>OPTION: <!--#echo var="VAR_incoming-archive-folders"--></TITLE>
21822 </HEAD>
21823 <BODY>
21824 <H1>OPTION: <!--#echo var="VAR_incoming-archive-folders"--></H1>
21825
21826 This is like
21827 <A HREF="h_config_read_message_folder"><!--#echo var="VAR_read-message-folder"--></A>,
21828 only more general.  You may archive
21829 any of the folders in your incoming collection.  This is a list of folder
21830 pairs, with the first separated from the second in the pair by a space.
21831 The first folder in a pair is the folder you want to archive, and the
21832 second folder is the folder that read messages from the first should be
21833 moved to.  Depending on how you define the
21834 <A HREF="h_config_auto_read_msgs">&quot;auto-move-read-messages&quot;</A>
21835 setting, you may or may not be asked when you
21836 leave the first folder if you want read messages to be moved to the
21837 second folder.  In either case, moving the messages means they will be
21838 deleted from the first folder.
21839 <P>
21840 The name of the first folder in each pair can be either the technical
21841 specification of the folder (like what appears in your configuration file)
21842 or (much easier) the nickname that you gave the folder when you made it
21843 an incoming folder.
21844 <p>
21845 For example:<p>
21846 <CENTER><SAMP>{monet.art.example.com}inbox {monet.art.example.com}mail/inbox-archive</SAMP></CENTER>
21847 <p>or, using nicknames:<p>
21848 <CENTER><SAMP>inbox inbox-archive</SAMP></CENTER>
21849 <P>
21850 If these are not path names, they will be in the default collection for
21851 saves. Any valid folder specification, local or remote (via IMAP), is
21852 allowed. There is no default.
21853 <P>
21854 See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
21855 details on the syntax of folder definitions.
21856 <P>
21857 <UL>
21858 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21859 </UL><P>
21860 &lt;End of help on this topic&gt;
21861 </BODY>
21862 </HTML>
21863 ====== h_config_newsrc_path ======
21864 <HTML>
21865 <HEAD>
21866 <TITLE>OPTION: <!--#echo var="VAR_newsrc-path"--></TITLE>
21867 </HEAD>
21868 <BODY>
21869 <H1>OPTION: <!--#echo var="VAR_newsrc-path"--></H1>
21870
21871 This option overrides the default name Alpine uses for your "newsrc" news
21872 status and subscription file.  If set, Alpine will take this value as the
21873 full pathname for the desired newsrc file.<P>
21874
21875 If this option is <B>not</B> set,
21876 <!--chtml if pinemode="os_windows"-->
21877 PC-Alpine looks first for $HOME&#92;NEWSRC (where $HOME defaults to the root
21878 of the current drive, e.g. &quot;C:&#92;&quot;) and then it looks in the same
21879 directory as your pinerc file for NEWSRC.
21880 <!--chtml else-->
21881 Unix Alpine looks for the file ~/.newsrc (that is, the file named .newsrc in
21882 your account's home directory).
21883 <!--chtml endif-->
21884 <P><UL>
21885 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21886 </UL>
21887 <P>
21888 &lt;End of help on this topic&gt;
21889 </BODY>
21890 </HTML>
21891 ====== h_config_literal_sig =====
21892 <HTML>
21893 <HEAD>
21894 <TITLE>OPTION: <!--#echo var="VAR_literal-signature"--></TITLE>
21895 </HEAD>
21896 <BODY>
21897 <H1>OPTION: <!--#echo var="VAR_literal-signature"--></H1>
21898
21899 With this option your actual signature, as opposed to
21900 the name of a file containing your signature,
21901 is stored in the Alpine configuration file.
21902 If this is defined it takes precedence over the <!--#echo var="VAR_signature-file"--> option.
21903 <P>
21904
21905 This is simply a different way to store the signature.
21906 The signature is stored inside your Alpine configuration file instead of in
21907 a separate file.
21908 Tokens work the same way they do with the
21909 <A HREF="h_config_signature_file"><!--#echo var="VAR_signature-file"--></A> so look there for
21910 help.
21911 <P>
21912
21913 The Setup/Signature command on Alpine's MAIN MENU will edit
21914 the &quot;<!--#echo var="VAR_literal-signature"-->&quot; by default.  However, if no
21915 &quot;<!--#echo var="VAR_literal-signature"-->&quot; is defined and the file named in the
21916 &quot;<!--#echo var="VAR_signature-file"-->&quot; option exists, then the latter will be used
21917 instead.
21918 <P>
21919
21920 The two character sequence &#92;n (backslash followed by
21921 the character n) will be used to signify a line-break in your signature.
21922 You don't have to enter the &#92;n, but it will be visible in the
21923 SETUP CONFIGURATION window after you are done editing the signature.
21924
21925 <P>
21926 <UL>
21927 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21928 </UL><P>
21929 &lt;End of help on this topic&gt;
21930 </BODY>
21931 </HTML>
21932 ====== h_config_signature_file =====
21933 <HTML>
21934 <HEAD>
21935 <TITLE>OPTION: <!--#echo var="VAR_signature-file"--></TITLE>
21936 </HEAD>
21937 <BODY>
21938 <H1>OPTION: <!--#echo var="VAR_signature-file"--></H1>
21939
21940 If a <A HREF="h_config_literal_sig"><!--#echo var="VAR_literal-signature"--></A> option is defined,
21941 then this &quot;<!--#echo var="VAR_signature-file"-->&quot; option will be ignored.
21942 You can tell that that is the case because the value of the
21943 &quot;<!--#echo var="VAR_signature-file"-->&quot; will show up as
21944 <P>
21945 <CENTER><SAMP>&lt;Ignored: using <!--#echo var="VAR_literal-signature"--> instead&gt;</SAMP></CENTER>
21946 <P>
21947 You may either use all Literal Signatures (signatures stored in your
21948 configuration file) throughout Alpine, or all signature files.
21949 You can't mix the two.
21950 <P>
21951 This is the name of a file that will be automatically inserted into
21952 outgoing messages.
21953 It typically contains information such as your
21954 name, email address and organizational affiliation.
21955 Alpine adds the
21956 signature into the message as soon as you enter the composer so you
21957 can choose to remove it or edit it on a message by message basis.
21958 Signature file placement in message replies is controlled by the
21959 &quot;<A HREF="h_config_sig_at_bottom"><!--#echo var="FEAT_signature-at-bottom"--></A>&quot;
21960 setting in the feature list.
21961 <P>
21962
21963 The default file name is
21964 <!--chtml if pinemode="os_windows"-->
21965 &quot;PINE.SIG&quot; in the same directory as your PINERC file if your
21966 PINERC file is a local file.
21967 If your PINERC file is remote, then it will be in the directory specified
21968 by the &quot;-aux local_directory&quot; command line option.
21969 <!--chtml else-->
21970 &quot;.signature&quot;.
21971 <!--chtml endif-->
21972 <P>
21973
21974 To create or edit your signature file choose Setup from the MAIN MENU
21975 and then select S for Signature (Main/Setup/Signature).  This puts you
21976 into the Signature Editor where you can enter a <EM>few</EM> lines of
21977 text containing your identity and affiliation.
21978
21979 <P>
21980 If the filename is followed by a vertical bar (|) then instead
21981 of reading the contents of the file the file is assumed to be a
21982 program that will produce the text to be used on its standard output.
21983 The program can't have any arguments and doesn't receive any input from Alpine,
21984 but the rest of the processing works as if the contents came from a file.
21985
21986 <P>
21987 Instead of storing the data in a local file, the
21988 signature data may be stored remotely in an IMAP folder.
21989 In order to do this,
21990 you must use a remote name for the file.
21991 A remote <!--#echo var="VAR_signature-file"--> name might look like:
21992 <P>
21993 <CENTER><SAMP>{myimaphost.myschool.k12.wa.us}mail/signature</SAMP></CENTER>
21994 <P>
21995
21996 The syntax used here is the same as the syntax used for remote configuration
21997 files from the command line.
21998 Note that you may not access an existing signature file remotely,
21999 you have to create a new <EM>folder</EM> that contains the signature data.
22000 If the name you use here for the signature file is a remote name, then when
22001 you edit the file from the Setup/Signature command the data will be stored
22002 remotely in the folder.
22003 You aren't required to do anything special to create the folder, it
22004 gets created automatically if you use a remote name.
22005
22006 <P>
22007 Besides regular text, the signature file may also contain
22008 (or a signature program may produce) tokens that
22009 are replaced with text that usually depends on the message you are replying
22010 to or forwarding.
22011 For example, if the signature file contains the token
22012 <P>
22013 <CENTER><SAMP>_DATE_</SAMP></CENTER>
22014 <P>
22015 anywhere in the text, then that token is replaced by the date
22016 the message you are replying to or forwarding was sent.
22017 If it contains
22018 <P>
22019 <CENTER><SAMP>_CURDATE_</SAMP></CENTER>
22020 <P>
22021 that is replaced with the current date.
22022 The first is an example of a token that depends on the message you
22023 are replying to (or forwarding) and the second is an example which
22024 doesn't depend on anything other than the current date.
22025 You have to be a little careful with this facility since tokens that
22026 depend on the message you are replying to or forwarding will be replaced
22027 by nothing in the case where you are composing a new message from scratch.
22028 The use of <A HREF="h_rules_roles">&quot;roles&quot;</A> may help you
22029 in this respect.
22030 It allows you to use different signature files in different cases.
22031 <P>
22032
22033 The list of tokens available for use in the signature file is
22034 <A HREF="h_index_tokens">here</A>.
22035 <P>
22036
22037 Instead of, or along with the use of &quot;roles&quot; to give you
22038 different signature files in different situations, there is also
22039 a way to conditionally include text based
22040 on whether or not a token would result in specific replacement text.
22041 For example, you could include some text based on whether or not
22042 the _NEWS_ token would result in any newsgroups if it was used.
22043 This is explained in detail
22044 <A HREF="h_reply_token_conditionals">here</A>.
22045 This isn't for the faint of heart.
22046 <P>
22047 In the very unlikely event that you want to include a literal token
22048 in the signature you must precede it with a backslash character.
22049 For example,
22050 <P>
22051 <CENTER><SAMP>&#92;_DAYDATE_ = _DAYDATE_</SAMP></CENTER>
22052 <P>
22053 would produce something like
22054 <P>
22055 <CENTER><SAMP>_DAYDATE_ = Sat, 24 Oct 1998</SAMP></CENTER>
22056 <P>
22057 It is not possible to have a literal backslash followed by an expanded token.
22058 <P>
22059 An alternate method for storing the signature data is available by using the
22060 <A HREF="h_config_literal_sig"><!--#echo var="VAR_literal-signature"--></A> configuration option.
22061 This variable will be used by default.
22062 <P>
22063 <UL>
22064 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22065 </UL><P>
22066 &lt;End of help on this topic&gt;
22067 </BODY>
22068 </HTML>
22069 ====== h_config_init_cmd_list =====
22070 <HTML>
22071 <HEAD>
22072 <TITLE>OPTION: <!--#echo var="VAR_initial-keystroke-list"--></TITLE>
22073 </HEAD>
22074 <BODY>
22075 <H1>OPTION: <!--#echo var="VAR_initial-keystroke-list"--></H1>
22076
22077 The initial keystroke--or command--list option lets you start Alpine at
22078 any place you like.
22079 Whatever keystrokes you specify here will be executed
22080 by Alpine upon startup as a macro.
22081 The words SPACE, TAB, DOWN, UP, LEFT, and
22082 RIGHT indicate the pressing of those keys.
22083 CR indicates the pressing of the RETURN key.
22084 F1 through F12 represent the function keys, and ^ followed
22085 by a character indicates that key pressed along with the control key (in
22086 other words, ^P means Ctrl-P).
22087 As a shortcut notation, an element of the list may be several characters
22088 surrounded by double-quotes (").
22089 That will be expanded into the individual keystrokes
22090 (excluding the double-quote characters).
22091 For example, the quoted-string
22092
22093 <P><CENTER>"ABC"</CENTER>
22094
22095 <P>
22096 is interpreted the same as the three separate list members
22097
22098 <P><CENTER>A and B and C</CENTER>
22099
22100 <P>
22101 which is also the same as
22102
22103 <P><CENTER>A,B,C</CENTER>
22104
22105 <P>
22106 An example: To view message 1 on startup,
22107 you could use an <!--#echo var="VAR_initial-keystroke-list"--> equal to
22108
22109 <P><CENTER>I,J,1,CR,V</CENTER>
22110
22111 <P>
22112 An equivalent version of this is
22113
22114 <P><CENTER>"IJ1",CR,V</CENTER>
22115
22116 <P>
22117 Restrictions: You cannot pre-type into the composer with the initial
22118 keystroke list, and you cannot mix function key commands with letter
22119 commands.
22120
22121 <P><UL>
22122 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22123 </UL>
22124 <P>
22125 &lt;End of help on this topic&gt;
22126 </BODY>
22127 </HTML>
22128 ====== h_config_comp_hdrs =====
22129 <html>
22130 <header>
22131 <title>OPTION: <!--#echo var="VAR_default-composer-hdrs"--></title>
22132 </header>
22133 <body>
22134 <h1>OPTION: <!--#echo var="VAR_default-composer-hdrs"--></h1>
22135
22136 You can control which headers you want visible when composing outgoing
22137 email using this option.
22138 You can specify any of the regular set, any
22139 <A HREF="h_compose_richhdr">Rich Header</A>,
22140 or any <A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A>
22141 that you have already defined.
22142 If you use this setting at all, you must specify all the
22143 headers you want to see, you can't just add to the regular header set.
22144 The default set is To:, Cc:, Attchmnt:, and Subject:.<p>
22145
22146 Note that the "Newsgroups:" header will be abbreviated in the Composer
22147 display, but should be spelled out in full here.<p>
22148 <UL>
22149 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22150 </UL><P>
22151 &lt;End of help on this topic&gt;
22152 </body>
22153 </html>
22154 ====== h_config_custom_hdrs =====
22155 <HTML>
22156 <HEAD>
22157 <TITLE>OPTION: <!--#echo var="VAR_customized-hdrs"--></TITLE>
22158 </HEAD>
22159 <BODY>
22160 <H1>OPTION: <!--#echo var="VAR_customized-hdrs"--></H1>
22161
22162 You may add your own custom headers to outgoing messages.
22163 Each header you specify here must include the header tag
22164 (<A HREF="h_composer_reply_to">Reply-To:</A>, Approved:, etc.)
22165 and may optionally include a value for that header.
22166 If you want to see these custom headers each time you compose a message,
22167 you must add them to your
22168 <A HREF="h_config_comp_hdrs"><!--#echo var="VAR_default-composer-hdrs"--></A> list,
22169 otherwise they become part
22170 of the rich header set that you only see when you press the
22171 <A HREF="h_compose_richhdr">Rich Header</A>
22172 <!--chtml if pinemode="function_key"-->(F5)
22173 <!--chtml else-->(Ctrl-R)<!--chtml endif--> command.
22174 (If you are looking for a way to change which headers are <EM>displayed</EM>
22175 when you view a message, take a look at the
22176 <A HREF="h_config_viewer_headers"><!--#echo var="VAR_viewer-hdrs"--></A>
22177 option instead.)
22178 Here's an example that shows how you might set your From address
22179 <P>
22180 <CENTER><SAMP>From: Full Name &lt;user@example.com&gt;</SAMP></CENTER>
22181 <P>
22182 and another showing how you might set a Reply-To address
22183 <P>
22184 <CENTER><SAMP>Reply-To: user@example.com</SAMP></CENTER>
22185 <P>
22186 You may also set non-standard header values here.
22187 For example, you could add
22188 <P>
22189 <CENTER><SAMP>Organization: My Organization Name</SAMP></CENTER>
22190 <P>
22191 or even
22192 <P>
22193 <CENTER><SAMP>X-Favorite-Colors: Purple and Gold</SAMP></CENTER>
22194 <P>
22195 If you include a value after the colon then that header will be included
22196 in your outgoing messages unless you delete it before sending.
22197 If a header in the <!--#echo var="VAR_customized-hdrs"--> list has only a tag but no value, then
22198 it will not be included in outgoing messages unless you edit a value
22199 in manually.
22200 For example, if
22201 <P>
22202 <CENTER><SAMP>Reply-To:</SAMP></CENTER>
22203 <P>
22204 is in the list, then the Reply-To header will be available for editing
22205 but won't be included unless a value is added while in the composer.
22206 <P>
22207 It's actually a little more complicated than that.
22208 The values of headers that you set with the <!--#echo var="VAR_customized-hdrs"--> option are
22209 defaults.
22210 If the message you are about to compose already has a value for a header,
22211 that value is used instead of a value from your <!--#echo var="VAR_customized-hdrs"-->.
22212 For example, if you are Replying to a message the Subject field
22213 will already be filled in.
22214 In that case, if the <!--#echo var="VAR_customized-hdrs"--> list contains a Subject line, the
22215 custom subject will <EM>NOT</EM> be used.
22216 The subject derived from the subject of the message you are Replying
22217 to will be used instead.
22218 <P>
22219 It is also possible to make header setting even more complicated and more
22220 automatic by using
22221 <A HREF="h_rules_roles">Roles</A>,
22222 but if all you want to do is set a default value for a header, you don't
22223 need to think about Roles.
22224 <P>
22225 If you change your From address you may also find it useful to add the
22226 changed From address to the
22227 <a href="h_config_alt_addresses"><!--#echo var="VAR_alt-addresses"--></a>
22228 configuration option.
22229 <P>
22230 Limitation: Because commas are used to separate the list of
22231 <!--#echo var="VAR_customized-hdrs"-->, it is not possible to have the value of a
22232 header contain a comma.
22233 Nor is there currently an &quot;escape&quot; mechanism provided
22234 to make this work.
22235 <P><UL>
22236 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22237 </UL>
22238 <P>
22239 &lt;End of help on this topic&gt;
22240 </BODY>
22241 </HTML>
22242 ====== h_config_viewer_headers =====
22243 <HTML>
22244 <HEAD>
22245 <TITLE>OPTION: <!--#echo var="VAR_viewer-hdrs"--></TITLE>
22246 </HEAD>
22247 <BODY>
22248 <H1>OPTION: <!--#echo var="VAR_viewer-hdrs"--></H1>
22249
22250 You may change the default list of headers that are viewed by listing
22251 the headers you want to view here.  If the headers in your
22252 &quot;<!--#echo var="VAR_viewer-hdrs"-->&quot; list are present in the message, then they
22253 will be shown.  The order of the headers you list will be honored.  If
22254 the special value &quot;all-except&quot; is included as the first
22255 header in the &quot;<!--#echo var="VAR_viewer-hdrs"-->&quot; list, then all headers in the
22256 message except those in the list will be shown.  The values are all
22257 case insensitive.
22258
22259 <P>
22260 Note that once you put anything in the &quot;<!--#echo var="VAR_viewer-hdrs"-->&quot; list,
22261 then the original default headers are ignored.  So, if you just wanted
22262 to add the header Organization to the list, you would have to list
22263 Organization plus all of the other headers originally in the default
22264 list.  If you just included Organization and nothing else, then you
22265 would see only the Organization header, nothing else.
22266
22267 <P>
22268 The default list of headers includes:
22269 <UL>
22270   <LI>From
22271   <LI>Resent-From
22272   <LI>To
22273   <LI>Resent-To
22274   <LI>Cc
22275   <LI>Resent-cc
22276   <LI>Bcc
22277   <LI>Newsgroups
22278   <LI>Followup-To
22279   <LI>Date
22280   <LI>Resent-Date
22281   <LI>Subject
22282   <LI>Resent-Subject
22283   <LI>Reply-To
22284 </UL>
22285
22286 <P>
22287 If you are looking for a way to control which headers are included in
22288 outgoing mail and are visible or not in the composer, take a look at the
22289 options
22290 <A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A>
22291 and <A HREF="h_config_comp_hdrs"><!--#echo var="VAR_default-composer-hdrs"--></A> instead of
22292 this option.
22293 <P>
22294 <UL>
22295 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22296 </UL><P>
22297 &lt;End of help on this topic&gt;
22298 </BODY>
22299 </HTML>
22300 ====== h_config_viewer_margin_left =====
22301 <HTML>
22302 <HEAD>
22303 <TITLE>OPTION: <!--#echo var="VAR_viewer-margin-left"--></TITLE>
22304 </HEAD>
22305 <BODY>
22306 <H1>OPTION: <!--#echo var="VAR_viewer-margin-left"--></H1>
22307
22308 This variable controls the left-hand vertical margin's width in
22309 Alpine's Message Viewing screen.
22310 Its value is the number of space characters preceding each displayed line.
22311 For consistency with
22312 <A HREF="h_config_viewer_margin_right"><!--#echo var="VAR_viewer-margin-right"--></A>,
22313 you may specify the column number to start in
22314 (column numbering begins with number 1)
22315 instead of the width of the margin by appending a lower case letter
22316 &quot;c&quot; to the number.
22317 For example, a value of &quot;2c&quot; means to start the text in column two,
22318 which is entirely equivalent to a value of &quot;1&quot;, which means to
22319 leave a margin of 1 space.
22320 <P>
22321 The default is a left margin of 0 (zero).
22322 Misconfigurations (for example, negative values or values with starting
22323 left columns greater than the ending right column)
22324 are silently ignored.
22325 If the number of columns for text between the <!--#echo var="VAR_viewer-margin-left"--> and
22326 the <!--#echo var="VAR_viewer-margin-right"--> is fewer than 8, then margins of zero will be used
22327 instead.
22328
22329 <P>
22330 &lt;End of help on this topic&gt;
22331 </BODY>
22332 </HTML>
22333 ====== h_config_viewer_margin_right =====
22334 <HTML>
22335 <HEAD>
22336 <TITLE>OPTION: <!--#echo var="VAR_viewer-margin-right"--></TITLE>
22337 </HEAD>
22338 <BODY>
22339 <H1>OPTION: <!--#echo var="VAR_viewer-margin-right"--></H1>
22340
22341 This variable controls the right-hand vertical margin's width in
22342 Alpine's Message Viewing screen.
22343 Its value is the number of space characters following each displayed line.
22344 You may specify the column number to end the text in
22345 (column numbering begins with number 1)
22346 instead of the width of the margin by appending a lower case letter
22347 &quot;c&quot; to the number.
22348 For example, a value of &quot;76c&quot; means to end the text in column 76.
22349 If the screen is 80 characters wide, this is equivalent to a value
22350 of &quot;4&quot;, which means to leave a margin of 4 spaces.
22351 However, if you use different size screens at different times, then these
22352 two values are not equivalent.
22353 <P>
22354 The default right margin is 4.
22355 Misconfigurations (for example, negative values or values with starting
22356 left columns greater than the ending right column)
22357 are silently ignored.
22358 If the number of columns for text between the
22359 <A HREF="h_config_viewer_margin_left"><!--#echo var="VAR_viewer-margin-left"--></A> and
22360 the <!--#echo var="VAR_viewer-margin-right"--> is fewer than 8, then margins of zero will be used
22361 instead.
22362
22363 <P>
22364 &lt;End of help on this topic&gt;
22365 </BODY>
22366 </HTML>
22367 ====== h_config_quote_suppression =====
22368 <HTML>
22369 <HEAD>
22370 <TITLE>OPTION: <!--#echo var="VAR_quote-suppression-threshold"--></TITLE>
22371 </HEAD>
22372 <BODY>
22373 <H1>OPTION: <!--#echo var="VAR_quote-suppression-threshold"--></H1>
22374
22375 This option should be used with care.
22376 It will cause some of the quoted text to be eliminated from the
22377 display when viewing a message in the MESSAGE TEXT screen.
22378 For example, if you set the <!--#echo var="VAR_quote-suppression-threshold"--> to the
22379 value &quot;5&quot;,
22380 this will cause quoted text that is longer than five lines to be truncated.
22381 Quoted text of five or fewer consecutive lines will be displayed in its entirety.
22382 Quoted text of more than six lines will have the first five lines displayed
22383 followed by a line that looks something like
22384 <P>
22385 <CENTER><SAMP>[ 12 lines of quoted text hidden from view ]</SAMP></CENTER>
22386 <P>
22387 As a special case, if exactly one line of quoted text would be hidden, the
22388 entire quote will be shown instead.
22389 So for the above example, quoted text that is exactly six lines long will
22390 will be shown in its entirety.
22391 (In other words, instead of hiding a single line and adding a line
22392 that announces that one line was hidden, the line is just shown.)
22393 <P>
22394 If the sender of a message has carefully chosen the quotes that he or she
22395 includes, hiding those quotes may change the meaning of the message.
22396 For that reason, Alpine requires that when you want to set the value of this
22397 variable to something less than four lines, you actually have to set it
22398 to the negative of that number.
22399 So if you want to set this option to &quot;3&quot;, you actually have to
22400 set it to &quot;-3&quot;.
22401 The only purpose of this is to get you to think about whether or not you
22402 really want to do this!
22403 If you want to delete all quoted text you set the value of this option
22404 to the special value &quot;-10&quot;.
22405 <P>
22406 The legal values for this option are
22407 <P>
22408 <TABLE>
22409 <TR>
22410   <TD> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </TD>
22411   <TD> Default, don't hide anything </TD>
22412 </TR>
22413 <TR>
22414   <TD> &nbsp;-1,-2,-3&nbsp;&nbsp; </TD>
22415   <TD> Suppress quote lines past 1, 2, or 3 lines </TD>
22416 </TR>
22417 <TR>
22418   <TD> &nbsp;4,5,6,...&nbsp; </TD>
22419   <TD> Suppress if more than that many lines </TD>
22420 </TR>
22421 <TR>
22422   <TD> &nbsp;&nbsp;&nbsp;-10&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </TD>
22423   <TD> Suppress all quoted lines </TD>
22424 </TR>
22425 </TABLE>
22426 <P>
22427 If you set this option to a non-default value you may sometimes wish to
22428 view the quoted text that is not shown.
22429 When this is the case, the
22430 <A HREF="h_common_hdrmode">HdrMode Command</A>
22431 may be used to show the hidden text.
22432 Typing the &quot;H&quot; command once will show the hidden text.
22433 Typing a second &quot;H&quot; will also turn on Full Header mode.
22434 The presence or absence of the HdrMode command is determined by the
22435 <A HREF="h_config_enable_full_hdr">&quot;<!--#echo var="FEAT_enable-full-header-cmd"-->&quot;</A>
22436 Feature-List option in your Alpine configuration, so you will want to
22437 be sure that is turned on if you use quote suppression.
22438 <P>
22439 For the purposes of this option, a quote is a line that begins with the
22440 character &quot;&gt;&quot;.
22441 <P>
22442 Quotes are only suppressed when displaying a message on the screen.
22443 The entire quote will be left intact when printing or forwarding or something
22444 similar.
22445 <P>
22446 &lt;End of help on this topic&gt;
22447 </BODY>
22448 </HTML>
22449 ====== h_config_saved_msg_name_rule =====
22450 <HTML>
22451 <HEAD>
22452 <TITLE>OPTION: <!--#echo var="VAR_saved-msg-name-rule"--></TITLE>
22453 </HEAD>
22454 <BODY>
22455 <H1>OPTION: <!--#echo var="VAR_saved-msg-name-rule"--></H1>
22456
22457 This option determines the default folder name when saving
22458 a message.
22459
22460 <P>
22461 The default option is &quot;default-folder&quot;, which is the folder
22462 called &quot;saved-messages&quot; in Unix Alpine and
22463 &quot;savemail&quot; in PC-Alpine.  To change the default folder, modify
22464 the Alpine option called
22465 <A HREF="h_config_def_save_folder">&quot;<!--#echo var="VAR_default-saved-msg-folder"-->&quot;</A>.
22466
22467 <P>
22468 Choosing any of the &quot;by-&quot; options cause Alpine to attempt to
22469 get the chosen option's value for the message being saved (or for the
22470 first message being saved if using an aggregrate save).
22471 For example, if &quot;by-from&quot; is chosen, Alpine attempts to get the
22472 value of who the message came from (i.e. the from address).
22473 Alpine then attempts to save the message to a folder matching that value.
22474 If &quot;by-from&quot; is chosen and no value is obtained, Alpine uses
22475 &quot;by-sender&quot;.
22476 The opposite is also true.
22477 If &quot;by-recipient&quot; is chosen and the message was posted to a
22478 newsgroup, Alpine will use the newsgroup name.
22479 If &quot;by-replyto&quot; is chosen and no value is obtained, Alpine uses
22480 &quot;by-from&quot;.
22481
22482 <P>
22483 If any of the &quot;by-realname&quot; options are chosen, Alpine will attempt
22484 to use the personal name part of the address instead of the mailbox part.
22485 If any of the &quot;by-nick&quot; options are chosen, the
22486 address is looked up in your address book and if found, the
22487 nickname for that entry is used.
22488 Only simple address book entries are checked, not distribution lists.
22489 Similarly, if any of the
22490 &quot;by-fcc&quot; options are chosen, the fcc from the corresponding
22491 address book entry is used.
22492 If by-realname, or the by-nick or by-fcc lookups result in no value,
22493 then if the chosen option ends with the &quot;then-from&quot;,
22494 &quot;then-sender&quot;, &quot;then-replyto&quot;,
22495 or &quot;then-recip&quot; suffix, Alpine
22496 reverts to the same behavior as &quot;by-from&quot;,
22497 &quot;by-sender&quot;, &quot;by-replyto&quot;, or &quot;by-recip&quot;
22498 depending on which option was specified.
22499 If the chosen option doesn't end with one of
22500 the &quot;then-&quot; suffixes, then Alpine reverts to the default
22501 folder when no match is found in the address book.
22502
22503 <P>
22504 Choosing the option called &quot;last-folder-used&quot;, causes Alpine
22505 to save to the folder that you saved to the last time you saved a
22506 message.  The first time you save a message in an Alpine session, Alpine
22507 attempts to save the message to the default folder.
22508
22509 <P>
22510 Here is an example to make some of the options clearer.
22511 If the message is From
22512 <P>
22513 <CENTER><SAMP>Fred Flintstone &lt;flint@bedrock.org&gt;</SAMP></CENTER>
22514 <P>
22515 and this rule is set to &quot;by-from&quot;, then the default folder offered
22516 in the save dialog would be &quot;flint&quot;.
22517 <P>
22518 If this rule is set to &quot;by-realname-of-from&quot; then the default would
22519 be &quot;Fred Flintstone&quot;.
22520 <P>
22521 If this rule is set to &quot;by-nick-of-from&quot; then Alpine will search
22522 for the address &quot;flint@bedrock.org&quot; in your address book.
22523 If an entry is found and it has a nickname associated with it, that nickname
22524 will be offered as the default folder.
22525 If not, the default saved message folder will be offered as the default.
22526 <P>
22527 If this rule is set to &quot;by-fcc-of-from&quot; then Alpine will search
22528 for the address &quot;flint@bedrock.org&quot; in your address book.
22529 If an entry is found and it has an Fcc associated with it, that Fcc
22530 will be offered as the default folder.
22531 If not, the default saved message folder will be offered as the default.
22532 <P>
22533 If this rule is set to &quot;by-nick-of-from-then-from&quot; then Alpine will search
22534 for the address &quot;flint@bedrock.org&quot; in your address book.
22535 If an entry is found and it has a nickname associated with it, that nickname
22536 will be offered as the default folder.
22537 If it is not found (or has no nickname) then the default offered will be
22538 the same as it would be for the &quot;by-from&quot; rule.
22539 That is, it would be &quot;flint&quot;
22540 <P>
22541 <UL>
22542 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22543 </UL><P>
22544 &lt;End of help on this topic&gt;
22545 </BODY>
22546 </HTML>
22547 ====== h_config_fcc_rule =====
22548 <HTML>
22549 <HEAD>
22550 <TITLE>OPTION: <!--#echo var="VAR_fcc-name-rule"--></TITLE>
22551 </HEAD>
22552 <BODY>
22553 <H1>OPTION: <!--#echo var="VAR_fcc-name-rule"--></H1>
22554
22555 This option determines the default name for folder carbon copy. Choose
22556 one:
22557
22558 <DL>
22559 <DT>default-fcc</DT>
22560 <DD>This is the normal default, the value of which is set in the
22561 &quot;<!--#echo var="VAR_default-fcc"-->&quot; variable as specified earlier in this
22562 configuration.
22563 </DD>
22564
22565 <DT>last-fcc-used</DT>
22566 <DD> Causes Alpine to use the folder that was last
22567 used in the fcc field
22568 </DD>
22569
22570 <DT>by-nickname</DT>
22571 <DD>Means that Alpine will use the nickname
22572 from your address book that matches the first address in the To line.
22573 If there is no match, it will use the value of the
22574 &quot;<!--#echo var="VAR_default-fcc"-->&quot; variable.
22575 </DD>
22576
22577 <DT>by-recipient</DT>
22578 <DD>Means Alpine will form a folder name
22579 based on the left hand side of the first address in the To line.
22580 </DD>
22581
22582 <DT>by-nick-then-recip</DT>
22583 <DD>Means that it will use the
22584 matching nickname from your address book if there is one, otherwise it
22585 will extract the recipient name from the address and use that (like
22586 by-recipient).
22587 </DD>
22588
22589 <DT>current-folder</DT>
22590 <DD>Causes a copy to be written to
22591 the currently open folder, unless that is the INBOX.  In the case
22592 where the current folder is the INBOX, the &quot;<!--#echo var="VAR_default-fcc"-->&quot; is
22593 used instead.
22594 </DD>
22595 </DL>
22596
22597 <P>
22598 Note: Whatever the fcc specified by the rule here, it will be
22599 over-ridden by any fcc entries you have in your address book.
22600
22601 <P>
22602 <UL>
22603 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22604 </UL><P>
22605 &lt;End of help on this topic&gt;
22606 </BODY>
22607 </HTML>
22608 ====== h_config_sort_key =====
22609 <HTML>
22610 <HEAD>
22611 <TITLE>OPTION: <!--#echo var="VAR_sort-key"--></TITLE>
22612 </HEAD>
22613 <BODY>
22614 <H1>OPTION: <!--#echo var="VAR_sort-key"--></H1>
22615
22616 This option determines the order in which messages will be displayed in
22617 the MESSAGE INDEX screen.  Choose from:
22618 <P>
22619 <UL>
22620  <LI> <A HREF="h_index_sort_arrival">Arrival</A>
22621  <LI> <A HREF="h_index_sort_date">Date</A>
22622  <LI> <A HREF="h_index_sort_subj">Subject</A>
22623  <LI> <A HREF="h_index_sort_ordsubj">OrderedSubj</A>
22624  <LI> <A HREF="h_index_sort_thread">Thread</A>
22625  <LI> <A HREF="h_index_sort_from">From</A>
22626  <LI> <A HREF="h_index_sort_size">Size</A>
22627  <LI> <A HREF="h_index_sort_score">Score</A>
22628  <LI> <A HREF="h_index_sort_to">To</A>
22629  <LI> <A HREF="h_index_sort_cc">Cc</A>
22630 </UL>
22631
22632 <P>
22633 Each type of sort may also be reversed.
22634 Normal default is by &quot;Arrival&quot;.
22635
22636 <P>
22637 A possible point of confusion arises when you change the configuration
22638 of the <!--#echo var="VAR_sort-key"-->.
22639 The folder will normally be re-sorted when you go back to viewing the
22640 index.
22641 However, if you have manually sorted the folder with the
22642 Sort
22643 (<!--chtml if pinemode="function_key"-->F7<!--chtml else-->$<!--chtml endif-->)
22644 command, then it will not be re-sorted until the next time it is opened.
22645
22646 <P>
22647 <UL>
22648 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22649 </UL><P>
22650 &lt;End of help on this topic&gt;
22651 </BODY>
22652 </HTML>
22653 ====== h_config_other_startup =====
22654 <HTML>
22655 <HEAD>
22656 <TITLE>OPTION: Set Startup Rule</TITLE>
22657 </HEAD>
22658 <BODY>
22659 <H1>OPTION: Set Startup Rule</H1>
22660
22661 This option determines which message will be the <EM>current message</EM> when
22662 the folder is first opened.
22663 It works the same way that the option
22664 <A HREF="h_config_inc_startup"><!--#echo var="VAR_incoming-startup-rule"--></A>
22665 works, so look there for help.
22666 It may be used for any folder, not just incoming folders.
22667
22668 <P>
22669 <UL>
22670 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22671 </UL><P>
22672 &lt;End of help on this topic&gt;
22673 </BODY>
22674 </HTML>
22675 ====== h_config_perfolder_sort =====
22676 <HTML>
22677 <HEAD>
22678 <TITLE>Set Sort Order</TITLE>
22679 </HEAD>
22680 <BODY>
22681 <H1>Set Sort Order</H1>
22682
22683 This option determines the order in which messages will be displayed in
22684 the MESSAGE INDEX screen when the Current Folder Type set in the
22685 Pattern is a match. Choose from:
22686 <P>
22687 <UL>
22688  <LI> <A HREF="h_index_sort_default">Default</A>
22689  <LI> <A HREF="h_index_sort_arrival">Arrival</A>
22690  <LI> <A HREF="h_index_sort_date">Date</A>
22691  <LI> <A HREF="h_index_sort_subj">Subject</A>
22692  <LI> <A HREF="h_index_sort_ordsubj">OrderedSubj</A>
22693  <LI> <A HREF="h_index_sort_thread">Thread</A>
22694  <LI> <A HREF="h_index_sort_from">From</A>
22695  <LI> <A HREF="h_index_sort_size">Size</A>
22696  <LI> <A HREF="h_index_sort_score">Score</A>
22697  <LI> <A HREF="h_index_sort_to">To</A>
22698  <LI> <A HREF="h_index_sort_cc">Cc</A>
22699 </UL>
22700
22701 <P>
22702 Each type of sort may also be reversed.
22703 Normal default is by &quot;Arrival&quot;.
22704
22705 <P>
22706 A possible point of confusion arises when you change the configuration
22707 of the Sort Order for the currently open folder.
22708 The folder will normally be re-sorted when you go back to viewing the
22709 index.
22710 However, if you have manually sorted the folder with the
22711 Sort
22712 (<!--chtml if pinemode="function_key"-->F7<!--chtml else-->$<!--chtml endif-->)
22713 command, then it will not be re-sorted until the next time it is opened.
22714
22715 <P>
22716 <UL>
22717 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22718 </UL><P>
22719 &lt;End of help on this topic&gt;
22720 </BODY>
22721 </HTML>
22722 ====== h_config_fld_sort_rule =====
22723 <HTML>
22724 <HEAD>
22725 <TITLE>OPTION: <!--#echo var="VAR_folder-sort-rule"--></TITLE>
22726 </HEAD>
22727 <BODY>
22728 <H1>OPTION: <!--#echo var="VAR_folder-sort-rule"--></H1>
22729
22730 This option controls the order in which folder list entries will be
22731 presented in the FOLDER LIST screen.  Choose one of the following:
22732
22733 <DL>
22734 <DT>Alphabetical</DT>
22735 <DD>sort by alphabetical name independent of type
22736 </DD>
22737
22738 <DT>Alpha-with-dirs-last</DT>
22739 <DD>sort by alphabetical name grouping directory entries
22740 to the end of the list
22741 </DD>
22742
22743 <DT>Alpha-with-dirs-first</DT>
22744 <DD>sort by alphabetical name grouping directory entries
22745 to the start of the list
22746 </DD>
22747 </DL>
22748
22749 The normal default is &quot;Alphabetical&quot;.
22750
22751 <P>
22752 <UL>
22753 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22754 </UL><P>
22755 &lt;End of help on this topic&gt;
22756 </BODY>
22757 </HTML>
22758 ====== h_config_ab_sort_rule =====
22759 <HTML>
22760 <HEAD>
22761 <TITLE>OPTION: <!--#echo var="VAR_addrbook-sort-rule"--></a></TITLE>
22762 </HEAD>
22763 <BODY>
22764 <H1>OPTION: <!--#echo var="VAR_addrbook-sort-rule"--></a></H1>
22765
22766 This option controls the order in which address book entries will be
22767 presented.  Choose one of the following:
22768
22769 <DL>
22770 <DT>fullname</DT>
22771 <DD>use fullname field, lists mixed in
22772 </DD>
22773
22774 <DT>fullname-with-lists-last</DT>
22775 <DD>use fullname field, but put lists at end
22776 </DD>
22777
22778 <DT>nickname</DT>
22779 <DD>use nickname field, lists mixed in
22780 </DD>
22781
22782 <DT>nickname-with-lists-last</DT>
22783 <DD>use nickname field, but put lists at end
22784 </DD>
22785
22786 <DT>dont-sort</DT>
22787 <DD>don't change order of file
22788 </DD>
22789 </DL>
22790
22791 <P>
22792 The normal default is &quot;fullname-with-lists-last&quot;.
22793 If you use an address book from more than one computer and those
22794 computers sort the address book differently then the sort order
22795 will be the order where the last change to the address book was
22796 made.
22797 There are two reasons the sorting might be different on different
22798 systems.
22799 First, the <!--#echo var="VAR_addrbook-sort-rule"--></a> may be set differently in the two
22800 places.
22801 Second, the collation rules on the two computers may be different.
22802 For example, one system might ignore special characters while the other
22803 doesn't or one may sort upper and lower case letters together while
22804 the other doesn't.
22805 In any case, the order you see is the order on the system where the
22806 last change was made, for example by an address book edit or a
22807 Take Address command.
22808
22809 <P>
22810 <UL>
22811 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22812 </UL><P>
22813 &lt;End of help on this topic&gt;
22814 </BODY>
22815 </HTML>
22816 ====== h_config_post_char_set =====
22817 <HTML>
22818 <HEAD>
22819 <TITLE>OPTION: <!--#echo var="VAR_posting-character-set"--></TITLE>
22820 </HEAD>
22821 <BODY>
22822 <H1>OPTION: <!--#echo var="VAR_posting-character-set"--></H1>
22823
22824 The <!--#echo var="VAR_posting-character-set"--> configuration option is used
22825 when sending messages.
22826
22827 <P>
22828
22829 When sending a message the text typed in the composer is
22830 labeled with the character set specified by this option.
22831 If the composed text is not fully representable in the
22832 specified <!--#echo var="VAR_posting-character-set"-->, then it is labeled as &quot;UTF-8.&quot
22833 instead;
22834
22835 <P>
22836 Attachments are labeled with your
22837 <A HREF="h_config_key_char_set">&quot;Keyboard Character Set&quot;</A>.
22838
22839 <P>
22840 Generally, there should be little need to set this option.
22841 If left unset, the
22842 default behavior is to label composed text as specifically as
22843 possible.  That is, if the composed text has no non-ASCII characters,
22844 it is labeled as &quot;US-ASCII.&quot; Similarly, if it is composed of
22845 only ISO-8859-15 characters, it is labeled as such.  Alpine will
22846 attempt to automatically detect a number of character sets including ISO-8859-15,
22847 ISO-8859-1, ISO-8859-2, VISCII, KOI8-R, KOI8-U, ISO-8859-7, ISO-8859-6,
22848 ISO-8859-8, TIS-620, ISO-2022-JP, GB2312, BIG5, and EUC-KR.
22849 If the message contains a mix of character sets,
22850 it is labeled as &quot;UTF-8.&quot;
22851
22852 <P>
22853
22854 This setting is provided to allow you to force a particular character set that
22855 Alpine does not automatically detect. For example, if a message is representable
22856 in more than one character set then Alpine may choose a different default
22857 than you want.
22858 Lastly, by setting this option explicitly to
22859 &quot;UTF-8&quot; all non-ASCII messages you send will be labeled as
22860 &quot;UTF-8&quot; instead of something more specific.
22861
22862 <P>
22863 In the Setup/Config screen you may choose from a list of all the
22864 character sets Alpine knows about by using the &quot;T&quot; ToCharsets command.
22865
22866 <P>
22867 The options
22868 <A HREF="h_config_char_set">&quot;Display Character Set&quot;</A>
22869 and <A HREF="h_config_key_char_set">&quot;Keyboard Character Set&quot;</A>
22870 are closely related.
22871 Setting the feature
22872 <A HREF="h_config_use_system_translation">&quot;Use System Translation&quot;</A>
22873 should cause this option to be ignored.
22874
22875 <P>
22876 <UL>
22877 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22878 </UL><P>
22879 &lt;End of help on this topic&gt;
22880 </BODY>
22881 </HTML>
22882 ====== h_config_unk_char_set =====
22883 <HTML>
22884 <HEAD>
22885 <TITLE>OPTION: <!--#echo var="VAR_unknown-character-set"--></TITLE>
22886 </HEAD>
22887 <BODY>
22888 <H1>OPTION: <!--#echo var="VAR_unknown-character-set"--></H1>
22889
22890 The <!--#echo var="VAR_unknown-character-set"--> configuration option is used
22891 when reading or replying to messages.
22892
22893 <P>
22894
22895 A text message should either be made up of all US-ASCII characters
22896 or it should contain a charset label which tells the software which
22897 character set encoding to use to interpret the message.
22898 Sometimes a malformed message may be unlabeled but contain non-ascii text.
22899 This message is outside of the standards so any attempt to read it could fail.
22900 When Alpine attempts to read such a message it will try to interpret the
22901 text in the character set you specify here.
22902 For example, if you have correspondents who send you unlabeled messages that
22903 are usually made up of characters from the WINDOWS-1251 character set, setting
22904 this <!--#echo var="VAR_unknown-character-set"--> to <CODE>WINDOWS-1251</CODE> will
22905 allow you to read those messages.
22906 Of course, if the unlabeled message is actually in some other character set,
22907 then you may see garbage on your screen.
22908 <P>
22909 Instead of just unlabeled text, this option also affects text which is labeled
22910 with the charsets &quot;X-Unknown&quot; or &quot;US-ASCII&quot;.
22911
22912 <P>
22913 In the Setup/Config screen you may choose from a list of all the
22914 character sets Alpine knows about by using the &quot;T&quot; ToCharsets command.
22915
22916 <P>
22917 <UL>
22918 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22919 </UL><P>
22920 &lt;End of help on this topic&gt;
22921 </BODY>
22922 </HTML>
22923 ====== h_config_char_set =====
22924 <HTML>
22925 <HEAD>
22926 <TITLE>OPTION: Display Character Set</TITLE>
22927 </HEAD>
22928 <BODY>
22929 <H1>OPTION: Display Character Set</H1>
22930
22931 The Display Character Set configuration option is used when viewing messages.
22932 <P>
22933 Alpine uses Unicode characters internally and
22934 it is a goal for Alpine to handle email in many different languages.
22935 Alpine will properly display only left-to-right character sets
22936 in a fixed-width font. Specifically, Alpine assumes that a fixed-width
22937 font is in use, in the sense that
22938 characters are assumed to take up zero, one, or two character cell
22939 widths from left to right on the screen. This is true even in PC-Alpine.
22940 <P>
22941
22942 Alpine recognizes some local character sets that are right-to-left
22943 (Arabic, Hebrew, and Thai) or not representable in a fixed-width font
22944 (Arabic) and properly converts texts in these character sets to/from
22945 Unicode; however, there are known display bugs with these character
22946 sets.
22947 <P>
22948
22949 There are three possible configuration character settings and some
22950 environment variable settings that can affect how Alpine
22951 handles international characters.
22952 The first two of these are only available in UNIX Alpine.
22953 The three configuration options are
22954 Display Character Set,
22955 Keyboard Character Set, and
22956 <!--#echo var="VAR_posting-character-set"-->.
22957 The Keyboard Character Set defaults to being the same value
22958 as the Display Character Set, and that is usually correct, because
22959 the keyboard almost always produces characters in the same character set
22960 as the display displays.
22961 The Display Character Set is the character set that Alpine
22962 will attempt to use when sending characters to the display.
22963 <P>
22964
22965 By default, the Display Character Set variable is not set and UNIX Alpine
22966 will attempt to get this information from the environment.
22967 In particular, the <CODE>nl_langinfo(CODESET)</CODE> call is used.
22968 This usually depends on the setting of the environment variables LANG or LC_CTYPE.
22969 An explicit configuration setting for Display Character Set will,
22970 of course, override any default setting.
22971 <P>
22972 For PC-Alpine the Display Character Set
22973 and the Keyboard Character Set
22974 are always equivalent to <CODE>UTF-8</CODE> and this is not settable.
22975 <P>
22976
22977 It is probably best to use UNIX Alpine in a terminal emulator
22978 capable of displaying UTF-8 characters, since that will allow you to
22979 view just about any received text that is correctly formatted (note,
22980 however, the above comments about known index display bugs with certain
22981 character sets). You'll need to have an emulator that uses a UTF-8 font
22982 and you'll need to set up your environment to use a UTF-8 charmap. For
22983 example, on a Linux system you might include
22984 <P>
22985 <CENTER> <CODE>setenv LANG en_US.UTF-8</CODE> </CENTER>
22986 <P>
22987
22988 or something similar in your UNIX startup files.
22989 You'd also have to select a UTF-8 font in your terminal emulator.
22990 <P>
22991
22992 The types of values that the character set variables may be set to are
22993 <CODE>UTF-8</CODE>, <CODE>ISO-8859-1</CODE>, or <CODE>EUC-JP</CODE>.
22994 The <CODE>ISO-2022</CODE> character sets are not supported for input or
22995 for display, but as a special case, <CODE>ISO-2022-JP</CODE> is supported
22996 for use only as a <!--#echo var="VAR_posting-character-set"-->.
22997 In the Setup/Config screen you may choose from a list of all the
22998 character sets Alpine knows about by using the &quot;T&quot; ToCharsets command.
22999 Here is a list of many of the possible character sets:
23000
23001 <P>
23002 <TABLE>
23003 <TR> <TD>UTF-8</TD> <TD>Unicode</TD> </TR>
23004 <TR> <TD>US-ASCII</TD> <TD>7 bit American English characters</TD> </TR>
23005 <TR> <TD>ISO-8859-1</TD> <TD>8 bit European "Latin 1" character set</TD> </TR>
23006 <TR> <TD>ISO-8859-2</TD> <TD>8 bit European "Latin 2" character set</TD> </TR>
23007 <TR> <TD>ISO-8859-3</TD> <TD>8 bit European "Latin 3" character set</TD> </TR>
23008 <TR> <TD>ISO-8859-4</TD> <TD>8 bit European "Latin 4" character set</TD> </TR>
23009 <TR> <TD>ISO-8859-5</TD> <TD>8 bit Latin and Cyrillic</TD> </TR>
23010 <TR> <TD>ISO-8859-6</TD> <TD>8 bit Latin and Arabic</TD> </TR>
23011 <TR> <TD>ISO-8859-7</TD> <TD>8 bit Latin and Greek</TD> </TR>
23012 <TR> <TD>ISO-8859-8</TD> <TD>8 bit Latin and Hebrew</TD> </TR>
23013 <TR> <TD>ISO-8859-9</TD> <TD>8 bit European "Latin 5" character set</TD> </TR>
23014 <TR> <TD>ISO-8859-10</TD> <TD>8 bit European "Latin 6" character set</TD> </TR>
23015 <TR> <TD>ISO-8859-11</TD> <TD>Latin and Thai</TD> </TR>
23016 <TR> <TD>ISO-8859-12</TD> <TD>Reserved</TD> </TR>
23017 <TR> <TD>ISO-8859-13</TD> <TD>8 bit European "Latin 7" character set</TD> </TR>
23018 <TR> <TD>ISO-8859-14</TD> <TD>8 bit European "Latin 8" character set</TD> </TR>
23019 <TR> <TD>ISO-8859-15</TD> <TD>8 bit European "Latin 9" character set</TD> </TR>
23020 <TR> <TD>ISO-8859-16</TD> <TD>8 bit European "Latin 10" character set</TD> </TR>
23021 <TR> <TD>KOI8-R</TD> <TD>8 bit Latin and Russian</TD> </TR>
23022 <TR> <TD>KOI8-U</TD> <TD>8 bit Latin and Ukranian</TD> </TR>
23023 <TR> <TD>WINDOWS-1251</TD> <TD>8 bit Latin and Russian</TD> </TR>
23024 <TR> <TD>TIS-620</TD> <TD>8 bit Latin and Thai</TD> </TR>
23025 <TR> <TD>VISCII</TD> <TD>8 bit Latin and Vietnamese</TD> </TR>
23026 <TR> <TD>GBK</TD> <TD>Latin and Chinese Simplified</TD> </TR>
23027 <TR> <TD>GB2312</TD> <TD>Latin and Chinese Simplified</TD> </TR>
23028 <TR> <TD>CN-GB</TD> <TD>Latin and Chinese Simplified</TD> </TR>
23029 <TR> <TD>BIG5</TD> <TD>Latin and Chinese Traditional</TD> </TR>
23030 <TR> <TD>BIG-5</TD> <TD>Latin and Chinese Traditional</TD> </TR>
23031 <TR> <TD>EUC-JP</TD> <TD>Latin and Japanese</TD> </TR>
23032 <TR> <TD>SHIFT-JIS</TD> <TD>Latin and Japanese</TD> </TR>
23033 <TR> <TD>EUC-KR</TD> <TD>Latin and Korean</TD> </TR>
23034 <TR> <TD>KSC5601</TD> <TD>Latin and Korean</TD> </TR>
23035 </TABLE>
23036 <P>
23037
23038 When reading incoming email, Alpine understands many different
23039 character sets and is able to convert the incoming mail into Unicode.
23040 The Unicode will be converted to the Display Character Set
23041 for display on your terminal.
23042 Characters typed at the keyboard will be converted from the
23043 Keyboard Character Set to Unicode for Alpine's internal
23044 use.
23045 You may find that you can read some malformed messages that do not
23046 contain a character set label by setting the option
23047 <A HREF="h_config_unk_char_set">&quot;<!--#echo var="VAR_unknown-character-set"-->&quot;</A>.
23048 <P>
23049
23050 The <!--#echo var="VAR_posting-character-set"--> is used when sending messages.
23051 The default behavior obtained by leaving this variable unset is usually
23052 what is wanted. In that default case, Alpine will attempt
23053 to label the message with the most specific character set from the
23054 rather arbitrary set
23055 <P>
23056 US-ASCII, ISO-8859-15,
23057 ISO-8859-1, ISO-8859-2, VISCII, KOI8-R, KOI8-U, ISO-8859-7, ISO-8859-6,
23058 ISO-8859-8, TIS-620, ISO-2022-JP, GB2312, BIG5, EUC-KR, and UTF-8.
23059 <P>
23060
23061 For example, if the message is made up of only US-ASCII characters, it
23062 will be labeled US-ASCII. Otherwise, if it is all ISO-8859-15 characters,
23063 that will be the label. If that doesn't work the same is tried for the
23064 remaining members of the list.
23065
23066 <P>
23067 It might make sense to set <!--#echo var="VAR_posting-character-set"--> to an
23068 explicit value instead.
23069 For example, if you usually send messages in Greek, setting this
23070 option to ISO-8859-7 will result in messages being labeled as
23071 US-ASCII if there are no non-ascii characters, ISO-8859-7 if there
23072 are only Greek characters, or UTF-8 if there are some characters
23073 that aren't representable in ISO-8859-7.
23074 Another possibility is to set this option explicitly to UTF-8.
23075 In that case
23076 Alpine labels only ascii messages as US-ASCII and all other
23077 messages as UTF-8.
23078 <P>
23079
23080 The options
23081 <A HREF="h_config_post_char_set">&quot;<!--#echo var="VAR_posting-character-set"-->&quot;</A>
23082 and <A HREF="h_config_key_char_set">&quot;Keyboard Character Set&quot;</A>
23083 are closely related to this option.
23084 Setting the feature
23085 <A HREF="h_config_use_system_translation">&quot;Use System Translation&quot;</A>
23086 should cause this option to be ignored.
23087
23088 <P>
23089 When displaying a message, Alpine compares this setting to the character
23090 set specified in the message.  If not all of the
23091 characters in the message can be displayed using the Display Character Set
23092 then Alpine places an editorial
23093 comment in the displayed text (enclosed in square-brackets) indicating
23094 that some characters may not be displayed correctly.
23095 This comment may be eliminated by turning on the option
23096 <A HREF="h_config_quell_charset_warning"><!--#echo var="FEAT_quell-charset-warning"--></A>.
23097
23098 <P>
23099 <UL>
23100 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23101 </UL><P>
23102 &lt;End of help on this topic&gt;
23103 </BODY>
23104 </HTML>
23105 ====== h_config_key_char_set =====
23106 <HTML>
23107 <HEAD>
23108 <TITLE>OPTION: Keyboard Character Set</TITLE>
23109 </HEAD>
23110 <BODY>
23111 <H1>OPTION: Keyboard Character Set</H1>
23112
23113 UNIX Alpine only.
23114 <P>
23115 The Keyboard Character Set identifies the character set of the characters
23116 coming from your keyboard.
23117 It defaults to having the same value as your
23118 <A HREF="h_config_char_set">&quot;Display Character Set&quot;</A>,
23119 which in turn defaults to a value obtained from your environment.
23120 It is unlikely that you will need to use this option, because the keyboard
23121 almost always produces the same kind of characters as the display displays.
23122
23123 <P>
23124 This character set is also used when accessing files in your local
23125 file system.
23126 The names of the files are assumed to be in the same character set as
23127 what the keyboard produces, as well as the contents of the files.
23128
23129 <P>
23130 In the Setup/Config screen you may choose from a list of all the
23131 character sets Alpine knows about by using the &quot;T&quot; ToCharsets command.
23132
23133 <P>
23134 The options
23135 <A HREF="h_config_char_set">&quot;Display Character Set&quot;</A>
23136 and <A HREF="h_config_post_char_set">&quot;<!--#echo var="VAR_posting-character-set"-->&quot;</A>
23137 are closely related.
23138 Setting the feature
23139 <A HREF="h_config_use_system_translation">&quot;Use System Translation&quot;</A>
23140 should cause this option to be ignored.
23141
23142 <P>
23143 <UL>
23144 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23145 </UL><P>
23146 &lt;End of help on this topic&gt;
23147 </BODY>
23148 </HTML>
23149 ====== h_config_editor =====
23150 <HTML>
23151 <HEAD>
23152 <TITLE>OPTION: <!--#echo var="VAR_editor"--></TITLE>
23153 </HEAD>
23154 <BODY>
23155 <H1>OPTION: <!--#echo var="VAR_editor"--></H1>
23156
23157 <!--#echo var="VAR_editor"--> specifies the program invoked by ^_ in the Composer. This is
23158 normally an alternative to Alpine's internal composer (Pico).  You could use
23159 this setting to specify an alternate editor to use occasionally or if you
23160 have a favorite editor and want to use it all the time (see the
23161 <A HREF="h_config_alt_ed_now">&quot;<!--#echo var="FEAT_enable-alternate-editor-implicitly"-->&quot;</A> setting).  <P>
23162 If you specify multiple editors for this option, ^_ will invoke the first one
23163 of those specified that exists and is executable.  When specifying a program
23164 for use here, make sure that the format of the text it saves -- which, when
23165 you exit it, will become the message body in Alpine -- is appropriate
23166 for the body of an email message; avoid proprietary formats that may result in
23167 a message body that the recipient of your message will be unable to decipher.
23168 <P>
23169 <!--chtml if pinemode="os_windows"-->
23170 <!--chtml else-->
23171 If you are in doubt about what editors are available on your system, or which
23172 of them may be appropriate for specification here, ask your local computing
23173 support staff.
23174 <!--chtml endif-->
23175 <P>
23176 Note that if <a href="h_config_quell_flowed_text"><!--#echo var="FEAT_quell-flowed-text"--></a> is
23177 unset, outgoing text will be set as flowed.  In most cases this will be fine,
23178 but if the editor has a &quot;flowed text&quot; mode, it would be best to
23179 use that.
23180
23181 <P><UL>
23182 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23183 </UL>
23184 <P>
23185 &lt;End of help on this topic&gt;
23186 </BODY>
23187 </HTML>
23188 ====== h_config_speller =====
23189 <HTML>
23190 <HEAD>
23191 <TITLE>OPTION: <!--#echo var="VAR_speller"--></TITLE>
23192 </HEAD>
23193 <BODY>
23194 <H1>OPTION: <!--#echo var="VAR_speller"--></H1>
23195
23196 UNIX Alpine only.
23197 <P>
23198 For PC-Alpine, you must install the aspell library code that you
23199 may get from
23200 <A HREF="http://aspell.net/win32/">http://aspell.net/win32/</A>.
23201 <P>
23202 This option affects the behavior of the ^T (spell check) command in the
23203 Composer.  It specifies the program invoked by ^T in the Composer.
23204 By default, Alpine uses
23205 <P>
23206 <CENTER><SAMP>aspell --dont-backup --mode=email check</SAMP></CENTER>
23207 <P>
23208 if it knows where to find &quot;aspell&quot;.
23209 If there is no &quot;aspell&quot; command available but the command &quot;ispell&quot; is available
23210 then the command used is
23211 <P>
23212 <CENTER><SAMP>ispell -l</SAMP></CENTER>
23213 <P>
23214 Otherwise, the ancient &quot;spell&quot; command is used.
23215 <P>
23216 If you specify a value for this command (with full pathname) then that is what
23217 will be used instead of any of the defaults.
23218 When invoking this
23219 spell-checking program, Alpine appends a tempfile name (where the message is
23220 passed) to the command line. Alpine expects the speller to correct the
23221 spelling in that file. When you exit from that program Alpine will read the
23222 tempfile back into the composer.
23223 <P>
23224 Don't set this speller option to the standard Unix spell command.
23225 That won't work because spell works in a different way.
23226
23227 <P>
23228 <UL>
23229 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23230 </UL><P>
23231 &lt;End of help on this topic&gt;
23232 </BODY>
23233 </HTML>
23234 ====== h_config_display_filters =====
23235 <HTML>
23236 <HEAD>
23237 <TITLE>OPTION: <!--#echo var="VAR_display-filters"--></TITLE>
23238 </HEAD>
23239 <BODY>
23240 <H1>OPTION: <!--#echo var="VAR_display-filters"--></H1>
23241
23242 This option defines a list of text-filtering commands (programs or
23243 scripts) that may be used to filter text portions of received messages
23244 prior to their use (e.g., presentation in the &quot;MESSAGE TEXT&quot;
23245 display screen, exporting to a text file).
23246 For security reasons, the full path name of the
23247 filter command must be specified.
23248
23249 <P>
23250 The command is executed and the message is piped into its standard input.
23251 The standard output of the command is read back by Alpine.  The
23252 &quot;_TMPFILE_&quot; token (see below) overrides this default behavior.
23253
23254 <P>
23255 The filter's use is based on the configured &quot;trigger&quot; string.  The
23256 format of a filter definition is:
23257
23258 <P>
23259 <CENTER>&lt;trigger&gt; &lt;command&gt; &lt;arguments&gt;</CENTER>
23260
23261 <P>
23262 You can specify as many filters as you wish, separating them with a comma.
23263 Each filter can have only one trigger and command.  Thus, two trigger
23264 strings that invoke the same command require separate filter
23265 specifications.
23266
23267 <P>
23268 The &quot;trigger&quot; is simply text that, if found in the message,
23269 will invoke the associated command.  If the trigger contains any space
23270 characters, it must be placed within quotes.  Likewise, should you
23271 wish a filter to be invoked unconditionally, define the trigger as the
23272 null string, &quot;&quot; (two consecutive double-quote characters).  If the
23273 trigger string is found anywhere in the text of the message the filter
23274 is invoked.  Placing the trigger text within the tokens defined below
23275 changes where within the text the trigger must be before considering
23276 it a match.
23277
23278 <P>
23279 Trigger Modifying Tokens:
23280 <DL>
23281 <DT>_CHARSET(<VAR>string</VAR>)_</DT>
23282 <DD>This token tells Alpine to invoke the supplied command
23283 if the text is in a character set matching <VAR>string</VAR>
23284 (e.g., ISO-8859-2 or ISO-2022-JP).
23285 </DD>
23286
23287
23288 <DT>_LEADING(<VAR>string</VAR>)_</DT>
23289 <DD>This token tells Alpine to invoke the supplied command
23290 if the enclosed <VAR>string</VAR> is found to be the first
23291 non-whitespace text.
23292 <BR>NOTE: Quotes are necessary if <VAR>string</VAR> contains
23293 the space character.
23294 </DD>
23295
23296 <DT>_BEGINNING(<VAR>string</VAR>)_</DT>
23297 <DD>This token tells Alpine to invoke the supplied command
23298 if the enclosed <VAR>string</VAR> is found at the beginning
23299 of any line in the text.
23300 <BR>NOTE: Quotes are necessary if <VAR>string</VAR> contains
23301 the space character.
23302 </DD>
23303 </DL>
23304
23305 <P>
23306 The &quot;command&quot; and &quot;arguments&quot; portion is simply
23307 the command line to be invoked if the trigger string is found.  Below
23308 are tokens that Alpine will recognize and replace with special values
23309 when the command is actually invoked.
23310
23311 <P>
23312 Command Modifying Tokens:
23313
23314 <DL>
23315 <DT>_TMPFILE_</DT>
23316 <DD>When the command is executed, this token is
23317 replaced with the path and name of the temporary
23318 file containing the text to be filtered.  Alpine
23319 expects the filter to replace this data with the
23320 filter's result.
23321
23322 <P>
23323 NOTE: Use of this token implies that the text to
23324 be filtered is not piped into standard input of the
23325 executed command and its standard output is ignored.
23326 Alpine restores the tty modes before invoking the
23327 filter in case the filter interacts with the user
23328 via its own standard input and output.
23329 </DD>
23330
23331 <DT>_RESULTFILE_</DT>
23332 <DD>When the command is executed, this token is
23333 replaced with the path and name of a temporary
23334 file intended to contain a status message from the
23335 filter.  Alpine displays this in the message status
23336 field.
23337 </DD>
23338
23339 <DT>_DATAFILE_</DT>
23340 <DD>When the command is executed, this token is
23341 replaced with the path and name of a temporary
23342 file that Alpine creates once per session and deletes
23343 upon exit.  The file is intended to be used by the
23344 filter to store state information between instances
23345 of the filter.
23346 </DD>
23347
23348 <DT>_PREPENDKEY_</DT>
23349 <DD>When the command is executed, this token indicates that a random
23350 number will be passed down the input stream before the message text.
23351 This number could be used as a session key.  It is sent in this way to
23352 improve security.  The number is unique to the current Alpine session
23353 and is only generated once per session.
23354 </DD>
23355
23356 <DT>_SILENT_</DT>
23357 <DD>When the filter is executed, this token tells Alpine not to repaint
23358 the screen while the command is being executed. This can be used with
23359 filters that do not interact with the user, and therefore repainting
23360 the screen is not necessary.
23361 </DD>
23362 </DL>
23363
23364 <P>
23365 The feature
23366 <A HREF="h_config_disable_reset_disp"><!--#echo var="FEAT_disable-terminal-reset-for-display-filters"--></A> is related.
23367 <P>
23368 Performance caveat/considerations:
23369 <BR>
23370 Testing for the trigger and invoking the filter doesn't come for free.
23371 There is overhead associated with searching for the trigger string, testing
23372 for the filter's existence and actually piping the text through the filter.
23373 The impact can be reduced if the Trigger Modifying Tokens above are
23374 employed.
23375 <P>
23376 &lt;End of help on this topic&gt;
23377 </BODY>
23378 </HTML>
23379 ====== h_config_sending_filter =====
23380 <HTML>
23381 <HEAD>
23382 <TITLE>OPTION: <!--#echo var="VAR_sending-filters"--></TITLE>
23383 </HEAD>
23384 <BODY>
23385 <H1>OPTION: <!--#echo var="VAR_sending-filters"--></H1>
23386
23387 This option defines a list of text-filtering commands (programs and
23388 scripts) that may be selectively invoked to process a message just before
23389 it is sent.  If set, the Composer's ^X (Send) command will allow you to
23390 select which filter (or none) to apply to the message before it is sent.
23391 For security reasons, the full path of the filter program must be
23392 specified.
23393
23394 <P>
23395 Command Modifying Tokens:
23396
23397 <DL>
23398 <DT>_RECIPIENTS_</DT>
23399 <DD>When the command is executed, this token is replaced
23400 with the space delimited list of recipients of the
23401 message being sent.
23402 </DD>
23403
23404 <DT>_TMPFILE_</DT>
23405 <DD>
23406 When the command is executed, this token is
23407 replaced with the path and name of the temporary
23408 file containing the text to be filtered.  Alpine
23409 expects the filter to replace this data with the
23410 filter's result.
23411
23412 <P>
23413 NOTE: Use of this token implies that the text to
23414 be filtered is not piped into standard input of the
23415 executed command and its standard output is ignored.
23416 Alpine restores the tty modes before invoking the
23417 filter in case the filter interacts with the user
23418 via its own standard input and output.
23419 </DD>
23420
23421 <DT>_RESULTFILE_</DT>
23422 <DD>When the command is executed, this token is
23423 replaced with the path and name of a temporary
23424 file intended to contain a status message from the
23425 filter.  Alpine displays this in the message status
23426 field.
23427 </DD>
23428
23429 <DT>_DATAFILE_</DT>
23430 <DD>When the command is executed, this token is replaced
23431 in the command line with the path and name of a
23432 temporary file that Alpine creates once per session
23433 and deletes upon exit.  The file is intended to be
23434 used by the filter to store state information between
23435 instances of the filter.
23436 </DD>
23437
23438 <DT>_PREPENDKEY_</DT>
23439 <DD>When the command is executed, this token indicates
23440 that a random number will be passed down the input
23441 stream before the message text.  This number could
23442 be used as a session key.  It is sent in this way
23443 to improve security.  The number is unique to the
23444 current Alpine session and is only generated once per
23445 session.
23446 </DD>
23447
23448 <DT>_INCLUDEALLHDRS_</DT>
23449 <DD>When the command is executed, this token indicates
23450 that the headers of the message will be passed down the input stream
23451 before the message text.
23452 </DD>
23453
23454 <DT>_MIMETYPE_</DT>
23455 <DD>When the command is executed, this token is replaced in the
23456 command name with a temporary file name used to accept any new MIME
23457 Content-Type information necessitated by the output of the filter.
23458 Upon the filter's exit, if the file contains new MIME type
23459 information, Alpine verifies its format and replaces the outgoing
23460 message's MIME type information with that contained in the file. This
23461 is basically a cheap way of sending something other than Text/Plain.
23462 </DD>
23463 </DL>
23464
23465 <P>
23466 NOTE: Only the body text, which is visible in the Composer, is piped
23467 through this filter.  Attachments are not sent to the filter.
23468 <P>
23469 Sending filters are not used if the feature
23470 <A HREF="h_config_send_wo_confirm">&quot;<!--#echo var="FEAT_send-without-confirm"-->&quot;</A> is set.
23471 <P>
23472 <UL>
23473 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23474 </UL><P>
23475 &lt;End of help on this topic&gt;
23476 </BODY>
23477 </HTML>
23478 ====== h_config_keywords =====
23479 <HTML>
23480 <HEAD>
23481 <TITLE>OPTION: <!--#echo var="VAR_keywords"--></TITLE>
23482 </HEAD>
23483 <BODY>
23484 <H1>OPTION: <!--#echo var="VAR_keywords"--></H1>
23485
23486 You may define your own set of keywords and optionally set them on a
23487 message by message basis.
23488 These are similar to the &quot;Important&quot; flag which the user
23489 may set using the Flag command.
23490 The difference is that the Important flag is always present for each folder.
23491 User-defined keywords are chosen by the user.
23492 You may set up the list of possible keywords here, or you may add keywords
23493 from the Flag Details screen that you
23494 can get to after typing the
23495 Flag (<!--chtml if pinemode="function_key"-->F11<!--chtml else-->*<!--chtml endif-->)
23496 command.
23497 After the keywords have been defined,
23498 then you use the <A HREF="h_common_flag">Flag command</A>
23499 to set or clear the keywords in each message.
23500 The behavior of the flag command may be modified by using the
23501 <A HREF="h_config_flag_screen_default">&quot;<!--#echo var="FEAT_enable-flag-screen-implicitly"-->&quot;</A> option or the
23502 <A HREF="h_config_flag_screen_kw_shortcut">&quot;<!--#echo var="FEAT_enable-flag-screen-keyword-shortcut"-->&quot;</A> option.
23503
23504 <P>
23505 Keywords may be used when Selecting messages (Select Keyword).
23506 Keywords may also be used in the Patterns of Rules (Filters, Indexcolors, etc).
23507 Filter Rules may be used to set keywords automatically.
23508 Keywords may be displayed as part of the Subject of a message by using
23509 the SUBJKEY or SUBJKEYINIT tokens in the
23510 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option.
23511 The <A HREF="h_config_kw_braces"><!--#echo var="VAR_keyword-surrounding-chars"--></A>
23512 option may be used to modify the display of keywords using
23513 SUBJKEY and SUBJKEYINIT slightly.
23514 Keywords may also be displayed in a column of their own in the MESSAGE INDEX
23515 screen by using the KEY or KEYINIT tokens.
23516 It is also possible to color keywords in the index using the
23517 Setup/Kolor screen (<A HREF="h_config_kw_color">Keyword Colors</A>).
23518 Keywords are not supported by all mail servers.
23519
23520 <P>
23521 You may give keywords nicknames if you wish.
23522 If the keyword definition you type in contains a SPACE character, then the
23523 actual value of the keyword is everything after the last SPACE and the
23524 nickname for that keyword is everything before the last SPACE.
23525 For example, suppose you are trying to interoperate with another email program
23526 that uses a particular keyword with an unpleasant name.
23527 Maybe it uses a keyword called
23528 <P>
23529 <CENTER><SAMP>VendorName.SoftwareName.08</SAMP></CENTER>
23530 <P>
23531 but for you that keyword means that the message is work-related.
23532 You could define a keyword to have the value
23533 <P>
23534 <CENTER><SAMP>Work VendorName.SoftwareName.08</SAMP></CENTER>
23535 <P>
23536 and then you would use the name &quot;Work&quot; when dealing with
23537 that keyword in Alpine.
23538 If you defined it as
23539 <P>
23540 <CENTER><SAMP>My Work VendorName.SoftwareName.08</SAMP></CENTER>
23541 <P>
23542 the nickname would be everything before the last SPACE, that is the nickname
23543 would be &quot;My Work&quot;.
23544 <P>
23545 Some commonly used keywords begin with dollar signs.
23546 This presents a slight complication, because the dollar sign is normally used
23547 to signify
23548 <A HREF="h_news_config">environment variable expansion</A>
23549 in the Alpine configuration.
23550 In order to specify a keyword that begins with a dollar sign you must
23551 precede the dollar sign with a second dollar sign to escape its special
23552 meaning.
23553 For example, if you want to include the keyword
23554 <P>
23555 <CENTER><SAMP>$Label1</SAMP></CENTER>
23556 <P>
23557 as one of your possible keywords, you must enter the text
23558 <P>
23559 <CENTER><SAMP>$$Label1</SAMP></CENTER>
23560 <P>
23561
23562 instead.
23563 <P>
23564 There are a couple limitations.
23565 First, not all servers support keywords.
23566 Second, some servers (including the IMAP server included with Alpine)
23567 have a per folder limit on the number of keywords that may be defined.
23568 This count commonly includes every keyword you have ever used in the
23569 folder, even if it is no longer being used.
23570 In other words, you can add keywords but you cannot remove them easily.
23571 If you have changed keywords over the life of a folder and find that
23572 you have reached such a limit, one possible solution might be to copy
23573 all of the messages to a newly created folder (using Alpine) and then
23574 delete the original and rename the new folder.
23575 The reason this might work is that only the keywords currently set in
23576 any of the messages will be used in the new folder, hopefully putting you
23577 under the limit.
23578
23579 <P>
23580 <UL>
23581 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23582 </UL><P>
23583 &lt;End of help on this topic&gt;
23584 </BODY>
23585 </HTML>
23586 ====== h_config_alt_addresses =====
23587 <HTML>
23588 <HEAD>
23589 <TITLE>OPTION: <!--#echo var="VAR_alt-addresses"--></TITLE>
23590 </HEAD>
23591 <BODY>
23592 <H1>OPTION: <!--#echo var="VAR_alt-addresses"--></H1>
23593
23594 This option provides a place for you to list alternate email addresses
23595 you may have.
23596 Each address in the list should be the actual email address part of an
23597 address, without the full name field or the angle brackets.
23598 For example:
23599
23600 <P>
23601 <CENTER><SAMP>user@example.com</SAMP></CENTER>
23602 <P>
23603
23604 The matching is case-insensitive, so this would match any of
23605 <SAMP>User@example.com</SAMP>, <SAMP>user@Example.Com</SAMP>, or
23606 <SAMP>USER@EXAMPLE.COM</SAMP> as well.
23607
23608 <P>
23609 If set, the option affects the behavior of the Reply
23610 command and the &quot;+&quot; symbol in the MESSAGE INDEX, which denotes that
23611 a message has been addressed specifically to you.
23612
23613 <P>
23614 In the default INDEX display
23615 the personal name (or email address) of
23616 the person listed in the message's &quot;From:&quot; header
23617 field is usually displayed except when that address is yours or one of your
23618 alternate addresses.
23619 In that case you will usually see the name of
23620 the first person specified in the
23621 message's &quot;To:&quot; header field
23622 with the prefix &quot;To: &quot; prepended.
23623
23624 <P>
23625 With respect to Reply, the reply-to-all option will exclude addresses
23626 listed here.
23627
23628 <P>
23629 The feature
23630 <A HREF="h_config_copy_to_to_from"><!--#echo var="FEAT_copy-to-address-to-from-if-it-is-us"--></A>
23631 is somewhat related to this option.
23632
23633 <P>
23634 In addition to a list of actual addresses,
23635 you may use regular expressions (as used with egrep with the ignore case flag)
23636 to describe the addresses you want to match.
23637 Alpine will somewhat arbitrarily interpret your entry as a regular
23638 expression if it contains any of the characters
23639 *, |, +, ?, {, [, ^, $, or &#92;.
23640 Otherwise, it will be treated literally.
23641 The feature
23642 <a href="h_config_disable_regex"><!--#echo var="FEAT_disable-regular-expression-matching-for-alternate-addresses"--></a>
23643 may be used to turn off regular expression processing regardless of whether or not
23644 special characters appear in the entry.
23645
23646 <P>
23647 A description of how regular expressions work is beyond the
23648 scope of this help text, but some examples follow.
23649
23650 <P>
23651 The entry
23652
23653 <P>
23654 <CENTER><SAMP>.*@example.com</SAMP></CENTER>
23655 <P>
23656
23657 in the <!--#echo var="VAR_alt-addresses"--> list would mean that any
23658 address with a domain name of <SAMP>example.com</SAMP> (such as
23659 <SAMP>fred@example.com</SAMP> or <SAMP>wilma@example.com</SAMP>) will be considered
23660 one of your alternate addresses.
23661 Strictly speaking, the dot in <SAMP>example.com</SAMP> ought to be escaped with
23662 a backslash, as in <SAMP>example&#92;.com</SAMP>, and a dollar sign anchor ought
23663 to come at the end of the expression to prevent a match of <SAMP>example.com.org</SAMP>.
23664 Complicating things further, the dollar sign
23665 is special in the Alpine configuration (it signifies environment variable expansion)
23666 so the dollar sign should be doubled or backslash escaped for Alpine's sake.
23667 Quotes around the whole expression will not escape the dollar sign successfully.
23668 So this example should look like
23669
23670 <P>
23671 <CENTER><SAMP>.*@example&#92;.com$$</SAMP></CENTER>
23672 <P>
23673
23674 <P>
23675 The entry
23676
23677 <P>
23678 <CENTER><SAMP>^fred[0-9]*@example.com$$</SAMP></CENTER>
23679 <P>
23680
23681 would match
23682 <SAMP>fred3@example.com</SAMP> or <SAMP>fred17@example.com</SAMP> as well
23683 as <SAMP>fred@example.com</SAMP>.
23684
23685 <P>
23686 You could match all addresses that look like
23687 <SAMP>fred+stuff@example.com</SAMP> for any value of <SAMP>stuff</SAMP> with the
23688 entry
23689
23690 <P>
23691 <CENTER><SAMP>^fred&#92;+.*@example.com$$</SAMP></CENTER>
23692 <P>
23693
23694 Notice that you have to escape the plus sign with a backslash because plus
23695 is a special character in regular expressions.
23696 If you wanted to match plain <SAMP>fred</SAMP> as well as <SAMP>fred+stuff</SAMP>
23697 the expression
23698
23699 <P>
23700 <CENTER><SAMP>^fred(()|&#92;+.*)@example.com$$</SAMP></CENTER>
23701 <P>
23702
23703 would do it, but it would be easier to just add fred@example.com as a
23704 separate entry.
23705
23706 <P>
23707 One more example, a match of all first-level subdomains, is given by
23708
23709 <P>
23710 <CENTER><SAMP>^fred@[[:alnum:]_-]*&#92;.example&#92;.com$$</SAMP></CENTER>
23711 <P>
23712
23713 <P>
23714 Because the regular expression matching is based on an old library
23715 (<SAMP>hs_regex</SAMP>) the regular expressions might not work exactly as you expect,
23716 but they should be close.
23717
23718 <P>
23719 <UL>
23720 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23721 </UL><P>
23722 &lt;End of help on this topic&gt;
23723 </BODY>
23724 </HTML>
23725 ====== h_config_abook_formats =====
23726 <HTML>
23727 <HEAD>
23728 <TITLE>OPTION: <!--#echo var="VAR_addressbook-formats"--></TITLE>
23729 </HEAD>
23730 <BODY>
23731 <H1>OPTION: <!--#echo var="VAR_addressbook-formats"--></H1>
23732
23733 This option specifies the format that address books are displayed in.
23734 Normally, address books are displayed with the nicknames in the first
23735 column, the fullnames in the second column, and addresses in the third
23736 column.  The system figures out reasonable defaults for the widths of
23737 the columns.  An address book may be given a different format by
23738 listing special tokens in the order you want them to display.  The
23739 possible tokens are NICKNAME, FULLNAME, ADDRESS, FCC, and COMMENT.
23740 So, for example, to get the default behavior you could list
23741
23742 <P>
23743 <CENTER><!--#echo var="VAR_addressbook-formats"-->=NICKNAME FULLNAME ADDRESS</CENTER>
23744
23745 <P>
23746 (You can also use the token DEFAULT to get the default behavior for
23747 an address book format.)
23748
23749 <P>
23750 The tokens are separated by spaces.  &quot;<!--#echo var="VAR_addressbook-formats"-->&quot;
23751 is a list, so if you have more than one address book you may have a
23752 separate format for each by putting its format at the corresponding
23753 location in the &quot;<!--#echo var="VAR_addressbook-formats"-->&quot; list.
23754
23755 <P>
23756
23757 Listed first are the personal address books, then the global address
23758 books.  So, if you have two personal address books and one global
23759 address book, you may have up to three formats in the
23760 &quot;<!--#echo var="VAR_addressbook-formats"-->&quot; list.  If
23761 &quot;<!--#echo var="VAR_addressbook-formats"-->&quot; doesn't have as many elements as there
23762 are address books, the last element is used repeatedly.
23763
23764 <P>
23765
23766 Each of the tokens may also be optionally followed by parentheses with
23767 either a number or a percentage inside the parentheses.  For example,
23768 <SAMP>FULLNAME(13)</SAMP> means to allocate 13 characters of space to
23769 the fullnames column, <SAMP>FULLNAME(20%)</SAMP> means to allocate 20%
23770 of the available space (the screen width minus the space for
23771 inter-column spaces) to the fullnames column, while plain
23772 <SAMP>FULLNAME</SAMP> means the system will attempt to figure out a
23773 reasonable number of columns.
23774
23775 <P>
23776 There are always 2 spaces between every column, so if you use
23777 fixed column widths (like 13) you should remember to take that into
23778 account.
23779
23780 <P>
23781 <UL>
23782 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23783 </UL><P>
23784 &lt;End of help on this topic&gt;
23785 </BODY>
23786 </HTML>
23787 ====== h_config_set_index_format =====
23788 <HTML>
23789 <HEAD>
23790 <TITLE>Set Index Format</TITLE>
23791 </HEAD>
23792 <BODY>
23793 <H1>Set Index Format</H1>
23794
23795 This option is used to customize the content of lines in the
23796 <A HREF="h_mail_index">MESSAGE INDEX screen</A>.
23797 This action works exactly like the regular
23798 &quot;<!--#echo var="VAR_index-format"-->&quot; option in the Setup/Config screen,
23799 except that you can have a folder-specific value for it if you specify it here.
23800 Consult the help for
23801 &quot;<A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A>&quot;
23802 for more information.
23803
23804 <P>
23805 <UL>
23806 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23807 </UL><P>
23808 &lt;End of help on this topic&gt;
23809 </BODY>
23810 </HTML>
23811 ====== h_config_index_format =====
23812 <HTML>
23813 <HEAD>
23814 <TITLE>OPTION: <!--#echo var="VAR_index-format"--></TITLE>
23815 </HEAD>
23816 <BODY>
23817 <H1>OPTION: <!--#echo var="VAR_index-format"--></H1>
23818
23819 This option is used to customize the content of lines in the
23820 <A HREF="h_mail_index">MESSAGE INDEX screen</A>.  Each line is intended
23821 to convey some amount of immediately relevant information about each
23822 message in the current folder.
23823 <P>
23824
23825 Alpine provides a pre-defined set of informational fields with
23826 reasonable column widths automatically computed.  You can, however,
23827 replace this default set by listing special tokens in the order you
23828 want them displayed.
23829 <P>
23830
23831 The list of available tokens is
23832 <A HREF="h_index_tokens">here</A>.
23833 <P>
23834
23835 Spaces are used to separate listed tokens.  Additionally, you can
23836 specify how much of the screen's width the token's associated data
23837 should occupy on the index line by appending to the token a pair of
23838 parentheses enclosing either a number or percentage.  For example,
23839 &quot;SUBJECT(13)&quot; means to allocate 13 characters of space to the subject
23840 column, and &quot;SUBJECT(20%)&quot; means to
23841 allocate 20% of the available space
23842 to the subjects column, while plain &quot;SUBJECT&quot; means the system will
23843 attempt to figure out a reasonable amount of space.
23844 <P>
23845
23846 There is always one space between every pair of columns, so if you use fixed
23847 column widths (like 13) you should remember to take that into account.
23848 Several of the fields are virtually fixed-width, so it doesn't make
23849 much sense to specify the width for them.  The fields STATUS,
23850 FULLSTATUS, IMAPSTATUS, MSGNO, the DATE fields, SIZE,
23851 and DESCRIPSIZE all fall into that category.
23852 You <EM>may</EM> specify widths for those if you wish, but
23853 you're probably better off letting the system pick those widths.  <P>
23854
23855 <P>
23856 The default is equivalent to:
23857
23858 <P>
23859 <CENTER><SAMP>STATUS MSGNO SMARTDATETIME24 FROMORTO(33%) SIZENARROW SUBJKEY(67%)</SAMP></CENTER>
23860
23861 <P>
23862 This means that the four fields without percentages will be allocated
23863 first, and then 33% and 67% of the <EM>remaining</EM> space will go to
23864 the from and subject fields.  If one of those two fields is specified
23865 as a percentage and the other is left for the system to choose, then
23866 the percentage is taken as an absolute percentage of the screen, not
23867 of the space remaining after allocating the first four columns.  It
23868 doesn't usually make sense to do it that way.  If you leave off all
23869 the widths, then the subject and from fields (if both are present) are
23870 allocated space in a 2 to 1 ratio, which is almost exactly the same as
23871 the default.
23872
23873 <P>
23874 What you are most likely to do with this configuration option is to
23875 specify which fields appear at all, which order they appear in, and the
23876 percentage of screen that is used for the from and subject fields if you
23877 don't like the 2 to 1 default.
23878
23879 <P>
23880 If you want to retain the default format that Pine 4.64 had, use
23881
23882 <P>
23883 <CENTER><SAMP><!--#echo var="VAR_index-format"-->=STATUS MSGNO DATE FROMORTO(33%) SIZE SUBJKEY(67%)</SAMP></CENTER>
23884 <P>
23885 <EM>and</EM> set the feature
23886 <A HREF="h_config_disable_index_locale_dates"><!--#echo var="FEAT_disable-index-locale-dates"--></A>.
23887 <UL>
23888 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23889 </UL><P>
23890 &lt;End of help on this topic&gt;
23891 </BODY>
23892 </HTML>
23893 ====== h_config_reply_intro =====
23894 <HTML>
23895 <HEAD>
23896 <TITLE>OPTION: <!--#echo var="VAR_reply-leadin"--></TITLE>
23897 </HEAD>
23898 <BODY>
23899 <H1>OPTION: <!--#echo var="VAR_reply-leadin"--></H1>
23900
23901 This option is used to customize the content of the introduction line
23902 that is included when replying to a message and including the original
23903 message in the reply.
23904 The normal default (what you will get if you delete this variable) looks
23905 something like:
23906 <P>
23907 <CENTER><SAMP>On Sat, 24 Oct 1998, Fred Flintstone wrote:</SAMP></CENTER>
23908 <P>
23909 where the day of the week is only included if it is available in the
23910 original message.
23911 You can replace this default with text of your own.
23912 The text may contain tokens that are replaced with text
23913 that depends on the message you are replying to.
23914 For example, the default is equivalent to:
23915 <P>
23916 <CENTER><SAMP>On _DAYDATE_, _FROM_ wrote:</SAMP></CENTER>
23917 <P>
23918
23919 Since this variable includes regular text mixed with special tokens
23920 the tokens have to be surrounded by underscore characters.
23921 For example, to use the token &quot;<SAMP>PREFDATE</SAMP>&quot;
23922 you would need to use &quot;<SAMP>_PREFDATE_</SAMP>&quot;,
23923 not &quot;<SAMP>PREFDATE</SAMP>&quot;.
23924 <P>
23925 The list of available tokens is
23926 <A HREF="h_index_tokens">here</A>.
23927
23928 <P>
23929 By default, the text is all on a single line and is followed by a blank line.
23930 If your &quot;<!--#echo var="VAR_reply-leadin"-->&quot; turns out to be longer
23931 than 80 characters when replying to a particular message, it is shortened.
23932 However, if you use the token
23933 <P>
23934 <CENTER><SAMP>_NEWLINE_</SAMP></CENTER>
23935 <P>
23936
23937 anywhere in the value, no end of line or blank line is appended, and no
23938 shortening is done.
23939 The _NEWLINE_ token may be used to get rid of the blank line following
23940 the text, to add more blank lines, or to form a multi-line
23941 &quot;<!--#echo var="VAR_reply-leadin"-->&quot;.
23942 To clarify how _NEWLINE_ works recall that the default value is:
23943 <P>
23944 <CENTER><SAMP>On _DAYDATE_, _FROM_ wrote:</SAMP></CENTER>
23945 <P>
23946
23947 That is equivalent to
23948 <P>
23949 <CENTER><SAMP>On _DAYDATE_, _FROM_ wrote:_NEWLINE__NEWLINE_</SAMP></CENTER>
23950 <P>
23951
23952 In the former case, two newlines are added automatically because
23953 no _NEWLINE_ token appears in the value of the option (for backwards
23954 compatibility). In the latter case, the newlines are explicit.
23955 If you want to remove the blank line that follows the
23956 &quot;<!--#echo var="VAR_reply-leadin"-->&quot; text use a single
23957 _NEWLINE_ token like
23958 <P>
23959 <CENTER><SAMP>On _DAYDATE_, _FROM_ wrote:_NEWLINE_</SAMP></CENTER>
23960 <P>
23961
23962 Because of the backwards compatibility problem, it is not possible to
23963 remove all of the ends of lines, because then there will be no _NEWLINE_ tokens
23964 and that will cause the automatic adding of two newlines!
23965 If you want, you may embed newlines in the middle of the text, as well,
23966 producing a multi-line &quot;<!--#echo var="VAR_reply-leadin"-->&quot;.
23967
23968 <P>
23969 By default, no attempt is made to localize the date.
23970 If you prefer a localized form you may find that one of the tokens
23971 _PREFDATE_ or _PREFDATETIME_ is a satisfactory substitute.
23972 If you want more control one of the many other date tokens, such as _DATEISO_,
23973 might be better.
23974
23975 <P>
23976 For the adventurous, there is a way to conditionally include text based
23977 on whether or not a token would result in specific replacement text.
23978 For example, you could include some text based on whether or not
23979 the _NEWS_ token would result in any newsgroups if it was used.
23980 It's explained in detail
23981 <A HREF="h_reply_token_conditionals">here</A>.
23982
23983 <P>
23984 In the very unlikely event that you want to include a literal token
23985 in the introduction line you must precede it with a backslash character.
23986 For example,
23987 <P>
23988 <CENTER><SAMP>&#92;_DAYDATE_ = _DAYDATE_</SAMP></CENTER>
23989 <P>
23990 would produce something like
23991 <P>
23992 <CENTER><SAMP>_DAYDATE_ = Sat, 24 Oct 1998</SAMP></CENTER>
23993 <P>
23994 It is not possible to have a literal backslash followed by an expanded token.
23995 <P>
23996 <UL>
23997 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23998 </UL><P>
23999 &lt;End of help on this topic&gt;
24000 </BODY>
24001 </HTML>
24002 ====== h_config_remote_abook_history =====
24003 <HTML>
24004 <HEAD>
24005 <TITLE>OPTION: <!--#echo var="VAR_remote-abook-history"--></TITLE>
24006 </HEAD>
24007 <BODY>
24008 <H1>OPTION: <!--#echo var="VAR_remote-abook-history"--></H1>
24009
24010 Sets how many extra copies of
24011 remote address book
24012 data will be kept in each remote address book folder.
24013 The default is three.
24014 These extra copies are simply old versions of the data. Each time a change
24015 is made a new copy of the address book data is appended to the folder. Old
24016 copies are trimmed, if possible, when Alpine exits.
24017 An old copy can be put back into use by
24018 deleting and expunging newer versions of the data from the folder.
24019 Don't delete the first message from the folder. It is a special header
24020 message for the remote address book and it must be there.
24021 This is to prevent regular folders from being used as remote address book
24022 folders and having their data destroyed.
24023 <P>
24024 This option is also used to determine how many extra copies of remote
24025 Alpine configuration files are kept.
24026 <P>
24027 <UL>
24028 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24029 </UL><P>
24030 &lt;End of help on this topic&gt;
24031 </BODY>
24032 </HTML>
24033 ====== h_config_remote_abook_validity =====
24034 <HTML>
24035 <HEAD>
24036 <TITLE>OPTION: <!--#echo var="VAR_remote-abook-validity"--></TITLE>
24037 </HEAD>
24038 <BODY>
24039 <H1>OPTION: <!--#echo var="VAR_remote-abook-validity"--></H1>
24040
24041 Sets the minimum number of minutes that a
24042 remote address book will be considered up to date.
24043 Whenever an entry contained in a remote address book is used,
24044 if more than this many minutes have
24045 passed since the last check the remote server will be queried to see if the
24046 address book has changed.
24047 If it has changed, the local copy is updated.
24048 The default value is five minutes.
24049 The special value of -1 means never check.
24050 The special value of zero means only check when the address book is first
24051 opened.
24052 <P>
24053 No matter what the value, the validity check is always done when the
24054 address book is about to be changed by the user.
24055 The check can be initiated manually by typing <EM>^L</EM> (Ctrl-L)
24056 while in the address book maintenance screen for the remote address book.
24057 <P>
24058 <UL>
24059 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24060 </UL><P>
24061 &lt;End of help on this topic&gt;
24062 </BODY>
24063 </HTML>
24064 ====== h_config_user_input_timeo =====
24065 <HTML>
24066 <HEAD>
24067 <TITLE>OPTION: <!--#echo var="VAR_user-input-timeout"--></TITLE>
24068 </HEAD>
24069 <BODY>
24070 <H1>OPTION: <!--#echo var="VAR_user-input-timeout"--></H1>
24071
24072 If this is set to an integer greater than zero, then this is the number
24073 of <EM>hours</EM> to wait for user input before Alpine times out.
24074 If Alpine is
24075 in the midst of composing a message or is waiting for user response to
24076 a question, then it will not timeout.
24077 However, if Alpine is sitting idle waiting for
24078 the user to tell it what to do next and the user does not give any
24079 input for this many hours, Alpine will exit.
24080 No expunging or moving of read
24081 messages will take place.
24082 It will exit similarly to the way it would exit
24083 if it received a hangup signal.
24084 This may be useful for cleaning up unused Alpine sessions that have been
24085 forgotten by their owners.
24086 The Alpine developers envision system administrators
24087 setting this to a value of several hours (24?) so that it won't surprise
24088 a user who didn't want to be disconnected.
24089 <P>
24090 <UL>
24091 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24092 </UL><P>
24093 &lt;End of help on this topic&gt;
24094 </BODY>
24095 </HTML>
24096 ====== h_config_ssh_open_timeo =====
24097 <HTML>
24098 <HEAD>
24099 <TITLE>OPTION: <!--#echo var="VAR_ssh-open-timeout"--></TITLE>
24100 </HEAD>
24101 <BODY>
24102 <H1>OPTION: <!--#echo var="VAR_ssh-open-timeout"--></H1>
24103
24104 Sets the time in seconds that Alpine will
24105 attempt to open a UNIX secure shell connection.
24106 The default is 15, the minimum non-zero value is 5,
24107 and the maximum is unlimited. If this is set to zero ssh connections
24108 will be completely disabled.
24109 <P>
24110 <UL>
24111 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24112 </UL><P>
24113 &lt;End of help on this topic&gt;
24114 </BODY>
24115 </HTML>
24116 ====== h_config_rsh_open_timeo =====
24117 <HTML>
24118 <HEAD>
24119 <TITLE>OPTION: <!--#echo var="VAR_rsh-open-timeout"--></TITLE>
24120 </HEAD>
24121 <BODY>
24122 <H1>OPTION: <!--#echo var="VAR_rsh-open-timeout"--></H1>
24123
24124 Sets the time in seconds that Alpine will
24125 attempt to open a UNIX remote shell connection.
24126 The default is 15, the minimum non-zero value is 5,
24127 and the maximum is unlimited. If this is set to zero rsh connections
24128 will be completely disabled.
24129 This might be useful if rsh connections will never work in your environment
24130 but are causing delays due to firewalls or some other reason.
24131 <P>
24132 <UL>
24133 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24134 </UL><P>
24135 &lt;End of help on this topic&gt;
24136 </BODY>
24137 </HTML>
24138 ====== h_config_tcp_open_timeo =====
24139 <HTML>
24140 <HEAD>
24141 <TITLE>OPTION: <!--#echo var="VAR_tcp-open-timeout"--></TITLE>
24142 </HEAD>
24143 <BODY>
24144 <H1>OPTION: <!--#echo var="VAR_tcp-open-timeout"--></H1>
24145
24146 Sets the time in seconds that Alpine will
24147 attempt to open a network connection. The default is 30, the minimum is 5,
24148 and the maximum is system defined (typically 75). If a connection has not
24149 completed within this many seconds Alpine will give up and consider it a
24150 failed connection.
24151 <P>
24152 <UL>
24153 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24154 </UL><P>
24155 &lt;End of help on this topic&gt;
24156 </BODY>
24157 </HTML>
24158 ====== h_config_tcp_readwarn_timeo =====
24159 <HTML>
24160 <HEAD>
24161 <TITLE>OPTION: <!--#echo var="VAR_tcp-read-warning-timeout"--></TITLE>
24162 </HEAD>
24163 <BODY>
24164 <H1>OPTION: <!--#echo var="VAR_tcp-read-warning-timeout"--></H1>
24165
24166 Sets the time in seconds that Alpine will
24167 wait for a network read before warning you that things are moving slowly
24168 and possibly giving you the option to break the connection.
24169 The default is 15 seconds. The minimum is 5 seconds and the maximumn is
24170 1000 seconds.
24171 <P>
24172 Related option: <A HREF="h_config_tcp_query_timeo"><!--#echo var="VAR_tcp-query-timeout"--></A>.
24173 <P>
24174 <UL>
24175 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24176 </UL><P>
24177 &lt;End of help on this topic&gt;
24178 </BODY>
24179 </HTML>
24180 ====== h_config_tcp_writewarn_timeo =====
24181 <HTML>
24182 <HEAD>
24183 <TITLE>OPTION: <!--#echo var="VAR_tcp-write-warning-timeout"--></TITLE>
24184 </HEAD>
24185 <BODY>
24186 <H1>OPTION: <!--#echo var="VAR_tcp-write-warning-timeout"--></H1>
24187
24188 Sets the time in seconds that Alpine will
24189 wait for a network write before warning you that things are moving slowly
24190 and possibly giving you the option to break the connection.
24191 The default is 0 which means it is unset. If set to a non-zero value, the
24192 minimum is 5 and the maximum is 1000.
24193 <P>
24194 Related option: <A HREF="h_config_tcp_query_timeo"><!--#echo var="VAR_tcp-query-timeout"--></A>.
24195 <P>
24196 <UL>
24197 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24198 </UL><P>
24199 &lt;End of help on this topic&gt;
24200 </BODY>
24201 </HTML>
24202 ====== h_config_tcp_query_timeo =====
24203 <HTML>
24204 <HEAD>
24205 <TITLE>OPTION: <!--#echo var="VAR_tcp-query-timeout"--></TITLE>
24206 </HEAD>
24207 <BODY>
24208 <H1>OPTION: <!--#echo var="VAR_tcp-query-timeout"--></H1>
24209
24210 When Alpine times out a network read or write it will normally just display
24211 a message saying &quot;Still waiting&quot;.
24212 However, if enough time has elapsed since it started waiting it will offer
24213 to let you break the connection.
24214 That amount of time is set by this option, which defaults to 60 seconds,
24215 has a minimum of 5 seconds, and a maximum of 1000 seconds.
24216 <P>
24217 <UL>
24218 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24219 </UL><P>
24220 &lt;End of help on this topic&gt;
24221 </BODY>
24222 </HTML>
24223 ====== h_config_incoming_folders =====
24224 <HTML>
24225 <HEAD>
24226 <TITLE>OPTION: <!--#echo var="VAR_incoming-folders"--></TITLE>
24227 </HEAD>
24228 <BODY>
24229 <H1>OPTION: <!--#echo var="VAR_incoming-folders"--></H1>
24230
24231 This is a list of one or more folders other than <EM>INBOX</EM> that
24232 may receive new messages.
24233 It is related to the
24234 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="FEAT_enable-incoming-folders"-->&quot;</A>
24235 feature.
24236 This variable is normally manipulated with the Add, Delete, and Rename
24237 commands in the FOLDER LIST for the Incoming Message Folders collection.
24238 <P>
24239 <UL>
24240 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24241 </UL><P>
24242 &lt;End of help on this topic&gt;
24243 </BODY>
24244 </HTML>
24245 ====== h_config_folder_spec =====
24246 <HTML>
24247 <HEAD>
24248 <TITLE>OPTION: <!--#echo var="VAR_folder-collections"--></TITLE>
24249 </HEAD>
24250 <BODY>
24251 <H1>OPTION: <!--#echo var="VAR_folder-collections"--></H1>
24252
24253 This is a list of one or more collections where saved mail is stored.
24254 The first collection in this list is the default
24255 collection for <EM>Save</EM>s,
24256 including <A HREF="h_config_default_fcc"><!--#echo var="VAR_default-fcc"--></A>.
24257 <P>
24258 This variable is normally manipulated using the Setup/collectionList screen.
24259 <P>
24260 <UL>
24261 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24262 </UL><P>
24263 &lt;End of help on this topic&gt;
24264 </BODY>
24265 </HTML>
24266 ====== h_config_news_spec =====
24267 <HTML>
24268 <HEAD>
24269 <TITLE>OPTION: <!--#echo var="VAR_news-collections"--></TITLE>
24270 </HEAD>
24271 <BODY>
24272 <H1>OPTION: <!--#echo var="VAR_news-collections"--></H1>
24273
24274 This is a list of collections where news folders are located.
24275 <P>
24276 This variable is normally manipulated using the Setup/collectionList screen.
24277 <P>
24278 <UL>
24279 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24280 </UL><P>
24281 &lt;End of help on this topic&gt;
24282 </BODY>
24283 </HTML>
24284 ====== h_config_address_book =====
24285 <HTML>
24286 <HEAD>
24287 <TITLE>OPTION: <!--#echo var="VAR_address-book"--></TITLE>
24288 </HEAD>
24289 <BODY>
24290 <H1>OPTION: <!--#echo var="VAR_address-book"--></H1>
24291
24292 A list of personal address books.
24293 Each entry in the list is an
24294 optional nickname followed by a pathname or file name relative to the home
24295 directory.
24296 The nickname is separated from the rest of the line with whitespace.
24297 Instead of a local pathname or file name, a remote folder name can be given.
24298 This causes the address book to
24299 be a Remote address book.
24300 <P>
24301 Use the Setup/AddressBook screen to modify this variable.
24302 <P>
24303 <UL>
24304 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24305 </UL><P>
24306 &lt;End of help on this topic&gt;
24307 </BODY>
24308 </HTML>
24309 ====== h_config_glob_addrbook =====
24310 <HTML>
24311 <HEAD>
24312 <TITLE>OPTION: <!--#echo var="VAR_global-address-book"--></TITLE>
24313 </HEAD>
24314 <BODY>
24315 <H1>OPTION: <!--#echo var="VAR_global-address-book"--></H1>
24316
24317 A list of shared address books.  Each entry in the list is an
24318 optional nickname followed by a pathname or file name relative to the home
24319 directory.
24320 A SPACE character separates the nickname from the rest of the line.
24321 Instead of a local pathname or file name, a remote folder name can be given.
24322 This causes the address book to
24323 be a Remote address book.
24324 Global address books are
24325 defined to be ReadOnly.
24326 <P>
24327 Use the Setup/AddressBook screen to modify this variable.
24328 <P>
24329 <UL>
24330 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24331 </UL><P>
24332 &lt;End of help on this topic&gt;
24333 </BODY>
24334 </HTML>
24335 ====== h_config_last_vers =====
24336 <HTML>
24337 <HEAD>
24338 <TITLE>OPTION: <!--#echo var="VAR_last-version-used"--></TITLE>
24339 </HEAD>
24340 <BODY>
24341 <H1>OPTION: <!--#echo var="VAR_last-version-used"--></H1>
24342
24343 This is set automatically by Alpine.
24344 It is used to keep track of the last version of Alpine that
24345 was run by the user.
24346 Whenever the version number increases, a new version message is printed out.
24347 This may not be set in the system-wide configuration files.
24348 <P>
24349 <UL>
24350 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24351 </UL><P>
24352 &lt;End of help on this topic&gt;
24353 </BODY>
24354 </HTML>
24355 ====== h_config_printer =====
24356 <HTML>
24357 <HEAD>
24358 <TITLE>OPTION: Printer</TITLE>
24359 </HEAD>
24360 <BODY>
24361 <H1>OPTION: Printer</H1>
24362
24363 Your default printer selection.
24364 <P>
24365 Use the Setup/Printer screen to modify this variable.
24366 <P>
24367 <UL>
24368 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24369 </UL><P>
24370 &lt;End of help on this topic&gt;
24371 </BODY>
24372 </HTML>
24373 ====== h_config_print_cat =====
24374 <HTML>
24375 <HEAD>
24376 <TITLE>OPTION: <!--#echo var="VAR_personal-print-category"--></TITLE>
24377 </HEAD>
24378 <BODY>
24379 <H1>OPTION: <!--#echo var="VAR_personal-print-category"--></H1>
24380
24381 This is an internal Alpine variable.
24382 It will be equal to 1, 2, or 3 depending on whether the default printer is
24383 attached, standard, or a personal print command.
24384 <P>
24385 Use the Setup/Printer screen to modify this variable.
24386 <P>
24387 <UL>
24388 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24389 </UL><P>
24390 &lt;End of help on this topic&gt;
24391 </BODY>
24392 </HTML>
24393 ====== h_config_print_command =====
24394 <HTML>
24395 <HEAD>
24396 <TITLE>OPTION: <!--#echo var="VAR_personal-print-command"--></TITLE>
24397 </HEAD>
24398 <BODY>
24399 <H1>OPTION: <!--#echo var="VAR_personal-print-command"--></H1>
24400
24401 List of personal print commands.
24402 <P>
24403 Use the Setup/Printer screen to modify this variable.
24404 <P>
24405 <UL>
24406 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24407 </UL><P>
24408 &lt;End of help on this topic&gt;
24409 </BODY>
24410 </HTML>
24411 ====== h_config_pat_old =====
24412 <HTML>
24413 <HEAD>
24414 <TITLE>OPTION: Patterns</TITLE>
24415 </HEAD>
24416 <BODY>
24417 <H1>OPTION: Patterns</H1>
24418
24419 The option Patterns is obsolete in Alpine and in Pine 4.50 and later, replaced by the
24420 options Patterns-Roles, Patterns-Filters, Patterns-Scores, Patterns-Indexcolors,
24421 and Patterns-Other.
24422 Patterns-Scores and Patterns-Filters have been replaced since then by
24423 Patterns-Scores2 and Patterns-Filters2.
24424 <P>
24425 Use the Setup/Rules screens to modify these variable.
24426 <P>
24427 <UL>
24428 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24429 </UL><P>
24430 &lt;End of help on this topic&gt;
24431 </BODY>
24432 </HTML>
24433 ====== h_config_pat_roles =====
24434 <HTML>
24435 <HEAD>
24436 <TITLE>OPTION: <!--#echo var="VAR_patterns-roles"--></TITLE>
24437 </HEAD>
24438 <BODY>
24439 <H1>OPTION: <!--#echo var="VAR_patterns-roles"--></H1>
24440
24441 List of rules used for roles.
24442 The option Patterns is obsolete in Alpine and in Pine 4.50 and later, replaced by this and
24443 other options.
24444 <P>
24445 Use the Setup/Rules/Roles screen to modify this variable.
24446 <P>
24447 <UL>
24448 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24449 </UL><P>
24450 &lt;End of help on this topic&gt;
24451 </BODY>
24452 </HTML>
24453 ====== h_config_pat_filts =====
24454 <HTML>
24455 <HEAD>
24456 <TITLE>OPTION: <!--#echo var="VAR_patterns-filters2"--></TITLE>
24457 </HEAD>
24458 <BODY>
24459 <H1>OPTION: <!--#echo var="VAR_patterns-filters2"--></H1>
24460
24461 List of rules used for filters.
24462 <P>
24463 Use the Setup/Rules/Filters screen to modify this variable.
24464 <P>
24465 <UL>
24466 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24467 </UL><P>
24468 &lt;End of help on this topic&gt;
24469 </BODY>
24470 </HTML>
24471 ====== h_config_pat_scores =====
24472 <HTML>
24473 <HEAD>
24474 <TITLE>OPTION: <!--#echo var="VAR_patterns-scores2"--></TITLE>
24475 </HEAD>
24476 <BODY>
24477 <H1>OPTION: <!--#echo var="VAR_patterns-scores2"--></H1>
24478
24479 List of rules used for scoring.
24480 <P>
24481 Use the Setup/Rules/SetScores screen to modify this variable.
24482 <P>
24483 <UL>
24484 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24485 </UL><P>
24486 &lt;End of help on this topic&gt;
24487 </BODY>
24488 </HTML>
24489 ====== h_config_pat_other =====
24490 <HTML>
24491 <HEAD>
24492 <TITLE>OPTION: <!--#echo var="VAR_patterns-other"--></TITLE>
24493 </HEAD>
24494 <BODY>
24495 <H1>OPTION: <!--#echo var="VAR_patterns-other"--></H1>
24496
24497 List of rules used for miscellaneous configuration.
24498 <P>
24499 Use the Setup/Rules/Other screen to modify this variable.
24500 <P>
24501 <UL>
24502 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24503 </UL><P>
24504 &lt;End of help on this topic&gt;
24505 </BODY>
24506 </HTML>
24507 ====== h_config_pat_incols =====
24508 <HTML>
24509 <HEAD>
24510 <TITLE>OPTION: patterns-indexcolors</TITLE>
24511 </HEAD>
24512 <BODY>
24513 <H1>OPTION: patterns-indexcolors</H1>
24514
24515 List of rules used for coloring lines in the index.
24516 <P>
24517 Use the Setup/Rules/Indexcolor screen to modify this variable.
24518 <P>
24519 <UL>
24520 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24521 </UL><P>
24522 &lt;End of help on this topic&gt;
24523 </BODY>
24524 </HTML>
24525 ====== h_config_pat_srch =====
24526 <HTML>
24527 <HEAD>
24528 <TITLE>OPTION: patterns-search</TITLE>
24529 </HEAD>
24530 <BODY>
24531 <H1>OPTION: patterns-search</H1>
24532
24533 List of rules used only for searching with the Select command in the MESSAGE INDEX.
24534 <P>
24535 Use the Setup/Rules/searCh screen to modify this variable.
24536 <P>
24537 <UL>
24538 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24539 </UL><P>
24540 &lt;End of help on this topic&gt;
24541 </BODY>
24542 </HTML>
24543 ====== h_config_font_name =====
24544 <HTML>
24545 <HEAD>
24546 <TITLE>OPTION: Font Name</TITLE>
24547 </HEAD>
24548 <BODY>
24549 <H1>OPTION: Font Name</H1>
24550
24551 PC-Alpine only.
24552 <P>
24553 Name of normal font.
24554 <P>
24555 Use the pulldown Config menu to modify this variable.
24556 <P>
24557 <UL>
24558 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24559 </UL><P>
24560 &lt;End of help on this topic&gt;
24561 </BODY>
24562 </HTML>
24563 ====== h_config_font_size =====
24564 <HTML>
24565 <HEAD>
24566 <TITLE>OPTION: Font Size</TITLE>
24567 </HEAD>
24568 <BODY>
24569 <H1>OPTION: Font Size</H1>
24570
24571 PC-Alpine only.
24572 <P>
24573 Size of normal font.
24574 <P>
24575 Use the pulldown Config menu to modify this variable.
24576 <P>
24577 <UL>
24578 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24579 </UL><P>
24580 &lt;End of help on this topic&gt;
24581 </BODY>
24582 </HTML>
24583 ====== h_config_font_style =====
24584 <HTML>
24585 <HEAD>
24586 <TITLE>OPTION: Font Style</TITLE>
24587 </HEAD>
24588 <BODY>
24589 <H1>OPTION: Font Style</H1>
24590
24591 PC-Alpine only.
24592 <P>
24593 Style of normal font.
24594 <P>
24595 Use the pulldown Config menu to modify this variable.
24596 <P>
24597 <UL>
24598 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24599 </UL><P>
24600 &lt;End of help on this topic&gt;
24601 </BODY>
24602 </HTML>
24603 ====== h_config_font_char_set =====
24604 <HTML>
24605 <HEAD>
24606 <TITLE>OPTION: Font Character Set</TITLE>
24607 </HEAD>
24608 <BODY>
24609 <H1>OPTION: Font Character Set</H1>
24610
24611 PC-Alpine only.
24612 <P>
24613 Character set of normal font.
24614 <P>
24615 Use the pulldown Config menu to modify this variable.
24616 <P>
24617 <UL>
24618 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24619 </UL><P>
24620 &lt;End of help on this topic&gt;
24621 </BODY>
24622 </HTML>
24623 ====== h_config_print_font_name =====
24624 <HTML>
24625 <HEAD>
24626 <TITLE>OPTION: Print-Font-Name</TITLE>
24627 </HEAD>
24628 <BODY>
24629 <H1>OPTION: Print-Font-Name</H1>
24630
24631 PC-Alpine only.
24632 <P>
24633 Name of printer font.
24634 <P>
24635 Use the pulldown Config menu to modify this variable.
24636 <P>
24637 <UL>
24638 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24639 </UL><P>
24640 &lt;End of help on this topic&gt;
24641 </BODY>
24642 </HTML>
24643 ====== h_config_print_font_size =====
24644 <HTML>
24645 <HEAD>
24646 <TITLE>OPTION: Print-Font-Size</TITLE>
24647 </HEAD>
24648 <BODY>
24649 <H1>OPTION: Print-Font-Size</H1>
24650
24651 PC-Alpine only.
24652 <P>
24653 Size of printer font.
24654 <P>
24655 Use the pulldown Config menu to modify this variable.
24656 <P>
24657 <UL>
24658 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24659 </UL><P>
24660 &lt;End of help on this topic&gt;
24661 </BODY>
24662 </HTML>
24663 ====== h_config_print_font_style =====
24664 <HTML>
24665 <HEAD>
24666 <TITLE>OPTION: Print-Font-Style</TITLE>
24667 </HEAD>
24668 <BODY>
24669 <H1>OPTION: Print-Font-Style</H1>
24670
24671 PC-Alpine only.
24672 <P>
24673 Style of printer font.
24674 <P>
24675 Use the pulldown Config menu to modify this variable.
24676 <P>
24677 <UL>
24678 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24679 </UL><P>
24680 &lt;End of help on this topic&gt;
24681 </BODY>
24682 </HTML>
24683 ====== h_config_print_font_char_set =====
24684 <HTML>
24685 <HEAD>
24686 <TITLE>OPTION: Print-Font-Char-Set</TITLE>
24687 </HEAD>
24688 <BODY>
24689 <H1>OPTION: Print-Font-Char-Set</H1>
24690
24691 PC-Alpine only.
24692 <P>
24693 Character set of printer font.
24694 <P>
24695 Use the pulldown Config menu to modify this variable.
24696 <P>
24697 <UL>
24698 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24699 </UL><P>
24700 &lt;End of help on this topic&gt;
24701 </BODY>
24702 </HTML>
24703 ====== h_config_window_position =====
24704 <HTML>
24705 <HEAD>
24706 <TITLE>OPTION: Window-Position</TITLE>
24707 </HEAD>
24708 <BODY>
24709 <H1>OPTION: Window-Position</H1>
24710
24711 PC-Alpine only.
24712 <P>
24713 Position on the screen of the Alpine window.
24714 <P>
24715 Alpine normally maintains this variable itself, and it is set automatically.
24716 This variable is provided to those who wish to use the same window position
24717 across different machines from the same configuration.
24718 <A HREF="h_config_winpos_in_config"><!--#echo var="FEAT_store-window-position-in-config"--></A>
24719 must also be set for this setting to be used.
24720 <P>
24721 The format for this variable is of the form: <CODE>CxR+X+Y</CODE>, where
24722 C is the number of columns, R is the number of rows, and X and Y specify the
24723 top left corner of the window.
24724 <P>
24725 <UL>
24726 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24727 </UL><P>
24728 &lt;End of help on this topic&gt;
24729 </BODY>
24730 </HTML>
24731 ====== h_config_cursor_style =====
24732 <HTML>
24733 <HEAD>
24734 <TITLE>OPTION: Cursor Style</TITLE>
24735 </HEAD>
24736 <BODY>
24737 <H1>OPTION: Cursor Style</H1>
24738
24739 PC-Alpine only.
24740 <P>
24741 Cursor style.
24742 <P>
24743 Use the pulldown Config menu to modify this variable.
24744 <P>
24745 <UL>
24746 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24747 </UL><P>
24748 &lt;End of help on this topic&gt;
24749 </BODY>
24750 </HTML>
24751 ====== h_config_ldap_servers =====
24752 <HTML>
24753 <HEAD>
24754 <TITLE>OPTION: <!--#echo var="VAR_ldap-servers"--></TITLE>
24755 </HEAD>
24756 <BODY>
24757 <H1>OPTION: <!--#echo var="VAR_ldap-servers"--></H1>
24758
24759 List of LDAP servers and associated data.
24760 <P>
24761 Use the Setup/Directory screen to modify this variable.
24762 <P>
24763 <UL>
24764 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24765 </UL><P>
24766 &lt;End of help on this topic&gt;
24767 </BODY>
24768 </HTML>
24769 ====== h_config_sendmail_path =====
24770 <HTML>
24771 <HEAD>
24772 <TITLE>OPTION: <!--#echo var="VAR_sendmail-path"--></TITLE>
24773 </HEAD>
24774 <BODY>
24775 <H1>OPTION: <!--#echo var="VAR_sendmail-path"--></H1>
24776
24777 This names the path to an
24778 alternative program, and any necessary arguments, to be used in posting
24779 mail messages. See the Technical notes for more information.
24780 <P>
24781 <UL>
24782 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24783 </UL><P>
24784 &lt;End of help on this topic&gt;
24785 </BODY>
24786 </HTML>
24787 ====== h_config_oper_dir =====
24788 <HTML>
24789 <HEAD>
24790 <TITLE>OPTION: <!--#echo var="VAR_operating-dir"--></TITLE>
24791 </HEAD>
24792 <BODY>
24793 <H1>OPTION: <!--#echo var="VAR_operating-dir"--></H1>
24794
24795 This names the root of the
24796 tree to which you are restricted when reading and writing folders and
24797 files. It is usually used in the system-wide,
24798 <EM>fixed</EM> configuration file.
24799 <P>
24800 <UL>
24801 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24802 </UL><P>
24803 &lt;End of help on this topic&gt;
24804 </BODY>
24805 </HTML>
24806 ====== h_config_rshpath =====
24807 <HTML>
24808 <HEAD>
24809 <TITLE>OPTION: <!--#echo var="VAR_rsh-path"--></TITLE>
24810 </HEAD>
24811 <BODY>
24812 <H1>OPTION: <!--#echo var="VAR_rsh-path"--></H1>
24813
24814 Sets the name of the command used to open a UNIX remote shell
24815 connection. The default is typically <CODE>/usr/ucb/rsh</CODE>.
24816 <P>
24817 <UL>
24818 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24819 </UL><P>
24820 &lt;End of help on this topic&gt;
24821 </BODY>
24822 </HTML>
24823 ====== h_config_rshcmd =====
24824 <HTML>
24825 <HEAD>
24826 <TITLE>OPTION: <!--#echo var="VAR_rsh-command"--></TITLE>
24827 </HEAD>
24828 <BODY>
24829 <H1>OPTION: <!--#echo var="VAR_rsh-command"--></H1>
24830
24831 Sets the format of the command used to
24832 open a UNIX remote shell connection. The default is
24833 "%s %s -l %s exec /etc/r%sd". All four "%s" entries MUST exist in the
24834 provided command. The first is for the command's pathname, the second is
24835 for the host to connnect to, the third is for the user to connect as, and
24836 the fourth is for the connection method (typically <CODE>imap</CODE>).
24837 <P>
24838 <UL>
24839 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24840 </UL><P>
24841 &lt;End of help on this topic&gt;
24842 </BODY>
24843 </HTML>
24844 ====== h_config_sshpath =====
24845 <HTML>
24846 <HEAD>
24847 <TITLE>OPTION: <!--#echo var="VAR_ssh-path"--></TITLE>
24848 </HEAD>
24849 <BODY>
24850 <H1>OPTION: <!--#echo var="VAR_ssh-path"--></H1>
24851
24852 Sets the name of the command used to open a UNIX secure shell
24853 connection. The default is typically <CODE>/usr/bin/ssh</CODE>.
24854 <P>
24855 <UL>
24856 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24857 </UL><P>
24858 &lt;End of help on this topic&gt;
24859 </BODY>
24860 </HTML>
24861 ====== h_config_sshcmd =====
24862 <HTML>
24863 <HEAD>
24864 <TITLE>OPTION: <!--#echo var="VAR_ssh-command"--></TITLE>
24865 </HEAD>
24866 <BODY>
24867 <H1>OPTION: <!--#echo var="VAR_ssh-command"--></H1>
24868
24869 Sets the format of the command used to
24870 open a UNIX secure shell connection. The default is
24871 "%s %s -l %s exec /etc/r%sd". All four "%s" entries MUST exist in the
24872 provided command. The first is for the command's pathname, the second is
24873 for the host to connnect to, the third is for the user to connect as, and
24874 the fourth is for the connection method (typically <CODE>imap</CODE>).
24875 <P>
24876 <UL>
24877 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24878 </UL><P>
24879 &lt;End of help on this topic&gt;
24880 </BODY>
24881 </HTML>
24882 ====== h_config_new_ver_quell =====
24883 <HTML>
24884 <HEAD>
24885 <TITLE>OPTION: <!--#echo var="VAR_new-version-threshold"--></TITLE>
24886 </HEAD>
24887 <BODY>
24888 <H1>OPTION: <!--#echo var="VAR_new-version-threshold"--></H1>
24889
24890 When a new version of Alpine is run for the first time it offers a
24891 special explanatory screen to the user upon startup.  This option
24892 helps control when and if that special screen appears for users that
24893 have previously run Alpine.  It takes as its value an Alpine version
24894 number.  Alpine versions less than the specified value will supress this
24895 special screen while versions equal to or greater than that specified
24896 will behave normally.
24897 <P>
24898 <UL>
24899 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24900 </UL><P>
24901 &lt;End of help on this topic&gt;
24902 </BODY>
24903 </HTML>
24904 ====== h_config_disable_drivers =====
24905 <HTML>
24906 <HEAD>
24907 <TITLE>OPTION: <!--#echo var="VAR_disable-these-drivers"--></TITLE>
24908 </HEAD>
24909 <BODY>
24910 <H1>OPTION: <!--#echo var="VAR_disable-these-drivers"--></H1>
24911
24912 This variable is a list of mail drivers that will be disabled.
24913 The candidates for disabling are listed below.
24914 There may be more in the future if you compile Alpine with
24915 a newer version of the c-client library.
24916 <P>
24917
24918 <UL>
24919 <LI> mbox
24920 <LI> mbx
24921 <LI> mh
24922 <LI> mmdf
24923 <LI> mtx
24924 <LI> mx
24925 <LI> news
24926 <LI> phile
24927 <LI> tenex
24928 <LI> unix
24929 </UL>
24930 <P>
24931
24932 The <EM>mbox</EM> driver enables the following behavior: if there is a
24933 file called <CODE>mbox</CODE>
24934 in your home directory, and if that file is either empty or in Unix mailbox
24935 format, then every time you open <EM>INBOX</EM> the <EM>mbox</EM> driver
24936 will automatically transfer mail from the system mail spool directory into the
24937 <CODE>mbox</CODE> file and
24938 delete it from the spool directory. If you disable the <EM>mbox</EM> driver,
24939 this will not happen.
24940 <P>
24941
24942 It is not recommended to disable the driver that supports the system default
24943 mailbox format. On most non-SCO systems, that driver is the
24944 <EM>unix</EM> driver.
24945 On most SCO systems, it is the <EM>mmdf</EM> driver.
24946 The system default driver may be
24947 configured to something else on your system; check with your system manager
24948 for additional information.
24949 <P>
24950
24951 It is most likely not very useful for you to disable any of the drivers other
24952 than possibly <EM>mbox</EM>.
24953 You could disable some of the others if you know for
24954 certain that you don't need them but the performance gain in doing so
24955 is very modest.
24956 <P>
24957 <UL>
24958 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24959 </UL><P>
24960 &lt;End of help on this topic&gt;
24961 </BODY>
24962 </HTML>
24963 ====== h_config_disable_auths =====
24964 <HTML>
24965 <HEAD>
24966 <TITLE>OPTION: <!--#echo var="VAR_disable-these-authenticators"--></TITLE>
24967 </HEAD>
24968 <BODY>
24969 <H1>OPTION: <!--#echo var="VAR_disable-these-authenticators"--></H1>
24970
24971 This variable is a list of SASL (Simple Authentication and Security
24972 Layer) authenticators that will be disabled.
24973 SASL is a mechanism for
24974 authenticating to IMAP, POP3, SMTP, and other network servers.
24975 <P>
24976
24977 Alpine matches its list of supported authenticators with the server to
24978 determine the most secure authenticator that is supported by both.
24979 If no matching authenticators are found, Alpine will revert to plaintext
24980 login (or, in the case of SMTP, will be unable to authenticate at all).
24981 <P>
24982 The candidates for disabling can be found <A HREF="X-Alpine-Config:">here</A>.
24983 <P>
24984
24985 Normally, you will not disable any authenticators.
24986 There are two exceptions:
24987 <P>
24988 <OL>
24989 <LI> You use a broken server that advertises an authenticator,
24990 but does not actually implement it.
24991 <LI> You have a Kerberos-capable version of Alpine and the server is
24992 also Kerberos-capable, but you can not obtain Kerberos
24993 credentials on the server machine, thus you desire to disable
24994 GSSAPI (which in turn disables Alpine's Kerberos support).
24995 </OL>
24996 <P>
24997 It is never necessary to disable authenticators, since Alpine will try
24998 other authenticators before giving up.
24999 However, disabling the relevant authenticator avoids annoying error messages.
25000 <P>
25001 <UL>
25002 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25003 </UL><P>
25004 &lt;End of help on this topic&gt;
25005 </BODY>
25006 </HTML>
25007 ====== h_config_abook_metafile =====
25008 <HTML>
25009 <HEAD>
25010 <TITLE>OPTION: <!--#echo var="VAR_remote-abook-metafile"--></TITLE>
25011 </HEAD>
25012 <BODY>
25013 <H1>OPTION: <!--#echo var="VAR_remote-abook-metafile"--></H1>
25014
25015 This is usually set by Alpine and is the name of a file
25016 that contains data about
25017 remote address books and remote configuration files.
25018 <P>
25019 <UL>
25020 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25021 </UL><P>
25022 &lt;End of help on this topic&gt;
25023 </BODY>
25024 </HTML>
25025 ====== h_config_composer_wrap_column =====
25026 <HTML>
25027 <HEAD>
25028 <TITLE>OPTION: <!--#echo var="VAR_composer-wrap-column"--></TITLE>
25029 </HEAD>
25030 <BODY>
25031 <H1>OPTION: <!--#echo var="VAR_composer-wrap-column"--></H1>
25032
25033
25034 This option specifies an aspect of Alpine's Composer.  This gives the
25035 maximum width that auto-wrapped lines will have.  It's also the maximum
25036 width of lines justified using the <A HREF="h_compose_justify">^J
25037 Justify</A> command.  The normal default
25038 is &quot;74&quot;.  The largest allowed setting is normally &quot;80&quot;
25039 in order to
25040 prevent very long lines from being sent in outgoing mail.  When the mail
25041 is actually sent, trailing spaces will be stripped off of each line.
25042
25043 <P>
25044 <UL>
25045 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25046 </UL><P>
25047 &lt;End of help on this topic&gt;
25048 </BODY>
25049 </HTML>
25050 ====== h_config_deadlets =====
25051 <HTML>
25052 <HEAD>
25053 <TITLE>OPTION: <!--#echo var="VAR_dead-letter-files"--></TITLE>
25054 </HEAD>
25055 <BODY>
25056 <H1>OPTION: <!--#echo var="VAR_dead-letter-files"--></H1>
25057
25058
25059 This option affects Alpine's behavior when you cancel a message being
25060 composed.  Alpine's usual behavior is to write the canceled message to
25061 a file named
25062 <!--chtml if pinemode="os_windows"-->
25063 &quot;DEADLETR&quot;,
25064 <!--chtml else-->
25065 &quot;dead.letter&quot; in your home directory,
25066 <!--chtml endif-->
25067 overwriting any previous message.
25068 <P>
25069 If you set this option to a value higher than one, then that many copies
25070 of dead letter files will be saved.
25071 For example, if you set this option to &quot;3&quot; then you may have
25072 files named
25073 <!--chtml if pinemode="os_windows"-->
25074 &quot;DEADLETR&quot;,
25075 &quot;DEADLETR2&quot;, and
25076 &quot;DEADLETR3&quot;.
25077 <!--chtml else-->
25078 &quot;dead.letter&quot;,
25079 &quot;dead.letter2&quot;, and
25080 &quot;dead.letter3&quot; in your home directory.
25081 <!--chtml endif-->
25082 In this example, the most recently cancelled message will be in
25083 <!--chtml if pinemode="os_windows"-->
25084 &quot;DEADLETR&quot;,
25085 <!--chtml else-->
25086 &quot;dead.letter&quot;,
25087 <!--chtml endif-->
25088 and the third most recently cancelled message will be in
25089 <!--chtml if pinemode="os_windows"-->
25090 &quot;DEADLETR3&quot;.
25091 <!--chtml else-->
25092 &quot;dead.letter3&quot;.
25093 <!--chtml endif-->
25094 The fourth most recently cancelled message will no longer be saved.
25095
25096 <P>
25097 If you set this option to zero, then NO record of canceled messages is
25098 maintained.
25099 <P>
25100 If the feature
25101 <A HREF="h_config_quell_dead_letter"><!--#echo var="FEAT_quell-dead-letter-on-cancel"--></A>
25102 is set, that overrides whatever you set for this option.
25103 If this option had existed at the time, then the Quell feature would not
25104 have been added, but it is still there for backwards compatibility.
25105 So, in order for this option to have the desired effect, make sure the
25106 Quell feature is turned off.
25107
25108 <P>
25109 <UL>
25110 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25111 </UL><P>
25112 &lt;End of help on this topic&gt;
25113 </BODY>
25114 </HTML>
25115 ====== h_config_maxremstream =====
25116 <HTML>
25117 <HEAD>
25118 <TITLE>OPTION: <!--#echo var="VAR_max-remote-connections"--></TITLE>
25119 </HEAD>
25120 <BODY>
25121 <H1>OPTION: <!--#echo var="VAR_max-remote-connections"--></H1>
25122
25123 This option affects low-level behavior of Alpine.
25124 The default value for this option is <EM>3</EM>.
25125 If your INBOX is accessed using the IMAP protocol
25126 from an IMAP server, that connection is kept open throughout the
25127 duration of your Alpine session, independent of the value of this option.
25128 The same is true of any
25129 <A HREF="h_config_permlocked">&quot;<!--#echo var="VAR_stay-open-folders"-->&quot;</A>
25130 you have defined.
25131 This option controls Alpine's behavior when connecting to remote IMAP folders
25132 other than your INBOX or your <!--#echo var="VAR_stay-open-folders"-->.
25133 It specifies the maximum number of remote IMAP connections (other than
25134 those mentioned above) that Alpine will use for accessing the rest of your
25135 folders.
25136 If you set this option to zero, you will turn off most remote connection
25137 re-use.
25138 It's difficult to understand exactly what this option does, and it is usually
25139 fine to leave it set to its default value.
25140 It is probably more likely that you will be interested in setting the
25141 <A HREF="h_config_permlocked">&quot;<!--#echo var="VAR_stay-open-folders"-->&quot;</A> option
25142 instead of changing the value of this option.
25143 A slightly longer explanation of what is going on with this option
25144 is given in the next paragraphs.
25145
25146 <P>
25147 There are some time costs involved in opening and closing remote IMAP
25148 folders, the main costs being the time you have to wait for the connection
25149 to the server and the time for the folder to open.
25150 Opening a folder may involve not only the time the server takes to do its
25151 processing but time that Alpine uses to do filtering.
25152 These times can vary widely.
25153 They depend on how loaded the server is, how large
25154 the folder being opened is, and how you set up filtering, among other things.
25155 Once Alpine has opened a connection to a particular folder, it will attempt
25156 to keep that connection open in case you use it again.
25157 In order to do this,
25158 Alpine will attempt to use the <!--#echo var="VAR_max-remote-connections"--> (the value of
25159 this option) IMAP connections you have alloted for this purpose.
25160 <P>
25161 For example, suppose the value of this option is set to &quot;2&quot;.
25162 If your INBOX is accessed on a remote server using the IMAP protocol, that
25163 doesn't count as one of the remote connections but it is always kept open.
25164 If you then open another IMAP folder, that would be your first
25165 remote connection counted as one of the <!--#echo var="VAR_max-remote-connections"--> connections.
25166 If you open a third folder the second will be left open, in case you
25167 return to it.
25168 You won't be able to tell it has been left open.
25169 It will appear to be closed when you leave the folder but the connection
25170 will remain in the background.
25171 Now suppose you go back to the second folder (the first folder after the
25172 INBOX).
25173 A connection to that folder is still open so you won't have to wait
25174 for the startup time to open it.
25175 Meanwhile, the connection to the third folder will be left behind.
25176 Now, if you open a fourth folder, you will bump into the
25177 <!--#echo var="VAR_max-remote-connections"--> limit, because this will be the third folder other
25178 than INBOX and you have the option set to &quot;2&quot;.
25179 The connection that is being used for
25180 the third folder will be re-used for this new fourth folder.
25181 If you go back to the third folder after this, it is no longer already
25182 connected when you get there.
25183 You'll still save some time since Alpine will re-use the connection to the
25184 fourth folder and you have already logged in on that connection,
25185 but the folder will have to be re-opened from scratch.
25186 <P>
25187 If a folder is large and the startup cost is dominated by the time it takes
25188 to open that folder or to run filters on it, then it will pay to make the
25189 value of this option large enough to keep it open.
25190 On the other hand, if you only revisit a handful of folders or if
25191 the folders are small, then it might
25192 make more sense to keep this number small so that the reconnect
25193 time (the time to start up a new connection and authenticate)
25194 is eliminated instead.
25195 <P>
25196 You may also need to consider the impact on the server.
25197 On the surface, a larger number here may cause a larger impact on the
25198 server, since you will have more connections open to the server.
25199 On the other hand, not only will <EM>you</EM> be avoiding the startup costs
25200 associated with reopening a folder, but the <EM>server</EM> will be
25201 avoiding those costs as well.
25202 <P>
25203 When twenty five minutes pass without any active use of an IMAP connection
25204 being saved for possible re-use, that connection will be shut down,
25205
25206 <P>
25207 <UL>
25208 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25209 </UL><P>
25210 &lt;End of help on this topic&gt;
25211 </BODY>
25212 </HTML>
25213 ====== h_config_permlocked =====
25214 <HTML>
25215 <HEAD>
25216 <TITLE>OPTION: <!--#echo var="VAR_stay-open-folders"--></TITLE>
25217 </HEAD>
25218 <BODY>
25219 <H1>OPTION: <!--#echo var="VAR_stay-open-folders"--></H1>
25220
25221 This option affects low-level behavior of Alpine.
25222 There is no default value for this option.
25223 It is related to the options
25224 <A HREF="h_config_preopen_stayopens">&quot;<!--#echo var="FEAT_preopen-stayopen-folders"-->&quot;</A>,
25225 <A HREF="h_config_maxremstream">&quot;<!--#echo var="VAR_max-remote-connections"-->&quot;</A>,
25226 and <A HREF="h_config_expunge_stayopens">&quot;<!--#echo var="FEAT_offer-expunge-of-stayopen-folders"-->&quot;</A>.
25227
25228 <P>
25229 Note: changes made to this list take effect the next time you open a
25230 folder in the list.
25231
25232 <P>
25233 This is a list of folders that will be permanently kept open once they
25234 are first opened.
25235 The names in this list may be either the nickname of an Incoming folder
25236 or the full technical specification of a folder.
25237 The folders in this list need not be remote IMAP folders, they could usefully
25238 be local folders, as well.
25239 If a folder in the list is a newsgroup or is not accessed either locally
25240 or via IMAP, then the entry will be ignored.
25241 For example, folders accessed via NNTP or POP3 will not be kept open, since
25242 the way that new mail is found with those protocols involves closing and
25243 reopening the connection.
25244 <P>
25245 Once a Stay Open folder has been opened, new-mail checking will continue
25246 to happen on that folder for the rest of the Alpine session.
25247 Your INBOX is always implicitly included in this Stay-Open list and doesn't
25248 need to be added explicitly.
25249 <P>
25250 Another difference that you may notice between a Stay Open folder and a
25251 non-Stay Open folder is which message is selected as the current message
25252 when you enter the folder index.
25253 Normally, the starting position for an incoming folder (which most Stay Open
25254 folders will likely be) is controlled by the
25255 <A HREF="h_config_inc_startup"><!--#echo var="VAR_incoming-startup-rule"--></A>.
25256 However, if a folder is a Stay Open folder, when you re-enter the folder
25257 after the first time the current message will be the same as it was when
25258 you left the folder.
25259 An exception is made if you use the TAB command to get to the folder.
25260 In that case, the message number will be incremented by one from what it
25261 was when you left the folder.
25262 <P>
25263 The above special behavior is thought to be useful.
25264 However, it is special and different from what you might at first expect.
25265 The feature
25266 <A HREF="h_config_use_reg_start_for_stayopen"><!--#echo var="FEAT_use-regular-startup-rule-for-stayopen-folders"--></A>
25267 may be used to turn off this special treatment.
25268 <P>
25269 If the message that was current when you left the folder no longer exists,
25270 then the regular startup rule will be used instead.
25271
25272 <P>
25273 <UL>
25274 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25275 </UL><P>
25276 &lt;End of help on this topic&gt;
25277 </BODY>
25278 </HTML>
25279 ====== h_config_viewer_overlap =====
25280 <html>
25281 <header>
25282 <title>OPTION: <!--#echo var="VAR_viewer-overlap"--></title>
25283 </header>
25284 <body>
25285 <h1>OPTION: <!--#echo var="VAR_viewer-overlap"--></h1>
25286
25287 This option specifies an aspect of Alpine's Message Viewing screen.  When
25288 the space bar is used to page forward in a message, the number of lines
25289 specified by the &quot;<!--#echo var="VAR_viewer-overlap"-->&quot; variable will be repeated from the
25290 bottom of the screen.  That is, if this was set to two lines, then the
25291 bottom two lines of the screen would be repeated on the top of the next
25292 screen.  The normal default value is "2".<p>
25293 <UL>
25294 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25295 </UL><P>
25296 &lt;End of help on this topic&gt;
25297 </body>
25298 </html>
25299 ====== h_config_scroll_margin =====
25300 <HTML>
25301 <HEAD>
25302 <TITLE>OPTION: <!--#echo var="VAR_scroll-margin"--></TITLE>
25303 </HEAD>
25304 <BODY>
25305 <H1>OPTION: <!--#echo var="VAR_scroll-margin"--></H1>
25306
25307 This option controls when Alpine's line-by-line scrolling occurs.
25308 Typically, when a selected item is at the top or bottom screen edge
25309 and the UP or DOWN (and Ctrl-P or Ctrl-N) keys are struck, the
25310 displayed items are scrolled down or up by a single line.
25311
25312 <P>
25313 This option allows you to tell Alpine the number of lines from the top and
25314 bottom screen edge that line-by-line paging should occcur.  For example,
25315 setting this value to one (1) will cause Alpine to scroll the display
25316 vertically when you move to select an item on the display's top or
25317 bottom edge.
25318
25319 <P>
25320 By default, this variable is zero, indicating that scrolling happens
25321 when you move up or down to select an item immediately off the display's
25322 top or bottom edge.
25323
25324 <P>
25325 <UL>
25326 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25327 </UL><P>
25328 &lt;End of help on this topic&gt;
25329 </BODY>
25330 </HTML>
25331 ====== h_config_wordseps =====
25332 <HTML>
25333 <HEAD>
25334 <TITLE>OPTION: <!--#echo var="VAR_composer-word-separators"--></TITLE>
25335 </HEAD>
25336 <BODY>
25337 <H1>OPTION: <!--#echo var="VAR_composer-word-separators"--></H1>
25338
25339 This option affects how a &quot;word&quot; is defined in the composer.
25340 The definition of a word is used when using the Forward Word and Backward
25341 Word commands in the composer, as well as when using the spell checker.
25342 Whitespace is always considered a word separator.
25343 Punctuation (like question marks, periods, commas, and so on) is always
25344 a word separator if it comes at the end of a word.
25345 By default, a punctuation character that is in the middle of a word does
25346 not break up that word as long as the character before and the character
25347 after it are both alphanumeric.
25348 If you add a character to this option it will be considered a
25349 word separator even when it occurs in the middle of an alphanumeric word.
25350 For example, if you want to skip through each part of an address instead
25351 of skipping the whole address at once you might want to include &quot;@&quot;
25352 and &quot;.&quot; in this list.
25353 If you want the word-skipper to stop on each part of a UNIX filename you
25354 could add &quot;/&quot; to the list.
25355 The equal sign and dash are other possibilities you might find helpful.
25356 <P>
25357 <UL>
25358 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25359 </UL><P>
25360 &lt;End of help on this topic&gt;
25361 </BODY>
25362 </HTML>
25363 ====== h_config_reply_indent_string =====
25364 <HTML>
25365 <HEAD>
25366 <TITLE>OPTION: <!--#echo var="VAR_reply-indent-string"--></TITLE>
25367 </HEAD>
25368 <BODY>
25369 <H1>OPTION: <!--#echo var="VAR_reply-indent-string"--></H1>
25370
25371 This option specifies an aspect of Alpine's Reply command.
25372 When a message is replied to and the text of the message is included, the
25373 included text usually has the string &quot;&gt;&nbsp;&quot; prepended
25374 to each line indicating it is quoted text.
25375 (In case you haven't seen this before, &quot;string&quot; is a technical term
25376 that means chunk of text.)
25377
25378 <P>
25379 Because of the introduction of <A HREF="h_config_quell_flowed_text">Flowed Text</A>
25380 in 1999 and its wide-spread adoption since then, you will usually be better off if you
25381 use one of the standard values,
25382 &quot;&gt;&nbsp;&quot; or &quot;&gt;&quot;, for this option.
25383
25384 <P>
25385 This option specifies a different value for that string.
25386 If you wish to use a string that begins or ends with a space,
25387 enclose the string in double quotes.
25388
25389 <P>
25390 Besides simple text, the prepended string can be based
25391 on the message being replied to.
25392 The following tokens are substituted for the message's corresponding value:
25393
25394 <DL>
25395 <DT>_FROM_</DT>
25396 <DD>This token gets replaced with the message sender's &quot;username&quot;.
25397 If the name is longer than six characters, only the first six characters are
25398 used.
25399 </DD>
25400
25401 <DT>_NICK_</DT>
25402 <DD>This token gets replaced with the nickname of the message sender's
25403 address as found in your addressbook.
25404 If no addressbook entry is found,
25405 Alpine replaces the characters &quot;_NICK_&quot; with nothing.
25406 If the nickname is longer than six characters, only the first six characters are
25407 used.
25408 </DD>
25409
25410 <DT>_INIT_</DT>
25411 <DD>This token gets replaced with the initials of the sender of the message.
25412 </DD>
25413
25414 </DL>
25415
25416 NOTE: When the
25417 <A HREF="h_config_prefix_editing">&quot;<!--#echo var="FEAT_enable-reply-indent-string-editing"-->&quot;</A>
25418 feature is enabled, you are given the opportunity to edit the string, whether
25419 it is the default or one automatically generated using the above tokens.
25420 <P>
25421 If you change your <!--#echo var="VAR_reply-indent-string"-->
25422 so that it is not equal to the default value of &quot;&gt;&nbsp;&quot;, then
25423 quoted text will not be flowed
25424 (<A HREF="h_config_quell_flowed_text">Flowed Text</A>)
25425 when you reply.
25426 For this reason, we recommend that you leave your <!--#echo var="VAR_reply-indent-string"-->
25427 set to the default value.
25428 <P>
25429 <UL>
25430 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25431 </UL><P>
25432 &lt;End of help on this topic&gt;
25433 </BODY>
25434 </HTML>
25435 ====== h_config_quote_replace_string =====
25436 <HTML>
25437 <HEAD>
25438 <TITLE>OPTION: <!--#echo var="VAR_quote-replace-string"--></TITLE>
25439 </HEAD>
25440 <BODY>
25441 <H1>OPTION: <!--#echo var="VAR_quote-replace-string"--></H1>
25442
25443 This option specifies what string to use as a quote when <b>viewing</b> a
25444 message.  The standard way of quoting messages when replying is the string
25445 &quot;&gt;&nbsp;&quot; (quote space).
25446 With this variable set, viewing a message will
25447 replace occurrences of
25448 &quot;&gt;&nbsp;&quot; and &quot;&gt;&quot; with the replacement string.
25449 This setting works best when
25450 <A HREF="h_config_reply_indent_string"><!--#echo var="VAR_reply-indent-string"--></A>
25451 or the equivalent setting in your correspondents' mail programs
25452 is set to the default
25453 &quot;&gt;&nbsp;&quot;, but it will also work fine with the
25454 <!--#echo var="VAR_reply-indent-string"--> set to &quot;&gt;&quot;.
25455 <P>
25456 By default, this setting will only work on messages that are flowed, which is
25457 the default way of sending messages for many mail clients including
25458 Alpine.  Enable the feature
25459 <A HREF="h_config_quote_replace_noflow"><!--#echo var="FEAT_quote-replace-nonflowed"--></A>
25460 to also have quote-replacement performed on non-flowed messages.
25461 <P>
25462
25463 Setting this option will replace  &quot;&gt;&quot; and
25464 &quot;&gt;&nbsp;&quot; with the new setting. This string may include trailing
25465 spaces. To preserve those spaces enclose the full string in double quotes.
25466 <P>
25467 No padding to separate the text of the message from the quote string is
25468 added. This means that if you do not add trailing spaces to the value of
25469 this variable, text will be displayed right next to the quote string,
25470 which may be undesirable. This can be avoided by adding a new string
25471 separated by a space from your selection of quote string replacement. This
25472 last string will be used for padding. For example, setting this variable to
25473 <br>&quot;&gt;&quot; &quot; &quot; has the effect of setting
25474 &quot;&gt;&quot; as the <!--#echo var="VAR_quote-replace-string"-->, with the text padded by
25475 a space from the last quote string to make it more readable.
25476 <P>
25477 One possible setting for this variable could be
25478 &quot;&nbsp;&nbsp;&nbsp;&nbsp;&quot; (four spaces wrapped in quotes), which
25479 would have the effect of indenting each level of quoting four spaces and
25480 removing the &quot;&gt;&quot;'s.  Different levels of quoting could be made
25481 more discernible by setting colors for quoted text.
25482 <P>
25483 Replying to or forwarding the viewed message will preserve the original
25484 formatting of the message, so quote-replacement will not be performed on
25485 messages that are being composed.
25486 <P>
25487 <UL>
25488 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25489 </UL><P>
25490 &lt;End of help on this topic&gt;
25491 </BODY>
25492 </HTML>
25493 ====== h_config_empty_hdr_msg =====
25494 <HTML>
25495 <HEAD>
25496 <TITLE>OPTION: <!--#echo var="VAR_empty-header-message"--></TITLE>
25497 </HEAD>
25498 <BODY>
25499 <H1>OPTION: <!--#echo var="VAR_empty-header-message"--></H1>
25500
25501 When sending, if both the To and Cc fields are empty and you
25502 are sending the message to a Bcc,
25503 Alpine will put a special address in the To line.  The default value is:
25504
25505 <P>
25506 <CENTER><SAMP>undisclosed-recipients:&nbsp;;</SAMP></CENTER>
25507
25508 <P>
25509 The reason for this is to avoid embarrassment caused by some Internet
25510 mail transfer software that interprets a &quot;missing&quot;
25511 <SAMP>To:</SAMP> header as an error and replaces it with an
25512 <SAMP>Apparently-to:</SAMP> header that may contain the addresses you
25513 entered on the <SAMP>Bcc:</SAMP> line, defeating the purpose of the
25514 Bcc.  You may change the part of this message that comes before the
25515 &quot;:&nbsp;;&quot; by setting the &quot;<!--#echo var="VAR_empty-header-message"-->&quot;
25516 variable to something else.
25517
25518 <P>
25519 The normal default is &quot;undisclosed-recipients&quot;.
25520
25521 <P>
25522 <UL>
25523 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25524 </UL><P>
25525 &lt;End of help on this topic&gt;
25526 </BODY>
25527 </HTML>
25528 ====== h_config_status_msg_delay =====
25529 <HTML>
25530 <HEAD>
25531 <TITLE>OPTION: <!--#echo var="VAR_status-message-delay"--></TITLE>
25532 </HEAD>
25533 <BODY>
25534 <H1>OPTION: <!--#echo var="VAR_status-message-delay"--></H1>
25535
25536 This option has evolved over time, causing the possible values to be
25537 counter-intuitive.
25538 Read carefully before you set this option.
25539 First we explain what the option does, then there is a longer discussion
25540 following that.
25541 <P>
25542 If this is set to zero, the default value, it has <EM>no</EM> effect.
25543 Positive and negative values serve two similar, but different purposes.
25544 <P>
25545 If it is set to a positive number, it causes the cursor to move to the
25546 status line whenever a status message is printed and pause there for this
25547 many seconds.
25548 It will probably only be useful if the
25549 <A HREF="h_config_show_cursor">&quot;<!--#echo var="FEAT_show-cursor"-->&quot;</A> feature is
25550 also turned on.
25551 Setting this option to a positive number can only be used to
25552 <EM>increase</EM> the status message delay.
25553 This may be useful for Braille displays, or other non-traditional displays.
25554 <P>
25555 If it is set to a negative number the interpretation is a bit complicated.
25556 Negative numbers are used to <EM>decrease</EM> the amount of delay Alpine uses to
25557 allow you to read important status messages.
25558 Of course, this may cause you to miss some important messages.
25559 If you see a message flash by but miss what it says you can use the
25560 Journal command from the MAIN MENU to read it.
25561 If you set this option to a negative value, the delay will be
25562 no more than one second less than the absolute value
25563 of the value you set.
25564 So if you set it to -1, the delay will be no more than zero seconds, no
25565 delay at all.
25566 If you set it to -2, the delay will be no more than 1 second.
25567 And so on, -3 is 2 seconds, -4 is 3 seconds, ...
25568 If the delay that Alpine would have used by default is less than this delay,
25569 then the smaller delay set by Alpine will be used.
25570 Setting this option to a negative value can only reduce the amount of
25571 delay, never increase it.
25572 <P>
25573 Here is a more detailed explanation.
25574 Status messages are the messages that show up spontaneously in the
25575 status message line, usually the third line from the bottom of the screen.
25576 By default, Alpine assigns each status message it produces a minimum
25577 display time.
25578 Some status messages have a minimum display time of zero.
25579 You can see an example of such a message by paging up in this help text
25580 until you reach the top of the screen.
25581 If you try to page past the top you will see the message
25582 <P>
25583 <CENTER><SAMP>[Already at start of help text]</SAMP></CENTER>
25584 <P>
25585 in the status line.
25586 If there is another more important use of the status message line this message
25587 might be replaced quickly, or it even might not be shown at all.
25588 However, if there is no reason to get rid of the message, it might stay
25589 there for several seconds while you read the help.
25590 An example where it is replaced immediately happens when you page up in
25591 the help text past the top of the screen, but then type the &quot;WhereIs&quot;
25592 command right after paging up.
25593 The message will disappear immediately without causing a delay (unless you
25594 have set this option to a positive value) to allow you to type input for
25595 the &quot;WhereIs&quot; command.
25596 Since it isn't a very important message, Alpine has set its minimum display
25597 time to zero seconds.
25598 <P>
25599 Other messages have minimum display times of three or more seconds.
25600 These are usually error messages that Alpine thinks you ought to see.
25601 For example, it might be a message about a failed Save or a failed folder open.
25602 It is often the case that this minimum display time won't delay you in
25603 any way because the status message line is not needed for another reason.
25604 However, there are times when Alpine has to delay what it is doing in
25605 order to display a status message for the minimum display time.
25606 This happens when a message is being displayed and Alpine wants to ask
25607 for input from the keyboard.
25608 For example, when you Save a message you use the status message line.
25609 You get a prompt there asking for the name of the folder to save to.
25610 If there is a status message being displayed that has not
25611 yet displayed for its minimum
25612 time Alpine will display that status message surrounded with the characters
25613 &gt; and &lt; to show you that it is delaying.
25614 That might happen, for example, if you tried to save to a folder that
25615 caused an error, then followed that immediately with another Save command.
25616 You might find yourself waiting for a status message like
25617 <P>
25618 <CENTER><SAMP>[&gt;Can't get write access to mailbox, access is readonly&lt;]</SAMP></CENTER>
25619 <P>
25620 to finish displaying for three seconds.
25621 If that is something you find happening to you frequently, you may use
25622 negative values of this option to decrease or eliminate that delay, at
25623 the risk of missing the message.
25624 <P>
25625 <UL>
25626 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25627 </UL><P>
25628 &lt;End of help on this topic&gt;
25629 </BODY>
25630 </HTML>
25631 ====== h_config_active_msg_interval =====
25632 <HTML>
25633 <HEAD>
25634 <TITLE>OPTION: <!--#echo var="VAR_busy-cue-rate"--></TITLE>
25635 </HEAD>
25636 <BODY>
25637 <H1>OPTION: <!--#echo var="VAR_busy-cue-rate"--></H1>
25638
25639 When Alpine is delayed for some reason it usually shows that
25640 something is happening with a small animated display in the status
25641 message line near the bottom of the screen.
25642 This option sets how frequently the characters (for example, a spinning bar)
25643 in the active status message lines are updated.
25644 At most, it can be set to be udpated 20 times per second.
25645
25646 <P>
25647 Setting this value to zero will prevent display of the animations
25648 altogether.
25649
25650 <P>
25651 The option <A HREF="h_config_use_boring_spinner"><!--#echo var="FEAT_busy-cue-spinner-only"--></A>
25652 can be used to remove the randomness from this animated display.
25653
25654 <P>
25655 <UL>
25656 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25657 </UL><P>
25658 &lt;End of help on this topic&gt;
25659 </BODY>
25660 </HTML>
25661 ====== h_config_mailchecknoncurr =====
25662 <HTML>
25663 <HEADER>
25664 <TITLE>OPTION: <!--#echo var="VAR_mail-check-interval-noncurrent"--></TITLE>
25665 </HEADER>
25666 <BODY>
25667 <H1>OPTION: <!--#echo var="VAR_mail-check-interval-noncurrent"--></H1>
25668
25669 This option is closely related to the
25670 <A HREF="h_config_mailcheck">&quot;<!--#echo var="VAR_mail-check-interval"-->&quot;</A>
25671 option, as well as the
25672 <A HREF="h_config_quell_checks_comp">&quot;<!--#echo var="FEAT_quell-mailchecks-composing-except-inbox"-->&quot;</A> and
25673 <A HREF="h_config_quell_checks_comp_inbox">&quot;<!--#echo var="FEAT_quell-mailchecks-composing-inbox"-->&quot;</A> options.
25674 If the &quot;<!--#echo var="VAR_mail-check-interval"-->&quot; option is set to zero, then automatic
25675 new-mail checking is disabled and this option will have no effect.
25676 <P>
25677 Normally this option is set to zero, which means that the value used will be
25678 the same as the value for the &quot;<!--#echo var="VAR_mail-check-interval"-->&quot;.
25679 If you set this option to a value different from zero
25680 (usually larger than the value for &quot;<!--#echo var="VAR_mail-check-interval"-->&quot;)
25681 then that is the check interval that will be used
25682 for folders that are not the currently open folder or the INBOX.
25683 You may not even have any folders that are noncurrent and not the INBOX.
25684 If you do, it is likely that they are due to
25685 <A HREF="h_config_permlocked">&quot;<!--#echo var="VAR_stay-open-folders"-->&quot;</A>
25686 you have configured.
25687 This option also affects the rate of mail checking done on cached
25688 connections to folders you previously had open but are no longer actively
25689 using.
25690 You aren't expected to understand that last sentence, but if you are interested
25691 take a look at
25692 <A HREF="h_config_maxremstream">&quot;<!--#echo var="VAR_max-remote-connections"-->&quot;</A>
25693 and the related options.
25694 <P>
25695 <UL>
25696 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25697 </UL><P>
25698 &lt;End of help on this topic&gt;
25699 </BODY>
25700 </HTML>
25701 ====== h_config_fifopath =====
25702 <HTML>
25703 <HEADER>
25704 <TITLE>OPTION: NewMail FIFO Path</TITLE>
25705 </HEADER>
25706 <BODY>
25707 <H1>OPTION: NewMail FIFO Path</H1>
25708
25709 This option is only available in UNIX Alpine.
25710 However, there is a very similar feature built in to PC-Alpine.
25711 In PC-Alpine's Config menu at the top of the screen
25712 is an option called &quot;New Mail Window&quot;.
25713 <P>
25714 You may have Alpine create a FIFO special file (also called a named pipe) where
25715 it will send a one-line message each time a new message is received in
25716 the current folder, the INBOX, or any open
25717 <A HREF="h_config_permlocked"><!--#echo var="VAR_stay-open-folders"--></A>.
25718 To protect against two different Alpines both writing to the same FIFO, Alpine
25719 will only create the FIFO and write to it if it doesn't already exist.
25720 <P>
25721 A possible way to use this option would be to have a separate window
25722 on your screen running the command
25723 <P>
25724 <CENTER><SAMP>cat filename</SAMP></CENTER>
25725 <P>
25726 where &quot;filename&quot; is the name of the file given for this option.
25727 Because the file won't exist until after you start Alpine, you must <EM>first</EM>
25728 start Alpine and <EM>then</EM> run the &quot;cat&quot; command.
25729 You may be tempted to use &quot;tail -f filename&quot; to view the new
25730 mail log.
25731 However, the common implementations of the tail command will not do what you
25732 are hoping.
25733 <P>
25734 The width of the messages produced for the FIFO may be altered with the
25735 <A HREF="h_config_newmailwidth"><!--#echo var="VAR_newmail-window-width"--></A> option.
25736 <P>
25737 On some systems, fifos may only be created in a local filesystem.
25738 In other words, they may not be in NFS filesystems.
25739 This requirement is not universal.
25740 If the system you are using supports it, it should work.
25741 (It is often the case that your home directory is in an NFS filesystem.
25742 If that is the case, you might try using a file in the &quot;/tmp&quot;
25743 filesystem, which is usually a local filesytem.)
25744 Even when it is possible to use an NFS-mounted filesystem as a place to name
25745 the fifo (for example, your home directory), it will still be the case that
25746 the reader (probably the &quot;cat&quot; command) and the
25747 writer (Alpine) of the fifo must be running on the same system.
25748 <P>
25749 <UL>
25750 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25751 </UL><P>
25752 &lt;End of help on this topic&gt;
25753 </BODY>
25754 </HTML>
25755 ====== h_config_newmailwidth =====
25756 <HTML>
25757 <HEADER>
25758 <TITLE>OPTION: <!--#echo var="VAR_newmail-window-width"--></TITLE>
25759 </HEADER>
25760 <BODY>
25761 <H1>OPTION: <!--#echo var="VAR_newmail-window-width"--></H1>
25762
25763 For UNIX Alpine, this option is only useful if you have turned on the
25764 <A HREF="h_config_fifopath">NewMail FIFO Path</A> option.
25765 That option causes new mail messages to be sent to a fifo file.
25766 Those messages will be 80 characters wide by default.
25767 You can change the width of those messages by changing this option.
25768 For example, if you are reading those messages in another window you might
25769 want to set this width to the width of that other window.
25770 <P>
25771 If you are using PC-Alpine, it has an option in the Config menu to turn
25772 on the &quot;New Mail Window&quot;.
25773 This present option also controls the width of that window.
25774 <P>
25775 <UL>
25776 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25777 </UL><P>
25778 &lt;End of help on this topic&gt;
25779 </BODY>
25780 </HTML>
25781 ====== h_config_mailcheck =====
25782 <HTML>
25783 <HEADER>
25784 <TITLE>OPTION: <!--#echo var="VAR_mail-check-interval"--></TITLE>
25785 </HEADER>
25786 <BODY>
25787 <H1>OPTION: <!--#echo var="VAR_mail-check-interval"--></H1>
25788
25789 This option specifies, in seconds,
25790 how often Alpine will check for new mail.
25791 If set to zero, new-mail checking is disabled.
25792 (You can always manually force a new-mail check by typing ^L (Ctrl-L), which is also the command to refresh the screen, or by typing the Next command when the
25793 current message is the last message of the folder.)
25794 There is a minimum value for this option, normally 15 seconds.
25795 The default value is normally 150 seconds.
25796 The higher you set this option, the easier it is on the server.
25797 <P>
25798 There are some situations where automatic new-mail checking does not work.
25799 See the discussion about new-mail checking in
25800 <A HREF="h_config_reopen_rule">&quot;<!--#echo var="VAR_folder-reopen-rule"-->&quot;</A>.
25801 <P>
25802 The new-mail checking will not happen exactly at the frequency that you specify.
25803 For example, Alpine may elect to defer a non-INBOX mail check if you
25804 are busy typing.
25805 Or, it may check more frequently than you have specified if that is
25806 thought to be necessary to keep the server from closing the connection
25807 to the folder due to inactivity.
25808 If Alpine checks for new mail as a side effect of another command, it will reset
25809 the timer, so that new-mail checking may seem to happen irregularly instead of
25810 every X seconds like clockwork.
25811 <P>
25812 If you are anxious to know about new mail as soon as possible, set the check
25813 interval low, and you'll know about the new mail by approximately
25814 that amount of time after it arrives.
25815 If you aren't so worried about knowing right away, set this option to a
25816 higher value.
25817 That will save the server some processing time and may save you some of
25818 the time you spend waiting for new-mail checks to happen if you are
25819 dealing with a slow server or slow network connection.
25820 <P>
25821 If you suspect that new-mail checking is causing slow downs for you,
25822 you may want to look into the options
25823 <A HREF="h_config_quell_checks_comp">&quot;<!--#echo var="FEAT_quell-mailchecks-composing-except-inbox"-->&quot;</A>,
25824 <A HREF="h_config_quell_checks_comp_inbox">&quot;<!--#echo var="FEAT_quell-mailchecks-composing-inbox"-->&quot;</A> and
25825 <A HREF="h_config_mailchecknoncurr">&quot;<!--#echo var="VAR_mail-check-interval-noncurrent"-->&quot;</A>,
25826 which refine when mail checking is done.
25827 <P>
25828 If the mailbox being checked uses a <A HREF="h_maildrop">Mail Drop</A> then
25829 there is a minimum time
25830 (<A HREF="h_config_maildropcheck">&quot;<!--#echo var="VAR_maildrop-check-minimum"-->&quot;</A>)
25831 between new-mail checks.
25832 Because of this minimum you may notice that new mail does not
25833 appear promptly when you expect it.
25834 The reason for this is to protect the server from over-zealous opening and
25835 closing of the Mail Drop folder, since that is a costly operation.
25836 <P>
25837 <UL>
25838 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25839 </UL><P>
25840 &lt;End of help on this topic&gt;
25841 </BODY>
25842 </HTML>
25843 ====== h_config_quell_checks_comp =====
25844 <HTML>
25845 <HEAD>
25846 <TITLE>FEATURE: <!--#echo var="FEAT_quell-mailchecks-composing-except-inbox"--></TITLE>
25847 </HEAD>
25848 <BODY>
25849 <H1>FEATURE: <!--#echo var="FEAT_quell-mailchecks-composing-except-inbox"--></H1>
25850
25851 This option is closely related to the
25852 <A HREF="h_config_mailcheck">&quot;<!--#echo var="VAR_mail-check-interval"-->&quot;</A>
25853 option, the
25854 <A HREF="h_config_mailchecknoncurr">&quot;<!--#echo var="VAR_mail-check-interval-noncurrent"-->&quot;</A> option, and
25855 <A HREF="h_config_quell_checks_comp_inbox">&quot;<!--#echo var="FEAT_quell-mailchecks-composing-inbox"-->&quot;</A>.
25856 <P>
25857 If this option is set, then the normal new-mail checking that happens
25858 while you are composing will not happen for folders other than your
25859 INBOX (which depends on the setting
25860 of &quot;<!--#echo var="FEAT_quell-mailchecks-composing-inbox"-->&quot;).
25861 <P>
25862 You might want to set this option if you are experiencing delays while
25863 composing that you think might be related to the speed of the new-mail
25864 checks.
25865 <P>
25866 Even with this option turned on, an occasional new-mail check may be done
25867 in order to keep the server from killing the connection to the folder.
25868 For example, IMAP servers may remove a connection to a folder if there
25869 has been no activity on the connection for 30 minutes or more.
25870 Instead of letting that happen, Alpine will check for new mail before the
25871 30 minutes is up even though you have turned on this feature to quell
25872 those checks.
25873 <P>
25874 Besides new-mail checks, checkpoint operations on the folders
25875 will also be quelled when you set this option.
25876 The purpose of checkpointing is to write the changes to a folder out to
25877 disk periodically in order to avoid losing those changes when system or
25878 software problems occur.
25879 New-mail checking and checkpointing while you are not composing are not
25880 affected by this option.
25881
25882 <P>
25883 &lt;End of help on this topic&gt;
25884 </BODY>
25885 </HTML>
25886 ====== h_config_quell_checks_comp_inbox =====
25887 <HTML>
25888 <HEAD>
25889 <TITLE>FEATURE: <!--#echo var="FEAT_quell-mailchecks-composing-inbox"--></TITLE>
25890 </HEAD>
25891 <BODY>
25892 <H1>FEATURE: <!--#echo var="FEAT_quell-mailchecks-composing-inbox"--></H1>
25893
25894 This option is closely related to the
25895 <A HREF="h_config_mailcheck">&quot;<!--#echo var="VAR_mail-check-interval"-->&quot;</A>
25896 option, the
25897 <A HREF="h_config_mailchecknoncurr">&quot;<!--#echo var="VAR_mail-check-interval-noncurrent"-->&quot;</A> option, and
25898 <A HREF="h_config_quell_checks_comp">&quot;<!--#echo var="FEAT_quell-mailchecks-composing-except-inbox"-->&quot;</A>.
25899 <P>
25900 If this option is set, then the normal new-mail checking that happens
25901 while you are composing will not happen for your INBOX.
25902 Checking of other folders is controlled in a similar way with the
25903 &quot;<!--#echo var="FEAT_quell-mailchecks-composing-except-inbox"-->&quot; option.
25904 <P>
25905 You might want to set this option if you are experiencing delays while
25906 composing that you think might be related to the speed of the new-mail
25907 checks.
25908 <P>
25909 Even with this option turned on, an occasional new-mail check may be done
25910 in order to keep the server from killing the connection to the folder.
25911 For example, IMAP servers may remove a connection to a folder if there
25912 has been no activity on the connection for 30 minutes or more.
25913 Instead of letting that happen, Alpine will check for new mail before the
25914 30 minutes is up even though you have turned on this feature to quell
25915 those checks.
25916 <P>
25917 Besides new-mail checks, checkpoint operations on the INBOX
25918 will also be quelled when you set this option.
25919 The purpose of checkpointing is to write the changes to a folder out to
25920 disk periodically in order to avoid losing those changes when system or
25921 software problems occur.
25922 New-mail checking and checkpointing while you are not composing are not
25923 affected by this option.
25924 <P>
25925 &lt;End of help on this topic&gt;
25926 </BODY>
25927 </HTML>
25928 ====== h_config_maildropcheck =====
25929 <HTML>
25930 <HEADER>
25931 <TITLE>OPTION: <!--#echo var="VAR_maildrop-check-minimum"--></TITLE>
25932 </HEADER>
25933 <BODY>
25934 <H1>OPTION: <!--#echo var="VAR_maildrop-check-minimum"--></H1>
25935
25936 New-mail checking for a
25937 <A HREF="h_maildrop">Mail Drop</A> is a little different from new
25938 mail checking for a regular folder.
25939 One of the differences is that the connection to the Mail Drop is not
25940 kept open and so the cost of checking
25941 (delay for you and additional load for the server) may be significant.
25942 Because of this additional cost we set a minimum time that
25943 must pass between checks.
25944 This minimum only applies to the automatic checking done by Alpine.
25945 If you force a check by typing ^L (Ctrl-L) or by typing the Next command when you are
25946 at the end of a folder index, then the check is done right away.
25947 <P>
25948 This option specifies, in seconds, the <EM>minimum</EM> time between Mail Drop
25949 new-mail checks.
25950 You may want to set this minimum high in order to avoid experiencing some
25951 of the delays associated with the checks.
25952 Note that the time between checks is still controlled by the regular
25953 <A HREF="h_config_mailcheck"><!--#echo var="VAR_mail-check-interval"--></A> option.
25954 When Alpine is about to do an automatic check for new mail (because
25955 the <!--#echo var="VAR_mail-check-interval"--> has expired) then if the time since the last
25956 new-mail check
25957 of any open Mail Drops has been greater than the <!--#echo var="VAR_maildrop-check-minimum"-->,
25958 the Mail Drop is checked for new mail as well.
25959 Therefore, it is only useful to set this option to a value that is higher
25960 than the <!--#echo var="VAR_mail-check-interval"-->.
25961 <P>
25962 If this option is set to zero, automatic Mail Drop new-mail
25963 checking is disabled.
25964 There is a minimum value, normally 60 seconds.
25965 The default value is normally 60 seconds as well.
25966 This applies to the INBOX and to the currently open folder if that is
25967 different from the INBOX.
25968
25969 <P>
25970 <UL>
25971 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25972 </UL><P>
25973 &lt;End of help on this topic&gt;
25974 </BODY>
25975 </HTML>
25976 ====== h_config_nntprange =====
25977 <HTML>
25978 <HEADER>
25979 <TITLE>OPTION: <!--#echo var="VAR_nntp-range"--></TITLE>
25980 </HEADER>
25981 <BODY>
25982 <H1>OPTION: <!--#echo var="VAR_nntp-range"--></H1>
25983
25984 This option applies only to newsgroups accessed using the NNTP protocol.
25985 It does not, for example,
25986 apply to newsgroups accessed using an IMAP-to-NNTP proxy.
25987
25988 <P>
25989 When you open a connection to a News server using the NNTP protocol, you
25990 normally have access to all of the articles in each newsgroup.
25991 If a server keeps a large backlog of messages it may speed performance
25992 some to restrict attention to only the newer messages in a group.
25993 This option allows you to set how many article numbers should be checked
25994 when opening a newsgroup.
25995 You can think of &quot;<!--#echo var="VAR_nntp-range"-->&quot; as specifying the maximum number
25996 of messages you ever want to see.
25997 For example, if you only ever wanted to look at the last 500 messages in each
25998 newsgroup you could set this option to 500.
25999 In actuality, it isn't quite that.
26000 Instead, for performance reasons, it specifies the range of article
26001 numbers to be checked, beginning
26002 with the highest numbered article and going backwards from there.
26003 If there are messages that have been canceled or deleted
26004 their article numbers are still counted as part of the range.
26005 <P>
26006 So, more precisely, setting the &quot;<!--#echo var="VAR_nntp-range"-->&quot; will cause article
26007 numbers
26008 <P><CENTER>last_article_number - <!--#echo var="VAR_nntp-range"--> + 1 through last_article_number</CENTER>
26009 <P>
26010 to be considered when reading a newsgroup.
26011 The number of messages that show up in your index will be less than or equal
26012 to the value of &quot;<!--#echo var="VAR_nntp-range"-->&quot;.
26013
26014 <P>
26015 The purpose of this option is simply to speed up access when reading news.
26016 The speedup comes because Alpine can ignore all but the last <!--#echo var="VAR_nntp-range"--> article
26017 numbers, and can avoid downloading any information about the ignored articles.
26018 There is a cost you pay for this speedup.
26019 That cost is that there is no way for you to see those ignored articles.
26020 The articles that come before the range you specify are invisible to you and
26021 to Alpine, as if they did not exist at all.
26022 There is no way to see those messages using, for example, an unexclude command
26023 or something similar.
26024 The only way to see those articles is to set this option high enough (or
26025 set it to zero) and then to reopen the newsgroup.
26026
26027 <P>
26028 If this option is set to 0 (which is also the default),
26029 then the range is unlimited.
26030 This option applies globally to all NNTP servers and to all newsgroups
26031 on those servers.
26032 There is no way to set different values for different newsgroups or servers.
26033
26034 <P>
26035 <UL>
26036 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26037 </UL><P>
26038 &lt;End of help on this topic&gt;
26039 </BODY>
26040 </HTML>
26041 ====== h_config_news_active =====
26042 <html>
26043 <header>
26044 <title>OPTION: <!--#echo var="VAR_news-active-file-path"--></title>
26045 </header>
26046 <body>
26047 <h1>OPTION: <!--#echo var="VAR_news-active-file-path"--></h1>
26048
26049 This option tells Alpine where to look for the "active file" for newsgroups
26050 when accessing news locally, rather than via NNTP.  The default path is
26051 usually "/usr/lib/news/active".<p>
26052 <UL>
26053 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26054 </UL><P>
26055 &lt;End of help on this topic&gt;
26056 </body>
26057 </html>
26058 ====== h_config_news_spool =====
26059 <html>
26060 <header>
26061 <title>OPTION: <!--#echo var="VAR_news-spool-directory"--></title>
26062 </header>
26063 <body>
26064 <h1>OPTION: <!--#echo var="VAR_news-spool-directory"--></h1>
26065
26066 This option tells Alpine where to look for the "news spool" for newsgroups
26067 when accessing news locally, rather than via NNTP.  The default path is
26068 usually "/var/spool/news".<p>
26069 <UL>
26070 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26071 </UL><P>
26072 &lt;End of help on this topic&gt;
26073 </body>
26074 </html>
26075 ====== h_config_image_viewer =====
26076 <html>
26077 <header>
26078 <title>OPTION: <!--#echo var="VAR_image-viewer"--></title>
26079 </header>
26080 <body>
26081 <h1>OPTION: <!--#echo var="VAR_image-viewer"--></h1>
26082 <body>
26083 This option specifies the program Alpine should call to view MIME
26084 attachments of type IMAGE (e.g. GIF or TIFF).  The Image Viewer setting is
26085 no longer needed, but remains for backward compatibility.  The more
26086 general method for associating external printing and viewing programs with
26087 specific MIME data types is to use the system's (or your personal)
26088 "mailcap" configuration file.<p>
26089 <UL>
26090 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26091 </UL><P>
26092 &lt;End of help on this topic&gt;
26093 </body>
26094 </html>
26095 ====== h_config_domain_name =====
26096 <HTML>
26097 <HEAD>
26098 <TITLE>OPTION: <!--#echo var="VAR_use-only-domain-name"--></TITLE>
26099 </HEAD>
26100 <BODY>
26101 <H1>OPTION: <!--#echo var="VAR_use-only-domain-name"--></H1>
26102
26103 This option is used only if the
26104 <A HREF="h_config_user_dom">&quot;<!--#echo var="VAR_user-domain"-->&quot;</A> option is <B>not</B>
26105 set.  If set to &quot;Yes&quot; (and <!--#echo var="VAR_user-domain"--> is not used), then Alpine
26106 strips the hostname from your return (&quot;From&quot;) address and when
26107 completing unqualified addresses that you enter into the composer.
26108 <P>
26109 If you set this, see also the <A HREF="h_config_quell_local_lookup">
26110 &quot;<!--#echo var="FEAT_quell-user-lookup-in-passwd-file"-->&quot;</A> feature.
26111
26112
26113 <!--chtml if pinemode="os_windows"-->
26114 <P>This option is not applicable to PC-Alpine.
26115 <!--chtml else-->
26116 <P>
26117 <!--chtml endif-->
26118 <UL>
26119 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26120 </UL>
26121 <P>
26122 &lt;End of help on this topic&gt;
26123 </BODY>
26124 </HTML>
26125 ====== h_config_prune_date =====
26126 <HTML>
26127 <HEAD>
26128 <TITLE>OPTION: Last-Time-Prune Question</TITLE>
26129 </HEAD>
26130 <BODY>
26131 <H1>OPTION: Last-Time-Prune Question</H1>
26132
26133 This value records the last time you were asked about deleting old
26134 sent-mail.
26135 It is set automatically by Alpine at the beginning of each month.
26136 In the past, if you wished to suppress the monthly sent-mail
26137 pruning feature, you could set this to a date in the future.
26138 This value is relative to the year 1900, so
26139 to set this, for example, to October 2005, use 105.10.
26140 <P>
26141 You can still do that if you wish, or you can use the
26142 <A HREF="h_config_pruning_rule"><!--#echo var="VAR_pruning-rule"--></A> option, which is probably
26143 a little more convenient to use.
26144 <P>
26145 <UL>
26146 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26147 </UL><P>
26148 &lt;End of help on this topic&gt;
26149 </BODY>
26150 </HTML>
26151 ====== h_config_goto_default =====
26152 <HTML>
26153 <HEAD>
26154 <TITLE>OPTION: <!--#echo var="VAR_goto-default-rule"--></TITLE>
26155 </HEAD>
26156 <BODY>
26157 <H1>OPTION: <!--#echo var="VAR_goto-default-rule"--></H1>
26158
26159 This value affects Alpine's behavior when you use the Goto command.
26160 Alpine's usual behavior has two parts.  If your current folder is
26161 &quot;Inbox&quot;, Alpine will offer the last open folder as the
26162 default.  If the current folder is other than &quot;Inbox&quot;,
26163 &quot;Inbox&quot; is offered as the default.
26164
26165 <P>
26166 The available options include:
26167
26168 <DL>
26169
26170  <DT>folder-in-first-collection</DT>
26171
26172  <DD> Alpine will offer the most recently visited folder in the default
26173 collection found in the &quot;Collection List&quot; screen as the default.
26174 </DD>
26175
26176  <DT> inbox-or-folder-in-first-collection</DT>
26177
26178  <DD> If the current folder is &quot;Inbox&quot;,
26179 Alpine will offer the most recently visited folder in the
26180 default collection found in the &quot;Collection List&quot; screen.
26181 If the current folder is other than &quot;Inbox&quot;,
26182 &quot;Inbox&quot; is offered as the default.
26183 </DD>
26184
26185  <DT> inbox-or-folder-in-recent-collection</DT>
26186
26187  <DD> This is Alpine's default behavior.
26188 If the current folder is &quot;Inbox&quot;,
26189 Alpine will offer the last open
26190 folder as the default.
26191 If the current folder is other than &quot;Inbox&quot;,
26192 &quot;Inbox&quot; is offered as the default.
26193 </DD>
26194
26195  <DT> first-collection-with-inbox-default</DT>
26196
26197  <DD> Instead of offering the most recently visited folder in the default
26198 collection, the default collection is offered but with &quot;Inbox&quot; as
26199 the default folder.
26200 If you type in a folder name it will be in the default collection.
26201 If you simply accept the default, however, your &quot;Inbox&quot; will be opened.
26202 </DD>
26203
26204  <DT> most-recent-folder</DT>
26205
26206  <DD> The last accepted value simply causes the most recently opened
26207 folder to be offered as the default regardless of the currently opened
26208 folder.
26209 </DD>
26210 </DL>
26211
26212 <P>
26213 NOTE: The default while a newsgroup is open remains the same; the last
26214 open newsgroup.
26215
26216 <P>
26217 <UL>
26218 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26219 </UL><P>
26220 &lt;End of help on this topic&gt;
26221 </BODY>
26222 </HTML>
26223 ====== h_config_thread_lastreply_char =====
26224 <HTML>
26225 <HEAD>
26226 <TITLE>OPTION: <!--#echo var="VAR_threading-lastreply-character"--></TITLE>
26227 </HEAD>
26228 <BODY>
26229 <H1>OPTION: <!--#echo var="VAR_threading-lastreply-character"--></H1>
26230
26231 The <!--#echo var="VAR_threading-lastreply-character"--> option has a small effect on the MESSAGE
26232 INDEX display when using a
26233 <A HREF="h_config_thread_disp_style"><!--#echo var="VAR_threading-display-style"--></A>
26234 of &quot;show-thread-structure&quot;, &quot;mutt-like&quot;, or
26235 &quot;show-structure-in-from&quot;; and sorting by Threads or OrderedSubject.
26236 The value of this option is a single character.
26237 This character is used instead of the vertical line character when there are
26238 no more replies directly to the parent of the current message.
26239 It can be used to &quot;round-off&quot; the bottom of the vertical line
26240 by setting it to a character such as a backslash (&#92;) or
26241 a backquote (&#96;).
26242 The default value of this option is the backslash character (&#92;).
26243 This option may not be set to the Empty Value.
26244 In that case, the default will be used instead.
26245
26246 <P>
26247 <UL>
26248 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26249 </UL><P>
26250 &lt;End of help on this topic&gt;
26251 </BODY>
26252 </HTML>
26253 ====== h_config_thread_indicator_char =====
26254 <HTML>
26255 <HEAD>
26256 <TITLE>OPTION: <!--#echo var="VAR_threading-indicator-character"--></TITLE>
26257 </HEAD>
26258 <BODY>
26259 <H1>OPTION: <!--#echo var="VAR_threading-indicator-character"--></H1>
26260
26261 The <!--#echo var="VAR_threading-indicator-character"--> option has a small effect on the MESSAGE
26262 INDEX display when using a
26263 <A HREF="h_config_thread_disp_style"><!--#echo var="VAR_threading-display-style"--></A> other
26264 than &quot;none&quot; and sorting by Threads or OrderedSubject.
26265 The value of this option is a single character.
26266 This character is used to indicate that part of a thread (a conversation) is
26267 hidden beneath a message.
26268 The message could be expanded
26269 if desired with the &quot;/&quot; Collapse/Expand command.
26270 By default, the value of this option is the greater than sign (&gt;).
26271 <P>
26272 If this option is set to the Empty Value, then the column (and the following
26273 blank column) will be deleted from the display.
26274
26275 <P>
26276 This option is closely related to the
26277 <A HREF="h_config_thread_exp_char"><!--#echo var="VAR_threading-expanded-character"--></A> option.
26278 Another similar option that affects the thread display is the
26279 <A HREF="h_config_thread_lastreply_char"><!--#echo var="VAR_threading-lastreply-character"--></A> option.
26280
26281 <P>
26282 <UL>
26283 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26284 </UL><P>
26285 &lt;End of help on this topic&gt;
26286 </BODY>
26287 </HTML>
26288 ====== h_config_thread_exp_char =====
26289 <HTML>
26290 <HEAD>
26291 <TITLE>OPTION: <!--#echo var="VAR_threading-expanded-character"--></TITLE>
26292 </HEAD>
26293 <BODY>
26294 <H1>OPTION: <!--#echo var="VAR_threading-expanded-character"--></H1>
26295
26296 The <!--#echo var="VAR_threading-expanded-character"--> option has a small effect on the MESSAGE
26297 INDEX display when using a
26298 <A HREF="h_config_thread_disp_style"><!--#echo var="VAR_threading-display-style"--></A> other
26299 than &quot;none&quot;.
26300 The value of this option is a single character.
26301 This character is used to indicate that part of a thread has been expanded
26302 and could be collapsed if desired with
26303 the &quot;/&quot; Collapse/Expand command.
26304 By default, the value of this option is a dot (.).
26305 <P>
26306 If this option is set to the Empty Value, then the column (and the following
26307 blank column) will be deleted from the display.
26308
26309 <P>
26310 This option is closely related to the
26311 <A HREF="h_config_thread_indicator_char"><!--#echo var="VAR_threading-indicator-character"--></A> option.
26312 Another similar option that affects the thread display is the
26313 <A HREF="h_config_thread_lastreply_char"><!--#echo var="VAR_threading-lastreply-character"--></A> option.
26314
26315 <P>
26316 <UL>
26317 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26318 </UL><P>
26319 &lt;End of help on this topic&gt;
26320 </BODY>
26321 </HTML>
26322 ====== h_config_thread_index_style =====
26323 <HTML>
26324 <HEAD>
26325 <TITLE>OPTION: <!--#echo var="VAR_threading-index-style"--></TITLE>
26326 </HEAD>
26327 <BODY>
26328 <H1>OPTION: <!--#echo var="VAR_threading-index-style"--></H1>
26329
26330 When a folder is sorted by Threads or OrderedSubject,
26331 this option will affect the INDEX displays.
26332 <P>
26333
26334 The possible values for this option are:
26335
26336 <DL>
26337 <DT>regular-index-with-expanded-threads</DT>
26338 <DD>This is the default display.
26339 If the configuration option
26340 <A HREF="h_config_thread_disp_style">&quot;<!--#echo var="VAR_threading-display-style"-->&quot;</A>
26341 is set to something other than &quot;none&quot;, then this setting
26342 will cause Alpine to start off with a MESSAGE INDEX with all of
26343 the threads expanded.
26344 That is, each message will have a line in the MESSAGE INDEX display.
26345 The Collapse/Expand command (/) may be used to manually collapse or
26346 expand a thread or subthread (see also <A HREF="h_config_slash_coll_entire">&quot;<!--#echo var="FEAT_slash-collapses-entire-thread"-->&quot;</A>).
26347 <P>
26348 This setting affects the display when the folder is first threaded.
26349 The collapsed state may also be re-initialized by re-sorting the folder manually
26350 using the SortIndex command ($).
26351 After re-sorting the threads will once again all be expanded, even if you
26352 have previously collapsed some of them.
26353 <P>
26354 If &quot;<!--#echo var="VAR_threading-display-style"-->&quot; is set to &quot;none&quot;, then
26355 the display will be the regular default Alpine MESSAGE INDEX, but sorted
26356 in a different order.
26357 </DD>
26358
26359 <DT>regular-index-with-collapsed-threads</DT>
26360 <DD>If the configuration option
26361 <A HREF="h_config_thread_disp_style">&quot;<!--#echo var="VAR_threading-display-style"-->&quot;</A>
26362 is set to something other than &quot;none&quot;, then this setting
26363 will cause Alpine to start out with all of the threads collapsed instead of
26364 starting out with all of the threads expanded.
26365 The Collapse/Expand command (/) may be used to manually collapse or
26366 expand a thread or subthread (see also <A HREF="h_config_slash_coll_entire">&quot;<!--#echo var="FEAT_slash-collapses-entire-thread"-->&quot;</A>).
26367 <P>
26368 This setting affects the display when the folder is first threaded.
26369 The collapsed state may also be re-initialized by re-sorting the folder manually
26370 using the SortIndex command ($).
26371 After re-sorting the threads will once again all be collapsed, even if you
26372 have previously expanded some of them.
26373 </DD>
26374
26375 <DT>separate-index-screen-always</DT>
26376 <DD>With this setting and the next, you will see an index of threads
26377 instead of an
26378 index of messages, provided you have sorted by Threads or OrderedSubject.
26379 <P>
26380 The THREAD INDEX contains a '*' in the first column if any message in the thread
26381 is marked Important.
26382 If not, it contains a '+' if any message in the thread is to you.
26383 The second column is blank. The third column contains a 'D' if all of the
26384 messages in the thread are deleted.
26385 Otherwise, it contains an 'N' if any of the messages in the thread are New.
26386 <P>
26387 When you view a particular thread from the THREAD INDEX you will be
26388 in the MESSAGE INDEX display
26389 but the index will only contain messages from the thread you are viewing.
26390 </DD>
26391
26392 <DT>separate-index-screen-except-for-single-messages</DT>
26393 <DD>This is very similar to the option above.
26394 When you are in the THREAD INDEX, one of the available commands
26395 is &quot;ViewThd&quot;.
26396 With the setting &quot;separate-index-screen-always&quot; (the option above)
26397 when you view a particular thread you will be in the
26398 MESSAGE INDEX display and the index will only contain messages from
26399 the thread you are viewing.
26400 If the thread you are viewing consists of a single message, the MESSAGE INDEX
26401 will be an index with only one message in it.
26402 If you use this &quot;separate-index-screen-except-for-single-messages&quot;
26403 setting instead, then that index that contains a single message
26404 will be skipped and you will go directly from the THREAD INDEX into the
26405 MESSAGE TEXT screen.
26406 </DD>
26407
26408 </DL>
26409
26410 <P>
26411 <UL>
26412 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26413 </UL><P>
26414 &lt;End of help on this topic&gt;
26415 </BODY>
26416 </HTML>
26417 ====== h_config_thread_disp_style =====
26418 <HTML>
26419 <HEAD>
26420 <TITLE>OPTION: <!--#echo var="VAR_threading-display-style"--></TITLE>
26421 </HEAD>
26422 <BODY>
26423 <H1>OPTION: <!--#echo var="VAR_threading-display-style"--></H1>
26424
26425 When a folder is sorted by Threads or OrderedSubject,
26426 this option will affect the MESSAGE INDEX display.
26427 By default, Alpine will display the MESSAGE INDEX in the
26428 &quot;show-thread-structure&quot; style if a folder is sorted
26429 by Threads or OrderedSubject.
26430 <P>
26431
26432 The possible values for this option are:
26433
26434 <DL>
26435 <DT>none</DT>
26436 <DD>Regular index display.
26437 The same index line as would be displayed without threading is used.
26438 The only difference will be in the order of the messages.
26439 </DD>
26440
26441 <DT>show-thread-structure</DT>
26442 <DD>Threaded Subjects will be indented and vertical bars and horizontal
26443 lines will be added to make it easier to see the relationships among
26444 the messages in a thread (a conversation).
26445 </DD>
26446
26447 <DT>mutt-like</DT>
26448 <DD>This is the same as the option above except that the Subject
26449 is suppressed (is blank) if it matches the previous Subject in the thread.
26450 The name comes from the email client <A HREF="http://www.mutt.org/">Mutt</A>.
26451 Here is an example of what a mutt-like index might look like.
26452 In this example, the first column represents the message number, the
26453 <A HREF="h_config_thread_index_style"><!--#echo var="VAR_threading-index-style"--></A>
26454 is set to &quot;regular-index-with-expanded-threads&quot;, and the
26455 <A HREF="h_config_thread_lastreply_char"><!--#echo var="VAR_threading-lastreply-character"--></A>
26456 is set to a backslash:
26457 <PRE>
26458 &nbsp;&nbsp;&nbsp;1    Some topic
26459 &nbsp;&nbsp;&nbsp;&nbsp;2  . Subject           original message in thread
26460 &nbsp;&nbsp;&nbsp;&nbsp;3    |->               reply to 2
26461 &nbsp;&nbsp;&nbsp;&nbsp;4  . |->               another reply to 2
26462 &nbsp;&nbsp;&nbsp;&nbsp;5  . | &#92;->             reply to 4
26463 &nbsp;&nbsp;&nbsp;&nbsp;6  . |   &#92;->           reply to 5
26464 &nbsp;&nbsp;&nbsp;&nbsp;7    |     &#92;->         reply to 6
26465 &nbsp;&nbsp;&nbsp;&nbsp;8    |->               another reply to 2
26466 &nbsp;&nbsp;&nbsp;&nbsp;9  . |->New subject    another reply to 2 but with a New subject
26467 &nbsp;&nbsp;&nbsp;10    | |->             reply to 9
26468 &nbsp;&nbsp;&nbsp;11    | &#92;->             another reply to 9
26469 &nbsp;&nbsp;&nbsp;12    |   &#92;->           reply to 11
26470 &nbsp;&nbsp;&nbsp;13    &#92;->               final reply to 2
26471 &nbsp;&nbsp;&nbsp;14    Next topic
26472 </PRE>
26473 </DD>
26474
26475 <DT>indent-subject-1</DT>
26476 <DD>Threaded Subjects will be indented one space per level of the conversation.
26477 The bars and lines that show up in the show-thread-structure display will
26478 not be there with this style.
26479 </DD>
26480
26481 <DT>indent-subject-2</DT>
26482 <DD>Same as above but indent two spaces per level instead of one space.
26483 </DD>
26484
26485 <DT>indent-from-1</DT>
26486 <DD>Similar to indent-subject-1, except that instead of indenting the
26487 Subject field one space the From field of a thread will be indented one
26488 space per level of the conversation.
26489 </DD>
26490
26491 <DT>indent-from-2</DT>
26492 <DD>Same as above but indent two spaces per level instead of one space.
26493 </DD>
26494
26495 <DT>show-structure-in-from</DT>
26496 <DD>The structure of the thread is illustrated with indenting, vertical bars,
26497 and horizontal lines just like with the show-thread-structure option, but
26498 the From field is used to show the relationships instead of the Subject field.
26499 </DD>
26500
26501 </DL>
26502
26503 <P>
26504 <UL>
26505 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26506 </UL><P>
26507 &lt;End of help on this topic&gt;
26508 </BODY>
26509 </HTML>
26510 ====== h_config_pruning_rule =====
26511 <HTML>
26512 <HEAD>
26513 <TITLE>OPTION: <!--#echo var="VAR_pruning-rule"--></TITLE>
26514 </HEAD>
26515 <BODY>
26516 <H1>OPTION: <!--#echo var="VAR_pruning-rule"--></H1>
26517
26518 By default, Alpine will ask at the beginning of each month whether or not
26519 you want to rename your sent-mail folder to a name like sent-mail-month-year.
26520 (See the feature <A HREF="h_config_prune_uses_iso"><!--#echo var="FEAT_prune-uses-yyyy-mm"--></A> to
26521 change the format of the folder to sent-mail-yyyy-mm.)
26522 It will also ask whether you would like to delete old sent-mail folders.
26523 If you have defined
26524 <A HREF="h_config_read_message_folder"><!--#echo var="VAR_read-message-folder"--></A>
26525 or
26526 <A HREF="h_config_pruned_folders"><!--#echo var="VAR_pruned-folders"--></A>
26527 Alpine will also ask about pruning those folders.
26528 <P>
26529
26530 With this option you may provide an automatic answer to these questions.
26531 The default value is to ask you what you'd like to do.
26532 <P>
26533
26534 The six possible values for this option are:
26535
26536 <DL>
26537 <DT>ask about rename, ask about deleting</DT>
26538 <DD>This is the default.
26539 Alpine will ask whether you want to rename the folders and whether you
26540 want to delete each of the old folders.
26541 </DD>
26542
26543 <DT>ask about rename, don't delete</DT>
26544 <DD>Alpine will ask whether you want to rename the folders, but won't
26545 ask about or delete old folders.
26546 </DD>
26547
26548 <DT>always rename, ask about deleting</DT>
26549 <DD>This means you want to always answer yes and have Alpine automatically
26550 rename the folder if possible.
26551 You will also be asked about deleting old folders.
26552 </DD>
26553
26554 <DT>always rename, don't delete</DT>
26555 <DD>This means you want to always answer yes and have Alpine automatically
26556 rename the folder if possible.
26557 There will be no deleting of old folders.
26558 </DD>
26559
26560 <DT>don't rename, ask about deleting</DT>
26561 <DD>This means you want to always answer no.
26562 Alpine will not rename the folder.
26563 You will be asked about deleting old folders.
26564 </DD>
26565
26566 <DT>don't rename, don't delete</DT>
26567 <DD>This means you want to always answer no.
26568 Alpine will not rename the folder.
26569 There will be no deleting of old folders, either.
26570 </DD>
26571 </DL>
26572
26573 <P>
26574 <UL>
26575 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26576 </UL><P>
26577 &lt;End of help on this topic&gt;
26578 </BODY>
26579 </HTML>
26580 ====== h_config_reopen_rule =====
26581 <HTML>
26582 <HEAD>
26583 <TITLE>OPTION: <!--#echo var="VAR_folder-reopen-rule"--></TITLE>
26584 </HEAD>
26585 <BODY>
26586 <H1>OPTION: <!--#echo var="VAR_folder-reopen-rule"--></H1>
26587
26588 Alpine normally checks for new mail in the currently open folder
26589 and in the INBOX every few <A HREF="h_config_mailcheck">minutes</A>.
26590
26591 <P>
26592 There are some situations where automatic new-mail checking does not work.
26593 For example, if a mail folder is opened using the POP protocol or a newsgroup
26594 is being read using the NNTP protocol, then new-mail checking is disabled.
26595
26596 <P>
26597 It may be possible to check for new mail in these cases by reopening the
26598 folder.
26599 Alpine does not do this for you automatically, but you may do the commands
26600 manually to cause this to happen.
26601 You reopen by going back to the folder list screen from the message
26602 index screen with the &quot;&lt;&quot; command,
26603 and then going back into the message index screen with
26604 the &quot;&gt;&quot; command.
26605 (Actually, any method you would normally use to open a folder will work the
26606 same as the &quot;&lt;&quot; followed by &quot;&gt;&quot; method.
26607 For example, the GoTo Folder command will work, or you may use L to go to the
26608 Folder List screen and Carriage Return to reopen the folder.)
26609
26610 <P>
26611 There are some cases where Alpine knows that reopening the folder should
26612 be useful as a way to discover new mail.
26613 At the time of this writing, connections made using the POP protocol,
26614 news reading using the NNTP protocol, local news reading, and local
26615 ReadOnly folders that are in the traditional UNIX or the MMDF format all
26616 fall into this category.
26617 There are other cases where it <EM>may</EM> be a way to discover new mail, but Alpine
26618 has no way of knowing, so it might also just be an exercise in futility.
26619 All remote, ReadOnly folders other than those listed just above fall into this
26620 category.
26621 The setting of this option together with the type of folder
26622 controls how Alpine will react to the apparent attempt to reopen a folder.
26623
26624 <P>
26625 If you don't reopen, then you will just be back in
26626 the message index with no change.
26627 You left the index and came back, but the folder remained &quot;open&quot;
26628 the whole time.
26629 However, if you do reopen the folder, the folder is closed and then reopened.
26630 In this case, the current state of the open folder is lost.
26631 The New status, Important and Answered flags,
26632 selected state, Zoom state, collapsed or expanded state of threads,
26633 current message number,
26634 and any other temporary state is all lost when the reopen happens.
26635 For POP folders (but not NNTP newsgroups) the Deleted flags are also lost.
26636
26637 <P>
26638 In the possibilities listed below, the text says &quot;POP/NNTP&quot; in
26639 several places.
26640 That really implies the case where Alpine knows it is a good way to discover
26641 new mail, which is more than just POP and NNTP, but POP and NNTP are
26642 the cases of most interest.
26643 This option probably has more possible values than it deserves. They are:
26644
26645 <DL>
26646 <DT>Always reopen</DT>
26647 <DD>Alpine will not ask whether you want to reopen but will just do the reopen
26648 whenever you type a command that implies a reopen, regardless of the
26649 access method.
26650 In other words, it is assumed you would always answer Yes if asked
26651 about reopening.
26652 </DD>
26653
26654 <DT>Yes for POP/NNTP, Ask about other remote [Yes]</DT>
26655 <DD>Alpine will assume a Yes answer if the access method is POP or NNTP, but
26656 will ask you whether to reopen other remote folders,
26657 with a default answer of Yes.
26658 </DD>
26659
26660 <DT>Yes for POP/NNTP, Ask about other remote [No]</DT>
26661 <DD>Alpine will assume a Yes answer if the access method is POP or NNTP, but
26662 will ask you whether to reopen other remote folders,
26663 with a default answer of No.
26664 </DD>
26665
26666 <DT>Yes for POP/NNTP, No for other remote</DT>
26667 <DD>Alpine will assume a Yes answer if the access method is POP or NNTP, and
26668 will assume a No answer for all other remote folders.
26669 </DD>
26670
26671 <DT>Always ask [Yes]</DT>
26672 <DD>Alpine will not differentiate based on access method.
26673 It will always ask for all remote folders, with a default answer of Yes.
26674 </DD>
26675
26676 <DT>Always ask [No]</DT>
26677 <DD>Alpine will not differentiate based on access method.
26678 It will always ask for all remote folders, with a default answer of No.
26679 </DD>
26680
26681 <DT>Ask about POP/NNTP [Yes], No for other remote</DT>
26682 <DD>Alpine will ask if the access method is POP or NNTP, with a default answer
26683 of Yes.
26684 It will never attempt to reopen other remote folders.
26685 </DD>
26686
26687 <DT>Ask about POP/NNTP [No], No for other remote</DT>
26688 <DD>This is the default.
26689 Alpine will ask if the access method is POP or NNTP, with a default answer
26690 of No.
26691 It will never attempt to reopen other remote folders.
26692 </DD>
26693
26694 <DT>Never reopen</DT>
26695 <DD>Alpine will never attempt to reopen already open folders.
26696 </DD>
26697 </DL>
26698
26699 <P>
26700 Remember, wherever it says POP or NNTP above it really means POP or NNTP or
26701 any of the other situations where it is likely that reopening is a good way
26702 to discover new mail.
26703
26704 <P>
26705 There is an alternative that may be of useful in some situations.
26706 Instead of manually checking for new mail you can set up a
26707 <A HREF="h_maildrop">Mail Drop</A>
26708 and automatically check for new mail.
26709
26710 <P>
26711 <UL>
26712 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26713 </UL><P>
26714 &lt;End of help on this topic&gt;
26715 </BODY>
26716 </HTML>
26717 ====== h_config_inc_startup =====
26718 <HTML>
26719 <HEAD>
26720 <TITLE>OPTION: <!--#echo var="VAR_incoming-startup-rule"--></TITLE>
26721 </HEAD>
26722 <BODY>
26723 <H1>OPTION: <!--#echo var="VAR_incoming-startup-rule"--></H1>
26724
26725 This value affects Alpine's behavior when opening the &quot;INBOX&quot; or
26726 one of the &quot;INCOMING MESSAGE FOLDERS&quot;.
26727 It determines which message will be the <EM>current message</EM> when
26728 the folder is first opened.
26729 The default value is &quot;first-unseen&quot;.
26730
26731 <P>
26732 The seven possible values for this option are:
26733
26734 <DL>
26735 <DT>first-unseen</DT>
26736 <DD>The current message is set to the first
26737 unseen message that has not been marked deleted, or the last message if
26738 all of the messages have been seen previously.
26739 Messages which have not been seen or which have been seen but re-marked
26740 as New are considered unseen messages.
26741 See the note at the bottom of this help about newsgroups.
26742 </DD>
26743
26744 <DT>first-recent</DT>
26745 <DD>Similar to the default, but rather than starting on the first
26746 unseen message Alpine starts on the first <EM>recent</EM> message.
26747 A message is recent if it arrived since the last time the folder was
26748 open.  This value causes the current message to be set to the first
26749 recent message if there is one, otherwise to the last
26750 message in the folder.
26751 </DD>
26752
26753 <DT>first-important</DT>
26754 <DD>This will result in the current message being set to the first
26755 message marked Important (but not Deleted).
26756 If no messages are marked Important, then it will be the last message.
26757 Messages are marked Important by <EM>you</EM>, not by the sender, using
26758 the
26759 <A HREF="h_common_flag">Flag command</A>.
26760 Or they may be marked Important by an Alpine
26761 <A HREF="h_mainhelp_filtering">Filter</A>
26762 that you have set up.
26763 </DD>
26764
26765 <DT>first-important-or-unseen</DT>
26766 <DD>This selects the first of the first unseen and the first important
26767 messages.
26768 </DD>
26769
26770 <DT>first-important-or-recent</DT>
26771 <DD>This selects the first of the first recent and the first important
26772 messages.
26773 </DD>
26774
26775 <DT>first</DT>
26776 <DD>Simply starts you on the <EM>first</EM> undeleted message in the folder.
26777 If all messages are deleted you start on the last message.
26778 </DD>
26779
26780 <DT>last</DT>
26781 <DD>Simply starts you on the <EM>last</EM> undeleted message in the folder
26782 If all messages are deleted you start on the last message.
26783 </DD>
26784 </DL>
26785
26786 <P>
26787 NOTE:  For newsgroups in the incoming collection, &quot;first-unseen&quot; and
26788 &quot;first-recent&quot; are the same and are affected by whether or not the
26789 feature
26790 <A HREF="h_config_news_uses_recent">&quot;<!--#echo var="FEAT_news-approximates-new-status"-->&quot;</A>
26791 is turned on.
26792 Also, there is no permanent storage in news for an Important flag.
26793 This means that no messages will be marked Important when a newsgroup is
26794 first opened.
26795
26796 <P>
26797 <UL>
26798 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26799 </UL><P>
26800 &lt;End of help on this topic&gt;
26801 </BODY>
26802 </HTML>
26803 ====== h_config_browser =====
26804 <HTML>
26805 <HEAD>
26806 <TITLE>OPTION: <!--#echo var="VAR_url-viewers"--></TITLE>
26807 </HEAD>
26808 <BODY>
26809 <H1>OPTION: <!--#echo var="VAR_url-viewers"--></H1>
26810 <!--chtml if pinemode="os_windows"-->
26811 PC-Alpine users do not need to enter anything here, unless:<UL>
26812 <LI> they want to override, for use with Alpine, the application defined
26813 in the Windows operating system for handling URLs; or
26814 <LI> they are (planning on) using the same configuration file with
26815 Unix Alpine.
26816 </UL>
26817 <P>
26818 Note that if using a viewer that has a space in its path, you should
26819 use the DOS name for that directory or file. Example:
26820 <PRE>
26821 url-viewer=C:&#92;Progra~1&#92;mozilla&#92;mozilla.exe
26822 </PRE>
26823 <HR><P>
26824 <!--chtml endif-->
26825 This option affects Alpine's handling of URLs that are found in
26826 messages you read.  Normally, only URLs Alpine can handle directly
26827 are automatically offered for selection in the &quot;Message
26828 Text&quot; screen.  When one or more applications
26829 capable of deciphering URLs on their command line are added here, Alpine
26830 will choose the first available to display URLs it cannot handle directly.
26831 A viewer's availability is based on its being specified with a <B>full
26832 directory path</B> and the evaluation of any optionally supplied
26833 parameters described below.
26834
26835 <P>
26836 Additionally, to support various connection methods and applications, each
26837 entry in this list can optionally begin with one or more of
26838 the following special tokens.  The allowed tokens include:
26839
26840 <P>
26841 <DL>
26842 <DT>_TEST(<VAR>test-string</VAR>)_</DT>
26843 <DD>
26844 The <VAR>test-string</VAR> is a shell command that Alpine will run to
26845 evaluate a viewer's availability.  The command specified by the test
26846 string is run and if its resulting exit status is non-zero, Alpine will
26847 not consider the associated viewer for use.
26848 </DD>
26849
26850 <DT>_SCHEME(<VAR>scheme-list</VAR>)_</DT>
26851 <DD>
26852 The <VAR>scheme-list</VAR> is a list of one or more (comma-delimited)
26853 URL schemes that are to be used with the associated viewer.  This is
26854 the way to configure Alpine to recognize URLs other than the built-in set.
26855 <P>
26856 It can also be used to override Alpine's built-in handlers.
26857 For example, you could specify &quot;news&quot; in the <VAR>scheme-list</VAR>,
26858 and Alpine would use (provided it passed all other criteria) the associated
26859 viewer when it encounterd a URL of the form &quot;news:comp.mail.pine&quot;.
26860
26861 </DD>
26862 </DL>
26863
26864 <P>
26865 By default, Alpine will simply append a space character followed by the
26866 selected URL prior to launching the command in your specified SHELL.  You can
26867 optionally specify where in the command the selected URL should appear
26868 by using the &quot;_URL_&quot; token.  All occurrences found in the command
26869 will be replaced with the selected URL before the command is handed
26870 to the shell.  If such replacement occurs, the default appending of the
26871 selected URL does not take place.
26872
26873 <P>
26874 NOTE: If the viewer you specify has any command-line arguments,
26875 including the &quot;_URL_&quot; token, you will need to add a
26876 double-quote character before the command path and after the last
26877 argument (see the &quot;lynx&quot; example below).
26878
26879 <P>
26880 So, here are some example entries:
26881 <PRE>
26882 url-viewers = _TEST(&quot;test -n '$&#123;DISPLAY}'&quot;)_  /usr/local/bin/netscape
26883               &quot;/usr/local/bin/lynx _URL_&quot;
26884               C:&#92;BIN&#92;NETSCAPE.BAT
26885 </PRE>
26886 <P>
26887 This example shows that for the first viewer in the list to be used
26888 the environment variable &quot;DISPLAY&quot; must be defined.  If it
26889 is, then the path and file &quot;/usr/local/bin/netscape&quot; must exist.
26890 If neither condition is met,
26891 then the path and file &quot;/usr/local/bin/lynx&quot; must exist.
26892 If it does, then the &quot;_URL_&quot; token is replaced by the selected URL.
26893 If the path to &quot;lynx&quot; is invalid,
26894 then the final path and file C:&#92;BIN&#92;NETSCAPE.BAT must exist.
26895 Note that the last
26896 entry is a DOS/Windows path.  This is one way to support Alpine running
26897 on more than one architecture with the same configuration file.<P>
26898 <P>
26899 <!--chtml if pinemode="os_windows"-->
26900 <!--chtml else-->
26901 Note that depending on the type of browser used and the method of
26902 its invocation (such as whether it will open in a separate window) from
26903 the MESSAGE TEXT screen, the browser may &quot;supplant&quot;
26904 the MESSAGE TEXT screen, and you will have to quit the browser to return to
26905 it (for example, when using Lynx; to exit Lynx, use the &quot;Q&quot; command).
26906 In other words, launching the browser from Alpine may make Alpine
26907 &quot;disappear&quot; (although it is still &quot;running&quot;)
26908 until you close the browser again.<P>
26909 <UL><LI><A HREF="h_config_browser_xterm">Defining <!--#echo var="VAR_url-viewers"--> in an X windows
26910 environment: for advanced users and  systems administrators</A>
26911 </UL>
26912 <!--chtml endif-->
26913 <P>If you are unsure what browsers are available on your system or how to
26914 specify them in Alpine's <!--#echo var="VAR_url-viewers"--> option for best usability, contact your
26915 local computing support staff.
26916 <P><UL>
26917 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26918 </UL>
26919 <P>
26920 &lt;End of help on this topic&gt;
26921 </BODY>
26922 </HTML>
26923 ====== h_config_browser_xterm =====
26924 <HTML>
26925 <HEAD>
26926 <TITLE><!--#echo var="VAR_url-viewers"--> and X windows applications</TITLE>
26927 </HEAD>
26928 <BODY>
26929 <H1>Defining <!--#echo var="VAR_url-viewers"--> in an X windows
26930 environment: for advanced users and  systems administrators</H1>
26931 If you are using Alpine with an X-terminal (emulator) and want to define an
26932 X windows-based application in <!--#echo var="VAR_url-viewers"-->,
26933 you may want to do so in a manner that causes any <B>already</B>
26934 invoked viewer application to be used for viewing URLs you select from Alpine
26935 messages, and a <B>new</B> URL-viewer process to be
26936 started <B>only</B> if the same application has <B>not already</B>
26937 been launched -- for one reason, to avoid file-locking contentions among
26938 multiple invocations of the same URL-viewer application.
26939 (The example entries set in the help screen for the &quot;<!--#echo var="VAR_url-viewers"-->&quot;
26940 option does not do this.)  A method of doing that would be:<OL>
26941 <LI> use
26942 the _TEST(<VAR>test-string</VAR>)_ token in the <B>first</B> entry to
26943 check (using commands appropriate for your Unix shell
26944 in place of <VAR>test-string</VAR>) for the presence of a
26945 lockfile created by the URL-viewer application -- which implies that the
26946 application is already running, though this is not foolproof.
26947 Following that in the same <!--#echo var="VAR_url-viewers"--> entry, specify the
26948 application with its appropriate command line option(s) to
26949 show the URL selected from the Alpine message in an already open window of
26950 that application, or perhaps in a new window of that application.
26951
26952 <LI> In the
26953 <B>second</B> entry for the <!--#echo var="VAR_url-viewers"--> option, specify the same
26954 application without those command line options, but this time using the
26955 _TEST(...)_ token to check whether the environment variable &quot;DISPLAY&quot;
26956 is defined.
26957 <LI> If you will be using Alpine (with the same .pinerc file) outside of the X
26958 windows environment (for instance, using VT-100 terminal emulation), you
26959 may wish to specify a non-X windows URL-viewer application such as Lynx
26960 as the last entry.
26961 </OL><BR>
26962 How exactly you define your <!--#echo var="VAR_url-viewers"--> entries to do this will depend on
26963 the command shell, the URL-viewer application(s), and possibly the specific
26964 version of the latter, you are using.
26965 <P>
26966 Relevant command
26967 line options for the Netscape browser for showing URLs (selected from Alpine)
26968 when Netscape is already running are discussed in the document
26969 &quot;Remote Control of UNIX Netscape&quot;
26970 found at the URL (as of 12 Aug. 1998):
26971 <P>
26972
26973 <CENTER><A HREF="http://home.netscape.com/newsref/std/x-remote.html">http://home.netscape.com/newsref/std/x-remote.html</A></CENTER>
26974
26975 <P>(If the URL-viewer application is
26976 <B>not</B> running on the same host as Alpine, but being launched from an
26977 applications server, you may not be able to use the command line options for
26978 using an existing invocation of the application in Alpine's <!--#echo var="VAR_url-viewers"--> entry.)
26979 <P>
26980 <!--chtml if this-method="shown-to-work"-->
26981 An example using the Korn shell and the Netscape browser (first entry wrapped
26982 because of its length, but should all appear on one line):
26983 <P>
26984 url-viewers = _TEST("test -L /myhomedir/.netscape/lock")_ &quot;/usr/local/bin/netscape -remote 'openURL(_URL_,  new-window)' &amp;&quot;<BR>
26985
26986 _TEST(&quot;test -n '$&#123;DISPLAY}'&quot;)_ &quot;/usr/local/bin/netscape &amp;&quot;<BR>
26987               &quot;/usr/local/bin/lynx '_URL_'&quot;
26988 <P>
26989 <!--chtml endif-->
26990 <P>
26991 <UL>
26992 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26993 </UL><P>
26994 &lt;End of help on this topic&gt;
26995 </BODY>
26996 </HTML>
26997 ====== h_config_enable_full_hdr =====
26998 <HTML>
26999 <HEAD>
27000 <TITLE>FEATURE: <!--#echo var="FEAT_enable-full-header-cmd"--></TITLE>
27001 </HEAD>
27002 <BODY>
27003 <H1>FEATURE: <!--#echo var="FEAT_enable-full-header-cmd"--></H1>
27004
27005 This feature enables the &quot;H Full Headers&quot; command which toggles between
27006 the display of all headers in the message and the normal edited view of
27007 headers.  The Full Header command also controls which headers are included
27008 for Export, Pipe, Print, Forward, and Reply functions.  (For Reply, the
27009 Full Header mode will respect the
27010 <A HREF="h_config_include_header">&quot;Include-Headers-in-Reply&quot;</A>
27011 feature setting.)
27012 <P>
27013 If Full Header mode is turned on and you Forward a message, you will
27014 be asked if you'd like to forward the message as an attachment, as opposed
27015 to including the text of the message in the body of your new message.
27016 <P>
27017 If you have also turned on the
27018 <A HREF="h_config_quote_suppression">&quot;Quote Suppression&quot;</A>
27019 option then the Full Headers command actually rotates through three states
27020 instead of just two.
27021 The first is the normal view with long quotes suppressed.
27022 The second is the normal view but with the long quotes included.
27023 The last enables the display of all headers in the message.
27024 When using Export, Pipe, Print, Forward, or Reply the quotes are
27025 never suppressed, so the first two states are identical.
27026 <P>
27027 Normally, the Header Mode will reset
27028 to the default behavior when moving to a new message.
27029 The mode can be made to persist from message to message by setting the feature
27030 <A HREF="h_config_quell_full_hdr_reset"><!--#echo var="FEAT_quell-full-header-auto-reset"--></A>.
27031 <P>
27032 <UL>
27033 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27034 </UL><P>
27035 &lt;End of help on this topic&gt;
27036 </BODY>
27037 </HTML>
27038 ====== h_config_enable_full_hdr_and_text =====
27039 <HTML>
27040 <HEAD>
27041 <TITLE>FEATURE: <!--#echo var="FEAT_enable-full-header-and-text"--></TITLE>
27042 </HEAD>
27043 <BODY>
27044 <H1>FEATURE: <!--#echo var="FEAT_enable-full-header-and-text"--></H1>
27045
27046 This feature affects how the &quot;H Full Headers&quot; command displays
27047 message text.  If set, the raw message text will be displayed.  This
27048 especially affects MIME formatted email, where the entire MIME format
27049 will be displayed.  This feature similarly affects how messages are
27050 included for the Export, Pipe, Print, Forward, and Reply functions.
27051 <P>
27052 When viewing a raw message that has attachments with this feature set,
27053 you will not be able to view attachments without first leaving full
27054 headers mode.  This is because MIME parsing is not done on the raw message.
27055 <P>
27056 <UL>
27057 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27058 </UL><P>
27059 &lt;End of help on this topic&gt;
27060 </BODY>
27061 </HTML>
27062 ====== h_config_enable_pipe =====
27063 <HTML>
27064 <HEAD>
27065 <TITLE>FEATURE: <!--#echo var="FEAT_enable-unix-pipe-cmd"--></TITLE>
27066 </HEAD>
27067 <BODY>
27068 <H1>FEATURE: <!--#echo var="FEAT_enable-unix-pipe-cmd"--></H1>
27069
27070 This feature enables the "| Pipe" command that sends the current message
27071 to the specified command for external processing.
27072 <P>
27073
27074 A short description of how the pipe command works is given
27075 <A HREF="h_pipe_command">here</A>.
27076
27077 <P>
27078 <UL>
27079 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27080 </UL><P>
27081 &lt;End of help on this topic&gt;
27082 </BODY>
27083 </HTML>
27084 ====== h_config_quell_full_hdr_reset =====
27085 <HTML>
27086 <HEAD>
27087 <TITLE>FEATURE: <!--#echo var="FEAT_quell-full-header-auto-reset"--></TITLE>
27088 </HEAD>
27089 <BODY>
27090 <H1>FEATURE: <!--#echo var="FEAT_quell-full-header-auto-reset"--></H1>
27091
27092 The <A HREF="h_common_hdrmode">HdrMode Command</A>
27093 normally resets to the default state when switching to a new message.
27094 For example, if you've used the &quot;H&quot; command to turn on Full
27095 Headers for a message you are viewing, and then you type the Next command
27096 to look at the next message, the full headers will no longer be shown.
27097 Setting this feature disables that reset.
27098 Instead, the Header Mode remains the same from message to message.
27099
27100 <P>
27101 The presence or absence of the HdrMode command is determined by the
27102 <A HREF="h_config_enable_full_hdr">&quot;<!--#echo var="FEAT_enable-full-header-cmd"-->&quot;</A>
27103 Feature-List option.
27104 <P>
27105 <UL>
27106 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27107 </UL><P>
27108 &lt;End of help on this topic&gt;
27109 </BODY>
27110 </HTML>
27111 ====== h_config_enable_tab_complete =====
27112 <HTML>
27113 <HEAD>
27114 <TITLE>FEATURE: <!--#echo var="FEAT_enable-tab-completion"--></TITLE>
27115 </HEAD>
27116 <BODY>
27117 <H1>FEATURE: <!--#echo var="FEAT_enable-tab-completion"--></H1>
27118
27119 This feature enables the TAB key when at a prompt for a filename. In this
27120 case, TAB will cause the partial name already entered to be automatically
27121 completed, provided the partial name is unambiguous.
27122 This feature is on by default.
27123 <P>
27124 Similarly, this feature also enables TAB completion of address book
27125 nicknames when at a prompt for a nickname,
27126 or when typing in an address field in the composer.
27127 <P>
27128 &lt;End of help on this topic&gt;
27129 </BODY>
27130 </HTML>
27131 ====== h_config_quit_wo_confirm =====
27132 <HTML>
27133 <HEAD>
27134 <TITLE>FEATURE: <!--#echo var="FEAT_quit-without-confirm"--></TITLE>
27135 </HEAD>
27136 <BODY>
27137 <H1>FEATURE: <!--#echo var="FEAT_quit-without-confirm"--></H1>
27138
27139 This feature controls whether or not Alpine will ask for confirmation when a
27140 Quit command is received.
27141 <P>
27142 &lt;End of help on this topic&gt;
27143 </BODY>
27144 </HTML>
27145 ====== h_config_quote_replace_noflow =====
27146 <HTML>
27147 <HEAD>
27148 <TITLE>FEATURE: <!--#echo var="FEAT_quote-replace-nonflowed"--></TITLE>
27149 </HEAD>
27150 <BODY>
27151 <H1>FEATURE: <!--#echo var="FEAT_quote-replace-nonflowed"--></H1>
27152
27153 This feature, which is only active when
27154 <A HREF="h_config_quote_replace_string"><!--#echo var="VAR_quote-replace-string"--></A> is
27155 also set,
27156 enables quote-replacement on non-flowed messages.  It is off
27157 by default because a non-flowed message is more dependent on its format,
27158 and thus quote-replacement may cause less-than-pleasing results.
27159 Setting this feature will cause quote-replacement similar to that of flowed
27160 messages, but with the added possibility of long lines being wrapped
27161 into new lines if the Quote-Replacement-String is longer than the string
27162 it is replacing, which is &quot;&gt;&nbsp;&quot;.
27163 <P>
27164 &lt;End of help on this topic&gt;
27165 </BODY>
27166 </HTML>
27167 ====== h_config_enable_jump =====
27168 <HTML>
27169 <HEAD>
27170 <TITLE>FEATURE: <!--#echo var="FEAT_enable-jump-shortcut"--></TITLE>
27171 </HEAD>
27172 <BODY>
27173 <H1>FEATURE: <!--#echo var="FEAT_enable-jump-shortcut"--></H1>
27174
27175 When this feature is set you may enter a number (followed by RETURN)
27176 and jump to that message number, when in the MESSAGE INDEX or MESSAGE TEXT
27177 screens.  In other words, it obviates the need for typing the "J" for the
27178 Jump command.
27179 <P>
27180 &lt;End of help on this topic&gt;
27181 </BODY>
27182 </HTML>
27183 ====== h_config_enable_alt_ed =====
27184 <HTML>
27185 <HEAD>
27186 <TITLE>FEATURE: <!--#echo var="FEAT_enable-alternate-editor-cmd"--></TITLE>
27187 </HEAD>
27188 <BODY>
27189 <H1>FEATURE: <!--#echo var="FEAT_enable-alternate-editor-cmd"--></H1>
27190
27191 If this feature is set (the default), and the
27192 <A HREF="h_config_editor">&quot;<!--#echo var="VAR_editor"-->&quot;</A> option
27193 <B>is not</B> set, entering
27194 the ^_ (Ctrl-underscore) key while composing a message will prompt you
27195 for the name of the editor you would like to use.
27196 <P>
27197 If the environment variable $EDITOR is set, its value will be offered as
27198 a default.
27199 <P>
27200 If the <A HREF="h_config_editor">&quot;<!--#echo var="VAR_editor"-->&quot;</A> option
27201 <B>is</B> set, the ^_ key will activate the specified
27202 editor without prompting, in which case it is not necessary to
27203 set the &quot;<!--#echo var="FEAT_enable-alternate-editor-cmd"-->&quot; feature.
27204 <P>
27205 <UL>
27206 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27207 </UL><P>
27208 &lt;End of help on this topic&gt;
27209 </BODY>
27210 </HTML>
27211 ====== h_config_alt_ed_now =====
27212 <HTML>
27213 <HEAD>
27214 <TITLE>FEATURE: <!--#echo var="FEAT_enable-alternate-editor-implicitly"--></TITLE>
27215 </HEAD>
27216 <BODY>
27217 <H1>FEATURE: <!--#echo var="FEAT_enable-alternate-editor-implicitly"--></H1>
27218
27219 If this feature and the <A HREF="h_config_editor">&quot;<!--#echo var="VAR_editor"-->&quot;</A>
27220 variable are both set, Alpine will
27221 automatically activate the specified editor when the cursor is moved from
27222 the header of the message being composed into the message text.  For
27223 replies, the alternate editor will be activated immediately.  If this
27224 feature is set but the &quot;<!--#echo var="VAR_editor"-->&quot; variable is not set, then Alpine will
27225 automatically ask for the name of an alternate editor when the cursor
27226 is moved out of the header being composed, or if a reply is being done.
27227
27228 <P><UL>
27229 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27230 </UL>
27231 <P>
27232 &lt;End of help on this topic&gt;
27233 </BODY>
27234 </HTML>
27235 ====== h_config_enable_bounce =====
27236 <HTML>
27237 <HEAD>
27238 <TITLE>FEATURE: <!--#echo var="FEAT_enable-bounce-cmd"--></TITLE>
27239 </HEAD>
27240 <H1>FEATURE: <!--#echo var="FEAT_enable-bounce-cmd"--></H1>
27241 <BODY>
27242
27243 Setting this feature enables the "B Bounce" command, which will prompt
27244 for an address and *remail* the message to the new recipient.  This command
27245 is used to re-direct messages that you have received in error, or need to
27246 be redirected for some other reason (e.g. list moderation).  The final
27247 recipient will see a header indicating that you have Resent the msg, but
27248 the message's From: header will show the original author of the message,
27249 and replies to it will go back to that author, and not to you.
27250 <P>
27251 &lt;End of help on this topic&gt;
27252 </BODY>
27253 </HTML>
27254 ====== h_config_enable_agg_ops =====
27255 <HTML>
27256 <HEAD>
27257 <TITLE>FEATURE: <!--#echo var="FEAT_enable-aggregate-command-set"--></TITLE>
27258 </HEAD>
27259 <BODY>
27260 <H1>FEATURE: <!--#echo var="FEAT_enable-aggregate-command-set"--></H1>
27261
27262 When this feature is set you may use the commands and subcommands that relate to
27263 performing operations on more than one message at a time.  We call these
27264 &quot;aggregate operations&quot;.  In particular, the
27265 <!--chtml if pinemode="function_key"-->&quot;F5
27266 <!--chtml else-->&quot;;
27267 <!--chtml endif--> Select&quot;,
27268
27269 <!--chtml if pinemode="function_key"-->
27270 &quot;F6
27271 <!--chtml else-->
27272 &quot;A
27273 <!--chtml endif-->
27274 Apply&quot;, and
27275 <!--chtml if pinemode="function_key"-->
27276 &quot;F4
27277 <!--chtml else-->
27278 &quot;Z
27279 <!--chtml endif-->
27280 Zoom&quot; commands are enabled by this feature.  Select is used to
27281 &quot;tag&quot; one or more messages meeting the specified criteria.  Apply can
27282 then be used to apply any message command to all of the selected/tagged
27283 messages.  Further, the Zoom command allows you to toggle the MESSAGE INDEX
27284 view between just those Selected and all messages in the folder.
27285 <P>
27286 This feature also enables the
27287 <!--chtml if pinemode="function_key"-->
27288 &quot;F7&quot;
27289 <!--chtml else-->
27290 &quot;^X&quot;
27291 <!--chtml endif-->
27292
27293 subcommand in the MESSAGE INDEX
27294 WhereIs command that causes all messages matching the WhereIs argument to
27295 become selected; and the Select, Select Current, and ZoomMode commands in the
27296 <A HREF="h_folder_maint">FOLDER LIST screen</A>.
27297 <P>
27298 Some related help topics are
27299 <UL>
27300 <LI> <A HREF="h_mainhelp_aggops">Aggregate Operations</A>
27301 <LI> <A HREF="h_index_cmd_select">Selecting: Select and WhereIs/Select</A>,
27302 <LI> <A HREF="h_config_auto_unzoom"><!--#echo var="FEAT_auto-unzoom-after-apply"--></A>,
27303 <LI> <A HREF="h_config_auto_unselect"><!--#echo var="FEAT_auto-unselect-after-apply"--></A>.
27304 <LI> <A HREF="h_config_auto_zoom"><!--#echo var="FEAT_auto-zoom-after-select"--></A>, and
27305 <LI> <A HREF="h_config_select_wo_confirm"><!--#echo var="FEAT_select-without-confirm"--></A>.
27306 </UL>
27307 <P>
27308 <UL>
27309 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27310 </UL><P>
27311 &lt;End of help on this topic&gt;
27312 </BODY>
27313 </HTML>
27314
27315 ====== h_config_enable_flag =====
27316 <HTML>
27317 <HEAD>
27318 <TITLE>FEATURE: <!--#echo var="FEAT_enable-flag-cmd"--></TITLE>
27319 </HEAD>
27320 <BODY>
27321 <H1>FEATURE: <!--#echo var="FEAT_enable-flag-cmd"--></H1>
27322
27323 Setting this feature enables the
27324 <A HREF="h_common_flag">&quot;* Flag&quot;</A>
27325 command that allows you to
27326 manipulate the status flags associated with a message.  By default, Flag
27327 will set the "Important" flag, which results in an asterisk being
27328 displayed in column one of the MESSAGE INDEX for such messages.
27329 <P>
27330 &lt;End of help on this topic&gt;
27331 </BODY>
27332 </HTML>
27333 ====== h_config_flag_screen_default =====
27334 <HTML>
27335 <HEAD>
27336 <TITLE>FEATURE: <!--#echo var="FEAT_enable-flag-screen-implicitly"--></TITLE>
27337 </HEAD>
27338 <BODY>
27339 <H1>FEATURE: <!--#echo var="FEAT_enable-flag-screen-implicitly"--></H1>
27340
27341 The feature modifies the behavior of the
27342 <a href="h_common_flag">Flag</a>
27343 command (provided it too is
27344 <A HREF="h_config_enable_flag">enabled</A>).
27345 By default, when the "* Flag" command is selected,
27346 Alpine offers a prompt to set one of several flags and also offers the
27347 option of entering the detailed flag manipulation screen via the "^T"
27348 key. Enabling this feature causes Alpine to immediately enter the detailed
27349 flag screen rather than first offer the simple prompt.
27350 The
27351 <A HREF="h_config_flag_screen_kw_shortcut"><!--#echo var="FEAT_enable-flag-screen-keyword-shortcut"--></A> option offers a slightly different way of setting keywords.
27352 <P>
27353 &lt;End of help on this topic&gt;
27354 </BODY>
27355 </HTML>
27356 ====== h_config_flag_screen_kw_shortcut =====
27357 <HTML>
27358 <HEAD>
27359 <TITLE>FEATURE: <!--#echo var="FEAT_enable-flag-screen-keyword-shortcut"--></TITLE>
27360 </HEAD>
27361 <BODY>
27362 <H1>FEATURE: <!--#echo var="FEAT_enable-flag-screen-keyword-shortcut"--></H1>
27363
27364 This feature modifies the behavior of the
27365 <a href="h_common_flag">Flag</a> command
27366 and the <A HREF="h_index_cmd_select">Select</A> command.
27367 This feature is set by default.
27368 When this feature is not set, when the "* Flag" command is selected,
27369 Alpine offers a prompt to set one of several flags and also offers the
27370 option of entering the detailed flag manipulation screen via the "^T"
27371 key.
27372 If you have
27373 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>
27374 defined, then enabling this feature adds a shortcut way to set or unset
27375 keywords.
27376 You use &quot;*&quot; followed by the first letter of a keyword (or the nickname of
27377 a keyword if you've given it a nickname) and that will set the keyword.
27378 <P>
27379 An example is easier to understand than the explanation.
27380 The flag command can always be used to set the system flags.
27381 For example, to set the Answered flag you would type
27382 <P>
27383 <CENTER><SAMP>* A</SAMP></CENTER>
27384 <P>
27385 Now suppose you have defined a keyword &quot;Work&quot; using the <!--#echo var="VAR_keywords"-->
27386 option in the Config screen.
27387 By default, to set a keyword like &quot;Work&quot; you would usually
27388 have to go to the Flag Details screen using
27389 the &quot;^T To Flag Details&quot; command.
27390 Instead, if you have enabled this feature, you may type
27391 <P>
27392 <CENTER><SAMP>* W</SAMP></CENTER>
27393 <P>
27394 to set the Work flag, or
27395 <P>
27396 <CENTER><SAMP>* ! W</SAMP></CENTER>
27397 <P>
27398 to unset it.
27399 Just like for the other flag setting commands, the case of the letter does
27400 not matter, so &quot;w&quot; or &quot;W&quot; both set the &quot;Work&quot;
27401 keyword.
27402 <P>
27403 Notice that you can only use this trick for one keyword that begins
27404 with &quot;W&quot;.
27405 If you happen to have a &quot;Work&quot; keyword and another keyword that is
27406 &quot;WIFI&quot; the &quot;* W&quot; command will set the first one in
27407 your list of keywords.
27408 Also, there are five letters that are reserved for system
27409 flags and the NOT command.
27410 If you type &quot;* A&quot; it will always set the Answered flag, not
27411 your &quot;Aardvark&quot; keyword.
27412 In order to set the &quot;Aardvark&quot; keyword you'll still have to use
27413 the Flag Details screen.
27414 <P>
27415 Because enabling the
27416 <A HREF="h_config_flag_screen_default"><!--#echo var="FEAT_enable-flag-screen-implicitly"--></A>
27417 option causes Alpine to skip directly to the Flag Details screen when the
27418 Flag command is used,
27419 setting it will cause this feature to have no effect at all.
27420 <P>
27421 Similarly, when Selecting by Keyword, setting this option will allow you
27422 to use Keyword initials instead of full keywords.
27423 <P>
27424 &lt;End of help on this topic&gt;
27425 </BODY>
27426 </HTML>
27427 ====== h_config_can_suspend =====
27428 <HTML>
27429 <HEAD>
27430 <TITLE>FEATURE: <!--#echo var="FEAT_enable-suspend"--></TITLE>
27431 </HEAD>
27432 <BODY>
27433 <H1>FEATURE: <!--#echo var="FEAT_enable-suspend"--></H1>
27434
27435 Setting this feature will allow you to type ^Z (Control Z) to
27436 <!--chtml if pinemode="os_windows"-->
27437 minimize Alpine into its icon, bringing into focus whatever
27438 application is running behind the PC-Alpine window.
27439 <!--chtml else-->
27440 temporarily suspend Alpine.
27441
27442 <P>
27443 This does not exit Alpine, but puts it in the background to watch
27444 for new mail and such.  Normally, you type a command, such
27445 as &quot;fg&quot; at your system prompt to return to your Alpine session.
27446
27447 <P>
27448 The <A HREF="h_config_suspend_spawns"><!--#echo var="FEAT_use-subshell-for-suspend"--></A> feature
27449 adjusts whether Alpine is placed into the background of the shell its
27450 running in or starts a news shell.
27451 <!--chtml endif-->
27452
27453 <P>
27454 <UL>
27455 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27456 </UL><P>
27457 &lt;End of help on this topic&gt;
27458 </BODY>
27459 </HTML>
27460 ====== h_config_take_lastfirst ======
27461 <HTML>
27462 <HEAD>
27463 <TITLE>FEATURE: <!--#echo var="FEAT_disable-take-last-comma-first"--></TITLE>
27464 </HEAD>
27465 <BODY>
27466 <H1>FEATURE: <!--#echo var="FEAT_disable-take-last-comma-first"--></H1>
27467
27468 Normally, when TakeAddr is used to copy an address from a message into
27469 an address book entry, Alpine will attempt to rewrite the full name of the
27470 address in the form
27471 <P>
27472
27473 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Last, First<P>
27474
27475 instead of<P>
27476
27477 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;First Last
27478
27479 <P>
27480 It does this because many people find it useful to sort by Last name
27481 instead of First name.  If this feature is set, then the TakeAddr command
27482 will not attempt to reverse the name in this manner.
27483 <P>
27484 &lt;End of help on this topic&gt;
27485 </BODY></HTML>
27486 ====== h_config_disable_regex ======
27487 <HTML>
27488 <HEAD>
27489 <TITLE>FEATURE: <!--#echo var="FEAT_disable-regular-expression-matching-for-alternate-addresses"--></TITLE>
27490 </HEAD>
27491 <BODY>
27492 <H1>FEATURE: <!--#echo var="FEAT_disable-regular-expression-matching-for-alternate-addresses"--></H1>
27493
27494 Normally, the
27495 <a href="h_config_alt_addresses"><!--#echo var="VAR_alt-addresses"--></a>
27496 option is interpreted as a regular expression.
27497 One type of address that might cause trouble is an address that
27498 contains a plus sign.
27499 If you want to have an address with a plus as one of your
27500 <!--#echo var="VAR_alt-addresses"-->
27501 and you don't want to use regular expressions, then setting this
27502 feature will cause Alpine to treat the addresses you list literally instead.
27503 <P>
27504 &lt;End of help on this topic&gt;
27505 </BODY></HTML>
27506 ====== h_config_take_fullname ======
27507 <HTML>
27508 <HEAD>
27509 <TITLE>FEATURE: <!--#echo var="FEAT_disable-take-fullname-in-addresses"--></TITLE>
27510 </HEAD>
27511 <BODY>
27512 <H1>FEATURE: <!--#echo var="FEAT_disable-take-fullname-in-addresses"--></H1>
27513
27514 Normally, when TakeAddr is used to copy an address or addresses
27515 from a message into an address book entry, Alpine will try to preserve
27516 the full name associated with each address in the list of addresses.
27517 The reason for this is so that if the entry is a list or later becomes a
27518 list, then information about the individual addresses in the list
27519 is preserved.
27520 If you would rather just have the simple addresses in the list of addresses,
27521 set this feature. For example, with the default setting you might
27522 see something like this in the ADDRESS BOOK editor after you type TakeAddr
27523 <P>
27524 <PRE>
27525  Nickname  : nick
27526  Fullname  : Bedrock Elders
27527  Fcc       :
27528  Comment   :
27529  Addresses : Fred Flintstone &lt;flint@bedrock.org&gt;,
27530              Barney Rubble &lt;rubble@bedrock.org&gt;
27531 </PRE>
27532 <P>
27533 but with this feature set it would look like
27534 <P>
27535 <PRE>
27536  Nickname  : nick
27537  Fullname  : Bedrock Elders
27538  Fcc       :
27539  Comment   :
27540  Addresses : flint@bedrock.org,
27541              rubble@bedrock.org
27542 </PRE>
27543 <P>
27544 instead. Note the difference in the Addresses field.
27545 <P>
27546 &lt;End of help on this topic&gt;
27547 </BODY></HTML>
27548 ====== h_config_print_from ======
27549 <HTML>
27550 <HEAD>
27551 <TITLE>FEATURE: <!--#echo var="FEAT_print-includes-from-line"--></TITLE>
27552 </HEAD>
27553 <BODY>
27554 <H1>FEATURE: <!--#echo var="FEAT_print-includes-from-line"--></H1>
27555
27556 If this feature is set, then the Berkeley-mail style From line is included
27557 at the start of each message that is printed.  This line looks something
27558 like the following, with the address replaced by the address from the
27559 From line of the message being printed:
27560 <P>
27561 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;From user@domain.somewhere.com Mon May 13
27562 14:11:06 1998
27563 <P>
27564 &lt;End of help on this topic&gt;
27565 </BODY>
27566 </HTML>
27567 ====== h_config_expanded_distlists ======
27568 <HTML>
27569 <HEAD>
27570 <TITLE>FEATURE: <!--#echo var="FEAT_expanded-view-of-distribution-lists"--></TITLE>
27571 </HEAD>
27572 <BODY>
27573 <H1>FEATURE: <!--#echo var="FEAT_expanded-view-of-distribution-lists"--></H1>
27574 If this feature is set, then distribution lists in the address book
27575 screen will always be expanded automatically.
27576 <P>
27577 &lt;End of help on this topic&gt;
27578 </BODY>
27579 </HTML>
27580 ====== h_config_compose_news_wo_conf ======
27581 <HTML>
27582 <HEAD>
27583 <TITLE>FEATURE: <!--#echo var="FEAT_compose-sets-newsgroup-without-confirm"--></TITLE>
27584 </HEAD>
27585 <BODY>
27586 <H1>FEATURE: <!--#echo var="FEAT_compose-sets-newsgroup-without-confirm"--></H1>
27587 This feature controls one aspect of Alpine's Composer.  If you enter the
27588 composer while reading a newsgroup, you will normally be prompted to
27589 determine whether you intend the new message to be posted to the current
27590 newsgroup or not.  If this feature is set, Alpine will not prompt you
27591 in this situation, and will assume that you do indeed wish to post
27592 to the newsgroup you are reading.
27593 <P>
27594 &lt;End of help on this topic&gt;
27595 </BODY>
27596 </HTML>
27597 ====== h_config_compose_rejects_unqual ======
27598 <HTML>
27599 <HEAD>
27600 <TITLE>FEATURE: <!--#echo var="FEAT_compose-rejects-unqualified-addrs"--></TITLE>
27601 </HEAD>
27602 <BODY>
27603 <H1>FEATURE: <!--#echo var="FEAT_compose-rejects-unqualified-addrs"--></H1>
27604
27605 This feature controls one aspect of the message composer; in particular,
27606 what happens when an unqualified name is entered into an address header.
27607 If set, unqualified names entered as addresses will be treated as errors
27608 unless they match an addressbook nickname.  Alpine will not attempt to turn
27609 them into complete addresses by adding your local domain.<P>
27610
27611 A complete (fully qualified) address is one containing a username followed
27612 by an &quot;@&quot; (&quot;at&quot;) symbol, followed by a domain name (e.g.
27613 &quot;jsmith@example.com&quot;).  An unqualified name is one <B>without</B>
27614 the &quot;@&quot; symbol and domain name (e.g. &quot;jsmith&quot;).
27615
27616 (See also <A HREF="h_address_format">Explanation of Address formats</A>.)
27617
27618 <P>
27619
27620 When you enter a fully qualified address, Alpine does not interpret or
27621 modify it, but simply passes it on to the mail-transport-agent (MTA) for
27622 your system.  Alpine conforms to the Internet standards governing message
27623 headers and will not send an unqualifed name to the MTA.  Therefore, when
27624 you enter an unqualified name, Alpine will normally attempt to turn it into
27625 a fully qualified address, first by checking to see if you have entered a
27626 matching nickname in your addressbook, or failing that, by simply adding
27627 your own domain to the name entered.  So if your address is
27628 &quot;jsmith@example.com&quot; and you enter &quot;fred&quot;, then (assuming
27629 &quot;fred&quot; is not a nickname in your addressbook), Alpine will turn
27630 that into &quot;fred@example.com&quot;.<P>
27631
27632 There are situations where it is not desirable for Alpine to interpret such
27633 unqualified names as valid (local) addresses.  For example, if &quot;fred&quot;
27634 turned out to be a typo (intended to be an addressbook nickname), but
27635 there actually was a &quot;fred&quot; in your local domain, the message might
27636 be mis-delivered without your realizing it.  In order to reduce the likelihood
27637 of such accidents, setting this feature will cause Alpine to treat such
27638 addresses as errors, and require that you explicitly enter the full local
27639 address (e.g. &quot;fred@example.com&quot;) or correct the name so that it
27640 matches an address book nickname.<P>
27641
27642 Consider this a safety feature against mis-directed mail.
27643 <P>
27644 <UL>
27645 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27646 </UL><P>
27647 &lt;End of help on this topic&gt;
27648 </BODY>
27649 </HTML>
27650 ====== h_config_quell_local_lookup ======
27651 <HTML>
27652 <HEAD>
27653 <TITLE>FEATURE: <!--#echo var="FEAT_quell-user-lookup-in-passwd-file"--></TITLE>
27654 </HEAD>
27655 <BODY>
27656 <H1>FEATURE: <!--#echo var="FEAT_quell-user-lookup-in-passwd-file"--></H1>
27657
27658 This feature controls an aspect of Alpine's Composer, and if needed, will
27659 usually be set by your system manager in Alpine's system-wide configuration
27660 file. Specifically, if this feature is set, Alpine will not attempt to look
27661 in the system password file to find a Full Name for the entered address.
27662 <P>
27663 Normally, names you enter into address fields (e.g. To: or Cc:) are
27664 checked against your address book(s) to see if they match an address book
27665 nickname.  Failing that, (in Unix Alpine) the name is then checked against
27666 the Unix password file.  If the entered name matches a username in the
27667 system password file, Alpine extracts the corresponding Full Name information
27668 for that individual, and adds that to the address being entered.
27669 <P>
27670 However, password file matching can have surprising (incorrect) results if
27671 other users of the system do not receive mail at the domain you are using.
27672 That is, if either the
27673 <A HREF="h_config_user_dom">&quot;<!--#echo var="VAR_user-domain"-->&quot;</A> or
27674 <A HREF="h_config_domain_name">&quot;<!--#echo var="VAR_use-only-domain-name"-->&quot;</A>
27675 option
27676 is set such that the administrative domain of other users on the system
27677 isn't accurately reflected, Alpine should be told that a passwd file match
27678 is coincidental, and Full Name info will be incorrect.  For example, a
27679 personal name from the password file could get falsely paired with the
27680 entered name as it is turned into an address in the configured domain.
27681 <P>
27682 If you are seeing this behavior, enabling this feature will prevent Unix
27683 Alpine from looking up names in the password file to find the Full Name
27684 for incomplete addresses you enter.<P>
27685 <UL>
27686 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27687 </UL>
27688 <P>
27689 &lt;End of help on this topic&gt;
27690 </BODY>
27691 </HTML>
27692 ====== h_config_tab_checks_recent ======
27693 <HTML>
27694 <HEAD>
27695 <TITLE>FEATURE: <!--#echo var="FEAT_tab-checks-recent"--></TITLE>
27696 </HEAD>
27697 <BODY>
27698 <H1>FEATURE: <!--#echo var="FEAT_tab-checks-recent"--></H1>
27699
27700 In a FOLDER LIST screen, the TAB key usually just changes which
27701 folder is highlighted.
27702 If this feature is set, then the TAB key will cause the number of
27703 recent messages and the total number of messages in the highlighted folder
27704 to be displayed instead.
27705
27706 <P>
27707 &lt;End of help on this topic&gt;
27708 </BODY>
27709 </HTML>
27710 ====== h_config_maildrops_preserve_state ======
27711 <HTML>
27712 <HEAD>
27713 <TITLE>FEATURE: <!--#echo var="FEAT_maildrops-preserve-state"--></TITLE>
27714 </HEAD>
27715 <BODY>
27716 <H1>FEATURE: <!--#echo var="FEAT_maildrops-preserve-state"--></H1>
27717
27718 This feature affects the way <A HREF="h_maildrop">Mail Drops</A> work.
27719 Normally, when mail is moved from a Mail Drop folder to a destination
27720 folder, it is delivered as new mail.
27721 Any Seen/New, Answered, Important/Flagged state that has changed will be
27722 ignored.
27723 All of the mail will be considered unSeen, unAnswered, and unImportant after
27724 it is moved.
27725 <P>
27726 If this feature is set, then the state changes that have been made
27727 to the messages in the Mail Drop folder will be preserved.
27728 <P>
27729 In any case, messages that are already marked Deleted when the
27730 mail is to be moved from the Mail Drop will be ignored.
27731 <P>
27732 &lt;End of help on this topic&gt;
27733 </BODY>
27734 </HTML>
27735 ====== h_config_preopen_stayopens ======
27736 <HTML>
27737 <HEAD>
27738 <TITLE>FEATURE: <!--#echo var="FEAT_preopen-stayopen-folders"--></TITLE>
27739 </HEAD>
27740 <BODY>
27741 <H1>FEATURE: <!--#echo var="FEAT_preopen-stayopen-folders"--></H1>
27742
27743 This feature is related to the option
27744 <A HREF="h_config_permlocked">&quot;<!--#echo var="VAR_stay-open-folders"-->&quot;</A>.
27745 Normally, Stay Open folders are only opened on demand, when the user
27746 asks to open them.
27747 From then on they are kept open for the duration of the session.
27748 However, if this feature is set, then the Stay Open folders will all be
27749 opened at startup, at the same time that the INBOX is opened.
27750
27751 <P>
27752 &lt;End of help on this topic&gt;
27753 </BODY>
27754 </HTML>
27755 ====== h_config_expunge_inbox ======
27756 <HTML>
27757 <HEAD>
27758 <TITLE>FEATURE: <!--#echo var="FEAT_offer-expunge-of-inbox"--></TITLE>
27759 </HEAD>
27760 <BODY>
27761 <H1>FEATURE: <!--#echo var="FEAT_offer-expunge-of-inbox"--></H1>
27762
27763 The INBOX is normally treated differently from regular folders in several
27764 ways.
27765 One of the differences is that the normal &quot;close&quot; sequence of
27766 events is deferred until Alpine is exited, instead of happening when you
27767 leave the INBOX to view another folder.
27768 The &quot;close&quot; sequence normally includes the Expunging
27769 of deleted messages
27770 (either automatically or after a prompt, controlled by the features
27771 <A HREF="h_config_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm"-->&quot;</A>,
27772 <A HREF="h_config_full_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm-everywhere"-->&quot;</A>, and
27773 <A HREF="h_config_expunge_manually"><!--#echo var="FEAT_expunge-only-manually"--></A>), and the
27774 handling of the
27775 <A HREF="h_config_read_message_folder"><!--#echo var="VAR_read-message-folder"--></A>.
27776
27777 <P>
27778 If this feature is set the &quot;close&quot; sequence handling will take
27779 place every time you leave the INBOX.
27780 The INBOX will still be kept open, but the offer to Expunge and the archiving
27781 to the <!--#echo var="VAR_read-message-folder"-->
27782 will take place each time you leave the INBOX instead of only once at the
27783 end of the session.
27784
27785 <P>
27786 &lt;End of help on this topic&gt;
27787 </BODY>
27788 </HTML>
27789 ====== h_config_expunge_stayopens ======
27790 <HTML>
27791 <HEAD>
27792 <TITLE>FEATURE: <!--#echo var="FEAT_offer-expunge-of-stayopen-folders"--></TITLE>
27793 </HEAD>
27794 <BODY>
27795 <H1>FEATURE: <!--#echo var="FEAT_offer-expunge-of-stayopen-folders"--></H1>
27796
27797 This feature is related to the option
27798 <A HREF="h_config_permlocked">&quot;<!--#echo var="VAR_stay-open-folders"-->&quot;</A>.
27799 Stay Open folders are treated differently from regular folders in several
27800 ways.
27801 One of the differences is that the normal &quot;close&quot; sequence of
27802 events is deferred until Alpine is exited, instead of happening when you
27803 leave the folder to view another folder.
27804 The &quot;close&quot; sequence normally includes the Expunging
27805 of deleted messages
27806 (either automatically or after a prompt, controlled by the features
27807 <A HREF="h_config_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm"-->&quot;</A>,
27808 <A HREF="h_config_full_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm-everywhere"-->&quot;</A>, and
27809 <A HREF="h_config_expunge_manually"><!--#echo var="FEAT_expunge-only-manually"--></A>), and the
27810 handling of
27811 <A HREF="h_config_archived_folders"><!--#echo var="VAR_incoming-archive-folders"--></A>.
27812
27813 <P>
27814 If this feature is set the &quot;close&quot; sequence handling will take
27815 place when you leave the Stay Open folder.
27816 The folder will still be kept open, but the offer to Expunge and the archiving
27817 will take place each time you leave the folder instead of only once at the
27818 end of the session.
27819 This feature does not affect the INBOX, which will still only be processed
27820 when you exit Alpine.
27821 However, there is a similar feature that affects only the INBOX called
27822 <A HREF="h_config_expunge_inbox">&quot;<!--#echo var="FEAT_offer-expunge-of-inbox"-->&quot;</A>.
27823
27824 <P>
27825 &lt;End of help on this topic&gt;
27826 </BODY>
27827 </HTML>
27828 ====== h_config_preserve_start_stop ======
27829 <HTML>
27830 <HEAD>
27831 <TITLE>FEATURE: <!--#echo var="FEAT_preserve-start-stop-characters"--></TITLE>
27832 </HEAD>
27833 <BODY>
27834 <H1>FEATURE: <!--#echo var="FEAT_preserve-start-stop-characters"--></H1>
27835
27836 This feature controls how special control key characters, typically
27837 Ctrl-S and Ctrl-Q, are interpreted when input to Alpine.  These characters
27838 are known as the "stop" and "start" characters and are sometimes used in
27839 communications paths to control data flow between devices that operate at
27840 different speeds.
27841
27842 <P>
27843
27844 By default, Alpine turns the system's handling of these special characters
27845 off except during printing.  However, if you see Alpine reporting input errors
27846 such as:
27847 <P>
27848 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[ Command "^Q" not defined for this screen.]
27849 <P>
27850 and, at the same time, see your display become garbled, then it is likely
27851 that setting this option will solve the problem.  Be aware, though, that
27852 enabling this feature will also cause Alpine to ostensibly "hang"
27853 whenever the Ctrl-S key combination is entered as the system is now
27854 interpreting such input as a "stop output" command.  To "start
27855 output"  again, simply type Ctrl-Q.
27856 <P>
27857 &lt;End of help on this topic&gt;
27858 </BODY>
27859 </HTML>
27860 ====== h_config_enable_incoming ======
27861 <HTML>
27862 <HEAD>
27863 <TITLE>FEATURE: <!--#echo var="FEAT_enable-incoming-folders"--></TITLE>
27864 </HEAD>
27865 <BODY>
27866 <H1>FEATURE: <!--#echo var="FEAT_enable-incoming-folders"--></H1>
27867
27868 Alpine's Incoming Message Folders collection
27869 provides a convenient way to access multiple incoming folders.
27870 It is also useful if you have accounts on multiple computers.
27871 <P>
27872
27873 If set, this feature defines a pseudo-folder collection called
27874 &quot;INCOMING MESSAGE FOLDERS&quot;.  Initially, the only folder included
27875 in this collection will be your INBOX, which will no longer show up in
27876 your Default folder collection.
27877 <P>
27878
27879 You may add more folders to the Incoming Message Folders collection by
27880 using the
27881 <!--chtml if pinemode="function_key"-->
27882 &quot;F10
27883 <!--chtml else-->
27884 &quot;A
27885 <!--chtml endif-->
27886 Add&quot; command in the FOLDER LIST screen.  You will be prompted for
27887 the host the folder is stored on (which defaults to the same host used
27888 for your INBOX), a nickname, and the actual folder name.  Once a set
27889 of Incoming Message Folders are defined, the TAB key (in MESSAGE INDEX
27890 or MESSAGE TEXT screens) may be used to scan the folders for those
27891 with Recent messages.  If you add more folders to
27892 your <!--#echo var="VAR_incoming-folders"--> collection, turning this feature back off will have
27893 no effect.
27894 <P>
27895 NOTE: Normally the software that actually delivers mail (the stuff that happens
27896 before Alpine is involved) is in a better position to do delivery filtering
27897 than is Alpine itself.
27898 If possible, you may want to look at programs such as
27899 &quot;filter&quot; or &quot;procmail&quot;, which are examples of delivery
27900 filtering programs.
27901 If you'd prefer to have Alpine do the filtering for you, you may set that
27902 up.
27903 Look <A HREF="h_rules_filter">here</A> for help with Alpine filtering.
27904 <P>
27905 <UL>
27906 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27907 </UL><P>
27908 &lt;End of help on this topic&gt;
27909 </BODY>
27910 </HTML>
27911 ====== h_config_enable_incoming_checking ======
27912 <HTML>
27913 <HEAD>
27914 <TITLE>FEATURE: <!--#echo var="FEAT_enable-incoming-folders-checking"--></TITLE>
27915 </HEAD>
27916 <BODY>
27917 <H1>FEATURE: <!--#echo var="FEAT_enable-incoming-folders-checking"--></H1>
27918
27919 This feature is only operational if you have enabled the optional
27920 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A> collection.
27921 If you do have Incoming Message Folders and you also set this feature,
27922 then the number of Unseen messages in each folder will be displayed
27923 in the FOLDER LIST screen for the Incoming Message Folders.
27924 The number of Unseen messages in a folder will be displayed in parentheses
27925 to the right of the name of each folder.
27926 If there are no Unseen messages in a folder then only the name
27927 is displayed, not a set of parentheses with zero inside them.
27928 A redraw command, Ctrl-L, can be used in the FOLDER LIST screen for
27929 the Incoming Message Folders to cause an immediate update.
27930 <P>
27931 If a check for Unseen messages fails for a particular folder then Alpine
27932 will no longer attempt to check that folder for the duration of the
27933 session and this will be indicated by a question mark inside the
27934 parentheses.
27935 <P>
27936 The features
27937 <A HREF="h_config_incoming_checking_total"><!--#echo var="FEAT_incoming-checking-includes-total"--></A>,
27938 <A HREF="h_config_incoming_checking_recent"><!--#echo var="FEAT_incoming-checking-uses-recent"--></A>,
27939 <A HREF="h_config_incoming_list"><!--#echo var="VAR_incoming-check-list"--></A>,
27940 <A HREF="h_config_incoming_interv"><!--#echo var="VAR_incoming-check-interval"--></A>,
27941 <A HREF="h_config_incoming_second_interv"><!--#echo var="VAR_incoming-check-interval-secondary"--></A>, and
27942 <A HREF="h_config_incoming_timeo"><!--#echo var="VAR_incoming-check-timeout"--></A>
27943 all affect how this feature behaves.
27944 <P>
27945 <UL>
27946 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27947 </UL><P>
27948 &lt;End of help on this topic&gt;
27949 </BODY>
27950 </HTML>
27951 ====== h_config_incoming_checking_total ======
27952 <HTML>
27953 <HEAD>
27954 <TITLE>FEATURE: <!--#echo var="FEAT_incoming-checking-includes-total"--></TITLE>
27955 </HEAD>
27956 <BODY>
27957 <H1>FEATURE: <!--#echo var="FEAT_incoming-checking-includes-total"--></H1>
27958
27959 This option has no effect unless the feature
27960 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
27961 is set, which in turn has no effect unless
27962 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
27963 is set.
27964 <P>
27965 When incoming folder checking is turned on the default is to display
27966 the number of unseen messages in each folder.
27967 More precisely, it is the number of undeleted unseen messages.
27968 Using this option you may also display the total number of messages
27969 in each folder.
27970 Instead of a single number representing the number of unseen messages
27971 you will get two numbers separated by a slash character.
27972 The first is the number of unseen messages and the second is the
27973 total number of messages.
27974 <P>
27975 You may also use the recent message count instead of the unseen message
27976 count by turning on the feature
27977 <A HREF="h_config_incoming_checking_recent"><!--#echo var="FEAT_incoming-checking-uses-recent"--></A>.
27978 <P>
27979 <UL>
27980 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27981 </UL><P>
27982 &lt;End of help on this topic&gt;
27983 </BODY>
27984 </HTML>
27985 ====== h_config_incoming_checking_recent ======
27986 <HTML>
27987 <HEAD>
27988 <TITLE>FEATURE: <!--#echo var="FEAT_incoming-checking-uses-recent"--></TITLE>
27989 </HEAD>
27990 <BODY>
27991 <H1>FEATURE: <!--#echo var="FEAT_incoming-checking-uses-recent"--></H1>
27992
27993 This option has no effect unless the feature
27994 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
27995 is set, which in turn has no effect unless
27996 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
27997 is set.
27998 <P>
27999 When incoming folder checking is turned on the default is to display
28000 the number of unseen messages in each folder.
28001 More precisely, it is the number of undeleted unseen messages.
28002 Using this option you may display the number of recent messages instead
28003 of the number of unseen messages.
28004 A message is only counted as recent if this is the first session to
28005 see it, so the recent count might be less than the unseen count.
28006 The difference between the two would be accounted for by the unseen messages
28007 in the folder which were there previously but have not been looked at yet.
28008 <P>
28009 If you simultaneously run more than one email client at a time
28010 (for example, you run more than one Alpine in parallel) then turning
28011 this feature on can cause some confusion.
28012 The confusion stems from the fact that each message is only considered to be
28013 recent in one session.
28014 That means that the counts of new messages may be different in the two
28015 Alpines running side by side, because each incoming message will only be
28016 counted as recent in one of the two sessions.
28017 <P>
28018 You may also display the total number of messages
28019 in each folder by using the
28020 <A HREF="h_config_incoming_checking_total"><!--#echo var="FEAT_incoming-checking-includes-total"--></A>
28021 option.
28022 <P>
28023 <UL>
28024 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28025 </UL><P>
28026 &lt;End of help on this topic&gt;
28027 </BODY>
28028 </HTML>
28029 ====== h_config_attach_in_reply ======
28030 <HTML>
28031 <HEAD>
28032 <TITLE>FEATURE: <!--#echo var="FEAT_include-attachments-in-reply"--></TITLE>
28033 </HEAD>
28034 <BODY>
28035 <H1>FEATURE: <!--#echo var="FEAT_include-attachments-in-reply"--></H1>
28036
28037 This feature controls an aspect of Alpine's Reply command. If set, any MIME
28038 attachments that were part of the original message will automatically be
28039 included in the Reply.
28040 <P>
28041 &lt;End of help on this topic&gt;
28042 </BODY>
28043 </HTML>
28044 ====== h_config_include_header =====
28045 <HTML>
28046 <HEAD>
28047 <TITLE>FEATURE: <!--#echo var="FEAT_include-header-in-reply"--></TITLE>
28048 </HEAD>
28049 <BODY>
28050 <H1>FEATURE: <!--#echo var="FEAT_include-header-in-reply"--></H1>
28051
28052 This feature controls an aspect of Alpine's Reply command. If set, and the
28053 original message is being included in the reply, then headers from that
28054 message will also be part of the reply.
28055 <P>
28056 &lt;End of help on this topic&gt;
28057 </HEAD>
28058 </HTML>
28059 ====== h_config_sig_at_bottom =====
28060 <HTML>
28061 <HEAD>
28062 <TITLE>FEATURE: <!--#echo var="FEAT_signature-at-bottom"--></TITLE>
28063 </HEAD>
28064 <BODY>
28065 <H1>FEATURE: <!--#echo var="FEAT_signature-at-bottom"--></H1>
28066
28067 This feature controls an aspect of Alpine's Reply command.  If this feature
28068 is set, and the original message is being included in the reply, then the
28069 contents of your signature file (if any) will be inserted after the included
28070 message.
28071 <P>
28072 This feature does not affect the results of a Forward command.
28073 <P>
28074 &lt;End of help on this topic&gt;
28075 </BODY>
28076 </HTML>
28077 ====== h_config_sigdashes =====
28078 <HTML>
28079 <HEAD>
28080 <TITLE>FEATURE: <!--#echo var="FEAT_enable-sigdashes"--></TITLE>
28081 </HEAD>
28082 <BODY>
28083 <H1>FEATURE: <!--#echo var="FEAT_enable-sigdashes"--></H1>
28084
28085 This feature enables support for the common USENET news convention
28086 of preceding a message signature with the special line consisting of
28087 the three characters &quot;--&nbsp;&quot; (i.e., dash, dash, and space).
28088
28089 <P>
28090 When enabled and a
28091 &quot;<A HREF="h_config_signature_file"><!--#echo var="VAR_signature-file"--></A>&quot; exists,
28092 Alpine will insert the special line before including the file's text (unless
28093 the special line already exists somewhere in the file's text).
28094
28095 <P>
28096 In addition, when you Reply or Followup to a message containing one of
28097 these special lines and choose to include its text, Alpine will observe
28098 the convention of not including text beyond the special line in your
28099 reply.
28100 If <A HREF="h_config_enable_full_hdr">&quot;Full Header&quot;</A>
28101 mode is enabled and turned on, then Alpine <EM>will</EM>
28102 include the text beyond the special line regardless of the setting of
28103 this feature.
28104
28105 <P>
28106 See also &quot;<a href="h_config_strip_sigdashes"><!--#echo var="FEAT_strip-from-sigdashes-on-reply"--></a>&quot;
28107 for a related feature.
28108
28109 <P>
28110 <UL>
28111 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28112 </UL><P>
28113 &lt;End of help on this topic&gt;
28114 </BODY>
28115 </HTML>
28116 ====== h_config_new_thread_blank_subject =====
28117 <HTML>
28118 <HEAD>
28119 <TITLE>FEATURE: <!--#echo var="FEAT_new-thread-on-blank-subject"--></TITLE>
28120 </HEAD>
28121 <BODY>
28122 <H1>FEATURE: <!--#echo var="FEAT_new-thread-on-blank-subject"--></H1>
28123
28124 When this feature is enabled (the default) Alpine will create a new thread
28125 every time that the subject line becomes empty at any time during composition.
28126
28127 <P>
28128 This behavior is particularly useful in case you are replying to a message.
28129 Replying to a message causes the message to be in the same thread than the
28130 original message that is being replied to. However, many authors want to create
28131 a new message (in a different thread) while replying to a message, and they do
28132 this by changing the full subject, by first deleting the original subject and
28133 typing the new subject of the current message.
28134
28135 <P>
28136 Enabling this feature causes that any time that the subject is deleted, the
28137 message being composed will be considered the first message of a new thread.
28138
28139 <P>
28140 <UL>
28141 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28142 </UL><P>
28143 &lt;End of help on this topic&gt;
28144 </BODY>
28145 </HTML>
28146 ====== h_config_strip_sigdashes =====
28147 <HTML>
28148 <HEAD>
28149 <TITLE>FEATURE: <!--#echo var="FEAT_strip-from-sigdashes-on-reply"--></TITLE>
28150 </HEAD>
28151 <BODY>
28152 <H1>FEATURE: <!--#echo var="FEAT_strip-from-sigdashes-on-reply"--></H1>
28153
28154 This feature doesn't do anything if the feature
28155 &quot;<A HREF="h_config_sigdashes"><!--#echo var="FEAT_enable-sigdashes"--></A>&quot; is turned on.
28156 However, if the &quot;<!--#echo var="FEAT_enable-sigdashes"-->&quot; feature is not turned on,
28157 then turning on this feature enables support for the convention
28158 of not including text beyond the sigdashes line when Replying or Following
28159 up to a message and including the text of that message.
28160 If <A HREF="h_config_enable_full_hdr">&quot;Full Header&quot;</A>
28161 mode is enabled and turned on, then Alpine <EM>will</EM>
28162 include the text beyond the special line regardless of the setting of
28163 this feature.
28164 <P>
28165 In other words, this is a way to turn on the signature stripping behavior
28166 without also turning on the dashes-adding behavior.
28167 <P>
28168 <UL>
28169 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28170 </UL><P>
28171 &lt;End of help on this topic&gt;
28172 </BODY>
28173 </HTML>
28174 ====== h_config_forward_as_attachment =====
28175 <HTML>
28176 <HEAD>
28177 <TITLE>FEATURE: <!--#echo var="FEAT_forward-as-attachment"--></TITLE>
28178 </HEAD>
28179 <BODY>
28180 <H1>FEATURE: <!--#echo var="FEAT_forward-as-attachment"--></H1>
28181
28182 This feature affects the way forwarded message text is handled.  When set, rather than
28183 include the text of the forwarded message below any additional text you provide in the
28184 composer, the forwarded message is attached in its entirety to the message you send.
28185 <P>
28186 This is useful in that it keeps the text you provide in the composer distinct from the
28187 text of the forwarded message.  Similarly, it allows the recipient to
28188 conveniently operate on the forwarded message.  For example, they might reply directly to
28189 the sender of the forwarded message, or process it as part of a spam report.
28190 <UL>
28191 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28192 </UL><P>
28193 &lt;End of help on this topic&gt;
28194 </BODY>
28195 </HTML>
28196 ====== h_config_preserve_field =====
28197 <HTML>
28198 <HEAD>
28199 <TITLE>FEATURE: <!--#echo var="FEAT_preserve-original-fields"--></TITLE>
28200 </HEAD>
28201 <BODY>
28202 <H1>FEATURE: <!--#echo var="FEAT_preserve-original-fields"--></H1>
28203
28204 This feature affects Alpine's behavior when one replies to a message.
28205 When you receive a message, some or all of the recipients of the message
28206 have been added to the To: and Cc: fields. If you reply to such message,
28207 and this feature is disabled, then the original sender of the message is
28208 added to the To: field, and all other recipients are added to the Cc:
28209 field, while your address is added to the From: field.
28210
28211 <P>
28212 However, if this feature is enabled, then Alpine will preserve the
28213 original fields as sent in the original message, so the Cc: and To:
28214 fields will be preserved. The sender's address will be added to the To:
28215 field, while your address is added to the From: field.
28216
28217 <P>
28218 The behavior of this feature is that replies to all messages will behave
28219 in the way described above. If you only intend this to happen on a per
28220 message basis, then keep this feature disabled, and when replying to a
28221 message you will see a new option in the menu for the &quot;Reply to all
28222 recipients?&quot; question. In this case, pressing &quot;p&quot; will
28223 make Alpine toggle its question so you can preserve the To: and Cc:
28224 fields for that message only.
28225
28226 <UL>
28227 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28228 </UL><P>
28229 &lt;End of help on this topic&gt;
28230 </BODY>
28231 </HTML>
28232 ====== h_config_sub_lists =====
28233 <HTML>
28234 <HEAD>
28235 <TITLE>FEATURE: <!--#echo var="FEAT_enable-partial-match-lists"--></TITLE>
28236 </HEAD>
28237 <BODY>
28238 <H1>FEATURE: <!--#echo var="FEAT_enable-partial-match-lists"--></H1>
28239
28240 This feature affects the subcommands available when Saving,
28241 or when Opening a new folder. If set, the subcommand ^X ListMatches will be
28242 available. This command allows you to type in a substring of the folder
28243 you are looking for and when you type ^X it will display all folders
28244 that contain that substring in their names.
28245 This feature is set by default.
28246
28247 <P>
28248 &lt;End of help on this topic&gt;
28249 </BODY>
28250 </HTML>
28251 ====== h_config_scramble_message_id =====
28252 <HTML>
28253 <HEAD>
28254 <TITLE>FEATURE: <!--#echo var="FEAT_scramble-message-id"--></TITLE>
28255 </HEAD>
28256 <BODY>
28257 <H1>FEATURE: <!--#echo var="FEAT_scramble-message-id"--></H1>
28258
28259 Normally the Message-ID header that Alpine generates when sending a message
28260 contains the name of the computer from which the message is being sent.
28261 Some believe that this hostname could be used by spammers or could
28262 be used by others for nefarious purposes.
28263 If this feature is set, that name will be transformed with a simple
28264 Rot13 transformation.
28265 The result will still have the correct syntax for a Message-ID but the
28266 part of the MessageID that is often a domain name will not be an actual
28267 domain name because the letters will be scrambled.
28268 <P>
28269 It is possible (but unlikely?) that some spam detection
28270 software will use that as a reason to reject the mail as spam.
28271 It has also been reported that some spam detection software uses the
28272 fact that there are no dots after the &quot;@&quot; as a reason to reject
28273 messages.
28274 If your PC-Alpine Message-ID is using a name without a dot that is because
28275 that is what Windows thinks is your &quot;Full computer name&quot;.
28276 The method used to set this varies from one type of Windows to another but
28277 check under Settings -> Control Panel -> System and
28278 look for Network Identification or Computer Name or something similar.
28279 How to set it is beyond the scope of Alpine.
28280
28281 <P>
28282 &lt;End of help on this topic&gt;
28283 </BODY>
28284 </HTML>
28285 ====== h_downgrade_multipart_to_text =====
28286 <HTML>
28287 <HEAD>
28288 <TITLE>FEATURE: <!--#echo var="FEAT_downgrade-multipart-to-text"--></TITLE>
28289 </HEAD>
28290 <BODY>
28291 <H1>FEATURE: <!--#echo var="FEAT_downgrade-multipart-to-text"--></H1>
28292
28293 <P>
28294 This feature affects Alpine's behavior when sending mail.  Internet
28295 standards require Alpine to translate all non-ASCII characters in
28296 messages that it sends using MIME encoding.  This encoding can be
28297 ostensibly broken for recipients if any agent between Alpine and the
28298 recipient, such as an email list expander, appends text to the
28299 message, such as list information or advertising.  When sending such
28300 messages Alpine attempts to protect such encoding by placing extra
28301 MIME boundaries around the message text.
28302 <P>
28303 These extra boundaries are invisible to recipients that
28304 use MIME-aware email programs (the vast majority).  However, if
28305 you correspond with users of email programs that are not MIME-aware,
28306 or do not handle the extra boundaries gracefully, you can
28307 use this feature to prevent Alpine from including the extra
28308 MIME information.  Of course, it will increase the likelihood
28309 that non-ASCII text you send may appear corrupt to the recipient.
28310 <P>
28311 &lt;End of help on this topic&gt;
28312 </BODY>
28313 </HTML>
28314 ====== h_config_show_sort =====
28315 <HTML>
28316 <HEAD>
28317 <TITLE>FEATURE: <!--#echo var="FEAT_show-sort"--></TITLE>
28318 </HEAD>
28319 <BODY>
28320 <H1>FEATURE: <!--#echo var="FEAT_show-sort"--></H1>
28321
28322 If this feature is set and there is sufficient space on the screen,
28323 a short indication of the current sort order will be
28324 added in the titlebar (the top line on the screen), before the name
28325 of the folder.
28326 For example, with the default Arrival sort in effect,
28327 the display would have the characters
28328
28329 <P><CENTER>[A]</CENTER><P>
28330
28331 added between the title of the screen and the folder name.
28332 The letters are the same as the letters you may type to manually
28333 sort a folder with the SortIndex command ($).
28334 The letters in the table below are the ones that may show
28335 up in the titlebar line.
28336 <P>
28337 <TABLE>
28338 <TR> <TD> A </TD> <TD> <EM>A</EM>rrival        </TD> </TR>
28339 <TR> <TD> S </TD> <TD> <EM>S</EM>ubject        </TD> </TR>
28340 <TR> <TD> F </TD> <TD> <EM>F</EM>rom           </TD> </TR>
28341 <TR> <TD> T </TD> <TD> <EM>T</EM>o             </TD> </TR>
28342 <TR> <TD> C </TD> <TD> <EM>C</EM>c             </TD> </TR>
28343 <TR> <TD> D </TD> <TD> <EM>D</EM>ate           </TD> </TR>
28344 <TR> <TD> Z </TD> <TD> si<EM>Z</EM>e           </TD> </TR>
28345 <TR> <TD> O </TD> <TD> <EM>O</EM>rderedsubject </TD> </TR>
28346 <TR> <TD> E </TD> <TD> scor<EM>E</EM>          </TD> </TR>
28347 <TR> <TD> H </TD> <TD> t<EM>H</EM>read         </TD> </TR>
28348 </TABLE>
28349 <P>
28350 If the sort order is Reversed, the letter above will be preceded by the letter
28351 &quot;R&quot;, for example
28352
28353 <P><CENTER>[RS]</CENTER><P>
28354
28355 means that a Reverse Subject sort is in effect.
28356 For the case where the sort is in Reverse Arrival order, the &quot;A&quot; is
28357 left out, and just an &quot;R&quot; is shown.
28358
28359 <P><CENTER>[R]</CENTER>
28360
28361 <P>
28362 &lt;End of help on this topic&gt;
28363 </BODY>
28364 </HTML>
28365 ====== h_config_disable_reset_disp =====
28366 <HTML>
28367 <HEAD>
28368 <TITLE>FEATURE: <!--#echo var="FEAT_disable-terminal-reset-for-display-filters"--></TITLE>
28369 </HEAD>
28370 <BODY>
28371 <H1>FEATURE: <!--#echo var="FEAT_disable-terminal-reset-for-display-filters"--></H1>
28372
28373 UNIX Alpine only.
28374 <P>
28375 This feature affects Alpine's behavior when using
28376 <A HREF="h_config_display_filters"><!--#echo var="VAR_display-filters"--></A>.
28377 Normally, before the display filter is run, the terminal mode is reset
28378 to what it was before you started Alpine.
28379 This may be necessary if the filter requires the use of the terminal.
28380 For example, it may need to interact with you.
28381 If you set this feature, then the terminal mode will not be reset.
28382 One thing that turning on this feature should fix is the coloring of
28383 <A HREF="h_config_quote_color">quoted text</A> in the message view, which
28384 breaks because the terminal reset resets the color state of the terminal.
28385
28386 <P>
28387 &lt;End of help on this topic&gt;
28388 </BODY>
28389 </HTML>
28390 ====== h_config_disable_sender =====
28391 <HTML>
28392 <HEAD>
28393 <TITLE>FEATURE: <!--#echo var="FEAT_disable-sender"--></TITLE>
28394 </HEAD>
28395 <BODY>
28396 <H1>FEATURE: <!--#echo var="FEAT_disable-sender"--></H1>
28397
28398 This feature affects Alpine's generation of the &quot;Sender:&quot; or
28399 <A HREF="h_config_use_sender_not_x">&quot;X-X-Sender&quot;</A>
28400 header fields.
28401 By default, Alpine will generate such a header in situations where the
28402 username or domain are not the same as
28403 the &quot;From:&quot; header on the message.
28404 With this feature set,
28405 no &quot;Sender:&quot; or &quot;X-X-Sender&quot; header will be generated.
28406 This may be desirable on a system that is virtually hosting many domains,
28407 and the sysadmin has other methods available for tracking a message to
28408 its originator.
28409 <P>
28410 See also <A HREF="h_config_allow_chg_from">&quot;<!--#echo var="FEAT_allow-changing-from"-->&quot;</A>.
28411
28412 <P>
28413 &lt;End of help on this topic&gt;
28414 </BODY>
28415 </HTML>
28416 ====== h_config_use_sender_not_x =====
28417 <HTML>
28418 <HEAD>
28419 <TITLE>FEATURE: <!--#echo var="FEAT_use-sender-not-x-sender"--></TITLE>
28420 </HEAD>
28421 <BODY>
28422 <H1>FEATURE: <!--#echo var="FEAT_use-sender-not-x-sender"--></H1>
28423
28424 Normally Alpine adds a header line
28425 labeled &quot;X-X-Sender&quot;, if the sender is
28426 different from the From: line.
28427 The standard specifies that this header
28428 line should be labeled &quot;Sender&quot;, not &quot;X-X-Sender&quot;.
28429 Setting this feature causes
28430 &quot;Sender&quot; to be used instead of &quot;X-X-Sender&quot;.
28431 <P>
28432 See also <A HREF="h_config_disable_sender">&quot;<!--#echo var="FEAT_disable-sender"-->&quot;</A>.
28433
28434 <P>
28435 &lt;End of help on this topic&gt;
28436 </BODY>
28437 </HTML>
28438 ====== h_config_use_fk =====
28439 <HTML>
28440 <HEAD>
28441 <TITLE>FEATURE: <!--#echo var="FEAT_use-function-keys"--></TITLE>
28442 </HEAD>
28443 <BODY>
28444 <H1>FEATURE: <!--#echo var="FEAT_use-function-keys"--></H1>
28445
28446 This feature specifies that Alpine will respond to function keys instead of
28447 the normal single-letter commands. In this mode, the key menus at the
28448 bottom of each screen will show function key designations instead of the
28449 normal mnemonic key.
28450
28451 <P>
28452 &lt;End of help on this topic&gt;
28453 </BODY>
28454 </HTML>
28455 ====== h_config_cancel_confirm =====
28456 <HTML>
28457 <HEAD>
28458 <TITLE>FEATURE: <!--#echo var="FEAT_compose-cancel-confirm-uses-yes"--></TITLE>
28459 </HEAD>
28460 <BODY>
28461 <H1>FEATURE: <!--#echo var="FEAT_compose-cancel-confirm-uses-yes"--></H1>
28462
28463 This feature affects what happens when you type ^C to cancel a composition.
28464 By default, if you attempt to cancel a composition by typing ^C, you will be
28465 asked to confirm the cancellation by typing a &quot;C&quot;
28466 for <EM>C</EM>onfirm.
28467 It logically ought to be a &quot;Y&quot; for <EM>Y</EM>es, but that is
28468 risky because the &quot;^C Y&quot; needed to cancel a message
28469 is close (on the keyboard) to the &quot;^X Y&quot; needed to send a message.
28470 <P>
28471 If this feature is set the confirmation asked for
28472 will be a &quot;<EM>Y</EM>es&quot;
28473 instead of a &quot;<EM>C</EM>onfirm&quot; response.
28474
28475 <P>
28476 &lt;End of help on this topic&gt;
28477 </BODY>
28478 </HTML>
28479 ====== h_config_compose_maps_del =====
28480 <HTML>
28481 <HEAD>
28482 <TITLE>FEATURE: <!--#echo var="FEAT_compose-maps-delete-key-to-ctrl-d"--></TITLE>
28483 </HEAD>
28484 <BODY>
28485 <H1>FEATURE: <!--#echo var="FEAT_compose-maps-delete-key-to-ctrl-d"--></H1>
28486
28487 This feature affects the behavior of the DELETE key.
28488 If set, Delete will be equivalent to ^D, and delete
28489 the current character.  Normally Alpine defines the Delete key
28490 to be equivalent to ^H, which deletes the <EM>previous</EM>
28491 character.
28492
28493 <P>
28494 &lt;End of help on this topic&gt;
28495 </BODY>
28496 </HTML>
28497 ====== h_config_compose_bg_post =====
28498 <HTML>
28499 <HEAD>
28500 <TITLE>FEATURE: <!--#echo var="FEAT_enable-background-sending"--></TITLE>
28501 </HEAD>
28502 <BODY>
28503 <H1>FEATURE: <!--#echo var="FEAT_enable-background-sending"--></H1>
28504
28505 This feature affects the behavior of Alpine's mail sending.  If set, this
28506 feature enables a subcommand in the composer's "Send?" confirmation
28507 prompt.  The subcommand allows you to tell Alpine to handle the actual
28508 posting in the background.  While this feature usually allows posting
28509 to appear to happen very fast, it has no affect on the actual delivery
28510 time it takes a message to arrive at its destination.
28511
28512 <P>
28513 Please Note:
28514 <OL>
28515  <LI>This feature will have no effect if the feature
28516        <A HREF="h_config_send_wo_confirm">&quot;<!--#echo var="FEAT_send-without-confirm"-->&quot;</A>
28517        is set.
28518  <LI>This feature isn't supported on all systems.  All DOS and Windows,
28519        as well as several Unix ports, do not recognize this feature.
28520  <LI>Error handling is significantly different when this feature is
28521         enabled.  Any message posting failure results in the message
28522         being appended to your &quot;Interrupted&quot; mail folder.  When you
28523         type the <A HREF="h_common_compose">C</A>ompose command,
28524         Alpine will notice this folder and
28525         offer to extract any messages contained.  Upon continuing a
28526         failed message, Alpine will display the nature of the failure
28527         in the status message line.
28528  <LI> <EM>WARNING</EM>: Under extreme conditions, it is possible
28529         for message data to
28530         get lost.  <EM>Do</EM> <EM>not</EM> enable this feature
28531         if you typically run close to any sort of disk-space limits or quotas.
28532 </OL>
28533 <P>
28534 &lt;End of help on this topic&gt;
28535 </BODY>
28536 </HTML>
28537 ====== h_config_compose_dsn =====
28538 <HTML>
28539 <HEAD>
28540 <TITLE>FEATURE: <!--#echo var="FEAT_enable-delivery-status-notification"--></TITLE>
28541 </HEAD>
28542 <BODY>
28543 <H1>FEATURE: <!--#echo var="FEAT_enable-delivery-status-notification"--></H1>
28544
28545 This feature affects the behavior of Alpine's mail sending.  If set, this
28546 feature enables a subcommand in the composer's &quot;Send?&quot; confirmation
28547 prompt.  The subcommand allows you to tell Alpine to request the type of
28548 Delivery Status Notification (DSN) that you would like.  Most users will
28549 be happy with the default, and need not enable this feature.
28550 <P>
28551 If the feature
28552 <A HREF="h_config_send_wo_confirm">&quot;<!--#echo var="FEAT_send-without-confirm"-->&quot;</A> is set,
28553 then this feature has no effect and the type of DSN is not selectable.
28554
28555 <P>
28556 Turning on this feature and then turning on the DSNOpts from the send
28557 prompt reveals four on-off toggles at the bottom of the screen.
28558 The &quot;X&quot; command toggles between NoErrRets and ErrRets.  NoErrRets requests
28559 that no notification be returned to you, even if there is a delivery
28560 failure.  The &quot;D&quot; key toggles between Delay and NoDelay.  This tells the
28561 server that you are willing (or not) to receive delay notifications, which
28562 happen when there is an unusual delay at some mail server (in that mail
28563 server's opinion).  The &quot;S&quot; key toggles between Success and NoSuccess.
28564 Success requests that you be sent a DSN message when the message is
28565 successfully delivered to the recipients mailbox.  Setting NoErrRets will
28566 automatically turn off Delay and Success notification, and will flip the
28567 toggles to show that.  Similarly, turning on Delay and/or Success will
28568 automatically toggle the &quot;X&quot; key to ErrRets.  The fourth command, the
28569 &quot;H&quot; key, toggles between RetHdrs and RetFull.  RetFull requests that
28570 the full message be returned in any failed DSN.  RetHdrs requests that
28571 only the headers be returned in any failed DSN.  Notice that this command
28572 applies only to failed delivery status reports.  For delay or success
28573 reports, the full message is never returned, only the headers are returned.
28574
28575 <P>
28576 If you don't enable the DSN feature or if you don't turn it on for a
28577 particular message, the default is that you will be notified about failures,
28578 you might be notified about delays, and you won't be notified about
28579 successes.  You will usually receive the full message back when there is
28580 a failure.
28581
28582 <P>
28583 If you turn on the DSNOpts the default is to return as much information as
28584 possible to you.  That is, by default, the Success and Delay options are
28585 turned on and the full message will be returned on failure.
28586
28587 <P>
28588 The sending prompt will display the current DSN request (if any) in a
28589 shorthand form.  It will be:
28590
28591 <P><CENTER>[Never]</CENTER>
28592
28593 <P>
28594 if you have requested NoErrRets.  Otherwise, it will look something like:
28595
28596 <P><CENTER>[FDS-Hdrs]</CENTER>
28597
28598 <P>
28599 The &quot;F&quot; will always be there, indicating that you will be notified
28600 of failures.  (Alpine doesn't provide a way to request no failure notification
28601 and at the same time request either success or delay notification.  The only
28602 way to request no failure notifications is to request no notifications at
28603 all with NoErrRets.)  The &quot;D&quot; and/or &quot;S&quot; will be present if you have
28604 requested Delay and/or Success notification.  If one of those is missing,
28605 that means you are requesting no notification of the corresponding type.
28606 After the dash it will say either Hdrs or Full.  Hdrs means to return only
28607 the headers and Full means to return the full message (applies to
28608 failure notifications only).
28609
28610 <P>
28611 NOTE: This feature relies on your system's mail transport agent or
28612 configured
28613 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>
28614 having the negotiation mechanism introduced in
28615 &quot;Extended SMTP&quot; (ESMTP) and the specific extension called
28616 &quot;Delivery Status Notification&quot; (DSN).  If the mail tranport agent you
28617 are using doesn't support DSN, a short warning will be shown to you on
28618 the message line at the bottom of the screen after you send your message,
28619 but your message will have been sent anyway.
28620
28621 <P>
28622 Note that DSNs don't provide a mechanism to request read receipts.  That
28623 is, if you request notification on success you are notified when the
28624 message is delivered to the mailbox, not when the message is read.
28625
28626 <P>
28627 ESMTP allows for graceful migration to upgraded mail transfer agents, but
28628 it is possible that this feature might cause problems for some servers.
28629
28630 <P>
28631 &lt;End of help on this topic&gt;
28632 </BODY>
28633 </HTML>
28634 ====== h_config_auto_zoom =====
28635 <HTML>
28636 <HEAD>
28637 <TITLE>FEATURE: <!--#echo var="FEAT_auto-zoom-after-select"--></TITLE>
28638 </HEAD>
28639 <BODY>
28640 <H1>FEATURE: <!--#echo var="FEAT_auto-zoom-after-select"--></H1>
28641
28642 This feature affects the behavior of the Select command.
28643 If set, the select command will automatically perform a zoom
28644 after the select is complete.
28645 This feature is set by default.
28646 <P>
28647 Some related help topics are
28648 <UL>
28649 <LI> <A HREF="h_mainhelp_aggops">Aggregate Operations</A>
28650 <LI> <A HREF="h_index_cmd_select">Selecting: Select and WhereIs/Select</A>,
28651 <LI> <A HREF="h_config_enable_agg_ops"><!--#echo var="FEAT_enable-aggregate-command-set"--></A>,
28652 <LI> <A HREF="h_config_auto_unzoom"><!--#echo var="FEAT_auto-unzoom-after-apply"--></A>, and
28653 <LI> <A HREF="h_config_auto_unselect"><!--#echo var="FEAT_auto-unselect-after-apply"--></A>.
28654 <LI> <A HREF="h_config_select_wo_confirm"><!--#echo var="FEAT_select-without-confirm"--></A>.
28655 </UL>
28656
28657 <P>
28658 &lt;End of help on this topic&gt;
28659 </BODY>
28660 </HTML>
28661 ====== h_config_auto_unzoom =====
28662 <HTML>
28663 <HEAD>
28664 <TITLE>FEATURE: <!--#echo var="FEAT_auto-unzoom-after-apply"--></TITLE>
28665 </HEAD>
28666 <BODY>
28667 <H1>FEATURE: <!--#echo var="FEAT_auto-unzoom-after-apply"--></H1>
28668
28669 This feature affects the behavior of the Apply command.  If set, and if
28670 you are currently looking at a Zoomed Index view of selected messages,
28671 the Apply command will do the operation you specify, but then will
28672 implicitly do an &quot;UnZoom&quot;, so that you will automatically be back in
28673 the normal Index view after the Apply.
28674 This feature is set by default.
28675
28676 <P>
28677 Some related help topics are
28678 <UL>
28679 <LI> <A HREF="h_mainhelp_aggops">Aggregate Operations</A>
28680 <LI> <A HREF="h_index_cmd_select">Selecting: Select and WhereIs/Select</A>,
28681 <LI> <A HREF="h_config_enable_agg_ops"><!--#echo var="FEAT_enable-aggregate-command-set"--></A>,
28682 <LI> <A HREF="h_config_auto_unselect"><!--#echo var="FEAT_auto-unselect-after-apply"--></A>.
28683 <LI> <A HREF="h_config_auto_zoom"><!--#echo var="FEAT_auto-zoom-after-select"--></A>, and
28684 <LI> <A HREF="h_config_select_wo_confirm"><!--#echo var="FEAT_select-without-confirm"--></A>.
28685 </UL>
28686 <P>
28687 &lt;End of help on this topic&gt;
28688 </BODY>
28689 </HTML>
28690 ====== h_config_auto_unselect =====
28691 <HTML>
28692 <HEAD>
28693 <TITLE>FEATURE: <!--#echo var="FEAT_auto-unselect-after-apply"--></TITLE>
28694 </HEAD>
28695 <BODY>
28696 <H1>FEATURE: <!--#echo var="FEAT_auto-unselect-after-apply"--></H1>
28697
28698 This feature affects the behavior of the Apply command.  If set,
28699 the Apply command will do the operation you specify, but then will
28700 implicitly do an &quot;UnSelect All&quot;, so that you will automatically be back in
28701 the normal Index view after the Apply.
28702
28703 <P>
28704 Some related help topics are
28705 <UL>
28706 <LI> <A HREF="h_mainhelp_aggops">Aggregate Operations</A>
28707 <LI> <A HREF="h_index_cmd_select">Selecting: Select and WhereIs/Select</A>,
28708 <LI> <A HREF="h_config_enable_agg_ops"><!--#echo var="FEAT_enable-aggregate-command-set"--></A>,
28709 <LI> <A HREF="h_config_auto_zoom"><!--#echo var="FEAT_auto-zoom-after-select"--></A>, and
28710 <LI> <A HREF="h_config_auto_unzoom"><!--#echo var="FEAT_auto-unzoom-after-apply"--></A>, and
28711 <LI> <A HREF="h_config_select_wo_confirm"><!--#echo var="FEAT_select-without-confirm"--></A>.
28712 </UL>
28713 <P>
28714 &lt;End of help on this topic&gt;
28715 </BODY>
28716 </HTML>
28717 ====== h_config_fast_recent =====
28718 <HTML>
28719 <HEAD>
28720 <TITLE>FEATURE: <!--#echo var="FEAT_enable-fast-recent-test"--></TITLE>
28721 </HEAD>
28722 <BODY>
28723 <H1>FEATURE: <!--#echo var="FEAT_enable-fast-recent-test"--></H1>
28724
28725 This feature controls the behavior of the TAB key when traversing folders
28726 in the optional
28727 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
28728 collection or in optional <!--#echo var="VAR_news-collections"-->.
28729
28730 <P>
28731 When the TAB
28732 (<A HREF="h_common_nextnew">NextNew</A>)
28733 key is pressed, the default behavior is to
28734 explicitly examine the status of the folder for the number of recent
28735 messages (messages delivered since the last time it was viewed).
28736 Depending on the size and number of messages in the folder, this test
28737 can be time consuming.
28738
28739 <P>
28740 Enabling this feature will cause Alpine to only test for the existence of
28741 any recent messages rather than to obtain the count.  This is much faster
28742 in many cases.  The downside is that you're not given the number of recent
28743 messages when prompted to view the next folder.
28744 If the feature
28745 <A HREF="h_config_tab_uses_unseen">&quot;<!--#echo var="FEAT_tab-uses-unseen-for-next-folder"-->&quot;</A>
28746 is turned on, then the present feature will have no effect.
28747
28748 <P>
28749 <UL>
28750 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28751 </UL><P>
28752 &lt;End of help on this topic&gt;
28753 </BODY>
28754 </HTML>
28755 ====== h_config_arrow_nav =====
28756 <HTML>
28757 <HEAD>
28758 <TITLE>FEATURE: <!--#echo var="FEAT_enable-arrow-navigation"--></TITLE>
28759 </HEAD>
28760 <BODY>
28761 <H1>FEATURE: <!--#echo var="FEAT_enable-arrow-navigation"--></H1>
28762
28763 This feature controls the behavior of the left and right arrow keys.
28764 If set, the left and right arrow keys will operate like the usual
28765 navigation keys &lt; and &gt;.
28766 This feature is set by default.
28767
28768 <P>
28769 If you set this feature, and do not like the changed behavior of the up/down
28770 arrow
28771 keys when navigating through the FOLDER LIST screen --
28772 <B>first</B> from column to column, if more than one folder is
28773 displayed per row,
28774 and <B>then</B> from row to row -- you may either also wish to set the feature
28775 &quot;<A HREF="h_config_relaxed_arrow_nav"><!--#echo var="FEAT_enable-arrow-navigation-relaxed"--></A>&quot;,
28776 &quot;<A HREF="h_config_single_list"><!--#echo var="FEAT_single-column-folder-list"--></A>&quot;, or
28777 use the ^P/^N (instead of up/down arrow) keys to move up/down the list of
28778 folders in each column.
28779 <P>
28780 <UL>
28781 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28782 </UL><P>
28783 &lt;End of help on this topic&gt;
28784 </BODY>
28785 </HTML>
28786 ====== h_config_relaxed_arrow_nav =====
28787 <HTML>
28788 <HEAD>
28789 <TITLE>FEATURE: <!--#echo var="FEAT_enable-arrow-navigation-relaxed"--></TITLE>
28790 </HEAD>
28791 <BODY>
28792 <H1>FEATURE: <!--#echo var="FEAT_enable-arrow-navigation-relaxed"--></H1>
28793
28794 This feature controls the behavior of the left, right, up and down
28795 arrow keys in the FOLDER LIST screen when the &quot;<A
28796 HREF="h_config_arrow_nav"><!--#echo var="FEAT_enable-arrow-navigation"--></A>&quot; feature is
28797 set.
28798 This feature is set by default.
28799
28800 <P>
28801
28802 When this feature is set, the left and right
28803 arrow keys in the FOLDER LIST screen
28804 move the highlight bar to the left or right, and the up and
28805 down arrows move it up or down.
28806
28807 <P>
28808 When the &quot;<!--#echo var="FEAT_enable-arrow-navigation"-->&quot; feature is set and this
28809 feature is not set;
28810 the left and right arrow keys in the Folder List screen strictly
28811 track the commands bound to the '&lt;' and '&gt;' keys, and the up
28812 and down arrow keys move the highlight bar to the previous and next
28813 folder or directory name.
28814
28815 <P>
28816 <UL>
28817 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28818 </UL><P>
28819 &lt;End of help on this topic&gt;
28820 </BODY>
28821 </HTML>
28822 ====== h_config_alt_compose_menu =====
28823 <HTML>
28824 <HEAD>
28825 <TITLE>FEATURE: <!--#echo var="FEAT_alternate-compose-menu"--></TITLE>
28826 </HEAD>
28827 <BODY>
28828 <H1>FEATURE: <!--#echo var="FEAT_alternate-compose-menu"--></H1>
28829
28830 This feature controls the menu that is displayed when Compose is selected.
28831 If set, a list of options will be presented, with each option representing
28832 the type of composition that could be used. This feature is most useful for
28833 users who want to avoid being prompted with each option separately, or who
28834 want to avoid the checking of remote postponed or form letter folders.
28835 The possible types of composition are:
28836
28837 <P>
28838 New, for starting a new composition. Note that if New is selected and roles
28839 are set, roles are checked for matches and applied according to the setting
28840 of the matching role.
28841
28842 <P>
28843 Interrupted, for continuing an interrupted composition. This option is only
28844 offered if an interrupted message folder is detected.
28845
28846 <P>
28847 Postponed, for continuing postponed compositions. This option is offered
28848 if a <!--#echo var="VAR_postponed-folder"--> is set in the config REGARDLESS OF whether or not
28849 the postponed folder actually exists. This option is especially handy
28850 for avoiding having to check for the existence of a remote postponed folder.
28851
28852 <P>
28853 Form, for using form letters. This option is offered if the <!--#echo var="VAR_form-letter-folder"-->
28854 is set in the config, and is not checked for existence for reasons similar
28855 to those explained by the postponed option.
28856
28857 <P>
28858 setRole, for selecting a role to apply to a composition.
28859
28860 <P>
28861 &lt;End of help on this topic&gt;
28862 </BODY>
28863 </HTML>
28864 ====== h_config_alt_role_menu =====
28865 <HTML>
28866 <HEAD>
28867 <TITLE>FEATURE: <!--#echo var="FEAT_alternate-role-menu"--></TITLE>
28868 </HEAD>
28869 <BODY>
28870 <H1>FEATURE: <!--#echo var="FEAT_alternate-role-menu"--></H1>
28871
28872 Normally the <A HREF="h_common_role">Role Command</A> allows you to choose
28873 a role and compose a new message using that role.
28874 When this feature is set, the role command will first ask whether you want to
28875 Compose a new message, Forward the current message, Reply to the
28876 current message, or Bounce the current message.
28877 If you are not in the MESSAGE INDEX and are not viewing a message,
28878 then there is no current message and the question will be skipped.
28879 After you have chosen to Compose, Forward, Reply, or Bounce you will
28880 then choose the role to be used.
28881 <P>
28882 When Bouncing the &quot;Set From&quot; address is used for the
28883 Resent-From header, the &quot;Set Fcc&quot; value is used for the Fcc
28884 provided that the option
28885 <A HREF="h_config_fcc_on_bounce">&quot;<!--#echo var="FEAT_fcc-on-bounce"-->&quot;</A> is turned on,
28886 and the &quot;Use SMTP Server&quot; value is used for the SMTP server, if
28887 set.
28888 Other actions of the role are ignored when Bouncing.
28889
28890 <P>
28891 &lt;End of help on this topic&gt;
28892 </BODY>
28893 </HTML>
28894 ====== h_config_always_spell_check =====
28895 <HTML>
28896 <HEAD>
28897 <TITLE>FEATURE: <!--#echo var="FEAT_spell-check-before-sending"--></TITLE>
28898 </HEAD>
28899 <BODY>
28900 <H1>FEATURE: <!--#echo var="FEAT_spell-check-before-sending"--></H1>
28901 <P>
28902 When this feature is set, every composed message will be spell-checked before
28903 being sent.
28904 <P>
28905 &lt;End of help on this topic&gt;
28906 </BODY>
28907 </HTML>
28908 ====== h_config_quell_asterisks =====
28909 <HTML>
28910 <HEAD>
28911 <TITLE>FEATURE: <!--#echo var="FEAT_suppress-asterisks-in-password-prompt"--></TITLE>
28912 </HEAD>
28913 <BODY>
28914 <H1>FEATURE: <!--#echo var="FEAT_suppress-asterisks-in-password-prompt"--></H1>
28915 <P>
28916 When you are running Alpine you will sometimes be asked for a password
28917 in a prompt on the third line from the bottom of the screen.
28918 Normally each password character you type will cause an asterisk to echo
28919 on the screen. That gives you some feedback to know that your typing is
28920 being recognized.
28921 There is a very slight security risk in doing it this way because someone
28922 watching over your shoulder might be able to see how many characters there
28923 are in your password.
28924 If you'd like to suppress the echoing of the asterisks set this feature.
28925 <P>
28926 &lt;End of help on this topic&gt;
28927 </BODY>
28928 </HTML>
28929 ====== h_config_quell_flowed_text =====
28930 <HTML>
28931 <HEAD>
28932 <TITLE>FEATURE: <!--#echo var="FEAT_quell-flowed-text"--></TITLE>
28933 </HEAD>
28934 <BODY>
28935 <H1>FEATURE: <!--#echo var="FEAT_quell-flowed-text"--></H1>
28936 <P>
28937 Alpine generates flowed text where possible.
28938 The method for generating flowed text is defined by
28939 <A HREF="http://www.ietf.org/rfc/rfc3676.txt">RFC 3676</A>,
28940 the benefit of doing so is
28941 to send message text that can properly be viewed both on normal width displays
28942 and on displays with smaller or larger than normal screen widths.
28943 With flowed text, a space at the end of a line tells the receiving mail
28944 client that the following line belongs to the same paragraph.
28945 Quoted text will also be affected, with only the innermost
28946 level of &quot;&gt;&quot; quoting being followed by a space.
28947 However, if you have changed the
28948 <A HREF="h_config_reply_indent_string">&quot;<!--#echo var="VAR_reply-indent-string"-->&quot;</A>
28949 so that it is not equal to the default value of &quot;&gt;&nbsp;&quot;, then
28950 quoted text will not be flowed.
28951 For this reason, we recommend that you leave your
28952 &quot;<!--#echo var="VAR_reply-indent-string"-->&quot; set to the default.
28953 <P>
28954 This feature turns off the generation of flowed text, as it might be
28955 desired to more tightly control how a message is displayed on the receiving end.
28956 <P>
28957 If this feature is <EM>not</EM> set, you can control on a message by message
28958 basis whether or not flowed text is generated.
28959 You do this by typing ^V at the Send confirmation prompt that you get
28960 after typing ^X to send a message.
28961 ^V is a toggle that turns flowing off and back on if typed again.
28962 If for some reason flowing cannot be done on a particular message, then the
28963 ^V command will not be available.
28964 This would be the case, for example, if this feature was set, or if your
28965 &quot;<!--#echo var="VAR_reply-indent-string"-->&quot; was set to a non-default value.
28966 If the feature
28967 <A HREF="h_config_send_wo_confirm">&quot;<!--#echo var="FEAT_send-without-confirm"-->&quot;</A> is set,
28968 then the opportunity to control on a message by message basis
28969 whether or not flowed text is generated is lost.
28970 <P>
28971 When this feature is not set and you have typed ^V to turn off flowing,
28972 the Send confirmation prompt will change to look like
28973 <P>
28974 <CENTER><SAMP>Send message (not flowed)?</SAMP></CENTER>
28975 <P>
28976 <A HREF="h_config_strip_ws_before_send">&quot;<!--#echo var="FEAT_strip-whitespace-before-send"-->&quot;</A> will
28977 also turn off the sending of flowed text messages, but it differs in that
28978 it also trims all trailing white space from a message before sending it.
28979 <P>
28980 If alternate editors are used extensively, be aware that a message will still
28981 be sent flowed if this feature is unset.  In most cases this will be fine,
28982 but if the editor has a &quot;flowed text&quot; mode, it would be best to
28983 use that.
28984 <P>
28985 &lt;End of help on this topic&gt;
28986 </BODY>
28987 </HTML>
28988 ====== h_config_strip_ws_before_send =====
28989 <HTML>
28990 <HEAD>
28991 <TITLE>FEATURE: <!--#echo var="FEAT_strip-whitespace-before-send"--></TITLE>
28992 </HEAD>
28993 <BODY>
28994 <H1>FEATURE: <!--#echo var="FEAT_strip-whitespace-before-send"--></H1>
28995 <P>
28996 By default, trailing whitespace is not stripped from
28997 a message before sending.  Trailing whitespace should have no effect on an
28998 email message, and in flowed text can aid in delimiting paragraphs.
28999 However, the old behavior of stripping trailing whitespace was in place
29000 to better deal with older clients that couldn't handle certain types of
29001 text encodings.  This feature restores the old behavior
29002 <P>
29003 Trailing whitespace is of aid to flowed-text-formatted messages, which are
29004 generated by default but can be turned off via the
29005 <A HREF="h_config_quell_flowed_text">&quot;<!--#echo var="FEAT_quell-flowed-text"-->&quot;</A> feature.
29006 <!--#echo var="FEAT_strip-whitespace-before-send"--> also has the effect of turning off sending
29007 of flowed text.
29008 <P>
29009 &lt;End of help on this topic&gt;
29010 </BODY>
29011 </HTML>
29012 ====== h_config_del_from_dot =====
29013 <HTML>
29014 <HEAD>
29015 <TITLE>FEATURE: <!--#echo var="FEAT_compose-cut-from-cursor"--></TITLE>
29016 </HEAD>
29017 <BODY>
29018 <H1>FEATURE: <!--#echo var="FEAT_compose-cut-from-cursor"--></H1>
29019
29020 This feature controls the behavior of the Ctrl-K command in the composer.
29021 If set, ^K will cut from the current cursor position to the end of the line,
29022 rather than cutting the entire line.
29023
29024 <P>
29025 &lt;End of help on this topic&gt;
29026 </BODY>
29027 </HTML>
29028 ====== h_config_print_index =====
29029 <HTML>
29030 <HEAD>
29031 <TITLE>FEATURE: <!--#echo var="FEAT_print-index-enabled"--></TITLE>
29032 </HEAD>
29033 <BODY>
29034 <H1>FEATURE: <!--#echo var="FEAT_print-index-enabled"--></H1>
29035
29036 This feature controls the behavior of the Print command when in the
29037 MESSAGE INDEX screen.  If set, the print command will give you a prompt
29038 asking if you wish to print the message index, or the currently highlighted
29039 message. If not set, the message will be printed.
29040
29041 <P>
29042 &lt;End of help on this topic&gt;
29043 </BODY>
29044 </HTML>
29045 ====== h_config_allow_talk =====
29046 <HTML>
29047 <HEAD>
29048 <TITLE>FEATURE: <!--#echo var="FEAT_allow-talk"--></TITLE>
29049 </HEAD>
29050 <BODY>
29051 <H1>FEATURE: <!--#echo var="FEAT_allow-talk"--></H1>
29052
29053 UNIX Alpine only.
29054 <P>
29055 By default, permission for others to &quot;talk&quot; to your terminal is turned
29056 off when you are running Alpine.  When this feature is set, permission is
29057 instead turned on.  If enabled, you may see unexpected messages in the
29058 middle of your Alpine screen from someone attempting to contact you via the
29059 &quot;talk&quot; program.
29060
29061 <P>
29062 NOTE: The &quot;talk&quot; program has nothing to do with Alpine or email.  The
29063 talk daemon on your system will attempt to print a message on your screen
29064 when someone else is trying to contact you.  If you wish to see these
29065 messages while you are running Alpine, you should enable this feature.
29066
29067 <P>
29068 If you do enable this feature and see a &quot;talk&quot; message, you must
29069 suspend or quit Alpine before you can respond.
29070
29071 <P>
29072 &lt;End of help on this topic&gt;
29073 </BODY>
29074 </HTML>
29075 ====== h_config_send_filter_dflt =====
29076 <HTML>
29077 <HEAD>
29078 <TITLE>FEATURE: <!--#echo var="FEAT_compose-send-offers-first-filter"--></TITLE>
29079 </HEAD>
29080 <BODY>
29081 <H1>FEATURE: <!--#echo var="FEAT_compose-send-offers-first-filter"--></H1>
29082 If you have <A HREF="h_config_sending_filter">&quot;<!--#echo var="VAR_sending-filters"-->&quot;</A>
29083 configured, setting this feature will cause
29084 the first filter in the <!--#echo var="VAR_sending-filters"--> list to be offered as the default
29085 instead of unfiltered, the usual default.
29086 <P>
29087 <UL>
29088 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29089 </UL><P>
29090 &lt;End of help on this topic&gt;
29091 </BODY>
29092 </HTML>
29093 ====== h_config_custom_print =====
29094 <HTML>
29095 <HEAD>
29096 <TITLE>FEATURE: <!--#echo var="FEAT_print-offers-custom-cmd-prompt"--></TITLE>
29097 </HEAD>
29098 <BODY>
29099 <H1>FEATURE: <!--#echo var="FEAT_print-offers-custom-cmd-prompt"--></H1>
29100
29101 When this feature is set, the print command will have an additional
29102 subcommand called "C CustomPrint".  If selected, you will have
29103 the opportunity to enter any system print command --instead of being
29104 restricted to using those that have been previously configured in the
29105 printer setup menu.
29106 <P>
29107
29108 &lt;End of help on this topic&gt;
29109 </BODY>
29110 </HTML>
29111 ====== h_config_enable_dot_files =====
29112 <HTML>
29113 <HEAD>
29114 <TITLE>FEATURE: <!--#echo var="FEAT_enable-dot-files"--></TITLE>
29115 </HEAD>
29116 <BODY>
29117 <H1>FEATURE: <!--#echo var="FEAT_enable-dot-files"--></H1>
29118
29119 When this feature is set, files beginning with dot (".") will be
29120 visible in the file browser.  For example, you'll be able to select them
29121 when using the browser to add an attachment to a message.
29122 <P>
29123 &lt;End of help on this topic&gt;
29124 </BODY>
29125 </HTML>
29126 ====== h_config_enable_dot_folders =====
29127 <HTML>
29128 <HEAD>
29129 <TITLE>FEATURE: <!--#echo var="FEAT_enable-dot-folders"--></TITLE>
29130 </HEAD>
29131 <BODY>
29132 <H1>FEATURE: <!--#echo var="FEAT_enable-dot-folders"--></H1>
29133
29134 When this feature is set, folders beginning with dot (".") may be added
29135 and viewed.
29136 <P>
29137 &lt;End of help on this topic&gt;
29138 </BODY>
29139 </HTML>
29140 ====== h_config_ff_between_msgs =====
29141 <HTML>
29142 <HEAD>
29143 <TITLE>FEATURE: <!--#echo var="FEAT_print-formfeed-between-messages"--></TITLE>
29144 </HEAD>
29145 <BODY>
29146 <H1>FEATURE: <!--#echo var="FEAT_print-formfeed-between-messages"--></H1>
29147
29148 Setting this feature causes a formfeed to be printed between messages when
29149 printing multiple messages (with Apply Print command).
29150 <P>
29151 &lt;End of help on this topic&gt;
29152 </BODY>
29153 </HTML>
29154 ====== h_config_blank_keymenu =====
29155 <HTML>
29156 <HEAD>
29157 <TITLE>FEATURE: <!--#echo var="FEAT_disable-keymenu"--></TITLE>
29158 </HEAD>
29159 <BODY>
29160 <H1>FEATURE: <!--#echo var="FEAT_disable-keymenu"--></H1>
29161
29162 If this feature is set the command key menu that normally appears on the
29163 bottom two lines of the screen will not usually be there.  Asking for
29164 help with ^G or ? will cause the key menu to appear instead of causing
29165 the help message to come up.  If you want to actually see the help text,
29166 another ^G or ? will show it to you.  After the key menu has popped
29167 up with the help key it will remain there for an O for Other command but
29168 disappear if any other command is typed.
29169 <P>
29170 &lt;End of help on this topic&gt;
29171 </BODY>
29172 </HTML>
29173 ====== h_config_enable_mouse =====
29174 <HTML>
29175 <HEAD>
29176 <TITLE>FEATURE: <!--#echo var="FEAT_enable-mouse-in-xterm"--></TITLE>
29177 </HEAD>
29178 <BODY>
29179 <H1>FEATURE: <!--#echo var="FEAT_enable-mouse-in-xterm"--></H1>
29180
29181 This feature controls whether or not an X terminal mouse can be used with
29182 Alpine.  If set, and the $DISPLAY variable indicates that an X terminal is
29183 being used, the left mouse button on the mouse can be used to select text
29184 or commands.
29185 Clicking on a command at the bottom of the screen will behave as if you had
29186 typed that command.
29187 Clicking on an index line will move the current message highlight to
29188 that line.
29189 Double-clicking on an index line will view the message.
29190 Double-clicking on a link will view the link.
29191 <P>
29192 This type of mouse support will also work in some terminal emulators which are
29193 not actually X terminals, but which have extra code to support the xterm
29194 style mouse.
29195 For those emulators you not only need to turn this feature on but you also
29196 have to set the $DISPLAY environment variable even though it isn't needed
29197 for your terminal.
29198 That will cause Alpine to think that it is an xterm and to properly interpret the
29199 escape sequences sent by the mouse.
29200 <P>
29201 Note: if this feature is set, the behavior of X terminal cut-and-paste is
29202 also modified.  It is sometimes possible to hold the shift key down while clicking
29203 left or middle mouse buttons for the normal xterm cut/paste operations.
29204 There is also an Alpine command to toggle this mode on or off.
29205 The command is Ctrl-&#92; (Control-backslash).
29206 <P>
29207 &lt;End of help on this topic&gt;
29208 </BODY>
29209 </HTML>
29210 ====== h_config_enable_xterm_newmail =====
29211 <HTML>
29212 <HEAD>
29213 <TITLE>FEATURE: <!--#echo var="FEAT_enable-newmail-in-xterm-icon"--></TITLE>
29214 </HEAD>
29215 <BODY>
29216 <H1>FEATURE: <!--#echo var="FEAT_enable-newmail-in-xterm-icon"--></H1>
29217
29218 This feature controls whether or not Alpine will attempt to announce new
29219 mail arrival when it is running in an X terminal window and that window
29220 is iconified.  If set, and the $DISPLAY variable indicates that an X
29221 terminal is being used, Alpine will send appropriate escape sequences to
29222 the X terminal to modify the label on Alpine's icon to indicate that new
29223 mail has arrived. Alpine will also modify the Alpine window's title to
29224 indicate new mail.
29225 See also <a href="h_config_enable_newmail_short_text"><!--#echo var="FEAT_enable-newmail-short-text-in-icon"--></a>.
29226 <P>
29227 &lt;End of help on this topic&gt;
29228 </BODY></HTML>
29229 ====== h_config_enable_newmail_short_text =====
29230 <HTML>
29231 <HEAD>
29232 <TITLE>FEATURE: <!--#echo var="FEAT_enable-newmail-short-text-in-icon"--></TITLE>
29233 </HEAD>
29234 <BODY>
29235 <H1>FEATURE: <!--#echo var="FEAT_enable-newmail-short-text-in-icon"--></H1>
29236
29237 This feature controls the text to be displayed in an icon in the event
29238 of a new message arrival.  Normally, the message will
29239 be the one that is displayed on the screen.  This feature shortens the
29240 message to a count of the number of new messages in brackets.  This may be
29241 more useful for those who use the window's title bar in the task bar as a
29242 new mail indicator.  This feature is only useful if the
29243 <A HREF="h_config_enable_xterm_newmail"><!--#echo var="FEAT_enable-newmail-in-xterm-icon"--></A>
29244 feature is also set.  Like the <!--#echo var="FEAT_enable-newmail-in-xterm-icon"-->
29245 feature, this feature is only relevant when run in an xterm environment.
29246 <P>
29247 &lt;End of help on this topic&gt;
29248 </BODY></HTML>
29249 ====== h_config_copy_to_to_from =====
29250 <HTML>
29251 <HEAD>
29252 <TITLE>FEATURE: <!--#echo var="FEAT_copy-to-address-to-from-if-it-is-us"--></TITLE>
29253 </HEAD>
29254 <BODY>
29255 <H1>FEATURE: <!--#echo var="FEAT_copy-to-address-to-from-if-it-is-us"--></H1>
29256
29257 This feature affects the From address used when Replying to a message.
29258 It is probably only useful if you have some
29259 <a href="h_config_alt_addresses"><!--#echo var="VAR_alt-addresses"--></a>
29260 defined.
29261 When enabled, it checks to see if any of the addresses in the To or Cc
29262 fields of the message you are replying to is one of your addresses.
29263 If it is, and there is only one of them, then that address is used as
29264 the From address in the message you are composing.
29265 In other words, you will be using a From address that is the same
29266 as the To address that was used to get the mail to you in the first place.
29267
29268 <P>
29269 If a role is being used and it has a From address defined, that From address will
29270 be used rather than the one derived from this feature.
29271
29272 <P>
29273 <UL>
29274 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29275 </UL><P>
29276 &lt;End of help on this topic&gt;
29277 </BODY>
29278 </HTML>
29279 ====== h_config_prefix_editing =====
29280 <HTML>
29281 <HEAD>
29282 <TITLE>FEATURE: <!--#echo var="FEAT_enable-reply-indent-string-editing"--></TITLE>
29283 </HEAD>
29284 <BODY>
29285 <H1>FEATURE: <!--#echo var="FEAT_enable-reply-indent-string-editing"--></H1>
29286
29287 This feature affects the Reply command's &quot;Include original message
29288 in Reply?&quot; prompt.  When enabled, it causes the
29289 &quot;Edit Indent String&quot; sub-command to appear which allows
29290 you to edit the string Alpine would otherwise use to denote included
29291 text from the message being replied to.<P>
29292
29293 Thus, you can change Alpine's default message quote character (usually
29294 an angle bracket) on a per message basis. So you could change your quoted message to
29295 look, for example, like this:<p>
29296
29297 <pre>On Tues, 26 Jan 1999, John Q. Smith wrote:
29298
29299 John: I just wanted to say hello and to congratulate you
29300 John: on a job well done!</pre><p>
29301
29302 The configuration option
29303 <A HREF="h_config_reply_indent_string">&quot;<!--#echo var="VAR_reply-indent-string"-->&quot;</A>
29304 may be used to change what appears as the default string to be edited.
29305 <P>
29306 NOTE: Edited <!--#echo var="VAR_reply-indent-string"--> only apply to the message
29307 currently being replied to.
29308 <P>
29309 If you change your <!--#echo var="VAR_reply-indent-string"-->
29310 so that it is not equal to the default value of &quot;&gt;&nbsp;&quot;, then
29311 quoted text will not be flowed
29312 (<A HREF="h_config_quell_flowed_text">Flowed Text</A>)
29313 when you reply.
29314 For this reason, we recommend that you leave your <!--#echo var="VAR_reply-indent-string"-->
29315 set to the default value.
29316 <P>
29317 <UL>
29318 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29319 </UL><P>
29320 &lt;End of help on this topic&gt;
29321 </BODY>
29322 </HTML>
29323 ====== h_config_enable_search_and_repl =====
29324 <HTML>
29325 <HEAD>
29326 <TITLE>FEATURE: <!--#echo var="FEAT_enable-search-and-replace"--></TITLE>
29327 </HEAD>
29328 <BODY>
29329 <H1>FEATURE: <!--#echo var="FEAT_enable-search-and-replace"--></H1>
29330
29331 This feature modifies the behavior of Alpine's composer.  Setting this
29332 feature causes Alpine to offer the "^R Replace" subcommand, which
29333 allows you to search and replace text strings in a message you are composing,
29334 inside the "^W Where is" command.
29335
29336 <P>
29337
29338 To search and replace text, first enter the text to be replaced at the
29339 "Search: " prompt.  Then, rather than pressing Enter to just search for that
29340 text, press ^R, which turns the prompt into
29341
29342 <P>
29343
29344 Search (to replace):
29345
29346 <P>
29347
29348 and then press Enter.  The cursor will highlight the first occurrence
29349 of the text string you entered, and the prompt will show:
29350
29351 <P>
29352
29353 Replace "<your text string>" with :
29354
29355 <P>
29356
29357 where <your text string> is what you entered at the previous prompt;
29358 here, enter the replacement text.  To only replace the highlighted
29359 occurrence, simply press Enter now; to replace all occurrences in the
29360 message, press ^X (Repl All), then Enter.  You will then be asked to confirm
29361 each replacement.
29362
29363 <P>
29364
29365 The command ^R toggles between "Replace" and "Don't Replace"; its subcommand
29366 ^X toggles between "Replace All" and "Replace One."
29367
29368 <P>
29369
29370 If you previously searched for text in a message, it will be offered for
29371 re-use as part of the prompt, shown in [ ] brackets.
29372
29373 <P>
29374 &lt;End of help on this topic&gt;
29375 </BODY>
29376 </HTML>
29377 ====== h_config_enable_view_attach =====
29378 <HTML>
29379 <HEAD>
29380 <TITLE>FEATURE: <!--#echo var="FEAT_enable-msg-view-attachments"--></TITLE>
29381 </HEAD>
29382 <BODY>
29383 <H1>FEATURE: <!--#echo var="FEAT_enable-msg-view-attachments"--></H1>
29384
29385 This feature modifies the behavior of Alpine's MESSAGE TEXT screen.
29386 Setting this feature causes Alpine to present attachments in boldface.
29387 The first available attachment is displayed in inverse.  This is the
29388 "selected" attachment.  Pressing RETURN will cause Alpine to display
29389 the selected attachment.  Use the arrow keys to change which of the
29390 attachments displayed in boldface is the current selection.
29391
29392 <P>
29393
29394 Speaking of arrow keys, the Up and Down Arrows will select the next
29395 and previous attachments if one is available on the screen for selection.
29396 Otherwise, they will simply adjust the viewed text one line up or down.
29397
29398 <P>
29399
29400 Similarly, when selectable items are present in a message, the Ctrl-F key
29401 can be used to select the next item in the message independent of which
29402 portion of the viewed message is currently displayed. The Ctrl-B key can
29403 be used to select the previous item in the same way.
29404 <P>
29405 &lt;End of help on this topic&gt;
29406 </BODY>
29407 </HTML>
29408 ====== h_config_enable_y_print =====
29409 <HTML>
29410 <HEAD>
29411 <TITLE>FEATURE: <!--#echo var="FEAT_enable-print-via-y-command"--></TITLE>
29412 </HEAD>
29413 <BODY>
29414 <H1>FEATURE: <!--#echo var="FEAT_enable-print-via-y-command"--></H1>
29415
29416 This feature modifies the behavior of Alpine's Print command.
29417 <P>
29418 By default, Alpine's print command is available by pressing the "%" key.
29419 (This command is a substantial change from Pine versions before 4.00 --
29420 where the print command was "Y" -- based on numerous complaints about
29421 printing being invoked inadvertently, since Y also means "Yes.")
29422
29423 <P>
29424
29425 This feature is supplied to mitigate any disruption or anxiety users
29426 might feel as a result of this change.
29427
29428 <P>
29429
29430 Enabling this feature will cause Alpine to recognize both the old
29431 command, "Y" for Prynt, as well the new "%" method for invoking
29432 printing.  Note, key menu labels are not changed as a result of
29433 enabling this feature.
29434
29435 <P>
29436
29437 &lt;End of help on this topic&gt;
29438 </BODY>
29439 </HTML>
29440 ====== h_config_enable_lessthan_exit =====
29441 <HTML>
29442 <HEAD>
29443 <TITLE>FEATURE: <!--#echo var="FEAT_enable-exit-via-lessthan-command"--></TITLE>
29444 </HEAD>
29445 <BODY>
29446 <H1>FEATURE: <!--#echo var="FEAT_enable-exit-via-lessthan-command"--></H1>
29447
29448 If this feature is set, then on screens where there is an Exit command
29449 but no < command, the < key will perform the same function as the Exit
29450 command.
29451 This feature is set by default.
29452 <P>
29453 &lt;End of help on this topic&gt;
29454 </BODY>
29455 </HTML>
29456 ====== h_config_enable_view_url =====
29457 <HTML>
29458 <HEAD>
29459 <TITLE>FEATURE: <!--#echo var="FEAT_enable-msg-view-urls"--></TITLE>
29460 </HEAD>
29461 <BODY>
29462 <H1>FEATURE: <!--#echo var="FEAT_enable-msg-view-urls"--></H1>
29463 This feature modifies the behavior of Alpine's MESSAGE TEXT screen.
29464 When this feature is set (the default) Alpine will select possible URLs from the
29465 displayed text and display them in boldface for selection.
29466 <P>
29467 The first available URL is displayed in inverse.  This is the
29468 &quot;selected&quot; URL.  Pressing RETURN will cause Alpine to display
29469 the selected URL via either built-in means as with mailto:, imap:,
29470 news:, and nntp:, or via an external application as defined
29471 by the <A HREF="h_config_browser">&quot;url-viewer&quot;</A>
29472 variable.
29473 <P>
29474 Use the arrow keys to change which of the URLs displayed in boldface
29475 is the current selection.
29476 <P>
29477 Speaking of arrow keys, the Up and Down Arrows will select the next
29478 and previous URL if one is available on the screen for selection (unless
29479 you have set the feature
29480 <A HREF="h_config_enable_view_arrows">&quot;<!--#echo var="FEAT_enable-msg-view-forced-arrows"-->&quot;</A>).
29481 Otherwise, they will simply adjust the viewed text one line up or down.
29482 <P>
29483 Similarly, when selectable items are present in a message, the Ctrl-F
29484 key can be used to select the next item in the message independent
29485 of which portion of the viewed message is currently displayed. The
29486 Ctrl-B key can be used to select the previous item in the same way.
29487 <P>
29488 <UL>
29489 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29490 </UL><P>
29491 &lt;End of help on this topic&gt;
29492 </BODY>
29493 </HTML>
29494 ====== h_config_enable_view_web_host =====
29495 <HTML>
29496 <HEAD>
29497 <TITLE>FEATURE: <!--#echo var="FEAT_enable-msg-view-web-hostnames"--></TITLE>
29498 </HEAD>
29499 <BODY>
29500 <H1>FEATURE: <!--#echo var="FEAT_enable-msg-view-web-hostnames"--></H1>
29501
29502 This feature modifies the behavior of Alpine's MESSAGE TEXT screen.
29503 When this feature is set (the default) Alpine will select possible web hostnames
29504 from the displayed text and display them in boldface for selection.
29505 This can be useful when you receive messages referencing World Wide Web
29506 sites without the use of complete URLs; for example, specifying only
29507 &quot;www.patches.freeiz.com/alpine/&quot; (which will <B>not</B> become a
29508 selectable
29509 item by setting <A HREF="h_config_enable_view_url">&quot;<!--#echo var="FEAT_enable-msg-view-urls"-->&quot;</A>)
29510 rather than explicitly
29511 &quot;http://www.patches.freeiz.com/alpine/&quot;.
29512 <P>
29513 The first available hostname is displayed in inverse.  This is the
29514 &quot;selected&quot; hostname.  Pressing RETURN will cause Alpine to display
29515 the selected hostname via an external application as defined
29516 by the <A HREF="h_config_browser">&quot;url-viewer&quot;</A>
29517 variable.
29518 <P>
29519 Use the arrow keys (unless you have set the feature
29520 <A HREF="h_config_enable_view_arrows">&quot;<!--#echo var="FEAT_enable-msg-view-forced-arrows"-->&quot;</A>)
29521 to change which of the hostnames displayed in
29522 boldface is the current selection.
29523 <P>
29524 Similarly, when selectable web hostnames are present in a message, the Ctrl-F
29525 key can be used to select the next web hostname in the message independent
29526 of which portion of the viewed message is currently displayed. The
29527 Ctrl-B key can be used to select the previous web hostnames in the same way.
29528 <P>
29529 <UL>
29530 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29531 </UL><P>
29532 &lt;End of help on this topic&gt;
29533 </BODY>
29534 </HTML>
29535 ====== h_config_enable_view_addresses =====
29536 <HTML>
29537 <HEAD>
29538 <TITLE>FEATURE: <!--#echo var="FEAT_enable-msg-view-addresses"--></TITLE>
29539 </HEAD>
29540 <BODY>
29541 <H1>FEATURE: <!--#echo var="FEAT_enable-msg-view-addresses"--></H1>
29542
29543 This feature modifies the behavior of Alpine's MESSAGE TEXT screen.
29544 Setting this feature causes Alpine to select possible email addresses
29545 from the displayed text and display them in boldface for selection.
29546
29547 <P>
29548 The first available email address is displayed in inverse.  This is the
29549 &quot;selected&quot; address.  Pressing RETURN will cause Alpine to enter
29550 the message composition screen with the To: field filled in with the
29551 selected address.
29552 <P>
29553 Use the arrow keys (unless you have set the feature
29554 <A HREF="h_config_enable_view_arrows">&quot;<!--#echo var="FEAT_enable-msg-view-forced-arrows"-->&quot;</A>)
29555 to change which of the hostnames displayed in
29556 boldface is the current selection.
29557 <P>
29558 Similarly, when selectable web hostnames are present in a message, the Ctrl-F
29559 key can be used to select the next web hostname in the message independent
29560 of which portion of the viewed message is currently displayed. The
29561 Ctrl-B key can be used to select the previous web hostnames in the same way.
29562 <P>
29563 <UL>
29564 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29565 </UL><P>
29566 &lt;End of help on this topic&gt;
29567 </BODY>
29568 </HTML>
29569 ====== h_config_enable_view_arrows =====
29570 <HTML>
29571 <HEAD>
29572 <TITLE>FEATURE: <!--#echo var="FEAT_enable-msg-view-forced-arrows"--></TITLE>
29573 </HEAD>
29574 <BODY>
29575 <H1>FEATURE: <!--#echo var="FEAT_enable-msg-view-forced-arrows"--></H1>
29576
29577 This feature modifies Up and Down arrow key behavior in Alpine's
29578 MESSAGE TEXT screen when selectable Attachments, URL's, or
29579 web-hostnames are presented. Alpine's usual behavior is to move to
29580 the next or previous selectable item if currently displayed or
29581 simply to adjust the screen view by one line.
29582
29583 <P>
29584
29585 Setting this feature causes the UP and Down arrow key to behave as
29586 if no selectable items were present in the message.
29587
29588 <P>
29589
29590 Note, the Ctrl-F (next selectable item) and Ctrl-B (previous selectable
29591 item) functionality is unchanged.
29592 <P>
29593
29594 &lt;End of help on this topic&gt;
29595 </BODY>
29596 <HTML>
29597 ====== h_config_quell_charset_warning =====
29598 <HTML>
29599 <HEAD>
29600 <TITLE>FEATURE: <!--#echo var="FEAT_quell-charset-warning"--></TITLE>
29601 </HEAD>
29602 <BODY>
29603 <H1>FEATURE: <!--#echo var="FEAT_quell-charset-warning"--></H1>
29604
29605 By default, if the message you are viewing contains characters that are
29606 not representable in your
29607 <A HREF="h_config_char_set">&quot;Display Character Set&quot;</A>
29608 then Alpine will
29609 add a warning to the start of the displayed text.
29610 If this option is set, then that editorial message will be suppressed.
29611 <P>
29612 Setting this feature also suppresses the comment about the character set
29613 in header lines.
29614 For example, when viewing a message you might see
29615 <P>
29616 <CENTER><SAMP>From: &quot;[ISO-8859-2] Name&quot; &lt;address&gt;</SAMP></CENTER>
29617 <P>
29618 in the From header if your Character-Set is something other than ISO-8859-2.
29619 If you set this feature, the comment about the character set will
29620 no longer be there.
29621 <P>
29622 &lt;End of help on this topic&gt;
29623 </BODY>
29624 </HTML>
29625 ====== h_config_quell_host_after_url =====
29626 <HTML>
29627 <HEAD>
29628 <TITLE>FEATURE: <!--#echo var="FEAT_quell-server-after-link-in-html"--></TITLE>
29629 </HEAD>
29630 <BODY>
29631 <H1>FEATURE: <!--#echo var="FEAT_quell-server-after-link-in-html"--></H1>
29632
29633 By default, links in HTML text are displayed with the host the link
29634 references appended, within square brackets, to the link text.  Alpine
29635 does this to help indicate where a link will take you, particularly when
29636 the link text might suggest a different destination.
29637
29638 <P>
29639 Setting this feature will prevent the server name from being appended
29640 to the displayed text.
29641
29642 <P>
29643 &lt;End of help on this topic&gt;
29644 </BODY>
29645 </HTML>
29646 ====== h_config_prefer_plain_text =====
29647 <HTML>
29648 <HEAD>
29649 <TITLE>FEATURE: <!--#echo var="FEAT_prefer-plain-text"--></TITLE>
29650 </HEAD>
29651 <BODY>
29652 <H1>FEATURE: <!--#echo var="FEAT_prefer-plain-text"--></H1>
29653
29654 A message being viewed may contain alternate versions of the same content.
29655 Those alternate versions are supposed to be ordered by the sending software such that the
29656 first alternative is the least preferred and the last alternative is the
29657 most preferred. Alpine will normally display the most-preferred version that
29658 it knows how to display. This is most often encountered where the two
29659 alternate versions are a plain text version and an HTML version, with the
29660 HTML version listed last as the most preferred.
29661 <P>
29662 If this option is set, then any plain text version will be preferred to
29663 all other versions.
29664 <P>
29665 When viewing a message there is a command &quot;A TogglePreferPlain&quot;,
29666 which will temporarily change the sense of this option.
29667 If this option is set you will first see the plain text version of a
29668 message.
29669 If you then type the &quot;A&quot; command, you will see the most preferred version,
29670 most likely HTML, instead.
29671 Typing the &quot;A&quot; command a second time will switch it back.
29672 Alternatively, if the present option is not set you will originally see
29673 the most preferred version of the message and typing &quot;A&quot; will switch to
29674 the plain text version.
29675 <P>
29676 &lt;End of help on this topic&gt;
29677 </BODY>
29678 </HTML>
29679 ====== h_config_pass_control =====
29680 <HTML>
29681 <HEAD>
29682 <TITLE>FEATURE: <!--#echo var="FEAT_pass-control-characters-as-is"--></TITLE>
29683 </HEAD>
29684 <BODY>
29685 <H1>FEATURE: <!--#echo var="FEAT_pass-control-characters-as-is"--></H1>
29686
29687 It is probably not useful to set this option.
29688 This is a legacy option left behind &quot;just in case&quot;.
29689 Multi-byte characters that have an octet that has the same
29690 value as a control character are permitted through whether or not
29691 this option is turned on.
29692 <P>
29693 This feature controls how certain characters contained in messages are
29694 displayed.
29695 If set, all characters in a message will be sent to the
29696 screen. Normally, control characters are displayed as shown below to
29697 avoid a garbled screen and to
29698 avoid inadvertently changing terminal setup parameters.
29699 Control characters are usually displayed as two character sequences like
29700 <P><CENTER><SAMP> ^C </SAMP></CENTER><P>
29701 for Control-C,
29702 <P><CENTER><SAMP> ^[ </SAMP></CENTER><P>
29703 for ESCAPE,
29704 <P><CENTER><SAMP> ^? </SAMP></CENTER><P>
29705 for DELETE, and
29706 <P><CENTER><SAMP> ~E </SAMP></CENTER><P>
29707 for the character with value 133 (0x85).
29708 (The DEL character is displayed as ^?, regular control characters are displayed
29709 as the character ^ followed by the character obtained by adding the
29710 five low-order bits of the character to 0x40, and the C1
29711 control characters 0x80 - 0x9F are displayed as the character ~ followed by the
29712 character obtained by adding the
29713 five low-order bits of the character to 0x40.)
29714 Sometimes, in cases where changing a single control character into a
29715 two-character sequence would confuse Alpine's display routines,
29716 a question mark is substituted for the control character.
29717 <P>
29718 If you wish to filter out regular control characters but pass the
29719 so-called C1 control characters (0x80 <= char < 0xA0) through unchanged, then
29720 you may leave this feature unset and set the feature <A HREF="h_config_pass_c1_control"><!--#echo var="FEAT_pass-c1-control-characters-as-is"--></A> instead.
29721 <P>
29722 &lt;End of help on this topic&gt;
29723 </BODY>
29724 </HTML>
29725 ====== h_config_pass_c1_control =====
29726 <HTML>
29727 <HEAD>
29728 <TITLE>FEATURE: <!--#echo var="FEAT_pass-c1-control-characters-as-is"--></TITLE>
29729 </HEAD>
29730 <BODY>
29731 <H1>FEATURE: <!--#echo var="FEAT_pass-c1-control-characters-as-is"--></H1>
29732
29733 It is probably not useful to set this option.
29734 This is a legacy option left behind &quot;just in case&quot;.
29735 Multi-byte characters that have an octet that has the same
29736 value as a control character are permitted through whether or not
29737 this option is turned on.
29738 <P>
29739 If the feature <A HREF="h_config_pass_control"><!--#echo var="FEAT_pass-control-characters-as-is"--></A>
29740 is set, then this feature has no effect.
29741 However, if you wish to filter out regular control characters but pass the
29742 so-called C1 control characters (0x80 <= char < 0xA0) through unchanged, then
29743 you may leave <A HREF="h_config_pass_control"><!--#echo var="FEAT_pass-control-characters-as-is"--></A>
29744 unset and set this feature.
29745 <P>
29746 &lt;End of help on this topic&gt;
29747 </BODY>
29748 </HTML>
29749 ====== h_config_fcc_on_bounce =====
29750 <HTML>
29751 <HEAD>
29752 <TITLE>FEATURE: <!--#echo var="FEAT_fcc-on-bounce"--></TITLE>
29753 </HEAD>
29754 <BODY>
29755 <H1>FEATURE: <!--#echo var="FEAT_fcc-on-bounce"--></H1>
29756
29757 This feature controls an aspect of Alpine's behavior when bouncing a
29758 message. If set, normal FCC ("File Carbon Copy") processing will be
29759 done, just as if you had composed a message to the address you are
29760 bouncing to.  If not set, no FCC of the message will be saved.
29761 <P>
29762 &lt;End of help on this topic&gt;
29763 </BODY>
29764 </HTML>
29765 ====== h_config_show_cursor =====
29766 <HTML>
29767 <HEAD>
29768 <TITLE>FEATURE: <!--#echo var="FEAT_show-cursor"--></TITLE>
29769 </HEAD>
29770 <BODY>
29771 <H1>FEATURE: <!--#echo var="FEAT_show-cursor"--></H1>
29772
29773 This feature controls an aspect of Alpine's displays.  If set, the system
29774 cursor will move to convenient locations in the displays.  For example,
29775 to the beginning of the status field of the highlighted index line, or
29776 to the highlighted word after a successful WhereIs command.  It is intended
29777 to draw your attention to an "interesting" spot on the screen.
29778 <P>
29779 &lt;End of help on this topic&gt;
29780 </BODY>
29781 </HTML>
29782 ====== h_config_sort_fcc_alpha =====
29783 <HTML>
29784 <HEAD>
29785 <TITLE>FEATURE: <!--#echo var="FEAT_sort-default-fcc-alpha"--></TITLE>
29786 </HEAD>
29787 <BODY>
29788 <H1>FEATURE: <!--#echo var="FEAT_sort-default-fcc-alpha"--></H1>
29789
29790 This feature controls an aspect of Alpine's FOLDER LIST screen.
29791 If set, the default Fcc folder will be sorted alphabetically with the other
29792 folders instead of appearing right after the INBOX.
29793 <P>
29794 &lt;End of help on this topic&gt;
29795 </BODY>
29796 </HTML>
29797 ====== h_config_sort_save_alpha =====
29798 <HTML>
29799 <HEAD>
29800 <TITLE>FEATURE: <!--#echo var="FEAT_sort-default-save-alpha"--></TITLE>
29801 </HEAD>
29802 <BODY>
29803 <H1>FEATURE: <!--#echo var="FEAT_sort-default-save-alpha"--></H1>
29804
29805 This feature controls an aspect of Alpine's FOLDER LIST screen.
29806 If set, the default save folder will be sorted alphabetically with the other
29807 folders instead of appearing right after the INBOX (and default FCC folder).
29808 <P>
29809 &lt;End of help on this topic&gt;
29810 </BODY>
29811 </HTML>
29812 ====== h_config_single_list =====
29813 <HTML>
29814 <HEAD>
29815 <TITLE>FEATURE: <!--#echo var="FEAT_single-column-folder-list"--></TITLE>
29816 </HEAD>
29817 <BODY>
29818 <H1>FEATURE: <!--#echo var="FEAT_single-column-folder-list"--></H1>
29819
29820 This feature controls an aspect of Alpine's FOLDER LIST screen.  If set,
29821 the folders will be listed one per line instead of several per line
29822 in the FOLDER LIST display.
29823 <P>
29824 &lt;End of help on this topic&gt;
29825 </BODY>
29826 </HTML>
29827 ====== h_config_vertical_list =====
29828 <HTML>
29829 <HEAD>
29830 <TITLE>FEATURE: <!--#echo var="FEAT_vertical-folder-list"--></TITLE>
29831 </HEAD>
29832 <BODY>
29833 <H1>FEATURE: <!--#echo var="FEAT_vertical-folder-list"--></H1>
29834
29835 This feature controls an aspect of Alpine's FOLDER LIST screen.  If set,
29836 the folders will be listed alphabetically down the columns rather
29837 than across the columns as is the default.
29838 <P>
29839 &lt;End of help on this topic&gt;
29840 </BODY>
29841 </HTML>
29842 ====== h_config_verbose_post =====
29843 <HTML>
29844 <HEAD>
29845 <TITLE>FEATURE: <!--#echo var="FEAT_enable-verbose-smtp-posting"--></TITLE>
29846 </HEAD>
29847 <BODY>
29848 <H1>FEATURE: <!--#echo var="FEAT_enable-verbose-smtp-posting"--></H1>
29849 This feature controls an aspect of Alpine's message sending.  When enabled,
29850 Alpine will send a VERB (i.e., VERBose) command early in the posting process
29851 intended to cause the SMTP server to provide a more detailed account of
29852 the transaction.  This feature is typically only useful to system
29853 administrators and other support personel as an aid in troublshooting
29854 problems.
29855 <P>
29856 Note, this feature relies on a specific capability of the system's mail
29857 transport agent or configured
29858 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>.
29859 It is possible that this
29860 feature will cause problems for some tranport agents, and may result in
29861 sending failure.  In addition, as the verbose output comes from the mail
29862 transport agent, it is likely to vary from one system to another.
29863 <P><UL>
29864 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29865 </UL><P>
29866 &lt;End of help on this topic&gt;
29867 </BODY>
29868 </HTML>
29869 ====== h_config_auto_reply_to =====
29870 <HTML>
29871 <HEAD>
29872 <TITLE>FEATURE: <!--#echo var="FEAT_reply-always-uses-reply-to"--></TITLE>
29873 </HEAD>
29874 <BODY>
29875 <H1>FEATURE: <!--#echo var="FEAT_reply-always-uses-reply-to"--></H1>
29876
29877 This feature controls an aspect of Alpine's Reply command.  If set, Alpine
29878 will not prompt when a message being replied to contains a "Reply-To:"
29879 header value, but will simply use its value (as opposed to using the
29880 "From:" field's value).
29881
29882 <P>
29883
29884 Note: Using the "Reply-To:" address is usually the preferred behavior,
29885 however, some mailing list managers choose to place the list's address in
29886 the "Reply-To:" field of any message sent out to the list.  In such
29887 cases, this feature makes it all too easy for personal replies to be
29888 inadvertently sent to the entire mail list, so be careful!
29889 <P>
29890 &lt;End of help on this topic&gt;
29891 </BODY>
29892 </HTML>
29893 ====== h_config_del_skips_del =====
29894 <HTML>
29895 <HEAD>
29896 <TITLE>FEATURE: <!--#echo var="FEAT_delete-skips-deleted"--></TITLE>
29897 </HEAD>
29898 <BODY>
29899 <H1>FEATURE: <!--#echo var="FEAT_delete-skips-deleted"--></H1>
29900
29901 This feature controls an aspect of Alpine's Delete command.  If set, this
29902 feature will cause the Delete command to advance past following messages that
29903 are marked deleted.  In other words, pressing "D" will both mark the
29904 current message deleted and advance to the next message that is not marked
29905 deleted.
29906 This feature is set by default.
29907 <P>
29908 &lt;End of help on this topic&gt;
29909 </BODY></HTML>
29910 ====== h_config_expunge_manually =====
29911 <HTML>
29912 <HEAD>
29913 <TITLE>FEATURE: <!--#echo var="FEAT_expunge-only-manually"--></TITLE>
29914 </HEAD>
29915 <BODY>
29916 <H1>FEATURE: <!--#echo var="FEAT_expunge-only-manually"--></H1>
29917
29918 Normally, when you close a folder that contains deleted messages you are
29919 asked if you want to expunge those messages from the folder permanently.
29920 If this feature is set, you won't be asked and the deleted messages will
29921 remain in the folder.
29922 If you choose to set this feature you will have to expunge the
29923 messages manually using the eXpunge command, which you can use while
29924 in the MESSAGE INDEX screen.
29925 If you do not expunge deleted messages the size of your
29926 folder will continue to increase until you are out of disk space.
29927 <P>
29928 <UL>
29929 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29930 </UL><P>
29931 &lt;End of help on this topic&gt;
29932 </BODY>
29933 </HTML>
29934 ====== h_config_auto_expunge =====
29935 <HTML>
29936 <HEAD>
29937 <TITLE>FEATURE: <!--#echo var="FEAT_expunge-without-confirm"--></TITLE>
29938 </HEAD>
29939 <BODY>
29940 <H1>FEATURE: <!--#echo var="FEAT_expunge-without-confirm"--></H1>
29941
29942 This features controls an aspect of Alpine's eXpunge command.  If set, you
29943 will <B>not</B> be prompted to confirm your intent before the expunge takes
29944 place.
29945 Actually, this is only true for the INBOX folder and for folders in the
29946 Incoming Folders collection. See the feature
29947 <A HREF="h_config_full_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm-everywhere"-->&quot;</A>.
29948 <P>
29949 <UL>
29950 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29951 </UL><P>
29952 &lt;End of help on this topic&gt;
29953 </BODY>
29954 </HTML>
29955 ====== h_config_full_auto_expunge =====
29956 <HTML>
29957 <HEAD>
29958 <TITLE>FEATURE: <!--#echo var="FEAT_expunge-without-confirm-everywhere"--></TITLE>
29959 </HEAD>
29960 <BODY>
29961 <H1>FEATURE: <!--#echo var="FEAT_expunge-without-confirm-everywhere"--></H1>
29962
29963 This features controls an aspect of Alpine's eXpunge command.  If set, you
29964 will <B>not</B> be prompted to confirm your intent before the expunge
29965 takes place.  This feature sets this behavior for all folders, unlike the
29966 <A HREF="h_config_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm"-->&quot;</A>
29967 feature that works only for incoming folders.
29968 <P>
29969 <UL>
29970 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29971 </UL><P>
29972 &lt;End of help on this topic&gt;
29973 </BODY>
29974 </HTML>
29975 ====== h_config_auto_read_msgs =====
29976 <HTML>
29977 <HEAD>
29978 <TITLE>FEATURE: <!--#echo var="FEAT_auto-move-read-msgs"--></TITLE>
29979 </HEAD>
29980 <BODY>
29981 <H1>FEATURE: <!--#echo var="FEAT_auto-move-read-msgs"--></H1>
29982 This feature controls an aspect of Alpine's behavior upon quitting.  If set,
29983 and the
29984 <A HREF="h_config_read_message_folder">&quot;<!--#echo var="VAR_read-message-folder"-->&quot;</A>
29985 option is also set, then Alpine will
29986 automatically transfer all read messages to the designated folder and mark
29987 them as deleted in the INBOX.  Messages in the INBOX marked with an
29988 &quot;N&quot; (meaning New, or unseen) are not affected.
29989 <P>
29990 <UL>
29991 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29992 </UL><P>
29993 &lt;End of help on this topic&gt;
29994 </BODY>
29995 </HTML>
29996 ====== h_config_auto_fcc_only =====
29997 <HTML>
29998 <HEAD>
29999 <TITLE>FEATURE: <!--#echo var="FEAT_fcc-only-without-confirm"--></TITLE>
30000 </HEAD>
30001 <BODY>
30002 <H1>FEATURE: <!--#echo var="FEAT_fcc-only-without-confirm"--></H1>
30003 This features controls an aspect of Alpine's composer.
30004 The only time this feature will be used is if you attempt to send mail
30005 that has no recipients but does have an Fcc.
30006 Normally, Alpine will ask if you really mean to copy the message only to
30007 the Fcc.
30008 That is, it asks if you really meant to have no recipients.
30009 If this feature is set, you
30010 will <B>not</B> be prompted to confirm your intent to make only a copy
30011 of a message with no recipients.
30012 <P>
30013 This feature is closely related to
30014 <A HREF="h_config_warn_if_no_to_or_cc"><!--#echo var="FEAT_warn-if-blank-to-and-cc-and-newsgroups"--></A>.
30015 The difference between this feature and that feature is that this feature
30016 considers a Bcc to be a recipient while that feature will ask for confirmation
30017 even if there is a Bcc when there is no To, Cc, or Newsgroup.
30018 The default values also differ. This feature defaults to asking the question
30019 and you have to turn it off.
30020 The <!--#echo var="FEAT_warn-if-blank-to-and-cc-and-newsgroups"--> feature defaults to not asking
30021 unless you turn it on.
30022 <P>
30023
30024 <UL>
30025 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30026 </UL><P>
30027 &lt;End of help on this topic&gt;
30028 </BODY>
30029 </HTML>
30030 ====== h_config_mark_fcc_seen =====
30031 <HTML>
30032 <HEAD>
30033 <TITLE>FEATURE: <!--#echo var="FEAT_mark-fcc-seen"--></TITLE>
30034 </HEAD>
30035 <BODY>
30036 <H1>FEATURE: <!--#echo var="FEAT_mark-fcc-seen"--></H1>
30037
30038 This features controls the way Fccs (File carbon copies) are
30039 made of the messages you send.
30040
30041 <P>
30042 Normally, when Alpine saves a copy of a message you sent as an Fcc, that
30043 copy will be marked as Unseen.
30044 When you look at the folder it was saved in the message will appear to
30045 be a New message until you read it.
30046 When this feature is enabled, the message will be marked as having
30047 been Seen.
30048
30049 <P>
30050 <UL>
30051 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30052 </UL><P>
30053 &lt;End of help on this topic&gt;
30054 </BODY>
30055 </HTML>
30056 ====== h_config_no_fcc_attach =====
30057 <HTML>
30058 <HEAD>
30059 <TITLE>FEATURE: <!--#echo var="FEAT_fcc-without-attachments"--></TITLE>
30060 </HEAD>
30061 <BODY>
30062 <H1>FEATURE: <!--#echo var="FEAT_fcc-without-attachments"--></H1>
30063
30064 This features controls the way Fcc's (File carbon copies) are
30065 made of the messages you send.
30066
30067 <P>
30068 Normally, Alpine saves an exact copy of your message as it was sent.
30069 When this feature is enabled, the &quot;body&quot; of the message
30070 you send (the text you type in the composer) is preserved in the
30071 copy as before, however all attachments are replaced with text
30072 explaining what had been sent rather than the attachments themselves.
30073
30074 <P>
30075 This feature also affects Alpine's &quot;Send ?&quot; confirmation prompt
30076 in that a new &quot;^F Fcc Attchmnts&quot; option becomes available which
30077 allows you to interactively set whether or not attachments are saved
30078 to the Fcc'd copy.
30079
30080 <P>
30081 <UL>
30082 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30083 </UL><P>
30084 &lt;End of help on this topic&gt;
30085 </BODY>
30086 </HTML>
30087 ====== h_config_read_in_newsrc_order =====
30088 <HTML>
30089 <HEAD>
30090 <TITLE>FEATURE: <!--#echo var="FEAT_news-read-in-newsrc-order"--></TITLE>
30091 </HEAD>
30092 <BODY>
30093 <H1>FEATURE: <!--#echo var="FEAT_news-read-in-newsrc-order"--></H1>
30094
30095 This feature controls the order in which newsgroups will be presented.  If
30096 set, they will be presented in the same order as they occur in your
30097 <!--chtml if pinemode="os_windows"-->
30098 &quot;NEWSRC&quot;
30099 <!--chtml else-->
30100 &quot;.newsrc&quot;
30101 <!--chtml endif-->
30102 file (the default location of which can be changed with the
30103 <A HREF="h_config_newsrc_path">&quot;<!--#echo var="VAR_newsrc-path"-->&quot;</A> option).
30104 <P>
30105 If not set, the newsgroups will be presented in alphabetical order.
30106 <P>
30107 <UL>
30108 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30109 </UL><P>
30110 &lt;End of help on this topic&gt;
30111 </BODY>
30112 </HTML>
30113 ====== h_config_quell_tz_comment =====
30114 <HTML>
30115 <HEAD>
30116 <TITLE>FEATURE: <!--#echo var="FEAT_quell-timezone-comment-when-sending"--></TITLE>
30117 </HEAD>
30118 <BODY>
30119 <H1>FEATURE: <!--#echo var="FEAT_quell-timezone-comment-when-sending"--></H1>
30120
30121 Normally, when Alpine generates a Date header for outgoing mail,
30122 it will try to include the symbolic timezone at the end of the
30123 header inside parentheses.
30124 The symbolic timezone is often three characters long, but on
30125 some operating systems, it may be longer.
30126 Apparently there are some SMTP servers in the world that will reject an
30127 incoming message if it has a Date header longer than about 80 characters.
30128 If this feature is set, the symbolic timezone normally generated by
30129 Alpine will not be included.
30130 You probably don't need to worry about this feature unless you run into
30131 the problem described above.
30132
30133 <P>
30134 &lt;End of help on this topic&gt;
30135 </BODY>
30136 </HTML>
30137 ====== h_config_post_wo_validation =====
30138 <HTML>
30139 <HEAD>
30140 <TITLE>FEATURE: <!--#echo var="FEAT_news-post-without-validation"--></TITLE>
30141 </HEAD>
30142 <BODY>
30143 <H1>FEATURE: <!--#echo var="FEAT_news-post-without-validation"--></H1>
30144
30145 This feature controls whether the NNTP server is queried as newsgroups
30146 are entered for posting.  Validation over slow links (e.g. dialup using
30147 SLIP or PPP) can cause delays.  Set this feature to eliminate such delays.
30148 <P>
30149 &lt;End of help on this topic&gt;
30150 </BODY>
30151 </HTML>
30152 ====== h_config_send_wo_confirm =====
30153 <HTML>
30154 <HEAD>
30155 <TITLE>FEATURE: <!--#echo var="FEAT_send-without-confirm"--></TITLE>
30156 </HEAD>
30157 <BODY>
30158 <H1>FEATURE: <!--#echo var="FEAT_send-without-confirm"--></H1>
30159
30160 By default, when you send or post a message you will be asked to confirm
30161 with a question that looks something like:
30162
30163 <P>
30164 <CENTER><SAMP>Send message?</SAMP></CENTER>
30165 <P>
30166
30167 If this feature is set, you
30168 will <B>not</B> be prompted to confirm your intent to send
30169 and your message will be sent.
30170 <P>
30171 If this feature is set it disables some possibilities and renders some
30172 other features meaningless.
30173 You will not be able to use
30174 <A HREF="h_config_sending_filter">Sending Filters</A>,
30175 Verbose sending mode,
30176 <A HREF="h_config_compose_bg_post">Background Sending</A>,
30177 <A HREF="h_config_compose_dsn">Delivery Status Notifications</A>,
30178 or ^V to turn off the generation of flowed text for this message.
30179 These options are normally available as suboptions in the Send prompt, but
30180 with no Send prompt the options are gone.
30181
30182 <P>
30183 A somewhat related feature is
30184 <A HREF="h_config_quell_post_prompt">&quot;<!--#echo var="FEAT_quell-extra-post-prompt"-->&quot;</A>,
30185 which may be used to eliminate the extra confirmation
30186 question when posting to a newsgroup.
30187 <P>
30188 <UL>
30189 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30190 </UL><P>
30191 &lt;End of help on this topic&gt;
30192 </BODY>
30193 </HTML>
30194 ====== h_config_quell_filtering_done_message =====
30195 <HTML>
30196 <HEAD>
30197 <TITLE>FEATURE: <!--#echo var="FEAT_quell-filtering-done-message"--></TITLE>
30198 </HEAD>
30199 <BODY>
30200 <H1>FEATURE: <!--#echo var="FEAT_quell-filtering-done-message"--></H1>
30201
30202 If you use Filter Rules that move messages or set status of messages
30203 you sometimes see a message from Alpine that looks like
30204
30205 <P>
30206 <CENTER><SAMP>filtering done</SAMP></CENTER>
30207 <P>
30208
30209 If this feature is set, this message will be suppressed.
30210 If the feature
30211 <A HREF="h_config_quell_filtering_messages"><!--#echo var="FEAT_quell-filtering-messages"--></A>
30212 is set then this message will be suppressed regardless.
30213
30214 <P>
30215 <UL>
30216 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30217 </UL><P>
30218 &lt;End of help on this topic&gt;
30219 </BODY>
30220 </HTML>
30221 ====== h_config_quell_filtering_messages =====
30222 <HTML>
30223 <HEAD>
30224 <TITLE>FEATURE: <!--#echo var="FEAT_quell-filtering-messages"--></TITLE>
30225 </HEAD>
30226 <BODY>
30227 <H1>FEATURE: <!--#echo var="FEAT_quell-filtering-messages"--></H1>
30228
30229 If you use Filter Rules that move messages or set status of messages
30230 you sometimes see messages from Alpine that look like
30231
30232 <P>
30233 <CENTER><SAMP>&lt;filter name&gt;: Moving 2 filtered messages to &lt;folder name&gt;</SAMP></CENTER>
30234 <P>
30235
30236 or
30237
30238 <P>
30239 <CENTER><SAMP>&lt;filter name&gt;: Setting flags in 5 messages</SAMP></CENTER>
30240 <P>
30241
30242 or
30243
30244 <P>
30245 <CENTER><SAMP>Processing filter &lt;filter name&gt;</SAMP></CENTER>
30246 <P>
30247
30248 If this feature is set, these messages will be suppressed.
30249 The feature
30250 <A HREF="h_config_quell_filtering_done_message"><!--#echo var="FEAT_quell-filtering-done-message"--></A>
30251 is related.
30252
30253 <P>
30254 <UL>
30255 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30256 </UL><P>
30257 &lt;End of help on this topic&gt;
30258 </BODY>
30259 </HTML>
30260 ====== h_config_quell_post_prompt =====
30261 <HTML>
30262 <HEAD>
30263 <TITLE>FEATURE: <!--#echo var="FEAT_quell-extra-post-prompt"--></TITLE>
30264 </HEAD>
30265 <BODY>
30266 <H1>FEATURE: <!--#echo var="FEAT_quell-extra-post-prompt"--></H1>
30267
30268 By default, when you post a message to a newsgroup you are asked to confirm
30269 that you want to post with the question
30270
30271 <P>
30272 <CENTER><SAMP>Posted message may go to thousands of readers. Really post?</SAMP></CENTER>
30273 <P>
30274
30275 If this feature is set, you
30276 will <B>not</B> be prompted to confirm your intent to post to a newsgroup
30277 and your message will be posted.
30278
30279 <P>
30280 <UL>
30281 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30282 </UL><P>
30283 &lt;End of help on this topic&gt;
30284 </BODY>
30285 </HTML>
30286 ====== h_config_check_mail_onquit =====
30287 <HTML>
30288 <HEAD>
30289 <TITLE>FEATURE: <!--#echo var="FEAT_check-newmail-when-quitting"--></TITLE>
30290 </HEAD>
30291 <BODY>
30292 <H1>FEATURE: <!--#echo var="FEAT_check-newmail-when-quitting"--></H1>
30293
30294 If this feature is set, Alpine will check for new mail after you give the
30295 Quit command.
30296 If new mail has arrived since the previous check, you will be notified
30297 and given the choice of quitting or not quitting.
30298 <P>
30299 <UL>
30300 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30301 </UL><P>
30302 &lt;End of help on this topic&gt;
30303 </BODY>
30304 </HTML>
30305 ====== h_config_inbox_no_confirm =====
30306 <HTML>
30307 <HEAD>
30308 <TITLE>FEATURE: <!--#echo var="FEAT_return-to-inbox-without-confirm"--></TITLE>
30309 </HEAD>
30310 <BODY>
30311 <H1>FEATURE: <!--#echo var="FEAT_return-to-inbox-without-confirm"--></H1>
30312
30313 Normally, when you use the TAB <A HREF="h_common_nextnew">NextNew</A>
30314 command and there are no more folders or newsgroups to visit, you are asked
30315 if you want to return to the INBOX.
30316 If this feature is set you will not be asked.
30317 It will be assumed that you do want to return to the INBOX.
30318 <P>
30319 <UL>
30320 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30321 </UL><P>
30322 &lt;End of help on this topic&gt;
30323 </BODY>
30324 </HTML>
30325 ====== h_config_dates_to_local =====
30326 <HTML>
30327 <HEAD>
30328 <TITLE>FEATURE: <!--#echo var="FEAT_convert-dates-to-localtime"--></TITLE>
30329 </HEAD>
30330 <BODY>
30331 <H1>FEATURE: <!--#echo var="FEAT_convert-dates-to-localtime"--></H1>
30332
30333 Normally, the message dates that you see in the
30334 MESSAGE INDEX and MESSAGE VIEW are displayed in the timezone they were sent from.
30335 For example, if a message was sent to you from a few timezones to the east
30336 it might appear that it was sent from the future;
30337 or if it was sent from somewhere to the west it might appear
30338 as if it is from yesterday even though it was sent only a few minutes ago.
30339 If this feature is set an attempt will be made to convert the dates
30340 to your local timezone to be displayed.
30341 <P>
30342 Note that this does not affect the results of Select by Date or of
30343 anything else other than these displayed dates.
30344 When viewing the message you may look at the original unconverted value of the Date
30345 header by using the <A HREF="h_common_hdrmode">HdrMode Command</A>.
30346 <P>
30347 <UL>
30348 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30349 </UL><P>
30350 &lt;End of help on this topic&gt;
30351 </BODY>
30352 </HTML>
30353 ====== h_config_tab_no_prompt =====
30354 <HTML>
30355 <HEAD>
30356 <TITLE>FEATURE: <!--#echo var="FEAT_continue-tab-without-confirm"--></TITLE>
30357 </HEAD>
30358 <BODY>
30359 <H1>FEATURE: <!--#echo var="FEAT_continue-tab-without-confirm"--></H1>
30360
30361 Normally, when you use the TAB <A HREF="h_common_nextnew">NextNew</A>
30362 command and there is a problem checking a folder, you are asked
30363 whether you want to continue with the search in the following folder or not.
30364 This question gives you a chance to stop the NextNew processing.
30365 (The checking problem might be caused by the fact that the folder does not
30366 exist, or by an authentication problem, or by a server problem
30367 of some sort.)
30368 <P>
30369
30370 If this feature is set you will not be asked.
30371 It will be assumed that you do want to continue.
30372 <P>
30373 <UL>
30374 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30375 </UL><P>
30376 &lt;End of help on this topic&gt;
30377 </BODY>
30378 </HTML>
30379 ====== h_config_input_history =====
30380 <HTML>
30381 <HEAD>
30382 <TITLE>FEATURE: <!--#echo var="FEAT_disable-save-input-history"--></TITLE>
30383 </HEAD>
30384 <BODY>
30385 <H1>FEATURE: <!--#echo var="FEAT_disable-save-input-history"--></H1>
30386
30387 Many of the prompts that ask for input in the status line near the
30388 bottom of the screen will respond to Up Arrow and Down Arrow
30389 with the history of previous entries.
30390 For example, in the MESSAGE INDEX screen when you use the WhereIs
30391 command the text you entered will be remembered and can be recalled
30392 by using the Up Arrow key.
30393 Another example, when saving a message the folders saved to will
30394 be remembered and can be recalled using the arrow keys.
30395 <P>
30396 In the Save prompt, some users prefer that the Up and Down arrow keys
30397 be used for the Previous Collection and Next Collection commands
30398 instead of for a history of previous saves.
30399 If this option is set the Up and Down arrow keys will become synonyms for the
30400 Previous Collection and Next Collection (^P and ^N) commands in the
30401 prompt for the name of a folder to Save to or in the prompt for the
30402 name of a folder to GoTo.
30403 When this feature is not set (the default), ^P and ^N will change the
30404 collection and the arrow keys will show the history.
30405 <P>
30406 <UL>
30407 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30408 </UL><P>
30409 &lt;End of help on this topic&gt;
30410 </BODY>
30411 </HTML>
30412 ====== h_config_confirm_role =====
30413 <HTML>
30414 <HEAD>
30415 <TITLE>FEATURE: <!--#echo var="FEAT_confirm-role-even-for-default"--></TITLE>
30416 </HEAD>
30417 <BODY>
30418 <H1>FEATURE: <!--#echo var="FEAT_confirm-role-even-for-default"--></H1>
30419
30420 If you have roles, when you Reply to or Forward a message, or Compose
30421 a new message, Alpine
30422 will search through your roles for one that matches.
30423 Normally, if no matches are found you will be placed into the composer
30424 with no opportunity to select a role.
30425 If this feature is set, then you will be asked to confirm that you don't
30426 want a role.
30427 This will give you the opportunity to select a role (with the ^T command).
30428 If you confirm no role with a Return, you will be placed in
30429 the composer with no role.
30430 You may also confirm with either an &quot;N&quot; or a &quot;Y&quot;.
30431 These behave the same as if you pressed the Return.
30432 (The &quot;N&quot; and &quot;Y&quot; answers are available because they
30433 match what you might type if there was a role match.)
30434 <P>
30435 If you are using the alternate form of the Compose command called
30436 &quot;Role&quot;, then all of your roles will be available to you,
30437 independent of the value of this feauture and of the values set for all of
30438 Reply Use, Forward Use, and Compose Use.
30439 <P>
30440 <UL>
30441 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30442 </UL><P>
30443 &lt;End of help on this topic&gt;
30444 </BODY>
30445 </HTML>
30446 ====== h_config_news_cross_deletes =====
30447 <HTML>
30448 <HEAD>
30449 <TITLE>FEATURE: <!--#echo var="FEAT_news-deletes-across-groups"--></TITLE>
30450 </HEAD>
30451 <BODY>
30452 <H1>FEATURE: <!--#echo var="FEAT_news-deletes-across-groups"--></H1>
30453
30454 This feature controls what Alpine does when you delete a message in a
30455 newsgroup that appears in more than one newsgroup.  Such a message
30456 is sometimes termed a &quot;crossposting&quot; in that it was posted
30457 across several newsgroups.
30458
30459 <P>
30460 Alpine's default behavior when you delete such a message is to remove
30461 only the copy in the current newsgroup from view when you use the
30462 &quot;Exclude&quot; command or the next time you visit the newsgroup.
30463
30464 <P>
30465 Enabling this feature causes Alpine to remove every occurrence of the
30466 message from all newsgroups it appears in and to which you are
30467 subscribed.
30468
30469 <P>
30470 NOTE: As currently implemented, enabling this feature may increase the
30471 time it takes the Expunge command and newsgroup closing to complete.
30472
30473 <P>
30474 <UL>
30475 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30476 </UL><P>
30477 &lt;End of help on this topic&gt;
30478 </BODY>
30479 </HTML>
30480 ====== h_config_news_catchup =====
30481 <HTML>
30482 <HEAD>
30483 <TITLE>FEATURE: <!--#echo var="FEAT_news-offers-catchup-on-close"--></TITLE>
30484 </HEAD>
30485 <BODY>
30486 <H1>FEATURE: <!--#echo var="FEAT_news-offers-catchup-on-close"--></H1>
30487
30488 This feature controls what Alpine does as it closes a newsgroup.
30489 When set, Alpine will offer to delete all messages from the newsgroup
30490 as you are quitting Alpine or opening a new folder.
30491
30492 <P>
30493 This feature is useful if you typically read all the interesting messages
30494 in a newsgroup each time you open it.  This feature saves you from
30495 having to delete each message in a newsgroup as you read it or from
30496 selecting all the messages and doing an
30497 <A HREF="h_config_enable_agg_ops">aggregate delete</A> before you
30498 move on to the next folder or newsgroup.
30499
30500 <P>
30501 <UL>
30502 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30503 </UL><P>
30504 &lt;End of help on this topic&gt;
30505 </BODY>
30506 </HTML>
30507 ====== h_config_next_thrd_wo_confirm =====
30508 <HTML>
30509 <HEAD>
30510 <TITLE>FEATURE: <!--#echo var="FEAT_next-thread-without-confirm"--></TITLE>
30511 </HEAD>
30512 <BODY>
30513 <H1>FEATURE: <!--#echo var="FEAT_next-thread-without-confirm"--></H1>
30514
30515 This feature controls an aspect of Alpine's Next and Prev commands in
30516 the case where you are using one of the
30517 &quot;separate-index-screen&quot; styles for the configuration option
30518 <A HREF="h_config_thread_index_style">&quot;<!--#echo var="VAR_threading-index-style"-->&quot;</A>
30519 and currently have the folder sorted by a Threaded or OrderedSubject sort.
30520 When you are Viewing a particular thread you have a
30521 MESSAGE INDEX of only the messages in that thread.
30522 If you press the Next command with the last message in the thread highlighted
30523 you will normally be asked if you want to &quot;View next thread?&quot;,
30524 assuming there is a next thread to view.
30525 If this feature is set it will be assumed that you always want to view the
30526 next thread and you won't be asked to confirm that.
30527 Similarly, if the first message of the thread is highlighted and you
30528 press the Prev command, this feature will prevent the question
30529 &quot;View previous thread&quot;.
30530 <P>
30531 This feature only has an effect in the MESSAGE INDEX screen.
30532 If you then view a particular message from that screen and press the
30533 Next command, you will be sent to the next thread without being asked,
30534 independent of the setting of this feature.
30535 <P>
30536 The feature
30537 <A HREF="h_config_auto_open_unread">&quot;<!--#echo var="FEAT_auto-open-next-unread"-->&quot;</A> also has some similar effects.
30538 <P>
30539 &lt;End of help on this topic&gt;
30540 </BODY>
30541 </HTML>
30542 ====== h_config_kw_braces =====
30543 <HTML>
30544 <HEAD>
30545 <TITLE>OPTION: <!--#echo var="VAR_keyword-surrounding-chars"--></TITLE>
30546 </HEAD>
30547 <BODY>
30548 <H1>OPTION: <!--#echo var="VAR_keyword-surrounding-chars"--></H1>
30549
30550 This option controls a minor aspect of Alpine's MESSAGE INDEX and MESSAGE
30551 TEXT screens.
30552 If you have modified the
30553 &quot;<A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A>&quot; option
30554 so that either the &quot;SUBJKEY&quot; or &quot;SUBJKEYINIT&quot; tokens
30555 are used to display keywords or their initials along with the Subject; then
30556 this option may be used to modify the resulting display slightly.
30557 By default, the keywords or initials displayed for these tokens will be
30558 surrounded with curly braces ({ and }) and a trailing space.
30559 For example, if keywords &quot;Work&quot; and &quot;Now&quot; are set for
30560 a message, the &quot;SUBJKEY&quot; token will normally look like
30561 <P>
30562 <CENTER><SAMP>{Work Now} actual subject</SAMP></CENTER>
30563 <P>
30564 and the SUBJKEYINIT token would look like
30565 <P>
30566 <CENTER><SAMP>{WN} actual subject</SAMP></CENTER>
30567 <P>
30568 The default character before the keywords is the left brace ({) and the
30569 default after the keywords is the right brace followed by a space (} ).
30570 <P>
30571 This option allows you to change that.
30572 You should set it to two values separated by a space.
30573 The values may be quoted if they include space characters.
30574 So, for example, the default value could be specified explicitly by setting this
30575 option to
30576 <P>
30577 <CENTER><SAMP><!--#echo var="VAR_keyword-surrounding-chars"-->="{" "}&nbsp;"</SAMP></CENTER>
30578 <P>
30579 The first part wouldn't need to be quoted (but it doesn't hurt).
30580 The second part does need the quotes because it includes a space character.
30581 If you wanted to change the braces to brackets you could use
30582 <P>
30583 <CENTER><SAMP><!--#echo var="VAR_keyword-surrounding-chars"-->="[" "]&nbsp;"</SAMP></CENTER>
30584 <P>
30585 Inside the quotes you can use backslash quote to mean quote, so
30586 <P>
30587 <CENTER><SAMP><!--#echo var="VAR_keyword-surrounding-chars"-->="&#92;"" "&#92;" "</SAMP></CENTER>
30588 <P>
30589 would produce
30590 <P>
30591 <CENTER><SAMP>"Work Now" actual subject</SAMP></CENTER>
30592 <P>
30593 It is also possible to color keywords in the index using the
30594 Setup/Kolor screen (<A HREF="h_config_kw_color">Keyword Colors</A>).
30595 <P>
30596 It is not possible to change the fact that a space character is used to
30597 separate the keywords if more than one keyword is set for a message.
30598 It is also not possible to change the fact that there are no separators
30599 between the keyword initials if more than one keyword is set.
30600 <P>
30601 &lt;End of help on this topic&gt;
30602 </BODY>
30603 </HTML>
30604 ====== h_config_opening_sep =====
30605 <HTML>
30606 <HEAD>
30607 <TITLE>OPTION: <!--#echo var="VAR_opening-text-separator-chars"--></TITLE>
30608 </HEAD>
30609 <BODY>
30610 <H1>OPTION: <!--#echo var="VAR_opening-text-separator-chars"--></H1>
30611
30612 This option controls a minor aspect of Alpine's MESSAGE INDEX screen.
30613 With some setups the text of the subject is followed
30614 by the opening text of the message if there is any room available in the index line.
30615 If you have configured your
30616 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option
30617 to include one of the Subject tokens that causes this behavior
30618 (SUBJECTTEXT, SUBJKEYTEXT, or SUBJKEYINITTEXT), then this option may be used
30619 to modify what is displayed slightly.
30620 By default, the Subject is separated from the opening text of the message by
30621 the three characters space dash space;
30622 <P>
30623 <CENTER><SAMP>&quot;&nbsp;-&nbsp;&quot;</SAMP></CENTER>
30624 <P>
30625 Use this option to set it to something different.
30626 The value must be quoted if it includes any space characters.
30627 For example, the default value could be specified explicitly by setting this
30628 option to
30629 <P>
30630 <CENTER><SAMP><!--#echo var="VAR_opening-text-separator-chars"-->="&nbsp;-&nbsp;"</SAMP></CENTER>
30631 <P>
30632 &lt;End of help on this topic&gt;
30633 </BODY>
30634 </HTML>
30635 ====== h_config_select_wo_confirm =====
30636 <HTML>
30637 <HEAD>
30638 <TITLE>FEATURE: <!--#echo var="FEAT_select-without-confirm"--></TITLE>
30639 </HEAD>
30640 <BODY>
30641 <H1>FEATURE: <!--#echo var="FEAT_select-without-confirm"--></H1>
30642
30643 This feature controls an aspect of Alpine's Save, Export, and Goto commands.
30644 These commands all take text input to specify the name of the folder or
30645 file to be used, but allow you to press ^T for a list of possible names.
30646 If set, the selected name will be used immediately, without further
30647 opportunity to confirm or edit the name.
30648 <P>
30649 Some related help topics are
30650 <UL>
30651 <LI> <A HREF="h_mainhelp_aggops">Aggregate Operations</A>
30652 <LI> <A HREF="h_index_cmd_select">Selecting: Select and WhereIs/Select</A>,
30653 <LI> <A HREF="h_config_enable_agg_ops"><!--#echo var="FEAT_enable-aggregate-command-set"--></A>,
30654 <LI> <A HREF="h_config_auto_unselect"><!--#echo var="FEAT_auto-unselect-after-apply"--></A>.
30655 <LI> <A HREF="h_config_auto_unzoom"><!--#echo var="FEAT_auto-unzoom-after-apply"--></A>, and
30656 <LI> <A HREF="h_config_auto_zoom"><!--#echo var="FEAT_auto-zoom-after-select"--></A>.
30657 </UL>
30658 <P>
30659 &lt;End of help on this topic&gt;
30660 </BODY>
30661 </HTML>
30662 ====== h_config_save_part_wo_confirm =====
30663 <HTML>
30664 <HEAD>
30665 <TITLE>FEATURE: <!--#echo var="FEAT_save-partial-msg-without-confirm"--></TITLE>
30666 </HEAD>
30667 <BODY>
30668 <H1>FEATURE: <!--#echo var="FEAT_save-partial-msg-without-confirm"--></H1>
30669
30670 This feature controls an aspect of Alpine's Save command.
30671 By default, when you Save a message that has some deleted parts, you will
30672 be asked to confirm that you want to Save with a prompt that looks like:
30673 <P>
30674 <CENTER><SAMP>Saved copy will NOT include entire message!  Continue?</SAMP></CENTER>
30675 <P>
30676 If this feature is set, you will not be asked.
30677 <P>
30678 &lt;End of help on this topic&gt;
30679 </BODY>
30680 </HTML>
30681 ====== h_config_use_resentto =====
30682 <HTML>
30683 <HEAD>
30684 <TITLE>FEATURE: <!--#echo var="FEAT_use-resent-to-in-rules"--></TITLE>
30685 </HEAD>
30686 <BODY>
30687 <H1>FEATURE: <!--#echo var="FEAT_use-resent-to-in-rules"--></H1>
30688
30689 This feature is turned off by default because turning it on causes problems
30690 with some deficient IMAP servers.
30691 In Alpine <A HREF="h_mainhelp_filtering">Filters</A> and other types of Rules, if the
30692 <A HREF="h_rule_patterns">Pattern</A>
30693 contains a To header pattern and this feature is turned on,
30694 then a check is made in the message to see
30695 if a Resent-To header is present, and that is used instead of the To header.
30696 If this feature is not turned on, then the regular To header will always
30697 be used.
30698
30699 <P>
30700 &lt;End of help on this topic&gt;
30701 </BODY>
30702 </HTML>
30703 ====== h_config_use_reg_start_for_stayopen =====
30704 <HTML>
30705 <HEAD>
30706 <TITLE>FEATURE: <!--#echo var="FEAT_use-regular-startup-rule-for-stayopen-folders"--></TITLE>
30707 </HEAD>
30708 <BODY>
30709 <H1>FEATURE: <!--#echo var="FEAT_use-regular-startup-rule-for-stayopen-folders"--></H1>
30710
30711 This feature affects which message is selected as the current message
30712 when you enter a
30713 <A HREF="h_config_permlocked">Stay Open</A> folder.
30714 <P>
30715 Normally, the starting position for an incoming folder (which most Stay Open
30716 folders will likely be) is controlled by the
30717 <A HREF="h_config_inc_startup"><!--#echo var="VAR_incoming-startup-rule"--></A>.
30718 However, if a folder is a Stay Open folder, when you re-enter the folder
30719 after the first time the current message will be the same as it was when
30720 you left the folder.
30721 An exception is made if you use the TAB command to get to the folder.
30722 In that case, the message number will be incremented by one from what it
30723 was when you left the folder.
30724 <P>
30725 The above special behavior is thought to be useful.
30726 However, it is special and different from what you might at first expect.
30727 If this feature is set, then Stay Open folders will not be treated specially
30728 as far as the startup rule is concerned.
30729
30730 <P>
30731 &lt;End of help on this topic&gt;
30732 </BODY>
30733 </HTML>
30734 ====== h_config_use_current_dir =====
30735 <HTML>
30736 <HEAD>
30737 <TITLE>FEATURE: <!--#echo var="FEAT_use-current-dir"--></TITLE>
30738 </HEAD>
30739 <BODY>
30740 <H1>FEATURE: <!--#echo var="FEAT_use-current-dir"--></H1>
30741
30742 This feature controls an aspect of several commands.
30743 If set, your &quot;current working directory&quot;
30744 <!--chtml if pinemode="running"-->
30745 (which, at least for your current Alpine &quot;session,&quot;
30746 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
30747 <!--chtml endif-->
30748 will be used instead of your home directory
30749 <!--chtml if pinemode="running"-->
30750 (which, in the present configuration of your system, is
30751  &quot;<!--#echo var="HOME_DIR"-->&quot;)
30752 <!--chtml endif-->
30753 for all of the following operations:<UL>
30754     <LI> Export in the MESSAGE INDEX and MESSAGE TEXT screens
30755     <LI> Attachment Save in the MESSAGE TEXT and ATTACHMENT TEXT screens
30756     <LI> <!--chtml if pinemode="function_key"-->F4
30757          <!--chtml else-->Ctrl-R
30758          <!--chtml endif--> file inclusion in the COMPOSER
30759     <LI> <!--chtml if pinemode="function_key"-->F5
30760          <!--chtml else-->Ctrl-J
30761          <!--chtml endif--> file attachment in the COMPOSER
30762 </UL>
30763 <!--chtml if pinemode="os_windows"-->
30764 <P>
30765 If you are starting PC-Alpine from a desktop icon or the Start menu,
30766 you can set the &quot;current drive&quot;
30767 by specifying it in the &quot;Start in:&quot;
30768 box found in the Shortcut tab of the Properties.
30769 <!--chtml endif-->
30770 <P>
30771 <UL>
30772 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30773 </UL>
30774
30775 <P>
30776 &lt;End of help on this topic&gt;
30777 </BODY>
30778 </HTML>
30779 ====== h_config_save_wont_delete =====
30780 <HTML>
30781 <HEAD>
30782 <TITLE>FEATURE: <!--#echo var="FEAT_save-will-not-delete"--></TITLE>
30783 </HEAD>
30784 <BODY>
30785 <H1>FEATURE: <!--#echo var="FEAT_save-will-not-delete"--></H1>
30786
30787 This feature controls one aspect of the Save command.  If set, Save will
30788 not mark the message &quot;deleted&quot; (its default behavior) after
30789 it has been copied to the designated folder.
30790
30791 <P>
30792 &lt;End of help on this topic&gt;
30793 </BODY>
30794 </HTML>
30795 ====== h_config_use_boring_spinner =====
30796 <HTML>
30797 <HEAD>
30798 <TITLE>FEATURE: <!--#echo var="FEAT_busy-cue-spinner-only"--></TITLE>
30799 </HEAD>
30800 <BODY>
30801 <H1>FEATURE: <!--#echo var="FEAT_busy-cue-spinner-only"--></H1>
30802
30803 When Alpine is delayed for some reason it usually shows that
30804 something is happening with a small animated display in the status
30805 message line near the bottom of the screen.
30806 Setting this feature will cause that animation to be the same
30807 each time instead of having Alpine choose a random animation.
30808 You may turn the animation off altogether by setting the
30809 <A HREF="h_config_active_msg_interval"><!--#echo var="VAR_busy-cue-rate"--></A>
30810 option to zero.
30811
30812 <P>
30813 &lt;End of help on this topic&gt;
30814 </BODY>
30815 </HTML>
30816 ====== h_config_unsel_wont_advance =====
30817 <HTML>
30818 <HEAD>
30819 <TITLE>FEATURE: <!--#echo var="FEAT_unselect-will-not-advance"--></TITLE>
30820 </HEAD>
30821 <BODY>
30822 <H1>FEATURE: <!--#echo var="FEAT_unselect-will-not-advance"--></H1>
30823
30824 This feature controls one aspect of the Unselect Current message command.
30825 Normally, when the Unselect current message command (:) is typed when the
30826 current message is selected, the message will be unselected and the next
30827 message will become the current message.
30828 If this feature is set, the cursor will not advance to the next message.
30829 Instead, the current message will remain the current message after
30830 unselecting.
30831
30832 <P>
30833 &lt;End of help on this topic&gt;
30834 </BODY>
30835 </HTML>
30836 ====== h_config_prune_uses_iso =====
30837 <HTML>
30838 <HEAD>
30839 <TITLE>FEATURE: <!--#echo var="FEAT_prune-uses-yyyy-mm"--></TITLE>
30840 </HEAD>
30841 <BODY>
30842 <H1>FEATURE: <!--#echo var="FEAT_prune-uses-yyyy-mm"--></H1>
30843
30844 By default, Alpine asks monthly whether or not you would like to rename
30845 some folders to a new name containing the date.
30846 It also asks whether or not you would like to delete some old folders.
30847 See the <A HREF="h_config_pruning_rule"><!--#echo var="VAR_pruning-rule"--></A> option for an
30848 explanation.
30849
30850 <P>
30851 By default, the name used when renaming a folder looks like
30852 <P>
30853 <CENTER><SAMP>&lt;foldername&gt;-&lt;month&gt;-&lt;year&gt;</SAMP></CENTER>
30854 <P>
30855 For example, the first time you run Alpine in May of 2004,
30856 the folder &quot;sent-mail&quot; might be renamed to
30857 <P>
30858 <CENTER><SAMP>sent-mail-apr-2004</SAMP></CENTER>
30859 <P>
30860 If this feature is set, the name used will be of the form
30861 <P>
30862 <CENTER><SAMP>&lt;foldername&gt;-&lt;yyyy&gt;-&lt;mm&gt;</SAMP></CENTER>
30863 <P>
30864 where &quot;yyyy&quot; is the year and &quot;mm&quot; is the two-digit
30865 month (01, 02, ..., 12).
30866 For the April, 2004 example above, it would instead be
30867 <P>
30868 <CENTER><SAMP>sent-mail-2004-04</SAMP></CENTER>
30869 <P>
30870 because April is the 4th month of the year.
30871 A reason you might want to set this feature is so that the folders
30872 will sort in chronological order.
30873
30874 <P>
30875 &lt;End of help on this topic&gt;
30876 </BODY>
30877 </HTML>
30878 ====== h_config_save_advances =====
30879 <HTML>
30880 <HEAD>
30881 <TITLE>FEATURE: <!--#echo var="FEAT_save-will-advance"--></TITLE>
30882 </HEAD>
30883 <BODY>
30884 <H1>FEATURE: <!--#echo var="FEAT_save-will-advance"--></H1>
30885
30886 This feature controls one aspect of the Save command.  If set, Save will
30887 (in addition to copying the current message to the designated folder) also
30888 advance to the next message.
30889
30890 <P>
30891 &lt;End of help on this topic&gt;
30892 </BODY>
30893 </HTML>
30894 ====== h_config_force_arrow =====
30895 <HTML>
30896 <HEAD>
30897 <TITLE>FEATURE: <!--#echo var="FEAT_force-arrow-cursor"--></TITLE>
30898 </HEAD>
30899 <BODY>
30900 <H1>FEATURE: <!--#echo var="FEAT_force-arrow-cursor"--></H1>
30901
30902 This feature affects Alpine's MESSAGE INDEX display routine.
30903 If set, the normal inverse-video cursor will be
30904 replaced by a simple &quot;arrow&quot; cursor, which normally occupies the
30905 second column of the index display.
30906 <P>
30907 This is the same index cursor you get if you turn on
30908 <A HREF="h_config_force_low_speed"><!--#echo var="FEAT_assume-slow-link"--></A>, but the index
30909 line coloring will still be present if this feature is turned on and
30910 <!--#echo var="FEAT_assume-slow-link"--> is off.
30911 <P>
30912 An alternative version of the Arrow cursor is available by including the
30913 <A HREF="h_config_index_arrow_color">ARROW</A>
30914 token in the
30915 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option.
30916 <P>
30917 It ought to be the case that this feature also affects the ATTACHMENT INDEX,
30918 but that is not implemented.
30919
30920 <P>
30921 &lt;End of help on this topic&gt;
30922 </BODY>
30923 </HTML>
30924 ====== h_config_force_low_speed =====
30925 <HTML>
30926 <HEAD>
30927 <TITLE>FEATURE: <!--#echo var="FEAT_assume-slow-link"--></TITLE>
30928 </HEAD>
30929 <BODY>
30930 <H1>FEATURE: <!--#echo var="FEAT_assume-slow-link"--></H1>
30931
30932 UNIX Alpine only.
30933 <P>
30934 This feature affects Alpine's display routines.  If set, the normal
30935 inverse-video cursor (used to highlight the current item in a list) will be
30936 replaced by an &quot;arrow&quot; cursor and other
30937 screen update optimizations for
30938 low-speed links (e.g. 2400 bps dialup connections) will be activated.
30939 One of the optimizations is that colored index lines (set up with Indexcolor
30940 Rules) will not be colored.
30941 If you are just turning this feature on because you like using
30942 the &quot;arrow&quot; cursor you may have an arrow cursor with index line
30943 coloring by turning this feature off and the
30944 <A HREF="h_config_force_arrow"><!--#echo var="FEAT_force-arrow-cursor"--></A> on.
30945
30946 <P>
30947 &lt;End of help on this topic&gt;
30948 </BODY>
30949 </HTML>
30950 ====== h_config_show_delay_cue =====
30951 <HTML>
30952 <HEAD>
30953 <TITLE>FEATURE: <!--#echo var="FEAT_enable-mail-check-cue"--></TITLE>
30954 </HEAD>
30955 <BODY>
30956 <H1>FEATURE: <!--#echo var="FEAT_enable-mail-check-cue"--></H1>
30957
30958 If set, this feature will cause an asterisk to appear in the upper
30959 left-hand corner of the screen whenever Alpine checks for new mail.
30960 Two asterisks whenever Alpine saves (checkpoints) the state of the current
30961 mailbox to disk.
30962
30963 <!--chtml if pinemode="os_windows"-->
30964 <P>
30965 In addition, PC-Alpine will display a less-than symbol, '&lt;', when
30966 it is trying to open a network connection (e.g, to open your INBOX
30967 on an IMAP
30968 server) or read from the network connection.  A greater-than symbol,
30969 will be displayed when PC-Alpine is trying to write to the network
30970 connection (e.g, sending a command to your IMAP server).
30971 <!--chtml endif-->
30972
30973 <P>
30974 &lt;End of help on this topic&gt;
30975 </BODY>
30976 </HTML>
30977 ====== h_config_color_style =====
30978 <HTML>
30979 <HEAD>
30980 <TITLE>OPTION: Color Style</TITLE>
30981 </HEAD>
30982 <BODY>
30983 <H1>OPTION: Color Style</H1>
30984
30985 UNIX Alpine only.
30986 <P>
30987 If the terminal or terminal emulator you are using is capable of displaying
30988 colors, this option controls whether or not color will be used in Alpine.
30989 If you turn color on and things are set up correctly,
30990 you should see color appear on the screen immmediately.
30991 Modern terminal emulators are usually capable of displaying colors.
30992 <P>
30993 The available options include:
30994 <P>
30995
30996 <DL>
30997 <DT>no-color</DT>
30998 <DD>Don't use color.
30999 </DD>
31000
31001 <DT>use-termdef</DT>
31002 <DD>In order to decide if your terminal is capable of color, Alpine looks in
31003 the terminal capabilities database, TERMINFO or TERMCAP, depending on
31004 how Alpine was compiled.
31005 This is a good option to choose if you switch between a color and a non-color
31006 terminal with the same Alpine configuration.
31007 Alpine will know to use color on the color terminal because it is described
31008 in the termcap entry, and Alpine will know to use black and white on the
31009 non-color terminal.
31010 The Alpine Technical Notes
31011 <CENTER><SAMP><A HREF="http://www.washington.edu/alpine/tech-notes/">http://www.washington.edu/alpine/tech-notes/</A></SAMP></CENTER>
31012 have more information on configuring a TERMCAP or TERMINFO
31013 entry for color Alpine.
31014 This is usually something a system administrator does.
31015 </DD>
31016
31017 <DT>force-ansi-8color</DT>
31018 <DD>This is probably the setting that most people should use.
31019 Because setting up a termcap entry is confusing and because the
31020 terminal capabilities database is often not correctly configured for color,
31021 this choice and the next may be easier for you to use.
31022 If your terminal emulator responds to ANSI color escape sequences, which
31023 many do, this option will cause Alpine to believe your terminal will respond
31024 to the escape sequences that produce eight different foreground and background
31025 colors.
31026 The escape sequences used to set the foreground colors are
31027
31028   <P><CENTER>ESC&nbsp;[&nbsp;3&nbsp;&lt;color_number&gt;&nbsp;m</CENTER><P>
31029
31030 where the color_number is an ASCII digit between 0 and 7.
31031 The numbers 0 through 7 should correspond to the colors black, red, green,
31032 yellow, blue, magenta, cyan, and white.
31033 Some terminal emulators use a pre-ANSI scheme that swaps
31034 the colors blue and red and the colors yellow and cyan.
31035 This will cause the default colors to be different, but other than that
31036 things should work fine.
31037 There is also a 9th color available, the last one shown, which is the default
31038 color from the terminal emulator.
31039 When used as a background color some people refer to this color as
31040 &quot;transparent&quot;, which is why the letters &quot;TRAN&quot; are
31041 shown in the color swatch of the SETUP COLOR screen.
31042 The foreground transparent color is shown as
31043 the color of the &quot;TRAN&quot; text.
31044 (The transparent color will not work correctly in a PC-Alpine configuration.)
31045 The escape sequences used to set the background colors are the same
31046 as for the foreground colors except a &quot;4&quot; replaces the &quot;3&quot;.
31047 The escape sequences for foreground and background default colors (transparent)
31048 are 39m and 49m.
31049 <P>
31050 Note: With the Tera Term terminal emulator this setting works well.
31051 You should also have the Tera Term &quot;Full color&quot; option turned OFF.
31052 You may find the &quot;Full color&quot; option in Tera Term's &quot;Setup&quot;
31053 menu, in the &quot;Window&quot; submenu.
31054 </DD>
31055
31056 <DT>force-ansi-16color</DT>
31057 <DD>Many terminal emulators know about the same eight colors above
31058 plus eight more.
31059 This option attempts to use all 16 colors.
31060 The same escape sequences as for the eight-color terminal are used
31061 for the first eight colors.
31062 The escape sequences used to set foreground colors 8-15 are the same as
31063 for 0-7 except the &quot;3&quot; is replaced with a &quot;9&quot;.
31064 The background color sequences for colors 8-15 are the same as for 0-7
31065 except the &quot;4&quot; is replaced with &quot;10&quot;.
31066 You can tell if the 16 colors are working by turning on this option
31067 and then going into one of the color configuration screens, for example,
31068 the configuration screen for Normal Color.
31069 If you see 16 different colors to select from (plus a 17th for
31070 the transparent color), it's working.
31071 </DD>
31072
31073 <DT>force-xterm-256color</DT>
31074 <DD>Some versions of xterm (and some other terminal emulators)
31075 have support for 256 colors.
31076 The escape sequences used to set the foreground colors are
31077
31078   <P><CENTER>ESC&nbsp;[&nbsp;38&nbsp;;&nbsp;5&nbsp;;&nbsp;&lt;color_number&gt;&nbsp;m</CENTER><P>
31079
31080 where the color_number is an ASCII digit between 0 and 255.
31081 Background colors are the same with the 38 replaced with a 48.
31082 The numbers 0 through 15 are probably similar to the 16 color version
31083 above, then comes a 6x6x6 color cube, followed by 24 colors of gray.
31084 The terminal default (transparent) color is the 257th color at the bottom.
31085 Some terminal emulators will misinterpret these escape sequences causing
31086 the terminal to blink or overstrike characters or to do something else
31087 undesirable.
31088 <P>
31089 The PuTTY terminal emulator has an option called &quot;Allow terminal to
31090 use xterm 256-colour mode&quot; which allows PuTTY to work well with
31091 this 256-color setting.
31092
31093 </DD>
31094 </DL>
31095
31096 <P>
31097 The normal default is &quot;no-color&quot;.
31098 <P>
31099
31100 Once you've turned on color you may set the
31101 colors of many objects on the screen individually.
31102 For example, you may add colors to the status letters on the MESSAGE
31103 INDEX page.
31104 Most categories of color that Alpine supports are configurable here.
31105 For example, &quot;Normal Color&quot;
31106 is the color used to display most of the text in Alpine, and
31107 &quot;Reverse Color&quot; is used to display highlighted text, such as the
31108 current message in the MESSAGE INDEX.
31109 <P>
31110 Lines in the MESSAGE INDEX may also be colored.
31111 Use Setup Rules to get to the Indexcolor configuration screen.
31112 <P>
31113
31114 <UL>
31115 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31116 </UL><P>
31117 &lt;End of help on this topic&gt;
31118 </BODY>
31119 </HTML>
31120 ====== h_config_disable_index_locale_dates =====
31121 <HTML>
31122 <HEAD>
31123 <TITLE>FEATURE: <!--#echo var="FEAT_disable-index-locale-dates"--></TITLE>
31124 </HEAD>
31125 <BODY>
31126 <H1>FEATURE: <!--#echo var="FEAT_disable-index-locale-dates"--></H1>
31127
31128 This feature affects the display of dates in the MESSAGE INDEX.
31129 Normally an attempt is made to localize the dates
31130 used in the MESSAGE INDEX display to your locale.
31131 This is controlled with the
31132 LC_TIME locale setting on a UNIX system.
31133 On Windows the Regional Options control panel may be used to set the date format.
31134 At the programming level, Alpine is using the strftime routine
31135 to print the parts of a date.
31136 <P>
31137 If this feature is set, dates are displayed in English and
31138 with the conventions of the United States.
31139 <P>
31140
31141 <UL>
31142 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31143 </UL><P>
31144 &lt;End of help on this topic&gt;
31145 </BODY>
31146 </HTML>
31147 ====== h_config_auto_open_unread =====
31148 <HTML>
31149 <HEAD>
31150 <TITLE>FEATURE: <!--#echo var="FEAT_auto-open-next-unread"--></TITLE>
31151 </HEAD>
31152 <BODY>
31153 <H1>FEATURE: <!--#echo var="FEAT_auto-open-next-unread"--></H1>
31154
31155 This feature controls the behavior of the TAB key when traversing folders
31156 in the optional
31157 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
31158 collection or in optional <!--#echo var="VAR_news-collections"-->.
31159 <P>
31160 When the TAB
31161 (<A HREF="h_common_nextnew">NextNew</A>)
31162 key is pressed, and there
31163 are no more unseen messages in the current (incoming message or news)
31164 folder, Alpine will search the list of folders in the current collection for
31165 one containing New or Recent (new since the last time the folder was
31166 opened) messages.
31167 This behavior may be modified slightly with the
31168 <A HREF="h_config_tab_uses_unseen">&quot;<!--#echo var="FEAT_tab-uses-unseen-for-next-folder"-->&quot;</A>
31169 feature that causes Alpine to look for Unseen messages instead of Recent
31170 messages.
31171 Normally, when such a folder is found, Alpine will ask
31172 whether you wish to open the folder.  If this feature is set, Alpine will
31173 automatically open the folder without prompting.
31174 <P>
31175 This feature also affects some other similar situations.
31176 If you have a
31177 <A HREF="h_config_thread_index_style"><!--#echo var="VAR_threading-index-style"--></A>
31178 that is equal to one of the &quot;separate-&quot; values, and you are
31179 viewing a thread; then when you type the NextNew command and are at the
31180 end of the current thread you will automatically go to the next thread
31181 if this feature is set.
31182 By default, you would be asked if you want to view the next thread.
31183 You will also be asked at times whether or not you want to view the next
31184 thread after you delete the last message in the thread.
31185 Setting this feature will also cause that question to be skipped.
31186 <P>
31187
31188 <UL>
31189 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31190 </UL><P>
31191 &lt;End of help on this topic&gt;
31192 </BODY>
31193 </HTML>
31194 ====== h_config_auto_include_reply =====
31195 <HTML>
31196 <HEAD>
31197 <TITLE>FEATURE: <!--#echo var="FEAT_include-text-in-reply"--></TITLE>
31198 </HEAD>
31199 <BODY>
31200 <H1>FEATURE: <!--#echo var="FEAT_include-text-in-reply"--></H1>
31201
31202 This feature controls an aspect of Alpine's Reply command.  Normally, Alpine
31203 will ask whether you wish to include the original message in your reply.
31204 If this feature is set and the feature
31205 <A HREF="h_config_prefix_editing">&quot;<!--#echo var="FEAT_enable-reply-indent-string-editing"-->&quot;</A>
31206 is <EM>not</EM> set, then the original message will be included in the reply
31207 automatically, without prompting.
31208 <P>
31209 &lt;End of help on this topic&gt;
31210 </BODY>
31211 </HTML>
31212 ====== h_config_select_in_bold =====
31213 <HTML>
31214 <HEAD>
31215 <TITLE>FEATURE: <!--#echo var="FEAT_show-selected-in-boldface"--></TITLE>
31216 </HEAD>
31217 <BODY>
31218 <H1>FEATURE: <!--#echo var="FEAT_show-selected-in-boldface"--></H1>
31219
31220 This feature controls an aspect of Alpine's
31221 <A HREF="h_config_enable_agg_ops">&quot;aggregate operation&quot;</A>
31222 commands; in
31223 particular, the Select and WhereIs commands. Select and WhereIs (with the
31224 ^X subcommand) will search the current folder for messages meeting a
31225 specified criteria, and &quot;tag&quot; the resulting messages with an
31226 &quot;X&quot; in the
31227 first column of the applicable lines in the MESSAGE INDEX.  If this feature
31228 is set, instead of using the &quot;X&quot; to denote a selected message,
31229 Alpine will
31230 attempt to display those index lines in boldface. Whether this is
31231 preferable to the &quot;X&quot; will depend on personal taste and the type of
31232 terminal being used.
31233 <P>
31234 <UL>
31235 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31236 </UL><P>
31237 &lt;End of help on this topic&gt;
31238 </BODY>
31239 </HTML>
31240 ====== h_config_alt_auth =====
31241 <HTML>
31242 <HEAD>
31243 <TITLE>FEATURE: <!--#echo var="FEAT_try-alternative-authentication-driver-first"--></TITLE>
31244 </HEAD>
31245 <BODY>
31246 <H1>FEATURE: <!--#echo var="FEAT_try-alternative-authentication-driver-first"--></H1>
31247
31248 This feature affects how Alpine connects to IMAP servers.
31249 It's utility has largely been overtaken by events,
31250 but it may still be useful in some circumstances.
31251 If you only connect to modern IMAP servers that support
31252 &quot;TLS&quot; you can ignore this feature.
31253
31254 <P>
31255 Details:
31256
31257 <P>
31258 By default, Alpine will attempt to connect to an IMAP server on the
31259 normal IMAP service port (143), and if the server offers &quot;Transport Layer
31260 Security&quot; (TLS) and Alpine has been compiled with encryption capability,
31261 then a secure (encrypted) session will be negotiated.
31262
31263 <P>
31264 With this feature enabled, before connecting on the normal IMAP port, Alpine
31265 will first attempt to connect to an alternate IMAP service port (993) used
31266 specifically for encrypted IMAP sessions via the Secure Sockets Layer
31267 (SSL) method.
31268 If the SSL attempt fails, Alpine will then try the default
31269 behavior described in the previous paragraph.
31270
31271 <P>
31272 TLS negotiation on the normal port is preferred, and supersedes the use of
31273 SSL on port 993, but older servers may not provide TLS support.
31274 This feature may be convenient when accessing IMAP servers that do not support
31275 TLS, but do support SSL connections on port 993.
31276 However, it is important to understand that with this feature enabled,
31277 Alpine will <EM>attempt</EM> to make a secure connection if that is possible,
31278 but it will proceed to make an insecure connection if that is the only
31279 option offered by the server, or if the Alpine in question has been built
31280 without encryption capability.
31281
31282 <P>
31283 Note that this feature specifies a per-user (or system-wide) default
31284 behavior, but host/folder specification flags may be used to control the
31285 behavior of any specific connection.
31286 This feature interacts with some of
31287 the possible host/folder path specification flags as follows:
31288
31289 <P>
31290 The <SAMP>/tls</SAMP> host flag, for example,
31291
31292 <P>
31293 <CENTER><SAMP>{foo.example.com/tls}INBOX</SAMP></CENTER>
31294 <P>
31295 will over-ride this feature for the specified host by bypassing the
31296 SSL connection attempt.
31297 Moreover, with <SAMP>/tls</SAMP> specified,
31298 the connection attempt will fail if the
31299 service on port 143 does not offer TLS support.
31300
31301 <P>
31302 The <SAMP>/ssl</SAMP> host flag, for example,
31303
31304 <P>
31305 <CENTER><SAMP>{foo.example.com/ssl}INBOX</SAMP></CENTER>
31306 <P>
31307 will insist on an SSL connection for the specified host,
31308 and will fail if the SSL service on port 993 is not available.
31309 Alpine will not subsequently retry a connection
31310 on port 143 if <SAMP>/ssl</SAMP> is specified.
31311
31312 <P>
31313 <UL>
31314 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31315 </UL><P>
31316 &lt;End of help on this topic&gt;
31317 </BODY>
31318 </HTML>
31319 ====== h_config_file_dir ======
31320 <HTML>
31321 <HEAD>
31322 <TITLE>OPTION: File Directory</TITLE>
31323 </HEAD>
31324 <BODY>
31325 <H1>OPTION: File Directory</H1>
31326
31327 PC-Alpine only.
31328 <P>
31329 This value affects the Composer's &quot;^J&nbsp;Attach&quot; command,
31330 the Attachment Index Screen's &quot;S&nbsp;Save&quot; command, and the
31331 Message Index's &quot;E&nbsp;Export&quot; command.
31332
31333 <P>
31334 Normally, when a filename is supplied that lacks a leading &quot;path&quot;
31335 component, Alpine assumes the file exists in the user's home directory.
31336 Under Windows operating systems, this definition isn't always clear.  This
31337 feature allows you to explictly set where Alpine should look for files
31338 without a leading path.
31339
31340 <P>
31341 NOTE: this feature's value is ignored if either
31342 <A HREF="h_config_use_current_dir"><!--#echo var="FEAT_use-current-dir"--></A> feature
31343 is set or the PINERC has a value for the &quot;<!--#echo var="VAR_operating-dir"-->&quot; variable.
31344
31345 <P>
31346 <UL>
31347 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31348 </UL><P>
31349 &lt;End of help on this topic&gt;
31350 </BODY>
31351 </HTML>
31352 ====== h_config_quote_all_froms =====
31353 <HTML>
31354 <HEAD>
31355 <TITLE>FEATURE: <!--#echo var="FEAT_save-will-quote-leading-froms"--></TITLE>
31356 </HEAD>
31357 <BODY>
31358 <H1>FEATURE: <!--#echo var="FEAT_save-will-quote-leading-froms"--></H1>
31359
31360 This feature controls an aspect of the Save command (and also the way
31361 outgoing messages are saved to an FCC folder).  If set, Alpine will add
31362 a leading &quot;>&quot; character in front of message lines beginning with &quot;From&quot;
31363 when they are saved to another folder, including lines syntactically
31364 distinguishable from the type of message separator line commonly used on
31365 Unix systems.
31366
31367 <P>
31368 The default behavior is that a &quot;>&quot; will be prepended only to lines
31369 beginning with &quot;From &quot; that might otherwise be confused with a message
31370 separator line on Unix systems.  If pine is the only mail program you use,
31371 this default is reasonable.  If another program you use has trouble
31372 displaying a message with an unquoted &quot;From &quot; saved by Alpine, you should
31373 enable this feature.  This feature only applies to the common Unix mailbox
31374 format that uses message separator lines beginning with &quot;From &quot;.  If
31375 Alpine has been configured to use a different mailbox format (possibly
31376 incompatible with other mail programs), then this issue does not arise,
31377 and the feature is irrelevant.
31378
31379 <P>
31380 &lt;End of help on this topic&gt;
31381 </BODY>
31382 </HTML>
31383 ====== h_config_normal_color =====
31384 <HTML>
31385 <HEAD>
31386 <TITLE>OPTION: Normal Color</TITLE>
31387 </HEAD>
31388 <BODY>
31389 <H1>OPTION: Normal Color</H1>
31390
31391 Sets the color Alpine normally uses.
31392 The foreground color is the color of the actual character and the
31393 background color is the color of the area behind the character.
31394 By default this color is black characters on a white background.
31395 <P>
31396 <A HREF="h_color_setup">Descriptions of the available commands</A>
31397 <P>
31398 Look <A HREF="h_edit_nav_cmds">here</A>
31399 to see the available Editing and Navigation commands.
31400 <P>
31401 &lt;End of help on this topic&gt;
31402 </BODY>
31403 </HTML>
31404 ====== h_config_reverse_color =====
31405 <HTML>
31406 <HEAD>
31407 <TITLE>OPTION: Reverse Color</TITLE>
31408 </HEAD>
31409 <BODY>
31410 <H1>OPTION: Reverse Color</H1>
31411
31412 Sets the color Alpine uses for reverse video characters.
31413 The foreground color is the color of the actual character and the
31414 background color is the color of the area behind the character.
31415 <P>
31416 <A HREF="h_color_setup">Descriptions of the available commands</A>
31417 <P>
31418 Look <A HREF="h_edit_nav_cmds">here</A>
31419 to see the available Editing and Navigation commands.
31420 <P>
31421 &lt;End of help on this topic&gt;
31422 </BODY>
31423 </HTML>
31424 ====== h_config_title_color =====
31425 <HTML>
31426 <HEAD>
31427 <TITLE>OPTION: Title Color</TITLE>
31428 </HEAD>
31429 <BODY>
31430 <H1>OPTION: Title Color</H1>
31431
31432 Sets the color Alpine uses for the titlebar (the top line on the screen).
31433 The foreground color is the color of the actual character and the
31434 background color is the color of the area behind the character.
31435 By default, the Title Color is black characters on a yellow background.
31436 <P>
31437 The actual titlebar color may be different from the Title Color if
31438 the option
31439 <A HREF="h_config_titlebar_color_style">&quot;<!--#echo var="VAR_titlebar-color-style"-->&quot;</A>
31440 is set to some value other than the default.
31441 It may also be different if the current folder is closed and the
31442 <A HREF="h_config_titleclosed_color">Title Closed Color</A>
31443 color is set to something different from the Title Color.
31444 <P>
31445 <A HREF="h_color_setup">Descriptions of the available commands</A>
31446 <P>
31447 Look <A HREF="h_edit_nav_cmds">here</A>
31448 to see the available Editing and Navigation commands.
31449 <P>
31450 &lt;End of help on this topic&gt;
31451 </BODY>
31452 </HTML>
31453 ====== h_config_titleclosed_color =====
31454 <HTML>
31455 <HEAD>
31456 <TITLE>OPTION: Title Closed Color</TITLE>
31457 </HEAD>
31458 <BODY>
31459 <H1>OPTION: Title Closed Color</H1>
31460
31461 Sets the color Alpine uses for the titlebar (the top line on the screen)
31462 when the current folder is closed.
31463 The foreground color is the color of the actual character and the
31464 background color is the color of the area behind the character.
31465 By default, the Title Color Closed Color is white characters on a red background.
31466 <P>
31467 By setting this color to something noticeable you will be alerted to the
31468 fact that the current folder is closed, perhaps unexpectedly.
31469 <P>
31470 &lt;End of help on this topic&gt;
31471 </BODY>
31472 </HTML>
31473 ====== h_config_status_color =====
31474 <HTML>
31475 <HEAD>
31476 <TITLE>OPTION: Status Color</TITLE>
31477 </HEAD>
31478 <BODY>
31479 <H1>OPTION: Status Color</H1>
31480
31481 Sets the color Alpine uses for status messages written to the message
31482 line near the bottom of the screen.
31483 The foreground color is the color of the actual character and the
31484 background color is the color of the area behind the character.
31485 By default, the Status Color is the same as the Reverse Color.
31486 <P>
31487 <A HREF="h_color_setup">Descriptions of the available commands</A>
31488 <P>
31489 Look <A HREF="h_edit_nav_cmds">here</A>
31490 to see the available Editing and Navigation commands.
31491 <P>
31492 &lt;End of help on this topic&gt;
31493 </BODY>
31494 </HTML>
31495 ====== h_config_index_opening_color =====
31496 <HTML>
31497 <HEAD>
31498 <TITLE>OPTION: Index Opening Color</TITLE>
31499 </HEAD>
31500 <BODY>
31501 <H1>OPTION: Index Opening Color</H1>
31502
31503 With some setups the text of the subject is followed
31504 by the opening text of the message if there is any room available in the index line.
31505 If you have configured your
31506 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option
31507 to include one of the Subject tokens that causes this behavior
31508 (SUBJECTTEXT, SUBJKEYTEXT, or SUBJKEYINITTEXT), you may set the color of
31509 this opening text with this option.
31510 This coloring takes place for all but the current index line, and the Opening
31511 Color appears to be in front of any color from an Index Color Rule.
31512 <P>
31513 By default the Index Opening Color is gray characters on a white background.
31514
31515 <P>
31516 <A HREF="h_color_setup">Descriptions of the available commands</A>
31517 <P>
31518 Look <A HREF="h_edit_nav_cmds">here</A>
31519 to see the available Editing and Navigation commands.
31520 <P>
31521 &lt;End of help on this topic&gt;
31522 </BODY>
31523 </HTML>
31524 ====== h_config_index_pri_color =====
31525 <HTML>
31526 <HEAD>
31527 <TITLE>OPTION: Index Priority Symbol Colors</TITLE>
31528 </HEAD>
31529 <BODY>
31530 <H1>OPTION: Index Priority Symbol Colors</H1>
31531
31532 The X-Priority header is a non-standard header that is used in a
31533 somewhat standard way by many mail programs.
31534 Alpine expects the value of this header to be a digit with a value
31535 from 1 to 5, with 1 being the highest priority and 5 the lowest priority.
31536 Alpine can be made to display an indication of this priority in
31537 messages by use of one of the tokens
31538 (<A HREF="h_index_tokens">Tokens for Index and Replying</A>)
31539 PRIORITY, PRIORITYALPHA, or PRIORITY! in the
31540 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option.
31541
31542 <P>
31543 You may set the color used to draw these tokens by use of the colors
31544 Index High Priority Symbol Color and Index Low Priority Symbol Color.
31545 This coloring takes place for all but the current index line, and the Priority
31546 Color appears to be in front of any color from an Index Color Rule.
31547 If the priority has a value of 1 or 2 the High Priority color will be
31548 used,
31549 and if the value is 4 or 5 the Low Priority color will be used.
31550 <P>
31551 If you don't set these colors the index line will be colored in the same color as
31552 the bulk of the index line.
31553
31554 <P>
31555 <A HREF="h_color_setup">Descriptions of the available commands</A>
31556 <P>
31557 Look <A HREF="h_edit_nav_cmds">here</A>
31558 to see the available Editing and Navigation commands.
31559 <P>
31560 &lt;End of help on this topic&gt;
31561 </BODY>
31562 </HTML>
31563 ====== h_config_index_subject_color =====
31564 <HTML>
31565 <HEAD>
31566 <TITLE>OPTION: Index Subject Color</TITLE>
31567 </HEAD>
31568 <BODY>
31569 <H1>OPTION: Index Subject Color</H1>
31570
31571 You may set the color used to draw the Subject part of the index line.
31572 This coloring takes place for all but the current index line, and the Subject
31573 Color appears to be in front of any color from an Index Color Rule.
31574 <P>
31575 If you don't set this color it will be colored in the same color as
31576 the bulk of the index line.
31577
31578 <P>
31579 <A HREF="h_color_setup">Descriptions of the available commands</A>
31580 <P>
31581 Look <A HREF="h_edit_nav_cmds">here</A>
31582 to see the available Editing and Navigation commands.
31583 <P>
31584 &lt;End of help on this topic&gt;
31585 </BODY>
31586 </HTML>
31587 ====== h_config_index_from_color =====
31588 <HTML>
31589 <HEAD>
31590 <TITLE>OPTION: Index From Color</TITLE>
31591 </HEAD>
31592 <BODY>
31593 <H1>OPTION: Index From Color</H1>
31594
31595 You may set the color used to draw the From part of the index line.
31596 This coloring takes place for all but the current index line, and the From
31597 Color appears to be in front of any color from an Index Color Rule.
31598 <P>
31599 If you don't set this color it will be colored in the same color as
31600 the bulk of the index line.
31601
31602 <P>
31603 <A HREF="h_color_setup">Descriptions of the available commands</A>
31604 <P>
31605 Look <A HREF="h_edit_nav_cmds">here</A>
31606 to see the available Editing and Navigation commands.
31607 <P>
31608 &lt;End of help on this topic&gt;
31609 </BODY>
31610 </HTML>
31611 ====== h_config_index_arrow_color =====
31612 <HTML>
31613 <HEAD>
31614 <TITLE>OPTION: Index Arrow Color</TITLE>
31615 </HEAD>
31616 <BODY>
31617 <H1>OPTION: Index Arrow Color</H1>
31618
31619 If you have configured your
31620 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option
31621 to include the &quot;ARROW&quot; token, you may set the color of
31622 the arrow displayed with this option.
31623 If you don't set the color it will be colored in the same color as
31624 the bulk of the index line.
31625
31626 <P>
31627 <A HREF="h_color_setup">Descriptions of the available commands</A>
31628 <P>
31629 Look <A HREF="h_edit_nav_cmds">here</A>
31630 to see the available Editing and Navigation commands.
31631 <P>
31632 &lt;End of help on this topic&gt;
31633 </BODY>
31634 </HTML>
31635 ====== h_config_index_color =====
31636 <HTML>
31637 <HEAD>
31638 <TITLE>OPTION: Index Colors</TITLE>
31639 </HEAD>
31640 <BODY>
31641 <H1>OPTION: Index Colors</H1>
31642
31643 You may add color to the single character symbols that give the status
31644 of each message in the MESSAGE INDEX.
31645 By default the characters &quot;+&quot;, &quot;*&quot;, &quot;D&quot;,
31646 &quot;A&quot;, and &quot;N&quot; show up near the left hand side of the
31647 screen depending on whether the message is addressed to you, and whether
31648 the message is marked Important, is Deleted, is Answered, or is New.
31649 The color for each of those characters may be specified by setting the
31650 &quot;Index-to-me&quot; Symbol Color,
31651 the &quot;Index-important&quot; Symbol Color,
31652 the &quot;Index-deleted&quot; Symbol Color,
31653 the &quot;Index-answered&quot; Symbol Color,
31654 and the &quot;Index-new&quot; Symbol Color.
31655 There are also two other symbol colors called &quot;Index-recent&quot;
31656 and &quot;Index-unseen&quot;.
31657 These two colors will only be used if you have configured your
31658 &quot;<A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A>&quot; option
31659 to include the &quot;IMAPSTATUS&quot; or &quot;SHORTIMAPSTATUS&quot; token.
31660 <P>
31661 The default colors for these symbols are:
31662 <TABLE>
31663 <TR> <TD> &nbsp;&nbsp;Index-to-me&nbsp;&nbsp;&nbsp;&nbsp; </TD> <TD> black on cyan </TD> </TR>
31664 <TR> <TD> &nbsp;&nbsp;Index-important </TD> <TD> white on bright red </TD> </TR>
31665 <TR> <TD> &nbsp;&nbsp;Index-deleted&nbsp;&nbsp; </TD> <TD> same as Normal Color </TD> </TR>
31666 <TR> <TD> &nbsp;&nbsp;Index-answered&nbsp; </TD> <TD> bright red on yellow </TD> </TR>
31667 <TR> <TD> &nbsp;&nbsp;Index-new&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </TD> <TD> white on magenta </TD> </TR>
31668 <TR> <TD> &nbsp;&nbsp;Index-recent&nbsp;&nbsp;&nbsp; </TD> <TD> same as Normal Color </TD> </TR>
31669 <TR> <TD> &nbsp;&nbsp;Index-unseen&nbsp;&nbsp;&nbsp; </TD> <TD> same as Normal Color </TD> </TR>
31670 </TABLE>
31671 <P>
31672 Besides coloring the message status symbols, you may also color the
31673 entire index line.
31674 This is done by using the
31675 <A HREF="h_rules_incols">SETUP INDEX LINE COLORS</A> screen, which you
31676 may get to with the commands <EM>S</EM>etup/<EM>R</EM>ules/<EM>I</EM>ndexcolor.
31677 When the entire line is colored that color will be &quot;behind&quot; the
31678 status symbol colors talked about in the paragraph above.
31679 <P>
31680 You may also color
31681 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>
31682 in the index using the
31683 Setup/Kolor screen (<A HREF="h_config_kw_color">Keyword Colors</A>);
31684 the <A HREF="h_config_index_arrow_color">ARROW</A> cursor;
31685 the Subject using
31686 <A HREF="h_config_index_subject_color">Index Subject Color</A>;
31687 the From field using
31688 <A HREF="h_config_index_from_color">Index From Color</A>;
31689 and the
31690 <A HREF="h_config_index_opening_color">Index Opening</A> text.
31691 <P>
31692 <A HREF="h_color_setup">Descriptions of the available commands</A>
31693 <P>
31694 Look <A HREF="h_edit_nav_cmds">here</A>
31695 to see the available Editing and Navigation commands.
31696 <P>
31697 &lt;End of help on this topic&gt;
31698 </BODY>
31699 </HTML>
31700 ====== h_config_metamsg_color =====
31701 <HTML>
31702 <HEAD>
31703 <TITLE>OPTION: Meta-Message Color</TITLE>
31704 </HEAD>
31705 <BODY>
31706 <H1>OPTION: Meta-Message Color</H1>
31707
31708 Sets the color Alpine uses in the MESSAGE TEXT screen for messages to you
31709 that aren't part of the message itself.
31710 For example, an attachment that isn't shown might produce a meta
31711 message something like:
31712 <P>
31713 <CENTER><SAMP> [ Part 2, &quot;comment&quot; Text/PLAIN (Name: &quot;file&quot;) ]</SAMP></CENTER>
31714 <P>
31715 If you set the
31716 <A HREF="h_config_quote_suppression"><!--#echo var="VAR_quote-suppression-threshold"--></A>
31717 option you might see
31718 <P>
31719 <CENTER><SAMP>[ 12 lines of quoted text hidden from view ]</SAMP></CENTER>
31720 <P>
31721 Warnings about suspicious looking URLs in HTML will also be colored
31722 with this color.
31723 <P>
31724 The foreground color is the color of the actual character and the
31725 background color is the color of the area behind the character.
31726 By default, the Meta-Message Color is black characters on a yellow background.
31727 <P>
31728 <A HREF="h_color_setup">Descriptions of the available commands</A>
31729 <P>
31730 Look <A HREF="h_edit_nav_cmds">here</A>
31731 to see the available Editing and Navigation commands.
31732 <P>
31733 &lt;End of help on this topic&gt;
31734 </BODY>
31735 </HTML>
31736 ====== h_config_keylabel_color =====
31737 <HTML>
31738 <HEAD>
31739 <TITLE>OPTION: KeyLabel Color</TITLE>
31740 </HEAD>
31741 <BODY>
31742 <H1>OPTION: KeyLabel Color</H1>
31743
31744 Sets the color Alpine uses for the labels of the keys in the two-line
31745 menu at the bottom of the screen.
31746 For example, some of the screens have a &quot;P PrevMsg&quot; command.
31747 This option sets the color used when displaying &quot;PrevMsg&quot;.
31748 The foreground color is the color of the actual character and the
31749 background color is the color of the area behind the character.
31750 By default, the KeyLabel Color is the same as the Normal Color.
31751 <P>
31752 WARNING: Some terminal emulators have the property that the screen will scroll
31753 down one line whenever a character is written to the character cell in the
31754 lower right corner of the screen.
31755 Alpine can usually avoid writing a character in that corner of the screen.
31756 However, if you have defined a KeyLabel Color then Alpine does have to write
31757 a character in that cell in order to color the cell correctly.
31758 If you find that your display sometimes scrolls up a line this could be
31759 the problem.
31760 The most obvious symptom is probably that the titlebar at the top of the
31761 screen scrolls off the screen.
31762 Try setting KeyLabel Color to Default to see if that fixes the problem.
31763 <P>
31764 <A HREF="h_color_setup">Descriptions of the available commands</A>
31765 <P>
31766 Look <A HREF="h_edit_nav_cmds">here</A>
31767 to see the available Editing and Navigation commands.
31768 <P>
31769 &lt;End of help on this topic&gt;
31770 </BODY>
31771 </HTML>
31772 ====== h_config_keyname_color =====
31773 <HTML>
31774 <HEAD>
31775 <TITLE>OPTION: KeyName Color</TITLE>
31776 </HEAD>
31777 <BODY>
31778 <H1>OPTION: KeyName Color</H1>
31779
31780 Sets the color Alpine uses for the names of the keys in the two-line
31781 menu at the bottom of the screen.
31782 For example, some of the screens have a &quot;P PrevMsg&quot; command.
31783 This option sets the color used when displaying the &quot;P&quot;.
31784 The foreground color is the color of the actual character and the
31785 background color is the color of the area behind the character.
31786 By default, the KeyName Color is the same as the Reverse Color.
31787 <P>
31788 <A HREF="h_color_setup">Descriptions of the available commands</A>
31789 <P>
31790 Look <A HREF="h_edit_nav_cmds">here</A>
31791 to see the available Editing and Navigation commands.
31792 <P>
31793 &lt;End of help on this topic&gt;
31794 </BODY>
31795 </HTML>
31796 ====== h_config_slctbl_color =====
31797 <HTML>
31798 <HEAD>
31799 <TITLE>OPTION: Selectable Item Color</TITLE>
31800 </HEAD>
31801 <BODY>
31802 <H1>OPTION: Selectable Item Color</H1>
31803
31804 Sets the color Alpine uses for selectable items, such as URLs.
31805 The foreground color is the color of the actual character and the
31806 background color is the color of the area behind the character.
31807 By default, the Selectable Item Color is the same as the Normal Color,
31808 except that it is bold.
31809 <P>
31810 <A HREF="h_color_setup">Descriptions of the available commands</A>
31811 <P>
31812 Look <A HREF="h_edit_nav_cmds">here</A>
31813 to see the available Editing and Navigation commands.
31814 <P>
31815 &lt;End of help on this topic&gt;
31816 </BODY>
31817 </HTML>
31818 ====== h_config_quote_color =====
31819 <HTML>
31820 <HEAD>
31821 <TITLE>OPTION: Quote Colors</TITLE>
31822 </HEAD>
31823 <BODY>
31824 <H1>OPTION: Quote Colors</H1>
31825
31826 Sets the colors Alpine uses for coloring quoted text in the MESSAGE TEXT
31827 screen.
31828 If a line begins with a &gt; character (or space followed by &gt;)
31829 it is considered a quote.
31830 That line will be given the Quote1 Color (first level quote).
31831 If there is a second level of quoting then the Quote2 Color will be used.
31832 Alpine considers there to be a second level of quoting if that first &gt; is
31833 followed by another &gt; (or space followed by &gt;).
31834 If there are characters other than whitespace and &gt; signs, then it isn't
31835 considered another level of quoting.
31836 Similarly, if there is a third level of quoting the Quote3 Color will be
31837 used.
31838 If there are more levels after that the Quote Colors are re-used.
31839 If you define all three colors then it would repeat like Color1, Color2, Color3,
31840 Color1, Color2, Color3, ...
31841 If you only define the first two it would be
31842 Color1, Color2, Color1, Color2, ...
31843 If you define only the Quote1 Color, then the entire quote would be that
31844 color regardless of the quoting levels.
31845 By default, the Quote1 Color is black characters on a greenish-blue background;
31846 the Quote2 Color is black characters on a dull yellow background; and
31847 the Quote3 Color is black characters on a green background.
31848 <P>
31849 <A HREF="h_color_setup">Descriptions of the available commands</A>
31850 <P>
31851 Look <A HREF="h_edit_nav_cmds">here</A>
31852 to see the available Editing and Navigation commands.
31853 <P>
31854 &lt;End of help on this topic&gt;
31855 </BODY>
31856 </HTML>
31857 ====== h_config_folder_color =====
31858 <HTML>
31859 <HEAD>
31860 <TITLE>OPTION: Folder Color</TITLE>
31861 </HEAD>
31862 <BODY>
31863 <H1>OPTION: Folder Color</H1>
31864
31865 Sets the colors Alpine uses for coloring a folder in the FOLDER LIST
31866 screen. By default, the Folder Color is the normal text color.
31867
31868 <P>
31869 If you set a color for this feature, other than the normal color
31870 (the default), or a color for
31871 <A HREF="h_config_directory_color">Directory Color</A>, then directories
31872 will be colored according to the color specified in the
31873 <A HREF="h_config_directory_color">Directory Color</A> option. In this
31874 case, the color will be the only indication that the colored name
31875 refers to a directory. The normal behavior is that Alpine
31876 indicates that a name refers to a directory by appending a
31877 separator (like &quot;/&quot; or &quot;.&quot;) to the name of
31878 the folder.
31879
31880 <P>
31881 If a folder is a directory, then the folder name will be painted
31882 according to the color defined by this variable, and a separator
31883 indicator  (like &quot;/&quot; or &quot;.&quot;) will be added
31884 to the name. That
31885 indicator will be painted according to the color defined in the
31886 <A HREF="h_config_directory_color">Directory Color</A> option.
31887
31888 <P>
31889 &lt;End of help on this topic&gt;
31890 </BODY>
31891 </HTML>
31892 ====== h_config_directory_color =====
31893 <HTML>
31894 <HEAD>
31895 <TITLE>OPTION: Directory Color</TITLE>
31896 </HEAD>
31897 <BODY>
31898 <H1>OPTION: Directory Color</H1>
31899
31900 Sets the colors Alpine uses for coloring a directory in the FOLDER LIST
31901 screen. By default, the Folder Color is the normal text color.
31902 <P>
31903 If you set a color for this feature, other than the normal color
31904 (the default), or a color for
31905 <A HREF="h_config_folder_color">Folder Color</A>, then folders
31906 will be colored according to the color specified in the
31907 <A HREF="h_config_folder_color">Folder Color</A> option. In this
31908 case, the color will be the only indication that the colored name
31909 refers to a directory. The normal behavior is that Alpine
31910 indicates that a name refers to a directory by appending a
31911 separator (like &quot;/&quot; or &quot;.&quot;) to the name of
31912 the folder.
31913 <P>
31914 If a folder is a directory, then the folder name will be painted
31915 according to the color defined by the option
31916 <A HREF="h_config_folder_color">Folder Color</A>, and the separator
31917 indicator  (like &quot;/&quot; or &quot;.&quot;) will be added
31918 after the name. That
31919 indicator will be painted according to the color defined in this
31920 option.
31921 <P>
31922 &lt;End of help on this topic&gt;
31923 </BODY>
31924 </HTML>
31925 ====== h_config_folder_list_color =====
31926 <HTML>
31927 <HEAD>
31928 <TITLE>OPTION: Folder-List Color</TITLE>
31929 </HEAD>
31930 <BODY>
31931 <H1>OPTION: Folder-List Color</H1>
31932
31933 Sets the colors Alpine uses for coloring normal text in the FOLDER LIST
31934 screen. By default, the Folder-List Color is the normal text color.
31935 <P>
31936 This text refers to the informative text that Alpine displays so you
31937 can recognize each collection. The color of the content of each collection
31938 is determined by the options <A HREF="h_config_folder_color">Folder Color</A>
31939 and <A HREF="h_config_directory_color">Directory Color</A>.
31940 <P>
31941 Unlike the options
31942 <A HREF="h_config_folder_color">Folder Color</A>
31943 and <A HREF="h_config_directory_color">Directory Color</A>, configuring
31944 this option does not affect the way that Alpine reports folders,
31945 directories and folders that are directories.
31946 <P>
31947 &lt;End of help on this topic&gt;
31948 </BODY>
31949 </HTML>
31950 ====== h_config_incunseen_color =====
31951 <HTML>
31952 <HEAD>
31953 <TITLE>OPTION: Incoming Unseen Color</TITLE>
31954 </HEAD>
31955 <BODY>
31956 <H1>OPTION: Incoming Unseen Color</H1>
31957
31958 If the option
31959 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
31960 is turned on it is possible to highlight the folders that contain
31961 unseen messages by coloring them with this color.
31962 By default, this is the same as the Normal Color and no highlighting is done.
31963 <P>
31964 Usually the &quot;current&quot; folder (the folder the cursor is on)
31965 is highlighted using reverse video.
31966 If the current folder is colored because it contains unseen messages then
31967 the color used to show that it is also the current folder is controlled
31968 by the
31969 <A HREF="h_config_index_color_style"><!--#echo var="VAR_current-indexline-style"--></A>
31970 feature at the top of the SETUP COLOR screen.
31971 <P>
31972 <A HREF="h_color_setup">Descriptions of the available commands</A>
31973 <P>
31974 Look <A HREF="h_edit_nav_cmds">here</A>
31975 to see the available Editing and Navigation commands.
31976 <P>
31977 &lt;End of help on this topic&gt;
31978 </BODY>
31979 </HTML>
31980 ====== h_config_signature_color =====
31981 <HTML>
31982 <HEAD>
31983 <TITLE>OPTION: Signature Color</TITLE>
31984 </HEAD>
31985 <BODY>
31986 <H1>OPTION: Signature Color</H1>
31987
31988 Sets the color Alpine uses for coloring the signature in the MESSAGE TEXT
31989 screen. According to USENET conventions, the signature is defined as the
31990 paragraph following the &quot;sigdashes&quot;, that is, the special line
31991 consisting of the three characters
31992 &quot;--&nbsp;&quot; (i.e., dash, dash, and space). Alpine allows for one
31993 empty line right after the sigdashes to be considered as part of the
31994 signature.
31995 By default, the Signature Color is blue characters on a white background.
31996 <P>
31997 <A HREF="h_color_setup">Descriptions of the available commands</A>
31998 <P>
31999 Look <A HREF="h_edit_nav_cmds">here</A>
32000 to see the available Editing and Navigation commands.
32001 <P>
32002 &lt;End of help on this topic&gt;
32003 </BODY>
32004 </HTML>
32005 ====== h_config_prompt_color =====
32006 <HTML>
32007 <HEAD>
32008 <TITLE>OPTION: Prompt Color</TITLE>
32009 </HEAD>
32010 <BODY>
32011 <H1>OPTION: Prompt Color</H1>
32012
32013 Sets the color Alpine uses for confirmation prompts and questions that
32014 appear in the status line near the bottom of the screen.
32015 The foreground color is the color of the actual character and the
32016 background color is the color of the area behind the character.
32017 By default, the Prompt Color is the same as the Reverse Color.
32018 <P>
32019 <A HREF="h_color_setup">Descriptions of the available commands</A>
32020 <P>
32021 Look <A HREF="h_edit_nav_cmds">here</A>
32022 to see the available Editing and Navigation commands.
32023 <P>
32024 &lt;End of help on this topic&gt;
32025 </BODY>
32026 </HTML>
32027 ====== h_config_header_general_color =====
32028 <HTML>
32029 <HEAD>
32030 <TITLE>OPTION: Header General Color</TITLE>
32031 </HEAD>
32032 <BODY>
32033 <H1>OPTION: Header General Color</H1>
32034
32035 Sets the color Alpine uses for the headers of a message in the MESSAGE TEXT
32036 screen.
32037 The foreground color is the color of the actual character and the
32038 background color is the color of the area behind the character.
32039 By default, this is the same as the Normal Color.
32040 <P>
32041 It is also possible to set the colors for specific header fields, for
32042 example the Subject, using
32043 <A HREF="h_config_customhdr_color"><!--#echo var="VAR_viewer-hdr-colors"--></A>.
32044 If both a Header General Color and a specific Viewer Header Color are set
32045 the specific color will override the general color, as you would expect.
32046 <P>
32047 <A HREF="h_color_setup">Descriptions of the available commands</A>
32048 <P>
32049 Look <A HREF="h_edit_nav_cmds">here</A>
32050 to see the available Editing and Navigation commands.
32051 <P>
32052 &lt;End of help on this topic&gt;
32053 </BODY>
32054 </HTML>
32055 ====== h_config_incol =====
32056 <HTML>
32057 <HEAD>
32058 <TITLE>Index Line Color</TITLE>
32059 </HEAD>
32060 <BODY>
32061 <H1>Index Line Color</H1>
32062
32063 This option is used to set the color of a line in the index when the
32064 message for that line matches the Pattern.
32065 This colors the whole index line, except possibly the status letters,
32066 which may be colored separately using the
32067 <A HREF="h_color_setup">Setup Kolor</A> screen.
32068 The foreground color is the color of the actual characters and the
32069 background color is the color of the area behind the characters.
32070 <P>
32071 <A HREF="h_color_setup">Descriptions of the available commands</A>
32072 <P>
32073 Look <A HREF="h_edit_nav_cmds">here</A>
32074 to see the available Editing and Navigation commands.
32075 <P>
32076 &lt;End of help on this topic&gt;
32077 </BODY>
32078 </HTML>
32079 ====== h_config_usetransparent_color =====
32080 <HTML>
32081 <HEAD>
32082 <TITLE>OPTION: Use Transparent Color</TITLE>
32083 </HEAD>
32084 <BODY>
32085 <H1>OPTION: Use Transparent Color</H1>
32086
32087 This is a special color supported by some terminal emulators.
32088 It is intended to result in the default foreground or background color
32089 from the terminal emulator.
32090 This is the color the terminal was displaying characters in before you started Alpine.
32091 The reason it is called Transparent is because you could set the foreground color
32092 to some specific color, like Red, and then set the background color to the
32093 Transparent Color. If it works as expected, the background color from the terminal
32094 window in which Alpine is running will show through but with the Red characters
32095 in the foreground.
32096 <P>
32097 <A HREF="h_color_setup">Descriptions of the available commands</A>
32098 <P>
32099 Look <A HREF="h_edit_nav_cmds">here</A>
32100 to see the available Editing and Navigation commands.
32101 <P>
32102 &lt;End of help on this topic&gt;
32103 </BODY>
32104 </HTML>
32105 ====== h_config_usenormal_color =====
32106 <HTML>
32107 <HEAD>
32108 <TITLE>OPTION: Use Normal Color</TITLE>
32109 </HEAD>
32110 <BODY>
32111 <H1>OPTION: Use Normal Color</H1>
32112
32113 When you use this color value, the actual color used will be the same
32114 as the corresponding Normal Color.
32115 For example if your Normal Color is black on white and you set both
32116 the foreground and background colors here to use the Normal Color, you'll
32117 get black on white. If you later change the Normal Color to red on blue
32118 this color will also change to red on blue.
32119 <P>
32120 <A HREF="h_color_setup">Descriptions of the available commands</A>
32121 <P>
32122 Look <A HREF="h_edit_nav_cmds">here</A>
32123 to see the available Editing and Navigation commands.
32124 <P>
32125 &lt;End of help on this topic&gt;
32126 </BODY>
32127 </HTML>
32128 ====== h_config_usenone_color =====
32129 <HTML>
32130 <HEAD>
32131 <TITLE>OPTION: Use None Color</TITLE>
32132 </HEAD>
32133 <BODY>
32134 <H1>OPTION: Use None Color</H1>
32135
32136 This is a special color that simply means to leave the color alone.
32137 It is useful for Index symbols and for Keyword Colors used in the Subject
32138 field of an index line.
32139 The most likely use is to set an explicit foreground color and then set
32140 the background color to the None Color.
32141 That will cause the symbol or keyword to be drawn in the foreground color
32142 with a background equal to whatever color the rest of the index line is already
32143 drawn in.
32144 You will see no visible effect unless you have assigned Indexcolor Rules to
32145 color index lines or you have set an actual color for the Reverse Color.
32146 <P>
32147 <A HREF="h_color_setup">Descriptions of the available commands</A>
32148 <P>
32149 Look <A HREF="h_edit_nav_cmds">here</A>
32150 to see the available Editing and Navigation commands.
32151 <P>
32152 &lt;End of help on this topic&gt;
32153 </BODY>
32154 </HTML>
32155 ====== h_config_dflt_color =====
32156 <HTML>
32157 <HEAD>
32158 <TITLE>OPTION: Default Color</TITLE>
32159 </HEAD>
32160 <BODY>
32161 <H1>OPTION: Default Color</H1>
32162
32163 Setting default will cause the color to be the default color.
32164 Unsetting default is normally done by choosing a color, but in some cases
32165 you may want to declare the current default color to be your non-default
32166 choice.
32167 For example, the default Keyname Color is the same as the Reverse Color.
32168 Whenever the Reverse Color changes the Keyname Color will also change, unless
32169 you've changed it or unset the default box.
32170 <P>
32171 <A HREF="h_color_setup">Descriptions of the available commands</A>
32172 <P>
32173 Look <A HREF="h_edit_nav_cmds">here</A>
32174 to see the available Editing and Navigation commands.
32175 <P>
32176 &lt;End of help on this topic&gt;
32177 </BODY>
32178 </HTML>
32179 ====== h_config_bold_slctbl =====
32180 <HTML>
32181 <HEAD>
32182 <TITLE>OPTION: Bold</TITLE>
32183 </HEAD>
32184 <BODY>
32185 <H1>OPTION: Bold</H1>
32186
32187 The color for this particular section may have the Bold attribute turned
32188 on or off.
32189 Setting bold will cause the characters to be bold.
32190 <P>
32191 <A HREF="h_color_setup">Descriptions of the available commands</A>
32192 <P>
32193 Look <A HREF="h_edit_nav_cmds">here</A>
32194 to see the available Editing and Navigation commands.
32195 <P>
32196 &lt;End of help on this topic&gt;
32197 </BODY>
32198 </HTML>
32199 ====== h_config_kw_color =====
32200 <HTML>
32201 <HEAD>
32202 <TITLE>OPTION: Keyword Colors</TITLE>
32203 </HEAD>
32204 <BODY>
32205 <H1>OPTION: Keyword Colors</H1>
32206
32207 Sets the colors Alpine uses for Keyword fields in the MESSAGE INDEX screen.
32208 Keywords are displayed as part of the Subject by default.
32209 They are also displayed as part of the Subject if the tokens
32210 &quot;SUBJKEY&quot;, &quot;SUBJKEYTEXT&quot;, &quot;SUBJKEYINIT&quot;, or &quot;SUBJKEYINITTEXT&quot; are used in the
32211 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option.
32212 Keywords may also be displayed in a column of their own in the MESSAGE INDEX
32213 screen by using the &quot;KEY&quot; or &quot;KEYINIT&quot; tokens.
32214 <P>
32215 For example, you might have set up a Keyword
32216 &quot;Work&quot; using the
32217 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in the Setup/Config screen.
32218 You could cause that Keyword to show up as a special color
32219 by setting up the Keyword Color using this option, and then including it
32220 in the MESSAGE INDEX screen using one of the tokens listed above in the
32221 <!--#echo var="VAR_index-format"-->.
32222 <P>
32223 <A HREF="h_color_setup">Descriptions of the available commands</A>
32224 <P>
32225 Look <A HREF="h_edit_nav_cmds">here</A>
32226 to see the available Editing and Navigation commands.
32227 <P>
32228 &lt;End of help on this topic&gt;
32229 </BODY>
32230 </HTML>
32231 ====== h_config_customhdr_color =====
32232 <HTML>
32233 <HEAD>
32234 <TITLE>OPTION: <!--#echo var="VAR_viewer-hdr-colors"--></TITLE>
32235 </HEAD>
32236 <BODY>
32237 <H1>OPTION: <!--#echo var="VAR_viewer-hdr-colors"--></H1>
32238
32239 Sets the colors Alpine uses for specific header fields in the MESSAGE TEXT screen.
32240 For example, you may set the color of the Subject header or the From header.
32241 The foreground color is the color of the actual character and the
32242 background color is the color of the area behind the character.
32243 <P>
32244 In addition to setting the colors for particular headers (like the Subject)
32245 you may also set a color to be used for all headers unless overridden by a
32246 more specific Viewer Header Color.
32247 To do this use the
32248 <A HREF="h_config_header_general_color">Header General Color</A>.
32249 <P>
32250 For Header Colors,
32251 there is an additional line on the
32252 screen labeled &quot;Pattern to match&quot;.
32253 If you leave that blank, then the whole field for that header will
32254 be colored.
32255 However, if you give a pattern to match, the coloring will only take place
32256 if there is a match for that pattern in the value of the field.
32257 For example, if you are working on a color for the Subject header and
32258 you fill in a pattern of &quot;important&quot;, then only Subjects that
32259 contain the word &quot;important&quot; will be colored.
32260 <P>
32261 If the pattern you enter is a comma-separated list of patterns, then coloring
32262 happens if any of those patterns matches.
32263 <P>
32264 <A HREF="h_color_setup">Descriptions of the available commands</A>
32265 <P>
32266 Look <A HREF="h_edit_nav_cmds">here</A>
32267 to see the available Editing and Navigation commands.
32268 <P>
32269 &lt;End of help on this topic&gt;
32270 </BODY>
32271 </HTML>
32272 ====== h_config_indextoken_color =====
32273 <HTML>
32274 <HEAD>
32275 <TITLE>OPTION: <!--#echo var="VAR_index-token-colors"--></TITLE>
32276 </HEAD>
32277 <BODY>
32278 <H1>OPTION: <!--#echo var="VAR_index-token-colors"--></H1>
32279
32280 This option allows you to set up the color in which any token, not specified by the
32281 previous options, will be colored in the MESSAGE INDEX screen.
32282 <P>
32283 In order to use this option, you must press the &quot;I&quot; <B>IndxHdr</B> command, and add
32284 a token that can be used in the index format.
32285 The list of available tokens is <A HREF="h_index_tokens">here</A>.
32286 <P>
32287 If you fail to enter a valid token your entry will be ignored, and you will be asked to
32288 enter a new one. Once you have entered a valid token, a line will be added to the
32289 configuration screen that you can use to set up the colors in which that token will
32290 be painted. This is done in the same way that you configure colors for other
32291 variables.
32292
32293 <A HREF="h_color_setup">Descriptions of the available commands</A>
32294 <P>
32295 Look <A HREF="h_edit_nav_cmds">here</A>
32296 to see the available Editing and Navigation commands.
32297 <P>
32298 &lt;End of help on this topic&gt;
32299 </BODY>
32300 </HTML>
32301 ====== h_config_customhdr_pattern =====
32302 <HTML>
32303 <HEAD>
32304 <TITLE>OPTION: Viewer Header Color Pattern</TITLE>
32305 </HEAD>
32306 <BODY>
32307 <H1>OPTION: Viewer Header Color Pattern</H1>
32308
32309 If you leave this blank, then the whole field for the header will
32310 be colored.
32311 If you give a pattern to match, the coloring will only take place
32312 if there is a match for that pattern in the value of the field.
32313 For example, if you are working on a color for the Subject header and
32314 you fill in a pattern of &quot;important&quot;, then only Subjects that
32315 contain the word &quot;important&quot; will be colored.
32316 <P>
32317 For address headers (like From and To) and for the Newsgroups header,
32318 a pattern match will cause only the matched addresses or newsgroups to be
32319 colored.
32320 If there is no pattern to match, then all of the addresses or newsgroups
32321 in the relevant header will be colored.
32322 <P>
32323 The matching pattern may be a comma-separated list of patterns to match
32324 instead of a single pattern.
32325 For example, you could use the pattern &quot;important,urgent&quot; which would
32326 cause a match if either the word &quot;important&quot; or the word
32327 &quot;urgent&quot; appeared in the value of the header.
32328 You could list several comma-separated email addresses in the Header
32329 From Color pattern so that those addresses will be colored when any of
32330 them appear in the From header.
32331 <P>
32332 To add a new matching pattern or change the existing pattern use the
32333 <!--chtml if pinemode="function_key"-->
32334 &quot;F4&quot;
32335 <!--chtml else-->
32336 &quot;C&quot;
32337 <!--chtml endif-->
32338 &quot;Change&quot; command that is available when the &quot;Pattern to
32339 match&quot; line is highlighted.
32340 The
32341 <!--chtml if pinemode="function_key"-->
32342 &quot;F10&quot;
32343 <!--chtml else-->
32344 &quot;D&quot;
32345 <!--chtml endif-->
32346 &quot;Delete&quot; command may be used to quickly remove all patterns
32347 for a particular header.
32348 <P>
32349 &lt;End of help on this topic&gt;
32350 </BODY>
32351 </HTML>
32352 ====== h_color_setup =====
32353 <HTML>
32354 <HEAD>
32355 <TITLE>SETUP COLOR COMMANDS</TITLE>
32356 </HEAD>
32357 <BODY>
32358 <H1>SETUP COLOR COMMANDS</H1>
32359 <!--chtml if pinemode="function_key"-->
32360 <PRE>
32361 Available Commands -- Group 1
32362 -------------------------------
32363 F1  Display this help text
32364 F2  Show other available commands
32365 F3  Exit to MAIN MENU
32366 F4  Select the highlighted foreground or background color
32367 F5  Move to previous line
32368 F6  Move to next line
32369 F7  Previous page
32370 F8  Next page
32371 F9  Add a config section for a header field
32372 F10 Restore all default colors (for all sections)
32373 F11 Print color configuration screen
32374 F12 Whereis (search for word)
32375
32376 Available Commands -- Group 2
32377 -------------------------------
32378 F1  Display this help text
32379 F2  Show other available commands
32380 F5  Delete config section for highlighted header field
32381 F6  Shuffle the order of Header Color sections
32382 </PRE>
32383 <!--chtml else-->
32384 <PRE>
32385 General commands
32386 -------------------------------------------------
32387  ?  Display this help text     E  Exit back to MAIN MENU
32388  P  Previous Line              N  Next Line
32389  -  Previous page             Spc (space bar) Next page
32390  W  WhereIs (search for word)  %  Print color configuration screen
32391
32392 Color Setup Commands
32393 ------------------------------------------------
32394  *  Select the highlighted foreground or background color
32395  A  Add a config section for a header field
32396  D  Delete config section for highlighted header field
32397  R  Restore all default colors (for all sections)
32398  $  Shuffle the order of Header Color sections
32399 </PRE>
32400 <!--chtml endif-->
32401
32402 <H2>Description of the Setup Color Screen</H2>
32403
32404 From this screen you may turn on color and set the colors of
32405 various parts of the Alpine display.
32406 For help on turning on color move your cursor into the Color Style section
32407 at the top of the Setup Color screen and ask for help.
32408
32409 <P>
32410 There are several sections in the Setup Color Screen.
32411 At the top are some settings that handle the style of color used
32412 with your terminal emulator (UNIX only), and some settings that
32413 control how the current indexline and the titlebar are colored.
32414 After that comes a long section called GENERAL COLORS that allows
32415 you to set the color of many elements in the Alpine screens.
32416 For example, the color of the titlebar, status messages,
32417 selectable links, quotes and signatures in messages, and so on.
32418 After that is a section called INDEX COLORS that allows you to
32419 set the colors of various pieces of the displayed index lines in
32420 the MESSAGE INDEX screen.
32421 The next section is HEADER COLORS. This is for coloring headers of
32422 messages in the MESSAGE TEXT screen in just about any way you would like.
32423 Finally, the KEYWORD COLORS section allows you to highlight
32424 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>
32425 in the MESSAGE INDEX screen.
32426
32427 <P>
32428 To change a color, highlight the color you want to change (for example,
32429 the Status Color) by moving
32430 the cursor into it.
32431 You may want to read the help text for the color to see a brief desription
32432 of what you are coloring.
32433 Then press &quot;C&quot; for Change to set the color to something new.
32434 That will put you into a screen with two columns of colors, one for
32435 the foreground color and one for the background color.
32436 The foreground color is just the color you want the actual characters
32437 to be and the background color is the color of the rest of the rectangle
32438 behind the characters.
32439 Select the foreground and background colors desired by using the Next and
32440 Prev keys to highlight the color, and the * command to select it.
32441 <P>
32442 To set a color to its default value, set the X in the Default line at
32443 the bottom of the list of colors.
32444 <P>
32445
32446 The HEADER COLORS section is a little bit different from the others.
32447 Besides coloring the specific fields that Alpine knows about, you may also
32448 color specific header fields when viewing a message in the MESSAGE TEXT
32449 screen.
32450 For example, you may color the Subject header a particular color.
32451 There are a few commands for use with headers.
32452 The &quot;AddHeader&quot; command adds a section to the color
32453 configuration screen that allows you to set the color for that header.
32454 You'll be asked for the name of the header field you want to color.
32455 If you wanted to color the Subject, you would answer
32456 with the word &quot;subject&quot;.
32457 Once you've added a header field, the color setting works just like the
32458 other color fields, except that there is an additional line on the
32459 configuration screen labeled &quot;Pattern to match&quot;.
32460 If you leave that blank, then the whole field for that header will always
32461 be colored.
32462 However, if you give a pattern to match, the coloring will only take place
32463 if there is a match for that pattern in the value of the field.
32464 For example, if you are working on a color for the Subject header and
32465 you fill in a pattern of &quot;important&quot;, then only Subjects that
32466 contain the word &quot;important&quot; will be colored.
32467 <P>
32468 The &quot;DeleteHdr&quot; command removes a header section from the
32469 configuration altogether.
32470 The &quot;Shuffle&quot; command changes the order of header sections.
32471 This is only necessary if you use header sections with pattern fields.
32472 For example, if you have two Subject sections, one with one pattern and
32473 another with another pattern, and the subject for a particular message
32474 happens to match both, then the color from the first match is used.
32475 <P>
32476
32477 The command &quot;RestoreDefs&quot; will restore all of the default colors.
32478 Each section will change to the default value used for that section when
32479 color is first enabled.
32480 When you restore all default colors the color settings for the Header Colors
32481 will be unset (since that's the default), but the header fields you've
32482 added will remain so that you may easily reset them.
32483 In order to get rid of them completely you'd have to use
32484 the &quot;DeleteHdr&quot; command.
32485
32486 <P>
32487 Remember that <A HREF="h_rules_incols">Index Line Colors</A>
32488 may be set with matching rules and that is configured separately from
32489 the rest of the color settings described here.
32490 It is configured in the Setup/Rules/Indexcolors section of the configuration screen
32491 instead of in the Setup/Kolor section.
32492
32493 <P><UL>
32494 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32495 </UL><P>
32496 &lt;End of help on this topic&gt;
32497 </BODY>
32498 </HTML>
32499 ====== h_config_news_uses_recent ======
32500 <HTML>
32501 <HEAD>
32502 <TITLE>FEATURE: <!--#echo var="FEAT_news-approximates-new-status"--></TITLE>
32503 </HEAD>
32504 <BODY>
32505 <H1>FEATURE: <!--#echo var="FEAT_news-approximates-new-status"--></H1>
32506
32507 This feature causes certain messages to be marked as "New" in the
32508 MESSAGE INDEX of newsgroups.
32509 This feature is set by default.
32510
32511 <P>
32512
32513 When opening a newsgroup, Alpine will consult your "newsrc" file and
32514 determine the last message you have previously disposed of via the "D"
32515 key.  If this feature is set, any subsequent messages will be shown in the
32516 Index with an "N", and the first of these messages will be highlighted.
32517 Although this is only an approximation of true "New" or "Unseen"
32518 status, it provides a useful cue to distinguish more-or-less recent
32519 messages from those you have seen previously, but are not yet ready to
32520 mark deleted.
32521
32522 <P>
32523
32524 Background: your "newsrc" file (used to store message status information
32525 for newsgroups) is only capable of storing a single flag, and Alpine uses
32526 this to record whether or not you are "done with" a message, as
32527 indicated by marking the message as "Deleted".  Unfortunately, this
32528 means that Alpine has no way to record exactly which messages you have
32529 previously seen, so it normally does not show the "N" status flag for
32530 any messages in a newsgroup. This feature enables a starting
32531 *approximation* of seen/unseen status that may be useful.
32532 <P>
32533 &lt;End of help on this topic&gt;
32534 </BODY>
32535 </HTML>
32536 ====== h_config_expose_hidden_config =====
32537 <HTML>
32538 <HEAD>
32539 <TITLE>FEATURE: <!--#echo var="FEAT_expose-hidden-config"--></TITLE>
32540 </HEAD>
32541 <BODY>
32542 <H1>FEATURE: <!--#echo var="FEAT_expose-hidden-config"--></H1>
32543
32544 If set, this causes configuration options and features that are normally
32545 hidden from view to be editable in the Setup/Config screen.
32546
32547 <P>
32548 The purpose of this feature is to allow you to change configuration
32549 features and variables that are normally hidden.
32550 This is particularly useful if you are using a remote configuration,
32551 where it is difficult to edit the contents manually, but it may also be used
32552 on a local pinerc configuration file.
32553 <P>
32554 If set, several configuration variables and features that are normally
32555 hidden from view will show up in the Setup/Configuration screen.
32556 They will be at the bottom of the configuration screen.
32557 You can find them by searching for the words &quot;hidden configuration&quot;.
32558 <P>
32559
32560 Note that this is an advanced feature that should be used with care.
32561 The reason that this part of the configuration is normally hidden is because
32562 there is a significant potential for causing problems if you change these
32563 variables.
32564 If something breaks after a change try changing it back to see if that is
32565 what is causing the problem.
32566 There are also some variables that are normally hidden because they are
32567 manipulated through Alpine in other ways.
32568 For example, colors are normally set using the Setup/Kolors screen and
32569 the &quot;<!--#echo var="VAR_address-book"-->&quot; variable is normally set using
32570 the Setup/AddressBooks screen, so there is little reason to edit these directly.
32571 The &quot;<!--#echo var="VAR_incoming-folders"-->&quot; variable is normally changed by using
32572 the Add, Delete, and Rename commands in the FOLDER LIST screen,
32573 and the &quot;<!--#echo var="VAR_last-time-prune-questioned"-->&quot; variable is normally used
32574 internally by Alpine and not set directly by the user.
32575 <P>
32576 <UL>
32577 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32578 </UL><P>
32579 &lt;End of help on this topic&gt;
32580 </BODY>
32581 </HTML>
32582 ====== h_config_disable_signature_edit =====
32583 <HTML>
32584 <HEAD>
32585 <TITLE>FEATURE: <!--#echo var="FEAT_disable-signature-edit-cmd"--></TITLE>
32586 </HEAD>
32587 <BODY>
32588 <H1>FEATURE: <!--#echo var="FEAT_disable-signature-edit-cmd"--></H1>
32589
32590 If set, this disables the editing of signature files from within
32591 the Setup/Config screen.
32592 <P>
32593 <UL>
32594 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32595 </UL><P>
32596 &lt;End of help on this topic&gt;
32597 </BODY>
32598 </HTML>
32599 ====== h_config_disable_roles_templateedit =====
32600 <HTML>
32601 <HEAD>
32602 <TITLE>FEATURE: <!--#echo var="FEAT_disable-roles-template-edit"--></TITLE>
32603 </HEAD>
32604 <BODY>
32605 <H1>FEATURE: <!--#echo var="FEAT_disable-roles-template-edit"--></H1>
32606
32607 If set, this disables the editing of template files within the
32608 Role setup screen.
32609 <P>
32610 <UL>
32611 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32612 </UL><P>
32613 &lt;End of help on this topic&gt;
32614 </BODY>
32615 </HTML>
32616 ====== h_config_disable_roles_sigedit =====
32617 <HTML>
32618 <HEAD>
32619 <TITLE>FEATURE: <!--#echo var="FEAT_disable-roles-sig-edit"--></TITLE>
32620 </HEAD>
32621 <BODY>
32622 <H1>FEATURE: <!--#echo var="FEAT_disable-roles-sig-edit"--></H1>
32623
32624 If set, this disables the editing of signature files within the
32625 Role setup screen.
32626 <P>
32627 <UL>
32628 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32629 </UL><P>
32630 &lt;End of help on this topic&gt;
32631 </BODY>
32632 </HTML>
32633 ====== h_config_disable_roles_setup =====
32634 <HTML>
32635 <HEAD>
32636 <TITLE>FEATURE: <!--#echo var="FEAT_disable-roles-setup-cmd"--></TITLE>
32637 </HEAD>
32638 <BODY>
32639 <H1>FEATURE: <!--#echo var="FEAT_disable-roles-setup-cmd"--></H1>
32640
32641 If set, this disables the Setup/Rules/Roles command.
32642 <P>
32643 <UL>
32644 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32645 </UL><P>
32646 &lt;End of help on this topic&gt;
32647 </BODY>
32648 </HTML>
32649 ====== h_config_disable_pipes_in_templates =====
32650 <HTML>
32651 <HEAD>
32652 <TITLE>FEATURE: <!--#echo var="FEAT_disable-pipes-in-templates"--></TITLE>
32653 </HEAD>
32654 <BODY>
32655 <H1>FEATURE: <!--#echo var="FEAT_disable-pipes-in-templates"--></H1>
32656
32657 By default, if a template file name is followed by a vertical bar (|) then
32658 that causes the file to be executed to produce the text for the template.
32659 If this feature is set, then this is not allowed.
32660 <P>
32661 <UL>
32662 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32663 </UL><P>
32664 &lt;End of help on this topic&gt;
32665 </BODY>
32666 </HTML>
32667 ====== h_config_disable_pipes_in_sigs =====
32668 <HTML>
32669 <HEAD>
32670 <TITLE>FEATURE: <!--#echo var="FEAT_disable-pipes-in-sigs"--></TITLE>
32671 </HEAD>
32672 <BODY>
32673 <H1>FEATURE: <!--#echo var="FEAT_disable-pipes-in-sigs"--></H1>
32674
32675 By default, if a signature file name is followed by a vertical bar (|) then
32676 that causes the file to be executed to produce the text for the signature.
32677 If this feature is set, then this is not allowed.
32678 <P>
32679 <UL>
32680 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32681 </UL><P>
32682 &lt;End of help on this topic&gt;
32683 </BODY>
32684 </HTML>
32685 ====== h_config_disable_password_cmd =====
32686 <HTML>
32687 <HEAD>
32688 <TITLE>FEATURE: <!--#echo var="FEAT_disable-password-cmd"--></TITLE>
32689 </HEAD>
32690 <BODY>
32691 <H1>FEATURE: <!--#echo var="FEAT_disable-password-cmd"--></H1>
32692
32693 If set, then the Setup/Newpassword command is disabled.
32694 <P>
32695 <UL>
32696 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32697 </UL><P>
32698 &lt;End of help on this topic&gt;
32699 </BODY>
32700 </HTML>
32701 ====== h_config_disable_password_caching =====
32702 <HTML>
32703 <HEAD>
32704 <TITLE>FEATURE: <!--#echo var="FEAT_disable-password-caching"--></TITLE>
32705 </HEAD>
32706 <BODY>
32707 <H1>FEATURE: <!--#echo var="FEAT_disable-password-caching"--></H1>
32708
32709 Normally, loginname/password combinations are cached in Alpine so that
32710 you do not have to enter the same password more than once in a session.
32711 A disadvantage to this approach is that the password must be stored in
32712 the memory image of the running Alpine in order that it can be re-used.
32713 In the event that Alpine crashes and produces a core dump, and that core
32714 dump is readable by others, the loginname and password could be read
32715 from the core dump.
32716 <P>
32717 If this feature is set, then the passwords will not be cached and you
32718 will have to retype the password whenever Alpine needs it.
32719 Even with this feature set there is still some chance that the core
32720 file will contain a password, so care should be taken to make the
32721 core files unreadable.
32722 <P>
32723 NOTE: If PASSFILE caching is enabled, this does not disable it.
32724 That is a separate and independent feature.
32725 <UL>
32726 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32727 </UL><P>
32728 &lt;End of help on this topic&gt;
32729 </BODY>
32730 </HTML>
32731 ====== h_config_disable_kb_lock =====
32732 <HTML>
32733 <HEAD>
32734 <TITLE>FEATURE: <!--#echo var="FEAT_disable-keyboard-lock-cmd"--></TITLE>
32735 </HEAD>
32736 <BODY>
32737 <H1>FEATURE: <!--#echo var="FEAT_disable-keyboard-lock-cmd"--></H1>
32738
32739 If set, then the Keyboard Lock command is removed from the MAIN MENU.
32740 <P>
32741 <UL>
32742 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32743 </UL><P>
32744 &lt;End of help on this topic&gt;
32745 </BODY>
32746 </HTML>
32747 ====== h_config_disable_config_cmd =====
32748 <HTML>
32749 <HEAD>
32750 <TITLE>FEATURE: <!--#echo var="FEAT_disable-config-cmd"--></TITLE>
32751 </HEAD>
32752 <BODY>
32753 <H1>FEATURE: <!--#echo var="FEAT_disable-config-cmd"--></H1>
32754
32755 If set, then the Setup/Config screen is disabled.
32756 <P>
32757 <UL>
32758 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32759 </UL><P>
32760 &lt;End of help on this topic&gt;
32761 </BODY>
32762 </HTML>
32763 ====== h_config_allow_chg_from =====
32764 <HTML>
32765 <HEAD>
32766 <TITLE>FEATURE: <!--#echo var="FEAT_allow-changing-from"--></TITLE>
32767 </HEAD>
32768 <BODY>
32769 <H1>FEATURE: <!--#echo var="FEAT_allow-changing-from"--></H1>
32770
32771 This feature affects Alpine's handling of the &quot;From:&quot; header field
32772 in the "<A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A>" configuration
32773 option.
32774 <P>
32775 If this feature is set then the From line can be changed just like
32776 all the other header fields that can be changed.
32777 This feature defaults to <EM>ON</EM>.
32778 <P>
32779 Even with this feature turned ON (the default) you will not be able
32780 to change the From header unless you add it to your list of
32781 <A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A>.
32782 You may also want to change the
32783 <A HREF="h_config_comp_hdrs"><!--#echo var="VAR_default-composer-hdrs"--></A>
32784 if you want the From header to always show up in the composer without
32785 having to type the Rich Headers command first.
32786 <P>
32787 Note that many sites restrict the use of this feature in order to
32788 reduce the chance of falsified addresses and misdirected mail.
32789 If you want to change the value of what gets included in the From header
32790 in messages you send
32791 look <A HREF="h_config_change_your_from">here</A> for a description.
32792 <P>
32793 <UL>
32794 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32795 </UL><P>
32796 &lt;End of help on this topic&gt;
32797 </BODY>
32798 </HTML>
32799 ====== h_config_disable_collate =====
32800 <HTML>
32801 <HEAD>
32802 <TITLE>FEATURE: <!--#echo var="FEAT_disable-setlocale-collate"--></TITLE>
32803 </HEAD>
32804 <BODY>
32805 <H1>FEATURE: <!--#echo var="FEAT_disable-setlocale-collate"--></H1>
32806
32807 This is a hard to understand feature that should only be used in rare cases.
32808 Normally, the C function call
32809 <P>
32810 <CENTER><SAMP>setlocale(LC_COLLATE, &quot;&quot;)</SAMP></CENTER>
32811 <P>
32812 is used by Alpine.
32813 If you want to try turning it off,
32814 setting this feature will turn it off.
32815 This part of the locale has to do with the sort order
32816 of characters in your locale.
32817 <P>
32818 <UL>
32819 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32820 </UL><P>
32821 &lt;End of help on this topic&gt;
32822 </BODY>
32823 </HTML>
32824 ====== h_config_quell_attach_extra_prompt =====
32825 <HTML>
32826 <HEAD>
32827 <TITLE>FEATURE: <!--#echo var="FEAT_quell-attachment-extra-prompt"--></TITLE>
32828 </HEAD>
32829 <BODY>
32830 <H1>FEATURE: <!--#echo var="FEAT_quell-attachment-extra-prompt"--></H1>
32831
32832 By default, when you attempt to view an attachment externally
32833 from the &quot;Attachment View&quot; screen, you are asked if you
32834 really want to view the selected attachment.
32835
32836 <P>
32837 If this feature is set, you will <B>not</B> be prompted to confirm
32838 your selection.  Prior to Alpine and to Pine 4.50, the default behavior was to not
32839 prompt. This feature was added for those wanting to preserve that
32840 behavior (along with
32841 <A HREF="h_config_quell_attach_ext_warn"><!--#echo var="FEAT_quell-attachment-extension-warn"--></A>).
32842
32843 <P>
32844 <UL>
32845 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32846 </UL><P>
32847 &lt;End of help on this topic&gt;
32848 </BODY>
32849 </HTML>
32850 ====== h_config_quell_attach_ext_warn =====
32851 <HTML>
32852 <HEAD>
32853 <TITLE>FEATURE: <!--#echo var="FEAT_quell-attachment-extension-warn"--></TITLE>
32854 </HEAD>
32855 <BODY>
32856 <H1>FEATURE: <!--#echo var="FEAT_quell-attachment-extension-warn"--></H1>
32857
32858 <P>
32859 This feature suppresses the extra warning you can get when trying
32860 to view an attachment for which there is no mime-type match.  Turning
32861 on this feature will just run the program according to extension
32862 instead of first warning the user that it will run according to the
32863 file's extension.
32864 <P>
32865 This feature can be used along side
32866 <A HREF="h_config_quell_attach_extra_prompt"><!--#echo var="FEAT_quell-attachment-extra-prompt"--></A>
32867 to preserve the behavior exhibited in Pine versions prior to Pine 4.50.
32868 <P>
32869 <UL>
32870 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32871 </UL><P>
32872 &lt;End of help on this topic&gt;
32873 </BODY>
32874 </HTML>
32875 ====== h_config_mailcap_params =====
32876 <HTML>
32877 <HEAD>
32878 <TITLE>FEATURE: <!--#echo var="FEAT_enable-mailcap-param-substitution"--></TITLE>
32879 </HEAD>
32880 <BODY>
32881 <H1>FEATURE: <!--#echo var="FEAT_enable-mailcap-param-substitution"--></H1>
32882
32883 If set, this will allow mailcap named parameter substitution to occur
32884 in mailcap entries.
32885 By default, this is turned off to prevent security problems that may occur
32886 with some incorrect mailcap configurations.
32887 For more information, see RFC1524 and look for "named parameters" in the
32888 text of the RFC.
32889 <P>
32890 <UL>
32891 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32892 </UL><P>
32893 &lt;End of help on this topic&gt;
32894 </BODY>
32895 </HTML>
32896 ====== h_config_disable_shared =====
32897 <HTML>
32898 <HEAD>
32899 <TITLE>FEATURE: <!--#echo var="FEAT_disable-shared-namespaces"--></TITLE>
32900 </HEAD>
32901 <BODY>
32902 <H1>FEATURE: <!--#echo var="FEAT_disable-shared-namespaces"--></H1>
32903
32904 If this feature is set, the automatic search for namespaces &quot;ftp&quot;,
32905 &quot;imapshared&quot;, and &quot;imappublic&quot; by the underlying library
32906 will be disabled.
32907 The reason this feature exists is because there are some implementations
32908 of system password lookup routines that are very slow when presented with
32909 a long loginname that does not exist.
32910 This feature could be set to prevent the delay at startup time when the
32911 names above are searched for in the password file.
32912 <P>
32913 <UL>
32914 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32915 </UL><P>
32916 &lt;End of help on this topic&gt;
32917 </BODY>
32918 </HTML>
32919 ====== h_config_hide_nntp_path =====
32920 <HTML>
32921 <HEAD>
32922 <TITLE>FEATURE: <!--#echo var="FEAT_hide-nntp-path"--></TITLE>
32923 </HEAD>
32924 <BODY>
32925 <H1>FEATURE: <!--#echo var="FEAT_hide-nntp-path"--></H1>
32926
32927 Normally the Path header that Alpine generates when posting to a newsgroup
32928 contains the name of the computer from which the message is being sent and
32929 the user name.
32930 Some believe that this information is used by spammers.
32931 If this feature is set, that information will be replaced with the text
32932 <P>
32933 <CENTER><SAMP>not-for-mail</SAMP></CENTER>
32934 <P>
32935 instead.
32936 <P>
32937 It should be noted that many servers being connected to will still reveal
32938 the information that this feature attempts to protect.
32939 <P>
32940 <UL>
32941 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32942 </UL><P>
32943 &lt;End of help on this topic&gt;
32944 </BODY>
32945 </HTML>
32946 ====== h_config_no_bezerk_zone =====
32947 <HTML>
32948 <HEAD>
32949 <TITLE>FEATURE: <!--#echo var="FEAT_quell-berkeley-format-timezone"--></TITLE>
32950 </HEAD>
32951 <BODY>
32952 <H1>FEATURE: <!--#echo var="FEAT_quell-berkeley-format-timezone"--></H1>
32953
32954 POSIX mandates a timezone in UNIX mailbox format folder delimiters
32955 (the line that begins with From <SPACE>).
32956 Some versions of Berkeley mail have trouble with this, and don't recognize
32957 the line as a message delimiter.
32958 If this feature is set, the timezone will be left off the delimiter line.
32959 <P>
32960 <UL>
32961 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32962 </UL><P>
32963 &lt;End of help on this topic&gt;
32964 </BODY>
32965 </HTML>
32966 ====== h_config_quell_domain_warn =====
32967 <HTML>
32968 <HEAD>
32969 <TITLE>FEATURE: <!--#echo var="FEAT_quell-maildomain-warning"--></TITLE>
32970 </HEAD>
32971 <BODY>
32972 <H1>FEATURE: <!--#echo var="FEAT_quell-maildomain-warning"--></H1>
32973
32974 When your configuration is set up so that your domain name contains no dots,
32975 it is usually a configuration error.
32976 By default, Alpine will warn you about this when you start it up.
32977 You will see a warning message that looks like
32978
32979 <P>
32980 <CENTER><SAMP>Incomplete maildomain &quot;&lt;domain&gt;&quot;.</SAMP></CENTER>
32981
32982 <P>
32983 If this feature is set, the warning is turned off.
32984 <P>
32985 <UL>
32986 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32987 </UL><P>
32988 &lt;End of help on this topic&gt;
32989 </BODY>
32990 </HTML>
32991 ====== h_config_quell_imap_env =====
32992 <HTML>
32993 <HEAD>
32994 <TITLE>FEATURE: <!--#echo var="FEAT_quell-imap-envelope-update"--></TITLE>
32995 </HEAD>
32996 <BODY>
32997 <H1>FEATURE: <!--#echo var="FEAT_quell-imap-envelope-update"--></H1>
32998
32999 In the MESSAGE INDEX screen, if the open folder is being accessed
33000 using IMAP, Alpine normally tries to paint the index lines on the screen
33001 as soon as the information arrives from the IMAP server.
33002 This means that the index information makes it onto the screen more quickly
33003 than it otherwise would.
33004 This sometimes results in behavior that bothers some users.
33005 For example, when paging to a new page of the index, it may be possible for
33006 the lines to be painted on the screen in a random order, rather than from
33007 top to bottom.
33008 <P>
33009
33010 Setting this feature causes Alpine to wait for all of the information
33011 to be gathered before it paints the index screen.
33012 Once it collects all of the information, the screen will be painted quickly
33013 from top to bottom.
33014 <P>
33015 <UL>
33016 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33017 </UL><P>
33018 &lt;End of help on this topic&gt;
33019 </BODY>
33020 </HTML>
33021 ====== h_config_quell_news_env =====
33022 <HTML>
33023 <HEAD>
33024 <TITLE>FEATURE: <!--#echo var="FEAT_quell-news-envelope-update"--></TITLE>
33025 </HEAD>
33026 <BODY>
33027 <H1>FEATURE: <!--#echo var="FEAT_quell-news-envelope-update"--></H1>
33028
33029 In the MESSAGE INDEX screen, if the open folder is being accessed
33030 using NNTP (News), Alpine normally tries to paint the index lines on the screen
33031 as soon as the information arrives from the NNTP server.
33032 This means that the index information makes it onto the screen more quickly
33033 than it otherwise would.
33034 This sometimes results in behavior that bothers some users.
33035 For example, when paging to a new page of the index, it may be possible for
33036 the lines to be painted on the screen in a random order, rather than from
33037 top to bottom.
33038 <P>
33039
33040 Setting this feature causes Alpine to wait for all of the information
33041 to be gathered before it paints the index screen.
33042 Once it collects all of the information, the screen will be painted quickly
33043 from top to bottom.
33044 <P>
33045 <UL>
33046 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33047 </UL><P>
33048 &lt;End of help on this topic&gt;
33049 </BODY>
33050 </HTML>
33051 ====== h_config_quell_content_id =====
33052 <HTML>
33053 <HEAD>
33054 <TITLE>FEATURE: <!--#echo var="FEAT_quell-content-id"--></TITLE>
33055 </HEAD>
33056 <BODY>
33057 <H1>FEATURE: <!--#echo var="FEAT_quell-content-id"--></H1>
33058
33059 This feature changes the behavior of Alpine when sending messages.
33060 It is intended to work around a bug in Microsoft's Outlook XP mail user
33061 agent.
33062 As of this writing, Microsoft has acknowledged the bug but
33063 has not added it to the Knowledge Base.
33064 We have been told that there will be a post-SP1 hotfix for Outlook XP.
33065 This particular bug has bug fix number OfficeQFE:4781.
33066 The nature of the bug is that messages with attachments that
33067 contain a Content-ID header (which standard Alpine attachments do)
33068 do not show the attachment indicator (a paperclip) when viewed with
33069 Outlook XP.
33070 So the user has no indication that the message contains an attachment.
33071
33072 <P>
33073 If this feature is set then Alpine will remove most Content-ID headers
33074 before sending a message.
33075 If an attachment is of type MESSAGE, then the existing Content-ID headers
33076 inside the message will be left intact.
33077 This would only happen with Alpine if a message was forwarded as an attachment
33078 or if a message with a message attached was forwarded.
33079 Similarly if an attachment of type MULTIPART/ALTERNATIVE is forwarded,
33080 the Content-ID headers of the alternative parts will not be removed.
33081
33082 <P>
33083 Because the Content-ID header is a standard part of MIME it is possible
33084 that setting this feature will break something.
33085 For example, if an attachment has a Content-ID header that is necessary
33086 for the correct functioning of that attachment, it is possible that Alpine
33087 may remove that header when the attachment is forwarded.
33088 However, it seems fairly safe at this time.
33089
33090 <P>
33091 <UL>
33092 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33093 </UL><P>
33094 &lt;End of help on this topic&gt;
33095 </BODY>
33096 </HTML>
33097 ====== h_config_winpos_in_config =====
33098 <HTML>
33099 <HEAD>
33100 <TITLE>FEATURE: <!--#echo var="FEAT_store-window-position-in-config"--></TITLE>
33101 </HEAD>
33102 <BODY>
33103 <H1>FEATURE: <!--#echo var="FEAT_store-window-position-in-config"--></H1>
33104
33105 PC-Alpine only.
33106 <P>
33107
33108 Normally, PC-Alpine will store its window size and position in the
33109 Windows Registry.
33110 This is convenient if you want to use the same remote
33111 configuration from more than one PC.
33112 If you use multiple configuration files to start PC-Alpine, you may want
33113 to store the window size and position in the configuration file instead
33114 of in the Registry.
33115 Setting this feature causes the value to be stored in
33116 <A HREF="h_config_window_position">Window-Position</A>.
33117
33118 <P>
33119 <UL>
33120 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33121 </UL><P>
33122 &lt;End of help on this topic&gt;
33123 </BODY>
33124 </HTML>
33125 ====== h_config_quell_ssl_largeblocks =====
33126 <HTML>
33127 <HEAD>
33128 <TITLE>FEATURE: <!--#echo var="FEAT_quell-ssl-largeblocks"--></TITLE>
33129 </HEAD>
33130 <BODY>
33131 <H1>FEATURE: <!--#echo var="FEAT_quell-ssl-largeblocks"--></H1>
33132
33133 PC-Alpine only.
33134 <P>
33135 This feature changes the behavior of fetching messages
33136 and attachments so that the message data is fetched in chunks no larger
33137 than 12K bytes.
33138 This works around a bug in Microsoft's SSL/TLS support.
33139 Some versions of Microsoft SSL are not able to read full-sized (16K)
33140 SSL/TLS packets.
33141 Some servers will send such packets and this will
33142 cause PC-Alpine to crash with the error
33143
33144 <P>
33145 <CENTER><SAMP>incomplete SecBuffer exceeds maximum buffer size</SAMP></CENTER>
33146
33147 <P>
33148 Microsoft is aware of the problem and has developed a hotfix for it, it is
33149 discussed in article 300562 in the Microsoft Knowledge Base.
33150 <P>
33151 <UL>
33152 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33153 </UL><P>
33154 &lt;End of help on this topic&gt;
33155 </BODY>
33156 </HTML>
33157 ====== h_config_quell_partial =====
33158 <HTML>
33159 <HEAD>
33160 <TITLE>FEATURE: <!--#echo var="FEAT_quell-partial-fetching"--></TITLE>
33161 </HEAD>
33162 <BODY>
33163 <H1>FEATURE: <!--#echo var="FEAT_quell-partial-fetching"--></H1>
33164
33165 Partial fetching is a feature of the IMAP protocol.
33166 By default, Alpine
33167 will use partial fetching when copying the contents of a message or attachment
33168 from the IMAP server to Alpine.
33169 This means that the fetch will be done in many
33170 small chunks instead of one big chunk. The main benefit of this approach is
33171 that the fetch becomes interruptible. That is, the user can type <EM>^C</EM>
33172 to stop the fetch early. In some cases partial fetching may cause a performance
33173 problem so that the fetching of data takes significantly longer when partial
33174 fetching is used. Turning on this feature will turn off partial fetching.
33175 <P>
33176 <UL>
33177 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33178 </UL><P>
33179 &lt;End of help on this topic&gt;
33180 </BODY>
33181 </HTML>
33182 ====== h_config_quell_personal_name_prompt =====
33183 <HTML>
33184 <HEAD>
33185 <TITLE>FEATURE: <!--#echo var="FEAT_quell-personal-name-prompt"--></TITLE>
33186 </HEAD>
33187 <BODY>
33188 <H1>FEATURE: <!--#echo var="FEAT_quell-personal-name-prompt"--></H1>
33189
33190 PC-Alpine only.  This feature quells the prompting for a
33191 <A HREF="h_config_pers_name">personal name</A>.  This
33192 prompt normally happens before composing a message, and only happens when
33193 there is no personal name already set.
33194 <P>
33195 <UL>
33196 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33197 </UL><P>
33198 &lt;End of help on this topic&gt;
33199 </BODY>
33200 </HTML>
33201 ====== h_config_quell_user_id_prompt =====
33202 <HTML>
33203 <HEAD>
33204 <TITLE>FEATURE: <!--#echo var="FEAT_quell-user-id-prompt"--></TITLE>
33205 </HEAD>
33206 <BODY>
33207 <H1>FEATURE: <!--#echo var="FEAT_quell-user-id-prompt"--></H1>
33208
33209 PC-Alpine only.  This feature quells the prompting for a
33210 <A HREF="h_config_user_id"><!--#echo var="VAR_user-id"--></A>
33211 if the information can be obtained from the login name used
33212 to open the INBOX.  Normally, this prompt happens before composing
33213 a message, and only happens when there is no user-id already set
33214 in the configuration.
33215 <P>
33216 With this feature set, composing a message is only possible after
33217 establishing a connection to the INBOX.
33218 <P>
33219 <UL>
33220 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33221 </UL><P>
33222 &lt;End of help on this topic&gt;
33223 </BODY>
33224 </HTML>
33225 ====== h_config_save_aggregates =====
33226 <HTML>
33227 <HEAD>
33228 <TITLE>FEATURE: <!--#echo var="FEAT_save-aggregates-copy-sequence"--></TITLE>
33229 </HEAD>
33230 <BODY>
33231 <H1>FEATURE: <!--#echo var="FEAT_save-aggregates-copy-sequence"--></H1>
33232
33233 This feature will optimize an aggregate copy operation, if
33234 possible, by issuing a single IMAP <EM>COPY</EM> command with a
33235 list of the messages to be copied.
33236 This feature is set by default.
33237 This may reduce network traffic and elapsed time for the Save.
33238 <EM>However, many IMAP servers (including the UW IMAP server) do
33239 not preserve the order of messages when this optimization is applied.</EM>
33240 If this feature is not set,
33241 Alpine will copy each message individually and the order of the messages
33242 will be preserved.
33243 <P>
33244 <UL>
33245 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33246 </UL><P>
33247 &lt;End of help on this topic&gt;
33248 </BODY>
33249 </HTML>
33250 ====== h_config_use_system_translation =====
33251 <HTML>
33252 <HEAD>
33253 <TITLE>FEATURE: Use System Translation</TITLE>
33254 </HEAD>
33255 <BODY>
33256 <H1>FEATURE: Use System Translation</H1>
33257
33258 UNIX Alpine only.
33259 <P>
33260 Alpine normally uses its own internal software to convert between the multi-byte
33261 representation of characters and the Unicode representation of those
33262 same characters.
33263 It converts from the multi-byte characters your keyboard produces to Unicode,
33264 and from Unicode to the multi-byte characters your display expects.
33265 Alpine also uses its own internal software to decide how much space on
33266 the screen a particular Unicode character will occupy.
33267
33268 <P>
33269 Setting this feature tells Alpine to use the system-supplied routines to
33270 perform these tasks instead.
33271 In particular there are three tasks and three system routines that will
33272 be used for these tasks.
33273
33274 <P>
33275 To convert from multi-byte to Unicode the routine
33276
33277 <P>
33278 <CENTER><SAMP>mbstowcs</SAMP></CENTER>
33279 <P>
33280
33281 is used.
33282 To convert from Unicode to multi-byte the routine
33283
33284 <P>
33285 <CENTER><SAMP>wcrtomb</SAMP></CENTER>
33286 <P>
33287
33288 is used.
33289 And to find the screen width a particular Unicode character will
33290 occupy the routine used is
33291
33292 <P>
33293 <CENTER><SAMP>wcwidth</SAMP></CENTER>
33294 <P>
33295
33296 This feature has been only lightly tested.
33297 The internal routines should normally be used unless you run into
33298 a problem that you think may be solved by using the system routines.
33299 Note that your environment needs to be set up for these
33300 routines to work correctly.
33301 In particular, the LANG or LC_CTYPE variable in your environment will
33302 need to be set.
33303
33304 <P>
33305 <UL>
33306 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33307 </UL><P>
33308 &lt;End of help on this topic&gt;
33309 </BODY>
33310 </HTML>
33311 ====== h_config_suspend_spawns =====
33312 <HTML>
33313 <HEAD>
33314 <TITLE>FEATURE: <!--#echo var="FEAT_use-subshell-for-suspend"--></TITLE>
33315 </HEAD>
33316 <BODY>
33317 <H1>FEATURE: <!--#echo var="FEAT_use-subshell-for-suspend"--></H1>
33318
33319 This feature affects Alpine's behavior when process suspension is enabled
33320 and then activated via the Ctrl-Z key.  Alpine suspension allows one to
33321 temporarily interact with the operating system command &quot;shell&quot;
33322 without
33323 quitting Alpine, and then subsequently resume the still-active Alpine session.
33324 <P>
33325
33326 When the <A HREF="h_config_can_suspend">&quot;<!--#echo var="FEAT_enable-suspend"-->&quot;</A> feature
33327 is set and subsequently the Ctrl-Z key
33328 is pressed, Alpine will normally suspend itself and return temporary control
33329 to Alpine's parent shell process.  However, if this feature is set, Alpine
33330 will instead create an inferior subshell process.  This is useful when the
33331 parent process is not intended to be used interactively.  Examples include
33332 invoking Alpine via the -e argument of the Unix &quot;xterm&quot; program,
33333 or via a menu system.<P>
33334
33335 Note that one typically resumes a suspended Alpine by entering the Unix
33336 &quot;fg&quot; command, but if this feature is set, it will be necessary to
33337 enter the &quot;exit&quot; command instead.
33338 <P>
33339 <UL>
33340 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33341 </UL><P>
33342 &lt;End of help on this topic&gt;
33343 </BODY>
33344 </HTML>
33345 ====== h_config_8bit_smtp =====
33346 <HTML>
33347 <HEAD>
33348 <TITLE>FEATURE: <!--#echo var="FEAT_enable-8bit-esmtp-negotiation"--></TITLE>
33349 </HEAD>
33350 <BODY>
33351 <H1>FEATURE: <!--#echo var="FEAT_enable-8bit-esmtp-negotiation"--></H1>
33352
33353 This feature affects Alpine's behavior when sending mail.
33354 By default, this feature is set.
33355 Internet standards
33356 require that all electronic mail messages traversing the global Internet
33357 consist of 7bit ASCII characters unless a pair of cooperating mail
33358 transfer agents explicitly agree to allow 8bit messages.  In general,
33359 then, exchanging messages in non-ASCII characters requires MIME encoding.
33360 <P>
33361 However, there are now Internet standards that allow for unencoded 8bit
33362 exchange of messages between cooperating systems.  When this feature is set
33363 Alpine will try to negotiate unencoded 8bit transmission during the
33364 sending process.  Should the negotiation fail, Alpine will fall back to its
33365 ordinary encoding rules.
33366 <P>
33367 Note, this feature relies on your system's mail transport agent or
33368 configured <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>
33369 having the negotiation mechanism introduced in
33370 &quot;Extended SMTP&quot; (ESMTP) and the specific extension called
33371 &quot;8BITMIME&quot;.
33372 <P>
33373 ESMTP allows for graceful migration to upgraded mail transfer agents, but
33374 it is possible that this feature might cause problems for some servers.
33375 <P><UL>
33376 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33377 </UL>
33378 <P>&lt;End of help on this topic&gt;
33379 </BODY>
33380 </HTML>
33381 ====== h_config_8bit_nntp =====
33382 <HTML>
33383 <HEAD>
33384 <TITLE>FEATURE: <!--#echo var="FEAT_enable-8bit-nntp-posting"--></TITLE>
33385 </HEAD>
33386 <BODY>
33387 <H1>FEATURE: <!--#echo var="FEAT_enable-8bit-nntp-posting"--></H1>
33388
33389 This feature affects Alpine's behavior when posting news.
33390
33391 <P>
33392
33393 The Internet standard for exchanging USENET news messages (RFC-1036)
33394 specifies that USENET messages should conform to Internet mail standards
33395 and contain only 7bit characters, but much of the news transport software
33396 in use today is capable of successfully sending messages containing 8bit
33397 characters.  Hence, many people believe that it is appropriate to send 8bit
33398 news messages without any MIME encoding.
33399
33400 <P>
33401
33402 Moreover, there is no Internet standard for explicitly negotiating 8bit
33403 transfer, as there is for Internet email.  Therefore, Alpine provides the
33404 option of posting unencoded 8bit news messages, though not as the default.
33405 Setting this feature will turn OFF Alpine's MIME encoding of newsgroup
33406 postings that contain 8bit characters.
33407
33408 <P>
33409
33410 Note, articles may cross a path or pass through news transport software
33411 that is unsafe or even hostile to 8bit characters.  At best this will only
33412 cause the posting to become garbled.  The safest way to transmit 8bit
33413 characters is to leave Alpine's MIME encoding turned on, but recipients
33414 who lack MIME-aware tools are often annoyed when they receive MIME-encoded
33415 messages.
33416 <P>
33417 &lt;End of help on this topic&gt;
33418 </BODY>
33419 </HTML>
33420 ====== h_config_mark_for_cc =====
33421 <HTML>
33422 <HEAD>
33423 <TITLE>FEATURE: <!--#echo var="FEAT_mark-for-cc"--></TITLE>
33424 </HEAD>
33425 <BODY>
33426 <H1>FEATURE: <!--#echo var="FEAT_mark-for-cc"--></H1>
33427
33428 This feature affects Alpine's MESSAGE INDEX display.
33429 By default, a '+' is displayed in the first column if the
33430 message is addressed directly to you.
33431 When this feature is set and the message is not addressed to you, then a
33432 '-' character is displayed if the message is instead Cc'd directly
33433 to you.
33434
33435 <P>
33436 <UL>
33437 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33438 </UL><P>
33439 &lt;End of help on this topic&gt;
33440 </BODY>
33441 </HTML>
33442 ====== h_config_tab_uses_unseen =====
33443 <HTML>
33444 <HEAD>
33445 <TITLE>FEATURE: <!--#echo var="FEAT_tab-uses-unseen-for-next-folder"--></TITLE>
33446 </HEAD>
33447 <BODY>
33448 <H1>FEATURE: <!--#echo var="FEAT_tab-uses-unseen-for-next-folder"--></H1>
33449
33450 This feature affects Alpine's behavior when using the TAB
33451 <A HREF="h_common_nextnew">NextNew Command</A>
33452 to move from one folder to the next.
33453 Alpine's usual behavior is to search for folders
33454 with <EM>Recent</EM> messages in them.
33455 Recent messages are messages that have arrived since the last time the
33456 folder was opened.
33457
33458 <P>
33459 Setting this feature causes Alpine to search for <EM>Unseen</EM>
33460 messages instead of Recent messages.
33461 Unseen messages remain Unseen until you view them (or flag then as Seen with
33462 the <A HREF="h_common_flag">Flag Command</A>).
33463 Setting this feature allows you to locate messages you have not read
33464 instead of only recently received messages.
33465 When this feature is set, the feature
33466 <A HREF="h_config_fast_recent">&quot;<!--#echo var="FEAT_enable-fast-recent-test"-->&quot;</A>
33467 will have no effect, so the checking may be slower.
33468
33469 <P>
33470 Another reason why you might want to use this feature is that Alpine sometimes
33471 opens folders implicitly behind the scenes, and this clears the
33472 Recent status of all messages in the folder.
33473 One example where this happens is when Saving or filtering a
33474 message to another folder.
33475 If that message has some <A HREF="h_config_keywords">keywords</A>
33476 set, then because of some shortcomings
33477 in the IMAP specification, the best way to ensure that those keywords are
33478 still set in the saved copy of the message is to open the folder and
33479 set the keywords explicitly.
33480 Because this clears the Recent status of all messages in that folder the
33481 folder will not be found by the NextNew command unless this feature is set.
33482
33483 <P>
33484 &lt;End of help on this topic&gt;
33485 </BODY>
33486 </HTML>
33487 ====== h_config_tab_new_only =====
33488 <HTML>
33489 <HEAD>
33490 <TITLE>FEATURE: <!--#echo var="FEAT_tab-visits-next-new-message-only"--></TITLE>
33491 </HEAD>
33492 <BODY>
33493 <H1>FEATURE: <!--#echo var="FEAT_tab-visits-next-new-message-only"--></H1>
33494
33495 This feature affects Alpine's behavior when using the TAB key to move from
33496 one message to the next.  Alpine's usual behavior is to select the next
33497 unread message or message flagged as "Important".
33498
33499 <P>
33500
33501 Setting this feature causes Alpine to skip the messages flagged as important,
33502 and select unread messages exclusively.  Tab behavior when there are no
33503 new messages left to select remains unchanged.
33504 <P>
33505 &lt;End of help on this topic&gt;
33506 </BODY>
33507 </HTML>
33508 ====== h_config_warn_if_subj_blank =====
33509 <HTML>
33510 <HEAD>
33511 <TITLE>FEATURE: <!--#echo var="FEAT_warn-if-blank-subject"--></TITLE>
33512 </HEAD>
33513 <BODY>
33514 <H1>FEATURE: <!--#echo var="FEAT_warn-if-blank-subject"--></H1>
33515
33516 This feature affects Alpine's behavior when you send a message being
33517 composed.
33518 If this option is set, Alpine will check to see if the message about to be sent
33519 has a subject or not.
33520 If not, you will be asked if you want to send the message anyway.
33521 <P>
33522
33523 <UL>
33524 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33525 </UL><P>
33526 &lt;End of help on this topic&gt;
33527 </BODY>
33528 </HTML>
33529 ====== h_config_warn_if_fcc_blank =====
33530 <HTML>
33531 <HEAD>
33532 <TITLE>FEATURE: <!--#echo var="FEAT_warn-if-blank-fcc"--></TITLE>
33533 </HEAD>
33534 <BODY>
33535 <H1>FEATURE: <!--#echo var="FEAT_warn-if-blank-fcc"--></H1>
33536
33537 This feature affects Alpine's behavior when you send a message being
33538 composed.
33539 If this option is set, Alpine will check to see if the message about to be sent
33540 has an Fcc or not.
33541 If not, you will be asked if you want to send the message anyway.
33542 <P>
33543
33544 <UL>
33545 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33546 </UL><P>
33547 &lt;End of help on this topic&gt;
33548 </BODY>
33549 </HTML>
33550 ====== h_config_warn_if_no_to_or_cc =====
33551 <HTML>
33552 <HEAD>
33553 <TITLE>FEATURE: <!--#echo var="FEAT_warn-if-blank-to-and-cc-and-newsgroups"--></TITLE>
33554 </HEAD>
33555 <BODY>
33556 <H1>FEATURE: <!--#echo var="FEAT_warn-if-blank-to-and-cc-and-newsgroups"--></H1>
33557
33558 This feature affects Alpine's behavior when you send a message being
33559 composed.
33560 If this option is set, Alpine will check to see if the message about to be sent
33561 has either a To address, a Cc address, or a Newsgroup.
33562 If none of these is set,
33563 you will be asked if you want to send the message anyway.
33564 <P>
33565
33566 This feature is closely related to
33567 <A HREF="h_config_auto_fcc_only"><!--#echo var="FEAT_fcc-only-without-confirm"--></A>.
33568 Alpine will normally ask if you want to copy a message only to the Fcc.
33569 This feature also applies to cases where there is a Bcc but still no To, Cc,
33570 or Newsgroup.
33571 If the <!--#echo var="FEAT_fcc-only-without-confirm"--> feature is set and you are sending a
33572 message with only an Fcc, then you won't be asked about sending with
33573 a blank To and Cc and Newsgroups header even if this feature is set.
33574 Similarly, if you have already been asked if you want to send to the Fcc
33575 only and you have answered Yes, then you won't be asked again about sending with
33576 blank To, Cc, and Newsgroups headers even if this feature is set.
33577 <P>
33578
33579 <UL>
33580 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33581 </UL><P>
33582 &lt;End of help on this topic&gt;
33583 </BODY>
33584 </HTML>
33585 ====== h_config_quell_dead_letter =====
33586 <HTML>
33587 <HEAD>
33588 <TITLE>FEATURE: <!--#echo var="FEAT_quell-dead-letter-on-cancel"--></TITLE>
33589 </HEAD>
33590 <BODY>
33591 <H1>FEATURE: <!--#echo var="FEAT_quell-dead-letter-on-cancel"--></H1>
33592
33593 This feature affects Alpine's behavior when you cancel a message being
33594 composed.  Alpine's usual behavior is to write the canceled message to
33595 a file named
33596 <!--chtml if pinemode="os_windows"-->
33597 &quot;DEADLETR&quot;,
33598 <!--chtml else-->
33599 &quot;dead.letter&quot; in your home directory,
33600 <!--chtml endif-->
33601 overwriting any previous message. Under
33602 some conditions (some routine), this can introduce a noticeable delay.
33603 Setting this feature will cause Alpine NOT to write canceled compositions
33604 into the file.
33605 <P>
33606 NOTE: Enabling this feature means NO record of canceled messages is
33607 maintained.
33608 <P>
33609 This feature affects the newer option
33610 <A HREF="h_config_deadlets"><!--#echo var="VAR_dead-letter-files"--></A>, which specifies the
33611 number of dead letter files to keep around.
33612 If this feature is set, then the <!--#echo var="VAR_dead-letter-files"--> option has no effect.
33613 <P>
33614 <UL>
33615 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33616 </UL><P>
33617 &lt;End of help on this topic&gt;
33618 </BODY>
33619 </HTML>
33620 ====== h_config_quell_beeps =====
33621 <HTML>
33622 <HEAD>
33623 <TITLE>FEATURE: <!--#echo var="FEAT_quell-status-message-beeping"--></TITLE>
33624 </HEAD>
33625 <BODY>
33626 <H1>FEATURE: <!--#echo var="FEAT_quell-status-message-beeping"--></H1>
33627
33628 This feature affects Alpine's behavior when it displays status message
33629 (e.g., Error complaints, New mail warnings, etc).  Setting this feature
33630 will not affect the display of such messages, but will cause those that
33631 emit a beep to become silent.
33632
33633 <P>
33634 <UL>
33635 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33636 </UL><P>
33637 &lt;End of help on this topic&gt;
33638 </BODY>
33639 </HTML>
33640 ====== h_config_suppress_user_agent =====
33641 <HTML>
33642 <HEAD>
33643 <TITLE>FEATURE: <!--#echo var="FEAT_suppress-user-agent-when-sending"--></TITLE>
33644 </HEAD>
33645 <BODY>
33646 <H1>FEATURE: <!--#echo var="FEAT_suppress-user-agent-when-sending"--></H1>
33647
33648 If this feature is set then Alpine will not generate a
33649 <CODE>User-Agent</CODE> header in outgoing messages.
33650 <P>
33651 <UL>
33652 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33653 </UL><P>
33654 &lt;End of help on this topic&gt;
33655 </BODY>
33656 </HTML>
33657 ====== h_config_quell_lock_failure_warnings =====
33658 <HTML>
33659 <HEAD>
33660 <TITLE>FEATURE: <!--#echo var="FEAT_quell-lock-failure-warnings"--></TITLE>
33661 </HEAD>
33662 <BODY>
33663 <H1>FEATURE: <!--#echo var="FEAT_quell-lock-failure-warnings"--></H1>
33664
33665 This feature affects Alpine's behavior when it encounters a problem
33666 acquiring a mail folder lock.  Typically, a secondary file associated
33667 with the mail folder being opened is created as part of the locking
33668 process.  On some systems, such file creation has been administratively
33669 precluded by the system configuration.
33670 <P>
33671 Alpine issues a warning when such failures occur, which can become bothersome
33672 if the system is configured to disallow such actions.  Setting this
33673 feature causes Alpine to remain silent when this part of lock creation fails.
33674 <P>
33675 WARNING: systems that have been configured in a way that precludes locking
33676 introduce some risk of mail folder corruption when more than one program
33677 attempts to modify the mail folder.  This is most likely to occur to one's
33678 INBOX or other incoming message folder.
33679 <P>
33680 See also <A HREF="h_info_on_locking">&quot;What Systems Managers Need to Know about Alpine File Locking&quot;</A>.
33681 <P>
33682 <UL>
33683 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33684 </UL><P>
33685 &lt;End of help on this topic&gt;
33686 </BODY>
33687 </HTML>
33688 ====== h_config_enable_role_take ======
33689 <HTML>
33690 <HEAD>
33691 <TITLE>FEATURE: <!--#echo var="FEAT_enable-rules-under-take"--></TITLE>
33692 </HEAD>
33693 <BODY>
33694 <H1>FEATURE: <!--#echo var="FEAT_enable-rules-under-take"--></H1>
33695
33696 Normally, the Take command takes addresses from a message and helps you
33697 put them into your Address Book.
33698 If you use Rules for Indexcolors, Roles, Filtering, or Scoring;
33699 you may find it useful
33700 to be able to Take information from a message's headers and put it into
33701 a new Rule.
33702 When this feature is set, you will be given an extra prompt that gives
33703 you the choice to Take into the Address Book or Take into a rule.
33704 <P><UL>
33705 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33706 </UL>
33707 <P>
33708 &lt;End of help on this topic&gt;
33709 </BODY>
33710 </HTML>
33711 ====== h_config_enable_take_export ======
33712 <HTML>
33713 <HEAD>
33714 <TITLE>FEATURE: <!--#echo var="FEAT_enable-take-export"--></TITLE>
33715 </HEAD>
33716 <BODY>
33717 <H1>FEATURE: <!--#echo var="FEAT_enable-take-export"--></H1>
33718
33719 Normally, the Take command takes addresses from a message and helps you
33720 put them into your Address Book.
33721 When this feature is set, you will be given an extra prompt that gives you
33722 the choice to Take addresses into a file instead of your Address
33723 Book.
33724 Only the user@domain_name part of the address is put in the file.
33725 <P><UL>
33726 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33727 </UL>
33728 <P>
33729 &lt;End of help on this topic&gt;
33730 </BODY>
33731 </HTML>
33732 ====== h_config_quell_folder_internal_msg ======
33733 <HTML>
33734 <HEAD>
33735 <TITLE>FEATURE: <!--#echo var="FEAT_quell-folder-internal-msg"--></TITLE>
33736 </HEAD>
33737 <BODY>
33738 <H1>FEATURE: <!--#echo var="FEAT_quell-folder-internal-msg"--></H1>
33739
33740 This feature determines whether or not Alpine will create
33741 &quot;pseudo messages&quot; in folders that are in standard Unix or
33742 MMDF format. <P>
33743
33744 Alpine will normally create these pseudo messages when they are not already
33745 present in a standard Unix or MMDF folder.  Their purpose is to record
33746 certain mailbox state data needed for correct IMAP and POP server
33747 operation, and also for Alpine to be able to mark messages as Answered when
33748 the Reply has been postponed.<P>
33749
33750 Sites that do not use IMAP/POP for remote mail access, and that need to
33751 support mail tools that are adversely affected by the presence of the
33752 pseudo-messages (e.g. some mail notification tools) may enable this
33753 feature to tell Alpine not to create them.  Note that Alpine's
33754 &quot;Answered&quot; flag
33755 capability will be adversely affected if this is done.<P>
33756
33757 Note too that, even if this feature is enabled, Alpine will not remove
33758 pseudo-messages when it encounters them (e.g. those created by UW's imapd
33759 or ipopd servers.) This feature has no effect on folders that are not in
33760 standard Unix or MMDF format, as pseudo-messages are not needed in the
33761 other formats to record mailbox state information.
33762 <P><UL>
33763 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33764 </UL>
33765 <P>
33766 &lt;End of help on this topic&gt;
33767 </BODY>
33768 </HTML>
33769 ====== h_config_mulnews_as_typed ======
33770 <HTML>
33771 <HEAD>
33772 <TITLE>FEATURE: <!--#echo var="FEAT_mult-newsrc-hostnames-as-typed"--></TITLE>
33773 </HEAD>
33774 <BODY>
33775 <H1>FEATURE: <!--#echo var="FEAT_mult-newsrc-hostnames-as-typed"--></H1>
33776
33777 This feature will be of little use to most users.
33778 It has no effect unless the feature
33779 <A HREF="h_config_enable_mulnewsrcs"><!--#echo var="FEAT_enable-multiple-newsrcs"--></A>
33780 is set.
33781
33782 When the <!--#echo var="FEAT_enable-multiple-newsrcs"--> feature is set
33783 then the setting of this feature may have an effect on the names of the
33784 newsrc files used.
33785 Normally, the name of the news server will be canonicalized before it is
33786 used in the newsrc file name.
33787 For example, if you type the news server name
33788
33789 <P>
33790 <CENTER><SAMP>servername</SAMP></CENTER>
33791 <P>
33792
33793 it is likely that the canonical name will be something like
33794
33795 <P>
33796 <CENTER><SAMP>servername.example.com</SAMP></CENTER>
33797 <P>
33798
33799 Or it may be the case that
33800
33801 <P>
33802 <CENTER><SAMP>servername.example.com</SAMP></CENTER>
33803 <P>
33804
33805 is really an alias (a DNS CNAME) for
33806
33807 <P>
33808 <CENTER><SAMP>othername.example.com</SAMP></CENTER>
33809 <P>
33810
33811 If this feature is not set, then the canonicalized names will be used.
33812 If this feature is set, then the name you typed in (or put in your
33813 configuration) will be used.
33814
33815 <P><UL>
33816 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33817 </UL>
33818 <P>
33819 &lt;End of help on this topic&gt;
33820 </BODY>
33821 </HTML>
33822 ====== h_config_quell_empty_dirs ======
33823 <HTML>
33824 <HEAD>
33825 <TITLE>FEATURE: <!--#echo var="FEAT_quell-empty-directories"--></TITLE>
33826 </HEAD>
33827 <BODY>
33828 <H1>FEATURE: <!--#echo var="FEAT_quell-empty-directories"--></H1>
33829
33830 This feature causes Alpine to remove from the display any directories
33831 that do not contain at least one file or directory.  This can be useful
33832 to prevent overly cluttered folder lists when a collection is stored on
33833 a server that treats all names as both a folder and a directory.
33834
33835 <P>
33836 Note, enabling this feature can cause surprising behavior!  For example,
33837 you can still use Add to create a directory, but unless you immediately
33838 enter that directory and create a folder, that newly created directory
33839 may not be displayed next time you enter the folder list.
33840
33841 <P>
33842 The description above is not quite correct.
33843 Only directories which potentially may hold messages are hidden if empty.
33844 That is, a directory which is really just a directory and is not selectable
33845 as a folder will not be hidden.
33846 Such directories can occur on servers that treat most names as both a folder
33847 and a directory.
33848 These directories are typically created implicitly when a folder is created
33849 inside a directory that does not yet exist.
33850
33851 <P>
33852 <UL>
33853 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33854 </UL><P>
33855 &lt;End of help on this topic&gt;
33856 </BODY>
33857 </HTML>
33858 ====== h_config_termcap_wins =====
33859 <HTML>
33860 <HEAD>
33861 <TITLE>FEATURE: <!--#echo var="FEAT_termdef-takes-precedence"--></TITLE>
33862 </HEAD>
33863 <BODY>
33864 <H1>FEATURE: <!--#echo var="FEAT_termdef-takes-precedence"--></H1>
33865
33866 This feature may affect Alpine's low-level input routines.  Termcap (or
33867 terminfo, depending on how your copy of Alpine was compiled and linked)
33868 is the name of the database that describes terminal capabilities.  In
33869 particular, it describes the sequences of characters that various keys
33870 will emit.
33871
33872 <P>
33873 An example would be the Up Arrow key on the keyboard.  Up
33874 Arrow is not a distinct character on most Unix systems.  When you press
33875 the Up Arrow key a short sequence of characters are produced.  This
33876 sequence is supposed to be described in the termcap database by the
33877 &quot;ku&quot; capability (or by the &quot;kcuu1&quot; capability if you
33878 are using terminfo instead of termcap).
33879
33880 <P>
33881 By default, Alpine defines some terminal
33882 escape sequences that are commonly used.  For example, the sequence
33883 &quot;ESC&nbsp;O&nbsp;A&quot; is recognized as an Up Arrow key.  The sequence
33884 &quot;ESC&nbsp;[&nbsp;A&quot;
33885 is also recognized as an Up Arrow key.  These are chosen because common
33886 terminals like VT100's or ANSI standard terminals produce these
33887 sequences when you press the Up Arrow key.
33888
33889 <P>
33890 If your system's termcap
33891 (terminfo) database assigns some other function to the sequence
33892 &quot;ESC&nbsp;O&nbsp;A&quot;
33893 it is usually ignored by Alpine.  Also, if your termcap (terminfo)
33894 database assigns a sequence that doesn't begin with an escape
33895 character (<SAMP>ESC</SAMP>) it is usually ignored by Alpine.
33896 This usually works fine
33897 because most terminals emit the escape sequences that Alpine has defined
33898 by default.  We have also found that it is usually better to have these
33899 defaults take precedence over the definitions contained in the database
33900 because the defaults are more likely to be correct than the database.
33901
33902 <P>
33903 There are some terminals where this breaks down.  If you want Alpine to
33904 believe the definitions given in your termcap (terminfo) database in
33905 preference to the defaults the Alpine itself sets up, then you may turn
33906 this feature on.  Then, sequences of characters that are defined in
33907 both termcap (terminfo) and in Alpine's set of defaults will be
33908 interpreted the way that termcap (terminfo) says they should be
33909 interpreted.  Also, if your terminal capabilities database assigns a
33910 sequence that doesn't begin with escape, it will not be ignored.
33911
33912 <P>
33913 <UL>
33914 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33915 </UL><P>
33916 &lt;End of help on this topic&gt;
33917 </BODY>
33918 </HTML>
33919 ====== h_config_cruise_mode =====
33920 <HTML>
33921 <HEAD>
33922 <TITLE>FEATURE: <!--#echo var="FEAT_enable-cruise-mode"--></TITLE>
33923 </HEAD>
33924 <BODY>
33925 <H1>FEATURE: <!--#echo var="FEAT_enable-cruise-mode"--></H1>
33926
33927 This feature affects Alpine's behavior when you hit the
33928 &quot;Space&nbsp;Bar&quot; at
33929 the end of a displayed message.  Typically, Alpine complains that the end
33930 of the text has already been reached.  Setting this feature causes such
33931 keystrokes to be interpreted as if the &quot;Tab&quot; key had been hit, thus
33932 taking you to the next &quot;interesting&quot; message,
33933 or scanning ahead to the
33934 next incoming folder with &quot;interesting&quot; messages.
33935
33936 <P>
33937 <UL>
33938 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33939 </UL><P>
33940 &lt;End of help on this topic&gt;
33941 </BODY>
33942 </HTML>
33943 ====== h_config_cruise_mode_delete =====
33944 <HTML>
33945 <HEAD>
33946 <TITLE>FEATURE: <!--#echo var="FEAT_enable-cruise-mode-delete"--></TITLE>
33947 </HEAD>
33948 <BODY>
33949 <H1>FEATURE: <!--#echo var="FEAT_enable-cruise-mode-delete"--></H1>
33950
33951 This feature modifies the behavior of Alpine's
33952 <A HREF="h_config_cruise_mode">&quot;<!--#echo var="FEAT_enable-cruise-mode"-->&quot;</A> feature.
33953 Setting this feature causes Alpine to implicitly delete read
33954 messages when it moves on to display the next &quot;interesting&quot; message.
33955 <P>
33956 NOTE: Beware when enabling this feature AND the
33957 <A HREF="h_config_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm"-->&quot;</A>
33958 feature.
33959 <P>
33960 <UL>
33961 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33962 </UL><P>
33963 &lt;End of help on this topic&gt;
33964 </BODY>
33965 </HTML>
33966 ====== h_config_slash_coll_entire =====
33967 <HTML>
33968 <HEAD>
33969 <TITLE>FEATURE: <!--#echo var="FEAT_slash-collapses-entire-thread"--></TITLE>
33970 </HEAD>
33971 <BODY>
33972 <H1>FEATURE: <!--#echo var="FEAT_slash-collapses-entire-thread"--></H1>
33973
33974 The slash (/) command is available from the MESSAGE INDEX screen when
33975 the folder is sorted by either Threads or OrderedSubject, and the
33976 <A HREF="h_config_thread_disp_style"><!--#echo var="VAR_threading-display-style"--></A>
33977 is set to something other than &quot;none&quot;.
33978 Normally, the slash command Collapses or Expands the subthread that
33979 starts at the currently highlighted message, if any.
33980 If this option is set, then the slash command Collapses or Expands the
33981 <EM>entire</EM> current thread instead of just the subthread.
33982 The current thread is simply the top-level thread that contains the
33983 current message.
33984
33985 <P>
33986 <UL>
33987 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33988 </UL><P>
33989 &lt;End of help on this topic&gt;
33990 </BODY>
33991 </HTML>
33992 ====== h_config_color_thrd_import =====
33993 <HTML>
33994 <HEAD>
33995 <TITLE>FEATURE: <!--#echo var="FEAT_thread-index-shows-important-color"--></TITLE>
33996 </HEAD>
33997 <BODY>
33998 <H1>FEATURE: <!--#echo var="FEAT_thread-index-shows-important-color"--></H1>
33999
34000 This option affects only the THREAD INDEX screen.
34001 Whether or not you ever see a THREAD INDEX screen depends on the setting
34002 of the configuration option
34003 <A HREF="h_config_thread_index_style">&quot;<!--#echo var="VAR_threading-index-style"-->&quot;</A>
34004 and on the sort order of the index.
34005
34006 <P>
34007 If a message within a thread is flagged as Important
34008 and this option is set, then
34009 the entire line in the THREAD INDEX will be colored the color of the
34010 Index-important Symbol, which can be set using the
34011 <A HREF="h_color_setup">Setup Kolor</A> screen.
34012
34013 <P>
34014 <UL>
34015 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34016 </UL><P>
34017 &lt;End of help on this topic&gt;
34018 </BODY>
34019 </HTML>
34020 ====== h_config_allow_goto =====
34021 <HTML>
34022 <HEAD>
34023 <TITLE>FEATURE: <!--#echo var="FEAT_enable-goto-in-file-browser"--></TITLE>
34024 </HEAD>
34025 <BODY>
34026 <H1>FEATURE: <!--#echo var="FEAT_enable-goto-in-file-browser"--></H1>
34027
34028 This feature modifies the behavior of Alpine's file browser.  Setting this
34029 feature causes Alpine to offer the "G Goto" command in the file browser.
34030 That is the default.
34031
34032 <P>
34033
34034 The Goto command allows you to explicitly type in the desired directory.
34035 <P>
34036 &lt;End of help on this topic&gt;
34037 </BODY></HTML>
34038 ====== h_config_add_ldap =====
34039 <HTML>
34040 <HEAD>
34041 <TITLE>FEATURE: <!--#echo var="FEAT_ldap-result-to-addrbook-add"--></TITLE>
34042 </HEAD>
34043 <BODY>
34044 <H1>FEATURE: <!--#echo var="FEAT_ldap-result-to-addrbook-add"--></H1>
34045
34046 If both the Directory option
34047 <A HREF="h_config_ldap_opts_impl">&quot;Use-Implicitly-From-Composer&quot;</A>
34048 and this feature are set,
34049 then when an implicit directory lookup is done from the
34050 composer you will automatically be prompted to add the result of the
34051 directory lookup to your address book.
34052 <P>
34053 <UL>
34054 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34055 </UL><P>
34056 &lt;End of help on this topic&gt;
34057 </BODY>
34058 </HTML>
34059 ===== h_patterns_compat_behavior =====
34060 <HTML>
34061 <HEAD>
34062 <TITLE>Rules Behavior Changes in Pine 4.50</TITLE>
34063 </HEAD>
34064 <BODY>
34065 <H1>Rules Behavior Changes in Pine 4.50</H1>
34066
34067 In Alpine, Rules that contain unrecognized elements
34068 are ignored.
34069 In most cases, the unrecognized elements will be something that was
34070 added as a new Rules feature in a later version of Alpine.
34071 In versions of Pine <EM>prior</EM> to 4.50, Pine did <EM>not</EM>
34072 ignore rules that contained unrecognized elements.
34073 For example, a new element of Rules that was added in Pine 4.50 is
34074 Age interval.
34075 Suppose you add an Indexcolor rule, using version Pine 4.50 or later, that colors
34076 all messages older than a week red.
34077 Now, if you run Pine 4.44 using that same configuration file, it will not
34078 recognize the Age interval and so will just ignore it.
34079 That means that all messages will match that rule so all messages will
34080 be colored red when using Pine version 4.44.
34081
34082 <P>
34083 This behavior was considered a bug so it is fixed in Alpine and Pine 4.50 and later.
34084 However, since the behavior still exists in versions prior to Pine 4.50 and
34085 since Filtering is a potentially destructive operation, another measure
34086 was taken to attempt to avoid unintentional Filtering of messages.
34087 The first time that you run Alpine or a Pine that is version 4.50 or greater,
34088 the rules in your Filters configuration variable (&quot;Patterns-Filters&quot;)
34089 will be copied to a new Filters configuration variable
34090 with a different name (&quot;Patterns-Filters2&quot;).
34091 From then on, Alpine will continue to use the new
34092 variable.
34093 Of course, Pine version 4.44 or lower will continue to use the old
34094 variable.
34095 That means that if you are using Alpine
34096 and also using a version of Pine that is older than 4.50, they will not
34097 share the configuration information about Filters.
34098 If you make a change in one version you won't see it in the other version.
34099
34100 <P>
34101 Since Scoring can be used to trigger Filtering, the same thing has been
34102 done for Score rules.
34103 The old configuration variable name is (&quot;Patterns-Scores&quot;)
34104 and the new name is (&quot;Patterns-Scores2&quot;).
34105 The same is not true of Role, Indexcolor, and Other rules that are
34106 thought to be less harmful when a mistake is made.
34107
34108 <P>
34109 &lt;End of help on this topic&gt;
34110 </BODY>
34111 </HTML>
34112 ======= h_config_filt_opts_sentdate =======
34113 <HTML>
34114 <HEAD>
34115 <TITLE>PATTERN FEATURE: Use-Date-Header-For-Age</TITLE>
34116 </HEAD>
34117 <BODY>
34118 <H1>PATTERN FEATURE: Use-Date-Header-For-Age</H1>
34119
34120 By default, the Age interval of a Pattern uses a message's time of
34121 arrival to compute the age of the message.
34122 If this feature is set, the date in the message's Date header will
34123 be used instead.
34124 <P>
34125 &lt;End of help on this topic&gt;
34126 </BODY>
34127 </HTML>
34128 ======= h_config_filt_opts_notdel =======
34129 <HTML>
34130 <HEAD>
34131 <TITLE>FILTER FEATURE: Move-Only-if-Not-Deleted</TITLE>
34132 </HEAD>
34133 <BODY>
34134 <H1>FILTER FEATURE: Move-Only-if-Not-Deleted</H1>
34135
34136 If this option is set then a message will be moved into the
34137 specified folder only if it is not marked for deletion.
34138 This is useful if you have multiple Alpine sessions running
34139 simultaneously and you don't want messages to be filtered into a
34140 folder more than once.
34141 It is also useful if you want to filter
34142 only the &quot;undeleted&quot; messages in a newsgroup into a folder.
34143 This method is not foolproof.
34144 There may be cases where a message
34145 gets marked deleted and so it is never filtered into the folder.
34146 For example, if you deleted it in another Alpine session or another mail
34147 program that didn't use the filtering rule.
34148 <P>
34149 This option has no effect if the Filter Action is not set to Move.
34150 <P>
34151 &lt;End of help on this topic&gt;
34152 </BODY>
34153 </HTML>
34154 ======= h_config_filt_opts_nonterm =======
34155 <HTML>
34156 <HEAD>
34157 <TITLE>FILTER FEATURE: Dont-Stop-Even-if-Rule-Matches</TITLE>
34158 </HEAD>
34159 <BODY>
34160 <H1>FILTER FEATURE: Dont-Stop-Even-if-Rule-Matches</H1>
34161
34162 If this option is set then this is a non-terminating rule.
34163 Usually, for each message, Alpine searches through the Filter Rules until
34164 a match is found and then it performs the action associated with that rule.
34165 Rules following the match are not considered.
34166 If this option is set then the search for matches will continue at the next
34167 rule.
34168 <P>
34169 If a non-terminating rule matches then the actions associated with
34170 that rule, except for any implied deletion of the message, are performed
34171 before the match for the next rule is checked.
34172 For example, if the non-terminating rule sets the Important status, then that
34173 status will be set when the next rule is considered.
34174 However, if the non-terminating rule Moves the message, the message will
34175 actually be copied instead of copied and deleted so that it is still there
34176 for the next rule.
34177 A moved message is deleted after all the relevant rules have been checked.
34178 The name of the &quot;Move&quot; action is confusing in this case because
34179 a single message can be moved to more than one folder.
34180 It turns the Move into a Copy instead, but it is still followed by a deletion
34181 at the end.
34182 <P>
34183 This option may be useful if you want to have a single message filtered to
34184 two different folders because it matches two different Patterns.
34185 For example, suppose you normally filter messages to a particular mailing
34186 list into one folder, and messages addressed directly to you into a second
34187 folder.
34188 If a message is sent to both you and the list (and you can tell that by
34189 looking at the headers of the message) this option may give you a convenient
34190 way to capture a copy to each folder.
34191 (It may also cause you to capture two copies to each folder,
34192 depending on whether your mail system delivers one or two copies of the
34193 message to you and on how the list works.)
34194 <P>
34195 &lt;End of help on this topic&gt;
34196 </BODY>
34197 </HTML>
34198 ===== h_mainhelp_smime ======
34199 <HTML>
34200 <HEAD>
34201 <TITLE>S/MIME Overview</TITLE>
34202 </HEAD>
34203 <BODY>
34204 <H1>S/MIME Overview</H1>
34205
34206 S/MIME is a standard for the public key encryption and signing of email.
34207 UNIX Alpine contains a basic implementation of S/MIME based on
34208 the <A HREF="http://www.openssl.org/">OpenSSL</A> libraries.
34209 To check if this version of Alpine supports S/MIME look at
34210 <A HREF="X-Alpine-Config:">Supported Options in this Alpine</A> and look
34211 for &quot;S/MIME&quot; under the &quot;Encryption&quot; heading.
34212 <P>
34213 Some limitations:
34214 <UL>
34215    <LI> There is no PC-Alpine implementation.
34216    <LI> There is no provision for checking for CRLs
34217         (Certificate Revocation Lists) in Alpine.
34218    <LI> This built-in S/MIME implementation is not compatible with and does not help with PGP.
34219    <LI> There is no mechanism available for feeding either an entire incoming
34220         or an entire outgoing message to an external
34221         filter and using that external filter to do S/MIME or PGP processing.
34222    <LI> Because the implementation currently uses OpenSSL, there is only a very
34223         limited integration with the Mac OS Keychain (the storing and access of
34224         public certificates).
34225 </UL>
34226 <P>
34227 The S/MIME configuration screen is reached by going to the Main Menu and typing
34228 the &quot;S&nbsp;Setup&quot; command followed by &quot;M&nbsp;S/MIME&quot;.
34229 <P>
34230
34231 <H2>S/MIME BASICS</H2>
34232
34233 In order to digitally sign messages you send you must have a public/private key-pair.
34234 This may be obtained from a public Certificate Authority (CA) such as Thawte, Verisign, Comodo,
34235 or GoDaddy; or from a smaller CA such as a university which provides certificates for its
34236 users or a company which provides certificates for its workers.
34237 These certificates are bound to an email address, so the identity being verified is the
34238 email address not a person's name.
34239 <P>
34240 Mail is signed by using the sender's private key, which only the owner of the private key
34241 has access to.
34242 The signature is verified using the signer's public key, which anyone can
34243 have access to.
34244 With Alpine, the first time you receive a signed message the public key of the
34245 sender will be stored for future use.
34246
34247 <P>
34248 Mail is encrypted using the recipient's public key and decrypted by
34249 the recipient with their private key.
34250
34251 <P>
34252 You need a key of your own in order to sign outgoing messages and to have others
34253 encrypt messages sent to you.
34254 You do not need a key of your own to verify signed messages sent by others or to
34255 encrypt messages sent to others.
34256
34257 <H2>ALPINE S/MIME CERTIFICATE STORAGE</H2>
34258
34259 By default UNIX Alpine stores the certificates it uses in a directory in your
34260 home directory.
34261 The directory name is
34262 <P>
34263 <CENTER><SAMP>.alpine-smime</SAMP></CENTER>
34264 <P>
34265 Within that directory are three subdirectories.
34266 Each of the three subdirectories contains files with PEM-encoded contents,
34267 the default format for OpenSSL.
34268 The &quot;<SAMP>public</SAMP>&quot; directory contains public certificates.
34269 The files within that directory have names that are email addresses with the
34270 suffix &quot;<SAMP>.crt</SAMP>&quot; appended.
34271 An example filename is
34272 <P>
34273 <CENTER><SAMP>user@example.com.crt</SAMP></CENTER>
34274 <P>
34275 The &quot;<SAMP>private</SAMP>&quot; directory contains private keys, probably just one for
34276 your private key.
34277 These are also email addresses but with the suffix &quot;<SAMP>.key</SAMP>&quot; instead.
34278 The third directory is &quot;<SAMP>ca</SAMP>&quot; and it contains certificates for any Certificate
34279 Authorities that you want to trust but that aren't contained in the set of system CAs.
34280 Those files may have arbitrary names as long as they end with the
34281 suffix &quot;<SAMP>.crt</SAMP>&quot;.
34282
34283 <H2>HOW TO SIGN AND ENCRYPT</H2>
34284
34285 If you have a certificate you may sign outgoing messages.
34286 After typing the Ctrl-X command to send a message you will see the prompt
34287 <P>
34288 <CENTER><SAMP>Send message?</SAMP></CENTER>
34289 <P>
34290 Available subcommands include &quot;G&nbsp;Sign&quot; and &quot;E&nbsp;Encrypt&quot;.
34291 Typing the &quot;G&quot; command will change the prompt to
34292 <P>
34293 <CENTER><SAMP>Send message (Signed)?</SAMP></CENTER>
34294 <P>
34295 Typing the &quot;E&quot; command will change the prompt to
34296 <P>
34297 <CENTER><SAMP>Send message (Encrypted)?</SAMP></CENTER>
34298 <P>
34299 You may even type both to get
34300 <P>
34301 <CENTER><SAMP>Send message (Encrypted, Signed)?</SAMP></CENTER>
34302 <P>
34303
34304 <H2>HOW TO READ SIGNED OR ENCRYPTED MESSAGES</H2>
34305
34306 The reading of a signed message should not require any special action on
34307 your part.
34308 There should be an editorial addition at the start of the message which
34309 says either
34310 <P>
34311 <CENTER><SAMP>This message was cryptographically signed.</SAMP></CENTER>
34312 <P>
34313 or
34314 <P>
34315 <CENTER><SAMP>This message was cryptographically signed but the signature could not be verified.</SAMP></CENTER>
34316 <P>
34317 If an encrypted message is sent to you the encrypted text will not
34318 be shown.
34319 You will have to type the &quot;Ctrl-D&nbsp;Decrypt&quot; command (from the screen where
34320 you are viewing the message) and supply your passphrase when asked.
34321 <P>
34322 For a signed or encrypted message there is also a &quot;Ctrl-E&nbsp;Security&quot; command
34323 which gives you some information about the certificate used to sign or encrypt the message.
34324
34325 <H2>MISCELLANEOUS</H2>
34326
34327 If you have access to a private certificate in the PKCS12 format, which
34328 would sometimes be in a file with a &quot;.p12&quot; extension, then you can
34329 use the following commands to generate private keys, public and certificate
34330 authorities certificates. In the examples below, we assume that the
34331 certificate in the p12 format is called &quot;certificate.p12&quot;, and
34332 that your email address is &quot;your@address.com&quot;.
34333
34334 <P>
34335 In order to create a private key use the command
34336 <P>
34337 <CENTER><SAMP>openssl pkcs12 -in certificate.p12 -out your@address.com.key</SAMP></CENTER>
34338 <P>
34339 In order to create a public certificate use the command
34340 <P>
34341 <CENTER><SAMP>
34342 openssl pkcs12 -in certificate.p12 -clcerts -nokeys -out your@address.com.crt
34343 </SAMP></CENTER>
34344 <P>
34345 In order to create a certificate authority certificate use the command
34346 <P>
34347 <CENTER><SAMP>
34348 openssl pkcs12 -in certificate.p12 -cacerts -nokeys -out certificate-ca.crt
34349 </SAMP></CENTER>
34350
34351 <P> If the previous command produces an empty file, it means that the
34352 certificate authority was not included in the .p12 file, so you will have
34353 to get it from some other sources. You will need these certificates, so
34354 that you can validate correctly signatures.
34355
34356 <P>
34357 After you have exported these certificates and keys, you can  use the import
34358 command in Alpine, from the S/MIME configuration screen,
34359 to import these certificates into Alpine. They will be available for use
34360 as soon as you import them.
34361 <P>
34362 &lt;End of help on this topic&gt;
34363 </BODY>
34364 </HTML>
34365 ====== h_config_smime_pubcertdir =====
34366 <HTML>
34367 <HEAD>
34368 <TITLE>S/MIME OPTION: <!--#echo var="VAR_smime-public-cert-directory"--></TITLE>
34369 </HEAD>
34370 <BODY>
34371 <H1>S/MIME OPTION: <!--#echo var="VAR_smime-public-cert-directory"--></H1>
34372
34373 UNIX Alpine only.
34374 <P>
34375 If the option
34376 <A HREF="h_config_smime_pubcertcon"><!--#echo var="VAR_smime-public-cert-container"--></A>
34377 is set then this option will have no effect.
34378 <P>
34379 Normally, Public Certificates for use with S/MIME will be stored in the directory
34380 which is the value of this option.
34381 Those certificates will be stored in PEM format, one certificate per file.
34382 The name of the file for the certificate corresponding to
34383 <P>
34384 <CENTER><SAMP>emailaddress</SAMP></CENTER>
34385 <P>
34386 should be
34387 <P>
34388 <CENTER><SAMP>emailaddress.crt</SAMP></CENTER>
34389 <P>
34390 For example, a file for user@example.com would be in the file
34391 <P>
34392 <CENTER><SAMP>user@example.com.crt</SAMP></CENTER>
34393 <P>
34394 in this directory.
34395 <P>
34396 Use the Setup/SMIME screen to modify this variable.
34397 <P>
34398 Typically, the public certificates that you have will come from S/MIME signed
34399 messages that are sent to you.
34400 Alpine will extract the public certificate from the signed message and store
34401 it in the certificates directory.
34402 These PEM format public certificates look something like:
34403 <PRE>
34404 -----BEGIN CERTIFICATE-----
34405 MIIFvTCCBKWgAwIBAgIQD4fYFHVI8T20yN4nus097DANBgkqhkiG9w0BAQUFADCB
34406 rjELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAlVUMRcwFQYDVQQHEw5TYWx0IExha2Ug
34407 Q2l0eTEeMBwGA1UEChMVVGhlIFVTRVJUUlVTVCBOZXR3b3JrMSEwHwYDVQQLExho
34408 ...
34409 2b9KGqDyMWW/rjNnmpjzjT2ObGM7lRA8lke4FLOLajhrz4ogO3b4DFfAAM1VSZH8
34410 D6sOwOLJZkLY8FRsfk63K+2EMzA2+qAzMKupgeTLqXIf
34411 -----END CERTIFICATE-----
34412 </PRE>
34413 <P>
34414 <UL>
34415 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
34416 </UL><P>
34417 <P>
34418 <UL>
34419 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34420 </UL><P>
34421 &lt;End of help on this topic&gt;
34422 </BODY>
34423 </HTML>
34424 ====== h_config_smime_pubcertcon =====
34425 <HTML>
34426 <HEAD>
34427 <TITLE>OPTION: <!--#echo var="VAR_smime-public-cert-container"--></TITLE>
34428 </HEAD>
34429 <BODY>
34430 <H1>OPTION: <!--#echo var="VAR_smime-public-cert-container"--></H1>
34431
34432 UNIX Alpine only.
34433 <P>
34434 If this option is set it will be used instead of
34435 <A HREF="h_config_smime_pubcertdir"><!--#echo var="VAR_smime-public-cert-directory"--></A>.
34436 <P>
34437 This option gives you a way to store certificates remotely on an IMAP server
34438 instead of storing the certificates one per file locally.
34439 In order to do that you just give this option a remote folder name for a folder
34440 which does not yet exist.
34441 The name is similar to the name you might use for a remote configuration file.
34442 A remote folder name might look something like:
34443 <P>
34444 <CENTER><SAMP>{myimaphost.myschool.k12.wa.us}mail/publiccerts</SAMP></CENTER>
34445 <P>
34446 See
34447 <A HREF="h_valid_folder_names">Valid Folder Names</A> for more information
34448 about the syntax of folder names.
34449 <P>
34450 Use the Setup/SMIME screen to modify this variable.
34451 <P>
34452 <UL>
34453 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
34454 </UL><P>
34455 <P>
34456 <UL>
34457 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34458 </UL><P>
34459 &lt;End of help on this topic&gt;
34460 </BODY>
34461 </HTML>
34462 ====== h_config_smime_privkeydir =====
34463 <HTML>
34464 <HEAD>
34465 <TITLE>OPTION: <!--#echo var="VAR_smime-private-key-directory"--></TITLE>
34466 </HEAD>
34467 <BODY>
34468 <H1>OPTION: <!--#echo var="VAR_smime-private-key-directory"--></H1>
34469
34470 UNIX Alpine only.
34471 <P>
34472 In order to sign outgoing S/MIME messages you will need a
34473 personal digital ID certificate.
34474 You will usually get such a certificate from a certificate authority such as
34475 Thawte or CAcert.
34476 (In order to encrypt outgoing messages you don't need a personal digital ID, you
34477 need the public certificate of the recipient instead.)
34478 If the option
34479 <A HREF="h_config_smime_privkeycon"><!--#echo var="VAR_smime-private-key-container"--></A>
34480 is set then this option will have no effect.
34481 <P>
34482 Normally, Private Keys for use with S/MIME will be stored in the directory
34483 which is the value of this option.
34484 Those certificates will be stored in PEM format, one certificate per file.
34485 The name of the file for the certificate corresponding to your
34486 <P>
34487 <CENTER><SAMP>emailaddress</SAMP></CENTER>
34488 <P>
34489 should be
34490 <P>
34491 <CENTER><SAMP>emailaddress.key</SAMP></CENTER>
34492 <P>
34493 For example, if your address is user@example.com the name of the file would be
34494 <P>
34495 <CENTER><SAMP>user@example.com.key</SAMP></CENTER>
34496 <P>
34497 in this directory.
34498 <P>
34499 Use the Setup/SMIME screen to modify this variable.
34500 <P>
34501 Typically, the private key that you have will come from a Certificate
34502 Authority.
34503 The private key should be stored in a PEM format file that
34504 looks something like:
34505 <PRE>
34506 -----BEGIN RSA PRIVATE KEY-----
34507 Proc-Type: 4,ENCRYPTED
34508 DEK-Info: DES-EDE3-CBC,2CBD328FD84CF5C6
34509
34510 YBEXYLgLU9NJoc1V+vJ6UvcF08RX54S6jXsmgL0b5HGkudG6fhnmHkH7+UCvM5NI
34511 SXO/F8iuZDfs1VGG0NyitkFZ0Zn2vfaGovBvm15gx24b2xnZDLRB7/bNZkurnK5k
34512 VjAjZ2xXn2hFp2GJwqRdmxYNqsKGu52B99oti5HUWuZ2GFRaWjn5hYOqeApZE2uA
34513 ...
34514 oSRqfI51UdSRt0tmGhHeTvybUVrHm9eKft8TTGf+qSBqzSc55CsmoVbRzw4Nfhix
34515 m+4TJybNGNfAgOctSkEyY/OCb49fRRQTCBZVIhzLGGmpYmkO55HbIA==
34516 -----END RSA PRIVATE KEY-----
34517 </PRE>
34518 <P>
34519 <UL>
34520 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
34521 </UL><P>
34522 <P>
34523 <UL>
34524 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34525 </UL><P>
34526 &lt;End of help on this topic&gt;
34527 </BODY>
34528 </HTML>
34529 ====== h_config_smime_privkeycon =====
34530 <HTML>
34531 <HEAD>
34532 <TITLE>OPTION: <!--#echo var="VAR_smime-private-key-container"--></TITLE>
34533 </HEAD>
34534 <BODY>
34535 <H1>OPTION: <!--#echo var="VAR_smime-private-key-container"--></H1>
34536
34537 UNIX Alpine only.
34538 <P>
34539 If this option is set it will be used instead of
34540 <A HREF="h_config_smime_privkeydir"><!--#echo var="VAR_smime-private-key-directory"--></A>.
34541 <P>
34542 This option gives you a way to store keys remotely on an IMAP server
34543 instead of storing the keys one per file locally.
34544 In order to do that you just give this option a remote folder name for a folder
34545 which does not yet exist.
34546 The name is similar to the name you might use for a remote configuration file.
34547 A remote folder name might look something like:
34548 <P>
34549 <CENTER><SAMP>{myimaphost.myschool.k12.wa.us}mail/privatekeys</SAMP></CENTER>
34550 <P>
34551 See
34552 <A HREF="h_valid_folder_names">Valid Folder Names</A> for more information
34553 about the syntax of folder names.
34554 <P>
34555 Use the Setup/SMIME screen to modify this variable.
34556 <P>
34557 <UL>
34558 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
34559 </UL><P>
34560 <P>
34561 <UL>
34562 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34563 </UL><P>
34564 &lt;End of help on this topic&gt;
34565 </BODY>
34566 </HTML>
34567 ====== h_config_smime_cacertdir =====
34568 <HTML>
34569 <HEAD>
34570 <TITLE>S/MIME OPTION: <!--#echo var="VAR_smime-cacert-directory"--></TITLE>
34571 </HEAD>
34572 <BODY>
34573 <H1>S/MIME OPTION: <!--#echo var="VAR_smime-cacert-directory"--></H1>
34574
34575 UNIX Alpine only.
34576 <P>
34577 If the option
34578 <A HREF="h_config_smime_cacertcon"><!--#echo var="VAR_smime-cacert-container"--></A>
34579 is set then this option will have no effect.
34580 <P>
34581 CACert is a shorthand name for certification authority certificate.
34582 Normally Alpine will use the CACerts that are located in the standard system
34583 location for CACerts.
34584 It may be the case that one of your correspondents has a Digital ID which has
34585 been signed by a certificate authority that is not in the regular set of system certificate
34586 authorities.
34587 You may supplement the system list by adding further certificates of your own.
34588 These should  be stored in the directory
34589 which is the value of this option.
34590 The certificates will be stored in PEM format, one certificate per file.
34591 The names of the files can be anything ending in &quot;.crt&quot;.
34592 <P>
34593 Use the Setup/SMIME screen to modify this variable.
34594 <P>
34595 These PEM format CA certificates look very similar to your public
34596 certificates for particular email addresses
34597 (<A HREF="h_config_smime_pubcertdir"><!--#echo var="VAR_smime-public-cert-directory"--></A>).
34598 <P>
34599 <UL>
34600 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
34601 </UL><P>
34602 <P>
34603 <UL>
34604 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34605 </UL><P>
34606 &lt;End of help on this topic&gt;
34607 </BODY>
34608 </HTML>
34609 ====== h_config_smime_cacertcon =====
34610 <HTML>
34611 <HEAD>
34612 <TITLE>S/MIME OPTION: <!--#echo var="VAR_smime-cacert-container"--></TITLE>
34613 </HEAD>
34614 <BODY>
34615 <H1>S/MIME OPTION: <!--#echo var="VAR_smime-cacert-container"--></H1>
34616
34617 UNIX Alpine only.
34618 <P>
34619 If this option is set it will be used instead of
34620 <A HREF="h_config_smime_cacertdir"><!--#echo var="VAR_smime-cacert-directory"--></A>.
34621 <P>
34622 This option gives you a way to store certificates remotely on an IMAP server
34623 instead of storing the certificates one per file locally.
34624 In order to do that you just give this option a remote folder name for a folder
34625 which does not yet exist.
34626 The name is similar to the name you might use for a remote configuration file.
34627 A remote folder name might look something like:
34628 <P>
34629 <CENTER><SAMP>{myimaphost.myschool.k12.wa.us}mail/cacerts</SAMP></CENTER>
34630 <P>
34631 See
34632 <A HREF="h_valid_folder_names">Valid Folder Names</A> for more information
34633 about the syntax of folder names.
34634 <P>
34635 Use the Setup/SMIME screen to modify this variable.
34636 <P>
34637 <UL>
34638 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
34639 </UL><P>
34640 <P>
34641 <UL>
34642 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34643 </UL><P>
34644 &lt;End of help on this topic&gt;
34645 </BODY>
34646 </HTML>
34647 ========== h_config_smime_sign_by_default ==========
34648 <HTML>
34649 <HEAD>
34650 <TITLE>S/MIME FEATURE: <!--#echo var="FEAT_smime-sign-by-default"--></TITLE>
34651 </HEAD>
34652 <BODY>
34653 <H1>S/MIME FEATURE: <!--#echo var="FEAT_smime-sign-by-default"--></H1>
34654
34655 UNIX Alpine only.
34656 <P>
34657 This feature only has an effect if your version of Alpine includes
34658 support for S/MIME.
34659 It affects Alpine's behavior when you send a message.
34660 If this option is set, the &quot;Sign&quot; option will default to ON when sending messages.
34661 <P>
34662 Only the default value is affected.
34663 In any case, you may still toggle the Signing option on or off before sending
34664 with the &quot;G Sign&quot; command (provided you have a personal digital ID
34665 certificate).
34666 <P>
34667 <UL>
34668 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
34669 </UL><P>
34670 <P>
34671
34672 <UL>
34673 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34674 </UL><P>
34675 &lt;End of help on this topic&gt;
34676 </BODY>
34677 </HTML>
34678 ========== h_config_smime_use_cert_store ==========
34679 <HTML>
34680 <HEAD>
34681 <TITLE>S/MIME FEATURE: <!--#echo var="FEAT_smime-use-store-only"--></TITLE>
34682 </HEAD>
34683 <BODY>
34684 <H1>S/MIME FEATURE: <!--#echo var="FEAT_smime-use-store-only"--></H1>
34685
34686 UNIX Alpine only.
34687 <P>
34688 This feature only has an effect if your version of Alpine includes
34689 support for S/MIME.
34690 It affects Alpine's behavior when you validate a message, and should
34691 not be disabled, unless you are performing a test.
34692 <P>
34693 There are two important aspects of validation: validation of the message
34694 (that is, the message was not modified after it was sent)
34695 as well as validation of the identity of the sender. This option has to
34696 do with the latter.
34697 <P>
34698 In order to validate that the message came from the sender in the message
34699 and not an impersonator, Alpine can
34700 either use the certificates that come in the message, or the ones that
34701 you have personally stored. If this feature is enabled (the default) then
34702 Alpine will use certificates that you have already saved in your store
34703 and not those that come in the message to validate the sender of the
34704 message. This behavior helps you prevent against impersonation, because
34705 it is assumed that you trust the certificates that you have saved, and
34706 might not trust those that came with the message that you are validating.
34707 <P>
34708 <UL>
34709 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
34710 </UL><P>
34711 <P>
34712
34713 <UL>
34714 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34715 </UL><P>
34716 &lt;End of help on this topic&gt;
34717 </BODY>
34718 </HTML>
34719 ========== h_config_smime_pubcerts_in_keychain ==========
34720 <HTML>
34721 <HEAD>
34722 <TITLE>S/MIME FEATURE: <!--#echo var="FEAT_publiccerts-in-keychain"--></TITLE>
34723 </HEAD>
34724 <BODY>
34725 <H1>S/MIME FEATURE: <!--#echo var="FEAT_publiccerts-in-keychain"--></H1>
34726
34727 UNIX Alpine only.
34728 <P>
34729 If this feature is set the Mac OS X default keychain will be used as the place
34730 to store public certificates instead of a
34731 <A HREF="h_config_smime_pubcertdir"><!--#echo var="VAR_smime-public-cert-directory"--></A>
34732 or a
34733 <A HREF="h_config_smime_pubcertcon"><!--#echo var="VAR_smime-public-cert-container"--></A>.
34734 <P>
34735 <UL>
34736 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
34737 </UL><P>
34738 <P>
34739 <UL>
34740 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34741 </UL><P>
34742 &lt;End of help on this topic&gt;
34743 </BODY>
34744 </HTML>
34745 ========== h_config_smime_dont_do_smime ==========
34746 <HTML>
34747 <HEAD>
34748 <TITLE>S/MIME FEATURE: <!--#echo var="FEAT_smime-dont-do-smime"--></TITLE>
34749 </HEAD>
34750 <BODY>
34751 <H1>S/MIME FEATURE: <!--#echo var="FEAT_smime-dont-do-smime"--></H1>
34752
34753 UNIX Alpine only.
34754 <P>
34755 Setting this feature turns off all of Alpine's S/MIME support.
34756 You might want to set this if you are having trouble due to the S/MIME support.
34757 <P>
34758 <UL>
34759 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
34760 </UL><P>
34761 <P>
34762
34763 <UL>
34764 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34765 </UL><P>
34766 &lt;End of help on this topic&gt;
34767 </BODY>
34768 </HTML>
34769 ========== h_config_smime_encrypt_by_default ==========
34770 <HTML>
34771 <HEAD>
34772 <TITLE>S/MIME FEATURE: <!--#echo var="FEAT_smime-encrypt-by-default"--></TITLE>
34773 </HEAD>
34774 <BODY>
34775 <H1>S/MIME FEATURE: <!--#echo var="FEAT_smime-encrypt-by-default"--></H1>
34776
34777 UNIX Alpine only.
34778 <P>
34779 This feature only has an effect if your version of Alpine includes
34780 support for S/MIME.
34781 It affects Alpine's behavior when you send a message.
34782 If this option is set, the &quot;Encrypt&quot; option will default to ON when sending messages.
34783 <P>
34784 Only the default value is affected.
34785 In any case, you may still toggle the Encrypt option on or off before sending
34786 with the &quot;E Encrypt&quot; command (provided you have a the public digital ID
34787 for the recipient).
34788 <P>
34789 <UL>
34790 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
34791 </UL><P>
34792 <P>
34793
34794 <UL>
34795 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34796 </UL><P>
34797 &lt;End of help on this topic&gt;
34798 </BODY>
34799 </HTML>
34800 ========== h_config_smime_remember_passphrase ==========
34801 <HTML>
34802 <HEAD>
34803 <TITLE>S/MIME FEATURE: <!--#echo var="FEAT_smime-remember-passphrase"--></TITLE>
34804 </HEAD>
34805 <BODY>
34806 <H1>S/MIME FEATURE: <!--#echo var="FEAT_smime-remember-passphrase"--></H1>
34807
34808 UNIX Alpine only.
34809 <P>
34810 This feature only has an effect if your version of Alpine includes
34811 support for S/MIME.
34812 If this option is set, you will only have to enter your passphrase for your private key
34813 once during an Alpine session.
34814 <P>
34815 <UL>
34816 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
34817 </UL><P>
34818 <P>
34819
34820 <UL>
34821 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34822 </UL><P>
34823 &lt;End of help on this topic&gt;
34824 </BODY>
34825 </HTML>
34826 ====== h_config_smime_transfer_pub_to_con =====
34827 <HTML>
34828 <HEAD>
34829 <TITLE>S/MIME: Transfer Public Certs to Container</TITLE>
34830 </HEAD>
34831 <BODY>
34832 <H1>S/MIME: Transfer Public Certs to Container</H1>
34833
34834 UNIX Alpine only.
34835 <P>
34836 The Transfer command will copy the public certificates in your configured
34837 <A HREF="h_config_smime_pubcertdir"><!--#echo var="VAR_smime-public-cert-directory"--></A>
34838 to the container in your configured
34839 <A HREF="h_config_smime_pubcertcon"><!--#echo var="VAR_smime-public-cert-container"--></A>.
34840 This might be useful if you decide to switch from using a cert directory to a cert
34841 container.
34842 <P>
34843 Warning: Any previous contents in the container will be lost.
34844 <P>
34845 <UL>
34846 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
34847 </UL><P>
34848 <P>
34849 <UL>
34850 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34851 </UL><P>
34852 &lt;End of help on this topic&gt;
34853 </BODY>
34854 </HTML>
34855 ====== h_config_smime_transfer_pub_to_dir =====
34856 <HTML>
34857 <HEAD>
34858 <TITLE>S/MIME: Transfer Public Certs to Directory</TITLE>
34859 </HEAD>
34860 <BODY>
34861 <H1>S/MIME: Transfer Public Certs to Directory</H1>
34862
34863 UNIX Alpine only.
34864 <P>
34865 The Transfer command will copy the public certificates in your configured
34866 <A HREF="h_config_smime_pubcertcon"><!--#echo var="VAR_smime-public-cert-container"--></A>
34867 to the directory in your configured
34868 <A HREF="h_config_smime_pubcertdir"><!--#echo var="VAR_smime-public-cert-directory"--></A>.
34869 This might be useful if you decide to switch from using a cert container to a cert
34870 directory.
34871 <P>
34872 <UL>
34873 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
34874 </UL><P>
34875 <P>
34876 <UL>
34877 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34878 </UL><P>
34879 &lt;End of help on this topic&gt;
34880 </BODY>
34881 </HTML>
34882 ====== h_config_smime_transfer_priv_to_con =====
34883 <HTML>
34884 <HEAD>
34885 <TITLE>S/MIME: Transfer Private Keys to Container</TITLE>
34886 </HEAD>
34887 <BODY>
34888 <H1>S/MIME: Transfer Private Keys to Container</H1>
34889
34890 UNIX Alpine only.
34891 <P>
34892 The Transfer command will copy the private keys in your configured
34893 <A HREF="h_config_smime_privkeydir"><!--#echo var="VAR_smime-private-key-directory"--></A>.
34894 to the container in your configured
34895 <A HREF="h_config_smime_privkeydir"><!--#echo var="VAR_smime-private-key-container"--></A>.
34896 This might be useful if you decide to switch from using a key directory to a key
34897 container.
34898 <P>
34899 Warning: Any previous contents in the container will be lost.
34900 <P>
34901 <UL>
34902 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
34903 </UL><P>
34904 <P>
34905 <UL>
34906 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34907 </UL><P>
34908 &lt;End of help on this topic&gt;
34909 </BODY>
34910 </HTML>
34911 ====== h_config_smime_transfer_priv_to_dir =====
34912 <HTML>
34913 <HEAD>
34914 <TITLE>S/MIME: Transfer Private Keys to Directory</TITLE>
34915 </HEAD>
34916 <BODY>
34917 <H1>S/MIME: Transfer Private Keys to Directory</H1>
34918
34919 UNIX Alpine only.
34920 <P>
34921 The Transfer command will copy the private keys in your configured
34922 <A HREF="h_config_smime_privkeydir"><!--#echo var="VAR_smime-private-key-container"--></A>.
34923 to the directory in your configured
34924 <A HREF="h_config_smime_privkeydir"><!--#echo var="VAR_smime-private-key-directory"--></A>.
34925 This might be useful if you decide to switch from using a key container to a key
34926 directory.
34927 <P>
34928 <UL>
34929 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
34930 </UL><P>
34931 <P>
34932 <UL>
34933 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34934 </UL><P>
34935 &lt;End of help on this topic&gt;
34936 </BODY>
34937 </HTML>
34938 ====== h_config_smime_transfer_cacert_to_con =====
34939 <HTML>
34940 <HEAD>
34941 <TITLE>S/MIME: Transfer CA Certs to Container</TITLE>
34942 </HEAD>
34943 <BODY>
34944 <H1>S/MIME: Transfer CA Certs to Container</H1>
34945
34946 UNIX Alpine only.
34947 <P>
34948 The Transfer command will copy the CA certificates in your configured
34949 <A HREF="h_config_smime_cacertdir"><!--#echo var="VAR_smime-cacert-directory"--></A>
34950 to the container in your configured
34951 <A HREF="h_config_smime_cacertcon"><!--#echo var="VAR_smime-cacert-container"--></A>.
34952 This might be useful if you decide to switch from using a CA cert directory to a CA cert
34953 container.
34954 <P>
34955 Warning: Any previous contents in the container will be lost.
34956 <P>
34957 <UL>
34958 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
34959 </UL><P>
34960 <P>
34961 <UL>
34962 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34963 </UL><P>
34964 &lt;End of help on this topic&gt;
34965 </BODY>
34966 </HTML>
34967 ====== h_config_smime_transfer_cacert_to_dir =====
34968 <HTML>
34969 <HEAD>
34970 <TITLE>S/MIME: Transfer CA Certs to Directory</TITLE>
34971 </HEAD>
34972 <BODY>
34973 <H1>S/MIME: Transfer CA Certs to Directory</H1>
34974
34975 UNIX Alpine only.
34976 <P>
34977 The Transfer command will copy the CA certificates in your configured
34978 <A HREF="h_config_smime_cacertcon"><!--#echo var="VAR_smime-cacert-container"--></A>.
34979 to the directory in your configured
34980 <A HREF="h_config_smime_cacertdir"><!--#echo var="VAR_smime-cacert-directory"--></A>.
34981 This might be useful if you decide to switch from using a CA cert container to a CA cert
34982 directory.
34983 <P>
34984 <UL>
34985 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
34986 </UL><P>
34987 <P>
34988 <UL>
34989 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34990 </UL><P>
34991 &lt;End of help on this topic&gt;
34992 </BODY>
34993 </HTML>
34994 ====== h_config_smime_transfer_pubcon_to_key =====
34995 <HTML>
34996 <HEAD>
34997 <TITLE>S/MIME: Transfer Public Certs to Keychain</TITLE>
34998 </HEAD>
34999 <BODY>
35000 <H1>S/MIME: Transfer Public Certs to Keychain</H1>
35001
35002 Mac OS X Alpine only.
35003 <P>
35004 The Transfer command will copy the public certificates in your configured
35005 <A HREF="h_config_smime_pubcertcon"><!--#echo var="VAR_smime-public-cert-container"--></A>
35006 to your default Mac OS X Keychain.
35007 This might be useful if you decide to switch from using a cert container to using
35008 the Keychain to store your public certs, which you may do by using the
35009 feature
35010 <A HREF="h_config_smime_pubcerts_in_keychain">S/MIME FEATURE: <!--#echo var="FEAT_publiccerts-in-keychain"--></A>.
35011 <P>
35012 <UL>
35013 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35014 </UL><P>
35015 <P>
35016 <UL>
35017 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35018 </UL><P>
35019 &lt;End of help on this topic&gt;
35020 </BODY>
35021 </HTML>
35022 ====== h_config_smime_transfer_pubkey_to_con =====
35023 <HTML>
35024 <HEAD>
35025 <TITLE>S/MIME: Transfer Public Certs to Keychain</TITLE>
35026 </HEAD>
35027 <BODY>
35028 <H1>S/MIME: Transfer Public Certs to Keychain</H1>
35029
35030 UNIX Alpine only.
35031 <P>
35032 The Transfer command will copy the public certificates in your configured
35033 <A HREF="h_config_smime_pubcertcon"><!--#echo var="VAR_smime-public-cert-container"--></A>
35034 to your default Mac OS X Keychain.
35035 This might be useful if you decide to switch from using a cert container to using
35036 the Keychain to store your public certs.
35037 <P>
35038 <UL>
35039 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35040 </UL><P>
35041 <P>
35042 <UL>
35043 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35044 </UL><P>
35045 &lt;End of help on this topic&gt;
35046 </BODY>
35047 </HTML>
35048 ====== h_config_smime_public_certificates =====
35049 <HTML>
35050 <HEAD>
35051 <TITLE>S/MIME: Manage Public Certificates</TITLE>
35052 </HEAD>
35053 <BODY>
35054 <H1>S/MIME: Manage Public Certificates</H1>
35055
35056 UNIX Alpine only.
35057 <P>
35058 This menu item allows you to manage your public certificates, this
35059 may include your own public certificate, but it normally includes
35060 certificates of people you correspond with. These certificates are
35061 saved by Alpine automatically when they are found in signed messages
35062 that you receive. This interface allows you to manage them, by
35063 giving you the option to delete them, or trust them (in the case
35064 of self-signed certificates).
35065
35066 <P>
35067 Please note that Alpine will not validate a message that was sent to you
35068 using a self-signed certificate, unless you decide to trust that certificate.
35069 Internally, a certificate is trusted by copying it to the
35070 <A HREF="h_config_smime_certificate_authorities">Certificate Authorities</A>
35071 collection. If you decide that you want to stop trusting a self-signed
35072 certificate, you must delete such certificate from such collection.
35073 <P>
35074 The <B>I</B> Import command available in this screen allows you to
35075 import a command to this collection.
35076 <P>
35077 <UL>
35078 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35079 </UL><P>
35080 <P>
35081 <UL>
35082 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35083 </UL><P>
35084 &lt;End of help on this topic&gt;
35085 </BODY>
35086 </HTML>
35087 ====== h_config_smime_private_keys =====
35088 <HTML>
35089 <HEAD>
35090 <TITLE>S/MIME: Manage Private Keys</TITLE>
35091 </HEAD>
35092 <BODY>
35093 <H1>S/MIME: Manage Private Keys</H1>
35094
35095 UNIX Alpine only.
35096 <P>
35097 This option allows you to manage your private key. Normally a person has only
35098 one key, in the same way that a person only has one valid passport, or ID card,
35099 at any given time. This option allows you to manage private keys. You can
35100 delete them or import them. Additionally, you can view information
35101 about your public certificate, such as the issuer and the dates of validity
35102 of such certificate, among others.
35103
35104 <P>
35105 If you have more than one e-mail address for which you want to use the
35106 same private key, you must add all those addresses to the private key at
35107 the moment that the key is generated. When you receive a signed message using
35108 a key generated for several e-mail addresses, Alpine will save a
35109 certificate for each e-mail address included in such certificate.
35110 <P>
35111 The <B>I</B> Import command available in this screen allows you to
35112 import a command to this collection.
35113 <P>
35114 <UL>
35115 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35116 </UL><P>
35117 <P>
35118 <UL>
35119 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35120 </UL><P>
35121 &lt;End of help on this topic&gt;
35122 </BODY>
35123 </HTML>
35124 ====== h_config_smime_certificate_authorities =====
35125 <HTML>
35126 <HEAD>
35127 <TITLE>S/MIME: Manage Certificate Authorities</TITLE>
35128 </HEAD>
35129 <BODY>
35130 <H1>S/MIME: Manage Certificate Authorities</H1>
35131
35132 UNIX Alpine only.
35133 <P>
35134 This collection contains certificates that are needed to validate the
35135 certificate of another person, and therefore contains certificates that
35136 you trust. Typically a certificate is signed by another entity, called a
35137 certificate authority. This option allows you to manage which certificates
35138 you trust, allowing you to import them and to delete them or view information
35139 about each certificate, such as the issuer and the dates of validity
35140 of such certificate.
35141 <P>
35142 The <B>I</B> Import command available in this screen allows you to
35143 import a command to this collection.
35144 <P>
35145 <UL>
35146 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35147 </UL><P>
35148 <P>
35149 <UL>
35150 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35151 </UL><P>
35152 &lt;End of help on this topic&gt;
35153 </BODY>
35154 </HTML>
35155 ====== h_certificate_information =====
35156 <HTML>
35157 <HEAD>
35158 <TITLE>S/MIME: Certificate Information Screen</TITLE>
35159 </HEAD>
35160 <BODY>
35161 <H1>S/MIME: Certificate Information Screen</H1>
35162
35163 UNIX Alpine only.
35164 <P>
35165 The CERTIFICATE INFORMATION screen shows you information contained in a certificate
35166 such as its owner, e-mail address, issuer, and interval of validity,
35167 among others.
35168 <P>
35169 In the case of public certificates, this screen shows you if there was a
35170 failure when attempting to validate such message. If the certificate is
35171 self-signed, then the <B>T</B> Trust command will be available, which
35172 you can use to trust such certificate and make Alpine not fail validating
35173 signatures signed with such certificate.
35174 <P>
35175 You can also mark a certificate deleted, with the <B>D</B> command, or
35176 remove the deleted mark with the <B>U</B> undelete command.
35177 <P>
35178 In the case of your private key, Alpine shows you the information
35179 from your public key. Additionally, Alpine allows you to see public
35180 and private information about your key, with the <B>B</B> and
35181 <B>R</B> commands respectively.
35182 <UL>
35183 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35184 </UL><P>
35185 <P>
35186 <UL>
35187 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35188 </UL><P>
35189 &lt;End of help on this topic&gt;
35190 </BODY>
35191 </HTML>
35192 ====== h_config_smime_manage_public_menu =====
35193 <HTML>
35194 <HEAD>
35195 <TITLE>S/MIME: Menu of Commands to Manage Public Certificates</TITLE>
35196 </HEAD>
35197 <BODY>
35198 <H1>S/MIME: Commands that Manage Public Certificates</H1>
35199
35200 UNIX Alpine only.
35201 <P>
35202 This screen allows you to manage your public certificates.
35203 <P>
35204 The format of this screen is as follows. There are five fields: The
35205 leftmost field is normally empty, but it could contain the letter
35206 &quot;D&quot; to indicate that that certificate has been marked for
35207 deletion. The next field is the e-mail address of the owner of the
35208 certificate, shown in its entirety. The third and fourth field are the
35209 first and last day validity for that certificate, respectively. The date
35210 is displayed in the user's locale unless the option
35211 <A HREF="h_config_disable_index_locale_dates"><!--#echo var="FEAT_disable-index-locale-dates"--></A>
35212 is set. In this case, the month, day and year are represented by two
35213 digits, and the format used is mm/dd/yy. Finally, the fifth
35214 field is what can be displayed of the MD5 hash of the certificate. You can
35215 use any of the last three fields to distinguish between two certificates
35216 for the same owner.
35217 <P>
35218 Available commands in this screen and a short description of what they
35219 do follows.
35220 <UL>
35221 <LI> <B>I</B> Imports a public certificate to this collection.
35222 <LI> <B>V</B> View information about a certificate such as the name of the person the
35223 certificate was issued to, its dates of validity, and validity status.
35224 <LI> <B>D</B> Marks a certificate deleted.
35225 <LI> <B>U</B> Removes the deletion mark on a certificate.
35226 <LI> <B>X</B> Removes all certificates marked deleted permanently (cannot be undone).
35227 <LI> <B>T</B> This command is only available for self-signed certificates, and allows you to
35228 trust a certificate by copying it to the collection of trusted certificates.
35229 </UL>
35230 <P>
35231 All commands provide feedback to let you know about their success or failure.
35232 <P>
35233 <UL>
35234 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35235 </UL><P>
35236 <P>
35237 <UL>
35238 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35239 </UL><P>
35240 &lt;End of help on this topic&gt;
35241 </BODY>
35242 </HTML>
35243 ====== h_config_smime_manage_private_menu =====
35244 <HTML>
35245 <HEAD>
35246 <TITLE>S/MIME: Menu of Commands to Manage Private Keys</TITLE>
35247 </HEAD>
35248 <BODY>
35249 <H1>S/MIME: Commands that Manage Private Keys</H1>
35250
35251 UNIX Alpine only.
35252 <P>
35253 This screen allows you to manage your private key.
35254 <P>
35255 The format of this screen is as follows. There are five fields: The
35256 leftmost field is normally empty, but it could contain the letter
35257 &quot;D&quot; to indicate that that certificate has been marked for
35258 deletion. The next field is the e-mail address of the owner of the
35259 certificate, shown in its entirety. The third field is the first day of
35260 validity for that certificate; the fourth field in the last day that that
35261 certificate is valid, and the fifth field is what can be displayed of the
35262 MD5 hash of the public certificate corresponding to this private key. You
35263 can use any of the last three fields to distinguish between two
35264 certificates for the same owner.
35265 <P>
35266 Available commands and a short description of what they do follows.
35267 <UL>
35268 <LI> <B>I</B> Imports a new public key to this collection.
35269 <LI> <B>V</B> View information about the public certificate corresponding to this
35270 key.
35271 <LI> <B>D</B> Marks a key to be deleted.
35272 <LI> <B>U</B> Removes the deletion mark on a key.
35273 <LI> <B>X</B> Removes all keys marked deleted permanently (cannot be undone).
35274 Note that expunging a private key does not remove the public key, which must
35275 be removed separately.
35276 </UL>
35277 <P>
35278 All commands provide feedback to let you know about their success or failure.
35279 <P>
35280 <UL>
35281 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35282 </UL><P>
35283 <P>
35284 <UL>
35285 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35286 </UL><P>
35287 &lt;End of help on this topic&gt;
35288 </BODY>
35289 </HTML>
35290 ====== h_config_smime_manage_cacerts_menu =====
35291 <HTML>
35292 <HEAD>
35293 <TITLE>S/MIME: Menu of Commands to Manage Certificate Authorities</TITLE>
35294 </HEAD>
35295 <BODY>
35296 <H1>S/MIME: Commands that Manage Certificate Authorities</H1>
35297
35298 UNIX Alpine only.
35299 <P>
35300 This screen allows you to manage your collection of certificates that you
35301 trust.
35302 <P>
35303 The format of this screen is as follows. There are five fields: The
35304 leftmost field is normally empty, but it could contain the letter
35305 &quot;D&quot; to indicate that that certificate has been marked for
35306 deletion. The next field is the e-mail address of the owner of the
35307 certificate, shown in its entirety. The third field is the first day of
35308 validity for that certificate; the fourth field in the last day that that
35309 certificate is valid, and the fifth field is what can be displayed of the
35310 MD5 hash of the certificate. You can use any of the last three fields to
35311 distinguish between two certificates for the same owner.
35312 <P>
35313 Available commands and a short description of what they do follows.
35314 <UL>
35315 <LI> <B>I</B> Imports a trusted certificate to this collection. This is
35316 done by reading the certificate and validating it. Once a certificate
35317 is found to be valid, it is saved, adding the extension &quot;.crt&quot;
35318 to the certificate, if necessary.
35319 <LI> <B>V</B> View information about this certificate, such as its issuer
35320 and validity dates.
35321 <LI> <B>D</B> Marks a certificate to be deleted.
35322 <LI> <B>U</B> Removes the deletion mark on a certificate.
35323 <LI> <B>X</B> Removes all certificates marked deleted permanently (cannot be undone).
35324 </UL>
35325 <P>
35326 All commands provide feedback to let you know about their success or failure.
35327 <P>
35328 <UL>
35329 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35330 </UL><P>
35331 <P>
35332 <UL>
35333 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35334 </UL><P>
35335 &lt;End of help on this topic&gt;
35336 </BODY>
35337 </HTML>
35338 ====== h_config_lame_list_mode =====
35339 <HTML>
35340 <HEAD>
35341 <TITLE>FEATURE: <!--#echo var="FEAT_enable-lame-list-mode"--></TITLE>
35342 </HEAD>
35343 <BODY>
35344 <H1>FEATURE: <!--#echo var="FEAT_enable-lame-list-mode"--></H1>
35345
35346 This feature modifies the method Alpine uses to ask your IMAP
35347 server for folder names to display in the FOLDER LIST screen.
35348 It is intended to compensate for a small set of IMAP servers that
35349 are programmed to ignore a part of the request, and thus respond
35350 to Alpine's query with nonsensical results.
35351 <P>
35352
35353 If you find that Alpine is erroneously displaying blank folder lists,
35354 try enabling this feature.
35355 <P>
35356
35357 NOTE: Enabling this feature has consequences for the Goto and Save
35358 commands.  Many servers allow access to folders outside the area
35359 reserved for your personal folders via some reserved character,
35360 typically '#' (sharp), '~' (tilde) or '/' (slash).  This mechanism
35361 allows, at the Goto and Save prompts, quick access to folders
35362 outside your personal folder collection without requiring a specific
35363 collection definition.  This behavior will generally not be available
35364 when this feature is enabled.
35365
35366 <P>
35367 <UL>
35368 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35369 </UL><P>
35370 &lt;End of help on this topic&gt;
35371 </BODY>
35372 </HTML>
35373 ====== h_config_enable_mulnewsrcs =====
35374 <HTML>
35375 <HEAD>
35376 <TITLE>FEATURE: <!--#echo var="FEAT_enable-multiple-newsrcs"--></TITLE>
35377 </HEAD>
35378 <BODY>
35379 <H1>FEATURE: <!--#echo var="FEAT_enable-multiple-newsrcs"--></H1>
35380
35381 This feature makes it so Alpine can use multiple newsrcs based on
35382 the news server being connected to, which allows for separate lists
35383 of subscribed-to newsgroups. When this feature is not set, there is only
35384 one list of newsgroups.
35385 <P>
35386 Under this feature, the name of a newsrc is based on the news server.
35387 For example, if your <a href="h_config_newsrc_path"><!--#echo var="VAR_newsrc-path"--></a>
35388 is set to &quot;.newsrc&quot;, and the news server you are connecting to is
35389 news.example.com, then the newsrc to be used is .newsrc-news.example.com.
35390 Setting this feature for the first time will allow for the option of using
35391 your old newsrc the next time you read news.
35392 <P>
35393 If this feature is set, then the feature
35394 <A HREF="h_config_mulnews_as_typed"><!--#echo var="FEAT_mult-newsrc-hostnames-as-typed"--></A>
35395 also may affect the name of the newsrc file that is used.
35396 <P>
35397 <UL>
35398 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35399 </UL><P>
35400 &lt;End of help on this topic&gt;
35401 </BODY>
35402 </HTML>
35403 ======= h_ab_export_vcard =======
35404 <HTML>
35405 <HEAD>
35406 <TITLE>Address Book Export Format</TITLE>
35407 </HEAD>
35408 <BODY>
35409 <H1>Address Book Export Format</H1>
35410
35411 You are exporting address book data from Alpine to a file outside of Alpine.
35412 You are being asked to choose the format of the export.
35413 Here are the choices:
35414
35415 <DL>
35416 <DT><EM>A</EM>ddress List</DT>
35417 <DD>
35418 The addresses from the address book entries you are saving
35419 from will be saved one address per line.
35420 Address book lists (those with more than one address) will have
35421 all of their addresses saved separately.
35422 </DD>
35423
35424 <DT><EM>V</EM>Card</DT>
35425 <DD>
35426 The entries will be saved in
35427 <A HREF="h_whatis_vcard">vCard</A> format.
35428 </DD>
35429
35430 <DT><EM>T</EM>ab Separated</DT>
35431 <DD>
35432 The entries will be saved in tab-separated columns.
35433 There will be just 4 columns of data that correspond to Alpine's
35434 Nickname field, Full Name field, Address field, and Comment field.
35435 It might prove useful to Select only the Simple, non-List address book
35436 entries before Saving.
35437 </DD>
35438
35439 <DT><EM>^C</EM> Cancel</DT>
35440 <DD>
35441 Cancel out of the Save.
35442 </DD>
35443
35444 </DL>
35445
35446
35447 <P>
35448 &lt;End of help on this topic&gt;
35449 </BODY>
35450 </HTML>
35451 ====== h_config_predict_nntp_server =====
35452 <HTML>
35453 <HEAD>
35454 <TITLE>FEATURE: <!--#echo var="FEAT_predict-nntp-server"--></TITLE>
35455 </HEAD>
35456 <BODY>
35457 <H1>FEATURE: <!--#echo var="FEAT_predict-nntp-server"--></H1>
35458
35459 This feature allows Alpine to assume that the open NNTP server at the
35460 time of composition is the NNTP server to which the message should be
35461 posted.  This is especially recommended when there are multiple News
35462 collections.  If this feature is not set, Alpine will try to post to the first server in
35463 the <a href="h_config_nntp_server"><!--#echo var="VAR_nntp-server"--></a> variable.  Setting
35464 this feature also negates the need to add News collection servers to
35465 the <!--#echo var="VAR_nntp-server"--> variable.
35466 <P>
35467 This feature can be especially handy when used in conjunction with
35468 <a href="h_config_enable_mulnewsrcs"><!--#echo var="FEAT_enable-multiple-newsrcs"--></a>.
35469 <P>
35470 <UL>
35471 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35472 </UL><P>
35473 &lt;End of help on this topic&gt;
35474 </BODY>
35475 </HTML>
35476 ====== h_config_nntp_search_uses_overview =====
35477 <HTML>
35478 <HEAD>
35479 <TITLE>FEATURE: <!--#echo var="FEAT_nntp-search-uses-overview"--></TITLE>
35480 </HEAD>
35481 <BODY>
35482 <H1>FEATURE: <!--#echo var="FEAT_nntp-search-uses-overview"--></H1>
35483
35484 This feature should probably be turned on unless it causes trouble.
35485 The results of the NNTP overview command (XOVER) may be used to help
35486 with some searches in news groups.
35487 It should result in quicker response time.
35488 Turning this feature on apparently causes search results which are
35489 different from what you would get with the feature turned off on some
35490 servers.
35491 <P>
35492 <UL>
35493 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35494 </UL><P>
35495 &lt;End of help on this topic&gt;
35496 </BODY>
35497 </HTML>
35498 ====== h_config_thread_sorts_by_arrival =====
35499 <HTML>
35500 <HEAD>
35501 <TITLE>FEATURE: <!--#echo var="FEAT_thread-sorts-by-arrival"--></TITLE>
35502 </HEAD>
35503 <BODY>
35504 <H1>FEATURE: <!--#echo var="FEAT_thread-sorts-by-arrival"--></H1>
35505
35506 This feature affects how a threading sort arranges threads.  The default way
35507 to arrange threads is by the date of the earliest message in the thread.
35508 This feature arranges threads by the last message to arrive in a thread.
35509 <P>
35510 This feature causes old threads that get recent messages to sort to the bottom,
35511 where previously a message arrival to a thread would not rearrange the order of
35512 that thread.
35513 <P>
35514 <UL>
35515 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35516 </UL><P>
35517 &lt;End of help on this topic&gt;
35518 </BODY>
35519 </HTML>
35520 ====== h_config_textplain_int =====
35521 <HTML>
35522 <HEAD>
35523 <TITLE>FEATURE: <!--#echo var="FEAT_show-plain-text-internally"--></TITLE>
35524 </HEAD>
35525 <BODY>
35526 <H1>FEATURE: <!--#echo var="FEAT_show-plain-text-internally"--></H1>
35527
35528 This feature modifies the method Alpine uses to display Text/Plain
35529 MIME attachments from the Attachment Index screen.  Normally, the
35530 &quot;View&quot; command searches for any externally defined (usually
35531 via the
35532 &quot;<A HREF="h_config_mailcap_path">Mailcap</A>&quot; file) viewer,
35533 and displays the selected text within that viewer.
35534
35535 <P>
35536 Enabling this feature causes Alpine to ignore any external viewer
35537 settings and always display text with Alpine's internal viewer.
35538
35539 <P>
35540 <UL>
35541 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35542 </UL><P>
35543 &lt;End of help on this topic&gt;
35544 </BODY>
35545 </HTML>
35546 ====== h_config_wp_columns =====
35547 <HTML>
35548 <HEAD>
35549 <TITLE>WEB ALPINE OPTION: <!--#echo var="VAR_wp-columns"--></TITLE>
35550 </HEAD>
35551 <BODY>
35552 <H1>WEB ALPINE OPTION: <!--#echo var="VAR_wp-columns"--></H1>
35553
35554 Web Alpine only.
35555 <P>
35556 This configuration setting specifies the number of horizontal characters
35557 used to format various WebAlpine pages.  Smaller values will tend to reduce
35558 the amount of horizontal scrolling required to view pages within narrow
35559 browsers, such as those found on PDAs, and larger values will tend to
35560 spread more information across the page.
35561
35562 <P>
35563 The Message List page uses the width to determine how many characters
35564 to assign each field.  Note, a smaller value may result in a disproportionate
35565 amount of blank space between fields on each line.  Similarly, a large
35566 value may result in cramped fields or horizontal scrolling.
35567
35568 <P>
35569 The Message View page uses this value to determine when to wrap lines
35570 in displayed message text.  Note, a smaller value may result in jagged
35571 right margins or confusing quoting.  A larger value may cause lines of text to
35572 run beyond the browser's right edge, requiring horizontal scrolling.
35573
35574 <P>
35575 <UL>
35576 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35577 </UL><P>
35578 &lt;End of help on this topic&gt;
35579 </BODY>
35580 </HTML>
35581 ====== h_config_wp_state =====
35582 <HTML>
35583 <HEAD>
35584 <TITLE>WEB ALPINE OPTION: <!--#echo var="VAR_wp-state"--></TITLE>
35585 </HEAD>
35586 <BODY>
35587 <H1>WEB ALPINE OPTION: <!--#echo var="VAR_wp-state"--></H1>
35588
35589 Web Alpine only.
35590 <P>
35591 Various aspects of cross-session state.
35592
35593 <P>
35594 <UL>
35595 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35596 </UL><P>
35597 &lt;End of help on this topic&gt;
35598 </BODY>
35599 </HTML>
35600 ====== h_config_wp_aggstate =====
35601 <HTML>
35602 <HEAD>
35603 <TITLE>WEB ALPINE OPTION: <!--#echo var="VAR_wp-aggstate"--></TITLE>
35604 </HEAD>
35605 <BODY>
35606 <H1>WEB ALPINE OPTION: <!--#echo var="VAR_wp-aggstate"--></H1>
35607
35608 Web Alpine only.
35609 <P>
35610 Aggregate operations tab state.
35611
35612 <P>
35613 <UL>
35614 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35615 </UL><P>
35616 &lt;End of help on this topic&gt;
35617 </BODY>
35618 </HTML>
35619 ====== h_config_wp_indexlines =====
35620 <HTML>
35621 <HEAD>
35622 <TITLE>WEB ALPINE OPTION: <!--#echo var="VAR_wp-indexlines"--></TITLE>
35623 </HEAD>
35624 <BODY>
35625 <H1>WEB ALPINE OPTION: <!--#echo var="VAR_wp-indexlines"--></H1>
35626
35627 Web Alpine only.
35628 <P>
35629 Number of index lines in table.
35630
35631 <P>
35632 <UL>
35633 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35634 </UL><P>
35635 &lt;End of help on this topic&gt;
35636 </BODY>
35637 </HTML>
35638 ====== h_config_wp_indexheight =====
35639 <HTML>
35640 <HEAD>
35641 <TITLE>WEB ALPINE OPTION: <!--#echo var="VAR_wp-indexheight"--></TITLE>
35642 </HEAD>
35643 <BODY>
35644 <H1>WEB ALPINE OPTION: <!--#echo var="VAR_wp-indexheight"--></H1>
35645
35646 Web Alpine only.
35647 <P>
35648 Index table row height.
35649
35650 <P>
35651 <UL>
35652 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35653 </UL><P>
35654 &lt;End of help on this topic&gt;
35655 </BODY>
35656 </HTML>
35657 ====== h_config_rss_news =====
35658 <HTML>
35659 <HEAD>
35660 <TITLE>WEB ALPINE OPTION: <!--#echo var="VAR_rss_news"--></TITLE>
35661 </HEAD>
35662 <BODY>
35663 <H1>WEB ALPINE OPTION: <!--#echo var="VAR_rss-news"--></H1>
35664
35665 Web Alpine only.
35666 <P>
35667 RSS News feed.
35668
35669 <P>
35670 <UL>
35671 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35672 </UL><P>
35673 &lt;End of help on this topic&gt;
35674 </BODY>
35675 </HTML>
35676 ====== h_config_rss_weather =====
35677 <HTML>
35678 <HEAD>
35679 <TITLE>WEB ALPINE OPTION: <!--#echo var="VAR_rss-weather"--></TITLE>
35680 </HEAD>
35681 <BODY>
35682 <H1>WEB ALPINE OPTION: <!--#echo var="VAR_rss-weather"--></H1>
35683
35684 Web Alpine only.
35685 <P>
35686 RSS Weather feed.
35687
35688 <P>
35689 <UL>
35690 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35691 </UL><P>
35692 &lt;End of help on this topic&gt;
35693 </BODY>
35694 </HTML>
35695 ====== h_config_send_confirms_only_expanded =====
35696 <HTML>
35697 <HEAD>
35698 <TITLE>FEATURE: send-confirms-only-expanded</TITLE>
35699 </HEAD>
35700 <BODY>
35701 <H1>FEATURE: send-confirms-only-expanded (Web Alpine Only)</H1>
35702
35703 This Web Alpine option specifies whether or not a Send confirmations
35704 happens when a composed message is readied for sending or not.  The
35705 default behavior is to not confirm that the nicknames were expanded to
35706 the intended addresses.
35707
35708 <P>
35709 <UL>
35710 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35711 </UL><P>
35712 &lt;End of help on this topic&gt;
35713 </BODY>
35714 </HTML>
35715 ====== h_config_enable_jump_command =====
35716 <HTML>
35717 <HEAD>
35718 <TITLE>FEATURE: enable-jump-command</TITLE>
35719 </HEAD>
35720 <BODY>
35721 <H1>FEATURE: enable-jump-command (Web Alpine Only)</H1>
35722
35723 This Web Alpine option specifies whether or not a Jump command is
35724 offered in the Message List and Message View pages.  The command is
35725 implemented as an input field in the left column of the List and View
35726 screens.
35727
35728 <P>
35729 When enabled and a number is entered in the input field while the
35730 Message List is displayed, the Message List is reframed with the
35731 specified message.  While viewing a message, the message associated
35732 with the specified message number is displayed.
35733
35734 <P>
35735 <UL>
35736 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35737 </UL><P>
35738 &lt;End of help on this topic&gt;
35739 </BODY>
35740 </HTML>
35741 ====== h_config_enable_newmail_sound =====
35742 <HTML>
35743 <HEAD>
35744 <TITLE>FEATURE: enable-newmail-sound</TITLE>
35745 </HEAD>
35746 <BODY>
35747 <H1>FEATURE: enable-newmail-sound (Web Alpine Only)</H1>
35748
35749 This Web Alpine option specifies whether or not a sound file is sent
35750 to the web browser along with the newmail notification message.
35751
35752
35753 <P>
35754 <UL>
35755 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35756 </UL><P>
35757 &lt;End of help on this topic&gt;
35758 </BODY>
35759 </HTML>
35760 ====== h_config_render_html_internally =====
35761 <HTML>
35762 <HEAD>
35763 <TITLE>FEATURE: render-html-internally</TITLE>
35764 </HEAD>
35765 <BODY>
35766 <H1>FEATURE: render-html-internally (Web Alpine Only)</H1>
35767
35768 By default, Web Alpine will pass cleansed HTML text you receive in messages
35769 to the browser for display (rendering).  This feature causes Web Alpine to convert
35770 the HTML text into plain text in the same way Unix and PC-Alpine do.
35771
35772
35773 <P>
35774 <UL>
35775 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35776 </UL><P>
35777 &lt;End of help on this topic&gt;
35778 </BODY>
35779 </HTML>
35780 ====== h_config_role_undo =====
35781 Yes, remember changes and exit back to list of roles; No, discard changes
35782 made in this screen; ^C, cancel exit and stay in this config screen.
35783 ====== h_exit_editor =====
35784 S, save changes and exit from the editor; D, do not save changes but
35785 do exit from the editor; or ^C, cancel exit and stay in the editor.
35786 ====== h_config_undo =====
35787 Yes, save changes and exit; No, exit without saving any changes made since
35788 entering this CONFIGURATION screen; ^C, cancel exit and stay in config screen.
35789 ====== h_os_index_whereis =====
35790 Enter ^V or ^Y to go immediately to the last or first message in the index.
35791 Or, enter the match string followed by RETURN.
35792 ====== h_os_index_whereis_agg =====
35793 Enter ^V or ^Y to go immediately to the last or first message in the index,
35794 Or, enter the match string followed by RETURN (or ^X to select all matches).
35795 =========== h_oe_add_full ==================
35796 Type the full name of the person being added and press the RETURN key.
35797 Press ^C to cancel addition.
35798 =========== h_oe_add_nick ==================
35799 Type a short nickname and press RETURN.  A nickname is a short easy-to-
35800 remember word, name or initials like "joe", or "wcfields."  ^C to cancel.
35801 ========== h_oe_add_addr ================
35802 Type the e-mail address and press RETURN.
35803 Press ^C to cancel addition.
35804 ========== h_oe_crlst_full ==============
35805 Type a long name or description for the list that you are creating and
35806 press RETURN.  Press ^C to cancel creation of list.
35807 =========== h_oe_crlst_nick =============
35808 Type a nickname (short, easy-to-remember name or single word) for the list
35809 you are creating and press RETURN.  Press ^C to cancel.
35810 ========== h_oe_crlst_addr ==============
35811 Type an e-mail address, or a nickname already in the address book that you
35812 want to be part of this list and press RETURN.
35813 ========== h_oe_adlst_addr =============
35814 Type an e-mail address or a nickname already in the address book that you
35815 want to add to this list and press RETURN.
35816 ========== h_oe_editab_nick ============
35817 Change the nickname using the arrow keys and delete key.  Press RETURN
35818 when done.  Press ^C to cancel editing and leave the nickname as it was.
35819 ========== h_oe_editab_full ============
35820 Change the full name using the arrow keys and delete key.  Press RETURN
35821 when done.  Press ^C to cancel editing and leave the full name as it was.
35822 ========== h_oe_editab_addr ============
35823 Change the address using the arrow keys and delete key.  Press RETURN
35824 when done.  Press ^C to cancel editing and leave the address as it was.
35825 ========== h_oe_editab_fcc ============
35826 Change the fcc using the arrow keys and delete key.  Press RETURN when
35827 done.  Press ^C to cancel editing and leave the fcc as it was.
35828 ========== h_oe_editab_comment ============
35829 Change the comment field using the arrow keys and delete key.  Press RETURN
35830 when done.  Press ^C to cancel editing and leave the comment as it was.
35831 ====== h_ab_forward =====
35832 Yes, expand nicknames and qualify local names with your current domain name;
35833 No, leave nicknames and local names as is;  ^C, cancel.
35834 ========== h_ab_export ==========
35835 Type the name of a file to write the addresses into and
35836 press RETURN.  You may also specify an absolute path.  Use ^C to cancel.
35837 ========== h_ab_edit_a_field ==========
35838 Edit any of the fields of the currently selected entry by typing one of the
35839 letters at the bottom of the screen.  Press ^C to cancel edit.
35840 ====== h_ab_del_data_revert =====
35841 Press B to completely delete addrbook and revert to default, C to delete config
35842 and revert while leaving data, or D to only delete data (make it empty).
35843 ====== h_ab_del_data_modify =====
35844 Press B to completely delete addrbook, C to delete configuration while leaving
35845 data, or D to delete data (make it empty) but leave config. ^C to cancel.
35846 ====== h_ab_del_config_modify =====
35847 Yes, remove this address book from my configuration.
35848 No, make no changes now.
35849 ====== h_ab_del_config_revert =====
35850 Yes, remove this address book from my config and revert to default.
35851 No, make no changes now.
35852 ====== h_ab_del_default =====
35853 Yes, remove this default address book from my configuration.
35854 No, make no changes now.
35855 ====== h_ab_really_delete =====
35856 Yes, delete the actual contents of the address book, not just the
35857 configuration.  No, don't delete the data after all, cancel and start over.
35858 ====== h_ab_del_ignore =====
35859 Press I to ignore all the default address books for this category.  Press R to
35860 remove this one address book and add the others to your personal list.
35861 ====== h_ab_del_dir_ignore =====
35862 Press I to ignore all the default directory servers for this category.
35863 Press R to remove this one server and add the others to your personal list.
35864 ====== h_ab_copy_dups =====
35865 Yes, overwrite the existing entry.
35866 No, skip duplicates but save the rest. Press ^C to cancel.
35867 ====== h_confirm_cancel =====
35868 Type C to Confirm that you want to abandon the message you are composing.
35869 Type N or ^C to cancel out of the cancel and keep composing.
35870 ====== h_ab_text_or_vcard =====
35871 Text, start composer with displayed text already included.
35872 VCard, start composer with address book entry attached as a vCard. ^C cancels.
35873 ====== h_ab_backup_or_ldap =====
35874 Backup, copy email address from entry and allow editing of it.
35875 LDAP, copy LDAP search criteria, do not allow editing of it. ^C cancels.
35876 ====== h_ldap_text_or_vcard =====
35877 Text: export displayed text for selected entry. Address: export only the
35878 email address. VCard: export entry in vCard format. ^C cancels.
35879 ====== h_ab_save_exp =====
35880 Save, save entry or entries to an address book.
35881 Export, save to file outside of pine. ^C cancels save.
35882 ====== h_ab_add =====
35883 A, add a brand new entry to this address book.
35884 E, edit the entry that is currently highlighted. ^C to cancel.
35885 ====== h_ab_shuf =====
35886 U, swap order of highlighted address book and the one above it.
35887 D, swap order of highlighted address book and the one below it. ^C to cancel.
35888 ====== h_ab_shuf_up =====
35889 U, swap order of highlighted address book and the one above it.
35890 Press ^C to cancel.
35891 ====== h_ab_shuf_down =====
35892 D, swap order of highlighted address book and the one below it.
35893 Press ^C to cancel.
35894 ====== h_folder_prop =====
35895 Count is # of messages in the folder, Unseen means messages that have not
35896 been read, New means messages that were Recently added to the folder.
35897 ====== h_role_shuf =====
35898 U, swap order of highlighted rule and the one above it.
35899 D, swap order of highlighted rule and the one below it. ^C to cancel.
35900 ====== h_role_shuf_up =====
35901 U, swap order of highlighted rule and the one above it.
35902 Press ^C to cancel.
35903 ====== h_role_shuf_down =====
35904 D, swap order of highlighted rule and the one below it.
35905 Press ^C to cancel.
35906 ====== h_incoming_shuf =====
35907 B, swap order of highlighted directory and the one before it.
35908 F, swap order of highlighted directory and the one after it. ^C to cancel.
35909 ====== h_incoming_shuf_up =====
35910 B, swap order of highlighted directory and the one before it.
35911 Press ^C to cancel.
35912 ====== h_incoming_shuf_down =====
35913 F, swap order of highlighted directory and the one after it.
35914 Press ^C to cancel.
35915 ====== h_dir_shuf =====
35916 U, swap order of highlighted directory and the one above it.
35917 D, swap order of highlighted directory and the one below it. ^C to cancel.
35918 ====== h_dir_shuf_up =====
35919 U, swap order of highlighted directory and the one above it.
35920 Press ^C to cancel.
35921 ====== h_dir_shuf_down =====
35922 D, swap order of highlighted directory and the one below it.
35923 Press ^C to cancel.
35924 ====== h_hdrcolor_shuf =====
35925 U, swap order of highlighted Header Color and the one above it.
35926 D, swap order of highlighted Header Color and the one below it. ^C to cancel.
35927 ====== h_hdrcolor_shuf_up =====
35928 U, swap order of highlighted Header Color and the one above it.
35929 Press ^C to cancel.
35930 ====== h_hdrcolor_shuf_down =====
35931 D, swap order of highlighted Header Color and the one below it.
35932 Press ^C to cancel.
35933 ========== h_oe_editab_al ============
35934 Change the address using the arrow keys and delete key.  Press RETURN
35935 when done.  Press ^C to cancel editing and leave the address as it was.
35936 ========== h_dir_comp_search ===============
35937 Type a string to look for just like you would in the composer. Your configured
35938 rules for the servers with the implicit flag set will be used.
35939 ========== h_oe_searchab ===============
35940 Type the word or name you want to search for and press RETURN.  If you press
35941 RETURN without entering anything the word in [] will be searched for.
35942 ========== h_oe_chooseabook ==========
35943 Choose the address book you want to save the new entry in.
35944 Use ^N or ^P to change address books.  ^C to cancel.
35945 ========== h_oe_takeaddr ==========
35946 Edit the e-mail address using the arrow and delete keys.  Press RETURN
35947 when done.  Press ^C to cancel adding this entry to the address book.
35948 ========== h_oe_take_replace ==========
35949 Press R to replace the old entry with this new data.  You will still have
35950 another chance to cancel.  N to enter another nickname.  ^C to cancel now.
35951 ========== h_oe_take_replace_or_add ==========
35952 Press R to replace the old entry.  Press A to add the selected addresses to
35953 the old existing list.  N to enter another nickname. ^C to cancel now.
35954 ========== h_oe_takename ==========
35955 Edit the full name to be correct using the arrow and delete keys.  Press RETURN
35956 when done.  Press ^C to cancel adding this entry to the address book.
35957 ========== h_oe_takenick ==========
35958 Type a nickname (short easy-to-remember name, initials or single word) for this
35959 entry in the address book and press RETURN.  Press ^C to cancel addition.
35960 ========== h_oe_jump ==========
35961 Type the message number you want to jump to and press RETURN.  The word "end"
35962 represents the last message. Press ^C to cancel jumping to another message.
35963 ========== h_oe_jump_thd ==========
35964 Type the thread number you want to jump to and press RETURN.  The word "end"
35965 represents the last thread. Press ^C to cancel jumping to another thread.
35966 ========== h_oe_debuglevel ==========
35967 Higher number shows more debugging details.
35968 Press ^C if you want to cancel the change.
35969 ========== h_oe_broach ==========
35970 Type the name of the folder you want to open and press RETURN.  Press ^P/^N
35971 to go to the previous/next collections in the list.  Press ^C to cancel goto.
35972 ========== h_oe_foldsearch ==========
35973 Type the text you want to search for in foldernames and press RETURN.  If you
35974 press RETURN without entering anything, any text in [] will be searched for.
35975 ========== h_oe_foldrename ==========
35976 Change the old name of the folder to the new name using the arrow and
35977 delete keys and press RETURN.  Press ^C to cancel rename.
35978 ========== h_oe_login ==========
35979 Enter your login name for the host you are opening the mailbox on.  Just press
35980 RETURN to use your login from this host as is, or edit it with delete key.
35981 ========== h_oe_passwd ==========
35982 Type your password for the host and login shown as part of the prompt.
35983 Press ^C to cancel opening folder.
35984 ========== h_oe_choosep ==========
35985 Enter the number associated with the printer you want to select.  Press ^C to
35986 cancel the printer selection.  The current selection is highlighted.
35987 ========== h_oe_customp ==========
35988 Type the name of the Unix print command and press RETURN.  Press ^C to
35989 cancel the printer selection.
35990 ========== h_oe_searchview ==========
35991 Type the word or name you want to search for and press RETURN.  If you press
35992 RETURN without entering anything the word in [] will be searched for.
35993 ========== h_oe_keylock ==========
35994 The keyboard is in use and locked by another user.  Only that user can
35995 unlock this keyboard by typing the password.
35996 ========== h_wt_expire ==========
35997 At the beginning of each month Alpine offers to rename your current sent-mail
35998 folder to one named for the month so you have a sent-mail folder for each month
35999 ========== h_wt_delete_old ==========
36000 It is the beginning of the month, and we need to conserve disk
36001 space.  Please delete any sent-mail that you do not need.
36002 ========== h_select_sort ==========
36003 Select the order for sorting the index by typing the capitalized letter.
36004 Arrival is by arrival in your mailbox; Date is by time/day message was sent.
36005 ========== h_no_F_arg ============
36006 Enter name of file to be opened.
36007
36008 ========== h_sticky_personal_name ==========
36009 Type in your name as you want it to appear on outgoing email.  This entry
36010 will be saved into your Alpine configuration file.
36011 ========== h_sticky_inbox ============
36012 INBOX syntax is usually {complete.machine.name}INBOX
36013 This entry will be saved in your Alpine configuration file.
36014 ========== h_sticky_smtp ============
36015 The name of the computer on your campus that relays your outgoing email
36016 to the Internet.  This entry will be saved in your Alpine configuration file.
36017 ========== h_sticky_user_id ==========
36018 The username or login-id part of your email address.  This entry will be
36019 saved in your Alpine configuration file.
36020 ========== h_sticky_domain ==========
36021 The domain part of your email address, NOT the name of your PC.  This
36022 entry will be saved in your Alpine configuration file.
36023 ========== h_bounce =========
36024 Enter the address or nickname of the intended recipient.  Alpine will resend
36025 the message, which will retain the original author's From: address.
36026 ========== h_incoming_add_folder_nickname =========
36027 Enter an (optional) nickname that will be used in lieu of the actual
36028 host and folder names in the FOLDER LIST display.
36029 ========== h_anon_forward ==========
36030 Enter the address of your intended recipient, or ^C to cancel.
36031 Example: jsmith@somewhere.edu
36032 ========== h_news_subscribe ==========
36033 Enter the name of the newsgroup to which you wish to subscribe,
36034 or ^C to cancel.  Example: comp.mail.pine
36035 ========== h_pipe_msg ==========
36036 Enter the name of the Unix command to which you wish to send this
36037 message, or ^C to cancel.
36038 ========== h_pipe_attach ==========
36039 Enter the name of the Unix command to which you wish to send this
36040 attachment, or ^C to cancel.
36041 ========== h_select_by_num ==========
36042 Enter a list of message numbers (or number ranges), or ^C to cancel.  The word
36043 "end" represents the last message. Example: 2-5,7-9,11,19,35-end
36044 ========== h_select_by_thrdnum ==========
36045 Enter a list of thread numbers (or number ranges), or ^C to cancel.  The word
36046 "end" represents the last thread. Example: 2-5,7-9,11,19,35-end
36047 ========== h_select_txt_from ==========
36048 Messages with From: headers containing the entered string will be selected.
36049 ^C to cancel. ^G again to see original options.
36050 ========== h_select_txt_not_from ==========
36051 Messages without From: headers containing the entered string will be selected.
36052 ^C to cancel. ^G again to see original options.
36053 ========== h_select_txt_to ==========
36054 Messages with To: headers containing the entered string will be selected.
36055 ^C to cancel. ^G again to see original options.
36056 ========== h_select_txt_not_to ==========
36057 Messages without To: headers containing the entered string will be selected.
36058 ^C to cancel. ^G again to see original options.
36059 ========== h_select_txt_cc ==========
36060 Messages with Cc: headers containing the entered string will be selected.
36061 ^C to cancel. ^G again to see original options.
36062 ========== h_select_txt_not_cc ==========
36063 Messages without Cc: headers containing the entered string will be selected.
36064 ^C to cancel. ^G again to see original options.
36065 ========== h_select_txt_subj ==========
36066 Messages with Subject: headers containing the entered string will be selected.
36067 ^C to cancel.  ^X enters Subject: line of current message.
36068 ========== h_select_txt_not_subj ==========
36069 Messages without Subject headers containing the entered string will be selected.
36070 ^C to cancel.  ^X enters Subject: line of current message.
36071 ========== h_select_txt_all ==========
36072 All messages containing the entered string will be selected.  Headers and body,
36073 but not encoded attachments, will be compared.  Enter ^C to cancel.
36074 ========== h_select_txt_not_all ==========
36075 All messages that don't contain the entered string will be selected.  Headers
36076 and body, but not encoded attachments, will be compared.  Enter ^C to cancel.
36077 ========== h_select_txt_body ==========
36078 All messages containing the entered string will be selected. Body text, but
36079 not headers or encoded attachments, will be compared. ^C to cancel.
36080 ========== h_select_txt_not_body ==========
36081 All messages that don't contain the entered string will be selected. Body
36082 text, but not headers or encoded attachments, will be compared. ^C to cancel.
36083 ========== h_select_txt_recip ==========
36084 Messages with Cc: or To: headers containing the entered string will be selected.
36085 ^C to cancel. ^G again to see original options.
36086 ========== h_select_txt_not_recip ==========
36087 Messages without Cc: or To: headers containing the string will be selected.
36088 ^C to cancel. ^G again to see original options.
36089 ========== h_select_txt_partic ==========
36090 Messages with Cc, To, or From headers containing the string will be selected.
36091 ^C to cancel. ^G again to see original options.
36092 ========== h_select_txt_not_partic ==========
36093 Messages without Cc, To, or From headers containing the string will be selected.
36094 ^C to cancel. ^G again to see original options.
36095 ========== h_select_date ==========
36096 If typed, date may be in DD-MMM-YYYY format (04-Jul-2006) or in ISO format
36097 (2006-07-04). ^P/^N also changes default date. ^X enters date of current msg.
36098 ========== h_attach_index_whereis ==========
36099 Enter some text that appears in the Attachment Index entry for the desired
36100 attachment.  The first attachment containing that text will be highlighted.
36101 ========== h_kb_lock ==========
36102 Keystrokes entered here (up to a RETURN) comprise a password that must
36103 be entered again later in order to unlock the keyboard.
36104 ========== h_compose_default ==========
36105 N, compose a new message. R, set a role.
36106 ^C to cancel.
36107 ========== h_untranslatable ==========
36108 Send using UTF-8 character set; Send but replace untranslatable characters
36109 with question marks; return to the composer; or cancel message altogether.
36110 ========== h_compose_intrptd ==========
36111 N, compose a new msg. I, continue interrupted msg. R, set a role.
36112 ^C to cancel.
36113 ========== h_compose_postponed ==========
36114 N, compose a new message. P, continue postponed msg. R, set a role.
36115 ^C to cancel.
36116 ========== h_compose_intrptd_postponed ==========
36117 N, compose a new msg. I, continue interrupted msg. P, continue postponed msg.
36118 R, set a role. ^C to cancel.
36119 ========== h_compose_form ==========
36120 N, compose a new message. F, use form letter. R, set a role.
36121 ^C to cancel.
36122 ========== h_compose_intrptd_form ==========
36123 N, compose a new msg. I, continue interrupted msg. F, use form letter.
36124 R, set a role. ^C to cancel.
36125 ========== h_compose_postponed_form ==========
36126 N, compose a new message. P, continue postponed msg. F, use form letter.
36127 R, set a role. ^C to cancel.
36128 ========== h_compose_intrptd_postponed_form ==========
36129 N, compose a new msg. I, continue interrupted msg. P, continue postponed msg.
36130 F, use form letter. R, set a role. ^C to cancel.
36131 ========== h_config_context_del_except ==========
36132 If you delete the last exceptional collection you can only add it back by
36133 manually editing the exceptions config file.
36134 ========== h_config_whereis ==========
36135 To move quickly to a particular line, enter a search string or
36136 ^C to cancel.
36137 ========== h_config_edit_scorei ==========
36138 Enter interval in the form (min,max). -INF and INF may be used to represent
36139 -infinity and infinity. ^C to cancel change. RETURN to accept change.
36140 ========== h_config_add ==========
36141 Enter desired value; use normal editing keys to modify (e.g. ^K, ^D).  Just
36142 pressing RETURN sets the Empty Value (this turns off any global default).
36143 ========== h_config_add_custom_color ==========
36144 Enter a header fieldname. For example, "subject" or "from".
36145
36146 ========== h_config_add_pat_hdr ==========
36147 Enter a header fieldname. For example, "reply-to" or "organization" or
36148 any fieldname you want that isn't included already.
36149 ========== h_config_print_opt_choice ==========
36150 You may edit either the initialization string (characters printed before
36151 printing starts) or the trailer string.  Choose one or ^C to cancel.
36152 ========== h_config_print_init ==========
36153 Enter a C-style string for this.  You may use common backslash escapes like
36154 \\n for newline, \\ooo for octal character, and \\xhh for hex character.
36155 ========== h_config_change ==========
36156 Edit the existing value using arrow keys, ^K to delete entire entry, ^D to
36157 delete current (highlighted) character, etc.  Enter ^C to cancel change.
36158 ========== h_config_replace_add ==========
36159 Replace ignores the current default, Add places the current default in your
36160 editing buffer as if you had typed it in.
36161 ========== h_config_insert_after ==========
36162 Enter a nickname for this print command.  (InsertBefore puts the new item
36163 before the current line, InsertAfter puts it after the current line.)
36164 ========== h_config_print_cmd ==========
36165 Enter command to be executed for the printer.  Use normal editing keys
36166 to modify, ^C to cancel, carriage return to accept current value.
36167 ========== h_config_role_del ==========
36168 Answering Yes will remove this rule completely from your rules list.
36169 ========== h_config_role_addfile ==========
36170 Type the name of a file to add to your configuration. You don't need to
36171 use a file, you may add rules directly (with Add) without using a file.
36172 ========== h_config_role_delfile ==========
36173 Answering Yes will remove this rule file completely from your rules list.
36174 The rules data file itself will not be removed.
36175 ========== h_config_print_del ==========
36176 Answering Yes will remove this printer completely from your printer list.
36177 ========== h_config_print_name_cmd ==========
36178 You may edit the Nickname of this printer, the Command to be executed when
36179 printing, or change the Options associated with this printer.
36180 ========== h_send_check_fcc ==========
36181 Yes, send message without an Fcc.
36182 No, return to composer.
36183 ========== h_send_check_subj ==========
36184 Yes, send message without a Subject.
36185 No, return to composer.
36186 ========== h_send_check_to_cc ==========
36187 Yes, send message without a To address, or a Cc address, or a Newsgroup.
36188 No, return to composer.
36189 ========== h_send_fcc_only ==========
36190 Yes, copy message to Fcc only and send to NO recipients.
36191 No, return to composer.
36192 ========== h_send_prompt ==========
36193 Yes, send the message.
36194 No or ^C, return to composer.
36195 ========== h_send_prompt_flowed ==========
36196 Yes, send the message.  No or ^C, return to composer.
36197 What's Flowed? See Do Not Send Flowed Text in config screen.
36198 ========== h_send_prompt_dsn ==========
36199 Yes, send the message.  No or ^C, return to composer.
36200 What's DSNOpts? See Enable Delivery Status Notification in config screen.
36201 ========== h_send_prompt_dsn_flowed ==========
36202 Yes, send the message.  No or ^C, return to composer. What's DSNOpts? See
36203 Enable Delivery Status Notification. What's Flowed? See Do Not Send Flowed Text.
36204 ========== h_role_confirm ==========
36205 Yes, use displayed role. No, compose without a role.
36206 ^C, cancel the message. ^T, select a role from your other eligible roles.
36207 ========== h_norole_confirm ==========
36208 Return, compose without a role.
36209 ^C, cancel the message. ^T, select a role from your eligible roles.
36210 ========== h_custom_print ==========
36211 Enter a Unix command that accepts its data on standard input.
36212 Alpine will display any information the command sends to standard output.
36213 ========== h_convert_abooks_and_sigs ==========
36214 You will be given the opportunity to convert address books and signature files
36215 to remote configurations.
36216 ========== h_convert_abooks ==========
36217 You will be given the opportunity to convert address books to remote
36218 configurations.
36219 ========== h_flag_keyword ==========
36220 Enter the name of the keyword you want to add for this folder.
36221 No spaces, parentheses, braces, percents or asterisks are allowed.
36222 ========== h_select_keyword ==========
36223 Enter the keyword you want to match, or use ^T to select a keyword from a list
36224 of possible keywords for this folder. Use ! to look for non-matches instead.
36225 ========== h_type_keyword ==========
36226 Enter the keyword you want to add. You may add a nickname in the next step.
36227 No spaces, parentheses, braces, percents or asterisks are allowed.
36228 ========== h_type_keyword_nickname ==========
36229 Enter an optional nickname for the keyword you want to add.
36230 Type Carriage return to use the keyword name instead of a nickname.
36231 ========== h_convert_sigs ==========
36232 You will be given the opportunity to convert signature files to remote
36233 configurations.
36234 ========== h_convert_abook ==========
36235 Yes is fairly safe. You will be ADDing a remote address book that is a copy
36236 of the current address book. The current abook won't be removed automatically.
36237 ========== h_convert_sig ==========
36238 Answering Yes copies the contents of the signature file into your Alpine
36239 configuration file. After that, the contents of the file will not be used.
36240 ========== h_save_addman ==========
36241 Enter the simple name of the folder you want to add. Carriage return to
36242 accept what you have typed so far. ^C to get back to SELECT FOLDER screen.
36243 ========== h_reopen_folder ==========
36244 Yes reopens the folder, as if you were starting over. This uncovers new mail.
36245 No leaves the folder index as it was without discovering new mail.
36246 ========== h_convert_pinerc_server ==========
36247 This is the name of the host (computer) where the remote Alpine configuration
36248 will be stored. This should be an IMAP server that you have permission to use.
36249 ========== h_convert_pinerc_folder ==========
36250 Enter the correct remote folder name. This folder is special and should
36251 contain only configuration data. It shouldn't contain other mail messages.
36252 ========== h_role_compose ==========
36253 Compose a New message, Reply to current message, Forward current message, or
36254 Bounce message. Then you will be asked to choose one of your Roles to be used.
36255 ========== h_save_size_changed ==========
36256 The reported size of a message is not the same as the actual size. Answer Yes
36257 to continue and hope for the best or No to Cancel the entire Save.
36258 ========== h_select_by_larger_size ==========
36259 Enter a number or ^C to cancel. All messages greater than this many characters
36260 in size will be selected. Examples: 2176, 1.53K (1530), or 3M (3000000).
36261 ========== h_select_by_smaller_size ==========
36262 Enter a number or ^C to cancel. All messages less than this many characters
36263 in size will be selected. Examples: 2176, 1.53K (1530), or 3M (3000000).
36264 ========== h_preserve_field ==========
36265 Use 'p' to toggle between preserving or not preserving the original To:
36266 and Cc: fields of the message. Enter ^C to cancel message.