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-2017 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 216 2017-09-19 21:56:28
 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-2017 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 Bugs that have been addressed include:
 181 <UL>
 182    <LI> Crash when attempting to bounce a message due to lack of space in
 183         allocated space for key menu array. Reported by David Sewell.
 184
 185    <LI> Crash when a CA certificate failed to load, and user attempted to
 186         view certificate information of other certificate authorities.
 187
 188    <LI> Deactivate some color code from Pico (as standalone editor in the
 189         windows version) until I find a way to activate it again. This is
 190         not critical and it is not something that PC-Pico must have (some
 191         of it already exists in other ways, like color support, what does
 192         not exist is the more complex code that Unix-Pico has with color
 193         codes for specific colors.)
 194
 195    <LI> Update build.bat file to add /DWINVER=0x0501 so that Alpine can
 196         build when using Visual Studio 2017. Fix contributed by
 197         Ulf-Dietrich Braunmann.
 198 </UL>
 199
 200 <P>
 201 Version 2.21 addresses bugs found in previous releases and has several
 202 additions as well.
 203
 204 <P>
 205 Additions include:
 206 <UL>
 207   <LI> PC-Alpine: New configuration option "Aspell Dictionaries" allows a
 208        user to choose the dictionary used to spell check, in case the user
 209        communicates in more than one language. Examples of values for the
 210        variable are "en_US" or "de_DE", etc. Only the first 10
 211        dictionaries are offered.
 212
 213   <LI> Unix-Alpine: Connect securely to a LDAP server on a secure port.
 214        Based on a contribution by Wang Kang.
 215
 216   <LI> Colors configured in Alpine are inherited in the composer.
 217
 218   <LI> When Alpine is compiled with password file and SMIME support
 219        the password file is encrypted using a private key/public
 220        certificate pair. If one such pair cannot be found, one will be
 221        created. <A HREF="h_password_file_support">Learn more</A>.
 222
 223   <LI> Alpine builds with any version of OpenSSL greater than or equal
 224        to 1.0.0c. This includes version 1.1.0. Alpine also builds with
 225        LibreSSL.
 226
 227   <LI> New SHORTSUBJECT, SHORTSUBJKEY and SHORTSUBJKEYINIT token for index
 228        format, which removes text in the SUBJECT between &quot;[&quot; and
 229        &quot;]&quot;.
 230
 231   <LI> New SMARTTIME24 token for index screen. It is close to SMARTDATETIME
 232        but it differns in that it gives the time in which the message was
 233        sent for messages that are less than a week old. it uses a 24 hour
 234        format.
 235
 236   <LI> Alpine will include attachments when forwarding some
 237        multipart/alternative messages for which it did not use to include
 238        attachments.
 239
 240   <LI> New configuration option
 241        <a href="h_config_alt_reply_menu"><!--#echo var="FEAT_alternate-reply-menu"--></a>
 242        which adds more ways to control features and variables when you
 243        start to reply to a message.
 244
 245   <LI> Added support for RFC 2971 - IMAP ID extension.
 246
 247   <LI> Add configuration <A href="h_config_ignore_size"><!--#echo var="FEAT_ignore-size-changes"--></A>
 248        that allows users to ignore errors in the computation of the size
 249        of a message from defective servers.
 250
 251   <LI> SMIME: Upgrade the default signature digest from sha1 to sha-256, since
 252        clients such as Thunderbird do not validate signatures that use sha1 digest.
 253
 254   <LI> Add the configuration variable "default-directories", which is called
 255        <A href="h_config_history"><!--#echo var="VAR_default-directories"--></A>
 256        variable saves a list of directories that are readily accessible
 257        for save or export of attachments. This makes it easier to save
 258        attachments in directories that are hard to navigate to, or that
 259        are accessed frequently.
 260
 261   <LI> When a filename is attached and its name is encoded, the save
 262        attachment command will offer to save the file in the encoded form.
 263        This might work for some users, but the save command will have a
 264        subcommand ^N to decode the file name and save the file with the
 265        decoded name.
 266
 267   <LI> The TAB key allows autocomplete in the Fcc field in the composer headers,
 268        as well as autocompletes automatically when only one possibility exists
 269        for the ^J attach command.
 270
 271   <LI> Add support for the &quot;TYPE&quot; and &quot;VALUE&quot; attributes of
 272        the html OL tag.
 273
 274   <LI> Ignore message from smtp server after a successful authentication
 275        challenge.
 276
 277   <LI> When a message is saved in the Form Letter folder, add the ability
 278        to save the role being used to compose such message so that settings
 279        such as the SMTP server set in the role can be used when sending
 280        such form message. Suggested and patched by Frank Doepper.
 281
 282   <LI> If SSLDIR is defined somehow, do not disable S/MIME if the
 283        SSLCERTSDIR is not found.
 284
 285   <LI> When Alpine sends an attachment, it will set the boundary attribute
 286        in lower case, as some SMTP servers, such as those of libero.it
 287        reject messages if the boundary attribute is in uppercase.
 288
 289   <LI> Add the ability to change the private key and certificates used
 290        to encrypt a password file in the SMIME setup configuration screen.
 291        <A HREF="h_config_smime_password_file_certificates">Learn more</A>
 292
 293   <LI> SMIME: The ctrl-E command that gives information on the certificate
 294        is only available for messages that have a signed or encrypted
 295        part.
 296
 297   <LI> SMIME: If a message contains a RFC822 attachment that is
 298        signed/decrypted add the ability to view its SMIME information.
 299
 300   <LI> SMIME: Certificate information in the S/MIME screen is available
 301        for certificates stored in a container.
 302
 303   <LI> SMIME: Offer the common name of the person, instead of the name of
 304        file containing the certificate, as the name to be displayed in the
 305        certificate management screen for certificate authorities.
 306        Suggested by Matthias Rieber.
 307
 308   <LI> SMIME: Management of several alternate name (SAN) certificates is
 309        improved. When importing a SAN certificate, also import a certificate
 310        for the filename, besides for the e-mail addresses in the
 311        certificate. Suggested by Matthias Rieber.
 312
 313   <LI> SMIME: add full year when displaying information about a certificate
 314        in the certificate management screen. Suggested by Matthias Rieber.
 315
 316   <LI> SMIME: sort certificates by some type of alphabetical order in the
 317        displayed name.
 318
 319   <LI> SMIME: Alpine will ask users if they wish to save S/MIME
 320        certificates included in signatures, when the option "Validate
 321        Using Certificate Store Only" is enabled. If the user does not wish
 322        to save it, validation will fail.
 323
 324   <LI> HTML: Add support for decoding entities in hexadecimal notation.
 325        Suggested by Tulip&aacute;nt Gergely.
 326
 327   <LI> The &quot;#&quot; command, when used as part of an aggregate
 328        operation will allow users to select the role used in either
 329        replying, forwarding or replying to the group of selected messages,
 330        Suggested by Hisashi T Fujinaka.
 331
 332   <LI> If the charset of a message can not be determined, use the value set
 333        in the <A HREF="h_config_unk_char_set"><!--#echo var="VAR_unknown-character-set"--></A> for its value.
 334
 335   <LI> Resizing setup screen will redraw screen.
 336
 337   <LI> Unix Alpine only. Experimental: If Alpine/Pico finds a UCS4 code
 338        in the width ambiguous zone, it will use other means to determine
 339        the width, such as call wcwidth.
 340
 341   <LI> Pico: Code reorganization in the search command to make it easier to
 342        add subcommands of the search command.
 343
 344   <LI> Pico: Search command can do a case sensitive match. Use the Ctrl-^
 345        subcommand of the search command to bring this choice into view.
 346
 347   <LI> Pico: Add the ability to search for strings in the beginning or end
 348        of a line. Use the Ctrl-^ subcommand of the search command to bring
 349        this choice into view.
 350
 351   <LI> For a multipart/alternative message, the Take Address command will
 352        work on the part that is being read.
 353
 354   <LI> When sending a message, allow for 512 characters of consecutive
 355        non-white space before folding the subject line.
 356
 357   <LI> Make sure titlebar (the line at the top of the screen) always
 358        contains the name of the folder/newsgroup that is open, if this
 359        fits in the title.
 360
 361   <LI> The feature <a href="h_config_scramble_message_id">FEATURE: <!--#echo var="FEAT_scramble-message-id"--></a>
 362        will also scramble the name, version and operating system in the
 363        message-id header. Based on a contribution by Dennis Davis, which
 364        is itself based on a contribution by Mark Hills.
 365
 366   <LI> Change in logic in imap_set_password function to make Alpine ask if
 367        a user wants to save a password before reading the password file.
 368
 369   <LI> When exporting all parts of a message, if two attachments have the same
 370        name, do not overwrite a file more than once, but instead add a counter
 371        number to the filename to make a new file that does not exist in the file
 372        system.
 373
 374   <LI> Add the Control-R subcommand to the save command for attachments.
 375        This subcommand toggles if the saving will be done in binary mode
 376        for text attachments. When a user saves an attachment using binary
 377        mode it will be saved as it was sent, otherwise the attachment will
 378        be transformed to UTF-8 for further transformation through internal
 379        and user defined filters for saving.
 380
 381   <LI> Add command line argument -smimedir, which allows to specify
 382        the default path for a directory that contains the public, private,
 383        and ca directories. This is useful in case a user has a backup of
 384        old certificates that cannot be installed in the ~/.alpine-smime
 385        dir.
 386
 387   <LI> Reimplementation of the code that allows the .pinerc file to be a
 388        symbolic link by Kyle George from tcpsoft.com to use realpath.
 389
 390   <LI> When saving an attachment, the "^T" command leads to a screen where the
 391        "A" command can be used to add a file. A directory can be added by
 392        pressing "^X" after the "A" command. Added after a suggestion by
 393        Stefan Goessling.
 394
 395   <LI> When saving an attachment, the ^Y and ^V commands allow a user to
 396        scroll through the history of directories used to save attachments,
 397        while preserving the given name of the file. Suggested by Peter
 398        Koellner.
 399
 400   <LI> SMIME: Turn off automatic signing and encrypting of a message when
 401        bouncing. Suggested after a discussion with Matthias Rieber.
 402
 403   <LI> When messages are selected, warn the user if a message that is not
 404        selected will be bounced, or if not all selected messages will be
 405        bounced. Suggested by Ulf-Dietrich Braumann.
 406
 407   <LI> The bounce command adds a subcommand to choose a role.
 408
 409   <LI> When selecting messages by number, the &quot;.&quot; character can
 410        be used to specify the message on which the cursor is on.
 411
 412   <LI> When Alpine opens an attachment, it sometimes changes the extension
 413        of the file that is being opened and replaces it by another for the
 414        same mime type. If Alpine finds that the extension of the file
 415        corresponds with the mime type, according to the mime-types file,
 416        then it will keep it, and no substitution will be made.
 417
 418   <LI> Set no restrictions on the length of encoded subjects, but encode
 419        words in length of no more than 75 characters.
 420 </UL>
 421
 422
 423 <P>
 424 Bugs that have been addressed include:
 425 <UL>
 426   <LI> SMIME: Crash when a certificate has an invalid date of validity. Also
 427        Alpine will use the function ASN1_TIME_print to determine the date
 428        of validity. Reported by Ben Stienstra.
 429
 430   <LI> SMIME: Crash when attempting to unlock the password file and an
 431        incorrect password is entered.
 432
 433   <LI> SMIME: Crash when checking the signature of a message that contains
 434        a RFC822 attached message. Reported by Holger Trapp and Bj&ouml;rn
 435        Krellner.
 436
 437   <LI> SMIME: Cancelling entering password to unlock key will not reprompt.
 438
 439   <LI> SMIME: fix a bug that did not allow users to transfer certificates to
 440        remote containers. Reported by Matthias Rieber.
 441
 442   <LI> SMIME: certificates included in messages were not being transferred
 443        to a remote container.
 444
 445   <LI> SMIME: Crash if public certificates are located in an inaccessible
 446        remote server and the private key is not available.
 447
 448   <LI> SMIME: Alpine does not remove temporary files created when adding a
 449        CA certificate to a container. Reported by Holger Trapp.
 450
 451   <LI> SMIME: When reading a local certificate, Alpine converts the name
 452        of the certificate to lowercase, which may make Alpine not be able
 453        to read such certificate. Reported by Dennis Davis.
 454
 455   <LI> SMIME: If the option "Remember S/MIME Passphrase" is disabled, then
 456        entering a password to read an encrypted message will make Alpine
 457        forget the key and not ask the password to unlock it again in case
 458        it is necessary to unlock it again. Reported by Ulf-Dietrich
 459        Braumann.
 460
 461   <LI> Alpine would use freed memory while trying to compute the color
 462        of the titlebar. This happened when trying to continue a postponed
 463        message.
 464
 465   <LI> Alpine failed to read an encrypted password file if too many
 466        passwords were saved in the password file.
 467
 468   <LI> When selecting messages while in Threaded Index Screen, some
 469        messages other than top of threads could appear in the index, making
 470        Alpine display messages &quot;out of the screen.&quot;
 471
 472   <LI> The index format would be chopped at the position of an unrecognized
 473        token, instead of skipping the token as intended.
 474
 475   <LI> Work in progress: Avoid calling non-safe functions when Alpine
 476        receives a signal. See bug report
 477        <A HREF="https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=825772">here.</A>
 478
 479   <LI> Crash when attempting to read a message after a bounce command.
 480        In order to produce a crash one needed to use the ^T subcommand and
 481        do a search in a LDAP directory. The crash is produced by changes
 482        to the text in the title bar. Reported by Heinrich Mislik in the
 483        Alpine-info list.
 484
 485   <LI> HTML messages that contain UTF-8 may wrap at the wrong position,
 486        making Alpine not display the correct character at the position
 487        that wrapping is done. Reported by Wang Kang.
 488
 489   <LI> Pico: Searching for a string that is too long causes Pico to crash
 490        in the next search.
 491
 492   <LI> Fix vulnerability in regex library. This only affects those who use
 493        this library, such as the windows version of Alpine. See
 494        <A HREF="http://www.kb.cert.org/vuls/id/695940">http://www.kb.cert.org/vuls/id/695940</A>
 495        for more details.
 496
 497   <LI> Alpine would not set include and lib paths for OpenSSL if this was
 498        installed in /usr/local/ssl.
 499
 500   <LI> If the .pinerc file is a symbolic link, Alpine might not write its
 501        contents when saving its configuration.
 502
 503   <LI> The _INIT_ token does not skip over non-alphanumeric characters in
 504        the name. Reported by Andreas Fehr.
 505
 506   <LI> When opening an INBOX folder in a context different from the
 507        incoming folders collection, from the command line, Alpine would
 508        open the INBOX folder from the incoming folders collection.
 509
 510   <LI> Mismatch in size of UCS and CELL caused a corruption in the
 511        content of a pointer, which made the speller in PC-Alpine get the
 512        content of a word incorrectly.
 513
 514   <LI> Skip testing openssl compatibility version when cross-compilation
 515        is detected. Fix contributed by Antti Sepp&auml;l&auml;
 516
 517   <LI> Alpine fails to remove temporary files used during a display or sending
 518        filter. Fix contributed by Phil Brooke.
 519
 520   <LI> When the index is in zoomed state, adding new messages to the
 521        selection would not show those messages if those messages are on
 522        top of the current message in the top of the screen. Reported by
 523        Ulf-Dietrich Braumann. In addition, when the user scrolls through
 524        the index, this scroll smoothly, without jumping pages. Reported
 525        by Holger Trapp.
 526
 527   <LI> Crash when reviewing history of saving attachments.
 528
 529   <LI> Crash when canceling a goto command on a local collection that has
 530        not been expanded and attempting to expand such collection.
 531
 532   <LI> Crash in Pico when forwarding messages that contain a direction mark
 533        at the end of a line. Reported by James Mingo.
 534
 535   <LI> Solve compilation errors when Alpine is built with Visual Studio 2015.
 536 </UL>
 537
 538
 539 <P>
 540 Version 2.20 addresses bugs found in previous releases and has several
 541 additions as well.
 542
 543 <P>
 544 Additions include:
 545 <P>
 546
 547 <UL>
 548   <LI> Upgrade UW-IMAP to Panda IMAP from
 549        <A HREF="https://github.com/jonabbey/panda-imap">https://github.com/jonabbey/panda-imap</A>.
 550   <LI> S/MIME: Add screen to manage certificates.
 551   <LI> S/MIME: Signatures are validated using the user's certificates instead
 552        of the ones included in the message. Behavior can be disabled by
 553        disabling the option <A href="h_config_smime_use_cert_store">
 554         <!--#echo var="FEAT_smime-use-storey-only"--></A>, which is enabled
 555        by default.
 556   <LI> S/MIME: sign messages using intermediate certificates when needed
 557        and possible.
 558   <LI> S/MIME: validation of certificates for servers that modify signed
 559        content.
 560   <LI> S/MIME: signed and encrypted messages will be signed first and
 561        encrypted second, so that they can be decoded by other clients.
 562   <LI> S/MIME: add the sender certificate to the list of certificates in
 563        encrypted messages to make it possible for the sender to decrypt
 564        the message they sent.
 565   <LI> S/MIME: When transferring certificates to a local container, create
 566        container with default names PublicContainer, PrivateContainer and
 567        CAContainer, as appropriate for these files, unless the user has
 568        provided some other names.
 569   <LI> S/MIME: Forwarding a message will include the signed part as part
 570        of the text and not as a multipart message, just as the reply
 571        command does.
 572   <LI> HTML: Style tag in body of html message causes Alpine to not write
 573        its content until a new &lt;/style&gt;
 574   <LI> HTML: &lt;BR&gt;, &lt;BR /&gt;, and &lt;BR/&gt; are considered
 575        the same inline tag; the same is valid for the &lt;HR&gt; tag.
 576   <LI> Add support to selective expunge through a subcommand of the
 577        select-apply commands. Read more in the <A
 578        HREF="h_index_cmd_expunge">help</A> for the expunge command.
 579   <LI> Pico: New subcommand of the search command, allows to reverse the
 580        direction of search.
 581   <LI> Unix Alpine: If a password file is defined, and S/MIME is enabled,
 582        the key and certificate used to encrypt the password file are saved
 583        in the ~/.alpine-smime/.pwd directory, or in the directory specified
 584        by the -pwdcertdir command line option.
 585        <A HREF="h_password_file_support">Learn more</A>.
 586   <LI> Add /tls1, /tls1_1, /tls1_2 and /dtls1 to the definition of a
 587        server to use different ways to connect using ssl, for
 588        example {server.com/tls1} will attempt to connect to
 589        server.com at the ssl imap port (port 993) and establish a
 590        connection using TLSv1. These flags can be used in
 591        conjunction with the /ssl flag, the ssl flag is redundant.
 592        Conversely, however, the /ssl flag does not imply any of
 593        these flags; the /ssl flag means SSLv3 or, if not available,
 594        SSLv2 in the SSL port.
 595   <LI> Alpine does not attempt to automatically reopen a collection
 596        that was not opened due to cancellation by the user.
 597        Instead, the user must try to open it explicitly.
 598   <LI> Alpine searches for a certificate that matches an email address in
 599        all addresses in a certificate (instead of just the first
 600        one) but when it tries to unlock the certificate, it asks
 601        for the password for the first email address in that
 602        certificate.
 603   <LI> Style tag in body of html message causes Alpine to not write its content
 604        until a new &lt;/style&gt;
 605   <LI> Experimental: Write the content-type of a message in
 606        lowercase, as some non-compliant servers do not understand
 607        uppercase content-type, such as those of GMX.de.
 608   <LI> Experimental: Do not send the RSET command before attempting
 609        to send a message, as this causes a delay in some evily managed
 610        servers.
 611   <LI> Opening a folder updates recent count in maildrops (this
 612        already works for other types of folders)
 613   <LI> Automatically redraw screen after opening an attachment
 614        instead of simply clearing it.
 615   <LI> Pico: Justification works without need of a predefined quote
 616        string. This allows justification of blocks of text that are
 617        indented with spaces.
 618   <LI> Decode the name of attachment names, so they can be written as part
 619        of the description of the part.
 620   <LI> Check bounds and tie strings off to improve security. Contributed
 621        by James Jerkins.
 622   <LI> Replace tabs by spaces in From and Subject fields to control for
 623        size in screen of these fields. Change only in index screen display.
 624   <LI> Aggregate operations allows bouncing a list of messages using a role.
 625        Suggested by Ulf-Dietrich Braumann.
 626   <LI> Disable saving new passwords to the password file. Implemented
 627        by Louis Raphael from dpslabs.com. <A HREF="h_config_disable_password_file_saving">Learn more.</A>
 628   <LI> Makefile: Add $(LIBINTL) to the flags to link rpdump, rpload,
 629      alpined and alpineldap because MAC OSX 10.8 x86_64 needs it. Reported by
 630      Charles M. Register.
 631 </UL>
 632
 633
 634 <P>
 635 Bugs that have been addressed include:
 636 <UL>
 637   <LI> Fix _INIT_ token for reply quote string to include support for 8-bit
 638        in personal names. Reported by Lev Gorenstein.
 639   <LI> When writing the .pinerc file, lines were truncated if they were longer
 640        than 10,000 characters. This could cause data corruption, so now lines
 641        are allowed to be of any length.
 642   <LI> In Unix Alpine (but not in MAC OSX) fix a problem that made Alpine
 643        remove attachments before they were open by a mailcap viewer. It
 644        requires that the user has an equivalent to a command such as "ps
 645        auxww" to list the list of processes, and check if there is any
 646        program using the attachment. The default is "/bin/ps auxww", but
 647        it can be changed at compile time with the option --with-ps-cmd.
 648        See the help of the variable
 649        <a href="h_config_psleep"><!--#echo var="VAR_mailcap-check-interval"--></a>
 650        for more information.
 651   <LI> S/MIME: signed messages that contained an attachment would not validate.
 652   <LI> S/MIME: signed and encrypted messages from Thunderbird would not
 653        validate. Thanks to Andreas Schamanek for testing, debugging and
 654        advising during the process of fixing this problem.
 655   <LI> S/MIME: Forwarding messages with multipart content-type failed to be signed
 656        with &quot;Error writing pipe&quot; message. Reported by Andreas Schamanek
 657        and Stefan Mueller.
 658   <LI> S/MIME: Certificates are lost when using a pinerc file outside of the
 659        home directory.
 660   <LI> S/MIME: Accessing the S/MIME configuration screen would deinitialize
 661        SMIME making it not possible to sign or encrypt messages.
 662   <LI> S/MIME: Forwarding a signed message might make the body contain mime
 663        information that is not part of the body, and hence making the body
 664        of the message seem wrong.
 665   <LI> S/MIME Alpine would compute incorrectly the signature of a message
 666        that contains 8bit if the option "Enable 8bit ESMTP Negotiation" is
 667        enabled, the message contains 8bit characters and the smtp server
 668        supports 8bit sending.
 669   <LI> When replying to several messages, subject will be decoded first,
 670        and then stripped from re/fwd before they are compared to determine
 671        the subject of the replied message.
 672   <LI> Crash when tcp connection to NNTP server was lost after connection
 673        had been established, but lost immediately afterwards.
 674   <LI> Crash with message &quot;lock when already locked&quot;, when painting
 675        an index was based on scores that needed information from a remote
 676        addressbook in the same server as the folder opened. Reported by
 677        Peter Koellner.
 678   <LI> Crash in message/rfc822 attachments encoded in base64.
 679   <LI> Postponed messages whose content-type is text/html, text/enriched and
 680        text/richtext are sent with that content-type, even though, after
 681        resuming composition, Alpine had changed its type to text/plain.
 682   <LI> Alpine cannot handle correctly some characters in the Windows-1256
 683        character set, which might lead to a crash or a corruption in the
 684        screen. Work was done to contain the bug. A more complete fix will
 685        be done in a future release. Reported by Professor Robert Funnell.
 686   <LI> WebAlpine: add _GNU_SOURCE to make pubcookie build.
 687   <LI> WebAlpine: fail to build with debug disabled. Fix from Sam Hathaway.
 688   <LI> Save command did not warn of existence of a message with a deleted
 689        attachment in an aggregate save, unless cursor was positioned on a message
 690        with a deleted attachment. Reported by Florian Herzig.
 691   <LI> Transformation of UTF-8 to MUTF7 was not being done when creating a folder
 692        in an IMAP server.
 693   <LI> DATE tokens were not internally transformed to UTF-8, which made their
 694        values not appear complete in the screen. Reported by Werner Scheinast.
 695   <LI> Fixes to configure script so that it will not require PAM for every system.
 696   <LI> Fix to configure script so that it will use CPPFLAGS instead of
 697        CPPCFLAGS, and so the --with-ssl-include-dir option take effect
 698        during the build. Fix by Ulf-Dietrich Braumann.
 699   <LI> Fix in WebAlpine: do not use deprecated dereference in pointer,
 700        needs to use tcl_getstringresult() instead. Reported by
 701        Ulf-Dietrich Braumann.
 702   <LI> Quoted string in URL Viewers configuration variable were not
 703        unquoted before passing to viewer.
 704   <LI> Fix in configure script to detect location of tcl library; add
 705        /usr/local in FreeBSD and fix a bug in configure script that used
 706        $alpine_TCLINC instead of $alpine_TCLINC/tcl.h. Reported and fixed
 707        by Werner Scheinast.
 708   <LI> Move SSL configurations from UW-IMAP to configure script, and
 709        update OpenSSL configuration for Mac OS X.
 710   <LI> Remove -lregex from linker flags when building --with-supplied-regex.
 711   <LI> When the download of an attachment is interrumpted, Alpine stills
 712      caches what was downloaded, making the download incomplete for
 713      subsequent calls of Alpine attempting to open the attachment. In the
 714      future, Alpine will not cache any downloaded part of the attachment
 715      when it is interrupted.
 716 </UL>
 717 <P>
 718
 719
 720 <P>
 721 Version 2.11 addresses bugs found in previous releases and has a few
 722 additions as well.
 723
 724 <P>
 725 Additions include:
 726 <P>
 727
 728 <UL>
 729    <LI> Alpine requires version 1.0.0c of Openssl to build.
 730    <LI> Increase encryption of S/MIME encrypted messages.
 731    <LI> Pico: Improvements in justification of paragraphs: lines that begin
 732 with a quote string, followed by a space were considered individual paragraphs,
 733 now they are considered part of a paragraph. Based on earlier joint work
 734 with Jeff Franklin.
 735    <LI> Unix Alpine: Allow local .pinerc file to be a symbolic link.
 736    <LI> Experimental extended support of recognition of UTF-8 in urls based on
 737 information from <A HREF="http://url.spec.whatwg.org">http://url.spec.whatwg.org</A>.
 738    <LI> Added recognition of ws and wss URIs.
 739    <LI> Add ability to <A HREF="h_config_folder_color">color folder names</A>,
 740  <A HREF="h_config_directory_color">directory names</A>,
 741  and <A HREF="h_config_folder_list_color">text</A> in the FOLDER SCREEN.
 742    <LI> Add the ability to <A HREF="h_config_indextoken_color">color any token</A>
 743 used in the display of the INDEX SCREEN.
 744    <LI> New option <A HREF="h_config_preserve_field"><!--#echo var="FEAT_preserve-original-fields"--></A>
 745 that adds the ability to preserve To: and Cc: fields when replying to a
 746 message, as specified by original sender.
 747    <LI> Add a _SILENT_ token to the <A HREF="h_config_display_filters">list of tokens</A>
 748  for a display filter, so that Alpine will not redraw the screen when it is unnecessary.
 749    <LI> Quota command includes subcommands for printing, forwarding, etc.
 750 </UL>
 751
 752 <P>
 753 Bugs that have been addressed include:
 754 <P>
 755 <UL>
 756   <LI> Crash when a non-compliant SMTP server closes a connection without a QUIT command.
 757   <LI> Crash when resizing the screen in a configuration screen.
 758   <LI> Do not bail out during a tcp timeout, instead close connection and avoid crash.
 759   <LI> Do not use a shell to open a browser.
 760   <LI> Configure script did not test for crypto or pam libraries.
 761   <LI> Configure script attempted to build web component, even if header file tcl.h was not present.
 762   <LI> Change Cygwin directory separator to &quot;/&quot;.
 763   <LI> Alpine could set List- headers, contrary to RFC 2369.
 764 </UL>
 765
 766 <P>
 767 Version 2.10 addresses bugs found in previous releases and has a few
 768 additions as well.
 769
 770 <P>
 771 Additions include:
 772 <P>
 773
 774 <UL>
 775    <LI> Quota report for IMAP folders that support it (press the &quot;@&quot; command in the index screen of such folder).
 776    <LI> Search a folder for the content of any header with the &quot;;&quot; command.
 777    <LI> Foreign characters are decoded correctly in IMAP folder names.
 778    <LI> Question about breaking connection to slow servers includes their name.
 779    <LI> Internal x-alpine-help: resource locator for sending links to internal help.
 780    <LI> OpenSuse: Alpine find location of OpenSSL certificates.
 781    <LI> Cygwin: Alpine builds without need of patch.
 782    <LI> Recognition of proper mime type for docx, xlsx, and pptx files.
 783    <LI> When composing a message, Alpine will create a new thread when the subject is erased.
 784    <LI> Add support for strong encryption of password file when S/MIME is built in.
 785 </UL>
 786
 787 <P>
 788 Bugs that have been addressed include:
 789 <P>
 790
 791 <UL>
 792    <LI> Alpine will close a folder after confirming with user their intention and not reopen it.
 793    <LI> Double allocation of memory in Pico.
 794    <LI> Alpine does not give warning of message sent and posted upon receipt by email of message posted in newsgroup.
 795    <LI> Handling of STYLE html parameter may make Alpine not display the content of a message.
 796    <LI> Not recognition of environment variables in some options.
 797    <LI> Not display of login prompt during initial keystrokes.
 798    <LI> justification of long urls breaks them.
 799    <LI> Incorrect New Mail message when envelope is not available.
 800    <LI> Incorrect display of PREFDATE, PREFDATETIME and PREFTIME tokens.
 801    <LI> Crash when resizing the screen after display of LDAP search.
 802    <LI> Crash when redrawing screen while opening a remote folder collection.
 803    <LI> Infinite loop in scrolltool function during notification of new mail.
 804    <LI> No repaint of the screen after midnight was done when the SMARTDATE token is used in the index screen.
 805    <LI> No display of signed and encrypted S/MIME messages.
 806    <LI> Alpine will not build with OpenSSL.
 807    <LI> Crash for double locking in calls to c-client.
 808    <LI> Bad recognition of mime-encoded text may make Alpine not print the subject of a message.
 809    <LI> Ignore the references header when threading messages
 810    <LI> No update of colors in index screen after update to addressbook.
 811 </UL>
 812
 813 <P>
 814 Version 2.01 addresses bugs found in previous releases and has a few
 815 additions as well.
 816
 817 <P>
 818 Additions include:
 819 <P>
 820
 821 <UL>
 822    <LI> Fixed non-ASCII web alpine handling
 823    <LI> Added web alpine help.
 824    <LI> Allow web alpine inbox on second IMAP server.
 825    <LI> Allow web alpine config reset after bad inbox-path gets set.
 826    <LI> Added web alpine ability to create group contact from contact list members.
 827    <LI> Backed out web alpine coercing of default sort-key of arrival to date/reverse.
 828    <LI> Tidied up web alpine script layout.
 829    <LI> Fixed web alpine status message ordering
 830    <LI> Added web alpine Fcc setting via Contacts in Compose
 831    <LI> Fixed web alpine autodraft attachment issues
 832    <LI> Fixed web alpine problems with recent count maintenance
 833    <LI> Fixed web alpine newmail arrival display in message list
 834    <LI> Added web alpine confirmation to folder create for Move/Copy
 835    <LI> Added web alpine user-domain support
 836    <LI> Fixed web alpine to support INBOX-within-a-collection deletion
 837 </UL>
 838
 839 <P>
 840 Bugs that have been addressed include:
 841 <P>
 842
 843 <UL>
 844    <LI> In web alpine fixed delete all selected within a search result to reorient
 845         correctly to whole-mailbox message list.
 846    <LI> Fixed web alpine delete in view page to be sensitive to sort
 847    <LI> Fixed web alpine open of folder within directory from folder manager page.
 848    <LI> Fixed web alpine open of folder within directory from left column's recent cache.
 849    <LI> Fixed web alpine problems with spaces in special folder names like Drafts
 850    <LI> Fixed web alpine adding contacts from message list and view
 851    <LI> Fixed web alpine create of non-existent fcc
 852    <LI> Remove mistakenly left debugger statement in web alpine javascript.
 853    <LI> Some UNIX alpine build problems fixed
 854    <LI> Crash in pico and pilot when nl_langinfo returned something unrecognizable
 855         or NULL. Add recognition of "646" to nl_langinfo wrapper. This is returned
 856         by locale charmap call on some Solaris 8 systems.
 857    <LI> MacOS Keychain logins were not working correctly with generic host names, like
 858         imap.gmail.com, as opposed to specific instances like rx-in-209.google.com, causing
 859         new password requests when not needed
 860    <LI> Possible crash in WhereIs command while in FOLDER LIST when cursor is located on the
 861         last folder in the list
 862    <LI> Change to S/MIME get_x509_subject_email so that X509v3 alternative names are
 863         looked for along with the email address
 864    <LI> Changes to configure to get spellcheck options with work with arguments.
 865    <LI> Add change from Mark Crispin of panda.com to at least minimally handle non-ascii hostname
 866         returned by gethostname (iPhone can do this)
 867    <LI> Fixed a bug that prevents a filter that moves a message into a local folder
 868         from also setting the DELETE flag in that moved message. Fix from Eduardo Chappa.
 869    <LI> Changed size of shellpath in open_system_pipe from 32 to MAXPATH. Fix from
 870         Jake Scott of marganstanley.com.
 871    <LI> Buffer overflow bug in c-client's tmail/dmail, fix from Mark Crispin. This
 872         is not used in alpine.
 873    <LI> Imapd server crash from unguarded fs_give in IDLE code, fix from Crispin.
 874         Apparently this causes RIM Blackberry BIS service problems. This is not
 875         used in alpine.
 876    <LI> Tmail uninitialized pointer fix from Neil Hoggarth. Not used in alpine.
 877    <LI> Buffer overflow possibility in RFC822BUFFER routines in c-client library.
 878         Fix from Ludwig Nussel of SUSE and from Crispin.
 879    <LI> Include whole filename in export filename history
 880    <LI> Fix display bug in pico when Replace command is canceled. Fix from Eduardo Chappa.
 881 </UL>
 882
 883 <P>
 884 Version 2.00
 885 addressed bugs found in previous releases and had a few additions as well.
 886 <P>
 887 Additions included:
 888 <P>
 889
 890 <UL>
 891    <LI> Redesigned Web Alpine interface
 892    <LI> Experimental <A HREF="h_mainhelp_smime">S/MIME support</A> added
 893         in UNIX versions of Alpine
 894    <LI> Attempt to include the attachment filename as part of the name of the
 895         temporary file used when viewing an attachment with an external program.
 896         Add some randomness to that filename to make it hard to predict the filename.
 897         Add a filename extension, usually derived from the type/subtype, to the
 898         temporary filename. This was previously done only on Windows and MacOS X.
 899    <LI> Enhance address completion in the composer (TAB command) so that it looks
 900         through nicknames, fullnames, and addresses from the address book; addresses
 901         from the message being viewed, if any; and the results from
 902         <A HREF="h_direct_config">LDAP Directory Server</A>
 903         lookups for all of the defined directory servers that have the
 904         <A HREF="h_config_ldap_opts_impl">&quot;Use-Implicitly-From-Composer&quot;</A>
 905         feature set.
 906    <LI> Make the default character set setting more liberal in what it will accept
 907         from the UNIX nl_langinfo call and the various values of LANG seen in the wild
 908    <LI> Remove the Alpine revision number from the titlebar in released versions
 909         while leaving it there in snapshot versions
 910    <LI> Add a <A HREF="h_config_quell_asterisks">feature</A> to suppress the
 911         display of asterisks when you type a password for Alpine
 912    <LI> Add line wrapping when displaying <EM>PRE</EM> formatted sections of HTML
 913    <LI> When the
 914         <A HREF="h_config_dates_to_local"><!--#echo var="FEAT_convert-dates-to-localtime"--></A>
 915         feature is turned on convert not only the dates in the index screen but also
 916         the dates in the MESSAGE VIEW
 917 </UL>
 918
 919 <P>
 920 Bugs addressed in the 2.00 release included:
 921 <P>
 922
 923 <UL>
 924    <LI> Crash when using tab-completion for selecting a Save filename
 925    <LI> Make Web Alpine help text images relative for more portability
 926    <LI> Fixed attach save of html parts in Web Alpine
 927    <LI> Viewing, printing, exporting, replying, and bouncing of message
 928         digests was broken. Replying and bouncing should not have been
 929         allowed at all for digests. It would be nice to have a more standard
 930         index-like view of a message digest but that has not been addressed
 931         with this minor bug fix.
 932    <LI> Adjust wrapping of HTML messages so that the margins specified by
 933         <A HREF="h_config_viewer_margin_left"><!--#echo var="VAR_viewer-margin-left"--></A> and
 934         <A HREF="h_config_viewer_margin_right"><!--#echo var="VAR_viewer-margin-right"--></A>
 935         are observed correctly
 936    <LI> Interrupt of WhereIs command in index was broken
 937    <LI> The <A HREF="h_config_unk_char_set"><!--#echo var="VAR_unknown-character-set"--></A>
 938         option did not work correctly interpreting unknown characters in message headers
 939    <LI> Long address lines could cause blank continuation lines
 940    <LI> Save to a local default INBOX failed if the primary collection was also local,
 941         which it is by default. The save went to  ~/mail/inbox instead.
 942    <LI> Make a default save folder of &quot;inbox&quot; always mean the real
 943         inbox, not the inbox in the primary collection
 944    <LI> Address book entries with lots of addresses would be truncated when
 945         entered in the composer with a screen size wider than 270 or so charcters
 946    <LI> Some fields in the index screen were truncated when the screen width was
 947         wider than 256 characters
 948    <LI> Crash when TABing to next folder, the next folder with new mail is a POP
 949         folder, and there is a more than 10 minute pause between typing the TAB
 950         and typing the Yes
 951 </UL>
 952
 953 <P>
 954 Version 1.10(962)
 955 addressed bugs found in previous releases and had a few additions as well.
 956 <P>
 957 Additions included:
 958 <P>
 959
 960 <UL>
 961    <LI> Add the possibility of setting a default role
 962         (see <A HREF="h_role_select">Roles Screen</A>)
 963         which may be convenient if your work flow involves acting in one
 964         role for a while then switching to another role and staying in the
 965         new role for another period of time
 966    <LI> When Saving and the IMAP server problem &quot;Message to save shrank!&quot;
 967         is encountered, ask the user if he or she wants to continue with the
 968         risky Save anyway instead of aborting. This may be helpful if your
 969         IMAP server is broken in this way but be aware that it is possible there
 970         was a real error instead of just a broken server implementation.
 971    <LI> Some configure adjustments for Kerberos detection and
 972         for SCO OpenServer 5 support
 973    <LI> Hide INBOX in a collection if it also appears as an
 974         <A HREF="h_config_enable_incoming">Incoming Folder</A>
 975    <LI> Show asterisks for feedback when the user is typing a password
 976    <LI> Performance improvement for threading of large folders
 977    <LI> Previously, the search used to find
 978         Pattern matches containing To patterns searched for both To
 979         and Resent-To headers. The relatively complicated search this
 980         produces causes problems when using some deficient IMAP servers.
 981         Now the default is to look only for To headers and ignore the
 982         presence of Resent-To. The previous behavior may be restored
 983         with the <A HREF="h_config_use_resentto"><!--#echo var="FEAT_use-resent-to-in-rules"--></A> feature.
 984    <LI> Add an
 985         <A HREF="h_config_unk_char_set"><!--#echo var="VAR_unknown-character-set"--></A>
 986         to help with reading malformed unlabeled messages
 987    <LI><A HREF="h_config_suppress_user_agent"><!--#echo var="FEAT_suppress-user-agent-when-sending"--></A> option added
 988    <LI> Map some Shift-LeftArrow escape sequences to LeftArrow
 989    <LI> Add feature <A HREF="h_config_warn_if_fcc_blank"><!--#echo var="FEAT_warn-if-blank-fcc"--></A>
 990 </UL>
 991
 992 <P>
 993 Bugs addressed in the 1.10(962) release included:
 994 <P>
 995
 996 <UL>
 997    <LI> Crash when encountering certain errors from an SMTP server
 998    <LI> Crash in composer caused by overflow in replace_pat()
 999    <LI> Hang when authenticating to an SMTP server that fails with a
1000         &quot;connection disconnected&quot; error
1001    <LI> Bug in handling of trailing tab character in flowed text
1002    <LI> Security enhancement for mailcap parameter substitution
1003    <LI> <A HREF="h_config_strip_sigdashes"><!--#echo var="FEAT_strip-from-sigdashes-on-reply"--></A>
1004         did not work if the message being replied to was not flowed text
1005         and <A HREF="h_config_quell_flowed_text"><!--#echo var="FEAT_quell-flowed-text"--></A>
1006         was not turned on
1007    <LI> Don't allow printer to be changed through hidden config screen
1008         if system administrator didn't want it to be allowed
1009    <LI> Attempts are sometimes made to set the Forwarded flag when alpine
1010         should know that it won't work, causing error messages to appear
1011    <LI> A <A HREF="h_config_reply_indent_string"><!--#echo var="VAR_reply-indent-string"--></A>
1012         of double-quote double-quote didn't work right
1013    <LI> Quoting wasn't being done to protect special characters from the
1014         MacOS X shell when
1015         <A HREF="h_config_browser"><!--#echo var="VAR_url-viewers"--></A>
1016         was not defined
1017    <LI> On MacOS X message attachments should be shown internally instead of
1018         being shown using the Mail application
1019    <LI> When replying to a message with a charset of X-UNKNOWN Alpine would
1020         sometimes set the outgoing charset to X-UNKNOWN, making the result
1021         unreadable
1022    <LI> When the sending of a message failed lines with leading spaces had one
1023         additional space inserted in each of those lines when the user
1024         was returned to the composer
1025    <LI> The <A HREF="h_index_cmd_whereis">WhereIs</A> command missed some index lines
1026         that contained non-ascii characters because it was truncating the
1027         line being searched so that it was shorter than what was visible on
1028         the screen
1029    <LI> When composing, an attachment with a long name that causes wrapping in
1030         just the wrong place would generate an error and cause the send
1031         of the attachment to fail
1032    <LI> After calling the file browser to attach a file in the composer, a resize
1033         of the window when back in the composer would redraw the last screen that
1034         had been shown in the browser instead of the current composer screen
1035    <LI> Possible crash in index screen when encountering unparseable addresses
1036         or when using one of the PRIORITY tokens or the HEADER token in the
1037         <a href="h_config_index_format"><!--#echo var="VAR_index-format"--></a>
1038    <LI> Problems with Header Color editing if the configuration option
1039         <a href="h_config_customhdr_color"><!--#echo var="VAR_viewer-hdr-colors"--></a>
1040         was inadvertently changed to the Empty Value in the hidden config screen
1041    <LI> When resuming the final postponed message from an Exchange server the user
1042         could get a certificate validation failure because alpine was trying
1043         to validate the canonical name of the folder instead of the name the
1044         user used
1045    <LI> Windows line endings in a mimetypes file on a Unix system cause a
1046         failure to find a match
1047    <LI> Make matching of extension names case independent in mimetypes files
1048    <LI> Windows dialog boxes for entering text were not working correctly
1049    <LI> Replying to or Forwarding multipart/alternative messages which had a
1050         single text/html part did not work well
1051    <LI> Printing the print confirmation page caused a crash
1052    <LI> A To line with a long, quoted personal name could display incorrectly
1053         if it was close to the same width as the screen
1054    <LI> When <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
1055         and <A HREF="h_config_incoming_checking_total"><!--#echo var="FEAT_incoming-checking-includes-total"--></A>
1056         are turned on hide (0/0) when the folder is empty
1057    <LI> Folder completion while Saving didn't work if the collection being
1058         saved to was the local home directory
1059 </UL>
1060
1061 <P>
1062 Version 1.00
1063 was an evolutionary release based on
1064 <A HREF="http://www.washington.edu/pine/">Pine</A>, which was also
1065 developed at the University of Washington.
1066 It is upwards-compatible for existing Pine users.
1067
1068 <P>
1069 Changes included:
1070 <P>
1071 <UL>
1072    <LI> Ground-up reorganization of source code around addition
1073         of "pith/" core routine library.
1074    <LI> Fundamental improvement in Alpine's internal text handling, which
1075         is now based exclusively on Unicode. This allows displaying incoming
1076         messages and producing outgoing messages in many different languages.
1077    <LI> Ground-up reorganization of build and install procedures
1078         based on GNU Build System's autotools. NOTE, the included IMAP library
1079         build is not based on autotools, so some features will not work. However,
1080         it should get built automatically during the Alpine build process.
1081    <LI> Web-based version included built on TCL designed to run under
1082         a suitable CGI-supporting web server such as Apache.
1083 </UL>
1084
1085 <P>
1086
1087 Details on changes in previous (prerelease) versions of Alpine
1088 may be found at the following URL:
1089 <P>
1090 <CENTER><SAMP><A HREF="http://alpine.freeiz.com/alpine/release/">http://alpine.freeiz.com/alpine/release/</A></SAMP></CENTER>
1091 <P>
1092
1093 <HR WIDTH="75%"><P>
1094
1095 <H2>Getting Help</H2>
1096 <DL>
1097 <DT>Online Help</DT>
1098 <DD>
1099 Every Alpine screen and command has associated help text
1100 accessible via the &quot;?&quot; key (or Ctrl-G in text-input contexts).
1101 </DD>
1102
1103 <DT>Web Help</DT>
1104 <DD>
1105 The most current source of information about Alpine,
1106 including new version availability, is the web page at
1107 <P>
1108 <CENTER><SAMP><A HREF="http://alpine.freeiz.com/alpine/">http://alpine.freeiz.com/alpine/</A></SAMP></CENTER>
1109 </DD>
1110 </DL>
1111
1112 Frequently Asked Questions (and answers) may be found at the following
1113 URL:
1114 <P>
1115 <CENTER><SAMP><A HREF="http://www.washington.edu/alpine/faq/">http://www.washington.edu/alpine/faq/</A></SAMP></CENTER>
1116 <P>
1117
1118 <HR WIDTH="75%"><P>
1119
1120 <H2>Additional Information</H2>
1121
1122 General Alpine configuration information can be found
1123 <A HREF="h_news_config">here</A>.
1124 <P>
1125 This is revision (<!--#echo var="ALPINE_REVISION"-->) of the Alpine software.
1126 Alpine mailbox and <A HREF="https://github.com/jonabbey/panda-imap/">IMAP</A> server
1127 access is provided by the IMAP Toolkit Environment (c-client library)
1128 version <!--#echo var="C_CLIENT_VERSION"-->.
1129 <P>
1130 Alpine was developed until 2009 by the Office of Computing
1131 &amp; Communications at the University of Washington in Seattle.
1132 Since then, the effort of developing Alpine has been continued by
1133 a community of volunteers who make good software even better!
1134
1135 <P>
1136 Alpine Copyright 2013-2017 Eduardo Chappa,
1137 <BR> Copyright 2006-2008 University of Washington.
1138
1139 <P>
1140 Additional legal notices can be found <A HREF="h_news_legal">here</A>,
1141 or instead you can find the Apache License, version 2.0 at the web URL:
1142
1143 <P>
1144 <CENTER><A HREF="http://www.apache.org/licenses/LICENSE-2.0">http://www.apache.org/licenses/LICENSE-2.0</A></CENTER>
1145
1146 <P>
1147 &lt;End of Release Notes&gt;
1148 </BODY>
1149 </HTML>
1150 ====== h_password_file_support ======
1151 <HTML>
1152 <HEAD>
1153 <TITLE>Encryption for Password File Support Explained</TITLE>
1154 </HEAD>
1155 <BODY>
1156 <H1>Encryption for Password File Support Explained</H1>
1157
1158 Index<BR>
1159 <OL>
1160 <LI><A HREF="#content">Explanation</A>
1161 <LI><A HREF="#example_existing_key">Example of Use of Existing Key and Certificate</A>
1162 <LI><A HREF="#example_self_signed">Example of Creating Master Password</A>
1163 </OL>
1164
1165 <P><A NAME="content">Unix Alpine Only.</A>
1166
1167 <P> If your version of Alpine has been built with password file support
1168 then you can use a special file to save your passwords, and avoid typing
1169 them every time you open a connection to a remote server.
1170
1171 <P> If, in addition, your version of Alpine was built with SMIME support, then your
1172 password file will be encrypted with a strong key. There are two ways in
1173 which this can happen: Alpine will either use a matching private key and
1174 public certificate pair that you already own, or it will create one for
1175 you, just for purposes of encrypting this file. We describe both processes
1176 below.
1177
1178 <P> Initially, Alpine will scan your public and private directories for a
1179 certificate/private key pair that works. Alpine will pick the first pair
1180 that it finds that matches.
1181
1182 <P> Once a pair has been chosen, it will be copied to the directory
1183 ~/.alpine-smime/.pwd, and from then on, Alpine will use the pair found in
1184 that directory. The first time this process is done, this directory will
1185 be created, a key/certificate pair will be copied to it, from then on
1186 this pair will be used to encrypt and decrypt your password file.
1187
1188 <P> If you want to use a specific key and certificate pair to encrypt
1189 your password file, you can create the directory ~/.alpine-smime/.pwd
1190 manually, and then create your preferred key/certificate pair there.
1191 Alpine will use this key regardless of if it has expired, or if it is
1192 self-signed. These issues do not affect the encryption or decryption
1193 of the password file.
1194
1195 <P> If you prefer not to use the directory ~/.alpine-smime/.pwd to save
1196 your key/certificate pair, you can specify a different one with the
1197 -pwdcertdir command line option in Alpine. If the directory specified by
1198 this option is not found Alpine will fail to encrypt and decrypt your
1199 password file. However if it exists, Alpine will search for a
1200 key/certificate pair in that
1201 directory, and if it does not find one, it will create one and save it
1202 in that directory.
1203
1204 <P> Alpine does not care about the names of the key and certificates in
1205 this directory, but the private key must have &quot;.key&quot; extension
1206 and your public certificate must have the &quot;.crt&quot; extension. The
1207 name of the private key will be used in the prompt when you are asked
1208 to unlock your key to decrypt your password.
1209
1210 <P> If Alpine cannot find a suitable private key and public certificate
1211 pair to encrypt your password, it will create one. You will be asked to
1212 create a &quot;Master Password&quot; to protect such key. At this moment
1213 there are no restrictions on passwords, other than they have to be at
1214 least 8 characters long, but future versions of Alpine will include
1215 functionality to restrict master passwords, as set up by the administrator
1216 of the system in the pine.conf.fixed file.
1217
1218 <P><A NAME="example_existing_key"><B>Example of Use of Existing Key and Certificate</B></A>
1219
1220 <P>Assume you have a private key called peter@address.com.key in your,
1221 ~/.alpine-smime/private directory, and a public certificate called
1222 peter@address.com.crt in your ~/.alpine-smime/public directory, and these
1223 are your only key/certificate pair.
1224
1225 <P> When Alpine starts for the first time, without command line options,
1226 it will check if the directory ~/.alpine-smime/.pwd exists, and if not,
1227 it will create it. Then it will go through your keys and certificates and
1228 find a pair that it can use, and copy the files peter@address.com.key,
1229 and peter@address.com.crt to the ~/.alpine-smime/.pwd directory. Alternatively
1230 you can do the same by copying these files by yourself. This can be done
1231 with the sequence of commands
1232
1233 <PRE>
1234 mkdir ~/.alpine-smime/.pwd
1235 cp ~/.alpine-smime/private/peter@address.com.key ~/.alpine-smime/.pwd
1236 cp ~/.alpine-smime/public/peter@address.com.crt ~/.alpine-smime/.pwd
1237 </PRE>
1238
1239 <P> When Alpine starts, you will be asked the password to unlock your
1240 private key with the prompt.
1241
1242 <PRE>
1243 Enter password of key &lt;peter@address.com&gt; to unlock password file:
1244 </PRE>
1245
1246 <P> If you prefer to use different names for your private and public keys
1247 in the ~/.alpine-smime/.pwd directory, you can do so, but you must
1248 preserve the extension of the files. For example, you can use the names
1249 private_key.key and public_cert.crt instead. In this case, the prompt you
1250 will see when you are asked to unlock your private key will read
1251
1252 <PRE>
1253 Enter password of key &lt;private_key&gt; to unlock password file:
1254 </PRE>
1255
1256 <P>Observe that you do not need to use an existing key/certificate pair,
1257 and that you can create a new private key/public certificate pair to
1258 encrypt and decrypt your password file. Alpine provides a mechanism to
1259 change the encryption key for this file in the S/MIME configuration
1260 screen.
1261
1262 <P><A NAME="example_self_signed"><B>Example of Creating Master Password</B></A>
1263
1264 <P> If Alpine cannot find a suitable private key and public certificate pair
1265 to encrypt your password file, it will create one. When doing so, it will
1266 start the process with the following warning:
1267
1268 <PRE>
1269 Creating a Master Password for your Password file.
1270 </PRE>
1271
1272 <P> Then Alpine will ask you to enter your Master Password:
1273
1274 <PRE>
1275 Create master password (attempt 1 of 3):
1276 </PRE>
1277
1278 <P> Once you enter this password, and it validates according to system policy,
1279 you will be asked to confirm this password.
1280
1281 <PRE>
1282 Confirm master password (attempt 1 of 3):
1283 </PRE>
1284
1285 <P> If you input the same password, then Alpine will set that as your
1286 Master Password, and you will use this password to unlock your key in the
1287 future.
1288
1289 <P> If you would like to switch your Master Password in the future, you can
1290 do so by creating a new public key and public certificate pair. You can do
1291 so in the S/MIME configuration screen, in the &quot;Manage Key and
1292 Certificate for Password File&quot; section, simply enter your current
1293 password to unlock your current key and then press &quot;C&quot; to create
1294 a new key.
1295
1296 <P>
1297 &lt;End of help&gt;
1298 </BODY>
1299 </HTML>
1300 ====== h_tls_failure_details ======
1301 <HTML>
1302 <HEAD>
1303 <TITLE>Certificate Validation Details</TITLE>
1304 </HEAD>
1305 <BODY>
1306 <H1>Certificate Validation Details</H1>
1307
1308 This screen gives details as to why the certificate validation failed: the
1309 name of the desired server system; the reason for failure; and the name on
1310 the certificate.  This is primarily of interest to experts.
1311
1312 <P>
1313 &lt;End of help&gt;
1314 </BODY>
1315 </HTML>
1316 ====== h_tls_failure ======
1317 <HTML>
1318 <HEAD>
1319 <TITLE>TLS or SSL Failure</TITLE>
1320 </HEAD>
1321 <BODY>
1322 <H1>TLS or SSL Failure</H1>
1323
1324 An attempt was made to establish a secure, encrypted connection to the
1325 server system using either Transport Layer Security (TLS) or the older
1326 Secure Sockets Layer (SSL).  This attempt failed.
1327
1328 <P>
1329 You should contact your server system management for more assistance.
1330 The problem is probably at the server system and not in Alpine or your local
1331 system.  The text in this screen may be helpful for the server system
1332 management in debugging the problem,
1333
1334 <P>
1335 &lt;End of help&gt;
1336 </BODY>
1337 </HTML>
1338 ====== h_tls_validation_failure ======
1339 <HTML>
1340 <HEAD>
1341 <TITLE>TLS and SSL Certificate Validation Failures</TITLE>
1342 </HEAD>
1343 <BODY>
1344 <H1>TLS and SSL Certificate Validation Failures</H1>
1345
1346 An attempt was made to establish a secure, encrypted connection to the
1347 server system using either Transport Layer Security (TLS) or the older
1348 Secure Sockets Layer (SSL).
1349
1350 <P>
1351 An important part of this procedure is server certificate validation.  A
1352 server certificate is an &quot;electronic identification card&quot; for the server
1353 system that is signed by a well-known certificate authority (CA).  Alpine
1354 compares the server system identity in the server certificate with the
1355 name of the server system to which it is trying to connect.  Alpine also
1356 verifies that the CA signature is authentic.
1357
1358 <P>
1359 Some common failure conditions are:
1360 <P>
1361
1362 <UL>
1363   <LI> [UNIX Alpine] Self signed certificate.  This means that the server system
1364 signed its own certificate.  This does not necessarily indicate anything
1365 bad; the server operators may simply have elected to not purchase a
1366 signed certificate from a certificate authority.
1367
1368   <LI> [UNIX Alpine] Unable to get local issuer certificate.  This means that
1369 the signature on the server system is from an unknown certificate authority.
1370 It can also mean that no certificate authority certificates have been
1371 installed on the local UNIX system.
1372
1373   <LI> [PC Alpine] Self-signed certificate or untrusted authority.  This is
1374 the same as either of the above two conditions in UNIX Alpine.  Note that
1375 Windows systems typically have a full set of certificate authority
1376 certificates installed, so it is more likely to be a self-signed
1377 certificate than an unknown certificate authority.
1378
1379   <LI> Server name does not match certificate.  This means that the server
1380 presented a proper signed certificate for a name other than the desired
1381 name.
1382 </UL>
1383
1384 <P>
1385 Any of these conditions can indicate that you are being attacked and have
1386 been directed to an imposter server that will record your password and
1387 your private mail messages.  It can also mean something innocuous.
1388
1389 <P>
1390 If you are certain that the problem is innocuous, you can append the
1391 option
1392
1393 <P>
1394 <CENTER><SAMP>/novalidate-cert</SAMP></CENTER>
1395 <P>
1396
1397 to the server system name where it appears in your configuration (e.g. the
1398 <A HREF="h_config_inbox_path"><!--#echo var="VAR_inbox-path"--></A>,
1399 a folder-collection, or a news or SMTP server).  This will
1400 disable certificate validation.  On the other hand, if you are attacked,
1401 you will get no warning if you do this.
1402
1403 <P>
1404 &lt;End of Cert Validation Failures help&gt;
1405 </BODY>
1406 </HTML>
1407 ====== h_release_tlscerts ======
1408 <HTML>
1409 <HEAD>
1410 <TITLE>TLS and SSL usage note</TITLE>
1411 </HEAD>
1412 <BODY>
1413 <H1>TLS and SSL usage note</H1>
1414
1415 <P>
1416 When using Alpine from Unix or Windows 2000,
1417 server certificates must be signed by a trusted certificate authority.
1418 You may relax this requirement (at the cost of some security) by using
1419 the
1420 <A HREF="h_folder_server_syntax">NoValidate-Cert</A>
1421 modifier in the mailbox name.
1422
1423 <P>
1424 <CENTER><SAMP>{foo.example.com/novalidate-cert}INBOX</SAMP></CENTER>
1425 <P>
1426
1427 The fully-qualified host name of the server should be used
1428 so that it matches the host name in the server certificate.
1429 <P>
1430 Here is an example of a host specification that directs Alpine to use
1431 the SSL port (993) and an encrypted data stream.
1432 <P>
1433 <CENTER><SAMP>{foo.example.com/ssl}INBOX</SAMP></CENTER>
1434 <P>
1435 &lt;End of TLS usage help&gt;
1436 </BODY>
1437 </HTML>
1438 ====== h_news_config ======
1439 <HTML>
1440 <HEAD>
1441 <TITLE>Alpine Configuration</TITLE>
1442 </HEAD>
1443 <BODY>
1444 <H1>Alpine Configuration</H1>
1445
1446 <H2>Using Environment Variables</H2>
1447
1448 The values of Alpine configuration options may include environment variables
1449 that are replaced by the value of the variable at the time Alpine is run
1450 (and also at the time the config option is changed).
1451 The syntax to use environment variables is a subset of the common Unix
1452 shell dollar-syntax.
1453 For example, if
1454
1455 <P><CENTER><SAMP>$VAR</SAMP></CENTER><P>
1456
1457 appears in the value of an Alpine configuration option it is looked up in the
1458 environent (using getenv(&quot;VAR&quot;)) and its
1459 looked-up value replaces the <SAMP>$VAR</SAMP> part of the option value.
1460 To include a literal dollar sign you may precede the dollar sign with another
1461 dollar sign.
1462 In other words, if the text
1463
1464 <P><CENTER><SAMP>$$text</SAMP></CENTER><P>
1465
1466 is the value of a configuration option, it will be expanded to
1467
1468 <P><CENTER><SAMP>$text</SAMP></CENTER><P>
1469
1470 and no environment lookup will be done.
1471 For Unix Alpine it will also work to use a backslash character to
1472 escape the special meaning of the dollar sign, but $$ is preferable since
1473 it works for both PC-Alpine and Unix Alpine, allowing the configuration option
1474 to be in a shared configuration file.
1475 <P>
1476
1477 This all sounds more complicated than it actually is.
1478 An example may make it clearer.
1479 Unfortunately, the way in which environment variables are set is OS-dependent
1480 and command shell-dependent.
1481 In some Unix command shells you may use
1482
1483 <P><CENTER><SAMP>PERSNAME="Fred Flintstone"</SAMP></CENTER><P>
1484    <CENTER><SAMP>export PERSNAME</SAMP></CENTER><P>
1485
1486 Now, if you use Alpine's Setup/Config screen to set
1487
1488 <P><CENTER><SAMP><!--#echo var="VAR_personal-name"-->=$PERSNAME</SAMP></CENTER><P>
1489
1490 the <SAMP>$PERSNAME</SAMP> would be replaced by <SAMP>Fred Flintstone</SAMP>
1491 so that this would be equivalent to
1492
1493 <P><CENTER><SAMP><!--#echo var="VAR_personal-name"-->=Fred Flintstone</SAMP></CENTER><P>
1494
1495 Note, environment variable substitution happens after configuration
1496 options that are lists are split into the separate elements of the list,
1497 so a single environment variable can't contain a list of values.
1498
1499 <P>
1500 The environment variable doesn't have to be the only thing
1501 after the equal sign.
1502 However, if the name of the variable is not at the end of the line or
1503 followed by a space (so that you can tell where the variable name ends),
1504 it must be enclosed in curly braces like
1505
1506 <P><CENTER><SAMP>${VAR}</SAMP></CENTER><P>
1507
1508 It is always ok to use the braces even if you don't need to.
1509 <P>
1510 It is also possible to set a default value for an environment variable.
1511 This default value will be used if the environment variable is not
1512 set (that is, if getenv(&quot;VAR&quot;) returns NULL).
1513 The syntax used to set a default value is
1514
1515 <P><CENTER><SAMP>${VAR:-default value}</SAMP></CENTER><P>
1516
1517 If the config file contains
1518
1519 <P><CENTER><SAMP>personal-name=${VAR:-Fred Flintstone}</SAMP></CENTER><P>
1520
1521 then when Alpine is run <SAMP>VAR</SAMP> will be looked up in the environment.
1522 If <SAMP>VAR</SAMP> is found then <SAMP>personal-name</SAMP> will have
1523 the value that <SAMP>VAR</SAMP> was set to, otherwise,
1524 <SAMP>personal-name</SAMP> will be set to <SAMP>Fred Flintstone</SAMP>,
1525 the default value.
1526 (Note that the variable is called &quot;personal-name&quot; in the config
1527 file but is displayed in the config screen as
1528 &quot;<!--#echo var="VAR_personal-name"-->&quot;.
1529 In general, the value that goes into a config file is never exactly the
1530 same as the value you see on the screen.)
1531
1532 <P>
1533 An example where an environment variable might be useful is the
1534 variable <SAMP>Inbox-Path</SAMP> in the global configuration file.
1535 Suppose most users used the server
1536
1537 <P><CENTER><SAMP>imapserver.example.com</SAMP></CENTER><P>
1538
1539 but that there were some exceptions who used
1540
1541 <P><CENTER><SAMP>altimapserver.example.com</SAMP></CENTER><P>
1542
1543 In this case, the system manager might include the following line in
1544 the systemwide default Alpine configuration file
1545
1546 <P><CENTER><SAMP>Inbox-Path=${IMAPSERVER:-imapserver.example.com}</SAMP></CENTER><P>
1547
1548 For the exceptional users adding
1549
1550 <P><CENTER><SAMP>IMAPSERVER=altimapserver.example.com</SAMP></CENTER><P>
1551
1552 to their environment should work.
1553 <P>
1554 Another example might be the case where a user has to use a different
1555 SMTP server from work and from home.
1556 The setup might be something as simple as
1557
1558 <P><CENTER><SAMP>smtp-server=$SMTP</SAMP></CENTER><P>
1559
1560 or perhaps a default value could be given.
1561 Note that, as mentioned above, the variable <SAMP>SMTP</SAMP> cannot contain
1562 a list of SMTP servers.
1563 <P>
1564
1565 <H2>Configuration precedence</H2>
1566
1567 There are several levels of Alpine configuration.  Configuration values at
1568 a given level override corresponding values at lower levels.  In order of
1569 increasing precedence:
1570 <P>
1571 <UL>
1572  <LI> built-in defaults
1573  <LI> system-wide
1574 <!--chtml if pinemode="os_windows"-->
1575       config file from command line or provided
1576       by "PINECONF" environment variable
1577 <!--chtml else-->
1578       pine.conf file
1579 <!--chtml endif-->
1580  <LI> personal configuration file
1581  <LI> personal exceptions configuration file
1582  <LI> command-line options
1583  <!--chtml if pinemode="os_windows"--><!--chtml else-->
1584  <LI> system-wide pine.conf.fixed file<!--chtml endif-->
1585 </UL>
1586 <P>
1587 The values in both the personal configuration file and the
1588 <A HREF="h_config_exceptions">exceptions</A>
1589 configuration file may be set using the Setup command.
1590 Setup/Config is the command to change most of the personal configuration
1591 options.
1592 The other Setup subcommands are also used to change the configuration,
1593 for example, Setup/AddressBook, Setup/Rules, and so on.
1594 Changing the personal exceptions configuration is very similar.
1595 To change a value in the Config screen you would use the command
1596 Setup/eXceptions/Config.
1597 Likewise for the other Setup subcommands (Setup/eXceptions/Rules and so on).
1598 <P>
1599 There are a couple exceptions to the rule that configuration values are replaced
1600 by the value of the same option in a higher-precedence file.
1601 The Feature-List variable has values that are additive, but can be
1602 negated by prepending &quot;no-&quot; in front of an individual feature name.
1603 So for features, each individual feature's value is replaced by the value
1604 of the same feature in a higher-precedence file.
1605 Note that this is done automatically for you when you change these values via
1606 the Setup/Config command.
1607 The other exception to the <EM>replace</EM> semantics happens when you
1608 use <A HREF="h_config_inheritance">configuration inheritance</A>
1609 for option lists.
1610 <P>
1611
1612 <H2>File name defaults</H2>
1613
1614 Notes:<P>
1615
1616 <BR> &lt;exe dir&gt; = directory where pine.exe found.
1617 <BR> &lt;pinerc dir&gt; = directory where pinerc found.
1618 <BR> # = default file name is overridable in pinerc.
1619 <BR> $HOME, if not explicitly set, defaults to root of the current drive.
1620 <BR> $MAILCAPS, if set, is used in lieu of the default mailcap search paths.
1621 <BR> + between the mailcap paths implies that the two files are combined.
1622 <BR> ; between other default paths implies that the first one found is used.
1623 </P>
1624 Alpine looks for most support files in the same directory it finds its
1625 personal configuration file (pinerc).  The -p command-line flag may be
1626 used to specify a particular path name for the pinerc file.  If a
1627 pinerc file does not exist, it will be created (if directory permissions
1628 allow).  In PC-Alpine, if -p or $PINERC are not defined, Alpine will look
1629 in $HOME&#92;PINE and the directory containing the PINE.EXE.  If a PINERC
1630 file does not exist in either one, it will create one in the first of those
1631 two directories that is writable.  In detail:
1632 <PRE>
1633
1634 PC-Alpine:
1635
1636  executable     &lt;DOS search path&gt;&#92;pine.exe
1637  help index     &lt;exe dir&gt;&#92;pine.ndx
1638  help text      &lt;exe dir&gt;&#92;pine.hlp
1639
1640  pers config    $PINERC  ;  $HOME&#92;pine&#92;PINERC  ;  &lt;exe dir&gt;&#92;PINERC
1641  except config  $PINERCEX ; $HOME&#92;pine&#92;PINERCEX  ;  &lt;exe dir&gt;&#92;PINERCEX
1642  global cfg     $PINECONF
1643
1644  debug          &lt;pinerc dir&gt;&#92;pinedebg.txtN
1645  crash          &lt;pinerc dir&gt;&#92;pinecrsh.txt
1646  signature#     &lt;pinerc dir&gt;&#92;pine.sig
1647  addressbook#   &lt;pinerc dir&gt;&#92;addrbook
1648  mailcap#       &lt;pinerc dir&gt;&#92;mailcap  +  &lt;exe dir&gt;&#92;mailcap
1649  mimetypes#     &lt;pinerc dir&gt;&#92;mimetype +  &lt;exe dir&gt;&#92;mimetype
1650  newsrc#        $HOME&#92;newsrc (if exists, else) &lt;pinerc dir&gt;&#92;newsrc
1651  sentmail#      $HOME&#92;mail&#92;sentmail.mtx
1652  postponed#     $HOME&#92;mail&#92;postpond.mtx
1653  interrupted    $HOME&#92;mail&#92;intruptd
1654
1655 Unix Alpine:
1656
1657  executable     &lt;Unix search path&gt;/pine
1658  persnl cfg     ~/.pinerc
1659  except cfg     ~/.pinercex
1660  global cfg     <!--#echo var="PINE_CONF_PATH"-->
1661  fixed cfg      <!--#echo var="PINE_CONF_FIXED_PATH"-->
1662  local help     <!--#echo var="PINE_INFO_PATH"-->
1663
1664  interrupted    ~/.pine-interrupted-mail
1665  debug          ~/.pine-debugN
1666  crash          ~/.pine-crash
1667  newsrc#        ~/.newsrc
1668  signature#     &lt;pinerc dir&gt;/.signature
1669  addressbook#   &lt;pinerc dir&gt;/.addressbook
1670  postponed#     ~/mail/postponed-msgs
1671  sentmail#      ~/mail/sent-mail
1672  mailcap#       ~/.mailcap + /etc/mailcap
1673                            + /usr/etc/mailcap + /usr/local/etc/mailcap
1674  mimetypes#     ~/.mime.types + /etc/mime.types + /usr/local/lib/mime.types
1675
1676  news-spool     varies across Unix flavors, e.g. /var/spool/news or /usr/spool/news
1677  active-news    varies across Unix flavors, e.g. /usr/lib/news/active
1678  lock files     /tmp/.<!--#echo var="MAIL_SPOOL_LOCK_PATH"-->
1679  inbox          <!--#echo var="MAIL_SPOOL_PATH"-->
1680  password       /etc/passwd
1681
1682 Unix Alpine and PC-Alpine:
1683
1684  .ab*           remote addressbook support files
1685  a[1-9]*        temporary (while Alpine is running) addressbook files
1686
1687 </PRE>
1688 <P>
1689
1690 <H2>Mailcap files</H2>
1691
1692 Alpine honors the mailcap configuration system for specifying external
1693 programs for handling attachments.  The mailcap file maps MIME attachment
1694 types to the external programs loaded on your system that can display
1695 and/or print the file.  A sample mailcap file comes bundled with the Alpine
1696 distribution.  It includes comments that explain the syntax you need to
1697 use for mailcap.  With the mailcap file, any program (mail readers,
1698 newsreaders, WWW clients) can use the same configuration for handling
1699 MIME-encoded data.
1700 <P>
1701
1702 <H2>MIME-Types files</H2>
1703
1704 Alpine uses mime-types files (.mime.types or MIMETYPE) to determine
1705 what Content-Type to use for labeling an attached file, based on
1706 the file extension.  That is, this file provides a mapping between
1707 filename extensions and MIME content-types.
1708 <P>
1709
1710 <H2>Environment variables</H2>
1711
1712 PC-Alpine uses the following environment variables:
1713 <DL>
1714 <DT>PINERC</DT>
1715 <DD>Optional path to pinerc file.</DD>
1716 <DT>PINERCEX</DT>
1717 <DD>Optional path to personal exceptions configuration file.</DD>
1718 <DT>PINECONF</DT>
1719 <DD>Optional path to global pine config file.</DD>
1720 <DT>HOME</DT>
1721 <DT>TMPDIR, TMP, or TEMP</DT>
1722 <DT>COMSPEC</DT>
1723 <DT>MAILCAPS</DT>
1724 <DD>A <B>semicolon</B> delimited list of path names to mailcap files.</DD>
1725 <DT>USER_DICTIONARY</DT>
1726 <DD>Used to specify the file to contain the user's spell check
1727 dictionary.  The default is <SAMP>DICT.U</SAMP> in the same
1728 directory as the <SAMP>SPELL32.DLL</SAMP></DD>
1729 </DL>
1730
1731 Unix Alpine uses the following environment variables:
1732 <DL>
1733 <DT>TERM</DT>
1734 <DD>Tells Alpine what kind of terminal is being used.</DD>
1735 <DT>DISPLAY</DT>
1736 <DD>Determines if Alpine will try to display IMAGE attachments.</DD>
1737 <DT>SHELL</DT>
1738 <DD>If not set, default is &quot;/bin/sh&quot;.</DD>
1739 <DT>TMPDIR, TMP, or TEMP</DT>
1740 <DT>MAILCAPS</DT>
1741 <DD>A <B>colon</B> delimited list of path names to mailcap files.</DD>
1742 </DL>
1743 <!--chtml if pinemode="os_windows"-->
1744 <P>
1745 <H2>Common PC-Alpine Configuration Problems</H2>
1746
1747 <H3>Configuration settings aren't being saved</H3>
1748
1749 <P>This problem can happen if you run pine from one directory and
1750 then decide to move your pine directory to another location.  PC-Alpine
1751 stores certain variables, including the configuration location, in the
1752 Windows Registry (which you shouldn't ever need to manually edit).  There
1753 are a couple of ways to go about removing or resetting the values in the
1754 registry.
1755
1756 <P>
1757 1) Run PC-Alpine's registry value deletion command.  This can be done by
1758 running: &quot;&lt;your&nbsp;pine&nbsp;directory&gt;&#92;pine.exe&nbsp;-registry&nbsp;clear&quot; from the DOS
1759 prompt. You could create a shortcut to pine.exe and change the &quot;Target&quot;
1760 value to the above command.
1761
1762 <P>
1763 2) Tell PC-Alpine where to look for the configuration file.  Configuration
1764 information is stored in a file called the PINERC.  With the &quot;-p&nbsp;PINERC&quot;
1765 option, you can tell PC-Alpine the location of your pinerc.  An example of
1766 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;.
1767 Again, you can use the DOS prompt or the shortcut method explained in (1).
1768
1769 <P>
1770 Additionally, there is the &quot;-registry&nbsp;set&quot; option, which will actively
1771 set registry values to the current setting, and is therefore useful with
1772 the &quot;-p&nbsp;PINERC&quot; option.
1773
1774 <!--chtml endif-->
1775 <P>
1776 &lt;End of Configuration Notes&gt;
1777 </BODY>
1778 </HTML>
1779 ====== h_news_legal ======
1780 <html>
1781 <head>
1782 <TITLE>Alpine Legal Notices</TITLE>
1783 </head>
1784 <body>
1785
1786 <H1>Alpine Legal Notices</H1>
1787
1788 Alpine and its constituent programs are covered by the Apache License Version 2.0.
1789
1790
1791 <P>
1792 &lt;End of Alpine Legal Notices&gt;
1793 </BODY>
1794 </HTML>
1795 ===== h_info_on_mbox =====
1796 <HTML>
1797 <HEAD>
1798 <TITLE>Information on mbox driver</TITLE>
1799 </HEAD>
1800 <BODY>
1801 <H1>Information on &quot;Missing Mail&quot; and the &quot;mbox&quot; driver</H1>
1802
1803 Beginning with Pine 4.00 (Pine came before Alpine)
1804 a new INBOX access method is
1805 available as part of the standard configuration.  It is called the
1806 &quot;mbox&quot; driver and it works like this:<P>
1807
1808 <P>
1809 <BLOCKQUOTE>
1810 If the file &quot;mbox&quot; exists in the user's home directory, and
1811 is in Unix mailbox format, then when INBOX is opened this file will be
1812 selected as INBOX instead of the mail spool file.  Messages will be
1813 automatically transferred from the mail spool file into the mbox
1814 file.
1815 </BLOCKQUOTE>
1816
1817 <P>
1818 The advantage of this method is that, after new mail has been copied
1819 from the system mail spool, all subsequent access is confined to the
1820 user's home directory, which is desirable on some systems.  However, a
1821 possible disadvantage is that mail tools other than those from the
1822 University of Washington will not know to look for mail in the user's
1823 mbox file.  For example, POP or IMAP servers other than those from the
1824 University of Washington, and many &quot;new mail notification&quot;
1825 programs may not work as expected with this driver enabled.<P>
1826
1827 To disable this behavior, either remove/rename the &quot;mbox&quot;
1828 file or find the <A HREF="h_config_disable_drivers"><!--#echo var="VAR_disable-these-drivers"--></A>
1829 option in Setup/Config
1830 and add &quot;mbox&quot; to it:
1831 <P>
1832 <CENTER><SAMP><!--#echo var="VAR_disable-these-drivers"-->=mbox</SAMP></CENTER>
1833 <P>
1834 &lt;End of help on this topic&gt;
1835 </BODY>
1836 </HTML>
1837 ===== h_info_on_locking =====
1838 <HTML>
1839 <HEAD>
1840 <TITLE>FAQs on Alpine Locking</TITLE>
1841 </HEAD>
1842 <BODY>
1843 <H1>What Systems Managers Need to Know about Alpine File Locking</H1>
1844
1845 There is an extensive section on locking in the Alpine technical notes;
1846 this information is intended to provide answers to some common questions:<P>
1847 <OL>
1848 <LI> Why did locking change in Pine 4.00?<BR>
1849 The actual locking mechanisms did not change in 4.00.
1850 What changed is that when one particular locking mechanism used by Alpine
1851 fails, Alpine now issues a warning message.  Prior to Pine 4.00, the locking
1852 failure would occur, but no warning was issued.<P>
1853
1854 <LI> Is this what the &quot;Mailbox vulnerable&quot; message is about?<BR>
1855 Yes.  It means that Alpine was unable to create a lockfile in the
1856 spool directory, generally because of overly restrictive protections on the
1857 spool directory.  The correct permissions on the spool directory for
1858 running Alpine are 1777, i.e. read-write-execute permission for everyone,
1859 with the sticky-bit set, so only owners of a file can delete them.<P>
1860
1861 <LI> Why does Alpine require that the mail spool directory have 1777
1862    protections?<BR>
1863 Alpine was designed to run without special privileges.  This means that in
1864 order to create a lockfile in the spool directory, it is necessary to have
1865 the spool directory permissions be world-writable.<P>
1866
1867 <LI> Can't you create the lockfile somewhere else?<BR>
1868 No.  The lockfile in question must be in the mail spool directory, because
1869 that's where the mail delivery program expects to find it, and the purpose
1870 of the file is to coordinate access between the mail client (Alpine) and the
1871 mail delivery program.<P>
1872
1873 <LI> Isn't having the spool directory world-writable a big security risk?<BR>
1874 No.  Remember that the individual mail files in the spool directory are
1875 NOT world-writable, only the containing directory.  Setting the &quot;sticky
1876 bit&quot; -- indicated by the &quot;1&quot; before the &quot;777&quot; mode
1877 -- means that only the owner of the file (or root) can delete files in the
1878 directory.  So the only bad behavior that is invited by the 1777 mode is that
1879 anyone could
1880 create a random file in the spool directory.  If the spool directory is
1881 under quota control along with home directories, there is little incentive
1882 for anyone to do this, and even without quotas a periodic scan for
1883 non-mail files usually takes care of the problem.  <P>
1884
1885 <LI> Why not run Alpine as setgid mail?<BR>
1886 Alpine was never designed to run with privileges, and to do so introduces a
1887 significant security vulnerability.  For example, if a user suspends Alpine,
1888 the resulting shell will have group privileges.  This is one example of
1889 why we strongly recommend against running Alpine as a privileged program.
1890 In addition, a &quot;privileged mailer &quot paradigm would mean that normal
1891 users
1892 could not test Alpine versions or other mailers that had not been installed
1893 by the system administrators.<P>
1894
1895
1896 <LI> Are there any alternatives to creating .lock files in the spool dir?<BR>
1897 There are, but they all have different sets of tradeoffs, and not all will
1898 work on all systems.  Some examples:<UL>
1899  <LI> Use lock system calls.  Works fine on a few systems, provided mail
1900    spool is local.   Doesn't work reliably if NFS is used.
1901    Doesn't work unless <B>all</B> the mail programs accessing the spool dir
1902    use the same calls.
1903  <LI> Deliver mail to user's home directory.  An excellent solution, highly
1904    recommended -- but one which is incompatible with some &quot;legacy&quot;
1905 mail tools that always look in the spool directory for the mail.
1906 </UL><P>
1907
1908 <LI> Are these spool directory lock files the only kinds of locks used by
1909    Alpine?<BR>
1910 No.  Alpine also creates lockfiles in the /tmp directory.  For normal Unix
1911 mailbox format folders, these are used to coordinate access between
1912 multiple Alpine sessions.  <P>
1913
1914 <LI> What about the
1915 <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>
1916 This is for people who are content to live dangerously, or who have
1917 specific knowledge that the spool directory lockfiles are superfluous on
1918 their system (because both Alpine and the mail delivery program are using
1919 system call file locking in a context that works reliably, e.g. not NFS.)<P>
1920
1921 <LI> Where can I find more details on how Alpine locking works?<BR>
1922 See the Alpine Technical Notes.<P>
1923
1924 </OL>
1925 <P>
1926 &lt;End of help on this topic&gt;
1927 </BODY>
1928 </HTML>
1929 ===== h_finding_help ====
1930 <HTML>
1931 <HEAD>
1932 <TITLE>Finding more information and requesting help</TITLE>
1933 </HEAD>
1934 <BODY>
1935 <H1>Places to Look for More Answers</H1>
1936 If you have questions about or problems with Alpine that you cannot resolve
1937 after consulting the program's internal, context-sensitive help screens, here
1938 are additional information resources that you may find helpful:
1939 <P>
1940 <UL>
1941   <LI> Alpine's top-level <A HREF="main_menu_tx">MAIN MENU HELP</A>.<P>
1942
1943   <LI> Alpine's <A HREF="h_help_index">Help Index</A>.<P>
1944
1945   <LI> Alpine's internal <A HREF="h_news">Release Notes</A>.  They contain a
1946 listing of changes in Alpine <!--#echo var="ALPINE_VERSION"-->
1947   since the last version, which may be useful for you to be aware of,
1948 <B>especially</B> if a &quot;problem&quot; you are encountering is actually
1949 a change in the way an aspect of Alpine works.  There, you will also find notes
1950 on Alpine configuration.<P>
1951
1952   <LI> The main site for Alpine contains information on configuring and solving problems
1953        with Alpine, it can be found at
1954
1955 <CENTER><A HREF="http://alpine.freeiz.com/alpine/">http://alpine.freeiz.com/alpine/</A></CENTER>
1956
1957   <LI> The Alpine Information Center (maintained by the University of
1958            Washington) World Wide Web site contains, among other things
1959            <UL>
1960            <LI>a collection of Frequently Asked Questions (and answers!) about Alpine
1961            <LI>an overview of the basics for beginning Alpine users
1962            <LI>Technical Notes for systems administrators
1963            <LI>archives (including a searchable index) of the alpine-info
1964 mailing list, on which matters of interest to systems/email administrators,
1965 developers, trainers, user support personnel, and others involved with Alpine
1966 messaging on a &quot;technical&quot; level are discussed.
1967 </UL>
1968         The Alpine Information Center can be accessed with a WWW browser at:<P>
1969             <CENTER><A HREF="http://www.washington.edu/alpine/">http://www.washington.edu/alpine/</A></CENTER>
1970 </UL>
1971 <P><HR WIDTH="75%">
1972 <H1>Requesting help</H1>
1973 If the internal help, the Release Notes, the Alpine Information Center, and your
1974 local online and print resources do not help you resolve a problem, please
1975 start by contacting your local computer support staff and asking for help.
1976 <p>
1977 This is especially true if:
1978 <ul>
1979   <li>You suddenly have trouble sending or receiving mail.
1980   <li>You receive a "disk quota exceeded" message.
1981   <li>You have forgotten your password.
1982   <li>You think your account may have been compromised.
1983   <li>You need help viewing an attachment.
1984   <li>You need to know how to configure your:
1985       <A HREF="h_config_nntp_server">NNTP (news) server</A>,
1986       <A HREF="h_config_smtp_server">SMTP (sending mail) server</A>,
1987       <A HREF="h_config_ldap_server">LDAP (directory lookup) server</A>, or
1988       <A HREF="h_config_inbox_path">INBOX (incoming mail) path</A>.
1989   <li>You want to know what alternative editors or spellcheckers you may be able to use.
1990   <li>You want to block email from a particular person.
1991   <li>You're going on vacation and need to autorespond to incoming mail.
1992   <li>You want to automatically file or filter incoming messages.
1993 </ul>
1994
1995 In all of these cases,
1996 you should contact <B>your</B> support staff, because <B>only they</B>
1997 will be able to assist you effectively. Your support staff may be, depending on who
1998 provides you with the email account you use Alpine with, for example:<UL>
1999 <LI> the computing help desk of (a department of) your university, school,
2000 employer, ... ; or
2001 <LI> the customer service center of your Internet Service Provider; or
2002 <LI> the friendly volunteer helpers of your Freenet; or
2003 <LI> the person who setup your computer and internet connection.
2004 </UL>
2005
2006 Due to the large number of Alpine installations worldwide, and because we
2007 receive no funding for it, the University of Washington <B>cannot provide
2008 individual support services outside the University of Washington</B>.
2009 <P>
2010 If you have no local computing support to turn to, the worldwide <b>comp.mail.pine</b>
2011 newsgroup can be a valuable source of information and assistance for Alpine
2012 user issues.
2013 <P>
2014 For systems/email administrators, developers, trainers, user support
2015 personnel, and others involved with Alpine messaging on a &quot;technical&quot;
2016 level, the mailing list alpine-info is available; for information on
2017 subscribing and posting to it, see
2018 <P>
2019 <CENTER><A HREF="http://www.washington.edu/alpine/alpine-info/subscribing.html">http://www.washington.edu/alpine/alpine-info/subscribing.html</A></CENTER>
2020 <P>
2021
2022 Regardless of whom you are asking for help with Alpine, remember
2023 to provide as much detail as you can about the
2024 nature of any problem you are encountering, such as
2025 <UL>
2026 <LI>when it first occurred;
2027 <LI>what, if anything, happened that might have brought it about;
2028 <LI>whether it still persists;
2029 <LI>whether it is reproducible, and if so, how;
2030 <LI>what, if anything, you already tried to solve it.
2031 </UL>
2032 It may also be helpful if you specify what version of Alpine you are using
2033 <!--chtml if pinemode="running"-->
2034 -- this is <!--#echo var="ALPINE_VERSION"--> --
2035 <!--chtml endif-->
2036 and on what system, and when the copy of Alpine you are using was created
2037 <!--chtml if pinemode="running"-->
2038 -- for this copy: <!--#echo var=ALPINE_COMPILE_DATE-->
2039 <!--chtml endif-->
2040
2041 <!--chtml if pinemode="running"-->
2042 <P>
2043 When the Alpine program you are currently using was installed, a support
2044 contact email address may have been set up; in that case, you can simply select
2045 this link now to send a message to it:<BR>
2046 <A HREF="X-Alpine-Gripe:_LOCAL_ADDRESS_?local"><!--#echo var="_LOCAL_FULLNAME_"--></A><P>
2047 <!--chtml endif-->
2048 <!--chtml if [ -r PINE_INFO_PATH ]-->
2049 <HR WIDTH="75%">Local Support Contacts:<P>
2050 <!--#include file="PINE_INFO_PATH"-->
2051 <HR WIDTH="75%">
2052 <!--chtml endif-->
2053 <P>
2054 &lt;End of help on this topic&gt;
2055 </BODY>
2056 </HTML>
2057 ===== new_user_greeting ======
2058 <HTML>
2059 <HEAD>
2060 <TITLE>NEW USER GREETING</TITLE>
2061 </HEAD>
2062 <BODY>
2063 <CENTER>&lt;&lt;&lt;This message will appear only once&gt;&gt;&gt;</CENTER>
2064 <BR>
2065 <H1>Welcome to Alpine ... a Program for Internet News and Email</H1>
2066 We hope you will explore Alpine's many capabilities. From the MAIN MENU,
2067 select Setup/Config to see many of the options available to you. Also note
2068 that all screens have context-sensitive help text available.<P>
2069 <!--chtml if pinemode="phone_home"-->
2070 SPECIAL REQUEST:
2071 This software was originally created and maintained as a public
2072 service by the University of Washington until 2009; updates are made
2073 available as a public service of the Alpine community. It is always
2074 helpful to have an idea of how many users are using Alpine. Are you
2075 willing to be counted as an Alpine user? Pressing
2076 <A HREF="X-Alpine-Phone-Home:">Return</A>
2077 will send an anonymous (meaning, your real email address will not be revealed)
2078 message to the Alpine developers for purposes of tallying.
2079 <P>
2080 <!--To Exit this screen and continue your Alpine session press "E".-->
2081 <!--chtml else-->
2082 To Exit this screen and continue your Alpine session press "Return".
2083 <!--chtml endif-->
2084 </BODY>
2085 </HTML>
2086 ===== new_alpine_user_greeting ======
2087 <HTML>
2088 <HEAD>
2089 <TITLE>NEW ALPINE USER GREETING</TITLE>
2090 </HEAD>
2091 <BODY>
2092 <CENTER>&lt;&lt;&lt;This message will appear only once&gt;&gt;&gt;</CENTER>
2093 <BR>
2094 <H1>Welcome to Alpine ... a Program for Internet News and Email</H1>
2095 Your Alpine configuration file indicates that you may have used Pine before
2096 but not Alpine.
2097 If you are familiar with the way Pine works, you should be comfortable
2098 using Alpine.
2099 Your Pine configuration file is automatically used for Alpine.
2100 The Release Notes may be viewed by pressing
2101 &quot;R&quot; now or while in the MAIN MENU.
2102 <P>
2103 <!--chtml if pinemode="phone_home"-->
2104 SPECIAL REQUEST:
2105 This software was originally created and maintained as a public
2106 service by the University of Washington until 2009; updates are made
2107 available as a public service of the Alpine community. It is always
2108 helpful to have an idea of how many users are using Alpine. Are you
2109 willing to be counted as an Alpine user? Pressing
2110 <A HREF="X-Alpine-Phone-Home:">Return</A>
2111 will send an anonymous (meaning, your real email address will not be revealed)
2112 message to the Alpine developers for purposes of tallying.
2113 <P>
2114 <!--To Exit this screen and continue your Alpine session press "E".-->
2115 <!--chtml else-->
2116 To Exit this screen and continue your Alpine session press "Return".
2117 <!--chtml endif-->
2118 </BODY>
2119 </HTML>
2120 ===== new_version_greeting ======
2121 <HTML>
2122 <HEAD>
2123 <TITLE>NEW VERSION GREETING</TITLE>
2124 </HEAD>
2125 <BODY>
2126 <CENTER>&lt;&lt;&lt;This message will appear only once&gt;&gt;&gt;</CENTER>
2127 <BR>
2128 <H1>Welcome to Alpine version <!--#echo var="ALPINE_VERSION"-->!</H1>
2129 Your Alpine configuration file indicates that you may not have used
2130 this version of Alpine before.  This version's significant changes are
2131 documented in the Release Notes, which may be viewed by pressing
2132 &quot;R&quot; now or while in the MAIN MENU.
2133 <P>
2134 <!--chtml if pinemode="phone_home"-->
2135 SPECIAL REQUEST:
2136 This software was originally created and maintained as a public
2137 service by the University of Washington until 2009; updates are made
2138 available as a public service of the Alpine community. It is always
2139 helpful to have an idea of how many users are using Alpine. Are you
2140 willing to be counted as an Alpine user? Pressing
2141 <A HREF="X-Alpine-Phone-Home:">Return</A>
2142 will send an anonymous (meaning, your real email address will not be revealed)
2143 message to the Alpine developers for purposes of tallying.
2144 <P>
2145 <!--To Exit this screen and continue your Alpine session press "E".-->
2146 <!--chtml else-->
2147 To Exit this screen and continue your Alpine session press "Return".
2148 <!--chtml endif-->
2149 </BODY>
2150 </HTML>
2151
2152 ===== main_menu_tx ======
2153 <HTML>
2154 <HEAD>
2155 <TITLE>GENERAL INFORMATION ON THE ALPINE MESSAGE SYSTEM</TITLE>
2156 </HEAD>
2157 <BODY>
2158 <H1>GENERAL INFORMATION ON THE ALPINE MESSAGE SYSTEM</H1>
2159 <DIV ALIGN=CENTER>
2160 Version <!--#echo var="ALPINE_VERSION"-->
2161 <!--chtml if pinemode="running"-->
2162 <BR>(built <!--#echo var=ALPINE_COMPILE_DATE-->)
2163 <!--chtml endif-->
2164 </DIV>
2165 <CENTER>Copyright 2013-2017 Eduardo Chappa,
2166 <BR>Copyright 2006-2008 University of Washington.
2167 </CENTER>
2168
2169 <P>
2170 When you are viewing a help screen, there may be links to
2171 other topics highlighted (in Reverse video) in the text.
2172 Here is an example.
2173 The word &quot;Introduction&quot; in the TABLE OF CONTENTS below should be
2174 highlighted.
2175 If you type carriage return (or V for View Link, see the commands at the
2176 bottom of the screen) you will be taken to a new help screen to view the
2177 Introduction.
2178 The commands at the bottom of the screen should then include
2179 &quot;P Prev Help&quot;.
2180 If you type &quot;P&quot; you will end up back here.
2181 If you type &quot;E&quot; for Exit, you will be back out of help and returned
2182 to the place you were in Alpine when you entered Help.
2183 In this case, you would go back to the MAIN MENU.
2184 There are also other links that are highlighted in bold (or the color used
2185 by your terminal to display bold).
2186 The items after the Introduction in the TABLE OF CONTENTS are all examples
2187 of such links.
2188 In order to view those links, you first have to make the link you want
2189 to view the current link.
2190 The &quot;NextLink&quot; and &quot;PrevLink&quot; commands
2191 (see bottom of screen) can do that for you.
2192 <P>
2193
2194 <H2>TABLE OF CONTENTS</H2>
2195 <OL>
2196   <LI> <A HREF="h_mainhelp_intro">Introduction</A>
2197   <LI> <A HREF="h_mainhelp_pinehelp">Alpine Help</A>
2198 <!--chtml if [ -r PINE_INFO_PATH ]-->
2199   <LI> <A HREF="h_mainhelp_localsupport">Local Support Contacts</A>
2200 <!--chtml endif-->
2201   <LI> <A HREF="h_mainhelp_cmds">Giving Commands in Alpine</A>
2202   <LI> <A HREF="h_mainhelp_config">Alpine Configuration</A>
2203   <LI> <A HREF="h_mainhelp_status">Titlebar Line</A>
2204   <LI> <A HREF="h_mainhelp_mainmenu">Main Menu</A>
2205   <LI> <A HREF="h_mainhelp_index">Index of Messages</A>
2206   <LI> <A HREF="h_mainhelp_reading">Reading Messages</A>
2207   <LI> <A HREF="h_mainhelp_composing">Composing Messages</A>
2208   <LI> <A HREF="h_mainhelp_readingnews">Reading News</A>
2209   <LI> <A HREF="h_mainhelp_abooks">Address Books</A>
2210   <LI> <A HREF="h_mainhelp_ldap">LDAP Directories</A>
2211   <LI> <A HREF="h_mainhelp_folders">Folders</A>
2212   <LI> <A HREF="h_mainhelp_collections">Collection Lists</A>
2213   <LI> <A HREF="h_mainhelp_aggops">Aggregate Operations</A>
2214   <LI> <A HREF="h_mainhelp_color">Color Setup</A>
2215   <LI> <A HREF="h_mainhelp_filtering">Filtering</A>
2216   <LI> <A HREF="h_mainhelp_roles">Roles</A>
2217   <LI> <A HREF="h_mainhelp_patterns">Patterns</A>
2218   <LI> <A HREF="h_mainhelp_keywords">Keywords (or Flags, or Labels)</A>
2219   <LI> <A HREF="h_mainhelp_mouse">Using a Mouse</A>
2220   <LI> <A HREF="h_mainhelp_cmdlineopts">Command Line Options</A>
2221   <LI> <A HREF="h_mainhelp_securing">Securing Your Alpine Session</A>
2222   <LI> <A HREF="h_mainhelp_smime">S/MIME</A>
2223   <LI> <A HREF="h_mainhelp_problems">Reporting Problems</A>
2224   <LI> <A HREF="X-Alpine-Config:">Show Supported Options in this Alpine</A>
2225   <LI> <A HREF="h_help_index">Index to Alpine's Online Help</A>
2226 </OL>
2227
2228 <P>
2229 &lt;End of help on this topic&gt;
2230 </BODY>
2231 </HTML>
2232 ===== h_mainhelp_intro ======
2233 <HTML>
2234 <HEAD>
2235 <TITLE>Introduction</TITLE>
2236 </HEAD>
2237 <BODY>
2238 <H1>Introduction</H1>
2239
2240 Alpine is an &quot;Alternatively Licensed Program for Internet
2241 News and Email&quot; produced until 2009 by the University of Washington.
2242 It is intended to be an easy-to-use program for
2243 sending, receiving, and filing Internet electronic mail messages and
2244 bulletin board (Netnews/Usenet) messages. Alpine supports the following
2245 Internet protocols and specifications: SMTP (Simple Mail Transport Protocol),
2246 NNTP (Network News Transport Protocol), MIME (Multipurpose Internet Mail
2247 Extensions), IMAP (Internet Message Access Protocol), and LDAP (Lightweight
2248 Directory Access Protocol).<p>
2249
2250 Although originally designed for inexperienced email users, Alpine has
2251 evolved to support many advanced features.  There are an ever-growing
2252 number of configuration and personal-preference options, though which of
2253 them are available to you is determined by your local system managers.
2254
2255 <H2>WHAT ALPINE DOES...</H2>
2256
2257 Alpine is a &quot;mail user agent&quot; (MUA), which is a program that
2258 allows you to
2259 compose and read messages using Internet mail standards.  (Whether you
2260 can correspond with others on the Internet depends on whether or not your
2261 computer is connected to the Internet.)  Alpine also allows reading and
2262 posting messages on the Internet &quot;net news&quot; system, provided
2263 that your site operates a suitable news server.
2264
2265 <H2>WHAT ALPINE DOES NOT DO...</H2>
2266
2267 A &quot;mail user agent&quot; such as Alpine is just one part of a
2268 messaging system. Here are some things that are <B>not</B> done by Alpine,
2269 but require other programs:<P>
2270 <UL>
2271  <LI> Actual relaying of email... which is done by &quot;message transfer
2272 agents&quot;.
2273  <LI> Vacation messages... automatically responding to incoming messages
2274  <LI> Anything to do with &quot;talk&quot;... which has nothing to do with
2275 email.
2276  <LI> Anything to do with &quot;irc&quot;... which has nothing to do with email.
2277  <LI> List processing... resending one message to a list of recipients.
2278 </UL>
2279
2280 <P>
2281 &lt;End of help on this topic&gt;
2282 </BODY>
2283 </HTML>
2284
2285 ===== h_mainhelp_pinehelp ======
2286 <HTML>
2287 <HEAD>
2288 <TITLE>Alpine Help</TITLE>
2289 </HEAD>
2290 <BODY>
2291 <H1>Alpine Help</H1>
2292
2293 Alpine help is generally context-sensitive. In other words, each Alpine screen you
2294 use will have its own help text, explaining the choices available for that
2295 screen. This general help section, on the other hand, attempts to give an
2296 overall picture of what Alpine is capable of doing, as well as pointers to
2297 additional help sections about specific topics.<p>
2298
2299 Much of the help text contains links to further help topics, similar to
2300 how the World Wide Web works.
2301 You may choose a link to view using the &quot;NextLink&quot; and
2302 &quot;PrevLink&quot; commands to change the link that is highlighted.
2303 The &quot;View Link&quot; command will then show you the highlighted link.
2304 Similar to the Back button in a web browser, the &quot;Prev Help&quot; command
2305 will return you to where you were before viewing the link, and &quot;Exit Help&quot
2306 will return you to the location in Alpine before you asked for help.
2307 For example, if you are reading this text in Alpine you may return to the
2308 help table of contents with the &quot;Prev Help&quot; command or you may view the
2309 Release notes link in the next paragraph and then return here with
2310 &quot;Prev Help&quot;.
2311 <P>
2312
2313 In addition to this general help on Alpine, <A HREF="h_news">Release Notes</A>
2314 on the current Alpine version are also available from the MAIN MENU: Press
2315 <!--chtml if pinemode="function_key"-->
2316 &quot;F9&quot;
2317 <!--chtml else-->
2318 &quot;R&quot;
2319 <!--chtml endif-->
2320 to browse the release notes.  These include changes since the last release,
2321 configuration information, the history of the Alpine
2322 project, credits, and legal notices.
2323
2324 Alpine releases are available via the world wide web at
2325 <P>
2326 <CENTER><SAMP><A
2327 HREF="http://alpine.freeiz.com/alpine/release/">http://alpine.freeiz.com/alpine/release/</A></SAMP
2328 ></CENTER>
2329 <P>
2330
2331 If you would like to print <EM>all</EM> of Alpine's internal help text
2332 (not recommended) for a little light bedtime reading, then press
2333 <!--chtml if pinemode="function_key"-->
2334 &quot;F12&quot;
2335 <!--chtml else-->
2336 &quot;Z&quot;
2337 <!--chtml endif-->
2338 now.  (This assumes that the
2339 copy of Alpine you are using has been properly configured for printing
2340 at your site.)
2341 <P>
2342 &lt;End of help on this topic&gt;
2343 </BODY>
2344 </HTML>
2345 ===== h_mainhelp_localsupport ======
2346 <HTML>
2347 <HEAD>
2348 <TITLE>Local Support Contacts</TITLE>
2349 </HEAD>
2350 <BODY>
2351 <H1>Local Support Contacts</H1>
2352
2353 <!--chtml if [ -r PINE_INFO_PATH ]-->
2354 <!--#include file="PINE_INFO_PATH"-->
2355 <!--chtml else-->
2356 No Local Support Contacts configured.
2357 <!--chtml endif-->
2358
2359 <P>
2360 &lt;End of help on this topic&gt;
2361 </BODY>
2362 </HTML>
2363
2364 ===== h_mainhelp_cmds ======
2365 <HTML>
2366 <HEAD>
2367 <TITLE>Giving Commands in Alpine</TITLE>
2368 </HEAD>
2369 <BODY>
2370 <H1>Giving Commands in Alpine</H1>
2371
2372 Unless configured otherwise
2373 (<A HREF="h_config_blank_keymenu"><!--#echo var="FEAT_disable-keymenu"--></A>)
2374 the bottom two lines of the screen are always used to list the
2375 commands you can give.  You press the keys that are highlighted to give
2376 the command.  The commands for getting help and going back to the main
2377 menu are always present (except when viewing help as you are now).
2378 <!--chtml if pinemode="function_key"-->
2379 <!--chtml else-->
2380 <p>
2381 Pressing O (meaning &quot;Other Commands&quot;) changes the keys
2382 you see at the bottom of any screen. In some cases there are 3 or
2383 even 4 different
2384 sets of keys that can be seen by using the O key. <EM>All commands are
2385 active</EM>, even if they are not currently showing at the bottom of your
2386 screen. In other words, you <EM>never</EM> need to press the O key, except to
2387 remind yourself of the proper key to press to perform an operation.
2388
2389 <H2>Control Key Commands</H2>
2390 When composing mail, and in a few other places, in Alpine you
2391 have to use Control keys. This means pressing the Control key (usually labeled
2392 &quot;Ctrl&quot;) and the
2393 letter indicated at the same time.  Usually, this is shown with a
2394 &quot;^&quot; in front of the letter.  On some systems, certain control
2395 characters are intercepted before they get to Alpine.  As a work-around,
2396 you can press the ESCAPE key twice followed by the desired key.  For
2397 example, if Ctrl-O (^O) does not work on your system, try typing
2398 &quot;ESC ESC O&quot;.
2399 <!--chtml endif-->
2400 <H2>Paging Up and Down</H2>
2401 The &quot;+&quot; and &quot;-&quot; keys are used for
2402 moving to the next or previous page.  The space bar is a synonym for
2403 &quot;+&quot;.  You may also use Ctrl-V to page down and Ctrl-Y to page
2404 up as you do in the message composer.  On screens with a WhereIs (search)
2405 command, W or Ctrl-W followed by Ctrl-V will move to the bottom of the
2406 message or list, and W or Ctrl-W followed by Ctrl-Y will move to the top
2407 of the message or list.
2408
2409 <H2>Return Key</H2>
2410 The return key is usually a synonym for a frequently used
2411 command.  When viewing a message, there is currently not a default
2412 command, so RETURN does nothing; when in the index, it is synonymous with
2413 &quot;view msg&quot;. In the key menu at the bottom of the screen, whatever is
2414 enclosed in square brackets [] is the same as the return key.
2415
2416 <H2>Control Keys Not Used By Alpine</H2>
2417 Most commands in Alpine are single letters, with -- we hope -- some mnemonic
2418 value, but in places where Alpine is expecting text input, e.g. in the composer or
2419 at prompts for file/folder names, control keys must be used for editing and
2420 navigation functions.
2421 <P>
2422
2423 Alpine has used nearly all the control keys available.  There are, however,
2424 certain control keys that are reserved by other programs or for technical
2425 reasons.  Alpine does not use any of these keys:
2426 <DL>
2427  <DT>Ctrl-S</DT> <DD>Used by Unix as &quot;stop output&quot;</DD>
2428  <DT>Ctrl-Q</DT> <DD>Used by Unix as &quot;resume output&quot;</DD>
2429  <DT>Ctrl-]</DT> <DD>Often used by Telnet as escape key</DD>
2430 </DL>
2431 <P>
2432 Note: Ctrl-S and Ctrl-Q can be subject to
2433 <A HREF="h_special_xon_xoff">special handling</A>.
2434 <P>
2435 In addition, while the ESC key alone is not used for command input,
2436 Alpine will recognize two consecutive ESC key presses followed by a letter
2437 key as a substitute for control key input.  For example, the control key
2438 <SAMP>Ctrl-X</SAMP> can alternatively be entered using the
2439 three keystrokes: <SAMP>ESC&nbsp;ESC&nbsp;x</SAMP>.
2440 This is useful if the communication program you are using
2441 (e.g. Telnet) has its own, conflicting, idea of what certain control
2442 characters mean.
2443
2444
2445 <H2>Repainting the Screen</H2>
2446 Sometimes what is displayed on the screen will be
2447 incorrect due to noise on the phone line or other causes and you will want
2448 to repaint the whole screen to make it correct.  You can use the Ctrl-L
2449 command to do this.  It never hurts to do it when in doubt.
2450
2451 <P>
2452 &lt;End of help on this topic&gt;
2453 </BODY>
2454 </HTML>
2455 ===== h_mainhelp_status ======
2456 <HTML>
2457 <HEAD>
2458 <TITLE>Titlebar Line</TITLE>
2459 </HEAD>
2460 <BODY>
2461 <H1>Titlebar Line</H1>
2462
2463 The top line of the screen is Alpine's titlebar line.  It will always display
2464 the current version of Alpine and will also convey information about the
2465 status of the program.  This is where you look to find out what
2466 collection, folder and message number is active and where you are in Alpine.
2467 <P>
2468
2469 If the titlebar line says &quot;READONLY&quot; it means that the open folder
2470 (typically your INBOX) is &quot;locked&quot; by another mail session --
2471 most likely a more recent session of Alpine has taken the INBOX lock.
2472 <P>
2473
2474 If the titlebar line says &quot;CLOSED&quot; it means that you are trying to
2475 access a
2476 folder on a remote mail server, and for some reason, communication with
2477 the mail server has either been lost, or never successfully established.
2478 This can be a result of trying to open a non-existent folder, or one
2479 stored on an invalid or non-operational server, or it can mean that Alpine
2480 has been suspended for more that 30 minutes while accessing a remote mail
2481 server.
2482
2483 <P>
2484 &lt;End of help on this topic&gt;
2485 </BODY>
2486 </HTML>
2487 ===== h_mainhelp_mainmenu ======
2488 <HTML>
2489 <HEAD>
2490 <TITLE>Main Menu</TITLE>
2491 </HEAD>
2492 <BODY>
2493 <H1>Main Menu</H1>
2494
2495 The Main Menu lists Alpine's main options.
2496 The key or keys you must type to enter your
2497 choice are to the left of each option or command name.
2498 You can type either uppercase or lowercase letters,
2499 and you should not press &lt;Return&gt; after typing the
2500 letter (unless you are specifically asking for the default,
2501 highlighted command).
2502 <P>
2503
2504 From the Main Menu you can choose to read online help, write (compose) and
2505 send a message, look at an index of your mail messages, open or maintain
2506 your mail folders, update your address book, configure Alpine, and quit Alpine.
2507 There are additional options listed at
2508 the bottom of the screen as well.
2509
2510 <P>
2511 The Help command usually returns context-sensitive help information.
2512 However, in the Main Menu you get the most general help, which includes
2513 a Table of Contents.
2514 The last entry in the Table of Contents is an Index of help topics,
2515 so this is a good place to go if you are having trouble finding how
2516 to do something.
2517
2518 <H2>Main Menu Commands</H2>
2519 The Alpine main menu lists the most common Alpine functions. A <a
2520 href="h_main_menu_commands">full list of these
2521 commands</a> and what they do is available.
2522 <P>
2523 &lt;End of help on this topic&gt;
2524 </BODY>
2525 </HTML>
2526 ===== h_mainhelp_abooks ======
2527 <HTML>
2528 <HEAD>
2529 <TITLE>Address Books</TITLE>
2530 </HEAD>
2531 <BODY>
2532 <H1>Address Books</H1>
2533
2534
2535 As you use email, you can build a list of your regular email correspondents
2536 in your Alpine
2537 Address Book. At the Alpine MAIN MENU, press A to see the Address Book List
2538 screen. Your
2539 personal address book will be highlighted. Press &lt;Return&gt; to view it.
2540 You can use the address book to store email addresses for individuals or
2541 groups, to create easily
2542 remembered &quot;nicknames&quot; for these addresses, and to quickly retrieve an email
2543 address when you are composing a message.
2544 <P>
2545 There are two ways to add addresses to your address book: you can add them
2546 manually or take them from messages (by pressing T to access the Take command).
2547 With either method, you specify nicknames for your correspondents. A single
2548 address book entry (or nickname) can point to just one email address, or, it can
2549 point to more than one. When it points to more than one, it is called a
2550 distribution list. Each distribution list has a nickname, a full name, and a
2551 list of addresses. These
2552 addresses may be actual addresses, other nicknames in your address book, or
2553 other
2554 distribution lists.
2555
2556 <P>
2557 Additional information is available in Alpine's online help:
2558 <ul>
2559   <li><a href="h_abook_opened">The Alpine Address Book</a></li>
2560 </ul>
2561 <P>
2562 &lt;End of help on this topic&gt;
2563 </BODY>
2564 </HTML>
2565 ===== h_mainhelp_ldap ======
2566 <HTML>
2567 <HEAD>
2568 <TITLE>LDAP</TITLE>
2569 </HEAD>
2570 <BODY>
2571 <H1>LDAP</H1>
2572
2573 LDAP (Lightweight Directory Access Protocol) is a standard means of accessing
2574 an organization's shared
2575 directories. Essentially, using LDAP, Alpine is able to find email addresses in
2576 large address
2577 books, rather like the White Pages provided by the phone company. As an Alpine
2578 user, it is not
2579 necessary to know much about how this works, only how to use it and how to
2580 configure
2581 it.
2582 <P>
2583 More information on configuring LDAP is available in Alpine's online help:
2584 <ul>
2585   <li><a href="h_direct_config">Setup LDAP Directory Servers</a></li>
2586 </ul>
2587 <P>
2588 Additional help on using LDAP in Alpine is also available:
2589 <ul>
2590   <li><a href="h_ldap_view">LDAP Response View Explained</a></li>
2591 </ul>
2592 <P>
2593 &lt;End of help on this topic&gt;
2594 </BODY>
2595 </HTML>
2596 ===== h_mainhelp_index ======
2597 <HTML>
2598 <HEAD>
2599 <TITLE>Index of Messages</TITLE>
2600 </HEAD>
2601 <BODY>
2602 <H1>Index of Messages</H1>
2603
2604 In Alpine's message index, the selected message is highlighted. The first
2605 column on the left is blank, shows a &quot;+&quot; if the message was
2606 sent directly to you (i.e., it is not a
2607 copy or from a list), or a &quot;-&quot; if you were explicitly Cc'd.
2608 <P>
2609 The second column may be blank, or it may contain:
2610 <ul>
2611   <li>"N" if the message is new (unread), </li>
2612   <li>"A" if you have answered the message (using the Reply command), </li>
2613   <li>"D" if you have marked the message for deletion.</li>
2614 </ul>
2615
2616 <P>
2617 Note: If you answer a message as well as mark it deleted (in either order),
2618 you will only see the &quot;D&quot;.
2619
2620 <P>
2621 The rest of the columns in the message line show you the message
2622 number, date sent, sender, size, and subject. For details, press ? (Help).
2623 The behavior and appearance of the Index screen is highly configurable.
2624 In the Setup/Config screen search (with the WhereIs command) for options
2625 that contain the words &quot;index&quot; or &quot;thread&quot; to see
2626 many of the configuration possibilities.
2627 In particular, the
2628 &quot;<A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A>&quot;
2629 option may be used to configure the look of the standard MESSAGE INDEX lines
2630 in many different ways.
2631 Find <!--#echo var="VAR_index-format"--> in the Setup/Config screen and
2632 read the help text there for more information.
2633 <P>
2634 Most of the commands you need to handle your messages are visible at the
2635 bottom of the screen, and you can press O (OTHER CMDS) to see additional
2636 commands that are available.
2637 You do not need to see these &quot;other commands&quot;
2638 on the screen to use them. That is, you never need to press O as a prefix
2639 for any other command.
2640
2641 <P>
2642 Additional information is available in Alpine's online help:
2643 <ul>
2644   <li><a href="h_mail_index">Message Index Commands</a></li>
2645 </ul>
2646 <P>
2647 &lt;End of help on this topic&gt;
2648 </BODY>
2649 </HTML>
2650 ===== h_mainhelp_reading ======
2651 <HTML>
2652 <HEAD>
2653 <TITLE>Reading Messages</TITLE>
2654 </HEAD>
2655 <BODY>
2656 <H1>Reading Messages</H1>
2657
2658 The message text screen shows you the text of the message along with
2659 its header. If a message has attachments, those will be listed (but not
2660 displayed) also.  The titlebar line displays information about the currently
2661 open message, folder and collection.  You see the name of the collection
2662 (if there is one) in angle brackets, then the name of the folder, then the
2663 message number and finally the position within the current message (in
2664 percent). If the message is marked for deletion
2665 &quot;DEL&quot; will appear in the
2666 upper right as well.
2667
2668 <P>
2669 As with every Alpine screen, the bottom two lines show you the commands
2670 available.
2671
2672 <P>Additional information is available in Alpine's online help:
2673 <ul>
2674   <li><a href="h_mail_view">Message Text Screen</a></li>
2675   <li><a href="h_attachment_screen">Attachment Index Screen Explained</a></li>
2676   <li><a href="h_mail_text_att_view">Attachment View Screen Explained</a></li>
2677 </ul>
2678 <P>
2679 &lt;End of help on this topic&gt;
2680 </BODY>
2681 </HTML>
2682 ===== h_mainhelp_composing ======
2683 <HTML>
2684 <HEAD>
2685 <TITLE>Composing Messages</TITLE>
2686 </HEAD>
2687 <BODY>
2688 <H1>Composing Messages</H1>
2689
2690 To write a message, press C (Compose). You see the Compose Message
2691 screen, which is divided into two parts: the header area and the message
2692 text area. The header area is where information on the recipient (the To:
2693 field) and the subject line go, while the message text area contains the
2694 actual text of the email message. Different commands are available to you
2695 when your cursor is in different areas on this screen. To see additional
2696 help on commands in either the message text or header area, type
2697 <Control>G (Get help).
2698
2699 <P>
2700 To move around, use the arrow keys or Ctrl-N (Next line) and Ctrl-P
2701 (Previous line); to correct typing errors, use &lt;Backspace&gt; or &lt;Delete&gt;.
2702
2703 <P>The following information from Alpine's online help may prove useful:
2704 <ul>
2705   <li><a href="h_composer_to">Message Header Commands</a></li>
2706   <li><a href="h_compose_richhdr">Rich Header Command</a></li>
2707   <li><a href="h_composer">Composer Commands</a></li>
2708   <li><a href="h_edit_nav_cmds">Composer Editing Commands</a></li>
2709   <li><a href="h_config_change_your_from">Changing your From Address</a></li>
2710   <li><a href="h_compose_send">Send Command</a></li>
2711   <li><a href="h_compose_spell">Spell Check Command</a></li>
2712 </ul>
2713 <P>
2714 &lt;End of help on this topic&gt;
2715 </BODY>
2716 </HTML>
2717 ===== h_mainhelp_collections ======
2718 <HTML>
2719 <HEAD>
2720 <TITLE>Collection Lists</TITLE>
2721 </HEAD>
2722 <BODY>
2723 <H1>Collection Lists</H1>
2724
2725 Collection lists are Alpine's way of organizing groups of folders. Each
2726 "collection" can reside on a different server, for example, and contain a
2727 different group of mail folders.
2728
2729 <P>
2730 For more information on this, see:
2731 <ul>
2732   <li><a href="h_what_are_collections">Folder Collections Explained</a></li>
2733 </ul>
2734 <P>
2735 Additional information relating to collection lists is also available in
2736 Alpine's online
2737 help:
2738 <ul>
2739   <li><a href="h_collection_maint">Setup Collection List Screen</a></li>
2740   <li><a href="h_collection_screen">Collection List Screen</a></li>
2741 </ul>
2742 <P>
2743 &lt;End of help on this topic&gt;
2744 </BODY>
2745 </HTML>
2746 ===== h_mainhelp_folders ======
2747 <HTML>
2748 <HEAD>
2749 <TITLE>Folders</TITLE>
2750 </HEAD>
2751 <BODY>
2752 <H1>Folders</H1>
2753
2754 Messages can quickly accumulate in your INBOX folder. If you use email
2755 often, you soon could have hundreds. You need to delete messages you do
2756 not want, and you can use folders to organize messages you wish to save. A
2757 folder is a collection of one or more messages that are stored (just like
2758 the messages in your INBOX) so you can access and manage them.
2759
2760 <P>
2761 You can organize your email messages into different folders by topic,
2762 correspondent, date, or any other category that is meaningful to you. You
2763 can create your own folders, and Alpine automatically provides three:
2764 <ul>
2765   <li>The INBOX folder: messages sent to you are listed in this folder.
2766       When you first start Alpine and go to the Message Index screen, you are
2767 looking at the list of messages in your INBOX folder. Every incoming
2768 message remains in your INBOX until you delete it or save it in another
2769 folder. </li>
2770   <li>The sent-mail folder: copies of messages you send are stored in this
2771 folder. This is
2772 convenient if you cannot remember whether you actually sent a message and want
2773 to check, or
2774 if you want to send a message again.</li>
2775   <li>The saved-messages folder: copies of messages you save are stored in this
2776 folder
2777 unless you choose to save them to other folders you create yourself.</li>
2778 </ul>
2779
2780 <P>
2781 More information about folders is available in Alpine's online help:
2782 <ul>
2783   <li><a href="h_folder_open">Explanation of Folder Selection</a></li>
2784   <li><a href="h_folder_maint">Help for Folder List</a></li>
2785   <li><a href="h_valid_folder_names">Explanation of Valid Folder Names</a></li>
2786   <li><a href="h_folder_fcc">Folder Select for Fcc ("sent-mail")
2787 Explained</a></li>
2788   <li><a href="h_folder_save">Folder Select for Save Explained</a></li>
2789 </ul>
2790 <P>
2791 &lt;End of help on this topic&gt;
2792 </BODY>
2793 </HTML>
2794 ===== h_mainhelp_color ======
2795 <HTML>
2796 <HEAD>
2797 <TITLE>Color</TITLE>
2798 </HEAD>
2799 <BODY>
2800 <H1>Color</H1>
2801
2802 If the terminal emulator you are using is capable of displaying color or if
2803 you are using PC-Alpine, then it is possible to set up Alpine so that various
2804 parts of the display will be shown in colors you configure. This is done
2805 using the Setup Color screen, available from the MAIN MENU by selecting
2806 the Setup command followed by &quot;K&quot; for Kolor (because &quot;C&quot;
2807 stands for Config in this context).
2808
2809 <P>
2810 For example, you may color things like the titlebar, the current item,
2811 the keymenu, and the status messages.
2812 You may also color lines in the index, and headers and quoted text in the
2813 MESSAGE TEXT screen.
2814 You use the Color Setup screen for configuring most of this, but you must
2815 use the IndexColor setup for coloring whole index lines.
2816 These are available from the MAIN MENU under Setup/Kolor and Setup/Rules/IndexColor.
2817
2818 <P>
2819 The following entries in Alpine's online help provide additional information
2820 about how to use color:
2821 <UL>
2822   <LI> <A HREF="h_color_setup">Color Setup screen</A>
2823   <LI> <A HREF="h_rules_incols">Index Line Color</A>
2824   <LI> <A HREF="h_config_quote_color">quoted text</A> in message view
2825   <LI> <A HREF="h_config_customhdr_pattern">text associated with user-defined headers</A> in message view
2826 </UL>
2827 <P>
2828 &lt;End of help on this topic&gt;
2829 </BODY>
2830 </HTML>
2831 ===== h_mainhelp_mouse ======
2832 <HTML>
2833 <HEAD>
2834 <TITLE>Using a Mouse</TITLE>
2835 </HEAD>
2836 <BODY>
2837 <H1>Using a Mouse</H1>
2838
2839 If you are using PC-Alpine mouse support is turned on automatically.
2840 If you are using UNIX Alpine within an X terminal window or within
2841 a terminal emulator that supports an xterm-style mouse, then you may
2842 turn on support for the mouse with the feature
2843 <A HREF="h_config_enable_mouse"><!--#echo var="FEAT_enable-mouse-in-xterm"--></A>.
2844 For UNIX Alpine you will also need to set the $DISPLAY environment variable.
2845 <P>
2846 PC-Alpine offers considerable mouse support.  You can view what is
2847 &quot;clickable&quot; by dragging your mouse over any screen; when the
2848 arrow cursor changes into a hand, you found something. Mouse-click
2849 possibilities include navigating between screens and folders and
2850 double-clicking on hyperlinks to open your Web browser.
2851 Context-sensitive pop-up menus appear with a right-click on your PC-Alpine
2852 screen.  Examples of right-click options include &quot;copy&quot; after
2853 selecting text to copy and &quot;View in New Window&quot; when you click
2854 on a particular message in the Message Index. The menu choices available
2855 to you will vary based upon what screen is open, where on the screen your
2856 cursor is located, and even what action you have already taken.
2857 Within a folder, you may set the &quot;Important&quot; flag on any
2858 message.
2859 <P>
2860 X terminal mouse support is more limited but still quite powerful.
2861 As with PC-Alpine, clicking on any of the commands in the keymenu at
2862 the bottom of the screen will execute that command as if you typed it.
2863 Double-clicking on a link, for example the link to the
2864 <!--#echo var="FEAT_enable-mouse-in-xterm"--> feature in the paragraph above,
2865 will take you to that link.
2866 Double-clicking on an index line will view the message, and so on.
2867 <P>
2868 &lt;End of help on this topic&gt;
2869 </BODY>
2870 </HTML>
2871 ===== h_mainhelp_keywords ======
2872 <HTML>
2873 <HEAD>
2874 <TITLE>Keywords</TITLE>
2875 </HEAD>
2876 <BODY>
2877 <H1>Keywords</H1>
2878
2879 Within a folder, you may set the &quot;Important&quot; flag on any
2880 message.
2881 This doesn't have any system-defined meaning and is only called
2882 the Important flag because many users use it to signify that a message
2883 is important to them in some way.
2884 <P>
2885 You may also define your own set of keywords.
2886 You might know these as user defined flags or as labels.
2887 These are similar to the Important flag but you choose the names for yourself.
2888 <P>
2889 Alpine will only display keywords that
2890 have been added by you in the Flag Details screen or
2891 that have been configured by you using the Setup/Config option
2892 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>.
2893 Keywords set by other means (for example, by another email client) will not
2894 show up in Alpine unless you configure Alpine to know about them.
2895 They will show up in the Flag Details screen, but will not show up, for example,
2896 in the index line.
2897
2898 <P>
2899 The following entries in Alpine's online help provide additional information
2900 about how to use keywords:
2901 <ul>
2902   <li><A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--> config option</A></li>
2903   <li><A HREF="h_common_flag">Flag command to set keywords</A></li>
2904 </ul>
2905 <P>
2906 &lt;End of help on this topic&gt;
2907 </BODY>
2908 </HTML>
2909 ===== h_mainhelp_roles ======
2910 <HTML>
2911 <HEAD>
2912 <TITLE>Roles</TITLE>
2913 </HEAD>
2914 <BODY>
2915 <H1>Roles</H1>
2916
2917 You may play different roles depending on who you are replying to. For
2918 example, if you are replying to a message addressed to help-desk you may
2919 be acting as a Help Desk Worker. That role may require that you use a
2920 different return address and/or a different signature.
2921
2922 <P>
2923 To configure roles, go to the MAIN MENU and use the Setup command
2924 followed by &quot;Rules&quot; and then &quot;Roles&quot;.
2925 The following entries in Alpine's online help provide additional information
2926 about how to
2927 use roles:
2928 <ul>
2929   <li><a href="h_rules_roles">Setup Roles Screen</a></li>
2930   <li><a href="h_role_select">Roles Screen</a></li>
2931 </ul>
2932 <P>
2933 &lt;End of help on this topic&gt;
2934 </BODY>
2935 </HTML>
2936 ===== h_mainhelp_filtering ======
2937 <HTML>
2938 <HEAD>
2939 <TITLE>Filtering</TITLE>
2940 </HEAD>
2941 <BODY>
2942 <H1>Filtering</H1>
2943
2944 The software that actually delivers mail (the stuff that happens
2945 before Alpine is involved) for you is in a better position to do mail filtering
2946 than Alpine itself.
2947 If possible, you may want to look into using that sort of mail filtering to
2948 deliver mail to different folders, delete it, or forward it.
2949 However, if you'd like Alpine to help with this, Alpine's filtering is for you.
2950
2951 <P>
2952 Filtering is a way to automatically move certain messages from one folder
2953 to another or to automatically delete messages.
2954 You may also automatically set the state (Important, New, Deleted, Answered) of messages
2955 and set <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> for messages.
2956 Alpine doesn't have the ability to forward mail to another address or
2957 to deliver vacation messages.
2958
2959 <P>
2960 To configure filtering, go to the MAIN MENU and use the Setup command
2961 followed by &quot;Rules&quot; and then &quot;Filters&quot;.
2962 The following entries in Alpine's online help provide additional information
2963 about how to use filtering:
2964 <UL>
2965   <LI> <A HREF="h_rules_filter">Filtering Setup screen</A>
2966 </UL>
2967 <P>
2968 &lt;End of help on this topic&gt;
2969 </BODY>
2970 </HTML>
2971 ===== h_mainhelp_patterns ======
2972 <HTML>
2973 <HEAD>
2974 <TITLE>Patterns</TITLE>
2975 </HEAD>
2976 <BODY>
2977 <H1>Patterns</H1>
2978
2979 Patterns are used with Roles, Filtering, Index Coloring,
2980 Scoring, Other Rules, and Search Rules, so it may help you to understand exactly how Patterns work.
2981 The following entries in Alpine's online help provide information
2982 about using Patterns:
2983 <UL>
2984   <LI> <A HREF="h_rule_patterns">Patterns</A>
2985 </UL>
2986 <P>
2987 &lt;End of help on this topic&gt;
2988 </BODY>
2989 </HTML>
2990 ===== h_mainhelp_cmdlineopts ======
2991 <HTML>
2992 <HEAD>
2993 <TITLE>Command Line Options</TITLE>
2994 </HEAD>
2995 <BODY>
2996 <H1>Command Line Options</H1>
2997
2998 Alpine accepts a number of command line arguments, allowing you, for
2999 example, to start Alpine and immediately access a particular folder.
3000 Many of these arguments overlap with options in the Alpine configuration file.
3001 If there is a difference, then an option set on the command line takes
3002 precedence.
3003 Alpine expects command line arguments (other than addresses) to be
3004 preceded by a &quot;-&quot; (dash) as normally used by UNIX programs.
3005 A <a href="h_command_line_options">full list</a> of command line
3006 possibilities is available.
3007 <P>
3008 &lt;End of help on this topic&gt;
3009 </BODY>
3010 </HTML>
3011 ===== h_mainhelp_config ======
3012 <HTML>
3013 <HEAD>
3014 <TITLE>Alpine Configuration</TITLE>
3015 </HEAD>
3016 <BODY>
3017 <H1>Alpine Configuration</H1>
3018
3019 Unless it has been administratively disabled, the Setup command on the
3020 MAIN MENU has several subcommands that allow you to modify Alpine's behavior.
3021 The possible subcommands are for general Configuration settings,
3022 Printer settings, Changing your Password, Signature setup,
3023 AddressBook setup, Collection Lists setup, Rules (including Roles, Filters,
3024 Scores, Search, Indexcolor, and Other rules), LDAP Directory setup,
3025 and Color configuration.
3026 In particular, the &quot;Config&quot; subcommand has many features you may
3027 set or unset and many other configuration variables that may be set to change
3028 the way Alpine works.
3029 Every one of the hundreds of options available in that configuration settings
3030 screen has help text associated with it.
3031 You may read that text by moving the cursor to highlight the option and then
3032 typing the Help command.
3033 <P>
3034 These settings are stored in your personal
3035 &quot;pinerc&quot; configuration file (or, optionally, they may be stored
3036 <A HREF="h_config_remote_config">remotely</A>),
3037 but on shared systems these settings
3038 may be over-ridden by a system-wide control file (due to local site
3039 security or support policies).  A global pine configuration file can also
3040 be used to set default values for all Alpine users on a particular system.
3041 Power users may be interested in splitting their personal configuration
3042 data into two pieces, a generic piece and
3043 <A HREF="h_config_exceptions">exceptions</A> which apply to
3044 a particular platform.
3045 They may also be interested in <A HREF="h_config_inheritance">configuration inheritance</A>.
3046 General Alpine configuration information can be found
3047 <A HREF="h_news_config">here</A>.
3048 <P>
3049 &lt;End of help on this topic&gt;
3050 </BODY>
3051 </HTML>
3052 ===== h_mainhelp_aggops ======
3053 <HTML>
3054 <HEAD>
3055 <TITLE>Aggregate Operations</TITLE>
3056 </HEAD>
3057 <BODY>
3058 <H1>Aggregate Operations</H1>
3059
3060 When you are in the MESSAGE INDEX, the available commands
3061 (for example, Delete, Undelete, Save, Reply, and so on)
3062 normally act on a single message.
3063 So, for example, if you press the Delete command, the currently highlighted
3064 message is marked Deleted.
3065 These commands that normally act on a single message may be applied to
3066 several messages at once instead.
3067 <P>
3068 By default this feature is turned on, but it could be administratively turned
3069 off to reduce complexity.
3070 The feature
3071 <A HREF="h_config_enable_agg_ops"><!--#echo var="FEAT_enable-aggregate-command-set"--></A>
3072 in the Setup/Config screen is used to turn it off or on.
3073 When this feature is turned on, the four commands &quot;Select&quot;,
3074 &quot;SelectCur&quot;, &quot;ZoomMode&quot;, and &quot;Apply&quot;
3075 are available.
3076 The two selection commands allow you to mark a set of
3077 messages as being &quot;selected&quot;.
3078 The &quot;ZoomMode&quot; command will toggle between
3079 displaying only the selected messages and displaying all the messages.
3080 The &quot;Apply&quot; command allows you to
3081 apply one of the regular MESSAGE INDEX commands to all of the selected
3082 messages instead of to only the highlighted message.
3083 <P>
3084 An example aggregate operation would be to catch up when reading
3085 a news group.
3086 That is, get rid of all the messages in the news group so that you can
3087 start fresh.
3088 The easiest way to do this in Alpine is to use aggregate operations.
3089 You want to Delete all of the messages in the group.
3090 You could start at the top and type &quot;D&quot; once for every message.
3091 A much faster method is to first Select all of the messages in the group,
3092 and then Delete all of them.
3093 This would take four keystrokes:
3094 <P>
3095 <CENTER><SAMP>; a (to select all messages)</SAMP></CENTER>
3096 <BR>
3097 <CENTER><SAMP>a d (to delete all selected messages)</SAMP></CENTER>
3098 <P>
3099 Another use of Select is to use it for searching for a particular message
3100 or set of messages in a large folder.
3101 You may know that the message was From a certain user.
3102 You could select all messages from that user to start, and use Zoom to
3103 look at only those messages.
3104 If there were still too many messages to look at you could Narrow the
3105 set of messages further by selecting from all of those messages only
3106 the ones that were after a certain date, or contained a particular phrase
3107 in the Subject, or were too a particular address, and so on.
3108 That may be the end of what you are doing, or you may want to use Apply to
3109 Save or Forward or Print all of the selected messages.
3110 <P>
3111 Some related help topics are
3112 <UL>
3113 <LI> <A HREF="h_index_cmd_select">Selecting: Select and WhereIs/Select</A>,
3114 <LI> <A HREF="h_config_enable_agg_ops"><!--#echo var="FEAT_enable-aggregate-command-set"--></A>,
3115 <LI> <A HREF="h_config_auto_unselect"><!--#echo var="FEAT_auto-unselect-after-apply"--></A>.
3116 <LI> <A HREF="h_config_auto_unzoom"><!--#echo var="FEAT_auto-unzoom-after-apply"--></A>,
3117 <LI> <A HREF="h_config_auto_zoom"><!--#echo var="FEAT_auto-zoom-after-select"--></A>, and
3118 <LI> <A HREF="h_config_select_wo_confirm"><!--#echo var="FEAT_select-without-confirm"--></A>.
3119 </UL>
3120 <P>
3121 &lt;End of help on this topic&gt;
3122 </BODY>
3123 </HTML>
3124 ===== h_mainhelp_readingnews ======
3125 <HTML>
3126 <HEAD>
3127 <TITLE>Reading News</TITLE>
3128 </HEAD>
3129 <BODY>
3130 <H1>Reading News</H1>
3131
3132 <H2>Background</H2>
3133 Alpine can read and post to Internet (or USENET) newsgroups, using the same
3134 commands as for mail. Similar to mailing lists but existing on a larger scale,
3135 Usenet newsgroups allow groups of people with common interests to discuss
3136 particular topics. You might find newsgroups related to your career, or you
3137 might wish to check out the online discussion among the fans of your favorite
3138 television show.
3139
3140 <H2>Configuring Alpine for Reading News</H2>
3141 Alpine often arrives
3142 pre-configured by your system administrator to automatically access the
3143 newsgroups offered by your organization, Internet Service Provider, or
3144 school. PC-Alpine users, and those attempting to customize Unix Alpine, will
3145 need additional details on <a href="h_configuring_news">how to
3146 configure Alpine to read news</a>.
3147
3148 <H2>Accessing Newsgroups</H2>
3149 The first step in reading news is to access the newsgroups collections
3150 screen from Alpine. If everything is configured properly, you should be able
3151 to do this by first typing L (folder List), then selecting the folder
3152 collection listed as "News." The actual name of this collection may differ
3153 from system to system.
3154
3155 <H2>Subscribing to Newsgroups</H2>
3156
3157 Once you have accessed the news collection, you need to subscribe to a
3158 newsgroup that interests you. Subscribing to a newsgroup means that Alpine
3159 will keep a record of the newsgroups in which you are interested and which
3160 articles in those newsgroups have been read.
3161
3162 <H2>Using Newsgroups</H2>
3163 Alpine uses the similar commands to read news as to read mail. For example,
3164 the D command marks messages as Deleted (or "Dismissed," if you prefer),
3165 and the R command Replies to a news posting. Basically, Alpine allows you to
3166 read news as if it were mail, so you don't need to change the way you
3167 interact with Alpine.
3168 <P>
3169 There is also additional Alpine help available on
3170 <A HREF="h_reading_news">how to use Alpine to read news</A>.
3171 <P>
3172 &lt;End of help on this topic&gt;
3173 </BODY>
3174 </HTML>
3175 ===== h_mainhelp_securing ======
3176 <HTML>
3177 <HEAD>
3178 <TITLE>Securing your Alpine Session</TITLE>
3179 </HEAD>
3180 <BODY>
3181 <H1>Securing your Alpine Session</H1>
3182
3183 By default, Alpine will attempt to connect to an IMAP server on the normal
3184 IMAP service port (143).
3185 If the Alpine you are using has been built to
3186 support &quot;Transport Layer Security&quot; (TLS)
3187 and &quot;Secure Sockets Layer&quot; (SSL)
3188 (check by clicking <A HREF="X-Alpine-Config:">here</A>),
3189 and the server offers the STARTTLS capability, then a secure (encrypted)
3190 session will be established.
3191 <P>
3192 When you are connected to a remote folder the titlebar will contain a plus sign
3193 in the far right column if the connection is encrypted using TLS or SSL.
3194 Similarly, when you are being prompted for a password a plus sign will appear in the prompt
3195 if the connection is encrypted.
3196
3197 <H2>More Information on Alpine with SSL and TLS</H2>
3198 <UL>
3199 <LI> <A HREF="h_release_tlscerts">TLS and SSL Usage Note</A> </LI>
3200 <LI> <A HREF="h_folder_server_syntax">/SSL</A> option for older servers which support port 993 SSL but not TLS </LI>
3201 <LI> <A HREF="h_config_alt_auth"><!--#echo var="FEAT_try-alternative-authentication-driver-first"--></A> feature </LI>
3202 <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>
3203 </UL>
3204 <H2>Here are some other security-related features and options</H2>
3205 <P>
3206 <UL>
3207 <LI> <A HREF="h_config_disable_password_caching"><!--#echo var="FEAT_disable-password-caching"--></A> feature to disable password caching </LI>
3208 <LI> <A HREF="h_config_disable_password_file_saving"><!--#echo var="FEAT_disable-password-file-saving"--></A> Disable password file saving</LI>
3209 <LI> <A HREF="h_config_mailcap_params"><!--#echo var="FEAT_enable-mailcap-param-substitution"--></A> feature </LI>
3210 <LI> <A HREF="h_config_disable_auths"><!--#echo var="VAR_disable-these-authenticators"--></A> option </LI>
3211 </UL>
3212 <P>
3213 &lt;End of help on this topic&gt;
3214 </BODY>
3215 </HTML>
3216 ===== h_mainhelp_problems ======
3217 <HTML>
3218 <HEAD>
3219 <TITLE>Reporting Problems</TITLE>
3220 </HEAD>
3221 <BODY>
3222 <H1>Reporting Problems</H1>
3223
3224 We ask that you first read the relevant help screens and then seek
3225 assistance from your own local support staff.  Once you are sure that your
3226 difficulty is not a local configuration problem, you might look at the
3227 help section explaining where to look for
3228 <A HREF="h_finding_help">more information</A> and where to
3229 get assistance.
3230 <P>
3231
3232 <ADDRESS>
3233    Eduardo Chappa &lt;chappa@gmx.com&gt;
3234 </ADDRESS>
3235
3236 <P>
3237 &lt;End of help on this topic&gt;
3238 </BODY>
3239 </HTML>
3240 ===== h_main_menu_commands ======
3241 <HTML>
3242 <HEAD>
3243 <TITLE>MAIN MENU COMMANDS</TITLE>
3244 </HEAD>
3245 <BODY>
3246 <H1>MAIN MENU COMMANDS</H1>
3247
3248 <!--chtml if pinemode="function_key"-->
3249 &nbsp;Available&nbsp;Commands&nbsp;--
3250 &nbsp;Group&nbsp;1&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;2<BR>
3251 &nbsp;------------------------------
3252 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;--------------------
3253 ----------<BR>
3254 &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>
3255 &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>
3256 &nbsp;F3&nbsp;&nbsp;Quit&nbsp;Alpine<BR>
3257 &nbsp;F4&nbsp;&nbsp;Execute&nbsp;current&nbsp;MAIN&nbsp;MENU&nbsp;command&nbsp;&nbsp;&nbsp;F4&nbsp;&nbsp;<A
3258 HREF="h_common_compose">Compose</A>&nbsp;a&nbsp;message<BR>
3259 &nbsp;F5&nbsp;&nbsp;Select&nbsp;previous&nbsp;command&nbsp;up&nbsp;on&nbsp;menu&nbsp;&nbsp;F5&nbsp;&nbsp;<A
3260 HREF="h_common_folders">FOLDER&nbsp;LIST</A>&nbsp;screen<BR>
3261 &nbsp;F6&nbsp;&nbsp;Select&nbsp;next&nbsp;command&nbsp;down&nbsp;on&nbsp;menu&nbsp;&nbsp;&nbsp;&nbsp;F6&nbsp;&nbsp;<A
3262 HREF="h_common_goto">Goto</A>&nbsp;a&nbsp;specified&nbsp;folder<BR>
3263 &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;
3264 &nbsp;F7&nbsp;&nbsp;<A
3265 HREF="h_common_index">MESSAGE&nbsp;INDEX</A>&nbsp;screen<BR>
3266 &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;
3267 &nbsp;F8&nbsp;&nbsp;<A
3268 HREF="h_main_journal">Journal</A>&nbsp;of&nbsp;status&nbsp;messages<BR>
3269 &nbsp;F9&nbsp;&nbsp;Display&nbsp;<A
3270 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
3271 HREF="h_main_setup">SETUP</A>&nbsp;menus<BR>
3272 &nbsp;F10&nbsp;<A
3273 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
3274 HREF="h_main_addrbook">ADDRESS&nbsp;BOOK</A>&nbsp;screen<BR>
3275 &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;
3276 &nbsp;F11&nbsp;<A
3277 HREF="h_common_role">Compose&nbsp;message&nbsp;using&nbsp;a&nbsp;role</a><BR>
3278 <!--chtml else-->
3279 &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>
3280 &nbsp;---------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;--------------------------<BR>
3281 &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>
3282 &nbsp;C&nbsp;&nbsp;<A
3283 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>
3284 &nbsp;I&nbsp;&nbsp;<A
3285 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>
3286 &nbsp;L&nbsp;&nbsp;<A
3287 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>
3288 &nbsp;A&nbsp;&nbsp;<A
3289 HREF="h_main_addrbook">ADDRESS&nbsp;BOOK</A>&nbsp;screen&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;K&nbsp;&nbsp;<A
3290 HREF="h_main_kblock">Lock&nbsp;Keyboard</A><BR>
3291 &nbsp;S&nbsp;&nbsp;<A
3292 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
3293 HREF="h_common_goto">Goto</A>&nbsp;a&nbsp;specified&nbsp;folder<BR>
3294 &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>
3295 &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
3296 HREF="h_common_role">Compose&nbsp;message&nbsp;using&nbsp;a&nbsp;role</a><BR>
3297 <!--chtml endif-->
3298
3299 <P>
3300 NOTE:
3301 <OL>
3302  <LI>For help on a particular command, highlight the bold text associated
3303 with it above and hit Return.
3304  <LI> The availability of certain commands (e.g. some of the options under
3305 SETUP) is determined by Alpine configuration files and system capabilities.
3306 At some sites, certain commands may not be available due to security or
3307 support concerns.
3308 </OL>
3309 <P>
3310 &lt;End of help on this topic&gt;
3311 </BODY>
3312 </HTML>
3313
3314 ===== h_command_line_options ======
3315 <HTML>
3316 <HEAD>
3317 <TITLE>COMMAND LINE OPTIONS</TITLE>
3318 </HEAD>
3319 <BODY>
3320 <H1>COMMAND LINE OPTIONS</H1>
3321 Possible starting arguments for Alpine:
3322
3323 <DL COMPACT>
3324
3325 <DT> <EM>[addresses]</EM>
3326
3327 <DD> Send-to:  If you give <EM>Alpine</EM> an argument or arguments which
3328 do not begin with a dash, <EM>Alpine</EM> treats them as email addresses.
3329 <EM>Alpine</EM> will startup in
3330 the composer with a message started to the addresses specified.
3331 Once the message is sent, the <EM>Alpine</EM> session closes.
3332 Standard input redirection is allowed.
3333 Separate multiple addresses with a space between them.
3334 Addresses are placed in the &quot;To&quot; field only.
3335 <P>
3336
3337 <DT> &lt; <EM>file</EM>
3338
3339 <DD> <EM>Alpine</EM> will startup in the composer with <EM>file</EM> read
3340 into the body of the message.
3341 Once the message is sent, the <EM>Alpine</EM> session closes.
3342 <P>
3343
3344 <DT> -attach <EM>file</EM>
3345
3346 <DD> Go directly into composer with given file attached.
3347 <P>
3348
3349 <DT> -attachlist <EM>file-list</EM>
3350
3351 <DD> Go directly into composer with given files attached.
3352 This must be the last option on the command line.
3353 <P>
3354
3355 <DT> -attach_and_delete <EM>file</EM>
3356
3357 <DD> Go directly into composer with given file attached, delete when finished.
3358 <P>
3359
3360 <DT> -aux <EM>local_directory</EM>
3361
3362 <DD> <EM>PC-Alpine</EM> only.
3363 This tells <EM>PC-Alpine</EM> the local directory to use for storing auxiliary
3364 files, like debug files, address books, and signature files.  The pinerc may
3365 be local or remote.
3366 <P>
3367
3368 <DT> -bail
3369
3370 <DD> If the personal configuration file doesn't already exist, exit.
3371 This might be useful if the configuration file is accessed using some
3372 remote filesystem protocol. If the remote mount is missing this will cause
3373 <EM>Alpine</EM> to quit instead of creating a new pinerc.
3374 <P>
3375
3376 <DT> -c <EM>n</EM>
3377
3378 <DD> When used with the <CODE>-f</CODE> option, apply the <EM>n</EM>th context.
3379 This is used when there are multiple folder collections (contexts) and you
3380 want to open a folder not in the primary collection.
3381 <P>
3382
3383 <DT> -conf
3384
3385 <DD> Configuration: Prints a sample system configuration file to the
3386 screen or standard output. To generate an initial system configuration
3387 file, execute
3388
3389 <PRE><CODE>
3390                 pine -conf > <!--#echo var="PINE_CONF_PATH"-->
3391 </CODE></PRE>
3392 <P>
3393
3394 To generate a system configuration file using settings from an old
3395 system configuration file, execute
3396
3397 <PRE><CODE>
3398                 pine -P old-pine.conf -conf > <!--#echo var="PINE_CONF_PATH"-->
3399 </CODE></PRE>
3400 <P>
3401 A system configuration file is not required.
3402 <P>
3403
3404 <DT> -copy_abook &lt;<EM>local_abook_file</EM>&gt; &lt;<EM>remote_abook_folder</EM>&gt;
3405
3406 <DD> Copy an address book file to a remote address book folder.
3407 If the remote folder doesn't exist, it will be created.
3408 If it exists but the first message in the folder isn't a remote address
3409 book header message, the copy will be aborted.
3410 This flag will not usually be used by a user.
3411 Instead, the user will create a remote address book from within <EM>Alpine</EM>
3412 and copy entries from the local address book by using aggregate Save in
3413 the address book screen.
3414 <P>
3415
3416 <DT> -copy_pinerc &lt;<EM>local_pinerc_file</EM>&gt; &lt;<EM>remote_pinerc_folder</EM>&gt;
3417
3418 <DD> Copy a pinerc configuration file to a remote pinerc folder.
3419 If the remote folder doesn't exist, it will be created.
3420 If it exists but the first message in the folder isn't a remote pinerc
3421 header message, the copy will be aborted.
3422 This flag may be useful to users who already have a local pinerc file and
3423 would like to convert it to a remote pinerc folder and use that instead.
3424 This gives a way to bootstrap that conversion without having to manually
3425 reset all of the variables in the remote pinerc folder.
3426 <P>
3427
3428 <DT> -d <EM>debug-level</EM>
3429
3430 <DD> Debug Level:  Sets the level of debugging information written by
3431 <EM>Alpine</EM>.
3432 <EM>debug-level</EM> can be set to any integer 0-9.
3433 A debug level of 0 turns off debugging for the session.
3434 (Actually there are some levels higher than 9, but you probably don't
3435 want to see them.)
3436 <P>
3437
3438 <DT> -d <EM>keywords</EM>
3439
3440 <DD> You may use a more detailed version of the debugging flag to set
3441 the debug level in separate parts of <EM>Alpine</EM>.
3442 The possibilities are flush, timestamp, imap=0..4, tcp, numfiles=0..31, and
3443 verbose=0..9.
3444 <EM>Flush</EM> causes debugging information to be flushed immediately to
3445 the debug file as it is written.
3446 <EM>Verbose</EM> is the general debugging verbosity level.
3447 <EM>Timestamp</EM> causes timestamps to be added to the debug file, which
3448 is useful when you are trying to figure out what is responsible for delays.
3449 <EM>Numfiles</EM> sets the number of debug files saved.
3450 <EM>Imap</EM> sets the debug level for the debugging statements related
3451 to the conversation with the IMAP server, and more generally, for the
3452 debugging related to <EM>Alpine</EM>'s interaction with the C-Client library.
3453 <EM>Tcp</EM> turns on some TCP/IP debugging.
3454 <P>
3455
3456 <DT> -f <EM>folder</EM>
3457
3458 <DD> Startup folder:  <EM>Alpine</EM> will open this folder in place
3459 of the standard INBOX.
3460 <P>
3461
3462 <DT> -F <EM>file</EM>
3463
3464 <DD> Open named text file for viewing and forwarding.
3465 <P>
3466
3467 <DT> -h
3468
3469 <DD> Help:  Prints the list of available command-line arguments to the
3470 screen.
3471 <P>
3472
3473 <DT> -i
3474
3475 <DD> <EM>Alpine</EM> will start up in the FOLDER INDEX
3476 screen instead of the MAIN MENU.
3477 <P>
3478
3479 Configuration equivalent:  <EM><!--#echo var="VAR_initial-keystroke-list"-->=i</EM>.
3480 <P>
3481
3482 <DT> -I <EM>a,b,c,...</EM>
3483
3484 <DD> Initial Keystrokes:  <EM>Alpine</EM> will execute this comma-separated
3485 sequence of commands upon startup.
3486 This allows users to get <EM>Alpine</EM> to start in any
3487 of its menus/screens.
3488 You cannot include any input to the composer in the initial keystrokes.
3489 The key &lt;Return&gt; is represented by a ``CR'' in
3490 the keystroke list; the spacebar is designated by the letters ``SPACE''.
3491 Control keys are two character sequences beginning with ``^'', such as
3492 ``^I''.
3493 A tab character is ``TAB''.
3494 Function keys are ``F1'' - ``F12'' and the arrow keys are ``UP'',
3495 ``DOWN'', ``LEFT'', and ``RIGHT''.
3496 A restriction is that you can't mix function keys and character keys in this
3497 list even though you can, in some cases, mix them when running <EM>Alpine</EM>.
3498 A user can always use only <EM>character</EM> keys in the startup list even
3499 if he or she is using <EM>function</EM> keys normally, or vice versa.
3500 If an element in this list is a string of characters surrounded by double
3501 quotes (&quot;) then it will be expanded into the individual characters in
3502 the string, excluding the double quotes.
3503 <P>
3504
3505 Configuration equivalent:  <EM><!--#echo var="VAR_initial-keystroke-list"--></EM>
3506 <P>
3507
3508 <DT> -install
3509
3510 <DD> For <EM>PC-Alpine</EM> only, this option prompts the user for
3511 some basic information to help with getting properly set up.
3512 <P>
3513
3514 <DT> -k
3515
3516 <DD> Function-Key Mode:  When invoked in this way, <EM>Alpine</EM> expects
3517 the input of commands to be function-keys.
3518 Otherwise, commands are linked to the regular character keys.
3519 <P>
3520
3521 Configuration equivalent:  <EM><!--#echo var="FEAT_use-function-keys"--></EM> included in
3522 <EM>Feature-List</EM>.
3523 <P>
3524
3525 <DT> -n <EM>n</EM>
3526
3527 <DD> Message-Number:  When specified, <EM>Alpine</EM> starts up in the
3528 FOLDER INDEX screen with the current message being the specified
3529 message number.
3530 <P>
3531
3532 <DT> -nosplash
3533
3534 <DD> <EM>PC-Alpine</EM> only.
3535 This tells <EM>PC-Alpine</EM> not to display the splash screen upon startup.
3536 This may be helpful for certain troubleshooting or terminal server scenarios.
3537 <P>
3538
3539 <DT> -o <EM>folder</EM>
3540
3541 <DD> Opens the INBOX (or a folder specified via the -f argument) ReadOnly.
3542 <P>
3543
3544 <DT> -p <EM>pinerc</EM>
3545
3546 <DD> Uses the named file as the personal configuration file instead of
3547 <EM>~/.pinerc</EM> or the default PINERC search sequence <EM>PC-Alpine</EM> uses.
3548 Alpinerc may be either a local file or a remote configuration folder.
3549 <P>
3550
3551 <DT> -P <EM>pinerc</EM>
3552
3553 <DD> Uses the named file as the system wide configuration file instead of
3554 <EM><!--#echo var="PINE_CONF_PATH"--></EM> on UNIX, or nothing on <EM>PC-Alpine</EM>.
3555 Alpinerc may be either a local file or a remote configuration folder.
3556 <P>
3557
3558 <DT> -passfile <EM>passfile</EM>
3559
3560 <DD> This tells <EM>Alpine</EM> what file should be used as the password file.
3561 This should be a fully-qualified filename.
3562 <P>
3563
3564 <DT> -pinerc <EM>file</EM>
3565
3566 <DD> Output fresh pinerc configuration to <EM>file</EM>, preserving the
3567 settings of variables that the user has made.
3568 Use <EM>file</EM> set to ``-'' to make output go to standard out.
3569 <P>
3570
3571 <DT> -r
3572
3573 <DD> Restricted Mode:  For UNIX <EM>Alpine</EM> only.
3574 <EM>Alpine</EM> in restricted mode can only send email to itself.
3575 Save and export are limited.
3576 <P>
3577
3578 <DT> -registry <EM>cmd</EM>
3579
3580 <DD> For <EM>PC-Alpine</EM> only, this option affects the values of
3581 <EM>Alpine</EM>'s registry entries.
3582 Possible values for <EM>cmd</EM> are set, clear, and dump.
3583 <EM>Set</EM> will always reset <EM>Alpine</EM>'s registry
3584 entries according to its current settings.
3585 <EM>Clear</EM> will clear the registry values.
3586 <EM>Clearsilent</EM> will clear the registry values without any dialogs.
3587 <EM>Dump</EM> will display the values of current registry settings.
3588 Note that the dump command is currently disabled.
3589 Without the -registry option, <EM>PC-Alpine</EM> will write values into
3590 the registry only if there currently aren't any values set.
3591 <P>
3592
3593 <DT> -sort <EM>key</EM>
3594
3595 <DD> Sort-Key:  Specifies the order messages will be displayed in for the
3596 FOLDER INDEX screen.
3597 <EM>Key</EM> can have the following values:
3598 arrival, date, subject, orderedsubj, thread, from, size, score, to, cc,
3599 arrival/reverse, date/reverse, subject/reverse, orderedsubj/reverse, thread/reverse,
3600 from/reverse, size/reverse, score/reverse, to/reverse, and cc/reverse.
3601 The default value is &quot;arrival&quot;.
3602 The <EM>key</EM> value reverse is equivalent to arrival/reverse.
3603 <P>
3604
3605 Configuration equivalent:  <EM><!--#echo var="VAR_sort-key"--></EM>.
3606 <P>
3607
3608 <DT> -uninstall
3609
3610 <DD> For <EM>PC-Alpine</EM> only, this option removes references to Alpine
3611 in Windows settings.  The registry settings are removed and
3612 the password cache is cleared.
3613 <P>
3614
3615 <DT> -url <EM>url</EM>
3616
3617 <DD> Open the given URL.
3618 <P>
3619
3620 <DT> -v
3621
3622 <DD> Version:  Print version information to the screen.
3623 <P>
3624
3625 <DT> -x <EM>exceptions_config</EM>
3626
3627 <DD> Configuration settings in the exceptions configuration override your normal
3628 default settings.
3629 <EM>Exceptions_config</EM> may be either a local file or a remote Alpine configuration folder.
3630 <P>
3631
3632 <DT> -z
3633
3634 <DD> Enable Suspend:  When run with this flag, the key sequence ctrl-z
3635 will suspend the <EM>Alpine</EM> session.
3636 <P>
3637
3638 Configuration equivalent:  <EM><!--#echo var="FEAT_enable-suspend"--></EM> included in
3639 <EM>Feature-List</EM>.
3640 <P>
3641
3642 <DT> -<EM>option</EM>=<EM>value</EM>
3643
3644 <DD> Assign <EM>value</EM> to the config option <EM>option</EM>.
3645 For example, <EM>-signature-file=sig1</EM> or
3646 <EM>-Feature-List=signature-at-bottom</EM>.
3647 Note:  Feature-List values are
3648 additive and features may be preceded with no- to turn them off.
3649 Also, as a special case, the &quot;Feature-List=&quot; part of that may be
3650 omitted. For example, <EM>-signature-at-bottom</EM> is equivalent to
3651 <EM>-Feature-List=signature-at-bottom</EM>.
3652 <P>
3653
3654 </DL>
3655 <P>
3656 &lt;End of help on this topic&gt;
3657 </BODY>
3658 </HTML>
3659 ===== h_configuring_news ======
3660 <HTML>
3661 <HEAD>
3662 <TITLE>CONFIGURING NEWS</TITLE>
3663 </HEAD>
3664 <BODY>
3665 <H1>CONFIGURING NEWS</H1>
3666 Alpine can access news folders in any one of three different ways:
3667 <DL>
3668 <DT>REMOTE NNTP</DT>
3669 <DD>Using the Network News Transport Protocol (NNTP) to
3670 access news on a remote news server.  In this case the newsrc file is
3671 stored on the machine where Alpine is running.
3672
3673 <P>
3674 To specify a remote news-collection accessed via NNTP use the
3675 SETUP/collectionList screen's &quot;Add&quot; command.  Set the
3676 Server: value to the NNTP server's hostname appended with the
3677 communication method &quot;/service=NNTP&quot;, and set the Path:
3678 value to the &quot;#news.&quot; namespace (without the quotes).  See
3679 the &quot;<A HREF="h_composer_cntxt_server">Server:</A>&quot; field's
3680 help text for a more complete explanation of access method, and the
3681 &quot;<A HREF="h_composer_cntxt_path">Path:</A>&quot; field's help
3682 text for a more complete explanation of &quot;namespace&quot;.
3683 <P>
3684 Instead of specifying a news-collection, you may simply set the
3685 <A HREF="h_config_nntp_server">NNTP Server</A>
3686 option, which will cause Alpine to create a default news-collection for you.
3687 Another NNTP option that may be of interest is
3688 <A HREF="h_config_nntprange"><!--#echo var="VAR_nntp-range"--></A>.
3689
3690 <DT>REMOTE IMAP</DT>
3691 <DD>Using the Internet Message Access Protocol (IMAP) to
3692 access news on a remote news server.  In this case, your newsrc file is
3693 stored on the news server, in your home directory, so you must have an
3694 account on the news server, but you would be running Alpine on a different
3695 machine.  The news server must be running an IMAPd server process.
3696
3697 <P>
3698 To specify a remote news-collection accessed via IMAP use the
3699 SETUP/collectionList screen's &quot;Add&quot; command.  Set the
3700 Server: value to the IMAP server's hostname, and set the Path: value
3701 to the &quot;#news.&quot; namespace (without the quotes).  See the
3702 &quot;<A HREF="h_composer_cntxt_path">Path:</A>&quot; field's help
3703 text for a more complete explanation of &quot;namespace&quot;.
3704
3705 </DD>
3706
3707 <DT>LOCAL</DT>
3708 <DD>Using local file access to the news database.  In this
3709 case, your newsrc file is stored on the news server, in your home
3710 directory, so you must have an account on the news server, and you would
3711 be running Alpine on the same machine.
3712
3713 <P>
3714 To specify a local news-collection use the SETUP/collectionList
3715 screen's &quot;Add&quot; command.  Leave the Server: value blank, and
3716 set the Path: value to the &quot;#news.&quot; namespace (without the
3717 quotes).  See the &quot;<A HREF="h_composer_cntxt_path">Path:</A>&quot;
3718 field's help text for a more complete explanation of &quot;namespace&quot;.
3719
3720 </DD>
3721 </DL>
3722
3723 <P>
3724
3725 NOTE: Should no news-collection be defined as above, Alpine will
3726 automatically create one using the Setup/Config screen's
3727 &quot;<!--#echo var="VAR_nntp-server"-->&quot; variable's value if defined.  The collection
3728 will be created as a &quot;Remote NNTP&quot; as described above.
3729
3730 <P>
3731
3732 If you are a PC-Alpine user, either option 1 (NNTP) or option 2 (IMAP) is
3733 possible.  If you don't have an account on the news server, or if the news
3734 server is not running an IMAP daemon, then you must use NNTP.  (If you are not
3735 sure, ask your service provider, university, or company for help.)  In
3736 this case, your Unix .newsrc file can be transferred to your PC.  A good
3737 place to put it would be in the same directory as your PINERC file, under
3738 the name NEWSRC, but you can
3739 <A HREF="h_config_newsrc_path">specify a different location</A>
3740 via Alpine's Setup/Config screen.
3741
3742 <P>
3743 Other configuration features related to news are
3744 <A HREF="h_config_8bit_nntp"><!--#echo var="FEAT_enable-8bit-nntp-posting"--></A>.
3745 <A HREF="h_config_compose_news_wo_conf"><!--#echo var="FEAT_compose-sets-newsgroup-without-confirm"--></A>,
3746 <A HREF="h_config_news_uses_recent"><!--#echo var="FEAT_news-approximates-new-status"--></A>,
3747 <A HREF="h_config_news_cross_deletes"><!--#echo var="FEAT_news-deletes-across-groups"--></A>,
3748 <A HREF="h_config_news_catchup"><!--#echo var="FEAT_news-offers-catchup-on-close"--></A>,
3749 <A HREF="h_config_post_wo_validation"><!--#echo var="FEAT_news-post-without-validation"--></A>,
3750 <A HREF="h_config_read_in_newsrc_order"><!--#echo var="FEAT_news-read-in-newsrc-order"--></A>, and
3751 <A HREF="h_config_quell_post_prompt"><!--#echo var="FEAT_quell-extra-post-prompt"--></A>.
3752
3753 <P>
3754 &lt;End of help on this topic&gt;
3755 </BODY>
3756 </HTML>
3757 ===== h_reading_news ======
3758 <HTML>
3759 <HEAD>
3760 <TITLE>READING NEWS</TITLE>
3761 </HEAD>
3762 <BODY>
3763 <H1>READING NEWS</H1>
3764
3765 Alpine uses almost the same commands for manipulating news folders as for
3766 mail folders.  This means, for example, that when you are done with a
3767 message, you would use &quot;D&quot; to mark it as Deleted (or Dismissed,
3768 if you prefer.)  This &quot;mail-like&quot; behavior differs from that of
3769 most newsreaders, wherein a message is implicitly dismissed after you have
3770 looked at it once. We strongly believe that Alpine should offer as much
3771 consistency as possible between mail and news, so the mail paradigm --
3772 wherein a message does not magically disappear without explicit action by
3773 the user -- is used for news as well. <P>
3774
3775 If you answer a message in a news folder, the index view will show the
3776 &quot;A&quot; flag as usual; but the industry standard file Alpine uses to
3777 keep track of what news as been read has no way of storing this flag, so
3778 it will not be preserved across sessions.  The Deleted flag is the only
3779 one that is preserved when you leave and then return to a newsgroup.  As an
3780 additional note on replies, when you Reply to a newsgroup message and say
3781 you want to reply to all recipients, Alpine will ask if you want to post the
3782 message to all the newsgroups listed in the original message. <P>
3783
3784 If you would like Alpine to mark more-or-less recent news messages as
3785 &quot;New&quot;, then set the
3786 <A HREF="h_config_news_uses_recent">&quot;<!--#echo var="FEAT_news-approximates-new-status"-->&quot;</A>
3787 feature (which is set by default).  This will cause messages after the last one you have marked as
3788 Deleted to appear with &quot;N&quot; status in the MESSAGE INDEX.  The
3789 &quot;N&quot; status often makes it easier to distinguish later news
3790 articles from those you've previously seen, but not yet disposed of via
3791 the &quot;D&quot; key.  Note that this is an approximation, not an exact
3792 record of which messages you have not seen.
3793 <P>
3794
3795 A frequent operation in news-reading is &quot;catching up&quot; -- that
3796 is, getting rid of all the messages in the newsgroup so that you can
3797 &quot;start fresh.&quot;  The easiest way to do this in Alpine is via the
3798 Select command.  You would enter the following four keystrokes:
3799 <tt>;aad</tt> to select all messaged, and then apply the delete (or
3800 dismiss) command to all of them.
3801
3802 <P>
3803 There are also additional details on
3804 <A HREF="h_configuring_news">configuring news</a>.
3805
3806 <P>
3807 &lt;End of help on this topic&gt;
3808 </BODY>
3809 </HTML>
3810 ====== h_help_index ======
3811 <HTML>
3812 <HEAD>
3813 <TITLE>Help Index</TITLE>
3814 </HEAD>
3815 <BODY>
3816 <H1>Help Index</H1>
3817 <ul>
3818 <li><a href="h_mainhelp_abooks">Address Books</a></li>
3819 <li><a href="h_abook_top">ADDRESS BOOK LIST COMMANDS</a>
3820 <li><a href="h_main_addrbook">Address Book Command</a>
3821 <li><a href="h_abook_view">Address Book View Explained</a>
3822 <li><a href="h_compose_addrcomplete">Address Completion</a>
3823 <li><a href="h_abook_select_listmode">Address Listmode Selection from Composer Explained</a>
3824 <li><a href="h_abook_select_checks">Address Selection from Composer Explained</a>
3825 <li><a href="h_composer_abook_comment">Addressbook Comment Explained</a>
3826 <li><a href="h_composer_abook_fcc">Addressbook Fcc Explained</a>
3827 <li><a href="h_composer_abook_add_folder">Addressbook Folder Name Field Explained</a>
3828 <li><a href="h_composer_abook_full">Addressbook Fullname Explained</a>
3829 <li><a href="h_composer_abook_add_nick">Addressbook NickName Field Explained</a>
3830 <li><a href="h_composer_abook_nick">Addressbook Nickname Explained</a>
3831 <li><a href="h_abook_select_addr">Addressbook Selection Explained</a>
3832 <li><a href="h_abook_select_top">Addressbook Selection Navigation Explained</a>
3833 <li><a href="h_composer_abook_add_server">Addressbook Server Name Field Explained</a>
3834 <li><a href="h_mainhelp_aggops">Aggregate Operations</a>
3835 <li><a href="h_mainhelp_config">Alpine Configuration</a>
3836 <li><a href="h_mainhelp_pinehelp">Alpine Help</a>
3837 <li><a href="h_news_legal">Alpine Legal Notices</a>
3838 <li><a href="h_compose_alted">Alt Editor Command</a>
3839 <li><a href="h_index_cmd_apply">Apply Command</a>
3840 <li><a href="h_attachment_screen">Attachment Index Screen Explained</a>
3841 <li><a href="h_mail_text_att_view">Attachment View Screen Explained</a>
3842 <li><a href="h_mainhelp_filtering">Blocking Messages</a>
3843 <li><a href="h_composer_browse">BROWSER</a>
3844 <li><a href="h_common_bounce">Bounce Command</a>
3845 <li><a href="h_compose_cancel">Cancel Command</a>
3846 <li><a href="h_config_change_your_from">Changing your From Address</a>
3847 <li><a href="h_collection_screen">COLLECTION LIST screen</a>
3848 <li><a href="h_mainhelp_color">Color</a>
3849 <li><a href="h_composer_ctrl_j">COMPOSER ATTACH</a>
3850 <li><a href="h_composer">COMPOSER COMMANDS</a>
3851 <li><a href="h_mainhelp_composing">Composing Messages</a>
3852 <li><a href="h_mainhelp_collections">Collection Lists</a>
3853 <li><a href="h_composer_cntxt_nick">Collection Nickname Explained</a>
3854 <li><a href="h_composer_cntxt_path">Collection Path: Explained</a>
3855 <li><a href="h_composer_cntxt_server">Collection Server: Explained</a>
3856 <li><a href="h_composer_cntxt_view">Collection View: Explained</a>
3857 <li><a href="h_mainhelp_cmdlineopts">Command Line Options</a>
3858 <li><a href="h_common_compose">Compose Command</a>
3859 <li><a href="h_edit_nav_cmds">Composer Editing Commands Explained</a>
3860 <li><a href="h_common_conditional_cmds">Conditional Commands</a>
3861 <li><a href="h_reply_token_conditionals">Conditional Inclusion of Text for <!--#echo var="VAR_reply-leadin"-->, Signatures, and Templates</a>
3862 <li><a href="h_mainhelp_config">Configuration</a>
3863 <li><a href="h_composer_custom_free">CUSTOMIZED HEADER FIELD</a>
3864 <li><a href="h_config_dflt_color">Default Color</a>
3865 <li><a href="h_common_delete">Delete and Undelete Commands</a>
3866 <li><a href="h_composer_qserv_cn">Directory Query Form Explained</a>
3867 <li><a href="h_special_list_commands">Email List Commands Explained</a>
3868 <li><a href="h_composer_search">Explanation of Composer Whereis Command </a>
3869 <li><a href="h_folder_open">Explanation of Folder Selection</a>
3870 <li><a href="h_special_xon_xoff">Explanation of Alpine's XOFF/XON Handling</a>
3871 <li><a href="h_valid_folder_names">Explanation of Valid Folder Names</a>
3872 <li><a href="h_ge_export">Export File Selection</a>
3873 <li><a href="h_ge_allparts">Export Message File Selection</a>
3874 <li><a href="h_index_cmd_expunge">Expunge/Exclude Command</a>
3875 <li><a href="h_info_on_locking">FAQs on Alpine Locking</a>
3876 <li><a href="h_config_allow_chg_from">FEATURE: <!--#echo var="FEAT_allow-changing-from"--></a>
3877 <li><a href="h_config_allow_talk">FEATURE: <!--#echo var="FEAT_allow-talk"--></a>
3878 <li><a href="h_config_alt_compose_menu">FEATURE: <!--#echo var="FEAT_alternate-compose-menu"--></a>
3879 <li><a href="h_config_alt_role_menu">FEATURE: <!--#echo var="FEAT_alternate-role-menu"--></a>
3880 <li><a href="h_config_alt_reply_menu">FEATURE: <!--#echo var="FEAT_alternate-reply-menu"--></a>
3881 <li><a href="h_config_force_low_speed">FEATURE: <!--#echo var="FEAT_assume-slow-link"--></a>
3882 <li><a href="h_config_auto_read_msgs">FEATURE: <!--#echo var="FEAT_auto-move-read-msgs"--></a>
3883 <li><a href="h_config_auto_open_unread">FEATURE: <!--#echo var="FEAT_auto-open-next-unread"--></a>
3884 <li><a href="h_config_auto_unselect">FEATURE: <!--#echo var="FEAT_auto-unselect-after-apply"--></a>
3885 <li><a href="h_config_auto_unzoom">FEATURE: <!--#echo var="FEAT_auto-unzoom-after-apply"--></a>
3886 <li><a href="h_config_auto_zoom">FEATURE: <!--#echo var="FEAT_auto-zoom-after-select"--></a>
3887 <li><a href="h_config_use_boring_spinner">FEATURE: <!--#echo var="FEAT_busy-cue-spinner-only"--></a>
3888 <li><a href="h_config_check_mail_onquit">FEATURE: <!--#echo var="FEAT_check-newmail-when-quitting"--></a>
3889 <li><a href="h_config_combined_abook_display">FEATURE: <!--#echo var="FEAT_combined-addrbook-display"--></a>
3890 <li><a href="h_config_combined_folder_display">FEATURE: <!--#echo var="FEAT_combined-folder-display"--></a>
3891 <li><a href="h_config_combined_subdir_display">FEATURE: <!--#echo var="FEAT_combined-subdirectory-display"--></a>
3892 <li><a href="h_config_cancel_confirm">FEATURE: <!--#echo var="FEAT_compose-cancel-confirm-uses-yes"--></a>
3893 <li><a href="h_config_lame_list_mode">FEATURE: <!--#echo var="FEAT_enable-lame-list-mode"--></a>
3894 <li><a href="h_config_compose_rejects_unqual">FEATURE: <!--#echo var="FEAT_compose-rejects-unqualified-addrs"--></a>
3895 <li><a href="h_config_send_filter_dflt">FEATURE: <!--#echo var="FEAT_compose-send-offers-first-filter"--></a>
3896 <li><a href="h_config_compose_news_wo_conf">FEATURE: <!--#echo var="FEAT_compose-sets-newsgroup-without-confirm"--></a>
3897 <li><a href="h_config_del_from_dot">FEATURE: <!--#echo var="FEAT_compose-cut-from-cursor"--></a>
3898 <li><a href="h_config_compose_maps_del">FEATURE: <!--#echo var="FEAT_compose-maps-delete-key-to-ctrl-d"--></a>
3899 <li><a href="h_config_confirm_role">FEATURE: <!--#echo var="FEAT_confirm-role-even-for-default"--></a>
3900 <li><a href="h_config_tab_no_prompt">FEATURE: <!--#echo var="FEAT_continue-tab-without-confirm"--></a>
3901 <li><a href="h_config_dates_to_local">FEATURE: <!--#echo var="FEAT_convert-dates-to-localtime"--></a>
3902 <li><a href="h_config_copy_to_to_from">FEATURE: <!--#echo var="FEAT_copy-to-address-to-from-if-it-is-us"--></a>
3903 <li><a href="h_config_del_skips_del">FEATURE: <!--#echo var="FEAT_delete-skips-deleted"--></a>
3904 <li><a href="h_config_disable_config_cmd">FEATURE: <!--#echo var="FEAT_disable-config-cmd"--></a>
3905 <li><a href="h_config_disable_index_locale_dates">FEATURE: <!--#echo var="FEAT_disable-index-locale-dates"--></a>
3906 <li><a href="h_config_disable_kb_lock">FEATURE: <!--#echo var="FEAT_disable-keyboard-lock-cmd"--></a>
3907 <li><a href="h_config_blank_keymenu">FEATURE: <!--#echo var="FEAT_disable-keymenu"--></a>
3908 <li><a href="h_config_disable_password_caching">FEATURE: <!--#echo var="FEAT_disable-password-caching"--></a>
3909 <li><a href="h_config_disable_password_cmd">FEATURE: <!--#echo var="FEAT_disable-password-cmd"--></a>
3910 <li><a href="h_config_disable_pipes_in_sigs">FEATURE: <!--#echo var="FEAT_disable-pipes-in-sigs"--></a>
3911 <li><a href="h_config_disable_pipes_in_templates">FEATURE: <!--#echo var="FEAT_disable-pipes-in-templates"--></a>
3912 <li><a href="h_config_disable_regex">FEATURE: <!--#echo var="FEAT_disable-regular-expression-matching-for-alternate-addresses"--></a>
3913 <li><a href="h_config_disable_roles_setup">FEATURE: <!--#echo var="FEAT_disable-roles-setup-cmd"--></a>
3914 <li><a href="h_config_disable_roles_sigedit">FEATURE: <!--#echo var="FEAT_disable-roles-sig-edit"--></a>
3915 <li><a href="h_config_disable_roles_templateedit">FEATURE: <!--#echo var="FEAT_disable-roles-template-edit"--></a>
3916 <li><a href="h_config_input_history">FEATURE: <!--#echo var="FEAT_disable-save-input-history"--></a>
3917 <li><a href="h_config_disable_collate">FEATURE: <!--#echo var="FEAT_disable-setlocale-collate"--></a>
3918 <li><a href="h_config_disable_shared">FEATURE: <!--#echo var="FEAT_disable-shared-namespaces"--></a>
3919 <li><a href="h_config_disable_signature_edit">FEATURE: <!--#echo var="FEAT_disable-signature-edit-cmd"--></a>
3920 <li><a href="h_config_take_fullname">FEATURE: <!--#echo var="FEAT_disable-take-fullname-in-addresses"--></a>
3921 <li><a href="h_config_take_lastfirst">FEATURE: <!--#echo var="FEAT_disable-take-last-comma-first"--></a>
3922 <li><a href="h_config_disable_reset_disp">FEATURE: <!--#echo var="FEAT_disable-terminal-reset-for-display-filters"--></a>
3923 <li><a href="h_config_disable_sender">FEATURE: <!--#echo var="FEAT_disable-sender"--></a>
3924 <li><a href="h_config_quell_dead_letter">FEATURE: <!--#echo var="FEAT_quell-dead-letter-on-cancel"--></a>
3925 <li><a href="h_config_quell_flowed_text">FEATURE: <!--#echo var="FEAT_quell-flowed-text"--></a>
3926 <li><a href="h_downgrade_multipart_to_text">FEATURE: <!--#echo var="FEAT_downgrade-multipart-to-text"--></a>
3927 <li><a href="h_config_8bit_smtp">FEATURE: <!--#echo var="FEAT_enable-8bit-esmtp-negotiation"--></a>
3928 <li><a href="h_config_8bit_nntp">FEATURE: <!--#echo var="FEAT_enable-8bit-nntp-posting"--></a>
3929 <li><a href="h_config_enable_agg_ops">FEATURE: <!--#echo var="FEAT_enable-aggregate-command-set"--></a>
3930 <li><a href="h_config_enable_alt_ed">FEATURE: <!--#echo var="FEAT_enable-alternate-editor-cmd"--></a>
3931 <li><a href="h_config_alt_ed_now">FEATURE: <!--#echo var="FEAT_enable-alternate-editor-implicitly"--></a>
3932 <li><a href="h_config_arrow_nav">FEATURE: <!--#echo var="FEAT_enable-arrow-navigation"--></a>
3933 <li><a href="h_config_relaxed_arrow_nav">FEATURE: <!--#echo var="FEAT_enable-arrow-navigation-relaxed"--></a>
3934 <li><a href="h_config_compose_bg_post">FEATURE: <!--#echo var="FEAT_enable-background-sending"--></a>
3935 <li><a href="h_config_enable_bounce">FEATURE: <!--#echo var="FEAT_enable-bounce-cmd"--></a>
3936 <li><a href="h_config_cruise_mode">FEATURE: <!--#echo var="FEAT_enable-cruise-mode"--></a>
3937 <li><a href="h_config_cruise_mode_delete">FEATURE: <!--#echo var="FEAT_enable-cruise-mode-delete"--></a>
3938 <li><a href="h_config_compose_dsn">FEATURE: <!--#echo var="FEAT_enable-delivery-status-notification"--></a>
3939 <li><a href="h_config_enable_dot_files">FEATURE: <!--#echo var="FEAT_enable-dot-files"--></a>
3940 <li><a href="h_config_enable_lessthan_exit">FEATURE: <!--#echo var="FEAT_enable-exit-via-lessthan-command"--></a>
3941 <li><a href="h_config_fast_recent">FEATURE: <!--#echo var="FEAT_enable-fast-recent-test"--></a>
3942 <li><a href="h_config_enable_flag">FEATURE: <!--#echo var="FEAT_enable-flag-cmd"--></a>
3943 <li><a href="h_config_flag_screen_default">FEATURE: <!--#echo var="FEAT_enable-flag-screen-implicitly"--></a>
3944 <li><a href="h_config_flag_screen_kw_shortcut">FEATURE: <!--#echo var="FEAT_enable-flag-screen-keyword-shortcut"--></a>
3945 <li><a href="h_config_enable_full_hdr_and_text">FEATURE: <!--#echo var="FEAT_enable-full-header-and-text"--></a>
3946 <li><a href="h_config_enable_full_hdr">FEATURE: <!--#echo var="FEAT_enable-full-header-cmd"--></a>
3947 <li><a href="h_config_allow_goto">FEATURE: <!--#echo var="FEAT_enable-goto-in-file-browser"--></a>
3948 <li><a href="h_config_enable_dot_folders">FEATURE: <!--#echo var="FEAT_enable-dot-folders"--></a>
3949 <li><a href="h_config_enable_incoming">FEATURE: <!--#echo var="FEAT_enable-incoming-folders"--></a>
3950 <li><a href="h_config_enable_incoming_checking">FEATURE: <!--#echo var="FEAT_enable-incoming-folders-checking"--></a>
3951 <li><a href="h_config_enable_jump">FEATURE: <!--#echo var="FEAT_enable-jump-shortcut"--></a>
3952 <li><a href="h_config_show_delay_cue">FEATURE: <!--#echo var="FEAT_enable-mail-check-cue"--></a>
3953 <li><a href="h_config_mailcap_params">FEATURE: <!--#echo var="FEAT_enable-mailcap-param-substitution"--></a>
3954 <li><a href="h_config_enable_mouse">FEATURE: <!--#echo var="FEAT_enable-mouse-in-xterm"--></a>
3955 <li><a href="h_config_enable_view_addresses">FEATURE: <!--#echo var="FEAT_enable-msg-view-addresses"--></a>
3956 <li><a href="h_config_enable_view_attach">FEATURE: <!--#echo var="FEAT_enable-msg-view-attachments"--></a>
3957 <li><a href="h_config_enable_view_arrows">FEATURE: <!--#echo var="FEAT_enable-msg-view-forced-arrows"--></a>
3958 <li><a href="h_config_enable_view_url">FEATURE: <!--#echo var="FEAT_enable-msg-view-urls"--></a>
3959 <li><a href="h_config_enable_view_web_host">FEATURE: <!--#echo var="FEAT_enable-msg-view-web-hostnames"--></a>
3960 <li><a href="h_config_enable_mulnewsrcs">FEATURE: <!--#echo var="FEAT_enable-multiple-newsrcs"--></a>
3961 <li><a href="h_config_enable_xterm_newmail">FEATURE: <!--#echo var="FEAT_enable-newmail-in-xterm-icon"--></a>
3962 <li><a href="h_config_enable_newmail_short_text">FEATURE: <!--#echo var="FEAT_enable-newmail-short-text-in-icon"--></a>
3963 <li><a href="h_config_sub_lists">FEATURE: <!--#echo var="FEAT_enable-partial-match-lists"--></a>
3964 <li><a href="h_config_enable_y_print">FEATURE: <!--#echo var="FEAT_enable-print-via-y-command"--></a>
3965 <li><a href="h_config_prefix_editing">FEATURE: <!--#echo var="FEAT_enable-reply-indent-string-editing"--></a>
3966 <li><a href="h_config_enable_search_and_repl">FEATURE: <!--#echo var="FEAT_enable-search-and-replace"--></a>
3967 <li><a href="h_config_sigdashes">FEATURE: <!--#echo var="FEAT_enable-sigdashes"--></a>
3968 <li><a href="h_config_new_thread_blank_subject">FEATURE: <!--#echo var="FEAT_new-thread-on-blank-subject"--></a>
3969 <li><a href="h_config_can_suspend">FEATURE: <!--#echo var="FEAT_enable-suspend"--></a>
3970 <li><a href="h_config_enable_tab_complete">FEATURE: <!--#echo var="FEAT_enable-tab-completion"--></a>
3971 <li><a href="h_config_enable_take_export">FEATURE: <!--#echo var="FEAT_enable-take-export"--></a>
3972 <li><a href="h_config_enable_role_take">FEATURE: <!--#echo var="FEAT_enable-rules-under-take"--></a>
3973 <li><a href="h_config_tray_icon">FEATURE: <!--#echo var="FEAT_enable-tray-icon"--></a>
3974 <li><a href="h_config_enable_pipe">FEATURE: <!--#echo var="FEAT_enable-unix-pipe-cmd"--></a>
3975 <li><a href="h_config_verbose_post">FEATURE: <!--#echo var="FEAT_enable-verbose-smtp-posting"--></a>
3976 <li><a href="h_config_expanded_addrbooks">FEATURE: <!--#echo var="FEAT_expanded-view-of-addressbooks"--></a>
3977 <li><a href="h_config_expanded_distlists">FEATURE: <!--#echo var="FEAT_expanded-view-of-distribution-lists"--></a>
3978 <li><a href="h_config_expanded_folders">FEATURE: <!--#echo var="FEAT_expanded-view-of-folders"--></a>
3979 <li><a href="h_config_expose_hidden_config">FEATURE: <!--#echo var="FEAT_expose-hidden-config"--></a>
3980 <li><a href="h_config_expunge_manually">FEATURE: <!--#echo var="FEAT_expunge-only-manually"--></a>
3981 <li><a href="h_config_auto_expunge">FEATURE: <!--#echo var="FEAT_expunge-without-confirm"--></a>
3982 <li><a href="h_config_full_auto_expunge">FEATURE: <!--#echo var="FEAT_expunge-without-confirm-everywhere"--></a>
3983 <li><a href="h_config_no_fcc_attach">FEATURE: <!--#echo var="FEAT_fcc-without-attachments"--></a>
3984 <li><a href="h_config_force_arrow">FEATURE: <!--#echo var="FEAT_force-arrow-cursor"--></a>
3985 <li><a href="h_config_ignore_size">FEATURE: <!--#echo var="FEAT_ignore-size-changes"--></a>
3986 <li><a href="h_config_forward_as_attachment">FEATURE: <!--#echo var="FEAT_forward-as-attachment"--></a>
3987 <li><a href="h_config_preserve_field">FEATURE: <!--#echo var="FEAT_preserve-original-fields"--></a>
3988 <li><a href="h_config_quell_empty_dirs">FEATURE: <!--#echo var="FEAT_quell-empty-directories"--></a>
3989 <li><a href="h_config_hide_nntp_path">FEATURE: <!--#echo var="FEAT_hide-nntp-path"--></a>
3990 <li><a href="h_config_attach_in_reply">FEATURE: <!--#echo var="FEAT_include-attachments-in-reply"--></a>
3991 <li><a href="h_config_fcc_on_bounce">FEATURE: <!--#echo var="FEAT_fcc-on-bounce"--></a>
3992 <li><a href="h_config_include_header">FEATURE: <!--#echo var="FEAT_include-header-in-reply"--></a>
3993 <li><a href="h_config_auto_include_reply">FEATURE: <!--#echo var="FEAT_include-text-in-reply"--></a>
3994 <li><a href="h_config_incoming_checking_total">FEATURE: <!--#echo var="FEAT_incoming-checking-includes-total"--></a>
3995 <li><a href="h_config_incoming_checking_recent">FEATURE: <!--#echo var="FEAT_incoming-checking-uses-recent"--></a>
3996 <li><a href="h_config_add_ldap">FEATURE: <!--#echo var="FEAT_ldap-result-to-addrbook-add"--></a>
3997 <li><a href="h_config_maildrops_preserve_state">FEATURE: <!--#echo var="FEAT_maildrops-preserve-state"--></a>
3998 <li><a href="h_config_mark_fcc_seen">FEATURE: <!--#echo var="FEAT_mark-fcc-seen"--></a>
3999 <li><a href="h_config_mark_for_cc">FEATURE: <!--#echo var="FEAT_mark-for-cc"--></a>
4000 <li><a href="h_config_mulnews_as_typed">FEATURE: <!--#echo var="FEAT_mult-newsrc-hostnames-as-typed"--></a>
4001 <li><a href="h_config_news_uses_recent">FEATURE: <!--#echo var="FEAT_news-approximates-new-status"--></a>
4002 <li><a href="h_config_news_cross_deletes">FEATURE: <!--#echo var="FEAT_news-deletes-across-groups"--></a>
4003 <li><a href="h_config_news_catchup">FEATURE: <!--#echo var="FEAT_news-offers-catchup-on-close"--></a>
4004 <li><a href="h_config_post_wo_validation">FEATURE: <!--#echo var="FEAT_news-post-without-validation"--></a>
4005 <li><a href="h_config_read_in_newsrc_order">FEATURE: <!--#echo var="FEAT_news-read-in-newsrc-order"--></a>
4006 <li><a href="h_config_nntp_search_uses_overview">FEATURE: <!--#echo var="FEAT_nntp-search-uses-overview"--></a>
4007 <li><a href="h_config_thread_sorts_by_arrival">FEATURE: <!--#echo var="FEAT_thread-sorts-by-arrival"--></a>
4008 <li><a href="h_config_expunge_inbox">FEATURE: <!--#echo var="FEAT_offer-expunge-of-inbox"--></a>
4009 <li><a href="h_config_expunge_stayopens">FEATURE: <!--#echo var="FEAT_offer-expunge-of-stayopen-folders"--></a>
4010 <li><a href="h_config_pass_c1_control">FEATURE: <!--#echo var="FEAT_pass-c1-control-characters-as-is"--></a>
4011 <li><a href="h_config_pass_control">FEATURE: <!--#echo var="FEAT_pass-control-characters-as-is"--></a>
4012 <li><a href="h_config_predict_nntp_server">FEATURE: <!--#echo var="FEAT_predict-nntp-server"--></a>
4013 <li><a href="h_config_prefer_plain_text">FEATURE: <!--#echo var="FEAT_prefer-plain-text"--></a>
4014 <li><a href="h_config_preopen_stayopens">FEATURE: <!--#echo var="FEAT_preopen-stayopen-folders"--></a>
4015 <li><a href="h_config_preserve_start_stop">FEATURE: <!--#echo var="FEAT_preserve-start-stop-characters"--></a>
4016 <li><a href="h_config_quell_folder_internal_msg">FEATURE: <!--#echo var="FEAT_quell-folder-internal-msg"--></a>
4017 <li><a href="h_config_quell_checks_comp">FEATURE: <!--#echo var="FEAT_quell-mailchecks-composing-except-inbox"--></a>
4018 <li><a href="h_config_quell_checks_comp_inbox">FEATURE: <!--#echo var="FEAT_quell-mailchecks-composing-inbox"--></a>
4019 <li><a href="h_config_quell_partial">FEATURE: <!--#echo var="FEAT_quell-partial-fetching"--></a>
4020 <li><a href="h_config_quell_local_lookup">FEATURE: <!--#echo var="FEAT_quell-user-lookup-in-passwd-file"--></a>
4021 <li><a href="h_config_ff_between_msgs">FEATURE: <!--#echo var="FEAT_print-formfeed-between-messages"--></a>
4022 <li><a href="h_config_print_from">FEATURE: <!--#echo var="FEAT_print-includes-from-line"--></a>
4023 <li><a href="h_config_print_index">FEATURE: <!--#echo var="FEAT_print-index-enabled"--></a>
4024 <li><a href="h_config_custom_print">FEATURE: <!--#echo var="FEAT_print-offers-custom-cmd-prompt"--></a>
4025 <li><a href="h_config_prune_uses_iso">FEATURE: <!--#echo var="FEAT_prune-uses-yyyy-mm"--></a>
4026 <li><a href="h_config_quell_personal_name_prompt">FEATURE: <!--#echo var="FEAT_quell-personal-name-prompt"--></a>
4027 <li><a href="h_config_quell_ssl_largeblocks">FEATURE: <!--#echo var="FEAT_quell-ssl-largeblocks"--></a>
4028 <li><a href="h_config_quell_user_id_prompt">FEATURE: <!--#echo var="FEAT_quell-user-id-prompt"--></a>
4029 <li><a href="h_config_quit_wo_confirm">FEATURE: <!--#echo var="FEAT_quit-without-confirm"--></a>
4030 <li><a href="h_config_quote_replace_noflow">FEATURE: <!--#echo var="FEAT_quote-replace-nonflowed"--></a>
4031 <li><a href="h_config_next_thrd_wo_confirm">FEATURE: <!--#echo var="FEAT_next-thread-without-confirm"--></a>
4032 <li><a href="h_config_auto_reply_to">FEATURE: <!--#echo var="FEAT_reply-always-uses-reply-to"--></a>
4033 <li><a href="h_config_inbox_no_confirm">FEATURE: <!--#echo var="FEAT_return-to-inbox-without-confirm"--></a>
4034 <li><a href="h_config_save_aggregates">FEATURE: <!--#echo var="FEAT_save-aggregates-copy-sequence"--></a>
4035 <li><a href="h_config_save_part_wo_confirm">FEATURE: <!--#echo var="FEAT_save-partial-msg-without-confirm"--></a>
4036 <li><a href="h_config_save_advances">FEATURE: <!--#echo var="FEAT_save-will-advance"--></a>
4037 <li><a href="h_config_save_wont_delete">FEATURE: <!--#echo var="FEAT_save-will-not-delete"--></a>
4038 <li><a href="h_config_quote_all_froms">FEATURE: <!--#echo var="FEAT_save-will-quote-leading-froms"--></a>
4039 <li><a href="h_config_scramble_message_id">FEATURE: <!--#echo var="FEAT_scramble-message-id"--></a>
4040 <li><a href="h_config_select_wo_confirm">FEATURE: <!--#echo var="FEAT_select-without-confirm"--></a>
4041 <li><a href="h_config_auto_fcc_only">FEATURE: <!--#echo var="FEAT_fcc-only-without-confirm"--></a>
4042 <li><a href="h_config_send_wo_confirm">FEATURE: <!--#echo var="FEAT_send-without-confirm"--></a>
4043 <li><a href="h_config_separate_fold_dir_view">FEATURE: <!--#echo var="FEAT_separate-folder-and-directory-entries"--></a>
4044 <li><a href="h_config_show_cursor">FEATURE: <!--#echo var="FEAT_show-cursor"--></a>
4045 <li><a href="h_config_textplain_int">FEATURE: <!--#echo var="FEAT_show-plain-text-internally"--></a>
4046 <li><a href="h_config_select_in_bold">FEATURE: <!--#echo var="FEAT_show-selected-in-boldface"--></a>
4047 <li><a href="h_config_show_sort">FEATURE: <!--#echo var="FEAT_show-sort"--></a>
4048 <li><a href="h_config_single_list">FEATURE: <!--#echo var="FEAT_single-column-folder-list"--></a>
4049 <li><a href="h_config_sig_at_bottom">FEATURE: <!--#echo var="FEAT_signature-at-bottom"--></a>
4050 <li><a href="h_config_slash_coll_entire">FEATURE: <!--#echo var="FEAT_slash-collapses-entire-thread"--></a>
4051 <li><a href="h_config_sort_fcc_alpha">FEATURE: <!--#echo var="FEAT_sort-default-fcc-alpha"--></a>
4052 <li><a href="h_config_sort_save_alpha">FEATURE: <!--#echo var="FEAT_sort-default-save-alpha"--></a>
4053 <li><a href="h_config_always_spell_check">FEATURE: <!--#echo var="FEAT_spell-check-before-sending"--></a>
4054 <li><a href="h_config_winpos_in_config">FEATURE: <!--#echo var="FEAT_store-window-position-in-config"--></a>
4055 <li><a href="h_config_strip_sigdashes">FEATURE: <!--#echo var="FEAT_strip-from-sigdashes-on-reply"--></a>
4056 <li><a href="h_config_strip_ws_before_send">FEATURE: <!--#echo var="FEAT_strip-whitespace-before-send"--></a>
4057 <li><a href="h_config_quells_asterisks">FEATURE: <!--#echo var="FEAT_suppress-asterisks-in-password-prompt"--></a>
4058 <li><a href="h_config_quell_attach_ext_warn">FEATURE: <!--#echo var="FEAT_quell-attachment-extension-warn"--></a>
4059 <li><a href="h_config_quell_attach_extra_prompt">FEATURE: <!--#echo var="FEAT_quell-attachment-extra-prompt"--></a>
4060 <li><a href="h_config_no_bezerk_zone">FEATURE: <!--#echo var="FEAT_quell-berkeley-format-timezone"--></a>
4061 <li><a href="h_config_quell_charset_warning">FEATURE: <!--#echo var="FEAT_quell-charset-warning"--></a>
4062 <li><a href="h_config_quell_content_id">FEATURE: <!--#echo var="FEAT_quell-content-id"--></a>
4063 <li><a href="h_config_quell_post_prompt">FEATURE: <!--#echo var="FEAT_quell-extra-post-prompt"--></a>
4064 <li><a href="h_config_quell_filtering_done_message">FEATURE: <!--#echo var="FEAT_quell-filtering-done-message"--></a>
4065 <li><a href="h_config_quell_filtering_messages">FEATURE: <!--#echo var="FEAT_quell-filtering-messages"--></a>
4066 <li><a href="h_config_quell_full_hdr_reset">FEATURE: <!--#echo var="FEAT_quell-full-header-auto-reset"--></a>
4067 <li><a href="h_config_quell_imap_env">FEATURE: <!--#echo var="FEAT_quell-imap-envelope-update"--></a>
4068 <li><a href="h_config_quell_lock_failure_warnings">FEATURE: <!--#echo var="FEAT_quell-lock-failure-warnings"--></a>
4069 <li><a href="h_config_quell_domain_warn">FEATURE: <!--#echo var="FEAT_quell-maildomain-warning"--></a>
4070 <li><a href="h_config_quell_news_env">FEATURE: <!--#echo var="FEAT_quell-news-envelope-update"--></a>
4071 <li><a href="h_config_quell_host_after_url">FEATURE: <!--#echo var="FEAT_quell-server-after-link-in-html"--></a>
4072 <li><a href="h_config_quell_beeps">FEATURE: <!--#echo var="FEAT_quell-status-message-beeping"--></a>
4073 <li><a href="h_config_quell_tz_comment">FEATURE: <!--#echo var="FEAT_quell-timezone-comment-when-sending"--></a>
4074 <li><a href="h_config_suppress_user_agent">FEATURE: <!--#echo var="FEAT_suppress-user-agent-when-sending"--></a>
4075 <li><a href="h_config_tab_checks_recent">FEATURE: <!--#echo var="FEAT_tab-checks-recent"--></a>
4076 <li><a href="h_config_tab_uses_unseen">FEATURE: <!--#echo var="FEAT_tab-uses-unseen-for-next-folder"--></a>
4077 <li><a href="h_config_tab_new_only">FEATURE: <!--#echo var="FEAT_tab-visits-next-new-message-only"--></a>
4078 <li><a href="h_config_termcap_wins">FEATURE: <!--#echo var="FEAT_termdef-takes-precedence"--></a>
4079 <li><a href="h_config_color_thrd_import">FEATURE: <!--#echo var="FEAT_thread-index-shows-important-color"--></a>
4080 <li><a href="h_config_alt_auth">FEATURE: <!--#echo var="FEAT_try-alternative-authentication-driver-first"--></a>
4081 <li><a href="h_config_unsel_wont_advance">FEATURE: <!--#echo var="FEAT_unselect-will-not-advance"--></a>
4082 <li><a href="h_config_use_current_dir">FEATURE: <!--#echo var="FEAT_use-current-dir"--></a>
4083 <li><a href="h_config_use_fk">FEATURE: <!--#echo var="FEAT_use-function-keys"--></a>
4084 <li><a href="h_config_use_reg_start_for_stayopen">FEATURE: <!--#echo var="FEAT_use-regular-startup-rule-for-stayopen-folders"--></a>
4085 <li><a href="h_config_use_resentto">FEATURE: <!--#echo var="FEAT_use-resent-to-in-rules"--></a>
4086 <li><a href="h_config_use_sender_not_x">FEATURE: <!--#echo var="FEAT_use-sender-not-x-sender"--></a>
4087 <li><a href="h_config_suspend_spawns">FEATURE: <!--#echo var="FEAT_use-subshell-for-suspend"--></a>
4088 <li><a href="h_config_use_system_translation">FEATURE: Use System Translation</a>
4089 <li><a href="h_config_vertical_list">FEATURE: <!--#echo var="FEAT_vertical-folder-list"--></a>
4090 <li><a href="h_config_warn_if_fcc_blank">FEATURE: <!--#echo var="FEAT_warn-if-blank-fcc"--></a>
4091 <li><a href="h_config_warn_if_subj_blank">FEATURE: <!--#echo var="FEAT_warn-if-blank-subject"--></a>
4092 <li><a href="h_config_warn_if_no_to_or_cc">FEATURE: <!--#echo var="FEAT_warn-if-blank-to-and-cc-and-newsgroups"--></a>
4093 <li><a href="h_mainhelp_filtering">Filtering</a>
4094 <li><a href="h_finding_help">Finding more information and requesting help</a>
4095 <li><a href="h_common_flag">Flag Command</a>
4096 <li><a href="h_config_quell_flowed_text">Flowed Text</a>
4097 <li><a href="h_mainhelp_folders">Folders</a>
4098 <li><a href="h_what_are_collections">Folder Collections Explained</a>
4099 <li><a href="h_common_folders">Folder List Command</a>
4100 <li><a href="h_folder_fcc">Folder Select for Fcc Explained</a>
4101 <li><a href="h_folder_save">Folder Select for Save Explained</a>
4102 <li><a href="h_folder_server_syntax">Folder Server Name Syntax</a>
4103 <li><a href="h_config_change_your_from">From Address, Changing</a>
4104 <li><a href="main_menu_tx">GENERAL INFORMATION ON THE ALPINE MESSAGE SYSTEM</a>
4105 <li><a href="h_pine_for_windows">GETTING HELP IN ALPINE</a>
4106 <li><a href="h_common_goto">Goto Command</a>
4107 <li><a href="h_common_hdrmode">HdrMode Command</a>
4108 <li><a href="h_mainhelp_pinehelp">Help</a>
4109 <li><a href="h_special_help_nav">Help Text Navigation Explained</a>
4110 <li><a href="h_folder_maint">Help for Folder List</a>
4111 <li><a href="h_valid_folder_names">IMAP</a>
4112 <li><a href="h_ge_import">Import File Selection</a>
4113 <li><a href="h_mainhelp_index">Index of Messages</a>
4114 <li><a href="h_composer_ins_m">INSERT MESSAGE</a>
4115 <li><a href="h_composer_ins">INSERT TEXT FILE</a>
4116 <li><a href="h_address_format">INTERNET EMAIL ADDRESS FORMAT</a>
4117 <li><a href="h_info_on_mbox">Information on mbox driver</a>
4118 <li><a href="h_mainhelp_intro">Introduction</a>
4119 <li><a href="h_main_journal">Journal Command</a>
4120 <li><a href="h_common_jump">Jump Command</a>
4121 <li><a href="h_compose_justify">Justify Command</a>
4122 <li><a href="h_main_kblock">Keyboard Lock Command</a>
4123 <li><a href="h_mainhelp_keywords">Keywords (or Flags, or Labels)</a>
4124 <li><a href="h_mainhelp_ldap">LDAP</a>
4125 <li><a href="h_config_ldap_opts_tls">LDAP FEATURE: Attempt-TLS-On-Connection</a>
4126 <li><a href="h_config_ldap_opts_nosub">LDAP FEATURE: Disable-Ad-Hoc-Space-Substitution</a>
4127 <li><a href="h_config_ldap_opts_rhs">LDAP FEATURE: Lookup-Addrbook-Contents</a>
4128 <li><a href="h_config_ldap_opts_tlsmust">LDAP FEATURE: Require-TLS-On-Connection</a>
4129 <li><a href="h_config_ldap_opts_ldaps">LDAP FEATURE: Require-LDAPS-On-Connection</a>
4130 <li><a href="h_config_ldap_opts_ref">LDAP FEATURE: Save-Search-Criteria-Not-Result</a>
4131 <li><a href="h_config_ldap_opts_impl">LDAP FEATURE: Use-Implicitly-From-Composer</a>
4132 <li><a href="h_config_ldap_binddn">LDAP OPTION: Bind-DN</a>
4133 <li><a href="h_config_ldap_cust">LDAP OPTION: Custom-Search-Filter</a>
4134 <li><a href="h_config_ldap_email_attr">LDAP OPTION: EmailAttribute</a>
4135 <li><a href="h_config_ldap_gn_attr">LDAP OPTION: GivennameAttribute</a>
4136 <li><a href="h_config_ldap_server">LDAP OPTION: <!--#echo var="VAR_ldap-servers"--></a>
4137 <li><a href="h_config_ldap_cn_attr">LDAP OPTION: NameAttribute</a>
4138 <li><a href="h_config_ldap_nick">LDAP OPTION: Nickname</a>
4139 <li><a href="h_config_ldap_port">LDAP OPTION: Port</a>
4140 <li><a href="h_config_ldap_base">LDAP OPTION: Search-Base</a>
4141 <li><a href="h_config_ldap_searchrules">LDAP OPTION: Search-Rule</a>
4142 <li><a href="h_config_ldap_searchtypes">LDAP OPTION: Search-Type</a>
4143 <li><a href="h_config_ldap_size">LDAP OPTION: Sizelimit</a>
4144 <li><a href="h_config_ldap_sn_attr">LDAP OPTION: SurnameAttribute</a>
4145 <li><a href="h_config_ldap_time">LDAP OPTION: Timelimit</a>
4146 <li><a href="h_ldap_view">LDAP Response View Explained</a>
4147 <li><a href="h_maildrop">Mail Drop: What is it?</a>
4148 <li><a href="h_mainhelp_mainmenu">MAIN MENU</a>
4149 <li><a href="h_mail_index">MESSAGE INDEX COMMANDS</a>
4150 <li><a href="h_mail_view">MESSAGE TEXT SCREEN</a>
4151 <li><a href="h_compose_markcutpaste">Mark, Cut and Paste Commands</a>
4152 <li><a href="h_common_index">Message Index Command</a>
4153 <li><a href="h_mainhelp_mouse">Mouse</a>
4154 <li><a href="h_mainhelp_aggops">Multiple Message Operations</a>
4155 <li><a href="new_user_greeting">NEW USER GREETING</a>
4156 <li><a href="new_version_greeting">NEW VERSION GREETING</a>
4157 <li><a href="h_mainhelp_readingnews">News Reading</a>
4158 <li><a href="h_folder_subscribe">Newsgroup Subcribe Screen explained</a>
4159 <li><a href="h_folder_postnews">Newsgroup selecting for Posting explained</a>
4160 <li><a href="h_common_nextnew">NextNew Command</a>
4161 <li><a href="h_abook_select_nick">Nickname Selection Explained</a>
4162 <li><a href="h_mainhelp_readingnews">NNTP</a>
4163 <li><a href="h_config_address_book">OPTION: <!--#echo var="VAR_address-book"--></a>
4164 <li><a href="h_config_abook_formats">OPTION: <!--#echo var="VAR_addressbook-formats"--></a>
4165 <li><a href="h_config_ab_sort_rule">OPTION: <!--#echo var="VAR_addrbook-sort-rule"--></a></a>
4166 <li><a href="h_config_alt_addresses">OPTION: <!--#echo var="VAR_alt-addresses"--></a>
4167 <li><a href="h_config_active_msg_interval">OPTION: <!--#echo var="VAR_busy-cue-rate"--></a>
4168 <li><a href="h_config_color_style">OPTION: Color Style</a>
4169 <li><a href="h_config_wordseps">OPTION: <!--#echo var="VAR_composer-word-separators"--></a>
4170 <li><a href="h_config_composer_wrap_column">OPTION: <!--#echo var="VAR_composer-wrap-column"--></a>
4171 <li><a href="h_config_index_color_style">OPTION: <!--#echo var="VAR_current-indexline-style"--></a>
4172 <li><a href="h_config_cursor_style">OPTION: Cursor Style</a>
4173 <li><a href="h_config_custom_hdrs">OPTION: <!--#echo var="VAR_customized-hdrs"--></a>
4174 <li><a href="h_config_deadlets">OPTION: <!--#echo var="VAR_dead-letter-files"--></a>
4175 <li><a href="h_config_comp_hdrs">OPTION: <!--#echo var="VAR_default-composer-hdrs"--></a>
4176 <li><a href="h_config_default_fcc">OPTION: <!--#echo var="VAR_default-fcc"--></a>
4177 <li><a href="h_config_def_save_folder">OPTION: <!--#echo var="VAR_default-saved-msg-folder"--></a>
4178 <li><a href="h_config_disable_auths">OPTION: <!--#echo var="VAR_disable-these-authenticators"--></a>
4179 <li><a href="h_config_disable_drivers">OPTION: <!--#echo var="VAR_disable-these-drivers"--></a>
4180 <li><a href="h_config_char_set">OPTION: Display Character Set</a>
4181 <li><a href="h_config_display_filters">OPTION: <!--#echo var="VAR_display-filters"--></a>
4182 <li><a href="h_config_download_cmd">OPTION: <!--#echo var="VAR_download-command"--></a>
4183 <li><a href="h_config_download_prefix">OPTION: <!--#echo var="VAR_download-command-prefix"--></a>
4184 <li><a href="h_config_editor">OPTION: <!--#echo var="VAR_editor"--></a>
4185 <li><a href="h_config_empty_hdr_msg">OPTION: <!--#echo var="VAR_empty-header-message"--></a>
4186 <li><a href="h_config_fcc_rule">OPTION: <!--#echo var="VAR_fcc-name-rule"--></a>
4187 <li><a href="h_config_file_dir">OPTION: File Directory</a>
4188 <li><a href="h_config_folder_spec">OPTION: <!--#echo var="VAR_folder-collections"--></a>
4189 <li><a href="h_config_reopen_rule">OPTION: <!--#echo var="VAR_folder-reopen-rule"--></a>
4190 <li><a href="h_config_fld_sort_rule">OPTION: <!--#echo var="VAR_folder-sort-rule"--></a>
4191 <li><a href="h_config_font_char_set">OPTION: Font Character Set</a>
4192 <li><a href="h_config_font_name">OPTION: Font Name</a>
4193 <li><a href="h_config_font_size">OPTION: Font Size</a>
4194 <li><a href="h_config_font_style">OPTION: Font Style</a>
4195 <li><a href="h_config_form_folder">OPTION: <!--#echo var="VAR_form-letter-folder"--></a>
4196 <li><a href="h_config_glob_addrbook">OPTION: <!--#echo var="VAR_global-address-book"--></a>
4197 <li><a href="h_config_goto_default">OPTION: <!--#echo var="VAR_goto-default-rule"--></a>
4198 <li><a href="h_config_header_general_color">OPTION: Header General Color</a>
4199 <li><a href="h_config_image_viewer">OPTION: <!--#echo var="VAR_image-viewer"--></a>
4200 <li><a href="h_config_inbox_path">OPTION: <!--#echo var="VAR_inbox-path"--></a>
4201 <li><a href="h_config_archived_folders">OPTION: <!--#echo var="VAR_incoming-archive-folders"--></a>
4202 <li><a href="h_config_psleep">OPTION: <!--#echo var="VAR_mailcap-check-interval"--></a>
4203 <li><a href="h_config_incoming_interv">OPTION: <!--#echo var="VAR_incoming-check-interval"--></a>
4204 <li><a href="h_config_incoming_second_interv">OPTION: <!--#echo var="VAR_incoming-check-interval-secondary"--></a>
4205 <li><a href="h_config_incoming_list">OPTION: <!--#echo var="VAR_incoming-check-list"--></a>
4206 <li><a href="h_config_incoming_timeo">OPTION: <!--#echo var="VAR_incoming-check-timeout"--></a>
4207 <li><a href="h_config_incoming_folders">OPTION: <!--#echo var="VAR_incoming-folders"--></a>
4208 <li><a href="h_config_inc_startup">OPTION: <!--#echo var="VAR_incoming-startup-rule"--></a>
4209 <li><a href="h_config_incunseen_color">OPTION: Incoming Unseen Color</a>
4210 <li><a href="h_config_index_arrow_color">OPTION: Index Arrow Color</a>
4211 <li><a href="h_config_index_color">OPTION: Index Colors</a>
4212 <li><a href="h_config_index_format">OPTION: <!--#echo var="VAR_index-format"--></a>
4213 <li><a href="h_config_index_from_color">OPTION: Index From Color</a>
4214 <li><a href="h_config_index_opening_color">OPTION: Index Opening Color</a>
4215 <li><a href="h_config_index_pri_color">OPTION: Index Priority Symbol Colors</a>
4216 <li><a href="h_config_index_subject_color">OPTION: Index Subject Color</a>
4217 <li><a href="h_config_init_cmd_list">OPTION: <!--#echo var="VAR_initial-keystroke-list"--></a>
4218 <li><a href="h_config_key_char_set">OPTION: Keyboard Character Set</a>
4219 <li><a href="h_config_keylabel_color">OPTION: KeyLabel Color</a>
4220 <li><a href="h_config_keyname_color">OPTION: KeyName Color</a>
4221 <li><a href="h_config_keywords">OPTION: <!--#echo var="VAR_keywords"--></a>
4222 <li><a href="h_config_kw_color">OPTION: Keyword Colors</a>
4223 <li><a href="h_config_kw_braces">OPTION: <!--#echo var="VAR_keyword-surrounding-chars"--></a>
4224 <li><a href="h_config_prune_date">OPTION: <!--#echo var="VAR_last-time-prune-questioned"--></a>
4225 <li><a href="h_config_last_vers">OPTION: <!--#echo var="VAR_last-version-used"--></a>
4226 <li><a href="h_config_literal_sig">OPTION: <!--#echo var="VAR_literal-signature"--></a>
4227 <li><a href="h_config_mailcheck">OPTION: <!--#echo var="VAR_mail-check-interval"--></a>
4228 <li><a href="h_config_mailchecknoncurr">OPTION: <!--#echo var="VAR_mail-check-interval-noncurrent"--></a>
4229 <li><a href="h_config_mailcap_path">OPTION: <!--#echo var="VAR_mailcap-search-path"--></a>
4230 <li><a href="h_config_maildropcheck">OPTION: <!--#echo var="VAR_maildrop-check-minimum"--></a>
4231 <li><a href="h_config_maxremstream">OPTION: <!--#echo var="VAR_max-remote-connections"--></a>
4232 <li><a href="h_config_metamsg_color">OPTION: Meta-Message Color</a>
4233 <li><a href="h_config_mimetype_path">OPTION: <!--#echo var="VAR_mimetype-search-path"--></a>
4234 <li><a href="h_config_new_ver_quell">OPTION: <!--#echo var="VAR_new-version-threshold"--></a>
4235 <li><a href="h_config_fifopath">OPTION: NewMail FIFO Path</a>
4236 <li><a href="h_config_newmailwidth">OPTION: <!--#echo var="VAR_newmail-window-width"--></a>
4237 <li><a href="h_config_news_active">OPTION: <!--#echo var="VAR_news-active-file-path"--></a>
4238 <li><a href="h_config_news_spec">OPTION: <!--#echo var="VAR_news-collections"--></a>
4239 <li><a href="h_config_news_spool">OPTION: <!--#echo var="VAR_news-spool-directory"--></a>
4240 <li><a href="h_config_newsrc_path">OPTION: <!--#echo var="VAR_newsrc-path"--></a>
4241 <li><a href="h_config_nntprange">OPTION: <!--#echo var="VAR_nntp-range"--></a>
4242 <li><a href="h_config_nntp_server">OPTION: <!--#echo var="VAR_nntp-server"--></HEAD></a>
4243 <li><a href="h_config_normal_color">OPTION: Normal Color</a>
4244 <li><a href="h_config_opening_sep">OPTION: <!--#echo var="VAR_opening-text-separator-chars"--></a>
4245 <li><a href="h_config_oper_dir">OPTION: <!--#echo var="VAR_operating-dir"--></a>
4246 <li><a href="h_config_pat_old">OPTION: Patterns</a>
4247 <li><a href="h_config_pat_filts">OPTION: <!--#echo var="VAR_patterns-filters2"--></a>
4248 <li><a href="h_config_pat_other">OPTION: <!--#echo var="VAR_patterns-other"--></a>
4249 <li><a href="h_config_pat_roles">OPTION: <!--#echo var="VAR_patterns-roles"--></a>
4250 <li><a href="h_config_pat_scores">OPTION: <!--#echo var="VAR_patterns-scores2"--></a>
4251 <li><a href="h_config_pers_name">OPTION: <!--#echo var="VAR_personal-name"--></a>
4252 <li><a href="h_config_print_cat">OPTION: <!--#echo var="VAR_personal-print-category"--></a>
4253 <li><a href="h_config_print_command">OPTION: <!--#echo var="VAR_personal-print-command"--></a>
4254 <li><a href="h_config_post_char_set">OPTION: <!--#echo var="VAR_posting-character-set"--></a>
4255 <li><a href="h_config_postponed_folder">OPTION: <!--#echo var="VAR_postponed-folder"--></a>
4256 <li><a href="h_config_print_font_char_set">OPTION: Print-Font-Char-Set</a>
4257 <li><a href="h_config_print_font_name">OPTION: Print-Font-Name</a>
4258 <li><a href="h_config_print_font_size">OPTION: Print-Font-Size</a>
4259 <li><a href="h_config_print_font_style">OPTION: Print-Font-Style</a>
4260 <li><a href="h_config_printer">OPTION: Printer</a>
4261 <li><a href="h_config_prompt_color">OPTION: Prompt Color</a>
4262 <li><a href="h_config_pruned_folders">OPTION: <!--#echo var="VAR_pruned-folders"--></a>
4263 <li><a href="h_config_pruning_rule">OPTION: <!--#echo var="VAR_pruning-rule"--></a>
4264 <li><a href="h_config_quote_color">OPTION: Quote Colors</a>
4265 <li><a href="h_config_quote_replace_string">OPTION: <!--#echo var="VAR_quote-replace-string"--></a>
4266 <li><a href="h_config_quote_suppression">OPTION: <!--#echo var="VAR_quote-suppression-threshold"--></a>
4267 <li><a href="h_config_read_message_folder">OPTION: <!--#echo var="VAR_read-message-folder"--></a>
4268 <li><a href="h_config_remote_abook_history">OPTION: <!--#echo var="VAR_remote-abook-history"--></a>
4269 <li><a href="h_config_abook_metafile">OPTION: <!--#echo var="VAR_remote-abook-metafile"--></a>
4270 <li><a href="h_config_remote_abook_validity">OPTION: <!--#echo var="VAR_remote-abook-validity"--></a>
4271 <li><a href="h_config_reply_indent_string">OPTION: <!--#echo var="VAR_reply-indent-string"--></a>
4272 <li><a href="h_config_reply_intro">OPTION: <!--#echo var="VAR_reply-leadin"--></a>
4273 <li><a href="h_config_reverse_color">OPTION: Reverse Color</a>
4274 <li><a href="h_config_rshcmd">OPTION: <!--#echo var="VAR_rsh-command"--></a>
4275 <li><a href="h_config_rsh_open_timeo">OPTION: <!--#echo var="VAR_rsh-open-timeout"--></a>
4276 <li><a href="h_config_rshpath">OPTION: <!--#echo var="VAR_rsh-path"--></a>
4277 <li><a href="h_config_saved_msg_name_rule">OPTION: <!--#echo var="VAR_saved-msg-name-rule"--></a>
4278 <li><a href="h_config_scroll_margin">OPTION: <!--#echo var="VAR_scroll-margin"--></a>
4279 <li><a href="h_config_slctbl_color">OPTION: Selectable Item Color</a>
4280 <li><a href="h_config_sending_filter">OPTION: <!--#echo var="VAR_sending-filters"--></a>
4281 <li><a href="h_config_sendmail_path">OPTION: <!--#echo var="VAR_sendmail-path"--></a>
4282 <li><a href="h_config_signature_color">OPTION: Signature Color</a>
4283 <li><a href="h_config_signature_file">OPTION: <!--#echo var="VAR_signature-file"--></a>
4284 <li><a href="h_config_smtp_server">OPTION: <!--#echo var="VAR_smtp-server"--></a>
4285 <li><a href="h_config_sort_key">OPTION: <!--#echo var="VAR_sort-key"--></a>
4286 <li><a href="h_config_speller">OPTION: <!--#echo var="VAR_speller"--></a>
4287 <li><a href="h_config_aspell_dictionary">OPTION: <!--#echo var="VAR_aspell-dictionary-list"--></a>
4288 <li><a href="h_config_sshcmd">OPTION: <!--#echo var="VAR_ssh-command"--></a>
4289 <li><a href="h_config_ssh_open_timeo">OPTION: <!--#echo var="VAR_ssh-open-timeout"--></a>
4290 <li><a href="h_config_sshpath">OPTION: <!--#echo var="VAR_ssh-path"--></a>
4291 <li><a href="h_config_status_color">OPTION: Status Color</a>
4292 <li><a href="h_config_status_msg_delay">OPTION: <!--#echo var="VAR_status-message-delay"--></a>
4293 <li><a href="h_config_permlocked">OPTION: <!--#echo var="VAR_stay-open-folders"--></a>
4294 <li><a href="h_config_tcp_open_timeo">OPTION: <!--#echo var="VAR_tcp-open-timeout"--></a>
4295 <li><a href="h_config_tcp_query_timeo">OPTION: <!--#echo var="VAR_tcp-query-timeout"--></a>
4296 <li><a href="h_config_tcp_readwarn_timeo">OPTION: <!--#echo var="VAR_tcp-read-warning-timeout"--></a>
4297 <li><a href="h_config_tcp_writewarn_timeo">OPTION: <!--#echo var="VAR_tcp-write-warning-timeout"--></a>
4298 <li><a href="h_config_thread_disp_style">OPTION: <!--#echo var="VAR_threading-display-style"--></a>
4299 <li><a href="h_config_thread_exp_char">OPTION: <!--#echo var="VAR_threading-expanded-character"--></a>
4300 <li><a href="h_config_thread_index_style">OPTION: <!--#echo var="VAR_threading-index-style"--></a>
4301 <li><a href="h_config_thread_indicator_char">OPTION: <!--#echo var="VAR_threading-indicator-character"--></a>
4302 <li><a href="h_config_thread_lastreply_char">OPTION: <!--#echo var="VAR_threading-lastreply-character"--></a>
4303 <li><a href="h_config_title_color">OPTION: Title Color</a>
4304 <li><a href="h_config_titleclosed_color">OPTION: Title Closed Color</a>
4305 <li><a href="h_config_titlebar_color_style">OPTION: <!--#echo var="VAR_titlebar-color-style"--></a>
4306 <li><a href="h_config_unk_char_set">OPTION: <!--#echo var="VAR_unknown-character-set"--></a>
4307 <li><a href="h_config_upload_cmd">OPTION: <!--#echo var="VAR_upload-command"--></a>
4308 <li><a href="h_config_upload_prefix">OPTION: <!--#echo var="VAR_upload-command-prefix"--></a>
4309 <li><a href="h_config_browser">OPTION: <!--#echo var="VAR_url-viewers"--></a>
4310 <li><a href="h_config_history">OPTION: <!--#echo var="VAR_default-directories"--></a>
4311 <li><a href="h_config_domain_name">OPTION: <!--#echo var="VAR_use-only-domain-name"--></a>
4312 <li><a href="h_config_user_dom">OPTION: <!--#echo var="VAR_user-domain"--></a>
4313 <li><a href="h_config_user_id">OPTION: <!--#echo var="VAR_user-id"--></a>
4314 <li><a href="h_config_user_input_timeo">OPTION: <!--#echo var="VAR_user-input-timeout"--></a>
4315 <li><a href="h_config_viewer_headers">OPTION: <!--#echo var="VAR_viewer-hdrs"--></a>
4316 <li><a href="h_config_customhdr_pattern">OPTION: Viewer Header Color Pattern</a>
4317 <li><a href="h_config_customhdr_color">OPTION: <!--#echo var="VAR_viewer-hdr-colors"--></a>
4318 <li><a href="h_config_viewer_margin_left">OPTION: <!--#echo var="VAR_viewer-margin-left"--></a>
4319 <li><a href="h_config_viewer_margin_right">OPTION: <!--#echo var="VAR_viewer-margin-right"--></a>
4320 <li><a href="h_config_viewer_overlap">OPTION: <!--#echo var="VAR_viewer-overlap"--></a>
4321 <li><a href="h_config_window_position">OPTION: Window-Position</a>
4322 <li><a href="h_mainhelp_patterns">Patterns</a>
4323 <li><a href="h_config_role_abookfrom">PATTERNS: Address in Address Book</a>
4324 <li><a href="h_config_role_age">PATTERNS: Age Interval</a>
4325 <li><a href="h_config_role_alltextpat">PATTERNS: AllText Pattern</a>
4326 <li><a href="h_config_role_bom">PATTERNS: Beginning of Month</a>
4327 <li><a href="h_config_role_boy">PATTERNS: Beginning of Year</a>
4328 <li><a href="h_config_role_bodytextpat">PATTERNS: BodyText Pattern</a>
4329 <li><a href="h_config_role_cat_cmd">PATTERNS: Categorizer Command</a>
4330 <li><a href="h_config_role_cat_cmd_example">PATTERNS: Categorizer Command Example</a>
4331 <li><a href="h_config_role_ccpat">PATTERNS: Cc Pattern</a>
4332 <li><a href="h_config_role_cat_limit">PATTERNS: Character Limit</a>
4333 <li><a href="h_config_role_charsetpat">PATTERNS: Character Set Pattern</a>
4334 <li><a href="h_config_role_comment">PATTERNS: Comment</a>
4335 <li><a href="h_config_role_fldr_type">PATTERNS: Current Folder Type</a>
4336 <li><a href="h_config_role_cat_status">PATTERNS: Exit Status Interval</a>
4337 <li><a href="h_config_role_arbpat">PATTERNS: Extra Headers Pattern</a>
4338 <li><a href="h_config_role_frompat">PATTERNS: From Pattern</a>
4339 <li><a href="h_config_role_keywordpat">PATTERNS: Keyword Pattern</a>
4340 <li><a href="h_config_role_stat_ans">PATTERNS: Message Answered Status</a>
4341 <li><a href="h_config_role_stat_del">PATTERNS: Message Deleted Status</a>
4342 <li><a href="h_config_role_stat_imp">PATTERNS: Message Important Status</a>
4343 <li><a href="h_config_role_stat_new">PATTERNS: Message New Status</a>
4344 <li><a href="h_config_role_stat_recent">PATTERNS: Message Recent Status</a>
4345 <li><a href="h_config_role_newspat">PATTERNS: News Pattern</a>
4346 <li><a href="h_config_role_nick">PATTERNS: Nickname</a>
4347 <li><a href="h_config_role_particpat">PATTERNS: Participant Pattern</a>
4348 <li><a href="h_config_role_stat_8bitsubj">PATTERNS: Raw 8-bit in Subject</a>
4349 <li><a href="h_config_role_recippat">PATTERNS: Recipient Pattern</a>
4350 <li><a href="h_config_role_scorei">PATTERNS: Score Interval</a>
4351 <li><a href="h_config_role_senderpat">PATTERNS: Sender Pattern</a>
4352 <li><a href="h_config_role_size">PATTERNS: Size Interval</a>
4353 <li><a href="h_config_role_subjpat">PATTERNS: Subject Pattern</a>
4354 <li><a href="h_config_role_topat">PATTERNS: To Pattern</a>
4355 <li><a href="h_config_filt_opts_nonterm">PATTERNS FEATURE: Dont-Stop-Even-if-Rule-Matches</a>
4356 <li><a href="h_config_filt_opts_notdel">PATTERNS FEATURE: Move-Only-if-Not-Deleted</a>
4357 <li><a href="h_config_filt_opts_sentdate">PATTERNS FEATURE: Use-Date-Header-For-Age</a>
4358 <li><a href="h_config_filt_rule_type">PATTERNS FILTER ACTION: Filter Action</a>
4359 <li><a href="h_config_filter_kw_clr">PATTERNS FILTER ACTION: Clear These Keywords</a>
4360 <li><a href="h_config_filt_stat_ans">PATTERNS FILTER ACTION: Set Answered Status</a>
4361 <li><a href="h_config_filt_stat_del">PATTERNS FILTER ACTION: Set Deleted Status</a>
4362 <li><a href="h_config_filt_stat_imp">PATTERNS FILTER ACTION: Set Important Status</a>
4363 <li><a href="h_config_filt_stat_new">PATTERNS FILTER ACTION: Set New Status</a>
4364 <li><a href="h_config_filter_kw_set">PATTERNS FILTER ACTION: Set These Keywords</a>
4365 <li><a href="h_config_incol">PATTERNS INDEXCOLOR ACTION: Index Line Color</a>
4366 <li><a href="h_config_set_index_format">PATTERNS OTHER ACTION: Set Index Format</a>
4367 <li><a href="h_config_perfolder_sort">PATTERNS OTHER ACTION: Set Sort Order</a>
4368 <li><a href="h_config_other_startup">PATTERNS OTHER ACTION: Set Startup Rule</a>
4369 <li><a href="h_config_role_inick">PATTERNS ROLE ACTION: Initialize Values From Role</a>
4370 <li><a href="h_config_role_setfcc">PATTERNS ROLE ACTION: Set Fcc</a>
4371 <li><a href="h_config_role_setfrom">PATTERNS ROLE ACTION: Set From</a>
4372 <li><a href="h_config_role_setlitsig">PATTERNS ROLE ACTION: Set Literal Signature</a>
4373 <li><a href="h_config_role_setotherhdr">PATTERNS ROLE ACTION: Set Other Headers</a>
4374 <li><a href="h_config_role_setreplyto">PATTERNS ROLE ACTION: Set Reply-To</a>
4375 <li><a href="h_config_role_setsig">PATTERNS ROLE ACTION: Set Signature</a>
4376 <li><a href="h_config_role_settempl">PATTERNS ROLE ACTION: Set Template</a>
4377 <li><a href="h_config_role_usenntp">PATTERNS ROLE ACTION: Use NNTP Server</a>
4378 <li><a href="h_config_role_usesmtp">PATTERNS ROLE ACTION: Use SMTP Server</a>
4379 <li><a href="h_config_role_scoreval">PATTERNS SCORE ACTION: Score Value</a>
4380 <li><a href="h_config_role_scorehdrtok">PATTERNS SCORE ACTION: Score Value From Header</a>
4381 <li><a href="h_config_role_composeuse">PATTERNS USE: Compose Use</a>
4382 <li><a href="h_config_role_forwarduse">PATTERNS USE: Forward Use</a>
4383 <li><a href="h_config_role_replyuse">PATTERNS USE: Reply Use</a>
4384 <li><a href="h_pipe_command">Pipe Command SubOptions</a>
4385 <li><a href="h_common_pipe">Pipe Command</a>
4386 <li><a href="h_valid_folder_names">POP</a>
4387 <li><a href="h_common_postpone">Postpone Command</a>
4388 <li><a href="h_common_print">Print Command</a>
4389 <li><a href="h_mainhelp_readingnews">Reading News</a>
4390 <li><a href="h_news">RELEASE NOTES for Alpine</a>
4391 <li><a href="h_mainhelp_roles">Roles</a>
4392 <li><a href="h_role_select">ROLES SCREEN</a>
4393 <li><a href="h_compose_readfile">Read File Command</a>
4394 <li><a href="h_mainhelp_reading">Reading Messages</a>
4395 <li><a href="h_main_release_notes">Release Notes Command</a>
4396 <li><a href="h_common_reply">Reply and Forward Commands</a>
4397 <li><a href="h_compose_richhdr">Rich Header Command</a>
4398 <li><a href="h_common_role">Role Command</a>
4399 <li><a href="h_mainhelp_smime">S/MIME</a>
4400 <li><a href="h_index_cmd_select">Searching for Messages</a>
4401 <li><a href="h_address_display">SEARCH RESULTS INDEX</a>
4402 <li><a href="h_address_select">SEARCH RESULTS INDEX</a>
4403 <li><a href="h_simple_index">SELECT POSTPONED MESSAGE</a>
4404 <li><a href="h_abook_config">SETUP ADDRESS BOOKS SCREEN</a>
4405 <li><a href="h_collection_maint">SETUP COLLECTION LIST screen</a>
4406 <li><a href="h_color_setup">SETUP COLOR COMMANDS</a>
4407 <li><a href="h_direct_config">SETUP LDAP DIRECTORY SERVERS SCREEN</a>
4408 <li><a href="h_rules_roles">SETUP ROLES SCREEN</a>
4409 <li><a href="h_rules_incols">SETUP INDEX COLORS SCREEN</a>
4410 <li><a href="h_rules_filter">SETUP FILTERING SCREEN</a>
4411 <li><a href="h_rules_score">SETUP SCORING SCREEN</a>
4412 <li><a href="h_common_save">Save and Export Commands</a>
4413 <li><a href="h_mainhelp_securing">Securing Your Alpine Session</a>
4414 <li><a href="h_index_cmd_select">Selecting: Select and WhereIs/Select</a>
4415 <li><a href="h_compose_send">Send Command</a>
4416 <li><a href="h_folder_server_syntax">Server Name Syntax</a>
4417 <li><a href="h_main_setup">Setup Command</a>
4418 <li><a href="X-Alpine-Config:">Show Supported Options in this Alpine</a>
4419 <li><a href="h_composer_sigedit">Signature Editor Commands Explained</a>
4420 <li><a href="h_simple_text_view">Simple Text View Screen Explained</a>
4421 <li><a href="h_mainhelp_smime">S/MIME</a>
4422 <li><a href="h_config_smime_dont_do_smime">S/MIME FEATURE: <!--#echo var="FEAT_smime-dont-do-smime"--></a>
4423 <li><a href="h_config_smime_encrypt_by_default">S/MIME FEATURE: <!--#echo var="FEAT_smime-encrypt-by-default"--></a>
4424 <li><a href="h_config_smime_remember_passphrase">S/MIME FEATURE: <!--#echo var="FEAT_smime-remember-passphrase"--></a>
4425 <li><a href="h_config_smime_sign_by_default">S/MIME FEATURE: <!--#echo var="FEAT_smime-sign-by-default"--></a>
4426 <li><a href="h_config_smime_use_cert_store">S/MIME FEATURE: <!--#echo var="FEAT_smime-use-store-only"--></a>
4427 <li><a href="h_config_smime_pubcerts_in_keychain">S/MIME FEATURE: <!--#echo var="FEAT_publiccerts-in-keychain"--></a>
4428 <li><a href="h_config_smime_cacertcon">S/MIME OPTION: <!--#echo var="VAR_smime-cacert-container"--></a>
4429 <li><a href="h_config_smime_cacertdir">S/MIME OPTION: <!--#echo var="VAR_smime-cacert-directory"--></a>
4430 <li><a href="h_config_smime_privkeycon">S/MIME OPTION: <!--#echo var="VAR_smime-private-key-container"--></a>
4431 <li><a href="h_config_smime_privkeydir">S/MIME OPTION: <!--#echo var="VAR_smime-private-key-directory"--></a>
4432 <li><a href="h_config_smime_pubcertcon">S/MIME OPTION: <!--#echo var="VAR_smime-public-cert-container"--></a>
4433 <li><a href="h_config_smime_pubcertdir">S/MIME OPTION: <!--#echo var="VAR_smime-public-cert-directory"--></a>
4434 <li><a href="h_config_smime_transfer_cacert_to_con">S/MIME: Transfer CA Certs to Container</a>
4435 <li><a href="h_config_smime_transfer_cacert_to_dir">S/MIME: Transfer CA Certs to Directory</a>
4436 <li><a href="h_config_smime_transfer_priv_to_con">S/MIME: Transfer Private Keys to Container</a>
4437 <li><a href="h_config_smime_transfer_priv_to_dir">S/MIME: Transfer Private Keys to Directory</a>
4438 <li><a href="h_config_smime_transfer_pub_to_con">S/MIME: Transfer Public Certs to Container</a>
4439 <li><a href="h_config_smime_transfer_pub_to_dir">S/MIME: Transfer Public Certs to Directory</a>
4440 <li><a href="h_config_smime_public_certificates">S/MIME: Manage Public Certificates</a>
4441 <li><a href="h_config_smime_private_keys">S/MIME: Manage Private Keys</a>
4442 <li><a href="h_config_smime_certificate_authorities">S/MIME: Manage Certificate Authorities</a>
4443 <li><a href="h_index_cmd_sort">Sort Command</a>
4444 <li><a href="h_compose_spell">Spell Check Command</a>
4445 <li><a href="h_common_suspend">Suspend Command</a>
4446 <li><a href="h_compose_addrcomplete">THE MESSAGE COMPOSER'S ADDRESS COMPLETION</a>
4447 <li><a href="h_composer_attachment">THE MESSAGE COMPOSER'S ATTCHMNT FIELD</a>
4448 <li><a href="h_composer_bcc">THE MESSAGE COMPOSER'S BCC FIELD</a>
4449 <li><a href="h_composer_cc">THE MESSAGE COMPOSER'S CC FIELD</a>
4450 <li><a href="h_composer_from">THE MESSAGE COMPOSER'S FROM FIELD</a>
4451 <li><a href="h_composer_lcc">THE MESSAGE COMPOSER'S LCC FIELD</a>
4452 <li><a href="h_composer_news">THE MESSAGE COMPOSER'S NEWSGRPS LINE</a>
4453 <li><a href="h_composer_reply_to">THE MESSAGE COMPOSER'S REPLY-TO FIELD</a>
4454 <li><a href="h_composer_to">THE MESSAGE COMPOSER'S TO FIELD</a>
4455 <li><a href="h_abook_opened">THE ALPINE ADDRESS BOOK</a>
4456 <li><a href="h_abook_select_nicks_take">Take Address Nickname Selection Explained</a>
4457 <li><a href="h_takeaddr_screen">Take Address Screen Explained</a>
4458 <li><a href="h_common_take">TakeAddr Command</a>
4459 <li><a href="h_mainhelp_status">Titlebar Line</a>
4460 <li><a href="h_index_tokens">Tokens for Index and Replying</a>
4461 <li><a href="h_config_usenone_color">Use None Color</a>
4462 <li><a href="h_config_usenormal_color">Use Normal Color</a>
4463 <li><a href="h_config_usetransparent_color">Use Transparent Color</a>
4464 <li><a href="h_whatis_vcard">VCARD EXPLAINED</a>
4465 <li><a href="h_view_cmd_hilite">View Hilite and Next item/Previous item</a>
4466 <li><a href="h_view_cmd_viewattch">ViewAttch Command</a>
4467 <li><a href="h_index_cmd_whereis">WhereIs Command</a>
4468 <li><a href="h_view_cmd_whereis">WhereIs Command</a>
4469 <li><a href="h_index_cmd_zoom">ZoomMode Command</a>
4470 <li><a href="h_config_browser_xterm"><!--#echo var="VAR_url-viewers"--> and X windows applications</a>
4471 </UL>
4472
4473 <P>
4474 &lt;End of Help Index&gt;
4475 </BODY>
4476 </HTML>
4477
4478
4479 ============== h_config_remote_config =============
4480 <HTML>
4481 <HEAD>
4482 <TITLE>Remote Configuration</TITLE>
4483 </HEAD>
4484 <BODY>
4485 <H1>Remote Configuration</H1>
4486
4487 You may use the command line argument &quot;-p pinerc&quot; to tell
4488 Alpine to use a non-default configuration file.
4489 There are two types of storage for configuration information.
4490 <EM>Local</EM> configuration files are used by default.
4491 These are just regular files on the UNIX system or on the PC.
4492 The file &quot;<CODE>.pinerc</CODE>&quot; is the default for Unix Alpine and the
4493 file &quot;<CODE>PINERC</CODE>&quot; is the default for PC-Alpine.
4494 <EM>Remote</EM> configuration folders are stored on an IMAP server.
4495 The advantage of using a remote configuration is that the same information
4496 may be accessed from multiple platforms.
4497 For example, if you use one computer at work and another at home, the same
4498 configuration could be used from both places.
4499 A configuration change from one place would be seen in both places.
4500 To use a remote configuration you simply give a
4501 <A HREF="h_valid_folder_names">remote folder name</A>
4502 as the argument to the &quot;-p&quot; command line option.
4503 The command line might look something like:
4504 <P>
4505 <CENTER><SAMP>pine -p {my.imap.server}remote_pinerc</SAMP></CENTER>
4506 <P>
4507 If there are special characters in the command shell you use, you may need to
4508 quote the last argument (to protect the curly braces from the shell).
4509 The command might look like:
4510 <P>
4511 <CENTER><SAMP>pine -p &quot;{my.imap.server}remote_pinerc&quot;</SAMP></CENTER>
4512 <P>
4513 You should choose a folder name for a folder that does not yet exist.
4514 It will be created containing an empty configuration.
4515 Do not use a folder that you wish to store regular mail messages in.
4516 <P>
4517 The Setup/RemoteConfigSetup command will help you convert from a local
4518 configuration to a remote configuration.
4519 It will create a remote configuration for you and copy your current local
4520 configuration to it.
4521 It will also help you convert local address books into remote address books
4522 and local signature files into literal signatures contained in the
4523 remote configuration file.
4524 <P>
4525 If the Setup/RemoteConfigSetup command doesn't do what you want, you
4526 may copy a local pinerc file to a remote configuration folder by hand
4527 by using the command line option &quot;-copy_pinerc&quot;.
4528 <P>
4529 Another command line option, which is somewhat related to remote
4530 configuration, is the option &quot;-x exceptions_config&quot;.
4531 The configuration settings in the exceptions configuration override
4532 your default settings.
4533 It may be useful to store the default configuration (the -p argument) remotely
4534 and to have the exceptions configuration stored in a local file.
4535 You might put generic configuration information in the remote configuration
4536 and platform-specific configuration on each platform in the exceptions
4537 configuration.
4538 The arguments to the &quot;-p&quot; and &quot;-x&quot; options
4539 can be either remote folders or local files.
4540 <P>
4541 There is another command line argument that works only with PC-Alpine and
4542 which may prove useful when using a remote configuration.
4543 The option &quot;-aux local_directory&quot; allows you to tell PC-Alpine where
4544 to store your local auxiliary files.
4545 This only has an effect if your configuration file is remote.
4546 Some examples of auxiliary files are debug files, address book files, and
4547 signature files.
4548 <P>
4549 &lt;End of help on this topic&gt;
4550 </BODY>
4551 </HTML>
4552 ============== h_config_exceptions =============
4553 <HTML>
4554 <HEAD>
4555 <TITLE>Generic and Exceptional Configuration</TITLE>
4556 </HEAD>
4557 <BODY>
4558 <H1>Generic and Exceptional Configuration</H1>
4559
4560 If you use Alpine from more than one platform it may be convenient
4561 to split your configuration information into two pieces, a generic piece
4562 and exceptions that apply to a particular platform.
4563 For example, suppose you use Alpine from home and from work.
4564 Most of your configuration settings are probably the
4565 same in both locations, so those settings belong in the generic settings
4566 configuration.
4567 However, you may use a different SMTP server and INBOX
4568 from home than you do from work.
4569 The
4570 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>
4571 and
4572 <A HREF="h_config_inbox_path">&quot;<!--#echo var="VAR_inbox-path"-->&quot;</A>
4573 options could be
4574 part of your exceptional configuration so that they could be different in the
4575 two places.
4576 <P>
4577 The command line option &quot;-x exceptions_config&quot;
4578 may be used to split your configuration into generic and exceptional pieces.
4579 &quot;Exceptions_config&quot; may be either local or remote.
4580 The regular Alpine configuration file will contain the generic data, and
4581 &quot;exceptions_config&quot; will contain the exceptional data.
4582 <P>
4583 For Unix Alpine, if you don't have a &quot;-x&quot; command line option,
4584 Alpine will look for the file &quot;<CODE>.pinercex</CODE>&quot;
4585 in the same local directory that the regular config file is located in (usually
4586 the Unix home directory).
4587 If the regular config file is remote (because the command line option
4588 &quot;-p remote_config&quot; was used) then Unix Alpine looks in the Unix home
4589 directory for &quot;<CODE>.pinercex</CODE>&quot;.
4590 If the file does not already exist then no exceptions will be used.
4591 You can force exceptions to be used by using the &quot;-x&quot; option or
4592 by creating an empty &quot;<CODE>.pinercex</CODE>&quot; file.
4593 <P>
4594 For PC-Alpine, if you don't have a &quot;-x&quot; command line option,
4595 PC-Alpine will use the value of the
4596 environment variable <CODE>$PINERCEX</CODE>.
4597 If that is not set, PC-Alpine will look for
4598 the local file &quot;<CODE>PINERCEX</CODE>&quot;
4599 in the same local directory that the regular config file is located in.
4600 If the regular config file is remote (because the command line option
4601 &quot;-p remote_config&quot; was used) then PC-Alpine looks in the
4602 local directory specified by the &quot;-aux local_directory&quot; command
4603 line argument, or the directory <CODE>$HOME&#92;PINE</CODE>, or
4604 in the <CODE>&lt;PINE.EXE </CODE>directory<CODE>&gt;</CODE>.
4605 <P>
4606 When you have an exception configuration there is a new command
4607 in the Alpine Setup screen, Setup/eXceptions.
4608 It toggles between exceptions and the regular configuration.
4609 This is the usual way to make changes in your exceptional configuration data.
4610 For example, you would type &quot;S&quot; for Setup, &quot;X&quot; for
4611 eXception, then follow that with one of the Setup commands, like &quot;C&quot;
4612 for Config or &quot;K&quot; for Kolor.
4613 <P>
4614 For most people, splitting the configuration information into two pieces is
4615 going to be most useful if the generic information is accessed
4616 <A HREF="h_config_remote_config">remotely</A>).
4617 That data will be the same no matter where you access it from and if you
4618 change it that change will show up everywhere.
4619 The exceptional data will most commonly be in a local file, so that the
4620 contents may easily be different on each computing platform used.
4621 <P>
4622 If you already have a local configuration file with settings you like
4623 you may find that the command Setup/RemoteConfigSetup is useful
4624 in helping you convert to a remote configuration.
4625 The command line flag &quot;-copy_pinerc&quot;
4626 may also be useful.
4627 <P>
4628 &lt;End of help on this topic&gt;
4629 </BODY>
4630 </HTML>
4631 ============== h_config_inheritance =============
4632 <HTML>
4633 <HEAD>
4634 <TITLE>Configuration Inheritance</TITLE>
4635 </HEAD>
4636 <BODY>
4637 <H1>Configuration Inheritance</H1>
4638
4639 Configuration inheritance is a power user feature.
4640 It is confusing and not completely supported by the configuration
4641 user interface.
4642 We start with an explanation of how configuration works in hopes of making
4643 it easier to describe how inheritance works.
4644 <P>
4645 Alpine uses a hierarchy of configuration values from different locations.
4646 There are five ways in which each configuration option (configuration
4647 variable) can be set.
4648 In increasing order of precedence they are:
4649 <P>
4650 <OL>
4651 <LI> the system-wide configuration file.
4652
4653 <LI> the personal configuration file
4654
4655 <LI> the personal exceptions file
4656
4657 <LI> a command line argument
4658
4659 <LI> the system-wide <EM>fixed</EM> configuration file (Unix Alpine only)
4660 </OL>
4661 <P>
4662 The fixed configuration file is normally
4663 <CODE><!--#echo var="PINE_CONF_FIXED_PATH"--></CODE>.
4664 <P>
4665 The system-wide configuration file is normally
4666 <CODE><!--#echo var="PINE_CONF_PATH"--></CODE> for Unix Alpine and is normally not
4667 set for PC-Alpine.
4668 For PC-Alpine, if the environment variable <EM>$PINECONF</EM> is set, that
4669 is used for the system-wide configuration.
4670 This location can be set or changed on the command line with the -P flag.
4671 The system-wide configuration file can be either a local file or a
4672 remote configuration folder.
4673 <P>
4674 For Unix Alpine, the personal configuration file is normally the file
4675 <CODE>.pinerc</CODE> in the user's home directory.
4676 This can be changed with the -p command line flag.
4677 For PC-Alpine, the personal configuration file is in
4678 <CODE>$PINERC</CODE> or <CODE>&lt;AlpineRC registry value&gt;</CODE> or
4679 <CODE>$HOME&#92;PINE&#92;PINERC</CODE> or
4680 <CODE>&lt;PINE.EXE </CODE>dir<CODE>&gt;&#92;PINERC</CODE>.
4681 This can be changed with the -p command line flag.
4682 If -p is used, the configuration data may be in a local file or a remote config
4683 folder.
4684 <P>
4685 For Unix Alpine, the personal exceptions configuration file is named
4686 <CODE>.pinercex</CODE> and is in the same directory as the personal
4687 configuration file, if that configuration file is not remote, and is in
4688 the home directory if the personal configuration file is remote.
4689 If the file exists, then exceptions are turned on.
4690 If it doesn't, then you are not using exceptions.
4691 Alternatively, you may change the location of the exceptions configuration
4692 by using the command line argument &quot;-x &lt;exceptions_config&gt;&quot;.
4693 Like the personal configuration data, exceptions_config may be
4694 either local or remote.
4695 <P>
4696 For PC-Alpine, the personal exceptions configuration file is named
4697 <CODE>PINERCEX</CODE> and is in the same directory as the personal
4698 configuration file unless the personal configuration file is remote.
4699 In that case, it is in the local directory specfied by the
4700 &quot;-aux local_directory&quot; command line argument.
4701 (In the case that the personal configuration is remote and there is no
4702 &quot;-aux&quot; command line argument, Alpine searches for
4703 a PINERCEX file in the directory <CODE>$HOME&#92;PINE</CODE> and
4704 the directory <CODE>&lt;PINE.EXE </CODE>dir<CODE>&gt;</CODE>.)
4705 If the file exists, then exceptions are turned on.
4706 If it doesn't, then you are not using exceptions.
4707 You may change the location of the exceptions configuration
4708 by using the command line argument &quot;-x &lt;exceptions_config&gt;&quot;.
4709 or with the
4710 environment variable <CODE>$PINERCEX</CODE> (if there is no &quot;-x&quot;
4711 option).
4712 <P>
4713 To reiterate, the value of a configuration option is taken from the
4714 last location in the list above in which it is set.
4715 Or, thinking about it slightly differently, a default value for an option
4716 is established in the system-wide configuration file (or internally by Alpine
4717 if there is no value in the system-wide file).
4718 That default remains in effect until and unless it is overridden by a value in a
4719 location further down the list, in which case a new &quot;default&quot;
4720 value is established.
4721 As we continue down the list of locations we either retain the
4722 value at each step or establish a new value.
4723 The value that is still set after going through the whole list of
4724 configuration locations is the one that is used.
4725 <P>
4726 So, for example, if an option is set in the system-wide configuration
4727 file and in the personal configuration file, but is not set in the
4728 exceptions, on the command line, or in the fixed file; then the value
4729 from the personal configuration file is the one that is used.
4730 Or, if it is set in the system-wide config, in the personal config, not
4731 in the exceptions, but is set on the command line; then the value
4732 on the command line is used.
4733 <P>
4734 Finally we get to inheritance.
4735 For configuration options that are lists, like &quot;<!--#echo var="VAR_smtp-server"-->&quot; or
4736 &quot;<!--#echo var="VAR_incoming-folders"-->&quot;,
4737 the inheritance mechanism makes it possible to <EM>combine</EM>
4738 the values from different locations instead of <EM>replacing</EM> the value.
4739 This is true of all configuration lists other than the &quot;Feature-List&quot;,
4740 for which you may already set whatever you want at
4741 any configuration location (by using the &quot;no-&quot; prefix if
4742 necessary).
4743 <P>
4744 To use inheritance, set the first item in a configuration list to the
4745 token &quot;INHERIT&quot;, without the quotes.
4746 If the first item is &quot;INHERIT&quot;,
4747 then instead of replacing the default value established so far, the rest of
4748 the list is appended to the default value established so far and that is
4749 the new value.
4750 <P>
4751 Here is an example which may make it clearer. Suppose we have:
4752 <P>
4753 <PRE>
4754  System-wide config :   smtp-server = smtp1.corp.com, smtp2.corp.com
4755  Personal config    :   smtp-server = INHERIT, mysmtp.home
4756  Exceptions config  :   smtp-server = &lt;No Value Set&gt;
4757  Command line       :   smtp-server = &lt;No Value Set&gt;
4758  Fixed config       :   smtp-server = &lt;No Value Set&gt;
4759 </PRE>
4760 <P>
4761
4762 This would result in an effective smtp-server option of
4763 <P>
4764 <PRE>
4765  smtp-server = smtp1.corp.com, smtp2.corp.com, mysmtp.home
4766 </PRE>
4767 <P>
4768 The &quot;INHERIT&quot; token can be used in any of the configuration files
4769 and the effect cascades.
4770 For example, if we change the above example to:
4771 <P>
4772 <PRE>
4773  System-wide config :   smtp-server = smtp1.corp.com, smtp2.corp.com
4774  Personal config    :   smtp-server = INHERIT, mysmtp.home
4775  Exceptions config  :   smtp-server = INHERIT, yoursmtp.org
4776  Command line       :   smtp-server = &lt;No Value Set&gt;
4777  Fixed config       :   smtp-server = &lt;No Value Set&gt;
4778 </PRE>
4779 <P>
4780
4781 This would result in:
4782 <P>
4783 <PRE>
4784  smtp-server = smtp1.corp.com, smtp2.corp.com, mysmtp.home, yoursmtp.org
4785 </PRE>
4786 <P>
4787 Unset variables are skipped over (the default value is carried forward) so
4788 that, for example:
4789 <P>
4790 <PRE>
4791  System-wide config :   smtp-server = smtp1.corp.com, smtp2.corp.com
4792  Personal config    :   smtp-server = &lt;No Value Set&gt;
4793  Exceptions config  :   smtp-server = INHERIT, yoursmtp.org
4794  Command line       :   smtp-server = &lt;No Value Set&gt;
4795  Fixed config       :   smtp-server = &lt;No Value Set&gt;
4796 </PRE>
4797 <P>
4798
4799 produces:
4800 <P>
4801 <PRE>
4802  smtp-server = smtp1.corp.com, smtp2.corp.com, yoursmtp.org
4803 </PRE>
4804 <P>
4805
4806 If any later configuration location has a value set (for a particular list
4807 option) which does <EM>not</EM> begin with &quot;INHERIT&quot;,
4808 then that value replaces whatever value has been defined up to that point.
4809 In other words, that cancels out any previous inheritance.
4810 <P>
4811 <PRE>
4812  System-wide config :   smtp-server = smtp1.corp.com, smtp2.corp.com
4813  Personal config    :   smtp-server = INHERIT, mysmtp.org
4814  Exceptions config  :   smtp-server = yoursmtp.org
4815  Command line       :   smtp-server = &lt;No Value Set&gt;
4816  Fixed config       :   smtp-server = &lt;No Value Set&gt;
4817 </PRE>
4818 <P>
4819
4820 results in:
4821 <P>
4822 <PRE>
4823  smtp-server = yoursmtp.org
4824 </PRE>
4825 <P>
4826
4827 For some configuration options, like &quot;<!--#echo var="VAR_viewer-hdr-colors"-->&quot; or
4828 &quot;<!--#echo var="VAR_patterns-roles"-->&quot;, it is
4829 difficult to insert the value &quot;INHERIT&quot; into the list of values
4830 for the option using the normal Setup tools.
4831 In other words, the color setting screen (for example) does not
4832 provide a way to input the text &quot;INHERIT&quot; as the first
4833 item in the <!--#echo var="VAR_viewer-hdr-colors"--> option.
4834 The way to do this is to either edit the pinerc file directly and manually
4835 insert it, or turn
4836 on the <A HREF="h_config_expose_hidden_config"><!--#echo var="FEAT_expose-hidden-config"--></A>
4837 feature and insert it using the Setup/Config screen.
4838 <P>
4839 &lt;End of help on this topic&gt;
4840 </BODY>
4841 </HTML>
4842 ============== h_special_xon_xoff =============
4843 <HTML>
4844 <HEAD>
4845 <TITLE>Explanation of Alpine's XOFF/XON Handling</TITLE>
4846 </HEAD>
4847 <BODY>
4848 <H1>XOFF/XON Handling within Alpine</H1>
4849
4850 By default, Alpine treats Ctrl-S or Ctrl-Q (sometimes known as XOFF
4851 and XON) as normal characters, even though Alpine does not use them.
4852 However, the printer, modem, or communication software you are using may
4853 be configured for &quot;software flow control,&quot; which means that
4854 XON/XOFF must be treated as special characters by the operating system.
4855 If you see messages such as &quot;^S not defined for this screen&quot;,
4856 then your system is probably using software flow control. In this case
4857 you will need to set the
4858 <A HREF="h_config_preserve_start_stop">&quot;<!--#echo var="FEAT_preserve-start-stop-characters"-->&quot;</A>
4859 feature.
4860 <P>
4861 If you <EM>do</EM> set this
4862 feature, be advised that if you accidentally hit a Ctrl-S, Alpine will
4863 mysteriously freeze up with no warning.  In this case, try typing a Ctrl-Q
4864 and see if that puts things right.  Printing via the
4865 &quot;attached-to-ansi&quot; or
4866 &quot;attached-to-wyse&quot;
4867 option will automatically enable software
4868 flow-control handling for the duration of the printing.
4869 <P>
4870 &lt;End of help on this topic&gt;
4871 </BODY>
4872 </HTML>
4873 ============= h_special_help_nav =============
4874 <HTML>
4875 <HEAD>
4876 <TITLE>Help Text Navigation Explained</TITLE>
4877 </HEAD>
4878 <BODY>
4879 <H1>Help Text Navigation Explained</H1>
4880
4881 Alpine contains extensive context-sensitive help text.   At any point,
4882 pressing the &quot;?&quot; key will bring up a page of help text
4883 explaining the options available to you.  You can leave the help
4884 text screen and return to normal Alpine operation by pressing
4885 the
4886 <!--chtml if pinemode="function_key"-->
4887 F3 function
4888 <!--chtml else-->
4889 &quot;E&quot;
4890 <!--chtml endif-->
4891 key to Exit Help at any time.
4892
4893 <P>
4894 Within the help screen you might find a word or phrase displayed in
4895 inverse text and others displayed in bold typeface.  Such words and
4896 phrases are used to tell you Alpine has more information available on
4897 the topic they describe.
4898 The inverted text is the &quot;selected&quot; topic.
4899 Use the arrow keys, Ctrl-F, and Ctrl-B to change which of the phrases
4900 displayed in bold type
4901 is &quot;selected&quot;.
4902 Hit the Return key to display the information Alpine has available on that
4903 topic.  While viewing such additional information, the
4904 <!--chtml if pinemode="function_key"-->
4905 F3 function
4906 <!--chtml else-->
4907 &quot;P&quot;
4908 <!--chtml endif-->
4909 key will return you to the previous help screen, and the
4910 <!--chtml if pinemode="function_key"-->
4911 F2 function
4912 <!--chtml else-->
4913 &quot;E&quot;
4914 <!--chtml endif-->
4915 key will Exit the Help system altogether.
4916
4917 <P>
4918 The "N" command will tell you the internal name of the help text you are
4919 reading each time, so that you can send this name in the text of a message
4920 and create a direct link to that internal help using the x-pine-help URL
4921 scheme. For example, the direct link to this item is
4922 x-pine-help:h_special_help_nav. If you add this text to a message, then
4923 a person using Pine to read such message would have a direct link to this
4924 help text.
4925
4926 <P>
4927 When you are finished reading this help text, you can press the
4928 <!--chtml if pinemode="function_key"-->
4929 F3 function
4930 <!--chtml else-->
4931 &quot;P&quot;
4932 <!--chtml endif-->
4933 key to return to the previously displayed help text.
4934
4935 <P>
4936 &lt;End of help on this topic&gt;
4937 </BODY>
4938 </HTML>
4939 ============= h_special_list_commands =============
4940 <HTML>
4941 <HEAD>
4942 <TITLE>Email List Commands Explained</TITLE>
4943 </HEAD>
4944 <BODY>
4945 <H1>Email List Commands Explained</H1>
4946
4947 Electonic mail lists provide a way for like-minded users to join in
4948 discussions on topics of interest.  The email list itself is
4949 represented by a
4950 single address that participants send messages to when they have
4951 something of interest to share with other members of the list.  The
4952 receiving computer then, either automatically or after review by the
4953 list's owner (or moderator), sends a copy of that message to each
4954 member of the list.
4955
4956 <P>
4957 Usually, subscribing and unsubscribing is done by sending requests in
4958 an email message to a special address setup to handle managing list
4959 membership.  Often this is the name of the list followed by
4960 <I>-request</I>.  This address is almost <EM>never</EM> the same as
4961 the address used to send messages to the list.
4962
4963 <P>
4964 Unfortunately, email list participation commands are more a matter
4965 of convention than standard, and thus may vary from list to list.
4966 Increasingly, list management software is adding information to
4967 the copy of the postings as they're copied to the list members that
4968 explains how to do the various list management functions.
4969
4970 <P>
4971 Alpine will recognize this information and offer the management commands
4972 they represent in a simple display. One or more of the following
4973 operations will be made available:
4974
4975 <DL>
4976 <DT>Help</DT>
4977 <DD>
4978 A method to get help on subscribing, unsubscribing,
4979 an explanation of what the list is about, or special instructions
4980 for participation.  This may be in the form of a reply in response
4981 to an email message, or instructions on how to connect to a Web site.
4982 </DD>
4983
4984 <DT>Unsubscribe</DT>
4985 <DD>
4986 A method to get your email addressed removed from the list of
4987 recipients of the email list.
4988 </DD>
4989
4990 <DT>Subscribe</DT>
4991 <DD>
4992 A method to get your email address added to the list of recipients
4993 of the email list.  It may be in the form of a message sent to
4994 a special address or you may be connected to a web site.
4995 <DD>
4996 </DD>
4997
4998 <DT>Post</DT>
4999 <DD>
5000 A method used to post to the email list.  However, it might also
5001 indicate that no posting is allowed directly to the list.
5002 </DD>
5003
5004 <DT>Owner</DT>
5005 <DD>
5006 A method to contact the list owner for special questions you might
5007 have regarding the list.
5008 </DD>
5009
5010 <DT>Archive</DT>
5011 <DD>
5012 A method to view an archive of previous messages posted to the list.
5013 This may be in the form of a mail folder on a remote computer, an
5014 IMAP mailbox or even a Web site.
5015 </DD>
5016 </DL>
5017
5018 <P>
5019 &lt;End of help on this topic&gt;
5020 </BODY>
5021 </HTML>
5022 ============= h_quota_command =============
5023 <HTML>
5024 <HEAD>
5025 <TITLE>Quota Screen Explained</TITLE>
5026 </HEAD>
5027 <BODY>
5028 <H1>Quota Screen Explained</H1>
5029
5030 <P> This screen summarizes the quota report for this mailbox in the
5031 IMAP server. For each resource that you have a quota, this reports summarizes
5032 its use and limit.
5033
5034 <P> Your IMAP server administrator may have set a quota based either on
5035 the total size of your mailbox (STORAGE), or the number of messages in
5036 your mailbox (MESSAGES), or some other criteria. This will be reported
5037 to you indicating the type of quota, its total use and its limit.
5038
5039 <P> The report for STORAGE is reported in kibibytes (KiB). One kibibyte is
5040 1024 bytes. Each of the characters that you see in this help text is one
5041 byte, and this help text is about 1 kibibyte in size. Small messages sent
5042 by Alpine are normally less than 4 kibibytes in size (which includes
5043 headers and text). Other email programs may send messages with bigger
5044 sizes when they send messages, since they send plain text and an
5045 alternative part in HTML.
5046
5047 <P> A convenient way to save space for the STORAGE type of quota is by
5048 deleting attachments. This is done on each individual message by pressing
5049 the &quot;V&quot; command while reading the message text, then moving the cursor
5050 to the position of the attachment that is to be deleted, then pressing
5051 &quot;D&quot; to delete such attachment, going back to reading the
5052 message with the &quot;&lt;&quot; command and pressing &quot;S&quot; to
5053 save the message in the same folder you are reading from. The saved
5054 message will not have the attachment that was marked deleted. Now you
5055 can delete and expunge the message with the unwanted attachment.
5056
5057 <P>
5058 &lt;End of help on this topic&gt;
5059 </BODY>
5060 </HTML>
5061 ============= h_mail_thread_index =============
5062 <HTML>
5063 <HEAD>
5064 <TITLE>THREAD INDEX COMMANDS</TITLE>
5065 </HEAD>
5066 <BODY>
5067 <H1>THREAD INDEX COMMANDS</H1>
5068 <!--chtml if pinemode="function_key"-->
5069 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>
5070 -------------------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;-----------------------------<BR>
5071 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>
5072 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>
5073 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>
5074 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>
5075 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>
5076 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>
5077 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>
5078 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>
5079 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>
5080 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>
5081 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>
5082 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>
5083 <BR>
5084 Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;3<BR>
5085 -----------------------------<BR>
5086 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>
5087 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>
5088 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>
5089 <BR>
5090 Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;4<BR>
5091 -----------------------------<BR>
5092 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
5093 F6&nbsp;&nbsp;<A HREF="h_common_role">Compose&nbsp;using&nbsp;a&nbsp;role</A><BR>
5094 <BR>
5095 <!--chtml else-->
5096 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>
5097 -------------------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;---------------------------------<BR>
5098 &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>
5099 &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>
5100 &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>
5101 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>
5102 &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>
5103 &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>
5104 &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>
5105 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>
5106 &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>
5107 <BR>
5108 Miscellaneous&nbsp;Operations&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;General&nbsp;Alpine&nbsp;Commands<BR>
5109 ------------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;---------------------<BR>
5110 &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>
5111 &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>
5112 &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>
5113 &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>
5114 &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>
5115 &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>
5116 &nbsp;:&nbsp;&nbsp;&nbsp;Select&nbsp;Messages&nbsp;in&nbsp;Current&nbsp;Thread<BR>
5117 <!--chtml endif-->
5118 <P>
5119
5120 NOTE:
5121 <OL>
5122  <LI>For help on a particular command, highlight the bold text associated
5123 with it above and hit Return.
5124  <LI>Availability of certain commands depends on <A HREF="h_common_conditional_cmds">feature settings</A>.
5125 </OL>
5126
5127 <H2>Description of the THREAD INDEX Screen</H2>
5128
5129 The THREAD INDEX displays summary information from each
5130 thread (conversation) in the current folder.
5131 This is useful if you want to quickly
5132 scan new threads, or find a particular thread without having to go
5133 through the text of each message, or to quickly get rid of junk
5134 threads, etc.
5135 The current thread is always highlighted.
5136 Each line of the THREAD INDEX contains the following columns: <P>
5137 <DL>
5138  <DT>STATUS:</DT>
5139  <DD> The markings on the left side of the thread tell you about its
5140 status.  You may see one or more of the following codes on any given
5141 thread:
5142 <UL>
5143   <LI> &quot;D&quot; for Deleted. All of the messages in this thread are marked for deletion but not yet eXpunged from the folder.
5144   <LI> &quot;A&quot; for Answered. All of the messages in this thread are marked answered.
5145   <LI> &quot;N&quot; for New. At least one message in the thread is New (you haven't looked at it yet).
5146   <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.
5147   <LI> &quot;-&quot; for cc-to-you. The &quot;-&quot; indicates that a
5148         message in the thread was sent to you as a cc:. This symbol will only show up if
5149         the feature
5150         &quot;<A HREF="h_config_mark_for_cc"><!--#echo var="FEAT_mark-for-cc"--></A>&quot; is turned on (which is the default).
5151   <LI> &quot;X&quot; for selected.  You have selected at least one message in the thread by using the
5152         &quot;select&quot; command.  (Some systems may optionally allow selected
5153         messages to be denoted by the index line being displayed in bold
5154         type instead.)
5155   <LI> &quot;*&quot; for Important.  You have previously used the &quot;Flag&quot; command
5156       to mark at least one message in this thread as &quot;important&quot;.
5157 </UL></DD><P>
5158
5159  <DT>THREAD NUMBER:</DT>
5160  <DD>Threads in a folder are numbered, from one through the number
5161 of threads in the folder, to help you know where you are in the folder.
5162 </DD><P>
5163
5164  <DT>DATE STARTED:</DT>
5165  <DD>The date the thread was started. This is actually from the Date header
5166 of the first message in the thread. It doesn't take different time zones
5167 into account.</DD><P>
5168
5169  <DT>WHO STARTED THE THREAD:</DT>
5170  <DD>This is usually the name of the sender of the first message in the thread, taken from
5171 the From header of the message.
5172 If there is no personal name given in that
5173 address, then the email address is used instead.
5174 If the message is from you (or from one of your
5175 <A HREF="h_config_alt_addresses">alternate addresses</A>),
5176 then the recipient's name is shown here instead, with the characters
5177 &quot;To: &quot; inserted before the name.
5178 (The idea of this is that if you started the thread you would rather see who
5179 the mail was sent to instead of that the mail was from you.)
5180 In Newsgroups, if you are
5181 the sender and there are no email recipients, the newsgroup name will be
5182 listed after the &quot;To: &quot;.
5183 </DD><P>
5184
5185  <DT>SIZE:</DT>
5186  <DD>The number in parentheses is the number of messages in the thread.</DD><P>
5187
5188  <DT>SUBJECT:</DT>
5189  <DD>As much of the thread's subject line as will fit on the screen.
5190 This is the subject of the first message in the thread.</DD>
5191 </DL>
5192
5193 <P><UL>
5194 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
5195 </UL>
5196 <P>
5197 &lt;End of help on this topic&gt;
5198 </BODY>
5199 </HTML>
5200 ============= h_mail_index =============
5201 <HTML>
5202 <HEAD>
5203 <TITLE>MESSAGE INDEX COMMANDS</TITLE>
5204 </HEAD>
5205 <BODY>
5206 <H1>MESSAGE INDEX COMMANDS</H1>
5207 <!--chtml if pinemode="function_key"-->
5208 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>
5209 -------------------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;-----------------------------<BR>
5210 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>
5211 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>
5212 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>
5213 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>
5214 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>
5215 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>
5216 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>
5217 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>
5218 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>
5219 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>
5220 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>
5221 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>
5222 <BR>
5223 Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;3<BR>
5224 -----------------------------<BR>
5225 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>
5226 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>
5227 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>
5228 <BR>
5229 Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;4<BR>
5230 -----------------------------<BR>
5231 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
5232 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>
5233 <BR>
5234 <!--chtml else-->
5235 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>
5236 -------------------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;---------------------------------<BR>
5237 &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>
5238 &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>
5239 &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>
5240 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>
5241 &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>
5242 &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>
5243 &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>
5244 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>
5245 &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>
5246 Miscellaneous&nbsp;Operations<BR>
5247 ------------------------<BR>
5248 &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>
5249 &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>
5250 &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>
5251 &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>
5252 &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>
5253 &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>
5254 &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>
5255 &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>
5256 <!--chtml endif-->
5257 <P>
5258
5259 NOTE:
5260 <OL>
5261  <LI>For help on a particular command, highlight the bold text associated
5262 with it above and hit Return.
5263  <LI>Availability of certain commands depends on <A HREF="h_common_conditional_cmds">feature settings</A>.
5264 </OL>
5265
5266 <H2>Description of the MESSAGE INDEX Screen</H2>
5267
5268 The MESSAGE INDEX displays summary information from each
5269 message in the current folder.
5270 This is useful if you want to quickly
5271 scan new messages, or find a particular message without having to go
5272 through the text of each message, or to quickly get rid of junk
5273 messages, etc.
5274 <P>
5275 The current message is always highlighted
5276 and many commands operate on the current message.
5277 For example, the Delete command will delete the current message.
5278 If the folder is sorted by either Threads or OrderedSubject, then, depending
5279 on some of your configuration settings, a single line in the index may
5280 refer to an entire thread or to a subthread.
5281 If that is the case, then the commands that normally operate on the current
5282 message will operate on the thread or subthread instead.
5283 For example, the Delete command will delete the whole collapsed thread
5284 instead of just a single message.
5285 <P>
5286 Each line of the MESSAGE INDEX contains the following columns (by default --
5287 you can change this with the
5288 &quot;<A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A>&quot; option
5289 in the SETUP CONFIGURATION screen): <P>
5290 <DL>
5291  <DT>STATUS:</DT>
5292  <DD> The markings on the left side of the message tell you about its
5293 status.  You may see one or more of the following codes on any given
5294 message:
5295 <UL>
5296   <LI> &quot;D&quot; for Deleted.  You have marked this message for deletion but not
5297          yet eXpunged the folder.
5298   <LI> &quot;N&quot; for New.  You have not looked at the text of the message yet.
5299   <LI> &quot;A&quot; for Answered.  Any time you reply to a message it is considered
5300          to be answered.
5301   <LI> &quot;F&quot; for Forwarded.  Similar to Answered, this is set whenever you
5302          forward a message.
5303   <LI> &quot;+&quot; for direct-to-you.  The &quot;+&quot; indicates that a message was sent
5304         directly to your account, your copy is not part of a cc: or a
5305         mailing list.
5306   <LI> &quot;-&quot; for cc-to-you. The &quot;-&quot; indicates that a
5307         message was sent to you as a cc:. This symbol will only show up if
5308         the feature
5309         &quot;<A HREF="h_config_mark_for_cc"><!--#echo var="FEAT_mark-for-cc"--></A>&quot; is turned on (which is the default).
5310   <LI> &quot;X&quot; for selected.  You have selected the message by using the
5311         &quot;select&quot; command.  (Some systems may optionally allow selected
5312         messages to be denoted by the index line being displayed in bold
5313         type.)
5314   <LI> &quot;*&quot; for Important.  You have previously used the &quot;Flag&quot; command
5315       to mark this message as &quot;important&quot;.
5316 </UL></DD><P>
5317
5318  <DT>MESSAGE NUMBER:</DT>
5319  <DD>Messages in a folder are numbered, from one through the number
5320 of messages in the folder, to help you know where you are in the folder.
5321 These numbers are always in increasing order, even if you sort the folder
5322 in a different way.</DD><P>
5323
5324  <DT>DATE SENT:</DT>
5325  <DD>The date the message was sent.  By default, messages are
5326 ordered by arrival time, not by date sent.  Most of the time, arrival time
5327 and date sent (effectively departure time) are similar.  Sometimes,
5328 however, the index will appear to be out of order because a message took a
5329 long time in delivery or because the sender is in a different time
5330 zone than you are. This date is just the date from the Date header
5331 field in the message.</DD><P>
5332
5333  <DT>WHO SENT THE MESSAGE:</DT>
5334  <DD>This is usually the name of the sender of the message, taken from
5335 the From header of the message.
5336 If there is no personal name given in that
5337 address, then the email address is used instead.
5338 If the message is from you (or from one of your
5339 <A HREF="h_config_alt_addresses">alternate addresses</A>),
5340 then the recipient's name is shown here instead, with the characters
5341 &quot;To: &quot; inserted before the name.
5342 (The idea of this is that if you sent the mail you would rather see who
5343 the mail was sent to instead of that the mail was from you.
5344 This behavior may be changed by modifying the <!--#echo var="VAR_index-format"--> option mentioned
5345 above.
5346 In particular, use the FROM token or the FROMORTONOTNEWS token
5347 in place of the FROMORTO token.)
5348 In Newsgroups, if you are
5349 the sender and there are no email recipients, the newsgroup name will be
5350 listed after the &quot;To: &quot;. </DD><P>
5351
5352  <DT>SIZE:</DT>
5353  <DD>The number in parentheses is the number of characters in the message.
5354 It may have a suffix of K, M, or G which means the number should be
5355 multiplied by one thousand, one million, or one billion to get the
5356 size of the message.</DD><P>
5357
5358  <DT>SUBJECT:</DT>
5359  <DD>As much of the message's subject line as will fit on the screen.</DD>
5360 </DL>
5361
5362 <P><UL>
5363 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
5364 </UL>
5365 <P>
5366 &lt;End of help on this topic&gt;
5367 </BODY>
5368 </HTML>
5369 ============= h_mail_view ========================
5370 <HTML>
5371 <HEAD>
5372 <TITLE>MESSAGE TEXT SCREEN</TITLE>
5373 </HEAD>
5374 <BODY>
5375 <H1>MESSAGE TEXT SCREEN</H1>
5376 <!--chtml if pinemode="function_key"-->
5377 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>
5378 -------------------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;------------------------------<BR>
5379 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>
5380 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>
5381 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>
5382 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>
5383 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>
5384 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>
5385 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>
5386 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>
5387 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>
5388 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>
5389 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>
5390 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>
5391 <BR>
5392 Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;3<BR>
5393 ------------------------------<BR>
5394 F1&nbsp;&nbsp;Show&nbsp;Help&nbsp;Text<BR>
5395 F2&nbsp;&nbsp;Toggle&nbsp;to&nbsp;see&nbsp;more&nbsp;commands<BR>
5396 F3&nbsp;&nbsp;<A HREF="h_view_cmd_hilite">View&nbsp;hilited</A><BR>
5397 F4&nbsp;&nbsp;Select&nbsp;current&nbsp;message<BR>
5398 F5&nbsp;&nbsp;Previous&nbsp;selectable&nbsp;item<BR>
5399 F6&nbsp;&nbsp;Next&nbsp;selectable&nbsp;item<BR>
5400 F7&nbsp;&nbsp;<A HREF="h_common_jump">Jump</A>&nbsp;to&nbsp;message&nbsp;number<BR>
5401 F8&nbsp;&nbsp;<A HREF="h_common_nextnew">Next&nbsp;new</A>&nbsp;message<BR>
5402 F9&nbsp;&nbsp;<A HREF="h_common_hdrmode">Display&nbsp;full&nbsp;headers</A><BR>
5403 F10&nbsp;<A HREF="h_common_bounce">Bounce</A>&nbsp;message<BR>
5404 F11&nbsp;<A HREF="h_common_flag">Flag</A>&nbsp;message<BR>
5405 F12&nbsp;<A HREF="h_common_pipe">Pipe</A>&nbsp;to&nbsp;a&nbsp;Unix&nbsp;command<BR>
5406 Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;4<BR>
5407 F5&nbsp;&nbsp;<A HREF="h_common_role">Compose using a role</A><BR>
5408 <!--chtml else-->
5409 Operations&nbsp;on&nbsp;the&nbsp;Current&nbsp;Message<BR>
5410 ---------------------------------<BR>
5411 <BR>
5412 &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>
5413 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>
5414 &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>
5415 &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>
5416 &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>
5417 &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>
5418 &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>
5419 &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>
5420 &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>
5421 <BR>
5422 Navigating&nbsp;the&nbsp;List&nbsp;of&nbsp;Messages&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Other&nbsp;Commands<BR>
5423 -------------------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;----------------------------<BR>
5424 &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>
5425 &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>
5426 &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>
5427 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>
5428 <BR>
5429 General&nbsp;Alpine&nbsp;Commands<BR>
5430 ---------------------<BR>
5431 &nbsp;O&nbsp;&nbsp;Show&nbsp;all&nbsp;other&nbsp;available&nbsp;commands<BR>
5432 &nbsp;?&nbsp;&nbsp;Show&nbsp;Help&nbsp;text&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Q&nbsp;Quit&nbsp;Alpine<BR>
5433 &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>
5434 &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>
5435 &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>
5436 <!--chtml endif-->
5437 <P>
5438
5439 NOTE:
5440 <OL>
5441  <LI>For help on a particular command, highlight the bold text associated
5442 with it above and hit Return.
5443  <LI>Availability of certain commands depends on <A HREF="h_common_conditional_cmds">feature settings</A>.
5444 </OL>
5445
5446 <H2>Description of the MESSAGE TEXT Screen</H2>
5447
5448 The top line of the view message screen displays status
5449 information about the currently open collection and folder and about the
5450 current message.  It shows the name of the collection in angle brackets
5451 and then the name of the folder.  The line also displays the number
5452 of messages in the folder, the number of the current message and the
5453 percentage of the current message that has been displayed on the screen.
5454 If the message is marked for deletion &quot;DEL&quot; will appear in the upper
5455 right corner.
5456 If the message has been answered (but not deleted) &quot;ANS&quot; will show
5457 in the corner.
5458 <P>
5459
5460 NOTE: to rapidly move to the end of a message, hit the
5461 <!--chtml if pinemode="function_key"-->F8<!--chtml else-->W<!--chtml endif-->
5462 (or Ctrl-W) key followed
5463 by Ctrl-V.  Similarly,
5464 <!--chtml if pinemode="function_key"-->F8<!--chtml else-->W<!--chtml endif-->
5465 followed by Ctrl-Y will take you to the beginning of
5466 a message.
5467
5468 <H2>Explanation of Alternate Character Sets</H2>
5469
5470 Alpine attempts to stay out of the way so that it won't prevent you from
5471 viewing mail in any character set.  It will simply send the message to
5472 your display device.  If the device is capable of displaying the
5473 message as it was written it will do so.  If not, the display may be
5474 partially or totally incorrect.
5475 If the message contains characters that are not representable in your
5476 <A HREF="h_config_char_set">&quot;Display Character Set&quot;</A>
5477 variable in your configuration, then a warning message will be printed
5478 to your screen at the beginning of the message display.
5479 It is probably best to use UNIX Alpine in a terminal emulator
5480 capable of displaying UTF-8 characters.
5481 See <A HREF="h_config_char_set">Display Character Set</A> for a little
5482 more information about character set settings.
5483
5484 <P><UL>
5485 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
5486 </UL>
5487 <P>
5488 &lt;End of help on this topic&gt;
5489 </BODY>
5490 </HTML>
5491 ======= h_index_cmd_select =======
5492 <HTML>
5493 <HEAD>
5494 <TITLE>Selecting: Select and WhereIs/Select</TITLE>
5495 </HEAD>
5496 <BODY>
5497 <H1>Selecting: Select and WhereIs/Select</H1>
5498
5499 Aggregate operations give you the ability to process a group of messages
5500 at once.  Acting on multiple messages requires two steps: (1) selecting a
5501 set of messages and then; (2) applying a command to that set. The first
5502 part is handled by the select command.  Select allows you to
5503 select messages based on their status (read, answered, etc.), contents,
5504 date, size, or keywords.
5505 You may also select based on one of your Rules or based on threads,
5506 and there are quick options to select a specific message or range of messages,
5507 to select the current message, or to select all messages.
5508 <P>
5509
5510 We describe the various selection criteria briefly:
5511 <P>
5512
5513 <DL>
5514 <DT>select All</DT>
5515 <DD> Marks all the messages in the folder as selected.
5516 </DD>
5517
5518 <DT>select Cur</DT>
5519 <DD> Selects the currently highlighted message or currently highlighted
5520 set of messages if in a threaded view.
5521 </DD>
5522
5523 <DT>select by Number</DT>
5524 <DD> Select by message number. This may be a comma-separated list instead or
5525 a single entry.
5526 Each element in the list may be either a single message number or a range
5527 of numbers with a dash between the lowest and highest member of the range.
5528 Some examples are 7 to select only message number 7; 2-5 to select messages
5529 2 through 5; and 2-5,7-9,11 to select messages 2, 3, 4, 5, 7, 8, 9, and 11.
5530 The word &quot;end&quot; or the character &quot;$&quot; may be used as a
5531 substitute for the highest numbered message in the folder, while the
5532 character &quot;.&quot; represents the message number holding the position
5533 of the cursor in the folder.
5534 If in a separate thread index where the numbers refer to threads instead of
5535 to messages, then you will be selecting all of the messages in the
5536 referenced threads instead of selecting by message number.
5537 </DD>
5538
5539 <DT>select by Date</DT>
5540 <DD> Select by either the date stored in the Date headers of each message,
5541 or by the date when the messages arrived.
5542 This does not adjust for different time zones, but just checks to see what
5543 day the message was sent on.
5544 You may type in a date. If you do, the date should be in the form
5545 <P><SAMP><CENTER>DD-Mon-YYYY</CENTER></SAMP><P>
5546 For example,
5547 <P><SAMP><CENTER>24-Nov-2004</CENTER></SAMP><P>
5548 or
5549 <P><SAMP><CENTER>09-Nov-2004</CENTER></SAMP><P>
5550 If the date you want is close to the current date, it is probably
5551 easier to use the &quot;^P&nbsp;Prev Day&quot; or &quot;^N&nbsp;Next Day&quot; commands to change the default date that
5552 is displayed, instead of typing in the date yourself.
5553 Or, the &quot;^X&nbsp;Cur Msg&quot; command may be used to fill in
5554 the date of the currently highlighted message.
5555 <P>
5556 There are six possible settings that are selected using the
5557 &quot;^W&nbsp;Toggle When&quot; command.
5558 Three of them select messages based on the Date headers.
5559 They are &quot;SENT SINCE&quot;, &quot;SENT BEFORE&quot;,
5560 and &quot;SENT ON&quot;.
5561 SINCE is all messages with the selected date or later.
5562 BEFORE is all messages earlier than the selected date (not including the day
5563 itself).
5564 ON is all messages sent on the selected date.
5565 The other three select messages in the same way but they use the arrival
5566 times of the messages instead of the Date headers included in the messages.
5567 Those three are &quot;ARRIVED SINCE&quot;, &quot;ARRIVED BEFORE&quot;,
5568 and &quot;ARRIVED ON&quot;.
5569 When you save a message from one folder to another the arrival time is
5570 preserved.
5571 </DD>
5572
5573 <DT>select by Text</DT>
5574 <DD> Selects messages based on the message contents.
5575 This allows you to select a set of messages based on whether or not the
5576 message headers or message body contain specified text.
5577 You may look for text in the Subject, the From header,
5578 the To header, or the Cc header.
5579 You may also choose Recipient, which searches for the text in
5580 either the To or the Cc header;
5581 or Participant, which means To or Cc or From.
5582 Besides those specific header searches, you may also search the entire
5583 header and text of the message with &quot;All Text&quot;, or just the
5584 body of the message.
5585 <P>
5586 To search for the absence of text, first type the &quot;! Not&quot; command
5587 before typing the specific type of text search.
5588 For example, you could type &quot;!&quot; followed by &quot;S&quot; to
5589 search for all messages that do not contain a particular word in their
5590 Subjects.
5591 <P>
5592 If you choose a Subject search, you may use the subject from the current
5593 message by typing the &quot;^X Cur Subject&quot; command.
5594 You may then edit it further if you wish.
5595 For example, you might select the subject of a reply and edit the
5596 &quot;Re:&nbsp;&quot; off of the front of it in order to search for
5597 the original message being replied to.
5598 All of the other header searches allow you to use addresses from the
5599 headers of the current message if you want to.
5600 You may use the &quot;^T Cur To&quot;, &quot;^R Cur From&quot;, or
5601 &quot;^W Cur Cc&quot;.
5602 In each case, if there is more than one address, only the first is offered.
5603 </DD>
5604
5605 <DT>select by Status</DT>
5606 <DD> Selects messages based on their status.
5607 You may select all New, Important, Deleted, Answered, Recent, or Unseen
5608 messages.
5609 Or, if you first type the &quot;! Not&quot; command, you get not New,
5610 or not Important, and so on.
5611 If you select Deleted messages, you will get all messages with their
5612 Deleted flag set.
5613 Likewise for Important messages, all messages that you have flagged as
5614 being Important with the
5615 <A HREF="h_common_flag">Flag</A> command.
5616 The &quot;New&quot; and &quot;Answered&quot; choices are a little bit odd
5617 because they try to match what you see on the screen by default.
5618 &quot;New&quot; is a shorthand for messages that are Unseen, Undeleted,
5619 and Unanswered.
5620 If you have looked at the message, or deleted it, or answered it; then it
5621 is not considered &quot;New &quot;.
5622 &quot;!&nbsp;New&quot; is the opposite of &quot;New&quot;.
5623 <P>
5624 &quot;Answered&quot; is another one that is a little different.
5625 It means that the message has been Answered <EM>and</EM> is not deleted.
5626 And to make it even more confusing, &quot;!&nbsp;Answered&quot; is not
5627 the opposite of &quot;Answered&quot;!
5628 Instead, &quot;!&nbsp;Answered&quot; stands for messages that are
5629 both Unanswered <EM>and</EM> not deleted.
5630 <P>
5631 The other two types were added later because the special nature of the
5632 New flag was not what was wanted by all users.
5633 New does match what you see in the index by default, but if you use
5634 the IMAPSTATUS or SHORTIMAPSTATUS token in the
5635 &quot;<A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A>&quot; it may not
5636 be exactly what you want.
5637 &quot;Unseen&quot; simply selects all unseen messages, whether or not
5638 they are deleted or answered, and
5639 &quot;Recent&quot; selects all of the messages that have been added to
5640 the folder since you started this Alpine session.
5641 (That's not technically quite true. If there are multiple mail clients
5642 reading an IMAP mailbox, each message will be marked as Recent in only
5643 one of the client's sessions.)
5644 </DD>
5645
5646 <DT>select by siZe</DT>
5647 <DD> Selects messages based on their size being smaller than or larger
5648 than the size you specify.
5649 The size is the number of bytes.
5650 You may use the suffix &quot;K&quot; or &quot;k&quot; to mean 1,000 times
5651 the number.
5652 For example, 7K is the same as 7000.
5653 The suffix &quot;M&quot; or &quot;m&quot; means 1,000,000 times the number,
5654 and the suffix &quot;G&quot; or &quot;g&quot; means 1,000,000,000 times.
5655 Use the &quot;^W&quot; command to toggle back and forth between Smaller
5656 and Larger.
5657 </DD>
5658
5659 <DT>select by Keyword</DT>
5660 <DD> Selects messages that either have or do not have
5661 (using the &quot;!&nbsp;Not&quot; command)
5662 a particular <A HREF="h_config_keywords">Keyword</A> set.
5663 One way to select a keyword is to use the &quot;^T&nbsp;To&nbsp;List&quot;
5664 command to select one from your list of keywords.
5665 The
5666 <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.
5667 </DD>
5668
5669 <DT>select by Rule</DT>
5670 <DD> Selects messages that either match or don't match
5671 (using the &quot;!&nbsp;Not&quot; command)
5672 one of the Rules you have defined.
5673 The most likely method of filling in the Rule is to use the
5674 &quot;^T&nbsp;To&nbsp;List&quot;
5675 command to select one of your Rules.
5676 All of the Rules you have defined will be in the list, including
5677 Rules for Searching, Indexcolors, Filtering, Roles, Score setting, and Other.
5678 They may not all make sense for this purpose, but they are all there for
5679 flexibility.
5680 You might find it useful to define some rules solely for the purpose
5681 of being used by the Select command.
5682 There is a special category for such Rules. They are called Search Rules.
5683 <P>
5684 Unfortunately, Alpine does not allow all possible Rules to be defined.
5685 For example, there is no logical OR operation.
5686 OR is accomplished in the Filter Rules or the other types of Rules by
5687 simply defining two rules, one that matches the first part of the OR
5688 and another that matches the second part.
5689 But you can't do that here, since you only have a single Rule to work with.
5690 Likewise, the order of Rules is usually important.
5691 For example, if the first Filter Rule (or Indexcolor rule or ...) matches
5692 a message, then that stops the search for a further match.
5693 This means that you may be confused if you try to use Select by Rule to
5694 check your Filter rules because the order is important when filtering but
5695 is not considered here.
5696 </DD>
5697
5698 <DT>select by tHread</DT>
5699 <DD> Selects all of the messages in the current thread.
5700 </DD>
5701 </DL>
5702
5703 After you have an initial selection, the next and subsequent selection
5704 commands modify the selection.
5705 The select command changes. It first gives
5706 you selection &quot;alteration&quot; options: &quot;unselect All&quot;,
5707 &quot;unselect Current&quot;,
5708 &quot;Broaden selection&quot; (implements a logical OR), and
5709 &quot;Narrow selection&quot; (implements a logical AND).
5710 After you choose either Broaden or Narrow, you then choose one of the
5711 selection criteria listed above (by Text or Number or ...).
5712 You may use select as many times as you wish to get the selected set right.
5713 <P>
5714
5715 The WhereIs command has a feature (Ctrl-X) to
5716 select all the messages that match the WhereIs search. WhereIs searches
5717 through just the text that appears on the MESSAGE INDEX screen.
5718 This method is often slower than using the select command itself, unless the
5719 line you are looking for is not too far away in the index.
5720 <P>
5721
5722 The availability of the aggregate operations commands is determined by the
5723 <A HREF="h_config_enable_agg_ops">&quot;<!--#echo var="FEAT_enable-aggregate-command-set"-->&quot;</A>
5724 Feature-List option in your Alpine
5725 configuration, which defaults to set.
5726 The features
5727 <A HREF="h_config_auto_zoom">&quot;<!--#echo var="FEAT_auto-zoom-after-select"-->&quot;</A>
5728 and
5729 <A HREF="h_config_select_wo_confirm">&quot;<!--#echo var="FEAT_select-without-confirm"-->&quot;</A>
5730 affect the behavior of the Select command.
5731
5732 <P>
5733 &lt;End of help on this topic&gt;
5734 </BODY>
5735 </HTML>
5736 ======= h_select_rule =======
5737 <HTML>
5738 <HEAD>
5739 <TITLE>Select: Rule</TITLE>
5740 </HEAD>
5741 <BODY>
5742 <H1>Select: Rule</H1>
5743
5744 You are selecting messages that either match or don't match
5745 one of the Rules you have defined.
5746 You may either type the nickname of the Rule at the prompt, or use the
5747 &quot;^T&nbsp;To&nbsp;List&quot;
5748 command to select one of your Rules.
5749 All of the Rules you have defined will be in the list, including
5750 Rules for Indexcolors, Filtering, Roles, Score setting, and Other.
5751 They may not all make sense for this purpose, but they are all there for
5752 flexibility.
5753 Rules may be added by using the Setup/Rules screen off of the main Alpine
5754 menu.
5755 <P>
5756 Unfortunately, Alpine does not allow all possible Rules to be defined.
5757 For example, there is no logical OR operation.
5758 OR is accomplished in the Filter Rules or the other types of Rules by
5759 simply defining two rules, one that matches the first part of the OR
5760 and another that matches the second part.
5761 But you can't do that here, since you only have a single Rule to work with.
5762 Likewise, the order of Rules is usually important.
5763 For example, if the first Filter Rule (or Indexcolor rule or ...) matches
5764 a message, then that stops the search for a further match.
5765 This means that you may be confused if you try to use Select by Rule to
5766 check your Filter rules because the order is important when filtering but
5767 is not considered here.
5768
5769 <P>
5770 &lt;End of help on this topic&gt;
5771 </BODY>
5772 </HTML>
5773 ======= h_select_text =======
5774 <HTML>
5775 <HEAD>
5776 <TITLE>Select: Text</TITLE>
5777 </HEAD>
5778 <BODY>
5779 <H1>Select: Text</H1>
5780
5781 You are selecting messages based on the contents of the message.
5782 This allows you to select a set of messages based on whether or not the
5783 message headers or message body contain specified text.
5784 You may look for text in the Subject, the From header,
5785 the To header, or the Cc header.
5786 You may also choose Recipient, which searches for the text in
5787 either the To or the Cc header;
5788 or Participant, which means either the To header, or the Cc header,
5789 or the From header.
5790 Besides those specific header searches, you may also search the entire
5791 header and text of the message with &quot;All Text&quot;, or just the
5792 body of the message with &quot;Body&quot;.
5793 <P>
5794 To search for the absence of text, first type the &quot;!&nbsp;Not&quot; command
5795 before typing the specific type of text search.
5796 For example, you could type &quot;!&quot; followed by &quot;S&quot; to
5797 search for all messages that do not contain a particular word in their
5798 Subjects.
5799 <P>
5800 If you choose a Subject search, you may use the subject from the current
5801 message by typing the &quot;^X Cur Subject&quot; command.
5802 You may then edit it further if you wish.
5803 For example, you might select the subject of a reply and edit the
5804 &quot;Re:&nbsp;&quot; off of the front of it in order to search for
5805 the original message being replied to.
5806 All of the other header searches allow you to use addresses from the
5807 headers of the current message if you want to.
5808 You may use the &quot;^T Cur To&quot;, &quot;^R Cur From&quot;, or
5809 &quot;^W Cur Cc&quot;.
5810 In each case, if there is more than one address, only the first is offered.
5811
5812 <P>
5813 &lt;End of help on this topic&gt;
5814 </BODY>
5815 </HTML>
5816 ======= h_select_status =======
5817 <HTML>
5818 <HEAD>
5819 <TITLE>Select: Status</TITLE>
5820 </HEAD>
5821 <BODY>
5822 <H1>Select: Status</H1>
5823
5824 You are selecting messages based on the status of the message.
5825 For example, whether or not the message has been marked Deleted or Important,
5826 or whether or not it has been Answered or is New.
5827 If you first type the &quot;!&nbsp;Not&quot; command, you will get the
5828 opposite: not Deleted, not Important, and so on.
5829 <P>
5830 If you select Deleted messages, you will get all messages with their
5831 Deleted flag set.
5832 Likewise for Important messages, all messages that you have flagged as
5833 being Important with the
5834 <A HREF="h_common_flag">Flag</A> command.
5835 The &quot;New&quot; and &quot;Answered&quot; choices are a little bit odd
5836 because they try to match what you see on the screen by default.
5837 &quot;New&quot; is a shorthand for messages that are Unseen, Undeleted,
5838 and Unanswered.
5839 If you have looked at the message, or deleted it, or answered it; then it
5840 is not considered &quot;New &quot;.
5841 &quot;!&nbsp;New&quot; is the opposite of &quot;New&quot;.
5842 <P>
5843 &quot;Answered&quot; is another one that is a little different.
5844 It means that the message has been Answered <EM>and</EM> is not deleted.
5845 And to make it even more confusing, &quot;!&nbsp;Answered&quot; is not
5846 the opposite of &quot;Answered&quot;!
5847 Instead, &quot;!&nbsp;Answered&quot; stands for messages that are
5848 both Unanswered <EM>and</EM> not deleted.
5849 <P>
5850 (The New and Answered options may seem counter-intuitive.
5851 The reason it is done this way is
5852 because, by default, a Deleted message will show up with the &quot;D&quot;
5853 symbol in the MAIL INDEX screen even if it is New or Answered.
5854 The Delete symbol overrides the New and Answered symbols, because you
5855 usually don't care about the message anymore once you've deleted it.
5856 Similarly, you usually only care about whether a message is Answered or
5857 not if it is not Deleted.
5858 Once it is Deleted you've put it out of your mind.)
5859 <P>
5860 The other two options were added later because the special nature of the
5861 New flag was not what was wanted by all users.
5862 New does match what you see in the index by default, but if you use
5863 the IMAPSTATUS or SHORTIMAPSTATUS token in the
5864 &quot;<A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A>&quot; it may not
5865 be exactly what you expect.
5866 &quot;Unseen&quot; simply selects all unseen messages, whether or not
5867 they are deleted or answered, and
5868 &quot;Recent&quot; selects all of the messages that have been added to
5869 the folder since you started this Alpine session.
5870 (That's not technically quite true. If there are multiple mail clients
5871 reading an IMAP mailbox, each message will be marked as Recent in only
5872 one of the client's sessions.
5873 That behavior can be convenienent for some purposes, like filtering, but
5874 it isn't usually what you expect when selecting.)
5875
5876 <P>
5877 &lt;End of help on this topic&gt;
5878 </BODY>
5879 </HTML>
5880 ======= h_index_cmd_apply =======
5881 <HTML>
5882 <HEAD>
5883 <TITLE>Apply Command</TITLE>
5884 </HEAD>
5885 <BODY>
5886 <H1>Apply Command</H1>
5887
5888 Apply
5889 (<!--chtml if pinemode="function_key"-->F6<!--chtml else-->A<!--chtml endif-->)
5890 is the second step of most aggregate operations.  Apply
5891 becomes active any time there is a defined set of selected messages.  The
5892 following commands can be applied to a selected message set: delete,
5893 undelete, reply, forward,
5894 <!--chtml if pinemode="os_windows"-->
5895 <!--chtml else-->
5896 pipe,
5897 <!--chtml endif-->
5898 print, take address, save, export, bounce, and flag.
5899 <P>
5900
5901 The behavior of some of these commands in an aggregate sense is not easy to
5902 explain.  Try them out to see what they do.
5903 The feature
5904 <A HREF="h_config_auto_unzoom">&quot;<!--#echo var="FEAT_auto-unzoom-after-apply"-->&quot;</A>
5905 affects the behavior of the Apply command, as does the feature
5906 <A HREF="h_config_auto_unselect">&quot;<!--#echo var="FEAT_auto-unselect-after-apply"-->&quot;</A>.
5907
5908 <P>
5909 &lt;End of help on this topic&gt;
5910 </BODY>
5911 </HTML>
5912 ======= h_index_cmd_zoom =======
5913 <HTML>
5914 <HEAD>
5915 <TITLE>ZoomMode Command</TITLE>
5916 </HEAD>
5917 <BODY>
5918 <H1>ZoomMode Command</H1>
5919
5920 Another action you might want to take on a set of selected messages is to
5921 zoom in on them.  Like apply, zoom only becomes active when messages have
5922 been selected.
5923 ZoomMode
5924 (<!--chtml if pinemode="function_key"-->F3<!--chtml else-->Z<!--chtml endif-->)
5925 is a toggle command that allows you to
5926 zoom-in (and only see the selected messages) and zoom-out (to see all
5927 messages in the folder).  Neither apply nor zoom removes the markings that
5928 define the selected set; you need to use a select command in order
5929 to do that.
5930
5931 <P>
5932 &lt;End of help on this topic&gt;
5933 </BODY>
5934 </HTML>
5935 ======= h_index_collapse_expand =======
5936 <HTML>
5937 <HEAD>
5938 <TITLE>Collapse/Expand Command</TITLE>
5939 </HEAD>
5940 <BODY>
5941 <H1>Collapse/Expand Command</H1>
5942
5943 The Collapse/Expand command is only available from the MESSAGE INDEX screen when
5944 the folder is sorted by either Threads or OrderedSubject, and the
5945 <A HREF="h_config_thread_disp_style"><!--#echo var="VAR_threading-display-style"--></A>
5946 is set to something other than &quot;none&quot;.
5947 By default, this command collapses or expands the subthread that starts at
5948 the currently highlighted message, if any.
5949 If the subthread is already collapsed, then this command expands it.
5950 If the subthread is expanded, then this command collapses it.
5951 If there are no more messages below the current message in the
5952 thread tree (that is, there are no replies to the current message) then
5953 this command does nothing.
5954
5955 <P>
5956 The behavior of this command is affected by the option
5957 <A HREF="h_config_slash_coll_entire">&quot;<!--#echo var="FEAT_slash-collapses-entire-thread"-->&quot;</A>.
5958 Normally, this command Collapses or Expands the subthread that
5959 starts at the currently highlighted message.
5960 If the above option is set, then this command Collapses or Expands the
5961 entire current thread instead of just the subthread.
5962 The current thread is simply the top-level thread that contains the
5963 current message.
5964
5965 <P>
5966 &lt;End of help on this topic&gt;
5967 </BODY>
5968 </HTML>
5969 ======= h_index_cmd_sort =======
5970 <HTML>
5971 <HEAD>
5972 <TITLE>Sort Command</TITLE>
5973 </HEAD>
5974 <BODY>
5975 <H1>Sort Command</H1>
5976
5977 In Alpine's generic configuration, messages are presented in the order in
5978 which they arrive.  This default can be changed in the SETUP CONFIGURATION
5979 with the &quot;<A HREF="h_config_sort_key"><!--#echo var="VAR_sort-key"--></A>&quot; option.
5980 You can also re-sort the folder on demand with the sort
5981 (<!--chtml if pinemode="function_key"-->F7<!--chtml else-->$<!--chtml endif-->)
5982 command.
5983 Your sorting options are:
5984 <P>
5985 <UL>
5986  <LI> <A HREF="h_index_sort_arrival">A</A>rrival
5987  <LI> <A HREF="h_index_sort_date">D</A>ate
5988  <LI> <A HREF="h_index_sort_subj">S</A>ubject
5989  <LI> <A HREF="h_index_sort_ordsubj">O</A>rderedSubject
5990  <LI> t<A HREF="h_index_sort_thread">H</A>read
5991  <LI> <A HREF="h_index_sort_from">F</A>rom
5992  <LI> si<A HREF="h_index_sort_size">Z</A>e
5993  <LI> scor<A HREF="h_index_sort_score">E</A>,
5994  <LI> <A HREF="h_index_sort_to">T</A>o
5995  <LI> <A HREF="h_index_sort_cc">C</A>c
5996 </UL>
5997
5998 <P>
5999 The Reverse option will toggle the order the index is currently
6000 sorted by, but will not change the relative sort order.
6001
6002 <P>
6003 Sorting a folder does not actually rearrange the way the folder is saved,
6004 it just re-arranges how the messages are presented to you.  This means
6005 that Alpine has to do the work of sorting every time you change sort order.
6006 Sometimes, especially with PC-Alpine or with large folders, this could take
6007 a while.
6008
6009 <P>
6010 &lt;End of help on this topic&gt;
6011 </BODY>
6012 </HTML>
6013 ======= h_index_sort_default =======
6014 <HTML>
6015 <HEAD>
6016 <TITLE>SORT OPTION: Default</TITLE>
6017 </HEAD>
6018 <BODY>
6019 <H1>SORT OPTION: Default</H1>
6020
6021 The <EM>Default</EM> sort option just means to use the default sort order
6022 set in the
6023 <li><a href="h_config_sort_key"><!--#echo var="VAR_sort-key"--></a>
6024 option in Setup/Config.
6025
6026 <P>
6027 &lt;End of help on this topic&gt;
6028 </BODY>
6029 </HTML>
6030 ======= h_index_sort_arrival =======
6031 <HTML>
6032 <HEAD>
6033 <TITLE>SORT OPTION: Arrival</TITLE>
6034 </HEAD>
6035 <BODY>
6036 <H1>SORT OPTION: Arrival</H1>
6037
6038 The <EM>Arrival</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX
6039 in the order that they exist in the folder.  This is usually the same as the
6040 order in which they arrived.  This option is comparable to not sorting
6041 the messages at all.
6042
6043 <P>
6044 &lt;End of help on this topic&gt;
6045 </BODY>
6046 </HTML>
6047 ======= h_index_sort_date =======
6048 <HTML>
6049 <HEAD>
6050 <TITLE>SORT OPTION: Date</TITLE>
6051 </HEAD>
6052 <BODY>
6053 <H1>SORT OPTION: Date</H1>
6054
6055 The <EM>Date</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX
6056 according to the date and time they were
6057 sent.
6058
6059 <P>
6060 On a folder like INBOX, sorting by &quot;Date&quot; should be almost
6061 identical to sorting by &quot;Arrival&quot;.
6062
6063 <P>
6064 &lt;End of help on this topic&gt;
6065 </BODY>
6066 </HTML>
6067 ======= h_index_sort_subj =======
6068 <HTML>
6069 <HEAD>
6070 <TITLE>SORT OPTION: Subject</TITLE>
6071 </HEAD>
6072 <BODY>
6073 <H1>SORT OPTION: Subject</H1>
6074
6075 The <EM>Subject</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX
6076 by subject.
6077
6078 <P>
6079 Messages with the same subject are
6080 first grouped together, and then the groups of like-subject messages
6081 are arranged alphabetically.
6082
6083 <P>
6084 Alpine ignores leading &quot;Re:&quot; and
6085 &quot;re:&quot; and trailing &quot;(fwd)&quot; when determining the
6086 likeness and alphabetical order of subject lines.
6087
6088 <P>
6089 &lt;End of help on this topic&gt;
6090 </BODY>
6091 </HTML>
6092 ======= h_index_sort_ordsubj =======
6093 <HTML>
6094 <HEAD>
6095 <TITLE>SORT OPTION: OrderedSubject</TITLE>
6096 </HEAD>
6097 <BODY>
6098 <H1>SORT OPTION: OrderedSubject</H1>
6099
6100 The <EM>OrderedSubject</EM> sort option arranges messages in the
6101 MESSAGE&nbsp;INDEX by grouping all messages with the same subject
6102 together, similar to sort by <A HREF="h_index_sort_subj">S</A>ubject.
6103
6104 <P>
6105 However, <EM>OrderedSubj</EM> then arranges the groups of like-subject
6106 messages by the date of the oldest message in the group.
6107
6108 <P>
6109 This sort method provides for pseudo threading of conversations within
6110 a folder.
6111 You may want to try sorting by Thread instead.
6112
6113 <P>
6114 &lt;End of help on this topic&gt;
6115 </BODY>
6116 </HTML>
6117 ======= h_index_sort_thread =======
6118 <HTML>
6119 <HEAD>
6120 <TITLE>SORT OPTION: Thread</TITLE>
6121 </HEAD>
6122 <BODY>
6123 <H1>SORT OPTION: Thread</H1>
6124
6125 The <EM>Thread</EM> sort option arranges messages in the
6126 MESSAGE&nbsp;INDEX by grouping all messages that indicate
6127 they are part of a conversation (discussion thread) taking
6128 place within a mailbox or newsgroup.  This indication is
6129 based on information in the message's header -- specifically
6130 its <tt>References:</tt>, <tt>Message-ID:</tt>, and <tt>Subject:</tt> fields.
6131
6132 <P>
6133 &lt;End of help on this topic&gt;
6134 </BODY>
6135 </HTML>
6136 ======= h_index_sort_from =======
6137 <HTML>
6138 <HEAD>
6139 <TITLE>SORT OPTION: From</TITLE>
6140 </HEAD>
6141 <BODY>
6142 <H1>SORT OPTION: From</H1>
6143
6144 The <EM>From</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX
6145 by the name of the author of the message.
6146
6147 <P>
6148 Messages with the same author are grouped together. Groups of
6149 messages are then put into alphabetical order according to message
6150 author.
6151
6152 <P>
6153 &lt;End of help on this topic&gt;
6154 </BODY>
6155 </HTML>
6156 ======= h_index_sort_size =======
6157 <HTML>
6158 <HEAD>
6159 <TITLE>SORT OPTION: Size</TITLE>
6160 </HEAD>
6161 <BODY>
6162 <H1>SORT OPTION: Size</H1>
6163
6164 The <EM>Size</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX
6165 by their relative sizes.
6166
6167 <P>
6168 &lt;End of help on this topic&gt;
6169 </BODY>
6170 </HTML>
6171 ======= h_index_sort_score =======
6172 <HTML>
6173 <HEAD>
6174 <TITLE>SORT OPTION: Score</TITLE>
6175 </HEAD>
6176 <BODY>
6177 <H1>SORT OPTION: Score</H1>
6178
6179 The <EM>Score</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX
6180 by their scores.
6181
6182 <P>
6183 Messages with the same score are sorted in arrival order.
6184 Scores are something you create using the
6185 <A HREF="h_rules_score">&quot;SETUP SCORING&quot;</A> screen.
6186
6187 <P>
6188 &lt;End of help on this topic&gt;
6189 </BODY>
6190 </HTML>
6191 ======= h_index_sort_to =======
6192 <HTML>
6193 <HEAD>
6194 <TITLE>SORT OPTION: To</TITLE>
6195 </HEAD>
6196 <BODY>
6197 <H1>SORT OPTION: To</H1>
6198
6199 The <EM>To</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX
6200 by the names of the recipients of the message.
6201
6202 <P>
6203 Messages with the same recipients are grouped together. Groups of
6204 messages are then put into alphabetical order according to message
6205 recipients.
6206
6207 <P>
6208 &lt;End of help on this topic&gt;
6209 </BODY>
6210 </HTML>
6211 ======= h_index_sort_cc =======
6212 <HTML>
6213 <HEAD>
6214 <TITLE>SORT OPTION: Cc</TITLE>
6215 </HEAD>
6216 <BODY>
6217 <H1>SORT OPTION: Cc</H1>
6218
6219 The <EM>Cc</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX by
6220 the names of the carbon copy addresses of the message.
6221
6222 <P>
6223 &lt;End of help on this topic&gt;
6224 </BODY>
6225 </HTML>
6226 ======= h_index_cmd_whereis =======
6227 <HTML>
6228 <HEAD>
6229 <TITLE>WhereIs Command</TITLE>
6230 </HEAD>
6231 <BODY>
6232 <H1>WhereIs Command</H1>
6233
6234 The WhereIs
6235 (<!--chtml if pinemode="function_key"-->F8<!--chtml else-->W<!--chtml endif-->)
6236 command lets you search the MESSAGE INDEX for a word.
6237 It scans through whatever you see, usually the name of the author
6238 and the Subject line.
6239 WhereIs has special subcommands to let you find the beginning of the
6240 index (Ctrl-Y -- first message)
6241 or the end of the index (Ctrl-V -- last message).
6242 <P>
6243 Note that WhereIs only searches through the visible text on the screen.
6244 For example, if only part of the Subject of a message is shown because it
6245 is long, then only the visible portion of the Subject is searched.
6246 Also note that WhereIs does not &quot;see&quot; the
6247 &quot;X&quot; in column one of Index entries for selected messages
6248 so it can't be used to search for
6249 selected messages (use &quot;Zoom&quot; instead).
6250 <P>
6251 If the feature
6252 <A HREF="h_config_enable_agg_ops">&quot;<!--#echo var="FEAT_enable-aggregate-command-set"-->&quot;</A>
6253 is turned on,
6254 WhereIs can also be used as a quick way to select messages that match the
6255 string being searched for.
6256 Instead of typing carriage return to search for the next match, type
6257 Ctrl-X to select all matches.
6258 Once again, this only selects matches that are (or would be if the right
6259 index line was on the screen) visible.
6260 Truncated From lines or Subjects will cause matches to be missed.
6261 Although WhereIs is sometimes convenient for quick matching, the Select
6262 command is usually more powerful and usually faster.
6263
6264 <P>
6265 &lt;End of help on this topic&gt;
6266 </BODY>
6267 </HTML>
6268 ======= h_view_cmd_whereis =======
6269 <HTML>
6270 <HEAD>
6271 <TITLE>WhereIs Command</TITLE>
6272 </HEAD>
6273 <BODY>
6274 <H1>WhereIs Command</H1>
6275
6276 The WhereIs
6277 (<!--chtml if pinemode="function_key"-->F8<!--chtml else-->W<!--chtml endif-->)
6278 command does a &quot;find in current message&quot; operation.  You
6279 type in text and Alpine will try to find it in the message you are
6280 reading.  WhereIs also has subcommands to jump to the beginning (Ctrl-Y)
6281 or end (Ctrl-V) of the message.
6282 That is, to rapidly move to the end of a message, hit the
6283 <!--chtml if pinemode="function_key"-->F8<!--chtml else-->W<!--chtml endif-->
6284 (or Ctrl-W) key followed
6285 by Ctrl-V.  Similarly,
6286 <!--chtml if pinemode="function_key"-->F8<!--chtml else-->W<!--chtml endif-->
6287 followed by Ctrl-Y will take you to the beginning of a message.
6288
6289 <P>
6290 &lt;End of help on this topic&gt;
6291 </BODY>
6292 </HTML>
6293 ======= h_view_cmd_hilite =======
6294 <HTML>
6295 <HEAD>
6296 <TITLE>View Hilite and Next item/Previous item</TITLE>
6297 </HEAD>
6298 <BODY>
6299 <H1>View Hilite and Next item/Previous item</H1>
6300
6301 Sometimes messages may be in the form of formatted HTML text
6302 or they may contain URLs or Web server hostnames.
6303 When any of the features
6304 <A HREF="h_config_enable_view_url">&quot;<!--#echo var="FEAT_enable-msg-view-urls"-->&quot;</A>,
6305 <A HREF="h_config_enable_view_web_host">&quot;<!--#echo var="FEAT_enable-msg-view-web-hostnames"-->&quot;</A>,
6306 <A HREF="h_config_enable_view_attach">&quot;<!--#echo var="FEAT_enable-msg-view-attachments"-->&quot;</A>,
6307 or
6308 <A HREF="h_config_enable_view_addresses">&quot;<!--#echo var="FEAT_enable-msg-view-addresses"-->&quot;</A>
6309 are enabled, Alpine will represent such selectable items in the text
6310 in bold typeface.  One of the selectable items will be displayed in
6311 inverse video (highlighted).  This is the &quot;currently selected&quot; item.
6312 Press the Return key to view the currently selected item.
6313 <P>
6314
6315 The Up and Down Arrows keys can be used to change the selected item
6316 (also see the feature
6317 <A HREF="h_config_enable_view_arrows">&quot;<!--#echo var="FEAT_enable-msg-view-forced-arrows"-->&quot;</A>).
6318 If there are no selectable items in the direction of the arrow you
6319 pressed, Alpine will scroll the display in that direction until one
6320 becomes visible.  To &quot;jump&quot; forwards/backwards among selectable
6321 items in the message text, use the Previous and Next item commands,
6322 <!--chtml if pinemode="function_key"-->F5 and F6
6323 <!--chtml else-->^B and ^F<!--chtml endif-->.
6324
6325 <P>
6326 &lt;End of help on this topic&gt;
6327 </BODY>
6328 </HTML>
6329 ======= h_view_cmd_viewattch =======
6330 <HTML>
6331 <HEAD>
6332 <TITLE>ViewAttch Command</TITLE>
6333 </HEAD>
6334 <BODY>
6335 <H1>ViewAttch Command</H1>
6336
6337
6338 The View/Save Attachment
6339 (<!--chtml if pinemode="function_key"-->F4<!--chtml else-->V<!--chtml endif-->)
6340 command allows you to handle MIME attachments to a message you have
6341 received.  Alpine shows you a list of the message attachments -- you just
6342 choose the attachment you want.  You may either view or save the
6343 selected attachment.
6344
6345 <P>
6346 Because many attachments require external programs for display, there
6347 is some system configuration that has to happen before you can
6348 actually display attachments.  Hopefully much of that will have been
6349 done already by your system administrator.  MIME configuration is
6350 handled with the &quot;mailcap&quot; configuration file.  (See the section
6351 on configuration in the
6352 <A HREF="h_news">release notes</A> for more information.)
6353
6354 <P>
6355 &lt;End of help on this topic&gt;
6356 </BODY>
6357 </HTML>
6358 ======= h_index_cmd_expunge =======
6359 <HTML>
6360 <HEAD>
6361 <TITLE>Expunge/Exclude Command</TITLE>
6362 </HEAD>
6363 <BODY>
6364 <H1>Expunge/Exclude Command</H1>
6365
6366 Expunge/Exclude
6367 (<!--chtml if pinemode="function_key"-->F3<!--chtml else-->X<!--chtml endif-->)
6368 is the command Alpine uses to actually remove all messages
6369 marked for deletion.  With regular email files, expunge literally deletes
6370 the text from the current folder.  With newsgroups or shared mailboxes,
6371 you don't have permission to actually remove the message, so it is an
6372 exclude -- Alpine removes the message from your view of the folder even
6373 though it is not technically gone.
6374
6375 <P> A selective expunge command is available in IMAP folders that support
6376 the UID EXPUNGE extension in <A
6377 HREF="http://tools.ietf.org/html/rfc4315">RFC 4315</A> as well as for all
6378 other folders (local folders in all formats, POP3 inbox, and newsgroups)
6379 as a subcommand of the apply command. If some selected messages are marked
6380 deleted, then the apply command will offer the eXpunge command, which when
6381 executed will only expunge those messages that are selected and deleted.
6382
6383 <P>
6384 Observe that the expunge command (when not used from the apply command)
6385 will expunge/exclude all deleted messages from the folder, and so all
6386 messages marked deleted will be expunged, regardless of if they are
6387 selected or not. In other words, there is no protection against
6388 potentially expunging more messages than only those that have been
6389 selected and deleted.
6390 <P>
6391
6392 The configuration features
6393 <A HREF="h_config_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm"-->&quot;</A>
6394 and
6395 <A HREF="h_config_full_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm-everywhere"-->&quot;</A>
6396 affect the behavior of the Expunge command.
6397
6398 <P>
6399 &lt;End of help on this topic&gt;
6400 </BODY>
6401 </HTML>
6402 ======= h_common_compose =======
6403 <HTML>
6404 <HEAD>
6405 <TITLE>Compose Command</TITLE>
6406 </HEAD>
6407 <BODY>
6408 <H1>Compose Command</H1>
6409
6410 The Compose command takes you into the Alpine message composer where you
6411 can start a new message for sending.  This is where you type in the
6412 message's text and specify its recipient list (the &quot;To:&quot;
6413 address), where copies should be directed (e.g., &quot;Fcc&quot;,
6414 &quot;Cc:&quot; or &quot;Bcc:&quot;), and which files, if any, should
6415 be attached to the message.
6416
6417 <P>
6418 When you type this command, Alpine will also automatically check for any
6419 interrupted (i.e., a message that was being composed when your modem
6420 or network connection was broken) or previously postponed messages and
6421 offer you a chance to continue working on those.
6422
6423 <P>
6424 <UL>
6425 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
6426 </UL><P>
6427 &lt;End of help on this topic&gt;
6428 </BODY>
6429 </HTML>
6430 ======= h_common_index =======
6431 <HTML>
6432 <HEAD>
6433 <TITLE>Message Index Command</TITLE>
6434 </HEAD>
6435 <BODY>
6436 <H1>Message Index Command</H1>
6437
6438 The Index command takes you to the MESSAGE INDEX screen that displays a
6439 summary caption for each message in the currently-open folder. One
6440 message will be highlighted; this is the &quot;Current&quot; message.
6441 The message commands available from this screen (e.g. View, Reply,
6442 Forward, Delete, Print, Save, etc) apply to the current message.
6443
6444 <P>
6445 &lt;End of help on this topic&gt;
6446 </BODY>
6447 </HTML>
6448 ======= h_common_folders =======
6449 <HTML>
6450 <HEAD>
6451 <TITLE>Folder List Command</TITLE>
6452 </HEAD>
6453 <BODY>
6454 <H1>Folder List Command</H1>
6455
6456 This Folder List command takes you to the FOLDER LIST screen that displays
6457 the names of all your message folders and allows you to view, rename,
6458 delete, and add folders.  You can open (view) a different folder than the
6459 one currently open by highlighting the desired one (using the arrow keys
6460 or their control-key equivalents) and pressing RETURN.
6461
6462 <P>
6463 If you have multiple folder collections defined (see the Help text for
6464 the FOLDER LIST screen to learn more about Collections), you may need
6465 to press Return to expand the collection and display all of the
6466 folders in it.
6467
6468 <P>
6469 &lt;End of help on this topic&gt;
6470 </BODY>
6471 </HTML>
6472 ======= h_main_addrbook =======
6473 <HTML>
6474 <HEAD>
6475 <TITLE>Address Book Command</TITLE>
6476 </HEAD>
6477 <BODY>
6478 <H1>Address Book Command</H1>
6479
6480 This command, available only from the MAIN MENU, takes you
6481 to the ADDRESS BOOK management screen.  From here, your personal address
6482 book(s) may be updated.
6483
6484 <P>
6485 &lt;End of help on this topic&gt;
6486 </BODY>
6487 </HTML>
6488 ======= h_main_setup =======
6489 <HTML>
6490 <HEAD>
6491 <TITLE>Setup Command</TITLE>
6492 </HEAD>
6493 <BODY>
6494 <H1>Setup Command</H1>
6495
6496 The Setup command, available only from the MAIN MENU, prompts you for
6497 one of several configuration screens, including the SETUP CONFIGURATION
6498 screen, by which you may activate optional Alpine features.
6499
6500 <P>
6501 &lt;End of help on this topic&gt;
6502 </BODY>
6503 </HTML>
6504 ======= h_main_release_notes =======
6505 <HTML>
6506 <HEAD>
6507 <TITLE>Release Notes Command</TITLE>
6508 </HEAD>
6509 <BODY>
6510 <H1>Release Notes Command</H1>
6511
6512 This command displays information about Alpine <!--#echo var="ALPINE_VERSION"-->,
6513 as well as pointers to further information such as history and legal notes.
6514
6515 <P>
6516 &lt;End of help on this topic&gt;
6517 </BODY>
6518 </HTML>
6519 ======= h_main_kblock =======
6520 <HTML>
6521 <HEAD>
6522 <TITLE>Keyboard Lock Command</TITLE>
6523 </HEAD>
6524 <BODY>
6525 <H1>Keyboard Lock Command</H1>
6526
6527 This command allows your Alpine session to be protected
6528 during a temporary absence from your terminal.
6529
6530 <P>
6531 &lt;End of help on this topic&gt;
6532 </BODY>
6533 </HTML>
6534 ======= h_main_journal =======
6535 <HTML>
6536 <HEAD>
6537 <TITLE>Journal Command</TITLE>
6538 </HEAD>
6539 <BODY>
6540 <H1>Journal Command</H1>
6541
6542 This command displays a list of all the status messages Alpine has
6543 displayed (on the third line from the bottom of the screen). This may
6544 be useful if a message disappeared before you had a chance to read it.
6545
6546 <P>
6547 &lt;End of help on this topic&gt;
6548 </BODY>
6549 </HTML>
6550 ======= h_common_role =======
6551 <HTML>
6552 <HEAD>
6553 <TITLE>Role Command</TITLE>
6554 </HEAD>
6555 <BODY>
6556 <H1>Role Command</H1>
6557
6558 The Role command is similar to the Compose command except that it starts
6559 off by letting you select a <A HREF="h_rules_roles">role</A>
6560 to be used for the composition.
6561 You may set up alternate roles by using Setup/Rules/Roles.
6562
6563 <P>
6564 &lt;End of help on this topic&gt;
6565 </BODY>
6566 </HTML>
6567 ======= h_common_conditional_cmds =======
6568 <HTML>
6569 <HEAD>
6570 <TITLE>Conditional Commands</TITLE>
6571 </HEAD>
6572 <BODY>
6573 <H1>Conditional Commands</H1>
6574
6575 The presence or absence of certain commands, particularly in the
6576 MESSAGE INDEX and MESSAGE TEXT screens, is determined by
6577 whether or not specific features are set in your Alpine configuration.
6578 (You can access the SETUP CONFIGURATION screen, where they are found, from
6579 Alpine's MAIN MENU.)  To see if a desired command's availability is
6580 conditioned on a feature setting, see the command's help text (highlight
6581 the phrase associated with the command and hit Return).
6582
6583 <P>
6584 Also note that some
6585 commands may be administratively disabled by your system manager;
6586 if they don't work, please check with your local help desk.
6587
6588 <P>
6589 <UL>
6590 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
6591 </UL><P>
6592 &lt;End of help on this topic&gt;
6593 </BODY>
6594 </HTML>
6595 ======= h_common_pipe =======
6596 <HTML>
6597 <HEAD>
6598 <TITLE>Pipe Command</TITLE>
6599 </HEAD>
6600 <BODY>
6601 <H1>Pipe Command</H1>
6602
6603 Pipe
6604 (<!--chtml if pinemode="function_key"-->F12<!--chtml else-->|<!--chtml endif-->)
6605 allows you to send a message to a specified Unix command for external
6606 processing.
6607 This command's availability is controlled by the
6608 <A HREF="h_config_enable_pipe">&quot;<!--#echo var="FEAT_enable-unix-pipe-cmd"-->&quot;</A>
6609 feature.
6610 By default, the processed text of the message is sent to the command
6611 you specify and the output is captured by Alpine and shown to you.
6612 When you run the pipe command, there are some sub-commands which may be
6613 used to alter this behavior.
6614 These sub-commands are described <A HREF="h_pipe_command">here</A>.
6615
6616 <P>
6617 &lt;End of help on this topic&gt;
6618 </BODY>
6619 </HTML>
6620 ======= h_common_goto =======
6621 <HTML>
6622 <HEAD>
6623 <TITLE>Goto Command</TITLE>
6624 </HEAD>
6625 <BODY>
6626 <H1>Goto Command</H1>
6627
6628 Goto
6629 (<!--chtml if pinemode="function_key"-->F6<!--chtml else-->G<!--chtml endif-->)
6630 is the command that lets you bypass Alpine's folder selection screens
6631 and jump directly to a new folder.  You can select any folder in the
6632 world: one in your current collection, one in a different collection or
6633 one in a collection you've never even used before.
6634 <P>
6635
6636 Alpine will help you as much as possible to narrow in on the folder you want.
6637 However, if the folder is outside of your defined collections, you are
6638 going to have to enter the exact folder location using the correct
6639 <A HREF="h_valid_folder_names">syntax</A>
6640 for a remote folder and/or fully-qualified path name.
6641
6642 <P>
6643 &lt;End of help on this topic&gt;
6644 </BODY>
6645 </HTML>
6646 ======= h_common_nextnew =======
6647 <HTML>
6648 <HEAD>
6649 <TITLE>NextNew Command</TITLE>
6650 </HEAD>
6651 <BODY>
6652 <H1>NextNew Command</H1>
6653
6654 When you press the TAB key, Alpine advances to the next
6655 &quot;interesting&quot; message.
6656 This will be the next message you have not seen before, or the next message
6657 you have flagged Important, whichever comes first.
6658 Unread messages that have been deleted are not considered interesting.
6659 (A note about reading news. Alpine expects you to &quot;Delete&quot; news
6660 articles after you have read them if you want to remove them from future
6661 consideration. See <A HREF="h_mainhelp_readingnews">Reading News</A> for
6662 more information.)
6663
6664 <P>
6665 The NextNew command is affected by the feature
6666 <A HREF="h_config_tab_new_only">&quot;<!--#echo var="FEAT_tab-visits-next-new-message-only"-->&quot;</A>,
6667 which causes Alpine to only consider Unread messages interesting, not messages
6668 flagged Important.
6669
6670 <P>
6671 This command behaves a little differently when it finds there are no more
6672 interesting messages left in the current folder.
6673 If the current folder is one of your Incoming Message Folders
6674 (<A HREF="h_config_enable_incoming">&quot;<!--#echo var="FEAT_enable-incoming-folders"-->&quot;</A>)
6675 or it is a newsgroup, then Alpine will try to find the next folder or
6676 newsgroup that contains <EM>Recent</EM> messages and will ask you
6677 if you want to open that folder.
6678 This behavior may be modified by using the
6679 <A HREF="h_config_tab_uses_unseen">&quot;<!--#echo var="FEAT_tab-uses-unseen-for-next-folder"-->&quot;</A>
6680 feature that causes Alpine to look for Unseen messages instead of Recent
6681 messages.
6682 The NextNew command's behavior is also affected by the configuration features
6683 <A HREF="h_config_auto_open_unread">&quot;<!--#echo var="FEAT_auto-open-next-unread"-->&quot;</A>,
6684 and
6685 <A HREF="h_config_tab_no_prompt">&quot;<!--#echo var="FEAT_continue-tab-without-confirm"-->&quot;</A>.
6686
6687 <P>
6688 &lt;End of help on this topic&gt;
6689 </BODY>
6690 </HTML>
6691 ======= h_common_jump =======
6692 <HTML>
6693 <HEAD>
6694 <TITLE>Jump Command</TITLE>
6695 </HEAD>
6696 <BODY>
6697 <H1>Jump Command</H1>
6698
6699 This is Alpine's way of allowing you to go straight to a specific message.
6700 Just press &quot;J&quot; and then enter the message number.  By default, Alpine is also
6701 configured such that typing in any number automatically jumps you to that
6702 message
6703 (<A HREF="h_config_enable_jump">&quot;<!--#echo var="FEAT_enable-jump-shortcut"-->&quot;</A>
6704 in the SETUP CONFIGURATION).
6705
6706 <P>
6707 &lt;End of help on this topic&gt;
6708 </BODY>
6709 </HTML>
6710 ======= h_common_flag =======
6711 <HTML>
6712 <HEAD>
6713 <TITLE>Flag Command</TITLE>
6714 </HEAD>
6715 <BODY>
6716 <H1>Flag Command</H1>
6717
6718 Flag
6719 (<!--chtml if pinemode="function_key"-->F11<!--chtml else-->*<!--chtml endif-->)
6720 is the command that allows users to manipulate the status flags that
6721 appear on the left side of the MESSAGE INDEX screen.  The most common
6722 use of this is to mark a message as important. This is something of a
6723 note to yourself to get back to that message.  You may also use the
6724 flag command to set (or unset) the flags that indicate that a message
6725 is new, answered, deleted, or forwarded.<P>
6726
6727 Provided the mail server supports it,
6728 you may also manipulate user-defined keywords
6729 for a message using the flag command.
6730 These keywords will be available if you use the Flag Details screen that you
6731 can get to after typing the
6732 Flag (<!--chtml if pinemode="function_key"-->F11<!--chtml else-->*<!--chtml endif-->)
6733 command.
6734 They will be listed after the Important, New, Answered, Deleted , and Forwarded flags,
6735 which are always present.
6736 You may add new keywords by using the Add KW command from the Flag Details screen
6737 or by defining them in the <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in the Setup/Config screen.
6738
6739 The availability of the flag command is determined by the
6740 <A HREF="h_config_enable_flag">&quot;<!--#echo var="FEAT_enable-flag-cmd"-->&quot;</A>
6741 feature in your Alpine configuration. Also, it is possible that Flag could be
6742 administratively disabled by your system manager; if it doesn't work,
6743 please check with your local help desk before reporting a bug.
6744 The behavior of the flag command may be modified by the
6745 <A HREF="h_config_flag_screen_default">&quot;<!--#echo var="FEAT_enable-flag-screen-implicitly"-->&quot;</A> option or the
6746 <A HREF="h_config_flag_screen_kw_shortcut">&quot;<!--#echo var="FEAT_enable-flag-screen-keyword-shortcut"-->&quot;</A> option.
6747
6748 <P>
6749 &lt;End of help on this topic&gt;
6750 </BODY>
6751 </HTML>
6752 ======= h_common_hdrmode =======
6753 <HTML>
6754 <HEAD>
6755 <TITLE>HdrMode Command</TITLE>
6756 </HEAD>
6757 <BODY>
6758 <H1>HdrMode Command</H1>
6759
6760 Every email message comes with some header lines that you normally
6761 don't see (and don't want to see).
6762 These include anywhere from 3-20 lines (or more) added by the
6763 Internet mail transport system to record the route your message took,
6764 for diagnostic purposes.
6765 These are normally of no import and simply
6766 add clutter, so Alpine suppresses them in the MESSAGE TEXT display.
6767 This also includes other non-standard headers the message may contain.
6768 If you want to see these headers, there is a way to reveal them.
6769 <P>
6770
6771 The Header Mode
6772 (<!--chtml if pinemode="function_key"-->F9<!--chtml else-->H<!--chtml endif-->)
6773 command is a toggle that controls Alpine's handling of these header
6774 lines.  Normally, full headers is &quot;off&quot; and you only see a
6775 few lines about who a message is to and who it is from.  When you
6776 press
6777 (<!--chtml if pinemode="function_key"-->F9<!--chtml else-->H<!--chtml endif-->)
6778 to turn full headers on, Alpine will show you
6779 the normal header lines as well as delivery headers, comment headers,
6780 MIME headers, and any other headers present.
6781 <P>
6782
6783 Several different Alpine commands honor the header mode -- it affects how
6784 messages are displayed, how they appear in forward and reply email, how
6785 they are printed, how they are saved, and how they are exported.
6786 <!--chtml if pinemode="os_windows"-->
6787 <!--chtml else-->
6788 The pipe command is also affected.
6789 <!--chtml endif-->
6790 <P>
6791
6792 The presence or absence of the Header Mode command is determined by the
6793 <A HREF="h_config_enable_full_hdr">&quot;<!--#echo var="FEAT_enable-full-header-cmd"-->&quot;</A>
6794 Feature-List option in your Alpine configuration.
6795
6796 <P>
6797 If you have also turned on the
6798 <A HREF="h_config_quote_suppression">&quot;Quote Suppression&quot;</A>
6799 option then the HdrMode command actually rotates through three states
6800 instead of just two.
6801 The first is the normal view with long quotes suppressed.
6802 The second is the normal view but with the long quotes included.
6803 The last enables the display of all headers in the message.
6804 When using Export, Pipe, Print, Forward, or Reply the quotes are
6805 never suppressed, so the first two states are identical.
6806
6807 <P>
6808 The behavior of the Header Mode command may be altered slightly by
6809 turning on the
6810 <A HREF="h_config_quell_full_hdr_reset">&quot;<!--#echo var="FEAT_quell-full-header-auto-reset"-->&quot;</A>
6811 Feature-List option in your Alpine configuration.
6812 In particular, it will cause the Header Mode to be persistent when moving
6813 from message to message instead of resetting to the default for each message.
6814
6815 <P>
6816 <UL>
6817 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
6818 </UL><P>
6819 &lt;End of help on this topic&gt;
6820 </BODY>
6821 </HTML>
6822 ======= h_common_print =======
6823 <HTML>
6824 <HEAD>
6825 <TITLE>Print Command</TITLE>
6826 </HEAD>
6827 <BODY>
6828 <H1>Print Command</H1>
6829
6830 The Print
6831 (<!--chtml if pinemode="function_key"-->F9<!--chtml else-->%<!--chtml endif-->)
6832 command allows you to print a copy of a message.
6833 There are many SETUP CONFIGURATION features that affect the
6834 Print command, including
6835 <A HREF="h_config_enable_y_print">&quot;<!--#echo var="FEAT_enable-print-via-y-command"-->&quot;</A>,
6836 <A HREF="h_config_print_index">&quot;<!--#echo var="FEAT_print-index-enabled"-->&quot;</A>,
6837 <A HREF="h_config_custom_print">&quot;<!--#echo var="FEAT_print-offers-custom-cmd-prompt"-->&quot;</A>,
6838 <A HREF="h_config_print_from">&quot;<!--#echo var="FEAT_print-includes-from-line"-->&quot;</A>, and
6839 <A HREF="h_config_ff_between_msgs">&quot;<!--#echo var="FEAT_print-formfeed-between-messages"-->&quot;</A>.
6840 You set up for printing by using the Printer option of the Setup command
6841 on the MAIN MENU.
6842 <P>
6843
6844 <P>
6845 &lt;End of help on this topic&gt;
6846 </BODY>
6847 </HTML>
6848 ======= h_common_take =======
6849 <HTML>
6850 <HEAD>
6851 <TITLE>TakeAddr Command</TITLE>
6852 </HEAD>
6853 <BODY>
6854 <H1>TakeAddr Command</H1>
6855
6856
6857 With the Take Address
6858 (<!--chtml if pinemode="function_key"-->F10<!--chtml else-->T<!--chtml endif-->)
6859 command, you can extract email addresses from an
6860 incoming message and save them in an address book.  This is an easy way
6861 to add to your address book and avoid having to remember the email
6862 addresses of the people who write to you.
6863 <P>
6864
6865 If the message is just to you individually, then you will only need to
6866 provide a nickname.  If the message contains more than one email address,
6867 then you will see an address
6868 selection screen that lets you choose the address you want to save into
6869 your address book, or lets you choose several of them add to a
6870 personal distribution list.
6871 <P>
6872
6873 Once you've added an entry to your address book, you can use it from the
6874 message composer by typing the nickname of the entry into one of the
6875 header fields (for example, into the To: field), or you can use ^T from
6876 the header field to select the entry from your address book.
6877 <P>
6878
6879 If the configuration feature
6880 <A HREF="h_config_enable_role_take">&quot;<!--#echo var="FEAT_enable-rules-under-take"-->&quot;</A>
6881 is set, the behavior of the Take command is altered slightly.
6882
6883 <P>
6884 &lt;End of help on this topic&gt;
6885 </BODY>
6886 </HTML>
6887 ======= h_ge_import =======
6888 <HTML>
6889 <HEAD>
6890 <TITLE>Import File Selection</TITLE>
6891 </HEAD>
6892 <BODY>
6893 <H1>Import File Selection</H1>
6894
6895 You are importing a file that you previously
6896 exported from Alpine.
6897 You are now being asked for the name of that file.
6898 The easiest way to select a file is probably with the &quot;^T&quot;
6899 &quot;To Files&quot; command.
6900 Alternatively, you may type in a file name.
6901 It may be an absolute pathname.
6902 Otherwise, it is a file located in your home directory
6903 or current working directory
6904 <!--chtml if pinemode="running"-->
6905 (which, at least for your current Alpine &quot;session,&quot;
6906 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
6907 <!--chtml endif-->, depending on the
6908 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A> option.
6909 In any case, you finish by typing a carriage return to accept the
6910 file name that is displayed.
6911 When the feature
6912 <A HREF="h_config_enable_tab_complete">&quot;<!--#echo var="FEAT_enable-tab-completion"-->&quot;</A>
6913 is turned on you may use TAB to complete partially typed in names.
6914 <P>
6915 You may cancel the import operation by typing &quot;^C&quot; after exiting
6916 this help.
6917 <P>
6918 &lt;End of help on this topic&gt;
6919 </BODY>
6920 </HTML>
6921 ======= h_ge_allparts =======
6922 <HTML>
6923 <HEAD>
6924 <TITLE>Export Message File Selection</TITLE>
6925 </HEAD>
6926 <BODY>
6927 <H1>Export Message File Selection</H1>
6928
6929 You are Exporting a message from an Alpine mail folder
6930 to a plain text file.
6931 You also have the option of exporting all of the attachments associated
6932 with the message.
6933 You are now being asked for the name of the file to export <EM>to</EM>.
6934 The easiest way to select a file is probably with the &quot;^T&quot;
6935 &quot;To Files&quot; subcommand.
6936 After returning from that subcommand you will still be allowed to
6937 edit the name you have selected.
6938 Alternatively, you may type in a file name.
6939 It may be an absolute pathname.
6940 Otherwise, it is a file located in your home directory
6941 or current working directory
6942 <!--chtml if pinemode="running"-->
6943 (which, at least for your current Alpine &quot;session,&quot;
6944 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
6945 <!--chtml endif-->, depending on the
6946 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A> option.
6947 In any case, you finish by typing a carriage return to accept the
6948 file name that is displayed.
6949 When the feature
6950 <A HREF="h_config_enable_tab_complete">&quot;<!--#echo var="FEAT_enable-tab-completion"-->&quot;</A>
6951 is turned on you may use TAB to complete partially typed in names.
6952 <P>
6953 The message you are exporting appears to have some attachments.
6954 If you wish to save <EM>all</EM> of the attachments at once,
6955 type the &quot;^P&quot; &quot;AllParts&quot; command to turn on
6956 saving of the attachments.
6957 You may turn it back off by typing &quot;^P&quot; again, which will now
6958 be labeled &quot;NoAllParts&quot; instead.
6959 If you want to save the parts the command displayed should be
6960 &quot;NoAllParts&quot;!
6961 When you choose to save attachments like this, the attachments will be saved
6962 in a newly created directory.
6963 That directory will have the same name as the file name you choose here,
6964 with the letters &quot;.d&quot; appended.
6965 If that directory already exists, then the letters &quot;.d_1&quot; will
6966 be tried, then &quot;.d_2&quot; and so on until a name that doesn't exist
6967 is found.
6968 For example, if you select the file name
6969 <P>
6970 <CENTER><SAMP>filename</SAMP></CENTER>
6971 <P>
6972 to export the message to, then the directory used for the attachments will be
6973 <P>
6974 <CENTER><SAMP>filename.d</SAMP></CENTER>
6975 <P>
6976 or perhaps
6977 <P>
6978 <CENTER><SAMP>filename.d_&lt;n&gt;</SAMP></CENTER>
6979 <P>
6980 The attachments will then be put into files inside that directory.
6981 The names for the attachment files will be derived from the attachments
6982 if possible.
6983 This is done in the same way as the default values are derived if you
6984 save them one at a time.
6985 (The &quot;filename&quot; parameter from the Content-Disposition header
6986 is the first choice. If that doesn't exist, the &quot;name&quot;
6987 parameter from the Content-Type header is used.)
6988 If a name for a particular attachment is not available, then the
6989 part number of the attachment is used, with the characters &quot;part_&quot;
6990 prepended.
6991 An example of that would be
6992 <P>
6993 <CENTER><SAMP>part_2.1</SAMP></CENTER>
6994 <P>
6995 If you want to save only some of the attachments or if you want more control
6996 over the directory and filename where an attachment is saved you may
6997 cancel out of this command and View the attachment list.
6998 From there you can save each attachment individually.
6999 <P>
7000 You may cancel the Export operation by typing &quot;^C&quot; after exiting
7001 this help.
7002 <P>
7003 &lt;End of help on this topic&gt;
7004 </BODY>
7005 </HTML>
7006 ======= h_ge_export =======
7007 <HTML>
7008 <HEAD>
7009 <TITLE>Export File Selection</TITLE>
7010 </HEAD>
7011 <BODY>
7012 <H1>Export File Selection</H1>
7013
7014 You are Exporting or Saving something from within the Alpine world
7015 (a message, an attachment, etc.)
7016 to a plain text file.
7017 You are now being asked for the name of the file to export <EM>to</EM>.
7018 The easiest way to select a file is probably with the &quot;^T&quot;
7019 &quot;To Files&quot; subcommand.
7020 After returning from that subcommand you will still be allowed to
7021 edit the name you have selected.
7022 Alternatively, you may type in a file name.
7023 It may be an absolute pathname.
7024 Otherwise, it is a file located in your home directory
7025 or current working directory
7026 <!--chtml if pinemode="running"-->
7027 (which, at least for your current Alpine &quot;session,&quot;
7028 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
7029 <!--chtml endif-->, depending on the
7030 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A> option.
7031 In any case, you finish by typing a carriage return to accept the
7032 file name that is displayed.
7033 When the feature
7034 <A HREF="h_config_enable_tab_complete">&quot;<!--#echo var="FEAT_enable-tab-completion"-->&quot;</A>
7035 is turned on you may use TAB to complete partially typed in names.
7036 <P>
7037 If the object you are exporting is a message with some attachments,
7038 you may wish to save all of the attachments by typing the &quot;^P&quot;
7039 &quot;AllParts&quot; command to turn on saving of the attachments.
7040 This subcommand will only be visible if the message actually has attachments.
7041 You may also View the attachment list and save individual attachments from
7042 there.
7043 <P>
7044 If you are SAVING a text part (text/plain, text/html, etc.) you can use
7045 the Control-R subcommand to toggle if saving will be done in binary mode,
7046 meaning that the attachment will be decoded, but will not be transformed
7047 to UTF-8 for further processing (either in internal filters, or user
7048 supplied filters.) This is useful in case you either want to preserve
7049 the text as it was encoded originally to you, or the attachment was
7050 incorrectly attached (the attachment is not of text type) and you need
7051 the original text to process the attachment.
7052 <P>
7053 You may cancel the Export operation by typing &quot;^C&quot; after exiting
7054 this help.
7055 <P>
7056 &lt;End of help on this topic&gt;
7057 </BODY>
7058 </HTML>
7059 ======= h_common_save =======
7060 <HTML>
7061 <HEAD>
7062 <TITLE>Save and Export Commands</TITLE>
7063 </HEAD>
7064 <BODY>
7065 <H1>Save and Export Commands</H1>
7066
7067 Save
7068 (<!--chtml if pinemode="function_key"-->F11<!--chtml else-->S<!--chtml endif-->)
7069 and Export
7070 (<!--chtml if pinemode="function_key"-->F12<!--chtml else-->E<!--chtml endif-->)
7071 are the two alternatives Alpine gives you to keep a copy of the message
7072 you are reading. If you want to keep the message within Alpine's email
7073 world, use &quot;Save&quot;; if you want to use the message in another
7074 program, use &quot;Export&quot;.
7075 <P>
7076
7077 When you Save a message, it is put into an existing folder or into a new
7078 folder in one of your existing folder collections.  The message stays in
7079 email format and can be read by Alpine again.  Alpine may use a special format
7080 for its mail folders -- never edit an Alpine folder by hand or with any
7081 program other than Alpine.  The exact behavior of the Save command can be
7082 configured with the
7083 <A HREF="h_config_quote_all_froms">&quot;<!--#echo var="FEAT_save-will-quote-leading-froms"-->&quot;</A>,
7084 <A HREF="h_config_save_wont_delete">&quot;<!--#echo var="FEAT_save-will-not-delete"-->&quot;</A>,
7085 and
7086 <A HREF="h_config_save_advances">&quot;<!--#echo var="FEAT_save-will-advance"-->&quot;</A>
7087 feature list settings.
7088 The name of the folder offered as a default is controlled by the option
7089 <A HREF="h_config_saved_msg_name_rule">&quot;<!--#echo var="VAR_saved-msg-name-rule"-->&quot;</A>.
7090 <P>
7091
7092 When you use Export, the message is placed in a plain text file in your
7093 home directory
7094 <!--chtml if pinemode="running"-->
7095 (which, in the present configuration of your system, is
7096  &quot;<!--#echo var="HOME_DIR"-->&quot;)
7097 <!--chtml endif-->
7098 or current working directory
7099 <!--chtml if pinemode="running"-->
7100 (which, at least for your current Alpine &quot;session,&quot;
7101 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
7102 <!--chtml endif-->, depending on the
7103 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
7104 configuration setting.  In the normal case, only minimal
7105 headers are exported with the message; however, if the full header mode
7106 (whose availability may be disabled  by setting the feature
7107 <A HREF="h_config_enable_full_hdr">&quot;<!--#echo var="FEAT_enable-full-header-cmd"-->&quot;</A>
7108 in SETUP CONFIGURATION) is
7109 toggled on, then complete headers are exported along with the message
7110 text. (If you have any <A HREF="h_config_display_filters"><!--#echo var="VAR_display-filters"--></A>
7111 defined, they may affect the contents of the exported file.)
7112
7113 <P>
7114 &lt;End of help on this topic&gt;
7115 </BODY>
7116 </HTML>
7117 ======= h_common_bounce =======
7118 <HTML>
7119 <HEAD>
7120 <TITLE>Bounce Command</TITLE>
7121 </HEAD>
7122 <BODY>
7123 <H1>Bounce Command</H1>
7124
7125 The Bounce
7126 (<!--chtml if pinemode="function_key"-->F10<!--chtml else-->B<!--chtml endif-->)
7127 command allows you to re-send, or &quot;remail&quot;, a
7128 message, as if you were never in the loop.  It is analogous to crossing
7129 out your address on a postal letter, writing a different address on the
7130 envelope, and putting it into the mailbox. Bounce is used primarily to
7131 redirect email that was sent to you in error.
7132 Also, some owners of email
7133 lists need the bounce command to handle list traffic.
7134 Bounce is not anonymous.
7135 A ReSent-From header is added to the message so that the recipient may
7136 tell that you Bounced it to them.
7137 <P>
7138
7139 The presence or absence of the Bounce command is determined by the
7140 <A HREF="h_config_enable_bounce">&quot;<!--#echo var="FEAT_enable-bounce-cmd"-->&quot;</A>
7141 feature in your Alpine configuration.
7142 The feature
7143 <A HREF="h_config_fcc_on_bounce">&quot;<!--#echo var="FEAT_fcc-on-bounce"-->&quot;</A>
7144 affects the behavior of the Bounce command.
7145 Also, it is possible that Bounce could be
7146 administratively disabled by your system manager; if it doesn't work,
7147 please check with your local help desk before reporting a bug.
7148
7149 <P>
7150 &lt;End of help on this topic&gt;
7151 </BODY>
7152 </HTML>
7153 ======= h_common_reply =======
7154 <HTML>
7155 <HEAD>
7156 <TITLE>Reply and Forward Commands</TITLE>
7157 </HEAD>
7158 <BODY>
7159
7160 <H1>Reply and Forward Commands</H1>
7161
7162 Replying
7163 (<!--chtml if pinemode="function_key"-->F11<!--chtml else-->R<!--chtml endif-->)
7164 and Forwarding
7165 (<!--chtml if pinemode="function_key"-->F12<!--chtml else-->F<!--chtml endif-->)
7166 are your two alternatives for following up on the
7167 message you are reading.  You would use reply if you want to get email
7168 back to the author of the message and/or the other people who have
7169 already seen it.  You use forward if you want somebody new to see the
7170 message.
7171 <P>
7172
7173 In the normal case, the only thing that you must supply when forwarding a
7174 message is the name/email address of the new recipient.
7175 Alpine will include the text of the forwarded message.
7176 Alpine will also include any attachments to the message.
7177 There is space above the forwarded text for you to include additional comments.
7178 <P>
7179
7180 When replying, you usually have to answer some questions.
7181 If the message is to multiple people and/or specified with a Reply-To: header,
7182 then you will have to decide who should get the reply.
7183 You also need to decide whether or not to include the previous
7184 message in your reply.
7185 Some of this is configurable.
7186 Specifically, see the
7187 <A HREF="h_config_include_header">&quot;<!--#echo var="FEAT_include-header-in-reply"-->&quot;</A>,
7188 <A HREF="h_config_auto_include_reply">&quot;<!--#echo var="FEAT_include-text-in-reply"-->&quot;</A>,
7189 <A HREF="h_config_attach_in_reply">&quot;<!--#echo var="FEAT_include-attachments-in-reply"-->&quot;</A>,
7190 and
7191 <A HREF="h_config_auto_reply_to">&quot;<!--#echo var="FEAT_reply-always-uses-reply-to"-->&quot;</A>
7192 configuration features.
7193 <P>
7194
7195 Both the Reply and Forward commands react to the full header mode toggle.
7196 If the full header mode is on, then all the header and delivery lines are
7197 included with the text of the message in your reply/forward.
7198 <P>
7199
7200 Other configuration features that affect the Reply command are
7201 <A HREF="h_config_sig_at_bottom">&quot;<!--#echo var="FEAT_signature-at-bottom"-->&quot;</A>,
7202 <A HREF="h_config_sigdashes">&quot;<!--#echo var="FEAT_enable-sigdashes"-->&quot;</A>, and
7203 <A HREF="h_config_strip_sigdashes">&quot;<!--#echo var="FEAT_strip-from-sigdashes-on-reply"-->&quot;</A>.
7204
7205 <P>
7206 &lt;End of help on this topic&gt;
7207 </BODY>
7208 </HTML>
7209 ======= h_common_delete =======
7210 <HTML>
7211 <HEAD>
7212 <TITLE>Delete and Undelete Commands</TITLE>
7213 </HEAD>
7214 <BODY>
7215 <H1>Delete and Undelete Commands</H1>
7216
7217 Delete
7218 (<!--chtml if pinemode="function_key"-->F9<!--chtml else-->D<!--chtml endif-->)
7219 and Undelete
7220 (<!--chtml if pinemode="function_key"-->F10<!--chtml else-->U<!--chtml endif-->)
7221 allow you to change the Deleted flag for the current message.
7222 Delete marks a message Deleted (turns on the Deleted flag) and Undelete
7223 removes the mark.
7224 In the MESSAGE INDEX, deleted messages have a &quot;D&quot; in the status field
7225 at the left hand edge of the index line.
7226 When viewing a deleted message, the letters &quot;DEL&quot; will be present
7227 in the upper right hand corner of the screen.
7228 Delete simply <EM>marks</EM> a message Deleted, it does not actually
7229 get rid of the message.
7230 The eXpunge command (available from the MESSAGE INDEX screen) actually
7231 removes all of the deleted messages in a folder.
7232 Once a message is eXpunged, it can't be retrieved.
7233 <P>
7234
7235 The Delete command is affected by the setting of the configuration feature
7236 <A HREF="h_config_del_skips_del">&quot;<!--#echo var="FEAT_delete-skips-deleted"-->&quot;</A>.
7237
7238 <P>
7239 &lt;End of help on this topic&gt;
7240 </BODY>
7241 </HTML>
7242 ======= h_common_postpone =======
7243 <HTML>
7244 <HEAD>
7245 <TITLE>Postpone Command</TITLE>
7246 </HEAD>
7247 <BODY>
7248 <H1>Postpone Command</H1>
7249
7250 The postpone
7251 <!--chtml if pinemode="function_key"-->(F11)<!--chtml else-->(^O)<!--chtml endif-->
7252 command allows you to temporarily stop working on the current
7253 message so you may read
7254 other messages or compose another message.  When you want to resume a
7255 message later, start to compose and answer &quot;yes&quot; to the
7256 &quot;Continue postponed composition?&quot; question.  You may
7257 postpone as many messages as you like.
7258
7259 <P>
7260 Note: If a <A HREF="h_config_form_folder"><!--#echo var="VAR_form-letter-folder"--></A> is defined
7261 in the Setup/Config screen, then the Postpone command will prompt you for
7262 the folder in which to store your outgoing message.
7263
7264 <P>
7265 &lt;End of help on this topic&gt;
7266 </BODY>
7267 </HTML>
7268 ======= h_compose_cancel =======
7269 <HTML>
7270 <HEAD>
7271 <TITLE>Cancel Command</TITLE>
7272 </HEAD>
7273 <BODY>
7274 <H1>Cancel Command</H1>
7275
7276 Cancel
7277 <!--chtml if pinemode="function_key"-->
7278 (F2)
7279 <!--chtml else-->
7280 (^C)
7281 <!--chtml endif-->
7282
7283 The Cancel command returns you to Alpine's normal mail processing and
7284 causes the message currently under composition to be thrown out.
7285 The message text <EM>will be lost</EM>.
7286
7287 <P>
7288 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
7289 will be preserved in the file named
7290 <!--chtml if pinemode="os_windows"-->
7291 &quot;DEADLETR&quot;.
7292 <!--chtml else-->
7293 &quot;dead.letter&quot; in your home directory.
7294 <!--chtml endif-->
7295 If you unintentionally cancel a message, look there for its text.
7296
7297 <P>
7298 &lt;End of help on this topic&gt;
7299 </BODY>
7300 </HTML>
7301 ======= h_compose_addrcomplete =======
7302 <HTML>
7303 <HEAD>
7304 <TITLE>Address Completion</TITLE>
7305 </HEAD>
7306 <BODY>
7307 <H1>Address Completion</H1>
7308
7309 When entering addresses in the address fields of the composer (To, Cc, etc.)
7310 the TAB key may be used to help complete the address.
7311 Type a partial nickname and tap the TAB key to complete the typing.
7312 The unambiguous part of the name will be filled in automatically.
7313 Typing TAB twice in succession will bring up a selection list of possibilities,
7314 making it easy to find and choose the correct address.
7315
7316 <P>
7317 The matching algorithm is rather ad hoc.
7318 The search starts with a search of your address book.
7319 It counts as a match if the nickname, address, or fullname field of an
7320 entry begins with the text typed in so far. It is also a match if
7321 a later word in the fullname (for example, the middle name or last name)
7322 begins with the entered text.
7323 <P>
7324 Next comes an LDAP search.
7325 The search will happen for any servers that have the
7326 <A HREF="h_config_ldap_opts_impl">&quot;Use-Implicitly-From-Composer&quot;</A>
7327 feature set. You can set or unset the feature for each server independently
7328 in the Setup/Directory screen.
7329 <P>
7330 Finally, if you are replying to or forwarding a message, that message is
7331 searched for likely candidate addresses that match the typed-in text.
7332
7333 <P>
7334 &lt;End of help on this topic&gt;
7335 </BODY>
7336 </HTML>
7337 ======= h_compose_richhdr =======
7338 <HTML>
7339 <HEAD>
7340 <TITLE>Rich Header Command</TITLE>
7341 </HEAD>
7342 <BODY>
7343 <H1>Rich Header Command</H1>
7344
7345 The Rich Header command allows you to toggle between the list of
7346 all message headers available for editing and those that are most
7347 common.
7348
7349 <P>
7350 Use this toggle to expose headers that are not normally visible by
7351 default.
7352 This set usually includes the
7353 &quot;Bcc:&quot;,
7354 &quot;Fcc:&quot;,
7355 &quot;Lcc:&quot;,
7356 and &quot;Newsgroups&quot;
7357 headers.
7358 If you are posting to a newsgroup the set of defaults is a little different.
7359 Obviously, in that case, the Newsgroups header is of interest so is not
7360 hidden.
7361 For news posting the hidden set includes the
7362 &quot;To:&quot;,
7363 &quot;Cc:&quot;,
7364 &quot;Bcc:&quot;,
7365 &quot;Fcc:&quot;,
7366 and &quot;Lcc:&quot;
7367 headers.
7368 You won't normally want to edit these, which is why they are hidden,
7369 but it is sometimes useful to be able to set them manually.
7370
7371 <P>
7372 The default sets of headers listed above can be altered.
7373 Any header that you have added to the
7374 <A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A>
7375 option, but not to the
7376 <A HREF="h_config_comp_hdrs"><!--#echo var="VAR_default-composer-hdrs"--></A>
7377 option will appear when you use the Rich Headers command to
7378 make the Rich Headers visible.
7379 (Headers listed in the <!--#echo var="VAR_default-composer-hdrs"--> list will be visible
7380 even without toggling the Rich Headers command.)
7381
7382 <P>
7383 &lt;End of help on this topic&gt;
7384 </BODY>
7385 </HTML>
7386 ======= h_compose_send =======
7387 <HTML>
7388 <HEAD>
7389 <TITLE>Send Command</TITLE>
7390 </HEAD>
7391 <BODY>
7392 <H1>Send Command</H1>
7393
7394 The Send command
7395 <!--chtml if pinemode="function_key"-->
7396 (F3)
7397 <!--chtml else-->
7398 (^X)
7399 <!--chtml endif-->
7400 tells Alpine you are finished composing.
7401 Before actually sending it, though, Alpine will ask you to confirm
7402 your intention, and, at the same time, redisplayed the message text
7403 with the recipients at the top of the screen to give you the opportunity
7404 to review and verify that the message is addressed to the people
7405 you intended.
7406 <P>
7407 If the feature
7408 <A HREF="h_config_send_wo_confirm">&quot;<!--#echo var="FEAT_send-without-confirm"-->&quot;</A> is set,
7409 then this confirmation prompt and any options it allows are skipped.
7410
7411 <P>
7412 This confirmation prompt may also offer, depending
7413 on your particular Setup/Config, options allowing you to set
7414 <A HREF="h_config_compose_dsn">delivery status notifications</A>,
7415 include attachments in the &quot;Fcc&quot; (if you had previously
7416 specified that they <A HREF="h_config_no_fcc_attach">exclude attachments</A>,
7417 observe details of the
7418 <A HREF="h_config_verbose_post">message submission process</A>,
7419 choose the filter through which the
7420 <A HREF="h_config_sending_filter">outgoing text should first pass</A>,
7421 or turn of flowed text generation.
7422
7423 <P>
7424 &lt;End of help on this topic&gt;
7425 </BODY>
7426 </HTML>
7427 ======= h_compose_markcutpaste =======
7428 <HTML>
7429 <HEAD>
7430 <TITLE>Mark, Cut and Paste Commands</TITLE>
7431 </HEAD>
7432 <BODY>
7433 <H1>Mark, Cut and Paste Commands</H1>
7434
7435 You can define a &quot;block&quot; of text, which can subsequently
7436  be deleted or
7437 copied as a unit, by setting a mark at the start of the block (Ctrl-^) and
7438 then moving the cursor to the end of the desired text block.  You can then
7439 &quot;cut&quot; the block out
7440 <!--chtml if pinemode="function_key"-->
7441 &quot;F9&quot;,
7442 <!--chtml else-->
7443 &quot;Ctrl-K&quot;,
7444 <!--chtml endif-->
7445 move the cursor, and &quot;paste&quot; it
7446 <!--chtml if pinemode="function_key"-->
7447 &quot;F10&quot;,
7448 <!--chtml else-->
7449 &quot;Ctrl-U&quot;,
7450 <!--chtml endif-->
7451 in the new location.  Also, you can paste more than once, allowing you
7452 to use this feature to copy a block of text.<P>
7453
7454 If you press
7455 <!--chtml if pinemode="function_key"-->
7456 &quot;F9&quot;
7457 <!--chtml else-->
7458 &quot;^K&quot;
7459 <!--chtml endif-->
7460 without having marked anything, Alpine will delete
7461 a single line.  If you delete a group of lines together, Alpine keeps them
7462 in the same buffer, so
7463 <!--chtml if pinemode="function_key"-->
7464 F10
7465 <!--chtml else-->
7466 ^U
7467 <!--chtml endif-->
7468 will restore them as a block.  About
7469 terminology:  Mark is shown as &quot;^^&quot;.  The first &quot;^&quot; means you should
7470 hold down the &quot;Control&quot; key on your keyboard.  The second &quot;^&quot; means
7471 &quot;type the character ^&quot;.
7472
7473 <P>
7474 &lt;End of help on this topic&gt;
7475 </BODY>
7476 </HTML>
7477 ======= h_compose_justify =======
7478 <HTML>
7479 <HEAD>
7480 <TITLE>Justify Command</TITLE>
7481 </HEAD>
7482 <BODY>
7483 <H1>Justify Command</H1>
7484
7485 The Justify
7486 <!--chtml if pinemode="function_key"-->
7487 (F4)
7488 <!--chtml else-->
7489 (^J)
7490 <!--chtml endif-->
7491 command reformats the text in the paragraph the cursor is in.
7492 Paragraphs are separated by one blank line or a line beginning with a space.
7493 This is useful when you have been editing a paragraph and the lines become
7494 uneven.  The text is left aligned or justified and the right is ragged.  If
7495 the text is already justified as typed with auto-wrap, no justification will
7496 be done.
7497
7498 <P>
7499 If you have set a <A HREF="h_compose_markcutpaste">mark</A> to select a
7500 block of text, the Justify command is modified.
7501 Instead of automatically justifying the current paragraph you will be
7502 asked if you want to justify the paragraph, justify the selected region,
7503 or adjust the quote level of the selected region.
7504 Adjusting the quote level only works if you are using standard
7505 &quot;&gt;&nbsp;&quot; or &quot;&gt;&quot; quotes, which is the default if you haven't
7506 changed &quot;<A HREF="h_config_reply_indent_string"><!--#echo var="VAR_reply-indent-string"--></A>&quot;.
7507
7508 <P>
7509 When composing a reply containing included text, the justify command
7510 will reformat text to the right of the
7511 &quot;<A HREF="h_config_reply_indent_string"><!--#echo var="VAR_reply-indent-string"--></A>&quot;,
7512 adding or removing indented lines as needed.  Paragraphs are separated
7513 by a blank line, a line containing only the <!--#echo var="VAR_reply-indent-string"-->, or a
7514 line containing the indent string and one or more blank spaces.
7515 Included text that was previously indented (or &quot;quoted&quot;) is
7516 not preserved.
7517
7518 <P>
7519 Because of the introduction of <A HREF="h_config_quell_flowed_text">Flowed Text</A>
7520 in 1999 and its wide-spread adoption since then, you will usually be better off if you
7521 use the standard
7522 &quot;&gt;&nbsp;&quot; or &quot;&gt;&quot; quotes.
7523
7524 <P>
7525 &lt;End of help on this topic&gt;
7526 </BODY>
7527 </HTML>
7528 ======= h_compose_spell =======
7529 <HTML>
7530 <HEAD>
7531 <TITLE>Spell Check Command</TITLE>
7532 </HEAD>
7533 <BODY>
7534 <H1>Spell Check Command</H1>
7535
7536 The &quot;To Spell&quot;
7537 <!--chtml if pinemode="function_key"-->
7538 (F12)
7539 <!--chtml else-->
7540 (^T)
7541 <!--chtml endif-->
7542 command calls an external spell checking program to look over the
7543 message you are composing.  By default, Alpine uses
7544 <P>
7545 <CENTER><SAMP>aspell --dont-backup --mode=email check</SAMP></CENTER>
7546 <P>
7547 if it knows where to find &quot;aspell&quot;.
7548 If there is no &quot;aspell&quot; command available but the command &quot;ispell&quot; is available
7549 then the command used is
7550 <P>
7551 <CENTER><SAMP>ispell -l</SAMP></CENTER>
7552 <P>
7553 Otherwise, the ancient &quot;spell&quot; command is used.
7554 <P>
7555 For PC-Alpine, you must install the aspell library code that you
7556 may get from
7557 <A HREF="http://aspell.net/win32/">http://aspell.net/win32/</A>.
7558
7559 <P>
7560 &lt;End of help on this topic&gt;
7561 </BODY>
7562 </HTML>
7563 ======= h_compose_alted =======
7564 <HTML>
7565 <HEAD>
7566 <TITLE>Alt Editor Command</TITLE>
7567 </HEAD>
7568 <BODY>
7569 <H1>Alt Editor Command</H1>
7570
7571 The &quot;Alt Editor&quot; command's availability depends on the
7572 Setup/Config variable &quot;<A HREF="h_config_editor"><!--#echo var="VAR_editor"--></A>&quot;.
7573
7574 <P>
7575 When the variable specifies a valid editor on your system, this
7576 command will launch it with the current text of your message
7577 already filled in.
7578
7579 <P>
7580 &lt;End of help on this topic&gt;
7581 </BODY>
7582 </HTML>
7583 ======= h_compose_readfile =======
7584 <HTML>
7585 <HEAD>
7586 <TITLE>Read File Command</TITLE>
7587 </HEAD>
7588 <BODY>
7589 <H1>Read File Command</H1>
7590
7591 The &quot;Read File&quot;
7592 <!--chtml if pinemode="function_key"-->
7593 (F5)
7594 <!--chtml else-->
7595 (^R)
7596 <!--chtml endif-->
7597 command allows you to copy in text from an existing file. You will be
7598 prompted for the name of a file to be inserted into the message.  The file
7599 name is relative to your home directory
7600 <!--chtml if pinemode="running"-->
7601 (which, in the present configuration of your system, is
7602  &quot;<!--#echo var="HOME_DIR"-->&quot;)
7603 <!--chtml endif-->
7604 or current working directory
7605 <!--chtml if pinemode="running"-->
7606 (which, at least for your current Alpine &quot;session,&quot;
7607 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
7608 <!--chtml endif-->, depending on the
7609 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
7610 configuration setting; or, the file name must be specified as a full path name
7611 <!--chtml if pinemode="os_windows"-->
7612 -- for example: &quot;A:&#92;PAPER.TXT&quot;
7613 <!--chtml else-->
7614 -- for example: &quot;/tmp/wisdom-of-the-day&quot;
7615 <!--chtml endif-->
7616 (without the quotation marks).
7617
7618 <P>
7619 The file will be inserted where the cursor is located.  <B>The
7620 file to be read must be on the same system as Alpine.</B> If you use Alpine on a
7621 Unix machine but have files on a PC or Mac, the files must be transferred
7622 to the system Alpine is running on before they can be read.  Please ask your
7623 local computer support people about the correct way to transfer a file to
7624 your Alpine system.
7625
7626 <P>
7627 &lt;End of help on this topic&gt;
7628 </BODY>
7629 </HTML>
7630 ======= h_config_tray_icon =======
7631 <HTML>
7632 <HEAD>
7633 <TITLE>FEATURE: <!--#echo var="FEAT_enable-tray-icon"--></TITLE>
7634 </HEAD>
7635 <BODY>
7636 <H1>FEATURE: <!--#echo var="FEAT_enable-tray-icon"--></H1>
7637
7638 PC-Alpine only.
7639 <P>
7640 This option restores a behavior of previous versions of PC-Alpine.
7641 These
7642 versions, when started, installed a PC-Alpine icon in the notification
7643 tray of Window's Taskbar.  The primary use of this icon was to indicate
7644 new mail arrival by turning red (while the Taskbar icon remained green).
7645 Additionally, the icon now changes to yellow to signify that a mail folder
7646 has been closed unexpectedly.
7647
7648 <P>
7649 Rather than add another icon to the Taskbar, this version of PC-Alpine will
7650 color its Taskbar entry's icon red (as well as the icon in the Window
7651 Title).  This feature is only provided for backwards compatibility.
7652
7653 <P>
7654 &lt;End of help on this topic&gt;
7655 </BODY>
7656 </HTML>
7657 ======= h_common_suspend =======
7658 <HTML>
7659 <HEAD>
7660 <TITLE>Suspend Command</TITLE>
7661 </HEAD>
7662 <BODY>
7663 <H1>Suspend Command</H1>
7664
7665 With the <A HREF="h_config_can_suspend"><!--#echo var="FEAT_enable-suspend"--></A> feature
7666 enabled, you can, at almost any time, temporarily halt your Alpine session,
7667 <!--chtml if pinemode="os_windows"-->
7668 minimizing it into an icon.
7669 <!--chtml else-->
7670 and return to your system prompt.
7671 <!--chtml endif-->
7672
7673 <P>
7674 &lt;End of help on this topic&gt;
7675 </BODY>
7676 </HTML>
7677 ======= h_pipe_command =======
7678 <HTML>
7679 <HEAD>
7680 <TITLE>Pipe Command SubOptions</TITLE>
7681 </HEAD>
7682 <BODY>
7683 <H1>Pipe Command SubOptions</H1>
7684
7685 By default, when you use the Pipe command, the processed text of the
7686 message is sent to the Unix command
7687 you specify and the output is captured by Alpine and shown to you.
7688 (This command is available in PC-Alpine, as well, but there aren't many
7689 Windows commands that work well with piping.)
7690 There are some sub-commands that may be used to alter this behavior.
7691 These are toggles that switch the behavior between two possibilities.
7692 They can be combined in any way you wish.
7693 <P>
7694 By default, the prompt at the bottom of the screen looks like
7695 <P>
7696 <CENTER><SAMP>Pipe message 37 to :</SAMP></CENTER>
7697 <P>
7698 or
7699 <P>
7700 <CENTER><SAMP>Pipe messages to :</SAMP></CENTER>
7701 <P>
7702 if you are piping more than one message.
7703 <P>
7704 The sub-command options are:
7705 <DL>
7706    <DT>Shown Text or Raw Text</DT>
7707    <DD>This option toggles between sending the shown (processed) text
7708 of the message to the Unix command, and sending the
7709 raw (unprocessed) text of the message to the Unix command.
7710 The default is to send the shown text.
7711 The raw version of the message will contain all of the headers and any
7712 MIME encoding that the message contains.
7713 If you've selected the Raw Text then the prompt will have the additional word
7714 &quot;RAW&quot; in it, like
7715 <P>
7716 <CENTER><SAMP>Pipe RAW messages to :</SAMP></CENTER>
7717 <P>
7718 You can experiment with this option by piping to something simple like the
7719 Unix &quot;cat&quot; command.
7720    </DD>
7721    <DT>Captured Output or Free Output</DT>
7722    <DD>This option toggles between having Alpine capture the output of
7723 the Unix pipe command for display, and not capturing it.
7724 If the command you are piping to is a filter that will produce output
7725 you want to view, then you want to capture that output
7726 for display (the default).
7727 If the Unix command doesn't produce output or handles the display itself,
7728 then you want free output.
7729 When you've selected the Free Output option the prompt will change to
7730 <P>
7731 <CENTER><SAMP>Pipe messages to (uncaptured) :</SAMP></CENTER>
7732 <P>
7733    </DD>
7734    <DT>No Delimiter or With Delimiter</DT>
7735    <DD>This option controls whether or not a Unix mailbox style delimiter
7736 will come before the text of the message.
7737 This is the delimiter used in the common Unix mailbox format.
7738 It's the single line that begins with the five characters
7739 &quot;From&quot; followed by a &lt;SPACE&gt; character.
7740 You'll usually only want to include this if the Unix command requires
7741 input in the format of a traditional Unix mailbox file.
7742 When you've selected the With Delimiter option the prompt will change to
7743 <P>
7744 <CENTER><SAMP>Pipe messages to (delimited) :</SAMP></CENTER>
7745 <P>
7746    </DD>
7747    <DT>To Same Pipe or To Individual Pipes</DT>
7748    <DD>This option only shows up if you are running an aggregate
7749 pipe command.
7750 That is, the command was Apply Pipe, not just Pipe.
7751 You have the option of piping all of the selected messages through a
7752 single pipe to a single instance of the Unix command,
7753 or piping each individual message through a separate pipe to separate
7754 instances of the Unix command.
7755 The default is that all of the output will go through a single pipe
7756 to a single instance of the command.
7757 You can try this option with a command like &quot;less&quot;, with Free
7758 Output enabled.
7759 When you've selected the Individual Pipes option the prompt will change to
7760 <P>
7761 <CENTER><SAMP>Pipe messages to (new pipe) :</SAMP></CENTER>
7762 <P>
7763    </DD>
7764 </DL>
7765
7766 <P>
7767 As mentioned earlier, the options can be combined in any way you wish.
7768 You may leave them all off, turn them all on, or turn some of them on
7769 and some of them off.
7770 If you use the pipe command a second time in the same session the default
7771 options will be what you used the last time.
7772
7773 <P>
7774 &lt;End of help on this topic&gt;
7775 </BODY>
7776 </HTML>
7777 ========== h_emptydir_subfolder_name =========
7778 <HTML>
7779 <HEAD>
7780 <TITLE>ENTER SUBFOLDER NAME</TITLE>
7781 </HEAD>
7782 <BODY>
7783 <H1>Enter Subfolder Name</H1>
7784
7785 <P>
7786 This is the name of a new subfolder in the directory you are creating.
7787 Because empty directories are hidden and therefore not useful, you must also
7788 create a subfolder in the directory you are creating in order that the
7789 directory remains visible.
7790 <P>
7791 Alternatively, you may turn off the configuration feature
7792 <A HREF="h_config_quell_empty_dirs"><!--#echo var="FEAT_quell-empty-directories"--></A>
7793 so that empty directories remain visible.
7794 If you do that, you will not be required to create the subfolder when you
7795 create a directory.
7796
7797 <P>
7798 &lt;End of help on this topic&gt;
7799 </BODY>
7800 </HTML>
7801 ========== h_incoming_add_folder_name =========
7802 <HTML>
7803 <HEAD>
7804 <TITLE>ENTER FOLDER NAME</TITLE>
7805 </HEAD>
7806 <BODY>
7807 <H1>Enter Folder Name</H1>
7808
7809 <P>
7810 This is the name of the folder on the previously specified server.
7811 By default the folder name is interpreted as defining a section of your personal
7812 folder area.  This area and how you specify it are defined by the
7813 server, if one is specified.
7814
7815 <P>
7816 To define a folder outside the default area, prefix
7817 the path with the namespace to use when interpreting the
7818 given path.  If a namespace is specified, the folder name begins with the
7819 sharp (#) character followed by the name of the namespace
7820 and then the namespace's path-element-delimiter.  Aside from the
7821 name's format, namespaces can also imply access rights, content
7822 policy, audience, location, and, occasionally, access methods.
7823
7824 <P>
7825 Each server exports its own set (possibly of size one) of
7826 namespaces.
7827 For a more detailed explanation read about
7828 <A HREF="h_folder_name_namespaces">Namespaces</A>.
7829
7830 <P>
7831 To specify the default for INBOX on the server you can usually just enter
7832 &quot;INBOX&quot;, and the server will understand the special meaning of
7833 that word.
7834
7835 <P>
7836 &lt;End of help on this topic&gt;
7837 </BODY>
7838 </HTML>
7839 ========== h_incoming_add_folder_host =========
7840 <HTML>
7841 <HEAD>
7842 <TITLE>ENTER INCOMING FOLDER SERVER</TITLE>
7843 </HEAD>
7844 <BODY>
7845 <H1>Enter Incoming Folder Server</H1>
7846
7847 You are being asked for the name of the server for use with this incoming
7848 folder.
7849 If the folder is on the machine where Alpine is running, then just enter
7850 RETURN without typing a server name.
7851
7852 <P>
7853 If the folder is on an IMAP server then type the server's name followed
7854 by RETURN.
7855 You may use the ^X command if the server is the same as the server that
7856 the INBOX is on.
7857
7858 <P>
7859 You may have to add optional extra information to the server name.
7860 For example, if the IMAP server is using a non-standard port number you
7861 would specify that by appending a colon (:) followed by the port number
7862 to the server name
7863
7864 <P>
7865 <CENTER><SAMP>foo.example.com:port</SAMP></CENTER>
7866 <P>
7867
7868 or you may need to specify a different protocol if the server is not an
7869 IMAP server. For example:
7870
7871 <P>
7872 <CENTER><SAMP>foo.example.com/pop3</SAMP></CENTER>
7873 <P>
7874
7875 for a POP server or
7876
7877 <P>
7878 <CENTER><SAMP>foo.example.com/nntp</SAMP></CENTER>
7879 <P>
7880
7881 for an NNTP news server.
7882 For an explanation of all of the possibilities, see
7883 <A HREF="h_folder_server_syntax">Server Name Syntax</A>
7884 for folders.
7885
7886 <P>
7887 There is a special command (^W) if you want to set up a folder that gets its
7888 mail from a
7889 <A HREF="h_maildrop">Mail Drop</A>.
7890 If you type that command, you will be prompted for the information for
7891 both the Mail Drop folder and the destination folder.
7892
7893 <P>
7894 &lt;End of help on this topic&gt;
7895 </BODY>
7896 </HTML>
7897 ========== h_incoming_add_inbox =========
7898 <HTML>
7899 <HEAD>
7900 <TITLE>ENTER INBOX SERVER</TITLE>
7901 </HEAD>
7902 <BODY>
7903 <H1>Enter INBOX Server</H1>
7904
7905 You are being asked for the name of the server for use with
7906 the INBOX folder.
7907 Type the server's name followed by RETURN.
7908
7909 <P>
7910 You may have to add optional extra information to the server name.
7911 For example, if the server is using a non-standard port number you
7912 would specify that by appending a colon (:) followed by the port number
7913 to the server name
7914
7915 <P>
7916 <CENTER><SAMP>foo.example.com:port</SAMP></CENTER>
7917 <P>
7918
7919 or you may need to specify a different protocol if the server is not an
7920 IMAP server. For example:
7921
7922 <P>
7923 <CENTER><SAMP>foo.example.com/pop3</SAMP></CENTER>
7924 <P>
7925
7926 for a POP server.
7927 <P>
7928
7929 For an explanation of all of the possibilities, see
7930 <A HREF="h_folder_server_syntax">Server Name Syntax</A>
7931 for folders.
7932
7933 <P>
7934 If the INBOX folder is on the machine where Alpine is running, then just enter
7935 RETURN without typing a server name.
7936
7937 <P>
7938 There is a special command (^W) if you want to set up a folder that gets its
7939 mail from a
7940 <A HREF="h_maildrop">Mail Drop</A>.
7941 If you type that command, you will be prompted for the information for
7942 both the Mail Drop folder and the destination folder, which will be used
7943 as your INBOX folder.
7944
7945 <P>
7946 &lt;End of help on this topic&gt;
7947 </BODY>
7948 </HTML>
7949 ========== h_incoming_add_maildrop_destn =========
7950 <HTML>
7951 <HEAD>
7952 <TITLE>ENTER DESTINATION SERVER</TITLE>
7953 </HEAD>
7954 <BODY>
7955 <H1>Enter Destination Server</H1>
7956
7957 You are being asked for the name of the server where the destination
7958 folder is for use with this Mail Drop incoming folder.
7959 That is, you are using a Mail Drop for this incoming folder and
7960 you've already entered
7961 the server and folder name for the Mail Drop.
7962 Now you need to enter the server for the destination folder
7963 where the mail should be copied to.
7964 Mail will come from the Mail Drop and be copied to the destination folder.
7965
7966 <P>
7967 Type the server's name followed by RETURN.
7968 If the folder is local to this computer, just type RETURN without entering
7969 a server name.
7970
7971 <P>
7972 You may have to add optional extra information to the server name.
7973 For example, if the server is using a non-standard port number you
7974 would specify that by appending a colon (:) followed by the port number
7975 to the server name
7976
7977 <P>
7978 <CENTER><SAMP>foo.example.com:port</SAMP></CENTER>
7979 <P>
7980
7981 For an explanation of all of the possibilities, see
7982 <A HREF="h_folder_server_syntax">Server Name Syntax</A>
7983 for folders.
7984
7985 <P>
7986 &lt;End of help on this topic&gt;
7987 </BODY>
7988 </HTML>
7989 ========== h_inbox_add_maildrop_destn =========
7990 <HTML>
7991 <HEAD>
7992 <TITLE>ENTER DESTINATION SERVER</TITLE>
7993 </HEAD>
7994 <BODY>
7995 <H1>Enter Destination Server</H1>
7996
7997 You are being asked for the name of the server where the destination
7998 folder is for use with your Mail Drop INBOX.
7999 That is, you are using a Mail Drop for your INBOX and you've already entered
8000 the server and folder name for the Mail Drop.
8001 Now you need to enter the server for the destination folder
8002 where the mail should be copied to.
8003 Mail will come from the Mail Drop and be copied to the destination folder.
8004
8005 <P>
8006 Type the server's name followed by RETURN.
8007 If the folder is local to this computer, just type RETURN without entering
8008 a server name.
8009
8010 <P>
8011 You may have to add optional extra information to the server name.
8012 For example, if the server is using a non-standard port number you
8013 would specify that by appending a colon (:) followed by the port number
8014 to the server name
8015
8016 <P>
8017 <CENTER><SAMP>foo.example.com:port</SAMP></CENTER>
8018 <P>
8019
8020 For an explanation of all of the possibilities, see
8021 <A HREF="h_folder_server_syntax">Server Name Syntax</A>
8022 for folders.
8023
8024 <P>
8025 &lt;End of help on this topic&gt;
8026 </BODY>
8027 </HTML>
8028 ========== h_inbox_add_maildrop =========
8029 <HTML>
8030 <HEAD>
8031 <TITLE>ENTER MAILDROP SERVER</TITLE>
8032 </HEAD>
8033 <BODY>
8034 <H1>Enter Mail Drop Server</H1>
8035
8036 You are being asked for the name of the Mail Drop server for use with
8037 your INBOX.
8038
8039 <P>
8040 Type the server's name followed by RETURN.
8041
8042 <P>
8043 You may have to add optional extra information to the server name.
8044 For example, if the server is using a non-standard port number you
8045 would specify that by appending a colon (:) followed by the port number
8046 to the server name
8047
8048 <P>
8049 <CENTER><SAMP>foo.example.com:port</SAMP></CENTER>
8050 <P>
8051
8052 or you may need to specify a different protocol if the server is not an
8053 IMAP server. For example:
8054
8055 <P>
8056 <CENTER><SAMP>foo.example.com/pop3</SAMP></CENTER>
8057 <P>
8058
8059 for a POP server or
8060
8061 <P>
8062 <CENTER><SAMP>foo.example.com/nntp</SAMP></CENTER>
8063 <P>
8064
8065 for an NNTP news server.
8066 For an explanation of all of the possibilities, see
8067 <A HREF="h_folder_server_syntax">Server Name Syntax</A>
8068 for folders.
8069
8070 <P>
8071 &lt;End of help on this topic&gt;
8072 </BODY>
8073 </HTML>
8074 ========== h_incoming_add_maildrop =========
8075 <HTML>
8076 <HEAD>
8077 <TITLE>ENTER MAILDROP SERVER</TITLE>
8078 </HEAD>
8079 <BODY>
8080 <H1>Enter Mail Drop Server</H1>
8081
8082 You are being asked for the name of the Mail Drop server for use with
8083 this incoming folder.
8084
8085 <P>
8086 Type the server's name followed by RETURN.
8087 You may use the ^X command if the server is the same as the server that
8088 the INBOX is on.
8089
8090 <P>
8091 You may have to add optional extra information to the server name.
8092 For example, if the server is using a non-standard port number you
8093 would specify that by appending a colon (:) followed by the port number
8094 to the server name
8095
8096 <P>
8097 <CENTER><SAMP>foo.example.com:port</SAMP></CENTER>
8098 <P>
8099
8100 or you may need to specify a different protocol if the server is not an
8101 IMAP server. For example:
8102
8103 <P>
8104 <CENTER><SAMP>foo.example.com/pop3</SAMP></CENTER>
8105 <P>
8106
8107 for a POP server or
8108
8109 <P>
8110 <CENTER><SAMP>foo.example.com/nntp</SAMP></CENTER>
8111 <P>
8112
8113 for an NNTP news server.
8114 For an explanation of all of the possibilities, see
8115 <A HREF="h_folder_server_syntax">Server Name Syntax</A>
8116 for folders.
8117
8118 <P>
8119 If the Mail Drop folder is on the machine where Alpine is running, then just enter
8120 RETURN without typing a server name.
8121
8122 <P>
8123 &lt;End of help on this topic&gt;
8124 </BODY>
8125 </HTML>
8126 ========== h_maildrop =========
8127 <HTML>
8128 <HEAD>
8129 <TITLE>WHAT IS A MAIL DROP?</TITLE>
8130 </HEAD>
8131 <BODY>
8132 <H1>What is a Mail Drop?</H1>
8133
8134 In some situaions it may make sense to have your mail delivered to one
8135 folder (the Mail Drop) and then when you want to read mail that has been
8136 delivered to the Mail Drop folder Alpine will move it to another
8137 destination folder.
8138 Often the Mail Drop will be a remote folder and messages will be moved from
8139 there to a local destination folder.
8140
8141 <P>
8142 One example where this might make sense is if the Mail Drop folder is accessible
8143 only with the POP protocol.
8144 You could designate your POP inbox as the Mail Drop folder and have Alpine move
8145 mail from there to a local (on the same machine Alpine is running on)
8146 destination folder, where you'll read it.
8147
8148 <P>
8149 A Mail Drop may only be used as your Inbox or as an
8150 <A HREF="h_config_enable_incoming">&quot;Incoming folder&quot;</A>.
8151
8152 <P>
8153 There is no attempt to synchronize the contents of the destination folder
8154 with the contents of the Mail Drop folder.
8155 All that happens is that all of the messages in the Mail Drop folder are
8156 copied to the destination folder and then they are deleted and expunged (if possible)
8157 from the Mail Drop folder.
8158 The next time a check for new mail is made, any messages in the Mail
8159 Drop folder are once again copied to the destination folder and deleted
8160 and expunged from the Mail Drop folder.
8161 (If the Mail Drop folder is a news group, then the messages can't be
8162 expunged from the newsgroup. Instead, only Recent messages are copied from
8163 the newsgroup to the destination folder.)
8164
8165 <P>
8166 Configuration of a Mail Drop is a little different from configuration of
8167 a folder that does not use a Mail Drop because you have to specify two
8168 folder names instead of one.
8169 The two folders may be any types of folders that Alpine can normally use.
8170 They don't have to be a remote folder and a local folder, that is
8171 simply the most common usage.
8172 When you use a Mail Drop folder Alpine will periodically re-open the Mail
8173 Drop to check for new mail.
8174 The new-mail checks will happen at the frequency set with the
8175 <A HREF="h_config_mailcheck"><!--#echo var="VAR_mail-check-interval"--></A> option,
8176 but with a minimum time
8177 (<A HREF="h_config_maildropcheck"><!--#echo var="VAR_maildrop-check-minimum"--></A>)
8178 between checks.
8179 Because of this minimum you may notice that new mail does not
8180 appear promptly when you expect it.
8181 The reason for this is to protect the server from over-zealous opening and
8182 closing of the Mail Drop folder.
8183 If the user initiates the check by typing ^L (Ctrl-L) or the Next command when at
8184 the end of the folder index, then the check will happen, regardless of how
8185 long it has been since the previous check.
8186 <P>
8187 If there is new mail, that mail will be copied to the destination folder
8188 and then will be deleted from the Mail Drop.
8189 Note that using a Mail Drop with a local destination folder does not make
8190 sense if you read mail from more than one machine, because the mail is
8191 downloaded to the destination folder (which is accessible from only one
8192 machine) and deleted from the Mail Drop.
8193 <P>
8194 The feature <A HREF="h_config_maildrops_preserve_state"><!--#echo var="FEAT_maildrops-preserve-state"--></A> modifies the operation of Mail Drops.
8195
8196 <P>
8197 The actual syntax used by Alpine for a folder that uses a Mail Drop is:
8198
8199 <P>
8200 <CENTER><SAMP>#move&lt;DELIM&gt;&lt;MailDropFolder&gt;&lt;DELIM&gt;&lt;DestinationFolder&gt;</SAMP></CENTER>
8201 <P>
8202 The brackets are not literal.
8203 <P>
8204 <CENTER><SAMP>&lt;DELIM&gt;</SAMP></CENTER>
8205 <P>
8206 is a single character that does not appear in the MailDropFolder name.
8207 If the name doesn't contain spaces then it can be a space character.
8208 The two folder names are full technical
8209 <A HREF="h_valid_folder_names">folder names</A>
8210 as used by Alpine.
8211 Here are a couple examples to give you an idea what is being talked about:
8212
8213 <P>
8214 <CENTER><SAMP>#move&nbsp;{popserver.example.com/pop3}inbox&nbsp;localfolder</SAMP></CENTER>
8215 <P>
8216 <CENTER><SAMP>#move+{nntpserver.example.com/nntp}#news.comp.mail.pine+local&nbsp;folder</SAMP></CENTER>
8217 <P>
8218
8219 A #move folder may only be used as an
8220 <A HREF="h_config_enable_incoming">&quot;Incoming folder&quot;</A> or
8221 an Inbox.
8222 When you are in the FOLDER LIST of Incoming Message Folders (after turning
8223 on the
8224 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="FEAT_enable-incoming-folders"-->&quot;</A>
8225 option)
8226 the Add command has a subcommand &quot;Use Mail Drop&quot;
8227 which may be helpful for defining the folder in your Alpine configuration.
8228 The same is true when you edit the
8229 <A HREF="h_config_inbox_path"><!--#echo var="VAR_inbox-path"--></A>
8230 option in Setup/Config.
8231 Each of these configuration methods will also create the DestinationFolder
8232 if it doesn't already exist.
8233 If you are having problems, make sure the DestinationFolder exists.
8234
8235 <P>
8236 &lt;End of help on this topic&gt;
8237 </BODY>
8238 </HTML>
8239 ========== h_save =========
8240 <HTML>
8241 <HEAD>
8242 <TITLE>CHOOSE A FOLDER TO SAVE INTO</TITLE>
8243 </HEAD>
8244 <BODY>
8245 <H1>Choose a Folder to Save Into</H1>
8246
8247 After Exiting from this help text,
8248 type the name of the folder you want to save into and press RETURN.
8249 <P>
8250 Press ^T to get a list of your folders to choose from.
8251 Press ^C to cancel the Save.
8252 <P>
8253 If you have Folder Collections defined you may use
8254 Ctrl-P (Previous collection) and Ctrl-N (Next collection) to switch
8255 the collection being saved to.
8256 <P>
8257 If Tab Completion is enabled (it is enabled by default)
8258 you may type a Tab character to have Alpine complete the folder name for you.
8259 <P>
8260 If Partial Match Lists is enabled (it is enabled by default) you may type
8261 Ctrl-X to get a list of matches to the prefix you've typed in so far.
8262 <P>
8263 If the Ctrl-R subcommand is present that means you can decide to Delete or
8264 not Delete the message you are saving after you save it.
8265 The label on that key gives the action to switch to.
8266 If it says Delete and you type Ctrl-R the label displayed will change to
8267 No Delete and the source message will be deleted after the save. If it
8268 says No Delete and you type Ctrl-R the label displayed will change to
8269 Delete and the message will not be deleted.
8270 You can control the default for the Delete parameter with the
8271 configuration feature <!--#echo var="FEAT_save-will-not-delete"-->.
8272 <P>
8273 Similarly, if the Ctrl-W subcommand is present that means you can decide
8274 to Preserve the order of the messages being saved or not.
8275 If it is labeled Preserve Order and you type Ctrl-W, the resulting Saved messages
8276 will be in the same order as you see them in the source folder now.
8277 The opposite action (which is usually the default) is that you don't care
8278 about the order.
8279 The Saved messages may or may not be in the same order in the destination folder.
8280 There may be a performance penalty for choosing to save the messages in order.
8281 You can control the default for the Preserve Order parameter with the
8282 configuration feature
8283 <!--#echo var="FEAT_save-aggregates-copy-sequence"-->.
8284
8285 <P>
8286 If you haven't disabled the Save Input History and you've already done a
8287 Save earlier in this session then you may use the Up and Down arrows to retrieve
8288 a folder name used in a previous Save.
8289
8290 <P>
8291 &lt;End of help on this topic&gt;
8292 </BODY>
8293 </HTML>
8294 ============= h_simple_index ========================
8295 <HTML>
8296 <HEAD>
8297 <TITLE>SELECT POSTPONED MESSAGE</TITLE>
8298 </HEAD>
8299 <BODY>
8300 <H1>POSTPONED MESSAGE SELECTION COMMANDS</H1>
8301 <!--chtml if pinemode="function_key"-->
8302 <PRE>
8303 Navigating the List of Messages               General Alpine Commands
8304 -------------------------------               -----------------------
8305  F5   Move to previous message                 F1   Show this help text
8306  F6   Move to next message
8307  F7   Show previous screen of messages
8308  F8   Show next screen of messages
8309
8310 Message Selection Commands
8311 --------------------------
8312  F3   Exit the Message Select menu (canceling Send command)
8313  F4   Select the currently highlighted message
8314  F9   Mark the currently highlighted message as deleted
8315  F10  Undelete (remove deletion mark from) the highlighted message
8316 </PRE>
8317 <!--chtml else-->
8318 <PRE>
8319 Navigating the List of Messages               General Alpine Commands
8320 -------------------------------               -----------------------
8321   P  Move to previous message                  ?  Show this help text
8322   N  Move to next message
8323   -  Show previous screen of messages
8324  Spc (space bar) Show next screen of messages
8325
8326 Message Selection Commands
8327 --------------------------
8328   E  Exit the Message Select menu (canceling Send command)
8329   S  Select the currently highlighted message
8330   D  Mark the currently highlighted message as deleted
8331   U  Undelete (remove deletion mark from) the highlighted message
8332 </PRE>
8333 <!--chtml endif-->
8334 <P>
8335 <H2>Description of the Select Postponed Message Screen</H2>
8336
8337 This screen allows you to select one of several previously postponed
8338 messages in order to continue composition.  Your options are very limited
8339 -- the screen is not meant to let you manipulate these messages.  However,
8340 you may now delete messages from this list.  Once you choose a message,
8341 Alpine reads it in and puts you into the regular message composer.
8342 <P>
8343
8344 Messages do not stay in this postponed state automatically.  If you select
8345 a message and then want to postpone it again, use the normal postpone
8346 (Ctrl-O) command in the composer.
8347 <P>
8348
8349 If you exit this screen without selecting a message, the Compose command
8350 that got you here is canceled.  Other than messages explicitly marked
8351 &quot;Deleted&quot;, no messages will be removed.
8352
8353 <P>
8354 &lt;End of help on this topic&gt;
8355 </BODY>
8356 </HTML>
8357 ============= h_collection_screen ========================
8358 <HTML>
8359 <HEAD>
8360 <TITLE>COLLECTION LIST screen</TITLE>
8361 </HEAD>
8362 <BODY>
8363 <H1>COLLECTION LIST screen</H1>
8364
8365 The COLLECTION LIST screen is used to select one of your
8366 collection definitions to display the folders they contain.  See
8367 <A HREF="h_what_are_collections">Folder Collections Explained</A> for
8368 detailed explanation of collections.<P>
8369
8370 To manage your collection definitions (Add, Change, Delete, etc.), use
8371 the <A HREF="h_collection_maint">Setup/collectionList</A> command on Alpine's
8372 MAIN MENU.
8373
8374 <P>
8375 &lt;End of help on this topic&gt;
8376 </BODY>
8377 </HTML>
8378 ============= h_collection_maint ========================
8379 <HTML>
8380 <HEAD>
8381 <TITLE>SETUP COLLECTION LIST screen</TITLE>
8382 </HEAD>
8383 <BODY>
8384 <H1>SETUP COLLECTION LIST screen</H1>
8385
8386 The SETUP COLLECTION LIST screen lets you manage your collection
8387 definitions.  See
8388 <A HREF="h_what_are_collections">Folder Collections Explained</A>
8389 for detailed explanation of collections.<P>
8390
8391 Maintenance commands include:
8392 <DL>
8393 <DT>Change
8394 <!--chtml if pinemode="function_key"-->
8395 (F4)
8396 <!--chtml else-->
8397 (C)
8398 <!--chtml endif-->
8399 </DT>
8400
8401 <DD>Modify attributes of the selected collection definition.
8402
8403 <DT>Add Cltn
8404 <!--chtml if pinemode="function_key"-->
8405 (F9)
8406 <!--chtml else-->
8407 (A)
8408 <!--chtml endif-->
8409 </DT>
8410
8411 <DD>Create a new collection definition.
8412 </DD>
8413
8414 <DT>Del Cltn
8415 <!--chtml if pinemode="function_key"-->
8416 (F10)
8417 <!--chtml else-->
8418 (D)
8419 <!--chtml endif-->
8420 </DT>
8421
8422 <DD>Delete the selected collection definition.<BR>
8423 NOTE: The folders and directories referred to by the
8424 collection definition are <EM>NOT</EM> deleted.  Folders must
8425 be deleted, if that's what you wish to do, from the
8426 <A HREF="h_folder_maint">FOLDER LIST screen</A>, which shows the
8427 individual folders in a collection.
8428 </DD>
8429
8430 <DT>Shuffle
8431 <!--chtml if pinemode="function_key"-->
8432 (F11)
8433 <!--chtml else-->
8434 ($)
8435 <!--chtml endif-->
8436 </DT>
8437
8438 <DD>Change the order of the displayed collections.  Alpine will offer
8439 to move the currently selected collection one position UP
8440 or DOWN.
8441 </DD>
8442 </DL>
8443
8444 <P>
8445 &lt;End of help on this topic&gt;
8446 </BODY>
8447 </HTML>
8448 ============ h_what_are_collections ==========
8449 <HTML>
8450 <HEAD>
8451 <TITLE>Folder Collections Explained</TITLE>
8452 </HEAD>
8453 <BODY>
8454 <H1>Folder Collections Explained</H1>
8455
8456
8457 Those of you with simple mail configurations will just see a list of all the
8458 folders you have when choosing FOLDER LIST from Alpine's MAIN MENU.
8459 The special folders for INBOX, sent mail and saved messages
8460 will appear at the top of the list.  All others are in alphabetical order.
8461 <P>
8462 If you
8463 or your system administrator have defined more than one collection or if
8464 you have a collection (for newsgroups or email folders) defined on your
8465 system, then you will see the COLLECTION LIST screen first when choosing
8466 FOLDER LIST from Alpine's MAIN MENU.
8467 <P>
8468 <H2>Why have multiple folder collections?</H2>
8469 <P>
8470 For Alpine users who only maintain email folders (and not too many) on one host,
8471 a single folder collection is probably sufficient.<P>
8472
8473 However, people who have more than one email account - for example, one
8474 at their university, and one with their personal Internet Service Provider -
8475 will have different sets of folders on different hosts, and they may want to
8476 access them all from the same installation of Alpine, rather than use different
8477 software and/or log into other hosts to manipulate messages in different
8478 accounts.  (If in doubt whether one of your email accounts can be accessed
8479 with Alpine, contact the technical support people for that account.)  Even people
8480 who have only one email account on one host, but have dozens or
8481 hundreds of email folders, may want to arrange these folders together in a
8482 meaningful way.<BR>
8483 That is where multiple collections come in.
8484
8485 <H2>Types of Collections</H2>
8486 <DL>
8487 <DT>INCOMING FOLDERS</DT>
8488 <DD>&quot;Incoming Message Folders&quot;
8489 is a special collection typically used to supplement your single INBOX.
8490 All the folders here are meant to be ones that receive incoming messages,
8491 which you intend to check more or less frequently.
8492 You may have multiple folders like this because you or your systems
8493 administrator have set up an external program or you may have set up
8494 Alpine to filter incoming
8495 messages into different folders, based on certain criteria such as
8496 sender, recipient, or subject; or because you have multiple accounts and
8497 wish to check their INBOXes easily.  This collection is established by
8498 setting the
8499 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="FEAT_enable-incoming-folders"-->&quot;</A>
8500 feature in the SETUP CONFIGURATION screen, which is accessed from the
8501 MAIN MENU.
8502 </DD>
8503
8504 <DT>NEWS</DT>
8505 <DD>You can also define a collection specifically for
8506 newsgroups.  Alpine does this for you implicitly when you
8507 <A HREF="h_config_nntp_server">define an NNTP Server</A>
8508 in your Alpine configuration.  The news collection appears last in the
8509 COLLECTION LIST (though you can shuffle it up in the order of presentation),
8510 and Alpine knows not to save messages there.
8511 </DD>
8512
8513 <DT>DEFAULT COLLECTION</DT>
8514 <DD>This is the default collection for your saved and sent messages folders.
8515 </DD>
8516 </DL>
8517
8518 <P>
8519
8520 <H2>Defining Collections</H2>
8521 <P>
8522 In the absence of any folder-collection definitions, Alpine will assume a
8523 single default folder collection.
8524 <!--chtml if pinemode="os_windows"-->
8525 <!--chtml else-->
8526 If necessary, Alpine will create the directory
8527 &quot;mail&quot; in your Unix home directory
8528 to hold your folders.
8529 <!--chtml endif-->
8530 <P>
8531 You can use the
8532 <A HREF="h_collection_maint">Setup/collectionList screen</A>, called up from
8533 the MAIN MENU, to manage your collection list.
8534 <P>
8535 &lt;End of help on this topic&gt;
8536 </BODY>
8537 </HTML>
8538 ===== h_select_address_screen =====
8539 <HTML>
8540 <HEAD>
8541 <TITLE>SELECT AN ADDRESS SCREEN</TITLE>
8542 </HEAD>
8543 <BODY>
8544 <H1>SELECT AN ADDRESS SCREEN</H1>
8545 <H2>COMMANDS</H2>
8546 <!--chtml if pinemode="function_key"-->
8547 <PRE>
8548 Available  Commands
8549 -------------------------------
8550 F1  Show Help Text
8551 F3  Exit without selecting anything
8552 F4  Select the highlighted address
8553 F5  Move highlight to previous address
8554 F6  Move highlight to next address
8555 F7  Previous page of addresses
8556 F8  Next page of addresses
8557 F11 Print
8558 F12 WhereIs
8559 </PRE>
8560 <!--chtml else-->
8561 <PRE>
8562 Navigation                     General Alpine Commands
8563 -------------------------      -----------------------
8564  P  Prev Address                ?  Display this help text
8565  N  Next Address                E  Exit without selecting anything
8566  -  Previous page               %  Print
8567 Spc (space bar) Next page
8568  W  WhereIs
8569
8570 Select Command
8571 ------------------------------------------------
8572  S  Select the highlighted address
8573 </PRE>
8574 <!--chtml endif-->
8575
8576 <H2>Description of the Select Address Screen</H2>
8577
8578 This screen gives you an easy way to select an address from all of
8579 the address book entries that match the prefix typed so far.
8580
8581 <P><UL>
8582 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
8583 </UL>
8584 <P>
8585 &lt;End of help on this topic&gt;
8586 </BODY>
8587 </HTML>
8588 ===== h_select_rule_screen =====
8589 <HTML>
8590 <HEAD>
8591 <TITLE>SELECT A RULE SCREEN</TITLE>
8592 </HEAD>
8593 <BODY>
8594 <H1>SELECT A RULE SCREEN</H1>
8595 <H2>COMMANDS</H2>
8596 <!--chtml if pinemode="function_key"-->
8597 <PRE>
8598 Available  Commands
8599 -------------------------------
8600 F1  Show Help Text
8601 F3  Exit without selecting anything
8602 F4  Select the highlighted rule
8603 F5  Move highlight to previous rule
8604 F6  Move highlight to next rule
8605 F7  Previous page of rules
8606 F8  Next page of rules
8607 F11 Print
8608 F12 WhereIs
8609 </PRE>
8610 <!--chtml else-->
8611 <PRE>
8612 Navigation                     General Alpine Commands
8613 -------------------------      -----------------------
8614  P  Prev Rule                   ?  Display this help text
8615  N  Next Rule                   E  Exit without selecting anything
8616  -  Previous page               %  Print
8617 Spc (space bar) Next page
8618  W  WhereIs
8619
8620 Select Command
8621 ------------------------------------------------
8622  S  Select the highlighted rule
8623 </PRE>
8624 <!--chtml endif-->
8625
8626 <H2>Description of the Select Rule Screen</H2>
8627
8628 This screen just gives you an easy way to select a rule from all of your
8629 defined rules.
8630 The list of rules presented is the list of nicknames of all of the rules
8631 defined using Setup/Rules.
8632 For selecting messages, it is likely that the Indexcolor rules and possibly
8633 the Roles rules will be most useful.
8634 The others are there also, in case you find a use for them.
8635 <P>
8636 In order for this to be useful for selecting messages, the nicknames of
8637 the rules have to be different.
8638 Alpine actually just gets the nickname of the rule that you select and then
8639 looks up that rule using the nickname.
8640 So if there are duplicate nicknames, the first rule that has that
8641 nickname will be used.
8642
8643 <P><UL>
8644 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
8645 </UL>
8646 <P>
8647 &lt;End of help on this topic&gt;
8648 </BODY>
8649 </HTML>
8650 ===== h_select_priority_screen =====
8651 <HTML>
8652 <HEAD>
8653 <TITLE>SELECT A PRIORITY SCREEN</TITLE>
8654 </HEAD>
8655 <BODY>
8656 <H1>SELECT A PRIORITY SCREEN</H1>
8657 <H2>COMMANDS</H2>
8658 <!--chtml if pinemode="function_key"-->
8659 <PRE>
8660 Available  Commands
8661 -------------------------------
8662 F1  Show Help Text
8663 F3  Exit without selecting anything
8664 F4  Select the highlighted priority
8665 F5  Move highlight to previous priority
8666 F6  Move highlight to next priority
8667 F7  Previous page of priorities
8668 F8  Next page of priorities
8669 F11 Print
8670 F12 WhereIs
8671 </PRE>
8672 <!--chtml else-->
8673 <PRE>
8674 Navigation                     General Alpine Commands
8675 -------------------------      -----------------------
8676  P  Prev Priority               ?  Display this help text
8677  N  Next Priority               E  Exit without selecting anything
8678  -  Previous page               %  Print
8679 Spc (space bar) Next page
8680  W  WhereIs
8681
8682 Select Command
8683 ------------------------------------------------
8684  S  Select the highlighted priority
8685 </PRE>
8686 <!--chtml endif-->
8687
8688 <H2>Description of the Select Priority Screen</H2>
8689
8690 This screen gives you a way to select a priority for the message you are sending.
8691 This priority will be placed in the non-standard X-Priority header of your outgoing mail.
8692 Some mail programs will display an indication of the priority level to
8693 the recipient of the message, some will ignore it.
8694 Even in cases where the mail programs of both the sender and the recipient
8695 agree on the meaning of this header, keep in mind that it is
8696 something that the sender sets so it is only an indication
8697 of the priority that the sender attaches to the mail.
8698 Alpine can be made to display an indication of this priority in incoming
8699 messages by use of one of the tokens
8700 (<A HREF="h_index_tokens">Tokens for Index and Replying</A>)
8701 PRIORITY, PRIORITYALPHA, or PRIORITY! in the
8702 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option.
8703
8704 <P><UL>
8705 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
8706 </UL>
8707 <P>
8708 &lt;End of help on this topic&gt;
8709 </BODY>
8710 </HTML>
8711 ===== h_select_keyword_screen =====
8712 <HTML>
8713 <HEAD>
8714 <TITLE>SELECT A KEYWORD SCREEN</TITLE>
8715 </HEAD>
8716 <BODY>
8717 <H1>SELECT A KEYWORD SCREEN</H1>
8718 <H2>COMMANDS</H2>
8719 <!--chtml if pinemode="function_key"-->
8720 <PRE>
8721 Available  Commands
8722 -------------------------------
8723 F1  Show Help Text
8724 F3  Exit without selecting anything
8725 F4  Select the highlighted keyword
8726 F5  Move highlight to previous keyword
8727 F6  Move highlight to next keyword
8728 F7  Previous page of keywords
8729 F8  Next page of keywords
8730 F11 Print
8731 F12 WhereIs
8732 </PRE>
8733 <!--chtml else-->
8734 <PRE>
8735 Navigation                     General Alpine Commands
8736 -------------------------      -----------------------
8737  P  Prev Keyword                ?  Display this help text
8738  N  Next Keyword                E  Exit without selecting anything
8739  -  Previous page               %  Print
8740 Spc (space bar) Next page
8741  W  WhereIs
8742
8743 Select Command
8744 ------------------------------------------------
8745  S  Select the highlighted keyword
8746 </PRE>
8747 <!--chtml endif-->
8748
8749 <H2>Description of the Select Keyword Screen</H2>
8750
8751 This screen just gives you an easy way to select a keyword.
8752 The list of keywords presented is the list of all keywords defined in your
8753 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option.
8754 If you have given a keyword a nickname, that nickname is displayed
8755 instead of the actual keyword.
8756
8757 <P><UL>
8758 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
8759 </UL>
8760 <P>
8761 &lt;End of help on this topic&gt;
8762 </BODY>
8763 </HTML>
8764 ===== h_select_charset_screen =====
8765 <HTML>
8766 <HEAD>
8767 <TITLE>SELECT A CHARACTER SET SCREEN</TITLE>
8768 </HEAD>
8769 <BODY>
8770 <H1>SELECT A CHARACTER SET SCREEN</H1>
8771 <H2>COMMANDS</H2>
8772 <!--chtml if pinemode="function_key"-->
8773 <PRE>
8774 Available  Commands
8775 -------------------------------
8776 F1  Show Help Text
8777 F3  Exit without selecting anything
8778 F4  Select the highlighted character set
8779 F5  Move highlight to previous character set
8780 F6  Move highlight to next character set
8781 F7  Previous page of character sets
8782 F8  Next page of character sets
8783 F11 Print
8784 F12 WhereIs
8785 </PRE>
8786 <!--chtml else-->
8787 <PRE>
8788 Navigation                     General Alpine Commands
8789 -------------------------      -----------------------
8790  P  Prev Character Set          ?  Display this help text
8791  N  Next Character Set          E  Exit without selecting anything
8792  -  Previous page               %  Print
8793 Spc (space bar) Next page
8794  W  WhereIs
8795
8796 Select Command
8797 ------------------------------------------------
8798  S  Select the highlighted character set
8799 </PRE>
8800 <!--chtml endif-->
8801
8802 <H2>Description of the Select A Character Set Screen</H2>
8803
8804 This screen just gives you an easy way to select a character set from the
8805 set of character sets Alpine knows about.
8806 The list presented will vary slightly depending on what option you are
8807 selecting the character set for.
8808
8809 <P><UL>
8810 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
8811 </UL>
8812 <P>
8813 &lt;End of help on this topic&gt;
8814 </BODY>
8815 </HTML>
8816 ===== h_select_multcharsets_screen =====
8817 <HTML>
8818 <HEAD>
8819 <TITLE>SELECT CHARACTER SETS SCREEN</TITLE>
8820 </HEAD>
8821 <BODY>
8822 <H1>SELECT CHARACTER SETS SCREEN</H1>
8823 <H2>COMMANDS</H2>
8824 <!--chtml if pinemode="function_key"-->
8825 <PRE>
8826 Available  Commands
8827 -------------------------------
8828 F1  Show Help Text
8829 F3  Exit without selecting anything
8830 F4  Select the highlighted charset (or chosen charsets in ListMode)
8831 F5  Move highlight to previous charset
8832 F6  Move highlight to next charset
8833 F7  Previous page of charsets
8834 F8  Next page of charsets
8835 F9  Toggle choices when using ListMode
8836 F10 Turn on/off ListMode (makes it easy to choose multiple charsets)
8837 F11 Print
8838 F12 WhereIs
8839 </PRE>
8840 <!--chtml else-->
8841 <PRE>
8842 Navigation                     General Alpine Commands
8843 -------------------------      -----------------------
8844  P  Prev Charset                ?  Display this help text
8845  N  Next Charset                E  Exit without selecting anything
8846  -  Previous page               %  Print
8847 Spc (space bar) Next page
8848  W  WhereIs
8849
8850 Select Command
8851 ------------------------------------------------
8852  S  Select the highlighted charset (or chosen charsets in ListMode)
8853  L  Turn on ListMode (makes it easy to choose multiple charsets)
8854  1  Turn off ListMode
8855  X  Toggle choices when using ListMode
8856 </PRE>
8857 <!--chtml endif-->
8858
8859 <H2>Description of the Select Character Set Screen</H2>
8860
8861 This screen just gives you an easy way to select a character set or a list of
8862 character sets.
8863 The list of character sets presented is the list of all character sets known to
8864 Alpine.
8865 You may select other character sets by typing them in directly.
8866
8867 <P><UL>
8868 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
8869 </UL>
8870 <P>
8871 &lt;End of help on this topic&gt;
8872 </BODY>
8873 </HTML>
8874 ===== h_select_multkeyword_screen =====
8875 <HTML>
8876 <HEAD>
8877 <TITLE>SELECT KEYWORDS SCREEN</TITLE>
8878 </HEAD>
8879 <BODY>
8880 <H1>SELECT KEYWORDS SCREEN</H1>
8881 <H2>COMMANDS</H2>
8882 <!--chtml if pinemode="function_key"-->
8883 <PRE>
8884 Available  Commands
8885 -------------------------------
8886 F1  Show Help Text
8887 F3  Exit without selecting anything
8888 F4  Select the highlighted keyword (or chosen keywords in ListMode)
8889 F5  Move highlight to previous keyword
8890 F6  Move highlight to next keyword
8891 F7  Previous page of keywords
8892 F8  Next page of keywords
8893 F9  Toggle choices when using ListMode
8894 F10 Turn on/off ListMode (makes it easy to choose multiple keywords)
8895 F11 Print
8896 F12 WhereIs
8897 </PRE>
8898 <!--chtml else-->
8899 <PRE>
8900 Navigation                     General Alpine Commands
8901 -------------------------      -----------------------
8902  P  Prev Keyword                ?  Display this help text
8903  N  Next Keyword                E  Exit without selecting anything
8904  -  Previous page               %  Print
8905 Spc (space bar) Next page
8906  W  WhereIs
8907
8908 Select Command
8909 ------------------------------------------------
8910  S  Select the highlighted keyword (or chosen keywords in ListMode)
8911  L  Turn on ListMode (makes it easy to choose multiple keywords)
8912  1  Turn off ListMode
8913  X  Toggle choices when using ListMode
8914 </PRE>
8915 <!--chtml endif-->
8916
8917 <H2>Description of the Select Keyword Screen</H2>
8918
8919 This screen just gives you an easy way to select a keyword or a list of
8920 keywords.
8921 The list of keywords presented is the list of all keywords defined in your
8922 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option.
8923 If you have given a keyword a nickname, that nickname is displayed
8924 instead of the actual keyword.
8925
8926 <P><UL>
8927 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
8928 </UL>
8929 <P>
8930 &lt;End of help on this topic&gt;
8931 </BODY>
8932 </HTML>
8933 ===== h_select_incoming_to_monitor =====
8934 <HTML>
8935 <HEAD>
8936 <TITLE>SELECT FOLDERS TO CHECK SCREEN</TITLE>
8937 </HEAD>
8938 <BODY>
8939 <H1>SELECT FOLDERS TO CHECK SCREEN</H1>
8940 <H2>COMMANDS</H2>
8941 <!--chtml if pinemode="function_key"-->
8942 <PRE>
8943 Available  Commands
8944 -------------------------------
8945 F1  Show Help Text
8946 F3  Exit without selecting anything
8947 F4  Select the marked folders
8948 F5  Move highlight to previous folder
8949 F6  Move highlight to next folder
8950 F7  Previous page of folders
8951 F8  Next page of folders
8952 F9  Toggle choices on or off
8953 F11 Print
8954 F12 WhereIs
8955 </PRE>
8956 <!--chtml else-->
8957 <PRE>
8958 Navigation                     General Alpine Commands
8959 -------------------------      -----------------------
8960  P  Prev Folder                 ?  Display this help text
8961  N  Next Folder                ^C  exit without changing anything
8962  -  Previous page               %  Print
8963 Spc (space bar) Next page
8964  W  WhereIs
8965
8966 Select Command
8967 ------------------------------------------------
8968  S  Select the marked folders
8969  X  Toggle choices on or off
8970 </PRE>
8971 <!--chtml endif-->
8972
8973 <H2>Description of the Select Folders to Check Screen</H2>
8974
8975 This screen is only useful if the feature
8976 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
8977 is set.
8978 By default, when you set that feature all of your incoming folders
8979 will be checked periodically for Unseen messages.
8980 By using this screen, you may restrict the set of monitored folders to
8981 a subset of all of the incoming folders.
8982 <P>
8983 Mark the folders you want to monitor for Unseen messages with
8984 an &quot;X&quot;.
8985 When you've finished marking all your selections use the Select
8986 command to register your choices.
8987 To return to the default of checking all incoming folders
8988 delete all folders or unmark all folders.
8989
8990 <P><UL>
8991 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
8992 </UL>
8993 <P>
8994 &lt;End of help on this topic&gt;
8995 </BODY>
8996 </HTML>
8997 ===== h_role_select =====
8998 <HTML>
8999 <HEAD>
9000 <TITLE>ROLES SCREEN</TITLE>
9001 </HEAD>
9002 <BODY>
9003 <H1>ROLES SCREEN</H1>
9004 <H2>ROLES COMMANDS</H2>
9005 <!--chtml if pinemode="function_key"-->
9006 <PRE>
9007 Available  Commands
9008 -------------------------------
9009 F1  Show Help Text
9010 F3  Exit without a selection
9011 F4  Select a role to use in composition
9012 F5  Move to previous role
9013 F6  Move to next role
9014 F7  Previous page of roles
9015 F8  Next page of roles
9016 F11 Change Default Role
9017 F12 Whereis (search role nicknames)
9018 </PRE>
9019 <!--chtml else-->
9020 <PRE>
9021 Navigation                     General Alpine Commands
9022 -------------------------      -----------------------
9023  P  Prev Role                     ?  Display this help text
9024  N  Next Role                     E  Exit without a selection
9025  -  Previous page
9026 Spc (space bar) Next page
9027  W  WhereIs (search for word in role nicknames)
9028
9029 Select Role Commands
9030 ------------------------------------------------
9031  [Return]  Select highlighted role
9032  D         Change Default Role
9033 </PRE>
9034 <!--chtml endif-->
9035
9036 <H2>Description of the Roles Screen</H2>
9037
9038 With this screen you select a role to be used in the composition of a
9039 message.
9040 Use the Previous and Next commands to highlight the role you wish to
9041 use.
9042 When you type carriage return you will be placed in the composer using the highlighted role.
9043 <P>
9044 You don't have any non-default <A HREF="h_rules_roles">roles</A>
9045 available unless you set them up.
9046 You may do so by using the Setup/Rules command on the MAIN MENU.
9047 <P>
9048 By using the D command, you may set a default role that will persist until
9049 you change it or until you exit Alpine.
9050 The D command toggles through three states: set the default role, unset the
9051 default role, and leave the default role as it is.
9052 <P><UL>
9053 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
9054 </UL>
9055 <P>
9056 &lt;End of help on this topic&gt;
9057 </BODY>
9058 </HTML>
9059 ===== h_role_abook_select =====
9060 <HTML>
9061 <HEAD>
9062 <TITLE>SELECT ADDRESS BOOK SCREEN</TITLE>
9063 </HEAD>
9064 <BODY>
9065 <H1>SELECT ADDRESS BOOK SCREEN</H1>
9066 <H2>COMMANDS</H2>
9067 <!--chtml if pinemode="function_key"-->
9068 <PRE>
9069 Available  Commands
9070 -------------------------------
9071 F1  Show Help Text
9072 F3  Exit screen without selecting anything
9073 F4  Select highlighted address book
9074 F5  Move to previous address book
9075 F6  Move to next address book
9076 F7  Previous page of address books
9077 F8  Next page of address books
9078 F12 Whereis
9079 </PRE>
9080 <!--chtml else-->
9081 <PRE>
9082 Navigation                     General Alpine Commands
9083 -------------------------      -----------------------
9084  P  Previous addrbook          ?  Display this help text
9085  N  Next addrbook
9086  -  Previous page
9087 Spc (space bar) Next page
9088  W  WhereIs
9089
9090 Select Role Commands
9091 ------------------------------------------------
9092  S  Select highlighted address book
9093  E  Exit screen without selecting anything
9094 </PRE>
9095 <!--chtml endif-->
9096
9097 <H2>Description of the Select Address Book Screen</H2>
9098
9099 This screen helps you select one of your address books.
9100 Use the Previous and Next commands to highlight the address book you wish to
9101 select.
9102 <P><UL>
9103 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
9104 </UL>
9105 <P>
9106 &lt;End of help on this topic&gt;
9107 </BODY>
9108 </HTML>
9109 ======== h_rule_patterns =============
9110 <HTML>
9111 <HEAD>
9112 <TITLE>PATTERNS</TITLE>
9113 </HEAD>
9114 <BODY>
9115 <H1>PATTERNS</H1>
9116 Patterns are used with Roles, Filtering, Index Coloring,
9117 Scoring, Other Rules, and Search Rules.
9118 Patterns are compared with a message to see if there is a match.
9119 For Filtering, the messages being checked are all the messages in the
9120 folder, one at a time.
9121 For Index Line Coloring, each message that is visible on the screen is
9122 checked for matches with the Index Coloring Patterns.
9123 Roles are used with the Reply, Forward, and Compose commands.
9124 For Reply, the message used to compare the Pattern with is the message
9125 being replied to;
9126 for Forward, the message used to compare the Pattern with is the message
9127 being forwarded;
9128 and for Compose, there is no message, so the parts of the Pattern that depend
9129 on a message (everything other than Current Folder Type and the
9130 Beginning of Month and Year)
9131 are not used.
9132 Only the Current Folder Type matters for Compose (plus the Beginning of
9133 Month or Year, which you wouldn't usually use for a Role).
9134 For Scoring, the message being scored is compared with all of the Score
9135 Patterns, and the Score Values from the ones that match are added together to
9136 get the message's score.
9137 For Other Rules, there is no message. Only the Current Folder Type is checked
9138 for Other Rules.
9139 <P>
9140 Each Pattern has several possible parts, all of which are optional.
9141 In order for there to be a match, <EM>ALL</EM> of the
9142 <EM>defined</EM> parts of the Pattern must match the message.
9143 If a part is not defined it is considered a match, but note that a filtering
9144 Pattern must have at least one defined part or it will be ignored.
9145 For example, if the To pattern is not defined it will be
9146 displayed as
9147 <P>
9148 <CENTER>To pattern = &lt;No Value Set&gt;</CENTER>
9149 <P>
9150 That is considered a match because it is not defined.
9151 This means that the Pattern with nothing defined is a match if the
9152 Current Folder Type matches, but there is an exception that was mentioned
9153 in the previous paragraph.
9154 Because filtering is a potentially destructive action, filtering Patterns
9155 with nothing other than Current Folder Type defined are ignored.
9156 If you really want a filtering Pattern to match all messages (subject to
9157 Current Folder Type) the best way to do it is to define a Score interval
9158 that includes all possible scores.
9159 This would be the score interval <SAMP>(-INF,INF)</SAMP>.
9160 This can be used even if you haven't defined any rules to Set Scores.
9161 <P>
9162 There are six predefined header patterns called the To, From, Sender, Cc, News,
9163 and Subject patterns.
9164 Besides those six predefined header patterns, you may add
9165 additional header patterns with header fieldnames of your choosing.
9166 You add an extra header pattern by placing the cursor on one of the
9167 patterns while in the role editor and using the &quot;eXtraHdr&quot; command.
9168 The Recip pattern is a header pattern that stands for Recipient (To OR Cc)
9169 and the Partic pattern is a header pattern that stands for
9170 Participant (From OR To OR Cc).
9171 (Defining the Recip pattern does not have the same effect as defining both
9172 the To and Cc patterns. Recip is To <EM>OR</EM> Cc, not To <EM>AND</EM> Cc.)
9173 Similar to the header patterns are the AllText pattern and the BodyText pattern.
9174 Instead of comparing this pattern's text against only the contents of
9175 a particular header field, the text for the AllText pattern is compared
9176 with text anywhere in the message's header or body, and the text for the
9177 BodyText pattern is compared with text anywhere in the message's body.
9178 <P>
9179 Any of the header patterns, the AllText pattern, or the BodyText pattern may be negated with the
9180 &quot;!&quot; &quot;toggle NOT&quot; command.
9181 You can tell that <EM>NOT</EM> has been turned on by looking for the character
9182 &quot;!&quot; at the beginning of the pattern line.
9183 When the &quot;!&quot; is present, it reverses the meaning of the match.
9184 That is, if the pattern matches then it is considered to NOT be a match, and
9185 if it does not match it is considered to be a match.
9186 <P>
9187 Don't make the mistake of putting the &quot;!&quot; in the data field for
9188 a pattern.
9189 For example, if you type the characters &quot;!urgent&quot; into the Subject
9190 pattern, the pattern will look like:
9191 <P>
9192 <PRE>
9193  Subject pattern = !urgent
9194 </PRE>
9195 <P>
9196 This means you want to match the 7 character sequence &quot;!urgent&quot;.
9197 In order to match messages that do not have &quot;urgent&quot; in
9198 their Subject field, first type the characters &quot;urgent&quot; followed
9199 by carriage return for the value of the Subject pattern, then negate it
9200 by typing the &quot;!&quot; command.
9201 It should look like
9202 <P>
9203 <PRE>
9204  ! Subject pattern = urgent
9205 </PRE>
9206 <P>
9207 The contents of each of these header patterns (or the AllText or BodyText patterns) may
9208 be a complete email address, part of an address, or a random set of
9209 characters to match against.
9210 It may also be a list of such patterns, which means you
9211 are looking for a match against the first pattern in the list <EM>OR</EM>
9212 the second pattern <EM>OR</EM> the third and so on.
9213 For example, a Subject pattern equal to
9214 <P>
9215 <PRE>
9216  Subject pattern = urgent
9217                    emergency
9218                    alert
9219 </PRE>
9220 <P>
9221 would match all messages with a subject that contained at least one
9222 of those words.
9223 It would also match subjects containing the words &quot;alerts&quot; or
9224 &quot;Urgently&quot;.
9225 <P>
9226 The same example with &quot;NOT&quot; turned on would be
9227 <P>
9228 <PRE>
9229  ! Subject pattern = urgent
9230                      emergency
9231                      alert
9232 </PRE>
9233 <P>
9234 which would match all messages with a subject that did <EM>NOT</EM> contain any of
9235 those words.
9236 You can use the &quot;Add Value&quot; command to add new words to the list,
9237 or you can enter them as a comma-separated list.
9238 <P>
9239 (It is not possible to specify two patterns that must <EM>BOTH</EM> be
9240 present for a match.
9241 It is only possible to specify that <EM>EITHER</EM> pattern1 <EM>OR</EM>
9242 pattern2 must be present,
9243 and that is exactly what using a list does.)
9244 <P>
9245 The &quot;Current Folder Type&quot; and the &quot;Score Interval&quot; are
9246 also part of the Pattern, although the &quot;Score Interval&quot; is not used
9247 when checking for matches for Scoring.
9248 There are five similar settings that relate to the status of the message.
9249 These settings rely on the message being New or not, Deleted or not,
9250 Answered or not, Important or not, and Recent or not.
9251 There are also some other miscellaneous settings.
9252 The first is the Age of the message in days.
9253 Another is the Size of the message, in bytes.
9254 The third is a setting that detects whether or not the Subject of a
9255 message contains raw 8-bit characters (unencoded characters with the most
9256 significant bit set).
9257 There is a setting that detects whether or not this is the first time
9258 Alpine has been run this month (doesn't depend on individual messages),
9259 and another that detects whether or not this is the first time Alpine has
9260 been run this year.
9261 Other parts of the Pattern detect whether or not the From address of a
9262 message appears in your address book, whether or not certain keywords
9263 are set for a message, and whether or not certain character sets are
9264 used in a message.
9265
9266 <H2>Parts of a Pattern</H2>
9267
9268 <H3>Header patterns</H3>
9269
9270 A header pattern is simply text that is searched for in the corresponding
9271 header field.
9272 For example, if a Pattern has a From header pattern with the value
9273 &quot;@company.com&quot;, then only messages that have a From header
9274 that contains the text &quot;@company.com&quot; will be possible
9275 matches.
9276 Matches don't have to be exact.
9277 For example, if the relevant field of a message contains the text
9278 &quot;mailbox@domain&quot; somewhere
9279 in it, then header patterns of &quot;box&quot;, or &quot;x@d&quot;, or
9280 &quot;mailbox@domain&quot; are all matches.
9281 <P>
9282 All parts of the Pattern must match so, for example,
9283 if a message matches a defined
9284 From pattern, it still must be checked against the other parts of the
9285 Pattern that have been defined.
9286 The To header pattern is a slightly special case.
9287 If the message being checked has a Resent-To header
9288 and the feature <A HREF="h_config_use_resentto"><!--#echo var="FEAT_use-resent-to-in-rules"--></A> is turned on, the addresses
9289 there are used in place of the addresses in the To header.
9290 This is only true for the To header.
9291 Resent-cc and Resent-From headers are never used unless you add them
9292 with the eXtraHdrs command.
9293 <P>
9294 The meaning of a header pattern may be negated with the
9295 &quot;!&quot; &quot;toggle NOT&quot; command.
9296 You can tell that <EM>NOT</EM> has been turned on by looking for the character
9297 &quot;!&quot; at the beginning of the pattern line.
9298 It would look something like
9299 <P>
9300 <PRE>
9301  ! From pattern = susan@example.com
9302 </PRE>
9303 <P>
9304 When the &quot;!&quot; is present, it reverses the meaning of the match.
9305 <P>
9306 If you want to check for the presence of a header field but don't care
9307 about its value, then
9308 the empty pattern that you get by entering a pair of
9309 double quotes (&quot;&quot;) should match any message that
9310 has the corresponding header field.
9311
9312 <H3><A NAME="pattern_alltext">AllText patterns</A></H3>
9313
9314 AllText patterns are just like header patterns except that the text is
9315 searched for anywhere in the message's headers or body, not just in the
9316 contents of a particular header field.
9317 <P>
9318
9319 <H3><A NAME="pattern_bodytext">BodyText patterns</A></H3>
9320
9321 BodyText patterns are just like header patterns except that the text is
9322 searched for anywhere in the message's body, not just in the
9323 contents of a particular header field.
9324 <P>
9325
9326 If there is more than one header pattern or AllText pattern or BodyText pattern
9327 for which you want to take the
9328 same action there is a shorthand notation that may be used.
9329 Any of these patterns may be a list of patterns instead of
9330 just a single pattern.
9331 If any one of the patterns in the list matches the message
9332 then it is considered a match.
9333 For example, if &quot;company1&quot; and &quot;company2&quot; both required
9334 you to use the same role when replying to messages, you might have
9335 a To pattern that looks like
9336 <P>
9337 <PRE>
9338  To pattern = company1.com
9339               company2.com
9340 </PRE>
9341 <P>
9342 This means that if the mail you are replying to was addressed to
9343 either &quot;anything@company1.com&quot; or &quot;anything@company2.com&quot;,
9344 then this Pattern is a match and the same actions will be taken.
9345 <P>
9346 The meaning of an AllText or BodyText pattern may be negated with the
9347 &quot;!&quot; &quot;toggle NOT&quot; command.
9348 You can tell that <EM>NOT</EM> has been turned on by looking for the character
9349 &quot;!&quot; at the beginning of the pattern line.
9350 When the &quot;!&quot; is present, it reverses the meaning of the match.
9351 <P>
9352 A technicality: Since comma is the character used to separate multiple values
9353 in any of the fields that may have multiple values (such as header patterns,
9354 AllText patterns, BodyText patterns, keywords, folder lists, and so on),
9355 you must escape comma with a
9356 backslash (&#92;) if you want to include a literal comma in one of those fields.
9357 In other words, if you type a backslash followed by a comma it will
9358 be interpreted as a comma by Alpine, instead of as a separator between
9359 pattern values.
9360 All other backslashes (those not followed by a comma) are literal
9361 backslashes and should not be escaped.
9362 It's unlikely you'll ever need to enter a literal comma or backslash in
9363 any of the patterns.
9364
9365 <H3><A NAME="pattern_current_folder">Current Folder Type</A></H3>
9366
9367 The &quot;Current Folder Type&quot; may be set to one of four different
9368 values: &quot;Any&quot;, &quot;News&quot;, &quot;Email&quot;, or
9369 &quot;Specific&quot;.
9370 If the value is set to &quot;News&quot;, then the
9371 Pattern will only match if the currently open folder is a newsgroup.
9372 The value &quot;Email&quot; only matches if the current folder is not news and
9373 the value &quot;Any&quot; causes any folder to match.
9374 If the value of &quot;Current Folder Type&quot; is set to &quot;Specific&quot;,
9375 then you must fill in a value for &quot;Folder&quot;, which is on the line
9376 below the &quot;Specific&quot; line.
9377 In this case you will only get a match if the currently open folder is
9378 the specific folder you list.
9379 You may give a list of folders instead of just a single
9380 folder name, in which case the Pattern will match if the open folder is
9381 any one of the folders in the list.
9382 The name of each folder in the list may be either &quot;INBOX&quot;,
9383 the technical specification
9384 of the folder (like what appears in your configuration file) or, if the
9385 folder is one of your incoming folders, it may be the nickname you've given
9386 the folder.
9387 Here are some samples of specific folder names:
9388 <P>
9389 <CENTER><SAMP>{monet.art.example.com}mail/art-class</SAMP></CENTER>
9390 <P>
9391 <CENTER><SAMP>{news.example.com/nntp}#news.comp.mail.pine</SAMP></CENTER>
9392 <P>
9393 <CENTER><SAMP>mail/local-folder</SAMP></CENTER>
9394 <P>
9395 The easiest way to fill in the &quot;Folder&quot; field is to use
9396 the &quot;T&quot; command that is available when the &quot;Folder&quot; line is
9397 highlighted, or to use the &quot;Take&quot; command with the configuration
9398 feature
9399 <A HREF="h_config_enable_role_take">&quot;<!--#echo var="FEAT_enable-rules-under-take"-->&quot;</A>
9400 turned on.
9401 <P>
9402 When reading a newsgroup, there may be a performance penalty
9403 incurred when collecting the information necessary to check whether
9404 or not a Pattern matches a message.
9405 For this reason, the default Current Folder Type is set to &quot;Email&quot;.
9406 If you have Patterns with a Current Folder Type of either
9407 &quot;Any&quot; or &quot;News&quot; and those Patterns are used for
9408 Index Line Coloring or Scoring, you may experience
9409 slower screen redrawing in the MESSAGE INDEX screen when in a newsgroup.
9410
9411 <H3><A NAME="pattern_age_interval">Age Interval</A></H3>
9412
9413 The &quot;Age Interval&quot; may be set to an interval of message
9414 ages that should be considered a match.
9415 Like the other parts of the Pattern, if it is unset it will be ignored.
9416 The Age Interval looks like
9417 <P>
9418 <CENTER><SAMP>(min_age,max_age)</SAMP></CENTER>
9419 <P>
9420 where &quot;min_age&quot; and &quot;max_age&quot; are integers greater
9421 than or equal to zero.
9422 The special value &quot;INF&quot; may be used for
9423 the max value. It represents infinity.
9424 <P>
9425 Actually, this option may be defined as a list of intervals instead
9426 of just a single interval.
9427 The list is separated by commas.
9428 It can look like
9429 <P>
9430 <CENTER><SAMP>(min_age1,max_age1),(min_age2,max_age2),...</SAMP></CENTER>
9431 <P>
9432 When there is an Age Interval defined, it is a match if the age, in days, of
9433 the message is contained in any of the intervals.
9434 The intervals include both endpoints.
9435 <P>
9436 Even though this option is called Age, it isn't actually
9437 the <EM>age</EM> of the message.
9438 Instead, it is how many days ago the message arrived in one of your folders.
9439 If the current time is a little past midnight, then a message that arrived
9440 just before midnight arrived yesterday, even though the message is only
9441 a few minutes old.
9442 By default, the date being used is not the date in the Date
9443 header of the message.
9444 It is the date that the message arrived in one of your folders.
9445 When you Save a message from one folder to another that arrival date
9446 is preserved.
9447 If you would like to use the date in the Date header that is possible.
9448 Turn on the option
9449 <A HREF="h_config_filt_opts_sentdate">&quot;Use-Date-Header-For-Age&quot;</A>
9450 near the bottom of the rule definition.
9451 A value of 0 is today, 1 is yesterday, 2 is the day before yesterday, and so on.
9452
9453 <H3><A NAME="pattern_size_interval">Size Interval</A></H3>
9454
9455 The &quot;Size Interval&quot; may be set to an interval of message
9456 sizes that should be considered a match.
9457 Like the other parts of the Pattern, if it is unset it will be ignored.
9458 The Size Interval looks like
9459 <P>
9460 <CENTER><SAMP>(min_size,max_size)</SAMP></CENTER>
9461 <P>
9462 where &quot;min_size&quot; and &quot;max_size&quot; are integers greater
9463 than or equal to zero.
9464 The special value &quot;INF&quot; may be used for
9465 the max value. It represents infinity.
9466 <P>
9467 Actually, this option may be defined as a list of intervals instead
9468 of just a single interval.
9469 The list is separated by commas.
9470 It can look like
9471 <P>
9472 <CENTER><SAMP>(min_size1,max_size1),(min_size2,max_size2),...</SAMP></CENTER>
9473 <P>
9474 When there is a Size Interval defined, it is a match if the size, in bytes, of
9475 the message is contained in any of the intervals.
9476 The intervals include both endpoints.
9477
9478 <H3><A NAME="pattern_score_interval">Score Interval</A></H3>
9479
9480 The &quot;Score Interval&quot; may be set to an interval of message
9481 scores that should be considered a match.
9482 Like the other parts of the Pattern, if it is unset it will be ignored.
9483 The Score Interval looks like
9484 <P>
9485 <CENTER><SAMP>(min_score,max_score)</SAMP></CENTER>
9486 <P>
9487 where &quot;min_score&quot; and &quot;max_score&quot; are positive or
9488 negative integers, with min_score less than or equal to max_score.
9489 The special values &quot;-INF&quot; and &quot;INF&quot; may be used for
9490 the min and max values to represent negative and positive infinity.
9491 <P>
9492 Actually, a list of intervals may be used if you wish.
9493 A list would look like
9494 <P>
9495 <CENTER><SAMP>(min_score1,max_score1),(min_score2,max_score2),...</SAMP></CENTER>
9496 <P>
9497 When there is a Score Interval defined, it is a match if the score for
9498 the message is contained in any of the intervals in the list.
9499 The intervals include the endpoints.
9500 The score for a message is calculated by looking at every Score rule defined and
9501 adding up the Score Values for the ones that match the message.
9502 When deciding whether or not a Pattern matches a message for purposes of
9503 calculating the score, the Score Interval is ignored.
9504
9505 <H3><A NAME="pattern_message_status">Message Status</A></H3>
9506
9507 There are five separate message status settings.
9508 By default, all five are set to the value &quot;Don't care&quot;, which
9509 will match any message.
9510 The value &quot;Yes&quot; means that the particular status must be true
9511 for a match, and the value &quot;No&quot; means that the particular
9512 status must not be true for a match.
9513 For example, one of the five Message Status settings is whether a message
9514 is marked Important or not.
9515 A &quot;Yes&quot; means that the message must be Important to be
9516 considered a match and &quot;No&quot; means that the message must not be
9517 Important to be considered a match.
9518 The same is true of the other four message status settings that depend
9519 on whether or not the message is New; whether the message has
9520 been Answered or not; whether the message has been Deleted or not, and
9521 whether the message is Recent or not.
9522 <P>
9523 The nomenclature for New and Recent is a bit confusing:
9524 <P>
9525 New means that the message is Unseen.
9526 It could have been in your mailbox for a long time but if you haven't looked
9527 at it, it is still considered New.
9528 That matches the default Alpine index display that shows an N for such a
9529 message.
9530 <P>
9531 Recent means that the message was added to this folder since the last time
9532 you opened the folder.
9533 Alpine also shows an N by default for these types of messages.
9534 If you were to run two copies of Alpine that opened a folder one right after
9535 the other, a message would only show up as Recent in (at most) the first
9536 Alpine session.
9537
9538 <H3><A NAME="pattern_message_keywords">Message Keywords</A></H3>
9539
9540 Keywords are similar to Message Status, but they are chosen by the user.
9541 Provided the mail server allows for it, you may add a set of possible keywords
9542 to a folder and then you may set those keywords or not for each message
9543 in the folder (see <A HREF="h_common_flag">Flag Command</A>).
9544 The syntax of this part of the Pattern is similar to the header patterns.
9545 It is a list of keywords.
9546 The Keyword part of the Pattern is a match if the message has any of
9547 the keywords in the list set.
9548 Like other parts of the Pattern, if this is unset it will be ignored.
9549
9550 <H3><A NAME="pattern_message_charsets">Message Character Sets</A></H3>
9551
9552 A message may use one or more character sets.
9553 This part of the Pattern matches messages that make use of one or more of
9554 the character sets specified in the pattern.
9555 It will be considered a match if a message uses any of the character
9556 sets in the list you give here.
9557
9558 <P>
9559 Besides actual character set names (for example, ISO-8859-7, KOI8-R, or
9560 GB2312) you may also use some shorthand names that Alpine provides.
9561 These names are more understandable shorthand names for sets of
9562 character set names.
9563 Two examples are &quot;Cyrillic&quot; and &quot;Greek&quot;.
9564 Selecting one of these shorthand names is equivalent to selecting all of
9565 the character sets that make up the set.
9566 You can see all of these shorthand names and the lists of character sets
9567 they stand for by typing the &quot;T&quot; command with the Character
9568 Set pattern highlighted.
9569 The syntax of this part of the Pattern is similar to the header patterns
9570 and the Message Keywords pattern.
9571 It is a list of character sets (or shorthand names).
9572 The Character Set part of the Pattern is a match if the message uses any
9573 of the character sets in the list.
9574 Like other parts of the Pattern, if this is unset it will be ignored.
9575
9576 <H3><A NAME="pattern_8bit_subject">Raw 8-bit in Subject</A></H3>
9577
9578 It seems that lots of unwanted email contains unencoded 8-bit characters
9579 in the Subject.
9580 Normally, characters with the 8th bit set are not allowed in the Subject
9581 header unless they are MIME-encoded.
9582 This option gives you a way to match messages that have Subjects that
9583 contain unencoded 8-bit characters.
9584 By default, the value of this option is &quot;Don't care&quot;, which
9585 will match any message.
9586 The value &quot;Yes&quot; means that there must be raw 8-bit characters in
9587 the Subject of the message in order for there to be a match,
9588 and the value &quot;No&quot; is the opposite.
9589 Setting this option will affect performance in large folders because the
9590 subject of each message in the folder has to be checked.
9591
9592 <H3><A NAME="pattern_bom">Beginning of Month</A></H3>
9593
9594 This option gives you a way to take some action once per month.
9595 By default, the value of this option is &quot;Don't care&quot;, which
9596 will always match.
9597 The value &quot;Yes&quot; means that this must be the first time Alpine has
9598 been run this month in order to count as a match,
9599 and the value &quot;No&quot; is the opposite.
9600
9601 <H3><A NAME="pattern_boy">Beginning of Year</A></H3>
9602
9603 This option gives you a way to take some action once per year.
9604 By default, the value of this option is &quot;Don't care&quot;, which
9605 will always match.
9606 The value &quot;Yes&quot; means that this must be the first time Alpine has
9607 been run this year in order to count as a match,
9608 and the value &quot;No&quot; is the opposite.
9609
9610 <H3><A NAME="pattern_abookfrom">Address in Address Books</A></H3>
9611
9612 This option gives you a way to match messages that have an address
9613 that is in one of your address books.
9614 Only the simple entries in your address books are searched.
9615 Address book distribution lists are ignored!
9616 By default, the value of this option is &quot;Don't care&quot;, which
9617 will match any message.
9618 The value &quot;Yes, in any address book&quot; means the address
9619 from the message must be in at least one of your
9620 address books in order to be a match.
9621 The value &quot;No, not in any address book&quot;
9622 means none of the addresses may
9623 be in any of your address books in order to be a match.
9624 The values &quot;Yes, in specific address books&quot; and
9625 &quot;No, not in any of specific address books&quot; are similar but instead
9626 of depending on all address books you are allowed to give a list of address
9627 books to look in.
9628 The addresses from the message that are checked for are determined by the
9629 setting you have for &quot;Types of addresses to check for in address book&quot;.
9630 If you set this to &quot;From&quot; the From address from the message will
9631 be looked up in the address book.
9632 If you set it to only &quot;To&quot; then the To addresses will be used.
9633 If any of the To addresses are in the address book then it is considered
9634 a match for &quot;Yes&quot; or not a match for &quot;No&quot;.
9635 You could set it to both From and To, in which case all of the From and To
9636 addresses are used.
9637 The &quot;Reply-To&quot; and &quot;Sender&quot; cases are a little unusual.
9638 Due to deficiencies in our tools, Reply-To uses the Reply-To address if it
9639 exists or the From address if there is no Reply-To address.
9640 Same for the Sender address.
9641 Setting this option may affect performance in large folders because the
9642 From and Reply-To of each message in the folder have to be checked.
9643
9644 <H3><A NAME="pattern_categorizer">Categorizer Command</A></H3>
9645
9646 This is a command that is run with its standard input set to the message
9647 being checked and its standard output discarded.
9648 The full directory path should be specified.
9649 The command will be run and then its exit status will be checked against
9650 the Exit Status Interval, which defaults to just the value zero.
9651 If the exit status of the command falls in the interval, it is considered
9652 a match, otherwise it is not a match.
9653 <P>
9654
9655 This option may actually be a list of commands.
9656 The first one that exists and is executable is used.
9657 That makes it possible to use the same configuration with Unix Alpine and
9658 PC-Alpine.
9659 <P>
9660
9661 If none of the commands in the list exists and is executable then the rule
9662 is <EM>not</EM> a match.
9663 If it is possible that the command may not exist, you should be careful
9664 to structure your rules so that nothing destructive
9665 happens when the command does not exist.
9666 For example, you might have a filter that filters away spam when there is
9667 a match but does nothing when there is not a match.
9668 That would continue to work correctly if the command didn't exist.
9669 However, if you have a filter that filters away spam when there is not
9670 a match and keeps it when there is a match, that would filter everything
9671 if the categorizer command didn't exist.
9672 <P>
9673 Here is an <A HREF="h_config_role_cat_cmd_example">example</A>
9674 setup for the bogofilter filter.
9675
9676 <P>
9677 &lt;End of help on this topic&gt;
9678 </BODY>
9679 </HTML>
9680 ===== h_rules_roles =====
9681 <HTML>
9682 <HEAD>
9683 <TITLE>SETUP ROLES SCREEN</TITLE>
9684 </HEAD>
9685 <BODY>
9686 <H1>SETUP ROLES SCREEN</H1>
9687 <H2>SETUP ROLES COMMANDS</H2>
9688 <!--chtml if pinemode="function_key"-->
9689 <PRE>
9690 Available  Commands -- Group 1         Available Commands -- Group 2
9691 -------------------------------        ------------------------------
9692 F1  Show Help Text                      F1  Show Help Text
9693 F2  See commands in next group          F2  See commands in next group
9694 F3  Back to MAIN Alpine menu
9695 F4  Change configuration for role
9696 F5  Move to previous role               F5  Include file in role config
9697 F6  Move to next role                   F6  Exclude file from config
9698 F7  Previous page of roles
9699 F8  Next page of roles
9700 F9  Add new role                        F9  Replicate existing role
9701 F10 Delete existing role
9702 F11 Shuffle the order of roles
9703 F12 Whereis (search role nicknames)
9704 </PRE>
9705 <!--chtml else-->
9706 <PRE>
9707 Navigation                     General Alpine Commands
9708 -------------------------      -----------------------
9709  P  Prev Role                     ?  Display this help text
9710  N  Next Role                     E  Back to MAIN Alpine menu
9711  -  Previous page
9712 Spc (space bar) Next page
9713  W  WhereIs (search for word in role nicknames)
9714
9715 Setup Roles Commands
9716 ------------------------------------------------
9717  A  Add new role                  $  Shuffle the order of roles
9718  D  Delete existing role          C  Change configuration for highlighted role
9719  R  Replicate existing role
9720  I  Include file in role config   X  Exclude file from role config
9721 </PRE>
9722 <!--chtml endif-->
9723
9724 <H2>Description of the Setup Roles Screen</H2>
9725
9726 This screen lets you add, delete, modify, or change the order of the rules
9727 that determine the role you are playing when composing a message.
9728 <P>
9729 You may play different roles depending on who you are replying to.
9730 For example, if you are replying to a message addressed to help-desk you
9731 may be acting as a Help Desk Worker.
9732 That role may require that you use a different return address and/or
9733 a different signature.
9734 <P>
9735 Roles are optional.
9736 If you set up roles they work like this:  Each role has a set of
9737 &quot;Uses&quot;, which indicate whether or not a role is eligible to be
9738 considered for a particular use; a &quot;Pattern&quot;,
9739 which is used to decide which of the eligible roles is used; and a set
9740 of &quot;Actions&quot;, which are taken when that role is used.
9741 When you reply to a message, the message you are replying to is compared
9742 with the Patterns of the roles marked as eligible for use when replying.
9743 The comparisons start with the first eligible role and keep going until there
9744 is a match.
9745 If a match is found, the matching role's Actions are taken.
9746 <P>
9747 It is also possible to set a default role and to change that role during
9748 your Alpine session.
9749 When you start Alpine no default role will be set.
9750 You may set or change the current default role by using the &quot;D&quot;
9751 command in the role selection screen.
9752 You'll see that screen while composing a message and being asked to select
9753 a role.
9754 An easy way to get to that screen is to use the <A HREF="h_common_role">Role Command</A> to
9755 compose a message.
9756 You may find a default role useful if you normally perform the duties of one
9757 of your roles for a while, then you switch to another role and stay in the
9758 new role for another period of time.
9759 It may be easier than using the Role Command to select the role each time you
9760 compose a message.
9761
9762 <H2>Role Uses</H2>
9763
9764 There are three types of use to be configured;
9765 one for Replying, one for Forwarding, and one for Composing.
9766 These indicate whether or not you want a role to be considered when you
9767 type the Reply, Forward, or Compose commands.
9768 (The Role command is an alternate form of the Compose command, and it is
9769 not affected by these settings.)
9770 Each of these Use types has three possible values.
9771 The value &quot;Never&quot;
9772 means that the role will never be considered as a candidate for use with
9773 the corresponding command.
9774 For example, if you set a role's Reply Use to Never, then when you Reply to
9775 a message, that role won't even be considered.
9776 (That isn't quite true. If the message you are replying to matches some other
9777 role that requires confirmation,
9778 then there will be a ^T command available which allows you to select a role
9779 from all of your roles, not just the reply-eligible roles.)
9780 <P>
9781
9782 The options &quot;With confirmation&quot; and &quot;Without confirmation&quot;
9783 both mean that you do want to consider this role when using the corresponding
9784 command.
9785 For either of these settings the role's Pattern will
9786 be checked to see if it matches the message.
9787 For Reply Use, the message used to compare the Pattern with is the message
9788 being replied to.
9789 For Forward Use, the message used to compare the Pattern with is the message
9790 being forwarded.
9791 For Compose Use, there is no message, so the parts of the Pattern that depend
9792 on a message (everything other than Current Folder Type) are ignored.
9793 In all cases, the Current Folder Type is checked if defined.
9794 If there is a match then this role will either be used without confirmation
9795 or will be the default when confirmation is asked for, depending on
9796 which of the two options is selected.
9797 If confirmation is requested, you will have a chance to
9798 choose No Role instead of the offered role, or to
9799 change the role to any one of your other roles (with the ^T command).
9800
9801 <H2>Role Patterns</H2>
9802
9803 In order to determine whether or not a message matches a role the message is
9804 compared with the Role's Pattern.
9805 These Patterns are the same for use with Roles, Filtering, Index Coloring,
9806 Scoring, Other Rules, and Search Rules, so are described in only one place,
9807 &quot;<A HREF="h_rule_patterns">here</A>&quot;.
9808 <P>
9809 Since header patterns, AllText patterns, and BodyText patterns that are unset are ignored,
9810 a role that has all header patterns unset, the AllText pattern unset,
9811 the BodyText pattern unset,
9812 the Score Interval unset, and the Current Folder Type set to
9813 &quot;Any&quot; may be used as a default role.
9814 It should be put last in the list of roles since the matching
9815 starts at the beginning and proceeds until one of the roles is a match.
9816 If no roles at all match, then Alpine will
9817 use its regular methods of defining the role.
9818 If you wanted to, you could define a different &quot;default&quot; role
9819 for Replying, Forwarding, and Composing by setting the
9820 &quot;Use&quot; fields appropriately.
9821
9822 <H2>Role Actions</H2>
9823
9824 Once a role match is found, the role's Actions are taken.
9825 For each role there are several possible actions that may be defined.
9826 They are actions to set the From address, the Reply-To address,
9827 the Fcc, the Signature, the Template file, and Other Headers.
9828
9829 <H3>Set From</H3>
9830
9831 The From address is the address used on the From line of the message
9832 you are sending.
9833
9834 <H3>Set Reply-To</H3>
9835
9836 The Reply-To address is the address used on the Reply-To line of the message
9837 you are sending.
9838 You don't need a Reply-To address unless it is different from the From address.
9839
9840 <H3>Set Other Headers</H3>
9841
9842 If you want to set the value of the From or Reply-To headers, use
9843 the specific fields &quot;Set From&quot; or &quot;Set Reply-To&quot;.
9844 If you want to set the values of other headers, use this field.
9845 This field is similar to the
9846 <A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A> configuration option.
9847 Each header you specify here must include the header tag
9848 (&quot;To:&quot;, &quot;Approved:&quot;, etc.)
9849 and may optionally include a value for that header.
9850 It is different from the <!--#echo var="VAR_customized-hdrs"--> in that the value you give
9851 for a header here will replace any value that already exists.
9852 For example, if you are Replying to a message there will be at least one
9853 address in the To header (the address you are Replying to).
9854 However, if you Reply using a role that sets the To header, that role's
9855 To header value will be used instead.
9856
9857 <H3>Set Fcc</H3>
9858
9859 The Fcc is used as the Fcc for the message you are sending.
9860
9861 <H3>Set Signature or Set LiteralSig</H3>
9862
9863 The Signature is the name of a file to be used as the signature file when
9864 this role is being used.
9865 If the name of the file has a vertical bar following it (|)
9866 then it is assumed that the file is a program that should be run to
9867 produce the signature.
9868 If the LiteralSig is set, then it is used instead of the signature file.
9869 LiteralSig is just a different way to store the signature.
9870 It is stored in the pine configuration file instead of in a separate
9871 signature file.
9872 If the <A HREF="h_config_literal_sig"><!--#echo var="VAR_literal-signature"--></A> option is defined
9873 either in the role or as the default signature in the Setup/Config screen,
9874 then the signature file is ignored.
9875
9876 <H3>Set Template</H3>
9877
9878 A Template is the name of a file to be included in the message when this
9879 role is being used.
9880 If the name of the file has a vertical bar following it (|)
9881 then it is assumed that the file is a program that should be run to
9882 produce the template.
9883
9884 <P>
9885 Both signature files and template files may be stored remotely on an IMAP
9886 server.
9887 In order to do that you just give the file a remote name.
9888 This works just like the regular
9889 <A HREF="h_config_signature_file"><!--#echo var="VAR_signature-file"--></A>
9890 option that is configured from the Setup/Configuration screen.
9891 A remote signature file name might look like:
9892 <P>
9893 <CENTER><SAMP>{myimaphost.myschool.k12.wa.us}mail/sig3</SAMP></CENTER>
9894 <P>
9895 Once you have named the remote signature or template file you create its
9896 contents by using the &quot;F&quot; &quot;editFile&quot; command when the
9897 cursor is on the &quot;Set Signature&quot; or &quot;Set Template&quot;
9898 line of the role editor.
9899
9900 <P>
9901 Both signature files and template files (or the output of signature programs
9902 and template file programs) may contain special tokens
9903 that are replaced with contents
9904 that depend on the message being replied to or forwarded.
9905 See the help for the individual fields inside the role editor for more
9906 information on tokens.
9907
9908 <H3>Use SMTP Server</H3>
9909
9910 If this field has a value, then it will be used as the SMTP server
9911 to send mail when this role is being used (unless the SMTP server variable
9912 is set in the system-wide fixed configuration file).
9913 It has the same semantics as the
9914 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>
9915 variable in the Setup/Config screen.
9916 When you postpone the composition this SMTP server list will be saved
9917 with the postponed composition and it cannot be changed later.
9918 Because of that, you may want to make this a list of SMTP servers
9919 with the preferred server at the front of the list and alternate servers
9920 later in the list.
9921
9922 <P>
9923 If any of the actions are left unset, then the action depends on what
9924 is present in the &quot;Initialize settings using role&quot; field.
9925 If you've listed the nickname of another one of your roles there, then the
9926 corresponding action from that role will be used here.
9927 If that action is also blank, or if there is no nickname specified,
9928 then Alpine will do whatever it normally does to set these actions.
9929 This depends on other configuration options and features you've set.
9930
9931 <H2>Command Descriptions</H2>
9932
9933 <H3>Add</H3>
9934
9935 The Add command is used to add a new role definition to your set of
9936 roles.
9937 The new role will be added after the highlighted role.
9938
9939 <H3>Delete</H3>
9940
9941 The Delete command deletes the currently highlighted role.
9942
9943 <H3>Change</H3>
9944
9945 The Change command lets you edit the nickname, Uses, Pattern,
9946 and Actions of the currently highlighted role.
9947
9948 <H3>Shuffle</H3>
9949
9950 The Shuffle command allows you to change the order of the roles.
9951 You may move the currently highlighted role up or down in the list.
9952 The order of the roles is important since the roles are tested for a
9953 match starting with the first role and continuing until a match is found.
9954 You should place the roles with more specific Patterns near the beginning
9955 of the list, and those with more general Patterns near the end so that
9956 the more specific matches will happen when appropriate.
9957
9958 <H3>Replicate</H3>
9959
9960 The Replicate command is used to copy an existing role and modify it.
9961 The new role will be added after the highlighted role.
9962
9963 <H3>IncludeFile</H3>
9964
9965 The IncludeFile command allows you to add a roles file to your configuration.
9966 Usually, your roles will be contained in your Alpine configuration file.
9967 If you wish, some or all of your roles may be stored in a separate file.
9968 If a roles file already exists (maybe it was made by somebody else using
9969 Alpine), you may insert it before the currently highlighted role.
9970 You may also insert an empty file or a file that does not yet exist.
9971 Once you have an empty roles file in your configuration, you may use
9972 the Shuffle command to move roles into it.
9973 In fact, that's the only way to get the initial role into the file.
9974
9975 <H3>eXcludeFile</H3>
9976
9977 The eXcludeFile command removes a roles file from your roles configuration.
9978 A limitation of the program is that in order to exclude a roles file
9979 that file must have at least one role
9980 in it, otherwise you won't be able to highlight a line in the file.
9981 So you may have to add a dummy role to the file in order to exclude the file.
9982 <P><UL>
9983 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
9984 </UL>
9985 <P>
9986 &lt;End of help on this topic&gt;
9987 </BODY>
9988 </HTML>
9989 ===== h_rules_other =====
9990 <HTML>
9991 <HEAD>
9992 <TITLE>SETUP OTHER RULES SCREEN</TITLE>
9993 </HEAD>
9994 <BODY>
9995 <H1>SETUP OTHER RULES SCREEN</H1>
9996 <H2>SETUP OTHER RULES COMMANDS</H2>
9997 <!--chtml if pinemode="function_key"-->
9998 <PRE>
9999 Available  Commands -- Group 1         Available Commands -- Group 2
10000 -------------------------------        ------------------------------
10001 F1  Show Help Text                      F1  Show Help Text
10002 F2  See commands in next group          F2  See commands in next group
10003 F3  Back to MAIN Alpine menu
10004 F4  Change configuration for rule
10005 F5  Move to previous rule               F5  Include file in rule config
10006 F6  Move to next rule                   F6  Exclude file from config
10007 F7  Previous page of rules
10008 F8  Next page of rules
10009 F9  Add new rule                        F9  Replicate existing rule
10010 F10 Delete existing rule
10011 F11 Shuffle the order of rules
10012 F12 Whereis (search rule nicknames)
10013 </PRE>
10014 <!--chtml else-->
10015 <PRE>
10016 Navigation                     General Alpine Commands
10017 -------------------------      -----------------------
10018  P  Prev rule                     ?  Display this help text
10019  N  Next rule                     E  Back to MAIN Alpine menu
10020  -  Previous page
10021 Spc (space bar) Next page
10022  W  WhereIs (search for word in rule nicknames)
10023
10024 Setup Other Rules Commands
10025 ------------------------------------------------
10026  A  Add new rule                  $  Shuffle the order of rules
10027  D  Delete existing rule          C  Change configuration for highlighted rule
10028  R  Replicate existing rule
10029  I  Include file in rule config   X  Exclude file from rule config
10030 </PRE>
10031 <!--chtml endif-->
10032
10033 <H2>Description of the Setup Other Rules Screen</H2>
10034
10035 This is where you may set various actions that do not fit well into the
10036 other Rules categories.
10037
10038 <H2>Patterns</H2>
10039
10040 Other Rules are a little different from the rest of the Rules because
10041 they depend only on the current folder, and not on a particular message.
10042 In order to determine whether or not a rule's actions should be applied
10043 the current folder is compared with the rule's Pattern, which consists
10044 of only the Current Folder Type.
10045 Current Folder Type works the same for Other Rules as it does for Roles,
10046 Filtering, Index Coloring, and Scoring.
10047 Keep in mind that the only part of the Pattern that applies to Other
10048 Rules is the Current Folder Type when looking at the description of
10049 Patterns given
10050 &quot;<A HREF="h_rule_patterns">here</A>&quot;.
10051
10052 <H2>The Actions</H2>
10053
10054 <H3>Set Sort Order</H3>
10055
10056 When you enter a new folder, these rules will be checked to see if you
10057 have set a sort order that is different from your default sort order.
10058 The default is set in the Setup/Config screen with
10059 the &quot;<A HREF="h_config_sort_key"><!--#echo var="VAR_sort-key"--></A>&quot; option.
10060 If the Sort Order action is set, then the folder will be displayed sorted in
10061 that sort order instead of in the default order.
10062 <P>
10063 A possible point of confusion arises when you change the configuration
10064 of the Sort Order for the currently open folder.
10065 The folder will normally be re-sorted when you go back to viewing the
10066 index.
10067 However, if you have manually sorted the folder with the
10068 Sort
10069 (<!--chtml if pinemode="function_key"-->F7<!--chtml else-->$<!--chtml endif-->)
10070 command, then it will not be re-sorted until the next time it is opened.
10071
10072 <H3>Set Index Format</H3>
10073
10074 When you enter a new folder, these rules will be checked to see if you
10075 have set an Index Format that is different from your default Index Format,
10076 which is set with the
10077 <A HREF="h_config_index_format">&quot;<!--#echo var="VAR_index-format"-->&quot;</A> option.
10078 If so, the index will be displayed with this format instead of the default.
10079
10080 <H3>Set Startup Rule</H3>
10081
10082 When you enter a new folder, these rules will be checked to see if you
10083 have set a startup rule that is different from the default startup rule.
10084 The default for incoming folders is set in the Setup/Config screen with
10085 the &quot;<!--#echo var="VAR_incoming-startup-rule"-->&quot; option.
10086 The default for folders other than INBOX that are not part of your
10087 incoming collection
10088 (see <A HREF="h_config_enable_incoming"><!--#echo var="FEAT_enable-incoming-folders"--></A> feature)
10089 is to start with the last message in the folder.
10090 If the Startup Rule is set to something other than &quot;default&quot;,
10091 then the rule will determine which message will be the current message when
10092 the folder is first opened.
10093 <P>
10094 The various startup rule possibilities work the same here as they do in
10095 the incoming collection, so check
10096 <A HREF="h_config_inc_startup"><!--#echo var="VAR_incoming-startup-rule"--></A>
10097 for more help.
10098
10099 <H2>Command Descriptions</H2>
10100
10101 <H3>Add</H3>
10102
10103 The Add command is used to add a new rule definition to your set of
10104 rules.
10105 The new rule will be added after the highlighted rule.
10106
10107 <H3>Delete</H3>
10108
10109 The Delete command deletes the currently highlighted rule.
10110
10111 <H3>Change</H3>
10112
10113 The Change command lets you edit the nickname, Pattern,
10114 and Action of the currently highlighted rule.
10115
10116 <H3>Shuffle</H3>
10117
10118 The Shuffle command allows you to change the order of the rules.
10119 You may move the currently highlighted rule up or down in the list.
10120 The order of the rules is important since the rules are tested for a
10121 match starting with the first rule and continuing until a match is found.
10122 You should place the rules with more specific Patterns near the beginning
10123 of the list, and those with more general Patterns near the end so that
10124 the more specific matches will happen when appropriate.
10125
10126 <H3>Replicate</H3>
10127
10128 The Replicate command is used to copy an existing rule definition and modify it.
10129 The new rule will be added after the highlighted rule.
10130
10131 <H3>IncludeFile</H3>
10132
10133 The IncludeFile command allows you to add a rules file to your configuration.
10134 Usually, your rules will be contained in your Alpine configuration file.
10135 If you wish, some or all of your rules may be stored in a separate file.
10136 If a rules file already exists (maybe it was made by somebody else using
10137 Alpine), you may insert it before the currently highlighted rule.
10138 You may also insert an empty file or a file that does not yet exist.
10139 Once you have an empty rules file in your configuration, you may use
10140 the Shuffle command to move rules into it.
10141 In fact, that's the only way to get the initial rule into the file.
10142
10143 <H3>eXcludeFile</H3>
10144
10145 The eXcludeFile command removes a rules file from your rules configuration.
10146 A limitation of the program is that in order to exclude a rules file
10147 that file must have at least one rule
10148 in it, otherwise you won't be able to highlight a line in the file.
10149 So you may have to add a dummy rule to the file in order to exclude the file.
10150 <P><UL>
10151 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
10152 </UL>
10153 <P>
10154 &lt;End of help on this topic&gt;
10155 </BODY>
10156 </HTML>
10157 ===== h_rules_srch =====
10158 <HTML>
10159 <HEAD>
10160 <TITLE>SETUP SEARCH RULES SCREEN</TITLE>
10161 </HEAD>
10162 <BODY>
10163 <H1>SETUP SEARCH RULES SCREEN</H1>
10164 <H2>SETUP SEARCH RULES COMMANDS</H2>
10165 <!--chtml if pinemode="function_key"-->
10166 <PRE>
10167 Available  Commands -- Group 1         Available Commands -- Group 2
10168 -------------------------------        ------------------------------
10169 F1  Show Help Text                      F1  Show Help Text
10170 F2  See commands in next group          F2  See commands in next group
10171 F3  Back to MAIN Alpine menu
10172 F4  Change configuration for rule
10173 F5  Move to previous rule               F5  Include file in rule config
10174 F6  Move to next rule                   F6  Exclude file from config
10175 F7  Previous page of rules
10176 F8  Next page of rules
10177 F9  Add new rule                        F9  Replicate existing rule
10178 F10 Delete existing rule
10179 F11 Shuffle the order of rules
10180 F12 Whereis (search rule nicknames)
10181 </PRE>
10182 <!--chtml else-->
10183 <PRE>
10184 Navigation                     General Alpine Commands
10185 -------------------------      -----------------------
10186  P  Prev rule                     ?  Display this help text
10187  N  Next rule                     E  Back to MAIN Alpine menu
10188  -  Previous page
10189 Spc (space bar) Next page
10190  W  WhereIs (search for word in rule nicknames)
10191
10192 Setup Search Rules Commands
10193 ------------------------------------------------
10194  A  Add new rule                  $  Shuffle the order of rules
10195  D  Delete existing rule          C  Change configuration for highlighted rule
10196  R  Replicate existing rule
10197  I  Include file in rule config   X  Exclude file from rule config
10198 </PRE>
10199 <!--chtml endif-->
10200
10201 <H2>Description of the Setup Search Rules Screen</H2>
10202
10203 One of the commands that becomes available when that feature is turned on
10204 is the &quot;; Select&quot; command, which is used in the MESSAGE INDEX
10205 screen to select a set of messages.
10206 One way of selecting messages is to use a Rule.
10207 All of the messages that match (or don't match if you wish)
10208 a Rule's Pattern will be selected.
10209 <P>
10210 Any of your Rules may be used for this purpose.
10211 You might already have Rules set up for filtering, index line color, scores, or roles;
10212 and you may use any of those Rules with the Select command.
10213 However, you might find it more convenient to set up a separate set of Rules
10214 just for this purpose without having to worry about what other effects
10215 they may cause.
10216 That is the purpose of these Select Rules.
10217
10218 <P>
10219 Each rule has a &quot;Pattern&quot;
10220 that is used to decide which messages are selected when you use it with
10221 the Select command.
10222
10223 <H2>Patterns</H2>
10224
10225 In order to determine whether or not a message should be selected
10226 the message is compared with the rule's Pattern.
10227 These Patterns are the same for use with Roles, Filtering, Index Coloring,
10228 Scoring, Other Rules, and Search Rules, so are described in only one place,
10229 &quot;<A HREF="h_rule_patterns">here</A>&quot;.
10230
10231 <H2>Command Descriptions</H2>
10232
10233 <H3>Add</H3>
10234
10235 The Add command is used to add a new rule definition to your set of
10236 rules.
10237 The new rule will be added after the highlighted rule.
10238
10239 <H3>Delete</H3>
10240
10241 The Delete command deletes the currently highlighted rule.
10242
10243 <H3>Change</H3>
10244
10245 The Change command lets you edit the nickname and Pattern
10246 of the currently highlighted rule.
10247
10248 <H3>Shuffle</H3>
10249
10250 The Shuffle command allows you to change the order of the rules.
10251 This affects only the order they are presented in when you use the
10252 ^T subcommand of the Select by Rule command.
10253 You may move the currently highlighted rule up or down in the list.
10254
10255 <H3>Replicate</H3>
10256
10257 The Replicate command is used to copy an existing rule definition and modify it.
10258 The new rule will be added after the highlighted rule.
10259
10260 <H3>IncludeFile</H3>
10261
10262 The IncludeFile command allows you to add a rules file to your configuration.
10263 Usually, your rules will be contained in your Alpine configuration file.
10264 If you wish, some or all of your rules may be stored in a separate file.
10265 If a rules file already exists (maybe it was made by somebody else using
10266 Alpine), you may insert it before the currently highlighted rule.
10267 You may also insert an empty file or a file that does not yet exist.
10268 Once you have an empty rules file in your configuration, you may use
10269 the Shuffle command to move rules into it.
10270 In fact, that's the only way to get the initial rule into the file.
10271
10272 <H3>eXcludeFile</H3>
10273
10274 The eXcludeFile command removes a rules file from your rules configuration.
10275 A limitation of the program is that in order to exclude a rules file
10276 that file must have at least one rule
10277 in it, otherwise you won't be able to highlight a line in the file.
10278 So you may have to add a dummy rule to the file in order to exclude the file.
10279 <P><UL>
10280 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
10281 </UL>
10282 <P>
10283 &lt;End of help on this topic&gt;
10284 </BODY>
10285 </HTML>
10286 ===== h_rules_incols =====
10287 <HTML>
10288 <HEAD>
10289 <TITLE>SETUP INDEX LINE COLORS SCREEN</TITLE>
10290 </HEAD>
10291 <BODY>
10292 <H1>SETUP INDEX LINE COLORS SCREEN</H1>
10293 <H2>SETUP INDEX LINE COLORS COMMANDS</H2>
10294 <!--chtml if pinemode="function_key"-->
10295 <PRE>
10296 Available  Commands -- Group 1         Available Commands -- Group 2
10297 -------------------------------        ------------------------------
10298 F1  Show Help Text                      F1  Show Help Text
10299 F2  See commands in next group          F2  See commands in next group
10300 F3  Back to MAIN Alpine menu
10301 F4  Change configuration for rule
10302 F5  Move to previous rule               F5  Include file in rule config
10303 F6  Move to next rule                   F6  Exclude file from config
10304 F7  Previous page of rules
10305 F8  Next page of rules
10306 F9  Add new rule                        F9  Replicate existing rule
10307 F10 Delete existing rule
10308 F11 Shuffle the order of rules
10309 F12 Whereis (search rule nicknames)
10310 </PRE>
10311 <!--chtml else-->
10312 <PRE>
10313 Navigation                     General Alpine Commands
10314 -------------------------      -----------------------
10315  P  Prev rule                     ?  Display this help text
10316  N  Next rule                     E  Back to MAIN Alpine menu
10317  -  Previous page
10318 Spc (space bar) Next page
10319  W  WhereIs (search for word in rule nicknames)
10320
10321 Setup Index Color Commands
10322 ------------------------------------------------
10323  A  Add new rule                  $  Shuffle the order of rules
10324  D  Delete existing rule          C  Change configuration for highlighted rule
10325  R  Replicate existing rule
10326  I  Include file in rule config   X  Exclude file from rule config
10327 </PRE>
10328 <!--chtml endif-->
10329
10330 <H2>Description of the Setup Index Line Colors Screen</H2>
10331
10332 Index Line Color causes lines in the MESSAGE INDEX screen to be colored.
10333 This action is only available if your terminal is capable of displaying
10334 color and color display has been enabled with the
10335 <A HREF="h_config_color_style">Color Style</A> option within the
10336 Setup Color screen.
10337 (In PC-Alpine, color is always enabled so there is no option to turn on.)
10338 This screen lets you add, delete, modify, or change the order of the rules
10339 that cause the lines in the MESSAGE INDEX to be displayed in different
10340 colors.
10341 <P>
10342 Each rule has a &quot;Pattern&quot;,
10343 which is used to decide which of the rules is used; and the color that
10344 is used if the Pattern matches a particular message.
10345
10346 <H2>Index Color Patterns</H2>
10347
10348 In order to determine whether or not a message matches an Index Color Rule
10349 the message is compared with the rule's Pattern.
10350 These Patterns are the same for use with Roles, Filtering, Index Coloring,
10351 Scoring, Other Rules, and Search Rules, so are described in only one place,
10352 &quot;<A HREF="h_rule_patterns">here</A>&quot;.
10353
10354 <P>
10355 If none of the Index Color rules is a match for a particular index line,
10356 then the color used is set using
10357 the <A HREF="h_color_setup">Setup Kolor</A> screen.
10358
10359 <H2>Index Line Color</H2>
10360
10361 This is the color that index lines are colored when there is a matching
10362 Pattern.
10363 This colors the whole index line, except possibly the status letters,
10364 which may be colored separately using
10365 the <A HREF="h_color_setup">Setup Kolor</A> screen.
10366
10367 <H2>Command Descriptions</H2>
10368
10369 <H3>Add</H3>
10370
10371 The Add command is used to add a new rule definition to your set of
10372 rules.
10373 The new rule will be added after the highlighted rule.
10374
10375 <H3>Delete</H3>
10376
10377 The Delete command deletes the currently highlighted rule.
10378
10379 <H3>Change</H3>
10380
10381 The Change command lets you edit the nickname, Pattern,
10382 and Index Line Color of the currently highlighted rule.
10383
10384 <H3>Shuffle</H3>
10385
10386 The Shuffle command allows you to change the order of the rules.
10387 You may move the currently highlighted rule up or down in the list.
10388 The order of the rules is important since the rules are tested for a
10389 match starting with the first rule and continuing until a match is found.
10390 You should place the rules with more specific Patterns near the beginning
10391 of the list, and those with more general Patterns near the end so that
10392 the more specific matches will happen when appropriate.
10393
10394 <H3>Replicate</H3>
10395
10396 The Replicate command is used to copy an existing rule definition and modify it.
10397 The new rule will be added after the highlighted rule.
10398
10399 <H3>IncludeFile</H3>
10400
10401 The IncludeFile command allows you to add a rules file to your configuration.
10402 Usually, your rules will be contained in your Alpine configuration file.
10403 If you wish, some or all of your rules may be stored in a separate file.
10404 If a rules file already exists (maybe it was made by somebody else using
10405 Alpine), you may insert it before the currently highlighted rule.
10406 You may also insert an empty file or a file that does not yet exist.
10407 Once you have an empty rules file in your configuration, you may use
10408 the Shuffle command to move rules into it.
10409 In fact, that's the only way to get the initial rule into the file.
10410
10411 <H3>eXcludeFile</H3>
10412
10413 The eXcludeFile command removes a rules file from your rules configuration.
10414 A limitation of the program is that in order to exclude a rules file
10415 that file must have at least one rule
10416 in it, otherwise you won't be able to highlight a line in the file.
10417 So you may have to add a dummy rule to the file in order to exclude the file.
10418 <P><UL>
10419 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
10420 </UL>
10421 <P>
10422 &lt;End of help on this topic&gt;
10423 </BODY>
10424 </HTML>
10425 ===== h_rules_filter =====
10426 <HTML>
10427 <HEAD>
10428 <TITLE>SETUP FILTERING SCREEN</TITLE>
10429 </HEAD>
10430 <BODY>
10431 <H1>SETUP FILTERING SCREEN</H1>
10432 <H2>SETUP FILTERING COMMANDS</H2>
10433 <!--chtml if pinemode="function_key"-->
10434 <PRE>
10435 Available  Commands -- Group 1         Available Commands -- Group 2
10436 -------------------------------        ------------------------------
10437 F1  Show Help Text                      F1  Show Help Text
10438 F2  See commands in next group          F2  See commands in next group
10439 F3  Back to MAIN Alpine menu
10440 F4  Change configuration for filter
10441 F5  Move to previous filter             F5  Include file in filter config
10442 F6  Move to next filter                 F6  Exclude file from config
10443 F7  Previous page of filters
10444 F8  Next page of filters
10445 F9  Add new filter                      F9  Replicate existing filter
10446 F10 Delete existing filter
10447 F11 Shuffle the order of filters
10448 F12 Whereis (search filter nicknames)
10449 </PRE>
10450 <!--chtml else-->
10451 <PRE>
10452 Navigation                     General Alpine Commands
10453 -------------------------      -----------------------
10454  P  Prev Filter                   ?  Display this help text
10455  N  Next Filter                   E  Back to MAIN Alpine menu
10456  -  Previous page
10457 Spc (space bar) Next page
10458  W  WhereIs (search for word in filter nicknames)
10459
10460 Setup Filters Commands
10461 ------------------------------------------------
10462  A  Add new filter                $  Shuffle the order of filters
10463  D  Delete existing filter        C  Change configuration for highlighted filter
10464  R  Replicate existing filter
10465  I  Include file in filter config X  Exclude file from filter config
10466 </PRE>
10467 <!--chtml endif-->
10468
10469 <H2>Description of the Setup Filtering Screen</H2>
10470
10471 This screen lets you add, delete, modify, or change the order of the rules
10472 that determine the filtering Alpine does on folders you view.
10473 <P>
10474 The software that actually delivers mail (the stuff that happens
10475 before Alpine is involved) for you is in a better position to do mail filtering
10476 than Alpine itself.
10477 If possible, you may want to look into using that sort of mail filtering to
10478 deliver mail to different folders, delete it, or forward it.
10479 However, if you'd like Alpine to help with this, Alpine's filtering is for you.
10480 <P>
10481 Filtering is a way to automatically move certain messages from one folder
10482 to another or to delete messages.
10483 It can also be used to set message status (Important, Deleted, New,
10484 Answered) and to set <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> for messages.
10485 Alpine doesn't have the ability to forward mail to another address or
10486 to deliver vacation messages.
10487 <P>
10488 Each filtering rule has a &quot;Pattern&quot; and a &quot;Filter Action&quot;.
10489 When a folder is opened, when new mail arrives in an open folder, or
10490 when mail is Expunged from a folder; each
10491 message is compared with the Patterns of your filtering rules.
10492 The comparisons start with the first rule and keep going until there
10493 is a match.
10494 If a match is found, the message may be deleted or moved, depending on
10495 the setting of the Filter Action.
10496 If the message is not deleted, it may have its status altered.
10497
10498 <P>
10499 <EM>NOTE:</EM>
10500 When setting up a Pattern used to delete messages,
10501 it is recommended that you test the Pattern first with a &quot;Move&quot;
10502 folder specified in
10503 case unintended matches occur.  Messages that are deleted will be removed
10504 from the folder and <EM>unrecoverable</EM> from within Alpine after the
10505 next Expunge command or once the folder being filtered has been closed.
10506
10507 <H2>Filter Patterns</H2>
10508
10509 In order to determine whether or not a message matches a filter the message is
10510 compared with the Filter's Pattern.
10511 These Patterns are the same for use with Roles, Filtering, Index Coloring,
10512 Scoring, Other Rules, and Search Rules, so are described in only one place,
10513 &quot;<A HREF="h_rule_patterns">here</A>&quot;.
10514 <P>
10515 Since filtering is a potentially destructive action, if you have a filtering
10516 Pattern with nothing other than Current Folder Type set, that filtering
10517 rule is ignored.
10518
10519 <H2>Filter Actions</H2>
10520
10521 Once a filter match is found for a particular message, there are some actions
10522 that may be taken.
10523 First, the message may have its status changed.
10524 This is the same message status that you can manipulate manually using the
10525 <a href="h_common_flag">Flag Command</a>.
10526 There are always four elements of message status that you can control.
10527 You can set or clear the Important status, the New status, the Deleted
10528 status, and the Answered status.
10529 Of course, if the filter is going to delete the message,
10530 then there is no point in setting message status.
10531 You may also be able to set user-defined keywords for a message.
10532 Read a little about keywords in the help text for the
10533 <A HREF="h_common_flag">Flag</A> command.
10534 <P>
10535 Second, the filter may delete or move the message.
10536 Deleting the message marks it Deleted and removes it from view.
10537 It is effectively gone forever (though it technically is still there until
10538 the next expunge command, which may happen implicitly).
10539 Moving the message moves it from the open folder into the folder
10540 listed on the &quot;Folder List&quot; line of the filter configuration.
10541 If you list more than one folder name (separated by commas) then the message
10542 will be copied to each of those folders.
10543 In any case, if &quot;Delete&quot; or &quot;Move&quot; is set then the
10544 message is removed from the current folder.
10545 If you just want to set the messages status without deleting it from
10546 the folder, then set the filter action to
10547 &quot;Just Set Message Status&quot;.
10548 <P>
10549 (There is no way to do a Copy instead of a Move, due to the difficulties
10550 involved in keeping track of whether or not a message has
10551 already been copied.)
10552
10553 <H2>Command Descriptions</H2>
10554
10555 <H3>Add</H3>
10556
10557 The Add command is used to add a new filter definition to your set of
10558 filters.
10559 The new filter will be added after the highlighted filter.
10560
10561 <H3>Delete</H3>
10562
10563 The Delete command deletes the currently highlighted filter.
10564
10565 <H3>Change</H3>
10566
10567 The Change command lets you edit the nickname, Pattern,
10568 and Folder of the currently highlighted filter.
10569
10570 <H3>Shuffle</H3>
10571
10572 The Shuffle command allows you to change the order of the filters.
10573 You may move the currently highlighted filter up or down in the list.
10574 The order of the filters is important since the filters are tested for a
10575 match starting with the first filter and continuing until a match is found.
10576 You should place the filters with more specific Patterns near the beginning
10577 of the list, and those with more general Patterns near the end so that
10578 the more specific matches will happen when appropriate.
10579
10580 <H3>Replicate</H3>
10581
10582 The Replicate command is used to copy an existing filter and modify it.
10583 The new filter will be added after the highlighted filter.
10584
10585 <H3>IncludeFile</H3>
10586
10587 The IncludeFile command allows you to add a filters file to your configuration.
10588 Usually, your filters will be contained in your Alpine configuration file.
10589 If you wish, some or all of your filters may be stored in a separate file.
10590 If a filters file already exists (maybe it was made by somebody else using
10591 Alpine), you may insert it before the currently highlighted filter.
10592 You may also insert an empty file or a file that does not yet exist.
10593 Once you have an empty filters file in your configuration, you may use
10594 the Shuffle command to move filters into it.
10595 In fact, that's the only way to get the initial filter into the file.
10596
10597 <H3>eXcludeFile</H3>
10598
10599 The eXcludeFile command removes a filters file from your filters configuration.
10600 A limitation of the program is that in order to exclude a filters file
10601 that file must have at least one filter
10602 in it, otherwise you won't be able to highlight a line in the file.
10603 So you may have to add a dummy filter to the file in order to exclude the file.
10604 <P><UL>
10605 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
10606 </UL>
10607 <P>
10608 <H3>Performance Considerations</H3>
10609 The number and type of patterns being tested can
10610 adversely effect performance.  Issues to be aware
10611 of include:
10612 <P>
10613 <UL>
10614   <LI> The more filters you have defined the longer it will take to run down
10615 the list.  Deleting unused filters is a good idea.
10616   <LI> Filtering in newsgroups served by an NNTP server will be slow
10617 if your patterns include tests other than &quot;From:&quot;
10618 or &quot;Subject:&quot;.
10619 </UL>
10620 <P>
10621 &lt;End of help on this topic&gt;
10622 </BODY>
10623 </HTML>
10624 ===== h_rules_score =====
10625 <HTML>
10626 <HEAD>
10627 <TITLE>SETUP SCORING SCREEN</TITLE>
10628 </HEAD>
10629 <BODY>
10630 <H1>SETUP SCORING SCREEN</H1>
10631 <H2>SETUP SCORING COMMANDS</H2>
10632 <!--chtml if pinemode="function_key"-->
10633 <PRE>
10634 Available  Commands -- Group 1         Available Commands -- Group 2
10635 -------------------------------        ------------------------------
10636 F1  Show Help Text                      F1  Show Help Text
10637 F2  See commands in next group          F2  See commands in next group
10638 F3  Back to MAIN Alpine menu
10639 F4  Change configuration for rule
10640 F5  Move to previous rule               F5  Include file in rule config
10641 F6  Move to next rule                   F6  Exclude file from config
10642 F7  Previous page of rules
10643 F8  Next page of rules
10644 F9  Add new rule                        F9  Replicate existing rule
10645 F10 Delete existing rule
10646 F11 Shuffle the order of rules
10647 F12 Whereis (search rule nicknames)
10648 </PRE>
10649 <!--chtml else-->
10650 <PRE>
10651 Navigation                     General Alpine Commands
10652 -------------------------      -----------------------
10653  P  Prev rule                     ?  Display this help text
10654  N  Next rule                     E  Back to MAIN Alpine menu
10655  -  Previous page
10656 Spc (space bar) Next page
10657  W  WhereIs (search for word in rule nicknames)
10658
10659 Setup Scoring Commands
10660 ------------------------------------------------
10661  A  Add new rule                  $  Shuffle the order of rules
10662  D  Delete existing rule          C  Change configuration for highlighted rule
10663  R  Replicate existing rule
10664  I  Include file in rule config   X  Exclude file from rule config
10665 </PRE>
10666 <!--chtml endif-->
10667
10668 <H2>Description of the Setup Scoring Screen</H2>
10669
10670 Most people will not use scores at all, but if you do use them, here's how
10671 they work in Alpine.
10672 Using this screen, you may define Scoring rules.
10673 The score for a message is calculated by looking at every Score rule defined
10674 and adding up the Score Values for the ones that match the message.
10675 If there are no matches for a message, it has a score of zero.
10676 Message scores may be used a couple of ways in Alpine.
10677
10678 <H3>Sorting by Score</H3>
10679
10680 One of the methods you may use to sort message indexes is to sort by
10681 score.
10682 The scores of all the messages in a folder will be calculated and then
10683 the index will be ordered by placing the messages in order of ascending or
10684 descending score.
10685
10686 <H3>Scores for use in Patterns</H3>
10687
10688 The Patterns used for Roles, Index Line Coloring, and Filtering have a
10689 category labeled &quot;Score Interval&quot;.
10690 When a message is being compared with a Pattern to check for a match, if
10691 the Score Interval is set only messages that have a score somewhere in
10692 the interval are a match.
10693
10694 <H2>Scoring Rule Patterns</H2>
10695
10696 In order to determine whether or not a message matches a scoring rule
10697 the message is compared with the rule's Pattern.
10698 These Patterns are the same for use with Roles, Filtering, Index Coloring,
10699 Scoring, Other Rules, and Search Rules, so are described in only one place,
10700 &quot;<A HREF="h_rule_patterns">here</A>&quot;.
10701
10702 <P>
10703 Actually, Scoring rule Patterns are slightly different from the other types of
10704 Patterns because Scoring rule Patterns don't contain a Score Interval.
10705 In other words, when calculating the score for a message, which is done
10706 by looking at the Scoring rule Patterns, scores aren't used.
10707
10708 <H2>Score Value</H2>
10709
10710 This is the value that will be added to the score for a message if the
10711 rule's Pattern is a match.
10712 Each individual Score Value is an integer between -100 and 100, and the
10713 values from matching rules are added together to get a message's score.
10714 There is also a way to extract the value from a particular header of each
10715 message. See the help text for Score Value for further information.
10716
10717 <H2>Command Descriptions</H2>
10718
10719 <H3>Add</H3>
10720
10721 The Add command is used to add a new scoring rule definition.
10722 The new rule will be added after the highlighted rule.
10723
10724 <H3>Delete</H3>
10725
10726 The Delete command deletes the currently highlighted scoring rule.
10727
10728 <H3>Change</H3>
10729
10730 The Change command lets you edit the nickname, Pattern,
10731 and Score Value of the currently highlighted scoring rule.
10732
10733 <H3>Shuffle</H3>
10734
10735 The Shuffle command allows you to change the order of the scoring rules.
10736 You may move the currently highlighted rule up or down in the list.
10737 The order of the rules is important since the rules are tested for a
10738 match starting with the first rule and continuing until a match is found.
10739 You should place the rules with more specific Patterns near the beginning
10740 of the list, and those with more general Patterns near the end so that
10741 the more specific matches will happen when appropriate.
10742
10743 <H3>Replicate</H3>
10744
10745 The Replicate command is used to copy an existing rule and modify it.
10746 The new rule will be added after the highlighted rule.
10747
10748 <H3>IncludeFile</H3>
10749
10750 The IncludeFile command allows you to add a rules file to your configuration.
10751 Usually, your rules will be contained in your Alpine configuration file.
10752 If you wish, some or all of your rules may be stored in a separate file.
10753 If a rules file already exists (maybe it was made by somebody else using
10754 Alpine), you may insert it before the currently highlighted rule.
10755 You may also insert an empty file or a file that does not yet exist.
10756 Once you have an empty rules file in your configuration, you may use
10757 the Shuffle command to move rules into it.
10758 In fact, that's the only way to get the initial rule into the file.
10759
10760 <H3>eXcludeFile</H3>
10761
10762 The eXcludeFile command removes a rules file from your rules configuration.
10763 A limitation of the program is that in order to exclude a rules file
10764 that file must have at least one rule
10765 in it, otherwise you won't be able to highlight a line in the file.
10766 So you may have to add a dummy rule to the file in order to exclude the file.
10767 <P><UL>
10768 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
10769 </UL>
10770 <P>
10771 &lt;End of help on this topic&gt;
10772 </BODY>
10773 </HTML>
10774 ===== h_direct_config =====
10775 <HTML>
10776 <HEAD>
10777 <TITLE>SETUP LDAP DIRECTORY SERVERS SCREEN</TITLE>
10778 </HEAD>
10779 <BODY>
10780 <H1>SETUP LDAP DIRECTORY SERVERS SCREEN</H1>
10781 <H2>SETUP LDAP DIRECTORY SERVERS COMMANDS</H2>
10782 <!--chtml if pinemode="function_key"-->
10783 <PRE>
10784 Available  Commands
10785 -------------------------------
10786 F1  Show Help Text
10787 F3  Back to MAIN Alpine menu
10788 F4  Change configuration for directory server
10789 F5  Move to previous directory server
10790 F6  Move to next directory server
10791 F7  Previous page of directory servers
10792 F8  Next page of directory servers
10793 F9  Add new directory server
10794 F10 Delete existing directory server
10795 F11 Shuffle the order of directory servers
10796 F12 Whereis (search directory server titles)
10797 </PRE>
10798 <!--chtml else-->
10799 <PRE>
10800 Navigation                     General Alpine Commands
10801 -------------------------      -----------------------
10802  P  Prev Directory Server         ?  Display this help text
10803  N  Next Directory Server         E  Back to MAIN Alpine menu
10804  -  Previous page
10805 Spc (space bar) Next page
10806  W  WhereIs (search for word in directory server titles)
10807
10808 Setup LDAP Directory Server Commands
10809 ------------------------------------------------
10810  A  Add new directory server      $  Shuffle the order of directory servers
10811  D  Delete existing dir server    C  Change configuration for highlighted server
10812 </PRE>
10813 <!--chtml endif-->
10814
10815 <H2>Description of the Setup LDAP Directory Servers Screen</H2>
10816
10817 This screen lets you add, delete, modify, or change the order of your
10818 directory servers. You may also set some optional behavior for each server.
10819 The &quot;Add Dir&quot; command brings up a blank form to
10820 fill in. You will have to supply at least the name of the LDAP server.
10821 You will often have to supply a search base to be used with that server,
10822 as well. Once the form has been brought up on your screen, there is help
10823 available for each of the options you may set.
10824 <P>
10825 The &quot;Del Dir&quot; command allows you to remove a directory server
10826 from your configuration.
10827 <P>
10828 The &quot;Change&quot; command is similar to the &quot;Add Dir&quot; command.
10829 The difference is that instead of bringing up a form for a new server
10830 configuration, you are changing the configuration of an existing entry.
10831 For example, you might want to correct a typing error, change a
10832 nickname, or change one of the options set for that server.
10833 <P>
10834 The &quot;Shuffle&quot; command is used to change the order of directory
10835 servers.
10836 <P><UL>
10837 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
10838 </UL>
10839 <P>
10840 &lt;End of help on this topic&gt;
10841 </BODY>
10842 </HTML>
10843 ============= h_address_display ========================
10844 <HTML>
10845 <HEAD>
10846 <TITLE>SEARCH RESULTS INDEX</TITLE>
10847 </HEAD>
10848 <BODY>
10849 <H1>SEARCH RESULTS INDEX</H1>
10850 This screen shows the results, if any, of your Directory Server search.
10851 Commands (besides those for screen navigation) are:
10852 <DL>
10853 <DT>View
10854 <!--chtml if pinemode="function_key"-->
10855 (F4)
10856 <!--chtml else-->
10857 (V)
10858 <!--chtml endif-->
10859 </DT>
10860 <DD>See the full information for the selected entry.
10861
10862 <DT>Compose
10863 <!--chtml if pinemode="function_key"-->
10864 (F9)
10865 <!--chtml else-->
10866 (C)
10867 <!--chtml endif--></DT>
10868 <DD>Compose a message with the selected entry as the recipient.
10869
10870 <DT>Role
10871 <!--chtml if pinemode="function_key"-->
10872 (F2)
10873 <!--chtml else-->
10874 (#)
10875 <!--chtml endif--></DT>
10876 <DD>Compose a message with the selected entry as the recipient. This differs
10877 from Compose in that you may select a role before beginning your composition.
10878
10879 <DT>Forward
10880 <!--chtml if pinemode="function_key"-->
10881 (F10)
10882 <!--chtml else-->
10883 (F)
10884 <!--chtml endif--></DT>
10885 <DD>Send the full information for the selected entry as an
10886 email message to someone else.
10887
10888 <DT>Save
10889 <!--chtml if pinemode="function_key"-->
10890 (F11)
10891 <!--chtml else-->
10892 (S)
10893 <!--chtml endif-->
10894 </DT>
10895 <DD>Save to your address book:
10896 <UL>
10897 <LI>the result of the search (as just found through your query) for the
10898 selected entry; or
10899 <LI>the selected entry for repeated Directory Server searching when used
10900 in the future.
10901 </UL>
10902 or<BR>
10903 Export to a file (external to Alpine):
10904 <UL>
10905 <LI>the full information for the selected entry; or
10906 <LI>the email address from the selected entry; or
10907 <LI>the selected entry in <A HREF="h_whatis_vcard">vCard</A> format.
10908 </UL>
10909 <DT>WhereIs
10910 <!--chtml if pinemode="function_key"-->
10911 (F12)
10912 <!--chtml else-->
10913 (W)
10914 <!--chtml endif-->
10915 </DT>
10916 <DD>Search for text in the SEARCH RESULTS INDEX screen. (Searches only the
10917 displayed text, not the full records for each entry.)
10918 </DL>
10919 &lt;End of help on this topic&gt;
10920 </BODY>
10921 </HTML>
10922 ============= h_address_select ========================
10923 <HTML>
10924 <HEAD>
10925 <TITLE>SEARCH RESULTS INDEX</TITLE>
10926 </HEAD>
10927 <BODY>
10928 <H1>SEARCH RESULTS INDEX</H1>
10929 This screen shows the results, if any, of your Directory Server search.
10930 Commands (besides those for screen navigation) are:
10931 <DL>
10932 <DT>Select
10933 </DT>
10934 <DD>Select this entry for use.
10935
10936 <DT>ExitSelect
10937 <DD>Exit without selecting any of the entries.
10938
10939 <DT>WhereIs
10940 </DT>
10941 <DD>Search for text in the SEARCH RESULTS INDEX screen. (Searches only the
10942 displayed text, not the full records for each entry.)
10943 </DL>
10944 &lt;End of help on this topic&gt;
10945 </BODY>
10946 </HTML>
10947 ===== h_folder_maint =====
10948 <HTML>
10949 <HEAD>
10950 <TITLE>Help for Folder List</TITLE>
10951 </HEAD>
10952 <BODY>
10953 <H1>FOLDER LIST COMMANDS</H1>
10954 <!--chtml if pinemode="function_key"-->
10955 <PRE>
10956 Available Commands -- Group 1        Available Commands -- Group 2
10957 -------------------------------      ------------------------------
10958 F1  Show Help Text                    F1  Show Help Text
10959 F2  See commands in next group        F2  See commands in next group
10960 F3  MAIN MENU Screen                  F3  Quit Alpine
10961 F4  Select folder and view it         F4  MAIN MENU Screen
10962 F5  Move to previous folder
10963 F6  Move to next folder               F6  Specify a folder to go to
10964 F7  Show previous screen of listing   F7  Show MESSAGE INDEX of current folder
10965 F8  Show next screen of listing       F8  Compose a message
10966 F9  Add a new folder                  F9  Print folder listing
10967 F10 Delete selected folder
10968 F11 Rename selected folder
10969 F12 Whereis (search folder names)
10970
10971 Available Commands -- Group 3
10972 F1  Show Help Text
10973 F2  See commands in next group
10974 F5  Go to next new message
10975     (or count recent messages if <A HREF="h_config_tab_checks_recent"><!--#echo var="FEAT_tab-checks-recent"--></A> is set)
10976 F8  Compose a message using roles
10977 F9  Export folder to a file
10978 F10 Import the file back to a folder
10979 </PRE>
10980 <!--chtml else-->
10981 <PRE>
10982 Navigating the Folder Screen            Operations on the Selected Folder
10983 ----------------------------            ---------------------------------
10984  P   Move to previous folder              V  View Index of selected folder
10985  N   Move to next folder                  D  Delete
10986  -   Show previous page of listing        R  Rename
10987 Spc  (space bar) Show next page           E  Export to file
10988                                           U  Import from file to folder
10989
10990 FOLDER LIST Screen Commands              General Alpine Command
10991 ---------------------------              -----------------------
10992  A  Add a folder                          O  Show all other available commands
10993  G  Specify a folder to go to             ?  Show Help text
10994  I  Show MESSAGE INDEX of current folder  M  MAIN MENU Screen
10995  W  Whereis (search folder names)         Q  Quit Alpine
10996  %  Print folder listing                  C  Compose a message
10997                                           #  Compose a message using roles
10998 </PRE>
10999 <!--chtml endif-->
11000 <P>
11001 These commands are only available in the FOLDER LIST screen when the
11002 <A HREF="h_config_enable_agg_ops">&quot;<!--#echo var="FEAT_enable-aggregate-command-set"-->&quot;
11003 feature</A> is set in the SETUP CONFIGURATION screen:<DL>
11004 <DT>Select:</DT>
11005 <DD>Select folders by certain criteria:<UL>
11006 <LI>All: of limited use, since there is no Apply command.
11007 <LI>by Property: <UL>
11008         <LI>folder contains messages not yet seen
11009         <LI>folder contains new messages
11010         <LI>folder contains exactly as many, more, or fewer messages
11011 than a given number
11012         </UL>
11013 <LI>by Text: <UL>
11014         <LI>contained in name of folder (Name Select)
11015         <LI>contained in messages in folder (Content Select)
11016         </UL>
11017 </UL></DD>
11018
11019 <DT>Select current:</DT>
11020 <DD>Select the folder the cursor is on.  (Can be used to &quot;manually&quot;
11021 add one or more folders to a set created with the Select command described
11022 above.)</DD>
11023 <DT>Zoom mode:</DT>
11024 <DD>Toggles display of only selected folders or all folders on and off.</DD>
11025 </DL>
11026 <P>
11027 If the feature
11028 <A HREF="h_config_tab_checks_recent">&quot;<!--#echo var="FEAT_tab-checks-recent"-->&quot;</A>
11029 is set then the TAB key will display the number of recent messages and
11030 the total number of messages in the highlighted folder.
11031 <P>
11032 The &quot;Export&quot; command causes the lowest common denominator style
11033 mailbox to be written to a file.
11034 If the file already exists, you are asked if you want to delete it.
11035 If you say No, then the operation is aborted.
11036 Export might be a reasonable way to store a backup or an archival copy of
11037 a folder.
11038 The exported-to file is a local file on the system where you are running Alpine.
11039 The &quot;Import&quot; command is the opposite of the Export command.
11040 It reads a file created by Export and asks where it should save it in your
11041 folders.
11042 This could be a new folder or an existing folder.
11043 If the folder already exists, the messages from the exported file will be
11044 appended to the folder.
11045 <P>
11046 <CENTER>Description of the FOLDER LIST Screen</CENTER>
11047
11048 The purpose of the FOLDER LIST screen is to help you browse and manage
11049 the folders and directories (also known as &quot;hierarchy&quot;)
11050 contained within a collection.
11051
11052 <P>
11053 Folders and directories are arranged alphabetically across lines of
11054 the screen.  Directories, if present, are denoted by a special
11055 character at the end of the name known as the hierarchy delimiter
11056 (typically, &quot;/&quot;).  By default, folders and directories are
11057 mixed together.  The
11058 "<A HREF="h_config_fld_sort_rule"><!--#echo var="VAR_folder-sort-rule"--></A>"
11059 configuration option can be used to group directories toward the
11060 beginning or end of the list.
11061
11062 <P>
11063 The Next/Prev Page commands help browse the list, the Next/Prev Fldr
11064 commands change the &quot;selected&quot; (i.e., highlighted) folder or
11065 directory, and the View Fldr/Dir commands will &quot;open&quot; the
11066 selected item.  Folder and directory management is provided via the
11067 Rename, Delete and Add commands.
11068
11069 <P><CENTER>About Folders</CENTER>
11070 What are Folders?<P>
11071
11072 Folders are simply files where messages are kept.  Every message has to be
11073 in a folder.  Most every Alpine user starts out with 3 folders: an INBOX, a
11074 folder for sent mail and a folder for saved messages.<P>
11075
11076 You may create as many other folders as you wish.  They must be given
11077 names that can be filenames on the filesystem.
11078 <P>
11079
11080 You can move messages from one folder to another by opening the original
11081 folder and saving messages into the other folder just as you can save
11082 message from your INBOX to any other folder.<P>
11083
11084 Folders are typically just files in the filesystem.  However, the files
11085 that are
11086 folders have some special formatting in them (so that Alpine knows where one
11087 message ends and another begins) and should <EM>not</EM> be edited outside of
11088 Alpine.  If you want copies of your messages in text files that you can edit
11089 or otherwise manipulate, use the Export command to copy them from Alpine into
11090 your regular file area.
11091
11092 <P>
11093 FOR MORE INFORMATION: See the section on
11094 <A HREF="h_valid_folder_names">Valid Folder Names</A>.
11095 <P>
11096 <CENTER>About Directories</CENTER>
11097 <P>
11098 A directory is simply a container used to group folders within a
11099 folder list.  You can create as many directories as you like.  And
11100 directories can even contain directories themselves.
11101
11102 <P>
11103 SPECIAL NOTES: When accessing folders on an IMAP server, it is important
11104 to note that not all IMAP servers support directories.  If you find that
11105 the Add command fails to offer the &quot;Create Directory&quot; subcommand,
11106 then it's likely that directories are not supported by the server serving
11107 in that collection.
11108
11109 <P>
11110 Similarly, servers that do provide for directories may not do so in
11111 the same way.  On some servers, for example, each folder name you
11112 create is at the same time capable of being a directory.  When this
11113 happens, Alpine will display both the folder name and the name of the
11114 directory (with trailing hierarchy delimiter) in the folder list.
11115
11116 <P>
11117 Another issue with IMAP access, though with a much smaller set of servers,
11118 is that not all servers accept the request to list out the available
11119 folders and directories in the same way.  If you find yourself having
11120 trouble viewing folders on your server, you might investigate the
11121 &quot;<A HREF="h_config_lame_list_mode"><!--#echo var="FEAT_enable-lame-list-mode"--></A>&quot;
11122 feature.
11123 <P>
11124 <UL>
11125 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
11126 </UL>
11127 <P>
11128 &lt;End of help on this topic&gt;
11129 </BODY>
11130 </HTML>
11131 ========= h_valid_folder_names ========
11132 <HTML>
11133 <HEAD>
11134 <TITLE>Explanation of Valid Folder Names</TITLE>
11135 </HEAD>
11136 <BODY>
11137 <H1>Folder Name Syntax Explained</H1>
11138
11139 Once your folder collections are defined, you can usually refer to
11140 folders by their simple (unqualified) name, or pick from a FOLDER LIST
11141 display.  However, understanding the complete syntax for folder names,
11142 both local and remote, is handy when using the Goto command and when
11143 you are adding new folder collections via the Setups/collectionList screen.
11144 <P>
11145 An Alpine folder name looks like
11146
11147 <P>
11148 <CENTER><SAMP>[{&lt;remote-specification&gt;}][#&lt;namespace&gt;]&lt;namespace-specific-part&gt;</SAMP></CENTER>
11149 <P>
11150
11151 The square brackets ([]) mean that the part is optional.
11152
11153 <P>
11154 If there is no remote-specification, then the folder name is interpreted
11155 locally on the computer running Alpine.
11156 Local folder names depend on the operating system used by the computer
11157 running Alpine, as well as the configuration of that system.  For example,
11158 &quot;C:&#92;PINE&#92;FOLDERS&#92;OCT-94&quot; might exist on a PC, and
11159 &quot;~/mail/september-1994&quot; might be a reasonable folder name on a
11160 system running Unix.
11161
11162 <P>
11163 Alpine users have the option of using folders that are stored on some other
11164 computer.  Alpine accesses remote folders via IMAP (the Internet Message
11165 Access Protocol), or in the case of news, via NNTP (the Network News
11166 Transport Protocol).  To be able to access remote folders in Alpine, the
11167 remote host must be running the appropriate server software (imapd or
11168 nntpd) and you must correctly specify the name of the folder to Alpine,
11169 including the domain name of the remote machine. For example,
11170 <P>
11171 <CENTER><SAMP>&#123;monet.art.example.com}INBOX</SAMP></CENTER>
11172 <P>
11173 could be a remote folder specification, and so could
11174 <P>
11175 <CENTER><SAMP>&#123;unixhost.art.example.com}~/mail/september-1994</SAMP></CENTER>
11176 and
11177 <P>
11178 <CENTER><SAMP>&#123;winhost.art.example.com}&#92;mymail&#92;SEP-94</SAMP></CENTER>
11179 <P>
11180 Note that in the case of remote folders, the directory/file path in the specification is
11181 determined by the operating system of the remote computer, <B>not</B> by
11182 the operating system of the computer on which you are running Alpine.
11183 <P>
11184 As you can tell, the name of the computer is in &#123;} brackets
11185 followed immediately by the name of the folder.  (In each of these cases the
11186 optional namespace is missing.)  If, as in these
11187 examples, there is no remote access protocol specified, then IMAP is
11188 assumed.  Check
11189 <A HREF="h_folder_server_syntax">here</A>
11190 for a more detailed look at what options can be placed between the brackets.
11191 If there are no brackets at all, then the folder name is interpreted locally
11192 on the computer on which you are running Alpine.
11193
11194 <P>
11195 To the right of the brackets when a server name is present, or at the
11196 start of the foldername if no server is present, the sharp sign,
11197 &quot;#&quot;, holds special meaning.  It indicates a folder name
11198 outside the area reserved for your personal folders.  In fact, it's
11199 used to indicate both the name of the folder, and a special phrase
11200 telling Alpine how to interpret the name that follows.
11201
11202 <P>
11203 So, for example, Alpine can be used to access a newsgroup that might be
11204 available on your computer using:
11205 <P>
11206 <CENTER><SAMP>#news.comp.mail.pine</SAMP></CENTER>
11207 <P>
11208 The sharp sign indicates the folder name is outside your personal
11209 folder area.  The &quot;news.&quot; phrase after it tells Alpine to
11210 interpret the remainder of the name as a newsgroup.
11211
11212 <P>
11213 Similarly, to access a newsgroup on your IMAP server, you might
11214 use something like:
11215 <P>
11216 <CENTER><SAMP>&#123;wharhol.art.example.com}#news.comp.mail.misc</SAMP></CENTER>
11217
11218 <P>
11219 There are a number of such special phrases (or &quot;namespaces&quot;)
11220 available.  For a more detailed explanation read about
11221 <A HREF="h_folder_name_namespaces">Namespaces</A>.
11222
11223 <P>
11224 Note that &quot;INBOX&quot; has special meaning in both local and remote folder
11225 names.  The name INBOX refers to your &quot;principal incoming
11226 message folder&quot; and will be mapped to the actual file name used for your
11227 INBOX on any given host.  Therefore, a name like
11228 &quot;&#123;xxx.art.example.com}INBOX&quot; refers to whatever file is used to
11229 store incoming mail for you on that particular host.
11230
11231 <P>
11232 &lt;End of help on this topic&gt;
11233 </BODY>
11234 </HTML>
11235 ======= h_folder_name_namespaces =======
11236 <HTML>
11237 <HEAD>
11238 <TITLE>FOLDER NAME NAMESPACES EXPLAINED</TITLE>
11239 </HEAD>
11240 <BODY>
11241 <H1>Folder Name Namespaces Explained</H1>
11242
11243 An Alpine folder name looks like
11244
11245 <P>
11246 <CENTER><SAMP>[{&lt;remote-specification&gt;}][#&lt;namespace&gt;][&lt;namespace-specific-part&gt;]</SAMP></CENTER>
11247 <P>
11248
11249 The local part of a folder name has an optional &quot;Namespace&quot; which
11250 tells Alpine how to interpret the rest of the name.
11251
11252 <P>
11253 By default the folder name is interpreted as defining a section of your personal
11254 folder area.  This area and how you specify it are defined by the
11255 server, if one is specified, or, typically, the home
11256 directory, if no server is defined.
11257
11258 <P>
11259 If a namespace is specified, it begins with the
11260 sharp, &quot;#&quot;, character followed by the name of the namespace
11261 and then the namespace's path-element-delimiter.  Aside from the
11262 path's format, namespaces can also imply access rights, content
11263 policy, audience, location, and, occasionally, access methods.
11264
11265 <P>
11266 Each server exports its own set (possibly of size one) of
11267 namespaces.  Hence, it's likely communication with your server's
11268 administrator will be required for specific configurations.  Some of
11269 the more common namespaces, however, include:
11270
11271 <DL>
11272 <DT>#news.</DT>
11273 <DD>This specifies a set of folders in the newsgroup namespace.  Newsgroup
11274 names are hierarchically defined with each level delimited by a period.
11275 <P>
11276 <CENTER><SAMP>#news.comp.mail.pine</SAMP></CENTER>
11277 <P>
11278 </DD>
11279 <DT>#public/</DT>
11280 <DD>This specifies a folder area that the server may export to the general
11281 public.
11282 </DD>
11283 <DT>#shared/</DT>
11284 <DD>This specifies a folder area that the server may export to groups
11285 of users.
11286 </DD>
11287 <DT>#ftp/</DT>
11288 <DD>This specifies a folder area that is the same as that it may have
11289 exported via the &quot;File Transfer Protocol&quot;.
11290 </DD>
11291 <DT>#mh/</DT>
11292 <DD>This specifies the personal folder area associated with folders
11293 and directories that were created using the MH message handling system.
11294 </DD>
11295 <DT>#move/</DT>
11296 <DD>This namespace is interpreted locally by Alpine. It has an unusual interpretation and format.
11297 <P>
11298 <CENTER><SAMP>#move&lt;DELIM&gt;&lt;MailDropFolder&gt;&lt;DELIM&gt;&lt;DestinationFolder&gt;</SAMP></CENTER>
11299 <P>
11300 The #move namespace is followed by two folder names separated by a delimiter
11301 character.
11302 The delimiter character may be any character that does not appear in
11303 the MailDropFolder name.
11304 The meaning of #move is that mail will be copied from the MailDropFolder to
11305 the DestinationFolder and then deleted (if possible) from the MailDropFolder.
11306 Periodic checks at frequency
11307 <A HREF="h_config_mailcheck"><!--#echo var="VAR_mail-check-interval"--></A>, but with a minimum
11308 time between checks set by
11309 <A HREF="h_config_maildropcheck"><!--#echo var="VAR_maildrop-check-minimum"--></A>,
11310 are made for new mail arriving in the MailDropFolder.
11311 An example that copies mail from a POP inbox to a local folder follows
11312 <P>
11313 <CENTER><SAMP>#move+{popserver.example.com/pop3/ssl}inbox+local folder</SAMP></CENTER>
11314 <P>
11315 To you it appears that mail is being delivered to the local folder when it
11316 is copied from the MailDropFolder, and you read mail from the local folder.
11317 <P>
11318 Note that if the DestinationFolder does not exist then the messages are not
11319 copied from the MailDropFolder.
11320 A #move folder may only be used as an
11321 <A HREF="h_config_enable_incoming">&quot;Incoming folder&quot;</A> or
11322 an Inbox.
11323 When you are in the FOLDER LIST of Incoming Message Folders (after turning
11324 on the
11325 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="FEAT_enable-incoming-folders"-->&quot;</A>
11326 option)
11327 the Add command has a subcommand &quot;Use Mail Drop&quot;
11328 which may be helpful for defining the folder in your Alpine configuration.
11329 The same is true when you edit the
11330 <A HREF="h_config_inbox_path"><!--#echo var="VAR_inbox-path"--></A>
11331 option in Setup/Config.
11332 Each of these configuration methods will also create the DestinationFolder
11333 if it doesn't already exist.
11334 If you are having problems, make sure the DestinationFolder exists.
11335 You may find some more useful information about Mail Drops at
11336 <A HREF="h_maildrop">What is a Mail Drop?</A>.
11337 </DD>
11338 </DL>
11339 <P>
11340
11341 In addition, the server may support access to other user's folders,
11342 provided you have suitable permissions.  Common methods use a prefix
11343 of either &quot;~<VAR>user</VAR>/&quot;, or &quot;/<VAR>user</VAR>/&quot; to
11344 indicate the root of the other user's folder area.
11345
11346 <P>
11347 No, nothing's simple.
11348
11349 <P>
11350 &lt;End of help on this topic&gt;
11351 </BODY>
11352 </HTML>
11353 ============= h_whatis_vcard ========================
11354 <HTML>
11355 <HEAD>
11356 <TITLE>VCARD EXPLAINED</TITLE>
11357 </HEAD>
11358 <BODY>
11359 <H1>What is the vCard format?</H1>
11360 A &quot;vCard&quot; is a sort of electronic business card, for exchanging
11361 information about and among people and organizations electronically.
11362 More information about vCard can be found (as of May 1998) on the WWW site
11363 of the Internet Mail Consortium at the URL:
11364 <P>
11365 <CENTER><A HREF="http://www.imc.org/pdi/">http://www.imc.org/pdi/</A></CENTER>
11366 <P>
11367 &lt;End of help on this topic&gt;
11368 </BODY>
11369 </HTML>
11370 ===== h_folder_open =====
11371 <HTML>
11372 <HEAD>
11373 <TITLE>Explanation of Folder Selection</TITLE>
11374 </HEAD>
11375 <BODY>
11376 <BR>
11377 <BR>
11378 This screen is designed to allow you to quickly and easily survey your
11379 folders and select one to open.
11380 <!--chtml if pinemode="function_key"-->
11381 <PRE>
11382 Navigating the List of Folders             General Alpine Commands
11383 ------------------------------             -----------------------
11384  P   Move to previous folder               ?   Show this help text
11385  N   Move to next folder
11386  -   Show previous screen of folders
11387 Spc  (space bar) Show next screen
11388  W   WhereIs (search folder names)
11389
11390 Folder Selection Commands
11391 -------------------------
11392  E   Exit the Folder Select menu (without selecting a folder)
11393  S   Select the currently highlighted folder
11394 </PRE>
11395 <!--chtml else-->
11396 <PRE>
11397 Navigating the List of Folders             General Alpine Commands
11398 ------------------------------             -----------------------
11399 F5   Move to previous folder               F1  Show this help text
11400 F6   Move to next folder
11401 F7   Show previous screen of folders
11402 F8   Show next screen of folders
11403 F12  WhereIs (search folder names)
11404
11405 Folder Selection Commands
11406 -------------------------
11407 F3   Exit the Folder Select menu (without selecting a folder)
11408 F4   Select the currently highlighted folder
11409 </PRE>
11410 <!--chtml endif-->
11411 <P>
11412 FOR MORE INFORMATION: See the section on
11413 <A HREF="h_valid_folder_names">Valid Folder Names</A>.
11414 <P>
11415 &lt;End of help on this topic&gt;
11416 </BODY>
11417 </HTML>
11418 ===== h_folder_subscribe =====
11419 <HTML>
11420 <HEAD>
11421 <TITLE>Newsgroup Subcribe Screen explained</TITLE>
11422 </HEAD>
11423 <BODY>
11424 <H1>FOLDER SUBSCRIBE HELP</H1>
11425
11426 This screen is designed to help you subscribe to newsgroups you are
11427 not currently subscribed to.  The screen display is a list of all
11428 available newsgroups (or possibly a partial list if you specified a
11429 partial name when entering the screen).  Groups you have already
11430 subscribed to have the letters &quot;SUB&quot; next to them.  You may
11431 select a single new group to subscribe to by moving the cursor to that
11432 group and pressing &quot;S&quot; or carriage return.  Alternatively,
11433 you may change into ListMode with the &quot;ListMode&quot; command.
11434 The display will change slightly so that each group has a checkbox in
11435 front of it.  Use the cursor and the Set/Unset command to place an
11436 &quot;X&quot; in front of each newsgroup you wish to subscribe to.
11437 <P>
11438
11439 When you are finished marking groups, the &quot;Subscribe&quot;
11440 command will subscribe you to those groups you have marked.  Note, you
11441 may not unsubscribe to groups with this command.  Instead of the
11442 &quot;A&quot; &quot;Subscribe&quot; command, use the &quot;D&quot;
11443 UnSbscrbe command.
11444 <P>
11445
11446 <!--chtml if pinemode="function_key"-->
11447 <PRE>
11448 Navigating the List of Newsgroups          General Alpine Commands
11449 ---------------------------------          -----------------------
11450 F5   Move to previous group                F1   Show this help text
11451 F6   Move to next group
11452 F7   Show previous screen of groups
11453 F8   Show next screen of groups
11454 F12  WhereIs (search group names)
11455 F9   Use ListMode
11456
11457 Group Selection Commands
11458 -------------------------
11459 F3  Exit the News Subscribe menu (without selecting any groups)
11460 F4  Subscribe to the currently highlighted newsgroup
11461 </PRE>
11462 <!--chtml else-->
11463 <PRE>
11464 Navigating the List of Newsgroups          General Alpine Commands
11465 ---------------------------------          -----------------------
11466  P   Move to previous group                ?   Show this help text
11467  N   Move to next group
11468  -   Show previous screen of groups
11469 Spc  (space bar) Show next screen
11470  W   WhereIs (search group names)
11471  L   Use ListMode
11472
11473 Group Selection Commands
11474 -------------------------
11475  E   Exit the News Subscribe menu (without selecting any groups)
11476  S   Subscribe to the currently highlighted newsgroup
11477 </PRE>
11478 <!--chtml endif-->
11479 <P>
11480 When in ListMode, there is an additional command for marking groups to
11481 subscribe to:
11482 <P>
11483 <!--chtml if pinemode="function_key"-->
11484 <PRE>
11485 ListMode Commands
11486 -------------------------
11487 F9  Set or unset the highlighted group
11488 </PRE>
11489 <!--chtml else-->
11490 <PRE>
11491 ListMode Commands
11492 -------------------------
11493 X   Set or unset the highlighted group
11494 </PRE>
11495 <!--chtml endif-->
11496 <P>
11497 &lt;End of help on this topic&gt;
11498 </BODY>
11499 </HTML>
11500 ===== h_folder_postnews =====
11501 <HTML>
11502 <HEAD>
11503 <TITLE>Newsgroup selecting for Posting explained</TITLE>
11504 </HEAD>
11505 <BODY>
11506 This screen is designed to allow you to quickly and easily survey
11507 the available newsgroups and select one to post news to.
11508 <P>
11509 <!--chtml if pinemode="function_key"-->
11510 <PRE>
11511 Navigating the List of Newsgroups          General Alpine Commands
11512 ---------------------------------          -----------------------
11513 F5   Move to previous group                F1  Show this help text
11514 F6   Move to next group
11515 F7   Show previous screen of groups
11516 F8   Show next screen of groups
11517 F12  WhereIs (search group names)
11518
11519 Group Selection Commands
11520 -------------------------
11521 F3   Exit the Selection menu (without selecting a group)
11522 F4   Select the currently highlighted newsgroup
11523 </PRE>
11524 <!--chtml else-->
11525 <PRE>
11526 Navigating the List of Newsgroups          General Alpine Commands
11527 ---------------------------------          -----------------------
11528  P   Move to previous group                ?  Show this help text
11529  N   Move to next group
11530  -   Show previous screen of groups
11531 Spc  (space bar) Show next screen of groups
11532  W   WhereIs (search group names)
11533
11534 Group Selection Commands
11535 -------------------------
11536  E   Exit the Selection menu (without selecting a group)
11537  S   Select the currently highlighted newsgroup
11538 </PRE>
11539 <!--chtml endif-->
11540 <P>
11541 &lt;End of help on this topic&gt;
11542 </BODY>
11543 </HTML>
11544 ===== h_folder_save =====
11545 <HTML>
11546 <HEAD>
11547 <TITLE>Folder Select for Save Explained</TITLE>
11548 </HEAD>
11549 <BODY>
11550 This screen is designed to allow you to quickly and easily survey your
11551 folders and select one to use for saving the current message.
11552 <P>
11553
11554 <!--chtml if pinemode="function_key"-->
11555 <PRE>
11556 Navigating the List of Folders             General Alpine Commands
11557 ------------------------------             -----------------------
11558 F5   Move to previous folder               F1  Show this help text
11559 F6   Move to next folder
11560 F7   Show previous screen of folders
11561 F8   Show next screen of folders
11562 F12  WhereIs (search folder names)
11563
11564 Folder Selection Commands
11565 -------------------------
11566 F3   Exit the Folder Select menu (without selecting a folder)
11567 F4   Select the currently highlighted folder
11568 F11  AddNew folder (just like Select, but you type in a new folder name)
11569 </PRE>
11570 <!--chtml else-->
11571 <PRE>
11572 Navigating the List of Folders             General Alpine Commands
11573 ------------------------------             -----------------------
11574  P   Move to previous folder               ?  Show this help text
11575  N   Move to next folder
11576  -   Show previous screen of folders
11577 Spc  (space bar) Show next screen of folders
11578  W   WhereIs (search folder names)
11579
11580 Folder Selection Commands
11581 -------------------------
11582  E   Exit the Folder Select menu (without selecting a folder)
11583  S   Select the currently highlighted folder
11584  A   AddNew folder (just like Select, but you type in a new folder name)
11585 </PRE>
11586 <!--chtml endif-->
11587 <P>
11588 FOR MORE INFORMATION: See the section on
11589 <A HREF="h_valid_folder_names">Valid Folder Names</A>.
11590 <P>
11591 &lt;End of help on this topic&gt;
11592 </BODY>
11593 </HTML>
11594 ===== h_folder_fcc =====
11595 <HTML>
11596 <HEAD>
11597 <TITLE>Folder Select for Fcc Explained</TITLE>
11598 </HEAD>
11599 <BODY>
11600 This screen is designed to allow you to quickly and easily survey your
11601 folders and select one to use as the file carbon copy (fcc) for the
11602 current message.
11603 <P>
11604
11605 <!--chtml if pinemode="function_key"-->
11606 <PRE>
11607 Navigating the List of Folders             General Alpine Commands
11608 ------------------------------             -----------------------
11609 F5   Move to previous folder               F1  Show this help text
11610 F6   Move to next folder
11611 F7   Show previous screen of folders
11612 F8   Show next screen of folders
11613 F12  WhereIs (search folder names)
11614
11615 Folder Selection Commands
11616 -------------------------
11617 F3   Exit the Folder Select menu (without selecting a folder)
11618 F4   Select the currently highlighted folder
11619 F11  AddNew folder (just like Select, but you type in a new folder name)
11620 </PRE>
11621 <!--chtml else-->
11622 <PRE>
11623 Navigating the List of Folders             General Alpine Commands
11624 ------------------------------             -----------------------
11625  P   Move to previous folder               ?  Show this help text
11626  N   Move to next folder
11627  -   Show previous screen of folders
11628 Spc  (space bar) Show next screen of folders
11629  W   WhereIs (search folder names)
11630
11631 Folder Selection Commands
11632 -------------------------
11633  E   Exit the Folder Select menu (without selecting a folder)
11634  S   Select the currently highlighted folder
11635  A   AddNew folder (just like Select, but you type in a new folder name)
11636 </PRE>
11637 <!--chtml endif-->
11638 <P>
11639 FOR MORE INFORMATION: See the section on
11640 <A HREF="h_valid_folder_names">Valid Folder Names</A>.
11641 <P>
11642 &lt;End of help on this topic&gt;
11643 </BODY>
11644 </HTML>
11645 ===== h_folder_pattern_roles =====
11646 <HTML>
11647 <HEAD>
11648 <TITLE>Folder Select for Current Folder Explained</TITLE>
11649 </HEAD>
11650 <BODY>
11651 This screen is designed to allow you to quickly and easily survey your
11652 folders and select one to use as the specific Current Folder
11653 in a Pattern.
11654 <P>
11655
11656 <!--chtml if pinemode="function_key"-->
11657 <PRE>
11658 Navigating the List of Folders             General Alpine Commands
11659 ------------------------------             -----------------------
11660 F5   Move to previous folder               F1  Show this help text
11661 F6   Move to next folder
11662 F7   Show previous screen of folders
11663 F8   Show next screen of folders
11664 F12  WhereIs (search folder names)
11665
11666 Folder Selection Commands
11667 -------------------------
11668 F3   Exit the Folder Select menu (without selecting a folder)
11669 F4   Select the currently highlighted folder
11670 F11  AddNew folder (just like Select, but you type in a new folder name)
11671 </PRE>
11672 <!--chtml else-->
11673 <PRE>
11674 Navigating the List of Folders             General Alpine Commands
11675 ------------------------------             -----------------------
11676  P   Move to previous folder               ?  Show this help text
11677  N   Move to next folder
11678  -   Show previous screen of folders
11679 Spc  (space bar) Show next screen of folders
11680  W   WhereIs (search folder names)
11681
11682 Folder Selection Commands
11683 -------------------------
11684  E   Exit the Folder Select menu (without selecting a folder)
11685  S   Select the currently highlighted folder
11686  A   AddNew folder (just like Select, but you type in a new folder name)
11687 </PRE>
11688 <!--chtml endif-->
11689 <P>
11690 FOR MORE INFORMATION: See the section on
11691 <A HREF="h_valid_folder_names">Valid Folder Names</A>.
11692 <P>
11693 &lt;End of help on this topic&gt;
11694 </BODY>
11695 </HTML>
11696 ===== h_folder_stayopen_folders =====
11697 <HTML>
11698 <HEAD>
11699 <TITLE>Folder Select Explained</TITLE>
11700 </HEAD>
11701 <BODY>
11702 This screen is designed to allow you to quickly and easily survey your
11703 folders and select one to use as a Stay-Open folder.
11704 <P>
11705
11706 <!--chtml if pinemode="function_key"-->
11707 <PRE>
11708 Navigating the List of Folders             General Alpine Commands
11709 ------------------------------             -----------------------
11710 F5   Move to previous folder               F1  Show this help text
11711 F6   Move to next folder
11712 F7   Show previous screen of folders
11713 F8   Show next screen of folders
11714 F12  WhereIs (search folder names)
11715
11716 Folder Selection Commands
11717 -------------------------
11718 F3   Exit the Folder Select menu (without selecting a folder)
11719 F4   Select the currently highlighted folder
11720 F11  AddNew folder (just like Select, but you type in a new folder name)
11721 </PRE>
11722 <!--chtml else-->
11723 <PRE>
11724 Navigating the List of Folders             General Alpine Commands
11725 ------------------------------             -----------------------
11726  P   Move to previous folder               ?  Show this help text
11727  N   Move to next folder
11728  -   Show previous screen of folders
11729 Spc  (space bar) Show next screen of folders
11730  W   WhereIs (search folder names)
11731
11732 Folder Selection Commands
11733 -------------------------
11734  E   Exit the Folder Select menu (without selecting a folder)
11735  S   Select the currently highlighted folder
11736  A   AddNew folder (just like Select, but you type in a new folder name)
11737 </PRE>
11738 <!--chtml endif-->
11739 <P>
11740 FOR MORE INFORMATION: See the section on
11741 <A HREF="h_valid_folder_names">Valid Folder Names</A>.
11742 <P>
11743 &lt;End of help on this topic&gt;
11744 </BODY>
11745 </HTML>
11746 ===== h_folder_action_roles =====
11747 <HTML>
11748 <HEAD>
11749 <TITLE>Folder Select Explained</TITLE>
11750 </HEAD>
11751 <BODY>
11752 This screen is designed to allow you to quickly and easily survey your
11753 folders and select one to use as the folder into which messages
11754 matching this filter will be moved.
11755 <P>
11756
11757 <!--chtml if pinemode="function_key"-->
11758 <PRE>
11759 Navigating the List of Folders             General Alpine Commands
11760 ------------------------------             -----------------------
11761 F5   Move to previous folder               F1  Show this help text
11762 F6   Move to next folder
11763 F7   Show previous screen of folders
11764 F8   Show next screen of folders
11765 F12  WhereIs (search folder names)
11766
11767 Folder Selection Commands
11768 -------------------------
11769 F3   Exit the Folder Select menu (without selecting a folder)
11770 F4   Select the currently highlighted folder
11771 F11  AddNew folder (just like Select, but you type in a new folder name)
11772 </PRE>
11773 <!--chtml else-->
11774 <PRE>
11775 Navigating the List of Folders             General Alpine Commands
11776 ------------------------------             -----------------------
11777  P   Move to previous folder               ?  Show this help text
11778  N   Move to next folder
11779  -   Show previous screen of folders
11780 Spc  (space bar) Show next screen of folders
11781  W   WhereIs (search folder names)
11782
11783 Folder Selection Commands
11784 -------------------------
11785  E   Exit the Folder Select menu (without selecting a folder)
11786  S   Select the currently highlighted folder
11787  A   AddNew folder (just like Select, but you type in a new folder name)
11788 </PRE>
11789 <!--chtml endif-->
11790 <P>
11791 FOR MORE INFORMATION: See the section on
11792 <A HREF="h_valid_folder_names">Valid Folder Names</A>.
11793 <P>
11794 &lt;End of help on this topic&gt;
11795 </BODY>
11796 </HTML>
11797 ===== h_abook_config =====
11798 <HTML>
11799 <HEAD>
11800 <TITLE>SETUP ADDRESS BOOKS SCREEN</TITLE>
11801 </HEAD>
11802 <BODY>
11803 <H1>SETUP ADDRESS BOOKS SCREEN</H1>
11804 <H2>SETUP ADDRESS BOOKS COMMANDS</H2>
11805 <!--chtml if pinemode="function_key"-->
11806 <PRE>
11807 Available  Commands
11808 -------------------------------
11809 F1  Show Help Text
11810 F3  Back to MAIN Alpine menu
11811 F4  Change configuration for address book
11812 F5  Move to previous address book
11813 F6  Move to next address book
11814 F7  Previous page of address books
11815 F8  Next page of address books
11816 F9  Add new address book
11817 F10 Delete existing address book
11818 F11 Shuffle the order of address books
11819 F12 Whereis (search address book titles)
11820 </PRE>
11821 <!--chtml else-->
11822 <PRE>
11823 Navigation                     General Alpine Commands
11824 -----------------------        -----------------------
11825  P  Prev Address Book           ?  Display this help text
11826  N  Next Address Book           E  Back to MAIN Alpine menu
11827  -  Previous page
11828 Spc (space bar) Next page
11829  W  WhereIs (search for word in address book titles)
11830
11831 Setup Address Books Commands
11832 ------------------------------------------------
11833  A  Add new address book          $  Shuffle the order of address books
11834  D  Delete existing address book  C  Change configuration for address book
11835 </PRE>
11836 <!--chtml endif-->
11837
11838 <H2>Description of the Setup Address Books Screen</H2>
11839
11840 This screen lets you add, delete, modify, or change the order of your
11841 address books.  The &quot;Add Abook&quot; command brings up a blank form to
11842 fill in.  If you are adding a remote address book on an IMAP server
11843 you should fill in the name of the IMAP server.  Otherwise, leave
11844 that field blank.  (Note that remote IMAP address books are an Alpine
11845 concept and are unlikely to interoperate with other mail clients.)
11846 For a remote address book, fill in the name of the remote folder
11847 in the Folder field.  This should be a folder that is used only for
11848 this one purpose, not a general purpose folder you expect to store
11849 messages in.
11850 <P>If you are adding a local address book, fill in the
11851 Folder Name field with a local file name (e.g., .addressbook).
11852 <P>
11853 <B>Please note:</B> Remote address books stored on an IMAP server are
11854 of an entirely different format (namely, a special-purpose
11855 &quot;mail folder&quot;) than that of the local addressbook familiar
11856 to Alpine users.  Therefore,
11857 you cannot use &quot;add a remote address book&quot; to make an existing
11858 Alpine .addressbook file you may have on a remote IMAP server accessible to
11859 Alpine running on a different host.
11860 <P>
11861
11862 The &quot;Del Abook&quot; command allows you to remove an address book
11863 from your configuration.  It will also ask you if you wish to remove
11864 the data for that address book, which would erase all traces of the
11865 address book if you answer Yes.
11866 <P>
11867
11868 The &quot;Change&quot; command is similar to the &quot;Add Abook&quot; command.
11869 The difference is that instead of adding a new address book to your
11870 configuration, you are changing the configuration of an existing entry.
11871 For example, you might want to correct a typing error or change a
11872 nickname.  The &quot;Change&quot; command is not a move command.  If you
11873 change the folder name or server name the data will not be moved for you.
11874 <P>
11875
11876 The &quot;Shuffle&quot; command is used for two purposes.  If you shuffle
11877 an address book toward another address book in the same group then
11878 the order of those two address books will be swapped.  If you shuffle
11879 the last Personal address book down towards the Global address book
11880 section, it will become a Global address book.  If you shuffle
11881 the first Global address book up it will become a Personal address
11882 book.  The main difference between Personal and Global address
11883 books is that Global address books are forced read-only.
11884 <P><UL>
11885 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
11886 </UL>
11887 <P>
11888 &lt;End of help on this topic&gt;
11889 </BODY>
11890 </HTML>
11891 ===== h_abook_top =====
11892 <HTML>
11893 <HEAD>
11894 <TITLE>ADDRESS BOOK LIST COMMANDS</TITLE>
11895 </HEAD>
11896 <BODY>
11897 <H1>ADDRESS BOOK LIST COMMANDS</H1>
11898 <!--chtml if pinemode="function_key"-->
11899 <PRE>
11900 Available  Commands -- Group 1         Available Commands -- Group 2
11901 -------------------------------        ------------------------------
11902 F1  Show Help Text                      F1  Show Help Text
11903 F2  See commands in next group          F2  See commands in next group
11904 F3  Exit to MAIN MENU                   F3  Quit Alpine
11905 F4  View/Edit selected address book
11906 F5  Move to previous address book       F5  FOLDER LIST screen
11907 F6  Move to next address book           F6  Specify a folder to go to
11908 F7  Previous page                       F7  MESSAGE INDEX screen
11909 F8  Next page                           F9  Print list of address books
11910 F12 Whereis (search for word)
11911 </PRE>
11912 <!--chtml else-->
11913 <PRE>
11914 Navigation                       General Alpine Commands
11915 -----------------------          -----------------------
11916  P  Previous Entry                ?  Display this help text
11917  N  Next Entry                    O  Show all other available commands
11918  -  Previous page                 &lt;  Back to MAIN Alpine menu
11919 Spc (space bar) Next page         Q  Quit Alpine
11920  W  WhereIs (search for word)     L  FOLDER LIST screen
11921                                   G  Specify a folder to go to
11922 Address Book Commands             I  MESSAGE INDEX screen
11923 ------------------------------------------------
11924  &gt;  View/Edit selected address book
11925               or
11926  &gt;  Search on selected directory server
11927
11928  %  Print list of address books and directory servers
11929 </PRE>
11930 <!--chtml endif-->
11931
11932 <H2>Description of the Address Book List Screen</H2>
11933
11934 From this screen you may choose which address book you wish to view
11935 or edit. For more information on address books, view one of your
11936 address books (with
11937 <!--chtml if pinemode="function_key"-->
11938 F4
11939 <!--chtml else-->
11940 &quot;&gt;&quot;
11941 <!--chtml endif-->)
11942 and see the Help Text there.<P>
11943
11944 You may also choose a directory server on which to search for entries.
11945 You do that by highlighting the directory server line and using
11946 <!--chtml if pinemode="function_key"-->
11947 F4
11948 <!--chtml else-->
11949 &quot;&gt;&quot;
11950 <!--chtml endif-->.<P>
11951
11952 If you wish to define new address books or directory servers go to the Main
11953 menu and choose Setup. You may then either choose to setup AddressBooks or
11954 Directory (among other things). It's possible that the Directory option
11955 will not be there if the Alpine you are using does not contain LDAP directory
11956 lookup functionality.
11957
11958 <P><UL>
11959 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
11960 </UL><P>
11961 &lt;End of help on this topic&gt;
11962 </BODY>
11963 </HTML>
11964 ===== h_abook_opened =====
11965 <HTML>
11966 <HEAD>
11967 <TITLE>THE ALPINE ADDRESS BOOK</TITLE>
11968 </HEAD>
11969 <BODY>
11970 <H1>THE ALPINE ADDRESS BOOK</H1>
11971 <H2>ADDRESS BOOK COMMANDS</H2>
11972 <PRE>
11973 <!--chtml if pinemode="function_key"-->
11974 Available  Commands -- Group 1         Available Commands -- Group 2
11975 -------------------------------        ------------------------------
11976 F1  Show Help Text                      F1  Show Help Text
11977 F2  See commands in next group          F2  See commands in next group
11978 F3  Exit this screen                    F3  Quit Alpine
11979 F4  View/Edit selected entry            F4  Go to MAIN MENU screen
11980 F5  Move to previous entry              F5  FOLDER LIST screen
11981 F6  Move to next entry                  F6  Specify a folder to go to
11982 F7  Previous page of address book       F7  MESSAGE INDEX screen
11983 F8  Next page of address book           F8  Compose to entry using roles
11984 F9  Add new entry to address book       F9  Print address book
11985 F10 Delete selected entry               F10 TakeAddr to another addrbook
11986 F11 Compose to selected entry           F11 Save or Export addrbook selections
11987 F12 Whereis (search address book)       F12 Forward entry by mail
11988
11989 Available Commands -- Group 3
11990 ------------------------------
11991 F3  Select                              F6  Zoom (or unZoom)
11992 F5  Select Current                      F7  Apply Command to Selection
11993 <!--chtml else-->
11994 Address Book Navigation        General Alpine Commands
11995 -----------------------        -----------------------
11996  P  Prev Address                  ?  Display this help text
11997  N  Next Address                  O  Show all other available commands
11998  -  Previous page of address book M  Back to MAIN MENU
11999 Spc (space bar) Next page         Q  Quit Alpine
12000  W  WhereIs (search for word      C  Compose message to selected addr
12001      or name in address book)     #  Compose to addr using roles
12002  &lt;  To List of Address Books if   L  FOLDER LIST screen
12003      more than one, else to MAIN  G  Specify a folder to go to
12004                                   I  MESSAGE INDEX screen
12005
12006 Address Book Commands
12007 ----------------------------------------------------
12008  &gt;  View/Update selected entry    D  Delete selected entries
12009  %  Print address book            S  Save or Export address book selections
12010  F  Forward entries by mail       @  Add new entry to address book
12011
12012  ;  Select command                Z  Toggle Zoom Mode
12013  :  Select highlighted entry      A  Apply command to selected entries
12014
12015 <!--chtml endif-->
12016 </PRE>
12017 Note:  The presence or absence of the final four commands above is
12018 controlled by the option
12019 <A HREF="h_config_enable_agg_ops">&quot;<!--#echo var="FEAT_enable-aggregate-command-set"-->&quot;</A>.
12020 <P>
12021
12022 <H2>Description of the Address Book Screen</H2>
12023
12024 This screen lets you edit and manage entries in your address book.  It
12025 also acts as a short-cut for composing messages to people in the address
12026 book.  When, from this screen, you press <!--chtml if pinemode="function_key"-->F11<!--chtml else-->&quot;C&quot;<!--chtml endif--> for ComposeTo, the
12027 message starts &quot;pre-addressed&quot; to whatever address book entry is
12028 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
12029 role to use in your composition.
12030 <P>
12031 Alpine's address book helps you keep a list of addresses you send email to so
12032 you do not have to remember addresses that are often complex.  Each entry
12033 in the address book has five fields, all of them optional.  The three
12034 elements that are usually visible on the ADDRESS BOOK display, are: <DL>
12035
12036         <P><DT>NICKNAME: <DD>A short easy-to-remember label to identify the entry.
12037         This is what you type in as you are addressing the message in the
12038         composer.  If there is a matching entry in your address book(s),
12039         Alpine will extract the corresponding FullName and Address fields to
12040         generate the actual address for your message.
12041
12042         <P><DT>FULLNAME: <DD>A longer field where you can put the full name
12043 of the
12044         person or organization.  Usually the full names are put in last
12045         name first so they sort nicely in alphabetical order.  Whatever
12046         you put as the name here will appear on the message when it is
12047         finally delivered.  Examples:<PRE>
12048            Garcia Marquez, Gabriel
12049            Henscheid, Eckhard
12050            Alpine-Info mailing list
12051            Library materials renewal requests
12052            Kim An-guk
12053            &quot;George III, King of Great Britain, 1738-1820&quot;
12054 </PRE>
12055 (In the second-to-last example, no comma is used in the name so that
12056 the family name appears first in the address book and when the entry is
12057 used in the composer.
12058 In the last example, retaining the commas is intended;
12059 double-quotation marks surround the name to
12060 prevent the transposition of its parts when the entry is used in
12061 the composer.)
12062
12063         <P><DT>ADDRESS: <DD>This is the actual email address itself.  This must be
12064         a valid Internet address that conforms to the Internet message
12065         header standard, RFC-822.  (See also <A HREF="h_address_format">Explanation of Address formats</A>.)</DL>
12066
12067 The two fields that aren't usually visible are:<DL>
12068
12069   <P><DT>FCC: <DD>The name of the folder you would like a copy of any outgoing
12070         message to this address to be saved in.  If this field is set, and
12071         this address is the first one in the message's To: header, then
12072         Alpine will use this folder name for the FCC in lieu of the normal
12073         FCC folder name.
12074
12075   <P><DT>COMMENTS: <DD>This field contains arbitrary text for your convenience.
12076         </DL>
12077 <P>
12078 Due to screen width limitations, these last two fields do not show up in
12079 the normal ADDRESS BOOK display.  You may select the
12080 &quot;View/Update&quot; command to
12081 view or modify them.  You may use the configuration variable
12082 <A HREF="h_config_abook_formats">&quot;<!--#echo var="VAR_addressbook-formats"-->&quot;</A>
12083 to add these fields to your ADDRESS BOOK
12084 display, or to modify the format of the display.
12085
12086 <H2>Sorting the Address book</H2>
12087
12088 By default, address book entries are sorted alphabetically on the full
12089 name with distribution lists sorted to the end.  Sorting can be changed by
12090 resetting the address book sort rule in the Alpine SETUP CONFIGURATION screen
12091 --assuming you have &quot;write&quot; permission for the address book file.
12092 <P>
12093 Unlike the sorting of folders (which only changes presentation), sorting an
12094 address book actually changes the file as it is kept on the computer.  For
12095 this reason you won't be able to sort a shared or system-wide address
12096 book.
12097
12098 <H2>Adding New Entries</H2>
12099
12100 The easiest way to add new entries to your address book is to use the
12101 &quot;TakeAddr&quot; command when viewing a message.
12102 This command allows you to take addresses from the header and body of the
12103 message and put them into your address book, without having to type
12104 them in.
12105 <P>
12106
12107 To manually add a new entry from within the address book screen, use the AddNew
12108 (<!--chtml if pinemode="function_key"-->F9<!--chtml else-->&quot;@&quot;<!--chtml endif-->) command.
12109 Use this command both for adding a simple alias and for adding a
12110 distribution list.
12111
12112 <H2>Distribution Lists</H2>
12113
12114 Address book entries can be simple cases of aliases (a single nickname is linked
12115 to a single email address) or distribution lists (a single nickname
12116 pointing at more than one email address).  Each distribution list has a
12117 nickname, a full name and a list of addresses.  The addresses may be
12118 actual addresses or they may be other nicknames in your address book.
12119 They may even refer to other distribution lists.
12120 There's really no difference between a simple alias and a distribution list,
12121 other than the number of addresses.
12122 Therefore, you can turn a simple alias with one address into a distribution
12123 list simply by adding more addresses.
12124 To add entries to an existing list or alias
12125 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
12126 a single address from the list if the cursor is placed on the address;
12127 it will delete the entire distribution list if the cursor is on the
12128 nickname/fullname line.  View/Update may also be used to delete addresses
12129 from a list.
12130 <P>
12131 Address field entries in distribution lists may take any one of three
12132 forms: a nickname existing in any of the defined address books, a normal
12133 address of the form &quot;jsmith@art.example.com&quot;, or a complete
12134 fullname/address combination, e.g. &quot;John Smith
12135 &lt;jsmith@art.example.com&gt;&quot;.
12136 <P>
12137 Distribution lists in Alpine address books can only be used by the person or
12138 people who have access to that address book.  They are not usually used to
12139 implement discussion groups, but can be used to facilitate small
12140 discussion groups if all the participants have access to the same shared
12141 address book.
12142
12143 <H2>FCC and Comments</H2>
12144
12145 As mentioned above, each entry in the address book also has two other optional
12146 fields, Fcc and Comments.  The command to look at or change either of these
12147 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
12148 Comments field is just for your own use.  The Fcc field overrides the
12149 default Fcc if this address is the first one on the To line.  The WhereIs
12150 command may be used to search for particular strings in the address book,
12151 including fields that are not visible (like Comment and Fcc by default).
12152
12153 <H2>Aggregate Operations</H2>
12154
12155 If the feature
12156 <A HREF="h_config_enable_agg_ops">&quot;<!--#echo var="FEAT_enable-aggregate-command-set"-->&quot;</A>
12157 is turned on (the default), then the four commands &quot;Select&quot;,
12158 &quot;Select Current&quot;, &quot;Zoom&quot;, and &quot;Apply&quot;
12159 are available.  The two selection commands allow you to mark a set of
12160 address book entries as being selected.  If you have more than one address
12161 book, the selections may be in more than one of those address books.
12162 The &quot;Zoom&quot; command will toggle between displaying only the selected
12163 entries and all of the entries.  The &quot;Apply&quot; command allows you to
12164 apply one of the regular address book commands to all of the selected
12165 entries.  Usually the address book commands apply to only the entry
12166 highlighted by the cursor.  The &quot;Apply&quot; command works with the
12167 commands &quot;ComposeTo&quot;, &quot;Delete&quot;, &quot;Print&quot;,
12168 &quot;Save&quot;, &quot;Forward&quot;, and &quot;Role&quot;.
12169
12170 <H2>Exporting and Forwarding Address book entries</H2>
12171
12172 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
12173 address book entry is placed in a plain text file in your home directory
12174 <!--chtml if pinemode="running"-->
12175 (which, in the present configuration of your system, is
12176  &quot;<!--#echo var="HOME_DIR"-->&quot;)
12177 <!--chtml endif-->
12178 or current working directory
12179 <!--chtml if pinemode="running"-->
12180 (which, at least for your current Alpine &quot;session,&quot;
12181 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
12182 <!--chtml endif-->, depending on the
12183 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
12184 configuration setting.  If you have some entries selected and use the
12185 Apply (<!--chtml if pinemode="function_key"-->F7<!--chtml else-->&quot;A&quot;<!--chtml endif-->) Export command, all of the selected addresses will be
12186 placed in the text file.
12187 <P>
12188 When you use the Forward (<!--chtml if pinemode="function_key"-->F12<!--chtml else-->&quot;F&quot;<!--chtml endif-->) command, the currently highlighted
12189 address book entry is placed in a special attachment and you are put into
12190 the composer.  You can fill in some comments in the body of the message,
12191 if you'd like, and send it to somebody else who uses Alpine.  The recipient
12192 may use the TakeAddr command on that message to insert the address book
12193 entry you sent in their own address book.  If you have some entries
12194 selected and use the Apply Forward command all of the selected entries
12195 will be forwarded in a single message.  You may
12196 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.
12197 The recipient must be using Alpine in order to receive this correctly.
12198 One way for the recipient to handle this might be to create an empty
12199 address book and then &quot;Take&quot; your forwarded address book entries into
12200 that empty address book.
12201
12202 <H2>Multiple and/or Site-Wide Address books</H2>
12203
12204 You may have more than one personal address book.  In addition, there may
12205 be one or more global address books.  This capability allows you to have
12206 multiple personal address books (some of which may be shared) and it also
12207 allows system administrators to implement site-wide address books that
12208 contain entries for users on multiple machines within the organization.
12209 <P><DL>
12210 <DT>Searching
12211   <DD> If you enter a nickname when composing a message, your
12212   personal address books will be searched through in order, and then the
12213   global address book(s) searched. If more than one address book has an entry
12214   for the nickname, Alpine uses the first one that it finds, so an entry in
12215   your personal address book would override a global address book entry. If
12216   after searching all the address books there is still no match, (Unix) Alpine
12217   then searches the local host password file on the assumption that you have
12218   entered a local user name rather than an address book nickname.
12219   You may change the search order of your address books with the <!--chtml if pinemode="function_key"-->F3<!--chtml else-->$<!--chtml endif--> Shuffle
12220   command, but global address books are always searched after personal
12221   address books.
12222
12223   <P><DT>Tab completion
12224   <DD> If the
12225   <A HREF="h_config_enable_tab_complete"><!--#echo var="FEAT_enable-tab-completion"--></A>
12226   feature is turned on (the default) then the Tab key may be used
12227   in the composer to complete partially typed nicknames in the To
12228   or Cc lines. You type the first few letters of a nickname and then
12229   press the Tab key. It there is only one nickname that matches it will
12230   be filled in by Alpine. If there is more than one the unambiguous part
12231   of the nicknames will be filled in. For example, if your address book or
12232   books contains only the two entries &quot;barley&quot; and &quot;barbecue&quot;
12233   beginning with the letters &quot;ba&quot;, then if you type &quot;ba&quot;
12234   followed by a Tab character Alpine will fill in &quot;bar&quot; and stop.
12235   If you then type a second Tab character you will be presented with a list
12236   of matching nicknames to select from. Alternatively, you could type another
12237   &quot;b&quot; resulting in &quot;barb&quot; and then a Tab would fill
12238   in the entire &quot;barbecue&quot; entry.
12239
12240   <P><DT>Defining
12241   <DD> You define multiple personal address books in the
12242   <A HREF="h_abook_config">SETUP AddressBooks</A> screen, which you may reach
12243   from the MAIN MENU.
12244   You may add as many as you like.  Global address books are usually
12245   site-wide address books defined by the System administrator, but
12246   you may define global address books of your own just like you define
12247   personal address books.
12248
12249   <P><DT>Creating and updating
12250   <DD> Personal address books are normally created empty
12251   and populated by explicit additions from within Alpine, e.g. via the
12252   TakeAddr command.  Unlike personal address books, global address books may
12253   not be modified/updated from within Alpine; that is, they are Read-Only.
12254   Thus, global address books are created, populated and updated outside of
12255   Alpine. They might be hand-edited, generated by a program from another
12256   database, or by copying an existing address book.  They might also be
12257   some other user's personal address book, and so be modified normally by
12258   that user but accessed Read-Only by you.  See the Alpine Technical
12259   Notes document (included in the Alpine distribution) for more information on
12260   this.
12261
12262   <P><DT>Accessing
12263   <DD>There are two different types of address books in Alpine.
12264   A local address book is stored in a regular file and the normal file
12265   access permissions apply.  A remote address book is stored on an IMAP
12266   server in a special folder that contains only messages pertaining to
12267   that address book.  The last message in the remote folder contains a
12268   copy of the address book data, and that data is copied to a local cache
12269   file in your home directory.  From there it is accessed just like a local
12270   address book.  The name of the cache file is kept track of in a special
12271   file called the
12272   <A HREF="h_config_abook_metafile"><!--#echo var="VAR_remote-abook-metafile"--></A>,
12273   the name of which is stored in
12274   your Alpine configuration file the first time you use a remote address book.
12275   Just as local Alpine address books use a format that only Alpine understands,
12276   remote Alpine address books do the same and other mail reading programs
12277   are unlikely to be able to understand them.<P>
12278   While global address books are explicitly intended to be shared, there is
12279   nothing to prevent you from sharing a personal address book with other
12280   Alpine users. This might be useful in the case of a small workgroup.
12281   However, it is recommended that updates to shared personal address books
12282   be done when other Alpine users are not accessing the address book. Alpine
12283   does not do any file-locking to manage concurrent updates to the
12284   addressbook, but it does check to see if the file has been modified before
12285   making any changes.  Consequently, inadvertent concurrent updates will
12286   only cause other Alpine users to have to restart their address book
12287   operation, which will cause Alpine to reopen the updated file.
12288
12289   <P><DT>Converting to Remote
12290   <DD>The easiest way to convert an existing local
12291   address book into a remote address book is to create an empty new remote
12292   personal address book by typing &quot;A&quot; to execute the
12293   &quot;Add Pers Abook&quot; command in the SETUP Addressbook screen.
12294   Make sure you add a <EM>personal</EM> address book, not a <EM>global</EM>
12295   address book.
12296   After you have added the empty
12297   remote address book, go into the screen for the address book you wish
12298   to copy and &quot;Select&quot; &quot;All&quot;.
12299   This selects every entry in that
12300   address book.  Then type the command &quot;Apply Save&quot;.
12301   You will be asked for the address book to save to.  You may use ^P and ^N
12302   to get to the new empty address book, then hit RETURN and the addresses
12303   will be copied.
12304   At this point you'll probably want to unselect all the entries in the local
12305   address book before proceeding. You do that with
12306   &quot;Select&quot; &quot;unselect All&quot;.
12307
12308 </DL>
12309 <UL>
12310 <LI><A HREF="h_address_format">Explanation of Address formats</A>
12311 </UL>
12312 <P><UL>
12313 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
12314 </UL>
12315 <P>
12316 &lt;End of help on this topic&gt;
12317 </BODY>
12318 </HTML>
12319 ===== h_abook_select_addr =====
12320 <HTML>
12321 <HEAD>
12322 <TITLE>Addressbook Selection Explained</TITLE>
12323 </HEAD>
12324 <BODY>
12325 <H1>SELECT ADDRESS</H1>
12326 <!--chtml if pinemode="function_key"-->
12327 <PRE>
12328 Navigating the List of Messages               General Alpine Commands
12329 -------------------------------               -----------------------
12330 F5   Move to previous entry                   F1  Show this help text
12331 F6   Move to next entry
12332 F7   Show previous screen of address book
12333 F8   Show next screen of address book
12334 F12  WhereIs (search through address book)
12335
12336 Address Selection Commands
12337 --------------------------
12338 F3   Exit the Address Select screen (without selecting an address)
12339 F4   Select the currently highlighted entry
12340 </PRE>
12341 <!--chtml else-->
12342 <PRE>
12343 Navigating the List of Messages               General Alpine Commands
12344 -------------------------------               -----------------------
12345  P   Move to previous entry                    ?  Show this help text
12346  N   Move to next entry
12347  -   Show previous screen of address book
12348 Spc  (space bar) Show next screen of address book
12349  W   WhereIs (search through address book)
12350
12351 Address Selection Commands
12352 --------------------------
12353  E   Exit the Address Select screen (without selecting an address)
12354  S   Select the currently highlighted entry
12355 </PRE>
12356 <!--chtml endif-->
12357 <P>
12358
12359 This screen is designed to let you easily scan your address book(s) in
12360 order to select an entry for the message you are composing.  You cannot
12361 edit your address book in any way at this time, for address book
12362 maintenance, select the address book command when not composing a message.
12363 <P>
12364
12365 If you are composing a message and know the nickname of the person/list you
12366 want, you can bypass this screen by simply typing in the nickname on the
12367 appropriate header line (To:, Cc:, etc.)  Exiting this screen without
12368 selecting an entry does not cancel your message.
12369 <P>
12370
12371 FOR MORE INFORMATION on addressing see
12372 <A HREF="h_address_format">Explanation of Address formats</A>, and the
12373 <A HREF="h_abook_opened">Address Book Screen's</A>
12374 help text.
12375 <P>
12376 &lt;End of help on this topic&gt;
12377 </BODY>
12378 </HTML>
12379 ===== h_abook_select_top =====
12380 <HTML>
12381 <HEAD>
12382 <TITLE>Addressbook Selection Navigation Explained</TITLE>
12383 </HEAD>
12384 <BODY>
12385 <H1>NAVIGATING WHILE SELECTING ADDRESSES</H1>
12386 <!--chtml if pinemode="function_key"-->
12387 <PRE>
12388 Navigating the List of Address Books       General Alpine Commands
12389 ------------------------------------       -----------------------
12390 F4   View the highlighted address book
12391 F5   Move to previous address book         F1  Show this help text
12392 F6   Move to next address book
12393 F7   Show previous screen of address books
12394 F8   Show next screen of address books
12395 F12  WhereIs (search through address books)
12396
12397 Address Selection Commands
12398 --------------------------
12399 F3   Exit the Address Select screen (without selecting an address)
12400 F4   Select the currently selected entries (if using ListMode)
12401 F9   Change to ListMode
12402 </PRE>
12403 <!--chtml else-->
12404 <PRE>
12405 Navigating the List of Address Books       General Alpine Commands
12406 ------------------------------------       -----------------------
12407  &gt;   View the highlighted address book
12408  P   Move to previous address book         ?  Show this help text
12409  N   Move to next address book
12410  -   Show previous screen of address books
12411 Spc  (space bar) Show next screen of address books
12412  W   WhereIs (search through address books)
12413
12414 Address Selection Commands
12415 --------------------------
12416  E   Exit the Address Select screen (without selecting an address)
12417  S   Select the currently selected entries (if using ListMode)
12418  L   Change to ListMode
12419 </PRE>
12420 <!--chtml endif-->
12421 <P>
12422
12423 This screen is designed to let you easily scan your address book(s) in
12424 order to select entries for the message you are composing.  You cannot
12425 edit your address book in any way at this time.  For address book
12426 maintenance, select the address book command when not composing a message.
12427 <P>
12428
12429 If you are composing a message and know the nickname of the person/list you
12430 want, you can bypass this screen by simply typing in the nickname on the
12431 appropriate header line (To:, Cc:, etc.)  Exiting this screen without
12432 selecting an entry does not cancel your message.
12433 <P>
12434
12435 The ListMode command will add a column at the left edge of the screen.
12436 You mark the entries that you wish to select with the &quot;X&quot; command.
12437 This allows you to choose more than one entry at a time.
12438 <P>
12439
12440 An alternative method of composing a message to entries in your
12441 address book(s) is to first use the &quot;Select&quot; command from
12442 the address book maintenance screen and then the &quot;Apply&quot;
12443 &quot;ComposeTo&quot; command to start the composer composing to the
12444 selected entries.
12445 <P>
12446
12447 FOR MORE INFORMATION on addressing see
12448 <A HREF="h_address_format">Explanation of Address formats</A>, and the
12449 <A HREF="h_abook_opened">Address Book Screen's</A>
12450 help text.
12451 <P>
12452 &lt;End of help on this topic&gt;
12453 </BODY>
12454 </HTML>
12455 ===== h_abook_select_listmode =====
12456 <HTML>
12457 <HEAD>
12458 <TITLE>Address Listmode Selection from Composer Explained</TITLE>
12459 </HEAD>
12460 <BODY>
12461 <H1>COMPOSER: SELECT ADDRESSES</H1>
12462 <!--chtml if pinemode="function_key"-->
12463 <PRE>
12464 Navigating the List of Messages                 General Alpine Commands
12465 -------------------------------                 -----------------------
12466 F5   Move to previous entry                     F1  Show this help text
12467 F6   Move to next entry
12468 F7   Show previous screen of address book
12469 F8   Show next screen of address book
12470 F12  WhereIs (search through address book)
12471
12472 Address Selection Commands
12473 --------------------------
12474 F3   Exit the Address Select screen (without selecting an address)
12475 F4   Select the currently highlighted entry
12476 F9   Change to ListMode
12477 </PRE>
12478 <!--chtml else-->
12479 <PRE>
12480 Navigating the List of Messages                 General Alpine Commands
12481 -------------------------------                 -----------------------
12482  P   Move to previous entry                     ?  Show this help text
12483  N   Move to next entry
12484  -   Show previous screen of address book
12485 Spc  (space bar) Show next screen of address book
12486  W   WhereIs (search through address book)
12487
12488 Address Selection Commands
12489 --------------------------
12490  E   Exit the Address Select screen (without selecting an address)
12491  S   Select the currently highlighted entry
12492  L   Change to ListMode
12493 </PRE>
12494 <!--chtml endif-->
12495 <P>
12496
12497 This screen is designed to let you easily scan your address book(s) in
12498 order to select entries for the message you are composing.  You cannot
12499 edit your address book in any way at this time, for address book
12500 maintenance, select the address book command when not composing a message.
12501 <P>
12502
12503 If you are composing a message and know the nickname of the person/list you
12504 want, you can bypass this screen by simply typing in the nickname on the
12505 appropriate header line (To:, Cc:, etc.)  Exiting this screen without
12506 selecting an entry does not cancel your message.
12507 <P>
12508
12509 The ListMode command will add a column at the left edge of the screen.
12510 You mark the entries that you wish to select with the &quot;X&quot; command.
12511 This allows you to choose more than one entry at a time.
12512 <P>
12513
12514 An alternative method of composing a message to entries in your
12515 address book(s) is to first use the &quot;Select&quot; command from
12516 the address book maintenance screen and then the &quot;Apply&quot;
12517 &quot;ComposeTo&quot; command to start the composer composing to the
12518 selected entries.
12519 <P>
12520
12521 FOR MORE INFORMATION on addressing see
12522 <A HREF="h_address_format">Explanation of Address formats</A>, and the
12523 <A HREF="h_abook_opened">Address Book Screen's</A>
12524 help text.
12525 <P>
12526 &lt;End of help on this topic&gt;
12527 </BODY>
12528 </HTML>
12529 ===== h_abook_select_checks =====
12530 <HTML>
12531 <HEAD>
12532 <TITLE>Address Selection from Composer Explained</TITLE>
12533 </HEAD>
12534 <BODY>
12535 <H1>COMPOSER: SELECT ADDRESSES</H1>
12536 <!--chtml if pinemode="function_key"-->
12537 <PRE>
12538 Navigating the List of Messages                 General Alpine Commands
12539 -------------------------------                 -----------------------
12540 F5   Move to previous entry                     F1  Show this help text
12541 F6   Move to next entry
12542 F7   Show previous screen of address book
12543 F8   Show next screen of address book
12544 F12  WhereIs (search through address book)
12545
12546 Address Selection Commands
12547 --------------------------
12548 F3   Exit the Address Select screen (without selecting an address)
12549 F4   Select the currently highlighted entry
12550 F8   Either Sets or Unsets all entries in this address book
12551 F9   Set or Unset the highlighted entry
12552 </PRE>
12553 <!--chtml else-->
12554 <PRE>
12555 Navigating the List of Messages                 General Alpine Commands
12556 -------------------------------                 -----------------------
12557  P   Move to previous entry                     ?  Show this help text
12558  N   Move to next entry
12559  -   Show previous screen of address book
12560 Spc  (space bar) Show next screen of address book
12561  W   WhereIs (search through address book)
12562
12563 Address Selection Commands
12564 --------------------------
12565  E   Exit the Address Select screen (without selecting an address)
12566  S   Select the currently highlighted entry
12567  X   Set or Unset the highlighted entry
12568  A   Either Sets or Unsets all entries in this address book
12569 </PRE>
12570 <!--chtml endif-->
12571 <P>
12572
12573 Mark the entries you wish to select with the &quot;X Set/Unset&quot;
12574 command.  Type &quot;S Select&quot; to select all of the entries you
12575 have marked, just as if you had typed them in by hand.
12576 <P>
12577
12578 An alternative method of composing a message to entries in your
12579 address book(s) is to first use the &quot;Select&quot; command from
12580 the address book maintenance screen and then the &quot;Apply&quot;
12581 &quot;ComposeTo&quot; command to start the composer composing to the
12582 selected entries.
12583 <P>
12584
12585 FOR MORE INFORMATION on addressing see
12586 <A HREF="h_address_format">Explanation of Address formats</A>, and the
12587 <A HREF="h_abook_opened">Address Book Screen's</A>
12588 help text.
12589 <P>
12590 &lt;End of help on this topic&gt;
12591 </BODY>
12592 </HTML>
12593 ===== h_abook_select_nicks_take =====
12594 <HTML>
12595 <HEAD>
12596 <TITLE>Take Address Nickname Selection Explained</TITLE>
12597 </HEAD>
12598 <BODY>
12599 <H1>TAKEADDR: SELECT NICKNAME</H1>
12600 <!--chtml if pinemode="function_key"-->
12601 <PRE>
12602 Navigating the List of Messages                 General Alpine Commands
12603 -------------------------------                 -----------------------
12604 F5   Move to previous entry                     F1  Show this help text
12605 F6   Move to next entry
12606 F7   Show previous screen of address book
12607 F8   Show next screen of address book
12608 F12  WhereIs (search through address book)
12609
12610 Message Selection Commands
12611 --------------------------
12612 F3   Exit the Nickname Select screen (without selecting an address)
12613 F4   Select the currently highlighted entry
12614 </PRE>
12615 <!--chtml else-->
12616 <PRE>
12617 Navigating the List of Messages                 General Alpine Commands
12618 -------------------------------                 -----------------------
12619  P   Move to previous entry                     ?  Show this help text
12620  N   Move to next entry
12621  -   Show previous screen of address book
12622 Spc  (space bar) Show next screen of address book
12623  W   WhereIs (search through address book)
12624
12625 Message Selection Commands
12626 --------------------------
12627  E   Exit the Nickname Select screen (without selecting an address)
12628  S   Select the currently highlighted entry
12629 </PRE>
12630 <!--chtml endif-->
12631 <P>
12632
12633 This screen is designed to let you modify or add to an existing
12634 address book entry.  You have already selected the name(s) and
12635 address(es) through &quot;Take Address&quot;.  This screen simply lets
12636 you scan your address books and select the nickname to be
12637 changed/augmented.  If you want to add a new entry, then you are in
12638 the wrong place-- Select &quot;Exit&quot; command.
12639 <P>
12640
12641 FOR MORE INFORMATION on addressing see
12642 <A HREF="h_address_format">Explanation of Address formats</A>, and the
12643 <A HREF="h_abook_opened">Address Book Screen's</A>
12644 help text.
12645 <P>
12646 &lt;End of help on this topic&gt;
12647 </BODY>
12648 </HTML>
12649 ===== h_abook_select_nick =====
12650 <HTML>
12651 <HEAD>
12652 <TITLE>Nickname Selection Explained</TITLE>
12653 </HEAD>
12654 <BODY>
12655 <H1>SELECT NICKNAME</H1>
12656 <!--chtml if pinemode="function_key"-->
12657 <PRE>
12658 Navigating the List of Messages                 General Alpine Commands
12659 -------------------------------                 -----------------------
12660 F5   Move to previous entry                     F1  Show this help text
12661 F6   Move to next entry
12662 F7   Show previous screen of address book
12663 F8   Show next screen of address book
12664 F12  WhereIs (search through address book)
12665
12666 Message Selection Commands
12667 --------------------------
12668 F3   Exit the Nickname Select screen (without selecting an address)
12669 F4   Select the currently highlighted entry
12670 </PRE>
12671 <!--chtml else-->
12672 <PRE>
12673 Navigating the List of Messages                 General Alpine Commands
12674 -------------------------------                 -----------------------
12675  P   Move to previous entry                     ?  Show this help text
12676  N   Move to next entry
12677  -   Show previous screen of address book
12678 Spc  (space bar) Show next screen of address book
12679  W   WhereIs (search through address book)
12680
12681 Message Selection Commands
12682 --------------------------
12683  E   Exit the Nickname Select screen (without selecting an address)
12684  S   Select the currently highlighted entry
12685 </PRE>
12686 <!--chtml endif-->
12687 <P>
12688
12689 This screen is designed to let you look at the nicknames in your address
12690 books before choosing a new one.
12691 <P>
12692
12693 FOR MORE INFORMATION on addressing see
12694 <A HREF="h_address_format">Explanation of Address formats</A>, and the
12695 <A HREF="h_abook_opened">Address Book Screen's</A>
12696 help text.
12697 <P>
12698 &lt;End of help on this topic&gt;
12699 </BODY>
12700 </HTML>
12701 ===== h_takeaddr_screen =====
12702 <HTML>
12703 <HEAD>
12704 <TITLE>Take Address Screen Explained</TITLE>
12705 </HEAD>
12706 <BODY>
12707 <H1>TAKE ADDRESS COMMANDS</H1>
12708 <!--chtml if pinemode="function_key"-->
12709 <PRE>
12710 Navigating the List of Addresses       Address Selection Commands
12711 --------------------------------       --------------------------
12712  F5  Move to previous entry            F3  Exit without taking address
12713  F6  Move to next entry                F4  Take current address(es)
12714  F7  Show previous page of address list
12715  F8  Show next page of address list
12716  F2  WhereIs (search list)
12717                                --------------
12718 Mode Toggle            F9  Set/Unset current address
12719 -----------            F10 Set all
12720  F12 Toggle between List and single mode       F11 Unset all
12721 </PRE>
12722 <!--chtml else-->
12723 <PRE>
12724 Navigating the List of Addresses       Address Selection Commands
12725 --------------------------------       --------------------------
12726  P  Move to previous entry              &lt;  Exit without taking address
12727  N  Move to next entry                  T  Take address
12728  -  Show previous page of address list
12729 Spc (space bar) Show next page of address list
12730  W  WhereIs (search list)              List Mode
12731                                        ---------
12732 Single Mode                             X  Set/Unset current address
12733 -----------                             A  Set all addresses
12734  L  Switch to list mode                 U  Unset all addresses
12735                                         S  Switch to single mode
12736 </PRE>
12737 <!--chtml endif-->
12738
12739 <H2>Description of the Take Address Screen</H2>
12740
12741 This screen is designed to let you select one or more address/name
12742 combinations from the current message and put them into your address book.
12743 The cursor is initially placed on the line with the message author.
12744 Other lines include the names of people and/or mailing lists who also
12745 received the message.  Other people &quot;involved&quot; in the
12746 message (e.g. the person named as Reply-To:) are also listed here.
12747 <P>
12748
12749 The simple case is adding a new, single entry into your address book. To
12750 do this, simply highlight the correct line and press
12751 <!--chtml if pinemode="function_key"-->
12752 F4.
12753 <!--chtml else-->
12754 &quot;T&quot;.
12755 <!--chtml endif-->
12756 To create a new list or add to an existing list, switch the screen display
12757 into List Mode by pressing
12758 <!--chtml if pinemode="function_key"-->
12759 F12.
12760 <!--chtml else-->
12761 &quot;L&quot;.
12762 <!--chtml endif-->
12763 In List Mode, you select the
12764 group of addresses you wish to manipulate by marking them with an
12765 &quot;X&quot;.
12766 The Set/Unset
12767 <!--chtml if pinemode="function_key"-->
12768 (F9)
12769 <!--chtml else-->
12770 (&quot;X&quot;)
12771 <!--chtml endif-->
12772 command will turn the &quot;X&quot; on for the
12773 highlighted address if it was off or turn it off if it was previously on.
12774 The SetAll command will select all of the addresses, and the UnSetAll
12775 command will turn off all the selections.  Once you've gotten the
12776 selection the way you want it, you may create a new list by pressing
12777 <!--chtml if pinemode="function_key"-->
12778 F4.
12779 <!--chtml else-->
12780 &quot;T&quot;.
12781 <!--chtml endif-->
12782 <P>
12783
12784 In both the simple and list cases, after choosing to take the address,
12785 you will be asked for the nickname of the entry.  Typing in a new name
12786 creates the new entry/list.  Entering an existing nickname will replace
12787 the entry (simple case) or add to the list (list case).  Alternatively,
12788 you can press Ctrl-T at the nickname prompt and select an existing
12789 nickname from your address book.
12790 <P>
12791
12792 You will normally start in Single Mode, unless you used the Apply command
12793 to startup the TakeAddr screen, in which case you will start in List Mode.
12794 You may switch between the two modes at any time.  If you've already
12795 selected several addresses in List Mode, those will be remembered when you
12796 switch to Single Mode and then back to List Mode.  The set of addresses
12797 that are pre-selected when you start in List Mode are the From addresses
12798 of all of the messages you are operating on.  You may, of course, easily
12799 erase those selections with the UnSetAll command.
12800 <P>
12801
12802 If you have more than one writable address book, you will be prompted for
12803 the name of the address book you wish to add the new entry to before
12804 anything else. You can use ^N and ^P to choose among the defined address
12805 books, or type in the address book name.
12806 <P>
12807
12808 FOR MORE INFORMATION on addressing see
12809 <A HREF="h_address_format">Explanation of Address formats</A>, and the
12810 <A HREF="h_abook_opened">Address Book Screen's</A>
12811 help text.
12812 <P>
12813 &lt;End of help on this topic&gt;
12814 </BODY>
12815 </HTML>
12816 ===== h_takeexport_screen =====
12817 <HTML>
12818 <HEAD>
12819 <TITLE>Take Export Screen Explained</TITLE>
12820 </HEAD>
12821 <BODY>
12822 <H1>TAKE EXPORT COMMANDS</H1>
12823 <!--chtml if pinemode="function_key"-->
12824 <PRE>
12825 Navigating the List of Addresses       Address Selection Commands
12826 --------------------------------       --------------------------
12827  F5  Move to previous entry            F3  Exit without taking address
12828  F6  Move to next entry                F4  Take current address(es)
12829  F7  Show previous page of address list
12830  F8  Show next page of address list
12831  F2  WhereIs (search list)
12832                                --------------
12833 Mode Toggle            F9  Set/Unset current address
12834 -----------            F10 Set all
12835  F12 Toggle between List and single mode       F11 Unset all
12836 </PRE>
12837 <!--chtml else-->
12838 <PRE>
12839 Navigating the List of Addresses       Address Selection Commands
12840 --------------------------------       --------------------------
12841  P  Move to previous entry              &lt;  Exit without taking address
12842  N  Move to next entry                  T  Take address
12843  -  Show previous page of address list
12844 Spc (space bar) Show next page of address list
12845  W  WhereIs (search list)              List Mode
12846                                        ---------
12847 Single Mode                             X  Set/Unset current address
12848 -----------                             A  Set all addresses
12849  L  Switch to list mode                 U  Unset all addresses
12850                                         S  Switch to single mode
12851 </PRE>
12852 <!--chtml endif-->
12853
12854 <H2>Description of the Take Export Screen</H2>
12855
12856 This screen is designed to let you select one or more addresses
12857 from the current message and put them into a file.
12858 Only the user@domain_name part of each address is put into the file.
12859 <P>
12860
12861 To put a single entry into a file simply highlight the correct line and press
12862 <!--chtml if pinemode="function_key"-->
12863 F4.
12864 <!--chtml else-->
12865 &quot;T&quot;.
12866 <!--chtml endif-->
12867 To put more than one entry into a file
12868 switch the screen display
12869 into List Mode by pressing
12870 <!--chtml if pinemode="function_key"-->
12871 F12.
12872 <!--chtml else-->
12873 &quot;L&quot;.
12874 <!--chtml endif-->
12875 In List Mode, you select the
12876 group of addresses you wish to manipulate by marking them with an
12877 &quot;X&quot;.
12878 The Set/Unset
12879 <!--chtml if pinemode="function_key"-->
12880 (F9)
12881 <!--chtml else-->
12882 (&quot;X&quot;)
12883 <!--chtml endif-->
12884 command will turn the &quot;X&quot; on for the
12885 highlighted address if it was off or turn it off if it was previously on.
12886 The SetAll command will select all of the addresses, and the UnSetAll
12887 command will turn off all the selections.  Once you've gotten the
12888 selection the way you want it, you may put the addresses in a file by typing
12889 <!--chtml if pinemode="function_key"-->
12890 F4.
12891 <!--chtml else-->
12892 &quot;T&quot;.
12893 <!--chtml endif-->
12894 <P>
12895
12896 You will be asked for the name of a file to put the addresses in.
12897 If the file already exists, you will be asked whether you want to Overwrite
12898 (replace) the contents of the file or Append to the contents of the file.
12899 <P>
12900
12901 &lt;End of help on this topic&gt;
12902 </BODY>
12903 </HTML>
12904 ============= h_abook_view ========================
12905 <HTML>
12906 <HEAD>
12907 <TITLE>Address Book View Explained</TITLE>
12908 </HEAD>
12909 <BODY>
12910 This function allows you to view the contents of an address book entry. You
12911 can only view one entry at a time.
12912 <P>
12913 <DL>
12914 <DT>Help
12915 <!--chtml if pinemode="function_key"-->
12916 (F1)
12917 <!--chtml else-->
12918 (?)
12919 <!--chtml endif-->
12920 </DT>
12921 <DD>
12922 Display this help text.
12923
12924 <DT>Abook
12925 <!--chtml if pinemode="function_key"-->
12926 (F3)
12927 <!--chtml else-->
12928 (&lt;)
12929 <!--chtml endif-->
12930 </DT>
12931 <DD>
12932 Go back to index of address book entries.
12933
12934 <DT>Update
12935 <!--chtml if pinemode="function_key"-->
12936 (F4)
12937 <!--chtml else-->
12938 (U)
12939 <!--chtml endif-->
12940 </DT>
12941 <DD>
12942 Update (modify) this entry.
12943
12944 <DT>ComposeTo
12945 <!--chtml if pinemode="function_key"-->
12946 (F5)
12947 <!--chtml else-->
12948 (C)
12949 <!--chtml endif-->
12950 </DT>
12951 <DD>Compose a message to the address(es) in this entry.
12952
12953 <DT>Role
12954 <!--chtml if pinemode="function_key"-->
12955 (F6)
12956 <!--chtml else-->
12957 (#)
12958 <!--chtml endif-->
12959 </DT>
12960 <DD>Compose a message to the address(es) in this entry using roles.
12961
12962 <DT>Prev Page
12963 <!--chtml if pinemode="function_key"-->
12964 (F7)
12965 <!--chtml else-->
12966 (-)
12967 <!--chtml endif-->
12968 </DT>
12969 <DD>
12970 Show the previous page of the current entry.
12971
12972 <DT>Next Page
12973 <!--chtml if pinemode="function_key"-->
12974 (F8)
12975 <!--chtml else-->
12976 (Space)
12977 <!--chtml endif-->
12978 </DT>
12979 <DD>
12980 Show the next page of the current entry.
12981
12982 <DT>Print
12983 <!--chtml if pinemode="function_key"-->
12984 (F9)
12985 <!--chtml else-->
12986 (%)
12987 <!--chtml endif-->
12988 </DT>
12989 <DD>Print the current entry.  You can select the
12990 printer or the print command via the &quot;Setup&quot; command
12991 on the MAIN MENU.
12992
12993 <DT>WhereIs
12994 <!--chtml if pinemode="function_key"-->
12995 (F10)
12996 <!--chtml else-->
12997 (W)
12998 <!--chtml endif-->
12999 </DT>
13000 <DD>Search the entry for a string of letters.  If it is
13001 found, move to it.  The string can be one word or a phrase.
13002 If there are multiple occurrences, the cursor moves to the
13003 first occurrence beyond the current cursor position.
13004
13005 <DT>Fwd Email
13006 <!--chtml if pinemode="function_key"-->
13007 (F11)
13008 <!--chtml else-->
13009 (F)
13010 <!--chtml endif-->
13011 </DT>
13012 <DD>Begin composition of a new mail message with the displayed
13013 text already inserted in the message body.
13014
13015 </DL>
13016 <P>
13017 &lt;End of help on this topic&gt;
13018 </BODY>
13019 </HTML>
13020 ============= h_ldap_view ========================
13021 <HTML>
13022 <HEAD>
13023 <TITLE>LDAP Response View Explained</TITLE>
13024 </HEAD>
13025 <BODY>
13026 This function allows you to view the contents of a directory entry. You
13027 can only view one entry at a time.
13028 <P>
13029 <DL>
13030 <DT>Help
13031 <!--chtml if pinemode="function_key"-->
13032 (F1)
13033 <!--chtml else-->
13034 (?)
13035 <!--chtml endif-->
13036 </DT>
13037 <DD>
13038 Display this help text.
13039
13040 <DT>Results Index
13041 <!--chtml if pinemode="function_key"-->
13042 (F3)
13043 <!--chtml else-->
13044 (&lt;)
13045 <!--chtml endif-->
13046 </DT>
13047 <DD>Go back to index of search results.
13048
13049 <DT>ComposeTo
13050 <!--chtml if pinemode="function_key"-->
13051 (F5)
13052 <!--chtml else-->
13053 (C)
13054 <!--chtml endif-->
13055 </DT>
13056 <DD>Compose a message to the address(es) in this entry.
13057
13058 <DT>Role
13059 <!--chtml if pinemode="function_key"-->
13060 (F6)
13061 <!--chtml else-->
13062 (#)
13063 <!--chtml endif-->
13064 </DT>
13065 <DD>Compose a message to the address(es) in this entry using roles.
13066
13067 <DT>Prev Page
13068 <!--chtml if pinemode="function_key"-->
13069 (F7)
13070 <!--chtml else-->
13071 (-)
13072 <!--chtml endif-->
13073 </DT>
13074 <DD>
13075 Show the previous page of the current entry.
13076
13077 <DT>Next Page
13078 <!--chtml if pinemode="function_key"-->
13079 (F8)
13080 <!--chtml else-->
13081 (Space)
13082 <!--chtml endif-->
13083 </DT>
13084 <DD>
13085 Show the next page of the current entry.
13086
13087 <DT>Print
13088 <!--chtml if pinemode="function_key"-->
13089 (F9)
13090 <!--chtml else-->
13091 (%)
13092 <!--chtml endif-->
13093 </DT>
13094 <DD>Print the current entry on paper.  You can select the
13095 printer or the print command via the &quot;Setup&quot; command
13096 on the MAIN MENU.
13097
13098 <DT>WhereIs
13099 <!--chtml if pinemode="function_key"-->
13100 (F10)
13101 <!--chtml else-->
13102 (W)
13103 <!--chtml endif-->
13104 </DT>
13105 <DD>Search the entry for a string of letters.  If it is
13106 found, move to it.  The string can be one word or a phrase.
13107 If there are multiple occurrences, the cursor moves to the
13108 first occurrence beyond the current cursor position.
13109
13110 <DT>Fwd Email
13111 <!--chtml if pinemode="function_key"-->
13112 (F11)
13113 <!--chtml else-->
13114 (F)
13115 <!--chtml endif-->
13116 </DT>
13117 <DD>Begin composition of a new mail message with the displayed
13118 text already inserted in the message body.
13119
13120 <DT>Save
13121 <!--chtml if pinemode="function_key"-->
13122 (F12)
13123 <!--chtml else-->
13124 (S)
13125 <!--chtml endif-->
13126 </DT>
13127 <DD>Save the displayed entry to one of your address books or export
13128 it to a file.
13129 </DL>
13130 <P>
13131 &lt;End of help on this topic&gt;
13132 </BODY>
13133 </HTML>
13134 ===== h_attachment_screen =====
13135 <HTML>
13136 <HEAD>
13137 <TITLE>Attachment Index Screen Explained</TITLE>
13138 </HEAD>
13139 <BODY>
13140 The &quot;ATTACHMENT INDEX&quot; displays a list of the current
13141 message's attachments, and allows various operations on them.  The
13142 first attachment is usually the message text, but does not include the
13143 header portion of the message.
13144 <P>
13145 Available commands include:
13146 <P>
13147 <DL>
13148
13149 <DT>Help</DT>
13150 <DD>Show this help text.
13151
13152 <DT>Msg #<I>num</I></DT>
13153 <DD>Leave this screen without displaying or saving any attachments.
13154
13155 <DT>View</DT>
13156 <DD>View the currently selected attachment.
13157
13158 <DT>Prev Attach</DT>
13159 <DD>Move to previous attachment.
13160
13161 <DT>Next Attach</DT>
13162 <DD>Move to next attachment.
13163
13164 <DT>Prev Page</DT>
13165 <DD>Previous page of the listed attachments.
13166
13167 <DT>Next Page</DT>
13168 <DD>Next page of the listed attachments.
13169
13170 <DT>Delete</DT>
13171 <DD>Mark the currently selected attachment for Deletion.
13172 This does not modify the current message by deleting the attachment from
13173 it, but instead the delete flag <EM>only</EM> has an effect when saving
13174 the message to a folder.
13175 Attachments marked for deletion are not copied to the destination folder
13176 along with the rest of the message when it is saved.
13177 It is ok for the destination folder to be the same as the current folder.
13178 In addition, the delete mark <EM>only</EM> applies to this Alpine session.
13179
13180 <DT>Undelete</DT>
13181 <DD>Turn off the Delete flag for the selected attachment.
13182
13183 <DT>Save</DT>
13184 <DD>Save the selected attachment to a file.  If the attachment is of
13185 type &quot;RFC822/Message&quot;, then the attachment will be saved to
13186 the specified mail folder.
13187
13188 <DT>Export</DT>
13189 <DD>If the attachment is of
13190 type &quot;RFC822/Message&quot;, then &quot;Export&quot; is used to
13191 copy the message to a file in the same way this command works on
13192 messages in the MESSAGE INDEX and MESSAGE TEXT screens.
13193
13194 <DT>Pipe</DT>
13195 <DD>Pipe the attachment contents into a UNIX command (if enabled).
13196 A description of the Pipe sub-commands is  <A HREF="h_pipe_command">here</A>.
13197
13198 <DT>WhereIs</DT>
13199 <DD>Find a matching string in the attachment list.
13200
13201 <DT>AboutAttch</DT>
13202 <DD>Examine various aspects of the selected attachment.
13203
13204 <DT>Print</DT>
13205 <DD>Print the selected attachment.
13206
13207 <DT>Forward</DT>
13208 <DD>Forward the selected attachment as an attachment.
13209 </DL>
13210
13211 <P>
13212
13213 All attachments can be saved or piped into a UNIX command, but some may
13214 not be readily displayed by either Alpine or an external tool.  In such
13215 cases, the reason why the message cannot be displayed is displayed on
13216 Alpine's message line.
13217 <P>
13218 &lt;End of help on this topic&gt;
13219 </BODY>
13220 </HTML>
13221 ============= h_mail_text_att_view ========================
13222 <HTML>
13223 <HEAD>
13224 <TITLE>Attachment View Screen Explained</TITLE>
13225 </HEAD>
13226 <BODY>
13227 This function allows you to view the contents of a text attachment. You
13228 can only view one attachment at a time.
13229 <P>
13230 Available commands include:
13231 <P>
13232 <DL>
13233
13234 <DT>Help</DT>
13235 <DD>Display this help text
13236
13237 <DT>AttchIndex</DT>
13238 <DD>Leave viewer and return to the &quot;ATTACHMENT INDEX&quot; screen
13239
13240 <DT>Prev Page</DT>
13241 <DD>Show the previous page of the current attachment.
13242
13243 <DT>Next Page</DT>
13244 <DD>Show the next page of the current attachment by pressing the space bar.
13245
13246 <DT>Delete</DT>
13247 <DD>Mark the viewed attachment for Deletion.  The delete
13248 flag <EM>only</EM> has affect when saving the message to a folder.
13249 Attachments marked for deletion are exluded from the messsage when
13250 it is saved.  In addition, the delete mark <EM>only</EM> applies to
13251 this Alpine session.
13252
13253 <DT>Undelete</DT>
13254 <DD>Turn off the Delete flag for the selected attachment.
13255
13256 <DT>Save</DT>
13257 <DD>Copy the current attachment to a file.  If you just enter
13258 a filename, the attachment will be saved with that name in
13259 your home directory
13260 <!--chtml if pinemode="running"-->
13261 (which, in the present configuration of your system, is
13262  &quot;<!--#echo var="HOME_DIR"-->&quot;)
13263 <!--chtml endif-->
13264 or current working directory
13265 <!--chtml if pinemode="running"-->
13266 (which, at least for your current Alpine &quot;session,&quot;
13267 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
13268 <!--chtml endif-->, depending on the
13269 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
13270 configuration setting.  You may enter the full
13271 path and filename to save it in another directory instead.
13272
13273 <DT>Export</DT>
13274 <DD>If the attachment is of
13275 type &quot;RFC822/Message&quot;, then &quot;Export&quot; is used to
13276 copy the message to a file in the same way this command works on
13277 messages in the MESSAGE INDEX and MESSAGE TEXT screens.
13278 (If you have any <A HREF="h_config_display_filters"><!--#echo var="VAR_display-filters"--></A>
13279 defined, they may affect the contents of the exported file.)
13280
13281 <DT>Pipe</DT>
13282 <DD>Pipe the attachment contents into a UNIX command (if enabled)
13283
13284 <DT>WhereIs</DT>
13285 <DD>Search the attachment for a string of letters.  If it is
13286 found, move to it.  The string can be one word or a phrase.
13287 If there are multiple occurrences, the cursor moves to the
13288 first occurrence beyond the current cursor position.
13289
13290 <DT>Print</DT>
13291 <DD>Print the current attachment on paper.  You can select the
13292 printer or the print command via the &quot;Setup&quot; command
13293 on the MAIN MENU.
13294
13295 <DT>Forward</DT>
13296 <DD>Forward the selected attachment as an attachment.
13297 </DL>
13298 <P>
13299 &lt;End of help on this topic&gt;
13300 </BODY>
13301 </HTML>
13302 ============= h_journal ==============
13303 <HTML>
13304 <HEAD>
13305 <TITLE>Recent Message Journal Explained</TITLE>
13306 </HEAD>
13307 <BODY>
13308
13309 The following commands are available on this screen:
13310 <P>
13311 <DL>
13312 <DT>Help</DT>
13313 <DD>Show this help text
13314
13315 <DT>Exit</DT>
13316 <DD>Exit Viewer, and go back to mail processing
13317
13318 <DT>Prev Page</DT>
13319 <DD>Show the previous page text
13320
13321 <DT>Next Page</DT>
13322 <DD>Show the next page of text by pressing the space bar
13323
13324 <DT>Print</DT>
13325 <DD>Print the displayed text on paper.  You can select the
13326 printer or the print command via the &quot;Setup&quot; command
13327 on the MAIN MENU.
13328
13329 <DT>Fwd Email</DT>
13330 <DD>Begin composition of a new mail message with the displayed
13331 text already inserted in the message body.
13332
13333 <DT>Save</DT>
13334 <DD>Copy the displayed text to a file.  If you just enter
13335 a filename, the text will be saved with that name in
13336 your
13337 home directory
13338 <!--chtml if pinemode="running"-->
13339 (which, in the present configuration of your system, is
13340  &quot;<!--#echo var="HOME_DIR"-->&quot;)
13341 <!--chtml endif-->
13342 or current working directory
13343 <!--chtml if pinemode="running"-->
13344 (which, at least for your current Alpine &quot;session,&quot;
13345 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
13346 <!--chtml endif-->, depending on the
13347 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
13348 configuration setting.   You may enter the full
13349 path and filename to save it in another directory instead.
13350
13351 <DT>WhereIs</DT>
13352 <DD>Search the text for a string of letters.  If it is
13353 found, move to it.  The string can be one word or a phrase.
13354 If there are multiple occurrences, the cursor moves to the
13355 first occurrence beyond the current cursor position.
13356 </DL>
13357 <P>
13358 &lt;End of help on this topic&gt;
13359 </BODY>
13360 </HTML>
13361 ============= h_debugjournal ==============
13362 <HTML>
13363 <HEAD>
13364 <TITLE>Debug Journal Explained</TITLE>
13365 </HEAD>
13366 <BODY>
13367
13368 The following commands are available on this screen:
13369 <P>
13370 <DL>
13371 <DT>Help</DT>
13372 <DD>Show this help text
13373
13374 <DT>Exit</DT>
13375 <DD>Exit Viewer, and go back to mail processing
13376
13377 <DT>Timestamps</DT>
13378 <DD>Turn on or off timestamps.
13379
13380 <DT>DebugView</DT>
13381 <DD>Set the level of debugging you want to see. The level may be any number
13382 in the range 0-9. Higher numbers show more debugging detail. Note that the
13383 debugging information has already been captured. This setting just causes the
13384 debugging information that you see to be filtered. If you set this to
13385 the number &quot;5&quot; then you will be shown all of the debugging information
13386 at levels 5 and below.
13387 It's actually a bit more complicated than that. A fixed amount of memory
13388 is used to store the debug information.
13389 Since the amount of memory used is limited the debugging information
13390 has to be trimmed back when it gets too large.
13391
13392 <DT>Prev Page</DT>
13393 <DD>Show the previous page text
13394
13395 <DT>Next Page</DT>
13396 <DD>Show the next page of text by pressing the space bar
13397
13398 <DT>Print</DT>
13399 <DD>Print the displayed text on paper.  You can select the
13400 printer or the print command via the &quot;Setup&quot; command
13401 on the MAIN MENU.
13402
13403 <DT>Fwd Email</DT>
13404 <DD>Begin composition of a new mail message with the displayed
13405 text already inserted in the message body.
13406
13407 <DT>Save</DT>
13408 <DD>Copy the displayed text to a file.  If you just enter
13409 a filename, the text will be saved with that name in
13410 your
13411 home directory
13412 <!--chtml if pinemode="running"-->
13413 (which, in the present configuration of your system, is
13414  &quot;<!--#echo var="HOME_DIR"-->&quot;)
13415 <!--chtml endif-->
13416 or current working directory
13417 <!--chtml if pinemode="running"-->
13418 (which, at least for your current Alpine &quot;session,&quot;
13419 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
13420 <!--chtml endif-->, depending on the
13421 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
13422 configuration setting.   You may enter the full
13423 path and filename to save it in another directory instead.
13424
13425 <DT>WhereIs</DT>
13426 <DD>Search the text for a string of letters.  If it is
13427 found, move to it.  The string can be one word or a phrase.
13428 If there are multiple occurrences, the cursor moves to the
13429 first occurrence beyond the current cursor position.
13430 </DL>
13431 <P>
13432 &lt;End of help on this topic&gt;
13433 </BODY>
13434 </HTML>
13435 ============= h_simple_text_view ==============
13436 <HTML>
13437 <HEAD>
13438 <TITLE>Simple Text View Screen Explained</TITLE>
13439 </HEAD>
13440 <BODY>
13441
13442 The following commands are available on this screen:
13443 <P>
13444 <DL>
13445 <DT>Help</DT>
13446 <DD>Show this help text
13447
13448 <DT>Exit</DT>
13449 <DD>Exit Viewer, and go back to mail processing
13450
13451 <DT>Prev Page</DT>
13452 <DD>Show the previous page text
13453
13454 <DT>Next Page</DT>
13455 <DD>Show the next page of text by pressing the space bar
13456
13457 <DT>Print</DT>
13458 <DD>Print the displayed text on paper.  You can select the
13459 printer or the print command via the &quot;Setup&quot; command
13460 on the MAIN MENU.
13461
13462 <DT>Fwd Email</DT>
13463 <DD>Begin composition of a new mail message with the displayed
13464 text already inserted in the message body.
13465
13466 <DT>Save</DT>
13467 <DD>Copy the displayed text to a file.  If you just enter
13468 a filename, the attachment will be saved with that name in
13469 your
13470 home directory
13471 <!--chtml if pinemode="running"-->
13472 (which, in the present configuration of your system, is
13473  &quot;<!--#echo var="HOME_DIR"-->&quot;)
13474 <!--chtml endif-->
13475 or current working directory
13476 <!--chtml if pinemode="running"-->
13477 (which, at least for your current Alpine &quot;session,&quot;
13478 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
13479 <!--chtml endif-->, depending on the
13480 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
13481 configuration setting.   You may enter the full
13482 path and filename to save it in another directory instead.
13483
13484 <DT>WhereIs</DT>
13485 <DD>Search the attachment for a string of letters.  If it is
13486 found, move to it.  The string can be one word or a phrase.
13487 If there are multiple occurrences, the cursor moves to the
13488 first occurrence beyond the current cursor position.
13489 </DL>
13490 <P>
13491 &lt;End of help on this topic&gt;
13492 </BODY>
13493 </HTML>
13494 ======= h_pine_for_windows ========
13495 <HTML>
13496 <HEAD>
13497 <TITLE>GETTING HELP IN PC-ALPINE</TITLE>
13498 </HEAD>
13499 <BODY>
13500 <H1>Getting Help In PC-Alpine</H1>
13501
13502 <P>
13503 PC-Alpine offers general and specific help text. From the <A
13504 HREF="main_menu_tx">MAIN MENU</A>, you will find an overview in the MAIN
13505 MENU HELP and the <A HREF="h_news">Release Notes</A>.  On all screens,
13506 specific help for that screen is available from the toolbar Help menu or
13507 with the
13508 <!--chtml if pinemode="function_key"-->
13509 &quot;F1&quot; key.
13510 <!--chtml else-->
13511 &quot;?&quot; or &quot;Ctrl-G&quot; keys. &quot;Ctrl-G&quot; is used where
13512 typing &quot;?&quot; would be mistaken as entering text.
13513 <!--chtml endif-->
13514
13515 <P>
13516 Although this version of Alpine is for Microsoft Windows, it is not
13517 considered a full &quot;Graphical User Interface&quot; application.
13518 Yet, many of the controls that Windows users are accustomed to seeing,
13519 such as scrollbars and toolbars, are available.
13520
13521 <P>
13522 PC-Alpine offers considerable mouse support.  You can view what is
13523 &quot;click-able&quot; by dragging your mouse over any screen; when the
13524 arrow cursor changes into a hand, you found something. Mouse-click
13525 possibilities include navigating between screens and folders and
13526 double-clicking on hyperlinks to open your Web browser.
13527 Context-sensitive pop-up menus appear with a right-click on your PC-Alpine
13528 screen.  Examples of right-click options include &quot;copy&quot; after
13529 selecting text to copy and &quot;View in New Window&quot; when you click
13530 on a particular message in the Message Index. The menu choices available
13531 to you will vary based upon what screen is open, where on the screen your
13532 cursor is located, and even what action you have already taken.
13533
13534 <P>
13535 &lt;End of help on this topic&gt;
13536 </BODY>
13537 </HTML>
13538 ===== h_composer =====
13539 <HTML>
13540 <HEAD>
13541 <TITLE>COMPOSER COMMANDS</TITLE>
13542 </HEAD>
13543 <BODY>
13544 <H1>COMPOSER COMMANDS</H1>
13545
13546 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>
13547 &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>
13548 &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>
13549 &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>
13550 &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>
13551 &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>
13552 &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>
13553 &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>
13554 &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>
13555 &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>
13556 ---------------------------------------|&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>
13557 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>
13558 &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>
13559 &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>
13560 &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>
13561
13562 <P>
13563 NOTE:
13564 <OL>
13565  <LI>For help on a particular command, highlight the bold text associated
13566 with it above and hit Return.
13567  <LI> The availability of certain commands
13568 is determined by Alpine configuration files and system capabilities.
13569 At some sites, certain commands may not be available due to security or
13570 support concerns.
13571  <LI>Alpine does not use the following keys:  Ctrl-S, Ctrl-Q, Ctrl-],
13572 Ctrl-&#92;, ESC.
13573  <LI>For special handling of Ctrl-S and Ctrl-Q see special comments regarding
13574 <A HREF="h_special_xon_xoff">&quot;XOFF/XON&quot;</A>.
13575 </OL>
13576
13577 <P>
13578 HINT: To move rapidly to the bottom of a message you are composing,
13579 enter ^W^V.  To go to the top, ^W^Y.  These can be used in conjunction
13580 with the Mark and Cut commands to eliminate large amounts of unwanted
13581 text in a Reply.
13582
13583 <H2>Description of Composer</H2>
13584
13585 Alpine has a built-in editing program that allows you to compose messages
13586 without having to leave Alpine.  The editor is designed to be very simple to
13587 use so that you can get started writing email right away.
13588
13589 <P>
13590 Messages are usually just text, about 80 columns wide.  Using upper and
13591 lower case is encouraged.  On some systems the size limit of the message
13592 is about 100,000 characters, which is about 2,000 lines.  You can include
13593 punctuation and special characters found on most keyboards, but you can't
13594 include characters with diacritical marks and certain special symbols.
13595
13596 <P>
13597 Text automatically wraps as you type past the end of a line so you do not
13598 have to hit return.  Using the
13599 &quot;<A HREF="h_compose_justify">Justify</A>&quot; command,
13600 you can also reformat text explicitly, perhaps after you have
13601 deleted some text.
13602
13603 <P>
13604 You can include other text files with the
13605 &quot;<A HREF="h_compose_readfile">Read File</A>&quot; command,
13606 which will prompt you for the name of the file to insert at the
13607 current cursor postion.
13608
13609 <P>
13610 <UL>
13611 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
13612 </UL>
13613 <P>
13614 &lt;End of help on this topic&gt;
13615 </BODY>
13616 </HTML>
13617 ====== h_composer_browse =====
13618 <HTML>
13619 <HEAD>
13620 <TITLE>BROWSER</TITLE>
13621 </HEAD>
13622 <BODY>
13623 <H1>BROWSER</H1>
13624 This screen lets you browse your files and directories.  To go to another
13625 directory (identified by &quot;(dir)&quot;), move the cursor to it and
13626 choose &quot;Select&quot; (the default choice on the menu);
13627 or choose &quot;Goto&quot; and enter the name of the directory.
13628 <!--chtml if pinemode="os_windows"-->
13629 <!--chtml else-->
13630 In Unix Alpine, you may use
13631 &quot;~&quot; to refer to your home directory or &quot;~user&quot; to refer
13632 to another's home directory.
13633 <!--chtml endif--><P>
13634 To select a file, move the cursor to it and
13635 choose &quot;Select&quot; (the default choice on the menu).
13636 <P>
13637 <UL>
13638 <LI>Note <B>if</B> you are currently using the BROWSER for choosing a file for
13639 inclusion in the
13640 message body (that is, you chose &quot;Read File&quot; with the cursor under
13641 the
13642 &quot;----- Message Text -----&quot; line
13643 while composing, then &quot;To Files&quot;):  Since the file
13644 selected will become part of the message text, it must be in a format
13645 suitable for that (Alpine does not check!), such as a plain text file.
13646 Files of other formats (for example, graphics, databases, software
13647 programs) should be
13648 <B>attached</B> to the message instead --
13649 by moving the cursor in the COMPOSE MESSAGE screen into the
13650 message header area and pressing
13651 <!--chtml if pinemode="function_key"-->
13652 F6.
13653 <!--chtml else-->
13654 Ctrl-J.
13655 <!--chtml endif-->
13656
13657 <P><LI>
13658 Note <B>if</B> you are currently using the BROWSER for saving a message
13659 attachment, or exporting a message, to a file: You can use the Add command to
13660 provide the name for a new file to save/export to, and then select that name
13661 to use it for the save/export operation.  Back at the prompt
13662 &quot;EXPORT: Copy message to file in ...&quot; hit Enter, then choose
13663 either Overwrite or Append (it doesn't make a difference, since the file is
13664 so far empty).  Note: If you cancel the
13665 operation at that point, the file created with the Add command will remain
13666 0 bytes in size.
13667
13668 </UL>
13669 <P><UL>
13670 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
13671 </UL>
13672 <P>
13673 &lt;End of help on this topic&gt;
13674 </BODY>
13675 </HTML>
13676 ====== h_composer_ins =====
13677 <HTML>
13678 <HEAD>
13679 <TITLE>INSERT TEXT FILE</TITLE>
13680 </HEAD>
13681 <BODY>
13682 <H1>INSERT TEXT FILE</H1>
13683
13684 Use this function to insert a text file. The file name
13685 given can be an absolute file path name for your system
13686 <!--chtml if pinemode="os_windows"-->
13687 (for example, &quot;H:&#92;SIGFILES&#92;FULLINFO.TXT&quot;), a file
13688 with a relative pathname, or simply a file name without
13689 drive or directory specification.
13690 <!--chtml else-->
13691 (for example, &quot;/tmp/exported.earlier&quot; on Unix hosts),
13692 a file in your home directory, or a file path relative to your
13693 home directory.  In Unix Alpine, you may use &quot;~&quot; to refer to
13694 your home directory or &quot;~user&quot; to refer to another
13695 account's home directory.
13696 <!--chtml endif-->
13697 <P>
13698 No wild card characters may be used.
13699 The file must reside on the system running Alpine.
13700 <P>
13701 If the
13702 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
13703 feature is set, names are relative to your current working directory
13704 <!--chtml if pinemode="running"-->
13705 (which, at least for your current Alpine &quot;session,&quot;
13706 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
13707 <!--chtml endif-->
13708 rather than your home directory
13709 <!--chtml if pinemode="running"-->
13710 (which, in the present configuration of your system, is
13711  &quot;<!--#echo var="HOME_DIR"-->&quot;)
13712 <!--chtml endif-->
13713 .
13714 <P><UL>
13715 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
13716 </UL>
13717 <P>
13718 &lt;End of help on this topic&gt;
13719 </BODY>
13720 </HTML>
13721 ====== h_composer_ins_m =====
13722 <HTML>
13723 <HEAD>
13724 <TITLE>INSERT MESSAGE</TITLE>
13725 </HEAD>
13726 <BODY>
13727 <H1>INSERT MESSAGE</H1>
13728
13729 Type in the number of a message in the currently open folder to insert it
13730 into your message.
13731 <P><UL>
13732 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
13733 </UL>
13734 <P>
13735 &lt;End of help on this topic&gt;
13736 </BODY>
13737 </HTML>
13738 ====== h_composer_search =====
13739 <HTML>
13740 <HEAD>
13741 <TITLE>Explanation of Composer Whereis Command </TITLE>
13742 </HEAD>
13743 <BODY>
13744 <H1>Help For Whereis Command</H1>
13745
13746 Whereis is used to search the message for a word or part of a word.
13747 When searching in the composer, only the message part of your mail is
13748 searched, and the cursor is put on the first occurrence appearing
13749 after the location of the cursor.  The search will wrap to the
13750 beginning of the message when it no longer finds matches in the
13751 remainder of the message.
13752
13753 To search for the same string a second time, press
13754 <!--chtml if pinemode="function_key"-->
13755 &quot;F6&quot;
13756 <!--chtml else-->
13757 &quot;^W&quot;
13758 <!--chtml endif-->
13759 to begin search and then just press RETURN to accept the previous
13760 search string shown in square brackets rather than entering a new
13761 search string.<P>
13762
13763 The &quot;Search&quot; prompt has several sub-command available:
13764
13765 <DL>
13766 <DT>Get Help</DT>
13767 <DD> Takes you to this help page.
13768
13769 <DT>Cancel</DT>
13770 <DD> Cancels the prompt.  No search takes place.
13771
13772 <DT>First Line</DT>
13773 <DD> Takes you back to the composer with the cursor on the first character
13774 of the first line of text.
13775
13776 <DT>Last Line</DT>
13777 <DD> Takes you back to the composer with the cursor on the last character
13778 of the last line of text.
13779
13780 <DT>Replace (Optional)</DT>
13781 <DD> This sub-command is enabled by the
13782 <A HREF="h_config_enable_search_and_repl">&quot;<!--#echo var="FEAT_enable-search-and-replace"-->&quot;</A>
13783 feature (which is on by default); see its help screen for details on how replacing works.
13784
13785 </DL>
13786
13787 &lt;End of help on this topic&gt;
13788 </BODY>
13789 </HTML>
13790 ====== h_sigedit_search =====
13791 <HTML>
13792 <HEAD>
13793 <TITLE>Explanation of Whereis Command </TITLE>
13794 </HEAD>
13795 <BODY>
13796 <H1>Help For Whereis Command</H1>
13797
13798 Whereis is used to search for a word or part of a word.
13799 When searching the cursor is put on the first occurrence appearing
13800 after the location of the cursor.  The search will wrap to the
13801 beginning of the signature when it no longer finds matches in the
13802 remainder of the signature.
13803
13804 To search for the same string a second time, press
13805 <!--chtml if pinemode="function_key"-->
13806 &quot;F6&quot;
13807 <!--chtml else-->
13808 &quot;^W&quot;
13809 <!--chtml endif-->
13810 to begin search and then just press RETURN to accept the previous
13811 search string shown in square brackets rather than entering a new
13812 search string.<P>
13813
13814 The &quot;Search&quot; prompt has several sub-command available:
13815
13816 <DL>
13817 <DT>Get Help</DT>
13818 <DD> Takes you to this help page.
13819
13820 <DT>Cancel</DT>
13821 <DD> Cancels the prompt.  No search takes place.
13822
13823 <DT>First Line</DT>
13824 <DD> Takes you back to the composer with the cursor on the first character
13825 of the first line of text.
13826
13827 <DT>Last Line</DT>
13828 <DD> Takes you back to the composer with the cursor on the last character
13829 of the last line of text.
13830
13831 <DT>Replace (Optional)</DT>
13832 <DD> This sub-command is enabled by the
13833 <A HREF="h_config_enable_search_and_repl">&quot;<!--#echo var="FEAT_enable-search-and-replace"-->&quot;</A>
13834 feature (which is on by default); see its help screen for details on how replacing works.
13835
13836 </DL>
13837
13838 &lt;End of help on this topic&gt;
13839 </BODY>
13840 </HTML>
13841 ======= h_composer_to ====
13842 <HTML>
13843 <HEAD>
13844 <TITLE>THE MESSAGE COMPOSER'S TO FIELD</TITLE>
13845 </HEAD>
13846 <BODY>
13847 <H1>THE MESSAGE COMPOSER'S TO FIELD</H1>
13848
13849 <H2>The &quot;To:&quot; field</H2>
13850 The address you enter here must be a valid email address that is reachable
13851 from your site.
13852
13853 <H2>Email Address Format</H2>
13854 You may enter a full name and email address,
13855 <!--chtml if pinemode="os_windows"-->
13856 <!--chtml else-->
13857 a local (meaning, on the same
13858 host as the one you are running Alpine on) username that Alpine will
13859 complete for you,
13860 <!--chtml endif-->
13861 the nickname of someone in a
13862 <A HREF="h_abook_opened">Alpine Address Book</A>, or a local
13863 mail alias defined by your system administrator.  When you move the cursor
13864 out of this field, the nicknames will be expanded to the addresses in your
13865 address book, and the local usernames will be expanded to include the
13866 persons' actual names.  You may enter as many addresses as you wish, but they
13867 must be separated by commas.  You can move around this and other header fields
13868 with the arrow keys and use many of the usual composer editing keys.
13869 <P>
13870 <UL>
13871 <LI><A HREF="h_address_format">Explanation of Address formats</A>
13872 </UL>
13873
13874 <P>
13875 <H2>MESSAGE HEADER COMMANDS</H2>
13876 <!--chtml if pinemode="function_key"-->
13877 CURSOR&nbsp;MOTION&nbsp;KEYS----------------------|EDITING&nbsp;KEYS-------------------------<BR>
13878 ^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>
13879 ^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>
13880 ^P&nbsp;(Up&nbsp;Arrow)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Previous&nbsp;line&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|<BR>
13881 ^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>
13882 ^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>
13883 ^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>
13884 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>
13885 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>
13886 ^@&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>
13887 ----------------------------------------|<BR>
13888 MESSAGE&nbsp;COMMANDS&nbsp;&nbsp;|&nbsp;GENERAL&nbsp;COMMANDS&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;F12&nbsp;&nbsp;&nbsp;&nbsp;To&nbsp;Addressbook/Browser<BR>
13889 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>
13890 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>
13891 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>
13892 <!--chtml else-->
13893 CURSOR&nbsp;MOTION&nbsp;KEYS----------------------|EDITING&nbsp;KEYS-------------------------<BR>
13894 ^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>
13895 ^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>
13896 ^P&nbsp;(Up&nbsp;Arrow)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Previous&nbsp;line&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;<BR>
13897 ^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>
13898 ^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>
13899 ^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>
13900 ^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>
13901 ^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>
13902 ^@&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>
13903 ----------------------------------------|&nbsp;^R&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="h_compose_richhdr">Rich&nbsp;Headers</A><BR>
13904 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>
13905 ^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>
13906 ^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>
13907 ^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>
13908 <!--chtml endif-->
13909
13910 <P>
13911 NOTE:
13912 <OL>
13913  <LI>For help on a particular command, highlight the bold text associated
13914 with it above and hit Return.
13915  <LI> The availability of certain commands
13916 is determined by Alpine configuration files and system capabilities.
13917 At some sites, certain commands may not be available due to security or
13918 support concerns.
13919 </OL>
13920
13921 <P>
13922 <UL>
13923 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
13924 </UL><P>
13925 &lt;End of help on this topic&gt;
13926 </BODY>
13927 </HTML>
13928 ======= h_composer_cc ====
13929 <HTML>
13930 <HEAD>
13931 <TITLE>THE MESSAGE COMPOSER'S CC FIELD</TITLE>
13932 </HEAD>
13933 <BODY>
13934 <H1>THE MESSAGE COMPOSER'S CC FIELD</H1>
13935 The Cc: field is just like the To: field, except it is used for addressees
13936 that you wish to send a &quot;carbon&quot; copy to.  That is, the message is
13937 not directly meant directly &quot;for&quot; these recipients, but you wanted
13938 them to see the message.  The only difference the recipients see is that their
13939 name is in the Cc: field, rather than the To: field.
13940 <P>
13941 For help with Cc: field editing
13942 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
13943 <P>
13944 <UL>
13945 <LI><A HREF="h_address_format">Explanation of Address formats</A>
13946 </UL>
13947 <P>
13948 <UL>
13949 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
13950 </UL><P>
13951 &lt;End of help on this topic&gt;
13952 </BODY>
13953 </HTML>
13954 ======= h_composer_bcc ====
13955 <HTML>
13956 <HEAD>
13957 <TITLE>THE MESSAGE COMPOSER'S BCC FIELD</TITLE>
13958 </HEAD>
13959 <BODY>
13960 <H1>THE MESSAGE COMPOSER'S BCC FIELD</H1>
13961 The &quot;Bcc:&quot; (Blind carbon copy) header is used when you wish to send
13962 a copy of the message to one or more people whose addresses you do not
13963 wish disclosed, either to reduce clutter or for confidentiality.
13964 <P>
13965 The format of the Bcc: field is just the same as the To: and Cc: fields in
13966 the way the addresses are entered.  The recipients listed here will
13967 receive a copy of the message, but --assuming your site's mail transport
13968 software is properly configured-- their addresses will not show up in the
13969 headers of the message, as delivered to all of the recipients.  The To:
13970 and Cc:  recipients will not know a copy was sent to the Bcc: recipients.
13971 <P>
13972 Note: if there is no To: or Cc: or Lcc: address in the message, Alpine
13973 will automatically generate and place in the To: field a pseudo-address of
13974   &quot;undisclosed-recipients: ;&quot;
13975 or whatever string has been specified in the
13976 <A HREF="h_config_empty_hdr_msg">&quot;<!--#echo var="VAR_empty-header-message"-->&quot;</A>
13977 variable.
13978 <P>
13979 The reason for this is to avoid embarrassment caused by some Internet
13980 mail transfer software that interprets a &quot;missing&quot; To: header as
13981 an error and replaces it with an Apparently-to: header that may contain
13982 the addresses you entered on the Bcc: line.  In addition, it may be
13983 less disconcerting to Bcc: recipients to see <B>something</B> in the To: field.
13984 <P>
13985 You can manipulate what text ends up on the (originally) empty To:
13986 field.  Just remember to put a colon and semicolon at the end of the
13987 field, which is a special notation denoting that it is not a real address.
13988 <P>
13989 For information on message header editing
13990 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
13991 <P>
13992 <UL>
13993 <LI><A HREF="h_address_format">Explanation of Address formats</A>
13994 </UL>
13995 <P>
13996 <UL>
13997 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
13998 </UL><P>
13999 &lt;End of help on this topic&gt;
14000 </BODY>
14001 </HTML>
14002 ======= h_composer_lcc ====
14003 <HTML>
14004 <HEAD>
14005 <TITLE>THE MESSAGE COMPOSER'S LCC FIELD</TITLE>
14006 </HEAD>
14007 <BODY>
14008 <H1>THE MESSAGE COMPOSER'S LCC FIELD</H1>
14009 The &quot;Lcc:&quot; (List carbon copy) header is intended to be used when
14010 you wish to send a message to a list of people but avoid having all
14011 of their addresses visible, in order to reduce clutter when the
14012 message is received.
14013 <P>
14014 It is similar to the
14015 <A HREF="h_composer_bcc">&quot;Bcc&quot; (Blind carbon copy) header</A>
14016 in that individual
14017 addressees are hidden, but Lcc is designed to work specifically with
14018 distribution lists you have created in your
14019 <A HREF="h_abook_opened">Alpine Address Book</A>.  Placing
14020 the nickname of the list on the Lcc line will result in the full name of
14021 your Alpine Address Book list being placed on the To: line of the message,
14022 using a special notation that distinguishes it from a real address. You
14023 must leave the To: line blank for your list name to appear there.
14024 <P>
14025 For example, if you have this list entered in your Address Book:<PRE>
14026
14027         largo         Key Largo List       DISTRIBUTION LIST:
14028                                            bogie@mgm.com
14029                                            lauren@mgm.com
14030                                            walter@mgm.com</PRE>
14031
14032
14033 and you enter &quot;largo&quot; on the Lcc: line while composing a message,
14034 the result is:<PRE>
14035
14036         To      : Key Largo List: ;
14037         Cc      :
14038         Bcc     :
14039         Fcc     : sent-mail
14040         Lcc     : Key Largo List &lt;bogie@mgm.com&gt;,
14041                   lauren@mgm.com,
14042                   walter@mgm.com
14043         Subject :</PRE>
14044
14045 Each recipient listed on the Lcc: line receives a copy of the message
14046 without their address being visible (as though they were listed on the
14047 Bcc: line). The colon-semicolon notation used to put the full-name of the
14048 list on the To: line is a special address format that doesn't specify any
14049 actual addressees, but does give some information to the recipients of the
14050 message.
14051 <P>
14052 Note: if after entering an LCC, you delete the list name that is placed
14053 on the To: line, then recipients will see <PRE>
14054        To: undisclosed-recipients: ;</PRE>
14055
14056 (or whatever string is defined in the
14057 <A HREF="h_config_empty_hdr_msg">&quot;<!--#echo var="VAR_empty-header-message"-->&quot;</A>
14058 variable) just as in the BCC case.
14059 <P>
14060 For help with Lcc: field editing
14061 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
14062 <P>
14063 <UL>
14064 <LI><A HREF="h_address_format">Explanation of Address formats</A>
14065 </UL>
14066 <P>
14067 <UL>
14068 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14069 </UL><P>
14070 &lt;End of help on this topic&gt;
14071 </BODY>
14072 </HTML>
14073 ======= h_composer_from =======
14074 <HTML>
14075 <HEAD>
14076 <TITLE>THE MESSAGE COMPOSER'S FROM FIELD</TITLE>
14077 </HEAD>
14078 <BODY>
14079 <H1>THE MESSAGE COMPOSER'S FROM FIELD</H1>
14080
14081 This header carries your return address.  It is the address toward which
14082 replies (and often, future unrelated correspondence) will be directed,
14083 unless you have <A HREF="h_config_custom_hdrs">defined an optional
14084 &quot;Reply-To:&quot; header</A> in the SETUP CONFIGURATION screen.  Make
14085 sure this address is correct.
14086 <P>
14087 For help with message header editing
14088 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
14089 <P>
14090 <UL>
14091 <LI><A HREF="h_address_format">Explanation of Address formats</A>
14092 </UL>
14093 <P>
14094 <UL>
14095 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14096 </UL><P>
14097 &lt;End of help on this topic&gt;
14098 </BODY>
14099 </HTML>
14100 ======= h_composer_reply_to =======
14101 <HTML>
14102 <HEAD>
14103 <TITLE>THE MESSAGE COMPOSER'S REPLY-TO FIELD</TITLE>
14104 </HEAD>
14105 <BODY>
14106 <H1>THE MESSAGE COMPOSER'S REPLY-TO FIELD</H1>
14107
14108 Most people should not need this header. The Reply-To: header is used in
14109 cases where you would like replies to your messages to be directed to an
14110 address other than your normal &quot;From:&quot; address.  This is atypical,
14111 but can happen when you use multiple machines and do not have the same account
14112 name on each one, or when you wish to direct certain replies to accounts
14113 or folders designated for specific classes of correspondence.
14114 <P>
14115 For help with message header editing
14116 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
14117 <P>
14118 <UL>
14119 <LI><A HREF="h_address_format">Explanation of Address formats</A>
14120 </UL>
14121
14122 <P>
14123 <UL>
14124 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14125 </UL><P>
14126 &lt;End of help on this topic&gt;
14127 </BODY>
14128 </HTML>
14129 ======= h_composer_custom_addr ====
14130 <HTML>
14131 <HEAD>
14132 <TITLE>CUSTOMIZED HEADER FIELD</TITLE>
14133 </HEAD>
14134 <BODY>
14135 <H1>CUSTOMIZED HEADER FIELD</H1>
14136 This is a customized header, i.e. not one that is part of Alpine's normal
14137 set of Compose headers.
14138 <P>
14139 For help with message header editing
14140 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
14141 <P>
14142 <UL>
14143 <LI><A HREF="h_address_format">Explanation of Address formats</A>
14144 </UL>
14145 <P>
14146 <UL>
14147 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14148 </UL><P>
14149 &lt;End of help on this topic&gt;
14150 </BODY>
14151 </HTML>
14152 ======= h_composer_custom_free ====
14153 <HTML>
14154 <HEAD>
14155 <TITLE>CUSTOMIZED HEADER FIELD</TITLE>
14156 </HEAD>
14157 <BODY>
14158 <H1>CUSTOMIZED HEADER FIELD</H1>
14159 This is a customized header, i.e. not one that is part of Alpine's normal
14160 set of Compose headers.
14161 <P>
14162 This field consists of arbitrary text.
14163 <P>
14164 For help with message header editing
14165 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
14166 <P>
14167 <UL>
14168 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14169 </UL><P>
14170 &lt;End of help on this topic&gt;
14171 </BODY>
14172 </HTML>
14173 ====== h_composer_news =====
14174 <HTML>
14175 <HEAD>
14176 <TITLE>THE MESSAGE COMPOSER'S NEWSGRPS LINE</TITLE>
14177 </HEAD>
14178 <BODY>
14179 <h1>THE MESSAGE COMPOSER'S NEWSGRPS LINE</h1>
14180 Use the newsgroups line to specify any and all USENET newsgroups to which
14181 your message should be posted.  When composing a message from scratch, this
14182 line may be hidden.  If so, just press the rich headers command
14183 (<!--chtml if pinemode="function_key"-->F5<!--chtml else-->^R<!--chtml endif-->)
14184 to make it visible.
14185 <P>
14186 <EM>Be aware</EM> that when you post to a newsgroup thousands of
14187 people will be reading your message.  Also, you or your system manager
14188 must have defined an &quot;<!--#echo var="VAR_nntp-server"-->&quot; in your Alpine configuration
14189 in order for you to be able to post.
14190 <P>
14191 For help with message header editing
14192 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
14193 <P><UL>
14194 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14195 </UL>
14196 <P>
14197 &lt;End of help on this topic&gt;
14198 </BODY>
14199 </HTML>
14200 ======= h_composer_fcc ====
14201 <HTML>
14202 <HEADER>
14203 <TITLE>THE MESSAGE COMPOSER'S FCC FIELD</TITLE>
14204 </HEADER>
14205 <BODY>
14206 <H1>THE MESSAGE COMPOSER'S FCC FIELD</H1>
14207 The FCC (File Carbon Copy) specifies the folder used to keep a copy of
14208 each outgoing message.  The default value can be configured with the
14209 &quot;<!--#echo var="VAR_default-fcc"-->&quot; and &quot;<!--#echo var="VAR_fcc-name-rule"-->&quot; options.  You can change or remove
14210 the file carbon copy on any message you send by editing the FCC header.<p>
14211
14212 You may type ^T to get a list of all your folders and select one to use as
14213 the FCC for this message.<P>
14214
14215 For help with message header editing
14216 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
14217 <P>
14218 <UL>
14219 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14220 </UL><P>
14221 &lt;End of help on this topic&gt;
14222 </BODY>
14223 </HTML>
14224 ======= h_composer_subject ====
14225 <HTML>
14226 <HEADER>
14227 <TITLE>THE MESSAGE COMPOSER'S SUBJECT FIELD</TITLE>
14228 </HEADER>
14229 <BODY>
14230 <H1>THE MESSAGE COMPOSER'S SUBJECT FIELD</H1>
14231
14232 The subject header provides a place to enter a few words that summarize
14233 the topic of the message you are sending.  You may leave this line blank,
14234 but it is considered a courtesy to use a meaningful subject.<p>
14235
14236 For help with message header editing
14237 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
14238 <P>
14239 <UL>
14240 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14241 </UL><P>
14242 &lt;End of help on this topic&gt;
14243 </BODY>
14244 </HTML>
14245 ======= h_composer_attachment ====
14246 <HTML>
14247 <HEAD>
14248 <TITLE>THE MESSAGE COMPOSER'S ATTCHMNT FIELD</TITLE>
14249 </HEAD>
14250 <BODY>
14251 <H1>THE MESSAGE COMPOSER'S ATTCHMNT FIELD</H1>
14252
14253 The &quot;Attchmnt:&quot; field is where you specify what file or
14254 files you'd like attached to
14255 the message you are composing.  Those files must reside on the machine
14256 running Alpine. If your file is on a PC or Mac and you run Alpine with an
14257 account on a Unix machine, you'll have to transfer it before attaching it.
14258 Contact local computer support people for assistance with transferring.
14259
14260 <P>
14261 The file name
14262 given can be an absolute file path name for your system
14263 <!--chtml if pinemode="os_windows"-->
14264 (for example, &quot;H:&#92;SIGFILES&#92;FULLINFO.TXT&quot;), a file
14265 with a relative pathname, or simply a file name without
14266 drive or directory specification.
14267 <!--chtml else-->
14268 (for example, &quot;/tmp/exported.earlier&quot; on Unix hosts),
14269 a file in your home directory, or a file path relative to your
14270 home directory.  In Unix Alpine, you may use &quot;~&quot; to refer to
14271 your home directory or &quot;~user&quot; to refer to another
14272 account's home directory.
14273 <!--chtml endif--><P>
14274 No wild card characters may be used.
14275 <P>If the
14276 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
14277 feature is set, names are relative to your current working directory
14278 <!--chtml if pinemode="running"-->
14279 (which, at least for your current Alpine &quot;session,&quot;
14280 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
14281 <!--chtml endif-->
14282 rather than your home directory
14283 <!--chtml if pinemode="running"-->
14284 (which, in the present configuration of your system, is
14285  &quot;<!--#echo var="HOME_DIR"-->&quot;)
14286 <!--chtml endif-->
14287 .
14288 <P>
14289 Alpine uses MIME encoding for attachments, so binaries and files of any
14290 length can safely be delivered to any MIME-capable mail reading program.
14291 If you send an attachment to someone who does not have a MIME-capable mail
14292 reading program yet, then the main message text will be readable, but
14293 attachments (even attachments that are just plain text) are not.
14294 <P>
14295
14296 Typing the filename on the Attchmnt: line achieves the same
14297 result as using the
14298 <!--chtml if pinemode="function_key"-->
14299 F6
14300 <!--chtml else-->
14301 Ctrl-J
14302 <!--chtml endif--> command.
14303 <P>
14304
14305 If you Forward a message with attachments, you may delete them from your
14306 Forwarded message by editing the Attchmnt header line.
14307 <P>
14308
14309 For help with message header editing
14310 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
14311 <P>
14312 <UL>
14313 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14314 </UL><P>
14315 &lt;End of help on this topic&gt;
14316 </BODY>
14317 </HTML>
14318 ======= h_composer_ctrl_j ====
14319 <HTML>
14320 <HEAD>
14321 <TITLE>COMPOSER ATTACH</TITLE>
14322 </HEAD>
14323 <BODY>
14324 After the
14325 <!--chtml if pinemode="function_key"-->
14326 F6
14327 <!--chtml else-->
14328 Ctrl-J
14329 <!--chtml endif--> command:
14330 At the &quot;File to attach:&quot; prompt, enter the name of the
14331 existing file to attach to your message.
14332 When the feature
14333 <A HREF="h_config_enable_tab_complete">&quot;<!--#echo var="FEAT_enable-tab-completion"-->&quot;</A>
14334 is set
14335 you need only enter the beginning of the filename (enough of it to uniquely
14336 identify the file) and press TAB to complete it.
14337
14338 Or, press ^T to use the BROWSER screen for
14339 selecting the file.  <P>
14340 For more information on attaching files, see the help screen for the
14341 composer's
14342 <A HREF="h_composer_attachment">Attchmnt: field</A>, which is normally hidden,
14343 but can be revealed using the
14344 <!--chtml if pinemode="function_key"-->
14345 F5
14346 <!--chtml else-->
14347 Ctrl-R
14348 <!--chtml endif-->
14349 command with the cursor positioned above the
14350 &quot;----- Message Text -----&quot; line in the COMPOSE MESSAGE screen.
14351 <P>
14352 &lt;End of help on this topic&gt;
14353 </BODY>
14354 </HTML>
14355 ======= h_edit_nav_cmds =========
14356 <HTML>
14357 <HEAD>
14358 <TITLE>Composer Editing Commands Explained</TITLE>
14359 </HEAD>
14360 <BODY>
14361 <H1>EDITING and NAVIGATION COMMANDS</H1>
14362 <!--chtml if pinemode="function_key"-->
14363 <PRE>
14364 CURSOR MOTION KEYS----------------------|EDITING KEYS-------------------------
14365 ^B (Left Arrow)    Back character       | ^D       Delete current character
14366 ^F (Right Arrow)   Forward character    | ^H (DEL) Delete previous character
14367 ^P (Up Arrow)      Previous line        |
14368 ^N (Down Arrow)    Next line            | F9       Cut marked text or
14369 ^A                 Beginning of line    |            delete current line
14370 ^E                 End of line          | F10      Undelete line(s)
14371 F7                 Previous page        |
14372 F8                 Next page            |-------------------------------------
14373 ^@ (Ctrl-SPACE)    Next word            | MISCELLANEOUS COMMANDS
14374 ----------------------------------------|
14375 EXIT COMMANDS    |  GENERAL COMMANDS    | F12    To Addressbook
14376 F3   Cancel      |   F1    Get help     | F12    RichView (expand lists)
14377 F2  eXit/save    |   ^Z    Suspend      | ^L     Redraw Screen
14378 </PRE>
14379 <!--chtml else-->
14380 <PRE>
14381 CURSOR MOTION KEYS----------------------|EDITING KEYS-------------------------
14382 ^B (Left Arrow)    Back character       | ^D       Delete current character
14383 ^F (Right Arrow)   Forward character    | ^H (DEL) Delete previous character
14384 ^P (Up Arrow)      Previous line        |
14385 ^N (Down Arrow)    Next line            | ^K       Cut marked text or
14386 ^A                 Beginning of line    |            delete current line
14387 ^E                 End of line          | ^U       Undelete line(s)
14388 ^Y                 Previous page        |
14389 ^V                 Next page            |-------------------------------------
14390 ^@ (Ctrl-SPACE)    Next word            | MISCELLANEOUS COMMANDS
14391 ----------------------------------------|
14392 EXIT COMMANDS    |  GENERAL COMMANDS    | ^T     To Addressbook
14393 ^C   Cancel      |   ^G    Get help     | ^R     RichView  (expand lists)
14394 ^X   eXit/save   |   ^Z    Suspend      | ^L     Redraw Screen
14395 </PRE>
14396 <!--chtml endif-->
14397 &lt;End of help on this topic&gt;
14398 </BODY>
14399 </HTML>
14400 ===== h_composer_sigedit =====
14401 <HTML>
14402 <HEAD>
14403 <TITLE>Signature Editor Commands Explained</TITLE>
14404 </HEAD>
14405 <BODY>
14406 <H1>SIGNATURE EDITOR COMMANDS</H1>
14407 <!--chtml if pinemode="function_key"-->
14408 <PRE>
14409 CURSOR MOTION KEYS                     |EDITING KEYS
14410   ^B (Left Arrow)   Back character     | ^D       Delete current character
14411   ^F (Right Arrow)  Forward character  | ^H (DEL) Delete previous character
14412   ^P (Up Arrow)     Previous line      | ^^       Set a mark
14413   ^N (Down Arrow)   Next line          | F9       Cut marked text or
14414   ^A                Beginning of line  |           delete current line
14415   ^E                End of line        | F10       Paste text, undelete lines
14416   F7                Previous page      |           cut with ^K, or unjustify
14417   F8                Next page          |-------------------------------------
14418   ^@ (Ctrl-SPACE)   Next word          |SCREEN/COMPOSITION COMMANDS
14419 ---------------------------------------| F6       Whereis (search for string)
14420 MESSAGE COMMANDS | GENERAL COMMANDS    | F12      Spell checker
14421  F3   Cancel     |  F1    Get help     | F4       Justify paragraph
14422                  |  ^Z    Suspend      | ^L       Redraw Screen
14423  F2   Send       |  F6    Alt. editor  | F5       Read in a file
14424 </PRE>
14425 <!--chtml else-->
14426 <PRE>
14427 CURSOR MOTION KEYS                     |EDITING KEYS
14428   ^B (Left Arrow)   Back character     | ^D       Delete current character
14429   ^F (Right Arrow)  Forward character  | ^H (DEL) Delete previous character
14430   ^P (Up Arrow)     Previous line      | ^^       Set a mark
14431   ^N (Down Arrow)   Next line          | ^K       Cut marked text or
14432   ^A                Beginning of line  |           delete current line
14433   ^E                End of line        | ^U        Paste text, undelete lines
14434   ^Y                Previous page      |           cut with ^K, or unjustify
14435   ^V                Next page          |-------------------------------------
14436   ^@ (Ctrl-SPACE)   Next word          |SCREEN/COMPOSITION COMMANDS
14437 ---------------------------------------| ^W       <A HREF="h_composer_search">Whereis</A> (search text)
14438 MESSAGE COMMANDS | GENERAL COMMANDS    | ^T       Spell checker
14439  ^C   Cancel     |  ^G    Get help     | ^J       <A HREF="h_compose_justify">Justify</A> paragraph
14440                  |  ^Z    <A HREF="h_common_suspend">Suspend</A>      | ^L       Redraw Screen
14441  ^X   Send       |  ^_    Alt. editor  | ^R       Read in a file
14442 </PRE>
14443 <!--chtml endif-->
14444
14445 NOTE: The presence or absence of the following commands is determined
14446 by &quot;Feature-List&quot; options in your Alpine configuration.  Also,
14447 some of these commands may be administratively disabled by your system
14448 manager; if they don't work, please check with your local help desk
14449 before reporting a bug.
14450 <P>
14451 <UL>
14452  <LI>Suspend (suspends Alpine and gives a system prompt)
14453  <LI>Alternate editor (allows you to compose with your own editor)
14454 </UL>
14455 <P>
14456
14457 Alpine does not use the following keys:  Ctrl-S, Ctrl-Q, Ctrl-],
14458 Ctrl-&#92;, ESC
14459 <P>
14460
14461 NOTE: For special handling of Ctrl-S and Ctrl-Q see special comments regarding
14462 <A HREF="h_special_xon_xoff">&quot;XOFF/XON&quot;</A>.
14463 <P>
14464 &lt;End of help on this topic&gt;
14465 </BODY>
14466 </HTML>
14467 ===== h_composer_commentedit =====
14468 <HTML>
14469 <HEAD>
14470 <TITLE>Comment Editor Commands Explained</TITLE>
14471 </HEAD>
14472 <BODY>
14473 <H1>COMMENT EDITOR COMMANDS</H1>
14474 <!--chtml if pinemode="function_key"-->
14475 <PRE>
14476 CURSOR MOTION KEYS                     |EDITING KEYS
14477   ^B (Left Arrow)   Back character     | ^D       Delete current character
14478   ^F (Right Arrow)  Forward character  | ^H (DEL) Delete previous character
14479   ^P (Up Arrow)     Previous line      | ^^       Set a mark
14480   ^N (Down Arrow)   Next line          | F9       Cut marked text or
14481   ^A                Beginning of line  |           delete current line
14482   ^E                End of line        | F10       Paste text, undelete lines
14483   F7                Previous page      |           cut with ^K, or unjustify
14484   F8                Next page          |-------------------------------------
14485   ^@ (Ctrl-SPACE)   Next word          |SCREEN/COMPOSITION COMMANDS
14486 ---------------------------------------| F6       Whereis (search for string)
14487 MESSAGE COMMANDS | GENERAL COMMANDS    | F12      Spell checker
14488  F3   Cancel     |  F1    Get help     | F4       Justify paragraph
14489                  |  ^Z    Suspend      | ^L       Redraw Screen
14490  F2   Send       |  F6    Alt. editor  | F5       Read in a file
14491 </PRE>
14492 <!--chtml else-->
14493 <PRE>
14494 CURSOR MOTION KEYS                     |EDITING KEYS
14495   ^B (Left Arrow)   Back character     | ^D       Delete current character
14496   ^F (Right Arrow)  Forward character  | ^H (DEL) Delete previous character
14497   ^P (Up Arrow)     Previous line      | ^^       Set a mark
14498   ^N (Down Arrow)   Next line          | ^K       Cut marked text or
14499   ^A                Beginning of line  |           delete current line
14500   ^E                End of line        | ^U        Paste text, undelete lines
14501   ^Y                Previous page      |           cut with ^K, or unjustify
14502   ^V                Next page          |-------------------------------------
14503   ^@ (Ctrl-SPACE)   Next word          |SCREEN/COMPOSITION COMMANDS
14504 ---------------------------------------| ^W       <A HREF="h_composer_search">Whereis</A> (search text)
14505 MESSAGE COMMANDS | GENERAL COMMANDS    | ^T       Spell checker
14506  ^C   Cancel     |  ^G    Get help     | ^J       <A HREF="h_compose_justify">Justify</A> paragraph
14507                  |  ^Z    <A HREF="h_common_suspend">Suspend</A>      | ^L       Redraw Screen
14508  ^X   Send       |  ^_    Alt. editor  | ^R       Read in a file
14509 </PRE>
14510 <!--chtml endif-->
14511
14512 NOTE: The presence or absence of the following commands is determined
14513 by &quot;Feature-List&quot; options in your Alpine configuration.  Also,
14514 some of these commands may be administratively disabled by your system
14515 manager; if they don't work, please check with your local help desk
14516 before reporting a bug.
14517 <P>
14518 <UL>
14519  <LI>Suspend (suspends Alpine and gives a system prompt)
14520  <LI>Alternate editor (allows you to compose with your own editor)
14521 </UL>
14522 <P>
14523
14524 Alpine does not use the following keys:  Ctrl-S, Ctrl-Q, Ctrl-],
14525 Ctrl-&#92;, ESC
14526 <P>
14527
14528 NOTE: For special handling of Ctrl-S and Ctrl-Q see special comments regarding
14529 <A HREF="h_special_xon_xoff">&quot;XOFF/XON&quot;</A>.
14530 <P>
14531 &lt;End of help on this topic&gt;
14532 </BODY>
14533 </HTML>
14534 ======= h_composer_abook_nick =======
14535 <HTML>
14536 <HEAD>
14537 <TITLE>Addressbook Nickname Explained</TITLE>
14538 </HEAD>
14539 <BODY>
14540 This is a short nickname for this address book entry.  If it is used in
14541 place of an address from the composer, the composer will fill in the
14542 address(es) for the entry that matches the nickname.
14543 <P>
14544
14545 Look <A HREF="h_edit_nav_cmds">here</A>
14546 to see the available Editing and Navigation commands.
14547 <P>
14548 &lt;End of help on this topic&gt;
14549 </BODY>
14550 </HTML>
14551 ======= h_composer_abook_full =======
14552 <HTML>
14553 <HEAD>
14554 <TITLE>Addressbook Fullname Explained</TITLE>
14555 </HEAD>
14556 <BODY>
14557 This is the full name field for this entry.  If this is going to be a
14558 distribution list (more than one address), it should be a descriptive
14559 phrase describing the list.  It will be included in the mail header if you
14560 put the list in the To: or CC: field, or in the To: line if you put the
14561 list in the Lcc: field.  It's OK to leave this field blank (and OK to
14562 leave any of the other fields blank, too). If this address book entry is
14563 going to be a simple entry with just one address, then this field is the
14564 person's name. When you send mail to this entry, this is the field to the
14565 left of the brackets. That is, it is the most readable part of the
14566 address. For example, in the sample address:
14567 <PRE>
14568        John Doe &lt;jdoe@some.domain&gt;
14569 </PRE>
14570 "John Doe" is the full name field. If you are sorting your address book
14571 with one of the options that uses full names, then it might be useful to
14572 enter the full name as "Last, First", for example:
14573 <PRE>
14574        Doe, John
14575 </PRE>
14576 so that it will be sorted using Doe instead of John. This will be changed
14577 back into John Doe when you use it.
14578 <P>
14579 Look <A HREF="h_edit_nav_cmds">here</A>
14580 to see the available Editing and Navigation commands.
14581 <P>
14582 &lt;End of help on this topic&gt;
14583 </BODY>
14584 </HTML>
14585 ======= h_composer_abook_fcc =======
14586 <HTML>
14587 <HEAD>
14588 <TITLE>Addressbook Fcc Explained</TITLE>
14589 </HEAD>
14590 <BODY>
14591 If this entry is the first one in the To: line of an outgoing message,
14592 this field will be used for the Fcc (File Carbon Copy) instead of whatever
14593 you would normally get (which depends on which
14594 <A HREF="h_config_saved_msg_name_rule">&quot;<!--#echo var="VAR_saved-msg-name-rule"-->&quot;</A>
14595 you've chosen).
14596 <P>
14597 If this field consists of two double quotes (&quot;&quot;) that tells Alpine
14598 that you don't want any Fcc associated with this entry.
14599 <P>
14600 Look <A HREF="h_edit_nav_cmds">here</A>
14601 to see the available Editing and Navigation commands.
14602 <P>
14603 &lt;End of help on this topic&gt;
14604 </BODY>
14605 </HTML>
14606 ====== h_config_combined_abook_display =====
14607 <HTML>
14608 <HEAD>
14609 <TITLE>FEATURE: <!--#echo var="FEAT_combined-addrbook-display"--></TITLE>
14610 </HEAD>
14611 <BODY>
14612 <H1>FEATURE: <!--#echo var="FEAT_combined-addrbook-display"--></H1>
14613
14614 This feature affects the address book display screens.
14615 Normally, expanding an address book from the ADDRESS BOOK LIST screen
14616 will cause the remaining address books and directory servers to disappear
14617 from the screen, leaving only the entries of the expanded address book.
14618 If this feature is set, then the other address books will remain on the screen,
14619 so that all of the address books can be present at once.
14620
14621 <P>
14622 The way that commands work won't be changed.
14623 For example, the Select All command will select all of the entries in the
14624 current address book, not all of the entries in all of the address books.
14625 The WhereIs command will change a little.
14626 It will search through all of the text on the screen plus all of the entries
14627 from expanded address books.
14628
14629 <P>
14630 When this feature is set, the setting of the feature
14631 <A HREF="h_config_expanded_addrbooks">&quot;<!--#echo var="FEAT_expanded-view-of-addressbooks"-->&quot;</A>
14632 has an effect.
14633 <P>
14634 &lt;End of help on this topic&gt;
14635 </BODY>
14636 </HTML>
14637 ====== h_config_titlebar_color_style =====
14638 <HTML>
14639 <HEAD>
14640 <TITLE>OPTION: <!--#echo var="VAR_titlebar-color-style"--></TITLE>
14641 </HEAD>
14642 <BODY>
14643 <H1>OPTION: <!--#echo var="VAR_titlebar-color-style"--></H1>
14644
14645 This option affects the colors used to display the titlebar (the top
14646 line on the screen) when viewing a message.
14647
14648 <P>
14649 The available options include:
14650 <P>
14651
14652 <DL>
14653 <DT>default</DT>
14654 <DD>The color of the titlebar will be the color you set for the
14655 <A HREF="h_config_title_color">Title Color</A>.
14656 The Title Color may be set by using the
14657 <A HREF="h_color_setup">Setup Kolor</A> screen.
14658 </DD>
14659
14660 <DT>indexline</DT>
14661 <DD>The color of the titlebar will be the same as the color of the
14662 index line corresponding to the message being viewed.
14663 The rules that determine what color the index line will be may be set
14664 up by going to the Setup/Rules/Indexcolor screen.
14665 If the index line for a message is not colored explicitly by the
14666 Indexcolor rules, then the titlebar will be colored the same as for
14667 the &quot;default&quot; option above (which is not the same color that
14668 the index line itself will have).
14669 </DD>
14670
14671 <DT>reverse-indexline</DT>
14672 <DD>This is similar to the &quot;indexline&quot; option except the
14673 foreground and background colors from the corresponding index line will
14674 be reversed.
14675 For example, if the index line color is red letters on a white background,
14676 then the titlebar will be white letters on a red background.
14677 If the index line for a message is not colored explicitly by the
14678 Indexcolor rules, then the titlebar will be colored the same as for
14679 the &quot;default&quot; option above (which is not the same color that
14680 the index line itself will have).
14681 </DD>
14682 </DL>
14683
14684 <P>
14685
14686 <UL>
14687 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14688 </UL><P>
14689 &lt;End of help on this topic&gt;
14690 </BODY>
14691 </HTML>
14692 ====== h_config_index_color_style =====
14693 <HTML>
14694 <HEAD>
14695 <TITLE>OPTION: <!--#echo var="VAR_current-indexline-style"--></TITLE>
14696 </HEAD>
14697 <BODY>
14698 <H1>OPTION: <!--#echo var="VAR_current-indexline-style"--></H1>
14699
14700 This option affects the colors used to display the current line in the
14701 MESSAGE INDEX screen.
14702 If you do not have Index Color Rules defined, then this option will
14703 have no effect in the index.
14704 Those Rules may be defined by going to the Setup/Rules/Indexcolor screen.
14705 <P>
14706 If the option
14707 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
14708 is turned on and the
14709 <A HREF="h_config_incunseen_color">Incoming Unseen Color</A>
14710 is set to something other than the default, then
14711 this option also affects the color used to display the current folder
14712 in the Incoming FOLDER LIST screen.
14713
14714 <P>
14715 The available options include:
14716 <P>
14717
14718 <DL>
14719 <DT>flip-colors</DT>
14720 <DD>This is the default.
14721 If an index line is colored because it matches one of your
14722 Index Color Rules, then its colors will be reversed when it is the currently
14723 highlighted line.
14724 For example, if the line is normally red text on a blue background, then
14725 when it is the current line it will be drawn as blue text on a red background.
14726 <P>
14727 The rest of the option values all revert to this flip-colors behavior if
14728 there is no Reverse Color defined.
14729 </DD>
14730
14731 <DT>reverse</DT>
14732 <DD>With this option the Reverse color is always used to highlight the
14733 current line.
14734 </DD>
14735
14736 <DT>reverse-fg</DT>
14737 <DD>The foreground part of the Reverse Color is used to highlight
14738 the current line.
14739 If this would cause the text to be unreadable (because the foreground and
14740 background colors are the same) or if it would cause no change in the
14741 color of the index line, then the colors are flipped instead.
14742 <P>
14743 Some people think this works particularly well if you use different
14744 background colors to emphasize &quot;interesting&quot; lines,
14745 but always with the same Normal foreground color,
14746 and you use a different foreground color for the Reverse Color.
14747 </DD>
14748
14749 <DT>reverse-fg-no-ambiguity</DT>
14750 <DD>With the &quot;reverse-fg&quot; rule above, it is possible that
14751 the resulting color will be exactly the same as the regular Reverse
14752 Color.
14753 That can lead to some possible confusion because an
14754 &quot;interesting&quot;
14755 line that is the current line will be displayed exactly the same as a
14756 non-interesting line that is current.
14757 You can't tell whether the line is just a regular current line or if it is
14758 an &quot;interesting&quot; current line by looking at the color.
14759 Setting the option to this value removes that ambiguity.
14760 It is the same as the &quot;reverse-fg&quot; setting unless the resulting
14761 interesting current line would look just like a non-interesting current line.
14762 In that case, the interesting line's colors are simply flipped (like in the
14763 default behavior).
14764 <P>
14765 As an alternative way to preserve the line's interestingness in this case,
14766 you may find that using both a different foreground and a different
14767 background color for the interesting line will help.
14768 </DD>
14769
14770 <DT>reverse-bg</DT>
14771 <DD>The background part of the Reverse Color is used to highlight
14772 the current line.
14773 If this would cause the text to be unreadable (because the foreground and
14774 background colors are the same) or if it would cause no change in the
14775 color of the index line, then the colors are flipped instead.
14776 <P>
14777 Some people think this works particularly well if you use different
14778 foreground colors to emphasize &quot;interesting&quot; lines,
14779 but always with the same Normal background color,
14780 and you use a different background color for the Reverse Color.
14781 </DD>
14782
14783 <DT>reverse-bg-no-ambiguity</DT>
14784 <DD>As with the &quot;reverse-fg&quot; case, the &quot;reverse-bg&quot;
14785 rule may also result in a color that is exactly the same as the regular
14786 Reverse Color.
14787 Setting the option to this value removes that ambiguity.
14788 It is the same as the &quot;reverse-bg&quot; setting unless the resulting
14789 current line has the same color as the Reverse Color.
14790 In that case, the interesting line's colors are simply flipped (like in the
14791 default behavior).
14792 </DD>
14793 </DL>
14794
14795 <P>
14796
14797 <UL>
14798 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14799 </UL><P>
14800 &lt;End of help on this topic&gt;
14801 </BODY>
14802 </HTML>
14803 ====== h_config_expanded_addrbooks =====
14804 <HTML>
14805 <HEAD>
14806 <TITLE>FEATURE: <!--#echo var="FEAT_expanded-view-of-addressbooks"--></TITLE>
14807 </HEAD>
14808 <BODY>
14809 <H1>FEATURE: <!--#echo var="FEAT_expanded-view-of-addressbooks"--></H1>
14810
14811 If multiple address books (either personal or global) are defined, and you
14812 wish to have them all expanded implicitly upon entering the ADDRESS BOOK
14813 screen, then set this feature. This feature will have no effect unless the
14814 feature
14815 <A HREF="h_config_combined_abook_display">&quot;<!--#echo var="FEAT_combined-addrbook-display"-->&quot;</A>
14816 is also set.
14817 <P>
14818 &lt;End of help on this topic&gt;
14819 </BODY>
14820 </HTML>
14821 ====== h_config_combined_folder_display =====
14822 <HTML>
14823 <HEAD>
14824 <TITLE>FEATURE: <!--#echo var="FEAT_combined-folder-display"--></TITLE>
14825 </HEAD>
14826 <BODY>
14827 <H1>FEATURE: <!--#echo var="FEAT_combined-folder-display"--></H1>
14828
14829 This feature affects the folder list display screens.
14830 Normally, each folder list is viewed within its collection only.  This
14831 command allows folder lists to be viewed within a single screen that
14832 combines the contents of all collections.
14833
14834 <P>
14835 The way that commands work won't be changed.
14836 For example, the Select All command will select all of the folders in the
14837 current collection, not all of the entries in all of the collections.
14838 The WhereIs command will change a little.
14839 It will search through all of the folders in the current collection as well
14840 as all the folder in any other expanded collection.
14841
14842 <P>
14843 When this feature is set, the setting of the feature
14844 <A HREF="h_config_expanded_folders">&quot;<!--#echo var="FEAT_expanded-view-of-folders"-->&quot;</A>
14845 has an effect.
14846 <P>
14847 &lt;End of help on this topic&gt;
14848 </BODY>
14849 </HTML>
14850 ====== h_config_combined_subdir_display =====
14851 <HTML>
14852 <HEAD>
14853 <TITLE>FEATURE: <!--#echo var="FEAT_combined-subdirectory-display"--></TITLE>
14854 </HEAD>
14855 <BODY>
14856 <H1>FEATURE: <!--#echo var="FEAT_combined-subdirectory-display"--></H1>
14857
14858 This feature affects the Folder List screen when
14859 the
14860 <A HREF="h_config_combined_folder_display">&quot;<!--#echo var="FEAT_combined-folder-display"-->&quot;</A>
14861 feature is enabled.  Normally, selecting a directory from the Folder
14862 List takes you into a new screen displaying only the contents of
14863 that directory.
14864
14865 <P>
14866 Enabling this feature will cause the contents of the selected
14867 directory to be
14868 displayed within the boundaries of the &quot;Collection&quot; it
14869 is a part of.  All previously displayed collections will remain
14870 in the screen.
14871
14872 <P>
14873 The way that commands work won't be changed.
14874 For example, the Select All command will select all of the folders in the
14875 directory, as opposed to all of the entries in all of the collections.
14876 The WhereIs command will change a little.
14877 It will search through all of the folders in the current collection as well
14878 as all the folder in any other expanded collection.
14879
14880 <P>
14881 &lt;End of help on this topic&gt;
14882 </BODY>
14883 </HTML>
14884 ====== h_config_separate_fold_dir_view =====
14885 <HTML>
14886 <HEAD>
14887 <TITLE>FEATURE: <!--#echo var="FEAT_separate-folder-and-directory-entries"--></TITLE>
14888 </HEAD>
14889 <BODY>
14890 <H1>FEATURE: <!--#echo var="FEAT_separate-folder-and-directory-entries"--></H1>
14891
14892 This feature affects folder collections wherein a folder
14893 and directory can have the same name.  By default, Alpine displays them
14894 only once, denoting that it is both a folder and directory by appending
14895 the folder name with the hierarchy character enclosed
14896 in square brackets.
14897
14898
14899 <P>
14900 Enabling this feature will cause Alpine to display such names
14901 separately marking the name representing a directory with a trailing
14902 hierarchy delimiter (typically the slash, &quot;/&quot;, character).
14903
14904 <P>
14905 The feature also alters the command set slightly.  By default, the
14906 right-arrow descends into the directory, while hitting the Return key will
14907 cause the folder by that name to be opened.
14908
14909 <P>
14910 With this feature set, the Return key will open the highlighted folder, or
14911 enter the highlighted directory.
14912
14913 <P>
14914 &lt;End of help on this topic&gt;
14915 </BODY>
14916 </HTML>
14917 ====== h_config_expanded_folders =====
14918 <HTML>
14919 <HEAD>
14920 <TITLE>FEATURE: <!--#echo var="FEAT_expanded-view-of-folders"--></TITLE>
14921 </HEAD>
14922 <BODY>
14923 <H1>FEATURE: <!--#echo var="FEAT_expanded-view-of-folders"--></H1>
14924
14925 If multiple folder collections are defined, and you
14926 wish to have them all expanded implicitly upon entering the FOLDER LIST
14927 screen, then set this feature. This feature will have no effect unless the
14928 feature
14929 <A HREF="h_config_combined_folder_display">&quot;<!--#echo var="FEAT_combined-folder-display"-->&quot;</A>
14930 is also set.
14931 <P>
14932 &lt;End of help on this topic&gt;
14933 </BODY>
14934 </HTML>
14935 ======= h_config_ldap_server =======
14936 <HTML>
14937 <HEAD>
14938 <TITLE>LDAP OPTION: <!--#echo var="VAR_ldap-servers"--></TITLE>
14939 </HEAD>
14940 <BODY>
14941 <H1>LDAP OPTION: <!--#echo var="VAR_ldap-servers"--></H1>
14942 This is the name of the host where an LDAP server is running.
14943 For redundancy, this may be a space-delimited set of server names, in which
14944 case the first server that answers is used.
14945 Each of the server names may be optionally followed by
14946 a colon and a port number.
14947 If this form is used then the port number configured below in the
14948 <EM>port</EM> field is not used.
14949 <P>
14950 To find out whether your organization has its own LDAP server,
14951 contact its computing support staff.
14952 <P><UL>
14953 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14954 </UL>
14955 <P>
14956 &lt;End of help on this topic&gt;
14957 </BODY>
14958 </HTML>
14959 ======= h_config_ldap_base =======
14960 <HTML>
14961 <HEAD>
14962 <TITLE>LDAP OPTION: Search-Base</TITLE>
14963 </HEAD>
14964 <BODY>
14965 <H1>LDAP OPTION: Search-Base</H1>
14966
14967 This is the search base to be used on this server.  It functions as a filter
14968 by restricting your searches in the LDAP server database
14969 to the specified contents of the specified fields.  Without it, searches
14970 submitted to this directory server may fail.  It might be something
14971 like:
14972
14973 <PRE>
14974       O = &lt;Your Organization Name&gt;, C = US
14975 </PRE>
14976 or it might be blank.
14977 (Some LDAP servers actually ignore anything specified here.)
14978 <P>
14979 If in doubt what parameters you should specify here,
14980 contact the maintainers of the LDAP server.
14981 <P><UL>
14982 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14983 </UL>
14984 <P>
14985 &lt;End of help on this topic&gt;
14986 </BODY>
14987 </HTML>
14988 ======= h_config_ldap_port =======
14989 <HTML>
14990 <HEAD>
14991 <TITLE>LDAP OPTION: Port</TITLE>
14992 </HEAD>
14993 <BODY>
14994 <H1>LDAP OPTION: Port</H1>
14995
14996 This is the TCP port number to be used with this LDAP server. If you leave
14997 this blank port 389 will be used.
14998 <P>
14999 &lt;End of help on this topic&gt;
15000 </BODY>
15001 </HTML>
15002 ======= h_config_ldap_nick =======
15003 <HTML>
15004 <HEAD>
15005 <TITLE>LDAP OPTION: Nickname</TITLE>
15006 </HEAD>
15007 <BODY>
15008 <H1>LDAP OPTION: Nickname</H1>
15009
15010 This is a nickname to be used in displays. If you don't supply a
15011 nickname the server name
15012 (<A HREF="h_config_ldap_server">&quot;<!--#echo var="VAR_ldap-servers"-->&quot;</A>)
15013 will be used instead.  This option is strictly for your convenience.
15014 <P>
15015 &lt;End of help on this topic&gt;
15016 </BODY>
15017 </HTML>
15018 ======= h_config_ldap_binddn =======
15019 <HTML>
15020 <HEAD>
15021 <TITLE>LDAP OPTION: Bind-DN</TITLE>
15022 </HEAD>
15023 <BODY>
15024 <H1>LDAP OPTION: Bind-DN</H1>
15025
15026 You may need to authenticate to the LDAP server before you are able to use it.
15027 This is the Distinguished Name to bind to when authenticating to this server.
15028 Try leaving this blank until you know you need it.
15029 <P>
15030 Alpine only knows about LDAP Simple authentication.
15031 It does not attempt LDAP SASL authentication.
15032 The DN and password will be sent in the clear unless TLS encryption is
15033 being used on this connection.
15034 Because of this, you may want to set the LDAP feature
15035 <A HREF="h_config_ldap_opts_tls">&quot;Attempt-TLS-On-Connection&quot;</A>
15036 or the feature
15037 <A HREF="h_config_ldap_opts_tlsmust">&quot;Require-TLS-On-Connection&quot;</A>
15038 if you are going to be providing a password.
15039 <P><UL>
15040 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
15041 </UL>
15042 <P>
15043 &lt;End of help on this topic&gt;
15044 </BODY>
15045 </HTML>
15046 ======= h_config_ldap_opts_impl =======
15047 <HTML>
15048 <HEAD>
15049 <TITLE>LDAP FEATURE: Use-Implicitly-From-Composer</TITLE>
15050 </HEAD>
15051 <BODY>
15052 <H1>LDAP FEATURE: Use-Implicitly-From-Composer</H1>
15053
15054 Set this to have lookups done to this server implicitly from the composer.
15055 If an address doesn't look like a fully-qualified address, it will be looked
15056 up in your address books, and if it doesn't match a nickname there, then it
15057 will be looked up on the LDAP servers that have this feature set.
15058 The lookups will also be done when using the address completion feature
15059 (TAB command) in the composer if any of the serves have this feature set.
15060 Also see the LDAP feature
15061 <A HREF="h_config_ldap_opts_rhs">&quot;Lookup-Addrbook-Contents&quot;</A>
15062 and the Setup/Config feature
15063 <A HREF="h_config_add_ldap">&quot;<!--#echo var="FEAT_ldap-result-to-addrbook-add"-->&quot;</A>.
15064 <P>
15065 &lt;End of help on this topic&gt;
15066 </BODY>
15067 </HTML>
15068 ======= h_config_ldap_opts_tls =======
15069 <HTML>
15070 <HEAD>
15071 <TITLE>LDAP FEATURE: Attempt-TLS-On-Connection</TITLE>
15072 </HEAD>
15073 <BODY>
15074 <H1>LDAP FEATURE: Attempt-TLS-On-Connection</H1>
15075
15076 When connecting to this server Alpine will attempt to use TLS encryption
15077 on the connection.
15078 Also see the closely related feature
15079 <A HREF="h_config_ldap_opts_tlsmust">&quot;Require-TLS-On-Connection&quot;</A>
15080 <P>
15081 Note that if this option is set, then
15082 <A HREF="h_config_ldap_opts_ldaps">
15083 &quot;Require-LDAPS-On-Connection&quot;</A>
15084 can not be enabled for this server. You must disable this feature in
15085 order to use
15086 <A HREF="h_config_ldap_opts_ldaps">
15087 &quot;Require-LDAPS-On-Connection&quot;</A>
15088 <P>
15089 &lt;End of help on this topic&gt;
15090 </BODY>
15091 </HTML>
15092 ======= h_config_ldap_opts_tlsmust =======
15093 <HTML>
15094 <HEAD>
15095 <TITLE>LDAP FEATURE: Require-TLS-On-Connection</TITLE>
15096 </HEAD>
15097 <BODY>
15098 <H1>LDAP FEATURE: Require-TLS-On-Connection</H1>
15099
15100 When connecting to this server Alpine will attempt to use TLS encryption
15101 on the connection.
15102 If the StartTLS operation fails then the connection will not be used.
15103 <P>
15104 Note that if this option is set, then
15105 <A HREF="h_config_ldap_opts_ldaps">
15106 &quot;Require-LDAPS-On-Connection&quot;</A>
15107 can not be enabled for this server. You must disable this feature in
15108 order to use
15109 <A HREF="h_config_ldap_opts_ldaps">
15110 &quot;Require-LDAPS-On-Connection&quot;</A>
15111 <P>
15112 &lt;End of help on this topic&gt;
15113 </BODY>
15114 </HTML>
15115 ======= h_config_ldap_opts_ldaps =======
15116 <HTML>
15117 <HEAD>
15118 <TITLE>LDAP FEATURE: Require-LDAPS-On-Connection</TITLE>
15119 </HEAD>
15120 <BODY>
15121 <H1>LDAP FEATURE: Require-LDAPS-On-Connection</H1>
15122
15123 When connecting to this server Alpine will use LDAPS (LDAP over SSL/TLS)
15124 on the connection.
15125 <P>
15126 This feature can not be used along with
15127 <A HREF="h_config_ldap_opts_tlsmust">&quot;Require-TLS-On-Connection&quot;</A>
15128  or
15129 <A HREF="h_config_ldap_opts_tls">&quot;Attempt-TLS-On-Connection&quot;</A>.
15130 If you want to connect using StartTLS to this server, you must disable
15131 this feature first.
15132 <P>
15133 &lt;End of help on this topic&gt;
15134 </BODY>
15135 </HTML>
15136 ====== h_config_ldap_opts_rhs =====
15137 <HTML>
15138 <HEAD>
15139 <TITLE>LDAP FEATURE: Lookup-Addrbook-Contents</TITLE>
15140 </HEAD>
15141 <BODY>
15142 <H1>LDAP FEATURE: Lookup-Addrbook-Contents</H1>
15143
15144 Normally implicit LDAP lookups from the composer are done only for the
15145 strings you type in from the composer screen. In other words, you type in
15146 something in the To or CC field and press return, then the string is looked up.
15147 First that string is looked up in your address books. If a match is found
15148 there, then the results of that match are looked up again. If you place
15149 a string in your address book that you want to have looked up on the LDAP
15150 directory server, you need to turn on this feature. If you set this feature
15151 for a server, you almost always will also want to set the
15152 <A HREF="h_config_ldap_opts_impl">&quot;Use-Implicitly-From-Composer&quot;</A>
15153 feature. An example might serve to best illustrate this feature.
15154 <P>
15155 If an LDAP lookup of &quot;William Clinton&quot; normally returns an
15156 entry with an
15157 address of pres@whitehouse.gov, then you might put an entry in your address
15158 book that looks like:
15159 <P>
15160 <CENTER><SAMP>Nickname = bill</SAMP></CENTER><BR>
15161 <CENTER><SAMP>Address = &quot;William Clinton&quot;</SAMP></CENTER>
15162 <P>
15163 Now, when you type &quot;bill&quot; into an
15164 address field in the composer Alpine will
15165 find the &quot;bill&quot; entry in your address book.
15166 It will replace &quot;bill&quot; with
15167 &quot;William Clinton&quot;.
15168 It will then search for an entry with that nickname
15169 in your address book and not find one. If this feature
15170 is set, Alpine will then attempt to lookup
15171 &quot;William Clinton&quot; on the LDAP server and find the entry with address
15172 pres@whitehouse.gov.
15173 <P>
15174 A better way to accomplish the same thing is probably to use the feature
15175 <A HREF="h_config_ldap_opts_ref">&quot;Save-Search-Criteria-Not-Result&quot;</A>.
15176 <P>
15177 &lt;End of help on this topic&gt;
15178 </BODY>
15179 </HTML>
15180 ====== h_config_ldap_opts_ref =====
15181 <HTML>
15182 <HEAD>
15183 <TITLE>LDAP FEATURE: Save-Search-Criteria-Not-Result</TITLE>
15184 </HEAD>
15185 <BODY>
15186 <H1>LDAP FEATURE: Save-Search-Criteria-Not-Result</H1>
15187
15188 Normally when you save the results of an LDAP directory lookup to your
15189 address book the results of the lookup are saved. If this feature is set
15190 and the entry being saved was found on this directory server, then the
15191 search criteria is saved instead of the results of the search. When this
15192 address book entry is used in the future, instead of copying the results
15193 from the address book the directory lookup will be done again. This could
15194 be useful if the copied result might become stale because the data on
15195 the directory server changes (for example, the entry's email address changes).
15196 You probably don't want to set this feature if the server is at all slow or
15197 unreliable.
15198 <P>
15199 The way this actually works is that instead of saving the email address
15200 in your address book, Alpine saves enough information to look up the same
15201 directory entry again. In particular, it saves the server name and the
15202 distinguished name of the entry. It's possible that the server administrators
15203 might change the format of distinguished names on the server, or that the
15204 entry might be removed from the server. If Alpine notices this, you will be warned
15205 and a backup copy of the email address will be used. You may want to create
15206 a new entry in this case, since you will get the annoying warning every
15207 time you use the old entry. You may do that by Saving the entry to a new
15208 nickname in the same address book. You will be asked whether or not you
15209 want to use the backup email address.
15210 <P>
15211 A related feature in the Setup/Config screen is
15212 <A HREF="h_config_add_ldap">&quot;<!--#echo var="FEAT_ldap-result-to-addrbook-add"-->&quot;</A>.
15213 <P>
15214 &lt;End of help on this topic&gt;
15215 </BODY>
15216 </HTML>
15217 ======= h_config_ldap_opts_nosub =======
15218 <HTML>
15219 <HEAD>
15220 <TITLE>LDAP FEATURE: Disable-Ad-Hoc-Space-Substitution</TITLE>
15221 </HEAD>
15222 <BODY>
15223 <H1>LDAP FEATURE: Disable-Ad-Hoc-Space-Substitution</H1>
15224
15225 Spaces in your input are normally handled specially.
15226 Each space character is replaced
15227 by
15228 <P>
15229 <CENTER><SAMP>*&nbsp;&lt;SPACE&gt;</SAMP></CENTER>
15230 <P>
15231 in the search query (but not by &quot;* &lt;SPACE&gt; *&quot;).
15232 The reason this is done is so the input string
15233 <P>
15234 <CENTER><SAMP>Greg Donald</SAMP></CENTER>
15235 <P>
15236 (which is converted to &quot;Greg* Donald&quot;) will match
15237 the names &quot;Greg Donald&quot;,
15238 &quot;Gregory Donald&quot;, &quot;Greg F. Donald&quot;, and
15239 &quot;Gregory F Donald&quot;; but it won't match &quot;Greg McDonald&quot;.
15240 If the &quot;Search-Rule&quot; you were using was &quot;begins-with&quot;,
15241 then it would also match the name &quot;Greg Donaldson&quot;.
15242 <P>
15243 Turning on this feature will disable this substitution.
15244 <P>
15245 &lt;End of help on this topic&gt;
15246 </BODY>
15247 </HTML>
15248 ====== h_config_ldap_searchtypes =======
15249 <HTML>
15250 <HEAD>
15251 <TITLE>LDAP OPTION: Search-Type</TITLE>
15252 </HEAD>
15253 <BODY>
15254 <H1>LDAP OPTION: Search-Type</H1>
15255
15256 This affects the way that LDAP searches are done.
15257 In particular, this tells the server where to look for the string to be matched.
15258 If set to &quot;name&quot; then the string that is being searched for will
15259 be compared with the string in the
15260 &quot;Name&quot; field on the server
15261 (technically, it is the &quot;commonname&quot; field on the server).
15262 &quot;Surname&quot; means we're looking for a
15263 match in the &quot;Surname&quot; field on the
15264 server (actually the &quot;sn&quot; field).
15265 &quot;Givenname&quot; really is &quot;givenname&quot;
15266 and &quot;email&quot; is the electronic mail address (this is actually the field
15267 called &quot;mail&quot; or &quot;electronicmail&quot; on the server).
15268 The other three types are combinations of
15269 the types listed so far. &quot;Name-or-email&quot;
15270 means the string should appear
15271 in either the &quot;name&quot; field OR the &quot;email&quot; field.
15272 Likewise, &quot;surname-or-givenname&quot;
15273 means &quot;surname&quot; OR &quot;givenname&quot;
15274 and &quot;sur-or-given-or-name-or-email&quot; means the obvious thing.
15275 <P>
15276 This search TYPE is combined with the
15277 search <A HREF="h_config_ldap_searchrules">RULE</A>
15278 to form the actual search query.
15279 <P>
15280 The usual default value for this
15281 option is &quot;sur-or-given-or-name-or-email&quot;.
15282 This type of search may be slow on some servers.
15283 Try &quot;name-or-email&quot;, which is often
15284 faster, or just &quot;name&quot; if the performance seems to be a problem.
15285 <P>
15286 Some servers have been configured with different attribute names for
15287 these four fields.
15288 In other words, instead of using the attribute name &quot;mail&quot;
15289 for the email address field, the server might be configured to use something
15290 else, for example, &quot;rfc822mail&quot; or &quot;internetemailaddress&quot;.
15291 Alpine can be configured to use these different attribute names by using
15292 the four configuration options:
15293 <P><UL>
15294 <LI><A HREF="h_config_ldap_email_attr">&quot;EmailAttribute&quot;</A>
15295 </UL>
15296 <P><UL>
15297 <LI><A HREF="h_config_ldap_cn_attr">&quot;NameAttribute&quot;</A>
15298 </UL>
15299 <P><UL>
15300 <LI><A HREF="h_config_ldap_sn_attr">&quot;SurnameAttribute&quot;</A>
15301 </UL>
15302 <P><UL>
15303 <LI><A HREF="h_config_ldap_gn_attr">&quot;GivennameAttribute&quot;</A>
15304 </UL>
15305 <P>
15306 &lt;End of help on this topic&gt;
15307 </BODY>
15308 </HTML>
15309 ====== h_config_ldap_searchrules =======
15310 <HTML>
15311 <HEAD>
15312 <TITLE>LDAP OPTION: Search-Rule</TITLE>
15313 </HEAD>
15314 <BODY>
15315 <H1>LDAP OPTION: Search-Rule</H1>
15316
15317 This affects the way that LDAP searches are done.
15318 If set to &quot;equals&quot; then
15319 only exact matches count.
15320 &quot;Contains&quot; means that the string you type in
15321 is a substring of what you are matching against.
15322 &quot;Begins-with&quot; and &quot;ends-with&quot;
15323 mean that the string starts or ends with the string you type in.
15324 <P>
15325 Spaces in your input are normally handled specially, but you can turn that
15326 special handling off with the
15327 <A HREF="h_config_ldap_opts_nosub">&quot;Disable-Ad-Hoc-Space-Substitution&quot;</A>
15328 feature.
15329 <P>
15330 The usual default value for this option is &quot;begins-with&quot;.
15331 <P>
15332 &lt;End of help on this topic&gt;
15333 </BODY>
15334 </HTML>
15335 ======= h_config_ldap_email_attr =======
15336 <HTML>
15337 <HEAD>
15338 <TITLE>LDAP OPTION: EmailAttribute</TITLE>
15339 </HEAD>
15340 <BODY>
15341 <H1>LDAP OPTION: EmailAttribute</H1>
15342
15343 This is the name of the attribute that is searched for when looking for
15344 an email address. The default value for this option is &quot;mail&quot; or
15345 &quot;electronicmail&quot;.
15346 If the server you are using uses a different attribute name for the email
15347 address, put that attribute name here.
15348 <P>
15349 This will affect the search filter used if your Search-Type is one that
15350 contains a search for &quot;email&quot;.
15351 It will also cause the attribute value matching this attribute name to be used
15352 as the email address when you look up an entry from the composer.
15353 <P>
15354 &lt;End of help on this topic&gt;
15355 </BODY>
15356 </HTML>
15357 ======= h_config_ldap_sn_attr =======
15358 <HTML>
15359 <HEAD>
15360 <TITLE>LDAP OPTION: SurnameAttribute</TITLE>
15361 </HEAD>
15362 <BODY>
15363 <H1>LDAP OPTION: SurnameAttribute</H1>
15364
15365 This is the name of the attribute that is searched for when looking for
15366 the surname of the entry. The default value for this option is &quot;sn&quot;.
15367 If the server you are using uses a different attribute name for the surname,
15368 put that attribute name here.
15369 This will affect the search filter used if your Search-Type is one that
15370 contains a search for &quot;surname&quot;.
15371 <P>
15372 &lt;End of help on this topic&gt;
15373 </BODY>
15374 </HTML>
15375 ======= h_config_ldap_gn_attr =======
15376 <HTML>
15377 <HEAD>
15378 <TITLE>LDAP OPTION: GivennameAttribute</TITLE>
15379 </HEAD>
15380 <BODY>
15381 <H1>LDAP OPTION: GivennameAttribute</H1>
15382
15383 This is the name of the attribute that is searched for when looking for
15384 the given name of the entry. The default value for this option is &quot;givenname&quot;.
15385 If the server you are using uses a different attribute name for the given name,
15386 put that attribute name here.
15387 This will affect the search filter used if your Search-Type is one that
15388 contains a search for &quot;givenname&quot;.
15389 <P>
15390 &lt;End of help on this topic&gt;
15391 </BODY>
15392 </HTML>
15393 ======= h_config_ldap_cn_attr =======
15394 <HTML>
15395 <HEAD>
15396 <TITLE>LDAP OPTION: NameAttribute</TITLE>
15397 </HEAD>
15398 <BODY>
15399 <H1>LDAP OPTION: NameAttribute</H1>
15400
15401 This is the name of the attribute that is searched for when looking for
15402 the name of the entry. The default value for this option is &quot;cn&quot;, which
15403 stands for common name.
15404 If the server you are using uses a different attribute name for the name,
15405 put that attribute name here.
15406 This will affect the search filter used if your Search-Type is one that
15407 contains a search for &quot;name&quot;.
15408 <P>
15409 &lt;End of help on this topic&gt;
15410 </BODY>
15411 </HTML>
15412 ======= h_config_ldap_time =======
15413 <HTML>
15414 <HEAD>
15415 <TITLE>LDAP OPTION: Timelimit</TITLE>
15416 </HEAD>
15417 <BODY>
15418 <H1>LDAP OPTION: Timelimit</H1>
15419
15420 This places a limit on the number of seconds the LDAP search will continue.
15421 The default is 30 seconds. A value of 0 means no limit. Note that some servers
15422 may place limits of their own on searches.
15423 <P>
15424 &lt;End of help on this topic&gt;
15425 </BODY>
15426 </HTML>
15427 ======= h_config_ldap_size =======
15428 <HTML>
15429 <HEAD>
15430 <TITLE>LDAP OPTION: Sizelimit</TITLE>
15431 </HEAD>
15432 <BODY>
15433 <H1>LDAP OPTION: Sizelimit</H1>
15434
15435 This places a limit on the number of entries returned by the LDAP server.
15436 A value of 0 means no limit. The default is 0. Note that some servers
15437 may place limits of their own on searches.
15438 <P>
15439 &lt;End of help on this topic&gt;
15440 </BODY>
15441 </HTML>
15442 ======= h_config_ldap_cust =======
15443 <HTML>
15444 <HEAD>
15445 <TITLE>LDAP OPTION: Custom-Search-Filter</TITLE>
15446 </HEAD>
15447 <BODY>
15448 <H1>LDAP OPTION: Custom-Search-Filter</H1>
15449
15450 This one is for advanced users only! If you define this, then the
15451 &quot;Search-Type&quot; and &quot;Search-Rule&quot; defined are both ignored.
15452 However, the feature
15453 <A HREF="h_config_ldap_opts_nosub">&quot;Disable-Ad-Hoc-Space-Substitution&quot;</A>
15454 is still in effect.
15455 That is, the space substitution will take place even in a custom filter unless
15456 you disable it.
15457 <P>
15458 If your LDAP service stops working and you suspect it might be because
15459 of your custom filter, just delete this filter and try using the
15460 &quot;Search-Type&quot; and &quot;Search-Rule&quot; instead.
15461 Another option that sometimes causes trouble is the
15462 <A HREF="h_config_ldap_base">&quot;Search-Base&quot;</A> option.
15463 <P>
15464 This variable may be set to the string representation of an LDAP search
15465 filter (see RFC1960). In the places where you want the address string to be
15466 substituted in, put a '%s' in this filter string. Here are some examples:
15467 <P>
15468 A &quot;Search-Type&quot; of &quot;name&quot; with &quot;Search-Rule&quot; of &quot;begins-with&quot;
15469 is equivalent to the &quot;Custom-Search-Filter&quot;
15470 <PRE>
15471      (cn=%s*)
15472 </PRE>
15473 When you try to match against the string &quot;string&quot; the program replaces
15474 the &quot;%s&quot; with &quot;string&quot; (without the quotes). You may have multiple &quot;%s&quot;'s and
15475 they will all be replaced with the string. There is a limit of 10 &quot;%s&quot;'s.
15476 <P>
15477 A &quot;Search-Type&quot; of &quot;name-or-email&quot; with &quot;Search-Rule&quot;
15478 of &quot;contains&quot; is equivalent to
15479 <PRE>
15480      (|(cn=*%s*)(mail=*%s*))
15481 </PRE>
15482 <P>
15483 If your server uses a different attribute <EM>name</EM> than
15484 Alpine uses by default,
15485 (for example, it uses &quot;rfc822mail&quot; instead of &quot;mail&quot;),
15486 then you may be able to use one or more of the four attribute configuration
15487 options instead of defining a custom filter:
15488 <P><UL>
15489 <LI><A HREF="h_config_ldap_email_attr">&quot;EmailAttribute&quot;</A>
15490 </UL>
15491 <P><UL>
15492 <LI><A HREF="h_config_ldap_cn_attr">&quot;NameAttribute&quot;</A>
15493 </UL>
15494 <P><UL>
15495 <LI><A HREF="h_config_ldap_sn_attr">&quot;SurnameAttribute&quot;</A>
15496 </UL>
15497 <P><UL>
15498 <LI><A HREF="h_config_ldap_gn_attr">&quot;GivennameAttribute&quot;</A>
15499 </UL>
15500 <P>
15501 &lt;End of help on this topic&gt;
15502 </BODY>
15503 </HTML>
15504 ======= h_composer_abook_comment =======
15505 <HTML>
15506 <HEAD>
15507 <TITLE>Addressbook Comment Explained</TITLE>
15508 </HEAD>
15509 <BODY>
15510 This is a comment to help you remember what this entry is. The WhereIs
15511 command searches comments so that it is easier to find an entry with a comment
15512 you know about attached to it. This field is not used in the outgoing message.
15513 <P>
15514 Look <A HREF="h_edit_nav_cmds">here</A>
15515 to see the available Editing and Navigation commands.
15516 <P>
15517 &lt;End of help on this topic&gt;
15518 </BODY>
15519 </HTML>
15520 ======= h_composer_abook_addrs =======
15521 <HTML>
15522 <HEAD>
15523 <TITLE>Addressbook Lists</TITLE>
15524 </HEAD>
15525 <BODY>
15526 <H1>Addressbook Lists</H1>
15527
15528 This is a list of addresses to send to when sending to this address book
15529 entry.  Each member of the list may be an address or another nickname from
15530 any of your address books.  If it is an address, it is OK to include the
15531 full name field as well as the electronic address portion of that address.
15532 For example, the following are all legitimate entries in this field:
15533
15534 <DL><DT>&nbsp;</DT>
15535 <DD>john&nbsp;&nbsp;&nbsp;&nbsp;(a nickname in your address book)
15536 <DD>jdoe@some.domain
15537 <DD>John Doe &lt;jdoe@some.domain&gt;
15538 </DL>
15539
15540 The addresses should be listed separated by commas, just like you would
15541 enter them from the composer.
15542
15543 <P>
15544
15545 The only difference between a distribution list and a simple entry with a
15546 single address, is that a distribution list has more than one address
15547 listed in the Addresses: field, whereas a simple personal entry has just
15548 one address.
15549
15550 <P>
15551
15552 For individual address book entries, if there is a full name in the
15553 Fullname: field (filling in the Fullname: field is not required), it is
15554 used.  If the full name is specified in the Address: field and not in the
15555 Fullname: field, then the full name from the Address: field is used.
15556
15557 <P>
15558
15559 If you type the nickname of a distribution list from one of your address
15560 books in the Lcc: field, then the full name of that list is used in the
15561 To: field.  If you put a list in the To: or Cc: fields, that list will be
15562 expanded into all of its addresses.  If the list has a full name, then
15563 that will appear at the beginning of the addresses.
15564
15565 <DL><DT>&nbsp;</DT>
15566 <DD>Sewing Club &lt;john@somewhere&gt;, nancy@something.else, Sal
15567 &lt;sal@here.there&gt;
15568 </DL>
15569
15570 If the first address in the distribution list also has a full name, then
15571 the list full name and that full name are combined into something like the
15572 following:
15573
15574 <DL><DT>&nbsp;</DT>
15575 <DD>Sewing Club -- John Smith &lt;john@somewhere&gt;
15576 </DL>
15577
15578
15579 If you specify a list via Lcc, the full name is used in the To: line.  If
15580 you specify a list in the To: or Cc: fields, then it uses the same method
15581 as for individual entries for filling in the full name.
15582
15583 <P>
15584
15585 For help with editing and navigation commands, check the Help for the
15586 Nickname: field.
15587
15588 <P>
15589 &lt;End of help on this topic&gt;
15590 </BODY>
15591 </HTML>
15592 ======= h_config_role_nick =======
15593 <HTML>
15594 <HEAD>
15595 <TITLE>Nickname Explained</TITLE>
15596 </HEAD>
15597 <BODY>
15598 <H1>Nickname Explained</H1>
15599
15600 This is a nickname to help you.
15601 You should have a different nickname for each role you define.
15602 The nickname will be used in the SETUP ROLE RULES screen to allow you to
15603 pick a role to edit.
15604 It will also be used when you send a message to let you know you are
15605 sending with a different role than you use by default, and
15606 it will be useful for choosing a role when composing with the Role command
15607 or when composing with one of the Role Uses set to With Confirmation.
15608 This field is not used in the outgoing message.
15609 <P>
15610 Look <A HREF="h_edit_nav_cmds">here</A>
15611 to see the available Editing and Navigation commands.
15612 <P>
15613 &lt;End of help on this topic&gt;
15614 </BODY>
15615 </HTML>
15616 ======= h_config_role_comment =======
15617 <HTML>
15618 <HEAD>
15619 <TITLE>Comment Explained</TITLE>
15620 </HEAD>
15621 <BODY>
15622 <H1>Comment Explained</H1>
15623
15624 This is a comment to help you.
15625 This comment does not play any functional role, it is simply an optional
15626 comment to help you remember what the rule is for.
15627 <P>
15628 Look <A HREF="h_edit_nav_cmds">here</A>
15629 to see the available Editing and Navigation commands.
15630 <P>
15631 &lt;End of help on this topic&gt;
15632 </BODY>
15633 </HTML>
15634 ======= h_config_other_nick =======
15635 <HTML>
15636 <HEAD>
15637 <TITLE>Nickname Explained</TITLE>
15638 </HEAD>
15639 <BODY>
15640 <H1>Nickname Explained</H1>
15641
15642 This is a nickname to help you.
15643 You should have a different nickname for each rule you define.
15644 The nickname will be used in the SETUP OTHER RULES screen to allow you to
15645 pick a rule to edit.
15646 <P>
15647 Look <A HREF="h_edit_nav_cmds">here</A>
15648 to see the available Editing and Navigation commands.
15649 <P>
15650 &lt;End of help on this topic&gt;
15651 </BODY>
15652 </HTML>
15653 ======= h_config_score_nick =======
15654 <HTML>
15655 <HEAD>
15656 <TITLE>Nickname Explained</TITLE>
15657 </HEAD>
15658 <BODY>
15659 <H1>Nickname Explained</H1>
15660
15661 This is a nickname to help you.
15662 You should have a different nickname for each scoring rule you define.
15663 The nickname will be used in the SETUP SCORING RULES screen to allow you to
15664 pick a rule to edit.
15665 <P>
15666 Look <A HREF="h_edit_nav_cmds">here</A>
15667 to see the available Editing and Navigation commands.
15668 <P>
15669 &lt;End of help on this topic&gt;
15670 </BODY>
15671 </HTML>
15672 ======= h_config_incol_nick =======
15673 <HTML>
15674 <HEAD>
15675 <TITLE>Nickname Explained</TITLE>
15676 </HEAD>
15677 <BODY>
15678 <H1>Nickname Explained</H1>
15679
15680 This is a nickname to help you.
15681 You should have a different nickname for each color rule you define.
15682 The nickname will be used in the SETUP INDEX COLOR RULES screen to allow you to
15683 pick a rule to edit.
15684 <P>
15685 Look <A HREF="h_edit_nav_cmds">here</A>
15686 to see the available Editing and Navigation commands.
15687 <P>
15688 &lt;End of help on this topic&gt;
15689 </BODY>
15690 </HTML>
15691 ======= h_config_filt_nick =======
15692 <HTML>
15693 <HEAD>
15694 <TITLE>Nickname Explained</TITLE>
15695 </HEAD>
15696 <BODY>
15697 <H1>Nickname Explained</H1>
15698
15699 This is a nickname to help you.
15700 You should have a different nickname for each filtering rule you define.
15701 The nickname will be used in the SETUP FILTERING RULES screen to allow you to
15702 pick a rule to edit.
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_score_topat =======
15711 <HTML>
15712 <HEAD>
15713 <TITLE>&quot;To:&quot; Pattern Explained</TITLE>
15714 </HEAD>
15715 <BODY>
15716 <H1>&quot;To:&quot; Pattern Explained</H1>
15717
15718 Any text you enter as the &quot;To pattern&quot;
15719 will be compared to the recipients from the To: line of
15720 the message being scored.
15721 When the text you entered matches
15722 all or part of the To: line of a message, then the Score Value
15723 you have specified will be added to the score for the message.
15724 (Any other non-blank parts of the Pattern must match, too.)
15725 <P>
15726
15727 You may enter a complete email address, part of an address, or a
15728 list of addresses or partial addresses.
15729 For example:
15730 <P>
15731
15732 <PRE>
15733  To pattern = friend@public.com
15734
15735  To pattern = rated.net
15736
15737  To pattern = xxx@adults.com
15738               admin@msn.com
15739               fool@motleyfool.com
15740 </PRE>
15741
15742 <P>
15743 Each of those are valid To patterns.
15744 <P>
15745
15746 Messages match those patterns if any of the
15747 addresses in the To: line of the message contains the pattern.
15748 If the pattern is a list of patterns
15749 (like the last example above) then it is a match if any of the patterns in
15750 the list match any of the addresses in the To: line.
15751 (It is not possible to specify two addresses that must <EM>BOTH</EM> be
15752 present for a match.
15753 It is only possible to specify that <EM>EITHER</EM> address1 <EM>OR</EM>
15754 address2 must be present.
15755 That is exactly what using a list does.)
15756 <P>
15757
15758 Some messages may be &quot;bounced&quot; to you, and will
15759 have a &quot;Resent-To:&quot; header line.
15760 If the message contains a Resent-To: line
15761 and the feature <A HREF="h_config_use_resentto"><!--#echo var="FEAT_use-resent-to-in-rules"--></A> is turned on,
15762 Alpine will look for
15763 matches to your &quot;To patterns&quot; there, and <EM>NOT</EM> in
15764 the original To: line.
15765 <P>
15766
15767 When entering a pattern, you may choose an address from your address book
15768 with the &quot;T&quot; command.
15769 <P>
15770
15771 It is possible to add a <EM>NOT</EM> to the To Pattern meaning with the
15772 &quot;!&quot; &quot;toggle NOT&quot; command.
15773 This changes the meaning of the To pattern so that it has the opposite meaning.
15774 It will be considered a match if there are no matches between the
15775 addresses in the To: line and the list of To patterns.
15776 <P>
15777 Don't make the mistake of putting the &quot;!&quot; in the data field for
15778 the pattern.
15779 For example, if you type the characters &quot;!frizzle&quot; into the To
15780 pattern, the pattern will look like:
15781 <P>
15782 <PRE>
15783  To pattern = !frizzle
15784 </PRE>
15785 <P>
15786 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
15787 In order to match messages that do not have &quot;frizzle&quot; in
15788 their To field, first type the characters &quot;frizzle&quot; followed
15789 by carriage return for the value of the To pattern, then negate it
15790 by typing the &quot;!&quot; command.
15791 It should end up looking like
15792 <P>
15793 <PRE>
15794  ! To pattern = frizzle
15795 </PRE>
15796 <P>
15797 You are not limited to using the six standard header patterns that are
15798 normally shown (To, From, Sender, Cc, News, and Subject).
15799 You may add any other header to a Pattern by
15800 using the &quot;eXtraHdr&quot; command to specify a different
15801 message header line; and then the Add or Change command to fill in
15802 a pattern for the new header line, just like you would for a standard header.
15803 <P>
15804 A technicality: Since comma is the character used to separate multiple
15805 values in a pattern field, you have to escape comma with a backslash (&#92;) if
15806 you want to include a literal comma in the field.
15807 In other words, if you type a backslash followed by a comma it will
15808 be interpreted as a comma by Alpine, instead of as a separator between
15809 pattern values.
15810 All other backslashes are literal backslashes and should not be escaped.
15811 <P>
15812 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
15813 for more information on Patterns.
15814 <P>
15815 Look <A HREF="h_edit_nav_cmds">here</A>
15816 to see the available Editing and Navigation commands.
15817 <P>
15818 &lt;End of help on this topic&gt;
15819 </BODY>
15820 </HTML>
15821 ======= h_config_incol_topat =======
15822 <HTML>
15823 <HEAD>
15824 <TITLE>&quot;To:&quot; Pattern Explained</TITLE>
15825 </HEAD>
15826 <BODY>
15827 <H1>&quot;To:&quot; Pattern Explained</H1>
15828
15829 Any text you enter as the &quot;To pattern&quot;
15830 will be compared to the recipients from the To: lines of
15831 the messages in the index.
15832 When the text you entered matches
15833 all or part of the To: line of a message, then the Index Line Color you have
15834 specified will be used for that line in the index.
15835 (Any other non-blank parts of the Pattern must match, too.)
15836 <P>
15837
15838 You may enter a complete email address, part of an address, or a
15839 list of addresses or partial addresses.
15840 For example:
15841 <P>
15842
15843 <PRE>
15844  To pattern = friend@public.com
15845  To pattern = rated.net
15846  To pattern = xxx@adults.com
15847               admin@msn.com
15848               fool@motleyfool.com
15849 </PRE>
15850
15851 <P>
15852 Each of those are valid To patterns.
15853 <P>
15854
15855 Messages match those patterns if any of the
15856 addresses in the To: line of the message contains the pattern.
15857 If the pattern is a list of patterns
15858 (like the last example above) then it is a match if any of the patterns in
15859 the list match any of the addresses in the To: line.
15860 (It is not possible to specify two addresses that must <EM>BOTH</EM> be
15861 present for a match.
15862 It is only possible to specify that <EM>EITHER</EM> address1 <EM>OR</EM>
15863 address2 must be present.
15864 That is exactly what using a list does.)
15865 <P>
15866
15867 Some messages may be &quot;bounced&quot; to you, and will
15868 have a &quot;Resent-To:&quot; header line.
15869 If the message contains a Resent-To: line
15870 and the feature <A HREF="h_config_use_resentto"><!--#echo var="FEAT_use-resent-to-in-rules"--></A> is turned on,
15871 Alpine will look for
15872 matches to your &quot;To patterns&quot; there, and <EM>NOT</EM> in
15873 the original To: line.
15874 <P>
15875
15876 When entering a pattern, you may choose an address from your address book
15877 with the &quot;T&quot; command.
15878 <P>
15879
15880 It is possible to add a <EM>NOT</EM> to the To Pattern meaning with the
15881 &quot;!&quot; &quot;toggle NOT&quot; command.
15882 This changes the meaning of the To pattern so that it has the opposite meaning.
15883 It will be considered a match if there are no matches between the
15884 addresses in the To: line and the list of To patterns.
15885 <P>
15886 Don't make the mistake of putting the &quot;!&quot; in the data field for
15887 the pattern.
15888 For example, if you type the characters &quot;!frizzle&quot; into the To
15889 pattern, the pattern will look like:
15890 <P>
15891 <PRE>
15892  To pattern = !frizzle
15893 </PRE>
15894 <P>
15895 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
15896 In order to match messages that do not have &quot;frizzle&quot; in
15897 their To field, first type the characters &quot;frizzle&quot; followed
15898 by carriage return for the value of the To pattern, then negate it
15899 by typing the &quot;!&quot; command.
15900 It should end up looking like
15901 <P>
15902 <PRE>
15903  ! To pattern = frizzle
15904 </PRE>
15905 <P>
15906
15907 You are not limited to using the six standard header patterns that are
15908 normally shown (To, From, Sender, Cc, News, and Subject).
15909 You may add any other header to a Pattern by
15910 using the &quot;eXtraHdr&quot; command to specify a different
15911 message header line; and then the Add or Change command to fill in
15912 a pattern for the new header line, just like you would for a standard header.
15913 <P>
15914 A technicality: Since comma is the character used to separate multiple
15915 values in a pattern field, you have to escape comma with a backslash (&#92;) if
15916 you want to include a literal comma in the field.
15917 In other words, if you type a backslash followed by a comma it will
15918 be interpreted as a comma by Alpine, instead of as a separator between
15919 pattern values.
15920 All other backslashes are literal backslashes and should not be escaped.
15921 <P>
15922 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
15923 for more information on Patterns.
15924 <P>
15925 Look <A HREF="h_edit_nav_cmds">here</A>
15926 to see the available Editing and Navigation commands.
15927 <P>
15928 &lt;End of help on this topic&gt;
15929 </BODY>
15930 </HTML>
15931 ======= h_config_other_topat =======
15932 <HTML>
15933 <HEAD>
15934 <TITLE>&quot;To:&quot; Pattern Explained</TITLE>
15935 </HEAD>
15936 <BODY>
15937 <H1>&quot;To:&quot; Pattern Explained</H1>
15938
15939 For some of the OTHER RULES actions, there is no message that is being
15940 compared against.
15941 If that is the case, then only the Current Folder Type is checked.
15942 In particular, this To pattern is ignored.
15943 Actions that fall into this category include both
15944 Sort Order and Index Format.
15945 <P>
15946 A technicality: Since comma is the character used to separate multiple
15947 values in a pattern field, you have to escape comma with a backslash (&#92;) if
15948 you want to include a literal comma in the field.
15949 In other words, if you type a backslash followed by a comma it will
15950 be interpreted as a comma by Alpine, instead of as a separator between
15951 pattern values.
15952 All other backslashes are literal backslashes and should not be escaped.
15953 <P>
15954 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
15955 for more information on Patterns.
15956 <P>
15957 Look <A HREF="h_edit_nav_cmds">here</A>
15958 to see the available Editing and Navigation commands.
15959 <P>
15960 &lt;End of help on this topic&gt;
15961 </BODY>
15962 </HTML>
15963 ======= h_config_filt_topat =======
15964 <HTML>
15965 <HEAD>
15966 <TITLE>&quot;To:&quot; Pattern Explained</TITLE>
15967 </HEAD>
15968 <BODY>
15969 <H1>&quot;To:&quot; Pattern Explained</H1>
15970
15971 Any text you enter as the &quot;To pattern&quot;
15972 will be compared to the recipients from the To: line of
15973 messages when Alpine opens folders.
15974 When the text you entered matches
15975 all or part of the To: line of a message, then the Filter Action you have
15976 specified will be carried out.
15977 (Any other non-blank parts of the Pattern must match, too.)
15978 <P>
15979
15980 You may enter a complete email address, part of an address, or a
15981 list of addresses or partial addresses.
15982 For example:
15983 <P>
15984
15985 <PRE>
15986  To pattern = friend@public.com
15987  To pattern = rated.net
15988  To pattern = xxx@adults.com
15989               admin@msn.com
15990               fool@motleyfool.com
15991 </PRE>
15992
15993 <P>
15994 Each of those are valid To patterns.
15995 <P>
15996
15997 Messages match those patterns if any of the
15998 addresses in the To: line of the message contains the pattern.
15999 If the pattern is a list of patterns
16000 (like the last example above) then it is a match if any of the patterns in
16001 the list match any of the addresses in the To: line.
16002 (It is not possible to specify two addresses that must <EM>BOTH</EM> be
16003 present for a match.
16004 It is only possible to specify that <EM>EITHER</EM> address1 <EM>OR</EM>
16005 address2 must be present.
16006 That is exactly what using a list does.)
16007 <P>
16008
16009 Some messages may be &quot;bounced&quot; to you, and will
16010 have a &quot;Resent-To:&quot; header line.
16011 If the message contains a Resent-To: line
16012 and the feature <A HREF="h_config_use_resentto"><!--#echo var="FEAT_use-resent-to-in-rules"--></A> is turned on,
16013 Alpine will look for
16014 matches to your &quot;To patterns&quot; there, and <EM>NOT</EM> in
16015 the original To: line.
16016 <P>
16017
16018 When entering a pattern, you may choose an address from your address book
16019 with the &quot;T&quot; command.
16020 <P>
16021
16022 It is possible to add a <EM>NOT</EM> to the To Pattern meaning with the
16023 &quot;!&quot; &quot;toggle NOT&quot; command.
16024 This changes the meaning of the To pattern so that it has the opposite meaning.
16025 It will be considered a match if there are no matches between the
16026 addresses in the To: line and the list of To patterns.
16027 <P>
16028 Don't make the mistake of putting the &quot;!&quot; in the data field for
16029 the pattern.
16030 For example, if you type the characters &quot;!frizzle&quot; into the To
16031 pattern, the pattern will look like:
16032 <P>
16033 <PRE>
16034  To pattern = !frizzle
16035 </PRE>
16036 <P>
16037 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
16038 In order to match messages that do not have &quot;frizzle&quot; in
16039 their To field, first type the characters &quot;frizzle&quot; followed
16040 by carriage return for the value of the To pattern, then negate it
16041 by typing the &quot;!&quot; command.
16042 It should end up looking like
16043 <P>
16044 <PRE>
16045  ! To pattern = frizzle
16046 </PRE>
16047 <P>
16048
16049 You are not limited to using the six standard header patterns that are
16050 normally shown (To, From, Sender, Cc, News, and Subject).
16051 You may add any other header to a Pattern by
16052 using the &quot;eXtraHdr&quot; command to specify a different
16053 message header line; and then the Add or Change command to fill in
16054 a pattern for the new header line, just like you would for a standard header.
16055 <P>
16056 A technicality: Since comma is the character used to separate multiple
16057 values in a pattern field, you have to escape comma with a backslash (&#92;) if
16058 you want to include a literal comma in the field.
16059 In other words, if you type a backslash followed by a comma it will
16060 be interpreted as a comma by Alpine, instead of as a separator between
16061 pattern values.
16062 All other backslashes are literal backslashes and should not be escaped.
16063 <P>
16064 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16065 for more information on Patterns.
16066 <P>
16067 Look <A HREF="h_edit_nav_cmds">here</A>
16068 to see the available Editing and Navigation commands.
16069 <P>
16070 &lt;End of help on this topic&gt;
16071 </BODY>
16072 </HTML>
16073 ======= h_config_role_topat =======
16074 <HTML>
16075 <HEAD>
16076 <TITLE>&quot;To:&quot; Pattern Explained</TITLE>
16077 </HEAD>
16078 <BODY>
16079 <H1>&quot;To:&quot; Pattern Explained</H1>
16080
16081 Any text you enter as the &quot;To pattern&quot;
16082 will be compared to the recipients from the To: line of
16083 the message being replied to or forwarded.
16084 (Any other non-blank parts of the Pattern must match, too.)
16085 In the case of the Compose command, this pattern and the other header
16086 patterns are ignored.
16087 <P>
16088
16089 You may enter a complete email address, part of an address, or a
16090 list of addresses or partial addresses.
16091 For example:
16092 <P>
16093
16094 <PRE>
16095  To pattern = friend@public.com
16096  To pattern = rated.net
16097  To pattern = xxx@adults.com
16098               admin@msn.com
16099               fool@motleyfool.com
16100 </PRE>
16101
16102 <P>
16103 Each of those are valid To patterns.
16104 <P>
16105
16106 Messages match those patterns if any of the
16107 addresses in the To: line of the message contains the pattern.
16108 If the pattern is a list of patterns
16109 (like the last example above) then it is a match if any of the patterns in
16110 the list match any of the addresses in the To: line.
16111 (It is not possible to specify two addresses that must <EM>BOTH</EM> be
16112 present for a match.
16113 It is only possible to specify that <EM>EITHER</EM> address1 <EM>OR</EM>
16114 address2 must be present.
16115 That is exactly what using a list does.)
16116 <P>
16117
16118 Some messages may be &quot;bounced&quot; to you, and will
16119 have a &quot;Resent-To:&quot; header line.
16120 If the message contains a Resent-To: line
16121 and the feature <A HREF="h_config_use_resentto"><!--#echo var="FEAT_use-resent-to-in-rules"--></A> is turned on,
16122 Alpine will look for
16123 matches to your &quot;To patterns&quot; there, and <EM>NOT</EM> in
16124 the original To: line.
16125 <P>
16126
16127 When entering a pattern, you may choose an address from your address book
16128 with the &quot;T&quot; command.
16129 <P>
16130
16131 It is possible to add a <EM>NOT</EM> to the To Pattern meaning with the
16132 &quot;!&quot; &quot;toggle NOT&quot; command.
16133 This changes the meaning of the To pattern so that it has the opposite meaning.
16134 It will be considered a match if there are no matches between the
16135 addresses in the To: line and the list of To patterns.
16136 <P>
16137 Don't make the mistake of putting the &quot;!&quot; in the data field for
16138 the pattern.
16139 For example, if you type the characters &quot;!frizzle&quot; into the To
16140 pattern, the pattern will look like:
16141 <P>
16142 <PRE>
16143  To pattern = !frizzle
16144 </PRE>
16145 <P>
16146 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
16147 In order to match messages that do not have &quot;frizzle&quot; in
16148 their To field, first type the characters &quot;frizzle&quot; followed
16149 by carriage return for the value of the To pattern, then negate it
16150 by typing the &quot;!&quot; command.
16151 It should end up looking like
16152 <P>
16153 <PRE>
16154  ! To pattern = frizzle
16155 </PRE>
16156 <P>
16157
16158 You are not limited to using the six standard header patterns that are
16159 normally shown (To, From, Sender, Cc, News, and Subject).
16160 You may add any other header to a Pattern by
16161 using the &quot;eXtraHdr&quot; command to specify a different
16162 message header line; and then the Add or Change command to fill in
16163 a pattern for the new header line, just like you would for a standard header.
16164 <P>
16165 A technicality: Since comma is the character used to separate multiple
16166 values in a pattern field, you have to escape comma with a backslash (&#92;) if
16167 you want to include a literal comma in the field.
16168 In other words, if you type a backslash followed by a comma it will
16169 be interpreted as a comma by Alpine, instead of as a separator between
16170 pattern values.
16171 All other backslashes are literal backslashes and should not be escaped.
16172 <P>
16173 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16174 for more information on Patterns.
16175 <P>
16176 Look <A HREF="h_edit_nav_cmds">here</A>
16177 to see the available Editing and Navigation commands.
16178 <P>
16179 &lt;End of help on this topic&gt;
16180 </BODY>
16181 </HTML>
16182 ======= h_config_role_frompat =======
16183 <HTML>
16184 <HEAD>
16185 <TITLE>&quot;From:&quot; Pattern Explained</TITLE>
16186 </HEAD>
16187 <BODY>
16188 <H1>&quot;From:&quot; Pattern Explained</H1>
16189
16190 This is just like the &quot;To pattern&quot; except that it is compared with
16191 the address in the From: line of the message
16192 instead of the addresses from the To: line.
16193 See the help for the To pattern for more information on header patterns.
16194 <P>
16195 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16196 for more information on Patterns.
16197 <P>
16198 Look <A HREF="h_edit_nav_cmds">here</A>
16199 to see the available Editing and Navigation commands.
16200 <P>
16201 &lt;End of help on this topic&gt;
16202 </BODY>
16203 </HTML>
16204 ======= h_config_role_senderpat =======
16205 <HTML>
16206 <HEAD>
16207 <TITLE>&quot;Sender:&quot; Pattern Explained</TITLE>
16208 </HEAD>
16209 <BODY>
16210 <H1>&quot;Sender:&quot; Pattern Explained</H1>
16211
16212 This is just like the &quot;To pattern&quot; except that it is compared with
16213 the address from the Sender: line of the message
16214 instead of the addresses from the To: line.
16215 See the help for the To pattern for more information on header patterns.
16216 <P>
16217 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16218 for more information on Patterns.
16219 <P>
16220 Look <A HREF="h_edit_nav_cmds">here</A>
16221 to see the available Editing and Navigation commands.
16222 <P>
16223 &lt;End of help on this topic&gt;
16224 </BODY>
16225 </HTML>
16226 ======= h_config_role_ccpat =======
16227 <HTML>
16228 <HEAD>
16229 <TITLE>&quot;Cc:&quot; Pattern Explained</TITLE>
16230 </HEAD>
16231 <BODY>
16232 <H1>&quot;Cc:&quot; Pattern Explained</H1>
16233
16234 This is just like the &quot;To pattern&quot; except that it is compared with
16235 the addresses from the Cc: line of the message
16236 instead of the addresses from the To: line.
16237 See the help for the To pattern for more information on header patterns.
16238 <P>
16239 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16240 for more information on Patterns.
16241 <P>
16242 Look <A HREF="h_edit_nav_cmds">here</A>
16243 to see the available Editing and Navigation commands.
16244 <P>
16245 &lt;End of help on this topic&gt;
16246 </BODY>
16247 </HTML>
16248 ======= h_config_role_recippat =======
16249 <HTML>
16250 <HEAD>
16251 <TITLE>Recipient Pattern Explained</TITLE>
16252 </HEAD>
16253 <BODY>
16254 <H1>Recipient Pattern Explained</H1>
16255
16256 This is just like the &quot;To pattern&quot; except that it is compared with
16257 the addresses from both the To: line and the Cc: line of the
16258 message instead of just the addresses from the To: line.
16259 In other words, it is considered a match if the pattern matches
16260 <EM>EITHER</EM> an address in the To: line <EM>OR</EM> an address
16261 in the Cc: line.
16262 (Notice that defining the Recipient pattern does not have the same
16263 effect as defining both the To and Cc patterns.
16264 Recipient is To <EM>OR</EM> Cc; not To <EM>AND</EM> Cc.
16265 It is equivalent to having two different rules;
16266 one with a To pattern and the other with the same Cc pattern.)
16267 <P>
16268 A technicality: Since comma is the character used to separate multiple
16269 values in a pattern field, you have to escape comma with a backslash (&#92;) if
16270 you want to include a literal comma in the field.
16271 In other words, if you type a backslash followed by a comma it will
16272 be interpreted as a comma by Alpine, instead of as a separator between
16273 pattern values.
16274 All other backslashes are literal backslashes and should not be escaped.
16275 <P>
16276 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16277 for more information on Patterns.
16278 <P>
16279 Look <A HREF="h_edit_nav_cmds">here</A>
16280 to see the available Editing and Navigation commands.
16281 <P>
16282 &lt;End of help on this topic&gt;
16283 </BODY>
16284 </HTML>
16285 ======= h_config_role_particpat =======
16286 <HTML>
16287 <HEAD>
16288 <TITLE>Participant Pattern Explained</TITLE>
16289 </HEAD>
16290 <BODY>
16291 <H1>Participant Pattern Explained</H1>
16292
16293 This is just like the &quot;To pattern&quot; except that it is compared with
16294 the addresses from the From: line, the To: line, and the Cc: line of the
16295 message instead of just the addresses from the To: line.
16296 In other words, it is considered a match if the pattern matches
16297 <EM>EITHER</EM> an address in the From: line, <EM>OR</EM> an address
16298 in the To: line, <EM>OR</EM> an address in the Cc: line.
16299 (Notice that defining the Participant pattern does not have the same
16300 effect as defining all of the From, To, and Cc patterns.
16301 Participant is From <EM>OR</EM> To <EM>OR</EM> Cc; not
16302 From <EM>AND</EM> To <EM>AND</EM> Cc.
16303 It is equivalent to having three different rules;
16304 one with a From pattern, another with the same To pattern, and a third with
16305 the same Cc pattern.)
16306 <P>
16307 A technicality: Since comma is the character used to separate multiple
16308 values in a pattern field, you have to escape comma with a backslash (&#92;) if
16309 you want to include a literal comma in the field.
16310 In other words, if you type a backslash followed by a comma it will
16311 be interpreted as a comma by Alpine, instead of as a separator between
16312 pattern values.
16313 All other backslashes are literal backslashes and should not be escaped.
16314 <P>
16315 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16316 for more information on Patterns.
16317 <P>
16318 Look <A HREF="h_edit_nav_cmds">here</A>
16319 to see the available Editing and Navigation commands.
16320 <P>
16321 &lt;End of help on this topic&gt;
16322 </BODY>
16323 </HTML>
16324 ======= h_config_role_newspat =======
16325 <HTML>
16326 <HEAD>
16327 <TITLE>News Pattern Explained</TITLE>
16328 </HEAD>
16329 <BODY>
16330 <H1>News Pattern Explained</H1>
16331
16332 If this pattern is non-blank, then for this rule to be considered a
16333 match, at least one of the newsgroups from
16334 the Newsgroups line of the message must match this pattern.
16335 If this pattern is a list of patterns, then at least one of the
16336 newsgroups must match at least one of the patterns.
16337 (Any other non-blank parts of the Pattern must match, too.)
16338 <P>
16339 It is possible to add a <EM>NOT</EM> to the News Pattern meaning with the
16340 &quot;!&quot; &quot;toggle NOT&quot; command.
16341 This changes the meaning of the News pattern so that it has the opposite meaning.
16342 It will be considered a match if there are no matches between the
16343 addresses in the Newsgroups: line and the list of News patterns.
16344 <P>
16345 Don't make the mistake of putting the &quot;!&quot; in the data field for
16346 the pattern.
16347 For example, if you type the characters &quot;!frizzle&quot; into the News
16348 pattern, the pattern will look like:
16349 <P>
16350 <PRE>
16351  News pattern = !frizzle
16352 </PRE>
16353 <P>
16354 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
16355 In order to match messages that do not have &quot;frizzle&quot; in
16356 their Newsgroups header, first type the characters &quot;frizzle&quot; followed
16357 by carriage return for the value of the News pattern, then negate it
16358 by typing the &quot;!&quot; command.
16359 It should end up looking like
16360 <P>
16361 <PRE>
16362  ! News pattern = frizzle
16363 </PRE>
16364 <P>
16365 A technicality: Since comma is the character used to separate multiple
16366 values in a pattern field, you have to escape comma with a backslash (&#92;) if
16367 you want to include a literal comma in the field.
16368 In other words, if you type a backslash followed by a comma it will
16369 be interpreted as a comma by Alpine, instead of as a separator between
16370 pattern values.
16371 All other backslashes are literal backslashes and should not be escaped.
16372 <P>
16373
16374 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16375 for more information on Patterns.
16376 <P>
16377 Look <A HREF="h_edit_nav_cmds">here</A>
16378 to see the available Editing and Navigation commands.
16379 <P>
16380 &lt;End of help on this topic&gt;
16381 </BODY>
16382 </HTML>
16383 ======= h_config_role_subjpat =======
16384 <HTML>
16385 <HEAD>
16386 <TITLE>&quot;Subject:&quot; Pattern Explained</TITLE>
16387 </HEAD>
16388 <BODY>
16389 <H1>&quot;Subject:&quot; Pattern Explained</H1>
16390
16391 This is similar to the other parts of the Pattern.
16392 It is compared with
16393 the contents from the Subject of the message.
16394 <P>
16395 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16396 for more information on Patterns.
16397 <P>
16398 It is possible to add a <EM>NOT</EM> to the Subject Pattern meaning with the
16399 &quot;!&quot; &quot;toggle NOT&quot; command.
16400 This changes the meaning of the Subject pattern so that it has the opposite meaning.
16401 It will be considered a match if there are no matches between the
16402 text in the Subject: line and the list of Subject patterns.
16403 <P>
16404
16405 If you wish to have a header pattern that is not one of the six standard
16406 header patterns, you may add it with the &quot;eXtraHdr&quot; command.
16407 <P>
16408 A technicality: Since comma is the character used to separate multiple
16409 values in a pattern field, you have to escape comma with a backslash (&#92;) if
16410 you want to include a literal comma in the field.
16411 In other words, if you type a backslash followed by a comma it will
16412 be interpreted as a comma by Alpine, instead of as a separator between
16413 pattern values.
16414 All other backslashes are literal backslashes and should not be escaped.
16415 <P>
16416 Look <A HREF="h_edit_nav_cmds">here</A>
16417 to see the available Editing and Navigation commands.
16418 <P>
16419 &lt;End of help on this topic&gt;
16420 </BODY>
16421 </HTML>
16422 ======= h_config_role_alltextpat =======
16423 <HTML>
16424 <HEAD>
16425 <TITLE>AllText Pattern Explained</TITLE>
16426 </HEAD>
16427 <BODY>
16428 <H1>AllText Pattern Explained</H1>
16429
16430 This is similar to the header patterns.
16431 Instead of comparing with text in a particular header field it
16432 is compared with all of the text in the message header and body.
16433 <P>
16434 It is possible to add a <EM>NOT</EM> to the AllText Pattern meaning with the
16435 &quot;!&quot; &quot;toggle NOT&quot; command.
16436 This changes the meaning of the AllText pattern so that it has the opposite meaning.
16437 It will be considered a match if there are no matches between the
16438 text of the message and the list of AllText patterns.
16439 <P>
16440 Don't make the mistake of putting the &quot;!&quot; in the data field for
16441 the pattern.
16442 For example, if you type the characters &quot;!frizzle&quot; into the AllText
16443 pattern, the pattern will look like:
16444 <P>
16445 <PRE>
16446  AllText pattern = !frizzle
16447 </PRE>
16448 <P>
16449 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
16450 In order to match messages that do not have &quot;frizzle&quot; in
16451 the text of the message, first type the characters &quot;frizzle&quot; followed
16452 by carriage return for the value of the AllText pattern, then negate it
16453 by typing the &quot;!&quot; command.
16454 It should end up looking like
16455 <P>
16456 <PRE>
16457  ! AllText pattern = frizzle
16458 </PRE>
16459 <P>
16460 It is possible that you may notice degraded performance when using
16461 AllText Patterns.
16462 <P>
16463 A technicality: Since comma is the character used to separate multiple
16464 values in a pattern field, you have to escape comma with a backslash (&#92;) if
16465 you want to include a literal comma in the field.
16466 In other words, if you type a backslash followed by a comma it will
16467 be interpreted as a comma by Alpine, instead of as a separator between
16468 pattern values.
16469 All other backslashes are literal backslashes and should not be escaped.
16470 <P>
16471 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16472 for more information on Patterns.
16473 <P>
16474 Look <A HREF="h_edit_nav_cmds">here</A>
16475 to see the available Editing and Navigation commands.
16476 <P>
16477 &lt;End of help on this topic&gt;
16478 </BODY>
16479 </HTML>
16480 ======= h_config_role_bodytextpat =======
16481 <HTML>
16482 <HEAD>
16483 <TITLE>BodyText Pattern Explained</TITLE>
16484 </HEAD>
16485 <BODY>
16486 <H1>BodyText Pattern Explained</H1>
16487
16488 This is similar to the header patterns.
16489 Instead of comparing with text in a particular header field it
16490 is compared with all of the text in the message body.
16491 <P>
16492 It is possible to add a <EM>NOT</EM> to the BodyText Pattern meaning with the
16493 &quot;!&quot; &quot;toggle NOT&quot; command.
16494 This changes the meaning of the BodyText pattern so that it has the opposite meaning.
16495 It will be considered a match if there are no matches between the
16496 text of the body of the message and the list of BodyText patterns.
16497 <P>
16498 Don't make the mistake of putting the &quot;!&quot; in the data field for
16499 the pattern.
16500 For example, if you type the characters &quot;!frizzle&quot; into the BodyText
16501 pattern, the pattern will look like:
16502 <P>
16503 <PRE>
16504  BdyText pattern = !frizzle
16505 </PRE>
16506 <P>
16507 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
16508 In order to match messages that do not have &quot;frizzle&quot; in
16509 their BodyText, first type the characters &quot;frizzle&quot; followed
16510 by carriage return for the value of the BodyText pattern, then negate it
16511 by typing the &quot;!&quot; command.
16512 It should end up looking like
16513 <P>
16514 <PRE>
16515  ! BodyText pattern = frizzle
16516 </PRE>
16517 <P>
16518 It is possible that you may notice degraded performance when using
16519 BodyText Patterns.
16520 <P>
16521 A technicality: Since comma is the character used to separate multiple
16522 values in a pattern field, you have to escape comma with a backslash (&#92;) if
16523 you want to include a literal comma in the field.
16524 In other words, if you type a backslash followed by a comma it will
16525 be interpreted as a comma by Alpine, instead of as a separator between
16526 pattern values.
16527 All other backslashes are literal backslashes and should not be escaped.
16528 <P>
16529 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16530 for more information on Patterns.
16531 <P>
16532 Look <A HREF="h_edit_nav_cmds">here</A>
16533 to see the available Editing and Navigation commands.
16534 <P>
16535 &lt;End of help on this topic&gt;
16536 </BODY>
16537 </HTML>
16538 ======= h_config_role_charsetpat =======
16539 <HTML>
16540 <HEAD>
16541 <TITLE>Character Set Pattern Explained</TITLE>
16542 </HEAD>
16543 <BODY>
16544 <H1>Character Set Pattern Explained</H1>
16545
16546 A message may use one or more character sets.
16547 This part of the Pattern matches messages that make use of
16548 certain specified character sets.
16549 It will be considered a match if a message uses any of the character
16550 sets in the list you give here.
16551
16552 <P>
16553 When filling in a value for this field, you may use
16554 the &quot;T&quot; command, which presents you with a large list of
16555 possible character sets to choose from.
16556 You may also just type in the name of a character set, and it need not
16557 be one that Alpine knows about.
16558
16559 <P>
16560 Besides actual character set names (for example, ISO-8859-7, KOI8-R, or
16561 GB2312) you may also use some shorthand names that Alpine provides.
16562 These names are more understandable shorthand names for sets of
16563 character set names.
16564 Two examples are &quot;Cyrillic&quot; and &quot;Greek&quot;.
16565 Selecting one of these shorthand names is equivalent to selecting all of
16566 the character sets that make up the set.
16567 You can see all of these shorthand names and the lists of character sets
16568 they stand for by typing the &quot;T&quot; command.
16569
16570 <P>
16571 For the purposes of this Pattern,
16572 Alpine will search through a message for all of the text parts and
16573 collect the character sets declared for each part.
16574 It will also look in the Subject line for a character set used there.
16575 Alpine does not actually look at the text of the message or the text
16576 of the Subject to determine if a declared character set is actually
16577 used, it looks only at the declarations themselves in the MIME part headers
16578 and in the Subject.
16579
16580 <P>
16581 It is possible to add a <EM>NOT</EM> to the Character Set Pattern meaning with the
16582 &quot;!&quot; &quot;toggle NOT&quot; command.
16583 This changes the meaning of the Character Set pattern so that
16584 it has the opposite meaning.
16585 It will be considered a match if none of the character sets in the
16586 list are used in a message.
16587 <P>
16588 Don't make the mistake of putting the &quot;!&quot; in the data field for
16589 the pattern.
16590 For example, if you type the characters &quot;!GB2312&quot; into the
16591 Character Set pattern, the pattern will look like:
16592 <P>
16593 <PRE>
16594  Charset pattern = !GB2312
16595 </PRE>
16596 <P>
16597 This means you want to match the 7 character sequence &quot;!GB2312&quot;.
16598 In order to match messages that do not have the
16599 character set &quot;GB2312&quot;
16600 set, first type the characters &quot;GB2312&quot; followed
16601 by carriage return for the value of the Character Set pattern, then negate it
16602 by typing the &quot;!&quot; command.
16603 It should end up looking like
16604 <P>
16605 <PRE>
16606  ! Charset pattern = GB2312
16607 </PRE>
16608 <P>
16609 A technicality: Since comma is the character used to separate multiple
16610 values in a pattern field, you have to escape comma with a backslash (&#92;) if
16611 you want to include a literal comma in the field.
16612 In other words, if you type a backslash followed by a comma it will
16613 be interpreted as a comma by Alpine, instead of as a separator between
16614 pattern values.
16615 All other backslashes are literal backslashes and should not be escaped.
16616 <P>
16617 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16618 for more information on Patterns.
16619 <P>
16620 Look <A HREF="h_edit_nav_cmds">here</A>
16621 to see the available Editing and Navigation commands.
16622 <P>
16623 &lt;End of help on this topic&gt;
16624 </BODY>
16625 </HTML>
16626 ======= h_config_role_keywordpat =======
16627 <HTML>
16628 <HEAD>
16629 <TITLE>Keyword Pattern Explained</TITLE>
16630 </HEAD>
16631 <BODY>
16632 <H1>Keyword Pattern Explained</H1>
16633
16634 A folder may have user-defined keywords.
16635 These are similar to the Important flag, which the user may set using the
16636 Flag command.
16637 The difference is that the Important flag is always present for each folder.
16638 User-defined keywords are picked by the user.
16639 You may add new keywords by defining them in the
16640 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in the Setup/Config screen.
16641 After you have added a potential keyword with the <!--#echo var="VAR_keywords"--> option,
16642 the Flag command may be used to set or clear the keyword on individual messages.
16643 If you have given a keyword a nickname when configuring it,
16644 that nickname may be used instead of the actual keyword.
16645
16646 <P>
16647 When filling in a value for this field, it may be easiest to use
16648 the &quot;T&quot; command, which presents you with a list of the keywords
16649 you have defined to choose from.
16650
16651 <P>
16652 This part of the Pattern matches messages with certain keywords set.
16653 It will be considered a match if a message has any of the keywords in the
16654 list set.
16655 A keyword that you have not defined using the
16656 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in the Setup/Config screen
16657 will not be a match.
16658
16659 <P>
16660 It is possible to add a <EM>NOT</EM> to the Keyword Pattern meaning with the
16661 &quot;!&quot; &quot;toggle NOT&quot; command.
16662 This changes the meaning of the Keyword pattern so that it has the opposite meaning.
16663 It will be considered a match if none of the keywords in the list are set
16664 for a message.
16665 A keyword that you have not defined using the
16666 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in the Setup/Config screen
16667 will not be a match, so a <EM>NOT</EM> of that keyword does match.
16668 <P>
16669 Don't make the mistake of putting the &quot;!&quot; in the data field for
16670 the pattern.
16671 For example, if you type the characters &quot;!frizzle&quot; into the Keyword
16672 pattern, the pattern will look like:
16673 <P>
16674 <PRE>
16675  Keyword pattern = !frizzle
16676 </PRE>
16677 <P>
16678 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
16679 In order to match messages that do not have the keyword &quot;frizzle&quot;
16680 set, first type the characters &quot;frizzle&quot; followed
16681 by carriage return for the value of the Keyword pattern, then negate it
16682 by typing the &quot;!&quot; command.
16683 It should end up looking like
16684 <P>
16685 <PRE>
16686  ! Keyword pattern = frizzle
16687 </PRE>
16688 <P>
16689 A technicality: Since comma is the character used to separate multiple
16690 values in a pattern field, you have to escape comma with a backslash (&#92;) if
16691 you want to include a literal comma in the field.
16692 In other words, if you type a backslash followed by a comma it will
16693 be interpreted as a comma by Alpine, instead of as a separator between
16694 pattern values.
16695 All other backslashes are literal backslashes and should not be escaped.
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_arbpat =======
16707 <HTML>
16708 <HEAD>
16709 <TITLE>Extra Header Patterns Explained</TITLE>
16710 </HEAD>
16711 <BODY>
16712 <H1>Extra Header Patterns Explained</H1>
16713
16714 The header patterns that come after the Participant pattern but before the
16715 AllText pattern are extra header patterns that you have added to a rule's
16716 Pattern. These are just like the other header patterns except that
16717 the contents of the particular header listed on the left hand side will
16718 be used for comparisons.
16719 <P>
16720 The &quot;eXtraHdr&quot; command may be used to add more of these
16721 header patterns to the rule you are editing.
16722 <P>
16723 The &quot;RemoveHdr&quot; command may be used to delete the highlighted
16724 extra header pattern from the rule you are editing.
16725 <P>
16726 It is possible to add a <EM>NOT</EM> to the Extra Header Pattern meaning with the
16727 &quot;!&quot; &quot;toggle NOT&quot; command.
16728 This changes the meaning of the pattern so that it has the opposite meaning.
16729 It will be considered a match if there are no matches between the
16730 text in the header line and the list of patterns.
16731 <P>
16732 Don't make the mistake of putting the &quot;!&quot; in the data field for
16733 the pattern.
16734 For example, if you type the characters &quot;!frizzle&quot; into the
16735 pattern, the pattern will look like:
16736 <P>
16737 <PRE>
16738  Xyz pattern = !frizzle
16739 </PRE>
16740 <P>
16741 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
16742 In order to match messages that do not have &quot;frizzle&quot; in
16743 their Xyz field, first type the characters &quot;frizzle&quot; followed
16744 by carriage return for the value of the pattern, then negate it
16745 by typing the &quot;!&quot; command.
16746 It should end up looking like
16747 <P>
16748 <PRE>
16749  ! Xyz pattern = frizzle
16750 </PRE>
16751
16752 <P>
16753 A technicality: Since comma is the character used to separate multiple
16754 values in a pattern field, you have to escape comma with a backslash (&#92;) if
16755 you want to include a literal comma in the field.
16756 In other words, if you type a backslash followed by a comma it will
16757 be interpreted as a comma by Alpine, instead of as a separator between
16758 pattern values.
16759 All other backslashes are literal backslashes and should not be escaped.
16760 <P>
16761 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16762 for more information on Patterns.
16763 <P>
16764 Look <A HREF="h_edit_nav_cmds">here</A>
16765 to see the available Editing and Navigation commands.
16766 <P>
16767 &lt;End of help on this topic&gt;
16768 </BODY>
16769 </HTML>
16770 ======= h_config_role_cat_cmd =======
16771 <HTML>
16772 <HEAD>
16773 <TITLE>Categorizer Command Explained</TITLE>
16774 </HEAD>
16775 <BODY>
16776 <H1>Categorizer Command Explained</H1>
16777
16778 This is a command that is run with its standard input set to the message
16779 being checked and its standard output discarded.
16780 The full directory path should be specified.
16781 The command will be run and then its exit status will be checked against
16782 the Exit Status Interval, which defaults to just the value zero.
16783 If the exit status of the command falls in the interval, it is considered
16784 a match, otherwise it is not a match.
16785 <P>
16786
16787 This option may actually be a list of commands.
16788 The first one that exists and is executable is used.
16789 That makes it possible to use the same configuration with Unix Alpine and
16790 PC-Alpine.
16791 <P>
16792
16793 If none of the commands in the list exists and is executable then the rule
16794 is <EM>not</EM> a match.
16795 If it is possible that the command may not exist, you should be careful
16796 to structure your rules so that nothing destructive
16797 happens when the command does not exist.
16798 For example, you might have a filter that filters away spam when there is
16799 a match but does nothing when there is not a match.
16800 That would cause no harm if the command didn't exist.
16801 However, if you have a filter that filters away spam when there is not
16802 a match and keeps it when there is a match, that would filter everything
16803 if the categorizer command didn't exist.
16804 <P>
16805 Here is an <A HREF="h_config_role_cat_cmd_example">example</A>
16806 setup for the bogofilter filter.
16807
16808 <P>
16809 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16810 for more information on Patterns.
16811 <P>
16812 Look <A HREF="h_edit_nav_cmds">here</A>
16813 to see the available Editing and Navigation commands.
16814 <P>
16815 &lt;End of help on this topic&gt;
16816 </BODY>
16817 </HTML>
16818 ======= h_config_role_cat_cmd_example =======
16819 <HTML>
16820 <HEAD>
16821 <TITLE>Categorizer Command Example</TITLE>
16822 </HEAD>
16823 <BODY>
16824 <H1>Categorizer Command Example</H1>
16825
16826 Bogofilter
16827 (<A HREF="http://bogofilter.sourceforge.net/">http://bogofilter.sourceforge.net/</A>)
16828 is a mail filter that attempts to classify mail as spam or
16829 non-spam using statistical analysis of the message content.
16830 When run with no arguments and a message as standard input, it exits with
16831 exit status 0 if it thinks a message is spam and 1 if it thinks
16832 it is not spam.
16833 To use bogofilter as your Categorizer Command you would simply set Command to
16834 the pathname of the bogofilter program.
16835 For example,
16836 <P>
16837 <CENTER><SAMP>Command = /usr/local/bin/bogofilter</SAMP></CENTER>
16838 <P>
16839 Exit status of zero is what you are interested in, so you'd set the
16840 Exit Status Interval to
16841 <P>
16842 <CENTER><SAMP>Exit Status Interval = (0,0)</SAMP></CENTER>
16843 <P>
16844
16845 In order to prevent downloading an entire huge message to check for spam, you
16846 might want to set the Character Limit to a few thousand characters (the
16847 assumption being that the spam will reveal itself in those characters)
16848 <P>
16849 <CENTER><SAMP>Character Limit = 50000</SAMP></CENTER>
16850 <P>
16851
16852 You would probably use bogofilter in an Alpine Filter Rule, and have the action
16853 be to move the message to a spam folder.
16854 It would usually be wise to also check the &quot;Message is Recent&quot;
16855 part of the rule so that messages are only checked when they first arrive,
16856 and to restrict the Current Folder Type to just your INBOX.
16857 The reason for checking only Recent messages is to save the time it takes
16858 to run bogofilter on each message.
16859 As an experiment, you might start out by using this in an Indexcolor Rule
16860 instead of a Filter Rule.
16861 In that case, you probably wouldn't check the Recent checkbox.
16862 <P>
16863 The use described above assumes that you are somehow maintaining bogofilter's
16864 database of words associated with spam and non-spam messages.
16865 One way to start your database would be to select a bunch of spam messages
16866 in Alpine (you might Save spam messages to a special folder or use Alpine's
16867 Select command to select several) and then Apply
16868 (<A HREF="h_config_enable_agg_ops"><!--#echo var="FEAT_enable-aggregate-command-set"--></A>)
16869 a pipe command to the spam messages.
16870 For example, you could have a shell script or an alias
16871 called <EM>this_is_spam</EM>, which would simply be the command
16872 <P>
16873 <CENTER><SAMP>bogofilter -s</SAMP></CENTER>
16874 <P>
16875
16876 It is probably best to use the pipe command's Raw Text, With Delimiter,
16877 and Free Output options,
16878 which are at the bottom of the screen when you type the pipe command.
16879 That's because bogofilter expects the raw message as input, and uses
16880 the Delimiters to tell when a new message starts.
16881 You would not need to use a separate pipe for each message, because
16882 bogofilter can handle multiple messages at once.
16883 <P>
16884 Similarly, you would select a group of non-spam messages
16885 and run them through a <EM>this_is_nonspam</EM> script
16886 that was something like
16887 <P>
16888 <CENTER><SAMP>bogofilter -n</SAMP></CENTER>
16889 <P>
16890
16891 For the more adventurous, the next step might be to automate the upkeep of
16892 the bogofilter database.
16893 It might make more sense to have bogofilter be part of the delivery process,
16894 but it is also possible to do it entirely from within Alpine.
16895 Instead of using just plain &quot;bogofilter&quot; as the Categorizer Command,
16896 the &quot;-u&quot; argument will cause bogofilter to update the database.
16897 <P>
16898 <CENTER><SAMP>Command = /usr/local/bin/bogofilter -u</SAMP></CENTER>
16899 <P>
16900 You'd want a couple more aliases or shell scripts called something like
16901 <EM>change_to_spam</EM>
16902 <P>
16903 <CENTER><SAMP>bogofilter -Ns</SAMP></CENTER>
16904 <P>
16905 and
16906 <EM>change_to_nonspam</EM>
16907 <P>
16908 <CENTER><SAMP>bogofilter -Sn</SAMP></CENTER>
16909 <P>
16910 When you run across a message in your INBOX that should have been
16911 classified as spam you would pipe it to the change_to_spam script, and
16912 when you run across a message in your spam folder that should have been
16913 left in your INBOX you would pipe it through change_to_nonspam.
16914
16915 <P>
16916 There is a technical problem with this approach.
16917 Alpine may check your filters more than once.
16918 In particular, every time you start Alpine the filters will be checked for
16919 each message.
16920 Also, if you have any filters that depend on message state (New, Deleted, etc.)
16921 then Alpine will recheck for matches in messages that have changed state
16922 at the time you close the folder and before expunging.
16923 This is usually ok.
16924 However, in this case it is a problem because the command
16925 <P>
16926 <CENTER><SAMP>Command = /usr/local/bin/bogofilter -u</SAMP></CENTER>
16927 <P>
16928 has the side effect of updating the database.
16929 So you run the risk of updating the database multiple times for a single
16930 message instead of updating it just once per message.
16931 There are some ways to work around this problem.
16932 What you need is a way to mark the message after you have run the filter.
16933 One way to mark messages is with the use of a keyword (say &quot;Bogo&quot;).
16934 Besides having the filter move the message to a spam folder, also have it
16935 set the Bogo keyword.
16936 (Note that you will have to set up the &quot;Bogo&quot; keyword in the
16937 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in Setup/Config.)
16938 This rule can only set the Bogo keyword for the messages that it matches.
16939 You will also need to add a second rule right after this one that
16940 matches all the messages that don't have the Bogo keyword set
16941 (put the keyword in the Keyword pattern and toggle
16942 the Not with the ! command)
16943 and takes the action of setting it.
16944 Then change the &quot;bogofilter -u&quot; rule so that it won't be a match
16945 (and so it won't re-run the bogofilter command) if the keyword is already
16946 set.
16947 <P>
16948 What you will end up with is a rule that runs &quot;bogofilter -u&quot;
16949 on all messages that don't have the Bogo keyword set.
16950 This will have the side effect of inserting that message in the bogofilter
16951 database, match or not.
16952 If this rule matches (it is spam), the Bogo keyword will be set and
16953 the message will be moved to a spam folder.
16954 If it does not match, the
16955 following rule will mark the message by turning on the keyword.
16956 This second rule should be a non-terminating
16957 (<A HREF="h_config_filt_opts_nonterm">Dont-Stop-Even-if-Rule-Matches</A>)
16958 rule so that it doesn't stop the filtering process before the rest of
16959 your rules are consulted.
16960
16961 <P>
16962 In summary, the first rule is something like
16963 <PRE>
16964   Nickname          = bogofilter -u rule
16965   Current Folder Type =
16966                (*) Specific
16967                    Folder = INBOX
16968
16969   ! Keyword pattern = Bogo
16970
16971   External Categorizer Commands =
16972        Command              = /usr/local/bin/bogofilter -u
16973        Exit Status Interval = (0,0)
16974        Character Limit      = <No Value Set: using "-1">  (optionally set this)
16975
16976   Filter Action =
16977        (*) Move
16978            Folder = spam
16979
16980   Set These Keywords   = Bogo
16981 </PRE>
16982 <P>
16983 and the following rule is
16984 <PRE>
16985   Nickname          = Set Bogo Keyword
16986   Current Folder Type =
16987                (*) Specific
16988                    Folder = INBOX
16989
16990   ! Keyword pattern = Bogo
16991
16992   Filter Action =
16993        (*) Just Set Message Status
16994
16995   Set These Keywords   = Bogo
16996
16997   Features =
16998       [X]  dont-stop-even-if-rule-matches
16999 </PRE>
17000 <P>
17001 If it is possible for you to insert bogofilter in the delivery process instead
17002 of having it called from Alpine you could prevent having to wait
17003 for the bogofilter processing while you read your mail.
17004 You would have bogofilter add a header to the message at the time of delivery
17005 that identified it as spam or nonspam.
17006 With this method, you could avoid using a Categorizer Command while running Alpine,
17007 and just match on the header instead.
17008 You might still want to use the scripts mentioned above to initialize the
17009 database or to re-classify wrongly classified messages.
17010
17011 <P>
17012 Finally, it isn't for the faint-hearted,
17013 but it is also possible to run bogofilter from PC-Alpine.
17014 You can install Cygwin from
17015 <A HREF="http://www.cygwin.com/">http://www.cygwin.com/</A> and
17016 then compile bogofilter in the cygwin environment, and run it from
17017 within PC-Alpine.
17018 You would end up with a Categorizer command that looked something like
17019 <P>
17020 <CENTER><SAMP>Command = C:&#92;cygwin&#92;bin&#92;bogofilter.exe -u</SAMP></CENTER>
17021 <P>
17022 Note that the &quot;.exe&quot; extension is explicit,
17023 and that the bogofilter.exe executable should be in the same directory
17024 as cygwin1.dll.
17025
17026 <P>
17027 &lt;End of help on this topic&gt;
17028 </BODY>
17029 </HTML>
17030 ======= h_config_role_cat_status =======
17031 <HTML>
17032 <HEAD>
17033 <TITLE>Exit Status Interval Explained</TITLE>
17034 </HEAD>
17035 <BODY>
17036 <H1>Exit Status Interval Explained</H1>
17037
17038 The categorizer command is run and the result is the exit status of
17039 that command.
17040 If that exit status falls in the Exit Status Interval
17041 then it is considered a match, otherwise it is not a match.
17042 Of course for the entire rule to match, it must also be checked against
17043 the other defined parts of the Pattern.
17044 <P>
17045 The Exit Status Interval defaults to the single value 0 (zero).
17046 If you define it, it should be set to something like:
17047 <P>
17048 <CENTER><SAMP>(min_exit_value,max_exit_value)</SAMP></CENTER>
17049 <P>
17050 where &quot;min_exit_value&quot; and &quot;max_exit_value&quot; are integers.
17051 The special values &quot;INF&quot; and &quot;-INF&quot; may be used for large
17052 positive and negative integers.
17053 <P>
17054 Actually, a list of intervals may be used if you wish.
17055 A list would look like
17056 <P>
17057 <CENTER><SAMP>(min_exit_value1,max_exit_value1),(min_exit_value2,max_exit_value2),...</SAMP></CENTER>
17058 <P>
17059 When there is an Exit Status Interval defined, it is a match if the exit status
17060 of the categorizer command is contained in any of the intervals.
17061 The intervals include both endpoints.
17062 <P>
17063 The default interval is
17064 <P>
17065 <CENTER><SAMP>(0,0)</SAMP></CENTER>
17066 <P>
17067 and it matches only if the command exits with exit status equal to zero.
17068
17069 <P>
17070 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17071 for more information on Patterns.
17072 <P>
17073 Look <A HREF="h_edit_nav_cmds">here</A>
17074 to see the available Editing and Navigation commands.
17075 <P>
17076 &lt;End of help on this topic&gt;
17077 </BODY>
17078 </HTML>
17079 ======= h_config_role_cat_limit =======
17080 <HTML>
17081 <HEAD>
17082 <TITLE>Character Limit Explained</TITLE>
17083 </HEAD>
17084 <BODY>
17085 <H1>Character Limit Explained</H1>
17086
17087 Setting this option makes it possible to limit how much of the message
17088 is made available to the categorizer command as input.
17089 The default value (-1) means that the entire message is fed to the
17090 command.
17091 A value of 0 (zero) means that only the headers of the message are
17092 made available.
17093 A positive integer means that the headers plus that many characters from
17094 the body of the message are passed to the categorizer.
17095
17096 <P>
17097 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17098 for more information on Patterns.
17099 <P>
17100 Look <A HREF="h_edit_nav_cmds">here</A>
17101 to see the available Editing and Navigation commands.
17102 <P>
17103 &lt;End of help on this topic&gt;
17104 </BODY>
17105 </HTML>
17106 ======= h_config_role_age =======
17107 <HTML>
17108 <HEAD>
17109 <TITLE>Age Interval Explained</TITLE>
17110 </HEAD>
17111 <BODY>
17112 <H1>Age Interval Explained</H1>
17113
17114 The Age Interval, if defined, is part of the Pattern.
17115 If you use this, it should be set to something like:
17116 <P>
17117 <CENTER><SAMP>(min_age,max_age)</SAMP></CENTER>
17118 <P>
17119 where &quot;min_age&quot; and &quot;max_age&quot; are non-negative integers.
17120 The special value &quot;INF&quot; may be used for the max value.
17121 It represents infinity.
17122 <P>
17123 In rare cases it may be useful to use the more general form of the value,
17124 which is a comma-separated list of intervals.
17125 It would look something like:
17126 <P>
17127 <CENTER><SAMP>(min_age1,max_age1),(min_age2,max_age2),...</SAMP></CENTER>
17128 <P>
17129 When there is an Age Interval defined, it is a match if the age, in days, of
17130 the message is contained in the interval.
17131 The interval includes both endpoints.
17132 If the option is set to a list of intervals then it is a match if the
17133 age of the message is contained in any of the intervals.
17134 <P>
17135 Even though this option is called Age, it isn't actually
17136 the <EM>age</EM> of the message.
17137 Instead, it is how many days ago the message arrived in one of your folders.
17138 If the current time is a little past midnight, then a message that arrived
17139 just before midnight arrived yesterday, even though the message is only
17140 a few minutes old.
17141 By default, the date being used is not the date in the Date
17142 header of the message.
17143 It is the date that the message arrived in one of your folders.
17144 When you Save a message from one folder to another that arrival date
17145 is preserved.
17146 If you would like to use the date in the Date header that is possible.
17147 Turn on the option
17148 <A HREF="h_config_filt_opts_sentdate">&quot;Use-Date-Header-For-Age&quot;</A>
17149 near the bottom of the rule definition.
17150 <P>
17151 A value of 0 is today, 1 is yesterday, 2 is the day before yesterday, and so on.
17152 The age interval
17153 <P>
17154 <CENTER><SAMP>(2,2)</SAMP></CENTER>
17155 <P>
17156 matches all messages that arrived on the day before yesterday.
17157 The interval
17158 <P>
17159 <CENTER><SAMP>(180,INF)</SAMP></CENTER>
17160 <P>
17161 matches all messages that arrived at least 180 days before today.
17162 The interval
17163 <P>
17164 <CENTER><SAMP>(0,1)</SAMP></CENTER>
17165 <P>
17166 matches all messages that arrived today or yesterday.
17167
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_size =======
17179 <HTML>
17180 <HEAD>
17181 <TITLE>Size Interval Explained</TITLE>
17182 </HEAD>
17183 <BODY>
17184 <H1>Size Interval Explained</H1>
17185
17186 The Size Interval, if defined, is part of the Pattern.
17187 If you use this, it should be set to something like:
17188 <P>
17189 <CENTER><SAMP>(min_size,max_size)</SAMP></CENTER>
17190 <P>
17191 where &quot;min_size&quot; and &quot;max_size&quot; are non-negative integers.
17192 The special value &quot;INF&quot; may be used for the max value.
17193 It represents infinity.
17194 <P>
17195 In rare cases it may be useful to use the more general form of the value,
17196 which is a comma-separated list of intervals.
17197 It would look something like:
17198 <P>
17199 <CENTER><SAMP>(min_size1,max_size1),(min_size2,max_size2),...</SAMP></CENTER>
17200 <P>
17201 When there is a Size Interval defined, it is a match if the size of
17202 the message is contained in the interval.
17203 The interval includes both endpoints.
17204 If the option is set to a list of intervals then it is a match if the
17205 size of the message is contained in any of the intervals.
17206 <P>
17207 The size interval
17208 <P>
17209 <CENTER><SAMP>(10000,50000)</SAMP></CENTER>
17210 <P>
17211 matches all messages with sizes greater than or equal to 10000, and less
17212 than or equal to 50000.
17213 The interval
17214 <P>
17215 <CENTER><SAMP>(100000,INF)</SAMP></CENTER>
17216 <P>
17217 matches all messages with sizes greater than or equal to 100000.
17218
17219 <P>
17220 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17221 for more information on Patterns.
17222 <P>
17223 Look <A HREF="h_edit_nav_cmds">here</A>
17224 to see the available Editing and Navigation commands.
17225 <P>
17226 &lt;End of help on this topic&gt;
17227 </BODY>
17228 </HTML>
17229 ======= h_config_role_scorei =======
17230 <HTML>
17231 <HEAD>
17232 <TITLE>Score Interval Explained</TITLE>
17233 </HEAD>
17234 <BODY>
17235 <H1>Score Interval Explained</H1>
17236
17237 The Score Interval, if defined, is part of the Pattern.
17238 If you use this, it should be set to something like:
17239 <P>
17240 <CENTER><SAMP>(min_score,max_score)</SAMP></CENTER>
17241 <P>
17242 where &quot;min_score&quot; and &quot;max_score&quot; are integers between
17243 -32000 and 32000.
17244 The special values &quot;-INF&quot; and &quot;INF&quot; may be used for
17245 the min and max values.
17246 These represent negative and positive infinity.
17247 <P>
17248 Actually, the value may be a list of intervals rather than just a
17249 single interval if that is useful.
17250 The elements of the list are separated by commas like:
17251 <P>
17252 <CENTER><SAMP>(min_score1,max_score1),(min_score2,max_score2),...</SAMP></CENTER>
17253 <P>
17254 When there is a Score Interval defined, it is a match if the score for
17255 the message is contained in any of the intervals.
17256 The intervals include both endpoints.
17257 The score for a message is calculated by looking at every scoring rule
17258 defined and adding up the Score Values for the rules that match the message.
17259 Scoring rules are created using the
17260 <A HREF="h_rules_score">&quot;SETUP SCORING&quot;</A> screen.
17261
17262 <P>
17263 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17264 for more information on Patterns.
17265 <P>
17266 Look <A HREF="h_edit_nav_cmds">here</A>
17267 to see the available Editing and Navigation commands.
17268 <P>
17269 &lt;End of help on this topic&gt;
17270 </BODY>
17271 </HTML>
17272 ======= h_config_role_fldr_type =======
17273 <HTML>
17274 <HEAD>
17275 <TITLE>Current Folder Type Explained</TITLE>
17276 </HEAD>
17277 <BODY>
17278 <H1>Current Folder Type Explained</H1>
17279
17280 The Current Folder Type is part of the role's Pattern.
17281 It refers to the type of the currently open folder, which is the folder
17282 you were last looking at from the MESSAGE INDEX or MESSAGE TEXT screen.
17283 In order for a role to be considered a match, the current folder must
17284 be of the type you set here.
17285 The three types &quot;Any&quot;, &quot;News&quot;, and &quot;Email&quot; are
17286 all what you might think.
17287 <P>
17288 If the Current Folder Type for a role's Pattern is set to &quot;News&quot;, for
17289 example, then
17290 that role will only be a match if the current folder is a newsgroup and
17291 the rest of the Pattern matches.
17292 The value &quot;Specific&quot; may be used when you want to limit the match
17293 to a specific folder (not just a specific type of folder), or to a list of
17294 specific folders.
17295 <P>
17296 In order to match a specific folder you Select the &quot;Specific&quot;
17297 button <EM>AND</EM> fill in
17298 the name (or list of names) of
17299 the folder in the &quot;Folder List&quot; field.
17300 If the current folder is any of the folders in the list, that is considered
17301 a match.
17302 The name of each folder in the list may be either &quot;INBOX&quot;,
17303 the technical specification
17304 of the folder (like what appears in your configuration file) or, if the
17305 folder is one of your incoming folders, it may be the nickname you've given
17306 the folder.
17307 Here are a couple samples of specific folder names:
17308 <P>
17309 <CENTER><SAMP>{monet.art.example.com}mail/art-class</SAMP></CENTER>
17310 <P>
17311 <CENTER><SAMP>{news.example.com/nntp}#news.comp.mail.pine</SAMP></CENTER>
17312 <P>
17313 The easiest way to fill in the &quot;Folder List&quot; field is to use
17314 the &quot;T&quot; command that is available when the &quot;Folder List&quot; line is
17315 highlighted, or to use the &quot;Take&quot; command with the configuration
17316 feature
17317 <A HREF="h_config_enable_role_take">&quot;<!--#echo var="FEAT_enable-rules-under-take"-->&quot;</A>
17318 turned on.
17319 Note that you won't be able to edit the &quot;Folder List&quot; line unless the
17320 Current Folder Type is set to &quot;Specific&quot;, and any value that
17321 &quot;Folder List&quot; has is ignored unless the type
17322 is set to &quot;Specific&quot;.
17323 <P>
17324 When reading a newsgroup, there may be a performance penalty
17325 incurred when collecting the information necessary to check a Pattern.
17326 For this reason, the default Current Folder Type is set to &quot;Email&quot;.
17327 <P>
17328 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17329 for more information on Patterns.
17330 <P>
17331 Look <A HREF="h_edit_nav_cmds">here</A>
17332 to see the available Editing and Navigation commands.
17333 <P>
17334 &lt;End of help on this topic&gt;
17335 </BODY>
17336 </HTML>
17337 ======= h_config_filt_rule_type =======
17338 <HTML>
17339 <HEAD>
17340 <TITLE>Filter Action Explained</TITLE>
17341 </HEAD>
17342 <BODY>
17343 <H1>Filter Action Explained</H1>
17344
17345 The Filter Action specifies the action to be taken when the Pattern is a
17346 match.
17347 It may be set to &quot;Delete&quot; &quot;Move&quot;, or
17348 &quot;Just Set Message Status&quot;.
17349 <P>
17350 If it is set to &quot;Delete&quot;, then the message that matches the
17351 Pattern will be deleted from the open folder.
17352 <P>
17353 If it is set to &quot;Move&quot;, then the name of the folder to which
17354 the matching message should be moved is given in the &quot;Folder List&quot; field on the
17355 next line of the screen.
17356 A list of folders separated by commas may be given, in which case the
17357 message will be copied to all of the folders in the list before it is
17358 deleted.
17359 <P>
17360 If it is set to neither of those two values (it is set to the value
17361 labeled &quot;Just Set Message Status&quot;) then the message status
17362 setting will happen
17363 but the message will not be deleted or moved.
17364 <P>
17365 If you are Moving a message you may also set Message Status if you wish.
17366 <P>
17367 The easiest way to fill in the &quot;Folder List&quot; field is to use
17368 the T command that is available when the &quot;Folder List&quot; line is
17369 highlighted.
17370 Note that you won't be able to edit the &quot;Folder List&quot; line unless the
17371 Filter Action is set to &quot;Move&quot;, and any value that
17372 &quot;Folder List&quot; has is ignored unless the type
17373 is set to &quot;Move&quot;.
17374 <P>
17375 There are a few tokens that may be used in the names in the Folder List.
17376 They are all related to the date on which the filtering is taking place.
17377 The tokens are words surrounded by underscores.
17378 For example, if you want your filter to move messages to a folder named
17379 <P><CENTER><SAMP>abc-year-mon</SAMP></CENTER><P>
17380 you could specify the folder as
17381 <P><CENTER><SAMP>abc-_CURYEAR_-_CURMONTHABBREV_</SAMP></CENTER><P>
17382 which would result in a file named something like
17383 <P><CENTER><SAMP>abc-2004-oct</SAMP></CENTER><P>
17384 or
17385 <P><CENTER><SAMP>abc-_CURYEAR2DIGIT_-_CURMONTH2DIGIT_</SAMP></CENTER><P>
17386 which would result in a file named something like
17387 <P><CENTER><SAMP>abc-04-10</SAMP></CENTER><P>
17388 The available tokens are listed
17389 <A HREF="h_index_tokens">here</A>.
17390 <P>
17391 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17392 for more information on Patterns.
17393 <P>
17394 Look <A HREF="h_edit_nav_cmds">here</A>
17395 to see the available Editing and Navigation commands.
17396 <P>
17397 &lt;End of help on this topic&gt;
17398 </BODY>
17399 </HTML>
17400 ======= h_config_score_fldr_type =======
17401 <HTML>
17402 <HEAD>
17403 <TITLE>Current Folder Type Explained</TITLE>
17404 </HEAD>
17405 <BODY>
17406 <H1>Current Folder Type Explained</H1>
17407
17408 The Current Folder Type is part of the scoring rule's Pattern.
17409 It refers to the type of the folder that
17410 the message being scored is in.
17411 In order for a rule to be considered a match, the current folder must
17412 be of the type you set here.
17413 The three types &quot;Any&quot;, &quot;News&quot;, and &quot;Email&quot; are
17414 all what you might think.
17415 <P>
17416 If the Current Folder Type for a Pattern is set to &quot;News&quot;, for
17417 example, then
17418 that Pattern will only match if the current folder is a newsgroup and
17419 the rest of the Pattern matches.
17420 The value &quot;Specific&quot; may be used when you want to limit the match
17421 to a specific folder (not just a specific type of folder), or to a list of
17422 specific folders.
17423 <P>
17424 In order to match a specific folder you Select the &quot;Specific&quot;
17425 button <EM>AND</EM> fill in
17426 the name (or list of names) of
17427 the folder in the &quot;Folder List&quot; field.
17428 If the current folder is any of the folders in the list, that is considered
17429 a match.
17430 The name of each folder in the list may be either &quot;INBOX&quot;, the technical specification
17431 of the folder (like what appears in your configuration file) or, if the
17432 folder is one of your incoming folders, it may be the nickname you've given
17433 the folder.
17434 Here are a couple samples of specific folder names:
17435 <P>
17436 <CENTER><SAMP>{monet.art.example.com}mail/art-class</SAMP></CENTER>
17437 <P>
17438 <CENTER><SAMP>{news.example.com/nntp}#news.comp.mail.pine</SAMP></CENTER>
17439 <P>
17440 The easiest way to fill in the &quot;Folder List&quot; field is to use
17441 the T command that is available when the &quot;Folder List&quot; line is
17442 highlighted.
17443 Note that you won't be able to edit the &quot;Folder List&quot; line unless the
17444 Current Folder Type is set to &quot;Specific&quot;, and any value that
17445 &quot;Folder List&quot; has is ignored unless the type
17446 is set to &quot;Specific&quot;.
17447 <P>
17448 When reading a newsgroup, there may be a performance penalty
17449 incurred when collecting the information necessary to check a Pattern.
17450 For this reason, the default Current Folder Type is set to &quot;Email&quot;.
17451 For example, if you have Index Line Coloring rules that have Score Intervals
17452 defined then the scores for all the visible messages will need to be calculated.
17453 If some of your Scoring rules have
17454 a Current Folder Type of
17455 &quot;Any&quot; or &quot;News&quot; this may cause the MESSAGE INDEX
17456 screen to draw more slowly when in a newsgroup.
17457 <P>
17458 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17459 for more information on Patterns.
17460 <P>
17461 Look <A HREF="h_edit_nav_cmds">here</A>
17462 to see the available Editing and Navigation commands.
17463 <P>
17464 &lt;End of help on this topic&gt;
17465 </BODY>
17466 </HTML>
17467 ======= h_config_other_fldr_type =======
17468 <HTML>
17469 <HEAD>
17470 <TITLE>Current Folder Type Explained</TITLE>
17471 </HEAD>
17472 <BODY>
17473 <H1>Current Folder Type Explained</H1>
17474
17475 The Current Folder Type is part of the rule's Pattern.
17476 It refers to the type of the folder being viewed.
17477 In order for a rule to be considered a match, the current folder must
17478 be of the type you set here.
17479 The three types &quot;Any&quot;, &quot;News&quot;, and &quot;Email&quot; are
17480 all what you might think.
17481 <P>
17482 If the Current Folder Type for a Pattern is set to &quot;News&quot;, for
17483 example, then
17484 that Pattern will only match if the current folder is a newsgroup.
17485 The value &quot;Specific&quot; may be used when you want to limit the match
17486 to a specific folder (not just a specific type of folder), or to a list of
17487 specific folders.
17488 <P>
17489 In order to match a specific folder you Select the &quot;Specific&quot;
17490 button <EM>AND</EM> fill in
17491 the name (or list of names) of
17492 the folder in the &quot;Folder List&quot; field.
17493 If the current folder is any of the folders in the list, that is considered
17494 a match.
17495 The name of each folder in the list may be either &quot;INBOX&quot;, the technical specification
17496 of the folder (like what appears in your configuration file) or, if the
17497 folder is one of your incoming folders, it may be the nickname you've given
17498 the folder.
17499 Here are a couple samples of specific folder names:
17500 <P>
17501 <CENTER><SAMP>{monet.art.example.com}mail/art-class</SAMP></CENTER>
17502 <P>
17503 <CENTER><SAMP>{news.example.com/nntp}#news.comp.mail.pine</SAMP></CENTER>
17504 <P>
17505 The easiest way to fill in the &quot;Folder List&quot; field is to use
17506 the T command that is available when the &quot;Folder List&quot; line is
17507 highlighted.
17508 Note that you won't be able to edit the &quot;Folder List&quot; line unless the
17509 Current Folder Type is set to &quot;Specific&quot;, and any value that
17510 &quot;Folder List&quot; has is ignored unless the type
17511 is set to &quot;Specific&quot;.
17512 <P>
17513 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17514 for more information on Patterns.
17515 <P>
17516 Look <A HREF="h_edit_nav_cmds">here</A>
17517 to see the available Editing and Navigation commands.
17518 <P>
17519 &lt;End of help on this topic&gt;
17520 </BODY>
17521 </HTML>
17522 ======= h_config_incol_fldr_type =======
17523 <HTML>
17524 <HEAD>
17525 <TITLE>Current Folder Type Explained</TITLE>
17526 </HEAD>
17527 <BODY>
17528 <H1>Current Folder Type Explained</H1>
17529
17530 The Current Folder Type is part of the Line Coloring rule's Pattern.
17531 It refers to the type of the folder for which the MESSAGE INDEX is
17532 being viewed.
17533 In order for a rule to be considered a match, the current folder must
17534 be of the type you set here.
17535 The three types &quot;Any&quot;, &quot;News&quot;, and &quot;Email&quot; are
17536 all what you might think.
17537 <P>
17538 If the Current Folder Type for a Pattern is set to &quot;News&quot;, for
17539 example, then
17540 that Pattern will only match if the current folder is a newsgroup and
17541 the rest of the Pattern matches.
17542 The value &quot;Specific&quot; may be used when you want to limit the match
17543 to a specific folder (not just a specific type of folder), or to a list of
17544 specific folders.
17545 <P>
17546 In order to match a specific folder you Select the &quot;Specific&quot;
17547 button <EM>AND</EM> fill in
17548 the name (or list of names) of
17549 the folder in the &quot;Folder List&quot; field.
17550 If the current folder is any of the folders in the list, that is considered
17551 a match.
17552 The name of each folder in the list may be either &quot;INBOX&quot;, the technical specification
17553 of the folder (like what appears in your configuration file) or, if the
17554 folder is one of your incoming folders, it may be the nickname you've given
17555 the folder.
17556 Here are a couple samples of specific folder names:
17557 <P>
17558 <CENTER><SAMP>{monet.art.example.com}mail/art-class</SAMP></CENTER>
17559 <P>
17560 <CENTER><SAMP>{news.example.com/nntp}#news.comp.mail.pine</SAMP></CENTER>
17561 <P>
17562 The easiest way to fill in the &quot;Folder List&quot; field is to use
17563 the T command that is available when the &quot;Folder List&quot; line is
17564 highlighted.
17565 Note that you won't be able to edit the &quot;Folder List&quot; line unless the
17566 Current Folder Type is set to &quot;Specific&quot;, and any value that
17567 &quot;Folder List&quot; has is ignored unless the type
17568 is set to &quot;Specific&quot;.
17569 <P>
17570 When reading a newsgroup, there may be a performance penalty
17571 incurred when collecting the information necessary to check a Pattern.
17572 For this reason, the default Current Folder Type is set to &quot;Email&quot;.
17573 For example, a rule with a non-Normal Index Line Color
17574 and a Current Folder Type of
17575 &quot;Any&quot; or &quot;News&quot; may cause the MESSAGE INDEX
17576 screen to draw more slowly when in a newsgroup.
17577 <P>
17578 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17579 for more information on Patterns.
17580 <P>
17581 Look <A HREF="h_edit_nav_cmds">here</A>
17582 to see the available Editing and Navigation commands.
17583 <P>
17584 &lt;End of help on this topic&gt;
17585 </BODY>
17586 </HTML>
17587 ======= h_config_filt_fldr_type =======
17588 <HTML>
17589 <HEAD>
17590 <TITLE>Current Folder Type Explained</TITLE>
17591 </HEAD>
17592 <BODY>
17593 <H1>Current Folder Type Explained</H1>
17594
17595 The Current Folder Type is part of the Filtering rule's Pattern.
17596 It refers to the type of the folder for which the filtering is being done.
17597 In order for a rule to be considered a match, the current folder must
17598 be of the type you set here.
17599 The three types &quot;Any&quot;, &quot;News&quot;, and &quot;Email&quot; are
17600 all what you might think.
17601 <P>
17602 If the Current Folder Type for a Pattern is set to &quot;News&quot;, for
17603 example, then
17604 that Pattern will only match if the current folder is a newsgroup and
17605 the rest of the Pattern matches.
17606 The value &quot;Specific&quot; may be used when you want to limit the match
17607 to a specific folder (not just a specific type of folder), or to a list of
17608 specific folders.
17609 <P>
17610 In order to match a specific folder you Select the &quot;Specific&quot;
17611 button <EM>AND</EM> fill in
17612 the name (or list of names) of
17613 the folder in the &quot;Folder List&quot; field.
17614 If the current folder is any of the folders in the list, that is considered
17615 a match.
17616 The name of each folder in the list may be either &quot;INBOX&quot;, the technical specification
17617 of the folder (like what appears in your configuration file) or, if the
17618 folder is one of your incoming folders, it may be the nickname you've given
17619 the folder.
17620 Here are a couple samples of specific folder names:
17621 <P>
17622 <CENTER><SAMP>{monet.art.example.com}mail/art-class</SAMP></CENTER>
17623 <P>
17624 <CENTER><SAMP>{news.example.com/nntp}#news.comp.mail.pine</SAMP></CENTER>
17625 <P>
17626 The easiest way to fill in the &quot;Folder List&quot; field is to use
17627 the T command that is available when the &quot;Folder List&quot; line is
17628 highlighted.
17629 Note that you won't be able to edit the &quot;Folder List&quot; line unless the
17630 Current Folder Type is set to &quot;Specific&quot;, and any value that
17631 &quot;Folder List&quot; has is ignored unless the type
17632 is set to &quot;Specific&quot;.
17633 <P>
17634 When reading a newsgroup, there may be a performance penalty
17635 incurred when collecting the information necessary to check a Pattern.
17636 For this reason, the default Current Folder Type is set to &quot;Email&quot;.
17637 For example, a rule with a Current Folder Type of either
17638 &quot;Any&quot; or &quot;News&quot; may cause the filtering to happen
17639 more slowly when opening a newsgroup.
17640 <P>
17641 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17642 for more information on Patterns.
17643 <P>
17644 Look <A HREF="h_edit_nav_cmds">here</A>
17645 to see the available Editing and Navigation commands.
17646 <P>
17647 &lt;End of help on this topic&gt;
17648 </BODY>
17649 </HTML>
17650 ======= h_config_role_stat_imp =======
17651 <HTML>
17652 <HEAD>
17653 <TITLE>Message Important Status Explained</TITLE>
17654 </HEAD>
17655 <BODY>
17656 <H1>Message Important Status Explained</H1>
17657
17658 This part of the Pattern may have one of three possible values.
17659 The default value is &quot;Don't care&quot;, which matches any message.
17660 The other two values are &quot;Yes&quot;, which means the message must be
17661 flagged &quot;Important&quot; in order to be a match; or &quot;No&quot;, which
17662 means the message must <EM>not</EM> be flagged &quot;Important&quot; in order
17663 to be a match.
17664 <P>
17665 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17666 for more information on Patterns.
17667 <P>
17668 Look <A HREF="h_edit_nav_cmds">here</A>
17669 to see the available Editing and Navigation commands.
17670 <P>
17671 &lt;End of help on this topic&gt;
17672 </BODY>
17673 </HTML>
17674 ======= h_config_role_stat_new =======
17675 <HTML>
17676 <HEAD>
17677 <TITLE>Message New Status Explained</TITLE>
17678 </HEAD>
17679 <BODY>
17680 <H1>Message New Status Explained</H1>
17681
17682 This part of the Pattern may have one of three possible values.
17683 The default value is &quot;Don't care&quot;, which matches any message.
17684 The other two values are &quot;Yes&quot;, which means the message must be
17685 &quot;New&quot; in order to be a match; or &quot;No&quot;, which
17686 means the message must <EM>not</EM> be &quot;New&quot; in order
17687 to be a match.
17688 &quot;New&quot; is the same as <EM>Unseen</EM> and not &quot;New&quot; is the
17689 same as <EM>Seen</EM>.
17690 <P>
17691 The nomenclature for New and Recent is a bit confusing:
17692 <P>
17693 New means that the message is Unseen.
17694 It could have been in your mailbox for a long time but if you haven't looked
17695 at it, it is still considered New.
17696 That matches the default Alpine index display that shows an N for such a
17697 message.
17698 <P>
17699 Recent means that the message was added to this folder since the last time
17700 you opened the folder.
17701 Alpine also shows an N by default for these types of messages.
17702 If you were to run two copies of Alpine that opened a folder one right after
17703 the other, a message would only show up as Recent in (at most) the first
17704 Alpine session.
17705 <P>
17706 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17707 for more information on Patterns.
17708 <P>
17709 Look <A HREF="h_edit_nav_cmds">here</A>
17710 to see the available Editing and Navigation commands.
17711 <P>
17712 &lt;End of help on this topic&gt;
17713 </BODY>
17714 </HTML>
17715 ======= h_config_role_stat_recent =======
17716 <HTML>
17717 <HEAD>
17718 <TITLE>Message Recent Status Explained</TITLE>
17719 </HEAD>
17720 <BODY>
17721 <H1>Message Recent Status Explained</H1>
17722
17723 This part of the Pattern may have one of three possible values.
17724 The default value is &quot;Don't care&quot;, which matches any message.
17725 The other two values are &quot;Yes&quot;, which means the message must be
17726 &quot;Recent&quot; in order to be a match; or &quot;No&quot;, which
17727 means the message must <EM>not</EM> be &quot;Recent&quot; in order
17728 to be a match.
17729 &quot;Recent&quot; means that the message was added to the folder since
17730 the last time the folder was opened.
17731 If more than one mail client has the folder opened, the message will
17732 appear to be &quot;Recent&quot; to only one of the clients.
17733 <P>
17734 The nomenclature for New and Recent is a bit confusing:
17735 <P>
17736 New means that the message is Unseen.
17737 It could have been in your mailbox for a long time but if you haven't looked
17738 at it, it is still considered New.
17739 That matches the default Alpine index display that shows an N for such a
17740 message.
17741 <P>
17742 Recent means that the message was added to this folder since the last time
17743 you opened the folder.
17744 Alpine also shows an N by default for these types of messages.
17745 If you were to run two copies of Alpine that opened a folder one right after
17746 the other, a message would only show up as Recent in (at most) the first
17747 Alpine session.
17748 <P>
17749 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17750 for more information on Patterns.
17751 <P>
17752 Look <A HREF="h_edit_nav_cmds">here</A>
17753 to see the available Editing and Navigation commands.
17754 <P>
17755 &lt;End of help on this topic&gt;
17756 </BODY>
17757 </HTML>
17758 ======= h_config_role_stat_del =======
17759 <HTML>
17760 <HEAD>
17761 <TITLE>Message Deleted Status Explained</TITLE>
17762 </HEAD>
17763 <BODY>
17764 <H1>Message Deleted Status Explained</H1>
17765
17766 This part of the Pattern may have one of three possible values.
17767 The default value is &quot;Don't care&quot;, which matches any message.
17768 The other two values are &quot;Yes&quot;, which means the message must be
17769 marked &quot;Deleted&quot; in order to be a match; or &quot;No&quot;, which
17770 means the message must <EM>not</EM> be marked &quot;Deleted&quot; in order
17771 to be a match.
17772 <P>
17773 If you are thinking of using this part of the Pattern as a way to prevent
17774 messages from being filtered more than once in a Filter Pattern,
17775 take a look at the Filter Option
17776 <A HREF="h_config_filt_opts_notdel">&quot;Move-Only-if-Not-Deleted&quot;</A>
17777 instead.
17778 It should work better than using this field since it will hide the filtered
17779 messages even if they are already Deleted.
17780 That option is at the bottom of the Filter configuration screen.
17781 <P>
17782 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17783 for more information on Patterns.
17784 <P>
17785 Look <A HREF="h_edit_nav_cmds">here</A>
17786 to see the available Editing and Navigation commands.
17787 <P>
17788 &lt;End of help on this topic&gt;
17789 </BODY>
17790 </HTML>
17791 ======= h_config_role_stat_ans =======
17792 <HTML>
17793 <HEAD>
17794 <TITLE>Message Answered Status Explained</TITLE>
17795 </HEAD>
17796 <BODY>
17797 <H1>Message Answered Status Explained</H1>
17798
17799 This part of the Pattern may have one of three possible values.
17800 The default value is &quot;Don't care&quot;, which matches any message.
17801 The other two values are &quot;Yes&quot;, which means the message must be
17802 marked &quot;Answered&quot; in order to be a match; or &quot;No&quot;, which
17803 means the message must <EM>not</EM> be marked &quot;Answered&quot; in order
17804 to be a match.
17805 <P>
17806 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17807 for more information on Patterns.
17808 <P>
17809 Look <A HREF="h_edit_nav_cmds">here</A>
17810 to see the available Editing and Navigation commands.
17811 <P>
17812 &lt;End of help on this topic&gt;
17813 </BODY>
17814 </HTML>
17815 ======= h_config_role_abookfrom =======
17816 <HTML>
17817 <HEAD>
17818 <TITLE>Address in Address Book Explained</TITLE>
17819 </HEAD>
17820 <BODY>
17821 <H1>Address in Address Book Explained</H1>
17822
17823 This option gives you a way to match messages that contain an address
17824 that is in one of your address books.
17825 Only the simple entries in your address books are searched.
17826 Address book distribution lists are ignored!
17827 <P>
17828 This part of the Pattern may have one of five possible values.
17829 The default value is &quot;Don't care&quot;, which matches any message.
17830 The value &quot;Yes, in any address book&quot; means at least one of the addresses
17831 from the message must be in at least one of your
17832 address books in order to be a match.
17833 The value &quot;No, not in any address book&quot;
17834 means none of the addresses may
17835 be in any of your address books in order to be a match.
17836 <P>
17837 The values &quot;Yes, in specific address books&quot; and
17838 &quot;No, not in any of specific address books&quot; are similar but instead
17839 of depending on all address books you are allowed to give a list of address
17840 books to look in.
17841 Usually this would be a single address book but it may be a
17842 list of address books as well.
17843 For each of these &quot;specific&quot; address book options you Select which
17844 of the Specific options you want (Yes or No) <EM>AND</EM> fill in the
17845 name (or list of names) of the address book in the
17846 &quot;Abook List&quot; field.
17847 The names to be used are those that appear in the ADDRESS BOOK LIST screen.
17848 The easiest way to fill in the Abook List field it to use
17849 the &quot;T&quot; command that is available when the &quot;Abook List&quot;
17850 line is highlighted.
17851 Note that you won't be able to edit the &quot;Abook List&quot; line unless the
17852 option is set to one of the two &quot;Specific&quot;, values.
17853 <P>
17854 The addresses from the message that are checked for are determined by the
17855 setting you have for &quot;Types of addresses to check for in address book&quot;.
17856 If you set this to &quot;From&quot; the From address from the message will
17857 be looked up in the address book.
17858 If you set it to &quot;To&quot; instead then the To addresses will be used.
17859 If any of the To addresses are in the address book then it is considered
17860 a match for &quot;Yes&quot; or not a match for &quot;No&quot;.
17861 You could set it to both From and To, in which case all of the From and To
17862 addresses are used.
17863 The &quot;Reply-To&quot; and &quot;Sender&quot; cases are a little unusual.
17864 Due to deficiencies in our tools, Reply-To uses the Reply-To address if it
17865 exists or the From address if there is no Reply-To address.
17866 Same for the Sender address.
17867 <P>
17868 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17869 for more information on Patterns.
17870 <P>
17871 Look <A HREF="h_edit_nav_cmds">here</A>
17872 to see the available Editing and Navigation commands.
17873 <P>
17874 &lt;End of help on this topic&gt;
17875 </BODY>
17876 </HTML>
17877 ======= h_config_inabook_from =======
17878 <HTML>
17879 <HEAD>
17880 <TITLE>From</TITLE>
17881 </HEAD>
17882 <BODY>
17883 <H1>From</H1>
17884
17885 Setting the From line will cause the address from the From header line
17886 of the message to be checked for in the address book.
17887 <P>
17888 &lt;End of help on this topic&gt;
17889 </BODY>
17890 </HTML>
17891 ======= h_config_inabook_replyto =======
17892 <HTML>
17893 <HEAD>
17894 <TITLE>Reply-To</TITLE>
17895 </HEAD>
17896 <BODY>
17897 <H1>Reply-To</H1>
17898
17899 Setting the Reply-To line will cause the address from the Reply-To header line
17900 of the message to be checked for in the address book.
17901 However, if there is no Reply-To header line in the message the From header
17902 line will be used instead.
17903 We understand this is dumb but we don't have an easy way around it.
17904 <P>
17905 &lt;End of help on this topic&gt;
17906 </BODY>
17907 </HTML>
17908 ======= h_config_inabook_sender =======
17909 <HTML>
17910 <HEAD>
17911 <TITLE>Sender</TITLE>
17912 </HEAD>
17913 <BODY>
17914 <H1>Sender</H1>
17915
17916 Setting the Sender line will cause the address from the Sender header line
17917 of the message to be checked for in the address book.
17918 However, if there is no Sender header line in the message the From header
17919 line will be used instead.
17920 We understand this is dumb but we don't have an easy way around it.
17921 <P>
17922 &lt;End of help on this topic&gt;
17923 </BODY>
17924 </HTML>
17925 ======= h_config_inabook_to =======
17926 <HTML>
17927 <HEAD>
17928 <TITLE>To</TITLE>
17929 </HEAD>
17930 <BODY>
17931 <H1>To</H1>
17932
17933 Setting the To line will cause the address from the To header line
17934 of the message to be checked for in the address book.
17935 <P>
17936 &lt;End of help on this topic&gt;
17937 </BODY>
17938 </HTML>
17939 ======= h_config_inabook_cc =======
17940 <HTML>
17941 <HEAD>
17942 <TITLE>CC</TITLE>
17943 </HEAD>
17944 <BODY>
17945 <H1>CC</H1>
17946
17947 Setting the CC line will cause the address from the CC header line
17948 of the message to be checked for in the address book.
17949 <P>
17950 &lt;End of help on this topic&gt;
17951 </BODY>
17952 </HTML>
17953 ======= h_config_role_stat_8bitsubj =======
17954 <HTML>
17955 <HEAD>
17956 <TITLE>Raw 8-bit in Subject Explained</TITLE>
17957 </HEAD>
17958 <BODY>
17959 <H1>Raw 8-bit in Subject Explained</H1>
17960
17961 It seems that lots of unwanted email contains unencoded 8-bit characters
17962 in the Subject.
17963 Normally, characters with the 8th bit set are not allowed in the Subject
17964 header unless they are MIME-encoded.
17965 This option gives you a way to match messages that have Subjects that
17966 contain unencoded 8-bit characters.
17967 <P>
17968 This part of the Pattern may have one of three possible values.
17969 The default value is &quot;Don't care&quot;, which matches any message.
17970 The other two values are &quot;Yes&quot;, which means the Subject of
17971 the message must contain unencoded 8-bit characters (characters with the
17972 most significant bit set)
17973 in order to be a match; or &quot;No&quot;, which
17974 means the Subject must <EM>not</EM>
17975 contain unencoded 8-bit characters in order to be a match.
17976 <P>
17977 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17978 for more information on Patterns.
17979 <P>
17980 Look <A HREF="h_edit_nav_cmds">here</A>
17981 to see the available Editing and Navigation commands.
17982 <P>
17983 &lt;End of help on this topic&gt;
17984 </BODY>
17985 </HTML>
17986 ======= h_config_role_bom =======
17987 <HTML>
17988 <HEAD>
17989 <TITLE>Beginning of Month</TITLE>
17990 </HEAD>
17991 <BODY>
17992 <H1>Beginning of Month</H1>
17993
17994 This option gives you a limited ability to take different actions depending on whether
17995 this is the first time Alpine has been run this month or not.
17996 Though it would be nice to have such an option available, this is not the
17997 same as whether or not this is the first time a paricular folder has been
17998 opened this month.
17999 If you want some action (probably Filtering) to take place in a folder each
18000 month, then you will need to be sure that the folder is opened during the
18001 first Alpine session of the month in order for this option to be helpful.
18002 <P>
18003 This part of the Pattern may have one of three possible values.
18004 The default value is &quot;Don't care&quot;, which matches any message.
18005 The other two values are &quot;Yes&quot;, which means this is the first
18006 time Alpine has been run this month;
18007 or &quot;No&quot;, which
18008 means this is not the first time Alpine has been run this month.
18009 <P>
18010 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18011 for more information on Patterns.
18012 <P>
18013 Here are some technical details.
18014 The way that Alpine decides if it is the beginning of the month or not is
18015 to compare today's date with the date stored in the
18016 <A HREF="h_config_prune_date"><!--#echo var="VAR_last-time-prune-questioned"--></A>
18017 variable in the config file.
18018 If the month of today's date is later than the month stored in the variable,
18019 then this is considered to be the first time you have run Alpine this month, and
18020 that turns the Beginning of the Month option on.
18021 <P>
18022 Look <A HREF="h_edit_nav_cmds">here</A>
18023 to see the available Editing and Navigation commands.
18024 <P>
18025 &lt;End of help on this topic&gt;
18026 </BODY>
18027 </HTML>
18028 ======= h_config_role_boy =======
18029 <HTML>
18030 <HEAD>
18031 <TITLE>Beginning of Year</TITLE>
18032 </HEAD>
18033 <BODY>
18034 <H1>Beginning of Year</H1>
18035
18036 This option gives you a limited ability to take different actions depending on whether
18037 this is the first time Alpine has been run this year or not.
18038 Though it would be nice to have such an option available, this is not the
18039 same as whether or not this is the first time a paricular folder has been
18040 opened this year.
18041 If you want some action (probably Filtering) to take place in a folder each
18042 year, then you will need to be sure that the folder is opened during the
18043 first Alpine session of the year in order for this option to be helpful.
18044 <P>
18045 This part of the Pattern may have one of three possible values.
18046 The default value is &quot;Don't care&quot;, which matches any message.
18047 The other two values are &quot;Yes&quot;, which means this is the first
18048 time Alpine has been run this year;
18049 or &quot;No&quot;, which
18050 means this is not the first time Alpine has been run this year.
18051 <P>
18052 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18053 for more information on Patterns.
18054 <P>
18055 Here are some technical details.
18056 The way that Alpine decides if it is the beginning of the year or not is
18057 to compare today's date with the date stored in the
18058 <A HREF="h_config_prune_date"><!--#echo var="VAR_last-time-prune-questioned"--></A>
18059 variable in the config file.
18060 If the year of today's date is later than the year stored in the variable,
18061 then this is considered to be the first time you have run Alpine this year, and
18062 that turns the Beginning of the Year option on.
18063 <P>
18064 Look <A HREF="h_edit_nav_cmds">here</A>
18065 to see the available Editing and Navigation commands.
18066 <P>
18067 &lt;End of help on this topic&gt;
18068 </BODY>
18069 </HTML>
18070 ======= h_config_role_inick =======
18071 <HTML>
18072 <HEAD>
18073 <TITLE>Initialize Values From Role Explained</TITLE>
18074 </HEAD>
18075 <BODY>
18076 <H1>Initialize Values From Role Explained</H1>
18077
18078 This is a power user feature.
18079 You will usually want to leave this field empty.
18080 The value of this field is the nickname of another one of your roles.
18081 The Action values from that other role
18082 are used as the initial values of the Action items for this role.
18083 If you put something in any of the action fields for this role, that will
18084 override whatever was in the corresponding field of the initializer role.
18085 <P>
18086 You might use this field if the &quot;Action&quot; part of one of your roles
18087 is something you want to use in more than one role.
18088 Instead of filling in those action values again for each role, you
18089 may give the nickname of the role where the values are filled in.
18090 It's just a shortcut way to define Role Actions.
18091 <P>
18092 Here's an example to help explain how this works.
18093 Suppose you have a role with nickname &quot;role1&quot; and role1 has
18094 (among other things)
18095 <P>
18096 <CENTER><SAMP>Set Reply-To = The Pres &lt;president@example.com&gt;</SAMP></CENTER>
18097 <P>
18098 set.
18099 If in &quot;role2&quot; you set &quot;Initialize settings using role&quot; to
18100 &quot;role1&quot;, then role2 will inherit the Set Reply-To value
18101 from role1 by default (and any of the other inheritable action values
18102 that are set).
18103 So if role2 had
18104 <P>
18105 <CENTER><SAMP>Set Reply-To = &lt;No Value Set&gt;</SAMP></CENTER>
18106 <P>
18107 defined, the Reply-To used with role2 would be &quot;The Pres &lt;president@example.com&gt;&quot;
18108 However, if role2 had
18109 <P>
18110 <CENTER><SAMP>Set Reply-To = VP &lt;vicepresident@example.com&gt;</SAMP></CENTER>
18111 <P>
18112 defined, then the Reply-To used with role2 would be &quot;VP &lt;vicepresident@example.com&gt;&quot; instead.
18113 <P>
18114 If you wish,
18115 you may choose a nickname from your list of roles by using the
18116 &quot;T&quot; command.
18117 If the role you are using to initialize also has a role it initializes from,
18118 then that initialization happens first.
18119 That is, inheritance works as expected with the grandparent and
18120 great-grandparent (and so on) roles having the expected effect.
18121 <P>
18122 Look <A HREF="h_edit_nav_cmds">here</A>
18123 to see the available Editing and Navigation commands.
18124 <P>
18125 &lt;End of help on this topic&gt;
18126 </BODY>
18127 </HTML>
18128 ======= h_config_role_setfrom =======
18129 <HTML>
18130 <HEAD>
18131 <TITLE>Set From Explained</TITLE>
18132 </HEAD>
18133 <BODY>
18134 <H1>Set From Explained</H1>
18135
18136 This describes part of the action to be taken if the Pattern for this
18137 role is a match.
18138 This field consists of a single address that will be used as the From
18139 address on the message you are sending.
18140 This should be a fully-qualified address like
18141 <P>
18142 <CENTER><SAMP>Full Name &lt;user@domain&gt;</SAMP></CENTER>
18143 <P>
18144 or just
18145 <P>
18146 <CENTER><SAMP>user@domain</SAMP></CENTER>
18147 <P>
18148 If you wish,
18149 you may choose an address from your address book with the
18150 &quot;T&quot; command.
18151 <P>
18152 If this is left blank, then your normal From address will be used.
18153 <P>
18154 You may also find it useful to add the changed From address to the
18155 <a href="h_config_alt_addresses"><!--#echo var="VAR_alt-addresses"--></a>
18156 configuration option.
18157 <P>
18158 Look <A HREF="h_edit_nav_cmds">here</A>
18159 to see the available Editing and Navigation commands.
18160 <P>
18161 &lt;End of help on this topic&gt;
18162 </BODY>
18163 </HTML>
18164 ======= h_config_role_setreplyto =======
18165 <HTML>
18166 <HEAD>
18167 <TITLE>Set Reply-To Explained</TITLE>
18168 </HEAD>
18169 <BODY>
18170 <H1>Set Reply-To Explained</H1>
18171
18172 This describes part of the action to be taken if the Pattern for this
18173 role is a match.
18174 This field consists of a single address that will be used as the Reply-To
18175 address on the message you are sending.
18176 This may be a fully-qualified address like
18177 <P>
18178 <CENTER><SAMP>Full Name &lt;user@domain&gt;</SAMP></CENTER>
18179 <P>
18180 or just
18181 <P>
18182 <CENTER><SAMP>user@domain</SAMP></CENTER>
18183 <P>
18184 If you wish,
18185 you may choose an address from your address book with the
18186 &quot;T&quot; command.
18187 <P>
18188 If this is left blank, then there won't be a Reply-To address unless
18189 you have configured one specially with the
18190 "<A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A>"
18191 configuration option.
18192 <P>
18193 Look <A HREF="h_edit_nav_cmds">here</A>
18194 to see the available Editing and Navigation commands.
18195 <P>
18196 &lt;End of help on this topic&gt;
18197 </BODY>
18198 </HTML>
18199 ======= h_config_role_setfcc =======
18200 <HTML>
18201 <HEAD>
18202 <TITLE>Set Fcc Explained</TITLE>
18203 </HEAD>
18204 <BODY>
18205 <H1>Set Fcc Explained</H1>
18206
18207 This describes part of the action to be taken if the Pattern for this
18208 role is a match.
18209 This field consists of a single folder name that will be used in
18210 the Fcc field of the message you are sending.
18211 You may put anything here that you would normally type into the Fcc
18212 field from the composer.
18213 <P>
18214 In addition, an fcc of &quot;&quot; (two double quotation marks) means
18215 no Fcc.
18216 <P>
18217 A blank field here means that Alpine will use its normal rules for deciding
18218 the default value of the Fcc field.
18219 For many roles, perhaps most, it may make more sense for you to use the
18220 other Alpine facilities for setting the Fcc.
18221 In particular, if you want the Fcc to depend on who you are sending the
18222 message to then the <A HREF="h_config_fcc_rule">&quot;<!--#echo var="VAR_fcc-name-rule"-->&quot;</A>
18223 is probably more useful.
18224 In that case, you would want to leave the Fcc field here blank.
18225 However, if you have a role that depends on who the message you are replying
18226 to was From, or what address that message was sent to;
18227 then it might make sense to set the Fcc for that role here.
18228 <P>
18229 If you wish,
18230 you may choose a folder from your folder collections by using the
18231 &quot;T&quot; command.
18232 <P>
18233 Look <A HREF="h_edit_nav_cmds">here</A>
18234 to see the available Editing and Navigation commands.
18235 <P>
18236 &lt;End of help on this topic&gt;
18237 </BODY>
18238 </HTML>
18239 ======= h_config_role_usesmtp =======
18240 <HTML>
18241 <HEAD>
18242 <TITLE>Use SMTP Server Explained</TITLE>
18243 </HEAD>
18244 <BODY>
18245 <H1>Use SMTP Server Explained</H1>
18246
18247 This describes part of the action to be taken if the Pattern for this
18248 role is a match.
18249 If this field has a value, then it will be used as the SMTP server
18250 to send mail when this role is being used (unless the SMTP server variable
18251 is set in the system-wide fixed configuration file).
18252 It has the same semantics as the
18253 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>
18254 variable in the Setup/Config screen.
18255 <P>
18256 If you are using this to post from home when you are at home and from
18257 work when you are at work you need to be careful about postponing messages.
18258 When you postpone a composition that was using a role with this variable
18259 set, the SMTP server list will be saved
18260 with the postponed composition.
18261 It cannot be changed later.
18262 Because of this, you may want to make this a list of SMTP servers
18263 with the preferred server at the front of the list and alternate servers
18264 later in the list.
18265 In your &quot;Home&quot; role you would put the home SMTP server first and
18266 the work SMTP server last.
18267 In your &quot;Work&quot; role you would put the work SMTP server first and
18268 the home SMTP server last.
18269 Then if you start a composition as &quot;Work&quot;, postpone
18270 it, and then later resume it from home the work SMTP server will fail but
18271 the home SMTP server later in the list will succeed.
18272 <P>
18273 You may be able to simplify things by making the regular
18274 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>
18275 variable in the Setup/Config screen a list instead of using roles
18276 to set the SMTP server.
18277
18278 <P>
18279 Look <A HREF="h_edit_nav_cmds">here</A>
18280 to see the available Editing and Navigation commands.
18281 <P>
18282 &lt;End of help on this topic&gt;
18283 </BODY>
18284 </HTML>
18285 ======= h_config_role_usenntp =======
18286 <HTML>
18287 <HEAD>
18288 <TITLE>Use NNTP Server Explained</TITLE>
18289 </HEAD>
18290 <BODY>
18291 <H1>Use NNTP Server Explained</H1>
18292
18293 This describes part of the action to be taken if the Pattern for this
18294 role is a match.
18295 If this field has a value, then it will be used as the NNTP server
18296 to post to newsgroups when this role is being used (unless the NNTP server
18297 variable
18298 is set in the system-wide fixed configuration file).
18299 It has the same semantics as the
18300 <A HREF="h_config_nntp_server">&quot;<!--#echo var="VAR_nntp-server"-->&quot;</A>
18301 variable in the Setup/Config screen.
18302 <P>
18303 This role setting can facilitate posting to the right nntp server for someone
18304 who reads news from various news sources.  The feature
18305 <A HREF="h_config_predict_nntp_server">&quot;<!--#echo var="FEAT_predict-nntp-server"-->&quot;</A>
18306 allows for setting the correct <!--#echo var="VAR_nntp-server"--> without having to individually
18307 set a role for that <!--#echo var="VAR_nntp-server"-->, but for greater flexibility, setting
18308 nntp servers for roles may be more desirable for some people.
18309 <P>
18310 If you are using this to post from home when you are at home and from
18311 work when you are at work you need to be careful about postponing messages.
18312 When you postpone a composition that was using a role with this variable
18313 set, the NNTP server list will be saved
18314 with the postponed composition.
18315 It cannot be changed later.
18316 Because of this, you may want to make this a list of NNTP servers
18317 with the preferred server at the front of the list and alternate servers
18318 later in the list.
18319 In your &quot;Home&quot; role you would put the home NNTP server first and
18320 the work NNTP server last.
18321 In your &quot;Work&quot; role you would put the work NNTP server first and
18322 the home NNTP server last.
18323 Then if you start a composition as &quot;Work&quot;, postpone
18324 it, and then later resume it from home the work NNTP server will fail but
18325 the home NNTP server later in the list will succeed.
18326 <P>
18327 You may be able to simplify things by making the regular
18328 <A HREF="h_config_nntp_server">&quot;<!--#echo var="VAR_nntp-server"-->&quot;</A>
18329 variable in the Setup/Config screen a list instead of using roles
18330 to set the NNTP server.
18331
18332 <P>
18333 Look <A HREF="h_edit_nav_cmds">here</A>
18334 to see the available Editing and Navigation commands.
18335 <P>
18336 &lt;End of help on this topic&gt;
18337 </BODY>
18338 </HTML>
18339 ======= h_config_role_setotherhdr =======
18340 <HTML>
18341 <HEAD>
18342 <TITLE>Set Other Headers Explained</TITLE>
18343 </HEAD>
18344 <BODY>
18345 <H1>Set Other Headers Explained</H1>
18346
18347 This describes part of the action to be taken if the Pattern for this
18348 role is a match.
18349 This field gives you a way to set values for headers besides
18350 &quot;From&quot; and &quot;Reply-To&quot;.
18351 If you want to set either of those, use the specific
18352 &quot;Set From&quot; and &quot;Set Reply-To&quot; settings above.
18353 <P>
18354 This field is similar to the
18355 "<A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A>" option.
18356 Each header you specify here must include the header tag
18357 (&quot;To:&quot;, &quot;Approved:&quot;, etc.)
18358 and may optionally include a value for that header.
18359 In order to see these headers when you compose using this role you
18360 must use the rich header
18361 <!--chtml if pinemode="function_key"-->(F5)
18362 <!--chtml else-->(Ctrl-R)<!--chtml endif--> command.
18363 Here's an example that shows how you might set the To address.
18364 <P>
18365 <CENTER><SAMP>Set Other Hdrs = To: Full Name &lt;user@domain&gt;</SAMP></CENTER>
18366 <P>
18367 Headers set in this way are different from headers set with the
18368 <!--#echo var="VAR_customized-hdrs"--> option in that the value you give for a header here
18369 will replace any value that already exists.
18370 For example, if you are Replying to a message there will already be at
18371 least one address in the To header (the address you are Replying to).
18372 However, if you Reply using a role that sets the To header, that role's
18373 To header value will be used instead.
18374 <P>
18375 Limitation: Because commas are used to separate the list of
18376 Other Headers, it is not possible to have the value of a
18377 header contain a comma;
18378 nor is there currently an &quot;escape&quot; mechanism provided
18379 to make this work.
18380 <P>
18381 Look <A HREF="h_edit_nav_cmds">here</A>
18382 to see the available Editing and Navigation commands.
18383 <P>
18384 &lt;End of help on this topic&gt;
18385 </BODY>
18386 </HTML>
18387 ======= h_config_role_setlitsig =======
18388 <HTML>
18389 <HEAD>
18390 <TITLE>Set Literal Signature Explained</TITLE>
18391 </HEAD>
18392 <BODY>
18393 <H1>Set Literal Signature Explained</H1>
18394
18395 This describes part of the action to be taken if the Pattern for this
18396 role is a match.
18397 This field contains the actual text for your signature, as opposed to
18398 the name of a file containing your signature.
18399 If this is defined it takes precedence over any value set in the
18400 &quot;Set Signature&quot; field.
18401 <P>
18402 This is simply a different way to store the signature.
18403 The signature is stored inside your Alpine configuration file instead of in
18404 a separate file.
18405 Tokens work the same way they do with
18406 <A HREF="h_config_role_setsig">Set Signature</A>, so refer to the
18407 help text there for more information.
18408 <P>
18409
18410 The two character sequence &#92;n (backslash followed by
18411 the character n) will be used to signify a line-break in your signature.
18412 You don't have to enter the &#92;n, but it will be visible in the
18413 CHANGE THIS ROLE RULE window after you are done editing the signature.
18414 <P>
18415 Look <A HREF="h_edit_nav_cmds">here</A>
18416 to see the available Editing and Navigation commands.
18417 <P>
18418 &lt;End of help on this topic&gt;
18419 </BODY>
18420 </HTML>
18421 ======= h_config_role_setsig =======
18422 <HTML>
18423 <HEAD>
18424 <TITLE>Set Signature Explained</TITLE>
18425 </HEAD>
18426 <BODY>
18427 <H1>Set Signature Explained</H1>
18428
18429 This describes part of the action to be taken if the Pattern for this
18430 role is a match.
18431 <P>
18432 If either the default <A HREF="h_config_literal_sig"><!--#echo var="VAR_literal-signature"--></A>
18433 option from Setup/Config
18434 or the &quot;Set LiteralSig&quot; option for this role are defined,
18435 then this option will be ignored.
18436 You can tell that that is the case because the value of this
18437 option will show up as
18438 <P>
18439 <CENTER><SAMP>&lt;Ignored: using LiteralSig instead&gt;</SAMP></CENTER>
18440 <P>
18441 You may either use all Literal Signatures (signatures stored in your
18442 configuration file) throughout Alpine, or all signature files.
18443 You can't mix the two.
18444 <P>
18445 This field consists of a filename that will be used as the signature
18446 file when using this role.
18447 <P>
18448 If the filename is followed by a vertical bar (|) then instead
18449 of reading the contents of the file the file is assumed to be a
18450 program that will produce the text to be used on its standard output.
18451 The program can't have any arguments and doesn't receive any input from Alpine,
18452 but the rest of the processing works as if the contents came from a file.
18453 <P>
18454 Instead of storing the data in a local file, the
18455 signature data may be stored remotely in an IMAP folder.
18456 In order to do this,
18457 you must use a remote name for the signature.
18458 A remote signature name might look like:
18459 <P>
18460 <CENTER><SAMP>{myimaphost.myschool.k12.wa.us}mail/sig3</SAMP></CENTER>
18461 <P>
18462
18463 The syntax used here is the same as the syntax used for a remote
18464 <A HREF="h_config_signature_file"><!--#echo var="VAR_signature-file"--></A>.
18465 Note that you may not access an existing signature file remotely,
18466 you have to create a new <EM>folder</EM> that contains the signature data.
18467 If the name you use here for the signature data is a remote name, then when
18468 you edit the file using the &quot;F&quot; command the data will
18469 be saved remotely in the folder.
18470 You aren't required to do anything special to create the folder, it
18471 gets created if you use a remote name.
18472
18473 <P>
18474 If you type &quot;F&quot; you may edit the contents of the file (as opposed to
18475 the name of the file) you have specified.
18476 If you type &quot;T&quot; you may use a browser to choose an existing filename.
18477 <P>
18478 Besides containing regular text, a signature file may also
18479 contain (or a signature program may produce) tokens that are replaced with text
18480 that depends on the message you are replying to or forwarding.
18481 The tokens all look like _word_ (a word surrounded by underscores).
18482 For example, if the token
18483 <P>
18484 <CENTER><SAMP>_DATE_</SAMP></CENTER>
18485 <P>
18486 is included in the text of the signature file, then when you reply to
18487 or forward a message, the token will be replaced with the actual date
18488 the message you are replying to or forwarding was sent.
18489 <P>
18490 If you use a role that has a signature file for a plain composition
18491 (that is, not a reply or forward) then there is no original message, so
18492 any tokens that depend on the message will be replaced with nothing.
18493 So if you want a signature file to be useful for new compositions it
18494 shouldn't include any of the tokens that depend on the message being
18495 replied to or forwarded.
18496 <P>
18497 The list of available tokens is
18498 <A HREF="h_index_tokens">here</A>.
18499 <P>
18500 Actually, for the adventurous, there is a way to conditionally include text based
18501 on whether or not a token would result in specific replacement text.
18502 For example, you could include some text based on whether or not
18503 the _NEWS_ token would result in any newsgroups if it was used.
18504 It's explained in detail
18505 <A HREF="h_reply_token_conditionals">here</A>.
18506 <P>
18507 In the very unlikely event that you want to include a literal token in
18508 a signature file, you must precede it with a backslash character.
18509 For example, to include the literal text _DATE_ you must actually use
18510 &#92;_DATE_.
18511 It is not possible to have a literal backslash followed by an expanded token.
18512 <P>
18513 A blank field here means that Alpine will use its normal rules for deciding
18514 which file (if any) to use for the signature file.
18515 <P>
18516 An alternate method for storing the signature is available in
18517 <A HREF="h_config_role_setlitsig">Set Literal Signature</A>.
18518 <P>
18519 Look <A HREF="h_edit_nav_cmds">here</A>
18520 to see the available Editing and Navigation commands.
18521 <P>
18522 &lt;End of help on this topic&gt;
18523 </BODY>
18524 </HTML>
18525 ======= h_config_role_settempl =======
18526 <HTML>
18527 <HEAD>
18528 <TITLE>Set Template Explained</TITLE>
18529 </HEAD>
18530 <BODY>
18531 <H1>Set Template Explained</H1>
18532
18533 This describes part of the action to be taken if the Pattern for this
18534 role is a match.
18535 This field consists of a filename that will be used as the template
18536 file when using this role.
18537 The template file is a file that is included at the top of the message you
18538 are composing.
18539 <P>
18540 If the filename is followed by a vertical bar (|) then instead
18541 of reading the contents of the file the file is assumed to be a
18542 program that will produce the text to be used on its standard output.
18543 The program can't have any arguments and doesn't receive any input from Alpine,
18544 but the rest of the processing works as if the contents came from a file.
18545 <P>
18546 Instead of storing the data in a local file, the
18547 template may be stored remotely in an IMAP folder.
18548 In order to do this,
18549 you must use a remote name for the template.
18550 A remote template name might look like:
18551 <P>
18552 <CENTER><SAMP>{myimaphost.myschool.k12.wa.us}mail/templ3</SAMP></CENTER>
18553 <P>
18554
18555 The syntax used here is the same as the syntax used for a remote
18556 <A HREF="h_config_signature_file"><!--#echo var="VAR_signature-file"--></A>.
18557 Note that you may not access an existing template file remotely,
18558 you have to create a new <EM>folder</EM> that contains the template data.
18559 If the name you use here for the template is a remote name, then when
18560 you edit the file using the &quot;F&quot; command the data will
18561 be saved remotely in the folder.
18562 You aren't required to do anything special to create the folder, it
18563 gets created if you use a remote name.
18564 <P>
18565 If you type &quot;F&quot; you may edit the contents of the file (as opposed to
18566 the name of the file) you have specified.
18567 If you type &quot;T&quot; you may use a browser to choose an existing filename.
18568 <P>
18569 Besides containing regular text, the template file may also
18570 contain (or a template file program may produce) tokens that are replaced with text
18571 that depends on the message you are replying to or forwarding.
18572 The tokens all look like _word_ (a word surrounded by underscores).
18573 For example, if the token
18574 <P>
18575 <CENTER><SAMP>_DATE_</SAMP></CENTER>
18576 <P>
18577 is included in the text of the template file, then when you reply to
18578 or forward a message, the token will be replaced with the actual date
18579 the message you are replying to or forwarding was sent.
18580 <P>
18581 If you use a role that has a template file for a plain composition
18582 (that is, not a reply or forward) then there is no original message, so
18583 any tokens that depend on the message will be replaced with nothing.
18584 So if you want a template file to be useful for new compositions it
18585 shouldn't include any of the tokens that depend on the message being
18586 replied to or forwarded.
18587 <P>
18588 The list of available tokens is
18589 <A HREF="h_index_tokens">here</A>.
18590 <P>
18591 Actually, for the adventurous, there is a way to conditionally include text based
18592 on whether or not a token would result in specific replacement text.
18593 For example, you could include some text based on whether or not
18594 the _NEWS_ token would result in any newsgroups if it was used.
18595 It's explained in detail
18596 <A HREF="h_reply_token_conditionals">here</A>.
18597 <P>
18598 In the very unlikely event that you want to include a literal token in
18599 a template file, you must precede it with a backslash character.
18600 For example, to include the literal text _DATE_ you must actually use
18601 &#92;_DATE_.
18602 It is not possible to have a literal backslash followed by an expanded token.
18603 <P>
18604 A blank template field means that Alpine will not use a template file when
18605 this role is being used.
18606 <P>
18607 Look <A HREF="h_edit_nav_cmds">here</A>
18608 to see the available Editing and Navigation commands.
18609 <P>
18610 &lt;End of help on this topic&gt;
18611 </BODY>
18612 </HTML>
18613 ======= h_config_filt_stat_imp =======
18614 <HTML>
18615 <HEAD>
18616 <TITLE>Set Important Status Explained</TITLE>
18617 </HEAD>
18618 <BODY>
18619 <H1>Set Important Status Explained</H1>
18620
18621 This describes part of the action to be taken if the Pattern for this
18622 filter is a match.
18623 If set to &quot;Don't change it&quot; then this does nothing.
18624 If set to &quot;Set this state&quot; then the Important flag is set
18625 for the matching message.
18626 If set to &quot;Clear this state&quot; then the Important flag is cleared
18627 for the matching message.
18628 The important flag usually causes an asterisk to show up in the MESSAGE
18629 INDEX.
18630 It may also be useful when selecting a set of messages
18631 with the Select command.
18632 <P>
18633 Look <A HREF="h_edit_nav_cmds">here</A>
18634 to see the available Editing and Navigation commands.
18635 <P>
18636 &lt;End of help on this topic&gt;
18637 </BODY>
18638 </HTML>
18639 ======= h_config_filt_stat_new =======
18640 <HTML>
18641 <HEAD>
18642 <TITLE>Set New Status Explained</TITLE>
18643 </HEAD>
18644 <BODY>
18645 <H1>Set New Status Explained</H1>
18646
18647 This describes part of the action to be taken if the Pattern for this
18648 filter is a match.
18649 If set to &quot;Don't change it&quot; then this does nothing.
18650 If set to &quot;Set this state&quot; then the
18651 matching message is marked New.
18652 If set to &quot;Clear this state&quot; then the
18653 matching message is marked Seen.
18654 <P>
18655 Look <A HREF="h_edit_nav_cmds">here</A>
18656 to see the available Editing and Navigation commands.
18657 <P>
18658 &lt;End of help on this topic&gt;
18659 </BODY>
18660 </HTML>
18661 ======= h_config_filt_stat_ans =======
18662 <HTML>
18663 <HEAD>
18664 <TITLE>Set Answered Status Explained</TITLE>
18665 </HEAD>
18666 <BODY>
18667 <H1>Set Answered Status Explained</H1>
18668
18669 This describes part of the action to be taken if the Pattern for this
18670 filter is a match.
18671 If set to &quot;Don't change it&quot; then this does nothing.
18672 If set to &quot;Set this state&quot; then the Answered flag is set
18673 for the matching message.
18674 If set to &quot;Clear this state&quot; then the Answered flag is cleared
18675 for the matching message.
18676 <P>
18677 Look <A HREF="h_edit_nav_cmds">here</A>
18678 to see the available Editing and Navigation commands.
18679 <P>
18680 &lt;End of help on this topic&gt;
18681 </BODY>
18682 </HTML>
18683 ======= h_config_filt_stat_del =======
18684 <HTML>
18685 <HEAD>
18686 <TITLE>Set Deleted Status Explained</TITLE>
18687 </HEAD>
18688 <BODY>
18689 <H1>Set Deleted Status Explained</H1>
18690
18691 This describes part of the action to be taken if the Pattern for this
18692 filter is a match.
18693 If set to &quot;Don't change it&quot; then this does nothing.
18694 If set to &quot;Set this state&quot; then the
18695 matching message is marked Deleted.
18696 If set to &quot;Clear this state&quot; then the
18697 matching message is marked UnDeleted.
18698 <P>
18699 You should not use this option unless you are prepared to have matching
18700 messages expunged from the folder permanently.
18701 For example, if you type the Expunge command, this filter is applied
18702 before the expunge, so matching messages will be marked Deleted and then
18703 will be permanently expunged from the folder.
18704 However, since the index isn't redrawn in between the time that the message
18705 is marked Deleted and the time that you are asked to expunge, the only
18706 indication that you are expunging the message comes in the number of messages
18707 being expunged.
18708 The same thing may happen when you close a folder.
18709 It is also possible that an expunge not initiated by you will
18710 delete matching messages.
18711 <P>
18712 Look <A HREF="h_edit_nav_cmds">here</A>
18713 to see the available Editing and Navigation commands.
18714 <P>
18715 &lt;End of help on this topic&gt;
18716 </BODY>
18717 </HTML>
18718 ======= h_config_role_scoreval =======
18719 <HTML>
18720 <HEAD>
18721 <TITLE>Score Value Explained</TITLE>
18722 </HEAD>
18723 <BODY>
18724 <H1>Score Value Explained</H1>
18725
18726 A message's score is the sum of the Score Values from all of the Scoring rules
18727 with Patterns that match the message.
18728 The value you give here is the Score Value associated with this rule.
18729 A Score Value is an integer between -100 and 100, with the default
18730 value of zero.
18731 <P>
18732 Alternatively, if the
18733 <A HREF="h_config_role_scorehdrtok">&quot;Score From Header&quot;</A>
18734 field is defined
18735 (on the line right below the &quot;Score Value&quot; field)
18736 then the &quot;Score Value&quot; is ignored and
18737 the &quot;Score From Header&quot; field is used instead.
18738 <P>
18739 Look <A HREF="h_edit_nav_cmds">here</A>
18740 to see the available Editing and Navigation commands.
18741 <P>
18742 &lt;End of help on this topic&gt;
18743 </BODY>
18744 </HTML>
18745 ======= h_config_role_scorehdrtok =======
18746 <HTML>
18747 <HEAD>
18748 <TITLE>Score Value From Header Explained</TITLE>
18749 </HEAD>
18750 <BODY>
18751 <H1>Score Value From Header Explained</H1>
18752
18753 This option provides a way to use a number that appears in the headers of your
18754 messages as the message's score, or as a component of that score.
18755 If this field is defined then it is used instead of the &quot;Score Value&quot;.
18756 The idea behind this option is that there may be a score embedded in the
18757 headers of messages that has already been calculated outside of Alpine.
18758 For example, messages delivered to you may contain an &quot;X-Spam&quot; header and
18759 somewhere in that header there is a score.
18760 <P>
18761 The value for this option is the name of the header followed by parentheses
18762 with two arguments inside:
18763 <P>
18764 <CENTER><SAMP>HeaderName(field_number,field_separators)</SAMP></CENTER>
18765 <P>
18766 No space is allowed between the comma and the start of the field_separators.
18767 It would be interpreted as the first separator if it was there.
18768 Field 0 is the whole line, Field 1 is the data up to the first separator, Field 2
18769 starts after that and goes to the second separator, and so on.
18770 It's easier to explain with examples.
18771 <P>
18772 <CENTER><SAMP>X-Spam(2,&quot;&nbsp;&quot;)</SAMP></CENTER>
18773 <P>
18774 In the above example the header that is used is the &quot;X-Spam&quot; header.
18775 The value of that header (the part after the colon and the space) is split
18776 into fields separated by spaces.
18777 <P>
18778 <CENTER><SAMP>Field1 &lt;space&gt; Field2 &lt;space&gt; Field3 ...</SAMP></CENTER>
18779 <P>
18780 The second field is selected and converted to an integer. It only makes sense
18781 if Field2 really is an integer.
18782 <P>
18783 Here's an example of a SpamAssassin header.
18784 The exact look of the header will vary, but if your incoming mail
18785 contains headers that look like the following
18786 <P>
18787 <CENTER><SAMP>X-Spam-Status: Yes, hits=10.6 tagged_above=-999.0 required=7.0 tests=BAYE...</SAMP></CENTER>
18788 <P>
18789 you might want to use the hits value as a score.
18790 Since the score is an integer value you can't make use of the decimal part of
18791 the number, but
18792 you might split off the hits=10 part as a score by using the characters &quot;=&quot;
18793 and &quot;.&quot; as your separators.
18794 <P>
18795 <CENTER><SAMP>X-Spam-Status(2,&quot;=.&quot;)</SAMP></CENTER>
18796 <P>
18797 The first field starts with the Y in Yes and goes until the &quot;=&quot; after
18798 hits.
18799 The second field is &quot;10&quot; so the score value would be 10.
18800 <P>
18801 Another example we've seen has headers that look like
18802 <P>
18803 <CENTER><SAMP>X-Spam: Gauge=IIIIIII, Probability=7%, Report=...</SAMP></CENTER>
18804 <P>
18805 Because there are two equals before the 7% the value
18806 <P>
18807 <CENTER><SAMP>X-Spam(3,&quot;=%&quot;)</SAMP></CENTER>
18808 <P>
18809 should capture the probability as the score.
18810 <P>
18811 The Score From Header scoring value actually works just like the
18812 regular Score Value in that the rest of the pattern has to match before
18813 it is used and the scores from all the different scoring rules that
18814 match for a particular message are added together.
18815 When using the Score From Header method it may (or may not) make sense to
18816 use only a single scoring rule with a pattern that matches every message.
18817 <P>
18818 Look <A HREF="h_edit_nav_cmds">here</A>
18819 to see the available Editing and Navigation commands.
18820 <P>
18821 &lt;End of help on this topic&gt;
18822 </BODY>
18823 </HTML>
18824 ======= h_config_role_replyuse =======
18825 <HTML>
18826 <HEAD>
18827 <TITLE>Reply Use Explained</TITLE>
18828 </HEAD>
18829 <BODY>
18830 <H1>Reply Use Explained</H1>
18831
18832 This option determines how this particular role will be used when Replying
18833 to a message.
18834 There are three possible values for this option.
18835 The value &quot;Never&quot;
18836 means that this role will not be a candidate for use when Replying.
18837 The role's Pattern will not be checked for a match, however the role will
18838 be available to be manually switched to if there is a confirmation prompt.
18839 <P>
18840
18841 The options &quot;With confirmation&quot; and &quot;Without confirmation&quot;
18842 mean that you do want to consider this role when Replying.
18843 For either of these settings, the role's Pattern will be compared with
18844 the message being replied to.
18845 If there is a match then this role will either be used without confirmation
18846 or will be the default when confirmation is asked for, depending on
18847 which of the two options is selected.
18848 If confirmation is requested, you will also have a chance to
18849 manually change the role to any one of your other roles.
18850 <P>
18851
18852 You won't be prompted for confirmation if none of your role Patterns
18853 match the message being replied to.
18854 This is independent of the value of the current option.
18855 The <A HREF="h_config_confirm_role"><!--#echo var="FEAT_confirm-role-even-for-default"--></A>
18856 feature may be used to change this behavior.
18857 <P>
18858 &lt;End of help on this topic&gt;
18859 </BODY>
18860 </HTML>
18861 ======= h_config_role_forwarduse =======
18862 <HTML>
18863 <HEAD>
18864 <TITLE>Forward Use Explained</TITLE>
18865 </HEAD>
18866 <BODY>
18867 <H1>Forward Use Explained</H1>
18868
18869 This option determines how this particular role will be used when Forwarding
18870 a message.
18871 There are three possible values for this option.
18872 The value &quot;Never&quot;
18873 means that this role will not be a candidate for use when Forwarding.
18874 The role's Pattern will not be checked for a match, however the role will
18875 be available to be manually switched to if there is a confirmation prompt.
18876 <P>
18877
18878 The options &quot;With confirmation&quot; and &quot;Without confirmation&quot;
18879 mean that you do want to consider this role when Forwarding.
18880 For either of these settings, the role's Pattern will be compared with
18881 the message being forwarded.
18882 If there is a match then this role will either be used without confirmation
18883 or will be the default when confirmation is asked for, depending on
18884 which of the two options is selected.
18885 If confirmation is requested, you will also have a chance to
18886 manually change the role to any one of your other roles.
18887 <P>
18888
18889 You won't be prompted for confirmation if none of your role Patterns
18890 match the message being forwarded.
18891 This is independent of the value of the current option.
18892 The <A HREF="h_config_confirm_role"><!--#echo var="FEAT_confirm-role-even-for-default"--></A>
18893 feature may be used to change this behavior.
18894 <P>
18895 &lt;End of help on this topic&gt;
18896 </BODY>
18897 </HTML>
18898 ======= h_config_role_composeuse =======
18899 <HTML>
18900 <HEAD>
18901 <TITLE>Compose Use Explained</TITLE>
18902 </HEAD>
18903 <BODY>
18904 <H1>Compose Use Explained</H1>
18905
18906 This option determines how this particular role will be used when Composing
18907 a new message using the &quot;Compose&quot; command.
18908 This does not affect what happens when using the &quot;Role&quot; command
18909 to compose a new message.
18910 The &quot;Role&quot; command allows you to select a role from all of the
18911 roles you have defined, regardless of what Uses you've assigned to those
18912 roles.
18913 <P>
18914
18915 There are three possible values for this option.
18916 The value &quot;Never&quot;
18917 means that this role will not be a candidate for use when Composing.
18918 The role's Current Folder Type will not be checked for a match, however the role
18919 will be available to be manually switched to if there is a confirmation prompt.
18920 <P>
18921
18922 The options &quot;With confirmation&quot; and &quot;Without confirmation&quot;
18923 mean that you do want to consider this role when Composing.
18924 For either of these settings,
18925 the role's Current Folder Type will be checked (since there is no message
18926 to compare with, the rest of the Pattern is considered a match).
18927 If there is a match then this role will either be used without confirmation
18928 or will be the default when confirmation is asked for, depending on
18929 which of the two options is selected.
18930 If confirmation is requested, you will also have a chance to
18931 manually change the role to any one of your other roles.
18932 <P>
18933
18934 When using the Compose command the role checking is a little different
18935 because there is no message being replied to or forwarded.
18936 Because of this the Current Folder Type is checked but the header pattern
18937 fields, the AllText pattern, the BodyText pattern, and the Score Interval are all ignored.
18938 A role is considered to be a match if it is a candidate for Compose Use and
18939 its Current Folder Type matches the currently open folder.
18940 This could be useful if you want to set a role based on the folder you
18941 are reading, or the type of folder you are reading.
18942 <P>
18943
18944 You won't be prompted for confirmation if none of your role Patterns
18945 are a match.
18946 This is independent of the value of the current option.
18947 The <A HREF="h_config_confirm_role"><!--#echo var="FEAT_confirm-role-even-for-default"--></A>
18948 feature may be used to change this behavior.
18949 <P>
18950 &lt;End of help on this topic&gt;
18951 </BODY>
18952 </HTML>
18953 ======= h_config_filter_folder =======
18954 <HTML>
18955 <HEAD>
18956 <TITLE>Filter Folder Explained</TITLE>
18957 </HEAD>
18958 <BODY>
18959 <H1>Filter Folder Explained</H1>
18960
18961 When the Filter Action is set to &quot;Move&quot;,
18962 the folder or folders specified here will be used to store messages matching
18963 the provided pattern.
18964
18965 <P>
18966 If you set the Filter Action to &quot;Move&quot; you must give a folder name
18967 here.
18968
18969 <P>
18970 If you wish,
18971 you may choose a folder from your folder collections by using the
18972 &quot;T&quot; command.
18973 <P>
18974 Besides regular text, the folder name may also contain
18975 tokens that are replaced with text representing the current date
18976 when you run Alpine.
18977 For example, if the folder name you use is
18978 <P>
18979 <CENTER><SAMP>abc-_CURYEAR_-_CURMONTHABBREV_</SAMP></CENTER>
18980 <P>
18981 that is replaced with something like
18982 <P>
18983 <CENTER><SAMP>abc-2004-oct</SAMP></CENTER>
18984 <P>
18985 Or,
18986 <P>
18987 <CENTER><SAMP>abc-_CURYEAR2DIGIT_-_CURMONTH2DIGIT_</SAMP></CENTER>
18988 <P>
18989 becomes
18990 <P>
18991 <CENTER><SAMP>abc-04-10</SAMP></CENTER>
18992 <P>
18993 The token names must be surrounded by underscores in order to be recognized
18994 as tokens.
18995 The tokens that may be used are those that are derived from the current date.
18996 They're listed near the bottom of the list of tokens give
18997 <A HREF="h_index_tokens">here</A>.
18998 <P>
18999 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
19000 for more information on Patterns.
19001 <P>
19002 Look <A HREF="h_edit_nav_cmds">here</A>
19003 to see the available Editing and Navigation commands.
19004 <P>
19005 &lt;End of help on this topic&gt;
19006 </BODY>
19007 </HTML>
19008 ======= h_config_filter_kw_set =======
19009 <HTML>
19010 <HEAD>
19011 <TITLE>Set These Keywords Explained</TITLE>
19012 </HEAD>
19013 <BODY>
19014 <H1>Set These Keywords Explained</H1>
19015
19016 This describes part of the action to be taken if the Pattern for this
19017 filter is a match.
19018 Read a little about keywords in the help text for the
19019 <A HREF="h_common_flag">Flag</A> command.
19020 This option is a list of keywords that will be Set when there is a match.
19021 If you wish, you may choose keywords from the list of keywords you have
19022 defined with the &quot;T&quot; command.
19023 You may add new keywords by defining them in the
19024 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in the Setup/Config screen.
19025 If you have given a keyword a nickname when configuring it,
19026 that nickname may be used instead of the actual keyword.
19027
19028 <P>
19029 Look <A HREF="h_edit_nav_cmds">here</A>
19030 to see the available Editing and Navigation commands.
19031 <P>
19032 &lt;End of help on this topic&gt;
19033 </BODY>
19034 </HTML>
19035 ======= h_config_filter_kw_clr =======
19036 <HTML>
19037 <HEAD>
19038 <TITLE>Clear These Keywords Explained</TITLE>
19039 </HEAD>
19040 <BODY>
19041 <H1>Clear These Keywords Explained</H1>
19042
19043 This describes part of the action to be taken if the Pattern for this
19044 filter is a match.
19045 Read a little about keywords in the help text for the
19046 <A HREF="h_common_flag">Flag</A> command.
19047 This option is a list of keywords that will be Cleared when there is a match.
19048 If you wish, you may choose keywords from the list of keywords you have
19049 defined with the &quot;T&quot; command.
19050 You may add new keywords by defining them in the
19051 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in the Setup/Config screen.
19052 If you have given a keyword a nickname when configuring it,
19053 that nickname may be used instead of the actual keyword.
19054
19055 <P>
19056 Look <A HREF="h_edit_nav_cmds">here</A>
19057 to see the available Editing and Navigation commands.
19058 <P>
19059 &lt;End of help on this topic&gt;
19060 </BODY>
19061 </HTML>
19062 ======= h_index_tokens =======
19063 <HTML>
19064 <HEAD>
19065 <TITLE>Tokens for Index and Replying</TITLE>
19066 </HEAD>
19067 <BODY>
19068
19069 This set of special tokens may be used in the
19070 <A HREF="h_config_index_format">&quot;<!--#echo var="VAR_index-format"-->&quot;</A> option,
19071 in the <A HREF="h_config_reply_intro">&quot;<!--#echo var="VAR_reply-leadin"-->&quot;</A> option,
19072 in signature files,
19073 in template files used in
19074 <A HREF="h_rules_roles">&quot;roles&quot;</A>, and in the folder name
19075 that is the target of a Filter Rule.
19076 Some of them aren't available in all situations.
19077 <P>
19078 The tokens are used as they appear below for the &quot;<!--#echo var="VAR_index-format"-->&quot;
19079 option, but they must be surrounded by underscores for the
19080 &quot;<!--#echo var="VAR_reply-leadin"-->&quot; option, in signature and template files,
19081 and in the target of Filter Rules.
19082 <P>
19083 <P>
19084
19085 <H1><EM>Tokens Available for all Cases (except Filter Rules)</EM></H1>
19086
19087 <DL>
19088 <DT>SUBJECT</DT>
19089 <DD>
19090 This token represents the Subject the sender gave the message.
19091 Alternatives for use in the index screen are SHORTSUBJECT,
19092 SUBJKEY, SHORTSUBJKEY, SUBJKEYINIT, SHORTSUBJKEYINIT, SUBJECTTEXT,
19093 SUBJKEYTEXT, and SUBJKEYINITTEXT.
19094 You may color the subject text in the MESSAGE INDEX screen differently by using the
19095 <A HREF="h_config_index_subject_color">Index Subject Color</A> and the
19096 <A HREF="h_config_index_opening_color">Index Opening Color</A>
19097 options available from
19098 the <A HREF="h_color_setup">Setup Kolor</A> screen.
19099 </DD>
19100
19101 <DT>FROM</DT>
19102 <DD>
19103 This token represents the personal name (or email address if the name
19104 is unavailable) of the person specified in the message's &quot;From:&quot;
19105 header field.
19106 You may color the from text in the MESSAGE INDEX screen differently by using the
19107 <A HREF="h_config_index_from_color">Index From Color</A>
19108 option available from
19109 the <A HREF="h_color_setup">Setup Kolor</A> screen.
19110 </DD>
19111
19112 <DT>ADDRESS</DT>
19113 <DD>
19114 This is similar to the &quot;FROM&quot; token, only it is always the
19115 email address, never the personal name.
19116 For example, &quot;mailbox@domain&quot;.
19117 </DD>
19118
19119 <DT>MAILBOX</DT>
19120 <DD>
19121 This is the same as the &quot;ADDRESS&quot; except that the
19122 domain part of the address is left off.
19123 For example, &quot;mailbox&quot;.
19124 </DD>
19125
19126 <DT>SENDER</DT>
19127 <DD>
19128 This token represents the personal name (or email address) of the person
19129 listed in the message's &quot;Sender:&quot; header field.
19130 </DD>
19131
19132 <DT>TO</DT>
19133 <DD>
19134 This token represents the personal names (or email addresses if the names
19135 are unavailable) of the persons specified in the
19136 message's &quot;To:&quot; header field.
19137 </DD>
19138
19139 <DT>NEWSANDTO</DT>
19140 <DD>
19141 This token represents the newsgroups from the
19142 message's &quot;Newsgroups:&quot; header field <EM>and</EM>
19143 the personal names (or email addresses if the names
19144 are unavailable) of the persons specified in the
19145 message's &quot;To:&quot; header field.
19146 </DD>
19147
19148 <DT>TOANDNEWS</DT>
19149 <DD>
19150 Same as &quot;NEWSANDTO&quot; except in the opposite order.
19151 </DD>
19152
19153 <DT>NEWS</DT>
19154 <DD>
19155 This token represents the newsgroups from the
19156 message's &quot;Newsgroups:&quot; header field.
19157 </DD>
19158
19159 <DT>CC</DT>
19160 <DD>
19161 This token represents the personal names (or email addresses if the names
19162 are unavailable) of the persons specified in the
19163 message's &quot;Cc:&quot; header field.
19164 </DD>
19165
19166 <DT>RECIPS</DT>
19167 <DD>
19168 This token represents the personal names (or email addresses if the names
19169 are unavailable) of the persons specified in both the
19170 message's &quot;To:&quot; header field and
19171 the message's &quot;Cc:&quot; header field.
19172 </DD>
19173
19174 <DT>NEWSANDRECIPS</DT>
19175 <DD>
19176 This token represents the newsgroups from the
19177 message's &quot;Newsgroups:&quot; header field <EM>and</EM>
19178 the personal names (or email addresses if the names
19179 are unavailable) of the persons specified in the
19180 message's &quot;To:&quot; and &quot;Cc:&quot; header fields.
19181 </DD>
19182
19183 <DT>RECIPSANDNEWS</DT>
19184 <DD>
19185 Same as &quot;NEWSANDRECIPS&quot; except in the opposite order.
19186 </DD>
19187
19188 <DT>INIT</DT>
19189 <DD>
19190 This token represents the initials from the personal name
19191 of the person specified in the message's &quot;From:&quot;
19192 header field.
19193 If there is no personal name, it is blank.
19194 </DD>
19195
19196 <DT>DATE</DT>
19197 <DD>
19198 This token represents the date on which the message was sent, according
19199 to the &quot;Date&quot; header field.
19200 It has the format MMM DD. For example, &quot;Oct 23&quot;.
19201 The feature
19202 <A HREF="h_config_dates_to_local"><!--#echo var="FEAT_convert-dates-to-localtime"--></A>,
19203 which adjusts for the timezone the message was sent from,
19204 may have an effect on the value of this token as well as the values of
19205 all of the other DATE or TIME tokens.
19206 Some of the DATE and TIME tokens are displayed in a locale-specific
19207 way unless the option
19208 <A HREF="h_config_disable_index_locale_dates"><!--#echo var="FEAT_disable-index-locale-dates"--></A> is set.
19209 </DD>
19210
19211 <DT>SMARTDATE</DT>
19212 <DD>
19213 This token represents the date on which the message was sent, according
19214 to the &quot;Date&quot; header field.
19215 It is &quot;Today&quot; if the message was sent today,
19216 &quot;Yesterday&quot; for yesterday,
19217 &quot;Wednesday&quot; if it was last Wednesday, and so on. If the
19218 message is from last year and is more than six months old it includes the year, as well.
19219 See the SMARTDATE alternatives below, as well.
19220 </DD>
19221
19222 <DT>SMARTTIME</DT>
19223 <DD>
19224 This token represents the most relevant elements of the date on which
19225 the message was sent (according to the &quot;Date&quot; header field),
19226 in a compact form. If the message was sent today, only the time is used
19227 (e.g. &quot;9:22am&quot;, &quot;10:07pm&quot;); if it was sent during
19228 the past week, the day of the week and the hour are used
19229 (e.g. &quot;Wed09am&quot;, &quot;Thu10pm&quot;); other dates are
19230 given as date, month, and year (e.g. &quot;23Aug00&quot;,
19231 &quot;9Apr98&quot;).
19232 </DD>
19233
19234 <DT>SMARTTIME24</DT>
19235 <DD>
19236 This token has the structure &quot;day hour:minute&quot;
19237 (e.g. &quot;Sun 19:03&quot;) for messages dated less than a week
19238 from the current date, or &quot;month day&quot; (e.g.
19239 &quot;Nov 23&quot;) for messages dated less than 6 months
19240 ago, or &quot;day/month/year&quot; (e.g &quot;06/Jan/16&quot;)
19241 for messages dated more than 6 months ago. It uses 9 characters
19242 of the width of the screen, and it left aligned.
19243 </DD>
19244
19245 <DT>SMARTDATETIME</DT>
19246 <DD>
19247 This is a combination of SMARTDATE and SMARTTIME.
19248 It is SMARTDATE unless the SMARTDATE value is &quot;Today&quot;, in which
19249 case it is SMARTTIME.
19250 See the SMARTDATETIME alternatives below, as well.
19251 </DD>
19252
19253 <DT>DATEISO</DT>
19254 <DD>
19255 This token represents the date on which the message was sent, according
19256 to the &quot;Date&quot; header field.
19257 It has the format YYYY-MM-DD. For example, &quot;1998-10-23&quot;.
19258 </DD>
19259
19260 <DT>SHORTDATEISO</DT>
19261 <DD>
19262 This token represents the date on which the message was sent, according
19263 to the &quot;Date&quot; header field.
19264 It has the format YY-MM-DD. For example, &quot;98-10-23&quot;.
19265 </DD>
19266
19267 <DT>SHORTDATE1</DT>
19268 <DD>
19269 This token represents the date on which the message was sent, according
19270 to the &quot;Date&quot; header field.
19271 It has the format MM/DD/YY. For example, &quot;10/23/98&quot;.
19272 </DD>
19273
19274 <DT>SHORTDATE2</DT>
19275 <DD>
19276 This token represents the date on which the message was sent, according
19277 to the &quot;Date&quot; header field.
19278 It has the format DD/MM/YY. For example, &quot;23/10/98&quot;.
19279 </DD>
19280
19281 <DT>SHORTDATE3</DT>
19282 <DD>
19283 This token represents the date on which the message was sent, according
19284 to the &quot;Date&quot; header field.
19285 It has the format DD.MM.YY. For example, &quot;23.10.98&quot;.
19286 </DD>
19287
19288 <DT>SHORTDATE4</DT>
19289 <DD>
19290 This token represents the date on which the message was sent, according
19291 to the &quot;Date&quot; header field.
19292 It has the format YY.MM.DD. For example, &quot;98.10.23&quot;.
19293 </DD>
19294
19295 <DT>LONGDATE</DT>
19296 <DD>
19297 This token represents the date on which the message was sent, according
19298 to the &quot;Date&quot; header field.
19299 It has the format MMM DD, YYYY. For example, &quot;Oct 23, 1998&quot;.
19300 </DD>
19301
19302 <DT>SMARTDATE alternatives</DT>
19303 <DD>
19304 There are several versions of SMARTDATE that are all the same except
19305 for the way they format dates far in the past.
19306 SMARTDATE formats the date using the information from your locale settings
19307 to format the date string. It may end up formatting dates so that they look
19308 like DATEISO tokens, or SHORTDATE2 tokens, or something else entirely.
19309 The feature
19310 <A HREF="h_config_dates_to_local"><!--#echo var="FEAT_convert-dates-to-localtime"--></A>
19311 may have an effect on the values of these tokens.
19312 If you want more control you may use one of the following.
19313   <DL>
19314   <DT>SMARTDATE</DT> <DD>If the option
19315 <A HREF="h_config_disable_index_locale_dates"><!--#echo var="FEAT_disable-index-locale-dates"--></A> is not set
19316 then this will be locale specific. Control this with the
19317 LC_TIME locale setting on a UNIX system. On Windows
19318 the Regional Options control panel may be used to set the Short date
19319 format. At the programming level, the strftime routine is what Alpine
19320 uses to print the date.
19321 If the <!--#echo var="FEAT_disable-index-locale-dates"--> option is set then this is equivalent
19322 to SMARTDATES1.</DD>
19323   <DT>SMARTDATEISO</DT> <DD>DATEISO format. See text above.</DD>
19324   <DT>SMARTDATESHORTISO</DT> <DD>SHORTDATEISO format.</DD>
19325   <DT>SMARTDATES1</DT> <DD>SHORTDATE1 format.</DD>
19326   <DT>SMARTDATES2</DT> <DD>SHORTDATE2 format.</DD>
19327   <DT>SMARTDATES3</DT> <DD>SHORTDATE3 format.</DD>
19328   <DT>SMARTDATES4</DT> <DD>SHORTDATE4 format.</DD>
19329   </DL>
19330 </DD>
19331
19332 <DT>SMARTDATETIME alternatives</DT>
19333 <DD>
19334 There are several versions of SMARTDATETIME that are all very similar.
19335 The ones that end in 24 use a 24-hour clock for Today's messages instead
19336 of a 12-hour clock.
19337 The other variation is
19338 for the way they format dates far in the past.
19339 SMARTDATETIME and SMARTDATETIME24 format the date using the information from your locale settings
19340 to format the date string. It may end up formatting dates so that they look
19341 like DATEISO tokens, or SHORTDATE2 tokens, or something else entirely.
19342 The feature
19343 <A HREF="h_config_dates_to_local"><!--#echo var="FEAT_convert-dates-to-localtime"--></A>
19344 may have an effect on the values of these tokens.
19345 The possible choices are:
19346   <DL>
19347   <DT>SMARTDATETIME</DT> <DD>If the option
19348 <A HREF="h_config_disable_index_locale_dates"><!--#echo var="FEAT_disable-index-locale-dates"--></A> is not set
19349 then this will be locale specific. Control this with the
19350 LC_TIME locale setting on a UNIX system. On Windows
19351 the Regional Options control panel may be used to set the Short date
19352 format. At the programming level, the strftime routine is what Alpine
19353 uses to print the date.
19354 If the <!--#echo var="FEAT_disable-index-locale-dates"--> option is set then this is equivalent
19355 to SMARTDATETIMES1.</DD>
19356   <DT>SMARTDATETIME24</DT> <DD>Use TIME24 for Today</DD>
19357   <DT>SMARTDATETIMEISO</DT> <DD>DATEISO format. See text above.</DD>
19358   <DT>SMARTDATETIMEISO24</DT> <DD>Use TIME24 for Today</DD>
19359   <DT>SMARTDATETIMESHORTISO</DT> <DD>SHORTDATEISO format.</DD>
19360   <DT>SMARTDATETIMESHORTISO24</DT> <DD>Use TIME24 for Today</DD>
19361   <DT>SMARTDATETIMES1</DT> <DD>SHORTDATE1 format.</DD>
19362   <DT>SMARTDATETIMES124</DT> <DD>Use TIME24 for Today</DD>
19363   <DT>SMARTDATETIMES2</DT> <DD>SHORTDATE2 format.</DD>
19364   <DT>SMARTDATETIMES224</DT> <DD>Use TIME24 for Today</DD>
19365   <DT>SMARTDATETIMES3</DT> <DD>SHORTDATE3 format.</DD>
19366   <DT>SMARTDATETIMES324</DT> <DD>Use TIME24 for Today</DD>
19367   <DT>SMARTDATETIMES4</DT> <DD>SHORTDATE4 format.</DD>
19368   <DT>SMARTDATETIMES424</DT> <DD>Use TIME24 for Today</DD>
19369   </DL>
19370 </DD>
19371
19372 <DT>DAYDATE</DT>
19373 <DD>
19374 This token represents the date on which the message was sent, according
19375 to the &quot;Date&quot; header field.
19376 It looks like &quot;Sat, 23 Oct 1998&quot;.
19377 This token is never converted in any locale-specific way.
19378 </DD>
19379
19380 <DT>PREFDATE</DT>
19381 <DD>
19382 This token represents the date on which the message was sent, according
19383 to the &quot;Date&quot; header field.
19384 It is your operating system's idea of the preferred date representation for the current locale.
19385 Internally it uses the %x version of the date from the strftime routine.
19386 </DD>
19387
19388 <DT>PREFTIME</DT>
19389 <DD>
19390 This token represents the time at which the message was sent, according
19391 to the &quot;Date&quot; header field.
19392 It is the preferred time representation for the current locale.
19393 Internally it uses the %X version of the time from the strftime routine.
19394 </DD>
19395
19396 <DT>PREFDATETIME</DT>
19397 <DD>
19398 This token represents the date and time at which the message was sent, according
19399 to the &quot;Date&quot; header field.
19400 It is the preferred date and time representation for the current locale.
19401 Internally it uses the %c version of the time from the strftime routine.
19402 </DD>
19403
19404 <DT>DAY</DT>
19405 <DD>
19406 This token represents the day of the month on which the message was sent,
19407 according to the &quot;Date&quot; header field.
19408 For example, &quot;23&quot; or &quot;9&quot;.
19409 </DD>
19410
19411 <DT>DAY2DIGIT</DT>
19412 <DD>
19413 This token represents the day of the month on which the message was sent,
19414 according to the &quot;Date&quot; header field.
19415 For example, &quot;23&quot; or &quot;09&quot;.
19416 It is always 2 digits.
19417 </DD>
19418
19419 <DT>DAYORDINAL</DT>
19420 <DD>
19421 This token represents the ordinal number that is the day of
19422 the month on which the message was sent,
19423 according to the &quot;Date&quot; header field.
19424 For example, &quot;23rd&quot; or &quot;9th&quot;.
19425 </DD>
19426
19427 <DT>DAYOFWEEK</DT>
19428 <DD>
19429 This token represents the day of the week on which the message was sent,
19430 according to the &quot;Date&quot; header field.
19431 For example, &quot;Sunday&quot; or &quot;Wednesday&quot;.
19432 </DD>
19433
19434 <DT>DAYOFWEEKABBREV</DT>
19435 <DD>
19436 This token represents the day of the week on which the message was sent,
19437 according to the &quot;Date&quot; header field.
19438 For example, &quot;Sun&quot; or &quot;Wed&quot;.
19439 </DD>
19440
19441 <DT>MONTHABBREV</DT>
19442 <DD>
19443 This token represents the month the message was sent, according
19444 to the &quot;Date&quot; header field.
19445 For example, &quot;Oct&quot;.
19446 </DD>
19447
19448 <DT>MONTHLONG</DT>
19449 <DD>
19450 This token represents the month in which the message was sent, according
19451 to the &quot;Date&quot; header field.
19452 For example, &quot;October&quot;.
19453 </DD>
19454
19455 <DT>MONTH</DT>
19456 <DD>
19457 This token represents the month in which the message was sent, according
19458 to the &quot;Date&quot; header field.
19459 For example, &quot;10&quot; or &quot;9&quot;.
19460 </DD>
19461
19462 <DT>MONTH2DIGIT</DT>
19463 <DD>
19464 This token represents the month in which the message was sent, according
19465 to the &quot;Date&quot; header field.
19466 For example, &quot;10&quot; or &quot;09&quot;.
19467 It is always 2 digits.
19468 </DD>
19469
19470 <DT>YEAR</DT>
19471 <DD>
19472 This token represents the year the message was sent, according
19473 to the &quot;Date&quot; header field.
19474 For example, &quot;1998&quot; or &quot;2001&quot;.
19475 </DD>
19476
19477 <DT>YEAR2DIGIT</DT>
19478 <DD>
19479 This token represents the year the message was sent, according
19480 to the &quot;Date&quot; header field.
19481 For example, &quot;98&quot; or &quot;01&quot;.
19482 It is always 2 digits.
19483 </DD>
19484
19485 <DT>TIME24</DT>
19486 <DD>
19487 This token represents the time at which the message was sent, according
19488 to the &quot;Date&quot; header field.
19489 There is no adjustment made for different time zones, so you'll get
19490 the time the message was sent according to the time zone the sender
19491 was in.
19492 It has the format HH:MM. For example, &quot;17:28&quot;.
19493 </DD>
19494
19495 <DT>TIME12</DT>
19496 <DD>
19497 This token represents the time at which the message was sent, according
19498 to the &quot;Date&quot; header field.
19499 This time is for a 12 hour clock.
19500 It has the format HH:MMpm.
19501 For example, &quot;5:28pm&quot; or &quot;11:13am&quot;.
19502 </DD>
19503
19504 <DT>TIMEZONE</DT>
19505 <DD>
19506 This token represents the numeric timezone from
19507 the &quot;Date&quot; header field.
19508 It has the format [+-]HHMM. For example, &quot;-0800&quot;.
19509 </DD>
19510
19511 </DL>
19512
19513 <P>
19514 <H1><EM>Tokens Available Only for <!--#echo var="VAR_index-format"--></EM></H1>
19515
19516 <DL>
19517 <DT>MSGNO</DT>
19518 <DD>
19519 This token represents the message's current position in the folder that,
19520 of course, may change as the folder is sorted or new mail arrives.
19521 </DD>
19522
19523 <DT>STATUS</DT>
19524 <DD>
19525 This token represents a three character wide field displaying various
19526 aspects of the message's state.
19527 The first character is either blank,
19528 a '*' for message marked Important, or a '+' indicating a message
19529 addressed directly to you (as opposed to your having received it via a
19530 mailing list, for example).
19531 When the feature
19532 &quot;<A HREF="h_config_mark_for_cc"><!--#echo var="FEAT_mark-for-cc"--></A>&quot;
19533 is set, if the first character would have been
19534 blank then it will instead be a '-' if the message is cc'd to you.
19535 The second character is typically blank,
19536 though the arrow cursor may occupy it if either the
19537 &quot;<A HREF="h_config_force_low_speed"><!--#echo var="FEAT_assume-slow-link"--></A>&quot;
19538 or the
19539 &quot;<A HREF="h_config_force_arrow"><!--#echo var="FEAT_force-arrow-cursor"--></A>&quot; feature
19540 is set (or you actually are on a slow link).
19541 The third character is either '<A HREF="h_flag_deleted">D</A>' (Deleted),
19542 '<A HREF="h_flag_answered">A</A>' (Answered),
19543 '<A HREF="h_flag_forwarded">F</A>' (Forwarded),
19544 '<A HREF="h_flag_new">N</A>' (New), or blank.
19545 <P>
19546 If you are using a threaded view of the index and this message is at the
19547 top of a collapsed portion of a thread,
19548 then this token refers to all of the messages in the collapsed portion of
19549 the thread instead of just the top message.
19550 The first character will be a '*' if <EM>any</EM> of the messages in the thread
19551 are marked Important, else a '+' if any of the messages are addressed
19552 to you, else a '-' if any of the messages are cc'd to you.
19553 The third character will be a 'D' if <EM>all</EM> of the messages
19554 in the collapsed thread are marked deleted,
19555 an 'A' if <EM>all</EM> of the messages
19556 in the collapsed thread are marked answered,
19557 it will be an 'N' if any of
19558 the messages are undeleted and unseen, and it will be blank otherwise.
19559 </DD>
19560
19561 <DT>FULLSTATUS</DT>
19562 <DD>
19563 This token represents a less abbreviated alternative
19564 to the &quot;STATUS&quot; token.
19565 It is six characters wide.
19566 The first character is '+', '-', or blank, the
19567 second blank, the third either '*' or blank, the fourth
19568 '<A HREF="h_flag_new">N</A>' or blank,
19569 the fifth '<A HREF="h_flag_answered">A</A>'
19570 or blank, and the sixth character is
19571 either '<A HREF="h_flag_deleted">D</A>' or
19572 blank.
19573 <P>
19574 If you are using a threaded view of the index and this message is at the
19575 top of a collapsed portion of a thread,
19576 then this token refers to all of the messages in the collapsed portion of
19577 the thread instead of just the top message.
19578 The first character is '+', '-', or blank depending on whether <EM>any</EM>
19579 of the messages in the collapsed thread are addressed to you or cc'd to you.
19580 The third character will be '*' if any of the messages are marked
19581 Important.
19582 The fourth character will be 'N' if all of the messages in the thread
19583 are New, else 'n' if some of the messages in the thread are New, else blank.
19584 The fifth character will be 'A' or 'a' or blank, and the sixth character
19585 will be 'D' or 'd' or blank.
19586 </DD>
19587
19588 <DT>IMAPSTATUS</DT>
19589 <DD>
19590 This token represents an even less abbreviated alternative to the
19591 &quot;STATUS&quot; token.
19592 It differs from &quot;FULLSTATUS&quot; in only the fourth character, which is
19593 an 'N' if the message is new to this folder since the last time
19594 it was opened <EM>and</EM> it has not been viewed, an 'R' (Recent) if the message
19595 is new to the folder and has been viewed, a 'U' (Unseen) if the message is not
19596 new to the folder since it was last opened <EM>but</EM> has not been
19597 viewed, or a blank if the message has been in the folder since it was
19598 last opened and has been viewed.
19599 <P>
19600 If you are using a threaded view of the index and this message is at the
19601 top of a collapsed portion of a thread,
19602 then the fourth character will be
19603 'N' if all of the messages in the thread are unseen and recent;
19604 else 'n' if some of the messages in the thread are unseen and recent;
19605 else 'U' if all of the messages in the thread are unseen and not recent;
19606 else 'u' if some of the messages in the thread are unseen and not recent;
19607 else 'R' if all of the messages in the thread are seen and recent;
19608 else 'r' if some of the messages in the thread are seen and recent;
19609 else blank.
19610 </DD>
19611
19612 <DT>SHORTIMAPSTATUS</DT>
19613 <DD>
19614 This is the same as the last four of the six characters of IMAPSTATUS,
19615 so the '+' To Me information will be missing.
19616 </DD>
19617
19618 <DT>SIZE</DT>
19619 <DD>
19620 This token represents the total size, in bytes, of the message.
19621 If a &quot;K&quot; (Kilobyte)
19622 follows the number, the size is approximately 1,000
19623 times that many bytes (rounded to the nearest 1,000).
19624 If an &quot;M&quot; (Megabyte) follows the number, the size is approximately
19625 1,000,000 times that many bytes.
19626 Commas are not used in this field.
19627 This field is seven characters wide, including the enclosing parentheses.
19628 Sizes are rounded when &quot;K&quot; or &quot;M&quot; is present.
19629 The progression of sizes used looks like:
19630
19631 <P>
19632 <CENTER><SAMP>0 1 ... 9999 10K ... 999K 1.0M ... 99.9M 100M ... 2000M</SAMP></CENTER>
19633 <P>
19634 </DD>
19635
19636 <DT>SIZECOMMA</DT>
19637 <DD>
19638 This token represents the total size, in bytes, of the message.
19639 If a &quot;K&quot; (Kilobyte)
19640 follows the number, the size is approximately 1,000
19641 times that many bytes (rounded to the nearest 1,000).
19642 If an &quot;M&quot; (Megabyte) follows the number, the size is approximately
19643 1,000,000 times that many bytes.
19644 Commas are used if the number shown is 1,000 or greater.
19645 The SIZECOMMA field is one character wider than the SIZE field.
19646 Sizes are rounded when &quot;K&quot; or &quot;M&quot; is present.
19647 The progression of sizes used looks like:
19648
19649 <P>
19650 <CENTER><SAMP>0 1 ... 99,999 100K ... 9,999K 10.0M ... 999.9M 1,000M ... 2,000M</SAMP></CENTER>
19651 <P>
19652 </DD>
19653
19654 <DT>KSIZE</DT>
19655 <DD>
19656 This token represents the total size of the message, expressed in
19657 kilobytes or megabytes, as most appropriate.
19658 These are 1,024 byte kilobytes and 1,024 x 1,024 byte megabytes.
19659 The progression of sizes used looks like:
19660
19661 <P>
19662 <CENTER><SAMP>0K 1K ... 1023K 1.0M ... 99.9M 100M ... 2047M</SAMP></CENTER>
19663 <P>
19664 </DD>
19665
19666 <DT>SIZENARROW</DT>
19667 <DD>
19668 This token represents the total size, in bytes, of the message.
19669 If a &quot;K&quot; (Kilobyte)
19670 follows the number, the size is approximately 1,000
19671 times that many bytes.
19672 If an &quot;M&quot; (Megabyte) follows the number, the size is approximately
19673 1,000,000 times that many bytes.
19674 If a &quot;G&quot; (Gigabyte) follows the number, the size is approximately
19675 1,000,000,000 times that many bytes.
19676 This field uses only five characters of screen width, including the enclosing
19677 parentheses.
19678 The progression of sizes used looks like:
19679
19680 <P>
19681 <CENTER><SAMP>0 1 ... 999 1K ... 99K .1M ... .9M 1M ... 99M .1G ... .9G 1G 2G</SAMP></CENTER>
19682 <P>
19683 </DD>
19684
19685 <DT>DESCRIPSIZE</DT>
19686 <DD>
19687 This token is intended to represent a more useful description of the
19688 message than just its size, but it isn't very useful at this point.
19689 The plus sign in this view means there are attachments.
19690 Note that including this token in
19691 the &quot;<!--#echo var="VAR_index-format"-->&quot; could slow down the
19692 display a little while Alpine collects the necessary information.
19693 </DD>
19694
19695 <DT>SHORTSUBJECT</DT>
19696 <DD> This token is the same as SUBJECT, but removes
19697 text between &quot;[&quot; and &quot;]&quot;. Typically text enclosed
19698 between these characters corresponds to mailing list names, and may be
19699 unnecessary or unwanted in some instances.
19700 </DD>
19701
19702 <DT>SUBJKEY</DT>
19703 <DD>
19704 This token is the same as the SUBJECT token unless keywords are set for
19705 the message.
19706 In that case, a list of keywords enclosed in braces will be prepended to
19707 the subject of the message.
19708 Only those keywords that you have defined in your
19709 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option
19710 in Setup/Config are considered in the list.
19711 In other words, keywords that have been set by some other means, perhaps
19712 by another email program, won't show up unless included in
19713 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>.
19714 Having this set in the <!--#echo var="VAR_index-format"--> will also cause the keywords to be
19715 prepended to the subject in the MESSAGE TEXT screen.
19716 If you have given a keyword a nickname
19717 (<A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>), that nickname is displayed
19718 instead of the actual keyword.
19719 The <A HREF="h_config_kw_braces"><!--#echo var="VAR_keyword-surrounding-chars"--></A>
19720 option may be used to modify this token slightly.
19721 It is also possible to color keywords in the index using the
19722 Setup/Kolor screen (<A HREF="h_config_kw_color">Keyword Colors</A>).
19723 </DD>
19724
19725 <DT>SHORTSUBJKEY</DT>
19726 <DD> This token is the same as SUBJKEY, but it is based on
19727 SHORTSUBJECT, instead of in SUBJECT.
19728 </DD>
19729
19730 <DT>SUBJKEYINIT</DT>
19731 <DD>
19732 This token is the same as the SUBJKEY token except that instead of
19733 prepending a list of keywords to the subject, a list of first initials
19734 of keywords will be prepended instead.
19735 For example, if a message has the keywords <EM>Work</EM> and <EM>Now</EM>
19736 set (or Work and Now are the Alpine nicknames of keywords that are set)
19737 then the SUBJKEY token would cause a result like
19738 <P>
19739 <CENTER><SAMP>{Work Now} actual subject</SAMP></CENTER>
19740 <P>
19741 whereas the SUBJKEYINIT token would give
19742 <P>
19743 <CENTER><SAMP>{WN} actual subject</SAMP></CENTER>
19744 <P>
19745 Only those keywords that you have defined in your
19746 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option
19747 in Setup/Config are considered in the list.
19748 In other words, keywords that have been set by some other means, perhaps
19749 by another email program, won't show up unless included in
19750 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>.
19751 The <A HREF="h_config_kw_braces"><!--#echo var="VAR_keyword-surrounding-chars"--></A>
19752 option may be used to modify this token slightly.
19753 It is also possible to color keywords in the index using the
19754 Setup/Kolor screen (<A HREF="h_config_kw_color">Keyword Colors</A>).
19755 </DD>
19756
19757 <DT>SHORTSUBJKEYINIT</DT>
19758 <DD> This token is the same as SUBJKEYINIT, but it is based on
19759 SHORTSUBJECT, instead of in SUBJECT.
19760 </DD>
19761
19762 <DT>SUBJECTTEXT</DT>
19763 <DD>
19764 Same as SUBJECT but if there is room in the Subject field for more text,
19765 the opening part of the text of the message is displayed after the subject.
19766 The time needed to fetch the text may cause a performance problem
19767 which can, of course, be avoided by using the SUBJECT version of
19768 the Subject instead.
19769 You may color this opening text differently by using the
19770 <A HREF="h_config_index_opening_color">Index Opening Color</A> option available from
19771 the <A HREF="h_color_setup">Setup Kolor</A> screen.
19772 You may adjust the characters that are displayed between the Subject and the
19773 opening text with the option
19774 <A HREF="h_config_opening_sep"><!--#echo var="VAR_opening-text-separator-chars"--></A>.
19775 </DD>
19776
19777 <DT>SUBJKEYTEXT</DT>
19778 <DD>
19779 Same as SUBJKEY but with the opening message text.
19780 </DD>
19781
19782 <DT>OPENINGTEXT</DT>
19783 <DD>
19784 This is similar to SUBJECTTEXT.
19785 Instead of combining the Subject and the opening text in a single
19786 field in the index screen this token allows you to allocate a
19787 separate column just for the opening text of the message.
19788 The time needed to fetch this text may cause a performance problem.
19789 You may color this opening text differently by using the
19790 <A HREF="h_config_index_opening_color">Index Opening Color</A> option available from
19791 the <A HREF="h_color_setup">Setup Kolor</A> screen.
19792 </DD>
19793
19794 <DT>OPENINGTEXTNQ</DT>
19795 <DD>
19796 This is very similar to OPENINGTEXT.
19797 The NQ stands for No Quotes.
19798 The only difference is that quoted text (lines beginning with &gt;) is deleted.
19799 For some messages this may be confusing.
19800 For example, a message might have a line preceding some quoted
19801 text that reads something like &quot;On May 8th person A said.&quot;
19802 That no longer makes sense after the quoted text is deleted and it
19803 will appear that person A said whatever the text after the quote
19804 is, even though that is really person B talking.
19805 </DD>
19806
19807 <DT>SUBJKEYINITTEXT</DT>
19808 <DD>
19809 Same as SUBJKEYINIT but with the opening message text.
19810 </DD>
19811
19812 <DT>KEY</DT>
19813 <DD>
19814 This is a space-delimited list of keywords that are set for the message.
19815 Only those keywords that you have defined in your
19816 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option
19817 in Setup/Config are considered in the list.
19818 In other words, keywords that have been set by some other means, perhaps
19819 by another email program, won't show up unless included in
19820 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>.
19821 If you have given a keyword a nickname
19822 (<A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>), that nickname is displayed
19823 instead of the actual keyword.
19824 It is also possible to color keywords in the index using the
19825 Setup/Kolor screen (<A HREF="h_config_kw_color">Keyword Colors</A>).
19826 This token defaults to an arbitrary width of 5.
19827 You should set it to whatever width suits you using something
19828 like KEY(17) in the <!--#echo var="VAR_index-format"-->.
19829 </DD>
19830
19831 <DT>KEYINIT</DT>
19832 <DD>
19833 This is a list of keyword initials that are set for the message.
19834 If you have given a keyword a nickname
19835 (<A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>), the initial of that nickname
19836 is displayed instead of the initial of the actual keyword.
19837 It is also possible to color keyword initials in the index using the
19838 Setup/Kolor screen (<A HREF="h_config_kw_color">Keyword Colors</A>).
19839 This token defaults to an arbitrary width of 2.
19840 You should set it to whatever width suits you using something
19841 like KEYINIT(3) in the <!--#echo var="VAR_index-format"-->.
19842 </DD>
19843
19844 <DT>PRIORITY</DT>
19845 <DD>
19846 The X-Priority header is a non-standard header that is used in a
19847 somewhat standard way by many mail programs.
19848 Alpine expects the value of this header to be a digit with a value
19849 from 1 to 5, with 1 being the highest priority and 5 the lowest priority.
19850 Since this priority is something that the sender sets it is only an indication
19851 of the priority that the sender attaches to the mail and it is therefore almost
19852 totally unreliable for use as a filtering criterion.
19853 This token will display the numeric value of the priority if it is between
19854 1 and 5.
19855 It will be suppressed (blank) if the value is 3, which is normal priority.
19856 This token may be colored with the
19857 <A HREF="h_config_index_pri_color">Index Priority Symbol Colors</A>.
19858 </DD>
19859
19860 <DT>PRIORITYALPHA</DT>
19861 <DD>
19862 This is a more verbose interpretation of the X-Priority field.
19863 Once again nothing is displayed unless the value of the field
19864 is 1, 2, 4, or 5.
19865 The values displayed for those values are:
19866 <P>
19867 <TABLE>
19868 <TR> <TD>1</TD> <TD>Highest</TD> </TR>
19869 <TR> <TD>2</TD> <TD>High</TD> </TR>
19870 <TR> <TD>4</TD> <TD>Low</TD> </TR>
19871 <TR> <TD>5</TD> <TD>Lowest</TD> </TR>
19872 </TABLE>
19873 <P>
19874 This token may be colored with the
19875 <A HREF="h_config_index_pri_color">Index Priority Symbol Colors</A>.
19876 </DD>
19877
19878 <DT>PRIORITY!</DT>
19879 <DD>
19880 This is a one character, non-numeric version of the X-Priority field.
19881 If the value of the X-Priority header is 1 or 2 an exclamation
19882 point is displayed.
19883 If the value is 4 or 5 a &quot;v&quot; (think down arrow) is displayed.
19884 This token may be colored with the
19885 <A HREF="h_config_index_pri_color">Index Priority Symbol Colors</A>.
19886 </DD>
19887
19888 <DT>ATT</DT>
19889 <DD>
19890 This is a one column wide field that represents the number of attachments
19891 a message has. It will be blank if there are no attachments, a single
19892 digit for one to nine attachments, or an asterisk for more than nine.
19893 Note that including this token in
19894 the &quot;<!--#echo var="VAR_index-format"-->&quot; could slow down the
19895 display a little while Alpine collects the necessary information.
19896 </DD>
19897
19898 <DT>FROMORTO</DT>
19899 <DD>
19900 This token represents <EM>either</EM> the personal name (or email address) of
19901 the person listed in the message's &quot;From:&quot; header
19902 field, <EM>or</EM>, if that address is yours or one of your
19903 <A HREF="h_config_alt_addresses">alternate addresses</A>,
19904 the first person specified in the
19905 message's &quot;To:&quot; header field
19906 with the prefix &quot;To: &quot; prepended.
19907 If the from address is yours and there is also no &quot;To&quot; address,
19908 Alpine will use the address on the &quot;Cc&quot; line.
19909 If there is no address there, either, Alpine will look for a newsgroup name
19910 from the &quot;Newsgroups&quot; header field and put
19911 that after the &quot;To: &quot; prefix.
19912 </DD>
19913
19914 <DT>FROMORTONOTNEWS</DT>
19915 <DD>
19916 This is almost the same as <EM>FROMORTO</EM>.
19917 The difference is that newsgroups aren't considered.
19918 When a message is from you, doesn't have a To or Cc, and does have
19919 a Newsgroups header; this token will be your name instead of the name
19920 of the newsgroup (like it would be with FROMORTO).
19921 </DD>
19922
19923 <DT>TEXT</DT>
19924 <DD>
19925 This is a different sort of token.
19926 It allows you to display a label within each index line.
19927 It will be the same fixed text for each line.
19928 It is different from all the other tokens in that there is no space column
19929 displayed after this token.
19930 Instead, it is butted up against the following field.
19931 It also has a different syntax.
19932 The text to display is given following a colon after the
19933 word &quot;TEXT&quot;.
19934 For example,
19935 <P>
19936 <CENTER><SAMP>TEXT:abc=</SAMP></CENTER>
19937 <P>
19938 would insert the literal text &quot;abc=&quot; (without the quotes)
19939 into the index display line.
19940 You must quote the text if it includes space characters, like
19941 <P>
19942 <CENTER><SAMP>TEXT:&quot;abc&nbsp;=&nbsp;&quot;</SAMP></CENTER>
19943 <P>
19944 </DD>
19945
19946 <DT>HEADER</DT>
19947 <DD>
19948 This allows you to display the text from a particular header line in the
19949 message.
19950 The syntax for this token is substantially different from all the others
19951 in order that you might be able to display a portion of the text following
19952 a particular header.
19953 The header name you are interested in is given following a colon
19954 after the word &quot;HEADER&quot;.
19955 For example,
19956 <P>
19957 <CENTER><SAMP>HEADER:X-Spam</SAMP></CENTER>
19958 <P>
19959 would display the text of the X-Spam header, if any.
19960 Like for other index tokens a width field may (and probably should)
19961 follow this.
19962 <P>
19963 <CENTER><SAMP>HEADER:X-Spam(10)</SAMP></CENTER>
19964 <P>
19965 displays the first ten characters of the X-Spam header.
19966 Unlike other index tokens, the syntax for HEADER is more flexible.
19967 An optional second argument comes after a comma inside the parentheses.
19968 It specifies the &quot;field&quot; number.
19969 By default, the field separator is a space character.
19970 No extra space characters are allowed in the argument list.
19971 <P>
19972 <CENTER><SAMP>HEADER:X-Spam(10,2)</SAMP></CENTER>
19973 <P>
19974 would display the second field, left-justified, in a 10 character
19975 wide field.
19976 The second field would consist of all the text after the first space
19977 up to the next space or the end of the header.
19978 The default field number is zero, which stands for the entire line.
19979 There is also an optional third argument that is a list of field
19980 separators. It defaults to a space character.
19981 The example
19982 <P>
19983 <CENTER><SAMP>HEADER:X-Spam(10,2,:%&nbsp;)</SAMP></CENTER>
19984 <P>
19985 would cause the field separators to be any of colon, percent,
19986 or space (there is a space character between the percent and the
19987 right parenthesis).
19988 The first field runs from the start of the header value up to the first
19989 colon, percent, or space; the second goes from there to the next; and so on.
19990 In order to use a comma character as a field separator you must escape
19991 it by preceding it with a backslash (&#92;).
19992 The same is true of the backslash character itself.
19993 There is one further optional argument.
19994 It is an R or an L to specify right or left adjustment of the text
19995 within the field.
19996 The default is to left justify, however if you are displaying numbers
19997 you might prefer to right justify.
19998 <P>
19999 Here's an example of a SpamAssassin header.
20000 The exact look of the header will vary, but if your incoming mail
20001 contains headers that look like the following
20002 <P>
20003 <CENTER><SAMP>X-Spam-Status: Yes, hits=10.6 tagged_above=-999.0 required=7.0 tests=BAYE...</SAMP></CENTER>
20004 <P>
20005 you might want to display the hits value.
20006 The first field starts with the Y in Yes.
20007 To get what you're interested in you might use &quot;=&quot; and
20008 space as the field separators and display the third field, like
20009 <P>
20010 <CENTER><SAMP>HEADER:X-Spam-Status(4,3,=&nbsp;)</SAMP></CENTER>
20011 <P>
20012 or maybe you would break at the dot instead
20013 <P>
20014 <CENTER><SAMP>HEADER:X-Spam-Status(2,2,=.,R)</SAMP></CENTER>
20015 <P>
20016 Another example we've seen has headers that look like
20017 <P>
20018 <CENTER><SAMP>X-Spam: Gauge=IIIIIII, Probability=7%, Report=...</SAMP></CENTER>
20019 <P>
20020 Because there are two equals and a comma before the 7% and a comma
20021 after it, the token
20022 <P>
20023 <CENTER><SAMP>HEADER:X-Spam(3,4,=&#92;,,R)</SAMP></CENTER>
20024 <P>
20025 should display the probability (for example 7% or 83%) right justified
20026 in a 3-wide field.
20027 </DD>
20028
20029 <DT>ARROW</DT>
20030 <DD>
20031 This gives an alternative way to display the current message in the
20032 MESSAGE INDEX screen.
20033 Usually the current message is indicated by the line being shown in
20034 reverse video.
20035 Instead, if the ARROW token is included in your <!--#echo var="VAR_index-format"-->,
20036 the current line will include an &quot;arrow&quot; that
20037 looks like
20038 <P>
20039 <CENTER><SAMP>-&gt;</SAMP></CENTER>
20040 <P>
20041 in the ARROW token's field.
20042 For all of the non-current messages, the ARROW field will be filled
20043 with blanks.
20044 If you use the fixed-field width feature the length of the &quot;arrow&quot;
20045 may be adjusted.
20046 The arrow will be drawn as width-1 dashes followed by a greater than sign.
20047 For example, if you use ARROW(3) you will get
20048 <P>
20049 <CENTER><SAMP>--&gt;</SAMP></CENTER>
20050 <P>
20051 and ARROW(1) will give you just
20052 <P>
20053 <CENTER><SAMP>&gt;</SAMP></CENTER>
20054 <P>
20055 It is also possible to set the color of the ARROW field.
20056 By default (and for non-current messages) the arrow is colored the same
20057 as the index line it is part of.
20058 You may set it to be another color with the
20059 <A HREF="h_config_index_arrow_color">Index Arrow Color</A> option available from
20060 the <A HREF="h_color_setup">Setup Kolor</A> screen.
20061 </DD>
20062
20063 <DT>SCORE</DT>
20064 <DD>
20065 This gives the
20066 <a href="h_rules_score">score</a>
20067 of each message.
20068 This will be six columns wide to accomodate the widest possible score.
20069 You will probably want to use the <!--#echo var="VAR_index-format"--> fixed-field width feature
20070 to limit the width of the field to the widest score that
20071 you use (e.g. SCORE(3) if your scores are always between 0 and 999).
20072 If you have not defined any score rules the scores will all be zero.
20073 If any of your score rules contain AllText or BodyText patterns
20074 then including SCORE in the <!--#echo var="VAR_index-format"-->
20075 may slow down the display of the MESSAGE INDEX screen.
20076 </DD>
20077 </DL>
20078
20079 <P>
20080 <H1><EM>Tokens Available for all but <!--#echo var="VAR_index-format"--></EM></H1>
20081
20082 <DL>
20083 <DT>CURNEWS</DT>
20084 <DD>
20085 This token represents the current newsgroup if there is one.
20086 For example, &quot;comp.mail.pine&quot;.
20087 </DD>
20088
20089 <DT>MSGID</DT>
20090 <DD>
20091 This token represents the message ID of the message.
20092 This token does not work with Filter Rule folder names.
20093 </DD>
20094
20095 <DT>CURDATE</DT>
20096 <DD>
20097 This token represents the current date.
20098 It has the format MMM DD. For example, &quot;Oct 23&quot;.
20099 </DD>
20100
20101 <DT>CURDATEISO</DT>
20102 <DD>
20103 This token represents the current date.
20104 It has the format YYYY-MM-DD. For example, &quot;1998-10-23&quot;.
20105 </DD>
20106
20107 <DT>CURDATEISOS</DT>
20108 <DD>
20109 This token represents the current date.
20110 It has the format YY-MM-DD. For example, &quot;98-10-23&quot;.
20111 </DD>
20112
20113 <DT>CURPREFDATE</DT>
20114 <DD>
20115 This token represents the current date.
20116 It is your operating system's idea of the preferred date representation for the current locale.
20117 Internally it uses the %x version of the date from the strftime routine.
20118 </DD>
20119
20120 <DT>CURPREFTIME</DT>
20121 <DD>
20122 This token represents the current time.
20123 It is the preferred time representation for the current locale.
20124 Internally it uses the %X version of the time from the strftime routine.
20125 </DD>
20126
20127 <DT>CURPREFDATETIME</DT>
20128 <DD>
20129 This token represents the current date and time.
20130 It is the preferred date and time representation for the current locale.
20131 Internally it uses the %c version of the time from the strftime routine.
20132 </DD>
20133
20134 <DT>CURTIME24</DT>
20135 <DD>
20136 This token represents the current time.
20137 It has the format HH:MM. For example, &quot;17:28&quot;.
20138 </DD>
20139
20140 <DT>CURTIME12</DT>
20141 <DD>
20142 This token represents the current time.
20143 This time is for a 12 hour clock.
20144 It has the format HH:MMpm.
20145 For example, &quot;5:28pm&quot; or &quot;11:13am&quot;.
20146 </DD>
20147
20148 <DT>CURDAY</DT>
20149 <DD>
20150 This token represents the current day of the month.
20151 For example, &quot;23&quot; or &quot;9&quot;.
20152 </DD>
20153
20154 <DT>CURDAY2DIGIT</DT>
20155 <DD>
20156 This token represents the current day of the month.
20157 For example, &quot;23&quot; or &quot;09&quot;.
20158 It is always 2 digits.
20159 </DD>
20160
20161 <DT>CURDAYOFWEEK</DT>
20162 <DD>
20163 This token represents the current day of the week.
20164 For example, &quot;Sunday&quot; or &quot;Wednesday&quot;.
20165 </DD>
20166
20167 <DT>CURDAYOFWEEKABBREV</DT>
20168 <DD>
20169 This token represents the current day of the week.
20170 For example, &quot;Sun&quot; or &quot;Wed&quot;.
20171 </DD>
20172
20173 <DT>CURMONTH</DT>
20174 <DD>
20175 This token represents the current month.
20176 For example, &quot;10&quot; or &quot;9&quot;.
20177 </DD>
20178
20179 <DT>CURMONTH2DIGIT</DT>
20180 <DD>
20181 This token represents the current month.
20182 For example, &quot;10&quot; or &quot;09&quot;.
20183 It is always 2 digits.
20184 </DD>
20185
20186 <DT>CURMONTHLONG</DT>
20187 <DD>
20188 This token represents the current month.
20189 For example, &quot;October&quot;.
20190 </DD>
20191
20192 <DT>CURMONTHABBREV</DT>
20193 <DD>
20194 This token represents the current month.
20195 For example, &quot;Oct&quot;.
20196 </DD>
20197
20198 <DT>CURYEAR</DT>
20199 <DD>
20200 This token represents the current year.
20201 For example, &quot;1998&quot; or &quot;2001&quot;.
20202 </DD>
20203
20204 <DT>CURYEAR2DIGIT</DT>
20205 <DD>
20206 This token represents the current year.
20207 For example, &quot;98&quot; or &quot;01&quot;.
20208 It is always 2 digits.
20209 </DD>
20210
20211 <DT>LASTMONTH</DT>
20212 <DD>
20213 This token represents last month.
20214 For example, if this is November (the 11th month),
20215 it is equal to &quot;10&quot; or if this is October (the 10th month),
20216 it is &quot;9&quot;.
20217 It is possible that this and the other tokens beginning with LASTMONTH
20218 below could be useful when used with a Filtering Rule that
20219 has the &quot;Beginning of Month&quot; option set.
20220 </DD>
20221
20222 <DT>LASTMONTH2DIGIT</DT>
20223 <DD>
20224 This token represents last month.
20225 For example, if this is November (the 11th month),
20226 it is equal to &quot;10&quot; or if this is October (the 10th month),
20227 it is &quot;09&quot;.
20228 It is always 2 digits.
20229 </DD>
20230
20231 <DT>LASTMONTHLONG</DT>
20232 <DD>
20233 This token represents last month.
20234 For example, if this is November the value is &quot;October&quot;.
20235 </DD>
20236
20237 <DT>LASTMONTHABBREV</DT>
20238 <DD>
20239 This token represents last month.
20240 For example, if this is November the value is &quot;Oct&quot;.
20241 </DD>
20242
20243 <DT>LASTMONTHYEAR</DT>
20244 <DD>
20245 This token represents what the year was a month ago.
20246 For example, if this is October, 1998, it is &quot;1998&quot;.
20247 If this is January, 1998, it is &quot;1997&quot;.
20248 </DD>
20249
20250 <DT>LASTMONTHYEAR2DIGIT</DT>
20251 <DD>
20252 This token represents what the year was a month ago.
20253 For example, if this is October, 1998, it is &quot;98&quot;.
20254 If this is January, 1998, it is &quot;97&quot;.
20255 </DD>
20256
20257 <DT>LASTYEAR</DT>
20258 <DD>
20259 This token represents last year.
20260 For example, if this is 1998, it equals &quot;1997&quot;.
20261 It is possible that this
20262 could be useful when used with a Filtering Rule that
20263 has the &quot;Beginning of Year&quot; option set.
20264 </DD>
20265
20266 <DT>LASTYEAR2DIGIT</DT>
20267 <DD>
20268 This token represents last year.
20269 For example, if this is 1998, it equals &quot;97&quot;.
20270 It is always 2 digits.
20271 </DD>
20272
20273 <DT>ROLENICK</DT>
20274 <DD>
20275 This token represents the nickname of the
20276 role currently being used.  If no role is being used,
20277 then no text will be printed for this token.
20278 This token does not work with Filter Rule folder names.
20279 </DD>
20280 </DL>
20281
20282 <P>
20283 <H1><EM>Token Available Only for <!--#echo var="VAR_reply-leadin"--></EM></H1>
20284 See the help for the
20285 <A HREF="h_config_reply_intro">&quot;<!--#echo var="VAR_reply-leadin"-->&quot;</A> option
20286 to see why you might want to use this.
20287 Since the <!--#echo var="VAR_reply-leadin"--> contains free text this token
20288 must be surrounded by underscores when used.
20289
20290 <DL>
20291 <DT>NEWLINE</DT>
20292 <DD>
20293 This is an end of line marker.
20294 </DD>
20295 </DL>
20296
20297 <P>
20298 <H1><EM>Token Available Only for Templates and Signatures</EM></H1>
20299
20300 <DL>
20301 <DT>CURSORPOS</DT>
20302 <DD>
20303 This token is different from the others.
20304 When it is replaced it is replaced with nothing, but it sets an Alpine
20305 internal variable that tells the composer to start with the cursor
20306 positioned at the position where this token was.
20307 If both the template file and the signature file contain
20308 a &quot;CURSORPOS&quot; token, then the position in the template file
20309 is used.
20310 If there is a template file and neither it nor the signature file contains
20311 a &quot;CURSORPOS&quot; token, then the cursor is positioned
20312 after the end of the contents of the
20313 template file when the composer starts up.
20314 </DD>
20315 </DL>
20316
20317 <P>
20318 &lt;End of help on this topic&gt;
20319 </BODY>
20320 </HTML>
20321 ======= h_reply_token_conditionals =======
20322 <HTML>
20323 <HEAD>
20324 <TITLE>Conditional Inclusion of Text for <!--#echo var="VAR_reply-leadin"-->, Signatures, and Templates</TITLE>
20325 </HEAD>
20326 <BODY>
20327 <H1>Conditional Inclusion of Text for <!--#echo var="VAR_reply-leadin"-->, Signatures, and Templates</H1>
20328
20329 Conditional text inclusion may be used with
20330 the <A HREF="h_config_reply_intro">&quot;<!--#echo var="VAR_reply-leadin"-->&quot;</A> option,
20331 in signature files, and in template files used in
20332 <A HREF="h_rules_roles">&quot;roles&quot;</A>.
20333 It may <EM>not</EM> be used with the
20334 <A HREF="h_config_index_format">&quot;<!--#echo var="VAR_index-format"-->&quot;</A> option.
20335
20336 <P>
20337 There is a limited if-else capability for including text.
20338 The if-else condition is based
20339 on whether or not a given token would result in replacement text you
20340 specify.
20341 The syntax of this conditional inclusion is
20342 <P>
20343 <CENTER><SAMP>_token_(match_this, if_matched [ , if_not_matched ] )</SAMP></CENTER>
20344 <P>
20345 The left parenthesis must follow the underscore immediately, with no
20346 intervening space.
20347 It means the token is expanded and the results of that expansion are
20348 compared against the &quot;match_this&quot; argument.
20349 If there is an exact match, then the &quot;if_matched&quot; text is used
20350 as the replacement text.
20351 Otherwise, the &quot;if_not_matched&quot; text is used.
20352 One of the most useful values for the &quot;match_this&quot; argument is
20353 the empty string, &quot;&quot;.
20354 In that case the expansion is compared against the empty string.
20355 <P>
20356 Here's an example to make it clearer.
20357 This text could be included in one of your template files:
20358 <P>
20359 <CENTER><SAMP>_NEWS_(&quot;&quot;, &quot;I'm replying to email&quot;, &quot;I'm replying to news&quot;)</SAMP></CENTER>
20360 <P>
20361 If that is included in a template file that you are using while replying
20362 to a message (because you chose to use the role it was part of),
20363 and that message has a newsgroup header and a newsgroup in that header,
20364 then the text
20365 <P>
20366 <CENTER><SAMP>I'm replying to news</SAMP></CENTER>
20367 <P>
20368 will be included in the message you are about to compose.
20369 On the other hand, if the message you are replying to does not have
20370 a newsgroup, then the text
20371 <P>
20372 <CENTER><SAMP>I'm replying to email</SAMP></CENTER>
20373 <P>
20374 would be included instead.
20375 This would also work in signature files and in
20376 the &quot;<!--#echo var="VAR_reply-leadin"-->&quot; option.
20377 If the &quot;match_this&quot;, &quot;if_matched&quot;,
20378 or &quot;if_not_matched&quot; arguments contain
20379 spaces, parentheses, or commas;
20380 they have to be quoted with double quotation marks (like in the example
20381 above).
20382 If you want to include a literal quote (&quot;) in the text you must escape the
20383 quote by preceding it with a backslash (&#92;) character.
20384 If you want to include a literal backslash character you must escape it
20385 by preceding it with another backslash.
20386 <P>
20387 The comma followed by &quot;if_not_matched&quot; is optional.
20388 If there is no &quot;if_not_matched&quot;
20389 present then no text is included if the not_matched case is true.
20390 Here's another example:
20391 <P>
20392 <CENTER><SAMP>_NEWS_(&quot;&quot;, &quot;&quot;, &quot;This msg was seen in group: _NEWS_.&quot;)</SAMP></CENTER>
20393 <P>
20394 Here you can see that tokens may appear in the arguments.
20395 The same is true for tokens with the conditional parentheses.
20396 They may appear in arguments,
20397 though you do have to be careful to get the quoting and escaping of
20398 nested double quotes correct.
20399 If this was in the signature file being used and you were replying to a message
20400 sent to comp.mail.pine the resulting text would be:
20401 <P>
20402 <CENTER><SAMP>This msg was seen in group: comp.mail.pine.</SAMP></CENTER>
20403 <P>
20404 If you were replying to a message that wasn't sent to any newsgroup the
20405 resulting text would be a single blank line.
20406 The reason you'd get a blank line is because the end of the line is
20407 outside of the conditional, so is always included.
20408 If you wanted to get rid of that blank line you could do so by moving
20409 the end of line inside the conditional.
20410 In other words, it's ok to have multi-line
20411 &quot;if_matched&quot; or &quot;if_not_matched&quot; arguments in your
20412 template file.
20413 The text just continues until the next double quotation, even if it's not
20414 on the same line.
20415 <P>
20416 Here's an example for use in the &quot;<!--#echo var="VAR_reply-leadin"-->&quot;:
20417 <P>
20418 <CENTER><SAMP>On _DAYDATE_, _FROM__CURNEWS_(&quot;&quot;, &quot;&quot;, &quot;seen in _CURNEWS_,&quot;) wrote</SAMP></CENTER>
20419 <P>
20420 If this was in your <!--#echo var="VAR_reply-leadin"--> and you were replying to a message
20421 while reading the newsgroup comp.mail.pine the resulting text would be:
20422 <P>
20423 <CENTER><SAMP>On Sat, 24 Oct 1998, Fred Flintstone, seen in comp.mail.pine, wrote:</SAMP></CENTER>
20424 <P>
20425 If you were replying to a message while reading an email folder instead
20426 of a newsgroup the resulting leadin text would be
20427 <P>
20428 <CENTER><SAMP>On Sat, 24 Oct 1998, Fred Flintstone wrote:</SAMP></CENTER>
20429 <P>
20430 Here's one more (contrived) example illustrating a matching argument
20431 that is not the empty string.
20432 <P>
20433 <CENTER><SAMP>_SMARTDATE_("Today", _SMARTDATE_, "On _DATE_") _FROM_ wrote:</SAMP></CENTER>
20434 <P>
20435 If this was the value of your &quot;<!--#echo var="VAR_reply-leadin"-->&quot; option and you
20436 were replying to
20437 a message that was sent today, then the value of the &quot;<!--#echo var="VAR_reply-leadin"-->&quot;
20438 would be
20439 <P>
20440 <CENTER><SAMP>Today Fred Flintstone wrote:</SAMP></CENTER>
20441 <P>
20442 But if you were replying to a message sent on Oct. 27 (and that wasn't
20443 today) you would get
20444 <P>
20445 <CENTER><SAMP>On Oct 27 Fred Flintstone wrote:</SAMP></CENTER>
20446 <P>
20447
20448 &lt;End of help on this topic&gt;
20449 </BODY>
20450 </HTML>
20451 ======= h_composer_cntxt_nick =======
20452 <HTML>
20453 <HEAD>
20454 <TITLE>Collection Nickname Explained</TITLE>
20455 </HEAD>
20456 <BODY>
20457 <H1>Collection Edit Help -- Nickname Field</H1>
20458
20459 This field is provided so you can add a short nickname to use when
20460 referring to this collection within Alpine.  Spaces are allowed, and
20461 you don't need to use double-quotes.  However, the double-quote
20462 character is not allowed.
20463 <P>
20464 Look <A HREF="h_edit_nav_cmds">here</A>
20465 to see the available Editing and Navigation commands.
20466 <P>
20467 &lt;End of help on this topic&gt;
20468 </BODY>
20469 </HTML>
20470 ======= h_folder_server_syntax =======
20471 <HTML>
20472 <HEAD>
20473 <TITLE>Server Name Syntax</TITLE>
20474 </HEAD>
20475 <BODY>
20476 <H1>Server Name Syntax</H1>
20477
20478 This help describes the syntax that may be used for server names
20479 that may be associated with remote folders or SMTP servers.
20480
20481 <P>
20482 A server name is the hostname of the server.
20483 It's a good idea to use the host's fully-qualified network name.
20484
20485 <P>
20486 <CENTER><SAMP>foo.example.com</SAMP></CENTER>
20487 <P>
20488
20489 However, IP addresses are allowed if surrounded
20490 with square-brackets.
20491
20492 <P>
20493 <CENTER><SAMP>[127.0.0.1]</SAMP></CENTER>
20494 <P>
20495
20496 An optional network port number may be supplied by appending
20497 a colon (:) followed by the port number
20498 to the server name.
20499 By default, the IMAP port number, 143, is used.
20500
20501 <P>
20502 <CENTER><SAMP>foo.example.com:port</SAMP></CENTER>
20503 <P>
20504
20505 Besides server name and optional port number, various other optional
20506 parameters may be supplied that alter Alpine's interaction with the server.
20507 A parameter is supplied by appending a slash (/) character followed by
20508 the parameter's name and,
20509 depending on the particular parameter, the value assigned to that
20510 name, to the server name (and optional port number).
20511 Parameter names are <EM>not</EM> case sensitive.
20512 Currently supported parameters include:
20513
20514 <DL>
20515
20516 <DT>User</DT>
20517 <DD>This parameter requires an associated value, and is intended to
20518 provide the username identifier with which to establish the server
20519 connection.
20520 If your SMTP server offers SMTP AUTH authentication, adding this
20521 parameter to the
20522 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>
20523 option will cause Alpine to attempt to authenticate to the server using the
20524 supplied username.
20525 Similarly, if your NNTP server offers NNTP &quot;AUTHINFO SASL&quot;
20526 or &quot;AUTHINFO USER&quot; authentication, adding this parameter to the
20527 <A HREF="h_config_nntp_server"><!--#echo var="VAR_nntp-server"--></A>
20528 option (or to the server name for any folder collection using NNTP)
20529 will cause Alpine to attempt
20530 to authenticate to the server using the supplied username.
20531 An example might be:
20532
20533 <P>
20534 <CENTER><SAMP>/user=katie</SAMP></CENTER>
20535 <P>
20536
20537 </DD>
20538
20539 <DT>TLS</DT>
20540 <DD>
20541 Normally, when a new connection is made an attempt is made to
20542 negotiate a secure (encrypted) session using Transport Layer Security (TLS).
20543 If that fails then a non-encrypted connection will be attempted instead.
20544 This is a unary parameter indicating communication with the server must
20545 take place over a TLS connection. If the attempt to use TLS fails then
20546 this parameter will cause the connection to fail instead of falling
20547 back to an unsecure connection.
20548
20549 <P>
20550 <CENTER><SAMP>/tls</SAMP></CENTER>
20551 <P>
20552
20553 </DD>
20554
20555 <DT>SSL</DT>
20556 <DD>
20557 This is a unary parameter indicating communication with the server should
20558 take place over a Secure Socket Layer connection.  The server must support
20559 this method, and be prepared to accept connections on the appropriate
20560 port (993 by default).
20561 Alpine must be linked with an SSL library for this option to be operational.
20562
20563 <P>
20564 <CENTER><SAMP>/ssl</SAMP></CENTER>
20565 <P>
20566
20567 </DD>
20568
20569 <DT>TLS1</DT>
20570 <DD>
20571 This parameter indicates that the connection to the server will be made
20572 over the SSL port, but using the TLSv1 protocol, instead of the usual
20573 SSLv3 or SSLv2 protocols.
20574 Alpine must be linked with an SSL library for this option to be operational.
20575
20576 <P>
20577 <CENTER><SAMP>/tls1</SAMP></CENTER>
20578 <P>
20579
20580 </DD>
20581
20582 <DT>DTLS1</DT>
20583 <DD>
20584 This parameter indicates that the connection to the server will be made
20585 over the SSL port, but using the DTLSv1 protocol, instead of the usual
20586 SSLv3 or SSLv2 protocols.
20587 Alpine must be linked with an SSL library for this option to be operational.
20588
20589 <P>
20590 <CENTER><SAMP>/dtls1</SAMP></CENTER>
20591 <P>
20592
20593 </DD>
20594
20595 <DT>TLS1_1</DT>
20596 <DD>
20597 This parameter indicates that the connection to the server will be made
20598 over the SSL port, but using the TLSv1.1 protocol, instead of the usual
20599 SSLv3 or SSLv2 protocols.
20600 Alpine must be linked with an SSL library for this option to be operational.
20601
20602 <P>
20603 <CENTER><SAMP>/tls1_1</SAMP></CENTER>
20604 <P>
20605
20606 </DD>
20607
20608 <DT>TLS1_2</DT>
20609 <DD>
20610 This parameter indicates that the connection to the server will be made
20611 over the SSL port, but using the TLSv1.2 protocol, instead of the usual
20612 SSLv3 or SSLv2 protocols.
20613 Alpine must be linked with an SSL library for this option to be operational.
20614
20615 <P>
20616 <CENTER><SAMP>/tls1_2</SAMP></CENTER>
20617 <P>
20618
20619 </DD>
20620
20621
20622 <DT>NoValidate-Cert</DT>
20623 <DD>Do not validate certificates (for TLS or SSL connections) from the server.
20624 This is needed if the server uses self-signed certificates or if Alpine
20625 cannot validate the certificate for some other known reason.
20626 <P>
20627 </DD>
20628
20629 <DT>Anonymous</DT>
20630 <DD>This is a unary parameter (that means it does not have a value)
20631 indicating that the connection be logged in as
20632 &quot;anonymous&quot; rather than a specific user.
20633 Not all servers offer anonymous
20634 access; those which do generally only offer read-only access to certain
20635 &quot;public&quot; folders.
20636
20637 <P>
20638 <CENTER><SAMP>/anonymous</SAMP></CENTER>
20639 <P>
20640
20641 </DD>
20642
20643 <DT>Secure</DT>
20644 <DD>This is a unary parameter indicating that the connection use the
20645 most secure authentication method mutually supported by Alpine and the
20646 server.
20647 Alpine is capable of authenticating connections to
20648 the server using several methods.
20649 By default, Alpine will attempt each
20650 method until either a connection is established or the
20651 list of methods is exhausted.
20652 This parameter causes Alpine to instead fail
20653 the connection if the first (generally most &quot;secure&quot;) method fails.
20654
20655 <P>
20656 <CENTER><SAMP>/secure</SAMP></CENTER>
20657 <P>
20658
20659 </DD>
20660
20661 <DT>Submit</DT>
20662 <DD>This is a unary parameter for use with the
20663 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A> option.
20664 It indicates that the connection should be made to the Submit server
20665 (<A HREF="http://www.ietf.org/rfc/rfc2476.txt">RFC 3676</A>)
20666 (port 587) instead of the SMTP port (25).
20667 At the time this help was written the submit option was equivalent to
20668 specifying port 587.
20669
20670 <P>
20671 <CENTER><SAMP>/submit</SAMP></CENTER>
20672 <P>
20673 or
20674 <P>
20675 <CENTER><SAMP>host:587</SAMP></CENTER>
20676 <P>
20677
20678 </DD>
20679
20680 <DT>Debug</DT>
20681 <DD>This is a unary parameter indicating that the connection be established
20682 in a verbose mode.  Basically, it causes Alpine to log the communication with
20683 the server in Alpine's debug file.
20684 Normally, the pine -d command-line flag would be used instead.
20685 <P>
20686 </DD>
20687
20688 <DT>NoRsh</DT>
20689 <DD>By default, Alpine attempts to login using &quot;rsh&quot;,
20690 the UNIX remote shell program.
20691 Including &quot;NoRsh&quot; will cause connections to this server to skip
20692 the &quot;rsh&quot; attempt.
20693 This might be useful to avoid long timeouts caused by rsh firewalls, for
20694 example.
20695 <P>
20696 </DD>
20697
20698 <DT>Loser</DT>
20699 <DD>This option makes sense only for IMAP servers that do not perform
20700 a SEARCH command correctly. If your filtering rules
20701 fail to filter some messages, that should have been filtered, then this
20702 option will make Alpine download all data necessary data to perform that
20703 search. There is a performance penalty when using this option. Downloading
20704 the data to perfom the search will take longer than requesting the IMAP
20705 server to perform the filtering, but the filtering will be done correctly.
20706 <P>
20707 </DD>
20708
20709
20710 <DT>Service</DT>
20711 <DD>This parameter requires an associated value.  The default value is
20712 &quot;IMAP&quot; which indicates communication with the server based
20713 on the IMAP4rev1 protocol (defined in RFC 3501 -- see
20714 <A HREF="http://www.imap.org/docs/rfc3501.html">http://www.imap.org/docs/rfc3501.html</A>).</DD>
20715
20716 Other service values include:
20717  <DL>
20718  <DT>NNTP</DT>
20719  <DD>This value indicates communication with the server takes place via
20720 the Network News Transfer Protocol.  Use this to define a collection
20721 of newsgroups on a remote news server.  So
20722
20723 <P>
20724 <CENTER><SAMP>/service=NNTP</SAMP></CENTER>
20725 <P>
20726 or just
20727 <P>
20728 <CENTER><SAMP>/NNTP</SAMP></CENTER>
20729 <P>
20730
20731 is the way to specify NNTP access.
20732 <P>
20733  </DD>
20734
20735  <DT>POP3</DT>
20736  <DD>This value indicates communication with the server takes place via the
20737 Post Office Protocol 3 protocol.
20738
20739 <P>
20740 <CENTER><SAMP>/service=POP3</SAMP></CENTER>
20741 <P>
20742 or just
20743 <P>
20744 <CENTER><SAMP>/POP3</SAMP></CENTER>
20745 <P>
20746
20747 Note that there are several important issues
20748 to consider when selecting this option:
20749 <OL>
20750  <LI> POP3 provides access to only your INBOX.  In other words,
20751 secondary folders such as your &quot;saved-messages&quot; are inaccessible.
20752  <LI> Alpine's implementation of POP3 does not follow the traditional POP
20753 model and will leave your mail on the server. Refer to the
20754 <A HREF="h_maildrop">Mail Drop</A> functionality for a possible way around this problem.
20755  <LI> See the discussion about new-mail checking in <A HREF="h_config_reopen_rule">&quot;<!--#echo var="VAR_folder-reopen-rule"-->&quot;</A>.
20756 </OL>
20757 </DD>
20758 </DL>
20759 </DL>
20760
20761 <P>
20762 Note that it is possible to include more than one parameter in a server
20763 specification by concatenating the parameters. For example:
20764
20765 <P>
20766 <CENTER><SAMP>foo.example.com:port/user=katie/novalidate-cert/debug</SAMP></CENTER>
20767 <P>
20768
20769 <P>
20770 &lt;End of help on this topic&gt;
20771 </BODY>
20772 </HTML>
20773 ======= h_composer_cntxt_server =======
20774 <HTML>
20775 <HEAD>
20776 <TITLE>Collection Server: Explained</TITLE>
20777 </HEAD>
20778 <BODY>
20779 <H1>Collection Edit Help -- Server Field</H1>
20780
20781 This collection's &quot;Server:&quot; definition indicates the
20782 hostname of the server providing access to the folders in this
20783 collection.
20784 The syntax of this server name is the same as for other server names used
20785 in remote folder names in
20786 Alpine and is described
20787 <A HREF="h_folder_server_syntax">here</A>.
20788
20789 <P>
20790 &lt;End of help on this topic&gt;
20791 </BODY>
20792 </HTML>
20793 ======= h_composer_cntxt_path =======
20794 <HTML>
20795 <HEAD>
20796 <TITLE>Collection Path: Explained</TITLE>
20797 </HEAD>
20798 <BODY>
20799 <H1>Collection Edit Help -- Path Field</H1>
20800
20801 The collection's &quot;Path:&quot; definition indicates the location
20802 of the folders in this collection.  If the path or any of its components
20803 do not exist, Alpine will prompt you for their creation when exiting the
20804 Add/Change screen.
20805
20806 <P>
20807 By default the path is interpreted as defining a section of your personal
20808 folder area.  This area and how you specify it are defined by the
20809 server, if one is specified in the collection, or, typically, the home
20810 directory if no server is defined.
20811
20812 <P>
20813 To define a collection outside the default &quot;area&quot;, prefix
20814 the path with the &quot;namespace&quot; to use when interpreting the
20815 given path.  If a namespace is specified, the Path begins with the
20816 sharp, &quot;#&quot;, character followed by the name of the namespace
20817 and then the namespace's path-element-delimiter.  Aside from the
20818 path's format, namespaces can also imply access rights, content
20819 policy, audience, location, and, occasionally, access methods.
20820
20821 <P>
20822 Each server exports its own set (possibly of size one) of
20823 namespaces.  Hence, it's likely communication with your server's
20824 administrator will be required for specific configurations.  Some of
20825 the more common namespaces, however, include:
20826
20827 <DL>
20828 <DT>#news.</DT>
20829 <DD>This specifies a set of folders in the newsgroup namespace.  Newsgroup
20830 names are hierarchically defined with each level delimited by a period.
20831 </DD>
20832 <DT>#public/</DT>
20833 <DD>This specifies a folder area that the server may export to the general
20834 public.
20835 </DD>
20836 <DT>#shared/</DT>
20837 <DD>This specifies a folder area that the folder may export to groups
20838 of users.
20839 </DD>
20840 <DT>#ftp/</DT>
20841 <DD>This specifies a folder area that is the same as that it may have
20842 exported via the &quot;File Transfer Protocol&quot;.
20843 </DD>
20844 <DT>#mh/</DT>
20845 <DD>This specifies the personal folder area associated with folders
20846 and directories that were created using the MH message handling system.
20847 </DD>
20848 </DL>
20849 <P>
20850
20851 In addition, the server may support access to other user's folders,
20852 provided you have suitable permissions.  Common methods use a prefix
20853 of either &quot;~<VAR>user</VAR>/&quot;, or &quot;/<VAR>user</VAR>/&quot; to
20854 indicate the root of the other user's folder area.
20855
20856 <P>
20857 No, nothing's simple.
20858
20859 <P>
20860 &lt;End of help on this topic&gt;
20861 </BODY>
20862 </HTML>
20863 ======= h_composer_cntxt_view =======
20864 <HTML>
20865 <HEAD>
20866 <TITLE>Collection View: Explained</TITLE>
20867 </HEAD>
20868 <BODY>
20869 <H1>Collection Edit Help -- View Field</H1>
20870
20871 The collection's &quot;View:&quot; definition provides a way to limit
20872 the displayed list of folders within a collection.  By default, only
20873 folders that contain the specified characters anywhere in their name
20874 are shown in the collection's folder list.
20875
20876 <P>
20877 Additionally, you can use a wildcard character to better control
20878 the list of folders selected for display.  The wildcard specifier is
20879 the star, &quot;*&quot;, character.
20880
20881 <P>
20882 So, for example, to define a collection of all folders ending with
20883 &quot;c&quot;, you'd specify a view of &quot;*c&quot; (without the
20884 quote characters!).  Or, similarly, to define a collection of folders
20885 whose names start with &quot;a&quot; and end with &quot;z&quot;, you'd
20886 specify a view of &quot;a*z&quot;.
20887
20888 <P>
20889 &lt;End of help on this topic&gt;
20890 </BODY>
20891 </HTML>
20892 ======= h_composer_abook_add_server =======
20893 <HTML>
20894 <HEAD>
20895 <TITLE>Addressbook Server Name Field Explained</TITLE>
20896 </HEAD>
20897 <BODY>
20898 This field should be left blank if the address book is stored in a regular
20899 file on this system.  If it is a remote address book stored on an IMAP
20900 server then this is the name of that IMAP server.
20901 <P>
20902 Look <A HREF="h_edit_nav_cmds">here</A>
20903 to see the available Editing and Navigation commands.
20904 <P>
20905 &lt;End of help on this topic&gt;
20906 </BODY>
20907 </HTML>
20908 ======= h_composer_abook_add_folder =======
20909 <HTML>
20910 <HEAD>
20911 <TITLE>Addressbook Folder Name Field Explained</TITLE>
20912 </HEAD>
20913 <BODY>
20914 For a remote address book (one for which the Server Name is filled in)
20915 this is the name of a folder on the remote server. The address book data
20916 will be stored in this folder. This folder should be used only for
20917 storing this single address book, not for other address books or for
20918 other messages.
20919 <P>
20920 For a local address book (one for which the Server Name is not filled in)
20921 this is the name of a file in which the address book will be stored.
20922 The file is in the same directory as the Alpine configuration file if the
20923 configuration file is local.
20924 If the configuration file is remote, then this will be in the home directory
20925 for Unix Alpine and in the directory specified by the
20926 &quot;-aux local_directory&quot; command line argument.
20927 <P>
20928 Look <A HREF="h_edit_nav_cmds">here</A>
20929 to see the available Editing and Navigation commands.
20930 <P>
20931 &lt;End of help on this topic&gt;
20932 </BODY>
20933 </HTML>
20934 ======= h_composer_abook_add_nick =======
20935 <HTML>
20936 <HEAD>
20937 <TITLE>Addressbook NickName Field Explained</TITLE>
20938 </HEAD>
20939 <BODY>
20940 This is just an optional nickname for this address book. If present, it
20941 is used in some of the displays and error messages in the address book
20942 maintenance screens. It is for your convenience only and serves no
20943 other purpose.
20944 <P>
20945 Look <A HREF="h_edit_nav_cmds">here</A>
20946 to see the available Editing and Navigation commands.
20947 <P>
20948 &lt;End of help on this topic&gt;
20949 </BODY>
20950 </HTML>
20951 ======= h_composer_qserv_cn =======
20952 <HTML>
20953 <HEAD>
20954 <TITLE>Directory Query Form Explained</TITLE>
20955 </HEAD>
20956 <BODY>
20957
20958 Fill in as many of these fields as you wish to narrow down your
20959 search. All the fields you fill in must match in order for an entry
20960 to be returned. You may use the wildcard character &quot;*&quot; in
20961 any of the fields, it matches any zero or more characters at that
20962 point in the string. There are no implicit wildcards, so the match is
20963 exact unless you include wildcards.
20964 <P>
20965
20966 Note that if an attribute isn't present at all, then the match will fail.
20967 For example, if a server doesn't support the Locality attribute, then no
20968 matter what you put in the Locality field (other than leaving it empty)
20969 the search will fail.
20970 <P>
20971
20972 This field, the Common Name field, is typically a person's full name.
20973 <P>
20974
20975 <H1>EDITING and NAVIGATION COMMANDS</H1>
20976 <!--chtml if pinemode="function_key"-->
20977 <PRE>
20978 CURSOR MOTION KEYS----------------------|EDITING KEYS-------------------------
20979 ^B (Left Arrow)    Back character       | ^D       Delete current character
20980 ^F (Right Arrow)   Forward character    | ^H (DEL) Delete previous character
20981 ^P (Up Arrow)      Previous line        |
20982 ^N (Down Arrow)    Next line            | F9       Cut marked text or
20983 ^A                 Beginning of line    |            delete current line
20984 ^E                 End of line          | F10      Undelete line(s)
20985 F7                 Previous page        |
20986 F8                 Next page            |-------------------------------------
20987 ^@ (Ctrl-SPACE)    Next word            | MISCELLANEOUS COMMANDS
20988 ----------------------------------------|
20989 EXIT COMMANDS    |  GENERAL COMMANDS    | F5    Restore previous search
20990 F2   Cancel      |   F1    Get help     |
20991 F3   Search      |   ^Z    Suspend      | ^L    Redraw Screen
20992 </PRE>
20993 <!--chtml else-->
20994 <PRE>
20995 CURSOR MOTION KEYS----------------------|EDITING KEYS-------------------------
20996 ^B (Left Arrow)    Back character       | ^D       Delete current character
20997 ^F (Right Arrow)   Forward character    | ^H (DEL) Delete previous character
20998 ^P (Up Arrow)      Previous line        |
20999 ^N (Down Arrow)    Next line            | ^K       Cut marked text or
21000 ^A                 Beginning of line    |            delete current line
21001 ^E                 End of line          | ^U       Undelete line(s)
21002 ^Y                 Previous page        |
21003 ^V                 Next page            |-------------------------------------
21004 ^@ (Ctrl-SPACE)    Next word            | MISCELLANEOUS COMMANDS
21005 ----------------------------------------|
21006 EXIT COMMANDS    |  GENERAL COMMANDS    | ^R     Restore previous search
21007 ^C   Cancel      |   ^G    Get help     |
21008 ^X   Search      |   ^Z    Suspend      | ^L     Redraw Screen
21009 </PRE>
21010 <!--chtml endif-->
21011 <P><UL>
21012 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21013 </UL><P>
21014 &lt;End of help on this topic&gt;
21015 </BODY>
21016 </HTML>
21017 ======= h_composer_qserv_sn =======
21018
21019 The Surname is usually the family name of a person.
21020
21021 <End of help on this topic>
21022 ======= h_composer_qserv_gn =======
21023
21024 This is the part of a person's name that isn't the surname or initials.
21025
21026 <End of help on this topic>
21027 ======= h_composer_qserv_mail =======
21028
21029 This is the email address of a person.
21030
21031 <End of help on this topic>
21032 ======= h_composer_qserv_org =======
21033
21034 This is the organization a person belongs to.
21035
21036 <End of help on this topic>
21037 ======= h_composer_qserv_unit =======
21038
21039 This is the organizational unit a person belongs to.
21040
21041 <End of help on this topic>
21042 ======= h_composer_qserv_country =======
21043
21044 This is the country a person belongs to.
21045
21046 <End of help on this topic>
21047 ======= h_composer_qserv_state =======
21048
21049 This is the state a person belongs to.
21050
21051 <End of help on this topic>
21052 ======= h_composer_qserv_locality =======
21053
21054 This is the locality a person belongs to.
21055
21056 <End of help on this topic>
21057 ======= h_composer_qserv_custom =======
21058
21059 This one is for advanced users only! If you put something in this field,
21060 then the rest of the fields are ignored.
21061
21062 This field may be set to the string representation of an LDAP search
21063 filter (see RFC1960). Here are some examples:
21064
21065 To search for an entry with a surname equal to "clinton" you could set
21066 the custom filter to:
21067
21068      (sn=clinton)
21069
21070 This is equivalent to putting "clinton" in the SurName field.
21071 To search for an entry that has a surname that begins with "clint" and
21072 has a givenname equal to "william" you could use:
21073
21074      (&(sn=clint*)(givenname=william))
21075
21076 This is equivalent to setting the SurName field to "clint*" and the
21077 GivenName field to "william".
21078 To search for an entry where either the common name OR the email address
21079 contains "abcde" you could use:
21080
21081      (|(cn=*abcde*)(mail=*abcde*))
21082
21083 That isn't equivalent to anything you can do by setting the other fields
21084 because of the OR.
21085
21086 <End of help on this topic>
21087 ======= h_composer_qserv_qq =======
21088
21089 This one is a little different from the rest of the categories.  It causes
21090 a search to be formed from the configured search filter that you filled
21091 in when you added the directory server to your configuration. It can also
21092 be combined with the other fields if you'd like.
21093
21094 <End of help on this topic>
21095 ======= h_address_format =======
21096 <HTML>
21097 <HEAD>
21098 <TITLE>INTERNET EMAIL ADDRESS FORMAT</TITLE>
21099 </HEAD>
21100 <BODY>
21101 <H1>INTERNET EMAIL ADDRESS FORMAT</H1>
21102
21103 A valid email address on the Internet has a username, an &quot;@&quot; sign,
21104 and then a domain, with no spaces.
21105 For example, jsmith@art.example.com might be the email address
21106 of a person
21107 with the username &quot;jsmith&quot; who has an account in the domain
21108 &quot;art.example.com&quot;.  The number of dot-separated segments on the
21109 right of the &quot;@&quot; sign can vary - a shorter example would be
21110 isabelle@elsewhere.edu (the shortest possible form: here, only the
21111 organization's domain is specified after the &quot;@&quot; sign); a longer
21112 example would be
21113  jsingh@shakti.edutech.example.com
21114 (here, the name of the host &quot;shakti&quot; in the domain
21115 edutech.example.com is also specified).
21116 <P>
21117 If you do not know the exact email address of someone you want to write
21118 to, ask them what it is using other means of communication than email; or
21119 use the tools for
21120 finding people's addresses that are available on the Internet.
21121 <P>
21122 If you are sending to someone on the same system as you are, you can leave
21123 the &quot;@&quot; sign and all the information to its right off of the
21124 address, and Alpine will fill it in automatically,
21125 unless the feature
21126 <A HREF="h_config_compose_rejects_unqual">&quot;<!--#echo var="FEAT_compose-rejects-unqualified-addrs"-->&quot;</A> is set in SETUP CONFIGURATION.
21127 <P>
21128
21129 When an email address you send a message to is not reachable -- either because
21130 it is simply an incorrect address, or because email can temporarily not be
21131 delivered to it due to a technical problem on the way to or at the recipient's
21132 end -- you will almost always get an error notification email message back.
21133 <P>
21134 If you encounter problems with, or have questions about, email delivery or
21135 email address syntax, contact your local network computing consultants.
21136 <P><UL>
21137 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21138 </UL>
21139 <P>
21140 &lt;End of help on this topic&gt;
21141 </BODY>
21142 </HTML>
21143 ======= h_flag_user_flag =======
21144 <HTML>
21145 <HEAD>
21146 <TITLE>STATUS FLAG: User Defined Keyword</TITLE>
21147 </HEAD>
21148 <BODY>
21149 <H1>STATUS FLAG: User Defined Keyword</h1>
21150
21151 This is a keyword that is defined for this folder.
21152 It was most likely defined by the owner of the folder.
21153 Alpine will not set or clear this flag on its own.
21154
21155 <P><UL>
21156 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21157 </UL><P>
21158 &lt;End of help on this topic&gt;
21159 </BODY>
21160 </HTML>
21161 ======= h_flag_important =======
21162 <html>
21163 <title>STATUS FLAG: Important</title>
21164 <body>
21165 <h1>STATUS FLAG: Important</h1>
21166
21167
21168 The <EM>Important</EM> flag, indicated by an asterisk in Alpine's
21169 MESSAGE&nbsp;INDEX
21170 screen, can only be set by the user, and is intended to be used in
21171 whatever fashion makes sense to you.  You are the only one that can set or
21172 clear it.
21173
21174 <P>
21175 &lt;End of help on this topic&gt;
21176 </BODY>
21177 </HTML>
21178 ======= h_flag_new =======
21179 <html>
21180 <title>STATUS FLAG: New</title>
21181 <body>
21182 <h1>STATUS FLAG: New</h1>
21183
21184
21185 The <EM>New</EM> flag, indicated by the letter 'N' in Alpine's
21186 MESSAGE&nbsp;INDEX screen,
21187 is automatically set when messages are delivered to your Inbox (or other
21188 folder specified outside of Alpine).  Likewise, it is cleared automatically
21189 the first time you read the message it is associated with.
21190
21191 <P>
21192 Sometimes it's helpful in prioritizing your mail.  For example, perhaps
21193 a message isn't weighty enough to assign it an <A HREF="h_flag_important">Important</A> flag, but
21194 you'd like to be reminded of it next time you read mail.  This can be done
21195 easily by <A HREF="h_common_flag">explicitly</A> resetting the <EM>New</EM> flag.
21196
21197
21198 <P>
21199 &lt;End of help on this topic&gt;
21200 </BODY>
21201 </HTML>
21202 ======= h_flag_answered =======
21203 <html>
21204 <title>STATUS FLAG: Answered</title>
21205 <body>
21206 <h1>STATUS FLAG: Answered</h1>
21207
21208 The <EM>Answered</EM> flag, indicated by the letter 'A' in Alpine's
21209 MESSAGE&nbsp;INDEX
21210 screen, is automatically set when you reply to a message.  This flag is not
21211 automatically cleared.
21212
21213 <P>
21214 &lt;End of help on this topic&gt;
21215 </BODY>
21216 </HTML>
21217 ======= h_flag_forwarded =======
21218 <html>
21219 <title>STATUS FLAG: Forwarded</title>
21220 <body>
21221 <h1>STATUS FLAG: Forwarded</h1>
21222
21223 The <EM>Forwarded</EM> flag, indicated by the letter 'F' in Alpine's
21224 MESSAGE&nbsp;INDEX
21225 screen, is automatically set when you forward a message.  This flag is not
21226 automatically cleared.
21227
21228 <P>
21229 &lt;End of help on this topic&gt;
21230 </BODY>
21231 </HTML>
21232 ======= h_flag_deleted =======
21233 <html>
21234 <title>STATUS FLAG: Deleted</title>
21235 <body>
21236 <h1>STATUS FLAG: Deleted</h1>
21237
21238 The <EM>Deleted</EM> flag, indicated by the letter 'D' in Alpine's
21239 MESSAGE&nbsp;INDEX
21240 screen, is set when you use the &quot;"D&nbsp;Delete&quot; command.
21241 It is cleared
21242 when you use the &quot;U&nbsp;Undelete&quot; command.
21243
21244 <P>
21245 Messages marked with this flag will be permanently removed from
21246 the folder when you issue the <A HREF="h_index_cmd_expunge">Expunge</A>
21247 command, or
21248 when you indicate acceptance of their removal upon leaving the folder.
21249
21250 <P>
21251 Note, there can be other actions implicit in the
21252 &quot;D&nbsp;Delete&quot; command,
21253 such as advancing to the next message, that may be momentarily undesirable.
21254 For this reason, it's sometimes useful to set or clear the <EM>Deleted</EM>
21255 flag <A HREF="h_common_flag">explicitly</A>.
21256
21257 <P>
21258 &lt;End of help on this topic&gt;
21259 </BODY>
21260 </HTML>
21261 ====== h_config_incoming_timeo ======
21262 <HTML>
21263 <HEAD>
21264 <TITLE>OPTION: <!--#echo var="VAR_incoming-check-timeout"--></TITLE>
21265 </HEAD>
21266 <BODY>
21267 <H1>OPTION: <!--#echo var="VAR_incoming-check-timeout"--></H1>
21268
21269 This option has no effect unless the feature
21270 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
21271 is set, which in turn has no effect unless
21272 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
21273 is set.
21274 <P>
21275 Sets the time in seconds that Alpine will
21276 attempt to open a network connection used for monitoring for Unseen
21277 messages in Incoming Folders. The default is 5.
21278 If a connection has not completed within this many seconds Alpine will
21279 give up and consider it a failed connection.
21280 <P>
21281 <UL>
21282 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21283 </UL><P>
21284 &lt;End of help on this topic&gt;
21285 </BODY>
21286 </HTML>
21287 ====== h_config_psleep ======
21288 <HTML>
21289 <HEAD>
21290 <TITLE>OPTION: <!--#echo var="VAR_mailcap-check-interval"--> (UNIX Alpine only)</TITLE>
21291 </HEAD>
21292 <BODY>
21293 <H1>OPTION: <!--#echo var="VAR_mailcap-check-interval"--> (UNIX Alpine only)</H1>
21294
21295 <P>
21296 In the good old days a mailcap viewer was used to examine an
21297 attachment before saving it, and after viewing the attachment control
21298 would return to the operating system when the viewer was closed. Therefore,
21299 when the mailcap viewer returned control to the operating system, it
21300 could be assumed that the user who opened the attachment was done
21301 examining it, and the copy of the attachment that was used, could be removed.
21302
21303 <P>
21304 However, today this assumption is not longer valid. Some viewers return
21305 control to the operating system before they actually read the attachment
21306 to be examined. This causes Alpine to delete the attachment before it
21307 is read by the viewer, causing the viewer to fail opening the attachment.
21308
21309 <P>
21310 In order to work around this problem, Alpine checks, after the viewer has
21311 returned control to the operating system, if there is any process that is
21312 using the attachment. This variable controls the number of seconds that
21313 must elapse between checks. Once it is found that no process is using the
21314 attachment, this is removed.
21315
21316 <P>
21317 The minimum value for this variable is 60 (checks will be made once per
21318 minute), and the maximum value is 600 (checks will be made once every 10
21319 minutes). The default value is 60.
21320
21321 <P>
21322 <UL>
21323 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21324 </UL><P>
21325 &lt;End of help on this topic&gt;
21326 </BODY>
21327 </HTML>
21328 ====== h_config_incoming_interv ======
21329 <HTML>
21330 <HEAD>
21331 <TITLE>OPTION: <!--#echo var="VAR_incoming-check-interval"--></TITLE>
21332 </HEAD>
21333 <BODY>
21334 <H1>OPTION: <!--#echo var="VAR_incoming-check-interval"--></H1>
21335
21336 This option has no effect unless the feature
21337 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
21338 is set, which in turn has no effect unless
21339 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
21340 is set.
21341 <P>
21342 This option specifies, in seconds, how often Alpine will check
21343 for new mail and state changes in Incoming Folders when Incoming Folders
21344 Checking is turned on.
21345 The default is 3 minutes (180).
21346 This value applies only to folders that are local to the system that
21347 Alpine is running on or that are accessed using the IMAP protocol.
21348 The similar option
21349 <A HREF="h_config_incoming_second_interv"><!--#echo var="VAR_incoming-check-interval-secondary"--></A>
21350 applies to all other monitored folders.
21351 <P>
21352 <UL>
21353 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21354 </UL><P>
21355 &lt;End of help on this topic&gt;
21356 </BODY>
21357 </HTML>
21358 ====== h_config_incoming_second_interv ======
21359 <HTML>
21360 <HEAD>
21361 <TITLE>OPTION: <!--#echo var="VAR_incoming-check-interval-secondary"--></TITLE>
21362 </HEAD>
21363 <BODY>
21364 <H1>OPTION: <!--#echo var="VAR_incoming-check-interval-secondary"--></H1>
21365
21366 This option has no effect unless the feature
21367 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
21368 is set, which in turn has no effect unless
21369 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
21370 is set.
21371 <P>
21372 This option together with the option
21373 <A HREF="h_config_incoming_interv"><!--#echo var="VAR_incoming-check-interval"--></A>
21374 specifies, in seconds, how often Alpine will check
21375 for new mail and state changes in Incoming Folders when Incoming Folders
21376 Checking is turned on.
21377 The default for this option is 3 minutes (180).
21378 For folders that are local to this system or
21379 that are accessed using the IMAP protocol
21380 the value of the option
21381 <A HREF="h_config_incoming_interv"><!--#echo var="VAR_incoming-check-interval"--></A>
21382 is used.
21383 For all other monitored folders, the value of this option is used.
21384 <P>
21385 The reason there are two separate options is because it is usually
21386 less expensive to check local and IMAP folders than it is to check
21387 other types, like POP or NNTP folders.
21388 You may want to set this secondary value to a higher number than
21389 the primary check interval.
21390 <P>
21391 <UL>
21392 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21393 </UL><P>
21394 &lt;End of help on this topic&gt;
21395 </BODY>
21396 </HTML>
21397 ====== h_config_incoming_list ======
21398 <HTML>
21399 <HEAD>
21400 <TITLE>OPTION: <!--#echo var="VAR_incoming-check-list"--></TITLE>
21401 </HEAD>
21402 <BODY>
21403 <H1>OPTION: <!--#echo var="VAR_incoming-check-list"--></H1>
21404
21405 This option has no effect unless the feature
21406 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
21407 is set, which in turn has no effect unless
21408 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
21409 is set.
21410 <P>
21411 When monitoring the Incoming Message Folders for Unseen messages Alpine will
21412 normally monitor all Incoming Folders.
21413 You may use this option to restrict the list of monitored folders to a
21414 subset of all Incoming Folders.
21415 <P>
21416 <UL>
21417 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21418 </UL><P>
21419 &lt;End of help on this topic&gt;
21420 </BODY>
21421 </HTML>
21422 ====== h_config_pers_name ======
21423 <HTML>
21424 <HEAD>
21425 <TITLE>OPTION: <!--#echo var="VAR_personal-name"--></TITLE>
21426 </HEAD>
21427 <BODY>
21428 <H1>OPTION: <!--#echo var="VAR_personal-name"--></H1>
21429
21430 This value is used to determine the full name part of the "From" address
21431 on messages you send.
21432 <!--chtml if pinemode="os_windows"-->
21433  PC-Alpine requires that this be set in order to properly construct the "From" address.
21434 <!--chtml else-->
21435  If unset, Unix Alpine will obtain your full name from
21436  the system password file. PC-Alpine, on the other hand, requires that this be set.
21437 <!--chtml endif-->
21438 <P>
21439 If you want to change the value of what gets included in the From header
21440 in messages you send (other than just the Personal Name)
21441 look <A HREF="h_config_change_your_from">here</A> for a description.
21442 <P><UL>
21443 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21444 </UL><P>
21445 &lt;End of help on this topic&gt;
21446 </BODY>
21447 </HTML>
21448 ====== h_config_pruned_folders ======
21449 <html>
21450 <header>
21451 <title>OPTION: <!--#echo var="VAR_pruned-folders"--></title>
21452 </header>
21453 <body>
21454 <h1>OPTION: <!--#echo var="VAR_pruned-folders"--></h1>
21455
21456 This variable allows you to define a list of one or more folders that
21457 Alpine will offer to prune for you in the same way it automatically offers
21458 to prune your "sent-mail" folder each month.
21459 Each folder in this list must be a folder in your default folder collection
21460 (the first folder collection if you have more than one), and it is just
21461 the relative name of the folder in the collection, not the fully-qualified name.
21462 It is similar to sent-mail.
21463 Instead of something like
21464 <P>
21465 <CENTER><SAMP><!--#echo var="VAR_pruned-folders"-->={servername}mail/folder</SAMP></CENTER>
21466 <P>
21467 the correct value to use would be
21468 <P>
21469 <CENTER><SAMP>folder</SAMP></CENTER>
21470 <P>
21471 There is an assumption here that your first collection is the folders in
21472 <P>
21473 <CENTER><SAMP>{servername}mail</SAMP></CENTER>
21474 <P>
21475
21476 Once a month, for each folder listed, Alpine will offer to move
21477 the contents of the folder to a new folder of the same name but with
21478 the previous month's date appended.  Alpine will then look for any such
21479 date-appended folder names created for a previous month, and offer each
21480 one it finds for deletion.
21481 <P>
21482
21483 If you decline the first offer, no mail is moved and no new folder is
21484 created.
21485 <P>
21486
21487 The new folders will be created
21488 in your default folder collection.
21489 <P>
21490
21491 <UL>
21492 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21493 </UL><P>
21494 &lt;End of help on this topic&gt;
21495 </body>
21496 </html>
21497 ====== h_config_upload_cmd ======
21498 <HTML>
21499 <HEAD>
21500 <TITLE>OPTION: <!--#echo var="VAR_upload-command"--></TITLE>
21501 </HEAD>
21502 <BODY>
21503 <H1>OPTION: <!--#echo var="VAR_upload-command"--></H1>
21504
21505 This option affects the behavior of the Composer's &quot;Read File&quot;
21506 (^R in the message body) and &quot;Attach File&quot; (^J in the header)
21507 commands.  It specifies
21508 a Unix program name, and any necessary command line arguments, that Alpine can
21509 use to transfer files from your personal computer into messages that you are
21510 composing.<P>
21511
21512 <B>Note:</B> this facility is intended for use with serial line transfer
21513 protocols, such as kermit, xmodem, or zmodem.  It is <B>not</B> intended
21514 to work with TCP/IP file transfer programs such as ftp.<P>
21515
21516 If a program is specified, the commands listed above are modified to offer a
21517 subcommand (^Y) to activate the transfer.  Obviously, the Unix program
21518 specified here must match the transfer program or protocol available on the
21519 personal computer.<P>
21520
21521 Alpine expects to exchange uploaded data via a file on your Unix system.  When
21522 the specified upload program finishes, Alpine expects the uploaded data to be
21523 contained in this file.<P>
21524
21525 When upload is invoked via the &quot;Read File&quot; subcommand, Alpine
21526 generates a
21527 temporary file name that it will pass to the specified Unix program.  Alpine
21528 will read the resulting uploaded text from this file and then delete it when
21529 the upload command is finished.<P>
21530
21531 When upload is invoked via the &quot;Attach File&quot; subcommand, Alpine will
21532 prompt
21533 you for the name of the file that is to contain the uploaded information that
21534 it is to attach.  Alpine will attach this file to the composition, but will
21535 <B>not</B> delete this file after the upload command is finished.<P>
21536
21537 The special token &quot;_FILE_&quot; may be included among the Unix program's
21538 command
21539 line arguments.  Alpine will replace this symbol with the name of the file
21540 being used to exchange the uploaded information.  This token allows you to
21541 position the file name where it is required in the Unix program's command
21542 line arguments.<P>
21543
21544 If the &quot;_FILE_&quot; token is not present in the specified command, the
21545 temporary file's name is automatically appended to the specified Unix
21546 program.  In other words, you don't need to use &quot;_FILE_&quot; if it is the
21547 <B>last</B> command line argument.
21548 <P><UL>
21549 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21550 </UL><P>
21551 &lt;End of help on this topic&gt;
21552 </BODY>
21553 </HTML>
21554 ====== h_config_upload_prefix ======
21555 <HTML>
21556 <HEAD>
21557 <TITLE>OPTION: <!--#echo var="VAR_upload-command-prefix"--></TITLE>
21558 </HEAD>
21559 <BODY>
21560 <H1>OPTION: <!--#echo var="VAR_upload-command-prefix"--></H1>
21561
21562 This option is used in conjunction with the <!--#echo var="VAR_upload-command"--> option.
21563 It defines text to be written to the terminal emulator (via standard output)
21564 immediately prior to starting upload command.  This is useful for
21565 integrated serial line file transfer agents that permit command passing
21566 (e.g., Kermit's APC method).<P>
21567
21568 The special token &quot;_FILE_&quot; may be included in the string specification.
21569 That symbol will be replaced with the (Alpine-created) name of the temporary
21570 file in which Alpine will expect to find the uploaded file.
21571 <P><UL>
21572 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21573 </UL><P>
21574 &lt;End of help on this topic&gt;
21575 </BODY>
21576 </HTML>
21577 ====== h_config_download_cmd ======
21578 <HTML>
21579 <HEAD>
21580 <TITLE>OPTION: <!--#echo var="VAR_download-command"--></TITLE>
21581 </HEAD>
21582 <BODY>
21583 <H1>OPTION: <!--#echo var="VAR_download-command"--></H1>
21584
21585 This option affects the behavior of the Export command.  It specifies a Unix
21586 program name, and any necessary command line arguments, that Alpine can use to
21587 transfer the exported message to your personal computer's disk.<P>
21588 Note: this facility is intended for use with serial line transfer
21589 protocols, such as kermit, xmodem, or zmodem.  It is <B>not</B> intended
21590 to work with TCP/IP file transfer programs such as ftp.<P>
21591 If a program is specified, the Export command is modified to offer a
21592 subcommand (^V) to activate the transfer (in lieu of saving it to
21593  the machine where Alpine is running).  Obviously, the Unix program
21594 specified here must match the transfer program or protocol available on the
21595 personal computer.<P>
21596
21597 When this subcommand is selected and before Alpine invokes the specified Unix
21598 program, Alpine will create a temporary file containing the text of the
21599 exported message.  Alpine uses this file to pass the exported message text to
21600 the specified Unix program.<P>
21601
21602 The special token &quot;_FILE_&quot; may be included among the Unix program's command
21603 line arguments.  Alpine will replace this symbol with the temporary file's name
21604 before executing the Unix program.  This token allows you to position the
21605 file name where it is required in the Unix program's command line arguments.
21606 <P>
21607 If the &quot;_FILE_&quot; token is not present in the specified command, the
21608 temporary file's name is automatically appended to the specified Unix
21609 program.  In other words, you don't need to use &quot;_FILE_&quot; if it is the
21610 <B>last</B> command line argument.
21611 <P><UL>
21612 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21613 </UL><P>
21614 &lt;End of help on this topic&gt;
21615 </BODY>
21616 </HTML>
21617 ====== h_config_download_prefix ======
21618 <HTML>
21619 <HEAD>
21620 <TITLE>OPTION: <!--#echo var="VAR_download-command-prefix"--></TITLE>
21621 </HEAD>
21622 <BODY>
21623 <H1>OPTION: <!--#echo var="VAR_download-command-prefix"--></H1>
21624
21625 This option is used in conjunction with the <!--#echo var="VAR_download-command"--> option.
21626 It defines text to be written to the terminal emulator (via standard output)
21627 immediately prior to starting the download command.  This is useful for
21628 integrated serial line file transfer agents that permit command passing
21629 (e.g., Kermit's APC method).
21630 <P>
21631 The special token &quot;_FILE_&quot; may be included in the string
21632 specification.
21633 That symbol will be replaced with the (Alpine-created) name of the temporary
21634 file into which Alpine will place the message to be downloaded.
21635 <P><UL>
21636 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21637 </UL><P>
21638 &lt;End of help on this topic&gt;
21639 </BODY>
21640 </HTML>
21641 ====== h_config_mailcap_path ======
21642 <HTML>
21643 <HEAD>
21644 <TITLE>OPTION: <!--#echo var="VAR_mailcap-search-path"--></TITLE>
21645 </HEAD>
21646 <BODY>
21647 <H1>OPTION: <!--#echo var="VAR_mailcap-search-path"--></H1>
21648 This variable is used to replace Alpine's default mailcap file search path.
21649 It takes one or more file names (full paths must be specified) in which to
21650 look for mail capability data.  The default search path can be found in this
21651 <A HREF="h_news_config">Alpine Configuration</A> help, near the bottom.
21652 If there is more than one file name listed, list members should be delimited
21653 by
21654 <!--chtml if pinemode="os_windows"-->
21655 a semi-colon (;) under Windows; for example:<PRE>
21656         C:&#92;MYCONFIG&#92;MAILCAP.TXT;H:&#92;NETCONFIG&#92;MAILCAP.TXT
21657 </PRE>
21658 <!--chtml else-->
21659 a colon (:) under UNIX; for example:<PRE>
21660         ~/.mailcap:/etc/mailcap:/usr/etc/mailcap:/usr/local/etc/mailcap
21661 </PRE>
21662 <!--chtml endif-->
21663 <P><UL>
21664 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21665 </UL>
21666 <P>
21667 &lt;End of help on this topic&gt;
21668 </BODY>
21669 </HTML>
21670 ====== h_config_mimetype_path ======
21671 <HTML>
21672 <HEAD>
21673 <TITLE>OPTION: <!--#echo var="VAR_mimetype-search-path"--></TITLE>
21674 </HEAD>
21675 <BODY>
21676 <H1>OPTION: <!--#echo var="VAR_mimetype-search-path"--></H1>
21677
21678 This variable is used to replace Alpine's default mime.types file search path.
21679 It takes one or more file names (full paths must be specified) in which to
21680 look for file-name-extension to MIME type mapping data.  The default search
21681 path can be found in this
21682 <A HREF="h_news_config">Alpine Configuration</A> help.
21683
21684 <P>
21685
21686 If there is more than one file name listed, list members should be delimited
21687 by a colon (:) under UNIX and a semi-colon (;) under Windows.
21688 <P>
21689 &lt;End of help on this topic&gt;
21690 </BODY></HTML>
21691 ====== h_config_set_att_ansi ======
21692 <HTML><HEAD>
21693 <TITLE>OPTION: Set printer to attached ansi printer</TITLE>
21694 </HEAD>
21695 <BODY>
21696 <H1>OPTION: Set printer to attached ansi printer</H1>
21697
21698 Type "S" to set your printer to "attached-to-ansi".<BR>
21699 It is OK to include "attached-to-ansi" in your personal list below.
21700 <P>
21701 &lt;End of help on this topic&gt;
21702 </BODY></HTML>
21703 ====== h_config_set_att_ansi2 ======
21704 <HTML><HEAD>
21705 <TITLE>OPTION: Set printer to attached ansi printer (no formfeed)</TITLE>
21706 </HEAD>
21707 <BODY>
21708 <H1>OPTION: Set printer to attached ansi printer (no formfeed)</H1>
21709
21710 Type "S" to set your printer to "attached-to-ansi-no-formfeed".<BR>
21711 It is OK to include "attached-to-ansi-no-formfeed" in your personal
21712 list below.
21713
21714 <P>
21715
21716 This is the same as the "attached-to-ansi" option except that a
21717 formfeed character will not be appended to the end of the print job.
21718 If your printer already ejects the paper by itself at the end of the
21719 job, you may prefer the "no-formfeed" form of this printer so that you
21720 don't get an extra blank page between print jobs.
21721 <P>
21722
21723 &lt;End of help on this topic&gt;
21724 </BODY></HTML>
21725 ====== h_config_set_att_wyse ======
21726 <HTML><HEAD>
21727 <TITLE>OPTION: Set printer to attached Wyse60 printer</TITLE>
21728 </HEAD>
21729 <BODY>
21730 <H1>OPTION: Set printer to attached Wyse60 printer</H1>
21731
21732 Type "S" to set your printer to "attached-to-wyse".<BR>
21733 It is OK to include "attached-to-wyse" in your personal list below.
21734 <P>
21735 This is very similar to "attached-to-ansi".
21736 The only difference is in the control characters sent to turn the printer
21737 on and off.
21738 The ansi version of the printer uses ESC LEFT_BRACKET 5 i
21739 to turn on the printer and ESC LEFT_BRACKET 4 i
21740 to turn it off.
21741 The Wyse version uses Ctrl-R for on, and Ctrl-T for off.
21742 &lt;End of help on this topic&gt;
21743 </BODY></HTML>
21744 ====== h_config_set_att_wyse2 ======
21745 <HTML><HEAD>
21746 <TITLE>OPTION: Set printer to attached Wyse60 printer (no formfeed)</TITLE>
21747 </HEAD>
21748 <BODY>
21749 <H1>OPTION: Set printer to attached Wyse60 printer (no formfeed)</H1>
21750
21751 Type "S" to set your printer to "attached-to-wyse-no-formfeed".<BR>
21752 It is OK to include "attached-to-wyse-no-formfeed" in your personal
21753 list below.
21754
21755 <P>
21756
21757 This is the same as the "attached-to-wyse" option except that a
21758 formfeed character will not be appended to the end of the print job.
21759 If your printer already ejects the paper by itself at the end of the
21760 job, you may prefer the "no-formfeed" form of this printer so that you
21761 don't get an extra blank page between print jobs.
21762 <P>
21763
21764 &lt;End of help on this topic&gt;
21765 </BODY></HTML>
21766 ====== h_config_set_stand_print ======
21767 <HTML>
21768 <HEAD>
21769 <TITLE>OPTION: Set default printer</TITLE>
21770 </HEAD>
21771 <H1>OPTION: Set default printer</H1>
21772 <BODY>
21773 Move to the printer you want and type "S" to set it to be your
21774 default printer.  This list is not modifiable by you and has been
21775 set up by the system administrators.  If there is more than one printer
21776 listed in the Command List, you will be able to cycle through that
21777 whole list at the time you print, starting with your default.
21778 It is OK to include entries from this Standard list in your personal
21779 list below.
21780 <P>
21781 &lt;End of help on this topic&gt;
21782 </BODY>
21783 </HTML>
21784 ====== h_config_set_custom_print ======
21785 <HTML>
21786 <HEAD>
21787 <TITLE>OPTION: Set default printer</TITLE>
21788 </HEAD>
21789 <H1>OPTION: Set default printer</H1>
21790 <BODY>
21791 You may add as many print commands as you want to your personal list.
21792 Specify one of them as your default printer by moving to the printer
21793 you want and typing "S".  If there is more than one printer listed
21794 in the Command List, you will be able to cycle through that list at
21795 the time you print, starting with your default.  It is OK to include
21796 entries from the Standard list above or to include the command
21797 "attached-to-ansi", "attached-to-ansi-no-formfeed", "attached-to-wyse", or
21798 "attached-to-wyse-no-formfeed" as one of the entries here.
21799 <P>
21800 &lt;End of help on this topic&gt;
21801 </BODY>
21802 </HTML>
21803 ====== h_config_user_id =====
21804 <HTML>
21805 <HEAD>
21806 <TITLE>OPTION: <!--#echo var="VAR_user-id"--></TITLE>
21807 </HEAD>
21808 <BODY>
21809 <H1>OPTION: <!--#echo var="VAR_user-id"--></H1>
21810
21811 This value is used as part of the "From" address on messages you send.
21812 It is also the default login name for remote IMAP server access.  Set this
21813 to the username part you want to appear on outgoing email.
21814 <P>
21815 If you want to change the value of what gets included in the From header
21816 in messages you send (other than just the User ID)
21817 look <A HREF="h_config_change_your_from">here</A> for a description.
21818
21819 <P><UL>
21820 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21821 </UL><P>
21822 &lt;End of help on this topic&gt;
21823 </BODY>
21824 </HTML>
21825 ====== h_config_user_dom =====
21826 <HTML>
21827 <HEAD>
21828 <TITLE>OPTION: <!--#echo var="VAR_user-domain"--></TITLE>
21829 </HEAD>
21830 <BODY>
21831 <H1>OPTION: <!--#echo var="VAR_user-domain"--></H1>
21832
21833 This value specifies the domain part (right-hand side) of your return
21834 address on outgoing email and is also used as the default domain for email
21835 composed to a local user.
21836 <!--chtml if pinemode="os_windows"-->
21837  This value is required for PC-Alpine. If you are unsure as to what this should be,
21838  contact your local help desk, system administrator, or Internet Service Provider.
21839 <!--chtml else-->
21840  If unset, Unix Alpine will obtain the domain from
21841  the system.  Often this value will be set for your whole site by the
21842  system administrator.<P>
21843 <!--chtml endif-->
21844 If you set this, see also the <A HREF="h_config_quell_local_lookup">
21845 &quot;<!--#echo var="FEAT_quell-user-lookup-in-passwd-file"-->&quot;</A> feature.
21846 <P>
21847 If you want to change the value of what gets included in the From header
21848 in messages you send (other than just the User Domain)
21849 look <A HREF="h_config_change_your_from">here</A> for a description.
21850 <P><UL>
21851 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21852 </UL><P>
21853 &lt;End of help on this topic&gt;
21854 </BODY>
21855 </HTML>
21856 ====== h_config_smtp_server =====
21857 <HTML>
21858 <HEAD>
21859 <TITLE>OPTION: <!--#echo var="VAR_smtp-server"--></TITLE>
21860 </HEAD>
21861 <BODY>
21862 <H1>OPTION: <!--#echo var="VAR_smtp-server"--></H1>
21863 This value specifies the name of one or more SMTP
21864 (Simple Mail Transfer Protocol) servers for sending mail.
21865 <!--chtml if pinemode="os_windows"-->
21866 You must have an SMTP server for use with PC-Alpine.
21867 SMTP servers are
21868 normally set up by a system administrator for use by all members of a given
21869 campus or department.
21870 Contact your local help desk to ask what SMTP
21871 servers you should use.
21872 <!--chtml else-->
21873 Unix Alpine users may not need to set an SMTP server.
21874 Alpine will attempt to execute the program (usually sendmail) that is used
21875 to insert mail into the mail system.
21876 If this works for you, you may leave this option blank.
21877 If there is an SMTP server running on the Unix host you may be able to
21878 improve sending performance slightly by setting the SMTP server option
21879 to &quot;localhost&quot; or to the actual name of the Unix host.
21880 <P>
21881 If the Unix host doesn't work the way Alpine was expecting you will need to
21882 set the value of this option.
21883 SMTP servers are
21884 normally set up by a system administrator for use by all members of a given
21885 campus or department.
21886 Contact your local help desk to ask what SMTP
21887 servers you should use.
21888 <!--chtml endif-->
21889 <P>
21890 Your SMTP server may offer SMTP AUTH authentication.
21891 It may even require it.
21892 If your SMTP server offers SMTP AUTH authentication you may specify a
21893 &quot;user&quot; name parameter to cause Alpine to attempt to authenticate.
21894 This parameter requires an associated value,
21895 the username identifier with which to establish the server
21896 connection.
21897 An example might be:
21898
21899 <P>
21900 <CENTER><SAMP>smtpserver.example.com/user=katie</SAMP></CENTER>
21901 <P>
21902
21903 If AUTH authentication is offered by the server, this will cause Alpine to
21904 attempt to use it.
21905 If AUTH authentication is not offered by the server, this will cause Alpine
21906 to fail sending with an error similar to:
21907
21908 <P>
21909 <CENTER><SAMP>Error: SMTP authentication not available</SAMP></CENTER>
21910 <P>
21911
21912 Another type of authentication that is used by some ISPs is called
21913 &quot;POP before SMTP&quot; or &quot;IMAP before SMTP&quot;,
21914 which means that you have to authenticate
21915 yourself to the POP or IMAP server by opening a mailbox before you
21916 can send mail.
21917 To do this, you usually only have to open your INBOX.
21918
21919 <P>
21920 You may tell Alpine to use the
21921 <A HREF="http://www.ietf.org/rfc/rfc2476.txt">Message Submission</A>
21922 port (587) instead of the SMTP port (25) by including the &quot;submit&quot;
21923 parameter
21924 in this option.
21925 At this time &quot;/submit&quot; is simply equivalent to specifying
21926 port 587, though it may imply more than that at some point in the future.
21927 Some ISPs are blocking port 25 in order to reduce the amount of spam
21928 being sent to their users.
21929 You may find that the submit option allows you to get around such a block.
21930
21931 <P>
21932 <CENTER><SAMP>smtpserver.example.com/submit</SAMP></CENTER>
21933 <P>
21934
21935 To specify any non-standard port number on the SMTP server you may follow
21936 the hostname with a colon followed by the portnumber.
21937
21938 <P>
21939 <CENTER><SAMP>smtpserver.example.com:12345</SAMP></CENTER>
21940 <P>
21941
21942 Normally, when a connection is made to the Smtp-Server Alpine will attempt
21943 to negotiate a secure (encrypted) session using Transport Layer Security (TLS).
21944 If that fails then a non-encrypted connection will be attempted instead.
21945 You may specify that a TLS connection is required if you wish.
21946 If you append &quot;/tls&quot; to the name then the connection will fail
21947 instead of falling back to a non-secure connection.
21948
21949 <P>
21950 <CENTER><SAMP>smtpserver.example.com/tls</SAMP></CENTER>
21951 <P>
21952
21953
21954 For more details about server name possibilities see
21955 <A HREF="h_folder_server_syntax">Server Name Syntax</A>.
21956 <P>
21957
21958 <UL>
21959 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21960 </UL>
21961 <P>
21962 &lt;End of help on this topic&gt;
21963 </BODY>
21964 </HTML>
21965 ====== h_config_nntp_server =====
21966 <HTML>
21967 <HEAD>
21968 <TITLE>OPTION: <!--#echo var="VAR_nntp-server"--></TITLE></HEAD>
21969 <BODY>
21970 <H1>OPTION: <!--#echo var="VAR_nntp-server"--></H1>
21971
21972 This value specifies the name of one or more NNTP
21973 (Network News Transfer Protocol)
21974 servers for reading and posting USENET news.
21975 NNTP servers are normally
21976 set up by a system administrator for use by all members of a given campus
21977 or department.
21978 Contact your local help desk to ask what NNTP servers you should use.
21979 <!--chtml if pinemode="os_windows"--><!--chtml else-->
21980 Often Unix Alpine users will find that this variable has been
21981 set for the whole system (and they don't have to worry about it).
21982 <!--chtml endif-->
21983 When you define an NNTP server here, Alpine implicitly defines a news
21984 collection for you, assuming that server as the news server and assuming
21985 that you will use the NNTP protocol and a local newsrc configuration file
21986 for reading news.
21987 For more about reading news with Alpine, see
21988 <A HREF="h_reading_news">how to use Alpine to read news</A>.
21989 <P>
21990 Your NNTP server may offer NNTP &quot;AUTHINFO SASL&quot;
21991 or &quot;AUTHINFO USER&quot; authentication.
21992 It may even require it.
21993 If your NNTP server does offer such authentication you may specify a user name
21994 parameter to cause Alpine to attempt to authenticate.
21995 The same is true for the server name in a folder collection that uses NNTP.
21996 This parameter requires an associated value,
21997 the username identifier with which to establish the server connection.
21998 An example might be:
21999
22000 <P>
22001 <CENTER><SAMP>nntpserver.example.com/user=katie</SAMP></CENTER>
22002 <P>
22003
22004 If authentication is offered by the server, this will cause Alpine to
22005 attempt to use it.
22006 If authentication is not offered by the server, this will cause Alpine
22007 to fail with an error similar to:
22008
22009 <P>
22010 <CENTER><SAMP>Error: NNTP authentication not available</SAMP></CENTER>
22011 <P>
22012 For more details about the server name possibilities see
22013 <A HREF="h_folder_server_syntax">Server Name Syntax</A>.
22014 <P><UL>
22015 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22016 </UL><P>
22017 &lt;End of help on this topic&gt;
22018 </BODY>
22019 </HTML>
22020 ====== h_config_inbox_path =====
22021 <HTML>
22022 <HEAD>
22023 <TITLE>OPTION: <!--#echo var="VAR_inbox-path"--></TITLE>
22024 </HEAD>
22025 <BODY>
22026 <H1>OPTION: <!--#echo var="VAR_inbox-path"--></H1>
22027
22028 This value overrides the default value of your INBOX name/path/location.
22029 <!--chtml if pinemode="os_windows"-->
22030 PC-Alpine users must specify an inbox path and it must be a folder on an
22031 IMAP server.
22032 <!--chtml else-->
22033 Unix and VMS Alpine users will often find that this variable
22034 has been pre-configured by your system administrator.
22035 <!--chtml endif-->
22036 You may be able to specify an alternate INBOX that is either a local folder
22037 or a folder on an IMAP server.
22038 <P>
22039 A typical remote <!--#echo var="VAR_inbox-path"--> entry would be: &#123;monet.art.example.com}INBOX
22040 where &quot;monet.art.example.com&quot; is replaced by the name of your IMAP
22041 mail server.
22042 <P>
22043 See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
22044 details on the syntax of folder definitions.
22045 <P>
22046 See <A HREF="h_info_on_mbox">Missing mail and the mbox driver</A> if your
22047 mail is disappearing.
22048 <P><UL>
22049 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22050 </UL><P>
22051 &lt;End of help on this topic&gt;
22052 </BODY>
22053 </HTML>
22054 ====== h_config_change_your_from =====
22055 <HTML>
22056 <HEAD>
22057 <TITLE>How to Change your From Address</TITLE>
22058 </HEAD>
22059 <BODY>
22060 <H1>How to Change your From Address</H1>
22061
22062 If the From address that Alpine includes in mail that you send is not correct,
22063 you may want to configure a different default value for the From address.
22064 You may follow these directions to change the default:
22065
22066 <P>
22067 <UL>
22068   <LI> Go to the Main Alpine Menu
22069   <LI> From there type the Setup Command
22070   <LI> From there type the Config Command
22071 </UL>
22072
22073 <P>
22074 You've probably already seen this SETUP CONFIGURATION screen.
22075 If not, there are many options you may want to set here.
22076 To set the value of the From header you may use the
22077 <A href="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A> option.
22078 Find it by scrolling down a few pages or use the WhereIs command to
22079 search for &quot;customized&quot;.
22080 You may want to read the help text associated with the option.
22081 <P>
22082 To add a custom From header, type the Add command and enter the
22083 full header line, including the leading &quot;From:&nbsp;&quot;.
22084 For example:
22085 <P>
22086 <CENTER><SAMP>From: Full Name &lt;user@example.com&gt;</SAMP></CENTER>
22087 <P>
22088 Now exit the Setup command and try sending mail to yourself to see
22089 what the From line looks like.
22090 <P>
22091 When you are in the composer you may edit the custom From line by typing
22092 Ctrl-R while your cursor is in the headers of the message and then moving
22093 to the From line and editing.
22094 If you want to leave the default value the same but add the possibility
22095 of being able to edit the header when you compose, add just the header
22096 name without a value.
22097 For example:
22098 <P>
22099 <CENTER><SAMP>From:</SAMP></CENTER>
22100 <P>
22101 If you change your From address you may also find it useful to add the
22102 changed From address to the
22103 <a href="h_config_alt_addresses"><!--#echo var="VAR_alt-addresses"--></a>
22104 configuration option.
22105 <P>
22106 <UL>
22107 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22108 </UL><P>
22109 &lt;End of help on this topic&gt;
22110 </BODY>
22111 </HTML>
22112 ====== h_config_default_fcc =====
22113 <HTML>
22114 <HEAD>
22115 <TITLE>OPTION: <!--#echo var="VAR_default-fcc"--></TITLE>
22116 </HEAD>
22117 <BODY>
22118 <H1>OPTION: <!--#echo var="VAR_default-fcc"--></H1>
22119
22120 This value specifies where a copy of outgoing mail should be saved.  If
22121 this is not a path name, it will be in the default collection for saves.
22122 Any valid folder specification, local or IMAP, is allowed.  This default
22123 folder carbon copy only applies when the
22124 <A HREF="h_config_fcc_rule">&quot;<!--#echo var="VAR_fcc-name-rule"-->&quot;</A>
22125 is set to use the default folder.
22126 <!--chtml if pinemode="os_windows"-->
22127 PC-Alpine default is &quot;SENTMAIL&quot; (normally stored as SENTMAIL.MTX)
22128 <!--chtml else-->
22129 Unix Alpine default
22130 is normally &quot;sent-mail&quot; in the default folder collection.
22131 <!--chtml endif-->
22132 <P>
22133 If you access your email through an IMAP server, especially if you often switch between Unix Alpine
22134 and PC-Alpine, or between various desktop email systems, you may want to set this to a folder on your
22135 IMAP server (remember that in order to later access this remote folder through Alpine, it
22136 must be in a folder collection. See <A HREF="h_what_are_collections">Folder Collections Explained</a>
22137 for more information). An example:<p>
22138 <CENTER><SAMP>{monet.art.example.com}mail/sent-mail</SAMP></CENTER>
22139 <P>
22140 To suppress saving of outgoing mail, set: <!--#echo var="VAR_default-fcc"-->=&quot;&quot;
22141 <P>
22142 See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
22143 details on the syntax of folder definitions.
22144 <P>
22145 <UL>
22146 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22147 </UL><P>
22148 &lt;End of help on this topic&gt;
22149 </BODY>
22150 </HTML>
22151 ====== h_config_def_save_folder =====
22152 <HTML>
22153 <HEAD>
22154 <TITLE>OPTION: <!--#echo var="VAR_default-saved-msg-folder"--></TITLE>
22155 </HEAD>
22156 <BODY>
22157 <H1>OPTION: <!--#echo var="VAR_default-saved-msg-folder"--></H1>
22158
22159 This option determines the default folder name for save-message operations
22160 (&quot;saves&quot;).
22161 <P>
22162 If this is not a path name, it will be in the default collection for saves.
22163 Any valid folder specification, local or IMAP, is allowed.  This default
22164 folder only applies when the
22165 <A HREF="h_config_saved_msg_name_rule">&quot;<!--#echo var="VAR_saved-msg-name-rule"-->&quot;</A>
22166 doesn't override it.
22167 <!--chtml if pinemode="os_windows"-->
22168 PC-Alpine default is &quot;SAVEMAIL&quot; (normally stored as SAVEMAIL.MTX).
22169 <!--chtml else-->
22170 Unix Alpine default
22171 is normally &quot;saved-messages&quot; in the default folder collection.
22172 <!--chtml endif-->
22173 If you access your email through an IMAP server, especially if you often switch between Unix
22174 and PC-Alpine, or between various desktop email systems, you may want to set this to a folder on an
22175 IMAP server (remember that in order to later access this remote folder through Alpine, it
22176 should be in a folder collection. See <A HREF="h_what_are_collections">Folder Collections Explained</a>
22177 for more information). An example:<p>
22178 <CENTER><SAMP>{monet.art.example.com}mail/saved-messages</SAMP></CENTER>
22179 <P>
22180 See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
22181 details on the syntax of folder definitions.
22182 <P>
22183 <UL>
22184 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22185 </UL><P>
22186 &lt;End of help on this topic&gt;
22187 </BODY>
22188 </HTML>
22189 ====== h_config_postponed_folder =====
22190 <HTML>
22191 <HEAD>
22192 <TITLE>OPTION: <!--#echo var="VAR_postponed-folder"--></TITLE>
22193 </HEAD>
22194 <BODY>
22195 <H1>OPTION: <!--#echo var="VAR_postponed-folder"--></H1>
22196
22197 This value overrides the default name for the folder where postponed
22198 messages are saved.  If this is not a path name, it will be in the default
22199 collection for message Saves.  Any valid folder specification, local or
22200 remote, is allowed.
22201 PC-Alpine default
22202 is &quot;POSTPOND&quot; (stored as POSTPOND.MTX).
22203 The Unix Alpine default is normally &quot;postponed-msgs&quot;
22204 in the default collection.
22205 <P>
22206 Tip: If you are using different installations of (PC-)Alpine -- for example, PC-Alpine on your personal
22207 computer at home, and Unix Alpine on campus -- you can postpone a composition begun with one Alpine and
22208 resume it later with the other if you set this option to the <B>same folder on the same IMAP host</B>
22209 in all Alpine copies you use.
22210 (Remember that in order to later access this remote folder through Alpine, it must be in a folder
22211 collection. See <A HREF="h_what_are_collections">Folder Collections Extensions Explained</a>
22212 for more information). An
22213 example:<p>
22214 <CENTER><SAMP>{monet.art.example.com}mail/postponed-msgs</SAMP></CENTER>
22215 <P>
22216 See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
22217 details on the syntax of folder definitions.
22218 <P>
22219 <UL>
22220 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22221 </UL><P>
22222 &lt;End of help on this topic&gt;
22223 </BODY>
22224 </HTML>
22225 ====== h_config_read_message_folder =====
22226 <HTML>
22227 <HEAD>
22228 <TITLE>OPTION: <!--#echo var="VAR_read-message-folder"--></TITLE>
22229 </HEAD>
22230 <BODY>
22231 <H1>OPTION: <!--#echo var="VAR_read-message-folder"--></H1>
22232
22233 By virtue of specifying a folder name here, Alpine will be configured to
22234 save all messages that you have read during a session into the designated
22235 &quot;read messages&quot; folder.  This allows you to more easily distinguish
22236 between your really new email (in your INBOX) and those that you have
22237 already read.  Depending on how you define the
22238 <A HREF="h_config_auto_read_msgs">&quot;auto-move-read-messages&quot;</A>
22239 setting, you may or may not be asked when you quit
22240 Alpine if you want read messages to be moved to this folder.  In either
22241 case, moving the messages means they will be deleted from your INBOX.
22242 <P>
22243 If this is not a path name, it will be in the default collection for
22244 saves.  Any valid folder specification, local or remote (via IMAP), is
22245 allowed.  There is no default for the name of the read message folder.
22246 <P>
22247 See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
22248 details on the syntax of folder definitions.
22249 <P>
22250 <UL>
22251 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22252 </UL><P>
22253 &lt;End of help on this topic&gt;
22254 </BODY>
22255 </HTML>
22256 ====== h_config_form_folder =====
22257 <HTML>
22258 <HEAD>
22259 <TITLE>OPTION: <!--#echo var="VAR_form-letter-folder"--></TITLE>
22260 </HEAD>
22261 <BODY>
22262 <H1>OPTION: <!--#echo var="VAR_form-letter-folder"--></H1>
22263
22264 A &quot;<!--#echo var="VAR_form-letter-folder"-->&quot; is a mail folder that is intended to
22265 contain messages that you have composed and that are intended to be
22266 sent in their original form repeatedly.
22267
22268 <P>
22269 Setting this variable will alter Alpine's usual behavior when you
22270 execute the Compose command.  Normally, Alpine offers a chance to
22271 continue a postponed or interrupted message should one or the other
22272 exist.  When this variable is set to a folder name that exists, Alpine
22273 will also offer the chance to select a message from the folder to
22274 insert into the composer (much like when continuing a postponed message).
22275 The difference, however, is that Alpine will not automatically delete
22276 the selected message from the Form Letter Folder.
22277 <P>
22278 Setting this variable will also affect Alpine's behavior when you
22279 Postpone a message from the composer.  Normally, Alpine simply stashes
22280 the message away in your
22281 &quot;<A HREF="h_config_postponed_folder"><!--#echo var="VAR_postponed-folder"--></A>&quot;.
22282 Regardless of the specified folder's existence, Alpine will ask which
22283 folder you intend the message to be stored in.  Choose the
22284 &quot;F&quot; option to store the message in your Form Letter Folder.
22285 This is the most common way to add a message to the folder.
22286
22287 <P>
22288 Another method of adding messages to the folder is via the Alpine
22289 composer's <SAMP>Fcc:</SAMP> field.  If you are sending a message that
22290 you expect to send in the same form again, you can enter the Form
22291 Letter Folder's name in this field.  Alpine, as usual, will copy the
22292 message as it's sent.  Note, when you later select this message from
22293 your Form Letter Folder, it will have the same recipients as the original
22294 message.
22295
22296 <P>
22297 To delete a message from the Form Letter Folder, you can either select
22298 the folder from a suitable FOLDER LIST screen, or use the Delete
22299 command in the MESSAGE INDEX offered when selecting from the folder as
22300 part of the Compose command.  You can delete a Form Letter Folder just
22301 as any other folder from a suitable FOLDER LIST screen.
22302
22303 <P>
22304 You may find that the <A HREF="h_rules_roles">&quot;Roles&quot;</A>
22305 facility can be used
22306 to replace the Form Letter Folder.
22307
22308 <P>
22309 See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
22310 details on the syntax of folder definitions.
22311
22312 <P>
22313 <UL>
22314 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22315 </UL><P>
22316 &lt;End of help on this topic&gt;
22317 </BODY>
22318 </HTML>
22319 ====== h_config_archived_folders =====
22320 <HTML>
22321 <HEAD>
22322 <TITLE>OPTION: <!--#echo var="VAR_incoming-archive-folders"--></TITLE>
22323 </HEAD>
22324 <BODY>
22325 <H1>OPTION: <!--#echo var="VAR_incoming-archive-folders"--></H1>
22326
22327 This is like
22328 <A HREF="h_config_read_message_folder"><!--#echo var="VAR_read-message-folder"--></A>,
22329 only more general.  You may archive
22330 any of the folders in your incoming collection.  This is a list of folder
22331 pairs, with the first separated from the second in the pair by a space.
22332 The first folder in a pair is the folder you want to archive, and the
22333 second folder is the folder that read messages from the first should be
22334 moved to.  Depending on how you define the
22335 <A HREF="h_config_auto_read_msgs">&quot;auto-move-read-messages&quot;</A>
22336 setting, you may or may not be asked when you
22337 leave the first folder if you want read messages to be moved to the
22338 second folder.  In either case, moving the messages means they will be
22339 deleted from the first folder.
22340 <P>
22341 The name of the first folder in each pair can be either the technical
22342 specification of the folder (like what appears in your configuration file)
22343 or (much easier) the nickname that you gave the folder when you made it
22344 an incoming folder.
22345 <p>
22346 For example:<p>
22347 <CENTER><SAMP>{monet.art.example.com}inbox {monet.art.example.com}mail/inbox-archive</SAMP></CENTER>
22348 <p>or, using nicknames:<p>
22349 <CENTER><SAMP>inbox inbox-archive</SAMP></CENTER>
22350 <P>
22351 If these are not path names, they will be in the default collection for
22352 saves. Any valid folder specification, local or remote (via IMAP), is
22353 allowed. There is no default.
22354 <P>
22355 See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
22356 details on the syntax of folder definitions.
22357 <P>
22358 <UL>
22359 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22360 </UL><P>
22361 &lt;End of help on this topic&gt;
22362 </BODY>
22363 </HTML>
22364 ====== h_config_newsrc_path ======
22365 <HTML>
22366 <HEAD>
22367 <TITLE>OPTION: <!--#echo var="VAR_newsrc-path"--></TITLE>
22368 </HEAD>
22369 <BODY>
22370 <H1>OPTION: <!--#echo var="VAR_newsrc-path"--></H1>
22371
22372 This option overrides the default name Alpine uses for your "newsrc" news
22373 status and subscription file.  If set, Alpine will take this value as the
22374 full pathname for the desired newsrc file.<P>
22375
22376 If this option is <B>not</B> set,
22377 <!--chtml if pinemode="os_windows"-->
22378 PC-Alpine looks first for $HOME&#92;NEWSRC (where $HOME defaults to the root
22379 of the current drive, e.g. &quot;C:&#92;&quot;) and then it looks in the same
22380 directory as your pinerc file for NEWSRC.
22381 <!--chtml else-->
22382 Unix Alpine looks for the file ~/.newsrc (that is, the file named .newsrc in
22383 your account's home directory).
22384 <!--chtml endif-->
22385 <P><UL>
22386 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22387 </UL>
22388 <P>
22389 &lt;End of help on this topic&gt;
22390 </BODY>
22391 </HTML>
22392 ====== h_config_literal_sig =====
22393 <HTML>
22394 <HEAD>
22395 <TITLE>OPTION: <!--#echo var="VAR_literal-signature"--></TITLE>
22396 </HEAD>
22397 <BODY>
22398 <H1>OPTION: <!--#echo var="VAR_literal-signature"--></H1>
22399
22400 With this option your actual signature, as opposed to
22401 the name of a file containing your signature,
22402 is stored in the Alpine configuration file.
22403 If this is defined it takes precedence over the <!--#echo var="VAR_signature-file"--> option.
22404 <P>
22405
22406 This is simply a different way to store the signature.
22407 The signature is stored inside your Alpine configuration file instead of in
22408 a separate file.
22409 Tokens work the same way they do with the
22410 <A HREF="h_config_signature_file"><!--#echo var="VAR_signature-file"--></A> so look there for
22411 help.
22412 <P>
22413
22414 The Setup/Signature command on Alpine's MAIN MENU will edit
22415 the &quot;<!--#echo var="VAR_literal-signature"-->&quot; by default.  However, if no
22416 &quot;<!--#echo var="VAR_literal-signature"-->&quot; is defined and the file named in the
22417 &quot;<!--#echo var="VAR_signature-file"-->&quot; option exists, then the latter will be used
22418 instead.
22419 <P>
22420
22421 The two character sequence &#92;n (backslash followed by
22422 the character n) will be used to signify a line-break in your signature.
22423 You don't have to enter the &#92;n, but it will be visible in the
22424 SETUP CONFIGURATION window after you are done editing the signature.
22425
22426 <P>
22427 <UL>
22428 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22429 </UL><P>
22430 &lt;End of help on this topic&gt;
22431 </BODY>
22432 </HTML>
22433 ====== h_config_signature_file =====
22434 <HTML>
22435 <HEAD>
22436 <TITLE>OPTION: <!--#echo var="VAR_signature-file"--></TITLE>
22437 </HEAD>
22438 <BODY>
22439 <H1>OPTION: <!--#echo var="VAR_signature-file"--></H1>
22440
22441 If a <A HREF="h_config_literal_sig"><!--#echo var="VAR_literal-signature"--></A> option is defined,
22442 then this &quot;<!--#echo var="VAR_signature-file"-->&quot; option will be ignored.
22443 You can tell that that is the case because the value of the
22444 &quot;<!--#echo var="VAR_signature-file"-->&quot; will show up as
22445 <P>
22446 <CENTER><SAMP>&lt;Ignored: using <!--#echo var="VAR_literal-signature"--> instead&gt;</SAMP></CENTER>
22447 <P>
22448 You may either use all Literal Signatures (signatures stored in your
22449 configuration file) throughout Alpine, or all signature files.
22450 You can't mix the two.
22451 <P>
22452 This is the name of a file that will be automatically inserted into
22453 outgoing messages.
22454 It typically contains information such as your
22455 name, email address and organizational affiliation.
22456 Alpine adds the
22457 signature into the message as soon as you enter the composer so you
22458 can choose to remove it or edit it on a message by message basis.
22459 Signature file placement in message replies is controlled by the
22460 &quot;<A HREF="h_config_sig_at_bottom"><!--#echo var="FEAT_signature-at-bottom"--></A>&quot;
22461 setting in the feature list.
22462 <P>
22463
22464 The default file name is
22465 <!--chtml if pinemode="os_windows"-->
22466 &quot;PINE.SIG&quot; in the same directory as your PINERC file if your
22467 PINERC file is a local file.
22468 If your PINERC file is remote, then it will be in the directory specified
22469 by the &quot;-aux local_directory&quot; command line option.
22470 <!--chtml else-->
22471 &quot;.signature&quot;.
22472 <!--chtml endif-->
22473 <P>
22474
22475 To create or edit your signature file choose Setup from the MAIN MENU
22476 and then select S for Signature (Main/Setup/Signature).  This puts you
22477 into the Signature Editor where you can enter a <EM>few</EM> lines of
22478 text containing your identity and affiliation.
22479
22480 <P>
22481 If the filename is followed by a vertical bar (|) then instead
22482 of reading the contents of the file the file is assumed to be a
22483 program that will produce the text to be used on its standard output.
22484 The program can't have any arguments and doesn't receive any input from Alpine,
22485 but the rest of the processing works as if the contents came from a file.
22486
22487 <P>
22488 Instead of storing the data in a local file, the
22489 signature data may be stored remotely in an IMAP folder.
22490 In order to do this,
22491 you must use a remote name for the file.
22492 A remote <!--#echo var="VAR_signature-file"--> name might look like:
22493 <P>
22494 <CENTER><SAMP>{myimaphost.myschool.k12.wa.us}mail/signature</SAMP></CENTER>
22495 <P>
22496
22497 The syntax used here is the same as the syntax used for remote configuration
22498 files from the command line.
22499 Note that you may not access an existing signature file remotely,
22500 you have to create a new <EM>folder</EM> that contains the signature data.
22501 If the name you use here for the signature file is a remote name, then when
22502 you edit the file from the Setup/Signature command the data will be stored
22503 remotely in the folder.
22504 You aren't required to do anything special to create the folder, it
22505 gets created automatically if you use a remote name.
22506
22507 <P>
22508 Besides regular text, the signature file may also contain
22509 (or a signature program may produce) tokens that
22510 are replaced with text that usually depends on the message you are replying
22511 to or forwarding.
22512 For example, if the signature file contains the token
22513 <P>
22514 <CENTER><SAMP>_DATE_</SAMP></CENTER>
22515 <P>
22516 anywhere in the text, then that token is replaced by the date
22517 the message you are replying to or forwarding was sent.
22518 If it contains
22519 <P>
22520 <CENTER><SAMP>_CURDATE_</SAMP></CENTER>
22521 <P>
22522 that is replaced with the current date.
22523 The first is an example of a token that depends on the message you
22524 are replying to (or forwarding) and the second is an example which
22525 doesn't depend on anything other than the current date.
22526 You have to be a little careful with this facility since tokens that
22527 depend on the message you are replying to or forwarding will be replaced
22528 by nothing in the case where you are composing a new message from scratch.
22529 The use of <A HREF="h_rules_roles">&quot;roles&quot;</A> may help you
22530 in this respect.
22531 It allows you to use different signature files in different cases.
22532 <P>
22533
22534 The list of tokens available for use in the signature file is
22535 <A HREF="h_index_tokens">here</A>.
22536 <P>
22537
22538 Instead of, or along with the use of &quot;roles&quot; to give you
22539 different signature files in different situations, there is also
22540 a way to conditionally include text based
22541 on whether or not a token would result in specific replacement text.
22542 For example, you could include some text based on whether or not
22543 the _NEWS_ token would result in any newsgroups if it was used.
22544 This is explained in detail
22545 <A HREF="h_reply_token_conditionals">here</A>.
22546 This isn't for the faint of heart.
22547 <P>
22548 In the very unlikely event that you want to include a literal token
22549 in the signature you must precede it with a backslash character.
22550 For example,
22551 <P>
22552 <CENTER><SAMP>&#92;_DAYDATE_ = _DAYDATE_</SAMP></CENTER>
22553 <P>
22554 would produce something like
22555 <P>
22556 <CENTER><SAMP>_DAYDATE_ = Sat, 24 Oct 1998</SAMP></CENTER>
22557 <P>
22558 It is not possible to have a literal backslash followed by an expanded token.
22559 <P>
22560 An alternate method for storing the signature data is available by using the
22561 <A HREF="h_config_literal_sig"><!--#echo var="VAR_literal-signature"--></A> configuration option.
22562 This variable will be used by default.
22563 <P>
22564 <UL>
22565 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22566 </UL><P>
22567 &lt;End of help on this topic&gt;
22568 </BODY>
22569 </HTML>
22570 ====== h_config_init_cmd_list =====
22571 <HTML>
22572 <HEAD>
22573 <TITLE>OPTION: <!--#echo var="VAR_initial-keystroke-list"--></TITLE>
22574 </HEAD>
22575 <BODY>
22576 <H1>OPTION: <!--#echo var="VAR_initial-keystroke-list"--></H1>
22577
22578 The initial keystroke--or command--list option lets you start Alpine at
22579 any place you like.
22580 Whatever keystrokes you specify here will be executed
22581 by Alpine upon startup as a macro.
22582 The words SPACE, TAB, DOWN, UP, LEFT, and
22583 RIGHT indicate the pressing of those keys.
22584 CR indicates the pressing of the RETURN key.
22585 F1 through F12 represent the function keys, and ^ followed
22586 by a character indicates that key pressed along with the control key (in
22587 other words, ^P means Ctrl-P).
22588 As a shortcut notation, an element of the list may be several characters
22589 surrounded by double-quotes (").
22590 That will be expanded into the individual keystrokes
22591 (excluding the double-quote characters).
22592 For example, the quoted-string
22593
22594 <P><CENTER>"ABC"</CENTER>
22595
22596 <P>
22597 is interpreted the same as the three separate list members
22598
22599 <P><CENTER>A and B and C</CENTER>
22600
22601 <P>
22602 which is also the same as
22603
22604 <P><CENTER>A,B,C</CENTER>
22605
22606 <P>
22607 An example: To view message 1 on startup,
22608 you could use an <!--#echo var="VAR_initial-keystroke-list"--> equal to
22609
22610 <P><CENTER>I,J,1,CR,V</CENTER>
22611
22612 <P>
22613 An equivalent version of this is
22614
22615 <P><CENTER>"IJ1",CR,V</CENTER>
22616
22617 <P>
22618 Restrictions: You cannot pre-type into the composer with the initial
22619 keystroke list, and you cannot mix function key commands with letter
22620 commands.
22621
22622 <P><UL>
22623 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22624 </UL>
22625 <P>
22626 &lt;End of help on this topic&gt;
22627 </BODY>
22628 </HTML>
22629 ====== h_config_comp_hdrs =====
22630 <html>
22631 <header>
22632 <title>OPTION: <!--#echo var="VAR_default-composer-hdrs"--></title>
22633 </header>
22634 <body>
22635 <h1>OPTION: <!--#echo var="VAR_default-composer-hdrs"--></h1>
22636
22637 You can control which headers you want visible when composing outgoing
22638 email using this option.
22639 You can specify any of the regular set, any
22640 <A HREF="h_compose_richhdr">Rich Header</A>,
22641 or any <A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A>
22642 that you have already defined.
22643 If you use this setting at all, you must specify all the
22644 headers you want to see, you can't just add to the regular header set.
22645 The default set is To:, Cc:, Attchmnt:, and Subject:.<p>
22646
22647 Note that the "Newsgroups:" header will be abbreviated in the Composer
22648 display, but should be spelled out in full here.<p>
22649 <UL>
22650 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22651 </UL><P>
22652 &lt;End of help on this topic&gt;
22653 </body>
22654 </html>
22655 ====== h_config_custom_hdrs =====
22656 <HTML>
22657 <HEAD>
22658 <TITLE>OPTION: <!--#echo var="VAR_customized-hdrs"--></TITLE>
22659 </HEAD>
22660 <BODY>
22661 <H1>OPTION: <!--#echo var="VAR_customized-hdrs"--></H1>
22662
22663 You may add your own custom headers to outgoing messages.
22664 Each header you specify here must include the header tag
22665 (<A HREF="h_composer_reply_to">Reply-To:</A>, Approved:, etc.)
22666 and may optionally include a value for that header.
22667 If you want to see these custom headers each time you compose a message,
22668 you must add them to your
22669 <A HREF="h_config_comp_hdrs"><!--#echo var="VAR_default-composer-hdrs"--></A> list,
22670 otherwise they become part
22671 of the rich header set that you only see when you press the
22672 <A HREF="h_compose_richhdr">Rich Header</A>
22673 <!--chtml if pinemode="function_key"-->(F5)
22674 <!--chtml else-->(Ctrl-R)<!--chtml endif--> command.
22675 (If you are looking for a way to change which headers are <EM>displayed</EM>
22676 when you view a message, take a look at the
22677 <A HREF="h_config_viewer_headers"><!--#echo var="VAR_viewer-hdrs"--></A>
22678 option instead.)
22679 Here's an example that shows how you might set your From address
22680 <P>
22681 <CENTER><SAMP>From: Full Name &lt;user@example.com&gt;</SAMP></CENTER>
22682 <P>
22683 and another showing how you might set a Reply-To address
22684 <P>
22685 <CENTER><SAMP>Reply-To: user@example.com</SAMP></CENTER>
22686 <P>
22687 You may also set non-standard header values here.
22688 For example, you could add
22689 <P>
22690 <CENTER><SAMP>Organization: My Organization Name</SAMP></CENTER>
22691 <P>
22692 or even
22693 <P>
22694 <CENTER><SAMP>X-Favorite-Colors: Purple and Gold</SAMP></CENTER>
22695 <P>
22696 If you include a value after the colon then that header will be included
22697 in your outgoing messages unless you delete it before sending.
22698 If a header in the <!--#echo var="VAR_customized-hdrs"--> list has only a tag but no value, then
22699 it will not be included in outgoing messages unless you edit a value
22700 in manually.
22701 For example, if
22702 <P>
22703 <CENTER><SAMP>Reply-To:</SAMP></CENTER>
22704 <P>
22705 is in the list, then the Reply-To header will be available for editing
22706 but won't be included unless a value is added while in the composer.
22707 <P>
22708 It's actually a little more complicated than that.
22709 The values of headers that you set with the <!--#echo var="VAR_customized-hdrs"--> option are
22710 defaults.
22711 If the message you are about to compose already has a value for a header,
22712 that value is used instead of a value from your <!--#echo var="VAR_customized-hdrs"-->.
22713 For example, if you are Replying to a message the Subject field
22714 will already be filled in.
22715 In that case, if the <!--#echo var="VAR_customized-hdrs"--> list contains a Subject line, the
22716 custom subject will <EM>NOT</EM> be used.
22717 The subject derived from the subject of the message you are Replying
22718 to will be used instead.
22719 <P>
22720 It is also possible to make header setting even more complicated and more
22721 automatic by using
22722 <A HREF="h_rules_roles">Roles</A>,
22723 but if all you want to do is set a default value for a header, you don't
22724 need to think about Roles.
22725 <P>
22726 If you change your From address you may also find it useful to add the
22727 changed From address to the
22728 <a href="h_config_alt_addresses"><!--#echo var="VAR_alt-addresses"--></a>
22729 configuration option.
22730 <P>
22731 Limitation: Because commas are used to separate the list of
22732 <!--#echo var="VAR_customized-hdrs"-->, it is not possible to have the value of a
22733 header contain a comma.
22734 Nor is there currently an &quot;escape&quot; mechanism provided
22735 to make this work.
22736 <P><UL>
22737 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22738 </UL>
22739 <P>
22740 &lt;End of help on this topic&gt;
22741 </BODY>
22742 </HTML>
22743 ====== h_config_viewer_headers =====
22744 <HTML>
22745 <HEAD>
22746 <TITLE>OPTION: <!--#echo var="VAR_viewer-hdrs"--></TITLE>
22747 </HEAD>
22748 <BODY>
22749 <H1>OPTION: <!--#echo var="VAR_viewer-hdrs"--></H1>
22750
22751 You may change the default list of headers that are viewed by listing
22752 the headers you want to view here.  If the headers in your
22753 &quot;<!--#echo var="VAR_viewer-hdrs"-->&quot; list are present in the message, then they
22754 will be shown.  The order of the headers you list will be honored.  If
22755 the special value &quot;all-except&quot; is included as the first
22756 header in the &quot;<!--#echo var="VAR_viewer-hdrs"-->&quot; list, then all headers in the
22757 message except those in the list will be shown.  The values are all
22758 case insensitive.
22759
22760 <P>
22761 Note that once you put anything in the &quot;<!--#echo var="VAR_viewer-hdrs"-->&quot; list,
22762 then the original default headers are ignored.  So, if you just wanted
22763 to add the header Organization to the list, you would have to list
22764 Organization plus all of the other headers originally in the default
22765 list.  If you just included Organization and nothing else, then you
22766 would see only the Organization header, nothing else.
22767
22768 <P>
22769 The default list of headers includes:
22770 <UL>
22771   <LI>From
22772   <LI>Resent-From
22773   <LI>To
22774   <LI>Resent-To
22775   <LI>Cc
22776   <LI>Resent-cc
22777   <LI>Bcc
22778   <LI>Newsgroups
22779   <LI>Followup-To
22780   <LI>Date
22781   <LI>Resent-Date
22782   <LI>Subject
22783   <LI>Resent-Subject
22784   <LI>Reply-To
22785 </UL>
22786
22787 <P>
22788 If you are looking for a way to control which headers are included in
22789 outgoing mail and are visible or not in the composer, take a look at the
22790 options
22791 <A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A>
22792 and <A HREF="h_config_comp_hdrs"><!--#echo var="VAR_default-composer-hdrs"--></A> instead of
22793 this option.
22794 <P>
22795 <UL>
22796 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22797 </UL><P>
22798 &lt;End of help on this topic&gt;
22799 </BODY>
22800 </HTML>
22801 ====== h_config_viewer_margin_left =====
22802 <HTML>
22803 <HEAD>
22804 <TITLE>OPTION: <!--#echo var="VAR_viewer-margin-left"--></TITLE>
22805 </HEAD>
22806 <BODY>
22807 <H1>OPTION: <!--#echo var="VAR_viewer-margin-left"--></H1>
22808
22809 This variable controls the left-hand vertical margin's width in
22810 Alpine's Message Viewing screen.
22811 Its value is the number of space characters preceding each displayed line.
22812 For consistency with
22813 <A HREF="h_config_viewer_margin_right"><!--#echo var="VAR_viewer-margin-right"--></A>,
22814 you may specify the column number to start in
22815 (column numbering begins with number 1)
22816 instead of the width of the margin by appending a lower case letter
22817 &quot;c&quot; to the number.
22818 For example, a value of &quot;2c&quot; means to start the text in column two,
22819 which is entirely equivalent to a value of &quot;1&quot;, which means to
22820 leave a margin of 1 space.
22821 <P>
22822 The default is a left margin of 0 (zero).
22823 Misconfigurations (for example, negative values or values with starting
22824 left columns greater than the ending right column)
22825 are silently ignored.
22826 If the number of columns for text between the <!--#echo var="VAR_viewer-margin-left"--> and
22827 the <!--#echo var="VAR_viewer-margin-right"--> is fewer than 8, then margins of zero will be used
22828 instead.
22829
22830 <P>
22831 &lt;End of help on this topic&gt;
22832 </BODY>
22833 </HTML>
22834 ====== h_config_viewer_margin_right =====
22835 <HTML>
22836 <HEAD>
22837 <TITLE>OPTION: <!--#echo var="VAR_viewer-margin-right"--></TITLE>
22838 </HEAD>
22839 <BODY>
22840 <H1>OPTION: <!--#echo var="VAR_viewer-margin-right"--></H1>
22841
22842 This variable controls the right-hand vertical margin's width in
22843 Alpine's Message Viewing screen.
22844 Its value is the number of space characters following each displayed line.
22845 You may specify the column number to end the text in
22846 (column numbering begins with number 1)
22847 instead of the width of the margin by appending a lower case letter
22848 &quot;c&quot; to the number.
22849 For example, a value of &quot;76c&quot; means to end the text in column 76.
22850 If the screen is 80 characters wide, this is equivalent to a value
22851 of &quot;4&quot;, which means to leave a margin of 4 spaces.
22852 However, if you use different size screens at different times, then these
22853 two values are not equivalent.
22854 <P>
22855 The default right margin is 4.
22856 Misconfigurations (for example, negative values or values with starting
22857 left columns greater than the ending right column)
22858 are silently ignored.
22859 If the number of columns for text between the
22860 <A HREF="h_config_viewer_margin_left"><!--#echo var="VAR_viewer-margin-left"--></A> and
22861 the <!--#echo var="VAR_viewer-margin-right"--> is fewer than 8, then margins of zero will be used
22862 instead.
22863
22864 <P>
22865 &lt;End of help on this topic&gt;
22866 </BODY>
22867 </HTML>
22868 ====== h_config_quote_suppression =====
22869 <HTML>
22870 <HEAD>
22871 <TITLE>OPTION: <!--#echo var="VAR_quote-suppression-threshold"--></TITLE>
22872 </HEAD>
22873 <BODY>
22874 <H1>OPTION: <!--#echo var="VAR_quote-suppression-threshold"--></H1>
22875
22876 This option should be used with care.
22877 It will cause some of the quoted text to be eliminated from the
22878 display when viewing a message in the MESSAGE TEXT screen.
22879 For example, if you set the <!--#echo var="VAR_quote-suppression-threshold"--> to the
22880 value &quot;5&quot;,
22881 this will cause quoted text that is longer than five lines to be truncated.
22882 Quoted text of five or fewer consecutive lines will be displayed in its entirety.
22883 Quoted text of more than six lines will have the first five lines displayed
22884 followed by a line that looks something like
22885 <P>
22886 <CENTER><SAMP>[ 12 lines of quoted text hidden from view ]</SAMP></CENTER>
22887 <P>
22888 As a special case, if exactly one line of quoted text would be hidden, the
22889 entire quote will be shown instead.
22890 So for the above example, quoted text that is exactly six lines long will
22891 will be shown in its entirety.
22892 (In other words, instead of hiding a single line and adding a line
22893 that announces that one line was hidden, the line is just shown.)
22894 <P>
22895 If the sender of a message has carefully chosen the quotes that he or she
22896 includes, hiding those quotes may change the meaning of the message.
22897 For that reason, Alpine requires that when you want to set the value of this
22898 variable to something less than four lines, you actually have to set it
22899 to the negative of that number.
22900 So if you want to set this option to &quot;3&quot;, you actually have to
22901 set it to &quot;-3&quot;.
22902 The only purpose of this is to get you to think about whether or not you
22903 really want to do this!
22904 If you want to delete all quoted text you set the value of this option
22905 to the special value &quot;-10&quot;.
22906 <P>
22907 The legal values for this option are
22908 <P>
22909 <TABLE>
22910 <TR>
22911   <TD> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </TD>
22912   <TD> Default, don't hide anything </TD>
22913 </TR>
22914 <TR>
22915   <TD> &nbsp;-1,-2,-3&nbsp;&nbsp; </TD>
22916   <TD> Suppress quote lines past 1, 2, or 3 lines </TD>
22917 </TR>
22918 <TR>
22919   <TD> &nbsp;4,5,6,...&nbsp; </TD>
22920   <TD> Suppress if more than that many lines </TD>
22921 </TR>
22922 <TR>
22923   <TD> &nbsp;&nbsp;&nbsp;-10&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </TD>
22924   <TD> Suppress all quoted lines </TD>
22925 </TR>
22926 </TABLE>
22927 <P>
22928 If you set this option to a non-default value you may sometimes wish to
22929 view the quoted text that is not shown.
22930 When this is the case, the
22931 <A HREF="h_common_hdrmode">HdrMode Command</A>
22932 may be used to show the hidden text.
22933 Typing the &quot;H&quot; command once will show the hidden text.
22934 Typing a second &quot;H&quot; will also turn on Full Header mode.
22935 The presence or absence of the HdrMode command is determined by the
22936 <A HREF="h_config_enable_full_hdr">&quot;<!--#echo var="FEAT_enable-full-header-cmd"-->&quot;</A>
22937 Feature-List option in your Alpine configuration, so you will want to
22938 be sure that is turned on if you use quote suppression.
22939 <P>
22940 For the purposes of this option, a quote is a line that begins with the
22941 character &quot;&gt;&quot;.
22942 <P>
22943 Quotes are only suppressed when displaying a message on the screen.
22944 The entire quote will be left intact when printing or forwarding or something
22945 similar.
22946 <P>
22947 &lt;End of help on this topic&gt;
22948 </BODY>
22949 </HTML>
22950 ====== h_config_saved_msg_name_rule =====
22951 <HTML>
22952 <HEAD>
22953 <TITLE>OPTION: <!--#echo var="VAR_saved-msg-name-rule"--></TITLE>
22954 </HEAD>
22955 <BODY>
22956 <H1>OPTION: <!--#echo var="VAR_saved-msg-name-rule"--></H1>
22957
22958 This option determines the default folder name when saving
22959 a message.
22960
22961 <P>
22962 The default option is &quot;default-folder&quot;, which is the folder
22963 called &quot;saved-messages&quot; in Unix Alpine and
22964 &quot;savemail&quot; in PC-Alpine.  To change the default folder, modify
22965 the Alpine option called
22966 <A HREF="h_config_def_save_folder">&quot;<!--#echo var="VAR_default-saved-msg-folder"-->&quot;</A>.
22967
22968 <P>
22969 Choosing any of the &quot;by-&quot; options cause Alpine to attempt to
22970 get the chosen option's value for the message being saved (or for the
22971 first message being saved if using an aggregrate save).
22972 For example, if &quot;by-from&quot; is chosen, Alpine attempts to get the
22973 value of who the message came from (i.e. the from address).
22974 Alpine then attempts to save the message to a folder matching that value.
22975 If &quot;by-from&quot; is chosen and no value is obtained, Alpine uses
22976 &quot;by-sender&quot;.
22977 The opposite is also true.
22978 If &quot;by-recipient&quot; is chosen and the message was posted to a
22979 newsgroup, Alpine will use the newsgroup name.
22980 If &quot;by-replyto&quot; is chosen and no value is obtained, Alpine uses
22981 &quot;by-from&quot;.
22982
22983 <P>
22984 If any of the &quot;by-realname&quot; options are chosen, Alpine will attempt
22985 to use the personal name part of the address instead of the mailbox part.
22986 If any of the &quot;by-nick&quot; options are chosen, the
22987 address is looked up in your address book and if found, the
22988 nickname for that entry is used.
22989 Only simple address book entries are checked, not distribution lists.
22990 Similarly, if any of the
22991 &quot;by-fcc&quot; options are chosen, the fcc from the corresponding
22992 address book entry is used.
22993 If by-realname, or the by-nick or by-fcc lookups result in no value,
22994 then if the chosen option ends with the &quot;then-from&quot;,
22995 &quot;then-sender&quot;, &quot;then-replyto&quot;,
22996 or &quot;then-recip&quot; suffix, Alpine
22997 reverts to the same behavior as &quot;by-from&quot;,
22998 &quot;by-sender&quot;, &quot;by-replyto&quot;, or &quot;by-recip&quot;
22999 depending on which option was specified.
23000 If the chosen option doesn't end with one of
23001 the &quot;then-&quot; suffixes, then Alpine reverts to the default
23002 folder when no match is found in the address book.
23003
23004 <P>
23005 Choosing the option called &quot;last-folder-used&quot;, causes Alpine
23006 to save to the folder that you saved to the last time you saved a
23007 message.  The first time you save a message in an Alpine session, Alpine
23008 attempts to save the message to the default folder.
23009
23010 <P>
23011 Here is an example to make some of the options clearer.
23012 If the message is From
23013 <P>
23014 <CENTER><SAMP>Fred Flintstone &lt;flint@bedrock.org&gt;</SAMP></CENTER>
23015 <P>
23016 and this rule is set to &quot;by-from&quot;, then the default folder offered
23017 in the save dialog would be &quot;flint&quot;.
23018 <P>
23019 If this rule is set to &quot;by-realname-of-from&quot; then the default would
23020 be &quot;Fred Flintstone&quot;.
23021 <P>
23022 If this rule is set to &quot;by-nick-of-from&quot; then Alpine will search
23023 for the address &quot;flint@bedrock.org&quot; in your address book.
23024 If an entry is found and it has a nickname associated with it, that nickname
23025 will be offered as the default folder.
23026 If not, the default saved message folder will be offered as the default.
23027 <P>
23028 If this rule is set to &quot;by-fcc-of-from&quot; then Alpine will search
23029 for the address &quot;flint@bedrock.org&quot; in your address book.
23030 If an entry is found and it has an Fcc associated with it, that Fcc
23031 will be offered as the default folder.
23032 If not, the default saved message folder will be offered as the default.
23033 <P>
23034 If this rule is set to &quot;by-nick-of-from-then-from&quot; then Alpine will search
23035 for the address &quot;flint@bedrock.org&quot; in your address book.
23036 If an entry is found and it has a nickname associated with it, that nickname
23037 will be offered as the default folder.
23038 If it is not found (or has no nickname) then the default offered will be
23039 the same as it would be for the &quot;by-from&quot; rule.
23040 That is, it would be &quot;flint&quot;
23041 <P>
23042 <UL>
23043 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23044 </UL><P>
23045 &lt;End of help on this topic&gt;
23046 </BODY>
23047 </HTML>
23048 ====== h_config_fcc_rule =====
23049 <HTML>
23050 <HEAD>
23051 <TITLE>OPTION: <!--#echo var="VAR_fcc-name-rule"--></TITLE>
23052 </HEAD>
23053 <BODY>
23054 <H1>OPTION: <!--#echo var="VAR_fcc-name-rule"--></H1>
23055
23056 This option determines the default name for folder carbon copy. Choose
23057 one:
23058
23059 <DL>
23060 <DT>default-fcc</DT>
23061 <DD>This is the normal default, the value of which is set in the
23062 &quot;<!--#echo var="VAR_default-fcc"-->&quot; variable as specified earlier in this
23063 configuration.
23064 </DD>
23065
23066 <DT>last-fcc-used</DT>
23067 <DD> Causes Alpine to use the folder that was last
23068 used in the fcc field
23069 </DD>
23070
23071 <DT>by-nickname</DT>
23072 <DD>Means that Alpine will use the nickname
23073 from your address book that matches the first address in the To line.
23074 If there is no match, it will use the value of the
23075 &quot;<!--#echo var="VAR_default-fcc"-->&quot; variable.
23076 </DD>
23077
23078 <DT>by-recipient</DT>
23079 <DD>Means Alpine will form a folder name
23080 based on the left hand side of the first address in the To line.
23081 </DD>
23082
23083 <DT>by-nick-then-recip</DT>
23084 <DD>Means that it will use the
23085 matching nickname from your address book if there is one, otherwise it
23086 will extract the recipient name from the address and use that (like
23087 by-recipient).
23088 </DD>
23089
23090 <DT>current-folder</DT>
23091 <DD>Causes a copy to be written to
23092 the currently open folder, unless that is the INBOX.  In the case
23093 where the current folder is the INBOX, the &quot;<!--#echo var="VAR_default-fcc"-->&quot; is
23094 used instead.
23095 </DD>
23096 </DL>
23097
23098 <P>
23099 Note: Whatever the fcc specified by the rule here, it will be
23100 over-ridden by any fcc entries you have in your address book.
23101
23102 <P>
23103 <UL>
23104 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23105 </UL><P>
23106 &lt;End of help on this topic&gt;
23107 </BODY>
23108 </HTML>
23109 ====== h_config_sort_key =====
23110 <HTML>
23111 <HEAD>
23112 <TITLE>OPTION: <!--#echo var="VAR_sort-key"--></TITLE>
23113 </HEAD>
23114 <BODY>
23115 <H1>OPTION: <!--#echo var="VAR_sort-key"--></H1>
23116
23117 This option determines the order in which messages will be displayed in
23118 the MESSAGE INDEX screen.  Choose from:
23119 <P>
23120 <UL>
23121  <LI> <A HREF="h_index_sort_arrival">Arrival</A>
23122  <LI> <A HREF="h_index_sort_date">Date</A>
23123  <LI> <A HREF="h_index_sort_subj">Subject</A>
23124  <LI> <A HREF="h_index_sort_ordsubj">OrderedSubj</A>
23125  <LI> <A HREF="h_index_sort_thread">Thread</A>
23126  <LI> <A HREF="h_index_sort_from">From</A>
23127  <LI> <A HREF="h_index_sort_size">Size</A>
23128  <LI> <A HREF="h_index_sort_score">Score</A>
23129  <LI> <A HREF="h_index_sort_to">To</A>
23130  <LI> <A HREF="h_index_sort_cc">Cc</A>
23131 </UL>
23132
23133 <P>
23134 Each type of sort may also be reversed.
23135 Normal default is by &quot;Arrival&quot;.
23136
23137 <P>
23138 A possible point of confusion arises when you change the configuration
23139 of the <!--#echo var="VAR_sort-key"-->.
23140 The folder will normally be re-sorted when you go back to viewing the
23141 index.
23142 However, if you have manually sorted the folder with the
23143 Sort
23144 (<!--chtml if pinemode="function_key"-->F7<!--chtml else-->$<!--chtml endif-->)
23145 command, then it will not be re-sorted until the next time it is opened.
23146
23147 <P>
23148 <UL>
23149 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23150 </UL><P>
23151 &lt;End of help on this topic&gt;
23152 </BODY>
23153 </HTML>
23154 ====== h_config_other_startup =====
23155 <HTML>
23156 <HEAD>
23157 <TITLE>OPTION: Set Startup Rule</TITLE>
23158 </HEAD>
23159 <BODY>
23160 <H1>OPTION: Set Startup Rule</H1>
23161
23162 This option determines which message will be the <EM>current message</EM> when
23163 the folder is first opened.
23164 It works the same way that the option
23165 <A HREF="h_config_inc_startup"><!--#echo var="VAR_incoming-startup-rule"--></A>
23166 works, so look there for help.
23167 It may be used for any folder, not just incoming folders.
23168
23169 <P>
23170 <UL>
23171 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23172 </UL><P>
23173 &lt;End of help on this topic&gt;
23174 </BODY>
23175 </HTML>
23176 ====== h_config_perfolder_sort =====
23177 <HTML>
23178 <HEAD>
23179 <TITLE>Set Sort Order</TITLE>
23180 </HEAD>
23181 <BODY>
23182 <H1>Set Sort Order</H1>
23183
23184 This option determines the order in which messages will be displayed in
23185 the MESSAGE INDEX screen when the Current Folder Type set in the
23186 Pattern is a match. Choose from:
23187 <P>
23188 <UL>
23189  <LI> <A HREF="h_index_sort_default">Default</A>
23190  <LI> <A HREF="h_index_sort_arrival">Arrival</A>
23191  <LI> <A HREF="h_index_sort_date">Date</A>
23192  <LI> <A HREF="h_index_sort_subj">Subject</A>
23193  <LI> <A HREF="h_index_sort_ordsubj">OrderedSubj</A>
23194  <LI> <A HREF="h_index_sort_thread">Thread</A>
23195  <LI> <A HREF="h_index_sort_from">From</A>
23196  <LI> <A HREF="h_index_sort_size">Size</A>
23197  <LI> <A HREF="h_index_sort_score">Score</A>
23198  <LI> <A HREF="h_index_sort_to">To</A>
23199  <LI> <A HREF="h_index_sort_cc">Cc</A>
23200 </UL>
23201
23202 <P>
23203 Each type of sort may also be reversed.
23204 Normal default is by &quot;Arrival&quot;.
23205
23206 <P>
23207 A possible point of confusion arises when you change the configuration
23208 of the Sort Order for the currently open folder.
23209 The folder will normally be re-sorted when you go back to viewing the
23210 index.
23211 However, if you have manually sorted the folder with the
23212 Sort
23213 (<!--chtml if pinemode="function_key"-->F7<!--chtml else-->$<!--chtml endif-->)
23214 command, then it will not be re-sorted until the next time it is opened.
23215
23216 <P>
23217 <UL>
23218 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23219 </UL><P>
23220 &lt;End of help on this topic&gt;
23221 </BODY>
23222 </HTML>
23223 ====== h_config_fld_sort_rule =====
23224 <HTML>
23225 <HEAD>
23226 <TITLE>OPTION: <!--#echo var="VAR_folder-sort-rule"--></TITLE>
23227 </HEAD>
23228 <BODY>
23229 <H1>OPTION: <!--#echo var="VAR_folder-sort-rule"--></H1>
23230
23231 This option controls the order in which folder list entries will be
23232 presented in the FOLDER LIST screen.  Choose one of the following:
23233
23234 <DL>
23235 <DT>Alphabetical</DT>
23236 <DD>sort by alphabetical name independent of type
23237 </DD>
23238
23239 <DT>Alpha-with-dirs-last</DT>
23240 <DD>sort by alphabetical name grouping directory entries
23241 to the end of the list
23242 </DD>
23243
23244 <DT>Alpha-with-dirs-first</DT>
23245 <DD>sort by alphabetical name grouping directory entries
23246 to the start of the list
23247 </DD>
23248 </DL>
23249
23250 The normal default is &quot;Alphabetical&quot;.
23251
23252 <P>
23253 <UL>
23254 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23255 </UL><P>
23256 &lt;End of help on this topic&gt;
23257 </BODY>
23258 </HTML>
23259 ====== h_config_ab_sort_rule =====
23260 <HTML>
23261 <HEAD>
23262 <TITLE>OPTION: <!--#echo var="VAR_addrbook-sort-rule"--></a></TITLE>
23263 </HEAD>
23264 <BODY>
23265 <H1>OPTION: <!--#echo var="VAR_addrbook-sort-rule"--></a></H1>
23266
23267 This option controls the order in which address book entries will be
23268 presented.  Choose one of the following:
23269
23270 <DL>
23271 <DT>fullname</DT>
23272 <DD>use fullname field, lists mixed in
23273 </DD>
23274
23275 <DT>fullname-with-lists-last</DT>
23276 <DD>use fullname field, but put lists at end
23277 </DD>
23278
23279 <DT>nickname</DT>
23280 <DD>use nickname field, lists mixed in
23281 </DD>
23282
23283 <DT>nickname-with-lists-last</DT>
23284 <DD>use nickname field, but put lists at end
23285 </DD>
23286
23287 <DT>dont-sort</DT>
23288 <DD>don't change order of file
23289 </DD>
23290 </DL>
23291
23292 <P>
23293 The normal default is &quot;fullname-with-lists-last&quot;.
23294 If you use an address book from more than one computer and those
23295 computers sort the address book differently then the sort order
23296 will be the order where the last change to the address book was
23297 made.
23298 There are two reasons the sorting might be different on different
23299 systems.
23300 First, the <!--#echo var="VAR_addrbook-sort-rule"--></a> may be set differently in the two
23301 places.
23302 Second, the collation rules on the two computers may be different.
23303 For example, one system might ignore special characters while the other
23304 doesn't or one may sort upper and lower case letters together while
23305 the other doesn't.
23306 In any case, the order you see is the order on the system where the
23307 last change was made, for example by an address book edit or a
23308 Take Address command.
23309
23310 <P>
23311 <UL>
23312 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23313 </UL><P>
23314 &lt;End of help on this topic&gt;
23315 </BODY>
23316 </HTML>
23317 ====== h_config_post_char_set =====
23318 <HTML>
23319 <HEAD>
23320 <TITLE>OPTION: <!--#echo var="VAR_posting-character-set"--></TITLE>
23321 </HEAD>
23322 <BODY>
23323 <H1>OPTION: <!--#echo var="VAR_posting-character-set"--></H1>
23324
23325 The <!--#echo var="VAR_posting-character-set"--> configuration option is used
23326 when sending messages.
23327
23328 <P>
23329
23330 When sending a message the text typed in the composer is
23331 labeled with the character set specified by this option.
23332 If the composed text is not fully representable in the
23333 specified <!--#echo var="VAR_posting-character-set"-->, then it is labeled as &quot;UTF-8.&quot
23334 instead;
23335
23336 <P>
23337 Attachments are labeled with your
23338 <A HREF="h_config_key_char_set">&quot;Keyboard Character Set&quot;</A>.
23339
23340 <P>
23341 Generally, there should be little need to set this option.
23342 If left unset, the
23343 default behavior is to label composed text as specifically as
23344 possible.  That is, if the composed text has no non-ASCII characters,
23345 it is labeled as &quot;US-ASCII.&quot; Similarly, if it is composed of
23346 only ISO-8859-15 characters, it is labeled as such.  Alpine will
23347 attempt to automatically detect a number of character sets including ISO-8859-15,
23348 ISO-8859-1, ISO-8859-2, VISCII, KOI8-R, KOI8-U, ISO-8859-7, ISO-8859-6,
23349 ISO-8859-8, TIS-620, ISO-2022-JP, GB2312, BIG5, and EUC-KR.
23350 If the message contains a mix of character sets,
23351 it is labeled as &quot;UTF-8.&quot;
23352
23353 <P>
23354
23355 This setting is provided to allow you to force a particular character set that
23356 Alpine does not automatically detect. For example, if a message is representable
23357 in more than one character set then Alpine may choose a different default
23358 than you want.
23359 Lastly, by setting this option explicitly to
23360 &quot;UTF-8&quot; all non-ASCII messages you send will be labeled as
23361 &quot;UTF-8&quot; instead of something more specific.
23362
23363 <P>
23364 In the Setup/Config screen you may choose from a list of all the
23365 character sets Alpine knows about by using the &quot;T&quot; ToCharsets command.
23366
23367 <P>
23368 The options
23369 <A HREF="h_config_char_set">&quot;Display Character Set&quot;</A>
23370 and <A HREF="h_config_key_char_set">&quot;Keyboard Character Set&quot;</A>
23371 are closely related.
23372 Setting the feature
23373 <A HREF="h_config_use_system_translation">&quot;Use System Translation&quot;</A>
23374 should cause this option to be ignored.
23375
23376 <P>
23377 <UL>
23378 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23379 </UL><P>
23380 &lt;End of help on this topic&gt;
23381 </BODY>
23382 </HTML>
23383 ====== h_config_unk_char_set =====
23384 <HTML>
23385 <HEAD>
23386 <TITLE>OPTION: <!--#echo var="VAR_unknown-character-set"--></TITLE>
23387 </HEAD>
23388 <BODY>
23389 <H1>OPTION: <!--#echo var="VAR_unknown-character-set"--></H1>
23390
23391 The <!--#echo var="VAR_unknown-character-set"--> configuration option is used
23392 when reading or replying to messages.
23393
23394 <P>
23395
23396 A text message should either be made up of all US-ASCII characters
23397 or it should contain a charset label which tells the software which
23398 character set encoding to use to interpret the message.
23399 Sometimes a malformed message may be unlabeled but contain non-ascii text.
23400 This message is outside of the standards so any attempt to read it could fail.
23401 When Alpine attempts to read such a message it will try to interpret the
23402 text in the character set you specify here.
23403 For example, if you have correspondents who send you unlabeled messages that
23404 are usually made up of characters from the WINDOWS-1251 character set, setting
23405 this <!--#echo var="VAR_unknown-character-set"--> to <CODE>WINDOWS-1251</CODE> will
23406 allow you to read those messages.
23407 Of course, if the unlabeled message is actually in some other character set,
23408 then you may see garbage on your screen.
23409 <P>
23410 Instead of just unlabeled text, this option also affects text which is labeled
23411 with the charsets &quot;X-Unknown&quot;, &quot;MISSING_PARAMETER_VALUE&quot;
23412 or &quot;US-ASCII&quot;.
23413
23414 <P>
23415 In the Setup/Config screen you may choose from a list of all the
23416 character sets Alpine knows about by using the &quot;T&quot; ToCharsets command.
23417
23418 <P>
23419 <UL>
23420 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23421 </UL><P>
23422 &lt;End of help on this topic&gt;
23423 </BODY>
23424 </HTML>
23425 ====== h_config_char_set =====
23426 <HTML>
23427 <HEAD>
23428 <TITLE>OPTION: Display Character Set</TITLE>
23429 </HEAD>
23430 <BODY>
23431 <H1>OPTION: Display Character Set</H1>
23432
23433 The Display Character Set configuration option is used when viewing messages.
23434 <P>
23435 Alpine uses Unicode characters internally and
23436 it is a goal for Alpine to handle email in many different languages.
23437 Alpine will properly display only left-to-right character sets
23438 in a fixed-width font. Specifically, Alpine assumes that a fixed-width
23439 font is in use, in the sense that
23440 characters are assumed to take up zero, one, or two character cell
23441 widths from left to right on the screen. This is true even in PC-Alpine.
23442 <P>
23443
23444 Alpine recognizes some local character sets that are right-to-left
23445 (Arabic, Hebrew, and Thai) or not representable in a fixed-width font
23446 (Arabic) and properly converts texts in these character sets to/from
23447 Unicode; however, there are known display bugs with these character
23448 sets.
23449 <P>
23450
23451 There are three possible configuration character settings and some
23452 environment variable settings that can affect how Alpine
23453 handles international characters.
23454 The first two of these are only available in UNIX Alpine.
23455 The three configuration options are
23456 Display Character Set,
23457 Keyboard Character Set, and
23458 <!--#echo var="VAR_posting-character-set"-->.
23459 The Keyboard Character Set defaults to being the same value
23460 as the Display Character Set, and that is usually correct, because
23461 the keyboard almost always produces characters in the same character set
23462 as the display displays.
23463 The Display Character Set is the character set that Alpine
23464 will attempt to use when sending characters to the display.
23465 <P>
23466
23467 By default, the Display Character Set variable is not set and UNIX Alpine
23468 will attempt to get this information from the environment.
23469 In particular, the <CODE>nl_langinfo(CODESET)</CODE> call is used.
23470 This usually depends on the setting of the environment variables LANG or LC_CTYPE.
23471 An explicit configuration setting for Display Character Set will,
23472 of course, override any default setting.
23473 <P>
23474 For PC-Alpine the Display Character Set
23475 and the Keyboard Character Set
23476 are always equivalent to <CODE>UTF-8</CODE> and this is not settable.
23477 <P>
23478
23479 It is probably best to use UNIX Alpine in a terminal emulator
23480 capable of displaying UTF-8 characters, since that will allow you to
23481 view just about any received text that is correctly formatted (note,
23482 however, the above comments about known index display bugs with certain
23483 character sets). You'll need to have an emulator that uses a UTF-8 font
23484 and you'll need to set up your environment to use a UTF-8 charmap. For
23485 example, on a Linux system you might include
23486 <P>
23487 <CENTER> <CODE>setenv LANG en_US.UTF-8</CODE> </CENTER>
23488 <P>
23489
23490 or something similar in your UNIX startup files.
23491 You'd also have to select a UTF-8 font in your terminal emulator.
23492 <P>
23493
23494 The types of values that the character set variables may be set to are
23495 <CODE>UTF-8</CODE>, <CODE>ISO-8859-1</CODE>, or <CODE>EUC-JP</CODE>.
23496 The <CODE>ISO-2022</CODE> character sets are not supported for input or
23497 for display, but as a special case, <CODE>ISO-2022-JP</CODE> is supported
23498 for use only as a <!--#echo var="VAR_posting-character-set"-->.
23499 In the Setup/Config screen you may choose from a list of all the
23500 character sets Alpine knows about by using the &quot;T&quot; ToCharsets command.
23501 Here is a list of many of the possible character sets:
23502
23503 <P>
23504 <TABLE>
23505 <TR> <TD>UTF-8</TD> <TD>Unicode</TD> </TR>
23506 <TR> <TD>US-ASCII</TD> <TD>7 bit American English characters</TD> </TR>
23507 <TR> <TD>ISO-8859-1</TD> <TD>8 bit European "Latin 1" character set</TD> </TR>
23508 <TR> <TD>ISO-8859-2</TD> <TD>8 bit European "Latin 2" character set</TD> </TR>
23509 <TR> <TD>ISO-8859-3</TD> <TD>8 bit European "Latin 3" character set</TD> </TR>
23510 <TR> <TD>ISO-8859-4</TD> <TD>8 bit European "Latin 4" character set</TD> </TR>
23511 <TR> <TD>ISO-8859-5</TD> <TD>8 bit Latin and Cyrillic</TD> </TR>
23512 <TR> <TD>ISO-8859-6</TD> <TD>8 bit Latin and Arabic</TD> </TR>
23513 <TR> <TD>ISO-8859-7</TD> <TD>8 bit Latin and Greek</TD> </TR>
23514 <TR> <TD>ISO-8859-8</TD> <TD>8 bit Latin and Hebrew</TD> </TR>
23515 <TR> <TD>ISO-8859-9</TD> <TD>8 bit European "Latin 5" character set</TD> </TR>
23516 <TR> <TD>ISO-8859-10</TD> <TD>8 bit European "Latin 6" character set</TD> </TR>
23517 <TR> <TD>ISO-8859-11</TD> <TD>Latin and Thai</TD> </TR>
23518 <TR> <TD>ISO-8859-12</TD> <TD>Reserved</TD> </TR>
23519 <TR> <TD>ISO-8859-13</TD> <TD>8 bit European "Latin 7" character set</TD> </TR>
23520 <TR> <TD>ISO-8859-14</TD> <TD>8 bit European "Latin 8" character set</TD> </TR>
23521 <TR> <TD>ISO-8859-15</TD> <TD>8 bit European "Latin 9" character set</TD> </TR>
23522 <TR> <TD>ISO-8859-16</TD> <TD>8 bit European "Latin 10" character set</TD> </TR>
23523 <TR> <TD>KOI8-R</TD> <TD>8 bit Latin and Russian</TD> </TR>
23524 <TR> <TD>KOI8-U</TD> <TD>8 bit Latin and Ukranian</TD> </TR>
23525 <TR> <TD>WINDOWS-1251</TD> <TD>8 bit Latin and Russian</TD> </TR>
23526 <TR> <TD>TIS-620</TD> <TD>8 bit Latin and Thai</TD> </TR>
23527 <TR> <TD>VISCII</TD> <TD>8 bit Latin and Vietnamese</TD> </TR>
23528 <TR> <TD>GBK</TD> <TD>Latin and Chinese Simplified</TD> </TR>
23529 <TR> <TD>GB2312</TD> <TD>Latin and Chinese Simplified</TD> </TR>
23530 <TR> <TD>CN-GB</TD> <TD>Latin and Chinese Simplified</TD> </TR>
23531 <TR> <TD>BIG5</TD> <TD>Latin and Chinese Traditional</TD> </TR>
23532 <TR> <TD>BIG-5</TD> <TD>Latin and Chinese Traditional</TD> </TR>
23533 <TR> <TD>EUC-JP</TD> <TD>Latin and Japanese</TD> </TR>
23534 <TR> <TD>SHIFT-JIS</TD> <TD>Latin and Japanese</TD> </TR>
23535 <TR> <TD>EUC-KR</TD> <TD>Latin and Korean</TD> </TR>
23536 <TR> <TD>KSC5601</TD> <TD>Latin and Korean</TD> </TR>
23537 </TABLE>
23538 <P>
23539
23540 When reading incoming email, Alpine understands many different
23541 character sets and is able to convert the incoming mail into Unicode.
23542 The Unicode will be converted to the Display Character Set
23543 for display on your terminal.
23544 Characters typed at the keyboard will be converted from the
23545 Keyboard Character Set to Unicode for Alpine's internal
23546 use.
23547 You may find that you can read some malformed messages that do not
23548 contain a character set label by setting the option
23549 <A HREF="h_config_unk_char_set">&quot;<!--#echo var="VAR_unknown-character-set"-->&quot;</A>.
23550 <P>
23551
23552 The <!--#echo var="VAR_posting-character-set"--> is used when sending messages.
23553 The default behavior obtained by leaving this variable unset is usually
23554 what is wanted. In that default case, Alpine will attempt
23555 to label the message with the most specific character set from the
23556 rather arbitrary set
23557 <P>
23558 US-ASCII, ISO-8859-15,
23559 ISO-8859-1, ISO-8859-2, VISCII, KOI8-R, KOI8-U, ISO-8859-7, ISO-8859-6,
23560 ISO-8859-8, TIS-620, ISO-2022-JP, GB2312, BIG5, EUC-KR, and UTF-8.
23561 <P>
23562
23563 For example, if the message is made up of only US-ASCII characters, it
23564 will be labeled US-ASCII. Otherwise, if it is all ISO-8859-15 characters,
23565 that will be the label. If that doesn't work the same is tried for the
23566 remaining members of the list.
23567
23568 <P>
23569 It might make sense to set <!--#echo var="VAR_posting-character-set"--> to an
23570 explicit value instead.
23571 For example, if you usually send messages in Greek, setting this
23572 option to ISO-8859-7 will result in messages being labeled as
23573 US-ASCII if there are no non-ascii characters, ISO-8859-7 if there
23574 are only Greek characters, or UTF-8 if there are some characters
23575 that aren't representable in ISO-8859-7.
23576 Another possibility is to set this option explicitly to UTF-8.
23577 In that case
23578 Alpine labels only ascii messages as US-ASCII and all other
23579 messages as UTF-8.
23580 <P>
23581
23582 The options
23583 <A HREF="h_config_post_char_set">&quot;<!--#echo var="VAR_posting-character-set"-->&quot;</A>
23584 and <A HREF="h_config_key_char_set">&quot;Keyboard Character Set&quot;</A>
23585 are closely related to this option.
23586 Setting the feature
23587 <A HREF="h_config_use_system_translation">&quot;Use System Translation&quot;</A>
23588 should cause this option to be ignored.
23589
23590 <P>
23591 When displaying a message, Alpine compares this setting to the character
23592 set specified in the message.  If not all of the
23593 characters in the message can be displayed using the Display Character Set
23594 then Alpine places an editorial
23595 comment in the displayed text (enclosed in square-brackets) indicating
23596 that some characters may not be displayed correctly.
23597 This comment may be eliminated by turning on the option
23598 <A HREF="h_config_quell_charset_warning"><!--#echo var="FEAT_quell-charset-warning"--></A>.
23599
23600 <P>
23601 <UL>
23602 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23603 </UL><P>
23604 &lt;End of help on this topic&gt;
23605 </BODY>
23606 </HTML>
23607 ====== h_config_key_char_set =====
23608 <HTML>
23609 <HEAD>
23610 <TITLE>OPTION: Keyboard Character Set</TITLE>
23611 </HEAD>
23612 <BODY>
23613 <H1>OPTION: Keyboard Character Set</H1>
23614
23615 UNIX Alpine only.
23616 <P>
23617 The Keyboard Character Set identifies the character set of the characters
23618 coming from your keyboard.
23619 It defaults to having the same value as your
23620 <A HREF="h_config_char_set">&quot;Display Character Set&quot;</A>,
23621 which in turn defaults to a value obtained from your environment.
23622 It is unlikely that you will need to use this option, because the keyboard
23623 almost always produces the same kind of characters as the display displays.
23624
23625 <P>
23626 This character set is also used when accessing files in your local
23627 file system.
23628 The names of the files are assumed to be in the same character set as
23629 what the keyboard produces, as well as the contents of the files.
23630
23631 <P>
23632 In the Setup/Config screen you may choose from a list of all the
23633 character sets Alpine knows about by using the &quot;T&quot; ToCharsets command.
23634
23635 <P>
23636 The options
23637 <A HREF="h_config_char_set">&quot;Display Character Set&quot;</A>
23638 and <A HREF="h_config_post_char_set">&quot;<!--#echo var="VAR_posting-character-set"-->&quot;</A>
23639 are closely related.
23640 Setting the feature
23641 <A HREF="h_config_use_system_translation">&quot;Use System Translation&quot;</A>
23642 should cause this option to be ignored.
23643
23644 <P>
23645 <UL>
23646 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23647 </UL><P>
23648 &lt;End of help on this topic&gt;
23649 </BODY>
23650 </HTML>
23651 ====== h_config_editor =====
23652 <HTML>
23653 <HEAD>
23654 <TITLE>OPTION: <!--#echo var="VAR_editor"--></TITLE>
23655 </HEAD>
23656 <BODY>
23657 <H1>OPTION: <!--#echo var="VAR_editor"--></H1>
23658
23659 <!--#echo var="VAR_editor"--> specifies the program invoked by ^_ in the Composer. This is
23660 normally an alternative to Alpine's internal composer (Pico).  You could use
23661 this setting to specify an alternate editor to use occasionally or if you
23662 have a favorite editor and want to use it all the time (see the
23663 <A HREF="h_config_alt_ed_now">&quot;<!--#echo var="FEAT_enable-alternate-editor-implicitly"-->&quot;</A> setting).  <P>
23664 If you specify multiple editors for this option, ^_ will invoke the first one
23665 of those specified that exists and is executable.  When specifying a program
23666 for use here, make sure that the format of the text it saves -- which, when
23667 you exit it, will become the message body in Alpine -- is appropriate
23668 for the body of an email message; avoid proprietary formats that may result in
23669 a message body that the recipient of your message will be unable to decipher.
23670 <P>
23671 <!--chtml if pinemode="os_windows"-->
23672 <!--chtml else-->
23673 If you are in doubt about what editors are available on your system, or which
23674 of them may be appropriate for specification here, ask your local computing
23675 support staff.
23676 <!--chtml endif-->
23677 <P>
23678 Note that if <a href="h_config_quell_flowed_text"><!--#echo var="FEAT_quell-flowed-text"--></a> is
23679 unset, outgoing text will be set as flowed.  In most cases this will be fine,
23680 but if the editor has a &quot;flowed text&quot; mode, it would be best to
23681 use that.
23682
23683 <P><UL>
23684 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23685 </UL>
23686 <P>
23687 &lt;End of help on this topic&gt;
23688 </BODY>
23689 </HTML>
23690 ====== h_config_speller =====
23691 <HTML>
23692 <HEAD>
23693 <TITLE>OPTION: <!--#echo var="VAR_speller"--></TITLE>
23694 </HEAD>
23695 <BODY>
23696 <H1>OPTION: <!--#echo var="VAR_speller"--></H1>
23697
23698 UNIX Alpine only.
23699 <P>
23700 For PC-Alpine, you must install the aspell library code that you
23701 may get from
23702 <A HREF="http://aspell.net/win32/">http://aspell.net/win32/</A>.
23703 <P>
23704 This option affects the behavior of the ^T (spell check) command in the
23705 Composer.  It specifies the program invoked by ^T in the Composer.
23706 By default, Alpine uses
23707 <P>
23708 <CENTER><SAMP>aspell --dont-backup --mode=email check</SAMP></CENTER>
23709 <P>
23710 if it knows where to find &quot;aspell&quot;.
23711 If there is no &quot;aspell&quot; command available but the command &quot;ispell&quot; is available
23712 then the command used is
23713 <P>
23714 <CENTER><SAMP>ispell -l</SAMP></CENTER>
23715 <P>
23716 Otherwise, the ancient &quot;spell&quot; command is used.
23717 <P>
23718 If you specify a value for this command (with full pathname) then that is what
23719 will be used instead of any of the defaults.
23720 When invoking this
23721 spell-checking program, Alpine appends a tempfile name (where the message is
23722 passed) to the command line. Alpine expects the speller to correct the
23723 spelling in that file. When you exit from that program Alpine will read the
23724 tempfile back into the composer.
23725 <P>
23726 Don't set this speller option to the standard Unix spell command.
23727 That won't work because spell works in a different way.
23728
23729 <P>
23730 <UL>
23731 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23732 </UL><P>
23733 &lt;End of help on this topic&gt;
23734 </BODY>
23735 </HTML>
23736 ====== h_config_aspell_dictionary =====
23737 <HTML>
23738 <HEAD>
23739 <TITLE>OPTION: <!--#echo var="VAR_aspell-dictionary-list"--></TITLE>
23740 </HEAD>
23741 <BODY>
23742 <H1>OPTION: <!--#echo var="VAR_aspell-dictionary-list"--></H1>
23743
23744 PC Alpine only.
23745 <P>
23746 This option specifies a list of dictionaries you will use with
23747 aspell. A sample entry is &quot;en_US&quot; for american english, or
23748 &quot;en_GB&quot; for brittish english.
23749
23750 <P>
23751 <UL>
23752 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23753 </UL><P>
23754 &lt;End of help on this topic&gt;
23755 </BODY>
23756 </HTML>
23757 ====== h_config_display_filters =====
23758 <HTML>
23759 <HEAD>
23760 <TITLE>OPTION: <!--#echo var="VAR_display-filters"--></TITLE>
23761 </HEAD>
23762 <BODY>
23763 <H1>OPTION: <!--#echo var="VAR_display-filters"--></H1>
23764
23765 This option defines a list of text-filtering commands (programs or
23766 scripts) that may be used to filter text portions of received messages
23767 prior to their use (e.g., presentation in the &quot;MESSAGE TEXT&quot;
23768 display screen, exporting to a text file).
23769 For security reasons, the full path name of the
23770 filter command must be specified.
23771
23772 <P>
23773 The command is executed and the message is piped into its standard input.
23774 The standard output of the command is read back by Alpine.  The
23775 &quot;_TMPFILE_&quot; token (see below) overrides this default behavior.
23776
23777 <P>
23778 The filter's use is based on the configured &quot;trigger&quot; string.  The
23779 format of a filter definition is:
23780
23781 <P>
23782 <CENTER>&lt;trigger&gt; &lt;command&gt; &lt;arguments&gt;</CENTER>
23783
23784 <P>
23785 You can specify as many filters as you wish, separating them with a comma.
23786 Each filter can have only one trigger and command.  Thus, two trigger
23787 strings that invoke the same command require separate filter
23788 specifications.
23789
23790 <P>
23791 The &quot;trigger&quot; is simply text that, if found in the message,
23792 will invoke the associated command.  If the trigger contains any space
23793 characters, it must be placed within quotes.  Likewise, should you
23794 wish a filter to be invoked unconditionally, define the trigger as the
23795 null string, &quot;&quot; (two consecutive double-quote characters).  If the
23796 trigger string is found anywhere in the text of the message the filter
23797 is invoked.  Placing the trigger text within the tokens defined below
23798 changes where within the text the trigger must be before considering
23799 it a match.
23800
23801 <P>
23802 Trigger Modifying Tokens:
23803 <DL>
23804 <DT>_CHARSET(<VAR>string</VAR>)_</DT>
23805 <DD>This token tells Alpine to invoke the supplied command
23806 if the text is in a character set matching <VAR>string</VAR>
23807 (e.g., ISO-8859-2 or ISO-2022-JP).
23808 </DD>
23809
23810
23811 <DT>_LEADING(<VAR>string</VAR>)_</DT>
23812 <DD>This token tells Alpine to invoke the supplied command
23813 if the enclosed <VAR>string</VAR> is found to be the first
23814 non-whitespace text.
23815 <BR>NOTE: Quotes are necessary if <VAR>string</VAR> contains
23816 the space character.
23817 </DD>
23818
23819 <DT>_BEGINNING(<VAR>string</VAR>)_</DT>
23820 <DD>This token tells Alpine to invoke the supplied command
23821 if the enclosed <VAR>string</VAR> is found at the beginning
23822 of any line in the text.
23823 <BR>NOTE: Quotes are necessary if <VAR>string</VAR> contains
23824 the space character.
23825 </DD>
23826 </DL>
23827
23828 <P>
23829 The &quot;command&quot; and &quot;arguments&quot; portion is simply
23830 the command line to be invoked if the trigger string is found.  Below
23831 are tokens that Alpine will recognize and replace with special values
23832 when the command is actually invoked.
23833
23834 <P>
23835 Command Modifying Tokens:
23836
23837 <DL>
23838 <DT>_TMPFILE_</DT>
23839 <DD>When the command is executed, this token is
23840 replaced with the path and name of the temporary
23841 file containing the text to be filtered.  Alpine
23842 expects the filter to replace this data with the
23843 filter's result.
23844
23845 <P>
23846 NOTE: Use of this token implies that the text to
23847 be filtered is not piped into standard input of the
23848 executed command and its standard output is ignored.
23849 Alpine restores the tty modes before invoking the
23850 filter in case the filter interacts with the user
23851 via its own standard input and output.
23852 </DD>
23853
23854 <DT>_RESULTFILE_</DT>
23855 <DD>When the command is executed, this token is
23856 replaced with the path and name of a temporary
23857 file intended to contain a status message from the
23858 filter.  Alpine displays this in the message status
23859 field.
23860 </DD>
23861
23862 <DT>_DATAFILE_</DT>
23863 <DD>When the command is executed, this token is
23864 replaced with the path and name of a temporary
23865 file that Alpine creates once per session and deletes
23866 upon exit.  The file is intended to be used by the
23867 filter to store state information between instances
23868 of the filter.
23869 </DD>
23870
23871 <DT>_PREPENDKEY_</DT>
23872 <DD>When the command is executed, this token indicates that a random
23873 number will be passed down the input stream before the message text.
23874 This number could be used as a session key.  It is sent in this way to
23875 improve security.  The number is unique to the current Alpine session
23876 and is only generated once per session.
23877 </DD>
23878
23879 <DT>_SILENT_</DT>
23880 <DD>When the filter is executed, this token tells Alpine not to repaint
23881 the screen while the command is being executed. This can be used with
23882 filters that do not interact with the user, and therefore repainting
23883 the screen is not necessary.
23884 </DD>
23885 </DL>
23886
23887 <P>
23888 The feature
23889 <A HREF="h_config_disable_reset_disp"><!--#echo var="FEAT_disable-terminal-reset-for-display-filters"--></A> is related.
23890 <P>
23891 Performance caveat/considerations:
23892 <BR>
23893 Testing for the trigger and invoking the filter doesn't come for free.
23894 There is overhead associated with searching for the trigger string, testing
23895 for the filter's existence and actually piping the text through the filter.
23896 The impact can be reduced if the Trigger Modifying Tokens above are
23897 employed.
23898 <P>
23899 &lt;End of help on this topic&gt;
23900 </BODY>
23901 </HTML>
23902 ====== h_config_sending_filter =====
23903 <HTML>
23904 <HEAD>
23905 <TITLE>OPTION: <!--#echo var="VAR_sending-filters"--></TITLE>
23906 </HEAD>
23907 <BODY>
23908 <H1>OPTION: <!--#echo var="VAR_sending-filters"--></H1>
23909
23910 This option defines a list of text-filtering commands (programs and
23911 scripts) that may be selectively invoked to process a message just before
23912 it is sent.  If set, the Composer's ^X (Send) command will allow you to
23913 select which filter (or none) to apply to the message before it is sent.
23914 For security reasons, the full path of the filter program must be
23915 specified.
23916
23917 <P>
23918 Command Modifying Tokens:
23919
23920 <DL>
23921 <DT>_RECIPIENTS_</DT>
23922 <DD>When the command is executed, this token is replaced
23923 with the space delimited list of recipients of the
23924 message being sent.
23925 </DD>
23926
23927 <DT>_TMPFILE_</DT>
23928 <DD>
23929 When the command is executed, this token is
23930 replaced with the path and name of the temporary
23931 file containing the text to be filtered.  Alpine
23932 expects the filter to replace this data with the
23933 filter's result.
23934
23935 <P>
23936 NOTE: Use of this token implies that the text to
23937 be filtered is not piped into standard input of the
23938 executed command and its standard output is ignored.
23939 Alpine restores the tty modes before invoking the
23940 filter in case the filter interacts with the user
23941 via its own standard input and output.
23942 </DD>
23943
23944 <DT>_RESULTFILE_</DT>
23945 <DD>When the command is executed, this token is
23946 replaced with the path and name of a temporary
23947 file intended to contain a status message from the
23948 filter.  Alpine displays this in the message status
23949 field.
23950 </DD>
23951
23952 <DT>_DATAFILE_</DT>
23953 <DD>When the command is executed, this token is replaced
23954 in the command line with the path and name of a
23955 temporary file that Alpine creates once per session
23956 and deletes upon exit.  The file is intended to be
23957 used by the filter to store state information between
23958 instances of the filter.
23959 </DD>
23960
23961 <DT>_PREPENDKEY_</DT>
23962 <DD>When the command is executed, this token indicates
23963 that a random number will be passed down the input
23964 stream before the message text.  This number could
23965 be used as a session key.  It is sent in this way
23966 to improve security.  The number is unique to the
23967 current Alpine session and is only generated once per
23968 session.
23969 </DD>
23970
23971 <DT>_INCLUDEALLHDRS_</DT>
23972 <DD>When the command is executed, this token indicates
23973 that the headers of the message will be passed down the input stream
23974 before the message text.
23975 </DD>
23976
23977 <DT>_MIMETYPE_</DT>
23978 <DD>When the command is executed, this token is replaced in the
23979 command name with a temporary file name used to accept any new MIME
23980 Content-Type information necessitated by the output of the filter.
23981 Upon the filter's exit, if the file contains new MIME type
23982 information, Alpine verifies its format and replaces the outgoing
23983 message's MIME type information with that contained in the file. This
23984 is basically a cheap way of sending something other than Text/Plain.
23985 </DD>
23986 </DL>
23987
23988 <P>
23989 NOTE: Only the body text, which is visible in the Composer, is piped
23990 through this filter.  Attachments are not sent to the filter.
23991 <P>
23992 Sending filters are not used if the feature
23993 <A HREF="h_config_send_wo_confirm">&quot;<!--#echo var="FEAT_send-without-confirm"-->&quot;</A> is set.
23994 <P>
23995 <UL>
23996 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23997 </UL><P>
23998 &lt;End of help on this topic&gt;
23999 </BODY>
24000 </HTML>
24001 ====== h_config_keywords =====
24002 <HTML>
24003 <HEAD>
24004 <TITLE>OPTION: <!--#echo var="VAR_keywords"--></TITLE>
24005 </HEAD>
24006 <BODY>
24007 <H1>OPTION: <!--#echo var="VAR_keywords"--></H1>
24008
24009 You may define your own set of keywords and optionally set them on a
24010 message by message basis.
24011 These are similar to the &quot;Important&quot; flag which the user
24012 may set using the Flag command.
24013 The difference is that the Important flag is always present for each folder.
24014 User-defined keywords are chosen by the user.
24015 You may set up the list of possible keywords here, or you may add keywords
24016 from the Flag Details screen that you
24017 can get to after typing the
24018 Flag (<!--chtml if pinemode="function_key"-->F11<!--chtml else-->*<!--chtml endif-->)
24019 command.
24020 After the keywords have been defined,
24021 then you use the <A HREF="h_common_flag">Flag command</A>
24022 to set or clear the keywords in each message.
24023 The behavior of the flag command may be modified by using the
24024 <A HREF="h_config_flag_screen_default">&quot;<!--#echo var="FEAT_enable-flag-screen-implicitly"-->&quot;</A> option or the
24025 <A HREF="h_config_flag_screen_kw_shortcut">&quot;<!--#echo var="FEAT_enable-flag-screen-keyword-shortcut"-->&quot;</A> option.
24026
24027 <P>
24028 Keywords may be used when Selecting messages (Select Keyword).
24029 Keywords may also be used in the Patterns of Rules (Filters, Indexcolors, etc).
24030 Filter Rules may be used to set keywords automatically.
24031 Keywords may be displayed as part of the Subject of a message by using
24032 the SUBJKEY or SUBJKEYINIT tokens in the
24033 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option.
24034 The <A HREF="h_config_kw_braces"><!--#echo var="VAR_keyword-surrounding-chars"--></A>
24035 option may be used to modify the display of keywords using
24036 SUBJKEY and SUBJKEYINIT slightly.
24037 Keywords may also be displayed in a column of their own in the MESSAGE INDEX
24038 screen by using the KEY or KEYINIT tokens.
24039 It is also possible to color keywords in the index using the
24040 Setup/Kolor screen (<A HREF="h_config_kw_color">Keyword Colors</A>).
24041 Keywords are not supported by all mail servers.
24042
24043 <P>
24044 You may give keywords nicknames if you wish.
24045 If the keyword definition you type in contains a SPACE character, then the
24046 actual value of the keyword is everything after the last SPACE and the
24047 nickname for that keyword is everything before the last SPACE.
24048 For example, suppose you are trying to interoperate with another email program
24049 that uses a particular keyword with an unpleasant name.
24050 Maybe it uses a keyword called
24051 <P>
24052 <CENTER><SAMP>VendorName.SoftwareName.08</SAMP></CENTER>
24053 <P>
24054 but for you that keyword means that the message is work-related.
24055 You could define a keyword to have the value
24056 <P>
24057 <CENTER><SAMP>Work VendorName.SoftwareName.08</SAMP></CENTER>
24058 <P>
24059 and then you would use the name &quot;Work&quot; when dealing with
24060 that keyword in Alpine.
24061 If you defined it as
24062 <P>
24063 <CENTER><SAMP>My Work VendorName.SoftwareName.08</SAMP></CENTER>
24064 <P>
24065 the nickname would be everything before the last SPACE, that is the nickname
24066 would be &quot;My Work&quot;.
24067 <P>
24068 Some commonly used keywords begin with dollar signs.
24069 This presents a slight complication, because the dollar sign is normally used
24070 to signify
24071 <A HREF="h_news_config">environment variable expansion</A>
24072 in the Alpine configuration.
24073 In order to specify a keyword that begins with a dollar sign you must
24074 precede the dollar sign with a second dollar sign to escape its special
24075 meaning.
24076 For example, if you want to include the keyword
24077 <P>
24078 <CENTER><SAMP>$Label1</SAMP></CENTER>
24079 <P>
24080 as one of your possible keywords, you must enter the text
24081 <P>
24082 <CENTER><SAMP>$$Label1</SAMP></CENTER>
24083 <P>
24084
24085 instead.
24086 <P>
24087 There are a couple limitations.
24088 First, not all servers support keywords.
24089 Second, some servers (including the IMAP server included with Alpine)
24090 have a per folder limit on the number of keywords that may be defined.
24091 This count commonly includes every keyword you have ever used in the
24092 folder, even if it is no longer being used.
24093 In other words, you can add keywords but you cannot remove them easily.
24094 If you have changed keywords over the life of a folder and find that
24095 you have reached such a limit, one possible solution might be to copy
24096 all of the messages to a newly created folder (using Alpine) and then
24097 delete the original and rename the new folder.
24098 The reason this might work is that only the keywords currently set in
24099 any of the messages will be used in the new folder, hopefully putting you
24100 under the limit.
24101
24102 <P>
24103 <UL>
24104 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24105 </UL><P>
24106 &lt;End of help on this topic&gt;
24107 </BODY>
24108 </HTML>
24109 ====== h_config_alt_addresses =====
24110 <HTML>
24111 <HEAD>
24112 <TITLE>OPTION: <!--#echo var="VAR_alt-addresses"--></TITLE>
24113 </HEAD>
24114 <BODY>
24115 <H1>OPTION: <!--#echo var="VAR_alt-addresses"--></H1>
24116
24117 This option provides a place for you to list alternate email addresses
24118 you may have.
24119 Each address in the list should be the actual email address part of an
24120 address, without the full name field or the angle brackets.
24121 For example:
24122
24123 <P>
24124 <CENTER><SAMP>user@example.com</SAMP></CENTER>
24125 <P>
24126
24127 The matching is case-insensitive, so this would match any of
24128 <SAMP>User@example.com</SAMP>, <SAMP>user@Example.Com</SAMP>, or
24129 <SAMP>USER@EXAMPLE.COM</SAMP> as well.
24130
24131 <P>
24132 If set, the option affects the behavior of the Reply
24133 command and the &quot;+&quot; symbol in the MESSAGE INDEX, which denotes that
24134 a message has been addressed specifically to you.
24135
24136 <P>
24137 In the default INDEX display
24138 the personal name (or email address) of
24139 the person listed in the message's &quot;From:&quot; header
24140 field is usually displayed except when that address is yours or one of your
24141 alternate addresses.
24142 In that case you will usually see the name of
24143 the first person specified in the
24144 message's &quot;To:&quot; header field
24145 with the prefix &quot;To: &quot; prepended.
24146
24147 <P>
24148 With respect to Reply, the reply-to-all option will exclude addresses
24149 listed here.
24150
24151 <P>
24152 The feature
24153 <A HREF="h_config_copy_to_to_from"><!--#echo var="FEAT_copy-to-address-to-from-if-it-is-us"--></A>
24154 is somewhat related to this option.
24155
24156 <P>
24157 In addition to a list of actual addresses,
24158 you may use regular expressions (as used with egrep with the ignore case flag)
24159 to describe the addresses you want to match.
24160 Alpine will somewhat arbitrarily interpret your entry as a regular
24161 expression if it contains any of the characters
24162 *, |, +, ?, {, [, ^, $, or &#92;.
24163 Otherwise, it will be treated literally.
24164 The feature
24165 <a href="h_config_disable_regex"><!--#echo var="FEAT_disable-regular-expression-matching-for-alternate-addresses"--></a>
24166 may be used to turn off regular expression processing regardless of whether or not
24167 special characters appear in the entry.
24168
24169 <P>
24170 A description of how regular expressions work is beyond the
24171 scope of this help text, but some examples follow.
24172
24173 <P>
24174 The entry
24175
24176 <P>
24177 <CENTER><SAMP>.*@example.com</SAMP></CENTER>
24178 <P>
24179
24180 in the <!--#echo var="VAR_alt-addresses"--> list would mean that any
24181 address with a domain name of <SAMP>example.com</SAMP> (such as
24182 <SAMP>fred@example.com</SAMP> or <SAMP>wilma@example.com</SAMP>) will be considered
24183 one of your alternate addresses.
24184 Strictly speaking, the dot in <SAMP>example.com</SAMP> ought to be escaped with
24185 a backslash, as in <SAMP>example&#92;.com</SAMP>, and a dollar sign anchor ought
24186 to come at the end of the expression to prevent a match of <SAMP>example.com.org</SAMP>.
24187 Complicating things further, the dollar sign
24188 is special in the Alpine configuration (it signifies environment variable expansion)
24189 so the dollar sign should be doubled or backslash escaped for Alpine's sake.
24190 Quotes around the whole expression will not escape the dollar sign successfully.
24191 So this example should look like
24192
24193 <P>
24194 <CENTER><SAMP>.*@example&#92;.com$$</SAMP></CENTER>
24195 <P>
24196
24197 <P>
24198 The entry
24199
24200 <P>
24201 <CENTER><SAMP>^fred[0-9]*@example.com$$</SAMP></CENTER>
24202 <P>
24203
24204 would match
24205 <SAMP>fred3@example.com</SAMP> or <SAMP>fred17@example.com</SAMP> as well
24206 as <SAMP>fred@example.com</SAMP>.
24207
24208 <P>
24209 You could match all addresses that look like
24210 <SAMP>fred+stuff@example.com</SAMP> for any value of <SAMP>stuff</SAMP> with the
24211 entry
24212
24213 <P>
24214 <CENTER><SAMP>^fred&#92;+.*@example.com$$</SAMP></CENTER>
24215 <P>
24216
24217 Notice that you have to escape the plus sign with a backslash because plus
24218 is a special character in regular expressions.
24219 If you wanted to match plain <SAMP>fred</SAMP> as well as <SAMP>fred+stuff</SAMP>
24220 the expression
24221
24222 <P>
24223 <CENTER><SAMP>^fred(()|&#92;+.*)@example.com$$</SAMP></CENTER>
24224 <P>
24225
24226 would do it, but it would be easier to just add fred@example.com as a
24227 separate entry.
24228
24229 <P>
24230 One more example, a match of all first-level subdomains, is given by
24231
24232 <P>
24233 <CENTER><SAMP>^fred@[[:alnum:]_-]*&#92;.example&#92;.com$$</SAMP></CENTER>
24234 <P>
24235
24236 <P>
24237 Because the regular expression matching is based on an old library
24238 (<SAMP>hs_regex</SAMP>) the regular expressions might not work exactly as you expect,
24239 but they should be close.
24240
24241 <P>
24242 <UL>
24243 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24244 </UL><P>
24245 &lt;End of help on this topic&gt;
24246 </BODY>
24247 </HTML>
24248 ====== h_config_abook_formats =====
24249 <HTML>
24250 <HEAD>
24251 <TITLE>OPTION: <!--#echo var="VAR_addressbook-formats"--></TITLE>
24252 </HEAD>
24253 <BODY>
24254 <H1>OPTION: <!--#echo var="VAR_addressbook-formats"--></H1>
24255
24256 This option specifies the format that address books are displayed in.
24257 Normally, address books are displayed with the nicknames in the first
24258 column, the fullnames in the second column, and addresses in the third
24259 column.  The system figures out reasonable defaults for the widths of
24260 the columns.  An address book may be given a different format by
24261 listing special tokens in the order you want them to display.  The
24262 possible tokens are NICKNAME, FULLNAME, ADDRESS, FCC, and COMMENT.
24263 So, for example, to get the default behavior you could list
24264
24265 <P>
24266 <CENTER><!--#echo var="VAR_addressbook-formats"-->=NICKNAME FULLNAME ADDRESS</CENTER>
24267
24268 <P>
24269 (You can also use the token DEFAULT to get the default behavior for
24270 an address book format.)
24271
24272 <P>
24273 The tokens are separated by spaces.  &quot;<!--#echo var="VAR_addressbook-formats"-->&quot;
24274 is a list, so if you have more than one address book you may have a
24275 separate format for each by putting its format at the corresponding
24276 location in the &quot;<!--#echo var="VAR_addressbook-formats"-->&quot; list.
24277
24278 <P>
24279
24280 Listed first are the personal address books, then the global address
24281 books.  So, if you have two personal address books and one global
24282 address book, you may have up to three formats in the
24283 &quot;<!--#echo var="VAR_addressbook-formats"-->&quot; list.  If
24284 &quot;<!--#echo var="VAR_addressbook-formats"-->&quot; doesn't have as many elements as there
24285 are address books, the last element is used repeatedly.
24286
24287 <P>
24288
24289 Each of the tokens may also be optionally followed by parentheses with
24290 either a number or a percentage inside the parentheses.  For example,
24291 <SAMP>FULLNAME(13)</SAMP> means to allocate 13 characters of space to
24292 the fullnames column, <SAMP>FULLNAME(20%)</SAMP> means to allocate 20%
24293 of the available space (the screen width minus the space for
24294 inter-column spaces) to the fullnames column, while plain
24295 <SAMP>FULLNAME</SAMP> means the system will attempt to figure out a
24296 reasonable number of columns.
24297
24298 <P>
24299 There are always 2 spaces between every column, so if you use
24300 fixed column widths (like 13) you should remember to take that into
24301 account.
24302
24303 <P>
24304 <UL>
24305 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24306 </UL><P>
24307 &lt;End of help on this topic&gt;
24308 </BODY>
24309 </HTML>
24310 ====== h_config_set_index_format =====
24311 <HTML>
24312 <HEAD>
24313 <TITLE>Set Index Format</TITLE>
24314 </HEAD>
24315 <BODY>
24316 <H1>Set Index Format</H1>
24317
24318 This option is used to customize the content of lines in the
24319 <A HREF="h_mail_index">MESSAGE INDEX screen</A>.
24320 This action works exactly like the regular
24321 &quot;<!--#echo var="VAR_index-format"-->&quot; option in the Setup/Config screen,
24322 except that you can have a folder-specific value for it if you specify it here.
24323 Consult the help for
24324 &quot;<A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A>&quot;
24325 for more information.
24326
24327 <P>
24328 <UL>
24329 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24330 </UL><P>
24331 &lt;End of help on this topic&gt;
24332 </BODY>
24333 </HTML>
24334 ====== h_config_index_format =====
24335 <HTML>
24336 <HEAD>
24337 <TITLE>OPTION: <!--#echo var="VAR_index-format"--></TITLE>
24338 </HEAD>
24339 <BODY>
24340 <H1>OPTION: <!--#echo var="VAR_index-format"--></H1>
24341
24342 This option is used to customize the content of lines in the
24343 <A HREF="h_mail_index">MESSAGE INDEX screen</A>.  Each line is intended
24344 to convey some amount of immediately relevant information about each
24345 message in the current folder.
24346 <P>
24347
24348 Alpine provides a pre-defined set of informational fields with
24349 reasonable column widths automatically computed.  You can, however,
24350 replace this default set by listing special tokens in the order you
24351 want them displayed.
24352 <P>
24353
24354 The list of available tokens is
24355 <A HREF="h_index_tokens">here</A>.
24356 <P>
24357
24358 Spaces are used to separate listed tokens.  Additionally, you can
24359 specify how much of the screen's width the token's associated data
24360 should occupy on the index line by appending to the token a pair of
24361 parentheses enclosing either a number or percentage.  For example,
24362 &quot;SUBJECT(13)&quot; means to allocate 13 characters of space to the subject
24363 column, and &quot;SUBJECT(20%)&quot; means to
24364 allocate 20% of the available space
24365 to the subjects column, while plain &quot;SUBJECT&quot; means the system will
24366 attempt to figure out a reasonable amount of space.
24367 <P>
24368
24369 There is always one space between every pair of columns, so if you use fixed
24370 column widths (like 13) you should remember to take that into account.
24371 Several of the fields are virtually fixed-width, so it doesn't make
24372 much sense to specify the width for them.  The fields STATUS,
24373 FULLSTATUS, IMAPSTATUS, MSGNO, the DATE fields, SIZE,
24374 and DESCRIPSIZE all fall into that category.
24375 You <EM>may</EM> specify widths for those if you wish, but
24376 you're probably better off letting the system pick those widths.  <P>
24377
24378 <P>
24379 The default is equivalent to:
24380
24381 <P>
24382 <CENTER><SAMP>STATUS MSGNO SMARTDATETIME24 FROMORTO(33%) SIZENARROW SUBJKEY(67%)</SAMP></CENTER>
24383
24384 <P>
24385 This means that the four fields without percentages will be allocated
24386 first, and then 33% and 67% of the <EM>remaining</EM> space will go to
24387 the from and subject fields.  If one of those two fields is specified
24388 as a percentage and the other is left for the system to choose, then
24389 the percentage is taken as an absolute percentage of the screen, not
24390 of the space remaining after allocating the first four columns.  It
24391 doesn't usually make sense to do it that way.  If you leave off all
24392 the widths, then the subject and from fields (if both are present) are
24393 allocated space in a 2 to 1 ratio, which is almost exactly the same as
24394 the default.
24395
24396 <P>
24397 What you are most likely to do with this configuration option is to
24398 specify which fields appear at all, which order they appear in, and the
24399 percentage of screen that is used for the from and subject fields if you
24400 don't like the 2 to 1 default.
24401
24402 <P>
24403 If you want to retain the default format that Pine 4.64 had, use
24404
24405 <P>
24406 <CENTER><SAMP><!--#echo var="VAR_index-format"-->=STATUS MSGNO DATE FROMORTO(33%) SIZE SUBJKEY(67%)</SAMP></CENTER>
24407 <P>
24408 <EM>and</EM> set the feature
24409 <A HREF="h_config_disable_index_locale_dates"><!--#echo var="FEAT_disable-index-locale-dates"--></A>.
24410 <UL>
24411 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24412 </UL><P>
24413 &lt;End of help on this topic&gt;
24414 </BODY>
24415 </HTML>
24416 ====== h_config_reply_intro =====
24417 <HTML>
24418 <HEAD>
24419 <TITLE>OPTION: <!--#echo var="VAR_reply-leadin"--></TITLE>
24420 </HEAD>
24421 <BODY>
24422 <H1>OPTION: <!--#echo var="VAR_reply-leadin"--></H1>
24423
24424 This option is used to customize the content of the introduction line
24425 that is included when replying to a message and including the original
24426 message in the reply.
24427 The normal default (what you will get if you delete this variable) looks
24428 something like:
24429 <P>
24430 <CENTER><SAMP>On Sat, 24 Oct 1998, Fred Flintstone wrote:</SAMP></CENTER>
24431 <P>
24432 where the day of the week is only included if it is available in the
24433 original message.
24434 You can replace this default with text of your own.
24435 The text may contain tokens that are replaced with text
24436 that depends on the message you are replying to.
24437 For example, the default is equivalent to:
24438 <P>
24439 <CENTER><SAMP>On _DAYDATE_, _FROM_ wrote:</SAMP></CENTER>
24440 <P>
24441
24442 Since this variable includes regular text mixed with special tokens
24443 the tokens have to be surrounded by underscore characters.
24444 For example, to use the token &quot;<SAMP>PREFDATE</SAMP>&quot;
24445 you would need to use &quot;<SAMP>_PREFDATE_</SAMP>&quot;,
24446 not &quot;<SAMP>PREFDATE</SAMP>&quot;.
24447 <P>
24448 The list of available tokens is
24449 <A HREF="h_index_tokens">here</A>.
24450
24451 <P>
24452 By default, the text is all on a single line and is followed by a blank line.
24453 If your &quot;<!--#echo var="VAR_reply-leadin"-->&quot; turns out to be longer
24454 than 80 characters when replying to a particular message, it is shortened.
24455 However, if you use the token
24456 <P>
24457 <CENTER><SAMP>_NEWLINE_</SAMP></CENTER>
24458 <P>
24459
24460 anywhere in the value, no end of line or blank line is appended, and no
24461 shortening is done.
24462 The _NEWLINE_ token may be used to get rid of the blank line following
24463 the text, to add more blank lines, or to form a multi-line
24464 &quot;<!--#echo var="VAR_reply-leadin"-->&quot;.
24465 To clarify how _NEWLINE_ works recall that the default value is:
24466 <P>
24467 <CENTER><SAMP>On _DAYDATE_, _FROM_ wrote:</SAMP></CENTER>
24468 <P>
24469
24470 That is equivalent to
24471 <P>
24472 <CENTER><SAMP>On _DAYDATE_, _FROM_ wrote:_NEWLINE__NEWLINE_</SAMP></CENTER>
24473 <P>
24474
24475 In the former case, two newlines are added automatically because
24476 no _NEWLINE_ token appears in the value of the option (for backwards
24477 compatibility). In the latter case, the newlines are explicit.
24478 If you want to remove the blank line that follows the
24479 &quot;<!--#echo var="VAR_reply-leadin"-->&quot; text use a single
24480 _NEWLINE_ token like
24481 <P>
24482 <CENTER><SAMP>On _DAYDATE_, _FROM_ wrote:_NEWLINE_</SAMP></CENTER>
24483 <P>
24484
24485 Because of the backwards compatibility problem, it is not possible to
24486 remove all of the ends of lines, because then there will be no _NEWLINE_ tokens
24487 and that will cause the automatic adding of two newlines!
24488 If you want, you may embed newlines in the middle of the text, as well,
24489 producing a multi-line &quot;<!--#echo var="VAR_reply-leadin"-->&quot;.
24490
24491 <P>
24492 By default, no attempt is made to localize the date.
24493 If you prefer a localized form you may find that one of the tokens
24494 _PREFDATE_ or _PREFDATETIME_ is a satisfactory substitute.
24495 If you want more control one of the many other date tokens, such as _DATEISO_,
24496 might be better.
24497
24498 <P>
24499 For the adventurous, there is a way to conditionally include text based
24500 on whether or not a token would result in specific replacement text.
24501 For example, you could include some text based on whether or not
24502 the _NEWS_ token would result in any newsgroups if it was used.
24503 It's explained in detail
24504 <A HREF="h_reply_token_conditionals">here</A>.
24505
24506 <P>
24507 In the very unlikely event that you want to include a literal token
24508 in the introduction line you must precede it with a backslash character.
24509 For example,
24510 <P>
24511 <CENTER><SAMP>&#92;_DAYDATE_ = _DAYDATE_</SAMP></CENTER>
24512 <P>
24513 would produce something like
24514 <P>
24515 <CENTER><SAMP>_DAYDATE_ = Sat, 24 Oct 1998</SAMP></CENTER>
24516 <P>
24517 It is not possible to have a literal backslash followed by an expanded token.
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_remote_abook_history =====
24526 <HTML>
24527 <HEAD>
24528 <TITLE>OPTION: <!--#echo var="VAR_remote-abook-history"--></TITLE>
24529 </HEAD>
24530 <BODY>
24531 <H1>OPTION: <!--#echo var="VAR_remote-abook-history"--></H1>
24532
24533 Sets how many extra copies of
24534 remote address book
24535 data will be kept in each remote address book folder.
24536 The default is three.
24537 These extra copies are simply old versions of the data. Each time a change
24538 is made a new copy of the address book data is appended to the folder. Old
24539 copies are trimmed, if possible, when Alpine exits.
24540 An old copy can be put back into use by
24541 deleting and expunging newer versions of the data from the folder.
24542 Don't delete the first message from the folder. It is a special header
24543 message for the remote address book and it must be there.
24544 This is to prevent regular folders from being used as remote address book
24545 folders and having their data destroyed.
24546 <P>
24547 This option is also used to determine how many extra copies of remote
24548 Alpine configuration files are kept.
24549 <P>
24550 <UL>
24551 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24552 </UL><P>
24553 &lt;End of help on this topic&gt;
24554 </BODY>
24555 </HTML>
24556 ====== h_config_remote_abook_validity =====
24557 <HTML>
24558 <HEAD>
24559 <TITLE>OPTION: <!--#echo var="VAR_remote-abook-validity"--></TITLE>
24560 </HEAD>
24561 <BODY>
24562 <H1>OPTION: <!--#echo var="VAR_remote-abook-validity"--></H1>
24563
24564 Sets the minimum number of minutes that a
24565 remote address book will be considered up to date.
24566 Whenever an entry contained in a remote address book is used,
24567 if more than this many minutes have
24568 passed since the last check the remote server will be queried to see if the
24569 address book has changed.
24570 If it has changed, the local copy is updated.
24571 The default value is five minutes.
24572 The special value of -1 means never check.
24573 The special value of zero means only check when the address book is first
24574 opened.
24575 <P>
24576 No matter what the value, the validity check is always done when the
24577 address book is about to be changed by the user.
24578 The check can be initiated manually by typing <EM>^L</EM> (Ctrl-L)
24579 while in the address book maintenance screen for the remote address book.
24580 <P>
24581 <UL>
24582 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24583 </UL><P>
24584 &lt;End of help on this topic&gt;
24585 </BODY>
24586 </HTML>
24587 ====== h_config_user_input_timeo =====
24588 <HTML>
24589 <HEAD>
24590 <TITLE>OPTION: <!--#echo var="VAR_user-input-timeout"--></TITLE>
24591 </HEAD>
24592 <BODY>
24593 <H1>OPTION: <!--#echo var="VAR_user-input-timeout"--></H1>
24594
24595 If this is set to an integer greater than zero, then this is the number
24596 of <EM>hours</EM> to wait for user input before Alpine times out.
24597 If Alpine is
24598 in the midst of composing a message or is waiting for user response to
24599 a question, then it will not timeout.
24600 However, if Alpine is sitting idle waiting for
24601 the user to tell it what to do next and the user does not give any
24602 input for this many hours, Alpine will exit.
24603 No expunging or moving of read
24604 messages will take place.
24605 It will exit similarly to the way it would exit
24606 if it received a hangup signal.
24607 This may be useful for cleaning up unused Alpine sessions that have been
24608 forgotten by their owners.
24609 The Alpine developers envision system administrators
24610 setting this to a value of several hours (24?) so that it won't surprise
24611 a user who didn't want to be disconnected.
24612 <P>
24613 <UL>
24614 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24615 </UL><P>
24616 &lt;End of help on this topic&gt;
24617 </BODY>
24618 </HTML>
24619 ====== h_config_ssh_open_timeo =====
24620 <HTML>
24621 <HEAD>
24622 <TITLE>OPTION: <!--#echo var="VAR_ssh-open-timeout"--></TITLE>
24623 </HEAD>
24624 <BODY>
24625 <H1>OPTION: <!--#echo var="VAR_ssh-open-timeout"--></H1>
24626
24627 Sets the time in seconds that Alpine will
24628 attempt to open a UNIX secure shell connection.
24629 The default is 15, the minimum non-zero value is 5,
24630 and the maximum is unlimited. If this is set to zero ssh connections
24631 will be completely disabled.
24632 <P>
24633 <UL>
24634 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24635 </UL><P>
24636 &lt;End of help on this topic&gt;
24637 </BODY>
24638 </HTML>
24639 ====== h_config_rsh_open_timeo =====
24640 <HTML>
24641 <HEAD>
24642 <TITLE>OPTION: <!--#echo var="VAR_rsh-open-timeout"--></TITLE>
24643 </HEAD>
24644 <BODY>
24645 <H1>OPTION: <!--#echo var="VAR_rsh-open-timeout"--></H1>
24646
24647 Sets the time in seconds that Alpine will
24648 attempt to open a UNIX remote shell connection.
24649 The default is 15, the minimum non-zero value is 5,
24650 and the maximum is unlimited. If this is set to zero rsh connections
24651 will be completely disabled.
24652 This might be useful if rsh connections will never work in your environment
24653 but are causing delays due to firewalls or some other reason.
24654 <P>
24655 <UL>
24656 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24657 </UL><P>
24658 &lt;End of help on this topic&gt;
24659 </BODY>
24660 </HTML>
24661 ====== h_config_tcp_open_timeo =====
24662 <HTML>
24663 <HEAD>
24664 <TITLE>OPTION: <!--#echo var="VAR_tcp-open-timeout"--></TITLE>
24665 </HEAD>
24666 <BODY>
24667 <H1>OPTION: <!--#echo var="VAR_tcp-open-timeout"--></H1>
24668
24669 Sets the time in seconds that Alpine will
24670 attempt to open a network connection. The default is 30, the minimum is 5,
24671 and the maximum is system defined (typically 75). If a connection has not
24672 completed within this many seconds Alpine will give up and consider it a
24673 failed connection.
24674 <P>
24675 <UL>
24676 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24677 </UL><P>
24678 &lt;End of help on this topic&gt;
24679 </BODY>
24680 </HTML>
24681 ====== h_config_tcp_readwarn_timeo =====
24682 <HTML>
24683 <HEAD>
24684 <TITLE>OPTION: <!--#echo var="VAR_tcp-read-warning-timeout"--></TITLE>
24685 </HEAD>
24686 <BODY>
24687 <H1>OPTION: <!--#echo var="VAR_tcp-read-warning-timeout"--></H1>
24688
24689 Sets the time in seconds that Alpine will
24690 wait for a network read before warning you that things are moving slowly
24691 and possibly giving you the option to break the connection.
24692 The default is 15 seconds. The minimum is 5 seconds and the maximumn is
24693 1000 seconds.
24694 <P>
24695 Related option: <A HREF="h_config_tcp_query_timeo"><!--#echo var="VAR_tcp-query-timeout"--></A>.
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_tcp_writewarn_timeo =====
24704 <HTML>
24705 <HEAD>
24706 <TITLE>OPTION: <!--#echo var="VAR_tcp-write-warning-timeout"--></TITLE>
24707 </HEAD>
24708 <BODY>
24709 <H1>OPTION: <!--#echo var="VAR_tcp-write-warning-timeout"--></H1>
24710
24711 Sets the time in seconds that Alpine will
24712 wait for a network write before warning you that things are moving slowly
24713 and possibly giving you the option to break the connection.
24714 The default is 0 which means it is unset. If set to a non-zero value, the
24715 minimum is 5 and the maximum is 1000.
24716 <P>
24717 Related option: <A HREF="h_config_tcp_query_timeo"><!--#echo var="VAR_tcp-query-timeout"--></A>.
24718 <P>
24719 <UL>
24720 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24721 </UL><P>
24722 &lt;End of help on this topic&gt;
24723 </BODY>
24724 </HTML>
24725 ====== h_config_tcp_query_timeo =====
24726 <HTML>
24727 <HEAD>
24728 <TITLE>OPTION: <!--#echo var="VAR_tcp-query-timeout"--></TITLE>
24729 </HEAD>
24730 <BODY>
24731 <H1>OPTION: <!--#echo var="VAR_tcp-query-timeout"--></H1>
24732
24733 When Alpine times out a network read or write it will normally just display
24734 a message saying &quot;Still waiting&quot;.
24735 However, if enough time has elapsed since it started waiting it will offer
24736 to let you break the connection.
24737 That amount of time is set by this option, which defaults to 60 seconds,
24738 has a minimum of 5 seconds, and a maximum of 1000 seconds.
24739 <P>
24740 <UL>
24741 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24742 </UL><P>
24743 &lt;End of help on this topic&gt;
24744 </BODY>
24745 </HTML>
24746 ====== h_config_incoming_folders =====
24747 <HTML>
24748 <HEAD>
24749 <TITLE>OPTION: <!--#echo var="VAR_incoming-folders"--></TITLE>
24750 </HEAD>
24751 <BODY>
24752 <H1>OPTION: <!--#echo var="VAR_incoming-folders"--></H1>
24753
24754 This is a list of one or more folders other than <EM>INBOX</EM> that
24755 may receive new messages.
24756 It is related to the
24757 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="FEAT_enable-incoming-folders"-->&quot;</A>
24758 feature.
24759 This variable is normally manipulated with the Add, Delete, and Rename
24760 commands in the FOLDER LIST for the Incoming Message Folders collection.
24761 <P>
24762 <UL>
24763 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24764 </UL><P>
24765 &lt;End of help on this topic&gt;
24766 </BODY>
24767 </HTML>
24768 ====== h_config_folder_spec =====
24769 <HTML>
24770 <HEAD>
24771 <TITLE>OPTION: <!--#echo var="VAR_folder-collections"--></TITLE>
24772 </HEAD>
24773 <BODY>
24774 <H1>OPTION: <!--#echo var="VAR_folder-collections"--></H1>
24775
24776 This is a list of one or more collections where saved mail is stored.
24777 The first collection in this list is the default
24778 collection for <EM>Save</EM>s,
24779 including <A HREF="h_config_default_fcc"><!--#echo var="VAR_default-fcc"--></A>.
24780 <P>
24781 This variable is normally manipulated using the Setup/collectionList screen.
24782 <P>
24783 <UL>
24784 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24785 </UL><P>
24786 &lt;End of help on this topic&gt;
24787 </BODY>
24788 </HTML>
24789 ====== h_config_news_spec =====
24790 <HTML>
24791 <HEAD>
24792 <TITLE>OPTION: <!--#echo var="VAR_news-collections"--></TITLE>
24793 </HEAD>
24794 <BODY>
24795 <H1>OPTION: <!--#echo var="VAR_news-collections"--></H1>
24796
24797 This is a list of collections where news folders are located.
24798 <P>
24799 This variable is normally manipulated using the Setup/collectionList screen.
24800 <P>
24801 <UL>
24802 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24803 </UL><P>
24804 &lt;End of help on this topic&gt;
24805 </BODY>
24806 </HTML>
24807 ====== h_config_address_book =====
24808 <HTML>
24809 <HEAD>
24810 <TITLE>OPTION: <!--#echo var="VAR_address-book"--></TITLE>
24811 </HEAD>
24812 <BODY>
24813 <H1>OPTION: <!--#echo var="VAR_address-book"--></H1>
24814
24815 A list of personal address books.
24816 Each entry in the list is an
24817 optional nickname followed by a pathname or file name relative to the home
24818 directory.
24819 The nickname is separated from the rest of the line with whitespace.
24820 Instead of a local pathname or file name, a remote folder name can be given.
24821 This causes the address book to
24822 be a Remote address book.
24823 <P>
24824 Use the Setup/AddressBook screen to modify this variable.
24825 <P>
24826 <UL>
24827 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24828 </UL><P>
24829 &lt;End of help on this topic&gt;
24830 </BODY>
24831 </HTML>
24832 ====== h_config_glob_addrbook =====
24833 <HTML>
24834 <HEAD>
24835 <TITLE>OPTION: <!--#echo var="VAR_global-address-book"--></TITLE>
24836 </HEAD>
24837 <BODY>
24838 <H1>OPTION: <!--#echo var="VAR_global-address-book"--></H1>
24839
24840 A list of shared address books.  Each entry in the list is an
24841 optional nickname followed by a pathname or file name relative to the home
24842 directory.
24843 A SPACE character separates the nickname from the rest of the line.
24844 Instead of a local pathname or file name, a remote folder name can be given.
24845 This causes the address book to
24846 be a Remote address book.
24847 Global address books are
24848 defined to be ReadOnly.
24849 <P>
24850 Use the Setup/AddressBook screen to modify this variable.
24851 <P>
24852 <UL>
24853 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24854 </UL><P>
24855 &lt;End of help on this topic&gt;
24856 </BODY>
24857 </HTML>
24858 ====== h_config_last_vers =====
24859 <HTML>
24860 <HEAD>
24861 <TITLE>OPTION: <!--#echo var="VAR_last-version-used"--></TITLE>
24862 </HEAD>
24863 <BODY>
24864 <H1>OPTION: <!--#echo var="VAR_last-version-used"--></H1>
24865
24866 This is set automatically by Alpine.
24867 It is used to keep track of the last version of Alpine that
24868 was run by the user.
24869 Whenever the version number increases, a new version message is printed out.
24870 This may not be set in the system-wide configuration files.
24871 <P>
24872 <UL>
24873 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24874 </UL><P>
24875 &lt;End of help on this topic&gt;
24876 </BODY>
24877 </HTML>
24878 ====== h_config_printer =====
24879 <HTML>
24880 <HEAD>
24881 <TITLE>OPTION: Printer</TITLE>
24882 </HEAD>
24883 <BODY>
24884 <H1>OPTION: Printer</H1>
24885
24886 Your default printer selection.
24887 <P>
24888 Use the Setup/Printer screen to modify this variable.
24889 <P>
24890 <UL>
24891 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24892 </UL><P>
24893 &lt;End of help on this topic&gt;
24894 </BODY>
24895 </HTML>
24896 ====== h_config_print_cat =====
24897 <HTML>
24898 <HEAD>
24899 <TITLE>OPTION: <!--#echo var="VAR_personal-print-category"--></TITLE>
24900 </HEAD>
24901 <BODY>
24902 <H1>OPTION: <!--#echo var="VAR_personal-print-category"--></H1>
24903
24904 This is an internal Alpine variable.
24905 It will be equal to 1, 2, or 3 depending on whether the default printer is
24906 attached, standard, or a personal print command.
24907 <P>
24908 Use the Setup/Printer screen to modify this variable.
24909 <P>
24910 <UL>
24911 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24912 </UL><P>
24913 &lt;End of help on this topic&gt;
24914 </BODY>
24915 </HTML>
24916 ====== h_config_print_command =====
24917 <HTML>
24918 <HEAD>
24919 <TITLE>OPTION: <!--#echo var="VAR_personal-print-command"--></TITLE>
24920 </HEAD>
24921 <BODY>
24922 <H1>OPTION: <!--#echo var="VAR_personal-print-command"--></H1>
24923
24924 List of personal print commands.
24925 <P>
24926 Use the Setup/Printer screen to modify this variable.
24927 <P>
24928 <UL>
24929 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24930 </UL><P>
24931 &lt;End of help on this topic&gt;
24932 </BODY>
24933 </HTML>
24934 ====== h_config_pat_old =====
24935 <HTML>
24936 <HEAD>
24937 <TITLE>OPTION: Patterns</TITLE>
24938 </HEAD>
24939 <BODY>
24940 <H1>OPTION: Patterns</H1>
24941
24942 The option Patterns is obsolete in Alpine and in Pine 4.50 and later, replaced by the
24943 options Patterns-Roles, Patterns-Filters, Patterns-Scores, Patterns-Indexcolors,
24944 and Patterns-Other.
24945 Patterns-Scores and Patterns-Filters have been replaced since then by
24946 Patterns-Scores2 and Patterns-Filters2.
24947 <P>
24948 Use the Setup/Rules screens to modify these variable.
24949 <P>
24950 <UL>
24951 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24952 </UL><P>
24953 &lt;End of help on this topic&gt;
24954 </BODY>
24955 </HTML>
24956 ====== h_config_pat_roles =====
24957 <HTML>
24958 <HEAD>
24959 <TITLE>OPTION: <!--#echo var="VAR_patterns-roles"--></TITLE>
24960 </HEAD>
24961 <BODY>
24962 <H1>OPTION: <!--#echo var="VAR_patterns-roles"--></H1>
24963
24964 List of rules used for roles.
24965 The option Patterns is obsolete in Alpine and in Pine 4.50 and later, replaced by this and
24966 other options.
24967 <P>
24968 Use the Setup/Rules/Roles screen to modify this variable.
24969 <P>
24970 <UL>
24971 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24972 </UL><P>
24973 &lt;End of help on this topic&gt;
24974 </BODY>
24975 </HTML>
24976 ====== h_config_pat_filts =====
24977 <HTML>
24978 <HEAD>
24979 <TITLE>OPTION: <!--#echo var="VAR_patterns-filters2"--></TITLE>
24980 </HEAD>
24981 <BODY>
24982 <H1>OPTION: <!--#echo var="VAR_patterns-filters2"--></H1>
24983
24984 List of rules used for filters.
24985 <P>
24986 Use the Setup/Rules/Filters screen to modify this variable.
24987 <P>
24988 <UL>
24989 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24990 </UL><P>
24991 &lt;End of help on this topic&gt;
24992 </BODY>
24993 </HTML>
24994 ====== h_config_pat_scores =====
24995 <HTML>
24996 <HEAD>
24997 <TITLE>OPTION: <!--#echo var="VAR_patterns-scores2"--></TITLE>
24998 </HEAD>
24999 <BODY>
25000 <H1>OPTION: <!--#echo var="VAR_patterns-scores2"--></H1>
25001
25002 List of rules used for scoring.
25003 <P>
25004 Use the Setup/Rules/SetScores screen to modify this variable.
25005 <P>
25006 <UL>
25007 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25008 </UL><P>
25009 &lt;End of help on this topic&gt;
25010 </BODY>
25011 </HTML>
25012 ====== h_config_pat_other =====
25013 <HTML>
25014 <HEAD>
25015 <TITLE>OPTION: <!--#echo var="VAR_patterns-other"--></TITLE>
25016 </HEAD>
25017 <BODY>
25018 <H1>OPTION: <!--#echo var="VAR_patterns-other"--></H1>
25019
25020 List of rules used for miscellaneous configuration.
25021 <P>
25022 Use the Setup/Rules/Other screen to modify this variable.
25023 <P>
25024 <UL>
25025 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25026 </UL><P>
25027 &lt;End of help on this topic&gt;
25028 </BODY>
25029 </HTML>
25030 ====== h_config_pat_incols =====
25031 <HTML>
25032 <HEAD>
25033 <TITLE>OPTION: patterns-indexcolors</TITLE>
25034 </HEAD>
25035 <BODY>
25036 <H1>OPTION: patterns-indexcolors</H1>
25037
25038 List of rules used for coloring lines in the index.
25039 <P>
25040 Use the Setup/Rules/Indexcolor screen to modify this variable.
25041 <P>
25042 <UL>
25043 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25044 </UL><P>
25045 &lt;End of help on this topic&gt;
25046 </BODY>
25047 </HTML>
25048 ====== h_config_pat_srch =====
25049 <HTML>
25050 <HEAD>
25051 <TITLE>OPTION: patterns-search</TITLE>
25052 </HEAD>
25053 <BODY>
25054 <H1>OPTION: patterns-search</H1>
25055
25056 List of rules used only for searching with the Select command in the MESSAGE INDEX.
25057 <P>
25058 Use the Setup/Rules/searCh screen to modify this variable.
25059 <P>
25060 <UL>
25061 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25062 </UL><P>
25063 &lt;End of help on this topic&gt;
25064 </BODY>
25065 </HTML>
25066 ====== h_config_font_name =====
25067 <HTML>
25068 <HEAD>
25069 <TITLE>OPTION: Font Name</TITLE>
25070 </HEAD>
25071 <BODY>
25072 <H1>OPTION: Font Name</H1>
25073
25074 PC-Alpine only.
25075 <P>
25076 Name of normal font.
25077 <P>
25078 Use the pulldown Config menu to modify this variable.
25079 <P>
25080 <UL>
25081 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25082 </UL><P>
25083 &lt;End of help on this topic&gt;
25084 </BODY>
25085 </HTML>
25086 ====== h_config_font_size =====
25087 <HTML>
25088 <HEAD>
25089 <TITLE>OPTION: Font Size</TITLE>
25090 </HEAD>
25091 <BODY>
25092 <H1>OPTION: Font Size</H1>
25093
25094 PC-Alpine only.
25095 <P>
25096 Size of normal font.
25097 <P>
25098 Use the pulldown Config menu to modify this variable.
25099 <P>
25100 <UL>
25101 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25102 </UL><P>
25103 &lt;End of help on this topic&gt;
25104 </BODY>
25105 </HTML>
25106 ====== h_config_font_style =====
25107 <HTML>
25108 <HEAD>
25109 <TITLE>OPTION: Font Style</TITLE>
25110 </HEAD>
25111 <BODY>
25112 <H1>OPTION: Font Style</H1>
25113
25114 PC-Alpine only.
25115 <P>
25116 Style of normal font.
25117 <P>
25118 Use the pulldown Config menu to modify this variable.
25119 <P>
25120 <UL>
25121 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25122 </UL><P>
25123 &lt;End of help on this topic&gt;
25124 </BODY>
25125 </HTML>
25126 ====== h_config_font_char_set =====
25127 <HTML>
25128 <HEAD>
25129 <TITLE>OPTION: Font Character Set</TITLE>
25130 </HEAD>
25131 <BODY>
25132 <H1>OPTION: Font Character Set</H1>
25133
25134 PC-Alpine only.
25135 <P>
25136 Character set of normal font.
25137 <P>
25138 Use the pulldown Config menu to modify this variable.
25139 <P>
25140 <UL>
25141 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25142 </UL><P>
25143 &lt;End of help on this topic&gt;
25144 </BODY>
25145 </HTML>
25146 ====== h_config_print_font_name =====
25147 <HTML>
25148 <HEAD>
25149 <TITLE>OPTION: Print-Font-Name</TITLE>
25150 </HEAD>
25151 <BODY>
25152 <H1>OPTION: Print-Font-Name</H1>
25153
25154 PC-Alpine only.
25155 <P>
25156 Name of printer font.
25157 <P>
25158 Use the pulldown Config menu to modify this variable.
25159 <P>
25160 <UL>
25161 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25162 </UL><P>
25163 &lt;End of help on this topic&gt;
25164 </BODY>
25165 </HTML>
25166 ====== h_config_print_font_size =====
25167 <HTML>
25168 <HEAD>
25169 <TITLE>OPTION: Print-Font-Size</TITLE>
25170 </HEAD>
25171 <BODY>
25172 <H1>OPTION: Print-Font-Size</H1>
25173
25174 PC-Alpine only.
25175 <P>
25176 Size of printer font.
25177 <P>
25178 Use the pulldown Config menu to modify this variable.
25179 <P>
25180 <UL>
25181 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25182 </UL><P>
25183 &lt;End of help on this topic&gt;
25184 </BODY>
25185 </HTML>
25186 ====== h_config_print_font_style =====
25187 <HTML>
25188 <HEAD>
25189 <TITLE>OPTION: Print-Font-Style</TITLE>
25190 </HEAD>
25191 <BODY>
25192 <H1>OPTION: Print-Font-Style</H1>
25193
25194 PC-Alpine only.
25195 <P>
25196 Style of printer font.
25197 <P>
25198 Use the pulldown Config menu to modify this variable.
25199 <P>
25200 <UL>
25201 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25202 </UL><P>
25203 &lt;End of help on this topic&gt;
25204 </BODY>
25205 </HTML>
25206 ====== h_config_print_font_char_set =====
25207 <HTML>
25208 <HEAD>
25209 <TITLE>OPTION: Print-Font-Char-Set</TITLE>
25210 </HEAD>
25211 <BODY>
25212 <H1>OPTION: Print-Font-Char-Set</H1>
25213
25214 PC-Alpine only.
25215 <P>
25216 Character set of printer font.
25217 <P>
25218 Use the pulldown Config menu to modify this variable.
25219 <P>
25220 <UL>
25221 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25222 </UL><P>
25223 &lt;End of help on this topic&gt;
25224 </BODY>
25225 </HTML>
25226 ====== h_config_window_position =====
25227 <HTML>
25228 <HEAD>
25229 <TITLE>OPTION: Window-Position</TITLE>
25230 </HEAD>
25231 <BODY>
25232 <H1>OPTION: Window-Position</H1>
25233
25234 PC-Alpine only.
25235 <P>
25236 Position on the screen of the Alpine window.
25237 <P>
25238 Alpine normally maintains this variable itself, and it is set automatically.
25239 This variable is provided to those who wish to use the same window position
25240 across different machines from the same configuration.
25241 <A HREF="h_config_winpos_in_config"><!--#echo var="FEAT_store-window-position-in-config"--></A>
25242 must also be set for this setting to be used.
25243 <P>
25244 The format for this variable is of the form: <CODE>CxR+X+Y</CODE>, where
25245 C is the number of columns, R is the number of rows, and X and Y specify the
25246 top left corner of the window.
25247 <P>
25248 <UL>
25249 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25250 </UL><P>
25251 &lt;End of help on this topic&gt;
25252 </BODY>
25253 </HTML>
25254 ====== h_config_cursor_style =====
25255 <HTML>
25256 <HEAD>
25257 <TITLE>OPTION: Cursor Style</TITLE>
25258 </HEAD>
25259 <BODY>
25260 <H1>OPTION: Cursor Style</H1>
25261
25262 PC-Alpine only.
25263 <P>
25264 Cursor style.
25265 <P>
25266 Use the pulldown Config menu to modify this variable.
25267 <P>
25268 <UL>
25269 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25270 </UL><P>
25271 &lt;End of help on this topic&gt;
25272 </BODY>
25273 </HTML>
25274 ====== h_config_ldap_servers =====
25275 <HTML>
25276 <HEAD>
25277 <TITLE>OPTION: <!--#echo var="VAR_ldap-servers"--></TITLE>
25278 </HEAD>
25279 <BODY>
25280 <H1>OPTION: <!--#echo var="VAR_ldap-servers"--></H1>
25281
25282 List of LDAP servers and associated data.
25283 <P>
25284 Use the Setup/Directory screen to modify this variable.
25285 <P>
25286 <UL>
25287 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25288 </UL><P>
25289 &lt;End of help on this topic&gt;
25290 </BODY>
25291 </HTML>
25292 ====== h_config_sendmail_path =====
25293 <HTML>
25294 <HEAD>
25295 <TITLE>OPTION: <!--#echo var="VAR_sendmail-path"--></TITLE>
25296 </HEAD>
25297 <BODY>
25298 <H1>OPTION: <!--#echo var="VAR_sendmail-path"--></H1>
25299
25300 This names the path to an
25301 alternative program, and any necessary arguments, to be used in posting
25302 mail messages. See the Technical notes for more information.
25303 <P>
25304 <UL>
25305 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25306 </UL><P>
25307 &lt;End of help on this topic&gt;
25308 </BODY>
25309 </HTML>
25310 ====== h_config_oper_dir =====
25311 <HTML>
25312 <HEAD>
25313 <TITLE>OPTION: <!--#echo var="VAR_operating-dir"--></TITLE>
25314 </HEAD>
25315 <BODY>
25316 <H1>OPTION: <!--#echo var="VAR_operating-dir"--></H1>
25317
25318 This names the root of the
25319 tree to which you are restricted when reading and writing folders and
25320 files. It is usually used in the system-wide,
25321 <EM>fixed</EM> configuration file.
25322 <P>
25323 <UL>
25324 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25325 </UL><P>
25326 &lt;End of help on this topic&gt;
25327 </BODY>
25328 </HTML>
25329 ====== h_config_rshpath =====
25330 <HTML>
25331 <HEAD>
25332 <TITLE>OPTION: <!--#echo var="VAR_rsh-path"--></TITLE>
25333 </HEAD>
25334 <BODY>
25335 <H1>OPTION: <!--#echo var="VAR_rsh-path"--></H1>
25336
25337 Sets the name of the command used to open a UNIX remote shell
25338 connection. The default is typically <CODE>/usr/ucb/rsh</CODE>.
25339 <P>
25340 <UL>
25341 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25342 </UL><P>
25343 &lt;End of help on this topic&gt;
25344 </BODY>
25345 </HTML>
25346 ====== h_config_rshcmd =====
25347 <HTML>
25348 <HEAD>
25349 <TITLE>OPTION: <!--#echo var="VAR_rsh-command"--></TITLE>
25350 </HEAD>
25351 <BODY>
25352 <H1>OPTION: <!--#echo var="VAR_rsh-command"--></H1>
25353
25354 Sets the format of the command used to
25355 open a UNIX remote shell connection. The default is
25356 "%s %s -l %s exec /etc/r%sd". All four "%s" entries MUST exist in the
25357 provided command. The first is for the command's pathname, the second is
25358 for the host to connnect to, the third is for the user to connect as, and
25359 the fourth is for the connection method (typically <CODE>imap</CODE>).
25360 <P>
25361 <UL>
25362 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25363 </UL><P>
25364 &lt;End of help on this topic&gt;
25365 </BODY>
25366 </HTML>
25367 ====== h_config_sshpath =====
25368 <HTML>
25369 <HEAD>
25370 <TITLE>OPTION: <!--#echo var="VAR_ssh-path"--></TITLE>
25371 </HEAD>
25372 <BODY>
25373 <H1>OPTION: <!--#echo var="VAR_ssh-path"--></H1>
25374
25375 Sets the name of the command used to open a UNIX secure shell
25376 connection. The default is typically <CODE>/usr/bin/ssh</CODE>.
25377 <P>
25378 <UL>
25379 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25380 </UL><P>
25381 &lt;End of help on this topic&gt;
25382 </BODY>
25383 </HTML>
25384 ====== h_config_sshcmd =====
25385 <HTML>
25386 <HEAD>
25387 <TITLE>OPTION: <!--#echo var="VAR_ssh-command"--></TITLE>
25388 </HEAD>
25389 <BODY>
25390 <H1>OPTION: <!--#echo var="VAR_ssh-command"--></H1>
25391
25392 Sets the format of the command used to
25393 open a UNIX secure shell connection. The default is
25394 "%s %s -l %s exec /etc/r%sd". All four "%s" entries MUST exist in the
25395 provided command. The first is for the command's pathname, the second is
25396 for the host to connnect to, the third is for the user to connect as, and
25397 the fourth is for the connection method (typically <CODE>imap</CODE>).
25398 <P>
25399 <UL>
25400 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25401 </UL><P>
25402 &lt;End of help on this topic&gt;
25403 </BODY>
25404 </HTML>
25405 ====== h_config_new_ver_quell =====
25406 <HTML>
25407 <HEAD>
25408 <TITLE>OPTION: <!--#echo var="VAR_new-version-threshold"--></TITLE>
25409 </HEAD>
25410 <BODY>
25411 <H1>OPTION: <!--#echo var="VAR_new-version-threshold"--></H1>
25412
25413 When a new version of Alpine is run for the first time it offers a
25414 special explanatory screen to the user upon startup.  This option
25415 helps control when and if that special screen appears for users that
25416 have previously run Alpine.  It takes as its value an Alpine version
25417 number.  Alpine versions less than the specified value will supress this
25418 special screen while versions equal to or greater than that specified
25419 will behave normally.
25420 <P>
25421 <UL>
25422 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25423 </UL><P>
25424 &lt;End of help on this topic&gt;
25425 </BODY>
25426 </HTML>
25427 ====== h_config_disable_drivers =====
25428 <HTML>
25429 <HEAD>
25430 <TITLE>OPTION: <!--#echo var="VAR_disable-these-drivers"--></TITLE>
25431 </HEAD>
25432 <BODY>
25433 <H1>OPTION: <!--#echo var="VAR_disable-these-drivers"--></H1>
25434
25435 This variable is a list of mail drivers that will be disabled.
25436 The candidates for disabling are listed below.
25437 There may be more in the future if you compile Alpine with
25438 a newer version of the c-client library.
25439 <P>
25440
25441 <UL>
25442 <LI> mbox
25443 <LI> mbx
25444 <LI> mh
25445 <LI> mmdf
25446 <LI> mtx
25447 <LI> mx
25448 <LI> news
25449 <LI> phile
25450 <LI> tenex
25451 <LI> unix
25452 </UL>
25453 <P>
25454
25455 The <EM>mbox</EM> driver enables the following behavior: if there is a
25456 file called <CODE>mbox</CODE>
25457 in your home directory, and if that file is either empty or in Unix mailbox
25458 format, then every time you open <EM>INBOX</EM> the <EM>mbox</EM> driver
25459 will automatically transfer mail from the system mail spool directory into the
25460 <CODE>mbox</CODE> file and
25461 delete it from the spool directory. If you disable the <EM>mbox</EM> driver,
25462 this will not happen.
25463 <P>
25464
25465 It is not recommended to disable the driver that supports the system default
25466 mailbox format. On most non-SCO systems, that driver is the
25467 <EM>unix</EM> driver.
25468 On most SCO systems, it is the <EM>mmdf</EM> driver.
25469 The system default driver may be
25470 configured to something else on your system; check with your system manager
25471 for additional information.
25472 <P>
25473
25474 It is most likely not very useful for you to disable any of the drivers other
25475 than possibly <EM>mbox</EM>.
25476 You could disable some of the others if you know for
25477 certain that you don't need them but the performance gain in doing so
25478 is very modest.
25479 <P>
25480 <UL>
25481 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25482 </UL><P>
25483 &lt;End of help on this topic&gt;
25484 </BODY>
25485 </HTML>
25486 ====== h_config_disable_auths =====
25487 <HTML>
25488 <HEAD>
25489 <TITLE>OPTION: <!--#echo var="VAR_disable-these-authenticators"--></TITLE>
25490 </HEAD>
25491 <BODY>
25492 <H1>OPTION: <!--#echo var="VAR_disable-these-authenticators"--></H1>
25493
25494 This variable is a list of SASL (Simple Authentication and Security
25495 Layer) authenticators that will be disabled.
25496 SASL is a mechanism for
25497 authenticating to IMAP, POP3, SMTP, and other network servers.
25498 <P>
25499
25500 Alpine matches its list of supported authenticators with the server to
25501 determine the most secure authenticator that is supported by both.
25502 If no matching authenticators are found, Alpine will revert to plaintext
25503 login (or, in the case of SMTP, will be unable to authenticate at all).
25504 <P>
25505 The candidates for disabling can be found <A HREF="X-Alpine-Config:">here</A>.
25506 <P>
25507
25508 Normally, you will not disable any authenticators.
25509 There are two exceptions:
25510 <P>
25511 <OL>
25512 <LI> You use a broken server that advertises an authenticator,
25513 but does not actually implement it.
25514 <LI> You have a Kerberos-capable version of Alpine and the server is
25515 also Kerberos-capable, but you can not obtain Kerberos
25516 credentials on the server machine, thus you desire to disable
25517 GSSAPI (which in turn disables Alpine's Kerberos support).
25518 </OL>
25519 <P>
25520 It is never necessary to disable authenticators, since Alpine will try
25521 other authenticators before giving up.
25522 However, disabling the relevant authenticator avoids annoying error messages.
25523 <P>
25524 <UL>
25525 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25526 </UL><P>
25527 &lt;End of help on this topic&gt;
25528 </BODY>
25529 </HTML>
25530 ====== h_config_abook_metafile =====
25531 <HTML>
25532 <HEAD>
25533 <TITLE>OPTION: <!--#echo var="VAR_remote-abook-metafile"--></TITLE>
25534 </HEAD>
25535 <BODY>
25536 <H1>OPTION: <!--#echo var="VAR_remote-abook-metafile"--></H1>
25537
25538 This is usually set by Alpine and is the name of a file
25539 that contains data about
25540 remote address books and remote configuration files.
25541 <P>
25542 <UL>
25543 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25544 </UL><P>
25545 &lt;End of help on this topic&gt;
25546 </BODY>
25547 </HTML>
25548 ====== h_config_composer_wrap_column =====
25549 <HTML>
25550 <HEAD>
25551 <TITLE>OPTION: <!--#echo var="VAR_composer-wrap-column"--></TITLE>
25552 </HEAD>
25553 <BODY>
25554 <H1>OPTION: <!--#echo var="VAR_composer-wrap-column"--></H1>
25555
25556
25557 This option specifies an aspect of Alpine's Composer.  This gives the
25558 maximum width that auto-wrapped lines will have.  It's also the maximum
25559 width of lines justified using the <A HREF="h_compose_justify">^J
25560 Justify</A> command.  The normal default
25561 is &quot;74&quot;.  The largest allowed setting is normally &quot;80&quot;
25562 in order to
25563 prevent very long lines from being sent in outgoing mail.  When the mail
25564 is actually sent, trailing spaces will be stripped off of each line.
25565
25566 <P>
25567 <UL>
25568 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25569 </UL><P>
25570 &lt;End of help on this topic&gt;
25571 </BODY>
25572 </HTML>
25573 ====== h_config_deadlets =====
25574 <HTML>
25575 <HEAD>
25576 <TITLE>OPTION: <!--#echo var="VAR_dead-letter-files"--></TITLE>
25577 </HEAD>
25578 <BODY>
25579 <H1>OPTION: <!--#echo var="VAR_dead-letter-files"--></H1>
25580
25581
25582 This option affects Alpine's behavior when you cancel a message being
25583 composed.  Alpine's usual behavior is to write the canceled message to
25584 a file named
25585 <!--chtml if pinemode="os_windows"-->
25586 &quot;DEADLETR&quot;,
25587 <!--chtml else-->
25588 &quot;dead.letter&quot; in your home directory,
25589 <!--chtml endif-->
25590 overwriting any previous message.
25591 <P>
25592 If you set this option to a value higher than one, then that many copies
25593 of dead letter files will be saved.
25594 For example, if you set this option to &quot;3&quot; then you may have
25595 files named
25596 <!--chtml if pinemode="os_windows"-->
25597 &quot;DEADLETR&quot;,
25598 &quot;DEADLETR2&quot;, and
25599 &quot;DEADLETR3&quot;.
25600 <!--chtml else-->
25601 &quot;dead.letter&quot;,
25602 &quot;dead.letter2&quot;, and
25603 &quot;dead.letter3&quot; in your home directory.
25604 <!--chtml endif-->
25605 In this example, the most recently cancelled message will be in
25606 <!--chtml if pinemode="os_windows"-->
25607 &quot;DEADLETR&quot;,
25608 <!--chtml else-->
25609 &quot;dead.letter&quot;,
25610 <!--chtml endif-->
25611 and the third most recently cancelled message will be in
25612 <!--chtml if pinemode="os_windows"-->
25613 &quot;DEADLETR3&quot;.
25614 <!--chtml else-->
25615 &quot;dead.letter3&quot;.
25616 <!--chtml endif-->
25617 The fourth most recently cancelled message will no longer be saved.
25618
25619 <P>
25620 If you set this option to zero, then NO record of canceled messages is
25621 maintained.
25622 <P>
25623 If the feature
25624 <A HREF="h_config_quell_dead_letter"><!--#echo var="FEAT_quell-dead-letter-on-cancel"--></A>
25625 is set, that overrides whatever you set for this option.
25626 If this option had existed at the time, then the Quell feature would not
25627 have been added, but it is still there for backwards compatibility.
25628 So, in order for this option to have the desired effect, make sure the
25629 Quell feature is turned off.
25630
25631 <P>
25632 <UL>
25633 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25634 </UL><P>
25635 &lt;End of help on this topic&gt;
25636 </BODY>
25637 </HTML>
25638 ====== h_config_maxremstream =====
25639 <HTML>
25640 <HEAD>
25641 <TITLE>OPTION: <!--#echo var="VAR_max-remote-connections"--></TITLE>
25642 </HEAD>
25643 <BODY>
25644 <H1>OPTION: <!--#echo var="VAR_max-remote-connections"--></H1>
25645
25646 This option affects low-level behavior of Alpine.
25647 The default value for this option is <EM>3</EM>.
25648 If your INBOX is accessed using the IMAP protocol
25649 from an IMAP server, that connection is kept open throughout the
25650 duration of your Alpine session, independent of the value of this option.
25651 The same is true of any
25652 <A HREF="h_config_permlocked">&quot;<!--#echo var="VAR_stay-open-folders"-->&quot;</A>
25653 you have defined.
25654 This option controls Alpine's behavior when connecting to remote IMAP folders
25655 other than your INBOX or your <!--#echo var="VAR_stay-open-folders"-->.
25656 It specifies the maximum number of remote IMAP connections (other than
25657 those mentioned above) that Alpine will use for accessing the rest of your
25658 folders.
25659 If you set this option to zero, you will turn off most remote connection
25660 re-use.
25661 It's difficult to understand exactly what this option does, and it is usually
25662 fine to leave it set to its default value.
25663 It is probably more likely that you will be interested in setting the
25664 <A HREF="h_config_permlocked">&quot;<!--#echo var="VAR_stay-open-folders"-->&quot;</A> option
25665 instead of changing the value of this option.
25666 A slightly longer explanation of what is going on with this option
25667 is given in the next paragraphs.
25668
25669 <P>
25670 There are some time costs involved in opening and closing remote IMAP
25671 folders, the main costs being the time you have to wait for the connection
25672 to the server and the time for the folder to open.
25673 Opening a folder may involve not only the time the server takes to do its
25674 processing but time that Alpine uses to do filtering.
25675 These times can vary widely.
25676 They depend on how loaded the server is, how large
25677 the folder being opened is, and how you set up filtering, among other things.
25678 Once Alpine has opened a connection to a particular folder, it will attempt
25679 to keep that connection open in case you use it again.
25680 In order to do this,
25681 Alpine will attempt to use the <!--#echo var="VAR_max-remote-connections"--> (the value of
25682 this option) IMAP connections you have alloted for this purpose.
25683 <P>
25684 For example, suppose the value of this option is set to &quot;2&quot;.
25685 If your INBOX is accessed on a remote server using the IMAP protocol, that
25686 doesn't count as one of the remote connections but it is always kept open.
25687 If you then open another IMAP folder, that would be your first
25688 remote connection counted as one of the <!--#echo var="VAR_max-remote-connections"--> connections.
25689 If you open a third folder the second will be left open, in case you
25690 return to it.
25691 You won't be able to tell it has been left open.
25692 It will appear to be closed when you leave the folder but the connection
25693 will remain in the background.
25694 Now suppose you go back to the second folder (the first folder after the
25695 INBOX).
25696 A connection to that folder is still open so you won't have to wait
25697 for the startup time to open it.
25698 Meanwhile, the connection to the third folder will be left behind.
25699 Now, if you open a fourth folder, you will bump into the
25700 <!--#echo var="VAR_max-remote-connections"--> limit, because this will be the third folder other
25701 than INBOX and you have the option set to &quot;2&quot;.
25702 The connection that is being used for
25703 the third folder will be re-used for this new fourth folder.
25704 If you go back to the third folder after this, it is no longer already
25705 connected when you get there.
25706 You'll still save some time since Alpine will re-use the connection to the
25707 fourth folder and you have already logged in on that connection,
25708 but the folder will have to be re-opened from scratch.
25709 <P>
25710 If a folder is large and the startup cost is dominated by the time it takes
25711 to open that folder or to run filters on it, then it will pay to make the
25712 value of this option large enough to keep it open.
25713 On the other hand, if you only revisit a handful of folders or if
25714 the folders are small, then it might
25715 make more sense to keep this number small so that the reconnect
25716 time (the time to start up a new connection and authenticate)
25717 is eliminated instead.
25718 <P>
25719 You may also need to consider the impact on the server.
25720 On the surface, a larger number here may cause a larger impact on the
25721 server, since you will have more connections open to the server.
25722 On the other hand, not only will <EM>you</EM> be avoiding the startup costs
25723 associated with reopening a folder, but the <EM>server</EM> will be
25724 avoiding those costs as well.
25725 <P>
25726 When twenty five minutes pass without any active use of an IMAP connection
25727 being saved for possible re-use, that connection will be shut down,
25728
25729 <P>
25730 <UL>
25731 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25732 </UL><P>
25733 &lt;End of help on this topic&gt;
25734 </BODY>
25735 </HTML>
25736 ====== h_config_permlocked =====
25737 <HTML>
25738 <HEAD>
25739 <TITLE>OPTION: <!--#echo var="VAR_stay-open-folders"--></TITLE>
25740 </HEAD>
25741 <BODY>
25742 <H1>OPTION: <!--#echo var="VAR_stay-open-folders"--></H1>
25743
25744 This option affects low-level behavior of Alpine.
25745 There is no default value for this option.
25746 It is related to the options
25747 <A HREF="h_config_preopen_stayopens">&quot;<!--#echo var="FEAT_preopen-stayopen-folders"-->&quot;</A>,
25748 <A HREF="h_config_maxremstream">&quot;<!--#echo var="VAR_max-remote-connections"-->&quot;</A>,
25749 and <A HREF="h_config_expunge_stayopens">&quot;<!--#echo var="FEAT_offer-expunge-of-stayopen-folders"-->&quot;</A>.
25750
25751 <P>
25752 Note: changes made to this list take effect the next time you open a
25753 folder in the list.
25754
25755 <P>
25756 This is a list of folders that will be permanently kept open once they
25757 are first opened.
25758 The names in this list may be either the nickname of an Incoming folder
25759 or the full technical specification of a folder.
25760 The folders in this list need not be remote IMAP folders, they could usefully
25761 be local folders, as well.
25762 If a folder in the list is a newsgroup or is not accessed either locally
25763 or via IMAP, then the entry will be ignored.
25764 For example, folders accessed via NNTP or POP3 will not be kept open, since
25765 the way that new mail is found with those protocols involves closing and
25766 reopening the connection.
25767 <P>
25768 Once a Stay Open folder has been opened, new-mail checking will continue
25769 to happen on that folder for the rest of the Alpine session.
25770 Your INBOX is always implicitly included in this Stay-Open list and doesn't
25771 need to be added explicitly.
25772 <P>
25773 Another difference that you may notice between a Stay Open folder and a
25774 non-Stay Open folder is which message is selected as the current message
25775 when you enter the folder index.
25776 Normally, the starting position for an incoming folder (which most Stay Open
25777 folders will likely be) is controlled by the
25778 <A HREF="h_config_inc_startup"><!--#echo var="VAR_incoming-startup-rule"--></A>.
25779 However, if a folder is a Stay Open folder, when you re-enter the folder
25780 after the first time the current message will be the same as it was when
25781 you left the folder.
25782 An exception is made if you use the TAB command to get to the folder.
25783 In that case, the message number will be incremented by one from what it
25784 was when you left the folder.
25785 <P>
25786 The above special behavior is thought to be useful.
25787 However, it is special and different from what you might at first expect.
25788 The feature
25789 <A HREF="h_config_use_reg_start_for_stayopen"><!--#echo var="FEAT_use-regular-startup-rule-for-stayopen-folders"--></A>
25790 may be used to turn off this special treatment.
25791 <P>
25792 If the message that was current when you left the folder no longer exists,
25793 then the regular startup rule will be used instead.
25794
25795 <P>
25796 <UL>
25797 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25798 </UL><P>
25799 &lt;End of help on this topic&gt;
25800 </BODY>
25801 </HTML>
25802 ====== h_config_viewer_overlap =====
25803 <html>
25804 <header>
25805 <title>OPTION: <!--#echo var="VAR_viewer-overlap"--></title>
25806 </header>
25807 <body>
25808 <h1>OPTION: <!--#echo var="VAR_viewer-overlap"--></h1>
25809
25810 This option specifies an aspect of Alpine's Message Viewing screen.  When
25811 the space bar is used to page forward in a message, the number of lines
25812 specified by the &quot;<!--#echo var="VAR_viewer-overlap"-->&quot; variable will be repeated from the
25813 bottom of the screen.  That is, if this was set to two lines, then the
25814 bottom two lines of the screen would be repeated on the top of the next
25815 screen.  The normal default value is "2".<p>
25816 <UL>
25817 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25818 </UL><P>
25819 &lt;End of help on this topic&gt;
25820 </body>
25821 </html>
25822 ====== h_config_scroll_margin =====
25823 <HTML>
25824 <HEAD>
25825 <TITLE>OPTION: <!--#echo var="VAR_scroll-margin"--></TITLE>
25826 </HEAD>
25827 <BODY>
25828 <H1>OPTION: <!--#echo var="VAR_scroll-margin"--></H1>
25829
25830 This option controls when Alpine's line-by-line scrolling occurs.
25831 Typically, when a selected item is at the top or bottom screen edge
25832 and the UP or DOWN (and Ctrl-P or Ctrl-N) keys are struck, the
25833 displayed items are scrolled down or up by a single line.
25834
25835 <P>
25836 This option allows you to tell Alpine the number of lines from the top and
25837 bottom screen edge that line-by-line paging should occcur.  For example,
25838 setting this value to one (1) will cause Alpine to scroll the display
25839 vertically when you move to select an item on the display's top or
25840 bottom edge.
25841
25842 <P>
25843 By default, this variable is zero, indicating that scrolling happens
25844 when you move up or down to select an item immediately off the display's
25845 top or bottom edge.
25846
25847 <P>
25848 <UL>
25849 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25850 </UL><P>
25851 &lt;End of help on this topic&gt;
25852 </BODY>
25853 </HTML>
25854 ====== h_config_wordseps =====
25855 <HTML>
25856 <HEAD>
25857 <TITLE>OPTION: <!--#echo var="VAR_composer-word-separators"--></TITLE>
25858 </HEAD>
25859 <BODY>
25860 <H1>OPTION: <!--#echo var="VAR_composer-word-separators"--></H1>
25861
25862 This option affects how a &quot;word&quot; is defined in the composer.
25863 The definition of a word is used when using the Forward Word and Backward
25864 Word commands in the composer, as well as when using the spell checker.
25865 Whitespace is always considered a word separator.
25866 Punctuation (like question marks, periods, commas, and so on) is always
25867 a word separator if it comes at the end of a word.
25868 By default, a punctuation character that is in the middle of a word does
25869 not break up that word as long as the character before and the character
25870 after it are both alphanumeric.
25871 If you add a character to this option it will be considered a
25872 word separator even when it occurs in the middle of an alphanumeric word.
25873 For example, if you want to skip through each part of an address instead
25874 of skipping the whole address at once you might want to include &quot;@&quot;
25875 and &quot;.&quot; in this list.
25876 If you want the word-skipper to stop on each part of a UNIX filename you
25877 could add &quot;/&quot; to the list.
25878 The equal sign and dash are other possibilities you might find helpful.
25879 <P>
25880 <UL>
25881 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25882 </UL><P>
25883 &lt;End of help on this topic&gt;
25884 </BODY>
25885 </HTML>
25886 ====== h_config_reply_indent_string =====
25887 <HTML>
25888 <HEAD>
25889 <TITLE>OPTION: <!--#echo var="VAR_reply-indent-string"--></TITLE>
25890 </HEAD>
25891 <BODY>
25892 <H1>OPTION: <!--#echo var="VAR_reply-indent-string"--></H1>
25893
25894 This option specifies an aspect of Alpine's Reply command.
25895 When a message is replied to and the text of the message is included, the
25896 included text usually has the string &quot;&gt;&nbsp;&quot; prepended
25897 to each line indicating it is quoted text.
25898 (In case you haven't seen this before, &quot;string&quot; is a technical term
25899 that means chunk of text.)
25900
25901 <P>
25902 Because of the introduction of <A HREF="h_config_quell_flowed_text">Flowed Text</A>
25903 in 1999 and its wide-spread adoption since then, you will usually be better off if you
25904 use one of the standard values,
25905 &quot;&gt;&nbsp;&quot; or &quot;&gt;&quot;, for this option.
25906
25907 <P>
25908 This option specifies a different value for that string.
25909 If you wish to use a string that begins or ends with a space,
25910 enclose the string in double quotes.
25911
25912 <P>
25913 Besides simple text, the prepended string can be based
25914 on the message being replied to.
25915 The following tokens are substituted for the message's corresponding value:
25916
25917 <DL>
25918 <DT>_FROM_</DT>
25919 <DD>This token gets replaced with the message sender's &quot;username&quot;.
25920 If the name is longer than six characters, only the first six characters are
25921 used.
25922 </DD>
25923
25924 <DT>_NICK_</DT>
25925 <DD>This token gets replaced with the nickname of the message sender's
25926 address as found in your addressbook.
25927 If no addressbook entry is found,
25928 Alpine replaces the characters &quot;_NICK_&quot; with nothing.
25929 If the nickname is longer than six characters, only the first six characters are
25930 used.
25931 </DD>
25932
25933 <DT>_INIT_</DT>
25934 <DD>This token gets replaced with the initials of the sender of the message.
25935 </DD>
25936
25937 </DL>
25938
25939 NOTE: When the
25940 <A HREF="h_config_prefix_editing">&quot;<!--#echo var="FEAT_enable-reply-indent-string-editing"-->&quot;</A>
25941 feature is enabled, you are given the opportunity to edit the string, whether
25942 it is the default or one automatically generated using the above tokens.
25943 <P>
25944 If you change your <!--#echo var="VAR_reply-indent-string"-->
25945 so that it is not equal to the default value of &quot;&gt;&nbsp;&quot;, then
25946 quoted text will not be flowed
25947 (<A HREF="h_config_quell_flowed_text">Flowed Text</A>)
25948 when you reply.
25949 For this reason, we recommend that you leave your <!--#echo var="VAR_reply-indent-string"-->
25950 set to the default value.
25951 <P>
25952 <UL>
25953 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25954 </UL><P>
25955 &lt;End of help on this topic&gt;
25956 </BODY>
25957 </HTML>
25958 ====== h_config_quote_replace_string =====
25959 <HTML>
25960 <HEAD>
25961 <TITLE>OPTION: <!--#echo var="VAR_quote-replace-string"--></TITLE>
25962 </HEAD>
25963 <BODY>
25964 <H1>OPTION: <!--#echo var="VAR_quote-replace-string"--></H1>
25965
25966 This option specifies what string to use as a quote when <b>viewing</b> a
25967 message.  The standard way of quoting messages when replying is the string
25968 &quot;&gt;&nbsp;&quot; (quote space).
25969 With this variable set, viewing a message will
25970 replace occurrences of
25971 &quot;&gt;&nbsp;&quot; and &quot;&gt;&quot; with the replacement string.
25972 This setting works best when
25973 <A HREF="h_config_reply_indent_string"><!--#echo var="VAR_reply-indent-string"--></A>
25974 or the equivalent setting in your correspondents' mail programs
25975 is set to the default
25976 &quot;&gt;&nbsp;&quot;, but it will also work fine with the
25977 <!--#echo var="VAR_reply-indent-string"--> set to &quot;&gt;&quot;.
25978 <P>
25979 By default, this setting will only work on messages that are flowed, which is
25980 the default way of sending messages for many mail clients including
25981 Alpine.  Enable the feature
25982 <A HREF="h_config_quote_replace_noflow"><!--#echo var="FEAT_quote-replace-nonflowed"--></A>
25983 to also have quote-replacement performed on non-flowed messages.
25984 <P>
25985
25986 Setting this option will replace  &quot;&gt;&quot; and
25987 &quot;&gt;&nbsp;&quot; with the new setting. This string may include trailing
25988 spaces. To preserve those spaces enclose the full string in double quotes.
25989 <P>
25990 No padding to separate the text of the message from the quote string is
25991 added. This means that if you do not add trailing spaces to the value of
25992 this variable, text will be displayed right next to the quote string,
25993 which may be undesirable. This can be avoided by adding a new string
25994 separated by a space from your selection of quote string replacement. This
25995 last string will be used for padding. For example, setting this variable to
25996 <br>&quot;&gt;&quot; &quot; &quot; has the effect of setting
25997 &quot;&gt;&quot; as the <!--#echo var="VAR_quote-replace-string"-->, with the text padded by
25998 a space from the last quote string to make it more readable.
25999 <P>
26000 One possible setting for this variable could be
26001 &quot;&nbsp;&nbsp;&nbsp;&nbsp;&quot; (four spaces wrapped in quotes), which
26002 would have the effect of indenting each level of quoting four spaces and
26003 removing the &quot;&gt;&quot;'s.  Different levels of quoting could be made
26004 more discernible by setting colors for quoted text.
26005 <P>
26006 Replying to or forwarding the viewed message will preserve the original
26007 formatting of the message, so quote-replacement will not be performed on
26008 messages that are being composed.
26009 <P>
26010 <UL>
26011 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26012 </UL><P>
26013 &lt;End of help on this topic&gt;
26014 </BODY>
26015 </HTML>
26016 ====== h_config_empty_hdr_msg =====
26017 <HTML>
26018 <HEAD>
26019 <TITLE>OPTION: <!--#echo var="VAR_empty-header-message"--></TITLE>
26020 </HEAD>
26021 <BODY>
26022 <H1>OPTION: <!--#echo var="VAR_empty-header-message"--></H1>
26023
26024 When sending, if both the To and Cc fields are empty and you
26025 are sending the message to a Bcc,
26026 Alpine will put a special address in the To line.  The default value is:
26027
26028 <P>
26029 <CENTER><SAMP>undisclosed-recipients:&nbsp;;</SAMP></CENTER>
26030
26031 <P>
26032 The reason for this is to avoid embarrassment caused by some Internet
26033 mail transfer software that interprets a &quot;missing&quot;
26034 <SAMP>To:</SAMP> header as an error and replaces it with an
26035 <SAMP>Apparently-to:</SAMP> header that may contain the addresses you
26036 entered on the <SAMP>Bcc:</SAMP> line, defeating the purpose of the
26037 Bcc.  You may change the part of this message that comes before the
26038 &quot;:&nbsp;;&quot; by setting the &quot;<!--#echo var="VAR_empty-header-message"-->&quot;
26039 variable to something else.
26040
26041 <P>
26042 The normal default is &quot;undisclosed-recipients&quot;.
26043
26044 <P>
26045 <UL>
26046 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26047 </UL><P>
26048 &lt;End of help on this topic&gt;
26049 </BODY>
26050 </HTML>
26051 ====== h_config_status_msg_delay =====
26052 <HTML>
26053 <HEAD>
26054 <TITLE>OPTION: <!--#echo var="VAR_status-message-delay"--></TITLE>
26055 </HEAD>
26056 <BODY>
26057 <H1>OPTION: <!--#echo var="VAR_status-message-delay"--></H1>
26058
26059 This option has evolved over time, causing the possible values to be
26060 counter-intuitive.
26061 Read carefully before you set this option.
26062 First we explain what the option does, then there is a longer discussion
26063 following that.
26064 <P>
26065 If this is set to zero, the default value, it has <EM>no</EM> effect.
26066 Positive and negative values serve two similar, but different purposes.
26067 <P>
26068 If it is set to a positive number, it causes the cursor to move to the
26069 status line whenever a status message is printed and pause there for this
26070 many seconds.
26071 It will probably only be useful if the
26072 <A HREF="h_config_show_cursor">&quot;<!--#echo var="FEAT_show-cursor"-->&quot;</A> feature is
26073 also turned on.
26074 Setting this option to a positive number can only be used to
26075 <EM>increase</EM> the status message delay.
26076 This may be useful for Braille displays, or other non-traditional displays.
26077 <P>
26078 If it is set to a negative number the interpretation is a bit complicated.
26079 Negative numbers are used to <EM>decrease</EM> the amount of delay Alpine uses to
26080 allow you to read important status messages.
26081 Of course, this may cause you to miss some important messages.
26082 If you see a message flash by but miss what it says you can use the
26083 Journal command from the MAIN MENU to read it.
26084 If you set this option to a negative value, the delay will be
26085 no more than one second less than the absolute value
26086 of the value you set.
26087 So if you set it to -1, the delay will be no more than zero seconds, no
26088 delay at all.
26089 If you set it to -2, the delay will be no more than 1 second.
26090 And so on, -3 is 2 seconds, -4 is 3 seconds, ...
26091 If the delay that Alpine would have used by default is less than this delay,
26092 then the smaller delay set by Alpine will be used.
26093 Setting this option to a negative value can only reduce the amount of
26094 delay, never increase it.
26095 <P>
26096 Here is a more detailed explanation.
26097 Status messages are the messages that show up spontaneously in the
26098 status message line, usually the third line from the bottom of the screen.
26099 By default, Alpine assigns each status message it produces a minimum
26100 display time.
26101 Some status messages have a minimum display time of zero.
26102 You can see an example of such a message by paging up in this help text
26103 until you reach the top of the screen.
26104 If you try to page past the top you will see the message
26105 <P>
26106 <CENTER><SAMP>[Already at start of help text]</SAMP></CENTER>
26107 <P>
26108 in the status line.
26109 If there is another more important use of the status message line this message
26110 might be replaced quickly, or it even might not be shown at all.
26111 However, if there is no reason to get rid of the message, it might stay
26112 there for several seconds while you read the help.
26113 An example where it is replaced immediately happens when you page up in
26114 the help text past the top of the screen, but then type the &quot;WhereIs&quot;
26115 command right after paging up.
26116 The message will disappear immediately without causing a delay (unless you
26117 have set this option to a positive value) to allow you to type input for
26118 the &quot;WhereIs&quot; command.
26119 Since it isn't a very important message, Alpine has set its minimum display
26120 time to zero seconds.
26121 <P>
26122 Other messages have minimum display times of three or more seconds.
26123 These are usually error messages that Alpine thinks you ought to see.
26124 For example, it might be a message about a failed Save or a failed folder open.
26125 It is often the case that this minimum display time won't delay you in
26126 any way because the status message line is not needed for another reason.
26127 However, there are times when Alpine has to delay what it is doing in
26128 order to display a status message for the minimum display time.
26129 This happens when a message is being displayed and Alpine wants to ask
26130 for input from the keyboard.
26131 For example, when you Save a message you use the status message line.
26132 You get a prompt there asking for the name of the folder to save to.
26133 If there is a status message being displayed that has not
26134 yet displayed for its minimum
26135 time Alpine will display that status message surrounded with the characters
26136 &gt; and &lt; to show you that it is delaying.
26137 That might happen, for example, if you tried to save to a folder that
26138 caused an error, then followed that immediately with another Save command.
26139 You might find yourself waiting for a status message like
26140 <P>
26141 <CENTER><SAMP>[&gt;Can't get write access to mailbox, access is readonly&lt;]</SAMP></CENTER>
26142 <P>
26143 to finish displaying for three seconds.
26144 If that is something you find happening to you frequently, you may use
26145 negative values of this option to decrease or eliminate that delay, at
26146 the risk of missing the message.
26147 <P>
26148 <UL>
26149 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26150 </UL><P>
26151 &lt;End of help on this topic&gt;
26152 </BODY>
26153 </HTML>
26154 ====== h_config_active_msg_interval =====
26155 <HTML>
26156 <HEAD>
26157 <TITLE>OPTION: <!--#echo var="VAR_busy-cue-rate"--></TITLE>
26158 </HEAD>
26159 <BODY>
26160 <H1>OPTION: <!--#echo var="VAR_busy-cue-rate"--></H1>
26161
26162 When Alpine is delayed for some reason it usually shows that
26163 something is happening with a small animated display in the status
26164 message line near the bottom of the screen.
26165 This option sets how frequently the characters (for example, a spinning bar)
26166 in the active status message lines are updated.
26167 At most, it can be set to be udpated 20 times per second.
26168
26169 <P>
26170 Setting this value to zero will prevent display of the animations
26171 altogether.
26172
26173 <P>
26174 The option <A HREF="h_config_use_boring_spinner"><!--#echo var="FEAT_busy-cue-spinner-only"--></A>
26175 can be used to remove the randomness from this animated display.
26176
26177 <P>
26178 <UL>
26179 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26180 </UL><P>
26181 &lt;End of help on this topic&gt;
26182 </BODY>
26183 </HTML>
26184 ====== h_config_mailchecknoncurr =====
26185 <HTML>
26186 <HEADER>
26187 <TITLE>OPTION: <!--#echo var="VAR_mail-check-interval-noncurrent"--></TITLE>
26188 </HEADER>
26189 <BODY>
26190 <H1>OPTION: <!--#echo var="VAR_mail-check-interval-noncurrent"--></H1>
26191
26192 This option is closely related to the
26193 <A HREF="h_config_mailcheck">&quot;<!--#echo var="VAR_mail-check-interval"-->&quot;</A>
26194 option, as well as the
26195 <A HREF="h_config_quell_checks_comp">&quot;<!--#echo var="FEAT_quell-mailchecks-composing-except-inbox"-->&quot;</A> and
26196 <A HREF="h_config_quell_checks_comp_inbox">&quot;<!--#echo var="FEAT_quell-mailchecks-composing-inbox"-->&quot;</A> options.
26197 If the &quot;<!--#echo var="VAR_mail-check-interval"-->&quot; option is set to zero, then automatic
26198 new-mail checking is disabled and this option will have no effect.
26199 <P>
26200 Normally this option is set to zero, which means that the value used will be
26201 the same as the value for the &quot;<!--#echo var="VAR_mail-check-interval"-->&quot;.
26202 If you set this option to a value different from zero
26203 (usually larger than the value for &quot;<!--#echo var="VAR_mail-check-interval"-->&quot;)
26204 then that is the check interval that will be used
26205 for folders that are not the currently open folder or the INBOX.
26206 You may not even have any folders that are noncurrent and not the INBOX.
26207 If you do, it is likely that they are due to
26208 <A HREF="h_config_permlocked">&quot;<!--#echo var="VAR_stay-open-folders"-->&quot;</A>
26209 you have configured.
26210 This option also affects the rate of mail checking done on cached
26211 connections to folders you previously had open but are no longer actively
26212 using.
26213 You aren't expected to understand that last sentence, but if you are interested
26214 take a look at
26215 <A HREF="h_config_maxremstream">&quot;<!--#echo var="VAR_max-remote-connections"-->&quot;</A>
26216 and the related options.
26217 <P>
26218 <UL>
26219 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26220 </UL><P>
26221 &lt;End of help on this topic&gt;
26222 </BODY>
26223 </HTML>
26224 ====== h_config_fifopath =====
26225 <HTML>
26226 <HEADER>
26227 <TITLE>OPTION: NewMail FIFO Path</TITLE>
26228 </HEADER>
26229 <BODY>
26230 <H1>OPTION: NewMail FIFO Path</H1>
26231
26232 This option is only available in UNIX Alpine.
26233 However, there is a very similar feature built in to PC-Alpine.
26234 In PC-Alpine's Config menu at the top of the screen
26235 is an option called &quot;New Mail Window&quot;.
26236 <P>
26237 You may have Alpine create a FIFO special file (also called a named pipe) where
26238 it will send a one-line message each time a new message is received in
26239 the current folder, the INBOX, or any open
26240 <A HREF="h_config_permlocked"><!--#echo var="VAR_stay-open-folders"--></A>.
26241 To protect against two different Alpines both writing to the same FIFO, Alpine
26242 will only create the FIFO and write to it if it doesn't already exist.
26243 <P>
26244 A possible way to use this option would be to have a separate window
26245 on your screen running the command
26246 <P>
26247 <CENTER><SAMP>cat filename</SAMP></CENTER>
26248 <P>
26249 where &quot;filename&quot; is the name of the file given for this option.
26250 Because the file won't exist until after you start Alpine, you must <EM>first</EM>
26251 start Alpine and <EM>then</EM> run the &quot;cat&quot; command.
26252 You may be tempted to use &quot;tail -f filename&quot; to view the new
26253 mail log.
26254 However, the common implementations of the tail command will not do what you
26255 are hoping.
26256 <P>
26257 The width of the messages produced for the FIFO may be altered with the
26258 <A HREF="h_config_newmailwidth"><!--#echo var="VAR_newmail-window-width"--></A> option.
26259 <P>
26260 On some systems, fifos may only be created in a local filesystem.
26261 In other words, they may not be in NFS filesystems.
26262 This requirement is not universal.
26263 If the system you are using supports it, it should work.
26264 (It is often the case that your home directory is in an NFS filesystem.
26265 If that is the case, you might try using a file in the &quot;/tmp&quot;
26266 filesystem, which is usually a local filesytem.)
26267 Even when it is possible to use an NFS-mounted filesystem as a place to name
26268 the fifo (for example, your home directory), it will still be the case that
26269 the reader (probably the &quot;cat&quot; command) and the
26270 writer (Alpine) of the fifo must be running on the same system.
26271 <P>
26272 <UL>
26273 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26274 </UL><P>
26275 &lt;End of help on this topic&gt;
26276 </BODY>
26277 </HTML>
26278 ====== h_config_newmailwidth =====
26279 <HTML>
26280 <HEADER>
26281 <TITLE>OPTION: <!--#echo var="VAR_newmail-window-width"--></TITLE>
26282 </HEADER>
26283 <BODY>
26284 <H1>OPTION: <!--#echo var="VAR_newmail-window-width"--></H1>
26285
26286 For UNIX Alpine, this option is only useful if you have turned on the
26287 <A HREF="h_config_fifopath">NewMail FIFO Path</A> option.
26288 That option causes new mail messages to be sent to a fifo file.
26289 Those messages will be 80 characters wide by default.
26290 You can change the width of those messages by changing this option.
26291 For example, if you are reading those messages in another window you might
26292 want to set this width to the width of that other window.
26293 <P>
26294 If you are using PC-Alpine, it has an option in the Config menu to turn
26295 on the &quot;New Mail Window&quot;.
26296 This present option also controls the width of that window.
26297 <P>
26298 <UL>
26299 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26300 </UL><P>
26301 &lt;End of help on this topic&gt;
26302 </BODY>
26303 </HTML>
26304 ====== h_config_mailcheck =====
26305 <HTML>
26306 <HEADER>
26307 <TITLE>OPTION: <!--#echo var="VAR_mail-check-interval"--></TITLE>
26308 </HEADER>
26309 <BODY>
26310 <H1>OPTION: <!--#echo var="VAR_mail-check-interval"--></H1>
26311
26312 This option specifies, in seconds,
26313 how often Alpine will check for new mail.
26314 If set to zero, new-mail checking is disabled.
26315 (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
26316 current message is the last message of the folder.)
26317 There is a minimum value for this option, normally 15 seconds.
26318 The default value is normally 150 seconds.
26319 The higher you set this option, the easier it is on the server.
26320 <P>
26321 There are some situations where automatic new-mail checking does not work.
26322 See the discussion about new-mail checking in
26323 <A HREF="h_config_reopen_rule">&quot;<!--#echo var="VAR_folder-reopen-rule"-->&quot;</A>.
26324 <P>
26325 The new-mail checking will not happen exactly at the frequency that you specify.
26326 For example, Alpine may elect to defer a non-INBOX mail check if you
26327 are busy typing.
26328 Or, it may check more frequently than you have specified if that is
26329 thought to be necessary to keep the server from closing the connection
26330 to the folder due to inactivity.
26331 If Alpine checks for new mail as a side effect of another command, it will reset
26332 the timer, so that new-mail checking may seem to happen irregularly instead of
26333 every X seconds like clockwork.
26334 <P>
26335 If you are anxious to know about new mail as soon as possible, set the check
26336 interval low, and you'll know about the new mail by approximately
26337 that amount of time after it arrives.
26338 If you aren't so worried about knowing right away, set this option to a
26339 higher value.
26340 That will save the server some processing time and may save you some of
26341 the time you spend waiting for new-mail checks to happen if you are
26342 dealing with a slow server or slow network connection.
26343 <P>
26344 If you suspect that new-mail checking is causing slow downs for you,
26345 you may want to look into the options
26346 <A HREF="h_config_quell_checks_comp">&quot;<!--#echo var="FEAT_quell-mailchecks-composing-except-inbox"-->&quot;</A>,
26347 <A HREF="h_config_quell_checks_comp_inbox">&quot;<!--#echo var="FEAT_quell-mailchecks-composing-inbox"-->&quot;</A> and
26348 <A HREF="h_config_mailchecknoncurr">&quot;<!--#echo var="VAR_mail-check-interval-noncurrent"-->&quot;</A>,
26349 which refine when mail checking is done.
26350 <P>
26351 If the mailbox being checked uses a <A HREF="h_maildrop">Mail Drop</A> then
26352 there is a minimum time
26353 (<A HREF="h_config_maildropcheck">&quot;<!--#echo var="VAR_maildrop-check-minimum"-->&quot;</A>)
26354 between new-mail checks.
26355 Because of this minimum you may notice that new mail does not
26356 appear promptly when you expect it.
26357 The reason for this is to protect the server from over-zealous opening and
26358 closing of the Mail Drop folder, since that is a costly operation.
26359 <P>
26360 <UL>
26361 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26362 </UL><P>
26363 &lt;End of help on this topic&gt;
26364 </BODY>
26365 </HTML>
26366 ====== h_config_quell_checks_comp =====
26367 <HTML>
26368 <HEAD>
26369 <TITLE>FEATURE: <!--#echo var="FEAT_quell-mailchecks-composing-except-inbox"--></TITLE>
26370 </HEAD>
26371 <BODY>
26372 <H1>FEATURE: <!--#echo var="FEAT_quell-mailchecks-composing-except-inbox"--></H1>
26373
26374 This option is closely related to the
26375 <A HREF="h_config_mailcheck">&quot;<!--#echo var="VAR_mail-check-interval"-->&quot;</A>
26376 option, the
26377 <A HREF="h_config_mailchecknoncurr">&quot;<!--#echo var="VAR_mail-check-interval-noncurrent"-->&quot;</A> option, and
26378 <A HREF="h_config_quell_checks_comp_inbox">&quot;<!--#echo var="FEAT_quell-mailchecks-composing-inbox"-->&quot;</A>.
26379 <P>
26380 If this option is set, then the normal new-mail checking that happens
26381 while you are composing will not happen for folders other than your
26382 INBOX (which depends on the setting
26383 of &quot;<!--#echo var="FEAT_quell-mailchecks-composing-inbox"-->&quot;).
26384 <P>
26385 You might want to set this option if you are experiencing delays while
26386 composing that you think might be related to the speed of the new-mail
26387 checks.
26388 <P>
26389 Even with this option turned on, an occasional new-mail check may be done
26390 in order to keep the server from killing the connection to the folder.
26391 For example, IMAP servers may remove a connection to a folder if there
26392 has been no activity on the connection for 30 minutes or more.
26393 Instead of letting that happen, Alpine will check for new mail before the
26394 30 minutes is up even though you have turned on this feature to quell
26395 those checks.
26396 <P>
26397 Besides new-mail checks, checkpoint operations on the folders
26398 will also be quelled when you set this option.
26399 The purpose of checkpointing is to write the changes to a folder out to
26400 disk periodically in order to avoid losing those changes when system or
26401 software problems occur.
26402 New-mail checking and checkpointing while you are not composing are not
26403 affected by this option.
26404
26405 <P>
26406 &lt;End of help on this topic&gt;
26407 </BODY>
26408 </HTML>
26409 ====== h_config_quell_checks_comp_inbox =====
26410 <HTML>
26411 <HEAD>
26412 <TITLE>FEATURE: <!--#echo var="FEAT_quell-mailchecks-composing-inbox"--></TITLE>
26413 </HEAD>
26414 <BODY>
26415 <H1>FEATURE: <!--#echo var="FEAT_quell-mailchecks-composing-inbox"--></H1>
26416
26417 This option is closely related to the
26418 <A HREF="h_config_mailcheck">&quot;<!--#echo var="VAR_mail-check-interval"-->&quot;</A>
26419 option, the
26420 <A HREF="h_config_mailchecknoncurr">&quot;<!--#echo var="VAR_mail-check-interval-noncurrent"-->&quot;</A> option, and
26421 <A HREF="h_config_quell_checks_comp">&quot;<!--#echo var="FEAT_quell-mailchecks-composing-except-inbox"-->&quot;</A>.
26422 <P>
26423 If this option is set, then the normal new-mail checking that happens
26424 while you are composing will not happen for your INBOX.
26425 Checking of other folders is controlled in a similar way with the
26426 &quot;<!--#echo var="FEAT_quell-mailchecks-composing-except-inbox"-->&quot; option.
26427 <P>
26428 You might want to set this option if you are experiencing delays while
26429 composing that you think might be related to the speed of the new-mail
26430 checks.
26431 <P>
26432 Even with this option turned on, an occasional new-mail check may be done
26433 in order to keep the server from killing the connection to the folder.
26434 For example, IMAP servers may remove a connection to a folder if there
26435 has been no activity on the connection for 30 minutes or more.
26436 Instead of letting that happen, Alpine will check for new mail before the
26437 30 minutes is up even though you have turned on this feature to quell
26438 those checks.
26439 <P>
26440 Besides new-mail checks, checkpoint operations on the INBOX
26441 will also be quelled when you set this option.
26442 The purpose of checkpointing is to write the changes to a folder out to
26443 disk periodically in order to avoid losing those changes when system or
26444 software problems occur.
26445 New-mail checking and checkpointing while you are not composing are not
26446 affected by this option.
26447 <P>
26448 &lt;End of help on this topic&gt;
26449 </BODY>
26450 </HTML>
26451 ====== h_config_maildropcheck =====
26452 <HTML>
26453 <HEADER>
26454 <TITLE>OPTION: <!--#echo var="VAR_maildrop-check-minimum"--></TITLE>
26455 </HEADER>
26456 <BODY>
26457 <H1>OPTION: <!--#echo var="VAR_maildrop-check-minimum"--></H1>
26458
26459 New-mail checking for a
26460 <A HREF="h_maildrop">Mail Drop</A> is a little different from new
26461 mail checking for a regular folder.
26462 One of the differences is that the connection to the Mail Drop is not
26463 kept open and so the cost of checking
26464 (delay for you and additional load for the server) may be significant.
26465 Because of this additional cost we set a minimum time that
26466 must pass between checks.
26467 This minimum only applies to the automatic checking done by Alpine.
26468 If you force a check by typing ^L (Ctrl-L) or by typing the Next command when you are
26469 at the end of a folder index, then the check is done right away.
26470 <P>
26471 This option specifies, in seconds, the <EM>minimum</EM> time between Mail Drop
26472 new-mail checks.
26473 You may want to set this minimum high in order to avoid experiencing some
26474 of the delays associated with the checks.
26475 Note that the time between checks is still controlled by the regular
26476 <A HREF="h_config_mailcheck"><!--#echo var="VAR_mail-check-interval"--></A> option.
26477 When Alpine is about to do an automatic check for new mail (because
26478 the <!--#echo var="VAR_mail-check-interval"--> has expired) then if the time since the last
26479 new-mail check
26480 of any open Mail Drops has been greater than the <!--#echo var="VAR_maildrop-check-minimum"-->,
26481 the Mail Drop is checked for new mail as well.
26482 Therefore, it is only useful to set this option to a value that is higher
26483 than the <!--#echo var="VAR_mail-check-interval"-->.
26484 <P>
26485 If this option is set to zero, automatic Mail Drop new-mail
26486 checking is disabled.
26487 There is a minimum value, normally 60 seconds.
26488 The default value is normally 60 seconds as well.
26489 This applies to the INBOX and to the currently open folder if that is
26490 different from the INBOX.
26491
26492 <P>
26493 <UL>
26494 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26495 </UL><P>
26496 &lt;End of help on this topic&gt;
26497 </BODY>
26498 </HTML>
26499 ====== h_config_nntprange =====
26500 <HTML>
26501 <HEADER>
26502 <TITLE>OPTION: <!--#echo var="VAR_nntp-range"--></TITLE>
26503 </HEADER>
26504 <BODY>
26505 <H1>OPTION: <!--#echo var="VAR_nntp-range"--></H1>
26506
26507 This option applies only to newsgroups accessed using the NNTP protocol.
26508 It does not, for example,
26509 apply to newsgroups accessed using an IMAP-to-NNTP proxy.
26510
26511 <P>
26512 When you open a connection to a News server using the NNTP protocol, you
26513 normally have access to all of the articles in each newsgroup.
26514 If a server keeps a large backlog of messages it may speed performance
26515 some to restrict attention to only the newer messages in a group.
26516 This option allows you to set how many article numbers should be checked
26517 when opening a newsgroup.
26518 You can think of &quot;<!--#echo var="VAR_nntp-range"-->&quot; as specifying the maximum number
26519 of messages you ever want to see.
26520 For example, if you only ever wanted to look at the last 500 messages in each
26521 newsgroup you could set this option to 500.
26522 In actuality, it isn't quite that.
26523 Instead, for performance reasons, it specifies the range of article
26524 numbers to be checked, beginning
26525 with the highest numbered article and going backwards from there.
26526 If there are messages that have been canceled or deleted
26527 their article numbers are still counted as part of the range.
26528 <P>
26529 So, more precisely, setting the &quot;<!--#echo var="VAR_nntp-range"-->&quot; will cause article
26530 numbers
26531 <P><CENTER>last_article_number - <!--#echo var="VAR_nntp-range"--> + 1 through last_article_number</CENTER>
26532 <P>
26533 to be considered when reading a newsgroup.
26534 The number of messages that show up in your index will be less than or equal
26535 to the value of &quot;<!--#echo var="VAR_nntp-range"-->&quot;.
26536
26537 <P>
26538 The purpose of this option is simply to speed up access when reading news.
26539 The speedup comes because Alpine can ignore all but the last <!--#echo var="VAR_nntp-range"--> article
26540 numbers, and can avoid downloading any information about the ignored articles.
26541 There is a cost you pay for this speedup.
26542 That cost is that there is no way for you to see those ignored articles.
26543 The articles that come before the range you specify are invisible to you and
26544 to Alpine, as if they did not exist at all.
26545 There is no way to see those messages using, for example, an unexclude command
26546 or something similar.
26547 The only way to see those articles is to set this option high enough (or
26548 set it to zero) and then to reopen the newsgroup.
26549
26550 <P>
26551 If this option is set to 0 (which is also the default),
26552 then the range is unlimited.
26553 This option applies globally to all NNTP servers and to all newsgroups
26554 on those servers.
26555 There is no way to set different values for different newsgroups or servers.
26556
26557 <P>
26558 <UL>
26559 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26560 </UL><P>
26561 &lt;End of help on this topic&gt;
26562 </BODY>
26563 </HTML>
26564 ====== h_config_news_active =====
26565 <html>
26566 <header>
26567 <title>OPTION: <!--#echo var="VAR_news-active-file-path"--></title>
26568 </header>
26569 <body>
26570 <h1>OPTION: <!--#echo var="VAR_news-active-file-path"--></h1>
26571
26572 This option tells Alpine where to look for the "active file" for newsgroups
26573 when accessing news locally, rather than via NNTP.  The default path is
26574 usually "/usr/lib/news/active".<p>
26575 <UL>
26576 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26577 </UL><P>
26578 &lt;End of help on this topic&gt;
26579 </body>
26580 </html>
26581 ====== h_config_news_spool =====
26582 <html>
26583 <header>
26584 <title>OPTION: <!--#echo var="VAR_news-spool-directory"--></title>
26585 </header>
26586 <body>
26587 <h1>OPTION: <!--#echo var="VAR_news-spool-directory"--></h1>
26588
26589 This option tells Alpine where to look for the "news spool" for newsgroups
26590 when accessing news locally, rather than via NNTP.  The default path is
26591 usually "/var/spool/news".<p>
26592 <UL>
26593 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26594 </UL><P>
26595 &lt;End of help on this topic&gt;
26596 </body>
26597 </html>
26598 ====== h_config_image_viewer =====
26599 <html>
26600 <header>
26601 <title>OPTION: <!--#echo var="VAR_image-viewer"--></title>
26602 </header>
26603 <body>
26604 <h1>OPTION: <!--#echo var="VAR_image-viewer"--></h1>
26605 <body>
26606 This option specifies the program Alpine should call to view MIME
26607 attachments of type IMAGE (e.g. GIF or TIFF).  The Image Viewer setting is
26608 no longer needed, but remains for backward compatibility.  The more
26609 general method for associating external printing and viewing programs with
26610 specific MIME data types is to use the system's (or your personal)
26611 "mailcap" configuration file.<p>
26612 <UL>
26613 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26614 </UL><P>
26615 &lt;End of help on this topic&gt;
26616 </body>
26617 </html>
26618 ====== h_config_domain_name =====
26619 <HTML>
26620 <HEAD>
26621 <TITLE>OPTION: <!--#echo var="VAR_use-only-domain-name"--></TITLE>
26622 </HEAD>
26623 <BODY>
26624 <H1>OPTION: <!--#echo var="VAR_use-only-domain-name"--></H1>
26625
26626 This option is used only if the
26627 <A HREF="h_config_user_dom">&quot;<!--#echo var="VAR_user-domain"-->&quot;</A> option is <B>not</B>
26628 set.  If set to &quot;Yes&quot; (and <!--#echo var="VAR_user-domain"--> is not used), then Alpine
26629 strips the hostname from your return (&quot;From&quot;) address and when
26630 completing unqualified addresses that you enter into the composer.
26631 <P>
26632 If you set this, see also the <A HREF="h_config_quell_local_lookup">
26633 &quot;<!--#echo var="FEAT_quell-user-lookup-in-passwd-file"-->&quot;</A> feature.
26634
26635
26636 <!--chtml if pinemode="os_windows"-->
26637 <P>This option is not applicable to PC-Alpine.
26638 <!--chtml else-->
26639 <P>
26640 <!--chtml endif-->
26641 <UL>
26642 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26643 </UL>
26644 <P>
26645 &lt;End of help on this topic&gt;
26646 </BODY>
26647 </HTML>
26648 ====== h_config_prune_date =====
26649 <HTML>
26650 <HEAD>
26651 <TITLE>OPTION: Last-Time-Prune Question</TITLE>
26652 </HEAD>
26653 <BODY>
26654 <H1>OPTION: Last-Time-Prune Question</H1>
26655
26656 This value records the last time you were asked about deleting old
26657 sent-mail.
26658 It is set automatically by Alpine at the beginning of each month.
26659 In the past, if you wished to suppress the monthly sent-mail
26660 pruning feature, you could set this to a date in the future.
26661 This value is relative to the year 1900, so
26662 to set this, for example, to October 2005, use 105.10.
26663 <P>
26664 You can still do that if you wish, or you can use the
26665 <A HREF="h_config_pruning_rule"><!--#echo var="VAR_pruning-rule"--></A> option, which is probably
26666 a little more convenient to use.
26667 <P>
26668 <UL>
26669 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26670 </UL><P>
26671 &lt;End of help on this topic&gt;
26672 </BODY>
26673 </HTML>
26674 ====== h_config_goto_default =====
26675 <HTML>
26676 <HEAD>
26677 <TITLE>OPTION: <!--#echo var="VAR_goto-default-rule"--></TITLE>
26678 </HEAD>
26679 <BODY>
26680 <H1>OPTION: <!--#echo var="VAR_goto-default-rule"--></H1>
26681
26682 This value affects Alpine's behavior when you use the Goto command.
26683 Alpine's usual behavior has two parts.  If your current folder is
26684 &quot;Inbox&quot;, Alpine will offer the last open folder as the
26685 default.  If the current folder is other than &quot;Inbox&quot;,
26686 &quot;Inbox&quot; is offered as the default.
26687
26688 <P>
26689 The available options include:
26690
26691 <DL>
26692
26693  <DT>folder-in-first-collection</DT>
26694
26695  <DD> Alpine will offer the most recently visited folder in the default
26696 collection found in the &quot;Collection List&quot; screen as the default.
26697 </DD>
26698
26699  <DT> inbox-or-folder-in-first-collection</DT>
26700
26701  <DD> If the current folder is &quot;Inbox&quot;,
26702 Alpine will offer the most recently visited folder in the
26703 default collection found in the &quot;Collection List&quot; screen.
26704 If the current folder is other than &quot;Inbox&quot;,
26705 &quot;Inbox&quot; is offered as the default.
26706 </DD>
26707
26708  <DT> inbox-or-folder-in-recent-collection</DT>
26709
26710  <DD> This is Alpine's default behavior.
26711 If the current folder is &quot;Inbox&quot;,
26712 Alpine will offer the last open
26713 folder as the default.
26714 If the current folder is other than &quot;Inbox&quot;,
26715 &quot;Inbox&quot; is offered as the default.
26716 </DD>
26717
26718  <DT> first-collection-with-inbox-default</DT>
26719
26720  <DD> Instead of offering the most recently visited folder in the default
26721 collection, the default collection is offered but with &quot;Inbox&quot; as
26722 the default folder.
26723 If you type in a folder name it will be in the default collection.
26724 If you simply accept the default, however, your &quot;Inbox&quot; will be opened.
26725 </DD>
26726
26727  <DT> most-recent-folder</DT>
26728
26729  <DD> The last accepted value simply causes the most recently opened
26730 folder to be offered as the default regardless of the currently opened
26731 folder.
26732 </DD>
26733 </DL>
26734
26735 <P>
26736 NOTE: The default while a newsgroup is open remains the same; the last
26737 open newsgroup.
26738
26739 <P>
26740 <UL>
26741 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26742 </UL><P>
26743 &lt;End of help on this topic&gt;
26744 </BODY>
26745 </HTML>
26746 ====== h_config_thread_lastreply_char =====
26747 <HTML>
26748 <HEAD>
26749 <TITLE>OPTION: <!--#echo var="VAR_threading-lastreply-character"--></TITLE>
26750 </HEAD>
26751 <BODY>
26752 <H1>OPTION: <!--#echo var="VAR_threading-lastreply-character"--></H1>
26753
26754 The <!--#echo var="VAR_threading-lastreply-character"--> option has a small effect on the MESSAGE
26755 INDEX display when using a
26756 <A HREF="h_config_thread_disp_style"><!--#echo var="VAR_threading-display-style"--></A>
26757 of &quot;show-thread-structure&quot;, &quot;mutt-like&quot;, or
26758 &quot;show-structure-in-from&quot;; and sorting by Threads or OrderedSubject.
26759 The value of this option is a single character.
26760 This character is used instead of the vertical line character when there are
26761 no more replies directly to the parent of the current message.
26762 It can be used to &quot;round-off&quot; the bottom of the vertical line
26763 by setting it to a character such as a backslash (&#92;) or
26764 a backquote (&#96;).
26765 The default value of this option is the backslash character (&#92;).
26766 This option may not be set to the Empty Value.
26767 In that case, the default will be used instead.
26768
26769 <P>
26770 <UL>
26771 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26772 </UL><P>
26773 &lt;End of help on this topic&gt;
26774 </BODY>
26775 </HTML>
26776 ====== h_config_thread_indicator_char =====
26777 <HTML>
26778 <HEAD>
26779 <TITLE>OPTION: <!--#echo var="VAR_threading-indicator-character"--></TITLE>
26780 </HEAD>
26781 <BODY>
26782 <H1>OPTION: <!--#echo var="VAR_threading-indicator-character"--></H1>
26783
26784 The <!--#echo var="VAR_threading-indicator-character"--> option has a small effect on the MESSAGE
26785 INDEX display when using a
26786 <A HREF="h_config_thread_disp_style"><!--#echo var="VAR_threading-display-style"--></A> other
26787 than &quot;none&quot; and sorting by Threads or OrderedSubject.
26788 The value of this option is a single character.
26789 This character is used to indicate that part of a thread (a conversation) is
26790 hidden beneath a message.
26791 The message could be expanded
26792 if desired with the &quot;/&quot; Collapse/Expand command.
26793 By default, the value of this option is the greater than sign (&gt;).
26794 <P>
26795 If this option is set to the Empty Value, then the column (and the following
26796 blank column) will be deleted from the display.
26797
26798 <P>
26799 This option is closely related to the
26800 <A HREF="h_config_thread_exp_char"><!--#echo var="VAR_threading-expanded-character"--></A> option.
26801 Another similar option that affects the thread display is the
26802 <A HREF="h_config_thread_lastreply_char"><!--#echo var="VAR_threading-lastreply-character"--></A> option.
26803
26804 <P>
26805 <UL>
26806 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26807 </UL><P>
26808 &lt;End of help on this topic&gt;
26809 </BODY>
26810 </HTML>
26811 ====== h_config_thread_exp_char =====
26812 <HTML>
26813 <HEAD>
26814 <TITLE>OPTION: <!--#echo var="VAR_threading-expanded-character"--></TITLE>
26815 </HEAD>
26816 <BODY>
26817 <H1>OPTION: <!--#echo var="VAR_threading-expanded-character"--></H1>
26818
26819 The <!--#echo var="VAR_threading-expanded-character"--> option has a small effect on the MESSAGE
26820 INDEX display when using a
26821 <A HREF="h_config_thread_disp_style"><!--#echo var="VAR_threading-display-style"--></A> other
26822 than &quot;none&quot;.
26823 The value of this option is a single character.
26824 This character is used to indicate that part of a thread has been expanded
26825 and could be collapsed if desired with
26826 the &quot;/&quot; Collapse/Expand command.
26827 By default, the value of this option is a dot (.).
26828 <P>
26829 If this option is set to the Empty Value, then the column (and the following
26830 blank column) will be deleted from the display.
26831
26832 <P>
26833 This option is closely related to the
26834 <A HREF="h_config_thread_indicator_char"><!--#echo var="VAR_threading-indicator-character"--></A> option.
26835 Another similar option that affects the thread display is the
26836 <A HREF="h_config_thread_lastreply_char"><!--#echo var="VAR_threading-lastreply-character"--></A> option.
26837
26838 <P>
26839 <UL>
26840 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26841 </UL><P>
26842 &lt;End of help on this topic&gt;
26843 </BODY>
26844 </HTML>
26845 ====== h_config_thread_index_style =====
26846 <HTML>
26847 <HEAD>
26848 <TITLE>OPTION: <!--#echo var="VAR_threading-index-style"--></TITLE>
26849 </HEAD>
26850 <BODY>
26851 <H1>OPTION: <!--#echo var="VAR_threading-index-style"--></H1>
26852
26853 When a folder is sorted by Threads or OrderedSubject,
26854 this option will affect the INDEX displays.
26855 <P>
26856
26857 The possible values for this option are:
26858
26859 <DL>
26860 <DT>regular-index-with-expanded-threads</DT>
26861 <DD>This is the default display.
26862 If the configuration option
26863 <A HREF="h_config_thread_disp_style">&quot;<!--#echo var="VAR_threading-display-style"-->&quot;</A>
26864 is set to something other than &quot;none&quot;, then this setting
26865 will cause Alpine to start off with a MESSAGE INDEX with all of
26866 the threads expanded.
26867 That is, each message will have a line in the MESSAGE INDEX display.
26868 The Collapse/Expand command (/) may be used to manually collapse or
26869 expand a thread or subthread (see also <A HREF="h_config_slash_coll_entire">&quot;<!--#echo var="FEAT_slash-collapses-entire-thread"-->&quot;</A>).
26870 <P>
26871 This setting affects the display when the folder is first threaded.
26872 The collapsed state may also be re-initialized by re-sorting the folder manually
26873 using the SortIndex command ($).
26874 After re-sorting the threads will once again all be expanded, even if you
26875 have previously collapsed some of them.
26876 <P>
26877 If &quot;<!--#echo var="VAR_threading-display-style"-->&quot; is set to &quot;none&quot;, then
26878 the display will be the regular default Alpine MESSAGE INDEX, but sorted
26879 in a different order.
26880 </DD>
26881
26882 <DT>regular-index-with-collapsed-threads</DT>
26883 <DD>If the configuration option
26884 <A HREF="h_config_thread_disp_style">&quot;<!--#echo var="VAR_threading-display-style"-->&quot;</A>
26885 is set to something other than &quot;none&quot;, then this setting
26886 will cause Alpine to start out with all of the threads collapsed instead of
26887 starting out with all of the threads expanded.
26888 The Collapse/Expand command (/) may be used to manually collapse or
26889 expand a thread or subthread (see also <A HREF="h_config_slash_coll_entire">&quot;<!--#echo var="FEAT_slash-collapses-entire-thread"-->&quot;</A>).
26890 <P>
26891 This setting affects the display when the folder is first threaded.
26892 The collapsed state may also be re-initialized by re-sorting the folder manually
26893 using the SortIndex command ($).
26894 After re-sorting the threads will once again all be collapsed, even if you
26895 have previously expanded some of them.
26896 </DD>
26897
26898 <DT>separate-index-screen-always</DT>
26899 <DD>With this setting and the next, you will see an index of threads
26900 instead of an
26901 index of messages, provided you have sorted by Threads or OrderedSubject.
26902 <P>
26903 The THREAD INDEX contains a '*' in the first column if any message in the thread
26904 is marked Important.
26905 If not, it contains a '+' if any message in the thread is to you.
26906 The second column is blank. The third column contains a 'D' if all of the
26907 messages in the thread are deleted.
26908 Otherwise, it contains an 'N' if any of the messages in the thread are New.
26909 <P>
26910 When you view a particular thread from the THREAD INDEX you will be
26911 in the MESSAGE INDEX display
26912 but the index will only contain messages from the thread you are viewing.
26913 </DD>
26914
26915 <DT>separate-index-screen-except-for-single-messages</DT>
26916 <DD>This is very similar to the option above.
26917 When you are in the THREAD INDEX, one of the available commands
26918 is &quot;ViewThd&quot;.
26919 With the setting &quot;separate-index-screen-always&quot; (the option above)
26920 when you view a particular thread you will be in the
26921 MESSAGE INDEX display and the index will only contain messages from
26922 the thread you are viewing.
26923 If the thread you are viewing consists of a single message, the MESSAGE INDEX
26924 will be an index with only one message in it.
26925 If you use this &quot;separate-index-screen-except-for-single-messages&quot;
26926 setting instead, then that index that contains a single message
26927 will be skipped and you will go directly from the THREAD INDEX into the
26928 MESSAGE TEXT screen.
26929 </DD>
26930
26931 </DL>
26932
26933 <P>
26934 <UL>
26935 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26936 </UL><P>
26937 &lt;End of help on this topic&gt;
26938 </BODY>
26939 </HTML>
26940 ====== h_config_thread_disp_style =====
26941 <HTML>
26942 <HEAD>
26943 <TITLE>OPTION: <!--#echo var="VAR_threading-display-style"--></TITLE>
26944 </HEAD>
26945 <BODY>
26946 <H1>OPTION: <!--#echo var="VAR_threading-display-style"--></H1>
26947
26948 When a folder is sorted by Threads or OrderedSubject,
26949 this option will affect the MESSAGE INDEX display.
26950 By default, Alpine will display the MESSAGE INDEX in the
26951 &quot;show-thread-structure&quot; style if a folder is sorted
26952 by Threads or OrderedSubject.
26953 <P>
26954
26955 The possible values for this option are:
26956
26957 <DL>
26958 <DT>none</DT>
26959 <DD>Regular index display.
26960 The same index line as would be displayed without threading is used.
26961 The only difference will be in the order of the messages.
26962 </DD>
26963
26964 <DT>show-thread-structure</DT>
26965 <DD>Threaded Subjects will be indented and vertical bars and horizontal
26966 lines will be added to make it easier to see the relationships among
26967 the messages in a thread (a conversation).
26968 </DD>
26969
26970 <DT>mutt-like</DT>
26971 <DD>This is the same as the option above except that the Subject
26972 is suppressed (is blank) if it matches the previous Subject in the thread.
26973 The name comes from the email client <A HREF="http://www.mutt.org/">Mutt</A>.
26974 Here is an example of what a mutt-like index might look like.
26975 In this example, the first column represents the message number, the
26976 <A HREF="h_config_thread_index_style"><!--#echo var="VAR_threading-index-style"--></A>
26977 is set to &quot;regular-index-with-expanded-threads&quot;, and the
26978 <A HREF="h_config_thread_lastreply_char"><!--#echo var="VAR_threading-lastreply-character"--></A>
26979 is set to a backslash:
26980 <PRE>
26981 &nbsp;&nbsp;&nbsp;1    Some topic
26982 &nbsp;&nbsp;&nbsp;&nbsp;2  . Subject           original message in thread
26983 &nbsp;&nbsp;&nbsp;&nbsp;3    |->               reply to 2
26984 &nbsp;&nbsp;&nbsp;&nbsp;4  . |->               another reply to 2
26985 &nbsp;&nbsp;&nbsp;&nbsp;5  . | &#92;->             reply to 4
26986 &nbsp;&nbsp;&nbsp;&nbsp;6  . |   &#92;->           reply to 5
26987 &nbsp;&nbsp;&nbsp;&nbsp;7    |     &#92;->         reply to 6
26988 &nbsp;&nbsp;&nbsp;&nbsp;8    |->               another reply to 2
26989 &nbsp;&nbsp;&nbsp;&nbsp;9  . |->New subject    another reply to 2 but with a New subject
26990 &nbsp;&nbsp;&nbsp;10    | |->             reply to 9
26991 &nbsp;&nbsp;&nbsp;11    | &#92;->             another reply to 9
26992 &nbsp;&nbsp;&nbsp;12    |   &#92;->           reply to 11
26993 &nbsp;&nbsp;&nbsp;13    &#92;->               final reply to 2
26994 &nbsp;&nbsp;&nbsp;14    Next topic
26995 </PRE>
26996 </DD>
26997
26998 <DT>indent-subject-1</DT>
26999 <DD>Threaded Subjects will be indented one space per level of the conversation.
27000 The bars and lines that show up in the show-thread-structure display will
27001 not be there with this style.
27002 </DD>
27003
27004 <DT>indent-subject-2</DT>
27005 <DD>Same as above but indent two spaces per level instead of one space.
27006 </DD>
27007
27008 <DT>indent-from-1</DT>
27009 <DD>Similar to indent-subject-1, except that instead of indenting the
27010 Subject field one space the From field of a thread will be indented one
27011 space per level of the conversation.
27012 </DD>
27013
27014 <DT>indent-from-2</DT>
27015 <DD>Same as above but indent two spaces per level instead of one space.
27016 </DD>
27017
27018 <DT>show-structure-in-from</DT>
27019 <DD>The structure of the thread is illustrated with indenting, vertical bars,
27020 and horizontal lines just like with the show-thread-structure option, but
27021 the From field is used to show the relationships instead of the Subject field.
27022 </DD>
27023
27024 </DL>
27025
27026 <P>
27027 <UL>
27028 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27029 </UL><P>
27030 &lt;End of help on this topic&gt;
27031 </BODY>
27032 </HTML>
27033 ====== h_config_pruning_rule =====
27034 <HTML>
27035 <HEAD>
27036 <TITLE>OPTION: <!--#echo var="VAR_pruning-rule"--></TITLE>
27037 </HEAD>
27038 <BODY>
27039 <H1>OPTION: <!--#echo var="VAR_pruning-rule"--></H1>
27040
27041 By default, Alpine will ask at the beginning of each month whether or not
27042 you want to rename your sent-mail folder to a name like sent-mail-month-year.
27043 (See the feature <A HREF="h_config_prune_uses_iso"><!--#echo var="FEAT_prune-uses-yyyy-mm"--></A> to
27044 change the format of the folder to sent-mail-yyyy-mm.)
27045 It will also ask whether you would like to delete old sent-mail folders.
27046 If you have defined
27047 <A HREF="h_config_read_message_folder"><!--#echo var="VAR_read-message-folder"--></A>
27048 or
27049 <A HREF="h_config_pruned_folders"><!--#echo var="VAR_pruned-folders"--></A>
27050 Alpine will also ask about pruning those folders.
27051 <P>
27052
27053 With this option you may provide an automatic answer to these questions.
27054 The default value is to ask you what you'd like to do.
27055 <P>
27056
27057 The six possible values for this option are:
27058
27059 <DL>
27060 <DT>ask about rename, ask about deleting</DT>
27061 <DD>This is the default.
27062 Alpine will ask whether you want to rename the folders and whether you
27063 want to delete each of the old folders.
27064 </DD>
27065
27066 <DT>ask about rename, don't delete</DT>
27067 <DD>Alpine will ask whether you want to rename the folders, but won't
27068 ask about or delete old folders.
27069 </DD>
27070
27071 <DT>always rename, ask about deleting</DT>
27072 <DD>This means you want to always answer yes and have Alpine automatically
27073 rename the folder if possible.
27074 You will also be asked about deleting old folders.
27075 </DD>
27076
27077 <DT>always rename, don't delete</DT>
27078 <DD>This means you want to always answer yes and have Alpine automatically
27079 rename the folder if possible.
27080 There will be no deleting of old folders.
27081 </DD>
27082
27083 <DT>don't rename, ask about deleting</DT>
27084 <DD>This means you want to always answer no.
27085 Alpine will not rename the folder.
27086 You will be asked about deleting old folders.
27087 </DD>
27088
27089 <DT>don't rename, don't delete</DT>
27090 <DD>This means you want to always answer no.
27091 Alpine will not rename the folder.
27092 There will be no deleting of old folders, either.
27093 </DD>
27094 </DL>
27095
27096 <P>
27097 <UL>
27098 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27099 </UL><P>
27100 &lt;End of help on this topic&gt;
27101 </BODY>
27102 </HTML>
27103 ====== h_config_reopen_rule =====
27104 <HTML>
27105 <HEAD>
27106 <TITLE>OPTION: <!--#echo var="VAR_folder-reopen-rule"--></TITLE>
27107 </HEAD>
27108 <BODY>
27109 <H1>OPTION: <!--#echo var="VAR_folder-reopen-rule"--></H1>
27110
27111 Alpine normally checks for new mail in the currently open folder
27112 and in the INBOX every few <A HREF="h_config_mailcheck">minutes</A>.
27113
27114 <P>
27115 There are some situations where automatic new-mail checking does not work.
27116 For example, if a mail folder is opened using the POP protocol or a newsgroup
27117 is being read using the NNTP protocol, then new-mail checking is disabled.
27118
27119 <P>
27120 It may be possible to check for new mail in these cases by reopening the
27121 folder.
27122 Alpine does not do this for you automatically, but you may do the commands
27123 manually to cause this to happen.
27124 You reopen by going back to the folder list screen from the message
27125 index screen with the &quot;&lt;&quot; command,
27126 and then going back into the message index screen with
27127 the &quot;&gt;&quot; command.
27128 (Actually, any method you would normally use to open a folder will work the
27129 same as the &quot;&lt;&quot; followed by &quot;&gt;&quot; method.
27130 For example, the GoTo Folder command will work, or you may use L to go to the
27131 Folder List screen and Carriage Return to reopen the folder.)
27132
27133 <P>
27134 There are some cases where Alpine knows that reopening the folder should
27135 be useful as a way to discover new mail.
27136 At the time of this writing, connections made using the POP protocol,
27137 news reading using the NNTP protocol, local news reading, and local
27138 ReadOnly folders that are in the traditional UNIX or the MMDF format all
27139 fall into this category.
27140 There are other cases where it <EM>may</EM> be a way to discover new mail, but Alpine
27141 has no way of knowing, so it might also just be an exercise in futility.
27142 All remote, ReadOnly folders other than those listed just above fall into this
27143 category.
27144 The setting of this option together with the type of folder
27145 controls how Alpine will react to the apparent attempt to reopen a folder.
27146
27147 <P>
27148 If you don't reopen, then you will just be back in
27149 the message index with no change.
27150 You left the index and came back, but the folder remained &quot;open&quot;
27151 the whole time.
27152 However, if you do reopen the folder, the folder is closed and then reopened.
27153 In this case, the current state of the open folder is lost.
27154 The New status, Important and Answered flags,
27155 selected state, Zoom state, collapsed or expanded state of threads,
27156 current message number,
27157 and any other temporary state is all lost when the reopen happens.
27158 For POP folders (but not NNTP newsgroups) the Deleted flags are also lost.
27159
27160 <P>
27161 In the possibilities listed below, the text says &quot;POP/NNTP&quot; in
27162 several places.
27163 That really implies the case where Alpine knows it is a good way to discover
27164 new mail, which is more than just POP and NNTP, but POP and NNTP are
27165 the cases of most interest.
27166 This option probably has more possible values than it deserves. They are:
27167
27168 <DL>
27169 <DT>Always reopen</DT>
27170 <DD>Alpine will not ask whether you want to reopen but will just do the reopen
27171 whenever you type a command that implies a reopen, regardless of the
27172 access method.
27173 In other words, it is assumed you would always answer Yes if asked
27174 about reopening.
27175 </DD>
27176
27177 <DT>Yes for POP/NNTP, Ask about other remote [Yes]</DT>
27178 <DD>Alpine will assume a Yes answer if the access method is POP or NNTP, but
27179 will ask you whether to reopen other remote folders,
27180 with a default answer of Yes.
27181 </DD>
27182
27183 <DT>Yes for POP/NNTP, Ask about other remote [No]</DT>
27184 <DD>Alpine will assume a Yes answer if the access method is POP or NNTP, but
27185 will ask you whether to reopen other remote folders,
27186 with a default answer of No.
27187 </DD>
27188
27189 <DT>Yes for POP/NNTP, No for other remote</DT>
27190 <DD>Alpine will assume a Yes answer if the access method is POP or NNTP, and
27191 will assume a No answer for all other remote folders.
27192 </DD>
27193
27194 <DT>Always ask [Yes]</DT>
27195 <DD>Alpine will not differentiate based on access method.
27196 It will always ask for all remote folders, with a default answer of Yes.
27197 </DD>
27198
27199 <DT>Always ask [No]</DT>
27200 <DD>Alpine will not differentiate based on access method.
27201 It will always ask for all remote folders, with a default answer of No.
27202 </DD>
27203
27204 <DT>Ask about POP/NNTP [Yes], No for other remote</DT>
27205 <DD>Alpine will ask if the access method is POP or NNTP, with a default answer
27206 of Yes.
27207 It will never attempt to reopen other remote folders.
27208 </DD>
27209
27210 <DT>Ask about POP/NNTP [No], No for other remote</DT>
27211 <DD>This is the default.
27212 Alpine will ask if the access method is POP or NNTP, with a default answer
27213 of No.
27214 It will never attempt to reopen other remote folders.
27215 </DD>
27216
27217 <DT>Never reopen</DT>
27218 <DD>Alpine will never attempt to reopen already open folders.
27219 </DD>
27220 </DL>
27221
27222 <P>
27223 Remember, wherever it says POP or NNTP above it really means POP or NNTP or
27224 any of the other situations where it is likely that reopening is a good way
27225 to discover new mail.
27226
27227 <P>
27228 There is an alternative that may be of useful in some situations.
27229 Instead of manually checking for new mail you can set up a
27230 <A HREF="h_maildrop">Mail Drop</A>
27231 and automatically check for new mail.
27232
27233 <P>
27234 <UL>
27235 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27236 </UL><P>
27237 &lt;End of help on this topic&gt;
27238 </BODY>
27239 </HTML>
27240 ====== h_config_inc_startup =====
27241 <HTML>
27242 <HEAD>
27243 <TITLE>OPTION: <!--#echo var="VAR_incoming-startup-rule"--></TITLE>
27244 </HEAD>
27245 <BODY>
27246 <H1>OPTION: <!--#echo var="VAR_incoming-startup-rule"--></H1>
27247
27248 This value affects Alpine's behavior when opening the &quot;INBOX&quot; or
27249 one of the &quot;INCOMING MESSAGE FOLDERS&quot;.
27250 It determines which message will be the <EM>current message</EM> when
27251 the folder is first opened.
27252 The default value is &quot;first-unseen&quot;.
27253
27254 <P>
27255 The seven possible values for this option are:
27256
27257 <DL>
27258 <DT>first-unseen</DT>
27259 <DD>The current message is set to the first
27260 unseen message that has not been marked deleted, or the last message if
27261 all of the messages have been seen previously.
27262 Messages which have not been seen or which have been seen but re-marked
27263 as New are considered unseen messages.
27264 See the note at the bottom of this help about newsgroups.
27265 </DD>
27266
27267 <DT>first-recent</DT>
27268 <DD>Similar to the default, but rather than starting on the first
27269 unseen message Alpine starts on the first <EM>recent</EM> message.
27270 A message is recent if it arrived since the last time the folder was
27271 open.  This value causes the current message to be set to the first
27272 recent message if there is one, otherwise to the last
27273 message in the folder.
27274 </DD>
27275
27276 <DT>first-important</DT>
27277 <DD>This will result in the current message being set to the first
27278 message marked Important (but not Deleted).
27279 If no messages are marked Important, then it will be the last message.
27280 Messages are marked Important by <EM>you</EM>, not by the sender, using
27281 the
27282 <A HREF="h_common_flag">Flag command</A>.
27283 Or they may be marked Important by an Alpine
27284 <A HREF="h_mainhelp_filtering">Filter</A>
27285 that you have set up.
27286 </DD>
27287
27288 <DT>first-important-or-unseen</DT>
27289 <DD>This selects the first of the first unseen and the first important
27290 messages.
27291 </DD>
27292
27293 <DT>first-important-or-recent</DT>
27294 <DD>This selects the first of the first recent and the first important
27295 messages.
27296 </DD>
27297
27298 <DT>first</DT>
27299 <DD>Simply starts you on the <EM>first</EM> undeleted message in the folder.
27300 If all messages are deleted you start on the last message.
27301 </DD>
27302
27303 <DT>last</DT>
27304 <DD>Simply starts you on the <EM>last</EM> undeleted message in the folder
27305 If all messages are deleted you start on the last message.
27306 </DD>
27307 </DL>
27308
27309 <P>
27310 NOTE:  For newsgroups in the incoming collection, &quot;first-unseen&quot; and
27311 &quot;first-recent&quot; are the same and are affected by whether or not the
27312 feature
27313 <A HREF="h_config_news_uses_recent">&quot;<!--#echo var="FEAT_news-approximates-new-status"-->&quot;</A>
27314 is turned on.
27315 Also, there is no permanent storage in news for an Important flag.
27316 This means that no messages will be marked Important when a newsgroup is
27317 first opened.
27318
27319 <P>
27320 <UL>
27321 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27322 </UL><P>
27323 &lt;End of help on this topic&gt;
27324 </BODY>
27325 </HTML>
27326 ====== h_config_browser =====
27327 <HTML>
27328 <HEAD>
27329 <TITLE>OPTION: <!--#echo var="VAR_url-viewers"--></TITLE>
27330 </HEAD>
27331 <BODY>
27332 <H1>OPTION: <!--#echo var="VAR_url-viewers"--></H1>
27333 <!--chtml if pinemode="os_windows"-->
27334 PC-Alpine users do not need to enter anything here, unless:<UL>
27335 <LI> they want to override, for use with Alpine, the application defined
27336 in the Windows operating system for handling URLs; or
27337 <LI> they are (planning on) using the same configuration file with
27338 Unix Alpine.
27339 </UL>
27340 <P>
27341 Note that if using a viewer that has a space in its path, you should
27342 use the DOS name for that directory or file. Example:
27343 <PRE>
27344 url-viewer=C:&#92;Progra~1&#92;mozilla&#92;mozilla.exe
27345 </PRE>
27346 <HR><P>
27347 <!--chtml endif-->
27348 This option affects Alpine's handling of URLs that are found in
27349 messages you read.  Normally, only URLs Alpine can handle directly
27350 are automatically offered for selection in the &quot;Message
27351 Text&quot; screen.  When one or more applications
27352 capable of deciphering URLs on their command line are added here, Alpine
27353 will choose the first available to display URLs it cannot handle directly.
27354 A viewer's availability is based on its being specified with a <B>full
27355 directory path</B> and the evaluation of any optionally supplied
27356 parameters described below.
27357
27358 <P>
27359 Additionally, to support various connection methods and applications, each
27360 entry in this list can optionally begin with one or more of
27361 the following special tokens.  The allowed tokens include:
27362
27363 <P>
27364 <DL>
27365 <DT>_TEST(<VAR>test-string</VAR>)_</DT>
27366 <DD>
27367 The <VAR>test-string</VAR> is a shell command that Alpine will run to
27368 evaluate a viewer's availability.  The command specified by the test
27369 string is run and if its resulting exit status is non-zero, Alpine will
27370 not consider the associated viewer for use.
27371 </DD>
27372
27373 <DT>_SCHEME(<VAR>scheme-list</VAR>)_</DT>
27374 <DD>
27375 The <VAR>scheme-list</VAR> is a list of one or more (comma-delimited)
27376 URL schemes that are to be used with the associated viewer.  This is
27377 the way to configure Alpine to recognize URLs other than the built-in set.
27378 <P>
27379 It can also be used to override Alpine's built-in handlers.
27380 For example, you could specify &quot;news&quot; in the <VAR>scheme-list</VAR>,
27381 and Alpine would use (provided it passed all other criteria) the associated
27382 viewer when it encounterd a URL of the form &quot;news:comp.mail.pine&quot;.
27383
27384 </DD>
27385 </DL>
27386
27387 <P>
27388 By default, Alpine will simply append a space character followed by the
27389 selected URL prior to launching the command in your specified SHELL.  You can
27390 optionally specify where in the command the selected URL should appear
27391 by using the &quot;_URL_&quot; token.  All occurrences found in the command
27392 will be replaced with the selected URL before the command is handed
27393 to the shell.  If such replacement occurs, the default appending of the
27394 selected URL does not take place.
27395
27396 <P>
27397 NOTE: If the viewer you specify has any command-line arguments,
27398 including the &quot;_URL_&quot; token, you will need to add a
27399 double-quote character before the command path and after the last
27400 argument (see the &quot;lynx&quot; example below).
27401
27402 <P>
27403 So, here are some example entries:
27404 <PRE>
27405 url-viewers = _TEST(&quot;test -n '$&#123;DISPLAY}'&quot;)_  /usr/local/bin/netscape
27406               &quot;/usr/local/bin/lynx _URL_&quot;
27407               C:&#92;BIN&#92;NETSCAPE.BAT
27408 </PRE>
27409 <P>
27410 This example shows that for the first viewer in the list to be used
27411 the environment variable &quot;DISPLAY&quot; must be defined.  If it
27412 is, then the path and file &quot;/usr/local/bin/netscape&quot; must exist.
27413 If neither condition is met,
27414 then the path and file &quot;/usr/local/bin/lynx&quot; must exist.
27415 If it does, then the &quot;_URL_&quot; token is replaced by the selected URL.
27416 If the path to &quot;lynx&quot; is invalid,
27417 then the final path and file C:&#92;BIN&#92;NETSCAPE.BAT must exist.
27418 Note that the last
27419 entry is a DOS/Windows path.  This is one way to support Alpine running
27420 on more than one architecture with the same configuration file.<P>
27421 <P>
27422 <!--chtml if pinemode="os_windows"-->
27423 <!--chtml else-->
27424 Note that depending on the type of browser used and the method of
27425 its invocation (such as whether it will open in a separate window) from
27426 the MESSAGE TEXT screen, the browser may &quot;supplant&quot;
27427 the MESSAGE TEXT screen, and you will have to quit the browser to return to
27428 it (for example, when using Lynx; to exit Lynx, use the &quot;Q&quot; command).
27429 In other words, launching the browser from Alpine may make Alpine
27430 &quot;disappear&quot; (although it is still &quot;running&quot;)
27431 until you close the browser again.<P>
27432 <UL><LI><A HREF="h_config_browser_xterm">Defining <!--#echo var="VAR_url-viewers"--> in an X windows
27433 environment: for advanced users and  systems administrators</A>
27434 </UL>
27435 <!--chtml endif-->
27436 <P>If you are unsure what browsers are available on your system or how to
27437 specify them in Alpine's <!--#echo var="VAR_url-viewers"--> option for best usability, contact your
27438 local computing support staff.
27439 <P><UL>
27440 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27441 </UL>
27442 <P>
27443 &lt;End of help on this topic&gt;
27444 </BODY>
27445 </HTML>
27446 ====== h_config_history =====
27447 <HTML>
27448 <HEAD>
27449 <TITLE>OPTION: <!--#echo var="VAR_default-directories"--></TITLE>
27450 </HEAD>
27451 <BODY>
27452 <H1>OPTION: <!--#echo var="VAR_default-directories"--></H1>
27453 <P>
27454 This option allows you to input a list of directories that Alpine will offer
27455 for you to use when you are saving or exporting attachments. This is useful
27456 when navigating to specific directories becomes too tedious, or when you
27457 need to do this on a daily basis, and want Alpine to remember this on a
27458 permanent basis.
27459 <P>
27460 The list of directories saved here can be accessed using the ^Y and ^V commands
27461 in the save prompt for attachments, or the export command.
27462
27463 <P><UL>
27464 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27465 </UL>
27466 <P>
27467 &lt;End of help on this topic&gt;
27468 </BODY>
27469 </HTML>
27470 ====== h_config_browser_xterm =====
27471 <HTML>
27472 <HEAD>
27473 <TITLE><!--#echo var="VAR_url-viewers"--> and X windows applications</TITLE>
27474 </HEAD>
27475 <BODY>
27476 <H1>Defining <!--#echo var="VAR_url-viewers"--> in an X windows
27477 environment: for advanced users and  systems administrators</H1>
27478 If you are using Alpine with an X-terminal (emulator) and want to define an
27479 X windows-based application in <!--#echo var="VAR_url-viewers"-->,
27480 you may want to do so in a manner that causes any <B>already</B>
27481 invoked viewer application to be used for viewing URLs you select from Alpine
27482 messages, and a <B>new</B> URL-viewer process to be
27483 started <B>only</B> if the same application has <B>not already</B>
27484 been launched -- for one reason, to avoid file-locking contentions among
27485 multiple invocations of the same URL-viewer application.
27486 (The example entries set in the help screen for the &quot;<!--#echo var="VAR_url-viewers"-->&quot;
27487 option does not do this.)  A method of doing that would be:<OL>
27488 <LI> use
27489 the _TEST(<VAR>test-string</VAR>)_ token in the <B>first</B> entry to
27490 check (using commands appropriate for your Unix shell
27491 in place of <VAR>test-string</VAR>) for the presence of a
27492 lockfile created by the URL-viewer application -- which implies that the
27493 application is already running, though this is not foolproof.
27494 Following that in the same <!--#echo var="VAR_url-viewers"--> entry, specify the
27495 application with its appropriate command line option(s) to
27496 show the URL selected from the Alpine message in an already open window of
27497 that application, or perhaps in a new window of that application.
27498
27499 <LI> In the
27500 <B>second</B> entry for the <!--#echo var="VAR_url-viewers"--> option, specify the same
27501 application without those command line options, but this time using the
27502 _TEST(...)_ token to check whether the environment variable &quot;DISPLAY&quot;
27503 is defined.
27504 <LI> If you will be using Alpine (with the same .pinerc file) outside of the X
27505 windows environment (for instance, using VT-100 terminal emulation), you
27506 may wish to specify a non-X windows URL-viewer application such as Lynx
27507 as the last entry.
27508 </OL><BR>
27509 How exactly you define your <!--#echo var="VAR_url-viewers"--> entries to do this will depend on
27510 the command shell, the URL-viewer application(s), and possibly the specific
27511 version of the latter, you are using.
27512 <P>
27513 Relevant command
27514 line options for the Netscape browser for showing URLs (selected from Alpine)
27515 when Netscape is already running are discussed in the document
27516 &quot;Remote Control of UNIX Netscape&quot;
27517 found at the URL (as of 12 Aug. 1998):
27518 <P>
27519
27520 <CENTER><A HREF="http://home.netscape.com/newsref/std/x-remote.html">http://home.netscape.com/newsref/std/x-remote.html</A></CENTER>
27521
27522 <P>(If the URL-viewer application is
27523 <B>not</B> running on the same host as Alpine, but being launched from an
27524 applications server, you may not be able to use the command line options for
27525 using an existing invocation of the application in Alpine's <!--#echo var="VAR_url-viewers"--> entry.)
27526 <P>
27527 <!--chtml if this-method="shown-to-work"-->
27528 An example using the Korn shell and the Netscape browser (first entry wrapped
27529 because of its length, but should all appear on one line):
27530 <P>
27531 url-viewers = _TEST("test -L /myhomedir/.netscape/lock")_ &quot;/usr/local/bin/netscape -remote 'openURL(_URL_,  new-window)' &amp;&quot;<BR>
27532
27533 _TEST(&quot;test -n '$&#123;DISPLAY}'&quot;)_ &quot;/usr/local/bin/netscape &amp;&quot;<BR>
27534               &quot;/usr/local/bin/lynx '_URL_'&quot;
27535 <P>
27536 <!--chtml endif-->
27537 <P>
27538 <UL>
27539 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27540 </UL><P>
27541 &lt;End of help on this topic&gt;
27542 </BODY>
27543 </HTML>
27544 ====== h_config_enable_full_hdr =====
27545 <HTML>
27546 <HEAD>
27547 <TITLE>FEATURE: <!--#echo var="FEAT_enable-full-header-cmd"--></TITLE>
27548 </HEAD>
27549 <BODY>
27550 <H1>FEATURE: <!--#echo var="FEAT_enable-full-header-cmd"--></H1>
27551
27552 This feature enables the &quot;H Full Headers&quot; command which toggles between
27553 the display of all headers in the message and the normal edited view of
27554 headers.  The Full Header command also controls which headers are included
27555 for Export, Pipe, Print, Forward, and Reply functions.  (For Reply, the
27556 Full Header mode will respect the
27557 <A HREF="h_config_include_header">&quot;Include-Headers-in-Reply&quot;</A>
27558 feature setting.)
27559 <P>
27560 If Full Header mode is turned on and you Forward a message, you will
27561 be asked if you'd like to forward the message as an attachment, as opposed
27562 to including the text of the message in the body of your new message.
27563 <P>
27564 If you have also turned on the
27565 <A HREF="h_config_quote_suppression">&quot;Quote Suppression&quot;</A>
27566 option then the Full Headers command actually rotates through three states
27567 instead of just two.
27568 The first is the normal view with long quotes suppressed.
27569 The second is the normal view but with the long quotes included.
27570 The last enables the display of all headers in the message.
27571 When using Export, Pipe, Print, Forward, or Reply the quotes are
27572 never suppressed, so the first two states are identical.
27573 <P>
27574 Normally, the Header Mode will reset
27575 to the default behavior when moving to a new message.
27576 The mode can be made to persist from message to message by setting the feature
27577 <A HREF="h_config_quell_full_hdr_reset"><!--#echo var="FEAT_quell-full-header-auto-reset"--></A>.
27578 <P>
27579 <UL>
27580 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27581 </UL><P>
27582 &lt;End of help on this topic&gt;
27583 </BODY>
27584 </HTML>
27585 ====== h_config_enable_full_hdr_and_text =====
27586 <HTML>
27587 <HEAD>
27588 <TITLE>FEATURE: <!--#echo var="FEAT_enable-full-header-and-text"--></TITLE>
27589 </HEAD>
27590 <BODY>
27591 <H1>FEATURE: <!--#echo var="FEAT_enable-full-header-and-text"--></H1>
27592
27593 This feature affects how the &quot;H Full Headers&quot; command displays
27594 message text.  If set, the raw message text will be displayed.  This
27595 especially affects MIME formatted email, where the entire MIME format
27596 will be displayed.  This feature similarly affects how messages are
27597 included for the Export, Pipe, Print, Forward, and Reply functions.
27598 <P>
27599 When viewing a raw message that has attachments with this feature set,
27600 you will not be able to view attachments without first leaving full
27601 headers mode.  This is because MIME parsing is not done on the raw message.
27602 <P>
27603 <UL>
27604 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27605 </UL><P>
27606 &lt;End of help on this topic&gt;
27607 </BODY>
27608 </HTML>
27609 ====== h_config_enable_pipe =====
27610 <HTML>
27611 <HEAD>
27612 <TITLE>FEATURE: <!--#echo var="FEAT_enable-unix-pipe-cmd"--></TITLE>
27613 </HEAD>
27614 <BODY>
27615 <H1>FEATURE: <!--#echo var="FEAT_enable-unix-pipe-cmd"--></H1>
27616
27617 This feature enables the "| Pipe" command that sends the current message
27618 to the specified command for external processing.
27619 <P>
27620
27621 A short description of how the pipe command works is given
27622 <A HREF="h_pipe_command">here</A>.
27623
27624 <P>
27625 <UL>
27626 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27627 </UL><P>
27628 &lt;End of help on this topic&gt;
27629 </BODY>
27630 </HTML>
27631 ====== h_config_quell_full_hdr_reset =====
27632 <HTML>
27633 <HEAD>
27634 <TITLE>FEATURE: <!--#echo var="FEAT_quell-full-header-auto-reset"--></TITLE>
27635 </HEAD>
27636 <BODY>
27637 <H1>FEATURE: <!--#echo var="FEAT_quell-full-header-auto-reset"--></H1>
27638
27639 The <A HREF="h_common_hdrmode">HdrMode Command</A>
27640 normally resets to the default state when switching to a new message.
27641 For example, if you've used the &quot;H&quot; command to turn on Full
27642 Headers for a message you are viewing, and then you type the Next command
27643 to look at the next message, the full headers will no longer be shown.
27644 Setting this feature disables that reset.
27645 Instead, the Header Mode remains the same from message to message.
27646
27647 <P>
27648 The presence or absence of the HdrMode command is determined by the
27649 <A HREF="h_config_enable_full_hdr">&quot;<!--#echo var="FEAT_enable-full-header-cmd"-->&quot;</A>
27650 Feature-List option.
27651 <P>
27652 <UL>
27653 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27654 </UL><P>
27655 &lt;End of help on this topic&gt;
27656 </BODY>
27657 </HTML>
27658 ====== h_config_enable_tab_complete =====
27659 <HTML>
27660 <HEAD>
27661 <TITLE>FEATURE: <!--#echo var="FEAT_enable-tab-completion"--></TITLE>
27662 </HEAD>
27663 <BODY>
27664 <H1>FEATURE: <!--#echo var="FEAT_enable-tab-completion"--></H1>
27665
27666 This feature enables the TAB key when at a prompt for a filename. In this
27667 case, TAB will cause the partial name already entered to be automatically
27668 completed, provided the partial name is unambiguous.
27669 This feature is on by default.
27670 <P>
27671 Similarly, this feature also enables TAB completion of address book
27672 nicknames when at a prompt for a nickname,
27673 or when typing in an address field in the composer.
27674 <P>
27675 &lt;End of help on this topic&gt;
27676 </BODY>
27677 </HTML>
27678 ====== h_config_quit_wo_confirm =====
27679 <HTML>
27680 <HEAD>
27681 <TITLE>FEATURE: <!--#echo var="FEAT_quit-without-confirm"--></TITLE>
27682 </HEAD>
27683 <BODY>
27684 <H1>FEATURE: <!--#echo var="FEAT_quit-without-confirm"--></H1>
27685
27686 This feature controls whether or not Alpine will ask for confirmation when a
27687 Quit command is received.
27688 <P>
27689 &lt;End of help on this topic&gt;
27690 </BODY>
27691 </HTML>
27692 ====== h_config_quote_replace_noflow =====
27693 <HTML>
27694 <HEAD>
27695 <TITLE>FEATURE: <!--#echo var="FEAT_quote-replace-nonflowed"--></TITLE>
27696 </HEAD>
27697 <BODY>
27698 <H1>FEATURE: <!--#echo var="FEAT_quote-replace-nonflowed"--></H1>
27699
27700 This feature, which is only active when
27701 <A HREF="h_config_quote_replace_string"><!--#echo var="VAR_quote-replace-string"--></A> is
27702 also set,
27703 enables quote-replacement on non-flowed messages.  It is off
27704 by default because a non-flowed message is more dependent on its format,
27705 and thus quote-replacement may cause less-than-pleasing results.
27706 Setting this feature will cause quote-replacement similar to that of flowed
27707 messages, but with the added possibility of long lines being wrapped
27708 into new lines if the Quote-Replacement-String is longer than the string
27709 it is replacing, which is &quot;&gt;&nbsp;&quot;.
27710 <P>
27711 &lt;End of help on this topic&gt;
27712 </BODY>
27713 </HTML>
27714 ====== h_config_enable_jump =====
27715 <HTML>
27716 <HEAD>
27717 <TITLE>FEATURE: <!--#echo var="FEAT_enable-jump-shortcut"--></TITLE>
27718 </HEAD>
27719 <BODY>
27720 <H1>FEATURE: <!--#echo var="FEAT_enable-jump-shortcut"--></H1>
27721
27722 When this feature is set you may enter a number (followed by RETURN)
27723 and jump to that message number, when in the MESSAGE INDEX or MESSAGE TEXT
27724 screens.  In other words, it obviates the need for typing the "J" for the
27725 Jump command.
27726 <P>
27727 &lt;End of help on this topic&gt;
27728 </BODY>
27729 </HTML>
27730 ====== h_config_enable_alt_ed =====
27731 <HTML>
27732 <HEAD>
27733 <TITLE>FEATURE: <!--#echo var="FEAT_enable-alternate-editor-cmd"--></TITLE>
27734 </HEAD>
27735 <BODY>
27736 <H1>FEATURE: <!--#echo var="FEAT_enable-alternate-editor-cmd"--></H1>
27737
27738 If this feature is set (the default), and the
27739 <A HREF="h_config_editor">&quot;<!--#echo var="VAR_editor"-->&quot;</A> option
27740 <B>is not</B> set, entering
27741 the ^_ (Ctrl-underscore) key while composing a message will prompt you
27742 for the name of the editor you would like to use.
27743 <P>
27744 If the environment variable $EDITOR is set, its value will be offered as
27745 a default.
27746 <P>
27747 If the <A HREF="h_config_editor">&quot;<!--#echo var="VAR_editor"-->&quot;</A> option
27748 <B>is</B> set, the ^_ key will activate the specified
27749 editor without prompting, in which case it is not necessary to
27750 set the &quot;<!--#echo var="FEAT_enable-alternate-editor-cmd"-->&quot; feature.
27751 <P>
27752 <UL>
27753 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27754 </UL><P>
27755 &lt;End of help on this topic&gt;
27756 </BODY>
27757 </HTML>
27758 ====== h_config_alt_ed_now =====
27759 <HTML>
27760 <HEAD>
27761 <TITLE>FEATURE: <!--#echo var="FEAT_enable-alternate-editor-implicitly"--></TITLE>
27762 </HEAD>
27763 <BODY>
27764 <H1>FEATURE: <!--#echo var="FEAT_enable-alternate-editor-implicitly"--></H1>
27765
27766 If this feature and the <A HREF="h_config_editor">&quot;<!--#echo var="VAR_editor"-->&quot;</A>
27767 variable are both set, Alpine will
27768 automatically activate the specified editor when the cursor is moved from
27769 the header of the message being composed into the message text.  For
27770 replies, the alternate editor will be activated immediately.  If this
27771 feature is set but the &quot;<!--#echo var="VAR_editor"-->&quot; variable is not set, then Alpine will
27772 automatically ask for the name of an alternate editor when the cursor
27773 is moved out of the header being composed, or if a reply is being done.
27774
27775 <P><UL>
27776 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27777 </UL>
27778 <P>
27779 &lt;End of help on this topic&gt;
27780 </BODY>
27781 </HTML>
27782 ====== h_config_enable_bounce =====
27783 <HTML>
27784 <HEAD>
27785 <TITLE>FEATURE: <!--#echo var="FEAT_enable-bounce-cmd"--></TITLE>
27786 </HEAD>
27787 <H1>FEATURE: <!--#echo var="FEAT_enable-bounce-cmd"--></H1>
27788 <BODY>
27789
27790 Setting this feature enables the "B Bounce" command, which will prompt
27791 for an address and *remail* the message to the new recipient.  This command
27792 is used to re-direct messages that you have received in error, or need to
27793 be redirected for some other reason (e.g. list moderation).  The final
27794 recipient will see a header indicating that you have Resent the msg, but
27795 the message's From: header will show the original author of the message,
27796 and replies to it will go back to that author, and not to you.
27797 <P>
27798 &lt;End of help on this topic&gt;
27799 </BODY>
27800 </HTML>
27801 ====== h_config_enable_agg_ops =====
27802 <HTML>
27803 <HEAD>
27804 <TITLE>FEATURE: <!--#echo var="FEAT_enable-aggregate-command-set"--></TITLE>
27805 </HEAD>
27806 <BODY>
27807 <H1>FEATURE: <!--#echo var="FEAT_enable-aggregate-command-set"--></H1>
27808
27809 When this feature is set you may use the commands and subcommands that relate to
27810 performing operations on more than one message at a time.  We call these
27811 &quot;aggregate operations&quot;.  In particular, the
27812 <!--chtml if pinemode="function_key"-->&quot;F5
27813 <!--chtml else-->&quot;;
27814 <!--chtml endif--> Select&quot;,
27815
27816 <!--chtml if pinemode="function_key"-->
27817 &quot;F6
27818 <!--chtml else-->
27819 &quot;A
27820 <!--chtml endif-->
27821 Apply&quot;, and
27822 <!--chtml if pinemode="function_key"-->
27823 &quot;F4
27824 <!--chtml else-->
27825 &quot;Z
27826 <!--chtml endif-->
27827 Zoom&quot; commands are enabled by this feature.  Select is used to
27828 &quot;tag&quot; one or more messages meeting the specified criteria.  Apply can
27829 then be used to apply any message command to all of the selected/tagged
27830 messages.  Further, the Zoom command allows you to toggle the MESSAGE INDEX
27831 view between just those Selected and all messages in the folder.
27832 <P>
27833 This feature also enables the
27834 <!--chtml if pinemode="function_key"-->
27835 &quot;F7&quot;
27836 <!--chtml else-->
27837 &quot;^X&quot;
27838 <!--chtml endif-->
27839
27840 subcommand in the MESSAGE INDEX
27841 WhereIs command that causes all messages matching the WhereIs argument to
27842 become selected; and the Select, Select Current, and ZoomMode commands in the
27843 <A HREF="h_folder_maint">FOLDER LIST screen</A>.
27844 <P>
27845 Some related help topics are
27846 <UL>
27847 <LI> <A HREF="h_mainhelp_aggops">Aggregate Operations</A>
27848 <LI> <A HREF="h_index_cmd_select">Selecting: Select and WhereIs/Select</A>,
27849 <LI> <A HREF="h_config_auto_unzoom"><!--#echo var="FEAT_auto-unzoom-after-apply"--></A>,
27850 <LI> <A HREF="h_config_auto_unselect"><!--#echo var="FEAT_auto-unselect-after-apply"--></A>.
27851 <LI> <A HREF="h_config_auto_zoom"><!--#echo var="FEAT_auto-zoom-after-select"--></A>, and
27852 <LI> <A HREF="h_config_select_wo_confirm"><!--#echo var="FEAT_select-without-confirm"--></A>.
27853 </UL>
27854 <P>
27855 <UL>
27856 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27857 </UL><P>
27858 &lt;End of help on this topic&gt;
27859 </BODY>
27860 </HTML>
27861
27862 ====== h_config_enable_flag =====
27863 <HTML>
27864 <HEAD>
27865 <TITLE>FEATURE: <!--#echo var="FEAT_enable-flag-cmd"--></TITLE>
27866 </HEAD>
27867 <BODY>
27868 <H1>FEATURE: <!--#echo var="FEAT_enable-flag-cmd"--></H1>
27869
27870 Setting this feature enables the
27871 <A HREF="h_common_flag">&quot;* Flag&quot;</A>
27872 command that allows you to
27873 manipulate the status flags associated with a message.  By default, Flag
27874 will set the "Important" flag, which results in an asterisk being
27875 displayed in column one of the MESSAGE INDEX for such messages.
27876 <P>
27877 &lt;End of help on this topic&gt;
27878 </BODY>
27879 </HTML>
27880 ====== h_config_flag_screen_default =====
27881 <HTML>
27882 <HEAD>
27883 <TITLE>FEATURE: <!--#echo var="FEAT_enable-flag-screen-implicitly"--></TITLE>
27884 </HEAD>
27885 <BODY>
27886 <H1>FEATURE: <!--#echo var="FEAT_enable-flag-screen-implicitly"--></H1>
27887
27888 The feature modifies the behavior of the
27889 <a href="h_common_flag">Flag</a>
27890 command (provided it too is
27891 <A HREF="h_config_enable_flag">enabled</A>).
27892 By default, when the "* Flag" command is selected,
27893 Alpine offers a prompt to set one of several flags and also offers the
27894 option of entering the detailed flag manipulation screen via the "^T"
27895 key. Enabling this feature causes Alpine to immediately enter the detailed
27896 flag screen rather than first offer the simple prompt.
27897 The
27898 <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.
27899 <P>
27900 &lt;End of help on this topic&gt;
27901 </BODY>
27902 </HTML>
27903 ====== h_config_flag_screen_kw_shortcut =====
27904 <HTML>
27905 <HEAD>
27906 <TITLE>FEATURE: <!--#echo var="FEAT_enable-flag-screen-keyword-shortcut"--></TITLE>
27907 </HEAD>
27908 <BODY>
27909 <H1>FEATURE: <!--#echo var="FEAT_enable-flag-screen-keyword-shortcut"--></H1>
27910
27911 This feature modifies the behavior of the
27912 <a href="h_common_flag">Flag</a> command
27913 and the <A HREF="h_index_cmd_select">Select</A> command.
27914 This feature is set by default.
27915 When this feature is not set, when the "* Flag" command is selected,
27916 Alpine offers a prompt to set one of several flags and also offers the
27917 option of entering the detailed flag manipulation screen via the "^T"
27918 key.
27919 If you have
27920 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>
27921 defined, then enabling this feature adds a shortcut way to set or unset
27922 keywords.
27923 You use &quot;*&quot; followed by the first letter of a keyword (or the nickname of
27924 a keyword if you've given it a nickname) and that will set the keyword.
27925 <P>
27926 An example is easier to understand than the explanation.
27927 The flag command can always be used to set the system flags.
27928 For example, to set the Answered flag you would type
27929 <P>
27930 <CENTER><SAMP>* A</SAMP></CENTER>
27931 <P>
27932 Now suppose you have defined a keyword &quot;Work&quot; using the <!--#echo var="VAR_keywords"-->
27933 option in the Config screen.
27934 By default, to set a keyword like &quot;Work&quot; you would usually
27935 have to go to the Flag Details screen using
27936 the &quot;^T To Flag Details&quot; command.
27937 Instead, if you have enabled this feature, you may type
27938 <P>
27939 <CENTER><SAMP>* W</SAMP></CENTER>
27940 <P>
27941 to set the Work flag, or
27942 <P>
27943 <CENTER><SAMP>* ! W</SAMP></CENTER>
27944 <P>
27945 to unset it.
27946 Just like for the other flag setting commands, the case of the letter does
27947 not matter, so &quot;w&quot; or &quot;W&quot; both set the &quot;Work&quot;
27948 keyword.
27949 <P>
27950 Notice that you can only use this trick for one keyword that begins
27951 with &quot;W&quot;.
27952 If you happen to have a &quot;Work&quot; keyword and another keyword that is
27953 &quot;WIFI&quot; the &quot;* W&quot; command will set the first one in
27954 your list of keywords.
27955 Also, there are five letters that are reserved for system
27956 flags and the NOT command.
27957 If you type &quot;* A&quot; it will always set the Answered flag, not
27958 your &quot;Aardvark&quot; keyword.
27959 In order to set the &quot;Aardvark&quot; keyword you'll still have to use
27960 the Flag Details screen.
27961 <P>
27962 Because enabling the
27963 <A HREF="h_config_flag_screen_default"><!--#echo var="FEAT_enable-flag-screen-implicitly"--></A>
27964 option causes Alpine to skip directly to the Flag Details screen when the
27965 Flag command is used,
27966 setting it will cause this feature to have no effect at all.
27967 <P>
27968 Similarly, when Selecting by Keyword, setting this option will allow you
27969 to use Keyword initials instead of full keywords.
27970 <P>
27971 &lt;End of help on this topic&gt;
27972 </BODY>
27973 </HTML>
27974 ====== h_config_can_suspend =====
27975 <HTML>
27976 <HEAD>
27977 <TITLE>FEATURE: <!--#echo var="FEAT_enable-suspend"--></TITLE>
27978 </HEAD>
27979 <BODY>
27980 <H1>FEATURE: <!--#echo var="FEAT_enable-suspend"--></H1>
27981
27982 Setting this feature will allow you to type ^Z (Control Z) to
27983 <!--chtml if pinemode="os_windows"-->
27984 minimize Alpine into its icon, bringing into focus whatever
27985 application is running behind the PC-Alpine window.
27986 <!--chtml else-->
27987 temporarily suspend Alpine.
27988
27989 <P>
27990 This does not exit Alpine, but puts it in the background to watch
27991 for new mail and such.  Normally, you type a command, such
27992 as &quot;fg&quot; at your system prompt to return to your Alpine session.
27993
27994 <P>
27995 The <A HREF="h_config_suspend_spawns"><!--#echo var="FEAT_use-subshell-for-suspend"--></A> feature
27996 adjusts whether Alpine is placed into the background of the shell its
27997 running in or starts a news shell.
27998 <!--chtml endif-->
27999
28000 <P>
28001 <UL>
28002 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28003 </UL><P>
28004 &lt;End of help on this topic&gt;
28005 </BODY>
28006 </HTML>
28007 ====== h_config_take_lastfirst ======
28008 <HTML>
28009 <HEAD>
28010 <TITLE>FEATURE: <!--#echo var="FEAT_disable-take-last-comma-first"--></TITLE>
28011 </HEAD>
28012 <BODY>
28013 <H1>FEATURE: <!--#echo var="FEAT_disable-take-last-comma-first"--></H1>
28014
28015 Normally, when TakeAddr is used to copy an address from a message into
28016 an address book entry, Alpine will attempt to rewrite the full name of the
28017 address in the form
28018 <P>
28019
28020 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Last, First<P>
28021
28022 instead of<P>
28023
28024 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;First Last
28025
28026 <P>
28027 It does this because many people find it useful to sort by Last name
28028 instead of First name.  If this feature is set, then the TakeAddr command
28029 will not attempt to reverse the name in this manner.
28030 <P>
28031 &lt;End of help on this topic&gt;
28032 </BODY></HTML>
28033 ====== h_config_disable_regex ======
28034 <HTML>
28035 <HEAD>
28036 <TITLE>FEATURE: <!--#echo var="FEAT_disable-regular-expression-matching-for-alternate-addresses"--></TITLE>
28037 </HEAD>
28038 <BODY>
28039 <H1>FEATURE: <!--#echo var="FEAT_disable-regular-expression-matching-for-alternate-addresses"--></H1>
28040
28041 Normally, the
28042 <a href="h_config_alt_addresses"><!--#echo var="VAR_alt-addresses"--></a>
28043 option is interpreted as a regular expression.
28044 One type of address that might cause trouble is an address that
28045 contains a plus sign.
28046 If you want to have an address with a plus as one of your
28047 <!--#echo var="VAR_alt-addresses"-->
28048 and you don't want to use regular expressions, then setting this
28049 feature will cause Alpine to treat the addresses you list literally instead.
28050 <P>
28051 &lt;End of help on this topic&gt;
28052 </BODY></HTML>
28053 ====== h_config_take_fullname ======
28054 <HTML>
28055 <HEAD>
28056 <TITLE>FEATURE: <!--#echo var="FEAT_disable-take-fullname-in-addresses"--></TITLE>
28057 </HEAD>
28058 <BODY>
28059 <H1>FEATURE: <!--#echo var="FEAT_disable-take-fullname-in-addresses"--></H1>
28060
28061 Normally, when TakeAddr is used to copy an address or addresses
28062 from a message into an address book entry, Alpine will try to preserve
28063 the full name associated with each address in the list of addresses.
28064 The reason for this is so that if the entry is a list or later becomes a
28065 list, then information about the individual addresses in the list
28066 is preserved.
28067 If you would rather just have the simple addresses in the list of addresses,
28068 set this feature. For example, with the default setting you might
28069 see something like this in the ADDRESS BOOK editor after you type TakeAddr
28070 <P>
28071 <PRE>
28072  Nickname  : nick
28073  Fullname  : Bedrock Elders
28074  Fcc       :
28075  Comment   :
28076  Addresses : Fred Flintstone &lt;flint@bedrock.org&gt;,
28077              Barney Rubble &lt;rubble@bedrock.org&gt;
28078 </PRE>
28079 <P>
28080 but with this feature set it would look like
28081 <P>
28082 <PRE>
28083  Nickname  : nick
28084  Fullname  : Bedrock Elders
28085  Fcc       :
28086  Comment   :
28087  Addresses : flint@bedrock.org,
28088              rubble@bedrock.org
28089 </PRE>
28090 <P>
28091 instead. Note the difference in the Addresses field.
28092 <P>
28093 &lt;End of help on this topic&gt;
28094 </BODY></HTML>
28095 ====== h_config_print_from ======
28096 <HTML>
28097 <HEAD>
28098 <TITLE>FEATURE: <!--#echo var="FEAT_print-includes-from-line"--></TITLE>
28099 </HEAD>
28100 <BODY>
28101 <H1>FEATURE: <!--#echo var="FEAT_print-includes-from-line"--></H1>
28102
28103 If this feature is set, then the Berkeley-mail style From line is included
28104 at the start of each message that is printed.  This line looks something
28105 like the following, with the address replaced by the address from the
28106 From line of the message being printed:
28107 <P>
28108 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;From user@domain.somewhere.com Mon May 13
28109 14:11:06 1998
28110 <P>
28111 &lt;End of help on this topic&gt;
28112 </BODY>
28113 </HTML>
28114 ====== h_config_expanded_distlists ======
28115 <HTML>
28116 <HEAD>
28117 <TITLE>FEATURE: <!--#echo var="FEAT_expanded-view-of-distribution-lists"--></TITLE>
28118 </HEAD>
28119 <BODY>
28120 <H1>FEATURE: <!--#echo var="FEAT_expanded-view-of-distribution-lists"--></H1>
28121 If this feature is set, then distribution lists in the address book
28122 screen will always be expanded automatically.
28123 <P>
28124 &lt;End of help on this topic&gt;
28125 </BODY>
28126 </HTML>
28127 ====== h_config_compose_news_wo_conf ======
28128 <HTML>
28129 <HEAD>
28130 <TITLE>FEATURE: <!--#echo var="FEAT_compose-sets-newsgroup-without-confirm"--></TITLE>
28131 </HEAD>
28132 <BODY>
28133 <H1>FEATURE: <!--#echo var="FEAT_compose-sets-newsgroup-without-confirm"--></H1>
28134 This feature controls one aspect of Alpine's Composer.  If you enter the
28135 composer while reading a newsgroup, you will normally be prompted to
28136 determine whether you intend the new message to be posted to the current
28137 newsgroup or not.  If this feature is set, Alpine will not prompt you
28138 in this situation, and will assume that you do indeed wish to post
28139 to the newsgroup you are reading.
28140 <P>
28141 &lt;End of help on this topic&gt;
28142 </BODY>
28143 </HTML>
28144 ====== h_config_compose_rejects_unqual ======
28145 <HTML>
28146 <HEAD>
28147 <TITLE>FEATURE: <!--#echo var="FEAT_compose-rejects-unqualified-addrs"--></TITLE>
28148 </HEAD>
28149 <BODY>
28150 <H1>FEATURE: <!--#echo var="FEAT_compose-rejects-unqualified-addrs"--></H1>
28151
28152 This feature controls one aspect of the message composer; in particular,
28153 what happens when an unqualified name is entered into an address header.
28154 If set, unqualified names entered as addresses will be treated as errors
28155 unless they match an addressbook nickname.  Alpine will not attempt to turn
28156 them into complete addresses by adding your local domain.<P>
28157
28158 A complete (fully qualified) address is one containing a username followed
28159 by an &quot;@&quot; (&quot;at&quot;) symbol, followed by a domain name (e.g.
28160 &quot;jsmith@example.com&quot;).  An unqualified name is one <B>without</B>
28161 the &quot;@&quot; symbol and domain name (e.g. &quot;jsmith&quot;).
28162
28163 (See also <A HREF="h_address_format">Explanation of Address formats</A>.)
28164
28165 <P>
28166
28167 When you enter a fully qualified address, Alpine does not interpret or
28168 modify it, but simply passes it on to the mail-transport-agent (MTA) for
28169 your system.  Alpine conforms to the Internet standards governing message
28170 headers and will not send an unqualifed name to the MTA.  Therefore, when
28171 you enter an unqualified name, Alpine will normally attempt to turn it into
28172 a fully qualified address, first by checking to see if you have entered a
28173 matching nickname in your addressbook, or failing that, by simply adding
28174 your own domain to the name entered.  So if your address is
28175 &quot;jsmith@example.com&quot; and you enter &quot;fred&quot;, then (assuming
28176 &quot;fred&quot; is not a nickname in your addressbook), Alpine will turn
28177 that into &quot;fred@example.com&quot;.<P>
28178
28179 There are situations where it is not desirable for Alpine to interpret such
28180 unqualified names as valid (local) addresses.  For example, if &quot;fred&quot;
28181 turned out to be a typo (intended to be an addressbook nickname), but
28182 there actually was a &quot;fred&quot; in your local domain, the message might
28183 be mis-delivered without your realizing it.  In order to reduce the likelihood
28184 of such accidents, setting this feature will cause Alpine to treat such
28185 addresses as errors, and require that you explicitly enter the full local
28186 address (e.g. &quot;fred@example.com&quot;) or correct the name so that it
28187 matches an address book nickname.<P>
28188
28189 Consider this a safety feature against mis-directed mail.
28190 <P>
28191 <UL>
28192 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28193 </UL><P>
28194 &lt;End of help on this topic&gt;
28195 </BODY>
28196 </HTML>
28197 ====== h_config_quell_local_lookup ======
28198 <HTML>
28199 <HEAD>
28200 <TITLE>FEATURE: <!--#echo var="FEAT_quell-user-lookup-in-passwd-file"--></TITLE>
28201 </HEAD>
28202 <BODY>
28203 <H1>FEATURE: <!--#echo var="FEAT_quell-user-lookup-in-passwd-file"--></H1>
28204
28205 This feature controls an aspect of Alpine's Composer, and if needed, will
28206 usually be set by your system manager in Alpine's system-wide configuration
28207 file. Specifically, if this feature is set, Alpine will not attempt to look
28208 in the system password file to find a Full Name for the entered address.
28209 <P>
28210 Normally, names you enter into address fields (e.g. To: or Cc:) are
28211 checked against your address book(s) to see if they match an address book
28212 nickname.  Failing that, (in Unix Alpine) the name is then checked against
28213 the Unix password file.  If the entered name matches a username in the
28214 system password file, Alpine extracts the corresponding Full Name information
28215 for that individual, and adds that to the address being entered.
28216 <P>
28217 However, password file matching can have surprising (incorrect) results if
28218 other users of the system do not receive mail at the domain you are using.
28219 That is, if either the
28220 <A HREF="h_config_user_dom">&quot;<!--#echo var="VAR_user-domain"-->&quot;</A> or
28221 <A HREF="h_config_domain_name">&quot;<!--#echo var="VAR_use-only-domain-name"-->&quot;</A>
28222 option
28223 is set such that the administrative domain of other users on the system
28224 isn't accurately reflected, Alpine should be told that a passwd file match
28225 is coincidental, and Full Name info will be incorrect.  For example, a
28226 personal name from the password file could get falsely paired with the
28227 entered name as it is turned into an address in the configured domain.
28228 <P>
28229 If you are seeing this behavior, enabling this feature will prevent Unix
28230 Alpine from looking up names in the password file to find the Full Name
28231 for incomplete addresses you enter.<P>
28232 <UL>
28233 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28234 </UL>
28235 <P>
28236 &lt;End of help on this topic&gt;
28237 </BODY>
28238 </HTML>
28239 ====== h_config_tab_checks_recent ======
28240 <HTML>
28241 <HEAD>
28242 <TITLE>FEATURE: <!--#echo var="FEAT_tab-checks-recent"--></TITLE>
28243 </HEAD>
28244 <BODY>
28245 <H1>FEATURE: <!--#echo var="FEAT_tab-checks-recent"--></H1>
28246
28247 In a FOLDER LIST screen, the TAB key usually just changes which
28248 folder is highlighted.
28249 If this feature is set, then the TAB key will cause the number of
28250 recent messages and the total number of messages in the highlighted folder
28251 to be displayed instead.
28252
28253 <P>
28254 &lt;End of help on this topic&gt;
28255 </BODY>
28256 </HTML>
28257 ====== h_config_maildrops_preserve_state ======
28258 <HTML>
28259 <HEAD>
28260 <TITLE>FEATURE: <!--#echo var="FEAT_maildrops-preserve-state"--></TITLE>
28261 </HEAD>
28262 <BODY>
28263 <H1>FEATURE: <!--#echo var="FEAT_maildrops-preserve-state"--></H1>
28264
28265 This feature affects the way <A HREF="h_maildrop">Mail Drops</A> work.
28266 Normally, when mail is moved from a Mail Drop folder to a destination
28267 folder, it is delivered as new mail.
28268 Any Seen/New, Answered, Important/Flagged state that has changed will be
28269 ignored.
28270 All of the mail will be considered unSeen, unAnswered, and unImportant after
28271 it is moved.
28272 <P>
28273 If this feature is set, then the state changes that have been made
28274 to the messages in the Mail Drop folder will be preserved.
28275 <P>
28276 In any case, messages that are already marked Deleted when the
28277 mail is to be moved from the Mail Drop will be ignored.
28278 <P>
28279 &lt;End of help on this topic&gt;
28280 </BODY>
28281 </HTML>
28282 ====== h_config_preopen_stayopens ======
28283 <HTML>
28284 <HEAD>
28285 <TITLE>FEATURE: <!--#echo var="FEAT_preopen-stayopen-folders"--></TITLE>
28286 </HEAD>
28287 <BODY>
28288 <H1>FEATURE: <!--#echo var="FEAT_preopen-stayopen-folders"--></H1>
28289
28290 This feature is related to the option
28291 <A HREF="h_config_permlocked">&quot;<!--#echo var="VAR_stay-open-folders"-->&quot;</A>.
28292 Normally, Stay Open folders are only opened on demand, when the user
28293 asks to open them.
28294 From then on they are kept open for the duration of the session.
28295 However, if this feature is set, then the Stay Open folders will all be
28296 opened at startup, at the same time that the INBOX is opened.
28297
28298 <P>
28299 &lt;End of help on this topic&gt;
28300 </BODY>
28301 </HTML>
28302 ====== h_config_expunge_inbox ======
28303 <HTML>
28304 <HEAD>
28305 <TITLE>FEATURE: <!--#echo var="FEAT_offer-expunge-of-inbox"--></TITLE>
28306 </HEAD>
28307 <BODY>
28308 <H1>FEATURE: <!--#echo var="FEAT_offer-expunge-of-inbox"--></H1>
28309
28310 The INBOX is normally treated differently from regular folders in several
28311 ways.
28312 One of the differences is that the normal &quot;close&quot; sequence of
28313 events is deferred until Alpine is exited, instead of happening when you
28314 leave the INBOX to view another folder.
28315 The &quot;close&quot; sequence normally includes the Expunging
28316 of deleted messages
28317 (either automatically or after a prompt, controlled by the features
28318 <A HREF="h_config_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm"-->&quot;</A>,
28319 <A HREF="h_config_full_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm-everywhere"-->&quot;</A>, and
28320 <A HREF="h_config_expunge_manually"><!--#echo var="FEAT_expunge-only-manually"--></A>), and the
28321 handling of the
28322 <A HREF="h_config_read_message_folder"><!--#echo var="VAR_read-message-folder"--></A>.
28323
28324 <P>
28325 If this feature is set the &quot;close&quot; sequence handling will take
28326 place every time you leave the INBOX.
28327 The INBOX will still be kept open, but the offer to Expunge and the archiving
28328 to the <!--#echo var="VAR_read-message-folder"-->
28329 will take place each time you leave the INBOX instead of only once at the
28330 end of the session.
28331
28332 <P>
28333 &lt;End of help on this topic&gt;
28334 </BODY>
28335 </HTML>
28336 ====== h_config_expunge_stayopens ======
28337 <HTML>
28338 <HEAD>
28339 <TITLE>FEATURE: <!--#echo var="FEAT_offer-expunge-of-stayopen-folders"--></TITLE>
28340 </HEAD>
28341 <BODY>
28342 <H1>FEATURE: <!--#echo var="FEAT_offer-expunge-of-stayopen-folders"--></H1>
28343
28344 This feature is related to the option
28345 <A HREF="h_config_permlocked">&quot;<!--#echo var="VAR_stay-open-folders"-->&quot;</A>.
28346 Stay Open folders are treated differently from regular folders in several
28347 ways.
28348 One of the differences is that the normal &quot;close&quot; sequence of
28349 events is deferred until Alpine is exited, instead of happening when you
28350 leave the folder to view another folder.
28351 The &quot;close&quot; sequence normally includes the Expunging
28352 of deleted messages
28353 (either automatically or after a prompt, controlled by the features
28354 <A HREF="h_config_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm"-->&quot;</A>,
28355 <A HREF="h_config_full_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm-everywhere"-->&quot;</A>, and
28356 <A HREF="h_config_expunge_manually"><!--#echo var="FEAT_expunge-only-manually"--></A>), and the
28357 handling of
28358 <A HREF="h_config_archived_folders"><!--#echo var="VAR_incoming-archive-folders"--></A>.
28359
28360 <P>
28361 If this feature is set the &quot;close&quot; sequence handling will take
28362 place when you leave the Stay Open folder.
28363 The folder will still be kept open, but the offer to Expunge and the archiving
28364 will take place each time you leave the folder instead of only once at the
28365 end of the session.
28366 This feature does not affect the INBOX, which will still only be processed
28367 when you exit Alpine.
28368 However, there is a similar feature that affects only the INBOX called
28369 <A HREF="h_config_expunge_inbox">&quot;<!--#echo var="FEAT_offer-expunge-of-inbox"-->&quot;</A>.
28370
28371 <P>
28372 &lt;End of help on this topic&gt;
28373 </BODY>
28374 </HTML>
28375 ====== h_config_preserve_start_stop ======
28376 <HTML>
28377 <HEAD>
28378 <TITLE>FEATURE: <!--#echo var="FEAT_preserve-start-stop-characters"--></TITLE>
28379 </HEAD>
28380 <BODY>
28381 <H1>FEATURE: <!--#echo var="FEAT_preserve-start-stop-characters"--></H1>
28382
28383 This feature controls how special control key characters, typically
28384 Ctrl-S and Ctrl-Q, are interpreted when input to Alpine.  These characters
28385 are known as the "stop" and "start" characters and are sometimes used in
28386 communications paths to control data flow between devices that operate at
28387 different speeds.
28388
28389 <P>
28390
28391 By default, Alpine turns the system's handling of these special characters
28392 off except during printing.  However, if you see Alpine reporting input errors
28393 such as:
28394 <P>
28395 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[ Command "^Q" not defined for this screen.]
28396 <P>
28397 and, at the same time, see your display become garbled, then it is likely
28398 that setting this option will solve the problem.  Be aware, though, that
28399 enabling this feature will also cause Alpine to ostensibly "hang"
28400 whenever the Ctrl-S key combination is entered as the system is now
28401 interpreting such input as a "stop output" command.  To "start
28402 output"  again, simply type Ctrl-Q.
28403 <P>
28404 &lt;End of help on this topic&gt;
28405 </BODY>
28406 </HTML>
28407 ====== h_config_enable_incoming ======
28408 <HTML>
28409 <HEAD>
28410 <TITLE>FEATURE: <!--#echo var="FEAT_enable-incoming-folders"--></TITLE>
28411 </HEAD>
28412 <BODY>
28413 <H1>FEATURE: <!--#echo var="FEAT_enable-incoming-folders"--></H1>
28414
28415 Alpine's Incoming Message Folders collection
28416 provides a convenient way to access multiple incoming folders.
28417 It is also useful if you have accounts on multiple computers.
28418 <P>
28419
28420 If set, this feature defines a pseudo-folder collection called
28421 &quot;INCOMING MESSAGE FOLDERS&quot;.  Initially, the only folder included
28422 in this collection will be your INBOX, which will no longer show up in
28423 your Default folder collection.
28424 <P>
28425
28426 You may add more folders to the Incoming Message Folders collection by
28427 using the
28428 <!--chtml if pinemode="function_key"-->
28429 &quot;F10
28430 <!--chtml else-->
28431 &quot;A
28432 <!--chtml endif-->
28433 Add&quot; command in the FOLDER LIST screen.  You will be prompted for
28434 the host the folder is stored on (which defaults to the same host used
28435 for your INBOX), a nickname, and the actual folder name.  Once a set
28436 of Incoming Message Folders are defined, the TAB key (in MESSAGE INDEX
28437 or MESSAGE TEXT screens) may be used to scan the folders for those
28438 with Recent messages.  If you add more folders to
28439 your <!--#echo var="VAR_incoming-folders"--> collection, turning this feature back off will have
28440 no effect.
28441 <P>
28442 NOTE: Normally the software that actually delivers mail (the stuff that happens
28443 before Alpine is involved) is in a better position to do delivery filtering
28444 than is Alpine itself.
28445 If possible, you may want to look at programs such as
28446 &quot;filter&quot; or &quot;procmail&quot;, which are examples of delivery
28447 filtering programs.
28448 If you'd prefer to have Alpine do the filtering for you, you may set that
28449 up.
28450 Look <A HREF="h_rules_filter">here</A> for help with Alpine filtering.
28451 <P>
28452 <UL>
28453 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28454 </UL><P>
28455 &lt;End of help on this topic&gt;
28456 </BODY>
28457 </HTML>
28458 ====== h_config_enable_incoming_checking ======
28459 <HTML>
28460 <HEAD>
28461 <TITLE>FEATURE: <!--#echo var="FEAT_enable-incoming-folders-checking"--></TITLE>
28462 </HEAD>
28463 <BODY>
28464 <H1>FEATURE: <!--#echo var="FEAT_enable-incoming-folders-checking"--></H1>
28465
28466 This feature is only operational if you have enabled the optional
28467 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A> collection.
28468 If you do have Incoming Message Folders and you also set this feature,
28469 then the number of Unseen messages in each folder will be displayed
28470 in the FOLDER LIST screen for the Incoming Message Folders.
28471 The number of Unseen messages in a folder will be displayed in parentheses
28472 to the right of the name of each folder.
28473 If there are no Unseen messages in a folder then only the name
28474 is displayed, not a set of parentheses with zero inside them.
28475 A redraw command, Ctrl-L, can be used in the FOLDER LIST screen for
28476 the Incoming Message Folders to cause an immediate update.
28477 <P>
28478 If a check for Unseen messages fails for a particular folder then Alpine
28479 will no longer attempt to check that folder for the duration of the
28480 session and this will be indicated by a question mark inside the
28481 parentheses.
28482 <P>
28483 The features
28484 <A HREF="h_config_incoming_checking_total"><!--#echo var="FEAT_incoming-checking-includes-total"--></A>,
28485 <A HREF="h_config_incoming_checking_recent"><!--#echo var="FEAT_incoming-checking-uses-recent"--></A>,
28486 <A HREF="h_config_incoming_list"><!--#echo var="VAR_incoming-check-list"--></A>,
28487 <A HREF="h_config_incoming_interv"><!--#echo var="VAR_incoming-check-interval"--></A>,
28488 <A HREF="h_config_incoming_second_interv"><!--#echo var="VAR_incoming-check-interval-secondary"--></A>, and
28489 <A HREF="h_config_incoming_timeo"><!--#echo var="VAR_incoming-check-timeout"--></A>
28490 all affect how this feature behaves.
28491 <P>
28492 <UL>
28493 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28494 </UL><P>
28495 &lt;End of help on this topic&gt;
28496 </BODY>
28497 </HTML>
28498 ====== h_config_incoming_checking_total ======
28499 <HTML>
28500 <HEAD>
28501 <TITLE>FEATURE: <!--#echo var="FEAT_incoming-checking-includes-total"--></TITLE>
28502 </HEAD>
28503 <BODY>
28504 <H1>FEATURE: <!--#echo var="FEAT_incoming-checking-includes-total"--></H1>
28505
28506 This option has no effect unless the feature
28507 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
28508 is set, which in turn has no effect unless
28509 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
28510 is set.
28511 <P>
28512 When incoming folder checking is turned on the default is to display
28513 the number of unseen messages in each folder.
28514 More precisely, it is the number of undeleted unseen messages.
28515 Using this option you may also display the total number of messages
28516 in each folder.
28517 Instead of a single number representing the number of unseen messages
28518 you will get two numbers separated by a slash character.
28519 The first is the number of unseen messages and the second is the
28520 total number of messages.
28521 <P>
28522 You may also use the recent message count instead of the unseen message
28523 count by turning on the feature
28524 <A HREF="h_config_incoming_checking_recent"><!--#echo var="FEAT_incoming-checking-uses-recent"--></A>.
28525 <P>
28526 <UL>
28527 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28528 </UL><P>
28529 &lt;End of help on this topic&gt;
28530 </BODY>
28531 </HTML>
28532 ====== h_config_incoming_checking_recent ======
28533 <HTML>
28534 <HEAD>
28535 <TITLE>FEATURE: <!--#echo var="FEAT_incoming-checking-uses-recent"--></TITLE>
28536 </HEAD>
28537 <BODY>
28538 <H1>FEATURE: <!--#echo var="FEAT_incoming-checking-uses-recent"--></H1>
28539
28540 This option has no effect unless the feature
28541 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
28542 is set, which in turn has no effect unless
28543 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
28544 is set.
28545 <P>
28546 When incoming folder checking is turned on the default is to display
28547 the number of unseen messages in each folder.
28548 More precisely, it is the number of undeleted unseen messages.
28549 Using this option you may display the number of recent messages instead
28550 of the number of unseen messages.
28551 A message is only counted as recent if this is the first session to
28552 see it, so the recent count might be less than the unseen count.
28553 The difference between the two would be accounted for by the unseen messages
28554 in the folder which were there previously but have not been looked at yet.
28555 <P>
28556 If you simultaneously run more than one email client at a time
28557 (for example, you run more than one Alpine in parallel) then turning
28558 this feature on can cause some confusion.
28559 The confusion stems from the fact that each message is only considered to be
28560 recent in one session.
28561 That means that the counts of new messages may be different in the two
28562 Alpines running side by side, because each incoming message will only be
28563 counted as recent in one of the two sessions.
28564 <P>
28565 You may also display the total number of messages
28566 in each folder by using the
28567 <A HREF="h_config_incoming_checking_total"><!--#echo var="FEAT_incoming-checking-includes-total"--></A>
28568 option.
28569 <P>
28570 <UL>
28571 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28572 </UL><P>
28573 &lt;End of help on this topic&gt;
28574 </BODY>
28575 </HTML>
28576 ====== h_config_attach_in_reply ======
28577 <HTML>
28578 <HEAD>
28579 <TITLE>FEATURE: <!--#echo var="FEAT_include-attachments-in-reply"--></TITLE>
28580 </HEAD>
28581 <BODY>
28582 <H1>FEATURE: <!--#echo var="FEAT_include-attachments-in-reply"--></H1>
28583
28584 This feature controls an aspect of Alpine's Reply command. If set, any MIME
28585 attachments that were part of the original message will automatically be
28586 included in the Reply.
28587 <P>
28588 &lt;End of help on this topic&gt;
28589 </BODY>
28590 </HTML>
28591 ====== h_config_include_header =====
28592 <HTML>
28593 <HEAD>
28594 <TITLE>FEATURE: <!--#echo var="FEAT_include-header-in-reply"--></TITLE>
28595 </HEAD>
28596 <BODY>
28597 <H1>FEATURE: <!--#echo var="FEAT_include-header-in-reply"--></H1>
28598
28599 This feature controls an aspect of Alpine's Reply command. If set, and the
28600 original message is being included in the reply, then headers from that
28601 message will also be part of the reply.
28602 <P>
28603 &lt;End of help on this topic&gt;
28604 </HEAD>
28605 </HTML>
28606 ====== h_config_sig_at_bottom =====
28607 <HTML>
28608 <HEAD>
28609 <TITLE>FEATURE: <!--#echo var="FEAT_signature-at-bottom"--></TITLE>
28610 </HEAD>
28611 <BODY>
28612 <H1>FEATURE: <!--#echo var="FEAT_signature-at-bottom"--></H1>
28613
28614 This feature controls an aspect of Alpine's Reply command.  If this feature
28615 is set, and the original message is being included in the reply, then the
28616 contents of your signature file (if any) will be inserted after the included
28617 message.
28618 <P>
28619 This feature does not affect the results of a Forward command.
28620 <P>
28621 &lt;End of help on this topic&gt;
28622 </BODY>
28623 </HTML>
28624 ====== h_config_sigdashes =====
28625 <HTML>
28626 <HEAD>
28627 <TITLE>FEATURE: <!--#echo var="FEAT_enable-sigdashes"--></TITLE>
28628 </HEAD>
28629 <BODY>
28630 <H1>FEATURE: <!--#echo var="FEAT_enable-sigdashes"--></H1>
28631
28632 This feature enables support for the common USENET news convention
28633 of preceding a message signature with the special line consisting of
28634 the three characters &quot;--&nbsp;&quot; (i.e., dash, dash, and space).
28635
28636 <P>
28637 When enabled and a
28638 &quot;<A HREF="h_config_signature_file"><!--#echo var="VAR_signature-file"--></A>&quot; exists,
28639 Alpine will insert the special line before including the file's text (unless
28640 the special line already exists somewhere in the file's text).
28641
28642 <P>
28643 In addition, when you Reply or Followup to a message containing one of
28644 these special lines and choose to include its text, Alpine will observe
28645 the convention of not including text beyond the special line in your
28646 reply.
28647 If <A HREF="h_config_enable_full_hdr">&quot;Full Header&quot;</A>
28648 mode is enabled and turned on, then Alpine <EM>will</EM>
28649 include the text beyond the special line regardless of the setting of
28650 this feature.
28651
28652 <P>
28653 See also &quot;<a href="h_config_strip_sigdashes"><!--#echo var="FEAT_strip-from-sigdashes-on-reply"--></a>&quot;
28654 for a related feature.
28655
28656 <P>
28657 <UL>
28658 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28659 </UL><P>
28660 &lt;End of help on this topic&gt;
28661 </BODY>
28662 </HTML>
28663 ====== h_config_new_thread_blank_subject =====
28664 <HTML>
28665 <HEAD>
28666 <TITLE>FEATURE: <!--#echo var="FEAT_new-thread-on-blank-subject"--></TITLE>
28667 </HEAD>
28668 <BODY>
28669 <H1>FEATURE: <!--#echo var="FEAT_new-thread-on-blank-subject"--></H1>
28670
28671 When this feature is enabled (the default) Alpine will create a new thread
28672 every time that the subject line becomes empty at any time during composition.
28673
28674 <P>
28675 This behavior is particularly useful in case you are replying to a message.
28676 Replying to a message causes the message to be in the same thread than the
28677 original message that is being replied to. However, many authors want to create
28678 a new message (in a different thread) while replying to a message, and they do
28679 this by changing the full subject, by first deleting the original subject and
28680 typing the new subject of the current message.
28681
28682 <P>
28683 Enabling this feature causes that any time that the subject is deleted, the
28684 message being composed will be considered the first message of a new thread.
28685
28686 <P>
28687 <UL>
28688 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28689 </UL><P>
28690 &lt;End of help on this topic&gt;
28691 </BODY>
28692 </HTML>
28693 ====== h_config_strip_sigdashes =====
28694 <HTML>
28695 <HEAD>
28696 <TITLE>FEATURE: <!--#echo var="FEAT_strip-from-sigdashes-on-reply"--></TITLE>
28697 </HEAD>
28698 <BODY>
28699 <H1>FEATURE: <!--#echo var="FEAT_strip-from-sigdashes-on-reply"--></H1>
28700
28701 This feature doesn't do anything if the feature
28702 &quot;<A HREF="h_config_sigdashes"><!--#echo var="FEAT_enable-sigdashes"--></A>&quot; is turned on.
28703 However, if the &quot;<!--#echo var="FEAT_enable-sigdashes"-->&quot; feature is not turned on,
28704 then turning on this feature enables support for the convention
28705 of not including text beyond the sigdashes line when Replying or Following
28706 up to a message and including the text of that message.
28707 If <A HREF="h_config_enable_full_hdr">&quot;Full Header&quot;</A>
28708 mode is enabled and turned on, then Alpine <EM>will</EM>
28709 include the text beyond the special line regardless of the setting of
28710 this feature.
28711 <P>
28712 In other words, this is a way to turn on the signature stripping behavior
28713 without also turning on the dashes-adding behavior.
28714 <P>
28715 <UL>
28716 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28717 </UL><P>
28718 &lt;End of help on this topic&gt;
28719 </BODY>
28720 </HTML>
28721 ====== h_config_forward_as_attachment =====
28722 <HTML>
28723 <HEAD>
28724 <TITLE>FEATURE: <!--#echo var="FEAT_forward-as-attachment"--></TITLE>
28725 </HEAD>
28726 <BODY>
28727 <H1>FEATURE: <!--#echo var="FEAT_forward-as-attachment"--></H1>
28728
28729 This feature affects the way forwarded message text is handled.  When set, rather than
28730 include the text of the forwarded message below any additional text you provide in the
28731 composer, the forwarded message is attached in its entirety to the message you send.
28732 <P>
28733 This is useful in that it keeps the text you provide in the composer distinct from the
28734 text of the forwarded message.  Similarly, it allows the recipient to
28735 conveniently operate on the forwarded message.  For example, they might reply directly to
28736 the sender of the forwarded message, or process it as part of a spam report.
28737 <UL>
28738 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28739 </UL><P>
28740 &lt;End of help on this topic&gt;
28741 </BODY>
28742 </HTML>
28743 ====== h_config_preserve_field =====
28744 <HTML>
28745 <HEAD>
28746 <TITLE>FEATURE: <!--#echo var="FEAT_preserve-original-fields"--></TITLE>
28747 </HEAD>
28748 <BODY>
28749 <H1>FEATURE: <!--#echo var="FEAT_preserve-original-fields"--></H1>
28750
28751 This feature affects Alpine's behavior when one replies to a message.
28752 When you receive a message, some or all of the recipients of the message
28753 have been added to the To: and Cc: fields. If you reply to such message,
28754 and this feature is disabled, then the original sender of the message is
28755 added to the To: field, and all other recipients are added to the Cc:
28756 field, while your address is added to the From: field.
28757
28758 <P>
28759 However, if this feature is enabled, then Alpine will preserve the
28760 original fields as sent in the original message, so the Cc: and To:
28761 fields will be preserved. The sender's address will be added to the To:
28762 field, while your address is added to the From: field.
28763
28764 <P>
28765 The behavior of this feature is that replies to all messages will behave
28766 in the way described above. If you only intend this to happen on a per
28767 message basis, then keep this feature disabled, and when replying to a
28768 message you will see a new option in the menu for the &quot;Reply to all
28769 recipients?&quot; question. In this case, pressing &quot;p&quot; will
28770 make Alpine toggle its question so you can preserve the To: and Cc:
28771 fields for that message only.
28772
28773 <UL>
28774 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28775 </UL><P>
28776 &lt;End of help on this topic&gt;
28777 </BODY>
28778 </HTML>
28779 ====== h_config_sub_lists =====
28780 <HTML>
28781 <HEAD>
28782 <TITLE>FEATURE: <!--#echo var="FEAT_enable-partial-match-lists"--></TITLE>
28783 </HEAD>
28784 <BODY>
28785 <H1>FEATURE: <!--#echo var="FEAT_enable-partial-match-lists"--></H1>
28786
28787 This feature affects the subcommands available when Saving,
28788 or when Opening a new folder. If set, the subcommand ^X ListMatches will be
28789 available. This command allows you to type in a substring of the folder
28790 you are looking for and when you type ^X it will display all folders
28791 that contain that substring in their names.
28792 This feature is set by default.
28793
28794 <P>
28795 &lt;End of help on this topic&gt;
28796 </BODY>
28797 </HTML>
28798 ====== h_config_scramble_message_id =====
28799 <HTML>
28800 <HEAD>
28801 <TITLE>FEATURE: <!--#echo var="FEAT_scramble-message-id"--></TITLE>
28802 </HEAD>
28803 <BODY>
28804 <H1>FEATURE: <!--#echo var="FEAT_scramble-message-id"--></H1>
28805
28806 Normally the Message-ID header that Alpine generates when sending a message
28807 contains the name of the computer from which the message is being sent.
28808 Some believe that this hostname could be used by spammers or could
28809 be used by others for nefarious purposes.
28810 If this feature is set, that name will be transformed with a simple
28811 Rot13 transformation.
28812 The result will still have the correct syntax for a Message-ID but the
28813 part of the MessageID that is often a domain name will not be an actual
28814 domain name because the letters will be scrambled.
28815 <P>
28816 In addition, other information such as the name program, version, and
28817 a code for operating system used to build Alpine, will be encoded using
28818 the Rot13 transformation, except for the version number which will be
28819 encoded using a Rot5 transformation.
28820 <P>
28821 It is possible (but unlikely?) that some spam detection
28822 software will use that as a reason to reject the mail as spam.
28823 It has also been reported that some spam detection software uses the
28824 fact that there are no dots after the &quot;@&quot; as a reason to reject
28825 messages.
28826 If your PC-Alpine Message-ID is using a name without a dot that is because
28827 that is what Windows thinks is your &quot;Full computer name&quot;.
28828 The method used to set this varies from one type of Windows to another but
28829 check under Settings -> Control Panel -> System and
28830 look for Network Identification or Computer Name or something similar.
28831 How to set it is beyond the scope of Alpine.
28832
28833 <P>
28834 &lt;End of help on this topic&gt;
28835 </BODY>
28836 </HTML>
28837 ====== h_downgrade_multipart_to_text =====
28838 <HTML>
28839 <HEAD>
28840 <TITLE>FEATURE: <!--#echo var="FEAT_downgrade-multipart-to-text"--></TITLE>
28841 </HEAD>
28842 <BODY>
28843 <H1>FEATURE: <!--#echo var="FEAT_downgrade-multipart-to-text"--></H1>
28844
28845 <P>
28846 This feature affects Alpine's behavior when sending mail.  Internet
28847 standards require Alpine to translate all non-ASCII characters in
28848 messages that it sends using MIME encoding.  This encoding can be
28849 ostensibly broken for recipients if any agent between Alpine and the
28850 recipient, such as an email list expander, appends text to the
28851 message, such as list information or advertising.  When sending such
28852 messages Alpine attempts to protect such encoding by placing extra
28853 MIME boundaries around the message text.
28854 <P>
28855 These extra boundaries are invisible to recipients that
28856 use MIME-aware email programs (the vast majority).  However, if
28857 you correspond with users of email programs that are not MIME-aware,
28858 or do not handle the extra boundaries gracefully, you can
28859 use this feature to prevent Alpine from including the extra
28860 MIME information.  Of course, it will increase the likelihood
28861 that non-ASCII text you send may appear corrupt to the recipient.
28862 <P>
28863 &lt;End of help on this topic&gt;
28864 </BODY>
28865 </HTML>
28866 ====== h_config_show_sort =====
28867 <HTML>
28868 <HEAD>
28869 <TITLE>FEATURE: <!--#echo var="FEAT_show-sort"--></TITLE>
28870 </HEAD>
28871 <BODY>
28872 <H1>FEATURE: <!--#echo var="FEAT_show-sort"--></H1>
28873
28874 If this feature is set and there is sufficient space on the screen,
28875 a short indication of the current sort order will be
28876 added in the titlebar (the top line on the screen), before the name
28877 of the folder.
28878 For example, with the default Arrival sort in effect,
28879 the display would have the characters
28880
28881 <P><CENTER>[A]</CENTER><P>
28882
28883 added between the title of the screen and the folder name.
28884 The letters are the same as the letters you may type to manually
28885 sort a folder with the SortIndex command ($).
28886 The letters in the table below are the ones that may show
28887 up in the titlebar line.
28888 <P>
28889 <TABLE>
28890 <TR> <TD> A </TD> <TD> <EM>A</EM>rrival        </TD> </TR>
28891 <TR> <TD> S </TD> <TD> <EM>S</EM>ubject        </TD> </TR>
28892 <TR> <TD> F </TD> <TD> <EM>F</EM>rom           </TD> </TR>
28893 <TR> <TD> T </TD> <TD> <EM>T</EM>o             </TD> </TR>
28894 <TR> <TD> C </TD> <TD> <EM>C</EM>c             </TD> </TR>
28895 <TR> <TD> D </TD> <TD> <EM>D</EM>ate           </TD> </TR>
28896 <TR> <TD> Z </TD> <TD> si<EM>Z</EM>e           </TD> </TR>
28897 <TR> <TD> O </TD> <TD> <EM>O</EM>rderedsubject </TD> </TR>
28898 <TR> <TD> E </TD> <TD> scor<EM>E</EM>          </TD> </TR>
28899 <TR> <TD> H </TD> <TD> t<EM>H</EM>read         </TD> </TR>
28900 </TABLE>
28901 <P>
28902 If the sort order is Reversed, the letter above will be preceded by the letter
28903 &quot;R&quot;, for example
28904
28905 <P><CENTER>[RS]</CENTER><P>
28906
28907 means that a Reverse Subject sort is in effect.
28908 For the case where the sort is in Reverse Arrival order, the &quot;A&quot; is
28909 left out, and just an &quot;R&quot; is shown.
28910
28911 <P><CENTER>[R]</CENTER>
28912
28913 <P>
28914 &lt;End of help on this topic&gt;
28915 </BODY>
28916 </HTML>
28917 ====== h_config_disable_reset_disp =====
28918 <HTML>
28919 <HEAD>
28920 <TITLE>FEATURE: <!--#echo var="FEAT_disable-terminal-reset-for-display-filters"--></TITLE>
28921 </HEAD>
28922 <BODY>
28923 <H1>FEATURE: <!--#echo var="FEAT_disable-terminal-reset-for-display-filters"--></H1>
28924
28925 UNIX Alpine only.
28926 <P>
28927 This feature affects Alpine's behavior when using
28928 <A HREF="h_config_display_filters"><!--#echo var="VAR_display-filters"--></A>.
28929 Normally, before the display filter is run, the terminal mode is reset
28930 to what it was before you started Alpine.
28931 This may be necessary if the filter requires the use of the terminal.
28932 For example, it may need to interact with you.
28933 If you set this feature, then the terminal mode will not be reset.
28934 One thing that turning on this feature should fix is the coloring of
28935 <A HREF="h_config_quote_color">quoted text</A> in the message view, which
28936 breaks because the terminal reset resets the color state of the terminal.
28937
28938 <P>
28939 &lt;End of help on this topic&gt;
28940 </BODY>
28941 </HTML>
28942 ====== h_config_disable_sender =====
28943 <HTML>
28944 <HEAD>
28945 <TITLE>FEATURE: <!--#echo var="FEAT_disable-sender"--></TITLE>
28946 </HEAD>
28947 <BODY>
28948 <H1>FEATURE: <!--#echo var="FEAT_disable-sender"--></H1>
28949
28950 This feature affects Alpine's generation of the &quot;Sender:&quot; or
28951 <A HREF="h_config_use_sender_not_x">&quot;X-X-Sender&quot;</A>
28952 header fields.
28953 By default, Alpine will generate such a header in situations where the
28954 username or domain are not the same as
28955 the &quot;From:&quot; header on the message.
28956 With this feature set,
28957 no &quot;Sender:&quot; or &quot;X-X-Sender&quot; header will be generated.
28958 This may be desirable on a system that is virtually hosting many domains,
28959 and the sysadmin has other methods available for tracking a message to
28960 its originator.
28961 <P>
28962 See also <A HREF="h_config_allow_chg_from">&quot;<!--#echo var="FEAT_allow-changing-from"-->&quot;</A>.
28963
28964 <P>
28965 &lt;End of help on this topic&gt;
28966 </BODY>
28967 </HTML>
28968 ====== h_config_use_sender_not_x =====
28969 <HTML>
28970 <HEAD>
28971 <TITLE>FEATURE: <!--#echo var="FEAT_use-sender-not-x-sender"--></TITLE>
28972 </HEAD>
28973 <BODY>
28974 <H1>FEATURE: <!--#echo var="FEAT_use-sender-not-x-sender"--></H1>
28975
28976 Normally Alpine adds a header line
28977 labeled &quot;X-X-Sender&quot;, if the sender is
28978 different from the From: line.
28979 The standard specifies that this header
28980 line should be labeled &quot;Sender&quot;, not &quot;X-X-Sender&quot;.
28981 Setting this feature causes
28982 &quot;Sender&quot; to be used instead of &quot;X-X-Sender&quot;.
28983 <P>
28984 See also <A HREF="h_config_disable_sender">&quot;<!--#echo var="FEAT_disable-sender"-->&quot;</A>.
28985
28986 <P>
28987 &lt;End of help on this topic&gt;
28988 </BODY>
28989 </HTML>
28990 ====== h_config_use_fk =====
28991 <HTML>
28992 <HEAD>
28993 <TITLE>FEATURE: <!--#echo var="FEAT_use-function-keys"--></TITLE>
28994 </HEAD>
28995 <BODY>
28996 <H1>FEATURE: <!--#echo var="FEAT_use-function-keys"--></H1>
28997
28998 This feature specifies that Alpine will respond to function keys instead of
28999 the normal single-letter commands. In this mode, the key menus at the
29000 bottom of each screen will show function key designations instead of the
29001 normal mnemonic key.
29002
29003 <P>
29004 &lt;End of help on this topic&gt;
29005 </BODY>
29006 </HTML>
29007 ====== h_config_cancel_confirm =====
29008 <HTML>
29009 <HEAD>
29010 <TITLE>FEATURE: <!--#echo var="FEAT_compose-cancel-confirm-uses-yes"--></TITLE>
29011 </HEAD>
29012 <BODY>
29013 <H1>FEATURE: <!--#echo var="FEAT_compose-cancel-confirm-uses-yes"--></H1>
29014
29015 This feature affects what happens when you type ^C to cancel a composition.
29016 By default, if you attempt to cancel a composition by typing ^C, you will be
29017 asked to confirm the cancellation by typing a &quot;C&quot;
29018 for <EM>C</EM>onfirm.
29019 It logically ought to be a &quot;Y&quot; for <EM>Y</EM>es, but that is
29020 risky because the &quot;^C Y&quot; needed to cancel a message
29021 is close (on the keyboard) to the &quot;^X Y&quot; needed to send a message.
29022 <P>
29023 If this feature is set the confirmation asked for
29024 will be a &quot;<EM>Y</EM>es&quot;
29025 instead of a &quot;<EM>C</EM>onfirm&quot; response.
29026
29027 <P>
29028 &lt;End of help on this topic&gt;
29029 </BODY>
29030 </HTML>
29031 ====== h_config_compose_maps_del =====
29032 <HTML>
29033 <HEAD>
29034 <TITLE>FEATURE: <!--#echo var="FEAT_compose-maps-delete-key-to-ctrl-d"--></TITLE>
29035 </HEAD>
29036 <BODY>
29037 <H1>FEATURE: <!--#echo var="FEAT_compose-maps-delete-key-to-ctrl-d"--></H1>
29038
29039 This feature affects the behavior of the DELETE key.
29040 If set, Delete will be equivalent to ^D, and delete
29041 the current character.  Normally Alpine defines the Delete key
29042 to be equivalent to ^H, which deletes the <EM>previous</EM>
29043 character.
29044
29045 <P>
29046 &lt;End of help on this topic&gt;
29047 </BODY>
29048 </HTML>
29049 ====== h_config_compose_bg_post =====
29050 <HTML>
29051 <HEAD>
29052 <TITLE>FEATURE: <!--#echo var="FEAT_enable-background-sending"--></TITLE>
29053 </HEAD>
29054 <BODY>
29055 <H1>FEATURE: <!--#echo var="FEAT_enable-background-sending"--></H1>
29056
29057 This feature affects the behavior of Alpine's mail sending.  If set, this
29058 feature enables a subcommand in the composer's "Send?" confirmation
29059 prompt.  The subcommand allows you to tell Alpine to handle the actual
29060 posting in the background.  While this feature usually allows posting
29061 to appear to happen very fast, it has no affect on the actual delivery
29062 time it takes a message to arrive at its destination.
29063
29064 <P>
29065 Please Note:
29066 <OL>
29067  <LI>This feature will have no effect if the feature
29068        <A HREF="h_config_send_wo_confirm">&quot;<!--#echo var="FEAT_send-without-confirm"-->&quot;</A>
29069        is set.
29070  <LI>This feature isn't supported on all systems.  All DOS and Windows,
29071        as well as several Unix ports, do not recognize this feature.
29072  <LI>Error handling is significantly different when this feature is
29073         enabled.  Any message posting failure results in the message
29074         being appended to your &quot;Interrupted&quot; mail folder.  When you
29075         type the <A HREF="h_common_compose">C</A>ompose command,
29076         Alpine will notice this folder and
29077         offer to extract any messages contained.  Upon continuing a
29078         failed message, Alpine will display the nature of the failure
29079         in the status message line.
29080  <LI> <EM>WARNING</EM>: Under extreme conditions, it is possible
29081         for message data to
29082         get lost.  <EM>Do</EM> <EM>not</EM> enable this feature
29083         if you typically run close to any sort of disk-space limits or quotas.
29084 </OL>
29085 <P>
29086 &lt;End of help on this topic&gt;
29087 </BODY>
29088 </HTML>
29089 ====== h_config_compose_dsn =====
29090 <HTML>
29091 <HEAD>
29092 <TITLE>FEATURE: <!--#echo var="FEAT_enable-delivery-status-notification"--></TITLE>
29093 </HEAD>
29094 <BODY>
29095 <H1>FEATURE: <!--#echo var="FEAT_enable-delivery-status-notification"--></H1>
29096
29097 This feature affects the behavior of Alpine's mail sending.  If set, this
29098 feature enables a subcommand in the composer's &quot;Send?&quot; confirmation
29099 prompt.  The subcommand allows you to tell Alpine to request the type of
29100 Delivery Status Notification (DSN) that you would like.  Most users will
29101 be happy with the default, and need not enable this feature.
29102 <P>
29103 If the feature
29104 <A HREF="h_config_send_wo_confirm">&quot;<!--#echo var="FEAT_send-without-confirm"-->&quot;</A> is set,
29105 then this feature has no effect and the type of DSN is not selectable.
29106
29107 <P>
29108 Turning on this feature and then turning on the DSNOpts from the send
29109 prompt reveals four on-off toggles at the bottom of the screen.
29110 The &quot;X&quot; command toggles between NoErrRets and ErrRets.  NoErrRets requests
29111 that no notification be returned to you, even if there is a delivery
29112 failure.  The &quot;D&quot; key toggles between Delay and NoDelay.  This tells the
29113 server that you are willing (or not) to receive delay notifications, which
29114 happen when there is an unusual delay at some mail server (in that mail
29115 server's opinion).  The &quot;S&quot; key toggles between Success and NoSuccess.
29116 Success requests that you be sent a DSN message when the message is
29117 successfully delivered to the recipients mailbox.  Setting NoErrRets will
29118 automatically turn off Delay and Success notification, and will flip the
29119 toggles to show that.  Similarly, turning on Delay and/or Success will
29120 automatically toggle the &quot;X&quot; key to ErrRets.  The fourth command, the
29121 &quot;H&quot; key, toggles between RetHdrs and RetFull.  RetFull requests that
29122 the full message be returned in any failed DSN.  RetHdrs requests that
29123 only the headers be returned in any failed DSN.  Notice that this command
29124 applies only to failed delivery status reports.  For delay or success
29125 reports, the full message is never returned, only the headers are returned.
29126
29127 <P>
29128 If you don't enable the DSN feature or if you don't turn it on for a
29129 particular message, the default is that you will be notified about failures,
29130 you might be notified about delays, and you won't be notified about
29131 successes.  You will usually receive the full message back when there is
29132 a failure.
29133
29134 <P>
29135 If you turn on the DSNOpts the default is to return as much information as
29136 possible to you.  That is, by default, the Success and Delay options are
29137 turned on and the full message will be returned on failure.
29138
29139 <P>
29140 The sending prompt will display the current DSN request (if any) in a
29141 shorthand form.  It will be:
29142
29143 <P><CENTER>[Never]</CENTER>
29144
29145 <P>
29146 if you have requested NoErrRets.  Otherwise, it will look something like:
29147
29148 <P><CENTER>[FDS-Hdrs]</CENTER>
29149
29150 <P>
29151 The &quot;F&quot; will always be there, indicating that you will be notified
29152 of failures.  (Alpine doesn't provide a way to request no failure notification
29153 and at the same time request either success or delay notification.  The only
29154 way to request no failure notifications is to request no notifications at
29155 all with NoErrRets.)  The &quot;D&quot; and/or &quot;S&quot; will be present if you have
29156 requested Delay and/or Success notification.  If one of those is missing,
29157 that means you are requesting no notification of the corresponding type.
29158 After the dash it will say either Hdrs or Full.  Hdrs means to return only
29159 the headers and Full means to return the full message (applies to
29160 failure notifications only).
29161
29162 <P>
29163 NOTE: This feature relies on your system's mail transport agent or
29164 configured
29165 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>
29166 having the negotiation mechanism introduced in
29167 &quot;Extended SMTP&quot; (ESMTP) and the specific extension called
29168 &quot;Delivery Status Notification&quot; (DSN).  If the mail tranport agent you
29169 are using doesn't support DSN, a short warning will be shown to you on
29170 the message line at the bottom of the screen after you send your message,
29171 but your message will have been sent anyway.
29172
29173 <P>
29174 Note that DSNs don't provide a mechanism to request read receipts.  That
29175 is, if you request notification on success you are notified when the
29176 message is delivered to the mailbox, not when the message is read.
29177
29178 <P>
29179 ESMTP allows for graceful migration to upgraded mail transfer agents, but
29180 it is possible that this feature might cause problems for some servers.
29181
29182 <P>
29183 &lt;End of help on this topic&gt;
29184 </BODY>
29185 </HTML>
29186 ====== h_config_auto_zoom =====
29187 <HTML>
29188 <HEAD>
29189 <TITLE>FEATURE: <!--#echo var="FEAT_auto-zoom-after-select"--></TITLE>
29190 </HEAD>
29191 <BODY>
29192 <H1>FEATURE: <!--#echo var="FEAT_auto-zoom-after-select"--></H1>
29193
29194 This feature affects the behavior of the Select command.
29195 If set, the select command will automatically perform a zoom
29196 after the select is complete.
29197 This feature is set by default.
29198 <P>
29199 Some related help topics are
29200 <UL>
29201 <LI> <A HREF="h_mainhelp_aggops">Aggregate Operations</A>
29202 <LI> <A HREF="h_index_cmd_select">Selecting: Select and WhereIs/Select</A>,
29203 <LI> <A HREF="h_config_enable_agg_ops"><!--#echo var="FEAT_enable-aggregate-command-set"--></A>,
29204 <LI> <A HREF="h_config_auto_unzoom"><!--#echo var="FEAT_auto-unzoom-after-apply"--></A>, and
29205 <LI> <A HREF="h_config_auto_unselect"><!--#echo var="FEAT_auto-unselect-after-apply"--></A>.
29206 <LI> <A HREF="h_config_select_wo_confirm"><!--#echo var="FEAT_select-without-confirm"--></A>.
29207 </UL>
29208
29209 <P>
29210 &lt;End of help on this topic&gt;
29211 </BODY>
29212 </HTML>
29213 ====== h_config_auto_unzoom =====
29214 <HTML>
29215 <HEAD>
29216 <TITLE>FEATURE: <!--#echo var="FEAT_auto-unzoom-after-apply"--></TITLE>
29217 </HEAD>
29218 <BODY>
29219 <H1>FEATURE: <!--#echo var="FEAT_auto-unzoom-after-apply"--></H1>
29220
29221 This feature affects the behavior of the Apply command.  If set, and if
29222 you are currently looking at a Zoomed Index view of selected messages,
29223 the Apply command will do the operation you specify, but then will
29224 implicitly do an &quot;UnZoom&quot;, so that you will automatically be back in
29225 the normal Index view after the Apply.
29226 This feature is set by default.
29227
29228 <P>
29229 Some related help topics are
29230 <UL>
29231 <LI> <A HREF="h_mainhelp_aggops">Aggregate Operations</A>
29232 <LI> <A HREF="h_index_cmd_select">Selecting: Select and WhereIs/Select</A>,
29233 <LI> <A HREF="h_config_enable_agg_ops"><!--#echo var="FEAT_enable-aggregate-command-set"--></A>,
29234 <LI> <A HREF="h_config_auto_unselect"><!--#echo var="FEAT_auto-unselect-after-apply"--></A>.
29235 <LI> <A HREF="h_config_auto_zoom"><!--#echo var="FEAT_auto-zoom-after-select"--></A>, and
29236 <LI> <A HREF="h_config_select_wo_confirm"><!--#echo var="FEAT_select-without-confirm"--></A>.
29237 </UL>
29238 <P>
29239 &lt;End of help on this topic&gt;
29240 </BODY>
29241 </HTML>
29242 ====== h_config_auto_unselect =====
29243 <HTML>
29244 <HEAD>
29245 <TITLE>FEATURE: <!--#echo var="FEAT_auto-unselect-after-apply"--></TITLE>
29246 </HEAD>
29247 <BODY>
29248 <H1>FEATURE: <!--#echo var="FEAT_auto-unselect-after-apply"--></H1>
29249
29250 This feature affects the behavior of the Apply command.  If set,
29251 the Apply command will do the operation you specify, but then will
29252 implicitly do an &quot;UnSelect All&quot;, so that you will automatically be back in
29253 the normal Index view after the Apply.
29254
29255 <P>
29256 Some related help topics are
29257 <UL>
29258 <LI> <A HREF="h_mainhelp_aggops">Aggregate Operations</A>
29259 <LI> <A HREF="h_index_cmd_select">Selecting: Select and WhereIs/Select</A>,
29260 <LI> <A HREF="h_config_enable_agg_ops"><!--#echo var="FEAT_enable-aggregate-command-set"--></A>,
29261 <LI> <A HREF="h_config_auto_zoom"><!--#echo var="FEAT_auto-zoom-after-select"--></A>, and
29262 <LI> <A HREF="h_config_auto_unzoom"><!--#echo var="FEAT_auto-unzoom-after-apply"--></A>, and
29263 <LI> <A HREF="h_config_select_wo_confirm"><!--#echo var="FEAT_select-without-confirm"--></A>.
29264 </UL>
29265 <P>
29266 &lt;End of help on this topic&gt;
29267 </BODY>
29268 </HTML>
29269 ====== h_config_fast_recent =====
29270 <HTML>
29271 <HEAD>
29272 <TITLE>FEATURE: <!--#echo var="FEAT_enable-fast-recent-test"--></TITLE>
29273 </HEAD>
29274 <BODY>
29275 <H1>FEATURE: <!--#echo var="FEAT_enable-fast-recent-test"--></H1>
29276
29277 This feature controls the behavior of the TAB key when traversing folders
29278 in the optional
29279 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
29280 collection or in optional <!--#echo var="VAR_news-collections"-->.
29281
29282 <P>
29283 When the TAB
29284 (<A HREF="h_common_nextnew">NextNew</A>)
29285 key is pressed, the default behavior is to
29286 explicitly examine the status of the folder for the number of recent
29287 messages (messages delivered since the last time it was viewed).
29288 Depending on the size and number of messages in the folder, this test
29289 can be time consuming.
29290
29291 <P>
29292 Enabling this feature will cause Alpine to only test for the existence of
29293 any recent messages rather than to obtain the count.  This is much faster
29294 in many cases.  The downside is that you're not given the number of recent
29295 messages when prompted to view the next folder.
29296 If the feature
29297 <A HREF="h_config_tab_uses_unseen">&quot;<!--#echo var="FEAT_tab-uses-unseen-for-next-folder"-->&quot;</A>
29298 is turned on, then the present feature will have no effect.
29299
29300 <P>
29301 <UL>
29302 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29303 </UL><P>
29304 &lt;End of help on this topic&gt;
29305 </BODY>
29306 </HTML>
29307 ====== h_config_arrow_nav =====
29308 <HTML>
29309 <HEAD>
29310 <TITLE>FEATURE: <!--#echo var="FEAT_enable-arrow-navigation"--></TITLE>
29311 </HEAD>
29312 <BODY>
29313 <H1>FEATURE: <!--#echo var="FEAT_enable-arrow-navigation"--></H1>
29314
29315 This feature controls the behavior of the left and right arrow keys.
29316 If set, the left and right arrow keys will operate like the usual
29317 navigation keys &lt; and &gt;.
29318 This feature is set by default.
29319
29320 <P>
29321 If you set this feature, and do not like the changed behavior of the up/down
29322 arrow
29323 keys when navigating through the FOLDER LIST screen --
29324 <B>first</B> from column to column, if more than one folder is
29325 displayed per row,
29326 and <B>then</B> from row to row -- you may either also wish to set the feature
29327 &quot;<A HREF="h_config_relaxed_arrow_nav"><!--#echo var="FEAT_enable-arrow-navigation-relaxed"--></A>&quot;,
29328 &quot;<A HREF="h_config_single_list"><!--#echo var="FEAT_single-column-folder-list"--></A>&quot;, or
29329 use the ^P/^N (instead of up/down arrow) keys to move up/down the list of
29330 folders in each column.
29331 <P>
29332 <UL>
29333 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29334 </UL><P>
29335 &lt;End of help on this topic&gt;
29336 </BODY>
29337 </HTML>
29338 ====== h_config_relaxed_arrow_nav =====
29339 <HTML>
29340 <HEAD>
29341 <TITLE>FEATURE: <!--#echo var="FEAT_enable-arrow-navigation-relaxed"--></TITLE>
29342 </HEAD>
29343 <BODY>
29344 <H1>FEATURE: <!--#echo var="FEAT_enable-arrow-navigation-relaxed"--></H1>
29345
29346 This feature controls the behavior of the left, right, up and down
29347 arrow keys in the FOLDER LIST screen when the &quot;<A
29348 HREF="h_config_arrow_nav"><!--#echo var="FEAT_enable-arrow-navigation"--></A>&quot; feature is
29349 set.
29350 This feature is set by default.
29351
29352 <P>
29353
29354 When this feature is set, the left and right
29355 arrow keys in the FOLDER LIST screen
29356 move the highlight bar to the left or right, and the up and
29357 down arrows move it up or down.
29358
29359 <P>
29360 When the &quot;<!--#echo var="FEAT_enable-arrow-navigation"-->&quot; feature is set and this
29361 feature is not set;
29362 the left and right arrow keys in the Folder List screen strictly
29363 track the commands bound to the '&lt;' and '&gt;' keys, and the up
29364 and down arrow keys move the highlight bar to the previous and next
29365 folder or directory name.
29366
29367 <P>
29368 <UL>
29369 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29370 </UL><P>
29371 &lt;End of help on this topic&gt;
29372 </BODY>
29373 </HTML>
29374 ====== h_config_alt_compose_menu =====
29375 <HTML>
29376 <HEAD>
29377 <TITLE>FEATURE: <!--#echo var="FEAT_alternate-compose-menu"--></TITLE>
29378 </HEAD>
29379 <BODY>
29380 <H1>FEATURE: <!--#echo var="FEAT_alternate-compose-menu"--></H1>
29381
29382 This feature controls the menu that is displayed when Compose is selected.
29383 If set, a list of options will be presented, with each option representing
29384 the type of composition that could be used. This feature is most useful for
29385 users who want to avoid being prompted with each option separately, or who
29386 want to avoid the checking of remote postponed or form letter folders.
29387 The possible types of composition are:
29388
29389 <P>
29390 New, for starting a new composition. Note that if New is selected and roles
29391 are set, roles are checked for matches and applied according to the setting
29392 of the matching role.
29393
29394 <P>
29395 Interrupted, for continuing an interrupted composition. This option is only
29396 offered if an interrupted message folder is detected.
29397
29398 <P>
29399 Postponed, for continuing postponed compositions. This option is offered
29400 if a <!--#echo var="VAR_postponed-folder"--> is set in the config REGARDLESS OF whether or not
29401 the postponed folder actually exists. This option is especially handy
29402 for avoiding having to check for the existence of a remote postponed folder.
29403
29404 <P>
29405 Form, for using form letters. This option is offered if the <!--#echo var="VAR_form-letter-folder"-->
29406 is set in the config, and is not checked for existence for reasons similar
29407 to those explained by the postponed option.
29408
29409 <P>
29410 setRole, for selecting a role to apply to a composition.
29411
29412 <P>
29413 &lt;End of help on this topic&gt;
29414 </BODY>
29415 </HTML>
29416 ====== h_config_alt_role_menu =====
29417 <HTML>
29418 <HEAD>
29419 <TITLE>FEATURE: <!--#echo var="FEAT_alternate-role-menu"--></TITLE>
29420 </HEAD>
29421 <BODY>
29422 <H1>FEATURE: <!--#echo var="FEAT_alternate-role-menu"--></H1>
29423
29424 Normally the <A HREF="h_common_role">Role Command</A> allows you to choose
29425 a role and compose a new message using that role.
29426 When this feature is set, the role command will first ask whether you want to
29427 Compose a new message, Forward the current message, Reply to the
29428 current message, or Bounce the current message.
29429 If you are not in the MESSAGE INDEX and are not viewing a message,
29430 then there is no current message and the question will be skipped.
29431 After you have chosen to Compose, Forward, Reply, or Bounce you will
29432 then choose the role to be used.
29433 <P>
29434 When Bouncing the &quot;Set From&quot; address is used for the
29435 Resent-From header, the &quot;Set Fcc&quot; value is used for the Fcc
29436 provided that the option
29437 <A HREF="h_config_fcc_on_bounce">&quot;<!--#echo var="FEAT_fcc-on-bounce"-->&quot;</A> is turned on,
29438 and the &quot;Use SMTP Server&quot; value is used for the SMTP server, if
29439 set.
29440 Other actions of the role are ignored when Bouncing.
29441
29442 <P>
29443 &lt;End of help on this topic&gt;
29444 </BODY>
29445 </HTML>
29446 ====== h_config_always_spell_check =====
29447 <HTML>
29448 <HEAD>
29449 <TITLE>FEATURE: <!--#echo var="FEAT_spell-check-before-sending"--></TITLE>
29450 </HEAD>
29451 <BODY>
29452 <H1>FEATURE: <!--#echo var="FEAT_spell-check-before-sending"--></H1>
29453 <P>
29454 When this feature is set, every composed message will be spell-checked before
29455 being sent.
29456 <P>
29457 &lt;End of help on this topic&gt;
29458 </BODY>
29459 </HTML>
29460 ====== h_config_quell_asterisks =====
29461 <HTML>
29462 <HEAD>
29463 <TITLE>FEATURE: <!--#echo var="FEAT_suppress-asterisks-in-password-prompt"--></TITLE>
29464 </HEAD>
29465 <BODY>
29466 <H1>FEATURE: <!--#echo var="FEAT_suppress-asterisks-in-password-prompt"--></H1>
29467 <P>
29468 When you are running Alpine you will sometimes be asked for a password
29469 in a prompt on the third line from the bottom of the screen.
29470 Normally each password character you type will cause an asterisk to echo
29471 on the screen. That gives you some feedback to know that your typing is
29472 being recognized.
29473 There is a very slight security risk in doing it this way because someone
29474 watching over your shoulder might be able to see how many characters there
29475 are in your password.
29476 If you'd like to suppress the echoing of the asterisks set this feature.
29477 <P>
29478 &lt;End of help on this topic&gt;
29479 </BODY>
29480 </HTML>
29481 ====== h_config_quell_flowed_text =====
29482 <HTML>
29483 <HEAD>
29484 <TITLE>FEATURE: <!--#echo var="FEAT_quell-flowed-text"--></TITLE>
29485 </HEAD>
29486 <BODY>
29487 <H1>FEATURE: <!--#echo var="FEAT_quell-flowed-text"--></H1>
29488 <P>
29489 Alpine generates flowed text where possible.
29490 The method for generating flowed text is defined by
29491 <A HREF="http://www.ietf.org/rfc/rfc3676.txt">RFC 3676</A>,
29492 the benefit of doing so is
29493 to send message text that can properly be viewed both on normal width displays
29494 and on displays with smaller or larger than normal screen widths.
29495 With flowed text, a space at the end of a line tells the receiving mail
29496 client that the following line belongs to the same paragraph.
29497 Quoted text will also be affected, with only the innermost
29498 level of &quot;&gt;&quot; quoting being followed by a space.
29499 However, if you have changed the
29500 <A HREF="h_config_reply_indent_string">&quot;<!--#echo var="VAR_reply-indent-string"-->&quot;</A>
29501 so that it is not equal to the default value of &quot;&gt;&nbsp;&quot;, then
29502 quoted text will not be flowed.
29503 For this reason, we recommend that you leave your
29504 &quot;<!--#echo var="VAR_reply-indent-string"-->&quot; set to the default.
29505 <P>
29506 This feature turns off the generation of flowed text, as it might be
29507 desired to more tightly control how a message is displayed on the receiving end.
29508 <P>
29509 If this feature is <EM>not</EM> set, you can control on a message by message
29510 basis whether or not flowed text is generated.
29511 You do this by typing ^V at the Send confirmation prompt that you get
29512 after typing ^X to send a message.
29513 ^V is a toggle that turns flowing off and back on if typed again.
29514 If for some reason flowing cannot be done on a particular message, then the
29515 ^V command will not be available.
29516 This would be the case, for example, if this feature was set, or if your
29517 &quot;<!--#echo var="VAR_reply-indent-string"-->&quot; was set to a non-default value.
29518 If the feature
29519 <A HREF="h_config_send_wo_confirm">&quot;<!--#echo var="FEAT_send-without-confirm"-->&quot;</A> is set,
29520 then the opportunity to control on a message by message basis
29521 whether or not flowed text is generated is lost.
29522 <P>
29523 When this feature is not set and you have typed ^V to turn off flowing,
29524 the Send confirmation prompt will change to look like
29525 <P>
29526 <CENTER><SAMP>Send message (not flowed)?</SAMP></CENTER>
29527 <P>
29528 <A HREF="h_config_strip_ws_before_send">&quot;<!--#echo var="FEAT_strip-whitespace-before-send"-->&quot;</A> will
29529 also turn off the sending of flowed text messages, but it differs in that
29530 it also trims all trailing white space from a message before sending it.
29531 <P>
29532 If alternate editors are used extensively, be aware that a message will still
29533 be sent flowed if this feature is unset.  In most cases this will be fine,
29534 but if the editor has a &quot;flowed text&quot; mode, it would be best to
29535 use that.
29536 <P>
29537 &lt;End of help on this topic&gt;
29538 </BODY>
29539 </HTML>
29540 ====== h_config_strip_ws_before_send =====
29541 <HTML>
29542 <HEAD>
29543 <TITLE>FEATURE: <!--#echo var="FEAT_strip-whitespace-before-send"--></TITLE>
29544 </HEAD>
29545 <BODY>
29546 <H1>FEATURE: <!--#echo var="FEAT_strip-whitespace-before-send"--></H1>
29547 <P>
29548 By default, trailing whitespace is not stripped from
29549 a message before sending.  Trailing whitespace should have no effect on an
29550 email message, and in flowed text can aid in delimiting paragraphs.
29551 However, the old behavior of stripping trailing whitespace was in place
29552 to better deal with older clients that couldn't handle certain types of
29553 text encodings.  This feature restores the old behavior
29554 <P>
29555 Trailing whitespace is of aid to flowed-text-formatted messages, which are
29556 generated by default but can be turned off via the
29557 <A HREF="h_config_quell_flowed_text">&quot;<!--#echo var="FEAT_quell-flowed-text"-->&quot;</A> feature.
29558 <!--#echo var="FEAT_strip-whitespace-before-send"--> also has the effect of turning off sending
29559 of flowed text.
29560 <P>
29561 &lt;End of help on this topic&gt;
29562 </BODY>
29563 </HTML>
29564 ====== h_config_alt_reply_menu =====
29565 <HTML>
29566 <HEAD>
29567 <TITLE>FEATURE: <!--#echo var="FEAT_alternate-reply-menu"--></TITLE>
29568 </HEAD>
29569 <BODY>
29570 <H1>FEATURE: <!--#echo var="FEAT_alternate-reply-menu"--></H1>
29571
29572 Note that if this option is enabled, then the option
29573 <A HREF="h_config_auto_include_reply"><!--#echo var="FEAT_include-text-in-reply"--></A>
29574 is ignored. See below to understand why.
29575 <P>
29576 When you reply to a message, a series of questions are asked that
29577 determines how your reply will be handled by Alpine. This feature only
29578 affects the result of the first question you are asked, and its purpose is
29579 to set values that could override defaults set in Alpine's main
29580 configuration screen. As a result, this menu allows you to configure even
29581 more features than you would be able to do without this option. For
29582 example, this menu always allows you to override or select a <A
29583 HREF="h_rules_roles">Role</A> if you have defined one, or allows you to
29584 override your indent string, regardless of if you have enabled
29585 <A HREF="h_config_prefix_editing"><!--#echo var="FEAT_enable-reply-indent-string-editing"--></A>.
29586 The full list of options can be found below.
29587 <P>
29588 Here is an example of how this option works. After you press Reply,
29589 if you see &quot;A Inc Attach&quot; in the menu, it means that
29590 if you press &quot;A&quot;, then Alpine will include the attachments
29591 of the original message, and the default is not to include them.
29592 Conversely, if you see &quot;A No Attach&quot;
29593 then by pressing &quot;A&quot; Alpine will not include
29594 attachments in your reply, and the default is that Alpine will
29595 include them in your reply. The value that you see when you
29596 start your reply is controlled by the option
29597 <A HREF="h_config_attach_in_reply">
29598 <!--#echo var="FEAT_include-attachments-in-reply"-->
29599 </A>. If the feature is enabled, then Alpine will display
29600 &quot;A No Attach&quot; to override the default behavior. You can
29601 toggle between the two values of this option by pressing &quot;A&quot;.
29602 Remember that the value that you see in the menu is the action that will
29603 be done when you press the associated command.
29604 <P>
29605 Below are your options:
29606 <OL>
29607 <LI><B>A</B>: This determines if Alpine will include or not the
29608 attachments sent to you in the message that you are replying to. The default
29609 is to use the value of the configuration option
29610 <A HREF="h_config_attach_in_reply"><!--#echo var="FEAT_include-attachments-in-reply"--></A> and can be overriden by using this command.
29611
29612 <LI><B>H</B>: This command determines if the headers of a message are
29613 included in the body of the message that is being replied to. By default
29614 Alpine will use the value of the configuration option
29615 <A HREF="h_config_include_header"><!--#echo var="FEAT_include-header-in-reply"--></A>.
29616 Observe that by toggling this option to include headers, text will be toggled
29617 to be included by default.
29618
29619 <LI><B>R</B>: Can be used to set a role different from the default.
29620
29621 <LI><B>S</B>: Determines if Alpine will strip the signature from a
29622 message. The default is to strip the signature when the message is not
29623 viewed in headers mode, and you either have enabled
29624 <A HREF="h_config_sigdashes"><!--#echo var="FEAT_enable-sigdashes"--></A>
29625 or
29626 <A HREF="h_config_strip_sigdashes"><!--#echo var="FEAT_strip-from-sigdashes-on-reply"--></A>.
29627
29628 <LI><B>Ctrl-R</B>: Can be used to edit the
29629 <A HREF="h_config_reply_indent_string">&quot;<!--#echo var="VAR_reply-indent-string"-->&quot;</A>.
29630 </OL>
29631 <P>
29632 In order to include the text of the original message in the reply
29633 you either need to press 'y' to include the original text, or 'n' to
29634 exclude it from the reply. Pressing return will execute the default
29635 action, which is to include text only if the option
29636 <A HREF="h_config_auto_include_reply"><!--#echo var="FEAT_include-text-in-reply"--></A>
29637 is enabled. However, notice that the default is to include text if you edit the
29638 reply indent string or if you explicitly set through this menu that you
29639 want headers included in the reply message.
29640
29641 <P>
29642 &lt;End of help on this topic&gt;
29643 </BODY>
29644 </HTML>
29645 ====== h_config_del_from_dot =====
29646 <HTML>
29647 <HEAD>
29648 <TITLE>FEATURE: <!--#echo var="FEAT_compose-cut-from-cursor"--></TITLE>
29649 </HEAD>
29650 <BODY>
29651 <H1>FEATURE: <!--#echo var="FEAT_compose-cut-from-cursor"--></H1>
29652
29653 This feature controls the behavior of the Ctrl-K command in the composer.
29654 If set, ^K will cut from the current cursor position to the end of the line,
29655 rather than cutting the entire line.
29656
29657 <P>
29658 &lt;End of help on this topic&gt;
29659 </BODY>
29660 </HTML>
29661 ====== h_config_print_index =====
29662 <HTML>
29663 <HEAD>
29664 <TITLE>FEATURE: <!--#echo var="FEAT_print-index-enabled"--></TITLE>
29665 </HEAD>
29666 <BODY>
29667 <H1>FEATURE: <!--#echo var="FEAT_print-index-enabled"--></H1>
29668
29669 This feature controls the behavior of the Print command when in the
29670 MESSAGE INDEX screen.  If set, the print command will give you a prompt
29671 asking if you wish to print the message index, or the currently highlighted
29672 message. If not set, the message will be printed.
29673
29674 <P>
29675 &lt;End of help on this topic&gt;
29676 </BODY>
29677 </HTML>
29678 ====== h_config_allow_talk =====
29679 <HTML>
29680 <HEAD>
29681 <TITLE>FEATURE: <!--#echo var="FEAT_allow-talk"--></TITLE>
29682 </HEAD>
29683 <BODY>
29684 <H1>FEATURE: <!--#echo var="FEAT_allow-talk"--></H1>
29685
29686 UNIX Alpine only.
29687 <P>
29688 By default, permission for others to &quot;talk&quot; to your terminal is turned
29689 off when you are running Alpine.  When this feature is set, permission is
29690 instead turned on.  If enabled, you may see unexpected messages in the
29691 middle of your Alpine screen from someone attempting to contact you via the
29692 &quot;talk&quot; program.
29693
29694 <P>
29695 NOTE: The &quot;talk&quot; program has nothing to do with Alpine or email.  The
29696 talk daemon on your system will attempt to print a message on your screen
29697 when someone else is trying to contact you.  If you wish to see these
29698 messages while you are running Alpine, you should enable this feature.
29699
29700 <P>
29701 If you do enable this feature and see a &quot;talk&quot; message, you must
29702 suspend or quit Alpine before you can respond.
29703
29704 <P>
29705 &lt;End of help on this topic&gt;
29706 </BODY>
29707 </HTML>
29708 ====== h_config_send_filter_dflt =====
29709 <HTML>
29710 <HEAD>
29711 <TITLE>FEATURE: <!--#echo var="FEAT_compose-send-offers-first-filter"--></TITLE>
29712 </HEAD>
29713 <BODY>
29714 <H1>FEATURE: <!--#echo var="FEAT_compose-send-offers-first-filter"--></H1>
29715 If you have <A HREF="h_config_sending_filter">&quot;<!--#echo var="VAR_sending-filters"-->&quot;</A>
29716 configured, setting this feature will cause
29717 the first filter in the <!--#echo var="VAR_sending-filters"--> list to be offered as the default
29718 instead of unfiltered, the usual default.
29719 <P>
29720 <UL>
29721 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29722 </UL><P>
29723 &lt;End of help on this topic&gt;
29724 </BODY>
29725 </HTML>
29726 ====== h_config_custom_print =====
29727 <HTML>
29728 <HEAD>
29729 <TITLE>FEATURE: <!--#echo var="FEAT_print-offers-custom-cmd-prompt"--></TITLE>
29730 </HEAD>
29731 <BODY>
29732 <H1>FEATURE: <!--#echo var="FEAT_print-offers-custom-cmd-prompt"--></H1>
29733
29734 When this feature is set, the print command will have an additional
29735 subcommand called "C CustomPrint".  If selected, you will have
29736 the opportunity to enter any system print command --instead of being
29737 restricted to using those that have been previously configured in the
29738 printer setup menu.
29739 <P>
29740
29741 &lt;End of help on this topic&gt;
29742 </BODY>
29743 </HTML>
29744 ====== h_config_enable_dot_files =====
29745 <HTML>
29746 <HEAD>
29747 <TITLE>FEATURE: <!--#echo var="FEAT_enable-dot-files"--></TITLE>
29748 </HEAD>
29749 <BODY>
29750 <H1>FEATURE: <!--#echo var="FEAT_enable-dot-files"--></H1>
29751
29752 When this feature is set, files beginning with dot (".") will be
29753 visible in the file browser.  For example, you'll be able to select them
29754 when using the browser to add an attachment to a message.
29755 <P>
29756 &lt;End of help on this topic&gt;
29757 </BODY>
29758 </HTML>
29759 ====== h_config_enable_dot_folders =====
29760 <HTML>
29761 <HEAD>
29762 <TITLE>FEATURE: <!--#echo var="FEAT_enable-dot-folders"--></TITLE>
29763 </HEAD>
29764 <BODY>
29765 <H1>FEATURE: <!--#echo var="FEAT_enable-dot-folders"--></H1>
29766
29767 When this feature is set, folders beginning with dot (".") may be added
29768 and viewed.
29769 <P>
29770 &lt;End of help on this topic&gt;
29771 </BODY>
29772 </HTML>
29773 ====== h_config_ff_between_msgs =====
29774 <HTML>
29775 <HEAD>
29776 <TITLE>FEATURE: <!--#echo var="FEAT_print-formfeed-between-messages"--></TITLE>
29777 </HEAD>
29778 <BODY>
29779 <H1>FEATURE: <!--#echo var="FEAT_print-formfeed-between-messages"--></H1>
29780
29781 Setting this feature causes a formfeed to be printed between messages when
29782 printing multiple messages (with Apply Print command).
29783 <P>
29784 &lt;End of help on this topic&gt;
29785 </BODY>
29786 </HTML>
29787 ====== h_config_blank_keymenu =====
29788 <HTML>
29789 <HEAD>
29790 <TITLE>FEATURE: <!--#echo var="FEAT_disable-keymenu"--></TITLE>
29791 </HEAD>
29792 <BODY>
29793 <H1>FEATURE: <!--#echo var="FEAT_disable-keymenu"--></H1>
29794
29795 If this feature is set the command key menu that normally appears on the
29796 bottom two lines of the screen will not usually be there.  Asking for
29797 help with ^G or ? will cause the key menu to appear instead of causing
29798 the help message to come up.  If you want to actually see the help text,
29799 another ^G or ? will show it to you.  After the key menu has popped
29800 up with the help key it will remain there for an O for Other command but
29801 disappear if any other command is typed.
29802 <P>
29803 &lt;End of help on this topic&gt;
29804 </BODY>
29805 </HTML>
29806 ====== h_config_enable_mouse =====
29807 <HTML>
29808 <HEAD>
29809 <TITLE>FEATURE: <!--#echo var="FEAT_enable-mouse-in-xterm"--></TITLE>
29810 </HEAD>
29811 <BODY>
29812 <H1>FEATURE: <!--#echo var="FEAT_enable-mouse-in-xterm"--></H1>
29813
29814 This feature controls whether or not an X terminal mouse can be used with
29815 Alpine.  If set, and the $DISPLAY variable indicates that an X terminal is
29816 being used, the left mouse button on the mouse can be used to select text
29817 or commands.
29818 Clicking on a command at the bottom of the screen will behave as if you had
29819 typed that command.
29820 Clicking on an index line will move the current message highlight to
29821 that line.
29822 Double-clicking on an index line will view the message.
29823 Double-clicking on a link will view the link.
29824 <P>
29825 This type of mouse support will also work in some terminal emulators which are
29826 not actually X terminals, but which have extra code to support the xterm
29827 style mouse.
29828 For those emulators you not only need to turn this feature on but you also
29829 have to set the $DISPLAY environment variable even though it isn't needed
29830 for your terminal.
29831 That will cause Alpine to think that it is an xterm and to properly interpret the
29832 escape sequences sent by the mouse.
29833 <P>
29834 Note: if this feature is set, the behavior of X terminal cut-and-paste is
29835 also modified.  It is sometimes possible to hold the shift key down while clicking
29836 left or middle mouse buttons for the normal xterm cut/paste operations.
29837 There is also an Alpine command to toggle this mode on or off.
29838 The command is Ctrl-&#92; (Control-backslash).
29839 <P>
29840 &lt;End of help on this topic&gt;
29841 </BODY>
29842 </HTML>
29843 ====== h_config_enable_xterm_newmail =====
29844 <HTML>
29845 <HEAD>
29846 <TITLE>FEATURE: <!--#echo var="FEAT_enable-newmail-in-xterm-icon"--></TITLE>
29847 </HEAD>
29848 <BODY>
29849 <H1>FEATURE: <!--#echo var="FEAT_enable-newmail-in-xterm-icon"--></H1>
29850
29851 This feature controls whether or not Alpine will attempt to announce new
29852 mail arrival when it is running in an X terminal window and that window
29853 is iconified.  If set, and the $DISPLAY variable indicates that an X
29854 terminal is being used, Alpine will send appropriate escape sequences to
29855 the X terminal to modify the label on Alpine's icon to indicate that new
29856 mail has arrived. Alpine will also modify the Alpine window's title to
29857 indicate new mail.
29858 See also <a href="h_config_enable_newmail_short_text"><!--#echo var="FEAT_enable-newmail-short-text-in-icon"--></a>.
29859 <P>
29860 &lt;End of help on this topic&gt;
29861 </BODY></HTML>
29862 ====== h_config_enable_newmail_short_text =====
29863 <HTML>
29864 <HEAD>
29865 <TITLE>FEATURE: <!--#echo var="FEAT_enable-newmail-short-text-in-icon"--></TITLE>
29866 </HEAD>
29867 <BODY>
29868 <H1>FEATURE: <!--#echo var="FEAT_enable-newmail-short-text-in-icon"--></H1>
29869
29870 This feature controls the text to be displayed in an icon in the event
29871 of a new message arrival.  Normally, the message will
29872 be the one that is displayed on the screen.  This feature shortens the
29873 message to a count of the number of new messages in brackets.  This may be
29874 more useful for those who use the window's title bar in the task bar as a
29875 new mail indicator.  This feature is only useful if the
29876 <A HREF="h_config_enable_xterm_newmail"><!--#echo var="FEAT_enable-newmail-in-xterm-icon"--></A>
29877 feature is also set.  Like the <!--#echo var="FEAT_enable-newmail-in-xterm-icon"-->
29878 feature, this feature is only relevant when run in an xterm environment.
29879 <P>
29880 &lt;End of help on this topic&gt;
29881 </BODY></HTML>
29882 ====== h_config_copy_to_to_from =====
29883 <HTML>
29884 <HEAD>
29885 <TITLE>FEATURE: <!--#echo var="FEAT_copy-to-address-to-from-if-it-is-us"--></TITLE>
29886 </HEAD>
29887 <BODY>
29888 <H1>FEATURE: <!--#echo var="FEAT_copy-to-address-to-from-if-it-is-us"--></H1>
29889
29890 This feature affects the From address used when Replying to a message.
29891 It is probably only useful if you have some
29892 <a href="h_config_alt_addresses"><!--#echo var="VAR_alt-addresses"--></a>
29893 defined.
29894 When enabled, it checks to see if any of the addresses in the To or Cc
29895 fields of the message you are replying to is one of your addresses.
29896 If it is, and there is only one of them, then that address is used as
29897 the From address in the message you are composing.
29898 In other words, you will be using a From address that is the same
29899 as the To address that was used to get the mail to you in the first place.
29900
29901 <P>
29902 If a role is being used and it has a From address defined, that From address will
29903 be used rather than the one derived from this feature.
29904
29905 <P>
29906 <UL>
29907 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29908 </UL><P>
29909 &lt;End of help on this topic&gt;
29910 </BODY>
29911 </HTML>
29912 ====== h_config_prefix_editing =====
29913 <HTML>
29914 <HEAD>
29915 <TITLE>FEATURE: <!--#echo var="FEAT_enable-reply-indent-string-editing"--></TITLE>
29916 </HEAD>
29917 <BODY>
29918 <H1>FEATURE: <!--#echo var="FEAT_enable-reply-indent-string-editing"--></H1>
29919
29920 This feature affects the Reply command's &quot;Include original message
29921 in Reply?&quot; prompt.  When enabled, it causes the
29922 &quot;Edit Indent String&quot; sub-command to appear which allows
29923 you to edit the string Alpine would otherwise use to denote included
29924 text from the message being replied to.<P>
29925
29926 Thus, you can change Alpine's default message quote character (usually
29927 an angle bracket) on a per message basis. So you could change your quoted message to
29928 look, for example, like this:<p>
29929
29930 <pre>On Tues, 26 Jan 1999, John Q. Smith wrote:
29931
29932 John: I just wanted to say hello and to congratulate you
29933 John: on a job well done!</pre><p>
29934
29935 The configuration option
29936 <A HREF="h_config_reply_indent_string">&quot;<!--#echo var="VAR_reply-indent-string"-->&quot;</A>
29937 may be used to change what appears as the default string to be edited.
29938 <P>
29939 NOTE: Edited <!--#echo var="VAR_reply-indent-string"--> only apply to the message
29940 currently being replied to.
29941 <P>
29942 If you change your <!--#echo var="VAR_reply-indent-string"-->
29943 so that it is not equal to the default value of &quot;&gt;&nbsp;&quot;, then
29944 quoted text will not be flowed
29945 (<A HREF="h_config_quell_flowed_text">Flowed Text</A>)
29946 when you reply.
29947 For this reason, we recommend that you leave your <!--#echo var="VAR_reply-indent-string"-->
29948 set to the default value.
29949 <P>
29950 <UL>
29951 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29952 </UL><P>
29953 &lt;End of help on this topic&gt;
29954 </BODY>
29955 </HTML>
29956 ====== h_config_enable_search_and_repl =====
29957 <HTML>
29958 <HEAD>
29959 <TITLE>FEATURE: <!--#echo var="FEAT_enable-search-and-replace"--></TITLE>
29960 </HEAD>
29961 <BODY>
29962 <H1>FEATURE: <!--#echo var="FEAT_enable-search-and-replace"--></H1>
29963
29964 This feature modifies the behavior of Alpine's composer.  Setting this
29965 feature causes Alpine to offer the "^R Replace" subcommand, which
29966 allows you to search and replace text strings in a message you are composing,
29967 inside the "^W Where is" command.
29968
29969 <P>
29970
29971 To search and replace text, first enter the text to be replaced at the
29972 "Search: " prompt.  Then, rather than pressing Enter to just search for that
29973 text, press ^R, which turns the prompt into
29974
29975 <P>
29976
29977 Search (to replace):
29978
29979 <P>
29980
29981 and then press Enter.  The cursor will highlight the first occurrence
29982 of the text string you entered, and the prompt will show:
29983
29984 <P>
29985
29986 Replace "<your text string>" with :
29987
29988 <P>
29989
29990 where <your text string> is what you entered at the previous prompt;
29991 here, enter the replacement text.  To only replace the highlighted
29992 occurrence, simply press Enter now; to replace all occurrences in the
29993 message, press ^X (Repl All), then Enter.  You will then be asked to confirm
29994 each replacement.
29995
29996 <P>
29997
29998 The command ^R toggles between "Replace" and "Don't Replace"; its subcommand
29999 ^X toggles between "Replace All" and "Replace One."
30000
30001 <P>
30002
30003 If you previously searched for text in a message, it will be offered for
30004 re-use as part of the prompt, shown in [ ] brackets.
30005
30006 <P>
30007 &lt;End of help on this topic&gt;
30008 </BODY>
30009 </HTML>
30010 ====== h_config_enable_view_attach =====
30011 <HTML>
30012 <HEAD>
30013 <TITLE>FEATURE: <!--#echo var="FEAT_enable-msg-view-attachments"--></TITLE>
30014 </HEAD>
30015 <BODY>
30016 <H1>FEATURE: <!--#echo var="FEAT_enable-msg-view-attachments"--></H1>
30017
30018 This feature modifies the behavior of Alpine's MESSAGE TEXT screen.
30019 Setting this feature causes Alpine to present attachments in boldface.
30020 The first available attachment is displayed in inverse.  This is the
30021 "selected" attachment.  Pressing RETURN will cause Alpine to display
30022 the selected attachment.  Use the arrow keys to change which of the
30023 attachments displayed in boldface is the current selection.
30024
30025 <P>
30026
30027 Speaking of arrow keys, the Up and Down Arrows will select the next
30028 and previous attachments if one is available on the screen for selection.
30029 Otherwise, they will simply adjust the viewed text one line up or down.
30030
30031 <P>
30032
30033 Similarly, when selectable items are present in a message, the Ctrl-F key
30034 can be used to select the next item in the message independent of which
30035 portion of the viewed message is currently displayed. The Ctrl-B key can
30036 be used to select the previous item in the same way.
30037 <P>
30038 &lt;End of help on this topic&gt;
30039 </BODY>
30040 </HTML>
30041 ====== h_config_enable_y_print =====
30042 <HTML>
30043 <HEAD>
30044 <TITLE>FEATURE: <!--#echo var="FEAT_enable-print-via-y-command"--></TITLE>
30045 </HEAD>
30046 <BODY>
30047 <H1>FEATURE: <!--#echo var="FEAT_enable-print-via-y-command"--></H1>
30048
30049 This feature modifies the behavior of Alpine's Print command.
30050 <P>
30051 By default, Alpine's print command is available by pressing the "%" key.
30052 (This command is a substantial change from Pine versions before 4.00 --
30053 where the print command was "Y" -- based on numerous complaints about
30054 printing being invoked inadvertently, since Y also means "Yes.")
30055
30056 <P>
30057
30058 This feature is supplied to mitigate any disruption or anxiety users
30059 might feel as a result of this change.
30060
30061 <P>
30062
30063 Enabling this feature will cause Alpine to recognize both the old
30064 command, "Y" for Prynt, as well the new "%" method for invoking
30065 printing.  Note, key menu labels are not changed as a result of
30066 enabling this feature.
30067
30068 <P>
30069
30070 &lt;End of help on this topic&gt;
30071 </BODY>
30072 </HTML>
30073 ====== h_config_enable_lessthan_exit =====
30074 <HTML>
30075 <HEAD>
30076 <TITLE>FEATURE: <!--#echo var="FEAT_enable-exit-via-lessthan-command"--></TITLE>
30077 </HEAD>
30078 <BODY>
30079 <H1>FEATURE: <!--#echo var="FEAT_enable-exit-via-lessthan-command"--></H1>
30080
30081 If this feature is set, then on screens where there is an Exit command
30082 but no < command, the < key will perform the same function as the Exit
30083 command.
30084 This feature is set by default.
30085 <P>
30086 &lt;End of help on this topic&gt;
30087 </BODY>
30088 </HTML>
30089 ====== h_config_enable_view_url =====
30090 <HTML>
30091 <HEAD>
30092 <TITLE>FEATURE: <!--#echo var="FEAT_enable-msg-view-urls"--></TITLE>
30093 </HEAD>
30094 <BODY>
30095 <H1>FEATURE: <!--#echo var="FEAT_enable-msg-view-urls"--></H1>
30096 This feature modifies the behavior of Alpine's MESSAGE TEXT screen.
30097 When this feature is set (the default) Alpine will select possible URLs from the
30098 displayed text and display them in boldface for selection.
30099 <P>
30100 The first available URL is displayed in inverse.  This is the
30101 &quot;selected&quot; URL.  Pressing RETURN will cause Alpine to display
30102 the selected URL via either built-in means as with mailto:, imap:,
30103 news:, and nntp:, or via an external application as defined
30104 by the <A HREF="h_config_browser">&quot;url-viewer&quot;</A>
30105 variable.
30106 <P>
30107 Use the arrow keys to change which of the URLs displayed in boldface
30108 is the current selection.
30109 <P>
30110 Speaking of arrow keys, the Up and Down Arrows will select the next
30111 and previous URL if one is available on the screen for selection (unless
30112 you have set the feature
30113 <A HREF="h_config_enable_view_arrows">&quot;<!--#echo var="FEAT_enable-msg-view-forced-arrows"-->&quot;</A>).
30114 Otherwise, they will simply adjust the viewed text one line up or down.
30115 <P>
30116 Similarly, when selectable items are present in a message, the Ctrl-F
30117 key can be used to select the next item in the message independent
30118 of which portion of the viewed message is currently displayed. The
30119 Ctrl-B key can be used to select the previous item in the same way.
30120 <P>
30121 <UL>
30122 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30123 </UL><P>
30124 &lt;End of help on this topic&gt;
30125 </BODY>
30126 </HTML>
30127 ====== h_config_enable_view_web_host =====
30128 <HTML>
30129 <HEAD>
30130 <TITLE>FEATURE: <!--#echo var="FEAT_enable-msg-view-web-hostnames"--></TITLE>
30131 </HEAD>
30132 <BODY>
30133 <H1>FEATURE: <!--#echo var="FEAT_enable-msg-view-web-hostnames"--></H1>
30134
30135 This feature modifies the behavior of Alpine's MESSAGE TEXT screen.
30136 When this feature is set (the default) Alpine will select possible web hostnames
30137 from the displayed text and display them in boldface for selection.
30138 This can be useful when you receive messages referencing World Wide Web
30139 sites without the use of complete URLs; for example, specifying only
30140 &quot;www.patches.freeiz.com/alpine/&quot; (which will <B>not</B> become a
30141 selectable
30142 item by setting <A HREF="h_config_enable_view_url">&quot;<!--#echo var="FEAT_enable-msg-view-urls"-->&quot;</A>)
30143 rather than explicitly
30144 &quot;http://www.patches.freeiz.com/alpine/&quot;.
30145 <P>
30146 The first available hostname is displayed in inverse.  This is the
30147 &quot;selected&quot; hostname.  Pressing RETURN will cause Alpine to display
30148 the selected hostname via an external application as defined
30149 by the <A HREF="h_config_browser">&quot;url-viewer&quot;</A>
30150 variable.
30151 <P>
30152 Use the arrow keys (unless you have set the feature
30153 <A HREF="h_config_enable_view_arrows">&quot;<!--#echo var="FEAT_enable-msg-view-forced-arrows"-->&quot;</A>)
30154 to change which of the hostnames displayed in
30155 boldface is the current selection.
30156 <P>
30157 Similarly, when selectable web hostnames are present in a message, the Ctrl-F
30158 key can be used to select the next web hostname in the message independent
30159 of which portion of the viewed message is currently displayed. The
30160 Ctrl-B key can be used to select the previous web hostnames in the same way.
30161 <P>
30162 <UL>
30163 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30164 </UL><P>
30165 &lt;End of help on this topic&gt;
30166 </BODY>
30167 </HTML>
30168 ====== h_config_enable_view_addresses =====
30169 <HTML>
30170 <HEAD>
30171 <TITLE>FEATURE: <!--#echo var="FEAT_enable-msg-view-addresses"--></TITLE>
30172 </HEAD>
30173 <BODY>
30174 <H1>FEATURE: <!--#echo var="FEAT_enable-msg-view-addresses"--></H1>
30175
30176 This feature modifies the behavior of Alpine's MESSAGE TEXT screen.
30177 Setting this feature causes Alpine to select possible email addresses
30178 from the displayed text and display them in boldface for selection.
30179
30180 <P>
30181 The first available email address is displayed in inverse.  This is the
30182 &quot;selected&quot; address.  Pressing RETURN will cause Alpine to enter
30183 the message composition screen with the To: field filled in with the
30184 selected address.
30185 <P>
30186 Use the arrow keys (unless you have set the feature
30187 <A HREF="h_config_enable_view_arrows">&quot;<!--#echo var="FEAT_enable-msg-view-forced-arrows"-->&quot;</A>)
30188 to change which of the hostnames displayed in
30189 boldface is the current selection.
30190 <P>
30191 Similarly, when selectable web hostnames are present in a message, the Ctrl-F
30192 key can be used to select the next web hostname in the message independent
30193 of which portion of the viewed message is currently displayed. The
30194 Ctrl-B key can be used to select the previous web hostnames in the same way.
30195 <P>
30196 <UL>
30197 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30198 </UL><P>
30199 &lt;End of help on this topic&gt;
30200 </BODY>
30201 </HTML>
30202 ====== h_config_enable_view_arrows =====
30203 <HTML>
30204 <HEAD>
30205 <TITLE>FEATURE: <!--#echo var="FEAT_enable-msg-view-forced-arrows"--></TITLE>
30206 </HEAD>
30207 <BODY>
30208 <H1>FEATURE: <!--#echo var="FEAT_enable-msg-view-forced-arrows"--></H1>
30209
30210 This feature modifies Up and Down arrow key behavior in Alpine's
30211 MESSAGE TEXT screen when selectable Attachments, URL's, or
30212 web-hostnames are presented. Alpine's usual behavior is to move to
30213 the next or previous selectable item if currently displayed or
30214 simply to adjust the screen view by one line.
30215
30216 <P>
30217
30218 Setting this feature causes the UP and Down arrow key to behave as
30219 if no selectable items were present in the message.
30220
30221 <P>
30222
30223 Note, the Ctrl-F (next selectable item) and Ctrl-B (previous selectable
30224 item) functionality is unchanged.
30225 <P>
30226
30227 &lt;End of help on this topic&gt;
30228 </BODY>
30229 <HTML>
30230 ====== h_config_quell_charset_warning =====
30231 <HTML>
30232 <HEAD>
30233 <TITLE>FEATURE: <!--#echo var="FEAT_quell-charset-warning"--></TITLE>
30234 </HEAD>
30235 <BODY>
30236 <H1>FEATURE: <!--#echo var="FEAT_quell-charset-warning"--></H1>
30237
30238 By default, if the message you are viewing contains characters that are
30239 not representable in your
30240 <A HREF="h_config_char_set">&quot;Display Character Set&quot;</A>
30241 then Alpine will
30242 add a warning to the start of the displayed text.
30243 If this option is set, then that editorial message will be suppressed.
30244 <P>
30245 Setting this feature also suppresses the comment about the character set
30246 in header lines.
30247 For example, when viewing a message you might see
30248 <P>
30249 <CENTER><SAMP>From: &quot;[ISO-8859-2] Name&quot; &lt;address&gt;</SAMP></CENTER>
30250 <P>
30251 in the From header if your Character-Set is something other than ISO-8859-2.
30252 If you set this feature, the comment about the character set will
30253 no longer be there.
30254 <P>
30255 &lt;End of help on this topic&gt;
30256 </BODY>
30257 </HTML>
30258 ====== h_config_quell_host_after_url =====
30259 <HTML>
30260 <HEAD>
30261 <TITLE>FEATURE: <!--#echo var="FEAT_quell-server-after-link-in-html"--></TITLE>
30262 </HEAD>
30263 <BODY>
30264 <H1>FEATURE: <!--#echo var="FEAT_quell-server-after-link-in-html"--></H1>
30265
30266 By default, links in HTML text are displayed with the host the link
30267 references appended, within square brackets, to the link text.  Alpine
30268 does this to help indicate where a link will take you, particularly when
30269 the link text might suggest a different destination.
30270
30271 <P>
30272 Setting this feature will prevent the server name from being appended
30273 to the displayed text.
30274
30275 <P>
30276 &lt;End of help on this topic&gt;
30277 </BODY>
30278 </HTML>
30279 ====== h_config_prefer_plain_text =====
30280 <HTML>
30281 <HEAD>
30282 <TITLE>FEATURE: <!--#echo var="FEAT_prefer-plain-text"--></TITLE>
30283 </HEAD>
30284 <BODY>
30285 <H1>FEATURE: <!--#echo var="FEAT_prefer-plain-text"--></H1>
30286
30287 A message being viewed may contain alternate versions of the same content.
30288 Those alternate versions are supposed to be ordered by the sending software such that the
30289 first alternative is the least preferred and the last alternative is the
30290 most preferred. Alpine will normally display the most-preferred version that
30291 it knows how to display. This is most often encountered where the two
30292 alternate versions are a plain text version and an HTML version, with the
30293 HTML version listed last as the most preferred.
30294 <P>
30295 If this option is set, then any plain text version will be preferred to
30296 all other versions.
30297 <P>
30298 When viewing a message there is a command &quot;A TogglePreferPlain&quot;,
30299 which will temporarily change the sense of this option.
30300 If this option is set you will first see the plain text version of a
30301 message.
30302 If you then type the &quot;A&quot; command, you will see the most preferred version,
30303 most likely HTML, instead.
30304 Typing the &quot;A&quot; command a second time will switch it back.
30305 Alternatively, if the present option is not set you will originally see
30306 the most preferred version of the message and typing &quot;A&quot; will switch to
30307 the plain text version.
30308 <P>
30309 &lt;End of help on this topic&gt;
30310 </BODY>
30311 </HTML>
30312 ====== h_config_pass_control =====
30313 <HTML>
30314 <HEAD>
30315 <TITLE>FEATURE: <!--#echo var="FEAT_pass-control-characters-as-is"--></TITLE>
30316 </HEAD>
30317 <BODY>
30318 <H1>FEATURE: <!--#echo var="FEAT_pass-control-characters-as-is"--></H1>
30319
30320 It is probably not useful to set this option.
30321 This is a legacy option left behind &quot;just in case&quot;.
30322 Multi-byte characters that have an octet that has the same
30323 value as a control character are permitted through whether or not
30324 this option is turned on.
30325 <P>
30326 This feature controls how certain characters contained in messages are
30327 displayed.
30328 If set, all characters in a message will be sent to the
30329 screen. Normally, control characters are displayed as shown below to
30330 avoid a garbled screen and to
30331 avoid inadvertently changing terminal setup parameters.
30332 Control characters are usually displayed as two character sequences like
30333 <P><CENTER><SAMP> ^C </SAMP></CENTER><P>
30334 for Control-C,
30335 <P><CENTER><SAMP> ^[ </SAMP></CENTER><P>
30336 for ESCAPE,
30337 <P><CENTER><SAMP> ^? </SAMP></CENTER><P>
30338 for DELETE, and
30339 <P><CENTER><SAMP> ~E </SAMP></CENTER><P>
30340 for the character with value 133 (0x85).
30341 (The DEL character is displayed as ^?, regular control characters are displayed
30342 as the character ^ followed by the character obtained by adding the
30343 five low-order bits of the character to 0x40, and the C1
30344 control characters 0x80 - 0x9F are displayed as the character ~ followed by the
30345 character obtained by adding the
30346 five low-order bits of the character to 0x40.)
30347 Sometimes, in cases where changing a single control character into a
30348 two-character sequence would confuse Alpine's display routines,
30349 a question mark is substituted for the control character.
30350 <P>
30351 If you wish to filter out regular control characters but pass the
30352 so-called C1 control characters (0x80 <= char < 0xA0) through unchanged, then
30353 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.
30354 <P>
30355 &lt;End of help on this topic&gt;
30356 </BODY>
30357 </HTML>
30358 ====== h_config_pass_c1_control =====
30359 <HTML>
30360 <HEAD>
30361 <TITLE>FEATURE: <!--#echo var="FEAT_pass-c1-control-characters-as-is"--></TITLE>
30362 </HEAD>
30363 <BODY>
30364 <H1>FEATURE: <!--#echo var="FEAT_pass-c1-control-characters-as-is"--></H1>
30365
30366 It is probably not useful to set this option.
30367 This is a legacy option left behind &quot;just in case&quot;.
30368 Multi-byte characters that have an octet that has the same
30369 value as a control character are permitted through whether or not
30370 this option is turned on.
30371 <P>
30372 If the feature <A HREF="h_config_pass_control"><!--#echo var="FEAT_pass-control-characters-as-is"--></A>
30373 is set, then this feature has no effect.
30374 However, if you wish to filter out regular control characters but pass the
30375 so-called C1 control characters (0x80 <= char < 0xA0) through unchanged, then
30376 you may leave <A HREF="h_config_pass_control"><!--#echo var="FEAT_pass-control-characters-as-is"--></A>
30377 unset and set this feature.
30378 <P>
30379 &lt;End of help on this topic&gt;
30380 </BODY>
30381 </HTML>
30382 ====== h_config_fcc_on_bounce =====
30383 <HTML>
30384 <HEAD>
30385 <TITLE>FEATURE: <!--#echo var="FEAT_fcc-on-bounce"--></TITLE>
30386 </HEAD>
30387 <BODY>
30388 <H1>FEATURE: <!--#echo var="FEAT_fcc-on-bounce"--></H1>
30389
30390 This feature controls an aspect of Alpine's behavior when bouncing a
30391 message. If set, normal FCC ("File Carbon Copy") processing will be
30392 done, just as if you had composed a message to the address you are
30393 bouncing to.  If not set, no FCC of the message will be saved.
30394 <P>
30395 &lt;End of help on this topic&gt;
30396 </BODY>
30397 </HTML>
30398 ====== h_config_show_cursor =====
30399 <HTML>
30400 <HEAD>
30401 <TITLE>FEATURE: <!--#echo var="FEAT_show-cursor"--></TITLE>
30402 </HEAD>
30403 <BODY>
30404 <H1>FEATURE: <!--#echo var="FEAT_show-cursor"--></H1>
30405
30406 This feature controls an aspect of Alpine's displays.  If set, the system
30407 cursor will move to convenient locations in the displays.  For example,
30408 to the beginning of the status field of the highlighted index line, or
30409 to the highlighted word after a successful WhereIs command.  It is intended
30410 to draw your attention to an "interesting" spot on the screen.
30411 <P>
30412 &lt;End of help on this topic&gt;
30413 </BODY>
30414 </HTML>
30415 ====== h_config_sort_fcc_alpha =====
30416 <HTML>
30417 <HEAD>
30418 <TITLE>FEATURE: <!--#echo var="FEAT_sort-default-fcc-alpha"--></TITLE>
30419 </HEAD>
30420 <BODY>
30421 <H1>FEATURE: <!--#echo var="FEAT_sort-default-fcc-alpha"--></H1>
30422
30423 This feature controls an aspect of Alpine's FOLDER LIST screen.
30424 If set, the default Fcc folder will be sorted alphabetically with the other
30425 folders instead of appearing right after the INBOX.
30426 <P>
30427 &lt;End of help on this topic&gt;
30428 </BODY>
30429 </HTML>
30430 ====== h_config_sort_save_alpha =====
30431 <HTML>
30432 <HEAD>
30433 <TITLE>FEATURE: <!--#echo var="FEAT_sort-default-save-alpha"--></TITLE>
30434 </HEAD>
30435 <BODY>
30436 <H1>FEATURE: <!--#echo var="FEAT_sort-default-save-alpha"--></H1>
30437
30438 This feature controls an aspect of Alpine's FOLDER LIST screen.
30439 If set, the default save folder will be sorted alphabetically with the other
30440 folders instead of appearing right after the INBOX (and default FCC folder).
30441 <P>
30442 &lt;End of help on this topic&gt;
30443 </BODY>
30444 </HTML>
30445 ====== h_config_single_list =====
30446 <HTML>
30447 <HEAD>
30448 <TITLE>FEATURE: <!--#echo var="FEAT_single-column-folder-list"--></TITLE>
30449 </HEAD>
30450 <BODY>
30451 <H1>FEATURE: <!--#echo var="FEAT_single-column-folder-list"--></H1>
30452
30453 This feature controls an aspect of Alpine's FOLDER LIST screen.  If set,
30454 the folders will be listed one per line instead of several per line
30455 in the FOLDER LIST display.
30456 <P>
30457 &lt;End of help on this topic&gt;
30458 </BODY>
30459 </HTML>
30460 ====== h_config_vertical_list =====
30461 <HTML>
30462 <HEAD>
30463 <TITLE>FEATURE: <!--#echo var="FEAT_vertical-folder-list"--></TITLE>
30464 </HEAD>
30465 <BODY>
30466 <H1>FEATURE: <!--#echo var="FEAT_vertical-folder-list"--></H1>
30467
30468 This feature controls an aspect of Alpine's FOLDER LIST screen.  If set,
30469 the folders will be listed alphabetically down the columns rather
30470 than across the columns as is the default.
30471 <P>
30472 &lt;End of help on this topic&gt;
30473 </BODY>
30474 </HTML>
30475 ====== h_config_verbose_post =====
30476 <HTML>
30477 <HEAD>
30478 <TITLE>FEATURE: <!--#echo var="FEAT_enable-verbose-smtp-posting"--></TITLE>
30479 </HEAD>
30480 <BODY>
30481 <H1>FEATURE: <!--#echo var="FEAT_enable-verbose-smtp-posting"--></H1>
30482 This feature controls an aspect of Alpine's message sending.  When enabled,
30483 Alpine will send a VERB (i.e., VERBose) command early in the posting process
30484 intended to cause the SMTP server to provide a more detailed account of
30485 the transaction.  This feature is typically only useful to system
30486 administrators and other support personel as an aid in troublshooting
30487 problems.
30488 <P>
30489 Note, this feature relies on a specific capability of the system's mail
30490 transport agent or configured
30491 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>.
30492 It is possible that this
30493 feature will cause problems for some tranport agents, and may result in
30494 sending failure.  In addition, as the verbose output comes from the mail
30495 transport agent, it is likely to vary from one system to another.
30496 <P><UL>
30497 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30498 </UL><P>
30499 &lt;End of help on this topic&gt;
30500 </BODY>
30501 </HTML>
30502 ====== h_config_auto_reply_to =====
30503 <HTML>
30504 <HEAD>
30505 <TITLE>FEATURE: <!--#echo var="FEAT_reply-always-uses-reply-to"--></TITLE>
30506 </HEAD>
30507 <BODY>
30508 <H1>FEATURE: <!--#echo var="FEAT_reply-always-uses-reply-to"--></H1>
30509
30510 This feature controls an aspect of Alpine's Reply command.  If set, Alpine
30511 will not prompt when a message being replied to contains a "Reply-To:"
30512 header value, but will simply use its value (as opposed to using the
30513 "From:" field's value).
30514
30515 <P>
30516
30517 Note: Using the "Reply-To:" address is usually the preferred behavior,
30518 however, some mailing list managers choose to place the list's address in
30519 the "Reply-To:" field of any message sent out to the list.  In such
30520 cases, this feature makes it all too easy for personal replies to be
30521 inadvertently sent to the entire mail list, so be careful!
30522 <P>
30523 &lt;End of help on this topic&gt;
30524 </BODY>
30525 </HTML>
30526 ====== h_config_del_skips_del =====
30527 <HTML>
30528 <HEAD>
30529 <TITLE>FEATURE: <!--#echo var="FEAT_delete-skips-deleted"--></TITLE>
30530 </HEAD>
30531 <BODY>
30532 <H1>FEATURE: <!--#echo var="FEAT_delete-skips-deleted"--></H1>
30533
30534 This feature controls an aspect of Alpine's Delete command.  If set, this
30535 feature will cause the Delete command to advance past following messages that
30536 are marked deleted.  In other words, pressing "D" will both mark the
30537 current message deleted and advance to the next message that is not marked
30538 deleted.
30539 This feature is set by default.
30540 <P>
30541 &lt;End of help on this topic&gt;
30542 </BODY></HTML>
30543 ====== h_config_expunge_manually =====
30544 <HTML>
30545 <HEAD>
30546 <TITLE>FEATURE: <!--#echo var="FEAT_expunge-only-manually"--></TITLE>
30547 </HEAD>
30548 <BODY>
30549 <H1>FEATURE: <!--#echo var="FEAT_expunge-only-manually"--></H1>
30550
30551 Normally, when you close a folder that contains deleted messages you are
30552 asked if you want to expunge those messages from the folder permanently.
30553 If this feature is set, you won't be asked and the deleted messages will
30554 remain in the folder.
30555 If you choose to set this feature you will have to expunge the
30556 messages manually using the eXpunge command, which you can use while
30557 in the MESSAGE INDEX screen.
30558 If you do not expunge deleted messages the size of your
30559 folder will continue to increase until you are out of disk space.
30560 <P>
30561 <UL>
30562 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30563 </UL><P>
30564 &lt;End of help on this topic&gt;
30565 </BODY>
30566 </HTML>
30567 ====== h_config_auto_expunge =====
30568 <HTML>
30569 <HEAD>
30570 <TITLE>FEATURE: <!--#echo var="FEAT_expunge-without-confirm"--></TITLE>
30571 </HEAD>
30572 <BODY>
30573 <H1>FEATURE: <!--#echo var="FEAT_expunge-without-confirm"--></H1>
30574
30575 This features controls an aspect of Alpine's eXpunge command.  If set, you
30576 will <B>not</B> be prompted to confirm your intent before the expunge takes
30577 place.
30578 Actually, this is only true for the INBOX folder and for folders in the
30579 Incoming Folders collection. See the feature
30580 <A HREF="h_config_full_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm-everywhere"-->&quot;</A>.
30581 <P>
30582 <UL>
30583 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30584 </UL><P>
30585 &lt;End of help on this topic&gt;
30586 </BODY>
30587 </HTML>
30588 ====== h_config_full_auto_expunge =====
30589 <HTML>
30590 <HEAD>
30591 <TITLE>FEATURE: <!--#echo var="FEAT_expunge-without-confirm-everywhere"--></TITLE>
30592 </HEAD>
30593 <BODY>
30594 <H1>FEATURE: <!--#echo var="FEAT_expunge-without-confirm-everywhere"--></H1>
30595
30596 This features controls an aspect of Alpine's eXpunge command.  If set, you
30597 will <B>not</B> be prompted to confirm your intent before the expunge
30598 takes place.  This feature sets this behavior for all folders, unlike the
30599 <A HREF="h_config_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm"-->&quot;</A>
30600 feature that works only for incoming folders.
30601 <P>
30602 <UL>
30603 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30604 </UL><P>
30605 &lt;End of help on this topic&gt;
30606 </BODY>
30607 </HTML>
30608 ====== h_config_auto_read_msgs =====
30609 <HTML>
30610 <HEAD>
30611 <TITLE>FEATURE: <!--#echo var="FEAT_auto-move-read-msgs"--></TITLE>
30612 </HEAD>
30613 <BODY>
30614 <H1>FEATURE: <!--#echo var="FEAT_auto-move-read-msgs"--></H1>
30615 This feature controls an aspect of Alpine's behavior upon quitting.  If set,
30616 and the
30617 <A HREF="h_config_read_message_folder">&quot;<!--#echo var="VAR_read-message-folder"-->&quot;</A>
30618 option is also set, then Alpine will
30619 automatically transfer all read messages to the designated folder and mark
30620 them as deleted in the INBOX.  Messages in the INBOX marked with an
30621 &quot;N&quot; (meaning New, or unseen) are not affected.
30622 <P>
30623 <UL>
30624 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30625 </UL><P>
30626 &lt;End of help on this topic&gt;
30627 </BODY>
30628 </HTML>
30629 ====== h_config_auto_fcc_only =====
30630 <HTML>
30631 <HEAD>
30632 <TITLE>FEATURE: <!--#echo var="FEAT_fcc-only-without-confirm"--></TITLE>
30633 </HEAD>
30634 <BODY>
30635 <H1>FEATURE: <!--#echo var="FEAT_fcc-only-without-confirm"--></H1>
30636 This features controls an aspect of Alpine's composer.
30637 The only time this feature will be used is if you attempt to send mail
30638 that has no recipients but does have an Fcc.
30639 Normally, Alpine will ask if you really mean to copy the message only to
30640 the Fcc.
30641 That is, it asks if you really meant to have no recipients.
30642 If this feature is set, you
30643 will <B>not</B> be prompted to confirm your intent to make only a copy
30644 of a message with no recipients.
30645 <P>
30646 This feature is closely related to
30647 <A HREF="h_config_warn_if_no_to_or_cc"><!--#echo var="FEAT_warn-if-blank-to-and-cc-and-newsgroups"--></A>.
30648 The difference between this feature and that feature is that this feature
30649 considers a Bcc to be a recipient while that feature will ask for confirmation
30650 even if there is a Bcc when there is no To, Cc, or Newsgroup.
30651 The default values also differ. This feature defaults to asking the question
30652 and you have to turn it off.
30653 The <!--#echo var="FEAT_warn-if-blank-to-and-cc-and-newsgroups"--> feature defaults to not asking
30654 unless you turn it on.
30655 <P>
30656
30657 <UL>
30658 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30659 </UL><P>
30660 &lt;End of help on this topic&gt;
30661 </BODY>
30662 </HTML>
30663 ====== h_config_mark_fcc_seen =====
30664 <HTML>
30665 <HEAD>
30666 <TITLE>FEATURE: <!--#echo var="FEAT_mark-fcc-seen"--></TITLE>
30667 </HEAD>
30668 <BODY>
30669 <H1>FEATURE: <!--#echo var="FEAT_mark-fcc-seen"--></H1>
30670
30671 This features controls the way Fccs (File carbon copies) are
30672 made of the messages you send.
30673
30674 <P>
30675 Normally, when Alpine saves a copy of a message you sent as an Fcc, that
30676 copy will be marked as Unseen.
30677 When you look at the folder it was saved in the message will appear to
30678 be a New message until you read it.
30679 When this feature is enabled, the message will be marked as having
30680 been Seen.
30681
30682 <P>
30683 <UL>
30684 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30685 </UL><P>
30686 &lt;End of help on this topic&gt;
30687 </BODY>
30688 </HTML>
30689 ====== h_config_no_fcc_attach =====
30690 <HTML>
30691 <HEAD>
30692 <TITLE>FEATURE: <!--#echo var="FEAT_fcc-without-attachments"--></TITLE>
30693 </HEAD>
30694 <BODY>
30695 <H1>FEATURE: <!--#echo var="FEAT_fcc-without-attachments"--></H1>
30696
30697 This features controls the way Fcc's (File carbon copies) are
30698 made of the messages you send.
30699
30700 <P>
30701 Normally, Alpine saves an exact copy of your message as it was sent.
30702 When this feature is enabled, the &quot;body&quot; of the message
30703 you send (the text you type in the composer) is preserved in the
30704 copy as before, however all attachments are replaced with text
30705 explaining what had been sent rather than the attachments themselves.
30706
30707 <P>
30708 This feature also affects Alpine's &quot;Send ?&quot; confirmation prompt
30709 in that a new &quot;^F Fcc Attchmnts&quot; option becomes available which
30710 allows you to interactively set whether or not attachments are saved
30711 to the Fcc'd copy.
30712
30713 <P>
30714 <UL>
30715 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30716 </UL><P>
30717 &lt;End of help on this topic&gt;
30718 </BODY>
30719 </HTML>
30720 ====== h_config_read_in_newsrc_order =====
30721 <HTML>
30722 <HEAD>
30723 <TITLE>FEATURE: <!--#echo var="FEAT_news-read-in-newsrc-order"--></TITLE>
30724 </HEAD>
30725 <BODY>
30726 <H1>FEATURE: <!--#echo var="FEAT_news-read-in-newsrc-order"--></H1>
30727
30728 This feature controls the order in which newsgroups will be presented.  If
30729 set, they will be presented in the same order as they occur in your
30730 <!--chtml if pinemode="os_windows"-->
30731 &quot;NEWSRC&quot;
30732 <!--chtml else-->
30733 &quot;.newsrc&quot;
30734 <!--chtml endif-->
30735 file (the default location of which can be changed with the
30736 <A HREF="h_config_newsrc_path">&quot;<!--#echo var="VAR_newsrc-path"-->&quot;</A> option).
30737 <P>
30738 If not set, the newsgroups will be presented in alphabetical order.
30739 <P>
30740 <UL>
30741 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30742 </UL><P>
30743 &lt;End of help on this topic&gt;
30744 </BODY>
30745 </HTML>
30746 ====== h_config_quell_tz_comment =====
30747 <HTML>
30748 <HEAD>
30749 <TITLE>FEATURE: <!--#echo var="FEAT_quell-timezone-comment-when-sending"--></TITLE>
30750 </HEAD>
30751 <BODY>
30752 <H1>FEATURE: <!--#echo var="FEAT_quell-timezone-comment-when-sending"--></H1>
30753
30754 Normally, when Alpine generates a Date header for outgoing mail,
30755 it will try to include the symbolic timezone at the end of the
30756 header inside parentheses.
30757 The symbolic timezone is often three characters long, but on
30758 some operating systems, it may be longer.
30759 Apparently there are some SMTP servers in the world that will reject an
30760 incoming message if it has a Date header longer than about 80 characters.
30761 If this feature is set, the symbolic timezone normally generated by
30762 Alpine will not be included.
30763 You probably don't need to worry about this feature unless you run into
30764 the problem described above.
30765
30766 <P>
30767 &lt;End of help on this topic&gt;
30768 </BODY>
30769 </HTML>
30770 ====== h_config_post_wo_validation =====
30771 <HTML>
30772 <HEAD>
30773 <TITLE>FEATURE: <!--#echo var="FEAT_news-post-without-validation"--></TITLE>
30774 </HEAD>
30775 <BODY>
30776 <H1>FEATURE: <!--#echo var="FEAT_news-post-without-validation"--></H1>
30777
30778 This feature controls whether the NNTP server is queried as newsgroups
30779 are entered for posting.  Validation over slow links (e.g. dialup using
30780 SLIP or PPP) can cause delays.  Set this feature to eliminate such delays.
30781 <P>
30782 &lt;End of help on this topic&gt;
30783 </BODY>
30784 </HTML>
30785 ====== h_config_send_wo_confirm =====
30786 <HTML>
30787 <HEAD>
30788 <TITLE>FEATURE: <!--#echo var="FEAT_send-without-confirm"--></TITLE>
30789 </HEAD>
30790 <BODY>
30791 <H1>FEATURE: <!--#echo var="FEAT_send-without-confirm"--></H1>
30792
30793 By default, when you send or post a message you will be asked to confirm
30794 with a question that looks something like:
30795
30796 <P>
30797 <CENTER><SAMP>Send message?</SAMP></CENTER>
30798 <P>
30799
30800 If this feature is set, you
30801 will <B>not</B> be prompted to confirm your intent to send
30802 and your message will be sent.
30803 <P>
30804 If this feature is set it disables some possibilities and renders some
30805 other features meaningless.
30806 You will not be able to use
30807 <A HREF="h_config_sending_filter">Sending Filters</A>,
30808 Verbose sending mode,
30809 <A HREF="h_config_compose_bg_post">Background Sending</A>,
30810 <A HREF="h_config_compose_dsn">Delivery Status Notifications</A>,
30811 or ^V to turn off the generation of flowed text for this message.
30812 These options are normally available as suboptions in the Send prompt, but
30813 with no Send prompt the options are gone.
30814
30815 <P>
30816 A somewhat related feature is
30817 <A HREF="h_config_quell_post_prompt">&quot;<!--#echo var="FEAT_quell-extra-post-prompt"-->&quot;</A>,
30818 which may be used to eliminate the extra confirmation
30819 question when posting to a newsgroup.
30820 <P>
30821 <UL>
30822 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30823 </UL><P>
30824 &lt;End of help on this topic&gt;
30825 </BODY>
30826 </HTML>
30827 ====== h_config_quell_filtering_done_message =====
30828 <HTML>
30829 <HEAD>
30830 <TITLE>FEATURE: <!--#echo var="FEAT_quell-filtering-done-message"--></TITLE>
30831 </HEAD>
30832 <BODY>
30833 <H1>FEATURE: <!--#echo var="FEAT_quell-filtering-done-message"--></H1>
30834
30835 If you use Filter Rules that move messages or set status of messages
30836 you sometimes see a message from Alpine that looks like
30837
30838 <P>
30839 <CENTER><SAMP>filtering done</SAMP></CENTER>
30840 <P>
30841
30842 If this feature is set, this message will be suppressed.
30843 If the feature
30844 <A HREF="h_config_quell_filtering_messages"><!--#echo var="FEAT_quell-filtering-messages"--></A>
30845 is set then this message will be suppressed regardless.
30846
30847 <P>
30848 <UL>
30849 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30850 </UL><P>
30851 &lt;End of help on this topic&gt;
30852 </BODY>
30853 </HTML>
30854 ====== h_config_quell_filtering_messages =====
30855 <HTML>
30856 <HEAD>
30857 <TITLE>FEATURE: <!--#echo var="FEAT_quell-filtering-messages"--></TITLE>
30858 </HEAD>
30859 <BODY>
30860 <H1>FEATURE: <!--#echo var="FEAT_quell-filtering-messages"--></H1>
30861
30862 If you use Filter Rules that move messages or set status of messages
30863 you sometimes see messages from Alpine that look like
30864
30865 <P>
30866 <CENTER><SAMP>&lt;filter name&gt;: Moving 2 filtered messages to &lt;folder name&gt;</SAMP></CENTER>
30867 <P>
30868
30869 or
30870
30871 <P>
30872 <CENTER><SAMP>&lt;filter name&gt;: Setting flags in 5 messages</SAMP></CENTER>
30873 <P>
30874
30875 or
30876
30877 <P>
30878 <CENTER><SAMP>Processing filter &lt;filter name&gt;</SAMP></CENTER>
30879 <P>
30880
30881 If this feature is set, these messages will be suppressed.
30882 The feature
30883 <A HREF="h_config_quell_filtering_done_message"><!--#echo var="FEAT_quell-filtering-done-message"--></A>
30884 is related.
30885
30886 <P>
30887 <UL>
30888 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30889 </UL><P>
30890 &lt;End of help on this topic&gt;
30891 </BODY>
30892 </HTML>
30893 ====== h_config_quell_post_prompt =====
30894 <HTML>
30895 <HEAD>
30896 <TITLE>FEATURE: <!--#echo var="FEAT_quell-extra-post-prompt"--></TITLE>
30897 </HEAD>
30898 <BODY>
30899 <H1>FEATURE: <!--#echo var="FEAT_quell-extra-post-prompt"--></H1>
30900
30901 By default, when you post a message to a newsgroup you are asked to confirm
30902 that you want to post with the question
30903
30904 <P>
30905 <CENTER><SAMP>Posted message may go to thousands of readers. Really post?</SAMP></CENTER>
30906 <P>
30907
30908 If this feature is set, you
30909 will <B>not</B> be prompted to confirm your intent to post to a newsgroup
30910 and your message will be posted.
30911
30912 <P>
30913 <UL>
30914 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30915 </UL><P>
30916 &lt;End of help on this topic&gt;
30917 </BODY>
30918 </HTML>
30919 ====== h_config_check_mail_onquit =====
30920 <HTML>
30921 <HEAD>
30922 <TITLE>FEATURE: <!--#echo var="FEAT_check-newmail-when-quitting"--></TITLE>
30923 </HEAD>
30924 <BODY>
30925 <H1>FEATURE: <!--#echo var="FEAT_check-newmail-when-quitting"--></H1>
30926
30927 If this feature is set, Alpine will check for new mail after you give the
30928 Quit command.
30929 If new mail has arrived since the previous check, you will be notified
30930 and given the choice of quitting or not quitting.
30931 <P>
30932 <UL>
30933 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30934 </UL><P>
30935 &lt;End of help on this topic&gt;
30936 </BODY>
30937 </HTML>
30938 ====== h_config_inbox_no_confirm =====
30939 <HTML>
30940 <HEAD>
30941 <TITLE>FEATURE: <!--#echo var="FEAT_return-to-inbox-without-confirm"--></TITLE>
30942 </HEAD>
30943 <BODY>
30944 <H1>FEATURE: <!--#echo var="FEAT_return-to-inbox-without-confirm"--></H1>
30945
30946 Normally, when you use the TAB <A HREF="h_common_nextnew">NextNew</A>
30947 command and there are no more folders or newsgroups to visit, you are asked
30948 if you want to return to the INBOX.
30949 If this feature is set you will not be asked.
30950 It will be assumed that you do want to return to the INBOX.
30951 <P>
30952 <UL>
30953 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30954 </UL><P>
30955 &lt;End of help on this topic&gt;
30956 </BODY>
30957 </HTML>
30958 ====== h_config_dates_to_local =====
30959 <HTML>
30960 <HEAD>
30961 <TITLE>FEATURE: <!--#echo var="FEAT_convert-dates-to-localtime"--></TITLE>
30962 </HEAD>
30963 <BODY>
30964 <H1>FEATURE: <!--#echo var="FEAT_convert-dates-to-localtime"--></H1>
30965
30966 Normally, the message dates that you see in the
30967 MESSAGE INDEX and MESSAGE VIEW are displayed in the timezone they were sent from.
30968 For example, if a message was sent to you from a few timezones to the east
30969 it might appear that it was sent from the future;
30970 or if it was sent from somewhere to the west it might appear
30971 as if it is from yesterday even though it was sent only a few minutes ago.
30972 If this feature is set an attempt will be made to convert the dates
30973 to your local timezone to be displayed.
30974 <P>
30975 Note that this does not affect the results of Select by Date or of
30976 anything else other than these displayed dates.
30977 When viewing the message you may look at the original unconverted value of the Date
30978 header by using the <A HREF="h_common_hdrmode">HdrMode Command</A>.
30979 <P>
30980 <UL>
30981 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30982 </UL><P>
30983 &lt;End of help on this topic&gt;
30984 </BODY>
30985 </HTML>
30986 ====== h_config_tab_no_prompt =====
30987 <HTML>
30988 <HEAD>
30989 <TITLE>FEATURE: <!--#echo var="FEAT_continue-tab-without-confirm"--></TITLE>
30990 </HEAD>
30991 <BODY>
30992 <H1>FEATURE: <!--#echo var="FEAT_continue-tab-without-confirm"--></H1>
30993
30994 Normally, when you use the TAB <A HREF="h_common_nextnew">NextNew</A>
30995 command and there is a problem checking a folder, you are asked
30996 whether you want to continue with the search in the following folder or not.
30997 This question gives you a chance to stop the NextNew processing.
30998 (The checking problem might be caused by the fact that the folder does not
30999 exist, or by an authentication problem, or by a server problem
31000 of some sort.)
31001 <P>
31002
31003 If this feature is set you will not be asked.
31004 It will be assumed that you do want to continue.
31005 <P>
31006 <UL>
31007 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31008 </UL><P>
31009 &lt;End of help on this topic&gt;
31010 </BODY>
31011 </HTML>
31012 ====== h_config_input_history =====
31013 <HTML>
31014 <HEAD>
31015 <TITLE>FEATURE: <!--#echo var="FEAT_disable-save-input-history"--></TITLE>
31016 </HEAD>
31017 <BODY>
31018 <H1>FEATURE: <!--#echo var="FEAT_disable-save-input-history"--></H1>
31019
31020 Many of the prompts that ask for input in the status line near the
31021 bottom of the screen will respond to Up Arrow and Down Arrow
31022 with the history of previous entries.
31023 For example, in the MESSAGE INDEX screen when you use the WhereIs
31024 command the text you entered will be remembered and can be recalled
31025 by using the Up Arrow key.
31026 Another example, when saving a message the folders saved to will
31027 be remembered and can be recalled using the arrow keys.
31028 <P>
31029 In the Save prompt, some users prefer that the Up and Down arrow keys
31030 be used for the Previous Collection and Next Collection commands
31031 instead of for a history of previous saves.
31032 If this option is set the Up and Down arrow keys will become synonyms for the
31033 Previous Collection and Next Collection (^P and ^N) commands in the
31034 prompt for the name of a folder to Save to or in the prompt for the
31035 name of a folder to GoTo.
31036 When this feature is not set (the default), ^P and ^N will change the
31037 collection and the arrow keys will show the history.
31038 <P>
31039 <UL>
31040 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31041 </UL><P>
31042 &lt;End of help on this topic&gt;
31043 </BODY>
31044 </HTML>
31045 ====== h_config_confirm_role =====
31046 <HTML>
31047 <HEAD>
31048 <TITLE>FEATURE: <!--#echo var="FEAT_confirm-role-even-for-default"--></TITLE>
31049 </HEAD>
31050 <BODY>
31051 <H1>FEATURE: <!--#echo var="FEAT_confirm-role-even-for-default"--></H1>
31052
31053 If you have roles, when you Reply to or Forward a message, or Compose
31054 a new message, Alpine
31055 will search through your roles for one that matches.
31056 Normally, if no matches are found you will be placed into the composer
31057 with no opportunity to select a role.
31058 If this feature is set, then you will be asked to confirm that you don't
31059 want a role.
31060 This will give you the opportunity to select a role (with the ^T command).
31061 If you confirm no role with a Return, you will be placed in
31062 the composer with no role.
31063 You may also confirm with either an &quot;N&quot; or a &quot;Y&quot;.
31064 These behave the same as if you pressed the Return.
31065 (The &quot;N&quot; and &quot;Y&quot; answers are available because they
31066 match what you might type if there was a role match.)
31067 <P>
31068 If you are using the alternate form of the Compose command called
31069 &quot;Role&quot;, then all of your roles will be available to you,
31070 independent of the value of this feauture and of the values set for all of
31071 Reply Use, Forward Use, and Compose Use.
31072 <P>
31073 <UL>
31074 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31075 </UL><P>
31076 &lt;End of help on this topic&gt;
31077 </BODY>
31078 </HTML>
31079 ====== h_config_news_cross_deletes =====
31080 <HTML>
31081 <HEAD>
31082 <TITLE>FEATURE: <!--#echo var="FEAT_news-deletes-across-groups"--></TITLE>
31083 </HEAD>
31084 <BODY>
31085 <H1>FEATURE: <!--#echo var="FEAT_news-deletes-across-groups"--></H1>
31086
31087 This feature controls what Alpine does when you delete a message in a
31088 newsgroup that appears in more than one newsgroup.  Such a message
31089 is sometimes termed a &quot;crossposting&quot; in that it was posted
31090 across several newsgroups.
31091
31092 <P>
31093 Alpine's default behavior when you delete such a message is to remove
31094 only the copy in the current newsgroup from view when you use the
31095 &quot;Exclude&quot; command or the next time you visit the newsgroup.
31096
31097 <P>
31098 Enabling this feature causes Alpine to remove every occurrence of the
31099 message from all newsgroups it appears in and to which you are
31100 subscribed.
31101
31102 <P>
31103 NOTE: As currently implemented, enabling this feature may increase the
31104 time it takes the Expunge command and newsgroup closing to complete.
31105
31106 <P>
31107 <UL>
31108 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31109 </UL><P>
31110 &lt;End of help on this topic&gt;
31111 </BODY>
31112 </HTML>
31113 ====== h_config_news_catchup =====
31114 <HTML>
31115 <HEAD>
31116 <TITLE>FEATURE: <!--#echo var="FEAT_news-offers-catchup-on-close"--></TITLE>
31117 </HEAD>
31118 <BODY>
31119 <H1>FEATURE: <!--#echo var="FEAT_news-offers-catchup-on-close"--></H1>
31120
31121 This feature controls what Alpine does as it closes a newsgroup.
31122 When set, Alpine will offer to delete all messages from the newsgroup
31123 as you are quitting Alpine or opening a new folder.
31124
31125 <P>
31126 This feature is useful if you typically read all the interesting messages
31127 in a newsgroup each time you open it.  This feature saves you from
31128 having to delete each message in a newsgroup as you read it or from
31129 selecting all the messages and doing an
31130 <A HREF="h_config_enable_agg_ops">aggregate delete</A> before you
31131 move on to the next folder or newsgroup.
31132
31133 <P>
31134 <UL>
31135 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31136 </UL><P>
31137 &lt;End of help on this topic&gt;
31138 </BODY>
31139 </HTML>
31140 ====== h_config_next_thrd_wo_confirm =====
31141 <HTML>
31142 <HEAD>
31143 <TITLE>FEATURE: <!--#echo var="FEAT_next-thread-without-confirm"--></TITLE>
31144 </HEAD>
31145 <BODY>
31146 <H1>FEATURE: <!--#echo var="FEAT_next-thread-without-confirm"--></H1>
31147
31148 This feature controls an aspect of Alpine's Next and Prev commands in
31149 the case where you are using one of the
31150 &quot;separate-index-screen&quot; styles for the configuration option
31151 <A HREF="h_config_thread_index_style">&quot;<!--#echo var="VAR_threading-index-style"-->&quot;</A>
31152 and currently have the folder sorted by a Threaded or OrderedSubject sort.
31153 When you are Viewing a particular thread you have a
31154 MESSAGE INDEX of only the messages in that thread.
31155 If you press the Next command with the last message in the thread highlighted
31156 you will normally be asked if you want to &quot;View next thread?&quot;,
31157 assuming there is a next thread to view.
31158 If this feature is set it will be assumed that you always want to view the
31159 next thread and you won't be asked to confirm that.
31160 Similarly, if the first message of the thread is highlighted and you
31161 press the Prev command, this feature will prevent the question
31162 &quot;View previous thread&quot;.
31163 <P>
31164 This feature only has an effect in the MESSAGE INDEX screen.
31165 If you then view a particular message from that screen and press the
31166 Next command, you will be sent to the next thread without being asked,
31167 independent of the setting of this feature.
31168 <P>
31169 The feature
31170 <A HREF="h_config_auto_open_unread">&quot;<!--#echo var="FEAT_auto-open-next-unread"-->&quot;</A> also has some similar effects.
31171 <P>
31172 &lt;End of help on this topic&gt;
31173 </BODY>
31174 </HTML>
31175 ====== h_config_kw_braces =====
31176 <HTML>
31177 <HEAD>
31178 <TITLE>OPTION: <!--#echo var="VAR_keyword-surrounding-chars"--></TITLE>
31179 </HEAD>
31180 <BODY>
31181 <H1>OPTION: <!--#echo var="VAR_keyword-surrounding-chars"--></H1>
31182
31183 This option controls a minor aspect of Alpine's MESSAGE INDEX and MESSAGE
31184 TEXT screens.
31185 If you have modified the
31186 &quot;<A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A>&quot; option
31187 so that either the &quot;SUBJKEY&quot; or &quot;SUBJKEYINIT&quot; tokens
31188 are used to display keywords or their initials along with the Subject; then
31189 this option may be used to modify the resulting display slightly.
31190 By default, the keywords or initials displayed for these tokens will be
31191 surrounded with curly braces ({ and }) and a trailing space.
31192 For example, if keywords &quot;Work&quot; and &quot;Now&quot; are set for
31193 a message, the &quot;SUBJKEY&quot; token will normally look like
31194 <P>
31195 <CENTER><SAMP>{Work Now} actual subject</SAMP></CENTER>
31196 <P>
31197 and the SUBJKEYINIT token would look like
31198 <P>
31199 <CENTER><SAMP>{WN} actual subject</SAMP></CENTER>
31200 <P>
31201 The default character before the keywords is the left brace ({) and the
31202 default after the keywords is the right brace followed by a space (} ).
31203 <P>
31204 This option allows you to change that.
31205 You should set it to two values separated by a space.
31206 The values may be quoted if they include space characters.
31207 So, for example, the default value could be specified explicitly by setting this
31208 option to
31209 <P>
31210 <CENTER><SAMP><!--#echo var="VAR_keyword-surrounding-chars"-->="{" "}&nbsp;"</SAMP></CENTER>
31211 <P>
31212 The first part wouldn't need to be quoted (but it doesn't hurt).
31213 The second part does need the quotes because it includes a space character.
31214 If you wanted to change the braces to brackets you could use
31215 <P>
31216 <CENTER><SAMP><!--#echo var="VAR_keyword-surrounding-chars"-->="[" "]&nbsp;"</SAMP></CENTER>
31217 <P>
31218 Inside the quotes you can use backslash quote to mean quote, so
31219 <P>
31220 <CENTER><SAMP><!--#echo var="VAR_keyword-surrounding-chars"-->="&#92;"" "&#92;" "</SAMP></CENTER>
31221 <P>
31222 would produce
31223 <P>
31224 <CENTER><SAMP>"Work Now" actual subject</SAMP></CENTER>
31225 <P>
31226 It is also possible to color keywords in the index using the
31227 Setup/Kolor screen (<A HREF="h_config_kw_color">Keyword Colors</A>).
31228 <P>
31229 It is not possible to change the fact that a space character is used to
31230 separate the keywords if more than one keyword is set for a message.
31231 It is also not possible to change the fact that there are no separators
31232 between the keyword initials if more than one keyword is set.
31233 <P>
31234 &lt;End of help on this topic&gt;
31235 </BODY>
31236 </HTML>
31237 ====== h_config_opening_sep =====
31238 <HTML>
31239 <HEAD>
31240 <TITLE>OPTION: <!--#echo var="VAR_opening-text-separator-chars"--></TITLE>
31241 </HEAD>
31242 <BODY>
31243 <H1>OPTION: <!--#echo var="VAR_opening-text-separator-chars"--></H1>
31244
31245 This option controls a minor aspect of Alpine's MESSAGE INDEX screen.
31246 With some setups the text of the subject is followed
31247 by the opening text of the message if there is any room available in the index line.
31248 If you have configured your
31249 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option
31250 to include one of the Subject tokens that causes this behavior
31251 (SUBJECTTEXT, SUBJKEYTEXT, or SUBJKEYINITTEXT), then this option may be used
31252 to modify what is displayed slightly.
31253 By default, the Subject is separated from the opening text of the message by
31254 the three characters space dash space;
31255 <P>
31256 <CENTER><SAMP>&quot;&nbsp;-&nbsp;&quot;</SAMP></CENTER>
31257 <P>
31258 Use this option to set it to something different.
31259 The value must be quoted if it includes any space characters.
31260 For example, the default value could be specified explicitly by setting this
31261 option to
31262 <P>
31263 <CENTER><SAMP><!--#echo var="VAR_opening-text-separator-chars"-->="&nbsp;-&nbsp;"</SAMP></CENTER>
31264 <P>
31265 &lt;End of help on this topic&gt;
31266 </BODY>
31267 </HTML>
31268 ====== h_config_select_wo_confirm =====
31269 <HTML>
31270 <HEAD>
31271 <TITLE>FEATURE: <!--#echo var="FEAT_select-without-confirm"--></TITLE>
31272 </HEAD>
31273 <BODY>
31274 <H1>FEATURE: <!--#echo var="FEAT_select-without-confirm"--></H1>
31275
31276 This feature controls an aspect of Alpine's Save, Export, and Goto commands.
31277 These commands all take text input to specify the name of the folder or
31278 file to be used, but allow you to press ^T for a list of possible names.
31279 If set, the selected name will be used immediately, without further
31280 opportunity to confirm or edit the name.
31281 <P>
31282 Some related help topics are
31283 <UL>
31284 <LI> <A HREF="h_mainhelp_aggops">Aggregate Operations</A>
31285 <LI> <A HREF="h_index_cmd_select">Selecting: Select and WhereIs/Select</A>,
31286 <LI> <A HREF="h_config_enable_agg_ops"><!--#echo var="FEAT_enable-aggregate-command-set"--></A>,
31287 <LI> <A HREF="h_config_auto_unselect"><!--#echo var="FEAT_auto-unselect-after-apply"--></A>.
31288 <LI> <A HREF="h_config_auto_unzoom"><!--#echo var="FEAT_auto-unzoom-after-apply"--></A>, and
31289 <LI> <A HREF="h_config_auto_zoom"><!--#echo var="FEAT_auto-zoom-after-select"--></A>.
31290 </UL>
31291 <P>
31292 &lt;End of help on this topic&gt;
31293 </BODY>
31294 </HTML>
31295 ====== h_config_save_part_wo_confirm =====
31296 <HTML>
31297 <HEAD>
31298 <TITLE>FEATURE: <!--#echo var="FEAT_save-partial-msg-without-confirm"--></TITLE>
31299 </HEAD>
31300 <BODY>
31301 <H1>FEATURE: <!--#echo var="FEAT_save-partial-msg-without-confirm"--></H1>
31302
31303 This feature controls an aspect of Alpine's Save command.
31304 By default, when you Save a message that has some deleted parts, you will
31305 be asked to confirm that you want to Save with a prompt that looks like:
31306 <P>
31307 <CENTER><SAMP>Saved copy will NOT include entire message!  Continue?</SAMP></CENTER>
31308 <P>
31309 If this feature is set, you will not be asked.
31310 <P>
31311 &lt;End of help on this topic&gt;
31312 </BODY>
31313 </HTML>
31314 ====== h_config_use_resentto =====
31315 <HTML>
31316 <HEAD>
31317 <TITLE>FEATURE: <!--#echo var="FEAT_use-resent-to-in-rules"--></TITLE>
31318 </HEAD>
31319 <BODY>
31320 <H1>FEATURE: <!--#echo var="FEAT_use-resent-to-in-rules"--></H1>
31321
31322 This feature is turned off by default because turning it on causes problems
31323 with some deficient IMAP servers.
31324 In Alpine <A HREF="h_mainhelp_filtering">Filters</A> and other types of Rules, if the
31325 <A HREF="h_rule_patterns">Pattern</A>
31326 contains a To header pattern and this feature is turned on,
31327 then a check is made in the message to see
31328 if a Resent-To header is present, and that is used instead of the To header.
31329 If this feature is not turned on, then the regular To header will always
31330 be used.
31331
31332 <P>
31333 &lt;End of help on this topic&gt;
31334 </BODY>
31335 </HTML>
31336 ====== h_config_use_reg_start_for_stayopen =====
31337 <HTML>
31338 <HEAD>
31339 <TITLE>FEATURE: <!--#echo var="FEAT_use-regular-startup-rule-for-stayopen-folders"--></TITLE>
31340 </HEAD>
31341 <BODY>
31342 <H1>FEATURE: <!--#echo var="FEAT_use-regular-startup-rule-for-stayopen-folders"--></H1>
31343
31344 This feature affects which message is selected as the current message
31345 when you enter a
31346 <A HREF="h_config_permlocked">Stay Open</A> folder.
31347 <P>
31348 Normally, the starting position for an incoming folder (which most Stay Open
31349 folders will likely be) is controlled by the
31350 <A HREF="h_config_inc_startup"><!--#echo var="VAR_incoming-startup-rule"--></A>.
31351 However, if a folder is a Stay Open folder, when you re-enter the folder
31352 after the first time the current message will be the same as it was when
31353 you left the folder.
31354 An exception is made if you use the TAB command to get to the folder.
31355 In that case, the message number will be incremented by one from what it
31356 was when you left the folder.
31357 <P>
31358 The above special behavior is thought to be useful.
31359 However, it is special and different from what you might at first expect.
31360 If this feature is set, then Stay Open folders will not be treated specially
31361 as far as the startup rule is concerned.
31362
31363 <P>
31364 &lt;End of help on this topic&gt;
31365 </BODY>
31366 </HTML>
31367 ====== h_config_use_current_dir =====
31368 <HTML>
31369 <HEAD>
31370 <TITLE>FEATURE: <!--#echo var="FEAT_use-current-dir"--></TITLE>
31371 </HEAD>
31372 <BODY>
31373 <H1>FEATURE: <!--#echo var="FEAT_use-current-dir"--></H1>
31374
31375 This feature controls an aspect of several commands.
31376 If set, your &quot;current working directory&quot;
31377 <!--chtml if pinemode="running"-->
31378 (which, at least for your current Alpine &quot;session,&quot;
31379 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
31380 <!--chtml endif-->
31381 will be used instead of your home directory
31382 <!--chtml if pinemode="running"-->
31383 (which, in the present configuration of your system, is
31384  &quot;<!--#echo var="HOME_DIR"-->&quot;)
31385 <!--chtml endif-->
31386 for all of the following operations:<UL>
31387     <LI> Export in the MESSAGE INDEX and MESSAGE TEXT screens
31388     <LI> Attachment Save in the MESSAGE TEXT and ATTACHMENT TEXT screens
31389     <LI> <!--chtml if pinemode="function_key"-->F4
31390          <!--chtml else-->Ctrl-R
31391          <!--chtml endif--> file inclusion in the COMPOSER
31392     <LI> <!--chtml if pinemode="function_key"-->F5
31393          <!--chtml else-->Ctrl-J
31394          <!--chtml endif--> file attachment in the COMPOSER
31395 </UL>
31396 <!--chtml if pinemode="os_windows"-->
31397 <P>
31398 If you are starting PC-Alpine from a desktop icon or the Start menu,
31399 you can set the &quot;current drive&quot;
31400 by specifying it in the &quot;Start in:&quot;
31401 box found in the Shortcut tab of the Properties.
31402 <!--chtml endif-->
31403 <P>
31404 <UL>
31405 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31406 </UL>
31407
31408 <P>
31409 &lt;End of help on this topic&gt;
31410 </BODY>
31411 </HTML>
31412 ====== h_config_save_wont_delete =====
31413 <HTML>
31414 <HEAD>
31415 <TITLE>FEATURE: <!--#echo var="FEAT_save-will-not-delete"--></TITLE>
31416 </HEAD>
31417 <BODY>
31418 <H1>FEATURE: <!--#echo var="FEAT_save-will-not-delete"--></H1>
31419
31420 This feature controls one aspect of the Save command.  If set, Save will
31421 not mark the message &quot;deleted&quot; (its default behavior) after
31422 it has been copied to the designated folder.
31423
31424 <P>
31425 &lt;End of help on this topic&gt;
31426 </BODY>
31427 </HTML>
31428 ====== h_config_use_boring_spinner =====
31429 <HTML>
31430 <HEAD>
31431 <TITLE>FEATURE: <!--#echo var="FEAT_busy-cue-spinner-only"--></TITLE>
31432 </HEAD>
31433 <BODY>
31434 <H1>FEATURE: <!--#echo var="FEAT_busy-cue-spinner-only"--></H1>
31435
31436 When Alpine is delayed for some reason it usually shows that
31437 something is happening with a small animated display in the status
31438 message line near the bottom of the screen.
31439 Setting this feature will cause that animation to be the same
31440 each time instead of having Alpine choose a random animation.
31441 You may turn the animation off altogether by setting the
31442 <A HREF="h_config_active_msg_interval"><!--#echo var="VAR_busy-cue-rate"--></A>
31443 option to zero.
31444
31445 <P>
31446 &lt;End of help on this topic&gt;
31447 </BODY>
31448 </HTML>
31449 ====== h_config_unsel_wont_advance =====
31450 <HTML>
31451 <HEAD>
31452 <TITLE>FEATURE: <!--#echo var="FEAT_unselect-will-not-advance"--></TITLE>
31453 </HEAD>
31454 <BODY>
31455 <H1>FEATURE: <!--#echo var="FEAT_unselect-will-not-advance"--></H1>
31456
31457 This feature controls one aspect of the Unselect Current message command.
31458 Normally, when the Unselect current message command (:) is typed when the
31459 current message is selected, the message will be unselected and the next
31460 message will become the current message.
31461 If this feature is set, the cursor will not advance to the next message.
31462 Instead, the current message will remain the current message after
31463 unselecting.
31464
31465 <P>
31466 &lt;End of help on this topic&gt;
31467 </BODY>
31468 </HTML>
31469 ====== h_config_prune_uses_iso =====
31470 <HTML>
31471 <HEAD>
31472 <TITLE>FEATURE: <!--#echo var="FEAT_prune-uses-yyyy-mm"--></TITLE>
31473 </HEAD>
31474 <BODY>
31475 <H1>FEATURE: <!--#echo var="FEAT_prune-uses-yyyy-mm"--></H1>
31476
31477 By default, Alpine asks monthly whether or not you would like to rename
31478 some folders to a new name containing the date.
31479 It also asks whether or not you would like to delete some old folders.
31480 See the <A HREF="h_config_pruning_rule"><!--#echo var="VAR_pruning-rule"--></A> option for an
31481 explanation.
31482
31483 <P>
31484 By default, the name used when renaming a folder looks like
31485 <P>
31486 <CENTER><SAMP>&lt;foldername&gt;-&lt;month&gt;-&lt;year&gt;</SAMP></CENTER>
31487 <P>
31488 For example, the first time you run Alpine in May of 2004,
31489 the folder &quot;sent-mail&quot; might be renamed to
31490 <P>
31491 <CENTER><SAMP>sent-mail-apr-2004</SAMP></CENTER>
31492 <P>
31493 If this feature is set, the name used will be of the form
31494 <P>
31495 <CENTER><SAMP>&lt;foldername&gt;-&lt;yyyy&gt;-&lt;mm&gt;</SAMP></CENTER>
31496 <P>
31497 where &quot;yyyy&quot; is the year and &quot;mm&quot; is the two-digit
31498 month (01, 02, ..., 12).
31499 For the April, 2004 example above, it would instead be
31500 <P>
31501 <CENTER><SAMP>sent-mail-2004-04</SAMP></CENTER>
31502 <P>
31503 because April is the 4th month of the year.
31504 A reason you might want to set this feature is so that the folders
31505 will sort in chronological order.
31506
31507 <P>
31508 &lt;End of help on this topic&gt;
31509 </BODY>
31510 </HTML>
31511 ====== h_config_save_advances =====
31512 <HTML>
31513 <HEAD>
31514 <TITLE>FEATURE: <!--#echo var="FEAT_save-will-advance"--></TITLE>
31515 </HEAD>
31516 <BODY>
31517 <H1>FEATURE: <!--#echo var="FEAT_save-will-advance"--></H1>
31518
31519 This feature controls one aspect of the Save command.  If set, Save will
31520 (in addition to copying the current message to the designated folder) also
31521 advance to the next message.
31522
31523 <P>
31524 &lt;End of help on this topic&gt;
31525 </BODY>
31526 </HTML>
31527 ====== h_config_force_arrow =====
31528 <HTML>
31529 <HEAD>
31530 <TITLE>FEATURE: <!--#echo var="FEAT_force-arrow-cursor"--></TITLE>
31531 </HEAD>
31532 <BODY>
31533 <H1>FEATURE: <!--#echo var="FEAT_force-arrow-cursor"--></H1>
31534
31535 This feature affects Alpine's MESSAGE INDEX display routine.
31536 If set, the normal inverse-video cursor will be
31537 replaced by a simple &quot;arrow&quot; cursor, which normally occupies the
31538 second column of the index display.
31539 <P>
31540 This is the same index cursor you get if you turn on
31541 <A HREF="h_config_force_low_speed"><!--#echo var="FEAT_assume-slow-link"--></A>, but the index
31542 line coloring will still be present if this feature is turned on and
31543 <!--#echo var="FEAT_assume-slow-link"--> is off.
31544 <P>
31545 An alternative version of the Arrow cursor is available by including the
31546 <A HREF="h_config_index_arrow_color">ARROW</A>
31547 token in the
31548 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option.
31549 <P>
31550 It ought to be the case that this feature also affects the ATTACHMENT INDEX,
31551 but that is not implemented.
31552
31553 <P>
31554 &lt;End of help on this topic&gt;
31555 </BODY>
31556 </HTML>
31557 ====== h_config_ignore_size =====
31558 <HTML>
31559 <HEAD>
31560 <TITLE>FEATURE: <!--#echo var="FEAT_ignore-size-changes"--></TITLE>
31561 </HEAD>
31562 <BODY>
31563 <H1>FEATURE: <!--#echo var="FEAT_ignore-size-changes"--></H1>
31564
31565 When you have an account residing in an IMAP server, Alpine records the
31566 size of each message as reported by the server. However, when Alpine saves
31567 a message in such IMAP server, Alpine will compute the size of the message
31568 independently, from the data it received. If these two numbers do not
31569 match for a message, Alpine asks you if you still want to take the risk of
31570 saving such message, since data corruption or loss of data could result
31571 from this save.
31572
31573 <P>
31574 Sometimes the root of this problem is that the IMAP server does not
31575 compute sizes correctly, and there will not be loss of information when
31576 saving such message. Enabling this feature will make Alpine ignore such
31577 error and continue saving the message without producing any warnings or
31578 ever stopping the process, as if there had not been any error. This option
31579 applies to all IMAP servers that you use, so if you enable this feature,
31580 size discrepancy warnings will not be given for any IMAP server you
31581 connect to.
31582
31583 <P>
31584 Example of a server where you could reproduce this problem is the Gmail
31585 IMAP server. Another example can be found in some versions of the Exchange
31586 server.
31587
31588 <P>
31589 It is recommended that this feature be disabled most of the time and only
31590 enabled when you find a server which you can determine that has the above
31591 mentioned defect, but be disabled again after making the save operation
31592 succeed.
31593
31594 <P>
31595 &lt;End of help on this topic&gt;
31596 </BODY>
31597 </HTML>
31598 ====== h_config_force_low_speed =====
31599 <HTML>
31600 <HEAD>
31601 <TITLE>FEATURE: <!--#echo var="FEAT_assume-slow-link"--></TITLE>
31602 </HEAD>
31603 <BODY>
31604 <H1>FEATURE: <!--#echo var="FEAT_assume-slow-link"--></H1>
31605
31606 UNIX Alpine only.
31607 <P>
31608 This feature affects Alpine's display routines.  If set, the normal
31609 inverse-video cursor (used to highlight the current item in a list) will be
31610 replaced by an &quot;arrow&quot; cursor and other
31611 screen update optimizations for
31612 low-speed links (e.g. 2400 bps dialup connections) will be activated.
31613 One of the optimizations is that colored index lines (set up with Indexcolor
31614 Rules) will not be colored.
31615 If you are just turning this feature on because you like using
31616 the &quot;arrow&quot; cursor you may have an arrow cursor with index line
31617 coloring by turning this feature off and the
31618 <A HREF="h_config_force_arrow"><!--#echo var="FEAT_force-arrow-cursor"--></A> on.
31619
31620 <P>
31621 &lt;End of help on this topic&gt;
31622 </BODY>
31623 </HTML>
31624 ====== h_config_show_delay_cue =====
31625 <HTML>
31626 <HEAD>
31627 <TITLE>FEATURE: <!--#echo var="FEAT_enable-mail-check-cue"--></TITLE>
31628 </HEAD>
31629 <BODY>
31630 <H1>FEATURE: <!--#echo var="FEAT_enable-mail-check-cue"--></H1>
31631
31632 If set, this feature will cause an asterisk to appear in the upper
31633 left-hand corner of the screen whenever Alpine checks for new mail.
31634 Two asterisks whenever Alpine saves (checkpoints) the state of the current
31635 mailbox to disk.
31636
31637 <!--chtml if pinemode="os_windows"-->
31638 <P>
31639 In addition, PC-Alpine will display a less-than symbol, '&lt;', when
31640 it is trying to open a network connection (e.g, to open your INBOX
31641 on an IMAP
31642 server) or read from the network connection.  A greater-than symbol,
31643 will be displayed when PC-Alpine is trying to write to the network
31644 connection (e.g, sending a command to your IMAP server).
31645 <!--chtml endif-->
31646
31647 <P>
31648 &lt;End of help on this topic&gt;
31649 </BODY>
31650 </HTML>
31651 ====== h_config_color_style =====
31652 <HTML>
31653 <HEAD>
31654 <TITLE>OPTION: Color Style</TITLE>
31655 </HEAD>
31656 <BODY>
31657 <H1>OPTION: Color Style</H1>
31658
31659 UNIX Alpine only.
31660 <P>
31661 If the terminal or terminal emulator you are using is capable of displaying
31662 colors, this option controls whether or not color will be used in Alpine.
31663 If you turn color on and things are set up correctly,
31664 you should see color appear on the screen immmediately.
31665 Modern terminal emulators are usually capable of displaying colors.
31666 <P>
31667 The available options include:
31668 <P>
31669
31670 <DL>
31671 <DT>no-color</DT>
31672 <DD>Don't use color.
31673 </DD>
31674
31675 <DT>use-termdef</DT>
31676 <DD>In order to decide if your terminal is capable of color, Alpine looks in
31677 the terminal capabilities database, TERMINFO or TERMCAP, depending on
31678 how Alpine was compiled.
31679 This is a good option to choose if you switch between a color and a non-color
31680 terminal with the same Alpine configuration.
31681 Alpine will know to use color on the color terminal because it is described
31682 in the termcap entry, and Alpine will know to use black and white on the
31683 non-color terminal.
31684 The Alpine Technical Notes
31685 <CENTER><SAMP><A HREF="http://www.washington.edu/alpine/tech-notes/">http://www.washington.edu/alpine/tech-notes/</A></SAMP></CENTER>
31686 have more information on configuring a TERMCAP or TERMINFO
31687 entry for color Alpine.
31688 This is usually something a system administrator does.
31689 </DD>
31690
31691 <DT>force-ansi-8color</DT>
31692 <DD>This is probably the setting that most people should use.
31693 Because setting up a termcap entry is confusing and because the
31694 terminal capabilities database is often not correctly configured for color,
31695 this choice and the next may be easier for you to use.
31696 If your terminal emulator responds to ANSI color escape sequences, which
31697 many do, this option will cause Alpine to believe your terminal will respond
31698 to the escape sequences that produce eight different foreground and background
31699 colors.
31700 The escape sequences used to set the foreground colors are
31701
31702   <P><CENTER>ESC&nbsp;[&nbsp;3&nbsp;&lt;color_number&gt;&nbsp;m</CENTER><P>
31703
31704 where the color_number is an ASCII digit between 0 and 7.
31705 The numbers 0 through 7 should correspond to the colors black, red, green,
31706 yellow, blue, magenta, cyan, and white.
31707 Some terminal emulators use a pre-ANSI scheme that swaps
31708 the colors blue and red and the colors yellow and cyan.
31709 This will cause the default colors to be different, but other than that
31710 things should work fine.
31711 There is also a 9th color available, the last one shown, which is the default
31712 color from the terminal emulator.
31713 When used as a background color some people refer to this color as
31714 &quot;transparent&quot;, which is why the letters &quot;TRAN&quot; are
31715 shown in the color swatch of the SETUP COLOR screen.
31716 The foreground transparent color is shown as
31717 the color of the &quot;TRAN&quot; text.
31718 (The transparent color will not work correctly in a PC-Alpine configuration.)
31719 The escape sequences used to set the background colors are the same
31720 as for the foreground colors except a &quot;4&quot; replaces the &quot;3&quot;.
31721 The escape sequences for foreground and background default colors (transparent)
31722 are 39m and 49m.
31723 <P>
31724 Note: With the Tera Term terminal emulator this setting works well.
31725 You should also have the Tera Term &quot;Full color&quot; option turned OFF.
31726 You may find the &quot;Full color&quot; option in Tera Term's &quot;Setup&quot;
31727 menu, in the &quot;Window&quot; submenu.
31728 </DD>
31729
31730 <DT>force-ansi-16color</DT>
31731 <DD>Many terminal emulators know about the same eight colors above
31732 plus eight more.
31733 This option attempts to use all 16 colors.
31734 The same escape sequences as for the eight-color terminal are used
31735 for the first eight colors.
31736 The escape sequences used to set foreground colors 8-15 are the same as
31737 for 0-7 except the &quot;3&quot; is replaced with a &quot;9&quot;.
31738 The background color sequences for colors 8-15 are the same as for 0-7
31739 except the &quot;4&quot; is replaced with &quot;10&quot;.
31740 You can tell if the 16 colors are working by turning on this option
31741 and then going into one of the color configuration screens, for example,
31742 the configuration screen for Normal Color.
31743 If you see 16 different colors to select from (plus a 17th for
31744 the transparent color), it's working.
31745 </DD>
31746
31747 <DT>force-xterm-256color</DT>
31748 <DD>Some versions of xterm (and some other terminal emulators)
31749 have support for 256 colors.
31750 The escape sequences used to set the foreground colors are
31751
31752   <P><CENTER>ESC&nbsp;[&nbsp;38&nbsp;;&nbsp;5&nbsp;;&nbsp;&lt;color_number&gt;&nbsp;m</CENTER><P>
31753
31754 where the color_number is an ASCII digit between 0 and 255.
31755 Background colors are the same with the 38 replaced with a 48.
31756 The numbers 0 through 15 are probably similar to the 16 color version
31757 above, then comes a 6x6x6 color cube, followed by 24 colors of gray.
31758 The terminal default (transparent) color is the 257th color at the bottom.
31759 Some terminal emulators will misinterpret these escape sequences causing
31760 the terminal to blink or overstrike characters or to do something else
31761 undesirable.
31762 <P>
31763 The PuTTY terminal emulator has an option called &quot;Allow terminal to
31764 use xterm 256-colour mode&quot; which allows PuTTY to work well with
31765 this 256-color setting.
31766
31767 </DD>
31768 </DL>
31769
31770 <P>
31771 The normal default is &quot;no-color&quot;.
31772 <P>
31773
31774 Once you've turned on color you may set the
31775 colors of many objects on the screen individually.
31776 For example, you may add colors to the status letters on the MESSAGE
31777 INDEX page.
31778 Most categories of color that Alpine supports are configurable here.
31779 For example, &quot;Normal Color&quot;
31780 is the color used to display most of the text in Alpine, and
31781 &quot;Reverse Color&quot; is used to display highlighted text, such as the
31782 current message in the MESSAGE INDEX.
31783 <P>
31784 Lines in the MESSAGE INDEX may also be colored.
31785 Use Setup Rules to get to the Indexcolor configuration screen.
31786 <P>
31787
31788 <UL>
31789 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31790 </UL><P>
31791 &lt;End of help on this topic&gt;
31792 </BODY>
31793 </HTML>
31794 ====== h_config_disable_index_locale_dates =====
31795 <HTML>
31796 <HEAD>
31797 <TITLE>FEATURE: <!--#echo var="FEAT_disable-index-locale-dates"--></TITLE>
31798 </HEAD>
31799 <BODY>
31800 <H1>FEATURE: <!--#echo var="FEAT_disable-index-locale-dates"--></H1>
31801
31802 This feature affects the display of dates in the MESSAGE INDEX.
31803 Normally an attempt is made to localize the dates
31804 used in the MESSAGE INDEX display to your locale.
31805 This is controlled with the
31806 LC_TIME locale setting on a UNIX system.
31807 On Windows the Regional Options control panel may be used to set the date format.
31808 At the programming level, Alpine is using the strftime routine
31809 to print the parts of a date.
31810 <P>
31811 If this feature is set, dates are displayed in English and
31812 with the conventions of the United States.
31813 <P>
31814
31815 <UL>
31816 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31817 </UL><P>
31818 &lt;End of help on this topic&gt;
31819 </BODY>
31820 </HTML>
31821 ====== h_config_auto_open_unread =====
31822 <HTML>
31823 <HEAD>
31824 <TITLE>FEATURE: <!--#echo var="FEAT_auto-open-next-unread"--></TITLE>
31825 </HEAD>
31826 <BODY>
31827 <H1>FEATURE: <!--#echo var="FEAT_auto-open-next-unread"--></H1>
31828
31829 This feature controls the behavior of the TAB key when traversing folders
31830 in the optional
31831 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
31832 collection or in optional <!--#echo var="VAR_news-collections"-->.
31833 <P>
31834 When the TAB
31835 (<A HREF="h_common_nextnew">NextNew</A>)
31836 key is pressed, and there
31837 are no more unseen messages in the current (incoming message or news)
31838 folder, Alpine will search the list of folders in the current collection for
31839 one containing New or Recent (new since the last time the folder was
31840 opened) messages.
31841 This behavior may be modified slightly with the
31842 <A HREF="h_config_tab_uses_unseen">&quot;<!--#echo var="FEAT_tab-uses-unseen-for-next-folder"-->&quot;</A>
31843 feature that causes Alpine to look for Unseen messages instead of Recent
31844 messages.
31845 Normally, when such a folder is found, Alpine will ask
31846 whether you wish to open the folder.  If this feature is set, Alpine will
31847 automatically open the folder without prompting.
31848 <P>
31849 This feature also affects some other similar situations.
31850 If you have a
31851 <A HREF="h_config_thread_index_style"><!--#echo var="VAR_threading-index-style"--></A>
31852 that is equal to one of the &quot;separate-&quot; values, and you are
31853 viewing a thread; then when you type the NextNew command and are at the
31854 end of the current thread you will automatically go to the next thread
31855 if this feature is set.
31856 By default, you would be asked if you want to view the next thread.
31857 You will also be asked at times whether or not you want to view the next
31858 thread after you delete the last message in the thread.
31859 Setting this feature will also cause that question to be skipped.
31860 <P>
31861
31862 <UL>
31863 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31864 </UL><P>
31865 &lt;End of help on this topic&gt;
31866 </BODY>
31867 </HTML>
31868 ====== h_config_auto_include_reply =====
31869 <HTML>
31870 <HEAD>
31871 <TITLE>FEATURE: <!--#echo var="FEAT_include-text-in-reply"--></TITLE>
31872 </HEAD>
31873 <BODY>
31874 <H1>FEATURE: <!--#echo var="FEAT_include-text-in-reply"--></H1>
31875
31876 This feature controls an aspect of Alpine's Reply command.  Normally, Alpine
31877 will ask whether you wish to include the original message in your reply.
31878 If this feature is set and the feature
31879 <A HREF="h_config_prefix_editing">&quot;<!--#echo var="FEAT_enable-reply-indent-string-editing"-->&quot;</A>
31880 is <EM>not</EM> set, then the original message will be included in the reply
31881 automatically, without prompting.
31882 <P>
31883 &lt;End of help on this topic&gt;
31884 </BODY>
31885 </HTML>
31886 ====== h_config_select_in_bold =====
31887 <HTML>
31888 <HEAD>
31889 <TITLE>FEATURE: <!--#echo var="FEAT_show-selected-in-boldface"--></TITLE>
31890 </HEAD>
31891 <BODY>
31892 <H1>FEATURE: <!--#echo var="FEAT_show-selected-in-boldface"--></H1>
31893
31894 This feature controls an aspect of Alpine's
31895 <A HREF="h_config_enable_agg_ops">&quot;aggregate operation&quot;</A>
31896 commands; in
31897 particular, the Select and WhereIs commands. Select and WhereIs (with the
31898 ^X subcommand) will search the current folder for messages meeting a
31899 specified criteria, and &quot;tag&quot; the resulting messages with an
31900 &quot;X&quot; in the
31901 first column of the applicable lines in the MESSAGE INDEX.  If this feature
31902 is set, instead of using the &quot;X&quot; to denote a selected message,
31903 Alpine will
31904 attempt to display those index lines in boldface. Whether this is
31905 preferable to the &quot;X&quot; will depend on personal taste and the type of
31906 terminal being used.
31907 <P>
31908 <UL>
31909 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31910 </UL><P>
31911 &lt;End of help on this topic&gt;
31912 </BODY>
31913 </HTML>
31914 ====== h_config_alt_auth =====
31915 <HTML>
31916 <HEAD>
31917 <TITLE>FEATURE: <!--#echo var="FEAT_try-alternative-authentication-driver-first"--></TITLE>
31918 </HEAD>
31919 <BODY>
31920 <H1>FEATURE: <!--#echo var="FEAT_try-alternative-authentication-driver-first"--></H1>
31921
31922 This feature affects how Alpine connects to IMAP servers.
31923 It's utility has largely been overtaken by events,
31924 but it may still be useful in some circumstances.
31925 If you only connect to modern IMAP servers that support
31926 &quot;TLS&quot; you can ignore this feature.
31927
31928 <P>
31929 Details:
31930
31931 <P>
31932 By default, Alpine will attempt to connect to an IMAP server on the
31933 normal IMAP service port (143), and if the server offers &quot;Transport Layer
31934 Security&quot; (TLS) and Alpine has been compiled with encryption capability,
31935 then a secure (encrypted) session will be negotiated.
31936
31937 <P>
31938 With this feature enabled, before connecting on the normal IMAP port, Alpine
31939 will first attempt to connect to an alternate IMAP service port (993) used
31940 specifically for encrypted IMAP sessions via the Secure Sockets Layer
31941 (SSL) method.
31942 If the SSL attempt fails, Alpine will then try the default
31943 behavior described in the previous paragraph.
31944
31945 <P>
31946 TLS negotiation on the normal port is preferred, and supersedes the use of
31947 SSL on port 993, but older servers may not provide TLS support.
31948 This feature may be convenient when accessing IMAP servers that do not support
31949 TLS, but do support SSL connections on port 993.
31950 However, it is important to understand that with this feature enabled,
31951 Alpine will <EM>attempt</EM> to make a secure connection if that is possible,
31952 but it will proceed to make an insecure connection if that is the only
31953 option offered by the server, or if the Alpine in question has been built
31954 without encryption capability.
31955
31956 <P>
31957 Note that this feature specifies a per-user (or system-wide) default
31958 behavior, but host/folder specification flags may be used to control the
31959 behavior of any specific connection.
31960 This feature interacts with some of
31961 the possible host/folder path specification flags as follows:
31962
31963 <P>
31964 The <SAMP>/tls</SAMP> host flag, for example,
31965
31966 <P>
31967 <CENTER><SAMP>{foo.example.com/tls}INBOX</SAMP></CENTER>
31968 <P>
31969 will over-ride this feature for the specified host by bypassing the
31970 SSL connection attempt.
31971 Moreover, with <SAMP>/tls</SAMP> specified,
31972 the connection attempt will fail if the
31973 service on port 143 does not offer TLS support.
31974
31975 <P>
31976 The <SAMP>/ssl</SAMP> host flag, for example,
31977
31978 <P>
31979 <CENTER><SAMP>{foo.example.com/ssl}INBOX</SAMP></CENTER>
31980 <P>
31981 will insist on an SSL connection for the specified host,
31982 and will fail if the SSL service on port 993 is not available.
31983 Alpine will not subsequently retry a connection
31984 on port 143 if <SAMP>/ssl</SAMP> is specified.
31985
31986 <P>
31987 <UL>
31988 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31989 </UL><P>
31990 &lt;End of help on this topic&gt;
31991 </BODY>
31992 </HTML>
31993 ====== h_config_file_dir ======
31994 <HTML>
31995 <HEAD>
31996 <TITLE>OPTION: File Directory</TITLE>
31997 </HEAD>
31998 <BODY>
31999 <H1>OPTION: File Directory</H1>
32000
32001 PC-Alpine only.
32002 <P>
32003 This value affects the Composer's &quot;^J&nbsp;Attach&quot; command,
32004 the Attachment Index Screen's &quot;S&nbsp;Save&quot; command, and the
32005 Message Index's &quot;E&nbsp;Export&quot; command.
32006
32007 <P>
32008 Normally, when a filename is supplied that lacks a leading &quot;path&quot;
32009 component, Alpine assumes the file exists in the user's home directory.
32010 Under Windows operating systems, this definition isn't always clear.  This
32011 feature allows you to explictly set where Alpine should look for files
32012 without a leading path.
32013
32014 <P>
32015 NOTE: this feature's value is ignored if either
32016 <A HREF="h_config_use_current_dir"><!--#echo var="FEAT_use-current-dir"--></A> feature
32017 is set or the PINERC has a value for the &quot;<!--#echo var="VAR_operating-dir"-->&quot; variable.
32018
32019 <P>
32020 <UL>
32021 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32022 </UL><P>
32023 &lt;End of help on this topic&gt;
32024 </BODY>
32025 </HTML>
32026 ====== h_config_quote_all_froms =====
32027 <HTML>
32028 <HEAD>
32029 <TITLE>FEATURE: <!--#echo var="FEAT_save-will-quote-leading-froms"--></TITLE>
32030 </HEAD>
32031 <BODY>
32032 <H1>FEATURE: <!--#echo var="FEAT_save-will-quote-leading-froms"--></H1>
32033
32034 This feature controls an aspect of the Save command (and also the way
32035 outgoing messages are saved to an FCC folder).  If set, Alpine will add
32036 a leading &quot;>&quot; character in front of message lines beginning with &quot;From&quot;
32037 when they are saved to another folder, including lines syntactically
32038 distinguishable from the type of message separator line commonly used on
32039 Unix systems.
32040
32041 <P>
32042 The default behavior is that a &quot;>&quot; will be prepended only to lines
32043 beginning with &quot;From &quot; that might otherwise be confused with a message
32044 separator line on Unix systems.  If pine is the only mail program you use,
32045 this default is reasonable.  If another program you use has trouble
32046 displaying a message with an unquoted &quot;From &quot; saved by Alpine, you should
32047 enable this feature.  This feature only applies to the common Unix mailbox
32048 format that uses message separator lines beginning with &quot;From &quot;.  If
32049 Alpine has been configured to use a different mailbox format (possibly
32050 incompatible with other mail programs), then this issue does not arise,
32051 and the feature is irrelevant.
32052
32053 <P>
32054 &lt;End of help on this topic&gt;
32055 </BODY>
32056 </HTML>
32057 ====== h_config_normal_color =====
32058 <HTML>
32059 <HEAD>
32060 <TITLE>OPTION: Normal Color</TITLE>
32061 </HEAD>
32062 <BODY>
32063 <H1>OPTION: Normal Color</H1>
32064
32065 Sets the color Alpine normally uses.
32066 The foreground color is the color of the actual character and the
32067 background color is the color of the area behind the character.
32068 By default this color is black characters on a white background.
32069 <P>
32070 <A HREF="h_color_setup">Descriptions of the available commands</A>
32071 <P>
32072 Look <A HREF="h_edit_nav_cmds">here</A>
32073 to see the available Editing and Navigation commands.
32074 <P>
32075 &lt;End of help on this topic&gt;
32076 </BODY>
32077 </HTML>
32078 ====== h_config_reverse_color =====
32079 <HTML>
32080 <HEAD>
32081 <TITLE>OPTION: Reverse Color</TITLE>
32082 </HEAD>
32083 <BODY>
32084 <H1>OPTION: Reverse Color</H1>
32085
32086 Sets the color Alpine uses for reverse video characters.
32087 The foreground color is the color of the actual character and the
32088 background color is the color of the area behind the character.
32089 <P>
32090 <A HREF="h_color_setup">Descriptions of the available commands</A>
32091 <P>
32092 Look <A HREF="h_edit_nav_cmds">here</A>
32093 to see the available Editing and Navigation commands.
32094 <P>
32095 &lt;End of help on this topic&gt;
32096 </BODY>
32097 </HTML>
32098 ====== h_config_title_color =====
32099 <HTML>
32100 <HEAD>
32101 <TITLE>OPTION: Title Color</TITLE>
32102 </HEAD>
32103 <BODY>
32104 <H1>OPTION: Title Color</H1>
32105
32106 Sets the color Alpine uses for the titlebar (the top line on the screen).
32107 The foreground color is the color of the actual character and the
32108 background color is the color of the area behind the character.
32109 By default, the Title Color is black characters on a yellow background.
32110 <P>
32111 The actual titlebar color may be different from the Title Color if
32112 the option
32113 <A HREF="h_config_titlebar_color_style">&quot;<!--#echo var="VAR_titlebar-color-style"-->&quot;</A>
32114 is set to some value other than the default.
32115 It may also be different if the current folder is closed and the
32116 <A HREF="h_config_titleclosed_color">Title Closed Color</A>
32117 color is set to something different from the Title Color.
32118 <P>
32119 <A HREF="h_color_setup">Descriptions of the available commands</A>
32120 <P>
32121 Look <A HREF="h_edit_nav_cmds">here</A>
32122 to see the available Editing and Navigation commands.
32123 <P>
32124 &lt;End of help on this topic&gt;
32125 </BODY>
32126 </HTML>
32127 ====== h_config_titleclosed_color =====
32128 <HTML>
32129 <HEAD>
32130 <TITLE>OPTION: Title Closed Color</TITLE>
32131 </HEAD>
32132 <BODY>
32133 <H1>OPTION: Title Closed Color</H1>
32134
32135 Sets the color Alpine uses for the titlebar (the top line on the screen)
32136 when the current folder is closed.
32137 The foreground color is the color of the actual character and the
32138 background color is the color of the area behind the character.
32139 By default, the Title Color Closed Color is white characters on a red background.
32140 <P>
32141 By setting this color to something noticeable you will be alerted to the
32142 fact that the current folder is closed, perhaps unexpectedly.
32143 <P>
32144 &lt;End of help on this topic&gt;
32145 </BODY>
32146 </HTML>
32147 ====== h_config_status_color =====
32148 <HTML>
32149 <HEAD>
32150 <TITLE>OPTION: Status Color</TITLE>
32151 </HEAD>
32152 <BODY>
32153 <H1>OPTION: Status Color</H1>
32154
32155 Sets the color Alpine uses for status messages written to the message
32156 line near the bottom of the screen.
32157 The foreground color is the color of the actual character and the
32158 background color is the color of the area behind the character.
32159 By default, the Status Color is the same as the Reverse Color.
32160 <P>
32161 <A HREF="h_color_setup">Descriptions of the available commands</A>
32162 <P>
32163 Look <A HREF="h_edit_nav_cmds">here</A>
32164 to see the available Editing and Navigation commands.
32165 <P>
32166 &lt;End of help on this topic&gt;
32167 </BODY>
32168 </HTML>
32169 ====== h_config_index_opening_color =====
32170 <HTML>
32171 <HEAD>
32172 <TITLE>OPTION: Index Opening Color</TITLE>
32173 </HEAD>
32174 <BODY>
32175 <H1>OPTION: Index Opening Color</H1>
32176
32177 With some setups the text of the subject is followed
32178 by the opening text of the message if there is any room available in the index line.
32179 If you have configured your
32180 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option
32181 to include one of the Subject tokens that causes this behavior
32182 (SUBJECTTEXT, SUBJKEYTEXT, or SUBJKEYINITTEXT), you may set the color of
32183 this opening text with this option.
32184 This coloring takes place for all but the current index line, and the Opening
32185 Color appears to be in front of any color from an Index Color Rule.
32186 <P>
32187 By default the Index Opening Color is gray characters on a white background.
32188
32189 <P>
32190 <A HREF="h_color_setup">Descriptions of the available commands</A>
32191 <P>
32192 Look <A HREF="h_edit_nav_cmds">here</A>
32193 to see the available Editing and Navigation commands.
32194 <P>
32195 &lt;End of help on this topic&gt;
32196 </BODY>
32197 </HTML>
32198 ====== h_config_index_pri_color =====
32199 <HTML>
32200 <HEAD>
32201 <TITLE>OPTION: Index Priority Symbol Colors</TITLE>
32202 </HEAD>
32203 <BODY>
32204 <H1>OPTION: Index Priority Symbol Colors</H1>
32205
32206 The X-Priority header is a non-standard header that is used in a
32207 somewhat standard way by many mail programs.
32208 Alpine expects the value of this header to be a digit with a value
32209 from 1 to 5, with 1 being the highest priority and 5 the lowest priority.
32210 Alpine can be made to display an indication of this priority in
32211 messages by use of one of the tokens
32212 (<A HREF="h_index_tokens">Tokens for Index and Replying</A>)
32213 PRIORITY, PRIORITYALPHA, or PRIORITY! in the
32214 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option.
32215
32216 <P>
32217 You may set the color used to draw these tokens by use of the colors
32218 Index High Priority Symbol Color and Index Low Priority Symbol Color.
32219 This coloring takes place for all but the current index line, and the Priority
32220 Color appears to be in front of any color from an Index Color Rule.
32221 If the priority has a value of 1 or 2 the High Priority color will be
32222 used,
32223 and if the value is 4 or 5 the Low Priority color will be used.
32224 <P>
32225 If you don't set these colors the index line will be colored in the same color as
32226 the bulk of the index line.
32227
32228 <P>
32229 <A HREF="h_color_setup">Descriptions of the available commands</A>
32230 <P>
32231 Look <A HREF="h_edit_nav_cmds">here</A>
32232 to see the available Editing and Navigation commands.
32233 <P>
32234 &lt;End of help on this topic&gt;
32235 </BODY>
32236 </HTML>
32237 ====== h_config_index_subject_color =====
32238 <HTML>
32239 <HEAD>
32240 <TITLE>OPTION: Index Subject Color</TITLE>
32241 </HEAD>
32242 <BODY>
32243 <H1>OPTION: Index Subject Color</H1>
32244
32245 You may set the color used to draw the Subject part of the index line.
32246 This coloring takes place for all but the current index line, and the Subject
32247 Color appears to be in front of any color from an Index Color Rule.
32248 <P>
32249 If you don't set this color it will be colored in the same color as
32250 the bulk of the index line.
32251
32252 <P>
32253 <A HREF="h_color_setup">Descriptions of the available commands</A>
32254 <P>
32255 Look <A HREF="h_edit_nav_cmds">here</A>
32256 to see the available Editing and Navigation commands.
32257 <P>
32258 &lt;End of help on this topic&gt;
32259 </BODY>
32260 </HTML>
32261 ====== h_config_index_from_color =====
32262 <HTML>
32263 <HEAD>
32264 <TITLE>OPTION: Index From Color</TITLE>
32265 </HEAD>
32266 <BODY>
32267 <H1>OPTION: Index From Color</H1>
32268
32269 You may set the color used to draw the From part of the index line.
32270 This coloring takes place for all but the current index line, and the From
32271 Color appears to be in front of any color from an Index Color Rule.
32272 <P>
32273 If you don't set this color it will be colored in the same color as
32274 the bulk of the index line.
32275
32276 <P>
32277 <A HREF="h_color_setup">Descriptions of the available commands</A>
32278 <P>
32279 Look <A HREF="h_edit_nav_cmds">here</A>
32280 to see the available Editing and Navigation commands.
32281 <P>
32282 &lt;End of help on this topic&gt;
32283 </BODY>
32284 </HTML>
32285 ====== h_config_index_arrow_color =====
32286 <HTML>
32287 <HEAD>
32288 <TITLE>OPTION: Index Arrow Color</TITLE>
32289 </HEAD>
32290 <BODY>
32291 <H1>OPTION: Index Arrow Color</H1>
32292
32293 If you have configured your
32294 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option
32295 to include the &quot;ARROW&quot; token, you may set the color of
32296 the arrow displayed with this option.
32297 If you don't set the color it will be colored in the same color as
32298 the bulk of the index line.
32299
32300 <P>
32301 <A HREF="h_color_setup">Descriptions of the available commands</A>
32302 <P>
32303 Look <A HREF="h_edit_nav_cmds">here</A>
32304 to see the available Editing and Navigation commands.
32305 <P>
32306 &lt;End of help on this topic&gt;
32307 </BODY>
32308 </HTML>
32309 ====== h_config_index_color =====
32310 <HTML>
32311 <HEAD>
32312 <TITLE>OPTION: Index Colors</TITLE>
32313 </HEAD>
32314 <BODY>
32315 <H1>OPTION: Index Colors</H1>
32316
32317 You may add color to the single character symbols that give the status
32318 of each message in the MESSAGE INDEX.
32319 By default the characters &quot;+&quot;, &quot;*&quot;, &quot;D&quot;,
32320 &quot;A&quot;, and &quot;N&quot; show up near the left hand side of the
32321 screen depending on whether the message is addressed to you, and whether
32322 the message is marked Important, is Deleted, is Answered, or is New.
32323 The color for each of those characters may be specified by setting the
32324 &quot;Index-to-me&quot; Symbol Color,
32325 the &quot;Index-important&quot; Symbol Color,
32326 the &quot;Index-deleted&quot; Symbol Color,
32327 the &quot;Index-answered&quot; Symbol Color,
32328 and the &quot;Index-new&quot; Symbol Color.
32329 There are also two other symbol colors called &quot;Index-recent&quot;
32330 and &quot;Index-unseen&quot;.
32331 These two colors will only be used if you have configured your
32332 &quot;<A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A>&quot; option
32333 to include the &quot;IMAPSTATUS&quot; or &quot;SHORTIMAPSTATUS&quot; token.
32334 <P>
32335 The default colors for these symbols are:
32336 <TABLE>
32337 <TR> <TD> &nbsp;&nbsp;Index-to-me&nbsp;&nbsp;&nbsp;&nbsp; </TD> <TD> black on cyan </TD> </TR>
32338 <TR> <TD> &nbsp;&nbsp;Index-important </TD> <TD> white on bright red </TD> </TR>
32339 <TR> <TD> &nbsp;&nbsp;Index-deleted&nbsp;&nbsp; </TD> <TD> same as Normal Color </TD> </TR>
32340 <TR> <TD> &nbsp;&nbsp;Index-answered&nbsp; </TD> <TD> bright red on yellow </TD> </TR>
32341 <TR> <TD> &nbsp;&nbsp;Index-new&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </TD> <TD> white on magenta </TD> </TR>
32342 <TR> <TD> &nbsp;&nbsp;Index-recent&nbsp;&nbsp;&nbsp; </TD> <TD> same as Normal Color </TD> </TR>
32343 <TR> <TD> &nbsp;&nbsp;Index-unseen&nbsp;&nbsp;&nbsp; </TD> <TD> same as Normal Color </TD> </TR>
32344 </TABLE>
32345 <P>
32346 Besides coloring the message status symbols, you may also color the
32347 entire index line.
32348 This is done by using the
32349 <A HREF="h_rules_incols">SETUP INDEX LINE COLORS</A> screen, which you
32350 may get to with the commands <EM>S</EM>etup/<EM>R</EM>ules/<EM>I</EM>ndexcolor.
32351 When the entire line is colored that color will be &quot;behind&quot; the
32352 status symbol colors talked about in the paragraph above.
32353 <P>
32354 You may also color
32355 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>
32356 in the index using the
32357 Setup/Kolor screen (<A HREF="h_config_kw_color">Keyword Colors</A>);
32358 the <A HREF="h_config_index_arrow_color">ARROW</A> cursor;
32359 the Subject using
32360 <A HREF="h_config_index_subject_color">Index Subject Color</A>;
32361 the From field using
32362 <A HREF="h_config_index_from_color">Index From Color</A>;
32363 and the
32364 <A HREF="h_config_index_opening_color">Index Opening</A> text.
32365 <P>
32366 <A HREF="h_color_setup">Descriptions of the available commands</A>
32367 <P>
32368 Look <A HREF="h_edit_nav_cmds">here</A>
32369 to see the available Editing and Navigation commands.
32370 <P>
32371 &lt;End of help on this topic&gt;
32372 </BODY>
32373 </HTML>
32374 ====== h_config_metamsg_color =====
32375 <HTML>
32376 <HEAD>
32377 <TITLE>OPTION: Meta-Message Color</TITLE>
32378 </HEAD>
32379 <BODY>
32380 <H1>OPTION: Meta-Message Color</H1>
32381
32382 Sets the color Alpine uses in the MESSAGE TEXT screen for messages to you
32383 that aren't part of the message itself.
32384 For example, an attachment that isn't shown might produce a meta
32385 message something like:
32386 <P>
32387 <CENTER><SAMP> [ Part 2, &quot;comment&quot; Text/PLAIN (Name: &quot;file&quot;) ]</SAMP></CENTER>
32388 <P>
32389 If you set the
32390 <A HREF="h_config_quote_suppression"><!--#echo var="VAR_quote-suppression-threshold"--></A>
32391 option you might see
32392 <P>
32393 <CENTER><SAMP>[ 12 lines of quoted text hidden from view ]</SAMP></CENTER>
32394 <P>
32395 Warnings about suspicious looking URLs in HTML will also be colored
32396 with this color.
32397 <P>
32398 The foreground color is the color of the actual character and the
32399 background color is the color of the area behind the character.
32400 By default, the Meta-Message Color is black characters on a yellow background.
32401 <P>
32402 <A HREF="h_color_setup">Descriptions of the available commands</A>
32403 <P>
32404 Look <A HREF="h_edit_nav_cmds">here</A>
32405 to see the available Editing and Navigation commands.
32406 <P>
32407 &lt;End of help on this topic&gt;
32408 </BODY>
32409 </HTML>
32410 ====== h_config_keylabel_color =====
32411 <HTML>
32412 <HEAD>
32413 <TITLE>OPTION: KeyLabel Color</TITLE>
32414 </HEAD>
32415 <BODY>
32416 <H1>OPTION: KeyLabel Color</H1>
32417
32418 Sets the color Alpine uses for the labels of the keys in the two-line
32419 menu at the bottom of the screen.
32420 For example, some of the screens have a &quot;P PrevMsg&quot; command.
32421 This option sets the color used when displaying &quot;PrevMsg&quot;.
32422 The foreground color is the color of the actual character and the
32423 background color is the color of the area behind the character.
32424 By default, the KeyLabel Color is the same as the Normal Color.
32425 <P>
32426 WARNING: Some terminal emulators have the property that the screen will scroll
32427 down one line whenever a character is written to the character cell in the
32428 lower right corner of the screen.
32429 Alpine can usually avoid writing a character in that corner of the screen.
32430 However, if you have defined a KeyLabel Color then Alpine does have to write
32431 a character in that cell in order to color the cell correctly.
32432 If you find that your display sometimes scrolls up a line this could be
32433 the problem.
32434 The most obvious symptom is probably that the titlebar at the top of the
32435 screen scrolls off the screen.
32436 Try setting KeyLabel Color to Default to see if that fixes the problem.
32437 <P>
32438 <A HREF="h_color_setup">Descriptions of the available commands</A>
32439 <P>
32440 Look <A HREF="h_edit_nav_cmds">here</A>
32441 to see the available Editing and Navigation commands.
32442 <P>
32443 &lt;End of help on this topic&gt;
32444 </BODY>
32445 </HTML>
32446 ====== h_config_keyname_color =====
32447 <HTML>
32448 <HEAD>
32449 <TITLE>OPTION: KeyName Color</TITLE>
32450 </HEAD>
32451 <BODY>
32452 <H1>OPTION: KeyName Color</H1>
32453
32454 Sets the color Alpine uses for the names of the keys in the two-line
32455 menu at the bottom of the screen.
32456 For example, some of the screens have a &quot;P PrevMsg&quot; command.
32457 This option sets the color used when displaying the &quot;P&quot;.
32458 The foreground color is the color of the actual character and the
32459 background color is the color of the area behind the character.
32460 By default, the KeyName Color is the same as the Reverse Color.
32461 <P>
32462 <A HREF="h_color_setup">Descriptions of the available commands</A>
32463 <P>
32464 Look <A HREF="h_edit_nav_cmds">here</A>
32465 to see the available Editing and Navigation commands.
32466 <P>
32467 &lt;End of help on this topic&gt;
32468 </BODY>
32469 </HTML>
32470 ====== h_config_slctbl_color =====
32471 <HTML>
32472 <HEAD>
32473 <TITLE>OPTION: Selectable Item Color</TITLE>
32474 </HEAD>
32475 <BODY>
32476 <H1>OPTION: Selectable Item Color</H1>
32477
32478 Sets the color Alpine uses for selectable items, such as URLs.
32479 The foreground color is the color of the actual character and the
32480 background color is the color of the area behind the character.
32481 By default, the Selectable Item Color is the same as the Normal Color,
32482 except that it is bold.
32483 <P>
32484 <A HREF="h_color_setup">Descriptions of the available commands</A>
32485 <P>
32486 Look <A HREF="h_edit_nav_cmds">here</A>
32487 to see the available Editing and Navigation commands.
32488 <P>
32489 &lt;End of help on this topic&gt;
32490 </BODY>
32491 </HTML>
32492 ====== h_config_quote_color =====
32493 <HTML>
32494 <HEAD>
32495 <TITLE>OPTION: Quote Colors</TITLE>
32496 </HEAD>
32497 <BODY>
32498 <H1>OPTION: Quote Colors</H1>
32499
32500 Sets the colors Alpine uses for coloring quoted text in the MESSAGE TEXT
32501 screen.
32502 If a line begins with a &gt; character (or space followed by &gt;)
32503 it is considered a quote.
32504 That line will be given the Quote1 Color (first level quote).
32505 If there is a second level of quoting then the Quote2 Color will be used.
32506 Alpine considers there to be a second level of quoting if that first &gt; is
32507 followed by another &gt; (or space followed by &gt;).
32508 If there are characters other than whitespace and &gt; signs, then it isn't
32509 considered another level of quoting.
32510 Similarly, if there is a third level of quoting the Quote3 Color will be
32511 used.
32512 If there are more levels after that the Quote Colors are re-used.
32513 If you define all three colors then it would repeat like Color1, Color2, Color3,
32514 Color1, Color2, Color3, ...
32515 If you only define the first two it would be
32516 Color1, Color2, Color1, Color2, ...
32517 If you define only the Quote1 Color, then the entire quote would be that
32518 color regardless of the quoting levels.
32519 By default, the Quote1 Color is black characters on a greenish-blue background;
32520 the Quote2 Color is black characters on a dull yellow background; and
32521 the Quote3 Color is black characters on a green background.
32522 <P>
32523 <A HREF="h_color_setup">Descriptions of the available commands</A>
32524 <P>
32525 Look <A HREF="h_edit_nav_cmds">here</A>
32526 to see the available Editing and Navigation commands.
32527 <P>
32528 &lt;End of help on this topic&gt;
32529 </BODY>
32530 </HTML>
32531 ====== h_config_folder_color =====
32532 <HTML>
32533 <HEAD>
32534 <TITLE>OPTION: Folder Color</TITLE>
32535 </HEAD>
32536 <BODY>
32537 <H1>OPTION: Folder Color</H1>
32538
32539 Sets the colors Alpine uses for coloring a folder in the FOLDER LIST
32540 screen. By default, the Folder Color is the normal text color.
32541
32542 <P>
32543 If you set a color for this feature, other than the normal color
32544 (the default), or a color for
32545 <A HREF="h_config_directory_color">Directory Color</A>, then directories
32546 will be colored according to the color specified in the
32547 <A HREF="h_config_directory_color">Directory Color</A> option. In this
32548 case, the color will be the only indication that the colored name
32549 refers to a directory. The normal behavior is that Alpine
32550 indicates that a name refers to a directory by appending a
32551 separator (like &quot;/&quot; or &quot;.&quot;) to the name of
32552 the folder.
32553
32554 <P>
32555 If a folder is a directory, then the folder name will be painted
32556 according to the color defined by this variable, and a separator
32557 indicator  (like &quot;/&quot; or &quot;.&quot;) will be added
32558 to the name. That
32559 indicator will be painted according to the color defined in the
32560 <A HREF="h_config_directory_color">Directory Color</A> option.
32561
32562 <P>
32563 &lt;End of help on this topic&gt;
32564 </BODY>
32565 </HTML>
32566 ====== h_config_directory_color =====
32567 <HTML>
32568 <HEAD>
32569 <TITLE>OPTION: Directory Color</TITLE>
32570 </HEAD>
32571 <BODY>
32572 <H1>OPTION: Directory Color</H1>
32573
32574 Sets the colors Alpine uses for coloring a directory in the FOLDER LIST
32575 screen. By default, the Folder Color is the normal text color.
32576 <P>
32577 If you set a color for this feature, other than the normal color
32578 (the default), or a color for
32579 <A HREF="h_config_folder_color">Folder Color</A>, then folders
32580 will be colored according to the color specified in the
32581 <A HREF="h_config_folder_color">Folder Color</A> option. In this
32582 case, the color will be the only indication that the colored name
32583 refers to a directory. The normal behavior is that Alpine
32584 indicates that a name refers to a directory by appending a
32585 separator (like &quot;/&quot; or &quot;.&quot;) to the name of
32586 the folder.
32587 <P>
32588 If a folder is a directory, then the folder name will be painted
32589 according to the color defined by the option
32590 <A HREF="h_config_folder_color">Folder Color</A>, and the separator
32591 indicator  (like &quot;/&quot; or &quot;.&quot;) will be added
32592 after the name. That
32593 indicator will be painted according to the color defined in this
32594 option.
32595 <P>
32596 &lt;End of help on this topic&gt;
32597 </BODY>
32598 </HTML>
32599 ====== h_config_folder_list_color =====
32600 <HTML>
32601 <HEAD>
32602 <TITLE>OPTION: Folder-List Color</TITLE>
32603 </HEAD>
32604 <BODY>
32605 <H1>OPTION: Folder-List Color</H1>
32606
32607 Sets the colors Alpine uses for coloring normal text in the FOLDER LIST
32608 screen. By default, the Folder-List Color is the normal text color.
32609 <P>
32610 This text refers to the informative text that Alpine displays so you
32611 can recognize each collection. The color of the content of each collection
32612 is determined by the options <A HREF="h_config_folder_color">Folder Color</A>
32613 and <A HREF="h_config_directory_color">Directory Color</A>.
32614 <P>
32615 Unlike the options
32616 <A HREF="h_config_folder_color">Folder Color</A>
32617 and <A HREF="h_config_directory_color">Directory Color</A>, configuring
32618 this option does not affect the way that Alpine reports folders,
32619 directories and folders that are directories.
32620 <P>
32621 &lt;End of help on this topic&gt;
32622 </BODY>
32623 </HTML>
32624 ====== h_config_incunseen_color =====
32625 <HTML>
32626 <HEAD>
32627 <TITLE>OPTION: Incoming Unseen Color</TITLE>
32628 </HEAD>
32629 <BODY>
32630 <H1>OPTION: Incoming Unseen Color</H1>
32631
32632 If the option
32633 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
32634 is turned on it is possible to highlight the folders that contain
32635 unseen messages by coloring them with this color.
32636 By default, this is the same as the Normal Color and no highlighting is done.
32637 <P>
32638 Usually the &quot;current&quot; folder (the folder the cursor is on)
32639 is highlighted using reverse video.
32640 If the current folder is colored because it contains unseen messages then
32641 the color used to show that it is also the current folder is controlled
32642 by the
32643 <A HREF="h_config_index_color_style"><!--#echo var="VAR_current-indexline-style"--></A>
32644 feature at the top of the SETUP COLOR screen.
32645 <P>
32646 <A HREF="h_color_setup">Descriptions of the available commands</A>
32647 <P>
32648 Look <A HREF="h_edit_nav_cmds">here</A>
32649 to see the available Editing and Navigation commands.
32650 <P>
32651 &lt;End of help on this topic&gt;
32652 </BODY>
32653 </HTML>
32654 ====== h_config_signature_color =====
32655 <HTML>
32656 <HEAD>
32657 <TITLE>OPTION: Signature Color</TITLE>
32658 </HEAD>
32659 <BODY>
32660 <H1>OPTION: Signature Color</H1>
32661
32662 Sets the color Alpine uses for coloring the signature in the MESSAGE TEXT
32663 screen. According to USENET conventions, the signature is defined as the
32664 paragraph following the &quot;sigdashes&quot;, that is, the special line
32665 consisting of the three characters
32666 &quot;--&nbsp;&quot; (i.e., dash, dash, and space). Alpine allows for one
32667 empty line right after the sigdashes to be considered as part of the
32668 signature.
32669 By default, the Signature Color is blue characters on a white background.
32670 <P>
32671 <A HREF="h_color_setup">Descriptions of the available commands</A>
32672 <P>
32673 Look <A HREF="h_edit_nav_cmds">here</A>
32674 to see the available Editing and Navigation commands.
32675 <P>
32676 &lt;End of help on this topic&gt;
32677 </BODY>
32678 </HTML>
32679 ====== h_config_prompt_color =====
32680 <HTML>
32681 <HEAD>
32682 <TITLE>OPTION: Prompt Color</TITLE>
32683 </HEAD>
32684 <BODY>
32685 <H1>OPTION: Prompt Color</H1>
32686
32687 Sets the color Alpine uses for confirmation prompts and questions that
32688 appear in the status line near the bottom of the screen.
32689 The foreground color is the color of the actual character and the
32690 background color is the color of the area behind the character.
32691 By default, the Prompt Color is the same as the Reverse Color.
32692 <P>
32693 <A HREF="h_color_setup">Descriptions of the available commands</A>
32694 <P>
32695 Look <A HREF="h_edit_nav_cmds">here</A>
32696 to see the available Editing and Navigation commands.
32697 <P>
32698 &lt;End of help on this topic&gt;
32699 </BODY>
32700 </HTML>
32701 ====== h_config_header_general_color =====
32702 <HTML>
32703 <HEAD>
32704 <TITLE>OPTION: Header General Color</TITLE>
32705 </HEAD>
32706 <BODY>
32707 <H1>OPTION: Header General Color</H1>
32708
32709 Sets the color Alpine uses for the headers of a message in the MESSAGE TEXT
32710 screen.
32711 The foreground color is the color of the actual character and the
32712 background color is the color of the area behind the character.
32713 By default, this is the same as the Normal Color.
32714 <P>
32715 It is also possible to set the colors for specific header fields, for
32716 example the Subject, using
32717 <A HREF="h_config_customhdr_color"><!--#echo var="VAR_viewer-hdr-colors"--></A>.
32718 If both a Header General Color and a specific Viewer Header Color are set
32719 the specific color will override the general color, as you would expect.
32720 <P>
32721 <A HREF="h_color_setup">Descriptions of the available commands</A>
32722 <P>
32723 Look <A HREF="h_edit_nav_cmds">here</A>
32724 to see the available Editing and Navigation commands.
32725 <P>
32726 &lt;End of help on this topic&gt;
32727 </BODY>
32728 </HTML>
32729 ====== h_config_incol =====
32730 <HTML>
32731 <HEAD>
32732 <TITLE>Index Line Color</TITLE>
32733 </HEAD>
32734 <BODY>
32735 <H1>Index Line Color</H1>
32736
32737 This option is used to set the color of a line in the index when the
32738 message for that line matches the Pattern.
32739 This colors the whole index line, except possibly the status letters,
32740 which may be colored separately using the
32741 <A HREF="h_color_setup">Setup Kolor</A> screen.
32742 The foreground color is the color of the actual characters and the
32743 background color is the color of the area behind the characters.
32744 <P>
32745 <A HREF="h_color_setup">Descriptions of the available commands</A>
32746 <P>
32747 Look <A HREF="h_edit_nav_cmds">here</A>
32748 to see the available Editing and Navigation commands.
32749 <P>
32750 &lt;End of help on this topic&gt;
32751 </BODY>
32752 </HTML>
32753 ====== h_config_usetransparent_color =====
32754 <HTML>
32755 <HEAD>
32756 <TITLE>OPTION: Use Transparent Color</TITLE>
32757 </HEAD>
32758 <BODY>
32759 <H1>OPTION: Use Transparent Color</H1>
32760
32761 This is a special color supported by some terminal emulators.
32762 It is intended to result in the default foreground or background color
32763 from the terminal emulator.
32764 This is the color the terminal was displaying characters in before you started Alpine.
32765 The reason it is called Transparent is because you could set the foreground color
32766 to some specific color, like Red, and then set the background color to the
32767 Transparent Color. If it works as expected, the background color from the terminal
32768 window in which Alpine is running will show through but with the Red characters
32769 in the foreground.
32770 <P>
32771 <A HREF="h_color_setup">Descriptions of the available commands</A>
32772 <P>
32773 Look <A HREF="h_edit_nav_cmds">here</A>
32774 to see the available Editing and Navigation commands.
32775 <P>
32776 &lt;End of help on this topic&gt;
32777 </BODY>
32778 </HTML>
32779 ====== h_config_usenormal_color =====
32780 <HTML>
32781 <HEAD>
32782 <TITLE>OPTION: Use Normal Color</TITLE>
32783 </HEAD>
32784 <BODY>
32785 <H1>OPTION: Use Normal Color</H1>
32786
32787 When you use this color value, the actual color used will be the same
32788 as the corresponding Normal Color.
32789 For example if your Normal Color is black on white and you set both
32790 the foreground and background colors here to use the Normal Color, you'll
32791 get black on white. If you later change the Normal Color to red on blue
32792 this color will also change to red on blue.
32793 <P>
32794 <A HREF="h_color_setup">Descriptions of the available commands</A>
32795 <P>
32796 Look <A HREF="h_edit_nav_cmds">here</A>
32797 to see the available Editing and Navigation commands.
32798 <P>
32799 &lt;End of help on this topic&gt;
32800 </BODY>
32801 </HTML>
32802 ====== h_config_usenone_color =====
32803 <HTML>
32804 <HEAD>
32805 <TITLE>OPTION: Use None Color</TITLE>
32806 </HEAD>
32807 <BODY>
32808 <H1>OPTION: Use None Color</H1>
32809
32810 This is a special color that simply means to leave the color alone.
32811 It is useful for Index symbols and for Keyword Colors used in the Subject
32812 field of an index line.
32813 The most likely use is to set an explicit foreground color and then set
32814 the background color to the None Color.
32815 That will cause the symbol or keyword to be drawn in the foreground color
32816 with a background equal to whatever color the rest of the index line is already
32817 drawn in.
32818 You will see no visible effect unless you have assigned Indexcolor Rules to
32819 color index lines or you have set an actual color for the Reverse Color.
32820 <P>
32821 <A HREF="h_color_setup">Descriptions of the available commands</A>
32822 <P>
32823 Look <A HREF="h_edit_nav_cmds">here</A>
32824 to see the available Editing and Navigation commands.
32825 <P>
32826 &lt;End of help on this topic&gt;
32827 </BODY>
32828 </HTML>
32829 ====== h_config_dflt_color =====
32830 <HTML>
32831 <HEAD>
32832 <TITLE>OPTION: Default Color</TITLE>
32833 </HEAD>
32834 <BODY>
32835 <H1>OPTION: Default Color</H1>
32836
32837 Setting default will cause the color to be the default color.
32838 Unsetting default is normally done by choosing a color, but in some cases
32839 you may want to declare the current default color to be your non-default
32840 choice.
32841 For example, the default Keyname Color is the same as the Reverse Color.
32842 Whenever the Reverse Color changes the Keyname Color will also change, unless
32843 you've changed it or unset the default box.
32844 <P>
32845 <A HREF="h_color_setup">Descriptions of the available commands</A>
32846 <P>
32847 Look <A HREF="h_edit_nav_cmds">here</A>
32848 to see the available Editing and Navigation commands.
32849 <P>
32850 &lt;End of help on this topic&gt;
32851 </BODY>
32852 </HTML>
32853 ====== h_config_bold_slctbl =====
32854 <HTML>
32855 <HEAD>
32856 <TITLE>OPTION: Bold</TITLE>
32857 </HEAD>
32858 <BODY>
32859 <H1>OPTION: Bold</H1>
32860
32861 The color for this particular section may have the Bold attribute turned
32862 on or off.
32863 Setting bold will cause the characters to be bold.
32864 <P>
32865 <A HREF="h_color_setup">Descriptions of the available commands</A>
32866 <P>
32867 Look <A HREF="h_edit_nav_cmds">here</A>
32868 to see the available Editing and Navigation commands.
32869 <P>
32870 &lt;End of help on this topic&gt;
32871 </BODY>
32872 </HTML>
32873 ====== h_config_kw_color =====
32874 <HTML>
32875 <HEAD>
32876 <TITLE>OPTION: Keyword Colors</TITLE>
32877 </HEAD>
32878 <BODY>
32879 <H1>OPTION: Keyword Colors</H1>
32880
32881 Sets the colors Alpine uses for Keyword fields in the MESSAGE INDEX screen.
32882 Keywords are displayed as part of the Subject by default.
32883 They are also displayed as part of the Subject if the tokens
32884 &quot;SUBJKEY&quot;, &quot;SUBJKEYTEXT&quot;, &quot;SUBJKEYINIT&quot;, or &quot;SUBJKEYINITTEXT&quot; are used in the
32885 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option.
32886 Keywords may also be displayed in a column of their own in the MESSAGE INDEX
32887 screen by using the &quot;KEY&quot; or &quot;KEYINIT&quot; tokens.
32888 <P>
32889 For example, you might have set up a Keyword
32890 &quot;Work&quot; using the
32891 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in the Setup/Config screen.
32892 You could cause that Keyword to show up as a special color
32893 by setting up the Keyword Color using this option, and then including it
32894 in the MESSAGE INDEX screen using one of the tokens listed above in the
32895 <!--#echo var="VAR_index-format"-->.
32896 <P>
32897 <A HREF="h_color_setup">Descriptions of the available commands</A>
32898 <P>
32899 Look <A HREF="h_edit_nav_cmds">here</A>
32900 to see the available Editing and Navigation commands.
32901 <P>
32902 &lt;End of help on this topic&gt;
32903 </BODY>
32904 </HTML>
32905 ====== h_config_customhdr_color =====
32906 <HTML>
32907 <HEAD>
32908 <TITLE>OPTION: <!--#echo var="VAR_viewer-hdr-colors"--></TITLE>
32909 </HEAD>
32910 <BODY>
32911 <H1>OPTION: <!--#echo var="VAR_viewer-hdr-colors"--></H1>
32912
32913 Sets the colors Alpine uses for specific header fields in the MESSAGE TEXT screen.
32914 For example, you may set the color of the Subject header or the From header.
32915 The foreground color is the color of the actual character and the
32916 background color is the color of the area behind the character.
32917 <P>
32918 In addition to setting the colors for particular headers (like the Subject)
32919 you may also set a color to be used for all headers unless overridden by a
32920 more specific Viewer Header Color.
32921 To do this use the
32922 <A HREF="h_config_header_general_color">Header General Color</A>.
32923 <P>
32924 For Header Colors,
32925 there is an additional line on the
32926 screen labeled &quot;Pattern to match&quot;.
32927 If you leave that blank, then the whole field for that header will
32928 be colored.
32929 However, if you give a pattern to match, the coloring will only take place
32930 if there is a match for that pattern in the value of the field.
32931 For example, if you are working on a color for the Subject header and
32932 you fill in a pattern of &quot;important&quot;, then only Subjects that
32933 contain the word &quot;important&quot; will be colored.
32934 <P>
32935 If the pattern you enter is a comma-separated list of patterns, then coloring
32936 happens if any of those patterns matches.
32937 <P>
32938 <A HREF="h_color_setup">Descriptions of the available commands</A>
32939 <P>
32940 Look <A HREF="h_edit_nav_cmds">here</A>
32941 to see the available Editing and Navigation commands.
32942 <P>
32943 &lt;End of help on this topic&gt;
32944 </BODY>
32945 </HTML>
32946 ====== h_config_indextoken_color =====
32947 <HTML>
32948 <HEAD>
32949 <TITLE>OPTION: <!--#echo var="VAR_index-token-colors"--></TITLE>
32950 </HEAD>
32951 <BODY>
32952 <H1>OPTION: <!--#echo var="VAR_index-token-colors"--></H1>
32953
32954 This option allows you to set up the color in which any token, not specified by the
32955 previous options, will be colored in the MESSAGE INDEX screen.
32956 <P>
32957 In order to use this option, you must press the &quot;I&quot; <B>IndxHdr</B> command, and add
32958 a token that can be used in the index format.
32959 The list of available tokens is <A HREF="h_index_tokens">here</A>.
32960 <P>
32961 If you fail to enter a valid token your entry will be ignored, and you will be asked to
32962 enter a new one. Once you have entered a valid token, a line will be added to the
32963 configuration screen that you can use to set up the colors in which that token will
32964 be painted. This is done in the same way that you configure colors for other
32965 variables.
32966
32967 <A HREF="h_color_setup">Descriptions of the available commands</A>
32968 <P>
32969 Look <A HREF="h_edit_nav_cmds">here</A>
32970 to see the available Editing and Navigation commands.
32971 <P>
32972 &lt;End of help on this topic&gt;
32973 </BODY>
32974 </HTML>
32975 ====== h_config_customhdr_pattern =====
32976 <HTML>
32977 <HEAD>
32978 <TITLE>OPTION: Viewer Header Color Pattern</TITLE>
32979 </HEAD>
32980 <BODY>
32981 <H1>OPTION: Viewer Header Color Pattern</H1>
32982
32983 If you leave this blank, then the whole field for the header will
32984 be colored.
32985 If you give a pattern to match, the coloring will only take place
32986 if there is a match for that pattern in the value of the field.
32987 For example, if you are working on a color for the Subject header and
32988 you fill in a pattern of &quot;important&quot;, then only Subjects that
32989 contain the word &quot;important&quot; will be colored.
32990 <P>
32991 For address headers (like From and To) and for the Newsgroups header,
32992 a pattern match will cause only the matched addresses or newsgroups to be
32993 colored.
32994 If there is no pattern to match, then all of the addresses or newsgroups
32995 in the relevant header will be colored.
32996 <P>
32997 The matching pattern may be a comma-separated list of patterns to match
32998 instead of a single pattern.
32999 For example, you could use the pattern &quot;important,urgent&quot; which would
33000 cause a match if either the word &quot;important&quot; or the word
33001 &quot;urgent&quot; appeared in the value of the header.
33002 You could list several comma-separated email addresses in the Header
33003 From Color pattern so that those addresses will be colored when any of
33004 them appear in the From header.
33005 <P>
33006 To add a new matching pattern or change the existing pattern use the
33007 <!--chtml if pinemode="function_key"-->
33008 &quot;F4&quot;
33009 <!--chtml else-->
33010 &quot;C&quot;
33011 <!--chtml endif-->
33012 &quot;Change&quot; command that is available when the &quot;Pattern to
33013 match&quot; line is highlighted.
33014 The
33015 <!--chtml if pinemode="function_key"-->
33016 &quot;F10&quot;
33017 <!--chtml else-->
33018 &quot;D&quot;
33019 <!--chtml endif-->
33020 &quot;Delete&quot; command may be used to quickly remove all patterns
33021 for a particular header.
33022 <P>
33023 &lt;End of help on this topic&gt;
33024 </BODY>
33025 </HTML>
33026 ====== h_color_setup =====
33027 <HTML>
33028 <HEAD>
33029 <TITLE>SETUP COLOR COMMANDS</TITLE>
33030 </HEAD>
33031 <BODY>
33032 <H1>SETUP COLOR COMMANDS</H1>
33033 <!--chtml if pinemode="function_key"-->
33034 <PRE>
33035 Available Commands -- Group 1
33036 -------------------------------
33037 F1  Display this help text
33038 F2  Show other available commands
33039 F3  Exit to MAIN MENU
33040 F4  Select the highlighted foreground or background color
33041 F5  Move to previous line
33042 F6  Move to next line
33043 F7  Previous page
33044 F8  Next page
33045 F9  Add a config section for a header field
33046 F10 Restore all default colors (for all sections)
33047 F11 Print color configuration screen
33048 F12 Whereis (search for word)
33049
33050 Available Commands -- Group 2
33051 -------------------------------
33052 F1  Display this help text
33053 F2  Show other available commands
33054 F5  Delete config section for highlighted header field
33055 F6  Shuffle the order of Header Color sections
33056 </PRE>
33057 <!--chtml else-->
33058 <PRE>
33059 General commands
33060 -------------------------------------------------
33061  ?  Display this help text     E  Exit back to MAIN MENU
33062  P  Previous Line              N  Next Line
33063  -  Previous page             Spc (space bar) Next page
33064  W  WhereIs (search for word)  %  Print color configuration screen
33065
33066 Color Setup Commands
33067 ------------------------------------------------
33068  *  Select the highlighted foreground or background color
33069  A  Add a config section for a header field
33070  D  Delete config section for highlighted header field
33071  R  Restore all default colors (for all sections)
33072  $  Shuffle the order of Header Color sections
33073 </PRE>
33074 <!--chtml endif-->
33075
33076 <H2>Description of the Setup Color Screen</H2>
33077
33078 From this screen you may turn on color and set the colors of
33079 various parts of the Alpine display.
33080 For help on turning on color move your cursor into the Color Style section
33081 at the top of the Setup Color screen and ask for help.
33082
33083 <P>
33084 There are several sections in the Setup Color Screen.
33085 At the top are some settings that handle the style of color used
33086 with your terminal emulator (UNIX only), and some settings that
33087 control how the current indexline and the titlebar are colored.
33088 After that comes a long section called GENERAL COLORS that allows
33089 you to set the color of many elements in the Alpine screens.
33090 For example, the color of the titlebar, status messages,
33091 selectable links, quotes and signatures in messages, and so on.
33092 After that is a section called INDEX COLORS that allows you to
33093 set the colors of various pieces of the displayed index lines in
33094 the MESSAGE INDEX screen.
33095 The next section is HEADER COLORS. This is for coloring headers of
33096 messages in the MESSAGE TEXT screen in just about any way you would like.
33097 Finally, the KEYWORD COLORS section allows you to highlight
33098 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>
33099 in the MESSAGE INDEX screen.
33100
33101 <P>
33102 To change a color, highlight the color you want to change (for example,
33103 the Status Color) by moving
33104 the cursor into it.
33105 You may want to read the help text for the color to see a brief desription
33106 of what you are coloring.
33107 Then press &quot;C&quot; for Change to set the color to something new.
33108 That will put you into a screen with two columns of colors, one for
33109 the foreground color and one for the background color.
33110 The foreground color is just the color you want the actual characters
33111 to be and the background color is the color of the rest of the rectangle
33112 behind the characters.
33113 Select the foreground and background colors desired by using the Next and
33114 Prev keys to highlight the color, and the * command to select it.
33115 <P>
33116 To set a color to its default value, set the X in the Default line at
33117 the bottom of the list of colors.
33118 <P>
33119
33120 The HEADER COLORS section is a little bit different from the others.
33121 Besides coloring the specific fields that Alpine knows about, you may also
33122 color specific header fields when viewing a message in the MESSAGE TEXT
33123 screen.
33124 For example, you may color the Subject header a particular color.
33125 There are a few commands for use with headers.
33126 The &quot;AddHeader&quot; command adds a section to the color
33127 configuration screen that allows you to set the color for that header.
33128 You'll be asked for the name of the header field you want to color.
33129 If you wanted to color the Subject, you would answer
33130 with the word &quot;subject&quot;.
33131 Once you've added a header field, the color setting works just like the
33132 other color fields, except that there is an additional line on the
33133 configuration screen labeled &quot;Pattern to match&quot;.
33134 If you leave that blank, then the whole field for that header will always
33135 be colored.
33136 However, if you give a pattern to match, the coloring will only take place
33137 if there is a match for that pattern in the value of the field.
33138 For example, if you are working on a color for the Subject header and
33139 you fill in a pattern of &quot;important&quot;, then only Subjects that
33140 contain the word &quot;important&quot; will be colored.
33141 <P>
33142 The &quot;DeleteHdr&quot; command removes a header section from the
33143 configuration altogether.
33144 The &quot;Shuffle&quot; command changes the order of header sections.
33145 This is only necessary if you use header sections with pattern fields.
33146 For example, if you have two Subject sections, one with one pattern and
33147 another with another pattern, and the subject for a particular message
33148 happens to match both, then the color from the first match is used.
33149 <P>
33150
33151 The command &quot;RestoreDefs&quot; will restore all of the default colors.
33152 Each section will change to the default value used for that section when
33153 color is first enabled.
33154 When you restore all default colors the color settings for the Header Colors
33155 will be unset (since that's the default), but the header fields you've
33156 added will remain so that you may easily reset them.
33157 In order to get rid of them completely you'd have to use
33158 the &quot;DeleteHdr&quot; command.
33159
33160 <P>
33161 Remember that <A HREF="h_rules_incols">Index Line Colors</A>
33162 may be set with matching rules and that is configured separately from
33163 the rest of the color settings described here.
33164 It is configured in the Setup/Rules/Indexcolors section of the configuration screen
33165 instead of in the Setup/Kolor section.
33166
33167 <P><UL>
33168 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33169 </UL><P>
33170 &lt;End of help on this topic&gt;
33171 </BODY>
33172 </HTML>
33173 ====== h_config_news_uses_recent ======
33174 <HTML>
33175 <HEAD>
33176 <TITLE>FEATURE: <!--#echo var="FEAT_news-approximates-new-status"--></TITLE>
33177 </HEAD>
33178 <BODY>
33179 <H1>FEATURE: <!--#echo var="FEAT_news-approximates-new-status"--></H1>
33180
33181 This feature causes certain messages to be marked as "New" in the
33182 MESSAGE INDEX of newsgroups.
33183 This feature is set by default.
33184
33185 <P>
33186
33187 When opening a newsgroup, Alpine will consult your "newsrc" file and
33188 determine the last message you have previously disposed of via the "D"
33189 key.  If this feature is set, any subsequent messages will be shown in the
33190 Index with an "N", and the first of these messages will be highlighted.
33191 Although this is only an approximation of true "New" or "Unseen"
33192 status, it provides a useful cue to distinguish more-or-less recent
33193 messages from those you have seen previously, but are not yet ready to
33194 mark deleted.
33195
33196 <P>
33197
33198 Background: your "newsrc" file (used to store message status information
33199 for newsgroups) is only capable of storing a single flag, and Alpine uses
33200 this to record whether or not you are "done with" a message, as
33201 indicated by marking the message as "Deleted".  Unfortunately, this
33202 means that Alpine has no way to record exactly which messages you have
33203 previously seen, so it normally does not show the "N" status flag for
33204 any messages in a newsgroup. This feature enables a starting
33205 *approximation* of seen/unseen status that may be useful.
33206 <P>
33207 &lt;End of help on this topic&gt;
33208 </BODY>
33209 </HTML>
33210 ====== h_config_expose_hidden_config =====
33211 <HTML>
33212 <HEAD>
33213 <TITLE>FEATURE: <!--#echo var="FEAT_expose-hidden-config"--></TITLE>
33214 </HEAD>
33215 <BODY>
33216 <H1>FEATURE: <!--#echo var="FEAT_expose-hidden-config"--></H1>
33217
33218 If set, this causes configuration options and features that are normally
33219 hidden from view to be editable in the Setup/Config screen.
33220
33221 <P>
33222 The purpose of this feature is to allow you to change configuration
33223 features and variables that are normally hidden.
33224 This is particularly useful if you are using a remote configuration,
33225 where it is difficult to edit the contents manually, but it may also be used
33226 on a local pinerc configuration file.
33227 <P>
33228 If set, several configuration variables and features that are normally
33229 hidden from view will show up in the Setup/Configuration screen.
33230 They will be at the bottom of the configuration screen.
33231 You can find them by searching for the words &quot;hidden configuration&quot;.
33232 <P>
33233
33234 Note that this is an advanced feature that should be used with care.
33235 The reason that this part of the configuration is normally hidden is because
33236 there is a significant potential for causing problems if you change these
33237 variables.
33238 If something breaks after a change try changing it back to see if that is
33239 what is causing the problem.
33240 There are also some variables that are normally hidden because they are
33241 manipulated through Alpine in other ways.
33242 For example, colors are normally set using the Setup/Kolors screen and
33243 the &quot;<!--#echo var="VAR_address-book"-->&quot; variable is normally set using
33244 the Setup/AddressBooks screen, so there is little reason to edit these directly.
33245 The &quot;<!--#echo var="VAR_incoming-folders"-->&quot; variable is normally changed by using
33246 the Add, Delete, and Rename commands in the FOLDER LIST screen,
33247 and the &quot;<!--#echo var="VAR_last-time-prune-questioned"-->&quot; variable is normally used
33248 internally by Alpine and not set directly by the user.
33249 <P>
33250 <UL>
33251 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33252 </UL><P>
33253 &lt;End of help on this topic&gt;
33254 </BODY>
33255 </HTML>
33256 ====== h_config_disable_signature_edit =====
33257 <HTML>
33258 <HEAD>
33259 <TITLE>FEATURE: <!--#echo var="FEAT_disable-signature-edit-cmd"--></TITLE>
33260 </HEAD>
33261 <BODY>
33262 <H1>FEATURE: <!--#echo var="FEAT_disable-signature-edit-cmd"--></H1>
33263
33264 If set, this disables the editing of signature files from within
33265 the Setup/Config screen.
33266 <P>
33267 <UL>
33268 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33269 </UL><P>
33270 &lt;End of help on this topic&gt;
33271 </BODY>
33272 </HTML>
33273 ====== h_config_disable_roles_templateedit =====
33274 <HTML>
33275 <HEAD>
33276 <TITLE>FEATURE: <!--#echo var="FEAT_disable-roles-template-edit"--></TITLE>
33277 </HEAD>
33278 <BODY>
33279 <H1>FEATURE: <!--#echo var="FEAT_disable-roles-template-edit"--></H1>
33280
33281 If set, this disables the editing of template files within the
33282 Role setup screen.
33283 <P>
33284 <UL>
33285 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33286 </UL><P>
33287 &lt;End of help on this topic&gt;
33288 </BODY>
33289 </HTML>
33290 ====== h_config_disable_roles_sigedit =====
33291 <HTML>
33292 <HEAD>
33293 <TITLE>FEATURE: <!--#echo var="FEAT_disable-roles-sig-edit"--></TITLE>
33294 </HEAD>
33295 <BODY>
33296 <H1>FEATURE: <!--#echo var="FEAT_disable-roles-sig-edit"--></H1>
33297
33298 If set, this disables the editing of signature files within the
33299 Role setup screen.
33300 <P>
33301 <UL>
33302 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33303 </UL><P>
33304 &lt;End of help on this topic&gt;
33305 </BODY>
33306 </HTML>
33307 ====== h_config_disable_roles_setup =====
33308 <HTML>
33309 <HEAD>
33310 <TITLE>FEATURE: <!--#echo var="FEAT_disable-roles-setup-cmd"--></TITLE>
33311 </HEAD>
33312 <BODY>
33313 <H1>FEATURE: <!--#echo var="FEAT_disable-roles-setup-cmd"--></H1>
33314
33315 If set, this disables the Setup/Rules/Roles command.
33316 <P>
33317 <UL>
33318 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33319 </UL><P>
33320 &lt;End of help on this topic&gt;
33321 </BODY>
33322 </HTML>
33323 ====== h_config_disable_pipes_in_templates =====
33324 <HTML>
33325 <HEAD>
33326 <TITLE>FEATURE: <!--#echo var="FEAT_disable-pipes-in-templates"--></TITLE>
33327 </HEAD>
33328 <BODY>
33329 <H1>FEATURE: <!--#echo var="FEAT_disable-pipes-in-templates"--></H1>
33330
33331 By default, if a template file name is followed by a vertical bar (|) then
33332 that causes the file to be executed to produce the text for the template.
33333 If this feature is set, then this is not allowed.
33334 <P>
33335 <UL>
33336 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33337 </UL><P>
33338 &lt;End of help on this topic&gt;
33339 </BODY>
33340 </HTML>
33341 ====== h_config_disable_pipes_in_sigs =====
33342 <HTML>
33343 <HEAD>
33344 <TITLE>FEATURE: <!--#echo var="FEAT_disable-pipes-in-sigs"--></TITLE>
33345 </HEAD>
33346 <BODY>
33347 <H1>FEATURE: <!--#echo var="FEAT_disable-pipes-in-sigs"--></H1>
33348
33349 By default, if a signature file name is followed by a vertical bar (|) then
33350 that causes the file to be executed to produce the text for the signature.
33351 If this feature is set, then this is not allowed.
33352 <P>
33353 <UL>
33354 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33355 </UL><P>
33356 &lt;End of help on this topic&gt;
33357 </BODY>
33358 </HTML>
33359 ====== h_config_disable_password_cmd =====
33360 <HTML>
33361 <HEAD>
33362 <TITLE>FEATURE: <!--#echo var="FEAT_disable-password-cmd"--></TITLE>
33363 </HEAD>
33364 <BODY>
33365 <H1>FEATURE: <!--#echo var="FEAT_disable-password-cmd"--></H1>
33366
33367 If set, then the Setup/Newpassword command is disabled.
33368 <P>
33369 <UL>
33370 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33371 </UL><P>
33372 &lt;End of help on this topic&gt;
33373 </BODY>
33374 </HTML>
33375 ====== h_config_disable_password_caching =====
33376 <HTML>
33377 <HEAD>
33378 <TITLE>FEATURE: <!--#echo var="FEAT_disable-password-caching"--></TITLE>
33379 </HEAD>
33380 <BODY>
33381 <H1>FEATURE: <!--#echo var="FEAT_disable-password-caching"--></H1>
33382
33383 Normally, loginname/password combinations are cached in Alpine so that
33384 you do not have to enter the same password more than once in a session.
33385 A disadvantage to this approach is that the password must be stored in
33386 the memory image of the running Alpine in order that it can be re-used.
33387 In the event that Alpine crashes and produces a core dump, and that core
33388 dump is readable by others, the loginname and password could be read
33389 from the core dump.
33390 <P>
33391 If this feature is set, then the passwords will not be cached and you
33392 will have to retype the password whenever Alpine needs it.
33393 Even with this feature set there is still some chance that the core
33394 file will contain a password, so care should be taken to make the
33395 core files unreadable.
33396 <P>
33397 NOTE: If PASSFILE caching is enabled, this does not disable it.
33398 That is a separate and independent feature.
33399 <UL>
33400 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33401 </UL><P>
33402 &lt;End of help on this topic&gt;
33403 </BODY>
33404 </HTML>
33405 ====== h_config_disable_password_file_saving =====
33406 <HTML>
33407 <HEAD>
33408 <TITLE>FEATURE: <!--#echo var="FEAT_disable-password-file-saving"--></TITLE>
33409 </HEAD>
33410 <BODY>
33411 <H1>FEATURE: <!--#echo var="FEAT_disable-password-file-saving"--></H1>
33412
33413 This feature changes the behavior of Alpine when a login name and password combination
33414 for a specific server is not found in the password file. The default behavior is that
33415 Alpine will ask the user if they wish to save this information in the password file for future
33416 use. It is assumed that if a user created a password file it is because they intend
33417 to use it, but in some instances a user might want to save some passwords and not others.
33418 In this case, enabling this feature will make Alpine not add any more passwords to the
33419 password file and will only use the passwords that it already saved. If you wish to allow
33420 Alpine to save more passwords in the password file, disable this feature.
33421 <P>
33422 <UL>
33423 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33424 </UL><P>
33425 &lt;End of help on this topic&gt;
33426 </BODY>
33427 </HTML>
33428 ====== h_config_disable_kb_lock =====
33429 <HTML>
33430 <HEAD>
33431 <TITLE>FEATURE: <!--#echo var="FEAT_disable-keyboard-lock-cmd"--></TITLE>
33432 </HEAD>
33433 <BODY>
33434 <H1>FEATURE: <!--#echo var="FEAT_disable-keyboard-lock-cmd"--></H1>
33435
33436 If set, then the Keyboard Lock command is removed from the MAIN MENU.
33437 <P>
33438 <UL>
33439 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33440 </UL><P>
33441 &lt;End of help on this topic&gt;
33442 </BODY>
33443 </HTML>
33444 ====== h_config_disable_config_cmd =====
33445 <HTML>
33446 <HEAD>
33447 <TITLE>FEATURE: <!--#echo var="FEAT_disable-config-cmd"--></TITLE>
33448 </HEAD>
33449 <BODY>
33450 <H1>FEATURE: <!--#echo var="FEAT_disable-config-cmd"--></H1>
33451
33452 If set, then the Setup/Config screen is disabled.
33453 <P>
33454 <UL>
33455 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33456 </UL><P>
33457 &lt;End of help on this topic&gt;
33458 </BODY>
33459 </HTML>
33460 ====== h_config_allow_chg_from =====
33461 <HTML>
33462 <HEAD>
33463 <TITLE>FEATURE: <!--#echo var="FEAT_allow-changing-from"--></TITLE>
33464 </HEAD>
33465 <BODY>
33466 <H1>FEATURE: <!--#echo var="FEAT_allow-changing-from"--></H1>
33467
33468 This feature affects Alpine's handling of the &quot;From:&quot; header field
33469 in the "<A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A>" configuration
33470 option.
33471 <P>
33472 If this feature is set then the From line can be changed just like
33473 all the other header fields that can be changed.
33474 This feature defaults to <EM>ON</EM>.
33475 <P>
33476 Even with this feature turned ON (the default) you will not be able
33477 to change the From header unless you add it to your list of
33478 <A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A>.
33479 You may also want to change the
33480 <A HREF="h_config_comp_hdrs"><!--#echo var="VAR_default-composer-hdrs"--></A>
33481 if you want the From header to always show up in the composer without
33482 having to type the Rich Headers command first.
33483 <P>
33484 Note that many sites restrict the use of this feature in order to
33485 reduce the chance of falsified addresses and misdirected mail.
33486 If you want to change the value of what gets included in the From header
33487 in messages you send
33488 look <A HREF="h_config_change_your_from">here</A> for a description.
33489 <P>
33490 <UL>
33491 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33492 </UL><P>
33493 &lt;End of help on this topic&gt;
33494 </BODY>
33495 </HTML>
33496 ====== h_config_disable_collate =====
33497 <HTML>
33498 <HEAD>
33499 <TITLE>FEATURE: <!--#echo var="FEAT_disable-setlocale-collate"--></TITLE>
33500 </HEAD>
33501 <BODY>
33502 <H1>FEATURE: <!--#echo var="FEAT_disable-setlocale-collate"--></H1>
33503
33504 This is a hard to understand feature that should only be used in rare cases.
33505 Normally, the C function call
33506 <P>
33507 <CENTER><SAMP>setlocale(LC_COLLATE, &quot;&quot;)</SAMP></CENTER>
33508 <P>
33509 is used by Alpine.
33510 If you want to try turning it off,
33511 setting this feature will turn it off.
33512 This part of the locale has to do with the sort order
33513 of characters in your locale.
33514 <P>
33515 <UL>
33516 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33517 </UL><P>
33518 &lt;End of help on this topic&gt;
33519 </BODY>
33520 </HTML>
33521 ====== h_config_quell_attach_extra_prompt =====
33522 <HTML>
33523 <HEAD>
33524 <TITLE>FEATURE: <!--#echo var="FEAT_quell-attachment-extra-prompt"--></TITLE>
33525 </HEAD>
33526 <BODY>
33527 <H1>FEATURE: <!--#echo var="FEAT_quell-attachment-extra-prompt"--></H1>
33528
33529 By default, when you attempt to view an attachment externally
33530 from the &quot;Attachment View&quot; screen, you are asked if you
33531 really want to view the selected attachment.
33532
33533 <P>
33534 If this feature is set, you will <B>not</B> be prompted to confirm
33535 your selection.  Prior to Alpine and to Pine 4.50, the default behavior was to not
33536 prompt. This feature was added for those wanting to preserve that
33537 behavior (along with
33538 <A HREF="h_config_quell_attach_ext_warn"><!--#echo var="FEAT_quell-attachment-extension-warn"--></A>).
33539
33540 <P>
33541 <UL>
33542 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33543 </UL><P>
33544 &lt;End of help on this topic&gt;
33545 </BODY>
33546 </HTML>
33547 ====== h_config_quell_attach_ext_warn =====
33548 <HTML>
33549 <HEAD>
33550 <TITLE>FEATURE: <!--#echo var="FEAT_quell-attachment-extension-warn"--></TITLE>
33551 </HEAD>
33552 <BODY>
33553 <H1>FEATURE: <!--#echo var="FEAT_quell-attachment-extension-warn"--></H1>
33554
33555 <P>
33556 This feature suppresses the extra warning you can get when trying
33557 to view an attachment for which there is no mime-type match.  Turning
33558 on this feature will just run the program according to extension
33559 instead of first warning the user that it will run according to the
33560 file's extension.
33561 <P>
33562 This feature can be used along side
33563 <A HREF="h_config_quell_attach_extra_prompt"><!--#echo var="FEAT_quell-attachment-extra-prompt"--></A>
33564 to preserve the behavior exhibited in Pine versions prior to Pine 4.50.
33565 <P>
33566 <UL>
33567 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33568 </UL><P>
33569 &lt;End of help on this topic&gt;
33570 </BODY>
33571 </HTML>
33572 ====== h_config_mailcap_params =====
33573 <HTML>
33574 <HEAD>
33575 <TITLE>FEATURE: <!--#echo var="FEAT_enable-mailcap-param-substitution"--></TITLE>
33576 </HEAD>
33577 <BODY>
33578 <H1>FEATURE: <!--#echo var="FEAT_enable-mailcap-param-substitution"--></H1>
33579
33580 If set, this will allow mailcap named parameter substitution to occur
33581 in mailcap entries.
33582 By default, this is turned off to prevent security problems that may occur
33583 with some incorrect mailcap configurations.
33584 For more information, see RFC1524 and look for "named parameters" in the
33585 text of the RFC.
33586 <P>
33587 <UL>
33588 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33589 </UL><P>
33590 &lt;End of help on this topic&gt;
33591 </BODY>
33592 </HTML>
33593 ====== h_config_disable_shared =====
33594 <HTML>
33595 <HEAD>
33596 <TITLE>FEATURE: <!--#echo var="FEAT_disable-shared-namespaces"--></TITLE>
33597 </HEAD>
33598 <BODY>
33599 <H1>FEATURE: <!--#echo var="FEAT_disable-shared-namespaces"--></H1>
33600
33601 If this feature is set, the automatic search for namespaces &quot;ftp&quot;,
33602 &quot;imapshared&quot;, and &quot;imappublic&quot; by the underlying library
33603 will be disabled.
33604 The reason this feature exists is because there are some implementations
33605 of system password lookup routines that are very slow when presented with
33606 a long loginname that does not exist.
33607 This feature could be set to prevent the delay at startup time when the
33608 names above are searched for in the password file.
33609 <P>
33610 <UL>
33611 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33612 </UL><P>
33613 &lt;End of help on this topic&gt;
33614 </BODY>
33615 </HTML>
33616 ====== h_config_hide_nntp_path =====
33617 <HTML>
33618 <HEAD>
33619 <TITLE>FEATURE: <!--#echo var="FEAT_hide-nntp-path"--></TITLE>
33620 </HEAD>
33621 <BODY>
33622 <H1>FEATURE: <!--#echo var="FEAT_hide-nntp-path"--></H1>
33623
33624 Normally the Path header that Alpine generates when posting to a newsgroup
33625 contains the name of the computer from which the message is being sent and
33626 the user name.
33627 Some believe that this information is used by spammers.
33628 If this feature is set, that information will be replaced with the text
33629 <P>
33630 <CENTER><SAMP>not-for-mail</SAMP></CENTER>
33631 <P>
33632 instead.
33633 <P>
33634 It should be noted that many servers being connected to will still reveal
33635 the information that this feature attempts to protect.
33636 <P>
33637 <UL>
33638 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33639 </UL><P>
33640 &lt;End of help on this topic&gt;
33641 </BODY>
33642 </HTML>
33643 ====== h_config_no_bezerk_zone =====
33644 <HTML>
33645 <HEAD>
33646 <TITLE>FEATURE: <!--#echo var="FEAT_quell-berkeley-format-timezone"--></TITLE>
33647 </HEAD>
33648 <BODY>
33649 <H1>FEATURE: <!--#echo var="FEAT_quell-berkeley-format-timezone"--></H1>
33650
33651 POSIX mandates a timezone in UNIX mailbox format folder delimiters
33652 (the line that begins with From <SPACE>).
33653 Some versions of Berkeley mail have trouble with this, and don't recognize
33654 the line as a message delimiter.
33655 If this feature is set, the timezone will be left off the delimiter line.
33656 <P>
33657 <UL>
33658 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33659 </UL><P>
33660 &lt;End of help on this topic&gt;
33661 </BODY>
33662 </HTML>
33663 ====== h_config_quell_domain_warn =====
33664 <HTML>
33665 <HEAD>
33666 <TITLE>FEATURE: <!--#echo var="FEAT_quell-maildomain-warning"--></TITLE>
33667 </HEAD>
33668 <BODY>
33669 <H1>FEATURE: <!--#echo var="FEAT_quell-maildomain-warning"--></H1>
33670
33671 When your configuration is set up so that your domain name contains no dots,
33672 it is usually a configuration error.
33673 By default, Alpine will warn you about this when you start it up.
33674 You will see a warning message that looks like
33675
33676 <P>
33677 <CENTER><SAMP>Incomplete maildomain &quot;&lt;domain&gt;&quot;.</SAMP></CENTER>
33678
33679 <P>
33680 If this feature is set, the warning is turned off.
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_quell_imap_env =====
33689 <HTML>
33690 <HEAD>
33691 <TITLE>FEATURE: <!--#echo var="FEAT_quell-imap-envelope-update"--></TITLE>
33692 </HEAD>
33693 <BODY>
33694 <H1>FEATURE: <!--#echo var="FEAT_quell-imap-envelope-update"--></H1>
33695
33696 In the MESSAGE INDEX screen, if the open folder is being accessed
33697 using IMAP, Alpine normally tries to paint the index lines on the screen
33698 as soon as the information arrives from the IMAP server.
33699 This means that the index information makes it onto the screen more quickly
33700 than it otherwise would.
33701 This sometimes results in behavior that bothers some users.
33702 For example, when paging to a new page of the index, it may be possible for
33703 the lines to be painted on the screen in a random order, rather than from
33704 top to bottom.
33705 <P>
33706
33707 Setting this feature causes Alpine to wait for all of the information
33708 to be gathered before it paints the index screen.
33709 Once it collects all of the information, the screen will be painted quickly
33710 from top to bottom.
33711 <P>
33712 <UL>
33713 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33714 </UL><P>
33715 &lt;End of help on this topic&gt;
33716 </BODY>
33717 </HTML>
33718 ====== h_config_quell_news_env =====
33719 <HTML>
33720 <HEAD>
33721 <TITLE>FEATURE: <!--#echo var="FEAT_quell-news-envelope-update"--></TITLE>
33722 </HEAD>
33723 <BODY>
33724 <H1>FEATURE: <!--#echo var="FEAT_quell-news-envelope-update"--></H1>
33725
33726 In the MESSAGE INDEX screen, if the open folder is being accessed
33727 using NNTP (News), Alpine normally tries to paint the index lines on the screen
33728 as soon as the information arrives from the NNTP server.
33729 This means that the index information makes it onto the screen more quickly
33730 than it otherwise would.
33731 This sometimes results in behavior that bothers some users.
33732 For example, when paging to a new page of the index, it may be possible for
33733 the lines to be painted on the screen in a random order, rather than from
33734 top to bottom.
33735 <P>
33736
33737 Setting this feature causes Alpine to wait for all of the information
33738 to be gathered before it paints the index screen.
33739 Once it collects all of the information, the screen will be painted quickly
33740 from top to bottom.
33741 <P>
33742 <UL>
33743 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33744 </UL><P>
33745 &lt;End of help on this topic&gt;
33746 </BODY>
33747 </HTML>
33748 ====== h_config_quell_content_id =====
33749 <HTML>
33750 <HEAD>
33751 <TITLE>FEATURE: <!--#echo var="FEAT_quell-content-id"--></TITLE>
33752 </HEAD>
33753 <BODY>
33754 <H1>FEATURE: <!--#echo var="FEAT_quell-content-id"--></H1>
33755
33756 This feature changes the behavior of Alpine when sending messages.
33757 It is intended to work around a bug in Microsoft's Outlook XP mail user
33758 agent.
33759 As of this writing, Microsoft has acknowledged the bug but
33760 has not added it to the Knowledge Base.
33761 We have been told that there will be a post-SP1 hotfix for Outlook XP.
33762 This particular bug has bug fix number OfficeQFE:4781.
33763 The nature of the bug is that messages with attachments that
33764 contain a Content-ID header (which standard Alpine attachments do)
33765 do not show the attachment indicator (a paperclip) when viewed with
33766 Outlook XP.
33767 So the user has no indication that the message contains an attachment.
33768
33769 <P>
33770 If this feature is set then Alpine will remove most Content-ID headers
33771 before sending a message.
33772 If an attachment is of type MESSAGE, then the existing Content-ID headers
33773 inside the message will be left intact.
33774 This would only happen with Alpine if a message was forwarded as an attachment
33775 or if a message with a message attached was forwarded.
33776 Similarly if an attachment of type MULTIPART/ALTERNATIVE is forwarded,
33777 the Content-ID headers of the alternative parts will not be removed.
33778
33779 <P>
33780 Because the Content-ID header is a standard part of MIME it is possible
33781 that setting this feature will break something.
33782 For example, if an attachment has a Content-ID header that is necessary
33783 for the correct functioning of that attachment, it is possible that Alpine
33784 may remove that header when the attachment is forwarded.
33785 However, it seems fairly safe at this time.
33786
33787 <P>
33788 <UL>
33789 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33790 </UL><P>
33791 &lt;End of help on this topic&gt;
33792 </BODY>
33793 </HTML>
33794 ====== h_config_winpos_in_config =====
33795 <HTML>
33796 <HEAD>
33797 <TITLE>FEATURE: <!--#echo var="FEAT_store-window-position-in-config"--></TITLE>
33798 </HEAD>
33799 <BODY>
33800 <H1>FEATURE: <!--#echo var="FEAT_store-window-position-in-config"--></H1>
33801
33802 PC-Alpine only.
33803 <P>
33804
33805 Normally, PC-Alpine will store its window size and position in the
33806 Windows Registry.
33807 This is convenient if you want to use the same remote
33808 configuration from more than one PC.
33809 If you use multiple configuration files to start PC-Alpine, you may want
33810 to store the window size and position in the configuration file instead
33811 of in the Registry.
33812 Setting this feature causes the value to be stored in
33813 <A HREF="h_config_window_position">Window-Position</A>.
33814
33815 <P>
33816 <UL>
33817 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33818 </UL><P>
33819 &lt;End of help on this topic&gt;
33820 </BODY>
33821 </HTML>
33822 ====== h_config_quell_ssl_largeblocks =====
33823 <HTML>
33824 <HEAD>
33825 <TITLE>FEATURE: <!--#echo var="FEAT_quell-ssl-largeblocks"--></TITLE>
33826 </HEAD>
33827 <BODY>
33828 <H1>FEATURE: <!--#echo var="FEAT_quell-ssl-largeblocks"--></H1>
33829
33830 PC-Alpine only.
33831 <P>
33832 This feature changes the behavior of fetching messages
33833 and attachments so that the message data is fetched in chunks no larger
33834 than 12K bytes.
33835 This works around a bug in Microsoft's SSL/TLS support.
33836 Some versions of Microsoft SSL are not able to read full-sized (16K)
33837 SSL/TLS packets.
33838 Some servers will send such packets and this will
33839 cause PC-Alpine to crash with the error
33840
33841 <P>
33842 <CENTER><SAMP>incomplete SecBuffer exceeds maximum buffer size</SAMP></CENTER>
33843
33844 <P>
33845 Microsoft is aware of the problem and has developed a hotfix for it, it is
33846 discussed in article 300562 in the Microsoft Knowledge Base.
33847 <P>
33848 <UL>
33849 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33850 </UL><P>
33851 &lt;End of help on this topic&gt;
33852 </BODY>
33853 </HTML>
33854 ====== h_config_quell_partial =====
33855 <HTML>
33856 <HEAD>
33857 <TITLE>FEATURE: <!--#echo var="FEAT_quell-partial-fetching"--></TITLE>
33858 </HEAD>
33859 <BODY>
33860 <H1>FEATURE: <!--#echo var="FEAT_quell-partial-fetching"--></H1>
33861
33862 Partial fetching is a feature of the IMAP protocol.
33863 By default, Alpine
33864 will use partial fetching when copying the contents of a message or attachment
33865 from the IMAP server to Alpine.
33866 This means that the fetch will be done in many
33867 small chunks instead of one big chunk. The main benefit of this approach is
33868 that the fetch becomes interruptible. That is, the user can type <EM>^C</EM>
33869 to stop the fetch early. In some cases partial fetching may cause a performance
33870 problem so that the fetching of data takes significantly longer when partial
33871 fetching is used. Turning on this feature will turn off partial fetching.
33872 <P>
33873 <UL>
33874 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33875 </UL><P>
33876 &lt;End of help on this topic&gt;
33877 </BODY>
33878 </HTML>
33879 ====== h_config_quell_personal_name_prompt =====
33880 <HTML>
33881 <HEAD>
33882 <TITLE>FEATURE: <!--#echo var="FEAT_quell-personal-name-prompt"--></TITLE>
33883 </HEAD>
33884 <BODY>
33885 <H1>FEATURE: <!--#echo var="FEAT_quell-personal-name-prompt"--></H1>
33886
33887 PC-Alpine only.  This feature quells the prompting for a
33888 <A HREF="h_config_pers_name">personal name</A>.  This
33889 prompt normally happens before composing a message, and only happens when
33890 there is no personal name already set.
33891 <P>
33892 <UL>
33893 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33894 </UL><P>
33895 &lt;End of help on this topic&gt;
33896 </BODY>
33897 </HTML>
33898 ====== h_config_quell_user_id_prompt =====
33899 <HTML>
33900 <HEAD>
33901 <TITLE>FEATURE: <!--#echo var="FEAT_quell-user-id-prompt"--></TITLE>
33902 </HEAD>
33903 <BODY>
33904 <H1>FEATURE: <!--#echo var="FEAT_quell-user-id-prompt"--></H1>
33905
33906 PC-Alpine only.  This feature quells the prompting for a
33907 <A HREF="h_config_user_id"><!--#echo var="VAR_user-id"--></A>
33908 if the information can be obtained from the login name used
33909 to open the INBOX.  Normally, this prompt happens before composing
33910 a message, and only happens when there is no user-id already set
33911 in the configuration.
33912 <P>
33913 With this feature set, composing a message is only possible after
33914 establishing a connection to the INBOX.
33915 <P>
33916 <UL>
33917 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33918 </UL><P>
33919 &lt;End of help on this topic&gt;
33920 </BODY>
33921 </HTML>
33922 ====== h_config_save_aggregates =====
33923 <HTML>
33924 <HEAD>
33925 <TITLE>FEATURE: <!--#echo var="FEAT_save-aggregates-copy-sequence"--></TITLE>
33926 </HEAD>
33927 <BODY>
33928 <H1>FEATURE: <!--#echo var="FEAT_save-aggregates-copy-sequence"--></H1>
33929
33930 This feature will optimize an aggregate copy operation, if
33931 possible, by issuing a single IMAP <EM>COPY</EM> command with a
33932 list of the messages to be copied.
33933 This feature is set by default.
33934 This may reduce network traffic and elapsed time for the Save.
33935 <EM>However, many IMAP servers (including the UW IMAP server) do
33936 not preserve the order of messages when this optimization is applied.</EM>
33937 If this feature is not set,
33938 Alpine will copy each message individually and the order of the messages
33939 will be preserved.
33940 <P>
33941 <UL>
33942 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33943 </UL><P>
33944 &lt;End of help on this topic&gt;
33945 </BODY>
33946 </HTML>
33947 ====== h_config_use_system_translation =====
33948 <HTML>
33949 <HEAD>
33950 <TITLE>FEATURE: Use System Translation</TITLE>
33951 </HEAD>
33952 <BODY>
33953 <H1>FEATURE: Use System Translation</H1>
33954
33955 UNIX Alpine only.
33956 <P>
33957 Alpine normally uses its own internal software to convert between the multi-byte
33958 representation of characters and the Unicode representation of those
33959 same characters.
33960 It converts from the multi-byte characters your keyboard produces to Unicode,
33961 and from Unicode to the multi-byte characters your display expects.
33962 Alpine also uses its own internal software to decide how much space on
33963 the screen a particular Unicode character will occupy.
33964
33965 <P>
33966 Setting this feature tells Alpine to use the system-supplied routines to
33967 perform these tasks instead.
33968 In particular there are three tasks and three system routines that will
33969 be used for these tasks.
33970
33971 <P>
33972 To convert from multi-byte to Unicode the routine
33973
33974 <P>
33975 <CENTER><SAMP>mbstowcs</SAMP></CENTER>
33976 <P>
33977
33978 is used.
33979 To convert from Unicode to multi-byte the routine
33980
33981 <P>
33982 <CENTER><SAMP>wcrtomb</SAMP></CENTER>
33983 <P>
33984
33985 is used.
33986 And to find the screen width a particular Unicode character will
33987 occupy the routine used is
33988
33989 <P>
33990 <CENTER><SAMP>wcwidth</SAMP></CENTER>
33991 <P>
33992
33993 This feature has been only lightly tested.
33994 The internal routines should normally be used unless you run into
33995 a problem that you think may be solved by using the system routines.
33996 Note that your environment needs to be set up for these
33997 routines to work correctly.
33998 In particular, the LANG or LC_CTYPE variable in your environment will
33999 need to be set.
34000
34001 <P>
34002 <UL>
34003 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34004 </UL><P>
34005 &lt;End of help on this topic&gt;
34006 </BODY>
34007 </HTML>
34008 ====== h_config_suspend_spawns =====
34009 <HTML>
34010 <HEAD>
34011 <TITLE>FEATURE: <!--#echo var="FEAT_use-subshell-for-suspend"--></TITLE>
34012 </HEAD>
34013 <BODY>
34014 <H1>FEATURE: <!--#echo var="FEAT_use-subshell-for-suspend"--></H1>
34015
34016 This feature affects Alpine's behavior when process suspension is enabled
34017 and then activated via the Ctrl-Z key.  Alpine suspension allows one to
34018 temporarily interact with the operating system command &quot;shell&quot;
34019 without
34020 quitting Alpine, and then subsequently resume the still-active Alpine session.
34021 <P>
34022
34023 When the <A HREF="h_config_can_suspend">&quot;<!--#echo var="FEAT_enable-suspend"-->&quot;</A> feature
34024 is set and subsequently the Ctrl-Z key
34025 is pressed, Alpine will normally suspend itself and return temporary control
34026 to Alpine's parent shell process.  However, if this feature is set, Alpine
34027 will instead create an inferior subshell process.  This is useful when the
34028 parent process is not intended to be used interactively.  Examples include
34029 invoking Alpine via the -e argument of the Unix &quot;xterm&quot; program,
34030 or via a menu system.<P>
34031
34032 Note that one typically resumes a suspended Alpine by entering the Unix
34033 &quot;fg&quot; command, but if this feature is set, it will be necessary to
34034 enter the &quot;exit&quot; command instead.
34035 <P>
34036 <UL>
34037 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34038 </UL><P>
34039 &lt;End of help on this topic&gt;
34040 </BODY>
34041 </HTML>
34042 ====== h_config_8bit_smtp =====
34043 <HTML>
34044 <HEAD>
34045 <TITLE>FEATURE: <!--#echo var="FEAT_enable-8bit-esmtp-negotiation"--></TITLE>
34046 </HEAD>
34047 <BODY>
34048 <H1>FEATURE: <!--#echo var="FEAT_enable-8bit-esmtp-negotiation"--></H1>
34049
34050 This feature affects Alpine's behavior when sending mail.
34051 By default, this feature is set.
34052 Internet standards
34053 require that all electronic mail messages traversing the global Internet
34054 consist of 7bit ASCII characters unless a pair of cooperating mail
34055 transfer agents explicitly agree to allow 8bit messages.  In general,
34056 then, exchanging messages in non-ASCII characters requires MIME encoding.
34057 <P>
34058 However, there are now Internet standards that allow for unencoded 8bit
34059 exchange of messages between cooperating systems.  When this feature is set
34060 Alpine will try to negotiate unencoded 8bit transmission during the
34061 sending process.  Should the negotiation fail, Alpine will fall back to its
34062 ordinary encoding rules.
34063 <P>
34064 Note, this feature relies on your system's mail transport agent or
34065 configured <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>
34066 having the negotiation mechanism introduced in
34067 &quot;Extended SMTP&quot; (ESMTP) and the specific extension called
34068 &quot;8BITMIME&quot;.
34069 <P>
34070 ESMTP allows for graceful migration to upgraded mail transfer agents, but
34071 it is possible that this feature might cause problems for some servers.
34072 <P><UL>
34073 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34074 </UL>
34075 <P>&lt;End of help on this topic&gt;
34076 </BODY>
34077 </HTML>
34078 ====== h_config_8bit_nntp =====
34079 <HTML>
34080 <HEAD>
34081 <TITLE>FEATURE: <!--#echo var="FEAT_enable-8bit-nntp-posting"--></TITLE>
34082 </HEAD>
34083 <BODY>
34084 <H1>FEATURE: <!--#echo var="FEAT_enable-8bit-nntp-posting"--></H1>
34085
34086 This feature affects Alpine's behavior when posting news.
34087
34088 <P>
34089
34090 The Internet standard for exchanging USENET news messages (RFC-1036)
34091 specifies that USENET messages should conform to Internet mail standards
34092 and contain only 7bit characters, but much of the news transport software
34093 in use today is capable of successfully sending messages containing 8bit
34094 characters.  Hence, many people believe that it is appropriate to send 8bit
34095 news messages without any MIME encoding.
34096
34097 <P>
34098
34099 Moreover, there is no Internet standard for explicitly negotiating 8bit
34100 transfer, as there is for Internet email.  Therefore, Alpine provides the
34101 option of posting unencoded 8bit news messages, though not as the default.
34102 Setting this feature will turn OFF Alpine's MIME encoding of newsgroup
34103 postings that contain 8bit characters.
34104
34105 <P>
34106
34107 Note, articles may cross a path or pass through news transport software
34108 that is unsafe or even hostile to 8bit characters.  At best this will only
34109 cause the posting to become garbled.  The safest way to transmit 8bit
34110 characters is to leave Alpine's MIME encoding turned on, but recipients
34111 who lack MIME-aware tools are often annoyed when they receive MIME-encoded
34112 messages.
34113 <P>
34114 &lt;End of help on this topic&gt;
34115 </BODY>
34116 </HTML>
34117 ====== h_config_mark_for_cc =====
34118 <HTML>
34119 <HEAD>
34120 <TITLE>FEATURE: <!--#echo var="FEAT_mark-for-cc"--></TITLE>
34121 </HEAD>
34122 <BODY>
34123 <H1>FEATURE: <!--#echo var="FEAT_mark-for-cc"--></H1>
34124
34125 This feature affects Alpine's MESSAGE INDEX display.
34126 By default, a '+' is displayed in the first column if the
34127 message is addressed directly to you.
34128 When this feature is set and the message is not addressed to you, then a
34129 '-' character is displayed if the message is instead Cc'd directly
34130 to you.
34131
34132 <P>
34133 <UL>
34134 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34135 </UL><P>
34136 &lt;End of help on this topic&gt;
34137 </BODY>
34138 </HTML>
34139 ====== h_config_tab_uses_unseen =====
34140 <HTML>
34141 <HEAD>
34142 <TITLE>FEATURE: <!--#echo var="FEAT_tab-uses-unseen-for-next-folder"--></TITLE>
34143 </HEAD>
34144 <BODY>
34145 <H1>FEATURE: <!--#echo var="FEAT_tab-uses-unseen-for-next-folder"--></H1>
34146
34147 This feature affects Alpine's behavior when using the TAB
34148 <A HREF="h_common_nextnew">NextNew Command</A>
34149 to move from one folder to the next.
34150 Alpine's usual behavior is to search for folders
34151 with <EM>Recent</EM> messages in them.
34152 Recent messages are messages that have arrived since the last time the
34153 folder was opened.
34154
34155 <P>
34156 Setting this feature causes Alpine to search for <EM>Unseen</EM>
34157 messages instead of Recent messages.
34158 Unseen messages remain Unseen until you view them (or flag then as Seen with
34159 the <A HREF="h_common_flag">Flag Command</A>).
34160 Setting this feature allows you to locate messages you have not read
34161 instead of only recently received messages.
34162 When this feature is set, the feature
34163 <A HREF="h_config_fast_recent">&quot;<!--#echo var="FEAT_enable-fast-recent-test"-->&quot;</A>
34164 will have no effect, so the checking may be slower.
34165
34166 <P>
34167 Another reason why you might want to use this feature is that Alpine sometimes
34168 opens folders implicitly behind the scenes, and this clears the
34169 Recent status of all messages in the folder.
34170 One example where this happens is when Saving or filtering a
34171 message to another folder.
34172 If that message has some <A HREF="h_config_keywords">keywords</A>
34173 set, then because of some shortcomings
34174 in the IMAP specification, the best way to ensure that those keywords are
34175 still set in the saved copy of the message is to open the folder and
34176 set the keywords explicitly.
34177 Because this clears the Recent status of all messages in that folder the
34178 folder will not be found by the NextNew command unless this feature is set.
34179
34180 <P>
34181 &lt;End of help on this topic&gt;
34182 </BODY>
34183 </HTML>
34184 ====== h_config_tab_new_only =====
34185 <HTML>
34186 <HEAD>
34187 <TITLE>FEATURE: <!--#echo var="FEAT_tab-visits-next-new-message-only"--></TITLE>
34188 </HEAD>
34189 <BODY>
34190 <H1>FEATURE: <!--#echo var="FEAT_tab-visits-next-new-message-only"--></H1>
34191
34192 This feature affects Alpine's behavior when using the TAB key to move from
34193 one message to the next.  Alpine's usual behavior is to select the next
34194 unread message or message flagged as "Important".
34195
34196 <P>
34197
34198 Setting this feature causes Alpine to skip the messages flagged as important,
34199 and select unread messages exclusively.  Tab behavior when there are no
34200 new messages left to select remains unchanged.
34201 <P>
34202 &lt;End of help on this topic&gt;
34203 </BODY>
34204 </HTML>
34205 ====== h_config_warn_if_subj_blank =====
34206 <HTML>
34207 <HEAD>
34208 <TITLE>FEATURE: <!--#echo var="FEAT_warn-if-blank-subject"--></TITLE>
34209 </HEAD>
34210 <BODY>
34211 <H1>FEATURE: <!--#echo var="FEAT_warn-if-blank-subject"--></H1>
34212
34213 This feature affects Alpine's behavior when you send a message being
34214 composed.
34215 If this option is set, Alpine will check to see if the message about to be sent
34216 has a subject or not.
34217 If not, you will be asked if you want to send the message anyway.
34218 <P>
34219
34220 <UL>
34221 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34222 </UL><P>
34223 &lt;End of help on this topic&gt;
34224 </BODY>
34225 </HTML>
34226 ====== h_config_warn_if_fcc_blank =====
34227 <HTML>
34228 <HEAD>
34229 <TITLE>FEATURE: <!--#echo var="FEAT_warn-if-blank-fcc"--></TITLE>
34230 </HEAD>
34231 <BODY>
34232 <H1>FEATURE: <!--#echo var="FEAT_warn-if-blank-fcc"--></H1>
34233
34234 This feature affects Alpine's behavior when you send a message being
34235 composed.
34236 If this option is set, Alpine will check to see if the message about to be sent
34237 has an Fcc or not.
34238 If not, you will be asked if you want to send the message anyway.
34239 <P>
34240
34241 <UL>
34242 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34243 </UL><P>
34244 &lt;End of help on this topic&gt;
34245 </BODY>
34246 </HTML>
34247 ====== h_config_warn_if_no_to_or_cc =====
34248 <HTML>
34249 <HEAD>
34250 <TITLE>FEATURE: <!--#echo var="FEAT_warn-if-blank-to-and-cc-and-newsgroups"--></TITLE>
34251 </HEAD>
34252 <BODY>
34253 <H1>FEATURE: <!--#echo var="FEAT_warn-if-blank-to-and-cc-and-newsgroups"--></H1>
34254
34255 This feature affects Alpine's behavior when you send a message being
34256 composed.
34257 If this option is set, Alpine will check to see if the message about to be sent
34258 has either a To address, a Cc address, or a Newsgroup.
34259 If none of these is set,
34260 you will be asked if you want to send the message anyway.
34261 <P>
34262
34263 This feature is closely related to
34264 <A HREF="h_config_auto_fcc_only"><!--#echo var="FEAT_fcc-only-without-confirm"--></A>.
34265 Alpine will normally ask if you want to copy a message only to the Fcc.
34266 This feature also applies to cases where there is a Bcc but still no To, Cc,
34267 or Newsgroup.
34268 If the <!--#echo var="FEAT_fcc-only-without-confirm"--> feature is set and you are sending a
34269 message with only an Fcc, then you won't be asked about sending with
34270 a blank To and Cc and Newsgroups header even if this feature is set.
34271 Similarly, if you have already been asked if you want to send to the Fcc
34272 only and you have answered Yes, then you won't be asked again about sending with
34273 blank To, Cc, and Newsgroups headers even if this feature is set.
34274 <P>
34275
34276 <UL>
34277 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34278 </UL><P>
34279 &lt;End of help on this topic&gt;
34280 </BODY>
34281 </HTML>
34282 ====== h_config_quell_dead_letter =====
34283 <HTML>
34284 <HEAD>
34285 <TITLE>FEATURE: <!--#echo var="FEAT_quell-dead-letter-on-cancel"--></TITLE>
34286 </HEAD>
34287 <BODY>
34288 <H1>FEATURE: <!--#echo var="FEAT_quell-dead-letter-on-cancel"--></H1>
34289
34290 This feature affects Alpine's behavior when you cancel a message being
34291 composed.  Alpine's usual behavior is to write the canceled message to
34292 a file named
34293 <!--chtml if pinemode="os_windows"-->
34294 &quot;DEADLETR&quot;,
34295 <!--chtml else-->
34296 &quot;dead.letter&quot; in your home directory,
34297 <!--chtml endif-->
34298 overwriting any previous message. Under
34299 some conditions (some routine), this can introduce a noticeable delay.
34300 Setting this feature will cause Alpine NOT to write canceled compositions
34301 into the file.
34302 <P>
34303 NOTE: Enabling this feature means NO record of canceled messages is
34304 maintained.
34305 <P>
34306 This feature affects the newer option
34307 <A HREF="h_config_deadlets"><!--#echo var="VAR_dead-letter-files"--></A>, which specifies the
34308 number of dead letter files to keep around.
34309 If this feature is set, then the <!--#echo var="VAR_dead-letter-files"--> option has no effect.
34310 <P>
34311 <UL>
34312 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34313 </UL><P>
34314 &lt;End of help on this topic&gt;
34315 </BODY>
34316 </HTML>
34317 ====== h_config_quell_beeps =====
34318 <HTML>
34319 <HEAD>
34320 <TITLE>FEATURE: <!--#echo var="FEAT_quell-status-message-beeping"--></TITLE>
34321 </HEAD>
34322 <BODY>
34323 <H1>FEATURE: <!--#echo var="FEAT_quell-status-message-beeping"--></H1>
34324
34325 This feature affects Alpine's behavior when it displays status message
34326 (e.g., Error complaints, New mail warnings, etc).  Setting this feature
34327 will not affect the display of such messages, but will cause those that
34328 emit a beep to become silent.
34329
34330 <P>
34331 <UL>
34332 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34333 </UL><P>
34334 &lt;End of help on this topic&gt;
34335 </BODY>
34336 </HTML>
34337 ====== h_config_suppress_user_agent =====
34338 <HTML>
34339 <HEAD>
34340 <TITLE>FEATURE: <!--#echo var="FEAT_suppress-user-agent-when-sending"--></TITLE>
34341 </HEAD>
34342 <BODY>
34343 <H1>FEATURE: <!--#echo var="FEAT_suppress-user-agent-when-sending"--></H1>
34344
34345 If this feature is set then Alpine will not generate a
34346 <CODE>User-Agent</CODE> header in outgoing messages.
34347 <P>
34348 <UL>
34349 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34350 </UL><P>
34351 &lt;End of help on this topic&gt;
34352 </BODY>
34353 </HTML>
34354 ====== h_config_quell_lock_failure_warnings =====
34355 <HTML>
34356 <HEAD>
34357 <TITLE>FEATURE: <!--#echo var="FEAT_quell-lock-failure-warnings"--></TITLE>
34358 </HEAD>
34359 <BODY>
34360 <H1>FEATURE: <!--#echo var="FEAT_quell-lock-failure-warnings"--></H1>
34361
34362 This feature affects Alpine's behavior when it encounters a problem
34363 acquiring a mail folder lock.  Typically, a secondary file associated
34364 with the mail folder being opened is created as part of the locking
34365 process.  On some systems, such file creation has been administratively
34366 precluded by the system configuration.
34367 <P>
34368 Alpine issues a warning when such failures occur, which can become bothersome
34369 if the system is configured to disallow such actions.  Setting this
34370 feature causes Alpine to remain silent when this part of lock creation fails.
34371 <P>
34372 WARNING: systems that have been configured in a way that precludes locking
34373 introduce some risk of mail folder corruption when more than one program
34374 attempts to modify the mail folder.  This is most likely to occur to one's
34375 INBOX or other incoming message folder.
34376 <P>
34377 See also <A HREF="h_info_on_locking">&quot;What Systems Managers Need to Know about Alpine File Locking&quot;</A>.
34378 <P>
34379 <UL>
34380 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34381 </UL><P>
34382 &lt;End of help on this topic&gt;
34383 </BODY>
34384 </HTML>
34385 ====== h_config_enable_role_take ======
34386 <HTML>
34387 <HEAD>
34388 <TITLE>FEATURE: <!--#echo var="FEAT_enable-rules-under-take"--></TITLE>
34389 </HEAD>
34390 <BODY>
34391 <H1>FEATURE: <!--#echo var="FEAT_enable-rules-under-take"--></H1>
34392
34393 Normally, the Take command takes addresses from a message and helps you
34394 put them into your Address Book.
34395 If you use Rules for Indexcolors, Roles, Filtering, or Scoring;
34396 you may find it useful
34397 to be able to Take information from a message's headers and put it into
34398 a new Rule.
34399 When this feature is set, you will be given an extra prompt that gives
34400 you the choice to Take into the Address Book or Take into a rule.
34401 <P><UL>
34402 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34403 </UL>
34404 <P>
34405 &lt;End of help on this topic&gt;
34406 </BODY>
34407 </HTML>
34408 ====== h_config_enable_take_export ======
34409 <HTML>
34410 <HEAD>
34411 <TITLE>FEATURE: <!--#echo var="FEAT_enable-take-export"--></TITLE>
34412 </HEAD>
34413 <BODY>
34414 <H1>FEATURE: <!--#echo var="FEAT_enable-take-export"--></H1>
34415
34416 Normally, the Take command takes addresses from a message and helps you
34417 put them into your Address Book.
34418 When this feature is set, you will be given an extra prompt that gives you
34419 the choice to Take addresses into a file instead of your Address
34420 Book.
34421 Only the user@domain_name part of the address is put in the file.
34422 <P><UL>
34423 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34424 </UL>
34425 <P>
34426 &lt;End of help on this topic&gt;
34427 </BODY>
34428 </HTML>
34429 ====== h_config_quell_folder_internal_msg ======
34430 <HTML>
34431 <HEAD>
34432 <TITLE>FEATURE: <!--#echo var="FEAT_quell-folder-internal-msg"--></TITLE>
34433 </HEAD>
34434 <BODY>
34435 <H1>FEATURE: <!--#echo var="FEAT_quell-folder-internal-msg"--></H1>
34436
34437 This feature determines whether or not Alpine will create
34438 &quot;pseudo messages&quot; in folders that are in standard Unix or
34439 MMDF format. <P>
34440
34441 Alpine will normally create these pseudo messages when they are not already
34442 present in a standard Unix or MMDF folder.  Their purpose is to record
34443 certain mailbox state data needed for correct IMAP and POP server
34444 operation, and also for Alpine to be able to mark messages as Answered when
34445 the Reply has been postponed.<P>
34446
34447 Sites that do not use IMAP/POP for remote mail access, and that need to
34448 support mail tools that are adversely affected by the presence of the
34449 pseudo-messages (e.g. some mail notification tools) may enable this
34450 feature to tell Alpine not to create them.  Note that Alpine's
34451 &quot;Answered&quot; flag
34452 capability will be adversely affected if this is done.<P>
34453
34454 Note too that, even if this feature is enabled, Alpine will not remove
34455 pseudo-messages when it encounters them (e.g. those created by UW's imapd
34456 or ipopd servers.) This feature has no effect on folders that are not in
34457 standard Unix or MMDF format, as pseudo-messages are not needed in the
34458 other formats to record mailbox state information.
34459 <P><UL>
34460 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34461 </UL>
34462 <P>
34463 &lt;End of help on this topic&gt;
34464 </BODY>
34465 </HTML>
34466 ====== h_config_mulnews_as_typed ======
34467 <HTML>
34468 <HEAD>
34469 <TITLE>FEATURE: <!--#echo var="FEAT_mult-newsrc-hostnames-as-typed"--></TITLE>
34470 </HEAD>
34471 <BODY>
34472 <H1>FEATURE: <!--#echo var="FEAT_mult-newsrc-hostnames-as-typed"--></H1>
34473
34474 This feature will be of little use to most users.
34475 It has no effect unless the feature
34476 <A HREF="h_config_enable_mulnewsrcs"><!--#echo var="FEAT_enable-multiple-newsrcs"--></A>
34477 is set.
34478
34479 When the <!--#echo var="FEAT_enable-multiple-newsrcs"--> feature is set
34480 then the setting of this feature may have an effect on the names of the
34481 newsrc files used.
34482 Normally, the name of the news server will be canonicalized before it is
34483 used in the newsrc file name.
34484 For example, if you type the news server name
34485
34486 <P>
34487 <CENTER><SAMP>servername</SAMP></CENTER>
34488 <P>
34489
34490 it is likely that the canonical name will be something like
34491
34492 <P>
34493 <CENTER><SAMP>servername.example.com</SAMP></CENTER>
34494 <P>
34495
34496 Or it may be the case that
34497
34498 <P>
34499 <CENTER><SAMP>servername.example.com</SAMP></CENTER>
34500 <P>
34501
34502 is really an alias (a DNS CNAME) for
34503
34504 <P>
34505 <CENTER><SAMP>othername.example.com</SAMP></CENTER>
34506 <P>
34507
34508 If this feature is not set, then the canonicalized names will be used.
34509 If this feature is set, then the name you typed in (or put in your
34510 configuration) will be used.
34511
34512 <P><UL>
34513 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34514 </UL>
34515 <P>
34516 &lt;End of help on this topic&gt;
34517 </BODY>
34518 </HTML>
34519 ====== h_config_quell_empty_dirs ======
34520 <HTML>
34521 <HEAD>
34522 <TITLE>FEATURE: <!--#echo var="FEAT_quell-empty-directories"--></TITLE>
34523 </HEAD>
34524 <BODY>
34525 <H1>FEATURE: <!--#echo var="FEAT_quell-empty-directories"--></H1>
34526
34527 This feature causes Alpine to remove from the display any directories
34528 that do not contain at least one file or directory.  This can be useful
34529 to prevent overly cluttered folder lists when a collection is stored on
34530 a server that treats all names as both a folder and a directory.
34531
34532 <P>
34533 Note, enabling this feature can cause surprising behavior!  For example,
34534 you can still use Add to create a directory, but unless you immediately
34535 enter that directory and create a folder, that newly created directory
34536 may not be displayed next time you enter the folder list.
34537
34538 <P>
34539 The description above is not quite correct.
34540 Only directories which potentially may hold messages are hidden if empty.
34541 That is, a directory which is really just a directory and is not selectable
34542 as a folder will not be hidden.
34543 Such directories can occur on servers that treat most names as both a folder
34544 and a directory.
34545 These directories are typically created implicitly when a folder is created
34546 inside a directory that does not yet exist.
34547
34548 <P>
34549 <UL>
34550 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34551 </UL><P>
34552 &lt;End of help on this topic&gt;
34553 </BODY>
34554 </HTML>
34555 ====== h_config_termcap_wins =====
34556 <HTML>
34557 <HEAD>
34558 <TITLE>FEATURE: <!--#echo var="FEAT_termdef-takes-precedence"--></TITLE>
34559 </HEAD>
34560 <BODY>
34561 <H1>FEATURE: <!--#echo var="FEAT_termdef-takes-precedence"--></H1>
34562
34563 This feature may affect Alpine's low-level input routines.  Termcap (or
34564 terminfo, depending on how your copy of Alpine was compiled and linked)
34565 is the name of the database that describes terminal capabilities.  In
34566 particular, it describes the sequences of characters that various keys
34567 will emit.
34568
34569 <P>
34570 An example would be the Up Arrow key on the keyboard.  Up
34571 Arrow is not a distinct character on most Unix systems.  When you press
34572 the Up Arrow key a short sequence of characters are produced.  This
34573 sequence is supposed to be described in the termcap database by the
34574 &quot;ku&quot; capability (or by the &quot;kcuu1&quot; capability if you
34575 are using terminfo instead of termcap).
34576
34577 <P>
34578 By default, Alpine defines some terminal
34579 escape sequences that are commonly used.  For example, the sequence
34580 &quot;ESC&nbsp;O&nbsp;A&quot; is recognized as an Up Arrow key.  The sequence
34581 &quot;ESC&nbsp;[&nbsp;A&quot;
34582 is also recognized as an Up Arrow key.  These are chosen because common
34583 terminals like VT100's or ANSI standard terminals produce these
34584 sequences when you press the Up Arrow key.
34585
34586 <P>
34587 If your system's termcap
34588 (terminfo) database assigns some other function to the sequence
34589 &quot;ESC&nbsp;O&nbsp;A&quot;
34590 it is usually ignored by Alpine.  Also, if your termcap (terminfo)
34591 database assigns a sequence that doesn't begin with an escape
34592 character (<SAMP>ESC</SAMP>) it is usually ignored by Alpine.
34593 This usually works fine
34594 because most terminals emit the escape sequences that Alpine has defined
34595 by default.  We have also found that it is usually better to have these
34596 defaults take precedence over the definitions contained in the database
34597 because the defaults are more likely to be correct than the database.
34598
34599 <P>
34600 There are some terminals where this breaks down.  If you want Alpine to
34601 believe the definitions given in your termcap (terminfo) database in
34602 preference to the defaults the Alpine itself sets up, then you may turn
34603 this feature on.  Then, sequences of characters that are defined in
34604 both termcap (terminfo) and in Alpine's set of defaults will be
34605 interpreted the way that termcap (terminfo) says they should be
34606 interpreted.  Also, if your terminal capabilities database assigns a
34607 sequence that doesn't begin with escape, it will not be ignored.
34608
34609 <P>
34610 <UL>
34611 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34612 </UL><P>
34613 &lt;End of help on this topic&gt;
34614 </BODY>
34615 </HTML>
34616 ====== h_config_cruise_mode =====
34617 <HTML>
34618 <HEAD>
34619 <TITLE>FEATURE: <!--#echo var="FEAT_enable-cruise-mode"--></TITLE>
34620 </HEAD>
34621 <BODY>
34622 <H1>FEATURE: <!--#echo var="FEAT_enable-cruise-mode"--></H1>
34623
34624 This feature affects Alpine's behavior when you hit the
34625 &quot;Space&nbsp;Bar&quot; at
34626 the end of a displayed message.  Typically, Alpine complains that the end
34627 of the text has already been reached.  Setting this feature causes such
34628 keystrokes to be interpreted as if the &quot;Tab&quot; key had been hit, thus
34629 taking you to the next &quot;interesting&quot; message,
34630 or scanning ahead to the
34631 next incoming folder with &quot;interesting&quot; messages.
34632
34633 <P>
34634 <UL>
34635 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34636 </UL><P>
34637 &lt;End of help on this topic&gt;
34638 </BODY>
34639 </HTML>
34640 ====== h_config_cruise_mode_delete =====
34641 <HTML>
34642 <HEAD>
34643 <TITLE>FEATURE: <!--#echo var="FEAT_enable-cruise-mode-delete"--></TITLE>
34644 </HEAD>
34645 <BODY>
34646 <H1>FEATURE: <!--#echo var="FEAT_enable-cruise-mode-delete"--></H1>
34647
34648 This feature modifies the behavior of Alpine's
34649 <A HREF="h_config_cruise_mode">&quot;<!--#echo var="FEAT_enable-cruise-mode"-->&quot;</A> feature.
34650 Setting this feature causes Alpine to implicitly delete read
34651 messages when it moves on to display the next &quot;interesting&quot; message.
34652 <P>
34653 NOTE: Beware when enabling this feature AND the
34654 <A HREF="h_config_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm"-->&quot;</A>
34655 feature.
34656 <P>
34657 <UL>
34658 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34659 </UL><P>
34660 &lt;End of help on this topic&gt;
34661 </BODY>
34662 </HTML>
34663 ====== h_config_slash_coll_entire =====
34664 <HTML>
34665 <HEAD>
34666 <TITLE>FEATURE: <!--#echo var="FEAT_slash-collapses-entire-thread"--></TITLE>
34667 </HEAD>
34668 <BODY>
34669 <H1>FEATURE: <!--#echo var="FEAT_slash-collapses-entire-thread"--></H1>
34670
34671 The slash (/) command is available from the MESSAGE INDEX screen when
34672 the folder is sorted by either Threads or OrderedSubject, and the
34673 <A HREF="h_config_thread_disp_style"><!--#echo var="VAR_threading-display-style"--></A>
34674 is set to something other than &quot;none&quot;.
34675 Normally, the slash command Collapses or Expands the subthread that
34676 starts at the currently highlighted message, if any.
34677 If this option is set, then the slash command Collapses or Expands the
34678 <EM>entire</EM> current thread instead of just the subthread.
34679 The current thread is simply the top-level thread that contains the
34680 current message.
34681
34682 <P>
34683 <UL>
34684 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34685 </UL><P>
34686 &lt;End of help on this topic&gt;
34687 </BODY>
34688 </HTML>
34689 ====== h_config_color_thrd_import =====
34690 <HTML>
34691 <HEAD>
34692 <TITLE>FEATURE: <!--#echo var="FEAT_thread-index-shows-important-color"--></TITLE>
34693 </HEAD>
34694 <BODY>
34695 <H1>FEATURE: <!--#echo var="FEAT_thread-index-shows-important-color"--></H1>
34696
34697 This option affects only the THREAD INDEX screen.
34698 Whether or not you ever see a THREAD INDEX screen depends on the setting
34699 of the configuration option
34700 <A HREF="h_config_thread_index_style">&quot;<!--#echo var="VAR_threading-index-style"-->&quot;</A>
34701 and on the sort order of the index.
34702
34703 <P>
34704 If a message within a thread is flagged as Important
34705 and this option is set, then
34706 the entire line in the THREAD INDEX will be colored the color of the
34707 Index-important Symbol, which can be set using the
34708 <A HREF="h_color_setup">Setup Kolor</A> screen.
34709
34710 <P>
34711 <UL>
34712 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34713 </UL><P>
34714 &lt;End of help on this topic&gt;
34715 </BODY>
34716 </HTML>
34717 ====== h_config_allow_goto =====
34718 <HTML>
34719 <HEAD>
34720 <TITLE>FEATURE: <!--#echo var="FEAT_enable-goto-in-file-browser"--></TITLE>
34721 </HEAD>
34722 <BODY>
34723 <H1>FEATURE: <!--#echo var="FEAT_enable-goto-in-file-browser"--></H1>
34724
34725 This feature modifies the behavior of Alpine's file browser.  Setting this
34726 feature causes Alpine to offer the "G Goto" command in the file browser.
34727 That is the default.
34728
34729 <P>
34730
34731 The Goto command allows you to explicitly type in the desired directory.
34732 <P>
34733 &lt;End of help on this topic&gt;
34734 </BODY></HTML>
34735 ====== h_config_add_ldap =====
34736 <HTML>
34737 <HEAD>
34738 <TITLE>FEATURE: <!--#echo var="FEAT_ldap-result-to-addrbook-add"--></TITLE>
34739 </HEAD>
34740 <BODY>
34741 <H1>FEATURE: <!--#echo var="FEAT_ldap-result-to-addrbook-add"--></H1>
34742
34743 If both the Directory option
34744 <A HREF="h_config_ldap_opts_impl">&quot;Use-Implicitly-From-Composer&quot;</A>
34745 and this feature are set,
34746 then when an implicit directory lookup is done from the
34747 composer you will automatically be prompted to add the result of the
34748 directory lookup to your address book.
34749 <P>
34750 <UL>
34751 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34752 </UL><P>
34753 &lt;End of help on this topic&gt;
34754 </BODY>
34755 </HTML>
34756 ===== h_patterns_compat_behavior =====
34757 <HTML>
34758 <HEAD>
34759 <TITLE>Rules Behavior Changes in Pine 4.50</TITLE>
34760 </HEAD>
34761 <BODY>
34762 <H1>Rules Behavior Changes in Pine 4.50</H1>
34763
34764 In Alpine, Rules that contain unrecognized elements
34765 are ignored.
34766 In most cases, the unrecognized elements will be something that was
34767 added as a new Rules feature in a later version of Alpine.
34768 In versions of Pine <EM>prior</EM> to 4.50, Pine did <EM>not</EM>
34769 ignore rules that contained unrecognized elements.
34770 For example, a new element of Rules that was added in Pine 4.50 is
34771 Age interval.
34772 Suppose you add an Indexcolor rule, using version Pine 4.50 or later, that colors
34773 all messages older than a week red.
34774 Now, if you run Pine 4.44 using that same configuration file, it will not
34775 recognize the Age interval and so will just ignore it.
34776 That means that all messages will match that rule so all messages will
34777 be colored red when using Pine version 4.44.
34778
34779 <P>
34780 This behavior was considered a bug so it is fixed in Alpine and Pine 4.50 and later.
34781 However, since the behavior still exists in versions prior to Pine 4.50 and
34782 since Filtering is a potentially destructive operation, another measure
34783 was taken to attempt to avoid unintentional Filtering of messages.
34784 The first time that you run Alpine or a Pine that is version 4.50 or greater,
34785 the rules in your Filters configuration variable (&quot;Patterns-Filters&quot;)
34786 will be copied to a new Filters configuration variable
34787 with a different name (&quot;Patterns-Filters2&quot;).
34788 From then on, Alpine will continue to use the new
34789 variable.
34790 Of course, Pine version 4.44 or lower will continue to use the old
34791 variable.
34792 That means that if you are using Alpine
34793 and also using a version of Pine that is older than 4.50, they will not
34794 share the configuration information about Filters.
34795 If you make a change in one version you won't see it in the other version.
34796
34797 <P>
34798 Since Scoring can be used to trigger Filtering, the same thing has been
34799 done for Score rules.
34800 The old configuration variable name is (&quot;Patterns-Scores&quot;)
34801 and the new name is (&quot;Patterns-Scores2&quot;).
34802 The same is not true of Role, Indexcolor, and Other rules that are
34803 thought to be less harmful when a mistake is made.
34804
34805 <P>
34806 &lt;End of help on this topic&gt;
34807 </BODY>
34808 </HTML>
34809 ======= h_config_filt_opts_sentdate =======
34810 <HTML>
34811 <HEAD>
34812 <TITLE>PATTERN FEATURE: Use-Date-Header-For-Age</TITLE>
34813 </HEAD>
34814 <BODY>
34815 <H1>PATTERN FEATURE: Use-Date-Header-For-Age</H1>
34816
34817 By default, the Age interval of a Pattern uses a message's time of
34818 arrival to compute the age of the message.
34819 If this feature is set, the date in the message's Date header will
34820 be used instead.
34821 <P>
34822 &lt;End of help on this topic&gt;
34823 </BODY>
34824 </HTML>
34825 ======= h_config_filt_opts_notdel =======
34826 <HTML>
34827 <HEAD>
34828 <TITLE>FILTER FEATURE: Move-Only-if-Not-Deleted</TITLE>
34829 </HEAD>
34830 <BODY>
34831 <H1>FILTER FEATURE: Move-Only-if-Not-Deleted</H1>
34832
34833 If this option is set then a message will be moved into the
34834 specified folder only if it is not marked for deletion.
34835 This is useful if you have multiple Alpine sessions running
34836 simultaneously and you don't want messages to be filtered into a
34837 folder more than once.
34838 It is also useful if you want to filter
34839 only the &quot;undeleted&quot; messages in a newsgroup into a folder.
34840 This method is not foolproof.
34841 There may be cases where a message
34842 gets marked deleted and so it is never filtered into the folder.
34843 For example, if you deleted it in another Alpine session or another mail
34844 program that didn't use the filtering rule.
34845 <P>
34846 This option has no effect if the Filter Action is not set to Move.
34847 <P>
34848 &lt;End of help on this topic&gt;
34849 </BODY>
34850 </HTML>
34851 ======= h_config_filt_opts_nonterm =======
34852 <HTML>
34853 <HEAD>
34854 <TITLE>FILTER FEATURE: Dont-Stop-Even-if-Rule-Matches</TITLE>
34855 </HEAD>
34856 <BODY>
34857 <H1>FILTER FEATURE: Dont-Stop-Even-if-Rule-Matches</H1>
34858
34859 If this option is set then this is a non-terminating rule.
34860 Usually, for each message, Alpine searches through the Filter Rules until
34861 a match is found and then it performs the action associated with that rule.
34862 Rules following the match are not considered.
34863 If this option is set then the search for matches will continue at the next
34864 rule.
34865 <P>
34866 If a non-terminating rule matches then the actions associated with
34867 that rule, except for any implied deletion of the message, are performed
34868 before the match for the next rule is checked.
34869 For example, if the non-terminating rule sets the Important status, then that
34870 status will be set when the next rule is considered.
34871 However, if the non-terminating rule Moves the message, the message will
34872 actually be copied instead of copied and deleted so that it is still there
34873 for the next rule.
34874 A moved message is deleted after all the relevant rules have been checked.
34875 The name of the &quot;Move&quot; action is confusing in this case because
34876 a single message can be moved to more than one folder.
34877 It turns the Move into a Copy instead, but it is still followed by a deletion
34878 at the end.
34879 <P>
34880 This option may be useful if you want to have a single message filtered to
34881 two different folders because it matches two different Patterns.
34882 For example, suppose you normally filter messages to a particular mailing
34883 list into one folder, and messages addressed directly to you into a second
34884 folder.
34885 If a message is sent to both you and the list (and you can tell that by
34886 looking at the headers of the message) this option may give you a convenient
34887 way to capture a copy to each folder.
34888 (It may also cause you to capture two copies to each folder,
34889 depending on whether your mail system delivers one or two copies of the
34890 message to you and on how the list works.)
34891 <P>
34892 &lt;End of help on this topic&gt;
34893 </BODY>
34894 </HTML>
34895 ===== h_mainhelp_smime ======
34896 <HTML>
34897 <HEAD>
34898 <TITLE>S/MIME Overview</TITLE>
34899 </HEAD>
34900 <BODY>
34901 <H1>S/MIME Overview</H1>
34902
34903 S/MIME is a standard for the public key encryption and signing of email.
34904 UNIX Alpine contains a basic implementation of S/MIME based on
34905 the <A HREF="http://www.openssl.org/">OpenSSL</A> libraries.
34906 To check if this version of Alpine supports S/MIME look at
34907 <A HREF="X-Alpine-Config:">Supported Options in this Alpine</A> and look
34908 for &quot;S/MIME&quot; under the &quot;Encryption&quot; heading.
34909 <P>
34910 Some limitations:
34911 <UL>
34912    <LI> There is no PC-Alpine implementation.
34913    <LI> There is no provision for checking for CRLs
34914         (Certificate Revocation Lists) in Alpine.
34915    <LI> This built-in S/MIME implementation is not compatible with and does not help with PGP.
34916    <LI> There is no mechanism available for feeding either an entire incoming
34917         or an entire outgoing message to an external
34918         filter and using that external filter to do S/MIME or PGP processing.
34919    <LI> Because the implementation currently uses OpenSSL, there is only a very
34920         limited integration with the Mac OS Keychain (the storing and access of
34921         public certificates).
34922 </UL>
34923 <P>
34924 The S/MIME configuration screen is reached by going to the Main Menu and typing
34925 the &quot;S&nbsp;Setup&quot; command followed by &quot;M&nbsp;S/MIME&quot;.
34926 <P>
34927
34928 <H2>S/MIME BASICS</H2>
34929
34930 In order to digitally sign messages you send you must have a public/private key-pair.
34931 This may be obtained from a public Certificate Authority (CA) such as Thawte, Verisign, Comodo,
34932 or GoDaddy; or from a smaller CA such as a university which provides certificates for its
34933 users or a company which provides certificates for its workers.
34934 These certificates are bound to an email address, so the identity being verified is the
34935 email address not a person's name.
34936 <P>
34937 Mail is signed by using the sender's private key, which only the owner of the private key
34938 has access to.
34939 The signature is verified using the signer's public key, which anyone can
34940 have access to.
34941 With Alpine, the first time you receive a signed message the public key of the
34942 sender will be stored for future use.
34943
34944 <P>
34945 Mail is encrypted using the recipient's public key and decrypted by
34946 the recipient with their private key.
34947
34948 <P>
34949 You need a key of your own in order to sign outgoing messages and to have others
34950 encrypt messages sent to you.
34951 You do not need a key of your own to verify signed messages sent by others or to
34952 encrypt messages sent to others.
34953
34954 <H2>ALPINE S/MIME CERTIFICATE STORAGE</H2>
34955
34956 By default UNIX Alpine stores the certificates it uses in a directory in your
34957 home directory.
34958 The directory name is
34959 <P>
34960 <CENTER><SAMP>.alpine-smime</SAMP></CENTER>
34961 <P>
34962 Within that directory are three subdirectories.
34963 Each of the three subdirectories contains files with PEM-encoded contents,
34964 the default format for OpenSSL.
34965 The &quot;<SAMP>public</SAMP>&quot; directory contains public certificates.
34966 The files within that directory have names that are email addresses with the
34967 suffix &quot;<SAMP>.crt</SAMP>&quot; appended.
34968 An example filename is
34969 <P>
34970 <CENTER><SAMP>user@example.com.crt</SAMP></CENTER>
34971 <P>
34972 The &quot;<SAMP>private</SAMP>&quot; directory contains private keys, probably just one for
34973 your private key.
34974 These are also email addresses but with the suffix &quot;<SAMP>.key</SAMP>&quot; instead.
34975 The third directory is &quot;<SAMP>ca</SAMP>&quot; and it contains certificates for any Certificate
34976 Authorities that you want to trust but that aren't contained in the set of system CAs.
34977 Those files may have arbitrary names as long as they end with the
34978 suffix &quot;<SAMP>.crt</SAMP>&quot;.
34979
34980 <H2>HOW TO SIGN AND ENCRYPT</H2>
34981
34982 If you have a certificate you may sign outgoing messages.
34983 After typing the Ctrl-X command to send a message you will see the prompt
34984 <P>
34985 <CENTER><SAMP>Send message?</SAMP></CENTER>
34986 <P>
34987 Available subcommands include &quot;G&nbsp;Sign&quot; and &quot;E&nbsp;Encrypt&quot;.
34988 Typing the &quot;G&quot; command will change the prompt to
34989 <P>
34990 <CENTER><SAMP>Send message (Signed)?</SAMP></CENTER>
34991 <P>
34992 Typing the &quot;E&quot; command will change the prompt to
34993 <P>
34994 <CENTER><SAMP>Send message (Encrypted)?</SAMP></CENTER>
34995 <P>
34996 You may even type both to get
34997 <P>
34998 <CENTER><SAMP>Send message (Encrypted, Signed)?</SAMP></CENTER>
34999 <P>
35000
35001 <H2>HOW TO READ SIGNED OR ENCRYPTED MESSAGES</H2>
35002
35003 The reading of a signed message should not require any special action on
35004 your part.
35005 There should be an editorial addition at the start of the message which
35006 says either
35007 <P>
35008 <CENTER><SAMP>This message was cryptographically signed.</SAMP></CENTER>
35009 <P>
35010 or
35011 <P>
35012 <CENTER><SAMP>This message was cryptographically signed but the signature could not be verified.</SAMP></CENTER>
35013 <P>
35014 If an encrypted message is sent to you the encrypted text will not
35015 be shown.
35016 You will have to type the &quot;Ctrl-D&nbsp;Decrypt&quot; command (from the screen where
35017 you are viewing the message) and supply your passphrase when asked.
35018 <P>
35019 For a signed or encrypted message there is also a &quot;Ctrl-E&nbsp;Security&quot; command
35020 which gives you some information about the certificate used to sign or encrypt the message.
35021
35022 <H2>MISCELLANEOUS</H2>
35023
35024 If you have access to a private certificate in the PKCS12 format, which
35025 would sometimes be in a file with a &quot;.p12&quot; extension, then you can
35026 use the following commands to generate private keys, public and certificate
35027 authorities certificates. In the examples below, we assume that the
35028 certificate in the p12 format is called &quot;certificate.p12&quot;, and
35029 that your email address is &quot;your@address.com&quot;.
35030
35031 <P>
35032 In order to create a private key use the command
35033 <P>
35034 <CENTER><SAMP>openssl pkcs12 -in certificate.p12 -out your@address.com.key</SAMP></CENTER>
35035 <P>
35036 In order to create a public certificate use the command
35037 <P>
35038 <CENTER><SAMP>
35039 openssl pkcs12 -in certificate.p12 -clcerts -nokeys -out your@address.com.crt
35040 </SAMP></CENTER>
35041 <P>
35042 In order to create a certificate authority certificate use the command
35043 <P>
35044 <CENTER><SAMP>
35045 openssl pkcs12 -in certificate.p12 -cacerts -nokeys -out certificate-ca.crt
35046 </SAMP></CENTER>
35047
35048 <P> If the previous command produces an empty file, it means that the
35049 certificate authority was not included in the .p12 file, so you will have
35050 to get it from some other sources. You will need these certificates, so
35051 that you can validate correctly signatures.
35052
35053 <P>
35054 After you have exported these certificates and keys, you can  use the import
35055 command in Alpine, from the S/MIME configuration screen,
35056 to import these certificates into Alpine. They will be available for use
35057 as soon as you import them.
35058 <P>
35059 &lt;End of help on this topic&gt;
35060 </BODY>
35061 </HTML>
35062 ====== h_config_smime_pubcertdir =====
35063 <HTML>
35064 <HEAD>
35065 <TITLE>S/MIME OPTION: <!--#echo var="VAR_smime-public-cert-directory"--></TITLE>
35066 </HEAD>
35067 <BODY>
35068 <H1>S/MIME OPTION: <!--#echo var="VAR_smime-public-cert-directory"--></H1>
35069
35070 UNIX Alpine only.
35071 <P>
35072 If the option
35073 <A HREF="h_config_smime_pubcertcon"><!--#echo var="VAR_smime-public-cert-container"--></A>
35074 is set then this option will have no effect.
35075 <P>
35076 Normally, Public Certificates for use with S/MIME will be stored in the directory
35077 which is the value of this option.
35078 Those certificates will be stored in PEM format, one certificate per file.
35079 The name of the file for the certificate corresponding to
35080 <P>
35081 <CENTER><SAMP>emailaddress</SAMP></CENTER>
35082 <P>
35083 should be
35084 <P>
35085 <CENTER><SAMP>emailaddress.crt</SAMP></CENTER>
35086 <P>
35087 For example, a file for user@example.com would be in the file
35088 <P>
35089 <CENTER><SAMP>user@example.com.crt</SAMP></CENTER>
35090 <P>
35091 in this directory.
35092 <P>
35093 Use the Setup/SMIME screen to modify this variable.
35094 <P>
35095 Typically, the public certificates that you have will come from S/MIME signed
35096 messages that are sent to you.
35097 Alpine will extract the public certificate from the signed message and store
35098 it in the certificates directory.
35099 These PEM format public certificates look something like:
35100 <PRE>
35101 -----BEGIN CERTIFICATE-----
35102 MIIFvTCCBKWgAwIBAgIQD4fYFHVI8T20yN4nus097DANBgkqhkiG9w0BAQUFADCB
35103 rjELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAlVUMRcwFQYDVQQHEw5TYWx0IExha2Ug
35104 Q2l0eTEeMBwGA1UEChMVVGhlIFVTRVJUUlVTVCBOZXR3b3JrMSEwHwYDVQQLExho
35105 ...
35106 2b9KGqDyMWW/rjNnmpjzjT2ObGM7lRA8lke4FLOLajhrz4ogO3b4DFfAAM1VSZH8
35107 D6sOwOLJZkLY8FRsfk63K+2EMzA2+qAzMKupgeTLqXIf
35108 -----END CERTIFICATE-----
35109 </PRE>
35110 <P>
35111 <UL>
35112 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35113 </UL><P>
35114 <P>
35115 <UL>
35116 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35117 </UL><P>
35118 &lt;End of help on this topic&gt;
35119 </BODY>
35120 </HTML>
35121 ====== h_config_smime_pubcertcon =====
35122 <HTML>
35123 <HEAD>
35124 <TITLE>OPTION: <!--#echo var="VAR_smime-public-cert-container"--></TITLE>
35125 </HEAD>
35126 <BODY>
35127 <H1>OPTION: <!--#echo var="VAR_smime-public-cert-container"--></H1>
35128
35129 UNIX Alpine only.
35130 <P>
35131 If this option is set it will be used instead of
35132 <A HREF="h_config_smime_pubcertdir"><!--#echo var="VAR_smime-public-cert-directory"--></A>.
35133 <P>
35134 This option gives you a way to store certificates remotely on an IMAP server
35135 instead of storing the certificates one per file locally.
35136 In order to do that you just give this option a remote folder name for a folder
35137 which does not yet exist.
35138 The name is similar to the name you might use for a remote configuration file.
35139 A remote folder name might look something like:
35140 <P>
35141 <CENTER><SAMP>{myimaphost.myschool.k12.wa.us}mail/publiccerts</SAMP></CENTER>
35142 <P>
35143 See
35144 <A HREF="h_valid_folder_names">Valid Folder Names</A> for more information
35145 about the syntax of folder names.
35146 <P>
35147 Use the Setup/SMIME screen to modify this variable.
35148 <P>
35149 <UL>
35150 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35151 </UL><P>
35152 <P>
35153 <UL>
35154 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35155 </UL><P>
35156 &lt;End of help on this topic&gt;
35157 </BODY>
35158 </HTML>
35159 ====== h_config_smime_privkeydir =====
35160 <HTML>
35161 <HEAD>
35162 <TITLE>OPTION: <!--#echo var="VAR_smime-private-key-directory"--></TITLE>
35163 </HEAD>
35164 <BODY>
35165 <H1>OPTION: <!--#echo var="VAR_smime-private-key-directory"--></H1>
35166
35167 UNIX Alpine only.
35168 <P>
35169 In order to sign outgoing S/MIME messages you will need a
35170 personal digital ID certificate.
35171 You will usually get such a certificate from a certificate authority such as
35172 Thawte or CAcert.
35173 (In order to encrypt outgoing messages you don't need a personal digital ID, you
35174 need the public certificate of the recipient instead.)
35175 If the option
35176 <A HREF="h_config_smime_privkeycon"><!--#echo var="VAR_smime-private-key-container"--></A>
35177 is set then this option will have no effect.
35178 <P>
35179 Normally, Private Keys for use with S/MIME will be stored in the directory
35180 which is the value of this option.
35181 Those certificates will be stored in PEM format, one certificate per file.
35182 The name of the file for the certificate corresponding to your
35183 <P>
35184 <CENTER><SAMP>emailaddress</SAMP></CENTER>
35185 <P>
35186 should be
35187 <P>
35188 <CENTER><SAMP>emailaddress.key</SAMP></CENTER>
35189 <P>
35190 For example, if your address is user@example.com the name of the file would be
35191 <P>
35192 <CENTER><SAMP>user@example.com.key</SAMP></CENTER>
35193 <P>
35194 in this directory.
35195 <P>
35196 Use the Setup/SMIME screen to modify this variable.
35197 <P>
35198 Typically, the private key that you have will come from a Certificate
35199 Authority.
35200 The private key should be stored in a PEM format file that
35201 looks something like:
35202 <PRE>
35203 -----BEGIN RSA PRIVATE KEY-----
35204 Proc-Type: 4,ENCRYPTED
35205 DEK-Info: DES-EDE3-CBC,2CBD328FD84CF5C6
35206
35207 YBEXYLgLU9NJoc1V+vJ6UvcF08RX54S6jXsmgL0b5HGkudG6fhnmHkH7+UCvM5NI
35208 SXO/F8iuZDfs1VGG0NyitkFZ0Zn2vfaGovBvm15gx24b2xnZDLRB7/bNZkurnK5k
35209 VjAjZ2xXn2hFp2GJwqRdmxYNqsKGu52B99oti5HUWuZ2GFRaWjn5hYOqeApZE2uA
35210 ...
35211 oSRqfI51UdSRt0tmGhHeTvybUVrHm9eKft8TTGf+qSBqzSc55CsmoVbRzw4Nfhix
35212 m+4TJybNGNfAgOctSkEyY/OCb49fRRQTCBZVIhzLGGmpYmkO55HbIA==
35213 -----END RSA PRIVATE KEY-----
35214 </PRE>
35215 <P>
35216 <UL>
35217 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35218 </UL><P>
35219 <P>
35220 <UL>
35221 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35222 </UL><P>
35223 &lt;End of help on this topic&gt;
35224 </BODY>
35225 </HTML>
35226 ====== h_config_smime_privkeycon =====
35227 <HTML>
35228 <HEAD>
35229 <TITLE>OPTION: <!--#echo var="VAR_smime-private-key-container"--></TITLE>
35230 </HEAD>
35231 <BODY>
35232 <H1>OPTION: <!--#echo var="VAR_smime-private-key-container"--></H1>
35233
35234 UNIX Alpine only.
35235 <P>
35236 If this option is set it will be used instead of
35237 <A HREF="h_config_smime_privkeydir"><!--#echo var="VAR_smime-private-key-directory"--></A>.
35238 <P>
35239 This option gives you a way to store keys remotely on an IMAP server
35240 instead of storing the keys one per file locally.
35241 In order to do that you just give this option a remote folder name for a folder
35242 which does not yet exist.
35243 The name is similar to the name you might use for a remote configuration file.
35244 A remote folder name might look something like:
35245 <P>
35246 <CENTER><SAMP>{myimaphost.myschool.k12.wa.us}mail/privatekeys</SAMP></CENTER>
35247 <P>
35248 See
35249 <A HREF="h_valid_folder_names">Valid Folder Names</A> for more information
35250 about the syntax of folder names.
35251 <P>
35252 Use the Setup/SMIME screen to modify this variable.
35253 <P>
35254 <UL>
35255 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35256 </UL><P>
35257 <P>
35258 <UL>
35259 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35260 </UL><P>
35261 &lt;End of help on this topic&gt;
35262 </BODY>
35263 </HTML>
35264 ====== h_config_smime_cacertdir =====
35265 <HTML>
35266 <HEAD>
35267 <TITLE>S/MIME OPTION: <!--#echo var="VAR_smime-cacert-directory"--></TITLE>
35268 </HEAD>
35269 <BODY>
35270 <H1>S/MIME OPTION: <!--#echo var="VAR_smime-cacert-directory"--></H1>
35271
35272 UNIX Alpine only.
35273 <P>
35274 If the option
35275 <A HREF="h_config_smime_cacertcon"><!--#echo var="VAR_smime-cacert-container"--></A>
35276 is set then this option will have no effect.
35277 <P>
35278 CACert is a shorthand name for certification authority certificate.
35279 Normally Alpine will use the CACerts that are located in the standard system
35280 location for CACerts.
35281 It may be the case that one of your correspondents has a Digital ID which has
35282 been signed by a certificate authority that is not in the regular set of system certificate
35283 authorities.
35284 You may supplement the system list by adding further certificates of your own.
35285 These should  be stored in the directory
35286 which is the value of this option.
35287 The certificates will be stored in PEM format, one certificate per file.
35288 The names of the files can be anything ending in &quot;.crt&quot;.
35289 <P>
35290 Use the Setup/SMIME screen to modify this variable.
35291 <P>
35292 These PEM format CA certificates look very similar to your public
35293 certificates for particular email addresses
35294 (<A HREF="h_config_smime_pubcertdir"><!--#echo var="VAR_smime-public-cert-directory"--></A>).
35295 <P>
35296 <UL>
35297 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35298 </UL><P>
35299 <P>
35300 <UL>
35301 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35302 </UL><P>
35303 &lt;End of help on this topic&gt;
35304 </BODY>
35305 </HTML>
35306 ====== h_config_smime_cacertcon =====
35307 <HTML>
35308 <HEAD>
35309 <TITLE>S/MIME OPTION: <!--#echo var="VAR_smime-cacert-container"--></TITLE>
35310 </HEAD>
35311 <BODY>
35312 <H1>S/MIME OPTION: <!--#echo var="VAR_smime-cacert-container"--></H1>
35313
35314 UNIX Alpine only.
35315 <P>
35316 If this option is set it will be used instead of
35317 <A HREF="h_config_smime_cacertdir"><!--#echo var="VAR_smime-cacert-directory"--></A>.
35318 <P>
35319 This option gives you a way to store certificates remotely on an IMAP server
35320 instead of storing the certificates one per file locally.
35321 In order to do that you just give this option a remote folder name for a folder
35322 which does not yet exist.
35323 The name is similar to the name you might use for a remote configuration file.
35324 A remote folder name might look something like:
35325 <P>
35326 <CENTER><SAMP>{myimaphost.myschool.k12.wa.us}mail/cacerts</SAMP></CENTER>
35327 <P>
35328 See
35329 <A HREF="h_valid_folder_names">Valid Folder Names</A> for more information
35330 about the syntax of folder names.
35331 <P>
35332 Use the Setup/SMIME screen to modify this variable.
35333 <P>
35334 <UL>
35335 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35336 </UL><P>
35337 <P>
35338 <UL>
35339 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35340 </UL><P>
35341 &lt;End of help on this topic&gt;
35342 </BODY>
35343 </HTML>
35344 ========== h_config_smime_sign_by_default ==========
35345 <HTML>
35346 <HEAD>
35347 <TITLE>S/MIME FEATURE: <!--#echo var="FEAT_smime-sign-by-default"--></TITLE>
35348 </HEAD>
35349 <BODY>
35350 <H1>S/MIME FEATURE: <!--#echo var="FEAT_smime-sign-by-default"--></H1>
35351
35352 UNIX Alpine only.
35353 <P>
35354 This feature only has an effect if your version of Alpine includes
35355 support for S/MIME.
35356 It affects Alpine's behavior when you send a message.
35357 If this option is set, the &quot;Sign&quot; option will default to ON when sending messages.
35358 <P>
35359 Only the default value is affected.
35360 In any case, you may still toggle the Signing option on or off before sending
35361 with the &quot;G Sign&quot; command (provided you have a personal digital ID
35362 certificate).
35363 <P>
35364 <UL>
35365 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35366 </UL><P>
35367 <P>
35368
35369 <UL>
35370 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35371 </UL><P>
35372 &lt;End of help on this topic&gt;
35373 </BODY>
35374 </HTML>
35375 ========== h_config_smime_use_cert_store ==========
35376 <HTML>
35377 <HEAD>
35378 <TITLE>S/MIME FEATURE: <!--#echo var="FEAT_smime-use-store-only"--></TITLE>
35379 </HEAD>
35380 <BODY>
35381 <H1>S/MIME FEATURE: <!--#echo var="FEAT_smime-use-store-only"--></H1>
35382
35383 UNIX Alpine only.
35384 <P>
35385 This feature only has an effect if your version of Alpine includes
35386 support for S/MIME.
35387 It affects Alpine's behavior when you validate a message, and should
35388 not be disabled, unless you are performing a test.
35389 <P>
35390 There are two important aspects of validation: validation of the message
35391 (that is, the message was not modified after it was sent)
35392 as well as validation of the identity of the sender. This option has to
35393 do with the latter.
35394 <P>
35395 In order to validate that the message came from the sender in the message
35396 and not an impersonator, Alpine can
35397 either use the certificates that come in the message, or the ones that
35398 you have personally stored. If this feature is enabled (the default) then
35399 Alpine will use certificates that you have already saved in your store
35400 and not those that come in the message to validate the sender of the
35401 message. In particular, the first time that you receive a signed message
35402 from a sender, and their certificate does not validate against your
35403 store, then you will be asked if you wish to save such certificate. If
35404 you do not wish to save the certificate, then Alpine will fail to validate
35405 the signature of the message. Otherwise, Alpine will proceed to validate
35406 the signature of the message. This behavior helps you prevent against impersonation, because
35407 it is assumed that you trust the certificates that you have saved, and
35408 might not trust those that came with the message that you are validating.
35409 <P>
35410 <UL>
35411 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35412 </UL><P>
35413 <P>
35414
35415 <UL>
35416 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35417 </UL><P>
35418 &lt;End of help on this topic&gt;
35419 </BODY>
35420 </HTML>
35421 ========== h_config_smime_pubcerts_in_keychain ==========
35422 <HTML>
35423 <HEAD>
35424 <TITLE>S/MIME FEATURE: <!--#echo var="FEAT_publiccerts-in-keychain"--></TITLE>
35425 </HEAD>
35426 <BODY>
35427 <H1>S/MIME FEATURE: <!--#echo var="FEAT_publiccerts-in-keychain"--></H1>
35428
35429 UNIX Alpine only.
35430 <P>
35431 If this feature is set the Mac OS X default keychain will be used as the place
35432 to store public certificates instead of a
35433 <A HREF="h_config_smime_pubcertdir"><!--#echo var="VAR_smime-public-cert-directory"--></A>
35434 or a
35435 <A HREF="h_config_smime_pubcertcon"><!--#echo var="VAR_smime-public-cert-container"--></A>.
35436 <P>
35437 <UL>
35438 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35439 </UL><P>
35440 <P>
35441 <UL>
35442 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35443 </UL><P>
35444 &lt;End of help on this topic&gt;
35445 </BODY>
35446 </HTML>
35447 ========== h_config_smime_dont_do_smime ==========
35448 <HTML>
35449 <HEAD>
35450 <TITLE>S/MIME FEATURE: <!--#echo var="FEAT_smime-dont-do-smime"--></TITLE>
35451 </HEAD>
35452 <BODY>
35453 <H1>S/MIME FEATURE: <!--#echo var="FEAT_smime-dont-do-smime"--></H1>
35454
35455 UNIX Alpine only.
35456 <P>
35457 Setting this feature turns off all of Alpine's S/MIME support.
35458 You might want to set this if you are having trouble due to the S/MIME support.
35459 <P>
35460 <UL>
35461 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35462 </UL><P>
35463 <P>
35464
35465 <UL>
35466 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35467 </UL><P>
35468 &lt;End of help on this topic&gt;
35469 </BODY>
35470 </HTML>
35471 ========== h_config_smime_encrypt_by_default ==========
35472 <HTML>
35473 <HEAD>
35474 <TITLE>S/MIME FEATURE: <!--#echo var="FEAT_smime-encrypt-by-default"--></TITLE>
35475 </HEAD>
35476 <BODY>
35477 <H1>S/MIME FEATURE: <!--#echo var="FEAT_smime-encrypt-by-default"--></H1>
35478
35479 UNIX Alpine only.
35480 <P>
35481 This feature only has an effect if your version of Alpine includes
35482 support for S/MIME.
35483 It affects Alpine's behavior when you send a message.
35484 If this option is set, the &quot;Encrypt&quot; option will default to ON when sending messages.
35485 <P>
35486 Only the default value is affected.
35487 In any case, you may still toggle the Encrypt option on or off before sending
35488 with the &quot;E Encrypt&quot; command (provided you have a the public digital ID
35489 for the recipient).
35490 <P>
35491 <UL>
35492 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35493 </UL><P>
35494 <P>
35495
35496 <UL>
35497 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35498 </UL><P>
35499 &lt;End of help on this topic&gt;
35500 </BODY>
35501 </HTML>
35502 ========== h_config_smime_remember_passphrase ==========
35503 <HTML>
35504 <HEAD>
35505 <TITLE>S/MIME FEATURE: <!--#echo var="FEAT_smime-remember-passphrase"--></TITLE>
35506 </HEAD>
35507 <BODY>
35508 <H1>S/MIME FEATURE: <!--#echo var="FEAT_smime-remember-passphrase"--></H1>
35509
35510 UNIX Alpine only.
35511 <P>
35512 This feature only has an effect if your version of Alpine includes
35513 support for S/MIME.
35514 If this option is set, you will only have to enter your passphrase for your private key
35515 once during an Alpine session.
35516 <P>
35517 <UL>
35518 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35519 </UL><P>
35520 <P>
35521
35522 <UL>
35523 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35524 </UL><P>
35525 &lt;End of help on this topic&gt;
35526 </BODY>
35527 </HTML>
35528 ====== h_config_smime_transfer_pub_to_con =====
35529 <HTML>
35530 <HEAD>
35531 <TITLE>S/MIME: Transfer Public Certs to Container</TITLE>
35532 </HEAD>
35533 <BODY>
35534 <H1>S/MIME: Transfer Public Certs to Container</H1>
35535
35536 UNIX Alpine only.
35537 <P>
35538 The Transfer command will copy the public certificates in your configured
35539 <A HREF="h_config_smime_pubcertdir"><!--#echo var="VAR_smime-public-cert-directory"--></A>
35540 to the container in your configured
35541 <A HREF="h_config_smime_pubcertcon"><!--#echo var="VAR_smime-public-cert-container"--></A>.
35542 This might be useful if you decide to switch from using a cert directory to a cert
35543 container.
35544 <P>
35545 Warning: Any previous contents in the container will be lost.
35546 <P>
35547 <UL>
35548 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35549 </UL><P>
35550 <P>
35551 <UL>
35552 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35553 </UL><P>
35554 &lt;End of help on this topic&gt;
35555 </BODY>
35556 </HTML>
35557 ====== h_config_smime_transfer_pub_to_dir =====
35558 <HTML>
35559 <HEAD>
35560 <TITLE>S/MIME: Transfer Public Certs to Directory</TITLE>
35561 </HEAD>
35562 <BODY>
35563 <H1>S/MIME: Transfer Public Certs to Directory</H1>
35564
35565 UNIX Alpine only.
35566 <P>
35567 The Transfer command will copy the public certificates in your configured
35568 <A HREF="h_config_smime_pubcertcon"><!--#echo var="VAR_smime-public-cert-container"--></A>
35569 to the directory in your configured
35570 <A HREF="h_config_smime_pubcertdir"><!--#echo var="VAR_smime-public-cert-directory"--></A>.
35571 This might be useful if you decide to switch from using a cert container to a cert
35572 directory.
35573 <P>
35574 <UL>
35575 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35576 </UL><P>
35577 <P>
35578 <UL>
35579 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35580 </UL><P>
35581 &lt;End of help on this topic&gt;
35582 </BODY>
35583 </HTML>
35584 ====== h_config_smime_transfer_priv_to_con =====
35585 <HTML>
35586 <HEAD>
35587 <TITLE>S/MIME: Transfer Private Keys to Container</TITLE>
35588 </HEAD>
35589 <BODY>
35590 <H1>S/MIME: Transfer Private Keys to Container</H1>
35591
35592 UNIX Alpine only.
35593 <P>
35594 The Transfer command will copy the private keys in your configured
35595 <A HREF="h_config_smime_privkeydir"><!--#echo var="VAR_smime-private-key-directory"--></A>.
35596 to the container in your configured
35597 <A HREF="h_config_smime_privkeydir"><!--#echo var="VAR_smime-private-key-container"--></A>.
35598 This might be useful if you decide to switch from using a key directory to a key
35599 container.
35600 <P>
35601 Warning: Any previous contents in the container will be lost.
35602 <P>
35603 <UL>
35604 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35605 </UL><P>
35606 <P>
35607 <UL>
35608 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35609 </UL><P>
35610 &lt;End of help on this topic&gt;
35611 </BODY>
35612 </HTML>
35613 ====== h_config_smime_transfer_priv_to_dir =====
35614 <HTML>
35615 <HEAD>
35616 <TITLE>S/MIME: Transfer Private Keys to Directory</TITLE>
35617 </HEAD>
35618 <BODY>
35619 <H1>S/MIME: Transfer Private Keys to Directory</H1>
35620
35621 UNIX Alpine only.
35622 <P>
35623 The Transfer command will copy the private keys in your configured
35624 <A HREF="h_config_smime_privkeydir"><!--#echo var="VAR_smime-private-key-container"--></A>.
35625 to the directory in your configured
35626 <A HREF="h_config_smime_privkeydir"><!--#echo var="VAR_smime-private-key-directory"--></A>.
35627 This might be useful if you decide to switch from using a key container to a key
35628 directory.
35629 <P>
35630 <UL>
35631 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35632 </UL><P>
35633 <P>
35634 <UL>
35635 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35636 </UL><P>
35637 &lt;End of help on this topic&gt;
35638 </BODY>
35639 </HTML>
35640 ====== h_config_smime_transfer_cacert_to_con =====
35641 <HTML>
35642 <HEAD>
35643 <TITLE>S/MIME: Transfer CA Certs to Container</TITLE>
35644 </HEAD>
35645 <BODY>
35646 <H1>S/MIME: Transfer CA Certs to Container</H1>
35647
35648 UNIX Alpine only.
35649 <P>
35650 The Transfer command will copy the CA certificates in your configured
35651 <A HREF="h_config_smime_cacertdir"><!--#echo var="VAR_smime-cacert-directory"--></A>
35652 to the container in your configured
35653 <A HREF="h_config_smime_cacertcon"><!--#echo var="VAR_smime-cacert-container"--></A>.
35654 This might be useful if you decide to switch from using a CA cert directory to a CA cert
35655 container.
35656 <P>
35657 Warning: Any previous contents in the container will be lost.
35658 <P>
35659 <UL>
35660 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35661 </UL><P>
35662 <P>
35663 <UL>
35664 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35665 </UL><P>
35666 &lt;End of help on this topic&gt;
35667 </BODY>
35668 </HTML>
35669 ====== h_config_smime_transfer_cacert_to_dir =====
35670 <HTML>
35671 <HEAD>
35672 <TITLE>S/MIME: Transfer CA Certs to Directory</TITLE>
35673 </HEAD>
35674 <BODY>
35675 <H1>S/MIME: Transfer CA Certs to Directory</H1>
35676
35677 UNIX Alpine only.
35678 <P>
35679 The Transfer command will copy the CA certificates in your configured
35680 <A HREF="h_config_smime_cacertcon"><!--#echo var="VAR_smime-cacert-container"--></A>.
35681 to the directory in your configured
35682 <A HREF="h_config_smime_cacertdir"><!--#echo var="VAR_smime-cacert-directory"--></A>.
35683 This might be useful if you decide to switch from using a CA cert container to a CA cert
35684 directory.
35685 <P>
35686 <UL>
35687 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35688 </UL><P>
35689 <P>
35690 <UL>
35691 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35692 </UL><P>
35693 &lt;End of help on this topic&gt;
35694 </BODY>
35695 </HTML>
35696 ====== h_config_smime_transfer_pubcon_to_key =====
35697 <HTML>
35698 <HEAD>
35699 <TITLE>S/MIME: Transfer Public Certs to Keychain</TITLE>
35700 </HEAD>
35701 <BODY>
35702 <H1>S/MIME: Transfer Public Certs to Keychain</H1>
35703
35704 Mac OS X Alpine only.
35705 <P>
35706 The Transfer command will copy the public certificates in your configured
35707 <A HREF="h_config_smime_pubcertcon"><!--#echo var="VAR_smime-public-cert-container"--></A>
35708 to your default Mac OS X Keychain.
35709 This might be useful if you decide to switch from using a cert container to using
35710 the Keychain to store your public certs, which you may do by using the
35711 feature
35712 <A HREF="h_config_smime_pubcerts_in_keychain">S/MIME FEATURE: <!--#echo var="FEAT_publiccerts-in-keychain"--></A>.
35713 <P>
35714 <UL>
35715 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35716 </UL><P>
35717 <P>
35718 <UL>
35719 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35720 </UL><P>
35721 &lt;End of help on this topic&gt;
35722 </BODY>
35723 </HTML>
35724 ====== h_config_smime_transfer_pubkey_to_con =====
35725 <HTML>
35726 <HEAD>
35727 <TITLE>S/MIME: Transfer Public Certs to Keychain</TITLE>
35728 </HEAD>
35729 <BODY>
35730 <H1>S/MIME: Transfer Public Certs to Keychain</H1>
35731
35732 UNIX Alpine only.
35733 <P>
35734 The Transfer command will copy the public certificates in your configured
35735 <A HREF="h_config_smime_pubcertcon"><!--#echo var="VAR_smime-public-cert-container"--></A>
35736 to your default Mac OS X Keychain.
35737 This might be useful if you decide to switch from using a cert container to using
35738 the Keychain to store your public certs.
35739 <P>
35740 <UL>
35741 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35742 </UL><P>
35743 <P>
35744 <UL>
35745 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35746 </UL><P>
35747 &lt;End of help on this topic&gt;
35748 </BODY>
35749 </HTML>
35750 ====== h_config_smime_public_certificates =====
35751 <HTML>
35752 <HEAD>
35753 <TITLE>S/MIME: Manage Public Certificates</TITLE>
35754 </HEAD>
35755 <BODY>
35756 <H1>S/MIME: Manage Public Certificates</H1>
35757
35758 UNIX Alpine only.
35759 <P>
35760 This menu item allows you to manage your public certificates, this
35761 may include your own public certificate, but it normally includes
35762 certificates of people you correspond with. These certificates are
35763 saved by Alpine automatically when they are found in signed messages
35764 that you receive. This interface allows you to manage them, by
35765 giving you the option to delete them, or trust them (in the case
35766 of self-signed certificates).
35767
35768 <P>
35769 Please note that Alpine will not validate a message that was sent to you
35770 using a self-signed certificate, unless you decide to trust that certificate.
35771 Internally, a certificate is trusted by copying it to the
35772 <A HREF="h_config_smime_certificate_authorities">Certificate Authorities</A>
35773 collection. If you decide that you want to stop trusting a self-signed
35774 certificate, you must delete such certificate from such collection.
35775 <P>
35776 The <B>I</B> Import command available in this screen allows you to
35777 import a command to this collection.
35778 <P>
35779 <UL>
35780 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35781 </UL><P>
35782 <P>
35783 <UL>
35784 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35785 </UL><P>
35786 &lt;End of help on this topic&gt;
35787 </BODY>
35788 </HTML>
35789 ====== h_config_smime_private_keys =====
35790 <HTML>
35791 <HEAD>
35792 <TITLE>S/MIME: Manage Private Keys</TITLE>
35793 </HEAD>
35794 <BODY>
35795 <H1>S/MIME: Manage Private Keys</H1>
35796
35797 UNIX Alpine only.
35798 <P>
35799 This option allows you to manage your private key. Normally a person has only
35800 one key, in the same way that a person only has one valid passport, or ID card,
35801 at any given time. This option allows you to manage private keys. You can
35802 delete them or import them. Additionally, you can view information
35803 about your public certificate, such as the issuer and the dates of validity
35804 of such certificate, among others.
35805
35806 <P>
35807 If you have more than one e-mail address for which you want to use the
35808 same private key, you must add all those addresses to the private key at
35809 the moment that the key is generated. When you receive a signed message using
35810 a key generated for several e-mail addresses, Alpine will save a
35811 certificate for each e-mail address included in such certificate.
35812 <P>
35813 The <B>I</B> Import command available in this screen allows you to
35814 import a command to this collection.
35815 <P>
35816 <UL>
35817 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35818 </UL><P>
35819 <P>
35820 <UL>
35821 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35822 </UL><P>
35823 &lt;End of help on this topic&gt;
35824 </BODY>
35825 </HTML>
35826 ====== h_config_smime_certificate_authorities =====
35827 <HTML>
35828 <HEAD>
35829 <TITLE>S/MIME: Manage Certificate Authorities</TITLE>
35830 </HEAD>
35831 <BODY>
35832 <H1>S/MIME: Manage Certificate Authorities</H1>
35833
35834 UNIX Alpine only.
35835 <P>
35836 This collection contains certificates that are needed to validate the
35837 certificate of another person, and therefore contains certificates that
35838 you trust. Typically a certificate is signed by another entity, called a
35839 certificate authority. This option allows you to manage which certificates
35840 you trust, allowing you to import them and to delete them or view information
35841 about each certificate, such as the issuer and the dates of validity
35842 of such certificate.
35843 <P>
35844 The <B>I</B> Import command available in this screen allows you to
35845 import a command to this collection.
35846 <P>
35847 <UL>
35848 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35849 </UL><P>
35850 <P>
35851 <UL>
35852 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35853 </UL><P>
35854 &lt;End of help on this topic&gt;
35855 </BODY>
35856 </HTML>
35857 ====== h_config_smime_password_file_certificates =====
35858 <HTML>
35859 <HEAD>
35860 <TITLE>S/MIME: Manage Password File Certificates</TITLE>
35861 </HEAD>
35862 <BODY>
35863 <H1>S/MIME: Manage Password File Certificates</H1>
35864
35865 UNIX Alpine only.
35866 <P>
35867 This option allows you to manage the certificates that are used to
35868 encrypt and decrypt your password file. This is useful in case you
35869 want to change the certificates used to encrypt your password file.
35870 <P>
35871 In order to avoid unauthorized use of this option, you are asked to
35872 enter the password of the current private key used to encrypt your
35873 password file.
35874 <P>
35875 Once you have entered your password for the current key, you enter a
35876 screen where you can import your new key, and see the information on your
35877 current key.
35878 <P>
35879 To import a new key press &quot;RETURN&quot; and enter the location of
35880 the new key. You will be asked to enter the password of the new key. If
35881 this part of the process is successful, Alpine will search for the
35882 certificate that matches that key. If your key is named
35883 &quot;your_email@address.com.key&quot;, then Alpine will look for your
35884 certificate in the same directory in the file named
35885 &quot;your_email@address.com.crt&quot;, otherwise it will look for it
35886 as part of your key (that is, it will look to see if your certificate
35887 is in the file &quot;your_email@address.com.key&quot;), if all of this
35888 fails, Alpine will ask you to enter the location of the certificate
35889 that matches the key you unlocked. If a certificate is found, it will be
35890 used, and in this case, the password file will be read, decrypted with the
35891 old key and encrypted with the new key. Once this is done, the new key and
35892 certificates are saved, and the old keys are permanently deleted.
35893 <P>
35894 Alpine does not create a backup of your password file, or your old keys
35895 that will be replaced. If you need to keep old copies, you will have to do
35896 this operation outside Alpine.
35897 <UL>
35898 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35899 </UL><P>
35900 <P>
35901 <UL>
35902 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35903 </UL><P>
35904 &lt;End of help on this topic&gt;
35905 </BODY>
35906 </HTML>
35907 ====== h_certificate_information =====
35908 <HTML>
35909 <HEAD>
35910 <TITLE>S/MIME: Certificate Information Screen</TITLE>
35911 </HEAD>
35912 <BODY>
35913 <H1>S/MIME: Certificate Information Screen</H1>
35914
35915 UNIX Alpine only.
35916 <P>
35917 The CERTIFICATE INFORMATION screen shows you information contained in a certificate
35918 such as its owner, e-mail address, issuer, and interval of validity,
35919 among others.
35920 <P>
35921 In the case of public certificates, this screen shows you if there was a
35922 failure when attempting to validate such message. If the certificate is
35923 self-signed, then the <B>T</B> Trust command will be available, which
35924 you can use to trust such certificate and make Alpine not fail validating
35925 signatures signed with such certificate.
35926 <P>
35927 You can also mark a certificate deleted, with the <B>D</B> command, or
35928 remove the deleted mark with the <B>U</B> undelete command.
35929 <P>
35930 In the case of your private key, Alpine shows you the information
35931 from your public key. Additionally, Alpine allows you to see public
35932 and private information about your key, with the <B>B</B> and
35933 <B>R</B> commands respectively.
35934 <UL>
35935 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35936 </UL><P>
35937 <P>
35938 <UL>
35939 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35940 </UL><P>
35941 &lt;End of help on this topic&gt;
35942 </BODY>
35943 </HTML>
35944 ====== h_config_smime_manage_public_menu =====
35945 <HTML>
35946 <HEAD>
35947 <TITLE>S/MIME: Menu of Commands to Manage Public Certificates</TITLE>
35948 </HEAD>
35949 <BODY>
35950 <H1>S/MIME: Commands that Manage Public Certificates</H1>
35951
35952 UNIX Alpine only.
35953 <P>
35954 This screen allows you to manage your public certificates.
35955 <P>
35956 The format of this screen is as follows. There are five fields: The
35957 leftmost field is normally empty, but it could contain the letter
35958 &quot;D&quot; to indicate that that certificate has been marked for
35959 deletion. The next field is the e-mail address of the owner of the
35960 certificate, shown in its entirety. The third and fourth field are the
35961 first and last day validity for that certificate, respectively. The date
35962 is displayed in the user's locale unless the option
35963 <A HREF="h_config_disable_index_locale_dates"><!--#echo var="FEAT_disable-index-locale-dates"--></A>
35964 is set. In this case, the month, day and year are represented by two
35965 digits, and the format used is mm/dd/yy. Finally, the fifth
35966 field is what can be displayed of the MD5 hash of the certificate. You can
35967 use any of the last three fields to distinguish between two certificates
35968 for the same owner.
35969 <P>
35970 Available commands in this screen and a short description of what they
35971 do follows.
35972 <UL>
35973 <LI> <B>I</B> Imports a public certificate to this collection.
35974 <LI> <B>V</B> View information about a certificate such as the name of the person the
35975 certificate was issued to, its dates of validity, and validity status.
35976 <LI> <B>D</B> Marks a certificate deleted.
35977 <LI> <B>U</B> Removes the deletion mark on a certificate.
35978 <LI> <B>X</B> Removes all certificates marked deleted permanently (cannot be undone).
35979 <LI> <B>T</B> This command is only available for self-signed certificates, and allows you to
35980 trust a certificate by copying it to the collection of trusted certificates.
35981 </UL>
35982 <P>
35983 All commands provide feedback to let you know about their success or failure.
35984 <P>
35985 <UL>
35986 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35987 </UL><P>
35988 <P>
35989 <UL>
35990 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35991 </UL><P>
35992 &lt;End of help on this topic&gt;
35993 </BODY>
35994 </HTML>
35995 ====== h_config_smime_manage_private_menu =====
35996 <HTML>
35997 <HEAD>
35998 <TITLE>S/MIME: Menu of Commands to Manage Private Keys</TITLE>
35999 </HEAD>
36000 <BODY>
36001 <H1>S/MIME: Commands that Manage Private Keys</H1>
36002
36003 UNIX Alpine only.
36004 <P>
36005 This screen allows you to manage your private key.
36006 <P>
36007 The format of this screen is as follows. There are five fields: The
36008 leftmost field is normally empty, but it could contain the letter
36009 &quot;D&quot; to indicate that that certificate has been marked for
36010 deletion. The next field is the e-mail address of the owner of the
36011 certificate, shown in its entirety. The third field is the first day of
36012 validity for that certificate; the fourth field in the last day that that
36013 certificate is valid, and the fifth field is what can be displayed of the
36014 MD5 hash of the public certificate corresponding to this private key. You
36015 can use any of the last three fields to distinguish between two
36016 certificates for the same owner.
36017 <P>
36018 Available commands and a short description of what they do follows.
36019 <UL>
36020 <LI> <B>I</B> Imports a new public key to this collection.
36021 <LI> <B>V</B> View information about the public certificate corresponding to this
36022 key.
36023 <LI> <B>D</B> Marks a key to be deleted.
36024 <LI> <B>U</B> Removes the deletion mark on a key.
36025 <LI> <B>X</B> Removes all keys marked deleted permanently (cannot be undone).
36026 Note that expunging a private key does not remove the public key, which must
36027 be removed separately.
36028 </UL>
36029 <P>
36030 All commands provide feedback to let you know about their success or failure.
36031 <P>
36032 <UL>
36033 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36034 </UL><P>
36035 <P>
36036 <UL>
36037 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36038 </UL><P>
36039 &lt;End of help on this topic&gt;
36040 </BODY>
36041 </HTML>
36042 ====== h_config_smime_manage_cacerts_menu =====
36043 <HTML>
36044 <HEAD>
36045 <TITLE>S/MIME: Menu of Commands to Manage Certificate Authorities</TITLE>
36046 </HEAD>
36047 <BODY>
36048 <H1>S/MIME: Commands that Manage Certificate Authorities</H1>
36049
36050 UNIX Alpine only.
36051 <P>
36052 This screen allows you to manage your collection of certificates that you
36053 trust.
36054 <P>
36055 The format of this screen is as follows. There are five fields: The
36056 leftmost field is normally empty, but it could contain the letter
36057 &quot;D&quot; to indicate that that certificate has been marked for
36058 deletion. The next field is the e-mail address of the owner of the
36059 certificate, shown in its entirety. The third field is the first day of
36060 validity for that certificate; the fourth field in the last day that that
36061 certificate is valid, and the fifth field is what can be displayed of the
36062 MD5 hash of the certificate. You can use any of the last three fields to
36063 distinguish between two certificates for the same owner.
36064 <P>
36065 Available commands and a short description of what they do follows.
36066 <UL>
36067 <LI> <B>I</B> Imports a trusted certificate to this collection. This is
36068 done by reading the certificate and validating it. Once a certificate
36069 is found to be valid, it is saved, adding the extension &quot;.crt&quot;
36070 to the certificate, if necessary.
36071 <LI> <B>V</B> View information about this certificate, such as its issuer
36072 and validity dates.
36073 <LI> <B>D</B> Marks a certificate to be deleted.
36074 <LI> <B>U</B> Removes the deletion mark on a certificate.
36075 <LI> <B>X</B> Removes all certificates marked deleted permanently (cannot be undone).
36076 </UL>
36077 <P>
36078 All commands provide feedback to let you know about their success or failure.
36079 <P>
36080 <UL>
36081 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36082 </UL><P>
36083 <P>
36084 <UL>
36085 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36086 </UL><P>
36087 &lt;End of help on this topic&gt;
36088 </BODY>
36089 </HTML>
36090 ====== h_config_lame_list_mode =====
36091 <HTML>
36092 <HEAD>
36093 <TITLE>FEATURE: <!--#echo var="FEAT_enable-lame-list-mode"--></TITLE>
36094 </HEAD>
36095 <BODY>
36096 <H1>FEATURE: <!--#echo var="FEAT_enable-lame-list-mode"--></H1>
36097
36098 This feature modifies the method Alpine uses to ask your IMAP
36099 server for folder names to display in the FOLDER LIST screen.
36100 It is intended to compensate for a small set of IMAP servers that
36101 are programmed to ignore a part of the request, and thus respond
36102 to Alpine's query with nonsensical results.
36103 <P>
36104
36105 If you find that Alpine is erroneously displaying blank folder lists,
36106 try enabling this feature.
36107 <P>
36108
36109 NOTE: Enabling this feature has consequences for the Goto and Save
36110 commands.  Many servers allow access to folders outside the area
36111 reserved for your personal folders via some reserved character,
36112 typically '#' (sharp), '~' (tilde) or '/' (slash).  This mechanism
36113 allows, at the Goto and Save prompts, quick access to folders
36114 outside your personal folder collection without requiring a specific
36115 collection definition.  This behavior will generally not be available
36116 when this feature is enabled.
36117
36118 <P>
36119 <UL>
36120 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36121 </UL><P>
36122 &lt;End of help on this topic&gt;
36123 </BODY>
36124 </HTML>
36125 ====== h_config_enable_mulnewsrcs =====
36126 <HTML>
36127 <HEAD>
36128 <TITLE>FEATURE: <!--#echo var="FEAT_enable-multiple-newsrcs"--></TITLE>
36129 </HEAD>
36130 <BODY>
36131 <H1>FEATURE: <!--#echo var="FEAT_enable-multiple-newsrcs"--></H1>
36132
36133 This feature makes it so Alpine can use multiple newsrcs based on
36134 the news server being connected to, which allows for separate lists
36135 of subscribed-to newsgroups. When this feature is not set, there is only
36136 one list of newsgroups.
36137 <P>
36138 Under this feature, the name of a newsrc is based on the news server.
36139 For example, if your <a href="h_config_newsrc_path"><!--#echo var="VAR_newsrc-path"--></a>
36140 is set to &quot;.newsrc&quot;, and the news server you are connecting to is
36141 news.example.com, then the newsrc to be used is .newsrc-news.example.com.
36142 Setting this feature for the first time will allow for the option of using
36143 your old newsrc the next time you read news.
36144 <P>
36145 If this feature is set, then the feature
36146 <A HREF="h_config_mulnews_as_typed"><!--#echo var="FEAT_mult-newsrc-hostnames-as-typed"--></A>
36147 also may affect the name of the newsrc file that is used.
36148 <P>
36149 <UL>
36150 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36151 </UL><P>
36152 &lt;End of help on this topic&gt;
36153 </BODY>
36154 </HTML>
36155 ======= h_ab_export_vcard =======
36156 <HTML>
36157 <HEAD>
36158 <TITLE>Address Book Export Format</TITLE>
36159 </HEAD>
36160 <BODY>
36161 <H1>Address Book Export Format</H1>
36162
36163 You are exporting address book data from Alpine to a file outside of Alpine.
36164 You are being asked to choose the format of the export.
36165 Here are the choices:
36166
36167 <DL>
36168 <DT><EM>A</EM>ddress List</DT>
36169 <DD>
36170 The addresses from the address book entries you are saving
36171 from will be saved one address per line.
36172 Address book lists (those with more than one address) will have
36173 all of their addresses saved separately.
36174 </DD>
36175
36176 <DT><EM>V</EM>Card</DT>
36177 <DD>
36178 The entries will be saved in
36179 <A HREF="h_whatis_vcard">vCard</A> format.
36180 </DD>
36181
36182 <DT><EM>T</EM>ab Separated</DT>
36183 <DD>
36184 The entries will be saved in tab-separated columns.
36185 There will be just 4 columns of data that correspond to Alpine's
36186 Nickname field, Full Name field, Address field, and Comment field.
36187 It might prove useful to Select only the Simple, non-List address book
36188 entries before Saving.
36189 </DD>
36190
36191 <DT><EM>^C</EM> Cancel</DT>
36192 <DD>
36193 Cancel out of the Save.
36194 </DD>
36195
36196 </DL>
36197
36198
36199 <P>
36200 &lt;End of help on this topic&gt;
36201 </BODY>
36202 </HTML>
36203 ====== h_config_predict_nntp_server =====
36204 <HTML>
36205 <HEAD>
36206 <TITLE>FEATURE: <!--#echo var="FEAT_predict-nntp-server"--></TITLE>
36207 </HEAD>
36208 <BODY>
36209 <H1>FEATURE: <!--#echo var="FEAT_predict-nntp-server"--></H1>
36210
36211 This feature allows Alpine to assume that the open NNTP server at the
36212 time of composition is the NNTP server to which the message should be
36213 posted.  This is especially recommended when there are multiple News
36214 collections.  If this feature is not set, Alpine will try to post to the first server in
36215 the <a href="h_config_nntp_server"><!--#echo var="VAR_nntp-server"--></a> variable.  Setting
36216 this feature also negates the need to add News collection servers to
36217 the <!--#echo var="VAR_nntp-server"--> variable.
36218 <P>
36219 This feature can be especially handy when used in conjunction with
36220 <a href="h_config_enable_mulnewsrcs"><!--#echo var="FEAT_enable-multiple-newsrcs"--></a>.
36221 <P>
36222 <UL>
36223 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36224 </UL><P>
36225 &lt;End of help on this topic&gt;
36226 </BODY>
36227 </HTML>
36228 ====== h_config_nntp_search_uses_overview =====
36229 <HTML>
36230 <HEAD>
36231 <TITLE>FEATURE: <!--#echo var="FEAT_nntp-search-uses-overview"--></TITLE>
36232 </HEAD>
36233 <BODY>
36234 <H1>FEATURE: <!--#echo var="FEAT_nntp-search-uses-overview"--></H1>
36235
36236 This feature should probably be turned on unless it causes trouble.
36237 The results of the NNTP overview command (XOVER) may be used to help
36238 with some searches in news groups.
36239 It should result in quicker response time.
36240 Turning this feature on apparently causes search results which are
36241 different from what you would get with the feature turned off on some
36242 servers.
36243 <P>
36244 <UL>
36245 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36246 </UL><P>
36247 &lt;End of help on this topic&gt;
36248 </BODY>
36249 </HTML>
36250 ====== h_config_thread_sorts_by_arrival =====
36251 <HTML>
36252 <HEAD>
36253 <TITLE>FEATURE: <!--#echo var="FEAT_thread-sorts-by-arrival"--></TITLE>
36254 </HEAD>
36255 <BODY>
36256 <H1>FEATURE: <!--#echo var="FEAT_thread-sorts-by-arrival"--></H1>
36257
36258 This feature affects how a threading sort arranges threads.  The default way
36259 to arrange threads is by the date of the earliest message in the thread.
36260 This feature arranges threads by the last message to arrive in a thread.
36261 <P>
36262 This feature causes old threads that get recent messages to sort to the bottom,
36263 where previously a message arrival to a thread would not rearrange the order of
36264 that thread.
36265 <P>
36266 <UL>
36267 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36268 </UL><P>
36269 &lt;End of help on this topic&gt;
36270 </BODY>
36271 </HTML>
36272 ====== h_config_textplain_int =====
36273 <HTML>
36274 <HEAD>
36275 <TITLE>FEATURE: <!--#echo var="FEAT_show-plain-text-internally"--></TITLE>
36276 </HEAD>
36277 <BODY>
36278 <H1>FEATURE: <!--#echo var="FEAT_show-plain-text-internally"--></H1>
36279
36280 This feature modifies the method Alpine uses to display Text/Plain
36281 MIME attachments from the Attachment Index screen.  Normally, the
36282 &quot;View&quot; command searches for any externally defined (usually
36283 via the
36284 &quot;<A HREF="h_config_mailcap_path">Mailcap</A>&quot; file) viewer,
36285 and displays the selected text within that viewer.
36286
36287 <P>
36288 Enabling this feature causes Alpine to ignore any external viewer
36289 settings and always display text with Alpine's internal viewer.
36290
36291 <P>
36292 <UL>
36293 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36294 </UL><P>
36295 &lt;End of help on this topic&gt;
36296 </BODY>
36297 </HTML>
36298 ====== h_config_wp_columns =====
36299 <HTML>
36300 <HEAD>
36301 <TITLE>WEB ALPINE OPTION: <!--#echo var="VAR_wp-columns"--></TITLE>
36302 </HEAD>
36303 <BODY>
36304 <H1>WEB ALPINE OPTION: <!--#echo var="VAR_wp-columns"--></H1>
36305
36306 Web Alpine only.
36307 <P>
36308 This configuration setting specifies the number of horizontal characters
36309 used to format various WebAlpine pages.  Smaller values will tend to reduce
36310 the amount of horizontal scrolling required to view pages within narrow
36311 browsers, such as those found on PDAs, and larger values will tend to
36312 spread more information across the page.
36313
36314 <P>
36315 The Message List page uses the width to determine how many characters
36316 to assign each field.  Note, a smaller value may result in a disproportionate
36317 amount of blank space between fields on each line.  Similarly, a large
36318 value may result in cramped fields or horizontal scrolling.
36319
36320 <P>
36321 The Message View page uses this value to determine when to wrap lines
36322 in displayed message text.  Note, a smaller value may result in jagged
36323 right margins or confusing quoting.  A larger value may cause lines of text to
36324 run beyond the browser's right edge, requiring horizontal scrolling.
36325
36326 <P>
36327 <UL>
36328 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36329 </UL><P>
36330 &lt;End of help on this topic&gt;
36331 </BODY>
36332 </HTML>
36333 ====== h_config_wp_state =====
36334 <HTML>
36335 <HEAD>
36336 <TITLE>WEB ALPINE OPTION: <!--#echo var="VAR_wp-state"--></TITLE>
36337 </HEAD>
36338 <BODY>
36339 <H1>WEB ALPINE OPTION: <!--#echo var="VAR_wp-state"--></H1>
36340
36341 Web Alpine only.
36342 <P>
36343 Various aspects of cross-session state.
36344
36345 <P>
36346 <UL>
36347 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36348 </UL><P>
36349 &lt;End of help on this topic&gt;
36350 </BODY>
36351 </HTML>
36352 ====== h_config_wp_aggstate =====
36353 <HTML>
36354 <HEAD>
36355 <TITLE>WEB ALPINE OPTION: <!--#echo var="VAR_wp-aggstate"--></TITLE>
36356 </HEAD>
36357 <BODY>
36358 <H1>WEB ALPINE OPTION: <!--#echo var="VAR_wp-aggstate"--></H1>
36359
36360 Web Alpine only.
36361 <P>
36362 Aggregate operations tab state.
36363
36364 <P>
36365 <UL>
36366 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36367 </UL><P>
36368 &lt;End of help on this topic&gt;
36369 </BODY>
36370 </HTML>
36371 ====== h_config_wp_indexlines =====
36372 <HTML>
36373 <HEAD>
36374 <TITLE>WEB ALPINE OPTION: <!--#echo var="VAR_wp-indexlines"--></TITLE>
36375 </HEAD>
36376 <BODY>
36377 <H1>WEB ALPINE OPTION: <!--#echo var="VAR_wp-indexlines"--></H1>
36378
36379 Web Alpine only.
36380 <P>
36381 Number of index lines in table.
36382
36383 <P>
36384 <UL>
36385 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36386 </UL><P>
36387 &lt;End of help on this topic&gt;
36388 </BODY>
36389 </HTML>
36390 ====== h_config_wp_indexheight =====
36391 <HTML>
36392 <HEAD>
36393 <TITLE>WEB ALPINE OPTION: <!--#echo var="VAR_wp-indexheight"--></TITLE>
36394 </HEAD>
36395 <BODY>
36396 <H1>WEB ALPINE OPTION: <!--#echo var="VAR_wp-indexheight"--></H1>
36397
36398 Web Alpine only.
36399 <P>
36400 Index table row height.
36401
36402 <P>
36403 <UL>
36404 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36405 </UL><P>
36406 &lt;End of help on this topic&gt;
36407 </BODY>
36408 </HTML>
36409 ====== h_config_rss_news =====
36410 <HTML>
36411 <HEAD>
36412 <TITLE>WEB ALPINE OPTION: <!--#echo var="VAR_rss_news"--></TITLE>
36413 </HEAD>
36414 <BODY>
36415 <H1>WEB ALPINE OPTION: <!--#echo var="VAR_rss-news"--></H1>
36416
36417 Web Alpine only.
36418 <P>
36419 RSS News feed.
36420
36421 <P>
36422 <UL>
36423 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36424 </UL><P>
36425 &lt;End of help on this topic&gt;
36426 </BODY>
36427 </HTML>
36428 ====== h_config_rss_weather =====
36429 <HTML>
36430 <HEAD>
36431 <TITLE>WEB ALPINE OPTION: <!--#echo var="VAR_rss-weather"--></TITLE>
36432 </HEAD>
36433 <BODY>
36434 <H1>WEB ALPINE OPTION: <!--#echo var="VAR_rss-weather"--></H1>
36435
36436 Web Alpine only.
36437 <P>
36438 RSS Weather feed.
36439
36440 <P>
36441 <UL>
36442 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36443 </UL><P>
36444 &lt;End of help on this topic&gt;
36445 </BODY>
36446 </HTML>
36447 ====== h_config_send_confirms_only_expanded =====
36448 <HTML>
36449 <HEAD>
36450 <TITLE>FEATURE: send-confirms-only-expanded</TITLE>
36451 </HEAD>
36452 <BODY>
36453 <H1>FEATURE: send-confirms-only-expanded (Web Alpine Only)</H1>
36454
36455 This Web Alpine option specifies whether or not a Send confirmations
36456 happens when a composed message is readied for sending or not.  The
36457 default behavior is to not confirm that the nicknames were expanded to
36458 the intended addresses.
36459
36460 <P>
36461 <UL>
36462 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36463 </UL><P>
36464 &lt;End of help on this topic&gt;
36465 </BODY>
36466 </HTML>
36467 ====== h_config_enable_jump_command =====
36468 <HTML>
36469 <HEAD>
36470 <TITLE>FEATURE: enable-jump-command</TITLE>
36471 </HEAD>
36472 <BODY>
36473 <H1>FEATURE: enable-jump-command (Web Alpine Only)</H1>
36474
36475 This Web Alpine option specifies whether or not a Jump command is
36476 offered in the Message List and Message View pages.  The command is
36477 implemented as an input field in the left column of the List and View
36478 screens.
36479
36480 <P>
36481 When enabled and a number is entered in the input field while the
36482 Message List is displayed, the Message List is reframed with the
36483 specified message.  While viewing a message, the message associated
36484 with the specified message number is displayed.
36485
36486 <P>
36487 <UL>
36488 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36489 </UL><P>
36490 &lt;End of help on this topic&gt;
36491 </BODY>
36492 </HTML>
36493 ====== h_config_enable_newmail_sound =====
36494 <HTML>
36495 <HEAD>
36496 <TITLE>FEATURE: enable-newmail-sound</TITLE>
36497 </HEAD>
36498 <BODY>
36499 <H1>FEATURE: enable-newmail-sound (Web Alpine Only)</H1>
36500
36501 This Web Alpine option specifies whether or not a sound file is sent
36502 to the web browser along with the newmail notification message.
36503
36504
36505 <P>
36506 <UL>
36507 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36508 </UL><P>
36509 &lt;End of help on this topic&gt;
36510 </BODY>
36511 </HTML>
36512 ====== h_config_render_html_internally =====
36513 <HTML>
36514 <HEAD>
36515 <TITLE>FEATURE: render-html-internally</TITLE>
36516 </HEAD>
36517 <BODY>
36518 <H1>FEATURE: render-html-internally (Web Alpine Only)</H1>
36519
36520 By default, Web Alpine will pass cleansed HTML text you receive in messages
36521 to the browser for display (rendering).  This feature causes Web Alpine to convert
36522 the HTML text into plain text in the same way Unix and PC-Alpine do.
36523
36524
36525 <P>
36526 <UL>
36527 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36528 </UL><P>
36529 &lt;End of help on this topic&gt;
36530 </BODY>
36531 </HTML>
36532 ====== h_config_role_undo =====
36533 Yes, remember changes and exit back to list of roles; No, discard changes
36534 made in this screen; ^C, cancel exit and stay in this config screen.
36535 ====== h_exit_editor =====
36536 S, save changes and exit from the editor; D, do not save changes but
36537 do exit from the editor; or ^C, cancel exit and stay in the editor.
36538 ====== h_config_undo =====
36539 Yes, save changes and exit; No, exit without saving any changes made since
36540 entering this CONFIGURATION screen; ^C, cancel exit and stay in config screen.
36541 ====== h_os_index_whereis =====
36542 Enter ^V or ^Y to go immediately to the last or first message in the index.
36543 Or, enter the match string followed by RETURN.
36544 ====== h_os_index_whereis_agg =====
36545 Enter ^V or ^Y to go immediately to the last or first message in the index,
36546 Or, enter the match string followed by RETURN (or ^X to select all matches).
36547 =========== h_oe_add_full ==================
36548 Type the full name of the person being added and press the RETURN key.
36549 Press ^C to cancel addition.
36550 =========== h_oe_add_nick ==================
36551 Type a short nickname and press RETURN.  A nickname is a short easy-to-
36552 remember word, name or initials like "joe", or "wcfields."  ^C to cancel.
36553 ========== h_oe_add_addr ================
36554 Type the e-mail address and press RETURN.
36555 Press ^C to cancel addition.
36556 ========== h_oe_crlst_full ==============
36557 Type a long name or description for the list that you are creating and
36558 press RETURN.  Press ^C to cancel creation of list.
36559 =========== h_oe_crlst_nick =============
36560 Type a nickname (short, easy-to-remember name or single word) for the list
36561 you are creating and press RETURN.  Press ^C to cancel.
36562 ========== h_oe_crlst_addr ==============
36563 Type an e-mail address, or a nickname already in the address book that you
36564 want to be part of this list and press RETURN.
36565 ========== h_oe_adlst_addr =============
36566 Type an e-mail address or a nickname already in the address book that you
36567 want to add to this list and press RETURN.
36568 ========== h_oe_editab_nick ============
36569 Change the nickname using the arrow keys and delete key.  Press RETURN
36570 when done.  Press ^C to cancel editing and leave the nickname as it was.
36571 ========== h_oe_editab_full ============
36572 Change the full name using the arrow keys and delete key.  Press RETURN
36573 when done.  Press ^C to cancel editing and leave the full name as it was.
36574 ========== h_oe_editab_addr ============
36575 Change the address using the arrow keys and delete key.  Press RETURN
36576 when done.  Press ^C to cancel editing and leave the address as it was.
36577 ========== h_oe_editab_fcc ============
36578 Change the fcc using the arrow keys and delete key.  Press RETURN when
36579 done.  Press ^C to cancel editing and leave the fcc as it was.
36580 ========== h_oe_editab_comment ============
36581 Change the comment field using the arrow keys and delete key.  Press RETURN
36582 when done.  Press ^C to cancel editing and leave the comment as it was.
36583 ====== h_ab_forward =====
36584 Yes, expand nicknames and qualify local names with your current domain name;
36585 No, leave nicknames and local names as is;  ^C, cancel.
36586 ========== h_ab_export ==========
36587 Type the name of a file to write the addresses into and
36588 press RETURN.  You may also specify an absolute path.  Use ^C to cancel.
36589 ========== h_ab_edit_a_field ==========
36590 Edit any of the fields of the currently selected entry by typing one of the
36591 letters at the bottom of the screen.  Press ^C to cancel edit.
36592 ====== h_ab_del_data_revert =====
36593 Press B to completely delete addrbook and revert to default, C to delete config
36594 and revert while leaving data, or D to only delete data (make it empty).
36595 ====== h_ab_del_data_modify =====
36596 Press B to completely delete addrbook, C to delete configuration while leaving
36597 data, or D to delete data (make it empty) but leave config. ^C to cancel.
36598 ====== h_ab_del_config_modify =====
36599 Yes, remove this address book from my configuration.
36600 No, make no changes now.
36601 ====== h_ab_del_config_revert =====
36602 Yes, remove this address book from my config and revert to default.
36603 No, make no changes now.
36604 ====== h_ab_del_default =====
36605 Yes, remove this default address book from my configuration.
36606 No, make no changes now.
36607 ====== h_ab_really_delete =====
36608 Yes, delete the actual contents of the address book, not just the
36609 configuration.  No, don't delete the data after all, cancel and start over.
36610 ====== h_ab_del_ignore =====
36611 Press I to ignore all the default address books for this category.  Press R to
36612 remove this one address book and add the others to your personal list.
36613 ====== h_ab_del_dir_ignore =====
36614 Press I to ignore all the default directory servers for this category.
36615 Press R to remove this one server and add the others to your personal list.
36616 ====== h_ab_copy_dups =====
36617 Yes, overwrite the existing entry.
36618 No, skip duplicates but save the rest. Press ^C to cancel.
36619 ====== h_confirm_cancel =====
36620 Type C to Confirm that you want to abandon the message you are composing.
36621 Type N or ^C to cancel out of the cancel and keep composing.
36622 ====== h_ab_text_or_vcard =====
36623 Text, start composer with displayed text already included.
36624 VCard, start composer with address book entry attached as a vCard. ^C cancels.
36625 ====== h_ab_backup_or_ldap =====
36626 Backup, copy email address from entry and allow editing of it.
36627 LDAP, copy LDAP search criteria, do not allow editing of it. ^C cancels.
36628 ====== h_ldap_text_or_vcard =====
36629 Text: export displayed text for selected entry. Address: export only the
36630 email address. VCard: export entry in vCard format. ^C cancels.
36631 ====== h_ab_save_exp =====
36632 Save, save entry or entries to an address book.
36633 Export, save to file outside of pine. ^C cancels save.
36634 ====== h_ab_add =====
36635 A, add a brand new entry to this address book.
36636 E, edit the entry that is currently highlighted. ^C to cancel.
36637 ====== h_ab_shuf =====
36638 U, swap order of highlighted address book and the one above it.
36639 D, swap order of highlighted address book and the one below it. ^C to cancel.
36640 ====== h_ab_shuf_up =====
36641 U, swap order of highlighted address book and the one above it.
36642 Press ^C to cancel.
36643 ====== h_ab_shuf_down =====
36644 D, swap order of highlighted address book and the one below it.
36645 Press ^C to cancel.
36646 ====== h_folder_prop =====
36647 Count is # of messages in the folder, Unseen means messages that have not
36648 been read, New means messages that were Recently added to the folder.
36649 ====== h_role_shuf =====
36650 U, swap order of highlighted rule and the one above it.
36651 D, swap order of highlighted rule and the one below it. ^C to cancel.
36652 ====== h_role_shuf_up =====
36653 U, swap order of highlighted rule and the one above it.
36654 Press ^C to cancel.
36655 ====== h_role_shuf_down =====
36656 D, swap order of highlighted rule and the one below it.
36657 Press ^C to cancel.
36658 ====== h_incoming_shuf =====
36659 B, swap order of highlighted directory and the one before it.
36660 F, swap order of highlighted directory and the one after it. ^C to cancel.
36661 ====== h_incoming_shuf_up =====
36662 B, swap order of highlighted directory and the one before it.
36663 Press ^C to cancel.
36664 ====== h_incoming_shuf_down =====
36665 F, swap order of highlighted directory and the one after it.
36666 Press ^C to cancel.
36667 ====== h_dir_shuf =====
36668 U, swap order of highlighted directory and the one above it.
36669 D, swap order of highlighted directory and the one below it. ^C to cancel.
36670 ====== h_dir_shuf_up =====
36671 U, swap order of highlighted directory and the one above it.
36672 Press ^C to cancel.
36673 ====== h_dir_shuf_down =====
36674 D, swap order of highlighted directory and the one below it.
36675 Press ^C to cancel.
36676 ====== h_hdrcolor_shuf =====
36677 U, swap order of highlighted Header Color and the one above it.
36678 D, swap order of highlighted Header Color and the one below it. ^C to cancel.
36679 ====== h_hdrcolor_shuf_up =====
36680 U, swap order of highlighted Header Color and the one above it.
36681 Press ^C to cancel.
36682 ====== h_hdrcolor_shuf_down =====
36683 D, swap order of highlighted Header Color and the one below it.
36684 Press ^C to cancel.
36685 ========== h_oe_editab_al ============
36686 Change the address using the arrow keys and delete key.  Press RETURN
36687 when done.  Press ^C to cancel editing and leave the address as it was.
36688 ========== h_dir_comp_search ===============
36689 Type a string to look for just like you would in the composer. Your configured
36690 rules for the servers with the implicit flag set will be used.
36691 ========== h_oe_searchab ===============
36692 Type the word or name you want to search for and press RETURN.  If you press
36693 RETURN without entering anything the word in [] will be searched for.
36694 ========== h_oe_chooseabook ==========
36695 Choose the address book you want to save the new entry in.
36696 Use ^N or ^P to change address books.  ^C to cancel.
36697 ========== h_oe_takeaddr ==========
36698 Edit the e-mail address using the arrow and delete keys.  Press RETURN
36699 when done.  Press ^C to cancel adding this entry to the address book.
36700 ========== h_oe_take_replace ==========
36701 Press R to replace the old entry with this new data.  You will still have
36702 another chance to cancel.  N to enter another nickname.  ^C to cancel now.
36703 ========== h_oe_take_replace_or_add ==========
36704 Press R to replace the old entry.  Press A to add the selected addresses to
36705 the old existing list.  N to enter another nickname. ^C to cancel now.
36706 ========== h_oe_takename ==========
36707 Edit the full name to be correct using the arrow and delete keys.  Press RETURN
36708 when done.  Press ^C to cancel adding this entry to the address book.
36709 ========== h_oe_takenick ==========
36710 Type a nickname (short easy-to-remember name, initials or single word) for this
36711 entry in the address book and press RETURN.  Press ^C to cancel addition.
36712 ========== h_oe_jump ==========
36713 Type the message number you want to jump to and press RETURN.  The word "end"
36714 represents the last message. Press ^C to cancel jumping to another message.
36715 ========== h_oe_jump_thd ==========
36716 Type the thread number you want to jump to and press RETURN.  The word "end"
36717 represents the last thread. Press ^C to cancel jumping to another thread.
36718 ========== h_oe_debuglevel ==========
36719 Higher number shows more debugging details.
36720 Press ^C if you want to cancel the change.
36721 ========== h_oe_broach ==========
36722 Type the name of the folder you want to open and press RETURN.  Press ^P/^N
36723 to go to the previous/next collections in the list.  Press ^C to cancel goto.
36724 ========== h_oe_foldsearch ==========
36725 Type the text you want to search for in foldernames and press RETURN.  If you
36726 press RETURN without entering anything, any text in [] will be searched for.
36727 ========== h_oe_foldrename ==========
36728 Change the old name of the folder to the new name using the arrow and
36729 delete keys and press RETURN.  Press ^C to cancel rename.
36730 ========== h_oe_login ==========
36731 Enter your login name for the host you are opening the mailbox on.  Just press
36732 RETURN to use your login from this host as is, or edit it with delete key.
36733 ========== h_oe_passwd ==========
36734 Type your password for the host and login shown as part of the prompt.
36735 Press ^C to cancel opening folder.
36736 ========== h_oe_choosep ==========
36737 Enter the number associated with the printer you want to select.  Press ^C to
36738 cancel the printer selection.  The current selection is highlighted.
36739 ========== h_oe_customp ==========
36740 Type the name of the Unix print command and press RETURN.  Press ^C to
36741 cancel the printer selection.
36742 ========== h_oe_searchview ==========
36743 Type the word or name you want to search for and press RETURN.  If you press
36744 RETURN without entering anything the word in [] will be searched for.
36745 ========== h_oe_keylock ==========
36746 The keyboard is in use and locked by another user.  Only that user can
36747 unlock this keyboard by typing the password.
36748 ========== h_wt_expire ==========
36749 At the beginning of each month Alpine offers to rename your current sent-mail
36750 folder to one named for the month so you have a sent-mail folder for each month
36751 ========== h_wt_delete_old ==========
36752 It is the beginning of the month, and we need to conserve disk
36753 space.  Please delete any sent-mail that you do not need.
36754 ========== h_select_sort ==========
36755 Select the order for sorting the index by typing the capitalized letter.
36756 Arrival is by arrival in your mailbox; Date is by time/day message was sent.
36757 ========== h_no_F_arg ============
36758 Enter name of file to be opened.
36759
36760 ========== h_sticky_personal_name ==========
36761 Type in your name as you want it to appear on outgoing email.  This entry
36762 will be saved into your Alpine configuration file.
36763 ========== h_sticky_inbox ============
36764 INBOX syntax is usually {complete.machine.name}INBOX
36765 This entry will be saved in your Alpine configuration file.
36766 ========== h_sticky_smtp ============
36767 The name of the computer on your campus that relays your outgoing email
36768 to the Internet.  This entry will be saved in your Alpine configuration file.
36769 ========== h_sticky_user_id ==========
36770 The username or login-id part of your email address.  This entry will be
36771 saved in your Alpine configuration file.
36772 ========== h_sticky_domain ==========
36773 The domain part of your email address, NOT the name of your PC.  This
36774 entry will be saved in your Alpine configuration file.
36775 ========== h_bounce =========
36776 Enter the address or nickname of the intended recipient.  Alpine will resend
36777 the message, which will retain the original author's From: address.
36778 ========== h_incoming_add_folder_nickname =========
36779 Enter an (optional) nickname that will be used in lieu of the actual
36780 host and folder names in the FOLDER LIST display.
36781 ========== h_anon_forward ==========
36782 Enter the address of your intended recipient, or ^C to cancel.
36783 Example: jsmith@somewhere.edu
36784 ========== h_news_subscribe ==========
36785 Enter the name of the newsgroup to which you wish to subscribe,
36786 or ^C to cancel.  Example: comp.mail.pine
36787 ========== h_pipe_msg ==========
36788 Enter the name of the Unix command to which you wish to send this
36789 message, or ^C to cancel.
36790 ========== h_pipe_attach ==========
36791 Enter the name of the Unix command to which you wish to send this
36792 attachment, or ^C to cancel.
36793 ========== h_select_by_num ==========
36794 Enter a list of message numbers (or number ranges), or ^C to cancel. "end"
36795 is the last message. "." is the current message. Example: 1-.,7-9,11,19,35-end
36796 ========== h_select_by_thrdnum ==========
36797 Enter a list of message numbers (or number ranges), or ^C to cancel. "end"
36798 is the last message. "." is the current message. Example: 1-.,7-9,11,19,35-end
36799 ========== h_select_txt_from ==========
36800 Messages with From: headers containing the entered string will be selected.
36801 ^C to cancel. ^G again to see original options.
36802 ========== h_select_txt_not_from ==========
36803 Messages without From: headers containing the entered string will be selected.
36804 ^C to cancel. ^G again to see original options.
36805 ========== h_select_txt_to ==========
36806 Messages with To: headers containing the entered string will be selected.
36807 ^C to cancel. ^G again to see original options.
36808 ========== h_select_txt_not_to ==========
36809 Messages without To: headers containing the entered string will be selected.
36810 ^C to cancel. ^G again to see original options.
36811 ========== h_select_txt_cc ==========
36812 Messages with Cc: headers containing the entered string will be selected.
36813 ^C to cancel. ^G again to see original options.
36814 ========== h_select_txt_not_cc ==========
36815 Messages without Cc: headers containing the entered string will be selected.
36816 ^C to cancel. ^G again to see original options.
36817 ========== h_select_txt_subj ==========
36818 Messages with Subject: headers containing the entered string will be selected.
36819 ^C to cancel.  ^X enters Subject: line of current message.
36820 ========== h_select_txt_not_subj ==========
36821 Messages without Subject headers containing the entered string will be selected.
36822 ^C to cancel.  ^X enters Subject: line of current message.
36823 ========== h_select_txt_all ==========
36824 All messages containing the entered string will be selected.  Headers and body,
36825 but not encoded attachments, will be compared.  Enter ^C to cancel.
36826 ========== h_select_txt_not_all ==========
36827 All messages that don't contain the entered string will be selected.  Headers
36828 and body, but not encoded attachments, will be compared.  Enter ^C to cancel.
36829 ========== h_select_txt_body ==========
36830 All messages containing the entered string will be selected. Body text, but
36831 not headers or encoded attachments, will be compared. ^C to cancel.
36832 ========== h_select_txt_not_body ==========
36833 All messages that don't contain the entered string will be selected. Body
36834 text, but not headers or encoded attachments, will be compared. ^C to cancel.
36835 ========== h_select_txt_recip ==========
36836 Messages with Cc: or To: headers containing the entered string will be selected.
36837 ^C to cancel. ^G again to see original options.
36838 ========== h_select_txt_not_recip ==========
36839 Messages without Cc: or To: headers containing the string will be selected.
36840 ^C to cancel. ^G again to see original options.
36841 ========== h_select_txt_partic ==========
36842 Messages with Cc, To, or From headers containing the string will be selected.
36843 ^C to cancel. ^G again to see original options.
36844 ========== h_select_txt_not_partic ==========
36845 Messages without Cc, To, or From headers containing the string will be selected.
36846 ^C to cancel. ^G again to see original options.
36847 ========== h_select_date ==========
36848 If typed, date may be in DD-MMM-YYYY format (04-Jul-2006) or in ISO format
36849 (2006-07-04). ^P/^N also changes default date. ^X enters date of current msg.
36850 ========== h_attach_index_whereis ==========
36851 Enter some text that appears in the Attachment Index entry for the desired
36852 attachment.  The first attachment containing that text will be highlighted.
36853 ========== h_kb_lock ==========
36854 Keystrokes entered here (up to a RETURN) comprise a password that must
36855 be entered again later in order to unlock the keyboard.
36856 ========== h_compose_default ==========
36857 N, compose a new message. R, set a role.
36858 ^C to cancel.
36859 ========== h_untranslatable ==========
36860 Send using UTF-8 character set; Send but replace untranslatable characters
36861 with question marks; return to the composer; or cancel message altogether.
36862 ========== h_compose_intrptd ==========
36863 N, compose a new msg. I, continue interrupted msg. R, set a role.
36864 ^C to cancel.
36865 ========== h_compose_postponed ==========
36866 N, compose a new message. P, continue postponed msg. R, set a role.
36867 ^C to cancel.
36868 ========== h_compose_intrptd_postponed ==========
36869 N, compose a new msg. I, continue interrupted msg. P, continue postponed msg.
36870 R, set a role. ^C to cancel.
36871 ========== h_compose_form ==========
36872 N, compose a new message. F, use form letter. R, set a role.
36873 ^C to cancel.
36874 ========== h_compose_intrptd_form ==========
36875 N, compose a new msg. I, continue interrupted msg. F, use form letter.
36876 R, set a role. ^C to cancel.
36877 ========== h_compose_postponed_form ==========
36878 N, compose a new message. P, continue postponed msg. F, use form letter.
36879 R, set a role. ^C to cancel.
36880 ========== h_compose_intrptd_postponed_form ==========
36881 N, compose a new msg. I, continue interrupted msg. P, continue postponed msg.
36882 F, use form letter. R, set a role. ^C to cancel.
36883 ========== h_config_context_del_except ==========
36884 If you delete the last exceptional collection you can only add it back by
36885 manually editing the exceptions config file.
36886 ========== h_config_whereis ==========
36887 To move quickly to a particular line, enter a search string or
36888 ^C to cancel.
36889 ========== h_config_edit_scorei ==========
36890 Enter interval in the form (min,max). -INF and INF may be used to represent
36891 -infinity and infinity. ^C to cancel change. RETURN to accept change.
36892 ========== h_config_add ==========
36893 Enter desired value; use normal editing keys to modify (e.g. ^K, ^D).  Just
36894 pressing RETURN sets the Empty Value (this turns off any global default).
36895 ========== h_config_add_custom_color ==========
36896 Enter a header fieldname. For example, "subject" or "from".
36897
36898 ========== h_config_add_pat_hdr ==========
36899 Enter a header fieldname. For example, "reply-to" or "organization" or
36900 any fieldname you want that isn't included already.
36901 ========== h_config_print_opt_choice ==========
36902 You may edit either the initialization string (characters printed before
36903 printing starts) or the trailer string.  Choose one or ^C to cancel.
36904 ========== h_config_print_init ==========
36905 Enter a C-style string for this.  You may use common backslash escapes like
36906 \\n for newline, \\ooo for octal character, and \\xhh for hex character.
36907 ========== h_config_change ==========
36908 Edit the existing value using arrow keys, ^K to delete entire entry, ^D to
36909 delete current (highlighted) character, etc.  Enter ^C to cancel change.
36910 ========== h_config_replace_add ==========
36911 Replace ignores the current default, Add places the current default in your
36912 editing buffer as if you had typed it in.
36913 ========== h_config_insert_after ==========
36914 Enter a nickname for this print command.  (InsertBefore puts the new item
36915 before the current line, InsertAfter puts it after the current line.)
36916 ========== h_config_print_cmd ==========
36917 Enter command to be executed for the printer.  Use normal editing keys
36918 to modify, ^C to cancel, carriage return to accept current value.
36919 ========== h_config_role_del ==========
36920 Answering Yes will remove this rule completely from your rules list.
36921 ========== h_config_role_addfile ==========
36922 Type the name of a file to add to your configuration. You don't need to
36923 use a file, you may add rules directly (with Add) without using a file.
36924 ========== h_config_role_delfile ==========
36925 Answering Yes will remove this rule file completely from your rules list.
36926 The rules data file itself will not be removed.
36927 ========== h_config_print_del ==========
36928 Answering Yes will remove this printer completely from your printer list.
36929 ========== h_config_print_name_cmd ==========
36930 You may edit the Nickname of this printer, the Command to be executed when
36931 printing, or change the Options associated with this printer.
36932 ========== h_send_check_fcc ==========
36933 Yes, send message without an Fcc.
36934 No, return to composer.
36935 ========== h_send_check_subj ==========
36936 Yes, send message without a Subject.
36937 No, return to composer.
36938 ========== h_send_check_to_cc ==========
36939 Yes, send message without a To address, or a Cc address, or a Newsgroup.
36940 No, return to composer.
36941 ========== h_send_fcc_only ==========
36942 Yes, copy message to Fcc only and send to NO recipients.
36943 No, return to composer.
36944 ========== h_send_prompt ==========
36945 Yes, send the message.
36946 No or ^C, return to composer.
36947 ========== h_send_prompt_flowed ==========
36948 Yes, send the message.  No or ^C, return to composer.
36949 What's Flowed? See Do Not Send Flowed Text in config screen.
36950 ========== h_send_prompt_dsn ==========
36951 Yes, send the message.  No or ^C, return to composer.
36952 What's DSNOpts? See Enable Delivery Status Notification in config screen.
36953 ========== h_send_prompt_dsn_flowed ==========
36954 Yes, send the message.  No or ^C, return to composer. What's DSNOpts? See
36955 Enable Delivery Status Notification. What's Flowed? See Do Not Send Flowed Text.
36956 ========== h_role_confirm ==========
36957 Yes, use displayed role. No, compose without a role.
36958 ^C, cancel the message. ^T, select a role from your other eligible roles.
36959 ========== h_norole_confirm ==========
36960 Return, compose without a role.
36961 ^C, cancel the message. ^T, select a role from your eligible roles.
36962 ========== h_custom_print ==========
36963 Enter a Unix command that accepts its data on standard input.
36964 Alpine will display any information the command sends to standard output.
36965 ========== h_convert_abooks_and_sigs ==========
36966 You will be given the opportunity to convert address books and signature files
36967 to remote configurations.
36968 ========== h_convert_abooks ==========
36969 You will be given the opportunity to convert address books to remote
36970 configurations.
36971 ========== h_flag_keyword ==========
36972 Enter the name of the keyword you want to add for this folder.
36973 No spaces, parentheses, braces, percents or asterisks are allowed.
36974 ========== h_select_keyword ==========
36975 Enter the keyword you want to match, or use ^T to select a keyword from a list
36976 of possible keywords for this folder. Use ! to look for non-matches instead.
36977 ========== h_type_keyword ==========
36978 Enter the keyword you want to add. You may add a nickname in the next step.
36979 No spaces, parentheses, braces, percents or asterisks are allowed.
36980 ========== h_type_keyword_nickname ==========
36981 Enter an optional nickname for the keyword you want to add.
36982 Type Carriage return to use the keyword name instead of a nickname.
36983 ========== h_convert_sigs ==========
36984 You will be given the opportunity to convert signature files to remote
36985 configurations.
36986 ========== h_convert_abook ==========
36987 Yes is fairly safe. You will be ADDing a remote address book that is a copy
36988 of the current address book. The current abook won't be removed automatically.
36989 ========== h_convert_sig ==========
36990 Answering Yes copies the contents of the signature file into your Alpine
36991 configuration file. After that, the contents of the file will not be used.
36992 ========== h_save_addman ==========
36993 Enter the simple name of the folder you want to add. Carriage return to
36994 accept what you have typed so far. ^C to get back to SELECT FOLDER screen.
36995 ========== h_reopen_folder ==========
36996 Yes reopens the folder, as if you were starting over. This uncovers new mail.
36997 No leaves the folder index as it was without discovering new mail.
36998 ========== h_convert_pinerc_server ==========
36999 This is the name of the host (computer) where the remote Alpine configuration
37000 will be stored. This should be an IMAP server that you have permission to use.
37001 ========== h_convert_pinerc_folder ==========
37002 Enter the correct remote folder name. This folder is special and should
37003 contain only configuration data. It shouldn't contain other mail messages.
37004 ========== h_role_compose ==========
37005 Compose a New message, Reply to current message, Forward current message, or
37006 Bounce message. Then you will be asked to choose one of your Roles to be used.
37007 ========== h_role_aggregate ==========
37008 Compose a reply, or forward, or bounce the selected messages. Then you
37009 will be asked to choose one of your Roles to be used for this operation.
37010 ========== h_save_size_changed ==========
37011 The reported size of a message is not the same as the actual size. Answer Yes
37012 to continue and hope for the best or No to Cancel the entire Save.
37013 ========== h_select_by_larger_size ==========
37014 Enter a number or ^C to cancel. All messages greater than this many characters
37015 in size will be selected. Examples: 2176, 1.53K (1530), or 3M (3000000).
37016 ========== h_select_by_smaller_size ==========
37017 Enter a number or ^C to cancel. All messages less than this many characters
37018 in size will be selected. Examples: 2176, 1.53K (1530), or 3M (3000000).
37019 ========== h_preserve_field ==========
37020 Use 'p' to toggle between preserving or not preserving the original To:
37021 and Cc: fields of the message. Enter ^C to cancel message.