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-2016 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 194 2016-12-18 12:55:24
 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-2016 Eduardo Chappa
 160 <BR>Copyright 2006-2008 University of Washington
 161 </DIV>
 162
 163 <P>
 164 Alpine is an &quot;Alternatively Licensed Program for Internet
 165 News and Email&quot; produced until 2009 by the University of Washington.
 166 It is intended to be an easy-to-use program for
 167 sending, receiving, and filing Internet electronic mail messages and
 168 bulletin board (Netnews) messages.  Alpine is designed to run on a wide
 169 variety of Unix&reg; operating systems.  A version for Microsoft Windows&reg;
 170 is available as is a world wide web based version designed to run under the
 171 Apache web server.
 172
 173
 174 <H2>New in Alpine <!--#echo var="ALPINE_VERSION"--> (<!--#echo var="ALPINE_REVISION"-->)</H2>
 175
 176 Version <!--#echo var="ALPINE_VERSION"--> (<!--#echo var="ALPINE_REVISION"-->)
 177 addresses bugs found in previous releases and has a few additions as well.
 178
 179 <P>
 180 Additions include:
 181 <UL>
 182   <LI> PC-Alpine: New configuration option "Aspell Dictionaries" allows a
 183        user to choose the dictionary used to spell check, in case the user
 184        communicates in more than one language. Examples of values for the
 185        variable are "en_US" or "de_DE", etc. Only the first 10
 186        dictionaries are offered.
 187
 188   <LI> Unix-Alpine: Connect securely to a LDAP server on a secure port.
 189        Based on a contribution by Wang Kang.
 190
 191   <LI> Colors configured in Alpine are inherited in the composer.
 192
 193   <LI> When Alpine is compiled with password file and SMIME support
 194        the password file is encrypted using a private key/public
 195        certificate pair. If one such pair cannot be found, one will be
 196        created. <A HREF="h_password_file_support">Learn more</A>.
 197
 198   <LI> Alpine builds with any version of OpenSSL greater than or equal
 199        to 1.0.0c. This includes version 1.1.0. Alpine also builds with
 200        LibreSSL.
 201
 202   <LI> New SHORTSUBJECT, SHORTSUBJKEY and SHORTSUBJKEYINIT token for index
 203        format, which removes text in the SUBJECT between &quot;[&quot; and
 204        &quot;]&quot;.
 205
 206   <LI> Alpine will include attachments when forwarding some
 207        multipart/alternative messages for which it did not use to include
 208        attachments.
 209
 210   <LI> New configuration option
 211        <a href="h_config_alt_reply_menu"><!--#echo var="FEAT_alternate-reply-menu"--></a>
 212        which adds more ways to control features and variables when you
 213        start to reply to a message.
 214
 215   <LI> Added support for RFC 2971 - IMAP ID extension.
 216
 217   <LI> Add configuration <A href="h_config_ignore_size"><!--#echo var="FEAT_ignore-size-changes"--></A>
 218        that allows users to ignore errors in the computation of the size
 219        of a message from defective servers.
 220
 221   <LI> SMIME: Upgrade the default signature digest from sha1 to sha-256, since
 222        clients such as Thunderbird do not validate signatures that use sha1 digest.
 223
 224   <LI> Add the configuration variable "default-directories", which is called
 225        <A href="h_config_history"><!--#echo var="VAR_default-directories"--></A>
 226        variable saves a list of directories that are readily accessible
 227        for save or export of attachments. This makes it easier to save
 228        attachments in directories that are hard to navigate to, or that
 229        are accessed frequently.
 230
 231   <LI> When a filename is attached and its name is encoded, the save
 232        attachment command will offer to save the file in the encoded form.
 233        This might work for some users, but the save command will have a
 234        subcommand ^N to decode the file name and save the file with the
 235        decoded name.
 236
 237   <LI> The TAB key allows autocomplete in the Fcc field in the composer headers,
 238        as well as autocompletes automatically when only one possibility exists
 239        for the ^J attach command.
 240
 241   <LI> Ignore message from smtp server after a successful authentication
 242        challenge.
 243
 244   <LI> When a message is saved in the Form Letter folder, add the ability
 245        to save the role being used to compose such message so that settings
 246        such as the SMTP server set in the role can be used when sending
 247        such form message. Suggested and patched by Frank Doepper.
 248
 249   <LI> If SSLDIR is defined somehow, do not disable S/MIME if the
 250        SSLCERTSDIR is not found.
 251
 252   <LI> When Alpine sends an attachment, it will set the boundary attribute
 253        in lower case, as some SMTP servers, such as those of libero.it
 254        reject messages if the boundary attribute is in uppercase.
 255
 256   <LI> Add the ability to change the private key and certificates used
 257        to encrypt a password file in the SMIME setup configuration screen.
 258        <A HREF="h_config_smime_password_file_certificates">Learn more</A>
 259
 260   <LI> SMIME: The ctrl-E command that gives information on the certificate
 261        is only available for messages that have a signed or encrypted
 262        part.
 263
 264   <LI> SMIME: If a message contains a RFC822 attachment that is
 265        signed/decrypted add the ability to view its SMIME information.
 266
 267   <LI> SMIME: Certificate information in the S/MIME screen is available
 268        for certificates stored in a container.
 269
 270   <LI> SMIME: Offer the common name of the person, instead of the name of
 271        file containing the certificate, as the name to be displayed in the
 272        certificate management screen for certificate authorities.
 273        Suggested by Matthias Rieber.
 274
 275   <LI> SMIME: Management of several alternate name (SAN) certificates is
 276        improved. When importing a SAN certificate, also import a certificate
 277        for the filename, besides for the e-mail addresses in the
 278        certificate. Suggested by Matthias Rieber.
 279
 280   <LI> SMIME: add full year when displaying information about a certificate
 281        in the certificate management screen. Suggested by Matthias Rieber.
 282
 283   <LI> SMIME: sort certificates by some type of alphabetical order in the
 284        displayed name.
 285
 286   <LI> SMIME: Alpine will ask users if they wish to save S/MIME
 287        certificates included in signatures, when the option "Validate
 288        Using Certificate Store Only" is enabled. If the user does not wish
 289        to save it, validation will fail.
 290
 291   <LI> HTML: Add support for decoding entities in hexadecimal notation.
 292        Suggested by Tulip&aacute;nt Gergely.
 293
 294   <LI> The &quot;#&quot; command, when used as part of an aggregate
 295        operation will allow users to select the role used in either
 296        replying, forwarding or replying to the group of selected messages,
 297        Suggested by Hisashi T Fujinaka.
 298
 299   <LI> If the charset of a message can not be determined, use the value set
 300        in the <A HREF="h_config_unk_char_set"><!--#echo var="VAR_unknown-character-set"--></A> for its value.
 301
 302   <LI> Resizing setup screen will redraw screen.
 303
 304   <LI> Unix Alpine only. Experimental: If Alpine/Pico finds a UCS4 code
 305        in the width ambiguous zone, it will use other means to determine
 306        the width, such as call wcwidth.
 307
 308   <LI> Pico: Code reorganization in the search command to make it easier to
 309        add subcommands of the search command.
 310
 311   <LI> Pico: Search command can do a case sensitive match. Use the Ctrl-^
 312        subcommand of the search command to bring this choice into view.
 313
 314   <LI> Pico: Add the ability to search for strings in the beginning or end
 315        of a line. Use the Ctrl-^ subcommand of the search command to bring
 316        this choice into view.
 317
 318   <LI> For a multipart/alternative message, the Take Address command will
 319        work on the part that is being read.
 320
 321   <LI> When sending a message, allow for 512 characters of consecutive
 322        non-white space before folding the subject line.
 323
 324   <LI> Make sure titlebar (the line at the top of the screen) always
 325        contains the name of the folder/newsgroup that is open, if this
 326        fits in the title.
 327
 328   <LI> The feature <a href="h_config_scramble_message_id">FEATURE: <!--#echo var="FEAT_scramble-message-id"--></a>
 329        will also scramble the name, version and operative system in the message-id header.
 330        Based on a contribution by Dennis Davis, which is itself based on a contribution by
 331        Mark Hills.
 332
 333   <LI> Change in logic in imap_set_password function to make Alpine ask if
 334        a user wants to save a password before reading the password file.
 335
 336   <LI> When exporting all parts of a message, if two attachments have the same
 337        name, do not overwrite a file more than once, but instead add a counter
 338        number to the filename to make a new file that does not exist in the file
 339        system.
 340
 341   <LI> Add the Control-R subcommand to the save command for attachments.
 342        This subcommand toggles if the saving will be done in binary mode
 343        for text attachments. When a user saves an attachment using binary
 344        mode it will be saved as it was sent, otherwise the attachment will
 345        be transformed to UTF-8 for further transformation through internal
 346        and user defined filters for saving.
 347
 348   <LI> Add command line argument -smimedir, which allows to specify
 349        the default path for a directory that contains the public, private,
 350        and ca directories. This is useful in case a user has a backup of
 351        old certificates that cannot be installed in the ~/.alpine-smime
 352        dir.
 353
 354   <LI> Reimplementation of the code that allows the .pinerc file to be a
 355        symbolic link by Kyle George from tcpsoft.com to use realpath.
 356
 357   <LI> When saving an attachment, the "^T" command leads to a screen where the
 358        "A" command can be used to add a file. A directory can be added by
 359        pressing "^X" after the "A" command. Added after a suggestion by
 360        Stefan Goessling.
 361
 362   <LI> When saving an attachment, the ^Y and ^V commands allow a user to
 363        scroll through the history of directories used to save attachments,
 364        while preserving the given name of the file. Suggested by Peter
 365        Koellner.
 366
 367   <LI> SMIME: Turn off automatic signing and encrypting of a message when
 368        bouncing. Suggested after a discussion with Matthias Rieber.
 369
 370   <LI> When messages are selected, warn the user if a message that is not
 371        selected will be bounced, or if not all selected messages will be
 372        bounced. Suggested by Ulf-Dietrich Braumann.
 373
 374   <LI> The bounce command adds a subcommand to choose a role.
 375
 376   <LI> When selecting messages by number, the &quot;.&quot; character can
 377        be used to specify the message on which the cursor is on.
 378
 379   <LI> When Alpine opens an attachment, it sometimes changes the extension
 380        of the file that is being opened and replaces it by another for the
 381        same mime type. If Alpine finds that the extension of the file
 382        corresponds with the mime type, according to the mime-types file,
 383        then it will keep it, and no substitution will be made.
 384
 385   <LI> Set no restrictions on the length of encoded subjects, but encode
 386        words in length of no more than 75 characters.
 387 </UL>
 388
 389
 390 <P>
 391 Bugs that have been addressed include:
 392 <UL>
 393   <LI> SMIME: Crash when a certificate has an invalid date of validity. Also
 394        Alpine will use the function ASN1_TIME_print to determine the date
 395        of validity. Reported by Ben Stienstra.
 396
 397   <LI> SMIME: Crash when attempting to unlock the password file and an
 398        incorrect password is entered.
 399
 400   <LI> SMIME: Crash when checking the signature of a message that contains
 401        a RFC822 attached message. Reported by Holger Trapp and Bj&ouml;rn
 402        Krellner.
 403
 404   <LI> SMIME: Cancelling entering password to unlock key will not reprompt.
 405
 406   <LI> SMIME: fix a bug that did not allow users to transfer certificates to
 407        remote containers. Reported by Matthias Rieber.
 408
 409   <LI> SMIME: certificates included in messages were not being transferred
 410        to a remote container.
 411
 412   <LI> SMIME: Crash if public certificates are located in an inaccessible
 413        remote server and the private key is not available.
 414
 415   <LI> SMIME: Alpine does not remove temporary files created when adding a
 416        CA certificate to a container. Reported by Holger Trapp.
 417
 418   <LI> SMIME: When reading a local certificate, Alpine converts the name
 419        of the certificate to lowercase, which may make Alpine not be able
 420        to read such certificate. Reported by Dennis Davis.
 421
 422   <LI> SMIME: If the option "Remember S/MIME Passphrase" is disabled, then
 423        entering a password to read an encrypted message will make Alpine
 424        forget the key and not ask the password to unlock it again in case
 425        it is necessary to unlock it again. Reported by Ulf-Dietrich
 426        Braumann.
 427
 428   <LI> Alpine would use freed memory while trying to compute the color
 429        of the titlebar. This happened when trying to continue a postponed
 430        message.
 431
 432   <LI> Alpine failed to read an encrypted password file if too many
 433        passwords were saved in the password file.
 434
 435   <LI> When selecting messages while in Threaded Index Screen, some
 436        messages other than top of threads could appear in the index, making
 437        Alpine display messages &quot;out of the screen.&quot;
 438
 439   <LI> Work in progress: Avoid calling non-safe functions when Alpine
 440        receives a signal. See bug report
 441        <A HREF="https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=825772">here.</A>
 442
 443   <LI> Crash when attempting to read a message after a bounce command.
 444        In order to produce a crash one needed to use the ^T subcommand and
 445        do a search in a LDAP directory. The crash is produced by changes
 446        to the text in the title bar. Reported by Heinrich Mislik in the
 447        Alpine-info list.
 448
 449   <LI> HTML messages that contain UTF-8 may wrap at the wrong position,
 450        making Alpine not display the correct character at the position
 451        that wrapping is done. Reported by Wang Kang.
 452
 453   <LI> Pico: Searching for a string that is too long causes Pico to crash
 454        in the next search.
 455
 456   <LI> Fix vulnerability in regex library. This only affects those who use
 457        this library, such as the windows version of Alpine. See
 458        <A HREF="http://www.kb.cert.org/vuls/id/695940">http://www.kb.cert.org/vuls/id/695940</A>
 459        for more details.
 460
 461   <LI> Alpine would not set include and lib paths for OpenSSL if this was
 462        installed in /usr/local/ssl.
 463
 464   <LI> If the .pinerc file is a symbolic link, Alpine might not write its
 465        contents when saving its configuration.
 466
 467   <LI> The _INIT_ token does not skip over non-alphanumeric characters in
 468        the name. Reported by Andreas Fehr.
 469
 470   <LI> When opening an INBOX folder in a context different from the
 471        incoming folders collection, from the command line, Alpine would
 472        open the INBOX folder from the incoming folders collection.
 473
 474   <LI> Mismatch in size of UCS and CELL caused a corruption in the
 475        content of a pointer, which made the speller in PC-Alpine get the
 476        content of a word incorrectly.
 477
 478   <LI> Skip testing openssl compatibility version when cross-compilation
 479        is detected. Fix contributed by Antti Sepp&auml;l&auml;
 480
 481   <LI> Alpine fails to remove temporary files used during a display or sending
 482        filter. Fix contributed by Phil Brooke.
 483
 484   <LI> When the index is in zoomed state, adding new messages to the
 485        selection would not show those messages if those messages are on
 486        top of the current message in the top of the screen. Reported by
 487        Ulf-Dietrich Braumann. In addition, when the user scrolls through
 488        the index, this scroll smoothly, without jumping pages. Reported
 489        by Holger Trapp.
 490
 491   <LI> Crash when reviewing history of saving attachments.
 492
 493   <LI> Crash when canceling a goto command on a local collection that has
 494        not been expanded and attempting to expand such collection.
 495
 496   <LI> Crash in Pico when forwarding messages that contain a direction mark
 497        at the end of a line. Reported by James Mingo.
 498
 499   <LI> Solve compilation errors when Alpine is built with Visual Studio 2015.
 500 </UL>
 501
 502
 503 <P>
 504 Version 2.20 addresses bugs found in previous releases and has several
 505 additions as well.
 506
 507 <P>
 508 Additions include:
 509 <P>
 510
 511 <UL>
 512   <LI> Upgrade UW-IMAP to Panda IMAP from
 513        <A HREF="https://github.com/jonabbey/panda-imap">https://github.com/jonabbey/panda-imap</A>.
 514   <LI> S/MIME: Add screen to manage certificates.
 515   <LI> S/MIME: Signatures are validated using the user's certificates instead
 516        of the ones included in the message. Behavior can be disabled by
 517        disabling the option <A href="h_config_smime_use_cert_store">
 518         <!--#echo var="FEAT_smime-use-storey-only"--></A>, which is enabled
 519        by default.
 520   <LI> S/MIME: sign messages using intermediate certificates when needed
 521        and possible.
 522   <LI> S/MIME: validation of certificates for servers that modify signed
 523        content.
 524   <LI> S/MIME: signed and encrypted messages will be signed first and
 525        encrypted second, so that they can be decoded by other clients.
 526   <LI> S/MIME: add the sender certificate to the list of certificates in
 527        encrypted messages to make it possible for the sender to decrypt
 528        the message they sent.
 529   <LI> S/MIME: When transferring certificates to a local container, create
 530        container with default names PublicContainer, PrivateContainer and
 531        CAContainer, as appropriate for these files, unless the user has
 532        provided some other names.
 533   <LI> S/MIME: Forwarding a message will include the signed part as part
 534        of the text and not as a multipart message, just as the reply
 535        command does.
 536   <LI> HTML: Style tag in body of html message causes Alpine to not write
 537        its content until a new &lt;/style&gt;
 538   <LI> HTML: &lt;BR&gt;, &lt;BR /&gt;, and &lt;BR/&gt; are considered
 539        the same inline tag; the same is valid for the &lt;HR&gt; tag.
 540   <LI> Add support to selective expunge through a subcommand of the
 541        select-apply commands. Read more in the <A
 542        HREF="h_index_cmd_expunge">help</A> for the expunge command.
 543   <LI> Pico: New subcommand of the search command, allows to reverse the
 544        direction of search.
 545   <LI> Unix Alpine: If a password file is defined, and S/MIME is enabled,
 546        the key and certificate used to encrypt the password file are saved
 547        in the ~/.alpine-smime/.pwd directory, or in the directory specified
 548        by the -pwdcertdir command line option.
 549        <A HREF="h_password_file_support">Learn more</A>.
 550   <LI> Add /tls1, /tls1_1, /tls1_2 and /dtls1 to the definition of a
 551        server to use different ways to connect using ssl, for
 552        example {server.com/tls1} will attempt to connect to
 553        server.com at the ssl imap port (port 993) and establish a
 554        connection using TLSv1. These flags can be used in
 555        conjunction with the /ssl flag, the ssl flag is redundant.
 556        Conversely, however, the /ssl flag does not imply any of
 557        these flags; the /ssl flag means SSLv3 or, if not available,
 558        SSLv2 in the SSL port.
 559   <LI> Alpine does not attempt to automatically reopen a collection
 560        that was not opened due to cancellation by the user.
 561        Instead, the user must try to open it explicitly.
 562   <LI> Alpine searches for a certificate that matches an email address in
 563        all addresses in a certificate (instead of just the first
 564        one) but when it tries to unlock the certificate, it asks
 565        for the password for the first email address in that
 566        certificate.
 567   <LI> Style tag in body of html message causes Alpine to not write its content
 568        until a new &lt;/style&gt;
 569   <LI> Experimental: Write the content-type of a message in
 570        lowercase, as some non-compliant servers do not understand
 571        uppercase content-type, such as those of GMX.de.
 572   <LI> Experimental: Do not send the RSET command before attempting
 573        to send a message, as this causes a delay in some evily managed
 574        servers.
 575   <LI> Opening a folder updates recent count in maildrops (this
 576        already works for other types of folders)
 577   <LI> Automatically redraw screen after opening an attachment
 578        instead of simply clearing it.
 579   <LI> Pico: Justification works without need of a predefined quote
 580        string. This allows justification of blocks of text that are
 581        indented with spaces.
 582   <LI> Decode the name of attachment names, so they can be written as part
 583        of the description of the part.
 584   <LI> Check bounds and tie strings off to improve security. Contributed
 585        by James Jerkins.
 586   <LI> Replace tabs by spaces in From and Subject fields to control for
 587        size in screen of these fields. Change only in index screen display.
 588   <LI> Aggregate operations allows bouncing a list of messages using a role.
 589        Suggested by Ulf-Dietrich Braumann.
 590   <LI> Disable saving new passwords to the password file. Implemented
 591        by Louis Raphael from dpslabs.com. <A HREF="h_config_disable_password_file_saving">Learn more.</A>
 592   <LI> Makefile: Add $(LIBINTL) to the flags to link rpdump, rpload,
 593      alpined and alpineldap because MAC OSX 10.8 x86_64 needs it. Reported by
 594      Charles M. Register.
 595 </UL>
 596
 597
 598 <P>
 599 Bugs that have been addressed include:
 600 <UL>
 601   <LI> Fix _INIT_ token for reply quote string to include support for 8-bit
 602        in personal names. Reported by Lev Gorenstein.
 603   <LI> When writing the .pinerc file, lines were truncated if they were longer
 604        than 10,000 characters. This could cause data corruption, so now lines
 605        are allowed to be of any length.
 606   <LI> In Unix Alpine (but not in MAC OSX) fix a problem that made Alpine
 607        remove attachments before they were open by a mailcap viewer. It
 608        requires that the user has an equivalent to a command such as "ps
 609        auxww" to list the list of processes, and check if there is any
 610        program using the attachment. The default is "/bin/ps auxww", but
 611        it can be changed at compile time with the option --with-ps-cmd.
 612        See the help of the variable
 613        <a href="h_config_psleep"><!--#echo var="VAR_mailcap-check-interval"--></a>
 614        for more information.
 615   <LI> S/MIME: signed messages that contained an attachment would not validate.
 616   <LI> S/MIME: signed and encrypted messages from Thunderbird would not
 617        validate. Thanks to Andreas Schamanek for testing, debugging and
 618        advising during the process of fixing this problem.
 619   <LI> S/MIME: Forwarding messages with multipart content-type failed to be signed
 620        with &quot;Error writing pipe&quot; message. Reported by Andreas Schamanek
 621        and Stefan Mueller.
 622   <LI> S/MIME: Certificates are lost when using a pinerc file outside of the
 623        home directory.
 624   <LI> S/MIME: Accessing the S/MIME configuration screen would deinitialize
 625        SMIME making it not possible to sign or encrypt messages.
 626   <LI> S/MIME: Forwarding a signed message might make the body contain mime
 627        information that is not part of the body, and hence making the body
 628        of the message seem wrong.
 629   <LI> S/MIME Alpine would compute incorrectly the signature of a message
 630        that contains 8bit if the option "Enable 8bit ESMTP Negotiation" is
 631        enabled, the message contains 8bit characters and the smtp server
 632        supports 8bit sending.
 633   <LI> When replying to several messages, subject will be decoded first,
 634        and then stripped from re/fwd before they are compared to determine
 635        the subject of the replied message.
 636   <LI> Crash when tcp connection to NNTP server was lost after connection
 637        had been established, but lost immediately afterwards.
 638   <LI> Crash with message &quot;lock when already locked&quot;, when painting
 639        an index was based on scores that needed information from a remote
 640        addressbook in the same server as the folder opened. Reported by
 641        Peter Koellner.
 642   <LI> Crash in message/rfc822 attachments encoded in base64.
 643   <LI> Postponed messages whose content-type is text/html, text/enriched and
 644        text/richtext are sent with that content-type, even though, after
 645        resuming composition, Alpine had changed its type to text/plain.
 646   <LI> Alpine cannot handle correctly some characters in the Windows-1256
 647        character set, which might lead to a crash or a corruption in the
 648        screen. Work was done to contain the bug. A more complete fix will
 649        be done in a future release. Reported by Professor Robert Funnell.
 650   <LI> WebAlpine: add _GNU_SOURCE to make pubcookie build.
 651   <LI> WebAlpine: fail to build with debug disabled. Fix from Sam Hathaway.
 652   <LI> Save command did not warn of existence of a message with a deleted
 653        attachment in an aggregate save, unless cursor was positioned on a message
 654        with a deleted attachment. Reported by Florian Herzig.
 655   <LI> Transformation of UTF-8 to MUTF7 was not being done when creating a folder
 656        in an IMAP server.
 657   <LI> DATE tokens were not internally transformed to UTF-8, which made their
 658        values not appear complete in the screen. Reported by Werner Scheinast.
 659   <LI> Fixes to configure script so that it will not require PAM for every system.
 660   <LI> Fix to configure script so that it will use CPPFLAGS instead of
 661        CPPCFLAGS, and so the --with-ssl-include-dir option take effect
 662        during the build. Fix by Ulf-Dietrich Braumann.
 663   <LI> Fix in WebAlpine: do not use deprecated dereference in pointer,
 664        needs to use tcl_getstringresult() instead. Reported by
 665        Ulf-Dietrich Braumann.
 666   <LI> Quoted string in URL Viewers configuration variable were not
 667        unquoted before passing to viewer.
 668   <LI> Fix in configure script to detect location of tcl library; add
 669        /usr/local in FreeBSD and fix a bug in configure script that used
 670        $alpine_TCLINC instead of $alpine_TCLINC/tcl.h. Reported and fixed
 671        by Werner Scheinast.
 672   <LI> Move SSL configurations from UW-IMAP to configure script, and
 673        update OpenSSL configuration for Mac OS X.
 674   <LI> Remove -lregex from linker flags when building --with-supplied-regex.
 675   <LI> When the download of an attachment is interrumpted, Alpine stills
 676      caches what was downloaded, making the download incomplete for
 677      subsequent calls of Alpine attempting to open the attachment. In the
 678      future, Alpine will not cache any downloaded part of the attachment
 679      when it is interrupted.
 680 </UL>
 681 <P>
 682
 683
 684 <P>
 685 Version 2.11 addresses bugs found in previous releases and has a few
 686 additions as well.
 687
 688 <P>
 689 Additions include:
 690 <P>
 691
 692 <UL>
 693    <LI> Alpine requires version 1.0.0c of Openssl to build.
 694    <LI> Increase encryption of S/MIME encrypted messages.
 695    <LI> Pico: Improvements in justification of paragraphs: lines that begin
 696 with a quote string, followed by a space were considered individual paragraphs,
 697 now they are considered part of a paragraph. Based on earlier joint work
 698 with Jeff Franklin.
 699    <LI> Unix Alpine: Allow local .pinerc file to be a symbolic link.
 700    <LI> Experimental extended support of recognition of UTF-8 in urls based on
 701 information from <A HREF="http://url.spec.whatwg.org">http://url.spec.whatwg.org</A>.
 702    <LI> Added recognition of ws and wss URIs.
 703    <LI> Add ability to <A HREF="h_config_folder_color">color folder names</A>,
 704  <A HREF="h_config_directory_color">directory names</A>,
 705  and <A HREF="h_config_folder_list_color">text</A> in the FOLDER SCREEN.
 706    <LI> Add the ability to <A HREF="h_config_indextoken_color">color any token</A>
 707 used in the display of the INDEX SCREEN.
 708    <LI> New option <A HREF="h_config_preserve_field"><!--#echo var="FEAT_preserve-original-fields"--></A>
 709 that adds the ability to preserve To: and Cc: fields when replying to a
 710 message, as specified by original sender.
 711    <LI> Add a _SILENT_ token to the <A HREF="h_config_display_filters">list of tokens</A>
 712  for a display filter, so that Alpine will not redraw the screen when it is unnecessary.
 713    <LI> Quota command includes subcommands for printing, forwarding, etc.
 714 </UL>
 715
 716 <P>
 717 Bugs that have been addressed include:
 718 <P>
 719 <UL>
 720   <LI> Crash when a non-compliant SMTP server closes a connection without a QUIT command.
 721   <LI> Crash when resizing the screen in a configuration screen.
 722   <LI> Do not bail out during a tcp timeout, instead close connection and avoid crash.
 723   <LI> Do not use a shell to open a browser.
 724   <LI> Configure script did not test for crypto or pam libraries.
 725   <LI> Configure script attempted to build web component, even if header file tcl.h was not present.
 726   <LI> Change Cygwin directory separator to &quot;/&quot;.
 727   <LI> Alpine could set List- headers, contrary to RFC 2369.
 728 </UL>
 729
 730 <P>
 731 Version 2.10 addresses bugs found in previous releases and has a few
 732 additions as well.
 733
 734 <P>
 735 Additions include:
 736 <P>
 737
 738 <UL>
 739    <LI> Quota report for IMAP folders that support it (press the &quot;@&quot; command in the index screen of such folder).
 740    <LI> Search a folder for the content of any header with the &quot;;&quot; command.
 741    <LI> Foreign characters are decoded correctly in IMAP folder names.
 742    <LI> Question about breaking connection to slow servers includes their name.
 743    <LI> Internal x-alpine-help: resource locator for sending links to internal help.
 744    <LI> OpenSuse: Alpine find location of OpenSSL certificates.
 745    <LI> Cygwin: Alpine builds without need of patch.
 746    <LI> Recognition of proper mime type for docx, xlsx, and pptx files.
 747    <LI> When composing a message, Alpine will create a new thread when the subject is erased.
 748    <LI> Add support for strong encryption of password file when S/MIME is built in.
 749 </UL>
 750
 751 <P>
 752 Bugs that have been addressed include:
 753 <P>
 754
 755 <UL>
 756    <LI> Alpine will close a folder after confirming with user their intention and not reopen it.
 757    <LI> Double allocation of memory in Pico.
 758    <LI> Alpine does not give warning of message sent and posted upon receipt by email of message posted in newsgroup.
 759    <LI> Handling of STYLE html parameter may make Alpine not display the content of a message.
 760    <LI> Not recognition of environment variables in some options.
 761    <LI> Not display of login prompt during initial keystrokes.
 762    <LI> justification of long urls breaks them.
 763    <LI> Incorrect New Mail message when envelope is not available.
 764    <LI> Incorrect display of PREFDATE, PREFDATETIME and PREFTIME tokens.
 765    <LI> Crash when resizing the screen after display of LDAP search.
 766    <LI> Crash when redrawing screen while opening a remote folder collection.
 767    <LI> Infinite loop in scrolltool function during notification of new mail.
 768    <LI> No repaint of the screen after midnight was done when the SMARTDATE token is used in the index screen.
 769    <LI> No display of signed and encrypted S/MIME messages.
 770    <LI> Alpine will not build with OpenSSL.
 771    <LI> Crash for double locking in calls to c-client.
 772    <LI> Bad recognition of mime-encoded text may make Alpine not print the subject of a message.
 773    <LI> Ignore the references header when threading messages
 774    <LI> No update of colors in index screen after update to addressbook.
 775 </UL>
 776
 777 <P>
 778 Version 2.01 addresses bugs found in previous releases and has a few
 779 additions as well.
 780
 781 <P>
 782 Additions include:
 783 <P>
 784
 785 <UL>
 786    <LI> Fixed non-ASCII web alpine handling
 787    <LI> Added web alpine help.
 788    <LI> Allow web alpine inbox on second IMAP server.
 789    <LI> Allow web alpine config reset after bad inbox-path gets set.
 790    <LI> Added web alpine ability to create group contact from contact list members.
 791    <LI> Backed out web alpine coercing of default sort-key of arrival to date/reverse.
 792    <LI> Tidied up web alpine script layout.
 793    <LI> Fixed web alpine status message ordering
 794    <LI> Added web alpine Fcc setting via Contacts in Compose
 795    <LI> Fixed web alpine autodraft attachment issues
 796    <LI> Fixed web alpine problems with recent count maintenance
 797    <LI> Fixed web alpine newmail arrival display in message list
 798    <LI> Added web alpine confirmation to folder create for Move/Copy
 799    <LI> Added web alpine user-domain support
 800    <LI> Fixed web alpine to support INBOX-within-a-collection deletion
 801 </UL>
 802
 803 <P>
 804 Bugs that have been addressed include:
 805 <P>
 806
 807 <UL>
 808    <LI> In web alpine fixed delete all selected within a search result to reorient
 809         correctly to whole-mailbox message list.
 810    <LI> Fixed web alpine delete in view page to be sensitive to sort
 811    <LI> Fixed web alpine open of folder within directory from folder manager page.
 812    <LI> Fixed web alpine open of folder within directory from left column's recent cache.
 813    <LI> Fixed web alpine problems with spaces in special folder names like Drafts
 814    <LI> Fixed web alpine adding contacts from message list and view
 815    <LI> Fixed web alpine create of non-existent fcc
 816    <LI> Remove mistakenly left debugger statement in web alpine javascript.
 817    <LI> Some UNIX alpine build problems fixed
 818    <LI> Crash in pico and pilot when nl_langinfo returned something unrecognizable
 819         or NULL. Add recognition of "646" to nl_langinfo wrapper. This is returned
 820         by locale charmap call on some Solaris 8 systems.
 821    <LI> MacOS Keychain logins were not working correctly with generic host names, like
 822         imap.gmail.com, as opposed to specific instances like rx-in-209.google.com, causing
 823         new password requests when not needed
 824    <LI> Possible crash in WhereIs command while in FOLDER LIST when cursor is located on the
 825         last folder in the list
 826    <LI> Change to S/MIME get_x509_subject_email so that X509v3 alternative names are
 827         looked for along with the email address
 828    <LI> Changes to configure to get spellcheck options with work with arguments.
 829    <LI> Add change from Mark Crispin of panda.com to at least minimally handle non-ascii hostname
 830         returned by gethostname (iPhone can do this)
 831    <LI> Fixed a bug that prevents a filter that moves a message into a local folder
 832         from also setting the DELETE flag in that moved message. Fix from Eduardo Chappa.
 833    <LI> Changed size of shellpath in open_system_pipe from 32 to MAXPATH. Fix from
 834         Jake Scott of marganstanley.com.
 835    <LI> Buffer overflow bug in c-client's tmail/dmail, fix from Mark Crispin. This
 836         is not used in alpine.
 837    <LI> Imapd server crash from unguarded fs_give in IDLE code, fix from Crispin.
 838         Apparently this causes RIM Blackberry BIS service problems. This is not
 839         used in alpine.
 840    <LI> Tmail uninitialized pointer fix from Neil Hoggarth. Not used in alpine.
 841    <LI> Buffer overflow possibility in RFC822BUFFER routines in c-client library.
 842         Fix from Ludwig Nussel of SUSE and from Crispin.
 843    <LI> Include whole filename in export filename history
 844    <LI> Fix display bug in pico when Replace command is canceled. Fix from Eduardo Chappa.
 845 </UL>
 846
 847 <P>
 848 Version 2.00
 849 addressed bugs found in previous releases and had a few additions as well.
 850 <P>
 851 Additions included:
 852 <P>
 853
 854 <UL>
 855    <LI> Redesigned Web Alpine interface
 856    <LI> Experimental <A HREF="h_mainhelp_smime">S/MIME support</A> added
 857         in UNIX versions of Alpine
 858    <LI> Attempt to include the attachment filename as part of the name of the
 859         temporary file used when viewing an attachment with an external program.
 860         Add some randomness to that filename to make it hard to predict the filename.
 861         Add a filename extension, usually derived from the type/subtype, to the
 862         temporary filename. This was previously done only on Windows and MacOS X.
 863    <LI> Enhance address completion in the composer (TAB command) so that it looks
 864         through nicknames, fullnames, and addresses from the address book; addresses
 865         from the message being viewed, if any; and the results from
 866         <A HREF="h_direct_config">LDAP Directory Server</A>
 867         lookups for all of the defined directory servers that have the
 868         <A HREF="h_config_ldap_opts_impl">&quot;Use-Implicitly-From-Composer&quot;</A>
 869         feature set.
 870    <LI> Make the default character set setting more liberal in what it will accept
 871         from the UNIX nl_langinfo call and the various values of LANG seen in the wild
 872    <LI> Remove the Alpine revision number from the titlebar in released versions
 873         while leaving it there in snapshot versions
 874    <LI> Add a <A HREF="h_config_quell_asterisks">feature</A> to suppress the
 875         display of asterisks when you type a password for Alpine
 876    <LI> Add line wrapping when displaying <EM>PRE</EM> formatted sections of HTML
 877    <LI> When the
 878         <A HREF="h_config_dates_to_local"><!--#echo var="FEAT_convert-dates-to-localtime"--></A>
 879         feature is turned on convert not only the dates in the index screen but also
 880         the dates in the MESSAGE VIEW
 881 </UL>
 882
 883 <P>
 884 Bugs addressed in the 2.00 release included:
 885 <P>
 886
 887 <UL>
 888    <LI> Crash when using tab-completion for selecting a Save filename
 889    <LI> Make Web Alpine help text images relative for more portability
 890    <LI> Fixed attach save of html parts in Web Alpine
 891    <LI> Viewing, printing, exporting, replying, and bouncing of message
 892         digests was broken. Replying and bouncing should not have been
 893         allowed at all for digests. It would be nice to have a more standard
 894         index-like view of a message digest but that has not been addressed
 895         with this minor bug fix.
 896    <LI> Adjust wrapping of HTML messages so that the margins specified by
 897         <A HREF="h_config_viewer_margin_left"><!--#echo var="VAR_viewer-margin-left"--></A> and
 898         <A HREF="h_config_viewer_margin_right"><!--#echo var="VAR_viewer-margin-right"--></A>
 899         are observed correctly
 900    <LI> Interrupt of WhereIs command in index was broken
 901    <LI> The <A HREF="h_config_unk_char_set"><!--#echo var="VAR_unknown-character-set"--></A>
 902         option did not work correctly interpreting unknown characters in message headers
 903    <LI> Long address lines could cause blank continuation lines
 904    <LI> Save to a local default INBOX failed if the primary collection was also local,
 905         which it is by default. The save went to  ~/mail/inbox instead.
 906    <LI> Make a default save folder of &quot;inbox&quot; always mean the real
 907         inbox, not the inbox in the primary collection
 908    <LI> Address book entries with lots of addresses would be truncated when
 909         entered in the composer with a screen size wider than 270 or so charcters
 910    <LI> Some fields in the index screen were truncated when the screen width was
 911         wider than 256 characters
 912    <LI> Crash when TABing to next folder, the next folder with new mail is a POP
 913         folder, and there is a more than 10 minute pause between typing the TAB
 914         and typing the Yes
 915 </UL>
 916
 917 <P>
 918 Version 1.10(962)
 919 addressed bugs found in previous releases and had a few additions as well.
 920 <P>
 921 Additions included:
 922 <P>
 923
 924 <UL>
 925    <LI> Add the possibility of setting a default role
 926         (see <A HREF="h_role_select">Roles Screen</A>)
 927         which may be convenient if your work flow involves acting in one
 928         role for a while then switching to another role and staying in the
 929         new role for another period of time
 930    <LI> When Saving and the IMAP server problem &quot;Message to save shrank!&quot;
 931         is encountered, ask the user if he or she wants to continue with the
 932         risky Save anyway instead of aborting. This may be helpful if your
 933         IMAP server is broken in this way but be aware that it is possible there
 934         was a real error instead of just a broken server implementation.
 935    <LI> Some configure adjustments for Kerberos detection and
 936         for SCO OpenServer 5 support
 937    <LI> Hide INBOX in a collection if it also appears as an
 938         <A HREF="h_config_enable_incoming">Incoming Folder</A>
 939    <LI> Show asterisks for feedback when the user is typing a password
 940    <LI> Performance improvement for threading of large folders
 941    <LI> Previously, the search used to find
 942         Pattern matches containing To patterns searched for both To
 943         and Resent-To headers. The relatively complicated search this
 944         produces causes problems when using some deficient IMAP servers.
 945         Now the default is to look only for To headers and ignore the
 946         presence of Resent-To. The previous behavior may be restored
 947         with the <A HREF="h_config_use_resentto"><!--#echo var="FEAT_use-resent-to-in-rules"--></A> feature.
 948    <LI> Add an
 949         <A HREF="h_config_unk_char_set"><!--#echo var="VAR_unknown-character-set"--></A>
 950         to help with reading malformed unlabeled messages
 951    <LI><A HREF="h_config_suppress_user_agent"><!--#echo var="FEAT_suppress-user-agent-when-sending"--></A> option added
 952    <LI> Map some Shift-LeftArrow escape sequences to LeftArrow
 953    <LI> Add feature <A HREF="h_config_warn_if_fcc_blank"><!--#echo var="FEAT_warn-if-blank-fcc"--></A>
 954 </UL>
 955
 956 <P>
 957 Bugs addressed in the 1.10(962) release included:
 958 <P>
 959
 960 <UL>
 961    <LI> Crash when encountering certain errors from an SMTP server
 962    <LI> Crash in composer caused by overflow in replace_pat()
 963    <LI> Hang when authenticating to an SMTP server that fails with a
 964         &quot;connection disconnected&quot; error
 965    <LI> Bug in handling of trailing tab character in flowed text
 966    <LI> Security enhancement for mailcap parameter substitution
 967    <LI> <A HREF="h_config_strip_sigdashes"><!--#echo var="FEAT_strip-from-sigdashes-on-reply"--></A>
 968         did not work if the message being replied to was not flowed text
 969         and <A HREF="h_config_quell_flowed_text"><!--#echo var="FEAT_quell-flowed-text"--></A>
 970         was not turned on
 971    <LI> Don't allow printer to be changed through hidden config screen
 972         if system administrator didn't want it to be allowed
 973    <LI> Attempts are sometimes made to set the Forwarded flag when alpine
 974         should know that it won't work, causing error messages to appear
 975    <LI> A <A HREF="h_config_reply_indent_string"><!--#echo var="VAR_reply-indent-string"--></A>
 976         of double-quote double-quote didn't work right
 977    <LI> Quoting wasn't being done to protect special characters from the
 978         MacOS X shell when
 979         <A HREF="h_config_browser"><!--#echo var="VAR_url-viewers"--></A>
 980         was not defined
 981    <LI> On MacOS X message attachments should be shown internally instead of
 982         being shown using the Mail application
 983    <LI> When replying to a message with a charset of X-UNKNOWN Alpine would
 984         sometimes set the outgoing charset to X-UNKNOWN, making the result
 985         unreadable
 986    <LI> When the sending of a message failed lines with leading spaces had one
 987         additional space inserted in each of those lines when the user
 988         was returned to the composer
 989    <LI> The <A HREF="h_index_cmd_whereis">WhereIs</A> command missed some index lines
 990         that contained non-ascii characters because it was truncating the
 991         line being searched so that it was shorter than what was visible on
 992         the screen
 993    <LI> When composing, an attachment with a long name that causes wrapping in
 994         just the wrong place would generate an error and cause the send
 995         of the attachment to fail
 996    <LI> After calling the file browser to attach a file in the composer, a resize
 997         of the window when back in the composer would redraw the last screen that
 998         had been shown in the browser instead of the current composer screen
 999    <LI> Possible crash in index screen when encountering unparseable addresses
1000         or when using one of the PRIORITY tokens or the HEADER token in the
1001         <a href="h_config_index_format"><!--#echo var="VAR_index-format"--></a>
1002    <LI> Problems with Header Color editing if the configuration option
1003         <a href="h_config_customhdr_color"><!--#echo var="VAR_viewer-hdr-colors"--></a>
1004         was inadvertently changed to the Empty Value in the hidden config screen
1005    <LI> When resuming the final postponed message from an Exchange server the user
1006         could get a certificate validation failure because alpine was trying
1007         to validate the canonical name of the folder instead of the name the
1008         user used
1009    <LI> Windows line endings in a mimetypes file on a Unix system cause a
1010         failure to find a match
1011    <LI> Make matching of extension names case independent in mimetypes files
1012    <LI> Windows dialog boxes for entering text were not working correctly
1013    <LI> Replying to or Forwarding multipart/alternative messages which had a
1014         single text/html part did not work well
1015    <LI> Printing the print confirmation page caused a crash
1016    <LI> A To line with a long, quoted personal name could display incorrectly
1017         if it was close to the same width as the screen
1018    <LI> When <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
1019         and <A HREF="h_config_incoming_checking_total"><!--#echo var="FEAT_incoming-checking-includes-total"--></A>
1020         are turned on hide (0/0) when the folder is empty
1021    <LI> Folder completion while Saving didn't work if the collection being
1022         saved to was the local home directory
1023 </UL>
1024
1025 <P>
1026 Version 1.00
1027 was an evolutionary release based on
1028 <A HREF="http://www.washington.edu/pine/">Pine</A>, which was also
1029 developed at the University of Washington.
1030 It is upwards-compatible for existing Pine users.
1031
1032 <P>
1033 Changes included:
1034 <P>
1035 <UL>
1036    <LI> Ground-up reorganization of source code around addition
1037         of "pith/" core routine library.
1038    <LI> Fundamental improvement in Alpine's internal text handling, which
1039         is now based exclusively on Unicode. This allows displaying incoming
1040         messages and producing outgoing messages in many different languages.
1041    <LI> Ground-up reorganization of build and install procedures
1042         based on GNU Build System's autotools. NOTE, the included IMAP library
1043         build is not based on autotools, so some features will not work. However,
1044         it should get built automatically during the Alpine build process.
1045    <LI> Web-based version included built on TCL designed to run under
1046         a suitable CGI-supporting web server such as Apache.
1047 </UL>
1048
1049 <P>
1050
1051 Details on changes in previous (prerelease) versions of Alpine
1052 may be found at the following URL:
1053 <P>
1054 <CENTER><SAMP><A HREF="http://patches.freeiz.com/alpine/release/">http://patches.freeiz.com/alpine/release/</A></SAMP></CENTER>
1055 <P>
1056
1057 <HR WIDTH="75%"><P>
1058
1059 <H2>Getting Help</H2>
1060 <DL>
1061 <DT>Online Help</DT>
1062 <DD>
1063 Every Alpine screen and command has associated help text
1064 accessible via the &quot;?&quot; key (or Ctrl-G in text-input contexts).
1065 </DD>
1066
1067 <DT>Web Help</DT>
1068 <DD>
1069 The most current source of information about Alpine,
1070 including new version availability, is the web page at
1071 <P>
1072 <CENTER><SAMP><A HREF="http://patches.freeiz.com/alpine/">http://patches.freeiz.com/alpine/</A></SAMP></CENTER>
1073 </DD>
1074 </DL>
1075
1076 Frequently Asked Questions (and answers) may be found at the following
1077 URL:
1078 <P>
1079 <CENTER><SAMP><A HREF="http://www.washington.edu/alpine/faq/">http://www.washington.edu/alpine/faq/</A></SAMP></CENTER>
1080 <P>
1081
1082 <HR WIDTH="75%"><P>
1083
1084 <H2>Additional Information</H2>
1085
1086 General Alpine configuration information can be found
1087 <A HREF="h_news_config">here</A>.
1088 <P>
1089 This is revision (<!--#echo var="ALPINE_REVISION"-->) of the Alpine software.
1090 Alpine mailbox and <A HREF="https://github.com/jonabbey/panda-imap/">IMAP</A> server
1091 access is provided by the IMAP Toolkit Environment (c-client library)
1092 version <!--#echo var="C_CLIENT_VERSION"-->.
1093 <P>
1094 Alpine was developed until 2009 by the Office of Computing
1095 &amp; Communications at the University of Washington in Seattle.
1096 Since then, the effort of developing Alpine has been continued by
1097 a community of volunteers who make good software even better!
1098
1099 <P>
1100 Alpine Copyright 2013-2016 Eduardo Chappa,
1101 <BR> Copyright 2006-2008 University of Washington.
1102
1103 <P>
1104 Additional legal notices can be found <A HREF="h_news_legal">here</A>,
1105 or instead you can find the Apache License, version 2.0 at the web URL:
1106
1107 <P>
1108 <CENTER><A HREF="http://www.apache.org/licenses/LICENSE-2.0">http://www.apache.org/licenses/LICENSE-2.0</A></CENTER>
1109
1110 <P>
1111 &lt;End of Release Notes&gt;
1112 </BODY>
1113 </HTML>
1114 ====== h_password_file_support ======
1115 <HTML>
1116 <HEAD>
1117 <TITLE>Encryption for Password File Support Explained</TITLE>
1118 </HEAD>
1119 <BODY>
1120 <H1>Encryption for Password File Support Explained</H1>
1121
1122 Index<BR>
1123 <OL>
1124 <LI><A HREF="#content">Explanation</A>
1125 <LI><A HREF="#example_existing_key">Example of Use of Existing Key and Certificate</A>
1126 <LI><A HREF="#example_self_signed">Example of Creating Master Password</A>
1127 </OL>
1128
1129 <P><A NAME="content">Unix Alpine Only.</A>
1130
1131 <P> If your version of Alpine has been built with password file support
1132 then you can use a special file to save your passwords, and avoid typing
1133 them every time you open a connection to a remote server.
1134
1135 <P> If, in addition, your version of Alpine was built with SMIME support, then your
1136 password file will be encrypted with a strong key. There are two ways in
1137 which this can happen: Alpine will either use a matching private key and
1138 public certificate pair that you already own, or it will create one for
1139 you, just for purposes of encrypting this file. We describe both processes
1140 below.
1141
1142 <P> Initially, Alpine will scan your public and private directories for a
1143 certificate/private key pair that works. Alpine will pick the first pair
1144 that it finds that matches.
1145
1146 <P> Once a pair has been chosen, it will be copied to the directory
1147 ~/.alpine-smime/.pwd, and from then on, Alpine will use the pair found in
1148 that directory. The first time this process is done, this directory will
1149 be created, a key/certificate pair will be copied to it, from then on
1150 this pair will be used to encrypt and decrypt your password file.
1151
1152 <P> If you want to use a specific key and certificate pair to encrypt
1153 your password file, you can create the directory ~/.alpine-smime/.pwd
1154 manually, and then create your preferred key/certificate pair there.
1155 Alpine will use this key regardless of if it has expired, or if it is
1156 self-signed. These issues do not affect the encryption or decryption
1157 of the password file.
1158
1159 <P> If you prefer not to use the directory ~/.alpine-smime/.pwd to save
1160 your key/certificate pair, you can specify a different one with the
1161 -pwdcertdir command line option in Alpine. If the directory specified by
1162 this option is not found Alpine will fail to encrypt and decrypt your
1163 password file. However if it exists, Alpine will search for a
1164 key/certificate pair in that
1165 directory, and if it does not find one, it will create one and save it
1166 in that directory.
1167
1168 <P> Alpine does not care about the names of the key and certificates in
1169 this directory, but the private key must have &quot;.key&quot; extension
1170 and your public certificate must have the &quot;.crt&quot; extension. The
1171 name of the private key will be used in the prompt when you are asked
1172 to unlock your key to decrypt your password.
1173
1174 <P> If Alpine cannot find a suitable private key and public certificate
1175 pair to encrypt your password, it will create one. You will be asked to
1176 create a &quot;Master Password&quot; to protect such key. At this moment
1177 there are no restrictions on passwords, other than they have to be at
1178 least 8 characters long, but future versions of Alpine will include
1179 functionality to restrict master passwords, as set up by the administrator
1180 of the system in the pine.conf.fixed file.
1181
1182 <P><A NAME="example_existing_key"><B>Example of Use of Existing Key and Certificate</B></A>
1183
1184 <P>Assume you have a private key called peter@address.com.key in your,
1185 ~/.alpine-smime/private directory, and a public certificate called
1186 peter@address.com.crt in your ~/.alpine-smime/public directory, and these
1187 are your only key/certificate pair.
1188
1189 <P> When Alpine starts for the first time, without command line options,
1190 it will check if the directory ~/.alpine-smime/.pwd exists, and if not,
1191 it will create it. Then it will go through your keys and certificates and
1192 find a pair that it can use, and copy the files peter@address.com.key,
1193 and peter@address.com.crt to the ~/.alpine-smime/.pwd directory. Alternatively
1194 you can do the same by copying these files by yourself. This can be done
1195 with the sequence of commands
1196
1197 <PRE>
1198 mkdir ~/.alpine-smime/.pwd
1199 cp ~/.alpine-smime/private/peter@address.com.key ~/.alpine-smime/.pwd
1200 cp ~/.alpine-smime/public/peter@address.com.crt ~/.alpine-smime/.pwd
1201 </PRE>
1202
1203 <P> When Alpine starts, you will be asked the password to unlock your
1204 private key with the prompt.
1205
1206 <PRE>
1207 Enter password of key &lt;peter@address.com&gt; to unlock password file:
1208 </PRE>
1209
1210 <P> If you prefer to use different names for your private and public keys
1211 in the ~/.alpine-smime/.pwd directory, you can do so, but you must
1212 preserve the extension of the files. For example, you can use the names
1213 private_key.key and public_cert.crt instead. In this case, the prompt you
1214 will see when you are asked to unlock your private key will read
1215
1216 <PRE>
1217 Enter password of key &lt;private_key&gt; to unlock password file:
1218 </PRE>
1219
1220 <P>Observe that you do not need to use an existing key/certificate pair,
1221 and that you can create a new private key/public certificate pair to
1222 encrypt and decrypt your password file. Alpine provides a mechanism to
1223 change the encryption key for this file in the S/MIME configuration
1224 screen.
1225
1226 <P><A NAME="example_self_signed"><B>Example of Creating Master Password</B></A>
1227
1228 <P> If Alpine cannot find a suitable private key and public certificate pair
1229 to encrypt your password file, it will create one. When doing so, it will
1230 start the process with the following warning:
1231
1232 <PRE>
1233 Creating a Master Password for your Password file.
1234 </PRE>
1235
1236 <P> Then Alpine will ask you to enter your Master Password:
1237
1238 <PRE>
1239 Create master password (attempt 1 of 3):
1240 </PRE>
1241
1242 <P> Once you enter this password, and it validates according to system policy,
1243 you will be asked to confirm this password.
1244
1245 <PRE>
1246 Confirm master password (attempt 1 of 3):
1247 </PRE>
1248
1249 <P> If you input the same password, then Alpine will set that as your
1250 Master Password, and you will use this password to unlock your key in the
1251 future.
1252
1253 <P> If you would like to switch your Master Password in the future, you can
1254 do so by creating a new public key and public certificate pair. You can do
1255 so in the S/MIME configuration screen, in the &quot;Manage Key and
1256 Certificate for Password File&quot; section, simply enter your current
1257 password to unlock your current key and then press &quot;C&quot; to create
1258 a new key.
1259
1260 <P>
1261 &lt;End of help&gt;
1262 </BODY>
1263 </HTML>
1264 ====== h_tls_failure_details ======
1265 <HTML>
1266 <HEAD>
1267 <TITLE>Certificate Validation Details</TITLE>
1268 </HEAD>
1269 <BODY>
1270 <H1>Certificate Validation Details</H1>
1271
1272 This screen gives details as to why the certificate validation failed: the
1273 name of the desired server system; the reason for failure; and the name on
1274 the certificate.  This is primarily of interest to experts.
1275
1276 <P>
1277 &lt;End of help&gt;
1278 </BODY>
1279 </HTML>
1280 ====== h_tls_failure ======
1281 <HTML>
1282 <HEAD>
1283 <TITLE>TLS or SSL Failure</TITLE>
1284 </HEAD>
1285 <BODY>
1286 <H1>TLS or SSL Failure</H1>
1287
1288 An attempt was made to establish a secure, encrypted connection to the
1289 server system using either Transport Layer Security (TLS) or the older
1290 Secure Sockets Layer (SSL).  This attempt failed.
1291
1292 <P>
1293 You should contact your server system management for more assistance.
1294 The problem is probably at the server system and not in Alpine or your local
1295 system.  The text in this screen may be helpful for the server system
1296 management in debugging the problem,
1297
1298 <P>
1299 &lt;End of help&gt;
1300 </BODY>
1301 </HTML>
1302 ====== h_tls_validation_failure ======
1303 <HTML>
1304 <HEAD>
1305 <TITLE>TLS and SSL Certificate Validation Failures</TITLE>
1306 </HEAD>
1307 <BODY>
1308 <H1>TLS and SSL Certificate Validation Failures</H1>
1309
1310 An attempt was made to establish a secure, encrypted connection to the
1311 server system using either Transport Layer Security (TLS) or the older
1312 Secure Sockets Layer (SSL).
1313
1314 <P>
1315 An important part of this procedure is server certificate validation.  A
1316 server certificate is an &quot;electronic identification card&quot; for the server
1317 system that is signed by a well-known certificate authority (CA).  Alpine
1318 compares the server system identity in the server certificate with the
1319 name of the server system to which it is trying to connect.  Alpine also
1320 verifies that the CA signature is authentic.
1321
1322 <P>
1323 Some common failure conditions are:
1324 <P>
1325
1326 <UL>
1327   <LI> [UNIX Alpine] Self signed certificate.  This means that the server system
1328 signed its own certificate.  This does not necessarily indicate anything
1329 bad; the server operators may simply have elected to not purchase a
1330 signed certificate from a certificate authority.
1331
1332   <LI> [UNIX Alpine] Unable to get local issuer certificate.  This means that
1333 the signature on the server system is from an unknown certificate authority.
1334 It can also mean that no certificate authority certificates have been
1335 installed on the local UNIX system.
1336
1337   <LI> [PC Alpine] Self-signed certificate or untrusted authority.  This is
1338 the same as either of the above two conditions in UNIX Alpine.  Note that
1339 Windows systems typically have a full set of certificate authority
1340 certificates installed, so it is more likely to be a self-signed
1341 certificate than an unknown certificate authority.
1342
1343   <LI> Server name does not match certificate.  This means that the server
1344 presented a proper signed certificate for a name other than the desired
1345 name.
1346 </UL>
1347
1348 <P>
1349 Any of these conditions can indicate that you are being attacked and have
1350 been directed to an imposter server that will record your password and
1351 your private mail messages.  It can also mean something innocuous.
1352
1353 <P>
1354 If you are certain that the problem is innocuous, you can append the
1355 option
1356
1357 <P>
1358 <CENTER><SAMP>/novalidate-cert</SAMP></CENTER>
1359 <P>
1360
1361 to the server system name where it appears in your configuration (e.g. the
1362 <A HREF="h_config_inbox_path"><!--#echo var="VAR_inbox-path"--></A>,
1363 a folder-collection, or a news or SMTP server).  This will
1364 disable certificate validation.  On the other hand, if you are attacked,
1365 you will get no warning if you do this.
1366
1367 <P>
1368 &lt;End of Cert Validation Failures help&gt;
1369 </BODY>
1370 </HTML>
1371 ====== h_release_tlscerts ======
1372 <HTML>
1373 <HEAD>
1374 <TITLE>TLS and SSL usage note</TITLE>
1375 </HEAD>
1376 <BODY>
1377 <H1>TLS and SSL usage note</H1>
1378
1379 <P>
1380 When using Alpine from Unix or Windows 2000,
1381 server certificates must be signed by a trusted certificate authority.
1382 You may relax this requirement (at the cost of some security) by using
1383 the
1384 <A HREF="h_folder_server_syntax">NoValidate-Cert</A>
1385 modifier in the mailbox name.
1386
1387 <P>
1388 <CENTER><SAMP>{foo.example.com/novalidate-cert}INBOX</SAMP></CENTER>
1389 <P>
1390
1391 The fully-qualified host name of the server should be used
1392 so that it matches the host name in the server certificate.
1393 <P>
1394 Here is an example of a host specification that directs Alpine to use
1395 the SSL port (993) and an encrypted data stream.
1396 <P>
1397 <CENTER><SAMP>{foo.example.com/ssl}INBOX</SAMP></CENTER>
1398 <P>
1399 &lt;End of TLS usage help&gt;
1400 </BODY>
1401 </HTML>
1402 ====== h_news_config ======
1403 <HTML>
1404 <HEAD>
1405 <TITLE>Alpine Configuration</TITLE>
1406 </HEAD>
1407 <BODY>
1408 <H1>Alpine Configuration</H1>
1409
1410 <H2>Using Environment Variables</H2>
1411
1412 The values of Alpine configuration options may include environment variables
1413 that are replaced by the value of the variable at the time Alpine is run
1414 (and also at the time the config option is changed).
1415 The syntax to use environment variables is a subset of the common Unix
1416 shell dollar-syntax.
1417 For example, if
1418
1419 <P><CENTER><SAMP>$VAR</SAMP></CENTER><P>
1420
1421 appears in the value of an Alpine configuration option it is looked up in the
1422 environent (using getenv(&quot;VAR&quot;)) and its
1423 looked-up value replaces the <SAMP>$VAR</SAMP> part of the option value.
1424 To include a literal dollar sign you may precede the dollar sign with another
1425 dollar sign.
1426 In other words, if the text
1427
1428 <P><CENTER><SAMP>$$text</SAMP></CENTER><P>
1429
1430 is the value of a configuration option, it will be expanded to
1431
1432 <P><CENTER><SAMP>$text</SAMP></CENTER><P>
1433
1434 and no environment lookup will be done.
1435 For Unix Alpine it will also work to use a backslash character to
1436 escape the special meaning of the dollar sign, but $$ is preferable since
1437 it works for both PC-Alpine and Unix Alpine, allowing the configuration option
1438 to be in a shared configuration file.
1439 <P>
1440
1441 This all sounds more complicated than it actually is.
1442 An example may make it clearer.
1443 Unfortunately, the way in which environment variables are set is OS-dependent
1444 and command shell-dependent.
1445 In some Unix command shells you may use
1446
1447 <P><CENTER><SAMP>PERSNAME="Fred Flintstone"</SAMP></CENTER><P>
1448    <CENTER><SAMP>export PERSNAME</SAMP></CENTER><P>
1449
1450 Now, if you use Alpine's Setup/Config screen to set
1451
1452 <P><CENTER><SAMP><!--#echo var="VAR_personal-name"-->=$PERSNAME</SAMP></CENTER><P>
1453
1454 the <SAMP>$PERSNAME</SAMP> would be replaced by <SAMP>Fred Flintstone</SAMP>
1455 so that this would be equivalent to
1456
1457 <P><CENTER><SAMP><!--#echo var="VAR_personal-name"-->=Fred Flintstone</SAMP></CENTER><P>
1458
1459 Note, environment variable substitution happens after configuration
1460 options that are lists are split into the separate elements of the list,
1461 so a single environment variable can't contain a list of values.
1462
1463 <P>
1464 The environment variable doesn't have to be the only thing
1465 after the equal sign.
1466 However, if the name of the variable is not at the end of the line or
1467 followed by a space (so that you can tell where the variable name ends),
1468 it must be enclosed in curly braces like
1469
1470 <P><CENTER><SAMP>${VAR}</SAMP></CENTER><P>
1471
1472 It is always ok to use the braces even if you don't need to.
1473 <P>
1474 It is also possible to set a default value for an environment variable.
1475 This default value will be used if the environment variable is not
1476 set (that is, if getenv(&quot;VAR&quot;) returns NULL).
1477 The syntax used to set a default value is
1478
1479 <P><CENTER><SAMP>${VAR:-default value}</SAMP></CENTER><P>
1480
1481 If the config file contains
1482
1483 <P><CENTER><SAMP>personal-name=${VAR:-Fred Flintstone}</SAMP></CENTER><P>
1484
1485 then when Alpine is run <SAMP>VAR</SAMP> will be looked up in the environment.
1486 If <SAMP>VAR</SAMP> is found then <SAMP>personal-name</SAMP> will have
1487 the value that <SAMP>VAR</SAMP> was set to, otherwise,
1488 <SAMP>personal-name</SAMP> will be set to <SAMP>Fred Flintstone</SAMP>,
1489 the default value.
1490 (Note that the variable is called &quot;personal-name&quot; in the config
1491 file but is displayed in the config screen as
1492 &quot;<!--#echo var="VAR_personal-name"-->&quot;.
1493 In general, the value that goes into a config file is never exactly the
1494 same as the value you see on the screen.)
1495
1496 <P>
1497 An example where an environment variable might be useful is the
1498 variable <SAMP>Inbox-Path</SAMP> in the global configuration file.
1499 Suppose most users used the server
1500
1501 <P><CENTER><SAMP>imapserver.example.com</SAMP></CENTER><P>
1502
1503 but that there were some exceptions who used
1504
1505 <P><CENTER><SAMP>altimapserver.example.com</SAMP></CENTER><P>
1506
1507 In this case, the system manager might include the following line in
1508 the systemwide default Alpine configuration file
1509
1510 <P><CENTER><SAMP>Inbox-Path=${IMAPSERVER:-imapserver.example.com}</SAMP></CENTER><P>
1511
1512 For the exceptional users adding
1513
1514 <P><CENTER><SAMP>IMAPSERVER=altimapserver.example.com</SAMP></CENTER><P>
1515
1516 to their environment should work.
1517 <P>
1518 Another example might be the case where a user has to use a different
1519 SMTP server from work and from home.
1520 The setup might be something as simple as
1521
1522 <P><CENTER><SAMP>smtp-server=$SMTP</SAMP></CENTER><P>
1523
1524 or perhaps a default value could be given.
1525 Note that, as mentioned above, the variable <SAMP>SMTP</SAMP> cannot contain
1526 a list of SMTP servers.
1527 <P>
1528
1529 <H2>Configuration precedence</H2>
1530
1531 There are several levels of Alpine configuration.  Configuration values at
1532 a given level override corresponding values at lower levels.  In order of
1533 increasing precedence:
1534 <P>
1535 <UL>
1536  <LI> built-in defaults
1537  <LI> system-wide
1538 <!--chtml if pinemode="os_windows"-->
1539       config file from command line or provided
1540       by "PINECONF" environment variable
1541 <!--chtml else-->
1542       pine.conf file
1543 <!--chtml endif-->
1544  <LI> personal configuration file
1545  <LI> personal exceptions configuration file
1546  <LI> command-line options
1547  <!--chtml if pinemode="os_windows"--><!--chtml else-->
1548  <LI> system-wide pine.conf.fixed file<!--chtml endif-->
1549 </UL>
1550 <P>
1551 The values in both the personal configuration file and the
1552 <A HREF="h_config_exceptions">exceptions</A>
1553 configuration file may be set using the Setup command.
1554 Setup/Config is the command to change most of the personal configuration
1555 options.
1556 The other Setup subcommands are also used to change the configuration,
1557 for example, Setup/AddressBook, Setup/Rules, and so on.
1558 Changing the personal exceptions configuration is very similar.
1559 To change a value in the Config screen you would use the command
1560 Setup/eXceptions/Config.
1561 Likewise for the other Setup subcommands (Setup/eXceptions/Rules and so on).
1562 <P>
1563 There are a couple exceptions to the rule that configuration values are replaced
1564 by the value of the same option in a higher-precedence file.
1565 The Feature-List variable has values that are additive, but can be
1566 negated by prepending &quot;no-&quot; in front of an individual feature name.
1567 So for features, each individual feature's value is replaced by the value
1568 of the same feature in a higher-precedence file.
1569 Note that this is done automatically for you when you change these values via
1570 the Setup/Config command.
1571 The other exception to the <EM>replace</EM> semantics happens when you
1572 use <A HREF="h_config_inheritance">configuration inheritance</A>
1573 for option lists.
1574 <P>
1575
1576 <H2>File name defaults</H2>
1577
1578 Notes:<P>
1579
1580 <BR> &lt;exe dir&gt; = directory where pine.exe found.
1581 <BR> &lt;pinerc dir&gt; = directory where pinerc found.
1582 <BR> # = default file name is overridable in pinerc.
1583 <BR> $HOME, if not explicitly set, defaults to root of the current drive.
1584 <BR> $MAILCAPS, if set, is used in lieu of the default mailcap search paths.
1585 <BR> + between the mailcap paths implies that the two files are combined.
1586 <BR> ; between other default paths implies that the first one found is used.
1587 </P>
1588 Alpine looks for most support files in the same directory it finds its
1589 personal configuration file (pinerc).  The -p command-line flag may be
1590 used to specify a particular path name for the pinerc file.  If a
1591 pinerc file does not exist, it will be created (if directory permissions
1592 allow).  In PC-Alpine, if -p or $PINERC are not defined, Alpine will look
1593 in $HOME&#92;PINE and the directory containing the PINE.EXE.  If a PINERC
1594 file does not exist in either one, it will create one in the first of those
1595 two directories that is writable.  In detail:
1596 <PRE>
1597
1598 PC-Alpine:
1599
1600  executable     &lt;DOS search path&gt;&#92;pine.exe
1601  help index     &lt;exe dir&gt;&#92;pine.ndx
1602  help text      &lt;exe dir&gt;&#92;pine.hlp
1603
1604  pers config    $PINERC  ;  $HOME&#92;pine&#92;PINERC  ;  &lt;exe dir&gt;&#92;PINERC
1605  except config  $PINERCEX ; $HOME&#92;pine&#92;PINERCEX  ;  &lt;exe dir&gt;&#92;PINERCEX
1606  global cfg     $PINECONF
1607
1608  debug          &lt;pinerc dir&gt;&#92;pinedebg.txtN
1609  crash          &lt;pinerc dir&gt;&#92;pinecrsh.txt
1610  signature#     &lt;pinerc dir&gt;&#92;pine.sig
1611  addressbook#   &lt;pinerc dir&gt;&#92;addrbook
1612  mailcap#       &lt;pinerc dir&gt;&#92;mailcap  +  &lt;exe dir&gt;&#92;mailcap
1613  mimetypes#     &lt;pinerc dir&gt;&#92;mimetype +  &lt;exe dir&gt;&#92;mimetype
1614  newsrc#        $HOME&#92;newsrc (if exists, else) &lt;pinerc dir&gt;&#92;newsrc
1615  sentmail#      $HOME&#92;mail&#92;sentmail.mtx
1616  postponed#     $HOME&#92;mail&#92;postpond.mtx
1617  interrupted    $HOME&#92;mail&#92;intruptd
1618
1619 Unix Alpine:
1620
1621  executable     &lt;Unix search path&gt;/pine
1622  persnl cfg     ~/.pinerc
1623  except cfg     ~/.pinercex
1624  global cfg     <!--#echo var="PINE_CONF_PATH"-->
1625  fixed cfg      <!--#echo var="PINE_CONF_FIXED_PATH"-->
1626  local help     <!--#echo var="PINE_INFO_PATH"-->
1627
1628  interrupted    ~/.pine-interrupted-mail
1629  debug          ~/.pine-debugN
1630  crash          ~/.pine-crash
1631  newsrc#        ~/.newsrc
1632  signature#     &lt;pinerc dir&gt;/.signature
1633  addressbook#   &lt;pinerc dir&gt;/.addressbook
1634  postponed#     ~/mail/postponed-msgs
1635  sentmail#      ~/mail/sent-mail
1636  mailcap#       ~/.mailcap + /etc/mailcap
1637                            + /usr/etc/mailcap + /usr/local/etc/mailcap
1638  mimetypes#     ~/.mime.types + /etc/mime.types + /usr/local/lib/mime.types
1639
1640  news-spool     varies across Unix flavors, e.g. /var/spool/news or /usr/spool/news
1641  active-news    varies across Unix flavors, e.g. /usr/lib/news/active
1642  lock files     /tmp/.<!--#echo var="MAIL_SPOOL_LOCK_PATH"-->
1643  inbox          <!--#echo var="MAIL_SPOOL_PATH"-->
1644  password       /etc/passwd
1645
1646 Unix Alpine and PC-Alpine:
1647
1648  .ab*           remote addressbook support files
1649  a[1-9]*        temporary (while Alpine is running) addressbook files
1650
1651 </PRE>
1652 <P>
1653
1654 <H2>Mailcap files</H2>
1655
1656 Alpine honors the mailcap configuration system for specifying external
1657 programs for handling attachments.  The mailcap file maps MIME attachment
1658 types to the external programs loaded on your system that can display
1659 and/or print the file.  A sample mailcap file comes bundled with the Alpine
1660 distribution.  It includes comments that explain the syntax you need to
1661 use for mailcap.  With the mailcap file, any program (mail readers,
1662 newsreaders, WWW clients) can use the same configuration for handling
1663 MIME-encoded data.
1664 <P>
1665
1666 <H2>MIME-Types files</H2>
1667
1668 Alpine uses mime-types files (.mime.types or MIMETYPE) to determine
1669 what Content-Type to use for labeling an attached file, based on
1670 the file extension.  That is, this file provides a mapping between
1671 filename extensions and MIME content-types.
1672 <P>
1673
1674 <H2>Environment variables</H2>
1675
1676 PC-Alpine uses the following environment variables:
1677 <DL>
1678 <DT>PINERC</DT>
1679 <DD>Optional path to pinerc file.</DD>
1680 <DT>PINERCEX</DT>
1681 <DD>Optional path to personal exceptions configuration file.</DD>
1682 <DT>PINECONF</DT>
1683 <DD>Optional path to global pine config file.</DD>
1684 <DT>HOME</DT>
1685 <DT>TMPDIR, TMP, or TEMP</DT>
1686 <DT>COMSPEC</DT>
1687 <DT>MAILCAPS</DT>
1688 <DD>A <B>semicolon</B> delimited list of path names to mailcap files.</DD>
1689 <DT>USER_DICTIONARY</DT>
1690 <DD>Used to specify the file to contain the user's spell check
1691 dictionary.  The default is <SAMP>DICT.U</SAMP> in the same
1692 directory as the <SAMP>SPELL32.DLL</SAMP></DD>
1693 </DL>
1694
1695 Unix Alpine uses the following environment variables:
1696 <DL>
1697 <DT>TERM</DT>
1698 <DD>Tells Alpine what kind of terminal is being used.</DD>
1699 <DT>DISPLAY</DT>
1700 <DD>Determines if Alpine will try to display IMAGE attachments.</DD>
1701 <DT>SHELL</DT>
1702 <DD>If not set, default is &quot;/bin/sh&quot;.</DD>
1703 <DT>TMPDIR, TMP, or TEMP</DT>
1704 <DT>MAILCAPS</DT>
1705 <DD>A <B>colon</B> delimited list of path names to mailcap files.</DD>
1706 </DL>
1707 <!--chtml if pinemode="os_windows"-->
1708 <P>
1709 <H2>Common PC-Alpine Configuration Problems</H2>
1710
1711 <H3>Configuration settings aren't being saved</H3>
1712
1713 <P>This problem can happen if you run pine from one directory and
1714 then decide to move your pine directory to another location.  PC-Alpine
1715 stores certain variables, including the configuration location, in the
1716 Windows Registry (which you shouldn't ever need to manually edit).  There
1717 are a couple of ways to go about removing or resetting the values in the
1718 registry.
1719
1720 <P>
1721 1) Run PC-Alpine's registry value deletion command.  This can be done by
1722 running: &quot;&lt;your&nbsp;pine&nbsp;directory&gt;&#92;pine.exe&nbsp;-registry&nbsp;clear&quot; from the DOS
1723 prompt. You could create a shortcut to pine.exe and change the &quot;Target&quot;
1724 value to the above command.
1725
1726 <P>
1727 2) Tell PC-Alpine where to look for the configuration file.  Configuration
1728 information is stored in a file called the PINERC.  With the &quot;-p&nbsp;PINERC&quot;
1729 option, you can tell PC-Alpine the location of your pinerc.  An example of
1730 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;.
1731 Again, you can use the DOS prompt or the shortcut method explained in (1).
1732
1733 <P>
1734 Additionally, there is the &quot;-registry&nbsp;set&quot; option, which will actively
1735 set registry values to the current setting, and is therefore useful with
1736 the &quot;-p&nbsp;PINERC&quot; option.
1737
1738 <!--chtml endif-->
1739 <P>
1740 &lt;End of Configuration Notes&gt;
1741 </BODY>
1742 </HTML>
1743 ====== h_news_legal ======
1744 <html>
1745 <head>
1746 <TITLE>Alpine Legal Notices</TITLE>
1747 </head>
1748 <body>
1749
1750 <H1>Alpine Legal Notices</H1>
1751
1752 Alpine and its constituent programs are covered by the Apache License Version 2.0.
1753
1754
1755 <P>
1756 &lt;End of Alpine Legal Notices&gt;
1757 </BODY>
1758 </HTML>
1759 ===== h_info_on_mbox =====
1760 <HTML>
1761 <HEAD>
1762 <TITLE>Information on mbox driver</TITLE>
1763 </HEAD>
1764 <BODY>
1765 <H1>Information on &quot;Missing Mail&quot; and the &quot;mbox&quot; driver</H1>
1766
1767 Beginning with Pine 4.00 (Pine came before Alpine)
1768 a new INBOX access method is
1769 available as part of the standard configuration.  It is called the
1770 &quot;mbox&quot; driver and it works like this:<P>
1771
1772 <P>
1773 <BLOCKQUOTE>
1774 If the file &quot;mbox&quot; exists in the user's home directory, and
1775 is in Unix mailbox format, then when INBOX is opened this file will be
1776 selected as INBOX instead of the mail spool file.  Messages will be
1777 automatically transferred from the mail spool file into the mbox
1778 file.
1779 </BLOCKQUOTE>
1780
1781 <P>
1782 The advantage of this method is that, after new mail has been copied
1783 from the system mail spool, all subsequent access is confined to the
1784 user's home directory, which is desirable on some systems.  However, a
1785 possible disadvantage is that mail tools other than those from the
1786 University of Washington will not know to look for mail in the user's
1787 mbox file.  For example, POP or IMAP servers other than those from the
1788 University of Washington, and many &quot;new mail notification&quot;
1789 programs may not work as expected with this driver enabled.<P>
1790
1791 To disable this behavior, either remove/rename the &quot;mbox&quot;
1792 file or find the <A HREF="h_config_disable_drivers"><!--#echo var="VAR_disable-these-drivers"--></A>
1793 option in Setup/Config
1794 and add &quot;mbox&quot; to it:
1795 <P>
1796 <CENTER><SAMP><!--#echo var="VAR_disable-these-drivers"-->=mbox</SAMP></CENTER>
1797 <P>
1798 &lt;End of help on this topic&gt;
1799 </BODY>
1800 </HTML>
1801 ===== h_info_on_locking =====
1802 <HTML>
1803 <HEAD>
1804 <TITLE>FAQs on Alpine Locking</TITLE>
1805 </HEAD>
1806 <BODY>
1807 <H1>What Systems Managers Need to Know about Alpine File Locking</H1>
1808
1809 There is an extensive section on locking in the Alpine technical notes;
1810 this information is intended to provide answers to some common questions:<P>
1811 <OL>
1812 <LI> Why did locking change in Pine 4.00?<BR>
1813 The actual locking mechanisms did not change in 4.00.
1814 What changed is that when one particular locking mechanism used by Alpine
1815 fails, Alpine now issues a warning message.  Prior to Pine 4.00, the locking
1816 failure would occur, but no warning was issued.<P>
1817
1818 <LI> Is this what the &quot;Mailbox vulnerable&quot; message is about?<BR>
1819 Yes.  It means that Alpine was unable to create a lockfile in the
1820 spool directory, generally because of overly restrictive protections on the
1821 spool directory.  The correct permissions on the spool directory for
1822 running Alpine are 1777, i.e. read-write-execute permission for everyone,
1823 with the sticky-bit set, so only owners of a file can delete them.<P>
1824
1825 <LI> Why does Alpine require that the mail spool directory have 1777
1826    protections?<BR>
1827 Alpine was designed to run without special privileges.  This means that in
1828 order to create a lockfile in the spool directory, it is necessary to have
1829 the spool directory permissions be world-writable.<P>
1830
1831 <LI> Can't you create the lockfile somewhere else?<BR>
1832 No.  The lockfile in question must be in the mail spool directory, because
1833 that's where the mail delivery program expects to find it, and the purpose
1834 of the file is to coordinate access between the mail client (Alpine) and the
1835 mail delivery program.<P>
1836
1837 <LI> Isn't having the spool directory world-writable a big security risk?<BR>
1838 No.  Remember that the individual mail files in the spool directory are
1839 NOT world-writable, only the containing directory.  Setting the &quot;sticky
1840 bit&quot; -- indicated by the &quot;1&quot; before the &quot;777&quot; mode
1841 -- means that only the owner of the file (or root) can delete files in the
1842 directory.  So the only bad behavior that is invited by the 1777 mode is that
1843 anyone could
1844 create a random file in the spool directory.  If the spool directory is
1845 under quota control along with home directories, there is little incentive
1846 for anyone to do this, and even without quotas a periodic scan for
1847 non-mail files usually takes care of the problem.  <P>
1848
1849 <LI> Why not run Alpine as setgid mail?<BR>
1850 Alpine was never designed to run with privileges, and to do so introduces a
1851 significant security vulnerability.  For example, if a user suspends Alpine,
1852 the resulting shell will have group privileges.  This is one example of
1853 why we strongly recommend against running Alpine as a privileged program.
1854 In addition, a &quot;privileged mailer &quot paradigm would mean that normal
1855 users
1856 could not test Alpine versions or other mailers that had not been installed
1857 by the system administrators.<P>
1858
1859
1860 <LI> Are there any alternatives to creating .lock files in the spool dir?<BR>
1861 There are, but they all have different sets of tradeoffs, and not all will
1862 work on all systems.  Some examples:<UL>
1863  <LI> Use lock system calls.  Works fine on a few systems, provided mail
1864    spool is local.   Doesn't work reliably if NFS is used.
1865    Doesn't work unless <B>all</B> the mail programs accessing the spool dir
1866    use the same calls.
1867  <LI> Deliver mail to user's home directory.  An excellent solution, highly
1868    recommended -- but one which is incompatible with some &quot;legacy&quot;
1869 mail tools that always look in the spool directory for the mail.
1870 </UL><P>
1871
1872 <LI> Are these spool directory lock files the only kinds of locks used by
1873    Alpine?<BR>
1874 No.  Alpine also creates lockfiles in the /tmp directory.  For normal Unix
1875 mailbox format folders, these are used to coordinate access between
1876 multiple Alpine sessions.  <P>
1877
1878 <LI> What about the
1879 <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>
1880 This is for people who are content to live dangerously, or who have
1881 specific knowledge that the spool directory lockfiles are superfluous on
1882 their system (because both Alpine and the mail delivery program are using
1883 system call file locking in a context that works reliably, e.g. not NFS.)<P>
1884
1885 <LI> Where can I find more details on how Alpine locking works?<BR>
1886 See the Alpine Technical Notes.<P>
1887
1888 </OL>
1889 <P>
1890 &lt;End of help on this topic&gt;
1891 </BODY>
1892 </HTML>
1893 ===== h_finding_help ====
1894 <HTML>
1895 <HEAD>
1896 <TITLE>Finding more information and requesting help</TITLE>
1897 </HEAD>
1898 <BODY>
1899 <H1>Places to Look for More Answers</H1>
1900 If you have questions about or problems with Alpine that you cannot resolve
1901 after consulting the program's internal, context-sensitive help screens, here
1902 are additional information resources that you may find helpful:
1903 <P>
1904 <UL>
1905   <LI> Alpine's top-level <A HREF="main_menu_tx">MAIN MENU HELP</A>.<P>
1906
1907   <LI> Alpine's <A HREF="h_help_index">Help Index</A>.<P>
1908
1909   <LI> Alpine's internal <A HREF="h_news">Release Notes</A>.  They contain a
1910 listing of changes in Alpine <!--#echo var="ALPINE_VERSION"-->
1911   since the last version, which may be useful for you to be aware of,
1912 <B>especially</B> if a &quot;problem&quot; you are encountering is actually
1913 a change in the way an aspect of Alpine works.  There, you will also find notes
1914 on Alpine configuration.<P>
1915
1916   <LI> The main site for Alpine contains information on configuring and solving problems
1917        with Alpine, it can be found at
1918
1919 <CENTER><A HREF="http://patches.freeiz.com/alpine/">http://patches.freeiz.com/alpine/</A></CENTER>
1920
1921   <LI> The Alpine Information Center (maintained by the University of
1922            Washington) World Wide Web site contains, among other things
1923            <UL>
1924            <LI>a collection of Frequently Asked Questions (and answers!) about Alpine
1925            <LI>an overview of the basics for beginning Alpine users
1926            <LI>Technical Notes for systems administrators
1927            <LI>archives (including a searchable index) of the alpine-info
1928 mailing list, on which matters of interest to systems/email administrators,
1929 developers, trainers, user support personnel, and others involved with Alpine
1930 messaging on a &quot;technical&quot; level are discussed.
1931 </UL>
1932         The Alpine Information Center can be accessed with a WWW browser at:<P>
1933             <CENTER><A HREF="http://www.washington.edu/alpine/">http://www.washington.edu/alpine/</A></CENTER>
1934 </UL>
1935 <P><HR WIDTH="75%">
1936 <H1>Requesting help</H1>
1937 If the internal help, the Release Notes, the Alpine Information Center, and your
1938 local online and print resources do not help you resolve a problem, please
1939 start by contacting your local computer support staff and asking for help.
1940 <p>
1941 This is especially true if:
1942 <ul>
1943   <li>You suddenly have trouble sending or receiving mail.
1944   <li>You receive a "disk quota exceeded" message.
1945   <li>You have forgotten your password.
1946   <li>You think your account may have been compromised.
1947   <li>You need help viewing an attachment.
1948   <li>You need to know how to configure your:
1949       <A HREF="h_config_nntp_server">NNTP (news) server</A>,
1950       <A HREF="h_config_smtp_server">SMTP (sending mail) server</A>,
1951       <A HREF="h_config_ldap_server">LDAP (directory lookup) server</A>, or
1952       <A HREF="h_config_inbox_path">INBOX (incoming mail) path</A>.
1953   <li>You want to know what alternative editors or spellcheckers you may be able to use.
1954   <li>You want to block email from a particular person.
1955   <li>You're going on vacation and need to autorespond to incoming mail.
1956   <li>You want to automatically file or filter incoming messages.
1957 </ul>
1958
1959 In all of these cases,
1960 you should contact <B>your</B> support staff, because <B>only they</B>
1961 will be able to assist you effectively. Your support staff may be, depending on who
1962 provides you with the email account you use Alpine with, for example:<UL>
1963 <LI> the computing help desk of (a department of) your university, school,
1964 employer, ... ; or
1965 <LI> the customer service center of your Internet Service Provider; or
1966 <LI> the friendly volunteer helpers of your Freenet; or
1967 <LI> the person who setup your computer and internet connection.
1968 </UL>
1969
1970 Due to the large number of Alpine installations worldwide, and because we
1971 receive no funding for it, the University of Washington <B>cannot provide
1972 individual support services outside the University of Washington</B>.
1973 <P>
1974 If you have no local computing support to turn to, the worldwide <b>comp.mail.pine</b>
1975 newsgroup can be a valuable source of information and assistance for Alpine
1976 user issues.
1977 <P>
1978 For systems/email administrators, developers, trainers, user support
1979 personnel, and others involved with Alpine messaging on a &quot;technical&quot;
1980 level, the mailing list alpine-info is available; for information on
1981 subscribing and posting to it, see
1982 <P>
1983 <CENTER><A HREF="http://www.washington.edu/alpine/alpine-info/subscribing.html">http://www.washington.edu/alpine/alpine-info/subscribing.html</A></CENTER>
1984 <P>
1985
1986 Regardless of whom you are asking for help with Alpine, remember
1987 to provide as much detail as you can about the
1988 nature of any problem you are encountering, such as
1989 <UL>
1990 <LI>when it first occurred;
1991 <LI>what, if anything, happened that might have brought it about;
1992 <LI>whether it still persists;
1993 <LI>whether it is reproducible, and if so, how;
1994 <LI>what, if anything, you already tried to solve it.
1995 </UL>
1996 It may also be helpful if you specify what version of Alpine you are using
1997 <!--chtml if pinemode="running"-->
1998 -- this is <!--#echo var="ALPINE_VERSION"--> --
1999 <!--chtml endif-->
2000 and on what system, and when the copy of Alpine you are using was created
2001 <!--chtml if pinemode="running"-->
2002 -- for this copy: <!--#echo var=ALPINE_COMPILE_DATE-->
2003 <!--chtml endif-->
2004
2005 <!--chtml if pinemode="running"-->
2006 <P>
2007 When the Alpine program you are currently using was installed, a support
2008 contact email address may have been set up; in that case, you can simply select
2009 this link now to send a message to it:<BR>
2010 <A HREF="X-Alpine-Gripe:_LOCAL_ADDRESS_?local"><!--#echo var="_LOCAL_FULLNAME_"--></A><P>
2011 <!--chtml endif-->
2012 <!--chtml if [ -r PINE_INFO_PATH ]-->
2013 <HR WIDTH="75%">Local Support Contacts:<P>
2014 <!--#include file="PINE_INFO_PATH"-->
2015 <HR WIDTH="75%">
2016 <!--chtml endif-->
2017 <P>
2018 &lt;End of help on this topic&gt;
2019 </BODY>
2020 </HTML>
2021 ===== new_user_greeting ======
2022 <HTML>
2023 <HEAD>
2024 <TITLE>NEW USER GREETING</TITLE>
2025 </HEAD>
2026 <BODY>
2027 <CENTER>&lt;&lt;&lt;This message will appear only once&gt;&gt;&gt;</CENTER>
2028 <BR>
2029 <H1>Welcome to Alpine ... a Program for Internet News and Email</H1>
2030 We hope you will explore Alpine's many capabilities. From the MAIN MENU,
2031 select Setup/Config to see many of the options available to you. Also note
2032 that all screens have context-sensitive help text available.<P>
2033 <!--chtml if pinemode="phone_home"-->
2034 SPECIAL REQUEST:
2035 This software was originally created and maintained as a public
2036 service by the University of Washington until 2009; updates are made
2037 available as a public service of the Alpine community. It is always
2038 helpful to have an idea of how many users are using Alpine. Are you
2039 willing to be counted as an Alpine user? Pressing
2040 <A HREF="X-Alpine-Phone-Home:">Return</A>
2041 will send an anonymous (meaning, your real email address will not be revealed)
2042 message to the Alpine developers for purposes of tallying.
2043 <P>
2044 <!--To Exit this screen and continue your Alpine session press "E".-->
2045 <!--chtml else-->
2046 To Exit this screen and continue your Alpine session press "Return".
2047 <!--chtml endif-->
2048 </BODY>
2049 </HTML>
2050 ===== new_alpine_user_greeting ======
2051 <HTML>
2052 <HEAD>
2053 <TITLE>NEW ALPINE USER GREETING</TITLE>
2054 </HEAD>
2055 <BODY>
2056 <CENTER>&lt;&lt;&lt;This message will appear only once&gt;&gt;&gt;</CENTER>
2057 <BR>
2058 <H1>Welcome to Alpine ... a Program for Internet News and Email</H1>
2059 Your Alpine configuration file indicates that you may have used Pine before
2060 but not Alpine.
2061 If you are familiar with the way Pine works, you should be comfortable
2062 using Alpine.
2063 Your Pine configuration file is automatically used for Alpine.
2064 The Release Notes may be viewed by pressing
2065 &quot;R&quot; now or while in the MAIN MENU.
2066 <P>
2067 <!--chtml if pinemode="phone_home"-->
2068 SPECIAL REQUEST:
2069 This software was originally created and maintained as a public
2070 service by the University of Washington until 2009; updates are made
2071 available as a public service of the Alpine community. It is always
2072 helpful to have an idea of how many users are using Alpine. Are you
2073 willing to be counted as an Alpine user? Pressing
2074 <A HREF="X-Alpine-Phone-Home:">Return</A>
2075 will send an anonymous (meaning, your real email address will not be revealed)
2076 message to the Alpine developers for purposes of tallying.
2077 <P>
2078 <!--To Exit this screen and continue your Alpine session press "E".-->
2079 <!--chtml else-->
2080 To Exit this screen and continue your Alpine session press "Return".
2081 <!--chtml endif-->
2082 </BODY>
2083 </HTML>
2084 ===== new_version_greeting ======
2085 <HTML>
2086 <HEAD>
2087 <TITLE>NEW VERSION GREETING</TITLE>
2088 </HEAD>
2089 <BODY>
2090 <CENTER>&lt;&lt;&lt;This message will appear only once&gt;&gt;&gt;</CENTER>
2091 <BR>
2092 <H1>Welcome to Alpine version <!--#echo var="ALPINE_VERSION"-->!</H1>
2093 Your Alpine configuration file indicates that you may not have used
2094 this version of Alpine before.  This version's significant changes are
2095 documented in the Release Notes, which may be viewed by pressing
2096 &quot;R&quot; now or while in the MAIN MENU.
2097 <P>
2098 <!--chtml if pinemode="phone_home"-->
2099 SPECIAL REQUEST:
2100 This software was originally created and maintained as a public
2101 service by the University of Washington until 2009; updates are made
2102 available as a public service of the Alpine community. It is always
2103 helpful to have an idea of how many users are using Alpine. Are you
2104 willing to be counted as an Alpine user? Pressing
2105 <A HREF="X-Alpine-Phone-Home:">Return</A>
2106 will send an anonymous (meaning, your real email address will not be revealed)
2107 message to the Alpine developers for purposes of tallying.
2108 <P>
2109 <!--To Exit this screen and continue your Alpine session press "E".-->
2110 <!--chtml else-->
2111 To Exit this screen and continue your Alpine session press "Return".
2112 <!--chtml endif-->
2113 </BODY>
2114 </HTML>
2115
2116 ===== main_menu_tx ======
2117 <HTML>
2118 <HEAD>
2119 <TITLE>GENERAL INFORMATION ON THE ALPINE MESSAGE SYSTEM</TITLE>
2120 </HEAD>
2121 <BODY>
2122 <H1>GENERAL INFORMATION ON THE ALPINE MESSAGE SYSTEM</H1>
2123 <DIV ALIGN=CENTER>
2124 Version <!--#echo var="ALPINE_VERSION"-->
2125 <!--chtml if pinemode="running"-->
2126 <BR>(built <!--#echo var=ALPINE_COMPILE_DATE-->)
2127 <!--chtml endif-->
2128 </DIV>
2129 <CENTER>Copyright 2013-2016 Eduardo Chappa,
2130 <BR>Copyright 2006-2008 University of Washington.
2131 </CENTER>
2132
2133 <P>
2134 When you are viewing a help screen, there may be links to
2135 other topics highlighted (in Reverse video) in the text.
2136 Here is an example.
2137 The word &quot;Introduction&quot; in the TABLE OF CONTENTS below should be
2138 highlighted.
2139 If you type carriage return (or V for View Link, see the commands at the
2140 bottom of the screen) you will be taken to a new help screen to view the
2141 Introduction.
2142 The commands at the bottom of the screen should then include
2143 &quot;P Prev Help&quot;.
2144 If you type &quot;P&quot; you will end up back here.
2145 If you type &quot;E&quot; for Exit, you will be back out of help and returned
2146 to the place you were in Alpine when you entered Help.
2147 In this case, you would go back to the MAIN MENU.
2148 There are also other links that are highlighted in bold (or the color used
2149 by your terminal to display bold).
2150 The items after the Introduction in the TABLE OF CONTENTS are all examples
2151 of such links.
2152 In order to view those links, you first have to make the link you want
2153 to view the current link.
2154 The &quot;NextLink&quot; and &quot;PrevLink&quot; commands
2155 (see bottom of screen) can do that for you.
2156 <P>
2157
2158 <H2>TABLE OF CONTENTS</H2>
2159 <OL>
2160   <LI> <A HREF="h_mainhelp_intro">Introduction</A>
2161   <LI> <A HREF="h_mainhelp_pinehelp">Alpine Help</A>
2162 <!--chtml if [ -r PINE_INFO_PATH ]-->
2163   <LI> <A HREF="h_mainhelp_localsupport">Local Support Contacts</A>
2164 <!--chtml endif-->
2165   <LI> <A HREF="h_mainhelp_cmds">Giving Commands in Alpine</A>
2166   <LI> <A HREF="h_mainhelp_config">Alpine Configuration</A>
2167   <LI> <A HREF="h_mainhelp_status">Titlebar Line</A>
2168   <LI> <A HREF="h_mainhelp_mainmenu">Main Menu</A>
2169   <LI> <A HREF="h_mainhelp_index">Index of Messages</A>
2170   <LI> <A HREF="h_mainhelp_reading">Reading Messages</A>
2171   <LI> <A HREF="h_mainhelp_composing">Composing Messages</A>
2172   <LI> <A HREF="h_mainhelp_readingnews">Reading News</A>
2173   <LI> <A HREF="h_mainhelp_abooks">Address Books</A>
2174   <LI> <A HREF="h_mainhelp_ldap">LDAP Directories</A>
2175   <LI> <A HREF="h_mainhelp_folders">Folders</A>
2176   <LI> <A HREF="h_mainhelp_collections">Collection Lists</A>
2177   <LI> <A HREF="h_mainhelp_aggops">Aggregate Operations</A>
2178   <LI> <A HREF="h_mainhelp_color">Color Setup</A>
2179   <LI> <A HREF="h_mainhelp_filtering">Filtering</A>
2180   <LI> <A HREF="h_mainhelp_roles">Roles</A>
2181   <LI> <A HREF="h_mainhelp_patterns">Patterns</A>
2182   <LI> <A HREF="h_mainhelp_keywords">Keywords (or Flags, or Labels)</A>
2183   <LI> <A HREF="h_mainhelp_mouse">Using a Mouse</A>
2184   <LI> <A HREF="h_mainhelp_cmdlineopts">Command Line Options</A>
2185   <LI> <A HREF="h_mainhelp_securing">Securing Your Alpine Session</A>
2186   <LI> <A HREF="h_mainhelp_smime">S/MIME</A>
2187   <LI> <A HREF="h_mainhelp_problems">Reporting Problems</A>
2188   <LI> <A HREF="X-Alpine-Config:">Show Supported Options in this Alpine</A>
2189   <LI> <A HREF="h_help_index">Index to Alpine's Online Help</A>
2190 </OL>
2191
2192 <P>
2193 &lt;End of help on this topic&gt;
2194 </BODY>
2195 </HTML>
2196 ===== h_mainhelp_intro ======
2197 <HTML>
2198 <HEAD>
2199 <TITLE>Introduction</TITLE>
2200 </HEAD>
2201 <BODY>
2202 <H1>Introduction</H1>
2203
2204 Alpine is an &quot;Alternatively Licensed Program for Internet
2205 News and Email&quot; produced until 2009 by the University of Washington.
2206 It is intended to be an easy-to-use program for
2207 sending, receiving, and filing Internet electronic mail messages and
2208 bulletin board (Netnews/Usenet) messages. Alpine supports the following
2209 Internet protocols and specifications: SMTP (Simple Mail Transport Protocol),
2210 NNTP (Network News Transport Protocol), MIME (Multipurpose Internet Mail
2211 Extensions), IMAP (Internet Message Access Protocol), and LDAP (Lightweight
2212 Directory Access Protocol).<p>
2213
2214 Although originally designed for inexperienced email users, Alpine has
2215 evolved to support many advanced features.  There are an ever-growing
2216 number of configuration and personal-preference options, though which of
2217 them are available to you is determined by your local system managers.
2218
2219 <H2>WHAT ALPINE DOES...</H2>
2220
2221 Alpine is a &quot;mail user agent&quot; (MUA), which is a program that
2222 allows you to
2223 compose and read messages using Internet mail standards.  (Whether you
2224 can correspond with others on the Internet depends on whether or not your
2225 computer is connected to the Internet.)  Alpine also allows reading and
2226 posting messages on the Internet &quot;net news&quot; system, provided
2227 that your site operates a suitable news server.
2228
2229 <H2>WHAT ALPINE DOES NOT DO...</H2>
2230
2231 A &quot;mail user agent&quot; such as Alpine is just one part of a
2232 messaging system. Here are some things that are <B>not</B> done by Alpine,
2233 but require other programs:<P>
2234 <UL>
2235  <LI> Actual relaying of email... which is done by &quot;message transfer
2236 agents&quot;.
2237  <LI> Vacation messages... automatically responding to incoming messages
2238  <LI> Anything to do with &quot;talk&quot;... which has nothing to do with
2239 email.
2240  <LI> Anything to do with &quot;irc&quot;... which has nothing to do with email.
2241  <LI> List processing... resending one message to a list of recipients.
2242 </UL>
2243
2244 <P>
2245 &lt;End of help on this topic&gt;
2246 </BODY>
2247 </HTML>
2248
2249 ===== h_mainhelp_pinehelp ======
2250 <HTML>
2251 <HEAD>
2252 <TITLE>Alpine Help</TITLE>
2253 </HEAD>
2254 <BODY>
2255 <H1>Alpine Help</H1>
2256
2257 Alpine help is generally context-sensitive. In other words, each Alpine screen you
2258 use will have its own help text, explaining the choices available for that
2259 screen. This general help section, on the other hand, attempts to give an
2260 overall picture of what Alpine is capable of doing, as well as pointers to
2261 additional help sections about specific topics.<p>
2262
2263 Much of the help text contains links to further help topics, similar to
2264 how the World Wide Web works.
2265 You may choose a link to view using the &quot;NextLink&quot; and
2266 &quot;PrevLink&quot; commands to change the link that is highlighted.
2267 The &quot;View Link&quot; command will then show you the highlighted link.
2268 Similar to the Back button in a web browser, the &quot;Prev Help&quot; command
2269 will return you to where you were before viewing the link, and &quot;Exit Help&quot
2270 will return you to the location in Alpine before you asked for help.
2271 For example, if you are reading this text in Alpine you may return to the
2272 help table of contents with the &quot;Prev Help&quot; command or you may view the
2273 Release notes link in the next paragraph and then return here with
2274 &quot;Prev Help&quot;.
2275 <P>
2276
2277 In addition to this general help on Alpine, <A HREF="h_news">Release Notes</A>
2278 on the current Alpine version are also available from the MAIN MENU: Press
2279 <!--chtml if pinemode="function_key"-->
2280 &quot;F9&quot;
2281 <!--chtml else-->
2282 &quot;R&quot;
2283 <!--chtml endif-->
2284 to browse the release notes.  These include changes since the last release,
2285 configuration information, the history of the Alpine
2286 project, credits, and legal notices.
2287
2288 Alpine releases are available via the world wide web at
2289 <P>
2290 <CENTER><SAMP><A
2291 HREF="http://patches.freeiz.com/alpine/release/">http://patches.freeiz.com/alpine/release/</A></SAMP
2292 ></CENTER>
2293 <P>
2294
2295 If you would like to print <EM>all</EM> of Alpine's internal help text
2296 (not recommended) for a little light bedtime reading, then press
2297 <!--chtml if pinemode="function_key"-->
2298 &quot;F12&quot;
2299 <!--chtml else-->
2300 &quot;Z&quot;
2301 <!--chtml endif-->
2302 now.  (This assumes that the
2303 copy of Alpine you are using has been properly configured for printing
2304 at your site.)
2305 <P>
2306 &lt;End of help on this topic&gt;
2307 </BODY>
2308 </HTML>
2309 ===== h_mainhelp_localsupport ======
2310 <HTML>
2311 <HEAD>
2312 <TITLE>Local Support Contacts</TITLE>
2313 </HEAD>
2314 <BODY>
2315 <H1>Local Support Contacts</H1>
2316
2317 <!--chtml if [ -r PINE_INFO_PATH ]-->
2318 <!--#include file="PINE_INFO_PATH"-->
2319 <!--chtml else-->
2320 No Local Support Contacts configured.
2321 <!--chtml endif-->
2322
2323 <P>
2324 &lt;End of help on this topic&gt;
2325 </BODY>
2326 </HTML>
2327
2328 ===== h_mainhelp_cmds ======
2329 <HTML>
2330 <HEAD>
2331 <TITLE>Giving Commands in Alpine</TITLE>
2332 </HEAD>
2333 <BODY>
2334 <H1>Giving Commands in Alpine</H1>
2335
2336 Unless configured otherwise
2337 (<A HREF="h_config_blank_keymenu"><!--#echo var="FEAT_disable-keymenu"--></A>)
2338 the bottom two lines of the screen are always used to list the
2339 commands you can give.  You press the keys that are highlighted to give
2340 the command.  The commands for getting help and going back to the main
2341 menu are always present (except when viewing help as you are now).
2342 <!--chtml if pinemode="function_key"-->
2343 <!--chtml else-->
2344 <p>
2345 Pressing O (meaning &quot;Other Commands&quot;) changes the keys
2346 you see at the bottom of any screen. In some cases there are 3 or
2347 even 4 different
2348 sets of keys that can be seen by using the O key. <EM>All commands are
2349 active</EM>, even if they are not currently showing at the bottom of your
2350 screen. In other words, you <EM>never</EM> need to press the O key, except to
2351 remind yourself of the proper key to press to perform an operation.
2352
2353 <H2>Control Key Commands</H2>
2354 When composing mail, and in a few other places, in Alpine you
2355 have to use Control keys. This means pressing the Control key (usually labeled
2356 &quot;Ctrl&quot;) and the
2357 letter indicated at the same time.  Usually, this is shown with a
2358 &quot;^&quot; in front of the letter.  On some systems, certain control
2359 characters are intercepted before they get to Alpine.  As a work-around,
2360 you can press the ESCAPE key twice followed by the desired key.  For
2361 example, if Ctrl-O (^O) does not work on your system, try typing
2362 &quot;ESC ESC O&quot;.
2363 <!--chtml endif-->
2364 <H2>Paging Up and Down</H2>
2365 The &quot;+&quot; and &quot;-&quot; keys are used for
2366 moving to the next or previous page.  The space bar is a synonym for
2367 &quot;+&quot;.  You may also use Ctrl-V to page down and Ctrl-Y to page
2368 up as you do in the message composer.  On screens with a WhereIs (search)
2369 command, W or Ctrl-W followed by Ctrl-V will move to the bottom of the
2370 message or list, and W or Ctrl-W followed by Ctrl-Y will move to the top
2371 of the message or list.
2372
2373 <H2>Return Key</H2>
2374 The return key is usually a synonym for a frequently used
2375 command.  When viewing a message, there is currently not a default
2376 command, so RETURN does nothing; when in the index, it is synonymous with
2377 &quot;view msg&quot;. In the key menu at the bottom of the screen, whatever is
2378 enclosed in square brackets [] is the same as the return key.
2379
2380 <H2>Control Keys Not Used By Alpine</H2>
2381 Most commands in Alpine are single letters, with -- we hope -- some mnemonic
2382 value, but in places where Alpine is expecting text input, e.g. in the composer or
2383 at prompts for file/folder names, control keys must be used for editing and
2384 navigation functions.
2385 <P>
2386
2387 Alpine has used nearly all the control keys available.  There are, however,
2388 certain control keys that are reserved by other programs or for technical
2389 reasons.  Alpine does not use any of these keys:
2390 <DL>
2391  <DT>Ctrl-S</DT> <DD>Used by Unix as &quot;stop output&quot;</DD>
2392  <DT>Ctrl-Q</DT> <DD>Used by Unix as &quot;resume output&quot;</DD>
2393  <DT>Ctrl-]</DT> <DD>Often used by Telnet as escape key</DD>
2394 </DL>
2395 <P>
2396 Note: Ctrl-S and Ctrl-Q can be subject to
2397 <A HREF="h_special_xon_xoff">special handling</A>.
2398 <P>
2399 In addition, while the ESC key alone is not used for command input,
2400 Alpine will recognize two consecutive ESC key presses followed by a letter
2401 key as a substitute for control key input.  For example, the control key
2402 <SAMP>Ctrl-X</SAMP> can alternatively be entered using the
2403 three keystrokes: <SAMP>ESC&nbsp;ESC&nbsp;x</SAMP>.
2404 This is useful if the communication program you are using
2405 (e.g. Telnet) has its own, conflicting, idea of what certain control
2406 characters mean.
2407
2408
2409 <H2>Repainting the Screen</H2>
2410 Sometimes what is displayed on the screen will be
2411 incorrect due to noise on the phone line or other causes and you will want
2412 to repaint the whole screen to make it correct.  You can use the Ctrl-L
2413 command to do this.  It never hurts to do it when in doubt.
2414
2415 <P>
2416 &lt;End of help on this topic&gt;
2417 </BODY>
2418 </HTML>
2419 ===== h_mainhelp_status ======
2420 <HTML>
2421 <HEAD>
2422 <TITLE>Titlebar Line</TITLE>
2423 </HEAD>
2424 <BODY>
2425 <H1>Titlebar Line</H1>
2426
2427 The top line of the screen is Alpine's titlebar line.  It will always display
2428 the current version of Alpine and will also convey information about the
2429 status of the program.  This is where you look to find out what
2430 collection, folder and message number is active and where you are in Alpine.
2431 <P>
2432
2433 If the titlebar line says &quot;READONLY&quot; it means that the open folder
2434 (typically your INBOX) is &quot;locked&quot; by another mail session --
2435 most likely a more recent session of Alpine has taken the INBOX lock.
2436 <P>
2437
2438 If the titlebar line says &quot;CLOSED&quot; it means that you are trying to
2439 access a
2440 folder on a remote mail server, and for some reason, communication with
2441 the mail server has either been lost, or never successfully established.
2442 This can be a result of trying to open a non-existent folder, or one
2443 stored on an invalid or non-operational server, or it can mean that Alpine
2444 has been suspended for more that 30 minutes while accessing a remote mail
2445 server.
2446
2447 <P>
2448 &lt;End of help on this topic&gt;
2449 </BODY>
2450 </HTML>
2451 ===== h_mainhelp_mainmenu ======
2452 <HTML>
2453 <HEAD>
2454 <TITLE>Main Menu</TITLE>
2455 </HEAD>
2456 <BODY>
2457 <H1>Main Menu</H1>
2458
2459 The Main Menu lists Alpine's main options.
2460 The key or keys you must type to enter your
2461 choice are to the left of each option or command name.
2462 You can type either uppercase or lowercase letters,
2463 and you should not press &lt;Return&gt; after typing the
2464 letter (unless you are specifically asking for the default,
2465 highlighted command).
2466 <P>
2467
2468 From the Main Menu you can choose to read online help, write (compose) and
2469 send a message, look at an index of your mail messages, open or maintain
2470 your mail folders, update your address book, configure Alpine, and quit Alpine.
2471 There are additional options listed at
2472 the bottom of the screen as well.
2473
2474 <P>
2475 The Help command usually returns context-sensitive help information.
2476 However, in the Main Menu you get the most general help, which includes
2477 a Table of Contents.
2478 The last entry in the Table of Contents is an Index of help topics,
2479 so this is a good place to go if you are having trouble finding how
2480 to do something.
2481
2482 <H2>Main Menu Commands</H2>
2483 The Alpine main menu lists the most common Alpine functions. A <a
2484 href="h_main_menu_commands">full list of these
2485 commands</a> and what they do is available.
2486 <P>
2487 &lt;End of help on this topic&gt;
2488 </BODY>
2489 </HTML>
2490 ===== h_mainhelp_abooks ======
2491 <HTML>
2492 <HEAD>
2493 <TITLE>Address Books</TITLE>
2494 </HEAD>
2495 <BODY>
2496 <H1>Address Books</H1>
2497
2498
2499 As you use email, you can build a list of your regular email correspondents
2500 in your Alpine
2501 Address Book. At the Alpine MAIN MENU, press A to see the Address Book List
2502 screen. Your
2503 personal address book will be highlighted. Press &lt;Return&gt; to view it.
2504 You can use the address book to store email addresses for individuals or
2505 groups, to create easily
2506 remembered &quot;nicknames&quot; for these addresses, and to quickly retrieve an email
2507 address when you are composing a message.
2508 <P>
2509 There are two ways to add addresses to your address book: you can add them
2510 manually or take them from messages (by pressing T to access the Take command).
2511 With either method, you specify nicknames for your correspondents. A single
2512 address book entry (or nickname) can point to just one email address, or, it can
2513 point to more than one. When it points to more than one, it is called a
2514 distribution list. Each distribution list has a nickname, a full name, and a
2515 list of addresses. These
2516 addresses may be actual addresses, other nicknames in your address book, or
2517 other
2518 distribution lists.
2519
2520 <P>
2521 Additional information is available in Alpine's online help:
2522 <ul>
2523   <li><a href="h_abook_opened">The Alpine Address Book</a></li>
2524 </ul>
2525 <P>
2526 &lt;End of help on this topic&gt;
2527 </BODY>
2528 </HTML>
2529 ===== h_mainhelp_ldap ======
2530 <HTML>
2531 <HEAD>
2532 <TITLE>LDAP</TITLE>
2533 </HEAD>
2534 <BODY>
2535 <H1>LDAP</H1>
2536
2537 LDAP (Lightweight Directory Access Protocol) is a standard means of accessing
2538 an organization's shared
2539 directories. Essentially, using LDAP, Alpine is able to find email addresses in
2540 large address
2541 books, rather like the White Pages provided by the phone company. As an Alpine
2542 user, it is not
2543 necessary to know much about how this works, only how to use it and how to
2544 configure
2545 it.
2546 <P>
2547 More information on configuring LDAP is available in Alpine's online help:
2548 <ul>
2549   <li><a href="h_direct_config">Setup LDAP Directory Servers</a></li>
2550 </ul>
2551 <P>
2552 Additional help on using LDAP in Alpine is also available:
2553 <ul>
2554   <li><a href="h_ldap_view">LDAP Response View Explained</a></li>
2555 </ul>
2556 <P>
2557 &lt;End of help on this topic&gt;
2558 </BODY>
2559 </HTML>
2560 ===== h_mainhelp_index ======
2561 <HTML>
2562 <HEAD>
2563 <TITLE>Index of Messages</TITLE>
2564 </HEAD>
2565 <BODY>
2566 <H1>Index of Messages</H1>
2567
2568 In Alpine's message index, the selected message is highlighted. The first
2569 column on the left is blank, shows a &quot;+&quot; if the message was
2570 sent directly to you (i.e., it is not a
2571 copy or from a list), or a &quot;-&quot; if you were explicitly Cc'd.
2572 <P>
2573 The second column may be blank, or it may contain:
2574 <ul>
2575   <li>"N" if the message is new (unread), </li>
2576   <li>"A" if you have answered the message (using the Reply command), </li>
2577   <li>"D" if you have marked the message for deletion.</li>
2578 </ul>
2579
2580 <P>
2581 Note: If you answer a message as well as mark it deleted (in either order),
2582 you will only see the &quot;D&quot;.
2583
2584 <P>
2585 The rest of the columns in the message line show you the message
2586 number, date sent, sender, size, and subject. For details, press ? (Help).
2587 The behavior and appearance of the Index screen is highly configurable.
2588 In the Setup/Config screen search (with the WhereIs command) for options
2589 that contain the words &quot;index&quot; or &quot;thread&quot; to see
2590 many of the configuration possibilities.
2591 In particular, the
2592 &quot;<A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A>&quot;
2593 option may be used to configure the look of the standard MESSAGE INDEX lines
2594 in many different ways.
2595 Find <!--#echo var="VAR_index-format"--> in the Setup/Config screen and
2596 read the help text there for more information.
2597 <P>
2598 Most of the commands you need to handle your messages are visible at the
2599 bottom of the screen, and you can press O (OTHER CMDS) to see additional
2600 commands that are available.
2601 You do not need to see these &quot;other commands&quot;
2602 on the screen to use them. That is, you never need to press O as a prefix
2603 for any other command.
2604
2605 <P>
2606 Additional information is available in Alpine's online help:
2607 <ul>
2608   <li><a href="h_mail_index">Message Index Commands</a></li>
2609 </ul>
2610 <P>
2611 &lt;End of help on this topic&gt;
2612 </BODY>
2613 </HTML>
2614 ===== h_mainhelp_reading ======
2615 <HTML>
2616 <HEAD>
2617 <TITLE>Reading Messages</TITLE>
2618 </HEAD>
2619 <BODY>
2620 <H1>Reading Messages</H1>
2621
2622 The message text screen shows you the text of the message along with
2623 its header. If a message has attachments, those will be listed (but not
2624 displayed) also.  The titlebar line displays information about the currently
2625 open message, folder and collection.  You see the name of the collection
2626 (if there is one) in angle brackets, then the name of the folder, then the
2627 message number and finally the position within the current message (in
2628 percent). If the message is marked for deletion
2629 &quot;DEL&quot; will appear in the
2630 upper right as well.
2631
2632 <P>
2633 As with every Alpine screen, the bottom two lines show you the commands
2634 available.
2635
2636 <P>Additional information is available in Alpine's online help:
2637 <ul>
2638   <li><a href="h_mail_view">Message Text Screen</a></li>
2639   <li><a href="h_attachment_screen">Attachment Index Screen Explained</a></li>
2640   <li><a href="h_mail_text_att_view">Attachment View Screen Explained</a></li>
2641 </ul>
2642 <P>
2643 &lt;End of help on this topic&gt;
2644 </BODY>
2645 </HTML>
2646 ===== h_mainhelp_composing ======
2647 <HTML>
2648 <HEAD>
2649 <TITLE>Composing Messages</TITLE>
2650 </HEAD>
2651 <BODY>
2652 <H1>Composing Messages</H1>
2653
2654 To write a message, press C (Compose). You see the Compose Message
2655 screen, which is divided into two parts: the header area and the message
2656 text area. The header area is where information on the recipient (the To:
2657 field) and the subject line go, while the message text area contains the
2658 actual text of the email message. Different commands are available to you
2659 when your cursor is in different areas on this screen. To see additional
2660 help on commands in either the message text or header area, type
2661 <Control>G (Get help).
2662
2663 <P>
2664 To move around, use the arrow keys or Ctrl-N (Next line) and Ctrl-P
2665 (Previous line); to correct typing errors, use &lt;Backspace&gt; or &lt;Delete&gt;.
2666
2667 <P>The following information from Alpine's online help may prove useful:
2668 <ul>
2669   <li><a href="h_composer_to">Message Header Commands</a></li>
2670   <li><a href="h_compose_richhdr">Rich Header Command</a></li>
2671   <li><a href="h_composer">Composer Commands</a></li>
2672   <li><a href="h_edit_nav_cmds">Composer Editing Commands</a></li>
2673   <li><a href="h_config_change_your_from">Changing your From Address</a></li>
2674   <li><a href="h_compose_send">Send Command</a></li>
2675   <li><a href="h_compose_spell">Spell Check Command</a></li>
2676 </ul>
2677 <P>
2678 &lt;End of help on this topic&gt;
2679 </BODY>
2680 </HTML>
2681 ===== h_mainhelp_collections ======
2682 <HTML>
2683 <HEAD>
2684 <TITLE>Collection Lists</TITLE>
2685 </HEAD>
2686 <BODY>
2687 <H1>Collection Lists</H1>
2688
2689 Collection lists are Alpine's way of organizing groups of folders. Each
2690 "collection" can reside on a different server, for example, and contain a
2691 different group of mail folders.
2692
2693 <P>
2694 For more information on this, see:
2695 <ul>
2696   <li><a href="h_what_are_collections">Folder Collections Explained</a></li>
2697 </ul>
2698 <P>
2699 Additional information relating to collection lists is also available in
2700 Alpine's online
2701 help:
2702 <ul>
2703   <li><a href="h_collection_maint">Setup Collection List Screen</a></li>
2704   <li><a href="h_collection_screen">Collection List Screen</a></li>
2705 </ul>
2706 <P>
2707 &lt;End of help on this topic&gt;
2708 </BODY>
2709 </HTML>
2710 ===== h_mainhelp_folders ======
2711 <HTML>
2712 <HEAD>
2713 <TITLE>Folders</TITLE>
2714 </HEAD>
2715 <BODY>
2716 <H1>Folders</H1>
2717
2718 Messages can quickly accumulate in your INBOX folder. If you use email
2719 often, you soon could have hundreds. You need to delete messages you do
2720 not want, and you can use folders to organize messages you wish to save. A
2721 folder is a collection of one or more messages that are stored (just like
2722 the messages in your INBOX) so you can access and manage them.
2723
2724 <P>
2725 You can organize your email messages into different folders by topic,
2726 correspondent, date, or any other category that is meaningful to you. You
2727 can create your own folders, and Alpine automatically provides three:
2728 <ul>
2729   <li>The INBOX folder: messages sent to you are listed in this folder.
2730       When you first start Alpine and go to the Message Index screen, you are
2731 looking at the list of messages in your INBOX folder. Every incoming
2732 message remains in your INBOX until you delete it or save it in another
2733 folder. </li>
2734   <li>The sent-mail folder: copies of messages you send are stored in this
2735 folder. This is
2736 convenient if you cannot remember whether you actually sent a message and want
2737 to check, or
2738 if you want to send a message again.</li>
2739   <li>The saved-messages folder: copies of messages you save are stored in this
2740 folder
2741 unless you choose to save them to other folders you create yourself.</li>
2742 </ul>
2743
2744 <P>
2745 More information about folders is available in Alpine's online help:
2746 <ul>
2747   <li><a href="h_folder_open">Explanation of Folder Selection</a></li>
2748   <li><a href="h_folder_maint">Help for Folder List</a></li>
2749   <li><a href="h_valid_folder_names">Explanation of Valid Folder Names</a></li>
2750   <li><a href="h_folder_fcc">Folder Select for Fcc ("sent-mail")
2751 Explained</a></li>
2752   <li><a href="h_folder_save">Folder Select for Save Explained</a></li>
2753 </ul>
2754 <P>
2755 &lt;End of help on this topic&gt;
2756 </BODY>
2757 </HTML>
2758 ===== h_mainhelp_color ======
2759 <HTML>
2760 <HEAD>
2761 <TITLE>Color</TITLE>
2762 </HEAD>
2763 <BODY>
2764 <H1>Color</H1>
2765
2766 If the terminal emulator you are using is capable of displaying color or if
2767 you are using PC-Alpine, then it is possible to set up Alpine so that various
2768 parts of the display will be shown in colors you configure. This is done
2769 using the Setup Color screen, available from the MAIN MENU by selecting
2770 the Setup command followed by &quot;K&quot; for Kolor (because &quot;C&quot;
2771 stands for Config in this context).
2772
2773 <P>
2774 For example, you may color things like the titlebar, the current item,
2775 the keymenu, and the status messages.
2776 You may also color lines in the index, and headers and quoted text in the
2777 MESSAGE TEXT screen.
2778 You use the Color Setup screen for configuring most of this, but you must
2779 use the IndexColor setup for coloring whole index lines.
2780 These are available from the MAIN MENU under Setup/Kolor and Setup/Rules/IndexColor.
2781
2782 <P>
2783 The following entries in Alpine's online help provide additional information
2784 about how to use color:
2785 <UL>
2786   <LI> <A HREF="h_color_setup">Color Setup screen</A>
2787   <LI> <A HREF="h_rules_incols">Index Line Color</A>
2788   <LI> <A HREF="h_config_quote_color">quoted text</A> in message view
2789   <LI> <A HREF="h_config_customhdr_pattern">text associated with user-defined headers</A> in message view
2790 </UL>
2791 <P>
2792 &lt;End of help on this topic&gt;
2793 </BODY>
2794 </HTML>
2795 ===== h_mainhelp_mouse ======
2796 <HTML>
2797 <HEAD>
2798 <TITLE>Using a Mouse</TITLE>
2799 </HEAD>
2800 <BODY>
2801 <H1>Using a Mouse</H1>
2802
2803 If you are using PC-Alpine mouse support is turned on automatically.
2804 If you are using UNIX Alpine within an X terminal window or within
2805 a terminal emulator that supports an xterm-style mouse, then you may
2806 turn on support for the mouse with the feature
2807 <A HREF="h_config_enable_mouse"><!--#echo var="FEAT_enable-mouse-in-xterm"--></A>.
2808 For UNIX Alpine you will also need to set the $DISPLAY environment variable.
2809 <P>
2810 PC-Alpine offers considerable mouse support.  You can view what is
2811 &quot;clickable&quot; by dragging your mouse over any screen; when the
2812 arrow cursor changes into a hand, you found something. Mouse-click
2813 possibilities include navigating between screens and folders and
2814 double-clicking on hyperlinks to open your Web browser.
2815 Context-sensitive pop-up menus appear with a right-click on your PC-Alpine
2816 screen.  Examples of right-click options include &quot;copy&quot; after
2817 selecting text to copy and &quot;View in New Window&quot; when you click
2818 on a particular message in the Message Index. The menu choices available
2819 to you will vary based upon what screen is open, where on the screen your
2820 cursor is located, and even what action you have already taken.
2821 Within a folder, you may set the &quot;Important&quot; flag on any
2822 message.
2823 <P>
2824 X terminal mouse support is more limited but still quite powerful.
2825 As with PC-Alpine, clicking on any of the commands in the keymenu at
2826 the bottom of the screen will execute that command as if you typed it.
2827 Double-clicking on a link, for example the link to the
2828 <!--#echo var="FEAT_enable-mouse-in-xterm"--> feature in the paragraph above,
2829 will take you to that link.
2830 Double-clicking on an index line will view the message, and so on.
2831 <P>
2832 &lt;End of help on this topic&gt;
2833 </BODY>
2834 </HTML>
2835 ===== h_mainhelp_keywords ======
2836 <HTML>
2837 <HEAD>
2838 <TITLE>Keywords</TITLE>
2839 </HEAD>
2840 <BODY>
2841 <H1>Keywords</H1>
2842
2843 Within a folder, you may set the &quot;Important&quot; flag on any
2844 message.
2845 This doesn't have any system-defined meaning and is only called
2846 the Important flag because many users use it to signify that a message
2847 is important to them in some way.
2848 <P>
2849 You may also define your own set of keywords.
2850 You might know these as user defined flags or as labels.
2851 These are similar to the Important flag but you choose the names for yourself.
2852 <P>
2853 Alpine will only display keywords that
2854 have been added by you in the Flag Details screen or
2855 that have been configured by you using the Setup/Config option
2856 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>.
2857 Keywords set by other means (for example, by another email client) will not
2858 show up in Alpine unless you configure Alpine to know about them.
2859 They will show up in the Flag Details screen, but will not show up, for example,
2860 in the index line.
2861
2862 <P>
2863 The following entries in Alpine's online help provide additional information
2864 about how to use keywords:
2865 <ul>
2866   <li><A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--> config option</A></li>
2867   <li><A HREF="h_common_flag">Flag command to set keywords</A></li>
2868 </ul>
2869 <P>
2870 &lt;End of help on this topic&gt;
2871 </BODY>
2872 </HTML>
2873 ===== h_mainhelp_roles ======
2874 <HTML>
2875 <HEAD>
2876 <TITLE>Roles</TITLE>
2877 </HEAD>
2878 <BODY>
2879 <H1>Roles</H1>
2880
2881 You may play different roles depending on who you are replying to. For
2882 example, if you are replying to a message addressed to help-desk you may
2883 be acting as a Help Desk Worker. That role may require that you use a
2884 different return address and/or a different signature.
2885
2886 <P>
2887 To configure roles, go to the MAIN MENU and use the Setup command
2888 followed by &quot;Rules&quot; and then &quot;Roles&quot;.
2889 The following entries in Alpine's online help provide additional information
2890 about how to
2891 use roles:
2892 <ul>
2893   <li><a href="h_rules_roles">Setup Roles Screen</a></li>
2894   <li><a href="h_role_select">Roles Screen</a></li>
2895 </ul>
2896 <P>
2897 &lt;End of help on this topic&gt;
2898 </BODY>
2899 </HTML>
2900 ===== h_mainhelp_filtering ======
2901 <HTML>
2902 <HEAD>
2903 <TITLE>Filtering</TITLE>
2904 </HEAD>
2905 <BODY>
2906 <H1>Filtering</H1>
2907
2908 The software that actually delivers mail (the stuff that happens
2909 before Alpine is involved) for you is in a better position to do mail filtering
2910 than Alpine itself.
2911 If possible, you may want to look into using that sort of mail filtering to
2912 deliver mail to different folders, delete it, or forward it.
2913 However, if you'd like Alpine to help with this, Alpine's filtering is for you.
2914
2915 <P>
2916 Filtering is a way to automatically move certain messages from one folder
2917 to another or to automatically delete messages.
2918 You may also automatically set the state (Important, New, Deleted, Answered) of messages
2919 and set <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> for messages.
2920 Alpine doesn't have the ability to forward mail to another address or
2921 to deliver vacation messages.
2922
2923 <P>
2924 To configure filtering, go to the MAIN MENU and use the Setup command
2925 followed by &quot;Rules&quot; and then &quot;Filters&quot;.
2926 The following entries in Alpine's online help provide additional information
2927 about how to use filtering:
2928 <UL>
2929   <LI> <A HREF="h_rules_filter">Filtering Setup screen</A>
2930 </UL>
2931 <P>
2932 &lt;End of help on this topic&gt;
2933 </BODY>
2934 </HTML>
2935 ===== h_mainhelp_patterns ======
2936 <HTML>
2937 <HEAD>
2938 <TITLE>Patterns</TITLE>
2939 </HEAD>
2940 <BODY>
2941 <H1>Patterns</H1>
2942
2943 Patterns are used with Roles, Filtering, Index Coloring,
2944 Scoring, Other Rules, and Search Rules, so it may help you to understand exactly how Patterns work.
2945 The following entries in Alpine's online help provide information
2946 about using Patterns:
2947 <UL>
2948   <LI> <A HREF="h_rule_patterns">Patterns</A>
2949 </UL>
2950 <P>
2951 &lt;End of help on this topic&gt;
2952 </BODY>
2953 </HTML>
2954 ===== h_mainhelp_cmdlineopts ======
2955 <HTML>
2956 <HEAD>
2957 <TITLE>Command Line Options</TITLE>
2958 </HEAD>
2959 <BODY>
2960 <H1>Command Line Options</H1>
2961
2962 Alpine accepts a number of command line arguments, allowing you, for
2963 example, to start Alpine and immediately access a particular folder.
2964 Many of these arguments overlap with options in the Alpine configuration file.
2965 If there is a difference, then an option set on the command line takes
2966 precedence.
2967 Alpine expects command line arguments (other than addresses) to be
2968 preceded by a &quot;-&quot; (dash) as normally used by UNIX programs.
2969 A <a href="h_command_line_options">full list</a> of command line
2970 possibilities is available.
2971 <P>
2972 &lt;End of help on this topic&gt;
2973 </BODY>
2974 </HTML>
2975 ===== h_mainhelp_config ======
2976 <HTML>
2977 <HEAD>
2978 <TITLE>Alpine Configuration</TITLE>
2979 </HEAD>
2980 <BODY>
2981 <H1>Alpine Configuration</H1>
2982
2983 Unless it has been administratively disabled, the Setup command on the
2984 MAIN MENU has several subcommands that allow you to modify Alpine's behavior.
2985 The possible subcommands are for general Configuration settings,
2986 Printer settings, Changing your Password, Signature setup,
2987 AddressBook setup, Collection Lists setup, Rules (including Roles, Filters,
2988 Scores, Search, Indexcolor, and Other rules), LDAP Directory setup,
2989 and Color configuration.
2990 In particular, the &quot;Config&quot; subcommand has many features you may
2991 set or unset and many other configuration variables that may be set to change
2992 the way Alpine works.
2993 Every one of the hundreds of options available in that configuration settings
2994 screen has help text associated with it.
2995 You may read that text by moving the cursor to highlight the option and then
2996 typing the Help command.
2997 <P>
2998 These settings are stored in your personal
2999 &quot;pinerc&quot; configuration file (or, optionally, they may be stored
3000 <A HREF="h_config_remote_config">remotely</A>),
3001 but on shared systems these settings
3002 may be over-ridden by a system-wide control file (due to local site
3003 security or support policies).  A global pine configuration file can also
3004 be used to set default values for all Alpine users on a particular system.
3005 Power users may be interested in splitting their personal configuration
3006 data into two pieces, a generic piece and
3007 <A HREF="h_config_exceptions">exceptions</A> which apply to
3008 a particular platform.
3009 They may also be interested in <A HREF="h_config_inheritance">configuration inheritance</A>.
3010 General Alpine configuration information can be found
3011 <A HREF="h_news_config">here</A>.
3012 <P>
3013 &lt;End of help on this topic&gt;
3014 </BODY>
3015 </HTML>
3016 ===== h_mainhelp_aggops ======
3017 <HTML>
3018 <HEAD>
3019 <TITLE>Aggregate Operations</TITLE>
3020 </HEAD>
3021 <BODY>
3022 <H1>Aggregate Operations</H1>
3023
3024 When you are in the MESSAGE INDEX, the available commands
3025 (for example, Delete, Undelete, Save, Reply, and so on)
3026 normally act on a single message.
3027 So, for example, if you press the Delete command, the currently highlighted
3028 message is marked Deleted.
3029 These commands that normally act on a single message may be applied to
3030 several messages at once instead.
3031 <P>
3032 By default this feature is turned on, but it could be administratively turned
3033 off to reduce complexity.
3034 The feature
3035 <A HREF="h_config_enable_agg_ops"><!--#echo var="FEAT_enable-aggregate-command-set"--></A>
3036 in the Setup/Config screen is used to turn it off or on.
3037 When this feature is turned on, the four commands &quot;Select&quot;,
3038 &quot;SelectCur&quot;, &quot;ZoomMode&quot;, and &quot;Apply&quot;
3039 are available.
3040 The two selection commands allow you to mark a set of
3041 messages as being &quot;selected&quot;.
3042 The &quot;ZoomMode&quot; command will toggle between
3043 displaying only the selected messages and displaying all the messages.
3044 The &quot;Apply&quot; command allows you to
3045 apply one of the regular MESSAGE INDEX commands to all of the selected
3046 messages instead of to only the highlighted message.
3047 <P>
3048 An example aggregate operation would be to catch up when reading
3049 a news group.
3050 That is, get rid of all the messages in the news group so that you can
3051 start fresh.
3052 The easiest way to do this in Alpine is to use aggregate operations.
3053 You want to Delete all of the messages in the group.
3054 You could start at the top and type &quot;D&quot; once for every message.
3055 A much faster method is to first Select all of the messages in the group,
3056 and then Delete all of them.
3057 This would take four keystrokes:
3058 <P>
3059 <CENTER><SAMP>; a (to select all messages)</SAMP></CENTER>
3060 <BR>
3061 <CENTER><SAMP>a d (to delete all selected messages)</SAMP></CENTER>
3062 <P>
3063 Another use of Select is to use it for searching for a particular message
3064 or set of messages in a large folder.
3065 You may know that the message was From a certain user.
3066 You could select all messages from that user to start, and use Zoom to
3067 look at only those messages.
3068 If there were still too many messages to look at you could Narrow the
3069 set of messages further by selecting from all of those messages only
3070 the ones that were after a certain date, or contained a particular phrase
3071 in the Subject, or were too a particular address, and so on.
3072 That may be the end of what you are doing, or you may want to use Apply to
3073 Save or Forward or Print all of the selected messages.
3074 <P>
3075 Some related help topics are
3076 <UL>
3077 <LI> <A HREF="h_index_cmd_select">Selecting: Select and WhereIs/Select</A>,
3078 <LI> <A HREF="h_config_enable_agg_ops"><!--#echo var="FEAT_enable-aggregate-command-set"--></A>,
3079 <LI> <A HREF="h_config_auto_unselect"><!--#echo var="FEAT_auto-unselect-after-apply"--></A>.
3080 <LI> <A HREF="h_config_auto_unzoom"><!--#echo var="FEAT_auto-unzoom-after-apply"--></A>,
3081 <LI> <A HREF="h_config_auto_zoom"><!--#echo var="FEAT_auto-zoom-after-select"--></A>, and
3082 <LI> <A HREF="h_config_select_wo_confirm"><!--#echo var="FEAT_select-without-confirm"--></A>.
3083 </UL>
3084 <P>
3085 &lt;End of help on this topic&gt;
3086 </BODY>
3087 </HTML>
3088 ===== h_mainhelp_readingnews ======
3089 <HTML>
3090 <HEAD>
3091 <TITLE>Reading News</TITLE>
3092 </HEAD>
3093 <BODY>
3094 <H1>Reading News</H1>
3095
3096 <H2>Background</H2>
3097 Alpine can read and post to Internet (or USENET) newsgroups, using the same
3098 commands as for mail. Similar to mailing lists but existing on a larger scale,
3099 Usenet newsgroups allow groups of people with common interests to discuss
3100 particular topics. You might find newsgroups related to your career, or you
3101 might wish to check out the online discussion among the fans of your favorite
3102 television show.
3103
3104 <H2>Configuring Alpine for Reading News</H2>
3105 Alpine often arrives
3106 pre-configured by your system administrator to automatically access the
3107 newsgroups offered by your organization, Internet Service Provider, or
3108 school. PC-Alpine users, and those attempting to customize Unix Alpine, will
3109 need additional details on <a href="h_configuring_news">how to
3110 configure Alpine to read news</a>.
3111
3112 <H2>Accessing Newsgroups</H2>
3113 The first step in reading news is to access the newsgroups collections
3114 screen from Alpine. If everything is configured properly, you should be able
3115 to do this by first typing L (folder List), then selecting the folder
3116 collection listed as "News." The actual name of this collection may differ
3117 from system to system.
3118
3119 <H2>Subscribing to Newsgroups</H2>
3120
3121 Once you have accessed the news collection, you need to subscribe to a
3122 newsgroup that interests you. Subscribing to a newsgroup means that Alpine
3123 will keep a record of the newsgroups in which you are interested and which
3124 articles in those newsgroups have been read.
3125
3126 <H2>Using Newsgroups</H2>
3127 Alpine uses the similar commands to read news as to read mail. For example,
3128 the D command marks messages as Deleted (or "Dismissed," if you prefer),
3129 and the R command Replies to a news posting. Basically, Alpine allows you to
3130 read news as if it were mail, so you don't need to change the way you
3131 interact with Alpine.
3132 <P>
3133 There is also additional Alpine help available on
3134 <A HREF="h_reading_news">how to use Alpine to read news</A>.
3135 <P>
3136 &lt;End of help on this topic&gt;
3137 </BODY>
3138 </HTML>
3139 ===== h_mainhelp_securing ======
3140 <HTML>
3141 <HEAD>
3142 <TITLE>Securing your Alpine Session</TITLE>
3143 </HEAD>
3144 <BODY>
3145 <H1>Securing your Alpine Session</H1>
3146
3147 By default, Alpine will attempt to connect to an IMAP server on the normal
3148 IMAP service port (143).
3149 If the Alpine you are using has been built to
3150 support &quot;Transport Layer Security&quot; (TLS)
3151 and &quot;Secure Sockets Layer&quot; (SSL)
3152 (check by clicking <A HREF="X-Alpine-Config:">here</A>),
3153 and the server offers the STARTTLS capability, then a secure (encrypted)
3154 session will be established.
3155 <P>
3156 When you are connected to a remote folder the titlebar will contain a plus sign
3157 in the far right column if the connection is encrypted using TLS or SSL.
3158 Similarly, when you are being prompted for a password a plus sign will appear in the prompt
3159 if the connection is encrypted.
3160
3161 <H2>More Information on Alpine with SSL and TLS</H2>
3162 <UL>
3163 <LI> <A HREF="h_release_tlscerts">TLS and SSL Usage Note</A> </LI>
3164 <LI> <A HREF="h_folder_server_syntax">/SSL</A> option for older servers which support port 993 SSL but not TLS </LI>
3165 <LI> <A HREF="h_config_alt_auth"><!--#echo var="FEAT_try-alternative-authentication-driver-first"--></A> feature </LI>
3166 <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>
3167 </UL>
3168 <H2>Here are some other security-related features and options</H2>
3169 <P>
3170 <UL>
3171 <LI> <A HREF="h_config_disable_password_caching"><!--#echo var="FEAT_disable-password-caching"--></A> feature to disable password caching </LI>
3172 <LI> <A HREF="h_config_disable_password_file_saving"><!--#echo var="FEAT_disable-password-file-saving"--></A> Disable password file saving</LI>
3173 <LI> <A HREF="h_config_mailcap_params"><!--#echo var="FEAT_enable-mailcap-param-substitution"--></A> feature </LI>
3174 <LI> <A HREF="h_config_disable_auths"><!--#echo var="VAR_disable-these-authenticators"--></A> option </LI>
3175 </UL>
3176 <P>
3177 &lt;End of help on this topic&gt;
3178 </BODY>
3179 </HTML>
3180 ===== h_mainhelp_problems ======
3181 <HTML>
3182 <HEAD>
3183 <TITLE>Reporting Problems</TITLE>
3184 </HEAD>
3185 <BODY>
3186 <H1>Reporting Problems</H1>
3187
3188 We ask that you first read the relevant help screens and then seek
3189 assistance from your own local support staff.  Once you are sure that your
3190 difficulty is not a local configuration problem, you might look at the
3191 help section explaining where to look for
3192 <A HREF="h_finding_help">more information</A> and where to
3193 get assistance.
3194 <P>
3195
3196 <ADDRESS>
3197    Eduardo Chappa &lt;chappa@gmx.com&gt;
3198 </ADDRESS>
3199
3200 <P>
3201 &lt;End of help on this topic&gt;
3202 </BODY>
3203 </HTML>
3204 ===== h_main_menu_commands ======
3205 <HTML>
3206 <HEAD>
3207 <TITLE>MAIN MENU COMMANDS</TITLE>
3208 </HEAD>
3209 <BODY>
3210 <H1>MAIN MENU COMMANDS</H1>
3211
3212 <!--chtml if pinemode="function_key"-->
3213 &nbsp;Available&nbsp;Commands&nbsp;--
3214 &nbsp;Group&nbsp;1&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;2<BR>
3215 &nbsp;------------------------------
3216 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;--------------------
3217 ----------<BR>
3218 &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>
3219 &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>
3220 &nbsp;F3&nbsp;&nbsp;Quit&nbsp;Alpine<BR>
3221 &nbsp;F4&nbsp;&nbsp;Execute&nbsp;current&nbsp;MAIN&nbsp;MENU&nbsp;command&nbsp;&nbsp;&nbsp;F4&nbsp;&nbsp;<A
3222 HREF="h_common_compose">Compose</A>&nbsp;a&nbsp;message<BR>
3223 &nbsp;F5&nbsp;&nbsp;Select&nbsp;previous&nbsp;command&nbsp;up&nbsp;on&nbsp;menu&nbsp;&nbsp;F5&nbsp;&nbsp;<A
3224 HREF="h_common_folders">FOLDER&nbsp;LIST</A>&nbsp;screen<BR>
3225 &nbsp;F6&nbsp;&nbsp;Select&nbsp;next&nbsp;command&nbsp;down&nbsp;on&nbsp;menu&nbsp;&nbsp;&nbsp;&nbsp;F6&nbsp;&nbsp;<A
3226 HREF="h_common_goto">Goto</A>&nbsp;a&nbsp;specified&nbsp;folder<BR>
3227 &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;
3228 &nbsp;F7&nbsp;&nbsp;<A
3229 HREF="h_common_index">MESSAGE&nbsp;INDEX</A>&nbsp;screen<BR>
3230 &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;
3231 &nbsp;F8&nbsp;&nbsp;<A
3232 HREF="h_main_journal">Journal</A>&nbsp;of&nbsp;status&nbsp;messages<BR>
3233 &nbsp;F9&nbsp;&nbsp;Display&nbsp;<A
3234 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
3235 HREF="h_main_setup">SETUP</A>&nbsp;menus<BR>
3236 &nbsp;F10&nbsp;<A
3237 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
3238 HREF="h_main_addrbook">ADDRESS&nbsp;BOOK</A>&nbsp;screen<BR>
3239 &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;
3240 &nbsp;F11&nbsp;<A
3241 HREF="h_common_role">Compose&nbsp;message&nbsp;using&nbsp;a&nbsp;role</a><BR>
3242 <!--chtml else-->
3243 &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>
3244 &nbsp;---------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;--------------------------<BR>
3245 &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>
3246 &nbsp;C&nbsp;&nbsp;<A
3247 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>
3248 &nbsp;I&nbsp;&nbsp;<A
3249 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>
3250 &nbsp;L&nbsp;&nbsp;<A
3251 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>
3252 &nbsp;A&nbsp;&nbsp;<A
3253 HREF="h_main_addrbook">ADDRESS&nbsp;BOOK</A>&nbsp;screen&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;K&nbsp;&nbsp;<A
3254 HREF="h_main_kblock">Lock&nbsp;Keyboard</A><BR>
3255 &nbsp;S&nbsp;&nbsp;<A
3256 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
3257 HREF="h_common_goto">Goto</A>&nbsp;a&nbsp;specified&nbsp;folder<BR>
3258 &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>
3259 &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
3260 HREF="h_common_role">Compose&nbsp;message&nbsp;using&nbsp;a&nbsp;role</a><BR>
3261 <!--chtml endif-->
3262
3263 <P>
3264 NOTE:
3265 <OL>
3266  <LI>For help on a particular command, highlight the bold text associated
3267 with it above and hit Return.
3268  <LI> The availability of certain commands (e.g. some of the options under
3269 SETUP) is determined by Alpine configuration files and system capabilities.
3270 At some sites, certain commands may not be available due to security or
3271 support concerns.
3272 </OL>
3273 <P>
3274 &lt;End of help on this topic&gt;
3275 </BODY>
3276 </HTML>
3277
3278 ===== h_command_line_options ======
3279 <HTML>
3280 <HEAD>
3281 <TITLE>COMMAND LINE OPTIONS</TITLE>
3282 </HEAD>
3283 <BODY>
3284 <H1>COMMAND LINE OPTIONS</H1>
3285 Possible starting arguments for Alpine:
3286
3287 <DL COMPACT>
3288
3289 <DT> <EM>[addresses]</EM>
3290
3291 <DD> Send-to:  If you give <EM>Alpine</EM> an argument or arguments which
3292 do not begin with a dash, <EM>Alpine</EM> treats them as email addresses.
3293 <EM>Alpine</EM> will startup in
3294 the composer with a message started to the addresses specified.
3295 Once the message is sent, the <EM>Alpine</EM> session closes.
3296 Standard input redirection is allowed.
3297 Separate multiple addresses with a space between them.
3298 Addresses are placed in the &quot;To&quot; field only.
3299 <P>
3300
3301 <DT> &lt; <EM>file</EM>
3302
3303 <DD> <EM>Alpine</EM> will startup in the composer with <EM>file</EM> read
3304 into the body of the message.
3305 Once the message is sent, the <EM>Alpine</EM> session closes.
3306 <P>
3307
3308 <DT> -attach <EM>file</EM>
3309
3310 <DD> Go directly into composer with given file attached.
3311 <P>
3312
3313 <DT> -attachlist <EM>file-list</EM>
3314
3315 <DD> Go directly into composer with given files attached.
3316 This must be the last option on the command line.
3317 <P>
3318
3319 <DT> -attach_and_delete <EM>file</EM>
3320
3321 <DD> Go directly into composer with given file attached, delete when finished.
3322 <P>
3323
3324 <DT> -aux <EM>local_directory</EM>
3325
3326 <DD> <EM>PC-Alpine</EM> only.
3327 This tells <EM>PC-Alpine</EM> the local directory to use for storing auxiliary
3328 files, like debug files, address books, and signature files.  The pinerc may
3329 be local or remote.
3330 <P>
3331
3332 <DT> -bail
3333
3334 <DD> If the personal configuration file doesn't already exist, exit.
3335 This might be useful if the configuration file is accessed using some
3336 remote filesystem protocol. If the remote mount is missing this will cause
3337 <EM>Alpine</EM> to quit instead of creating a new pinerc.
3338 <P>
3339
3340 <DT> -c <EM>n</EM>
3341
3342 <DD> When used with the <CODE>-f</CODE> option, apply the <EM>n</EM>th context.
3343 This is used when there are multiple folder collections (contexts) and you
3344 want to open a folder not in the primary collection.
3345 <P>
3346
3347 <DT> -conf
3348
3349 <DD> Configuration: Prints a sample system configuration file to the
3350 screen or standard output. To generate an initial system configuration
3351 file, execute
3352
3353 <PRE><CODE>
3354                 pine -conf > <!--#echo var="PINE_CONF_PATH"-->
3355 </CODE></PRE>
3356 <P>
3357
3358 To generate a system configuration file using settings from an old
3359 system configuration file, execute
3360
3361 <PRE><CODE>
3362                 pine -P old-pine.conf -conf > <!--#echo var="PINE_CONF_PATH"-->
3363 </CODE></PRE>
3364 <P>
3365 A system configuration file is not required.
3366 <P>
3367
3368 <DT> -copy_abook &lt;<EM>local_abook_file</EM>&gt; &lt;<EM>remote_abook_folder</EM>&gt;
3369
3370 <DD> Copy an address book file to a remote address book folder.
3371 If the remote folder doesn't exist, it will be created.
3372 If it exists but the first message in the folder isn't a remote address
3373 book header message, the copy will be aborted.
3374 This flag will not usually be used by a user.
3375 Instead, the user will create a remote address book from within <EM>Alpine</EM>
3376 and copy entries from the local address book by using aggregate Save in
3377 the address book screen.
3378 <P>
3379
3380 <DT> -copy_pinerc &lt;<EM>local_pinerc_file</EM>&gt; &lt;<EM>remote_pinerc_folder</EM>&gt;
3381
3382 <DD> Copy a pinerc configuration file to a remote pinerc folder.
3383 If the remote folder doesn't exist, it will be created.
3384 If it exists but the first message in the folder isn't a remote pinerc
3385 header message, the copy will be aborted.
3386 This flag may be useful to users who already have a local pinerc file and
3387 would like to convert it to a remote pinerc folder and use that instead.
3388 This gives a way to bootstrap that conversion without having to manually
3389 reset all of the variables in the remote pinerc folder.
3390 <P>
3391
3392 <DT> -d <EM>debug-level</EM>
3393
3394 <DD> Debug Level:  Sets the level of debugging information written by
3395 <EM>Alpine</EM>.
3396 <EM>debug-level</EM> can be set to any integer 0-9.
3397 A debug level of 0 turns off debugging for the session.
3398 (Actually there are some levels higher than 9, but you probably don't
3399 want to see them.)
3400 <P>
3401
3402 <DT> -d <EM>keywords</EM>
3403
3404 <DD> You may use a more detailed version of the debugging flag to set
3405 the debug level in separate parts of <EM>Alpine</EM>.
3406 The possibilities are flush, timestamp, imap=0..4, tcp, numfiles=0..31, and
3407 verbose=0..9.
3408 <EM>Flush</EM> causes debugging information to be flushed immediately to
3409 the debug file as it is written.
3410 <EM>Verbose</EM> is the general debugging verbosity level.
3411 <EM>Timestamp</EM> causes timestamps to be added to the debug file, which
3412 is useful when you are trying to figure out what is responsible for delays.
3413 <EM>Numfiles</EM> sets the number of debug files saved.
3414 <EM>Imap</EM> sets the debug level for the debugging statements related
3415 to the conversation with the IMAP server, and more generally, for the
3416 debugging related to <EM>Alpine</EM>'s interaction with the C-Client library.
3417 <EM>Tcp</EM> turns on some TCP/IP debugging.
3418 <P>
3419
3420 <DT> -f <EM>folder</EM>
3421
3422 <DD> Startup folder:  <EM>Alpine</EM> will open this folder in place
3423 of the standard INBOX.
3424 <P>
3425
3426 <DT> -F <EM>file</EM>
3427
3428 <DD> Open named text file for viewing and forwarding.
3429 <P>
3430
3431 <DT> -h
3432
3433 <DD> Help:  Prints the list of available command-line arguments to the
3434 screen.
3435 <P>
3436
3437 <DT> -i
3438
3439 <DD> <EM>Alpine</EM> will start up in the FOLDER INDEX
3440 screen instead of the MAIN MENU.
3441 <P>
3442
3443 Configuration equivalent:  <EM><!--#echo var="VAR_initial-keystroke-list"-->=i</EM>.
3444 <P>
3445
3446 <DT> -I <EM>a,b,c,...</EM>
3447
3448 <DD> Initial Keystrokes:  <EM>Alpine</EM> will execute this comma-separated
3449 sequence of commands upon startup.
3450 This allows users to get <EM>Alpine</EM> to start in any
3451 of its menus/screens.
3452 You cannot include any input to the composer in the initial keystrokes.
3453 The key &lt;Return&gt; is represented by a ``CR'' in
3454 the keystroke list; the spacebar is designated by the letters ``SPACE''.
3455 Control keys are two character sequences beginning with ``^'', such as
3456 ``^I''.
3457 A tab character is ``TAB''.
3458 Function keys are ``F1'' - ``F12'' and the arrow keys are ``UP'',
3459 ``DOWN'', ``LEFT'', and ``RIGHT''.
3460 A restriction is that you can't mix function keys and character keys in this
3461 list even though you can, in some cases, mix them when running <EM>Alpine</EM>.
3462 A user can always use only <EM>character</EM> keys in the startup list even
3463 if he or she is using <EM>function</EM> keys normally, or vice versa.
3464 If an element in this list is a string of characters surrounded by double
3465 quotes (&quot;) then it will be expanded into the individual characters in
3466 the string, excluding the double quotes.
3467 <P>
3468
3469 Configuration equivalent:  <EM><!--#echo var="VAR_initial-keystroke-list"--></EM>
3470 <P>
3471
3472 <DT> -install
3473
3474 <DD> For <EM>PC-Alpine</EM> only, this option prompts the user for
3475 some basic information to help with getting properly set up.
3476 <P>
3477
3478 <DT> -k
3479
3480 <DD> Function-Key Mode:  When invoked in this way, <EM>Alpine</EM> expects
3481 the input of commands to be function-keys.
3482 Otherwise, commands are linked to the regular character keys.
3483 <P>
3484
3485 Configuration equivalent:  <EM><!--#echo var="FEAT_use-function-keys"--></EM> included in
3486 <EM>Feature-List</EM>.
3487 <P>
3488
3489 <DT> -n <EM>n</EM>
3490
3491 <DD> Message-Number:  When specified, <EM>Alpine</EM> starts up in the
3492 FOLDER INDEX screen with the current message being the specified
3493 message number.
3494 <P>
3495
3496 <DT> -nosplash
3497
3498 <DD> <EM>PC-Alpine</EM> only.
3499 This tells <EM>PC-Alpine</EM> not to display the splash screen upon startup.
3500 This may be helpful for certain troubleshooting or terminal server scenarios.
3501 <P>
3502
3503 <DT> -o <EM>folder</EM>
3504
3505 <DD> Opens the INBOX (or a folder specified via the -f argument) ReadOnly.
3506 <P>
3507
3508 <DT> -p <EM>pinerc</EM>
3509
3510 <DD> Uses the named file as the personal configuration file instead of
3511 <EM>~/.pinerc</EM> or the default PINERC search sequence <EM>PC-Alpine</EM> uses.
3512 Alpinerc may be either a local file or a remote configuration folder.
3513 <P>
3514
3515 <DT> -P <EM>pinerc</EM>
3516
3517 <DD> Uses the named file as the system wide configuration file instead of
3518 <EM><!--#echo var="PINE_CONF_PATH"--></EM> on UNIX, or nothing on <EM>PC-Alpine</EM>.
3519 Alpinerc may be either a local file or a remote configuration folder.
3520 <P>
3521
3522 <DT> -passfile <EM>passfile</EM>
3523
3524 <DD> This tells <EM>Alpine</EM> what file should be used as the password file.
3525 This should be a fully-qualified filename.
3526 <P>
3527
3528 <DT> -pinerc <EM>file</EM>
3529
3530 <DD> Output fresh pinerc configuration to <EM>file</EM>, preserving the
3531 settings of variables that the user has made.
3532 Use <EM>file</EM> set to ``-'' to make output go to standard out.
3533 <P>
3534
3535 <DT> -r
3536
3537 <DD> Restricted Mode:  For UNIX <EM>Alpine</EM> only.
3538 <EM>Alpine</EM> in restricted mode can only send email to itself.
3539 Save and export are limited.
3540 <P>
3541
3542 <DT> -registry <EM>cmd</EM>
3543
3544 <DD> For <EM>PC-Alpine</EM> only, this option affects the values of
3545 <EM>Alpine</EM>'s registry entries.
3546 Possible values for <EM>cmd</EM> are set, clear, and dump.
3547 <EM>Set</EM> will always reset <EM>Alpine</EM>'s registry
3548 entries according to its current settings.
3549 <EM>Clear</EM> will clear the registry values.
3550 <EM>Clearsilent</EM> will clear the registry values without any dialogs.
3551 <EM>Dump</EM> will display the values of current registry settings.
3552 Note that the dump command is currently disabled.
3553 Without the -registry option, <EM>PC-Alpine</EM> will write values into
3554 the registry only if there currently aren't any values set.
3555 <P>
3556
3557 <DT> -sort <EM>key</EM>
3558
3559 <DD> Sort-Key:  Specifies the order messages will be displayed in for the
3560 FOLDER INDEX screen.
3561 <EM>Key</EM> can have the following values:
3562 arrival, date, subject, orderedsubj, thread, from, size, score, to, cc,
3563 arrival/reverse, date/reverse, subject/reverse, orderedsubj/reverse, thread/reverse,
3564 from/reverse, size/reverse, score/reverse, to/reverse, and cc/reverse.
3565 The default value is &quot;arrival&quot;.
3566 The <EM>key</EM> value reverse is equivalent to arrival/reverse.
3567 <P>
3568
3569 Configuration equivalent:  <EM><!--#echo var="VAR_sort-key"--></EM>.
3570 <P>
3571
3572 <DT> -uninstall
3573
3574 <DD> For <EM>PC-Alpine</EM> only, this option removes references to Alpine
3575 in Windows settings.  The registry settings are removed and
3576 the password cache is cleared.
3577 <P>
3578
3579 <DT> -url <EM>url</EM>
3580
3581 <DD> Open the given URL.
3582 <P>
3583
3584 <DT> -v
3585
3586 <DD> Version:  Print version information to the screen.
3587 <P>
3588
3589 <DT> -x <EM>exceptions_config</EM>
3590
3591 <DD> Configuration settings in the exceptions configuration override your normal
3592 default settings.
3593 <EM>Exceptions_config</EM> may be either a local file or a remote Alpine configuration folder.
3594 <P>
3595
3596 <DT> -z
3597
3598 <DD> Enable Suspend:  When run with this flag, the key sequence ctrl-z
3599 will suspend the <EM>Alpine</EM> session.
3600 <P>
3601
3602 Configuration equivalent:  <EM><!--#echo var="FEAT_enable-suspend"--></EM> included in
3603 <EM>Feature-List</EM>.
3604 <P>
3605
3606 <DT> -<EM>option</EM>=<EM>value</EM>
3607
3608 <DD> Assign <EM>value</EM> to the config option <EM>option</EM>.
3609 For example, <EM>-signature-file=sig1</EM> or
3610 <EM>-Feature-List=signature-at-bottom</EM>.
3611 Note:  Feature-List values are
3612 additive and features may be preceded with no- to turn them off.
3613 Also, as a special case, the &quot;Feature-List=&quot; part of that may be
3614 omitted. For example, <EM>-signature-at-bottom</EM> is equivalent to
3615 <EM>-Feature-List=signature-at-bottom</EM>.
3616 <P>
3617
3618 </DL>
3619 <P>
3620 &lt;End of help on this topic&gt;
3621 </BODY>
3622 </HTML>
3623 ===== h_configuring_news ======
3624 <HTML>
3625 <HEAD>
3626 <TITLE>CONFIGURING NEWS</TITLE>
3627 </HEAD>
3628 <BODY>
3629 <H1>CONFIGURING NEWS</H1>
3630 Alpine can access news folders in any one of three different ways:
3631 <DL>
3632 <DT>REMOTE NNTP</DT>
3633 <DD>Using the Network News Transport Protocol (NNTP) to
3634 access news on a remote news server.  In this case the newsrc file is
3635 stored on the machine where Alpine is running.
3636
3637 <P>
3638 To specify a remote news-collection accessed via NNTP use the
3639 SETUP/collectionList screen's &quot;Add&quot; command.  Set the
3640 Server: value to the NNTP server's hostname appended with the
3641 communication method &quot;/service=NNTP&quot;, and set the Path:
3642 value to the &quot;#news.&quot; namespace (without the quotes).  See
3643 the &quot;<A HREF="h_composer_cntxt_server">Server:</A>&quot; field's
3644 help text for a more complete explanation of access method, and the
3645 &quot;<A HREF="h_composer_cntxt_path">Path:</A>&quot; field's help
3646 text for a more complete explanation of &quot;namespace&quot;.
3647 <P>
3648 Instead of specifying a news-collection, you may simply set the
3649 <A HREF="h_config_nntp_server">NNTP Server</A>
3650 option, which will cause Alpine to create a default news-collection for you.
3651 Another NNTP option that may be of interest is
3652 <A HREF="h_config_nntprange"><!--#echo var="VAR_nntp-range"--></A>.
3653
3654 <DT>REMOTE IMAP</DT>
3655 <DD>Using the Internet Message Access Protocol (IMAP) to
3656 access news on a remote news server.  In this case, your newsrc file is
3657 stored on the news server, in your home directory, so you must have an
3658 account on the news server, but you would be running Alpine on a different
3659 machine.  The news server must be running an IMAPd server process.
3660
3661 <P>
3662 To specify a remote news-collection accessed via IMAP use the
3663 SETUP/collectionList screen's &quot;Add&quot; command.  Set the
3664 Server: value to the IMAP server's hostname, and set the Path: value
3665 to the &quot;#news.&quot; namespace (without the quotes).  See the
3666 &quot;<A HREF="h_composer_cntxt_path">Path:</A>&quot; field's help
3667 text for a more complete explanation of &quot;namespace&quot;.
3668
3669 </DD>
3670
3671 <DT>LOCAL</DT>
3672 <DD>Using local file access to the news database.  In this
3673 case, your newsrc file is stored on the news server, in your home
3674 directory, so you must have an account on the news server, and you would
3675 be running Alpine on the same machine.
3676
3677 <P>
3678 To specify a local news-collection use the SETUP/collectionList
3679 screen's &quot;Add&quot; command.  Leave the Server: value blank, and
3680 set the Path: value to the &quot;#news.&quot; namespace (without the
3681 quotes).  See the &quot;<A HREF="h_composer_cntxt_path">Path:</A>&quot;
3682 field's help text for a more complete explanation of &quot;namespace&quot;.
3683
3684 </DD>
3685 </DL>
3686
3687 <P>
3688
3689 NOTE: Should no news-collection be defined as above, Alpine will
3690 automatically create one using the Setup/Config screen's
3691 &quot;<!--#echo var="VAR_nntp-server"-->&quot; variable's value if defined.  The collection
3692 will be created as a &quot;Remote NNTP&quot; as described above.
3693
3694 <P>
3695
3696 If you are a PC-Alpine user, either option 1 (NNTP) or option 2 (IMAP) is
3697 possible.  If you don't have an account on the news server, or if the news
3698 server is not running an IMAP daemon, then you must use NNTP.  (If you are not
3699 sure, ask your service provider, university, or company for help.)  In
3700 this case, your Unix .newsrc file can be transferred to your PC.  A good
3701 place to put it would be in the same directory as your PINERC file, under
3702 the name NEWSRC, but you can
3703 <A HREF="h_config_newsrc_path">specify a different location</A>
3704 via Alpine's Setup/Config screen.
3705
3706 <P>
3707 Other configuration features related to news are
3708 <A HREF="h_config_8bit_nntp"><!--#echo var="FEAT_enable-8bit-nntp-posting"--></A>.
3709 <A HREF="h_config_compose_news_wo_conf"><!--#echo var="FEAT_compose-sets-newsgroup-without-confirm"--></A>,
3710 <A HREF="h_config_news_uses_recent"><!--#echo var="FEAT_news-approximates-new-status"--></A>,
3711 <A HREF="h_config_news_cross_deletes"><!--#echo var="FEAT_news-deletes-across-groups"--></A>,
3712 <A HREF="h_config_news_catchup"><!--#echo var="FEAT_news-offers-catchup-on-close"--></A>,
3713 <A HREF="h_config_post_wo_validation"><!--#echo var="FEAT_news-post-without-validation"--></A>,
3714 <A HREF="h_config_read_in_newsrc_order"><!--#echo var="FEAT_news-read-in-newsrc-order"--></A>, and
3715 <A HREF="h_config_quell_post_prompt"><!--#echo var="FEAT_quell-extra-post-prompt"--></A>.
3716
3717 <P>
3718 &lt;End of help on this topic&gt;
3719 </BODY>
3720 </HTML>
3721 ===== h_reading_news ======
3722 <HTML>
3723 <HEAD>
3724 <TITLE>READING NEWS</TITLE>
3725 </HEAD>
3726 <BODY>
3727 <H1>READING NEWS</H1>
3728
3729 Alpine uses almost the same commands for manipulating news folders as for
3730 mail folders.  This means, for example, that when you are done with a
3731 message, you would use &quot;D&quot; to mark it as Deleted (or Dismissed,
3732 if you prefer.)  This &quot;mail-like&quot; behavior differs from that of
3733 most newsreaders, wherein a message is implicitly dismissed after you have
3734 looked at it once. We strongly believe that Alpine should offer as much
3735 consistency as possible between mail and news, so the mail paradigm --
3736 wherein a message does not magically disappear without explicit action by
3737 the user -- is used for news as well. <P>
3738
3739 If you answer a message in a news folder, the index view will show the
3740 &quot;A&quot; flag as usual; but the industry standard file Alpine uses to
3741 keep track of what news as been read has no way of storing this flag, so
3742 it will not be preserved across sessions.  The Deleted flag is the only
3743 one that is preserved when you leave and then return to a newsgroup.  As an
3744 additional note on replies, when you Reply to a newsgroup message and say
3745 you want to reply to all recipients, Alpine will ask if you want to post the
3746 message to all the newsgroups listed in the original message. <P>
3747
3748 If you would like Alpine to mark more-or-less recent news messages as
3749 &quot;New&quot;, then set the
3750 <A HREF="h_config_news_uses_recent">&quot;<!--#echo var="FEAT_news-approximates-new-status"-->&quot;</A>
3751 feature (which is set by default).  This will cause messages after the last one you have marked as
3752 Deleted to appear with &quot;N&quot; status in the MESSAGE INDEX.  The
3753 &quot;N&quot; status often makes it easier to distinguish later news
3754 articles from those you've previously seen, but not yet disposed of via
3755 the &quot;D&quot; key.  Note that this is an approximation, not an exact
3756 record of which messages you have not seen.
3757 <P>
3758
3759 A frequent operation in news-reading is &quot;catching up&quot; -- that
3760 is, getting rid of all the messages in the newsgroup so that you can
3761 &quot;start fresh.&quot;  The easiest way to do this in Alpine is via the
3762 Select command.  You would enter the following four keystrokes:
3763 <tt>;aad</tt> to select all messaged, and then apply the delete (or
3764 dismiss) command to all of them.
3765
3766 <P>
3767 There are also additional details on
3768 <A HREF="h_configuring_news">configuring news</a>.
3769
3770 <P>
3771 &lt;End of help on this topic&gt;
3772 </BODY>
3773 </HTML>
3774 ====== h_help_index ======
3775 <HTML>
3776 <HEAD>
3777 <TITLE>Help Index</TITLE>
3778 </HEAD>
3779 <BODY>
3780 <H1>Help Index</H1>
3781 <ul>
3782 <li><a href="h_mainhelp_abooks">Address Books</a></li>
3783 <li><a href="h_abook_top">ADDRESS BOOK LIST COMMANDS</a>
3784 <li><a href="h_main_addrbook">Address Book Command</a>
3785 <li><a href="h_abook_view">Address Book View Explained</a>
3786 <li><a href="h_compose_addrcomplete">Address Completion</a>
3787 <li><a href="h_abook_select_listmode">Address Listmode Selection from Composer Explained</a>
3788 <li><a href="h_abook_select_checks">Address Selection from Composer Explained</a>
3789 <li><a href="h_composer_abook_comment">Addressbook Comment Explained</a>
3790 <li><a href="h_composer_abook_fcc">Addressbook Fcc Explained</a>
3791 <li><a href="h_composer_abook_add_folder">Addressbook Folder Name Field Explained</a>
3792 <li><a href="h_composer_abook_full">Addressbook Fullname Explained</a>
3793 <li><a href="h_composer_abook_add_nick">Addressbook NickName Field Explained</a>
3794 <li><a href="h_composer_abook_nick">Addressbook Nickname Explained</a>
3795 <li><a href="h_abook_select_addr">Addressbook Selection Explained</a>
3796 <li><a href="h_abook_select_top">Addressbook Selection Navigation Explained</a>
3797 <li><a href="h_composer_abook_add_server">Addressbook Server Name Field Explained</a>
3798 <li><a href="h_mainhelp_aggops">Aggregate Operations</a>
3799 <li><a href="h_mainhelp_config">Alpine Configuration</a>
3800 <li><a href="h_mainhelp_pinehelp">Alpine Help</a>
3801 <li><a href="h_news_legal">Alpine Legal Notices</a>
3802 <li><a href="h_compose_alted">Alt Editor Command</a>
3803 <li><a href="h_index_cmd_apply">Apply Command</a>
3804 <li><a href="h_attachment_screen">Attachment Index Screen Explained</a>
3805 <li><a href="h_mail_text_att_view">Attachment View Screen Explained</a>
3806 <li><a href="h_mainhelp_filtering">Blocking Messages</a>
3807 <li><a href="h_composer_browse">BROWSER</a>
3808 <li><a href="h_common_bounce">Bounce Command</a>
3809 <li><a href="h_compose_cancel">Cancel Command</a>
3810 <li><a href="h_config_change_your_from">Changing your From Address</a>
3811 <li><a href="h_collection_screen">COLLECTION LIST screen</a>
3812 <li><a href="h_mainhelp_color">Color</a>
3813 <li><a href="h_composer_ctrl_j">COMPOSER ATTACH</a>
3814 <li><a href="h_composer">COMPOSER COMMANDS</a>
3815 <li><a href="h_mainhelp_composing">Composing Messages</a>
3816 <li><a href="h_mainhelp_collections">Collection Lists</a>
3817 <li><a href="h_composer_cntxt_nick">Collection Nickname Explained</a>
3818 <li><a href="h_composer_cntxt_path">Collection Path: Explained</a>
3819 <li><a href="h_composer_cntxt_server">Collection Server: Explained</a>
3820 <li><a href="h_composer_cntxt_view">Collection View: Explained</a>
3821 <li><a href="h_mainhelp_cmdlineopts">Command Line Options</a>
3822 <li><a href="h_common_compose">Compose Command</a>
3823 <li><a href="h_edit_nav_cmds">Composer Editing Commands Explained</a>
3824 <li><a href="h_common_conditional_cmds">Conditional Commands</a>
3825 <li><a href="h_reply_token_conditionals">Conditional Inclusion of Text for <!--#echo var="VAR_reply-leadin"-->, Signatures, and Templates</a>
3826 <li><a href="h_mainhelp_config">Configuration</a>
3827 <li><a href="h_composer_custom_free">CUSTOMIZED HEADER FIELD</a>
3828 <li><a href="h_config_dflt_color">Default Color</a>
3829 <li><a href="h_common_delete">Delete and Undelete Commands</a>
3830 <li><a href="h_composer_qserv_cn">Directory Query Form Explained</a>
3831 <li><a href="h_special_list_commands">Email List Commands Explained</a>
3832 <li><a href="h_composer_search">Explanation of Composer Whereis Command </a>
3833 <li><a href="h_folder_open">Explanation of Folder Selection</a>
3834 <li><a href="h_special_xon_xoff">Explanation of Alpine's XOFF/XON Handling</a>
3835 <li><a href="h_valid_folder_names">Explanation of Valid Folder Names</a>
3836 <li><a href="h_ge_export">Export File Selection</a>
3837 <li><a href="h_ge_allparts">Export Message File Selection</a>
3838 <li><a href="h_index_cmd_expunge">Expunge/Exclude Command</a>
3839 <li><a href="h_info_on_locking">FAQs on Alpine Locking</a>
3840 <li><a href="h_config_allow_chg_from">FEATURE: <!--#echo var="FEAT_allow-changing-from"--></a>
3841 <li><a href="h_config_allow_talk">FEATURE: <!--#echo var="FEAT_allow-talk"--></a>
3842 <li><a href="h_config_alt_compose_menu">FEATURE: <!--#echo var="FEAT_alternate-compose-menu"--></a>
3843 <li><a href="h_config_alt_role_menu">FEATURE: <!--#echo var="FEAT_alternate-role-menu"--></a>
3844 <li><a href="h_config_alt_reply_menu">FEATURE: <!--#echo var="FEAT_alternate-reply-menu"--></a>
3845 <li><a href="h_config_force_low_speed">FEATURE: <!--#echo var="FEAT_assume-slow-link"--></a>
3846 <li><a href="h_config_auto_read_msgs">FEATURE: <!--#echo var="FEAT_auto-move-read-msgs"--></a>
3847 <li><a href="h_config_auto_open_unread">FEATURE: <!--#echo var="FEAT_auto-open-next-unread"--></a>
3848 <li><a href="h_config_auto_unselect">FEATURE: <!--#echo var="FEAT_auto-unselect-after-apply"--></a>
3849 <li><a href="h_config_auto_unzoom">FEATURE: <!--#echo var="FEAT_auto-unzoom-after-apply"--></a>
3850 <li><a href="h_config_auto_zoom">FEATURE: <!--#echo var="FEAT_auto-zoom-after-select"--></a>
3851 <li><a href="h_config_use_boring_spinner">FEATURE: <!--#echo var="FEAT_busy-cue-spinner-only"--></a>
3852 <li><a href="h_config_check_mail_onquit">FEATURE: <!--#echo var="FEAT_check-newmail-when-quitting"--></a>
3853 <li><a href="h_config_combined_abook_display">FEATURE: <!--#echo var="FEAT_combined-addrbook-display"--></a>
3854 <li><a href="h_config_combined_folder_display">FEATURE: <!--#echo var="FEAT_combined-folder-display"--></a>
3855 <li><a href="h_config_combined_subdir_display">FEATURE: <!--#echo var="FEAT_combined-subdirectory-display"--></a>
3856 <li><a href="h_config_cancel_confirm">FEATURE: <!--#echo var="FEAT_compose-cancel-confirm-uses-yes"--></a>
3857 <li><a href="h_config_lame_list_mode">FEATURE: <!--#echo var="FEAT_enable-lame-list-mode"--></a>
3858 <li><a href="h_config_compose_rejects_unqual">FEATURE: <!--#echo var="FEAT_compose-rejects-unqualified-addrs"--></a>
3859 <li><a href="h_config_send_filter_dflt">FEATURE: <!--#echo var="FEAT_compose-send-offers-first-filter"--></a>
3860 <li><a href="h_config_compose_news_wo_conf">FEATURE: <!--#echo var="FEAT_compose-sets-newsgroup-without-confirm"--></a>
3861 <li><a href="h_config_del_from_dot">FEATURE: <!--#echo var="FEAT_compose-cut-from-cursor"--></a>
3862 <li><a href="h_config_compose_maps_del">FEATURE: <!--#echo var="FEAT_compose-maps-delete-key-to-ctrl-d"--></a>
3863 <li><a href="h_config_confirm_role">FEATURE: <!--#echo var="FEAT_confirm-role-even-for-default"--></a>
3864 <li><a href="h_config_tab_no_prompt">FEATURE: <!--#echo var="FEAT_continue-tab-without-confirm"--></a>
3865 <li><a href="h_config_dates_to_local">FEATURE: <!--#echo var="FEAT_convert-dates-to-localtime"--></a>
3866 <li><a href="h_config_copy_to_to_from">FEATURE: <!--#echo var="FEAT_copy-to-address-to-from-if-it-is-us"--></a>
3867 <li><a href="h_config_del_skips_del">FEATURE: <!--#echo var="FEAT_delete-skips-deleted"--></a>
3868 <li><a href="h_config_disable_config_cmd">FEATURE: <!--#echo var="FEAT_disable-config-cmd"--></a>
3869 <li><a href="h_config_disable_index_locale_dates">FEATURE: <!--#echo var="FEAT_disable-index-locale-dates"--></a>
3870 <li><a href="h_config_disable_kb_lock">FEATURE: <!--#echo var="FEAT_disable-keyboard-lock-cmd"--></a>
3871 <li><a href="h_config_blank_keymenu">FEATURE: <!--#echo var="FEAT_disable-keymenu"--></a>
3872 <li><a href="h_config_disable_password_caching">FEATURE: <!--#echo var="FEAT_disable-password-caching"--></a>
3873 <li><a href="h_config_disable_password_cmd">FEATURE: <!--#echo var="FEAT_disable-password-cmd"--></a>
3874 <li><a href="h_config_disable_pipes_in_sigs">FEATURE: <!--#echo var="FEAT_disable-pipes-in-sigs"--></a>
3875 <li><a href="h_config_disable_pipes_in_templates">FEATURE: <!--#echo var="FEAT_disable-pipes-in-templates"--></a>
3876 <li><a href="h_config_disable_regex">FEATURE: <!--#echo var="FEAT_disable-regular-expression-matching-for-alternate-addresses"--></a>
3877 <li><a href="h_config_disable_roles_setup">FEATURE: <!--#echo var="FEAT_disable-roles-setup-cmd"--></a>
3878 <li><a href="h_config_disable_roles_sigedit">FEATURE: <!--#echo var="FEAT_disable-roles-sig-edit"--></a>
3879 <li><a href="h_config_disable_roles_templateedit">FEATURE: <!--#echo var="FEAT_disable-roles-template-edit"--></a>
3880 <li><a href="h_config_input_history">FEATURE: <!--#echo var="FEAT_disable-save-input-history"--></a>
3881 <li><a href="h_config_disable_collate">FEATURE: <!--#echo var="FEAT_disable-setlocale-collate"--></a>
3882 <li><a href="h_config_disable_shared">FEATURE: <!--#echo var="FEAT_disable-shared-namespaces"--></a>
3883 <li><a href="h_config_disable_signature_edit">FEATURE: <!--#echo var="FEAT_disable-signature-edit-cmd"--></a>
3884 <li><a href="h_config_take_fullname">FEATURE: <!--#echo var="FEAT_disable-take-fullname-in-addresses"--></a>
3885 <li><a href="h_config_take_lastfirst">FEATURE: <!--#echo var="FEAT_disable-take-last-comma-first"--></a>
3886 <li><a href="h_config_disable_reset_disp">FEATURE: <!--#echo var="FEAT_disable-terminal-reset-for-display-filters"--></a>
3887 <li><a href="h_config_disable_sender">FEATURE: <!--#echo var="FEAT_disable-sender"--></a>
3888 <li><a href="h_config_quell_dead_letter">FEATURE: <!--#echo var="FEAT_quell-dead-letter-on-cancel"--></a>
3889 <li><a href="h_config_quell_flowed_text">FEATURE: <!--#echo var="FEAT_quell-flowed-text"--></a>
3890 <li><a href="h_downgrade_multipart_to_text">FEATURE: <!--#echo var="FEAT_downgrade-multipart-to-text"--></a>
3891 <li><a href="h_config_8bit_smtp">FEATURE: <!--#echo var="FEAT_enable-8bit-esmtp-negotiation"--></a>
3892 <li><a href="h_config_8bit_nntp">FEATURE: <!--#echo var="FEAT_enable-8bit-nntp-posting"--></a>
3893 <li><a href="h_config_enable_agg_ops">FEATURE: <!--#echo var="FEAT_enable-aggregate-command-set"--></a>
3894 <li><a href="h_config_enable_alt_ed">FEATURE: <!--#echo var="FEAT_enable-alternate-editor-cmd"--></a>
3895 <li><a href="h_config_alt_ed_now">FEATURE: <!--#echo var="FEAT_enable-alternate-editor-implicitly"--></a>
3896 <li><a href="h_config_arrow_nav">FEATURE: <!--#echo var="FEAT_enable-arrow-navigation"--></a>
3897 <li><a href="h_config_relaxed_arrow_nav">FEATURE: <!--#echo var="FEAT_enable-arrow-navigation-relaxed"--></a>
3898 <li><a href="h_config_compose_bg_post">FEATURE: <!--#echo var="FEAT_enable-background-sending"--></a>
3899 <li><a href="h_config_enable_bounce">FEATURE: <!--#echo var="FEAT_enable-bounce-cmd"--></a>
3900 <li><a href="h_config_cruise_mode">FEATURE: <!--#echo var="FEAT_enable-cruise-mode"--></a>
3901 <li><a href="h_config_cruise_mode_delete">FEATURE: <!--#echo var="FEAT_enable-cruise-mode-delete"--></a>
3902 <li><a href="h_config_compose_dsn">FEATURE: <!--#echo var="FEAT_enable-delivery-status-notification"--></a>
3903 <li><a href="h_config_enable_dot_files">FEATURE: <!--#echo var="FEAT_enable-dot-files"--></a>
3904 <li><a href="h_config_enable_lessthan_exit">FEATURE: <!--#echo var="FEAT_enable-exit-via-lessthan-command"--></a>
3905 <li><a href="h_config_fast_recent">FEATURE: <!--#echo var="FEAT_enable-fast-recent-test"--></a>
3906 <li><a href="h_config_enable_flag">FEATURE: <!--#echo var="FEAT_enable-flag-cmd"--></a>
3907 <li><a href="h_config_flag_screen_default">FEATURE: <!--#echo var="FEAT_enable-flag-screen-implicitly"--></a>
3908 <li><a href="h_config_flag_screen_kw_shortcut">FEATURE: <!--#echo var="FEAT_enable-flag-screen-keyword-shortcut"--></a>
3909 <li><a href="h_config_enable_full_hdr_and_text">FEATURE: <!--#echo var="FEAT_enable-full-header-and-text"--></a>
3910 <li><a href="h_config_enable_full_hdr">FEATURE: <!--#echo var="FEAT_enable-full-header-cmd"--></a>
3911 <li><a href="h_config_allow_goto">FEATURE: <!--#echo var="FEAT_enable-goto-in-file-browser"--></a>
3912 <li><a href="h_config_enable_dot_folders">FEATURE: <!--#echo var="FEAT_enable-dot-folders"--></a>
3913 <li><a href="h_config_enable_incoming">FEATURE: <!--#echo var="FEAT_enable-incoming-folders"--></a>
3914 <li><a href="h_config_enable_incoming_checking">FEATURE: <!--#echo var="FEAT_enable-incoming-folders-checking"--></a>
3915 <li><a href="h_config_enable_jump">FEATURE: <!--#echo var="FEAT_enable-jump-shortcut"--></a>
3916 <li><a href="h_config_show_delay_cue">FEATURE: <!--#echo var="FEAT_enable-mail-check-cue"--></a>
3917 <li><a href="h_config_mailcap_params">FEATURE: <!--#echo var="FEAT_enable-mailcap-param-substitution"--></a>
3918 <li><a href="h_config_enable_mouse">FEATURE: <!--#echo var="FEAT_enable-mouse-in-xterm"--></a>
3919 <li><a href="h_config_enable_view_addresses">FEATURE: <!--#echo var="FEAT_enable-msg-view-addresses"--></a>
3920 <li><a href="h_config_enable_view_attach">FEATURE: <!--#echo var="FEAT_enable-msg-view-attachments"--></a>
3921 <li><a href="h_config_enable_view_arrows">FEATURE: <!--#echo var="FEAT_enable-msg-view-forced-arrows"--></a>
3922 <li><a href="h_config_enable_view_url">FEATURE: <!--#echo var="FEAT_enable-msg-view-urls"--></a>
3923 <li><a href="h_config_enable_view_web_host">FEATURE: <!--#echo var="FEAT_enable-msg-view-web-hostnames"--></a>
3924 <li><a href="h_config_enable_mulnewsrcs">FEATURE: <!--#echo var="FEAT_enable-multiple-newsrcs"--></a>
3925 <li><a href="h_config_enable_xterm_newmail">FEATURE: <!--#echo var="FEAT_enable-newmail-in-xterm-icon"--></a>
3926 <li><a href="h_config_enable_newmail_short_text">FEATURE: <!--#echo var="FEAT_enable-newmail-short-text-in-icon"--></a>
3927 <li><a href="h_config_sub_lists">FEATURE: <!--#echo var="FEAT_enable-partial-match-lists"--></a>
3928 <li><a href="h_config_enable_y_print">FEATURE: <!--#echo var="FEAT_enable-print-via-y-command"--></a>
3929 <li><a href="h_config_prefix_editing">FEATURE: <!--#echo var="FEAT_enable-reply-indent-string-editing"--></a>
3930 <li><a href="h_config_enable_search_and_repl">FEATURE: <!--#echo var="FEAT_enable-search-and-replace"--></a>
3931 <li><a href="h_config_sigdashes">FEATURE: <!--#echo var="FEAT_enable-sigdashes"--></a>
3932 <li><a href="h_config_new_thread_blank_subject">FEATURE: <!--#echo var="FEAT_new-thread-on-blank-subject"--></a>
3933 <li><a href="h_config_can_suspend">FEATURE: <!--#echo var="FEAT_enable-suspend"--></a>
3934 <li><a href="h_config_enable_tab_complete">FEATURE: <!--#echo var="FEAT_enable-tab-completion"--></a>
3935 <li><a href="h_config_enable_take_export">FEATURE: <!--#echo var="FEAT_enable-take-export"--></a>
3936 <li><a href="h_config_enable_role_take">FEATURE: <!--#echo var="FEAT_enable-rules-under-take"--></a>
3937 <li><a href="h_config_tray_icon">FEATURE: <!--#echo var="FEAT_enable-tray-icon"--></a>
3938 <li><a href="h_config_enable_pipe">FEATURE: <!--#echo var="FEAT_enable-unix-pipe-cmd"--></a>
3939 <li><a href="h_config_verbose_post">FEATURE: <!--#echo var="FEAT_enable-verbose-smtp-posting"--></a>
3940 <li><a href="h_config_expanded_addrbooks">FEATURE: <!--#echo var="FEAT_expanded-view-of-addressbooks"--></a>
3941 <li><a href="h_config_expanded_distlists">FEATURE: <!--#echo var="FEAT_expanded-view-of-distribution-lists"--></a>
3942 <li><a href="h_config_expanded_folders">FEATURE: <!--#echo var="FEAT_expanded-view-of-folders"--></a>
3943 <li><a href="h_config_expose_hidden_config">FEATURE: <!--#echo var="FEAT_expose-hidden-config"--></a>
3944 <li><a href="h_config_expunge_manually">FEATURE: <!--#echo var="FEAT_expunge-only-manually"--></a>
3945 <li><a href="h_config_auto_expunge">FEATURE: <!--#echo var="FEAT_expunge-without-confirm"--></a>
3946 <li><a href="h_config_full_auto_expunge">FEATURE: <!--#echo var="FEAT_expunge-without-confirm-everywhere"--></a>
3947 <li><a href="h_config_no_fcc_attach">FEATURE: <!--#echo var="FEAT_fcc-without-attachments"--></a>
3948 <li><a href="h_config_force_arrow">FEATURE: <!--#echo var="FEAT_force-arrow-cursor"--></a>
3949 <li><a href="h_config_ignore_size">FEATURE: <!--#echo var="FEAT_ignore-size-changes"--></a>
3950 <li><a href="h_config_forward_as_attachment">FEATURE: <!--#echo var="FEAT_forward-as-attachment"--></a>
3951 <li><a href="h_config_preserve_field">FEATURE: <!--#echo var="FEAT_preserve-original-fields"--></a>
3952 <li><a href="h_config_quell_empty_dirs">FEATURE: <!--#echo var="FEAT_quell-empty-directories"--></a>
3953 <li><a href="h_config_hide_nntp_path">FEATURE: <!--#echo var="FEAT_hide-nntp-path"--></a>
3954 <li><a href="h_config_attach_in_reply">FEATURE: <!--#echo var="FEAT_include-attachments-in-reply"--></a>
3955 <li><a href="h_config_fcc_on_bounce">FEATURE: <!--#echo var="FEAT_fcc-on-bounce"--></a>
3956 <li><a href="h_config_include_header">FEATURE: <!--#echo var="FEAT_include-header-in-reply"--></a>
3957 <li><a href="h_config_auto_include_reply">FEATURE: <!--#echo var="FEAT_include-text-in-reply"--></a>
3958 <li><a href="h_config_incoming_checking_total">FEATURE: <!--#echo var="FEAT_incoming-checking-includes-total"--></a>
3959 <li><a href="h_config_incoming_checking_recent">FEATURE: <!--#echo var="FEAT_incoming-checking-uses-recent"--></a>
3960 <li><a href="h_config_add_ldap">FEATURE: <!--#echo var="FEAT_ldap-result-to-addrbook-add"--></a>
3961 <li><a href="h_config_maildrops_preserve_state">FEATURE: <!--#echo var="FEAT_maildrops-preserve-state"--></a>
3962 <li><a href="h_config_mark_fcc_seen">FEATURE: <!--#echo var="FEAT_mark-fcc-seen"--></a>
3963 <li><a href="h_config_mark_for_cc">FEATURE: <!--#echo var="FEAT_mark-for-cc"--></a>
3964 <li><a href="h_config_mulnews_as_typed">FEATURE: <!--#echo var="FEAT_mult-newsrc-hostnames-as-typed"--></a>
3965 <li><a href="h_config_news_uses_recent">FEATURE: <!--#echo var="FEAT_news-approximates-new-status"--></a>
3966 <li><a href="h_config_news_cross_deletes">FEATURE: <!--#echo var="FEAT_news-deletes-across-groups"--></a>
3967 <li><a href="h_config_news_catchup">FEATURE: <!--#echo var="FEAT_news-offers-catchup-on-close"--></a>
3968 <li><a href="h_config_post_wo_validation">FEATURE: <!--#echo var="FEAT_news-post-without-validation"--></a>
3969 <li><a href="h_config_read_in_newsrc_order">FEATURE: <!--#echo var="FEAT_news-read-in-newsrc-order"--></a>
3970 <li><a href="h_config_nntp_search_uses_overview">FEATURE: <!--#echo var="FEAT_nntp-search-uses-overview"--></a>
3971 <li><a href="h_config_thread_sorts_by_arrival">FEATURE: <!--#echo var="FEAT_thread-sorts-by-arrival"--></a>
3972 <li><a href="h_config_expunge_inbox">FEATURE: <!--#echo var="FEAT_offer-expunge-of-inbox"--></a>
3973 <li><a href="h_config_expunge_stayopens">FEATURE: <!--#echo var="FEAT_offer-expunge-of-stayopen-folders"--></a>
3974 <li><a href="h_config_pass_c1_control">FEATURE: <!--#echo var="FEAT_pass-c1-control-characters-as-is"--></a>
3975 <li><a href="h_config_pass_control">FEATURE: <!--#echo var="FEAT_pass-control-characters-as-is"--></a>
3976 <li><a href="h_config_predict_nntp_server">FEATURE: <!--#echo var="FEAT_predict-nntp-server"--></a>
3977 <li><a href="h_config_prefer_plain_text">FEATURE: <!--#echo var="FEAT_prefer-plain-text"--></a>
3978 <li><a href="h_config_preopen_stayopens">FEATURE: <!--#echo var="FEAT_preopen-stayopen-folders"--></a>
3979 <li><a href="h_config_preserve_start_stop">FEATURE: <!--#echo var="FEAT_preserve-start-stop-characters"--></a>
3980 <li><a href="h_config_quell_folder_internal_msg">FEATURE: <!--#echo var="FEAT_quell-folder-internal-msg"--></a>
3981 <li><a href="h_config_quell_checks_comp">FEATURE: <!--#echo var="FEAT_quell-mailchecks-composing-except-inbox"--></a>
3982 <li><a href="h_config_quell_checks_comp_inbox">FEATURE: <!--#echo var="FEAT_quell-mailchecks-composing-inbox"--></a>
3983 <li><a href="h_config_quell_partial">FEATURE: <!--#echo var="FEAT_quell-partial-fetching"--></a>
3984 <li><a href="h_config_quell_local_lookup">FEATURE: <!--#echo var="FEAT_quell-user-lookup-in-passwd-file"--></a>
3985 <li><a href="h_config_ff_between_msgs">FEATURE: <!--#echo var="FEAT_print-formfeed-between-messages"--></a>
3986 <li><a href="h_config_print_from">FEATURE: <!--#echo var="FEAT_print-includes-from-line"--></a>
3987 <li><a href="h_config_print_index">FEATURE: <!--#echo var="FEAT_print-index-enabled"--></a>
3988 <li><a href="h_config_custom_print">FEATURE: <!--#echo var="FEAT_print-offers-custom-cmd-prompt"--></a>
3989 <li><a href="h_config_prune_uses_iso">FEATURE: <!--#echo var="FEAT_prune-uses-yyyy-mm"--></a>
3990 <li><a href="h_config_quell_personal_name_prompt">FEATURE: <!--#echo var="FEAT_quell-personal-name-prompt"--></a>
3991 <li><a href="h_config_quell_ssl_largeblocks">FEATURE: <!--#echo var="FEAT_quell-ssl-largeblocks"--></a>
3992 <li><a href="h_config_quell_user_id_prompt">FEATURE: <!--#echo var="FEAT_quell-user-id-prompt"--></a>
3993 <li><a href="h_config_quit_wo_confirm">FEATURE: <!--#echo var="FEAT_quit-without-confirm"--></a>
3994 <li><a href="h_config_quote_replace_noflow">FEATURE: <!--#echo var="FEAT_quote-replace-nonflowed"--></a>
3995 <li><a href="h_config_next_thrd_wo_confirm">FEATURE: <!--#echo var="FEAT_next-thread-without-confirm"--></a>
3996 <li><a href="h_config_auto_reply_to">FEATURE: <!--#echo var="FEAT_reply-always-uses-reply-to"--></a>
3997 <li><a href="h_config_inbox_no_confirm">FEATURE: <!--#echo var="FEAT_return-to-inbox-without-confirm"--></a>
3998 <li><a href="h_config_save_aggregates">FEATURE: <!--#echo var="FEAT_save-aggregates-copy-sequence"--></a>
3999 <li><a href="h_config_save_part_wo_confirm">FEATURE: <!--#echo var="FEAT_save-partial-msg-without-confirm"--></a>
4000 <li><a href="h_config_save_advances">FEATURE: <!--#echo var="FEAT_save-will-advance"--></a>
4001 <li><a href="h_config_save_wont_delete">FEATURE: <!--#echo var="FEAT_save-will-not-delete"--></a>
4002 <li><a href="h_config_quote_all_froms">FEATURE: <!--#echo var="FEAT_save-will-quote-leading-froms"--></a>
4003 <li><a href="h_config_scramble_message_id">FEATURE: <!--#echo var="FEAT_scramble-message-id"--></a>
4004 <li><a href="h_config_select_wo_confirm">FEATURE: <!--#echo var="FEAT_select-without-confirm"--></a>
4005 <li><a href="h_config_auto_fcc_only">FEATURE: <!--#echo var="FEAT_fcc-only-without-confirm"--></a>
4006 <li><a href="h_config_send_wo_confirm">FEATURE: <!--#echo var="FEAT_send-without-confirm"--></a>
4007 <li><a href="h_config_separate_fold_dir_view">FEATURE: <!--#echo var="FEAT_separate-folder-and-directory-entries"--></a>
4008 <li><a href="h_config_show_cursor">FEATURE: <!--#echo var="FEAT_show-cursor"--></a>
4009 <li><a href="h_config_textplain_int">FEATURE: <!--#echo var="FEAT_show-plain-text-internally"--></a>
4010 <li><a href="h_config_select_in_bold">FEATURE: <!--#echo var="FEAT_show-selected-in-boldface"--></a>
4011 <li><a href="h_config_show_sort">FEATURE: <!--#echo var="FEAT_show-sort"--></a>
4012 <li><a href="h_config_single_list">FEATURE: <!--#echo var="FEAT_single-column-folder-list"--></a>
4013 <li><a href="h_config_sig_at_bottom">FEATURE: <!--#echo var="FEAT_signature-at-bottom"--></a>
4014 <li><a href="h_config_slash_coll_entire">FEATURE: <!--#echo var="FEAT_slash-collapses-entire-thread"--></a>
4015 <li><a href="h_config_sort_fcc_alpha">FEATURE: <!--#echo var="FEAT_sort-default-fcc-alpha"--></a>
4016 <li><a href="h_config_sort_save_alpha">FEATURE: <!--#echo var="FEAT_sort-default-save-alpha"--></a>
4017 <li><a href="h_config_always_spell_check">FEATURE: <!--#echo var="FEAT_spell-check-before-sending"--></a>
4018 <li><a href="h_config_winpos_in_config">FEATURE: <!--#echo var="FEAT_store-window-position-in-config"--></a>
4019 <li><a href="h_config_strip_sigdashes">FEATURE: <!--#echo var="FEAT_strip-from-sigdashes-on-reply"--></a>
4020 <li><a href="h_config_strip_ws_before_send">FEATURE: <!--#echo var="FEAT_strip-whitespace-before-send"--></a>
4021 <li><a href="h_config_quells_asterisks">FEATURE: <!--#echo var="FEAT_suppress-asterisks-in-password-prompt"--></a>
4022 <li><a href="h_config_quell_attach_ext_warn">FEATURE: <!--#echo var="FEAT_quell-attachment-extension-warn"--></a>
4023 <li><a href="h_config_quell_attach_extra_prompt">FEATURE: <!--#echo var="FEAT_quell-attachment-extra-prompt"--></a>
4024 <li><a href="h_config_no_bezerk_zone">FEATURE: <!--#echo var="FEAT_quell-berkeley-format-timezone"--></a>
4025 <li><a href="h_config_quell_charset_warning">FEATURE: <!--#echo var="FEAT_quell-charset-warning"--></a>
4026 <li><a href="h_config_quell_content_id">FEATURE: <!--#echo var="FEAT_quell-content-id"--></a>
4027 <li><a href="h_config_quell_post_prompt">FEATURE: <!--#echo var="FEAT_quell-extra-post-prompt"--></a>
4028 <li><a href="h_config_quell_filtering_done_message">FEATURE: <!--#echo var="FEAT_quell-filtering-done-message"--></a>
4029 <li><a href="h_config_quell_filtering_messages">FEATURE: <!--#echo var="FEAT_quell-filtering-messages"--></a>
4030 <li><a href="h_config_quell_full_hdr_reset">FEATURE: <!--#echo var="FEAT_quell-full-header-auto-reset"--></a>
4031 <li><a href="h_config_quell_imap_env">FEATURE: <!--#echo var="FEAT_quell-imap-envelope-update"--></a>
4032 <li><a href="h_config_quell_lock_failure_warnings">FEATURE: <!--#echo var="FEAT_quell-lock-failure-warnings"--></a>
4033 <li><a href="h_config_quell_domain_warn">FEATURE: <!--#echo var="FEAT_quell-maildomain-warning"--></a>
4034 <li><a href="h_config_quell_news_env">FEATURE: <!--#echo var="FEAT_quell-news-envelope-update"--></a>
4035 <li><a href="h_config_quell_host_after_url">FEATURE: <!--#echo var="FEAT_quell-server-after-link-in-html"--></a>
4036 <li><a href="h_config_quell_beeps">FEATURE: <!--#echo var="FEAT_quell-status-message-beeping"--></a>
4037 <li><a href="h_config_quell_tz_comment">FEATURE: <!--#echo var="FEAT_quell-timezone-comment-when-sending"--></a>
4038 <li><a href="h_config_suppress_user_agent">FEATURE: <!--#echo var="FEAT_suppress-user-agent-when-sending"--></a>
4039 <li><a href="h_config_tab_checks_recent">FEATURE: <!--#echo var="FEAT_tab-checks-recent"--></a>
4040 <li><a href="h_config_tab_uses_unseen">FEATURE: <!--#echo var="FEAT_tab-uses-unseen-for-next-folder"--></a>
4041 <li><a href="h_config_tab_new_only">FEATURE: <!--#echo var="FEAT_tab-visits-next-new-message-only"--></a>
4042 <li><a href="h_config_termcap_wins">FEATURE: <!--#echo var="FEAT_termdef-takes-precedence"--></a>
4043 <li><a href="h_config_color_thrd_import">FEATURE: <!--#echo var="FEAT_thread-index-shows-important-color"--></a>
4044 <li><a href="h_config_alt_auth">FEATURE: <!--#echo var="FEAT_try-alternative-authentication-driver-first"--></a>
4045 <li><a href="h_config_unsel_wont_advance">FEATURE: <!--#echo var="FEAT_unselect-will-not-advance"--></a>
4046 <li><a href="h_config_use_current_dir">FEATURE: <!--#echo var="FEAT_use-current-dir"--></a>
4047 <li><a href="h_config_use_fk">FEATURE: <!--#echo var="FEAT_use-function-keys"--></a>
4048 <li><a href="h_config_use_reg_start_for_stayopen">FEATURE: <!--#echo var="FEAT_use-regular-startup-rule-for-stayopen-folders"--></a>
4049 <li><a href="h_config_use_resentto">FEATURE: <!--#echo var="FEAT_use-resent-to-in-rules"--></a>
4050 <li><a href="h_config_use_sender_not_x">FEATURE: <!--#echo var="FEAT_use-sender-not-x-sender"--></a>
4051 <li><a href="h_config_suspend_spawns">FEATURE: <!--#echo var="FEAT_use-subshell-for-suspend"--></a>
4052 <li><a href="h_config_use_system_translation">FEATURE: Use System Translation</a>
4053 <li><a href="h_config_vertical_list">FEATURE: <!--#echo var="FEAT_vertical-folder-list"--></a>
4054 <li><a href="h_config_warn_if_fcc_blank">FEATURE: <!--#echo var="FEAT_warn-if-blank-fcc"--></a>
4055 <li><a href="h_config_warn_if_subj_blank">FEATURE: <!--#echo var="FEAT_warn-if-blank-subject"--></a>
4056 <li><a href="h_config_warn_if_no_to_or_cc">FEATURE: <!--#echo var="FEAT_warn-if-blank-to-and-cc-and-newsgroups"--></a>
4057 <li><a href="h_mainhelp_filtering">Filtering</a>
4058 <li><a href="h_finding_help">Finding more information and requesting help</a>
4059 <li><a href="h_common_flag">Flag Command</a>
4060 <li><a href="h_config_quell_flowed_text">Flowed Text</a>
4061 <li><a href="h_mainhelp_folders">Folders</a>
4062 <li><a href="h_what_are_collections">Folder Collections Explained</a>
4063 <li><a href="h_common_folders">Folder List Command</a>
4064 <li><a href="h_folder_fcc">Folder Select for Fcc Explained</a>
4065 <li><a href="h_folder_save">Folder Select for Save Explained</a>
4066 <li><a href="h_folder_server_syntax">Folder Server Name Syntax</a>
4067 <li><a href="h_config_change_your_from">From Address, Changing</a>
4068 <li><a href="main_menu_tx">GENERAL INFORMATION ON THE ALPINE MESSAGE SYSTEM</a>
4069 <li><a href="h_pine_for_windows">GETTING HELP IN ALPINE</a>
4070 <li><a href="h_common_goto">Goto Command</a>
4071 <li><a href="h_common_hdrmode">HdrMode Command</a>
4072 <li><a href="h_mainhelp_pinehelp">Help</a>
4073 <li><a href="h_special_help_nav">Help Text Navigation Explained</a>
4074 <li><a href="h_folder_maint">Help for Folder List</a>
4075 <li><a href="h_valid_folder_names">IMAP</a>
4076 <li><a href="h_ge_import">Import File Selection</a>
4077 <li><a href="h_mainhelp_index">Index of Messages</a>
4078 <li><a href="h_composer_ins_m">INSERT MESSAGE</a>
4079 <li><a href="h_composer_ins">INSERT TEXT FILE</a>
4080 <li><a href="h_address_format">INTERNET EMAIL ADDRESS FORMAT</a>
4081 <li><a href="h_info_on_mbox">Information on mbox driver</a>
4082 <li><a href="h_mainhelp_intro">Introduction</a>
4083 <li><a href="h_main_journal">Journal Command</a>
4084 <li><a href="h_common_jump">Jump Command</a>
4085 <li><a href="h_compose_justify">Justify Command</a>
4086 <li><a href="h_main_kblock">Keyboard Lock Command</a>
4087 <li><a href="h_mainhelp_keywords">Keywords (or Flags, or Labels)</a>
4088 <li><a href="h_mainhelp_ldap">LDAP</a>
4089 <li><a href="h_config_ldap_opts_tls">LDAP FEATURE: Attempt-TLS-On-Connection</a>
4090 <li><a href="h_config_ldap_opts_nosub">LDAP FEATURE: Disable-Ad-Hoc-Space-Substitution</a>
4091 <li><a href="h_config_ldap_opts_rhs">LDAP FEATURE: Lookup-Addrbook-Contents</a>
4092 <li><a href="h_config_ldap_opts_tlsmust">LDAP FEATURE: Require-TLS-On-Connection</a>
4093 <li><a href="h_config_ldap_opts_ldaps">LDAP FEATURE: Require-LDAPS-On-Connection</a>
4094 <li><a href="h_config_ldap_opts_ref">LDAP FEATURE: Save-Search-Criteria-Not-Result</a>
4095 <li><a href="h_config_ldap_opts_impl">LDAP FEATURE: Use-Implicitly-From-Composer</a>
4096 <li><a href="h_config_ldap_binddn">LDAP OPTION: Bind-DN</a>
4097 <li><a href="h_config_ldap_cust">LDAP OPTION: Custom-Search-Filter</a>
4098 <li><a href="h_config_ldap_email_attr">LDAP OPTION: EmailAttribute</a>
4099 <li><a href="h_config_ldap_gn_attr">LDAP OPTION: GivennameAttribute</a>
4100 <li><a href="h_config_ldap_server">LDAP OPTION: <!--#echo var="VAR_ldap-servers"--></a>
4101 <li><a href="h_config_ldap_cn_attr">LDAP OPTION: NameAttribute</a>
4102 <li><a href="h_config_ldap_nick">LDAP OPTION: Nickname</a>
4103 <li><a href="h_config_ldap_port">LDAP OPTION: Port</a>
4104 <li><a href="h_config_ldap_base">LDAP OPTION: Search-Base</a>
4105 <li><a href="h_config_ldap_searchrules">LDAP OPTION: Search-Rule</a>
4106 <li><a href="h_config_ldap_searchtypes">LDAP OPTION: Search-Type</a>
4107 <li><a href="h_config_ldap_size">LDAP OPTION: Sizelimit</a>
4108 <li><a href="h_config_ldap_sn_attr">LDAP OPTION: SurnameAttribute</a>
4109 <li><a href="h_config_ldap_time">LDAP OPTION: Timelimit</a>
4110 <li><a href="h_ldap_view">LDAP Response View Explained</a>
4111 <li><a href="h_maildrop">Mail Drop: What is it?</a>
4112 <li><a href="h_mainhelp_mainmenu">MAIN MENU</a>
4113 <li><a href="h_mail_index">MESSAGE INDEX COMMANDS</a>
4114 <li><a href="h_mail_view">MESSAGE TEXT SCREEN</a>
4115 <li><a href="h_compose_markcutpaste">Mark, Cut and Paste Commands</a>
4116 <li><a href="h_common_index">Message Index Command</a>
4117 <li><a href="h_mainhelp_mouse">Mouse</a>
4118 <li><a href="h_mainhelp_aggops">Multiple Message Operations</a>
4119 <li><a href="new_user_greeting">NEW USER GREETING</a>
4120 <li><a href="new_version_greeting">NEW VERSION GREETING</a>
4121 <li><a href="h_mainhelp_readingnews">News Reading</a>
4122 <li><a href="h_folder_subscribe">Newsgroup Subcribe Screen explained</a>
4123 <li><a href="h_folder_postnews">Newsgroup selecting for Posting explained</a>
4124 <li><a href="h_common_nextnew">NextNew Command</a>
4125 <li><a href="h_abook_select_nick">Nickname Selection Explained</a>
4126 <li><a href="h_mainhelp_readingnews">NNTP</a>
4127 <li><a href="h_config_address_book">OPTION: <!--#echo var="VAR_address-book"--></a>
4128 <li><a href="h_config_abook_formats">OPTION: <!--#echo var="VAR_addressbook-formats"--></a>
4129 <li><a href="h_config_ab_sort_rule">OPTION: <!--#echo var="VAR_addrbook-sort-rule"--></a></a>
4130 <li><a href="h_config_alt_addresses">OPTION: <!--#echo var="VAR_alt-addresses"--></a>
4131 <li><a href="h_config_active_msg_interval">OPTION: <!--#echo var="VAR_busy-cue-rate"--></a>
4132 <li><a href="h_config_color_style">OPTION: Color Style</a>
4133 <li><a href="h_config_wordseps">OPTION: <!--#echo var="VAR_composer-word-separators"--></a>
4134 <li><a href="h_config_composer_wrap_column">OPTION: <!--#echo var="VAR_composer-wrap-column"--></a>
4135 <li><a href="h_config_index_color_style">OPTION: <!--#echo var="VAR_current-indexline-style"--></a>
4136 <li><a href="h_config_cursor_style">OPTION: Cursor Style</a>
4137 <li><a href="h_config_custom_hdrs">OPTION: <!--#echo var="VAR_customized-hdrs"--></a>
4138 <li><a href="h_config_deadlets">OPTION: <!--#echo var="VAR_dead-letter-files"--></a>
4139 <li><a href="h_config_comp_hdrs">OPTION: <!--#echo var="VAR_default-composer-hdrs"--></a>
4140 <li><a href="h_config_default_fcc">OPTION: <!--#echo var="VAR_default-fcc"--></a>
4141 <li><a href="h_config_def_save_folder">OPTION: <!--#echo var="VAR_default-saved-msg-folder"--></a>
4142 <li><a href="h_config_disable_auths">OPTION: <!--#echo var="VAR_disable-these-authenticators"--></a>
4143 <li><a href="h_config_disable_drivers">OPTION: <!--#echo var="VAR_disable-these-drivers"--></a>
4144 <li><a href="h_config_char_set">OPTION: Display Character Set</a>
4145 <li><a href="h_config_display_filters">OPTION: <!--#echo var="VAR_display-filters"--></a>
4146 <li><a href="h_config_download_cmd">OPTION: <!--#echo var="VAR_download-command"--></a>
4147 <li><a href="h_config_download_prefix">OPTION: <!--#echo var="VAR_download-command-prefix"--></a>
4148 <li><a href="h_config_editor">OPTION: <!--#echo var="VAR_editor"--></a>
4149 <li><a href="h_config_empty_hdr_msg">OPTION: <!--#echo var="VAR_empty-header-message"--></a>
4150 <li><a href="h_config_fcc_rule">OPTION: <!--#echo var="VAR_fcc-name-rule"--></a>
4151 <li><a href="h_config_file_dir">OPTION: File Directory</a>
4152 <li><a href="h_config_folder_spec">OPTION: <!--#echo var="VAR_folder-collections"--></a>
4153 <li><a href="h_config_reopen_rule">OPTION: <!--#echo var="VAR_folder-reopen-rule"--></a>
4154 <li><a href="h_config_fld_sort_rule">OPTION: <!--#echo var="VAR_folder-sort-rule"--></a>
4155 <li><a href="h_config_font_char_set">OPTION: Font Character Set</a>
4156 <li><a href="h_config_font_name">OPTION: Font Name</a>
4157 <li><a href="h_config_font_size">OPTION: Font Size</a>
4158 <li><a href="h_config_font_style">OPTION: Font Style</a>
4159 <li><a href="h_config_form_folder">OPTION: <!--#echo var="VAR_form-letter-folder"--></a>
4160 <li><a href="h_config_glob_addrbook">OPTION: <!--#echo var="VAR_global-address-book"--></a>
4161 <li><a href="h_config_goto_default">OPTION: <!--#echo var="VAR_goto-default-rule"--></a>
4162 <li><a href="h_config_header_general_color">OPTION: Header General Color</a>
4163 <li><a href="h_config_image_viewer">OPTION: <!--#echo var="VAR_image-viewer"--></a>
4164 <li><a href="h_config_inbox_path">OPTION: <!--#echo var="VAR_inbox-path"--></a>
4165 <li><a href="h_config_archived_folders">OPTION: <!--#echo var="VAR_incoming-archive-folders"--></a>
4166 <li><a href="h_config_psleep">OPTION: <!--#echo var="VAR_mailcap-check-interval"--></a>
4167 <li><a href="h_config_incoming_interv">OPTION: <!--#echo var="VAR_incoming-check-interval"--></a>
4168 <li><a href="h_config_incoming_second_interv">OPTION: <!--#echo var="VAR_incoming-check-interval-secondary"--></a>
4169 <li><a href="h_config_incoming_list">OPTION: <!--#echo var="VAR_incoming-check-list"--></a>
4170 <li><a href="h_config_incoming_timeo">OPTION: <!--#echo var="VAR_incoming-check-timeout"--></a>
4171 <li><a href="h_config_incoming_folders">OPTION: <!--#echo var="VAR_incoming-folders"--></a>
4172 <li><a href="h_config_inc_startup">OPTION: <!--#echo var="VAR_incoming-startup-rule"--></a>
4173 <li><a href="h_config_incunseen_color">OPTION: Incoming Unseen Color</a>
4174 <li><a href="h_config_index_arrow_color">OPTION: Index Arrow Color</a>
4175 <li><a href="h_config_index_color">OPTION: Index Colors</a>
4176 <li><a href="h_config_index_format">OPTION: <!--#echo var="VAR_index-format"--></a>
4177 <li><a href="h_config_index_from_color">OPTION: Index From Color</a>
4178 <li><a href="h_config_index_opening_color">OPTION: Index Opening Color</a>
4179 <li><a href="h_config_index_pri_color">OPTION: Index Priority Symbol Colors</a>
4180 <li><a href="h_config_index_subject_color">OPTION: Index Subject Color</a>
4181 <li><a href="h_config_init_cmd_list">OPTION: <!--#echo var="VAR_initial-keystroke-list"--></a>
4182 <li><a href="h_config_key_char_set">OPTION: Keyboard Character Set</a>
4183 <li><a href="h_config_keylabel_color">OPTION: KeyLabel Color</a>
4184 <li><a href="h_config_keyname_color">OPTION: KeyName Color</a>
4185 <li><a href="h_config_keywords">OPTION: <!--#echo var="VAR_keywords"--></a>
4186 <li><a href="h_config_kw_color">OPTION: Keyword Colors</a>
4187 <li><a href="h_config_kw_braces">OPTION: <!--#echo var="VAR_keyword-surrounding-chars"--></a>
4188 <li><a href="h_config_prune_date">OPTION: <!--#echo var="VAR_last-time-prune-questioned"--></a>
4189 <li><a href="h_config_last_vers">OPTION: <!--#echo var="VAR_last-version-used"--></a>
4190 <li><a href="h_config_literal_sig">OPTION: <!--#echo var="VAR_literal-signature"--></a>
4191 <li><a href="h_config_mailcheck">OPTION: <!--#echo var="VAR_mail-check-interval"--></a>
4192 <li><a href="h_config_mailchecknoncurr">OPTION: <!--#echo var="VAR_mail-check-interval-noncurrent"--></a>
4193 <li><a href="h_config_mailcap_path">OPTION: <!--#echo var="VAR_mailcap-search-path"--></a>
4194 <li><a href="h_config_maildropcheck">OPTION: <!--#echo var="VAR_maildrop-check-minimum"--></a>
4195 <li><a href="h_config_maxremstream">OPTION: <!--#echo var="VAR_max-remote-connections"--></a>
4196 <li><a href="h_config_metamsg_color">OPTION: Meta-Message Color</a>
4197 <li><a href="h_config_mimetype_path">OPTION: <!--#echo var="VAR_mimetype-search-path"--></a>
4198 <li><a href="h_config_new_ver_quell">OPTION: <!--#echo var="VAR_new-version-threshold"--></a>
4199 <li><a href="h_config_fifopath">OPTION: NewMail FIFO Path</a>
4200 <li><a href="h_config_newmailwidth">OPTION: <!--#echo var="VAR_newmail-window-width"--></a>
4201 <li><a href="h_config_news_active">OPTION: <!--#echo var="VAR_news-active-file-path"--></a>
4202 <li><a href="h_config_news_spec">OPTION: <!--#echo var="VAR_news-collections"--></a>
4203 <li><a href="h_config_news_spool">OPTION: <!--#echo var="VAR_news-spool-directory"--></a>
4204 <li><a href="h_config_newsrc_path">OPTION: <!--#echo var="VAR_newsrc-path"--></a>
4205 <li><a href="h_config_nntprange">OPTION: <!--#echo var="VAR_nntp-range"--></a>
4206 <li><a href="h_config_nntp_server">OPTION: <!--#echo var="VAR_nntp-server"--></HEAD></a>
4207 <li><a href="h_config_normal_color">OPTION: Normal Color</a>
4208 <li><a href="h_config_opening_sep">OPTION: <!--#echo var="VAR_opening-text-separator-chars"--></a>
4209 <li><a href="h_config_oper_dir">OPTION: <!--#echo var="VAR_operating-dir"--></a>
4210 <li><a href="h_config_pat_old">OPTION: Patterns</a>
4211 <li><a href="h_config_pat_filts">OPTION: <!--#echo var="VAR_patterns-filters2"--></a>
4212 <li><a href="h_config_pat_other">OPTION: <!--#echo var="VAR_patterns-other"--></a>
4213 <li><a href="h_config_pat_roles">OPTION: <!--#echo var="VAR_patterns-roles"--></a>
4214 <li><a href="h_config_pat_scores">OPTION: <!--#echo var="VAR_patterns-scores2"--></a>
4215 <li><a href="h_config_pers_name">OPTION: <!--#echo var="VAR_personal-name"--></a>
4216 <li><a href="h_config_print_cat">OPTION: <!--#echo var="VAR_personal-print-category"--></a>
4217 <li><a href="h_config_print_command">OPTION: <!--#echo var="VAR_personal-print-command"--></a>
4218 <li><a href="h_config_post_char_set">OPTION: <!--#echo var="VAR_posting-character-set"--></a>
4219 <li><a href="h_config_postponed_folder">OPTION: <!--#echo var="VAR_postponed-folder"--></a>
4220 <li><a href="h_config_print_font_char_set">OPTION: Print-Font-Char-Set</a>
4221 <li><a href="h_config_print_font_name">OPTION: Print-Font-Name</a>
4222 <li><a href="h_config_print_font_size">OPTION: Print-Font-Size</a>
4223 <li><a href="h_config_print_font_style">OPTION: Print-Font-Style</a>
4224 <li><a href="h_config_printer">OPTION: Printer</a>
4225 <li><a href="h_config_prompt_color">OPTION: Prompt Color</a>
4226 <li><a href="h_config_pruned_folders">OPTION: <!--#echo var="VAR_pruned-folders"--></a>
4227 <li><a href="h_config_pruning_rule">OPTION: <!--#echo var="VAR_pruning-rule"--></a>
4228 <li><a href="h_config_quote_color">OPTION: Quote Colors</a>
4229 <li><a href="h_config_quote_replace_string">OPTION: <!--#echo var="VAR_quote-replace-string"--></a>
4230 <li><a href="h_config_quote_suppression">OPTION: <!--#echo var="VAR_quote-suppression-threshold"--></a>
4231 <li><a href="h_config_read_message_folder">OPTION: <!--#echo var="VAR_read-message-folder"--></a>
4232 <li><a href="h_config_remote_abook_history">OPTION: <!--#echo var="VAR_remote-abook-history"--></a>
4233 <li><a href="h_config_abook_metafile">OPTION: <!--#echo var="VAR_remote-abook-metafile"--></a>
4234 <li><a href="h_config_remote_abook_validity">OPTION: <!--#echo var="VAR_remote-abook-validity"--></a>
4235 <li><a href="h_config_reply_indent_string">OPTION: <!--#echo var="VAR_reply-indent-string"--></a>
4236 <li><a href="h_config_reply_intro">OPTION: <!--#echo var="VAR_reply-leadin"--></a>
4237 <li><a href="h_config_reverse_color">OPTION: Reverse Color</a>
4238 <li><a href="h_config_rshcmd">OPTION: <!--#echo var="VAR_rsh-command"--></a>
4239 <li><a href="h_config_rsh_open_timeo">OPTION: <!--#echo var="VAR_rsh-open-timeout"--></a>
4240 <li><a href="h_config_rshpath">OPTION: <!--#echo var="VAR_rsh-path"--></a>
4241 <li><a href="h_config_saved_msg_name_rule">OPTION: <!--#echo var="VAR_saved-msg-name-rule"--></a>
4242 <li><a href="h_config_scroll_margin">OPTION: <!--#echo var="VAR_scroll-margin"--></a>
4243 <li><a href="h_config_slctbl_color">OPTION: Selectable Item Color</a>
4244 <li><a href="h_config_sending_filter">OPTION: <!--#echo var="VAR_sending-filters"--></a>
4245 <li><a href="h_config_sendmail_path">OPTION: <!--#echo var="VAR_sendmail-path"--></a>
4246 <li><a href="h_config_signature_color">OPTION: Signature Color</a>
4247 <li><a href="h_config_signature_file">OPTION: <!--#echo var="VAR_signature-file"--></a>
4248 <li><a href="h_config_smtp_server">OPTION: <!--#echo var="VAR_smtp-server"--></a>
4249 <li><a href="h_config_sort_key">OPTION: <!--#echo var="VAR_sort-key"--></a>
4250 <li><a href="h_config_speller">OPTION: <!--#echo var="VAR_speller"--></a>
4251 <li><a href="h_config_aspell_dictionary">OPTION: <!--#echo var="VAR_aspell-dictionary-list"--></a>
4252 <li><a href="h_config_sshcmd">OPTION: <!--#echo var="VAR_ssh-command"--></a>
4253 <li><a href="h_config_ssh_open_timeo">OPTION: <!--#echo var="VAR_ssh-open-timeout"--></a>
4254 <li><a href="h_config_sshpath">OPTION: <!--#echo var="VAR_ssh-path"--></a>
4255 <li><a href="h_config_status_color">OPTION: Status Color</a>
4256 <li><a href="h_config_status_msg_delay">OPTION: <!--#echo var="VAR_status-message-delay"--></a>
4257 <li><a href="h_config_permlocked">OPTION: <!--#echo var="VAR_stay-open-folders"--></a>
4258 <li><a href="h_config_tcp_open_timeo">OPTION: <!--#echo var="VAR_tcp-open-timeout"--></a>
4259 <li><a href="h_config_tcp_query_timeo">OPTION: <!--#echo var="VAR_tcp-query-timeout"--></a>
4260 <li><a href="h_config_tcp_readwarn_timeo">OPTION: <!--#echo var="VAR_tcp-read-warning-timeout"--></a>
4261 <li><a href="h_config_tcp_writewarn_timeo">OPTION: <!--#echo var="VAR_tcp-write-warning-timeout"--></a>
4262 <li><a href="h_config_thread_disp_style">OPTION: <!--#echo var="VAR_threading-display-style"--></a>
4263 <li><a href="h_config_thread_exp_char">OPTION: <!--#echo var="VAR_threading-expanded-character"--></a>
4264 <li><a href="h_config_thread_index_style">OPTION: <!--#echo var="VAR_threading-index-style"--></a>
4265 <li><a href="h_config_thread_indicator_char">OPTION: <!--#echo var="VAR_threading-indicator-character"--></a>
4266 <li><a href="h_config_thread_lastreply_char">OPTION: <!--#echo var="VAR_threading-lastreply-character"--></a>
4267 <li><a href="h_config_title_color">OPTION: Title Color</a>
4268 <li><a href="h_config_titleclosed_color">OPTION: Title Closed Color</a>
4269 <li><a href="h_config_titlebar_color_style">OPTION: <!--#echo var="VAR_titlebar-color-style"--></a>
4270 <li><a href="h_config_unk_char_set">OPTION: <!--#echo var="VAR_unknown-character-set"--></a>
4271 <li><a href="h_config_upload_cmd">OPTION: <!--#echo var="VAR_upload-command"--></a>
4272 <li><a href="h_config_upload_prefix">OPTION: <!--#echo var="VAR_upload-command-prefix"--></a>
4273 <li><a href="h_config_browser">OPTION: <!--#echo var="VAR_url-viewers"--></a>
4274 <li><a href="h_config_history">OPTION: <!--#echo var="VAR_default-directories"--></a>
4275 <li><a href="h_config_domain_name">OPTION: <!--#echo var="VAR_use-only-domain-name"--></a>
4276 <li><a href="h_config_user_dom">OPTION: <!--#echo var="VAR_user-domain"--></a>
4277 <li><a href="h_config_user_id">OPTION: <!--#echo var="VAR_user-id"--></a>
4278 <li><a href="h_config_user_input_timeo">OPTION: <!--#echo var="VAR_user-input-timeout"--></a>
4279 <li><a href="h_config_viewer_headers">OPTION: <!--#echo var="VAR_viewer-hdrs"--></a>
4280 <li><a href="h_config_customhdr_pattern">OPTION: Viewer Header Color Pattern</a>
4281 <li><a href="h_config_customhdr_color">OPTION: <!--#echo var="VAR_viewer-hdr-colors"--></a>
4282 <li><a href="h_config_viewer_margin_left">OPTION: <!--#echo var="VAR_viewer-margin-left"--></a>
4283 <li><a href="h_config_viewer_margin_right">OPTION: <!--#echo var="VAR_viewer-margin-right"--></a>
4284 <li><a href="h_config_viewer_overlap">OPTION: <!--#echo var="VAR_viewer-overlap"--></a>
4285 <li><a href="h_config_window_position">OPTION: Window-Position</a>
4286 <li><a href="h_mainhelp_patterns">Patterns</a>
4287 <li><a href="h_config_role_abookfrom">PATTERNS: Address in Address Book</a>
4288 <li><a href="h_config_role_age">PATTERNS: Age Interval</a>
4289 <li><a href="h_config_role_alltextpat">PATTERNS: AllText Pattern</a>
4290 <li><a href="h_config_role_bom">PATTERNS: Beginning of Month</a>
4291 <li><a href="h_config_role_boy">PATTERNS: Beginning of Year</a>
4292 <li><a href="h_config_role_bodytextpat">PATTERNS: BodyText Pattern</a>
4293 <li><a href="h_config_role_cat_cmd">PATTERNS: Categorizer Command</a>
4294 <li><a href="h_config_role_cat_cmd_example">PATTERNS: Categorizer Command Example</a>
4295 <li><a href="h_config_role_ccpat">PATTERNS: Cc Pattern</a>
4296 <li><a href="h_config_role_cat_limit">PATTERNS: Character Limit</a>
4297 <li><a href="h_config_role_charsetpat">PATTERNS: Character Set Pattern</a>
4298 <li><a href="h_config_role_comment">PATTERNS: Comment</a>
4299 <li><a href="h_config_role_fldr_type">PATTERNS: Current Folder Type</a>
4300 <li><a href="h_config_role_cat_status">PATTERNS: Exit Status Interval</a>
4301 <li><a href="h_config_role_arbpat">PATTERNS: Extra Headers Pattern</a>
4302 <li><a href="h_config_role_frompat">PATTERNS: From Pattern</a>
4303 <li><a href="h_config_role_keywordpat">PATTERNS: Keyword Pattern</a>
4304 <li><a href="h_config_role_stat_ans">PATTERNS: Message Answered Status</a>
4305 <li><a href="h_config_role_stat_del">PATTERNS: Message Deleted Status</a>
4306 <li><a href="h_config_role_stat_imp">PATTERNS: Message Important Status</a>
4307 <li><a href="h_config_role_stat_new">PATTERNS: Message New Status</a>
4308 <li><a href="h_config_role_stat_recent">PATTERNS: Message Recent Status</a>
4309 <li><a href="h_config_role_newspat">PATTERNS: News Pattern</a>
4310 <li><a href="h_config_role_nick">PATTERNS: Nickname</a>
4311 <li><a href="h_config_role_particpat">PATTERNS: Participant Pattern</a>
4312 <li><a href="h_config_role_stat_8bitsubj">PATTERNS: Raw 8-bit in Subject</a>
4313 <li><a href="h_config_role_recippat">PATTERNS: Recipient Pattern</a>
4314 <li><a href="h_config_role_scorei">PATTERNS: Score Interval</a>
4315 <li><a href="h_config_role_senderpat">PATTERNS: Sender Pattern</a>
4316 <li><a href="h_config_role_size">PATTERNS: Size Interval</a>
4317 <li><a href="h_config_role_subjpat">PATTERNS: Subject Pattern</a>
4318 <li><a href="h_config_role_topat">PATTERNS: To Pattern</a>
4319 <li><a href="h_config_filt_opts_nonterm">PATTERNS FEATURE: Dont-Stop-Even-if-Rule-Matches</a>
4320 <li><a href="h_config_filt_opts_notdel">PATTERNS FEATURE: Move-Only-if-Not-Deleted</a>
4321 <li><a href="h_config_filt_opts_sentdate">PATTERNS FEATURE: Use-Date-Header-For-Age</a>
4322 <li><a href="h_config_filt_rule_type">PATTERNS FILTER ACTION: Filter Action</a>
4323 <li><a href="h_config_filter_kw_clr">PATTERNS FILTER ACTION: Clear These Keywords</a>
4324 <li><a href="h_config_filt_stat_ans">PATTERNS FILTER ACTION: Set Answered Status</a>
4325 <li><a href="h_config_filt_stat_del">PATTERNS FILTER ACTION: Set Deleted Status</a>
4326 <li><a href="h_config_filt_stat_imp">PATTERNS FILTER ACTION: Set Important Status</a>
4327 <li><a href="h_config_filt_stat_new">PATTERNS FILTER ACTION: Set New Status</a>
4328 <li><a href="h_config_filter_kw_set">PATTERNS FILTER ACTION: Set These Keywords</a>
4329 <li><a href="h_config_incol">PATTERNS INDEXCOLOR ACTION: Index Line Color</a>
4330 <li><a href="h_config_set_index_format">PATTERNS OTHER ACTION: Set Index Format</a>
4331 <li><a href="h_config_perfolder_sort">PATTERNS OTHER ACTION: Set Sort Order</a>
4332 <li><a href="h_config_other_startup">PATTERNS OTHER ACTION: Set Startup Rule</a>
4333 <li><a href="h_config_role_inick">PATTERNS ROLE ACTION: Initialize Values From Role</a>
4334 <li><a href="h_config_role_setfcc">PATTERNS ROLE ACTION: Set Fcc</a>
4335 <li><a href="h_config_role_setfrom">PATTERNS ROLE ACTION: Set From</a>
4336 <li><a href="h_config_role_setlitsig">PATTERNS ROLE ACTION: Set Literal Signature</a>
4337 <li><a href="h_config_role_setotherhdr">PATTERNS ROLE ACTION: Set Other Headers</a>
4338 <li><a href="h_config_role_setreplyto">PATTERNS ROLE ACTION: Set Reply-To</a>
4339 <li><a href="h_config_role_setsig">PATTERNS ROLE ACTION: Set Signature</a>
4340 <li><a href="h_config_role_settempl">PATTERNS ROLE ACTION: Set Template</a>
4341 <li><a href="h_config_role_usenntp">PATTERNS ROLE ACTION: Use NNTP Server</a>
4342 <li><a href="h_config_role_usesmtp">PATTERNS ROLE ACTION: Use SMTP Server</a>
4343 <li><a href="h_config_role_scoreval">PATTERNS SCORE ACTION: Score Value</a>
4344 <li><a href="h_config_role_scorehdrtok">PATTERNS SCORE ACTION: Score Value From Header</a>
4345 <li><a href="h_config_role_composeuse">PATTERNS USE: Compose Use</a>
4346 <li><a href="h_config_role_forwarduse">PATTERNS USE: Forward Use</a>
4347 <li><a href="h_config_role_replyuse">PATTERNS USE: Reply Use</a>
4348 <li><a href="h_pipe_command">Pipe Command SubOptions</a>
4349 <li><a href="h_common_pipe">Pipe Command</a>
4350 <li><a href="h_valid_folder_names">POP</a>
4351 <li><a href="h_common_postpone">Postpone Command</a>
4352 <li><a href="h_common_print">Print Command</a>
4353 <li><a href="h_mainhelp_readingnews">Reading News</a>
4354 <li><a href="h_news">RELEASE NOTES for Alpine</a>
4355 <li><a href="h_mainhelp_roles">Roles</a>
4356 <li><a href="h_role_select">ROLES SCREEN</a>
4357 <li><a href="h_compose_readfile">Read File Command</a>
4358 <li><a href="h_mainhelp_reading">Reading Messages</a>
4359 <li><a href="h_main_release_notes">Release Notes Command</a>
4360 <li><a href="h_common_reply">Reply and Forward Commands</a>
4361 <li><a href="h_compose_richhdr">Rich Header Command</a>
4362 <li><a href="h_common_role">Role Command</a>
4363 <li><a href="h_mainhelp_smime">S/MIME</a>
4364 <li><a href="h_index_cmd_select">Searching for Messages</a>
4365 <li><a href="h_address_display">SEARCH RESULTS INDEX</a>
4366 <li><a href="h_address_select">SEARCH RESULTS INDEX</a>
4367 <li><a href="h_simple_index">SELECT POSTPONED MESSAGE</a>
4368 <li><a href="h_abook_config">SETUP ADDRESS BOOKS SCREEN</a>
4369 <li><a href="h_collection_maint">SETUP COLLECTION LIST screen</a>
4370 <li><a href="h_color_setup">SETUP COLOR COMMANDS</a>
4371 <li><a href="h_direct_config">SETUP LDAP DIRECTORY SERVERS SCREEN</a>
4372 <li><a href="h_rules_roles">SETUP ROLES SCREEN</a>
4373 <li><a href="h_rules_incols">SETUP INDEX COLORS SCREEN</a>
4374 <li><a href="h_rules_filter">SETUP FILTERING SCREEN</a>
4375 <li><a href="h_rules_score">SETUP SCORING SCREEN</a>
4376 <li><a href="h_common_save">Save and Export Commands</a>
4377 <li><a href="h_mainhelp_securing">Securing Your Alpine Session</a>
4378 <li><a href="h_index_cmd_select">Selecting: Select and WhereIs/Select</a>
4379 <li><a href="h_compose_send">Send Command</a>
4380 <li><a href="h_folder_server_syntax">Server Name Syntax</a>
4381 <li><a href="h_main_setup">Setup Command</a>
4382 <li><a href="X-Alpine-Config:">Show Supported Options in this Alpine</a>
4383 <li><a href="h_composer_sigedit">Signature Editor Commands Explained</a>
4384 <li><a href="h_simple_text_view">Simple Text View Screen Explained</a>
4385 <li><a href="h_mainhelp_smime">S/MIME</a>
4386 <li><a href="h_config_smime_dont_do_smime">S/MIME FEATURE: <!--#echo var="FEAT_smime-dont-do-smime"--></a>
4387 <li><a href="h_config_smime_encrypt_by_default">S/MIME FEATURE: <!--#echo var="FEAT_smime-encrypt-by-default"--></a>
4388 <li><a href="h_config_smime_remember_passphrase">S/MIME FEATURE: <!--#echo var="FEAT_smime-remember-passphrase"--></a>
4389 <li><a href="h_config_smime_sign_by_default">S/MIME FEATURE: <!--#echo var="FEAT_smime-sign-by-default"--></a>
4390 <li><a href="h_config_smime_use_cert_store">S/MIME FEATURE: <!--#echo var="FEAT_smime-use-store-only"--></a>
4391 <li><a href="h_config_smime_pubcerts_in_keychain">S/MIME FEATURE: <!--#echo var="FEAT_publiccerts-in-keychain"--></a>
4392 <li><a href="h_config_smime_cacertcon">S/MIME OPTION: <!--#echo var="VAR_smime-cacert-container"--></a>
4393 <li><a href="h_config_smime_cacertdir">S/MIME OPTION: <!--#echo var="VAR_smime-cacert-directory"--></a>
4394 <li><a href="h_config_smime_privkeycon">S/MIME OPTION: <!--#echo var="VAR_smime-private-key-container"--></a>
4395 <li><a href="h_config_smime_privkeydir">S/MIME OPTION: <!--#echo var="VAR_smime-private-key-directory"--></a>
4396 <li><a href="h_config_smime_pubcertcon">S/MIME OPTION: <!--#echo var="VAR_smime-public-cert-container"--></a>
4397 <li><a href="h_config_smime_pubcertdir">S/MIME OPTION: <!--#echo var="VAR_smime-public-cert-directory"--></a>
4398 <li><a href="h_config_smime_transfer_cacert_to_con">S/MIME: Transfer CA Certs to Container</a>
4399 <li><a href="h_config_smime_transfer_cacert_to_dir">S/MIME: Transfer CA Certs to Directory</a>
4400 <li><a href="h_config_smime_transfer_priv_to_con">S/MIME: Transfer Private Keys to Container</a>
4401 <li><a href="h_config_smime_transfer_priv_to_dir">S/MIME: Transfer Private Keys to Directory</a>
4402 <li><a href="h_config_smime_transfer_pub_to_con">S/MIME: Transfer Public Certs to Container</a>
4403 <li><a href="h_config_smime_transfer_pub_to_dir">S/MIME: Transfer Public Certs to Directory</a>
4404 <li><a href="h_config_smime_public_certificates">S/MIME: Manage Public Certificates</a>
4405 <li><a href="h_config_smime_private_keys">S/MIME: Manage Private Keys</a>
4406 <li><a href="h_config_smime_certificate_authorities">S/MIME: Manage Certificate Authorities</a>
4407 <li><a href="h_index_cmd_sort">Sort Command</a>
4408 <li><a href="h_compose_spell">Spell Check Command</a>
4409 <li><a href="h_common_suspend">Suspend Command</a>
4410 <li><a href="h_compose_addrcomplete">THE MESSAGE COMPOSER'S ADDRESS COMPLETION</a>
4411 <li><a href="h_composer_attachment">THE MESSAGE COMPOSER'S ATTCHMNT FIELD</a>
4412 <li><a href="h_composer_bcc">THE MESSAGE COMPOSER'S BCC FIELD</a>
4413 <li><a href="h_composer_cc">THE MESSAGE COMPOSER'S CC FIELD</a>
4414 <li><a href="h_composer_from">THE MESSAGE COMPOSER'S FROM FIELD</a>
4415 <li><a href="h_composer_lcc">THE MESSAGE COMPOSER'S LCC FIELD</a>
4416 <li><a href="h_composer_news">THE MESSAGE COMPOSER'S NEWSGRPS LINE</a>
4417 <li><a href="h_composer_reply_to">THE MESSAGE COMPOSER'S REPLY-TO FIELD</a>
4418 <li><a href="h_composer_to">THE MESSAGE COMPOSER'S TO FIELD</a>
4419 <li><a href="h_abook_opened">THE ALPINE ADDRESS BOOK</a>
4420 <li><a href="h_abook_select_nicks_take">Take Address Nickname Selection Explained</a>
4421 <li><a href="h_takeaddr_screen">Take Address Screen Explained</a>
4422 <li><a href="h_common_take">TakeAddr Command</a>
4423 <li><a href="h_mainhelp_status">Titlebar Line</a>
4424 <li><a href="h_index_tokens">Tokens for Index and Replying</a>
4425 <li><a href="h_config_usenone_color">Use None Color</a>
4426 <li><a href="h_config_usenormal_color">Use Normal Color</a>
4427 <li><a href="h_config_usetransparent_color">Use Transparent Color</a>
4428 <li><a href="h_whatis_vcard">VCARD EXPLAINED</a>
4429 <li><a href="h_view_cmd_hilite">View Hilite and Next item/Previous item</a>
4430 <li><a href="h_view_cmd_viewattch">ViewAttch Command</a>
4431 <li><a href="h_index_cmd_whereis">WhereIs Command</a>
4432 <li><a href="h_view_cmd_whereis">WhereIs Command</a>
4433 <li><a href="h_index_cmd_zoom">ZoomMode Command</a>
4434 <li><a href="h_config_browser_xterm"><!--#echo var="VAR_url-viewers"--> and X windows applications</a>
4435 </UL>
4436
4437 <P>
4438 &lt;End of Help Index&gt;
4439 </BODY>
4440 </HTML>
4441
4442
4443 ============== h_config_remote_config =============
4444 <HTML>
4445 <HEAD>
4446 <TITLE>Remote Configuration</TITLE>
4447 </HEAD>
4448 <BODY>
4449 <H1>Remote Configuration</H1>
4450
4451 You may use the command line argument &quot;-p pinerc&quot; to tell
4452 Alpine to use a non-default configuration file.
4453 There are two types of storage for configuration information.
4454 <EM>Local</EM> configuration files are used by default.
4455 These are just regular files on the UNIX system or on the PC.
4456 The file &quot;<CODE>.pinerc</CODE>&quot; is the default for Unix Alpine and the
4457 file &quot;<CODE>PINERC</CODE>&quot; is the default for PC-Alpine.
4458 <EM>Remote</EM> configuration folders are stored on an IMAP server.
4459 The advantage of using a remote configuration is that the same information
4460 may be accessed from multiple platforms.
4461 For example, if you use one computer at work and another at home, the same
4462 configuration could be used from both places.
4463 A configuration change from one place would be seen in both places.
4464 To use a remote configuration you simply give a
4465 <A HREF="h_valid_folder_names">remote folder name</A>
4466 as the argument to the &quot;-p&quot; command line option.
4467 The command line might look something like:
4468 <P>
4469 <CENTER><SAMP>pine -p {my.imap.server}remote_pinerc</SAMP></CENTER>
4470 <P>
4471 If there are special characters in the command shell you use, you may need to
4472 quote the last argument (to protect the curly braces from the shell).
4473 The command might look like:
4474 <P>
4475 <CENTER><SAMP>pine -p &quot;{my.imap.server}remote_pinerc&quot;</SAMP></CENTER>
4476 <P>
4477 You should choose a folder name for a folder that does not yet exist.
4478 It will be created containing an empty configuration.
4479 Do not use a folder that you wish to store regular mail messages in.
4480 <P>
4481 The Setup/RemoteConfigSetup command will help you convert from a local
4482 configuration to a remote configuration.
4483 It will create a remote configuration for you and copy your current local
4484 configuration to it.
4485 It will also help you convert local address books into remote address books
4486 and local signature files into literal signatures contained in the
4487 remote configuration file.
4488 <P>
4489 If the Setup/RemoteConfigSetup command doesn't do what you want, you
4490 may copy a local pinerc file to a remote configuration folder by hand
4491 by using the command line option &quot;-copy_pinerc&quot;.
4492 <P>
4493 Another command line option, which is somewhat related to remote
4494 configuration, is the option &quot;-x exceptions_config&quot;.
4495 The configuration settings in the exceptions configuration override
4496 your default settings.
4497 It may be useful to store the default configuration (the -p argument) remotely
4498 and to have the exceptions configuration stored in a local file.
4499 You might put generic configuration information in the remote configuration
4500 and platform-specific configuration on each platform in the exceptions
4501 configuration.
4502 The arguments to the &quot;-p&quot; and &quot;-x&quot; options
4503 can be either remote folders or local files.
4504 <P>
4505 There is another command line argument that works only with PC-Alpine and
4506 which may prove useful when using a remote configuration.
4507 The option &quot;-aux local_directory&quot; allows you to tell PC-Alpine where
4508 to store your local auxiliary files.
4509 This only has an effect if your configuration file is remote.
4510 Some examples of auxiliary files are debug files, address book files, and
4511 signature files.
4512 <P>
4513 &lt;End of help on this topic&gt;
4514 </BODY>
4515 </HTML>
4516 ============== h_config_exceptions =============
4517 <HTML>
4518 <HEAD>
4519 <TITLE>Generic and Exceptional Configuration</TITLE>
4520 </HEAD>
4521 <BODY>
4522 <H1>Generic and Exceptional Configuration</H1>
4523
4524 If you use Alpine from more than one platform it may be convenient
4525 to split your configuration information into two pieces, a generic piece
4526 and exceptions that apply to a particular platform.
4527 For example, suppose you use Alpine from home and from work.
4528 Most of your configuration settings are probably the
4529 same in both locations, so those settings belong in the generic settings
4530 configuration.
4531 However, you may use a different SMTP server and INBOX
4532 from home than you do from work.
4533 The
4534 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>
4535 and
4536 <A HREF="h_config_inbox_path">&quot;<!--#echo var="VAR_inbox-path"-->&quot;</A>
4537 options could be
4538 part of your exceptional configuration so that they could be different in the
4539 two places.
4540 <P>
4541 The command line option &quot;-x exceptions_config&quot;
4542 may be used to split your configuration into generic and exceptional pieces.
4543 &quot;Exceptions_config&quot; may be either local or remote.
4544 The regular Alpine configuration file will contain the generic data, and
4545 &quot;exceptions_config&quot; will contain the exceptional data.
4546 <P>
4547 For Unix Alpine, if you don't have a &quot;-x&quot; command line option,
4548 Alpine will look for the file &quot;<CODE>.pinercex</CODE>&quot;
4549 in the same local directory that the regular config file is located in (usually
4550 the Unix home directory).
4551 If the regular config file is remote (because the command line option
4552 &quot;-p remote_config&quot; was used) then Unix Alpine looks in the Unix home
4553 directory for &quot;<CODE>.pinercex</CODE>&quot;.
4554 If the file does not already exist then no exceptions will be used.
4555 You can force exceptions to be used by using the &quot;-x&quot; option or
4556 by creating an empty &quot;<CODE>.pinercex</CODE>&quot; file.
4557 <P>
4558 For PC-Alpine, if you don't have a &quot;-x&quot; command line option,
4559 PC-Alpine will use the value of the
4560 environment variable <CODE>$PINERCEX</CODE>.
4561 If that is not set, PC-Alpine will look for
4562 the local file &quot;<CODE>PINERCEX</CODE>&quot;
4563 in the same local directory that the regular config file is located in.
4564 If the regular config file is remote (because the command line option
4565 &quot;-p remote_config&quot; was used) then PC-Alpine looks in the
4566 local directory specified by the &quot;-aux local_directory&quot; command
4567 line argument, or the directory <CODE>$HOME&#92;PINE</CODE>, or
4568 in the <CODE>&lt;PINE.EXE </CODE>directory<CODE>&gt;</CODE>.
4569 <P>
4570 When you have an exception configuration there is a new command
4571 in the Alpine Setup screen, Setup/eXceptions.
4572 It toggles between exceptions and the regular configuration.
4573 This is the usual way to make changes in your exceptional configuration data.
4574 For example, you would type &quot;S&quot; for Setup, &quot;X&quot; for
4575 eXception, then follow that with one of the Setup commands, like &quot;C&quot;
4576 for Config or &quot;K&quot; for Kolor.
4577 <P>
4578 For most people, splitting the configuration information into two pieces is
4579 going to be most useful if the generic information is accessed
4580 <A HREF="h_config_remote_config">remotely</A>).
4581 That data will be the same no matter where you access it from and if you
4582 change it that change will show up everywhere.
4583 The exceptional data will most commonly be in a local file, so that the
4584 contents may easily be different on each computing platform used.
4585 <P>
4586 If you already have a local configuration file with settings you like
4587 you may find that the command Setup/RemoteConfigSetup is useful
4588 in helping you convert to a remote configuration.
4589 The command line flag &quot;-copy_pinerc&quot;
4590 may also be useful.
4591 <P>
4592 &lt;End of help on this topic&gt;
4593 </BODY>
4594 </HTML>
4595 ============== h_config_inheritance =============
4596 <HTML>
4597 <HEAD>
4598 <TITLE>Configuration Inheritance</TITLE>
4599 </HEAD>
4600 <BODY>
4601 <H1>Configuration Inheritance</H1>
4602
4603 Configuration inheritance is a power user feature.
4604 It is confusing and not completely supported by the configuration
4605 user interface.
4606 We start with an explanation of how configuration works in hopes of making
4607 it easier to describe how inheritance works.
4608 <P>
4609 Alpine uses a hierarchy of configuration values from different locations.
4610 There are five ways in which each configuration option (configuration
4611 variable) can be set.
4612 In increasing order of precedence they are:
4613 <P>
4614 <OL>
4615 <LI> the system-wide configuration file.
4616
4617 <LI> the personal configuration file
4618
4619 <LI> the personal exceptions file
4620
4621 <LI> a command line argument
4622
4623 <LI> the system-wide <EM>fixed</EM> configuration file (Unix Alpine only)
4624 </OL>
4625 <P>
4626 The fixed configuration file is normally
4627 <CODE><!--#echo var="PINE_CONF_FIXED_PATH"--></CODE>.
4628 <P>
4629 The system-wide configuration file is normally
4630 <CODE><!--#echo var="PINE_CONF_PATH"--></CODE> for Unix Alpine and is normally not
4631 set for PC-Alpine.
4632 For PC-Alpine, if the environment variable <EM>$PINECONF</EM> is set, that
4633 is used for the system-wide configuration.
4634 This location can be set or changed on the command line with the -P flag.
4635 The system-wide configuration file can be either a local file or a
4636 remote configuration folder.
4637 <P>
4638 For Unix Alpine, the personal configuration file is normally the file
4639 <CODE>.pinerc</CODE> in the user's home directory.
4640 This can be changed with the -p command line flag.
4641 For PC-Alpine, the personal configuration file is in
4642 <CODE>$PINERC</CODE> or <CODE>&lt;AlpineRC registry value&gt;</CODE> or
4643 <CODE>$HOME&#92;PINE&#92;PINERC</CODE> or
4644 <CODE>&lt;PINE.EXE </CODE>dir<CODE>&gt;&#92;PINERC</CODE>.
4645 This can be changed with the -p command line flag.
4646 If -p is used, the configuration data may be in a local file or a remote config
4647 folder.
4648 <P>
4649 For Unix Alpine, the personal exceptions configuration file is named
4650 <CODE>.pinercex</CODE> and is in the same directory as the personal
4651 configuration file, if that configuration file is not remote, and is in
4652 the home directory if the personal configuration file is remote.
4653 If the file exists, then exceptions are turned on.
4654 If it doesn't, then you are not using exceptions.
4655 Alternatively, you may change the location of the exceptions configuration
4656 by using the command line argument &quot;-x &lt;exceptions_config&gt;&quot;.
4657 Like the personal configuration data, exceptions_config may be
4658 either local or remote.
4659 <P>
4660 For PC-Alpine, the personal exceptions configuration file is named
4661 <CODE>PINERCEX</CODE> and is in the same directory as the personal
4662 configuration file unless the personal configuration file is remote.
4663 In that case, it is in the local directory specfied by the
4664 &quot;-aux local_directory&quot; command line argument.
4665 (In the case that the personal configuration is remote and there is no
4666 &quot;-aux&quot; command line argument, Alpine searches for
4667 a PINERCEX file in the directory <CODE>$HOME&#92;PINE</CODE> and
4668 the directory <CODE>&lt;PINE.EXE </CODE>dir<CODE>&gt;</CODE>.)
4669 If the file exists, then exceptions are turned on.
4670 If it doesn't, then you are not using exceptions.
4671 You may change the location of the exceptions configuration
4672 by using the command line argument &quot;-x &lt;exceptions_config&gt;&quot;.
4673 or with the
4674 environment variable <CODE>$PINERCEX</CODE> (if there is no &quot;-x&quot;
4675 option).
4676 <P>
4677 To reiterate, the value of a configuration option is taken from the
4678 last location in the list above in which it is set.
4679 Or, thinking about it slightly differently, a default value for an option
4680 is established in the system-wide configuration file (or internally by Alpine
4681 if there is no value in the system-wide file).
4682 That default remains in effect until and unless it is overridden by a value in a
4683 location further down the list, in which case a new &quot;default&quot;
4684 value is established.
4685 As we continue down the list of locations we either retain the
4686 value at each step or establish a new value.
4687 The value that is still set after going through the whole list of
4688 configuration locations is the one that is used.
4689 <P>
4690 So, for example, if an option is set in the system-wide configuration
4691 file and in the personal configuration file, but is not set in the
4692 exceptions, on the command line, or in the fixed file; then the value
4693 from the personal configuration file is the one that is used.
4694 Or, if it is set in the system-wide config, in the personal config, not
4695 in the exceptions, but is set on the command line; then the value
4696 on the command line is used.
4697 <P>
4698 Finally we get to inheritance.
4699 For configuration options that are lists, like &quot;<!--#echo var="VAR_smtp-server"-->&quot; or
4700 &quot;<!--#echo var="VAR_incoming-folders"-->&quot;,
4701 the inheritance mechanism makes it possible to <EM>combine</EM>
4702 the values from different locations instead of <EM>replacing</EM> the value.
4703 This is true of all configuration lists other than the &quot;Feature-List&quot;,
4704 for which you may already set whatever you want at
4705 any configuration location (by using the &quot;no-&quot; prefix if
4706 necessary).
4707 <P>
4708 To use inheritance, set the first item in a configuration list to the
4709 token &quot;INHERIT&quot;, without the quotes.
4710 If the first item is &quot;INHERIT&quot;,
4711 then instead of replacing the default value established so far, the rest of
4712 the list is appended to the default value established so far and that is
4713 the new value.
4714 <P>
4715 Here is an example which may make it clearer. Suppose we have:
4716 <P>
4717 <PRE>
4718  System-wide config :   smtp-server = smtp1.corp.com, smtp2.corp.com
4719  Personal config    :   smtp-server = INHERIT, mysmtp.home
4720  Exceptions config  :   smtp-server = &lt;No Value Set&gt;
4721  Command line       :   smtp-server = &lt;No Value Set&gt;
4722  Fixed config       :   smtp-server = &lt;No Value Set&gt;
4723 </PRE>
4724 <P>
4725
4726 This would result in an effective smtp-server option of
4727 <P>
4728 <PRE>
4729  smtp-server = smtp1.corp.com, smtp2.corp.com, mysmtp.home
4730 </PRE>
4731 <P>
4732 The &quot;INHERIT&quot; token can be used in any of the configuration files
4733 and the effect cascades.
4734 For example, if we change the above example to:
4735 <P>
4736 <PRE>
4737  System-wide config :   smtp-server = smtp1.corp.com, smtp2.corp.com
4738  Personal config    :   smtp-server = INHERIT, mysmtp.home
4739  Exceptions config  :   smtp-server = INHERIT, yoursmtp.org
4740  Command line       :   smtp-server = &lt;No Value Set&gt;
4741  Fixed config       :   smtp-server = &lt;No Value Set&gt;
4742 </PRE>
4743 <P>
4744
4745 This would result in:
4746 <P>
4747 <PRE>
4748  smtp-server = smtp1.corp.com, smtp2.corp.com, mysmtp.home, yoursmtp.org
4749 </PRE>
4750 <P>
4751 Unset variables are skipped over (the default value is carried forward) so
4752 that, for example:
4753 <P>
4754 <PRE>
4755  System-wide config :   smtp-server = smtp1.corp.com, smtp2.corp.com
4756  Personal config    :   smtp-server = &lt;No Value Set&gt;
4757  Exceptions config  :   smtp-server = INHERIT, yoursmtp.org
4758  Command line       :   smtp-server = &lt;No Value Set&gt;
4759  Fixed config       :   smtp-server = &lt;No Value Set&gt;
4760 </PRE>
4761 <P>
4762
4763 produces:
4764 <P>
4765 <PRE>
4766  smtp-server = smtp1.corp.com, smtp2.corp.com, yoursmtp.org
4767 </PRE>
4768 <P>
4769
4770 If any later configuration location has a value set (for a particular list
4771 option) which does <EM>not</EM> begin with &quot;INHERIT&quot;,
4772 then that value replaces whatever value has been defined up to that point.
4773 In other words, that cancels out any previous inheritance.
4774 <P>
4775 <PRE>
4776  System-wide config :   smtp-server = smtp1.corp.com, smtp2.corp.com
4777  Personal config    :   smtp-server = INHERIT, mysmtp.org
4778  Exceptions config  :   smtp-server = yoursmtp.org
4779  Command line       :   smtp-server = &lt;No Value Set&gt;
4780  Fixed config       :   smtp-server = &lt;No Value Set&gt;
4781 </PRE>
4782 <P>
4783
4784 results in:
4785 <P>
4786 <PRE>
4787  smtp-server = yoursmtp.org
4788 </PRE>
4789 <P>
4790
4791 For some configuration options, like &quot;<!--#echo var="VAR_viewer-hdr-colors"-->&quot; or
4792 &quot;<!--#echo var="VAR_patterns-roles"-->&quot;, it is
4793 difficult to insert the value &quot;INHERIT&quot; into the list of values
4794 for the option using the normal Setup tools.
4795 In other words, the color setting screen (for example) does not
4796 provide a way to input the text &quot;INHERIT&quot; as the first
4797 item in the <!--#echo var="VAR_viewer-hdr-colors"--> option.
4798 The way to do this is to either edit the pinerc file directly and manually
4799 insert it, or turn
4800 on the <A HREF="h_config_expose_hidden_config"><!--#echo var="FEAT_expose-hidden-config"--></A>
4801 feature and insert it using the Setup/Config screen.
4802 <P>
4803 &lt;End of help on this topic&gt;
4804 </BODY>
4805 </HTML>
4806 ============== h_special_xon_xoff =============
4807 <HTML>
4808 <HEAD>
4809 <TITLE>Explanation of Alpine's XOFF/XON Handling</TITLE>
4810 </HEAD>
4811 <BODY>
4812 <H1>XOFF/XON Handling within Alpine</H1>
4813
4814 By default, Alpine treats Ctrl-S or Ctrl-Q (sometimes known as XOFF
4815 and XON) as normal characters, even though Alpine does not use them.
4816 However, the printer, modem, or communication software you are using may
4817 be configured for &quot;software flow control,&quot; which means that
4818 XON/XOFF must be treated as special characters by the operating system.
4819 If you see messages such as &quot;^S not defined for this screen&quot;,
4820 then your system is probably using software flow control. In this case
4821 you will need to set the
4822 <A HREF="h_config_preserve_start_stop">&quot;<!--#echo var="FEAT_preserve-start-stop-characters"-->&quot;</A>
4823 feature.
4824 <P>
4825 If you <EM>do</EM> set this
4826 feature, be advised that if you accidentally hit a Ctrl-S, Alpine will
4827 mysteriously freeze up with no warning.  In this case, try typing a Ctrl-Q
4828 and see if that puts things right.  Printing via the
4829 &quot;attached-to-ansi&quot; or
4830 &quot;attached-to-wyse&quot;
4831 option will automatically enable software
4832 flow-control handling for the duration of the printing.
4833 <P>
4834 &lt;End of help on this topic&gt;
4835 </BODY>
4836 </HTML>
4837 ============= h_special_help_nav =============
4838 <HTML>
4839 <HEAD>
4840 <TITLE>Help Text Navigation Explained</TITLE>
4841 </HEAD>
4842 <BODY>
4843 <H1>Help Text Navigation Explained</H1>
4844
4845 Alpine contains extensive context-sensitive help text.   At any point,
4846 pressing the &quot;?&quot; key will bring up a page of help text
4847 explaining the options available to you.  You can leave the help
4848 text screen and return to normal Alpine operation by pressing
4849 the
4850 <!--chtml if pinemode="function_key"-->
4851 F3 function
4852 <!--chtml else-->
4853 &quot;E&quot;
4854 <!--chtml endif-->
4855 key to Exit Help at any time.
4856
4857 <P>
4858 Within the help screen you might find a word or phrase displayed in
4859 inverse text and others displayed in bold typeface.  Such words and
4860 phrases are used to tell you Alpine has more information available on
4861 the topic they describe.
4862 The inverted text is the &quot;selected&quot; topic.
4863 Use the arrow keys, Ctrl-F, and Ctrl-B to change which of the phrases
4864 displayed in bold type
4865 is &quot;selected&quot;.
4866 Hit the Return key to display the information Alpine has available on that
4867 topic.  While viewing such additional information, the
4868 <!--chtml if pinemode="function_key"-->
4869 F3 function
4870 <!--chtml else-->
4871 &quot;P&quot;
4872 <!--chtml endif-->
4873 key will return you to the previous help screen, and the
4874 <!--chtml if pinemode="function_key"-->
4875 F2 function
4876 <!--chtml else-->
4877 &quot;E&quot;
4878 <!--chtml endif-->
4879 key will Exit the Help system altogether.
4880
4881 <P>
4882 The "N" command will tell you the internal name of the help text you are
4883 reading each time, so that you can send this name in the text of a message
4884 and create a direct link to that internal help using the x-pine-help URL
4885 scheme. For example, the direct link to this item is
4886 x-pine-help:h_special_help_nav. If you add this text to a message, then
4887 a person using Pine to read such message would have a direct link to this
4888 help text.
4889
4890 <P>
4891 When you are finished reading this help text, you can press the
4892 <!--chtml if pinemode="function_key"-->
4893 F3 function
4894 <!--chtml else-->
4895 &quot;P&quot;
4896 <!--chtml endif-->
4897 key to return to the previously displayed help text.
4898
4899 <P>
4900 &lt;End of help on this topic&gt;
4901 </BODY>
4902 </HTML>
4903 ============= h_special_list_commands =============
4904 <HTML>
4905 <HEAD>
4906 <TITLE>Email List Commands Explained</TITLE>
4907 </HEAD>
4908 <BODY>
4909 <H1>Email List Commands Explained</H1>
4910
4911 Electonic mail lists provide a way for like-minded users to join in
4912 discussions on topics of interest.  The email list itself is
4913 represented by a
4914 single address that participants send messages to when they have
4915 something of interest to share with other members of the list.  The
4916 receiving computer then, either automatically or after review by the
4917 list's owner (or moderator), sends a copy of that message to each
4918 member of the list.
4919
4920 <P>
4921 Usually, subscribing and unsubscribing is done by sending requests in
4922 an email message to a special address setup to handle managing list
4923 membership.  Often this is the name of the list followed by
4924 <I>-request</I>.  This address is almost <EM>never</EM> the same as
4925 the address used to send messages to the list.
4926
4927 <P>
4928 Unfortunately, email list participation commands are more a matter
4929 of convention than standard, and thus may vary from list to list.
4930 Increasingly, list management software is adding information to
4931 the copy of the postings as they're copied to the list members that
4932 explains how to do the various list management functions.
4933
4934 <P>
4935 Alpine will recognize this information and offer the management commands
4936 they represent in a simple display. One or more of the following
4937 operations will be made available:
4938
4939 <DL>
4940 <DT>Help</DT>
4941 <DD>
4942 A method to get help on subscribing, unsubscribing,
4943 an explanation of what the list is about, or special instructions
4944 for participation.  This may be in the form of a reply in response
4945 to an email message, or instructions on how to connect to a Web site.
4946 </DD>
4947
4948 <DT>Unsubscribe</DT>
4949 <DD>
4950 A method to get your email addressed removed from the list of
4951 recipients of the email list.
4952 </DD>
4953
4954 <DT>Subscribe</DT>
4955 <DD>
4956 A method to get your email address added to the list of recipients
4957 of the email list.  It may be in the form of a message sent to
4958 a special address or you may be connected to a web site.
4959 <DD>
4960 </DD>
4961
4962 <DT>Post</DT>
4963 <DD>
4964 A method used to post to the email list.  However, it might also
4965 indicate that no posting is allowed directly to the list.
4966 </DD>
4967
4968 <DT>Owner</DT>
4969 <DD>
4970 A method to contact the list owner for special questions you might
4971 have regarding the list.
4972 </DD>
4973
4974 <DT>Archive</DT>
4975 <DD>
4976 A method to view an archive of previous messages posted to the list.
4977 This may be in the form of a mail folder on a remote computer, an
4978 IMAP mailbox or even a Web site.
4979 </DD>
4980 </DL>
4981
4982 <P>
4983 &lt;End of help on this topic&gt;
4984 </BODY>
4985 </HTML>
4986 ============= h_quota_command =============
4987 <HTML>
4988 <HEAD>
4989 <TITLE>Quota Screen Explained</TITLE>
4990 </HEAD>
4991 <BODY>
4992 <H1>Quota Screen Explained</H1>
4993
4994 <P> This screen summarizes the quota report for this mailbox in the
4995 IMAP server. For each resource that you have a quota, this reports summarizes
4996 its use and limit.
4997
4998 <P> Your IMAP server administrator may have set a quota based either on
4999 the total size of your mailbox (STORAGE), or the number of messages in
5000 your mailbox (MESSAGES), or some other criteria. This will be reported
5001 to you indicating the type of quota, its total use and its limit.
5002
5003 <P> The report for STORAGE is reported in kibibytes (KiB). One kibibyte is
5004 1024 bytes. Each of the characters that you see in this help text is one
5005 byte, and this help text is about 1 kibibyte in size. Small messages sent
5006 by Alpine are normally less than 4 kibibytes in size (which includes
5007 headers and text). Other email programs may send messages with bigger
5008 sizes when they send messages, since they send plain text and an
5009 alternative part in HTML.
5010
5011 <P> A convenient way to save space for the STORAGE type of quota is by
5012 deleting attachments. This is done on each individual message by pressing
5013 the &quot;V&quot; command while reading the message text, then moving the cursor
5014 to the position of the attachment that is to be deleted, then pressing
5015 &quot;D&quot; to delete such attachment, going back to reading the
5016 message with the &quot;&lt;&quot; command and pressing &quot;S&quot; to
5017 save the message in the same folder you are reading from. The saved
5018 message will not have the attachment that was marked deleted. Now you
5019 can delete and expunge the message with the unwanted attachment.
5020
5021 <P>
5022 &lt;End of help on this topic&gt;
5023 </BODY>
5024 </HTML>
5025 ============= h_mail_thread_index =============
5026 <HTML>
5027 <HEAD>
5028 <TITLE>THREAD INDEX COMMANDS</TITLE>
5029 </HEAD>
5030 <BODY>
5031 <H1>THREAD INDEX COMMANDS</H1>
5032 <!--chtml if pinemode="function_key"-->
5033 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>
5034 -------------------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;-----------------------------<BR>
5035 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>
5036 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>
5037 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>
5038 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>
5039 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>
5040 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>
5041 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>
5042 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>
5043 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>
5044 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>
5045 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>
5046 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>
5047 <BR>
5048 Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;3<BR>
5049 -----------------------------<BR>
5050 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>
5051 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>
5052 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>
5053 <BR>
5054 Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;4<BR>
5055 -----------------------------<BR>
5056 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
5057 F6&nbsp;&nbsp;<A HREF="h_common_role">Compose&nbsp;using&nbsp;a&nbsp;role</A><BR>
5058 <BR>
5059 <!--chtml else-->
5060 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>
5061 -------------------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;---------------------------------<BR>
5062 &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>
5063 &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>
5064 &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>
5065 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>
5066 &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>
5067 &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>
5068 &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>
5069 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>
5070 &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>
5071 <BR>
5072 Miscellaneous&nbsp;Operations&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;General&nbsp;Alpine&nbsp;Commands<BR>
5073 ------------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;---------------------<BR>
5074 &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>
5075 &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>
5076 &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>
5077 &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>
5078 &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>
5079 &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>
5080 &nbsp;:&nbsp;&nbsp;&nbsp;Select&nbsp;Messages&nbsp;in&nbsp;Current&nbsp;Thread<BR>
5081 <!--chtml endif-->
5082 <P>
5083
5084 NOTE:
5085 <OL>
5086  <LI>For help on a particular command, highlight the bold text associated
5087 with it above and hit Return.
5088  <LI>Availability of certain commands depends on <A HREF="h_common_conditional_cmds">feature settings</A>.
5089 </OL>
5090
5091 <H2>Description of the THREAD INDEX Screen</H2>
5092
5093 The THREAD INDEX displays summary information from each
5094 thread (conversation) in the current folder.
5095 This is useful if you want to quickly
5096 scan new threads, or find a particular thread without having to go
5097 through the text of each message, or to quickly get rid of junk
5098 threads, etc.
5099 The current thread is always highlighted.
5100 Each line of the THREAD INDEX contains the following columns: <P>
5101 <DL>
5102  <DT>STATUS:</DT>
5103  <DD> The markings on the left side of the thread tell you about its
5104 status.  You may see one or more of the following codes on any given
5105 thread:
5106 <UL>
5107   <LI> &quot;D&quot; for Deleted. All of the messages in this thread are marked for deletion but not yet eXpunged from the folder.
5108   <LI> &quot;A&quot; for Answered. All of the messages in this thread are marked answered.
5109   <LI> &quot;N&quot; for New. At least one message in the thread is New (you haven't looked at it yet).
5110   <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.
5111   <LI> &quot;-&quot; for cc-to-you. The &quot;-&quot; indicates that a
5112         message in the thread was sent to you as a cc:. This symbol will only show up if
5113         the feature
5114         &quot;<A HREF="h_config_mark_for_cc"><!--#echo var="FEAT_mark-for-cc"--></A>&quot; is turned on (which is the default).
5115   <LI> &quot;X&quot; for selected.  You have selected at least one message in the thread by using the
5116         &quot;select&quot; command.  (Some systems may optionally allow selected
5117         messages to be denoted by the index line being displayed in bold
5118         type instead.)
5119   <LI> &quot;*&quot; for Important.  You have previously used the &quot;Flag&quot; command
5120       to mark at least one message in this thread as &quot;important&quot;.
5121 </UL></DD><P>
5122
5123  <DT>THREAD NUMBER:</DT>
5124  <DD>Threads in a folder are numbered, from one through the number
5125 of threads in the folder, to help you know where you are in the folder.
5126 </DD><P>
5127
5128  <DT>DATE STARTED:</DT>
5129  <DD>The date the thread was started. This is actually from the Date header
5130 of the first message in the thread. It doesn't take different time zones
5131 into account.</DD><P>
5132
5133  <DT>WHO STARTED THE THREAD:</DT>
5134  <DD>This is usually the name of the sender of the first message in the thread, taken from
5135 the From header of the message.
5136 If there is no personal name given in that
5137 address, then the email address is used instead.
5138 If the message is from you (or from one of your
5139 <A HREF="h_config_alt_addresses">alternate addresses</A>),
5140 then the recipient's name is shown here instead, with the characters
5141 &quot;To: &quot; inserted before the name.
5142 (The idea of this is that if you started the thread you would rather see who
5143 the mail was sent to instead of that the mail was from you.)
5144 In Newsgroups, if you are
5145 the sender and there are no email recipients, the newsgroup name will be
5146 listed after the &quot;To: &quot;.
5147 </DD><P>
5148
5149  <DT>SIZE:</DT>
5150  <DD>The number in parentheses is the number of messages in the thread.</DD><P>
5151
5152  <DT>SUBJECT:</DT>
5153  <DD>As much of the thread's subject line as will fit on the screen.
5154 This is the subject of the first message in the thread.</DD>
5155 </DL>
5156
5157 <P><UL>
5158 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
5159 </UL>
5160 <P>
5161 &lt;End of help on this topic&gt;
5162 </BODY>
5163 </HTML>
5164 ============= h_mail_index =============
5165 <HTML>
5166 <HEAD>
5167 <TITLE>MESSAGE INDEX COMMANDS</TITLE>
5168 </HEAD>
5169 <BODY>
5170 <H1>MESSAGE INDEX COMMANDS</H1>
5171 <!--chtml if pinemode="function_key"-->
5172 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>
5173 -------------------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;-----------------------------<BR>
5174 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>
5175 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>
5176 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>
5177 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>
5178 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>
5179 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>
5180 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>
5181 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>
5182 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>
5183 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>
5184 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>
5185 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>
5186 <BR>
5187 Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;3<BR>
5188 -----------------------------<BR>
5189 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>
5190 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>
5191 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>
5192 <BR>
5193 Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;4<BR>
5194 -----------------------------<BR>
5195 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
5196 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>
5197 <BR>
5198 <!--chtml else-->
5199 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>
5200 -------------------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;---------------------------------<BR>
5201 &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>
5202 &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>
5203 &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>
5204 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>
5205 &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>
5206 &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>
5207 &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>
5208 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>
5209 &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>
5210 Miscellaneous&nbsp;Operations<BR>
5211 ------------------------<BR>
5212 &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>
5213 &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>
5214 &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>
5215 &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>
5216 &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>
5217 &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>
5218 &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>
5219 &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>
5220 <!--chtml endif-->
5221 <P>
5222
5223 NOTE:
5224 <OL>
5225  <LI>For help on a particular command, highlight the bold text associated
5226 with it above and hit Return.
5227  <LI>Availability of certain commands depends on <A HREF="h_common_conditional_cmds">feature settings</A>.
5228 </OL>
5229
5230 <H2>Description of the MESSAGE INDEX Screen</H2>
5231
5232 The MESSAGE INDEX displays summary information from each
5233 message in the current folder.
5234 This is useful if you want to quickly
5235 scan new messages, or find a particular message without having to go
5236 through the text of each message, or to quickly get rid of junk
5237 messages, etc.
5238 <P>
5239 The current message is always highlighted
5240 and many commands operate on the current message.
5241 For example, the Delete command will delete the current message.
5242 If the folder is sorted by either Threads or OrderedSubject, then, depending
5243 on some of your configuration settings, a single line in the index may
5244 refer to an entire thread or to a subthread.
5245 If that is the case, then the commands that normally operate on the current
5246 message will operate on the thread or subthread instead.
5247 For example, the Delete command will delete the whole collapsed thread
5248 instead of just a single message.
5249 <P>
5250 Each line of the MESSAGE INDEX contains the following columns (by default --
5251 you can change this with the
5252 &quot;<A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A>&quot; option
5253 in the SETUP CONFIGURATION screen): <P>
5254 <DL>
5255  <DT>STATUS:</DT>
5256  <DD> The markings on the left side of the message tell you about its
5257 status.  You may see one or more of the following codes on any given
5258 message:
5259 <UL>
5260   <LI> &quot;D&quot; for Deleted.  You have marked this message for deletion but not
5261          yet eXpunged the folder.
5262   <LI> &quot;N&quot; for New.  You have not looked at the text of the message yet.
5263   <LI> &quot;A&quot; for Answered.  Any time you reply to a message it is considered
5264          to be answered.
5265   <LI> &quot;F&quot; for Forwarded.  Similar to Answered, this is set whenever you
5266          forward a message.
5267   <LI> &quot;+&quot; for direct-to-you.  The &quot;+&quot; indicates that a message was sent
5268         directly to your account, your copy is not part of a cc: or a
5269         mailing list.
5270   <LI> &quot;-&quot; for cc-to-you. The &quot;-&quot; indicates that a
5271         message was sent to you as a cc:. This symbol will only show up if
5272         the feature
5273         &quot;<A HREF="h_config_mark_for_cc"><!--#echo var="FEAT_mark-for-cc"--></A>&quot; is turned on (which is the default).
5274   <LI> &quot;X&quot; for selected.  You have selected the message by using the
5275         &quot;select&quot; command.  (Some systems may optionally allow selected
5276         messages to be denoted by the index line being displayed in bold
5277         type.)
5278   <LI> &quot;*&quot; for Important.  You have previously used the &quot;Flag&quot; command
5279       to mark this message as &quot;important&quot;.
5280 </UL></DD><P>
5281
5282  <DT>MESSAGE NUMBER:</DT>
5283  <DD>Messages in a folder are numbered, from one through the number
5284 of messages in the folder, to help you know where you are in the folder.
5285 These numbers are always in increasing order, even if you sort the folder
5286 in a different way.</DD><P>
5287
5288  <DT>DATE SENT:</DT>
5289  <DD>The date the message was sent.  By default, messages are
5290 ordered by arrival time, not by date sent.  Most of the time, arrival time
5291 and date sent (effectively departure time) are similar.  Sometimes,
5292 however, the index will appear to be out of order because a message took a
5293 long time in delivery or because the sender is in a different time
5294 zone than you are. This date is just the date from the Date header
5295 field in the message.</DD><P>
5296
5297  <DT>WHO SENT THE MESSAGE:</DT>
5298  <DD>This is usually the name of the sender of the message, taken from
5299 the From header of the message.
5300 If there is no personal name given in that
5301 address, then the email address is used instead.
5302 If the message is from you (or from one of your
5303 <A HREF="h_config_alt_addresses">alternate addresses</A>),
5304 then the recipient's name is shown here instead, with the characters
5305 &quot;To: &quot; inserted before the name.
5306 (The idea of this is that if you sent the mail you would rather see who
5307 the mail was sent to instead of that the mail was from you.
5308 This behavior may be changed by modifying the <!--#echo var="VAR_index-format"--> option mentioned
5309 above.
5310 In particular, use the FROM token or the FROMORTONOTNEWS token
5311 in place of the FROMORTO token.)
5312 In Newsgroups, if you are
5313 the sender and there are no email recipients, the newsgroup name will be
5314 listed after the &quot;To: &quot;. </DD><P>
5315
5316  <DT>SIZE:</DT>
5317  <DD>The number in parentheses is the number of characters in the message.
5318 It may have a suffix of K, M, or G which means the number should be
5319 multiplied by one thousand, one million, or one billion to get the
5320 size of the message.</DD><P>
5321
5322  <DT>SUBJECT:</DT>
5323  <DD>As much of the message's subject line as will fit on the screen.</DD>
5324 </DL>
5325
5326 <P><UL>
5327 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
5328 </UL>
5329 <P>
5330 &lt;End of help on this topic&gt;
5331 </BODY>
5332 </HTML>
5333 ============= h_mail_view ========================
5334 <HTML>
5335 <HEAD>
5336 <TITLE>MESSAGE TEXT SCREEN</TITLE>
5337 </HEAD>
5338 <BODY>
5339 <H1>MESSAGE TEXT SCREEN</H1>
5340 <!--chtml if pinemode="function_key"-->
5341 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>
5342 -------------------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;------------------------------<BR>
5343 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>
5344 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>
5345 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>
5346 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>
5347 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>
5348 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>
5349 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>
5350 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>
5351 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>
5352 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>
5353 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>
5354 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>
5355 <BR>
5356 Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;3<BR>
5357 ------------------------------<BR>
5358 F1&nbsp;&nbsp;Show&nbsp;Help&nbsp;Text<BR>
5359 F2&nbsp;&nbsp;Toggle&nbsp;to&nbsp;see&nbsp;more&nbsp;commands<BR>
5360 F3&nbsp;&nbsp;<A HREF="h_view_cmd_hilite">View&nbsp;hilited</A><BR>
5361 F4&nbsp;&nbsp;Select&nbsp;current&nbsp;message<BR>
5362 F5&nbsp;&nbsp;Previous&nbsp;selectable&nbsp;item<BR>
5363 F6&nbsp;&nbsp;Next&nbsp;selectable&nbsp;item<BR>
5364 F7&nbsp;&nbsp;<A HREF="h_common_jump">Jump</A>&nbsp;to&nbsp;message&nbsp;number<BR>
5365 F8&nbsp;&nbsp;<A HREF="h_common_nextnew">Next&nbsp;new</A>&nbsp;message<BR>
5366 F9&nbsp;&nbsp;<A HREF="h_common_hdrmode">Display&nbsp;full&nbsp;headers</A><BR>
5367 F10&nbsp;<A HREF="h_common_bounce">Bounce</A>&nbsp;message<BR>
5368 F11&nbsp;<A HREF="h_common_flag">Flag</A>&nbsp;message<BR>
5369 F12&nbsp;<A HREF="h_common_pipe">Pipe</A>&nbsp;to&nbsp;a&nbsp;Unix&nbsp;command<BR>
5370 Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;4<BR>
5371 F5&nbsp;&nbsp;<A HREF="h_common_role">Compose using a role</A><BR>
5372 <!--chtml else-->
5373 Operations&nbsp;on&nbsp;the&nbsp;Current&nbsp;Message<BR>
5374 ---------------------------------<BR>
5375 <BR>
5376 &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>
5377 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>
5378 &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>
5379 &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>
5380 &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>
5381 &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>
5382 &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>
5383 &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>
5384 &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>
5385 <BR>
5386 Navigating&nbsp;the&nbsp;List&nbsp;of&nbsp;Messages&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Other&nbsp;Commands<BR>
5387 -------------------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;----------------------------<BR>
5388 &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>
5389 &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>
5390 &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>
5391 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>
5392 <BR>
5393 General&nbsp;Alpine&nbsp;Commands<BR>
5394 ---------------------<BR>
5395 &nbsp;O&nbsp;&nbsp;Show&nbsp;all&nbsp;other&nbsp;available&nbsp;commands<BR>
5396 &nbsp;?&nbsp;&nbsp;Show&nbsp;Help&nbsp;text&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Q&nbsp;Quit&nbsp;Alpine<BR>
5397 &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>
5398 &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>
5399 &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>
5400 <!--chtml endif-->
5401 <P>
5402
5403 NOTE:
5404 <OL>
5405  <LI>For help on a particular command, highlight the bold text associated
5406 with it above and hit Return.
5407  <LI>Availability of certain commands depends on <A HREF="h_common_conditional_cmds">feature settings</A>.
5408 </OL>
5409
5410 <H2>Description of the MESSAGE TEXT Screen</H2>
5411
5412 The top line of the view message screen displays status
5413 information about the currently open collection and folder and about the
5414 current message.  It shows the name of the collection in angle brackets
5415 and then the name of the folder.  The line also displays the number
5416 of messages in the folder, the number of the current message and the
5417 percentage of the current message that has been displayed on the screen.
5418 If the message is marked for deletion &quot;DEL&quot; will appear in the upper
5419 right corner.
5420 If the message has been answered (but not deleted) &quot;ANS&quot; will show
5421 in the corner.
5422 <P>
5423
5424 NOTE: to rapidly move to the end of a message, hit the
5425 <!--chtml if pinemode="function_key"-->F8<!--chtml else-->W<!--chtml endif-->
5426 (or Ctrl-W) key followed
5427 by Ctrl-V.  Similarly,
5428 <!--chtml if pinemode="function_key"-->F8<!--chtml else-->W<!--chtml endif-->
5429 followed by Ctrl-Y will take you to the beginning of
5430 a message.
5431
5432 <H2>Explanation of Alternate Character Sets</H2>
5433
5434 Alpine attempts to stay out of the way so that it won't prevent you from
5435 viewing mail in any character set.  It will simply send the message to
5436 your display device.  If the device is capable of displaying the
5437 message as it was written it will do so.  If not, the display may be
5438 partially or totally incorrect.
5439 If the message contains characters that are not representable in your
5440 <A HREF="h_config_char_set">&quot;Display Character Set&quot;</A>
5441 variable in your configuration, then a warning message will be printed
5442 to your screen at the beginning of the message display.
5443 It is probably best to use UNIX Alpine in a terminal emulator
5444 capable of displaying UTF-8 characters.
5445 See <A HREF="h_config_char_set">Display Character Set</A> for a little
5446 more information about character set settings.
5447
5448 <P><UL>
5449 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
5450 </UL>
5451 <P>
5452 &lt;End of help on this topic&gt;
5453 </BODY>
5454 </HTML>
5455 ======= h_index_cmd_select =======
5456 <HTML>
5457 <HEAD>
5458 <TITLE>Selecting: Select and WhereIs/Select</TITLE>
5459 </HEAD>
5460 <BODY>
5461 <H1>Selecting: Select and WhereIs/Select</H1>
5462
5463 Aggregate operations give you the ability to process a group of messages
5464 at once.  Acting on multiple messages requires two steps: (1) selecting a
5465 set of messages and then; (2) applying a command to that set. The first
5466 part is handled by the select command.  Select allows you to
5467 select messages based on their status (read, answered, etc.), contents,
5468 date, size, or keywords.
5469 You may also select based on one of your Rules or based on threads,
5470 and there are quick options to select a specific message or range of messages,
5471 to select the current message, or to select all messages.
5472 <P>
5473
5474 We describe the various selection criteria briefly:
5475 <P>
5476
5477 <DL>
5478 <DT>select All</DT>
5479 <DD> Marks all the messages in the folder as selected.
5480 </DD>
5481
5482 <DT>select Cur</DT>
5483 <DD> Selects the currently highlighted message or currently highlighted
5484 set of messages if in a threaded view.
5485 </DD>
5486
5487 <DT>select by Number</DT>
5488 <DD> Select by message number. This may be a comma-separated list instead or
5489 a single entry.
5490 Each element in the list may be either a single message number or a range
5491 of numbers with a dash between the lowest and highest member of the range.
5492 Some examples are 7 to select only message number 7; 2-5 to select messages
5493 2 through 5; and 2-5,7-9,11 to select messages 2, 3, 4, 5, 7, 8, 9, and 11.
5494 The word &quot;end&quot; or the character &quot;$&quot; may be used as a
5495 substitute for the highest numbered message in the folder, while the
5496 character &quot;.&quot; represents the message number holding the position
5497 of the cursor in the folder.
5498 If in a separate thread index where the numbers refer to threads instead of
5499 to messages, then you will be selecting all of the messages in the
5500 referenced threads instead of selecting by message number.
5501 </DD>
5502
5503 <DT>select by Date</DT>
5504 <DD> Select by either the date stored in the Date headers of each message,
5505 or by the date when the messages arrived.
5506 This does not adjust for different time zones, but just checks to see what
5507 day the message was sent on.
5508 You may type in a date. If you do, the date should be in the form
5509 <P><SAMP><CENTER>DD-Mon-YYYY</CENTER></SAMP><P>
5510 For example,
5511 <P><SAMP><CENTER>24-Nov-2004</CENTER></SAMP><P>
5512 or
5513 <P><SAMP><CENTER>09-Nov-2004</CENTER></SAMP><P>
5514 If the date you want is close to the current date, it is probably
5515 easier to use the &quot;^P&nbsp;Prev Day&quot; or &quot;^N&nbsp;Next Day&quot; commands to change the default date that
5516 is displayed, instead of typing in the date yourself.
5517 Or, the &quot;^X&nbsp;Cur Msg&quot; command may be used to fill in
5518 the date of the currently highlighted message.
5519 <P>
5520 There are six possible settings that are selected using the
5521 &quot;^W&nbsp;Toggle When&quot; command.
5522 Three of them select messages based on the Date headers.
5523 They are &quot;SENT SINCE&quot;, &quot;SENT BEFORE&quot;,
5524 and &quot;SENT ON&quot;.
5525 SINCE is all messages with the selected date or later.
5526 BEFORE is all messages earlier than the selected date (not including the day
5527 itself).
5528 ON is all messages sent on the selected date.
5529 The other three select messages in the same way but they use the arrival
5530 times of the messages instead of the Date headers included in the messages.
5531 Those three are &quot;ARRIVED SINCE&quot;, &quot;ARRIVED BEFORE&quot;,
5532 and &quot;ARRIVED ON&quot;.
5533 When you save a message from one folder to another the arrival time is
5534 preserved.
5535 </DD>
5536
5537 <DT>select by Text</DT>
5538 <DD> Selects messages based on the message contents.
5539 This allows you to select a set of messages based on whether or not the
5540 message headers or message body contain specified text.
5541 You may look for text in the Subject, the From header,
5542 the To header, or the Cc header.
5543 You may also choose Recipient, which searches for the text in
5544 either the To or the Cc header;
5545 or Participant, which means To or Cc or From.
5546 Besides those specific header searches, you may also search the entire
5547 header and text of the message with &quot;All Text&quot;, or just the
5548 body of the message.
5549 <P>
5550 To search for the absence of text, first type the &quot;! Not&quot; command
5551 before typing the specific type of text search.
5552 For example, you could type &quot;!&quot; followed by &quot;S&quot; to
5553 search for all messages that do not contain a particular word in their
5554 Subjects.
5555 <P>
5556 If you choose a Subject search, you may use the subject from the current
5557 message by typing the &quot;^X Cur Subject&quot; command.
5558 You may then edit it further if you wish.
5559 For example, you might select the subject of a reply and edit the
5560 &quot;Re:&nbsp;&quot; off of the front of it in order to search for
5561 the original message being replied to.
5562 All of the other header searches allow you to use addresses from the
5563 headers of the current message if you want to.
5564 You may use the &quot;^T Cur To&quot;, &quot;^R Cur From&quot;, or
5565 &quot;^W Cur Cc&quot;.
5566 In each case, if there is more than one address, only the first is offered.
5567 </DD>
5568
5569 <DT>select by Status</DT>
5570 <DD> Selects messages based on their status.
5571 You may select all New, Important, Deleted, Answered, Recent, or Unseen
5572 messages.
5573 Or, if you first type the &quot;! Not&quot; command, you get not New,
5574 or not Important, and so on.
5575 If you select Deleted messages, you will get all messages with their
5576 Deleted flag set.
5577 Likewise for Important messages, all messages that you have flagged as
5578 being Important with the
5579 <A HREF="h_common_flag">Flag</A> command.
5580 The &quot;New&quot; and &quot;Answered&quot; choices are a little bit odd
5581 because they try to match what you see on the screen by default.
5582 &quot;New&quot; is a shorthand for messages that are Unseen, Undeleted,
5583 and Unanswered.
5584 If you have looked at the message, or deleted it, or answered it; then it
5585 is not considered &quot;New &quot;.
5586 &quot;!&nbsp;New&quot; is the opposite of &quot;New&quot;.
5587 <P>
5588 &quot;Answered&quot; is another one that is a little different.
5589 It means that the message has been Answered <EM>and</EM> is not deleted.
5590 And to make it even more confusing, &quot;!&nbsp;Answered&quot; is not
5591 the opposite of &quot;Answered&quot;!
5592 Instead, &quot;!&nbsp;Answered&quot; stands for messages that are
5593 both Unanswered <EM>and</EM> not deleted.
5594 <P>
5595 The other two types were added later because the special nature of the
5596 New flag was not what was wanted by all users.
5597 New does match what you see in the index by default, but if you use
5598 the IMAPSTATUS or SHORTIMAPSTATUS token in the
5599 &quot;<A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A>&quot; it may not
5600 be exactly what you want.
5601 &quot;Unseen&quot; simply selects all unseen messages, whether or not
5602 they are deleted or answered, and
5603 &quot;Recent&quot; selects all of the messages that have been added to
5604 the folder since you started this Alpine session.
5605 (That's not technically quite true. If there are multiple mail clients
5606 reading an IMAP mailbox, each message will be marked as Recent in only
5607 one of the client's sessions.)
5608 </DD>
5609
5610 <DT>select by siZe</DT>
5611 <DD> Selects messages based on their size being smaller than or larger
5612 than the size you specify.
5613 The size is the number of bytes.
5614 You may use the suffix &quot;K&quot; or &quot;k&quot; to mean 1,000 times
5615 the number.
5616 For example, 7K is the same as 7000.
5617 The suffix &quot;M&quot; or &quot;m&quot; means 1,000,000 times the number,
5618 and the suffix &quot;G&quot; or &quot;g&quot; means 1,000,000,000 times.
5619 Use the &quot;^W&quot; command to toggle back and forth between Smaller
5620 and Larger.
5621 </DD>
5622
5623 <DT>select by Keyword</DT>
5624 <DD> Selects messages that either have or do not have
5625 (using the &quot;!&nbsp;Not&quot; command)
5626 a particular <A HREF="h_config_keywords">Keyword</A> set.
5627 One way to select a keyword is to use the &quot;^T&nbsp;To&nbsp;List&quot;
5628 command to select one from your list of keywords.
5629 The
5630 <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.
5631 </DD>
5632
5633 <DT>select by Rule</DT>
5634 <DD> Selects messages that either match or don't match
5635 (using the &quot;!&nbsp;Not&quot; command)
5636 one of the Rules you have defined.
5637 The most likely method of filling in the Rule is to use the
5638 &quot;^T&nbsp;To&nbsp;List&quot;
5639 command to select one of your Rules.
5640 All of the Rules you have defined will be in the list, including
5641 Rules for Searching, Indexcolors, Filtering, Roles, Score setting, and Other.
5642 They may not all make sense for this purpose, but they are all there for
5643 flexibility.
5644 You might find it useful to define some rules solely for the purpose
5645 of being used by the Select command.
5646 There is a special category for such Rules. They are called Search Rules.
5647 <P>
5648 Unfortunately, Alpine does not allow all possible Rules to be defined.
5649 For example, there is no logical OR operation.
5650 OR is accomplished in the Filter Rules or the other types of Rules by
5651 simply defining two rules, one that matches the first part of the OR
5652 and another that matches the second part.
5653 But you can't do that here, since you only have a single Rule to work with.
5654 Likewise, the order of Rules is usually important.
5655 For example, if the first Filter Rule (or Indexcolor rule or ...) matches
5656 a message, then that stops the search for a further match.
5657 This means that you may be confused if you try to use Select by Rule to
5658 check your Filter rules because the order is important when filtering but
5659 is not considered here.
5660 </DD>
5661
5662 <DT>select by tHread</DT>
5663 <DD> Selects all of the messages in the current thread.
5664 </DD>
5665 </DL>
5666
5667 After you have an initial selection, the next and subsequent selection
5668 commands modify the selection.
5669 The select command changes. It first gives
5670 you selection &quot;alteration&quot; options: &quot;unselect All&quot;,
5671 &quot;unselect Current&quot;,
5672 &quot;Broaden selection&quot; (implements a logical OR), and
5673 &quot;Narrow selection&quot; (implements a logical AND).
5674 After you choose either Broaden or Narrow, you then choose one of the
5675 selection criteria listed above (by Text or Number or ...).
5676 You may use select as many times as you wish to get the selected set right.
5677 <P>
5678
5679 The WhereIs command has a feature (Ctrl-X) to
5680 select all the messages that match the WhereIs search. WhereIs searches
5681 through just the text that appears on the MESSAGE INDEX screen.
5682 This method is often slower than using the select command itself, unless the
5683 line you are looking for is not too far away in the index.
5684 <P>
5685
5686 The availability of the aggregate operations commands is determined by the
5687 <A HREF="h_config_enable_agg_ops">&quot;<!--#echo var="FEAT_enable-aggregate-command-set"-->&quot;</A>
5688 Feature-List option in your Alpine
5689 configuration, which defaults to set.
5690 The features
5691 <A HREF="h_config_auto_zoom">&quot;<!--#echo var="FEAT_auto-zoom-after-select"-->&quot;</A>
5692 and
5693 <A HREF="h_config_select_wo_confirm">&quot;<!--#echo var="FEAT_select-without-confirm"-->&quot;</A>
5694 affect the behavior of the Select command.
5695
5696 <P>
5697 &lt;End of help on this topic&gt;
5698 </BODY>
5699 </HTML>
5700 ======= h_select_rule =======
5701 <HTML>
5702 <HEAD>
5703 <TITLE>Select: Rule</TITLE>
5704 </HEAD>
5705 <BODY>
5706 <H1>Select: Rule</H1>
5707
5708 You are selecting messages that either match or don't match
5709 one of the Rules you have defined.
5710 You may either type the nickname of the Rule at the prompt, or use the
5711 &quot;^T&nbsp;To&nbsp;List&quot;
5712 command to select one of your Rules.
5713 All of the Rules you have defined will be in the list, including
5714 Rules for Indexcolors, Filtering, Roles, Score setting, and Other.
5715 They may not all make sense for this purpose, but they are all there for
5716 flexibility.
5717 Rules may be added by using the Setup/Rules screen off of the main Alpine
5718 menu.
5719 <P>
5720 Unfortunately, Alpine does not allow all possible Rules to be defined.
5721 For example, there is no logical OR operation.
5722 OR is accomplished in the Filter Rules or the other types of Rules by
5723 simply defining two rules, one that matches the first part of the OR
5724 and another that matches the second part.
5725 But you can't do that here, since you only have a single Rule to work with.
5726 Likewise, the order of Rules is usually important.
5727 For example, if the first Filter Rule (or Indexcolor rule or ...) matches
5728 a message, then that stops the search for a further match.
5729 This means that you may be confused if you try to use Select by Rule to
5730 check your Filter rules because the order is important when filtering but
5731 is not considered here.
5732
5733 <P>
5734 &lt;End of help on this topic&gt;
5735 </BODY>
5736 </HTML>
5737 ======= h_select_text =======
5738 <HTML>
5739 <HEAD>
5740 <TITLE>Select: Text</TITLE>
5741 </HEAD>
5742 <BODY>
5743 <H1>Select: Text</H1>
5744
5745 You are selecting messages based on the contents of the message.
5746 This allows you to select a set of messages based on whether or not the
5747 message headers or message body contain specified text.
5748 You may look for text in the Subject, the From header,
5749 the To header, or the Cc header.
5750 You may also choose Recipient, which searches for the text in
5751 either the To or the Cc header;
5752 or Participant, which means either the To header, or the Cc header,
5753 or the From header.
5754 Besides those specific header searches, you may also search the entire
5755 header and text of the message with &quot;All Text&quot;, or just the
5756 body of the message with &quot;Body&quot;.
5757 <P>
5758 To search for the absence of text, first type the &quot;!&nbsp;Not&quot; command
5759 before typing the specific type of text search.
5760 For example, you could type &quot;!&quot; followed by &quot;S&quot; to
5761 search for all messages that do not contain a particular word in their
5762 Subjects.
5763 <P>
5764 If you choose a Subject search, you may use the subject from the current
5765 message by typing the &quot;^X Cur Subject&quot; command.
5766 You may then edit it further if you wish.
5767 For example, you might select the subject of a reply and edit the
5768 &quot;Re:&nbsp;&quot; off of the front of it in order to search for
5769 the original message being replied to.
5770 All of the other header searches allow you to use addresses from the
5771 headers of the current message if you want to.
5772 You may use the &quot;^T Cur To&quot;, &quot;^R Cur From&quot;, or
5773 &quot;^W Cur Cc&quot;.
5774 In each case, if there is more than one address, only the first is offered.
5775
5776 <P>
5777 &lt;End of help on this topic&gt;
5778 </BODY>
5779 </HTML>
5780 ======= h_select_status =======
5781 <HTML>
5782 <HEAD>
5783 <TITLE>Select: Status</TITLE>
5784 </HEAD>
5785 <BODY>
5786 <H1>Select: Status</H1>
5787
5788 You are selecting messages based on the status of the message.
5789 For example, whether or not the message has been marked Deleted or Important,
5790 or whether or not it has been Answered or is New.
5791 If you first type the &quot;!&nbsp;Not&quot; command, you will get the
5792 opposite: not Deleted, not Important, and so on.
5793 <P>
5794 If you select Deleted messages, you will get all messages with their
5795 Deleted flag set.
5796 Likewise for Important messages, all messages that you have flagged as
5797 being Important with the
5798 <A HREF="h_common_flag">Flag</A> command.
5799 The &quot;New&quot; and &quot;Answered&quot; choices are a little bit odd
5800 because they try to match what you see on the screen by default.
5801 &quot;New&quot; is a shorthand for messages that are Unseen, Undeleted,
5802 and Unanswered.
5803 If you have looked at the message, or deleted it, or answered it; then it
5804 is not considered &quot;New &quot;.
5805 &quot;!&nbsp;New&quot; is the opposite of &quot;New&quot;.
5806 <P>
5807 &quot;Answered&quot; is another one that is a little different.
5808 It means that the message has been Answered <EM>and</EM> is not deleted.
5809 And to make it even more confusing, &quot;!&nbsp;Answered&quot; is not
5810 the opposite of &quot;Answered&quot;!
5811 Instead, &quot;!&nbsp;Answered&quot; stands for messages that are
5812 both Unanswered <EM>and</EM> not deleted.
5813 <P>
5814 (The New and Answered options may seem counter-intuitive.
5815 The reason it is done this way is
5816 because, by default, a Deleted message will show up with the &quot;D&quot;
5817 symbol in the MAIL INDEX screen even if it is New or Answered.
5818 The Delete symbol overrides the New and Answered symbols, because you
5819 usually don't care about the message anymore once you've deleted it.
5820 Similarly, you usually only care about whether a message is Answered or
5821 not if it is not Deleted.
5822 Once it is Deleted you've put it out of your mind.)
5823 <P>
5824 The other two options were added later because the special nature of the
5825 New flag was not what was wanted by all users.
5826 New does match what you see in the index by default, but if you use
5827 the IMAPSTATUS or SHORTIMAPSTATUS token in the
5828 &quot;<A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A>&quot; it may not
5829 be exactly what you expect.
5830 &quot;Unseen&quot; simply selects all unseen messages, whether or not
5831 they are deleted or answered, and
5832 &quot;Recent&quot; selects all of the messages that have been added to
5833 the folder since you started this Alpine session.
5834 (That's not technically quite true. If there are multiple mail clients
5835 reading an IMAP mailbox, each message will be marked as Recent in only
5836 one of the client's sessions.
5837 That behavior can be convenienent for some purposes, like filtering, but
5838 it isn't usually what you expect when selecting.)
5839
5840 <P>
5841 &lt;End of help on this topic&gt;
5842 </BODY>
5843 </HTML>
5844 ======= h_index_cmd_apply =======
5845 <HTML>
5846 <HEAD>
5847 <TITLE>Apply Command</TITLE>
5848 </HEAD>
5849 <BODY>
5850 <H1>Apply Command</H1>
5851
5852 Apply
5853 (<!--chtml if pinemode="function_key"-->F6<!--chtml else-->A<!--chtml endif-->)
5854 is the second step of most aggregate operations.  Apply
5855 becomes active any time there is a defined set of selected messages.  The
5856 following commands can be applied to a selected message set: delete,
5857 undelete, reply, forward,
5858 <!--chtml if pinemode="os_windows"-->
5859 <!--chtml else-->
5860 pipe,
5861 <!--chtml endif-->
5862 print, take address, save, export, bounce, and flag.
5863 <P>
5864
5865 The behavior of some of these commands in an aggregate sense is not easy to
5866 explain.  Try them out to see what they do.
5867 The feature
5868 <A HREF="h_config_auto_unzoom">&quot;<!--#echo var="FEAT_auto-unzoom-after-apply"-->&quot;</A>
5869 affects the behavior of the Apply command, as does the feature
5870 <A HREF="h_config_auto_unselect">&quot;<!--#echo var="FEAT_auto-unselect-after-apply"-->&quot;</A>.
5871
5872 <P>
5873 &lt;End of help on this topic&gt;
5874 </BODY>
5875 </HTML>
5876 ======= h_index_cmd_zoom =======
5877 <HTML>
5878 <HEAD>
5879 <TITLE>ZoomMode Command</TITLE>
5880 </HEAD>
5881 <BODY>
5882 <H1>ZoomMode Command</H1>
5883
5884 Another action you might want to take on a set of selected messages is to
5885 zoom in on them.  Like apply, zoom only becomes active when messages have
5886 been selected.
5887 ZoomMode
5888 (<!--chtml if pinemode="function_key"-->F3<!--chtml else-->Z<!--chtml endif-->)
5889 is a toggle command that allows you to
5890 zoom-in (and only see the selected messages) and zoom-out (to see all
5891 messages in the folder).  Neither apply nor zoom removes the markings that
5892 define the selected set; you need to use a select command in order
5893 to do that.
5894
5895 <P>
5896 &lt;End of help on this topic&gt;
5897 </BODY>
5898 </HTML>
5899 ======= h_index_collapse_expand =======
5900 <HTML>
5901 <HEAD>
5902 <TITLE>Collapse/Expand Command</TITLE>
5903 </HEAD>
5904 <BODY>
5905 <H1>Collapse/Expand Command</H1>
5906
5907 The Collapse/Expand command is only available from the MESSAGE INDEX screen when
5908 the folder is sorted by either Threads or OrderedSubject, and the
5909 <A HREF="h_config_thread_disp_style"><!--#echo var="VAR_threading-display-style"--></A>
5910 is set to something other than &quot;none&quot;.
5911 By default, this command collapses or expands the subthread that starts at
5912 the currently highlighted message, if any.
5913 If the subthread is already collapsed, then this command expands it.
5914 If the subthread is expanded, then this command collapses it.
5915 If there are no more messages below the current message in the
5916 thread tree (that is, there are no replies to the current message) then
5917 this command does nothing.
5918
5919 <P>
5920 The behavior of this command is affected by the option
5921 <A HREF="h_config_slash_coll_entire">&quot;<!--#echo var="FEAT_slash-collapses-entire-thread"-->&quot;</A>.
5922 Normally, this command Collapses or Expands the subthread that
5923 starts at the currently highlighted message.
5924 If the above option is set, then this command Collapses or Expands the
5925 entire current thread instead of just the subthread.
5926 The current thread is simply the top-level thread that contains the
5927 current message.
5928
5929 <P>
5930 &lt;End of help on this topic&gt;
5931 </BODY>
5932 </HTML>
5933 ======= h_index_cmd_sort =======
5934 <HTML>
5935 <HEAD>
5936 <TITLE>Sort Command</TITLE>
5937 </HEAD>
5938 <BODY>
5939 <H1>Sort Command</H1>
5940
5941 In Alpine's generic configuration, messages are presented in the order in
5942 which they arrive.  This default can be changed in the SETUP CONFIGURATION
5943 with the &quot;<A HREF="h_config_sort_key"><!--#echo var="VAR_sort-key"--></A>&quot; option.
5944 You can also re-sort the folder on demand with the sort
5945 (<!--chtml if pinemode="function_key"-->F7<!--chtml else-->$<!--chtml endif-->)
5946 command.
5947 Your sorting options are:
5948 <P>
5949 <UL>
5950  <LI> <A HREF="h_index_sort_arrival">A</A>rrival
5951  <LI> <A HREF="h_index_sort_date">D</A>ate
5952  <LI> <A HREF="h_index_sort_subj">S</A>ubject
5953  <LI> <A HREF="h_index_sort_ordsubj">O</A>rderedSubject
5954  <LI> t<A HREF="h_index_sort_thread">H</A>read
5955  <LI> <A HREF="h_index_sort_from">F</A>rom
5956  <LI> si<A HREF="h_index_sort_size">Z</A>e
5957  <LI> scor<A HREF="h_index_sort_score">E</A>,
5958  <LI> <A HREF="h_index_sort_to">T</A>o
5959  <LI> <A HREF="h_index_sort_cc">C</A>c
5960 </UL>
5961
5962 <P>
5963 The Reverse option will toggle the order the index is currently
5964 sorted by, but will not change the relative sort order.
5965
5966 <P>
5967 Sorting a folder does not actually rearrange the way the folder is saved,
5968 it just re-arranges how the messages are presented to you.  This means
5969 that Alpine has to do the work of sorting every time you change sort order.
5970 Sometimes, especially with PC-Alpine or with large folders, this could take
5971 a while.
5972
5973 <P>
5974 &lt;End of help on this topic&gt;
5975 </BODY>
5976 </HTML>
5977 ======= h_index_sort_default =======
5978 <HTML>
5979 <HEAD>
5980 <TITLE>SORT OPTION: Default</TITLE>
5981 </HEAD>
5982 <BODY>
5983 <H1>SORT OPTION: Default</H1>
5984
5985 The <EM>Default</EM> sort option just means to use the default sort order
5986 set in the
5987 <li><a href="h_config_sort_key"><!--#echo var="VAR_sort-key"--></a>
5988 option in Setup/Config.
5989
5990 <P>
5991 &lt;End of help on this topic&gt;
5992 </BODY>
5993 </HTML>
5994 ======= h_index_sort_arrival =======
5995 <HTML>
5996 <HEAD>
5997 <TITLE>SORT OPTION: Arrival</TITLE>
5998 </HEAD>
5999 <BODY>
6000 <H1>SORT OPTION: Arrival</H1>
6001
6002 The <EM>Arrival</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX
6003 in the order that they exist in the folder.  This is usually the same as the
6004 order in which they arrived.  This option is comparable to not sorting
6005 the messages at all.
6006
6007 <P>
6008 &lt;End of help on this topic&gt;
6009 </BODY>
6010 </HTML>
6011 ======= h_index_sort_date =======
6012 <HTML>
6013 <HEAD>
6014 <TITLE>SORT OPTION: Date</TITLE>
6015 </HEAD>
6016 <BODY>
6017 <H1>SORT OPTION: Date</H1>
6018
6019 The <EM>Date</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX
6020 according to the date and time they were
6021 sent.
6022
6023 <P>
6024 On a folder like INBOX, sorting by &quot;Date&quot; should be almost
6025 identical to sorting by &quot;Arrival&quot;.
6026
6027 <P>
6028 &lt;End of help on this topic&gt;
6029 </BODY>
6030 </HTML>
6031 ======= h_index_sort_subj =======
6032 <HTML>
6033 <HEAD>
6034 <TITLE>SORT OPTION: Subject</TITLE>
6035 </HEAD>
6036 <BODY>
6037 <H1>SORT OPTION: Subject</H1>
6038
6039 The <EM>Subject</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX
6040 by subject.
6041
6042 <P>
6043 Messages with the same subject are
6044 first grouped together, and then the groups of like-subject messages
6045 are arranged alphabetically.
6046
6047 <P>
6048 Alpine ignores leading &quot;Re:&quot; and
6049 &quot;re:&quot; and trailing &quot;(fwd)&quot; when determining the
6050 likeness and alphabetical order of subject lines.
6051
6052 <P>
6053 &lt;End of help on this topic&gt;
6054 </BODY>
6055 </HTML>
6056 ======= h_index_sort_ordsubj =======
6057 <HTML>
6058 <HEAD>
6059 <TITLE>SORT OPTION: OrderedSubject</TITLE>
6060 </HEAD>
6061 <BODY>
6062 <H1>SORT OPTION: OrderedSubject</H1>
6063
6064 The <EM>OrderedSubject</EM> sort option arranges messages in the
6065 MESSAGE&nbsp;INDEX by grouping all messages with the same subject
6066 together, similar to sort by <A HREF="h_index_sort_subj">S</A>ubject.
6067
6068 <P>
6069 However, <EM>OrderedSubj</EM> then arranges the groups of like-subject
6070 messages by the date of the oldest message in the group.
6071
6072 <P>
6073 This sort method provides for pseudo threading of conversations within
6074 a folder.
6075 You may want to try sorting by Thread instead.
6076
6077 <P>
6078 &lt;End of help on this topic&gt;
6079 </BODY>
6080 </HTML>
6081 ======= h_index_sort_thread =======
6082 <HTML>
6083 <HEAD>
6084 <TITLE>SORT OPTION: Thread</TITLE>
6085 </HEAD>
6086 <BODY>
6087 <H1>SORT OPTION: Thread</H1>
6088
6089 The <EM>Thread</EM> sort option arranges messages in the
6090 MESSAGE&nbsp;INDEX by grouping all messages that indicate
6091 they are part of a conversation (discussion thread) taking
6092 place within a mailbox or newsgroup.  This indication is
6093 based on information in the message's header -- specifically
6094 its <tt>References:</tt>, <tt>Message-ID:</tt>, and <tt>Subject:</tt> fields.
6095
6096 <P>
6097 &lt;End of help on this topic&gt;
6098 </BODY>
6099 </HTML>
6100 ======= h_index_sort_from =======
6101 <HTML>
6102 <HEAD>
6103 <TITLE>SORT OPTION: From</TITLE>
6104 </HEAD>
6105 <BODY>
6106 <H1>SORT OPTION: From</H1>
6107
6108 The <EM>From</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX
6109 by the name of the author of the message.
6110
6111 <P>
6112 Messages with the same author are grouped together. Groups of
6113 messages are then put into alphabetical order according to message
6114 author.
6115
6116 <P>
6117 &lt;End of help on this topic&gt;
6118 </BODY>
6119 </HTML>
6120 ======= h_index_sort_size =======
6121 <HTML>
6122 <HEAD>
6123 <TITLE>SORT OPTION: Size</TITLE>
6124 </HEAD>
6125 <BODY>
6126 <H1>SORT OPTION: Size</H1>
6127
6128 The <EM>Size</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX
6129 by their relative sizes.
6130
6131 <P>
6132 &lt;End of help on this topic&gt;
6133 </BODY>
6134 </HTML>
6135 ======= h_index_sort_score =======
6136 <HTML>
6137 <HEAD>
6138 <TITLE>SORT OPTION: Score</TITLE>
6139 </HEAD>
6140 <BODY>
6141 <H1>SORT OPTION: Score</H1>
6142
6143 The <EM>Score</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX
6144 by their scores.
6145
6146 <P>
6147 Messages with the same score are sorted in arrival order.
6148 Scores are something you create using the
6149 <A HREF="h_rules_score">&quot;SETUP SCORING&quot;</A> screen.
6150
6151 <P>
6152 &lt;End of help on this topic&gt;
6153 </BODY>
6154 </HTML>
6155 ======= h_index_sort_to =======
6156 <HTML>
6157 <HEAD>
6158 <TITLE>SORT OPTION: To</TITLE>
6159 </HEAD>
6160 <BODY>
6161 <H1>SORT OPTION: To</H1>
6162
6163 The <EM>To</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX
6164 by the names of the recipients of the message.
6165
6166 <P>
6167 Messages with the same recipients are grouped together. Groups of
6168 messages are then put into alphabetical order according to message
6169 recipients.
6170
6171 <P>
6172 &lt;End of help on this topic&gt;
6173 </BODY>
6174 </HTML>
6175 ======= h_index_sort_cc =======
6176 <HTML>
6177 <HEAD>
6178 <TITLE>SORT OPTION: Cc</TITLE>
6179 </HEAD>
6180 <BODY>
6181 <H1>SORT OPTION: Cc</H1>
6182
6183 The <EM>Cc</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX by
6184 the names of the carbon copy addresses of the message.
6185
6186 <P>
6187 &lt;End of help on this topic&gt;
6188 </BODY>
6189 </HTML>
6190 ======= h_index_cmd_whereis =======
6191 <HTML>
6192 <HEAD>
6193 <TITLE>WhereIs Command</TITLE>
6194 </HEAD>
6195 <BODY>
6196 <H1>WhereIs Command</H1>
6197
6198 The WhereIs
6199 (<!--chtml if pinemode="function_key"-->F8<!--chtml else-->W<!--chtml endif-->)
6200 command lets you search the MESSAGE INDEX for a word.
6201 It scans through whatever you see, usually the name of the author
6202 and the Subject line.
6203 WhereIs has special subcommands to let you find the beginning of the
6204 index (Ctrl-Y -- first message)
6205 or the end of the index (Ctrl-V -- last message).
6206 <P>
6207 Note that WhereIs only searches through the visible text on the screen.
6208 For example, if only part of the Subject of a message is shown because it
6209 is long, then only the visible portion of the Subject is searched.
6210 Also note that WhereIs does not &quot;see&quot; the
6211 &quot;X&quot; in column one of Index entries for selected messages
6212 so it can't be used to search for
6213 selected messages (use &quot;Zoom&quot; instead).
6214 <P>
6215 If the feature
6216 <A HREF="h_config_enable_agg_ops">&quot;<!--#echo var="FEAT_enable-aggregate-command-set"-->&quot;</A>
6217 is turned on,
6218 WhereIs can also be used as a quick way to select messages that match the
6219 string being searched for.
6220 Instead of typing carriage return to search for the next match, type
6221 Ctrl-X to select all matches.
6222 Once again, this only selects matches that are (or would be if the right
6223 index line was on the screen) visible.
6224 Truncated From lines or Subjects will cause matches to be missed.
6225 Although WhereIs is sometimes convenient for quick matching, the Select
6226 command is usually more powerful and usually faster.
6227
6228 <P>
6229 &lt;End of help on this topic&gt;
6230 </BODY>
6231 </HTML>
6232 ======= h_view_cmd_whereis =======
6233 <HTML>
6234 <HEAD>
6235 <TITLE>WhereIs Command</TITLE>
6236 </HEAD>
6237 <BODY>
6238 <H1>WhereIs Command</H1>
6239
6240 The WhereIs
6241 (<!--chtml if pinemode="function_key"-->F8<!--chtml else-->W<!--chtml endif-->)
6242 command does a &quot;find in current message&quot; operation.  You
6243 type in text and Alpine will try to find it in the message you are
6244 reading.  WhereIs also has subcommands to jump to the beginning (Ctrl-Y)
6245 or end (Ctrl-V) of the message.
6246 That is, to rapidly move to the end of a message, hit the
6247 <!--chtml if pinemode="function_key"-->F8<!--chtml else-->W<!--chtml endif-->
6248 (or Ctrl-W) key followed
6249 by Ctrl-V.  Similarly,
6250 <!--chtml if pinemode="function_key"-->F8<!--chtml else-->W<!--chtml endif-->
6251 followed by Ctrl-Y will take you to the beginning of a message.
6252
6253 <P>
6254 &lt;End of help on this topic&gt;
6255 </BODY>
6256 </HTML>
6257 ======= h_view_cmd_hilite =======
6258 <HTML>
6259 <HEAD>
6260 <TITLE>View Hilite and Next item/Previous item</TITLE>
6261 </HEAD>
6262 <BODY>
6263 <H1>View Hilite and Next item/Previous item</H1>
6264
6265 Sometimes messages may be in the form of formatted HTML text
6266 or they may contain URLs or Web server hostnames.
6267 When any of the features
6268 <A HREF="h_config_enable_view_url">&quot;<!--#echo var="FEAT_enable-msg-view-urls"-->&quot;</A>,
6269 <A HREF="h_config_enable_view_web_host">&quot;<!--#echo var="FEAT_enable-msg-view-web-hostnames"-->&quot;</A>,
6270 <A HREF="h_config_enable_view_attach">&quot;<!--#echo var="FEAT_enable-msg-view-attachments"-->&quot;</A>,
6271 or
6272 <A HREF="h_config_enable_view_addresses">&quot;<!--#echo var="FEAT_enable-msg-view-addresses"-->&quot;</A>
6273 are enabled, Alpine will represent such selectable items in the text
6274 in bold typeface.  One of the selectable items will be displayed in
6275 inverse video (highlighted).  This is the &quot;currently selected&quot; item.
6276 Press the Return key to view the currently selected item.
6277 <P>
6278
6279 The Up and Down Arrows keys can be used to change the selected item
6280 (also see the feature
6281 <A HREF="h_config_enable_view_arrows">&quot;<!--#echo var="FEAT_enable-msg-view-forced-arrows"-->&quot;</A>).
6282 If there are no selectable items in the direction of the arrow you
6283 pressed, Alpine will scroll the display in that direction until one
6284 becomes visible.  To &quot;jump&quot; forwards/backwards among selectable
6285 items in the message text, use the Previous and Next item commands,
6286 <!--chtml if pinemode="function_key"-->F5 and F6
6287 <!--chtml else-->^B and ^F<!--chtml endif-->.
6288
6289 <P>
6290 &lt;End of help on this topic&gt;
6291 </BODY>
6292 </HTML>
6293 ======= h_view_cmd_viewattch =======
6294 <HTML>
6295 <HEAD>
6296 <TITLE>ViewAttch Command</TITLE>
6297 </HEAD>
6298 <BODY>
6299 <H1>ViewAttch Command</H1>
6300
6301
6302 The View/Save Attachment
6303 (<!--chtml if pinemode="function_key"-->F4<!--chtml else-->V<!--chtml endif-->)
6304 command allows you to handle MIME attachments to a message you have
6305 received.  Alpine shows you a list of the message attachments -- you just
6306 choose the attachment you want.  You may either view or save the
6307 selected attachment.
6308
6309 <P>
6310 Because many attachments require external programs for display, there
6311 is some system configuration that has to happen before you can
6312 actually display attachments.  Hopefully much of that will have been
6313 done already by your system administrator.  MIME configuration is
6314 handled with the &quot;mailcap&quot; configuration file.  (See the section
6315 on configuration in the
6316 <A HREF="h_news">release notes</A> for more information.)
6317
6318 <P>
6319 &lt;End of help on this topic&gt;
6320 </BODY>
6321 </HTML>
6322 ======= h_index_cmd_expunge =======
6323 <HTML>
6324 <HEAD>
6325 <TITLE>Expunge/Exclude Command</TITLE>
6326 </HEAD>
6327 <BODY>
6328 <H1>Expunge/Exclude Command</H1>
6329
6330 Expunge/Exclude
6331 (<!--chtml if pinemode="function_key"-->F3<!--chtml else-->X<!--chtml endif-->)
6332 is the command Alpine uses to actually remove all messages
6333 marked for deletion.  With regular email files, expunge literally deletes
6334 the text from the current folder.  With newsgroups or shared mailboxes,
6335 you don't have permission to actually remove the message, so it is an
6336 exclude -- Alpine removes the message from your view of the folder even
6337 though it is not technically gone.
6338
6339 <P> A selective expunge command is available in IMAP folders that support
6340 the UID EXPUNGE extension in <A
6341 HREF="http://tools.ietf.org/html/rfc4315">RFC 4315</A> as well as for all
6342 other folders (local folders in all formats, POP3 inbox, and newsgroups)
6343 as a subcommand of the apply command. If some selected messages are marked
6344 deleted, then the apply command will offer the eXpunge command, which when
6345 executed will only expunge those messages that are selected and deleted.
6346
6347 <P>
6348 Observe that the expunge command (when not used from the apply command)
6349 will expunge/exclude all deleted messages from the folder, and so all
6350 messages marked deleted will be expunged, regardless of if they are
6351 selected or not. In other words, there is no protection against
6352 potentially expunging more messages than only those that have been
6353 selected and deleted.
6354 <P>
6355
6356 The configuration features
6357 <A HREF="h_config_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm"-->&quot;</A>
6358 and
6359 <A HREF="h_config_full_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm-everywhere"-->&quot;</A>
6360 affect the behavior of the Expunge command.
6361
6362 <P>
6363 &lt;End of help on this topic&gt;
6364 </BODY>
6365 </HTML>
6366 ======= h_common_compose =======
6367 <HTML>
6368 <HEAD>
6369 <TITLE>Compose Command</TITLE>
6370 </HEAD>
6371 <BODY>
6372 <H1>Compose Command</H1>
6373
6374 The Compose command takes you into the Alpine message composer where you
6375 can start a new message for sending.  This is where you type in the
6376 message's text and specify its recipient list (the &quot;To:&quot;
6377 address), where copies should be directed (e.g., &quot;Fcc&quot;,
6378 &quot;Cc:&quot; or &quot;Bcc:&quot;), and which files, if any, should
6379 be attached to the message.
6380
6381 <P>
6382 When you type this command, Alpine will also automatically check for any
6383 interrupted (i.e., a message that was being composed when your modem
6384 or network connection was broken) or previously postponed messages and
6385 offer you a chance to continue working on those.
6386
6387 <P>
6388 <UL>
6389 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
6390 </UL><P>
6391 &lt;End of help on this topic&gt;
6392 </BODY>
6393 </HTML>
6394 ======= h_common_index =======
6395 <HTML>
6396 <HEAD>
6397 <TITLE>Message Index Command</TITLE>
6398 </HEAD>
6399 <BODY>
6400 <H1>Message Index Command</H1>
6401
6402 The Index command takes you to the MESSAGE INDEX screen that displays a
6403 summary caption for each message in the currently-open folder. One
6404 message will be highlighted; this is the &quot;Current&quot; message.
6405 The message commands available from this screen (e.g. View, Reply,
6406 Forward, Delete, Print, Save, etc) apply to the current message.
6407
6408 <P>
6409 &lt;End of help on this topic&gt;
6410 </BODY>
6411 </HTML>
6412 ======= h_common_folders =======
6413 <HTML>
6414 <HEAD>
6415 <TITLE>Folder List Command</TITLE>
6416 </HEAD>
6417 <BODY>
6418 <H1>Folder List Command</H1>
6419
6420 This Folder List command takes you to the FOLDER LIST screen that displays
6421 the names of all your message folders and allows you to view, rename,
6422 delete, and add folders.  You can open (view) a different folder than the
6423 one currently open by highlighting the desired one (using the arrow keys
6424 or their control-key equivalents) and pressing RETURN.
6425
6426 <P>
6427 If you have multiple folder collections defined (see the Help text for
6428 the FOLDER LIST screen to learn more about Collections), you may need
6429 to press Return to expand the collection and display all of the
6430 folders in it.
6431
6432 <P>
6433 &lt;End of help on this topic&gt;
6434 </BODY>
6435 </HTML>
6436 ======= h_main_addrbook =======
6437 <HTML>
6438 <HEAD>
6439 <TITLE>Address Book Command</TITLE>
6440 </HEAD>
6441 <BODY>
6442 <H1>Address Book Command</H1>
6443
6444 This command, available only from the MAIN MENU, takes you
6445 to the ADDRESS BOOK management screen.  From here, your personal address
6446 book(s) may be updated.
6447
6448 <P>
6449 &lt;End of help on this topic&gt;
6450 </BODY>
6451 </HTML>
6452 ======= h_main_setup =======
6453 <HTML>
6454 <HEAD>
6455 <TITLE>Setup Command</TITLE>
6456 </HEAD>
6457 <BODY>
6458 <H1>Setup Command</H1>
6459
6460 The Setup command, available only from the MAIN MENU, prompts you for
6461 one of several configuration screens, including the SETUP CONFIGURATION
6462 screen, by which you may activate optional Alpine features.
6463
6464 <P>
6465 &lt;End of help on this topic&gt;
6466 </BODY>
6467 </HTML>
6468 ======= h_main_release_notes =======
6469 <HTML>
6470 <HEAD>
6471 <TITLE>Release Notes Command</TITLE>
6472 </HEAD>
6473 <BODY>
6474 <H1>Release Notes Command</H1>
6475
6476 This command displays information about Alpine <!--#echo var="ALPINE_VERSION"-->,
6477 as well as pointers to further information such as history and legal notes.
6478
6479 <P>
6480 &lt;End of help on this topic&gt;
6481 </BODY>
6482 </HTML>
6483 ======= h_main_kblock =======
6484 <HTML>
6485 <HEAD>
6486 <TITLE>Keyboard Lock Command</TITLE>
6487 </HEAD>
6488 <BODY>
6489 <H1>Keyboard Lock Command</H1>
6490
6491 This command allows your Alpine session to be protected
6492 during a temporary absence from your terminal.
6493
6494 <P>
6495 &lt;End of help on this topic&gt;
6496 </BODY>
6497 </HTML>
6498 ======= h_main_journal =======
6499 <HTML>
6500 <HEAD>
6501 <TITLE>Journal Command</TITLE>
6502 </HEAD>
6503 <BODY>
6504 <H1>Journal Command</H1>
6505
6506 This command displays a list of all the status messages Alpine has
6507 displayed (on the third line from the bottom of the screen). This may
6508 be useful if a message disappeared before you had a chance to read it.
6509
6510 <P>
6511 &lt;End of help on this topic&gt;
6512 </BODY>
6513 </HTML>
6514 ======= h_common_role =======
6515 <HTML>
6516 <HEAD>
6517 <TITLE>Role Command</TITLE>
6518 </HEAD>
6519 <BODY>
6520 <H1>Role Command</H1>
6521
6522 The Role command is similar to the Compose command except that it starts
6523 off by letting you select a <A HREF="h_rules_roles">role</A>
6524 to be used for the composition.
6525 You may set up alternate roles by using Setup/Rules/Roles.
6526
6527 <P>
6528 &lt;End of help on this topic&gt;
6529 </BODY>
6530 </HTML>
6531 ======= h_common_conditional_cmds =======
6532 <HTML>
6533 <HEAD>
6534 <TITLE>Conditional Commands</TITLE>
6535 </HEAD>
6536 <BODY>
6537 <H1>Conditional Commands</H1>
6538
6539 The presence or absence of certain commands, particularly in the
6540 MESSAGE INDEX and MESSAGE TEXT screens, is determined by
6541 whether or not specific features are set in your Alpine configuration.
6542 (You can access the SETUP CONFIGURATION screen, where they are found, from
6543 Alpine's MAIN MENU.)  To see if a desired command's availability is
6544 conditioned on a feature setting, see the command's help text (highlight
6545 the phrase associated with the command and hit Return).
6546
6547 <P>
6548 Also note that some
6549 commands may be administratively disabled by your system manager;
6550 if they don't work, please check with your local help desk.
6551
6552 <P>
6553 <UL>
6554 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
6555 </UL><P>
6556 &lt;End of help on this topic&gt;
6557 </BODY>
6558 </HTML>
6559 ======= h_common_pipe =======
6560 <HTML>
6561 <HEAD>
6562 <TITLE>Pipe Command</TITLE>
6563 </HEAD>
6564 <BODY>
6565 <H1>Pipe Command</H1>
6566
6567 Pipe
6568 (<!--chtml if pinemode="function_key"-->F12<!--chtml else-->|<!--chtml endif-->)
6569 allows you to send a message to a specified Unix command for external
6570 processing.
6571 This command's availability is controlled by the
6572 <A HREF="h_config_enable_pipe">&quot;<!--#echo var="FEAT_enable-unix-pipe-cmd"-->&quot;</A>
6573 feature.
6574 By default, the processed text of the message is sent to the command
6575 you specify and the output is captured by Alpine and shown to you.
6576 When you run the pipe command, there are some sub-commands which may be
6577 used to alter this behavior.
6578 These sub-commands are described <A HREF="h_pipe_command">here</A>.
6579
6580 <P>
6581 &lt;End of help on this topic&gt;
6582 </BODY>
6583 </HTML>
6584 ======= h_common_goto =======
6585 <HTML>
6586 <HEAD>
6587 <TITLE>Goto Command</TITLE>
6588 </HEAD>
6589 <BODY>
6590 <H1>Goto Command</H1>
6591
6592 Goto
6593 (<!--chtml if pinemode="function_key"-->F6<!--chtml else-->G<!--chtml endif-->)
6594 is the command that lets you bypass Alpine's folder selection screens
6595 and jump directly to a new folder.  You can select any folder in the
6596 world: one in your current collection, one in a different collection or
6597 one in a collection you've never even used before.
6598 <P>
6599
6600 Alpine will help you as much as possible to narrow in on the folder you want.
6601 However, if the folder is outside of your defined collections, you are
6602 going to have to enter the exact folder location using the correct
6603 <A HREF="h_valid_folder_names">syntax</A>
6604 for a remote folder and/or fully-qualified path name.
6605
6606 <P>
6607 &lt;End of help on this topic&gt;
6608 </BODY>
6609 </HTML>
6610 ======= h_common_nextnew =======
6611 <HTML>
6612 <HEAD>
6613 <TITLE>NextNew Command</TITLE>
6614 </HEAD>
6615 <BODY>
6616 <H1>NextNew Command</H1>
6617
6618 When you press the TAB key, Alpine advances to the next
6619 &quot;interesting&quot; message.
6620 This will be the next message you have not seen before, or the next message
6621 you have flagged Important, whichever comes first.
6622 Unread messages that have been deleted are not considered interesting.
6623 (A note about reading news. Alpine expects you to &quot;Delete&quot; news
6624 articles after you have read them if you want to remove them from future
6625 consideration. See <A HREF="h_mainhelp_readingnews">Reading News</A> for
6626 more information.)
6627
6628 <P>
6629 The NextNew command is affected by the feature
6630 <A HREF="h_config_tab_new_only">&quot;<!--#echo var="FEAT_tab-visits-next-new-message-only"-->&quot;</A>,
6631 which causes Alpine to only consider Unread messages interesting, not messages
6632 flagged Important.
6633
6634 <P>
6635 This command behaves a little differently when it finds there are no more
6636 interesting messages left in the current folder.
6637 If the current folder is one of your Incoming Message Folders
6638 (<A HREF="h_config_enable_incoming">&quot;<!--#echo var="FEAT_enable-incoming-folders"-->&quot;</A>)
6639 or it is a newsgroup, then Alpine will try to find the next folder or
6640 newsgroup that contains <EM>Recent</EM> messages and will ask you
6641 if you want to open that folder.
6642 This behavior may be modified by using the
6643 <A HREF="h_config_tab_uses_unseen">&quot;<!--#echo var="FEAT_tab-uses-unseen-for-next-folder"-->&quot;</A>
6644 feature that causes Alpine to look for Unseen messages instead of Recent
6645 messages.
6646 The NextNew command's behavior is also affected by the configuration features
6647 <A HREF="h_config_auto_open_unread">&quot;<!--#echo var="FEAT_auto-open-next-unread"-->&quot;</A>,
6648 and
6649 <A HREF="h_config_tab_no_prompt">&quot;<!--#echo var="FEAT_continue-tab-without-confirm"-->&quot;</A>.
6650
6651 <P>
6652 &lt;End of help on this topic&gt;
6653 </BODY>
6654 </HTML>
6655 ======= h_common_jump =======
6656 <HTML>
6657 <HEAD>
6658 <TITLE>Jump Command</TITLE>
6659 </HEAD>
6660 <BODY>
6661 <H1>Jump Command</H1>
6662
6663 This is Alpine's way of allowing you to go straight to a specific message.
6664 Just press &quot;J&quot; and then enter the message number.  By default, Alpine is also
6665 configured such that typing in any number automatically jumps you to that
6666 message
6667 (<A HREF="h_config_enable_jump">&quot;<!--#echo var="FEAT_enable-jump-shortcut"-->&quot;</A>
6668 in the SETUP CONFIGURATION).
6669
6670 <P>
6671 &lt;End of help on this topic&gt;
6672 </BODY>
6673 </HTML>
6674 ======= h_common_flag =======
6675 <HTML>
6676 <HEAD>
6677 <TITLE>Flag Command</TITLE>
6678 </HEAD>
6679 <BODY>
6680 <H1>Flag Command</H1>
6681
6682 Flag
6683 (<!--chtml if pinemode="function_key"-->F11<!--chtml else-->*<!--chtml endif-->)
6684 is the command that allows users to manipulate the status flags that
6685 appear on the left side of the MESSAGE INDEX screen.  The most common
6686 use of this is to mark a message as important. This is something of a
6687 note to yourself to get back to that message.  You may also use the
6688 flag command to set (or unset) the flags that indicate that a message
6689 is new, answered, deleted, or forwarded.<P>
6690
6691 Provided the mail server supports it,
6692 you may also manipulate user-defined keywords
6693 for a message using the flag command.
6694 These keywords will be available if you use the Flag Details screen that you
6695 can get to after typing the
6696 Flag (<!--chtml if pinemode="function_key"-->F11<!--chtml else-->*<!--chtml endif-->)
6697 command.
6698 They will be listed after the Important, New, Answered, Deleted , and Forwarded flags,
6699 which are always present.
6700 You may add new keywords by using the Add KW command from the Flag Details screen
6701 or by defining them in the <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in the Setup/Config screen.
6702
6703 The availability of the flag command is determined by the
6704 <A HREF="h_config_enable_flag">&quot;<!--#echo var="FEAT_enable-flag-cmd"-->&quot;</A>
6705 feature in your Alpine configuration. Also, it is possible that Flag could be
6706 administratively disabled by your system manager; if it doesn't work,
6707 please check with your local help desk before reporting a bug.
6708 The behavior of the flag command may be modified by the
6709 <A HREF="h_config_flag_screen_default">&quot;<!--#echo var="FEAT_enable-flag-screen-implicitly"-->&quot;</A> option or the
6710 <A HREF="h_config_flag_screen_kw_shortcut">&quot;<!--#echo var="FEAT_enable-flag-screen-keyword-shortcut"-->&quot;</A> option.
6711
6712 <P>
6713 &lt;End of help on this topic&gt;
6714 </BODY>
6715 </HTML>
6716 ======= h_common_hdrmode =======
6717 <HTML>
6718 <HEAD>
6719 <TITLE>HdrMode Command</TITLE>
6720 </HEAD>
6721 <BODY>
6722 <H1>HdrMode Command</H1>
6723
6724 Every email message comes with some header lines that you normally
6725 don't see (and don't want to see).
6726 These include anywhere from 3-20 lines (or more) added by the
6727 Internet mail transport system to record the route your message took,
6728 for diagnostic purposes.
6729 These are normally of no import and simply
6730 add clutter, so Alpine suppresses them in the MESSAGE TEXT display.
6731 This also includes other non-standard headers the message may contain.
6732 If you want to see these headers, there is a way to reveal them.
6733 <P>
6734
6735 The Header Mode
6736 (<!--chtml if pinemode="function_key"-->F9<!--chtml else-->H<!--chtml endif-->)
6737 command is a toggle that controls Alpine's handling of these header
6738 lines.  Normally, full headers is &quot;off&quot; and you only see a
6739 few lines about who a message is to and who it is from.  When you
6740 press
6741 (<!--chtml if pinemode="function_key"-->F9<!--chtml else-->H<!--chtml endif-->)
6742 to turn full headers on, Alpine will show you
6743 the normal header lines as well as delivery headers, comment headers,
6744 MIME headers, and any other headers present.
6745 <P>
6746
6747 Several different Alpine commands honor the header mode -- it affects how
6748 messages are displayed, how they appear in forward and reply email, how
6749 they are printed, how they are saved, and how they are exported.
6750 <!--chtml if pinemode="os_windows"-->
6751 <!--chtml else-->
6752 The pipe command is also affected.
6753 <!--chtml endif-->
6754 <P>
6755
6756 The presence or absence of the Header Mode command is determined by the
6757 <A HREF="h_config_enable_full_hdr">&quot;<!--#echo var="FEAT_enable-full-header-cmd"-->&quot;</A>
6758 Feature-List option in your Alpine configuration.
6759
6760 <P>
6761 If you have also turned on the
6762 <A HREF="h_config_quote_suppression">&quot;Quote Suppression&quot;</A>
6763 option then the HdrMode command actually rotates through three states
6764 instead of just two.
6765 The first is the normal view with long quotes suppressed.
6766 The second is the normal view but with the long quotes included.
6767 The last enables the display of all headers in the message.
6768 When using Export, Pipe, Print, Forward, or Reply the quotes are
6769 never suppressed, so the first two states are identical.
6770
6771 <P>
6772 The behavior of the Header Mode command may be altered slightly by
6773 turning on the
6774 <A HREF="h_config_quell_full_hdr_reset">&quot;<!--#echo var="FEAT_quell-full-header-auto-reset"-->&quot;</A>
6775 Feature-List option in your Alpine configuration.
6776 In particular, it will cause the Header Mode to be persistent when moving
6777 from message to message instead of resetting to the default for each message.
6778
6779 <P>
6780 <UL>
6781 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
6782 </UL><P>
6783 &lt;End of help on this topic&gt;
6784 </BODY>
6785 </HTML>
6786 ======= h_common_print =======
6787 <HTML>
6788 <HEAD>
6789 <TITLE>Print Command</TITLE>
6790 </HEAD>
6791 <BODY>
6792 <H1>Print Command</H1>
6793
6794 The Print
6795 (<!--chtml if pinemode="function_key"-->F9<!--chtml else-->%<!--chtml endif-->)
6796 command allows you to print a copy of a message.
6797 There are many SETUP CONFIGURATION features that affect the
6798 Print command, including
6799 <A HREF="h_config_enable_y_print">&quot;<!--#echo var="FEAT_enable-print-via-y-command"-->&quot;</A>,
6800 <A HREF="h_config_print_index">&quot;<!--#echo var="FEAT_print-index-enabled"-->&quot;</A>,
6801 <A HREF="h_config_custom_print">&quot;<!--#echo var="FEAT_print-offers-custom-cmd-prompt"-->&quot;</A>,
6802 <A HREF="h_config_print_from">&quot;<!--#echo var="FEAT_print-includes-from-line"-->&quot;</A>, and
6803 <A HREF="h_config_ff_between_msgs">&quot;<!--#echo var="FEAT_print-formfeed-between-messages"-->&quot;</A>.
6804 You set up for printing by using the Printer option of the Setup command
6805 on the MAIN MENU.
6806 <P>
6807
6808 <P>
6809 &lt;End of help on this topic&gt;
6810 </BODY>
6811 </HTML>
6812 ======= h_common_take =======
6813 <HTML>
6814 <HEAD>
6815 <TITLE>TakeAddr Command</TITLE>
6816 </HEAD>
6817 <BODY>
6818 <H1>TakeAddr Command</H1>
6819
6820
6821 With the Take Address
6822 (<!--chtml if pinemode="function_key"-->F10<!--chtml else-->T<!--chtml endif-->)
6823 command, you can extract email addresses from an
6824 incoming message and save them in an address book.  This is an easy way
6825 to add to your address book and avoid having to remember the email
6826 addresses of the people who write to you.
6827 <P>
6828
6829 If the message is just to you individually, then you will only need to
6830 provide a nickname.  If the message contains more than one email address,
6831 then you will see an address
6832 selection screen that lets you choose the address you want to save into
6833 your address book, or lets you choose several of them add to a
6834 personal distribution list.
6835 <P>
6836
6837 Once you've added an entry to your address book, you can use it from the
6838 message composer by typing the nickname of the entry into one of the
6839 header fields (for example, into the To: field), or you can use ^T from
6840 the header field to select the entry from your address book.
6841 <P>
6842
6843 If the configuration feature
6844 <A HREF="h_config_enable_role_take">&quot;<!--#echo var="FEAT_enable-rules-under-take"-->&quot;</A>
6845 is set, the behavior of the Take command is altered slightly.
6846
6847 <P>
6848 &lt;End of help on this topic&gt;
6849 </BODY>
6850 </HTML>
6851 ======= h_ge_import =======
6852 <HTML>
6853 <HEAD>
6854 <TITLE>Import File Selection</TITLE>
6855 </HEAD>
6856 <BODY>
6857 <H1>Import File Selection</H1>
6858
6859 You are importing a file that you previously
6860 exported from Alpine.
6861 You are now being asked for the name of that file.
6862 The easiest way to select a file is probably with the &quot;^T&quot;
6863 &quot;To Files&quot; command.
6864 Alternatively, you may type in a file name.
6865 It may be an absolute pathname.
6866 Otherwise, it is a file located in your home directory
6867 or current working directory
6868 <!--chtml if pinemode="running"-->
6869 (which, at least for your current Alpine &quot;session,&quot;
6870 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
6871 <!--chtml endif-->, depending on the
6872 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A> option.
6873 In any case, you finish by typing a carriage return to accept the
6874 file name that is displayed.
6875 When the feature
6876 <A HREF="h_config_enable_tab_complete">&quot;<!--#echo var="FEAT_enable-tab-completion"-->&quot;</A>
6877 is turned on you may use TAB to complete partially typed in names.
6878 <P>
6879 You may cancel the import operation by typing &quot;^C&quot; after exiting
6880 this help.
6881 <P>
6882 &lt;End of help on this topic&gt;
6883 </BODY>
6884 </HTML>
6885 ======= h_ge_allparts =======
6886 <HTML>
6887 <HEAD>
6888 <TITLE>Export Message File Selection</TITLE>
6889 </HEAD>
6890 <BODY>
6891 <H1>Export Message File Selection</H1>
6892
6893 You are Exporting a message from an Alpine mail folder
6894 to a plain text file.
6895 You also have the option of exporting all of the attachments associated
6896 with the message.
6897 You are now being asked for the name of the file to export <EM>to</EM>.
6898 The easiest way to select a file is probably with the &quot;^T&quot;
6899 &quot;To Files&quot; subcommand.
6900 After returning from that subcommand you will still be allowed to
6901 edit the name you have selected.
6902 Alternatively, you may type in a file name.
6903 It may be an absolute pathname.
6904 Otherwise, it is a file located in your home directory
6905 or current working directory
6906 <!--chtml if pinemode="running"-->
6907 (which, at least for your current Alpine &quot;session,&quot;
6908 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
6909 <!--chtml endif-->, depending on the
6910 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A> option.
6911 In any case, you finish by typing a carriage return to accept the
6912 file name that is displayed.
6913 When the feature
6914 <A HREF="h_config_enable_tab_complete">&quot;<!--#echo var="FEAT_enable-tab-completion"-->&quot;</A>
6915 is turned on you may use TAB to complete partially typed in names.
6916 <P>
6917 The message you are exporting appears to have some attachments.
6918 If you wish to save <EM>all</EM> of the attachments at once,
6919 type the &quot;^P&quot; &quot;AllParts&quot; command to turn on
6920 saving of the attachments.
6921 You may turn it back off by typing &quot;^P&quot; again, which will now
6922 be labeled &quot;NoAllParts&quot; instead.
6923 If you want to save the parts the command displayed should be
6924 &quot;NoAllParts&quot;!
6925 When you choose to save attachments like this, the attachments will be saved
6926 in a newly created directory.
6927 That directory will have the same name as the file name you choose here,
6928 with the letters &quot;.d&quot; appended.
6929 If that directory already exists, then the letters &quot;.d_1&quot; will
6930 be tried, then &quot;.d_2&quot; and so on until a name that doesn't exist
6931 is found.
6932 For example, if you select the file name
6933 <P>
6934 <CENTER><SAMP>filename</SAMP></CENTER>
6935 <P>
6936 to export the message to, then the directory used for the attachments will be
6937 <P>
6938 <CENTER><SAMP>filename.d</SAMP></CENTER>
6939 <P>
6940 or perhaps
6941 <P>
6942 <CENTER><SAMP>filename.d_&lt;n&gt;</SAMP></CENTER>
6943 <P>
6944 The attachments will then be put into files inside that directory.
6945 The names for the attachment files will be derived from the attachments
6946 if possible.
6947 This is done in the same way as the default values are derived if you
6948 save them one at a time.
6949 (The &quot;filename&quot; parameter from the Content-Disposition header
6950 is the first choice. If that doesn't exist, the &quot;name&quot;
6951 parameter from the Content-Type header is used.)
6952 If a name for a particular attachment is not available, then the
6953 part number of the attachment is used, with the characters &quot;part_&quot;
6954 prepended.
6955 An example of that would be
6956 <P>
6957 <CENTER><SAMP>part_2.1</SAMP></CENTER>
6958 <P>
6959 If you want to save only some of the attachments or if you want more control
6960 over the directory and filename where an attachment is saved you may
6961 cancel out of this command and View the attachment list.
6962 From there you can save each attachment individually.
6963 <P>
6964 You may cancel the Export operation by typing &quot;^C&quot; after exiting
6965 this help.
6966 <P>
6967 &lt;End of help on this topic&gt;
6968 </BODY>
6969 </HTML>
6970 ======= h_ge_export =======
6971 <HTML>
6972 <HEAD>
6973 <TITLE>Export File Selection</TITLE>
6974 </HEAD>
6975 <BODY>
6976 <H1>Export File Selection</H1>
6977
6978 You are Exporting or Saving something from within the Alpine world
6979 (a message, an attachment, etc.)
6980 to a plain text file.
6981 You are now being asked for the name of the file to export <EM>to</EM>.
6982 The easiest way to select a file is probably with the &quot;^T&quot;
6983 &quot;To Files&quot; subcommand.
6984 After returning from that subcommand you will still be allowed to
6985 edit the name you have selected.
6986 Alternatively, you may type in a file name.
6987 It may be an absolute pathname.
6988 Otherwise, it is a file located in your home directory
6989 or current working directory
6990 <!--chtml if pinemode="running"-->
6991 (which, at least for your current Alpine &quot;session,&quot;
6992 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
6993 <!--chtml endif-->, depending on the
6994 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A> option.
6995 In any case, you finish by typing a carriage return to accept the
6996 file name that is displayed.
6997 When the feature
6998 <A HREF="h_config_enable_tab_complete">&quot;<!--#echo var="FEAT_enable-tab-completion"-->&quot;</A>
6999 is turned on you may use TAB to complete partially typed in names.
7000 <P>
7001 If the object you are exporting is a message with some attachments,
7002 you may wish to save all of the attachments by typing the &quot;^P&quot;
7003 &quot;AllParts&quot; command to turn on saving of the attachments.
7004 This subcommand will only be visible if the message actually has attachments.
7005 You may also View the attachment list and save individual attachments from
7006 there.
7007 <P>
7008 If you are SAVING a text part (text/plain, text/html, etc.) you can use
7009 the Control-R subcommand to toggle if saving will be done in binary mode,
7010 meaning that the attachment will be decoded, but will not be transformed
7011 to UTF-8 for further processing (either in internal filters, or user
7012 supplied filters.) This is useful in case you either want to preserve
7013 the text as it was encoded originally to you, or the attachment was
7014 incorrectly attached (the attachment is not of text type) and you need
7015 the original text to process the attachment.
7016 <P>
7017 You may cancel the Export operation by typing &quot;^C&quot; after exiting
7018 this help.
7019 <P>
7020 &lt;End of help on this topic&gt;
7021 </BODY>
7022 </HTML>
7023 ======= h_common_save =======
7024 <HTML>
7025 <HEAD>
7026 <TITLE>Save and Export Commands</TITLE>
7027 </HEAD>
7028 <BODY>
7029 <H1>Save and Export Commands</H1>
7030
7031 Save
7032 (<!--chtml if pinemode="function_key"-->F11<!--chtml else-->S<!--chtml endif-->)
7033 and Export
7034 (<!--chtml if pinemode="function_key"-->F12<!--chtml else-->E<!--chtml endif-->)
7035 are the two alternatives Alpine gives you to keep a copy of the message
7036 you are reading. If you want to keep the message within Alpine's email
7037 world, use &quot;Save&quot;; if you want to use the message in another
7038 program, use &quot;Export&quot;.
7039 <P>
7040
7041 When you Save a message, it is put into an existing folder or into a new
7042 folder in one of your existing folder collections.  The message stays in
7043 email format and can be read by Alpine again.  Alpine may use a special format
7044 for its mail folders -- never edit an Alpine folder by hand or with any
7045 program other than Alpine.  The exact behavior of the Save command can be
7046 configured with the
7047 <A HREF="h_config_quote_all_froms">&quot;<!--#echo var="FEAT_save-will-quote-leading-froms"-->&quot;</A>,
7048 <A HREF="h_config_save_wont_delete">&quot;<!--#echo var="FEAT_save-will-not-delete"-->&quot;</A>,
7049 and
7050 <A HREF="h_config_save_advances">&quot;<!--#echo var="FEAT_save-will-advance"-->&quot;</A>
7051 feature list settings.
7052 The name of the folder offered as a default is controlled by the option
7053 <A HREF="h_config_saved_msg_name_rule">&quot;<!--#echo var="VAR_saved-msg-name-rule"-->&quot;</A>.
7054 <P>
7055
7056 When you use Export, the message is placed in a plain text file in your
7057 home directory
7058 <!--chtml if pinemode="running"-->
7059 (which, in the present configuration of your system, is
7060  &quot;<!--#echo var="HOME_DIR"-->&quot;)
7061 <!--chtml endif-->
7062 or current working directory
7063 <!--chtml if pinemode="running"-->
7064 (which, at least for your current Alpine &quot;session,&quot;
7065 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
7066 <!--chtml endif-->, depending on the
7067 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
7068 configuration setting.  In the normal case, only minimal
7069 headers are exported with the message; however, if the full header mode
7070 (whose availability may be disabled  by setting the feature
7071 <A HREF="h_config_enable_full_hdr">&quot;<!--#echo var="FEAT_enable-full-header-cmd"-->&quot;</A>
7072 in SETUP CONFIGURATION) is
7073 toggled on, then complete headers are exported along with the message
7074 text. (If you have any <A HREF="h_config_display_filters"><!--#echo var="VAR_display-filters"--></A>
7075 defined, they may affect the contents of the exported file.)
7076
7077 <P>
7078 &lt;End of help on this topic&gt;
7079 </BODY>
7080 </HTML>
7081 ======= h_common_bounce =======
7082 <HTML>
7083 <HEAD>
7084 <TITLE>Bounce Command</TITLE>
7085 </HEAD>
7086 <BODY>
7087 <H1>Bounce Command</H1>
7088
7089 The Bounce
7090 (<!--chtml if pinemode="function_key"-->F10<!--chtml else-->B<!--chtml endif-->)
7091 command allows you to re-send, or &quot;remail&quot;, a
7092 message, as if you were never in the loop.  It is analogous to crossing
7093 out your address on a postal letter, writing a different address on the
7094 envelope, and putting it into the mailbox. Bounce is used primarily to
7095 redirect email that was sent to you in error.
7096 Also, some owners of email
7097 lists need the bounce command to handle list traffic.
7098 Bounce is not anonymous.
7099 A ReSent-From header is added to the message so that the recipient may
7100 tell that you Bounced it to them.
7101 <P>
7102
7103 The presence or absence of the Bounce command is determined by the
7104 <A HREF="h_config_enable_bounce">&quot;<!--#echo var="FEAT_enable-bounce-cmd"-->&quot;</A>
7105 feature in your Alpine configuration.
7106 The feature
7107 <A HREF="h_config_fcc_on_bounce">&quot;<!--#echo var="FEAT_fcc-on-bounce"-->&quot;</A>
7108 affects the behavior of the Bounce command.
7109 Also, it is possible that Bounce could be
7110 administratively disabled by your system manager; if it doesn't work,
7111 please check with your local help desk before reporting a bug.
7112
7113 <P>
7114 &lt;End of help on this topic&gt;
7115 </BODY>
7116 </HTML>
7117 ======= h_common_reply =======
7118 <HTML>
7119 <HEAD>
7120 <TITLE>Reply and Forward Commands</TITLE>
7121 </HEAD>
7122 <BODY>
7123
7124 <H1>Reply and Forward Commands</H1>
7125
7126 Replying
7127 (<!--chtml if pinemode="function_key"-->F11<!--chtml else-->R<!--chtml endif-->)
7128 and Forwarding
7129 (<!--chtml if pinemode="function_key"-->F12<!--chtml else-->F<!--chtml endif-->)
7130 are your two alternatives for following up on the
7131 message you are reading.  You would use reply if you want to get email
7132 back to the author of the message and/or the other people who have
7133 already seen it.  You use forward if you want somebody new to see the
7134 message.
7135 <P>
7136
7137 In the normal case, the only thing that you must supply when forwarding a
7138 message is the name/email address of the new recipient.
7139 Alpine will include the text of the forwarded message.
7140 Alpine will also include any attachments to the message.
7141 There is space above the forwarded text for you to include additional comments.
7142 <P>
7143
7144 When replying, you usually have to answer some questions.
7145 If the message is to multiple people and/or specified with a Reply-To: header,
7146 then you will have to decide who should get the reply.
7147 You also need to decide whether or not to include the previous
7148 message in your reply.
7149 Some of this is configurable.
7150 Specifically, see the
7151 <A HREF="h_config_include_header">&quot;<!--#echo var="FEAT_include-header-in-reply"-->&quot;</A>,
7152 <A HREF="h_config_auto_include_reply">&quot;<!--#echo var="FEAT_include-text-in-reply"-->&quot;</A>,
7153 <A HREF="h_config_attach_in_reply">&quot;<!--#echo var="FEAT_include-attachments-in-reply"-->&quot;</A>,
7154 and
7155 <A HREF="h_config_auto_reply_to">&quot;<!--#echo var="FEAT_reply-always-uses-reply-to"-->&quot;</A>
7156 configuration features.
7157 <P>
7158
7159 Both the Reply and Forward commands react to the full header mode toggle.
7160 If the full header mode is on, then all the header and delivery lines are
7161 included with the text of the message in your reply/forward.
7162 <P>
7163
7164 Other configuration features that affect the Reply command are
7165 <A HREF="h_config_sig_at_bottom">&quot;<!--#echo var="FEAT_signature-at-bottom"-->&quot;</A>,
7166 <A HREF="h_config_sigdashes">&quot;<!--#echo var="FEAT_enable-sigdashes"-->&quot;</A>, and
7167 <A HREF="h_config_strip_sigdashes">&quot;<!--#echo var="FEAT_strip-from-sigdashes-on-reply"-->&quot;</A>.
7168
7169 <P>
7170 &lt;End of help on this topic&gt;
7171 </BODY>
7172 </HTML>
7173 ======= h_common_delete =======
7174 <HTML>
7175 <HEAD>
7176 <TITLE>Delete and Undelete Commands</TITLE>
7177 </HEAD>
7178 <BODY>
7179 <H1>Delete and Undelete Commands</H1>
7180
7181 Delete
7182 (<!--chtml if pinemode="function_key"-->F9<!--chtml else-->D<!--chtml endif-->)
7183 and Undelete
7184 (<!--chtml if pinemode="function_key"-->F10<!--chtml else-->U<!--chtml endif-->)
7185 allow you to change the Deleted flag for the current message.
7186 Delete marks a message Deleted (turns on the Deleted flag) and Undelete
7187 removes the mark.
7188 In the MESSAGE INDEX, deleted messages have a &quot;D&quot; in the status field
7189 at the left hand edge of the index line.
7190 When viewing a deleted message, the letters &quot;DEL&quot; will be present
7191 in the upper right hand corner of the screen.
7192 Delete simply <EM>marks</EM> a message Deleted, it does not actually
7193 get rid of the message.
7194 The eXpunge command (available from the MESSAGE INDEX screen) actually
7195 removes all of the deleted messages in a folder.
7196 Once a message is eXpunged, it can't be retrieved.
7197 <P>
7198
7199 The Delete command is affected by the setting of the configuration feature
7200 <A HREF="h_config_del_skips_del">&quot;<!--#echo var="FEAT_delete-skips-deleted"-->&quot;</A>.
7201
7202 <P>
7203 &lt;End of help on this topic&gt;
7204 </BODY>
7205 </HTML>
7206 ======= h_common_postpone =======
7207 <HTML>
7208 <HEAD>
7209 <TITLE>Postpone Command</TITLE>
7210 </HEAD>
7211 <BODY>
7212 <H1>Postpone Command</H1>
7213
7214 The postpone
7215 <!--chtml if pinemode="function_key"-->(F11)<!--chtml else-->(^O)<!--chtml endif-->
7216 command allows you to temporarily stop working on the current
7217 message so you may read
7218 other messages or compose another message.  When you want to resume a
7219 message later, start to compose and answer &quot;yes&quot; to the
7220 &quot;Continue postponed composition?&quot; question.  You may
7221 postpone as many messages as you like.
7222
7223 <P>
7224 Note: If a <A HREF="h_config_form_folder"><!--#echo var="VAR_form-letter-folder"--></A> is defined
7225 in the Setup/Config screen, then the Postpone command will prompt you for
7226 the folder in which to store your outgoing message.
7227
7228 <P>
7229 &lt;End of help on this topic&gt;
7230 </BODY>
7231 </HTML>
7232 ======= h_compose_cancel =======
7233 <HTML>
7234 <HEAD>
7235 <TITLE>Cancel Command</TITLE>
7236 </HEAD>
7237 <BODY>
7238 <H1>Cancel Command</H1>
7239
7240 Cancel
7241 <!--chtml if pinemode="function_key"-->
7242 (F2)
7243 <!--chtml else-->
7244 (^C)
7245 <!--chtml endif-->
7246
7247 The Cancel command returns you to Alpine's normal mail processing and
7248 causes the message currently under composition to be thrown out.
7249 The message text <EM>will be lost</EM>.
7250
7251 <P>
7252 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
7253 will be preserved in the file named
7254 <!--chtml if pinemode="os_windows"-->
7255 &quot;DEADLETR&quot;.
7256 <!--chtml else-->
7257 &quot;dead.letter&quot; in your home directory.
7258 <!--chtml endif-->
7259 If you unintentionally cancel a message, look there for its text.
7260
7261 <P>
7262 &lt;End of help on this topic&gt;
7263 </BODY>
7264 </HTML>
7265 ======= h_compose_addrcomplete =======
7266 <HTML>
7267 <HEAD>
7268 <TITLE>Address Completion</TITLE>
7269 </HEAD>
7270 <BODY>
7271 <H1>Address Completion</H1>
7272
7273 When entering addresses in the address fields of the composer (To, Cc, etc.)
7274 the TAB key may be used to help complete the address.
7275 Type a partial nickname and tap the TAB key to complete the typing.
7276 The unambiguous part of the name will be filled in automatically.
7277 Typing TAB twice in succession will bring up a selection list of possibilities,
7278 making it easy to find and choose the correct address.
7279
7280 <P>
7281 The matching algorithm is rather ad hoc.
7282 The search starts with a search of your address book.
7283 It counts as a match if the nickname, address, or fullname field of an
7284 entry begins with the text typed in so far. It is also a match if
7285 a later word in the fullname (for example, the middle name or last name)
7286 begins with the entered text.
7287 <P>
7288 Next comes an LDAP search.
7289 The search will happen for any servers that have the
7290 <A HREF="h_config_ldap_opts_impl">&quot;Use-Implicitly-From-Composer&quot;</A>
7291 feature set. You can set or unset the feature for each server independently
7292 in the Setup/Directory screen.
7293 <P>
7294 Finally, if you are replying to or forwarding a message, that message is
7295 searched for likely candidate addresses that match the typed-in text.
7296
7297 <P>
7298 &lt;End of help on this topic&gt;
7299 </BODY>
7300 </HTML>
7301 ======= h_compose_richhdr =======
7302 <HTML>
7303 <HEAD>
7304 <TITLE>Rich Header Command</TITLE>
7305 </HEAD>
7306 <BODY>
7307 <H1>Rich Header Command</H1>
7308
7309 The Rich Header command allows you to toggle between the list of
7310 all message headers available for editing and those that are most
7311 common.
7312
7313 <P>
7314 Use this toggle to expose headers that are not normally visible by
7315 default.
7316 This set usually includes the
7317 &quot;Bcc:&quot;,
7318 &quot;Fcc:&quot;,
7319 &quot;Lcc:&quot;,
7320 and &quot;Newsgroups&quot;
7321 headers.
7322 If you are posting to a newsgroup the set of defaults is a little different.
7323 Obviously, in that case, the Newsgroups header is of interest so is not
7324 hidden.
7325 For news posting the hidden set includes the
7326 &quot;To:&quot;,
7327 &quot;Cc:&quot;,
7328 &quot;Bcc:&quot;,
7329 &quot;Fcc:&quot;,
7330 and &quot;Lcc:&quot;
7331 headers.
7332 You won't normally want to edit these, which is why they are hidden,
7333 but it is sometimes useful to be able to set them manually.
7334
7335 <P>
7336 The default sets of headers listed above can be altered.
7337 Any header that you have added to the
7338 <A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A>
7339 option, but not to the
7340 <A HREF="h_config_comp_hdrs"><!--#echo var="VAR_default-composer-hdrs"--></A>
7341 option will appear when you use the Rich Headers command to
7342 make the Rich Headers visible.
7343 (Headers listed in the <!--#echo var="VAR_default-composer-hdrs"--> list will be visible
7344 even without toggling the Rich Headers command.)
7345
7346 <P>
7347 &lt;End of help on this topic&gt;
7348 </BODY>
7349 </HTML>
7350 ======= h_compose_send =======
7351 <HTML>
7352 <HEAD>
7353 <TITLE>Send Command</TITLE>
7354 </HEAD>
7355 <BODY>
7356 <H1>Send Command</H1>
7357
7358 The Send command
7359 <!--chtml if pinemode="function_key"-->
7360 (F3)
7361 <!--chtml else-->
7362 (^X)
7363 <!--chtml endif-->
7364 tells Alpine you are finished composing.
7365 Before actually sending it, though, Alpine will ask you to confirm
7366 your intention, and, at the same time, redisplayed the message text
7367 with the recipients at the top of the screen to give you the opportunity
7368 to review and verify that the message is addressed to the people
7369 you intended.
7370 <P>
7371 If the feature
7372 <A HREF="h_config_send_wo_confirm">&quot;<!--#echo var="FEAT_send-without-confirm"-->&quot;</A> is set,
7373 then this confirmation prompt and any options it allows are skipped.
7374
7375 <P>
7376 This confirmation prompt may also offer, depending
7377 on your particular Setup/Config, options allowing you to set
7378 <A HREF="h_config_compose_dsn">delivery status notifications</A>,
7379 include attachments in the &quot;Fcc&quot; (if you had previously
7380 specified that they <A HREF="h_config_no_fcc_attach">exclude attachments</A>,
7381 observe details of the
7382 <A HREF="h_config_verbose_post">message submission process</A>,
7383 choose the filter through which the
7384 <A HREF="h_config_sending_filter">outgoing text should first pass</A>,
7385 or turn of flowed text generation.
7386
7387 <P>
7388 &lt;End of help on this topic&gt;
7389 </BODY>
7390 </HTML>
7391 ======= h_compose_markcutpaste =======
7392 <HTML>
7393 <HEAD>
7394 <TITLE>Mark, Cut and Paste Commands</TITLE>
7395 </HEAD>
7396 <BODY>
7397 <H1>Mark, Cut and Paste Commands</H1>
7398
7399 You can define a &quot;block&quot; of text, which can subsequently
7400  be deleted or
7401 copied as a unit, by setting a mark at the start of the block (Ctrl-^) and
7402 then moving the cursor to the end of the desired text block.  You can then
7403 &quot;cut&quot; the block out
7404 <!--chtml if pinemode="function_key"-->
7405 &quot;F9&quot;,
7406 <!--chtml else-->
7407 &quot;Ctrl-K&quot;,
7408 <!--chtml endif-->
7409 move the cursor, and &quot;paste&quot; it
7410 <!--chtml if pinemode="function_key"-->
7411 &quot;F10&quot;,
7412 <!--chtml else-->
7413 &quot;Ctrl-U&quot;,
7414 <!--chtml endif-->
7415 in the new location.  Also, you can paste more than once, allowing you
7416 to use this feature to copy a block of text.<P>
7417
7418 If you press
7419 <!--chtml if pinemode="function_key"-->
7420 &quot;F9&quot;
7421 <!--chtml else-->
7422 &quot;^K&quot;
7423 <!--chtml endif-->
7424 without having marked anything, Alpine will delete
7425 a single line.  If you delete a group of lines together, Alpine keeps them
7426 in the same buffer, so
7427 <!--chtml if pinemode="function_key"-->
7428 F10
7429 <!--chtml else-->
7430 ^U
7431 <!--chtml endif-->
7432 will restore them as a block.  About
7433 terminology:  Mark is shown as &quot;^^&quot;.  The first &quot;^&quot; means you should
7434 hold down the &quot;Control&quot; key on your keyboard.  The second &quot;^&quot; means
7435 &quot;type the character ^&quot;.
7436
7437 <P>
7438 &lt;End of help on this topic&gt;
7439 </BODY>
7440 </HTML>
7441 ======= h_compose_justify =======
7442 <HTML>
7443 <HEAD>
7444 <TITLE>Justify Command</TITLE>
7445 </HEAD>
7446 <BODY>
7447 <H1>Justify Command</H1>
7448
7449 The Justify
7450 <!--chtml if pinemode="function_key"-->
7451 (F4)
7452 <!--chtml else-->
7453 (^J)
7454 <!--chtml endif-->
7455 command reformats the text in the paragraph the cursor is in.
7456 Paragraphs are separated by one blank line or a line beginning with a space.
7457 This is useful when you have been editing a paragraph and the lines become
7458 uneven.  The text is left aligned or justified and the right is ragged.  If
7459 the text is already justified as typed with auto-wrap, no justification will
7460 be done.
7461
7462 <P>
7463 If you have set a <A HREF="h_compose_markcutpaste">mark</A> to select a
7464 block of text, the Justify command is modified.
7465 Instead of automatically justifying the current paragraph you will be
7466 asked if you want to justify the paragraph, justify the selected region,
7467 or adjust the quote level of the selected region.
7468 Adjusting the quote level only works if you are using standard
7469 &quot;&gt;&nbsp;&quot; or &quot;&gt;&quot; quotes, which is the default if you haven't
7470 changed &quot;<A HREF="h_config_reply_indent_string"><!--#echo var="VAR_reply-indent-string"--></A>&quot;.
7471
7472 <P>
7473 When composing a reply containing included text, the justify command
7474 will reformat text to the right of the
7475 &quot;<A HREF="h_config_reply_indent_string"><!--#echo var="VAR_reply-indent-string"--></A>&quot;,
7476 adding or removing indented lines as needed.  Paragraphs are separated
7477 by a blank line, a line containing only the <!--#echo var="VAR_reply-indent-string"-->, or a
7478 line containing the indent string and one or more blank spaces.
7479 Included text that was previously indented (or &quot;quoted&quot;) is
7480 not preserved.
7481
7482 <P>
7483 Because of the introduction of <A HREF="h_config_quell_flowed_text">Flowed Text</A>
7484 in 1999 and its wide-spread adoption since then, you will usually be better off if you
7485 use the standard
7486 &quot;&gt;&nbsp;&quot; or &quot;&gt;&quot; quotes.
7487
7488 <P>
7489 &lt;End of help on this topic&gt;
7490 </BODY>
7491 </HTML>
7492 ======= h_compose_spell =======
7493 <HTML>
7494 <HEAD>
7495 <TITLE>Spell Check Command</TITLE>
7496 </HEAD>
7497 <BODY>
7498 <H1>Spell Check Command</H1>
7499
7500 The &quot;To Spell&quot;
7501 <!--chtml if pinemode="function_key"-->
7502 (F12)
7503 <!--chtml else-->
7504 (^T)
7505 <!--chtml endif-->
7506 command calls an external spell checking program to look over the
7507 message you are composing.  By default, Alpine uses
7508 <P>
7509 <CENTER><SAMP>aspell --dont-backup --mode=email check</SAMP></CENTER>
7510 <P>
7511 if it knows where to find &quot;aspell&quot;.
7512 If there is no &quot;aspell&quot; command available but the command &quot;ispell&quot; is available
7513 then the command used is
7514 <P>
7515 <CENTER><SAMP>ispell -l</SAMP></CENTER>
7516 <P>
7517 Otherwise, the ancient &quot;spell&quot; command is used.
7518 <P>
7519 For PC-Alpine, you must install the aspell library code that you
7520 may get from
7521 <A HREF="http://aspell.net/win32/">http://aspell.net/win32/</A>.
7522
7523 <P>
7524 &lt;End of help on this topic&gt;
7525 </BODY>
7526 </HTML>
7527 ======= h_compose_alted =======
7528 <HTML>
7529 <HEAD>
7530 <TITLE>Alt Editor Command</TITLE>
7531 </HEAD>
7532 <BODY>
7533 <H1>Alt Editor Command</H1>
7534
7535 The &quot;Alt Editor&quot; command's availability depends on the
7536 Setup/Config variable &quot;<A HREF="h_config_editor"><!--#echo var="VAR_editor"--></A>&quot;.
7537
7538 <P>
7539 When the variable specifies a valid editor on your system, this
7540 command will launch it with the current text of your message
7541 already filled in.
7542
7543 <P>
7544 &lt;End of help on this topic&gt;
7545 </BODY>
7546 </HTML>
7547 ======= h_compose_readfile =======
7548 <HTML>
7549 <HEAD>
7550 <TITLE>Read File Command</TITLE>
7551 </HEAD>
7552 <BODY>
7553 <H1>Read File Command</H1>
7554
7555 The &quot;Read File&quot;
7556 <!--chtml if pinemode="function_key"-->
7557 (F5)
7558 <!--chtml else-->
7559 (^R)
7560 <!--chtml endif-->
7561 command allows you to copy in text from an existing file. You will be
7562 prompted for the name of a file to be inserted into the message.  The file
7563 name is relative to your home directory
7564 <!--chtml if pinemode="running"-->
7565 (which, in the present configuration of your system, is
7566  &quot;<!--#echo var="HOME_DIR"-->&quot;)
7567 <!--chtml endif-->
7568 or current working directory
7569 <!--chtml if pinemode="running"-->
7570 (which, at least for your current Alpine &quot;session,&quot;
7571 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
7572 <!--chtml endif-->, depending on the
7573 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
7574 configuration setting; or, the file name must be specified as a full path name
7575 <!--chtml if pinemode="os_windows"-->
7576 -- for example: &quot;A:&#92;PAPER.TXT&quot;
7577 <!--chtml else-->
7578 -- for example: &quot;/tmp/wisdom-of-the-day&quot;
7579 <!--chtml endif-->
7580 (without the quotation marks).
7581
7582 <P>
7583 The file will be inserted where the cursor is located.  <B>The
7584 file to be read must be on the same system as Alpine.</B> If you use Alpine on a
7585 Unix machine but have files on a PC or Mac, the files must be transferred
7586 to the system Alpine is running on before they can be read.  Please ask your
7587 local computer support people about the correct way to transfer a file to
7588 your Alpine system.
7589
7590 <P>
7591 &lt;End of help on this topic&gt;
7592 </BODY>
7593 </HTML>
7594 ======= h_config_tray_icon =======
7595 <HTML>
7596 <HEAD>
7597 <TITLE>FEATURE: <!--#echo var="FEAT_enable-tray-icon"--></TITLE>
7598 </HEAD>
7599 <BODY>
7600 <H1>FEATURE: <!--#echo var="FEAT_enable-tray-icon"--></H1>
7601
7602 PC-Alpine only.
7603 <P>
7604 This option restores a behavior of previous versions of PC-Alpine.
7605 These
7606 versions, when started, installed a PC-Alpine icon in the notification
7607 tray of Window's Taskbar.  The primary use of this icon was to indicate
7608 new mail arrival by turning red (while the Taskbar icon remained green).
7609 Additionally, the icon now changes to yellow to signify that a mail folder
7610 has been closed unexpectedly.
7611
7612 <P>
7613 Rather than add another icon to the Taskbar, this version of PC-Alpine will
7614 color its Taskbar entry's icon red (as well as the icon in the Window
7615 Title).  This feature is only provided for backwards compatibility.
7616
7617 <P>
7618 &lt;End of help on this topic&gt;
7619 </BODY>
7620 </HTML>
7621 ======= h_common_suspend =======
7622 <HTML>
7623 <HEAD>
7624 <TITLE>Suspend Command</TITLE>
7625 </HEAD>
7626 <BODY>
7627 <H1>Suspend Command</H1>
7628
7629 With the <A HREF="h_config_can_suspend"><!--#echo var="FEAT_enable-suspend"--></A> feature
7630 enabled, you can, at almost any time, temporarily halt your Alpine session,
7631 <!--chtml if pinemode="os_windows"-->
7632 minimizing it into an icon.
7633 <!--chtml else-->
7634 and return to your system prompt.
7635 <!--chtml endif-->
7636
7637 <P>
7638 &lt;End of help on this topic&gt;
7639 </BODY>
7640 </HTML>
7641 ======= h_pipe_command =======
7642 <HTML>
7643 <HEAD>
7644 <TITLE>Pipe Command SubOptions</TITLE>
7645 </HEAD>
7646 <BODY>
7647 <H1>Pipe Command SubOptions</H1>
7648
7649 By default, when you use the Pipe command, the processed text of the
7650 message is sent to the Unix command
7651 you specify and the output is captured by Alpine and shown to you.
7652 (This command is available in PC-Alpine, as well, but there aren't many
7653 Windows commands that work well with piping.)
7654 There are some sub-commands that may be used to alter this behavior.
7655 These are toggles that switch the behavior between two possibilities.
7656 They can be combined in any way you wish.
7657 <P>
7658 By default, the prompt at the bottom of the screen looks like
7659 <P>
7660 <CENTER><SAMP>Pipe message 37 to :</SAMP></CENTER>
7661 <P>
7662 or
7663 <P>
7664 <CENTER><SAMP>Pipe messages to :</SAMP></CENTER>
7665 <P>
7666 if you are piping more than one message.
7667 <P>
7668 The sub-command options are:
7669 <DL>
7670    <DT>Shown Text or Raw Text</DT>
7671    <DD>This option toggles between sending the shown (processed) text
7672 of the message to the Unix command, and sending the
7673 raw (unprocessed) text of the message to the Unix command.
7674 The default is to send the shown text.
7675 The raw version of the message will contain all of the headers and any
7676 MIME encoding that the message contains.
7677 If you've selected the Raw Text then the prompt will have the additional word
7678 &quot;RAW&quot; in it, like
7679 <P>
7680 <CENTER><SAMP>Pipe RAW messages to :</SAMP></CENTER>
7681 <P>
7682 You can experiment with this option by piping to something simple like the
7683 Unix &quot;cat&quot; command.
7684    </DD>
7685    <DT>Captured Output or Free Output</DT>
7686    <DD>This option toggles between having Alpine capture the output of
7687 the Unix pipe command for display, and not capturing it.
7688 If the command you are piping to is a filter that will produce output
7689 you want to view, then you want to capture that output
7690 for display (the default).
7691 If the Unix command doesn't produce output or handles the display itself,
7692 then you want free output.
7693 When you've selected the Free Output option the prompt will change to
7694 <P>
7695 <CENTER><SAMP>Pipe messages to (uncaptured) :</SAMP></CENTER>
7696 <P>
7697    </DD>
7698    <DT>No Delimiter or With Delimiter</DT>
7699    <DD>This option controls whether or not a Unix mailbox style delimiter
7700 will come before the text of the message.
7701 This is the delimiter used in the common Unix mailbox format.
7702 It's the single line that begins with the five characters
7703 &quot;From&quot; followed by a &lt;SPACE&gt; character.
7704 You'll usually only want to include this if the Unix command requires
7705 input in the format of a traditional Unix mailbox file.
7706 When you've selected the With Delimiter option the prompt will change to
7707 <P>
7708 <CENTER><SAMP>Pipe messages to (delimited) :</SAMP></CENTER>
7709 <P>
7710    </DD>
7711    <DT>To Same Pipe or To Individual Pipes</DT>
7712    <DD>This option only shows up if you are running an aggregate
7713 pipe command.
7714 That is, the command was Apply Pipe, not just Pipe.
7715 You have the option of piping all of the selected messages through a
7716 single pipe to a single instance of the Unix command,
7717 or piping each individual message through a separate pipe to separate
7718 instances of the Unix command.
7719 The default is that all of the output will go through a single pipe
7720 to a single instance of the command.
7721 You can try this option with a command like &quot;less&quot;, with Free
7722 Output enabled.
7723 When you've selected the Individual Pipes option the prompt will change to
7724 <P>
7725 <CENTER><SAMP>Pipe messages to (new pipe) :</SAMP></CENTER>
7726 <P>
7727    </DD>
7728 </DL>
7729
7730 <P>
7731 As mentioned earlier, the options can be combined in any way you wish.
7732 You may leave them all off, turn them all on, or turn some of them on
7733 and some of them off.
7734 If you use the pipe command a second time in the same session the default
7735 options will be what you used the last time.
7736
7737 <P>
7738 &lt;End of help on this topic&gt;
7739 </BODY>
7740 </HTML>
7741 ========== h_emptydir_subfolder_name =========
7742 <HTML>
7743 <HEAD>
7744 <TITLE>ENTER SUBFOLDER NAME</TITLE>
7745 </HEAD>
7746 <BODY>
7747 <H1>Enter Subfolder Name</H1>
7748
7749 <P>
7750 This is the name of a new subfolder in the directory you are creating.
7751 Because empty directories are hidden and therefore not useful, you must also
7752 create a subfolder in the directory you are creating in order that the
7753 directory remains visible.
7754 <P>
7755 Alternatively, you may turn off the configuration feature
7756 <A HREF="h_config_quell_empty_dirs"><!--#echo var="FEAT_quell-empty-directories"--></A>
7757 so that empty directories remain visible.
7758 If you do that, you will not be required to create the subfolder when you
7759 create a directory.
7760
7761 <P>
7762 &lt;End of help on this topic&gt;
7763 </BODY>
7764 </HTML>
7765 ========== h_incoming_add_folder_name =========
7766 <HTML>
7767 <HEAD>
7768 <TITLE>ENTER FOLDER NAME</TITLE>
7769 </HEAD>
7770 <BODY>
7771 <H1>Enter Folder Name</H1>
7772
7773 <P>
7774 This is the name of the folder on the previously specified server.
7775 By default the folder name is interpreted as defining a section of your personal
7776 folder area.  This area and how you specify it are defined by the
7777 server, if one is specified.
7778
7779 <P>
7780 To define a folder outside the default area, prefix
7781 the path with the namespace to use when interpreting the
7782 given path.  If a namespace is specified, the folder name begins with the
7783 sharp (#) character followed by the name of the namespace
7784 and then the namespace's path-element-delimiter.  Aside from the
7785 name's format, namespaces can also imply access rights, content
7786 policy, audience, location, and, occasionally, access methods.
7787
7788 <P>
7789 Each server exports its own set (possibly of size one) of
7790 namespaces.
7791 For a more detailed explanation read about
7792 <A HREF="h_folder_name_namespaces">Namespaces</A>.
7793
7794 <P>
7795 To specify the default for INBOX on the server you can usually just enter
7796 &quot;INBOX&quot;, and the server will understand the special meaning of
7797 that word.
7798
7799 <P>
7800 &lt;End of help on this topic&gt;
7801 </BODY>
7802 </HTML>
7803 ========== h_incoming_add_folder_host =========
7804 <HTML>
7805 <HEAD>
7806 <TITLE>ENTER INCOMING FOLDER SERVER</TITLE>
7807 </HEAD>
7808 <BODY>
7809 <H1>Enter Incoming Folder Server</H1>
7810
7811 You are being asked for the name of the server for use with this incoming
7812 folder.
7813 If the folder is on the machine where Alpine is running, then just enter
7814 RETURN without typing a server name.
7815
7816 <P>
7817 If the folder is on an IMAP server then type the server's name followed
7818 by RETURN.
7819 You may use the ^X command if the server is the same as the server that
7820 the INBOX is on.
7821
7822 <P>
7823 You may have to add optional extra information to the server name.
7824 For example, if the IMAP server is using a non-standard port number you
7825 would specify that by appending a colon (:) followed by the port number
7826 to the server name
7827
7828 <P>
7829 <CENTER><SAMP>foo.example.com:port</SAMP></CENTER>
7830 <P>
7831
7832 or you may need to specify a different protocol if the server is not an
7833 IMAP server. For example:
7834
7835 <P>
7836 <CENTER><SAMP>foo.example.com/pop3</SAMP></CENTER>
7837 <P>
7838
7839 for a POP server or
7840
7841 <P>
7842 <CENTER><SAMP>foo.example.com/nntp</SAMP></CENTER>
7843 <P>
7844
7845 for an NNTP news server.
7846 For an explanation of all of the possibilities, see
7847 <A HREF="h_folder_server_syntax">Server Name Syntax</A>
7848 for folders.
7849
7850 <P>
7851 There is a special command (^W) if you want to set up a folder that gets its
7852 mail from a
7853 <A HREF="h_maildrop">Mail Drop</A>.
7854 If you type that command, you will be prompted for the information for
7855 both the Mail Drop folder and the destination folder.
7856
7857 <P>
7858 &lt;End of help on this topic&gt;
7859 </BODY>
7860 </HTML>
7861 ========== h_incoming_add_inbox =========
7862 <HTML>
7863 <HEAD>
7864 <TITLE>ENTER INBOX SERVER</TITLE>
7865 </HEAD>
7866 <BODY>
7867 <H1>Enter INBOX Server</H1>
7868
7869 You are being asked for the name of the server for use with
7870 the INBOX folder.
7871 Type the server's name followed by RETURN.
7872
7873 <P>
7874 You may have to add optional extra information to the server name.
7875 For example, if the server is using a non-standard port number you
7876 would specify that by appending a colon (:) followed by the port number
7877 to the server name
7878
7879 <P>
7880 <CENTER><SAMP>foo.example.com:port</SAMP></CENTER>
7881 <P>
7882
7883 or you may need to specify a different protocol if the server is not an
7884 IMAP server. For example:
7885
7886 <P>
7887 <CENTER><SAMP>foo.example.com/pop3</SAMP></CENTER>
7888 <P>
7889
7890 for a POP server.
7891 <P>
7892
7893 For an explanation of all of the possibilities, see
7894 <A HREF="h_folder_server_syntax">Server Name Syntax</A>
7895 for folders.
7896
7897 <P>
7898 If the INBOX folder is on the machine where Alpine is running, then just enter
7899 RETURN without typing a server name.
7900
7901 <P>
7902 There is a special command (^W) if you want to set up a folder that gets its
7903 mail from a
7904 <A HREF="h_maildrop">Mail Drop</A>.
7905 If you type that command, you will be prompted for the information for
7906 both the Mail Drop folder and the destination folder, which will be used
7907 as your INBOX folder.
7908
7909 <P>
7910 &lt;End of help on this topic&gt;
7911 </BODY>
7912 </HTML>
7913 ========== h_incoming_add_maildrop_destn =========
7914 <HTML>
7915 <HEAD>
7916 <TITLE>ENTER DESTINATION SERVER</TITLE>
7917 </HEAD>
7918 <BODY>
7919 <H1>Enter Destination Server</H1>
7920
7921 You are being asked for the name of the server where the destination
7922 folder is for use with this Mail Drop incoming folder.
7923 That is, you are using a Mail Drop for this incoming folder and
7924 you've already entered
7925 the server and folder name for the Mail Drop.
7926 Now you need to enter the server for the destination folder
7927 where the mail should be copied to.
7928 Mail will come from the Mail Drop and be copied to the destination folder.
7929
7930 <P>
7931 Type the server's name followed by RETURN.
7932 If the folder is local to this computer, just type RETURN without entering
7933 a server name.
7934
7935 <P>
7936 You may have to add optional extra information to the server name.
7937 For example, if the server is using a non-standard port number you
7938 would specify that by appending a colon (:) followed by the port number
7939 to the server name
7940
7941 <P>
7942 <CENTER><SAMP>foo.example.com:port</SAMP></CENTER>
7943 <P>
7944
7945 For an explanation of all of the possibilities, see
7946 <A HREF="h_folder_server_syntax">Server Name Syntax</A>
7947 for folders.
7948
7949 <P>
7950 &lt;End of help on this topic&gt;
7951 </BODY>
7952 </HTML>
7953 ========== h_inbox_add_maildrop_destn =========
7954 <HTML>
7955 <HEAD>
7956 <TITLE>ENTER DESTINATION SERVER</TITLE>
7957 </HEAD>
7958 <BODY>
7959 <H1>Enter Destination Server</H1>
7960
7961 You are being asked for the name of the server where the destination
7962 folder is for use with your Mail Drop INBOX.
7963 That is, you are using a Mail Drop for your INBOX and you've already entered
7964 the server and folder name for the Mail Drop.
7965 Now you need to enter the server for the destination folder
7966 where the mail should be copied to.
7967 Mail will come from the Mail Drop and be copied to the destination folder.
7968
7969 <P>
7970 Type the server's name followed by RETURN.
7971 If the folder is local to this computer, just type RETURN without entering
7972 a server name.
7973
7974 <P>
7975 You may have to add optional extra information to the server name.
7976 For example, if the server is using a non-standard port number you
7977 would specify that by appending a colon (:) followed by the port number
7978 to the server name
7979
7980 <P>
7981 <CENTER><SAMP>foo.example.com:port</SAMP></CENTER>
7982 <P>
7983
7984 For an explanation of all of the possibilities, see
7985 <A HREF="h_folder_server_syntax">Server Name Syntax</A>
7986 for folders.
7987
7988 <P>
7989 &lt;End of help on this topic&gt;
7990 </BODY>
7991 </HTML>
7992 ========== h_inbox_add_maildrop =========
7993 <HTML>
7994 <HEAD>
7995 <TITLE>ENTER MAILDROP SERVER</TITLE>
7996 </HEAD>
7997 <BODY>
7998 <H1>Enter Mail Drop Server</H1>
7999
8000 You are being asked for the name of the Mail Drop server for use with
8001 your INBOX.
8002
8003 <P>
8004 Type the server's name followed by RETURN.
8005
8006 <P>
8007 You may have to add optional extra information to the server name.
8008 For example, if the server is using a non-standard port number you
8009 would specify that by appending a colon (:) followed by the port number
8010 to the server name
8011
8012 <P>
8013 <CENTER><SAMP>foo.example.com:port</SAMP></CENTER>
8014 <P>
8015
8016 or you may need to specify a different protocol if the server is not an
8017 IMAP server. For example:
8018
8019 <P>
8020 <CENTER><SAMP>foo.example.com/pop3</SAMP></CENTER>
8021 <P>
8022
8023 for a POP server or
8024
8025 <P>
8026 <CENTER><SAMP>foo.example.com/nntp</SAMP></CENTER>
8027 <P>
8028
8029 for an NNTP news server.
8030 For an explanation of all of the possibilities, see
8031 <A HREF="h_folder_server_syntax">Server Name Syntax</A>
8032 for folders.
8033
8034 <P>
8035 &lt;End of help on this topic&gt;
8036 </BODY>
8037 </HTML>
8038 ========== h_incoming_add_maildrop =========
8039 <HTML>
8040 <HEAD>
8041 <TITLE>ENTER MAILDROP SERVER</TITLE>
8042 </HEAD>
8043 <BODY>
8044 <H1>Enter Mail Drop Server</H1>
8045
8046 You are being asked for the name of the Mail Drop server for use with
8047 this incoming folder.
8048
8049 <P>
8050 Type the server's name followed by RETURN.
8051 You may use the ^X command if the server is the same as the server that
8052 the INBOX is on.
8053
8054 <P>
8055 You may have to add optional extra information to the server name.
8056 For example, if the server is using a non-standard port number you
8057 would specify that by appending a colon (:) followed by the port number
8058 to the server name
8059
8060 <P>
8061 <CENTER><SAMP>foo.example.com:port</SAMP></CENTER>
8062 <P>
8063
8064 or you may need to specify a different protocol if the server is not an
8065 IMAP server. For example:
8066
8067 <P>
8068 <CENTER><SAMP>foo.example.com/pop3</SAMP></CENTER>
8069 <P>
8070
8071 for a POP server or
8072
8073 <P>
8074 <CENTER><SAMP>foo.example.com/nntp</SAMP></CENTER>
8075 <P>
8076
8077 for an NNTP news server.
8078 For an explanation of all of the possibilities, see
8079 <A HREF="h_folder_server_syntax">Server Name Syntax</A>
8080 for folders.
8081
8082 <P>
8083 If the Mail Drop folder is on the machine where Alpine is running, then just enter
8084 RETURN without typing a server name.
8085
8086 <P>
8087 &lt;End of help on this topic&gt;
8088 </BODY>
8089 </HTML>
8090 ========== h_maildrop =========
8091 <HTML>
8092 <HEAD>
8093 <TITLE>WHAT IS A MAIL DROP?</TITLE>
8094 </HEAD>
8095 <BODY>
8096 <H1>What is a Mail Drop?</H1>
8097
8098 In some situaions it may make sense to have your mail delivered to one
8099 folder (the Mail Drop) and then when you want to read mail that has been
8100 delivered to the Mail Drop folder Alpine will move it to another
8101 destination folder.
8102 Often the Mail Drop will be a remote folder and messages will be moved from
8103 there to a local destination folder.
8104
8105 <P>
8106 One example where this might make sense is if the Mail Drop folder is accessible
8107 only with the POP protocol.
8108 You could designate your POP inbox as the Mail Drop folder and have Alpine move
8109 mail from there to a local (on the same machine Alpine is running on)
8110 destination folder, where you'll read it.
8111
8112 <P>
8113 A Mail Drop may only be used as your Inbox or as an
8114 <A HREF="h_config_enable_incoming">&quot;Incoming folder&quot;</A>.
8115
8116 <P>
8117 There is no attempt to synchronize the contents of the destination folder
8118 with the contents of the Mail Drop folder.
8119 All that happens is that all of the messages in the Mail Drop folder are
8120 copied to the destination folder and then they are deleted and expunged (if possible)
8121 from the Mail Drop folder.
8122 The next time a check for new mail is made, any messages in the Mail
8123 Drop folder are once again copied to the destination folder and deleted
8124 and expunged from the Mail Drop folder.
8125 (If the Mail Drop folder is a news group, then the messages can't be
8126 expunged from the newsgroup. Instead, only Recent messages are copied from
8127 the newsgroup to the destination folder.)
8128
8129 <P>
8130 Configuration of a Mail Drop is a little different from configuration of
8131 a folder that does not use a Mail Drop because you have to specify two
8132 folder names instead of one.
8133 The two folders may be any types of folders that Alpine can normally use.
8134 They don't have to be a remote folder and a local folder, that is
8135 simply the most common usage.
8136 When you use a Mail Drop folder Alpine will periodically re-open the Mail
8137 Drop to check for new mail.
8138 The new-mail checks will happen at the frequency set with the
8139 <A HREF="h_config_mailcheck"><!--#echo var="VAR_mail-check-interval"--></A> option,
8140 but with a minimum time
8141 (<A HREF="h_config_maildropcheck"><!--#echo var="VAR_maildrop-check-minimum"--></A>)
8142 between checks.
8143 Because of this minimum you may notice that new mail does not
8144 appear promptly when you expect it.
8145 The reason for this is to protect the server from over-zealous opening and
8146 closing of the Mail Drop folder.
8147 If the user initiates the check by typing ^L (Ctrl-L) or the Next command when at
8148 the end of the folder index, then the check will happen, regardless of how
8149 long it has been since the previous check.
8150 <P>
8151 If there is new mail, that mail will be copied to the destination folder
8152 and then will be deleted from the Mail Drop.
8153 Note that using a Mail Drop with a local destination folder does not make
8154 sense if you read mail from more than one machine, because the mail is
8155 downloaded to the destination folder (which is accessible from only one
8156 machine) and deleted from the Mail Drop.
8157 <P>
8158 The feature <A HREF="h_config_maildrops_preserve_state"><!--#echo var="FEAT_maildrops-preserve-state"--></A> modifies the operation of Mail Drops.
8159
8160 <P>
8161 The actual syntax used by Alpine for a folder that uses a Mail Drop is:
8162
8163 <P>
8164 <CENTER><SAMP>#move&lt;DELIM&gt;&lt;MailDropFolder&gt;&lt;DELIM&gt;&lt;DestinationFolder&gt;</SAMP></CENTER>
8165 <P>
8166 The brackets are not literal.
8167 <P>
8168 <CENTER><SAMP>&lt;DELIM&gt;</SAMP></CENTER>
8169 <P>
8170 is a single character that does not appear in the MailDropFolder name.
8171 If the name doesn't contain spaces then it can be a space character.
8172 The two folder names are full technical
8173 <A HREF="h_valid_folder_names">folder names</A>
8174 as used by Alpine.
8175 Here are a couple examples to give you an idea what is being talked about:
8176
8177 <P>
8178 <CENTER><SAMP>#move&nbsp;{popserver.example.com/pop3}inbox&nbsp;localfolder</SAMP></CENTER>
8179 <P>
8180 <CENTER><SAMP>#move+{nntpserver.example.com/nntp}#news.comp.mail.pine+local&nbsp;folder</SAMP></CENTER>
8181 <P>
8182
8183 A #move folder may only be used as an
8184 <A HREF="h_config_enable_incoming">&quot;Incoming folder&quot;</A> or
8185 an Inbox.
8186 When you are in the FOLDER LIST of Incoming Message Folders (after turning
8187 on the
8188 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="FEAT_enable-incoming-folders"-->&quot;</A>
8189 option)
8190 the Add command has a subcommand &quot;Use Mail Drop&quot;
8191 which may be helpful for defining the folder in your Alpine configuration.
8192 The same is true when you edit the
8193 <A HREF="h_config_inbox_path"><!--#echo var="VAR_inbox-path"--></A>
8194 option in Setup/Config.
8195 Each of these configuration methods will also create the DestinationFolder
8196 if it doesn't already exist.
8197 If you are having problems, make sure the DestinationFolder exists.
8198
8199 <P>
8200 &lt;End of help on this topic&gt;
8201 </BODY>
8202 </HTML>
8203 ========== h_save =========
8204 <HTML>
8205 <HEAD>
8206 <TITLE>CHOOSE A FOLDER TO SAVE INTO</TITLE>
8207 </HEAD>
8208 <BODY>
8209 <H1>Choose a Folder to Save Into</H1>
8210
8211 After Exiting from this help text,
8212 type the name of the folder you want to save into and press RETURN.
8213 <P>
8214 Press ^T to get a list of your folders to choose from.
8215 Press ^C to cancel the Save.
8216 <P>
8217 If you have Folder Collections defined you may use
8218 Ctrl-P (Previous collection) and Ctrl-N (Next collection) to switch
8219 the collection being saved to.
8220 <P>
8221 If Tab Completion is enabled (it is enabled by default)
8222 you may type a Tab character to have Alpine complete the folder name for you.
8223 <P>
8224 If Partial Match Lists is enabled (it is enabled by default) you may type
8225 Ctrl-X to get a list of matches to the prefix you've typed in so far.
8226 <P>
8227 If the Ctrl-R subcommand is present that means you can decide to Delete or
8228 not Delete the message you are saving after you save it.
8229 The label on that key gives the action to switch to.
8230 If it says Delete and you type Ctrl-R the label displayed will change to
8231 No Delete and the source message will be deleted after the save. If it
8232 says No Delete and you type Ctrl-R the label displayed will change to
8233 Delete and the message will not be deleted.
8234 You can control the default for the Delete parameter with the
8235 configuration feature <!--#echo var="FEAT_save-will-not-delete"-->.
8236 <P>
8237 Similarly, if the Ctrl-W subcommand is present that means you can decide
8238 to Preserve the order of the messages being saved or not.
8239 If it is labeled Preserve Order and you type Ctrl-W, the resulting Saved messages
8240 will be in the same order as you see them in the source folder now.
8241 The opposite action (which is usually the default) is that you don't care
8242 about the order.
8243 The Saved messages may or may not be in the same order in the destination folder.
8244 There may be a performance penalty for choosing to save the messages in order.
8245 You can control the default for the Preserve Order parameter with the
8246 configuration feature
8247 <!--#echo var="FEAT_save-aggregates-copy-sequence"-->.
8248
8249 <P>
8250 If you haven't disabled the Save Input History and you've already done a
8251 Save earlier in this session then you may use the Up and Down arrows to retrieve
8252 a folder name used in a previous Save.
8253
8254 <P>
8255 &lt;End of help on this topic&gt;
8256 </BODY>
8257 </HTML>
8258 ============= h_simple_index ========================
8259 <HTML>
8260 <HEAD>
8261 <TITLE>SELECT POSTPONED MESSAGE</TITLE>
8262 </HEAD>
8263 <BODY>
8264 <H1>POSTPONED MESSAGE SELECTION COMMANDS</H1>
8265 <!--chtml if pinemode="function_key"-->
8266 <PRE>
8267 Navigating the List of Messages               General Alpine Commands
8268 -------------------------------               -----------------------
8269  F5   Move to previous message                 F1   Show this help text
8270  F6   Move to next message
8271  F7   Show previous screen of messages
8272  F8   Show next screen of messages
8273
8274 Message Selection Commands
8275 --------------------------
8276  F3   Exit the Message Select menu (canceling Send command)
8277  F4   Select the currently highlighted message
8278  F9   Mark the currently highlighted message as deleted
8279  F10  Undelete (remove deletion mark from) the highlighted message
8280 </PRE>
8281 <!--chtml else-->
8282 <PRE>
8283 Navigating the List of Messages               General Alpine Commands
8284 -------------------------------               -----------------------
8285   P  Move to previous message                  ?  Show this help text
8286   N  Move to next message
8287   -  Show previous screen of messages
8288  Spc (space bar) Show next screen of messages
8289
8290 Message Selection Commands
8291 --------------------------
8292   E  Exit the Message Select menu (canceling Send command)
8293   S  Select the currently highlighted message
8294   D  Mark the currently highlighted message as deleted
8295   U  Undelete (remove deletion mark from) the highlighted message
8296 </PRE>
8297 <!--chtml endif-->
8298 <P>
8299 <H2>Description of the Select Postponed Message Screen</H2>
8300
8301 This screen allows you to select one of several previously postponed
8302 messages in order to continue composition.  Your options are very limited
8303 -- the screen is not meant to let you manipulate these messages.  However,
8304 you may now delete messages from this list.  Once you choose a message,
8305 Alpine reads it in and puts you into the regular message composer.
8306 <P>
8307
8308 Messages do not stay in this postponed state automatically.  If you select
8309 a message and then want to postpone it again, use the normal postpone
8310 (Ctrl-O) command in the composer.
8311 <P>
8312
8313 If you exit this screen without selecting a message, the Compose command
8314 that got you here is canceled.  Other than messages explicitly marked
8315 &quot;Deleted&quot;, no messages will be removed.
8316
8317 <P>
8318 &lt;End of help on this topic&gt;
8319 </BODY>
8320 </HTML>
8321 ============= h_collection_screen ========================
8322 <HTML>
8323 <HEAD>
8324 <TITLE>COLLECTION LIST screen</TITLE>
8325 </HEAD>
8326 <BODY>
8327 <H1>COLLECTION LIST screen</H1>
8328
8329 The COLLECTION LIST screen is used to select one of your
8330 collection definitions to display the folders they contain.  See
8331 <A HREF="h_what_are_collections">Folder Collections Explained</A> for
8332 detailed explanation of collections.<P>
8333
8334 To manage your collection definitions (Add, Change, Delete, etc.), use
8335 the <A HREF="h_collection_maint">Setup/collectionList</A> command on Alpine's
8336 MAIN MENU.
8337
8338 <P>
8339 &lt;End of help on this topic&gt;
8340 </BODY>
8341 </HTML>
8342 ============= h_collection_maint ========================
8343 <HTML>
8344 <HEAD>
8345 <TITLE>SETUP COLLECTION LIST screen</TITLE>
8346 </HEAD>
8347 <BODY>
8348 <H1>SETUP COLLECTION LIST screen</H1>
8349
8350 The SETUP COLLECTION LIST screen lets you manage your collection
8351 definitions.  See
8352 <A HREF="h_what_are_collections">Folder Collections Explained</A>
8353 for detailed explanation of collections.<P>
8354
8355 Maintenance commands include:
8356 <DL>
8357 <DT>Change
8358 <!--chtml if pinemode="function_key"-->
8359 (F4)
8360 <!--chtml else-->
8361 (C)
8362 <!--chtml endif-->
8363 </DT>
8364
8365 <DD>Modify attributes of the selected collection definition.
8366
8367 <DT>Add Cltn
8368 <!--chtml if pinemode="function_key"-->
8369 (F9)
8370 <!--chtml else-->
8371 (A)
8372 <!--chtml endif-->
8373 </DT>
8374
8375 <DD>Create a new collection definition.
8376 </DD>
8377
8378 <DT>Del Cltn
8379 <!--chtml if pinemode="function_key"-->
8380 (F10)
8381 <!--chtml else-->
8382 (D)
8383 <!--chtml endif-->
8384 </DT>
8385
8386 <DD>Delete the selected collection definition.<BR>
8387 NOTE: The folders and directories referred to by the
8388 collection definition are <EM>NOT</EM> deleted.  Folders must
8389 be deleted, if that's what you wish to do, from the
8390 <A HREF="h_folder_maint">FOLDER LIST screen</A>, which shows the
8391 individual folders in a collection.
8392 </DD>
8393
8394 <DT>Shuffle
8395 <!--chtml if pinemode="function_key"-->
8396 (F11)
8397 <!--chtml else-->
8398 ($)
8399 <!--chtml endif-->
8400 </DT>
8401
8402 <DD>Change the order of the displayed collections.  Alpine will offer
8403 to move the currently selected collection one position UP
8404 or DOWN.
8405 </DD>
8406 </DL>
8407
8408 <P>
8409 &lt;End of help on this topic&gt;
8410 </BODY>
8411 </HTML>
8412 ============ h_what_are_collections ==========
8413 <HTML>
8414 <HEAD>
8415 <TITLE>Folder Collections Explained</TITLE>
8416 </HEAD>
8417 <BODY>
8418 <H1>Folder Collections Explained</H1>
8419
8420
8421 Those of you with simple mail configurations will just see a list of all the
8422 folders you have when choosing FOLDER LIST from Alpine's MAIN MENU.
8423 The special folders for INBOX, sent mail and saved messages
8424 will appear at the top of the list.  All others are in alphabetical order.
8425 <P>
8426 If you
8427 or your system administrator have defined more than one collection or if
8428 you have a collection (for newsgroups or email folders) defined on your
8429 system, then you will see the COLLECTION LIST screen first when choosing
8430 FOLDER LIST from Alpine's MAIN MENU.
8431 <P>
8432 <H2>Why have multiple folder collections?</H2>
8433 <P>
8434 For Alpine users who only maintain email folders (and not too many) on one host,
8435 a single folder collection is probably sufficient.<P>
8436
8437 However, people who have more than one email account - for example, one
8438 at their university, and one with their personal Internet Service Provider -
8439 will have different sets of folders on different hosts, and they may want to
8440 access them all from the same installation of Alpine, rather than use different
8441 software and/or log into other hosts to manipulate messages in different
8442 accounts.  (If in doubt whether one of your email accounts can be accessed
8443 with Alpine, contact the technical support people for that account.)  Even people
8444 who have only one email account on one host, but have dozens or
8445 hundreds of email folders, may want to arrange these folders together in a
8446 meaningful way.<BR>
8447 That is where multiple collections come in.
8448
8449 <H2>Types of Collections</H2>
8450 <DL>
8451 <DT>INCOMING FOLDERS</DT>
8452 <DD>&quot;Incoming Message Folders&quot;
8453 is a special collection typically used to supplement your single INBOX.
8454 All the folders here are meant to be ones that receive incoming messages,
8455 which you intend to check more or less frequently.
8456 You may have multiple folders like this because you or your systems
8457 administrator have set up an external program or you may have set up
8458 Alpine to filter incoming
8459 messages into different folders, based on certain criteria such as
8460 sender, recipient, or subject; or because you have multiple accounts and
8461 wish to check their INBOXes easily.  This collection is established by
8462 setting the
8463 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="FEAT_enable-incoming-folders"-->&quot;</A>
8464 feature in the SETUP CONFIGURATION screen, which is accessed from the
8465 MAIN MENU.
8466 </DD>
8467
8468 <DT>NEWS</DT>
8469 <DD>You can also define a collection specifically for
8470 newsgroups.  Alpine does this for you implicitly when you
8471 <A HREF="h_config_nntp_server">define an NNTP Server</A>
8472 in your Alpine configuration.  The news collection appears last in the
8473 COLLECTION LIST (though you can shuffle it up in the order of presentation),
8474 and Alpine knows not to save messages there.
8475 </DD>
8476
8477 <DT>DEFAULT COLLECTION</DT>
8478 <DD>This is the default collection for your saved and sent messages folders.
8479 </DD>
8480 </DL>
8481
8482 <P>
8483
8484 <H2>Defining Collections</H2>
8485 <P>
8486 In the absence of any folder-collection definitions, Alpine will assume a
8487 single default folder collection.
8488 <!--chtml if pinemode="os_windows"-->
8489 <!--chtml else-->
8490 If necessary, Alpine will create the directory
8491 &quot;mail&quot; in your Unix home directory
8492 to hold your folders.
8493 <!--chtml endif-->
8494 <P>
8495 You can use the
8496 <A HREF="h_collection_maint">Setup/collectionList screen</A>, called up from
8497 the MAIN MENU, to manage your collection list.
8498 <P>
8499 &lt;End of help on this topic&gt;
8500 </BODY>
8501 </HTML>
8502 ===== h_select_address_screen =====
8503 <HTML>
8504 <HEAD>
8505 <TITLE>SELECT AN ADDRESS SCREEN</TITLE>
8506 </HEAD>
8507 <BODY>
8508 <H1>SELECT AN ADDRESS SCREEN</H1>
8509 <H2>COMMANDS</H2>
8510 <!--chtml if pinemode="function_key"-->
8511 <PRE>
8512 Available  Commands
8513 -------------------------------
8514 F1  Show Help Text
8515 F3  Exit without selecting anything
8516 F4  Select the highlighted address
8517 F5  Move highlight to previous address
8518 F6  Move highlight to next address
8519 F7  Previous page of addresses
8520 F8  Next page of addresses
8521 F11 Print
8522 F12 WhereIs
8523 </PRE>
8524 <!--chtml else-->
8525 <PRE>
8526 Navigation                     General Alpine Commands
8527 -------------------------      -----------------------
8528  P  Prev Address                ?  Display this help text
8529  N  Next Address                E  Exit without selecting anything
8530  -  Previous page               %  Print
8531 Spc (space bar) Next page
8532  W  WhereIs
8533
8534 Select Command
8535 ------------------------------------------------
8536  S  Select the highlighted address
8537 </PRE>
8538 <!--chtml endif-->
8539
8540 <H2>Description of the Select Address Screen</H2>
8541
8542 This screen gives you an easy way to select an address from all of
8543 the address book entries that match the prefix typed so far.
8544
8545 <P><UL>
8546 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
8547 </UL>
8548 <P>
8549 &lt;End of help on this topic&gt;
8550 </BODY>
8551 </HTML>
8552 ===== h_select_rule_screen =====
8553 <HTML>
8554 <HEAD>
8555 <TITLE>SELECT A RULE SCREEN</TITLE>
8556 </HEAD>
8557 <BODY>
8558 <H1>SELECT A RULE SCREEN</H1>
8559 <H2>COMMANDS</H2>
8560 <!--chtml if pinemode="function_key"-->
8561 <PRE>
8562 Available  Commands
8563 -------------------------------
8564 F1  Show Help Text
8565 F3  Exit without selecting anything
8566 F4  Select the highlighted rule
8567 F5  Move highlight to previous rule
8568 F6  Move highlight to next rule
8569 F7  Previous page of rules
8570 F8  Next page of rules
8571 F11 Print
8572 F12 WhereIs
8573 </PRE>
8574 <!--chtml else-->
8575 <PRE>
8576 Navigation                     General Alpine Commands
8577 -------------------------      -----------------------
8578  P  Prev Rule                   ?  Display this help text
8579  N  Next Rule                   E  Exit without selecting anything
8580  -  Previous page               %  Print
8581 Spc (space bar) Next page
8582  W  WhereIs
8583
8584 Select Command
8585 ------------------------------------------------
8586  S  Select the highlighted rule
8587 </PRE>
8588 <!--chtml endif-->
8589
8590 <H2>Description of the Select Rule Screen</H2>
8591
8592 This screen just gives you an easy way to select a rule from all of your
8593 defined rules.
8594 The list of rules presented is the list of nicknames of all of the rules
8595 defined using Setup/Rules.
8596 For selecting messages, it is likely that the Indexcolor rules and possibly
8597 the Roles rules will be most useful.
8598 The others are there also, in case you find a use for them.
8599 <P>
8600 In order for this to be useful for selecting messages, the nicknames of
8601 the rules have to be different.
8602 Alpine actually just gets the nickname of the rule that you select and then
8603 looks up that rule using the nickname.
8604 So if there are duplicate nicknames, the first rule that has that
8605 nickname will be used.
8606
8607 <P><UL>
8608 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
8609 </UL>
8610 <P>
8611 &lt;End of help on this topic&gt;
8612 </BODY>
8613 </HTML>
8614 ===== h_select_priority_screen =====
8615 <HTML>
8616 <HEAD>
8617 <TITLE>SELECT A PRIORITY SCREEN</TITLE>
8618 </HEAD>
8619 <BODY>
8620 <H1>SELECT A PRIORITY SCREEN</H1>
8621 <H2>COMMANDS</H2>
8622 <!--chtml if pinemode="function_key"-->
8623 <PRE>
8624 Available  Commands
8625 -------------------------------
8626 F1  Show Help Text
8627 F3  Exit without selecting anything
8628 F4  Select the highlighted priority
8629 F5  Move highlight to previous priority
8630 F6  Move highlight to next priority
8631 F7  Previous page of priorities
8632 F8  Next page of priorities
8633 F11 Print
8634 F12 WhereIs
8635 </PRE>
8636 <!--chtml else-->
8637 <PRE>
8638 Navigation                     General Alpine Commands
8639 -------------------------      -----------------------
8640  P  Prev Priority               ?  Display this help text
8641  N  Next Priority               E  Exit without selecting anything
8642  -  Previous page               %  Print
8643 Spc (space bar) Next page
8644  W  WhereIs
8645
8646 Select Command
8647 ------------------------------------------------
8648  S  Select the highlighted priority
8649 </PRE>
8650 <!--chtml endif-->
8651
8652 <H2>Description of the Select Priority Screen</H2>
8653
8654 This screen gives you a way to select a priority for the message you are sending.
8655 This priority will be placed in the non-standard X-Priority header of your outgoing mail.
8656 Some mail programs will display an indication of the priority level to
8657 the recipient of the message, some will ignore it.
8658 Even in cases where the mail programs of both the sender and the recipient
8659 agree on the meaning of this header, keep in mind that it is
8660 something that the sender sets so it is only an indication
8661 of the priority that the sender attaches to the mail.
8662 Alpine can be made to display an indication of this priority in incoming
8663 messages by use of one of the tokens
8664 (<A HREF="h_index_tokens">Tokens for Index and Replying</A>)
8665 PRIORITY, PRIORITYALPHA, or PRIORITY! in the
8666 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option.
8667
8668 <P><UL>
8669 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
8670 </UL>
8671 <P>
8672 &lt;End of help on this topic&gt;
8673 </BODY>
8674 </HTML>
8675 ===== h_select_keyword_screen =====
8676 <HTML>
8677 <HEAD>
8678 <TITLE>SELECT A KEYWORD SCREEN</TITLE>
8679 </HEAD>
8680 <BODY>
8681 <H1>SELECT A KEYWORD SCREEN</H1>
8682 <H2>COMMANDS</H2>
8683 <!--chtml if pinemode="function_key"-->
8684 <PRE>
8685 Available  Commands
8686 -------------------------------
8687 F1  Show Help Text
8688 F3  Exit without selecting anything
8689 F4  Select the highlighted keyword
8690 F5  Move highlight to previous keyword
8691 F6  Move highlight to next keyword
8692 F7  Previous page of keywords
8693 F8  Next page of keywords
8694 F11 Print
8695 F12 WhereIs
8696 </PRE>
8697 <!--chtml else-->
8698 <PRE>
8699 Navigation                     General Alpine Commands
8700 -------------------------      -----------------------
8701  P  Prev Keyword                ?  Display this help text
8702  N  Next Keyword                E  Exit without selecting anything
8703  -  Previous page               %  Print
8704 Spc (space bar) Next page
8705  W  WhereIs
8706
8707 Select Command
8708 ------------------------------------------------
8709  S  Select the highlighted keyword
8710 </PRE>
8711 <!--chtml endif-->
8712
8713 <H2>Description of the Select Keyword Screen</H2>
8714
8715 This screen just gives you an easy way to select a keyword.
8716 The list of keywords presented is the list of all keywords defined in your
8717 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option.
8718 If you have given a keyword a nickname, that nickname is displayed
8719 instead of the actual keyword.
8720
8721 <P><UL>
8722 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
8723 </UL>
8724 <P>
8725 &lt;End of help on this topic&gt;
8726 </BODY>
8727 </HTML>
8728 ===== h_select_charset_screen =====
8729 <HTML>
8730 <HEAD>
8731 <TITLE>SELECT A CHARACTER SET SCREEN</TITLE>
8732 </HEAD>
8733 <BODY>
8734 <H1>SELECT A CHARACTER SET SCREEN</H1>
8735 <H2>COMMANDS</H2>
8736 <!--chtml if pinemode="function_key"-->
8737 <PRE>
8738 Available  Commands
8739 -------------------------------
8740 F1  Show Help Text
8741 F3  Exit without selecting anything
8742 F4  Select the highlighted character set
8743 F5  Move highlight to previous character set
8744 F6  Move highlight to next character set
8745 F7  Previous page of character sets
8746 F8  Next page of character sets
8747 F11 Print
8748 F12 WhereIs
8749 </PRE>
8750 <!--chtml else-->
8751 <PRE>
8752 Navigation                     General Alpine Commands
8753 -------------------------      -----------------------
8754  P  Prev Character Set          ?  Display this help text
8755  N  Next Character Set          E  Exit without selecting anything
8756  -  Previous page               %  Print
8757 Spc (space bar) Next page
8758  W  WhereIs
8759
8760 Select Command
8761 ------------------------------------------------
8762  S  Select the highlighted character set
8763 </PRE>
8764 <!--chtml endif-->
8765
8766 <H2>Description of the Select A Character Set Screen</H2>
8767
8768 This screen just gives you an easy way to select a character set from the
8769 set of character sets Alpine knows about.
8770 The list presented will vary slightly depending on what option you are
8771 selecting the character set for.
8772
8773 <P><UL>
8774 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
8775 </UL>
8776 <P>
8777 &lt;End of help on this topic&gt;
8778 </BODY>
8779 </HTML>
8780 ===== h_select_multcharsets_screen =====
8781 <HTML>
8782 <HEAD>
8783 <TITLE>SELECT CHARACTER SETS SCREEN</TITLE>
8784 </HEAD>
8785 <BODY>
8786 <H1>SELECT CHARACTER SETS SCREEN</H1>
8787 <H2>COMMANDS</H2>
8788 <!--chtml if pinemode="function_key"-->
8789 <PRE>
8790 Available  Commands
8791 -------------------------------
8792 F1  Show Help Text
8793 F3  Exit without selecting anything
8794 F4  Select the highlighted charset (or chosen charsets in ListMode)
8795 F5  Move highlight to previous charset
8796 F6  Move highlight to next charset
8797 F7  Previous page of charsets
8798 F8  Next page of charsets
8799 F9  Toggle choices when using ListMode
8800 F10 Turn on/off ListMode (makes it easy to choose multiple charsets)
8801 F11 Print
8802 F12 WhereIs
8803 </PRE>
8804 <!--chtml else-->
8805 <PRE>
8806 Navigation                     General Alpine Commands
8807 -------------------------      -----------------------
8808  P  Prev Charset                ?  Display this help text
8809  N  Next Charset                E  Exit without selecting anything
8810  -  Previous page               %  Print
8811 Spc (space bar) Next page
8812  W  WhereIs
8813
8814 Select Command
8815 ------------------------------------------------
8816  S  Select the highlighted charset (or chosen charsets in ListMode)
8817  L  Turn on ListMode (makes it easy to choose multiple charsets)
8818  1  Turn off ListMode
8819  X  Toggle choices when using ListMode
8820 </PRE>
8821 <!--chtml endif-->
8822
8823 <H2>Description of the Select Character Set Screen</H2>
8824
8825 This screen just gives you an easy way to select a character set or a list of
8826 character sets.
8827 The list of character sets presented is the list of all character sets known to
8828 Alpine.
8829 You may select other character sets by typing them in directly.
8830
8831 <P><UL>
8832 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
8833 </UL>
8834 <P>
8835 &lt;End of help on this topic&gt;
8836 </BODY>
8837 </HTML>
8838 ===== h_select_multkeyword_screen =====
8839 <HTML>
8840 <HEAD>
8841 <TITLE>SELECT KEYWORDS SCREEN</TITLE>
8842 </HEAD>
8843 <BODY>
8844 <H1>SELECT KEYWORDS SCREEN</H1>
8845 <H2>COMMANDS</H2>
8846 <!--chtml if pinemode="function_key"-->
8847 <PRE>
8848 Available  Commands
8849 -------------------------------
8850 F1  Show Help Text
8851 F3  Exit without selecting anything
8852 F4  Select the highlighted keyword (or chosen keywords in ListMode)
8853 F5  Move highlight to previous keyword
8854 F6  Move highlight to next keyword
8855 F7  Previous page of keywords
8856 F8  Next page of keywords
8857 F9  Toggle choices when using ListMode
8858 F10 Turn on/off ListMode (makes it easy to choose multiple keywords)
8859 F11 Print
8860 F12 WhereIs
8861 </PRE>
8862 <!--chtml else-->
8863 <PRE>
8864 Navigation                     General Alpine Commands
8865 -------------------------      -----------------------
8866  P  Prev Keyword                ?  Display this help text
8867  N  Next Keyword                E  Exit without selecting anything
8868  -  Previous page               %  Print
8869 Spc (space bar) Next page
8870  W  WhereIs
8871
8872 Select Command
8873 ------------------------------------------------
8874  S  Select the highlighted keyword (or chosen keywords in ListMode)
8875  L  Turn on ListMode (makes it easy to choose multiple keywords)
8876  1  Turn off ListMode
8877  X  Toggle choices when using ListMode
8878 </PRE>
8879 <!--chtml endif-->
8880
8881 <H2>Description of the Select Keyword Screen</H2>
8882
8883 This screen just gives you an easy way to select a keyword or a list of
8884 keywords.
8885 The list of keywords presented is the list of all keywords defined in your
8886 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option.
8887 If you have given a keyword a nickname, that nickname is displayed
8888 instead of the actual keyword.
8889
8890 <P><UL>
8891 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
8892 </UL>
8893 <P>
8894 &lt;End of help on this topic&gt;
8895 </BODY>
8896 </HTML>
8897 ===== h_select_incoming_to_monitor =====
8898 <HTML>
8899 <HEAD>
8900 <TITLE>SELECT FOLDERS TO CHECK SCREEN</TITLE>
8901 </HEAD>
8902 <BODY>
8903 <H1>SELECT FOLDERS TO CHECK SCREEN</H1>
8904 <H2>COMMANDS</H2>
8905 <!--chtml if pinemode="function_key"-->
8906 <PRE>
8907 Available  Commands
8908 -------------------------------
8909 F1  Show Help Text
8910 F3  Exit without selecting anything
8911 F4  Select the marked folders
8912 F5  Move highlight to previous folder
8913 F6  Move highlight to next folder
8914 F7  Previous page of folders
8915 F8  Next page of folders
8916 F9  Toggle choices on or off
8917 F11 Print
8918 F12 WhereIs
8919 </PRE>
8920 <!--chtml else-->
8921 <PRE>
8922 Navigation                     General Alpine Commands
8923 -------------------------      -----------------------
8924  P  Prev Folder                 ?  Display this help text
8925  N  Next Folder                ^C  exit without changing anything
8926  -  Previous page               %  Print
8927 Spc (space bar) Next page
8928  W  WhereIs
8929
8930 Select Command
8931 ------------------------------------------------
8932  S  Select the marked folders
8933  X  Toggle choices on or off
8934 </PRE>
8935 <!--chtml endif-->
8936
8937 <H2>Description of the Select Folders to Check Screen</H2>
8938
8939 This screen is only useful if the feature
8940 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
8941 is set.
8942 By default, when you set that feature all of your incoming folders
8943 will be checked periodically for Unseen messages.
8944 By using this screen, you may restrict the set of monitored folders to
8945 a subset of all of the incoming folders.
8946 <P>
8947 Mark the folders you want to monitor for Unseen messages with
8948 an &quot;X&quot;.
8949 When you've finished marking all your selections use the Select
8950 command to register your choices.
8951 To return to the default of checking all incoming folders
8952 delete all folders or unmark all folders.
8953
8954 <P><UL>
8955 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
8956 </UL>
8957 <P>
8958 &lt;End of help on this topic&gt;
8959 </BODY>
8960 </HTML>
8961 ===== h_role_select =====
8962 <HTML>
8963 <HEAD>
8964 <TITLE>ROLES SCREEN</TITLE>
8965 </HEAD>
8966 <BODY>
8967 <H1>ROLES SCREEN</H1>
8968 <H2>ROLES COMMANDS</H2>
8969 <!--chtml if pinemode="function_key"-->
8970 <PRE>
8971 Available  Commands
8972 -------------------------------
8973 F1  Show Help Text
8974 F3  Exit without a selection
8975 F4  Select a role to use in composition
8976 F5  Move to previous role
8977 F6  Move to next role
8978 F7  Previous page of roles
8979 F8  Next page of roles
8980 F11 Change Default Role
8981 F12 Whereis (search role nicknames)
8982 </PRE>
8983 <!--chtml else-->
8984 <PRE>
8985 Navigation                     General Alpine Commands
8986 -------------------------      -----------------------
8987  P  Prev Role                     ?  Display this help text
8988  N  Next Role                     E  Exit without a selection
8989  -  Previous page
8990 Spc (space bar) Next page
8991  W  WhereIs (search for word in role nicknames)
8992
8993 Select Role Commands
8994 ------------------------------------------------
8995  [Return]  Select highlighted role
8996  D         Change Default Role
8997 </PRE>
8998 <!--chtml endif-->
8999
9000 <H2>Description of the Roles Screen</H2>
9001
9002 With this screen you select a role to be used in the composition of a
9003 message.
9004 Use the Previous and Next commands to highlight the role you wish to
9005 use.
9006 When you type carriage return you will be placed in the composer using the highlighted role.
9007 <P>
9008 You don't have any non-default <A HREF="h_rules_roles">roles</A>
9009 available unless you set them up.
9010 You may do so by using the Setup/Rules command on the MAIN MENU.
9011 <P>
9012 By using the D command, you may set a default role that will persist until
9013 you change it or until you exit Alpine.
9014 The D command toggles through three states: set the default role, unset the
9015 default role, and leave the default role as it is.
9016 <P><UL>
9017 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
9018 </UL>
9019 <P>
9020 &lt;End of help on this topic&gt;
9021 </BODY>
9022 </HTML>
9023 ===== h_role_abook_select =====
9024 <HTML>
9025 <HEAD>
9026 <TITLE>SELECT ADDRESS BOOK SCREEN</TITLE>
9027 </HEAD>
9028 <BODY>
9029 <H1>SELECT ADDRESS BOOK SCREEN</H1>
9030 <H2>COMMANDS</H2>
9031 <!--chtml if pinemode="function_key"-->
9032 <PRE>
9033 Available  Commands
9034 -------------------------------
9035 F1  Show Help Text
9036 F3  Exit screen without selecting anything
9037 F4  Select highlighted address book
9038 F5  Move to previous address book
9039 F6  Move to next address book
9040 F7  Previous page of address books
9041 F8  Next page of address books
9042 F12 Whereis
9043 </PRE>
9044 <!--chtml else-->
9045 <PRE>
9046 Navigation                     General Alpine Commands
9047 -------------------------      -----------------------
9048  P  Previous addrbook          ?  Display this help text
9049  N  Next addrbook
9050  -  Previous page
9051 Spc (space bar) Next page
9052  W  WhereIs
9053
9054 Select Role Commands
9055 ------------------------------------------------
9056  S  Select highlighted address book
9057  E  Exit screen without selecting anything
9058 </PRE>
9059 <!--chtml endif-->
9060
9061 <H2>Description of the Select Address Book Screen</H2>
9062
9063 This screen helps you select one of your address books.
9064 Use the Previous and Next commands to highlight the address book you wish to
9065 select.
9066 <P><UL>
9067 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
9068 </UL>
9069 <P>
9070 &lt;End of help on this topic&gt;
9071 </BODY>
9072 </HTML>
9073 ======== h_rule_patterns =============
9074 <HTML>
9075 <HEAD>
9076 <TITLE>PATTERNS</TITLE>
9077 </HEAD>
9078 <BODY>
9079 <H1>PATTERNS</H1>
9080 Patterns are used with Roles, Filtering, Index Coloring,
9081 Scoring, Other Rules, and Search Rules.
9082 Patterns are compared with a message to see if there is a match.
9083 For Filtering, the messages being checked are all the messages in the
9084 folder, one at a time.
9085 For Index Line Coloring, each message that is visible on the screen is
9086 checked for matches with the Index Coloring Patterns.
9087 Roles are used with the Reply, Forward, and Compose commands.
9088 For Reply, the message used to compare the Pattern with is the message
9089 being replied to;
9090 for Forward, the message used to compare the Pattern with is the message
9091 being forwarded;
9092 and for Compose, there is no message, so the parts of the Pattern that depend
9093 on a message (everything other than Current Folder Type and the
9094 Beginning of Month and Year)
9095 are not used.
9096 Only the Current Folder Type matters for Compose (plus the Beginning of
9097 Month or Year, which you wouldn't usually use for a Role).
9098 For Scoring, the message being scored is compared with all of the Score
9099 Patterns, and the Score Values from the ones that match are added together to
9100 get the message's score.
9101 For Other Rules, there is no message. Only the Current Folder Type is checked
9102 for Other Rules.
9103 <P>
9104 Each Pattern has several possible parts, all of which are optional.
9105 In order for there to be a match, <EM>ALL</EM> of the
9106 <EM>defined</EM> parts of the Pattern must match the message.
9107 If a part is not defined it is considered a match, but note that a filtering
9108 Pattern must have at least one defined part or it will be ignored.
9109 For example, if the To pattern is not defined it will be
9110 displayed as
9111 <P>
9112 <CENTER>To pattern = &lt;No Value Set&gt;</CENTER>
9113 <P>
9114 That is considered a match because it is not defined.
9115 This means that the Pattern with nothing defined is a match if the
9116 Current Folder Type matches, but there is an exception that was mentioned
9117 in the previous paragraph.
9118 Because filtering is a potentially destructive action, filtering Patterns
9119 with nothing other than Current Folder Type defined are ignored.
9120 If you really want a filtering Pattern to match all messages (subject to
9121 Current Folder Type) the best way to do it is to define a Score interval
9122 that includes all possible scores.
9123 This would be the score interval <SAMP>(-INF,INF)</SAMP>.
9124 This can be used even if you haven't defined any rules to Set Scores.
9125 <P>
9126 There are six predefined header patterns called the To, From, Sender, Cc, News,
9127 and Subject patterns.
9128 Besides those six predefined header patterns, you may add
9129 additional header patterns with header fieldnames of your choosing.
9130 You add an extra header pattern by placing the cursor on one of the
9131 patterns while in the role editor and using the &quot;eXtraHdr&quot; command.
9132 The Recip pattern is a header pattern that stands for Recipient (To OR Cc)
9133 and the Partic pattern is a header pattern that stands for
9134 Participant (From OR To OR Cc).
9135 (Defining the Recip pattern does not have the same effect as defining both
9136 the To and Cc patterns. Recip is To <EM>OR</EM> Cc, not To <EM>AND</EM> Cc.)
9137 Similar to the header patterns are the AllText pattern and the BodyText pattern.
9138 Instead of comparing this pattern's text against only the contents of
9139 a particular header field, the text for the AllText pattern is compared
9140 with text anywhere in the message's header or body, and the text for the
9141 BodyText pattern is compared with text anywhere in the message's body.
9142 <P>
9143 Any of the header patterns, the AllText pattern, or the BodyText pattern may be negated with the
9144 &quot;!&quot; &quot;toggle NOT&quot; command.
9145 You can tell that <EM>NOT</EM> has been turned on by looking for the character
9146 &quot;!&quot; at the beginning of the pattern line.
9147 When the &quot;!&quot; is present, it reverses the meaning of the match.
9148 That is, if the pattern matches then it is considered to NOT be a match, and
9149 if it does not match it is considered to be a match.
9150 <P>
9151 Don't make the mistake of putting the &quot;!&quot; in the data field for
9152 a pattern.
9153 For example, if you type the characters &quot;!urgent&quot; into the Subject
9154 pattern, the pattern will look like:
9155 <P>
9156 <PRE>
9157  Subject pattern = !urgent
9158 </PRE>
9159 <P>
9160 This means you want to match the 7 character sequence &quot;!urgent&quot;.
9161 In order to match messages that do not have &quot;urgent&quot; in
9162 their Subject field, first type the characters &quot;urgent&quot; followed
9163 by carriage return for the value of the Subject pattern, then negate it
9164 by typing the &quot;!&quot; command.
9165 It should look like
9166 <P>
9167 <PRE>
9168  ! Subject pattern = urgent
9169 </PRE>
9170 <P>
9171 The contents of each of these header patterns (or the AllText or BodyText patterns) may
9172 be a complete email address, part of an address, or a random set of
9173 characters to match against.
9174 It may also be a list of such patterns, which means you
9175 are looking for a match against the first pattern in the list <EM>OR</EM>
9176 the second pattern <EM>OR</EM> the third and so on.
9177 For example, a Subject pattern equal to
9178 <P>
9179 <PRE>
9180  Subject pattern = urgent
9181                    emergency
9182                    alert
9183 </PRE>
9184 <P>
9185 would match all messages with a subject that contained at least one
9186 of those words.
9187 It would also match subjects containing the words &quot;alerts&quot; or
9188 &quot;Urgently&quot;.
9189 <P>
9190 The same example with &quot;NOT&quot; turned on would be
9191 <P>
9192 <PRE>
9193  ! Subject pattern = urgent
9194                      emergency
9195                      alert
9196 </PRE>
9197 <P>
9198 which would match all messages with a subject that did <EM>NOT</EM> contain any of
9199 those words.
9200 You can use the &quot;Add Value&quot; command to add new words to the list,
9201 or you can enter them as a comma-separated list.
9202 <P>
9203 (It is not possible to specify two patterns that must <EM>BOTH</EM> be
9204 present for a match.
9205 It is only possible to specify that <EM>EITHER</EM> pattern1 <EM>OR</EM>
9206 pattern2 must be present,
9207 and that is exactly what using a list does.)
9208 <P>
9209 The &quot;Current Folder Type&quot; and the &quot;Score Interval&quot; are
9210 also part of the Pattern, although the &quot;Score Interval&quot; is not used
9211 when checking for matches for Scoring.
9212 There are five similar settings that relate to the status of the message.
9213 These settings rely on the message being New or not, Deleted or not,
9214 Answered or not, Important or not, and Recent or not.
9215 There are also some other miscellaneous settings.
9216 The first is the Age of the message in days.
9217 Another is the Size of the message, in bytes.
9218 The third is a setting that detects whether or not the Subject of a
9219 message contains raw 8-bit characters (unencoded characters with the most
9220 significant bit set).
9221 There is a setting that detects whether or not this is the first time
9222 Alpine has been run this month (doesn't depend on individual messages),
9223 and another that detects whether or not this is the first time Alpine has
9224 been run this year.
9225 Other parts of the Pattern detect whether or not the From address of a
9226 message appears in your address book, whether or not certain keywords
9227 are set for a message, and whether or not certain character sets are
9228 used in a message.
9229
9230 <H2>Parts of a Pattern</H2>
9231
9232 <H3>Header patterns</H3>
9233
9234 A header pattern is simply text that is searched for in the corresponding
9235 header field.
9236 For example, if a Pattern has a From header pattern with the value
9237 &quot;@company.com&quot;, then only messages that have a From header
9238 that contains the text &quot;@company.com&quot; will be possible
9239 matches.
9240 Matches don't have to be exact.
9241 For example, if the relevant field of a message contains the text
9242 &quot;mailbox@domain&quot; somewhere
9243 in it, then header patterns of &quot;box&quot;, or &quot;x@d&quot;, or
9244 &quot;mailbox@domain&quot; are all matches.
9245 <P>
9246 All parts of the Pattern must match so, for example,
9247 if a message matches a defined
9248 From pattern, it still must be checked against the other parts of the
9249 Pattern that have been defined.
9250 The To header pattern is a slightly special case.
9251 If the message being checked has a Resent-To header
9252 and the feature <A HREF="h_config_use_resentto"><!--#echo var="FEAT_use-resent-to-in-rules"--></A> is turned on, the addresses
9253 there are used in place of the addresses in the To header.
9254 This is only true for the To header.
9255 Resent-cc and Resent-From headers are never used unless you add them
9256 with the eXtraHdrs command.
9257 <P>
9258 The meaning of a header pattern may be negated with the
9259 &quot;!&quot; &quot;toggle NOT&quot; command.
9260 You can tell that <EM>NOT</EM> has been turned on by looking for the character
9261 &quot;!&quot; at the beginning of the pattern line.
9262 It would look something like
9263 <P>
9264 <PRE>
9265  ! From pattern = susan@example.com
9266 </PRE>
9267 <P>
9268 When the &quot;!&quot; is present, it reverses the meaning of the match.
9269 <P>
9270 If you want to check for the presence of a header field but don't care
9271 about its value, then
9272 the empty pattern that you get by entering a pair of
9273 double quotes (&quot;&quot;) should match any message that
9274 has the corresponding header field.
9275
9276 <H3><A NAME="pattern_alltext">AllText patterns</A></H3>
9277
9278 AllText patterns are just like header patterns except that the text is
9279 searched for anywhere in the message's headers or body, not just in the
9280 contents of a particular header field.
9281 <P>
9282
9283 <H3><A NAME="pattern_bodytext">BodyText patterns</A></H3>
9284
9285 BodyText patterns are just like header patterns except that the text is
9286 searched for anywhere in the message's body, not just in the
9287 contents of a particular header field.
9288 <P>
9289
9290 If there is more than one header pattern or AllText pattern or BodyText pattern
9291 for which you want to take the
9292 same action there is a shorthand notation that may be used.
9293 Any of these patterns may be a list of patterns instead of
9294 just a single pattern.
9295 If any one of the patterns in the list matches the message
9296 then it is considered a match.
9297 For example, if &quot;company1&quot; and &quot;company2&quot; both required
9298 you to use the same role when replying to messages, you might have
9299 a To pattern that looks like
9300 <P>
9301 <PRE>
9302  To pattern = company1.com
9303               company2.com
9304 </PRE>
9305 <P>
9306 This means that if the mail you are replying to was addressed to
9307 either &quot;anything@company1.com&quot; or &quot;anything@company2.com&quot;,
9308 then this Pattern is a match and the same actions will be taken.
9309 <P>
9310 The meaning of an AllText or BodyText pattern may be negated with the
9311 &quot;!&quot; &quot;toggle NOT&quot; command.
9312 You can tell that <EM>NOT</EM> has been turned on by looking for the character
9313 &quot;!&quot; at the beginning of the pattern line.
9314 When the &quot;!&quot; is present, it reverses the meaning of the match.
9315 <P>
9316 A technicality: Since comma is the character used to separate multiple values
9317 in any of the fields that may have multiple values (such as header patterns,
9318 AllText patterns, BodyText patterns, keywords, folder lists, and so on),
9319 you must escape comma with a
9320 backslash (&#92;) if you want to include a literal comma in one of those fields.
9321 In other words, if you type a backslash followed by a comma it will
9322 be interpreted as a comma by Alpine, instead of as a separator between
9323 pattern values.
9324 All other backslashes (those not followed by a comma) are literal
9325 backslashes and should not be escaped.
9326 It's unlikely you'll ever need to enter a literal comma or backslash in
9327 any of the patterns.
9328
9329 <H3><A NAME="pattern_current_folder">Current Folder Type</A></H3>
9330
9331 The &quot;Current Folder Type&quot; may be set to one of four different
9332 values: &quot;Any&quot;, &quot;News&quot;, &quot;Email&quot;, or
9333 &quot;Specific&quot;.
9334 If the value is set to &quot;News&quot;, then the
9335 Pattern will only match if the currently open folder is a newsgroup.
9336 The value &quot;Email&quot; only matches if the current folder is not news and
9337 the value &quot;Any&quot; causes any folder to match.
9338 If the value of &quot;Current Folder Type&quot; is set to &quot;Specific&quot;,
9339 then you must fill in a value for &quot;Folder&quot;, which is on the line
9340 below the &quot;Specific&quot; line.
9341 In this case you will only get a match if the currently open folder is
9342 the specific folder you list.
9343 You may give a list of folders instead of just a single
9344 folder name, in which case the Pattern will match if the open folder is
9345 any one of the folders in the list.
9346 The name of each folder in the list may be either &quot;INBOX&quot;,
9347 the technical specification
9348 of the folder (like what appears in your configuration file) or, if the
9349 folder is one of your incoming folders, it may be the nickname you've given
9350 the folder.
9351 Here are some samples of specific folder names:
9352 <P>
9353 <CENTER><SAMP>{monet.art.example.com}mail/art-class</SAMP></CENTER>
9354 <P>
9355 <CENTER><SAMP>{news.example.com/nntp}#news.comp.mail.pine</SAMP></CENTER>
9356 <P>
9357 <CENTER><SAMP>mail/local-folder</SAMP></CENTER>
9358 <P>
9359 The easiest way to fill in the &quot;Folder&quot; field is to use
9360 the &quot;T&quot; command that is available when the &quot;Folder&quot; line is
9361 highlighted, or to use the &quot;Take&quot; command with the configuration
9362 feature
9363 <A HREF="h_config_enable_role_take">&quot;<!--#echo var="FEAT_enable-rules-under-take"-->&quot;</A>
9364 turned on.
9365 <P>
9366 When reading a newsgroup, there may be a performance penalty
9367 incurred when collecting the information necessary to check whether
9368 or not a Pattern matches a message.
9369 For this reason, the default Current Folder Type is set to &quot;Email&quot;.
9370 If you have Patterns with a Current Folder Type of either
9371 &quot;Any&quot; or &quot;News&quot; and those Patterns are used for
9372 Index Line Coloring or Scoring, you may experience
9373 slower screen redrawing in the MESSAGE INDEX screen when in a newsgroup.
9374
9375 <H3><A NAME="pattern_age_interval">Age Interval</A></H3>
9376
9377 The &quot;Age Interval&quot; may be set to an interval of message
9378 ages that should be considered a match.
9379 Like the other parts of the Pattern, if it is unset it will be ignored.
9380 The Age Interval looks like
9381 <P>
9382 <CENTER><SAMP>(min_age,max_age)</SAMP></CENTER>
9383 <P>
9384 where &quot;min_age&quot; and &quot;max_age&quot; are integers greater
9385 than or equal to zero.
9386 The special value &quot;INF&quot; may be used for
9387 the max value. It represents infinity.
9388 <P>
9389 Actually, this option may be defined as a list of intervals instead
9390 of just a single interval.
9391 The list is separated by commas.
9392 It can look like
9393 <P>
9394 <CENTER><SAMP>(min_age1,max_age1),(min_age2,max_age2),...</SAMP></CENTER>
9395 <P>
9396 When there is an Age Interval defined, it is a match if the age, in days, of
9397 the message is contained in any of the intervals.
9398 The intervals include both endpoints.
9399 <P>
9400 Even though this option is called Age, it isn't actually
9401 the <EM>age</EM> of the message.
9402 Instead, it is how many days ago the message arrived in one of your folders.
9403 If the current time is a little past midnight, then a message that arrived
9404 just before midnight arrived yesterday, even though the message is only
9405 a few minutes old.
9406 By default, the date being used is not the date in the Date
9407 header of the message.
9408 It is the date that the message arrived in one of your folders.
9409 When you Save a message from one folder to another that arrival date
9410 is preserved.
9411 If you would like to use the date in the Date header that is possible.
9412 Turn on the option
9413 <A HREF="h_config_filt_opts_sentdate">&quot;Use-Date-Header-For-Age&quot;</A>
9414 near the bottom of the rule definition.
9415 A value of 0 is today, 1 is yesterday, 2 is the day before yesterday, and so on.
9416
9417 <H3><A NAME="pattern_size_interval">Size Interval</A></H3>
9418
9419 The &quot;Size Interval&quot; may be set to an interval of message
9420 sizes that should be considered a match.
9421 Like the other parts of the Pattern, if it is unset it will be ignored.
9422 The Size Interval looks like
9423 <P>
9424 <CENTER><SAMP>(min_size,max_size)</SAMP></CENTER>
9425 <P>
9426 where &quot;min_size&quot; and &quot;max_size&quot; are integers greater
9427 than or equal to zero.
9428 The special value &quot;INF&quot; may be used for
9429 the max value. It represents infinity.
9430 <P>
9431 Actually, this option may be defined as a list of intervals instead
9432 of just a single interval.
9433 The list is separated by commas.
9434 It can look like
9435 <P>
9436 <CENTER><SAMP>(min_size1,max_size1),(min_size2,max_size2),...</SAMP></CENTER>
9437 <P>
9438 When there is a Size Interval defined, it is a match if the size, in bytes, of
9439 the message is contained in any of the intervals.
9440 The intervals include both endpoints.
9441
9442 <H3><A NAME="pattern_score_interval">Score Interval</A></H3>
9443
9444 The &quot;Score Interval&quot; may be set to an interval of message
9445 scores that should be considered a match.
9446 Like the other parts of the Pattern, if it is unset it will be ignored.
9447 The Score Interval looks like
9448 <P>
9449 <CENTER><SAMP>(min_score,max_score)</SAMP></CENTER>
9450 <P>
9451 where &quot;min_score&quot; and &quot;max_score&quot; are positive or
9452 negative integers, with min_score less than or equal to max_score.
9453 The special values &quot;-INF&quot; and &quot;INF&quot; may be used for
9454 the min and max values to represent negative and positive infinity.
9455 <P>
9456 Actually, a list of intervals may be used if you wish.
9457 A list would look like
9458 <P>
9459 <CENTER><SAMP>(min_score1,max_score1),(min_score2,max_score2),...</SAMP></CENTER>
9460 <P>
9461 When there is a Score Interval defined, it is a match if the score for
9462 the message is contained in any of the intervals in the list.
9463 The intervals include the endpoints.
9464 The score for a message is calculated by looking at every Score rule defined and
9465 adding up the Score Values for the ones that match the message.
9466 When deciding whether or not a Pattern matches a message for purposes of
9467 calculating the score, the Score Interval is ignored.
9468
9469 <H3><A NAME="pattern_message_status">Message Status</A></H3>
9470
9471 There are five separate message status settings.
9472 By default, all five are set to the value &quot;Don't care&quot;, which
9473 will match any message.
9474 The value &quot;Yes&quot; means that the particular status must be true
9475 for a match, and the value &quot;No&quot; means that the particular
9476 status must not be true for a match.
9477 For example, one of the five Message Status settings is whether a message
9478 is marked Important or not.
9479 A &quot;Yes&quot; means that the message must be Important to be
9480 considered a match and &quot;No&quot; means that the message must not be
9481 Important to be considered a match.
9482 The same is true of the other four message status settings that depend
9483 on whether or not the message is New; whether the message has
9484 been Answered or not; whether the message has been Deleted or not, and
9485 whether the message is Recent or not.
9486 <P>
9487 The nomenclature for New and Recent is a bit confusing:
9488 <P>
9489 New means that the message is Unseen.
9490 It could have been in your mailbox for a long time but if you haven't looked
9491 at it, it is still considered New.
9492 That matches the default Alpine index display that shows an N for such a
9493 message.
9494 <P>
9495 Recent means that the message was added to this folder since the last time
9496 you opened the folder.
9497 Alpine also shows an N by default for these types of messages.
9498 If you were to run two copies of Alpine that opened a folder one right after
9499 the other, a message would only show up as Recent in (at most) the first
9500 Alpine session.
9501
9502 <H3><A NAME="pattern_message_keywords">Message Keywords</A></H3>
9503
9504 Keywords are similar to Message Status, but they are chosen by the user.
9505 Provided the mail server allows for it, you may add a set of possible keywords
9506 to a folder and then you may set those keywords or not for each message
9507 in the folder (see <A HREF="h_common_flag">Flag Command</A>).
9508 The syntax of this part of the Pattern is similar to the header patterns.
9509 It is a list of keywords.
9510 The Keyword part of the Pattern is a match if the message has any of
9511 the keywords in the list set.
9512 Like other parts of the Pattern, if this is unset it will be ignored.
9513
9514 <H3><A NAME="pattern_message_charsets">Message Character Sets</A></H3>
9515
9516 A message may use one or more character sets.
9517 This part of the Pattern matches messages that make use of one or more of
9518 the character sets specified in the pattern.
9519 It will be considered a match if a message uses any of the character
9520 sets in the list you give here.
9521
9522 <P>
9523 Besides actual character set names (for example, ISO-8859-7, KOI8-R, or
9524 GB2312) you may also use some shorthand names that Alpine provides.
9525 These names are more understandable shorthand names for sets of
9526 character set names.
9527 Two examples are &quot;Cyrillic&quot; and &quot;Greek&quot;.
9528 Selecting one of these shorthand names is equivalent to selecting all of
9529 the character sets that make up the set.
9530 You can see all of these shorthand names and the lists of character sets
9531 they stand for by typing the &quot;T&quot; command with the Character
9532 Set pattern highlighted.
9533 The syntax of this part of the Pattern is similar to the header patterns
9534 and the Message Keywords pattern.
9535 It is a list of character sets (or shorthand names).
9536 The Character Set part of the Pattern is a match if the message uses any
9537 of the character sets in the list.
9538 Like other parts of the Pattern, if this is unset it will be ignored.
9539
9540 <H3><A NAME="pattern_8bit_subject">Raw 8-bit in Subject</A></H3>
9541
9542 It seems that lots of unwanted email contains unencoded 8-bit characters
9543 in the Subject.
9544 Normally, characters with the 8th bit set are not allowed in the Subject
9545 header unless they are MIME-encoded.
9546 This option gives you a way to match messages that have Subjects that
9547 contain unencoded 8-bit characters.
9548 By default, the value of this option is &quot;Don't care&quot;, which
9549 will match any message.
9550 The value &quot;Yes&quot; means that there must be raw 8-bit characters in
9551 the Subject of the message in order for there to be a match,
9552 and the value &quot;No&quot; is the opposite.
9553 Setting this option will affect performance in large folders because the
9554 subject of each message in the folder has to be checked.
9555
9556 <H3><A NAME="pattern_bom">Beginning of Month</A></H3>
9557
9558 This option gives you a way to take some action once per month.
9559 By default, the value of this option is &quot;Don't care&quot;, which
9560 will always match.
9561 The value &quot;Yes&quot; means that this must be the first time Alpine has
9562 been run this month in order to count as a match,
9563 and the value &quot;No&quot; is the opposite.
9564
9565 <H3><A NAME="pattern_boy">Beginning of Year</A></H3>
9566
9567 This option gives you a way to take some action once per year.
9568 By default, the value of this option is &quot;Don't care&quot;, which
9569 will always match.
9570 The value &quot;Yes&quot; means that this must be the first time Alpine has
9571 been run this year in order to count as a match,
9572 and the value &quot;No&quot; is the opposite.
9573
9574 <H3><A NAME="pattern_abookfrom">Address in Address Books</A></H3>
9575
9576 This option gives you a way to match messages that have an address
9577 that is in one of your address books.
9578 Only the simple entries in your address books are searched.
9579 Address book distribution lists are ignored!
9580 By default, the value of this option is &quot;Don't care&quot;, which
9581 will match any message.
9582 The value &quot;Yes, in any address book&quot; means the address
9583 from the message must be in at least one of your
9584 address books in order to be a match.
9585 The value &quot;No, not in any address book&quot;
9586 means none of the addresses may
9587 be in any of your address books in order to be a match.
9588 The values &quot;Yes, in specific address books&quot; and
9589 &quot;No, not in any of specific address books&quot; are similar but instead
9590 of depending on all address books you are allowed to give a list of address
9591 books to look in.
9592 The addresses from the message that are checked for are determined by the
9593 setting you have for &quot;Types of addresses to check for in address book&quot;.
9594 If you set this to &quot;From&quot; the From address from the message will
9595 be looked up in the address book.
9596 If you set it to only &quot;To&quot; then the To addresses will be used.
9597 If any of the To addresses are in the address book then it is considered
9598 a match for &quot;Yes&quot; or not a match for &quot;No&quot;.
9599 You could set it to both From and To, in which case all of the From and To
9600 addresses are used.
9601 The &quot;Reply-To&quot; and &quot;Sender&quot; cases are a little unusual.
9602 Due to deficiencies in our tools, Reply-To uses the Reply-To address if it
9603 exists or the From address if there is no Reply-To address.
9604 Same for the Sender address.
9605 Setting this option may affect performance in large folders because the
9606 From and Reply-To of each message in the folder have to be checked.
9607
9608 <H3><A NAME="pattern_categorizer">Categorizer Command</A></H3>
9609
9610 This is a command that is run with its standard input set to the message
9611 being checked and its standard output discarded.
9612 The full directory path should be specified.
9613 The command will be run and then its exit status will be checked against
9614 the Exit Status Interval, which defaults to just the value zero.
9615 If the exit status of the command falls in the interval, it is considered
9616 a match, otherwise it is not a match.
9617 <P>
9618
9619 This option may actually be a list of commands.
9620 The first one that exists and is executable is used.
9621 That makes it possible to use the same configuration with Unix Alpine and
9622 PC-Alpine.
9623 <P>
9624
9625 If none of the commands in the list exists and is executable then the rule
9626 is <EM>not</EM> a match.
9627 If it is possible that the command may not exist, you should be careful
9628 to structure your rules so that nothing destructive
9629 happens when the command does not exist.
9630 For example, you might have a filter that filters away spam when there is
9631 a match but does nothing when there is not a match.
9632 That would continue to work correctly if the command didn't exist.
9633 However, if you have a filter that filters away spam when there is not
9634 a match and keeps it when there is a match, that would filter everything
9635 if the categorizer command didn't exist.
9636 <P>
9637 Here is an <A HREF="h_config_role_cat_cmd_example">example</A>
9638 setup for the bogofilter filter.
9639
9640 <P>
9641 &lt;End of help on this topic&gt;
9642 </BODY>
9643 </HTML>
9644 ===== h_rules_roles =====
9645 <HTML>
9646 <HEAD>
9647 <TITLE>SETUP ROLES SCREEN</TITLE>
9648 </HEAD>
9649 <BODY>
9650 <H1>SETUP ROLES SCREEN</H1>
9651 <H2>SETUP ROLES COMMANDS</H2>
9652 <!--chtml if pinemode="function_key"-->
9653 <PRE>
9654 Available  Commands -- Group 1         Available Commands -- Group 2
9655 -------------------------------        ------------------------------
9656 F1  Show Help Text                      F1  Show Help Text
9657 F2  See commands in next group          F2  See commands in next group
9658 F3  Back to MAIN Alpine menu
9659 F4  Change configuration for role
9660 F5  Move to previous role               F5  Include file in role config
9661 F6  Move to next role                   F6  Exclude file from config
9662 F7  Previous page of roles
9663 F8  Next page of roles
9664 F9  Add new role                        F9  Replicate existing role
9665 F10 Delete existing role
9666 F11 Shuffle the order of roles
9667 F12 Whereis (search role nicknames)
9668 </PRE>
9669 <!--chtml else-->
9670 <PRE>
9671 Navigation                     General Alpine Commands
9672 -------------------------      -----------------------
9673  P  Prev Role                     ?  Display this help text
9674  N  Next Role                     E  Back to MAIN Alpine menu
9675  -  Previous page
9676 Spc (space bar) Next page
9677  W  WhereIs (search for word in role nicknames)
9678
9679 Setup Roles Commands
9680 ------------------------------------------------
9681  A  Add new role                  $  Shuffle the order of roles
9682  D  Delete existing role          C  Change configuration for highlighted role
9683  R  Replicate existing role
9684  I  Include file in role config   X  Exclude file from role config
9685 </PRE>
9686 <!--chtml endif-->
9687
9688 <H2>Description of the Setup Roles Screen</H2>
9689
9690 This screen lets you add, delete, modify, or change the order of the rules
9691 that determine the role you are playing when composing a message.
9692 <P>
9693 You may play different roles depending on who you are replying to.
9694 For example, if you are replying to a message addressed to help-desk you
9695 may be acting as a Help Desk Worker.
9696 That role may require that you use a different return address and/or
9697 a different signature.
9698 <P>
9699 Roles are optional.
9700 If you set up roles they work like this:  Each role has a set of
9701 &quot;Uses&quot;, which indicate whether or not a role is eligible to be
9702 considered for a particular use; a &quot;Pattern&quot;,
9703 which is used to decide which of the eligible roles is used; and a set
9704 of &quot;Actions&quot;, which are taken when that role is used.
9705 When you reply to a message, the message you are replying to is compared
9706 with the Patterns of the roles marked as eligible for use when replying.
9707 The comparisons start with the first eligible role and keep going until there
9708 is a match.
9709 If a match is found, the matching role's Actions are taken.
9710 <P>
9711 It is also possible to set a default role and to change that role during
9712 your Alpine session.
9713 When you start Alpine no default role will be set.
9714 You may set or change the current default role by using the &quot;D&quot;
9715 command in the role selection screen.
9716 You'll see that screen while composing a message and being asked to select
9717 a role.
9718 An easy way to get to that screen is to use the <A HREF="h_common_role">Role Command</A> to
9719 compose a message.
9720 You may find a default role useful if you normally perform the duties of one
9721 of your roles for a while, then you switch to another role and stay in the
9722 new role for another period of time.
9723 It may be easier than using the Role Command to select the role each time you
9724 compose a message.
9725
9726 <H2>Role Uses</H2>
9727
9728 There are three types of use to be configured;
9729 one for Replying, one for Forwarding, and one for Composing.
9730 These indicate whether or not you want a role to be considered when you
9731 type the Reply, Forward, or Compose commands.
9732 (The Role command is an alternate form of the Compose command, and it is
9733 not affected by these settings.)
9734 Each of these Use types has three possible values.
9735 The value &quot;Never&quot;
9736 means that the role will never be considered as a candidate for use with
9737 the corresponding command.
9738 For example, if you set a role's Reply Use to Never, then when you Reply to
9739 a message, that role won't even be considered.
9740 (That isn't quite true. If the message you are replying to matches some other
9741 role that requires confirmation,
9742 then there will be a ^T command available which allows you to select a role
9743 from all of your roles, not just the reply-eligible roles.)
9744 <P>
9745
9746 The options &quot;With confirmation&quot; and &quot;Without confirmation&quot;
9747 both mean that you do want to consider this role when using the corresponding
9748 command.
9749 For either of these settings the role's Pattern will
9750 be checked to see if it matches the message.
9751 For Reply Use, the message used to compare the Pattern with is the message
9752 being replied to.
9753 For Forward Use, the message used to compare the Pattern with is the message
9754 being forwarded.
9755 For Compose Use, there is no message, so the parts of the Pattern that depend
9756 on a message (everything other than Current Folder Type) are ignored.
9757 In all cases, the Current Folder Type is checked if defined.
9758 If there is a match then this role will either be used without confirmation
9759 or will be the default when confirmation is asked for, depending on
9760 which of the two options is selected.
9761 If confirmation is requested, you will have a chance to
9762 choose No Role instead of the offered role, or to
9763 change the role to any one of your other roles (with the ^T command).
9764
9765 <H2>Role Patterns</H2>
9766
9767 In order to determine whether or not a message matches a role the message is
9768 compared with the Role's Pattern.
9769 These Patterns are the same for use with Roles, Filtering, Index Coloring,
9770 Scoring, Other Rules, and Search Rules, so are described in only one place,
9771 &quot;<A HREF="h_rule_patterns">here</A>&quot;.
9772 <P>
9773 Since header patterns, AllText patterns, and BodyText patterns that are unset are ignored,
9774 a role that has all header patterns unset, the AllText pattern unset,
9775 the BodyText pattern unset,
9776 the Score Interval unset, and the Current Folder Type set to
9777 &quot;Any&quot; may be used as a default role.
9778 It should be put last in the list of roles since the matching
9779 starts at the beginning and proceeds until one of the roles is a match.
9780 If no roles at all match, then Alpine will
9781 use its regular methods of defining the role.
9782 If you wanted to, you could define a different &quot;default&quot; role
9783 for Replying, Forwarding, and Composing by setting the
9784 &quot;Use&quot; fields appropriately.
9785
9786 <H2>Role Actions</H2>
9787
9788 Once a role match is found, the role's Actions are taken.
9789 For each role there are several possible actions that may be defined.
9790 They are actions to set the From address, the Reply-To address,
9791 the Fcc, the Signature, the Template file, and Other Headers.
9792
9793 <H3>Set From</H3>
9794
9795 The From address is the address used on the From line of the message
9796 you are sending.
9797
9798 <H3>Set Reply-To</H3>
9799
9800 The Reply-To address is the address used on the Reply-To line of the message
9801 you are sending.
9802 You don't need a Reply-To address unless it is different from the From address.
9803
9804 <H3>Set Other Headers</H3>
9805
9806 If you want to set the value of the From or Reply-To headers, use
9807 the specific fields &quot;Set From&quot; or &quot;Set Reply-To&quot;.
9808 If you want to set the values of other headers, use this field.
9809 This field is similar to the
9810 <A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A> configuration option.
9811 Each header you specify here must include the header tag
9812 (&quot;To:&quot;, &quot;Approved:&quot;, etc.)
9813 and may optionally include a value for that header.
9814 It is different from the <!--#echo var="VAR_customized-hdrs"--> in that the value you give
9815 for a header here will replace any value that already exists.
9816 For example, if you are Replying to a message there will be at least one
9817 address in the To header (the address you are Replying to).
9818 However, if you Reply using a role that sets the To header, that role's
9819 To header value will be used instead.
9820
9821 <H3>Set Fcc</H3>
9822
9823 The Fcc is used as the Fcc for the message you are sending.
9824
9825 <H3>Set Signature or Set LiteralSig</H3>
9826
9827 The Signature is the name of a file to be used as the signature file when
9828 this role is being used.
9829 If the name of the file has a vertical bar following it (|)
9830 then it is assumed that the file is a program that should be run to
9831 produce the signature.
9832 If the LiteralSig is set, then it is used instead of the signature file.
9833 LiteralSig is just a different way to store the signature.
9834 It is stored in the pine configuration file instead of in a separate
9835 signature file.
9836 If the <A HREF="h_config_literal_sig"><!--#echo var="VAR_literal-signature"--></A> option is defined
9837 either in the role or as the default signature in the Setup/Config screen,
9838 then the signature file is ignored.
9839
9840 <H3>Set Template</H3>
9841
9842 A Template is the name of a file to be included in the message when this
9843 role is being used.
9844 If the name of the file has a vertical bar following it (|)
9845 then it is assumed that the file is a program that should be run to
9846 produce the template.
9847
9848 <P>
9849 Both signature files and template files may be stored remotely on an IMAP
9850 server.
9851 In order to do that you just give the file a remote name.
9852 This works just like the regular
9853 <A HREF="h_config_signature_file"><!--#echo var="VAR_signature-file"--></A>
9854 option that is configured from the Setup/Configuration screen.
9855 A remote signature file name might look like:
9856 <P>
9857 <CENTER><SAMP>{myimaphost.myschool.k12.wa.us}mail/sig3</SAMP></CENTER>
9858 <P>
9859 Once you have named the remote signature or template file you create its
9860 contents by using the &quot;F&quot; &quot;editFile&quot; command when the
9861 cursor is on the &quot;Set Signature&quot; or &quot;Set Template&quot;
9862 line of the role editor.
9863
9864 <P>
9865 Both signature files and template files (or the output of signature programs
9866 and template file programs) may contain special tokens
9867 that are replaced with contents
9868 that depend on the message being replied to or forwarded.
9869 See the help for the individual fields inside the role editor for more
9870 information on tokens.
9871
9872 <H3>Use SMTP Server</H3>
9873
9874 If this field has a value, then it will be used as the SMTP server
9875 to send mail when this role is being used (unless the SMTP server variable
9876 is set in the system-wide fixed configuration file).
9877 It has the same semantics as the
9878 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>
9879 variable in the Setup/Config screen.
9880 When you postpone the composition this SMTP server list will be saved
9881 with the postponed composition and it cannot be changed later.
9882 Because of that, you may want to make this a list of SMTP servers
9883 with the preferred server at the front of the list and alternate servers
9884 later in the list.
9885
9886 <P>
9887 If any of the actions are left unset, then the action depends on what
9888 is present in the &quot;Initialize settings using role&quot; field.
9889 If you've listed the nickname of another one of your roles there, then the
9890 corresponding action from that role will be used here.
9891 If that action is also blank, or if there is no nickname specified,
9892 then Alpine will do whatever it normally does to set these actions.
9893 This depends on other configuration options and features you've set.
9894
9895 <H2>Command Descriptions</H2>
9896
9897 <H3>Add</H3>
9898
9899 The Add command is used to add a new role definition to your set of
9900 roles.
9901 The new role will be added after the highlighted role.
9902
9903 <H3>Delete</H3>
9904
9905 The Delete command deletes the currently highlighted role.
9906
9907 <H3>Change</H3>
9908
9909 The Change command lets you edit the nickname, Uses, Pattern,
9910 and Actions of the currently highlighted role.
9911
9912 <H3>Shuffle</H3>
9913
9914 The Shuffle command allows you to change the order of the roles.
9915 You may move the currently highlighted role up or down in the list.
9916 The order of the roles is important since the roles are tested for a
9917 match starting with the first role and continuing until a match is found.
9918 You should place the roles with more specific Patterns near the beginning
9919 of the list, and those with more general Patterns near the end so that
9920 the more specific matches will happen when appropriate.
9921
9922 <H3>Replicate</H3>
9923
9924 The Replicate command is used to copy an existing role and modify it.
9925 The new role will be added after the highlighted role.
9926
9927 <H3>IncludeFile</H3>
9928
9929 The IncludeFile command allows you to add a roles file to your configuration.
9930 Usually, your roles will be contained in your Alpine configuration file.
9931 If you wish, some or all of your roles may be stored in a separate file.
9932 If a roles file already exists (maybe it was made by somebody else using
9933 Alpine), you may insert it before the currently highlighted role.
9934 You may also insert an empty file or a file that does not yet exist.
9935 Once you have an empty roles file in your configuration, you may use
9936 the Shuffle command to move roles into it.
9937 In fact, that's the only way to get the initial role into the file.
9938
9939 <H3>eXcludeFile</H3>
9940
9941 The eXcludeFile command removes a roles file from your roles configuration.
9942 A limitation of the program is that in order to exclude a roles file
9943 that file must have at least one role
9944 in it, otherwise you won't be able to highlight a line in the file.
9945 So you may have to add a dummy role to the file in order to exclude the file.
9946 <P><UL>
9947 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
9948 </UL>
9949 <P>
9950 &lt;End of help on this topic&gt;
9951 </BODY>
9952 </HTML>
9953 ===== h_rules_other =====
9954 <HTML>
9955 <HEAD>
9956 <TITLE>SETUP OTHER RULES SCREEN</TITLE>
9957 </HEAD>
9958 <BODY>
9959 <H1>SETUP OTHER RULES SCREEN</H1>
9960 <H2>SETUP OTHER RULES COMMANDS</H2>
9961 <!--chtml if pinemode="function_key"-->
9962 <PRE>
9963 Available  Commands -- Group 1         Available Commands -- Group 2
9964 -------------------------------        ------------------------------
9965 F1  Show Help Text                      F1  Show Help Text
9966 F2  See commands in next group          F2  See commands in next group
9967 F3  Back to MAIN Alpine menu
9968 F4  Change configuration for rule
9969 F5  Move to previous rule               F5  Include file in rule config
9970 F6  Move to next rule                   F6  Exclude file from config
9971 F7  Previous page of rules
9972 F8  Next page of rules
9973 F9  Add new rule                        F9  Replicate existing rule
9974 F10 Delete existing rule
9975 F11 Shuffle the order of rules
9976 F12 Whereis (search rule nicknames)
9977 </PRE>
9978 <!--chtml else-->
9979 <PRE>
9980 Navigation                     General Alpine Commands
9981 -------------------------      -----------------------
9982  P  Prev rule                     ?  Display this help text
9983  N  Next rule                     E  Back to MAIN Alpine menu
9984  -  Previous page
9985 Spc (space bar) Next page
9986  W  WhereIs (search for word in rule nicknames)
9987
9988 Setup Other Rules Commands
9989 ------------------------------------------------
9990  A  Add new rule                  $  Shuffle the order of rules
9991  D  Delete existing rule          C  Change configuration for highlighted rule
9992  R  Replicate existing rule
9993  I  Include file in rule config   X  Exclude file from rule config
9994 </PRE>
9995 <!--chtml endif-->
9996
9997 <H2>Description of the Setup Other Rules Screen</H2>
9998
9999 This is where you may set various actions that do not fit well into the
10000 other Rules categories.
10001
10002 <H2>Patterns</H2>
10003
10004 Other Rules are a little different from the rest of the Rules because
10005 they depend only on the current folder, and not on a particular message.
10006 In order to determine whether or not a rule's actions should be applied
10007 the current folder is compared with the rule's Pattern, which consists
10008 of only the Current Folder Type.
10009 Current Folder Type works the same for Other Rules as it does for Roles,
10010 Filtering, Index Coloring, and Scoring.
10011 Keep in mind that the only part of the Pattern that applies to Other
10012 Rules is the Current Folder Type when looking at the description of
10013 Patterns given
10014 &quot;<A HREF="h_rule_patterns">here</A>&quot;.
10015
10016 <H2>The Actions</H2>
10017
10018 <H3>Set Sort Order</H3>
10019
10020 When you enter a new folder, these rules will be checked to see if you
10021 have set a sort order that is different from your default sort order.
10022 The default is set in the Setup/Config screen with
10023 the &quot;<A HREF="h_config_sort_key"><!--#echo var="VAR_sort-key"--></A>&quot; option.
10024 If the Sort Order action is set, then the folder will be displayed sorted in
10025 that sort order instead of in the default order.
10026 <P>
10027 A possible point of confusion arises when you change the configuration
10028 of the Sort Order for the currently open folder.
10029 The folder will normally be re-sorted when you go back to viewing the
10030 index.
10031 However, if you have manually sorted the folder with the
10032 Sort
10033 (<!--chtml if pinemode="function_key"-->F7<!--chtml else-->$<!--chtml endif-->)
10034 command, then it will not be re-sorted until the next time it is opened.
10035
10036 <H3>Set Index Format</H3>
10037
10038 When you enter a new folder, these rules will be checked to see if you
10039 have set an Index Format that is different from your default Index Format,
10040 which is set with the
10041 <A HREF="h_config_index_format">&quot;<!--#echo var="VAR_index-format"-->&quot;</A> option.
10042 If so, the index will be displayed with this format instead of the default.
10043
10044 <H3>Set Startup Rule</H3>
10045
10046 When you enter a new folder, these rules will be checked to see if you
10047 have set a startup rule that is different from the default startup rule.
10048 The default for incoming folders is set in the Setup/Config screen with
10049 the &quot;<!--#echo var="VAR_incoming-startup-rule"-->&quot; option.
10050 The default for folders other than INBOX that are not part of your
10051 incoming collection
10052 (see <A HREF="h_config_enable_incoming"><!--#echo var="FEAT_enable-incoming-folders"--></A> feature)
10053 is to start with the last message in the folder.
10054 If the Startup Rule is set to something other than &quot;default&quot;,
10055 then the rule will determine which message will be the current message when
10056 the folder is first opened.
10057 <P>
10058 The various startup rule possibilities work the same here as they do in
10059 the incoming collection, so check
10060 <A HREF="h_config_inc_startup"><!--#echo var="VAR_incoming-startup-rule"--></A>
10061 for more help.
10062
10063 <H2>Command Descriptions</H2>
10064
10065 <H3>Add</H3>
10066
10067 The Add command is used to add a new rule definition to your set of
10068 rules.
10069 The new rule will be added after the highlighted rule.
10070
10071 <H3>Delete</H3>
10072
10073 The Delete command deletes the currently highlighted rule.
10074
10075 <H3>Change</H3>
10076
10077 The Change command lets you edit the nickname, Pattern,
10078 and Action of the currently highlighted rule.
10079
10080 <H3>Shuffle</H3>
10081
10082 The Shuffle command allows you to change the order of the rules.
10083 You may move the currently highlighted rule up or down in the list.
10084 The order of the rules is important since the rules are tested for a
10085 match starting with the first rule and continuing until a match is found.
10086 You should place the rules with more specific Patterns near the beginning
10087 of the list, and those with more general Patterns near the end so that
10088 the more specific matches will happen when appropriate.
10089
10090 <H3>Replicate</H3>
10091
10092 The Replicate command is used to copy an existing rule definition and modify it.
10093 The new rule will be added after the highlighted rule.
10094
10095 <H3>IncludeFile</H3>
10096
10097 The IncludeFile command allows you to add a rules file to your configuration.
10098 Usually, your rules will be contained in your Alpine configuration file.
10099 If you wish, some or all of your rules may be stored in a separate file.
10100 If a rules file already exists (maybe it was made by somebody else using
10101 Alpine), you may insert it before the currently highlighted rule.
10102 You may also insert an empty file or a file that does not yet exist.
10103 Once you have an empty rules file in your configuration, you may use
10104 the Shuffle command to move rules into it.
10105 In fact, that's the only way to get the initial rule into the file.
10106
10107 <H3>eXcludeFile</H3>
10108
10109 The eXcludeFile command removes a rules file from your rules configuration.
10110 A limitation of the program is that in order to exclude a rules file
10111 that file must have at least one rule
10112 in it, otherwise you won't be able to highlight a line in the file.
10113 So you may have to add a dummy rule to the file in order to exclude the file.
10114 <P><UL>
10115 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
10116 </UL>
10117 <P>
10118 &lt;End of help on this topic&gt;
10119 </BODY>
10120 </HTML>
10121 ===== h_rules_srch =====
10122 <HTML>
10123 <HEAD>
10124 <TITLE>SETUP SEARCH RULES SCREEN</TITLE>
10125 </HEAD>
10126 <BODY>
10127 <H1>SETUP SEARCH RULES SCREEN</H1>
10128 <H2>SETUP SEARCH RULES COMMANDS</H2>
10129 <!--chtml if pinemode="function_key"-->
10130 <PRE>
10131 Available  Commands -- Group 1         Available Commands -- Group 2
10132 -------------------------------        ------------------------------
10133 F1  Show Help Text                      F1  Show Help Text
10134 F2  See commands in next group          F2  See commands in next group
10135 F3  Back to MAIN Alpine menu
10136 F4  Change configuration for rule
10137 F5  Move to previous rule               F5  Include file in rule config
10138 F6  Move to next rule                   F6  Exclude file from config
10139 F7  Previous page of rules
10140 F8  Next page of rules
10141 F9  Add new rule                        F9  Replicate existing rule
10142 F10 Delete existing rule
10143 F11 Shuffle the order of rules
10144 F12 Whereis (search rule nicknames)
10145 </PRE>
10146 <!--chtml else-->
10147 <PRE>
10148 Navigation                     General Alpine Commands
10149 -------------------------      -----------------------
10150  P  Prev rule                     ?  Display this help text
10151  N  Next rule                     E  Back to MAIN Alpine menu
10152  -  Previous page
10153 Spc (space bar) Next page
10154  W  WhereIs (search for word in rule nicknames)
10155
10156 Setup Search Rules Commands
10157 ------------------------------------------------
10158  A  Add new rule                  $  Shuffle the order of rules
10159  D  Delete existing rule          C  Change configuration for highlighted rule
10160  R  Replicate existing rule
10161  I  Include file in rule config   X  Exclude file from rule config
10162 </PRE>
10163 <!--chtml endif-->
10164
10165 <H2>Description of the Setup Search Rules Screen</H2>
10166
10167 One of the commands that becomes available when that feature is turned on
10168 is the &quot;; Select&quot; command, which is used in the MESSAGE INDEX
10169 screen to select a set of messages.
10170 One way of selecting messages is to use a Rule.
10171 All of the messages that match (or don't match if you wish)
10172 a Rule's Pattern will be selected.
10173 <P>
10174 Any of your Rules may be used for this purpose.
10175 You might already have Rules set up for filtering, index line color, scores, or roles;
10176 and you may use any of those Rules with the Select command.
10177 However, you might find it more convenient to set up a separate set of Rules
10178 just for this purpose without having to worry about what other effects
10179 they may cause.
10180 That is the purpose of these Select Rules.
10181
10182 <P>
10183 Each rule has a &quot;Pattern&quot;
10184 that is used to decide which messages are selected when you use it with
10185 the Select command.
10186
10187 <H2>Patterns</H2>
10188
10189 In order to determine whether or not a message should be selected
10190 the message is compared with the rule's Pattern.
10191 These Patterns are the same for use with Roles, Filtering, Index Coloring,
10192 Scoring, Other Rules, and Search Rules, so are described in only one place,
10193 &quot;<A HREF="h_rule_patterns">here</A>&quot;.
10194
10195 <H2>Command Descriptions</H2>
10196
10197 <H3>Add</H3>
10198
10199 The Add command is used to add a new rule definition to your set of
10200 rules.
10201 The new rule will be added after the highlighted rule.
10202
10203 <H3>Delete</H3>
10204
10205 The Delete command deletes the currently highlighted rule.
10206
10207 <H3>Change</H3>
10208
10209 The Change command lets you edit the nickname and Pattern
10210 of the currently highlighted rule.
10211
10212 <H3>Shuffle</H3>
10213
10214 The Shuffle command allows you to change the order of the rules.
10215 This affects only the order they are presented in when you use the
10216 ^T subcommand of the Select by Rule command.
10217 You may move the currently highlighted rule up or down in the list.
10218
10219 <H3>Replicate</H3>
10220
10221 The Replicate command is used to copy an existing rule definition and modify it.
10222 The new rule will be added after the highlighted rule.
10223
10224 <H3>IncludeFile</H3>
10225
10226 The IncludeFile command allows you to add a rules file to your configuration.
10227 Usually, your rules will be contained in your Alpine configuration file.
10228 If you wish, some or all of your rules may be stored in a separate file.
10229 If a rules file already exists (maybe it was made by somebody else using
10230 Alpine), you may insert it before the currently highlighted rule.
10231 You may also insert an empty file or a file that does not yet exist.
10232 Once you have an empty rules file in your configuration, you may use
10233 the Shuffle command to move rules into it.
10234 In fact, that's the only way to get the initial rule into the file.
10235
10236 <H3>eXcludeFile</H3>
10237
10238 The eXcludeFile command removes a rules file from your rules configuration.
10239 A limitation of the program is that in order to exclude a rules file
10240 that file must have at least one rule
10241 in it, otherwise you won't be able to highlight a line in the file.
10242 So you may have to add a dummy rule to the file in order to exclude the file.
10243 <P><UL>
10244 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
10245 </UL>
10246 <P>
10247 &lt;End of help on this topic&gt;
10248 </BODY>
10249 </HTML>
10250 ===== h_rules_incols =====
10251 <HTML>
10252 <HEAD>
10253 <TITLE>SETUP INDEX LINE COLORS SCREEN</TITLE>
10254 </HEAD>
10255 <BODY>
10256 <H1>SETUP INDEX LINE COLORS SCREEN</H1>
10257 <H2>SETUP INDEX LINE COLORS COMMANDS</H2>
10258 <!--chtml if pinemode="function_key"-->
10259 <PRE>
10260 Available  Commands -- Group 1         Available Commands -- Group 2
10261 -------------------------------        ------------------------------
10262 F1  Show Help Text                      F1  Show Help Text
10263 F2  See commands in next group          F2  See commands in next group
10264 F3  Back to MAIN Alpine menu
10265 F4  Change configuration for rule
10266 F5  Move to previous rule               F5  Include file in rule config
10267 F6  Move to next rule                   F6  Exclude file from config
10268 F7  Previous page of rules
10269 F8  Next page of rules
10270 F9  Add new rule                        F9  Replicate existing rule
10271 F10 Delete existing rule
10272 F11 Shuffle the order of rules
10273 F12 Whereis (search rule nicknames)
10274 </PRE>
10275 <!--chtml else-->
10276 <PRE>
10277 Navigation                     General Alpine Commands
10278 -------------------------      -----------------------
10279  P  Prev rule                     ?  Display this help text
10280  N  Next rule                     E  Back to MAIN Alpine menu
10281  -  Previous page
10282 Spc (space bar) Next page
10283  W  WhereIs (search for word in rule nicknames)
10284
10285 Setup Index Color Commands
10286 ------------------------------------------------
10287  A  Add new rule                  $  Shuffle the order of rules
10288  D  Delete existing rule          C  Change configuration for highlighted rule
10289  R  Replicate existing rule
10290  I  Include file in rule config   X  Exclude file from rule config
10291 </PRE>
10292 <!--chtml endif-->
10293
10294 <H2>Description of the Setup Index Line Colors Screen</H2>
10295
10296 Index Line Color causes lines in the MESSAGE INDEX screen to be colored.
10297 This action is only available if your terminal is capable of displaying
10298 color and color display has been enabled with the
10299 <A HREF="h_config_color_style">Color Style</A> option within the
10300 Setup Color screen.
10301 (In PC-Alpine, color is always enabled so there is no option to turn on.)
10302 This screen lets you add, delete, modify, or change the order of the rules
10303 that cause the lines in the MESSAGE INDEX to be displayed in different
10304 colors.
10305 <P>
10306 Each rule has a &quot;Pattern&quot;,
10307 which is used to decide which of the rules is used; and the color that
10308 is used if the Pattern matches a particular message.
10309
10310 <H2>Index Color Patterns</H2>
10311
10312 In order to determine whether or not a message matches an Index Color Rule
10313 the message is compared with the rule's Pattern.
10314 These Patterns are the same for use with Roles, Filtering, Index Coloring,
10315 Scoring, Other Rules, and Search Rules, so are described in only one place,
10316 &quot;<A HREF="h_rule_patterns">here</A>&quot;.
10317
10318 <P>
10319 If none of the Index Color rules is a match for a particular index line,
10320 then the color used is set using
10321 the <A HREF="h_color_setup">Setup Kolor</A> screen.
10322
10323 <H2>Index Line Color</H2>
10324
10325 This is the color that index lines are colored when there is a matching
10326 Pattern.
10327 This colors the whole index line, except possibly the status letters,
10328 which may be colored separately using
10329 the <A HREF="h_color_setup">Setup Kolor</A> screen.
10330
10331 <H2>Command Descriptions</H2>
10332
10333 <H3>Add</H3>
10334
10335 The Add command is used to add a new rule definition to your set of
10336 rules.
10337 The new rule will be added after the highlighted rule.
10338
10339 <H3>Delete</H3>
10340
10341 The Delete command deletes the currently highlighted rule.
10342
10343 <H3>Change</H3>
10344
10345 The Change command lets you edit the nickname, Pattern,
10346 and Index Line Color of the currently highlighted rule.
10347
10348 <H3>Shuffle</H3>
10349
10350 The Shuffle command allows you to change the order of the rules.
10351 You may move the currently highlighted rule up or down in the list.
10352 The order of the rules is important since the rules are tested for a
10353 match starting with the first rule and continuing until a match is found.
10354 You should place the rules with more specific Patterns near the beginning
10355 of the list, and those with more general Patterns near the end so that
10356 the more specific matches will happen when appropriate.
10357
10358 <H3>Replicate</H3>
10359
10360 The Replicate command is used to copy an existing rule definition and modify it.
10361 The new rule will be added after the highlighted rule.
10362
10363 <H3>IncludeFile</H3>
10364
10365 The IncludeFile command allows you to add a rules file to your configuration.
10366 Usually, your rules will be contained in your Alpine configuration file.
10367 If you wish, some or all of your rules may be stored in a separate file.
10368 If a rules file already exists (maybe it was made by somebody else using
10369 Alpine), you may insert it before the currently highlighted rule.
10370 You may also insert an empty file or a file that does not yet exist.
10371 Once you have an empty rules file in your configuration, you may use
10372 the Shuffle command to move rules into it.
10373 In fact, that's the only way to get the initial rule into the file.
10374
10375 <H3>eXcludeFile</H3>
10376
10377 The eXcludeFile command removes a rules file from your rules configuration.
10378 A limitation of the program is that in order to exclude a rules file
10379 that file must have at least one rule
10380 in it, otherwise you won't be able to highlight a line in the file.
10381 So you may have to add a dummy rule to the file in order to exclude the file.
10382 <P><UL>
10383 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
10384 </UL>
10385 <P>
10386 &lt;End of help on this topic&gt;
10387 </BODY>
10388 </HTML>
10389 ===== h_rules_filter =====
10390 <HTML>
10391 <HEAD>
10392 <TITLE>SETUP FILTERING SCREEN</TITLE>
10393 </HEAD>
10394 <BODY>
10395 <H1>SETUP FILTERING SCREEN</H1>
10396 <H2>SETUP FILTERING COMMANDS</H2>
10397 <!--chtml if pinemode="function_key"-->
10398 <PRE>
10399 Available  Commands -- Group 1         Available Commands -- Group 2
10400 -------------------------------        ------------------------------
10401 F1  Show Help Text                      F1  Show Help Text
10402 F2  See commands in next group          F2  See commands in next group
10403 F3  Back to MAIN Alpine menu
10404 F4  Change configuration for filter
10405 F5  Move to previous filter             F5  Include file in filter config
10406 F6  Move to next filter                 F6  Exclude file from config
10407 F7  Previous page of filters
10408 F8  Next page of filters
10409 F9  Add new filter                      F9  Replicate existing filter
10410 F10 Delete existing filter
10411 F11 Shuffle the order of filters
10412 F12 Whereis (search filter nicknames)
10413 </PRE>
10414 <!--chtml else-->
10415 <PRE>
10416 Navigation                     General Alpine Commands
10417 -------------------------      -----------------------
10418  P  Prev Filter                   ?  Display this help text
10419  N  Next Filter                   E  Back to MAIN Alpine menu
10420  -  Previous page
10421 Spc (space bar) Next page
10422  W  WhereIs (search for word in filter nicknames)
10423
10424 Setup Filters Commands
10425 ------------------------------------------------
10426  A  Add new filter                $  Shuffle the order of filters
10427  D  Delete existing filter        C  Change configuration for highlighted filter
10428  R  Replicate existing filter
10429  I  Include file in filter config X  Exclude file from filter config
10430 </PRE>
10431 <!--chtml endif-->
10432
10433 <H2>Description of the Setup Filtering Screen</H2>
10434
10435 This screen lets you add, delete, modify, or change the order of the rules
10436 that determine the filtering Alpine does on folders you view.
10437 <P>
10438 The software that actually delivers mail (the stuff that happens
10439 before Alpine is involved) for you is in a better position to do mail filtering
10440 than Alpine itself.
10441 If possible, you may want to look into using that sort of mail filtering to
10442 deliver mail to different folders, delete it, or forward it.
10443 However, if you'd like Alpine to help with this, Alpine's filtering is for you.
10444 <P>
10445 Filtering is a way to automatically move certain messages from one folder
10446 to another or to delete messages.
10447 It can also be used to set message status (Important, Deleted, New,
10448 Answered) and to set <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> for messages.
10449 Alpine doesn't have the ability to forward mail to another address or
10450 to deliver vacation messages.
10451 <P>
10452 Each filtering rule has a &quot;Pattern&quot; and a &quot;Filter Action&quot;.
10453 When a folder is opened, when new mail arrives in an open folder, or
10454 when mail is Expunged from a folder; each
10455 message is compared with the Patterns of your filtering rules.
10456 The comparisons start with the first rule and keep going until there
10457 is a match.
10458 If a match is found, the message may be deleted or moved, depending on
10459 the setting of the Filter Action.
10460 If the message is not deleted, it may have its status altered.
10461
10462 <P>
10463 <EM>NOTE:</EM>
10464 When setting up a Pattern used to delete messages,
10465 it is recommended that you test the Pattern first with a &quot;Move&quot;
10466 folder specified in
10467 case unintended matches occur.  Messages that are deleted will be removed
10468 from the folder and <EM>unrecoverable</EM> from within Alpine after the
10469 next Expunge command or once the folder being filtered has been closed.
10470
10471 <H2>Filter Patterns</H2>
10472
10473 In order to determine whether or not a message matches a filter the message is
10474 compared with the Filter's Pattern.
10475 These Patterns are the same for use with Roles, Filtering, Index Coloring,
10476 Scoring, Other Rules, and Search Rules, so are described in only one place,
10477 &quot;<A HREF="h_rule_patterns">here</A>&quot;.
10478 <P>
10479 Since filtering is a potentially destructive action, if you have a filtering
10480 Pattern with nothing other than Current Folder Type set, that filtering
10481 rule is ignored.
10482
10483 <H2>Filter Actions</H2>
10484
10485 Once a filter match is found for a particular message, there are some actions
10486 that may be taken.
10487 First, the message may have its status changed.
10488 This is the same message status that you can manipulate manually using the
10489 <a href="h_common_flag">Flag Command</a>.
10490 There are always four elements of message status that you can control.
10491 You can set or clear the Important status, the New status, the Deleted
10492 status, and the Answered status.
10493 Of course, if the filter is going to delete the message,
10494 then there is no point in setting message status.
10495 You may also be able to set user-defined keywords for a message.
10496 Read a little about keywords in the help text for the
10497 <A HREF="h_common_flag">Flag</A> command.
10498 <P>
10499 Second, the filter may delete or move the message.
10500 Deleting the message marks it Deleted and removes it from view.
10501 It is effectively gone forever (though it technically is still there until
10502 the next expunge command, which may happen implicitly).
10503 Moving the message moves it from the open folder into the folder
10504 listed on the &quot;Folder List&quot; line of the filter configuration.
10505 If you list more than one folder name (separated by commas) then the message
10506 will be copied to each of those folders.
10507 In any case, if &quot;Delete&quot; or &quot;Move&quot; is set then the
10508 message is removed from the current folder.
10509 If you just want to set the messages status without deleting it from
10510 the folder, then set the filter action to
10511 &quot;Just Set Message Status&quot;.
10512 <P>
10513 (There is no way to do a Copy instead of a Move, due to the difficulties
10514 involved in keeping track of whether or not a message has
10515 already been copied.)
10516
10517 <H2>Command Descriptions</H2>
10518
10519 <H3>Add</H3>
10520
10521 The Add command is used to add a new filter definition to your set of
10522 filters.
10523 The new filter will be added after the highlighted filter.
10524
10525 <H3>Delete</H3>
10526
10527 The Delete command deletes the currently highlighted filter.
10528
10529 <H3>Change</H3>
10530
10531 The Change command lets you edit the nickname, Pattern,
10532 and Folder of the currently highlighted filter.
10533
10534 <H3>Shuffle</H3>
10535
10536 The Shuffle command allows you to change the order of the filters.
10537 You may move the currently highlighted filter up or down in the list.
10538 The order of the filters is important since the filters are tested for a
10539 match starting with the first filter and continuing until a match is found.
10540 You should place the filters with more specific Patterns near the beginning
10541 of the list, and those with more general Patterns near the end so that
10542 the more specific matches will happen when appropriate.
10543
10544 <H3>Replicate</H3>
10545
10546 The Replicate command is used to copy an existing filter and modify it.
10547 The new filter will be added after the highlighted filter.
10548
10549 <H3>IncludeFile</H3>
10550
10551 The IncludeFile command allows you to add a filters file to your configuration.
10552 Usually, your filters will be contained in your Alpine configuration file.
10553 If you wish, some or all of your filters may be stored in a separate file.
10554 If a filters file already exists (maybe it was made by somebody else using
10555 Alpine), you may insert it before the currently highlighted filter.
10556 You may also insert an empty file or a file that does not yet exist.
10557 Once you have an empty filters file in your configuration, you may use
10558 the Shuffle command to move filters into it.
10559 In fact, that's the only way to get the initial filter into the file.
10560
10561 <H3>eXcludeFile</H3>
10562
10563 The eXcludeFile command removes a filters file from your filters configuration.
10564 A limitation of the program is that in order to exclude a filters file
10565 that file must have at least one filter
10566 in it, otherwise you won't be able to highlight a line in the file.
10567 So you may have to add a dummy filter to the file in order to exclude the file.
10568 <P><UL>
10569 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
10570 </UL>
10571 <P>
10572 <H3>Performance Considerations</H3>
10573 The number and type of patterns being tested can
10574 adversely effect performance.  Issues to be aware
10575 of include:
10576 <P>
10577 <UL>
10578   <LI> The more filters you have defined the longer it will take to run down
10579 the list.  Deleting unused filters is a good idea.
10580   <LI> Filtering in newsgroups served by an NNTP server will be slow
10581 if your patterns include tests other than &quot;From:&quot;
10582 or &quot;Subject:&quot;.
10583 </UL>
10584 <P>
10585 &lt;End of help on this topic&gt;
10586 </BODY>
10587 </HTML>
10588 ===== h_rules_score =====
10589 <HTML>
10590 <HEAD>
10591 <TITLE>SETUP SCORING SCREEN</TITLE>
10592 </HEAD>
10593 <BODY>
10594 <H1>SETUP SCORING SCREEN</H1>
10595 <H2>SETUP SCORING COMMANDS</H2>
10596 <!--chtml if pinemode="function_key"-->
10597 <PRE>
10598 Available  Commands -- Group 1         Available Commands -- Group 2
10599 -------------------------------        ------------------------------
10600 F1  Show Help Text                      F1  Show Help Text
10601 F2  See commands in next group          F2  See commands in next group
10602 F3  Back to MAIN Alpine menu
10603 F4  Change configuration for rule
10604 F5  Move to previous rule               F5  Include file in rule config
10605 F6  Move to next rule                   F6  Exclude file from config
10606 F7  Previous page of rules
10607 F8  Next page of rules
10608 F9  Add new rule                        F9  Replicate existing rule
10609 F10 Delete existing rule
10610 F11 Shuffle the order of rules
10611 F12 Whereis (search rule nicknames)
10612 </PRE>
10613 <!--chtml else-->
10614 <PRE>
10615 Navigation                     General Alpine Commands
10616 -------------------------      -----------------------
10617  P  Prev rule                     ?  Display this help text
10618  N  Next rule                     E  Back to MAIN Alpine menu
10619  -  Previous page
10620 Spc (space bar) Next page
10621  W  WhereIs (search for word in rule nicknames)
10622
10623 Setup Scoring Commands
10624 ------------------------------------------------
10625  A  Add new rule                  $  Shuffle the order of rules
10626  D  Delete existing rule          C  Change configuration for highlighted rule
10627  R  Replicate existing rule
10628  I  Include file in rule config   X  Exclude file from rule config
10629 </PRE>
10630 <!--chtml endif-->
10631
10632 <H2>Description of the Setup Scoring Screen</H2>
10633
10634 Most people will not use scores at all, but if you do use them, here's how
10635 they work in Alpine.
10636 Using this screen, you may define Scoring rules.
10637 The score for a message is calculated by looking at every Score rule defined
10638 and adding up the Score Values for the ones that match the message.
10639 If there are no matches for a message, it has a score of zero.
10640 Message scores may be used a couple of ways in Alpine.
10641
10642 <H3>Sorting by Score</H3>
10643
10644 One of the methods you may use to sort message indexes is to sort by
10645 score.
10646 The scores of all the messages in a folder will be calculated and then
10647 the index will be ordered by placing the messages in order of ascending or
10648 descending score.
10649
10650 <H3>Scores for use in Patterns</H3>
10651
10652 The Patterns used for Roles, Index Line Coloring, and Filtering have a
10653 category labeled &quot;Score Interval&quot;.
10654 When a message is being compared with a Pattern to check for a match, if
10655 the Score Interval is set only messages that have a score somewhere in
10656 the interval are a match.
10657
10658 <H2>Scoring Rule Patterns</H2>
10659
10660 In order to determine whether or not a message matches a scoring rule
10661 the message is compared with the rule's Pattern.
10662 These Patterns are the same for use with Roles, Filtering, Index Coloring,
10663 Scoring, Other Rules, and Search Rules, so are described in only one place,
10664 &quot;<A HREF="h_rule_patterns">here</A>&quot;.
10665
10666 <P>
10667 Actually, Scoring rule Patterns are slightly different from the other types of
10668 Patterns because Scoring rule Patterns don't contain a Score Interval.
10669 In other words, when calculating the score for a message, which is done
10670 by looking at the Scoring rule Patterns, scores aren't used.
10671
10672 <H2>Score Value</H2>
10673
10674 This is the value that will be added to the score for a message if the
10675 rule's Pattern is a match.
10676 Each individual Score Value is an integer between -100 and 100, and the
10677 values from matching rules are added together to get a message's score.
10678 There is also a way to extract the value from a particular header of each
10679 message. See the help text for Score Value for further information.
10680
10681 <H2>Command Descriptions</H2>
10682
10683 <H3>Add</H3>
10684
10685 The Add command is used to add a new scoring rule definition.
10686 The new rule will be added after the highlighted rule.
10687
10688 <H3>Delete</H3>
10689
10690 The Delete command deletes the currently highlighted scoring rule.
10691
10692 <H3>Change</H3>
10693
10694 The Change command lets you edit the nickname, Pattern,
10695 and Score Value of the currently highlighted scoring rule.
10696
10697 <H3>Shuffle</H3>
10698
10699 The Shuffle command allows you to change the order of the scoring rules.
10700 You may move the currently highlighted rule up or down in the list.
10701 The order of the rules is important since the rules are tested for a
10702 match starting with the first rule and continuing until a match is found.
10703 You should place the rules with more specific Patterns near the beginning
10704 of the list, and those with more general Patterns near the end so that
10705 the more specific matches will happen when appropriate.
10706
10707 <H3>Replicate</H3>
10708
10709 The Replicate command is used to copy an existing rule and modify it.
10710 The new rule will be added after the highlighted rule.
10711
10712 <H3>IncludeFile</H3>
10713
10714 The IncludeFile command allows you to add a rules file to your configuration.
10715 Usually, your rules will be contained in your Alpine configuration file.
10716 If you wish, some or all of your rules may be stored in a separate file.
10717 If a rules file already exists (maybe it was made by somebody else using
10718 Alpine), you may insert it before the currently highlighted rule.
10719 You may also insert an empty file or a file that does not yet exist.
10720 Once you have an empty rules file in your configuration, you may use
10721 the Shuffle command to move rules into it.
10722 In fact, that's the only way to get the initial rule into the file.
10723
10724 <H3>eXcludeFile</H3>
10725
10726 The eXcludeFile command removes a rules file from your rules configuration.
10727 A limitation of the program is that in order to exclude a rules file
10728 that file must have at least one rule
10729 in it, otherwise you won't be able to highlight a line in the file.
10730 So you may have to add a dummy rule to the file in order to exclude the file.
10731 <P><UL>
10732 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
10733 </UL>
10734 <P>
10735 &lt;End of help on this topic&gt;
10736 </BODY>
10737 </HTML>
10738 ===== h_direct_config =====
10739 <HTML>
10740 <HEAD>
10741 <TITLE>SETUP LDAP DIRECTORY SERVERS SCREEN</TITLE>
10742 </HEAD>
10743 <BODY>
10744 <H1>SETUP LDAP DIRECTORY SERVERS SCREEN</H1>
10745 <H2>SETUP LDAP DIRECTORY SERVERS COMMANDS</H2>
10746 <!--chtml if pinemode="function_key"-->
10747 <PRE>
10748 Available  Commands
10749 -------------------------------
10750 F1  Show Help Text
10751 F3  Back to MAIN Alpine menu
10752 F4  Change configuration for directory server
10753 F5  Move to previous directory server
10754 F6  Move to next directory server
10755 F7  Previous page of directory servers
10756 F8  Next page of directory servers
10757 F9  Add new directory server
10758 F10 Delete existing directory server
10759 F11 Shuffle the order of directory servers
10760 F12 Whereis (search directory server titles)
10761 </PRE>
10762 <!--chtml else-->
10763 <PRE>
10764 Navigation                     General Alpine Commands
10765 -------------------------      -----------------------
10766  P  Prev Directory Server         ?  Display this help text
10767  N  Next Directory Server         E  Back to MAIN Alpine menu
10768  -  Previous page
10769 Spc (space bar) Next page
10770  W  WhereIs (search for word in directory server titles)
10771
10772 Setup LDAP Directory Server Commands
10773 ------------------------------------------------
10774  A  Add new directory server      $  Shuffle the order of directory servers
10775  D  Delete existing dir server    C  Change configuration for highlighted server
10776 </PRE>
10777 <!--chtml endif-->
10778
10779 <H2>Description of the Setup LDAP Directory Servers Screen</H2>
10780
10781 This screen lets you add, delete, modify, or change the order of your
10782 directory servers. You may also set some optional behavior for each server.
10783 The &quot;Add Dir&quot; command brings up a blank form to
10784 fill in. You will have to supply at least the name of the LDAP server.
10785 You will often have to supply a search base to be used with that server,
10786 as well. Once the form has been brought up on your screen, there is help
10787 available for each of the options you may set.
10788 <P>
10789 The &quot;Del Dir&quot; command allows you to remove a directory server
10790 from your configuration.
10791 <P>
10792 The &quot;Change&quot; command is similar to the &quot;Add Dir&quot; command.
10793 The difference is that instead of bringing up a form for a new server
10794 configuration, you are changing the configuration of an existing entry.
10795 For example, you might want to correct a typing error, change a
10796 nickname, or change one of the options set for that server.
10797 <P>
10798 The &quot;Shuffle&quot; command is used to change the order of directory
10799 servers.
10800 <P><UL>
10801 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
10802 </UL>
10803 <P>
10804 &lt;End of help on this topic&gt;
10805 </BODY>
10806 </HTML>
10807 ============= h_address_display ========================
10808 <HTML>
10809 <HEAD>
10810 <TITLE>SEARCH RESULTS INDEX</TITLE>
10811 </HEAD>
10812 <BODY>
10813 <H1>SEARCH RESULTS INDEX</H1>
10814 This screen shows the results, if any, of your Directory Server search.
10815 Commands (besides those for screen navigation) are:
10816 <DL>
10817 <DT>View
10818 <!--chtml if pinemode="function_key"-->
10819 (F4)
10820 <!--chtml else-->
10821 (V)
10822 <!--chtml endif-->
10823 </DT>
10824 <DD>See the full information for the selected entry.
10825
10826 <DT>Compose
10827 <!--chtml if pinemode="function_key"-->
10828 (F9)
10829 <!--chtml else-->
10830 (C)
10831 <!--chtml endif--></DT>
10832 <DD>Compose a message with the selected entry as the recipient.
10833
10834 <DT>Role
10835 <!--chtml if pinemode="function_key"-->
10836 (F2)
10837 <!--chtml else-->
10838 (#)
10839 <!--chtml endif--></DT>
10840 <DD>Compose a message with the selected entry as the recipient. This differs
10841 from Compose in that you may select a role before beginning your composition.
10842
10843 <DT>Forward
10844 <!--chtml if pinemode="function_key"-->
10845 (F10)
10846 <!--chtml else-->
10847 (F)
10848 <!--chtml endif--></DT>
10849 <DD>Send the full information for the selected entry as an
10850 email message to someone else.
10851
10852 <DT>Save
10853 <!--chtml if pinemode="function_key"-->
10854 (F11)
10855 <!--chtml else-->
10856 (S)
10857 <!--chtml endif-->
10858 </DT>
10859 <DD>Save to your address book:
10860 <UL>
10861 <LI>the result of the search (as just found through your query) for the
10862 selected entry; or
10863 <LI>the selected entry for repeated Directory Server searching when used
10864 in the future.
10865 </UL>
10866 or<BR>
10867 Export to a file (external to Alpine):
10868 <UL>
10869 <LI>the full information for the selected entry; or
10870 <LI>the email address from the selected entry; or
10871 <LI>the selected entry in <A HREF="h_whatis_vcard">vCard</A> format.
10872 </UL>
10873 <DT>WhereIs
10874 <!--chtml if pinemode="function_key"-->
10875 (F12)
10876 <!--chtml else-->
10877 (W)
10878 <!--chtml endif-->
10879 </DT>
10880 <DD>Search for text in the SEARCH RESULTS INDEX screen. (Searches only the
10881 displayed text, not the full records for each entry.)
10882 </DL>
10883 &lt;End of help on this topic&gt;
10884 </BODY>
10885 </HTML>
10886 ============= h_address_select ========================
10887 <HTML>
10888 <HEAD>
10889 <TITLE>SEARCH RESULTS INDEX</TITLE>
10890 </HEAD>
10891 <BODY>
10892 <H1>SEARCH RESULTS INDEX</H1>
10893 This screen shows the results, if any, of your Directory Server search.
10894 Commands (besides those for screen navigation) are:
10895 <DL>
10896 <DT>Select
10897 </DT>
10898 <DD>Select this entry for use.
10899
10900 <DT>ExitSelect
10901 <DD>Exit without selecting any of the entries.
10902
10903 <DT>WhereIs
10904 </DT>
10905 <DD>Search for text in the SEARCH RESULTS INDEX screen. (Searches only the
10906 displayed text, not the full records for each entry.)
10907 </DL>
10908 &lt;End of help on this topic&gt;
10909 </BODY>
10910 </HTML>
10911 ===== h_folder_maint =====
10912 <HTML>
10913 <HEAD>
10914 <TITLE>Help for Folder List</TITLE>
10915 </HEAD>
10916 <BODY>
10917 <H1>FOLDER LIST COMMANDS</H1>
10918 <!--chtml if pinemode="function_key"-->
10919 <PRE>
10920 Available Commands -- Group 1        Available Commands -- Group 2
10921 -------------------------------      ------------------------------
10922 F1  Show Help Text                    F1  Show Help Text
10923 F2  See commands in next group        F2  See commands in next group
10924 F3  MAIN MENU Screen                  F3  Quit Alpine
10925 F4  Select folder and view it         F4  MAIN MENU Screen
10926 F5  Move to previous folder
10927 F6  Move to next folder               F6  Specify a folder to go to
10928 F7  Show previous screen of listing   F7  Show MESSAGE INDEX of current folder
10929 F8  Show next screen of listing       F8  Compose a message
10930 F9  Add a new folder                  F9  Print folder listing
10931 F10 Delete selected folder
10932 F11 Rename selected folder
10933 F12 Whereis (search folder names)
10934
10935 Available Commands -- Group 3
10936 F1  Show Help Text
10937 F2  See commands in next group
10938 F5  Go to next new message
10939     (or count recent messages if <A HREF="h_config_tab_checks_recent"><!--#echo var="FEAT_tab-checks-recent"--></A> is set)
10940 F8  Compose a message using roles
10941 F9  Export folder to a file
10942 F10 Import the file back to a folder
10943 </PRE>
10944 <!--chtml else-->
10945 <PRE>
10946 Navigating the Folder Screen            Operations on the Selected Folder
10947 ----------------------------            ---------------------------------
10948  P   Move to previous folder              V  View Index of selected folder
10949  N   Move to next folder                  D  Delete
10950  -   Show previous page of listing        R  Rename
10951 Spc  (space bar) Show next page           E  Export to file
10952                                           U  Import from file to folder
10953
10954 FOLDER LIST Screen Commands              General Alpine Command
10955 ---------------------------              -----------------------
10956  A  Add a folder                          O  Show all other available commands
10957  G  Specify a folder to go to             ?  Show Help text
10958  I  Show MESSAGE INDEX of current folder  M  MAIN MENU Screen
10959  W  Whereis (search folder names)         Q  Quit Alpine
10960  %  Print folder listing                  C  Compose a message
10961                                           #  Compose a message using roles
10962 </PRE>
10963 <!--chtml endif-->
10964 <P>
10965 These commands are only available in the FOLDER LIST screen when the
10966 <A HREF="h_config_enable_agg_ops">&quot;<!--#echo var="FEAT_enable-aggregate-command-set"-->&quot;
10967 feature</A> is set in the SETUP CONFIGURATION screen:<DL>
10968 <DT>Select:</DT>
10969 <DD>Select folders by certain criteria:<UL>
10970 <LI>All: of limited use, since there is no Apply command.
10971 <LI>by Property: <UL>
10972         <LI>folder contains messages not yet seen
10973         <LI>folder contains new messages
10974         <LI>folder contains exactly as many, more, or fewer messages
10975 than a given number
10976         </UL>
10977 <LI>by Text: <UL>
10978         <LI>contained in name of folder (Name Select)
10979         <LI>contained in messages in folder (Content Select)
10980         </UL>
10981 </UL></DD>
10982
10983 <DT>Select current:</DT>
10984 <DD>Select the folder the cursor is on.  (Can be used to &quot;manually&quot;
10985 add one or more folders to a set created with the Select command described
10986 above.)</DD>
10987 <DT>Zoom mode:</DT>
10988 <DD>Toggles display of only selected folders or all folders on and off.</DD>
10989 </DL>
10990 <P>
10991 If the feature
10992 <A HREF="h_config_tab_checks_recent">&quot;<!--#echo var="FEAT_tab-checks-recent"-->&quot;</A>
10993 is set then the TAB key will display the number of recent messages and
10994 the total number of messages in the highlighted folder.
10995 <P>
10996 The &quot;Export&quot; command causes the lowest common denominator style
10997 mailbox to be written to a file.
10998 If the file already exists, you are asked if you want to delete it.
10999 If you say No, then the operation is aborted.
11000 Export might be a reasonable way to store a backup or an archival copy of
11001 a folder.
11002 The exported-to file is a local file on the system where you are running Alpine.
11003 The &quot;Import&quot; command is the opposite of the Export command.
11004 It reads a file created by Export and asks where it should save it in your
11005 folders.
11006 This could be a new folder or an existing folder.
11007 If the folder already exists, the messages from the exported file will be
11008 appended to the folder.
11009 <P>
11010 <CENTER>Description of the FOLDER LIST Screen</CENTER>
11011
11012 The purpose of the FOLDER LIST screen is to help you browse and manage
11013 the folders and directories (also known as &quot;hierarchy&quot;)
11014 contained within a collection.
11015
11016 <P>
11017 Folders and directories are arranged alphabetically across lines of
11018 the screen.  Directories, if present, are denoted by a special
11019 character at the end of the name known as the hierarchy delimiter
11020 (typically, &quot;/&quot;).  By default, folders and directories are
11021 mixed together.  The
11022 "<A HREF="h_config_fld_sort_rule"><!--#echo var="VAR_folder-sort-rule"--></A>"
11023 configuration option can be used to group directories toward the
11024 beginning or end of the list.
11025
11026 <P>
11027 The Next/Prev Page commands help browse the list, the Next/Prev Fldr
11028 commands change the &quot;selected&quot; (i.e., highlighted) folder or
11029 directory, and the View Fldr/Dir commands will &quot;open&quot; the
11030 selected item.  Folder and directory management is provided via the
11031 Rename, Delete and Add commands.
11032
11033 <P><CENTER>About Folders</CENTER>
11034 What are Folders?<P>
11035
11036 Folders are simply files where messages are kept.  Every message has to be
11037 in a folder.  Most every Alpine user starts out with 3 folders: an INBOX, a
11038 folder for sent mail and a folder for saved messages.<P>
11039
11040 You may create as many other folders as you wish.  They must be given
11041 names that can be filenames on the filesystem.
11042 <P>
11043
11044 You can move messages from one folder to another by opening the original
11045 folder and saving messages into the other folder just as you can save
11046 message from your INBOX to any other folder.<P>
11047
11048 Folders are typically just files in the filesystem.  However, the files
11049 that are
11050 folders have some special formatting in them (so that Alpine knows where one
11051 message ends and another begins) and should <EM>not</EM> be edited outside of
11052 Alpine.  If you want copies of your messages in text files that you can edit
11053 or otherwise manipulate, use the Export command to copy them from Alpine into
11054 your regular file area.
11055
11056 <P>
11057 FOR MORE INFORMATION: See the section on
11058 <A HREF="h_valid_folder_names">Valid Folder Names</A>.
11059 <P>
11060 <CENTER>About Directories</CENTER>
11061 <P>
11062 A directory is simply a container used to group folders within a
11063 folder list.  You can create as many directories as you like.  And
11064 directories can even contain directories themselves.
11065
11066 <P>
11067 SPECIAL NOTES: When accessing folders on an IMAP server, it is important
11068 to note that not all IMAP servers support directories.  If you find that
11069 the Add command fails to offer the &quot;Create Directory&quot; subcommand,
11070 then it's likely that directories are not supported by the server serving
11071 in that collection.
11072
11073 <P>
11074 Similarly, servers that do provide for directories may not do so in
11075 the same way.  On some servers, for example, each folder name you
11076 create is at the same time capable of being a directory.  When this
11077 happens, Alpine will display both the folder name and the name of the
11078 directory (with trailing hierarchy delimiter) in the folder list.
11079
11080 <P>
11081 Another issue with IMAP access, though with a much smaller set of servers,
11082 is that not all servers accept the request to list out the available
11083 folders and directories in the same way.  If you find yourself having
11084 trouble viewing folders on your server, you might investigate the
11085 &quot;<A HREF="h_config_lame_list_mode"><!--#echo var="FEAT_enable-lame-list-mode"--></A>&quot;
11086 feature.
11087 <P>
11088 <UL>
11089 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
11090 </UL>
11091 <P>
11092 &lt;End of help on this topic&gt;
11093 </BODY>
11094 </HTML>
11095 ========= h_valid_folder_names ========
11096 <HTML>
11097 <HEAD>
11098 <TITLE>Explanation of Valid Folder Names</TITLE>
11099 </HEAD>
11100 <BODY>
11101 <H1>Folder Name Syntax Explained</H1>
11102
11103 Once your folder collections are defined, you can usually refer to
11104 folders by their simple (unqualified) name, or pick from a FOLDER LIST
11105 display.  However, understanding the complete syntax for folder names,
11106 both local and remote, is handy when using the Goto command and when
11107 you are adding new folder collections via the Setups/collectionList screen.
11108 <P>
11109 An Alpine folder name looks like
11110
11111 <P>
11112 <CENTER><SAMP>[{&lt;remote-specification&gt;}][#&lt;namespace&gt;]&lt;namespace-specific-part&gt;</SAMP></CENTER>
11113 <P>
11114
11115 The square brackets ([]) mean that the part is optional.
11116
11117 <P>
11118 If there is no remote-specification, then the folder name is interpreted
11119 locally on the computer running Alpine.
11120 Local folder names depend on the operating system used by the computer
11121 running Alpine, as well as the configuration of that system.  For example,
11122 &quot;C:&#92;PINE&#92;FOLDERS&#92;OCT-94&quot; might exist on a PC, and
11123 &quot;~/mail/september-1994&quot; might be a reasonable folder name on a
11124 system running Unix.
11125
11126 <P>
11127 Alpine users have the option of using folders that are stored on some other
11128 computer.  Alpine accesses remote folders via IMAP (the Internet Message
11129 Access Protocol), or in the case of news, via NNTP (the Network News
11130 Transport Protocol).  To be able to access remote folders in Alpine, the
11131 remote host must be running the appropriate server software (imapd or
11132 nntpd) and you must correctly specify the name of the folder to Alpine,
11133 including the domain name of the remote machine. For example,
11134 <P>
11135 <CENTER><SAMP>&#123;monet.art.example.com}INBOX</SAMP></CENTER>
11136 <P>
11137 could be a remote folder specification, and so could
11138 <P>
11139 <CENTER><SAMP>&#123;unixhost.art.example.com}~/mail/september-1994</SAMP></CENTER>
11140 and
11141 <P>
11142 <CENTER><SAMP>&#123;winhost.art.example.com}&#92;mymail&#92;SEP-94</SAMP></CENTER>
11143 <P>
11144 Note that in the case of remote folders, the directory/file path in the specification is
11145 determined by the operating system of the remote computer, <B>not</B> by
11146 the operating system of the computer on which you are running Alpine.
11147 <P>
11148 As you can tell, the name of the computer is in &#123;} brackets
11149 followed immediately by the name of the folder.  (In each of these cases the
11150 optional namespace is missing.)  If, as in these
11151 examples, there is no remote access protocol specified, then IMAP is
11152 assumed.  Check
11153 <A HREF="h_folder_server_syntax">here</A>
11154 for a more detailed look at what options can be placed between the brackets.
11155 If there are no brackets at all, then the folder name is interpreted locally
11156 on the computer on which you are running Alpine.
11157
11158 <P>
11159 To the right of the brackets when a server name is present, or at the
11160 start of the foldername if no server is present, the sharp sign,
11161 &quot;#&quot;, holds special meaning.  It indicates a folder name
11162 outside the area reserved for your personal folders.  In fact, it's
11163 used to indicate both the name of the folder, and a special phrase
11164 telling Alpine how to interpret the name that follows.
11165
11166 <P>
11167 So, for example, Alpine can be used to access a newsgroup that might be
11168 available on your computer using:
11169 <P>
11170 <CENTER><SAMP>#news.comp.mail.pine</SAMP></CENTER>
11171 <P>
11172 The sharp sign indicates the folder name is outside your personal
11173 folder area.  The &quot;news.&quot; phrase after it tells Alpine to
11174 interpret the remainder of the name as a newsgroup.
11175
11176 <P>
11177 Similarly, to access a newsgroup on your IMAP server, you might
11178 use something like:
11179 <P>
11180 <CENTER><SAMP>&#123;wharhol.art.example.com}#news.comp.mail.misc</SAMP></CENTER>
11181
11182 <P>
11183 There are a number of such special phrases (or &quot;namespaces&quot;)
11184 available.  For a more detailed explanation read about
11185 <A HREF="h_folder_name_namespaces">Namespaces</A>.
11186
11187 <P>
11188 Note that &quot;INBOX&quot; has special meaning in both local and remote folder
11189 names.  The name INBOX refers to your &quot;principal incoming
11190 message folder&quot; and will be mapped to the actual file name used for your
11191 INBOX on any given host.  Therefore, a name like
11192 &quot;&#123;xxx.art.example.com}INBOX&quot; refers to whatever file is used to
11193 store incoming mail for you on that particular host.
11194
11195 <P>
11196 &lt;End of help on this topic&gt;
11197 </BODY>
11198 </HTML>
11199 ======= h_folder_name_namespaces =======
11200 <HTML>
11201 <HEAD>
11202 <TITLE>FOLDER NAME NAMESPACES EXPLAINED</TITLE>
11203 </HEAD>
11204 <BODY>
11205 <H1>Folder Name Namespaces Explained</H1>
11206
11207 An Alpine folder name looks like
11208
11209 <P>
11210 <CENTER><SAMP>[{&lt;remote-specification&gt;}][#&lt;namespace&gt;][&lt;namespace-specific-part&gt;]</SAMP></CENTER>
11211 <P>
11212
11213 The local part of a folder name has an optional &quot;Namespace&quot; which
11214 tells Alpine how to interpret the rest of the name.
11215
11216 <P>
11217 By default the folder name is interpreted as defining a section of your personal
11218 folder area.  This area and how you specify it are defined by the
11219 server, if one is specified, or, typically, the home
11220 directory, if no server is defined.
11221
11222 <P>
11223 If a namespace is specified, it begins with the
11224 sharp, &quot;#&quot;, character followed by the name of the namespace
11225 and then the namespace's path-element-delimiter.  Aside from the
11226 path's format, namespaces can also imply access rights, content
11227 policy, audience, location, and, occasionally, access methods.
11228
11229 <P>
11230 Each server exports its own set (possibly of size one) of
11231 namespaces.  Hence, it's likely communication with your server's
11232 administrator will be required for specific configurations.  Some of
11233 the more common namespaces, however, include:
11234
11235 <DL>
11236 <DT>#news.</DT>
11237 <DD>This specifies a set of folders in the newsgroup namespace.  Newsgroup
11238 names are hierarchically defined with each level delimited by a period.
11239 <P>
11240 <CENTER><SAMP>#news.comp.mail.pine</SAMP></CENTER>
11241 <P>
11242 </DD>
11243 <DT>#public/</DT>
11244 <DD>This specifies a folder area that the server may export to the general
11245 public.
11246 </DD>
11247 <DT>#shared/</DT>
11248 <DD>This specifies a folder area that the server may export to groups
11249 of users.
11250 </DD>
11251 <DT>#ftp/</DT>
11252 <DD>This specifies a folder area that is the same as that it may have
11253 exported via the &quot;File Transfer Protocol&quot;.
11254 </DD>
11255 <DT>#mh/</DT>
11256 <DD>This specifies the personal folder area associated with folders
11257 and directories that were created using the MH message handling system.
11258 </DD>
11259 <DT>#move/</DT>
11260 <DD>This namespace is interpreted locally by Alpine. It has an unusual interpretation and format.
11261 <P>
11262 <CENTER><SAMP>#move&lt;DELIM&gt;&lt;MailDropFolder&gt;&lt;DELIM&gt;&lt;DestinationFolder&gt;</SAMP></CENTER>
11263 <P>
11264 The #move namespace is followed by two folder names separated by a delimiter
11265 character.
11266 The delimiter character may be any character that does not appear in
11267 the MailDropFolder name.
11268 The meaning of #move is that mail will be copied from the MailDropFolder to
11269 the DestinationFolder and then deleted (if possible) from the MailDropFolder.
11270 Periodic checks at frequency
11271 <A HREF="h_config_mailcheck"><!--#echo var="VAR_mail-check-interval"--></A>, but with a minimum
11272 time between checks set by
11273 <A HREF="h_config_maildropcheck"><!--#echo var="VAR_maildrop-check-minimum"--></A>,
11274 are made for new mail arriving in the MailDropFolder.
11275 An example that copies mail from a POP inbox to a local folder follows
11276 <P>
11277 <CENTER><SAMP>#move+{popserver.example.com/pop3/ssl}inbox+local folder</SAMP></CENTER>
11278 <P>
11279 To you it appears that mail is being delivered to the local folder when it
11280 is copied from the MailDropFolder, and you read mail from the local folder.
11281 <P>
11282 Note that if the DestinationFolder does not exist then the messages are not
11283 copied from the MailDropFolder.
11284 A #move folder may only be used as an
11285 <A HREF="h_config_enable_incoming">&quot;Incoming folder&quot;</A> or
11286 an Inbox.
11287 When you are in the FOLDER LIST of Incoming Message Folders (after turning
11288 on the
11289 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="FEAT_enable-incoming-folders"-->&quot;</A>
11290 option)
11291 the Add command has a subcommand &quot;Use Mail Drop&quot;
11292 which may be helpful for defining the folder in your Alpine configuration.
11293 The same is true when you edit the
11294 <A HREF="h_config_inbox_path"><!--#echo var="VAR_inbox-path"--></A>
11295 option in Setup/Config.
11296 Each of these configuration methods will also create the DestinationFolder
11297 if it doesn't already exist.
11298 If you are having problems, make sure the DestinationFolder exists.
11299 You may find some more useful information about Mail Drops at
11300 <A HREF="h_maildrop">What is a Mail Drop?</A>.
11301 </DD>
11302 </DL>
11303 <P>
11304
11305 In addition, the server may support access to other user's folders,
11306 provided you have suitable permissions.  Common methods use a prefix
11307 of either &quot;~<VAR>user</VAR>/&quot;, or &quot;/<VAR>user</VAR>/&quot; to
11308 indicate the root of the other user's folder area.
11309
11310 <P>
11311 No, nothing's simple.
11312
11313 <P>
11314 &lt;End of help on this topic&gt;
11315 </BODY>
11316 </HTML>
11317 ============= h_whatis_vcard ========================
11318 <HTML>
11319 <HEAD>
11320 <TITLE>VCARD EXPLAINED</TITLE>
11321 </HEAD>
11322 <BODY>
11323 <H1>What is the vCard format?</H1>
11324 A &quot;vCard&quot; is a sort of electronic business card, for exchanging
11325 information about and among people and organizations electronically.
11326 More information about vCard can be found (as of May 1998) on the WWW site
11327 of the Internet Mail Consortium at the URL:
11328 <P>
11329 <CENTER><A HREF="http://www.imc.org/pdi/">http://www.imc.org/pdi/</A></CENTER>
11330 <P>
11331 &lt;End of help on this topic&gt;
11332 </BODY>
11333 </HTML>
11334 ===== h_folder_open =====
11335 <HTML>
11336 <HEAD>
11337 <TITLE>Explanation of Folder Selection</TITLE>
11338 </HEAD>
11339 <BODY>
11340 <BR>
11341 <BR>
11342 This screen is designed to allow you to quickly and easily survey your
11343 folders and select one to open.
11344 <!--chtml if pinemode="function_key"-->
11345 <PRE>
11346 Navigating the List of Folders             General Alpine Commands
11347 ------------------------------             -----------------------
11348  P   Move to previous folder               ?   Show this help text
11349  N   Move to next folder
11350  -   Show previous screen of folders
11351 Spc  (space bar) Show next screen
11352  W   WhereIs (search folder names)
11353
11354 Folder Selection Commands
11355 -------------------------
11356  E   Exit the Folder Select menu (without selecting a folder)
11357  S   Select the currently highlighted folder
11358 </PRE>
11359 <!--chtml else-->
11360 <PRE>
11361 Navigating the List of Folders             General Alpine Commands
11362 ------------------------------             -----------------------
11363 F5   Move to previous folder               F1  Show this help text
11364 F6   Move to next folder
11365 F7   Show previous screen of folders
11366 F8   Show next screen of folders
11367 F12  WhereIs (search folder names)
11368
11369 Folder Selection Commands
11370 -------------------------
11371 F3   Exit the Folder Select menu (without selecting a folder)
11372 F4   Select the currently highlighted folder
11373 </PRE>
11374 <!--chtml endif-->
11375 <P>
11376 FOR MORE INFORMATION: See the section on
11377 <A HREF="h_valid_folder_names">Valid Folder Names</A>.
11378 <P>
11379 &lt;End of help on this topic&gt;
11380 </BODY>
11381 </HTML>
11382 ===== h_folder_subscribe =====
11383 <HTML>
11384 <HEAD>
11385 <TITLE>Newsgroup Subcribe Screen explained</TITLE>
11386 </HEAD>
11387 <BODY>
11388 <H1>FOLDER SUBSCRIBE HELP</H1>
11389
11390 This screen is designed to help you subscribe to newsgroups you are
11391 not currently subscribed to.  The screen display is a list of all
11392 available newsgroups (or possibly a partial list if you specified a
11393 partial name when entering the screen).  Groups you have already
11394 subscribed to have the letters &quot;SUB&quot; next to them.  You may
11395 select a single new group to subscribe to by moving the cursor to that
11396 group and pressing &quot;S&quot; or carriage return.  Alternatively,
11397 you may change into ListMode with the &quot;ListMode&quot; command.
11398 The display will change slightly so that each group has a checkbox in
11399 front of it.  Use the cursor and the Set/Unset command to place an
11400 &quot;X&quot; in front of each newsgroup you wish to subscribe to.
11401 <P>
11402
11403 When you are finished marking groups, the &quot;Subscribe&quot;
11404 command will subscribe you to those groups you have marked.  Note, you
11405 may not unsubscribe to groups with this command.  Instead of the
11406 &quot;A&quot; &quot;Subscribe&quot; command, use the &quot;D&quot;
11407 UnSbscrbe command.
11408 <P>
11409
11410 <!--chtml if pinemode="function_key"-->
11411 <PRE>
11412 Navigating the List of Newsgroups          General Alpine Commands
11413 ---------------------------------          -----------------------
11414 F5   Move to previous group                F1   Show this help text
11415 F6   Move to next group
11416 F7   Show previous screen of groups
11417 F8   Show next screen of groups
11418 F12  WhereIs (search group names)
11419 F9   Use ListMode
11420
11421 Group Selection Commands
11422 -------------------------
11423 F3  Exit the News Subscribe menu (without selecting any groups)
11424 F4  Subscribe to the currently highlighted newsgroup
11425 </PRE>
11426 <!--chtml else-->
11427 <PRE>
11428 Navigating the List of Newsgroups          General Alpine Commands
11429 ---------------------------------          -----------------------
11430  P   Move to previous group                ?   Show this help text
11431  N   Move to next group
11432  -   Show previous screen of groups
11433 Spc  (space bar) Show next screen
11434  W   WhereIs (search group names)
11435  L   Use ListMode
11436
11437 Group Selection Commands
11438 -------------------------
11439  E   Exit the News Subscribe menu (without selecting any groups)
11440  S   Subscribe to the currently highlighted newsgroup
11441 </PRE>
11442 <!--chtml endif-->
11443 <P>
11444 When in ListMode, there is an additional command for marking groups to
11445 subscribe to:
11446 <P>
11447 <!--chtml if pinemode="function_key"-->
11448 <PRE>
11449 ListMode Commands
11450 -------------------------
11451 F9  Set or unset the highlighted group
11452 </PRE>
11453 <!--chtml else-->
11454 <PRE>
11455 ListMode Commands
11456 -------------------------
11457 X   Set or unset the highlighted group
11458 </PRE>
11459 <!--chtml endif-->
11460 <P>
11461 &lt;End of help on this topic&gt;
11462 </BODY>
11463 </HTML>
11464 ===== h_folder_postnews =====
11465 <HTML>
11466 <HEAD>
11467 <TITLE>Newsgroup selecting for Posting explained</TITLE>
11468 </HEAD>
11469 <BODY>
11470 This screen is designed to allow you to quickly and easily survey
11471 the available newsgroups and select one to post news to.
11472 <P>
11473 <!--chtml if pinemode="function_key"-->
11474 <PRE>
11475 Navigating the List of Newsgroups          General Alpine Commands
11476 ---------------------------------          -----------------------
11477 F5   Move to previous group                F1  Show this help text
11478 F6   Move to next group
11479 F7   Show previous screen of groups
11480 F8   Show next screen of groups
11481 F12  WhereIs (search group names)
11482
11483 Group Selection Commands
11484 -------------------------
11485 F3   Exit the Selection menu (without selecting a group)
11486 F4   Select the currently highlighted newsgroup
11487 </PRE>
11488 <!--chtml else-->
11489 <PRE>
11490 Navigating the List of Newsgroups          General Alpine Commands
11491 ---------------------------------          -----------------------
11492  P   Move to previous group                ?  Show this help text
11493  N   Move to next group
11494  -   Show previous screen of groups
11495 Spc  (space bar) Show next screen of groups
11496  W   WhereIs (search group names)
11497
11498 Group Selection Commands
11499 -------------------------
11500  E   Exit the Selection menu (without selecting a group)
11501  S   Select the currently highlighted newsgroup
11502 </PRE>
11503 <!--chtml endif-->
11504 <P>
11505 &lt;End of help on this topic&gt;
11506 </BODY>
11507 </HTML>
11508 ===== h_folder_save =====
11509 <HTML>
11510 <HEAD>
11511 <TITLE>Folder Select for Save Explained</TITLE>
11512 </HEAD>
11513 <BODY>
11514 This screen is designed to allow you to quickly and easily survey your
11515 folders and select one to use for saving the current message.
11516 <P>
11517
11518 <!--chtml if pinemode="function_key"-->
11519 <PRE>
11520 Navigating the List of Folders             General Alpine Commands
11521 ------------------------------             -----------------------
11522 F5   Move to previous folder               F1  Show this help text
11523 F6   Move to next folder
11524 F7   Show previous screen of folders
11525 F8   Show next screen of folders
11526 F12  WhereIs (search folder names)
11527
11528 Folder Selection Commands
11529 -------------------------
11530 F3   Exit the Folder Select menu (without selecting a folder)
11531 F4   Select the currently highlighted folder
11532 F11  AddNew folder (just like Select, but you type in a new folder name)
11533 </PRE>
11534 <!--chtml else-->
11535 <PRE>
11536 Navigating the List of Folders             General Alpine Commands
11537 ------------------------------             -----------------------
11538  P   Move to previous folder               ?  Show this help text
11539  N   Move to next folder
11540  -   Show previous screen of folders
11541 Spc  (space bar) Show next screen of folders
11542  W   WhereIs (search folder names)
11543
11544 Folder Selection Commands
11545 -------------------------
11546  E   Exit the Folder Select menu (without selecting a folder)
11547  S   Select the currently highlighted folder
11548  A   AddNew folder (just like Select, but you type in a new folder name)
11549 </PRE>
11550 <!--chtml endif-->
11551 <P>
11552 FOR MORE INFORMATION: See the section on
11553 <A HREF="h_valid_folder_names">Valid Folder Names</A>.
11554 <P>
11555 &lt;End of help on this topic&gt;
11556 </BODY>
11557 </HTML>
11558 ===== h_folder_fcc =====
11559 <HTML>
11560 <HEAD>
11561 <TITLE>Folder Select for Fcc Explained</TITLE>
11562 </HEAD>
11563 <BODY>
11564 This screen is designed to allow you to quickly and easily survey your
11565 folders and select one to use as the file carbon copy (fcc) for the
11566 current message.
11567 <P>
11568
11569 <!--chtml if pinemode="function_key"-->
11570 <PRE>
11571 Navigating the List of Folders             General Alpine Commands
11572 ------------------------------             -----------------------
11573 F5   Move to previous folder               F1  Show this help text
11574 F6   Move to next folder
11575 F7   Show previous screen of folders
11576 F8   Show next screen of folders
11577 F12  WhereIs (search folder names)
11578
11579 Folder Selection Commands
11580 -------------------------
11581 F3   Exit the Folder Select menu (without selecting a folder)
11582 F4   Select the currently highlighted folder
11583 F11  AddNew folder (just like Select, but you type in a new folder name)
11584 </PRE>
11585 <!--chtml else-->
11586 <PRE>
11587 Navigating the List of Folders             General Alpine Commands
11588 ------------------------------             -----------------------
11589  P   Move to previous folder               ?  Show this help text
11590  N   Move to next folder
11591  -   Show previous screen of folders
11592 Spc  (space bar) Show next screen of folders
11593  W   WhereIs (search folder names)
11594
11595 Folder Selection Commands
11596 -------------------------
11597  E   Exit the Folder Select menu (without selecting a folder)
11598  S   Select the currently highlighted folder
11599  A   AddNew folder (just like Select, but you type in a new folder name)
11600 </PRE>
11601 <!--chtml endif-->
11602 <P>
11603 FOR MORE INFORMATION: See the section on
11604 <A HREF="h_valid_folder_names">Valid Folder Names</A>.
11605 <P>
11606 &lt;End of help on this topic&gt;
11607 </BODY>
11608 </HTML>
11609 ===== h_folder_pattern_roles =====
11610 <HTML>
11611 <HEAD>
11612 <TITLE>Folder Select for Current Folder Explained</TITLE>
11613 </HEAD>
11614 <BODY>
11615 This screen is designed to allow you to quickly and easily survey your
11616 folders and select one to use as the specific Current Folder
11617 in a Pattern.
11618 <P>
11619
11620 <!--chtml if pinemode="function_key"-->
11621 <PRE>
11622 Navigating the List of Folders             General Alpine Commands
11623 ------------------------------             -----------------------
11624 F5   Move to previous folder               F1  Show this help text
11625 F6   Move to next folder
11626 F7   Show previous screen of folders
11627 F8   Show next screen of folders
11628 F12  WhereIs (search folder names)
11629
11630 Folder Selection Commands
11631 -------------------------
11632 F3   Exit the Folder Select menu (without selecting a folder)
11633 F4   Select the currently highlighted folder
11634 F11  AddNew folder (just like Select, but you type in a new folder name)
11635 </PRE>
11636 <!--chtml else-->
11637 <PRE>
11638 Navigating the List of Folders             General Alpine Commands
11639 ------------------------------             -----------------------
11640  P   Move to previous folder               ?  Show this help text
11641  N   Move to next folder
11642  -   Show previous screen of folders
11643 Spc  (space bar) Show next screen of folders
11644  W   WhereIs (search folder names)
11645
11646 Folder Selection Commands
11647 -------------------------
11648  E   Exit the Folder Select menu (without selecting a folder)
11649  S   Select the currently highlighted folder
11650  A   AddNew folder (just like Select, but you type in a new folder name)
11651 </PRE>
11652 <!--chtml endif-->
11653 <P>
11654 FOR MORE INFORMATION: See the section on
11655 <A HREF="h_valid_folder_names">Valid Folder Names</A>.
11656 <P>
11657 &lt;End of help on this topic&gt;
11658 </BODY>
11659 </HTML>
11660 ===== h_folder_stayopen_folders =====
11661 <HTML>
11662 <HEAD>
11663 <TITLE>Folder Select Explained</TITLE>
11664 </HEAD>
11665 <BODY>
11666 This screen is designed to allow you to quickly and easily survey your
11667 folders and select one to use as a Stay-Open folder.
11668 <P>
11669
11670 <!--chtml if pinemode="function_key"-->
11671 <PRE>
11672 Navigating the List of Folders             General Alpine Commands
11673 ------------------------------             -----------------------
11674 F5   Move to previous folder               F1  Show this help text
11675 F6   Move to next folder
11676 F7   Show previous screen of folders
11677 F8   Show next screen of folders
11678 F12  WhereIs (search folder names)
11679
11680 Folder Selection Commands
11681 -------------------------
11682 F3   Exit the Folder Select menu (without selecting a folder)
11683 F4   Select the currently highlighted folder
11684 F11  AddNew folder (just like Select, but you type in a new folder name)
11685 </PRE>
11686 <!--chtml else-->
11687 <PRE>
11688 Navigating the List of Folders             General Alpine Commands
11689 ------------------------------             -----------------------
11690  P   Move to previous folder               ?  Show this help text
11691  N   Move to next folder
11692  -   Show previous screen of folders
11693 Spc  (space bar) Show next screen of folders
11694  W   WhereIs (search folder names)
11695
11696 Folder Selection Commands
11697 -------------------------
11698  E   Exit the Folder Select menu (without selecting a folder)
11699  S   Select the currently highlighted folder
11700  A   AddNew folder (just like Select, but you type in a new folder name)
11701 </PRE>
11702 <!--chtml endif-->
11703 <P>
11704 FOR MORE INFORMATION: See the section on
11705 <A HREF="h_valid_folder_names">Valid Folder Names</A>.
11706 <P>
11707 &lt;End of help on this topic&gt;
11708 </BODY>
11709 </HTML>
11710 ===== h_folder_action_roles =====
11711 <HTML>
11712 <HEAD>
11713 <TITLE>Folder Select Explained</TITLE>
11714 </HEAD>
11715 <BODY>
11716 This screen is designed to allow you to quickly and easily survey your
11717 folders and select one to use as the folder into which messages
11718 matching this filter will be moved.
11719 <P>
11720
11721 <!--chtml if pinemode="function_key"-->
11722 <PRE>
11723 Navigating the List of Folders             General Alpine Commands
11724 ------------------------------             -----------------------
11725 F5   Move to previous folder               F1  Show this help text
11726 F6   Move to next folder
11727 F7   Show previous screen of folders
11728 F8   Show next screen of folders
11729 F12  WhereIs (search folder names)
11730
11731 Folder Selection Commands
11732 -------------------------
11733 F3   Exit the Folder Select menu (without selecting a folder)
11734 F4   Select the currently highlighted folder
11735 F11  AddNew folder (just like Select, but you type in a new folder name)
11736 </PRE>
11737 <!--chtml else-->
11738 <PRE>
11739 Navigating the List of Folders             General Alpine Commands
11740 ------------------------------             -----------------------
11741  P   Move to previous folder               ?  Show this help text
11742  N   Move to next folder
11743  -   Show previous screen of folders
11744 Spc  (space bar) Show next screen of folders
11745  W   WhereIs (search folder names)
11746
11747 Folder Selection Commands
11748 -------------------------
11749  E   Exit the Folder Select menu (without selecting a folder)
11750  S   Select the currently highlighted folder
11751  A   AddNew folder (just like Select, but you type in a new folder name)
11752 </PRE>
11753 <!--chtml endif-->
11754 <P>
11755 FOR MORE INFORMATION: See the section on
11756 <A HREF="h_valid_folder_names">Valid Folder Names</A>.
11757 <P>
11758 &lt;End of help on this topic&gt;
11759 </BODY>
11760 </HTML>
11761 ===== h_abook_config =====
11762 <HTML>
11763 <HEAD>
11764 <TITLE>SETUP ADDRESS BOOKS SCREEN</TITLE>
11765 </HEAD>
11766 <BODY>
11767 <H1>SETUP ADDRESS BOOKS SCREEN</H1>
11768 <H2>SETUP ADDRESS BOOKS COMMANDS</H2>
11769 <!--chtml if pinemode="function_key"-->
11770 <PRE>
11771 Available  Commands
11772 -------------------------------
11773 F1  Show Help Text
11774 F3  Back to MAIN Alpine menu
11775 F4  Change configuration for address book
11776 F5  Move to previous address book
11777 F6  Move to next address book
11778 F7  Previous page of address books
11779 F8  Next page of address books
11780 F9  Add new address book
11781 F10 Delete existing address book
11782 F11 Shuffle the order of address books
11783 F12 Whereis (search address book titles)
11784 </PRE>
11785 <!--chtml else-->
11786 <PRE>
11787 Navigation                     General Alpine Commands
11788 -----------------------        -----------------------
11789  P  Prev Address Book           ?  Display this help text
11790  N  Next Address Book           E  Back to MAIN Alpine menu
11791  -  Previous page
11792 Spc (space bar) Next page
11793  W  WhereIs (search for word in address book titles)
11794
11795 Setup Address Books Commands
11796 ------------------------------------------------
11797  A  Add new address book          $  Shuffle the order of address books
11798  D  Delete existing address book  C  Change configuration for address book
11799 </PRE>
11800 <!--chtml endif-->
11801
11802 <H2>Description of the Setup Address Books Screen</H2>
11803
11804 This screen lets you add, delete, modify, or change the order of your
11805 address books.  The &quot;Add Abook&quot; command brings up a blank form to
11806 fill in.  If you are adding a remote address book on an IMAP server
11807 you should fill in the name of the IMAP server.  Otherwise, leave
11808 that field blank.  (Note that remote IMAP address books are an Alpine
11809 concept and are unlikely to interoperate with other mail clients.)
11810 For a remote address book, fill in the name of the remote folder
11811 in the Folder field.  This should be a folder that is used only for
11812 this one purpose, not a general purpose folder you expect to store
11813 messages in.
11814 <P>If you are adding a local address book, fill in the
11815 Folder Name field with a local file name (e.g., .addressbook).
11816 <P>
11817 <B>Please note:</B> Remote address books stored on an IMAP server are
11818 of an entirely different format (namely, a special-purpose
11819 &quot;mail folder&quot;) than that of the local addressbook familiar
11820 to Alpine users.  Therefore,
11821 you cannot use &quot;add a remote address book&quot; to make an existing
11822 Alpine .addressbook file you may have on a remote IMAP server accessible to
11823 Alpine running on a different host.
11824 <P>
11825
11826 The &quot;Del Abook&quot; command allows you to remove an address book
11827 from your configuration.  It will also ask you if you wish to remove
11828 the data for that address book, which would erase all traces of the
11829 address book if you answer Yes.
11830 <P>
11831
11832 The &quot;Change&quot; command is similar to the &quot;Add Abook&quot; command.
11833 The difference is that instead of adding a new address book to your
11834 configuration, you are changing the configuration of an existing entry.
11835 For example, you might want to correct a typing error or change a
11836 nickname.  The &quot;Change&quot; command is not a move command.  If you
11837 change the folder name or server name the data will not be moved for you.
11838 <P>
11839
11840 The &quot;Shuffle&quot; command is used for two purposes.  If you shuffle
11841 an address book toward another address book in the same group then
11842 the order of those two address books will be swapped.  If you shuffle
11843 the last Personal address book down towards the Global address book
11844 section, it will become a Global address book.  If you shuffle
11845 the first Global address book up it will become a Personal address
11846 book.  The main difference between Personal and Global address
11847 books is that Global address books are forced read-only.
11848 <P><UL>
11849 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
11850 </UL>
11851 <P>
11852 &lt;End of help on this topic&gt;
11853 </BODY>
11854 </HTML>
11855 ===== h_abook_top =====
11856 <HTML>
11857 <HEAD>
11858 <TITLE>ADDRESS BOOK LIST COMMANDS</TITLE>
11859 </HEAD>
11860 <BODY>
11861 <H1>ADDRESS BOOK LIST COMMANDS</H1>
11862 <!--chtml if pinemode="function_key"-->
11863 <PRE>
11864 Available  Commands -- Group 1         Available Commands -- Group 2
11865 -------------------------------        ------------------------------
11866 F1  Show Help Text                      F1  Show Help Text
11867 F2  See commands in next group          F2  See commands in next group
11868 F3  Exit to MAIN MENU                   F3  Quit Alpine
11869 F4  View/Edit selected address book
11870 F5  Move to previous address book       F5  FOLDER LIST screen
11871 F6  Move to next address book           F6  Specify a folder to go to
11872 F7  Previous page                       F7  MESSAGE INDEX screen
11873 F8  Next page                           F9  Print list of address books
11874 F12 Whereis (search for word)
11875 </PRE>
11876 <!--chtml else-->
11877 <PRE>
11878 Navigation                       General Alpine Commands
11879 -----------------------          -----------------------
11880  P  Previous Entry                ?  Display this help text
11881  N  Next Entry                    O  Show all other available commands
11882  -  Previous page                 &lt;  Back to MAIN Alpine menu
11883 Spc (space bar) Next page         Q  Quit Alpine
11884  W  WhereIs (search for word)     L  FOLDER LIST screen
11885                                   G  Specify a folder to go to
11886 Address Book Commands             I  MESSAGE INDEX screen
11887 ------------------------------------------------
11888  &gt;  View/Edit selected address book
11889               or
11890  &gt;  Search on selected directory server
11891
11892  %  Print list of address books and directory servers
11893 </PRE>
11894 <!--chtml endif-->
11895
11896 <H2>Description of the Address Book List Screen</H2>
11897
11898 From this screen you may choose which address book you wish to view
11899 or edit. For more information on address books, view one of your
11900 address books (with
11901 <!--chtml if pinemode="function_key"-->
11902 F4
11903 <!--chtml else-->
11904 &quot;&gt;&quot;
11905 <!--chtml endif-->)
11906 and see the Help Text there.<P>
11907
11908 You may also choose a directory server on which to search for entries.
11909 You do that by highlighting the directory server line and using
11910 <!--chtml if pinemode="function_key"-->
11911 F4
11912 <!--chtml else-->
11913 &quot;&gt;&quot;
11914 <!--chtml endif-->.<P>
11915
11916 If you wish to define new address books or directory servers go to the Main
11917 menu and choose Setup. You may then either choose to setup AddressBooks or
11918 Directory (among other things). It's possible that the Directory option
11919 will not be there if the Alpine you are using does not contain LDAP directory
11920 lookup functionality.
11921
11922 <P><UL>
11923 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
11924 </UL><P>
11925 &lt;End of help on this topic&gt;
11926 </BODY>
11927 </HTML>
11928 ===== h_abook_opened =====
11929 <HTML>
11930 <HEAD>
11931 <TITLE>THE ALPINE ADDRESS BOOK</TITLE>
11932 </HEAD>
11933 <BODY>
11934 <H1>THE ALPINE ADDRESS BOOK</H1>
11935 <H2>ADDRESS BOOK COMMANDS</H2>
11936 <PRE>
11937 <!--chtml if pinemode="function_key"-->
11938 Available  Commands -- Group 1         Available Commands -- Group 2
11939 -------------------------------        ------------------------------
11940 F1  Show Help Text                      F1  Show Help Text
11941 F2  See commands in next group          F2  See commands in next group
11942 F3  Exit this screen                    F3  Quit Alpine
11943 F4  View/Edit selected entry            F4  Go to MAIN MENU screen
11944 F5  Move to previous entry              F5  FOLDER LIST screen
11945 F6  Move to next entry                  F6  Specify a folder to go to
11946 F7  Previous page of address book       F7  MESSAGE INDEX screen
11947 F8  Next page of address book           F8  Compose to entry using roles
11948 F9  Add new entry to address book       F9  Print address book
11949 F10 Delete selected entry               F10 TakeAddr to another addrbook
11950 F11 Compose to selected entry           F11 Save or Export addrbook selections
11951 F12 Whereis (search address book)       F12 Forward entry by mail
11952
11953 Available Commands -- Group 3
11954 ------------------------------
11955 F3  Select                              F6  Zoom (or unZoom)
11956 F5  Select Current                      F7  Apply Command to Selection
11957 <!--chtml else-->
11958 Address Book Navigation        General Alpine Commands
11959 -----------------------        -----------------------
11960  P  Prev Address                  ?  Display this help text
11961  N  Next Address                  O  Show all other available commands
11962  -  Previous page of address book M  Back to MAIN MENU
11963 Spc (space bar) Next page         Q  Quit Alpine
11964  W  WhereIs (search for word      C  Compose message to selected addr
11965      or name in address book)     #  Compose to addr using roles
11966  &lt;  To List of Address Books if   L  FOLDER LIST screen
11967      more than one, else to MAIN  G  Specify a folder to go to
11968                                   I  MESSAGE INDEX screen
11969
11970 Address Book Commands
11971 ----------------------------------------------------
11972  &gt;  View/Update selected entry    D  Delete selected entries
11973  %  Print address book            S  Save or Export address book selections
11974  F  Forward entries by mail       @  Add new entry to address book
11975
11976  ;  Select command                Z  Toggle Zoom Mode
11977  :  Select highlighted entry      A  Apply command to selected entries
11978
11979 <!--chtml endif-->
11980 </PRE>
11981 Note:  The presence or absence of the final four commands above is
11982 controlled by the option
11983 <A HREF="h_config_enable_agg_ops">&quot;<!--#echo var="FEAT_enable-aggregate-command-set"-->&quot;</A>.
11984 <P>
11985
11986 <H2>Description of the Address Book Screen</H2>
11987
11988 This screen lets you edit and manage entries in your address book.  It
11989 also acts as a short-cut for composing messages to people in the address
11990 book.  When, from this screen, you press <!--chtml if pinemode="function_key"-->F11<!--chtml else-->&quot;C&quot;<!--chtml endif--> for ComposeTo, the
11991 message starts &quot;pre-addressed&quot; to whatever address book entry is
11992 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
11993 role to use in your composition.
11994 <P>
11995 Alpine's address book helps you keep a list of addresses you send email to so
11996 you do not have to remember addresses that are often complex.  Each entry
11997 in the address book has five fields, all of them optional.  The three
11998 elements that are usually visible on the ADDRESS BOOK display, are: <DL>
11999
12000         <P><DT>NICKNAME: <DD>A short easy-to-remember label to identify the entry.
12001         This is what you type in as you are addressing the message in the
12002         composer.  If there is a matching entry in your address book(s),
12003         Alpine will extract the corresponding FullName and Address fields to
12004         generate the actual address for your message.
12005
12006         <P><DT>FULLNAME: <DD>A longer field where you can put the full name
12007 of the
12008         person or organization.  Usually the full names are put in last
12009         name first so they sort nicely in alphabetical order.  Whatever
12010         you put as the name here will appear on the message when it is
12011         finally delivered.  Examples:<PRE>
12012            Garcia Marquez, Gabriel
12013            Henscheid, Eckhard
12014            Alpine-Info mailing list
12015            Library materials renewal requests
12016            Kim An-guk
12017            &quot;George III, King of Great Britain, 1738-1820&quot;
12018 </PRE>
12019 (In the second-to-last example, no comma is used in the name so that
12020 the family name appears first in the address book and when the entry is
12021 used in the composer.
12022 In the last example, retaining the commas is intended;
12023 double-quotation marks surround the name to
12024 prevent the transposition of its parts when the entry is used in
12025 the composer.)
12026
12027         <P><DT>ADDRESS: <DD>This is the actual email address itself.  This must be
12028         a valid Internet address that conforms to the Internet message
12029         header standard, RFC-822.  (See also <A HREF="h_address_format">Explanation of Address formats</A>.)</DL>
12030
12031 The two fields that aren't usually visible are:<DL>
12032
12033   <P><DT>FCC: <DD>The name of the folder you would like a copy of any outgoing
12034         message to this address to be saved in.  If this field is set, and
12035         this address is the first one in the message's To: header, then
12036         Alpine will use this folder name for the FCC in lieu of the normal
12037         FCC folder name.
12038
12039   <P><DT>COMMENTS: <DD>This field contains arbitrary text for your convenience.
12040         </DL>
12041 <P>
12042 Due to screen width limitations, these last two fields do not show up in
12043 the normal ADDRESS BOOK display.  You may select the
12044 &quot;View/Update&quot; command to
12045 view or modify them.  You may use the configuration variable
12046 <A HREF="h_config_abook_formats">&quot;<!--#echo var="VAR_addressbook-formats"-->&quot;</A>
12047 to add these fields to your ADDRESS BOOK
12048 display, or to modify the format of the display.
12049
12050 <H2>Sorting the Address book</H2>
12051
12052 By default, address book entries are sorted alphabetically on the full
12053 name with distribution lists sorted to the end.  Sorting can be changed by
12054 resetting the address book sort rule in the Alpine SETUP CONFIGURATION screen
12055 --assuming you have &quot;write&quot; permission for the address book file.
12056 <P>
12057 Unlike the sorting of folders (which only changes presentation), sorting an
12058 address book actually changes the file as it is kept on the computer.  For
12059 this reason you won't be able to sort a shared or system-wide address
12060 book.
12061
12062 <H2>Adding New Entries</H2>
12063
12064 The easiest way to add new entries to your address book is to use the
12065 &quot;TakeAddr&quot; command when viewing a message.
12066 This command allows you to take addresses from the header and body of the
12067 message and put them into your address book, without having to type
12068 them in.
12069 <P>
12070
12071 To manually add a new entry from within the address book screen, use the AddNew
12072 (<!--chtml if pinemode="function_key"-->F9<!--chtml else-->&quot;@&quot;<!--chtml endif-->) command.
12073 Use this command both for adding a simple alias and for adding a
12074 distribution list.
12075
12076 <H2>Distribution Lists</H2>
12077
12078 Address book entries can be simple cases of aliases (a single nickname is linked
12079 to a single email address) or distribution lists (a single nickname
12080 pointing at more than one email address).  Each distribution list has a
12081 nickname, a full name and a list of addresses.  The addresses may be
12082 actual addresses or they may be other nicknames in your address book.
12083 They may even refer to other distribution lists.
12084 There's really no difference between a simple alias and a distribution list,
12085 other than the number of addresses.
12086 Therefore, you can turn a simple alias with one address into a distribution
12087 list simply by adding more addresses.
12088 To add entries to an existing list or alias
12089 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
12090 a single address from the list if the cursor is placed on the address;
12091 it will delete the entire distribution list if the cursor is on the
12092 nickname/fullname line.  View/Update may also be used to delete addresses
12093 from a list.
12094 <P>
12095 Address field entries in distribution lists may take any one of three
12096 forms: a nickname existing in any of the defined address books, a normal
12097 address of the form &quot;jsmith@art.example.com&quot;, or a complete
12098 fullname/address combination, e.g. &quot;John Smith
12099 &lt;jsmith@art.example.com&gt;&quot;.
12100 <P>
12101 Distribution lists in Alpine address books can only be used by the person or
12102 people who have access to that address book.  They are not usually used to
12103 implement discussion groups, but can be used to facilitate small
12104 discussion groups if all the participants have access to the same shared
12105 address book.
12106
12107 <H2>FCC and Comments</H2>
12108
12109 As mentioned above, each entry in the address book also has two other optional
12110 fields, Fcc and Comments.  The command to look at or change either of these
12111 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
12112 Comments field is just for your own use.  The Fcc field overrides the
12113 default Fcc if this address is the first one on the To line.  The WhereIs
12114 command may be used to search for particular strings in the address book,
12115 including fields that are not visible (like Comment and Fcc by default).
12116
12117 <H2>Aggregate Operations</H2>
12118
12119 If the feature
12120 <A HREF="h_config_enable_agg_ops">&quot;<!--#echo var="FEAT_enable-aggregate-command-set"-->&quot;</A>
12121 is turned on (the default), then the four commands &quot;Select&quot;,
12122 &quot;Select Current&quot;, &quot;Zoom&quot;, and &quot;Apply&quot;
12123 are available.  The two selection commands allow you to mark a set of
12124 address book entries as being selected.  If you have more than one address
12125 book, the selections may be in more than one of those address books.
12126 The &quot;Zoom&quot; command will toggle between displaying only the selected
12127 entries and all of the entries.  The &quot;Apply&quot; command allows you to
12128 apply one of the regular address book commands to all of the selected
12129 entries.  Usually the address book commands apply to only the entry
12130 highlighted by the cursor.  The &quot;Apply&quot; command works with the
12131 commands &quot;ComposeTo&quot;, &quot;Delete&quot;, &quot;Print&quot;,
12132 &quot;Save&quot;, &quot;Forward&quot;, and &quot;Role&quot;.
12133
12134 <H2>Exporting and Forwarding Address book entries</H2>
12135
12136 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
12137 address book entry is placed in a plain text file in your home directory
12138 <!--chtml if pinemode="running"-->
12139 (which, in the present configuration of your system, is
12140  &quot;<!--#echo var="HOME_DIR"-->&quot;)
12141 <!--chtml endif-->
12142 or current working directory
12143 <!--chtml if pinemode="running"-->
12144 (which, at least for your current Alpine &quot;session,&quot;
12145 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
12146 <!--chtml endif-->, depending on the
12147 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
12148 configuration setting.  If you have some entries selected and use the
12149 Apply (<!--chtml if pinemode="function_key"-->F7<!--chtml else-->&quot;A&quot;<!--chtml endif-->) Export command, all of the selected addresses will be
12150 placed in the text file.
12151 <P>
12152 When you use the Forward (<!--chtml if pinemode="function_key"-->F12<!--chtml else-->&quot;F&quot;<!--chtml endif-->) command, the currently highlighted
12153 address book entry is placed in a special attachment and you are put into
12154 the composer.  You can fill in some comments in the body of the message,
12155 if you'd like, and send it to somebody else who uses Alpine.  The recipient
12156 may use the TakeAddr command on that message to insert the address book
12157 entry you sent in their own address book.  If you have some entries
12158 selected and use the Apply Forward command all of the selected entries
12159 will be forwarded in a single message.  You may
12160 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.
12161 The recipient must be using Alpine in order to receive this correctly.
12162 One way for the recipient to handle this might be to create an empty
12163 address book and then &quot;Take&quot; your forwarded address book entries into
12164 that empty address book.
12165
12166 <H2>Multiple and/or Site-Wide Address books</H2>
12167
12168 You may have more than one personal address book.  In addition, there may
12169 be one or more global address books.  This capability allows you to have
12170 multiple personal address books (some of which may be shared) and it also
12171 allows system administrators to implement site-wide address books that
12172 contain entries for users on multiple machines within the organization.
12173 <P><DL>
12174 <DT>Searching
12175   <DD> If you enter a nickname when composing a message, your
12176   personal address books will be searched through in order, and then the
12177   global address book(s) searched. If more than one address book has an entry
12178   for the nickname, Alpine uses the first one that it finds, so an entry in
12179   your personal address book would override a global address book entry. If
12180   after searching all the address books there is still no match, (Unix) Alpine
12181   then searches the local host password file on the assumption that you have
12182   entered a local user name rather than an address book nickname.
12183   You may change the search order of your address books with the <!--chtml if pinemode="function_key"-->F3<!--chtml else-->$<!--chtml endif--> Shuffle
12184   command, but global address books are always searched after personal
12185   address books.
12186
12187   <P><DT>Tab completion
12188   <DD> If the
12189   <A HREF="h_config_enable_tab_complete"><!--#echo var="FEAT_enable-tab-completion"--></A>
12190   feature is turned on (the default) then the Tab key may be used
12191   in the composer to complete partially typed nicknames in the To
12192   or Cc lines. You type the first few letters of a nickname and then
12193   press the Tab key. It there is only one nickname that matches it will
12194   be filled in by Alpine. If there is more than one the unambiguous part
12195   of the nicknames will be filled in. For example, if your address book or
12196   books contains only the two entries &quot;barley&quot; and &quot;barbecue&quot;
12197   beginning with the letters &quot;ba&quot;, then if you type &quot;ba&quot;
12198   followed by a Tab character Alpine will fill in &quot;bar&quot; and stop.
12199   If you then type a second Tab character you will be presented with a list
12200   of matching nicknames to select from. Alternatively, you could type another
12201   &quot;b&quot; resulting in &quot;barb&quot; and then a Tab would fill
12202   in the entire &quot;barbecue&quot; entry.
12203
12204   <P><DT>Defining
12205   <DD> You define multiple personal address books in the
12206   <A HREF="h_abook_config">SETUP AddressBooks</A> screen, which you may reach
12207   from the MAIN MENU.
12208   You may add as many as you like.  Global address books are usually
12209   site-wide address books defined by the System administrator, but
12210   you may define global address books of your own just like you define
12211   personal address books.
12212
12213   <P><DT>Creating and updating
12214   <DD> Personal address books are normally created empty
12215   and populated by explicit additions from within Alpine, e.g. via the
12216   TakeAddr command.  Unlike personal address books, global address books may
12217   not be modified/updated from within Alpine; that is, they are Read-Only.
12218   Thus, global address books are created, populated and updated outside of
12219   Alpine. They might be hand-edited, generated by a program from another
12220   database, or by copying an existing address book.  They might also be
12221   some other user's personal address book, and so be modified normally by
12222   that user but accessed Read-Only by you.  See the Alpine Technical
12223   Notes document (included in the Alpine distribution) for more information on
12224   this.
12225
12226   <P><DT>Accessing
12227   <DD>There are two different types of address books in Alpine.
12228   A local address book is stored in a regular file and the normal file
12229   access permissions apply.  A remote address book is stored on an IMAP
12230   server in a special folder that contains only messages pertaining to
12231   that address book.  The last message in the remote folder contains a
12232   copy of the address book data, and that data is copied to a local cache
12233   file in your home directory.  From there it is accessed just like a local
12234   address book.  The name of the cache file is kept track of in a special
12235   file called the
12236   <A HREF="h_config_abook_metafile"><!--#echo var="VAR_remote-abook-metafile"--></A>,
12237   the name of which is stored in
12238   your Alpine configuration file the first time you use a remote address book.
12239   Just as local Alpine address books use a format that only Alpine understands,
12240   remote Alpine address books do the same and other mail reading programs
12241   are unlikely to be able to understand them.<P>
12242   While global address books are explicitly intended to be shared, there is
12243   nothing to prevent you from sharing a personal address book with other
12244   Alpine users. This might be useful in the case of a small workgroup.
12245   However, it is recommended that updates to shared personal address books
12246   be done when other Alpine users are not accessing the address book. Alpine
12247   does not do any file-locking to manage concurrent updates to the
12248   addressbook, but it does check to see if the file has been modified before
12249   making any changes.  Consequently, inadvertent concurrent updates will
12250   only cause other Alpine users to have to restart their address book
12251   operation, which will cause Alpine to reopen the updated file.
12252
12253   <P><DT>Converting to Remote
12254   <DD>The easiest way to convert an existing local
12255   address book into a remote address book is to create an empty new remote
12256   personal address book by typing &quot;A&quot; to execute the
12257   &quot;Add Pers Abook&quot; command in the SETUP Addressbook screen.
12258   Make sure you add a <EM>personal</EM> address book, not a <EM>global</EM>
12259   address book.
12260   After you have added the empty
12261   remote address book, go into the screen for the address book you wish
12262   to copy and &quot;Select&quot; &quot;All&quot;.
12263   This selects every entry in that
12264   address book.  Then type the command &quot;Apply Save&quot;.
12265   You will be asked for the address book to save to.  You may use ^P and ^N
12266   to get to the new empty address book, then hit RETURN and the addresses
12267   will be copied.
12268   At this point you'll probably want to unselect all the entries in the local
12269   address book before proceeding. You do that with
12270   &quot;Select&quot; &quot;unselect All&quot;.
12271
12272 </DL>
12273 <UL>
12274 <LI><A HREF="h_address_format">Explanation of Address formats</A>
12275 </UL>
12276 <P><UL>
12277 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
12278 </UL>
12279 <P>
12280 &lt;End of help on this topic&gt;
12281 </BODY>
12282 </HTML>
12283 ===== h_abook_select_addr =====
12284 <HTML>
12285 <HEAD>
12286 <TITLE>Addressbook Selection Explained</TITLE>
12287 </HEAD>
12288 <BODY>
12289 <H1>SELECT ADDRESS</H1>
12290 <!--chtml if pinemode="function_key"-->
12291 <PRE>
12292 Navigating the List of Messages               General Alpine Commands
12293 -------------------------------               -----------------------
12294 F5   Move to previous entry                   F1  Show this help text
12295 F6   Move to next entry
12296 F7   Show previous screen of address book
12297 F8   Show next screen of address book
12298 F12  WhereIs (search through address book)
12299
12300 Address Selection Commands
12301 --------------------------
12302 F3   Exit the Address Select screen (without selecting an address)
12303 F4   Select the currently highlighted entry
12304 </PRE>
12305 <!--chtml else-->
12306 <PRE>
12307 Navigating the List of Messages               General Alpine Commands
12308 -------------------------------               -----------------------
12309  P   Move to previous entry                    ?  Show this help text
12310  N   Move to next entry
12311  -   Show previous screen of address book
12312 Spc  (space bar) Show next screen of address book
12313  W   WhereIs (search through address book)
12314
12315 Address Selection Commands
12316 --------------------------
12317  E   Exit the Address Select screen (without selecting an address)
12318  S   Select the currently highlighted entry
12319 </PRE>
12320 <!--chtml endif-->
12321 <P>
12322
12323 This screen is designed to let you easily scan your address book(s) in
12324 order to select an entry for the message you are composing.  You cannot
12325 edit your address book in any way at this time, for address book
12326 maintenance, select the address book command when not composing a message.
12327 <P>
12328
12329 If you are composing a message and know the nickname of the person/list you
12330 want, you can bypass this screen by simply typing in the nickname on the
12331 appropriate header line (To:, Cc:, etc.)  Exiting this screen without
12332 selecting an entry does not cancel your message.
12333 <P>
12334
12335 FOR MORE INFORMATION on addressing see
12336 <A HREF="h_address_format">Explanation of Address formats</A>, and the
12337 <A HREF="h_abook_opened">Address Book Screen's</A>
12338 help text.
12339 <P>
12340 &lt;End of help on this topic&gt;
12341 </BODY>
12342 </HTML>
12343 ===== h_abook_select_top =====
12344 <HTML>
12345 <HEAD>
12346 <TITLE>Addressbook Selection Navigation Explained</TITLE>
12347 </HEAD>
12348 <BODY>
12349 <H1>NAVIGATING WHILE SELECTING ADDRESSES</H1>
12350 <!--chtml if pinemode="function_key"-->
12351 <PRE>
12352 Navigating the List of Address Books       General Alpine Commands
12353 ------------------------------------       -----------------------
12354 F4   View the highlighted address book
12355 F5   Move to previous address book         F1  Show this help text
12356 F6   Move to next address book
12357 F7   Show previous screen of address books
12358 F8   Show next screen of address books
12359 F12  WhereIs (search through address books)
12360
12361 Address Selection Commands
12362 --------------------------
12363 F3   Exit the Address Select screen (without selecting an address)
12364 F4   Select the currently selected entries (if using ListMode)
12365 F9   Change to ListMode
12366 </PRE>
12367 <!--chtml else-->
12368 <PRE>
12369 Navigating the List of Address Books       General Alpine Commands
12370 ------------------------------------       -----------------------
12371  &gt;   View the highlighted address book
12372  P   Move to previous address book         ?  Show this help text
12373  N   Move to next address book
12374  -   Show previous screen of address books
12375 Spc  (space bar) Show next screen of address books
12376  W   WhereIs (search through address books)
12377
12378 Address Selection Commands
12379 --------------------------
12380  E   Exit the Address Select screen (without selecting an address)
12381  S   Select the currently selected entries (if using ListMode)
12382  L   Change to ListMode
12383 </PRE>
12384 <!--chtml endif-->
12385 <P>
12386
12387 This screen is designed to let you easily scan your address book(s) in
12388 order to select entries for the message you are composing.  You cannot
12389 edit your address book in any way at this time.  For address book
12390 maintenance, select the address book command when not composing a message.
12391 <P>
12392
12393 If you are composing a message and know the nickname of the person/list you
12394 want, you can bypass this screen by simply typing in the nickname on the
12395 appropriate header line (To:, Cc:, etc.)  Exiting this screen without
12396 selecting an entry does not cancel your message.
12397 <P>
12398
12399 The ListMode command will add a column at the left edge of the screen.
12400 You mark the entries that you wish to select with the &quot;X&quot; command.
12401 This allows you to choose more than one entry at a time.
12402 <P>
12403
12404 An alternative method of composing a message to entries in your
12405 address book(s) is to first use the &quot;Select&quot; command from
12406 the address book maintenance screen and then the &quot;Apply&quot;
12407 &quot;ComposeTo&quot; command to start the composer composing to the
12408 selected entries.
12409 <P>
12410
12411 FOR MORE INFORMATION on addressing see
12412 <A HREF="h_address_format">Explanation of Address formats</A>, and the
12413 <A HREF="h_abook_opened">Address Book Screen's</A>
12414 help text.
12415 <P>
12416 &lt;End of help on this topic&gt;
12417 </BODY>
12418 </HTML>
12419 ===== h_abook_select_listmode =====
12420 <HTML>
12421 <HEAD>
12422 <TITLE>Address Listmode Selection from Composer Explained</TITLE>
12423 </HEAD>
12424 <BODY>
12425 <H1>COMPOSER: SELECT ADDRESSES</H1>
12426 <!--chtml if pinemode="function_key"-->
12427 <PRE>
12428 Navigating the List of Messages                 General Alpine Commands
12429 -------------------------------                 -----------------------
12430 F5   Move to previous entry                     F1  Show this help text
12431 F6   Move to next entry
12432 F7   Show previous screen of address book
12433 F8   Show next screen of address book
12434 F12  WhereIs (search through address book)
12435
12436 Address Selection Commands
12437 --------------------------
12438 F3   Exit the Address Select screen (without selecting an address)
12439 F4   Select the currently highlighted entry
12440 F9   Change to ListMode
12441 </PRE>
12442 <!--chtml else-->
12443 <PRE>
12444 Navigating the List of Messages                 General Alpine Commands
12445 -------------------------------                 -----------------------
12446  P   Move to previous entry                     ?  Show this help text
12447  N   Move to next entry
12448  -   Show previous screen of address book
12449 Spc  (space bar) Show next screen of address book
12450  W   WhereIs (search through address book)
12451
12452 Address Selection Commands
12453 --------------------------
12454  E   Exit the Address Select screen (without selecting an address)
12455  S   Select the currently highlighted entry
12456  L   Change to ListMode
12457 </PRE>
12458 <!--chtml endif-->
12459 <P>
12460
12461 This screen is designed to let you easily scan your address book(s) in
12462 order to select entries for the message you are composing.  You cannot
12463 edit your address book in any way at this time, for address book
12464 maintenance, select the address book command when not composing a message.
12465 <P>
12466
12467 If you are composing a message and know the nickname of the person/list you
12468 want, you can bypass this screen by simply typing in the nickname on the
12469 appropriate header line (To:, Cc:, etc.)  Exiting this screen without
12470 selecting an entry does not cancel your message.
12471 <P>
12472
12473 The ListMode command will add a column at the left edge of the screen.
12474 You mark the entries that you wish to select with the &quot;X&quot; command.
12475 This allows you to choose more than one entry at a time.
12476 <P>
12477
12478 An alternative method of composing a message to entries in your
12479 address book(s) is to first use the &quot;Select&quot; command from
12480 the address book maintenance screen and then the &quot;Apply&quot;
12481 &quot;ComposeTo&quot; command to start the composer composing to the
12482 selected entries.
12483 <P>
12484
12485 FOR MORE INFORMATION on addressing see
12486 <A HREF="h_address_format">Explanation of Address formats</A>, and the
12487 <A HREF="h_abook_opened">Address Book Screen's</A>
12488 help text.
12489 <P>
12490 &lt;End of help on this topic&gt;
12491 </BODY>
12492 </HTML>
12493 ===== h_abook_select_checks =====
12494 <HTML>
12495 <HEAD>
12496 <TITLE>Address Selection from Composer Explained</TITLE>
12497 </HEAD>
12498 <BODY>
12499 <H1>COMPOSER: SELECT ADDRESSES</H1>
12500 <!--chtml if pinemode="function_key"-->
12501 <PRE>
12502 Navigating the List of Messages                 General Alpine Commands
12503 -------------------------------                 -----------------------
12504 F5   Move to previous entry                     F1  Show this help text
12505 F6   Move to next entry
12506 F7   Show previous screen of address book
12507 F8   Show next screen of address book
12508 F12  WhereIs (search through address book)
12509
12510 Address Selection Commands
12511 --------------------------
12512 F3   Exit the Address Select screen (without selecting an address)
12513 F4   Select the currently highlighted entry
12514 F8   Either Sets or Unsets all entries in this address book
12515 F9   Set or Unset the highlighted entry
12516 </PRE>
12517 <!--chtml else-->
12518 <PRE>
12519 Navigating the List of Messages                 General Alpine Commands
12520 -------------------------------                 -----------------------
12521  P   Move to previous entry                     ?  Show this help text
12522  N   Move to next entry
12523  -   Show previous screen of address book
12524 Spc  (space bar) Show next screen of address book
12525  W   WhereIs (search through address book)
12526
12527 Address Selection Commands
12528 --------------------------
12529  E   Exit the Address Select screen (without selecting an address)
12530  S   Select the currently highlighted entry
12531  X   Set or Unset the highlighted entry
12532  A   Either Sets or Unsets all entries in this address book
12533 </PRE>
12534 <!--chtml endif-->
12535 <P>
12536
12537 Mark the entries you wish to select with the &quot;X Set/Unset&quot;
12538 command.  Type &quot;S Select&quot; to select all of the entries you
12539 have marked, just as if you had typed them in by hand.
12540 <P>
12541
12542 An alternative method of composing a message to entries in your
12543 address book(s) is to first use the &quot;Select&quot; command from
12544 the address book maintenance screen and then the &quot;Apply&quot;
12545 &quot;ComposeTo&quot; command to start the composer composing to the
12546 selected entries.
12547 <P>
12548
12549 FOR MORE INFORMATION on addressing see
12550 <A HREF="h_address_format">Explanation of Address formats</A>, and the
12551 <A HREF="h_abook_opened">Address Book Screen's</A>
12552 help text.
12553 <P>
12554 &lt;End of help on this topic&gt;
12555 </BODY>
12556 </HTML>
12557 ===== h_abook_select_nicks_take =====
12558 <HTML>
12559 <HEAD>
12560 <TITLE>Take Address Nickname Selection Explained</TITLE>
12561 </HEAD>
12562 <BODY>
12563 <H1>TAKEADDR: SELECT NICKNAME</H1>
12564 <!--chtml if pinemode="function_key"-->
12565 <PRE>
12566 Navigating the List of Messages                 General Alpine Commands
12567 -------------------------------                 -----------------------
12568 F5   Move to previous entry                     F1  Show this help text
12569 F6   Move to next entry
12570 F7   Show previous screen of address book
12571 F8   Show next screen of address book
12572 F12  WhereIs (search through address book)
12573
12574 Message Selection Commands
12575 --------------------------
12576 F3   Exit the Nickname Select screen (without selecting an address)
12577 F4   Select the currently highlighted entry
12578 </PRE>
12579 <!--chtml else-->
12580 <PRE>
12581 Navigating the List of Messages                 General Alpine Commands
12582 -------------------------------                 -----------------------
12583  P   Move to previous entry                     ?  Show this help text
12584  N   Move to next entry
12585  -   Show previous screen of address book
12586 Spc  (space bar) Show next screen of address book
12587  W   WhereIs (search through address book)
12588
12589 Message Selection Commands
12590 --------------------------
12591  E   Exit the Nickname Select screen (without selecting an address)
12592  S   Select the currently highlighted entry
12593 </PRE>
12594 <!--chtml endif-->
12595 <P>
12596
12597 This screen is designed to let you modify or add to an existing
12598 address book entry.  You have already selected the name(s) and
12599 address(es) through &quot;Take Address&quot;.  This screen simply lets
12600 you scan your address books and select the nickname to be
12601 changed/augmented.  If you want to add a new entry, then you are in
12602 the wrong place-- Select &quot;Exit&quot; command.
12603 <P>
12604
12605 FOR MORE INFORMATION on addressing see
12606 <A HREF="h_address_format">Explanation of Address formats</A>, and the
12607 <A HREF="h_abook_opened">Address Book Screen's</A>
12608 help text.
12609 <P>
12610 &lt;End of help on this topic&gt;
12611 </BODY>
12612 </HTML>
12613 ===== h_abook_select_nick =====
12614 <HTML>
12615 <HEAD>
12616 <TITLE>Nickname Selection Explained</TITLE>
12617 </HEAD>
12618 <BODY>
12619 <H1>SELECT NICKNAME</H1>
12620 <!--chtml if pinemode="function_key"-->
12621 <PRE>
12622 Navigating the List of Messages                 General Alpine Commands
12623 -------------------------------                 -----------------------
12624 F5   Move to previous entry                     F1  Show this help text
12625 F6   Move to next entry
12626 F7   Show previous screen of address book
12627 F8   Show next screen of address book
12628 F12  WhereIs (search through address book)
12629
12630 Message Selection Commands
12631 --------------------------
12632 F3   Exit the Nickname Select screen (without selecting an address)
12633 F4   Select the currently highlighted entry
12634 </PRE>
12635 <!--chtml else-->
12636 <PRE>
12637 Navigating the List of Messages                 General Alpine Commands
12638 -------------------------------                 -----------------------
12639  P   Move to previous entry                     ?  Show this help text
12640  N   Move to next entry
12641  -   Show previous screen of address book
12642 Spc  (space bar) Show next screen of address book
12643  W   WhereIs (search through address book)
12644
12645 Message Selection Commands
12646 --------------------------
12647  E   Exit the Nickname Select screen (without selecting an address)
12648  S   Select the currently highlighted entry
12649 </PRE>
12650 <!--chtml endif-->
12651 <P>
12652
12653 This screen is designed to let you look at the nicknames in your address
12654 books before choosing a new one.
12655 <P>
12656
12657 FOR MORE INFORMATION on addressing see
12658 <A HREF="h_address_format">Explanation of Address formats</A>, and the
12659 <A HREF="h_abook_opened">Address Book Screen's</A>
12660 help text.
12661 <P>
12662 &lt;End of help on this topic&gt;
12663 </BODY>
12664 </HTML>
12665 ===== h_takeaddr_screen =====
12666 <HTML>
12667 <HEAD>
12668 <TITLE>Take Address Screen Explained</TITLE>
12669 </HEAD>
12670 <BODY>
12671 <H1>TAKE ADDRESS COMMANDS</H1>
12672 <!--chtml if pinemode="function_key"-->
12673 <PRE>
12674 Navigating the List of Addresses       Address Selection Commands
12675 --------------------------------       --------------------------
12676  F5  Move to previous entry            F3  Exit without taking address
12677  F6  Move to next entry                F4  Take current address(es)
12678  F7  Show previous page of address list
12679  F8  Show next page of address list
12680  F2  WhereIs (search list)
12681                                --------------
12682 Mode Toggle            F9  Set/Unset current address
12683 -----------            F10 Set all
12684  F12 Toggle between List and single mode       F11 Unset all
12685 </PRE>
12686 <!--chtml else-->
12687 <PRE>
12688 Navigating the List of Addresses       Address Selection Commands
12689 --------------------------------       --------------------------
12690  P  Move to previous entry              &lt;  Exit without taking address
12691  N  Move to next entry                  T  Take address
12692  -  Show previous page of address list
12693 Spc (space bar) Show next page of address list
12694  W  WhereIs (search list)              List Mode
12695                                        ---------
12696 Single Mode                             X  Set/Unset current address
12697 -----------                             A  Set all addresses
12698  L  Switch to list mode                 U  Unset all addresses
12699                                         S  Switch to single mode
12700 </PRE>
12701 <!--chtml endif-->
12702
12703 <H2>Description of the Take Address Screen</H2>
12704
12705 This screen is designed to let you select one or more address/name
12706 combinations from the current message and put them into your address book.
12707 The cursor is initially placed on the line with the message author.
12708 Other lines include the names of people and/or mailing lists who also
12709 received the message.  Other people &quot;involved&quot; in the
12710 message (e.g. the person named as Reply-To:) are also listed here.
12711 <P>
12712
12713 The simple case is adding a new, single entry into your address book. To
12714 do this, simply highlight the correct line and press
12715 <!--chtml if pinemode="function_key"-->
12716 F4.
12717 <!--chtml else-->
12718 &quot;T&quot;.
12719 <!--chtml endif-->
12720 To create a new list or add to an existing list, switch the screen display
12721 into List Mode by pressing
12722 <!--chtml if pinemode="function_key"-->
12723 F12.
12724 <!--chtml else-->
12725 &quot;L&quot;.
12726 <!--chtml endif-->
12727 In List Mode, you select the
12728 group of addresses you wish to manipulate by marking them with an
12729 &quot;X&quot;.
12730 The Set/Unset
12731 <!--chtml if pinemode="function_key"-->
12732 (F9)
12733 <!--chtml else-->
12734 (&quot;X&quot;)
12735 <!--chtml endif-->
12736 command will turn the &quot;X&quot; on for the
12737 highlighted address if it was off or turn it off if it was previously on.
12738 The SetAll command will select all of the addresses, and the UnSetAll
12739 command will turn off all the selections.  Once you've gotten the
12740 selection the way you want it, you may create a new list by pressing
12741 <!--chtml if pinemode="function_key"-->
12742 F4.
12743 <!--chtml else-->
12744 &quot;T&quot;.
12745 <!--chtml endif-->
12746 <P>
12747
12748 In both the simple and list cases, after choosing to take the address,
12749 you will be asked for the nickname of the entry.  Typing in a new name
12750 creates the new entry/list.  Entering an existing nickname will replace
12751 the entry (simple case) or add to the list (list case).  Alternatively,
12752 you can press Ctrl-T at the nickname prompt and select an existing
12753 nickname from your address book.
12754 <P>
12755
12756 You will normally start in Single Mode, unless you used the Apply command
12757 to startup the TakeAddr screen, in which case you will start in List Mode.
12758 You may switch between the two modes at any time.  If you've already
12759 selected several addresses in List Mode, those will be remembered when you
12760 switch to Single Mode and then back to List Mode.  The set of addresses
12761 that are pre-selected when you start in List Mode are the From addresses
12762 of all of the messages you are operating on.  You may, of course, easily
12763 erase those selections with the UnSetAll command.
12764 <P>
12765
12766 If you have more than one writable address book, you will be prompted for
12767 the name of the address book you wish to add the new entry to before
12768 anything else. You can use ^N and ^P to choose among the defined address
12769 books, or type in the address book name.
12770 <P>
12771
12772 FOR MORE INFORMATION on addressing see
12773 <A HREF="h_address_format">Explanation of Address formats</A>, and the
12774 <A HREF="h_abook_opened">Address Book Screen's</A>
12775 help text.
12776 <P>
12777 &lt;End of help on this topic&gt;
12778 </BODY>
12779 </HTML>
12780 ===== h_takeexport_screen =====
12781 <HTML>
12782 <HEAD>
12783 <TITLE>Take Export Screen Explained</TITLE>
12784 </HEAD>
12785 <BODY>
12786 <H1>TAKE EXPORT COMMANDS</H1>
12787 <!--chtml if pinemode="function_key"-->
12788 <PRE>
12789 Navigating the List of Addresses       Address Selection Commands
12790 --------------------------------       --------------------------
12791  F5  Move to previous entry            F3  Exit without taking address
12792  F6  Move to next entry                F4  Take current address(es)
12793  F7  Show previous page of address list
12794  F8  Show next page of address list
12795  F2  WhereIs (search list)
12796                                --------------
12797 Mode Toggle            F9  Set/Unset current address
12798 -----------            F10 Set all
12799  F12 Toggle between List and single mode       F11 Unset all
12800 </PRE>
12801 <!--chtml else-->
12802 <PRE>
12803 Navigating the List of Addresses       Address Selection Commands
12804 --------------------------------       --------------------------
12805  P  Move to previous entry              &lt;  Exit without taking address
12806  N  Move to next entry                  T  Take address
12807  -  Show previous page of address list
12808 Spc (space bar) Show next page of address list
12809  W  WhereIs (search list)              List Mode
12810                                        ---------
12811 Single Mode                             X  Set/Unset current address
12812 -----------                             A  Set all addresses
12813  L  Switch to list mode                 U  Unset all addresses
12814                                         S  Switch to single mode
12815 </PRE>
12816 <!--chtml endif-->
12817
12818 <H2>Description of the Take Export Screen</H2>
12819
12820 This screen is designed to let you select one or more addresses
12821 from the current message and put them into a file.
12822 Only the user@domain_name part of each address is put into the file.
12823 <P>
12824
12825 To put a single entry into a file simply highlight the correct line and press
12826 <!--chtml if pinemode="function_key"-->
12827 F4.
12828 <!--chtml else-->
12829 &quot;T&quot;.
12830 <!--chtml endif-->
12831 To put more than one entry into a file
12832 switch the screen display
12833 into List Mode by pressing
12834 <!--chtml if pinemode="function_key"-->
12835 F12.
12836 <!--chtml else-->
12837 &quot;L&quot;.
12838 <!--chtml endif-->
12839 In List Mode, you select the
12840 group of addresses you wish to manipulate by marking them with an
12841 &quot;X&quot;.
12842 The Set/Unset
12843 <!--chtml if pinemode="function_key"-->
12844 (F9)
12845 <!--chtml else-->
12846 (&quot;X&quot;)
12847 <!--chtml endif-->
12848 command will turn the &quot;X&quot; on for the
12849 highlighted address if it was off or turn it off if it was previously on.
12850 The SetAll command will select all of the addresses, and the UnSetAll
12851 command will turn off all the selections.  Once you've gotten the
12852 selection the way you want it, you may put the addresses in a file by typing
12853 <!--chtml if pinemode="function_key"-->
12854 F4.
12855 <!--chtml else-->
12856 &quot;T&quot;.
12857 <!--chtml endif-->
12858 <P>
12859
12860 You will be asked for the name of a file to put the addresses in.
12861 If the file already exists, you will be asked whether you want to Overwrite
12862 (replace) the contents of the file or Append to the contents of the file.
12863 <P>
12864
12865 &lt;End of help on this topic&gt;
12866 </BODY>
12867 </HTML>
12868 ============= h_abook_view ========================
12869 <HTML>
12870 <HEAD>
12871 <TITLE>Address Book View Explained</TITLE>
12872 </HEAD>
12873 <BODY>
12874 This function allows you to view the contents of an address book entry. You
12875 can only view one entry at a time.
12876 <P>
12877 <DL>
12878 <DT>Help
12879 <!--chtml if pinemode="function_key"-->
12880 (F1)
12881 <!--chtml else-->
12882 (?)
12883 <!--chtml endif-->
12884 </DT>
12885 <DD>
12886 Display this help text.
12887
12888 <DT>Abook
12889 <!--chtml if pinemode="function_key"-->
12890 (F3)
12891 <!--chtml else-->
12892 (&lt;)
12893 <!--chtml endif-->
12894 </DT>
12895 <DD>
12896 Go back to index of address book entries.
12897
12898 <DT>Update
12899 <!--chtml if pinemode="function_key"-->
12900 (F4)
12901 <!--chtml else-->
12902 (U)
12903 <!--chtml endif-->
12904 </DT>
12905 <DD>
12906 Update (modify) this entry.
12907
12908 <DT>ComposeTo
12909 <!--chtml if pinemode="function_key"-->
12910 (F5)
12911 <!--chtml else-->
12912 (C)
12913 <!--chtml endif-->
12914 </DT>
12915 <DD>Compose a message to the address(es) in this entry.
12916
12917 <DT>Role
12918 <!--chtml if pinemode="function_key"-->
12919 (F6)
12920 <!--chtml else-->
12921 (#)
12922 <!--chtml endif-->
12923 </DT>
12924 <DD>Compose a message to the address(es) in this entry using roles.
12925
12926 <DT>Prev Page
12927 <!--chtml if pinemode="function_key"-->
12928 (F7)
12929 <!--chtml else-->
12930 (-)
12931 <!--chtml endif-->
12932 </DT>
12933 <DD>
12934 Show the previous page of the current entry.
12935
12936 <DT>Next Page
12937 <!--chtml if pinemode="function_key"-->
12938 (F8)
12939 <!--chtml else-->
12940 (Space)
12941 <!--chtml endif-->
12942 </DT>
12943 <DD>
12944 Show the next page of the current entry.
12945
12946 <DT>Print
12947 <!--chtml if pinemode="function_key"-->
12948 (F9)
12949 <!--chtml else-->
12950 (%)
12951 <!--chtml endif-->
12952 </DT>
12953 <DD>Print the current entry.  You can select the
12954 printer or the print command via the &quot;Setup&quot; command
12955 on the MAIN MENU.
12956
12957 <DT>WhereIs
12958 <!--chtml if pinemode="function_key"-->
12959 (F10)
12960 <!--chtml else-->
12961 (W)
12962 <!--chtml endif-->
12963 </DT>
12964 <DD>Search the entry for a string of letters.  If it is
12965 found, move to it.  The string can be one word or a phrase.
12966 If there are multiple occurrences, the cursor moves to the
12967 first occurrence beyond the current cursor position.
12968
12969 <DT>Fwd Email
12970 <!--chtml if pinemode="function_key"-->
12971 (F11)
12972 <!--chtml else-->
12973 (F)
12974 <!--chtml endif-->
12975 </DT>
12976 <DD>Begin composition of a new mail message with the displayed
12977 text already inserted in the message body.
12978
12979 </DL>
12980 <P>
12981 &lt;End of help on this topic&gt;
12982 </BODY>
12983 </HTML>
12984 ============= h_ldap_view ========================
12985 <HTML>
12986 <HEAD>
12987 <TITLE>LDAP Response View Explained</TITLE>
12988 </HEAD>
12989 <BODY>
12990 This function allows you to view the contents of a directory entry. You
12991 can only view one entry at a time.
12992 <P>
12993 <DL>
12994 <DT>Help
12995 <!--chtml if pinemode="function_key"-->
12996 (F1)
12997 <!--chtml else-->
12998 (?)
12999 <!--chtml endif-->
13000 </DT>
13001 <DD>
13002 Display this help text.
13003
13004 <DT>Results Index
13005 <!--chtml if pinemode="function_key"-->
13006 (F3)
13007 <!--chtml else-->
13008 (&lt;)
13009 <!--chtml endif-->
13010 </DT>
13011 <DD>Go back to index of search results.
13012
13013 <DT>ComposeTo
13014 <!--chtml if pinemode="function_key"-->
13015 (F5)
13016 <!--chtml else-->
13017 (C)
13018 <!--chtml endif-->
13019 </DT>
13020 <DD>Compose a message to the address(es) in this entry.
13021
13022 <DT>Role
13023 <!--chtml if pinemode="function_key"-->
13024 (F6)
13025 <!--chtml else-->
13026 (#)
13027 <!--chtml endif-->
13028 </DT>
13029 <DD>Compose a message to the address(es) in this entry using roles.
13030
13031 <DT>Prev Page
13032 <!--chtml if pinemode="function_key"-->
13033 (F7)
13034 <!--chtml else-->
13035 (-)
13036 <!--chtml endif-->
13037 </DT>
13038 <DD>
13039 Show the previous page of the current entry.
13040
13041 <DT>Next Page
13042 <!--chtml if pinemode="function_key"-->
13043 (F8)
13044 <!--chtml else-->
13045 (Space)
13046 <!--chtml endif-->
13047 </DT>
13048 <DD>
13049 Show the next page of the current entry.
13050
13051 <DT>Print
13052 <!--chtml if pinemode="function_key"-->
13053 (F9)
13054 <!--chtml else-->
13055 (%)
13056 <!--chtml endif-->
13057 </DT>
13058 <DD>Print the current entry on paper.  You can select the
13059 printer or the print command via the &quot;Setup&quot; command
13060 on the MAIN MENU.
13061
13062 <DT>WhereIs
13063 <!--chtml if pinemode="function_key"-->
13064 (F10)
13065 <!--chtml else-->
13066 (W)
13067 <!--chtml endif-->
13068 </DT>
13069 <DD>Search the entry for a string of letters.  If it is
13070 found, move to it.  The string can be one word or a phrase.
13071 If there are multiple occurrences, the cursor moves to the
13072 first occurrence beyond the current cursor position.
13073
13074 <DT>Fwd Email
13075 <!--chtml if pinemode="function_key"-->
13076 (F11)
13077 <!--chtml else-->
13078 (F)
13079 <!--chtml endif-->
13080 </DT>
13081 <DD>Begin composition of a new mail message with the displayed
13082 text already inserted in the message body.
13083
13084 <DT>Save
13085 <!--chtml if pinemode="function_key"-->
13086 (F12)
13087 <!--chtml else-->
13088 (S)
13089 <!--chtml endif-->
13090 </DT>
13091 <DD>Save the displayed entry to one of your address books or export
13092 it to a file.
13093 </DL>
13094 <P>
13095 &lt;End of help on this topic&gt;
13096 </BODY>
13097 </HTML>
13098 ===== h_attachment_screen =====
13099 <HTML>
13100 <HEAD>
13101 <TITLE>Attachment Index Screen Explained</TITLE>
13102 </HEAD>
13103 <BODY>
13104 The &quot;ATTACHMENT INDEX&quot; displays a list of the current
13105 message's attachments, and allows various operations on them.  The
13106 first attachment is usually the message text, but does not include the
13107 header portion of the message.
13108 <P>
13109 Available commands include:
13110 <P>
13111 <DL>
13112
13113 <DT>Help</DT>
13114 <DD>Show this help text.
13115
13116 <DT>Msg #<I>num</I></DT>
13117 <DD>Leave this screen without displaying or saving any attachments.
13118
13119 <DT>View</DT>
13120 <DD>View the currently selected attachment.
13121
13122 <DT>Prev Attach</DT>
13123 <DD>Move to previous attachment.
13124
13125 <DT>Next Attach</DT>
13126 <DD>Move to next attachment.
13127
13128 <DT>Prev Page</DT>
13129 <DD>Previous page of the listed attachments.
13130
13131 <DT>Next Page</DT>
13132 <DD>Next page of the listed attachments.
13133
13134 <DT>Delete</DT>
13135 <DD>Mark the currently selected attachment for Deletion.
13136 This does not modify the current message by deleting the attachment from
13137 it, but instead the delete flag <EM>only</EM> has an effect when saving
13138 the message to a folder.
13139 Attachments marked for deletion are not copied to the destination folder
13140 along with the rest of the message when it is saved.
13141 It is ok for the destination folder to be the same as the current folder.
13142 In addition, the delete mark <EM>only</EM> applies to this Alpine session.
13143
13144 <DT>Undelete</DT>
13145 <DD>Turn off the Delete flag for the selected attachment.
13146
13147 <DT>Save</DT>
13148 <DD>Save the selected attachment to a file.  If the attachment is of
13149 type &quot;RFC822/Message&quot;, then the attachment will be saved to
13150 the specified mail folder.
13151
13152 <DT>Export</DT>
13153 <DD>If the attachment is of
13154 type &quot;RFC822/Message&quot;, then &quot;Export&quot; is used to
13155 copy the message to a file in the same way this command works on
13156 messages in the MESSAGE INDEX and MESSAGE TEXT screens.
13157
13158 <DT>Pipe</DT>
13159 <DD>Pipe the attachment contents into a UNIX command (if enabled).
13160 A description of the Pipe sub-commands is  <A HREF="h_pipe_command">here</A>.
13161
13162 <DT>WhereIs</DT>
13163 <DD>Find a matching string in the attachment list.
13164
13165 <DT>AboutAttch</DT>
13166 <DD>Examine various aspects of the selected attachment.
13167
13168 <DT>Print</DT>
13169 <DD>Print the selected attachment.
13170
13171 <DT>Forward</DT>
13172 <DD>Forward the selected attachment as an attachment.
13173 </DL>
13174
13175 <P>
13176
13177 All attachments can be saved or piped into a UNIX command, but some may
13178 not be readily displayed by either Alpine or an external tool.  In such
13179 cases, the reason why the message cannot be displayed is displayed on
13180 Alpine's message line.
13181 <P>
13182 &lt;End of help on this topic&gt;
13183 </BODY>
13184 </HTML>
13185 ============= h_mail_text_att_view ========================
13186 <HTML>
13187 <HEAD>
13188 <TITLE>Attachment View Screen Explained</TITLE>
13189 </HEAD>
13190 <BODY>
13191 This function allows you to view the contents of a text attachment. You
13192 can only view one attachment at a time.
13193 <P>
13194 Available commands include:
13195 <P>
13196 <DL>
13197
13198 <DT>Help</DT>
13199 <DD>Display this help text
13200
13201 <DT>AttchIndex</DT>
13202 <DD>Leave viewer and return to the &quot;ATTACHMENT INDEX&quot; screen
13203
13204 <DT>Prev Page</DT>
13205 <DD>Show the previous page of the current attachment.
13206
13207 <DT>Next Page</DT>
13208 <DD>Show the next page of the current attachment by pressing the space bar.
13209
13210 <DT>Delete</DT>
13211 <DD>Mark the viewed attachment for Deletion.  The delete
13212 flag <EM>only</EM> has affect when saving the message to a folder.
13213 Attachments marked for deletion are exluded from the messsage when
13214 it is saved.  In addition, the delete mark <EM>only</EM> applies to
13215 this Alpine session.
13216
13217 <DT>Undelete</DT>
13218 <DD>Turn off the Delete flag for the selected attachment.
13219
13220 <DT>Save</DT>
13221 <DD>Copy the current attachment to a file.  If you just enter
13222 a filename, the attachment will be saved with that name in
13223 your home directory
13224 <!--chtml if pinemode="running"-->
13225 (which, in the present configuration of your system, is
13226  &quot;<!--#echo var="HOME_DIR"-->&quot;)
13227 <!--chtml endif-->
13228 or current working directory
13229 <!--chtml if pinemode="running"-->
13230 (which, at least for your current Alpine &quot;session,&quot;
13231 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
13232 <!--chtml endif-->, depending on the
13233 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
13234 configuration setting.  You may enter the full
13235 path and filename to save it in another directory instead.
13236
13237 <DT>Export</DT>
13238 <DD>If the attachment is of
13239 type &quot;RFC822/Message&quot;, then &quot;Export&quot; is used to
13240 copy the message to a file in the same way this command works on
13241 messages in the MESSAGE INDEX and MESSAGE TEXT screens.
13242 (If you have any <A HREF="h_config_display_filters"><!--#echo var="VAR_display-filters"--></A>
13243 defined, they may affect the contents of the exported file.)
13244
13245 <DT>Pipe</DT>
13246 <DD>Pipe the attachment contents into a UNIX command (if enabled)
13247
13248 <DT>WhereIs</DT>
13249 <DD>Search the attachment for a string of letters.  If it is
13250 found, move to it.  The string can be one word or a phrase.
13251 If there are multiple occurrences, the cursor moves to the
13252 first occurrence beyond the current cursor position.
13253
13254 <DT>Print</DT>
13255 <DD>Print the current attachment on paper.  You can select the
13256 printer or the print command via the &quot;Setup&quot; command
13257 on the MAIN MENU.
13258
13259 <DT>Forward</DT>
13260 <DD>Forward the selected attachment as an attachment.
13261 </DL>
13262 <P>
13263 &lt;End of help on this topic&gt;
13264 </BODY>
13265 </HTML>
13266 ============= h_journal ==============
13267 <HTML>
13268 <HEAD>
13269 <TITLE>Recent Message Journal Explained</TITLE>
13270 </HEAD>
13271 <BODY>
13272
13273 The following commands are available on this screen:
13274 <P>
13275 <DL>
13276 <DT>Help</DT>
13277 <DD>Show this help text
13278
13279 <DT>Exit</DT>
13280 <DD>Exit Viewer, and go back to mail processing
13281
13282 <DT>Prev Page</DT>
13283 <DD>Show the previous page text
13284
13285 <DT>Next Page</DT>
13286 <DD>Show the next page of text by pressing the space bar
13287
13288 <DT>Print</DT>
13289 <DD>Print the displayed text on paper.  You can select the
13290 printer or the print command via the &quot;Setup&quot; command
13291 on the MAIN MENU.
13292
13293 <DT>Fwd Email</DT>
13294 <DD>Begin composition of a new mail message with the displayed
13295 text already inserted in the message body.
13296
13297 <DT>Save</DT>
13298 <DD>Copy the displayed text to a file.  If you just enter
13299 a filename, the text will be saved with that name in
13300 your
13301 home directory
13302 <!--chtml if pinemode="running"-->
13303 (which, in the present configuration of your system, is
13304  &quot;<!--#echo var="HOME_DIR"-->&quot;)
13305 <!--chtml endif-->
13306 or current working directory
13307 <!--chtml if pinemode="running"-->
13308 (which, at least for your current Alpine &quot;session,&quot;
13309 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
13310 <!--chtml endif-->, depending on the
13311 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
13312 configuration setting.   You may enter the full
13313 path and filename to save it in another directory instead.
13314
13315 <DT>WhereIs</DT>
13316 <DD>Search the text for a string of letters.  If it is
13317 found, move to it.  The string can be one word or a phrase.
13318 If there are multiple occurrences, the cursor moves to the
13319 first occurrence beyond the current cursor position.
13320 </DL>
13321 <P>
13322 &lt;End of help on this topic&gt;
13323 </BODY>
13324 </HTML>
13325 ============= h_debugjournal ==============
13326 <HTML>
13327 <HEAD>
13328 <TITLE>Debug Journal Explained</TITLE>
13329 </HEAD>
13330 <BODY>
13331
13332 The following commands are available on this screen:
13333 <P>
13334 <DL>
13335 <DT>Help</DT>
13336 <DD>Show this help text
13337
13338 <DT>Exit</DT>
13339 <DD>Exit Viewer, and go back to mail processing
13340
13341 <DT>Timestamps</DT>
13342 <DD>Turn on or off timestamps.
13343
13344 <DT>DebugView</DT>
13345 <DD>Set the level of debugging you want to see. The level may be any number
13346 in the range 0-9. Higher numbers show more debugging detail. Note that the
13347 debugging information has already been captured. This setting just causes the
13348 debugging information that you see to be filtered. If you set this to
13349 the number &quot;5&quot; then you will be shown all of the debugging information
13350 at levels 5 and below.
13351 It's actually a bit more complicated than that. A fixed amount of memory
13352 is used to store the debug information.
13353 Since the amount of memory used is limited the debugging information
13354 has to be trimmed back when it gets too large.
13355
13356 <DT>Prev Page</DT>
13357 <DD>Show the previous page text
13358
13359 <DT>Next Page</DT>
13360 <DD>Show the next page of text by pressing the space bar
13361
13362 <DT>Print</DT>
13363 <DD>Print the displayed text on paper.  You can select the
13364 printer or the print command via the &quot;Setup&quot; command
13365 on the MAIN MENU.
13366
13367 <DT>Fwd Email</DT>
13368 <DD>Begin composition of a new mail message with the displayed
13369 text already inserted in the message body.
13370
13371 <DT>Save</DT>
13372 <DD>Copy the displayed text to a file.  If you just enter
13373 a filename, the text will be saved with that name in
13374 your
13375 home directory
13376 <!--chtml if pinemode="running"-->
13377 (which, in the present configuration of your system, is
13378  &quot;<!--#echo var="HOME_DIR"-->&quot;)
13379 <!--chtml endif-->
13380 or current working directory
13381 <!--chtml if pinemode="running"-->
13382 (which, at least for your current Alpine &quot;session,&quot;
13383 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
13384 <!--chtml endif-->, depending on the
13385 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
13386 configuration setting.   You may enter the full
13387 path and filename to save it in another directory instead.
13388
13389 <DT>WhereIs</DT>
13390 <DD>Search the text for a string of letters.  If it is
13391 found, move to it.  The string can be one word or a phrase.
13392 If there are multiple occurrences, the cursor moves to the
13393 first occurrence beyond the current cursor position.
13394 </DL>
13395 <P>
13396 &lt;End of help on this topic&gt;
13397 </BODY>
13398 </HTML>
13399 ============= h_simple_text_view ==============
13400 <HTML>
13401 <HEAD>
13402 <TITLE>Simple Text View Screen Explained</TITLE>
13403 </HEAD>
13404 <BODY>
13405
13406 The following commands are available on this screen:
13407 <P>
13408 <DL>
13409 <DT>Help</DT>
13410 <DD>Show this help text
13411
13412 <DT>Exit</DT>
13413 <DD>Exit Viewer, and go back to mail processing
13414
13415 <DT>Prev Page</DT>
13416 <DD>Show the previous page text
13417
13418 <DT>Next Page</DT>
13419 <DD>Show the next page of text by pressing the space bar
13420
13421 <DT>Print</DT>
13422 <DD>Print the displayed text on paper.  You can select the
13423 printer or the print command via the &quot;Setup&quot; command
13424 on the MAIN MENU.
13425
13426 <DT>Fwd Email</DT>
13427 <DD>Begin composition of a new mail message with the displayed
13428 text already inserted in the message body.
13429
13430 <DT>Save</DT>
13431 <DD>Copy the displayed text to a file.  If you just enter
13432 a filename, the attachment will be saved with that name in
13433 your
13434 home directory
13435 <!--chtml if pinemode="running"-->
13436 (which, in the present configuration of your system, is
13437  &quot;<!--#echo var="HOME_DIR"-->&quot;)
13438 <!--chtml endif-->
13439 or current working directory
13440 <!--chtml if pinemode="running"-->
13441 (which, at least for your current Alpine &quot;session,&quot;
13442 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
13443 <!--chtml endif-->, depending on the
13444 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
13445 configuration setting.   You may enter the full
13446 path and filename to save it in another directory instead.
13447
13448 <DT>WhereIs</DT>
13449 <DD>Search the attachment for a string of letters.  If it is
13450 found, move to it.  The string can be one word or a phrase.
13451 If there are multiple occurrences, the cursor moves to the
13452 first occurrence beyond the current cursor position.
13453 </DL>
13454 <P>
13455 &lt;End of help on this topic&gt;
13456 </BODY>
13457 </HTML>
13458 ======= h_pine_for_windows ========
13459 <HTML>
13460 <HEAD>
13461 <TITLE>GETTING HELP IN PC-ALPINE</TITLE>
13462 </HEAD>
13463 <BODY>
13464 <H1>Getting Help In PC-Alpine</H1>
13465
13466 <P>
13467 PC-Alpine offers general and specific help text. From the <A
13468 HREF="main_menu_tx">MAIN MENU</A>, you will find an overview in the MAIN
13469 MENU HELP and the <A HREF="h_news">Release Notes</A>.  On all screens,
13470 specific help for that screen is available from the toolbar Help menu or
13471 with the
13472 <!--chtml if pinemode="function_key"-->
13473 &quot;F1&quot; key.
13474 <!--chtml else-->
13475 &quot;?&quot; or &quot;Ctrl-G&quot; keys. &quot;Ctrl-G&quot; is used where
13476 typing &quot;?&quot; would be mistaken as entering text.
13477 <!--chtml endif-->
13478
13479 <P>
13480 Although this version of Alpine is for Microsoft Windows, it is not
13481 considered a full &quot;Graphical User Interface&quot; application.
13482 Yet, many of the controls that Windows users are accustomed to seeing,
13483 such as scrollbars and toolbars, are available.
13484
13485 <P>
13486 PC-Alpine offers considerable mouse support.  You can view what is
13487 &quot;click-able&quot; by dragging your mouse over any screen; when the
13488 arrow cursor changes into a hand, you found something. Mouse-click
13489 possibilities include navigating between screens and folders and
13490 double-clicking on hyperlinks to open your Web browser.
13491 Context-sensitive pop-up menus appear with a right-click on your PC-Alpine
13492 screen.  Examples of right-click options include &quot;copy&quot; after
13493 selecting text to copy and &quot;View in New Window&quot; when you click
13494 on a particular message in the Message Index. The menu choices available
13495 to you will vary based upon what screen is open, where on the screen your
13496 cursor is located, and even what action you have already taken.
13497
13498 <P>
13499 &lt;End of help on this topic&gt;
13500 </BODY>
13501 </HTML>
13502 ===== h_composer =====
13503 <HTML>
13504 <HEAD>
13505 <TITLE>COMPOSER COMMANDS</TITLE>
13506 </HEAD>
13507 <BODY>
13508 <H1>COMPOSER COMMANDS</H1>
13509
13510 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>
13511 &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>
13512 &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>
13513 &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>
13514 &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>
13515 &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>
13516 &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>
13517 &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>
13518 &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>
13519 &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>
13520 ---------------------------------------|&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>
13521 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>
13522 &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>
13523 &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>
13524 &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>
13525
13526 <P>
13527 NOTE:
13528 <OL>
13529  <LI>For help on a particular command, highlight the bold text associated
13530 with it above and hit Return.
13531  <LI> The availability of certain commands
13532 is determined by Alpine configuration files and system capabilities.
13533 At some sites, certain commands may not be available due to security or
13534 support concerns.
13535  <LI>Alpine does not use the following keys:  Ctrl-S, Ctrl-Q, Ctrl-],
13536 Ctrl-&#92;, ESC.
13537  <LI>For special handling of Ctrl-S and Ctrl-Q see special comments regarding
13538 <A HREF="h_special_xon_xoff">&quot;XOFF/XON&quot;</A>.
13539 </OL>
13540
13541 <P>
13542 HINT: To move rapidly to the bottom of a message you are composing,
13543 enter ^W^V.  To go to the top, ^W^Y.  These can be used in conjunction
13544 with the Mark and Cut commands to eliminate large amounts of unwanted
13545 text in a Reply.
13546
13547 <H2>Description of Composer</H2>
13548
13549 Alpine has a built-in editing program that allows you to compose messages
13550 without having to leave Alpine.  The editor is designed to be very simple to
13551 use so that you can get started writing email right away.
13552
13553 <P>
13554 Messages are usually just text, about 80 columns wide.  Using upper and
13555 lower case is encouraged.  On some systems the size limit of the message
13556 is about 100,000 characters, which is about 2,000 lines.  You can include
13557 punctuation and special characters found on most keyboards, but you can't
13558 include characters with diacritical marks and certain special symbols.
13559
13560 <P>
13561 Text automatically wraps as you type past the end of a line so you do not
13562 have to hit return.  Using the
13563 &quot;<A HREF="h_compose_justify">Justify</A>&quot; command,
13564 you can also reformat text explicitly, perhaps after you have
13565 deleted some text.
13566
13567 <P>
13568 You can include other text files with the
13569 &quot;<A HREF="h_compose_readfile">Read File</A>&quot; command,
13570 which will prompt you for the name of the file to insert at the
13571 current cursor postion.
13572
13573 <P>
13574 <UL>
13575 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
13576 </UL>
13577 <P>
13578 &lt;End of help on this topic&gt;
13579 </BODY>
13580 </HTML>
13581 ====== h_composer_browse =====
13582 <HTML>
13583 <HEAD>
13584 <TITLE>BROWSER</TITLE>
13585 </HEAD>
13586 <BODY>
13587 <H1>BROWSER</H1>
13588 This screen lets you browse your files and directories.  To go to another
13589 directory (identified by &quot;(dir)&quot;), move the cursor to it and
13590 choose &quot;Select&quot; (the default choice on the menu);
13591 or choose &quot;Goto&quot; and enter the name of the directory.
13592 <!--chtml if pinemode="os_windows"-->
13593 <!--chtml else-->
13594 In Unix Alpine, you may use
13595 &quot;~&quot; to refer to your home directory or &quot;~user&quot; to refer
13596 to another's home directory.
13597 <!--chtml endif--><P>
13598 To select a file, move the cursor to it and
13599 choose &quot;Select&quot; (the default choice on the menu).
13600 <P>
13601 <UL>
13602 <LI>Note <B>if</B> you are currently using the BROWSER for choosing a file for
13603 inclusion in the
13604 message body (that is, you chose &quot;Read File&quot; with the cursor under
13605 the
13606 &quot;----- Message Text -----&quot; line
13607 while composing, then &quot;To Files&quot;):  Since the file
13608 selected will become part of the message text, it must be in a format
13609 suitable for that (Alpine does not check!), such as a plain text file.
13610 Files of other formats (for example, graphics, databases, software
13611 programs) should be
13612 <B>attached</B> to the message instead --
13613 by moving the cursor in the COMPOSE MESSAGE screen into the
13614 message header area and pressing
13615 <!--chtml if pinemode="function_key"-->
13616 F6.
13617 <!--chtml else-->
13618 Ctrl-J.
13619 <!--chtml endif-->
13620
13621 <P><LI>
13622 Note <B>if</B> you are currently using the BROWSER for saving a message
13623 attachment, or exporting a message, to a file: You can use the Add command to
13624 provide the name for a new file to save/export to, and then select that name
13625 to use it for the save/export operation.  Back at the prompt
13626 &quot;EXPORT: Copy message to file in ...&quot; hit Enter, then choose
13627 either Overwrite or Append (it doesn't make a difference, since the file is
13628 so far empty).  Note: If you cancel the
13629 operation at that point, the file created with the Add command will remain
13630 0 bytes in size.
13631
13632 </UL>
13633 <P><UL>
13634 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
13635 </UL>
13636 <P>
13637 &lt;End of help on this topic&gt;
13638 </BODY>
13639 </HTML>
13640 ====== h_composer_ins =====
13641 <HTML>
13642 <HEAD>
13643 <TITLE>INSERT TEXT FILE</TITLE>
13644 </HEAD>
13645 <BODY>
13646 <H1>INSERT TEXT FILE</H1>
13647
13648 Use this function to insert a text file. The file name
13649 given can be an absolute file path name for your system
13650 <!--chtml if pinemode="os_windows"-->
13651 (for example, &quot;H:&#92;SIGFILES&#92;FULLINFO.TXT&quot;), a file
13652 with a relative pathname, or simply a file name without
13653 drive or directory specification.
13654 <!--chtml else-->
13655 (for example, &quot;/tmp/exported.earlier&quot; on Unix hosts),
13656 a file in your home directory, or a file path relative to your
13657 home directory.  In Unix Alpine, you may use &quot;~&quot; to refer to
13658 your home directory or &quot;~user&quot; to refer to another
13659 account's home directory.
13660 <!--chtml endif-->
13661 <P>
13662 No wild card characters may be used.
13663 The file must reside on the system running Alpine.
13664 <P>
13665 If the
13666 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
13667 feature is set, names are relative to your current working directory
13668 <!--chtml if pinemode="running"-->
13669 (which, at least for your current Alpine &quot;session,&quot;
13670 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
13671 <!--chtml endif-->
13672 rather than your home directory
13673 <!--chtml if pinemode="running"-->
13674 (which, in the present configuration of your system, is
13675  &quot;<!--#echo var="HOME_DIR"-->&quot;)
13676 <!--chtml endif-->
13677 .
13678 <P><UL>
13679 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
13680 </UL>
13681 <P>
13682 &lt;End of help on this topic&gt;
13683 </BODY>
13684 </HTML>
13685 ====== h_composer_ins_m =====
13686 <HTML>
13687 <HEAD>
13688 <TITLE>INSERT MESSAGE</TITLE>
13689 </HEAD>
13690 <BODY>
13691 <H1>INSERT MESSAGE</H1>
13692
13693 Type in the number of a message in the currently open folder to insert it
13694 into your message.
13695 <P><UL>
13696 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
13697 </UL>
13698 <P>
13699 &lt;End of help on this topic&gt;
13700 </BODY>
13701 </HTML>
13702 ====== h_composer_search =====
13703 <HTML>
13704 <HEAD>
13705 <TITLE>Explanation of Composer Whereis Command </TITLE>
13706 </HEAD>
13707 <BODY>
13708 <H1>Help For Whereis Command</H1>
13709
13710 Whereis is used to search the message for a word or part of a word.
13711 When searching in the composer, only the message part of your mail is
13712 searched, and the cursor is put on the first occurrence appearing
13713 after the location of the cursor.  The search will wrap to the
13714 beginning of the message when it no longer finds matches in the
13715 remainder of the message.
13716
13717 To search for the same string a second time, press
13718 <!--chtml if pinemode="function_key"-->
13719 &quot;F6&quot;
13720 <!--chtml else-->
13721 &quot;^W&quot;
13722 <!--chtml endif-->
13723 to begin search and then just press RETURN to accept the previous
13724 search string shown in square brackets rather than entering a new
13725 search string.<P>
13726
13727 The &quot;Search&quot; prompt has several sub-command available:
13728
13729 <DL>
13730 <DT>Get Help</DT>
13731 <DD> Takes you to this help page.
13732
13733 <DT>Cancel</DT>
13734 <DD> Cancels the prompt.  No search takes place.
13735
13736 <DT>First Line</DT>
13737 <DD> Takes you back to the composer with the cursor on the first character
13738 of the first line of text.
13739
13740 <DT>Last Line</DT>
13741 <DD> Takes you back to the composer with the cursor on the last character
13742 of the last line of text.
13743
13744 <DT>Replace (Optional)</DT>
13745 <DD> This sub-command is enabled by the
13746 <A HREF="h_config_enable_search_and_repl">&quot;<!--#echo var="FEAT_enable-search-and-replace"-->&quot;</A>
13747 feature (which is on by default); see its help screen for details on how replacing works.
13748
13749 </DL>
13750
13751 &lt;End of help on this topic&gt;
13752 </BODY>
13753 </HTML>
13754 ====== h_sigedit_search =====
13755 <HTML>
13756 <HEAD>
13757 <TITLE>Explanation of Whereis Command </TITLE>
13758 </HEAD>
13759 <BODY>
13760 <H1>Help For Whereis Command</H1>
13761
13762 Whereis is used to search for a word or part of a word.
13763 When searching the cursor is put on the first occurrence appearing
13764 after the location of the cursor.  The search will wrap to the
13765 beginning of the signature when it no longer finds matches in the
13766 remainder of the signature.
13767
13768 To search for the same string a second time, press
13769 <!--chtml if pinemode="function_key"-->
13770 &quot;F6&quot;
13771 <!--chtml else-->
13772 &quot;^W&quot;
13773 <!--chtml endif-->
13774 to begin search and then just press RETURN to accept the previous
13775 search string shown in square brackets rather than entering a new
13776 search string.<P>
13777
13778 The &quot;Search&quot; prompt has several sub-command available:
13779
13780 <DL>
13781 <DT>Get Help</DT>
13782 <DD> Takes you to this help page.
13783
13784 <DT>Cancel</DT>
13785 <DD> Cancels the prompt.  No search takes place.
13786
13787 <DT>First Line</DT>
13788 <DD> Takes you back to the composer with the cursor on the first character
13789 of the first line of text.
13790
13791 <DT>Last Line</DT>
13792 <DD> Takes you back to the composer with the cursor on the last character
13793 of the last line of text.
13794
13795 <DT>Replace (Optional)</DT>
13796 <DD> This sub-command is enabled by the
13797 <A HREF="h_config_enable_search_and_repl">&quot;<!--#echo var="FEAT_enable-search-and-replace"-->&quot;</A>
13798 feature (which is on by default); see its help screen for details on how replacing works.
13799
13800 </DL>
13801
13802 &lt;End of help on this topic&gt;
13803 </BODY>
13804 </HTML>
13805 ======= h_composer_to ====
13806 <HTML>
13807 <HEAD>
13808 <TITLE>THE MESSAGE COMPOSER'S TO FIELD</TITLE>
13809 </HEAD>
13810 <BODY>
13811 <H1>THE MESSAGE COMPOSER'S TO FIELD</H1>
13812
13813 <H2>The &quot;To:&quot; field</H2>
13814 The address you enter here must be a valid email address that is reachable
13815 from your site.
13816
13817 <H2>Email Address Format</H2>
13818 You may enter a full name and email address,
13819 <!--chtml if pinemode="os_windows"-->
13820 <!--chtml else-->
13821 a local (meaning, on the same
13822 host as the one you are running Alpine on) username that Alpine will
13823 complete for you,
13824 <!--chtml endif-->
13825 the nickname of someone in a
13826 <A HREF="h_abook_opened">Alpine Address Book</A>, or a local
13827 mail alias defined by your system administrator.  When you move the cursor
13828 out of this field, the nicknames will be expanded to the addresses in your
13829 address book, and the local usernames will be expanded to include the
13830 persons' actual names.  You may enter as many addresses as you wish, but they
13831 must be separated by commas.  You can move around this and other header fields
13832 with the arrow keys and use many of the usual composer editing keys.
13833 <P>
13834 <UL>
13835 <LI><A HREF="h_address_format">Explanation of Address formats</A>
13836 </UL>
13837
13838 <P>
13839 <H2>MESSAGE HEADER COMMANDS</H2>
13840 <!--chtml if pinemode="function_key"-->
13841 CURSOR&nbsp;MOTION&nbsp;KEYS----------------------|EDITING&nbsp;KEYS-------------------------<BR>
13842 ^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>
13843 ^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>
13844 ^P&nbsp;(Up&nbsp;Arrow)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Previous&nbsp;line&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|<BR>
13845 ^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>
13846 ^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>
13847 ^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>
13848 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>
13849 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>
13850 ^@&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>
13851 ----------------------------------------|<BR>
13852 MESSAGE&nbsp;COMMANDS&nbsp;&nbsp;|&nbsp;GENERAL&nbsp;COMMANDS&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;F12&nbsp;&nbsp;&nbsp;&nbsp;To&nbsp;Addressbook/Browser<BR>
13853 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>
13854 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>
13855 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>
13856 <!--chtml else-->
13857 CURSOR&nbsp;MOTION&nbsp;KEYS----------------------|EDITING&nbsp;KEYS-------------------------<BR>
13858 ^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>
13859 ^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>
13860 ^P&nbsp;(Up&nbsp;Arrow)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Previous&nbsp;line&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;<BR>
13861 ^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>
13862 ^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>
13863 ^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>
13864 ^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>
13865 ^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>
13866 ^@&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>
13867 ----------------------------------------|&nbsp;^R&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="h_compose_richhdr">Rich&nbsp;Headers</A><BR>
13868 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>
13869 ^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>
13870 ^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>
13871 ^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>
13872 <!--chtml endif-->
13873
13874 <P>
13875 NOTE:
13876 <OL>
13877  <LI>For help on a particular command, highlight the bold text associated
13878 with it above and hit Return.
13879  <LI> The availability of certain commands
13880 is determined by Alpine configuration files and system capabilities.
13881 At some sites, certain commands may not be available due to security or
13882 support concerns.
13883 </OL>
13884
13885 <P>
13886 <UL>
13887 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
13888 </UL><P>
13889 &lt;End of help on this topic&gt;
13890 </BODY>
13891 </HTML>
13892 ======= h_composer_cc ====
13893 <HTML>
13894 <HEAD>
13895 <TITLE>THE MESSAGE COMPOSER'S CC FIELD</TITLE>
13896 </HEAD>
13897 <BODY>
13898 <H1>THE MESSAGE COMPOSER'S CC FIELD</H1>
13899 The Cc: field is just like the To: field, except it is used for addressees
13900 that you wish to send a &quot;carbon&quot; copy to.  That is, the message is
13901 not directly meant directly &quot;for&quot; these recipients, but you wanted
13902 them to see the message.  The only difference the recipients see is that their
13903 name is in the Cc: field, rather than the To: field.
13904 <P>
13905 For help with Cc: field editing
13906 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
13907 <P>
13908 <UL>
13909 <LI><A HREF="h_address_format">Explanation of Address formats</A>
13910 </UL>
13911 <P>
13912 <UL>
13913 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
13914 </UL><P>
13915 &lt;End of help on this topic&gt;
13916 </BODY>
13917 </HTML>
13918 ======= h_composer_bcc ====
13919 <HTML>
13920 <HEAD>
13921 <TITLE>THE MESSAGE COMPOSER'S BCC FIELD</TITLE>
13922 </HEAD>
13923 <BODY>
13924 <H1>THE MESSAGE COMPOSER'S BCC FIELD</H1>
13925 The &quot;Bcc:&quot; (Blind carbon copy) header is used when you wish to send
13926 a copy of the message to one or more people whose addresses you do not
13927 wish disclosed, either to reduce clutter or for confidentiality.
13928 <P>
13929 The format of the Bcc: field is just the same as the To: and Cc: fields in
13930 the way the addresses are entered.  The recipients listed here will
13931 receive a copy of the message, but --assuming your site's mail transport
13932 software is properly configured-- their addresses will not show up in the
13933 headers of the message, as delivered to all of the recipients.  The To:
13934 and Cc:  recipients will not know a copy was sent to the Bcc: recipients.
13935 <P>
13936 Note: if there is no To: or Cc: or Lcc: address in the message, Alpine
13937 will automatically generate and place in the To: field a pseudo-address of
13938   &quot;undisclosed-recipients: ;&quot;
13939 or whatever string has been specified in the
13940 <A HREF="h_config_empty_hdr_msg">&quot;<!--#echo var="VAR_empty-header-message"-->&quot;</A>
13941 variable.
13942 <P>
13943 The reason for this is to avoid embarrassment caused by some Internet
13944 mail transfer software that interprets a &quot;missing&quot; To: header as
13945 an error and replaces it with an Apparently-to: header that may contain
13946 the addresses you entered on the Bcc: line.  In addition, it may be
13947 less disconcerting to Bcc: recipients to see <B>something</B> in the To: field.
13948 <P>
13949 You can manipulate what text ends up on the (originally) empty To:
13950 field.  Just remember to put a colon and semicolon at the end of the
13951 field, which is a special notation denoting that it is not a real address.
13952 <P>
13953 For information on message header editing
13954 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
13955 <P>
13956 <UL>
13957 <LI><A HREF="h_address_format">Explanation of Address formats</A>
13958 </UL>
13959 <P>
13960 <UL>
13961 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
13962 </UL><P>
13963 &lt;End of help on this topic&gt;
13964 </BODY>
13965 </HTML>
13966 ======= h_composer_lcc ====
13967 <HTML>
13968 <HEAD>
13969 <TITLE>THE MESSAGE COMPOSER'S LCC FIELD</TITLE>
13970 </HEAD>
13971 <BODY>
13972 <H1>THE MESSAGE COMPOSER'S LCC FIELD</H1>
13973 The &quot;Lcc:&quot; (List carbon copy) header is intended to be used when
13974 you wish to send a message to a list of people but avoid having all
13975 of their addresses visible, in order to reduce clutter when the
13976 message is received.
13977 <P>
13978 It is similar to the
13979 <A HREF="h_composer_bcc">&quot;Bcc&quot; (Blind carbon copy) header</A>
13980 in that individual
13981 addressees are hidden, but Lcc is designed to work specifically with
13982 distribution lists you have created in your
13983 <A HREF="h_abook_opened">Alpine Address Book</A>.  Placing
13984 the nickname of the list on the Lcc line will result in the full name of
13985 your Alpine Address Book list being placed on the To: line of the message,
13986 using a special notation that distinguishes it from a real address. You
13987 must leave the To: line blank for your list name to appear there.
13988 <P>
13989 For example, if you have this list entered in your Address Book:<PRE>
13990
13991         largo         Key Largo List       DISTRIBUTION LIST:
13992                                            bogie@mgm.com
13993                                            lauren@mgm.com
13994                                            walter@mgm.com</PRE>
13995
13996
13997 and you enter &quot;largo&quot; on the Lcc: line while composing a message,
13998 the result is:<PRE>
13999
14000         To      : Key Largo List: ;
14001         Cc      :
14002         Bcc     :
14003         Fcc     : sent-mail
14004         Lcc     : Key Largo List &lt;bogie@mgm.com&gt;,
14005                   lauren@mgm.com,
14006                   walter@mgm.com
14007         Subject :</PRE>
14008
14009 Each recipient listed on the Lcc: line receives a copy of the message
14010 without their address being visible (as though they were listed on the
14011 Bcc: line). The colon-semicolon notation used to put the full-name of the
14012 list on the To: line is a special address format that doesn't specify any
14013 actual addressees, but does give some information to the recipients of the
14014 message.
14015 <P>
14016 Note: if after entering an LCC, you delete the list name that is placed
14017 on the To: line, then recipients will see <PRE>
14018        To: undisclosed-recipients: ;</PRE>
14019
14020 (or whatever string is defined in the
14021 <A HREF="h_config_empty_hdr_msg">&quot;<!--#echo var="VAR_empty-header-message"-->&quot;</A>
14022 variable) just as in the BCC case.
14023 <P>
14024 For help with Lcc: field editing
14025 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
14026 <P>
14027 <UL>
14028 <LI><A HREF="h_address_format">Explanation of Address formats</A>
14029 </UL>
14030 <P>
14031 <UL>
14032 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14033 </UL><P>
14034 &lt;End of help on this topic&gt;
14035 </BODY>
14036 </HTML>
14037 ======= h_composer_from =======
14038 <HTML>
14039 <HEAD>
14040 <TITLE>THE MESSAGE COMPOSER'S FROM FIELD</TITLE>
14041 </HEAD>
14042 <BODY>
14043 <H1>THE MESSAGE COMPOSER'S FROM FIELD</H1>
14044
14045 This header carries your return address.  It is the address toward which
14046 replies (and often, future unrelated correspondence) will be directed,
14047 unless you have <A HREF="h_config_custom_hdrs">defined an optional
14048 &quot;Reply-To:&quot; header</A> in the SETUP CONFIGURATION screen.  Make
14049 sure this address is correct.
14050 <P>
14051 For help with message header editing
14052 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
14053 <P>
14054 <UL>
14055 <LI><A HREF="h_address_format">Explanation of Address formats</A>
14056 </UL>
14057 <P>
14058 <UL>
14059 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14060 </UL><P>
14061 &lt;End of help on this topic&gt;
14062 </BODY>
14063 </HTML>
14064 ======= h_composer_reply_to =======
14065 <HTML>
14066 <HEAD>
14067 <TITLE>THE MESSAGE COMPOSER'S REPLY-TO FIELD</TITLE>
14068 </HEAD>
14069 <BODY>
14070 <H1>THE MESSAGE COMPOSER'S REPLY-TO FIELD</H1>
14071
14072 Most people should not need this header. The Reply-To: header is used in
14073 cases where you would like replies to your messages to be directed to an
14074 address other than your normal &quot;From:&quot; address.  This is atypical,
14075 but can happen when you use multiple machines and do not have the same account
14076 name on each one, or when you wish to direct certain replies to accounts
14077 or folders designated for specific classes of correspondence.
14078 <P>
14079 For help with message header editing
14080 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
14081 <P>
14082 <UL>
14083 <LI><A HREF="h_address_format">Explanation of Address formats</A>
14084 </UL>
14085
14086 <P>
14087 <UL>
14088 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14089 </UL><P>
14090 &lt;End of help on this topic&gt;
14091 </BODY>
14092 </HTML>
14093 ======= h_composer_custom_addr ====
14094 <HTML>
14095 <HEAD>
14096 <TITLE>CUSTOMIZED HEADER FIELD</TITLE>
14097 </HEAD>
14098 <BODY>
14099 <H1>CUSTOMIZED HEADER FIELD</H1>
14100 This is a customized header, i.e. not one that is part of Alpine's normal
14101 set of Compose headers.
14102 <P>
14103 For help with message header editing
14104 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
14105 <P>
14106 <UL>
14107 <LI><A HREF="h_address_format">Explanation of Address formats</A>
14108 </UL>
14109 <P>
14110 <UL>
14111 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14112 </UL><P>
14113 &lt;End of help on this topic&gt;
14114 </BODY>
14115 </HTML>
14116 ======= h_composer_custom_free ====
14117 <HTML>
14118 <HEAD>
14119 <TITLE>CUSTOMIZED HEADER FIELD</TITLE>
14120 </HEAD>
14121 <BODY>
14122 <H1>CUSTOMIZED HEADER FIELD</H1>
14123 This is a customized header, i.e. not one that is part of Alpine's normal
14124 set of Compose headers.
14125 <P>
14126 This field consists of arbitrary text.
14127 <P>
14128 For help with message header editing
14129 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
14130 <P>
14131 <UL>
14132 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14133 </UL><P>
14134 &lt;End of help on this topic&gt;
14135 </BODY>
14136 </HTML>
14137 ====== h_composer_news =====
14138 <HTML>
14139 <HEAD>
14140 <TITLE>THE MESSAGE COMPOSER'S NEWSGRPS LINE</TITLE>
14141 </HEAD>
14142 <BODY>
14143 <h1>THE MESSAGE COMPOSER'S NEWSGRPS LINE</h1>
14144 Use the newsgroups line to specify any and all USENET newsgroups to which
14145 your message should be posted.  When composing a message from scratch, this
14146 line may be hidden.  If so, just press the rich headers command
14147 (<!--chtml if pinemode="function_key"-->F5<!--chtml else-->^R<!--chtml endif-->)
14148 to make it visible.
14149 <P>
14150 <EM>Be aware</EM> that when you post to a newsgroup thousands of
14151 people will be reading your message.  Also, you or your system manager
14152 must have defined an &quot;<!--#echo var="VAR_nntp-server"-->&quot; in your Alpine configuration
14153 in order for you to be able to post.
14154 <P>
14155 For help with message header editing
14156 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
14157 <P><UL>
14158 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14159 </UL>
14160 <P>
14161 &lt;End of help on this topic&gt;
14162 </BODY>
14163 </HTML>
14164 ======= h_composer_fcc ====
14165 <HTML>
14166 <HEADER>
14167 <TITLE>THE MESSAGE COMPOSER'S FCC FIELD</TITLE>
14168 </HEADER>
14169 <BODY>
14170 <H1>THE MESSAGE COMPOSER'S FCC FIELD</H1>
14171 The FCC (File Carbon Copy) specifies the folder used to keep a copy of
14172 each outgoing message.  The default value can be configured with the
14173 &quot;<!--#echo var="VAR_default-fcc"-->&quot; and &quot;<!--#echo var="VAR_fcc-name-rule"-->&quot; options.  You can change or remove
14174 the file carbon copy on any message you send by editing the FCC header.<p>
14175
14176 You may type ^T to get a list of all your folders and select one to use as
14177 the FCC for this message.<P>
14178
14179 For help with message header editing
14180 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
14181 <P>
14182 <UL>
14183 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14184 </UL><P>
14185 &lt;End of help on this topic&gt;
14186 </BODY>
14187 </HTML>
14188 ======= h_composer_subject ====
14189 <HTML>
14190 <HEADER>
14191 <TITLE>THE MESSAGE COMPOSER'S SUBJECT FIELD</TITLE>
14192 </HEADER>
14193 <BODY>
14194 <H1>THE MESSAGE COMPOSER'S SUBJECT FIELD</H1>
14195
14196 The subject header provides a place to enter a few words that summarize
14197 the topic of the message you are sending.  You may leave this line blank,
14198 but it is considered a courtesy to use a meaningful subject.<p>
14199
14200 For help with message header editing
14201 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
14202 <P>
14203 <UL>
14204 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14205 </UL><P>
14206 &lt;End of help on this topic&gt;
14207 </BODY>
14208 </HTML>
14209 ======= h_composer_attachment ====
14210 <HTML>
14211 <HEAD>
14212 <TITLE>THE MESSAGE COMPOSER'S ATTCHMNT FIELD</TITLE>
14213 </HEAD>
14214 <BODY>
14215 <H1>THE MESSAGE COMPOSER'S ATTCHMNT FIELD</H1>
14216
14217 The &quot;Attchmnt:&quot; field is where you specify what file or
14218 files you'd like attached to
14219 the message you are composing.  Those files must reside on the machine
14220 running Alpine. If your file is on a PC or Mac and you run Alpine with an
14221 account on a Unix machine, you'll have to transfer it before attaching it.
14222 Contact local computer support people for assistance with transferring.
14223
14224 <P>
14225 The file name
14226 given can be an absolute file path name for your system
14227 <!--chtml if pinemode="os_windows"-->
14228 (for example, &quot;H:&#92;SIGFILES&#92;FULLINFO.TXT&quot;), a file
14229 with a relative pathname, or simply a file name without
14230 drive or directory specification.
14231 <!--chtml else-->
14232 (for example, &quot;/tmp/exported.earlier&quot; on Unix hosts),
14233 a file in your home directory, or a file path relative to your
14234 home directory.  In Unix Alpine, you may use &quot;~&quot; to refer to
14235 your home directory or &quot;~user&quot; to refer to another
14236 account's home directory.
14237 <!--chtml endif--><P>
14238 No wild card characters may be used.
14239 <P>If the
14240 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
14241 feature is set, names are relative to your current working directory
14242 <!--chtml if pinemode="running"-->
14243 (which, at least for your current Alpine &quot;session,&quot;
14244 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
14245 <!--chtml endif-->
14246 rather than your home directory
14247 <!--chtml if pinemode="running"-->
14248 (which, in the present configuration of your system, is
14249  &quot;<!--#echo var="HOME_DIR"-->&quot;)
14250 <!--chtml endif-->
14251 .
14252 <P>
14253 Alpine uses MIME encoding for attachments, so binaries and files of any
14254 length can safely be delivered to any MIME-capable mail reading program.
14255 If you send an attachment to someone who does not have a MIME-capable mail
14256 reading program yet, then the main message text will be readable, but
14257 attachments (even attachments that are just plain text) are not.
14258 <P>
14259
14260 Typing the filename on the Attchmnt: line achieves the same
14261 result as using the
14262 <!--chtml if pinemode="function_key"-->
14263 F6
14264 <!--chtml else-->
14265 Ctrl-J
14266 <!--chtml endif--> command.
14267 <P>
14268
14269 If you Forward a message with attachments, you may delete them from your
14270 Forwarded message by editing the Attchmnt header line.
14271 <P>
14272
14273 For help with message header editing
14274 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
14275 <P>
14276 <UL>
14277 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14278 </UL><P>
14279 &lt;End of help on this topic&gt;
14280 </BODY>
14281 </HTML>
14282 ======= h_composer_ctrl_j ====
14283 <HTML>
14284 <HEAD>
14285 <TITLE>COMPOSER ATTACH</TITLE>
14286 </HEAD>
14287 <BODY>
14288 After the
14289 <!--chtml if pinemode="function_key"-->
14290 F6
14291 <!--chtml else-->
14292 Ctrl-J
14293 <!--chtml endif--> command:
14294 At the &quot;File to attach:&quot; prompt, enter the name of the
14295 existing file to attach to your message.
14296 When the feature
14297 <A HREF="h_config_enable_tab_complete">&quot;<!--#echo var="FEAT_enable-tab-completion"-->&quot;</A>
14298 is set
14299 you need only enter the beginning of the filename (enough of it to uniquely
14300 identify the file) and press TAB to complete it.
14301
14302 Or, press ^T to use the BROWSER screen for
14303 selecting the file.  <P>
14304 For more information on attaching files, see the help screen for the
14305 composer's
14306 <A HREF="h_composer_attachment">Attchmnt: field</A>, which is normally hidden,
14307 but can be revealed using the
14308 <!--chtml if pinemode="function_key"-->
14309 F5
14310 <!--chtml else-->
14311 Ctrl-R
14312 <!--chtml endif-->
14313 command with the cursor positioned above the
14314 &quot;----- Message Text -----&quot; line in the COMPOSE MESSAGE screen.
14315 <P>
14316 &lt;End of help on this topic&gt;
14317 </BODY>
14318 </HTML>
14319 ======= h_edit_nav_cmds =========
14320 <HTML>
14321 <HEAD>
14322 <TITLE>Composer Editing Commands Explained</TITLE>
14323 </HEAD>
14324 <BODY>
14325 <H1>EDITING and NAVIGATION COMMANDS</H1>
14326 <!--chtml if pinemode="function_key"-->
14327 <PRE>
14328 CURSOR MOTION KEYS----------------------|EDITING KEYS-------------------------
14329 ^B (Left Arrow)    Back character       | ^D       Delete current character
14330 ^F (Right Arrow)   Forward character    | ^H (DEL) Delete previous character
14331 ^P (Up Arrow)      Previous line        |
14332 ^N (Down Arrow)    Next line            | F9       Cut marked text or
14333 ^A                 Beginning of line    |            delete current line
14334 ^E                 End of line          | F10      Undelete line(s)
14335 F7                 Previous page        |
14336 F8                 Next page            |-------------------------------------
14337 ^@ (Ctrl-SPACE)    Next word            | MISCELLANEOUS COMMANDS
14338 ----------------------------------------|
14339 EXIT COMMANDS    |  GENERAL COMMANDS    | F12    To Addressbook
14340 F3   Cancel      |   F1    Get help     | F12    RichView (expand lists)
14341 F2  eXit/save    |   ^Z    Suspend      | ^L     Redraw Screen
14342 </PRE>
14343 <!--chtml else-->
14344 <PRE>
14345 CURSOR MOTION KEYS----------------------|EDITING KEYS-------------------------
14346 ^B (Left Arrow)    Back character       | ^D       Delete current character
14347 ^F (Right Arrow)   Forward character    | ^H (DEL) Delete previous character
14348 ^P (Up Arrow)      Previous line        |
14349 ^N (Down Arrow)    Next line            | ^K       Cut marked text or
14350 ^A                 Beginning of line    |            delete current line
14351 ^E                 End of line          | ^U       Undelete line(s)
14352 ^Y                 Previous page        |
14353 ^V                 Next page            |-------------------------------------
14354 ^@ (Ctrl-SPACE)    Next word            | MISCELLANEOUS COMMANDS
14355 ----------------------------------------|
14356 EXIT COMMANDS    |  GENERAL COMMANDS    | ^T     To Addressbook
14357 ^C   Cancel      |   ^G    Get help     | ^R     RichView  (expand lists)
14358 ^X   eXit/save   |   ^Z    Suspend      | ^L     Redraw Screen
14359 </PRE>
14360 <!--chtml endif-->
14361 &lt;End of help on this topic&gt;
14362 </BODY>
14363 </HTML>
14364 ===== h_composer_sigedit =====
14365 <HTML>
14366 <HEAD>
14367 <TITLE>Signature Editor Commands Explained</TITLE>
14368 </HEAD>
14369 <BODY>
14370 <H1>SIGNATURE EDITOR COMMANDS</H1>
14371 <!--chtml if pinemode="function_key"-->
14372 <PRE>
14373 CURSOR MOTION KEYS                     |EDITING KEYS
14374   ^B (Left Arrow)   Back character     | ^D       Delete current character
14375   ^F (Right Arrow)  Forward character  | ^H (DEL) Delete previous character
14376   ^P (Up Arrow)     Previous line      | ^^       Set a mark
14377   ^N (Down Arrow)   Next line          | F9       Cut marked text or
14378   ^A                Beginning of line  |           delete current line
14379   ^E                End of line        | F10       Paste text, undelete lines
14380   F7                Previous page      |           cut with ^K, or unjustify
14381   F8                Next page          |-------------------------------------
14382   ^@ (Ctrl-SPACE)   Next word          |SCREEN/COMPOSITION COMMANDS
14383 ---------------------------------------| F6       Whereis (search for string)
14384 MESSAGE COMMANDS | GENERAL COMMANDS    | F12      Spell checker
14385  F3   Cancel     |  F1    Get help     | F4       Justify paragraph
14386                  |  ^Z    Suspend      | ^L       Redraw Screen
14387  F2   Send       |  F6    Alt. editor  | F5       Read in a file
14388 </PRE>
14389 <!--chtml else-->
14390 <PRE>
14391 CURSOR MOTION KEYS                     |EDITING KEYS
14392   ^B (Left Arrow)   Back character     | ^D       Delete current character
14393   ^F (Right Arrow)  Forward character  | ^H (DEL) Delete previous character
14394   ^P (Up Arrow)     Previous line      | ^^       Set a mark
14395   ^N (Down Arrow)   Next line          | ^K       Cut marked text or
14396   ^A                Beginning of line  |           delete current line
14397   ^E                End of line        | ^U        Paste text, undelete lines
14398   ^Y                Previous page      |           cut with ^K, or unjustify
14399   ^V                Next page          |-------------------------------------
14400   ^@ (Ctrl-SPACE)   Next word          |SCREEN/COMPOSITION COMMANDS
14401 ---------------------------------------| ^W       <A HREF="h_composer_search">Whereis</A> (search text)
14402 MESSAGE COMMANDS | GENERAL COMMANDS    | ^T       Spell checker
14403  ^C   Cancel     |  ^G    Get help     | ^J       <A HREF="h_compose_justify">Justify</A> paragraph
14404                  |  ^Z    <A HREF="h_common_suspend">Suspend</A>      | ^L       Redraw Screen
14405  ^X   Send       |  ^_    Alt. editor  | ^R       Read in a file
14406 </PRE>
14407 <!--chtml endif-->
14408
14409 NOTE: The presence or absence of the following commands is determined
14410 by &quot;Feature-List&quot; options in your Alpine configuration.  Also,
14411 some of these commands may be administratively disabled by your system
14412 manager; if they don't work, please check with your local help desk
14413 before reporting a bug.
14414 <P>
14415 <UL>
14416  <LI>Suspend (suspends Alpine and gives a system prompt)
14417  <LI>Alternate editor (allows you to compose with your own editor)
14418 </UL>
14419 <P>
14420
14421 Alpine does not use the following keys:  Ctrl-S, Ctrl-Q, Ctrl-],
14422 Ctrl-&#92;, ESC
14423 <P>
14424
14425 NOTE: For special handling of Ctrl-S and Ctrl-Q see special comments regarding
14426 <A HREF="h_special_xon_xoff">&quot;XOFF/XON&quot;</A>.
14427 <P>
14428 &lt;End of help on this topic&gt;
14429 </BODY>
14430 </HTML>
14431 ===== h_composer_commentedit =====
14432 <HTML>
14433 <HEAD>
14434 <TITLE>Comment Editor Commands Explained</TITLE>
14435 </HEAD>
14436 <BODY>
14437 <H1>COMMENT EDITOR COMMANDS</H1>
14438 <!--chtml if pinemode="function_key"-->
14439 <PRE>
14440 CURSOR MOTION KEYS                     |EDITING KEYS
14441   ^B (Left Arrow)   Back character     | ^D       Delete current character
14442   ^F (Right Arrow)  Forward character  | ^H (DEL) Delete previous character
14443   ^P (Up Arrow)     Previous line      | ^^       Set a mark
14444   ^N (Down Arrow)   Next line          | F9       Cut marked text or
14445   ^A                Beginning of line  |           delete current line
14446   ^E                End of line        | F10       Paste text, undelete lines
14447   F7                Previous page      |           cut with ^K, or unjustify
14448   F8                Next page          |-------------------------------------
14449   ^@ (Ctrl-SPACE)   Next word          |SCREEN/COMPOSITION COMMANDS
14450 ---------------------------------------| F6       Whereis (search for string)
14451 MESSAGE COMMANDS | GENERAL COMMANDS    | F12      Spell checker
14452  F3   Cancel     |  F1    Get help     | F4       Justify paragraph
14453                  |  ^Z    Suspend      | ^L       Redraw Screen
14454  F2   Send       |  F6    Alt. editor  | F5       Read in a file
14455 </PRE>
14456 <!--chtml else-->
14457 <PRE>
14458 CURSOR MOTION KEYS                     |EDITING KEYS
14459   ^B (Left Arrow)   Back character     | ^D       Delete current character
14460   ^F (Right Arrow)  Forward character  | ^H (DEL) Delete previous character
14461   ^P (Up Arrow)     Previous line      | ^^       Set a mark
14462   ^N (Down Arrow)   Next line          | ^K       Cut marked text or
14463   ^A                Beginning of line  |           delete current line
14464   ^E                End of line        | ^U        Paste text, undelete lines
14465   ^Y                Previous page      |           cut with ^K, or unjustify
14466   ^V                Next page          |-------------------------------------
14467   ^@ (Ctrl-SPACE)   Next word          |SCREEN/COMPOSITION COMMANDS
14468 ---------------------------------------| ^W       <A HREF="h_composer_search">Whereis</A> (search text)
14469 MESSAGE COMMANDS | GENERAL COMMANDS    | ^T       Spell checker
14470  ^C   Cancel     |  ^G    Get help     | ^J       <A HREF="h_compose_justify">Justify</A> paragraph
14471                  |  ^Z    <A HREF="h_common_suspend">Suspend</A>      | ^L       Redraw Screen
14472  ^X   Send       |  ^_    Alt. editor  | ^R       Read in a file
14473 </PRE>
14474 <!--chtml endif-->
14475
14476 NOTE: The presence or absence of the following commands is determined
14477 by &quot;Feature-List&quot; options in your Alpine configuration.  Also,
14478 some of these commands may be administratively disabled by your system
14479 manager; if they don't work, please check with your local help desk
14480 before reporting a bug.
14481 <P>
14482 <UL>
14483  <LI>Suspend (suspends Alpine and gives a system prompt)
14484  <LI>Alternate editor (allows you to compose with your own editor)
14485 </UL>
14486 <P>
14487
14488 Alpine does not use the following keys:  Ctrl-S, Ctrl-Q, Ctrl-],
14489 Ctrl-&#92;, ESC
14490 <P>
14491
14492 NOTE: For special handling of Ctrl-S and Ctrl-Q see special comments regarding
14493 <A HREF="h_special_xon_xoff">&quot;XOFF/XON&quot;</A>.
14494 <P>
14495 &lt;End of help on this topic&gt;
14496 </BODY>
14497 </HTML>
14498 ======= h_composer_abook_nick =======
14499 <HTML>
14500 <HEAD>
14501 <TITLE>Addressbook Nickname Explained</TITLE>
14502 </HEAD>
14503 <BODY>
14504 This is a short nickname for this address book entry.  If it is used in
14505 place of an address from the composer, the composer will fill in the
14506 address(es) for the entry that matches the nickname.
14507 <P>
14508
14509 Look <A HREF="h_edit_nav_cmds">here</A>
14510 to see the available Editing and Navigation commands.
14511 <P>
14512 &lt;End of help on this topic&gt;
14513 </BODY>
14514 </HTML>
14515 ======= h_composer_abook_full =======
14516 <HTML>
14517 <HEAD>
14518 <TITLE>Addressbook Fullname Explained</TITLE>
14519 </HEAD>
14520 <BODY>
14521 This is the full name field for this entry.  If this is going to be a
14522 distribution list (more than one address), it should be a descriptive
14523 phrase describing the list.  It will be included in the mail header if you
14524 put the list in the To: or CC: field, or in the To: line if you put the
14525 list in the Lcc: field.  It's OK to leave this field blank (and OK to
14526 leave any of the other fields blank, too). If this address book entry is
14527 going to be a simple entry with just one address, then this field is the
14528 person's name. When you send mail to this entry, this is the field to the
14529 left of the brackets. That is, it is the most readable part of the
14530 address. For example, in the sample address:
14531 <PRE>
14532        John Doe &lt;jdoe@some.domain&gt;
14533 </PRE>
14534 "John Doe" is the full name field. If you are sorting your address book
14535 with one of the options that uses full names, then it might be useful to
14536 enter the full name as "Last, First", for example:
14537 <PRE>
14538        Doe, John
14539 </PRE>
14540 so that it will be sorted using Doe instead of John. This will be changed
14541 back into John Doe when you use it.
14542 <P>
14543 Look <A HREF="h_edit_nav_cmds">here</A>
14544 to see the available Editing and Navigation commands.
14545 <P>
14546 &lt;End of help on this topic&gt;
14547 </BODY>
14548 </HTML>
14549 ======= h_composer_abook_fcc =======
14550 <HTML>
14551 <HEAD>
14552 <TITLE>Addressbook Fcc Explained</TITLE>
14553 </HEAD>
14554 <BODY>
14555 If this entry is the first one in the To: line of an outgoing message,
14556 this field will be used for the Fcc (File Carbon Copy) instead of whatever
14557 you would normally get (which depends on which
14558 <A HREF="h_config_saved_msg_name_rule">&quot;<!--#echo var="VAR_saved-msg-name-rule"-->&quot;</A>
14559 you've chosen).
14560 <P>
14561 If this field consists of two double quotes (&quot;&quot;) that tells Alpine
14562 that you don't want any Fcc associated with this entry.
14563 <P>
14564 Look <A HREF="h_edit_nav_cmds">here</A>
14565 to see the available Editing and Navigation commands.
14566 <P>
14567 &lt;End of help on this topic&gt;
14568 </BODY>
14569 </HTML>
14570 ====== h_config_combined_abook_display =====
14571 <HTML>
14572 <HEAD>
14573 <TITLE>FEATURE: <!--#echo var="FEAT_combined-addrbook-display"--></TITLE>
14574 </HEAD>
14575 <BODY>
14576 <H1>FEATURE: <!--#echo var="FEAT_combined-addrbook-display"--></H1>
14577
14578 This feature affects the address book display screens.
14579 Normally, expanding an address book from the ADDRESS BOOK LIST screen
14580 will cause the remaining address books and directory servers to disappear
14581 from the screen, leaving only the entries of the expanded address book.
14582 If this feature is set, then the other address books will remain on the screen,
14583 so that all of the address books can be present at once.
14584
14585 <P>
14586 The way that commands work won't be changed.
14587 For example, the Select All command will select all of the entries in the
14588 current address book, not all of the entries in all of the address books.
14589 The WhereIs command will change a little.
14590 It will search through all of the text on the screen plus all of the entries
14591 from expanded address books.
14592
14593 <P>
14594 When this feature is set, the setting of the feature
14595 <A HREF="h_config_expanded_addrbooks">&quot;<!--#echo var="FEAT_expanded-view-of-addressbooks"-->&quot;</A>
14596 has an effect.
14597 <P>
14598 &lt;End of help on this topic&gt;
14599 </BODY>
14600 </HTML>
14601 ====== h_config_titlebar_color_style =====
14602 <HTML>
14603 <HEAD>
14604 <TITLE>OPTION: <!--#echo var="VAR_titlebar-color-style"--></TITLE>
14605 </HEAD>
14606 <BODY>
14607 <H1>OPTION: <!--#echo var="VAR_titlebar-color-style"--></H1>
14608
14609 This option affects the colors used to display the titlebar (the top
14610 line on the screen) when viewing a message.
14611
14612 <P>
14613 The available options include:
14614 <P>
14615
14616 <DL>
14617 <DT>default</DT>
14618 <DD>The color of the titlebar will be the color you set for the
14619 <A HREF="h_config_title_color">Title Color</A>.
14620 The Title Color may be set by using the
14621 <A HREF="h_color_setup">Setup Kolor</A> screen.
14622 </DD>
14623
14624 <DT>indexline</DT>
14625 <DD>The color of the titlebar will be the same as the color of the
14626 index line corresponding to the message being viewed.
14627 The rules that determine what color the index line will be may be set
14628 up by going to the Setup/Rules/Indexcolor screen.
14629 If the index line for a message is not colored explicitly by the
14630 Indexcolor rules, then the titlebar will be colored the same as for
14631 the &quot;default&quot; option above (which is not the same color that
14632 the index line itself will have).
14633 </DD>
14634
14635 <DT>reverse-indexline</DT>
14636 <DD>This is similar to the &quot;indexline&quot; option except the
14637 foreground and background colors from the corresponding index line will
14638 be reversed.
14639 For example, if the index line color is red letters on a white background,
14640 then the titlebar will be white letters on a red background.
14641 If the index line for a message is not colored explicitly by the
14642 Indexcolor rules, then the titlebar will be colored the same as for
14643 the &quot;default&quot; option above (which is not the same color that
14644 the index line itself will have).
14645 </DD>
14646 </DL>
14647
14648 <P>
14649
14650 <UL>
14651 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14652 </UL><P>
14653 &lt;End of help on this topic&gt;
14654 </BODY>
14655 </HTML>
14656 ====== h_config_index_color_style =====
14657 <HTML>
14658 <HEAD>
14659 <TITLE>OPTION: <!--#echo var="VAR_current-indexline-style"--></TITLE>
14660 </HEAD>
14661 <BODY>
14662 <H1>OPTION: <!--#echo var="VAR_current-indexline-style"--></H1>
14663
14664 This option affects the colors used to display the current line in the
14665 MESSAGE INDEX screen.
14666 If you do not have Index Color Rules defined, then this option will
14667 have no effect in the index.
14668 Those Rules may be defined by going to the Setup/Rules/Indexcolor screen.
14669 <P>
14670 If the option
14671 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
14672 is turned on and the
14673 <A HREF="h_config_incunseen_color">Incoming Unseen Color</A>
14674 is set to something other than the default, then
14675 this option also affects the color used to display the current folder
14676 in the Incoming FOLDER LIST screen.
14677
14678 <P>
14679 The available options include:
14680 <P>
14681
14682 <DL>
14683 <DT>flip-colors</DT>
14684 <DD>This is the default.
14685 If an index line is colored because it matches one of your
14686 Index Color Rules, then its colors will be reversed when it is the currently
14687 highlighted line.
14688 For example, if the line is normally red text on a blue background, then
14689 when it is the current line it will be drawn as blue text on a red background.
14690 <P>
14691 The rest of the option values all revert to this flip-colors behavior if
14692 there is no Reverse Color defined.
14693 </DD>
14694
14695 <DT>reverse</DT>
14696 <DD>With this option the Reverse color is always used to highlight the
14697 current line.
14698 </DD>
14699
14700 <DT>reverse-fg</DT>
14701 <DD>The foreground part of the Reverse Color is used to highlight
14702 the current line.
14703 If this would cause the text to be unreadable (because the foreground and
14704 background colors are the same) or if it would cause no change in the
14705 color of the index line, then the colors are flipped instead.
14706 <P>
14707 Some people think this works particularly well if you use different
14708 background colors to emphasize &quot;interesting&quot; lines,
14709 but always with the same Normal foreground color,
14710 and you use a different foreground color for the Reverse Color.
14711 </DD>
14712
14713 <DT>reverse-fg-no-ambiguity</DT>
14714 <DD>With the &quot;reverse-fg&quot; rule above, it is possible that
14715 the resulting color will be exactly the same as the regular Reverse
14716 Color.
14717 That can lead to some possible confusion because an
14718 &quot;interesting&quot;
14719 line that is the current line will be displayed exactly the same as a
14720 non-interesting line that is current.
14721 You can't tell whether the line is just a regular current line or if it is
14722 an &quot;interesting&quot; current line by looking at the color.
14723 Setting the option to this value removes that ambiguity.
14724 It is the same as the &quot;reverse-fg&quot; setting unless the resulting
14725 interesting current line would look just like a non-interesting current line.
14726 In that case, the interesting line's colors are simply flipped (like in the
14727 default behavior).
14728 <P>
14729 As an alternative way to preserve the line's interestingness in this case,
14730 you may find that using both a different foreground and a different
14731 background color for the interesting line will help.
14732 </DD>
14733
14734 <DT>reverse-bg</DT>
14735 <DD>The background part of the Reverse Color is used to highlight
14736 the current line.
14737 If this would cause the text to be unreadable (because the foreground and
14738 background colors are the same) or if it would cause no change in the
14739 color of the index line, then the colors are flipped instead.
14740 <P>
14741 Some people think this works particularly well if you use different
14742 foreground colors to emphasize &quot;interesting&quot; lines,
14743 but always with the same Normal background color,
14744 and you use a different background color for the Reverse Color.
14745 </DD>
14746
14747 <DT>reverse-bg-no-ambiguity</DT>
14748 <DD>As with the &quot;reverse-fg&quot; case, the &quot;reverse-bg&quot;
14749 rule may also result in a color that is exactly the same as the regular
14750 Reverse Color.
14751 Setting the option to this value removes that ambiguity.
14752 It is the same as the &quot;reverse-bg&quot; setting unless the resulting
14753 current line has the same color as the Reverse Color.
14754 In that case, the interesting line's colors are simply flipped (like in the
14755 default behavior).
14756 </DD>
14757 </DL>
14758
14759 <P>
14760
14761 <UL>
14762 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14763 </UL><P>
14764 &lt;End of help on this topic&gt;
14765 </BODY>
14766 </HTML>
14767 ====== h_config_expanded_addrbooks =====
14768 <HTML>
14769 <HEAD>
14770 <TITLE>FEATURE: <!--#echo var="FEAT_expanded-view-of-addressbooks"--></TITLE>
14771 </HEAD>
14772 <BODY>
14773 <H1>FEATURE: <!--#echo var="FEAT_expanded-view-of-addressbooks"--></H1>
14774
14775 If multiple address books (either personal or global) are defined, and you
14776 wish to have them all expanded implicitly upon entering the ADDRESS BOOK
14777 screen, then set this feature. This feature will have no effect unless the
14778 feature
14779 <A HREF="h_config_combined_abook_display">&quot;<!--#echo var="FEAT_combined-addrbook-display"-->&quot;</A>
14780 is also set.
14781 <P>
14782 &lt;End of help on this topic&gt;
14783 </BODY>
14784 </HTML>
14785 ====== h_config_combined_folder_display =====
14786 <HTML>
14787 <HEAD>
14788 <TITLE>FEATURE: <!--#echo var="FEAT_combined-folder-display"--></TITLE>
14789 </HEAD>
14790 <BODY>
14791 <H1>FEATURE: <!--#echo var="FEAT_combined-folder-display"--></H1>
14792
14793 This feature affects the folder list display screens.
14794 Normally, each folder list is viewed within its collection only.  This
14795 command allows folder lists to be viewed within a single screen that
14796 combines the contents of all collections.
14797
14798 <P>
14799 The way that commands work won't be changed.
14800 For example, the Select All command will select all of the folders in the
14801 current collection, not all of the entries in all of the collections.
14802 The WhereIs command will change a little.
14803 It will search through all of the folders in the current collection as well
14804 as all the folder in any other expanded collection.
14805
14806 <P>
14807 When this feature is set, the setting of the feature
14808 <A HREF="h_config_expanded_folders">&quot;<!--#echo var="FEAT_expanded-view-of-folders"-->&quot;</A>
14809 has an effect.
14810 <P>
14811 &lt;End of help on this topic&gt;
14812 </BODY>
14813 </HTML>
14814 ====== h_config_combined_subdir_display =====
14815 <HTML>
14816 <HEAD>
14817 <TITLE>FEATURE: <!--#echo var="FEAT_combined-subdirectory-display"--></TITLE>
14818 </HEAD>
14819 <BODY>
14820 <H1>FEATURE: <!--#echo var="FEAT_combined-subdirectory-display"--></H1>
14821
14822 This feature affects the Folder List screen when
14823 the
14824 <A HREF="h_config_combined_folder_display">&quot;<!--#echo var="FEAT_combined-folder-display"-->&quot;</A>
14825 feature is enabled.  Normally, selecting a directory from the Folder
14826 List takes you into a new screen displaying only the contents of
14827 that directory.
14828
14829 <P>
14830 Enabling this feature will cause the contents of the selected
14831 directory to be
14832 displayed within the boundaries of the &quot;Collection&quot; it
14833 is a part of.  All previously displayed collections will remain
14834 in the screen.
14835
14836 <P>
14837 The way that commands work won't be changed.
14838 For example, the Select All command will select all of the folders in the
14839 directory, as opposed to all of the entries in all of the collections.
14840 The WhereIs command will change a little.
14841 It will search through all of the folders in the current collection as well
14842 as all the folder in any other expanded collection.
14843
14844 <P>
14845 &lt;End of help on this topic&gt;
14846 </BODY>
14847 </HTML>
14848 ====== h_config_separate_fold_dir_view =====
14849 <HTML>
14850 <HEAD>
14851 <TITLE>FEATURE: <!--#echo var="FEAT_separate-folder-and-directory-entries"--></TITLE>
14852 </HEAD>
14853 <BODY>
14854 <H1>FEATURE: <!--#echo var="FEAT_separate-folder-and-directory-entries"--></H1>
14855
14856 This feature affects folder collections wherein a folder
14857 and directory can have the same name.  By default, Alpine displays them
14858 only once, denoting that it is both a folder and directory by appending
14859 the folder name with the hierarchy character enclosed
14860 in square brackets.
14861
14862
14863 <P>
14864 Enabling this feature will cause Alpine to display such names
14865 separately marking the name representing a directory with a trailing
14866 hierarchy delimiter (typically the slash, &quot;/&quot;, character).
14867
14868 <P>
14869 The feature also alters the command set slightly.  By default, the
14870 right-arrow descends into the directory, while hitting the Return key will
14871 cause the folder by that name to be opened.
14872
14873 <P>
14874 With this feature set, the Return key will open the highlighted folder, or
14875 enter the highlighted directory.
14876
14877 <P>
14878 &lt;End of help on this topic&gt;
14879 </BODY>
14880 </HTML>
14881 ====== h_config_expanded_folders =====
14882 <HTML>
14883 <HEAD>
14884 <TITLE>FEATURE: <!--#echo var="FEAT_expanded-view-of-folders"--></TITLE>
14885 </HEAD>
14886 <BODY>
14887 <H1>FEATURE: <!--#echo var="FEAT_expanded-view-of-folders"--></H1>
14888
14889 If multiple folder collections are defined, and you
14890 wish to have them all expanded implicitly upon entering the FOLDER LIST
14891 screen, then set this feature. This feature will have no effect unless the
14892 feature
14893 <A HREF="h_config_combined_folder_display">&quot;<!--#echo var="FEAT_combined-folder-display"-->&quot;</A>
14894 is also set.
14895 <P>
14896 &lt;End of help on this topic&gt;
14897 </BODY>
14898 </HTML>
14899 ======= h_config_ldap_server =======
14900 <HTML>
14901 <HEAD>
14902 <TITLE>LDAP OPTION: <!--#echo var="VAR_ldap-servers"--></TITLE>
14903 </HEAD>
14904 <BODY>
14905 <H1>LDAP OPTION: <!--#echo var="VAR_ldap-servers"--></H1>
14906 This is the name of the host where an LDAP server is running.
14907 For redundancy, this may be a space-delimited set of server names, in which
14908 case the first server that answers is used.
14909 Each of the server names may be optionally followed by
14910 a colon and a port number.
14911 If this form is used then the port number configured below in the
14912 <EM>port</EM> field is not used.
14913 <P>
14914 To find out whether your organization has its own LDAP server,
14915 contact its computing support staff.
14916 <P><UL>
14917 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14918 </UL>
14919 <P>
14920 &lt;End of help on this topic&gt;
14921 </BODY>
14922 </HTML>
14923 ======= h_config_ldap_base =======
14924 <HTML>
14925 <HEAD>
14926 <TITLE>LDAP OPTION: Search-Base</TITLE>
14927 </HEAD>
14928 <BODY>
14929 <H1>LDAP OPTION: Search-Base</H1>
14930
14931 This is the search base to be used on this server.  It functions as a filter
14932 by restricting your searches in the LDAP server database
14933 to the specified contents of the specified fields.  Without it, searches
14934 submitted to this directory server may fail.  It might be something
14935 like:
14936
14937 <PRE>
14938       O = &lt;Your Organization Name&gt;, C = US
14939 </PRE>
14940 or it might be blank.
14941 (Some LDAP servers actually ignore anything specified here.)
14942 <P>
14943 If in doubt what parameters you should specify here,
14944 contact the maintainers of the LDAP server.
14945 <P><UL>
14946 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14947 </UL>
14948 <P>
14949 &lt;End of help on this topic&gt;
14950 </BODY>
14951 </HTML>
14952 ======= h_config_ldap_port =======
14953 <HTML>
14954 <HEAD>
14955 <TITLE>LDAP OPTION: Port</TITLE>
14956 </HEAD>
14957 <BODY>
14958 <H1>LDAP OPTION: Port</H1>
14959
14960 This is the TCP port number to be used with this LDAP server. If you leave
14961 this blank port 389 will be used.
14962 <P>
14963 &lt;End of help on this topic&gt;
14964 </BODY>
14965 </HTML>
14966 ======= h_config_ldap_nick =======
14967 <HTML>
14968 <HEAD>
14969 <TITLE>LDAP OPTION: Nickname</TITLE>
14970 </HEAD>
14971 <BODY>
14972 <H1>LDAP OPTION: Nickname</H1>
14973
14974 This is a nickname to be used in displays. If you don't supply a
14975 nickname the server name
14976 (<A HREF="h_config_ldap_server">&quot;<!--#echo var="VAR_ldap-servers"-->&quot;</A>)
14977 will be used instead.  This option is strictly for your convenience.
14978 <P>
14979 &lt;End of help on this topic&gt;
14980 </BODY>
14981 </HTML>
14982 ======= h_config_ldap_binddn =======
14983 <HTML>
14984 <HEAD>
14985 <TITLE>LDAP OPTION: Bind-DN</TITLE>
14986 </HEAD>
14987 <BODY>
14988 <H1>LDAP OPTION: Bind-DN</H1>
14989
14990 You may need to authenticate to the LDAP server before you are able to use it.
14991 This is the Distinguished Name to bind to when authenticating to this server.
14992 Try leaving this blank until you know you need it.
14993 <P>
14994 Alpine only knows about LDAP Simple authentication.
14995 It does not attempt LDAP SASL authentication.
14996 The DN and password will be sent in the clear unless TLS encryption is
14997 being used on this connection.
14998 Because of this, you may want to set the LDAP feature
14999 <A HREF="h_config_ldap_opts_tls">&quot;Attempt-TLS-On-Connection&quot;</A>
15000 or the feature
15001 <A HREF="h_config_ldap_opts_tlsmust">&quot;Require-TLS-On-Connection&quot;</A>
15002 if you are going to be providing a password.
15003 <P><UL>
15004 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
15005 </UL>
15006 <P>
15007 &lt;End of help on this topic&gt;
15008 </BODY>
15009 </HTML>
15010 ======= h_config_ldap_opts_impl =======
15011 <HTML>
15012 <HEAD>
15013 <TITLE>LDAP FEATURE: Use-Implicitly-From-Composer</TITLE>
15014 </HEAD>
15015 <BODY>
15016 <H1>LDAP FEATURE: Use-Implicitly-From-Composer</H1>
15017
15018 Set this to have lookups done to this server implicitly from the composer.
15019 If an address doesn't look like a fully-qualified address, it will be looked
15020 up in your address books, and if it doesn't match a nickname there, then it
15021 will be looked up on the LDAP servers that have this feature set.
15022 The lookups will also be done when using the address completion feature
15023 (TAB command) in the composer if any of the serves have this feature set.
15024 Also see the LDAP feature
15025 <A HREF="h_config_ldap_opts_rhs">&quot;Lookup-Addrbook-Contents&quot;</A>
15026 and the Setup/Config feature
15027 <A HREF="h_config_add_ldap">&quot;<!--#echo var="FEAT_ldap-result-to-addrbook-add"-->&quot;</A>.
15028 <P>
15029 &lt;End of help on this topic&gt;
15030 </BODY>
15031 </HTML>
15032 ======= h_config_ldap_opts_tls =======
15033 <HTML>
15034 <HEAD>
15035 <TITLE>LDAP FEATURE: Attempt-TLS-On-Connection</TITLE>
15036 </HEAD>
15037 <BODY>
15038 <H1>LDAP FEATURE: Attempt-TLS-On-Connection</H1>
15039
15040 When connecting to this server Alpine will attempt to use TLS encryption
15041 on the connection.
15042 Also see the closely related feature
15043 <A HREF="h_config_ldap_opts_tlsmust">&quot;Require-TLS-On-Connection&quot;</A>
15044 <P>
15045 Note that if this option is set, then
15046 <A HREF="h_config_ldap_opts_ldaps">
15047 &quot;Require-LDAPS-On-Connection&quot;</A>
15048 can not be enabled for this server. You must disable this feature in
15049 order to use
15050 <A HREF="h_config_ldap_opts_ldaps">
15051 &quot;Require-LDAPS-On-Connection&quot;</A>
15052 <P>
15053 &lt;End of help on this topic&gt;
15054 </BODY>
15055 </HTML>
15056 ======= h_config_ldap_opts_tlsmust =======
15057 <HTML>
15058 <HEAD>
15059 <TITLE>LDAP FEATURE: Require-TLS-On-Connection</TITLE>
15060 </HEAD>
15061 <BODY>
15062 <H1>LDAP FEATURE: Require-TLS-On-Connection</H1>
15063
15064 When connecting to this server Alpine will attempt to use TLS encryption
15065 on the connection.
15066 If the StartTLS operation fails then the connection will not be used.
15067 <P>
15068 Note that if this option is set, then
15069 <A HREF="h_config_ldap_opts_ldaps">
15070 &quot;Require-LDAPS-On-Connection&quot;</A>
15071 can not be enabled for this server. You must disable this feature in
15072 order to use
15073 <A HREF="h_config_ldap_opts_ldaps">
15074 &quot;Require-LDAPS-On-Connection&quot;</A>
15075 <P>
15076 &lt;End of help on this topic&gt;
15077 </BODY>
15078 </HTML>
15079 ======= h_config_ldap_opts_ldaps =======
15080 <HTML>
15081 <HEAD>
15082 <TITLE>LDAP FEATURE: Require-LDAPS-On-Connection</TITLE>
15083 </HEAD>
15084 <BODY>
15085 <H1>LDAP FEATURE: Require-LDAPS-On-Connection</H1>
15086
15087 When connecting to this server Alpine will use LDAPS (LDAP over SSL/TLS)
15088 on the connection.
15089 <P>
15090 This feature can not be used along with
15091 <A HREF="h_config_ldap_opts_tlsmust">&quot;Require-TLS-On-Connection&quot;</A>
15092  or
15093 <A HREF="h_config_ldap_opts_tls">&quot;Attempt-TLS-On-Connection&quot;</A>.
15094 If you want to connect using StartTLS to this server, you must disable
15095 this feature first.
15096 <P>
15097 &lt;End of help on this topic&gt;
15098 </BODY>
15099 </HTML>
15100 ====== h_config_ldap_opts_rhs =====
15101 <HTML>
15102 <HEAD>
15103 <TITLE>LDAP FEATURE: Lookup-Addrbook-Contents</TITLE>
15104 </HEAD>
15105 <BODY>
15106 <H1>LDAP FEATURE: Lookup-Addrbook-Contents</H1>
15107
15108 Normally implicit LDAP lookups from the composer are done only for the
15109 strings you type in from the composer screen. In other words, you type in
15110 something in the To or CC field and press return, then the string is looked up.
15111 First that string is looked up in your address books. If a match is found
15112 there, then the results of that match are looked up again. If you place
15113 a string in your address book that you want to have looked up on the LDAP
15114 directory server, you need to turn on this feature. If you set this feature
15115 for a server, you almost always will also want to set the
15116 <A HREF="h_config_ldap_opts_impl">&quot;Use-Implicitly-From-Composer&quot;</A>
15117 feature. An example might serve to best illustrate this feature.
15118 <P>
15119 If an LDAP lookup of &quot;William Clinton&quot; normally returns an
15120 entry with an
15121 address of pres@whitehouse.gov, then you might put an entry in your address
15122 book that looks like:
15123 <P>
15124 <CENTER><SAMP>Nickname = bill</SAMP></CENTER><BR>
15125 <CENTER><SAMP>Address = &quot;William Clinton&quot;</SAMP></CENTER>
15126 <P>
15127 Now, when you type &quot;bill&quot; into an
15128 address field in the composer Alpine will
15129 find the &quot;bill&quot; entry in your address book.
15130 It will replace &quot;bill&quot; with
15131 &quot;William Clinton&quot;.
15132 It will then search for an entry with that nickname
15133 in your address book and not find one. If this feature
15134 is set, Alpine will then attempt to lookup
15135 &quot;William Clinton&quot; on the LDAP server and find the entry with address
15136 pres@whitehouse.gov.
15137 <P>
15138 A better way to accomplish the same thing is probably to use the feature
15139 <A HREF="h_config_ldap_opts_ref">&quot;Save-Search-Criteria-Not-Result&quot;</A>.
15140 <P>
15141 &lt;End of help on this topic&gt;
15142 </BODY>
15143 </HTML>
15144 ====== h_config_ldap_opts_ref =====
15145 <HTML>
15146 <HEAD>
15147 <TITLE>LDAP FEATURE: Save-Search-Criteria-Not-Result</TITLE>
15148 </HEAD>
15149 <BODY>
15150 <H1>LDAP FEATURE: Save-Search-Criteria-Not-Result</H1>
15151
15152 Normally when you save the results of an LDAP directory lookup to your
15153 address book the results of the lookup are saved. If this feature is set
15154 and the entry being saved was found on this directory server, then the
15155 search criteria is saved instead of the results of the search. When this
15156 address book entry is used in the future, instead of copying the results
15157 from the address book the directory lookup will be done again. This could
15158 be useful if the copied result might become stale because the data on
15159 the directory server changes (for example, the entry's email address changes).
15160 You probably don't want to set this feature if the server is at all slow or
15161 unreliable.
15162 <P>
15163 The way this actually works is that instead of saving the email address
15164 in your address book, Alpine saves enough information to look up the same
15165 directory entry again. In particular, it saves the server name and the
15166 distinguished name of the entry. It's possible that the server administrators
15167 might change the format of distinguished names on the server, or that the
15168 entry might be removed from the server. If Alpine notices this, you will be warned
15169 and a backup copy of the email address will be used. You may want to create
15170 a new entry in this case, since you will get the annoying warning every
15171 time you use the old entry. You may do that by Saving the entry to a new
15172 nickname in the same address book. You will be asked whether or not you
15173 want to use the backup email address.
15174 <P>
15175 A related feature in the Setup/Config screen is
15176 <A HREF="h_config_add_ldap">&quot;<!--#echo var="FEAT_ldap-result-to-addrbook-add"-->&quot;</A>.
15177 <P>
15178 &lt;End of help on this topic&gt;
15179 </BODY>
15180 </HTML>
15181 ======= h_config_ldap_opts_nosub =======
15182 <HTML>
15183 <HEAD>
15184 <TITLE>LDAP FEATURE: Disable-Ad-Hoc-Space-Substitution</TITLE>
15185 </HEAD>
15186 <BODY>
15187 <H1>LDAP FEATURE: Disable-Ad-Hoc-Space-Substitution</H1>
15188
15189 Spaces in your input are normally handled specially.
15190 Each space character is replaced
15191 by
15192 <P>
15193 <CENTER><SAMP>*&nbsp;&lt;SPACE&gt;</SAMP></CENTER>
15194 <P>
15195 in the search query (but not by &quot;* &lt;SPACE&gt; *&quot;).
15196 The reason this is done is so the input string
15197 <P>
15198 <CENTER><SAMP>Greg Donald</SAMP></CENTER>
15199 <P>
15200 (which is converted to &quot;Greg* Donald&quot;) will match
15201 the names &quot;Greg Donald&quot;,
15202 &quot;Gregory Donald&quot;, &quot;Greg F. Donald&quot;, and
15203 &quot;Gregory F Donald&quot;; but it won't match &quot;Greg McDonald&quot;.
15204 If the &quot;Search-Rule&quot; you were using was &quot;begins-with&quot;,
15205 then it would also match the name &quot;Greg Donaldson&quot;.
15206 <P>
15207 Turning on this feature will disable this substitution.
15208 <P>
15209 &lt;End of help on this topic&gt;
15210 </BODY>
15211 </HTML>
15212 ====== h_config_ldap_searchtypes =======
15213 <HTML>
15214 <HEAD>
15215 <TITLE>LDAP OPTION: Search-Type</TITLE>
15216 </HEAD>
15217 <BODY>
15218 <H1>LDAP OPTION: Search-Type</H1>
15219
15220 This affects the way that LDAP searches are done.
15221 In particular, this tells the server where to look for the string to be matched.
15222 If set to &quot;name&quot; then the string that is being searched for will
15223 be compared with the string in the
15224 &quot;Name&quot; field on the server
15225 (technically, it is the &quot;commonname&quot; field on the server).
15226 &quot;Surname&quot; means we're looking for a
15227 match in the &quot;Surname&quot; field on the
15228 server (actually the &quot;sn&quot; field).
15229 &quot;Givenname&quot; really is &quot;givenname&quot;
15230 and &quot;email&quot; is the electronic mail address (this is actually the field
15231 called &quot;mail&quot; or &quot;electronicmail&quot; on the server).
15232 The other three types are combinations of
15233 the types listed so far. &quot;Name-or-email&quot;
15234 means the string should appear
15235 in either the &quot;name&quot; field OR the &quot;email&quot; field.
15236 Likewise, &quot;surname-or-givenname&quot;
15237 means &quot;surname&quot; OR &quot;givenname&quot;
15238 and &quot;sur-or-given-or-name-or-email&quot; means the obvious thing.
15239 <P>
15240 This search TYPE is combined with the
15241 search <A HREF="h_config_ldap_searchrules">RULE</A>
15242 to form the actual search query.
15243 <P>
15244 The usual default value for this
15245 option is &quot;sur-or-given-or-name-or-email&quot;.
15246 This type of search may be slow on some servers.
15247 Try &quot;name-or-email&quot;, which is often
15248 faster, or just &quot;name&quot; if the performance seems to be a problem.
15249 <P>
15250 Some servers have been configured with different attribute names for
15251 these four fields.
15252 In other words, instead of using the attribute name &quot;mail&quot;
15253 for the email address field, the server might be configured to use something
15254 else, for example, &quot;rfc822mail&quot; or &quot;internetemailaddress&quot;.
15255 Alpine can be configured to use these different attribute names by using
15256 the four configuration options:
15257 <P><UL>
15258 <LI><A HREF="h_config_ldap_email_attr">&quot;EmailAttribute&quot;</A>
15259 </UL>
15260 <P><UL>
15261 <LI><A HREF="h_config_ldap_cn_attr">&quot;NameAttribute&quot;</A>
15262 </UL>
15263 <P><UL>
15264 <LI><A HREF="h_config_ldap_sn_attr">&quot;SurnameAttribute&quot;</A>
15265 </UL>
15266 <P><UL>
15267 <LI><A HREF="h_config_ldap_gn_attr">&quot;GivennameAttribute&quot;</A>
15268 </UL>
15269 <P>
15270 &lt;End of help on this topic&gt;
15271 </BODY>
15272 </HTML>
15273 ====== h_config_ldap_searchrules =======
15274 <HTML>
15275 <HEAD>
15276 <TITLE>LDAP OPTION: Search-Rule</TITLE>
15277 </HEAD>
15278 <BODY>
15279 <H1>LDAP OPTION: Search-Rule</H1>
15280
15281 This affects the way that LDAP searches are done.
15282 If set to &quot;equals&quot; then
15283 only exact matches count.
15284 &quot;Contains&quot; means that the string you type in
15285 is a substring of what you are matching against.
15286 &quot;Begins-with&quot; and &quot;ends-with&quot;
15287 mean that the string starts or ends with the string you type in.
15288 <P>
15289 Spaces in your input are normally handled specially, but you can turn that
15290 special handling off with the
15291 <A HREF="h_config_ldap_opts_nosub">&quot;Disable-Ad-Hoc-Space-Substitution&quot;</A>
15292 feature.
15293 <P>
15294 The usual default value for this option is &quot;begins-with&quot;.
15295 <P>
15296 &lt;End of help on this topic&gt;
15297 </BODY>
15298 </HTML>
15299 ======= h_config_ldap_email_attr =======
15300 <HTML>
15301 <HEAD>
15302 <TITLE>LDAP OPTION: EmailAttribute</TITLE>
15303 </HEAD>
15304 <BODY>
15305 <H1>LDAP OPTION: EmailAttribute</H1>
15306
15307 This is the name of the attribute that is searched for when looking for
15308 an email address. The default value for this option is &quot;mail&quot; or
15309 &quot;electronicmail&quot;.
15310 If the server you are using uses a different attribute name for the email
15311 address, put that attribute name here.
15312 <P>
15313 This will affect the search filter used if your Search-Type is one that
15314 contains a search for &quot;email&quot;.
15315 It will also cause the attribute value matching this attribute name to be used
15316 as the email address when you look up an entry from the composer.
15317 <P>
15318 &lt;End of help on this topic&gt;
15319 </BODY>
15320 </HTML>
15321 ======= h_config_ldap_sn_attr =======
15322 <HTML>
15323 <HEAD>
15324 <TITLE>LDAP OPTION: SurnameAttribute</TITLE>
15325 </HEAD>
15326 <BODY>
15327 <H1>LDAP OPTION: SurnameAttribute</H1>
15328
15329 This is the name of the attribute that is searched for when looking for
15330 the surname of the entry. The default value for this option is &quot;sn&quot;.
15331 If the server you are using uses a different attribute name for the surname,
15332 put that attribute name here.
15333 This will affect the search filter used if your Search-Type is one that
15334 contains a search for &quot;surname&quot;.
15335 <P>
15336 &lt;End of help on this topic&gt;
15337 </BODY>
15338 </HTML>
15339 ======= h_config_ldap_gn_attr =======
15340 <HTML>
15341 <HEAD>
15342 <TITLE>LDAP OPTION: GivennameAttribute</TITLE>
15343 </HEAD>
15344 <BODY>
15345 <H1>LDAP OPTION: GivennameAttribute</H1>
15346
15347 This is the name of the attribute that is searched for when looking for
15348 the given name of the entry. The default value for this option is &quot;givenname&quot;.
15349 If the server you are using uses a different attribute name for the given name,
15350 put that attribute name here.
15351 This will affect the search filter used if your Search-Type is one that
15352 contains a search for &quot;givenname&quot;.
15353 <P>
15354 &lt;End of help on this topic&gt;
15355 </BODY>
15356 </HTML>
15357 ======= h_config_ldap_cn_attr =======
15358 <HTML>
15359 <HEAD>
15360 <TITLE>LDAP OPTION: NameAttribute</TITLE>
15361 </HEAD>
15362 <BODY>
15363 <H1>LDAP OPTION: NameAttribute</H1>
15364
15365 This is the name of the attribute that is searched for when looking for
15366 the name of the entry. The default value for this option is &quot;cn&quot;, which
15367 stands for common name.
15368 If the server you are using uses a different attribute name for the name,
15369 put that attribute name here.
15370 This will affect the search filter used if your Search-Type is one that
15371 contains a search for &quot;name&quot;.
15372 <P>
15373 &lt;End of help on this topic&gt;
15374 </BODY>
15375 </HTML>
15376 ======= h_config_ldap_time =======
15377 <HTML>
15378 <HEAD>
15379 <TITLE>LDAP OPTION: Timelimit</TITLE>
15380 </HEAD>
15381 <BODY>
15382 <H1>LDAP OPTION: Timelimit</H1>
15383
15384 This places a limit on the number of seconds the LDAP search will continue.
15385 The default is 30 seconds. A value of 0 means no limit. Note that some servers
15386 may place limits of their own on searches.
15387 <P>
15388 &lt;End of help on this topic&gt;
15389 </BODY>
15390 </HTML>
15391 ======= h_config_ldap_size =======
15392 <HTML>
15393 <HEAD>
15394 <TITLE>LDAP OPTION: Sizelimit</TITLE>
15395 </HEAD>
15396 <BODY>
15397 <H1>LDAP OPTION: Sizelimit</H1>
15398
15399 This places a limit on the number of entries returned by the LDAP server.
15400 A value of 0 means no limit. The default is 0. Note that some servers
15401 may place limits of their own on searches.
15402 <P>
15403 &lt;End of help on this topic&gt;
15404 </BODY>
15405 </HTML>
15406 ======= h_config_ldap_cust =======
15407 <HTML>
15408 <HEAD>
15409 <TITLE>LDAP OPTION: Custom-Search-Filter</TITLE>
15410 </HEAD>
15411 <BODY>
15412 <H1>LDAP OPTION: Custom-Search-Filter</H1>
15413
15414 This one is for advanced users only! If you define this, then the
15415 &quot;Search-Type&quot; and &quot;Search-Rule&quot; defined are both ignored.
15416 However, the feature
15417 <A HREF="h_config_ldap_opts_nosub">&quot;Disable-Ad-Hoc-Space-Substitution&quot;</A>
15418 is still in effect.
15419 That is, the space substitution will take place even in a custom filter unless
15420 you disable it.
15421 <P>
15422 If your LDAP service stops working and you suspect it might be because
15423 of your custom filter, just delete this filter and try using the
15424 &quot;Search-Type&quot; and &quot;Search-Rule&quot; instead.
15425 Another option that sometimes causes trouble is the
15426 <A HREF="h_config_ldap_base">&quot;Search-Base&quot;</A> option.
15427 <P>
15428 This variable may be set to the string representation of an LDAP search
15429 filter (see RFC1960). In the places where you want the address string to be
15430 substituted in, put a '%s' in this filter string. Here are some examples:
15431 <P>
15432 A &quot;Search-Type&quot; of &quot;name&quot; with &quot;Search-Rule&quot; of &quot;begins-with&quot;
15433 is equivalent to the &quot;Custom-Search-Filter&quot;
15434 <PRE>
15435      (cn=%s*)
15436 </PRE>
15437 When you try to match against the string &quot;string&quot; the program replaces
15438 the &quot;%s&quot; with &quot;string&quot; (without the quotes). You may have multiple &quot;%s&quot;'s and
15439 they will all be replaced with the string. There is a limit of 10 &quot;%s&quot;'s.
15440 <P>
15441 A &quot;Search-Type&quot; of &quot;name-or-email&quot; with &quot;Search-Rule&quot;
15442 of &quot;contains&quot; is equivalent to
15443 <PRE>
15444      (|(cn=*%s*)(mail=*%s*))
15445 </PRE>
15446 <P>
15447 If your server uses a different attribute <EM>name</EM> than
15448 Alpine uses by default,
15449 (for example, it uses &quot;rfc822mail&quot; instead of &quot;mail&quot;),
15450 then you may be able to use one or more of the four attribute configuration
15451 options instead of defining a custom filter:
15452 <P><UL>
15453 <LI><A HREF="h_config_ldap_email_attr">&quot;EmailAttribute&quot;</A>
15454 </UL>
15455 <P><UL>
15456 <LI><A HREF="h_config_ldap_cn_attr">&quot;NameAttribute&quot;</A>
15457 </UL>
15458 <P><UL>
15459 <LI><A HREF="h_config_ldap_sn_attr">&quot;SurnameAttribute&quot;</A>
15460 </UL>
15461 <P><UL>
15462 <LI><A HREF="h_config_ldap_gn_attr">&quot;GivennameAttribute&quot;</A>
15463 </UL>
15464 <P>
15465 &lt;End of help on this topic&gt;
15466 </BODY>
15467 </HTML>
15468 ======= h_composer_abook_comment =======
15469 <HTML>
15470 <HEAD>
15471 <TITLE>Addressbook Comment Explained</TITLE>
15472 </HEAD>
15473 <BODY>
15474 This is a comment to help you remember what this entry is. The WhereIs
15475 command searches comments so that it is easier to find an entry with a comment
15476 you know about attached to it. This field is not used in the outgoing message.
15477 <P>
15478 Look <A HREF="h_edit_nav_cmds">here</A>
15479 to see the available Editing and Navigation commands.
15480 <P>
15481 &lt;End of help on this topic&gt;
15482 </BODY>
15483 </HTML>
15484 ======= h_composer_abook_addrs =======
15485 <HTML>
15486 <HEAD>
15487 <TITLE>Addressbook Lists</TITLE>
15488 </HEAD>
15489 <BODY>
15490 <H1>Addressbook Lists</H1>
15491
15492 This is a list of addresses to send to when sending to this address book
15493 entry.  Each member of the list may be an address or another nickname from
15494 any of your address books.  If it is an address, it is OK to include the
15495 full name field as well as the electronic address portion of that address.
15496 For example, the following are all legitimate entries in this field:
15497
15498 <DL><DT>&nbsp;</DT>
15499 <DD>john&nbsp;&nbsp;&nbsp;&nbsp;(a nickname in your address book)
15500 <DD>jdoe@some.domain
15501 <DD>John Doe &lt;jdoe@some.domain&gt;
15502 </DL>
15503
15504 The addresses should be listed separated by commas, just like you would
15505 enter them from the composer.
15506
15507 <P>
15508
15509 The only difference between a distribution list and a simple entry with a
15510 single address, is that a distribution list has more than one address
15511 listed in the Addresses: field, whereas a simple personal entry has just
15512 one address.
15513
15514 <P>
15515
15516 For individual address book entries, if there is a full name in the
15517 Fullname: field (filling in the Fullname: field is not required), it is
15518 used.  If the full name is specified in the Address: field and not in the
15519 Fullname: field, then the full name from the Address: field is used.
15520
15521 <P>
15522
15523 If you type the nickname of a distribution list from one of your address
15524 books in the Lcc: field, then the full name of that list is used in the
15525 To: field.  If you put a list in the To: or Cc: fields, that list will be
15526 expanded into all of its addresses.  If the list has a full name, then
15527 that will appear at the beginning of the addresses.
15528
15529 <DL><DT>&nbsp;</DT>
15530 <DD>Sewing Club &lt;john@somewhere&gt;, nancy@something.else, Sal
15531 &lt;sal@here.there&gt;
15532 </DL>
15533
15534 If the first address in the distribution list also has a full name, then
15535 the list full name and that full name are combined into something like the
15536 following:
15537
15538 <DL><DT>&nbsp;</DT>
15539 <DD>Sewing Club -- John Smith &lt;john@somewhere&gt;
15540 </DL>
15541
15542
15543 If you specify a list via Lcc, the full name is used in the To: line.  If
15544 you specify a list in the To: or Cc: fields, then it uses the same method
15545 as for individual entries for filling in the full name.
15546
15547 <P>
15548
15549 For help with editing and navigation commands, check the Help for the
15550 Nickname: field.
15551
15552 <P>
15553 &lt;End of help on this topic&gt;
15554 </BODY>
15555 </HTML>
15556 ======= h_config_role_nick =======
15557 <HTML>
15558 <HEAD>
15559 <TITLE>Nickname Explained</TITLE>
15560 </HEAD>
15561 <BODY>
15562 <H1>Nickname Explained</H1>
15563
15564 This is a nickname to help you.
15565 You should have a different nickname for each role you define.
15566 The nickname will be used in the SETUP ROLE RULES screen to allow you to
15567 pick a role to edit.
15568 It will also be used when you send a message to let you know you are
15569 sending with a different role than you use by default, and
15570 it will be useful for choosing a role when composing with the Role command
15571 or when composing with one of the Role Uses set to With Confirmation.
15572 This field is not used in the outgoing message.
15573 <P>
15574 Look <A HREF="h_edit_nav_cmds">here</A>
15575 to see the available Editing and Navigation commands.
15576 <P>
15577 &lt;End of help on this topic&gt;
15578 </BODY>
15579 </HTML>
15580 ======= h_config_role_comment =======
15581 <HTML>
15582 <HEAD>
15583 <TITLE>Comment Explained</TITLE>
15584 </HEAD>
15585 <BODY>
15586 <H1>Comment Explained</H1>
15587
15588 This is a comment to help you.
15589 This comment does not play any functional role, it is simply an optional
15590 comment to help you remember what the rule is for.
15591 <P>
15592 Look <A HREF="h_edit_nav_cmds">here</A>
15593 to see the available Editing and Navigation commands.
15594 <P>
15595 &lt;End of help on this topic&gt;
15596 </BODY>
15597 </HTML>
15598 ======= h_config_other_nick =======
15599 <HTML>
15600 <HEAD>
15601 <TITLE>Nickname Explained</TITLE>
15602 </HEAD>
15603 <BODY>
15604 <H1>Nickname Explained</H1>
15605
15606 This is a nickname to help you.
15607 You should have a different nickname for each rule you define.
15608 The nickname will be used in the SETUP OTHER RULES screen to allow you to
15609 pick a rule to edit.
15610 <P>
15611 Look <A HREF="h_edit_nav_cmds">here</A>
15612 to see the available Editing and Navigation commands.
15613 <P>
15614 &lt;End of help on this topic&gt;
15615 </BODY>
15616 </HTML>
15617 ======= h_config_score_nick =======
15618 <HTML>
15619 <HEAD>
15620 <TITLE>Nickname Explained</TITLE>
15621 </HEAD>
15622 <BODY>
15623 <H1>Nickname Explained</H1>
15624
15625 This is a nickname to help you.
15626 You should have a different nickname for each scoring rule you define.
15627 The nickname will be used in the SETUP SCORING RULES screen to allow you to
15628 pick a rule to edit.
15629 <P>
15630 Look <A HREF="h_edit_nav_cmds">here</A>
15631 to see the available Editing and Navigation commands.
15632 <P>
15633 &lt;End of help on this topic&gt;
15634 </BODY>
15635 </HTML>
15636 ======= h_config_incol_nick =======
15637 <HTML>
15638 <HEAD>
15639 <TITLE>Nickname Explained</TITLE>
15640 </HEAD>
15641 <BODY>
15642 <H1>Nickname Explained</H1>
15643
15644 This is a nickname to help you.
15645 You should have a different nickname for each color rule you define.
15646 The nickname will be used in the SETUP INDEX COLOR RULES screen to allow you to
15647 pick a rule to edit.
15648 <P>
15649 Look <A HREF="h_edit_nav_cmds">here</A>
15650 to see the available Editing and Navigation commands.
15651 <P>
15652 &lt;End of help on this topic&gt;
15653 </BODY>
15654 </HTML>
15655 ======= h_config_filt_nick =======
15656 <HTML>
15657 <HEAD>
15658 <TITLE>Nickname Explained</TITLE>
15659 </HEAD>
15660 <BODY>
15661 <H1>Nickname Explained</H1>
15662
15663 This is a nickname to help you.
15664 You should have a different nickname for each filtering rule you define.
15665 The nickname will be used in the SETUP FILTERING RULES screen to allow you to
15666 pick a rule to edit.
15667 <P>
15668 Look <A HREF="h_edit_nav_cmds">here</A>
15669 to see the available Editing and Navigation commands.
15670 <P>
15671 &lt;End of help on this topic&gt;
15672 </BODY>
15673 </HTML>
15674 ======= h_config_score_topat =======
15675 <HTML>
15676 <HEAD>
15677 <TITLE>&quot;To:&quot; Pattern Explained</TITLE>
15678 </HEAD>
15679 <BODY>
15680 <H1>&quot;To:&quot; Pattern Explained</H1>
15681
15682 Any text you enter as the &quot;To pattern&quot;
15683 will be compared to the recipients from the To: line of
15684 the message being scored.
15685 When the text you entered matches
15686 all or part of the To: line of a message, then the Score Value
15687 you have specified will be added to the score for the message.
15688 (Any other non-blank parts of the Pattern must match, too.)
15689 <P>
15690
15691 You may enter a complete email address, part of an address, or a
15692 list of addresses or partial addresses.
15693 For example:
15694 <P>
15695
15696 <PRE>
15697  To pattern = friend@public.com
15698
15699  To pattern = rated.net
15700
15701  To pattern = xxx@adults.com
15702               admin@msn.com
15703               fool@motleyfool.com
15704 </PRE>
15705
15706 <P>
15707 Each of those are valid To patterns.
15708 <P>
15709
15710 Messages match those patterns if any of the
15711 addresses in the To: line of the message contains the pattern.
15712 If the pattern is a list of patterns
15713 (like the last example above) then it is a match if any of the patterns in
15714 the list match any of the addresses in the To: line.
15715 (It is not possible to specify two addresses that must <EM>BOTH</EM> be
15716 present for a match.
15717 It is only possible to specify that <EM>EITHER</EM> address1 <EM>OR</EM>
15718 address2 must be present.
15719 That is exactly what using a list does.)
15720 <P>
15721
15722 Some messages may be &quot;bounced&quot; to you, and will
15723 have a &quot;Resent-To:&quot; header line.
15724 If the message contains a Resent-To: line
15725 and the feature <A HREF="h_config_use_resentto"><!--#echo var="FEAT_use-resent-to-in-rules"--></A> is turned on,
15726 Alpine will look for
15727 matches to your &quot;To patterns&quot; there, and <EM>NOT</EM> in
15728 the original To: line.
15729 <P>
15730
15731 When entering a pattern, you may choose an address from your address book
15732 with the &quot;T&quot; command.
15733 <P>
15734
15735 It is possible to add a <EM>NOT</EM> to the To Pattern meaning with the
15736 &quot;!&quot; &quot;toggle NOT&quot; command.
15737 This changes the meaning of the To pattern so that it has the opposite meaning.
15738 It will be considered a match if there are no matches between the
15739 addresses in the To: line and the list of To patterns.
15740 <P>
15741 Don't make the mistake of putting the &quot;!&quot; in the data field for
15742 the pattern.
15743 For example, if you type the characters &quot;!frizzle&quot; into the To
15744 pattern, the pattern will look like:
15745 <P>
15746 <PRE>
15747  To pattern = !frizzle
15748 </PRE>
15749 <P>
15750 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
15751 In order to match messages that do not have &quot;frizzle&quot; in
15752 their To field, first type the characters &quot;frizzle&quot; followed
15753 by carriage return for the value of the To pattern, then negate it
15754 by typing the &quot;!&quot; command.
15755 It should end up looking like
15756 <P>
15757 <PRE>
15758  ! To pattern = frizzle
15759 </PRE>
15760 <P>
15761 You are not limited to using the six standard header patterns that are
15762 normally shown (To, From, Sender, Cc, News, and Subject).
15763 You may add any other header to a Pattern by
15764 using the &quot;eXtraHdr&quot; command to specify a different
15765 message header line; and then the Add or Change command to fill in
15766 a pattern for the new header line, just like you would for a standard header.
15767 <P>
15768 A technicality: Since comma is the character used to separate multiple
15769 values in a pattern field, you have to escape comma with a backslash (&#92;) if
15770 you want to include a literal comma in the field.
15771 In other words, if you type a backslash followed by a comma it will
15772 be interpreted as a comma by Alpine, instead of as a separator between
15773 pattern values.
15774 All other backslashes are literal backslashes and should not be escaped.
15775 <P>
15776 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
15777 for more information on Patterns.
15778 <P>
15779 Look <A HREF="h_edit_nav_cmds">here</A>
15780 to see the available Editing and Navigation commands.
15781 <P>
15782 &lt;End of help on this topic&gt;
15783 </BODY>
15784 </HTML>
15785 ======= h_config_incol_topat =======
15786 <HTML>
15787 <HEAD>
15788 <TITLE>&quot;To:&quot; Pattern Explained</TITLE>
15789 </HEAD>
15790 <BODY>
15791 <H1>&quot;To:&quot; Pattern Explained</H1>
15792
15793 Any text you enter as the &quot;To pattern&quot;
15794 will be compared to the recipients from the To: lines of
15795 the messages in the index.
15796 When the text you entered matches
15797 all or part of the To: line of a message, then the Index Line Color you have
15798 specified will be used for that line in the index.
15799 (Any other non-blank parts of the Pattern must match, too.)
15800 <P>
15801
15802 You may enter a complete email address, part of an address, or a
15803 list of addresses or partial addresses.
15804 For example:
15805 <P>
15806
15807 <PRE>
15808  To pattern = friend@public.com
15809  To pattern = rated.net
15810  To pattern = xxx@adults.com
15811               admin@msn.com
15812               fool@motleyfool.com
15813 </PRE>
15814
15815 <P>
15816 Each of those are valid To patterns.
15817 <P>
15818
15819 Messages match those patterns if any of the
15820 addresses in the To: line of the message contains the pattern.
15821 If the pattern is a list of patterns
15822 (like the last example above) then it is a match if any of the patterns in
15823 the list match any of the addresses in the To: line.
15824 (It is not possible to specify two addresses that must <EM>BOTH</EM> be
15825 present for a match.
15826 It is only possible to specify that <EM>EITHER</EM> address1 <EM>OR</EM>
15827 address2 must be present.
15828 That is exactly what using a list does.)
15829 <P>
15830
15831 Some messages may be &quot;bounced&quot; to you, and will
15832 have a &quot;Resent-To:&quot; header line.
15833 If the message contains a Resent-To: line
15834 and the feature <A HREF="h_config_use_resentto"><!--#echo var="FEAT_use-resent-to-in-rules"--></A> is turned on,
15835 Alpine will look for
15836 matches to your &quot;To patterns&quot; there, and <EM>NOT</EM> in
15837 the original To: line.
15838 <P>
15839
15840 When entering a pattern, you may choose an address from your address book
15841 with the &quot;T&quot; command.
15842 <P>
15843
15844 It is possible to add a <EM>NOT</EM> to the To Pattern meaning with the
15845 &quot;!&quot; &quot;toggle NOT&quot; command.
15846 This changes the meaning of the To pattern so that it has the opposite meaning.
15847 It will be considered a match if there are no matches between the
15848 addresses in the To: line and the list of To patterns.
15849 <P>
15850 Don't make the mistake of putting the &quot;!&quot; in the data field for
15851 the pattern.
15852 For example, if you type the characters &quot;!frizzle&quot; into the To
15853 pattern, the pattern will look like:
15854 <P>
15855 <PRE>
15856  To pattern = !frizzle
15857 </PRE>
15858 <P>
15859 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
15860 In order to match messages that do not have &quot;frizzle&quot; in
15861 their To field, first type the characters &quot;frizzle&quot; followed
15862 by carriage return for the value of the To pattern, then negate it
15863 by typing the &quot;!&quot; command.
15864 It should end up looking like
15865 <P>
15866 <PRE>
15867  ! To pattern = frizzle
15868 </PRE>
15869 <P>
15870
15871 You are not limited to using the six standard header patterns that are
15872 normally shown (To, From, Sender, Cc, News, and Subject).
15873 You may add any other header to a Pattern by
15874 using the &quot;eXtraHdr&quot; command to specify a different
15875 message header line; and then the Add or Change command to fill in
15876 a pattern for the new header line, just like you would for a standard header.
15877 <P>
15878 A technicality: Since comma is the character used to separate multiple
15879 values in a pattern field, you have to escape comma with a backslash (&#92;) if
15880 you want to include a literal comma in the field.
15881 In other words, if you type a backslash followed by a comma it will
15882 be interpreted as a comma by Alpine, instead of as a separator between
15883 pattern values.
15884 All other backslashes are literal backslashes and should not be escaped.
15885 <P>
15886 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
15887 for more information on Patterns.
15888 <P>
15889 Look <A HREF="h_edit_nav_cmds">here</A>
15890 to see the available Editing and Navigation commands.
15891 <P>
15892 &lt;End of help on this topic&gt;
15893 </BODY>
15894 </HTML>
15895 ======= h_config_other_topat =======
15896 <HTML>
15897 <HEAD>
15898 <TITLE>&quot;To:&quot; Pattern Explained</TITLE>
15899 </HEAD>
15900 <BODY>
15901 <H1>&quot;To:&quot; Pattern Explained</H1>
15902
15903 For some of the OTHER RULES actions, there is no message that is being
15904 compared against.
15905 If that is the case, then only the Current Folder Type is checked.
15906 In particular, this To pattern is ignored.
15907 Actions that fall into this category include both
15908 Sort Order and Index Format.
15909 <P>
15910 A technicality: Since comma is the character used to separate multiple
15911 values in a pattern field, you have to escape comma with a backslash (&#92;) if
15912 you want to include a literal comma in the field.
15913 In other words, if you type a backslash followed by a comma it will
15914 be interpreted as a comma by Alpine, instead of as a separator between
15915 pattern values.
15916 All other backslashes are literal backslashes and should not be escaped.
15917 <P>
15918 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
15919 for more information on Patterns.
15920 <P>
15921 Look <A HREF="h_edit_nav_cmds">here</A>
15922 to see the available Editing and Navigation commands.
15923 <P>
15924 &lt;End of help on this topic&gt;
15925 </BODY>
15926 </HTML>
15927 ======= h_config_filt_topat =======
15928 <HTML>
15929 <HEAD>
15930 <TITLE>&quot;To:&quot; Pattern Explained</TITLE>
15931 </HEAD>
15932 <BODY>
15933 <H1>&quot;To:&quot; Pattern Explained</H1>
15934
15935 Any text you enter as the &quot;To pattern&quot;
15936 will be compared to the recipients from the To: line of
15937 messages when Alpine opens folders.
15938 When the text you entered matches
15939 all or part of the To: line of a message, then the Filter Action you have
15940 specified will be carried out.
15941 (Any other non-blank parts of the Pattern must match, too.)
15942 <P>
15943
15944 You may enter a complete email address, part of an address, or a
15945 list of addresses or partial addresses.
15946 For example:
15947 <P>
15948
15949 <PRE>
15950  To pattern = friend@public.com
15951  To pattern = rated.net
15952  To pattern = xxx@adults.com
15953               admin@msn.com
15954               fool@motleyfool.com
15955 </PRE>
15956
15957 <P>
15958 Each of those are valid To patterns.
15959 <P>
15960
15961 Messages match those patterns if any of the
15962 addresses in the To: line of the message contains the pattern.
15963 If the pattern is a list of patterns
15964 (like the last example above) then it is a match if any of the patterns in
15965 the list match any of the addresses in the To: line.
15966 (It is not possible to specify two addresses that must <EM>BOTH</EM> be
15967 present for a match.
15968 It is only possible to specify that <EM>EITHER</EM> address1 <EM>OR</EM>
15969 address2 must be present.
15970 That is exactly what using a list does.)
15971 <P>
15972
15973 Some messages may be &quot;bounced&quot; to you, and will
15974 have a &quot;Resent-To:&quot; header line.
15975 If the message contains a Resent-To: line
15976 and the feature <A HREF="h_config_use_resentto"><!--#echo var="FEAT_use-resent-to-in-rules"--></A> is turned on,
15977 Alpine will look for
15978 matches to your &quot;To patterns&quot; there, and <EM>NOT</EM> in
15979 the original To: line.
15980 <P>
15981
15982 When entering a pattern, you may choose an address from your address book
15983 with the &quot;T&quot; command.
15984 <P>
15985
15986 It is possible to add a <EM>NOT</EM> to the To Pattern meaning with the
15987 &quot;!&quot; &quot;toggle NOT&quot; command.
15988 This changes the meaning of the To pattern so that it has the opposite meaning.
15989 It will be considered a match if there are no matches between the
15990 addresses in the To: line and the list of To patterns.
15991 <P>
15992 Don't make the mistake of putting the &quot;!&quot; in the data field for
15993 the pattern.
15994 For example, if you type the characters &quot;!frizzle&quot; into the To
15995 pattern, the pattern will look like:
15996 <P>
15997 <PRE>
15998  To pattern = !frizzle
15999 </PRE>
16000 <P>
16001 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
16002 In order to match messages that do not have &quot;frizzle&quot; in
16003 their To field, first type the characters &quot;frizzle&quot; followed
16004 by carriage return for the value of the To pattern, then negate it
16005 by typing the &quot;!&quot; command.
16006 It should end up looking like
16007 <P>
16008 <PRE>
16009  ! To pattern = frizzle
16010 </PRE>
16011 <P>
16012
16013 You are not limited to using the six standard header patterns that are
16014 normally shown (To, From, Sender, Cc, News, and Subject).
16015 You may add any other header to a Pattern by
16016 using the &quot;eXtraHdr&quot; command to specify a different
16017 message header line; and then the Add or Change command to fill in
16018 a pattern for the new header line, just like you would for a standard header.
16019 <P>
16020 A technicality: Since comma is the character used to separate multiple
16021 values in a pattern field, you have to escape comma with a backslash (&#92;) if
16022 you want to include a literal comma in the field.
16023 In other words, if you type a backslash followed by a comma it will
16024 be interpreted as a comma by Alpine, instead of as a separator between
16025 pattern values.
16026 All other backslashes are literal backslashes and should not be escaped.
16027 <P>
16028 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16029 for more information on Patterns.
16030 <P>
16031 Look <A HREF="h_edit_nav_cmds">here</A>
16032 to see the available Editing and Navigation commands.
16033 <P>
16034 &lt;End of help on this topic&gt;
16035 </BODY>
16036 </HTML>
16037 ======= h_config_role_topat =======
16038 <HTML>
16039 <HEAD>
16040 <TITLE>&quot;To:&quot; Pattern Explained</TITLE>
16041 </HEAD>
16042 <BODY>
16043 <H1>&quot;To:&quot; Pattern Explained</H1>
16044
16045 Any text you enter as the &quot;To pattern&quot;
16046 will be compared to the recipients from the To: line of
16047 the message being replied to or forwarded.
16048 (Any other non-blank parts of the Pattern must match, too.)
16049 In the case of the Compose command, this pattern and the other header
16050 patterns are ignored.
16051 <P>
16052
16053 You may enter a complete email address, part of an address, or a
16054 list of addresses or partial addresses.
16055 For example:
16056 <P>
16057
16058 <PRE>
16059  To pattern = friend@public.com
16060  To pattern = rated.net
16061  To pattern = xxx@adults.com
16062               admin@msn.com
16063               fool@motleyfool.com
16064 </PRE>
16065
16066 <P>
16067 Each of those are valid To patterns.
16068 <P>
16069
16070 Messages match those patterns if any of the
16071 addresses in the To: line of the message contains the pattern.
16072 If the pattern is a list of patterns
16073 (like the last example above) then it is a match if any of the patterns in
16074 the list match any of the addresses in the To: line.
16075 (It is not possible to specify two addresses that must <EM>BOTH</EM> be
16076 present for a match.
16077 It is only possible to specify that <EM>EITHER</EM> address1 <EM>OR</EM>
16078 address2 must be present.
16079 That is exactly what using a list does.)
16080 <P>
16081
16082 Some messages may be &quot;bounced&quot; to you, and will
16083 have a &quot;Resent-To:&quot; header line.
16084 If the message contains a Resent-To: line
16085 and the feature <A HREF="h_config_use_resentto"><!--#echo var="FEAT_use-resent-to-in-rules"--></A> is turned on,
16086 Alpine will look for
16087 matches to your &quot;To patterns&quot; there, and <EM>NOT</EM> in
16088 the original To: line.
16089 <P>
16090
16091 When entering a pattern, you may choose an address from your address book
16092 with the &quot;T&quot; command.
16093 <P>
16094
16095 It is possible to add a <EM>NOT</EM> to the To Pattern meaning with the
16096 &quot;!&quot; &quot;toggle NOT&quot; command.
16097 This changes the meaning of the To pattern so that it has the opposite meaning.
16098 It will be considered a match if there are no matches between the
16099 addresses in the To: line and the list of To patterns.
16100 <P>
16101 Don't make the mistake of putting the &quot;!&quot; in the data field for
16102 the pattern.
16103 For example, if you type the characters &quot;!frizzle&quot; into the To
16104 pattern, the pattern will look like:
16105 <P>
16106 <PRE>
16107  To pattern = !frizzle
16108 </PRE>
16109 <P>
16110 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
16111 In order to match messages that do not have &quot;frizzle&quot; in
16112 their To field, first type the characters &quot;frizzle&quot; followed
16113 by carriage return for the value of the To pattern, then negate it
16114 by typing the &quot;!&quot; command.
16115 It should end up looking like
16116 <P>
16117 <PRE>
16118  ! To pattern = frizzle
16119 </PRE>
16120 <P>
16121
16122 You are not limited to using the six standard header patterns that are
16123 normally shown (To, From, Sender, Cc, News, and Subject).
16124 You may add any other header to a Pattern by
16125 using the &quot;eXtraHdr&quot; command to specify a different
16126 message header line; and then the Add or Change command to fill in
16127 a pattern for the new header line, just like you would for a standard header.
16128 <P>
16129 A technicality: Since comma is the character used to separate multiple
16130 values in a pattern field, you have to escape comma with a backslash (&#92;) if
16131 you want to include a literal comma in the field.
16132 In other words, if you type a backslash followed by a comma it will
16133 be interpreted as a comma by Alpine, instead of as a separator between
16134 pattern values.
16135 All other backslashes are literal backslashes and should not be escaped.
16136 <P>
16137 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16138 for more information on Patterns.
16139 <P>
16140 Look <A HREF="h_edit_nav_cmds">here</A>
16141 to see the available Editing and Navigation commands.
16142 <P>
16143 &lt;End of help on this topic&gt;
16144 </BODY>
16145 </HTML>
16146 ======= h_config_role_frompat =======
16147 <HTML>
16148 <HEAD>
16149 <TITLE>&quot;From:&quot; Pattern Explained</TITLE>
16150 </HEAD>
16151 <BODY>
16152 <H1>&quot;From:&quot; Pattern Explained</H1>
16153
16154 This is just like the &quot;To pattern&quot; except that it is compared with
16155 the address in the From: line of the message
16156 instead of the addresses from the To: line.
16157 See the help for the To pattern for more information on header patterns.
16158 <P>
16159 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16160 for more information on Patterns.
16161 <P>
16162 Look <A HREF="h_edit_nav_cmds">here</A>
16163 to see the available Editing and Navigation commands.
16164 <P>
16165 &lt;End of help on this topic&gt;
16166 </BODY>
16167 </HTML>
16168 ======= h_config_role_senderpat =======
16169 <HTML>
16170 <HEAD>
16171 <TITLE>&quot;Sender:&quot; Pattern Explained</TITLE>
16172 </HEAD>
16173 <BODY>
16174 <H1>&quot;Sender:&quot; Pattern Explained</H1>
16175
16176 This is just like the &quot;To pattern&quot; except that it is compared with
16177 the address from the Sender: line of the message
16178 instead of the addresses from the To: line.
16179 See the help for the To pattern for more information on header patterns.
16180 <P>
16181 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16182 for more information on Patterns.
16183 <P>
16184 Look <A HREF="h_edit_nav_cmds">here</A>
16185 to see the available Editing and Navigation commands.
16186 <P>
16187 &lt;End of help on this topic&gt;
16188 </BODY>
16189 </HTML>
16190 ======= h_config_role_ccpat =======
16191 <HTML>
16192 <HEAD>
16193 <TITLE>&quot;Cc:&quot; Pattern Explained</TITLE>
16194 </HEAD>
16195 <BODY>
16196 <H1>&quot;Cc:&quot; Pattern Explained</H1>
16197
16198 This is just like the &quot;To pattern&quot; except that it is compared with
16199 the addresses from the Cc: line of the message
16200 instead of the addresses from the To: line.
16201 See the help for the To pattern for more information on header patterns.
16202 <P>
16203 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16204 for more information on Patterns.
16205 <P>
16206 Look <A HREF="h_edit_nav_cmds">here</A>
16207 to see the available Editing and Navigation commands.
16208 <P>
16209 &lt;End of help on this topic&gt;
16210 </BODY>
16211 </HTML>
16212 ======= h_config_role_recippat =======
16213 <HTML>
16214 <HEAD>
16215 <TITLE>Recipient Pattern Explained</TITLE>
16216 </HEAD>
16217 <BODY>
16218 <H1>Recipient Pattern Explained</H1>
16219
16220 This is just like the &quot;To pattern&quot; except that it is compared with
16221 the addresses from both the To: line and the Cc: line of the
16222 message instead of just the addresses from the To: line.
16223 In other words, it is considered a match if the pattern matches
16224 <EM>EITHER</EM> an address in the To: line <EM>OR</EM> an address
16225 in the Cc: line.
16226 (Notice that defining the Recipient pattern does not have the same
16227 effect as defining both the To and Cc patterns.
16228 Recipient is To <EM>OR</EM> Cc; not To <EM>AND</EM> Cc.
16229 It is equivalent to having two different rules;
16230 one with a To pattern and the other with the same Cc pattern.)
16231 <P>
16232 A technicality: Since comma is the character used to separate multiple
16233 values in a pattern field, you have to escape comma with a backslash (&#92;) if
16234 you want to include a literal comma in the field.
16235 In other words, if you type a backslash followed by a comma it will
16236 be interpreted as a comma by Alpine, instead of as a separator between
16237 pattern values.
16238 All other backslashes are literal backslashes and should not be escaped.
16239 <P>
16240 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16241 for more information on Patterns.
16242 <P>
16243 Look <A HREF="h_edit_nav_cmds">here</A>
16244 to see the available Editing and Navigation commands.
16245 <P>
16246 &lt;End of help on this topic&gt;
16247 </BODY>
16248 </HTML>
16249 ======= h_config_role_particpat =======
16250 <HTML>
16251 <HEAD>
16252 <TITLE>Participant Pattern Explained</TITLE>
16253 </HEAD>
16254 <BODY>
16255 <H1>Participant Pattern Explained</H1>
16256
16257 This is just like the &quot;To pattern&quot; except that it is compared with
16258 the addresses from the From: line, the To: line, and the Cc: line of the
16259 message instead of just the addresses from the To: line.
16260 In other words, it is considered a match if the pattern matches
16261 <EM>EITHER</EM> an address in the From: line, <EM>OR</EM> an address
16262 in the To: line, <EM>OR</EM> an address in the Cc: line.
16263 (Notice that defining the Participant pattern does not have the same
16264 effect as defining all of the From, To, and Cc patterns.
16265 Participant is From <EM>OR</EM> To <EM>OR</EM> Cc; not
16266 From <EM>AND</EM> To <EM>AND</EM> Cc.
16267 It is equivalent to having three different rules;
16268 one with a From pattern, another with the same To pattern, and a third with
16269 the same Cc pattern.)
16270 <P>
16271 A technicality: Since comma is the character used to separate multiple
16272 values in a pattern field, you have to escape comma with a backslash (&#92;) if
16273 you want to include a literal comma in the field.
16274 In other words, if you type a backslash followed by a comma it will
16275 be interpreted as a comma by Alpine, instead of as a separator between
16276 pattern values.
16277 All other backslashes are literal backslashes and should not be escaped.
16278 <P>
16279 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16280 for more information on Patterns.
16281 <P>
16282 Look <A HREF="h_edit_nav_cmds">here</A>
16283 to see the available Editing and Navigation commands.
16284 <P>
16285 &lt;End of help on this topic&gt;
16286 </BODY>
16287 </HTML>
16288 ======= h_config_role_newspat =======
16289 <HTML>
16290 <HEAD>
16291 <TITLE>News Pattern Explained</TITLE>
16292 </HEAD>
16293 <BODY>
16294 <H1>News Pattern Explained</H1>
16295
16296 If this pattern is non-blank, then for this rule to be considered a
16297 match, at least one of the newsgroups from
16298 the Newsgroups line of the message must match this pattern.
16299 If this pattern is a list of patterns, then at least one of the
16300 newsgroups must match at least one of the patterns.
16301 (Any other non-blank parts of the Pattern must match, too.)
16302 <P>
16303 It is possible to add a <EM>NOT</EM> to the News Pattern meaning with the
16304 &quot;!&quot; &quot;toggle NOT&quot; command.
16305 This changes the meaning of the News pattern so that it has the opposite meaning.
16306 It will be considered a match if there are no matches between the
16307 addresses in the Newsgroups: line and the list of News patterns.
16308 <P>
16309 Don't make the mistake of putting the &quot;!&quot; in the data field for
16310 the pattern.
16311 For example, if you type the characters &quot;!frizzle&quot; into the News
16312 pattern, the pattern will look like:
16313 <P>
16314 <PRE>
16315  News pattern = !frizzle
16316 </PRE>
16317 <P>
16318 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
16319 In order to match messages that do not have &quot;frizzle&quot; in
16320 their Newsgroups header, first type the characters &quot;frizzle&quot; followed
16321 by carriage return for the value of the News pattern, then negate it
16322 by typing the &quot;!&quot; command.
16323 It should end up looking like
16324 <P>
16325 <PRE>
16326  ! News pattern = frizzle
16327 </PRE>
16328 <P>
16329 A technicality: Since comma is the character used to separate multiple
16330 values in a pattern field, you have to escape comma with a backslash (&#92;) if
16331 you want to include a literal comma in the field.
16332 In other words, if you type a backslash followed by a comma it will
16333 be interpreted as a comma by Alpine, instead of as a separator between
16334 pattern values.
16335 All other backslashes are literal backslashes and should not be escaped.
16336 <P>
16337
16338 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16339 for more information on Patterns.
16340 <P>
16341 Look <A HREF="h_edit_nav_cmds">here</A>
16342 to see the available Editing and Navigation commands.
16343 <P>
16344 &lt;End of help on this topic&gt;
16345 </BODY>
16346 </HTML>
16347 ======= h_config_role_subjpat =======
16348 <HTML>
16349 <HEAD>
16350 <TITLE>&quot;Subject:&quot; Pattern Explained</TITLE>
16351 </HEAD>
16352 <BODY>
16353 <H1>&quot;Subject:&quot; Pattern Explained</H1>
16354
16355 This is similar to the other parts of the Pattern.
16356 It is compared with
16357 the contents from the Subject of the message.
16358 <P>
16359 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16360 for more information on Patterns.
16361 <P>
16362 It is possible to add a <EM>NOT</EM> to the Subject Pattern meaning with the
16363 &quot;!&quot; &quot;toggle NOT&quot; command.
16364 This changes the meaning of the Subject pattern so that it has the opposite meaning.
16365 It will be considered a match if there are no matches between the
16366 text in the Subject: line and the list of Subject patterns.
16367 <P>
16368
16369 If you wish to have a header pattern that is not one of the six standard
16370 header patterns, you may add it with the &quot;eXtraHdr&quot; command.
16371 <P>
16372 A technicality: Since comma is the character used to separate multiple
16373 values in a pattern field, you have to escape comma with a backslash (&#92;) if
16374 you want to include a literal comma in the field.
16375 In other words, if you type a backslash followed by a comma it will
16376 be interpreted as a comma by Alpine, instead of as a separator between
16377 pattern values.
16378 All other backslashes are literal backslashes and should not be escaped.
16379 <P>
16380 Look <A HREF="h_edit_nav_cmds">here</A>
16381 to see the available Editing and Navigation commands.
16382 <P>
16383 &lt;End of help on this topic&gt;
16384 </BODY>
16385 </HTML>
16386 ======= h_config_role_alltextpat =======
16387 <HTML>
16388 <HEAD>
16389 <TITLE>AllText Pattern Explained</TITLE>
16390 </HEAD>
16391 <BODY>
16392 <H1>AllText Pattern Explained</H1>
16393
16394 This is similar to the header patterns.
16395 Instead of comparing with text in a particular header field it
16396 is compared with all of the text in the message header and body.
16397 <P>
16398 It is possible to add a <EM>NOT</EM> to the AllText Pattern meaning with the
16399 &quot;!&quot; &quot;toggle NOT&quot; command.
16400 This changes the meaning of the AllText pattern so that it has the opposite meaning.
16401 It will be considered a match if there are no matches between the
16402 text of the message and the list of AllText patterns.
16403 <P>
16404 Don't make the mistake of putting the &quot;!&quot; in the data field for
16405 the pattern.
16406 For example, if you type the characters &quot;!frizzle&quot; into the AllText
16407 pattern, the pattern will look like:
16408 <P>
16409 <PRE>
16410  AllText pattern = !frizzle
16411 </PRE>
16412 <P>
16413 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
16414 In order to match messages that do not have &quot;frizzle&quot; in
16415 the text of the message, first type the characters &quot;frizzle&quot; followed
16416 by carriage return for the value of the AllText pattern, then negate it
16417 by typing the &quot;!&quot; command.
16418 It should end up looking like
16419 <P>
16420 <PRE>
16421  ! AllText pattern = frizzle
16422 </PRE>
16423 <P>
16424 It is possible that you may notice degraded performance when using
16425 AllText Patterns.
16426 <P>
16427 A technicality: Since comma is the character used to separate multiple
16428 values in a pattern field, you have to escape comma with a backslash (&#92;) if
16429 you want to include a literal comma in the field.
16430 In other words, if you type a backslash followed by a comma it will
16431 be interpreted as a comma by Alpine, instead of as a separator between
16432 pattern values.
16433 All other backslashes are literal backslashes and should not be escaped.
16434 <P>
16435 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16436 for more information on Patterns.
16437 <P>
16438 Look <A HREF="h_edit_nav_cmds">here</A>
16439 to see the available Editing and Navigation commands.
16440 <P>
16441 &lt;End of help on this topic&gt;
16442 </BODY>
16443 </HTML>
16444 ======= h_config_role_bodytextpat =======
16445 <HTML>
16446 <HEAD>
16447 <TITLE>BodyText Pattern Explained</TITLE>
16448 </HEAD>
16449 <BODY>
16450 <H1>BodyText Pattern Explained</H1>
16451
16452 This is similar to the header patterns.
16453 Instead of comparing with text in a particular header field it
16454 is compared with all of the text in the message body.
16455 <P>
16456 It is possible to add a <EM>NOT</EM> to the BodyText Pattern meaning with the
16457 &quot;!&quot; &quot;toggle NOT&quot; command.
16458 This changes the meaning of the BodyText pattern so that it has the opposite meaning.
16459 It will be considered a match if there are no matches between the
16460 text of the body of the message and the list of BodyText patterns.
16461 <P>
16462 Don't make the mistake of putting the &quot;!&quot; in the data field for
16463 the pattern.
16464 For example, if you type the characters &quot;!frizzle&quot; into the BodyText
16465 pattern, the pattern will look like:
16466 <P>
16467 <PRE>
16468  BdyText pattern = !frizzle
16469 </PRE>
16470 <P>
16471 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
16472 In order to match messages that do not have &quot;frizzle&quot; in
16473 their BodyText, first type the characters &quot;frizzle&quot; followed
16474 by carriage return for the value of the BodyText pattern, then negate it
16475 by typing the &quot;!&quot; command.
16476 It should end up looking like
16477 <P>
16478 <PRE>
16479  ! BodyText pattern = frizzle
16480 </PRE>
16481 <P>
16482 It is possible that you may notice degraded performance when using
16483 BodyText Patterns.
16484 <P>
16485 A technicality: Since comma is the character used to separate multiple
16486 values in a pattern field, you have to escape comma with a backslash (&#92;) if
16487 you want to include a literal comma in the field.
16488 In other words, if you type a backslash followed by a comma it will
16489 be interpreted as a comma by Alpine, instead of as a separator between
16490 pattern values.
16491 All other backslashes are literal backslashes and should not be escaped.
16492 <P>
16493 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16494 for more information on Patterns.
16495 <P>
16496 Look <A HREF="h_edit_nav_cmds">here</A>
16497 to see the available Editing and Navigation commands.
16498 <P>
16499 &lt;End of help on this topic&gt;
16500 </BODY>
16501 </HTML>
16502 ======= h_config_role_charsetpat =======
16503 <HTML>
16504 <HEAD>
16505 <TITLE>Character Set Pattern Explained</TITLE>
16506 </HEAD>
16507 <BODY>
16508 <H1>Character Set Pattern Explained</H1>
16509
16510 A message may use one or more character sets.
16511 This part of the Pattern matches messages that make use of
16512 certain specified character sets.
16513 It will be considered a match if a message uses any of the character
16514 sets in the list you give here.
16515
16516 <P>
16517 When filling in a value for this field, you may use
16518 the &quot;T&quot; command, which presents you with a large list of
16519 possible character sets to choose from.
16520 You may also just type in the name of a character set, and it need not
16521 be one that Alpine knows about.
16522
16523 <P>
16524 Besides actual character set names (for example, ISO-8859-7, KOI8-R, or
16525 GB2312) you may also use some shorthand names that Alpine provides.
16526 These names are more understandable shorthand names for sets of
16527 character set names.
16528 Two examples are &quot;Cyrillic&quot; and &quot;Greek&quot;.
16529 Selecting one of these shorthand names is equivalent to selecting all of
16530 the character sets that make up the set.
16531 You can see all of these shorthand names and the lists of character sets
16532 they stand for by typing the &quot;T&quot; command.
16533
16534 <P>
16535 For the purposes of this Pattern,
16536 Alpine will search through a message for all of the text parts and
16537 collect the character sets declared for each part.
16538 It will also look in the Subject line for a character set used there.
16539 Alpine does not actually look at the text of the message or the text
16540 of the Subject to determine if a declared character set is actually
16541 used, it looks only at the declarations themselves in the MIME part headers
16542 and in the Subject.
16543
16544 <P>
16545 It is possible to add a <EM>NOT</EM> to the Character Set Pattern meaning with the
16546 &quot;!&quot; &quot;toggle NOT&quot; command.
16547 This changes the meaning of the Character Set pattern so that
16548 it has the opposite meaning.
16549 It will be considered a match if none of the character sets in the
16550 list are used in a message.
16551 <P>
16552 Don't make the mistake of putting the &quot;!&quot; in the data field for
16553 the pattern.
16554 For example, if you type the characters &quot;!GB2312&quot; into the
16555 Character Set pattern, the pattern will look like:
16556 <P>
16557 <PRE>
16558  Charset pattern = !GB2312
16559 </PRE>
16560 <P>
16561 This means you want to match the 7 character sequence &quot;!GB2312&quot;.
16562 In order to match messages that do not have the
16563 character set &quot;GB2312&quot;
16564 set, first type the characters &quot;GB2312&quot; followed
16565 by carriage return for the value of the Character Set pattern, then negate it
16566 by typing the &quot;!&quot; command.
16567 It should end up looking like
16568 <P>
16569 <PRE>
16570  ! Charset pattern = GB2312
16571 </PRE>
16572 <P>
16573 A technicality: Since comma is the character used to separate multiple
16574 values in a pattern field, you have to escape comma with a backslash (&#92;) if
16575 you want to include a literal comma in the field.
16576 In other words, if you type a backslash followed by a comma it will
16577 be interpreted as a comma by Alpine, instead of as a separator between
16578 pattern values.
16579 All other backslashes are literal backslashes and should not be escaped.
16580 <P>
16581 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16582 for more information on Patterns.
16583 <P>
16584 Look <A HREF="h_edit_nav_cmds">here</A>
16585 to see the available Editing and Navigation commands.
16586 <P>
16587 &lt;End of help on this topic&gt;
16588 </BODY>
16589 </HTML>
16590 ======= h_config_role_keywordpat =======
16591 <HTML>
16592 <HEAD>
16593 <TITLE>Keyword Pattern Explained</TITLE>
16594 </HEAD>
16595 <BODY>
16596 <H1>Keyword Pattern Explained</H1>
16597
16598 A folder may have user-defined keywords.
16599 These are similar to the Important flag, which the user may set using the
16600 Flag command.
16601 The difference is that the Important flag is always present for each folder.
16602 User-defined keywords are picked by the user.
16603 You may add new keywords by defining them in the
16604 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in the Setup/Config screen.
16605 After you have added a potential keyword with the <!--#echo var="VAR_keywords"--> option,
16606 the Flag command may be used to set or clear the keyword on individual messages.
16607 If you have given a keyword a nickname when configuring it,
16608 that nickname may be used instead of the actual keyword.
16609
16610 <P>
16611 When filling in a value for this field, it may be easiest to use
16612 the &quot;T&quot; command, which presents you with a list of the keywords
16613 you have defined to choose from.
16614
16615 <P>
16616 This part of the Pattern matches messages with certain keywords set.
16617 It will be considered a match if a message has any of the keywords in the
16618 list set.
16619 A keyword that you have not defined using the
16620 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in the Setup/Config screen
16621 will not be a match.
16622
16623 <P>
16624 It is possible to add a <EM>NOT</EM> to the Keyword Pattern meaning with the
16625 &quot;!&quot; &quot;toggle NOT&quot; command.
16626 This changes the meaning of the Keyword pattern so that it has the opposite meaning.
16627 It will be considered a match if none of the keywords in the list are set
16628 for a message.
16629 A keyword that you have not defined using the
16630 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in the Setup/Config screen
16631 will not be a match, so a <EM>NOT</EM> of that keyword does match.
16632 <P>
16633 Don't make the mistake of putting the &quot;!&quot; in the data field for
16634 the pattern.
16635 For example, if you type the characters &quot;!frizzle&quot; into the Keyword
16636 pattern, the pattern will look like:
16637 <P>
16638 <PRE>
16639  Keyword pattern = !frizzle
16640 </PRE>
16641 <P>
16642 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
16643 In order to match messages that do not have the keyword &quot;frizzle&quot;
16644 set, first type the characters &quot;frizzle&quot; followed
16645 by carriage return for the value of the Keyword pattern, then negate it
16646 by typing the &quot;!&quot; command.
16647 It should end up looking like
16648 <P>
16649 <PRE>
16650  ! Keyword pattern = frizzle
16651 </PRE>
16652 <P>
16653 A technicality: Since comma is the character used to separate multiple
16654 values in a pattern field, you have to escape comma with a backslash (&#92;) if
16655 you want to include a literal comma in the field.
16656 In other words, if you type a backslash followed by a comma it will
16657 be interpreted as a comma by Alpine, instead of as a separator between
16658 pattern values.
16659 All other backslashes are literal backslashes and should not be escaped.
16660 <P>
16661 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16662 for more information on Patterns.
16663 <P>
16664 Look <A HREF="h_edit_nav_cmds">here</A>
16665 to see the available Editing and Navigation commands.
16666 <P>
16667 &lt;End of help on this topic&gt;
16668 </BODY>
16669 </HTML>
16670 ======= h_config_role_arbpat =======
16671 <HTML>
16672 <HEAD>
16673 <TITLE>Extra Header Patterns Explained</TITLE>
16674 </HEAD>
16675 <BODY>
16676 <H1>Extra Header Patterns Explained</H1>
16677
16678 The header patterns that come after the Participant pattern but before the
16679 AllText pattern are extra header patterns that you have added to a rule's
16680 Pattern. These are just like the other header patterns except that
16681 the contents of the particular header listed on the left hand side will
16682 be used for comparisons.
16683 <P>
16684 The &quot;eXtraHdr&quot; command may be used to add more of these
16685 header patterns to the rule you are editing.
16686 <P>
16687 The &quot;RemoveHdr&quot; command may be used to delete the highlighted
16688 extra header pattern from the rule you are editing.
16689 <P>
16690 It is possible to add a <EM>NOT</EM> to the Extra Header Pattern meaning with the
16691 &quot;!&quot; &quot;toggle NOT&quot; command.
16692 This changes the meaning of the pattern so that it has the opposite meaning.
16693 It will be considered a match if there are no matches between the
16694 text in the header line and the list of patterns.
16695 <P>
16696 Don't make the mistake of putting the &quot;!&quot; in the data field for
16697 the pattern.
16698 For example, if you type the characters &quot;!frizzle&quot; into the
16699 pattern, the pattern will look like:
16700 <P>
16701 <PRE>
16702  Xyz pattern = !frizzle
16703 </PRE>
16704 <P>
16705 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
16706 In order to match messages that do not have &quot;frizzle&quot; in
16707 their Xyz field, first type the characters &quot;frizzle&quot; followed
16708 by carriage return for the value of the pattern, then negate it
16709 by typing the &quot;!&quot; command.
16710 It should end up looking like
16711 <P>
16712 <PRE>
16713  ! Xyz pattern = frizzle
16714 </PRE>
16715
16716 <P>
16717 A technicality: Since comma is the character used to separate multiple
16718 values in a pattern field, you have to escape comma with a backslash (&#92;) if
16719 you want to include a literal comma in the field.
16720 In other words, if you type a backslash followed by a comma it will
16721 be interpreted as a comma by Alpine, instead of as a separator between
16722 pattern values.
16723 All other backslashes are literal backslashes and should not be escaped.
16724 <P>
16725 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16726 for more information on Patterns.
16727 <P>
16728 Look <A HREF="h_edit_nav_cmds">here</A>
16729 to see the available Editing and Navigation commands.
16730 <P>
16731 &lt;End of help on this topic&gt;
16732 </BODY>
16733 </HTML>
16734 ======= h_config_role_cat_cmd =======
16735 <HTML>
16736 <HEAD>
16737 <TITLE>Categorizer Command Explained</TITLE>
16738 </HEAD>
16739 <BODY>
16740 <H1>Categorizer Command Explained</H1>
16741
16742 This is a command that is run with its standard input set to the message
16743 being checked and its standard output discarded.
16744 The full directory path should be specified.
16745 The command will be run and then its exit status will be checked against
16746 the Exit Status Interval, which defaults to just the value zero.
16747 If the exit status of the command falls in the interval, it is considered
16748 a match, otherwise it is not a match.
16749 <P>
16750
16751 This option may actually be a list of commands.
16752 The first one that exists and is executable is used.
16753 That makes it possible to use the same configuration with Unix Alpine and
16754 PC-Alpine.
16755 <P>
16756
16757 If none of the commands in the list exists and is executable then the rule
16758 is <EM>not</EM> a match.
16759 If it is possible that the command may not exist, you should be careful
16760 to structure your rules so that nothing destructive
16761 happens when the command does not exist.
16762 For example, you might have a filter that filters away spam when there is
16763 a match but does nothing when there is not a match.
16764 That would cause no harm if the command didn't exist.
16765 However, if you have a filter that filters away spam when there is not
16766 a match and keeps it when there is a match, that would filter everything
16767 if the categorizer command didn't exist.
16768 <P>
16769 Here is an <A HREF="h_config_role_cat_cmd_example">example</A>
16770 setup for the bogofilter filter.
16771
16772 <P>
16773 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16774 for more information on Patterns.
16775 <P>
16776 Look <A HREF="h_edit_nav_cmds">here</A>
16777 to see the available Editing and Navigation commands.
16778 <P>
16779 &lt;End of help on this topic&gt;
16780 </BODY>
16781 </HTML>
16782 ======= h_config_role_cat_cmd_example =======
16783 <HTML>
16784 <HEAD>
16785 <TITLE>Categorizer Command Example</TITLE>
16786 </HEAD>
16787 <BODY>
16788 <H1>Categorizer Command Example</H1>
16789
16790 Bogofilter
16791 (<A HREF="http://bogofilter.sourceforge.net/">http://bogofilter.sourceforge.net/</A>)
16792 is a mail filter that attempts to classify mail as spam or
16793 non-spam using statistical analysis of the message content.
16794 When run with no arguments and a message as standard input, it exits with
16795 exit status 0 if it thinks a message is spam and 1 if it thinks
16796 it is not spam.
16797 To use bogofilter as your Categorizer Command you would simply set Command to
16798 the pathname of the bogofilter program.
16799 For example,
16800 <P>
16801 <CENTER><SAMP>Command = /usr/local/bin/bogofilter</SAMP></CENTER>
16802 <P>
16803 Exit status of zero is what you are interested in, so you'd set the
16804 Exit Status Interval to
16805 <P>
16806 <CENTER><SAMP>Exit Status Interval = (0,0)</SAMP></CENTER>
16807 <P>
16808
16809 In order to prevent downloading an entire huge message to check for spam, you
16810 might want to set the Character Limit to a few thousand characters (the
16811 assumption being that the spam will reveal itself in those characters)
16812 <P>
16813 <CENTER><SAMP>Character Limit = 50000</SAMP></CENTER>
16814 <P>
16815
16816 You would probably use bogofilter in an Alpine Filter Rule, and have the action
16817 be to move the message to a spam folder.
16818 It would usually be wise to also check the &quot;Message is Recent&quot;
16819 part of the rule so that messages are only checked when they first arrive,
16820 and to restrict the Current Folder Type to just your INBOX.
16821 The reason for checking only Recent messages is to save the time it takes
16822 to run bogofilter on each message.
16823 As an experiment, you might start out by using this in an Indexcolor Rule
16824 instead of a Filter Rule.
16825 In that case, you probably wouldn't check the Recent checkbox.
16826 <P>
16827 The use described above assumes that you are somehow maintaining bogofilter's
16828 database of words associated with spam and non-spam messages.
16829 One way to start your database would be to select a bunch of spam messages
16830 in Alpine (you might Save spam messages to a special folder or use Alpine's
16831 Select command to select several) and then Apply
16832 (<A HREF="h_config_enable_agg_ops"><!--#echo var="FEAT_enable-aggregate-command-set"--></A>)
16833 a pipe command to the spam messages.
16834 For example, you could have a shell script or an alias
16835 called <EM>this_is_spam</EM>, which would simply be the command
16836 <P>
16837 <CENTER><SAMP>bogofilter -s</SAMP></CENTER>
16838 <P>
16839
16840 It is probably best to use the pipe command's Raw Text, With Delimiter,
16841 and Free Output options,
16842 which are at the bottom of the screen when you type the pipe command.
16843 That's because bogofilter expects the raw message as input, and uses
16844 the Delimiters to tell when a new message starts.
16845 You would not need to use a separate pipe for each message, because
16846 bogofilter can handle multiple messages at once.
16847 <P>
16848 Similarly, you would select a group of non-spam messages
16849 and run them through a <EM>this_is_nonspam</EM> script
16850 that was something like
16851 <P>
16852 <CENTER><SAMP>bogofilter -n</SAMP></CENTER>
16853 <P>
16854
16855 For the more adventurous, the next step might be to automate the upkeep of
16856 the bogofilter database.
16857 It might make more sense to have bogofilter be part of the delivery process,
16858 but it is also possible to do it entirely from within Alpine.
16859 Instead of using just plain &quot;bogofilter&quot; as the Categorizer Command,
16860 the &quot;-u&quot; argument will cause bogofilter to update the database.
16861 <P>
16862 <CENTER><SAMP>Command = /usr/local/bin/bogofilter -u</SAMP></CENTER>
16863 <P>
16864 You'd want a couple more aliases or shell scripts called something like
16865 <EM>change_to_spam</EM>
16866 <P>
16867 <CENTER><SAMP>bogofilter -Ns</SAMP></CENTER>
16868 <P>
16869 and
16870 <EM>change_to_nonspam</EM>
16871 <P>
16872 <CENTER><SAMP>bogofilter -Sn</SAMP></CENTER>
16873 <P>
16874 When you run across a message in your INBOX that should have been
16875 classified as spam you would pipe it to the change_to_spam script, and
16876 when you run across a message in your spam folder that should have been
16877 left in your INBOX you would pipe it through change_to_nonspam.
16878
16879 <P>
16880 There is a technical problem with this approach.
16881 Alpine may check your filters more than once.
16882 In particular, every time you start Alpine the filters will be checked for
16883 each message.
16884 Also, if you have any filters that depend on message state (New, Deleted, etc.)
16885 then Alpine will recheck for matches in messages that have changed state
16886 at the time you close the folder and before expunging.
16887 This is usually ok.
16888 However, in this case it is a problem because the command
16889 <P>
16890 <CENTER><SAMP>Command = /usr/local/bin/bogofilter -u</SAMP></CENTER>
16891 <P>
16892 has the side effect of updating the database.
16893 So you run the risk of updating the database multiple times for a single
16894 message instead of updating it just once per message.
16895 There are some ways to work around this problem.
16896 What you need is a way to mark the message after you have run the filter.
16897 One way to mark messages is with the use of a keyword (say &quot;Bogo&quot;).
16898 Besides having the filter move the message to a spam folder, also have it
16899 set the Bogo keyword.
16900 (Note that you will have to set up the &quot;Bogo&quot; keyword in the
16901 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in Setup/Config.)
16902 This rule can only set the Bogo keyword for the messages that it matches.
16903 You will also need to add a second rule right after this one that
16904 matches all the messages that don't have the Bogo keyword set
16905 (put the keyword in the Keyword pattern and toggle
16906 the Not with the ! command)
16907 and takes the action of setting it.
16908 Then change the &quot;bogofilter -u&quot; rule so that it won't be a match
16909 (and so it won't re-run the bogofilter command) if the keyword is already
16910 set.
16911 <P>
16912 What you will end up with is a rule that runs &quot;bogofilter -u&quot;
16913 on all messages that don't have the Bogo keyword set.
16914 This will have the side effect of inserting that message in the bogofilter
16915 database, match or not.
16916 If this rule matches (it is spam), the Bogo keyword will be set and
16917 the message will be moved to a spam folder.
16918 If it does not match, the
16919 following rule will mark the message by turning on the keyword.
16920 This second rule should be a non-terminating
16921 (<A HREF="h_config_filt_opts_nonterm">Dont-Stop-Even-if-Rule-Matches</A>)
16922 rule so that it doesn't stop the filtering process before the rest of
16923 your rules are consulted.
16924
16925 <P>
16926 In summary, the first rule is something like
16927 <PRE>
16928   Nickname          = bogofilter -u rule
16929   Current Folder Type =
16930                (*) Specific
16931                    Folder = INBOX
16932
16933   ! Keyword pattern = Bogo
16934
16935   External Categorizer Commands =
16936        Command              = /usr/local/bin/bogofilter -u
16937        Exit Status Interval = (0,0)
16938        Character Limit      = <No Value Set: using "-1">  (optionally set this)
16939
16940   Filter Action =
16941        (*) Move
16942            Folder = spam
16943
16944   Set These Keywords   = Bogo
16945 </PRE>
16946 <P>
16947 and the following rule is
16948 <PRE>
16949   Nickname          = Set Bogo Keyword
16950   Current Folder Type =
16951                (*) Specific
16952                    Folder = INBOX
16953
16954   ! Keyword pattern = Bogo
16955
16956   Filter Action =
16957        (*) Just Set Message Status
16958
16959   Set These Keywords   = Bogo
16960
16961   Features =
16962       [X]  dont-stop-even-if-rule-matches
16963 </PRE>
16964 <P>
16965 If it is possible for you to insert bogofilter in the delivery process instead
16966 of having it called from Alpine you could prevent having to wait
16967 for the bogofilter processing while you read your mail.
16968 You would have bogofilter add a header to the message at the time of delivery
16969 that identified it as spam or nonspam.
16970 With this method, you could avoid using a Categorizer Command while running Alpine,
16971 and just match on the header instead.
16972 You might still want to use the scripts mentioned above to initialize the
16973 database or to re-classify wrongly classified messages.
16974
16975 <P>
16976 Finally, it isn't for the faint-hearted,
16977 but it is also possible to run bogofilter from PC-Alpine.
16978 You can install Cygwin from
16979 <A HREF="http://www.cygwin.com/">http://www.cygwin.com/</A> and
16980 then compile bogofilter in the cygwin environment, and run it from
16981 within PC-Alpine.
16982 You would end up with a Categorizer command that looked something like
16983 <P>
16984 <CENTER><SAMP>Command = C:&#92;cygwin&#92;bin&#92;bogofilter.exe -u</SAMP></CENTER>
16985 <P>
16986 Note that the &quot;.exe&quot; extension is explicit,
16987 and that the bogofilter.exe executable should be in the same directory
16988 as cygwin1.dll.
16989
16990 <P>
16991 &lt;End of help on this topic&gt;
16992 </BODY>
16993 </HTML>
16994 ======= h_config_role_cat_status =======
16995 <HTML>
16996 <HEAD>
16997 <TITLE>Exit Status Interval Explained</TITLE>
16998 </HEAD>
16999 <BODY>
17000 <H1>Exit Status Interval Explained</H1>
17001
17002 The categorizer command is run and the result is the exit status of
17003 that command.
17004 If that exit status falls in the Exit Status Interval
17005 then it is considered a match, otherwise it is not a match.
17006 Of course for the entire rule to match, it must also be checked against
17007 the other defined parts of the Pattern.
17008 <P>
17009 The Exit Status Interval defaults to the single value 0 (zero).
17010 If you define it, it should be set to something like:
17011 <P>
17012 <CENTER><SAMP>(min_exit_value,max_exit_value)</SAMP></CENTER>
17013 <P>
17014 where &quot;min_exit_value&quot; and &quot;max_exit_value&quot; are integers.
17015 The special values &quot;INF&quot; and &quot;-INF&quot; may be used for large
17016 positive and negative integers.
17017 <P>
17018 Actually, a list of intervals may be used if you wish.
17019 A list would look like
17020 <P>
17021 <CENTER><SAMP>(min_exit_value1,max_exit_value1),(min_exit_value2,max_exit_value2),...</SAMP></CENTER>
17022 <P>
17023 When there is an Exit Status Interval defined, it is a match if the exit status
17024 of the categorizer command is contained in any of the intervals.
17025 The intervals include both endpoints.
17026 <P>
17027 The default interval is
17028 <P>
17029 <CENTER><SAMP>(0,0)</SAMP></CENTER>
17030 <P>
17031 and it matches only if the command exits with exit status equal to zero.
17032
17033 <P>
17034 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17035 for more information on Patterns.
17036 <P>
17037 Look <A HREF="h_edit_nav_cmds">here</A>
17038 to see the available Editing and Navigation commands.
17039 <P>
17040 &lt;End of help on this topic&gt;
17041 </BODY>
17042 </HTML>
17043 ======= h_config_role_cat_limit =======
17044 <HTML>
17045 <HEAD>
17046 <TITLE>Character Limit Explained</TITLE>
17047 </HEAD>
17048 <BODY>
17049 <H1>Character Limit Explained</H1>
17050
17051 Setting this option makes it possible to limit how much of the message
17052 is made available to the categorizer command as input.
17053 The default value (-1) means that the entire message is fed to the
17054 command.
17055 A value of 0 (zero) means that only the headers of the message are
17056 made available.
17057 A positive integer means that the headers plus that many characters from
17058 the body of the message are passed to the categorizer.
17059
17060 <P>
17061 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17062 for more information on Patterns.
17063 <P>
17064 Look <A HREF="h_edit_nav_cmds">here</A>
17065 to see the available Editing and Navigation commands.
17066 <P>
17067 &lt;End of help on this topic&gt;
17068 </BODY>
17069 </HTML>
17070 ======= h_config_role_age =======
17071 <HTML>
17072 <HEAD>
17073 <TITLE>Age Interval Explained</TITLE>
17074 </HEAD>
17075 <BODY>
17076 <H1>Age Interval Explained</H1>
17077
17078 The Age Interval, if defined, is part of the Pattern.
17079 If you use this, it should be set to something like:
17080 <P>
17081 <CENTER><SAMP>(min_age,max_age)</SAMP></CENTER>
17082 <P>
17083 where &quot;min_age&quot; and &quot;max_age&quot; are non-negative integers.
17084 The special value &quot;INF&quot; may be used for the max value.
17085 It represents infinity.
17086 <P>
17087 In rare cases it may be useful to use the more general form of the value,
17088 which is a comma-separated list of intervals.
17089 It would look something like:
17090 <P>
17091 <CENTER><SAMP>(min_age1,max_age1),(min_age2,max_age2),...</SAMP></CENTER>
17092 <P>
17093 When there is an Age Interval defined, it is a match if the age, in days, of
17094 the message is contained in the interval.
17095 The interval includes both endpoints.
17096 If the option is set to a list of intervals then it is a match if the
17097 age of the message is contained in any of the intervals.
17098 <P>
17099 Even though this option is called Age, it isn't actually
17100 the <EM>age</EM> of the message.
17101 Instead, it is how many days ago the message arrived in one of your folders.
17102 If the current time is a little past midnight, then a message that arrived
17103 just before midnight arrived yesterday, even though the message is only
17104 a few minutes old.
17105 By default, the date being used is not the date in the Date
17106 header of the message.
17107 It is the date that the message arrived in one of your folders.
17108 When you Save a message from one folder to another that arrival date
17109 is preserved.
17110 If you would like to use the date in the Date header that is possible.
17111 Turn on the option
17112 <A HREF="h_config_filt_opts_sentdate">&quot;Use-Date-Header-For-Age&quot;</A>
17113 near the bottom of the rule definition.
17114 <P>
17115 A value of 0 is today, 1 is yesterday, 2 is the day before yesterday, and so on.
17116 The age interval
17117 <P>
17118 <CENTER><SAMP>(2,2)</SAMP></CENTER>
17119 <P>
17120 matches all messages that arrived on the day before yesterday.
17121 The interval
17122 <P>
17123 <CENTER><SAMP>(180,INF)</SAMP></CENTER>
17124 <P>
17125 matches all messages that arrived at least 180 days before today.
17126 The interval
17127 <P>
17128 <CENTER><SAMP>(0,1)</SAMP></CENTER>
17129 <P>
17130 matches all messages that arrived today or yesterday.
17131
17132 <P>
17133 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17134 for more information on Patterns.
17135 <P>
17136 Look <A HREF="h_edit_nav_cmds">here</A>
17137 to see the available Editing and Navigation commands.
17138 <P>
17139 &lt;End of help on this topic&gt;
17140 </BODY>
17141 </HTML>
17142 ======= h_config_role_size =======
17143 <HTML>
17144 <HEAD>
17145 <TITLE>Size Interval Explained</TITLE>
17146 </HEAD>
17147 <BODY>
17148 <H1>Size Interval Explained</H1>
17149
17150 The Size Interval, if defined, is part of the Pattern.
17151 If you use this, it should be set to something like:
17152 <P>
17153 <CENTER><SAMP>(min_size,max_size)</SAMP></CENTER>
17154 <P>
17155 where &quot;min_size&quot; and &quot;max_size&quot; are non-negative integers.
17156 The special value &quot;INF&quot; may be used for the max value.
17157 It represents infinity.
17158 <P>
17159 In rare cases it may be useful to use the more general form of the value,
17160 which is a comma-separated list of intervals.
17161 It would look something like:
17162 <P>
17163 <CENTER><SAMP>(min_size1,max_size1),(min_size2,max_size2),...</SAMP></CENTER>
17164 <P>
17165 When there is a Size Interval defined, it is a match if the size of
17166 the message is contained in the interval.
17167 The interval includes both endpoints.
17168 If the option is set to a list of intervals then it is a match if the
17169 size of the message is contained in any of the intervals.
17170 <P>
17171 The size interval
17172 <P>
17173 <CENTER><SAMP>(10000,50000)</SAMP></CENTER>
17174 <P>
17175 matches all messages with sizes greater than or equal to 10000, and less
17176 than or equal to 50000.
17177 The interval
17178 <P>
17179 <CENTER><SAMP>(100000,INF)</SAMP></CENTER>
17180 <P>
17181 matches all messages with sizes greater than or equal to 100000.
17182
17183 <P>
17184 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17185 for more information on Patterns.
17186 <P>
17187 Look <A HREF="h_edit_nav_cmds">here</A>
17188 to see the available Editing and Navigation commands.
17189 <P>
17190 &lt;End of help on this topic&gt;
17191 </BODY>
17192 </HTML>
17193 ======= h_config_role_scorei =======
17194 <HTML>
17195 <HEAD>
17196 <TITLE>Score Interval Explained</TITLE>
17197 </HEAD>
17198 <BODY>
17199 <H1>Score Interval Explained</H1>
17200
17201 The Score Interval, if defined, is part of the Pattern.
17202 If you use this, it should be set to something like:
17203 <P>
17204 <CENTER><SAMP>(min_score,max_score)</SAMP></CENTER>
17205 <P>
17206 where &quot;min_score&quot; and &quot;max_score&quot; are integers between
17207 -32000 and 32000.
17208 The special values &quot;-INF&quot; and &quot;INF&quot; may be used for
17209 the min and max values.
17210 These represent negative and positive infinity.
17211 <P>
17212 Actually, the value may be a list of intervals rather than just a
17213 single interval if that is useful.
17214 The elements of the list are separated by commas like:
17215 <P>
17216 <CENTER><SAMP>(min_score1,max_score1),(min_score2,max_score2),...</SAMP></CENTER>
17217 <P>
17218 When there is a Score Interval defined, it is a match if the score for
17219 the message is contained in any of the intervals.
17220 The intervals include both endpoints.
17221 The score for a message is calculated by looking at every scoring rule
17222 defined and adding up the Score Values for the rules that match the message.
17223 Scoring rules are created using the
17224 <A HREF="h_rules_score">&quot;SETUP SCORING&quot;</A> screen.
17225
17226 <P>
17227 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17228 for more information on Patterns.
17229 <P>
17230 Look <A HREF="h_edit_nav_cmds">here</A>
17231 to see the available Editing and Navigation commands.
17232 <P>
17233 &lt;End of help on this topic&gt;
17234 </BODY>
17235 </HTML>
17236 ======= h_config_role_fldr_type =======
17237 <HTML>
17238 <HEAD>
17239 <TITLE>Current Folder Type Explained</TITLE>
17240 </HEAD>
17241 <BODY>
17242 <H1>Current Folder Type Explained</H1>
17243
17244 The Current Folder Type is part of the role's Pattern.
17245 It refers to the type of the currently open folder, which is the folder
17246 you were last looking at from the MESSAGE INDEX or MESSAGE TEXT screen.
17247 In order for a role to be considered a match, the current folder must
17248 be of the type you set here.
17249 The three types &quot;Any&quot;, &quot;News&quot;, and &quot;Email&quot; are
17250 all what you might think.
17251 <P>
17252 If the Current Folder Type for a role's Pattern is set to &quot;News&quot;, for
17253 example, then
17254 that role will only be a match if the current folder is a newsgroup and
17255 the rest of the Pattern matches.
17256 The value &quot;Specific&quot; may be used when you want to limit the match
17257 to a specific folder (not just a specific type of folder), or to a list of
17258 specific folders.
17259 <P>
17260 In order to match a specific folder you Select the &quot;Specific&quot;
17261 button <EM>AND</EM> fill in
17262 the name (or list of names) of
17263 the folder in the &quot;Folder List&quot; field.
17264 If the current folder is any of the folders in the list, that is considered
17265 a match.
17266 The name of each folder in the list may be either &quot;INBOX&quot;,
17267 the technical specification
17268 of the folder (like what appears in your configuration file) or, if the
17269 folder is one of your incoming folders, it may be the nickname you've given
17270 the folder.
17271 Here are a couple samples of specific folder names:
17272 <P>
17273 <CENTER><SAMP>{monet.art.example.com}mail/art-class</SAMP></CENTER>
17274 <P>
17275 <CENTER><SAMP>{news.example.com/nntp}#news.comp.mail.pine</SAMP></CENTER>
17276 <P>
17277 The easiest way to fill in the &quot;Folder List&quot; field is to use
17278 the &quot;T&quot; command that is available when the &quot;Folder List&quot; line is
17279 highlighted, or to use the &quot;Take&quot; command with the configuration
17280 feature
17281 <A HREF="h_config_enable_role_take">&quot;<!--#echo var="FEAT_enable-rules-under-take"-->&quot;</A>
17282 turned on.
17283 Note that you won't be able to edit the &quot;Folder List&quot; line unless the
17284 Current Folder Type is set to &quot;Specific&quot;, and any value that
17285 &quot;Folder List&quot; has is ignored unless the type
17286 is set to &quot;Specific&quot;.
17287 <P>
17288 When reading a newsgroup, there may be a performance penalty
17289 incurred when collecting the information necessary to check a Pattern.
17290 For this reason, the default Current Folder Type is set to &quot;Email&quot;.
17291 <P>
17292 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17293 for more information on Patterns.
17294 <P>
17295 Look <A HREF="h_edit_nav_cmds">here</A>
17296 to see the available Editing and Navigation commands.
17297 <P>
17298 &lt;End of help on this topic&gt;
17299 </BODY>
17300 </HTML>
17301 ======= h_config_filt_rule_type =======
17302 <HTML>
17303 <HEAD>
17304 <TITLE>Filter Action Explained</TITLE>
17305 </HEAD>
17306 <BODY>
17307 <H1>Filter Action Explained</H1>
17308
17309 The Filter Action specifies the action to be taken when the Pattern is a
17310 match.
17311 It may be set to &quot;Delete&quot; &quot;Move&quot;, or
17312 &quot;Just Set Message Status&quot;.
17313 <P>
17314 If it is set to &quot;Delete&quot;, then the message that matches the
17315 Pattern will be deleted from the open folder.
17316 <P>
17317 If it is set to &quot;Move&quot;, then the name of the folder to which
17318 the matching message should be moved is given in the &quot;Folder List&quot; field on the
17319 next line of the screen.
17320 A list of folders separated by commas may be given, in which case the
17321 message will be copied to all of the folders in the list before it is
17322 deleted.
17323 <P>
17324 If it is set to neither of those two values (it is set to the value
17325 labeled &quot;Just Set Message Status&quot;) then the message status
17326 setting will happen
17327 but the message will not be deleted or moved.
17328 <P>
17329 If you are Moving a message you may also set Message Status if you wish.
17330 <P>
17331 The easiest way to fill in the &quot;Folder List&quot; field is to use
17332 the T command that is available when the &quot;Folder List&quot; line is
17333 highlighted.
17334 Note that you won't be able to edit the &quot;Folder List&quot; line unless the
17335 Filter Action is set to &quot;Move&quot;, and any value that
17336 &quot;Folder List&quot; has is ignored unless the type
17337 is set to &quot;Move&quot;.
17338 <P>
17339 There are a few tokens that may be used in the names in the Folder List.
17340 They are all related to the date on which the filtering is taking place.
17341 The tokens are words surrounded by underscores.
17342 For example, if you want your filter to move messages to a folder named
17343 <P><CENTER><SAMP>abc-year-mon</SAMP></CENTER><P>
17344 you could specify the folder as
17345 <P><CENTER><SAMP>abc-_CURYEAR_-_CURMONTHABBREV_</SAMP></CENTER><P>
17346 which would result in a file named something like
17347 <P><CENTER><SAMP>abc-2004-oct</SAMP></CENTER><P>
17348 or
17349 <P><CENTER><SAMP>abc-_CURYEAR2DIGIT_-_CURMONTH2DIGIT_</SAMP></CENTER><P>
17350 which would result in a file named something like
17351 <P><CENTER><SAMP>abc-04-10</SAMP></CENTER><P>
17352 The available tokens are listed
17353 <A HREF="h_index_tokens">here</A>.
17354 <P>
17355 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17356 for more information on Patterns.
17357 <P>
17358 Look <A HREF="h_edit_nav_cmds">here</A>
17359 to see the available Editing and Navigation commands.
17360 <P>
17361 &lt;End of help on this topic&gt;
17362 </BODY>
17363 </HTML>
17364 ======= h_config_score_fldr_type =======
17365 <HTML>
17366 <HEAD>
17367 <TITLE>Current Folder Type Explained</TITLE>
17368 </HEAD>
17369 <BODY>
17370 <H1>Current Folder Type Explained</H1>
17371
17372 The Current Folder Type is part of the scoring rule's Pattern.
17373 It refers to the type of the folder that
17374 the message being scored is in.
17375 In order for a rule to be considered a match, the current folder must
17376 be of the type you set here.
17377 The three types &quot;Any&quot;, &quot;News&quot;, and &quot;Email&quot; are
17378 all what you might think.
17379 <P>
17380 If the Current Folder Type for a Pattern is set to &quot;News&quot;, for
17381 example, then
17382 that Pattern will only match if the current folder is a newsgroup and
17383 the rest of the Pattern matches.
17384 The value &quot;Specific&quot; may be used when you want to limit the match
17385 to a specific folder (not just a specific type of folder), or to a list of
17386 specific folders.
17387 <P>
17388 In order to match a specific folder you Select the &quot;Specific&quot;
17389 button <EM>AND</EM> fill in
17390 the name (or list of names) of
17391 the folder in the &quot;Folder List&quot; field.
17392 If the current folder is any of the folders in the list, that is considered
17393 a match.
17394 The name of each folder in the list may be either &quot;INBOX&quot;, the technical specification
17395 of the folder (like what appears in your configuration file) or, if the
17396 folder is one of your incoming folders, it may be the nickname you've given
17397 the folder.
17398 Here are a couple samples of specific folder names:
17399 <P>
17400 <CENTER><SAMP>{monet.art.example.com}mail/art-class</SAMP></CENTER>
17401 <P>
17402 <CENTER><SAMP>{news.example.com/nntp}#news.comp.mail.pine</SAMP></CENTER>
17403 <P>
17404 The easiest way to fill in the &quot;Folder List&quot; field is to use
17405 the T command that is available when the &quot;Folder List&quot; line is
17406 highlighted.
17407 Note that you won't be able to edit the &quot;Folder List&quot; line unless the
17408 Current Folder Type is set to &quot;Specific&quot;, and any value that
17409 &quot;Folder List&quot; has is ignored unless the type
17410 is set to &quot;Specific&quot;.
17411 <P>
17412 When reading a newsgroup, there may be a performance penalty
17413 incurred when collecting the information necessary to check a Pattern.
17414 For this reason, the default Current Folder Type is set to &quot;Email&quot;.
17415 For example, if you have Index Line Coloring rules that have Score Intervals
17416 defined then the scores for all the visible messages will need to be calculated.
17417 If some of your Scoring rules have
17418 a Current Folder Type of
17419 &quot;Any&quot; or &quot;News&quot; this may cause the MESSAGE INDEX
17420 screen to draw more slowly when in a newsgroup.
17421 <P>
17422 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17423 for more information on Patterns.
17424 <P>
17425 Look <A HREF="h_edit_nav_cmds">here</A>
17426 to see the available Editing and Navigation commands.
17427 <P>
17428 &lt;End of help on this topic&gt;
17429 </BODY>
17430 </HTML>
17431 ======= h_config_other_fldr_type =======
17432 <HTML>
17433 <HEAD>
17434 <TITLE>Current Folder Type Explained</TITLE>
17435 </HEAD>
17436 <BODY>
17437 <H1>Current Folder Type Explained</H1>
17438
17439 The Current Folder Type is part of the rule's Pattern.
17440 It refers to the type of the folder being viewed.
17441 In order for a rule to be considered a match, the current folder must
17442 be of the type you set here.
17443 The three types &quot;Any&quot;, &quot;News&quot;, and &quot;Email&quot; are
17444 all what you might think.
17445 <P>
17446 If the Current Folder Type for a Pattern is set to &quot;News&quot;, for
17447 example, then
17448 that Pattern will only match if the current folder is a newsgroup.
17449 The value &quot;Specific&quot; may be used when you want to limit the match
17450 to a specific folder (not just a specific type of folder), or to a list of
17451 specific folders.
17452 <P>
17453 In order to match a specific folder you Select the &quot;Specific&quot;
17454 button <EM>AND</EM> fill in
17455 the name (or list of names) of
17456 the folder in the &quot;Folder List&quot; field.
17457 If the current folder is any of the folders in the list, that is considered
17458 a match.
17459 The name of each folder in the list may be either &quot;INBOX&quot;, the technical specification
17460 of the folder (like what appears in your configuration file) or, if the
17461 folder is one of your incoming folders, it may be the nickname you've given
17462 the folder.
17463 Here are a couple samples of specific folder names:
17464 <P>
17465 <CENTER><SAMP>{monet.art.example.com}mail/art-class</SAMP></CENTER>
17466 <P>
17467 <CENTER><SAMP>{news.example.com/nntp}#news.comp.mail.pine</SAMP></CENTER>
17468 <P>
17469 The easiest way to fill in the &quot;Folder List&quot; field is to use
17470 the T command that is available when the &quot;Folder List&quot; line is
17471 highlighted.
17472 Note that you won't be able to edit the &quot;Folder List&quot; line unless the
17473 Current Folder Type is set to &quot;Specific&quot;, and any value that
17474 &quot;Folder List&quot; has is ignored unless the type
17475 is set to &quot;Specific&quot;.
17476 <P>
17477 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17478 for more information on Patterns.
17479 <P>
17480 Look <A HREF="h_edit_nav_cmds">here</A>
17481 to see the available Editing and Navigation commands.
17482 <P>
17483 &lt;End of help on this topic&gt;
17484 </BODY>
17485 </HTML>
17486 ======= h_config_incol_fldr_type =======
17487 <HTML>
17488 <HEAD>
17489 <TITLE>Current Folder Type Explained</TITLE>
17490 </HEAD>
17491 <BODY>
17492 <H1>Current Folder Type Explained</H1>
17493
17494 The Current Folder Type is part of the Line Coloring rule's Pattern.
17495 It refers to the type of the folder for which the MESSAGE INDEX is
17496 being viewed.
17497 In order for a rule to be considered a match, the current folder must
17498 be of the type you set here.
17499 The three types &quot;Any&quot;, &quot;News&quot;, and &quot;Email&quot; are
17500 all what you might think.
17501 <P>
17502 If the Current Folder Type for a Pattern is set to &quot;News&quot;, for
17503 example, then
17504 that Pattern will only match if the current folder is a newsgroup and
17505 the rest of the Pattern matches.
17506 The value &quot;Specific&quot; may be used when you want to limit the match
17507 to a specific folder (not just a specific type of folder), or to a list of
17508 specific folders.
17509 <P>
17510 In order to match a specific folder you Select the &quot;Specific&quot;
17511 button <EM>AND</EM> fill in
17512 the name (or list of names) of
17513 the folder in the &quot;Folder List&quot; field.
17514 If the current folder is any of the folders in the list, that is considered
17515 a match.
17516 The name of each folder in the list may be either &quot;INBOX&quot;, the technical specification
17517 of the folder (like what appears in your configuration file) or, if the
17518 folder is one of your incoming folders, it may be the nickname you've given
17519 the folder.
17520 Here are a couple samples of specific folder names:
17521 <P>
17522 <CENTER><SAMP>{monet.art.example.com}mail/art-class</SAMP></CENTER>
17523 <P>
17524 <CENTER><SAMP>{news.example.com/nntp}#news.comp.mail.pine</SAMP></CENTER>
17525 <P>
17526 The easiest way to fill in the &quot;Folder List&quot; field is to use
17527 the T command that is available when the &quot;Folder List&quot; line is
17528 highlighted.
17529 Note that you won't be able to edit the &quot;Folder List&quot; line unless the
17530 Current Folder Type is set to &quot;Specific&quot;, and any value that
17531 &quot;Folder List&quot; has is ignored unless the type
17532 is set to &quot;Specific&quot;.
17533 <P>
17534 When reading a newsgroup, there may be a performance penalty
17535 incurred when collecting the information necessary to check a Pattern.
17536 For this reason, the default Current Folder Type is set to &quot;Email&quot;.
17537 For example, a rule with a non-Normal Index Line Color
17538 and a Current Folder Type of
17539 &quot;Any&quot; or &quot;News&quot; may cause the MESSAGE INDEX
17540 screen to draw more slowly when in a newsgroup.
17541 <P>
17542 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17543 for more information on Patterns.
17544 <P>
17545 Look <A HREF="h_edit_nav_cmds">here</A>
17546 to see the available Editing and Navigation commands.
17547 <P>
17548 &lt;End of help on this topic&gt;
17549 </BODY>
17550 </HTML>
17551 ======= h_config_filt_fldr_type =======
17552 <HTML>
17553 <HEAD>
17554 <TITLE>Current Folder Type Explained</TITLE>
17555 </HEAD>
17556 <BODY>
17557 <H1>Current Folder Type Explained</H1>
17558
17559 The Current Folder Type is part of the Filtering rule's Pattern.
17560 It refers to the type of the folder for which the filtering is being done.
17561 In order for a rule to be considered a match, the current folder must
17562 be of the type you set here.
17563 The three types &quot;Any&quot;, &quot;News&quot;, and &quot;Email&quot; are
17564 all what you might think.
17565 <P>
17566 If the Current Folder Type for a Pattern is set to &quot;News&quot;, for
17567 example, then
17568 that Pattern will only match if the current folder is a newsgroup and
17569 the rest of the Pattern matches.
17570 The value &quot;Specific&quot; may be used when you want to limit the match
17571 to a specific folder (not just a specific type of folder), or to a list of
17572 specific folders.
17573 <P>
17574 In order to match a specific folder you Select the &quot;Specific&quot;
17575 button <EM>AND</EM> fill in
17576 the name (or list of names) of
17577 the folder in the &quot;Folder List&quot; field.
17578 If the current folder is any of the folders in the list, that is considered
17579 a match.
17580 The name of each folder in the list may be either &quot;INBOX&quot;, the technical specification
17581 of the folder (like what appears in your configuration file) or, if the
17582 folder is one of your incoming folders, it may be the nickname you've given
17583 the folder.
17584 Here are a couple samples of specific folder names:
17585 <P>
17586 <CENTER><SAMP>{monet.art.example.com}mail/art-class</SAMP></CENTER>
17587 <P>
17588 <CENTER><SAMP>{news.example.com/nntp}#news.comp.mail.pine</SAMP></CENTER>
17589 <P>
17590 The easiest way to fill in the &quot;Folder List&quot; field is to use
17591 the T command that is available when the &quot;Folder List&quot; line is
17592 highlighted.
17593 Note that you won't be able to edit the &quot;Folder List&quot; line unless the
17594 Current Folder Type is set to &quot;Specific&quot;, and any value that
17595 &quot;Folder List&quot; has is ignored unless the type
17596 is set to &quot;Specific&quot;.
17597 <P>
17598 When reading a newsgroup, there may be a performance penalty
17599 incurred when collecting the information necessary to check a Pattern.
17600 For this reason, the default Current Folder Type is set to &quot;Email&quot;.
17601 For example, a rule with a Current Folder Type of either
17602 &quot;Any&quot; or &quot;News&quot; may cause the filtering to happen
17603 more slowly when opening a newsgroup.
17604 <P>
17605 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17606 for more information on Patterns.
17607 <P>
17608 Look <A HREF="h_edit_nav_cmds">here</A>
17609 to see the available Editing and Navigation commands.
17610 <P>
17611 &lt;End of help on this topic&gt;
17612 </BODY>
17613 </HTML>
17614 ======= h_config_role_stat_imp =======
17615 <HTML>
17616 <HEAD>
17617 <TITLE>Message Important Status Explained</TITLE>
17618 </HEAD>
17619 <BODY>
17620 <H1>Message Important Status Explained</H1>
17621
17622 This part of the Pattern may have one of three possible values.
17623 The default value is &quot;Don't care&quot;, which matches any message.
17624 The other two values are &quot;Yes&quot;, which means the message must be
17625 flagged &quot;Important&quot; in order to be a match; or &quot;No&quot;, which
17626 means the message must <EM>not</EM> be flagged &quot;Important&quot; in order
17627 to be a match.
17628 <P>
17629 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17630 for more information on Patterns.
17631 <P>
17632 Look <A HREF="h_edit_nav_cmds">here</A>
17633 to see the available Editing and Navigation commands.
17634 <P>
17635 &lt;End of help on this topic&gt;
17636 </BODY>
17637 </HTML>
17638 ======= h_config_role_stat_new =======
17639 <HTML>
17640 <HEAD>
17641 <TITLE>Message New Status Explained</TITLE>
17642 </HEAD>
17643 <BODY>
17644 <H1>Message New Status Explained</H1>
17645
17646 This part of the Pattern may have one of three possible values.
17647 The default value is &quot;Don't care&quot;, which matches any message.
17648 The other two values are &quot;Yes&quot;, which means the message must be
17649 &quot;New&quot; in order to be a match; or &quot;No&quot;, which
17650 means the message must <EM>not</EM> be &quot;New&quot; in order
17651 to be a match.
17652 &quot;New&quot; is the same as <EM>Unseen</EM> and not &quot;New&quot; is the
17653 same as <EM>Seen</EM>.
17654 <P>
17655 The nomenclature for New and Recent is a bit confusing:
17656 <P>
17657 New means that the message is Unseen.
17658 It could have been in your mailbox for a long time but if you haven't looked
17659 at it, it is still considered New.
17660 That matches the default Alpine index display that shows an N for such a
17661 message.
17662 <P>
17663 Recent means that the message was added to this folder since the last time
17664 you opened the folder.
17665 Alpine also shows an N by default for these types of messages.
17666 If you were to run two copies of Alpine that opened a folder one right after
17667 the other, a message would only show up as Recent in (at most) the first
17668 Alpine session.
17669 <P>
17670 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17671 for more information on Patterns.
17672 <P>
17673 Look <A HREF="h_edit_nav_cmds">here</A>
17674 to see the available Editing and Navigation commands.
17675 <P>
17676 &lt;End of help on this topic&gt;
17677 </BODY>
17678 </HTML>
17679 ======= h_config_role_stat_recent =======
17680 <HTML>
17681 <HEAD>
17682 <TITLE>Message Recent Status Explained</TITLE>
17683 </HEAD>
17684 <BODY>
17685 <H1>Message Recent Status Explained</H1>
17686
17687 This part of the Pattern may have one of three possible values.
17688 The default value is &quot;Don't care&quot;, which matches any message.
17689 The other two values are &quot;Yes&quot;, which means the message must be
17690 &quot;Recent&quot; in order to be a match; or &quot;No&quot;, which
17691 means the message must <EM>not</EM> be &quot;Recent&quot; in order
17692 to be a match.
17693 &quot;Recent&quot; means that the message was added to the folder since
17694 the last time the folder was opened.
17695 If more than one mail client has the folder opened, the message will
17696 appear to be &quot;Recent&quot; to only one of the clients.
17697 <P>
17698 The nomenclature for New and Recent is a bit confusing:
17699 <P>
17700 New means that the message is Unseen.
17701 It could have been in your mailbox for a long time but if you haven't looked
17702 at it, it is still considered New.
17703 That matches the default Alpine index display that shows an N for such a
17704 message.
17705 <P>
17706 Recent means that the message was added to this folder since the last time
17707 you opened the folder.
17708 Alpine also shows an N by default for these types of messages.
17709 If you were to run two copies of Alpine that opened a folder one right after
17710 the other, a message would only show up as Recent in (at most) the first
17711 Alpine session.
17712 <P>
17713 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17714 for more information on Patterns.
17715 <P>
17716 Look <A HREF="h_edit_nav_cmds">here</A>
17717 to see the available Editing and Navigation commands.
17718 <P>
17719 &lt;End of help on this topic&gt;
17720 </BODY>
17721 </HTML>
17722 ======= h_config_role_stat_del =======
17723 <HTML>
17724 <HEAD>
17725 <TITLE>Message Deleted Status Explained</TITLE>
17726 </HEAD>
17727 <BODY>
17728 <H1>Message Deleted Status Explained</H1>
17729
17730 This part of the Pattern may have one of three possible values.
17731 The default value is &quot;Don't care&quot;, which matches any message.
17732 The other two values are &quot;Yes&quot;, which means the message must be
17733 marked &quot;Deleted&quot; in order to be a match; or &quot;No&quot;, which
17734 means the message must <EM>not</EM> be marked &quot;Deleted&quot; in order
17735 to be a match.
17736 <P>
17737 If you are thinking of using this part of the Pattern as a way to prevent
17738 messages from being filtered more than once in a Filter Pattern,
17739 take a look at the Filter Option
17740 <A HREF="h_config_filt_opts_notdel">&quot;Move-Only-if-Not-Deleted&quot;</A>
17741 instead.
17742 It should work better than using this field since it will hide the filtered
17743 messages even if they are already Deleted.
17744 That option is at the bottom of the Filter configuration screen.
17745 <P>
17746 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17747 for more information on Patterns.
17748 <P>
17749 Look <A HREF="h_edit_nav_cmds">here</A>
17750 to see the available Editing and Navigation commands.
17751 <P>
17752 &lt;End of help on this topic&gt;
17753 </BODY>
17754 </HTML>
17755 ======= h_config_role_stat_ans =======
17756 <HTML>
17757 <HEAD>
17758 <TITLE>Message Answered Status Explained</TITLE>
17759 </HEAD>
17760 <BODY>
17761 <H1>Message Answered Status Explained</H1>
17762
17763 This part of the Pattern may have one of three possible values.
17764 The default value is &quot;Don't care&quot;, which matches any message.
17765 The other two values are &quot;Yes&quot;, which means the message must be
17766 marked &quot;Answered&quot; in order to be a match; or &quot;No&quot;, which
17767 means the message must <EM>not</EM> be marked &quot;Answered&quot; in order
17768 to be a match.
17769 <P>
17770 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17771 for more information on Patterns.
17772 <P>
17773 Look <A HREF="h_edit_nav_cmds">here</A>
17774 to see the available Editing and Navigation commands.
17775 <P>
17776 &lt;End of help on this topic&gt;
17777 </BODY>
17778 </HTML>
17779 ======= h_config_role_abookfrom =======
17780 <HTML>
17781 <HEAD>
17782 <TITLE>Address in Address Book Explained</TITLE>
17783 </HEAD>
17784 <BODY>
17785 <H1>Address in Address Book Explained</H1>
17786
17787 This option gives you a way to match messages that contain an address
17788 that is in one of your address books.
17789 Only the simple entries in your address books are searched.
17790 Address book distribution lists are ignored!
17791 <P>
17792 This part of the Pattern may have one of five possible values.
17793 The default value is &quot;Don't care&quot;, which matches any message.
17794 The value &quot;Yes, in any address book&quot; means at least one of the addresses
17795 from the message must be in at least one of your
17796 address books in order to be a match.
17797 The value &quot;No, not in any address book&quot;
17798 means none of the addresses may
17799 be in any of your address books in order to be a match.
17800 <P>
17801 The values &quot;Yes, in specific address books&quot; and
17802 &quot;No, not in any of specific address books&quot; are similar but instead
17803 of depending on all address books you are allowed to give a list of address
17804 books to look in.
17805 Usually this would be a single address book but it may be a
17806 list of address books as well.
17807 For each of these &quot;specific&quot; address book options you Select which
17808 of the Specific options you want (Yes or No) <EM>AND</EM> fill in the
17809 name (or list of names) of the address book in the
17810 &quot;Abook List&quot; field.
17811 The names to be used are those that appear in the ADDRESS BOOK LIST screen.
17812 The easiest way to fill in the Abook List field it to use
17813 the &quot;T&quot; command that is available when the &quot;Abook List&quot;
17814 line is highlighted.
17815 Note that you won't be able to edit the &quot;Abook List&quot; line unless the
17816 option is set to one of the two &quot;Specific&quot;, values.
17817 <P>
17818 The addresses from the message that are checked for are determined by the
17819 setting you have for &quot;Types of addresses to check for in address book&quot;.
17820 If you set this to &quot;From&quot; the From address from the message will
17821 be looked up in the address book.
17822 If you set it to &quot;To&quot; instead then the To addresses will be used.
17823 If any of the To addresses are in the address book then it is considered
17824 a match for &quot;Yes&quot; or not a match for &quot;No&quot;.
17825 You could set it to both From and To, in which case all of the From and To
17826 addresses are used.
17827 The &quot;Reply-To&quot; and &quot;Sender&quot; cases are a little unusual.
17828 Due to deficiencies in our tools, Reply-To uses the Reply-To address if it
17829 exists or the From address if there is no Reply-To address.
17830 Same for the Sender address.
17831 <P>
17832 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17833 for more information on Patterns.
17834 <P>
17835 Look <A HREF="h_edit_nav_cmds">here</A>
17836 to see the available Editing and Navigation commands.
17837 <P>
17838 &lt;End of help on this topic&gt;
17839 </BODY>
17840 </HTML>
17841 ======= h_config_inabook_from =======
17842 <HTML>
17843 <HEAD>
17844 <TITLE>From</TITLE>
17845 </HEAD>
17846 <BODY>
17847 <H1>From</H1>
17848
17849 Setting the From line will cause the address from the From header line
17850 of the message to be checked for in the address book.
17851 <P>
17852 &lt;End of help on this topic&gt;
17853 </BODY>
17854 </HTML>
17855 ======= h_config_inabook_replyto =======
17856 <HTML>
17857 <HEAD>
17858 <TITLE>Reply-To</TITLE>
17859 </HEAD>
17860 <BODY>
17861 <H1>Reply-To</H1>
17862
17863 Setting the Reply-To line will cause the address from the Reply-To header line
17864 of the message to be checked for in the address book.
17865 However, if there is no Reply-To header line in the message the From header
17866 line will be used instead.
17867 We understand this is dumb but we don't have an easy way around it.
17868 <P>
17869 &lt;End of help on this topic&gt;
17870 </BODY>
17871 </HTML>
17872 ======= h_config_inabook_sender =======
17873 <HTML>
17874 <HEAD>
17875 <TITLE>Sender</TITLE>
17876 </HEAD>
17877 <BODY>
17878 <H1>Sender</H1>
17879
17880 Setting the Sender line will cause the address from the Sender header line
17881 of the message to be checked for in the address book.
17882 However, if there is no Sender header line in the message the From header
17883 line will be used instead.
17884 We understand this is dumb but we don't have an easy way around it.
17885 <P>
17886 &lt;End of help on this topic&gt;
17887 </BODY>
17888 </HTML>
17889 ======= h_config_inabook_to =======
17890 <HTML>
17891 <HEAD>
17892 <TITLE>To</TITLE>
17893 </HEAD>
17894 <BODY>
17895 <H1>To</H1>
17896
17897 Setting the To line will cause the address from the To header line
17898 of the message to be checked for in the address book.
17899 <P>
17900 &lt;End of help on this topic&gt;
17901 </BODY>
17902 </HTML>
17903 ======= h_config_inabook_cc =======
17904 <HTML>
17905 <HEAD>
17906 <TITLE>CC</TITLE>
17907 </HEAD>
17908 <BODY>
17909 <H1>CC</H1>
17910
17911 Setting the CC line will cause the address from the CC header line
17912 of the message to be checked for in the address book.
17913 <P>
17914 &lt;End of help on this topic&gt;
17915 </BODY>
17916 </HTML>
17917 ======= h_config_role_stat_8bitsubj =======
17918 <HTML>
17919 <HEAD>
17920 <TITLE>Raw 8-bit in Subject Explained</TITLE>
17921 </HEAD>
17922 <BODY>
17923 <H1>Raw 8-bit in Subject Explained</H1>
17924
17925 It seems that lots of unwanted email contains unencoded 8-bit characters
17926 in the Subject.
17927 Normally, characters with the 8th bit set are not allowed in the Subject
17928 header unless they are MIME-encoded.
17929 This option gives you a way to match messages that have Subjects that
17930 contain unencoded 8-bit characters.
17931 <P>
17932 This part of the Pattern may have one of three possible values.
17933 The default value is &quot;Don't care&quot;, which matches any message.
17934 The other two values are &quot;Yes&quot;, which means the Subject of
17935 the message must contain unencoded 8-bit characters (characters with the
17936 most significant bit set)
17937 in order to be a match; or &quot;No&quot;, which
17938 means the Subject must <EM>not</EM>
17939 contain unencoded 8-bit characters in order to be a match.
17940 <P>
17941 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17942 for more information on Patterns.
17943 <P>
17944 Look <A HREF="h_edit_nav_cmds">here</A>
17945 to see the available Editing and Navigation commands.
17946 <P>
17947 &lt;End of help on this topic&gt;
17948 </BODY>
17949 </HTML>
17950 ======= h_config_role_bom =======
17951 <HTML>
17952 <HEAD>
17953 <TITLE>Beginning of Month</TITLE>
17954 </HEAD>
17955 <BODY>
17956 <H1>Beginning of Month</H1>
17957
17958 This option gives you a limited ability to take different actions depending on whether
17959 this is the first time Alpine has been run this month or not.
17960 Though it would be nice to have such an option available, this is not the
17961 same as whether or not this is the first time a paricular folder has been
17962 opened this month.
17963 If you want some action (probably Filtering) to take place in a folder each
17964 month, then you will need to be sure that the folder is opened during the
17965 first Alpine session of the month in order for this option to be helpful.
17966 <P>
17967 This part of the Pattern may have one of three possible values.
17968 The default value is &quot;Don't care&quot;, which matches any message.
17969 The other two values are &quot;Yes&quot;, which means this is the first
17970 time Alpine has been run this month;
17971 or &quot;No&quot;, which
17972 means this is not the first time Alpine has been run this month.
17973 <P>
17974 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17975 for more information on Patterns.
17976 <P>
17977 Here are some technical details.
17978 The way that Alpine decides if it is the beginning of the month or not is
17979 to compare today's date with the date stored in the
17980 <A HREF="h_config_prune_date"><!--#echo var="VAR_last-time-prune-questioned"--></A>
17981 variable in the config file.
17982 If the month of today's date is later than the month stored in the variable,
17983 then this is considered to be the first time you have run Alpine this month, and
17984 that turns the Beginning of the Month option on.
17985 <P>
17986 Look <A HREF="h_edit_nav_cmds">here</A>
17987 to see the available Editing and Navigation commands.
17988 <P>
17989 &lt;End of help on this topic&gt;
17990 </BODY>
17991 </HTML>
17992 ======= h_config_role_boy =======
17993 <HTML>
17994 <HEAD>
17995 <TITLE>Beginning of Year</TITLE>
17996 </HEAD>
17997 <BODY>
17998 <H1>Beginning of Year</H1>
17999
18000 This option gives you a limited ability to take different actions depending on whether
18001 this is the first time Alpine has been run this year or not.
18002 Though it would be nice to have such an option available, this is not the
18003 same as whether or not this is the first time a paricular folder has been
18004 opened this year.
18005 If you want some action (probably Filtering) to take place in a folder each
18006 year, then you will need to be sure that the folder is opened during the
18007 first Alpine session of the year in order for this option to be helpful.
18008 <P>
18009 This part of the Pattern may have one of three possible values.
18010 The default value is &quot;Don't care&quot;, which matches any message.
18011 The other two values are &quot;Yes&quot;, which means this is the first
18012 time Alpine has been run this year;
18013 or &quot;No&quot;, which
18014 means this is not the first time Alpine has been run this year.
18015 <P>
18016 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18017 for more information on Patterns.
18018 <P>
18019 Here are some technical details.
18020 The way that Alpine decides if it is the beginning of the year or not is
18021 to compare today's date with the date stored in the
18022 <A HREF="h_config_prune_date"><!--#echo var="VAR_last-time-prune-questioned"--></A>
18023 variable in the config file.
18024 If the year of today's date is later than the year stored in the variable,
18025 then this is considered to be the first time you have run Alpine this year, and
18026 that turns the Beginning of the Year option on.
18027 <P>
18028 Look <A HREF="h_edit_nav_cmds">here</A>
18029 to see the available Editing and Navigation commands.
18030 <P>
18031 &lt;End of help on this topic&gt;
18032 </BODY>
18033 </HTML>
18034 ======= h_config_role_inick =======
18035 <HTML>
18036 <HEAD>
18037 <TITLE>Initialize Values From Role Explained</TITLE>
18038 </HEAD>
18039 <BODY>
18040 <H1>Initialize Values From Role Explained</H1>
18041
18042 This is a power user feature.
18043 You will usually want to leave this field empty.
18044 The value of this field is the nickname of another one of your roles.
18045 The Action values from that other role
18046 are used as the initial values of the Action items for this role.
18047 If you put something in any of the action fields for this role, that will
18048 override whatever was in the corresponding field of the initializer role.
18049 <P>
18050 You might use this field if the &quot;Action&quot; part of one of your roles
18051 is something you want to use in more than one role.
18052 Instead of filling in those action values again for each role, you
18053 may give the nickname of the role where the values are filled in.
18054 It's just a shortcut way to define Role Actions.
18055 <P>
18056 Here's an example to help explain how this works.
18057 Suppose you have a role with nickname &quot;role1&quot; and role1 has
18058 (among other things)
18059 <P>
18060 <CENTER><SAMP>Set Reply-To = The Pres &lt;president@example.com&gt;</SAMP></CENTER>
18061 <P>
18062 set.
18063 If in &quot;role2&quot; you set &quot;Initialize settings using role&quot; to
18064 &quot;role1&quot;, then role2 will inherit the Set Reply-To value
18065 from role1 by default (and any of the other inheritable action values
18066 that are set).
18067 So if role2 had
18068 <P>
18069 <CENTER><SAMP>Set Reply-To = &lt;No Value Set&gt;</SAMP></CENTER>
18070 <P>
18071 defined, the Reply-To used with role2 would be &quot;The Pres &lt;president@example.com&gt;&quot;
18072 However, if role2 had
18073 <P>
18074 <CENTER><SAMP>Set Reply-To = VP &lt;vicepresident@example.com&gt;</SAMP></CENTER>
18075 <P>
18076 defined, then the Reply-To used with role2 would be &quot;VP &lt;vicepresident@example.com&gt;&quot; instead.
18077 <P>
18078 If you wish,
18079 you may choose a nickname from your list of roles by using the
18080 &quot;T&quot; command.
18081 If the role you are using to initialize also has a role it initializes from,
18082 then that initialization happens first.
18083 That is, inheritance works as expected with the grandparent and
18084 great-grandparent (and so on) roles having the expected effect.
18085 <P>
18086 Look <A HREF="h_edit_nav_cmds">here</A>
18087 to see the available Editing and Navigation commands.
18088 <P>
18089 &lt;End of help on this topic&gt;
18090 </BODY>
18091 </HTML>
18092 ======= h_config_role_setfrom =======
18093 <HTML>
18094 <HEAD>
18095 <TITLE>Set From Explained</TITLE>
18096 </HEAD>
18097 <BODY>
18098 <H1>Set From Explained</H1>
18099
18100 This describes part of the action to be taken if the Pattern for this
18101 role is a match.
18102 This field consists of a single address that will be used as the From
18103 address on the message you are sending.
18104 This should be a fully-qualified address like
18105 <P>
18106 <CENTER><SAMP>Full Name &lt;user@domain&gt;</SAMP></CENTER>
18107 <P>
18108 or just
18109 <P>
18110 <CENTER><SAMP>user@domain</SAMP></CENTER>
18111 <P>
18112 If you wish,
18113 you may choose an address from your address book with the
18114 &quot;T&quot; command.
18115 <P>
18116 If this is left blank, then your normal From address will be used.
18117 <P>
18118 You may also find it useful to add the changed From address to the
18119 <a href="h_config_alt_addresses"><!--#echo var="VAR_alt-addresses"--></a>
18120 configuration option.
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_setreplyto =======
18129 <HTML>
18130 <HEAD>
18131 <TITLE>Set Reply-To Explained</TITLE>
18132 </HEAD>
18133 <BODY>
18134 <H1>Set Reply-To 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 Reply-To
18139 address on the message you are sending.
18140 This may 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 there won't be a Reply-To address unless
18153 you have configured one specially with the
18154 "<A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A>"
18155 configuration option.
18156 <P>
18157 Look <A HREF="h_edit_nav_cmds">here</A>
18158 to see the available Editing and Navigation commands.
18159 <P>
18160 &lt;End of help on this topic&gt;
18161 </BODY>
18162 </HTML>
18163 ======= h_config_role_setfcc =======
18164 <HTML>
18165 <HEAD>
18166 <TITLE>Set Fcc Explained</TITLE>
18167 </HEAD>
18168 <BODY>
18169 <H1>Set Fcc Explained</H1>
18170
18171 This describes part of the action to be taken if the Pattern for this
18172 role is a match.
18173 This field consists of a single folder name that will be used in
18174 the Fcc field of the message you are sending.
18175 You may put anything here that you would normally type into the Fcc
18176 field from the composer.
18177 <P>
18178 In addition, an fcc of &quot;&quot; (two double quotation marks) means
18179 no Fcc.
18180 <P>
18181 A blank field here means that Alpine will use its normal rules for deciding
18182 the default value of the Fcc field.
18183 For many roles, perhaps most, it may make more sense for you to use the
18184 other Alpine facilities for setting the Fcc.
18185 In particular, if you want the Fcc to depend on who you are sending the
18186 message to then the <A HREF="h_config_fcc_rule">&quot;<!--#echo var="VAR_fcc-name-rule"-->&quot;</A>
18187 is probably more useful.
18188 In that case, you would want to leave the Fcc field here blank.
18189 However, if you have a role that depends on who the message you are replying
18190 to was From, or what address that message was sent to;
18191 then it might make sense to set the Fcc for that role here.
18192 <P>
18193 If you wish,
18194 you may choose a folder from your folder collections by using the
18195 &quot;T&quot; command.
18196 <P>
18197 Look <A HREF="h_edit_nav_cmds">here</A>
18198 to see the available Editing and Navigation commands.
18199 <P>
18200 &lt;End of help on this topic&gt;
18201 </BODY>
18202 </HTML>
18203 ======= h_config_role_usesmtp =======
18204 <HTML>
18205 <HEAD>
18206 <TITLE>Use SMTP Server Explained</TITLE>
18207 </HEAD>
18208 <BODY>
18209 <H1>Use SMTP Server Explained</H1>
18210
18211 This describes part of the action to be taken if the Pattern for this
18212 role is a match.
18213 If this field has a value, then it will be used as the SMTP server
18214 to send mail when this role is being used (unless the SMTP server variable
18215 is set in the system-wide fixed configuration file).
18216 It has the same semantics as the
18217 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>
18218 variable in the Setup/Config screen.
18219 <P>
18220 If you are using this to post from home when you are at home and from
18221 work when you are at work you need to be careful about postponing messages.
18222 When you postpone a composition that was using a role with this variable
18223 set, the SMTP server list will be saved
18224 with the postponed composition.
18225 It cannot be changed later.
18226 Because of this, you may want to make this a list of SMTP servers
18227 with the preferred server at the front of the list and alternate servers
18228 later in the list.
18229 In your &quot;Home&quot; role you would put the home SMTP server first and
18230 the work SMTP server last.
18231 In your &quot;Work&quot; role you would put the work SMTP server first and
18232 the home SMTP server last.
18233 Then if you start a composition as &quot;Work&quot;, postpone
18234 it, and then later resume it from home the work SMTP server will fail but
18235 the home SMTP server later in the list will succeed.
18236 <P>
18237 You may be able to simplify things by making the regular
18238 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>
18239 variable in the Setup/Config screen a list instead of using roles
18240 to set the SMTP server.
18241
18242 <P>
18243 Look <A HREF="h_edit_nav_cmds">here</A>
18244 to see the available Editing and Navigation commands.
18245 <P>
18246 &lt;End of help on this topic&gt;
18247 </BODY>
18248 </HTML>
18249 ======= h_config_role_usenntp =======
18250 <HTML>
18251 <HEAD>
18252 <TITLE>Use NNTP Server Explained</TITLE>
18253 </HEAD>
18254 <BODY>
18255 <H1>Use NNTP Server Explained</H1>
18256
18257 This describes part of the action to be taken if the Pattern for this
18258 role is a match.
18259 If this field has a value, then it will be used as the NNTP server
18260 to post to newsgroups when this role is being used (unless the NNTP server
18261 variable
18262 is set in the system-wide fixed configuration file).
18263 It has the same semantics as the
18264 <A HREF="h_config_nntp_server">&quot;<!--#echo var="VAR_nntp-server"-->&quot;</A>
18265 variable in the Setup/Config screen.
18266 <P>
18267 This role setting can facilitate posting to the right nntp server for someone
18268 who reads news from various news sources.  The feature
18269 <A HREF="h_config_predict_nntp_server">&quot;<!--#echo var="FEAT_predict-nntp-server"-->&quot;</A>
18270 allows for setting the correct <!--#echo var="VAR_nntp-server"--> without having to individually
18271 set a role for that <!--#echo var="VAR_nntp-server"-->, but for greater flexibility, setting
18272 nntp servers for roles may be more desirable for some people.
18273 <P>
18274 If you are using this to post from home when you are at home and from
18275 work when you are at work you need to be careful about postponing messages.
18276 When you postpone a composition that was using a role with this variable
18277 set, the NNTP server list will be saved
18278 with the postponed composition.
18279 It cannot be changed later.
18280 Because of this, you may want to make this a list of NNTP servers
18281 with the preferred server at the front of the list and alternate servers
18282 later in the list.
18283 In your &quot;Home&quot; role you would put the home NNTP server first and
18284 the work NNTP server last.
18285 In your &quot;Work&quot; role you would put the work NNTP server first and
18286 the home NNTP server last.
18287 Then if you start a composition as &quot;Work&quot;, postpone
18288 it, and then later resume it from home the work NNTP server will fail but
18289 the home NNTP server later in the list will succeed.
18290 <P>
18291 You may be able to simplify things by making the regular
18292 <A HREF="h_config_nntp_server">&quot;<!--#echo var="VAR_nntp-server"-->&quot;</A>
18293 variable in the Setup/Config screen a list instead of using roles
18294 to set the NNTP server.
18295
18296 <P>
18297 Look <A HREF="h_edit_nav_cmds">here</A>
18298 to see the available Editing and Navigation commands.
18299 <P>
18300 &lt;End of help on this topic&gt;
18301 </BODY>
18302 </HTML>
18303 ======= h_config_role_setotherhdr =======
18304 <HTML>
18305 <HEAD>
18306 <TITLE>Set Other Headers Explained</TITLE>
18307 </HEAD>
18308 <BODY>
18309 <H1>Set Other Headers Explained</H1>
18310
18311 This describes part of the action to be taken if the Pattern for this
18312 role is a match.
18313 This field gives you a way to set values for headers besides
18314 &quot;From&quot; and &quot;Reply-To&quot;.
18315 If you want to set either of those, use the specific
18316 &quot;Set From&quot; and &quot;Set Reply-To&quot; settings above.
18317 <P>
18318 This field is similar to the
18319 "<A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A>" option.
18320 Each header you specify here must include the header tag
18321 (&quot;To:&quot;, &quot;Approved:&quot;, etc.)
18322 and may optionally include a value for that header.
18323 In order to see these headers when you compose using this role you
18324 must use the rich header
18325 <!--chtml if pinemode="function_key"-->(F5)
18326 <!--chtml else-->(Ctrl-R)<!--chtml endif--> command.
18327 Here's an example that shows how you might set the To address.
18328 <P>
18329 <CENTER><SAMP>Set Other Hdrs = To: Full Name &lt;user@domain&gt;</SAMP></CENTER>
18330 <P>
18331 Headers set in this way are different from headers set with the
18332 <!--#echo var="VAR_customized-hdrs"--> option in that the value you give for a header here
18333 will replace any value that already exists.
18334 For example, if you are Replying to a message there will already be at
18335 least one address in the To header (the address you are Replying to).
18336 However, if you Reply using a role that sets the To header, that role's
18337 To header value will be used instead.
18338 <P>
18339 Limitation: Because commas are used to separate the list of
18340 Other Headers, it is not possible to have the value of a
18341 header contain a comma;
18342 nor is there currently an &quot;escape&quot; mechanism provided
18343 to make this work.
18344 <P>
18345 Look <A HREF="h_edit_nav_cmds">here</A>
18346 to see the available Editing and Navigation commands.
18347 <P>
18348 &lt;End of help on this topic&gt;
18349 </BODY>
18350 </HTML>
18351 ======= h_config_role_setlitsig =======
18352 <HTML>
18353 <HEAD>
18354 <TITLE>Set Literal Signature Explained</TITLE>
18355 </HEAD>
18356 <BODY>
18357 <H1>Set Literal Signature Explained</H1>
18358
18359 This describes part of the action to be taken if the Pattern for this
18360 role is a match.
18361 This field contains the actual text for your signature, as opposed to
18362 the name of a file containing your signature.
18363 If this is defined it takes precedence over any value set in the
18364 &quot;Set Signature&quot; field.
18365 <P>
18366 This is simply a different way to store the signature.
18367 The signature is stored inside your Alpine configuration file instead of in
18368 a separate file.
18369 Tokens work the same way they do with
18370 <A HREF="h_config_role_setsig">Set Signature</A>, so refer to the
18371 help text there for more information.
18372 <P>
18373
18374 The two character sequence &#92;n (backslash followed by
18375 the character n) will be used to signify a line-break in your signature.
18376 You don't have to enter the &#92;n, but it will be visible in the
18377 CHANGE THIS ROLE RULE window after you are done editing the signature.
18378 <P>
18379 Look <A HREF="h_edit_nav_cmds">here</A>
18380 to see the available Editing and Navigation commands.
18381 <P>
18382 &lt;End of help on this topic&gt;
18383 </BODY>
18384 </HTML>
18385 ======= h_config_role_setsig =======
18386 <HTML>
18387 <HEAD>
18388 <TITLE>Set Signature Explained</TITLE>
18389 </HEAD>
18390 <BODY>
18391 <H1>Set Signature Explained</H1>
18392
18393 This describes part of the action to be taken if the Pattern for this
18394 role is a match.
18395 <P>
18396 If either the default <A HREF="h_config_literal_sig"><!--#echo var="VAR_literal-signature"--></A>
18397 option from Setup/Config
18398 or the &quot;Set LiteralSig&quot; option for this role are defined,
18399 then this option will be ignored.
18400 You can tell that that is the case because the value of this
18401 option will show up as
18402 <P>
18403 <CENTER><SAMP>&lt;Ignored: using LiteralSig instead&gt;</SAMP></CENTER>
18404 <P>
18405 You may either use all Literal Signatures (signatures stored in your
18406 configuration file) throughout Alpine, or all signature files.
18407 You can't mix the two.
18408 <P>
18409 This field consists of a filename that will be used as the signature
18410 file when using this role.
18411 <P>
18412 If the filename is followed by a vertical bar (|) then instead
18413 of reading the contents of the file the file is assumed to be a
18414 program that will produce the text to be used on its standard output.
18415 The program can't have any arguments and doesn't receive any input from Alpine,
18416 but the rest of the processing works as if the contents came from a file.
18417 <P>
18418 Instead of storing the data in a local file, the
18419 signature data may be stored remotely in an IMAP folder.
18420 In order to do this,
18421 you must use a remote name for the signature.
18422 A remote signature name might look like:
18423 <P>
18424 <CENTER><SAMP>{myimaphost.myschool.k12.wa.us}mail/sig3</SAMP></CENTER>
18425 <P>
18426
18427 The syntax used here is the same as the syntax used for a remote
18428 <A HREF="h_config_signature_file"><!--#echo var="VAR_signature-file"--></A>.
18429 Note that you may not access an existing signature file remotely,
18430 you have to create a new <EM>folder</EM> that contains the signature data.
18431 If the name you use here for the signature data is a remote name, then when
18432 you edit the file using the &quot;F&quot; command the data will
18433 be saved remotely in the folder.
18434 You aren't required to do anything special to create the folder, it
18435 gets created if you use a remote name.
18436
18437 <P>
18438 If you type &quot;F&quot; you may edit the contents of the file (as opposed to
18439 the name of the file) you have specified.
18440 If you type &quot;T&quot; you may use a browser to choose an existing filename.
18441 <P>
18442 Besides containing regular text, a signature file may also
18443 contain (or a signature program may produce) tokens that are replaced with text
18444 that depends on the message you are replying to or forwarding.
18445 The tokens all look like _word_ (a word surrounded by underscores).
18446 For example, if the token
18447 <P>
18448 <CENTER><SAMP>_DATE_</SAMP></CENTER>
18449 <P>
18450 is included in the text of the signature file, then when you reply to
18451 or forward a message, the token will be replaced with the actual date
18452 the message you are replying to or forwarding was sent.
18453 <P>
18454 If you use a role that has a signature file for a plain composition
18455 (that is, not a reply or forward) then there is no original message, so
18456 any tokens that depend on the message will be replaced with nothing.
18457 So if you want a signature file to be useful for new compositions it
18458 shouldn't include any of the tokens that depend on the message being
18459 replied to or forwarded.
18460 <P>
18461 The list of available tokens is
18462 <A HREF="h_index_tokens">here</A>.
18463 <P>
18464 Actually, for the adventurous, there is a way to conditionally include text based
18465 on whether or not a token would result in specific replacement text.
18466 For example, you could include some text based on whether or not
18467 the _NEWS_ token would result in any newsgroups if it was used.
18468 It's explained in detail
18469 <A HREF="h_reply_token_conditionals">here</A>.
18470 <P>
18471 In the very unlikely event that you want to include a literal token in
18472 a signature file, you must precede it with a backslash character.
18473 For example, to include the literal text _DATE_ you must actually use
18474 &#92;_DATE_.
18475 It is not possible to have a literal backslash followed by an expanded token.
18476 <P>
18477 A blank field here means that Alpine will use its normal rules for deciding
18478 which file (if any) to use for the signature file.
18479 <P>
18480 An alternate method for storing the signature is available in
18481 <A HREF="h_config_role_setlitsig">Set Literal Signature</A>.
18482 <P>
18483 Look <A HREF="h_edit_nav_cmds">here</A>
18484 to see the available Editing and Navigation commands.
18485 <P>
18486 &lt;End of help on this topic&gt;
18487 </BODY>
18488 </HTML>
18489 ======= h_config_role_settempl =======
18490 <HTML>
18491 <HEAD>
18492 <TITLE>Set Template Explained</TITLE>
18493 </HEAD>
18494 <BODY>
18495 <H1>Set Template Explained</H1>
18496
18497 This describes part of the action to be taken if the Pattern for this
18498 role is a match.
18499 This field consists of a filename that will be used as the template
18500 file when using this role.
18501 The template file is a file that is included at the top of the message you
18502 are composing.
18503 <P>
18504 If the filename is followed by a vertical bar (|) then instead
18505 of reading the contents of the file the file is assumed to be a
18506 program that will produce the text to be used on its standard output.
18507 The program can't have any arguments and doesn't receive any input from Alpine,
18508 but the rest of the processing works as if the contents came from a file.
18509 <P>
18510 Instead of storing the data in a local file, the
18511 template may be stored remotely in an IMAP folder.
18512 In order to do this,
18513 you must use a remote name for the template.
18514 A remote template name might look like:
18515 <P>
18516 <CENTER><SAMP>{myimaphost.myschool.k12.wa.us}mail/templ3</SAMP></CENTER>
18517 <P>
18518
18519 The syntax used here is the same as the syntax used for a remote
18520 <A HREF="h_config_signature_file"><!--#echo var="VAR_signature-file"--></A>.
18521 Note that you may not access an existing template file remotely,
18522 you have to create a new <EM>folder</EM> that contains the template data.
18523 If the name you use here for the template is a remote name, then when
18524 you edit the file using the &quot;F&quot; command the data will
18525 be saved remotely in the folder.
18526 You aren't required to do anything special to create the folder, it
18527 gets created if you use a remote name.
18528 <P>
18529 If you type &quot;F&quot; you may edit the contents of the file (as opposed to
18530 the name of the file) you have specified.
18531 If you type &quot;T&quot; you may use a browser to choose an existing filename.
18532 <P>
18533 Besides containing regular text, the template file may also
18534 contain (or a template file program may produce) tokens that are replaced with text
18535 that depends on the message you are replying to or forwarding.
18536 The tokens all look like _word_ (a word surrounded by underscores).
18537 For example, if the token
18538 <P>
18539 <CENTER><SAMP>_DATE_</SAMP></CENTER>
18540 <P>
18541 is included in the text of the template file, then when you reply to
18542 or forward a message, the token will be replaced with the actual date
18543 the message you are replying to or forwarding was sent.
18544 <P>
18545 If you use a role that has a template file for a plain composition
18546 (that is, not a reply or forward) then there is no original message, so
18547 any tokens that depend on the message will be replaced with nothing.
18548 So if you want a template file to be useful for new compositions it
18549 shouldn't include any of the tokens that depend on the message being
18550 replied to or forwarded.
18551 <P>
18552 The list of available tokens is
18553 <A HREF="h_index_tokens">here</A>.
18554 <P>
18555 Actually, for the adventurous, there is a way to conditionally include text based
18556 on whether or not a token would result in specific replacement text.
18557 For example, you could include some text based on whether or not
18558 the _NEWS_ token would result in any newsgroups if it was used.
18559 It's explained in detail
18560 <A HREF="h_reply_token_conditionals">here</A>.
18561 <P>
18562 In the very unlikely event that you want to include a literal token in
18563 a template file, you must precede it with a backslash character.
18564 For example, to include the literal text _DATE_ you must actually use
18565 &#92;_DATE_.
18566 It is not possible to have a literal backslash followed by an expanded token.
18567 <P>
18568 A blank template field means that Alpine will not use a template file when
18569 this role is being used.
18570 <P>
18571 Look <A HREF="h_edit_nav_cmds">here</A>
18572 to see the available Editing and Navigation commands.
18573 <P>
18574 &lt;End of help on this topic&gt;
18575 </BODY>
18576 </HTML>
18577 ======= h_config_filt_stat_imp =======
18578 <HTML>
18579 <HEAD>
18580 <TITLE>Set Important Status Explained</TITLE>
18581 </HEAD>
18582 <BODY>
18583 <H1>Set Important Status Explained</H1>
18584
18585 This describes part of the action to be taken if the Pattern for this
18586 filter is a match.
18587 If set to &quot;Don't change it&quot; then this does nothing.
18588 If set to &quot;Set this state&quot; then the Important flag is set
18589 for the matching message.
18590 If set to &quot;Clear this state&quot; then the Important flag is cleared
18591 for the matching message.
18592 The important flag usually causes an asterisk to show up in the MESSAGE
18593 INDEX.
18594 It may also be useful when selecting a set of messages
18595 with the Select command.
18596 <P>
18597 Look <A HREF="h_edit_nav_cmds">here</A>
18598 to see the available Editing and Navigation commands.
18599 <P>
18600 &lt;End of help on this topic&gt;
18601 </BODY>
18602 </HTML>
18603 ======= h_config_filt_stat_new =======
18604 <HTML>
18605 <HEAD>
18606 <TITLE>Set New Status Explained</TITLE>
18607 </HEAD>
18608 <BODY>
18609 <H1>Set New Status Explained</H1>
18610
18611 This describes part of the action to be taken if the Pattern for this
18612 filter is a match.
18613 If set to &quot;Don't change it&quot; then this does nothing.
18614 If set to &quot;Set this state&quot; then the
18615 matching message is marked New.
18616 If set to &quot;Clear this state&quot; then the
18617 matching message is marked Seen.
18618 <P>
18619 Look <A HREF="h_edit_nav_cmds">here</A>
18620 to see the available Editing and Navigation commands.
18621 <P>
18622 &lt;End of help on this topic&gt;
18623 </BODY>
18624 </HTML>
18625 ======= h_config_filt_stat_ans =======
18626 <HTML>
18627 <HEAD>
18628 <TITLE>Set Answered Status Explained</TITLE>
18629 </HEAD>
18630 <BODY>
18631 <H1>Set Answered Status Explained</H1>
18632
18633 This describes part of the action to be taken if the Pattern for this
18634 filter is a match.
18635 If set to &quot;Don't change it&quot; then this does nothing.
18636 If set to &quot;Set this state&quot; then the Answered flag is set
18637 for the matching message.
18638 If set to &quot;Clear this state&quot; then the Answered flag is cleared
18639 for the matching message.
18640 <P>
18641 Look <A HREF="h_edit_nav_cmds">here</A>
18642 to see the available Editing and Navigation commands.
18643 <P>
18644 &lt;End of help on this topic&gt;
18645 </BODY>
18646 </HTML>
18647 ======= h_config_filt_stat_del =======
18648 <HTML>
18649 <HEAD>
18650 <TITLE>Set Deleted Status Explained</TITLE>
18651 </HEAD>
18652 <BODY>
18653 <H1>Set Deleted Status Explained</H1>
18654
18655 This describes part of the action to be taken if the Pattern for this
18656 filter is a match.
18657 If set to &quot;Don't change it&quot; then this does nothing.
18658 If set to &quot;Set this state&quot; then the
18659 matching message is marked Deleted.
18660 If set to &quot;Clear this state&quot; then the
18661 matching message is marked UnDeleted.
18662 <P>
18663 You should not use this option unless you are prepared to have matching
18664 messages expunged from the folder permanently.
18665 For example, if you type the Expunge command, this filter is applied
18666 before the expunge, so matching messages will be marked Deleted and then
18667 will be permanently expunged from the folder.
18668 However, since the index isn't redrawn in between the time that the message
18669 is marked Deleted and the time that you are asked to expunge, the only
18670 indication that you are expunging the message comes in the number of messages
18671 being expunged.
18672 The same thing may happen when you close a folder.
18673 It is also possible that an expunge not initiated by you will
18674 delete matching messages.
18675 <P>
18676 Look <A HREF="h_edit_nav_cmds">here</A>
18677 to see the available Editing and Navigation commands.
18678 <P>
18679 &lt;End of help on this topic&gt;
18680 </BODY>
18681 </HTML>
18682 ======= h_config_role_scoreval =======
18683 <HTML>
18684 <HEAD>
18685 <TITLE>Score Value Explained</TITLE>
18686 </HEAD>
18687 <BODY>
18688 <H1>Score Value Explained</H1>
18689
18690 A message's score is the sum of the Score Values from all of the Scoring rules
18691 with Patterns that match the message.
18692 The value you give here is the Score Value associated with this rule.
18693 A Score Value is an integer between -100 and 100, with the default
18694 value of zero.
18695 <P>
18696 Alternatively, if the
18697 <A HREF="h_config_role_scorehdrtok">&quot;Score From Header&quot;</A>
18698 field is defined
18699 (on the line right below the &quot;Score Value&quot; field)
18700 then the &quot;Score Value&quot; is ignored and
18701 the &quot;Score From Header&quot; field is used instead.
18702 <P>
18703 Look <A HREF="h_edit_nav_cmds">here</A>
18704 to see the available Editing and Navigation commands.
18705 <P>
18706 &lt;End of help on this topic&gt;
18707 </BODY>
18708 </HTML>
18709 ======= h_config_role_scorehdrtok =======
18710 <HTML>
18711 <HEAD>
18712 <TITLE>Score Value From Header Explained</TITLE>
18713 </HEAD>
18714 <BODY>
18715 <H1>Score Value From Header Explained</H1>
18716
18717 This option provides a way to use a number that appears in the headers of your
18718 messages as the message's score, or as a component of that score.
18719 If this field is defined then it is used instead of the &quot;Score Value&quot;.
18720 The idea behind this option is that there may be a score embedded in the
18721 headers of messages that has already been calculated outside of Alpine.
18722 For example, messages delivered to you may contain an &quot;X-Spam&quot; header and
18723 somewhere in that header there is a score.
18724 <P>
18725 The value for this option is the name of the header followed by parentheses
18726 with two arguments inside:
18727 <P>
18728 <CENTER><SAMP>HeaderName(field_number,field_separators)</SAMP></CENTER>
18729 <P>
18730 No space is allowed between the comma and the start of the field_separators.
18731 It would be interpreted as the first separator if it was there.
18732 Field 0 is the whole line, Field 1 is the data up to the first separator, Field 2
18733 starts after that and goes to the second separator, and so on.
18734 It's easier to explain with examples.
18735 <P>
18736 <CENTER><SAMP>X-Spam(2,&quot;&nbsp;&quot;)</SAMP></CENTER>
18737 <P>
18738 In the above example the header that is used is the &quot;X-Spam&quot; header.
18739 The value of that header (the part after the colon and the space) is split
18740 into fields separated by spaces.
18741 <P>
18742 <CENTER><SAMP>Field1 &lt;space&gt; Field2 &lt;space&gt; Field3 ...</SAMP></CENTER>
18743 <P>
18744 The second field is selected and converted to an integer. It only makes sense
18745 if Field2 really is an integer.
18746 <P>
18747 Here's an example of a SpamAssassin header.
18748 The exact look of the header will vary, but if your incoming mail
18749 contains headers that look like the following
18750 <P>
18751 <CENTER><SAMP>X-Spam-Status: Yes, hits=10.6 tagged_above=-999.0 required=7.0 tests=BAYE...</SAMP></CENTER>
18752 <P>
18753 you might want to use the hits value as a score.
18754 Since the score is an integer value you can't make use of the decimal part of
18755 the number, but
18756 you might split off the hits=10 part as a score by using the characters &quot;=&quot;
18757 and &quot;.&quot; as your separators.
18758 <P>
18759 <CENTER><SAMP>X-Spam-Status(2,&quot;=.&quot;)</SAMP></CENTER>
18760 <P>
18761 The first field starts with the Y in Yes and goes until the &quot;=&quot; after
18762 hits.
18763 The second field is &quot;10&quot; so the score value would be 10.
18764 <P>
18765 Another example we've seen has headers that look like
18766 <P>
18767 <CENTER><SAMP>X-Spam: Gauge=IIIIIII, Probability=7%, Report=...</SAMP></CENTER>
18768 <P>
18769 Because there are two equals before the 7% the value
18770 <P>
18771 <CENTER><SAMP>X-Spam(3,&quot;=%&quot;)</SAMP></CENTER>
18772 <P>
18773 should capture the probability as the score.
18774 <P>
18775 The Score From Header scoring value actually works just like the
18776 regular Score Value in that the rest of the pattern has to match before
18777 it is used and the scores from all the different scoring rules that
18778 match for a particular message are added together.
18779 When using the Score From Header method it may (or may not) make sense to
18780 use only a single scoring rule with a pattern that matches every message.
18781 <P>
18782 Look <A HREF="h_edit_nav_cmds">here</A>
18783 to see the available Editing and Navigation commands.
18784 <P>
18785 &lt;End of help on this topic&gt;
18786 </BODY>
18787 </HTML>
18788 ======= h_config_role_replyuse =======
18789 <HTML>
18790 <HEAD>
18791 <TITLE>Reply Use Explained</TITLE>
18792 </HEAD>
18793 <BODY>
18794 <H1>Reply Use Explained</H1>
18795
18796 This option determines how this particular role will be used when Replying
18797 to a message.
18798 There are three possible values for this option.
18799 The value &quot;Never&quot;
18800 means that this role will not be a candidate for use when Replying.
18801 The role's Pattern will not be checked for a match, however the role will
18802 be available to be manually switched to if there is a confirmation prompt.
18803 <P>
18804
18805 The options &quot;With confirmation&quot; and &quot;Without confirmation&quot;
18806 mean that you do want to consider this role when Replying.
18807 For either of these settings, the role's Pattern will be compared with
18808 the message being replied to.
18809 If there is a match then this role will either be used without confirmation
18810 or will be the default when confirmation is asked for, depending on
18811 which of the two options is selected.
18812 If confirmation is requested, you will also have a chance to
18813 manually change the role to any one of your other roles.
18814 <P>
18815
18816 You won't be prompted for confirmation if none of your role Patterns
18817 match the message being replied to.
18818 This is independent of the value of the current option.
18819 The <A HREF="h_config_confirm_role"><!--#echo var="FEAT_confirm-role-even-for-default"--></A>
18820 feature may be used to change this behavior.
18821 <P>
18822 &lt;End of help on this topic&gt;
18823 </BODY>
18824 </HTML>
18825 ======= h_config_role_forwarduse =======
18826 <HTML>
18827 <HEAD>
18828 <TITLE>Forward Use Explained</TITLE>
18829 </HEAD>
18830 <BODY>
18831 <H1>Forward Use Explained</H1>
18832
18833 This option determines how this particular role will be used when Forwarding
18834 a message.
18835 There are three possible values for this option.
18836 The value &quot;Never&quot;
18837 means that this role will not be a candidate for use when Forwarding.
18838 The role's Pattern will not be checked for a match, however the role will
18839 be available to be manually switched to if there is a confirmation prompt.
18840 <P>
18841
18842 The options &quot;With confirmation&quot; and &quot;Without confirmation&quot;
18843 mean that you do want to consider this role when Forwarding.
18844 For either of these settings, the role's Pattern will be compared with
18845 the message being forwarded.
18846 If there is a match then this role will either be used without confirmation
18847 or will be the default when confirmation is asked for, depending on
18848 which of the two options is selected.
18849 If confirmation is requested, you will also have a chance to
18850 manually change the role to any one of your other roles.
18851 <P>
18852
18853 You won't be prompted for confirmation if none of your role Patterns
18854 match the message being forwarded.
18855 This is independent of the value of the current option.
18856 The <A HREF="h_config_confirm_role"><!--#echo var="FEAT_confirm-role-even-for-default"--></A>
18857 feature may be used to change this behavior.
18858 <P>
18859 &lt;End of help on this topic&gt;
18860 </BODY>
18861 </HTML>
18862 ======= h_config_role_composeuse =======
18863 <HTML>
18864 <HEAD>
18865 <TITLE>Compose Use Explained</TITLE>
18866 </HEAD>
18867 <BODY>
18868 <H1>Compose Use Explained</H1>
18869
18870 This option determines how this particular role will be used when Composing
18871 a new message using the &quot;Compose&quot; command.
18872 This does not affect what happens when using the &quot;Role&quot; command
18873 to compose a new message.
18874 The &quot;Role&quot; command allows you to select a role from all of the
18875 roles you have defined, regardless of what Uses you've assigned to those
18876 roles.
18877 <P>
18878
18879 There are three possible values for this option.
18880 The value &quot;Never&quot;
18881 means that this role will not be a candidate for use when Composing.
18882 The role's Current Folder Type will not be checked for a match, however the role
18883 will be available to be manually switched to if there is a confirmation prompt.
18884 <P>
18885
18886 The options &quot;With confirmation&quot; and &quot;Without confirmation&quot;
18887 mean that you do want to consider this role when Composing.
18888 For either of these settings,
18889 the role's Current Folder Type will be checked (since there is no message
18890 to compare with, the rest of the Pattern is considered a match).
18891 If there is a match then this role will either be used without confirmation
18892 or will be the default when confirmation is asked for, depending on
18893 which of the two options is selected.
18894 If confirmation is requested, you will also have a chance to
18895 manually change the role to any one of your other roles.
18896 <P>
18897
18898 When using the Compose command the role checking is a little different
18899 because there is no message being replied to or forwarded.
18900 Because of this the Current Folder Type is checked but the header pattern
18901 fields, the AllText pattern, the BodyText pattern, and the Score Interval are all ignored.
18902 A role is considered to be a match if it is a candidate for Compose Use and
18903 its Current Folder Type matches the currently open folder.
18904 This could be useful if you want to set a role based on the folder you
18905 are reading, or the type of folder you are reading.
18906 <P>
18907
18908 You won't be prompted for confirmation if none of your role Patterns
18909 are a match.
18910 This is independent of the value of the current option.
18911 The <A HREF="h_config_confirm_role"><!--#echo var="FEAT_confirm-role-even-for-default"--></A>
18912 feature may be used to change this behavior.
18913 <P>
18914 &lt;End of help on this topic&gt;
18915 </BODY>
18916 </HTML>
18917 ======= h_config_filter_folder =======
18918 <HTML>
18919 <HEAD>
18920 <TITLE>Filter Folder Explained</TITLE>
18921 </HEAD>
18922 <BODY>
18923 <H1>Filter Folder Explained</H1>
18924
18925 When the Filter Action is set to &quot;Move&quot;,
18926 the folder or folders specified here will be used to store messages matching
18927 the provided pattern.
18928
18929 <P>
18930 If you set the Filter Action to &quot;Move&quot; you must give a folder name
18931 here.
18932
18933 <P>
18934 If you wish,
18935 you may choose a folder from your folder collections by using the
18936 &quot;T&quot; command.
18937 <P>
18938 Besides regular text, the folder name may also contain
18939 tokens that are replaced with text representing the current date
18940 when you run Alpine.
18941 For example, if the folder name you use is
18942 <P>
18943 <CENTER><SAMP>abc-_CURYEAR_-_CURMONTHABBREV_</SAMP></CENTER>
18944 <P>
18945 that is replaced with something like
18946 <P>
18947 <CENTER><SAMP>abc-2004-oct</SAMP></CENTER>
18948 <P>
18949 Or,
18950 <P>
18951 <CENTER><SAMP>abc-_CURYEAR2DIGIT_-_CURMONTH2DIGIT_</SAMP></CENTER>
18952 <P>
18953 becomes
18954 <P>
18955 <CENTER><SAMP>abc-04-10</SAMP></CENTER>
18956 <P>
18957 The token names must be surrounded by underscores in order to be recognized
18958 as tokens.
18959 The tokens that may be used are those that are derived from the current date.
18960 They're listed near the bottom of the list of tokens give
18961 <A HREF="h_index_tokens">here</A>.
18962 <P>
18963 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18964 for more information on Patterns.
18965 <P>
18966 Look <A HREF="h_edit_nav_cmds">here</A>
18967 to see the available Editing and Navigation commands.
18968 <P>
18969 &lt;End of help on this topic&gt;
18970 </BODY>
18971 </HTML>
18972 ======= h_config_filter_kw_set =======
18973 <HTML>
18974 <HEAD>
18975 <TITLE>Set These Keywords Explained</TITLE>
18976 </HEAD>
18977 <BODY>
18978 <H1>Set These Keywords Explained</H1>
18979
18980 This describes part of the action to be taken if the Pattern for this
18981 filter is a match.
18982 Read a little about keywords in the help text for the
18983 <A HREF="h_common_flag">Flag</A> command.
18984 This option is a list of keywords that will be Set when there is a match.
18985 If you wish, you may choose keywords from the list of keywords you have
18986 defined with the &quot;T&quot; command.
18987 You may add new keywords by defining them in the
18988 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in the Setup/Config screen.
18989 If you have given a keyword a nickname when configuring it,
18990 that nickname may be used instead of the actual keyword.
18991
18992 <P>
18993 Look <A HREF="h_edit_nav_cmds">here</A>
18994 to see the available Editing and Navigation commands.
18995 <P>
18996 &lt;End of help on this topic&gt;
18997 </BODY>
18998 </HTML>
18999 ======= h_config_filter_kw_clr =======
19000 <HTML>
19001 <HEAD>
19002 <TITLE>Clear These Keywords Explained</TITLE>
19003 </HEAD>
19004 <BODY>
19005 <H1>Clear These Keywords Explained</H1>
19006
19007 This describes part of the action to be taken if the Pattern for this
19008 filter is a match.
19009 Read a little about keywords in the help text for the
19010 <A HREF="h_common_flag">Flag</A> command.
19011 This option is a list of keywords that will be Cleared when there is a match.
19012 If you wish, you may choose keywords from the list of keywords you have
19013 defined with the &quot;T&quot; command.
19014 You may add new keywords by defining them in the
19015 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in the Setup/Config screen.
19016 If you have given a keyword a nickname when configuring it,
19017 that nickname may be used instead of the actual keyword.
19018
19019 <P>
19020 Look <A HREF="h_edit_nav_cmds">here</A>
19021 to see the available Editing and Navigation commands.
19022 <P>
19023 &lt;End of help on this topic&gt;
19024 </BODY>
19025 </HTML>
19026 ======= h_index_tokens =======
19027 <HTML>
19028 <HEAD>
19029 <TITLE>Tokens for Index and Replying</TITLE>
19030 </HEAD>
19031 <BODY>
19032
19033 This set of special tokens may be used in the
19034 <A HREF="h_config_index_format">&quot;<!--#echo var="VAR_index-format"-->&quot;</A> option,
19035 in the <A HREF="h_config_reply_intro">&quot;<!--#echo var="VAR_reply-leadin"-->&quot;</A> option,
19036 in signature files,
19037 in template files used in
19038 <A HREF="h_rules_roles">&quot;roles&quot;</A>, and in the folder name
19039 that is the target of a Filter Rule.
19040 Some of them aren't available in all situations.
19041 <P>
19042 The tokens are used as they appear below for the &quot;<!--#echo var="VAR_index-format"-->&quot;
19043 option, but they must be surrounded by underscores for the
19044 &quot;<!--#echo var="VAR_reply-leadin"-->&quot; option, in signature and template files,
19045 and in the target of Filter Rules.
19046 <P>
19047 <P>
19048
19049 <H1><EM>Tokens Available for all Cases (except Filter Rules)</EM></H1>
19050
19051 <DL>
19052 <DT>SUBJECT</DT>
19053 <DD>
19054 This token represents the Subject the sender gave the message.
19055 Alternatives for use in the index screen are SHORTSUBJECT,
19056 SUBJKEY, SUBJKEYINIT, SUBJECTTEXT, SUBJKEYTEXT, and SUBJKEYINITTEXT.
19057 You may color the subject text in the MESSAGE INDEX screen differently by using the
19058 <A HREF="h_config_index_subject_color">Index Subject Color</A> and the
19059 <A HREF="h_config_index_opening_color">Index Opening Color</A>
19060 options available from
19061 the <A HREF="h_color_setup">Setup Kolor</A> screen.
19062 </DD>
19063
19064 <DT>FROM</DT>
19065 <DD>
19066 This token represents the personal name (or email address if the name
19067 is unavailable) of the person specified in the message's &quot;From:&quot;
19068 header field.
19069 You may color the from text in the MESSAGE INDEX screen differently by using the
19070 <A HREF="h_config_index_from_color">Index From Color</A>
19071 option available from
19072 the <A HREF="h_color_setup">Setup Kolor</A> screen.
19073 </DD>
19074
19075 <DT>ADDRESS</DT>
19076 <DD>
19077 This is similar to the &quot;FROM&quot; token, only it is always the
19078 email address, never the personal name.
19079 For example, &quot;mailbox@domain&quot;.
19080 </DD>
19081
19082 <DT>MAILBOX</DT>
19083 <DD>
19084 This is the same as the &quot;ADDRESS&quot; except that the
19085 domain part of the address is left off.
19086 For example, &quot;mailbox&quot;.
19087 </DD>
19088
19089 <DT>SENDER</DT>
19090 <DD>
19091 This token represents the personal name (or email address) of the person
19092 listed in the message's &quot;Sender:&quot; header field.
19093 </DD>
19094
19095 <DT>TO</DT>
19096 <DD>
19097 This token represents the personal names (or email addresses if the names
19098 are unavailable) of the persons specified in the
19099 message's &quot;To:&quot; header field.
19100 </DD>
19101
19102 <DT>NEWSANDTO</DT>
19103 <DD>
19104 This token represents the newsgroups from the
19105 message's &quot;Newsgroups:&quot; header field <EM>and</EM>
19106 the personal names (or email addresses if the names
19107 are unavailable) of the persons specified in the
19108 message's &quot;To:&quot; header field.
19109 </DD>
19110
19111 <DT>TOANDNEWS</DT>
19112 <DD>
19113 Same as &quot;NEWSANDTO&quot; except in the opposite order.
19114 </DD>
19115
19116 <DT>NEWS</DT>
19117 <DD>
19118 This token represents the newsgroups from the
19119 message's &quot;Newsgroups:&quot; header field.
19120 </DD>
19121
19122 <DT>CC</DT>
19123 <DD>
19124 This token represents the personal names (or email addresses if the names
19125 are unavailable) of the persons specified in the
19126 message's &quot;Cc:&quot; header field.
19127 </DD>
19128
19129 <DT>RECIPS</DT>
19130 <DD>
19131 This token represents the personal names (or email addresses if the names
19132 are unavailable) of the persons specified in both the
19133 message's &quot;To:&quot; header field and
19134 the message's &quot;Cc:&quot; header field.
19135 </DD>
19136
19137 <DT>NEWSANDRECIPS</DT>
19138 <DD>
19139 This token represents the newsgroups from the
19140 message's &quot;Newsgroups:&quot; header field <EM>and</EM>
19141 the personal names (or email addresses if the names
19142 are unavailable) of the persons specified in the
19143 message's &quot;To:&quot; and &quot;Cc:&quot; header fields.
19144 </DD>
19145
19146 <DT>RECIPSANDNEWS</DT>
19147 <DD>
19148 Same as &quot;NEWSANDRECIPS&quot; except in the opposite order.
19149 </DD>
19150
19151 <DT>INIT</DT>
19152 <DD>
19153 This token represents the initials from the personal name
19154 of the person specified in the message's &quot;From:&quot;
19155 header field.
19156 If there is no personal name, it is blank.
19157 </DD>
19158
19159 <DT>DATE</DT>
19160 <DD>
19161 This token represents the date on which the message was sent, according
19162 to the &quot;Date&quot; header field.
19163 It has the format MMM DD. For example, &quot;Oct 23&quot;.
19164 The feature
19165 <A HREF="h_config_dates_to_local"><!--#echo var="FEAT_convert-dates-to-localtime"--></A>,
19166 which adjusts for the timezone the message was sent from,
19167 may have an effect on the value of this token as well as the values of
19168 all of the other DATE or TIME tokens.
19169 Some of the DATE and TIME tokens are displayed in a locale-specific
19170 way unless the option
19171 <A HREF="h_config_disable_index_locale_dates"><!--#echo var="FEAT_disable-index-locale-dates"--></A> is set.
19172 </DD>
19173
19174 <DT>SMARTDATE</DT>
19175 <DD>
19176 This token represents the date on which the message was sent, according
19177 to the &quot;Date&quot; header field.
19178 It is &quot;Today&quot; if the message was sent today,
19179 &quot;Yesterday&quot; for yesterday,
19180 &quot;Wednesday&quot; if it was last Wednesday, and so on. If the
19181 message is from last year and is more than six months old it includes the year, as well.
19182 See the SMARTDATE alternatives below, as well.
19183 </DD>
19184
19185 <DT>SMARTTIME</DT>
19186 <DD>
19187 This token represents the most relevant elements of the date on which
19188 the message was sent (according to the &quot;Date&quot; header field),
19189 in a compact form. If the message was sent today, only the time is used
19190 (e.g. &quot;9:22am&quot;, &quot;10:07pm&quot;); if it was sent during
19191 the past week, the day of the week and the hour are used
19192 (e.g. &quot;Wed09am&quot;, &quot;Thu10pm&quot;); other dates are
19193 given as date, month, and year (e.g. &quot;23Aug00&quot;,
19194 &quot;9Apr98&quot;).
19195 </DD>
19196
19197 <DT>SMARTDATETIME</DT>
19198 <DD>
19199 This is a combination of SMARTDATE and SMARTTIME.
19200 It is SMARTDATE unless the SMARTDATE value is &quot;Today&quot;, in which
19201 case it is SMARTTIME.
19202 See the SMARTDATETIME alternatives below, as well.
19203 </DD>
19204
19205 <DT>DATEISO</DT>
19206 <DD>
19207 This token represents the date on which the message was sent, according
19208 to the &quot;Date&quot; header field.
19209 It has the format YYYY-MM-DD. For example, &quot;1998-10-23&quot;.
19210 </DD>
19211
19212 <DT>SHORTDATEISO</DT>
19213 <DD>
19214 This token represents the date on which the message was sent, according
19215 to the &quot;Date&quot; header field.
19216 It has the format YY-MM-DD. For example, &quot;98-10-23&quot;.
19217 </DD>
19218
19219 <DT>SHORTDATE1</DT>
19220 <DD>
19221 This token represents the date on which the message was sent, according
19222 to the &quot;Date&quot; header field.
19223 It has the format MM/DD/YY. For example, &quot;10/23/98&quot;.
19224 </DD>
19225
19226 <DT>SHORTDATE2</DT>
19227 <DD>
19228 This token represents the date on which the message was sent, according
19229 to the &quot;Date&quot; header field.
19230 It has the format DD/MM/YY. For example, &quot;23/10/98&quot;.
19231 </DD>
19232
19233 <DT>SHORTDATE3</DT>
19234 <DD>
19235 This token represents the date on which the message was sent, according
19236 to the &quot;Date&quot; header field.
19237 It has the format DD.MM.YY. For example, &quot;23.10.98&quot;.
19238 </DD>
19239
19240 <DT>SHORTDATE4</DT>
19241 <DD>
19242 This token represents the date on which the message was sent, according
19243 to the &quot;Date&quot; header field.
19244 It has the format YY.MM.DD. For example, &quot;98.10.23&quot;.
19245 </DD>
19246
19247 <DT>LONGDATE</DT>
19248 <DD>
19249 This token represents the date on which the message was sent, according
19250 to the &quot;Date&quot; header field.
19251 It has the format MMM DD, YYYY. For example, &quot;Oct 23, 1998&quot;.
19252 </DD>
19253
19254 <DT>SMARTDATE alternatives</DT>
19255 <DD>
19256 There are several versions of SMARTDATE that are all the same except
19257 for the way they format dates far in the past.
19258 SMARTDATE formats the date using the information from your locale settings
19259 to format the date string. It may end up formatting dates so that they look
19260 like DATEISO tokens, or SHORTDATE2 tokens, or something else entirely.
19261 The feature
19262 <A HREF="h_config_dates_to_local"><!--#echo var="FEAT_convert-dates-to-localtime"--></A>
19263 may have an effect on the values of these tokens.
19264 If you want more control you may use one of the following.
19265   <DL>
19266   <DT>SMARTDATE</DT> <DD>If the option
19267 <A HREF="h_config_disable_index_locale_dates"><!--#echo var="FEAT_disable-index-locale-dates"--></A> is not set
19268 then this will be locale specific. Control this with the
19269 LC_TIME locale setting on a UNIX system. On Windows
19270 the Regional Options control panel may be used to set the Short date
19271 format. At the programming level, the strftime routine is what Alpine
19272 uses to print the date.
19273 If the <!--#echo var="FEAT_disable-index-locale-dates"--> option is set then this is equivalent
19274 to SMARTDATES1.</DD>
19275   <DT>SMARTDATEISO</DT> <DD>DATEISO format. See text above.</DD>
19276   <DT>SMARTDATESHORTISO</DT> <DD>SHORTDATEISO format.</DD>
19277   <DT>SMARTDATES1</DT> <DD>SHORTDATE1 format.</DD>
19278   <DT>SMARTDATES2</DT> <DD>SHORTDATE2 format.</DD>
19279   <DT>SMARTDATES3</DT> <DD>SHORTDATE3 format.</DD>
19280   <DT>SMARTDATES4</DT> <DD>SHORTDATE4 format.</DD>
19281   </DL>
19282 </DD>
19283
19284 <DT>SMARTDATETIME alternatives</DT>
19285 <DD>
19286 There are several versions of SMARTDATETIME that are all very similar.
19287 The ones that end in 24 use a 24-hour clock for Today's messages instead
19288 of a 12-hour clock.
19289 The other variation is
19290 for the way they format dates far in the past.
19291 SMARTDATETIME and SMARTDATETIME24 format the date using the information from your locale settings
19292 to format the date string. It may end up formatting dates so that they look
19293 like DATEISO tokens, or SHORTDATE2 tokens, or something else entirely.
19294 The feature
19295 <A HREF="h_config_dates_to_local"><!--#echo var="FEAT_convert-dates-to-localtime"--></A>
19296 may have an effect on the values of these tokens.
19297 The possible choices are:
19298   <DL>
19299   <DT>SMARTDATETIME</DT> <DD>If the option
19300 <A HREF="h_config_disable_index_locale_dates"><!--#echo var="FEAT_disable-index-locale-dates"--></A> is not set
19301 then this will be locale specific. Control this with the
19302 LC_TIME locale setting on a UNIX system. On Windows
19303 the Regional Options control panel may be used to set the Short date
19304 format. At the programming level, the strftime routine is what Alpine
19305 uses to print the date.
19306 If the <!--#echo var="FEAT_disable-index-locale-dates"--> option is set then this is equivalent
19307 to SMARTDATETIMES1.</DD>
19308   <DT>SMARTDATETIME24</DT> <DD>Use TIME24 for Today</DD>
19309   <DT>SMARTDATETIMEISO</DT> <DD>DATEISO format. See text above.</DD>
19310   <DT>SMARTDATETIMEISO24</DT> <DD>Use TIME24 for Today</DD>
19311   <DT>SMARTDATETIMESHORTISO</DT> <DD>SHORTDATEISO format.</DD>
19312   <DT>SMARTDATETIMESHORTISO24</DT> <DD>Use TIME24 for Today</DD>
19313   <DT>SMARTDATETIMES1</DT> <DD>SHORTDATE1 format.</DD>
19314   <DT>SMARTDATETIMES124</DT> <DD>Use TIME24 for Today</DD>
19315   <DT>SMARTDATETIMES2</DT> <DD>SHORTDATE2 format.</DD>
19316   <DT>SMARTDATETIMES224</DT> <DD>Use TIME24 for Today</DD>
19317   <DT>SMARTDATETIMES3</DT> <DD>SHORTDATE3 format.</DD>
19318   <DT>SMARTDATETIMES324</DT> <DD>Use TIME24 for Today</DD>
19319   <DT>SMARTDATETIMES4</DT> <DD>SHORTDATE4 format.</DD>
19320   <DT>SMARTDATETIMES424</DT> <DD>Use TIME24 for Today</DD>
19321   </DL>
19322 </DD>
19323
19324 <DT>DAYDATE</DT>
19325 <DD>
19326 This token represents the date on which the message was sent, according
19327 to the &quot;Date&quot; header field.
19328 It looks like &quot;Sat, 23 Oct 1998&quot;.
19329 This token is never converted in any locale-specific way.
19330 </DD>
19331
19332 <DT>PREFDATE</DT>
19333 <DD>
19334 This token represents the date on which the message was sent, according
19335 to the &quot;Date&quot; header field.
19336 It is your operating system's idea of the preferred date representation for the current locale.
19337 Internally it uses the %x version of the date from the strftime routine.
19338 </DD>
19339
19340 <DT>PREFTIME</DT>
19341 <DD>
19342 This token represents the time at which the message was sent, according
19343 to the &quot;Date&quot; header field.
19344 It is the preferred time representation for the current locale.
19345 Internally it uses the %X version of the time from the strftime routine.
19346 </DD>
19347
19348 <DT>PREFDATETIME</DT>
19349 <DD>
19350 This token represents the date and time at which the message was sent, according
19351 to the &quot;Date&quot; header field.
19352 It is the preferred date and time representation for the current locale.
19353 Internally it uses the %c version of the time from the strftime routine.
19354 </DD>
19355
19356 <DT>DAY</DT>
19357 <DD>
19358 This token represents the day of the month on which the message was sent,
19359 according to the &quot;Date&quot; header field.
19360 For example, &quot;23&quot; or &quot;9&quot;.
19361 </DD>
19362
19363 <DT>DAY2DIGIT</DT>
19364 <DD>
19365 This token represents the day of the month on which the message was sent,
19366 according to the &quot;Date&quot; header field.
19367 For example, &quot;23&quot; or &quot;09&quot;.
19368 It is always 2 digits.
19369 </DD>
19370
19371 <DT>DAYORDINAL</DT>
19372 <DD>
19373 This token represents the ordinal number that is the day of
19374 the month on which the message was sent,
19375 according to the &quot;Date&quot; header field.
19376 For example, &quot;23rd&quot; or &quot;9th&quot;.
19377 </DD>
19378
19379 <DT>DAYOFWEEK</DT>
19380 <DD>
19381 This token represents the day of the week on which the message was sent,
19382 according to the &quot;Date&quot; header field.
19383 For example, &quot;Sunday&quot; or &quot;Wednesday&quot;.
19384 </DD>
19385
19386 <DT>DAYOFWEEKABBREV</DT>
19387 <DD>
19388 This token represents the day of the week on which the message was sent,
19389 according to the &quot;Date&quot; header field.
19390 For example, &quot;Sun&quot; or &quot;Wed&quot;.
19391 </DD>
19392
19393 <DT>MONTHABBREV</DT>
19394 <DD>
19395 This token represents the month the message was sent, according
19396 to the &quot;Date&quot; header field.
19397 For example, &quot;Oct&quot;.
19398 </DD>
19399
19400 <DT>MONTHLONG</DT>
19401 <DD>
19402 This token represents the month in which the message was sent, according
19403 to the &quot;Date&quot; header field.
19404 For example, &quot;October&quot;.
19405 </DD>
19406
19407 <DT>MONTH</DT>
19408 <DD>
19409 This token represents the month in which the message was sent, according
19410 to the &quot;Date&quot; header field.
19411 For example, &quot;10&quot; or &quot;9&quot;.
19412 </DD>
19413
19414 <DT>MONTH2DIGIT</DT>
19415 <DD>
19416 This token represents the month in which the message was sent, according
19417 to the &quot;Date&quot; header field.
19418 For example, &quot;10&quot; or &quot;09&quot;.
19419 It is always 2 digits.
19420 </DD>
19421
19422 <DT>YEAR</DT>
19423 <DD>
19424 This token represents the year the message was sent, according
19425 to the &quot;Date&quot; header field.
19426 For example, &quot;1998&quot; or &quot;2001&quot;.
19427 </DD>
19428
19429 <DT>YEAR2DIGIT</DT>
19430 <DD>
19431 This token represents the year the message was sent, according
19432 to the &quot;Date&quot; header field.
19433 For example, &quot;98&quot; or &quot;01&quot;.
19434 It is always 2 digits.
19435 </DD>
19436
19437 <DT>TIME24</DT>
19438 <DD>
19439 This token represents the time at which the message was sent, according
19440 to the &quot;Date&quot; header field.
19441 There is no adjustment made for different time zones, so you'll get
19442 the time the message was sent according to the time zone the sender
19443 was in.
19444 It has the format HH:MM. For example, &quot;17:28&quot;.
19445 </DD>
19446
19447 <DT>TIME12</DT>
19448 <DD>
19449 This token represents the time at which the message was sent, according
19450 to the &quot;Date&quot; header field.
19451 This time is for a 12 hour clock.
19452 It has the format HH:MMpm.
19453 For example, &quot;5:28pm&quot; or &quot;11:13am&quot;.
19454 </DD>
19455
19456 <DT>TIMEZONE</DT>
19457 <DD>
19458 This token represents the numeric timezone from
19459 the &quot;Date&quot; header field.
19460 It has the format [+-]HHMM. For example, &quot;-0800&quot;.
19461 </DD>
19462
19463 </DL>
19464
19465 <P>
19466 <H1><EM>Tokens Available Only for <!--#echo var="VAR_index-format"--></EM></H1>
19467
19468 <DL>
19469 <DT>MSGNO</DT>
19470 <DD>
19471 This token represents the message's current position in the folder that,
19472 of course, may change as the folder is sorted or new mail arrives.
19473 </DD>
19474
19475 <DT>STATUS</DT>
19476 <DD>
19477 This token represents a three character wide field displaying various
19478 aspects of the message's state.
19479 The first character is either blank,
19480 a '*' for message marked Important, or a '+' indicating a message
19481 addressed directly to you (as opposed to your having received it via a
19482 mailing list, for example).
19483 When the feature
19484 &quot;<A HREF="h_config_mark_for_cc"><!--#echo var="FEAT_mark-for-cc"--></A>&quot;
19485 is set, if the first character would have been
19486 blank then it will instead be a '-' if the message is cc'd to you.
19487 The second character is typically blank,
19488 though the arrow cursor may occupy it if either the
19489 &quot;<A HREF="h_config_force_low_speed"><!--#echo var="FEAT_assume-slow-link"--></A>&quot;
19490 or the
19491 &quot;<A HREF="h_config_force_arrow"><!--#echo var="FEAT_force-arrow-cursor"--></A>&quot; feature
19492 is set (or you actually are on a slow link).
19493 The third character is either '<A HREF="h_flag_deleted">D</A>' (Deleted),
19494 '<A HREF="h_flag_answered">A</A>' (Answered),
19495 '<A HREF="h_flag_forwarded">F</A>' (Forwarded),
19496 '<A HREF="h_flag_new">N</A>' (New), or blank.
19497 <P>
19498 If you are using a threaded view of the index and this message is at the
19499 top of a collapsed portion of a thread,
19500 then this token refers to all of the messages in the collapsed portion of
19501 the thread instead of just the top message.
19502 The first character will be a '*' if <EM>any</EM> of the messages in the thread
19503 are marked Important, else a '+' if any of the messages are addressed
19504 to you, else a '-' if any of the messages are cc'd to you.
19505 The third character will be a 'D' if <EM>all</EM> of the messages
19506 in the collapsed thread are marked deleted,
19507 an 'A' if <EM>all</EM> of the messages
19508 in the collapsed thread are marked answered,
19509 it will be an 'N' if any of
19510 the messages are undeleted and unseen, and it will be blank otherwise.
19511 </DD>
19512
19513 <DT>FULLSTATUS</DT>
19514 <DD>
19515 This token represents a less abbreviated alternative
19516 to the &quot;STATUS&quot; token.
19517 It is six characters wide.
19518 The first character is '+', '-', or blank, the
19519 second blank, the third either '*' or blank, the fourth
19520 '<A HREF="h_flag_new">N</A>' or blank,
19521 the fifth '<A HREF="h_flag_answered">A</A>'
19522 or blank, and the sixth character is
19523 either '<A HREF="h_flag_deleted">D</A>' or
19524 blank.
19525 <P>
19526 If you are using a threaded view of the index and this message is at the
19527 top of a collapsed portion of a thread,
19528 then this token refers to all of the messages in the collapsed portion of
19529 the thread instead of just the top message.
19530 The first character is '+', '-', or blank depending on whether <EM>any</EM>
19531 of the messages in the collapsed thread are addressed to you or cc'd to you.
19532 The third character will be '*' if any of the messages are marked
19533 Important.
19534 The fourth character will be 'N' if all of the messages in the thread
19535 are New, else 'n' if some of the messages in the thread are New, else blank.
19536 The fifth character will be 'A' or 'a' or blank, and the sixth character
19537 will be 'D' or 'd' or blank.
19538 </DD>
19539
19540 <DT>IMAPSTATUS</DT>
19541 <DD>
19542 This token represents an even less abbreviated alternative to the
19543 &quot;STATUS&quot; token.
19544 It differs from &quot;FULLSTATUS&quot; in only the fourth character, which is
19545 an 'N' if the message is new to this folder since the last time
19546 it was opened <EM>and</EM> it has not been viewed, an 'R' (Recent) if the message
19547 is new to the folder and has been viewed, a 'U' (Unseen) if the message is not
19548 new to the folder since it was last opened <EM>but</EM> has not been
19549 viewed, or a blank if the message has been in the folder since it was
19550 last opened and has been viewed.
19551 <P>
19552 If you are using a threaded view of the index and this message is at the
19553 top of a collapsed portion of a thread,
19554 then the fourth character will be
19555 'N' if all of the messages in the thread are unseen and recent;
19556 else 'n' if some of the messages in the thread are unseen and recent;
19557 else 'U' if all of the messages in the thread are unseen and not recent;
19558 else 'u' if some of the messages in the thread are unseen and not recent;
19559 else 'R' if all of the messages in the thread are seen and recent;
19560 else 'r' if some of the messages in the thread are seen and recent;
19561 else blank.
19562 </DD>
19563
19564 <DT>SHORTIMAPSTATUS</DT>
19565 <DD>
19566 This is the same as the last four of the six characters of IMAPSTATUS,
19567 so the '+' To Me information will be missing.
19568 </DD>
19569
19570 <DT>SIZE</DT>
19571 <DD>
19572 This token represents the total size, in bytes, of the message.
19573 If a &quot;K&quot; (Kilobyte)
19574 follows the number, the size is approximately 1,000
19575 times that many bytes (rounded to the nearest 1,000).
19576 If an &quot;M&quot; (Megabyte) follows the number, the size is approximately
19577 1,000,000 times that many bytes.
19578 Commas are not used in this field.
19579 This field is seven characters wide, including the enclosing parentheses.
19580 Sizes are rounded when &quot;K&quot; or &quot;M&quot; is present.
19581 The progression of sizes used looks like:
19582
19583 <P>
19584 <CENTER><SAMP>0 1 ... 9999 10K ... 999K 1.0M ... 99.9M 100M ... 2000M</SAMP></CENTER>
19585 <P>
19586 </DD>
19587
19588 <DT>SIZECOMMA</DT>
19589 <DD>
19590 This token represents the total size, in bytes, of the message.
19591 If a &quot;K&quot; (Kilobyte)
19592 follows the number, the size is approximately 1,000
19593 times that many bytes (rounded to the nearest 1,000).
19594 If an &quot;M&quot; (Megabyte) follows the number, the size is approximately
19595 1,000,000 times that many bytes.
19596 Commas are used if the number shown is 1,000 or greater.
19597 The SIZECOMMA field is one character wider than the SIZE field.
19598 Sizes are rounded when &quot;K&quot; or &quot;M&quot; is present.
19599 The progression of sizes used looks like:
19600
19601 <P>
19602 <CENTER><SAMP>0 1 ... 99,999 100K ... 9,999K 10.0M ... 999.9M 1,000M ... 2,000M</SAMP></CENTER>
19603 <P>
19604 </DD>
19605
19606 <DT>KSIZE</DT>
19607 <DD>
19608 This token represents the total size of the message, expressed in
19609 kilobytes or megabytes, as most appropriate.
19610 These are 1,024 byte kilobytes and 1,024 x 1,024 byte megabytes.
19611 The progression of sizes used looks like:
19612
19613 <P>
19614 <CENTER><SAMP>0K 1K ... 1023K 1.0M ... 99.9M 100M ... 2047M</SAMP></CENTER>
19615 <P>
19616 </DD>
19617
19618 <DT>SIZENARROW</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.
19624 If an &quot;M&quot; (Megabyte) follows the number, the size is approximately
19625 1,000,000 times that many bytes.
19626 If a &quot;G&quot; (Gigabyte) follows the number, the size is approximately
19627 1,000,000,000 times that many bytes.
19628 This field uses only five characters of screen width, including the enclosing
19629 parentheses.
19630 The progression of sizes used looks like:
19631
19632 <P>
19633 <CENTER><SAMP>0 1 ... 999 1K ... 99K .1M ... .9M 1M ... 99M .1G ... .9G 1G 2G</SAMP></CENTER>
19634 <P>
19635 </DD>
19636
19637 <DT>DESCRIPSIZE</DT>
19638 <DD>
19639 This token is intended to represent a more useful description of the
19640 message than just its size, but it isn't very useful at this point.
19641 The plus sign in this view means there are attachments.
19642 Note that including this token in
19643 the &quot;<!--#echo var="VAR_index-format"-->&quot; could slow down the
19644 display a little while Alpine collects the necessary information.
19645 </DD>
19646
19647 <DT>SHORTSUBJECT</DT>
19648 <DD>
19649 This token is the same as SUBJECT, but
19650 removes text between &quot;[&quot; and &quot;]&quot;.
19651 Typically text enclosed between these characters corresponds to
19652 mailing list names, and may be unnecessary or unwanted in some
19653 instances.
19654 </DD>
19655
19656 <DT>SUBJKEY</DT>
19657 <DD>
19658 This token is the same as the SUBJECT token unless keywords are set for
19659 the message.
19660 In that case, a list of keywords enclosed in braces will be prepended to
19661 the subject of the message.
19662 Only those keywords that you have defined in your
19663 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option
19664 in Setup/Config are considered in the list.
19665 In other words, keywords that have been set by some other means, perhaps
19666 by another email program, won't show up unless included in
19667 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>.
19668 Having this set in the <!--#echo var="VAR_index-format"--> will also cause the keywords to be
19669 prepended to the subject in the MESSAGE TEXT screen.
19670 If you have given a keyword a nickname
19671 (<A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>), that nickname is displayed
19672 instead of the actual keyword.
19673 The <A HREF="h_config_kw_braces"><!--#echo var="VAR_keyword-surrounding-chars"--></A>
19674 option may be used to modify this token slightly.
19675 It is also possible to color keywords in the index using the
19676 Setup/Kolor screen (<A HREF="h_config_kw_color">Keyword Colors</A>).
19677 </DD>
19678
19679 <DT>SUBJKEYINIT</DT>
19680 <DD>
19681 This token is the same as the SUBJKEY token except that instead of
19682 prepending a list of keywords to the subject, a list of first initials
19683 of keywords will be prepended instead.
19684 For example, if a message has the keywords <EM>Work</EM> and <EM>Now</EM>
19685 set (or Work and Now are the Alpine nicknames of keywords that are set)
19686 then the SUBJKEY token would cause a result like
19687 <P>
19688 <CENTER><SAMP>{Work Now} actual subject</SAMP></CENTER>
19689 <P>
19690 whereas the SUBJKEYINIT token would give
19691 <P>
19692 <CENTER><SAMP>{WN} actual subject</SAMP></CENTER>
19693 <P>
19694 Only those keywords that you have defined in your
19695 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option
19696 in Setup/Config are considered in the list.
19697 In other words, keywords that have been set by some other means, perhaps
19698 by another email program, won't show up unless included in
19699 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>.
19700 The <A HREF="h_config_kw_braces"><!--#echo var="VAR_keyword-surrounding-chars"--></A>
19701 option may be used to modify this token slightly.
19702 It is also possible to color keywords in the index using the
19703 Setup/Kolor screen (<A HREF="h_config_kw_color">Keyword Colors</A>).
19704 </DD>
19705
19706 <DT>SUBJECTTEXT</DT>
19707 <DD>
19708 Same as SUBJECT but if there is room in the Subject field for more text,
19709 the opening part of the text of the message is displayed after the subject.
19710 The time needed to fetch the text may cause a performance problem
19711 which can, of course, be avoided by using the SUBJECT version of
19712 the Subject instead.
19713 You may color this opening text differently by using the
19714 <A HREF="h_config_index_opening_color">Index Opening Color</A> option available from
19715 the <A HREF="h_color_setup">Setup Kolor</A> screen.
19716 You may adjust the characters that are displayed between the Subject and the
19717 opening text with the option
19718 <A HREF="h_config_opening_sep"><!--#echo var="VAR_opening-text-separator-chars"--></A>.
19719 </DD>
19720
19721 <DT>SUBJKEYTEXT</DT>
19722 <DD>
19723 Same as SUBJKEY but with the opening message text.
19724 </DD>
19725
19726 <DT>OPENINGTEXT</DT>
19727 <DD>
19728 This is similar to SUBJECTTEXT.
19729 Instead of combining the Subject and the opening text in a single
19730 field in the index screen this token allows you to allocate a
19731 separate column just for the opening text of the message.
19732 The time needed to fetch this text may cause a performance problem.
19733 You may color this opening text differently by using the
19734 <A HREF="h_config_index_opening_color">Index Opening Color</A> option available from
19735 the <A HREF="h_color_setup">Setup Kolor</A> screen.
19736 </DD>
19737
19738 <DT>OPENINGTEXTNQ</DT>
19739 <DD>
19740 This is very similar to OPENINGTEXT.
19741 The NQ stands for No Quotes.
19742 The only difference is that quoted text (lines beginning with &gt;) is deleted.
19743 For some messages this may be confusing.
19744 For example, a message might have a line preceding some quoted
19745 text that reads something like &quot;On May 8th person A said.&quot;
19746 That no longer makes sense after the quoted text is deleted and it
19747 will appear that person A said whatever the text after the quote
19748 is, even though that is really person B talking.
19749 </DD>
19750
19751 <DT>SUBJKEYINITTEXT</DT>
19752 <DD>
19753 Same as SUBJKEYINIT but with the opening message text.
19754 </DD>
19755
19756 <DT>KEY</DT>
19757 <DD>
19758 This is a space-delimited list of keywords that are set for the message.
19759 Only those keywords that you have defined in your
19760 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option
19761 in Setup/Config are considered in the list.
19762 In other words, keywords that have been set by some other means, perhaps
19763 by another email program, won't show up unless included in
19764 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>.
19765 If you have given a keyword a nickname
19766 (<A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>), that nickname is displayed
19767 instead of the actual keyword.
19768 It is also possible to color keywords in the index using the
19769 Setup/Kolor screen (<A HREF="h_config_kw_color">Keyword Colors</A>).
19770 This token defaults to an arbitrary width of 5.
19771 You should set it to whatever width suits you using something
19772 like KEY(17) in the <!--#echo var="VAR_index-format"-->.
19773 </DD>
19774
19775 <DT>KEYINIT</DT>
19776 <DD>
19777 This is a list of keyword initials that are set for the message.
19778 If you have given a keyword a nickname
19779 (<A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>), the initial of that nickname
19780 is displayed instead of the initial of the actual keyword.
19781 It is also possible to color keyword initials in the index using the
19782 Setup/Kolor screen (<A HREF="h_config_kw_color">Keyword Colors</A>).
19783 This token defaults to an arbitrary width of 2.
19784 You should set it to whatever width suits you using something
19785 like KEYINIT(3) in the <!--#echo var="VAR_index-format"-->.
19786 </DD>
19787
19788 <DT>PRIORITY</DT>
19789 <DD>
19790 The X-Priority header is a non-standard header that is used in a
19791 somewhat standard way by many mail programs.
19792 Alpine expects the value of this header to be a digit with a value
19793 from 1 to 5, with 1 being the highest priority and 5 the lowest priority.
19794 Since this priority is something that the sender sets it is only an indication
19795 of the priority that the sender attaches to the mail and it is therefore almost
19796 totally unreliable for use as a filtering criterion.
19797 This token will display the numeric value of the priority if it is between
19798 1 and 5.
19799 It will be suppressed (blank) if the value is 3, which is normal priority.
19800 This token may be colored with the
19801 <A HREF="h_config_index_pri_color">Index Priority Symbol Colors</A>.
19802 </DD>
19803
19804 <DT>PRIORITYALPHA</DT>
19805 <DD>
19806 This is a more verbose interpretation of the X-Priority field.
19807 Once again nothing is displayed unless the value of the field
19808 is 1, 2, 4, or 5.
19809 The values displayed for those values are:
19810 <P>
19811 <TABLE>
19812 <TR> <TD>1</TD> <TD>Highest</TD> </TR>
19813 <TR> <TD>2</TD> <TD>High</TD> </TR>
19814 <TR> <TD>4</TD> <TD>Low</TD> </TR>
19815 <TR> <TD>5</TD> <TD>Lowest</TD> </TR>
19816 </TABLE>
19817 <P>
19818 This token may be colored with the
19819 <A HREF="h_config_index_pri_color">Index Priority Symbol Colors</A>.
19820 </DD>
19821
19822 <DT>PRIORITY!</DT>
19823 <DD>
19824 This is a one character, non-numeric version of the X-Priority field.
19825 If the value of the X-Priority header is 1 or 2 an exclamation
19826 point is displayed.
19827 If the value is 4 or 5 a &quot;v&quot; (think down arrow) is displayed.
19828 This token may be colored with the
19829 <A HREF="h_config_index_pri_color">Index Priority Symbol Colors</A>.
19830 </DD>
19831
19832 <DT>ATT</DT>
19833 <DD>
19834 This is a one column wide field that represents the number of attachments
19835 a message has. It will be blank if there are no attachments, a single
19836 digit for one to nine attachments, or an asterisk for more than nine.
19837 Note that including this token in
19838 the &quot;<!--#echo var="VAR_index-format"-->&quot; could slow down the
19839 display a little while Alpine collects the necessary information.
19840 </DD>
19841
19842 <DT>FROMORTO</DT>
19843 <DD>
19844 This token represents <EM>either</EM> the personal name (or email address) of
19845 the person listed in the message's &quot;From:&quot; header
19846 field, <EM>or</EM>, if that address is yours or one of your
19847 <A HREF="h_config_alt_addresses">alternate addresses</A>,
19848 the first person specified in the
19849 message's &quot;To:&quot; header field
19850 with the prefix &quot;To: &quot; prepended.
19851 If the from address is yours and there is also no &quot;To&quot; address,
19852 Alpine will use the address on the &quot;Cc&quot; line.
19853 If there is no address there, either, Alpine will look for a newsgroup name
19854 from the &quot;Newsgroups&quot; header field and put
19855 that after the &quot;To: &quot; prefix.
19856 </DD>
19857
19858 <DT>FROMORTONOTNEWS</DT>
19859 <DD>
19860 This is almost the same as <EM>FROMORTO</EM>.
19861 The difference is that newsgroups aren't considered.
19862 When a message is from you, doesn't have a To or Cc, and does have
19863 a Newsgroups header; this token will be your name instead of the name
19864 of the newsgroup (like it would be with FROMORTO).
19865 </DD>
19866
19867 <DT>TEXT</DT>
19868 <DD>
19869 This is a different sort of token.
19870 It allows you to display a label within each index line.
19871 It will be the same fixed text for each line.
19872 It is different from all the other tokens in that there is no space column
19873 displayed after this token.
19874 Instead, it is butted up against the following field.
19875 It also has a different syntax.
19876 The text to display is given following a colon after the
19877 word &quot;TEXT&quot;.
19878 For example,
19879 <P>
19880 <CENTER><SAMP>TEXT:abc=</SAMP></CENTER>
19881 <P>
19882 would insert the literal text &quot;abc=&quot; (without the quotes)
19883 into the index display line.
19884 You must quote the text if it includes space characters, like
19885 <P>
19886 <CENTER><SAMP>TEXT:&quot;abc&nbsp;=&nbsp;&quot;</SAMP></CENTER>
19887 <P>
19888 </DD>
19889
19890 <DT>HEADER</DT>
19891 <DD>
19892 This allows you to display the text from a particular header line in the
19893 message.
19894 The syntax for this token is substantially different from all the others
19895 in order that you might be able to display a portion of the text following
19896 a particular header.
19897 The header name you are interested in is given following a colon
19898 after the word &quot;HEADER&quot;.
19899 For example,
19900 <P>
19901 <CENTER><SAMP>HEADER:X-Spam</SAMP></CENTER>
19902 <P>
19903 would display the text of the X-Spam header, if any.
19904 Like for other index tokens a width field may (and probably should)
19905 follow this.
19906 <P>
19907 <CENTER><SAMP>HEADER:X-Spam(10)</SAMP></CENTER>
19908 <P>
19909 displays the first ten characters of the X-Spam header.
19910 Unlike other index tokens, the syntax for HEADER is more flexible.
19911 An optional second argument comes after a comma inside the parentheses.
19912 It specifies the &quot;field&quot; number.
19913 By default, the field separator is a space character.
19914 No extra space characters are allowed in the argument list.
19915 <P>
19916 <CENTER><SAMP>HEADER:X-Spam(10,2)</SAMP></CENTER>
19917 <P>
19918 would display the second field, left-justified, in a 10 character
19919 wide field.
19920 The second field would consist of all the text after the first space
19921 up to the next space or the end of the header.
19922 The default field number is zero, which stands for the entire line.
19923 There is also an optional third argument that is a list of field
19924 separators. It defaults to a space character.
19925 The example
19926 <P>
19927 <CENTER><SAMP>HEADER:X-Spam(10,2,:%&nbsp;)</SAMP></CENTER>
19928 <P>
19929 would cause the field separators to be any of colon, percent,
19930 or space (there is a space character between the percent and the
19931 right parenthesis).
19932 The first field runs from the start of the header value up to the first
19933 colon, percent, or space; the second goes from there to the next; and so on.
19934 In order to use a comma character as a field separator you must escape
19935 it by preceding it with a backslash (&#92;).
19936 The same is true of the backslash character itself.
19937 There is one further optional argument.
19938 It is an R or an L to specify right or left adjustment of the text
19939 within the field.
19940 The default is to left justify, however if you are displaying numbers
19941 you might prefer to right justify.
19942 <P>
19943 Here's an example of a SpamAssassin header.
19944 The exact look of the header will vary, but if your incoming mail
19945 contains headers that look like the following
19946 <P>
19947 <CENTER><SAMP>X-Spam-Status: Yes, hits=10.6 tagged_above=-999.0 required=7.0 tests=BAYE...</SAMP></CENTER>
19948 <P>
19949 you might want to display the hits value.
19950 The first field starts with the Y in Yes.
19951 To get what you're interested in you might use &quot;=&quot; and
19952 space as the field separators and display the third field, like
19953 <P>
19954 <CENTER><SAMP>HEADER:X-Spam-Status(4,3,=&nbsp;)</SAMP></CENTER>
19955 <P>
19956 or maybe you would break at the dot instead
19957 <P>
19958 <CENTER><SAMP>HEADER:X-Spam-Status(2,2,=.,R)</SAMP></CENTER>
19959 <P>
19960 Another example we've seen has headers that look like
19961 <P>
19962 <CENTER><SAMP>X-Spam: Gauge=IIIIIII, Probability=7%, Report=...</SAMP></CENTER>
19963 <P>
19964 Because there are two equals and a comma before the 7% and a comma
19965 after it, the token
19966 <P>
19967 <CENTER><SAMP>HEADER:X-Spam(3,4,=&#92;,,R)</SAMP></CENTER>
19968 <P>
19969 should display the probability (for example 7% or 83%) right justified
19970 in a 3-wide field.
19971 </DD>
19972
19973 <DT>ARROW</DT>
19974 <DD>
19975 This gives an alternative way to display the current message in the
19976 MESSAGE INDEX screen.
19977 Usually the current message is indicated by the line being shown in
19978 reverse video.
19979 Instead, if the ARROW token is included in your <!--#echo var="VAR_index-format"-->,
19980 the current line will include an &quot;arrow&quot; that
19981 looks like
19982 <P>
19983 <CENTER><SAMP>-&gt;</SAMP></CENTER>
19984 <P>
19985 in the ARROW token's field.
19986 For all of the non-current messages, the ARROW field will be filled
19987 with blanks.
19988 If you use the fixed-field width feature the length of the &quot;arrow&quot;
19989 may be adjusted.
19990 The arrow will be drawn as width-1 dashes followed by a greater than sign.
19991 For example, if you use ARROW(3) you will get
19992 <P>
19993 <CENTER><SAMP>--&gt;</SAMP></CENTER>
19994 <P>
19995 and ARROW(1) will give you just
19996 <P>
19997 <CENTER><SAMP>&gt;</SAMP></CENTER>
19998 <P>
19999 It is also possible to set the color of the ARROW field.
20000 By default (and for non-current messages) the arrow is colored the same
20001 as the index line it is part of.
20002 You may set it to be another color with the
20003 <A HREF="h_config_index_arrow_color">Index Arrow Color</A> option available from
20004 the <A HREF="h_color_setup">Setup Kolor</A> screen.
20005 </DD>
20006
20007 <DT>SCORE</DT>
20008 <DD>
20009 This gives the
20010 <a href="h_rules_score">score</a>
20011 of each message.
20012 This will be six columns wide to accomodate the widest possible score.
20013 You will probably want to use the <!--#echo var="VAR_index-format"--> fixed-field width feature
20014 to limit the width of the field to the widest score that
20015 you use (e.g. SCORE(3) if your scores are always between 0 and 999).
20016 If you have not defined any score rules the scores will all be zero.
20017 If any of your score rules contain AllText or BodyText patterns
20018 then including SCORE in the <!--#echo var="VAR_index-format"-->
20019 may slow down the display of the MESSAGE INDEX screen.
20020 </DD>
20021 </DL>
20022
20023 <P>
20024 <H1><EM>Tokens Available for all but <!--#echo var="VAR_index-format"--></EM></H1>
20025
20026 <DL>
20027 <DT>CURNEWS</DT>
20028 <DD>
20029 This token represents the current newsgroup if there is one.
20030 For example, &quot;comp.mail.pine&quot;.
20031 </DD>
20032
20033 <DT>MSGID</DT>
20034 <DD>
20035 This token represents the message ID of the message.
20036 This token does not work with Filter Rule folder names.
20037 </DD>
20038
20039 <DT>CURDATE</DT>
20040 <DD>
20041 This token represents the current date.
20042 It has the format MMM DD. For example, &quot;Oct 23&quot;.
20043 </DD>
20044
20045 <DT>CURDATEISO</DT>
20046 <DD>
20047 This token represents the current date.
20048 It has the format YYYY-MM-DD. For example, &quot;1998-10-23&quot;.
20049 </DD>
20050
20051 <DT>CURDATEISOS</DT>
20052 <DD>
20053 This token represents the current date.
20054 It has the format YY-MM-DD. For example, &quot;98-10-23&quot;.
20055 </DD>
20056
20057 <DT>CURPREFDATE</DT>
20058 <DD>
20059 This token represents the current date.
20060 It is your operating system's idea of the preferred date representation for the current locale.
20061 Internally it uses the %x version of the date from the strftime routine.
20062 </DD>
20063
20064 <DT>CURPREFTIME</DT>
20065 <DD>
20066 This token represents the current time.
20067 It is the preferred time representation for the current locale.
20068 Internally it uses the %X version of the time from the strftime routine.
20069 </DD>
20070
20071 <DT>CURPREFDATETIME</DT>
20072 <DD>
20073 This token represents the current date and time.
20074 It is the preferred date and time representation for the current locale.
20075 Internally it uses the %c version of the time from the strftime routine.
20076 </DD>
20077
20078 <DT>CURTIME24</DT>
20079 <DD>
20080 This token represents the current time.
20081 It has the format HH:MM. For example, &quot;17:28&quot;.
20082 </DD>
20083
20084 <DT>CURTIME12</DT>
20085 <DD>
20086 This token represents the current time.
20087 This time is for a 12 hour clock.
20088 It has the format HH:MMpm.
20089 For example, &quot;5:28pm&quot; or &quot;11:13am&quot;.
20090 </DD>
20091
20092 <DT>CURDAY</DT>
20093 <DD>
20094 This token represents the current day of the month.
20095 For example, &quot;23&quot; or &quot;9&quot;.
20096 </DD>
20097
20098 <DT>CURDAY2DIGIT</DT>
20099 <DD>
20100 This token represents the current day of the month.
20101 For example, &quot;23&quot; or &quot;09&quot;.
20102 It is always 2 digits.
20103 </DD>
20104
20105 <DT>CURDAYOFWEEK</DT>
20106 <DD>
20107 This token represents the current day of the week.
20108 For example, &quot;Sunday&quot; or &quot;Wednesday&quot;.
20109 </DD>
20110
20111 <DT>CURDAYOFWEEKABBREV</DT>
20112 <DD>
20113 This token represents the current day of the week.
20114 For example, &quot;Sun&quot; or &quot;Wed&quot;.
20115 </DD>
20116
20117 <DT>CURMONTH</DT>
20118 <DD>
20119 This token represents the current month.
20120 For example, &quot;10&quot; or &quot;9&quot;.
20121 </DD>
20122
20123 <DT>CURMONTH2DIGIT</DT>
20124 <DD>
20125 This token represents the current month.
20126 For example, &quot;10&quot; or &quot;09&quot;.
20127 It is always 2 digits.
20128 </DD>
20129
20130 <DT>CURMONTHLONG</DT>
20131 <DD>
20132 This token represents the current month.
20133 For example, &quot;October&quot;.
20134 </DD>
20135
20136 <DT>CURMONTHABBREV</DT>
20137 <DD>
20138 This token represents the current month.
20139 For example, &quot;Oct&quot;.
20140 </DD>
20141
20142 <DT>CURYEAR</DT>
20143 <DD>
20144 This token represents the current year.
20145 For example, &quot;1998&quot; or &quot;2001&quot;.
20146 </DD>
20147
20148 <DT>CURYEAR2DIGIT</DT>
20149 <DD>
20150 This token represents the current year.
20151 For example, &quot;98&quot; or &quot;01&quot;.
20152 It is always 2 digits.
20153 </DD>
20154
20155 <DT>LASTMONTH</DT>
20156 <DD>
20157 This token represents last month.
20158 For example, if this is November (the 11th month),
20159 it is equal to &quot;10&quot; or if this is October (the 10th month),
20160 it is &quot;9&quot;.
20161 It is possible that this and the other tokens beginning with LASTMONTH
20162 below could be useful when used with a Filtering Rule that
20163 has the &quot;Beginning of Month&quot; option set.
20164 </DD>
20165
20166 <DT>LASTMONTH2DIGIT</DT>
20167 <DD>
20168 This token represents last month.
20169 For example, if this is November (the 11th month),
20170 it is equal to &quot;10&quot; or if this is October (the 10th month),
20171 it is &quot;09&quot;.
20172 It is always 2 digits.
20173 </DD>
20174
20175 <DT>LASTMONTHLONG</DT>
20176 <DD>
20177 This token represents last month.
20178 For example, if this is November the value is &quot;October&quot;.
20179 </DD>
20180
20181 <DT>LASTMONTHABBREV</DT>
20182 <DD>
20183 This token represents last month.
20184 For example, if this is November the value is &quot;Oct&quot;.
20185 </DD>
20186
20187 <DT>LASTMONTHYEAR</DT>
20188 <DD>
20189 This token represents what the year was a month ago.
20190 For example, if this is October, 1998, it is &quot;1998&quot;.
20191 If this is January, 1998, it is &quot;1997&quot;.
20192 </DD>
20193
20194 <DT>LASTMONTHYEAR2DIGIT</DT>
20195 <DD>
20196 This token represents what the year was a month ago.
20197 For example, if this is October, 1998, it is &quot;98&quot;.
20198 If this is January, 1998, it is &quot;97&quot;.
20199 </DD>
20200
20201 <DT>LASTYEAR</DT>
20202 <DD>
20203 This token represents last year.
20204 For example, if this is 1998, it equals &quot;1997&quot;.
20205 It is possible that this
20206 could be useful when used with a Filtering Rule that
20207 has the &quot;Beginning of Year&quot; option set.
20208 </DD>
20209
20210 <DT>LASTYEAR2DIGIT</DT>
20211 <DD>
20212 This token represents last year.
20213 For example, if this is 1998, it equals &quot;97&quot;.
20214 It is always 2 digits.
20215 </DD>
20216
20217 <DT>ROLENICK</DT>
20218 <DD>
20219 This token represents the nickname of the
20220 role currently being used.  If no role is being used,
20221 then no text will be printed for this token.
20222 This token does not work with Filter Rule folder names.
20223 </DD>
20224 </DL>
20225
20226 <P>
20227 <H1><EM>Token Available Only for <!--#echo var="VAR_reply-leadin"--></EM></H1>
20228 See the help for the
20229 <A HREF="h_config_reply_intro">&quot;<!--#echo var="VAR_reply-leadin"-->&quot;</A> option
20230 to see why you might want to use this.
20231 Since the <!--#echo var="VAR_reply-leadin"--> contains free text this token
20232 must be surrounded by underscores when used.
20233
20234 <DL>
20235 <DT>NEWLINE</DT>
20236 <DD>
20237 This is an end of line marker.
20238 </DD>
20239 </DL>
20240
20241 <P>
20242 <H1><EM>Token Available Only for Templates and Signatures</EM></H1>
20243
20244 <DL>
20245 <DT>CURSORPOS</DT>
20246 <DD>
20247 This token is different from the others.
20248 When it is replaced it is replaced with nothing, but it sets an Alpine
20249 internal variable that tells the composer to start with the cursor
20250 positioned at the position where this token was.
20251 If both the template file and the signature file contain
20252 a &quot;CURSORPOS&quot; token, then the position in the template file
20253 is used.
20254 If there is a template file and neither it nor the signature file contains
20255 a &quot;CURSORPOS&quot; token, then the cursor is positioned
20256 after the end of the contents of the
20257 template file when the composer starts up.
20258 </DD>
20259 </DL>
20260
20261 <P>
20262 &lt;End of help on this topic&gt;
20263 </BODY>
20264 </HTML>
20265 ======= h_reply_token_conditionals =======
20266 <HTML>
20267 <HEAD>
20268 <TITLE>Conditional Inclusion of Text for <!--#echo var="VAR_reply-leadin"-->, Signatures, and Templates</TITLE>
20269 </HEAD>
20270 <BODY>
20271 <H1>Conditional Inclusion of Text for <!--#echo var="VAR_reply-leadin"-->, Signatures, and Templates</H1>
20272
20273 Conditional text inclusion may be used with
20274 the <A HREF="h_config_reply_intro">&quot;<!--#echo var="VAR_reply-leadin"-->&quot;</A> option,
20275 in signature files, and in template files used in
20276 <A HREF="h_rules_roles">&quot;roles&quot;</A>.
20277 It may <EM>not</EM> be used with the
20278 <A HREF="h_config_index_format">&quot;<!--#echo var="VAR_index-format"-->&quot;</A> option.
20279
20280 <P>
20281 There is a limited if-else capability for including text.
20282 The if-else condition is based
20283 on whether or not a given token would result in replacement text you
20284 specify.
20285 The syntax of this conditional inclusion is
20286 <P>
20287 <CENTER><SAMP>_token_(match_this, if_matched [ , if_not_matched ] )</SAMP></CENTER>
20288 <P>
20289 The left parenthesis must follow the underscore immediately, with no
20290 intervening space.
20291 It means the token is expanded and the results of that expansion are
20292 compared against the &quot;match_this&quot; argument.
20293 If there is an exact match, then the &quot;if_matched&quot; text is used
20294 as the replacement text.
20295 Otherwise, the &quot;if_not_matched&quot; text is used.
20296 One of the most useful values for the &quot;match_this&quot; argument is
20297 the empty string, &quot;&quot;.
20298 In that case the expansion is compared against the empty string.
20299 <P>
20300 Here's an example to make it clearer.
20301 This text could be included in one of your template files:
20302 <P>
20303 <CENTER><SAMP>_NEWS_(&quot;&quot;, &quot;I'm replying to email&quot;, &quot;I'm replying to news&quot;)</SAMP></CENTER>
20304 <P>
20305 If that is included in a template file that you are using while replying
20306 to a message (because you chose to use the role it was part of),
20307 and that message has a newsgroup header and a newsgroup in that header,
20308 then the text
20309 <P>
20310 <CENTER><SAMP>I'm replying to news</SAMP></CENTER>
20311 <P>
20312 will be included in the message you are about to compose.
20313 On the other hand, if the message you are replying to does not have
20314 a newsgroup, then the text
20315 <P>
20316 <CENTER><SAMP>I'm replying to email</SAMP></CENTER>
20317 <P>
20318 would be included instead.
20319 This would also work in signature files and in
20320 the &quot;<!--#echo var="VAR_reply-leadin"-->&quot; option.
20321 If the &quot;match_this&quot;, &quot;if_matched&quot;,
20322 or &quot;if_not_matched&quot; arguments contain
20323 spaces, parentheses, or commas;
20324 they have to be quoted with double quotation marks (like in the example
20325 above).
20326 If you want to include a literal quote (&quot;) in the text you must escape the
20327 quote by preceding it with a backslash (&#92;) character.
20328 If you want to include a literal backslash character you must escape it
20329 by preceding it with another backslash.
20330 <P>
20331 The comma followed by &quot;if_not_matched&quot; is optional.
20332 If there is no &quot;if_not_matched&quot;
20333 present then no text is included if the not_matched case is true.
20334 Here's another example:
20335 <P>
20336 <CENTER><SAMP>_NEWS_(&quot;&quot;, &quot;&quot;, &quot;This msg was seen in group: _NEWS_.&quot;)</SAMP></CENTER>
20337 <P>
20338 Here you can see that tokens may appear in the arguments.
20339 The same is true for tokens with the conditional parentheses.
20340 They may appear in arguments,
20341 though you do have to be careful to get the quoting and escaping of
20342 nested double quotes correct.
20343 If this was in the signature file being used and you were replying to a message
20344 sent to comp.mail.pine the resulting text would be:
20345 <P>
20346 <CENTER><SAMP>This msg was seen in group: comp.mail.pine.</SAMP></CENTER>
20347 <P>
20348 If you were replying to a message that wasn't sent to any newsgroup the
20349 resulting text would be a single blank line.
20350 The reason you'd get a blank line is because the end of the line is
20351 outside of the conditional, so is always included.
20352 If you wanted to get rid of that blank line you could do so by moving
20353 the end of line inside the conditional.
20354 In other words, it's ok to have multi-line
20355 &quot;if_matched&quot; or &quot;if_not_matched&quot; arguments in your
20356 template file.
20357 The text just continues until the next double quotation, even if it's not
20358 on the same line.
20359 <P>
20360 Here's an example for use in the &quot;<!--#echo var="VAR_reply-leadin"-->&quot;:
20361 <P>
20362 <CENTER><SAMP>On _DAYDATE_, _FROM__CURNEWS_(&quot;&quot;, &quot;&quot;, &quot;seen in _CURNEWS_,&quot;) wrote</SAMP></CENTER>
20363 <P>
20364 If this was in your <!--#echo var="VAR_reply-leadin"--> and you were replying to a message
20365 while reading the newsgroup comp.mail.pine the resulting text would be:
20366 <P>
20367 <CENTER><SAMP>On Sat, 24 Oct 1998, Fred Flintstone, seen in comp.mail.pine, wrote:</SAMP></CENTER>
20368 <P>
20369 If you were replying to a message while reading an email folder instead
20370 of a newsgroup the resulting leadin text would be
20371 <P>
20372 <CENTER><SAMP>On Sat, 24 Oct 1998, Fred Flintstone wrote:</SAMP></CENTER>
20373 <P>
20374 Here's one more (contrived) example illustrating a matching argument
20375 that is not the empty string.
20376 <P>
20377 <CENTER><SAMP>_SMARTDATE_("Today", _SMARTDATE_, "On _DATE_") _FROM_ wrote:</SAMP></CENTER>
20378 <P>
20379 If this was the value of your &quot;<!--#echo var="VAR_reply-leadin"-->&quot; option and you
20380 were replying to
20381 a message that was sent today, then the value of the &quot;<!--#echo var="VAR_reply-leadin"-->&quot;
20382 would be
20383 <P>
20384 <CENTER><SAMP>Today Fred Flintstone wrote:</SAMP></CENTER>
20385 <P>
20386 But if you were replying to a message sent on Oct. 27 (and that wasn't
20387 today) you would get
20388 <P>
20389 <CENTER><SAMP>On Oct 27 Fred Flintstone wrote:</SAMP></CENTER>
20390 <P>
20391
20392 &lt;End of help on this topic&gt;
20393 </BODY>
20394 </HTML>
20395 ======= h_composer_cntxt_nick =======
20396 <HTML>
20397 <HEAD>
20398 <TITLE>Collection Nickname Explained</TITLE>
20399 </HEAD>
20400 <BODY>
20401 <H1>Collection Edit Help -- Nickname Field</H1>
20402
20403 This field is provided so you can add a short nickname to use when
20404 referring to this collection within Alpine.  Spaces are allowed, and
20405 you don't need to use double-quotes.  However, the double-quote
20406 character is not allowed.
20407 <P>
20408 Look <A HREF="h_edit_nav_cmds">here</A>
20409 to see the available Editing and Navigation commands.
20410 <P>
20411 &lt;End of help on this topic&gt;
20412 </BODY>
20413 </HTML>
20414 ======= h_folder_server_syntax =======
20415 <HTML>
20416 <HEAD>
20417 <TITLE>Server Name Syntax</TITLE>
20418 </HEAD>
20419 <BODY>
20420 <H1>Server Name Syntax</H1>
20421
20422 This help describes the syntax that may be used for server names
20423 that may be associated with remote folders or SMTP servers.
20424
20425 <P>
20426 A server name is the hostname of the server.
20427 It's a good idea to use the host's fully-qualified network name.
20428
20429 <P>
20430 <CENTER><SAMP>foo.example.com</SAMP></CENTER>
20431 <P>
20432
20433 However, IP addresses are allowed if surrounded
20434 with square-brackets.
20435
20436 <P>
20437 <CENTER><SAMP>[127.0.0.1]</SAMP></CENTER>
20438 <P>
20439
20440 An optional network port number may be supplied by appending
20441 a colon (:) followed by the port number
20442 to the server name.
20443 By default, the IMAP port number, 143, is used.
20444
20445 <P>
20446 <CENTER><SAMP>foo.example.com:port</SAMP></CENTER>
20447 <P>
20448
20449 Besides server name and optional port number, various other optional
20450 parameters may be supplied that alter Alpine's interaction with the server.
20451 A parameter is supplied by appending a slash (/) character followed by
20452 the parameter's name and,
20453 depending on the particular parameter, the value assigned to that
20454 name, to the server name (and optional port number).
20455 Parameter names are <EM>not</EM> case sensitive.
20456 Currently supported parameters include:
20457
20458 <DL>
20459
20460 <DT>User</DT>
20461 <DD>This parameter requires an associated value, and is intended to
20462 provide the username identifier with which to establish the server
20463 connection.
20464 If your SMTP server offers SMTP AUTH authentication, adding this
20465 parameter to the
20466 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>
20467 option will cause Alpine to attempt to authenticate to the server using the
20468 supplied username.
20469 Similarly, if your NNTP server offers NNTP &quot;AUTHINFO SASL&quot;
20470 or &quot;AUTHINFO USER&quot; authentication, adding this parameter to the
20471 <A HREF="h_config_nntp_server"><!--#echo var="VAR_nntp-server"--></A>
20472 option (or to the server name for any folder collection using NNTP)
20473 will cause Alpine to attempt
20474 to authenticate to the server using the supplied username.
20475 An example might be:
20476
20477 <P>
20478 <CENTER><SAMP>/user=katie</SAMP></CENTER>
20479 <P>
20480
20481 </DD>
20482
20483 <DT>TLS</DT>
20484 <DD>
20485 Normally, when a new connection is made an attempt is made to
20486 negotiate a secure (encrypted) session using Transport Layer Security (TLS).
20487 If that fails then a non-encrypted connection will be attempted instead.
20488 This is a unary parameter indicating communication with the server must
20489 take place over a TLS connection. If the attempt to use TLS fails then
20490 this parameter will cause the connection to fail instead of falling
20491 back to an unsecure connection.
20492
20493 <P>
20494 <CENTER><SAMP>/tls</SAMP></CENTER>
20495 <P>
20496
20497 </DD>
20498
20499 <DT>SSL</DT>
20500 <DD>
20501 This is a unary parameter indicating communication with the server should
20502 take place over a Secure Socket Layer connection.  The server must support
20503 this method, and be prepared to accept connections on the appropriate
20504 port (993 by default).
20505 Alpine must be linked with an SSL library for this option to be operational.
20506
20507 <P>
20508 <CENTER><SAMP>/ssl</SAMP></CENTER>
20509 <P>
20510
20511 </DD>
20512
20513 <DT>TLS1</DT>
20514 <DD>
20515 This parameter indicates that the connection to the server will be made
20516 over the SSL port, but using the TLSv1 protocol, instead of the usual
20517 SSLv3 or SSLv2 protocols.
20518 Alpine must be linked with an SSL library for this option to be operational.
20519
20520 <P>
20521 <CENTER><SAMP>/tls1</SAMP></CENTER>
20522 <P>
20523
20524 </DD>
20525
20526 <DT>DTLS1</DT>
20527 <DD>
20528 This parameter indicates that the connection to the server will be made
20529 over the SSL port, but using the DTLSv1 protocol, instead of the usual
20530 SSLv3 or SSLv2 protocols.
20531 Alpine must be linked with an SSL library for this option to be operational.
20532
20533 <P>
20534 <CENTER><SAMP>/dtls1</SAMP></CENTER>
20535 <P>
20536
20537 </DD>
20538
20539 <DT>TLS1_1</DT>
20540 <DD>
20541 This parameter indicates that the connection to the server will be made
20542 over the SSL port, but using the TLSv1.1 protocol, instead of the usual
20543 SSLv3 or SSLv2 protocols.
20544 Alpine must be linked with an SSL library for this option to be operational.
20545
20546 <P>
20547 <CENTER><SAMP>/tls1_1</SAMP></CENTER>
20548 <P>
20549
20550 </DD>
20551
20552 <DT>TLS1_2</DT>
20553 <DD>
20554 This parameter indicates that the connection to the server will be made
20555 over the SSL port, but using the TLSv1.2 protocol, instead of the usual
20556 SSLv3 or SSLv2 protocols.
20557 Alpine must be linked with an SSL library for this option to be operational.
20558
20559 <P>
20560 <CENTER><SAMP>/tls1_2</SAMP></CENTER>
20561 <P>
20562
20563 </DD>
20564
20565
20566 <DT>NoValidate-Cert</DT>
20567 <DD>Do not validate certificates (for TLS or SSL connections) from the server.
20568 This is needed if the server uses self-signed certificates or if Alpine
20569 cannot validate the certificate for some other known reason.
20570 <P>
20571 </DD>
20572
20573 <DT>Anonymous</DT>
20574 <DD>This is a unary parameter (that means it does not have a value)
20575 indicating that the connection be logged in as
20576 &quot;anonymous&quot; rather than a specific user.
20577 Not all servers offer anonymous
20578 access; those which do generally only offer read-only access to certain
20579 &quot;public&quot; folders.
20580
20581 <P>
20582 <CENTER><SAMP>/anonymous</SAMP></CENTER>
20583 <P>
20584
20585 </DD>
20586
20587 <DT>Secure</DT>
20588 <DD>This is a unary parameter indicating that the connection use the
20589 most secure authentication method mutually supported by Alpine and the
20590 server.
20591 Alpine is capable of authenticating connections to
20592 the server using several methods.
20593 By default, Alpine will attempt each
20594 method until either a connection is established or the
20595 list of methods is exhausted.
20596 This parameter causes Alpine to instead fail
20597 the connection if the first (generally most &quot;secure&quot;) method fails.
20598
20599 <P>
20600 <CENTER><SAMP>/secure</SAMP></CENTER>
20601 <P>
20602
20603 </DD>
20604
20605 <DT>Submit</DT>
20606 <DD>This is a unary parameter for use with the
20607 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A> option.
20608 It indicates that the connection should be made to the Submit server
20609 (<A HREF="http://www.ietf.org/rfc/rfc2476.txt">RFC 3676</A>)
20610 (port 587) instead of the SMTP port (25).
20611 At the time this help was written the submit option was equivalent to
20612 specifying port 587.
20613
20614 <P>
20615 <CENTER><SAMP>/submit</SAMP></CENTER>
20616 <P>
20617 or
20618 <P>
20619 <CENTER><SAMP>host:587</SAMP></CENTER>
20620 <P>
20621
20622 </DD>
20623
20624 <DT>Debug</DT>
20625 <DD>This is a unary parameter indicating that the connection be established
20626 in a verbose mode.  Basically, it causes Alpine to log the communication with
20627 the server in Alpine's debug file.
20628 Normally, the pine -d command-line flag would be used instead.
20629 <P>
20630 </DD>
20631
20632 <DT>NoRsh</DT>
20633 <DD>By default, Alpine attempts to login using &quot;rsh&quot;,
20634 the UNIX remote shell program.
20635 Including &quot;NoRsh&quot; will cause connections to this server to skip
20636 the &quot;rsh&quot; attempt.
20637 This might be useful to avoid long timeouts caused by rsh firewalls, for
20638 example.
20639 <P>
20640 </DD>
20641
20642 <DT>Loser</DT>
20643 <DD>This option makes sense only for IMAP servers that do not perform
20644 a SEARCH command correctly. If your filtering rules
20645 fail to filter some messages, that should have been filtered, then this
20646 option will make Alpine download all data necessary data to perform that
20647 search. There is a performance penalty when using this option. Downloading
20648 the data to perfom the search will take longer than requesting the IMAP
20649 server to perform the filtering, but the filtering will be done correctly.
20650 <P>
20651 </DD>
20652
20653
20654 <DT>Service</DT>
20655 <DD>This parameter requires an associated value.  The default value is
20656 &quot;IMAP&quot; which indicates communication with the server based
20657 on the IMAP4rev1 protocol (defined in RFC 3501 -- see
20658 <A HREF="http://www.imap.org/docs/rfc3501.html">http://www.imap.org/docs/rfc3501.html</A>).</DD>
20659
20660 Other service values include:
20661  <DL>
20662  <DT>NNTP</DT>
20663  <DD>This value indicates communication with the server takes place via
20664 the Network News Transfer Protocol.  Use this to define a collection
20665 of newsgroups on a remote news server.  So
20666
20667 <P>
20668 <CENTER><SAMP>/service=NNTP</SAMP></CENTER>
20669 <P>
20670 or just
20671 <P>
20672 <CENTER><SAMP>/NNTP</SAMP></CENTER>
20673 <P>
20674
20675 is the way to specify NNTP access.
20676 <P>
20677  </DD>
20678
20679  <DT>POP3</DT>
20680  <DD>This value indicates communication with the server takes place via the
20681 Post Office Protocol 3 protocol.
20682
20683 <P>
20684 <CENTER><SAMP>/service=POP3</SAMP></CENTER>
20685 <P>
20686 or just
20687 <P>
20688 <CENTER><SAMP>/POP3</SAMP></CENTER>
20689 <P>
20690
20691 Note that there are several important issues
20692 to consider when selecting this option:
20693 <OL>
20694  <LI> POP3 provides access to only your INBOX.  In other words,
20695 secondary folders such as your &quot;saved-messages&quot; are inaccessible.
20696  <LI> Alpine's implementation of POP3 does not follow the traditional POP
20697 model and will leave your mail on the server. Refer to the
20698 <A HREF="h_maildrop">Mail Drop</A> functionality for a possible way around this problem.
20699  <LI> See the discussion about new-mail checking in <A HREF="h_config_reopen_rule">&quot;<!--#echo var="VAR_folder-reopen-rule"-->&quot;</A>.
20700 </OL>
20701 </DD>
20702 </DL>
20703 </DL>
20704
20705 <P>
20706 Note that it is possible to include more than one parameter in a server
20707 specification by concatenating the parameters. For example:
20708
20709 <P>
20710 <CENTER><SAMP>foo.example.com:port/user=katie/novalidate-cert/debug</SAMP></CENTER>
20711 <P>
20712
20713 <P>
20714 &lt;End of help on this topic&gt;
20715 </BODY>
20716 </HTML>
20717 ======= h_composer_cntxt_server =======
20718 <HTML>
20719 <HEAD>
20720 <TITLE>Collection Server: Explained</TITLE>
20721 </HEAD>
20722 <BODY>
20723 <H1>Collection Edit Help -- Server Field</H1>
20724
20725 This collection's &quot;Server:&quot; definition indicates the
20726 hostname of the server providing access to the folders in this
20727 collection.
20728 The syntax of this server name is the same as for other server names used
20729 in remote folder names in
20730 Alpine and is described
20731 <A HREF="h_folder_server_syntax">here</A>.
20732
20733 <P>
20734 &lt;End of help on this topic&gt;
20735 </BODY>
20736 </HTML>
20737 ======= h_composer_cntxt_path =======
20738 <HTML>
20739 <HEAD>
20740 <TITLE>Collection Path: Explained</TITLE>
20741 </HEAD>
20742 <BODY>
20743 <H1>Collection Edit Help -- Path Field</H1>
20744
20745 The collection's &quot;Path:&quot; definition indicates the location
20746 of the folders in this collection.  If the path or any of its components
20747 do not exist, Alpine will prompt you for their creation when exiting the
20748 Add/Change screen.
20749
20750 <P>
20751 By default the path is interpreted as defining a section of your personal
20752 folder area.  This area and how you specify it are defined by the
20753 server, if one is specified in the collection, or, typically, the home
20754 directory if no server is defined.
20755
20756 <P>
20757 To define a collection outside the default &quot;area&quot;, prefix
20758 the path with the &quot;namespace&quot; to use when interpreting the
20759 given path.  If a namespace is specified, the Path begins with the
20760 sharp, &quot;#&quot;, character followed by the name of the namespace
20761 and then the namespace's path-element-delimiter.  Aside from the
20762 path's format, namespaces can also imply access rights, content
20763 policy, audience, location, and, occasionally, access methods.
20764
20765 <P>
20766 Each server exports its own set (possibly of size one) of
20767 namespaces.  Hence, it's likely communication with your server's
20768 administrator will be required for specific configurations.  Some of
20769 the more common namespaces, however, include:
20770
20771 <DL>
20772 <DT>#news.</DT>
20773 <DD>This specifies a set of folders in the newsgroup namespace.  Newsgroup
20774 names are hierarchically defined with each level delimited by a period.
20775 </DD>
20776 <DT>#public/</DT>
20777 <DD>This specifies a folder area that the server may export to the general
20778 public.
20779 </DD>
20780 <DT>#shared/</DT>
20781 <DD>This specifies a folder area that the folder may export to groups
20782 of users.
20783 </DD>
20784 <DT>#ftp/</DT>
20785 <DD>This specifies a folder area that is the same as that it may have
20786 exported via the &quot;File Transfer Protocol&quot;.
20787 </DD>
20788 <DT>#mh/</DT>
20789 <DD>This specifies the personal folder area associated with folders
20790 and directories that were created using the MH message handling system.
20791 </DD>
20792 </DL>
20793 <P>
20794
20795 In addition, the server may support access to other user's folders,
20796 provided you have suitable permissions.  Common methods use a prefix
20797 of either &quot;~<VAR>user</VAR>/&quot;, or &quot;/<VAR>user</VAR>/&quot; to
20798 indicate the root of the other user's folder area.
20799
20800 <P>
20801 No, nothing's simple.
20802
20803 <P>
20804 &lt;End of help on this topic&gt;
20805 </BODY>
20806 </HTML>
20807 ======= h_composer_cntxt_view =======
20808 <HTML>
20809 <HEAD>
20810 <TITLE>Collection View: Explained</TITLE>
20811 </HEAD>
20812 <BODY>
20813 <H1>Collection Edit Help -- View Field</H1>
20814
20815 The collection's &quot;View:&quot; definition provides a way to limit
20816 the displayed list of folders within a collection.  By default, only
20817 folders that contain the specified characters anywhere in their name
20818 are shown in the collection's folder list.
20819
20820 <P>
20821 Additionally, you can use a wildcard character to better control
20822 the list of folders selected for display.  The wildcard specifier is
20823 the star, &quot;*&quot;, character.
20824
20825 <P>
20826 So, for example, to define a collection of all folders ending with
20827 &quot;c&quot;, you'd specify a view of &quot;*c&quot; (without the
20828 quote characters!).  Or, similarly, to define a collection of folders
20829 whose names start with &quot;a&quot; and end with &quot;z&quot;, you'd
20830 specify a view of &quot;a*z&quot;.
20831
20832 <P>
20833 &lt;End of help on this topic&gt;
20834 </BODY>
20835 </HTML>
20836 ======= h_composer_abook_add_server =======
20837 <HTML>
20838 <HEAD>
20839 <TITLE>Addressbook Server Name Field Explained</TITLE>
20840 </HEAD>
20841 <BODY>
20842 This field should be left blank if the address book is stored in a regular
20843 file on this system.  If it is a remote address book stored on an IMAP
20844 server then this is the name of that IMAP server.
20845 <P>
20846 Look <A HREF="h_edit_nav_cmds">here</A>
20847 to see the available Editing and Navigation commands.
20848 <P>
20849 &lt;End of help on this topic&gt;
20850 </BODY>
20851 </HTML>
20852 ======= h_composer_abook_add_folder =======
20853 <HTML>
20854 <HEAD>
20855 <TITLE>Addressbook Folder Name Field Explained</TITLE>
20856 </HEAD>
20857 <BODY>
20858 For a remote address book (one for which the Server Name is filled in)
20859 this is the name of a folder on the remote server. The address book data
20860 will be stored in this folder. This folder should be used only for
20861 storing this single address book, not for other address books or for
20862 other messages.
20863 <P>
20864 For a local address book (one for which the Server Name is not filled in)
20865 this is the name of a file in which the address book will be stored.
20866 The file is in the same directory as the Alpine configuration file if the
20867 configuration file is local.
20868 If the configuration file is remote, then this will be in the home directory
20869 for Unix Alpine and in the directory specified by the
20870 &quot;-aux local_directory&quot; command line argument.
20871 <P>
20872 Look <A HREF="h_edit_nav_cmds">here</A>
20873 to see the available Editing and Navigation commands.
20874 <P>
20875 &lt;End of help on this topic&gt;
20876 </BODY>
20877 </HTML>
20878 ======= h_composer_abook_add_nick =======
20879 <HTML>
20880 <HEAD>
20881 <TITLE>Addressbook NickName Field Explained</TITLE>
20882 </HEAD>
20883 <BODY>
20884 This is just an optional nickname for this address book. If present, it
20885 is used in some of the displays and error messages in the address book
20886 maintenance screens. It is for your convenience only and serves no
20887 other purpose.
20888 <P>
20889 Look <A HREF="h_edit_nav_cmds">here</A>
20890 to see the available Editing and Navigation commands.
20891 <P>
20892 &lt;End of help on this topic&gt;
20893 </BODY>
20894 </HTML>
20895 ======= h_composer_qserv_cn =======
20896 <HTML>
20897 <HEAD>
20898 <TITLE>Directory Query Form Explained</TITLE>
20899 </HEAD>
20900 <BODY>
20901
20902 Fill in as many of these fields as you wish to narrow down your
20903 search. All the fields you fill in must match in order for an entry
20904 to be returned. You may use the wildcard character &quot;*&quot; in
20905 any of the fields, it matches any zero or more characters at that
20906 point in the string. There are no implicit wildcards, so the match is
20907 exact unless you include wildcards.
20908 <P>
20909
20910 Note that if an attribute isn't present at all, then the match will fail.
20911 For example, if a server doesn't support the Locality attribute, then no
20912 matter what you put in the Locality field (other than leaving it empty)
20913 the search will fail.
20914 <P>
20915
20916 This field, the Common Name field, is typically a person's full name.
20917 <P>
20918
20919 <H1>EDITING and NAVIGATION COMMANDS</H1>
20920 <!--chtml if pinemode="function_key"-->
20921 <PRE>
20922 CURSOR MOTION KEYS----------------------|EDITING KEYS-------------------------
20923 ^B (Left Arrow)    Back character       | ^D       Delete current character
20924 ^F (Right Arrow)   Forward character    | ^H (DEL) Delete previous character
20925 ^P (Up Arrow)      Previous line        |
20926 ^N (Down Arrow)    Next line            | F9       Cut marked text or
20927 ^A                 Beginning of line    |            delete current line
20928 ^E                 End of line          | F10      Undelete line(s)
20929 F7                 Previous page        |
20930 F8                 Next page            |-------------------------------------
20931 ^@ (Ctrl-SPACE)    Next word            | MISCELLANEOUS COMMANDS
20932 ----------------------------------------|
20933 EXIT COMMANDS    |  GENERAL COMMANDS    | F5    Restore previous search
20934 F2   Cancel      |   F1    Get help     |
20935 F3   Search      |   ^Z    Suspend      | ^L    Redraw Screen
20936 </PRE>
20937 <!--chtml else-->
20938 <PRE>
20939 CURSOR MOTION KEYS----------------------|EDITING KEYS-------------------------
20940 ^B (Left Arrow)    Back character       | ^D       Delete current character
20941 ^F (Right Arrow)   Forward character    | ^H (DEL) Delete previous character
20942 ^P (Up Arrow)      Previous line        |
20943 ^N (Down Arrow)    Next line            | ^K       Cut marked text or
20944 ^A                 Beginning of line    |            delete current line
20945 ^E                 End of line          | ^U       Undelete line(s)
20946 ^Y                 Previous page        |
20947 ^V                 Next page            |-------------------------------------
20948 ^@ (Ctrl-SPACE)    Next word            | MISCELLANEOUS COMMANDS
20949 ----------------------------------------|
20950 EXIT COMMANDS    |  GENERAL COMMANDS    | ^R     Restore previous search
20951 ^C   Cancel      |   ^G    Get help     |
20952 ^X   Search      |   ^Z    Suspend      | ^L     Redraw Screen
20953 </PRE>
20954 <!--chtml endif-->
20955 <P><UL>
20956 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
20957 </UL><P>
20958 &lt;End of help on this topic&gt;
20959 </BODY>
20960 </HTML>
20961 ======= h_composer_qserv_sn =======
20962
20963 The Surname is usually the family name of a person.
20964
20965 <End of help on this topic>
20966 ======= h_composer_qserv_gn =======
20967
20968 This is the part of a person's name that isn't the surname or initials.
20969
20970 <End of help on this topic>
20971 ======= h_composer_qserv_mail =======
20972
20973 This is the email address of a person.
20974
20975 <End of help on this topic>
20976 ======= h_composer_qserv_org =======
20977
20978 This is the organization a person belongs to.
20979
20980 <End of help on this topic>
20981 ======= h_composer_qserv_unit =======
20982
20983 This is the organizational unit a person belongs to.
20984
20985 <End of help on this topic>
20986 ======= h_composer_qserv_country =======
20987
20988 This is the country a person belongs to.
20989
20990 <End of help on this topic>
20991 ======= h_composer_qserv_state =======
20992
20993 This is the state a person belongs to.
20994
20995 <End of help on this topic>
20996 ======= h_composer_qserv_locality =======
20997
20998 This is the locality a person belongs to.
20999
21000 <End of help on this topic>
21001 ======= h_composer_qserv_custom =======
21002
21003 This one is for advanced users only! If you put something in this field,
21004 then the rest of the fields are ignored.
21005
21006 This field may be set to the string representation of an LDAP search
21007 filter (see RFC1960). Here are some examples:
21008
21009 To search for an entry with a surname equal to "clinton" you could set
21010 the custom filter to:
21011
21012      (sn=clinton)
21013
21014 This is equivalent to putting "clinton" in the SurName field.
21015 To search for an entry that has a surname that begins with "clint" and
21016 has a givenname equal to "william" you could use:
21017
21018      (&(sn=clint*)(givenname=william))
21019
21020 This is equivalent to setting the SurName field to "clint*" and the
21021 GivenName field to "william".
21022 To search for an entry where either the common name OR the email address
21023 contains "abcde" you could use:
21024
21025      (|(cn=*abcde*)(mail=*abcde*))
21026
21027 That isn't equivalent to anything you can do by setting the other fields
21028 because of the OR.
21029
21030 <End of help on this topic>
21031 ======= h_composer_qserv_qq =======
21032
21033 This one is a little different from the rest of the categories.  It causes
21034 a search to be formed from the configured search filter that you filled
21035 in when you added the directory server to your configuration. It can also
21036 be combined with the other fields if you'd like.
21037
21038 <End of help on this topic>
21039 ======= h_address_format =======
21040 <HTML>
21041 <HEAD>
21042 <TITLE>INTERNET EMAIL ADDRESS FORMAT</TITLE>
21043 </HEAD>
21044 <BODY>
21045 <H1>INTERNET EMAIL ADDRESS FORMAT</H1>
21046
21047 A valid email address on the Internet has a username, an &quot;@&quot; sign,
21048 and then a domain, with no spaces.
21049 For example, jsmith@art.example.com might be the email address
21050 of a person
21051 with the username &quot;jsmith&quot; who has an account in the domain
21052 &quot;art.example.com&quot;.  The number of dot-separated segments on the
21053 right of the &quot;@&quot; sign can vary - a shorter example would be
21054 isabelle@elsewhere.edu (the shortest possible form: here, only the
21055 organization's domain is specified after the &quot;@&quot; sign); a longer
21056 example would be
21057  jsingh@shakti.edutech.example.com
21058 (here, the name of the host &quot;shakti&quot; in the domain
21059 edutech.example.com is also specified).
21060 <P>
21061 If you do not know the exact email address of someone you want to write
21062 to, ask them what it is using other means of communication than email; or
21063 use the tools for
21064 finding people's addresses that are available on the Internet.
21065 <P>
21066 If you are sending to someone on the same system as you are, you can leave
21067 the &quot;@&quot; sign and all the information to its right off of the
21068 address, and Alpine will fill it in automatically,
21069 unless the feature
21070 <A HREF="h_config_compose_rejects_unqual">&quot;<!--#echo var="FEAT_compose-rejects-unqualified-addrs"-->&quot;</A> is set in SETUP CONFIGURATION.
21071 <P>
21072
21073 When an email address you send a message to is not reachable -- either because
21074 it is simply an incorrect address, or because email can temporarily not be
21075 delivered to it due to a technical problem on the way to or at the recipient's
21076 end -- you will almost always get an error notification email message back.
21077 <P>
21078 If you encounter problems with, or have questions about, email delivery or
21079 email address syntax, contact your local network computing consultants.
21080 <P><UL>
21081 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21082 </UL>
21083 <P>
21084 &lt;End of help on this topic&gt;
21085 </BODY>
21086 </HTML>
21087 ======= h_flag_user_flag =======
21088 <HTML>
21089 <HEAD>
21090 <TITLE>STATUS FLAG: User Defined Keyword</TITLE>
21091 </HEAD>
21092 <BODY>
21093 <H1>STATUS FLAG: User Defined Keyword</h1>
21094
21095 This is a keyword that is defined for this folder.
21096 It was most likely defined by the owner of the folder.
21097 Alpine will not set or clear this flag on its own.
21098
21099 <P><UL>
21100 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21101 </UL><P>
21102 &lt;End of help on this topic&gt;
21103 </BODY>
21104 </HTML>
21105 ======= h_flag_important =======
21106 <html>
21107 <title>STATUS FLAG: Important</title>
21108 <body>
21109 <h1>STATUS FLAG: Important</h1>
21110
21111
21112 The <EM>Important</EM> flag, indicated by an asterisk in Alpine's
21113 MESSAGE&nbsp;INDEX
21114 screen, can only be set by the user, and is intended to be used in
21115 whatever fashion makes sense to you.  You are the only one that can set or
21116 clear it.
21117
21118 <P>
21119 &lt;End of help on this topic&gt;
21120 </BODY>
21121 </HTML>
21122 ======= h_flag_new =======
21123 <html>
21124 <title>STATUS FLAG: New</title>
21125 <body>
21126 <h1>STATUS FLAG: New</h1>
21127
21128
21129 The <EM>New</EM> flag, indicated by the letter 'N' in Alpine's
21130 MESSAGE&nbsp;INDEX screen,
21131 is automatically set when messages are delivered to your Inbox (or other
21132 folder specified outside of Alpine).  Likewise, it is cleared automatically
21133 the first time you read the message it is associated with.
21134
21135 <P>
21136 Sometimes it's helpful in prioritizing your mail.  For example, perhaps
21137 a message isn't weighty enough to assign it an <A HREF="h_flag_important">Important</A> flag, but
21138 you'd like to be reminded of it next time you read mail.  This can be done
21139 easily by <A HREF="h_common_flag">explicitly</A> resetting the <EM>New</EM> flag.
21140
21141
21142 <P>
21143 &lt;End of help on this topic&gt;
21144 </BODY>
21145 </HTML>
21146 ======= h_flag_answered =======
21147 <html>
21148 <title>STATUS FLAG: Answered</title>
21149 <body>
21150 <h1>STATUS FLAG: Answered</h1>
21151
21152 The <EM>Answered</EM> flag, indicated by the letter 'A' in Alpine's
21153 MESSAGE&nbsp;INDEX
21154 screen, is automatically set when you reply to a message.  This flag is not
21155 automatically cleared.
21156
21157 <P>
21158 &lt;End of help on this topic&gt;
21159 </BODY>
21160 </HTML>
21161 ======= h_flag_forwarded =======
21162 <html>
21163 <title>STATUS FLAG: Forwarded</title>
21164 <body>
21165 <h1>STATUS FLAG: Forwarded</h1>
21166
21167 The <EM>Forwarded</EM> flag, indicated by the letter 'F' in Alpine's
21168 MESSAGE&nbsp;INDEX
21169 screen, is automatically set when you forward a message.  This flag is not
21170 automatically cleared.
21171
21172 <P>
21173 &lt;End of help on this topic&gt;
21174 </BODY>
21175 </HTML>
21176 ======= h_flag_deleted =======
21177 <html>
21178 <title>STATUS FLAG: Deleted</title>
21179 <body>
21180 <h1>STATUS FLAG: Deleted</h1>
21181
21182 The <EM>Deleted</EM> flag, indicated by the letter 'D' in Alpine's
21183 MESSAGE&nbsp;INDEX
21184 screen, is set when you use the &quot;"D&nbsp;Delete&quot; command.
21185 It is cleared
21186 when you use the &quot;U&nbsp;Undelete&quot; command.
21187
21188 <P>
21189 Messages marked with this flag will be permanently removed from
21190 the folder when you issue the <A HREF="h_index_cmd_expunge">Expunge</A>
21191 command, or
21192 when you indicate acceptance of their removal upon leaving the folder.
21193
21194 <P>
21195 Note, there can be other actions implicit in the
21196 &quot;D&nbsp;Delete&quot; command,
21197 such as advancing to the next message, that may be momentarily undesirable.
21198 For this reason, it's sometimes useful to set or clear the <EM>Deleted</EM>
21199 flag <A HREF="h_common_flag">explicitly</A>.
21200
21201 <P>
21202 &lt;End of help on this topic&gt;
21203 </BODY>
21204 </HTML>
21205 ====== h_config_incoming_timeo ======
21206 <HTML>
21207 <HEAD>
21208 <TITLE>OPTION: <!--#echo var="VAR_incoming-check-timeout"--></TITLE>
21209 </HEAD>
21210 <BODY>
21211 <H1>OPTION: <!--#echo var="VAR_incoming-check-timeout"--></H1>
21212
21213 This option has no effect unless the feature
21214 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
21215 is set, which in turn has no effect unless
21216 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
21217 is set.
21218 <P>
21219 Sets the time in seconds that Alpine will
21220 attempt to open a network connection used for monitoring for Unseen
21221 messages in Incoming Folders. The default is 5.
21222 If a connection has not completed within this many seconds Alpine will
21223 give up and consider it a failed connection.
21224 <P>
21225 <UL>
21226 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21227 </UL><P>
21228 &lt;End of help on this topic&gt;
21229 </BODY>
21230 </HTML>
21231 ====== h_config_psleep ======
21232 <HTML>
21233 <HEAD>
21234 <TITLE>OPTION: <!--#echo var="VAR_mailcap-check-interval"--> (UNIX Alpine only)</TITLE>
21235 </HEAD>
21236 <BODY>
21237 <H1>OPTION: <!--#echo var="VAR_mailcap-check-interval"--> (UNIX Alpine only)</H1>
21238
21239 <P>
21240 In the good old days a mailcap viewer was used to examine an
21241 attachment before saving it, and after viewing the attachment control
21242 would return to the operating system when the viewer was closed. Therefore,
21243 when the mailcap viewer returned control to the operating system, it
21244 could be assumed that the user who opened the attachment was done
21245 examining it, and the copy of the attachment that was used, could be removed.
21246
21247 <P>
21248 However, today this assumption is not longer valid. Some viewers return
21249 control to the operating system before they actually read the attachment
21250 to be examined. This causes Alpine to delete the attachment before it
21251 is read by the viewer, causing the viewer to fail opening the attachment.
21252
21253 <P>
21254 In order to work around this problem, Alpine checks, after the viewer has
21255 returned control to the operating system, if there is any process that is
21256 using the attachment. This variable controls the number of seconds that
21257 must elapse between checks. Once it is found that no process is using the
21258 attachment, this is removed.
21259
21260 <P>
21261 The minimum value for this variable is 60 (checks will be made once per
21262 minute), and the maximum value is 600 (checks will be made once every 10
21263 minutes). The default value is 60.
21264
21265 <P>
21266 <UL>
21267 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21268 </UL><P>
21269 &lt;End of help on this topic&gt;
21270 </BODY>
21271 </HTML>
21272 ====== h_config_incoming_interv ======
21273 <HTML>
21274 <HEAD>
21275 <TITLE>OPTION: <!--#echo var="VAR_incoming-check-interval"--></TITLE>
21276 </HEAD>
21277 <BODY>
21278 <H1>OPTION: <!--#echo var="VAR_incoming-check-interval"--></H1>
21279
21280 This option has no effect unless the feature
21281 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
21282 is set, which in turn has no effect unless
21283 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
21284 is set.
21285 <P>
21286 This option specifies, in seconds, how often Alpine will check
21287 for new mail and state changes in Incoming Folders when Incoming Folders
21288 Checking is turned on.
21289 The default is 3 minutes (180).
21290 This value applies only to folders that are local to the system that
21291 Alpine is running on or that are accessed using the IMAP protocol.
21292 The similar option
21293 <A HREF="h_config_incoming_second_interv"><!--#echo var="VAR_incoming-check-interval-secondary"--></A>
21294 applies to all other monitored folders.
21295 <P>
21296 <UL>
21297 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21298 </UL><P>
21299 &lt;End of help on this topic&gt;
21300 </BODY>
21301 </HTML>
21302 ====== h_config_incoming_second_interv ======
21303 <HTML>
21304 <HEAD>
21305 <TITLE>OPTION: <!--#echo var="VAR_incoming-check-interval-secondary"--></TITLE>
21306 </HEAD>
21307 <BODY>
21308 <H1>OPTION: <!--#echo var="VAR_incoming-check-interval-secondary"--></H1>
21309
21310 This option has no effect unless the feature
21311 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
21312 is set, which in turn has no effect unless
21313 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
21314 is set.
21315 <P>
21316 This option together with the option
21317 <A HREF="h_config_incoming_interv"><!--#echo var="VAR_incoming-check-interval"--></A>
21318 specifies, in seconds, how often Alpine will check
21319 for new mail and state changes in Incoming Folders when Incoming Folders
21320 Checking is turned on.
21321 The default for this option is 3 minutes (180).
21322 For folders that are local to this system or
21323 that are accessed using the IMAP protocol
21324 the value of the option
21325 <A HREF="h_config_incoming_interv"><!--#echo var="VAR_incoming-check-interval"--></A>
21326 is used.
21327 For all other monitored folders, the value of this option is used.
21328 <P>
21329 The reason there are two separate options is because it is usually
21330 less expensive to check local and IMAP folders than it is to check
21331 other types, like POP or NNTP folders.
21332 You may want to set this secondary value to a higher number than
21333 the primary check interval.
21334 <P>
21335 <UL>
21336 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21337 </UL><P>
21338 &lt;End of help on this topic&gt;
21339 </BODY>
21340 </HTML>
21341 ====== h_config_incoming_list ======
21342 <HTML>
21343 <HEAD>
21344 <TITLE>OPTION: <!--#echo var="VAR_incoming-check-list"--></TITLE>
21345 </HEAD>
21346 <BODY>
21347 <H1>OPTION: <!--#echo var="VAR_incoming-check-list"--></H1>
21348
21349 This option has no effect unless the feature
21350 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
21351 is set, which in turn has no effect unless
21352 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
21353 is set.
21354 <P>
21355 When monitoring the Incoming Message Folders for Unseen messages Alpine will
21356 normally monitor all Incoming Folders.
21357 You may use this option to restrict the list of monitored folders to a
21358 subset of all Incoming Folders.
21359 <P>
21360 <UL>
21361 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21362 </UL><P>
21363 &lt;End of help on this topic&gt;
21364 </BODY>
21365 </HTML>
21366 ====== h_config_pers_name ======
21367 <HTML>
21368 <HEAD>
21369 <TITLE>OPTION: <!--#echo var="VAR_personal-name"--></TITLE>
21370 </HEAD>
21371 <BODY>
21372 <H1>OPTION: <!--#echo var="VAR_personal-name"--></H1>
21373
21374 This value is used to determine the full name part of the "From" address
21375 on messages you send.
21376 <!--chtml if pinemode="os_windows"-->
21377  PC-Alpine requires that this be set in order to properly construct the "From" address.
21378 <!--chtml else-->
21379  If unset, Unix Alpine will obtain your full name from
21380  the system password file. PC-Alpine, on the other hand, requires that this be set.
21381 <!--chtml endif-->
21382 <P>
21383 If you want to change the value of what gets included in the From header
21384 in messages you send (other than just the Personal Name)
21385 look <A HREF="h_config_change_your_from">here</A> for a description.
21386 <P><UL>
21387 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21388 </UL><P>
21389 &lt;End of help on this topic&gt;
21390 </BODY>
21391 </HTML>
21392 ====== h_config_pruned_folders ======
21393 <html>
21394 <header>
21395 <title>OPTION: <!--#echo var="VAR_pruned-folders"--></title>
21396 </header>
21397 <body>
21398 <h1>OPTION: <!--#echo var="VAR_pruned-folders"--></h1>
21399
21400 This variable allows you to define a list of one or more folders that
21401 Alpine will offer to prune for you in the same way it automatically offers
21402 to prune your "sent-mail" folder each month.
21403 Each folder in this list must be a folder in your default folder collection
21404 (the first folder collection if you have more than one), and it is just
21405 the relative name of the folder in the collection, not the fully-qualified name.
21406 It is similar to sent-mail.
21407 Instead of something like
21408 <P>
21409 <CENTER><SAMP><!--#echo var="VAR_pruned-folders"-->={servername}mail/folder</SAMP></CENTER>
21410 <P>
21411 the correct value to use would be
21412 <P>
21413 <CENTER><SAMP>folder</SAMP></CENTER>
21414 <P>
21415 There is an assumption here that your first collection is the folders in
21416 <P>
21417 <CENTER><SAMP>{servername}mail</SAMP></CENTER>
21418 <P>
21419
21420 Once a month, for each folder listed, Alpine will offer to move
21421 the contents of the folder to a new folder of the same name but with
21422 the previous month's date appended.  Alpine will then look for any such
21423 date-appended folder names created for a previous month, and offer each
21424 one it finds for deletion.
21425 <P>
21426
21427 If you decline the first offer, no mail is moved and no new folder is
21428 created.
21429 <P>
21430
21431 The new folders will be created
21432 in your default folder collection.
21433 <P>
21434
21435 <UL>
21436 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21437 </UL><P>
21438 &lt;End of help on this topic&gt;
21439 </body>
21440 </html>
21441 ====== h_config_upload_cmd ======
21442 <HTML>
21443 <HEAD>
21444 <TITLE>OPTION: <!--#echo var="VAR_upload-command"--></TITLE>
21445 </HEAD>
21446 <BODY>
21447 <H1>OPTION: <!--#echo var="VAR_upload-command"--></H1>
21448
21449 This option affects the behavior of the Composer's &quot;Read File&quot;
21450 (^R in the message body) and &quot;Attach File&quot; (^J in the header)
21451 commands.  It specifies
21452 a Unix program name, and any necessary command line arguments, that Alpine can
21453 use to transfer files from your personal computer into messages that you are
21454 composing.<P>
21455
21456 <B>Note:</B> this facility is intended for use with serial line transfer
21457 protocols, such as kermit, xmodem, or zmodem.  It is <B>not</B> intended
21458 to work with TCP/IP file transfer programs such as ftp.<P>
21459
21460 If a program is specified, the commands listed above are modified to offer a
21461 subcommand (^Y) to activate the transfer.  Obviously, the Unix program
21462 specified here must match the transfer program or protocol available on the
21463 personal computer.<P>
21464
21465 Alpine expects to exchange uploaded data via a file on your Unix system.  When
21466 the specified upload program finishes, Alpine expects the uploaded data to be
21467 contained in this file.<P>
21468
21469 When upload is invoked via the &quot;Read File&quot; subcommand, Alpine
21470 generates a
21471 temporary file name that it will pass to the specified Unix program.  Alpine
21472 will read the resulting uploaded text from this file and then delete it when
21473 the upload command is finished.<P>
21474
21475 When upload is invoked via the &quot;Attach File&quot; subcommand, Alpine will
21476 prompt
21477 you for the name of the file that is to contain the uploaded information that
21478 it is to attach.  Alpine will attach this file to the composition, but will
21479 <B>not</B> delete this file after the upload command is finished.<P>
21480
21481 The special token &quot;_FILE_&quot; may be included among the Unix program's
21482 command
21483 line arguments.  Alpine will replace this symbol with the name of the file
21484 being used to exchange the uploaded information.  This token allows you to
21485 position the file name where it is required in the Unix program's command
21486 line arguments.<P>
21487
21488 If the &quot;_FILE_&quot; token is not present in the specified command, the
21489 temporary file's name is automatically appended to the specified Unix
21490 program.  In other words, you don't need to use &quot;_FILE_&quot; if it is the
21491 <B>last</B> command line argument.
21492 <P><UL>
21493 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21494 </UL><P>
21495 &lt;End of help on this topic&gt;
21496 </BODY>
21497 </HTML>
21498 ====== h_config_upload_prefix ======
21499 <HTML>
21500 <HEAD>
21501 <TITLE>OPTION: <!--#echo var="VAR_upload-command-prefix"--></TITLE>
21502 </HEAD>
21503 <BODY>
21504 <H1>OPTION: <!--#echo var="VAR_upload-command-prefix"--></H1>
21505
21506 This option is used in conjunction with the <!--#echo var="VAR_upload-command"--> option.
21507 It defines text to be written to the terminal emulator (via standard output)
21508 immediately prior to starting upload command.  This is useful for
21509 integrated serial line file transfer agents that permit command passing
21510 (e.g., Kermit's APC method).<P>
21511
21512 The special token &quot;_FILE_&quot; may be included in the string specification.
21513 That symbol will be replaced with the (Alpine-created) name of the temporary
21514 file in which Alpine will expect to find the uploaded file.
21515 <P><UL>
21516 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21517 </UL><P>
21518 &lt;End of help on this topic&gt;
21519 </BODY>
21520 </HTML>
21521 ====== h_config_download_cmd ======
21522 <HTML>
21523 <HEAD>
21524 <TITLE>OPTION: <!--#echo var="VAR_download-command"--></TITLE>
21525 </HEAD>
21526 <BODY>
21527 <H1>OPTION: <!--#echo var="VAR_download-command"--></H1>
21528
21529 This option affects the behavior of the Export command.  It specifies a Unix
21530 program name, and any necessary command line arguments, that Alpine can use to
21531 transfer the exported message to your personal computer's disk.<P>
21532 Note: this facility is intended for use with serial line transfer
21533 protocols, such as kermit, xmodem, or zmodem.  It is <B>not</B> intended
21534 to work with TCP/IP file transfer programs such as ftp.<P>
21535 If a program is specified, the Export command is modified to offer a
21536 subcommand (^V) to activate the transfer (in lieu of saving it to
21537  the machine where Alpine is running).  Obviously, the Unix program
21538 specified here must match the transfer program or protocol available on the
21539 personal computer.<P>
21540
21541 When this subcommand is selected and before Alpine invokes the specified Unix
21542 program, Alpine will create a temporary file containing the text of the
21543 exported message.  Alpine uses this file to pass the exported message text to
21544 the specified Unix program.<P>
21545
21546 The special token &quot;_FILE_&quot; may be included among the Unix program's command
21547 line arguments.  Alpine will replace this symbol with the temporary file's name
21548 before executing the Unix program.  This token allows you to position the
21549 file name where it is required in the Unix program's command line arguments.
21550 <P>
21551 If the &quot;_FILE_&quot; token is not present in the specified command, the
21552 temporary file's name is automatically appended to the specified Unix
21553 program.  In other words, you don't need to use &quot;_FILE_&quot; if it is the
21554 <B>last</B> command line argument.
21555 <P><UL>
21556 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21557 </UL><P>
21558 &lt;End of help on this topic&gt;
21559 </BODY>
21560 </HTML>
21561 ====== h_config_download_prefix ======
21562 <HTML>
21563 <HEAD>
21564 <TITLE>OPTION: <!--#echo var="VAR_download-command-prefix"--></TITLE>
21565 </HEAD>
21566 <BODY>
21567 <H1>OPTION: <!--#echo var="VAR_download-command-prefix"--></H1>
21568
21569 This option is used in conjunction with the <!--#echo var="VAR_download-command"--> option.
21570 It defines text to be written to the terminal emulator (via standard output)
21571 immediately prior to starting the download command.  This is useful for
21572 integrated serial line file transfer agents that permit command passing
21573 (e.g., Kermit's APC method).
21574 <P>
21575 The special token &quot;_FILE_&quot; may be included in the string
21576 specification.
21577 That symbol will be replaced with the (Alpine-created) name of the temporary
21578 file into which Alpine will place the message to be downloaded.
21579 <P><UL>
21580 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21581 </UL><P>
21582 &lt;End of help on this topic&gt;
21583 </BODY>
21584 </HTML>
21585 ====== h_config_mailcap_path ======
21586 <HTML>
21587 <HEAD>
21588 <TITLE>OPTION: <!--#echo var="VAR_mailcap-search-path"--></TITLE>
21589 </HEAD>
21590 <BODY>
21591 <H1>OPTION: <!--#echo var="VAR_mailcap-search-path"--></H1>
21592 This variable is used to replace Alpine's default mailcap file search path.
21593 It takes one or more file names (full paths must be specified) in which to
21594 look for mail capability data.  The default search path can be found in this
21595 <A HREF="h_news_config">Alpine Configuration</A> help, near the bottom.
21596 If there is more than one file name listed, list members should be delimited
21597 by
21598 <!--chtml if pinemode="os_windows"-->
21599 a semi-colon (;) under Windows; for example:<PRE>
21600         C:&#92;MYCONFIG&#92;MAILCAP.TXT;H:&#92;NETCONFIG&#92;MAILCAP.TXT
21601 </PRE>
21602 <!--chtml else-->
21603 a colon (:) under UNIX; for example:<PRE>
21604         ~/.mailcap:/etc/mailcap:/usr/etc/mailcap:/usr/local/etc/mailcap
21605 </PRE>
21606 <!--chtml endif-->
21607 <P><UL>
21608 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21609 </UL>
21610 <P>
21611 &lt;End of help on this topic&gt;
21612 </BODY>
21613 </HTML>
21614 ====== h_config_mimetype_path ======
21615 <HTML>
21616 <HEAD>
21617 <TITLE>OPTION: <!--#echo var="VAR_mimetype-search-path"--></TITLE>
21618 </HEAD>
21619 <BODY>
21620 <H1>OPTION: <!--#echo var="VAR_mimetype-search-path"--></H1>
21621
21622 This variable is used to replace Alpine's default mime.types file search path.
21623 It takes one or more file names (full paths must be specified) in which to
21624 look for file-name-extension to MIME type mapping data.  The default search
21625 path can be found in this
21626 <A HREF="h_news_config">Alpine Configuration</A> help.
21627
21628 <P>
21629
21630 If there is more than one file name listed, list members should be delimited
21631 by a colon (:) under UNIX and a semi-colon (;) under Windows.
21632 <P>
21633 &lt;End of help on this topic&gt;
21634 </BODY></HTML>
21635 ====== h_config_set_att_ansi ======
21636 <HTML><HEAD>
21637 <TITLE>OPTION: Set printer to attached ansi printer</TITLE>
21638 </HEAD>
21639 <BODY>
21640 <H1>OPTION: Set printer to attached ansi printer</H1>
21641
21642 Type "S" to set your printer to "attached-to-ansi".<BR>
21643 It is OK to include "attached-to-ansi" in your personal list below.
21644 <P>
21645 &lt;End of help on this topic&gt;
21646 </BODY></HTML>
21647 ====== h_config_set_att_ansi2 ======
21648 <HTML><HEAD>
21649 <TITLE>OPTION: Set printer to attached ansi printer (no formfeed)</TITLE>
21650 </HEAD>
21651 <BODY>
21652 <H1>OPTION: Set printer to attached ansi printer (no formfeed)</H1>
21653
21654 Type "S" to set your printer to "attached-to-ansi-no-formfeed".<BR>
21655 It is OK to include "attached-to-ansi-no-formfeed" in your personal
21656 list below.
21657
21658 <P>
21659
21660 This is the same as the "attached-to-ansi" option except that a
21661 formfeed character will not be appended to the end of the print job.
21662 If your printer already ejects the paper by itself at the end of the
21663 job, you may prefer the "no-formfeed" form of this printer so that you
21664 don't get an extra blank page between print jobs.
21665 <P>
21666
21667 &lt;End of help on this topic&gt;
21668 </BODY></HTML>
21669 ====== h_config_set_att_wyse ======
21670 <HTML><HEAD>
21671 <TITLE>OPTION: Set printer to attached Wyse60 printer</TITLE>
21672 </HEAD>
21673 <BODY>
21674 <H1>OPTION: Set printer to attached Wyse60 printer</H1>
21675
21676 Type "S" to set your printer to "attached-to-wyse".<BR>
21677 It is OK to include "attached-to-wyse" in your personal list below.
21678 <P>
21679 This is very similar to "attached-to-ansi".
21680 The only difference is in the control characters sent to turn the printer
21681 on and off.
21682 The ansi version of the printer uses ESC LEFT_BRACKET 5 i
21683 to turn on the printer and ESC LEFT_BRACKET 4 i
21684 to turn it off.
21685 The Wyse version uses Ctrl-R for on, and Ctrl-T for off.
21686 &lt;End of help on this topic&gt;
21687 </BODY></HTML>
21688 ====== h_config_set_att_wyse2 ======
21689 <HTML><HEAD>
21690 <TITLE>OPTION: Set printer to attached Wyse60 printer (no formfeed)</TITLE>
21691 </HEAD>
21692 <BODY>
21693 <H1>OPTION: Set printer to attached Wyse60 printer (no formfeed)</H1>
21694
21695 Type "S" to set your printer to "attached-to-wyse-no-formfeed".<BR>
21696 It is OK to include "attached-to-wyse-no-formfeed" in your personal
21697 list below.
21698
21699 <P>
21700
21701 This is the same as the "attached-to-wyse" option except that a
21702 formfeed character will not be appended to the end of the print job.
21703 If your printer already ejects the paper by itself at the end of the
21704 job, you may prefer the "no-formfeed" form of this printer so that you
21705 don't get an extra blank page between print jobs.
21706 <P>
21707
21708 &lt;End of help on this topic&gt;
21709 </BODY></HTML>
21710 ====== h_config_set_stand_print ======
21711 <HTML>
21712 <HEAD>
21713 <TITLE>OPTION: Set default printer</TITLE>
21714 </HEAD>
21715 <H1>OPTION: Set default printer</H1>
21716 <BODY>
21717 Move to the printer you want and type "S" to set it to be your
21718 default printer.  This list is not modifiable by you and has been
21719 set up by the system administrators.  If there is more than one printer
21720 listed in the Command List, you will be able to cycle through that
21721 whole list at the time you print, starting with your default.
21722 It is OK to include entries from this Standard list in your personal
21723 list below.
21724 <P>
21725 &lt;End of help on this topic&gt;
21726 </BODY>
21727 </HTML>
21728 ====== h_config_set_custom_print ======
21729 <HTML>
21730 <HEAD>
21731 <TITLE>OPTION: Set default printer</TITLE>
21732 </HEAD>
21733 <H1>OPTION: Set default printer</H1>
21734 <BODY>
21735 You may add as many print commands as you want to your personal list.
21736 Specify one of them as your default printer by moving to the printer
21737 you want and typing "S".  If there is more than one printer listed
21738 in the Command List, you will be able to cycle through that list at
21739 the time you print, starting with your default.  It is OK to include
21740 entries from the Standard list above or to include the command
21741 "attached-to-ansi", "attached-to-ansi-no-formfeed", "attached-to-wyse", or
21742 "attached-to-wyse-no-formfeed" as one of the entries here.
21743 <P>
21744 &lt;End of help on this topic&gt;
21745 </BODY>
21746 </HTML>
21747 ====== h_config_user_id =====
21748 <HTML>
21749 <HEAD>
21750 <TITLE>OPTION: <!--#echo var="VAR_user-id"--></TITLE>
21751 </HEAD>
21752 <BODY>
21753 <H1>OPTION: <!--#echo var="VAR_user-id"--></H1>
21754
21755 This value is used as part of the "From" address on messages you send.
21756 It is also the default login name for remote IMAP server access.  Set this
21757 to the username part you want to appear on outgoing email.
21758 <P>
21759 If you want to change the value of what gets included in the From header
21760 in messages you send (other than just the User ID)
21761 look <A HREF="h_config_change_your_from">here</A> for a description.
21762
21763 <P><UL>
21764 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21765 </UL><P>
21766 &lt;End of help on this topic&gt;
21767 </BODY>
21768 </HTML>
21769 ====== h_config_user_dom =====
21770 <HTML>
21771 <HEAD>
21772 <TITLE>OPTION: <!--#echo var="VAR_user-domain"--></TITLE>
21773 </HEAD>
21774 <BODY>
21775 <H1>OPTION: <!--#echo var="VAR_user-domain"--></H1>
21776
21777 This value specifies the domain part (right-hand side) of your return
21778 address on outgoing email and is also used as the default domain for email
21779 composed to a local user.
21780 <!--chtml if pinemode="os_windows"-->
21781  This value is required for PC-Alpine. If you are unsure as to what this should be,
21782  contact your local help desk, system administrator, or Internet Service Provider.
21783 <!--chtml else-->
21784  If unset, Unix Alpine will obtain the domain from
21785  the system.  Often this value will be set for your whole site by the
21786  system administrator.<P>
21787 <!--chtml endif-->
21788 If you set this, see also the <A HREF="h_config_quell_local_lookup">
21789 &quot;<!--#echo var="FEAT_quell-user-lookup-in-passwd-file"-->&quot;</A> feature.
21790 <P>
21791 If you want to change the value of what gets included in the From header
21792 in messages you send (other than just the User Domain)
21793 look <A HREF="h_config_change_your_from">here</A> for a description.
21794 <P><UL>
21795 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21796 </UL><P>
21797 &lt;End of help on this topic&gt;
21798 </BODY>
21799 </HTML>
21800 ====== h_config_smtp_server =====
21801 <HTML>
21802 <HEAD>
21803 <TITLE>OPTION: <!--#echo var="VAR_smtp-server"--></TITLE>
21804 </HEAD>
21805 <BODY>
21806 <H1>OPTION: <!--#echo var="VAR_smtp-server"--></H1>
21807 This value specifies the name of one or more SMTP
21808 (Simple Mail Transfer Protocol) servers for sending mail.
21809 <!--chtml if pinemode="os_windows"-->
21810 You must have an SMTP server for use with PC-Alpine.
21811 SMTP servers are
21812 normally set up by a system administrator for use by all members of a given
21813 campus or department.
21814 Contact your local help desk to ask what SMTP
21815 servers you should use.
21816 <!--chtml else-->
21817 Unix Alpine users may not need to set an SMTP server.
21818 Alpine will attempt to execute the program (usually sendmail) that is used
21819 to insert mail into the mail system.
21820 If this works for you, you may leave this option blank.
21821 If there is an SMTP server running on the Unix host you may be able to
21822 improve sending performance slightly by setting the SMTP server option
21823 to &quot;localhost&quot; or to the actual name of the Unix host.
21824 <P>
21825 If the Unix host doesn't work the way Alpine was expecting you will need to
21826 set the value of this option.
21827 SMTP servers are
21828 normally set up by a system administrator for use by all members of a given
21829 campus or department.
21830 Contact your local help desk to ask what SMTP
21831 servers you should use.
21832 <!--chtml endif-->
21833 <P>
21834 Your SMTP server may offer SMTP AUTH authentication.
21835 It may even require it.
21836 If your SMTP server offers SMTP AUTH authentication you may specify a
21837 &quot;user&quot; name parameter to cause Alpine to attempt to authenticate.
21838 This parameter requires an associated value,
21839 the username identifier with which to establish the server
21840 connection.
21841 An example might be:
21842
21843 <P>
21844 <CENTER><SAMP>smtpserver.example.com/user=katie</SAMP></CENTER>
21845 <P>
21846
21847 If AUTH authentication is offered by the server, this will cause Alpine to
21848 attempt to use it.
21849 If AUTH authentication is not offered by the server, this will cause Alpine
21850 to fail sending with an error similar to:
21851
21852 <P>
21853 <CENTER><SAMP>Error: SMTP authentication not available</SAMP></CENTER>
21854 <P>
21855
21856 Another type of authentication that is used by some ISPs is called
21857 &quot;POP before SMTP&quot; or &quot;IMAP before SMTP&quot;,
21858 which means that you have to authenticate
21859 yourself to the POP or IMAP server by opening a mailbox before you
21860 can send mail.
21861 To do this, you usually only have to open your INBOX.
21862
21863 <P>
21864 You may tell Alpine to use the
21865 <A HREF="http://www.ietf.org/rfc/rfc2476.txt">Message Submission</A>
21866 port (587) instead of the SMTP port (25) by including the &quot;submit&quot;
21867 parameter
21868 in this option.
21869 At this time &quot;/submit&quot; is simply equivalent to specifying
21870 port 587, though it may imply more than that at some point in the future.
21871 Some ISPs are blocking port 25 in order to reduce the amount of spam
21872 being sent to their users.
21873 You may find that the submit option allows you to get around such a block.
21874
21875 <P>
21876 <CENTER><SAMP>smtpserver.example.com/submit</SAMP></CENTER>
21877 <P>
21878
21879 To specify any non-standard port number on the SMTP server you may follow
21880 the hostname with a colon followed by the portnumber.
21881
21882 <P>
21883 <CENTER><SAMP>smtpserver.example.com:12345</SAMP></CENTER>
21884 <P>
21885
21886 Normally, when a connection is made to the Smtp-Server Alpine will attempt
21887 to negotiate a secure (encrypted) session using Transport Layer Security (TLS).
21888 If that fails then a non-encrypted connection will be attempted instead.
21889 You may specify that a TLS connection is required if you wish.
21890 If you append &quot;/tls&quot; to the name then the connection will fail
21891 instead of falling back to a non-secure connection.
21892
21893 <P>
21894 <CENTER><SAMP>smtpserver.example.com/tls</SAMP></CENTER>
21895 <P>
21896
21897
21898 For more details about server name possibilities see
21899 <A HREF="h_folder_server_syntax">Server Name Syntax</A>.
21900 <P>
21901
21902 <UL>
21903 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21904 </UL>
21905 <P>
21906 &lt;End of help on this topic&gt;
21907 </BODY>
21908 </HTML>
21909 ====== h_config_nntp_server =====
21910 <HTML>
21911 <HEAD>
21912 <TITLE>OPTION: <!--#echo var="VAR_nntp-server"--></TITLE></HEAD>
21913 <BODY>
21914 <H1>OPTION: <!--#echo var="VAR_nntp-server"--></H1>
21915
21916 This value specifies the name of one or more NNTP
21917 (Network News Transfer Protocol)
21918 servers for reading and posting USENET news.
21919 NNTP servers are normally
21920 set up by a system administrator for use by all members of a given campus
21921 or department.
21922 Contact your local help desk to ask what NNTP servers you should use.
21923 <!--chtml if pinemode="os_windows"--><!--chtml else-->
21924 Often Unix Alpine users will find that this variable has been
21925 set for the whole system (and they don't have to worry about it).
21926 <!--chtml endif-->
21927 When you define an NNTP server here, Alpine implicitly defines a news
21928 collection for you, assuming that server as the news server and assuming
21929 that you will use the NNTP protocol and a local newsrc configuration file
21930 for reading news.
21931 For more about reading news with Alpine, see
21932 <A HREF="h_reading_news">how to use Alpine to read news</A>.
21933 <P>
21934 Your NNTP server may offer NNTP &quot;AUTHINFO SASL&quot;
21935 or &quot;AUTHINFO USER&quot; authentication.
21936 It may even require it.
21937 If your NNTP server does offer such authentication you may specify a user name
21938 parameter to cause Alpine to attempt to authenticate.
21939 The same is true for the server name in a folder collection that uses NNTP.
21940 This parameter requires an associated value,
21941 the username identifier with which to establish the server connection.
21942 An example might be:
21943
21944 <P>
21945 <CENTER><SAMP>nntpserver.example.com/user=katie</SAMP></CENTER>
21946 <P>
21947
21948 If authentication is offered by the server, this will cause Alpine to
21949 attempt to use it.
21950 If authentication is not offered by the server, this will cause Alpine
21951 to fail with an error similar to:
21952
21953 <P>
21954 <CENTER><SAMP>Error: NNTP authentication not available</SAMP></CENTER>
21955 <P>
21956 For more details about the server name possibilities see
21957 <A HREF="h_folder_server_syntax">Server Name Syntax</A>.
21958 <P><UL>
21959 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21960 </UL><P>
21961 &lt;End of help on this topic&gt;
21962 </BODY>
21963 </HTML>
21964 ====== h_config_inbox_path =====
21965 <HTML>
21966 <HEAD>
21967 <TITLE>OPTION: <!--#echo var="VAR_inbox-path"--></TITLE>
21968 </HEAD>
21969 <BODY>
21970 <H1>OPTION: <!--#echo var="VAR_inbox-path"--></H1>
21971
21972 This value overrides the default value of your INBOX name/path/location.
21973 <!--chtml if pinemode="os_windows"-->
21974 PC-Alpine users must specify an inbox path and it must be a folder on an
21975 IMAP server.
21976 <!--chtml else-->
21977 Unix and VMS Alpine users will often find that this variable
21978 has been pre-configured by your system administrator.
21979 <!--chtml endif-->
21980 You may be able to specify an alternate INBOX that is either a local folder
21981 or a folder on an IMAP server.
21982 <P>
21983 A typical remote <!--#echo var="VAR_inbox-path"--> entry would be: &#123;monet.art.example.com}INBOX
21984 where &quot;monet.art.example.com&quot; is replaced by the name of your IMAP
21985 mail server.
21986 <P>
21987 See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
21988 details on the syntax of folder definitions.
21989 <P>
21990 See <A HREF="h_info_on_mbox">Missing mail and the mbox driver</A> if your
21991 mail is disappearing.
21992 <P><UL>
21993 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21994 </UL><P>
21995 &lt;End of help on this topic&gt;
21996 </BODY>
21997 </HTML>
21998 ====== h_config_change_your_from =====
21999 <HTML>
22000 <HEAD>
22001 <TITLE>How to Change your From Address</TITLE>
22002 </HEAD>
22003 <BODY>
22004 <H1>How to Change your From Address</H1>
22005
22006 If the From address that Alpine includes in mail that you send is not correct,
22007 you may want to configure a different default value for the From address.
22008 You may follow these directions to change the default:
22009
22010 <P>
22011 <UL>
22012   <LI> Go to the Main Alpine Menu
22013   <LI> From there type the Setup Command
22014   <LI> From there type the Config Command
22015 </UL>
22016
22017 <P>
22018 You've probably already seen this SETUP CONFIGURATION screen.
22019 If not, there are many options you may want to set here.
22020 To set the value of the From header you may use the
22021 <A href="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A> option.
22022 Find it by scrolling down a few pages or use the WhereIs command to
22023 search for &quot;customized&quot;.
22024 You may want to read the help text associated with the option.
22025 <P>
22026 To add a custom From header, type the Add command and enter the
22027 full header line, including the leading &quot;From:&nbsp;&quot;.
22028 For example:
22029 <P>
22030 <CENTER><SAMP>From: Full Name &lt;user@example.com&gt;</SAMP></CENTER>
22031 <P>
22032 Now exit the Setup command and try sending mail to yourself to see
22033 what the From line looks like.
22034 <P>
22035 When you are in the composer you may edit the custom From line by typing
22036 Ctrl-R while your cursor is in the headers of the message and then moving
22037 to the From line and editing.
22038 If you want to leave the default value the same but add the possibility
22039 of being able to edit the header when you compose, add just the header
22040 name without a value.
22041 For example:
22042 <P>
22043 <CENTER><SAMP>From:</SAMP></CENTER>
22044 <P>
22045 If you change your From address you may also find it useful to add the
22046 changed From address to the
22047 <a href="h_config_alt_addresses"><!--#echo var="VAR_alt-addresses"--></a>
22048 configuration option.
22049 <P>
22050 <UL>
22051 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22052 </UL><P>
22053 &lt;End of help on this topic&gt;
22054 </BODY>
22055 </HTML>
22056 ====== h_config_default_fcc =====
22057 <HTML>
22058 <HEAD>
22059 <TITLE>OPTION: <!--#echo var="VAR_default-fcc"--></TITLE>
22060 </HEAD>
22061 <BODY>
22062 <H1>OPTION: <!--#echo var="VAR_default-fcc"--></H1>
22063
22064 This value specifies where a copy of outgoing mail should be saved.  If
22065 this is not a path name, it will be in the default collection for saves.
22066 Any valid folder specification, local or IMAP, is allowed.  This default
22067 folder carbon copy only applies when the
22068 <A HREF="h_config_fcc_rule">&quot;<!--#echo var="VAR_fcc-name-rule"-->&quot;</A>
22069 is set to use the default folder.
22070 <!--chtml if pinemode="os_windows"-->
22071 PC-Alpine default is &quot;SENTMAIL&quot; (normally stored as SENTMAIL.MTX)
22072 <!--chtml else-->
22073 Unix Alpine default
22074 is normally &quot;sent-mail&quot; in the default folder collection.
22075 <!--chtml endif-->
22076 <P>
22077 If you access your email through an IMAP server, especially if you often switch between Unix Alpine
22078 and PC-Alpine, or between various desktop email systems, you may want to set this to a folder on your
22079 IMAP server (remember that in order to later access this remote folder through Alpine, it
22080 must be in a folder collection. See <A HREF="h_what_are_collections">Folder Collections Explained</a>
22081 for more information). An example:<p>
22082 <CENTER><SAMP>{monet.art.example.com}mail/sent-mail</SAMP></CENTER>
22083 <P>
22084 To suppress saving of outgoing mail, set: <!--#echo var="VAR_default-fcc"-->=&quot;&quot;
22085 <P>
22086 See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
22087 details on the syntax of folder definitions.
22088 <P>
22089 <UL>
22090 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22091 </UL><P>
22092 &lt;End of help on this topic&gt;
22093 </BODY>
22094 </HTML>
22095 ====== h_config_def_save_folder =====
22096 <HTML>
22097 <HEAD>
22098 <TITLE>OPTION: <!--#echo var="VAR_default-saved-msg-folder"--></TITLE>
22099 </HEAD>
22100 <BODY>
22101 <H1>OPTION: <!--#echo var="VAR_default-saved-msg-folder"--></H1>
22102
22103 This option determines the default folder name for save-message operations
22104 (&quot;saves&quot;).
22105 <P>
22106 If this is not a path name, it will be in the default collection for saves.
22107 Any valid folder specification, local or IMAP, is allowed.  This default
22108 folder only applies when the
22109 <A HREF="h_config_saved_msg_name_rule">&quot;<!--#echo var="VAR_saved-msg-name-rule"-->&quot;</A>
22110 doesn't override it.
22111 <!--chtml if pinemode="os_windows"-->
22112 PC-Alpine default is &quot;SAVEMAIL&quot; (normally stored as SAVEMAIL.MTX).
22113 <!--chtml else-->
22114 Unix Alpine default
22115 is normally &quot;saved-messages&quot; in the default folder collection.
22116 <!--chtml endif-->
22117 If you access your email through an IMAP server, especially if you often switch between Unix
22118 and PC-Alpine, or between various desktop email systems, you may want to set this to a folder on an
22119 IMAP server (remember that in order to later access this remote folder through Alpine, it
22120 should be in a folder collection. See <A HREF="h_what_are_collections">Folder Collections Explained</a>
22121 for more information). An example:<p>
22122 <CENTER><SAMP>{monet.art.example.com}mail/saved-messages</SAMP></CENTER>
22123 <P>
22124 See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
22125 details on the syntax of folder definitions.
22126 <P>
22127 <UL>
22128 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22129 </UL><P>
22130 &lt;End of help on this topic&gt;
22131 </BODY>
22132 </HTML>
22133 ====== h_config_postponed_folder =====
22134 <HTML>
22135 <HEAD>
22136 <TITLE>OPTION: <!--#echo var="VAR_postponed-folder"--></TITLE>
22137 </HEAD>
22138 <BODY>
22139 <H1>OPTION: <!--#echo var="VAR_postponed-folder"--></H1>
22140
22141 This value overrides the default name for the folder where postponed
22142 messages are saved.  If this is not a path name, it will be in the default
22143 collection for message Saves.  Any valid folder specification, local or
22144 remote, is allowed.
22145 PC-Alpine default
22146 is &quot;POSTPOND&quot; (stored as POSTPOND.MTX).
22147 The Unix Alpine default is normally &quot;postponed-msgs&quot;
22148 in the default collection.
22149 <P>
22150 Tip: If you are using different installations of (PC-)Alpine -- for example, PC-Alpine on your personal
22151 computer at home, and Unix Alpine on campus -- you can postpone a composition begun with one Alpine and
22152 resume it later with the other if you set this option to the <B>same folder on the same IMAP host</B>
22153 in all Alpine copies you use.
22154 (Remember that in order to later access this remote folder through Alpine, it must be in a folder
22155 collection. See <A HREF="h_what_are_collections">Folder Collections Extensions Explained</a>
22156 for more information). An
22157 example:<p>
22158 <CENTER><SAMP>{monet.art.example.com}mail/postponed-msgs</SAMP></CENTER>
22159 <P>
22160 See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
22161 details on the syntax of folder definitions.
22162 <P>
22163 <UL>
22164 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22165 </UL><P>
22166 &lt;End of help on this topic&gt;
22167 </BODY>
22168 </HTML>
22169 ====== h_config_read_message_folder =====
22170 <HTML>
22171 <HEAD>
22172 <TITLE>OPTION: <!--#echo var="VAR_read-message-folder"--></TITLE>
22173 </HEAD>
22174 <BODY>
22175 <H1>OPTION: <!--#echo var="VAR_read-message-folder"--></H1>
22176
22177 By virtue of specifying a folder name here, Alpine will be configured to
22178 save all messages that you have read during a session into the designated
22179 &quot;read messages&quot; folder.  This allows you to more easily distinguish
22180 between your really new email (in your INBOX) and those that you have
22181 already read.  Depending on how you define the
22182 <A HREF="h_config_auto_read_msgs">&quot;auto-move-read-messages&quot;</A>
22183 setting, you may or may not be asked when you quit
22184 Alpine if you want read messages to be moved to this folder.  In either
22185 case, moving the messages means they will be deleted from your INBOX.
22186 <P>
22187 If this is not a path name, it will be in the default collection for
22188 saves.  Any valid folder specification, local or remote (via IMAP), is
22189 allowed.  There is no default for the name of the read message folder.
22190 <P>
22191 See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
22192 details on the syntax of folder definitions.
22193 <P>
22194 <UL>
22195 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22196 </UL><P>
22197 &lt;End of help on this topic&gt;
22198 </BODY>
22199 </HTML>
22200 ====== h_config_form_folder =====
22201 <HTML>
22202 <HEAD>
22203 <TITLE>OPTION: <!--#echo var="VAR_form-letter-folder"--></TITLE>
22204 </HEAD>
22205 <BODY>
22206 <H1>OPTION: <!--#echo var="VAR_form-letter-folder"--></H1>
22207
22208 A &quot;<!--#echo var="VAR_form-letter-folder"-->&quot; is a mail folder that is intended to
22209 contain messages that you have composed and that are intended to be
22210 sent in their original form repeatedly.
22211
22212 <P>
22213 Setting this variable will alter Alpine's usual behavior when you
22214 execute the Compose command.  Normally, Alpine offers a chance to
22215 continue a postponed or interrupted message should one or the other
22216 exist.  When this variable is set to a folder name that exists, Alpine
22217 will also offer the chance to select a message from the folder to
22218 insert into the composer (much like when continuing a postponed message).
22219 The difference, however, is that Alpine will not automatically delete
22220 the selected message from the Form Letter Folder.
22221 <P>
22222 Setting this variable will also affect Alpine's behavior when you
22223 Postpone a message from the composer.  Normally, Alpine simply stashes
22224 the message away in your
22225 &quot;<A HREF="h_config_postponed_folder"><!--#echo var="VAR_postponed-folder"--></A>&quot;.
22226 Regardless of the specified folder's existence, Alpine will ask which
22227 folder you intend the message to be stored in.  Choose the
22228 &quot;F&quot; option to store the message in your Form Letter Folder.
22229 This is the most common way to add a message to the folder.
22230
22231 <P>
22232 Another method of adding messages to the folder is via the Alpine
22233 composer's <SAMP>Fcc:</SAMP> field.  If you are sending a message that
22234 you expect to send in the same form again, you can enter the Form
22235 Letter Folder's name in this field.  Alpine, as usual, will copy the
22236 message as it's sent.  Note, when you later select this message from
22237 your Form Letter Folder, it will have the same recipients as the original
22238 message.
22239
22240 <P>
22241 To delete a message from the Form Letter Folder, you can either select
22242 the folder from a suitable FOLDER LIST screen, or use the Delete
22243 command in the MESSAGE INDEX offered when selecting from the folder as
22244 part of the Compose command.  You can delete a Form Letter Folder just
22245 as any other folder from a suitable FOLDER LIST screen.
22246
22247 <P>
22248 You may find that the <A HREF="h_rules_roles">&quot;Roles&quot;</A>
22249 facility can be used
22250 to replace the Form Letter Folder.
22251
22252 <P>
22253 See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
22254 details on the syntax of folder definitions.
22255
22256 <P>
22257 <UL>
22258 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22259 </UL><P>
22260 &lt;End of help on this topic&gt;
22261 </BODY>
22262 </HTML>
22263 ====== h_config_archived_folders =====
22264 <HTML>
22265 <HEAD>
22266 <TITLE>OPTION: <!--#echo var="VAR_incoming-archive-folders"--></TITLE>
22267 </HEAD>
22268 <BODY>
22269 <H1>OPTION: <!--#echo var="VAR_incoming-archive-folders"--></H1>
22270
22271 This is like
22272 <A HREF="h_config_read_message_folder"><!--#echo var="VAR_read-message-folder"--></A>,
22273 only more general.  You may archive
22274 any of the folders in your incoming collection.  This is a list of folder
22275 pairs, with the first separated from the second in the pair by a space.
22276 The first folder in a pair is the folder you want to archive, and the
22277 second folder is the folder that read messages from the first should be
22278 moved to.  Depending on how you define the
22279 <A HREF="h_config_auto_read_msgs">&quot;auto-move-read-messages&quot;</A>
22280 setting, you may or may not be asked when you
22281 leave the first folder if you want read messages to be moved to the
22282 second folder.  In either case, moving the messages means they will be
22283 deleted from the first folder.
22284 <P>
22285 The name of the first folder in each pair can be either the technical
22286 specification of the folder (like what appears in your configuration file)
22287 or (much easier) the nickname that you gave the folder when you made it
22288 an incoming folder.
22289 <p>
22290 For example:<p>
22291 <CENTER><SAMP>{monet.art.example.com}inbox {monet.art.example.com}mail/inbox-archive</SAMP></CENTER>
22292 <p>or, using nicknames:<p>
22293 <CENTER><SAMP>inbox inbox-archive</SAMP></CENTER>
22294 <P>
22295 If these are not path names, they will be in the default collection for
22296 saves. Any valid folder specification, local or remote (via IMAP), is
22297 allowed. There is no default.
22298 <P>
22299 See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
22300 details on the syntax of folder definitions.
22301 <P>
22302 <UL>
22303 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22304 </UL><P>
22305 &lt;End of help on this topic&gt;
22306 </BODY>
22307 </HTML>
22308 ====== h_config_newsrc_path ======
22309 <HTML>
22310 <HEAD>
22311 <TITLE>OPTION: <!--#echo var="VAR_newsrc-path"--></TITLE>
22312 </HEAD>
22313 <BODY>
22314 <H1>OPTION: <!--#echo var="VAR_newsrc-path"--></H1>
22315
22316 This option overrides the default name Alpine uses for your "newsrc" news
22317 status and subscription file.  If set, Alpine will take this value as the
22318 full pathname for the desired newsrc file.<P>
22319
22320 If this option is <B>not</B> set,
22321 <!--chtml if pinemode="os_windows"-->
22322 PC-Alpine looks first for $HOME&#92;NEWSRC (where $HOME defaults to the root
22323 of the current drive, e.g. &quot;C:&#92;&quot;) and then it looks in the same
22324 directory as your pinerc file for NEWSRC.
22325 <!--chtml else-->
22326 Unix Alpine looks for the file ~/.newsrc (that is, the file named .newsrc in
22327 your account's home directory).
22328 <!--chtml endif-->
22329 <P><UL>
22330 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22331 </UL>
22332 <P>
22333 &lt;End of help on this topic&gt;
22334 </BODY>
22335 </HTML>
22336 ====== h_config_literal_sig =====
22337 <HTML>
22338 <HEAD>
22339 <TITLE>OPTION: <!--#echo var="VAR_literal-signature"--></TITLE>
22340 </HEAD>
22341 <BODY>
22342 <H1>OPTION: <!--#echo var="VAR_literal-signature"--></H1>
22343
22344 With this option your actual signature, as opposed to
22345 the name of a file containing your signature,
22346 is stored in the Alpine configuration file.
22347 If this is defined it takes precedence over the <!--#echo var="VAR_signature-file"--> option.
22348 <P>
22349
22350 This is simply a different way to store the signature.
22351 The signature is stored inside your Alpine configuration file instead of in
22352 a separate file.
22353 Tokens work the same way they do with the
22354 <A HREF="h_config_signature_file"><!--#echo var="VAR_signature-file"--></A> so look there for
22355 help.
22356 <P>
22357
22358 The Setup/Signature command on Alpine's MAIN MENU will edit
22359 the &quot;<!--#echo var="VAR_literal-signature"-->&quot; by default.  However, if no
22360 &quot;<!--#echo var="VAR_literal-signature"-->&quot; is defined and the file named in the
22361 &quot;<!--#echo var="VAR_signature-file"-->&quot; option exists, then the latter will be used
22362 instead.
22363 <P>
22364
22365 The two character sequence &#92;n (backslash followed by
22366 the character n) will be used to signify a line-break in your signature.
22367 You don't have to enter the &#92;n, but it will be visible in the
22368 SETUP CONFIGURATION window after you are done editing the signature.
22369
22370 <P>
22371 <UL>
22372 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22373 </UL><P>
22374 &lt;End of help on this topic&gt;
22375 </BODY>
22376 </HTML>
22377 ====== h_config_signature_file =====
22378 <HTML>
22379 <HEAD>
22380 <TITLE>OPTION: <!--#echo var="VAR_signature-file"--></TITLE>
22381 </HEAD>
22382 <BODY>
22383 <H1>OPTION: <!--#echo var="VAR_signature-file"--></H1>
22384
22385 If a <A HREF="h_config_literal_sig"><!--#echo var="VAR_literal-signature"--></A> option is defined,
22386 then this &quot;<!--#echo var="VAR_signature-file"-->&quot; option will be ignored.
22387 You can tell that that is the case because the value of the
22388 &quot;<!--#echo var="VAR_signature-file"-->&quot; will show up as
22389 <P>
22390 <CENTER><SAMP>&lt;Ignored: using <!--#echo var="VAR_literal-signature"--> instead&gt;</SAMP></CENTER>
22391 <P>
22392 You may either use all Literal Signatures (signatures stored in your
22393 configuration file) throughout Alpine, or all signature files.
22394 You can't mix the two.
22395 <P>
22396 This is the name of a file that will be automatically inserted into
22397 outgoing messages.
22398 It typically contains information such as your
22399 name, email address and organizational affiliation.
22400 Alpine adds the
22401 signature into the message as soon as you enter the composer so you
22402 can choose to remove it or edit it on a message by message basis.
22403 Signature file placement in message replies is controlled by the
22404 &quot;<A HREF="h_config_sig_at_bottom"><!--#echo var="FEAT_signature-at-bottom"--></A>&quot;
22405 setting in the feature list.
22406 <P>
22407
22408 The default file name is
22409 <!--chtml if pinemode="os_windows"-->
22410 &quot;PINE.SIG&quot; in the same directory as your PINERC file if your
22411 PINERC file is a local file.
22412 If your PINERC file is remote, then it will be in the directory specified
22413 by the &quot;-aux local_directory&quot; command line option.
22414 <!--chtml else-->
22415 &quot;.signature&quot;.
22416 <!--chtml endif-->
22417 <P>
22418
22419 To create or edit your signature file choose Setup from the MAIN MENU
22420 and then select S for Signature (Main/Setup/Signature).  This puts you
22421 into the Signature Editor where you can enter a <EM>few</EM> lines of
22422 text containing your identity and affiliation.
22423
22424 <P>
22425 If the filename is followed by a vertical bar (|) then instead
22426 of reading the contents of the file the file is assumed to be a
22427 program that will produce the text to be used on its standard output.
22428 The program can't have any arguments and doesn't receive any input from Alpine,
22429 but the rest of the processing works as if the contents came from a file.
22430
22431 <P>
22432 Instead of storing the data in a local file, the
22433 signature data may be stored remotely in an IMAP folder.
22434 In order to do this,
22435 you must use a remote name for the file.
22436 A remote <!--#echo var="VAR_signature-file"--> name might look like:
22437 <P>
22438 <CENTER><SAMP>{myimaphost.myschool.k12.wa.us}mail/signature</SAMP></CENTER>
22439 <P>
22440
22441 The syntax used here is the same as the syntax used for remote configuration
22442 files from the command line.
22443 Note that you may not access an existing signature file remotely,
22444 you have to create a new <EM>folder</EM> that contains the signature data.
22445 If the name you use here for the signature file is a remote name, then when
22446 you edit the file from the Setup/Signature command the data will be stored
22447 remotely in the folder.
22448 You aren't required to do anything special to create the folder, it
22449 gets created automatically if you use a remote name.
22450
22451 <P>
22452 Besides regular text, the signature file may also contain
22453 (or a signature program may produce) tokens that
22454 are replaced with text that usually depends on the message you are replying
22455 to or forwarding.
22456 For example, if the signature file contains the token
22457 <P>
22458 <CENTER><SAMP>_DATE_</SAMP></CENTER>
22459 <P>
22460 anywhere in the text, then that token is replaced by the date
22461 the message you are replying to or forwarding was sent.
22462 If it contains
22463 <P>
22464 <CENTER><SAMP>_CURDATE_</SAMP></CENTER>
22465 <P>
22466 that is replaced with the current date.
22467 The first is an example of a token that depends on the message you
22468 are replying to (or forwarding) and the second is an example which
22469 doesn't depend on anything other than the current date.
22470 You have to be a little careful with this facility since tokens that
22471 depend on the message you are replying to or forwarding will be replaced
22472 by nothing in the case where you are composing a new message from scratch.
22473 The use of <A HREF="h_rules_roles">&quot;roles&quot;</A> may help you
22474 in this respect.
22475 It allows you to use different signature files in different cases.
22476 <P>
22477
22478 The list of tokens available for use in the signature file is
22479 <A HREF="h_index_tokens">here</A>.
22480 <P>
22481
22482 Instead of, or along with the use of &quot;roles&quot; to give you
22483 different signature files in different situations, there is also
22484 a way to conditionally include text based
22485 on whether or not a token would result in specific replacement text.
22486 For example, you could include some text based on whether or not
22487 the _NEWS_ token would result in any newsgroups if it was used.
22488 This is explained in detail
22489 <A HREF="h_reply_token_conditionals">here</A>.
22490 This isn't for the faint of heart.
22491 <P>
22492 In the very unlikely event that you want to include a literal token
22493 in the signature you must precede it with a backslash character.
22494 For example,
22495 <P>
22496 <CENTER><SAMP>&#92;_DAYDATE_ = _DAYDATE_</SAMP></CENTER>
22497 <P>
22498 would produce something like
22499 <P>
22500 <CENTER><SAMP>_DAYDATE_ = Sat, 24 Oct 1998</SAMP></CENTER>
22501 <P>
22502 It is not possible to have a literal backslash followed by an expanded token.
22503 <P>
22504 An alternate method for storing the signature data is available by using the
22505 <A HREF="h_config_literal_sig"><!--#echo var="VAR_literal-signature"--></A> configuration option.
22506 This variable will be used by default.
22507 <P>
22508 <UL>
22509 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22510 </UL><P>
22511 &lt;End of help on this topic&gt;
22512 </BODY>
22513 </HTML>
22514 ====== h_config_init_cmd_list =====
22515 <HTML>
22516 <HEAD>
22517 <TITLE>OPTION: <!--#echo var="VAR_initial-keystroke-list"--></TITLE>
22518 </HEAD>
22519 <BODY>
22520 <H1>OPTION: <!--#echo var="VAR_initial-keystroke-list"--></H1>
22521
22522 The initial keystroke--or command--list option lets you start Alpine at
22523 any place you like.
22524 Whatever keystrokes you specify here will be executed
22525 by Alpine upon startup as a macro.
22526 The words SPACE, TAB, DOWN, UP, LEFT, and
22527 RIGHT indicate the pressing of those keys.
22528 CR indicates the pressing of the RETURN key.
22529 F1 through F12 represent the function keys, and ^ followed
22530 by a character indicates that key pressed along with the control key (in
22531 other words, ^P means Ctrl-P).
22532 As a shortcut notation, an element of the list may be several characters
22533 surrounded by double-quotes (").
22534 That will be expanded into the individual keystrokes
22535 (excluding the double-quote characters).
22536 For example, the quoted-string
22537
22538 <P><CENTER>"ABC"</CENTER>
22539
22540 <P>
22541 is interpreted the same as the three separate list members
22542
22543 <P><CENTER>A and B and C</CENTER>
22544
22545 <P>
22546 which is also the same as
22547
22548 <P><CENTER>A,B,C</CENTER>
22549
22550 <P>
22551 An example: To view message 1 on startup,
22552 you could use an <!--#echo var="VAR_initial-keystroke-list"--> equal to
22553
22554 <P><CENTER>I,J,1,CR,V</CENTER>
22555
22556 <P>
22557 An equivalent version of this is
22558
22559 <P><CENTER>"IJ1",CR,V</CENTER>
22560
22561 <P>
22562 Restrictions: You cannot pre-type into the composer with the initial
22563 keystroke list, and you cannot mix function key commands with letter
22564 commands.
22565
22566 <P><UL>
22567 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22568 </UL>
22569 <P>
22570 &lt;End of help on this topic&gt;
22571 </BODY>
22572 </HTML>
22573 ====== h_config_comp_hdrs =====
22574 <html>
22575 <header>
22576 <title>OPTION: <!--#echo var="VAR_default-composer-hdrs"--></title>
22577 </header>
22578 <body>
22579 <h1>OPTION: <!--#echo var="VAR_default-composer-hdrs"--></h1>
22580
22581 You can control which headers you want visible when composing outgoing
22582 email using this option.
22583 You can specify any of the regular set, any
22584 <A HREF="h_compose_richhdr">Rich Header</A>,
22585 or any <A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A>
22586 that you have already defined.
22587 If you use this setting at all, you must specify all the
22588 headers you want to see, you can't just add to the regular header set.
22589 The default set is To:, Cc:, Attchmnt:, and Subject:.<p>
22590
22591 Note that the "Newsgroups:" header will be abbreviated in the Composer
22592 display, but should be spelled out in full here.<p>
22593 <UL>
22594 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22595 </UL><P>
22596 &lt;End of help on this topic&gt;
22597 </body>
22598 </html>
22599 ====== h_config_custom_hdrs =====
22600 <HTML>
22601 <HEAD>
22602 <TITLE>OPTION: <!--#echo var="VAR_customized-hdrs"--></TITLE>
22603 </HEAD>
22604 <BODY>
22605 <H1>OPTION: <!--#echo var="VAR_customized-hdrs"--></H1>
22606
22607 You may add your own custom headers to outgoing messages.
22608 Each header you specify here must include the header tag
22609 (<A HREF="h_composer_reply_to">Reply-To:</A>, Approved:, etc.)
22610 and may optionally include a value for that header.
22611 If you want to see these custom headers each time you compose a message,
22612 you must add them to your
22613 <A HREF="h_config_comp_hdrs"><!--#echo var="VAR_default-composer-hdrs"--></A> list,
22614 otherwise they become part
22615 of the rich header set that you only see when you press the
22616 <A HREF="h_compose_richhdr">Rich Header</A>
22617 <!--chtml if pinemode="function_key"-->(F5)
22618 <!--chtml else-->(Ctrl-R)<!--chtml endif--> command.
22619 (If you are looking for a way to change which headers are <EM>displayed</EM>
22620 when you view a message, take a look at the
22621 <A HREF="h_config_viewer_headers"><!--#echo var="VAR_viewer-hdrs"--></A>
22622 option instead.)
22623 Here's an example that shows how you might set your From address
22624 <P>
22625 <CENTER><SAMP>From: Full Name &lt;user@example.com&gt;</SAMP></CENTER>
22626 <P>
22627 and another showing how you might set a Reply-To address
22628 <P>
22629 <CENTER><SAMP>Reply-To: user@example.com</SAMP></CENTER>
22630 <P>
22631 You may also set non-standard header values here.
22632 For example, you could add
22633 <P>
22634 <CENTER><SAMP>Organization: My Organization Name</SAMP></CENTER>
22635 <P>
22636 or even
22637 <P>
22638 <CENTER><SAMP>X-Favorite-Colors: Purple and Gold</SAMP></CENTER>
22639 <P>
22640 If you include a value after the colon then that header will be included
22641 in your outgoing messages unless you delete it before sending.
22642 If a header in the <!--#echo var="VAR_customized-hdrs"--> list has only a tag but no value, then
22643 it will not be included in outgoing messages unless you edit a value
22644 in manually.
22645 For example, if
22646 <P>
22647 <CENTER><SAMP>Reply-To:</SAMP></CENTER>
22648 <P>
22649 is in the list, then the Reply-To header will be available for editing
22650 but won't be included unless a value is added while in the composer.
22651 <P>
22652 It's actually a little more complicated than that.
22653 The values of headers that you set with the <!--#echo var="VAR_customized-hdrs"--> option are
22654 defaults.
22655 If the message you are about to compose already has a value for a header,
22656 that value is used instead of a value from your <!--#echo var="VAR_customized-hdrs"-->.
22657 For example, if you are Replying to a message the Subject field
22658 will already be filled in.
22659 In that case, if the <!--#echo var="VAR_customized-hdrs"--> list contains a Subject line, the
22660 custom subject will <EM>NOT</EM> be used.
22661 The subject derived from the subject of the message you are Replying
22662 to will be used instead.
22663 <P>
22664 It is also possible to make header setting even more complicated and more
22665 automatic by using
22666 <A HREF="h_rules_roles">Roles</A>,
22667 but if all you want to do is set a default value for a header, you don't
22668 need to think about Roles.
22669 <P>
22670 If you change your From address you may also find it useful to add the
22671 changed From address to the
22672 <a href="h_config_alt_addresses"><!--#echo var="VAR_alt-addresses"--></a>
22673 configuration option.
22674 <P>
22675 Limitation: Because commas are used to separate the list of
22676 <!--#echo var="VAR_customized-hdrs"-->, it is not possible to have the value of a
22677 header contain a comma.
22678 Nor is there currently an &quot;escape&quot; mechanism provided
22679 to make this work.
22680 <P><UL>
22681 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22682 </UL>
22683 <P>
22684 &lt;End of help on this topic&gt;
22685 </BODY>
22686 </HTML>
22687 ====== h_config_viewer_headers =====
22688 <HTML>
22689 <HEAD>
22690 <TITLE>OPTION: <!--#echo var="VAR_viewer-hdrs"--></TITLE>
22691 </HEAD>
22692 <BODY>
22693 <H1>OPTION: <!--#echo var="VAR_viewer-hdrs"--></H1>
22694
22695 You may change the default list of headers that are viewed by listing
22696 the headers you want to view here.  If the headers in your
22697 &quot;<!--#echo var="VAR_viewer-hdrs"-->&quot; list are present in the message, then they
22698 will be shown.  The order of the headers you list will be honored.  If
22699 the special value &quot;all-except&quot; is included as the first
22700 header in the &quot;<!--#echo var="VAR_viewer-hdrs"-->&quot; list, then all headers in the
22701 message except those in the list will be shown.  The values are all
22702 case insensitive.
22703
22704 <P>
22705 Note that once you put anything in the &quot;<!--#echo var="VAR_viewer-hdrs"-->&quot; list,
22706 then the original default headers are ignored.  So, if you just wanted
22707 to add the header Organization to the list, you would have to list
22708 Organization plus all of the other headers originally in the default
22709 list.  If you just included Organization and nothing else, then you
22710 would see only the Organization header, nothing else.
22711
22712 <P>
22713 The default list of headers includes:
22714 <UL>
22715   <LI>From
22716   <LI>Resent-From
22717   <LI>To
22718   <LI>Resent-To
22719   <LI>Cc
22720   <LI>Resent-cc
22721   <LI>Bcc
22722   <LI>Newsgroups
22723   <LI>Followup-To
22724   <LI>Date
22725   <LI>Resent-Date
22726   <LI>Subject
22727   <LI>Resent-Subject
22728   <LI>Reply-To
22729 </UL>
22730
22731 <P>
22732 If you are looking for a way to control which headers are included in
22733 outgoing mail and are visible or not in the composer, take a look at the
22734 options
22735 <A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A>
22736 and <A HREF="h_config_comp_hdrs"><!--#echo var="VAR_default-composer-hdrs"--></A> instead of
22737 this option.
22738 <P>
22739 <UL>
22740 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22741 </UL><P>
22742 &lt;End of help on this topic&gt;
22743 </BODY>
22744 </HTML>
22745 ====== h_config_viewer_margin_left =====
22746 <HTML>
22747 <HEAD>
22748 <TITLE>OPTION: <!--#echo var="VAR_viewer-margin-left"--></TITLE>
22749 </HEAD>
22750 <BODY>
22751 <H1>OPTION: <!--#echo var="VAR_viewer-margin-left"--></H1>
22752
22753 This variable controls the left-hand vertical margin's width in
22754 Alpine's Message Viewing screen.
22755 Its value is the number of space characters preceding each displayed line.
22756 For consistency with
22757 <A HREF="h_config_viewer_margin_right"><!--#echo var="VAR_viewer-margin-right"--></A>,
22758 you may specify the column number to start in
22759 (column numbering begins with number 1)
22760 instead of the width of the margin by appending a lower case letter
22761 &quot;c&quot; to the number.
22762 For example, a value of &quot;2c&quot; means to start the text in column two,
22763 which is entirely equivalent to a value of &quot;1&quot;, which means to
22764 leave a margin of 1 space.
22765 <P>
22766 The default is a left margin of 0 (zero).
22767 Misconfigurations (for example, negative values or values with starting
22768 left columns greater than the ending right column)
22769 are silently ignored.
22770 If the number of columns for text between the <!--#echo var="VAR_viewer-margin-left"--> and
22771 the <!--#echo var="VAR_viewer-margin-right"--> is fewer than 8, then margins of zero will be used
22772 instead.
22773
22774 <P>
22775 &lt;End of help on this topic&gt;
22776 </BODY>
22777 </HTML>
22778 ====== h_config_viewer_margin_right =====
22779 <HTML>
22780 <HEAD>
22781 <TITLE>OPTION: <!--#echo var="VAR_viewer-margin-right"--></TITLE>
22782 </HEAD>
22783 <BODY>
22784 <H1>OPTION: <!--#echo var="VAR_viewer-margin-right"--></H1>
22785
22786 This variable controls the right-hand vertical margin's width in
22787 Alpine's Message Viewing screen.
22788 Its value is the number of space characters following each displayed line.
22789 You may specify the column number to end the text in
22790 (column numbering begins with number 1)
22791 instead of the width of the margin by appending a lower case letter
22792 &quot;c&quot; to the number.
22793 For example, a value of &quot;76c&quot; means to end the text in column 76.
22794 If the screen is 80 characters wide, this is equivalent to a value
22795 of &quot;4&quot;, which means to leave a margin of 4 spaces.
22796 However, if you use different size screens at different times, then these
22797 two values are not equivalent.
22798 <P>
22799 The default right margin is 4.
22800 Misconfigurations (for example, negative values or values with starting
22801 left columns greater than the ending right column)
22802 are silently ignored.
22803 If the number of columns for text between the
22804 <A HREF="h_config_viewer_margin_left"><!--#echo var="VAR_viewer-margin-left"--></A> and
22805 the <!--#echo var="VAR_viewer-margin-right"--> is fewer than 8, then margins of zero will be used
22806 instead.
22807
22808 <P>
22809 &lt;End of help on this topic&gt;
22810 </BODY>
22811 </HTML>
22812 ====== h_config_quote_suppression =====
22813 <HTML>
22814 <HEAD>
22815 <TITLE>OPTION: <!--#echo var="VAR_quote-suppression-threshold"--></TITLE>
22816 </HEAD>
22817 <BODY>
22818 <H1>OPTION: <!--#echo var="VAR_quote-suppression-threshold"--></H1>
22819
22820 This option should be used with care.
22821 It will cause some of the quoted text to be eliminated from the
22822 display when viewing a message in the MESSAGE TEXT screen.
22823 For example, if you set the <!--#echo var="VAR_quote-suppression-threshold"--> to the
22824 value &quot;5&quot;,
22825 this will cause quoted text that is longer than five lines to be truncated.
22826 Quoted text of five or fewer consecutive lines will be displayed in its entirety.
22827 Quoted text of more than six lines will have the first five lines displayed
22828 followed by a line that looks something like
22829 <P>
22830 <CENTER><SAMP>[ 12 lines of quoted text hidden from view ]</SAMP></CENTER>
22831 <P>
22832 As a special case, if exactly one line of quoted text would be hidden, the
22833 entire quote will be shown instead.
22834 So for the above example, quoted text that is exactly six lines long will
22835 will be shown in its entirety.
22836 (In other words, instead of hiding a single line and adding a line
22837 that announces that one line was hidden, the line is just shown.)
22838 <P>
22839 If the sender of a message has carefully chosen the quotes that he or she
22840 includes, hiding those quotes may change the meaning of the message.
22841 For that reason, Alpine requires that when you want to set the value of this
22842 variable to something less than four lines, you actually have to set it
22843 to the negative of that number.
22844 So if you want to set this option to &quot;3&quot;, you actually have to
22845 set it to &quot;-3&quot;.
22846 The only purpose of this is to get you to think about whether or not you
22847 really want to do this!
22848 If you want to delete all quoted text you set the value of this option
22849 to the special value &quot;-10&quot;.
22850 <P>
22851 The legal values for this option are
22852 <P>
22853 <TABLE>
22854 <TR>
22855   <TD> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </TD>
22856   <TD> Default, don't hide anything </TD>
22857 </TR>
22858 <TR>
22859   <TD> &nbsp;-1,-2,-3&nbsp;&nbsp; </TD>
22860   <TD> Suppress quote lines past 1, 2, or 3 lines </TD>
22861 </TR>
22862 <TR>
22863   <TD> &nbsp;4,5,6,...&nbsp; </TD>
22864   <TD> Suppress if more than that many lines </TD>
22865 </TR>
22866 <TR>
22867   <TD> &nbsp;&nbsp;&nbsp;-10&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </TD>
22868   <TD> Suppress all quoted lines </TD>
22869 </TR>
22870 </TABLE>
22871 <P>
22872 If you set this option to a non-default value you may sometimes wish to
22873 view the quoted text that is not shown.
22874 When this is the case, the
22875 <A HREF="h_common_hdrmode">HdrMode Command</A>
22876 may be used to show the hidden text.
22877 Typing the &quot;H&quot; command once will show the hidden text.
22878 Typing a second &quot;H&quot; will also turn on Full Header mode.
22879 The presence or absence of the HdrMode command is determined by the
22880 <A HREF="h_config_enable_full_hdr">&quot;<!--#echo var="FEAT_enable-full-header-cmd"-->&quot;</A>
22881 Feature-List option in your Alpine configuration, so you will want to
22882 be sure that is turned on if you use quote suppression.
22883 <P>
22884 For the purposes of this option, a quote is a line that begins with the
22885 character &quot;&gt;&quot;.
22886 <P>
22887 Quotes are only suppressed when displaying a message on the screen.
22888 The entire quote will be left intact when printing or forwarding or something
22889 similar.
22890 <P>
22891 &lt;End of help on this topic&gt;
22892 </BODY>
22893 </HTML>
22894 ====== h_config_saved_msg_name_rule =====
22895 <HTML>
22896 <HEAD>
22897 <TITLE>OPTION: <!--#echo var="VAR_saved-msg-name-rule"--></TITLE>
22898 </HEAD>
22899 <BODY>
22900 <H1>OPTION: <!--#echo var="VAR_saved-msg-name-rule"--></H1>
22901
22902 This option determines the default folder name when saving
22903 a message.
22904
22905 <P>
22906 The default option is &quot;default-folder&quot;, which is the folder
22907 called &quot;saved-messages&quot; in Unix Alpine and
22908 &quot;savemail&quot; in PC-Alpine.  To change the default folder, modify
22909 the Alpine option called
22910 <A HREF="h_config_def_save_folder">&quot;<!--#echo var="VAR_default-saved-msg-folder"-->&quot;</A>.
22911
22912 <P>
22913 Choosing any of the &quot;by-&quot; options cause Alpine to attempt to
22914 get the chosen option's value for the message being saved (or for the
22915 first message being saved if using an aggregrate save).
22916 For example, if &quot;by-from&quot; is chosen, Alpine attempts to get the
22917 value of who the message came from (i.e. the from address).
22918 Alpine then attempts to save the message to a folder matching that value.
22919 If &quot;by-from&quot; is chosen and no value is obtained, Alpine uses
22920 &quot;by-sender&quot;.
22921 The opposite is also true.
22922 If &quot;by-recipient&quot; is chosen and the message was posted to a
22923 newsgroup, Alpine will use the newsgroup name.
22924 If &quot;by-replyto&quot; is chosen and no value is obtained, Alpine uses
22925 &quot;by-from&quot;.
22926
22927 <P>
22928 If any of the &quot;by-realname&quot; options are chosen, Alpine will attempt
22929 to use the personal name part of the address instead of the mailbox part.
22930 If any of the &quot;by-nick&quot; options are chosen, the
22931 address is looked up in your address book and if found, the
22932 nickname for that entry is used.
22933 Only simple address book entries are checked, not distribution lists.
22934 Similarly, if any of the
22935 &quot;by-fcc&quot; options are chosen, the fcc from the corresponding
22936 address book entry is used.
22937 If by-realname, or the by-nick or by-fcc lookups result in no value,
22938 then if the chosen option ends with the &quot;then-from&quot;,
22939 &quot;then-sender&quot;, &quot;then-replyto&quot;,
22940 or &quot;then-recip&quot; suffix, Alpine
22941 reverts to the same behavior as &quot;by-from&quot;,
22942 &quot;by-sender&quot;, &quot;by-replyto&quot;, or &quot;by-recip&quot;
22943 depending on which option was specified.
22944 If the chosen option doesn't end with one of
22945 the &quot;then-&quot; suffixes, then Alpine reverts to the default
22946 folder when no match is found in the address book.
22947
22948 <P>
22949 Choosing the option called &quot;last-folder-used&quot;, causes Alpine
22950 to save to the folder that you saved to the last time you saved a
22951 message.  The first time you save a message in an Alpine session, Alpine
22952 attempts to save the message to the default folder.
22953
22954 <P>
22955 Here is an example to make some of the options clearer.
22956 If the message is From
22957 <P>
22958 <CENTER><SAMP>Fred Flintstone &lt;flint@bedrock.org&gt;</SAMP></CENTER>
22959 <P>
22960 and this rule is set to &quot;by-from&quot;, then the default folder offered
22961 in the save dialog would be &quot;flint&quot;.
22962 <P>
22963 If this rule is set to &quot;by-realname-of-from&quot; then the default would
22964 be &quot;Fred Flintstone&quot;.
22965 <P>
22966 If this rule is set to &quot;by-nick-of-from&quot; then Alpine will search
22967 for the address &quot;flint@bedrock.org&quot; in your address book.
22968 If an entry is found and it has a nickname associated with it, that nickname
22969 will be offered as the default folder.
22970 If not, the default saved message folder will be offered as the default.
22971 <P>
22972 If this rule is set to &quot;by-fcc-of-from&quot; then Alpine will search
22973 for the address &quot;flint@bedrock.org&quot; in your address book.
22974 If an entry is found and it has an Fcc associated with it, that Fcc
22975 will be offered as the default folder.
22976 If not, the default saved message folder will be offered as the default.
22977 <P>
22978 If this rule is set to &quot;by-nick-of-from-then-from&quot; then Alpine will search
22979 for the address &quot;flint@bedrock.org&quot; in your address book.
22980 If an entry is found and it has a nickname associated with it, that nickname
22981 will be offered as the default folder.
22982 If it is not found (or has no nickname) then the default offered will be
22983 the same as it would be for the &quot;by-from&quot; rule.
22984 That is, it would be &quot;flint&quot;
22985 <P>
22986 <UL>
22987 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22988 </UL><P>
22989 &lt;End of help on this topic&gt;
22990 </BODY>
22991 </HTML>
22992 ====== h_config_fcc_rule =====
22993 <HTML>
22994 <HEAD>
22995 <TITLE>OPTION: <!--#echo var="VAR_fcc-name-rule"--></TITLE>
22996 </HEAD>
22997 <BODY>
22998 <H1>OPTION: <!--#echo var="VAR_fcc-name-rule"--></H1>
22999
23000 This option determines the default name for folder carbon copy. Choose
23001 one:
23002
23003 <DL>
23004 <DT>default-fcc</DT>
23005 <DD>This is the normal default, the value of which is set in the
23006 &quot;<!--#echo var="VAR_default-fcc"-->&quot; variable as specified earlier in this
23007 configuration.
23008 </DD>
23009
23010 <DT>last-fcc-used</DT>
23011 <DD> Causes Alpine to use the folder that was last
23012 used in the fcc field
23013 </DD>
23014
23015 <DT>by-nickname</DT>
23016 <DD>Means that Alpine will use the nickname
23017 from your address book that matches the first address in the To line.
23018 If there is no match, it will use the value of the
23019 &quot;<!--#echo var="VAR_default-fcc"-->&quot; variable.
23020 </DD>
23021
23022 <DT>by-recipient</DT>
23023 <DD>Means Alpine will form a folder name
23024 based on the left hand side of the first address in the To line.
23025 </DD>
23026
23027 <DT>by-nick-then-recip</DT>
23028 <DD>Means that it will use the
23029 matching nickname from your address book if there is one, otherwise it
23030 will extract the recipient name from the address and use that (like
23031 by-recipient).
23032 </DD>
23033
23034 <DT>current-folder</DT>
23035 <DD>Causes a copy to be written to
23036 the currently open folder, unless that is the INBOX.  In the case
23037 where the current folder is the INBOX, the &quot;<!--#echo var="VAR_default-fcc"-->&quot; is
23038 used instead.
23039 </DD>
23040 </DL>
23041
23042 <P>
23043 Note: Whatever the fcc specified by the rule here, it will be
23044 over-ridden by any fcc entries you have in your address book.
23045
23046 <P>
23047 <UL>
23048 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23049 </UL><P>
23050 &lt;End of help on this topic&gt;
23051 </BODY>
23052 </HTML>
23053 ====== h_config_sort_key =====
23054 <HTML>
23055 <HEAD>
23056 <TITLE>OPTION: <!--#echo var="VAR_sort-key"--></TITLE>
23057 </HEAD>
23058 <BODY>
23059 <H1>OPTION: <!--#echo var="VAR_sort-key"--></H1>
23060
23061 This option determines the order in which messages will be displayed in
23062 the MESSAGE INDEX screen.  Choose from:
23063 <P>
23064 <UL>
23065  <LI> <A HREF="h_index_sort_arrival">Arrival</A>
23066  <LI> <A HREF="h_index_sort_date">Date</A>
23067  <LI> <A HREF="h_index_sort_subj">Subject</A>
23068  <LI> <A HREF="h_index_sort_ordsubj">OrderedSubj</A>
23069  <LI> <A HREF="h_index_sort_thread">Thread</A>
23070  <LI> <A HREF="h_index_sort_from">From</A>
23071  <LI> <A HREF="h_index_sort_size">Size</A>
23072  <LI> <A HREF="h_index_sort_score">Score</A>
23073  <LI> <A HREF="h_index_sort_to">To</A>
23074  <LI> <A HREF="h_index_sort_cc">Cc</A>
23075 </UL>
23076
23077 <P>
23078 Each type of sort may also be reversed.
23079 Normal default is by &quot;Arrival&quot;.
23080
23081 <P>
23082 A possible point of confusion arises when you change the configuration
23083 of the <!--#echo var="VAR_sort-key"-->.
23084 The folder will normally be re-sorted when you go back to viewing the
23085 index.
23086 However, if you have manually sorted the folder with the
23087 Sort
23088 (<!--chtml if pinemode="function_key"-->F7<!--chtml else-->$<!--chtml endif-->)
23089 command, then it will not be re-sorted until the next time it is opened.
23090
23091 <P>
23092 <UL>
23093 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23094 </UL><P>
23095 &lt;End of help on this topic&gt;
23096 </BODY>
23097 </HTML>
23098 ====== h_config_other_startup =====
23099 <HTML>
23100 <HEAD>
23101 <TITLE>OPTION: Set Startup Rule</TITLE>
23102 </HEAD>
23103 <BODY>
23104 <H1>OPTION: Set Startup Rule</H1>
23105
23106 This option determines which message will be the <EM>current message</EM> when
23107 the folder is first opened.
23108 It works the same way that the option
23109 <A HREF="h_config_inc_startup"><!--#echo var="VAR_incoming-startup-rule"--></A>
23110 works, so look there for help.
23111 It may be used for any folder, not just incoming folders.
23112
23113 <P>
23114 <UL>
23115 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23116 </UL><P>
23117 &lt;End of help on this topic&gt;
23118 </BODY>
23119 </HTML>
23120 ====== h_config_perfolder_sort =====
23121 <HTML>
23122 <HEAD>
23123 <TITLE>Set Sort Order</TITLE>
23124 </HEAD>
23125 <BODY>
23126 <H1>Set Sort Order</H1>
23127
23128 This option determines the order in which messages will be displayed in
23129 the MESSAGE INDEX screen when the Current Folder Type set in the
23130 Pattern is a match. Choose from:
23131 <P>
23132 <UL>
23133  <LI> <A HREF="h_index_sort_default">Default</A>
23134  <LI> <A HREF="h_index_sort_arrival">Arrival</A>
23135  <LI> <A HREF="h_index_sort_date">Date</A>
23136  <LI> <A HREF="h_index_sort_subj">Subject</A>
23137  <LI> <A HREF="h_index_sort_ordsubj">OrderedSubj</A>
23138  <LI> <A HREF="h_index_sort_thread">Thread</A>
23139  <LI> <A HREF="h_index_sort_from">From</A>
23140  <LI> <A HREF="h_index_sort_size">Size</A>
23141  <LI> <A HREF="h_index_sort_score">Score</A>
23142  <LI> <A HREF="h_index_sort_to">To</A>
23143  <LI> <A HREF="h_index_sort_cc">Cc</A>
23144 </UL>
23145
23146 <P>
23147 Each type of sort may also be reversed.
23148 Normal default is by &quot;Arrival&quot;.
23149
23150 <P>
23151 A possible point of confusion arises when you change the configuration
23152 of the Sort Order for the currently open folder.
23153 The folder will normally be re-sorted when you go back to viewing the
23154 index.
23155 However, if you have manually sorted the folder with the
23156 Sort
23157 (<!--chtml if pinemode="function_key"-->F7<!--chtml else-->$<!--chtml endif-->)
23158 command, then it will not be re-sorted until the next time it is opened.
23159
23160 <P>
23161 <UL>
23162 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23163 </UL><P>
23164 &lt;End of help on this topic&gt;
23165 </BODY>
23166 </HTML>
23167 ====== h_config_fld_sort_rule =====
23168 <HTML>
23169 <HEAD>
23170 <TITLE>OPTION: <!--#echo var="VAR_folder-sort-rule"--></TITLE>
23171 </HEAD>
23172 <BODY>
23173 <H1>OPTION: <!--#echo var="VAR_folder-sort-rule"--></H1>
23174
23175 This option controls the order in which folder list entries will be
23176 presented in the FOLDER LIST screen.  Choose one of the following:
23177
23178 <DL>
23179 <DT>Alphabetical</DT>
23180 <DD>sort by alphabetical name independent of type
23181 </DD>
23182
23183 <DT>Alpha-with-dirs-last</DT>
23184 <DD>sort by alphabetical name grouping directory entries
23185 to the end of the list
23186 </DD>
23187
23188 <DT>Alpha-with-dirs-first</DT>
23189 <DD>sort by alphabetical name grouping directory entries
23190 to the start of the list
23191 </DD>
23192 </DL>
23193
23194 The normal default is &quot;Alphabetical&quot;.
23195
23196 <P>
23197 <UL>
23198 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23199 </UL><P>
23200 &lt;End of help on this topic&gt;
23201 </BODY>
23202 </HTML>
23203 ====== h_config_ab_sort_rule =====
23204 <HTML>
23205 <HEAD>
23206 <TITLE>OPTION: <!--#echo var="VAR_addrbook-sort-rule"--></a></TITLE>
23207 </HEAD>
23208 <BODY>
23209 <H1>OPTION: <!--#echo var="VAR_addrbook-sort-rule"--></a></H1>
23210
23211 This option controls the order in which address book entries will be
23212 presented.  Choose one of the following:
23213
23214 <DL>
23215 <DT>fullname</DT>
23216 <DD>use fullname field, lists mixed in
23217 </DD>
23218
23219 <DT>fullname-with-lists-last</DT>
23220 <DD>use fullname field, but put lists at end
23221 </DD>
23222
23223 <DT>nickname</DT>
23224 <DD>use nickname field, lists mixed in
23225 </DD>
23226
23227 <DT>nickname-with-lists-last</DT>
23228 <DD>use nickname field, but put lists at end
23229 </DD>
23230
23231 <DT>dont-sort</DT>
23232 <DD>don't change order of file
23233 </DD>
23234 </DL>
23235
23236 <P>
23237 The normal default is &quot;fullname-with-lists-last&quot;.
23238 If you use an address book from more than one computer and those
23239 computers sort the address book differently then the sort order
23240 will be the order where the last change to the address book was
23241 made.
23242 There are two reasons the sorting might be different on different
23243 systems.
23244 First, the <!--#echo var="VAR_addrbook-sort-rule"--></a> may be set differently in the two
23245 places.
23246 Second, the collation rules on the two computers may be different.
23247 For example, one system might ignore special characters while the other
23248 doesn't or one may sort upper and lower case letters together while
23249 the other doesn't.
23250 In any case, the order you see is the order on the system where the
23251 last change was made, for example by an address book edit or a
23252 Take Address command.
23253
23254 <P>
23255 <UL>
23256 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23257 </UL><P>
23258 &lt;End of help on this topic&gt;
23259 </BODY>
23260 </HTML>
23261 ====== h_config_post_char_set =====
23262 <HTML>
23263 <HEAD>
23264 <TITLE>OPTION: <!--#echo var="VAR_posting-character-set"--></TITLE>
23265 </HEAD>
23266 <BODY>
23267 <H1>OPTION: <!--#echo var="VAR_posting-character-set"--></H1>
23268
23269 The <!--#echo var="VAR_posting-character-set"--> configuration option is used
23270 when sending messages.
23271
23272 <P>
23273
23274 When sending a message the text typed in the composer is
23275 labeled with the character set specified by this option.
23276 If the composed text is not fully representable in the
23277 specified <!--#echo var="VAR_posting-character-set"-->, then it is labeled as &quot;UTF-8.&quot
23278 instead;
23279
23280 <P>
23281 Attachments are labeled with your
23282 <A HREF="h_config_key_char_set">&quot;Keyboard Character Set&quot;</A>.
23283
23284 <P>
23285 Generally, there should be little need to set this option.
23286 If left unset, the
23287 default behavior is to label composed text as specifically as
23288 possible.  That is, if the composed text has no non-ASCII characters,
23289 it is labeled as &quot;US-ASCII.&quot; Similarly, if it is composed of
23290 only ISO-8859-15 characters, it is labeled as such.  Alpine will
23291 attempt to automatically detect a number of character sets including ISO-8859-15,
23292 ISO-8859-1, ISO-8859-2, VISCII, KOI8-R, KOI8-U, ISO-8859-7, ISO-8859-6,
23293 ISO-8859-8, TIS-620, ISO-2022-JP, GB2312, BIG5, and EUC-KR.
23294 If the message contains a mix of character sets,
23295 it is labeled as &quot;UTF-8.&quot;
23296
23297 <P>
23298
23299 This setting is provided to allow you to force a particular character set that
23300 Alpine does not automatically detect. For example, if a message is representable
23301 in more than one character set then Alpine may choose a different default
23302 than you want.
23303 Lastly, by setting this option explicitly to
23304 &quot;UTF-8&quot; all non-ASCII messages you send will be labeled as
23305 &quot;UTF-8&quot; instead of something more specific.
23306
23307 <P>
23308 In the Setup/Config screen you may choose from a list of all the
23309 character sets Alpine knows about by using the &quot;T&quot; ToCharsets command.
23310
23311 <P>
23312 The options
23313 <A HREF="h_config_char_set">&quot;Display Character Set&quot;</A>
23314 and <A HREF="h_config_key_char_set">&quot;Keyboard Character Set&quot;</A>
23315 are closely related.
23316 Setting the feature
23317 <A HREF="h_config_use_system_translation">&quot;Use System Translation&quot;</A>
23318 should cause this option to be ignored.
23319
23320 <P>
23321 <UL>
23322 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23323 </UL><P>
23324 &lt;End of help on this topic&gt;
23325 </BODY>
23326 </HTML>
23327 ====== h_config_unk_char_set =====
23328 <HTML>
23329 <HEAD>
23330 <TITLE>OPTION: <!--#echo var="VAR_unknown-character-set"--></TITLE>
23331 </HEAD>
23332 <BODY>
23333 <H1>OPTION: <!--#echo var="VAR_unknown-character-set"--></H1>
23334
23335 The <!--#echo var="VAR_unknown-character-set"--> configuration option is used
23336 when reading or replying to messages.
23337
23338 <P>
23339
23340 A text message should either be made up of all US-ASCII characters
23341 or it should contain a charset label which tells the software which
23342 character set encoding to use to interpret the message.
23343 Sometimes a malformed message may be unlabeled but contain non-ascii text.
23344 This message is outside of the standards so any attempt to read it could fail.
23345 When Alpine attempts to read such a message it will try to interpret the
23346 text in the character set you specify here.
23347 For example, if you have correspondents who send you unlabeled messages that
23348 are usually made up of characters from the WINDOWS-1251 character set, setting
23349 this <!--#echo var="VAR_unknown-character-set"--> to <CODE>WINDOWS-1251</CODE> will
23350 allow you to read those messages.
23351 Of course, if the unlabeled message is actually in some other character set,
23352 then you may see garbage on your screen.
23353 <P>
23354 Instead of just unlabeled text, this option also affects text which is labeled
23355 with the charsets &quot;X-Unknown&quot;, &quot;MISSING_PARAMETER_VALUE&quot;
23356 or &quot;US-ASCII&quot;.
23357
23358 <P>
23359 In the Setup/Config screen you may choose from a list of all the
23360 character sets Alpine knows about by using the &quot;T&quot; ToCharsets command.
23361
23362 <P>
23363 <UL>
23364 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23365 </UL><P>
23366 &lt;End of help on this topic&gt;
23367 </BODY>
23368 </HTML>
23369 ====== h_config_char_set =====
23370 <HTML>
23371 <HEAD>
23372 <TITLE>OPTION: Display Character Set</TITLE>
23373 </HEAD>
23374 <BODY>
23375 <H1>OPTION: Display Character Set</H1>
23376
23377 The Display Character Set configuration option is used when viewing messages.
23378 <P>
23379 Alpine uses Unicode characters internally and
23380 it is a goal for Alpine to handle email in many different languages.
23381 Alpine will properly display only left-to-right character sets
23382 in a fixed-width font. Specifically, Alpine assumes that a fixed-width
23383 font is in use, in the sense that
23384 characters are assumed to take up zero, one, or two character cell
23385 widths from left to right on the screen. This is true even in PC-Alpine.
23386 <P>
23387
23388 Alpine recognizes some local character sets that are right-to-left
23389 (Arabic, Hebrew, and Thai) or not representable in a fixed-width font
23390 (Arabic) and properly converts texts in these character sets to/from
23391 Unicode; however, there are known display bugs with these character
23392 sets.
23393 <P>
23394
23395 There are three possible configuration character settings and some
23396 environment variable settings that can affect how Alpine
23397 handles international characters.
23398 The first two of these are only available in UNIX Alpine.
23399 The three configuration options are
23400 Display Character Set,
23401 Keyboard Character Set, and
23402 <!--#echo var="VAR_posting-character-set"-->.
23403 The Keyboard Character Set defaults to being the same value
23404 as the Display Character Set, and that is usually correct, because
23405 the keyboard almost always produces characters in the same character set
23406 as the display displays.
23407 The Display Character Set is the character set that Alpine
23408 will attempt to use when sending characters to the display.
23409 <P>
23410
23411 By default, the Display Character Set variable is not set and UNIX Alpine
23412 will attempt to get this information from the environment.
23413 In particular, the <CODE>nl_langinfo(CODESET)</CODE> call is used.
23414 This usually depends on the setting of the environment variables LANG or LC_CTYPE.
23415 An explicit configuration setting for Display Character Set will,
23416 of course, override any default setting.
23417 <P>
23418 For PC-Alpine the Display Character Set
23419 and the Keyboard Character Set
23420 are always equivalent to <CODE>UTF-8</CODE> and this is not settable.
23421 <P>
23422
23423 It is probably best to use UNIX Alpine in a terminal emulator
23424 capable of displaying UTF-8 characters, since that will allow you to
23425 view just about any received text that is correctly formatted (note,
23426 however, the above comments about known index display bugs with certain
23427 character sets). You'll need to have an emulator that uses a UTF-8 font
23428 and you'll need to set up your environment to use a UTF-8 charmap. For
23429 example, on a Linux system you might include
23430 <P>
23431 <CENTER> <CODE>setenv LANG en_US.UTF-8</CODE> </CENTER>
23432 <P>
23433
23434 or something similar in your UNIX startup files.
23435 You'd also have to select a UTF-8 font in your terminal emulator.
23436 <P>
23437
23438 The types of values that the character set variables may be set to are
23439 <CODE>UTF-8</CODE>, <CODE>ISO-8859-1</CODE>, or <CODE>EUC-JP</CODE>.
23440 The <CODE>ISO-2022</CODE> character sets are not supported for input or
23441 for display, but as a special case, <CODE>ISO-2022-JP</CODE> is supported
23442 for use only as a <!--#echo var="VAR_posting-character-set"-->.
23443 In the Setup/Config screen you may choose from a list of all the
23444 character sets Alpine knows about by using the &quot;T&quot; ToCharsets command.
23445 Here is a list of many of the possible character sets:
23446
23447 <P>
23448 <TABLE>
23449 <TR> <TD>UTF-8</TD> <TD>Unicode</TD> </TR>
23450 <TR> <TD>US-ASCII</TD> <TD>7 bit American English characters</TD> </TR>
23451 <TR> <TD>ISO-8859-1</TD> <TD>8 bit European "Latin 1" character set</TD> </TR>
23452 <TR> <TD>ISO-8859-2</TD> <TD>8 bit European "Latin 2" character set</TD> </TR>
23453 <TR> <TD>ISO-8859-3</TD> <TD>8 bit European "Latin 3" character set</TD> </TR>
23454 <TR> <TD>ISO-8859-4</TD> <TD>8 bit European "Latin 4" character set</TD> </TR>
23455 <TR> <TD>ISO-8859-5</TD> <TD>8 bit Latin and Cyrillic</TD> </TR>
23456 <TR> <TD>ISO-8859-6</TD> <TD>8 bit Latin and Arabic</TD> </TR>
23457 <TR> <TD>ISO-8859-7</TD> <TD>8 bit Latin and Greek</TD> </TR>
23458 <TR> <TD>ISO-8859-8</TD> <TD>8 bit Latin and Hebrew</TD> </TR>
23459 <TR> <TD>ISO-8859-9</TD> <TD>8 bit European "Latin 5" character set</TD> </TR>
23460 <TR> <TD>ISO-8859-10</TD> <TD>8 bit European "Latin 6" character set</TD> </TR>
23461 <TR> <TD>ISO-8859-11</TD> <TD>Latin and Thai</TD> </TR>
23462 <TR> <TD>ISO-8859-12</TD> <TD>Reserved</TD> </TR>
23463 <TR> <TD>ISO-8859-13</TD> <TD>8 bit European "Latin 7" character set</TD> </TR>
23464 <TR> <TD>ISO-8859-14</TD> <TD>8 bit European "Latin 8" character set</TD> </TR>
23465 <TR> <TD>ISO-8859-15</TD> <TD>8 bit European "Latin 9" character set</TD> </TR>
23466 <TR> <TD>ISO-8859-16</TD> <TD>8 bit European "Latin 10" character set</TD> </TR>
23467 <TR> <TD>KOI8-R</TD> <TD>8 bit Latin and Russian</TD> </TR>
23468 <TR> <TD>KOI8-U</TD> <TD>8 bit Latin and Ukranian</TD> </TR>
23469 <TR> <TD>WINDOWS-1251</TD> <TD>8 bit Latin and Russian</TD> </TR>
23470 <TR> <TD>TIS-620</TD> <TD>8 bit Latin and Thai</TD> </TR>
23471 <TR> <TD>VISCII</TD> <TD>8 bit Latin and Vietnamese</TD> </TR>
23472 <TR> <TD>GBK</TD> <TD>Latin and Chinese Simplified</TD> </TR>
23473 <TR> <TD>GB2312</TD> <TD>Latin and Chinese Simplified</TD> </TR>
23474 <TR> <TD>CN-GB</TD> <TD>Latin and Chinese Simplified</TD> </TR>
23475 <TR> <TD>BIG5</TD> <TD>Latin and Chinese Traditional</TD> </TR>
23476 <TR> <TD>BIG-5</TD> <TD>Latin and Chinese Traditional</TD> </TR>
23477 <TR> <TD>EUC-JP</TD> <TD>Latin and Japanese</TD> </TR>
23478 <TR> <TD>SHIFT-JIS</TD> <TD>Latin and Japanese</TD> </TR>
23479 <TR> <TD>EUC-KR</TD> <TD>Latin and Korean</TD> </TR>
23480 <TR> <TD>KSC5601</TD> <TD>Latin and Korean</TD> </TR>
23481 </TABLE>
23482 <P>
23483
23484 When reading incoming email, Alpine understands many different
23485 character sets and is able to convert the incoming mail into Unicode.
23486 The Unicode will be converted to the Display Character Set
23487 for display on your terminal.
23488 Characters typed at the keyboard will be converted from the
23489 Keyboard Character Set to Unicode for Alpine's internal
23490 use.
23491 You may find that you can read some malformed messages that do not
23492 contain a character set label by setting the option
23493 <A HREF="h_config_unk_char_set">&quot;<!--#echo var="VAR_unknown-character-set"-->&quot;</A>.
23494 <P>
23495
23496 The <!--#echo var="VAR_posting-character-set"--> is used when sending messages.
23497 The default behavior obtained by leaving this variable unset is usually
23498 what is wanted. In that default case, Alpine will attempt
23499 to label the message with the most specific character set from the
23500 rather arbitrary set
23501 <P>
23502 US-ASCII, ISO-8859-15,
23503 ISO-8859-1, ISO-8859-2, VISCII, KOI8-R, KOI8-U, ISO-8859-7, ISO-8859-6,
23504 ISO-8859-8, TIS-620, ISO-2022-JP, GB2312, BIG5, EUC-KR, and UTF-8.
23505 <P>
23506
23507 For example, if the message is made up of only US-ASCII characters, it
23508 will be labeled US-ASCII. Otherwise, if it is all ISO-8859-15 characters,
23509 that will be the label. If that doesn't work the same is tried for the
23510 remaining members of the list.
23511
23512 <P>
23513 It might make sense to set <!--#echo var="VAR_posting-character-set"--> to an
23514 explicit value instead.
23515 For example, if you usually send messages in Greek, setting this
23516 option to ISO-8859-7 will result in messages being labeled as
23517 US-ASCII if there are no non-ascii characters, ISO-8859-7 if there
23518 are only Greek characters, or UTF-8 if there are some characters
23519 that aren't representable in ISO-8859-7.
23520 Another possibility is to set this option explicitly to UTF-8.
23521 In that case
23522 Alpine labels only ascii messages as US-ASCII and all other
23523 messages as UTF-8.
23524 <P>
23525
23526 The options
23527 <A HREF="h_config_post_char_set">&quot;<!--#echo var="VAR_posting-character-set"-->&quot;</A>
23528 and <A HREF="h_config_key_char_set">&quot;Keyboard Character Set&quot;</A>
23529 are closely related to this option.
23530 Setting the feature
23531 <A HREF="h_config_use_system_translation">&quot;Use System Translation&quot;</A>
23532 should cause this option to be ignored.
23533
23534 <P>
23535 When displaying a message, Alpine compares this setting to the character
23536 set specified in the message.  If not all of the
23537 characters in the message can be displayed using the Display Character Set
23538 then Alpine places an editorial
23539 comment in the displayed text (enclosed in square-brackets) indicating
23540 that some characters may not be displayed correctly.
23541 This comment may be eliminated by turning on the option
23542 <A HREF="h_config_quell_charset_warning"><!--#echo var="FEAT_quell-charset-warning"--></A>.
23543
23544 <P>
23545 <UL>
23546 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23547 </UL><P>
23548 &lt;End of help on this topic&gt;
23549 </BODY>
23550 </HTML>
23551 ====== h_config_key_char_set =====
23552 <HTML>
23553 <HEAD>
23554 <TITLE>OPTION: Keyboard Character Set</TITLE>
23555 </HEAD>
23556 <BODY>
23557 <H1>OPTION: Keyboard Character Set</H1>
23558
23559 UNIX Alpine only.
23560 <P>
23561 The Keyboard Character Set identifies the character set of the characters
23562 coming from your keyboard.
23563 It defaults to having the same value as your
23564 <A HREF="h_config_char_set">&quot;Display Character Set&quot;</A>,
23565 which in turn defaults to a value obtained from your environment.
23566 It is unlikely that you will need to use this option, because the keyboard
23567 almost always produces the same kind of characters as the display displays.
23568
23569 <P>
23570 This character set is also used when accessing files in your local
23571 file system.
23572 The names of the files are assumed to be in the same character set as
23573 what the keyboard produces, as well as the contents of the files.
23574
23575 <P>
23576 In the Setup/Config screen you may choose from a list of all the
23577 character sets Alpine knows about by using the &quot;T&quot; ToCharsets command.
23578
23579 <P>
23580 The options
23581 <A HREF="h_config_char_set">&quot;Display Character Set&quot;</A>
23582 and <A HREF="h_config_post_char_set">&quot;<!--#echo var="VAR_posting-character-set"-->&quot;</A>
23583 are closely related.
23584 Setting the feature
23585 <A HREF="h_config_use_system_translation">&quot;Use System Translation&quot;</A>
23586 should cause this option to be ignored.
23587
23588 <P>
23589 <UL>
23590 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23591 </UL><P>
23592 &lt;End of help on this topic&gt;
23593 </BODY>
23594 </HTML>
23595 ====== h_config_editor =====
23596 <HTML>
23597 <HEAD>
23598 <TITLE>OPTION: <!--#echo var="VAR_editor"--></TITLE>
23599 </HEAD>
23600 <BODY>
23601 <H1>OPTION: <!--#echo var="VAR_editor"--></H1>
23602
23603 <!--#echo var="VAR_editor"--> specifies the program invoked by ^_ in the Composer. This is
23604 normally an alternative to Alpine's internal composer (Pico).  You could use
23605 this setting to specify an alternate editor to use occasionally or if you
23606 have a favorite editor and want to use it all the time (see the
23607 <A HREF="h_config_alt_ed_now">&quot;<!--#echo var="FEAT_enable-alternate-editor-implicitly"-->&quot;</A> setting).  <P>
23608 If you specify multiple editors for this option, ^_ will invoke the first one
23609 of those specified that exists and is executable.  When specifying a program
23610 for use here, make sure that the format of the text it saves -- which, when
23611 you exit it, will become the message body in Alpine -- is appropriate
23612 for the body of an email message; avoid proprietary formats that may result in
23613 a message body that the recipient of your message will be unable to decipher.
23614 <P>
23615 <!--chtml if pinemode="os_windows"-->
23616 <!--chtml else-->
23617 If you are in doubt about what editors are available on your system, or which
23618 of them may be appropriate for specification here, ask your local computing
23619 support staff.
23620 <!--chtml endif-->
23621 <P>
23622 Note that if <a href="h_config_quell_flowed_text"><!--#echo var="FEAT_quell-flowed-text"--></a> is
23623 unset, outgoing text will be set as flowed.  In most cases this will be fine,
23624 but if the editor has a &quot;flowed text&quot; mode, it would be best to
23625 use that.
23626
23627 <P><UL>
23628 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23629 </UL>
23630 <P>
23631 &lt;End of help on this topic&gt;
23632 </BODY>
23633 </HTML>
23634 ====== h_config_speller =====
23635 <HTML>
23636 <HEAD>
23637 <TITLE>OPTION: <!--#echo var="VAR_speller"--></TITLE>
23638 </HEAD>
23639 <BODY>
23640 <H1>OPTION: <!--#echo var="VAR_speller"--></H1>
23641
23642 UNIX Alpine only.
23643 <P>
23644 For PC-Alpine, you must install the aspell library code that you
23645 may get from
23646 <A HREF="http://aspell.net/win32/">http://aspell.net/win32/</A>.
23647 <P>
23648 This option affects the behavior of the ^T (spell check) command in the
23649 Composer.  It specifies the program invoked by ^T in the Composer.
23650 By default, Alpine uses
23651 <P>
23652 <CENTER><SAMP>aspell --dont-backup --mode=email check</SAMP></CENTER>
23653 <P>
23654 if it knows where to find &quot;aspell&quot;.
23655 If there is no &quot;aspell&quot; command available but the command &quot;ispell&quot; is available
23656 then the command used is
23657 <P>
23658 <CENTER><SAMP>ispell -l</SAMP></CENTER>
23659 <P>
23660 Otherwise, the ancient &quot;spell&quot; command is used.
23661 <P>
23662 If you specify a value for this command (with full pathname) then that is what
23663 will be used instead of any of the defaults.
23664 When invoking this
23665 spell-checking program, Alpine appends a tempfile name (where the message is
23666 passed) to the command line. Alpine expects the speller to correct the
23667 spelling in that file. When you exit from that program Alpine will read the
23668 tempfile back into the composer.
23669 <P>
23670 Don't set this speller option to the standard Unix spell command.
23671 That won't work because spell works in a different way.
23672
23673 <P>
23674 <UL>
23675 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23676 </UL><P>
23677 &lt;End of help on this topic&gt;
23678 </BODY>
23679 </HTML>
23680 ====== h_config_aspell_dictionary =====
23681 <HTML>
23682 <HEAD>
23683 <TITLE>OPTION: <!--#echo var="VAR_aspell-dictionary-list"--></TITLE>
23684 </HEAD>
23685 <BODY>
23686 <H1>OPTION: <!--#echo var="VAR_aspell-dictionary-list"--></H1>
23687
23688 PC Alpine only.
23689 <P>
23690 This option specifies a list of dictionaries you will use with
23691 aspell. A sample entry is &quot;en_US&quot; for american english, or
23692 &quot;en_GB&quot; for brittish english.
23693
23694 <P>
23695 <UL>
23696 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23697 </UL><P>
23698 &lt;End of help on this topic&gt;
23699 </BODY>
23700 </HTML>
23701 ====== h_config_display_filters =====
23702 <HTML>
23703 <HEAD>
23704 <TITLE>OPTION: <!--#echo var="VAR_display-filters"--></TITLE>
23705 </HEAD>
23706 <BODY>
23707 <H1>OPTION: <!--#echo var="VAR_display-filters"--></H1>
23708
23709 This option defines a list of text-filtering commands (programs or
23710 scripts) that may be used to filter text portions of received messages
23711 prior to their use (e.g., presentation in the &quot;MESSAGE TEXT&quot;
23712 display screen, exporting to a text file).
23713 For security reasons, the full path name of the
23714 filter command must be specified.
23715
23716 <P>
23717 The command is executed and the message is piped into its standard input.
23718 The standard output of the command is read back by Alpine.  The
23719 &quot;_TMPFILE_&quot; token (see below) overrides this default behavior.
23720
23721 <P>
23722 The filter's use is based on the configured &quot;trigger&quot; string.  The
23723 format of a filter definition is:
23724
23725 <P>
23726 <CENTER>&lt;trigger&gt; &lt;command&gt; &lt;arguments&gt;</CENTER>
23727
23728 <P>
23729 You can specify as many filters as you wish, separating them with a comma.
23730 Each filter can have only one trigger and command.  Thus, two trigger
23731 strings that invoke the same command require separate filter
23732 specifications.
23733
23734 <P>
23735 The &quot;trigger&quot; is simply text that, if found in the message,
23736 will invoke the associated command.  If the trigger contains any space
23737 characters, it must be placed within quotes.  Likewise, should you
23738 wish a filter to be invoked unconditionally, define the trigger as the
23739 null string, &quot;&quot; (two consecutive double-quote characters).  If the
23740 trigger string is found anywhere in the text of the message the filter
23741 is invoked.  Placing the trigger text within the tokens defined below
23742 changes where within the text the trigger must be before considering
23743 it a match.
23744
23745 <P>
23746 Trigger Modifying Tokens:
23747 <DL>
23748 <DT>_CHARSET(<VAR>string</VAR>)_</DT>
23749 <DD>This token tells Alpine to invoke the supplied command
23750 if the text is in a character set matching <VAR>string</VAR>
23751 (e.g., ISO-8859-2 or ISO-2022-JP).
23752 </DD>
23753
23754
23755 <DT>_LEADING(<VAR>string</VAR>)_</DT>
23756 <DD>This token tells Alpine to invoke the supplied command
23757 if the enclosed <VAR>string</VAR> is found to be the first
23758 non-whitespace text.
23759 <BR>NOTE: Quotes are necessary if <VAR>string</VAR> contains
23760 the space character.
23761 </DD>
23762
23763 <DT>_BEGINNING(<VAR>string</VAR>)_</DT>
23764 <DD>This token tells Alpine to invoke the supplied command
23765 if the enclosed <VAR>string</VAR> is found at the beginning
23766 of any line in the text.
23767 <BR>NOTE: Quotes are necessary if <VAR>string</VAR> contains
23768 the space character.
23769 </DD>
23770 </DL>
23771
23772 <P>
23773 The &quot;command&quot; and &quot;arguments&quot; portion is simply
23774 the command line to be invoked if the trigger string is found.  Below
23775 are tokens that Alpine will recognize and replace with special values
23776 when the command is actually invoked.
23777
23778 <P>
23779 Command Modifying Tokens:
23780
23781 <DL>
23782 <DT>_TMPFILE_</DT>
23783 <DD>When the command is executed, this token is
23784 replaced with the path and name of the temporary
23785 file containing the text to be filtered.  Alpine
23786 expects the filter to replace this data with the
23787 filter's result.
23788
23789 <P>
23790 NOTE: Use of this token implies that the text to
23791 be filtered is not piped into standard input of the
23792 executed command and its standard output is ignored.
23793 Alpine restores the tty modes before invoking the
23794 filter in case the filter interacts with the user
23795 via its own standard input and output.
23796 </DD>
23797
23798 <DT>_RESULTFILE_</DT>
23799 <DD>When the command is executed, this token is
23800 replaced with the path and name of a temporary
23801 file intended to contain a status message from the
23802 filter.  Alpine displays this in the message status
23803 field.
23804 </DD>
23805
23806 <DT>_DATAFILE_</DT>
23807 <DD>When the command is executed, this token is
23808 replaced with the path and name of a temporary
23809 file that Alpine creates once per session and deletes
23810 upon exit.  The file is intended to be used by the
23811 filter to store state information between instances
23812 of the filter.
23813 </DD>
23814
23815 <DT>_PREPENDKEY_</DT>
23816 <DD>When the command is executed, this token indicates that a random
23817 number will be passed down the input stream before the message text.
23818 This number could be used as a session key.  It is sent in this way to
23819 improve security.  The number is unique to the current Alpine session
23820 and is only generated once per session.
23821 </DD>
23822
23823 <DT>_SILENT_</DT>
23824 <DD>When the filter is executed, this token tells Alpine not to repaint
23825 the screen while the command is being executed. This can be used with
23826 filters that do not interact with the user, and therefore repainting
23827 the screen is not necessary.
23828 </DD>
23829 </DL>
23830
23831 <P>
23832 The feature
23833 <A HREF="h_config_disable_reset_disp"><!--#echo var="FEAT_disable-terminal-reset-for-display-filters"--></A> is related.
23834 <P>
23835 Performance caveat/considerations:
23836 <BR>
23837 Testing for the trigger and invoking the filter doesn't come for free.
23838 There is overhead associated with searching for the trigger string, testing
23839 for the filter's existence and actually piping the text through the filter.
23840 The impact can be reduced if the Trigger Modifying Tokens above are
23841 employed.
23842 <P>
23843 &lt;End of help on this topic&gt;
23844 </BODY>
23845 </HTML>
23846 ====== h_config_sending_filter =====
23847 <HTML>
23848 <HEAD>
23849 <TITLE>OPTION: <!--#echo var="VAR_sending-filters"--></TITLE>
23850 </HEAD>
23851 <BODY>
23852 <H1>OPTION: <!--#echo var="VAR_sending-filters"--></H1>
23853
23854 This option defines a list of text-filtering commands (programs and
23855 scripts) that may be selectively invoked to process a message just before
23856 it is sent.  If set, the Composer's ^X (Send) command will allow you to
23857 select which filter (or none) to apply to the message before it is sent.
23858 For security reasons, the full path of the filter program must be
23859 specified.
23860
23861 <P>
23862 Command Modifying Tokens:
23863
23864 <DL>
23865 <DT>_RECIPIENTS_</DT>
23866 <DD>When the command is executed, this token is replaced
23867 with the space delimited list of recipients of the
23868 message being sent.
23869 </DD>
23870
23871 <DT>_TMPFILE_</DT>
23872 <DD>
23873 When the command is executed, this token is
23874 replaced with the path and name of the temporary
23875 file containing the text to be filtered.  Alpine
23876 expects the filter to replace this data with the
23877 filter's result.
23878
23879 <P>
23880 NOTE: Use of this token implies that the text to
23881 be filtered is not piped into standard input of the
23882 executed command and its standard output is ignored.
23883 Alpine restores the tty modes before invoking the
23884 filter in case the filter interacts with the user
23885 via its own standard input and output.
23886 </DD>
23887
23888 <DT>_RESULTFILE_</DT>
23889 <DD>When the command is executed, this token is
23890 replaced with the path and name of a temporary
23891 file intended to contain a status message from the
23892 filter.  Alpine displays this in the message status
23893 field.
23894 </DD>
23895
23896 <DT>_DATAFILE_</DT>
23897 <DD>When the command is executed, this token is replaced
23898 in the command line with the path and name of a
23899 temporary file that Alpine creates once per session
23900 and deletes upon exit.  The file is intended to be
23901 used by the filter to store state information between
23902 instances of the filter.
23903 </DD>
23904
23905 <DT>_PREPENDKEY_</DT>
23906 <DD>When the command is executed, this token indicates
23907 that a random number will be passed down the input
23908 stream before the message text.  This number could
23909 be used as a session key.  It is sent in this way
23910 to improve security.  The number is unique to the
23911 current Alpine session and is only generated once per
23912 session.
23913 </DD>
23914
23915 <DT>_INCLUDEALLHDRS_</DT>
23916 <DD>When the command is executed, this token indicates
23917 that the headers of the message will be passed down the input stream
23918 before the message text.
23919 </DD>
23920
23921 <DT>_MIMETYPE_</DT>
23922 <DD>When the command is executed, this token is replaced in the
23923 command name with a temporary file name used to accept any new MIME
23924 Content-Type information necessitated by the output of the filter.
23925 Upon the filter's exit, if the file contains new MIME type
23926 information, Alpine verifies its format and replaces the outgoing
23927 message's MIME type information with that contained in the file. This
23928 is basically a cheap way of sending something other than Text/Plain.
23929 </DD>
23930 </DL>
23931
23932 <P>
23933 NOTE: Only the body text, which is visible in the Composer, is piped
23934 through this filter.  Attachments are not sent to the filter.
23935 <P>
23936 Sending filters are not used if the feature
23937 <A HREF="h_config_send_wo_confirm">&quot;<!--#echo var="FEAT_send-without-confirm"-->&quot;</A> is set.
23938 <P>
23939 <UL>
23940 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23941 </UL><P>
23942 &lt;End of help on this topic&gt;
23943 </BODY>
23944 </HTML>
23945 ====== h_config_keywords =====
23946 <HTML>
23947 <HEAD>
23948 <TITLE>OPTION: <!--#echo var="VAR_keywords"--></TITLE>
23949 </HEAD>
23950 <BODY>
23951 <H1>OPTION: <!--#echo var="VAR_keywords"--></H1>
23952
23953 You may define your own set of keywords and optionally set them on a
23954 message by message basis.
23955 These are similar to the &quot;Important&quot; flag which the user
23956 may set using the Flag command.
23957 The difference is that the Important flag is always present for each folder.
23958 User-defined keywords are chosen by the user.
23959 You may set up the list of possible keywords here, or you may add keywords
23960 from the Flag Details screen that you
23961 can get to after typing the
23962 Flag (<!--chtml if pinemode="function_key"-->F11<!--chtml else-->*<!--chtml endif-->)
23963 command.
23964 After the keywords have been defined,
23965 then you use the <A HREF="h_common_flag">Flag command</A>
23966 to set or clear the keywords in each message.
23967 The behavior of the flag command may be modified by using the
23968 <A HREF="h_config_flag_screen_default">&quot;<!--#echo var="FEAT_enable-flag-screen-implicitly"-->&quot;</A> option or the
23969 <A HREF="h_config_flag_screen_kw_shortcut">&quot;<!--#echo var="FEAT_enable-flag-screen-keyword-shortcut"-->&quot;</A> option.
23970
23971 <P>
23972 Keywords may be used when Selecting messages (Select Keyword).
23973 Keywords may also be used in the Patterns of Rules (Filters, Indexcolors, etc).
23974 Filter Rules may be used to set keywords automatically.
23975 Keywords may be displayed as part of the Subject of a message by using
23976 the SUBJKEY or SUBJKEYINIT tokens in the
23977 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option.
23978 The <A HREF="h_config_kw_braces"><!--#echo var="VAR_keyword-surrounding-chars"--></A>
23979 option may be used to modify the display of keywords using
23980 SUBJKEY and SUBJKEYINIT slightly.
23981 Keywords may also be displayed in a column of their own in the MESSAGE INDEX
23982 screen by using the KEY or KEYINIT tokens.
23983 It is also possible to color keywords in the index using the
23984 Setup/Kolor screen (<A HREF="h_config_kw_color">Keyword Colors</A>).
23985 Keywords are not supported by all mail servers.
23986
23987 <P>
23988 You may give keywords nicknames if you wish.
23989 If the keyword definition you type in contains a SPACE character, then the
23990 actual value of the keyword is everything after the last SPACE and the
23991 nickname for that keyword is everything before the last SPACE.
23992 For example, suppose you are trying to interoperate with another email program
23993 that uses a particular keyword with an unpleasant name.
23994 Maybe it uses a keyword called
23995 <P>
23996 <CENTER><SAMP>VendorName.SoftwareName.08</SAMP></CENTER>
23997 <P>
23998 but for you that keyword means that the message is work-related.
23999 You could define a keyword to have the value
24000 <P>
24001 <CENTER><SAMP>Work VendorName.SoftwareName.08</SAMP></CENTER>
24002 <P>
24003 and then you would use the name &quot;Work&quot; when dealing with
24004 that keyword in Alpine.
24005 If you defined it as
24006 <P>
24007 <CENTER><SAMP>My Work VendorName.SoftwareName.08</SAMP></CENTER>
24008 <P>
24009 the nickname would be everything before the last SPACE, that is the nickname
24010 would be &quot;My Work&quot;.
24011 <P>
24012 Some commonly used keywords begin with dollar signs.
24013 This presents a slight complication, because the dollar sign is normally used
24014 to signify
24015 <A HREF="h_news_config">environment variable expansion</A>
24016 in the Alpine configuration.
24017 In order to specify a keyword that begins with a dollar sign you must
24018 precede the dollar sign with a second dollar sign to escape its special
24019 meaning.
24020 For example, if you want to include the keyword
24021 <P>
24022 <CENTER><SAMP>$Label1</SAMP></CENTER>
24023 <P>
24024 as one of your possible keywords, you must enter the text
24025 <P>
24026 <CENTER><SAMP>$$Label1</SAMP></CENTER>
24027 <P>
24028
24029 instead.
24030 <P>
24031 There are a couple limitations.
24032 First, not all servers support keywords.
24033 Second, some servers (including the IMAP server included with Alpine)
24034 have a per folder limit on the number of keywords that may be defined.
24035 This count commonly includes every keyword you have ever used in the
24036 folder, even if it is no longer being used.
24037 In other words, you can add keywords but you cannot remove them easily.
24038 If you have changed keywords over the life of a folder and find that
24039 you have reached such a limit, one possible solution might be to copy
24040 all of the messages to a newly created folder (using Alpine) and then
24041 delete the original and rename the new folder.
24042 The reason this might work is that only the keywords currently set in
24043 any of the messages will be used in the new folder, hopefully putting you
24044 under the limit.
24045
24046 <P>
24047 <UL>
24048 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24049 </UL><P>
24050 &lt;End of help on this topic&gt;
24051 </BODY>
24052 </HTML>
24053 ====== h_config_alt_addresses =====
24054 <HTML>
24055 <HEAD>
24056 <TITLE>OPTION: <!--#echo var="VAR_alt-addresses"--></TITLE>
24057 </HEAD>
24058 <BODY>
24059 <H1>OPTION: <!--#echo var="VAR_alt-addresses"--></H1>
24060
24061 This option provides a place for you to list alternate email addresses
24062 you may have.
24063 Each address in the list should be the actual email address part of an
24064 address, without the full name field or the angle brackets.
24065 For example:
24066
24067 <P>
24068 <CENTER><SAMP>user@example.com</SAMP></CENTER>
24069 <P>
24070
24071 The matching is case-insensitive, so this would match any of
24072 <SAMP>User@example.com</SAMP>, <SAMP>user@Example.Com</SAMP>, or
24073 <SAMP>USER@EXAMPLE.COM</SAMP> as well.
24074
24075 <P>
24076 If set, the option affects the behavior of the Reply
24077 command and the &quot;+&quot; symbol in the MESSAGE INDEX, which denotes that
24078 a message has been addressed specifically to you.
24079
24080 <P>
24081 In the default INDEX display
24082 the personal name (or email address) of
24083 the person listed in the message's &quot;From:&quot; header
24084 field is usually displayed except when that address is yours or one of your
24085 alternate addresses.
24086 In that case you will usually see the name of
24087 the first person specified in the
24088 message's &quot;To:&quot; header field
24089 with the prefix &quot;To: &quot; prepended.
24090
24091 <P>
24092 With respect to Reply, the reply-to-all option will exclude addresses
24093 listed here.
24094
24095 <P>
24096 The feature
24097 <A HREF="h_config_copy_to_to_from"><!--#echo var="FEAT_copy-to-address-to-from-if-it-is-us"--></A>
24098 is somewhat related to this option.
24099
24100 <P>
24101 In addition to a list of actual addresses,
24102 you may use regular expressions (as used with egrep with the ignore case flag)
24103 to describe the addresses you want to match.
24104 Alpine will somewhat arbitrarily interpret your entry as a regular
24105 expression if it contains any of the characters
24106 *, |, +, ?, {, [, ^, $, or &#92;.
24107 Otherwise, it will be treated literally.
24108 The feature
24109 <a href="h_config_disable_regex"><!--#echo var="FEAT_disable-regular-expression-matching-for-alternate-addresses"--></a>
24110 may be used to turn off regular expression processing regardless of whether or not
24111 special characters appear in the entry.
24112
24113 <P>
24114 A description of how regular expressions work is beyond the
24115 scope of this help text, but some examples follow.
24116
24117 <P>
24118 The entry
24119
24120 <P>
24121 <CENTER><SAMP>.*@example.com</SAMP></CENTER>
24122 <P>
24123
24124 in the <!--#echo var="VAR_alt-addresses"--> list would mean that any
24125 address with a domain name of <SAMP>example.com</SAMP> (such as
24126 <SAMP>fred@example.com</SAMP> or <SAMP>wilma@example.com</SAMP>) will be considered
24127 one of your alternate addresses.
24128 Strictly speaking, the dot in <SAMP>example.com</SAMP> ought to be escaped with
24129 a backslash, as in <SAMP>example&#92;.com</SAMP>, and a dollar sign anchor ought
24130 to come at the end of the expression to prevent a match of <SAMP>example.com.org</SAMP>.
24131 Complicating things further, the dollar sign
24132 is special in the Alpine configuration (it signifies environment variable expansion)
24133 so the dollar sign should be doubled or backslash escaped for Alpine's sake.
24134 Quotes around the whole expression will not escape the dollar sign successfully.
24135 So this example should look like
24136
24137 <P>
24138 <CENTER><SAMP>.*@example&#92;.com$$</SAMP></CENTER>
24139 <P>
24140
24141 <P>
24142 The entry
24143
24144 <P>
24145 <CENTER><SAMP>^fred[0-9]*@example.com$$</SAMP></CENTER>
24146 <P>
24147
24148 would match
24149 <SAMP>fred3@example.com</SAMP> or <SAMP>fred17@example.com</SAMP> as well
24150 as <SAMP>fred@example.com</SAMP>.
24151
24152 <P>
24153 You could match all addresses that look like
24154 <SAMP>fred+stuff@example.com</SAMP> for any value of <SAMP>stuff</SAMP> with the
24155 entry
24156
24157 <P>
24158 <CENTER><SAMP>^fred&#92;+.*@example.com$$</SAMP></CENTER>
24159 <P>
24160
24161 Notice that you have to escape the plus sign with a backslash because plus
24162 is a special character in regular expressions.
24163 If you wanted to match plain <SAMP>fred</SAMP> as well as <SAMP>fred+stuff</SAMP>
24164 the expression
24165
24166 <P>
24167 <CENTER><SAMP>^fred(()|&#92;+.*)@example.com$$</SAMP></CENTER>
24168 <P>
24169
24170 would do it, but it would be easier to just add fred@example.com as a
24171 separate entry.
24172
24173 <P>
24174 One more example, a match of all first-level subdomains, is given by
24175
24176 <P>
24177 <CENTER><SAMP>^fred@[[:alnum:]_-]*&#92;.example&#92;.com$$</SAMP></CENTER>
24178 <P>
24179
24180 <P>
24181 Because the regular expression matching is based on an old library
24182 (<SAMP>hs_regex</SAMP>) the regular expressions might not work exactly as you expect,
24183 but they should be close.
24184
24185 <P>
24186 <UL>
24187 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24188 </UL><P>
24189 &lt;End of help on this topic&gt;
24190 </BODY>
24191 </HTML>
24192 ====== h_config_abook_formats =====
24193 <HTML>
24194 <HEAD>
24195 <TITLE>OPTION: <!--#echo var="VAR_addressbook-formats"--></TITLE>
24196 </HEAD>
24197 <BODY>
24198 <H1>OPTION: <!--#echo var="VAR_addressbook-formats"--></H1>
24199
24200 This option specifies the format that address books are displayed in.
24201 Normally, address books are displayed with the nicknames in the first
24202 column, the fullnames in the second column, and addresses in the third
24203 column.  The system figures out reasonable defaults for the widths of
24204 the columns.  An address book may be given a different format by
24205 listing special tokens in the order you want them to display.  The
24206 possible tokens are NICKNAME, FULLNAME, ADDRESS, FCC, and COMMENT.
24207 So, for example, to get the default behavior you could list
24208
24209 <P>
24210 <CENTER><!--#echo var="VAR_addressbook-formats"-->=NICKNAME FULLNAME ADDRESS</CENTER>
24211
24212 <P>
24213 (You can also use the token DEFAULT to get the default behavior for
24214 an address book format.)
24215
24216 <P>
24217 The tokens are separated by spaces.  &quot;<!--#echo var="VAR_addressbook-formats"-->&quot;
24218 is a list, so if you have more than one address book you may have a
24219 separate format for each by putting its format at the corresponding
24220 location in the &quot;<!--#echo var="VAR_addressbook-formats"-->&quot; list.
24221
24222 <P>
24223
24224 Listed first are the personal address books, then the global address
24225 books.  So, if you have two personal address books and one global
24226 address book, you may have up to three formats in the
24227 &quot;<!--#echo var="VAR_addressbook-formats"-->&quot; list.  If
24228 &quot;<!--#echo var="VAR_addressbook-formats"-->&quot; doesn't have as many elements as there
24229 are address books, the last element is used repeatedly.
24230
24231 <P>
24232
24233 Each of the tokens may also be optionally followed by parentheses with
24234 either a number or a percentage inside the parentheses.  For example,
24235 <SAMP>FULLNAME(13)</SAMP> means to allocate 13 characters of space to
24236 the fullnames column, <SAMP>FULLNAME(20%)</SAMP> means to allocate 20%
24237 of the available space (the screen width minus the space for
24238 inter-column spaces) to the fullnames column, while plain
24239 <SAMP>FULLNAME</SAMP> means the system will attempt to figure out a
24240 reasonable number of columns.
24241
24242 <P>
24243 There are always 2 spaces between every column, so if you use
24244 fixed column widths (like 13) you should remember to take that into
24245 account.
24246
24247 <P>
24248 <UL>
24249 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24250 </UL><P>
24251 &lt;End of help on this topic&gt;
24252 </BODY>
24253 </HTML>
24254 ====== h_config_set_index_format =====
24255 <HTML>
24256 <HEAD>
24257 <TITLE>Set Index Format</TITLE>
24258 </HEAD>
24259 <BODY>
24260 <H1>Set Index Format</H1>
24261
24262 This option is used to customize the content of lines in the
24263 <A HREF="h_mail_index">MESSAGE INDEX screen</A>.
24264 This action works exactly like the regular
24265 &quot;<!--#echo var="VAR_index-format"-->&quot; option in the Setup/Config screen,
24266 except that you can have a folder-specific value for it if you specify it here.
24267 Consult the help for
24268 &quot;<A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A>&quot;
24269 for more information.
24270
24271 <P>
24272 <UL>
24273 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24274 </UL><P>
24275 &lt;End of help on this topic&gt;
24276 </BODY>
24277 </HTML>
24278 ====== h_config_index_format =====
24279 <HTML>
24280 <HEAD>
24281 <TITLE>OPTION: <!--#echo var="VAR_index-format"--></TITLE>
24282 </HEAD>
24283 <BODY>
24284 <H1>OPTION: <!--#echo var="VAR_index-format"--></H1>
24285
24286 This option is used to customize the content of lines in the
24287 <A HREF="h_mail_index">MESSAGE INDEX screen</A>.  Each line is intended
24288 to convey some amount of immediately relevant information about each
24289 message in the current folder.
24290 <P>
24291
24292 Alpine provides a pre-defined set of informational fields with
24293 reasonable column widths automatically computed.  You can, however,
24294 replace this default set by listing special tokens in the order you
24295 want them displayed.
24296 <P>
24297
24298 The list of available tokens is
24299 <A HREF="h_index_tokens">here</A>.
24300 <P>
24301
24302 Spaces are used to separate listed tokens.  Additionally, you can
24303 specify how much of the screen's width the token's associated data
24304 should occupy on the index line by appending to the token a pair of
24305 parentheses enclosing either a number or percentage.  For example,
24306 &quot;SUBJECT(13)&quot; means to allocate 13 characters of space to the subject
24307 column, and &quot;SUBJECT(20%)&quot; means to
24308 allocate 20% of the available space
24309 to the subjects column, while plain &quot;SUBJECT&quot; means the system will
24310 attempt to figure out a reasonable amount of space.
24311 <P>
24312
24313 There is always one space between every pair of columns, so if you use fixed
24314 column widths (like 13) you should remember to take that into account.
24315 Several of the fields are virtually fixed-width, so it doesn't make
24316 much sense to specify the width for them.  The fields STATUS,
24317 FULLSTATUS, IMAPSTATUS, MSGNO, the DATE fields, SIZE,
24318 and DESCRIPSIZE all fall into that category.
24319 You <EM>may</EM> specify widths for those if you wish, but
24320 you're probably better off letting the system pick those widths.  <P>
24321
24322 <P>
24323 The default is equivalent to:
24324
24325 <P>
24326 <CENTER><SAMP>STATUS MSGNO SMARTDATETIME24 FROMORTO(33%) SIZENARROW SUBJKEY(67%)</SAMP></CENTER>
24327
24328 <P>
24329 This means that the four fields without percentages will be allocated
24330 first, and then 33% and 67% of the <EM>remaining</EM> space will go to
24331 the from and subject fields.  If one of those two fields is specified
24332 as a percentage and the other is left for the system to choose, then
24333 the percentage is taken as an absolute percentage of the screen, not
24334 of the space remaining after allocating the first four columns.  It
24335 doesn't usually make sense to do it that way.  If you leave off all
24336 the widths, then the subject and from fields (if both are present) are
24337 allocated space in a 2 to 1 ratio, which is almost exactly the same as
24338 the default.
24339
24340 <P>
24341 What you are most likely to do with this configuration option is to
24342 specify which fields appear at all, which order they appear in, and the
24343 percentage of screen that is used for the from and subject fields if you
24344 don't like the 2 to 1 default.
24345
24346 <P>
24347 If you want to retain the default format that Pine 4.64 had, use
24348
24349 <P>
24350 <CENTER><SAMP><!--#echo var="VAR_index-format"-->=STATUS MSGNO DATE FROMORTO(33%) SIZE SUBJKEY(67%)</SAMP></CENTER>
24351 <P>
24352 <EM>and</EM> set the feature
24353 <A HREF="h_config_disable_index_locale_dates"><!--#echo var="FEAT_disable-index-locale-dates"--></A>.
24354 <UL>
24355 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24356 </UL><P>
24357 &lt;End of help on this topic&gt;
24358 </BODY>
24359 </HTML>
24360 ====== h_config_reply_intro =====
24361 <HTML>
24362 <HEAD>
24363 <TITLE>OPTION: <!--#echo var="VAR_reply-leadin"--></TITLE>
24364 </HEAD>
24365 <BODY>
24366 <H1>OPTION: <!--#echo var="VAR_reply-leadin"--></H1>
24367
24368 This option is used to customize the content of the introduction line
24369 that is included when replying to a message and including the original
24370 message in the reply.
24371 The normal default (what you will get if you delete this variable) looks
24372 something like:
24373 <P>
24374 <CENTER><SAMP>On Sat, 24 Oct 1998, Fred Flintstone wrote:</SAMP></CENTER>
24375 <P>
24376 where the day of the week is only included if it is available in the
24377 original message.
24378 You can replace this default with text of your own.
24379 The text may contain tokens that are replaced with text
24380 that depends on the message you are replying to.
24381 For example, the default is equivalent to:
24382 <P>
24383 <CENTER><SAMP>On _DAYDATE_, _FROM_ wrote:</SAMP></CENTER>
24384 <P>
24385
24386 Since this variable includes regular text mixed with special tokens
24387 the tokens have to be surrounded by underscore characters.
24388 For example, to use the token &quot;<SAMP>PREFDATE</SAMP>&quot;
24389 you would need to use &quot;<SAMP>_PREFDATE_</SAMP>&quot;,
24390 not &quot;<SAMP>PREFDATE</SAMP>&quot;.
24391 <P>
24392 The list of available tokens is
24393 <A HREF="h_index_tokens">here</A>.
24394
24395 <P>
24396 By default, the text is all on a single line and is followed by a blank line.
24397 If your &quot;<!--#echo var="VAR_reply-leadin"-->&quot; turns out to be longer
24398 than 80 characters when replying to a particular message, it is shortened.
24399 However, if you use the token
24400 <P>
24401 <CENTER><SAMP>_NEWLINE_</SAMP></CENTER>
24402 <P>
24403
24404 anywhere in the value, no end of line or blank line is appended, and no
24405 shortening is done.
24406 The _NEWLINE_ token may be used to get rid of the blank line following
24407 the text, to add more blank lines, or to form a multi-line
24408 &quot;<!--#echo var="VAR_reply-leadin"-->&quot;.
24409 To clarify how _NEWLINE_ works recall that the default value is:
24410 <P>
24411 <CENTER><SAMP>On _DAYDATE_, _FROM_ wrote:</SAMP></CENTER>
24412 <P>
24413
24414 That is equivalent to
24415 <P>
24416 <CENTER><SAMP>On _DAYDATE_, _FROM_ wrote:_NEWLINE__NEWLINE_</SAMP></CENTER>
24417 <P>
24418
24419 In the former case, two newlines are added automatically because
24420 no _NEWLINE_ token appears in the value of the option (for backwards
24421 compatibility). In the latter case, the newlines are explicit.
24422 If you want to remove the blank line that follows the
24423 &quot;<!--#echo var="VAR_reply-leadin"-->&quot; text use a single
24424 _NEWLINE_ token like
24425 <P>
24426 <CENTER><SAMP>On _DAYDATE_, _FROM_ wrote:_NEWLINE_</SAMP></CENTER>
24427 <P>
24428
24429 Because of the backwards compatibility problem, it is not possible to
24430 remove all of the ends of lines, because then there will be no _NEWLINE_ tokens
24431 and that will cause the automatic adding of two newlines!
24432 If you want, you may embed newlines in the middle of the text, as well,
24433 producing a multi-line &quot;<!--#echo var="VAR_reply-leadin"-->&quot;.
24434
24435 <P>
24436 By default, no attempt is made to localize the date.
24437 If you prefer a localized form you may find that one of the tokens
24438 _PREFDATE_ or _PREFDATETIME_ is a satisfactory substitute.
24439 If you want more control one of the many other date tokens, such as _DATEISO_,
24440 might be better.
24441
24442 <P>
24443 For the adventurous, there is a way to conditionally include text based
24444 on whether or not a token would result in specific replacement text.
24445 For example, you could include some text based on whether or not
24446 the _NEWS_ token would result in any newsgroups if it was used.
24447 It's explained in detail
24448 <A HREF="h_reply_token_conditionals">here</A>.
24449
24450 <P>
24451 In the very unlikely event that you want to include a literal token
24452 in the introduction line you must precede it with a backslash character.
24453 For example,
24454 <P>
24455 <CENTER><SAMP>&#92;_DAYDATE_ = _DAYDATE_</SAMP></CENTER>
24456 <P>
24457 would produce something like
24458 <P>
24459 <CENTER><SAMP>_DAYDATE_ = Sat, 24 Oct 1998</SAMP></CENTER>
24460 <P>
24461 It is not possible to have a literal backslash followed by an expanded token.
24462 <P>
24463 <UL>
24464 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24465 </UL><P>
24466 &lt;End of help on this topic&gt;
24467 </BODY>
24468 </HTML>
24469 ====== h_config_remote_abook_history =====
24470 <HTML>
24471 <HEAD>
24472 <TITLE>OPTION: <!--#echo var="VAR_remote-abook-history"--></TITLE>
24473 </HEAD>
24474 <BODY>
24475 <H1>OPTION: <!--#echo var="VAR_remote-abook-history"--></H1>
24476
24477 Sets how many extra copies of
24478 remote address book
24479 data will be kept in each remote address book folder.
24480 The default is three.
24481 These extra copies are simply old versions of the data. Each time a change
24482 is made a new copy of the address book data is appended to the folder. Old
24483 copies are trimmed, if possible, when Alpine exits.
24484 An old copy can be put back into use by
24485 deleting and expunging newer versions of the data from the folder.
24486 Don't delete the first message from the folder. It is a special header
24487 message for the remote address book and it must be there.
24488 This is to prevent regular folders from being used as remote address book
24489 folders and having their data destroyed.
24490 <P>
24491 This option is also used to determine how many extra copies of remote
24492 Alpine configuration files are kept.
24493 <P>
24494 <UL>
24495 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24496 </UL><P>
24497 &lt;End of help on this topic&gt;
24498 </BODY>
24499 </HTML>
24500 ====== h_config_remote_abook_validity =====
24501 <HTML>
24502 <HEAD>
24503 <TITLE>OPTION: <!--#echo var="VAR_remote-abook-validity"--></TITLE>
24504 </HEAD>
24505 <BODY>
24506 <H1>OPTION: <!--#echo var="VAR_remote-abook-validity"--></H1>
24507
24508 Sets the minimum number of minutes that a
24509 remote address book will be considered up to date.
24510 Whenever an entry contained in a remote address book is used,
24511 if more than this many minutes have
24512 passed since the last check the remote server will be queried to see if the
24513 address book has changed.
24514 If it has changed, the local copy is updated.
24515 The default value is five minutes.
24516 The special value of -1 means never check.
24517 The special value of zero means only check when the address book is first
24518 opened.
24519 <P>
24520 No matter what the value, the validity check is always done when the
24521 address book is about to be changed by the user.
24522 The check can be initiated manually by typing <EM>^L</EM> (Ctrl-L)
24523 while in the address book maintenance screen for the remote address book.
24524 <P>
24525 <UL>
24526 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24527 </UL><P>
24528 &lt;End of help on this topic&gt;
24529 </BODY>
24530 </HTML>
24531 ====== h_config_user_input_timeo =====
24532 <HTML>
24533 <HEAD>
24534 <TITLE>OPTION: <!--#echo var="VAR_user-input-timeout"--></TITLE>
24535 </HEAD>
24536 <BODY>
24537 <H1>OPTION: <!--#echo var="VAR_user-input-timeout"--></H1>
24538
24539 If this is set to an integer greater than zero, then this is the number
24540 of <EM>hours</EM> to wait for user input before Alpine times out.
24541 If Alpine is
24542 in the midst of composing a message or is waiting for user response to
24543 a question, then it will not timeout.
24544 However, if Alpine is sitting idle waiting for
24545 the user to tell it what to do next and the user does not give any
24546 input for this many hours, Alpine will exit.
24547 No expunging or moving of read
24548 messages will take place.
24549 It will exit similarly to the way it would exit
24550 if it received a hangup signal.
24551 This may be useful for cleaning up unused Alpine sessions that have been
24552 forgotten by their owners.
24553 The Alpine developers envision system administrators
24554 setting this to a value of several hours (24?) so that it won't surprise
24555 a user who didn't want to be disconnected.
24556 <P>
24557 <UL>
24558 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24559 </UL><P>
24560 &lt;End of help on this topic&gt;
24561 </BODY>
24562 </HTML>
24563 ====== h_config_ssh_open_timeo =====
24564 <HTML>
24565 <HEAD>
24566 <TITLE>OPTION: <!--#echo var="VAR_ssh-open-timeout"--></TITLE>
24567 </HEAD>
24568 <BODY>
24569 <H1>OPTION: <!--#echo var="VAR_ssh-open-timeout"--></H1>
24570
24571 Sets the time in seconds that Alpine will
24572 attempt to open a UNIX secure shell connection.
24573 The default is 15, the minimum non-zero value is 5,
24574 and the maximum is unlimited. If this is set to zero ssh connections
24575 will be completely disabled.
24576 <P>
24577 <UL>
24578 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24579 </UL><P>
24580 &lt;End of help on this topic&gt;
24581 </BODY>
24582 </HTML>
24583 ====== h_config_rsh_open_timeo =====
24584 <HTML>
24585 <HEAD>
24586 <TITLE>OPTION: <!--#echo var="VAR_rsh-open-timeout"--></TITLE>
24587 </HEAD>
24588 <BODY>
24589 <H1>OPTION: <!--#echo var="VAR_rsh-open-timeout"--></H1>
24590
24591 Sets the time in seconds that Alpine will
24592 attempt to open a UNIX remote shell connection.
24593 The default is 15, the minimum non-zero value is 5,
24594 and the maximum is unlimited. If this is set to zero rsh connections
24595 will be completely disabled.
24596 This might be useful if rsh connections will never work in your environment
24597 but are causing delays due to firewalls or some other reason.
24598 <P>
24599 <UL>
24600 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24601 </UL><P>
24602 &lt;End of help on this topic&gt;
24603 </BODY>
24604 </HTML>
24605 ====== h_config_tcp_open_timeo =====
24606 <HTML>
24607 <HEAD>
24608 <TITLE>OPTION: <!--#echo var="VAR_tcp-open-timeout"--></TITLE>
24609 </HEAD>
24610 <BODY>
24611 <H1>OPTION: <!--#echo var="VAR_tcp-open-timeout"--></H1>
24612
24613 Sets the time in seconds that Alpine will
24614 attempt to open a network connection. The default is 30, the minimum is 5,
24615 and the maximum is system defined (typically 75). If a connection has not
24616 completed within this many seconds Alpine will give up and consider it a
24617 failed connection.
24618 <P>
24619 <UL>
24620 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24621 </UL><P>
24622 &lt;End of help on this topic&gt;
24623 </BODY>
24624 </HTML>
24625 ====== h_config_tcp_readwarn_timeo =====
24626 <HTML>
24627 <HEAD>
24628 <TITLE>OPTION: <!--#echo var="VAR_tcp-read-warning-timeout"--></TITLE>
24629 </HEAD>
24630 <BODY>
24631 <H1>OPTION: <!--#echo var="VAR_tcp-read-warning-timeout"--></H1>
24632
24633 Sets the time in seconds that Alpine will
24634 wait for a network read before warning you that things are moving slowly
24635 and possibly giving you the option to break the connection.
24636 The default is 15 seconds. The minimum is 5 seconds and the maximumn is
24637 1000 seconds.
24638 <P>
24639 Related option: <A HREF="h_config_tcp_query_timeo"><!--#echo var="VAR_tcp-query-timeout"--></A>.
24640 <P>
24641 <UL>
24642 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24643 </UL><P>
24644 &lt;End of help on this topic&gt;
24645 </BODY>
24646 </HTML>
24647 ====== h_config_tcp_writewarn_timeo =====
24648 <HTML>
24649 <HEAD>
24650 <TITLE>OPTION: <!--#echo var="VAR_tcp-write-warning-timeout"--></TITLE>
24651 </HEAD>
24652 <BODY>
24653 <H1>OPTION: <!--#echo var="VAR_tcp-write-warning-timeout"--></H1>
24654
24655 Sets the time in seconds that Alpine will
24656 wait for a network write before warning you that things are moving slowly
24657 and possibly giving you the option to break the connection.
24658 The default is 0 which means it is unset. If set to a non-zero value, the
24659 minimum is 5 and the maximum is 1000.
24660 <P>
24661 Related option: <A HREF="h_config_tcp_query_timeo"><!--#echo var="VAR_tcp-query-timeout"--></A>.
24662 <P>
24663 <UL>
24664 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24665 </UL><P>
24666 &lt;End of help on this topic&gt;
24667 </BODY>
24668 </HTML>
24669 ====== h_config_tcp_query_timeo =====
24670 <HTML>
24671 <HEAD>
24672 <TITLE>OPTION: <!--#echo var="VAR_tcp-query-timeout"--></TITLE>
24673 </HEAD>
24674 <BODY>
24675 <H1>OPTION: <!--#echo var="VAR_tcp-query-timeout"--></H1>
24676
24677 When Alpine times out a network read or write it will normally just display
24678 a message saying &quot;Still waiting&quot;.
24679 However, if enough time has elapsed since it started waiting it will offer
24680 to let you break the connection.
24681 That amount of time is set by this option, which defaults to 60 seconds,
24682 has a minimum of 5 seconds, and a maximum of 1000 seconds.
24683 <P>
24684 <UL>
24685 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24686 </UL><P>
24687 &lt;End of help on this topic&gt;
24688 </BODY>
24689 </HTML>
24690 ====== h_config_incoming_folders =====
24691 <HTML>
24692 <HEAD>
24693 <TITLE>OPTION: <!--#echo var="VAR_incoming-folders"--></TITLE>
24694 </HEAD>
24695 <BODY>
24696 <H1>OPTION: <!--#echo var="VAR_incoming-folders"--></H1>
24697
24698 This is a list of one or more folders other than <EM>INBOX</EM> that
24699 may receive new messages.
24700 It is related to the
24701 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="FEAT_enable-incoming-folders"-->&quot;</A>
24702 feature.
24703 This variable is normally manipulated with the Add, Delete, and Rename
24704 commands in the FOLDER LIST for the Incoming Message Folders collection.
24705 <P>
24706 <UL>
24707 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24708 </UL><P>
24709 &lt;End of help on this topic&gt;
24710 </BODY>
24711 </HTML>
24712 ====== h_config_folder_spec =====
24713 <HTML>
24714 <HEAD>
24715 <TITLE>OPTION: <!--#echo var="VAR_folder-collections"--></TITLE>
24716 </HEAD>
24717 <BODY>
24718 <H1>OPTION: <!--#echo var="VAR_folder-collections"--></H1>
24719
24720 This is a list of one or more collections where saved mail is stored.
24721 The first collection in this list is the default
24722 collection for <EM>Save</EM>s,
24723 including <A HREF="h_config_default_fcc"><!--#echo var="VAR_default-fcc"--></A>.
24724 <P>
24725 This variable is normally manipulated using the Setup/collectionList screen.
24726 <P>
24727 <UL>
24728 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24729 </UL><P>
24730 &lt;End of help on this topic&gt;
24731 </BODY>
24732 </HTML>
24733 ====== h_config_news_spec =====
24734 <HTML>
24735 <HEAD>
24736 <TITLE>OPTION: <!--#echo var="VAR_news-collections"--></TITLE>
24737 </HEAD>
24738 <BODY>
24739 <H1>OPTION: <!--#echo var="VAR_news-collections"--></H1>
24740
24741 This is a list of collections where news folders are located.
24742 <P>
24743 This variable is normally manipulated using the Setup/collectionList screen.
24744 <P>
24745 <UL>
24746 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24747 </UL><P>
24748 &lt;End of help on this topic&gt;
24749 </BODY>
24750 </HTML>
24751 ====== h_config_address_book =====
24752 <HTML>
24753 <HEAD>
24754 <TITLE>OPTION: <!--#echo var="VAR_address-book"--></TITLE>
24755 </HEAD>
24756 <BODY>
24757 <H1>OPTION: <!--#echo var="VAR_address-book"--></H1>
24758
24759 A list of personal address books.
24760 Each entry in the list is an
24761 optional nickname followed by a pathname or file name relative to the home
24762 directory.
24763 The nickname is separated from the rest of the line with whitespace.
24764 Instead of a local pathname or file name, a remote folder name can be given.
24765 This causes the address book to
24766 be a Remote address book.
24767 <P>
24768 Use the Setup/AddressBook screen to modify this variable.
24769 <P>
24770 <UL>
24771 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24772 </UL><P>
24773 &lt;End of help on this topic&gt;
24774 </BODY>
24775 </HTML>
24776 ====== h_config_glob_addrbook =====
24777 <HTML>
24778 <HEAD>
24779 <TITLE>OPTION: <!--#echo var="VAR_global-address-book"--></TITLE>
24780 </HEAD>
24781 <BODY>
24782 <H1>OPTION: <!--#echo var="VAR_global-address-book"--></H1>
24783
24784 A list of shared address books.  Each entry in the list is an
24785 optional nickname followed by a pathname or file name relative to the home
24786 directory.
24787 A SPACE character separates the nickname from the rest of the line.
24788 Instead of a local pathname or file name, a remote folder name can be given.
24789 This causes the address book to
24790 be a Remote address book.
24791 Global address books are
24792 defined to be ReadOnly.
24793 <P>
24794 Use the Setup/AddressBook screen to modify this variable.
24795 <P>
24796 <UL>
24797 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24798 </UL><P>
24799 &lt;End of help on this topic&gt;
24800 </BODY>
24801 </HTML>
24802 ====== h_config_last_vers =====
24803 <HTML>
24804 <HEAD>
24805 <TITLE>OPTION: <!--#echo var="VAR_last-version-used"--></TITLE>
24806 </HEAD>
24807 <BODY>
24808 <H1>OPTION: <!--#echo var="VAR_last-version-used"--></H1>
24809
24810 This is set automatically by Alpine.
24811 It is used to keep track of the last version of Alpine that
24812 was run by the user.
24813 Whenever the version number increases, a new version message is printed out.
24814 This may not be set in the system-wide configuration files.
24815 <P>
24816 <UL>
24817 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24818 </UL><P>
24819 &lt;End of help on this topic&gt;
24820 </BODY>
24821 </HTML>
24822 ====== h_config_printer =====
24823 <HTML>
24824 <HEAD>
24825 <TITLE>OPTION: Printer</TITLE>
24826 </HEAD>
24827 <BODY>
24828 <H1>OPTION: Printer</H1>
24829
24830 Your default printer selection.
24831 <P>
24832 Use the Setup/Printer screen to modify this variable.
24833 <P>
24834 <UL>
24835 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24836 </UL><P>
24837 &lt;End of help on this topic&gt;
24838 </BODY>
24839 </HTML>
24840 ====== h_config_print_cat =====
24841 <HTML>
24842 <HEAD>
24843 <TITLE>OPTION: <!--#echo var="VAR_personal-print-category"--></TITLE>
24844 </HEAD>
24845 <BODY>
24846 <H1>OPTION: <!--#echo var="VAR_personal-print-category"--></H1>
24847
24848 This is an internal Alpine variable.
24849 It will be equal to 1, 2, or 3 depending on whether the default printer is
24850 attached, standard, or a personal print command.
24851 <P>
24852 Use the Setup/Printer screen to modify this variable.
24853 <P>
24854 <UL>
24855 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24856 </UL><P>
24857 &lt;End of help on this topic&gt;
24858 </BODY>
24859 </HTML>
24860 ====== h_config_print_command =====
24861 <HTML>
24862 <HEAD>
24863 <TITLE>OPTION: <!--#echo var="VAR_personal-print-command"--></TITLE>
24864 </HEAD>
24865 <BODY>
24866 <H1>OPTION: <!--#echo var="VAR_personal-print-command"--></H1>
24867
24868 List of personal print commands.
24869 <P>
24870 Use the Setup/Printer screen to modify this variable.
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_pat_old =====
24879 <HTML>
24880 <HEAD>
24881 <TITLE>OPTION: Patterns</TITLE>
24882 </HEAD>
24883 <BODY>
24884 <H1>OPTION: Patterns</H1>
24885
24886 The option Patterns is obsolete in Alpine and in Pine 4.50 and later, replaced by the
24887 options Patterns-Roles, Patterns-Filters, Patterns-Scores, Patterns-Indexcolors,
24888 and Patterns-Other.
24889 Patterns-Scores and Patterns-Filters have been replaced since then by
24890 Patterns-Scores2 and Patterns-Filters2.
24891 <P>
24892 Use the Setup/Rules screens to modify these variable.
24893 <P>
24894 <UL>
24895 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24896 </UL><P>
24897 &lt;End of help on this topic&gt;
24898 </BODY>
24899 </HTML>
24900 ====== h_config_pat_roles =====
24901 <HTML>
24902 <HEAD>
24903 <TITLE>OPTION: <!--#echo var="VAR_patterns-roles"--></TITLE>
24904 </HEAD>
24905 <BODY>
24906 <H1>OPTION: <!--#echo var="VAR_patterns-roles"--></H1>
24907
24908 List of rules used for roles.
24909 The option Patterns is obsolete in Alpine and in Pine 4.50 and later, replaced by this and
24910 other options.
24911 <P>
24912 Use the Setup/Rules/Roles screen to modify this variable.
24913 <P>
24914 <UL>
24915 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24916 </UL><P>
24917 &lt;End of help on this topic&gt;
24918 </BODY>
24919 </HTML>
24920 ====== h_config_pat_filts =====
24921 <HTML>
24922 <HEAD>
24923 <TITLE>OPTION: <!--#echo var="VAR_patterns-filters2"--></TITLE>
24924 </HEAD>
24925 <BODY>
24926 <H1>OPTION: <!--#echo var="VAR_patterns-filters2"--></H1>
24927
24928 List of rules used for filters.
24929 <P>
24930 Use the Setup/Rules/Filters screen to modify this variable.
24931 <P>
24932 <UL>
24933 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24934 </UL><P>
24935 &lt;End of help on this topic&gt;
24936 </BODY>
24937 </HTML>
24938 ====== h_config_pat_scores =====
24939 <HTML>
24940 <HEAD>
24941 <TITLE>OPTION: <!--#echo var="VAR_patterns-scores2"--></TITLE>
24942 </HEAD>
24943 <BODY>
24944 <H1>OPTION: <!--#echo var="VAR_patterns-scores2"--></H1>
24945
24946 List of rules used for scoring.
24947 <P>
24948 Use the Setup/Rules/SetScores screen to modify this 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_other =====
24957 <HTML>
24958 <HEAD>
24959 <TITLE>OPTION: <!--#echo var="VAR_patterns-other"--></TITLE>
24960 </HEAD>
24961 <BODY>
24962 <H1>OPTION: <!--#echo var="VAR_patterns-other"--></H1>
24963
24964 List of rules used for miscellaneous configuration.
24965 <P>
24966 Use the Setup/Rules/Other screen to modify this variable.
24967 <P>
24968 <UL>
24969 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24970 </UL><P>
24971 &lt;End of help on this topic&gt;
24972 </BODY>
24973 </HTML>
24974 ====== h_config_pat_incols =====
24975 <HTML>
24976 <HEAD>
24977 <TITLE>OPTION: patterns-indexcolors</TITLE>
24978 </HEAD>
24979 <BODY>
24980 <H1>OPTION: patterns-indexcolors</H1>
24981
24982 List of rules used for coloring lines in the index.
24983 <P>
24984 Use the Setup/Rules/Indexcolor screen to modify this variable.
24985 <P>
24986 <UL>
24987 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24988 </UL><P>
24989 &lt;End of help on this topic&gt;
24990 </BODY>
24991 </HTML>
24992 ====== h_config_pat_srch =====
24993 <HTML>
24994 <HEAD>
24995 <TITLE>OPTION: patterns-search</TITLE>
24996 </HEAD>
24997 <BODY>
24998 <H1>OPTION: patterns-search</H1>
24999
25000 List of rules used only for searching with the Select command in the MESSAGE INDEX.
25001 <P>
25002 Use the Setup/Rules/searCh screen to modify this variable.
25003 <P>
25004 <UL>
25005 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25006 </UL><P>
25007 &lt;End of help on this topic&gt;
25008 </BODY>
25009 </HTML>
25010 ====== h_config_font_name =====
25011 <HTML>
25012 <HEAD>
25013 <TITLE>OPTION: Font Name</TITLE>
25014 </HEAD>
25015 <BODY>
25016 <H1>OPTION: Font Name</H1>
25017
25018 PC-Alpine only.
25019 <P>
25020 Name of normal font.
25021 <P>
25022 Use the pulldown Config menu 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_font_size =====
25031 <HTML>
25032 <HEAD>
25033 <TITLE>OPTION: Font Size</TITLE>
25034 </HEAD>
25035 <BODY>
25036 <H1>OPTION: Font Size</H1>
25037
25038 PC-Alpine only.
25039 <P>
25040 Size of normal font.
25041 <P>
25042 Use the pulldown Config menu to modify this variable.
25043 <P>
25044 <UL>
25045 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25046 </UL><P>
25047 &lt;End of help on this topic&gt;
25048 </BODY>
25049 </HTML>
25050 ====== h_config_font_style =====
25051 <HTML>
25052 <HEAD>
25053 <TITLE>OPTION: Font Style</TITLE>
25054 </HEAD>
25055 <BODY>
25056 <H1>OPTION: Font Style</H1>
25057
25058 PC-Alpine only.
25059 <P>
25060 Style of normal font.
25061 <P>
25062 Use the pulldown Config menu to modify this variable.
25063 <P>
25064 <UL>
25065 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25066 </UL><P>
25067 &lt;End of help on this topic&gt;
25068 </BODY>
25069 </HTML>
25070 ====== h_config_font_char_set =====
25071 <HTML>
25072 <HEAD>
25073 <TITLE>OPTION: Font Character Set</TITLE>
25074 </HEAD>
25075 <BODY>
25076 <H1>OPTION: Font Character Set</H1>
25077
25078 PC-Alpine only.
25079 <P>
25080 Character set of normal font.
25081 <P>
25082 Use the pulldown Config menu to modify this variable.
25083 <P>
25084 <UL>
25085 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25086 </UL><P>
25087 &lt;End of help on this topic&gt;
25088 </BODY>
25089 </HTML>
25090 ====== h_config_print_font_name =====
25091 <HTML>
25092 <HEAD>
25093 <TITLE>OPTION: Print-Font-Name</TITLE>
25094 </HEAD>
25095 <BODY>
25096 <H1>OPTION: Print-Font-Name</H1>
25097
25098 PC-Alpine only.
25099 <P>
25100 Name of printer font.
25101 <P>
25102 Use the pulldown Config menu to modify this variable.
25103 <P>
25104 <UL>
25105 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25106 </UL><P>
25107 &lt;End of help on this topic&gt;
25108 </BODY>
25109 </HTML>
25110 ====== h_config_print_font_size =====
25111 <HTML>
25112 <HEAD>
25113 <TITLE>OPTION: Print-Font-Size</TITLE>
25114 </HEAD>
25115 <BODY>
25116 <H1>OPTION: Print-Font-Size</H1>
25117
25118 PC-Alpine only.
25119 <P>
25120 Size of printer font.
25121 <P>
25122 Use the pulldown Config menu to modify this variable.
25123 <P>
25124 <UL>
25125 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25126 </UL><P>
25127 &lt;End of help on this topic&gt;
25128 </BODY>
25129 </HTML>
25130 ====== h_config_print_font_style =====
25131 <HTML>
25132 <HEAD>
25133 <TITLE>OPTION: Print-Font-Style</TITLE>
25134 </HEAD>
25135 <BODY>
25136 <H1>OPTION: Print-Font-Style</H1>
25137
25138 PC-Alpine only.
25139 <P>
25140 Style of printer font.
25141 <P>
25142 Use the pulldown Config menu to modify this variable.
25143 <P>
25144 <UL>
25145 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25146 </UL><P>
25147 &lt;End of help on this topic&gt;
25148 </BODY>
25149 </HTML>
25150 ====== h_config_print_font_char_set =====
25151 <HTML>
25152 <HEAD>
25153 <TITLE>OPTION: Print-Font-Char-Set</TITLE>
25154 </HEAD>
25155 <BODY>
25156 <H1>OPTION: Print-Font-Char-Set</H1>
25157
25158 PC-Alpine only.
25159 <P>
25160 Character set of printer font.
25161 <P>
25162 Use the pulldown Config menu to modify this variable.
25163 <P>
25164 <UL>
25165 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25166 </UL><P>
25167 &lt;End of help on this topic&gt;
25168 </BODY>
25169 </HTML>
25170 ====== h_config_window_position =====
25171 <HTML>
25172 <HEAD>
25173 <TITLE>OPTION: Window-Position</TITLE>
25174 </HEAD>
25175 <BODY>
25176 <H1>OPTION: Window-Position</H1>
25177
25178 PC-Alpine only.
25179 <P>
25180 Position on the screen of the Alpine window.
25181 <P>
25182 Alpine normally maintains this variable itself, and it is set automatically.
25183 This variable is provided to those who wish to use the same window position
25184 across different machines from the same configuration.
25185 <A HREF="h_config_winpos_in_config"><!--#echo var="FEAT_store-window-position-in-config"--></A>
25186 must also be set for this setting to be used.
25187 <P>
25188 The format for this variable is of the form: <CODE>CxR+X+Y</CODE>, where
25189 C is the number of columns, R is the number of rows, and X and Y specify the
25190 top left corner of the window.
25191 <P>
25192 <UL>
25193 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25194 </UL><P>
25195 &lt;End of help on this topic&gt;
25196 </BODY>
25197 </HTML>
25198 ====== h_config_cursor_style =====
25199 <HTML>
25200 <HEAD>
25201 <TITLE>OPTION: Cursor Style</TITLE>
25202 </HEAD>
25203 <BODY>
25204 <H1>OPTION: Cursor Style</H1>
25205
25206 PC-Alpine only.
25207 <P>
25208 Cursor style.
25209 <P>
25210 Use the pulldown Config menu to modify this variable.
25211 <P>
25212 <UL>
25213 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25214 </UL><P>
25215 &lt;End of help on this topic&gt;
25216 </BODY>
25217 </HTML>
25218 ====== h_config_ldap_servers =====
25219 <HTML>
25220 <HEAD>
25221 <TITLE>OPTION: <!--#echo var="VAR_ldap-servers"--></TITLE>
25222 </HEAD>
25223 <BODY>
25224 <H1>OPTION: <!--#echo var="VAR_ldap-servers"--></H1>
25225
25226 List of LDAP servers and associated data.
25227 <P>
25228 Use the Setup/Directory screen to modify this variable.
25229 <P>
25230 <UL>
25231 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25232 </UL><P>
25233 &lt;End of help on this topic&gt;
25234 </BODY>
25235 </HTML>
25236 ====== h_config_sendmail_path =====
25237 <HTML>
25238 <HEAD>
25239 <TITLE>OPTION: <!--#echo var="VAR_sendmail-path"--></TITLE>
25240 </HEAD>
25241 <BODY>
25242 <H1>OPTION: <!--#echo var="VAR_sendmail-path"--></H1>
25243
25244 This names the path to an
25245 alternative program, and any necessary arguments, to be used in posting
25246 mail messages. See the Technical notes for more information.
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_oper_dir =====
25255 <HTML>
25256 <HEAD>
25257 <TITLE>OPTION: <!--#echo var="VAR_operating-dir"--></TITLE>
25258 </HEAD>
25259 <BODY>
25260 <H1>OPTION: <!--#echo var="VAR_operating-dir"--></H1>
25261
25262 This names the root of the
25263 tree to which you are restricted when reading and writing folders and
25264 files. It is usually used in the system-wide,
25265 <EM>fixed</EM> configuration file.
25266 <P>
25267 <UL>
25268 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25269 </UL><P>
25270 &lt;End of help on this topic&gt;
25271 </BODY>
25272 </HTML>
25273 ====== h_config_rshpath =====
25274 <HTML>
25275 <HEAD>
25276 <TITLE>OPTION: <!--#echo var="VAR_rsh-path"--></TITLE>
25277 </HEAD>
25278 <BODY>
25279 <H1>OPTION: <!--#echo var="VAR_rsh-path"--></H1>
25280
25281 Sets the name of the command used to open a UNIX remote shell
25282 connection. The default is typically <CODE>/usr/ucb/rsh</CODE>.
25283 <P>
25284 <UL>
25285 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25286 </UL><P>
25287 &lt;End of help on this topic&gt;
25288 </BODY>
25289 </HTML>
25290 ====== h_config_rshcmd =====
25291 <HTML>
25292 <HEAD>
25293 <TITLE>OPTION: <!--#echo var="VAR_rsh-command"--></TITLE>
25294 </HEAD>
25295 <BODY>
25296 <H1>OPTION: <!--#echo var="VAR_rsh-command"--></H1>
25297
25298 Sets the format of the command used to
25299 open a UNIX remote shell connection. The default is
25300 "%s %s -l %s exec /etc/r%sd". All four "%s" entries MUST exist in the
25301 provided command. The first is for the command's pathname, the second is
25302 for the host to connnect to, the third is for the user to connect as, and
25303 the fourth is for the connection method (typically <CODE>imap</CODE>).
25304 <P>
25305 <UL>
25306 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25307 </UL><P>
25308 &lt;End of help on this topic&gt;
25309 </BODY>
25310 </HTML>
25311 ====== h_config_sshpath =====
25312 <HTML>
25313 <HEAD>
25314 <TITLE>OPTION: <!--#echo var="VAR_ssh-path"--></TITLE>
25315 </HEAD>
25316 <BODY>
25317 <H1>OPTION: <!--#echo var="VAR_ssh-path"--></H1>
25318
25319 Sets the name of the command used to open a UNIX secure shell
25320 connection. The default is typically <CODE>/usr/bin/ssh</CODE>.
25321 <P>
25322 <UL>
25323 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25324 </UL><P>
25325 &lt;End of help on this topic&gt;
25326 </BODY>
25327 </HTML>
25328 ====== h_config_sshcmd =====
25329 <HTML>
25330 <HEAD>
25331 <TITLE>OPTION: <!--#echo var="VAR_ssh-command"--></TITLE>
25332 </HEAD>
25333 <BODY>
25334 <H1>OPTION: <!--#echo var="VAR_ssh-command"--></H1>
25335
25336 Sets the format of the command used to
25337 open a UNIX secure shell connection. The default is
25338 "%s %s -l %s exec /etc/r%sd". All four "%s" entries MUST exist in the
25339 provided command. The first is for the command's pathname, the second is
25340 for the host to connnect to, the third is for the user to connect as, and
25341 the fourth is for the connection method (typically <CODE>imap</CODE>).
25342 <P>
25343 <UL>
25344 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25345 </UL><P>
25346 &lt;End of help on this topic&gt;
25347 </BODY>
25348 </HTML>
25349 ====== h_config_new_ver_quell =====
25350 <HTML>
25351 <HEAD>
25352 <TITLE>OPTION: <!--#echo var="VAR_new-version-threshold"--></TITLE>
25353 </HEAD>
25354 <BODY>
25355 <H1>OPTION: <!--#echo var="VAR_new-version-threshold"--></H1>
25356
25357 When a new version of Alpine is run for the first time it offers a
25358 special explanatory screen to the user upon startup.  This option
25359 helps control when and if that special screen appears for users that
25360 have previously run Alpine.  It takes as its value an Alpine version
25361 number.  Alpine versions less than the specified value will supress this
25362 special screen while versions equal to or greater than that specified
25363 will behave normally.
25364 <P>
25365 <UL>
25366 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25367 </UL><P>
25368 &lt;End of help on this topic&gt;
25369 </BODY>
25370 </HTML>
25371 ====== h_config_disable_drivers =====
25372 <HTML>
25373 <HEAD>
25374 <TITLE>OPTION: <!--#echo var="VAR_disable-these-drivers"--></TITLE>
25375 </HEAD>
25376 <BODY>
25377 <H1>OPTION: <!--#echo var="VAR_disable-these-drivers"--></H1>
25378
25379 This variable is a list of mail drivers that will be disabled.
25380 The candidates for disabling are listed below.
25381 There may be more in the future if you compile Alpine with
25382 a newer version of the c-client library.
25383 <P>
25384
25385 <UL>
25386 <LI> mbox
25387 <LI> mbx
25388 <LI> mh
25389 <LI> mmdf
25390 <LI> mtx
25391 <LI> mx
25392 <LI> news
25393 <LI> phile
25394 <LI> tenex
25395 <LI> unix
25396 </UL>
25397 <P>
25398
25399 The <EM>mbox</EM> driver enables the following behavior: if there is a
25400 file called <CODE>mbox</CODE>
25401 in your home directory, and if that file is either empty or in Unix mailbox
25402 format, then every time you open <EM>INBOX</EM> the <EM>mbox</EM> driver
25403 will automatically transfer mail from the system mail spool directory into the
25404 <CODE>mbox</CODE> file and
25405 delete it from the spool directory. If you disable the <EM>mbox</EM> driver,
25406 this will not happen.
25407 <P>
25408
25409 It is not recommended to disable the driver that supports the system default
25410 mailbox format. On most non-SCO systems, that driver is the
25411 <EM>unix</EM> driver.
25412 On most SCO systems, it is the <EM>mmdf</EM> driver.
25413 The system default driver may be
25414 configured to something else on your system; check with your system manager
25415 for additional information.
25416 <P>
25417
25418 It is most likely not very useful for you to disable any of the drivers other
25419 than possibly <EM>mbox</EM>.
25420 You could disable some of the others if you know for
25421 certain that you don't need them but the performance gain in doing so
25422 is very modest.
25423 <P>
25424 <UL>
25425 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25426 </UL><P>
25427 &lt;End of help on this topic&gt;
25428 </BODY>
25429 </HTML>
25430 ====== h_config_disable_auths =====
25431 <HTML>
25432 <HEAD>
25433 <TITLE>OPTION: <!--#echo var="VAR_disable-these-authenticators"--></TITLE>
25434 </HEAD>
25435 <BODY>
25436 <H1>OPTION: <!--#echo var="VAR_disable-these-authenticators"--></H1>
25437
25438 This variable is a list of SASL (Simple Authentication and Security
25439 Layer) authenticators that will be disabled.
25440 SASL is a mechanism for
25441 authenticating to IMAP, POP3, SMTP, and other network servers.
25442 <P>
25443
25444 Alpine matches its list of supported authenticators with the server to
25445 determine the most secure authenticator that is supported by both.
25446 If no matching authenticators are found, Alpine will revert to plaintext
25447 login (or, in the case of SMTP, will be unable to authenticate at all).
25448 <P>
25449 The candidates for disabling can be found <A HREF="X-Alpine-Config:">here</A>.
25450 <P>
25451
25452 Normally, you will not disable any authenticators.
25453 There are two exceptions:
25454 <P>
25455 <OL>
25456 <LI> You use a broken server that advertises an authenticator,
25457 but does not actually implement it.
25458 <LI> You have a Kerberos-capable version of Alpine and the server is
25459 also Kerberos-capable, but you can not obtain Kerberos
25460 credentials on the server machine, thus you desire to disable
25461 GSSAPI (which in turn disables Alpine's Kerberos support).
25462 </OL>
25463 <P>
25464 It is never necessary to disable authenticators, since Alpine will try
25465 other authenticators before giving up.
25466 However, disabling the relevant authenticator avoids annoying error messages.
25467 <P>
25468 <UL>
25469 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25470 </UL><P>
25471 &lt;End of help on this topic&gt;
25472 </BODY>
25473 </HTML>
25474 ====== h_config_abook_metafile =====
25475 <HTML>
25476 <HEAD>
25477 <TITLE>OPTION: <!--#echo var="VAR_remote-abook-metafile"--></TITLE>
25478 </HEAD>
25479 <BODY>
25480 <H1>OPTION: <!--#echo var="VAR_remote-abook-metafile"--></H1>
25481
25482 This is usually set by Alpine and is the name of a file
25483 that contains data about
25484 remote address books and remote configuration files.
25485 <P>
25486 <UL>
25487 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25488 </UL><P>
25489 &lt;End of help on this topic&gt;
25490 </BODY>
25491 </HTML>
25492 ====== h_config_composer_wrap_column =====
25493 <HTML>
25494 <HEAD>
25495 <TITLE>OPTION: <!--#echo var="VAR_composer-wrap-column"--></TITLE>
25496 </HEAD>
25497 <BODY>
25498 <H1>OPTION: <!--#echo var="VAR_composer-wrap-column"--></H1>
25499
25500
25501 This option specifies an aspect of Alpine's Composer.  This gives the
25502 maximum width that auto-wrapped lines will have.  It's also the maximum
25503 width of lines justified using the <A HREF="h_compose_justify">^J
25504 Justify</A> command.  The normal default
25505 is &quot;74&quot;.  The largest allowed setting is normally &quot;80&quot;
25506 in order to
25507 prevent very long lines from being sent in outgoing mail.  When the mail
25508 is actually sent, trailing spaces will be stripped off of each line.
25509
25510 <P>
25511 <UL>
25512 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25513 </UL><P>
25514 &lt;End of help on this topic&gt;
25515 </BODY>
25516 </HTML>
25517 ====== h_config_deadlets =====
25518 <HTML>
25519 <HEAD>
25520 <TITLE>OPTION: <!--#echo var="VAR_dead-letter-files"--></TITLE>
25521 </HEAD>
25522 <BODY>
25523 <H1>OPTION: <!--#echo var="VAR_dead-letter-files"--></H1>
25524
25525
25526 This option affects Alpine's behavior when you cancel a message being
25527 composed.  Alpine's usual behavior is to write the canceled message to
25528 a file named
25529 <!--chtml if pinemode="os_windows"-->
25530 &quot;DEADLETR&quot;,
25531 <!--chtml else-->
25532 &quot;dead.letter&quot; in your home directory,
25533 <!--chtml endif-->
25534 overwriting any previous message.
25535 <P>
25536 If you set this option to a value higher than one, then that many copies
25537 of dead letter files will be saved.
25538 For example, if you set this option to &quot;3&quot; then you may have
25539 files named
25540 <!--chtml if pinemode="os_windows"-->
25541 &quot;DEADLETR&quot;,
25542 &quot;DEADLETR2&quot;, and
25543 &quot;DEADLETR3&quot;.
25544 <!--chtml else-->
25545 &quot;dead.letter&quot;,
25546 &quot;dead.letter2&quot;, and
25547 &quot;dead.letter3&quot; in your home directory.
25548 <!--chtml endif-->
25549 In this example, the most recently cancelled message will be in
25550 <!--chtml if pinemode="os_windows"-->
25551 &quot;DEADLETR&quot;,
25552 <!--chtml else-->
25553 &quot;dead.letter&quot;,
25554 <!--chtml endif-->
25555 and the third most recently cancelled message will be in
25556 <!--chtml if pinemode="os_windows"-->
25557 &quot;DEADLETR3&quot;.
25558 <!--chtml else-->
25559 &quot;dead.letter3&quot;.
25560 <!--chtml endif-->
25561 The fourth most recently cancelled message will no longer be saved.
25562
25563 <P>
25564 If you set this option to zero, then NO record of canceled messages is
25565 maintained.
25566 <P>
25567 If the feature
25568 <A HREF="h_config_quell_dead_letter"><!--#echo var="FEAT_quell-dead-letter-on-cancel"--></A>
25569 is set, that overrides whatever you set for this option.
25570 If this option had existed at the time, then the Quell feature would not
25571 have been added, but it is still there for backwards compatibility.
25572 So, in order for this option to have the desired effect, make sure the
25573 Quell feature is turned off.
25574
25575 <P>
25576 <UL>
25577 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25578 </UL><P>
25579 &lt;End of help on this topic&gt;
25580 </BODY>
25581 </HTML>
25582 ====== h_config_maxremstream =====
25583 <HTML>
25584 <HEAD>
25585 <TITLE>OPTION: <!--#echo var="VAR_max-remote-connections"--></TITLE>
25586 </HEAD>
25587 <BODY>
25588 <H1>OPTION: <!--#echo var="VAR_max-remote-connections"--></H1>
25589
25590 This option affects low-level behavior of Alpine.
25591 The default value for this option is <EM>3</EM>.
25592 If your INBOX is accessed using the IMAP protocol
25593 from an IMAP server, that connection is kept open throughout the
25594 duration of your Alpine session, independent of the value of this option.
25595 The same is true of any
25596 <A HREF="h_config_permlocked">&quot;<!--#echo var="VAR_stay-open-folders"-->&quot;</A>
25597 you have defined.
25598 This option controls Alpine's behavior when connecting to remote IMAP folders
25599 other than your INBOX or your <!--#echo var="VAR_stay-open-folders"-->.
25600 It specifies the maximum number of remote IMAP connections (other than
25601 those mentioned above) that Alpine will use for accessing the rest of your
25602 folders.
25603 If you set this option to zero, you will turn off most remote connection
25604 re-use.
25605 It's difficult to understand exactly what this option does, and it is usually
25606 fine to leave it set to its default value.
25607 It is probably more likely that you will be interested in setting the
25608 <A HREF="h_config_permlocked">&quot;<!--#echo var="VAR_stay-open-folders"-->&quot;</A> option
25609 instead of changing the value of this option.
25610 A slightly longer explanation of what is going on with this option
25611 is given in the next paragraphs.
25612
25613 <P>
25614 There are some time costs involved in opening and closing remote IMAP
25615 folders, the main costs being the time you have to wait for the connection
25616 to the server and the time for the folder to open.
25617 Opening a folder may involve not only the time the server takes to do its
25618 processing but time that Alpine uses to do filtering.
25619 These times can vary widely.
25620 They depend on how loaded the server is, how large
25621 the folder being opened is, and how you set up filtering, among other things.
25622 Once Alpine has opened a connection to a particular folder, it will attempt
25623 to keep that connection open in case you use it again.
25624 In order to do this,
25625 Alpine will attempt to use the <!--#echo var="VAR_max-remote-connections"--> (the value of
25626 this option) IMAP connections you have alloted for this purpose.
25627 <P>
25628 For example, suppose the value of this option is set to &quot;2&quot;.
25629 If your INBOX is accessed on a remote server using the IMAP protocol, that
25630 doesn't count as one of the remote connections but it is always kept open.
25631 If you then open another IMAP folder, that would be your first
25632 remote connection counted as one of the <!--#echo var="VAR_max-remote-connections"--> connections.
25633 If you open a third folder the second will be left open, in case you
25634 return to it.
25635 You won't be able to tell it has been left open.
25636 It will appear to be closed when you leave the folder but the connection
25637 will remain in the background.
25638 Now suppose you go back to the second folder (the first folder after the
25639 INBOX).
25640 A connection to that folder is still open so you won't have to wait
25641 for the startup time to open it.
25642 Meanwhile, the connection to the third folder will be left behind.
25643 Now, if you open a fourth folder, you will bump into the
25644 <!--#echo var="VAR_max-remote-connections"--> limit, because this will be the third folder other
25645 than INBOX and you have the option set to &quot;2&quot;.
25646 The connection that is being used for
25647 the third folder will be re-used for this new fourth folder.
25648 If you go back to the third folder after this, it is no longer already
25649 connected when you get there.
25650 You'll still save some time since Alpine will re-use the connection to the
25651 fourth folder and you have already logged in on that connection,
25652 but the folder will have to be re-opened from scratch.
25653 <P>
25654 If a folder is large and the startup cost is dominated by the time it takes
25655 to open that folder or to run filters on it, then it will pay to make the
25656 value of this option large enough to keep it open.
25657 On the other hand, if you only revisit a handful of folders or if
25658 the folders are small, then it might
25659 make more sense to keep this number small so that the reconnect
25660 time (the time to start up a new connection and authenticate)
25661 is eliminated instead.
25662 <P>
25663 You may also need to consider the impact on the server.
25664 On the surface, a larger number here may cause a larger impact on the
25665 server, since you will have more connections open to the server.
25666 On the other hand, not only will <EM>you</EM> be avoiding the startup costs
25667 associated with reopening a folder, but the <EM>server</EM> will be
25668 avoiding those costs as well.
25669 <P>
25670 When twenty five minutes pass without any active use of an IMAP connection
25671 being saved for possible re-use, that connection will be shut down,
25672
25673 <P>
25674 <UL>
25675 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25676 </UL><P>
25677 &lt;End of help on this topic&gt;
25678 </BODY>
25679 </HTML>
25680 ====== h_config_permlocked =====
25681 <HTML>
25682 <HEAD>
25683 <TITLE>OPTION: <!--#echo var="VAR_stay-open-folders"--></TITLE>
25684 </HEAD>
25685 <BODY>
25686 <H1>OPTION: <!--#echo var="VAR_stay-open-folders"--></H1>
25687
25688 This option affects low-level behavior of Alpine.
25689 There is no default value for this option.
25690 It is related to the options
25691 <A HREF="h_config_preopen_stayopens">&quot;<!--#echo var="FEAT_preopen-stayopen-folders"-->&quot;</A>,
25692 <A HREF="h_config_maxremstream">&quot;<!--#echo var="VAR_max-remote-connections"-->&quot;</A>,
25693 and <A HREF="h_config_expunge_stayopens">&quot;<!--#echo var="FEAT_offer-expunge-of-stayopen-folders"-->&quot;</A>.
25694
25695 <P>
25696 Note: changes made to this list take effect the next time you open a
25697 folder in the list.
25698
25699 <P>
25700 This is a list of folders that will be permanently kept open once they
25701 are first opened.
25702 The names in this list may be either the nickname of an Incoming folder
25703 or the full technical specification of a folder.
25704 The folders in this list need not be remote IMAP folders, they could usefully
25705 be local folders, as well.
25706 If a folder in the list is a newsgroup or is not accessed either locally
25707 or via IMAP, then the entry will be ignored.
25708 For example, folders accessed via NNTP or POP3 will not be kept open, since
25709 the way that new mail is found with those protocols involves closing and
25710 reopening the connection.
25711 <P>
25712 Once a Stay Open folder has been opened, new-mail checking will continue
25713 to happen on that folder for the rest of the Alpine session.
25714 Your INBOX is always implicitly included in this Stay-Open list and doesn't
25715 need to be added explicitly.
25716 <P>
25717 Another difference that you may notice between a Stay Open folder and a
25718 non-Stay Open folder is which message is selected as the current message
25719 when you enter the folder index.
25720 Normally, the starting position for an incoming folder (which most Stay Open
25721 folders will likely be) is controlled by the
25722 <A HREF="h_config_inc_startup"><!--#echo var="VAR_incoming-startup-rule"--></A>.
25723 However, if a folder is a Stay Open folder, when you re-enter the folder
25724 after the first time the current message will be the same as it was when
25725 you left the folder.
25726 An exception is made if you use the TAB command to get to the folder.
25727 In that case, the message number will be incremented by one from what it
25728 was when you left the folder.
25729 <P>
25730 The above special behavior is thought to be useful.
25731 However, it is special and different from what you might at first expect.
25732 The feature
25733 <A HREF="h_config_use_reg_start_for_stayopen"><!--#echo var="FEAT_use-regular-startup-rule-for-stayopen-folders"--></A>
25734 may be used to turn off this special treatment.
25735 <P>
25736 If the message that was current when you left the folder no longer exists,
25737 then the regular startup rule will be used instead.
25738
25739 <P>
25740 <UL>
25741 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25742 </UL><P>
25743 &lt;End of help on this topic&gt;
25744 </BODY>
25745 </HTML>
25746 ====== h_config_viewer_overlap =====
25747 <html>
25748 <header>
25749 <title>OPTION: <!--#echo var="VAR_viewer-overlap"--></title>
25750 </header>
25751 <body>
25752 <h1>OPTION: <!--#echo var="VAR_viewer-overlap"--></h1>
25753
25754 This option specifies an aspect of Alpine's Message Viewing screen.  When
25755 the space bar is used to page forward in a message, the number of lines
25756 specified by the &quot;<!--#echo var="VAR_viewer-overlap"-->&quot; variable will be repeated from the
25757 bottom of the screen.  That is, if this was set to two lines, then the
25758 bottom two lines of the screen would be repeated on the top of the next
25759 screen.  The normal default value is "2".<p>
25760 <UL>
25761 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25762 </UL><P>
25763 &lt;End of help on this topic&gt;
25764 </body>
25765 </html>
25766 ====== h_config_scroll_margin =====
25767 <HTML>
25768 <HEAD>
25769 <TITLE>OPTION: <!--#echo var="VAR_scroll-margin"--></TITLE>
25770 </HEAD>
25771 <BODY>
25772 <H1>OPTION: <!--#echo var="VAR_scroll-margin"--></H1>
25773
25774 This option controls when Alpine's line-by-line scrolling occurs.
25775 Typically, when a selected item is at the top or bottom screen edge
25776 and the UP or DOWN (and Ctrl-P or Ctrl-N) keys are struck, the
25777 displayed items are scrolled down or up by a single line.
25778
25779 <P>
25780 This option allows you to tell Alpine the number of lines from the top and
25781 bottom screen edge that line-by-line paging should occcur.  For example,
25782 setting this value to one (1) will cause Alpine to scroll the display
25783 vertically when you move to select an item on the display's top or
25784 bottom edge.
25785
25786 <P>
25787 By default, this variable is zero, indicating that scrolling happens
25788 when you move up or down to select an item immediately off the display's
25789 top or bottom edge.
25790
25791 <P>
25792 <UL>
25793 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25794 </UL><P>
25795 &lt;End of help on this topic&gt;
25796 </BODY>
25797 </HTML>
25798 ====== h_config_wordseps =====
25799 <HTML>
25800 <HEAD>
25801 <TITLE>OPTION: <!--#echo var="VAR_composer-word-separators"--></TITLE>
25802 </HEAD>
25803 <BODY>
25804 <H1>OPTION: <!--#echo var="VAR_composer-word-separators"--></H1>
25805
25806 This option affects how a &quot;word&quot; is defined in the composer.
25807 The definition of a word is used when using the Forward Word and Backward
25808 Word commands in the composer, as well as when using the spell checker.
25809 Whitespace is always considered a word separator.
25810 Punctuation (like question marks, periods, commas, and so on) is always
25811 a word separator if it comes at the end of a word.
25812 By default, a punctuation character that is in the middle of a word does
25813 not break up that word as long as the character before and the character
25814 after it are both alphanumeric.
25815 If you add a character to this option it will be considered a
25816 word separator even when it occurs in the middle of an alphanumeric word.
25817 For example, if you want to skip through each part of an address instead
25818 of skipping the whole address at once you might want to include &quot;@&quot;
25819 and &quot;.&quot; in this list.
25820 If you want the word-skipper to stop on each part of a UNIX filename you
25821 could add &quot;/&quot; to the list.
25822 The equal sign and dash are other possibilities you might find helpful.
25823 <P>
25824 <UL>
25825 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25826 </UL><P>
25827 &lt;End of help on this topic&gt;
25828 </BODY>
25829 </HTML>
25830 ====== h_config_reply_indent_string =====
25831 <HTML>
25832 <HEAD>
25833 <TITLE>OPTION: <!--#echo var="VAR_reply-indent-string"--></TITLE>
25834 </HEAD>
25835 <BODY>
25836 <H1>OPTION: <!--#echo var="VAR_reply-indent-string"--></H1>
25837
25838 This option specifies an aspect of Alpine's Reply command.
25839 When a message is replied to and the text of the message is included, the
25840 included text usually has the string &quot;&gt;&nbsp;&quot; prepended
25841 to each line indicating it is quoted text.
25842 (In case you haven't seen this before, &quot;string&quot; is a technical term
25843 that means chunk of text.)
25844
25845 <P>
25846 Because of the introduction of <A HREF="h_config_quell_flowed_text">Flowed Text</A>
25847 in 1999 and its wide-spread adoption since then, you will usually be better off if you
25848 use one of the standard values,
25849 &quot;&gt;&nbsp;&quot; or &quot;&gt;&quot;, for this option.
25850
25851 <P>
25852 This option specifies a different value for that string.
25853 If you wish to use a string that begins or ends with a space,
25854 enclose the string in double quotes.
25855
25856 <P>
25857 Besides simple text, the prepended string can be based
25858 on the message being replied to.
25859 The following tokens are substituted for the message's corresponding value:
25860
25861 <DL>
25862 <DT>_FROM_</DT>
25863 <DD>This token gets replaced with the message sender's &quot;username&quot;.
25864 If the name is longer than six characters, only the first six characters are
25865 used.
25866 </DD>
25867
25868 <DT>_NICK_</DT>
25869 <DD>This token gets replaced with the nickname of the message sender's
25870 address as found in your addressbook.
25871 If no addressbook entry is found,
25872 Alpine replaces the characters &quot;_NICK_&quot; with nothing.
25873 If the nickname is longer than six characters, only the first six characters are
25874 used.
25875 </DD>
25876
25877 <DT>_INIT_</DT>
25878 <DD>This token gets replaced with the initials of the sender of the message.
25879 </DD>
25880
25881 </DL>
25882
25883 NOTE: When the
25884 <A HREF="h_config_prefix_editing">&quot;<!--#echo var="FEAT_enable-reply-indent-string-editing"-->&quot;</A>
25885 feature is enabled, you are given the opportunity to edit the string, whether
25886 it is the default or one automatically generated using the above tokens.
25887 <P>
25888 If you change your <!--#echo var="VAR_reply-indent-string"-->
25889 so that it is not equal to the default value of &quot;&gt;&nbsp;&quot;, then
25890 quoted text will not be flowed
25891 (<A HREF="h_config_quell_flowed_text">Flowed Text</A>)
25892 when you reply.
25893 For this reason, we recommend that you leave your <!--#echo var="VAR_reply-indent-string"-->
25894 set to the default value.
25895 <P>
25896 <UL>
25897 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25898 </UL><P>
25899 &lt;End of help on this topic&gt;
25900 </BODY>
25901 </HTML>
25902 ====== h_config_quote_replace_string =====
25903 <HTML>
25904 <HEAD>
25905 <TITLE>OPTION: <!--#echo var="VAR_quote-replace-string"--></TITLE>
25906 </HEAD>
25907 <BODY>
25908 <H1>OPTION: <!--#echo var="VAR_quote-replace-string"--></H1>
25909
25910 This option specifies what string to use as a quote when <b>viewing</b> a
25911 message.  The standard way of quoting messages when replying is the string
25912 &quot;&gt;&nbsp;&quot; (quote space).
25913 With this variable set, viewing a message will
25914 replace occurrences of
25915 &quot;&gt;&nbsp;&quot; and &quot;&gt;&quot; with the replacement string.
25916 This setting works best when
25917 <A HREF="h_config_reply_indent_string"><!--#echo var="VAR_reply-indent-string"--></A>
25918 or the equivalent setting in your correspondents' mail programs
25919 is set to the default
25920 &quot;&gt;&nbsp;&quot;, but it will also work fine with the
25921 <!--#echo var="VAR_reply-indent-string"--> set to &quot;&gt;&quot;.
25922 <P>
25923 By default, this setting will only work on messages that are flowed, which is
25924 the default way of sending messages for many mail clients including
25925 Alpine.  Enable the feature
25926 <A HREF="h_config_quote_replace_noflow"><!--#echo var="FEAT_quote-replace-nonflowed"--></A>
25927 to also have quote-replacement performed on non-flowed messages.
25928 <P>
25929
25930 Setting this option will replace  &quot;&gt;&quot; and
25931 &quot;&gt;&nbsp;&quot; with the new setting. This string may include trailing
25932 spaces. To preserve those spaces enclose the full string in double quotes.
25933 <P>
25934 No padding to separate the text of the message from the quote string is
25935 added. This means that if you do not add trailing spaces to the value of
25936 this variable, text will be displayed right next to the quote string,
25937 which may be undesirable. This can be avoided by adding a new string
25938 separated by a space from your selection of quote string replacement. This
25939 last string will be used for padding. For example, setting this variable to
25940 <br>&quot;&gt;&quot; &quot; &quot; has the effect of setting
25941 &quot;&gt;&quot; as the <!--#echo var="VAR_quote-replace-string"-->, with the text padded by
25942 a space from the last quote string to make it more readable.
25943 <P>
25944 One possible setting for this variable could be
25945 &quot;&nbsp;&nbsp;&nbsp;&nbsp;&quot; (four spaces wrapped in quotes), which
25946 would have the effect of indenting each level of quoting four spaces and
25947 removing the &quot;&gt;&quot;'s.  Different levels of quoting could be made
25948 more discernible by setting colors for quoted text.
25949 <P>
25950 Replying to or forwarding the viewed message will preserve the original
25951 formatting of the message, so quote-replacement will not be performed on
25952 messages that are being composed.
25953 <P>
25954 <UL>
25955 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25956 </UL><P>
25957 &lt;End of help on this topic&gt;
25958 </BODY>
25959 </HTML>
25960 ====== h_config_empty_hdr_msg =====
25961 <HTML>
25962 <HEAD>
25963 <TITLE>OPTION: <!--#echo var="VAR_empty-header-message"--></TITLE>
25964 </HEAD>
25965 <BODY>
25966 <H1>OPTION: <!--#echo var="VAR_empty-header-message"--></H1>
25967
25968 When sending, if both the To and Cc fields are empty and you
25969 are sending the message to a Bcc,
25970 Alpine will put a special address in the To line.  The default value is:
25971
25972 <P>
25973 <CENTER><SAMP>undisclosed-recipients:&nbsp;;</SAMP></CENTER>
25974
25975 <P>
25976 The reason for this is to avoid embarrassment caused by some Internet
25977 mail transfer software that interprets a &quot;missing&quot;
25978 <SAMP>To:</SAMP> header as an error and replaces it with an
25979 <SAMP>Apparently-to:</SAMP> header that may contain the addresses you
25980 entered on the <SAMP>Bcc:</SAMP> line, defeating the purpose of the
25981 Bcc.  You may change the part of this message that comes before the
25982 &quot;:&nbsp;;&quot; by setting the &quot;<!--#echo var="VAR_empty-header-message"-->&quot;
25983 variable to something else.
25984
25985 <P>
25986 The normal default is &quot;undisclosed-recipients&quot;.
25987
25988 <P>
25989 <UL>
25990 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25991 </UL><P>
25992 &lt;End of help on this topic&gt;
25993 </BODY>
25994 </HTML>
25995 ====== h_config_status_msg_delay =====
25996 <HTML>
25997 <HEAD>
25998 <TITLE>OPTION: <!--#echo var="VAR_status-message-delay"--></TITLE>
25999 </HEAD>
26000 <BODY>
26001 <H1>OPTION: <!--#echo var="VAR_status-message-delay"--></H1>
26002
26003 This option has evolved over time, causing the possible values to be
26004 counter-intuitive.
26005 Read carefully before you set this option.
26006 First we explain what the option does, then there is a longer discussion
26007 following that.
26008 <P>
26009 If this is set to zero, the default value, it has <EM>no</EM> effect.
26010 Positive and negative values serve two similar, but different purposes.
26011 <P>
26012 If it is set to a positive number, it causes the cursor to move to the
26013 status line whenever a status message is printed and pause there for this
26014 many seconds.
26015 It will probably only be useful if the
26016 <A HREF="h_config_show_cursor">&quot;<!--#echo var="FEAT_show-cursor"-->&quot;</A> feature is
26017 also turned on.
26018 Setting this option to a positive number can only be used to
26019 <EM>increase</EM> the status message delay.
26020 This may be useful for Braille displays, or other non-traditional displays.
26021 <P>
26022 If it is set to a negative number the interpretation is a bit complicated.
26023 Negative numbers are used to <EM>decrease</EM> the amount of delay Alpine uses to
26024 allow you to read important status messages.
26025 Of course, this may cause you to miss some important messages.
26026 If you see a message flash by but miss what it says you can use the
26027 Journal command from the MAIN MENU to read it.
26028 If you set this option to a negative value, the delay will be
26029 no more than one second less than the absolute value
26030 of the value you set.
26031 So if you set it to -1, the delay will be no more than zero seconds, no
26032 delay at all.
26033 If you set it to -2, the delay will be no more than 1 second.
26034 And so on, -3 is 2 seconds, -4 is 3 seconds, ...
26035 If the delay that Alpine would have used by default is less than this delay,
26036 then the smaller delay set by Alpine will be used.
26037 Setting this option to a negative value can only reduce the amount of
26038 delay, never increase it.
26039 <P>
26040 Here is a more detailed explanation.
26041 Status messages are the messages that show up spontaneously in the
26042 status message line, usually the third line from the bottom of the screen.
26043 By default, Alpine assigns each status message it produces a minimum
26044 display time.
26045 Some status messages have a minimum display time of zero.
26046 You can see an example of such a message by paging up in this help text
26047 until you reach the top of the screen.
26048 If you try to page past the top you will see the message
26049 <P>
26050 <CENTER><SAMP>[Already at start of help text]</SAMP></CENTER>
26051 <P>
26052 in the status line.
26053 If there is another more important use of the status message line this message
26054 might be replaced quickly, or it even might not be shown at all.
26055 However, if there is no reason to get rid of the message, it might stay
26056 there for several seconds while you read the help.
26057 An example where it is replaced immediately happens when you page up in
26058 the help text past the top of the screen, but then type the &quot;WhereIs&quot;
26059 command right after paging up.
26060 The message will disappear immediately without causing a delay (unless you
26061 have set this option to a positive value) to allow you to type input for
26062 the &quot;WhereIs&quot; command.
26063 Since it isn't a very important message, Alpine has set its minimum display
26064 time to zero seconds.
26065 <P>
26066 Other messages have minimum display times of three or more seconds.
26067 These are usually error messages that Alpine thinks you ought to see.
26068 For example, it might be a message about a failed Save or a failed folder open.
26069 It is often the case that this minimum display time won't delay you in
26070 any way because the status message line is not needed for another reason.
26071 However, there are times when Alpine has to delay what it is doing in
26072 order to display a status message for the minimum display time.
26073 This happens when a message is being displayed and Alpine wants to ask
26074 for input from the keyboard.
26075 For example, when you Save a message you use the status message line.
26076 You get a prompt there asking for the name of the folder to save to.
26077 If there is a status message being displayed that has not
26078 yet displayed for its minimum
26079 time Alpine will display that status message surrounded with the characters
26080 &gt; and &lt; to show you that it is delaying.
26081 That might happen, for example, if you tried to save to a folder that
26082 caused an error, then followed that immediately with another Save command.
26083 You might find yourself waiting for a status message like
26084 <P>
26085 <CENTER><SAMP>[&gt;Can't get write access to mailbox, access is readonly&lt;]</SAMP></CENTER>
26086 <P>
26087 to finish displaying for three seconds.
26088 If that is something you find happening to you frequently, you may use
26089 negative values of this option to decrease or eliminate that delay, at
26090 the risk of missing the message.
26091 <P>
26092 <UL>
26093 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26094 </UL><P>
26095 &lt;End of help on this topic&gt;
26096 </BODY>
26097 </HTML>
26098 ====== h_config_active_msg_interval =====
26099 <HTML>
26100 <HEAD>
26101 <TITLE>OPTION: <!--#echo var="VAR_busy-cue-rate"--></TITLE>
26102 </HEAD>
26103 <BODY>
26104 <H1>OPTION: <!--#echo var="VAR_busy-cue-rate"--></H1>
26105
26106 When Alpine is delayed for some reason it usually shows that
26107 something is happening with a small animated display in the status
26108 message line near the bottom of the screen.
26109 This option sets how frequently the characters (for example, a spinning bar)
26110 in the active status message lines are updated.
26111 At most, it can be set to be udpated 20 times per second.
26112
26113 <P>
26114 Setting this value to zero will prevent display of the animations
26115 altogether.
26116
26117 <P>
26118 The option <A HREF="h_config_use_boring_spinner"><!--#echo var="FEAT_busy-cue-spinner-only"--></A>
26119 can be used to remove the randomness from this animated display.
26120
26121 <P>
26122 <UL>
26123 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26124 </UL><P>
26125 &lt;End of help on this topic&gt;
26126 </BODY>
26127 </HTML>
26128 ====== h_config_mailchecknoncurr =====
26129 <HTML>
26130 <HEADER>
26131 <TITLE>OPTION: <!--#echo var="VAR_mail-check-interval-noncurrent"--></TITLE>
26132 </HEADER>
26133 <BODY>
26134 <H1>OPTION: <!--#echo var="VAR_mail-check-interval-noncurrent"--></H1>
26135
26136 This option is closely related to the
26137 <A HREF="h_config_mailcheck">&quot;<!--#echo var="VAR_mail-check-interval"-->&quot;</A>
26138 option, as well as the
26139 <A HREF="h_config_quell_checks_comp">&quot;<!--#echo var="FEAT_quell-mailchecks-composing-except-inbox"-->&quot;</A> and
26140 <A HREF="h_config_quell_checks_comp_inbox">&quot;<!--#echo var="FEAT_quell-mailchecks-composing-inbox"-->&quot;</A> options.
26141 If the &quot;<!--#echo var="VAR_mail-check-interval"-->&quot; option is set to zero, then automatic
26142 new-mail checking is disabled and this option will have no effect.
26143 <P>
26144 Normally this option is set to zero, which means that the value used will be
26145 the same as the value for the &quot;<!--#echo var="VAR_mail-check-interval"-->&quot;.
26146 If you set this option to a value different from zero
26147 (usually larger than the value for &quot;<!--#echo var="VAR_mail-check-interval"-->&quot;)
26148 then that is the check interval that will be used
26149 for folders that are not the currently open folder or the INBOX.
26150 You may not even have any folders that are noncurrent and not the INBOX.
26151 If you do, it is likely that they are due to
26152 <A HREF="h_config_permlocked">&quot;<!--#echo var="VAR_stay-open-folders"-->&quot;</A>
26153 you have configured.
26154 This option also affects the rate of mail checking done on cached
26155 connections to folders you previously had open but are no longer actively
26156 using.
26157 You aren't expected to understand that last sentence, but if you are interested
26158 take a look at
26159 <A HREF="h_config_maxremstream">&quot;<!--#echo var="VAR_max-remote-connections"-->&quot;</A>
26160 and the related options.
26161 <P>
26162 <UL>
26163 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26164 </UL><P>
26165 &lt;End of help on this topic&gt;
26166 </BODY>
26167 </HTML>
26168 ====== h_config_fifopath =====
26169 <HTML>
26170 <HEADER>
26171 <TITLE>OPTION: NewMail FIFO Path</TITLE>
26172 </HEADER>
26173 <BODY>
26174 <H1>OPTION: NewMail FIFO Path</H1>
26175
26176 This option is only available in UNIX Alpine.
26177 However, there is a very similar feature built in to PC-Alpine.
26178 In PC-Alpine's Config menu at the top of the screen
26179 is an option called &quot;New Mail Window&quot;.
26180 <P>
26181 You may have Alpine create a FIFO special file (also called a named pipe) where
26182 it will send a one-line message each time a new message is received in
26183 the current folder, the INBOX, or any open
26184 <A HREF="h_config_permlocked"><!--#echo var="VAR_stay-open-folders"--></A>.
26185 To protect against two different Alpines both writing to the same FIFO, Alpine
26186 will only create the FIFO and write to it if it doesn't already exist.
26187 <P>
26188 A possible way to use this option would be to have a separate window
26189 on your screen running the command
26190 <P>
26191 <CENTER><SAMP>cat filename</SAMP></CENTER>
26192 <P>
26193 where &quot;filename&quot; is the name of the file given for this option.
26194 Because the file won't exist until after you start Alpine, you must <EM>first</EM>
26195 start Alpine and <EM>then</EM> run the &quot;cat&quot; command.
26196 You may be tempted to use &quot;tail -f filename&quot; to view the new
26197 mail log.
26198 However, the common implementations of the tail command will not do what you
26199 are hoping.
26200 <P>
26201 The width of the messages produced for the FIFO may be altered with the
26202 <A HREF="h_config_newmailwidth"><!--#echo var="VAR_newmail-window-width"--></A> option.
26203 <P>
26204 On some systems, fifos may only be created in a local filesystem.
26205 In other words, they may not be in NFS filesystems.
26206 This requirement is not universal.
26207 If the system you are using supports it, it should work.
26208 (It is often the case that your home directory is in an NFS filesystem.
26209 If that is the case, you might try using a file in the &quot;/tmp&quot;
26210 filesystem, which is usually a local filesytem.)
26211 Even when it is possible to use an NFS-mounted filesystem as a place to name
26212 the fifo (for example, your home directory), it will still be the case that
26213 the reader (probably the &quot;cat&quot; command) and the
26214 writer (Alpine) of the fifo must be running on the same system.
26215 <P>
26216 <UL>
26217 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26218 </UL><P>
26219 &lt;End of help on this topic&gt;
26220 </BODY>
26221 </HTML>
26222 ====== h_config_newmailwidth =====
26223 <HTML>
26224 <HEADER>
26225 <TITLE>OPTION: <!--#echo var="VAR_newmail-window-width"--></TITLE>
26226 </HEADER>
26227 <BODY>
26228 <H1>OPTION: <!--#echo var="VAR_newmail-window-width"--></H1>
26229
26230 For UNIX Alpine, this option is only useful if you have turned on the
26231 <A HREF="h_config_fifopath">NewMail FIFO Path</A> option.
26232 That option causes new mail messages to be sent to a fifo file.
26233 Those messages will be 80 characters wide by default.
26234 You can change the width of those messages by changing this option.
26235 For example, if you are reading those messages in another window you might
26236 want to set this width to the width of that other window.
26237 <P>
26238 If you are using PC-Alpine, it has an option in the Config menu to turn
26239 on the &quot;New Mail Window&quot;.
26240 This present option also controls the width of that window.
26241 <P>
26242 <UL>
26243 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26244 </UL><P>
26245 &lt;End of help on this topic&gt;
26246 </BODY>
26247 </HTML>
26248 ====== h_config_mailcheck =====
26249 <HTML>
26250 <HEADER>
26251 <TITLE>OPTION: <!--#echo var="VAR_mail-check-interval"--></TITLE>
26252 </HEADER>
26253 <BODY>
26254 <H1>OPTION: <!--#echo var="VAR_mail-check-interval"--></H1>
26255
26256 This option specifies, in seconds,
26257 how often Alpine will check for new mail.
26258 If set to zero, new-mail checking is disabled.
26259 (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
26260 current message is the last message of the folder.)
26261 There is a minimum value for this option, normally 15 seconds.
26262 The default value is normally 150 seconds.
26263 The higher you set this option, the easier it is on the server.
26264 <P>
26265 There are some situations where automatic new-mail checking does not work.
26266 See the discussion about new-mail checking in
26267 <A HREF="h_config_reopen_rule">&quot;<!--#echo var="VAR_folder-reopen-rule"-->&quot;</A>.
26268 <P>
26269 The new-mail checking will not happen exactly at the frequency that you specify.
26270 For example, Alpine may elect to defer a non-INBOX mail check if you
26271 are busy typing.
26272 Or, it may check more frequently than you have specified if that is
26273 thought to be necessary to keep the server from closing the connection
26274 to the folder due to inactivity.
26275 If Alpine checks for new mail as a side effect of another command, it will reset
26276 the timer, so that new-mail checking may seem to happen irregularly instead of
26277 every X seconds like clockwork.
26278 <P>
26279 If you are anxious to know about new mail as soon as possible, set the check
26280 interval low, and you'll know about the new mail by approximately
26281 that amount of time after it arrives.
26282 If you aren't so worried about knowing right away, set this option to a
26283 higher value.
26284 That will save the server some processing time and may save you some of
26285 the time you spend waiting for new-mail checks to happen if you are
26286 dealing with a slow server or slow network connection.
26287 <P>
26288 If you suspect that new-mail checking is causing slow downs for you,
26289 you may want to look into the options
26290 <A HREF="h_config_quell_checks_comp">&quot;<!--#echo var="FEAT_quell-mailchecks-composing-except-inbox"-->&quot;</A>,
26291 <A HREF="h_config_quell_checks_comp_inbox">&quot;<!--#echo var="FEAT_quell-mailchecks-composing-inbox"-->&quot;</A> and
26292 <A HREF="h_config_mailchecknoncurr">&quot;<!--#echo var="VAR_mail-check-interval-noncurrent"-->&quot;</A>,
26293 which refine when mail checking is done.
26294 <P>
26295 If the mailbox being checked uses a <A HREF="h_maildrop">Mail Drop</A> then
26296 there is a minimum time
26297 (<A HREF="h_config_maildropcheck">&quot;<!--#echo var="VAR_maildrop-check-minimum"-->&quot;</A>)
26298 between new-mail checks.
26299 Because of this minimum you may notice that new mail does not
26300 appear promptly when you expect it.
26301 The reason for this is to protect the server from over-zealous opening and
26302 closing of the Mail Drop folder, since that is a costly operation.
26303 <P>
26304 <UL>
26305 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26306 </UL><P>
26307 &lt;End of help on this topic&gt;
26308 </BODY>
26309 </HTML>
26310 ====== h_config_quell_checks_comp =====
26311 <HTML>
26312 <HEAD>
26313 <TITLE>FEATURE: <!--#echo var="FEAT_quell-mailchecks-composing-except-inbox"--></TITLE>
26314 </HEAD>
26315 <BODY>
26316 <H1>FEATURE: <!--#echo var="FEAT_quell-mailchecks-composing-except-inbox"--></H1>
26317
26318 This option is closely related to the
26319 <A HREF="h_config_mailcheck">&quot;<!--#echo var="VAR_mail-check-interval"-->&quot;</A>
26320 option, the
26321 <A HREF="h_config_mailchecknoncurr">&quot;<!--#echo var="VAR_mail-check-interval-noncurrent"-->&quot;</A> option, and
26322 <A HREF="h_config_quell_checks_comp_inbox">&quot;<!--#echo var="FEAT_quell-mailchecks-composing-inbox"-->&quot;</A>.
26323 <P>
26324 If this option is set, then the normal new-mail checking that happens
26325 while you are composing will not happen for folders other than your
26326 INBOX (which depends on the setting
26327 of &quot;<!--#echo var="FEAT_quell-mailchecks-composing-inbox"-->&quot;).
26328 <P>
26329 You might want to set this option if you are experiencing delays while
26330 composing that you think might be related to the speed of the new-mail
26331 checks.
26332 <P>
26333 Even with this option turned on, an occasional new-mail check may be done
26334 in order to keep the server from killing the connection to the folder.
26335 For example, IMAP servers may remove a connection to a folder if there
26336 has been no activity on the connection for 30 minutes or more.
26337 Instead of letting that happen, Alpine will check for new mail before the
26338 30 minutes is up even though you have turned on this feature to quell
26339 those checks.
26340 <P>
26341 Besides new-mail checks, checkpoint operations on the folders
26342 will also be quelled when you set this option.
26343 The purpose of checkpointing is to write the changes to a folder out to
26344 disk periodically in order to avoid losing those changes when system or
26345 software problems occur.
26346 New-mail checking and checkpointing while you are not composing are not
26347 affected by this option.
26348
26349 <P>
26350 &lt;End of help on this topic&gt;
26351 </BODY>
26352 </HTML>
26353 ====== h_config_quell_checks_comp_inbox =====
26354 <HTML>
26355 <HEAD>
26356 <TITLE>FEATURE: <!--#echo var="FEAT_quell-mailchecks-composing-inbox"--></TITLE>
26357 </HEAD>
26358 <BODY>
26359 <H1>FEATURE: <!--#echo var="FEAT_quell-mailchecks-composing-inbox"--></H1>
26360
26361 This option is closely related to the
26362 <A HREF="h_config_mailcheck">&quot;<!--#echo var="VAR_mail-check-interval"-->&quot;</A>
26363 option, the
26364 <A HREF="h_config_mailchecknoncurr">&quot;<!--#echo var="VAR_mail-check-interval-noncurrent"-->&quot;</A> option, and
26365 <A HREF="h_config_quell_checks_comp">&quot;<!--#echo var="FEAT_quell-mailchecks-composing-except-inbox"-->&quot;</A>.
26366 <P>
26367 If this option is set, then the normal new-mail checking that happens
26368 while you are composing will not happen for your INBOX.
26369 Checking of other folders is controlled in a similar way with the
26370 &quot;<!--#echo var="FEAT_quell-mailchecks-composing-except-inbox"-->&quot; option.
26371 <P>
26372 You might want to set this option if you are experiencing delays while
26373 composing that you think might be related to the speed of the new-mail
26374 checks.
26375 <P>
26376 Even with this option turned on, an occasional new-mail check may be done
26377 in order to keep the server from killing the connection to the folder.
26378 For example, IMAP servers may remove a connection to a folder if there
26379 has been no activity on the connection for 30 minutes or more.
26380 Instead of letting that happen, Alpine will check for new mail before the
26381 30 minutes is up even though you have turned on this feature to quell
26382 those checks.
26383 <P>
26384 Besides new-mail checks, checkpoint operations on the INBOX
26385 will also be quelled when you set this option.
26386 The purpose of checkpointing is to write the changes to a folder out to
26387 disk periodically in order to avoid losing those changes when system or
26388 software problems occur.
26389 New-mail checking and checkpointing while you are not composing are not
26390 affected by this option.
26391 <P>
26392 &lt;End of help on this topic&gt;
26393 </BODY>
26394 </HTML>
26395 ====== h_config_maildropcheck =====
26396 <HTML>
26397 <HEADER>
26398 <TITLE>OPTION: <!--#echo var="VAR_maildrop-check-minimum"--></TITLE>
26399 </HEADER>
26400 <BODY>
26401 <H1>OPTION: <!--#echo var="VAR_maildrop-check-minimum"--></H1>
26402
26403 New-mail checking for a
26404 <A HREF="h_maildrop">Mail Drop</A> is a little different from new
26405 mail checking for a regular folder.
26406 One of the differences is that the connection to the Mail Drop is not
26407 kept open and so the cost of checking
26408 (delay for you and additional load for the server) may be significant.
26409 Because of this additional cost we set a minimum time that
26410 must pass between checks.
26411 This minimum only applies to the automatic checking done by Alpine.
26412 If you force a check by typing ^L (Ctrl-L) or by typing the Next command when you are
26413 at the end of a folder index, then the check is done right away.
26414 <P>
26415 This option specifies, in seconds, the <EM>minimum</EM> time between Mail Drop
26416 new-mail checks.
26417 You may want to set this minimum high in order to avoid experiencing some
26418 of the delays associated with the checks.
26419 Note that the time between checks is still controlled by the regular
26420 <A HREF="h_config_mailcheck"><!--#echo var="VAR_mail-check-interval"--></A> option.
26421 When Alpine is about to do an automatic check for new mail (because
26422 the <!--#echo var="VAR_mail-check-interval"--> has expired) then if the time since the last
26423 new-mail check
26424 of any open Mail Drops has been greater than the <!--#echo var="VAR_maildrop-check-minimum"-->,
26425 the Mail Drop is checked for new mail as well.
26426 Therefore, it is only useful to set this option to a value that is higher
26427 than the <!--#echo var="VAR_mail-check-interval"-->.
26428 <P>
26429 If this option is set to zero, automatic Mail Drop new-mail
26430 checking is disabled.
26431 There is a minimum value, normally 60 seconds.
26432 The default value is normally 60 seconds as well.
26433 This applies to the INBOX and to the currently open folder if that is
26434 different from the INBOX.
26435
26436 <P>
26437 <UL>
26438 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26439 </UL><P>
26440 &lt;End of help on this topic&gt;
26441 </BODY>
26442 </HTML>
26443 ====== h_config_nntprange =====
26444 <HTML>
26445 <HEADER>
26446 <TITLE>OPTION: <!--#echo var="VAR_nntp-range"--></TITLE>
26447 </HEADER>
26448 <BODY>
26449 <H1>OPTION: <!--#echo var="VAR_nntp-range"--></H1>
26450
26451 This option applies only to newsgroups accessed using the NNTP protocol.
26452 It does not, for example,
26453 apply to newsgroups accessed using an IMAP-to-NNTP proxy.
26454
26455 <P>
26456 When you open a connection to a News server using the NNTP protocol, you
26457 normally have access to all of the articles in each newsgroup.
26458 If a server keeps a large backlog of messages it may speed performance
26459 some to restrict attention to only the newer messages in a group.
26460 This option allows you to set how many article numbers should be checked
26461 when opening a newsgroup.
26462 You can think of &quot;<!--#echo var="VAR_nntp-range"-->&quot; as specifying the maximum number
26463 of messages you ever want to see.
26464 For example, if you only ever wanted to look at the last 500 messages in each
26465 newsgroup you could set this option to 500.
26466 In actuality, it isn't quite that.
26467 Instead, for performance reasons, it specifies the range of article
26468 numbers to be checked, beginning
26469 with the highest numbered article and going backwards from there.
26470 If there are messages that have been canceled or deleted
26471 their article numbers are still counted as part of the range.
26472 <P>
26473 So, more precisely, setting the &quot;<!--#echo var="VAR_nntp-range"-->&quot; will cause article
26474 numbers
26475 <P><CENTER>last_article_number - <!--#echo var="VAR_nntp-range"--> + 1 through last_article_number</CENTER>
26476 <P>
26477 to be considered when reading a newsgroup.
26478 The number of messages that show up in your index will be less than or equal
26479 to the value of &quot;<!--#echo var="VAR_nntp-range"-->&quot;.
26480
26481 <P>
26482 The purpose of this option is simply to speed up access when reading news.
26483 The speedup comes because Alpine can ignore all but the last <!--#echo var="VAR_nntp-range"--> article
26484 numbers, and can avoid downloading any information about the ignored articles.
26485 There is a cost you pay for this speedup.
26486 That cost is that there is no way for you to see those ignored articles.
26487 The articles that come before the range you specify are invisible to you and
26488 to Alpine, as if they did not exist at all.
26489 There is no way to see those messages using, for example, an unexclude command
26490 or something similar.
26491 The only way to see those articles is to set this option high enough (or
26492 set it to zero) and then to reopen the newsgroup.
26493
26494 <P>
26495 If this option is set to 0 (which is also the default),
26496 then the range is unlimited.
26497 This option applies globally to all NNTP servers and to all newsgroups
26498 on those servers.
26499 There is no way to set different values for different newsgroups or servers.
26500
26501 <P>
26502 <UL>
26503 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26504 </UL><P>
26505 &lt;End of help on this topic&gt;
26506 </BODY>
26507 </HTML>
26508 ====== h_config_news_active =====
26509 <html>
26510 <header>
26511 <title>OPTION: <!--#echo var="VAR_news-active-file-path"--></title>
26512 </header>
26513 <body>
26514 <h1>OPTION: <!--#echo var="VAR_news-active-file-path"--></h1>
26515
26516 This option tells Alpine where to look for the "active file" for newsgroups
26517 when accessing news locally, rather than via NNTP.  The default path is
26518 usually "/usr/lib/news/active".<p>
26519 <UL>
26520 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26521 </UL><P>
26522 &lt;End of help on this topic&gt;
26523 </body>
26524 </html>
26525 ====== h_config_news_spool =====
26526 <html>
26527 <header>
26528 <title>OPTION: <!--#echo var="VAR_news-spool-directory"--></title>
26529 </header>
26530 <body>
26531 <h1>OPTION: <!--#echo var="VAR_news-spool-directory"--></h1>
26532
26533 This option tells Alpine where to look for the "news spool" for newsgroups
26534 when accessing news locally, rather than via NNTP.  The default path is
26535 usually "/var/spool/news".<p>
26536 <UL>
26537 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26538 </UL><P>
26539 &lt;End of help on this topic&gt;
26540 </body>
26541 </html>
26542 ====== h_config_image_viewer =====
26543 <html>
26544 <header>
26545 <title>OPTION: <!--#echo var="VAR_image-viewer"--></title>
26546 </header>
26547 <body>
26548 <h1>OPTION: <!--#echo var="VAR_image-viewer"--></h1>
26549 <body>
26550 This option specifies the program Alpine should call to view MIME
26551 attachments of type IMAGE (e.g. GIF or TIFF).  The Image Viewer setting is
26552 no longer needed, but remains for backward compatibility.  The more
26553 general method for associating external printing and viewing programs with
26554 specific MIME data types is to use the system's (or your personal)
26555 "mailcap" configuration file.<p>
26556 <UL>
26557 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26558 </UL><P>
26559 &lt;End of help on this topic&gt;
26560 </body>
26561 </html>
26562 ====== h_config_domain_name =====
26563 <HTML>
26564 <HEAD>
26565 <TITLE>OPTION: <!--#echo var="VAR_use-only-domain-name"--></TITLE>
26566 </HEAD>
26567 <BODY>
26568 <H1>OPTION: <!--#echo var="VAR_use-only-domain-name"--></H1>
26569
26570 This option is used only if the
26571 <A HREF="h_config_user_dom">&quot;<!--#echo var="VAR_user-domain"-->&quot;</A> option is <B>not</B>
26572 set.  If set to &quot;Yes&quot; (and <!--#echo var="VAR_user-domain"--> is not used), then Alpine
26573 strips the hostname from your return (&quot;From&quot;) address and when
26574 completing unqualified addresses that you enter into the composer.
26575 <P>
26576 If you set this, see also the <A HREF="h_config_quell_local_lookup">
26577 &quot;<!--#echo var="FEAT_quell-user-lookup-in-passwd-file"-->&quot;</A> feature.
26578
26579
26580 <!--chtml if pinemode="os_windows"-->
26581 <P>This option is not applicable to PC-Alpine.
26582 <!--chtml else-->
26583 <P>
26584 <!--chtml endif-->
26585 <UL>
26586 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26587 </UL>
26588 <P>
26589 &lt;End of help on this topic&gt;
26590 </BODY>
26591 </HTML>
26592 ====== h_config_prune_date =====
26593 <HTML>
26594 <HEAD>
26595 <TITLE>OPTION: Last-Time-Prune Question</TITLE>
26596 </HEAD>
26597 <BODY>
26598 <H1>OPTION: Last-Time-Prune Question</H1>
26599
26600 This value records the last time you were asked about deleting old
26601 sent-mail.
26602 It is set automatically by Alpine at the beginning of each month.
26603 In the past, if you wished to suppress the monthly sent-mail
26604 pruning feature, you could set this to a date in the future.
26605 This value is relative to the year 1900, so
26606 to set this, for example, to October 2005, use 105.10.
26607 <P>
26608 You can still do that if you wish, or you can use the
26609 <A HREF="h_config_pruning_rule"><!--#echo var="VAR_pruning-rule"--></A> option, which is probably
26610 a little more convenient to use.
26611 <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_goto_default =====
26619 <HTML>
26620 <HEAD>
26621 <TITLE>OPTION: <!--#echo var="VAR_goto-default-rule"--></TITLE>
26622 </HEAD>
26623 <BODY>
26624 <H1>OPTION: <!--#echo var="VAR_goto-default-rule"--></H1>
26625
26626 This value affects Alpine's behavior when you use the Goto command.
26627 Alpine's usual behavior has two parts.  If your current folder is
26628 &quot;Inbox&quot;, Alpine will offer the last open folder as the
26629 default.  If the current folder is other than &quot;Inbox&quot;,
26630 &quot;Inbox&quot; is offered as the default.
26631
26632 <P>
26633 The available options include:
26634
26635 <DL>
26636
26637  <DT>folder-in-first-collection</DT>
26638
26639  <DD> Alpine will offer the most recently visited folder in the default
26640 collection found in the &quot;Collection List&quot; screen as the default.
26641 </DD>
26642
26643  <DT> inbox-or-folder-in-first-collection</DT>
26644
26645  <DD> If the current folder is &quot;Inbox&quot;,
26646 Alpine will offer the most recently visited folder in the
26647 default collection found in the &quot;Collection List&quot; screen.
26648 If the current folder is other than &quot;Inbox&quot;,
26649 &quot;Inbox&quot; is offered as the default.
26650 </DD>
26651
26652  <DT> inbox-or-folder-in-recent-collection</DT>
26653
26654  <DD> This is Alpine's default behavior.
26655 If the current folder is &quot;Inbox&quot;,
26656 Alpine will offer the last open
26657 folder as the default.
26658 If the current folder is other than &quot;Inbox&quot;,
26659 &quot;Inbox&quot; is offered as the default.
26660 </DD>
26661
26662  <DT> first-collection-with-inbox-default</DT>
26663
26664  <DD> Instead of offering the most recently visited folder in the default
26665 collection, the default collection is offered but with &quot;Inbox&quot; as
26666 the default folder.
26667 If you type in a folder name it will be in the default collection.
26668 If you simply accept the default, however, your &quot;Inbox&quot; will be opened.
26669 </DD>
26670
26671  <DT> most-recent-folder</DT>
26672
26673  <DD> The last accepted value simply causes the most recently opened
26674 folder to be offered as the default regardless of the currently opened
26675 folder.
26676 </DD>
26677 </DL>
26678
26679 <P>
26680 NOTE: The default while a newsgroup is open remains the same; the last
26681 open newsgroup.
26682
26683 <P>
26684 <UL>
26685 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26686 </UL><P>
26687 &lt;End of help on this topic&gt;
26688 </BODY>
26689 </HTML>
26690 ====== h_config_thread_lastreply_char =====
26691 <HTML>
26692 <HEAD>
26693 <TITLE>OPTION: <!--#echo var="VAR_threading-lastreply-character"--></TITLE>
26694 </HEAD>
26695 <BODY>
26696 <H1>OPTION: <!--#echo var="VAR_threading-lastreply-character"--></H1>
26697
26698 The <!--#echo var="VAR_threading-lastreply-character"--> option has a small effect on the MESSAGE
26699 INDEX display when using a
26700 <A HREF="h_config_thread_disp_style"><!--#echo var="VAR_threading-display-style"--></A>
26701 of &quot;show-thread-structure&quot;, &quot;mutt-like&quot;, or
26702 &quot;show-structure-in-from&quot;; and sorting by Threads or OrderedSubject.
26703 The value of this option is a single character.
26704 This character is used instead of the vertical line character when there are
26705 no more replies directly to the parent of the current message.
26706 It can be used to &quot;round-off&quot; the bottom of the vertical line
26707 by setting it to a character such as a backslash (&#92;) or
26708 a backquote (&#96;).
26709 The default value of this option is the backslash character (&#92;).
26710 This option may not be set to the Empty Value.
26711 In that case, the default will be used instead.
26712
26713 <P>
26714 <UL>
26715 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26716 </UL><P>
26717 &lt;End of help on this topic&gt;
26718 </BODY>
26719 </HTML>
26720 ====== h_config_thread_indicator_char =====
26721 <HTML>
26722 <HEAD>
26723 <TITLE>OPTION: <!--#echo var="VAR_threading-indicator-character"--></TITLE>
26724 </HEAD>
26725 <BODY>
26726 <H1>OPTION: <!--#echo var="VAR_threading-indicator-character"--></H1>
26727
26728 The <!--#echo var="VAR_threading-indicator-character"--> option has a small effect on the MESSAGE
26729 INDEX display when using a
26730 <A HREF="h_config_thread_disp_style"><!--#echo var="VAR_threading-display-style"--></A> other
26731 than &quot;none&quot; and sorting by Threads or OrderedSubject.
26732 The value of this option is a single character.
26733 This character is used to indicate that part of a thread (a conversation) is
26734 hidden beneath a message.
26735 The message could be expanded
26736 if desired with the &quot;/&quot; Collapse/Expand command.
26737 By default, the value of this option is the greater than sign (&gt;).
26738 <P>
26739 If this option is set to the Empty Value, then the column (and the following
26740 blank column) will be deleted from the display.
26741
26742 <P>
26743 This option is closely related to the
26744 <A HREF="h_config_thread_exp_char"><!--#echo var="VAR_threading-expanded-character"--></A> option.
26745 Another similar option that affects the thread display is the
26746 <A HREF="h_config_thread_lastreply_char"><!--#echo var="VAR_threading-lastreply-character"--></A> option.
26747
26748 <P>
26749 <UL>
26750 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26751 </UL><P>
26752 &lt;End of help on this topic&gt;
26753 </BODY>
26754 </HTML>
26755 ====== h_config_thread_exp_char =====
26756 <HTML>
26757 <HEAD>
26758 <TITLE>OPTION: <!--#echo var="VAR_threading-expanded-character"--></TITLE>
26759 </HEAD>
26760 <BODY>
26761 <H1>OPTION: <!--#echo var="VAR_threading-expanded-character"--></H1>
26762
26763 The <!--#echo var="VAR_threading-expanded-character"--> option has a small effect on the MESSAGE
26764 INDEX display when using a
26765 <A HREF="h_config_thread_disp_style"><!--#echo var="VAR_threading-display-style"--></A> other
26766 than &quot;none&quot;.
26767 The value of this option is a single character.
26768 This character is used to indicate that part of a thread has been expanded
26769 and could be collapsed if desired with
26770 the &quot;/&quot; Collapse/Expand command.
26771 By default, the value of this option is a dot (.).
26772 <P>
26773 If this option is set to the Empty Value, then the column (and the following
26774 blank column) will be deleted from the display.
26775
26776 <P>
26777 This option is closely related to the
26778 <A HREF="h_config_thread_indicator_char"><!--#echo var="VAR_threading-indicator-character"--></A> option.
26779 Another similar option that affects the thread display is the
26780 <A HREF="h_config_thread_lastreply_char"><!--#echo var="VAR_threading-lastreply-character"--></A> option.
26781
26782 <P>
26783 <UL>
26784 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26785 </UL><P>
26786 &lt;End of help on this topic&gt;
26787 </BODY>
26788 </HTML>
26789 ====== h_config_thread_index_style =====
26790 <HTML>
26791 <HEAD>
26792 <TITLE>OPTION: <!--#echo var="VAR_threading-index-style"--></TITLE>
26793 </HEAD>
26794 <BODY>
26795 <H1>OPTION: <!--#echo var="VAR_threading-index-style"--></H1>
26796
26797 When a folder is sorted by Threads or OrderedSubject,
26798 this option will affect the INDEX displays.
26799 <P>
26800
26801 The possible values for this option are:
26802
26803 <DL>
26804 <DT>regular-index-with-expanded-threads</DT>
26805 <DD>This is the default display.
26806 If the configuration option
26807 <A HREF="h_config_thread_disp_style">&quot;<!--#echo var="VAR_threading-display-style"-->&quot;</A>
26808 is set to something other than &quot;none&quot;, then this setting
26809 will cause Alpine to start off with a MESSAGE INDEX with all of
26810 the threads expanded.
26811 That is, each message will have a line in the MESSAGE INDEX display.
26812 The Collapse/Expand command (/) may be used to manually collapse or
26813 expand a thread or subthread (see also <A HREF="h_config_slash_coll_entire">&quot;<!--#echo var="FEAT_slash-collapses-entire-thread"-->&quot;</A>).
26814 <P>
26815 This setting affects the display when the folder is first threaded.
26816 The collapsed state may also be re-initialized by re-sorting the folder manually
26817 using the SortIndex command ($).
26818 After re-sorting the threads will once again all be expanded, even if you
26819 have previously collapsed some of them.
26820 <P>
26821 If &quot;<!--#echo var="VAR_threading-display-style"-->&quot; is set to &quot;none&quot;, then
26822 the display will be the regular default Alpine MESSAGE INDEX, but sorted
26823 in a different order.
26824 </DD>
26825
26826 <DT>regular-index-with-collapsed-threads</DT>
26827 <DD>If the configuration option
26828 <A HREF="h_config_thread_disp_style">&quot;<!--#echo var="VAR_threading-display-style"-->&quot;</A>
26829 is set to something other than &quot;none&quot;, then this setting
26830 will cause Alpine to start out with all of the threads collapsed instead of
26831 starting out with all of the threads expanded.
26832 The Collapse/Expand command (/) may be used to manually collapse or
26833 expand a thread or subthread (see also <A HREF="h_config_slash_coll_entire">&quot;<!--#echo var="FEAT_slash-collapses-entire-thread"-->&quot;</A>).
26834 <P>
26835 This setting affects the display when the folder is first threaded.
26836 The collapsed state may also be re-initialized by re-sorting the folder manually
26837 using the SortIndex command ($).
26838 After re-sorting the threads will once again all be collapsed, even if you
26839 have previously expanded some of them.
26840 </DD>
26841
26842 <DT>separate-index-screen-always</DT>
26843 <DD>With this setting and the next, you will see an index of threads
26844 instead of an
26845 index of messages, provided you have sorted by Threads or OrderedSubject.
26846 <P>
26847 The THREAD INDEX contains a '*' in the first column if any message in the thread
26848 is marked Important.
26849 If not, it contains a '+' if any message in the thread is to you.
26850 The second column is blank. The third column contains a 'D' if all of the
26851 messages in the thread are deleted.
26852 Otherwise, it contains an 'N' if any of the messages in the thread are New.
26853 <P>
26854 When you view a particular thread from the THREAD INDEX you will be
26855 in the MESSAGE INDEX display
26856 but the index will only contain messages from the thread you are viewing.
26857 </DD>
26858
26859 <DT>separate-index-screen-except-for-single-messages</DT>
26860 <DD>This is very similar to the option above.
26861 When you are in the THREAD INDEX, one of the available commands
26862 is &quot;ViewThd&quot;.
26863 With the setting &quot;separate-index-screen-always&quot; (the option above)
26864 when you view a particular thread you will be in the
26865 MESSAGE INDEX display and the index will only contain messages from
26866 the thread you are viewing.
26867 If the thread you are viewing consists of a single message, the MESSAGE INDEX
26868 will be an index with only one message in it.
26869 If you use this &quot;separate-index-screen-except-for-single-messages&quot;
26870 setting instead, then that index that contains a single message
26871 will be skipped and you will go directly from the THREAD INDEX into the
26872 MESSAGE TEXT screen.
26873 </DD>
26874
26875 </DL>
26876
26877 <P>
26878 <UL>
26879 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26880 </UL><P>
26881 &lt;End of help on this topic&gt;
26882 </BODY>
26883 </HTML>
26884 ====== h_config_thread_disp_style =====
26885 <HTML>
26886 <HEAD>
26887 <TITLE>OPTION: <!--#echo var="VAR_threading-display-style"--></TITLE>
26888 </HEAD>
26889 <BODY>
26890 <H1>OPTION: <!--#echo var="VAR_threading-display-style"--></H1>
26891
26892 When a folder is sorted by Threads or OrderedSubject,
26893 this option will affect the MESSAGE INDEX display.
26894 By default, Alpine will display the MESSAGE INDEX in the
26895 &quot;show-thread-structure&quot; style if a folder is sorted
26896 by Threads or OrderedSubject.
26897 <P>
26898
26899 The possible values for this option are:
26900
26901 <DL>
26902 <DT>none</DT>
26903 <DD>Regular index display.
26904 The same index line as would be displayed without threading is used.
26905 The only difference will be in the order of the messages.
26906 </DD>
26907
26908 <DT>show-thread-structure</DT>
26909 <DD>Threaded Subjects will be indented and vertical bars and horizontal
26910 lines will be added to make it easier to see the relationships among
26911 the messages in a thread (a conversation).
26912 </DD>
26913
26914 <DT>mutt-like</DT>
26915 <DD>This is the same as the option above except that the Subject
26916 is suppressed (is blank) if it matches the previous Subject in the thread.
26917 The name comes from the email client <A HREF="http://www.mutt.org/">Mutt</A>.
26918 Here is an example of what a mutt-like index might look like.
26919 In this example, the first column represents the message number, the
26920 <A HREF="h_config_thread_index_style"><!--#echo var="VAR_threading-index-style"--></A>
26921 is set to &quot;regular-index-with-expanded-threads&quot;, and the
26922 <A HREF="h_config_thread_lastreply_char"><!--#echo var="VAR_threading-lastreply-character"--></A>
26923 is set to a backslash:
26924 <PRE>
26925 &nbsp;&nbsp;&nbsp;1    Some topic
26926 &nbsp;&nbsp;&nbsp;&nbsp;2  . Subject           original message in thread
26927 &nbsp;&nbsp;&nbsp;&nbsp;3    |->               reply to 2
26928 &nbsp;&nbsp;&nbsp;&nbsp;4  . |->               another reply to 2
26929 &nbsp;&nbsp;&nbsp;&nbsp;5  . | &#92;->             reply to 4
26930 &nbsp;&nbsp;&nbsp;&nbsp;6  . |   &#92;->           reply to 5
26931 &nbsp;&nbsp;&nbsp;&nbsp;7    |     &#92;->         reply to 6
26932 &nbsp;&nbsp;&nbsp;&nbsp;8    |->               another reply to 2
26933 &nbsp;&nbsp;&nbsp;&nbsp;9  . |->New subject    another reply to 2 but with a New subject
26934 &nbsp;&nbsp;&nbsp;10    | |->             reply to 9
26935 &nbsp;&nbsp;&nbsp;11    | &#92;->             another reply to 9
26936 &nbsp;&nbsp;&nbsp;12    |   &#92;->           reply to 11
26937 &nbsp;&nbsp;&nbsp;13    &#92;->               final reply to 2
26938 &nbsp;&nbsp;&nbsp;14    Next topic
26939 </PRE>
26940 </DD>
26941
26942 <DT>indent-subject-1</DT>
26943 <DD>Threaded Subjects will be indented one space per level of the conversation.
26944 The bars and lines that show up in the show-thread-structure display will
26945 not be there with this style.
26946 </DD>
26947
26948 <DT>indent-subject-2</DT>
26949 <DD>Same as above but indent two spaces per level instead of one space.
26950 </DD>
26951
26952 <DT>indent-from-1</DT>
26953 <DD>Similar to indent-subject-1, except that instead of indenting the
26954 Subject field one space the From field of a thread will be indented one
26955 space per level of the conversation.
26956 </DD>
26957
26958 <DT>indent-from-2</DT>
26959 <DD>Same as above but indent two spaces per level instead of one space.
26960 </DD>
26961
26962 <DT>show-structure-in-from</DT>
26963 <DD>The structure of the thread is illustrated with indenting, vertical bars,
26964 and horizontal lines just like with the show-thread-structure option, but
26965 the From field is used to show the relationships instead of the Subject field.
26966 </DD>
26967
26968 </DL>
26969
26970 <P>
26971 <UL>
26972 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26973 </UL><P>
26974 &lt;End of help on this topic&gt;
26975 </BODY>
26976 </HTML>
26977 ====== h_config_pruning_rule =====
26978 <HTML>
26979 <HEAD>
26980 <TITLE>OPTION: <!--#echo var="VAR_pruning-rule"--></TITLE>
26981 </HEAD>
26982 <BODY>
26983 <H1>OPTION: <!--#echo var="VAR_pruning-rule"--></H1>
26984
26985 By default, Alpine will ask at the beginning of each month whether or not
26986 you want to rename your sent-mail folder to a name like sent-mail-month-year.
26987 (See the feature <A HREF="h_config_prune_uses_iso"><!--#echo var="FEAT_prune-uses-yyyy-mm"--></A> to
26988 change the format of the folder to sent-mail-yyyy-mm.)
26989 It will also ask whether you would like to delete old sent-mail folders.
26990 If you have defined
26991 <A HREF="h_config_read_message_folder"><!--#echo var="VAR_read-message-folder"--></A>
26992 or
26993 <A HREF="h_config_pruned_folders"><!--#echo var="VAR_pruned-folders"--></A>
26994 Alpine will also ask about pruning those folders.
26995 <P>
26996
26997 With this option you may provide an automatic answer to these questions.
26998 The default value is to ask you what you'd like to do.
26999 <P>
27000
27001 The six possible values for this option are:
27002
27003 <DL>
27004 <DT>ask about rename, ask about deleting</DT>
27005 <DD>This is the default.
27006 Alpine will ask whether you want to rename the folders and whether you
27007 want to delete each of the old folders.
27008 </DD>
27009
27010 <DT>ask about rename, don't delete</DT>
27011 <DD>Alpine will ask whether you want to rename the folders, but won't
27012 ask about or delete old folders.
27013 </DD>
27014
27015 <DT>always rename, ask about deleting</DT>
27016 <DD>This means you want to always answer yes and have Alpine automatically
27017 rename the folder if possible.
27018 You will also be asked about deleting old folders.
27019 </DD>
27020
27021 <DT>always rename, don't delete</DT>
27022 <DD>This means you want to always answer yes and have Alpine automatically
27023 rename the folder if possible.
27024 There will be no deleting of old folders.
27025 </DD>
27026
27027 <DT>don't rename, ask about deleting</DT>
27028 <DD>This means you want to always answer no.
27029 Alpine will not rename the folder.
27030 You will be asked about deleting old folders.
27031 </DD>
27032
27033 <DT>don't rename, don't delete</DT>
27034 <DD>This means you want to always answer no.
27035 Alpine will not rename the folder.
27036 There will be no deleting of old folders, either.
27037 </DD>
27038 </DL>
27039
27040 <P>
27041 <UL>
27042 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27043 </UL><P>
27044 &lt;End of help on this topic&gt;
27045 </BODY>
27046 </HTML>
27047 ====== h_config_reopen_rule =====
27048 <HTML>
27049 <HEAD>
27050 <TITLE>OPTION: <!--#echo var="VAR_folder-reopen-rule"--></TITLE>
27051 </HEAD>
27052 <BODY>
27053 <H1>OPTION: <!--#echo var="VAR_folder-reopen-rule"--></H1>
27054
27055 Alpine normally checks for new mail in the currently open folder
27056 and in the INBOX every few <A HREF="h_config_mailcheck">minutes</A>.
27057
27058 <P>
27059 There are some situations where automatic new-mail checking does not work.
27060 For example, if a mail folder is opened using the POP protocol or a newsgroup
27061 is being read using the NNTP protocol, then new-mail checking is disabled.
27062
27063 <P>
27064 It may be possible to check for new mail in these cases by reopening the
27065 folder.
27066 Alpine does not do this for you automatically, but you may do the commands
27067 manually to cause this to happen.
27068 You reopen by going back to the folder list screen from the message
27069 index screen with the &quot;&lt;&quot; command,
27070 and then going back into the message index screen with
27071 the &quot;&gt;&quot; command.
27072 (Actually, any method you would normally use to open a folder will work the
27073 same as the &quot;&lt;&quot; followed by &quot;&gt;&quot; method.
27074 For example, the GoTo Folder command will work, or you may use L to go to the
27075 Folder List screen and Carriage Return to reopen the folder.)
27076
27077 <P>
27078 There are some cases where Alpine knows that reopening the folder should
27079 be useful as a way to discover new mail.
27080 At the time of this writing, connections made using the POP protocol,
27081 news reading using the NNTP protocol, local news reading, and local
27082 ReadOnly folders that are in the traditional UNIX or the MMDF format all
27083 fall into this category.
27084 There are other cases where it <EM>may</EM> be a way to discover new mail, but Alpine
27085 has no way of knowing, so it might also just be an exercise in futility.
27086 All remote, ReadOnly folders other than those listed just above fall into this
27087 category.
27088 The setting of this option together with the type of folder
27089 controls how Alpine will react to the apparent attempt to reopen a folder.
27090
27091 <P>
27092 If you don't reopen, then you will just be back in
27093 the message index with no change.
27094 You left the index and came back, but the folder remained &quot;open&quot;
27095 the whole time.
27096 However, if you do reopen the folder, the folder is closed and then reopened.
27097 In this case, the current state of the open folder is lost.
27098 The New status, Important and Answered flags,
27099 selected state, Zoom state, collapsed or expanded state of threads,
27100 current message number,
27101 and any other temporary state is all lost when the reopen happens.
27102 For POP folders (but not NNTP newsgroups) the Deleted flags are also lost.
27103
27104 <P>
27105 In the possibilities listed below, the text says &quot;POP/NNTP&quot; in
27106 several places.
27107 That really implies the case where Alpine knows it is a good way to discover
27108 new mail, which is more than just POP and NNTP, but POP and NNTP are
27109 the cases of most interest.
27110 This option probably has more possible values than it deserves. They are:
27111
27112 <DL>
27113 <DT>Always reopen</DT>
27114 <DD>Alpine will not ask whether you want to reopen but will just do the reopen
27115 whenever you type a command that implies a reopen, regardless of the
27116 access method.
27117 In other words, it is assumed you would always answer Yes if asked
27118 about reopening.
27119 </DD>
27120
27121 <DT>Yes for POP/NNTP, Ask about other remote [Yes]</DT>
27122 <DD>Alpine will assume a Yes answer if the access method is POP or NNTP, but
27123 will ask you whether to reopen other remote folders,
27124 with a default answer of Yes.
27125 </DD>
27126
27127 <DT>Yes for POP/NNTP, Ask about other remote [No]</DT>
27128 <DD>Alpine will assume a Yes answer if the access method is POP or NNTP, but
27129 will ask you whether to reopen other remote folders,
27130 with a default answer of No.
27131 </DD>
27132
27133 <DT>Yes for POP/NNTP, No for other remote</DT>
27134 <DD>Alpine will assume a Yes answer if the access method is POP or NNTP, and
27135 will assume a No answer for all other remote folders.
27136 </DD>
27137
27138 <DT>Always ask [Yes]</DT>
27139 <DD>Alpine will not differentiate based on access method.
27140 It will always ask for all remote folders, with a default answer of Yes.
27141 </DD>
27142
27143 <DT>Always ask [No]</DT>
27144 <DD>Alpine will not differentiate based on access method.
27145 It will always ask for all remote folders, with a default answer of No.
27146 </DD>
27147
27148 <DT>Ask about POP/NNTP [Yes], No for other remote</DT>
27149 <DD>Alpine will ask if the access method is POP or NNTP, with a default answer
27150 of Yes.
27151 It will never attempt to reopen other remote folders.
27152 </DD>
27153
27154 <DT>Ask about POP/NNTP [No], No for other remote</DT>
27155 <DD>This is the default.
27156 Alpine will ask if the access method is POP or NNTP, with a default answer
27157 of No.
27158 It will never attempt to reopen other remote folders.
27159 </DD>
27160
27161 <DT>Never reopen</DT>
27162 <DD>Alpine will never attempt to reopen already open folders.
27163 </DD>
27164 </DL>
27165
27166 <P>
27167 Remember, wherever it says POP or NNTP above it really means POP or NNTP or
27168 any of the other situations where it is likely that reopening is a good way
27169 to discover new mail.
27170
27171 <P>
27172 There is an alternative that may be of useful in some situations.
27173 Instead of manually checking for new mail you can set up a
27174 <A HREF="h_maildrop">Mail Drop</A>
27175 and automatically check for new mail.
27176
27177 <P>
27178 <UL>
27179 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27180 </UL><P>
27181 &lt;End of help on this topic&gt;
27182 </BODY>
27183 </HTML>
27184 ====== h_config_inc_startup =====
27185 <HTML>
27186 <HEAD>
27187 <TITLE>OPTION: <!--#echo var="VAR_incoming-startup-rule"--></TITLE>
27188 </HEAD>
27189 <BODY>
27190 <H1>OPTION: <!--#echo var="VAR_incoming-startup-rule"--></H1>
27191
27192 This value affects Alpine's behavior when opening the &quot;INBOX&quot; or
27193 one of the &quot;INCOMING MESSAGE FOLDERS&quot;.
27194 It determines which message will be the <EM>current message</EM> when
27195 the folder is first opened.
27196 The default value is &quot;first-unseen&quot;.
27197
27198 <P>
27199 The seven possible values for this option are:
27200
27201 <DL>
27202 <DT>first-unseen</DT>
27203 <DD>The current message is set to the first
27204 unseen message that has not been marked deleted, or the last message if
27205 all of the messages have been seen previously.
27206 Messages which have not been seen or which have been seen but re-marked
27207 as New are considered unseen messages.
27208 See the note at the bottom of this help about newsgroups.
27209 </DD>
27210
27211 <DT>first-recent</DT>
27212 <DD>Similar to the default, but rather than starting on the first
27213 unseen message Alpine starts on the first <EM>recent</EM> message.
27214 A message is recent if it arrived since the last time the folder was
27215 open.  This value causes the current message to be set to the first
27216 recent message if there is one, otherwise to the last
27217 message in the folder.
27218 </DD>
27219
27220 <DT>first-important</DT>
27221 <DD>This will result in the current message being set to the first
27222 message marked Important (but not Deleted).
27223 If no messages are marked Important, then it will be the last message.
27224 Messages are marked Important by <EM>you</EM>, not by the sender, using
27225 the
27226 <A HREF="h_common_flag">Flag command</A>.
27227 Or they may be marked Important by an Alpine
27228 <A HREF="h_mainhelp_filtering">Filter</A>
27229 that you have set up.
27230 </DD>
27231
27232 <DT>first-important-or-unseen</DT>
27233 <DD>This selects the first of the first unseen and the first important
27234 messages.
27235 </DD>
27236
27237 <DT>first-important-or-recent</DT>
27238 <DD>This selects the first of the first recent and the first important
27239 messages.
27240 </DD>
27241
27242 <DT>first</DT>
27243 <DD>Simply starts you on the <EM>first</EM> undeleted message in the folder.
27244 If all messages are deleted you start on the last message.
27245 </DD>
27246
27247 <DT>last</DT>
27248 <DD>Simply starts you on the <EM>last</EM> undeleted message in the folder
27249 If all messages are deleted you start on the last message.
27250 </DD>
27251 </DL>
27252
27253 <P>
27254 NOTE:  For newsgroups in the incoming collection, &quot;first-unseen&quot; and
27255 &quot;first-recent&quot; are the same and are affected by whether or not the
27256 feature
27257 <A HREF="h_config_news_uses_recent">&quot;<!--#echo var="FEAT_news-approximates-new-status"-->&quot;</A>
27258 is turned on.
27259 Also, there is no permanent storage in news for an Important flag.
27260 This means that no messages will be marked Important when a newsgroup is
27261 first opened.
27262
27263 <P>
27264 <UL>
27265 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27266 </UL><P>
27267 &lt;End of help on this topic&gt;
27268 </BODY>
27269 </HTML>
27270 ====== h_config_browser =====
27271 <HTML>
27272 <HEAD>
27273 <TITLE>OPTION: <!--#echo var="VAR_url-viewers"--></TITLE>
27274 </HEAD>
27275 <BODY>
27276 <H1>OPTION: <!--#echo var="VAR_url-viewers"--></H1>
27277 <!--chtml if pinemode="os_windows"-->
27278 PC-Alpine users do not need to enter anything here, unless:<UL>
27279 <LI> they want to override, for use with Alpine, the application defined
27280 in the Windows operating system for handling URLs; or
27281 <LI> they are (planning on) using the same configuration file with
27282 Unix Alpine.
27283 </UL>
27284 <P>
27285 Note that if using a viewer that has a space in its path, you should
27286 use the DOS name for that directory or file. Example:
27287 <PRE>
27288 url-viewer=C:&#92;Progra~1&#92;mozilla&#92;mozilla.exe
27289 </PRE>
27290 <HR><P>
27291 <!--chtml endif-->
27292 This option affects Alpine's handling of URLs that are found in
27293 messages you read.  Normally, only URLs Alpine can handle directly
27294 are automatically offered for selection in the &quot;Message
27295 Text&quot; screen.  When one or more applications
27296 capable of deciphering URLs on their command line are added here, Alpine
27297 will choose the first available to display URLs it cannot handle directly.
27298 A viewer's availability is based on its being specified with a <B>full
27299 directory path</B> and the evaluation of any optionally supplied
27300 parameters described below.
27301
27302 <P>
27303 Additionally, to support various connection methods and applications, each
27304 entry in this list can optionally begin with one or more of
27305 the following special tokens.  The allowed tokens include:
27306
27307 <P>
27308 <DL>
27309 <DT>_TEST(<VAR>test-string</VAR>)_</DT>
27310 <DD>
27311 The <VAR>test-string</VAR> is a shell command that Alpine will run to
27312 evaluate a viewer's availability.  The command specified by the test
27313 string is run and if its resulting exit status is non-zero, Alpine will
27314 not consider the associated viewer for use.
27315 </DD>
27316
27317 <DT>_SCHEME(<VAR>scheme-list</VAR>)_</DT>
27318 <DD>
27319 The <VAR>scheme-list</VAR> is a list of one or more (comma-delimited)
27320 URL schemes that are to be used with the associated viewer.  This is
27321 the way to configure Alpine to recognize URLs other than the built-in set.
27322 <P>
27323 It can also be used to override Alpine's built-in handlers.
27324 For example, you could specify &quot;news&quot; in the <VAR>scheme-list</VAR>,
27325 and Alpine would use (provided it passed all other criteria) the associated
27326 viewer when it encounterd a URL of the form &quot;news:comp.mail.pine&quot;.
27327
27328 </DD>
27329 </DL>
27330
27331 <P>
27332 By default, Alpine will simply append a space character followed by the
27333 selected URL prior to launching the command in your specified SHELL.  You can
27334 optionally specify where in the command the selected URL should appear
27335 by using the &quot;_URL_&quot; token.  All occurrences found in the command
27336 will be replaced with the selected URL before the command is handed
27337 to the shell.  If such replacement occurs, the default appending of the
27338 selected URL does not take place.
27339
27340 <P>
27341 NOTE: If the viewer you specify has any command-line arguments,
27342 including the &quot;_URL_&quot; token, you will need to add a
27343 double-quote character before the command path and after the last
27344 argument (see the &quot;lynx&quot; example below).
27345
27346 <P>
27347 So, here are some example entries:
27348 <PRE>
27349 url-viewers = _TEST(&quot;test -n '$&#123;DISPLAY}'&quot;)_  /usr/local/bin/netscape
27350               &quot;/usr/local/bin/lynx _URL_&quot;
27351               C:&#92;BIN&#92;NETSCAPE.BAT
27352 </PRE>
27353 <P>
27354 This example shows that for the first viewer in the list to be used
27355 the environment variable &quot;DISPLAY&quot; must be defined.  If it
27356 is, then the path and file &quot;/usr/local/bin/netscape&quot; must exist.
27357 If neither condition is met,
27358 then the path and file &quot;/usr/local/bin/lynx&quot; must exist.
27359 If it does, then the &quot;_URL_&quot; token is replaced by the selected URL.
27360 If the path to &quot;lynx&quot; is invalid,
27361 then the final path and file C:&#92;BIN&#92;NETSCAPE.BAT must exist.
27362 Note that the last
27363 entry is a DOS/Windows path.  This is one way to support Alpine running
27364 on more than one architecture with the same configuration file.<P>
27365 <P>
27366 <!--chtml if pinemode="os_windows"-->
27367 <!--chtml else-->
27368 Note that depending on the type of browser used and the method of
27369 its invocation (such as whether it will open in a separate window) from
27370 the MESSAGE TEXT screen, the browser may &quot;supplant&quot;
27371 the MESSAGE TEXT screen, and you will have to quit the browser to return to
27372 it (for example, when using Lynx; to exit Lynx, use the &quot;Q&quot; command).
27373 In other words, launching the browser from Alpine may make Alpine
27374 &quot;disappear&quot; (although it is still &quot;running&quot;)
27375 until you close the browser again.<P>
27376 <UL><LI><A HREF="h_config_browser_xterm">Defining <!--#echo var="VAR_url-viewers"--> in an X windows
27377 environment: for advanced users and  systems administrators</A>
27378 </UL>
27379 <!--chtml endif-->
27380 <P>If you are unsure what browsers are available on your system or how to
27381 specify them in Alpine's <!--#echo var="VAR_url-viewers"--> option for best usability, contact your
27382 local computing support staff.
27383 <P><UL>
27384 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27385 </UL>
27386 <P>
27387 &lt;End of help on this topic&gt;
27388 </BODY>
27389 </HTML>
27390 ====== h_config_history =====
27391 <HTML>
27392 <HEAD>
27393 <TITLE>OPTION: <!--#echo var="VAR_default-directories"--></TITLE>
27394 </HEAD>
27395 <BODY>
27396 <H1>OPTION: <!--#echo var="VAR_default-directories"--></H1>
27397 <P>
27398 This option allows you to input a list of directories that Alpine will offer
27399 for you to use when you are saving or exporting attachments. This is useful
27400 when navigating to specific directories becomes too tedious, or when you
27401 need to do this on a daily basis, and want Alpine to remember this on a
27402 permanent basis.
27403 <P>
27404 The list of directories saved here can be accessed using the ^Y and ^V commands
27405 in the save prompt for attachments, or the export command.
27406
27407 <P><UL>
27408 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27409 </UL>
27410 <P>
27411 &lt;End of help on this topic&gt;
27412 </BODY>
27413 </HTML>
27414 ====== h_config_browser_xterm =====
27415 <HTML>
27416 <HEAD>
27417 <TITLE><!--#echo var="VAR_url-viewers"--> and X windows applications</TITLE>
27418 </HEAD>
27419 <BODY>
27420 <H1>Defining <!--#echo var="VAR_url-viewers"--> in an X windows
27421 environment: for advanced users and  systems administrators</H1>
27422 If you are using Alpine with an X-terminal (emulator) and want to define an
27423 X windows-based application in <!--#echo var="VAR_url-viewers"-->,
27424 you may want to do so in a manner that causes any <B>already</B>
27425 invoked viewer application to be used for viewing URLs you select from Alpine
27426 messages, and a <B>new</B> URL-viewer process to be
27427 started <B>only</B> if the same application has <B>not already</B>
27428 been launched -- for one reason, to avoid file-locking contentions among
27429 multiple invocations of the same URL-viewer application.
27430 (The example entries set in the help screen for the &quot;<!--#echo var="VAR_url-viewers"-->&quot;
27431 option does not do this.)  A method of doing that would be:<OL>
27432 <LI> use
27433 the _TEST(<VAR>test-string</VAR>)_ token in the <B>first</B> entry to
27434 check (using commands appropriate for your Unix shell
27435 in place of <VAR>test-string</VAR>) for the presence of a
27436 lockfile created by the URL-viewer application -- which implies that the
27437 application is already running, though this is not foolproof.
27438 Following that in the same <!--#echo var="VAR_url-viewers"--> entry, specify the
27439 application with its appropriate command line option(s) to
27440 show the URL selected from the Alpine message in an already open window of
27441 that application, or perhaps in a new window of that application.
27442
27443 <LI> In the
27444 <B>second</B> entry for the <!--#echo var="VAR_url-viewers"--> option, specify the same
27445 application without those command line options, but this time using the
27446 _TEST(...)_ token to check whether the environment variable &quot;DISPLAY&quot;
27447 is defined.
27448 <LI> If you will be using Alpine (with the same .pinerc file) outside of the X
27449 windows environment (for instance, using VT-100 terminal emulation), you
27450 may wish to specify a non-X windows URL-viewer application such as Lynx
27451 as the last entry.
27452 </OL><BR>
27453 How exactly you define your <!--#echo var="VAR_url-viewers"--> entries to do this will depend on
27454 the command shell, the URL-viewer application(s), and possibly the specific
27455 version of the latter, you are using.
27456 <P>
27457 Relevant command
27458 line options for the Netscape browser for showing URLs (selected from Alpine)
27459 when Netscape is already running are discussed in the document
27460 &quot;Remote Control of UNIX Netscape&quot;
27461 found at the URL (as of 12 Aug. 1998):
27462 <P>
27463
27464 <CENTER><A HREF="http://home.netscape.com/newsref/std/x-remote.html">http://home.netscape.com/newsref/std/x-remote.html</A></CENTER>
27465
27466 <P>(If the URL-viewer application is
27467 <B>not</B> running on the same host as Alpine, but being launched from an
27468 applications server, you may not be able to use the command line options for
27469 using an existing invocation of the application in Alpine's <!--#echo var="VAR_url-viewers"--> entry.)
27470 <P>
27471 <!--chtml if this-method="shown-to-work"-->
27472 An example using the Korn shell and the Netscape browser (first entry wrapped
27473 because of its length, but should all appear on one line):
27474 <P>
27475 url-viewers = _TEST("test -L /myhomedir/.netscape/lock")_ &quot;/usr/local/bin/netscape -remote 'openURL(_URL_,  new-window)' &amp;&quot;<BR>
27476
27477 _TEST(&quot;test -n '$&#123;DISPLAY}'&quot;)_ &quot;/usr/local/bin/netscape &amp;&quot;<BR>
27478               &quot;/usr/local/bin/lynx '_URL_'&quot;
27479 <P>
27480 <!--chtml endif-->
27481 <P>
27482 <UL>
27483 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27484 </UL><P>
27485 &lt;End of help on this topic&gt;
27486 </BODY>
27487 </HTML>
27488 ====== h_config_enable_full_hdr =====
27489 <HTML>
27490 <HEAD>
27491 <TITLE>FEATURE: <!--#echo var="FEAT_enable-full-header-cmd"--></TITLE>
27492 </HEAD>
27493 <BODY>
27494 <H1>FEATURE: <!--#echo var="FEAT_enable-full-header-cmd"--></H1>
27495
27496 This feature enables the &quot;H Full Headers&quot; command which toggles between
27497 the display of all headers in the message and the normal edited view of
27498 headers.  The Full Header command also controls which headers are included
27499 for Export, Pipe, Print, Forward, and Reply functions.  (For Reply, the
27500 Full Header mode will respect the
27501 <A HREF="h_config_include_header">&quot;Include-Headers-in-Reply&quot;</A>
27502 feature setting.)
27503 <P>
27504 If Full Header mode is turned on and you Forward a message, you will
27505 be asked if you'd like to forward the message as an attachment, as opposed
27506 to including the text of the message in the body of your new message.
27507 <P>
27508 If you have also turned on the
27509 <A HREF="h_config_quote_suppression">&quot;Quote Suppression&quot;</A>
27510 option then the Full Headers command actually rotates through three states
27511 instead of just two.
27512 The first is the normal view with long quotes suppressed.
27513 The second is the normal view but with the long quotes included.
27514 The last enables the display of all headers in the message.
27515 When using Export, Pipe, Print, Forward, or Reply the quotes are
27516 never suppressed, so the first two states are identical.
27517 <P>
27518 Normally, the Header Mode will reset
27519 to the default behavior when moving to a new message.
27520 The mode can be made to persist from message to message by setting the feature
27521 <A HREF="h_config_quell_full_hdr_reset"><!--#echo var="FEAT_quell-full-header-auto-reset"--></A>.
27522 <P>
27523 <UL>
27524 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27525 </UL><P>
27526 &lt;End of help on this topic&gt;
27527 </BODY>
27528 </HTML>
27529 ====== h_config_enable_full_hdr_and_text =====
27530 <HTML>
27531 <HEAD>
27532 <TITLE>FEATURE: <!--#echo var="FEAT_enable-full-header-and-text"--></TITLE>
27533 </HEAD>
27534 <BODY>
27535 <H1>FEATURE: <!--#echo var="FEAT_enable-full-header-and-text"--></H1>
27536
27537 This feature affects how the &quot;H Full Headers&quot; command displays
27538 message text.  If set, the raw message text will be displayed.  This
27539 especially affects MIME formatted email, where the entire MIME format
27540 will be displayed.  This feature similarly affects how messages are
27541 included for the Export, Pipe, Print, Forward, and Reply functions.
27542 <P>
27543 When viewing a raw message that has attachments with this feature set,
27544 you will not be able to view attachments without first leaving full
27545 headers mode.  This is because MIME parsing is not done on the raw message.
27546 <P>
27547 <UL>
27548 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27549 </UL><P>
27550 &lt;End of help on this topic&gt;
27551 </BODY>
27552 </HTML>
27553 ====== h_config_enable_pipe =====
27554 <HTML>
27555 <HEAD>
27556 <TITLE>FEATURE: <!--#echo var="FEAT_enable-unix-pipe-cmd"--></TITLE>
27557 </HEAD>
27558 <BODY>
27559 <H1>FEATURE: <!--#echo var="FEAT_enable-unix-pipe-cmd"--></H1>
27560
27561 This feature enables the "| Pipe" command that sends the current message
27562 to the specified command for external processing.
27563 <P>
27564
27565 A short description of how the pipe command works is given
27566 <A HREF="h_pipe_command">here</A>.
27567
27568 <P>
27569 <UL>
27570 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27571 </UL><P>
27572 &lt;End of help on this topic&gt;
27573 </BODY>
27574 </HTML>
27575 ====== h_config_quell_full_hdr_reset =====
27576 <HTML>
27577 <HEAD>
27578 <TITLE>FEATURE: <!--#echo var="FEAT_quell-full-header-auto-reset"--></TITLE>
27579 </HEAD>
27580 <BODY>
27581 <H1>FEATURE: <!--#echo var="FEAT_quell-full-header-auto-reset"--></H1>
27582
27583 The <A HREF="h_common_hdrmode">HdrMode Command</A>
27584 normally resets to the default state when switching to a new message.
27585 For example, if you've used the &quot;H&quot; command to turn on Full
27586 Headers for a message you are viewing, and then you type the Next command
27587 to look at the next message, the full headers will no longer be shown.
27588 Setting this feature disables that reset.
27589 Instead, the Header Mode remains the same from message to message.
27590
27591 <P>
27592 The presence or absence of the HdrMode command is determined by the
27593 <A HREF="h_config_enable_full_hdr">&quot;<!--#echo var="FEAT_enable-full-header-cmd"-->&quot;</A>
27594 Feature-List option.
27595 <P>
27596 <UL>
27597 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27598 </UL><P>
27599 &lt;End of help on this topic&gt;
27600 </BODY>
27601 </HTML>
27602 ====== h_config_enable_tab_complete =====
27603 <HTML>
27604 <HEAD>
27605 <TITLE>FEATURE: <!--#echo var="FEAT_enable-tab-completion"--></TITLE>
27606 </HEAD>
27607 <BODY>
27608 <H1>FEATURE: <!--#echo var="FEAT_enable-tab-completion"--></H1>
27609
27610 This feature enables the TAB key when at a prompt for a filename. In this
27611 case, TAB will cause the partial name already entered to be automatically
27612 completed, provided the partial name is unambiguous.
27613 This feature is on by default.
27614 <P>
27615 Similarly, this feature also enables TAB completion of address book
27616 nicknames when at a prompt for a nickname,
27617 or when typing in an address field in the composer.
27618 <P>
27619 &lt;End of help on this topic&gt;
27620 </BODY>
27621 </HTML>
27622 ====== h_config_quit_wo_confirm =====
27623 <HTML>
27624 <HEAD>
27625 <TITLE>FEATURE: <!--#echo var="FEAT_quit-without-confirm"--></TITLE>
27626 </HEAD>
27627 <BODY>
27628 <H1>FEATURE: <!--#echo var="FEAT_quit-without-confirm"--></H1>
27629
27630 This feature controls whether or not Alpine will ask for confirmation when a
27631 Quit command is received.
27632 <P>
27633 &lt;End of help on this topic&gt;
27634 </BODY>
27635 </HTML>
27636 ====== h_config_quote_replace_noflow =====
27637 <HTML>
27638 <HEAD>
27639 <TITLE>FEATURE: <!--#echo var="FEAT_quote-replace-nonflowed"--></TITLE>
27640 </HEAD>
27641 <BODY>
27642 <H1>FEATURE: <!--#echo var="FEAT_quote-replace-nonflowed"--></H1>
27643
27644 This feature, which is only active when
27645 <A HREF="h_config_quote_replace_string"><!--#echo var="VAR_quote-replace-string"--></A> is
27646 also set,
27647 enables quote-replacement on non-flowed messages.  It is off
27648 by default because a non-flowed message is more dependent on its format,
27649 and thus quote-replacement may cause less-than-pleasing results.
27650 Setting this feature will cause quote-replacement similar to that of flowed
27651 messages, but with the added possibility of long lines being wrapped
27652 into new lines if the Quote-Replacement-String is longer than the string
27653 it is replacing, which is &quot;&gt;&nbsp;&quot;.
27654 <P>
27655 &lt;End of help on this topic&gt;
27656 </BODY>
27657 </HTML>
27658 ====== h_config_enable_jump =====
27659 <HTML>
27660 <HEAD>
27661 <TITLE>FEATURE: <!--#echo var="FEAT_enable-jump-shortcut"--></TITLE>
27662 </HEAD>
27663 <BODY>
27664 <H1>FEATURE: <!--#echo var="FEAT_enable-jump-shortcut"--></H1>
27665
27666 When this feature is set you may enter a number (followed by RETURN)
27667 and jump to that message number, when in the MESSAGE INDEX or MESSAGE TEXT
27668 screens.  In other words, it obviates the need for typing the "J" for the
27669 Jump command.
27670 <P>
27671 &lt;End of help on this topic&gt;
27672 </BODY>
27673 </HTML>
27674 ====== h_config_enable_alt_ed =====
27675 <HTML>
27676 <HEAD>
27677 <TITLE>FEATURE: <!--#echo var="FEAT_enable-alternate-editor-cmd"--></TITLE>
27678 </HEAD>
27679 <BODY>
27680 <H1>FEATURE: <!--#echo var="FEAT_enable-alternate-editor-cmd"--></H1>
27681
27682 If this feature is set (the default), and the
27683 <A HREF="h_config_editor">&quot;<!--#echo var="VAR_editor"-->&quot;</A> option
27684 <B>is not</B> set, entering
27685 the ^_ (Ctrl-underscore) key while composing a message will prompt you
27686 for the name of the editor you would like to use.
27687 <P>
27688 If the environment variable $EDITOR is set, its value will be offered as
27689 a default.
27690 <P>
27691 If the <A HREF="h_config_editor">&quot;<!--#echo var="VAR_editor"-->&quot;</A> option
27692 <B>is</B> set, the ^_ key will activate the specified
27693 editor without prompting, in which case it is not necessary to
27694 set the &quot;<!--#echo var="FEAT_enable-alternate-editor-cmd"-->&quot; feature.
27695 <P>
27696 <UL>
27697 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27698 </UL><P>
27699 &lt;End of help on this topic&gt;
27700 </BODY>
27701 </HTML>
27702 ====== h_config_alt_ed_now =====
27703 <HTML>
27704 <HEAD>
27705 <TITLE>FEATURE: <!--#echo var="FEAT_enable-alternate-editor-implicitly"--></TITLE>
27706 </HEAD>
27707 <BODY>
27708 <H1>FEATURE: <!--#echo var="FEAT_enable-alternate-editor-implicitly"--></H1>
27709
27710 If this feature and the <A HREF="h_config_editor">&quot;<!--#echo var="VAR_editor"-->&quot;</A>
27711 variable are both set, Alpine will
27712 automatically activate the specified editor when the cursor is moved from
27713 the header of the message being composed into the message text.  For
27714 replies, the alternate editor will be activated immediately.  If this
27715 feature is set but the &quot;<!--#echo var="VAR_editor"-->&quot; variable is not set, then Alpine will
27716 automatically ask for the name of an alternate editor when the cursor
27717 is moved out of the header being composed, or if a reply is being done.
27718
27719 <P><UL>
27720 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27721 </UL>
27722 <P>
27723 &lt;End of help on this topic&gt;
27724 </BODY>
27725 </HTML>
27726 ====== h_config_enable_bounce =====
27727 <HTML>
27728 <HEAD>
27729 <TITLE>FEATURE: <!--#echo var="FEAT_enable-bounce-cmd"--></TITLE>
27730 </HEAD>
27731 <H1>FEATURE: <!--#echo var="FEAT_enable-bounce-cmd"--></H1>
27732 <BODY>
27733
27734 Setting this feature enables the "B Bounce" command, which will prompt
27735 for an address and *remail* the message to the new recipient.  This command
27736 is used to re-direct messages that you have received in error, or need to
27737 be redirected for some other reason (e.g. list moderation).  The final
27738 recipient will see a header indicating that you have Resent the msg, but
27739 the message's From: header will show the original author of the message,
27740 and replies to it will go back to that author, and not to you.
27741 <P>
27742 &lt;End of help on this topic&gt;
27743 </BODY>
27744 </HTML>
27745 ====== h_config_enable_agg_ops =====
27746 <HTML>
27747 <HEAD>
27748 <TITLE>FEATURE: <!--#echo var="FEAT_enable-aggregate-command-set"--></TITLE>
27749 </HEAD>
27750 <BODY>
27751 <H1>FEATURE: <!--#echo var="FEAT_enable-aggregate-command-set"--></H1>
27752
27753 When this feature is set you may use the commands and subcommands that relate to
27754 performing operations on more than one message at a time.  We call these
27755 &quot;aggregate operations&quot;.  In particular, the
27756 <!--chtml if pinemode="function_key"-->&quot;F5
27757 <!--chtml else-->&quot;;
27758 <!--chtml endif--> Select&quot;,
27759
27760 <!--chtml if pinemode="function_key"-->
27761 &quot;F6
27762 <!--chtml else-->
27763 &quot;A
27764 <!--chtml endif-->
27765 Apply&quot;, and
27766 <!--chtml if pinemode="function_key"-->
27767 &quot;F4
27768 <!--chtml else-->
27769 &quot;Z
27770 <!--chtml endif-->
27771 Zoom&quot; commands are enabled by this feature.  Select is used to
27772 &quot;tag&quot; one or more messages meeting the specified criteria.  Apply can
27773 then be used to apply any message command to all of the selected/tagged
27774 messages.  Further, the Zoom command allows you to toggle the MESSAGE INDEX
27775 view between just those Selected and all messages in the folder.
27776 <P>
27777 This feature also enables the
27778 <!--chtml if pinemode="function_key"-->
27779 &quot;F7&quot;
27780 <!--chtml else-->
27781 &quot;^X&quot;
27782 <!--chtml endif-->
27783
27784 subcommand in the MESSAGE INDEX
27785 WhereIs command that causes all messages matching the WhereIs argument to
27786 become selected; and the Select, Select Current, and ZoomMode commands in the
27787 <A HREF="h_folder_maint">FOLDER LIST screen</A>.
27788 <P>
27789 Some related help topics are
27790 <UL>
27791 <LI> <A HREF="h_mainhelp_aggops">Aggregate Operations</A>
27792 <LI> <A HREF="h_index_cmd_select">Selecting: Select and WhereIs/Select</A>,
27793 <LI> <A HREF="h_config_auto_unzoom"><!--#echo var="FEAT_auto-unzoom-after-apply"--></A>,
27794 <LI> <A HREF="h_config_auto_unselect"><!--#echo var="FEAT_auto-unselect-after-apply"--></A>.
27795 <LI> <A HREF="h_config_auto_zoom"><!--#echo var="FEAT_auto-zoom-after-select"--></A>, and
27796 <LI> <A HREF="h_config_select_wo_confirm"><!--#echo var="FEAT_select-without-confirm"--></A>.
27797 </UL>
27798 <P>
27799 <UL>
27800 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27801 </UL><P>
27802 &lt;End of help on this topic&gt;
27803 </BODY>
27804 </HTML>
27805
27806 ====== h_config_enable_flag =====
27807 <HTML>
27808 <HEAD>
27809 <TITLE>FEATURE: <!--#echo var="FEAT_enable-flag-cmd"--></TITLE>
27810 </HEAD>
27811 <BODY>
27812 <H1>FEATURE: <!--#echo var="FEAT_enable-flag-cmd"--></H1>
27813
27814 Setting this feature enables the
27815 <A HREF="h_common_flag">&quot;* Flag&quot;</A>
27816 command that allows you to
27817 manipulate the status flags associated with a message.  By default, Flag
27818 will set the "Important" flag, which results in an asterisk being
27819 displayed in column one of the MESSAGE INDEX for such messages.
27820 <P>
27821 &lt;End of help on this topic&gt;
27822 </BODY>
27823 </HTML>
27824 ====== h_config_flag_screen_default =====
27825 <HTML>
27826 <HEAD>
27827 <TITLE>FEATURE: <!--#echo var="FEAT_enable-flag-screen-implicitly"--></TITLE>
27828 </HEAD>
27829 <BODY>
27830 <H1>FEATURE: <!--#echo var="FEAT_enable-flag-screen-implicitly"--></H1>
27831
27832 The feature modifies the behavior of the
27833 <a href="h_common_flag">Flag</a>
27834 command (provided it too is
27835 <A HREF="h_config_enable_flag">enabled</A>).
27836 By default, when the "* Flag" command is selected,
27837 Alpine offers a prompt to set one of several flags and also offers the
27838 option of entering the detailed flag manipulation screen via the "^T"
27839 key. Enabling this feature causes Alpine to immediately enter the detailed
27840 flag screen rather than first offer the simple prompt.
27841 The
27842 <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.
27843 <P>
27844 &lt;End of help on this topic&gt;
27845 </BODY>
27846 </HTML>
27847 ====== h_config_flag_screen_kw_shortcut =====
27848 <HTML>
27849 <HEAD>
27850 <TITLE>FEATURE: <!--#echo var="FEAT_enable-flag-screen-keyword-shortcut"--></TITLE>
27851 </HEAD>
27852 <BODY>
27853 <H1>FEATURE: <!--#echo var="FEAT_enable-flag-screen-keyword-shortcut"--></H1>
27854
27855 This feature modifies the behavior of the
27856 <a href="h_common_flag">Flag</a> command
27857 and the <A HREF="h_index_cmd_select">Select</A> command.
27858 This feature is set by default.
27859 When this feature is not set, when the "* Flag" command is selected,
27860 Alpine offers a prompt to set one of several flags and also offers the
27861 option of entering the detailed flag manipulation screen via the "^T"
27862 key.
27863 If you have
27864 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>
27865 defined, then enabling this feature adds a shortcut way to set or unset
27866 keywords.
27867 You use &quot;*&quot; followed by the first letter of a keyword (or the nickname of
27868 a keyword if you've given it a nickname) and that will set the keyword.
27869 <P>
27870 An example is easier to understand than the explanation.
27871 The flag command can always be used to set the system flags.
27872 For example, to set the Answered flag you would type
27873 <P>
27874 <CENTER><SAMP>* A</SAMP></CENTER>
27875 <P>
27876 Now suppose you have defined a keyword &quot;Work&quot; using the <!--#echo var="VAR_keywords"-->
27877 option in the Config screen.
27878 By default, to set a keyword like &quot;Work&quot; you would usually
27879 have to go to the Flag Details screen using
27880 the &quot;^T To Flag Details&quot; command.
27881 Instead, if you have enabled this feature, you may type
27882 <P>
27883 <CENTER><SAMP>* W</SAMP></CENTER>
27884 <P>
27885 to set the Work flag, or
27886 <P>
27887 <CENTER><SAMP>* ! W</SAMP></CENTER>
27888 <P>
27889 to unset it.
27890 Just like for the other flag setting commands, the case of the letter does
27891 not matter, so &quot;w&quot; or &quot;W&quot; both set the &quot;Work&quot;
27892 keyword.
27893 <P>
27894 Notice that you can only use this trick for one keyword that begins
27895 with &quot;W&quot;.
27896 If you happen to have a &quot;Work&quot; keyword and another keyword that is
27897 &quot;WIFI&quot; the &quot;* W&quot; command will set the first one in
27898 your list of keywords.
27899 Also, there are five letters that are reserved for system
27900 flags and the NOT command.
27901 If you type &quot;* A&quot; it will always set the Answered flag, not
27902 your &quot;Aardvark&quot; keyword.
27903 In order to set the &quot;Aardvark&quot; keyword you'll still have to use
27904 the Flag Details screen.
27905 <P>
27906 Because enabling the
27907 <A HREF="h_config_flag_screen_default"><!--#echo var="FEAT_enable-flag-screen-implicitly"--></A>
27908 option causes Alpine to skip directly to the Flag Details screen when the
27909 Flag command is used,
27910 setting it will cause this feature to have no effect at all.
27911 <P>
27912 Similarly, when Selecting by Keyword, setting this option will allow you
27913 to use Keyword initials instead of full keywords.
27914 <P>
27915 &lt;End of help on this topic&gt;
27916 </BODY>
27917 </HTML>
27918 ====== h_config_can_suspend =====
27919 <HTML>
27920 <HEAD>
27921 <TITLE>FEATURE: <!--#echo var="FEAT_enable-suspend"--></TITLE>
27922 </HEAD>
27923 <BODY>
27924 <H1>FEATURE: <!--#echo var="FEAT_enable-suspend"--></H1>
27925
27926 Setting this feature will allow you to type ^Z (Control Z) to
27927 <!--chtml if pinemode="os_windows"-->
27928 minimize Alpine into its icon, bringing into focus whatever
27929 application is running behind the PC-Alpine window.
27930 <!--chtml else-->
27931 temporarily suspend Alpine.
27932
27933 <P>
27934 This does not exit Alpine, but puts it in the background to watch
27935 for new mail and such.  Normally, you type a command, such
27936 as &quot;fg&quot; at your system prompt to return to your Alpine session.
27937
27938 <P>
27939 The <A HREF="h_config_suspend_spawns"><!--#echo var="FEAT_use-subshell-for-suspend"--></A> feature
27940 adjusts whether Alpine is placed into the background of the shell its
27941 running in or starts a news shell.
27942 <!--chtml endif-->
27943
27944 <P>
27945 <UL>
27946 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27947 </UL><P>
27948 &lt;End of help on this topic&gt;
27949 </BODY>
27950 </HTML>
27951 ====== h_config_take_lastfirst ======
27952 <HTML>
27953 <HEAD>
27954 <TITLE>FEATURE: <!--#echo var="FEAT_disable-take-last-comma-first"--></TITLE>
27955 </HEAD>
27956 <BODY>
27957 <H1>FEATURE: <!--#echo var="FEAT_disable-take-last-comma-first"--></H1>
27958
27959 Normally, when TakeAddr is used to copy an address from a message into
27960 an address book entry, Alpine will attempt to rewrite the full name of the
27961 address in the form
27962 <P>
27963
27964 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Last, First<P>
27965
27966 instead of<P>
27967
27968 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;First Last
27969
27970 <P>
27971 It does this because many people find it useful to sort by Last name
27972 instead of First name.  If this feature is set, then the TakeAddr command
27973 will not attempt to reverse the name in this manner.
27974 <P>
27975 &lt;End of help on this topic&gt;
27976 </BODY></HTML>
27977 ====== h_config_disable_regex ======
27978 <HTML>
27979 <HEAD>
27980 <TITLE>FEATURE: <!--#echo var="FEAT_disable-regular-expression-matching-for-alternate-addresses"--></TITLE>
27981 </HEAD>
27982 <BODY>
27983 <H1>FEATURE: <!--#echo var="FEAT_disable-regular-expression-matching-for-alternate-addresses"--></H1>
27984
27985 Normally, the
27986 <a href="h_config_alt_addresses"><!--#echo var="VAR_alt-addresses"--></a>
27987 option is interpreted as a regular expression.
27988 One type of address that might cause trouble is an address that
27989 contains a plus sign.
27990 If you want to have an address with a plus as one of your
27991 <!--#echo var="VAR_alt-addresses"-->
27992 and you don't want to use regular expressions, then setting this
27993 feature will cause Alpine to treat the addresses you list literally instead.
27994 <P>
27995 &lt;End of help on this topic&gt;
27996 </BODY></HTML>
27997 ====== h_config_take_fullname ======
27998 <HTML>
27999 <HEAD>
28000 <TITLE>FEATURE: <!--#echo var="FEAT_disable-take-fullname-in-addresses"--></TITLE>
28001 </HEAD>
28002 <BODY>
28003 <H1>FEATURE: <!--#echo var="FEAT_disable-take-fullname-in-addresses"--></H1>
28004
28005 Normally, when TakeAddr is used to copy an address or addresses
28006 from a message into an address book entry, Alpine will try to preserve
28007 the full name associated with each address in the list of addresses.
28008 The reason for this is so that if the entry is a list or later becomes a
28009 list, then information about the individual addresses in the list
28010 is preserved.
28011 If you would rather just have the simple addresses in the list of addresses,
28012 set this feature. For example, with the default setting you might
28013 see something like this in the ADDRESS BOOK editor after you type TakeAddr
28014 <P>
28015 <PRE>
28016  Nickname  : nick
28017  Fullname  : Bedrock Elders
28018  Fcc       :
28019  Comment   :
28020  Addresses : Fred Flintstone &lt;flint@bedrock.org&gt;,
28021              Barney Rubble &lt;rubble@bedrock.org&gt;
28022 </PRE>
28023 <P>
28024 but with this feature set it would look like
28025 <P>
28026 <PRE>
28027  Nickname  : nick
28028  Fullname  : Bedrock Elders
28029  Fcc       :
28030  Comment   :
28031  Addresses : flint@bedrock.org,
28032              rubble@bedrock.org
28033 </PRE>
28034 <P>
28035 instead. Note the difference in the Addresses field.
28036 <P>
28037 &lt;End of help on this topic&gt;
28038 </BODY></HTML>
28039 ====== h_config_print_from ======
28040 <HTML>
28041 <HEAD>
28042 <TITLE>FEATURE: <!--#echo var="FEAT_print-includes-from-line"--></TITLE>
28043 </HEAD>
28044 <BODY>
28045 <H1>FEATURE: <!--#echo var="FEAT_print-includes-from-line"--></H1>
28046
28047 If this feature is set, then the Berkeley-mail style From line is included
28048 at the start of each message that is printed.  This line looks something
28049 like the following, with the address replaced by the address from the
28050 From line of the message being printed:
28051 <P>
28052 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;From user@domain.somewhere.com Mon May 13
28053 14:11:06 1998
28054 <P>
28055 &lt;End of help on this topic&gt;
28056 </BODY>
28057 </HTML>
28058 ====== h_config_expanded_distlists ======
28059 <HTML>
28060 <HEAD>
28061 <TITLE>FEATURE: <!--#echo var="FEAT_expanded-view-of-distribution-lists"--></TITLE>
28062 </HEAD>
28063 <BODY>
28064 <H1>FEATURE: <!--#echo var="FEAT_expanded-view-of-distribution-lists"--></H1>
28065 If this feature is set, then distribution lists in the address book
28066 screen will always be expanded automatically.
28067 <P>
28068 &lt;End of help on this topic&gt;
28069 </BODY>
28070 </HTML>
28071 ====== h_config_compose_news_wo_conf ======
28072 <HTML>
28073 <HEAD>
28074 <TITLE>FEATURE: <!--#echo var="FEAT_compose-sets-newsgroup-without-confirm"--></TITLE>
28075 </HEAD>
28076 <BODY>
28077 <H1>FEATURE: <!--#echo var="FEAT_compose-sets-newsgroup-without-confirm"--></H1>
28078 This feature controls one aspect of Alpine's Composer.  If you enter the
28079 composer while reading a newsgroup, you will normally be prompted to
28080 determine whether you intend the new message to be posted to the current
28081 newsgroup or not.  If this feature is set, Alpine will not prompt you
28082 in this situation, and will assume that you do indeed wish to post
28083 to the newsgroup you are reading.
28084 <P>
28085 &lt;End of help on this topic&gt;
28086 </BODY>
28087 </HTML>
28088 ====== h_config_compose_rejects_unqual ======
28089 <HTML>
28090 <HEAD>
28091 <TITLE>FEATURE: <!--#echo var="FEAT_compose-rejects-unqualified-addrs"--></TITLE>
28092 </HEAD>
28093 <BODY>
28094 <H1>FEATURE: <!--#echo var="FEAT_compose-rejects-unqualified-addrs"--></H1>
28095
28096 This feature controls one aspect of the message composer; in particular,
28097 what happens when an unqualified name is entered into an address header.
28098 If set, unqualified names entered as addresses will be treated as errors
28099 unless they match an addressbook nickname.  Alpine will not attempt to turn
28100 them into complete addresses by adding your local domain.<P>
28101
28102 A complete (fully qualified) address is one containing a username followed
28103 by an &quot;@&quot; (&quot;at&quot;) symbol, followed by a domain name (e.g.
28104 &quot;jsmith@example.com&quot;).  An unqualified name is one <B>without</B>
28105 the &quot;@&quot; symbol and domain name (e.g. &quot;jsmith&quot;).
28106
28107 (See also <A HREF="h_address_format">Explanation of Address formats</A>.)
28108
28109 <P>
28110
28111 When you enter a fully qualified address, Alpine does not interpret or
28112 modify it, but simply passes it on to the mail-transport-agent (MTA) for
28113 your system.  Alpine conforms to the Internet standards governing message
28114 headers and will not send an unqualifed name to the MTA.  Therefore, when
28115 you enter an unqualified name, Alpine will normally attempt to turn it into
28116 a fully qualified address, first by checking to see if you have entered a
28117 matching nickname in your addressbook, or failing that, by simply adding
28118 your own domain to the name entered.  So if your address is
28119 &quot;jsmith@example.com&quot; and you enter &quot;fred&quot;, then (assuming
28120 &quot;fred&quot; is not a nickname in your addressbook), Alpine will turn
28121 that into &quot;fred@example.com&quot;.<P>
28122
28123 There are situations where it is not desirable for Alpine to interpret such
28124 unqualified names as valid (local) addresses.  For example, if &quot;fred&quot;
28125 turned out to be a typo (intended to be an addressbook nickname), but
28126 there actually was a &quot;fred&quot; in your local domain, the message might
28127 be mis-delivered without your realizing it.  In order to reduce the likelihood
28128 of such accidents, setting this feature will cause Alpine to treat such
28129 addresses as errors, and require that you explicitly enter the full local
28130 address (e.g. &quot;fred@example.com&quot;) or correct the name so that it
28131 matches an address book nickname.<P>
28132
28133 Consider this a safety feature against mis-directed mail.
28134 <P>
28135 <UL>
28136 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28137 </UL><P>
28138 &lt;End of help on this topic&gt;
28139 </BODY>
28140 </HTML>
28141 ====== h_config_quell_local_lookup ======
28142 <HTML>
28143 <HEAD>
28144 <TITLE>FEATURE: <!--#echo var="FEAT_quell-user-lookup-in-passwd-file"--></TITLE>
28145 </HEAD>
28146 <BODY>
28147 <H1>FEATURE: <!--#echo var="FEAT_quell-user-lookup-in-passwd-file"--></H1>
28148
28149 This feature controls an aspect of Alpine's Composer, and if needed, will
28150 usually be set by your system manager in Alpine's system-wide configuration
28151 file. Specifically, if this feature is set, Alpine will not attempt to look
28152 in the system password file to find a Full Name for the entered address.
28153 <P>
28154 Normally, names you enter into address fields (e.g. To: or Cc:) are
28155 checked against your address book(s) to see if they match an address book
28156 nickname.  Failing that, (in Unix Alpine) the name is then checked against
28157 the Unix password file.  If the entered name matches a username in the
28158 system password file, Alpine extracts the corresponding Full Name information
28159 for that individual, and adds that to the address being entered.
28160 <P>
28161 However, password file matching can have surprising (incorrect) results if
28162 other users of the system do not receive mail at the domain you are using.
28163 That is, if either the
28164 <A HREF="h_config_user_dom">&quot;<!--#echo var="VAR_user-domain"-->&quot;</A> or
28165 <A HREF="h_config_domain_name">&quot;<!--#echo var="VAR_use-only-domain-name"-->&quot;</A>
28166 option
28167 is set such that the administrative domain of other users on the system
28168 isn't accurately reflected, Alpine should be told that a passwd file match
28169 is coincidental, and Full Name info will be incorrect.  For example, a
28170 personal name from the password file could get falsely paired with the
28171 entered name as it is turned into an address in the configured domain.
28172 <P>
28173 If you are seeing this behavior, enabling this feature will prevent Unix
28174 Alpine from looking up names in the password file to find the Full Name
28175 for incomplete addresses you enter.<P>
28176 <UL>
28177 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28178 </UL>
28179 <P>
28180 &lt;End of help on this topic&gt;
28181 </BODY>
28182 </HTML>
28183 ====== h_config_tab_checks_recent ======
28184 <HTML>
28185 <HEAD>
28186 <TITLE>FEATURE: <!--#echo var="FEAT_tab-checks-recent"--></TITLE>
28187 </HEAD>
28188 <BODY>
28189 <H1>FEATURE: <!--#echo var="FEAT_tab-checks-recent"--></H1>
28190
28191 In a FOLDER LIST screen, the TAB key usually just changes which
28192 folder is highlighted.
28193 If this feature is set, then the TAB key will cause the number of
28194 recent messages and the total number of messages in the highlighted folder
28195 to be displayed instead.
28196
28197 <P>
28198 &lt;End of help on this topic&gt;
28199 </BODY>
28200 </HTML>
28201 ====== h_config_maildrops_preserve_state ======
28202 <HTML>
28203 <HEAD>
28204 <TITLE>FEATURE: <!--#echo var="FEAT_maildrops-preserve-state"--></TITLE>
28205 </HEAD>
28206 <BODY>
28207 <H1>FEATURE: <!--#echo var="FEAT_maildrops-preserve-state"--></H1>
28208
28209 This feature affects the way <A HREF="h_maildrop">Mail Drops</A> work.
28210 Normally, when mail is moved from a Mail Drop folder to a destination
28211 folder, it is delivered as new mail.
28212 Any Seen/New, Answered, Important/Flagged state that has changed will be
28213 ignored.
28214 All of the mail will be considered unSeen, unAnswered, and unImportant after
28215 it is moved.
28216 <P>
28217 If this feature is set, then the state changes that have been made
28218 to the messages in the Mail Drop folder will be preserved.
28219 <P>
28220 In any case, messages that are already marked Deleted when the
28221 mail is to be moved from the Mail Drop will be ignored.
28222 <P>
28223 &lt;End of help on this topic&gt;
28224 </BODY>
28225 </HTML>
28226 ====== h_config_preopen_stayopens ======
28227 <HTML>
28228 <HEAD>
28229 <TITLE>FEATURE: <!--#echo var="FEAT_preopen-stayopen-folders"--></TITLE>
28230 </HEAD>
28231 <BODY>
28232 <H1>FEATURE: <!--#echo var="FEAT_preopen-stayopen-folders"--></H1>
28233
28234 This feature is related to the option
28235 <A HREF="h_config_permlocked">&quot;<!--#echo var="VAR_stay-open-folders"-->&quot;</A>.
28236 Normally, Stay Open folders are only opened on demand, when the user
28237 asks to open them.
28238 From then on they are kept open for the duration of the session.
28239 However, if this feature is set, then the Stay Open folders will all be
28240 opened at startup, at the same time that the INBOX is opened.
28241
28242 <P>
28243 &lt;End of help on this topic&gt;
28244 </BODY>
28245 </HTML>
28246 ====== h_config_expunge_inbox ======
28247 <HTML>
28248 <HEAD>
28249 <TITLE>FEATURE: <!--#echo var="FEAT_offer-expunge-of-inbox"--></TITLE>
28250 </HEAD>
28251 <BODY>
28252 <H1>FEATURE: <!--#echo var="FEAT_offer-expunge-of-inbox"--></H1>
28253
28254 The INBOX is normally treated differently from regular folders in several
28255 ways.
28256 One of the differences is that the normal &quot;close&quot; sequence of
28257 events is deferred until Alpine is exited, instead of happening when you
28258 leave the INBOX to view another folder.
28259 The &quot;close&quot; sequence normally includes the Expunging
28260 of deleted messages
28261 (either automatically or after a prompt, controlled by the features
28262 <A HREF="h_config_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm"-->&quot;</A>,
28263 <A HREF="h_config_full_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm-everywhere"-->&quot;</A>, and
28264 <A HREF="h_config_expunge_manually"><!--#echo var="FEAT_expunge-only-manually"--></A>), and the
28265 handling of the
28266 <A HREF="h_config_read_message_folder"><!--#echo var="VAR_read-message-folder"--></A>.
28267
28268 <P>
28269 If this feature is set the &quot;close&quot; sequence handling will take
28270 place every time you leave the INBOX.
28271 The INBOX will still be kept open, but the offer to Expunge and the archiving
28272 to the <!--#echo var="VAR_read-message-folder"-->
28273 will take place each time you leave the INBOX instead of only once at the
28274 end of the session.
28275
28276 <P>
28277 &lt;End of help on this topic&gt;
28278 </BODY>
28279 </HTML>
28280 ====== h_config_expunge_stayopens ======
28281 <HTML>
28282 <HEAD>
28283 <TITLE>FEATURE: <!--#echo var="FEAT_offer-expunge-of-stayopen-folders"--></TITLE>
28284 </HEAD>
28285 <BODY>
28286 <H1>FEATURE: <!--#echo var="FEAT_offer-expunge-of-stayopen-folders"--></H1>
28287
28288 This feature is related to the option
28289 <A HREF="h_config_permlocked">&quot;<!--#echo var="VAR_stay-open-folders"-->&quot;</A>.
28290 Stay Open folders are treated differently from regular folders in several
28291 ways.
28292 One of the differences is that the normal &quot;close&quot; sequence of
28293 events is deferred until Alpine is exited, instead of happening when you
28294 leave the folder to view another folder.
28295 The &quot;close&quot; sequence normally includes the Expunging
28296 of deleted messages
28297 (either automatically or after a prompt, controlled by the features
28298 <A HREF="h_config_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm"-->&quot;</A>,
28299 <A HREF="h_config_full_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm-everywhere"-->&quot;</A>, and
28300 <A HREF="h_config_expunge_manually"><!--#echo var="FEAT_expunge-only-manually"--></A>), and the
28301 handling of
28302 <A HREF="h_config_archived_folders"><!--#echo var="VAR_incoming-archive-folders"--></A>.
28303
28304 <P>
28305 If this feature is set the &quot;close&quot; sequence handling will take
28306 place when you leave the Stay Open folder.
28307 The folder will still be kept open, but the offer to Expunge and the archiving
28308 will take place each time you leave the folder instead of only once at the
28309 end of the session.
28310 This feature does not affect the INBOX, which will still only be processed
28311 when you exit Alpine.
28312 However, there is a similar feature that affects only the INBOX called
28313 <A HREF="h_config_expunge_inbox">&quot;<!--#echo var="FEAT_offer-expunge-of-inbox"-->&quot;</A>.
28314
28315 <P>
28316 &lt;End of help on this topic&gt;
28317 </BODY>
28318 </HTML>
28319 ====== h_config_preserve_start_stop ======
28320 <HTML>
28321 <HEAD>
28322 <TITLE>FEATURE: <!--#echo var="FEAT_preserve-start-stop-characters"--></TITLE>
28323 </HEAD>
28324 <BODY>
28325 <H1>FEATURE: <!--#echo var="FEAT_preserve-start-stop-characters"--></H1>
28326
28327 This feature controls how special control key characters, typically
28328 Ctrl-S and Ctrl-Q, are interpreted when input to Alpine.  These characters
28329 are known as the "stop" and "start" characters and are sometimes used in
28330 communications paths to control data flow between devices that operate at
28331 different speeds.
28332
28333 <P>
28334
28335 By default, Alpine turns the system's handling of these special characters
28336 off except during printing.  However, if you see Alpine reporting input errors
28337 such as:
28338 <P>
28339 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[ Command "^Q" not defined for this screen.]
28340 <P>
28341 and, at the same time, see your display become garbled, then it is likely
28342 that setting this option will solve the problem.  Be aware, though, that
28343 enabling this feature will also cause Alpine to ostensibly "hang"
28344 whenever the Ctrl-S key combination is entered as the system is now
28345 interpreting such input as a "stop output" command.  To "start
28346 output"  again, simply type Ctrl-Q.
28347 <P>
28348 &lt;End of help on this topic&gt;
28349 </BODY>
28350 </HTML>
28351 ====== h_config_enable_incoming ======
28352 <HTML>
28353 <HEAD>
28354 <TITLE>FEATURE: <!--#echo var="FEAT_enable-incoming-folders"--></TITLE>
28355 </HEAD>
28356 <BODY>
28357 <H1>FEATURE: <!--#echo var="FEAT_enable-incoming-folders"--></H1>
28358
28359 Alpine's Incoming Message Folders collection
28360 provides a convenient way to access multiple incoming folders.
28361 It is also useful if you have accounts on multiple computers.
28362 <P>
28363
28364 If set, this feature defines a pseudo-folder collection called
28365 &quot;INCOMING MESSAGE FOLDERS&quot;.  Initially, the only folder included
28366 in this collection will be your INBOX, which will no longer show up in
28367 your Default folder collection.
28368 <P>
28369
28370 You may add more folders to the Incoming Message Folders collection by
28371 using the
28372 <!--chtml if pinemode="function_key"-->
28373 &quot;F10
28374 <!--chtml else-->
28375 &quot;A
28376 <!--chtml endif-->
28377 Add&quot; command in the FOLDER LIST screen.  You will be prompted for
28378 the host the folder is stored on (which defaults to the same host used
28379 for your INBOX), a nickname, and the actual folder name.  Once a set
28380 of Incoming Message Folders are defined, the TAB key (in MESSAGE INDEX
28381 or MESSAGE TEXT screens) may be used to scan the folders for those
28382 with Recent messages.  If you add more folders to
28383 your <!--#echo var="VAR_incoming-folders"--> collection, turning this feature back off will have
28384 no effect.
28385 <P>
28386 NOTE: Normally the software that actually delivers mail (the stuff that happens
28387 before Alpine is involved) is in a better position to do delivery filtering
28388 than is Alpine itself.
28389 If possible, you may want to look at programs such as
28390 &quot;filter&quot; or &quot;procmail&quot;, which are examples of delivery
28391 filtering programs.
28392 If you'd prefer to have Alpine do the filtering for you, you may set that
28393 up.
28394 Look <A HREF="h_rules_filter">here</A> for help with Alpine filtering.
28395 <P>
28396 <UL>
28397 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28398 </UL><P>
28399 &lt;End of help on this topic&gt;
28400 </BODY>
28401 </HTML>
28402 ====== h_config_enable_incoming_checking ======
28403 <HTML>
28404 <HEAD>
28405 <TITLE>FEATURE: <!--#echo var="FEAT_enable-incoming-folders-checking"--></TITLE>
28406 </HEAD>
28407 <BODY>
28408 <H1>FEATURE: <!--#echo var="FEAT_enable-incoming-folders-checking"--></H1>
28409
28410 This feature is only operational if you have enabled the optional
28411 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A> collection.
28412 If you do have Incoming Message Folders and you also set this feature,
28413 then the number of Unseen messages in each folder will be displayed
28414 in the FOLDER LIST screen for the Incoming Message Folders.
28415 The number of Unseen messages in a folder will be displayed in parentheses
28416 to the right of the name of each folder.
28417 If there are no Unseen messages in a folder then only the name
28418 is displayed, not a set of parentheses with zero inside them.
28419 A redraw command, Ctrl-L, can be used in the FOLDER LIST screen for
28420 the Incoming Message Folders to cause an immediate update.
28421 <P>
28422 If a check for Unseen messages fails for a particular folder then Alpine
28423 will no longer attempt to check that folder for the duration of the
28424 session and this will be indicated by a question mark inside the
28425 parentheses.
28426 <P>
28427 The features
28428 <A HREF="h_config_incoming_checking_total"><!--#echo var="FEAT_incoming-checking-includes-total"--></A>,
28429 <A HREF="h_config_incoming_checking_recent"><!--#echo var="FEAT_incoming-checking-uses-recent"--></A>,
28430 <A HREF="h_config_incoming_list"><!--#echo var="VAR_incoming-check-list"--></A>,
28431 <A HREF="h_config_incoming_interv"><!--#echo var="VAR_incoming-check-interval"--></A>,
28432 <A HREF="h_config_incoming_second_interv"><!--#echo var="VAR_incoming-check-interval-secondary"--></A>, and
28433 <A HREF="h_config_incoming_timeo"><!--#echo var="VAR_incoming-check-timeout"--></A>
28434 all affect how this feature behaves.
28435 <P>
28436 <UL>
28437 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28438 </UL><P>
28439 &lt;End of help on this topic&gt;
28440 </BODY>
28441 </HTML>
28442 ====== h_config_incoming_checking_total ======
28443 <HTML>
28444 <HEAD>
28445 <TITLE>FEATURE: <!--#echo var="FEAT_incoming-checking-includes-total"--></TITLE>
28446 </HEAD>
28447 <BODY>
28448 <H1>FEATURE: <!--#echo var="FEAT_incoming-checking-includes-total"--></H1>
28449
28450 This option has no effect unless the feature
28451 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
28452 is set, which in turn has no effect unless
28453 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
28454 is set.
28455 <P>
28456 When incoming folder checking is turned on the default is to display
28457 the number of unseen messages in each folder.
28458 More precisely, it is the number of undeleted unseen messages.
28459 Using this option you may also display the total number of messages
28460 in each folder.
28461 Instead of a single number representing the number of unseen messages
28462 you will get two numbers separated by a slash character.
28463 The first is the number of unseen messages and the second is the
28464 total number of messages.
28465 <P>
28466 You may also use the recent message count instead of the unseen message
28467 count by turning on the feature
28468 <A HREF="h_config_incoming_checking_recent"><!--#echo var="FEAT_incoming-checking-uses-recent"--></A>.
28469 <P>
28470 <UL>
28471 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28472 </UL><P>
28473 &lt;End of help on this topic&gt;
28474 </BODY>
28475 </HTML>
28476 ====== h_config_incoming_checking_recent ======
28477 <HTML>
28478 <HEAD>
28479 <TITLE>FEATURE: <!--#echo var="FEAT_incoming-checking-uses-recent"--></TITLE>
28480 </HEAD>
28481 <BODY>
28482 <H1>FEATURE: <!--#echo var="FEAT_incoming-checking-uses-recent"--></H1>
28483
28484 This option has no effect unless the feature
28485 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
28486 is set, which in turn has no effect unless
28487 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
28488 is set.
28489 <P>
28490 When incoming folder checking is turned on the default is to display
28491 the number of unseen messages in each folder.
28492 More precisely, it is the number of undeleted unseen messages.
28493 Using this option you may display the number of recent messages instead
28494 of the number of unseen messages.
28495 A message is only counted as recent if this is the first session to
28496 see it, so the recent count might be less than the unseen count.
28497 The difference between the two would be accounted for by the unseen messages
28498 in the folder which were there previously but have not been looked at yet.
28499 <P>
28500 If you simultaneously run more than one email client at a time
28501 (for example, you run more than one Alpine in parallel) then turning
28502 this feature on can cause some confusion.
28503 The confusion stems from the fact that each message is only considered to be
28504 recent in one session.
28505 That means that the counts of new messages may be different in the two
28506 Alpines running side by side, because each incoming message will only be
28507 counted as recent in one of the two sessions.
28508 <P>
28509 You may also display the total number of messages
28510 in each folder by using the
28511 <A HREF="h_config_incoming_checking_total"><!--#echo var="FEAT_incoming-checking-includes-total"--></A>
28512 option.
28513 <P>
28514 <UL>
28515 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28516 </UL><P>
28517 &lt;End of help on this topic&gt;
28518 </BODY>
28519 </HTML>
28520 ====== h_config_attach_in_reply ======
28521 <HTML>
28522 <HEAD>
28523 <TITLE>FEATURE: <!--#echo var="FEAT_include-attachments-in-reply"--></TITLE>
28524 </HEAD>
28525 <BODY>
28526 <H1>FEATURE: <!--#echo var="FEAT_include-attachments-in-reply"--></H1>
28527
28528 This feature controls an aspect of Alpine's Reply command. If set, any MIME
28529 attachments that were part of the original message will automatically be
28530 included in the Reply.
28531 <P>
28532 &lt;End of help on this topic&gt;
28533 </BODY>
28534 </HTML>
28535 ====== h_config_include_header =====
28536 <HTML>
28537 <HEAD>
28538 <TITLE>FEATURE: <!--#echo var="FEAT_include-header-in-reply"--></TITLE>
28539 </HEAD>
28540 <BODY>
28541 <H1>FEATURE: <!--#echo var="FEAT_include-header-in-reply"--></H1>
28542
28543 This feature controls an aspect of Alpine's Reply command. If set, and the
28544 original message is being included in the reply, then headers from that
28545 message will also be part of the reply.
28546 <P>
28547 &lt;End of help on this topic&gt;
28548 </HEAD>
28549 </HTML>
28550 ====== h_config_sig_at_bottom =====
28551 <HTML>
28552 <HEAD>
28553 <TITLE>FEATURE: <!--#echo var="FEAT_signature-at-bottom"--></TITLE>
28554 </HEAD>
28555 <BODY>
28556 <H1>FEATURE: <!--#echo var="FEAT_signature-at-bottom"--></H1>
28557
28558 This feature controls an aspect of Alpine's Reply command.  If this feature
28559 is set, and the original message is being included in the reply, then the
28560 contents of your signature file (if any) will be inserted after the included
28561 message.
28562 <P>
28563 This feature does not affect the results of a Forward command.
28564 <P>
28565 &lt;End of help on this topic&gt;
28566 </BODY>
28567 </HTML>
28568 ====== h_config_sigdashes =====
28569 <HTML>
28570 <HEAD>
28571 <TITLE>FEATURE: <!--#echo var="FEAT_enable-sigdashes"--></TITLE>
28572 </HEAD>
28573 <BODY>
28574 <H1>FEATURE: <!--#echo var="FEAT_enable-sigdashes"--></H1>
28575
28576 This feature enables support for the common USENET news convention
28577 of preceding a message signature with the special line consisting of
28578 the three characters &quot;--&nbsp;&quot; (i.e., dash, dash, and space).
28579
28580 <P>
28581 When enabled and a
28582 &quot;<A HREF="h_config_signature_file"><!--#echo var="VAR_signature-file"--></A>&quot; exists,
28583 Alpine will insert the special line before including the file's text (unless
28584 the special line already exists somewhere in the file's text).
28585
28586 <P>
28587 In addition, when you Reply or Followup to a message containing one of
28588 these special lines and choose to include its text, Alpine will observe
28589 the convention of not including text beyond the special line in your
28590 reply.
28591 If <A HREF="h_config_enable_full_hdr">&quot;Full Header&quot;</A>
28592 mode is enabled and turned on, then Alpine <EM>will</EM>
28593 include the text beyond the special line regardless of the setting of
28594 this feature.
28595
28596 <P>
28597 See also &quot;<a href="h_config_strip_sigdashes"><!--#echo var="FEAT_strip-from-sigdashes-on-reply"--></a>&quot;
28598 for a related feature.
28599
28600 <P>
28601 <UL>
28602 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28603 </UL><P>
28604 &lt;End of help on this topic&gt;
28605 </BODY>
28606 </HTML>
28607 ====== h_config_new_thread_blank_subject =====
28608 <HTML>
28609 <HEAD>
28610 <TITLE>FEATURE: <!--#echo var="FEAT_new-thread-on-blank-subject"--></TITLE>
28611 </HEAD>
28612 <BODY>
28613 <H1>FEATURE: <!--#echo var="FEAT_new-thread-on-blank-subject"--></H1>
28614
28615 When this feature is enabled (the default) Alpine will create a new thread
28616 every time that the subject line becomes empty at any time during composition.
28617
28618 <P>
28619 This behavior is particularly useful in case you are replying to a message.
28620 Replying to a message causes the message to be in the same thread than the
28621 original message that is being replied to. However, many authors want to create
28622 a new message (in a different thread) while replying to a message, and they do
28623 this by changing the full subject, by first deleting the original subject and
28624 typing the new subject of the current message.
28625
28626 <P>
28627 Enabling this feature causes that any time that the subject is deleted, the
28628 message being composed will be considered the first message of a new thread.
28629
28630 <P>
28631 <UL>
28632 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28633 </UL><P>
28634 &lt;End of help on this topic&gt;
28635 </BODY>
28636 </HTML>
28637 ====== h_config_strip_sigdashes =====
28638 <HTML>
28639 <HEAD>
28640 <TITLE>FEATURE: <!--#echo var="FEAT_strip-from-sigdashes-on-reply"--></TITLE>
28641 </HEAD>
28642 <BODY>
28643 <H1>FEATURE: <!--#echo var="FEAT_strip-from-sigdashes-on-reply"--></H1>
28644
28645 This feature doesn't do anything if the feature
28646 &quot;<A HREF="h_config_sigdashes"><!--#echo var="FEAT_enable-sigdashes"--></A>&quot; is turned on.
28647 However, if the &quot;<!--#echo var="FEAT_enable-sigdashes"-->&quot; feature is not turned on,
28648 then turning on this feature enables support for the convention
28649 of not including text beyond the sigdashes line when Replying or Following
28650 up to a message and including the text of that message.
28651 If <A HREF="h_config_enable_full_hdr">&quot;Full Header&quot;</A>
28652 mode is enabled and turned on, then Alpine <EM>will</EM>
28653 include the text beyond the special line regardless of the setting of
28654 this feature.
28655 <P>
28656 In other words, this is a way to turn on the signature stripping behavior
28657 without also turning on the dashes-adding behavior.
28658 <P>
28659 <UL>
28660 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28661 </UL><P>
28662 &lt;End of help on this topic&gt;
28663 </BODY>
28664 </HTML>
28665 ====== h_config_forward_as_attachment =====
28666 <HTML>
28667 <HEAD>
28668 <TITLE>FEATURE: <!--#echo var="FEAT_forward-as-attachment"--></TITLE>
28669 </HEAD>
28670 <BODY>
28671 <H1>FEATURE: <!--#echo var="FEAT_forward-as-attachment"--></H1>
28672
28673 This feature affects the way forwarded message text is handled.  When set, rather than
28674 include the text of the forwarded message below any additional text you provide in the
28675 composer, the forwarded message is attached in its entirety to the message you send.
28676 <P>
28677 This is useful in that it keeps the text you provide in the composer distinct from the
28678 text of the forwarded message.  Similarly, it allows the recipient to
28679 conveniently operate on the forwarded message.  For example, they might reply directly to
28680 the sender of the forwarded message, or process it as part of a spam report.
28681 <UL>
28682 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28683 </UL><P>
28684 &lt;End of help on this topic&gt;
28685 </BODY>
28686 </HTML>
28687 ====== h_config_preserve_field =====
28688 <HTML>
28689 <HEAD>
28690 <TITLE>FEATURE: <!--#echo var="FEAT_preserve-original-fields"--></TITLE>
28691 </HEAD>
28692 <BODY>
28693 <H1>FEATURE: <!--#echo var="FEAT_preserve-original-fields"--></H1>
28694
28695 This feature affects Alpine's behavior when one replies to a message.
28696 When you receive a message, some or all of the recipients of the message
28697 have been added to the To: and Cc: fields. If you reply to such message,
28698 and this feature is disabled, then the original sender of the message is
28699 added to the To: field, and all other recipients are added to the Cc:
28700 field, while your address is added to the From: field.
28701
28702 <P>
28703 However, if this feature is enabled, then Alpine will preserve the
28704 original fields as sent in the original message, so the Cc: and To:
28705 fields will be preserved. The sender's address will be added to the To:
28706 field, while your address is added to the From: field.
28707
28708 <P>
28709 The behavior of this feature is that replies to all messages will behave
28710 in the way described above. If you only intend this to happen on a per
28711 message basis, then keep this feature disabled, and when replying to a
28712 message you will see a new option in the menu for the &quot;Reply to all
28713 recipients?&quot; question. In this case, pressing &quot;p&quot; will
28714 make Alpine toggle its question so you can preserve the To: and Cc:
28715 fields for that message only.
28716
28717 <UL>
28718 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28719 </UL><P>
28720 &lt;End of help on this topic&gt;
28721 </BODY>
28722 </HTML>
28723 ====== h_config_sub_lists =====
28724 <HTML>
28725 <HEAD>
28726 <TITLE>FEATURE: <!--#echo var="FEAT_enable-partial-match-lists"--></TITLE>
28727 </HEAD>
28728 <BODY>
28729 <H1>FEATURE: <!--#echo var="FEAT_enable-partial-match-lists"--></H1>
28730
28731 This feature affects the subcommands available when Saving,
28732 or when Opening a new folder. If set, the subcommand ^X ListMatches will be
28733 available. This command allows you to type in a substring of the folder
28734 you are looking for and when you type ^X it will display all folders
28735 that contain that substring in their names.
28736 This feature is set by default.
28737
28738 <P>
28739 &lt;End of help on this topic&gt;
28740 </BODY>
28741 </HTML>
28742 ====== h_config_scramble_message_id =====
28743 <HTML>
28744 <HEAD>
28745 <TITLE>FEATURE: <!--#echo var="FEAT_scramble-message-id"--></TITLE>
28746 </HEAD>
28747 <BODY>
28748 <H1>FEATURE: <!--#echo var="FEAT_scramble-message-id"--></H1>
28749
28750 Normally the Message-ID header that Alpine generates when sending a message
28751 contains the name of the computer from which the message is being sent.
28752 Some believe that this hostname could be used by spammers or could
28753 be used by others for nefarious purposes.
28754 If this feature is set, that name will be transformed with a simple
28755 Rot13 transformation.
28756 The result will still have the correct syntax for a Message-ID but the
28757 part of the MessageID that is often a domain name will not be an actual
28758 domain name because the letters will be scrambled.
28759 <P>
28760 In addition, other information such as the name program, version, and
28761 a code for operating system used to build Alpine, will be encoded using
28762 the Rot13 transformation, except for the version number which will be
28763 encoded using a Rot5 transformation.
28764 <P>
28765 It is possible (but unlikely?) that some spam detection
28766 software will use that as a reason to reject the mail as spam.
28767 It has also been reported that some spam detection software uses the
28768 fact that there are no dots after the &quot;@&quot; as a reason to reject
28769 messages.
28770 If your PC-Alpine Message-ID is using a name without a dot that is because
28771 that is what Windows thinks is your &quot;Full computer name&quot;.
28772 The method used to set this varies from one type of Windows to another but
28773 check under Settings -> Control Panel -> System and
28774 look for Network Identification or Computer Name or something similar.
28775 How to set it is beyond the scope of Alpine.
28776
28777 <P>
28778 &lt;End of help on this topic&gt;
28779 </BODY>
28780 </HTML>
28781 ====== h_downgrade_multipart_to_text =====
28782 <HTML>
28783 <HEAD>
28784 <TITLE>FEATURE: <!--#echo var="FEAT_downgrade-multipart-to-text"--></TITLE>
28785 </HEAD>
28786 <BODY>
28787 <H1>FEATURE: <!--#echo var="FEAT_downgrade-multipart-to-text"--></H1>
28788
28789 <P>
28790 This feature affects Alpine's behavior when sending mail.  Internet
28791 standards require Alpine to translate all non-ASCII characters in
28792 messages that it sends using MIME encoding.  This encoding can be
28793 ostensibly broken for recipients if any agent between Alpine and the
28794 recipient, such as an email list expander, appends text to the
28795 message, such as list information or advertising.  When sending such
28796 messages Alpine attempts to protect such encoding by placing extra
28797 MIME boundaries around the message text.
28798 <P>
28799 These extra boundaries are invisible to recipients that
28800 use MIME-aware email programs (the vast majority).  However, if
28801 you correspond with users of email programs that are not MIME-aware,
28802 or do not handle the extra boundaries gracefully, you can
28803 use this feature to prevent Alpine from including the extra
28804 MIME information.  Of course, it will increase the likelihood
28805 that non-ASCII text you send may appear corrupt to the recipient.
28806 <P>
28807 &lt;End of help on this topic&gt;
28808 </BODY>
28809 </HTML>
28810 ====== h_config_show_sort =====
28811 <HTML>
28812 <HEAD>
28813 <TITLE>FEATURE: <!--#echo var="FEAT_show-sort"--></TITLE>
28814 </HEAD>
28815 <BODY>
28816 <H1>FEATURE: <!--#echo var="FEAT_show-sort"--></H1>
28817
28818 If this feature is set and there is sufficient space on the screen,
28819 a short indication of the current sort order will be
28820 added in the titlebar (the top line on the screen), before the name
28821 of the folder.
28822 For example, with the default Arrival sort in effect,
28823 the display would have the characters
28824
28825 <P><CENTER>[A]</CENTER><P>
28826
28827 added between the title of the screen and the folder name.
28828 The letters are the same as the letters you may type to manually
28829 sort a folder with the SortIndex command ($).
28830 The letters in the table below are the ones that may show
28831 up in the titlebar line.
28832 <P>
28833 <TABLE>
28834 <TR> <TD> A </TD> <TD> <EM>A</EM>rrival        </TD> </TR>
28835 <TR> <TD> S </TD> <TD> <EM>S</EM>ubject        </TD> </TR>
28836 <TR> <TD> F </TD> <TD> <EM>F</EM>rom           </TD> </TR>
28837 <TR> <TD> T </TD> <TD> <EM>T</EM>o             </TD> </TR>
28838 <TR> <TD> C </TD> <TD> <EM>C</EM>c             </TD> </TR>
28839 <TR> <TD> D </TD> <TD> <EM>D</EM>ate           </TD> </TR>
28840 <TR> <TD> Z </TD> <TD> si<EM>Z</EM>e           </TD> </TR>
28841 <TR> <TD> O </TD> <TD> <EM>O</EM>rderedsubject </TD> </TR>
28842 <TR> <TD> E </TD> <TD> scor<EM>E</EM>          </TD> </TR>
28843 <TR> <TD> H </TD> <TD> t<EM>H</EM>read         </TD> </TR>
28844 </TABLE>
28845 <P>
28846 If the sort order is Reversed, the letter above will be preceded by the letter
28847 &quot;R&quot;, for example
28848
28849 <P><CENTER>[RS]</CENTER><P>
28850
28851 means that a Reverse Subject sort is in effect.
28852 For the case where the sort is in Reverse Arrival order, the &quot;A&quot; is
28853 left out, and just an &quot;R&quot; is shown.
28854
28855 <P><CENTER>[R]</CENTER>
28856
28857 <P>
28858 &lt;End of help on this topic&gt;
28859 </BODY>
28860 </HTML>
28861 ====== h_config_disable_reset_disp =====
28862 <HTML>
28863 <HEAD>
28864 <TITLE>FEATURE: <!--#echo var="FEAT_disable-terminal-reset-for-display-filters"--></TITLE>
28865 </HEAD>
28866 <BODY>
28867 <H1>FEATURE: <!--#echo var="FEAT_disable-terminal-reset-for-display-filters"--></H1>
28868
28869 UNIX Alpine only.
28870 <P>
28871 This feature affects Alpine's behavior when using
28872 <A HREF="h_config_display_filters"><!--#echo var="VAR_display-filters"--></A>.
28873 Normally, before the display filter is run, the terminal mode is reset
28874 to what it was before you started Alpine.
28875 This may be necessary if the filter requires the use of the terminal.
28876 For example, it may need to interact with you.
28877 If you set this feature, then the terminal mode will not be reset.
28878 One thing that turning on this feature should fix is the coloring of
28879 <A HREF="h_config_quote_color">quoted text</A> in the message view, which
28880 breaks because the terminal reset resets the color state of the terminal.
28881
28882 <P>
28883 &lt;End of help on this topic&gt;
28884 </BODY>
28885 </HTML>
28886 ====== h_config_disable_sender =====
28887 <HTML>
28888 <HEAD>
28889 <TITLE>FEATURE: <!--#echo var="FEAT_disable-sender"--></TITLE>
28890 </HEAD>
28891 <BODY>
28892 <H1>FEATURE: <!--#echo var="FEAT_disable-sender"--></H1>
28893
28894 This feature affects Alpine's generation of the &quot;Sender:&quot; or
28895 <A HREF="h_config_use_sender_not_x">&quot;X-X-Sender&quot;</A>
28896 header fields.
28897 By default, Alpine will generate such a header in situations where the
28898 username or domain are not the same as
28899 the &quot;From:&quot; header on the message.
28900 With this feature set,
28901 no &quot;Sender:&quot; or &quot;X-X-Sender&quot; header will be generated.
28902 This may be desirable on a system that is virtually hosting many domains,
28903 and the sysadmin has other methods available for tracking a message to
28904 its originator.
28905 <P>
28906 See also <A HREF="h_config_allow_chg_from">&quot;<!--#echo var="FEAT_allow-changing-from"-->&quot;</A>.
28907
28908 <P>
28909 &lt;End of help on this topic&gt;
28910 </BODY>
28911 </HTML>
28912 ====== h_config_use_sender_not_x =====
28913 <HTML>
28914 <HEAD>
28915 <TITLE>FEATURE: <!--#echo var="FEAT_use-sender-not-x-sender"--></TITLE>
28916 </HEAD>
28917 <BODY>
28918 <H1>FEATURE: <!--#echo var="FEAT_use-sender-not-x-sender"--></H1>
28919
28920 Normally Alpine adds a header line
28921 labeled &quot;X-X-Sender&quot;, if the sender is
28922 different from the From: line.
28923 The standard specifies that this header
28924 line should be labeled &quot;Sender&quot;, not &quot;X-X-Sender&quot;.
28925 Setting this feature causes
28926 &quot;Sender&quot; to be used instead of &quot;X-X-Sender&quot;.
28927 <P>
28928 See also <A HREF="h_config_disable_sender">&quot;<!--#echo var="FEAT_disable-sender"-->&quot;</A>.
28929
28930 <P>
28931 &lt;End of help on this topic&gt;
28932 </BODY>
28933 </HTML>
28934 ====== h_config_use_fk =====
28935 <HTML>
28936 <HEAD>
28937 <TITLE>FEATURE: <!--#echo var="FEAT_use-function-keys"--></TITLE>
28938 </HEAD>
28939 <BODY>
28940 <H1>FEATURE: <!--#echo var="FEAT_use-function-keys"--></H1>
28941
28942 This feature specifies that Alpine will respond to function keys instead of
28943 the normal single-letter commands. In this mode, the key menus at the
28944 bottom of each screen will show function key designations instead of the
28945 normal mnemonic key.
28946
28947 <P>
28948 &lt;End of help on this topic&gt;
28949 </BODY>
28950 </HTML>
28951 ====== h_config_cancel_confirm =====
28952 <HTML>
28953 <HEAD>
28954 <TITLE>FEATURE: <!--#echo var="FEAT_compose-cancel-confirm-uses-yes"--></TITLE>
28955 </HEAD>
28956 <BODY>
28957 <H1>FEATURE: <!--#echo var="FEAT_compose-cancel-confirm-uses-yes"--></H1>
28958
28959 This feature affects what happens when you type ^C to cancel a composition.
28960 By default, if you attempt to cancel a composition by typing ^C, you will be
28961 asked to confirm the cancellation by typing a &quot;C&quot;
28962 for <EM>C</EM>onfirm.
28963 It logically ought to be a &quot;Y&quot; for <EM>Y</EM>es, but that is
28964 risky because the &quot;^C Y&quot; needed to cancel a message
28965 is close (on the keyboard) to the &quot;^X Y&quot; needed to send a message.
28966 <P>
28967 If this feature is set the confirmation asked for
28968 will be a &quot;<EM>Y</EM>es&quot;
28969 instead of a &quot;<EM>C</EM>onfirm&quot; response.
28970
28971 <P>
28972 &lt;End of help on this topic&gt;
28973 </BODY>
28974 </HTML>
28975 ====== h_config_compose_maps_del =====
28976 <HTML>
28977 <HEAD>
28978 <TITLE>FEATURE: <!--#echo var="FEAT_compose-maps-delete-key-to-ctrl-d"--></TITLE>
28979 </HEAD>
28980 <BODY>
28981 <H1>FEATURE: <!--#echo var="FEAT_compose-maps-delete-key-to-ctrl-d"--></H1>
28982
28983 This feature affects the behavior of the DELETE key.
28984 If set, Delete will be equivalent to ^D, and delete
28985 the current character.  Normally Alpine defines the Delete key
28986 to be equivalent to ^H, which deletes the <EM>previous</EM>
28987 character.
28988
28989 <P>
28990 &lt;End of help on this topic&gt;
28991 </BODY>
28992 </HTML>
28993 ====== h_config_compose_bg_post =====
28994 <HTML>
28995 <HEAD>
28996 <TITLE>FEATURE: <!--#echo var="FEAT_enable-background-sending"--></TITLE>
28997 </HEAD>
28998 <BODY>
28999 <H1>FEATURE: <!--#echo var="FEAT_enable-background-sending"--></H1>
29000
29001 This feature affects the behavior of Alpine's mail sending.  If set, this
29002 feature enables a subcommand in the composer's "Send?" confirmation
29003 prompt.  The subcommand allows you to tell Alpine to handle the actual
29004 posting in the background.  While this feature usually allows posting
29005 to appear to happen very fast, it has no affect on the actual delivery
29006 time it takes a message to arrive at its destination.
29007
29008 <P>
29009 Please Note:
29010 <OL>
29011  <LI>This feature will have no effect if the feature
29012        <A HREF="h_config_send_wo_confirm">&quot;<!--#echo var="FEAT_send-without-confirm"-->&quot;</A>
29013        is set.
29014  <LI>This feature isn't supported on all systems.  All DOS and Windows,
29015        as well as several Unix ports, do not recognize this feature.
29016  <LI>Error handling is significantly different when this feature is
29017         enabled.  Any message posting failure results in the message
29018         being appended to your &quot;Interrupted&quot; mail folder.  When you
29019         type the <A HREF="h_common_compose">C</A>ompose command,
29020         Alpine will notice this folder and
29021         offer to extract any messages contained.  Upon continuing a
29022         failed message, Alpine will display the nature of the failure
29023         in the status message line.
29024  <LI> <EM>WARNING</EM>: Under extreme conditions, it is possible
29025         for message data to
29026         get lost.  <EM>Do</EM> <EM>not</EM> enable this feature
29027         if you typically run close to any sort of disk-space limits or quotas.
29028 </OL>
29029 <P>
29030 &lt;End of help on this topic&gt;
29031 </BODY>
29032 </HTML>
29033 ====== h_config_compose_dsn =====
29034 <HTML>
29035 <HEAD>
29036 <TITLE>FEATURE: <!--#echo var="FEAT_enable-delivery-status-notification"--></TITLE>
29037 </HEAD>
29038 <BODY>
29039 <H1>FEATURE: <!--#echo var="FEAT_enable-delivery-status-notification"--></H1>
29040
29041 This feature affects the behavior of Alpine's mail sending.  If set, this
29042 feature enables a subcommand in the composer's &quot;Send?&quot; confirmation
29043 prompt.  The subcommand allows you to tell Alpine to request the type of
29044 Delivery Status Notification (DSN) that you would like.  Most users will
29045 be happy with the default, and need not enable this feature.
29046 <P>
29047 If the feature
29048 <A HREF="h_config_send_wo_confirm">&quot;<!--#echo var="FEAT_send-without-confirm"-->&quot;</A> is set,
29049 then this feature has no effect and the type of DSN is not selectable.
29050
29051 <P>
29052 Turning on this feature and then turning on the DSNOpts from the send
29053 prompt reveals four on-off toggles at the bottom of the screen.
29054 The &quot;X&quot; command toggles between NoErrRets and ErrRets.  NoErrRets requests
29055 that no notification be returned to you, even if there is a delivery
29056 failure.  The &quot;D&quot; key toggles between Delay and NoDelay.  This tells the
29057 server that you are willing (or not) to receive delay notifications, which
29058 happen when there is an unusual delay at some mail server (in that mail
29059 server's opinion).  The &quot;S&quot; key toggles between Success and NoSuccess.
29060 Success requests that you be sent a DSN message when the message is
29061 successfully delivered to the recipients mailbox.  Setting NoErrRets will
29062 automatically turn off Delay and Success notification, and will flip the
29063 toggles to show that.  Similarly, turning on Delay and/or Success will
29064 automatically toggle the &quot;X&quot; key to ErrRets.  The fourth command, the
29065 &quot;H&quot; key, toggles between RetHdrs and RetFull.  RetFull requests that
29066 the full message be returned in any failed DSN.  RetHdrs requests that
29067 only the headers be returned in any failed DSN.  Notice that this command
29068 applies only to failed delivery status reports.  For delay or success
29069 reports, the full message is never returned, only the headers are returned.
29070
29071 <P>
29072 If you don't enable the DSN feature or if you don't turn it on for a
29073 particular message, the default is that you will be notified about failures,
29074 you might be notified about delays, and you won't be notified about
29075 successes.  You will usually receive the full message back when there is
29076 a failure.
29077
29078 <P>
29079 If you turn on the DSNOpts the default is to return as much information as
29080 possible to you.  That is, by default, the Success and Delay options are
29081 turned on and the full message will be returned on failure.
29082
29083 <P>
29084 The sending prompt will display the current DSN request (if any) in a
29085 shorthand form.  It will be:
29086
29087 <P><CENTER>[Never]</CENTER>
29088
29089 <P>
29090 if you have requested NoErrRets.  Otherwise, it will look something like:
29091
29092 <P><CENTER>[FDS-Hdrs]</CENTER>
29093
29094 <P>
29095 The &quot;F&quot; will always be there, indicating that you will be notified
29096 of failures.  (Alpine doesn't provide a way to request no failure notification
29097 and at the same time request either success or delay notification.  The only
29098 way to request no failure notifications is to request no notifications at
29099 all with NoErrRets.)  The &quot;D&quot; and/or &quot;S&quot; will be present if you have
29100 requested Delay and/or Success notification.  If one of those is missing,
29101 that means you are requesting no notification of the corresponding type.
29102 After the dash it will say either Hdrs or Full.  Hdrs means to return only
29103 the headers and Full means to return the full message (applies to
29104 failure notifications only).
29105
29106 <P>
29107 NOTE: This feature relies on your system's mail transport agent or
29108 configured
29109 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>
29110 having the negotiation mechanism introduced in
29111 &quot;Extended SMTP&quot; (ESMTP) and the specific extension called
29112 &quot;Delivery Status Notification&quot; (DSN).  If the mail tranport agent you
29113 are using doesn't support DSN, a short warning will be shown to you on
29114 the message line at the bottom of the screen after you send your message,
29115 but your message will have been sent anyway.
29116
29117 <P>
29118 Note that DSNs don't provide a mechanism to request read receipts.  That
29119 is, if you request notification on success you are notified when the
29120 message is delivered to the mailbox, not when the message is read.
29121
29122 <P>
29123 ESMTP allows for graceful migration to upgraded mail transfer agents, but
29124 it is possible that this feature might cause problems for some servers.
29125
29126 <P>
29127 &lt;End of help on this topic&gt;
29128 </BODY>
29129 </HTML>
29130 ====== h_config_auto_zoom =====
29131 <HTML>
29132 <HEAD>
29133 <TITLE>FEATURE: <!--#echo var="FEAT_auto-zoom-after-select"--></TITLE>
29134 </HEAD>
29135 <BODY>
29136 <H1>FEATURE: <!--#echo var="FEAT_auto-zoom-after-select"--></H1>
29137
29138 This feature affects the behavior of the Select command.
29139 If set, the select command will automatically perform a zoom
29140 after the select is complete.
29141 This feature is set by default.
29142 <P>
29143 Some related help topics are
29144 <UL>
29145 <LI> <A HREF="h_mainhelp_aggops">Aggregate Operations</A>
29146 <LI> <A HREF="h_index_cmd_select">Selecting: Select and WhereIs/Select</A>,
29147 <LI> <A HREF="h_config_enable_agg_ops"><!--#echo var="FEAT_enable-aggregate-command-set"--></A>,
29148 <LI> <A HREF="h_config_auto_unzoom"><!--#echo var="FEAT_auto-unzoom-after-apply"--></A>, and
29149 <LI> <A HREF="h_config_auto_unselect"><!--#echo var="FEAT_auto-unselect-after-apply"--></A>.
29150 <LI> <A HREF="h_config_select_wo_confirm"><!--#echo var="FEAT_select-without-confirm"--></A>.
29151 </UL>
29152
29153 <P>
29154 &lt;End of help on this topic&gt;
29155 </BODY>
29156 </HTML>
29157 ====== h_config_auto_unzoom =====
29158 <HTML>
29159 <HEAD>
29160 <TITLE>FEATURE: <!--#echo var="FEAT_auto-unzoom-after-apply"--></TITLE>
29161 </HEAD>
29162 <BODY>
29163 <H1>FEATURE: <!--#echo var="FEAT_auto-unzoom-after-apply"--></H1>
29164
29165 This feature affects the behavior of the Apply command.  If set, and if
29166 you are currently looking at a Zoomed Index view of selected messages,
29167 the Apply command will do the operation you specify, but then will
29168 implicitly do an &quot;UnZoom&quot;, so that you will automatically be back in
29169 the normal Index view after the Apply.
29170 This feature is set by default.
29171
29172 <P>
29173 Some related help topics are
29174 <UL>
29175 <LI> <A HREF="h_mainhelp_aggops">Aggregate Operations</A>
29176 <LI> <A HREF="h_index_cmd_select">Selecting: Select and WhereIs/Select</A>,
29177 <LI> <A HREF="h_config_enable_agg_ops"><!--#echo var="FEAT_enable-aggregate-command-set"--></A>,
29178 <LI> <A HREF="h_config_auto_unselect"><!--#echo var="FEAT_auto-unselect-after-apply"--></A>.
29179 <LI> <A HREF="h_config_auto_zoom"><!--#echo var="FEAT_auto-zoom-after-select"--></A>, and
29180 <LI> <A HREF="h_config_select_wo_confirm"><!--#echo var="FEAT_select-without-confirm"--></A>.
29181 </UL>
29182 <P>
29183 &lt;End of help on this topic&gt;
29184 </BODY>
29185 </HTML>
29186 ====== h_config_auto_unselect =====
29187 <HTML>
29188 <HEAD>
29189 <TITLE>FEATURE: <!--#echo var="FEAT_auto-unselect-after-apply"--></TITLE>
29190 </HEAD>
29191 <BODY>
29192 <H1>FEATURE: <!--#echo var="FEAT_auto-unselect-after-apply"--></H1>
29193
29194 This feature affects the behavior of the Apply command.  If set,
29195 the Apply command will do the operation you specify, but then will
29196 implicitly do an &quot;UnSelect All&quot;, so that you will automatically be back in
29197 the normal Index view after the Apply.
29198
29199 <P>
29200 Some related help topics are
29201 <UL>
29202 <LI> <A HREF="h_mainhelp_aggops">Aggregate Operations</A>
29203 <LI> <A HREF="h_index_cmd_select">Selecting: Select and WhereIs/Select</A>,
29204 <LI> <A HREF="h_config_enable_agg_ops"><!--#echo var="FEAT_enable-aggregate-command-set"--></A>,
29205 <LI> <A HREF="h_config_auto_zoom"><!--#echo var="FEAT_auto-zoom-after-select"--></A>, and
29206 <LI> <A HREF="h_config_auto_unzoom"><!--#echo var="FEAT_auto-unzoom-after-apply"--></A>, and
29207 <LI> <A HREF="h_config_select_wo_confirm"><!--#echo var="FEAT_select-without-confirm"--></A>.
29208 </UL>
29209 <P>
29210 &lt;End of help on this topic&gt;
29211 </BODY>
29212 </HTML>
29213 ====== h_config_fast_recent =====
29214 <HTML>
29215 <HEAD>
29216 <TITLE>FEATURE: <!--#echo var="FEAT_enable-fast-recent-test"--></TITLE>
29217 </HEAD>
29218 <BODY>
29219 <H1>FEATURE: <!--#echo var="FEAT_enable-fast-recent-test"--></H1>
29220
29221 This feature controls the behavior of the TAB key when traversing folders
29222 in the optional
29223 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
29224 collection or in optional <!--#echo var="VAR_news-collections"-->.
29225
29226 <P>
29227 When the TAB
29228 (<A HREF="h_common_nextnew">NextNew</A>)
29229 key is pressed, the default behavior is to
29230 explicitly examine the status of the folder for the number of recent
29231 messages (messages delivered since the last time it was viewed).
29232 Depending on the size and number of messages in the folder, this test
29233 can be time consuming.
29234
29235 <P>
29236 Enabling this feature will cause Alpine to only test for the existence of
29237 any recent messages rather than to obtain the count.  This is much faster
29238 in many cases.  The downside is that you're not given the number of recent
29239 messages when prompted to view the next folder.
29240 If the feature
29241 <A HREF="h_config_tab_uses_unseen">&quot;<!--#echo var="FEAT_tab-uses-unseen-for-next-folder"-->&quot;</A>
29242 is turned on, then the present feature will have no effect.
29243
29244 <P>
29245 <UL>
29246 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29247 </UL><P>
29248 &lt;End of help on this topic&gt;
29249 </BODY>
29250 </HTML>
29251 ====== h_config_arrow_nav =====
29252 <HTML>
29253 <HEAD>
29254 <TITLE>FEATURE: <!--#echo var="FEAT_enable-arrow-navigation"--></TITLE>
29255 </HEAD>
29256 <BODY>
29257 <H1>FEATURE: <!--#echo var="FEAT_enable-arrow-navigation"--></H1>
29258
29259 This feature controls the behavior of the left and right arrow keys.
29260 If set, the left and right arrow keys will operate like the usual
29261 navigation keys &lt; and &gt;.
29262 This feature is set by default.
29263
29264 <P>
29265 If you set this feature, and do not like the changed behavior of the up/down
29266 arrow
29267 keys when navigating through the FOLDER LIST screen --
29268 <B>first</B> from column to column, if more than one folder is
29269 displayed per row,
29270 and <B>then</B> from row to row -- you may either also wish to set the feature
29271 &quot;<A HREF="h_config_relaxed_arrow_nav"><!--#echo var="FEAT_enable-arrow-navigation-relaxed"--></A>&quot;,
29272 &quot;<A HREF="h_config_single_list"><!--#echo var="FEAT_single-column-folder-list"--></A>&quot;, or
29273 use the ^P/^N (instead of up/down arrow) keys to move up/down the list of
29274 folders in each column.
29275 <P>
29276 <UL>
29277 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29278 </UL><P>
29279 &lt;End of help on this topic&gt;
29280 </BODY>
29281 </HTML>
29282 ====== h_config_relaxed_arrow_nav =====
29283 <HTML>
29284 <HEAD>
29285 <TITLE>FEATURE: <!--#echo var="FEAT_enable-arrow-navigation-relaxed"--></TITLE>
29286 </HEAD>
29287 <BODY>
29288 <H1>FEATURE: <!--#echo var="FEAT_enable-arrow-navigation-relaxed"--></H1>
29289
29290 This feature controls the behavior of the left, right, up and down
29291 arrow keys in the FOLDER LIST screen when the &quot;<A
29292 HREF="h_config_arrow_nav"><!--#echo var="FEAT_enable-arrow-navigation"--></A>&quot; feature is
29293 set.
29294 This feature is set by default.
29295
29296 <P>
29297
29298 When this feature is set, the left and right
29299 arrow keys in the FOLDER LIST screen
29300 move the highlight bar to the left or right, and the up and
29301 down arrows move it up or down.
29302
29303 <P>
29304 When the &quot;<!--#echo var="FEAT_enable-arrow-navigation"-->&quot; feature is set and this
29305 feature is not set;
29306 the left and right arrow keys in the Folder List screen strictly
29307 track the commands bound to the '&lt;' and '&gt;' keys, and the up
29308 and down arrow keys move the highlight bar to the previous and next
29309 folder or directory name.
29310
29311 <P>
29312 <UL>
29313 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29314 </UL><P>
29315 &lt;End of help on this topic&gt;
29316 </BODY>
29317 </HTML>
29318 ====== h_config_alt_compose_menu =====
29319 <HTML>
29320 <HEAD>
29321 <TITLE>FEATURE: <!--#echo var="FEAT_alternate-compose-menu"--></TITLE>
29322 </HEAD>
29323 <BODY>
29324 <H1>FEATURE: <!--#echo var="FEAT_alternate-compose-menu"--></H1>
29325
29326 This feature controls the menu that is displayed when Compose is selected.
29327 If set, a list of options will be presented, with each option representing
29328 the type of composition that could be used. This feature is most useful for
29329 users who want to avoid being prompted with each option separately, or who
29330 want to avoid the checking of remote postponed or form letter folders.
29331 The possible types of composition are:
29332
29333 <P>
29334 New, for starting a new composition. Note that if New is selected and roles
29335 are set, roles are checked for matches and applied according to the setting
29336 of the matching role.
29337
29338 <P>
29339 Interrupted, for continuing an interrupted composition. This option is only
29340 offered if an interrupted message folder is detected.
29341
29342 <P>
29343 Postponed, for continuing postponed compositions. This option is offered
29344 if a <!--#echo var="VAR_postponed-folder"--> is set in the config REGARDLESS OF whether or not
29345 the postponed folder actually exists. This option is especially handy
29346 for avoiding having to check for the existence of a remote postponed folder.
29347
29348 <P>
29349 Form, for using form letters. This option is offered if the <!--#echo var="VAR_form-letter-folder"-->
29350 is set in the config, and is not checked for existence for reasons similar
29351 to those explained by the postponed option.
29352
29353 <P>
29354 setRole, for selecting a role to apply to a composition.
29355
29356 <P>
29357 &lt;End of help on this topic&gt;
29358 </BODY>
29359 </HTML>
29360 ====== h_config_alt_role_menu =====
29361 <HTML>
29362 <HEAD>
29363 <TITLE>FEATURE: <!--#echo var="FEAT_alternate-role-menu"--></TITLE>
29364 </HEAD>
29365 <BODY>
29366 <H1>FEATURE: <!--#echo var="FEAT_alternate-role-menu"--></H1>
29367
29368 Normally the <A HREF="h_common_role">Role Command</A> allows you to choose
29369 a role and compose a new message using that role.
29370 When this feature is set, the role command will first ask whether you want to
29371 Compose a new message, Forward the current message, Reply to the
29372 current message, or Bounce the current message.
29373 If you are not in the MESSAGE INDEX and are not viewing a message,
29374 then there is no current message and the question will be skipped.
29375 After you have chosen to Compose, Forward, Reply, or Bounce you will
29376 then choose the role to be used.
29377 <P>
29378 When Bouncing the &quot;Set From&quot; address is used for the
29379 Resent-From header, the &quot;Set Fcc&quot; value is used for the Fcc
29380 provided that the option
29381 <A HREF="h_config_fcc_on_bounce">&quot;<!--#echo var="FEAT_fcc-on-bounce"-->&quot;</A> is turned on,
29382 and the &quot;Use SMTP Server&quot; value is used for the SMTP server, if
29383 set.
29384 Other actions of the role are ignored when Bouncing.
29385
29386 <P>
29387 &lt;End of help on this topic&gt;
29388 </BODY>
29389 </HTML>
29390 ====== h_config_always_spell_check =====
29391 <HTML>
29392 <HEAD>
29393 <TITLE>FEATURE: <!--#echo var="FEAT_spell-check-before-sending"--></TITLE>
29394 </HEAD>
29395 <BODY>
29396 <H1>FEATURE: <!--#echo var="FEAT_spell-check-before-sending"--></H1>
29397 <P>
29398 When this feature is set, every composed message will be spell-checked before
29399 being sent.
29400 <P>
29401 &lt;End of help on this topic&gt;
29402 </BODY>
29403 </HTML>
29404 ====== h_config_quell_asterisks =====
29405 <HTML>
29406 <HEAD>
29407 <TITLE>FEATURE: <!--#echo var="FEAT_suppress-asterisks-in-password-prompt"--></TITLE>
29408 </HEAD>
29409 <BODY>
29410 <H1>FEATURE: <!--#echo var="FEAT_suppress-asterisks-in-password-prompt"--></H1>
29411 <P>
29412 When you are running Alpine you will sometimes be asked for a password
29413 in a prompt on the third line from the bottom of the screen.
29414 Normally each password character you type will cause an asterisk to echo
29415 on the screen. That gives you some feedback to know that your typing is
29416 being recognized.
29417 There is a very slight security risk in doing it this way because someone
29418 watching over your shoulder might be able to see how many characters there
29419 are in your password.
29420 If you'd like to suppress the echoing of the asterisks set this feature.
29421 <P>
29422 &lt;End of help on this topic&gt;
29423 </BODY>
29424 </HTML>
29425 ====== h_config_quell_flowed_text =====
29426 <HTML>
29427 <HEAD>
29428 <TITLE>FEATURE: <!--#echo var="FEAT_quell-flowed-text"--></TITLE>
29429 </HEAD>
29430 <BODY>
29431 <H1>FEATURE: <!--#echo var="FEAT_quell-flowed-text"--></H1>
29432 <P>
29433 Alpine generates flowed text where possible.
29434 The method for generating flowed text is defined by
29435 <A HREF="http://www.ietf.org/rfc/rfc3676.txt">RFC 3676</A>,
29436 the benefit of doing so is
29437 to send message text that can properly be viewed both on normal width displays
29438 and on displays with smaller or larger than normal screen widths.
29439 With flowed text, a space at the end of a line tells the receiving mail
29440 client that the following line belongs to the same paragraph.
29441 Quoted text will also be affected, with only the innermost
29442 level of &quot;&gt;&quot; quoting being followed by a space.
29443 However, if you have changed the
29444 <A HREF="h_config_reply_indent_string">&quot;<!--#echo var="VAR_reply-indent-string"-->&quot;</A>
29445 so that it is not equal to the default value of &quot;&gt;&nbsp;&quot;, then
29446 quoted text will not be flowed.
29447 For this reason, we recommend that you leave your
29448 &quot;<!--#echo var="VAR_reply-indent-string"-->&quot; set to the default.
29449 <P>
29450 This feature turns off the generation of flowed text, as it might be
29451 desired to more tightly control how a message is displayed on the receiving end.
29452 <P>
29453 If this feature is <EM>not</EM> set, you can control on a message by message
29454 basis whether or not flowed text is generated.
29455 You do this by typing ^V at the Send confirmation prompt that you get
29456 after typing ^X to send a message.
29457 ^V is a toggle that turns flowing off and back on if typed again.
29458 If for some reason flowing cannot be done on a particular message, then the
29459 ^V command will not be available.
29460 This would be the case, for example, if this feature was set, or if your
29461 &quot;<!--#echo var="VAR_reply-indent-string"-->&quot; was set to a non-default value.
29462 If the feature
29463 <A HREF="h_config_send_wo_confirm">&quot;<!--#echo var="FEAT_send-without-confirm"-->&quot;</A> is set,
29464 then the opportunity to control on a message by message basis
29465 whether or not flowed text is generated is lost.
29466 <P>
29467 When this feature is not set and you have typed ^V to turn off flowing,
29468 the Send confirmation prompt will change to look like
29469 <P>
29470 <CENTER><SAMP>Send message (not flowed)?</SAMP></CENTER>
29471 <P>
29472 <A HREF="h_config_strip_ws_before_send">&quot;<!--#echo var="FEAT_strip-whitespace-before-send"-->&quot;</A> will
29473 also turn off the sending of flowed text messages, but it differs in that
29474 it also trims all trailing white space from a message before sending it.
29475 <P>
29476 If alternate editors are used extensively, be aware that a message will still
29477 be sent flowed if this feature is unset.  In most cases this will be fine,
29478 but if the editor has a &quot;flowed text&quot; mode, it would be best to
29479 use that.
29480 <P>
29481 &lt;End of help on this topic&gt;
29482 </BODY>
29483 </HTML>
29484 ====== h_config_strip_ws_before_send =====
29485 <HTML>
29486 <HEAD>
29487 <TITLE>FEATURE: <!--#echo var="FEAT_strip-whitespace-before-send"--></TITLE>
29488 </HEAD>
29489 <BODY>
29490 <H1>FEATURE: <!--#echo var="FEAT_strip-whitespace-before-send"--></H1>
29491 <P>
29492 By default, trailing whitespace is not stripped from
29493 a message before sending.  Trailing whitespace should have no effect on an
29494 email message, and in flowed text can aid in delimiting paragraphs.
29495 However, the old behavior of stripping trailing whitespace was in place
29496 to better deal with older clients that couldn't handle certain types of
29497 text encodings.  This feature restores the old behavior
29498 <P>
29499 Trailing whitespace is of aid to flowed-text-formatted messages, which are
29500 generated by default but can be turned off via the
29501 <A HREF="h_config_quell_flowed_text">&quot;<!--#echo var="FEAT_quell-flowed-text"-->&quot;</A> feature.
29502 <!--#echo var="FEAT_strip-whitespace-before-send"--> also has the effect of turning off sending
29503 of flowed text.
29504 <P>
29505 &lt;End of help on this topic&gt;
29506 </BODY>
29507 </HTML>
29508 ====== h_config_alt_reply_menu =====
29509 <HTML>
29510 <HEAD>
29511 <TITLE>FEATURE: <!--#echo var="FEAT_alternate-reply-menu"--></TITLE>
29512 </HEAD>
29513 <BODY>
29514 <H1>FEATURE: <!--#echo var="FEAT_alternate-reply-menu"--></H1>
29515
29516 Note that if this option is enabled, then the option
29517 <A HREF="h_config_auto_include_reply"><!--#echo var="FEAT_include-text-in-reply"--></A>
29518 is ignored. See below to understand why.
29519 <P>
29520 When you reply to a message, a series of questions are asked that
29521 determines how your reply will be handled by Alpine. This feature only
29522 affects the result of the first question you are asked, and its purpose is
29523 to set values that could override defaults set in Alpine's main
29524 configuration screen. As a result, this menu allows you to configure even
29525 more features than you would be able to do without this option. For
29526 example, this menu always allows you to override or select a <A
29527 HREF="h_rules_roles">Role</A> if you have defined one, or allows you to
29528 override your indent string, regardless of if you have enabled
29529 <A HREF="h_config_prefix_editing"><!--#echo var="FEAT_enable-reply-indent-string-editing"--></A>.
29530 The full list of options can be found below.
29531 <P>
29532 Here is an example of how this option works. After you press Reply,
29533 if you see &quot;A Inc Attach&quot; in the menu, it means that
29534 if you press &quot;A&quot;, then Alpine will include the attachments
29535 of the original message, and the default is not to include them.
29536 Conversely, if you see &quot;A No Attach&quot;
29537 then by pressing &quot;A&quot; Alpine will not include
29538 attachments in your reply, and the default is that Alpine will
29539 include them in your reply. The value that you see when you
29540 start your reply is controlled by the option
29541 <A HREF="h_config_attach_in_reply">
29542 <!--#echo var="FEAT_include-attachments-in-reply"-->
29543 </A>. If the feature is enabled, then Alpine will display
29544 &quot;A No Attach&quot; to override the default behavior. You can
29545 toggle between the two values of this option by pressing &quot;A&quot;.
29546 Remember that the value that you see in the menu is the action that will
29547 be done when you press the associated command.
29548 <P>
29549 Below are your options:
29550 <OL>
29551 <LI><B>A</B>: This determines if Alpine will include or not the
29552 attachments sent to you in the message that you are replying to. The default
29553 is to use the value of the configuration option
29554 <A HREF="h_config_attach_in_reply"><!--#echo var="FEAT_include-attachments-in-reply"--></A> and can be overriden by using this command.
29555
29556 <LI><B>H</B>: This command determines if the headers of a message are
29557 included in the body of the message that is being replied to. By default
29558 Alpine will use the value of the configuration option
29559 <A HREF="h_config_include_header"><!--#echo var="FEAT_include-header-in-reply"--></A>.
29560 Observe that by toggling this option to include headers, text will be toggled
29561 to be included by default.
29562
29563 <LI><B>R</B>: Can be used to set a role different from the default.
29564
29565 <LI><B>S</B>: Determines if Alpine will strip the signature from a
29566 message. The default is to strip the signature when the message is not
29567 viewed in headers mode, and you either have enabled
29568 <A HREF="h_config_sigdashes"><!--#echo var="FEAT_enable-sigdashes"--></A>
29569 or
29570 <A HREF="h_config_strip_sigdashes"><!--#echo var="FEAT_strip-from-sigdashes-on-reply"--></A>.
29571
29572 <LI><B>Ctrl-R</B>: Can be used to edit the
29573 <A HREF="h_config_reply_indent_string">&quot;<!--#echo var="VAR_reply-indent-string"-->&quot;</A>.
29574 </OL>
29575 <P>
29576 In order to include the text of the original message in the reply
29577 you either need to press 'y' to include the original text, or 'n' to
29578 exclude it from the reply. Pressing return will execute the default
29579 action, which is to include text only if the option
29580 <A HREF="h_config_auto_include_reply"><!--#echo var="FEAT_include-text-in-reply"--></A>
29581 is enabled. However, notice that the default is to include text if you edit the
29582 reply indent string or if you explicitly set through this menu that you
29583 want headers included in the reply message.
29584
29585 <P>
29586 &lt;End of help on this topic&gt;
29587 </BODY>
29588 </HTML>
29589 ====== h_config_del_from_dot =====
29590 <HTML>
29591 <HEAD>
29592 <TITLE>FEATURE: <!--#echo var="FEAT_compose-cut-from-cursor"--></TITLE>
29593 </HEAD>
29594 <BODY>
29595 <H1>FEATURE: <!--#echo var="FEAT_compose-cut-from-cursor"--></H1>
29596
29597 This feature controls the behavior of the Ctrl-K command in the composer.
29598 If set, ^K will cut from the current cursor position to the end of the line,
29599 rather than cutting the entire line.
29600
29601 <P>
29602 &lt;End of help on this topic&gt;
29603 </BODY>
29604 </HTML>
29605 ====== h_config_print_index =====
29606 <HTML>
29607 <HEAD>
29608 <TITLE>FEATURE: <!--#echo var="FEAT_print-index-enabled"--></TITLE>
29609 </HEAD>
29610 <BODY>
29611 <H1>FEATURE: <!--#echo var="FEAT_print-index-enabled"--></H1>
29612
29613 This feature controls the behavior of the Print command when in the
29614 MESSAGE INDEX screen.  If set, the print command will give you a prompt
29615 asking if you wish to print the message index, or the currently highlighted
29616 message. If not set, the message will be printed.
29617
29618 <P>
29619 &lt;End of help on this topic&gt;
29620 </BODY>
29621 </HTML>
29622 ====== h_config_allow_talk =====
29623 <HTML>
29624 <HEAD>
29625 <TITLE>FEATURE: <!--#echo var="FEAT_allow-talk"--></TITLE>
29626 </HEAD>
29627 <BODY>
29628 <H1>FEATURE: <!--#echo var="FEAT_allow-talk"--></H1>
29629
29630 UNIX Alpine only.
29631 <P>
29632 By default, permission for others to &quot;talk&quot; to your terminal is turned
29633 off when you are running Alpine.  When this feature is set, permission is
29634 instead turned on.  If enabled, you may see unexpected messages in the
29635 middle of your Alpine screen from someone attempting to contact you via the
29636 &quot;talk&quot; program.
29637
29638 <P>
29639 NOTE: The &quot;talk&quot; program has nothing to do with Alpine or email.  The
29640 talk daemon on your system will attempt to print a message on your screen
29641 when someone else is trying to contact you.  If you wish to see these
29642 messages while you are running Alpine, you should enable this feature.
29643
29644 <P>
29645 If you do enable this feature and see a &quot;talk&quot; message, you must
29646 suspend or quit Alpine before you can respond.
29647
29648 <P>
29649 &lt;End of help on this topic&gt;
29650 </BODY>
29651 </HTML>
29652 ====== h_config_send_filter_dflt =====
29653 <HTML>
29654 <HEAD>
29655 <TITLE>FEATURE: <!--#echo var="FEAT_compose-send-offers-first-filter"--></TITLE>
29656 </HEAD>
29657 <BODY>
29658 <H1>FEATURE: <!--#echo var="FEAT_compose-send-offers-first-filter"--></H1>
29659 If you have <A HREF="h_config_sending_filter">&quot;<!--#echo var="VAR_sending-filters"-->&quot;</A>
29660 configured, setting this feature will cause
29661 the first filter in the <!--#echo var="VAR_sending-filters"--> list to be offered as the default
29662 instead of unfiltered, the usual default.
29663 <P>
29664 <UL>
29665 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29666 </UL><P>
29667 &lt;End of help on this topic&gt;
29668 </BODY>
29669 </HTML>
29670 ====== h_config_custom_print =====
29671 <HTML>
29672 <HEAD>
29673 <TITLE>FEATURE: <!--#echo var="FEAT_print-offers-custom-cmd-prompt"--></TITLE>
29674 </HEAD>
29675 <BODY>
29676 <H1>FEATURE: <!--#echo var="FEAT_print-offers-custom-cmd-prompt"--></H1>
29677
29678 When this feature is set, the print command will have an additional
29679 subcommand called "C CustomPrint".  If selected, you will have
29680 the opportunity to enter any system print command --instead of being
29681 restricted to using those that have been previously configured in the
29682 printer setup menu.
29683 <P>
29684
29685 &lt;End of help on this topic&gt;
29686 </BODY>
29687 </HTML>
29688 ====== h_config_enable_dot_files =====
29689 <HTML>
29690 <HEAD>
29691 <TITLE>FEATURE: <!--#echo var="FEAT_enable-dot-files"--></TITLE>
29692 </HEAD>
29693 <BODY>
29694 <H1>FEATURE: <!--#echo var="FEAT_enable-dot-files"--></H1>
29695
29696 When this feature is set, files beginning with dot (".") will be
29697 visible in the file browser.  For example, you'll be able to select them
29698 when using the browser to add an attachment to a message.
29699 <P>
29700 &lt;End of help on this topic&gt;
29701 </BODY>
29702 </HTML>
29703 ====== h_config_enable_dot_folders =====
29704 <HTML>
29705 <HEAD>
29706 <TITLE>FEATURE: <!--#echo var="FEAT_enable-dot-folders"--></TITLE>
29707 </HEAD>
29708 <BODY>
29709 <H1>FEATURE: <!--#echo var="FEAT_enable-dot-folders"--></H1>
29710
29711 When this feature is set, folders beginning with dot (".") may be added
29712 and viewed.
29713 <P>
29714 &lt;End of help on this topic&gt;
29715 </BODY>
29716 </HTML>
29717 ====== h_config_ff_between_msgs =====
29718 <HTML>
29719 <HEAD>
29720 <TITLE>FEATURE: <!--#echo var="FEAT_print-formfeed-between-messages"--></TITLE>
29721 </HEAD>
29722 <BODY>
29723 <H1>FEATURE: <!--#echo var="FEAT_print-formfeed-between-messages"--></H1>
29724
29725 Setting this feature causes a formfeed to be printed between messages when
29726 printing multiple messages (with Apply Print command).
29727 <P>
29728 &lt;End of help on this topic&gt;
29729 </BODY>
29730 </HTML>
29731 ====== h_config_blank_keymenu =====
29732 <HTML>
29733 <HEAD>
29734 <TITLE>FEATURE: <!--#echo var="FEAT_disable-keymenu"--></TITLE>
29735 </HEAD>
29736 <BODY>
29737 <H1>FEATURE: <!--#echo var="FEAT_disable-keymenu"--></H1>
29738
29739 If this feature is set the command key menu that normally appears on the
29740 bottom two lines of the screen will not usually be there.  Asking for
29741 help with ^G or ? will cause the key menu to appear instead of causing
29742 the help message to come up.  If you want to actually see the help text,
29743 another ^G or ? will show it to you.  After the key menu has popped
29744 up with the help key it will remain there for an O for Other command but
29745 disappear if any other command is typed.
29746 <P>
29747 &lt;End of help on this topic&gt;
29748 </BODY>
29749 </HTML>
29750 ====== h_config_enable_mouse =====
29751 <HTML>
29752 <HEAD>
29753 <TITLE>FEATURE: <!--#echo var="FEAT_enable-mouse-in-xterm"--></TITLE>
29754 </HEAD>
29755 <BODY>
29756 <H1>FEATURE: <!--#echo var="FEAT_enable-mouse-in-xterm"--></H1>
29757
29758 This feature controls whether or not an X terminal mouse can be used with
29759 Alpine.  If set, and the $DISPLAY variable indicates that an X terminal is
29760 being used, the left mouse button on the mouse can be used to select text
29761 or commands.
29762 Clicking on a command at the bottom of the screen will behave as if you had
29763 typed that command.
29764 Clicking on an index line will move the current message highlight to
29765 that line.
29766 Double-clicking on an index line will view the message.
29767 Double-clicking on a link will view the link.
29768 <P>
29769 This type of mouse support will also work in some terminal emulators which are
29770 not actually X terminals, but which have extra code to support the xterm
29771 style mouse.
29772 For those emulators you not only need to turn this feature on but you also
29773 have to set the $DISPLAY environment variable even though it isn't needed
29774 for your terminal.
29775 That will cause Alpine to think that it is an xterm and to properly interpret the
29776 escape sequences sent by the mouse.
29777 <P>
29778 Note: if this feature is set, the behavior of X terminal cut-and-paste is
29779 also modified.  It is sometimes possible to hold the shift key down while clicking
29780 left or middle mouse buttons for the normal xterm cut/paste operations.
29781 There is also an Alpine command to toggle this mode on or off.
29782 The command is Ctrl-&#92; (Control-backslash).
29783 <P>
29784 &lt;End of help on this topic&gt;
29785 </BODY>
29786 </HTML>
29787 ====== h_config_enable_xterm_newmail =====
29788 <HTML>
29789 <HEAD>
29790 <TITLE>FEATURE: <!--#echo var="FEAT_enable-newmail-in-xterm-icon"--></TITLE>
29791 </HEAD>
29792 <BODY>
29793 <H1>FEATURE: <!--#echo var="FEAT_enable-newmail-in-xterm-icon"--></H1>
29794
29795 This feature controls whether or not Alpine will attempt to announce new
29796 mail arrival when it is running in an X terminal window and that window
29797 is iconified.  If set, and the $DISPLAY variable indicates that an X
29798 terminal is being used, Alpine will send appropriate escape sequences to
29799 the X terminal to modify the label on Alpine's icon to indicate that new
29800 mail has arrived. Alpine will also modify the Alpine window's title to
29801 indicate new mail.
29802 See also <a href="h_config_enable_newmail_short_text"><!--#echo var="FEAT_enable-newmail-short-text-in-icon"--></a>.
29803 <P>
29804 &lt;End of help on this topic&gt;
29805 </BODY></HTML>
29806 ====== h_config_enable_newmail_short_text =====
29807 <HTML>
29808 <HEAD>
29809 <TITLE>FEATURE: <!--#echo var="FEAT_enable-newmail-short-text-in-icon"--></TITLE>
29810 </HEAD>
29811 <BODY>
29812 <H1>FEATURE: <!--#echo var="FEAT_enable-newmail-short-text-in-icon"--></H1>
29813
29814 This feature controls the text to be displayed in an icon in the event
29815 of a new message arrival.  Normally, the message will
29816 be the one that is displayed on the screen.  This feature shortens the
29817 message to a count of the number of new messages in brackets.  This may be
29818 more useful for those who use the window's title bar in the task bar as a
29819 new mail indicator.  This feature is only useful if the
29820 <A HREF="h_config_enable_xterm_newmail"><!--#echo var="FEAT_enable-newmail-in-xterm-icon"--></A>
29821 feature is also set.  Like the <!--#echo var="FEAT_enable-newmail-in-xterm-icon"-->
29822 feature, this feature is only relevant when run in an xterm environment.
29823 <P>
29824 &lt;End of help on this topic&gt;
29825 </BODY></HTML>
29826 ====== h_config_copy_to_to_from =====
29827 <HTML>
29828 <HEAD>
29829 <TITLE>FEATURE: <!--#echo var="FEAT_copy-to-address-to-from-if-it-is-us"--></TITLE>
29830 </HEAD>
29831 <BODY>
29832 <H1>FEATURE: <!--#echo var="FEAT_copy-to-address-to-from-if-it-is-us"--></H1>
29833
29834 This feature affects the From address used when Replying to a message.
29835 It is probably only useful if you have some
29836 <a href="h_config_alt_addresses"><!--#echo var="VAR_alt-addresses"--></a>
29837 defined.
29838 When enabled, it checks to see if any of the addresses in the To or Cc
29839 fields of the message you are replying to is one of your addresses.
29840 If it is, and there is only one of them, then that address is used as
29841 the From address in the message you are composing.
29842 In other words, you will be using a From address that is the same
29843 as the To address that was used to get the mail to you in the first place.
29844
29845 <P>
29846 If a role is being used and it has a From address defined, that From address will
29847 be used rather than the one derived from this feature.
29848
29849 <P>
29850 <UL>
29851 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29852 </UL><P>
29853 &lt;End of help on this topic&gt;
29854 </BODY>
29855 </HTML>
29856 ====== h_config_prefix_editing =====
29857 <HTML>
29858 <HEAD>
29859 <TITLE>FEATURE: <!--#echo var="FEAT_enable-reply-indent-string-editing"--></TITLE>
29860 </HEAD>
29861 <BODY>
29862 <H1>FEATURE: <!--#echo var="FEAT_enable-reply-indent-string-editing"--></H1>
29863
29864 This feature affects the Reply command's &quot;Include original message
29865 in Reply?&quot; prompt.  When enabled, it causes the
29866 &quot;Edit Indent String&quot; sub-command to appear which allows
29867 you to edit the string Alpine would otherwise use to denote included
29868 text from the message being replied to.<P>
29869
29870 Thus, you can change Alpine's default message quote character (usually
29871 an angle bracket) on a per message basis. So you could change your quoted message to
29872 look, for example, like this:<p>
29873
29874 <pre>On Tues, 26 Jan 1999, John Q. Smith wrote:
29875
29876 John: I just wanted to say hello and to congratulate you
29877 John: on a job well done!</pre><p>
29878
29879 The configuration option
29880 <A HREF="h_config_reply_indent_string">&quot;<!--#echo var="VAR_reply-indent-string"-->&quot;</A>
29881 may be used to change what appears as the default string to be edited.
29882 <P>
29883 NOTE: Edited <!--#echo var="VAR_reply-indent-string"--> only apply to the message
29884 currently being replied to.
29885 <P>
29886 If you change your <!--#echo var="VAR_reply-indent-string"-->
29887 so that it is not equal to the default value of &quot;&gt;&nbsp;&quot;, then
29888 quoted text will not be flowed
29889 (<A HREF="h_config_quell_flowed_text">Flowed Text</A>)
29890 when you reply.
29891 For this reason, we recommend that you leave your <!--#echo var="VAR_reply-indent-string"-->
29892 set to the default value.
29893 <P>
29894 <UL>
29895 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29896 </UL><P>
29897 &lt;End of help on this topic&gt;
29898 </BODY>
29899 </HTML>
29900 ====== h_config_enable_search_and_repl =====
29901 <HTML>
29902 <HEAD>
29903 <TITLE>FEATURE: <!--#echo var="FEAT_enable-search-and-replace"--></TITLE>
29904 </HEAD>
29905 <BODY>
29906 <H1>FEATURE: <!--#echo var="FEAT_enable-search-and-replace"--></H1>
29907
29908 This feature modifies the behavior of Alpine's composer.  Setting this
29909 feature causes Alpine to offer the "^R Replace" subcommand, which
29910 allows you to search and replace text strings in a message you are composing,
29911 inside the "^W Where is" command.
29912
29913 <P>
29914
29915 To search and replace text, first enter the text to be replaced at the
29916 "Search: " prompt.  Then, rather than pressing Enter to just search for that
29917 text, press ^R, which turns the prompt into
29918
29919 <P>
29920
29921 Search (to replace):
29922
29923 <P>
29924
29925 and then press Enter.  The cursor will highlight the first occurrence
29926 of the text string you entered, and the prompt will show:
29927
29928 <P>
29929
29930 Replace "<your text string>" with :
29931
29932 <P>
29933
29934 where <your text string> is what you entered at the previous prompt;
29935 here, enter the replacement text.  To only replace the highlighted
29936 occurrence, simply press Enter now; to replace all occurrences in the
29937 message, press ^X (Repl All), then Enter.  You will then be asked to confirm
29938 each replacement.
29939
29940 <P>
29941
29942 The command ^R toggles between "Replace" and "Don't Replace"; its subcommand
29943 ^X toggles between "Replace All" and "Replace One."
29944
29945 <P>
29946
29947 If you previously searched for text in a message, it will be offered for
29948 re-use as part of the prompt, shown in [ ] brackets.
29949
29950 <P>
29951 &lt;End of help on this topic&gt;
29952 </BODY>
29953 </HTML>
29954 ====== h_config_enable_view_attach =====
29955 <HTML>
29956 <HEAD>
29957 <TITLE>FEATURE: <!--#echo var="FEAT_enable-msg-view-attachments"--></TITLE>
29958 </HEAD>
29959 <BODY>
29960 <H1>FEATURE: <!--#echo var="FEAT_enable-msg-view-attachments"--></H1>
29961
29962 This feature modifies the behavior of Alpine's MESSAGE TEXT screen.
29963 Setting this feature causes Alpine to present attachments in boldface.
29964 The first available attachment is displayed in inverse.  This is the
29965 "selected" attachment.  Pressing RETURN will cause Alpine to display
29966 the selected attachment.  Use the arrow keys to change which of the
29967 attachments displayed in boldface is the current selection.
29968
29969 <P>
29970
29971 Speaking of arrow keys, the Up and Down Arrows will select the next
29972 and previous attachments if one is available on the screen for selection.
29973 Otherwise, they will simply adjust the viewed text one line up or down.
29974
29975 <P>
29976
29977 Similarly, when selectable items are present in a message, the Ctrl-F key
29978 can be used to select the next item in the message independent of which
29979 portion of the viewed message is currently displayed. The Ctrl-B key can
29980 be used to select the previous item in the same way.
29981 <P>
29982 &lt;End of help on this topic&gt;
29983 </BODY>
29984 </HTML>
29985 ====== h_config_enable_y_print =====
29986 <HTML>
29987 <HEAD>
29988 <TITLE>FEATURE: <!--#echo var="FEAT_enable-print-via-y-command"--></TITLE>
29989 </HEAD>
29990 <BODY>
29991 <H1>FEATURE: <!--#echo var="FEAT_enable-print-via-y-command"--></H1>
29992
29993 This feature modifies the behavior of Alpine's Print command.
29994 <P>
29995 By default, Alpine's print command is available by pressing the "%" key.
29996 (This command is a substantial change from Pine versions before 4.00 --
29997 where the print command was "Y" -- based on numerous complaints about
29998 printing being invoked inadvertently, since Y also means "Yes.")
29999
30000 <P>
30001
30002 This feature is supplied to mitigate any disruption or anxiety users
30003 might feel as a result of this change.
30004
30005 <P>
30006
30007 Enabling this feature will cause Alpine to recognize both the old
30008 command, "Y" for Prynt, as well the new "%" method for invoking
30009 printing.  Note, key menu labels are not changed as a result of
30010 enabling this feature.
30011
30012 <P>
30013
30014 &lt;End of help on this topic&gt;
30015 </BODY>
30016 </HTML>
30017 ====== h_config_enable_lessthan_exit =====
30018 <HTML>
30019 <HEAD>
30020 <TITLE>FEATURE: <!--#echo var="FEAT_enable-exit-via-lessthan-command"--></TITLE>
30021 </HEAD>
30022 <BODY>
30023 <H1>FEATURE: <!--#echo var="FEAT_enable-exit-via-lessthan-command"--></H1>
30024
30025 If this feature is set, then on screens where there is an Exit command
30026 but no < command, the < key will perform the same function as the Exit
30027 command.
30028 This feature is set by default.
30029 <P>
30030 &lt;End of help on this topic&gt;
30031 </BODY>
30032 </HTML>
30033 ====== h_config_enable_view_url =====
30034 <HTML>
30035 <HEAD>
30036 <TITLE>FEATURE: <!--#echo var="FEAT_enable-msg-view-urls"--></TITLE>
30037 </HEAD>
30038 <BODY>
30039 <H1>FEATURE: <!--#echo var="FEAT_enable-msg-view-urls"--></H1>
30040 This feature modifies the behavior of Alpine's MESSAGE TEXT screen.
30041 When this feature is set (the default) Alpine will select possible URLs from the
30042 displayed text and display them in boldface for selection.
30043 <P>
30044 The first available URL is displayed in inverse.  This is the
30045 &quot;selected&quot; URL.  Pressing RETURN will cause Alpine to display
30046 the selected URL via either built-in means as with mailto:, imap:,
30047 news:, and nntp:, or via an external application as defined
30048 by the <A HREF="h_config_browser">&quot;url-viewer&quot;</A>
30049 variable.
30050 <P>
30051 Use the arrow keys to change which of the URLs displayed in boldface
30052 is the current selection.
30053 <P>
30054 Speaking of arrow keys, the Up and Down Arrows will select the next
30055 and previous URL if one is available on the screen for selection (unless
30056 you have set the feature
30057 <A HREF="h_config_enable_view_arrows">&quot;<!--#echo var="FEAT_enable-msg-view-forced-arrows"-->&quot;</A>).
30058 Otherwise, they will simply adjust the viewed text one line up or down.
30059 <P>
30060 Similarly, when selectable items are present in a message, the Ctrl-F
30061 key can be used to select the next item in the message independent
30062 of which portion of the viewed message is currently displayed. The
30063 Ctrl-B key can be used to select the previous item in the same way.
30064 <P>
30065 <UL>
30066 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30067 </UL><P>
30068 &lt;End of help on this topic&gt;
30069 </BODY>
30070 </HTML>
30071 ====== h_config_enable_view_web_host =====
30072 <HTML>
30073 <HEAD>
30074 <TITLE>FEATURE: <!--#echo var="FEAT_enable-msg-view-web-hostnames"--></TITLE>
30075 </HEAD>
30076 <BODY>
30077 <H1>FEATURE: <!--#echo var="FEAT_enable-msg-view-web-hostnames"--></H1>
30078
30079 This feature modifies the behavior of Alpine's MESSAGE TEXT screen.
30080 When this feature is set (the default) Alpine will select possible web hostnames
30081 from the displayed text and display them in boldface for selection.
30082 This can be useful when you receive messages referencing World Wide Web
30083 sites without the use of complete URLs; for example, specifying only
30084 &quot;www.patches.freeiz.com/alpine/&quot; (which will <B>not</B> become a
30085 selectable
30086 item by setting <A HREF="h_config_enable_view_url">&quot;<!--#echo var="FEAT_enable-msg-view-urls"-->&quot;</A>)
30087 rather than explicitly
30088 &quot;http://www.patches.freeiz.com/alpine/&quot;.
30089 <P>
30090 The first available hostname is displayed in inverse.  This is the
30091 &quot;selected&quot; hostname.  Pressing RETURN will cause Alpine to display
30092 the selected hostname via an external application as defined
30093 by the <A HREF="h_config_browser">&quot;url-viewer&quot;</A>
30094 variable.
30095 <P>
30096 Use the arrow keys (unless you have set the feature
30097 <A HREF="h_config_enable_view_arrows">&quot;<!--#echo var="FEAT_enable-msg-view-forced-arrows"-->&quot;</A>)
30098 to change which of the hostnames displayed in
30099 boldface is the current selection.
30100 <P>
30101 Similarly, when selectable web hostnames are present in a message, the Ctrl-F
30102 key can be used to select the next web hostname in the message independent
30103 of which portion of the viewed message is currently displayed. The
30104 Ctrl-B key can be used to select the previous web hostnames in the same way.
30105 <P>
30106 <UL>
30107 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30108 </UL><P>
30109 &lt;End of help on this topic&gt;
30110 </BODY>
30111 </HTML>
30112 ====== h_config_enable_view_addresses =====
30113 <HTML>
30114 <HEAD>
30115 <TITLE>FEATURE: <!--#echo var="FEAT_enable-msg-view-addresses"--></TITLE>
30116 </HEAD>
30117 <BODY>
30118 <H1>FEATURE: <!--#echo var="FEAT_enable-msg-view-addresses"--></H1>
30119
30120 This feature modifies the behavior of Alpine's MESSAGE TEXT screen.
30121 Setting this feature causes Alpine to select possible email addresses
30122 from the displayed text and display them in boldface for selection.
30123
30124 <P>
30125 The first available email address is displayed in inverse.  This is the
30126 &quot;selected&quot; address.  Pressing RETURN will cause Alpine to enter
30127 the message composition screen with the To: field filled in with the
30128 selected address.
30129 <P>
30130 Use the arrow keys (unless you have set the feature
30131 <A HREF="h_config_enable_view_arrows">&quot;<!--#echo var="FEAT_enable-msg-view-forced-arrows"-->&quot;</A>)
30132 to change which of the hostnames displayed in
30133 boldface is the current selection.
30134 <P>
30135 Similarly, when selectable web hostnames are present in a message, the Ctrl-F
30136 key can be used to select the next web hostname in the message independent
30137 of which portion of the viewed message is currently displayed. The
30138 Ctrl-B key can be used to select the previous web hostnames in the same way.
30139 <P>
30140 <UL>
30141 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30142 </UL><P>
30143 &lt;End of help on this topic&gt;
30144 </BODY>
30145 </HTML>
30146 ====== h_config_enable_view_arrows =====
30147 <HTML>
30148 <HEAD>
30149 <TITLE>FEATURE: <!--#echo var="FEAT_enable-msg-view-forced-arrows"--></TITLE>
30150 </HEAD>
30151 <BODY>
30152 <H1>FEATURE: <!--#echo var="FEAT_enable-msg-view-forced-arrows"--></H1>
30153
30154 This feature modifies Up and Down arrow key behavior in Alpine's
30155 MESSAGE TEXT screen when selectable Attachments, URL's, or
30156 web-hostnames are presented. Alpine's usual behavior is to move to
30157 the next or previous selectable item if currently displayed or
30158 simply to adjust the screen view by one line.
30159
30160 <P>
30161
30162 Setting this feature causes the UP and Down arrow key to behave as
30163 if no selectable items were present in the message.
30164
30165 <P>
30166
30167 Note, the Ctrl-F (next selectable item) and Ctrl-B (previous selectable
30168 item) functionality is unchanged.
30169 <P>
30170
30171 &lt;End of help on this topic&gt;
30172 </BODY>
30173 <HTML>
30174 ====== h_config_quell_charset_warning =====
30175 <HTML>
30176 <HEAD>
30177 <TITLE>FEATURE: <!--#echo var="FEAT_quell-charset-warning"--></TITLE>
30178 </HEAD>
30179 <BODY>
30180 <H1>FEATURE: <!--#echo var="FEAT_quell-charset-warning"--></H1>
30181
30182 By default, if the message you are viewing contains characters that are
30183 not representable in your
30184 <A HREF="h_config_char_set">&quot;Display Character Set&quot;</A>
30185 then Alpine will
30186 add a warning to the start of the displayed text.
30187 If this option is set, then that editorial message will be suppressed.
30188 <P>
30189 Setting this feature also suppresses the comment about the character set
30190 in header lines.
30191 For example, when viewing a message you might see
30192 <P>
30193 <CENTER><SAMP>From: &quot;[ISO-8859-2] Name&quot; &lt;address&gt;</SAMP></CENTER>
30194 <P>
30195 in the From header if your Character-Set is something other than ISO-8859-2.
30196 If you set this feature, the comment about the character set will
30197 no longer be there.
30198 <P>
30199 &lt;End of help on this topic&gt;
30200 </BODY>
30201 </HTML>
30202 ====== h_config_quell_host_after_url =====
30203 <HTML>
30204 <HEAD>
30205 <TITLE>FEATURE: <!--#echo var="FEAT_quell-server-after-link-in-html"--></TITLE>
30206 </HEAD>
30207 <BODY>
30208 <H1>FEATURE: <!--#echo var="FEAT_quell-server-after-link-in-html"--></H1>
30209
30210 By default, links in HTML text are displayed with the host the link
30211 references appended, within square brackets, to the link text.  Alpine
30212 does this to help indicate where a link will take you, particularly when
30213 the link text might suggest a different destination.
30214
30215 <P>
30216 Setting this feature will prevent the server name from being appended
30217 to the displayed text.
30218
30219 <P>
30220 &lt;End of help on this topic&gt;
30221 </BODY>
30222 </HTML>
30223 ====== h_config_prefer_plain_text =====
30224 <HTML>
30225 <HEAD>
30226 <TITLE>FEATURE: <!--#echo var="FEAT_prefer-plain-text"--></TITLE>
30227 </HEAD>
30228 <BODY>
30229 <H1>FEATURE: <!--#echo var="FEAT_prefer-plain-text"--></H1>
30230
30231 A message being viewed may contain alternate versions of the same content.
30232 Those alternate versions are supposed to be ordered by the sending software such that the
30233 first alternative is the least preferred and the last alternative is the
30234 most preferred. Alpine will normally display the most-preferred version that
30235 it knows how to display. This is most often encountered where the two
30236 alternate versions are a plain text version and an HTML version, with the
30237 HTML version listed last as the most preferred.
30238 <P>
30239 If this option is set, then any plain text version will be preferred to
30240 all other versions.
30241 <P>
30242 When viewing a message there is a command &quot;A TogglePreferPlain&quot;,
30243 which will temporarily change the sense of this option.
30244 If this option is set you will first see the plain text version of a
30245 message.
30246 If you then type the &quot;A&quot; command, you will see the most preferred version,
30247 most likely HTML, instead.
30248 Typing the &quot;A&quot; command a second time will switch it back.
30249 Alternatively, if the present option is not set you will originally see
30250 the most preferred version of the message and typing &quot;A&quot; will switch to
30251 the plain text version.
30252 <P>
30253 &lt;End of help on this topic&gt;
30254 </BODY>
30255 </HTML>
30256 ====== h_config_pass_control =====
30257 <HTML>
30258 <HEAD>
30259 <TITLE>FEATURE: <!--#echo var="FEAT_pass-control-characters-as-is"--></TITLE>
30260 </HEAD>
30261 <BODY>
30262 <H1>FEATURE: <!--#echo var="FEAT_pass-control-characters-as-is"--></H1>
30263
30264 It is probably not useful to set this option.
30265 This is a legacy option left behind &quot;just in case&quot;.
30266 Multi-byte characters that have an octet that has the same
30267 value as a control character are permitted through whether or not
30268 this option is turned on.
30269 <P>
30270 This feature controls how certain characters contained in messages are
30271 displayed.
30272 If set, all characters in a message will be sent to the
30273 screen. Normally, control characters are displayed as shown below to
30274 avoid a garbled screen and to
30275 avoid inadvertently changing terminal setup parameters.
30276 Control characters are usually displayed as two character sequences like
30277 <P><CENTER><SAMP> ^C </SAMP></CENTER><P>
30278 for Control-C,
30279 <P><CENTER><SAMP> ^[ </SAMP></CENTER><P>
30280 for ESCAPE,
30281 <P><CENTER><SAMP> ^? </SAMP></CENTER><P>
30282 for DELETE, and
30283 <P><CENTER><SAMP> ~E </SAMP></CENTER><P>
30284 for the character with value 133 (0x85).
30285 (The DEL character is displayed as ^?, regular control characters are displayed
30286 as the character ^ followed by the character obtained by adding the
30287 five low-order bits of the character to 0x40, and the C1
30288 control characters 0x80 - 0x9F are displayed as the character ~ followed by the
30289 character obtained by adding the
30290 five low-order bits of the character to 0x40.)
30291 Sometimes, in cases where changing a single control character into a
30292 two-character sequence would confuse Alpine's display routines,
30293 a question mark is substituted for the control character.
30294 <P>
30295 If you wish to filter out regular control characters but pass the
30296 so-called C1 control characters (0x80 <= char < 0xA0) through unchanged, then
30297 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.
30298 <P>
30299 &lt;End of help on this topic&gt;
30300 </BODY>
30301 </HTML>
30302 ====== h_config_pass_c1_control =====
30303 <HTML>
30304 <HEAD>
30305 <TITLE>FEATURE: <!--#echo var="FEAT_pass-c1-control-characters-as-is"--></TITLE>
30306 </HEAD>
30307 <BODY>
30308 <H1>FEATURE: <!--#echo var="FEAT_pass-c1-control-characters-as-is"--></H1>
30309
30310 It is probably not useful to set this option.
30311 This is a legacy option left behind &quot;just in case&quot;.
30312 Multi-byte characters that have an octet that has the same
30313 value as a control character are permitted through whether or not
30314 this option is turned on.
30315 <P>
30316 If the feature <A HREF="h_config_pass_control"><!--#echo var="FEAT_pass-control-characters-as-is"--></A>
30317 is set, then this feature has no effect.
30318 However, if you wish to filter out regular control characters but pass the
30319 so-called C1 control characters (0x80 <= char < 0xA0) through unchanged, then
30320 you may leave <A HREF="h_config_pass_control"><!--#echo var="FEAT_pass-control-characters-as-is"--></A>
30321 unset and set this feature.
30322 <P>
30323 &lt;End of help on this topic&gt;
30324 </BODY>
30325 </HTML>
30326 ====== h_config_fcc_on_bounce =====
30327 <HTML>
30328 <HEAD>
30329 <TITLE>FEATURE: <!--#echo var="FEAT_fcc-on-bounce"--></TITLE>
30330 </HEAD>
30331 <BODY>
30332 <H1>FEATURE: <!--#echo var="FEAT_fcc-on-bounce"--></H1>
30333
30334 This feature controls an aspect of Alpine's behavior when bouncing a
30335 message. If set, normal FCC ("File Carbon Copy") processing will be
30336 done, just as if you had composed a message to the address you are
30337 bouncing to.  If not set, no FCC of the message will be saved.
30338 <P>
30339 &lt;End of help on this topic&gt;
30340 </BODY>
30341 </HTML>
30342 ====== h_config_show_cursor =====
30343 <HTML>
30344 <HEAD>
30345 <TITLE>FEATURE: <!--#echo var="FEAT_show-cursor"--></TITLE>
30346 </HEAD>
30347 <BODY>
30348 <H1>FEATURE: <!--#echo var="FEAT_show-cursor"--></H1>
30349
30350 This feature controls an aspect of Alpine's displays.  If set, the system
30351 cursor will move to convenient locations in the displays.  For example,
30352 to the beginning of the status field of the highlighted index line, or
30353 to the highlighted word after a successful WhereIs command.  It is intended
30354 to draw your attention to an "interesting" spot on the screen.
30355 <P>
30356 &lt;End of help on this topic&gt;
30357 </BODY>
30358 </HTML>
30359 ====== h_config_sort_fcc_alpha =====
30360 <HTML>
30361 <HEAD>
30362 <TITLE>FEATURE: <!--#echo var="FEAT_sort-default-fcc-alpha"--></TITLE>
30363 </HEAD>
30364 <BODY>
30365 <H1>FEATURE: <!--#echo var="FEAT_sort-default-fcc-alpha"--></H1>
30366
30367 This feature controls an aspect of Alpine's FOLDER LIST screen.
30368 If set, the default Fcc folder will be sorted alphabetically with the other
30369 folders instead of appearing right after the INBOX.
30370 <P>
30371 &lt;End of help on this topic&gt;
30372 </BODY>
30373 </HTML>
30374 ====== h_config_sort_save_alpha =====
30375 <HTML>
30376 <HEAD>
30377 <TITLE>FEATURE: <!--#echo var="FEAT_sort-default-save-alpha"--></TITLE>
30378 </HEAD>
30379 <BODY>
30380 <H1>FEATURE: <!--#echo var="FEAT_sort-default-save-alpha"--></H1>
30381
30382 This feature controls an aspect of Alpine's FOLDER LIST screen.
30383 If set, the default save folder will be sorted alphabetically with the other
30384 folders instead of appearing right after the INBOX (and default FCC folder).
30385 <P>
30386 &lt;End of help on this topic&gt;
30387 </BODY>
30388 </HTML>
30389 ====== h_config_single_list =====
30390 <HTML>
30391 <HEAD>
30392 <TITLE>FEATURE: <!--#echo var="FEAT_single-column-folder-list"--></TITLE>
30393 </HEAD>
30394 <BODY>
30395 <H1>FEATURE: <!--#echo var="FEAT_single-column-folder-list"--></H1>
30396
30397 This feature controls an aspect of Alpine's FOLDER LIST screen.  If set,
30398 the folders will be listed one per line instead of several per line
30399 in the FOLDER LIST display.
30400 <P>
30401 &lt;End of help on this topic&gt;
30402 </BODY>
30403 </HTML>
30404 ====== h_config_vertical_list =====
30405 <HTML>
30406 <HEAD>
30407 <TITLE>FEATURE: <!--#echo var="FEAT_vertical-folder-list"--></TITLE>
30408 </HEAD>
30409 <BODY>
30410 <H1>FEATURE: <!--#echo var="FEAT_vertical-folder-list"--></H1>
30411
30412 This feature controls an aspect of Alpine's FOLDER LIST screen.  If set,
30413 the folders will be listed alphabetically down the columns rather
30414 than across the columns as is the default.
30415 <P>
30416 &lt;End of help on this topic&gt;
30417 </BODY>
30418 </HTML>
30419 ====== h_config_verbose_post =====
30420 <HTML>
30421 <HEAD>
30422 <TITLE>FEATURE: <!--#echo var="FEAT_enable-verbose-smtp-posting"--></TITLE>
30423 </HEAD>
30424 <BODY>
30425 <H1>FEATURE: <!--#echo var="FEAT_enable-verbose-smtp-posting"--></H1>
30426 This feature controls an aspect of Alpine's message sending.  When enabled,
30427 Alpine will send a VERB (i.e., VERBose) command early in the posting process
30428 intended to cause the SMTP server to provide a more detailed account of
30429 the transaction.  This feature is typically only useful to system
30430 administrators and other support personel as an aid in troublshooting
30431 problems.
30432 <P>
30433 Note, this feature relies on a specific capability of the system's mail
30434 transport agent or configured
30435 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>.
30436 It is possible that this
30437 feature will cause problems for some tranport agents, and may result in
30438 sending failure.  In addition, as the verbose output comes from the mail
30439 transport agent, it is likely to vary from one system to another.
30440 <P><UL>
30441 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30442 </UL><P>
30443 &lt;End of help on this topic&gt;
30444 </BODY>
30445 </HTML>
30446 ====== h_config_auto_reply_to =====
30447 <HTML>
30448 <HEAD>
30449 <TITLE>FEATURE: <!--#echo var="FEAT_reply-always-uses-reply-to"--></TITLE>
30450 </HEAD>
30451 <BODY>
30452 <H1>FEATURE: <!--#echo var="FEAT_reply-always-uses-reply-to"--></H1>
30453
30454 This feature controls an aspect of Alpine's Reply command.  If set, Alpine
30455 will not prompt when a message being replied to contains a "Reply-To:"
30456 header value, but will simply use its value (as opposed to using the
30457 "From:" field's value).
30458
30459 <P>
30460
30461 Note: Using the "Reply-To:" address is usually the preferred behavior,
30462 however, some mailing list managers choose to place the list's address in
30463 the "Reply-To:" field of any message sent out to the list.  In such
30464 cases, this feature makes it all too easy for personal replies to be
30465 inadvertently sent to the entire mail list, so be careful!
30466 <P>
30467 &lt;End of help on this topic&gt;
30468 </BODY>
30469 </HTML>
30470 ====== h_config_del_skips_del =====
30471 <HTML>
30472 <HEAD>
30473 <TITLE>FEATURE: <!--#echo var="FEAT_delete-skips-deleted"--></TITLE>
30474 </HEAD>
30475 <BODY>
30476 <H1>FEATURE: <!--#echo var="FEAT_delete-skips-deleted"--></H1>
30477
30478 This feature controls an aspect of Alpine's Delete command.  If set, this
30479 feature will cause the Delete command to advance past following messages that
30480 are marked deleted.  In other words, pressing "D" will both mark the
30481 current message deleted and advance to the next message that is not marked
30482 deleted.
30483 This feature is set by default.
30484 <P>
30485 &lt;End of help on this topic&gt;
30486 </BODY></HTML>
30487 ====== h_config_expunge_manually =====
30488 <HTML>
30489 <HEAD>
30490 <TITLE>FEATURE: <!--#echo var="FEAT_expunge-only-manually"--></TITLE>
30491 </HEAD>
30492 <BODY>
30493 <H1>FEATURE: <!--#echo var="FEAT_expunge-only-manually"--></H1>
30494
30495 Normally, when you close a folder that contains deleted messages you are
30496 asked if you want to expunge those messages from the folder permanently.
30497 If this feature is set, you won't be asked and the deleted messages will
30498 remain in the folder.
30499 If you choose to set this feature you will have to expunge the
30500 messages manually using the eXpunge command, which you can use while
30501 in the MESSAGE INDEX screen.
30502 If you do not expunge deleted messages the size of your
30503 folder will continue to increase until you are out of disk space.
30504 <P>
30505 <UL>
30506 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30507 </UL><P>
30508 &lt;End of help on this topic&gt;
30509 </BODY>
30510 </HTML>
30511 ====== h_config_auto_expunge =====
30512 <HTML>
30513 <HEAD>
30514 <TITLE>FEATURE: <!--#echo var="FEAT_expunge-without-confirm"--></TITLE>
30515 </HEAD>
30516 <BODY>
30517 <H1>FEATURE: <!--#echo var="FEAT_expunge-without-confirm"--></H1>
30518
30519 This features controls an aspect of Alpine's eXpunge command.  If set, you
30520 will <B>not</B> be prompted to confirm your intent before the expunge takes
30521 place.
30522 Actually, this is only true for the INBOX folder and for folders in the
30523 Incoming Folders collection. See the feature
30524 <A HREF="h_config_full_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm-everywhere"-->&quot;</A>.
30525 <P>
30526 <UL>
30527 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30528 </UL><P>
30529 &lt;End of help on this topic&gt;
30530 </BODY>
30531 </HTML>
30532 ====== h_config_full_auto_expunge =====
30533 <HTML>
30534 <HEAD>
30535 <TITLE>FEATURE: <!--#echo var="FEAT_expunge-without-confirm-everywhere"--></TITLE>
30536 </HEAD>
30537 <BODY>
30538 <H1>FEATURE: <!--#echo var="FEAT_expunge-without-confirm-everywhere"--></H1>
30539
30540 This features controls an aspect of Alpine's eXpunge command.  If set, you
30541 will <B>not</B> be prompted to confirm your intent before the expunge
30542 takes place.  This feature sets this behavior for all folders, unlike the
30543 <A HREF="h_config_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm"-->&quot;</A>
30544 feature that works only for incoming folders.
30545 <P>
30546 <UL>
30547 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30548 </UL><P>
30549 &lt;End of help on this topic&gt;
30550 </BODY>
30551 </HTML>
30552 ====== h_config_auto_read_msgs =====
30553 <HTML>
30554 <HEAD>
30555 <TITLE>FEATURE: <!--#echo var="FEAT_auto-move-read-msgs"--></TITLE>
30556 </HEAD>
30557 <BODY>
30558 <H1>FEATURE: <!--#echo var="FEAT_auto-move-read-msgs"--></H1>
30559 This feature controls an aspect of Alpine's behavior upon quitting.  If set,
30560 and the
30561 <A HREF="h_config_read_message_folder">&quot;<!--#echo var="VAR_read-message-folder"-->&quot;</A>
30562 option is also set, then Alpine will
30563 automatically transfer all read messages to the designated folder and mark
30564 them as deleted in the INBOX.  Messages in the INBOX marked with an
30565 &quot;N&quot; (meaning New, or unseen) are not affected.
30566 <P>
30567 <UL>
30568 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30569 </UL><P>
30570 &lt;End of help on this topic&gt;
30571 </BODY>
30572 </HTML>
30573 ====== h_config_auto_fcc_only =====
30574 <HTML>
30575 <HEAD>
30576 <TITLE>FEATURE: <!--#echo var="FEAT_fcc-only-without-confirm"--></TITLE>
30577 </HEAD>
30578 <BODY>
30579 <H1>FEATURE: <!--#echo var="FEAT_fcc-only-without-confirm"--></H1>
30580 This features controls an aspect of Alpine's composer.
30581 The only time this feature will be used is if you attempt to send mail
30582 that has no recipients but does have an Fcc.
30583 Normally, Alpine will ask if you really mean to copy the message only to
30584 the Fcc.
30585 That is, it asks if you really meant to have no recipients.
30586 If this feature is set, you
30587 will <B>not</B> be prompted to confirm your intent to make only a copy
30588 of a message with no recipients.
30589 <P>
30590 This feature is closely related to
30591 <A HREF="h_config_warn_if_no_to_or_cc"><!--#echo var="FEAT_warn-if-blank-to-and-cc-and-newsgroups"--></A>.
30592 The difference between this feature and that feature is that this feature
30593 considers a Bcc to be a recipient while that feature will ask for confirmation
30594 even if there is a Bcc when there is no To, Cc, or Newsgroup.
30595 The default values also differ. This feature defaults to asking the question
30596 and you have to turn it off.
30597 The <!--#echo var="FEAT_warn-if-blank-to-and-cc-and-newsgroups"--> feature defaults to not asking
30598 unless you turn it on.
30599 <P>
30600
30601 <UL>
30602 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30603 </UL><P>
30604 &lt;End of help on this topic&gt;
30605 </BODY>
30606 </HTML>
30607 ====== h_config_mark_fcc_seen =====
30608 <HTML>
30609 <HEAD>
30610 <TITLE>FEATURE: <!--#echo var="FEAT_mark-fcc-seen"--></TITLE>
30611 </HEAD>
30612 <BODY>
30613 <H1>FEATURE: <!--#echo var="FEAT_mark-fcc-seen"--></H1>
30614
30615 This features controls the way Fccs (File carbon copies) are
30616 made of the messages you send.
30617
30618 <P>
30619 Normally, when Alpine saves a copy of a message you sent as an Fcc, that
30620 copy will be marked as Unseen.
30621 When you look at the folder it was saved in the message will appear to
30622 be a New message until you read it.
30623 When this feature is enabled, the message will be marked as having
30624 been Seen.
30625
30626 <P>
30627 <UL>
30628 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30629 </UL><P>
30630 &lt;End of help on this topic&gt;
30631 </BODY>
30632 </HTML>
30633 ====== h_config_no_fcc_attach =====
30634 <HTML>
30635 <HEAD>
30636 <TITLE>FEATURE: <!--#echo var="FEAT_fcc-without-attachments"--></TITLE>
30637 </HEAD>
30638 <BODY>
30639 <H1>FEATURE: <!--#echo var="FEAT_fcc-without-attachments"--></H1>
30640
30641 This features controls the way Fcc's (File carbon copies) are
30642 made of the messages you send.
30643
30644 <P>
30645 Normally, Alpine saves an exact copy of your message as it was sent.
30646 When this feature is enabled, the &quot;body&quot; of the message
30647 you send (the text you type in the composer) is preserved in the
30648 copy as before, however all attachments are replaced with text
30649 explaining what had been sent rather than the attachments themselves.
30650
30651 <P>
30652 This feature also affects Alpine's &quot;Send ?&quot; confirmation prompt
30653 in that a new &quot;^F Fcc Attchmnts&quot; option becomes available which
30654 allows you to interactively set whether or not attachments are saved
30655 to the Fcc'd copy.
30656
30657 <P>
30658 <UL>
30659 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30660 </UL><P>
30661 &lt;End of help on this topic&gt;
30662 </BODY>
30663 </HTML>
30664 ====== h_config_read_in_newsrc_order =====
30665 <HTML>
30666 <HEAD>
30667 <TITLE>FEATURE: <!--#echo var="FEAT_news-read-in-newsrc-order"--></TITLE>
30668 </HEAD>
30669 <BODY>
30670 <H1>FEATURE: <!--#echo var="FEAT_news-read-in-newsrc-order"--></H1>
30671
30672 This feature controls the order in which newsgroups will be presented.  If
30673 set, they will be presented in the same order as they occur in your
30674 <!--chtml if pinemode="os_windows"-->
30675 &quot;NEWSRC&quot;
30676 <!--chtml else-->
30677 &quot;.newsrc&quot;
30678 <!--chtml endif-->
30679 file (the default location of which can be changed with the
30680 <A HREF="h_config_newsrc_path">&quot;<!--#echo var="VAR_newsrc-path"-->&quot;</A> option).
30681 <P>
30682 If not set, the newsgroups will be presented in alphabetical order.
30683 <P>
30684 <UL>
30685 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30686 </UL><P>
30687 &lt;End of help on this topic&gt;
30688 </BODY>
30689 </HTML>
30690 ====== h_config_quell_tz_comment =====
30691 <HTML>
30692 <HEAD>
30693 <TITLE>FEATURE: <!--#echo var="FEAT_quell-timezone-comment-when-sending"--></TITLE>
30694 </HEAD>
30695 <BODY>
30696 <H1>FEATURE: <!--#echo var="FEAT_quell-timezone-comment-when-sending"--></H1>
30697
30698 Normally, when Alpine generates a Date header for outgoing mail,
30699 it will try to include the symbolic timezone at the end of the
30700 header inside parentheses.
30701 The symbolic timezone is often three characters long, but on
30702 some operating systems, it may be longer.
30703 Apparently there are some SMTP servers in the world that will reject an
30704 incoming message if it has a Date header longer than about 80 characters.
30705 If this feature is set, the symbolic timezone normally generated by
30706 Alpine will not be included.
30707 You probably don't need to worry about this feature unless you run into
30708 the problem described above.
30709
30710 <P>
30711 &lt;End of help on this topic&gt;
30712 </BODY>
30713 </HTML>
30714 ====== h_config_post_wo_validation =====
30715 <HTML>
30716 <HEAD>
30717 <TITLE>FEATURE: <!--#echo var="FEAT_news-post-without-validation"--></TITLE>
30718 </HEAD>
30719 <BODY>
30720 <H1>FEATURE: <!--#echo var="FEAT_news-post-without-validation"--></H1>
30721
30722 This feature controls whether the NNTP server is queried as newsgroups
30723 are entered for posting.  Validation over slow links (e.g. dialup using
30724 SLIP or PPP) can cause delays.  Set this feature to eliminate such delays.
30725 <P>
30726 &lt;End of help on this topic&gt;
30727 </BODY>
30728 </HTML>
30729 ====== h_config_send_wo_confirm =====
30730 <HTML>
30731 <HEAD>
30732 <TITLE>FEATURE: <!--#echo var="FEAT_send-without-confirm"--></TITLE>
30733 </HEAD>
30734 <BODY>
30735 <H1>FEATURE: <!--#echo var="FEAT_send-without-confirm"--></H1>
30736
30737 By default, when you send or post a message you will be asked to confirm
30738 with a question that looks something like:
30739
30740 <P>
30741 <CENTER><SAMP>Send message?</SAMP></CENTER>
30742 <P>
30743
30744 If this feature is set, you
30745 will <B>not</B> be prompted to confirm your intent to send
30746 and your message will be sent.
30747 <P>
30748 If this feature is set it disables some possibilities and renders some
30749 other features meaningless.
30750 You will not be able to use
30751 <A HREF="h_config_sending_filter">Sending Filters</A>,
30752 Verbose sending mode,
30753 <A HREF="h_config_compose_bg_post">Background Sending</A>,
30754 <A HREF="h_config_compose_dsn">Delivery Status Notifications</A>,
30755 or ^V to turn off the generation of flowed text for this message.
30756 These options are normally available as suboptions in the Send prompt, but
30757 with no Send prompt the options are gone.
30758
30759 <P>
30760 A somewhat related feature is
30761 <A HREF="h_config_quell_post_prompt">&quot;<!--#echo var="FEAT_quell-extra-post-prompt"-->&quot;</A>,
30762 which may be used to eliminate the extra confirmation
30763 question when posting to a newsgroup.
30764 <P>
30765 <UL>
30766 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30767 </UL><P>
30768 &lt;End of help on this topic&gt;
30769 </BODY>
30770 </HTML>
30771 ====== h_config_quell_filtering_done_message =====
30772 <HTML>
30773 <HEAD>
30774 <TITLE>FEATURE: <!--#echo var="FEAT_quell-filtering-done-message"--></TITLE>
30775 </HEAD>
30776 <BODY>
30777 <H1>FEATURE: <!--#echo var="FEAT_quell-filtering-done-message"--></H1>
30778
30779 If you use Filter Rules that move messages or set status of messages
30780 you sometimes see a message from Alpine that looks like
30781
30782 <P>
30783 <CENTER><SAMP>filtering done</SAMP></CENTER>
30784 <P>
30785
30786 If this feature is set, this message will be suppressed.
30787 If the feature
30788 <A HREF="h_config_quell_filtering_messages"><!--#echo var="FEAT_quell-filtering-messages"--></A>
30789 is set then this message will be suppressed regardless.
30790
30791 <P>
30792 <UL>
30793 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30794 </UL><P>
30795 &lt;End of help on this topic&gt;
30796 </BODY>
30797 </HTML>
30798 ====== h_config_quell_filtering_messages =====
30799 <HTML>
30800 <HEAD>
30801 <TITLE>FEATURE: <!--#echo var="FEAT_quell-filtering-messages"--></TITLE>
30802 </HEAD>
30803 <BODY>
30804 <H1>FEATURE: <!--#echo var="FEAT_quell-filtering-messages"--></H1>
30805
30806 If you use Filter Rules that move messages or set status of messages
30807 you sometimes see messages from Alpine that look like
30808
30809 <P>
30810 <CENTER><SAMP>&lt;filter name&gt;: Moving 2 filtered messages to &lt;folder name&gt;</SAMP></CENTER>
30811 <P>
30812
30813 or
30814
30815 <P>
30816 <CENTER><SAMP>&lt;filter name&gt;: Setting flags in 5 messages</SAMP></CENTER>
30817 <P>
30818
30819 or
30820
30821 <P>
30822 <CENTER><SAMP>Processing filter &lt;filter name&gt;</SAMP></CENTER>
30823 <P>
30824
30825 If this feature is set, these messages will be suppressed.
30826 The feature
30827 <A HREF="h_config_quell_filtering_done_message"><!--#echo var="FEAT_quell-filtering-done-message"--></A>
30828 is related.
30829
30830 <P>
30831 <UL>
30832 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30833 </UL><P>
30834 &lt;End of help on this topic&gt;
30835 </BODY>
30836 </HTML>
30837 ====== h_config_quell_post_prompt =====
30838 <HTML>
30839 <HEAD>
30840 <TITLE>FEATURE: <!--#echo var="FEAT_quell-extra-post-prompt"--></TITLE>
30841 </HEAD>
30842 <BODY>
30843 <H1>FEATURE: <!--#echo var="FEAT_quell-extra-post-prompt"--></H1>
30844
30845 By default, when you post a message to a newsgroup you are asked to confirm
30846 that you want to post with the question
30847
30848 <P>
30849 <CENTER><SAMP>Posted message may go to thousands of readers. Really post?</SAMP></CENTER>
30850 <P>
30851
30852 If this feature is set, you
30853 will <B>not</B> be prompted to confirm your intent to post to a newsgroup
30854 and your message will be posted.
30855
30856 <P>
30857 <UL>
30858 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30859 </UL><P>
30860 &lt;End of help on this topic&gt;
30861 </BODY>
30862 </HTML>
30863 ====== h_config_check_mail_onquit =====
30864 <HTML>
30865 <HEAD>
30866 <TITLE>FEATURE: <!--#echo var="FEAT_check-newmail-when-quitting"--></TITLE>
30867 </HEAD>
30868 <BODY>
30869 <H1>FEATURE: <!--#echo var="FEAT_check-newmail-when-quitting"--></H1>
30870
30871 If this feature is set, Alpine will check for new mail after you give the
30872 Quit command.
30873 If new mail has arrived since the previous check, you will be notified
30874 and given the choice of quitting or not quitting.
30875 <P>
30876 <UL>
30877 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30878 </UL><P>
30879 &lt;End of help on this topic&gt;
30880 </BODY>
30881 </HTML>
30882 ====== h_config_inbox_no_confirm =====
30883 <HTML>
30884 <HEAD>
30885 <TITLE>FEATURE: <!--#echo var="FEAT_return-to-inbox-without-confirm"--></TITLE>
30886 </HEAD>
30887 <BODY>
30888 <H1>FEATURE: <!--#echo var="FEAT_return-to-inbox-without-confirm"--></H1>
30889
30890 Normally, when you use the TAB <A HREF="h_common_nextnew">NextNew</A>
30891 command and there are no more folders or newsgroups to visit, you are asked
30892 if you want to return to the INBOX.
30893 If this feature is set you will not be asked.
30894 It will be assumed that you do want to return to the INBOX.
30895 <P>
30896 <UL>
30897 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30898 </UL><P>
30899 &lt;End of help on this topic&gt;
30900 </BODY>
30901 </HTML>
30902 ====== h_config_dates_to_local =====
30903 <HTML>
30904 <HEAD>
30905 <TITLE>FEATURE: <!--#echo var="FEAT_convert-dates-to-localtime"--></TITLE>
30906 </HEAD>
30907 <BODY>
30908 <H1>FEATURE: <!--#echo var="FEAT_convert-dates-to-localtime"--></H1>
30909
30910 Normally, the message dates that you see in the
30911 MESSAGE INDEX and MESSAGE VIEW are displayed in the timezone they were sent from.
30912 For example, if a message was sent to you from a few timezones to the east
30913 it might appear that it was sent from the future;
30914 or if it was sent from somewhere to the west it might appear
30915 as if it is from yesterday even though it was sent only a few minutes ago.
30916 If this feature is set an attempt will be made to convert the dates
30917 to your local timezone to be displayed.
30918 <P>
30919 Note that this does not affect the results of Select by Date or of
30920 anything else other than these displayed dates.
30921 When viewing the message you may look at the original unconverted value of the Date
30922 header by using the <A HREF="h_common_hdrmode">HdrMode Command</A>.
30923 <P>
30924 <UL>
30925 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30926 </UL><P>
30927 &lt;End of help on this topic&gt;
30928 </BODY>
30929 </HTML>
30930 ====== h_config_tab_no_prompt =====
30931 <HTML>
30932 <HEAD>
30933 <TITLE>FEATURE: <!--#echo var="FEAT_continue-tab-without-confirm"--></TITLE>
30934 </HEAD>
30935 <BODY>
30936 <H1>FEATURE: <!--#echo var="FEAT_continue-tab-without-confirm"--></H1>
30937
30938 Normally, when you use the TAB <A HREF="h_common_nextnew">NextNew</A>
30939 command and there is a problem checking a folder, you are asked
30940 whether you want to continue with the search in the following folder or not.
30941 This question gives you a chance to stop the NextNew processing.
30942 (The checking problem might be caused by the fact that the folder does not
30943 exist, or by an authentication problem, or by a server problem
30944 of some sort.)
30945 <P>
30946
30947 If this feature is set you will not be asked.
30948 It will be assumed that you do want to continue.
30949 <P>
30950 <UL>
30951 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30952 </UL><P>
30953 &lt;End of help on this topic&gt;
30954 </BODY>
30955 </HTML>
30956 ====== h_config_input_history =====
30957 <HTML>
30958 <HEAD>
30959 <TITLE>FEATURE: <!--#echo var="FEAT_disable-save-input-history"--></TITLE>
30960 </HEAD>
30961 <BODY>
30962 <H1>FEATURE: <!--#echo var="FEAT_disable-save-input-history"--></H1>
30963
30964 Many of the prompts that ask for input in the status line near the
30965 bottom of the screen will respond to Up Arrow and Down Arrow
30966 with the history of previous entries.
30967 For example, in the MESSAGE INDEX screen when you use the WhereIs
30968 command the text you entered will be remembered and can be recalled
30969 by using the Up Arrow key.
30970 Another example, when saving a message the folders saved to will
30971 be remembered and can be recalled using the arrow keys.
30972 <P>
30973 In the Save prompt, some users prefer that the Up and Down arrow keys
30974 be used for the Previous Collection and Next Collection commands
30975 instead of for a history of previous saves.
30976 If this option is set the Up and Down arrow keys will become synonyms for the
30977 Previous Collection and Next Collection (^P and ^N) commands in the
30978 prompt for the name of a folder to Save to or in the prompt for the
30979 name of a folder to GoTo.
30980 When this feature is not set (the default), ^P and ^N will change the
30981 collection and the arrow keys will show the history.
30982 <P>
30983 <UL>
30984 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30985 </UL><P>
30986 &lt;End of help on this topic&gt;
30987 </BODY>
30988 </HTML>
30989 ====== h_config_confirm_role =====
30990 <HTML>
30991 <HEAD>
30992 <TITLE>FEATURE: <!--#echo var="FEAT_confirm-role-even-for-default"--></TITLE>
30993 </HEAD>
30994 <BODY>
30995 <H1>FEATURE: <!--#echo var="FEAT_confirm-role-even-for-default"--></H1>
30996
30997 If you have roles, when you Reply to or Forward a message, or Compose
30998 a new message, Alpine
30999 will search through your roles for one that matches.
31000 Normally, if no matches are found you will be placed into the composer
31001 with no opportunity to select a role.
31002 If this feature is set, then you will be asked to confirm that you don't
31003 want a role.
31004 This will give you the opportunity to select a role (with the ^T command).
31005 If you confirm no role with a Return, you will be placed in
31006 the composer with no role.
31007 You may also confirm with either an &quot;N&quot; or a &quot;Y&quot;.
31008 These behave the same as if you pressed the Return.
31009 (The &quot;N&quot; and &quot;Y&quot; answers are available because they
31010 match what you might type if there was a role match.)
31011 <P>
31012 If you are using the alternate form of the Compose command called
31013 &quot;Role&quot;, then all of your roles will be available to you,
31014 independent of the value of this feauture and of the values set for all of
31015 Reply Use, Forward Use, and Compose Use.
31016 <P>
31017 <UL>
31018 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31019 </UL><P>
31020 &lt;End of help on this topic&gt;
31021 </BODY>
31022 </HTML>
31023 ====== h_config_news_cross_deletes =====
31024 <HTML>
31025 <HEAD>
31026 <TITLE>FEATURE: <!--#echo var="FEAT_news-deletes-across-groups"--></TITLE>
31027 </HEAD>
31028 <BODY>
31029 <H1>FEATURE: <!--#echo var="FEAT_news-deletes-across-groups"--></H1>
31030
31031 This feature controls what Alpine does when you delete a message in a
31032 newsgroup that appears in more than one newsgroup.  Such a message
31033 is sometimes termed a &quot;crossposting&quot; in that it was posted
31034 across several newsgroups.
31035
31036 <P>
31037 Alpine's default behavior when you delete such a message is to remove
31038 only the copy in the current newsgroup from view when you use the
31039 &quot;Exclude&quot; command or the next time you visit the newsgroup.
31040
31041 <P>
31042 Enabling this feature causes Alpine to remove every occurrence of the
31043 message from all newsgroups it appears in and to which you are
31044 subscribed.
31045
31046 <P>
31047 NOTE: As currently implemented, enabling this feature may increase the
31048 time it takes the Expunge command and newsgroup closing to complete.
31049
31050 <P>
31051 <UL>
31052 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31053 </UL><P>
31054 &lt;End of help on this topic&gt;
31055 </BODY>
31056 </HTML>
31057 ====== h_config_news_catchup =====
31058 <HTML>
31059 <HEAD>
31060 <TITLE>FEATURE: <!--#echo var="FEAT_news-offers-catchup-on-close"--></TITLE>
31061 </HEAD>
31062 <BODY>
31063 <H1>FEATURE: <!--#echo var="FEAT_news-offers-catchup-on-close"--></H1>
31064
31065 This feature controls what Alpine does as it closes a newsgroup.
31066 When set, Alpine will offer to delete all messages from the newsgroup
31067 as you are quitting Alpine or opening a new folder.
31068
31069 <P>
31070 This feature is useful if you typically read all the interesting messages
31071 in a newsgroup each time you open it.  This feature saves you from
31072 having to delete each message in a newsgroup as you read it or from
31073 selecting all the messages and doing an
31074 <A HREF="h_config_enable_agg_ops">aggregate delete</A> before you
31075 move on to the next folder or newsgroup.
31076
31077 <P>
31078 <UL>
31079 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31080 </UL><P>
31081 &lt;End of help on this topic&gt;
31082 </BODY>
31083 </HTML>
31084 ====== h_config_next_thrd_wo_confirm =====
31085 <HTML>
31086 <HEAD>
31087 <TITLE>FEATURE: <!--#echo var="FEAT_next-thread-without-confirm"--></TITLE>
31088 </HEAD>
31089 <BODY>
31090 <H1>FEATURE: <!--#echo var="FEAT_next-thread-without-confirm"--></H1>
31091
31092 This feature controls an aspect of Alpine's Next and Prev commands in
31093 the case where you are using one of the
31094 &quot;separate-index-screen&quot; styles for the configuration option
31095 <A HREF="h_config_thread_index_style">&quot;<!--#echo var="VAR_threading-index-style"-->&quot;</A>
31096 and currently have the folder sorted by a Threaded or OrderedSubject sort.
31097 When you are Viewing a particular thread you have a
31098 MESSAGE INDEX of only the messages in that thread.
31099 If you press the Next command with the last message in the thread highlighted
31100 you will normally be asked if you want to &quot;View next thread?&quot;,
31101 assuming there is a next thread to view.
31102 If this feature is set it will be assumed that you always want to view the
31103 next thread and you won't be asked to confirm that.
31104 Similarly, if the first message of the thread is highlighted and you
31105 press the Prev command, this feature will prevent the question
31106 &quot;View previous thread&quot;.
31107 <P>
31108 This feature only has an effect in the MESSAGE INDEX screen.
31109 If you then view a particular message from that screen and press the
31110 Next command, you will be sent to the next thread without being asked,
31111 independent of the setting of this feature.
31112 <P>
31113 The feature
31114 <A HREF="h_config_auto_open_unread">&quot;<!--#echo var="FEAT_auto-open-next-unread"-->&quot;</A> also has some similar effects.
31115 <P>
31116 &lt;End of help on this topic&gt;
31117 </BODY>
31118 </HTML>
31119 ====== h_config_kw_braces =====
31120 <HTML>
31121 <HEAD>
31122 <TITLE>OPTION: <!--#echo var="VAR_keyword-surrounding-chars"--></TITLE>
31123 </HEAD>
31124 <BODY>
31125 <H1>OPTION: <!--#echo var="VAR_keyword-surrounding-chars"--></H1>
31126
31127 This option controls a minor aspect of Alpine's MESSAGE INDEX and MESSAGE
31128 TEXT screens.
31129 If you have modified the
31130 &quot;<A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A>&quot; option
31131 so that either the &quot;SUBJKEY&quot; or &quot;SUBJKEYINIT&quot; tokens
31132 are used to display keywords or their initials along with the Subject; then
31133 this option may be used to modify the resulting display slightly.
31134 By default, the keywords or initials displayed for these tokens will be
31135 surrounded with curly braces ({ and }) and a trailing space.
31136 For example, if keywords &quot;Work&quot; and &quot;Now&quot; are set for
31137 a message, the &quot;SUBJKEY&quot; token will normally look like
31138 <P>
31139 <CENTER><SAMP>{Work Now} actual subject</SAMP></CENTER>
31140 <P>
31141 and the SUBJKEYINIT token would look like
31142 <P>
31143 <CENTER><SAMP>{WN} actual subject</SAMP></CENTER>
31144 <P>
31145 The default character before the keywords is the left brace ({) and the
31146 default after the keywords is the right brace followed by a space (} ).
31147 <P>
31148 This option allows you to change that.
31149 You should set it to two values separated by a space.
31150 The values may be quoted if they include space characters.
31151 So, for example, the default value could be specified explicitly by setting this
31152 option to
31153 <P>
31154 <CENTER><SAMP><!--#echo var="VAR_keyword-surrounding-chars"-->="{" "}&nbsp;"</SAMP></CENTER>
31155 <P>
31156 The first part wouldn't need to be quoted (but it doesn't hurt).
31157 The second part does need the quotes because it includes a space character.
31158 If you wanted to change the braces to brackets you could use
31159 <P>
31160 <CENTER><SAMP><!--#echo var="VAR_keyword-surrounding-chars"-->="[" "]&nbsp;"</SAMP></CENTER>
31161 <P>
31162 Inside the quotes you can use backslash quote to mean quote, so
31163 <P>
31164 <CENTER><SAMP><!--#echo var="VAR_keyword-surrounding-chars"-->="&#92;"" "&#92;" "</SAMP></CENTER>
31165 <P>
31166 would produce
31167 <P>
31168 <CENTER><SAMP>"Work Now" actual subject</SAMP></CENTER>
31169 <P>
31170 It is also possible to color keywords in the index using the
31171 Setup/Kolor screen (<A HREF="h_config_kw_color">Keyword Colors</A>).
31172 <P>
31173 It is not possible to change the fact that a space character is used to
31174 separate the keywords if more than one keyword is set for a message.
31175 It is also not possible to change the fact that there are no separators
31176 between the keyword initials if more than one keyword is set.
31177 <P>
31178 &lt;End of help on this topic&gt;
31179 </BODY>
31180 </HTML>
31181 ====== h_config_opening_sep =====
31182 <HTML>
31183 <HEAD>
31184 <TITLE>OPTION: <!--#echo var="VAR_opening-text-separator-chars"--></TITLE>
31185 </HEAD>
31186 <BODY>
31187 <H1>OPTION: <!--#echo var="VAR_opening-text-separator-chars"--></H1>
31188
31189 This option controls a minor aspect of Alpine's MESSAGE INDEX screen.
31190 With some setups the text of the subject is followed
31191 by the opening text of the message if there is any room available in the index line.
31192 If you have configured your
31193 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option
31194 to include one of the Subject tokens that causes this behavior
31195 (SUBJECTTEXT, SUBJKEYTEXT, or SUBJKEYINITTEXT), then this option may be used
31196 to modify what is displayed slightly.
31197 By default, the Subject is separated from the opening text of the message by
31198 the three characters space dash space;
31199 <P>
31200 <CENTER><SAMP>&quot;&nbsp;-&nbsp;&quot;</SAMP></CENTER>
31201 <P>
31202 Use this option to set it to something different.
31203 The value must be quoted if it includes any space characters.
31204 For example, the default value could be specified explicitly by setting this
31205 option to
31206 <P>
31207 <CENTER><SAMP><!--#echo var="VAR_opening-text-separator-chars"-->="&nbsp;-&nbsp;"</SAMP></CENTER>
31208 <P>
31209 &lt;End of help on this topic&gt;
31210 </BODY>
31211 </HTML>
31212 ====== h_config_select_wo_confirm =====
31213 <HTML>
31214 <HEAD>
31215 <TITLE>FEATURE: <!--#echo var="FEAT_select-without-confirm"--></TITLE>
31216 </HEAD>
31217 <BODY>
31218 <H1>FEATURE: <!--#echo var="FEAT_select-without-confirm"--></H1>
31219
31220 This feature controls an aspect of Alpine's Save, Export, and Goto commands.
31221 These commands all take text input to specify the name of the folder or
31222 file to be used, but allow you to press ^T for a list of possible names.
31223 If set, the selected name will be used immediately, without further
31224 opportunity to confirm or edit the name.
31225 <P>
31226 Some related help topics are
31227 <UL>
31228 <LI> <A HREF="h_mainhelp_aggops">Aggregate Operations</A>
31229 <LI> <A HREF="h_index_cmd_select">Selecting: Select and WhereIs/Select</A>,
31230 <LI> <A HREF="h_config_enable_agg_ops"><!--#echo var="FEAT_enable-aggregate-command-set"--></A>,
31231 <LI> <A HREF="h_config_auto_unselect"><!--#echo var="FEAT_auto-unselect-after-apply"--></A>.
31232 <LI> <A HREF="h_config_auto_unzoom"><!--#echo var="FEAT_auto-unzoom-after-apply"--></A>, and
31233 <LI> <A HREF="h_config_auto_zoom"><!--#echo var="FEAT_auto-zoom-after-select"--></A>.
31234 </UL>
31235 <P>
31236 &lt;End of help on this topic&gt;
31237 </BODY>
31238 </HTML>
31239 ====== h_config_save_part_wo_confirm =====
31240 <HTML>
31241 <HEAD>
31242 <TITLE>FEATURE: <!--#echo var="FEAT_save-partial-msg-without-confirm"--></TITLE>
31243 </HEAD>
31244 <BODY>
31245 <H1>FEATURE: <!--#echo var="FEAT_save-partial-msg-without-confirm"--></H1>
31246
31247 This feature controls an aspect of Alpine's Save command.
31248 By default, when you Save a message that has some deleted parts, you will
31249 be asked to confirm that you want to Save with a prompt that looks like:
31250 <P>
31251 <CENTER><SAMP>Saved copy will NOT include entire message!  Continue?</SAMP></CENTER>
31252 <P>
31253 If this feature is set, you will not be asked.
31254 <P>
31255 &lt;End of help on this topic&gt;
31256 </BODY>
31257 </HTML>
31258 ====== h_config_use_resentto =====
31259 <HTML>
31260 <HEAD>
31261 <TITLE>FEATURE: <!--#echo var="FEAT_use-resent-to-in-rules"--></TITLE>
31262 </HEAD>
31263 <BODY>
31264 <H1>FEATURE: <!--#echo var="FEAT_use-resent-to-in-rules"--></H1>
31265
31266 This feature is turned off by default because turning it on causes problems
31267 with some deficient IMAP servers.
31268 In Alpine <A HREF="h_mainhelp_filtering">Filters</A> and other types of Rules, if the
31269 <A HREF="h_rule_patterns">Pattern</A>
31270 contains a To header pattern and this feature is turned on,
31271 then a check is made in the message to see
31272 if a Resent-To header is present, and that is used instead of the To header.
31273 If this feature is not turned on, then the regular To header will always
31274 be used.
31275
31276 <P>
31277 &lt;End of help on this topic&gt;
31278 </BODY>
31279 </HTML>
31280 ====== h_config_use_reg_start_for_stayopen =====
31281 <HTML>
31282 <HEAD>
31283 <TITLE>FEATURE: <!--#echo var="FEAT_use-regular-startup-rule-for-stayopen-folders"--></TITLE>
31284 </HEAD>
31285 <BODY>
31286 <H1>FEATURE: <!--#echo var="FEAT_use-regular-startup-rule-for-stayopen-folders"--></H1>
31287
31288 This feature affects which message is selected as the current message
31289 when you enter a
31290 <A HREF="h_config_permlocked">Stay Open</A> folder.
31291 <P>
31292 Normally, the starting position for an incoming folder (which most Stay Open
31293 folders will likely be) is controlled by the
31294 <A HREF="h_config_inc_startup"><!--#echo var="VAR_incoming-startup-rule"--></A>.
31295 However, if a folder is a Stay Open folder, when you re-enter the folder
31296 after the first time the current message will be the same as it was when
31297 you left the folder.
31298 An exception is made if you use the TAB command to get to the folder.
31299 In that case, the message number will be incremented by one from what it
31300 was when you left the folder.
31301 <P>
31302 The above special behavior is thought to be useful.
31303 However, it is special and different from what you might at first expect.
31304 If this feature is set, then Stay Open folders will not be treated specially
31305 as far as the startup rule is concerned.
31306
31307 <P>
31308 &lt;End of help on this topic&gt;
31309 </BODY>
31310 </HTML>
31311 ====== h_config_use_current_dir =====
31312 <HTML>
31313 <HEAD>
31314 <TITLE>FEATURE: <!--#echo var="FEAT_use-current-dir"--></TITLE>
31315 </HEAD>
31316 <BODY>
31317 <H1>FEATURE: <!--#echo var="FEAT_use-current-dir"--></H1>
31318
31319 This feature controls an aspect of several commands.
31320 If set, your &quot;current working directory&quot;
31321 <!--chtml if pinemode="running"-->
31322 (which, at least for your current Alpine &quot;session,&quot;
31323 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
31324 <!--chtml endif-->
31325 will be used instead of your home directory
31326 <!--chtml if pinemode="running"-->
31327 (which, in the present configuration of your system, is
31328  &quot;<!--#echo var="HOME_DIR"-->&quot;)
31329 <!--chtml endif-->
31330 for all of the following operations:<UL>
31331     <LI> Export in the MESSAGE INDEX and MESSAGE TEXT screens
31332     <LI> Attachment Save in the MESSAGE TEXT and ATTACHMENT TEXT screens
31333     <LI> <!--chtml if pinemode="function_key"-->F4
31334          <!--chtml else-->Ctrl-R
31335          <!--chtml endif--> file inclusion in the COMPOSER
31336     <LI> <!--chtml if pinemode="function_key"-->F5
31337          <!--chtml else-->Ctrl-J
31338          <!--chtml endif--> file attachment in the COMPOSER
31339 </UL>
31340 <!--chtml if pinemode="os_windows"-->
31341 <P>
31342 If you are starting PC-Alpine from a desktop icon or the Start menu,
31343 you can set the &quot;current drive&quot;
31344 by specifying it in the &quot;Start in:&quot;
31345 box found in the Shortcut tab of the Properties.
31346 <!--chtml endif-->
31347 <P>
31348 <UL>
31349 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31350 </UL>
31351
31352 <P>
31353 &lt;End of help on this topic&gt;
31354 </BODY>
31355 </HTML>
31356 ====== h_config_save_wont_delete =====
31357 <HTML>
31358 <HEAD>
31359 <TITLE>FEATURE: <!--#echo var="FEAT_save-will-not-delete"--></TITLE>
31360 </HEAD>
31361 <BODY>
31362 <H1>FEATURE: <!--#echo var="FEAT_save-will-not-delete"--></H1>
31363
31364 This feature controls one aspect of the Save command.  If set, Save will
31365 not mark the message &quot;deleted&quot; (its default behavior) after
31366 it has been copied to the designated folder.
31367
31368 <P>
31369 &lt;End of help on this topic&gt;
31370 </BODY>
31371 </HTML>
31372 ====== h_config_use_boring_spinner =====
31373 <HTML>
31374 <HEAD>
31375 <TITLE>FEATURE: <!--#echo var="FEAT_busy-cue-spinner-only"--></TITLE>
31376 </HEAD>
31377 <BODY>
31378 <H1>FEATURE: <!--#echo var="FEAT_busy-cue-spinner-only"--></H1>
31379
31380 When Alpine is delayed for some reason it usually shows that
31381 something is happening with a small animated display in the status
31382 message line near the bottom of the screen.
31383 Setting this feature will cause that animation to be the same
31384 each time instead of having Alpine choose a random animation.
31385 You may turn the animation off altogether by setting the
31386 <A HREF="h_config_active_msg_interval"><!--#echo var="VAR_busy-cue-rate"--></A>
31387 option to zero.
31388
31389 <P>
31390 &lt;End of help on this topic&gt;
31391 </BODY>
31392 </HTML>
31393 ====== h_config_unsel_wont_advance =====
31394 <HTML>
31395 <HEAD>
31396 <TITLE>FEATURE: <!--#echo var="FEAT_unselect-will-not-advance"--></TITLE>
31397 </HEAD>
31398 <BODY>
31399 <H1>FEATURE: <!--#echo var="FEAT_unselect-will-not-advance"--></H1>
31400
31401 This feature controls one aspect of the Unselect Current message command.
31402 Normally, when the Unselect current message command (:) is typed when the
31403 current message is selected, the message will be unselected and the next
31404 message will become the current message.
31405 If this feature is set, the cursor will not advance to the next message.
31406 Instead, the current message will remain the current message after
31407 unselecting.
31408
31409 <P>
31410 &lt;End of help on this topic&gt;
31411 </BODY>
31412 </HTML>
31413 ====== h_config_prune_uses_iso =====
31414 <HTML>
31415 <HEAD>
31416 <TITLE>FEATURE: <!--#echo var="FEAT_prune-uses-yyyy-mm"--></TITLE>
31417 </HEAD>
31418 <BODY>
31419 <H1>FEATURE: <!--#echo var="FEAT_prune-uses-yyyy-mm"--></H1>
31420
31421 By default, Alpine asks monthly whether or not you would like to rename
31422 some folders to a new name containing the date.
31423 It also asks whether or not you would like to delete some old folders.
31424 See the <A HREF="h_config_pruning_rule"><!--#echo var="VAR_pruning-rule"--></A> option for an
31425 explanation.
31426
31427 <P>
31428 By default, the name used when renaming a folder looks like
31429 <P>
31430 <CENTER><SAMP>&lt;foldername&gt;-&lt;month&gt;-&lt;year&gt;</SAMP></CENTER>
31431 <P>
31432 For example, the first time you run Alpine in May of 2004,
31433 the folder &quot;sent-mail&quot; might be renamed to
31434 <P>
31435 <CENTER><SAMP>sent-mail-apr-2004</SAMP></CENTER>
31436 <P>
31437 If this feature is set, the name used will be of the form
31438 <P>
31439 <CENTER><SAMP>&lt;foldername&gt;-&lt;yyyy&gt;-&lt;mm&gt;</SAMP></CENTER>
31440 <P>
31441 where &quot;yyyy&quot; is the year and &quot;mm&quot; is the two-digit
31442 month (01, 02, ..., 12).
31443 For the April, 2004 example above, it would instead be
31444 <P>
31445 <CENTER><SAMP>sent-mail-2004-04</SAMP></CENTER>
31446 <P>
31447 because April is the 4th month of the year.
31448 A reason you might want to set this feature is so that the folders
31449 will sort in chronological order.
31450
31451 <P>
31452 &lt;End of help on this topic&gt;
31453 </BODY>
31454 </HTML>
31455 ====== h_config_save_advances =====
31456 <HTML>
31457 <HEAD>
31458 <TITLE>FEATURE: <!--#echo var="FEAT_save-will-advance"--></TITLE>
31459 </HEAD>
31460 <BODY>
31461 <H1>FEATURE: <!--#echo var="FEAT_save-will-advance"--></H1>
31462
31463 This feature controls one aspect of the Save command.  If set, Save will
31464 (in addition to copying the current message to the designated folder) also
31465 advance to the next message.
31466
31467 <P>
31468 &lt;End of help on this topic&gt;
31469 </BODY>
31470 </HTML>
31471 ====== h_config_force_arrow =====
31472 <HTML>
31473 <HEAD>
31474 <TITLE>FEATURE: <!--#echo var="FEAT_force-arrow-cursor"--></TITLE>
31475 </HEAD>
31476 <BODY>
31477 <H1>FEATURE: <!--#echo var="FEAT_force-arrow-cursor"--></H1>
31478
31479 This feature affects Alpine's MESSAGE INDEX display routine.
31480 If set, the normal inverse-video cursor will be
31481 replaced by a simple &quot;arrow&quot; cursor, which normally occupies the
31482 second column of the index display.
31483 <P>
31484 This is the same index cursor you get if you turn on
31485 <A HREF="h_config_force_low_speed"><!--#echo var="FEAT_assume-slow-link"--></A>, but the index
31486 line coloring will still be present if this feature is turned on and
31487 <!--#echo var="FEAT_assume-slow-link"--> is off.
31488 <P>
31489 An alternative version of the Arrow cursor is available by including the
31490 <A HREF="h_config_index_arrow_color">ARROW</A>
31491 token in the
31492 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option.
31493 <P>
31494 It ought to be the case that this feature also affects the ATTACHMENT INDEX,
31495 but that is not implemented.
31496
31497 <P>
31498 &lt;End of help on this topic&gt;
31499 </BODY>
31500 </HTML>
31501 ====== h_config_ignore_size =====
31502 <HTML>
31503 <HEAD>
31504 <TITLE>FEATURE: <!--#echo var="FEAT_ignore-size-changes"--></TITLE>
31505 </HEAD>
31506 <BODY>
31507 <H1>FEATURE: <!--#echo var="FEAT_ignore-size-changes"--></H1>
31508
31509 When you have an account residing in an IMAP server, Alpine records the
31510 size of each message as reported by the server. However, when Alpine saves
31511 a message in such IMAP server, Alpine will compute the size of the message
31512 independently, from the data it received. If these two numbers do not
31513 match for a message, Alpine asks you if you still want to take the risk of
31514 saving such message, since data corruption or loss of data could result
31515 from this save.
31516
31517 <P>
31518 Sometimes the root of this problem is that the IMAP server does not
31519 compute sizes correctly, and there will not be loss of information when
31520 saving such message. Enabling this feature will make Alpine ignore such
31521 error and continue saving the message without producing any warnings or
31522 ever stopping the process, as if there had not been any error. This option
31523 applies to all IMAP servers that you use, so if you enable this feature,
31524 size discrepancy warnings will not be given for any IMAP server you
31525 connect to.
31526
31527 <P>
31528 Example of a server where you could reproduce this problem is the Gmail
31529 IMAP server. Another example can be found in some versions of the Exchange
31530 server.
31531
31532 <P>
31533 It is recommended that this feature be disabled most of the time and only
31534 enabled when you find a server which you can determine that has the above
31535 mentioned defect, but be disabled again after making the save operation
31536 succeed.
31537
31538 <P>
31539 &lt;End of help on this topic&gt;
31540 </BODY>
31541 </HTML>
31542 ====== h_config_force_low_speed =====
31543 <HTML>
31544 <HEAD>
31545 <TITLE>FEATURE: <!--#echo var="FEAT_assume-slow-link"--></TITLE>
31546 </HEAD>
31547 <BODY>
31548 <H1>FEATURE: <!--#echo var="FEAT_assume-slow-link"--></H1>
31549
31550 UNIX Alpine only.
31551 <P>
31552 This feature affects Alpine's display routines.  If set, the normal
31553 inverse-video cursor (used to highlight the current item in a list) will be
31554 replaced by an &quot;arrow&quot; cursor and other
31555 screen update optimizations for
31556 low-speed links (e.g. 2400 bps dialup connections) will be activated.
31557 One of the optimizations is that colored index lines (set up with Indexcolor
31558 Rules) will not be colored.
31559 If you are just turning this feature on because you like using
31560 the &quot;arrow&quot; cursor you may have an arrow cursor with index line
31561 coloring by turning this feature off and the
31562 <A HREF="h_config_force_arrow"><!--#echo var="FEAT_force-arrow-cursor"--></A> on.
31563
31564 <P>
31565 &lt;End of help on this topic&gt;
31566 </BODY>
31567 </HTML>
31568 ====== h_config_show_delay_cue =====
31569 <HTML>
31570 <HEAD>
31571 <TITLE>FEATURE: <!--#echo var="FEAT_enable-mail-check-cue"--></TITLE>
31572 </HEAD>
31573 <BODY>
31574 <H1>FEATURE: <!--#echo var="FEAT_enable-mail-check-cue"--></H1>
31575
31576 If set, this feature will cause an asterisk to appear in the upper
31577 left-hand corner of the screen whenever Alpine checks for new mail.
31578 Two asterisks whenever Alpine saves (checkpoints) the state of the current
31579 mailbox to disk.
31580
31581 <!--chtml if pinemode="os_windows"-->
31582 <P>
31583 In addition, PC-Alpine will display a less-than symbol, '&lt;', when
31584 it is trying to open a network connection (e.g, to open your INBOX
31585 on an IMAP
31586 server) or read from the network connection.  A greater-than symbol,
31587 will be displayed when PC-Alpine is trying to write to the network
31588 connection (e.g, sending a command to your IMAP server).
31589 <!--chtml endif-->
31590
31591 <P>
31592 &lt;End of help on this topic&gt;
31593 </BODY>
31594 </HTML>
31595 ====== h_config_color_style =====
31596 <HTML>
31597 <HEAD>
31598 <TITLE>OPTION: Color Style</TITLE>
31599 </HEAD>
31600 <BODY>
31601 <H1>OPTION: Color Style</H1>
31602
31603 UNIX Alpine only.
31604 <P>
31605 If the terminal or terminal emulator you are using is capable of displaying
31606 colors, this option controls whether or not color will be used in Alpine.
31607 If you turn color on and things are set up correctly,
31608 you should see color appear on the screen immmediately.
31609 Modern terminal emulators are usually capable of displaying colors.
31610 <P>
31611 The available options include:
31612 <P>
31613
31614 <DL>
31615 <DT>no-color</DT>
31616 <DD>Don't use color.
31617 </DD>
31618
31619 <DT>use-termdef</DT>
31620 <DD>In order to decide if your terminal is capable of color, Alpine looks in
31621 the terminal capabilities database, TERMINFO or TERMCAP, depending on
31622 how Alpine was compiled.
31623 This is a good option to choose if you switch between a color and a non-color
31624 terminal with the same Alpine configuration.
31625 Alpine will know to use color on the color terminal because it is described
31626 in the termcap entry, and Alpine will know to use black and white on the
31627 non-color terminal.
31628 The Alpine Technical Notes
31629 <CENTER><SAMP><A HREF="http://www.washington.edu/alpine/tech-notes/">http://www.washington.edu/alpine/tech-notes/</A></SAMP></CENTER>
31630 have more information on configuring a TERMCAP or TERMINFO
31631 entry for color Alpine.
31632 This is usually something a system administrator does.
31633 </DD>
31634
31635 <DT>force-ansi-8color</DT>
31636 <DD>This is probably the setting that most people should use.
31637 Because setting up a termcap entry is confusing and because the
31638 terminal capabilities database is often not correctly configured for color,
31639 this choice and the next may be easier for you to use.
31640 If your terminal emulator responds to ANSI color escape sequences, which
31641 many do, this option will cause Alpine to believe your terminal will respond
31642 to the escape sequences that produce eight different foreground and background
31643 colors.
31644 The escape sequences used to set the foreground colors are
31645
31646   <P><CENTER>ESC&nbsp;[&nbsp;3&nbsp;&lt;color_number&gt;&nbsp;m</CENTER><P>
31647
31648 where the color_number is an ASCII digit between 0 and 7.
31649 The numbers 0 through 7 should correspond to the colors black, red, green,
31650 yellow, blue, magenta, cyan, and white.
31651 Some terminal emulators use a pre-ANSI scheme that swaps
31652 the colors blue and red and the colors yellow and cyan.
31653 This will cause the default colors to be different, but other than that
31654 things should work fine.
31655 There is also a 9th color available, the last one shown, which is the default
31656 color from the terminal emulator.
31657 When used as a background color some people refer to this color as
31658 &quot;transparent&quot;, which is why the letters &quot;TRAN&quot; are
31659 shown in the color swatch of the SETUP COLOR screen.
31660 The foreground transparent color is shown as
31661 the color of the &quot;TRAN&quot; text.
31662 (The transparent color will not work correctly in a PC-Alpine configuration.)
31663 The escape sequences used to set the background colors are the same
31664 as for the foreground colors except a &quot;4&quot; replaces the &quot;3&quot;.
31665 The escape sequences for foreground and background default colors (transparent)
31666 are 39m and 49m.
31667 <P>
31668 Note: With the Tera Term terminal emulator this setting works well.
31669 You should also have the Tera Term &quot;Full color&quot; option turned OFF.
31670 You may find the &quot;Full color&quot; option in Tera Term's &quot;Setup&quot;
31671 menu, in the &quot;Window&quot; submenu.
31672 </DD>
31673
31674 <DT>force-ansi-16color</DT>
31675 <DD>Many terminal emulators know about the same eight colors above
31676 plus eight more.
31677 This option attempts to use all 16 colors.
31678 The same escape sequences as for the eight-color terminal are used
31679 for the first eight colors.
31680 The escape sequences used to set foreground colors 8-15 are the same as
31681 for 0-7 except the &quot;3&quot; is replaced with a &quot;9&quot;.
31682 The background color sequences for colors 8-15 are the same as for 0-7
31683 except the &quot;4&quot; is replaced with &quot;10&quot;.
31684 You can tell if the 16 colors are working by turning on this option
31685 and then going into one of the color configuration screens, for example,
31686 the configuration screen for Normal Color.
31687 If you see 16 different colors to select from (plus a 17th for
31688 the transparent color), it's working.
31689 </DD>
31690
31691 <DT>force-xterm-256color</DT>
31692 <DD>Some versions of xterm (and some other terminal emulators)
31693 have support for 256 colors.
31694 The escape sequences used to set the foreground colors are
31695
31696   <P><CENTER>ESC&nbsp;[&nbsp;38&nbsp;;&nbsp;5&nbsp;;&nbsp;&lt;color_number&gt;&nbsp;m</CENTER><P>
31697
31698 where the color_number is an ASCII digit between 0 and 255.
31699 Background colors are the same with the 38 replaced with a 48.
31700 The numbers 0 through 15 are probably similar to the 16 color version
31701 above, then comes a 6x6x6 color cube, followed by 24 colors of gray.
31702 The terminal default (transparent) color is the 257th color at the bottom.
31703 Some terminal emulators will misinterpret these escape sequences causing
31704 the terminal to blink or overstrike characters or to do something else
31705 undesirable.
31706 <P>
31707 The PuTTY terminal emulator has an option called &quot;Allow terminal to
31708 use xterm 256-colour mode&quot; which allows PuTTY to work well with
31709 this 256-color setting.
31710
31711 </DD>
31712 </DL>
31713
31714 <P>
31715 The normal default is &quot;no-color&quot;.
31716 <P>
31717
31718 Once you've turned on color you may set the
31719 colors of many objects on the screen individually.
31720 For example, you may add colors to the status letters on the MESSAGE
31721 INDEX page.
31722 Most categories of color that Alpine supports are configurable here.
31723 For example, &quot;Normal Color&quot;
31724 is the color used to display most of the text in Alpine, and
31725 &quot;Reverse Color&quot; is used to display highlighted text, such as the
31726 current message in the MESSAGE INDEX.
31727 <P>
31728 Lines in the MESSAGE INDEX may also be colored.
31729 Use Setup Rules to get to the Indexcolor configuration screen.
31730 <P>
31731
31732 <UL>
31733 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31734 </UL><P>
31735 &lt;End of help on this topic&gt;
31736 </BODY>
31737 </HTML>
31738 ====== h_config_disable_index_locale_dates =====
31739 <HTML>
31740 <HEAD>
31741 <TITLE>FEATURE: <!--#echo var="FEAT_disable-index-locale-dates"--></TITLE>
31742 </HEAD>
31743 <BODY>
31744 <H1>FEATURE: <!--#echo var="FEAT_disable-index-locale-dates"--></H1>
31745
31746 This feature affects the display of dates in the MESSAGE INDEX.
31747 Normally an attempt is made to localize the dates
31748 used in the MESSAGE INDEX display to your locale.
31749 This is controlled with the
31750 LC_TIME locale setting on a UNIX system.
31751 On Windows the Regional Options control panel may be used to set the date format.
31752 At the programming level, Alpine is using the strftime routine
31753 to print the parts of a date.
31754 <P>
31755 If this feature is set, dates are displayed in English and
31756 with the conventions of the United States.
31757 <P>
31758
31759 <UL>
31760 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31761 </UL><P>
31762 &lt;End of help on this topic&gt;
31763 </BODY>
31764 </HTML>
31765 ====== h_config_auto_open_unread =====
31766 <HTML>
31767 <HEAD>
31768 <TITLE>FEATURE: <!--#echo var="FEAT_auto-open-next-unread"--></TITLE>
31769 </HEAD>
31770 <BODY>
31771 <H1>FEATURE: <!--#echo var="FEAT_auto-open-next-unread"--></H1>
31772
31773 This feature controls the behavior of the TAB key when traversing folders
31774 in the optional
31775 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
31776 collection or in optional <!--#echo var="VAR_news-collections"-->.
31777 <P>
31778 When the TAB
31779 (<A HREF="h_common_nextnew">NextNew</A>)
31780 key is pressed, and there
31781 are no more unseen messages in the current (incoming message or news)
31782 folder, Alpine will search the list of folders in the current collection for
31783 one containing New or Recent (new since the last time the folder was
31784 opened) messages.
31785 This behavior may be modified slightly with the
31786 <A HREF="h_config_tab_uses_unseen">&quot;<!--#echo var="FEAT_tab-uses-unseen-for-next-folder"-->&quot;</A>
31787 feature that causes Alpine to look for Unseen messages instead of Recent
31788 messages.
31789 Normally, when such a folder is found, Alpine will ask
31790 whether you wish to open the folder.  If this feature is set, Alpine will
31791 automatically open the folder without prompting.
31792 <P>
31793 This feature also affects some other similar situations.
31794 If you have a
31795 <A HREF="h_config_thread_index_style"><!--#echo var="VAR_threading-index-style"--></A>
31796 that is equal to one of the &quot;separate-&quot; values, and you are
31797 viewing a thread; then when you type the NextNew command and are at the
31798 end of the current thread you will automatically go to the next thread
31799 if this feature is set.
31800 By default, you would be asked if you want to view the next thread.
31801 You will also be asked at times whether or not you want to view the next
31802 thread after you delete the last message in the thread.
31803 Setting this feature will also cause that question to be skipped.
31804 <P>
31805
31806 <UL>
31807 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31808 </UL><P>
31809 &lt;End of help on this topic&gt;
31810 </BODY>
31811 </HTML>
31812 ====== h_config_auto_include_reply =====
31813 <HTML>
31814 <HEAD>
31815 <TITLE>FEATURE: <!--#echo var="FEAT_include-text-in-reply"--></TITLE>
31816 </HEAD>
31817 <BODY>
31818 <H1>FEATURE: <!--#echo var="FEAT_include-text-in-reply"--></H1>
31819
31820 This feature controls an aspect of Alpine's Reply command.  Normally, Alpine
31821 will ask whether you wish to include the original message in your reply.
31822 If this feature is set and the feature
31823 <A HREF="h_config_prefix_editing">&quot;<!--#echo var="FEAT_enable-reply-indent-string-editing"-->&quot;</A>
31824 is <EM>not</EM> set, then the original message will be included in the reply
31825 automatically, without prompting.
31826 <P>
31827 &lt;End of help on this topic&gt;
31828 </BODY>
31829 </HTML>
31830 ====== h_config_select_in_bold =====
31831 <HTML>
31832 <HEAD>
31833 <TITLE>FEATURE: <!--#echo var="FEAT_show-selected-in-boldface"--></TITLE>
31834 </HEAD>
31835 <BODY>
31836 <H1>FEATURE: <!--#echo var="FEAT_show-selected-in-boldface"--></H1>
31837
31838 This feature controls an aspect of Alpine's
31839 <A HREF="h_config_enable_agg_ops">&quot;aggregate operation&quot;</A>
31840 commands; in
31841 particular, the Select and WhereIs commands. Select and WhereIs (with the
31842 ^X subcommand) will search the current folder for messages meeting a
31843 specified criteria, and &quot;tag&quot; the resulting messages with an
31844 &quot;X&quot; in the
31845 first column of the applicable lines in the MESSAGE INDEX.  If this feature
31846 is set, instead of using the &quot;X&quot; to denote a selected message,
31847 Alpine will
31848 attempt to display those index lines in boldface. Whether this is
31849 preferable to the &quot;X&quot; will depend on personal taste and the type of
31850 terminal being used.
31851 <P>
31852 <UL>
31853 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31854 </UL><P>
31855 &lt;End of help on this topic&gt;
31856 </BODY>
31857 </HTML>
31858 ====== h_config_alt_auth =====
31859 <HTML>
31860 <HEAD>
31861 <TITLE>FEATURE: <!--#echo var="FEAT_try-alternative-authentication-driver-first"--></TITLE>
31862 </HEAD>
31863 <BODY>
31864 <H1>FEATURE: <!--#echo var="FEAT_try-alternative-authentication-driver-first"--></H1>
31865
31866 This feature affects how Alpine connects to IMAP servers.
31867 It's utility has largely been overtaken by events,
31868 but it may still be useful in some circumstances.
31869 If you only connect to modern IMAP servers that support
31870 &quot;TLS&quot; you can ignore this feature.
31871
31872 <P>
31873 Details:
31874
31875 <P>
31876 By default, Alpine will attempt to connect to an IMAP server on the
31877 normal IMAP service port (143), and if the server offers &quot;Transport Layer
31878 Security&quot; (TLS) and Alpine has been compiled with encryption capability,
31879 then a secure (encrypted) session will be negotiated.
31880
31881 <P>
31882 With this feature enabled, before connecting on the normal IMAP port, Alpine
31883 will first attempt to connect to an alternate IMAP service port (993) used
31884 specifically for encrypted IMAP sessions via the Secure Sockets Layer
31885 (SSL) method.
31886 If the SSL attempt fails, Alpine will then try the default
31887 behavior described in the previous paragraph.
31888
31889 <P>
31890 TLS negotiation on the normal port is preferred, and supersedes the use of
31891 SSL on port 993, but older servers may not provide TLS support.
31892 This feature may be convenient when accessing IMAP servers that do not support
31893 TLS, but do support SSL connections on port 993.
31894 However, it is important to understand that with this feature enabled,
31895 Alpine will <EM>attempt</EM> to make a secure connection if that is possible,
31896 but it will proceed to make an insecure connection if that is the only
31897 option offered by the server, or if the Alpine in question has been built
31898 without encryption capability.
31899
31900 <P>
31901 Note that this feature specifies a per-user (or system-wide) default
31902 behavior, but host/folder specification flags may be used to control the
31903 behavior of any specific connection.
31904 This feature interacts with some of
31905 the possible host/folder path specification flags as follows:
31906
31907 <P>
31908 The <SAMP>/tls</SAMP> host flag, for example,
31909
31910 <P>
31911 <CENTER><SAMP>{foo.example.com/tls}INBOX</SAMP></CENTER>
31912 <P>
31913 will over-ride this feature for the specified host by bypassing the
31914 SSL connection attempt.
31915 Moreover, with <SAMP>/tls</SAMP> specified,
31916 the connection attempt will fail if the
31917 service on port 143 does not offer TLS support.
31918
31919 <P>
31920 The <SAMP>/ssl</SAMP> host flag, for example,
31921
31922 <P>
31923 <CENTER><SAMP>{foo.example.com/ssl}INBOX</SAMP></CENTER>
31924 <P>
31925 will insist on an SSL connection for the specified host,
31926 and will fail if the SSL service on port 993 is not available.
31927 Alpine will not subsequently retry a connection
31928 on port 143 if <SAMP>/ssl</SAMP> is specified.
31929
31930 <P>
31931 <UL>
31932 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31933 </UL><P>
31934 &lt;End of help on this topic&gt;
31935 </BODY>
31936 </HTML>
31937 ====== h_config_file_dir ======
31938 <HTML>
31939 <HEAD>
31940 <TITLE>OPTION: File Directory</TITLE>
31941 </HEAD>
31942 <BODY>
31943 <H1>OPTION: File Directory</H1>
31944
31945 PC-Alpine only.
31946 <P>
31947 This value affects the Composer's &quot;^J&nbsp;Attach&quot; command,
31948 the Attachment Index Screen's &quot;S&nbsp;Save&quot; command, and the
31949 Message Index's &quot;E&nbsp;Export&quot; command.
31950
31951 <P>
31952 Normally, when a filename is supplied that lacks a leading &quot;path&quot;
31953 component, Alpine assumes the file exists in the user's home directory.
31954 Under Windows operating systems, this definition isn't always clear.  This
31955 feature allows you to explictly set where Alpine should look for files
31956 without a leading path.
31957
31958 <P>
31959 NOTE: this feature's value is ignored if either
31960 <A HREF="h_config_use_current_dir"><!--#echo var="FEAT_use-current-dir"--></A> feature
31961 is set or the PINERC has a value for the &quot;<!--#echo var="VAR_operating-dir"-->&quot; variable.
31962
31963 <P>
31964 <UL>
31965 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31966 </UL><P>
31967 &lt;End of help on this topic&gt;
31968 </BODY>
31969 </HTML>
31970 ====== h_config_quote_all_froms =====
31971 <HTML>
31972 <HEAD>
31973 <TITLE>FEATURE: <!--#echo var="FEAT_save-will-quote-leading-froms"--></TITLE>
31974 </HEAD>
31975 <BODY>
31976 <H1>FEATURE: <!--#echo var="FEAT_save-will-quote-leading-froms"--></H1>
31977
31978 This feature controls an aspect of the Save command (and also the way
31979 outgoing messages are saved to an FCC folder).  If set, Alpine will add
31980 a leading &quot;>&quot; character in front of message lines beginning with &quot;From&quot;
31981 when they are saved to another folder, including lines syntactically
31982 distinguishable from the type of message separator line commonly used on
31983 Unix systems.
31984
31985 <P>
31986 The default behavior is that a &quot;>&quot; will be prepended only to lines
31987 beginning with &quot;From &quot; that might otherwise be confused with a message
31988 separator line on Unix systems.  If pine is the only mail program you use,
31989 this default is reasonable.  If another program you use has trouble
31990 displaying a message with an unquoted &quot;From &quot; saved by Alpine, you should
31991 enable this feature.  This feature only applies to the common Unix mailbox
31992 format that uses message separator lines beginning with &quot;From &quot;.  If
31993 Alpine has been configured to use a different mailbox format (possibly
31994 incompatible with other mail programs), then this issue does not arise,
31995 and the feature is irrelevant.
31996
31997 <P>
31998 &lt;End of help on this topic&gt;
31999 </BODY>
32000 </HTML>
32001 ====== h_config_normal_color =====
32002 <HTML>
32003 <HEAD>
32004 <TITLE>OPTION: Normal Color</TITLE>
32005 </HEAD>
32006 <BODY>
32007 <H1>OPTION: Normal Color</H1>
32008
32009 Sets the color Alpine normally uses.
32010 The foreground color is the color of the actual character and the
32011 background color is the color of the area behind the character.
32012 By default this color is black characters on a white background.
32013 <P>
32014 <A HREF="h_color_setup">Descriptions of the available commands</A>
32015 <P>
32016 Look <A HREF="h_edit_nav_cmds">here</A>
32017 to see the available Editing and Navigation commands.
32018 <P>
32019 &lt;End of help on this topic&gt;
32020 </BODY>
32021 </HTML>
32022 ====== h_config_reverse_color =====
32023 <HTML>
32024 <HEAD>
32025 <TITLE>OPTION: Reverse Color</TITLE>
32026 </HEAD>
32027 <BODY>
32028 <H1>OPTION: Reverse Color</H1>
32029
32030 Sets the color Alpine uses for reverse video characters.
32031 The foreground color is the color of the actual character and the
32032 background color is the color of the area behind the character.
32033 <P>
32034 <A HREF="h_color_setup">Descriptions of the available commands</A>
32035 <P>
32036 Look <A HREF="h_edit_nav_cmds">here</A>
32037 to see the available Editing and Navigation commands.
32038 <P>
32039 &lt;End of help on this topic&gt;
32040 </BODY>
32041 </HTML>
32042 ====== h_config_title_color =====
32043 <HTML>
32044 <HEAD>
32045 <TITLE>OPTION: Title Color</TITLE>
32046 </HEAD>
32047 <BODY>
32048 <H1>OPTION: Title Color</H1>
32049
32050 Sets the color Alpine uses for the titlebar (the top line on the screen).
32051 The foreground color is the color of the actual character and the
32052 background color is the color of the area behind the character.
32053 By default, the Title Color is black characters on a yellow background.
32054 <P>
32055 The actual titlebar color may be different from the Title Color if
32056 the option
32057 <A HREF="h_config_titlebar_color_style">&quot;<!--#echo var="VAR_titlebar-color-style"-->&quot;</A>
32058 is set to some value other than the default.
32059 It may also be different if the current folder is closed and the
32060 <A HREF="h_config_titleclosed_color">Title Closed Color</A>
32061 color is set to something different from the Title Color.
32062 <P>
32063 <A HREF="h_color_setup">Descriptions of the available commands</A>
32064 <P>
32065 Look <A HREF="h_edit_nav_cmds">here</A>
32066 to see the available Editing and Navigation commands.
32067 <P>
32068 &lt;End of help on this topic&gt;
32069 </BODY>
32070 </HTML>
32071 ====== h_config_titleclosed_color =====
32072 <HTML>
32073 <HEAD>
32074 <TITLE>OPTION: Title Closed Color</TITLE>
32075 </HEAD>
32076 <BODY>
32077 <H1>OPTION: Title Closed Color</H1>
32078
32079 Sets the color Alpine uses for the titlebar (the top line on the screen)
32080 when the current folder is closed.
32081 The foreground color is the color of the actual character and the
32082 background color is the color of the area behind the character.
32083 By default, the Title Color Closed Color is white characters on a red background.
32084 <P>
32085 By setting this color to something noticeable you will be alerted to the
32086 fact that the current folder is closed, perhaps unexpectedly.
32087 <P>
32088 &lt;End of help on this topic&gt;
32089 </BODY>
32090 </HTML>
32091 ====== h_config_status_color =====
32092 <HTML>
32093 <HEAD>
32094 <TITLE>OPTION: Status Color</TITLE>
32095 </HEAD>
32096 <BODY>
32097 <H1>OPTION: Status Color</H1>
32098
32099 Sets the color Alpine uses for status messages written to the message
32100 line near the bottom of the screen.
32101 The foreground color is the color of the actual character and the
32102 background color is the color of the area behind the character.
32103 By default, the Status Color is the same as the Reverse Color.
32104 <P>
32105 <A HREF="h_color_setup">Descriptions of the available commands</A>
32106 <P>
32107 Look <A HREF="h_edit_nav_cmds">here</A>
32108 to see the available Editing and Navigation commands.
32109 <P>
32110 &lt;End of help on this topic&gt;
32111 </BODY>
32112 </HTML>
32113 ====== h_config_index_opening_color =====
32114 <HTML>
32115 <HEAD>
32116 <TITLE>OPTION: Index Opening Color</TITLE>
32117 </HEAD>
32118 <BODY>
32119 <H1>OPTION: Index Opening Color</H1>
32120
32121 With some setups the text of the subject is followed
32122 by the opening text of the message if there is any room available in the index line.
32123 If you have configured your
32124 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option
32125 to include one of the Subject tokens that causes this behavior
32126 (SUBJECTTEXT, SUBJKEYTEXT, or SUBJKEYINITTEXT), you may set the color of
32127 this opening text with this option.
32128 This coloring takes place for all but the current index line, and the Opening
32129 Color appears to be in front of any color from an Index Color Rule.
32130 <P>
32131 By default the Index Opening Color is gray characters on a white background.
32132
32133 <P>
32134 <A HREF="h_color_setup">Descriptions of the available commands</A>
32135 <P>
32136 Look <A HREF="h_edit_nav_cmds">here</A>
32137 to see the available Editing and Navigation commands.
32138 <P>
32139 &lt;End of help on this topic&gt;
32140 </BODY>
32141 </HTML>
32142 ====== h_config_index_pri_color =====
32143 <HTML>
32144 <HEAD>
32145 <TITLE>OPTION: Index Priority Symbol Colors</TITLE>
32146 </HEAD>
32147 <BODY>
32148 <H1>OPTION: Index Priority Symbol Colors</H1>
32149
32150 The X-Priority header is a non-standard header that is used in a
32151 somewhat standard way by many mail programs.
32152 Alpine expects the value of this header to be a digit with a value
32153 from 1 to 5, with 1 being the highest priority and 5 the lowest priority.
32154 Alpine can be made to display an indication of this priority in
32155 messages by use of one of the tokens
32156 (<A HREF="h_index_tokens">Tokens for Index and Replying</A>)
32157 PRIORITY, PRIORITYALPHA, or PRIORITY! in the
32158 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option.
32159
32160 <P>
32161 You may set the color used to draw these tokens by use of the colors
32162 Index High Priority Symbol Color and Index Low Priority Symbol Color.
32163 This coloring takes place for all but the current index line, and the Priority
32164 Color appears to be in front of any color from an Index Color Rule.
32165 If the priority has a value of 1 or 2 the High Priority color will be
32166 used,
32167 and if the value is 4 or 5 the Low Priority color will be used.
32168 <P>
32169 If you don't set these colors the index line will be colored in the same color as
32170 the bulk of the index line.
32171
32172 <P>
32173 <A HREF="h_color_setup">Descriptions of the available commands</A>
32174 <P>
32175 Look <A HREF="h_edit_nav_cmds">here</A>
32176 to see the available Editing and Navigation commands.
32177 <P>
32178 &lt;End of help on this topic&gt;
32179 </BODY>
32180 </HTML>
32181 ====== h_config_index_subject_color =====
32182 <HTML>
32183 <HEAD>
32184 <TITLE>OPTION: Index Subject Color</TITLE>
32185 </HEAD>
32186 <BODY>
32187 <H1>OPTION: Index Subject Color</H1>
32188
32189 You may set the color used to draw the Subject part of the index line.
32190 This coloring takes place for all but the current index line, and the Subject
32191 Color appears to be in front of any color from an Index Color Rule.
32192 <P>
32193 If you don't set this color it will be colored in the same color as
32194 the bulk of the index line.
32195
32196 <P>
32197 <A HREF="h_color_setup">Descriptions of the available commands</A>
32198 <P>
32199 Look <A HREF="h_edit_nav_cmds">here</A>
32200 to see the available Editing and Navigation commands.
32201 <P>
32202 &lt;End of help on this topic&gt;
32203 </BODY>
32204 </HTML>
32205 ====== h_config_index_from_color =====
32206 <HTML>
32207 <HEAD>
32208 <TITLE>OPTION: Index From Color</TITLE>
32209 </HEAD>
32210 <BODY>
32211 <H1>OPTION: Index From Color</H1>
32212
32213 You may set the color used to draw the From part of the index line.
32214 This coloring takes place for all but the current index line, and the From
32215 Color appears to be in front of any color from an Index Color Rule.
32216 <P>
32217 If you don't set this color it will be colored in the same color as
32218 the bulk of the index line.
32219
32220 <P>
32221 <A HREF="h_color_setup">Descriptions of the available commands</A>
32222 <P>
32223 Look <A HREF="h_edit_nav_cmds">here</A>
32224 to see the available Editing and Navigation commands.
32225 <P>
32226 &lt;End of help on this topic&gt;
32227 </BODY>
32228 </HTML>
32229 ====== h_config_index_arrow_color =====
32230 <HTML>
32231 <HEAD>
32232 <TITLE>OPTION: Index Arrow Color</TITLE>
32233 </HEAD>
32234 <BODY>
32235 <H1>OPTION: Index Arrow Color</H1>
32236
32237 If you have configured your
32238 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option
32239 to include the &quot;ARROW&quot; token, you may set the color of
32240 the arrow displayed with this option.
32241 If you don't set the color it will be colored in the same color as
32242 the bulk of the index line.
32243
32244 <P>
32245 <A HREF="h_color_setup">Descriptions of the available commands</A>
32246 <P>
32247 Look <A HREF="h_edit_nav_cmds">here</A>
32248 to see the available Editing and Navigation commands.
32249 <P>
32250 &lt;End of help on this topic&gt;
32251 </BODY>
32252 </HTML>
32253 ====== h_config_index_color =====
32254 <HTML>
32255 <HEAD>
32256 <TITLE>OPTION: Index Colors</TITLE>
32257 </HEAD>
32258 <BODY>
32259 <H1>OPTION: Index Colors</H1>
32260
32261 You may add color to the single character symbols that give the status
32262 of each message in the MESSAGE INDEX.
32263 By default the characters &quot;+&quot;, &quot;*&quot;, &quot;D&quot;,
32264 &quot;A&quot;, and &quot;N&quot; show up near the left hand side of the
32265 screen depending on whether the message is addressed to you, and whether
32266 the message is marked Important, is Deleted, is Answered, or is New.
32267 The color for each of those characters may be specified by setting the
32268 &quot;Index-to-me&quot; Symbol Color,
32269 the &quot;Index-important&quot; Symbol Color,
32270 the &quot;Index-deleted&quot; Symbol Color,
32271 the &quot;Index-answered&quot; Symbol Color,
32272 and the &quot;Index-new&quot; Symbol Color.
32273 There are also two other symbol colors called &quot;Index-recent&quot;
32274 and &quot;Index-unseen&quot;.
32275 These two colors will only be used if you have configured your
32276 &quot;<A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A>&quot; option
32277 to include the &quot;IMAPSTATUS&quot; or &quot;SHORTIMAPSTATUS&quot; token.
32278 <P>
32279 The default colors for these symbols are:
32280 <TABLE>
32281 <TR> <TD> &nbsp;&nbsp;Index-to-me&nbsp;&nbsp;&nbsp;&nbsp; </TD> <TD> black on cyan </TD> </TR>
32282 <TR> <TD> &nbsp;&nbsp;Index-important </TD> <TD> white on bright red </TD> </TR>
32283 <TR> <TD> &nbsp;&nbsp;Index-deleted&nbsp;&nbsp; </TD> <TD> same as Normal Color </TD> </TR>
32284 <TR> <TD> &nbsp;&nbsp;Index-answered&nbsp; </TD> <TD> bright red on yellow </TD> </TR>
32285 <TR> <TD> &nbsp;&nbsp;Index-new&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </TD> <TD> white on magenta </TD> </TR>
32286 <TR> <TD> &nbsp;&nbsp;Index-recent&nbsp;&nbsp;&nbsp; </TD> <TD> same as Normal Color </TD> </TR>
32287 <TR> <TD> &nbsp;&nbsp;Index-unseen&nbsp;&nbsp;&nbsp; </TD> <TD> same as Normal Color </TD> </TR>
32288 </TABLE>
32289 <P>
32290 Besides coloring the message status symbols, you may also color the
32291 entire index line.
32292 This is done by using the
32293 <A HREF="h_rules_incols">SETUP INDEX LINE COLORS</A> screen, which you
32294 may get to with the commands <EM>S</EM>etup/<EM>R</EM>ules/<EM>I</EM>ndexcolor.
32295 When the entire line is colored that color will be &quot;behind&quot; the
32296 status symbol colors talked about in the paragraph above.
32297 <P>
32298 You may also color
32299 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>
32300 in the index using the
32301 Setup/Kolor screen (<A HREF="h_config_kw_color">Keyword Colors</A>);
32302 the <A HREF="h_config_index_arrow_color">ARROW</A> cursor;
32303 the Subject using
32304 <A HREF="h_config_index_subject_color">Index Subject Color</A>;
32305 the From field using
32306 <A HREF="h_config_index_from_color">Index From Color</A>;
32307 and the
32308 <A HREF="h_config_index_opening_color">Index Opening</A> text.
32309 <P>
32310 <A HREF="h_color_setup">Descriptions of the available commands</A>
32311 <P>
32312 Look <A HREF="h_edit_nav_cmds">here</A>
32313 to see the available Editing and Navigation commands.
32314 <P>
32315 &lt;End of help on this topic&gt;
32316 </BODY>
32317 </HTML>
32318 ====== h_config_metamsg_color =====
32319 <HTML>
32320 <HEAD>
32321 <TITLE>OPTION: Meta-Message Color</TITLE>
32322 </HEAD>
32323 <BODY>
32324 <H1>OPTION: Meta-Message Color</H1>
32325
32326 Sets the color Alpine uses in the MESSAGE TEXT screen for messages to you
32327 that aren't part of the message itself.
32328 For example, an attachment that isn't shown might produce a meta
32329 message something like:
32330 <P>
32331 <CENTER><SAMP> [ Part 2, &quot;comment&quot; Text/PLAIN (Name: &quot;file&quot;) ]</SAMP></CENTER>
32332 <P>
32333 If you set the
32334 <A HREF="h_config_quote_suppression"><!--#echo var="VAR_quote-suppression-threshold"--></A>
32335 option you might see
32336 <P>
32337 <CENTER><SAMP>[ 12 lines of quoted text hidden from view ]</SAMP></CENTER>
32338 <P>
32339 Warnings about suspicious looking URLs in HTML will also be colored
32340 with this color.
32341 <P>
32342 The foreground color is the color of the actual character and the
32343 background color is the color of the area behind the character.
32344 By default, the Meta-Message Color is black characters on a yellow background.
32345 <P>
32346 <A HREF="h_color_setup">Descriptions of the available commands</A>
32347 <P>
32348 Look <A HREF="h_edit_nav_cmds">here</A>
32349 to see the available Editing and Navigation commands.
32350 <P>
32351 &lt;End of help on this topic&gt;
32352 </BODY>
32353 </HTML>
32354 ====== h_config_keylabel_color =====
32355 <HTML>
32356 <HEAD>
32357 <TITLE>OPTION: KeyLabel Color</TITLE>
32358 </HEAD>
32359 <BODY>
32360 <H1>OPTION: KeyLabel Color</H1>
32361
32362 Sets the color Alpine uses for the labels of the keys in the two-line
32363 menu at the bottom of the screen.
32364 For example, some of the screens have a &quot;P PrevMsg&quot; command.
32365 This option sets the color used when displaying &quot;PrevMsg&quot;.
32366 The foreground color is the color of the actual character and the
32367 background color is the color of the area behind the character.
32368 By default, the KeyLabel Color is the same as the Normal Color.
32369 <P>
32370 WARNING: Some terminal emulators have the property that the screen will scroll
32371 down one line whenever a character is written to the character cell in the
32372 lower right corner of the screen.
32373 Alpine can usually avoid writing a character in that corner of the screen.
32374 However, if you have defined a KeyLabel Color then Alpine does have to write
32375 a character in that cell in order to color the cell correctly.
32376 If you find that your display sometimes scrolls up a line this could be
32377 the problem.
32378 The most obvious symptom is probably that the titlebar at the top of the
32379 screen scrolls off the screen.
32380 Try setting KeyLabel Color to Default to see if that fixes the problem.
32381 <P>
32382 <A HREF="h_color_setup">Descriptions of the available commands</A>
32383 <P>
32384 Look <A HREF="h_edit_nav_cmds">here</A>
32385 to see the available Editing and Navigation commands.
32386 <P>
32387 &lt;End of help on this topic&gt;
32388 </BODY>
32389 </HTML>
32390 ====== h_config_keyname_color =====
32391 <HTML>
32392 <HEAD>
32393 <TITLE>OPTION: KeyName Color</TITLE>
32394 </HEAD>
32395 <BODY>
32396 <H1>OPTION: KeyName Color</H1>
32397
32398 Sets the color Alpine uses for the names of the keys in the two-line
32399 menu at the bottom of the screen.
32400 For example, some of the screens have a &quot;P PrevMsg&quot; command.
32401 This option sets the color used when displaying the &quot;P&quot;.
32402 The foreground color is the color of the actual character and the
32403 background color is the color of the area behind the character.
32404 By default, the KeyName Color is the same as the Reverse Color.
32405 <P>
32406 <A HREF="h_color_setup">Descriptions of the available commands</A>
32407 <P>
32408 Look <A HREF="h_edit_nav_cmds">here</A>
32409 to see the available Editing and Navigation commands.
32410 <P>
32411 &lt;End of help on this topic&gt;
32412 </BODY>
32413 </HTML>
32414 ====== h_config_slctbl_color =====
32415 <HTML>
32416 <HEAD>
32417 <TITLE>OPTION: Selectable Item Color</TITLE>
32418 </HEAD>
32419 <BODY>
32420 <H1>OPTION: Selectable Item Color</H1>
32421
32422 Sets the color Alpine uses for selectable items, such as URLs.
32423 The foreground color is the color of the actual character and the
32424 background color is the color of the area behind the character.
32425 By default, the Selectable Item Color is the same as the Normal Color,
32426 except that it is bold.
32427 <P>
32428 <A HREF="h_color_setup">Descriptions of the available commands</A>
32429 <P>
32430 Look <A HREF="h_edit_nav_cmds">here</A>
32431 to see the available Editing and Navigation commands.
32432 <P>
32433 &lt;End of help on this topic&gt;
32434 </BODY>
32435 </HTML>
32436 ====== h_config_quote_color =====
32437 <HTML>
32438 <HEAD>
32439 <TITLE>OPTION: Quote Colors</TITLE>
32440 </HEAD>
32441 <BODY>
32442 <H1>OPTION: Quote Colors</H1>
32443
32444 Sets the colors Alpine uses for coloring quoted text in the MESSAGE TEXT
32445 screen.
32446 If a line begins with a &gt; character (or space followed by &gt;)
32447 it is considered a quote.
32448 That line will be given the Quote1 Color (first level quote).
32449 If there is a second level of quoting then the Quote2 Color will be used.
32450 Alpine considers there to be a second level of quoting if that first &gt; is
32451 followed by another &gt; (or space followed by &gt;).
32452 If there are characters other than whitespace and &gt; signs, then it isn't
32453 considered another level of quoting.
32454 Similarly, if there is a third level of quoting the Quote3 Color will be
32455 used.
32456 If there are more levels after that the Quote Colors are re-used.
32457 If you define all three colors then it would repeat like Color1, Color2, Color3,
32458 Color1, Color2, Color3, ...
32459 If you only define the first two it would be
32460 Color1, Color2, Color1, Color2, ...
32461 If you define only the Quote1 Color, then the entire quote would be that
32462 color regardless of the quoting levels.
32463 By default, the Quote1 Color is black characters on a greenish-blue background;
32464 the Quote2 Color is black characters on a dull yellow background; and
32465 the Quote3 Color is black characters on a green background.
32466 <P>
32467 <A HREF="h_color_setup">Descriptions of the available commands</A>
32468 <P>
32469 Look <A HREF="h_edit_nav_cmds">here</A>
32470 to see the available Editing and Navigation commands.
32471 <P>
32472 &lt;End of help on this topic&gt;
32473 </BODY>
32474 </HTML>
32475 ====== h_config_folder_color =====
32476 <HTML>
32477 <HEAD>
32478 <TITLE>OPTION: Folder Color</TITLE>
32479 </HEAD>
32480 <BODY>
32481 <H1>OPTION: Folder Color</H1>
32482
32483 Sets the colors Alpine uses for coloring a folder in the FOLDER LIST
32484 screen. By default, the Folder Color is the normal text color.
32485
32486 <P>
32487 If you set a color for this feature, other than the normal color
32488 (the default), or a color for
32489 <A HREF="h_config_directory_color">Directory Color</A>, then directories
32490 will be colored according to the color specified in the
32491 <A HREF="h_config_directory_color">Directory Color</A> option. In this
32492 case, the color will be the only indication that the colored name
32493 refers to a directory. The normal behavior is that Alpine
32494 indicates that a name refers to a directory by appending a
32495 separator (like &quot;/&quot; or &quot;.&quot;) to the name of
32496 the folder.
32497
32498 <P>
32499 If a folder is a directory, then the folder name will be painted
32500 according to the color defined by this variable, and a separator
32501 indicator  (like &quot;/&quot; or &quot;.&quot;) will be added
32502 to the name. That
32503 indicator will be painted according to the color defined in the
32504 <A HREF="h_config_directory_color">Directory Color</A> option.
32505
32506 <P>
32507 &lt;End of help on this topic&gt;
32508 </BODY>
32509 </HTML>
32510 ====== h_config_directory_color =====
32511 <HTML>
32512 <HEAD>
32513 <TITLE>OPTION: Directory Color</TITLE>
32514 </HEAD>
32515 <BODY>
32516 <H1>OPTION: Directory Color</H1>
32517
32518 Sets the colors Alpine uses for coloring a directory in the FOLDER LIST
32519 screen. By default, the Folder Color is the normal text color.
32520 <P>
32521 If you set a color for this feature, other than the normal color
32522 (the default), or a color for
32523 <A HREF="h_config_folder_color">Folder Color</A>, then folders
32524 will be colored according to the color specified in the
32525 <A HREF="h_config_folder_color">Folder Color</A> option. In this
32526 case, the color will be the only indication that the colored name
32527 refers to a directory. The normal behavior is that Alpine
32528 indicates that a name refers to a directory by appending a
32529 separator (like &quot;/&quot; or &quot;.&quot;) to the name of
32530 the folder.
32531 <P>
32532 If a folder is a directory, then the folder name will be painted
32533 according to the color defined by the option
32534 <A HREF="h_config_folder_color">Folder Color</A>, and the separator
32535 indicator  (like &quot;/&quot; or &quot;.&quot;) will be added
32536 after the name. That
32537 indicator will be painted according to the color defined in this
32538 option.
32539 <P>
32540 &lt;End of help on this topic&gt;
32541 </BODY>
32542 </HTML>
32543 ====== h_config_folder_list_color =====
32544 <HTML>
32545 <HEAD>
32546 <TITLE>OPTION: Folder-List Color</TITLE>
32547 </HEAD>
32548 <BODY>
32549 <H1>OPTION: Folder-List Color</H1>
32550
32551 Sets the colors Alpine uses for coloring normal text in the FOLDER LIST
32552 screen. By default, the Folder-List Color is the normal text color.
32553 <P>
32554 This text refers to the informative text that Alpine displays so you
32555 can recognize each collection. The color of the content of each collection
32556 is determined by the options <A HREF="h_config_folder_color">Folder Color</A>
32557 and <A HREF="h_config_directory_color">Directory Color</A>.
32558 <P>
32559 Unlike the options
32560 <A HREF="h_config_folder_color">Folder Color</A>
32561 and <A HREF="h_config_directory_color">Directory Color</A>, configuring
32562 this option does not affect the way that Alpine reports folders,
32563 directories and folders that are directories.
32564 <P>
32565 &lt;End of help on this topic&gt;
32566 </BODY>
32567 </HTML>
32568 ====== h_config_incunseen_color =====
32569 <HTML>
32570 <HEAD>
32571 <TITLE>OPTION: Incoming Unseen Color</TITLE>
32572 </HEAD>
32573 <BODY>
32574 <H1>OPTION: Incoming Unseen Color</H1>
32575
32576 If the option
32577 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
32578 is turned on it is possible to highlight the folders that contain
32579 unseen messages by coloring them with this color.
32580 By default, this is the same as the Normal Color and no highlighting is done.
32581 <P>
32582 Usually the &quot;current&quot; folder (the folder the cursor is on)
32583 is highlighted using reverse video.
32584 If the current folder is colored because it contains unseen messages then
32585 the color used to show that it is also the current folder is controlled
32586 by the
32587 <A HREF="h_config_index_color_style"><!--#echo var="VAR_current-indexline-style"--></A>
32588 feature at the top of the SETUP COLOR screen.
32589 <P>
32590 <A HREF="h_color_setup">Descriptions of the available commands</A>
32591 <P>
32592 Look <A HREF="h_edit_nav_cmds">here</A>
32593 to see the available Editing and Navigation commands.
32594 <P>
32595 &lt;End of help on this topic&gt;
32596 </BODY>
32597 </HTML>
32598 ====== h_config_signature_color =====
32599 <HTML>
32600 <HEAD>
32601 <TITLE>OPTION: Signature Color</TITLE>
32602 </HEAD>
32603 <BODY>
32604 <H1>OPTION: Signature Color</H1>
32605
32606 Sets the color Alpine uses for coloring the signature in the MESSAGE TEXT
32607 screen. According to USENET conventions, the signature is defined as the
32608 paragraph following the &quot;sigdashes&quot;, that is, the special line
32609 consisting of the three characters
32610 &quot;--&nbsp;&quot; (i.e., dash, dash, and space). Alpine allows for one
32611 empty line right after the sigdashes to be considered as part of the
32612 signature.
32613 By default, the Signature Color is blue characters on a white background.
32614 <P>
32615 <A HREF="h_color_setup">Descriptions of the available commands</A>
32616 <P>
32617 Look <A HREF="h_edit_nav_cmds">here</A>
32618 to see the available Editing and Navigation commands.
32619 <P>
32620 &lt;End of help on this topic&gt;
32621 </BODY>
32622 </HTML>
32623 ====== h_config_prompt_color =====
32624 <HTML>
32625 <HEAD>
32626 <TITLE>OPTION: Prompt Color</TITLE>
32627 </HEAD>
32628 <BODY>
32629 <H1>OPTION: Prompt Color</H1>
32630
32631 Sets the color Alpine uses for confirmation prompts and questions that
32632 appear in the status line near the bottom of the screen.
32633 The foreground color is the color of the actual character and the
32634 background color is the color of the area behind the character.
32635 By default, the Prompt Color is the same as the Reverse Color.
32636 <P>
32637 <A HREF="h_color_setup">Descriptions of the available commands</A>
32638 <P>
32639 Look <A HREF="h_edit_nav_cmds">here</A>
32640 to see the available Editing and Navigation commands.
32641 <P>
32642 &lt;End of help on this topic&gt;
32643 </BODY>
32644 </HTML>
32645 ====== h_config_header_general_color =====
32646 <HTML>
32647 <HEAD>
32648 <TITLE>OPTION: Header General Color</TITLE>
32649 </HEAD>
32650 <BODY>
32651 <H1>OPTION: Header General Color</H1>
32652
32653 Sets the color Alpine uses for the headers of a message in the MESSAGE TEXT
32654 screen.
32655 The foreground color is the color of the actual character and the
32656 background color is the color of the area behind the character.
32657 By default, this is the same as the Normal Color.
32658 <P>
32659 It is also possible to set the colors for specific header fields, for
32660 example the Subject, using
32661 <A HREF="h_config_customhdr_color"><!--#echo var="VAR_viewer-hdr-colors"--></A>.
32662 If both a Header General Color and a specific Viewer Header Color are set
32663 the specific color will override the general color, as you would expect.
32664 <P>
32665 <A HREF="h_color_setup">Descriptions of the available commands</A>
32666 <P>
32667 Look <A HREF="h_edit_nav_cmds">here</A>
32668 to see the available Editing and Navigation commands.
32669 <P>
32670 &lt;End of help on this topic&gt;
32671 </BODY>
32672 </HTML>
32673 ====== h_config_incol =====
32674 <HTML>
32675 <HEAD>
32676 <TITLE>Index Line Color</TITLE>
32677 </HEAD>
32678 <BODY>
32679 <H1>Index Line Color</H1>
32680
32681 This option is used to set the color of a line in the index when the
32682 message for that line matches the Pattern.
32683 This colors the whole index line, except possibly the status letters,
32684 which may be colored separately using the
32685 <A HREF="h_color_setup">Setup Kolor</A> screen.
32686 The foreground color is the color of the actual characters and the
32687 background color is the color of the area behind the characters.
32688 <P>
32689 <A HREF="h_color_setup">Descriptions of the available commands</A>
32690 <P>
32691 Look <A HREF="h_edit_nav_cmds">here</A>
32692 to see the available Editing and Navigation commands.
32693 <P>
32694 &lt;End of help on this topic&gt;
32695 </BODY>
32696 </HTML>
32697 ====== h_config_usetransparent_color =====
32698 <HTML>
32699 <HEAD>
32700 <TITLE>OPTION: Use Transparent Color</TITLE>
32701 </HEAD>
32702 <BODY>
32703 <H1>OPTION: Use Transparent Color</H1>
32704
32705 This is a special color supported by some terminal emulators.
32706 It is intended to result in the default foreground or background color
32707 from the terminal emulator.
32708 This is the color the terminal was displaying characters in before you started Alpine.
32709 The reason it is called Transparent is because you could set the foreground color
32710 to some specific color, like Red, and then set the background color to the
32711 Transparent Color. If it works as expected, the background color from the terminal
32712 window in which Alpine is running will show through but with the Red characters
32713 in the foreground.
32714 <P>
32715 <A HREF="h_color_setup">Descriptions of the available commands</A>
32716 <P>
32717 Look <A HREF="h_edit_nav_cmds">here</A>
32718 to see the available Editing and Navigation commands.
32719 <P>
32720 &lt;End of help on this topic&gt;
32721 </BODY>
32722 </HTML>
32723 ====== h_config_usenormal_color =====
32724 <HTML>
32725 <HEAD>
32726 <TITLE>OPTION: Use Normal Color</TITLE>
32727 </HEAD>
32728 <BODY>
32729 <H1>OPTION: Use Normal Color</H1>
32730
32731 When you use this color value, the actual color used will be the same
32732 as the corresponding Normal Color.
32733 For example if your Normal Color is black on white and you set both
32734 the foreground and background colors here to use the Normal Color, you'll
32735 get black on white. If you later change the Normal Color to red on blue
32736 this color will also change to red on blue.
32737 <P>
32738 <A HREF="h_color_setup">Descriptions of the available commands</A>
32739 <P>
32740 Look <A HREF="h_edit_nav_cmds">here</A>
32741 to see the available Editing and Navigation commands.
32742 <P>
32743 &lt;End of help on this topic&gt;
32744 </BODY>
32745 </HTML>
32746 ====== h_config_usenone_color =====
32747 <HTML>
32748 <HEAD>
32749 <TITLE>OPTION: Use None Color</TITLE>
32750 </HEAD>
32751 <BODY>
32752 <H1>OPTION: Use None Color</H1>
32753
32754 This is a special color that simply means to leave the color alone.
32755 It is useful for Index symbols and for Keyword Colors used in the Subject
32756 field of an index line.
32757 The most likely use is to set an explicit foreground color and then set
32758 the background color to the None Color.
32759 That will cause the symbol or keyword to be drawn in the foreground color
32760 with a background equal to whatever color the rest of the index line is already
32761 drawn in.
32762 You will see no visible effect unless you have assigned Indexcolor Rules to
32763 color index lines or you have set an actual color for the Reverse Color.
32764 <P>
32765 <A HREF="h_color_setup">Descriptions of the available commands</A>
32766 <P>
32767 Look <A HREF="h_edit_nav_cmds">here</A>
32768 to see the available Editing and Navigation commands.
32769 <P>
32770 &lt;End of help on this topic&gt;
32771 </BODY>
32772 </HTML>
32773 ====== h_config_dflt_color =====
32774 <HTML>
32775 <HEAD>
32776 <TITLE>OPTION: Default Color</TITLE>
32777 </HEAD>
32778 <BODY>
32779 <H1>OPTION: Default Color</H1>
32780
32781 Setting default will cause the color to be the default color.
32782 Unsetting default is normally done by choosing a color, but in some cases
32783 you may want to declare the current default color to be your non-default
32784 choice.
32785 For example, the default Keyname Color is the same as the Reverse Color.
32786 Whenever the Reverse Color changes the Keyname Color will also change, unless
32787 you've changed it or unset the default box.
32788 <P>
32789 <A HREF="h_color_setup">Descriptions of the available commands</A>
32790 <P>
32791 Look <A HREF="h_edit_nav_cmds">here</A>
32792 to see the available Editing and Navigation commands.
32793 <P>
32794 &lt;End of help on this topic&gt;
32795 </BODY>
32796 </HTML>
32797 ====== h_config_bold_slctbl =====
32798 <HTML>
32799 <HEAD>
32800 <TITLE>OPTION: Bold</TITLE>
32801 </HEAD>
32802 <BODY>
32803 <H1>OPTION: Bold</H1>
32804
32805 The color for this particular section may have the Bold attribute turned
32806 on or off.
32807 Setting bold will cause the characters to be bold.
32808 <P>
32809 <A HREF="h_color_setup">Descriptions of the available commands</A>
32810 <P>
32811 Look <A HREF="h_edit_nav_cmds">here</A>
32812 to see the available Editing and Navigation commands.
32813 <P>
32814 &lt;End of help on this topic&gt;
32815 </BODY>
32816 </HTML>
32817 ====== h_config_kw_color =====
32818 <HTML>
32819 <HEAD>
32820 <TITLE>OPTION: Keyword Colors</TITLE>
32821 </HEAD>
32822 <BODY>
32823 <H1>OPTION: Keyword Colors</H1>
32824
32825 Sets the colors Alpine uses for Keyword fields in the MESSAGE INDEX screen.
32826 Keywords are displayed as part of the Subject by default.
32827 They are also displayed as part of the Subject if the tokens
32828 &quot;SUBJKEY&quot;, &quot;SUBJKEYTEXT&quot;, &quot;SUBJKEYINIT&quot;, or &quot;SUBJKEYINITTEXT&quot; are used in the
32829 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option.
32830 Keywords may also be displayed in a column of their own in the MESSAGE INDEX
32831 screen by using the &quot;KEY&quot; or &quot;KEYINIT&quot; tokens.
32832 <P>
32833 For example, you might have set up a Keyword
32834 &quot;Work&quot; using the
32835 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in the Setup/Config screen.
32836 You could cause that Keyword to show up as a special color
32837 by setting up the Keyword Color using this option, and then including it
32838 in the MESSAGE INDEX screen using one of the tokens listed above in the
32839 <!--#echo var="VAR_index-format"-->.
32840 <P>
32841 <A HREF="h_color_setup">Descriptions of the available commands</A>
32842 <P>
32843 Look <A HREF="h_edit_nav_cmds">here</A>
32844 to see the available Editing and Navigation commands.
32845 <P>
32846 &lt;End of help on this topic&gt;
32847 </BODY>
32848 </HTML>
32849 ====== h_config_customhdr_color =====
32850 <HTML>
32851 <HEAD>
32852 <TITLE>OPTION: <!--#echo var="VAR_viewer-hdr-colors"--></TITLE>
32853 </HEAD>
32854 <BODY>
32855 <H1>OPTION: <!--#echo var="VAR_viewer-hdr-colors"--></H1>
32856
32857 Sets the colors Alpine uses for specific header fields in the MESSAGE TEXT screen.
32858 For example, you may set the color of the Subject header or the From header.
32859 The foreground color is the color of the actual character and the
32860 background color is the color of the area behind the character.
32861 <P>
32862 In addition to setting the colors for particular headers (like the Subject)
32863 you may also set a color to be used for all headers unless overridden by a
32864 more specific Viewer Header Color.
32865 To do this use the
32866 <A HREF="h_config_header_general_color">Header General Color</A>.
32867 <P>
32868 For Header Colors,
32869 there is an additional line on the
32870 screen labeled &quot;Pattern to match&quot;.
32871 If you leave that blank, then the whole field for that header will
32872 be colored.
32873 However, if you give a pattern to match, the coloring will only take place
32874 if there is a match for that pattern in the value of the field.
32875 For example, if you are working on a color for the Subject header and
32876 you fill in a pattern of &quot;important&quot;, then only Subjects that
32877 contain the word &quot;important&quot; will be colored.
32878 <P>
32879 If the pattern you enter is a comma-separated list of patterns, then coloring
32880 happens if any of those patterns matches.
32881 <P>
32882 <A HREF="h_color_setup">Descriptions of the available commands</A>
32883 <P>
32884 Look <A HREF="h_edit_nav_cmds">here</A>
32885 to see the available Editing and Navigation commands.
32886 <P>
32887 &lt;End of help on this topic&gt;
32888 </BODY>
32889 </HTML>
32890 ====== h_config_indextoken_color =====
32891 <HTML>
32892 <HEAD>
32893 <TITLE>OPTION: <!--#echo var="VAR_index-token-colors"--></TITLE>
32894 </HEAD>
32895 <BODY>
32896 <H1>OPTION: <!--#echo var="VAR_index-token-colors"--></H1>
32897
32898 This option allows you to set up the color in which any token, not specified by the
32899 previous options, will be colored in the MESSAGE INDEX screen.
32900 <P>
32901 In order to use this option, you must press the &quot;I&quot; <B>IndxHdr</B> command, and add
32902 a token that can be used in the index format.
32903 The list of available tokens is <A HREF="h_index_tokens">here</A>.
32904 <P>
32905 If you fail to enter a valid token your entry will be ignored, and you will be asked to
32906 enter a new one. Once you have entered a valid token, a line will be added to the
32907 configuration screen that you can use to set up the colors in which that token will
32908 be painted. This is done in the same way that you configure colors for other
32909 variables.
32910
32911 <A HREF="h_color_setup">Descriptions of the available commands</A>
32912 <P>
32913 Look <A HREF="h_edit_nav_cmds">here</A>
32914 to see the available Editing and Navigation commands.
32915 <P>
32916 &lt;End of help on this topic&gt;
32917 </BODY>
32918 </HTML>
32919 ====== h_config_customhdr_pattern =====
32920 <HTML>
32921 <HEAD>
32922 <TITLE>OPTION: Viewer Header Color Pattern</TITLE>
32923 </HEAD>
32924 <BODY>
32925 <H1>OPTION: Viewer Header Color Pattern</H1>
32926
32927 If you leave this blank, then the whole field for the header will
32928 be colored.
32929 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 For address headers (like From and To) and for the Newsgroups header,
32936 a pattern match will cause only the matched addresses or newsgroups to be
32937 colored.
32938 If there is no pattern to match, then all of the addresses or newsgroups
32939 in the relevant header will be colored.
32940 <P>
32941 The matching pattern may be a comma-separated list of patterns to match
32942 instead of a single pattern.
32943 For example, you could use the pattern &quot;important,urgent&quot; which would
32944 cause a match if either the word &quot;important&quot; or the word
32945 &quot;urgent&quot; appeared in the value of the header.
32946 You could list several comma-separated email addresses in the Header
32947 From Color pattern so that those addresses will be colored when any of
32948 them appear in the From header.
32949 <P>
32950 To add a new matching pattern or change the existing pattern use the
32951 <!--chtml if pinemode="function_key"-->
32952 &quot;F4&quot;
32953 <!--chtml else-->
32954 &quot;C&quot;
32955 <!--chtml endif-->
32956 &quot;Change&quot; command that is available when the &quot;Pattern to
32957 match&quot; line is highlighted.
32958 The
32959 <!--chtml if pinemode="function_key"-->
32960 &quot;F10&quot;
32961 <!--chtml else-->
32962 &quot;D&quot;
32963 <!--chtml endif-->
32964 &quot;Delete&quot; command may be used to quickly remove all patterns
32965 for a particular header.
32966 <P>
32967 &lt;End of help on this topic&gt;
32968 </BODY>
32969 </HTML>
32970 ====== h_color_setup =====
32971 <HTML>
32972 <HEAD>
32973 <TITLE>SETUP COLOR COMMANDS</TITLE>
32974 </HEAD>
32975 <BODY>
32976 <H1>SETUP COLOR COMMANDS</H1>
32977 <!--chtml if pinemode="function_key"-->
32978 <PRE>
32979 Available Commands -- Group 1
32980 -------------------------------
32981 F1  Display this help text
32982 F2  Show other available commands
32983 F3  Exit to MAIN MENU
32984 F4  Select the highlighted foreground or background color
32985 F5  Move to previous line
32986 F6  Move to next line
32987 F7  Previous page
32988 F8  Next page
32989 F9  Add a config section for a header field
32990 F10 Restore all default colors (for all sections)
32991 F11 Print color configuration screen
32992 F12 Whereis (search for word)
32993
32994 Available Commands -- Group 2
32995 -------------------------------
32996 F1  Display this help text
32997 F2  Show other available commands
32998 F5  Delete config section for highlighted header field
32999 F6  Shuffle the order of Header Color sections
33000 </PRE>
33001 <!--chtml else-->
33002 <PRE>
33003 General commands
33004 -------------------------------------------------
33005  ?  Display this help text     E  Exit back to MAIN MENU
33006  P  Previous Line              N  Next Line
33007  -  Previous page             Spc (space bar) Next page
33008  W  WhereIs (search for word)  %  Print color configuration screen
33009
33010 Color Setup Commands
33011 ------------------------------------------------
33012  *  Select the highlighted foreground or background color
33013  A  Add a config section for a header field
33014  D  Delete config section for highlighted header field
33015  R  Restore all default colors (for all sections)
33016  $  Shuffle the order of Header Color sections
33017 </PRE>
33018 <!--chtml endif-->
33019
33020 <H2>Description of the Setup Color Screen</H2>
33021
33022 From this screen you may turn on color and set the colors of
33023 various parts of the Alpine display.
33024 For help on turning on color move your cursor into the Color Style section
33025 at the top of the Setup Color screen and ask for help.
33026
33027 <P>
33028 There are several sections in the Setup Color Screen.
33029 At the top are some settings that handle the style of color used
33030 with your terminal emulator (UNIX only), and some settings that
33031 control how the current indexline and the titlebar are colored.
33032 After that comes a long section called GENERAL COLORS that allows
33033 you to set the color of many elements in the Alpine screens.
33034 For example, the color of the titlebar, status messages,
33035 selectable links, quotes and signatures in messages, and so on.
33036 After that is a section called INDEX COLORS that allows you to
33037 set the colors of various pieces of the displayed index lines in
33038 the MESSAGE INDEX screen.
33039 The next section is HEADER COLORS. This is for coloring headers of
33040 messages in the MESSAGE TEXT screen in just about any way you would like.
33041 Finally, the KEYWORD COLORS section allows you to highlight
33042 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>
33043 in the MESSAGE INDEX screen.
33044
33045 <P>
33046 To change a color, highlight the color you want to change (for example,
33047 the Status Color) by moving
33048 the cursor into it.
33049 You may want to read the help text for the color to see a brief desription
33050 of what you are coloring.
33051 Then press &quot;C&quot; for Change to set the color to something new.
33052 That will put you into a screen with two columns of colors, one for
33053 the foreground color and one for the background color.
33054 The foreground color is just the color you want the actual characters
33055 to be and the background color is the color of the rest of the rectangle
33056 behind the characters.
33057 Select the foreground and background colors desired by using the Next and
33058 Prev keys to highlight the color, and the * command to select it.
33059 <P>
33060 To set a color to its default value, set the X in the Default line at
33061 the bottom of the list of colors.
33062 <P>
33063
33064 The HEADER COLORS section is a little bit different from the others.
33065 Besides coloring the specific fields that Alpine knows about, you may also
33066 color specific header fields when viewing a message in the MESSAGE TEXT
33067 screen.
33068 For example, you may color the Subject header a particular color.
33069 There are a few commands for use with headers.
33070 The &quot;AddHeader&quot; command adds a section to the color
33071 configuration screen that allows you to set the color for that header.
33072 You'll be asked for the name of the header field you want to color.
33073 If you wanted to color the Subject, you would answer
33074 with the word &quot;subject&quot;.
33075 Once you've added a header field, the color setting works just like the
33076 other color fields, except that there is an additional line on the
33077 configuration screen labeled &quot;Pattern to match&quot;.
33078 If you leave that blank, then the whole field for that header will always
33079 be colored.
33080 However, if you give a pattern to match, the coloring will only take place
33081 if there is a match for that pattern in the value of the field.
33082 For example, if you are working on a color for the Subject header and
33083 you fill in a pattern of &quot;important&quot;, then only Subjects that
33084 contain the word &quot;important&quot; will be colored.
33085 <P>
33086 The &quot;DeleteHdr&quot; command removes a header section from the
33087 configuration altogether.
33088 The &quot;Shuffle&quot; command changes the order of header sections.
33089 This is only necessary if you use header sections with pattern fields.
33090 For example, if you have two Subject sections, one with one pattern and
33091 another with another pattern, and the subject for a particular message
33092 happens to match both, then the color from the first match is used.
33093 <P>
33094
33095 The command &quot;RestoreDefs&quot; will restore all of the default colors.
33096 Each section will change to the default value used for that section when
33097 color is first enabled.
33098 When you restore all default colors the color settings for the Header Colors
33099 will be unset (since that's the default), but the header fields you've
33100 added will remain so that you may easily reset them.
33101 In order to get rid of them completely you'd have to use
33102 the &quot;DeleteHdr&quot; command.
33103
33104 <P>
33105 Remember that <A HREF="h_rules_incols">Index Line Colors</A>
33106 may be set with matching rules and that is configured separately from
33107 the rest of the color settings described here.
33108 It is configured in the Setup/Rules/Indexcolors section of the configuration screen
33109 instead of in the Setup/Kolor section.
33110
33111 <P><UL>
33112 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33113 </UL><P>
33114 &lt;End of help on this topic&gt;
33115 </BODY>
33116 </HTML>
33117 ====== h_config_news_uses_recent ======
33118 <HTML>
33119 <HEAD>
33120 <TITLE>FEATURE: <!--#echo var="FEAT_news-approximates-new-status"--></TITLE>
33121 </HEAD>
33122 <BODY>
33123 <H1>FEATURE: <!--#echo var="FEAT_news-approximates-new-status"--></H1>
33124
33125 This feature causes certain messages to be marked as "New" in the
33126 MESSAGE INDEX of newsgroups.
33127 This feature is set by default.
33128
33129 <P>
33130
33131 When opening a newsgroup, Alpine will consult your "newsrc" file and
33132 determine the last message you have previously disposed of via the "D"
33133 key.  If this feature is set, any subsequent messages will be shown in the
33134 Index with an "N", and the first of these messages will be highlighted.
33135 Although this is only an approximation of true "New" or "Unseen"
33136 status, it provides a useful cue to distinguish more-or-less recent
33137 messages from those you have seen previously, but are not yet ready to
33138 mark deleted.
33139
33140 <P>
33141
33142 Background: your "newsrc" file (used to store message status information
33143 for newsgroups) is only capable of storing a single flag, and Alpine uses
33144 this to record whether or not you are "done with" a message, as
33145 indicated by marking the message as "Deleted".  Unfortunately, this
33146 means that Alpine has no way to record exactly which messages you have
33147 previously seen, so it normally does not show the "N" status flag for
33148 any messages in a newsgroup. This feature enables a starting
33149 *approximation* of seen/unseen status that may be useful.
33150 <P>
33151 &lt;End of help on this topic&gt;
33152 </BODY>
33153 </HTML>
33154 ====== h_config_expose_hidden_config =====
33155 <HTML>
33156 <HEAD>
33157 <TITLE>FEATURE: <!--#echo var="FEAT_expose-hidden-config"--></TITLE>
33158 </HEAD>
33159 <BODY>
33160 <H1>FEATURE: <!--#echo var="FEAT_expose-hidden-config"--></H1>
33161
33162 If set, this causes configuration options and features that are normally
33163 hidden from view to be editable in the Setup/Config screen.
33164
33165 <P>
33166 The purpose of this feature is to allow you to change configuration
33167 features and variables that are normally hidden.
33168 This is particularly useful if you are using a remote configuration,
33169 where it is difficult to edit the contents manually, but it may also be used
33170 on a local pinerc configuration file.
33171 <P>
33172 If set, several configuration variables and features that are normally
33173 hidden from view will show up in the Setup/Configuration screen.
33174 They will be at the bottom of the configuration screen.
33175 You can find them by searching for the words &quot;hidden configuration&quot;.
33176 <P>
33177
33178 Note that this is an advanced feature that should be used with care.
33179 The reason that this part of the configuration is normally hidden is because
33180 there is a significant potential for causing problems if you change these
33181 variables.
33182 If something breaks after a change try changing it back to see if that is
33183 what is causing the problem.
33184 There are also some variables that are normally hidden because they are
33185 manipulated through Alpine in other ways.
33186 For example, colors are normally set using the Setup/Kolors screen and
33187 the &quot;<!--#echo var="VAR_address-book"-->&quot; variable is normally set using
33188 the Setup/AddressBooks screen, so there is little reason to edit these directly.
33189 The &quot;<!--#echo var="VAR_incoming-folders"-->&quot; variable is normally changed by using
33190 the Add, Delete, and Rename commands in the FOLDER LIST screen,
33191 and the &quot;<!--#echo var="VAR_last-time-prune-questioned"-->&quot; variable is normally used
33192 internally by Alpine and not set directly by the user.
33193 <P>
33194 <UL>
33195 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33196 </UL><P>
33197 &lt;End of help on this topic&gt;
33198 </BODY>
33199 </HTML>
33200 ====== h_config_disable_signature_edit =====
33201 <HTML>
33202 <HEAD>
33203 <TITLE>FEATURE: <!--#echo var="FEAT_disable-signature-edit-cmd"--></TITLE>
33204 </HEAD>
33205 <BODY>
33206 <H1>FEATURE: <!--#echo var="FEAT_disable-signature-edit-cmd"--></H1>
33207
33208 If set, this disables the editing of signature files from within
33209 the Setup/Config screen.
33210 <P>
33211 <UL>
33212 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33213 </UL><P>
33214 &lt;End of help on this topic&gt;
33215 </BODY>
33216 </HTML>
33217 ====== h_config_disable_roles_templateedit =====
33218 <HTML>
33219 <HEAD>
33220 <TITLE>FEATURE: <!--#echo var="FEAT_disable-roles-template-edit"--></TITLE>
33221 </HEAD>
33222 <BODY>
33223 <H1>FEATURE: <!--#echo var="FEAT_disable-roles-template-edit"--></H1>
33224
33225 If set, this disables the editing of template files within the
33226 Role setup screen.
33227 <P>
33228 <UL>
33229 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33230 </UL><P>
33231 &lt;End of help on this topic&gt;
33232 </BODY>
33233 </HTML>
33234 ====== h_config_disable_roles_sigedit =====
33235 <HTML>
33236 <HEAD>
33237 <TITLE>FEATURE: <!--#echo var="FEAT_disable-roles-sig-edit"--></TITLE>
33238 </HEAD>
33239 <BODY>
33240 <H1>FEATURE: <!--#echo var="FEAT_disable-roles-sig-edit"--></H1>
33241
33242 If set, this disables the editing of signature files within the
33243 Role setup screen.
33244 <P>
33245 <UL>
33246 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33247 </UL><P>
33248 &lt;End of help on this topic&gt;
33249 </BODY>
33250 </HTML>
33251 ====== h_config_disable_roles_setup =====
33252 <HTML>
33253 <HEAD>
33254 <TITLE>FEATURE: <!--#echo var="FEAT_disable-roles-setup-cmd"--></TITLE>
33255 </HEAD>
33256 <BODY>
33257 <H1>FEATURE: <!--#echo var="FEAT_disable-roles-setup-cmd"--></H1>
33258
33259 If set, this disables the Setup/Rules/Roles command.
33260 <P>
33261 <UL>
33262 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33263 </UL><P>
33264 &lt;End of help on this topic&gt;
33265 </BODY>
33266 </HTML>
33267 ====== h_config_disable_pipes_in_templates =====
33268 <HTML>
33269 <HEAD>
33270 <TITLE>FEATURE: <!--#echo var="FEAT_disable-pipes-in-templates"--></TITLE>
33271 </HEAD>
33272 <BODY>
33273 <H1>FEATURE: <!--#echo var="FEAT_disable-pipes-in-templates"--></H1>
33274
33275 By default, if a template file name is followed by a vertical bar (|) then
33276 that causes the file to be executed to produce the text for the template.
33277 If this feature is set, then this is not allowed.
33278 <P>
33279 <UL>
33280 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33281 </UL><P>
33282 &lt;End of help on this topic&gt;
33283 </BODY>
33284 </HTML>
33285 ====== h_config_disable_pipes_in_sigs =====
33286 <HTML>
33287 <HEAD>
33288 <TITLE>FEATURE: <!--#echo var="FEAT_disable-pipes-in-sigs"--></TITLE>
33289 </HEAD>
33290 <BODY>
33291 <H1>FEATURE: <!--#echo var="FEAT_disable-pipes-in-sigs"--></H1>
33292
33293 By default, if a signature file name is followed by a vertical bar (|) then
33294 that causes the file to be executed to produce the text for the signature.
33295 If this feature is set, then this is not allowed.
33296 <P>
33297 <UL>
33298 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33299 </UL><P>
33300 &lt;End of help on this topic&gt;
33301 </BODY>
33302 </HTML>
33303 ====== h_config_disable_password_cmd =====
33304 <HTML>
33305 <HEAD>
33306 <TITLE>FEATURE: <!--#echo var="FEAT_disable-password-cmd"--></TITLE>
33307 </HEAD>
33308 <BODY>
33309 <H1>FEATURE: <!--#echo var="FEAT_disable-password-cmd"--></H1>
33310
33311 If set, then the Setup/Newpassword command is disabled.
33312 <P>
33313 <UL>
33314 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33315 </UL><P>
33316 &lt;End of help on this topic&gt;
33317 </BODY>
33318 </HTML>
33319 ====== h_config_disable_password_caching =====
33320 <HTML>
33321 <HEAD>
33322 <TITLE>FEATURE: <!--#echo var="FEAT_disable-password-caching"--></TITLE>
33323 </HEAD>
33324 <BODY>
33325 <H1>FEATURE: <!--#echo var="FEAT_disable-password-caching"--></H1>
33326
33327 Normally, loginname/password combinations are cached in Alpine so that
33328 you do not have to enter the same password more than once in a session.
33329 A disadvantage to this approach is that the password must be stored in
33330 the memory image of the running Alpine in order that it can be re-used.
33331 In the event that Alpine crashes and produces a core dump, and that core
33332 dump is readable by others, the loginname and password could be read
33333 from the core dump.
33334 <P>
33335 If this feature is set, then the passwords will not be cached and you
33336 will have to retype the password whenever Alpine needs it.
33337 Even with this feature set there is still some chance that the core
33338 file will contain a password, so care should be taken to make the
33339 core files unreadable.
33340 <P>
33341 NOTE: If PASSFILE caching is enabled, this does not disable it.
33342 That is a separate and independent feature.
33343 <UL>
33344 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33345 </UL><P>
33346 &lt;End of help on this topic&gt;
33347 </BODY>
33348 </HTML>
33349 ====== h_config_disable_password_file_saving =====
33350 <HTML>
33351 <HEAD>
33352 <TITLE>FEATURE: <!--#echo var="FEAT_disable-password-file-saving"--></TITLE>
33353 </HEAD>
33354 <BODY>
33355 <H1>FEATURE: <!--#echo var="FEAT_disable-password-file-saving"--></H1>
33356
33357 This feature changes the behavior of Alpine when a login name and password combination
33358 for a specific server is not found in the password file. The default behavior is that
33359 Alpine will ask the user if they wish to save this information in the password file for future
33360 use. It is assumed that if a user created a password file it is because they intend
33361 to use it, but in some instances a user might want to save some passwords and not others.
33362 In this case, enabling this feature will make Alpine not add any more passwords to the
33363 password file and will only use the passwords that it already saved. If you wish to allow
33364 Alpine to save more passwords in the password file, disable this feature.
33365 <P>
33366 <UL>
33367 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33368 </UL><P>
33369 &lt;End of help on this topic&gt;
33370 </BODY>
33371 </HTML>
33372 ====== h_config_disable_kb_lock =====
33373 <HTML>
33374 <HEAD>
33375 <TITLE>FEATURE: <!--#echo var="FEAT_disable-keyboard-lock-cmd"--></TITLE>
33376 </HEAD>
33377 <BODY>
33378 <H1>FEATURE: <!--#echo var="FEAT_disable-keyboard-lock-cmd"--></H1>
33379
33380 If set, then the Keyboard Lock command is removed from the MAIN MENU.
33381 <P>
33382 <UL>
33383 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33384 </UL><P>
33385 &lt;End of help on this topic&gt;
33386 </BODY>
33387 </HTML>
33388 ====== h_config_disable_config_cmd =====
33389 <HTML>
33390 <HEAD>
33391 <TITLE>FEATURE: <!--#echo var="FEAT_disable-config-cmd"--></TITLE>
33392 </HEAD>
33393 <BODY>
33394 <H1>FEATURE: <!--#echo var="FEAT_disable-config-cmd"--></H1>
33395
33396 If set, then the Setup/Config screen is disabled.
33397 <P>
33398 <UL>
33399 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33400 </UL><P>
33401 &lt;End of help on this topic&gt;
33402 </BODY>
33403 </HTML>
33404 ====== h_config_allow_chg_from =====
33405 <HTML>
33406 <HEAD>
33407 <TITLE>FEATURE: <!--#echo var="FEAT_allow-changing-from"--></TITLE>
33408 </HEAD>
33409 <BODY>
33410 <H1>FEATURE: <!--#echo var="FEAT_allow-changing-from"--></H1>
33411
33412 This feature affects Alpine's handling of the &quot;From:&quot; header field
33413 in the "<A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A>" configuration
33414 option.
33415 <P>
33416 If this feature is set then the From line can be changed just like
33417 all the other header fields that can be changed.
33418 This feature defaults to <EM>ON</EM>.
33419 <P>
33420 Even with this feature turned ON (the default) you will not be able
33421 to change the From header unless you add it to your list of
33422 <A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A>.
33423 You may also want to change the
33424 <A HREF="h_config_comp_hdrs"><!--#echo var="VAR_default-composer-hdrs"--></A>
33425 if you want the From header to always show up in the composer without
33426 having to type the Rich Headers command first.
33427 <P>
33428 Note that many sites restrict the use of this feature in order to
33429 reduce the chance of falsified addresses and misdirected mail.
33430 If you want to change the value of what gets included in the From header
33431 in messages you send
33432 look <A HREF="h_config_change_your_from">here</A> for a description.
33433 <P>
33434 <UL>
33435 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33436 </UL><P>
33437 &lt;End of help on this topic&gt;
33438 </BODY>
33439 </HTML>
33440 ====== h_config_disable_collate =====
33441 <HTML>
33442 <HEAD>
33443 <TITLE>FEATURE: <!--#echo var="FEAT_disable-setlocale-collate"--></TITLE>
33444 </HEAD>
33445 <BODY>
33446 <H1>FEATURE: <!--#echo var="FEAT_disable-setlocale-collate"--></H1>
33447
33448 This is a hard to understand feature that should only be used in rare cases.
33449 Normally, the C function call
33450 <P>
33451 <CENTER><SAMP>setlocale(LC_COLLATE, &quot;&quot;)</SAMP></CENTER>
33452 <P>
33453 is used by Alpine.
33454 If you want to try turning it off,
33455 setting this feature will turn it off.
33456 This part of the locale has to do with the sort order
33457 of characters in your locale.
33458 <P>
33459 <UL>
33460 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33461 </UL><P>
33462 &lt;End of help on this topic&gt;
33463 </BODY>
33464 </HTML>
33465 ====== h_config_quell_attach_extra_prompt =====
33466 <HTML>
33467 <HEAD>
33468 <TITLE>FEATURE: <!--#echo var="FEAT_quell-attachment-extra-prompt"--></TITLE>
33469 </HEAD>
33470 <BODY>
33471 <H1>FEATURE: <!--#echo var="FEAT_quell-attachment-extra-prompt"--></H1>
33472
33473 By default, when you attempt to view an attachment externally
33474 from the &quot;Attachment View&quot; screen, you are asked if you
33475 really want to view the selected attachment.
33476
33477 <P>
33478 If this feature is set, you will <B>not</B> be prompted to confirm
33479 your selection.  Prior to Alpine and to Pine 4.50, the default behavior was to not
33480 prompt. This feature was added for those wanting to preserve that
33481 behavior (along with
33482 <A HREF="h_config_quell_attach_ext_warn"><!--#echo var="FEAT_quell-attachment-extension-warn"--></A>).
33483
33484 <P>
33485 <UL>
33486 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33487 </UL><P>
33488 &lt;End of help on this topic&gt;
33489 </BODY>
33490 </HTML>
33491 ====== h_config_quell_attach_ext_warn =====
33492 <HTML>
33493 <HEAD>
33494 <TITLE>FEATURE: <!--#echo var="FEAT_quell-attachment-extension-warn"--></TITLE>
33495 </HEAD>
33496 <BODY>
33497 <H1>FEATURE: <!--#echo var="FEAT_quell-attachment-extension-warn"--></H1>
33498
33499 <P>
33500 This feature suppresses the extra warning you can get when trying
33501 to view an attachment for which there is no mime-type match.  Turning
33502 on this feature will just run the program according to extension
33503 instead of first warning the user that it will run according to the
33504 file's extension.
33505 <P>
33506 This feature can be used along side
33507 <A HREF="h_config_quell_attach_extra_prompt"><!--#echo var="FEAT_quell-attachment-extra-prompt"--></A>
33508 to preserve the behavior exhibited in Pine versions prior to Pine 4.50.
33509 <P>
33510 <UL>
33511 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33512 </UL><P>
33513 &lt;End of help on this topic&gt;
33514 </BODY>
33515 </HTML>
33516 ====== h_config_mailcap_params =====
33517 <HTML>
33518 <HEAD>
33519 <TITLE>FEATURE: <!--#echo var="FEAT_enable-mailcap-param-substitution"--></TITLE>
33520 </HEAD>
33521 <BODY>
33522 <H1>FEATURE: <!--#echo var="FEAT_enable-mailcap-param-substitution"--></H1>
33523
33524 If set, this will allow mailcap named parameter substitution to occur
33525 in mailcap entries.
33526 By default, this is turned off to prevent security problems that may occur
33527 with some incorrect mailcap configurations.
33528 For more information, see RFC1524 and look for "named parameters" in the
33529 text of the RFC.
33530 <P>
33531 <UL>
33532 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33533 </UL><P>
33534 &lt;End of help on this topic&gt;
33535 </BODY>
33536 </HTML>
33537 ====== h_config_disable_shared =====
33538 <HTML>
33539 <HEAD>
33540 <TITLE>FEATURE: <!--#echo var="FEAT_disable-shared-namespaces"--></TITLE>
33541 </HEAD>
33542 <BODY>
33543 <H1>FEATURE: <!--#echo var="FEAT_disable-shared-namespaces"--></H1>
33544
33545 If this feature is set, the automatic search for namespaces &quot;ftp&quot;,
33546 &quot;imapshared&quot;, and &quot;imappublic&quot; by the underlying library
33547 will be disabled.
33548 The reason this feature exists is because there are some implementations
33549 of system password lookup routines that are very slow when presented with
33550 a long loginname that does not exist.
33551 This feature could be set to prevent the delay at startup time when the
33552 names above are searched for in the password file.
33553 <P>
33554 <UL>
33555 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33556 </UL><P>
33557 &lt;End of help on this topic&gt;
33558 </BODY>
33559 </HTML>
33560 ====== h_config_hide_nntp_path =====
33561 <HTML>
33562 <HEAD>
33563 <TITLE>FEATURE: <!--#echo var="FEAT_hide-nntp-path"--></TITLE>
33564 </HEAD>
33565 <BODY>
33566 <H1>FEATURE: <!--#echo var="FEAT_hide-nntp-path"--></H1>
33567
33568 Normally the Path header that Alpine generates when posting to a newsgroup
33569 contains the name of the computer from which the message is being sent and
33570 the user name.
33571 Some believe that this information is used by spammers.
33572 If this feature is set, that information will be replaced with the text
33573 <P>
33574 <CENTER><SAMP>not-for-mail</SAMP></CENTER>
33575 <P>
33576 instead.
33577 <P>
33578 It should be noted that many servers being connected to will still reveal
33579 the information that this feature attempts to protect.
33580 <P>
33581 <UL>
33582 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33583 </UL><P>
33584 &lt;End of help on this topic&gt;
33585 </BODY>
33586 </HTML>
33587 ====== h_config_no_bezerk_zone =====
33588 <HTML>
33589 <HEAD>
33590 <TITLE>FEATURE: <!--#echo var="FEAT_quell-berkeley-format-timezone"--></TITLE>
33591 </HEAD>
33592 <BODY>
33593 <H1>FEATURE: <!--#echo var="FEAT_quell-berkeley-format-timezone"--></H1>
33594
33595 POSIX mandates a timezone in UNIX mailbox format folder delimiters
33596 (the line that begins with From <SPACE>).
33597 Some versions of Berkeley mail have trouble with this, and don't recognize
33598 the line as a message delimiter.
33599 If this feature is set, the timezone will be left off the delimiter line.
33600 <P>
33601 <UL>
33602 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33603 </UL><P>
33604 &lt;End of help on this topic&gt;
33605 </BODY>
33606 </HTML>
33607 ====== h_config_quell_domain_warn =====
33608 <HTML>
33609 <HEAD>
33610 <TITLE>FEATURE: <!--#echo var="FEAT_quell-maildomain-warning"--></TITLE>
33611 </HEAD>
33612 <BODY>
33613 <H1>FEATURE: <!--#echo var="FEAT_quell-maildomain-warning"--></H1>
33614
33615 When your configuration is set up so that your domain name contains no dots,
33616 it is usually a configuration error.
33617 By default, Alpine will warn you about this when you start it up.
33618 You will see a warning message that looks like
33619
33620 <P>
33621 <CENTER><SAMP>Incomplete maildomain &quot;&lt;domain&gt;&quot;.</SAMP></CENTER>
33622
33623 <P>
33624 If this feature is set, the warning is turned off.
33625 <P>
33626 <UL>
33627 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33628 </UL><P>
33629 &lt;End of help on this topic&gt;
33630 </BODY>
33631 </HTML>
33632 ====== h_config_quell_imap_env =====
33633 <HTML>
33634 <HEAD>
33635 <TITLE>FEATURE: <!--#echo var="FEAT_quell-imap-envelope-update"--></TITLE>
33636 </HEAD>
33637 <BODY>
33638 <H1>FEATURE: <!--#echo var="FEAT_quell-imap-envelope-update"--></H1>
33639
33640 In the MESSAGE INDEX screen, if the open folder is being accessed
33641 using IMAP, Alpine normally tries to paint the index lines on the screen
33642 as soon as the information arrives from the IMAP server.
33643 This means that the index information makes it onto the screen more quickly
33644 than it otherwise would.
33645 This sometimes results in behavior that bothers some users.
33646 For example, when paging to a new page of the index, it may be possible for
33647 the lines to be painted on the screen in a random order, rather than from
33648 top to bottom.
33649 <P>
33650
33651 Setting this feature causes Alpine to wait for all of the information
33652 to be gathered before it paints the index screen.
33653 Once it collects all of the information, the screen will be painted quickly
33654 from top to bottom.
33655 <P>
33656 <UL>
33657 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33658 </UL><P>
33659 &lt;End of help on this topic&gt;
33660 </BODY>
33661 </HTML>
33662 ====== h_config_quell_news_env =====
33663 <HTML>
33664 <HEAD>
33665 <TITLE>FEATURE: <!--#echo var="FEAT_quell-news-envelope-update"--></TITLE>
33666 </HEAD>
33667 <BODY>
33668 <H1>FEATURE: <!--#echo var="FEAT_quell-news-envelope-update"--></H1>
33669
33670 In the MESSAGE INDEX screen, if the open folder is being accessed
33671 using NNTP (News), Alpine normally tries to paint the index lines on the screen
33672 as soon as the information arrives from the NNTP server.
33673 This means that the index information makes it onto the screen more quickly
33674 than it otherwise would.
33675 This sometimes results in behavior that bothers some users.
33676 For example, when paging to a new page of the index, it may be possible for
33677 the lines to be painted on the screen in a random order, rather than from
33678 top to bottom.
33679 <P>
33680
33681 Setting this feature causes Alpine to wait for all of the information
33682 to be gathered before it paints the index screen.
33683 Once it collects all of the information, the screen will be painted quickly
33684 from top to bottom.
33685 <P>
33686 <UL>
33687 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33688 </UL><P>
33689 &lt;End of help on this topic&gt;
33690 </BODY>
33691 </HTML>
33692 ====== h_config_quell_content_id =====
33693 <HTML>
33694 <HEAD>
33695 <TITLE>FEATURE: <!--#echo var="FEAT_quell-content-id"--></TITLE>
33696 </HEAD>
33697 <BODY>
33698 <H1>FEATURE: <!--#echo var="FEAT_quell-content-id"--></H1>
33699
33700 This feature changes the behavior of Alpine when sending messages.
33701 It is intended to work around a bug in Microsoft's Outlook XP mail user
33702 agent.
33703 As of this writing, Microsoft has acknowledged the bug but
33704 has not added it to the Knowledge Base.
33705 We have been told that there will be a post-SP1 hotfix for Outlook XP.
33706 This particular bug has bug fix number OfficeQFE:4781.
33707 The nature of the bug is that messages with attachments that
33708 contain a Content-ID header (which standard Alpine attachments do)
33709 do not show the attachment indicator (a paperclip) when viewed with
33710 Outlook XP.
33711 So the user has no indication that the message contains an attachment.
33712
33713 <P>
33714 If this feature is set then Alpine will remove most Content-ID headers
33715 before sending a message.
33716 If an attachment is of type MESSAGE, then the existing Content-ID headers
33717 inside the message will be left intact.
33718 This would only happen with Alpine if a message was forwarded as an attachment
33719 or if a message with a message attached was forwarded.
33720 Similarly if an attachment of type MULTIPART/ALTERNATIVE is forwarded,
33721 the Content-ID headers of the alternative parts will not be removed.
33722
33723 <P>
33724 Because the Content-ID header is a standard part of MIME it is possible
33725 that setting this feature will break something.
33726 For example, if an attachment has a Content-ID header that is necessary
33727 for the correct functioning of that attachment, it is possible that Alpine
33728 may remove that header when the attachment is forwarded.
33729 However, it seems fairly safe at this time.
33730
33731 <P>
33732 <UL>
33733 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33734 </UL><P>
33735 &lt;End of help on this topic&gt;
33736 </BODY>
33737 </HTML>
33738 ====== h_config_winpos_in_config =====
33739 <HTML>
33740 <HEAD>
33741 <TITLE>FEATURE: <!--#echo var="FEAT_store-window-position-in-config"--></TITLE>
33742 </HEAD>
33743 <BODY>
33744 <H1>FEATURE: <!--#echo var="FEAT_store-window-position-in-config"--></H1>
33745
33746 PC-Alpine only.
33747 <P>
33748
33749 Normally, PC-Alpine will store its window size and position in the
33750 Windows Registry.
33751 This is convenient if you want to use the same remote
33752 configuration from more than one PC.
33753 If you use multiple configuration files to start PC-Alpine, you may want
33754 to store the window size and position in the configuration file instead
33755 of in the Registry.
33756 Setting this feature causes the value to be stored in
33757 <A HREF="h_config_window_position">Window-Position</A>.
33758
33759 <P>
33760 <UL>
33761 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33762 </UL><P>
33763 &lt;End of help on this topic&gt;
33764 </BODY>
33765 </HTML>
33766 ====== h_config_quell_ssl_largeblocks =====
33767 <HTML>
33768 <HEAD>
33769 <TITLE>FEATURE: <!--#echo var="FEAT_quell-ssl-largeblocks"--></TITLE>
33770 </HEAD>
33771 <BODY>
33772 <H1>FEATURE: <!--#echo var="FEAT_quell-ssl-largeblocks"--></H1>
33773
33774 PC-Alpine only.
33775 <P>
33776 This feature changes the behavior of fetching messages
33777 and attachments so that the message data is fetched in chunks no larger
33778 than 12K bytes.
33779 This works around a bug in Microsoft's SSL/TLS support.
33780 Some versions of Microsoft SSL are not able to read full-sized (16K)
33781 SSL/TLS packets.
33782 Some servers will send such packets and this will
33783 cause PC-Alpine to crash with the error
33784
33785 <P>
33786 <CENTER><SAMP>incomplete SecBuffer exceeds maximum buffer size</SAMP></CENTER>
33787
33788 <P>
33789 Microsoft is aware of the problem and has developed a hotfix for it, it is
33790 discussed in article 300562 in the Microsoft Knowledge Base.
33791 <P>
33792 <UL>
33793 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33794 </UL><P>
33795 &lt;End of help on this topic&gt;
33796 </BODY>
33797 </HTML>
33798 ====== h_config_quell_partial =====
33799 <HTML>
33800 <HEAD>
33801 <TITLE>FEATURE: <!--#echo var="FEAT_quell-partial-fetching"--></TITLE>
33802 </HEAD>
33803 <BODY>
33804 <H1>FEATURE: <!--#echo var="FEAT_quell-partial-fetching"--></H1>
33805
33806 Partial fetching is a feature of the IMAP protocol.
33807 By default, Alpine
33808 will use partial fetching when copying the contents of a message or attachment
33809 from the IMAP server to Alpine.
33810 This means that the fetch will be done in many
33811 small chunks instead of one big chunk. The main benefit of this approach is
33812 that the fetch becomes interruptible. That is, the user can type <EM>^C</EM>
33813 to stop the fetch early. In some cases partial fetching may cause a performance
33814 problem so that the fetching of data takes significantly longer when partial
33815 fetching is used. Turning on this feature will turn off partial fetching.
33816 <P>
33817 <UL>
33818 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33819 </UL><P>
33820 &lt;End of help on this topic&gt;
33821 </BODY>
33822 </HTML>
33823 ====== h_config_quell_personal_name_prompt =====
33824 <HTML>
33825 <HEAD>
33826 <TITLE>FEATURE: <!--#echo var="FEAT_quell-personal-name-prompt"--></TITLE>
33827 </HEAD>
33828 <BODY>
33829 <H1>FEATURE: <!--#echo var="FEAT_quell-personal-name-prompt"--></H1>
33830
33831 PC-Alpine only.  This feature quells the prompting for a
33832 <A HREF="h_config_pers_name">personal name</A>.  This
33833 prompt normally happens before composing a message, and only happens when
33834 there is no personal name already set.
33835 <P>
33836 <UL>
33837 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33838 </UL><P>
33839 &lt;End of help on this topic&gt;
33840 </BODY>
33841 </HTML>
33842 ====== h_config_quell_user_id_prompt =====
33843 <HTML>
33844 <HEAD>
33845 <TITLE>FEATURE: <!--#echo var="FEAT_quell-user-id-prompt"--></TITLE>
33846 </HEAD>
33847 <BODY>
33848 <H1>FEATURE: <!--#echo var="FEAT_quell-user-id-prompt"--></H1>
33849
33850 PC-Alpine only.  This feature quells the prompting for a
33851 <A HREF="h_config_user_id"><!--#echo var="VAR_user-id"--></A>
33852 if the information can be obtained from the login name used
33853 to open the INBOX.  Normally, this prompt happens before composing
33854 a message, and only happens when there is no user-id already set
33855 in the configuration.
33856 <P>
33857 With this feature set, composing a message is only possible after
33858 establishing a connection to the INBOX.
33859 <P>
33860 <UL>
33861 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33862 </UL><P>
33863 &lt;End of help on this topic&gt;
33864 </BODY>
33865 </HTML>
33866 ====== h_config_save_aggregates =====
33867 <HTML>
33868 <HEAD>
33869 <TITLE>FEATURE: <!--#echo var="FEAT_save-aggregates-copy-sequence"--></TITLE>
33870 </HEAD>
33871 <BODY>
33872 <H1>FEATURE: <!--#echo var="FEAT_save-aggregates-copy-sequence"--></H1>
33873
33874 This feature will optimize an aggregate copy operation, if
33875 possible, by issuing a single IMAP <EM>COPY</EM> command with a
33876 list of the messages to be copied.
33877 This feature is set by default.
33878 This may reduce network traffic and elapsed time for the Save.
33879 <EM>However, many IMAP servers (including the UW IMAP server) do
33880 not preserve the order of messages when this optimization is applied.</EM>
33881 If this feature is not set,
33882 Alpine will copy each message individually and the order of the messages
33883 will be preserved.
33884 <P>
33885 <UL>
33886 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33887 </UL><P>
33888 &lt;End of help on this topic&gt;
33889 </BODY>
33890 </HTML>
33891 ====== h_config_use_system_translation =====
33892 <HTML>
33893 <HEAD>
33894 <TITLE>FEATURE: Use System Translation</TITLE>
33895 </HEAD>
33896 <BODY>
33897 <H1>FEATURE: Use System Translation</H1>
33898
33899 UNIX Alpine only.
33900 <P>
33901 Alpine normally uses its own internal software to convert between the multi-byte
33902 representation of characters and the Unicode representation of those
33903 same characters.
33904 It converts from the multi-byte characters your keyboard produces to Unicode,
33905 and from Unicode to the multi-byte characters your display expects.
33906 Alpine also uses its own internal software to decide how much space on
33907 the screen a particular Unicode character will occupy.
33908
33909 <P>
33910 Setting this feature tells Alpine to use the system-supplied routines to
33911 perform these tasks instead.
33912 In particular there are three tasks and three system routines that will
33913 be used for these tasks.
33914
33915 <P>
33916 To convert from multi-byte to Unicode the routine
33917
33918 <P>
33919 <CENTER><SAMP>mbstowcs</SAMP></CENTER>
33920 <P>
33921
33922 is used.
33923 To convert from Unicode to multi-byte the routine
33924
33925 <P>
33926 <CENTER><SAMP>wcrtomb</SAMP></CENTER>
33927 <P>
33928
33929 is used.
33930 And to find the screen width a particular Unicode character will
33931 occupy the routine used is
33932
33933 <P>
33934 <CENTER><SAMP>wcwidth</SAMP></CENTER>
33935 <P>
33936
33937 This feature has been only lightly tested.
33938 The internal routines should normally be used unless you run into
33939 a problem that you think may be solved by using the system routines.
33940 Note that your environment needs to be set up for these
33941 routines to work correctly.
33942 In particular, the LANG or LC_CTYPE variable in your environment will
33943 need to be set.
33944
33945 <P>
33946 <UL>
33947 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33948 </UL><P>
33949 &lt;End of help on this topic&gt;
33950 </BODY>
33951 </HTML>
33952 ====== h_config_suspend_spawns =====
33953 <HTML>
33954 <HEAD>
33955 <TITLE>FEATURE: <!--#echo var="FEAT_use-subshell-for-suspend"--></TITLE>
33956 </HEAD>
33957 <BODY>
33958 <H1>FEATURE: <!--#echo var="FEAT_use-subshell-for-suspend"--></H1>
33959
33960 This feature affects Alpine's behavior when process suspension is enabled
33961 and then activated via the Ctrl-Z key.  Alpine suspension allows one to
33962 temporarily interact with the operating system command &quot;shell&quot;
33963 without
33964 quitting Alpine, and then subsequently resume the still-active Alpine session.
33965 <P>
33966
33967 When the <A HREF="h_config_can_suspend">&quot;<!--#echo var="FEAT_enable-suspend"-->&quot;</A> feature
33968 is set and subsequently the Ctrl-Z key
33969 is pressed, Alpine will normally suspend itself and return temporary control
33970 to Alpine's parent shell process.  However, if this feature is set, Alpine
33971 will instead create an inferior subshell process.  This is useful when the
33972 parent process is not intended to be used interactively.  Examples include
33973 invoking Alpine via the -e argument of the Unix &quot;xterm&quot; program,
33974 or via a menu system.<P>
33975
33976 Note that one typically resumes a suspended Alpine by entering the Unix
33977 &quot;fg&quot; command, but if this feature is set, it will be necessary to
33978 enter the &quot;exit&quot; command instead.
33979 <P>
33980 <UL>
33981 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33982 </UL><P>
33983 &lt;End of help on this topic&gt;
33984 </BODY>
33985 </HTML>
33986 ====== h_config_8bit_smtp =====
33987 <HTML>
33988 <HEAD>
33989 <TITLE>FEATURE: <!--#echo var="FEAT_enable-8bit-esmtp-negotiation"--></TITLE>
33990 </HEAD>
33991 <BODY>
33992 <H1>FEATURE: <!--#echo var="FEAT_enable-8bit-esmtp-negotiation"--></H1>
33993
33994 This feature affects Alpine's behavior when sending mail.
33995 By default, this feature is set.
33996 Internet standards
33997 require that all electronic mail messages traversing the global Internet
33998 consist of 7bit ASCII characters unless a pair of cooperating mail
33999 transfer agents explicitly agree to allow 8bit messages.  In general,
34000 then, exchanging messages in non-ASCII characters requires MIME encoding.
34001 <P>
34002 However, there are now Internet standards that allow for unencoded 8bit
34003 exchange of messages between cooperating systems.  When this feature is set
34004 Alpine will try to negotiate unencoded 8bit transmission during the
34005 sending process.  Should the negotiation fail, Alpine will fall back to its
34006 ordinary encoding rules.
34007 <P>
34008 Note, this feature relies on your system's mail transport agent or
34009 configured <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>
34010 having the negotiation mechanism introduced in
34011 &quot;Extended SMTP&quot; (ESMTP) and the specific extension called
34012 &quot;8BITMIME&quot;.
34013 <P>
34014 ESMTP allows for graceful migration to upgraded mail transfer agents, but
34015 it is possible that this feature might cause problems for some servers.
34016 <P><UL>
34017 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34018 </UL>
34019 <P>&lt;End of help on this topic&gt;
34020 </BODY>
34021 </HTML>
34022 ====== h_config_8bit_nntp =====
34023 <HTML>
34024 <HEAD>
34025 <TITLE>FEATURE: <!--#echo var="FEAT_enable-8bit-nntp-posting"--></TITLE>
34026 </HEAD>
34027 <BODY>
34028 <H1>FEATURE: <!--#echo var="FEAT_enable-8bit-nntp-posting"--></H1>
34029
34030 This feature affects Alpine's behavior when posting news.
34031
34032 <P>
34033
34034 The Internet standard for exchanging USENET news messages (RFC-1036)
34035 specifies that USENET messages should conform to Internet mail standards
34036 and contain only 7bit characters, but much of the news transport software
34037 in use today is capable of successfully sending messages containing 8bit
34038 characters.  Hence, many people believe that it is appropriate to send 8bit
34039 news messages without any MIME encoding.
34040
34041 <P>
34042
34043 Moreover, there is no Internet standard for explicitly negotiating 8bit
34044 transfer, as there is for Internet email.  Therefore, Alpine provides the
34045 option of posting unencoded 8bit news messages, though not as the default.
34046 Setting this feature will turn OFF Alpine's MIME encoding of newsgroup
34047 postings that contain 8bit characters.
34048
34049 <P>
34050
34051 Note, articles may cross a path or pass through news transport software
34052 that is unsafe or even hostile to 8bit characters.  At best this will only
34053 cause the posting to become garbled.  The safest way to transmit 8bit
34054 characters is to leave Alpine's MIME encoding turned on, but recipients
34055 who lack MIME-aware tools are often annoyed when they receive MIME-encoded
34056 messages.
34057 <P>
34058 &lt;End of help on this topic&gt;
34059 </BODY>
34060 </HTML>
34061 ====== h_config_mark_for_cc =====
34062 <HTML>
34063 <HEAD>
34064 <TITLE>FEATURE: <!--#echo var="FEAT_mark-for-cc"--></TITLE>
34065 </HEAD>
34066 <BODY>
34067 <H1>FEATURE: <!--#echo var="FEAT_mark-for-cc"--></H1>
34068
34069 This feature affects Alpine's MESSAGE INDEX display.
34070 By default, a '+' is displayed in the first column if the
34071 message is addressed directly to you.
34072 When this feature is set and the message is not addressed to you, then a
34073 '-' character is displayed if the message is instead Cc'd directly
34074 to you.
34075
34076 <P>
34077 <UL>
34078 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34079 </UL><P>
34080 &lt;End of help on this topic&gt;
34081 </BODY>
34082 </HTML>
34083 ====== h_config_tab_uses_unseen =====
34084 <HTML>
34085 <HEAD>
34086 <TITLE>FEATURE: <!--#echo var="FEAT_tab-uses-unseen-for-next-folder"--></TITLE>
34087 </HEAD>
34088 <BODY>
34089 <H1>FEATURE: <!--#echo var="FEAT_tab-uses-unseen-for-next-folder"--></H1>
34090
34091 This feature affects Alpine's behavior when using the TAB
34092 <A HREF="h_common_nextnew">NextNew Command</A>
34093 to move from one folder to the next.
34094 Alpine's usual behavior is to search for folders
34095 with <EM>Recent</EM> messages in them.
34096 Recent messages are messages that have arrived since the last time the
34097 folder was opened.
34098
34099 <P>
34100 Setting this feature causes Alpine to search for <EM>Unseen</EM>
34101 messages instead of Recent messages.
34102 Unseen messages remain Unseen until you view them (or flag then as Seen with
34103 the <A HREF="h_common_flag">Flag Command</A>).
34104 Setting this feature allows you to locate messages you have not read
34105 instead of only recently received messages.
34106 When this feature is set, the feature
34107 <A HREF="h_config_fast_recent">&quot;<!--#echo var="FEAT_enable-fast-recent-test"-->&quot;</A>
34108 will have no effect, so the checking may be slower.
34109
34110 <P>
34111 Another reason why you might want to use this feature is that Alpine sometimes
34112 opens folders implicitly behind the scenes, and this clears the
34113 Recent status of all messages in the folder.
34114 One example where this happens is when Saving or filtering a
34115 message to another folder.
34116 If that message has some <A HREF="h_config_keywords">keywords</A>
34117 set, then because of some shortcomings
34118 in the IMAP specification, the best way to ensure that those keywords are
34119 still set in the saved copy of the message is to open the folder and
34120 set the keywords explicitly.
34121 Because this clears the Recent status of all messages in that folder the
34122 folder will not be found by the NextNew command unless this feature is set.
34123
34124 <P>
34125 &lt;End of help on this topic&gt;
34126 </BODY>
34127 </HTML>
34128 ====== h_config_tab_new_only =====
34129 <HTML>
34130 <HEAD>
34131 <TITLE>FEATURE: <!--#echo var="FEAT_tab-visits-next-new-message-only"--></TITLE>
34132 </HEAD>
34133 <BODY>
34134 <H1>FEATURE: <!--#echo var="FEAT_tab-visits-next-new-message-only"--></H1>
34135
34136 This feature affects Alpine's behavior when using the TAB key to move from
34137 one message to the next.  Alpine's usual behavior is to select the next
34138 unread message or message flagged as "Important".
34139
34140 <P>
34141
34142 Setting this feature causes Alpine to skip the messages flagged as important,
34143 and select unread messages exclusively.  Tab behavior when there are no
34144 new messages left to select remains unchanged.
34145 <P>
34146 &lt;End of help on this topic&gt;
34147 </BODY>
34148 </HTML>
34149 ====== h_config_warn_if_subj_blank =====
34150 <HTML>
34151 <HEAD>
34152 <TITLE>FEATURE: <!--#echo var="FEAT_warn-if-blank-subject"--></TITLE>
34153 </HEAD>
34154 <BODY>
34155 <H1>FEATURE: <!--#echo var="FEAT_warn-if-blank-subject"--></H1>
34156
34157 This feature affects Alpine's behavior when you send a message being
34158 composed.
34159 If this option is set, Alpine will check to see if the message about to be sent
34160 has a subject or not.
34161 If not, you will be asked if you want to send the message anyway.
34162 <P>
34163
34164 <UL>
34165 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34166 </UL><P>
34167 &lt;End of help on this topic&gt;
34168 </BODY>
34169 </HTML>
34170 ====== h_config_warn_if_fcc_blank =====
34171 <HTML>
34172 <HEAD>
34173 <TITLE>FEATURE: <!--#echo var="FEAT_warn-if-blank-fcc"--></TITLE>
34174 </HEAD>
34175 <BODY>
34176 <H1>FEATURE: <!--#echo var="FEAT_warn-if-blank-fcc"--></H1>
34177
34178 This feature affects Alpine's behavior when you send a message being
34179 composed.
34180 If this option is set, Alpine will check to see if the message about to be sent
34181 has an Fcc or not.
34182 If not, you will be asked if you want to send the message anyway.
34183 <P>
34184
34185 <UL>
34186 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34187 </UL><P>
34188 &lt;End of help on this topic&gt;
34189 </BODY>
34190 </HTML>
34191 ====== h_config_warn_if_no_to_or_cc =====
34192 <HTML>
34193 <HEAD>
34194 <TITLE>FEATURE: <!--#echo var="FEAT_warn-if-blank-to-and-cc-and-newsgroups"--></TITLE>
34195 </HEAD>
34196 <BODY>
34197 <H1>FEATURE: <!--#echo var="FEAT_warn-if-blank-to-and-cc-and-newsgroups"--></H1>
34198
34199 This feature affects Alpine's behavior when you send a message being
34200 composed.
34201 If this option is set, Alpine will check to see if the message about to be sent
34202 has either a To address, a Cc address, or a Newsgroup.
34203 If none of these is set,
34204 you will be asked if you want to send the message anyway.
34205 <P>
34206
34207 This feature is closely related to
34208 <A HREF="h_config_auto_fcc_only"><!--#echo var="FEAT_fcc-only-without-confirm"--></A>.
34209 Alpine will normally ask if you want to copy a message only to the Fcc.
34210 This feature also applies to cases where there is a Bcc but still no To, Cc,
34211 or Newsgroup.
34212 If the <!--#echo var="FEAT_fcc-only-without-confirm"--> feature is set and you are sending a
34213 message with only an Fcc, then you won't be asked about sending with
34214 a blank To and Cc and Newsgroups header even if this feature is set.
34215 Similarly, if you have already been asked if you want to send to the Fcc
34216 only and you have answered Yes, then you won't be asked again about sending with
34217 blank To, Cc, and Newsgroups headers even if this feature is set.
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_quell_dead_letter =====
34227 <HTML>
34228 <HEAD>
34229 <TITLE>FEATURE: <!--#echo var="FEAT_quell-dead-letter-on-cancel"--></TITLE>
34230 </HEAD>
34231 <BODY>
34232 <H1>FEATURE: <!--#echo var="FEAT_quell-dead-letter-on-cancel"--></H1>
34233
34234 This feature affects Alpine's behavior when you cancel a message being
34235 composed.  Alpine's usual behavior is to write the canceled message to
34236 a file named
34237 <!--chtml if pinemode="os_windows"-->
34238 &quot;DEADLETR&quot;,
34239 <!--chtml else-->
34240 &quot;dead.letter&quot; in your home directory,
34241 <!--chtml endif-->
34242 overwriting any previous message. Under
34243 some conditions (some routine), this can introduce a noticeable delay.
34244 Setting this feature will cause Alpine NOT to write canceled compositions
34245 into the file.
34246 <P>
34247 NOTE: Enabling this feature means NO record of canceled messages is
34248 maintained.
34249 <P>
34250 This feature affects the newer option
34251 <A HREF="h_config_deadlets"><!--#echo var="VAR_dead-letter-files"--></A>, which specifies the
34252 number of dead letter files to keep around.
34253 If this feature is set, then the <!--#echo var="VAR_dead-letter-files"--> option has no effect.
34254 <P>
34255 <UL>
34256 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34257 </UL><P>
34258 &lt;End of help on this topic&gt;
34259 </BODY>
34260 </HTML>
34261 ====== h_config_quell_beeps =====
34262 <HTML>
34263 <HEAD>
34264 <TITLE>FEATURE: <!--#echo var="FEAT_quell-status-message-beeping"--></TITLE>
34265 </HEAD>
34266 <BODY>
34267 <H1>FEATURE: <!--#echo var="FEAT_quell-status-message-beeping"--></H1>
34268
34269 This feature affects Alpine's behavior when it displays status message
34270 (e.g., Error complaints, New mail warnings, etc).  Setting this feature
34271 will not affect the display of such messages, but will cause those that
34272 emit a beep to become silent.
34273
34274 <P>
34275 <UL>
34276 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34277 </UL><P>
34278 &lt;End of help on this topic&gt;
34279 </BODY>
34280 </HTML>
34281 ====== h_config_suppress_user_agent =====
34282 <HTML>
34283 <HEAD>
34284 <TITLE>FEATURE: <!--#echo var="FEAT_suppress-user-agent-when-sending"--></TITLE>
34285 </HEAD>
34286 <BODY>
34287 <H1>FEATURE: <!--#echo var="FEAT_suppress-user-agent-when-sending"--></H1>
34288
34289 If this feature is set then Alpine will not generate a
34290 <CODE>User-Agent</CODE> header in outgoing messages.
34291 <P>
34292 <UL>
34293 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34294 </UL><P>
34295 &lt;End of help on this topic&gt;
34296 </BODY>
34297 </HTML>
34298 ====== h_config_quell_lock_failure_warnings =====
34299 <HTML>
34300 <HEAD>
34301 <TITLE>FEATURE: <!--#echo var="FEAT_quell-lock-failure-warnings"--></TITLE>
34302 </HEAD>
34303 <BODY>
34304 <H1>FEATURE: <!--#echo var="FEAT_quell-lock-failure-warnings"--></H1>
34305
34306 This feature affects Alpine's behavior when it encounters a problem
34307 acquiring a mail folder lock.  Typically, a secondary file associated
34308 with the mail folder being opened is created as part of the locking
34309 process.  On some systems, such file creation has been administratively
34310 precluded by the system configuration.
34311 <P>
34312 Alpine issues a warning when such failures occur, which can become bothersome
34313 if the system is configured to disallow such actions.  Setting this
34314 feature causes Alpine to remain silent when this part of lock creation fails.
34315 <P>
34316 WARNING: systems that have been configured in a way that precludes locking
34317 introduce some risk of mail folder corruption when more than one program
34318 attempts to modify the mail folder.  This is most likely to occur to one's
34319 INBOX or other incoming message folder.
34320 <P>
34321 See also <A HREF="h_info_on_locking">&quot;What Systems Managers Need to Know about Alpine File Locking&quot;</A>.
34322 <P>
34323 <UL>
34324 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34325 </UL><P>
34326 &lt;End of help on this topic&gt;
34327 </BODY>
34328 </HTML>
34329 ====== h_config_enable_role_take ======
34330 <HTML>
34331 <HEAD>
34332 <TITLE>FEATURE: <!--#echo var="FEAT_enable-rules-under-take"--></TITLE>
34333 </HEAD>
34334 <BODY>
34335 <H1>FEATURE: <!--#echo var="FEAT_enable-rules-under-take"--></H1>
34336
34337 Normally, the Take command takes addresses from a message and helps you
34338 put them into your Address Book.
34339 If you use Rules for Indexcolors, Roles, Filtering, or Scoring;
34340 you may find it useful
34341 to be able to Take information from a message's headers and put it into
34342 a new Rule.
34343 When this feature is set, you will be given an extra prompt that gives
34344 you the choice to Take into the Address Book or Take into a rule.
34345 <P><UL>
34346 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34347 </UL>
34348 <P>
34349 &lt;End of help on this topic&gt;
34350 </BODY>
34351 </HTML>
34352 ====== h_config_enable_take_export ======
34353 <HTML>
34354 <HEAD>
34355 <TITLE>FEATURE: <!--#echo var="FEAT_enable-take-export"--></TITLE>
34356 </HEAD>
34357 <BODY>
34358 <H1>FEATURE: <!--#echo var="FEAT_enable-take-export"--></H1>
34359
34360 Normally, the Take command takes addresses from a message and helps you
34361 put them into your Address Book.
34362 When this feature is set, you will be given an extra prompt that gives you
34363 the choice to Take addresses into a file instead of your Address
34364 Book.
34365 Only the user@domain_name part of the address is put in the file.
34366 <P><UL>
34367 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34368 </UL>
34369 <P>
34370 &lt;End of help on this topic&gt;
34371 </BODY>
34372 </HTML>
34373 ====== h_config_quell_folder_internal_msg ======
34374 <HTML>
34375 <HEAD>
34376 <TITLE>FEATURE: <!--#echo var="FEAT_quell-folder-internal-msg"--></TITLE>
34377 </HEAD>
34378 <BODY>
34379 <H1>FEATURE: <!--#echo var="FEAT_quell-folder-internal-msg"--></H1>
34380
34381 This feature determines whether or not Alpine will create
34382 &quot;pseudo messages&quot; in folders that are in standard Unix or
34383 MMDF format. <P>
34384
34385 Alpine will normally create these pseudo messages when they are not already
34386 present in a standard Unix or MMDF folder.  Their purpose is to record
34387 certain mailbox state data needed for correct IMAP and POP server
34388 operation, and also for Alpine to be able to mark messages as Answered when
34389 the Reply has been postponed.<P>
34390
34391 Sites that do not use IMAP/POP for remote mail access, and that need to
34392 support mail tools that are adversely affected by the presence of the
34393 pseudo-messages (e.g. some mail notification tools) may enable this
34394 feature to tell Alpine not to create them.  Note that Alpine's
34395 &quot;Answered&quot; flag
34396 capability will be adversely affected if this is done.<P>
34397
34398 Note too that, even if this feature is enabled, Alpine will not remove
34399 pseudo-messages when it encounters them (e.g. those created by UW's imapd
34400 or ipopd servers.) This feature has no effect on folders that are not in
34401 standard Unix or MMDF format, as pseudo-messages are not needed in the
34402 other formats to record mailbox state information.
34403 <P><UL>
34404 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34405 </UL>
34406 <P>
34407 &lt;End of help on this topic&gt;
34408 </BODY>
34409 </HTML>
34410 ====== h_config_mulnews_as_typed ======
34411 <HTML>
34412 <HEAD>
34413 <TITLE>FEATURE: <!--#echo var="FEAT_mult-newsrc-hostnames-as-typed"--></TITLE>
34414 </HEAD>
34415 <BODY>
34416 <H1>FEATURE: <!--#echo var="FEAT_mult-newsrc-hostnames-as-typed"--></H1>
34417
34418 This feature will be of little use to most users.
34419 It has no effect unless the feature
34420 <A HREF="h_config_enable_mulnewsrcs"><!--#echo var="FEAT_enable-multiple-newsrcs"--></A>
34421 is set.
34422
34423 When the <!--#echo var="FEAT_enable-multiple-newsrcs"--> feature is set
34424 then the setting of this feature may have an effect on the names of the
34425 newsrc files used.
34426 Normally, the name of the news server will be canonicalized before it is
34427 used in the newsrc file name.
34428 For example, if you type the news server name
34429
34430 <P>
34431 <CENTER><SAMP>servername</SAMP></CENTER>
34432 <P>
34433
34434 it is likely that the canonical name will be something like
34435
34436 <P>
34437 <CENTER><SAMP>servername.example.com</SAMP></CENTER>
34438 <P>
34439
34440 Or it may be the case that
34441
34442 <P>
34443 <CENTER><SAMP>servername.example.com</SAMP></CENTER>
34444 <P>
34445
34446 is really an alias (a DNS CNAME) for
34447
34448 <P>
34449 <CENTER><SAMP>othername.example.com</SAMP></CENTER>
34450 <P>
34451
34452 If this feature is not set, then the canonicalized names will be used.
34453 If this feature is set, then the name you typed in (or put in your
34454 configuration) will be used.
34455
34456 <P><UL>
34457 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34458 </UL>
34459 <P>
34460 &lt;End of help on this topic&gt;
34461 </BODY>
34462 </HTML>
34463 ====== h_config_quell_empty_dirs ======
34464 <HTML>
34465 <HEAD>
34466 <TITLE>FEATURE: <!--#echo var="FEAT_quell-empty-directories"--></TITLE>
34467 </HEAD>
34468 <BODY>
34469 <H1>FEATURE: <!--#echo var="FEAT_quell-empty-directories"--></H1>
34470
34471 This feature causes Alpine to remove from the display any directories
34472 that do not contain at least one file or directory.  This can be useful
34473 to prevent overly cluttered folder lists when a collection is stored on
34474 a server that treats all names as both a folder and a directory.
34475
34476 <P>
34477 Note, enabling this feature can cause surprising behavior!  For example,
34478 you can still use Add to create a directory, but unless you immediately
34479 enter that directory and create a folder, that newly created directory
34480 may not be displayed next time you enter the folder list.
34481
34482 <P>
34483 The description above is not quite correct.
34484 Only directories which potentially may hold messages are hidden if empty.
34485 That is, a directory which is really just a directory and is not selectable
34486 as a folder will not be hidden.
34487 Such directories can occur on servers that treat most names as both a folder
34488 and a directory.
34489 These directories are typically created implicitly when a folder is created
34490 inside a directory that does not yet exist.
34491
34492 <P>
34493 <UL>
34494 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34495 </UL><P>
34496 &lt;End of help on this topic&gt;
34497 </BODY>
34498 </HTML>
34499 ====== h_config_termcap_wins =====
34500 <HTML>
34501 <HEAD>
34502 <TITLE>FEATURE: <!--#echo var="FEAT_termdef-takes-precedence"--></TITLE>
34503 </HEAD>
34504 <BODY>
34505 <H1>FEATURE: <!--#echo var="FEAT_termdef-takes-precedence"--></H1>
34506
34507 This feature may affect Alpine's low-level input routines.  Termcap (or
34508 terminfo, depending on how your copy of Alpine was compiled and linked)
34509 is the name of the database that describes terminal capabilities.  In
34510 particular, it describes the sequences of characters that various keys
34511 will emit.
34512
34513 <P>
34514 An example would be the Up Arrow key on the keyboard.  Up
34515 Arrow is not a distinct character on most Unix systems.  When you press
34516 the Up Arrow key a short sequence of characters are produced.  This
34517 sequence is supposed to be described in the termcap database by the
34518 &quot;ku&quot; capability (or by the &quot;kcuu1&quot; capability if you
34519 are using terminfo instead of termcap).
34520
34521 <P>
34522 By default, Alpine defines some terminal
34523 escape sequences that are commonly used.  For example, the sequence
34524 &quot;ESC&nbsp;O&nbsp;A&quot; is recognized as an Up Arrow key.  The sequence
34525 &quot;ESC&nbsp;[&nbsp;A&quot;
34526 is also recognized as an Up Arrow key.  These are chosen because common
34527 terminals like VT100's or ANSI standard terminals produce these
34528 sequences when you press the Up Arrow key.
34529
34530 <P>
34531 If your system's termcap
34532 (terminfo) database assigns some other function to the sequence
34533 &quot;ESC&nbsp;O&nbsp;A&quot;
34534 it is usually ignored by Alpine.  Also, if your termcap (terminfo)
34535 database assigns a sequence that doesn't begin with an escape
34536 character (<SAMP>ESC</SAMP>) it is usually ignored by Alpine.
34537 This usually works fine
34538 because most terminals emit the escape sequences that Alpine has defined
34539 by default.  We have also found that it is usually better to have these
34540 defaults take precedence over the definitions contained in the database
34541 because the defaults are more likely to be correct than the database.
34542
34543 <P>
34544 There are some terminals where this breaks down.  If you want Alpine to
34545 believe the definitions given in your termcap (terminfo) database in
34546 preference to the defaults the Alpine itself sets up, then you may turn
34547 this feature on.  Then, sequences of characters that are defined in
34548 both termcap (terminfo) and in Alpine's set of defaults will be
34549 interpreted the way that termcap (terminfo) says they should be
34550 interpreted.  Also, if your terminal capabilities database assigns a
34551 sequence that doesn't begin with escape, it will not be ignored.
34552
34553 <P>
34554 <UL>
34555 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34556 </UL><P>
34557 &lt;End of help on this topic&gt;
34558 </BODY>
34559 </HTML>
34560 ====== h_config_cruise_mode =====
34561 <HTML>
34562 <HEAD>
34563 <TITLE>FEATURE: <!--#echo var="FEAT_enable-cruise-mode"--></TITLE>
34564 </HEAD>
34565 <BODY>
34566 <H1>FEATURE: <!--#echo var="FEAT_enable-cruise-mode"--></H1>
34567
34568 This feature affects Alpine's behavior when you hit the
34569 &quot;Space&nbsp;Bar&quot; at
34570 the end of a displayed message.  Typically, Alpine complains that the end
34571 of the text has already been reached.  Setting this feature causes such
34572 keystrokes to be interpreted as if the &quot;Tab&quot; key had been hit, thus
34573 taking you to the next &quot;interesting&quot; message,
34574 or scanning ahead to the
34575 next incoming folder with &quot;interesting&quot; messages.
34576
34577 <P>
34578 <UL>
34579 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34580 </UL><P>
34581 &lt;End of help on this topic&gt;
34582 </BODY>
34583 </HTML>
34584 ====== h_config_cruise_mode_delete =====
34585 <HTML>
34586 <HEAD>
34587 <TITLE>FEATURE: <!--#echo var="FEAT_enable-cruise-mode-delete"--></TITLE>
34588 </HEAD>
34589 <BODY>
34590 <H1>FEATURE: <!--#echo var="FEAT_enable-cruise-mode-delete"--></H1>
34591
34592 This feature modifies the behavior of Alpine's
34593 <A HREF="h_config_cruise_mode">&quot;<!--#echo var="FEAT_enable-cruise-mode"-->&quot;</A> feature.
34594 Setting this feature causes Alpine to implicitly delete read
34595 messages when it moves on to display the next &quot;interesting&quot; message.
34596 <P>
34597 NOTE: Beware when enabling this feature AND the
34598 <A HREF="h_config_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm"-->&quot;</A>
34599 feature.
34600 <P>
34601 <UL>
34602 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34603 </UL><P>
34604 &lt;End of help on this topic&gt;
34605 </BODY>
34606 </HTML>
34607 ====== h_config_slash_coll_entire =====
34608 <HTML>
34609 <HEAD>
34610 <TITLE>FEATURE: <!--#echo var="FEAT_slash-collapses-entire-thread"--></TITLE>
34611 </HEAD>
34612 <BODY>
34613 <H1>FEATURE: <!--#echo var="FEAT_slash-collapses-entire-thread"--></H1>
34614
34615 The slash (/) command is available from the MESSAGE INDEX screen when
34616 the folder is sorted by either Threads or OrderedSubject, and the
34617 <A HREF="h_config_thread_disp_style"><!--#echo var="VAR_threading-display-style"--></A>
34618 is set to something other than &quot;none&quot;.
34619 Normally, the slash command Collapses or Expands the subthread that
34620 starts at the currently highlighted message, if any.
34621 If this option is set, then the slash command Collapses or Expands the
34622 <EM>entire</EM> current thread instead of just the subthread.
34623 The current thread is simply the top-level thread that contains the
34624 current message.
34625
34626 <P>
34627 <UL>
34628 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34629 </UL><P>
34630 &lt;End of help on this topic&gt;
34631 </BODY>
34632 </HTML>
34633 ====== h_config_color_thrd_import =====
34634 <HTML>
34635 <HEAD>
34636 <TITLE>FEATURE: <!--#echo var="FEAT_thread-index-shows-important-color"--></TITLE>
34637 </HEAD>
34638 <BODY>
34639 <H1>FEATURE: <!--#echo var="FEAT_thread-index-shows-important-color"--></H1>
34640
34641 This option affects only the THREAD INDEX screen.
34642 Whether or not you ever see a THREAD INDEX screen depends on the setting
34643 of the configuration option
34644 <A HREF="h_config_thread_index_style">&quot;<!--#echo var="VAR_threading-index-style"-->&quot;</A>
34645 and on the sort order of the index.
34646
34647 <P>
34648 If a message within a thread is flagged as Important
34649 and this option is set, then
34650 the entire line in the THREAD INDEX will be colored the color of the
34651 Index-important Symbol, which can be set using the
34652 <A HREF="h_color_setup">Setup Kolor</A> screen.
34653
34654 <P>
34655 <UL>
34656 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34657 </UL><P>
34658 &lt;End of help on this topic&gt;
34659 </BODY>
34660 </HTML>
34661 ====== h_config_allow_goto =====
34662 <HTML>
34663 <HEAD>
34664 <TITLE>FEATURE: <!--#echo var="FEAT_enable-goto-in-file-browser"--></TITLE>
34665 </HEAD>
34666 <BODY>
34667 <H1>FEATURE: <!--#echo var="FEAT_enable-goto-in-file-browser"--></H1>
34668
34669 This feature modifies the behavior of Alpine's file browser.  Setting this
34670 feature causes Alpine to offer the "G Goto" command in the file browser.
34671 That is the default.
34672
34673 <P>
34674
34675 The Goto command allows you to explicitly type in the desired directory.
34676 <P>
34677 &lt;End of help on this topic&gt;
34678 </BODY></HTML>
34679 ====== h_config_add_ldap =====
34680 <HTML>
34681 <HEAD>
34682 <TITLE>FEATURE: <!--#echo var="FEAT_ldap-result-to-addrbook-add"--></TITLE>
34683 </HEAD>
34684 <BODY>
34685 <H1>FEATURE: <!--#echo var="FEAT_ldap-result-to-addrbook-add"--></H1>
34686
34687 If both the Directory option
34688 <A HREF="h_config_ldap_opts_impl">&quot;Use-Implicitly-From-Composer&quot;</A>
34689 and this feature are set,
34690 then when an implicit directory lookup is done from the
34691 composer you will automatically be prompted to add the result of the
34692 directory lookup to your address book.
34693 <P>
34694 <UL>
34695 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34696 </UL><P>
34697 &lt;End of help on this topic&gt;
34698 </BODY>
34699 </HTML>
34700 ===== h_patterns_compat_behavior =====
34701 <HTML>
34702 <HEAD>
34703 <TITLE>Rules Behavior Changes in Pine 4.50</TITLE>
34704 </HEAD>
34705 <BODY>
34706 <H1>Rules Behavior Changes in Pine 4.50</H1>
34707
34708 In Alpine, Rules that contain unrecognized elements
34709 are ignored.
34710 In most cases, the unrecognized elements will be something that was
34711 added as a new Rules feature in a later version of Alpine.
34712 In versions of Pine <EM>prior</EM> to 4.50, Pine did <EM>not</EM>
34713 ignore rules that contained unrecognized elements.
34714 For example, a new element of Rules that was added in Pine 4.50 is
34715 Age interval.
34716 Suppose you add an Indexcolor rule, using version Pine 4.50 or later, that colors
34717 all messages older than a week red.
34718 Now, if you run Pine 4.44 using that same configuration file, it will not
34719 recognize the Age interval and so will just ignore it.
34720 That means that all messages will match that rule so all messages will
34721 be colored red when using Pine version 4.44.
34722
34723 <P>
34724 This behavior was considered a bug so it is fixed in Alpine and Pine 4.50 and later.
34725 However, since the behavior still exists in versions prior to Pine 4.50 and
34726 since Filtering is a potentially destructive operation, another measure
34727 was taken to attempt to avoid unintentional Filtering of messages.
34728 The first time that you run Alpine or a Pine that is version 4.50 or greater,
34729 the rules in your Filters configuration variable (&quot;Patterns-Filters&quot;)
34730 will be copied to a new Filters configuration variable
34731 with a different name (&quot;Patterns-Filters2&quot;).
34732 From then on, Alpine will continue to use the new
34733 variable.
34734 Of course, Pine version 4.44 or lower will continue to use the old
34735 variable.
34736 That means that if you are using Alpine
34737 and also using a version of Pine that is older than 4.50, they will not
34738 share the configuration information about Filters.
34739 If you make a change in one version you won't see it in the other version.
34740
34741 <P>
34742 Since Scoring can be used to trigger Filtering, the same thing has been
34743 done for Score rules.
34744 The old configuration variable name is (&quot;Patterns-Scores&quot;)
34745 and the new name is (&quot;Patterns-Scores2&quot;).
34746 The same is not true of Role, Indexcolor, and Other rules that are
34747 thought to be less harmful when a mistake is made.
34748
34749 <P>
34750 &lt;End of help on this topic&gt;
34751 </BODY>
34752 </HTML>
34753 ======= h_config_filt_opts_sentdate =======
34754 <HTML>
34755 <HEAD>
34756 <TITLE>PATTERN FEATURE: Use-Date-Header-For-Age</TITLE>
34757 </HEAD>
34758 <BODY>
34759 <H1>PATTERN FEATURE: Use-Date-Header-For-Age</H1>
34760
34761 By default, the Age interval of a Pattern uses a message's time of
34762 arrival to compute the age of the message.
34763 If this feature is set, the date in the message's Date header will
34764 be used instead.
34765 <P>
34766 &lt;End of help on this topic&gt;
34767 </BODY>
34768 </HTML>
34769 ======= h_config_filt_opts_notdel =======
34770 <HTML>
34771 <HEAD>
34772 <TITLE>FILTER FEATURE: Move-Only-if-Not-Deleted</TITLE>
34773 </HEAD>
34774 <BODY>
34775 <H1>FILTER FEATURE: Move-Only-if-Not-Deleted</H1>
34776
34777 If this option is set then a message will be moved into the
34778 specified folder only if it is not marked for deletion.
34779 This is useful if you have multiple Alpine sessions running
34780 simultaneously and you don't want messages to be filtered into a
34781 folder more than once.
34782 It is also useful if you want to filter
34783 only the &quot;undeleted&quot; messages in a newsgroup into a folder.
34784 This method is not foolproof.
34785 There may be cases where a message
34786 gets marked deleted and so it is never filtered into the folder.
34787 For example, if you deleted it in another Alpine session or another mail
34788 program that didn't use the filtering rule.
34789 <P>
34790 This option has no effect if the Filter Action is not set to Move.
34791 <P>
34792 &lt;End of help on this topic&gt;
34793 </BODY>
34794 </HTML>
34795 ======= h_config_filt_opts_nonterm =======
34796 <HTML>
34797 <HEAD>
34798 <TITLE>FILTER FEATURE: Dont-Stop-Even-if-Rule-Matches</TITLE>
34799 </HEAD>
34800 <BODY>
34801 <H1>FILTER FEATURE: Dont-Stop-Even-if-Rule-Matches</H1>
34802
34803 If this option is set then this is a non-terminating rule.
34804 Usually, for each message, Alpine searches through the Filter Rules until
34805 a match is found and then it performs the action associated with that rule.
34806 Rules following the match are not considered.
34807 If this option is set then the search for matches will continue at the next
34808 rule.
34809 <P>
34810 If a non-terminating rule matches then the actions associated with
34811 that rule, except for any implied deletion of the message, are performed
34812 before the match for the next rule is checked.
34813 For example, if the non-terminating rule sets the Important status, then that
34814 status will be set when the next rule is considered.
34815 However, if the non-terminating rule Moves the message, the message will
34816 actually be copied instead of copied and deleted so that it is still there
34817 for the next rule.
34818 A moved message is deleted after all the relevant rules have been checked.
34819 The name of the &quot;Move&quot; action is confusing in this case because
34820 a single message can be moved to more than one folder.
34821 It turns the Move into a Copy instead, but it is still followed by a deletion
34822 at the end.
34823 <P>
34824 This option may be useful if you want to have a single message filtered to
34825 two different folders because it matches two different Patterns.
34826 For example, suppose you normally filter messages to a particular mailing
34827 list into one folder, and messages addressed directly to you into a second
34828 folder.
34829 If a message is sent to both you and the list (and you can tell that by
34830 looking at the headers of the message) this option may give you a convenient
34831 way to capture a copy to each folder.
34832 (It may also cause you to capture two copies to each folder,
34833 depending on whether your mail system delivers one or two copies of the
34834 message to you and on how the list works.)
34835 <P>
34836 &lt;End of help on this topic&gt;
34837 </BODY>
34838 </HTML>
34839 ===== h_mainhelp_smime ======
34840 <HTML>
34841 <HEAD>
34842 <TITLE>S/MIME Overview</TITLE>
34843 </HEAD>
34844 <BODY>
34845 <H1>S/MIME Overview</H1>
34846
34847 S/MIME is a standard for the public key encryption and signing of email.
34848 UNIX Alpine contains a basic implementation of S/MIME based on
34849 the <A HREF="http://www.openssl.org/">OpenSSL</A> libraries.
34850 To check if this version of Alpine supports S/MIME look at
34851 <A HREF="X-Alpine-Config:">Supported Options in this Alpine</A> and look
34852 for &quot;S/MIME&quot; under the &quot;Encryption&quot; heading.
34853 <P>
34854 Some limitations:
34855 <UL>
34856    <LI> There is no PC-Alpine implementation.
34857    <LI> There is no provision for checking for CRLs
34858         (Certificate Revocation Lists) in Alpine.
34859    <LI> This built-in S/MIME implementation is not compatible with and does not help with PGP.
34860    <LI> There is no mechanism available for feeding either an entire incoming
34861         or an entire outgoing message to an external
34862         filter and using that external filter to do S/MIME or PGP processing.
34863    <LI> Because the implementation currently uses OpenSSL, there is only a very
34864         limited integration with the Mac OS Keychain (the storing and access of
34865         public certificates).
34866 </UL>
34867 <P>
34868 The S/MIME configuration screen is reached by going to the Main Menu and typing
34869 the &quot;S&nbsp;Setup&quot; command followed by &quot;M&nbsp;S/MIME&quot;.
34870 <P>
34871
34872 <H2>S/MIME BASICS</H2>
34873
34874 In order to digitally sign messages you send you must have a public/private key-pair.
34875 This may be obtained from a public Certificate Authority (CA) such as Thawte, Verisign, Comodo,
34876 or GoDaddy; or from a smaller CA such as a university which provides certificates for its
34877 users or a company which provides certificates for its workers.
34878 These certificates are bound to an email address, so the identity being verified is the
34879 email address not a person's name.
34880 <P>
34881 Mail is signed by using the sender's private key, which only the owner of the private key
34882 has access to.
34883 The signature is verified using the signer's public key, which anyone can
34884 have access to.
34885 With Alpine, the first time you receive a signed message the public key of the
34886 sender will be stored for future use.
34887
34888 <P>
34889 Mail is encrypted using the recipient's public key and decrypted by
34890 the recipient with their private key.
34891
34892 <P>
34893 You need a key of your own in order to sign outgoing messages and to have others
34894 encrypt messages sent to you.
34895 You do not need a key of your own to verify signed messages sent by others or to
34896 encrypt messages sent to others.
34897
34898 <H2>ALPINE S/MIME CERTIFICATE STORAGE</H2>
34899
34900 By default UNIX Alpine stores the certificates it uses in a directory in your
34901 home directory.
34902 The directory name is
34903 <P>
34904 <CENTER><SAMP>.alpine-smime</SAMP></CENTER>
34905 <P>
34906 Within that directory are three subdirectories.
34907 Each of the three subdirectories contains files with PEM-encoded contents,
34908 the default format for OpenSSL.
34909 The &quot;<SAMP>public</SAMP>&quot; directory contains public certificates.
34910 The files within that directory have names that are email addresses with the
34911 suffix &quot;<SAMP>.crt</SAMP>&quot; appended.
34912 An example filename is
34913 <P>
34914 <CENTER><SAMP>user@example.com.crt</SAMP></CENTER>
34915 <P>
34916 The &quot;<SAMP>private</SAMP>&quot; directory contains private keys, probably just one for
34917 your private key.
34918 These are also email addresses but with the suffix &quot;<SAMP>.key</SAMP>&quot; instead.
34919 The third directory is &quot;<SAMP>ca</SAMP>&quot; and it contains certificates for any Certificate
34920 Authorities that you want to trust but that aren't contained in the set of system CAs.
34921 Those files may have arbitrary names as long as they end with the
34922 suffix &quot;<SAMP>.crt</SAMP>&quot;.
34923
34924 <H2>HOW TO SIGN AND ENCRYPT</H2>
34925
34926 If you have a certificate you may sign outgoing messages.
34927 After typing the Ctrl-X command to send a message you will see the prompt
34928 <P>
34929 <CENTER><SAMP>Send message?</SAMP></CENTER>
34930 <P>
34931 Available subcommands include &quot;G&nbsp;Sign&quot; and &quot;E&nbsp;Encrypt&quot;.
34932 Typing the &quot;G&quot; command will change the prompt to
34933 <P>
34934 <CENTER><SAMP>Send message (Signed)?</SAMP></CENTER>
34935 <P>
34936 Typing the &quot;E&quot; command will change the prompt to
34937 <P>
34938 <CENTER><SAMP>Send message (Encrypted)?</SAMP></CENTER>
34939 <P>
34940 You may even type both to get
34941 <P>
34942 <CENTER><SAMP>Send message (Encrypted, Signed)?</SAMP></CENTER>
34943 <P>
34944
34945 <H2>HOW TO READ SIGNED OR ENCRYPTED MESSAGES</H2>
34946
34947 The reading of a signed message should not require any special action on
34948 your part.
34949 There should be an editorial addition at the start of the message which
34950 says either
34951 <P>
34952 <CENTER><SAMP>This message was cryptographically signed.</SAMP></CENTER>
34953 <P>
34954 or
34955 <P>
34956 <CENTER><SAMP>This message was cryptographically signed but the signature could not be verified.</SAMP></CENTER>
34957 <P>
34958 If an encrypted message is sent to you the encrypted text will not
34959 be shown.
34960 You will have to type the &quot;Ctrl-D&nbsp;Decrypt&quot; command (from the screen where
34961 you are viewing the message) and supply your passphrase when asked.
34962 <P>
34963 For a signed or encrypted message there is also a &quot;Ctrl-E&nbsp;Security&quot; command
34964 which gives you some information about the certificate used to sign or encrypt the message.
34965
34966 <H2>MISCELLANEOUS</H2>
34967
34968 If you have access to a private certificate in the PKCS12 format, which
34969 would sometimes be in a file with a &quot;.p12&quot; extension, then you can
34970 use the following commands to generate private keys, public and certificate
34971 authorities certificates. In the examples below, we assume that the
34972 certificate in the p12 format is called &quot;certificate.p12&quot;, and
34973 that your email address is &quot;your@address.com&quot;.
34974
34975 <P>
34976 In order to create a private key use the command
34977 <P>
34978 <CENTER><SAMP>openssl pkcs12 -in certificate.p12 -out your@address.com.key</SAMP></CENTER>
34979 <P>
34980 In order to create a public certificate use the command
34981 <P>
34982 <CENTER><SAMP>
34983 openssl pkcs12 -in certificate.p12 -clcerts -nokeys -out your@address.com.crt
34984 </SAMP></CENTER>
34985 <P>
34986 In order to create a certificate authority certificate use the command
34987 <P>
34988 <CENTER><SAMP>
34989 openssl pkcs12 -in certificate.p12 -cacerts -nokeys -out certificate-ca.crt
34990 </SAMP></CENTER>
34991
34992 <P> If the previous command produces an empty file, it means that the
34993 certificate authority was not included in the .p12 file, so you will have
34994 to get it from some other sources. You will need these certificates, so
34995 that you can validate correctly signatures.
34996
34997 <P>
34998 After you have exported these certificates and keys, you can  use the import
34999 command in Alpine, from the S/MIME configuration screen,
35000 to import these certificates into Alpine. They will be available for use
35001 as soon as you import them.
35002 <P>
35003 &lt;End of help on this topic&gt;
35004 </BODY>
35005 </HTML>
35006 ====== h_config_smime_pubcertdir =====
35007 <HTML>
35008 <HEAD>
35009 <TITLE>S/MIME OPTION: <!--#echo var="VAR_smime-public-cert-directory"--></TITLE>
35010 </HEAD>
35011 <BODY>
35012 <H1>S/MIME OPTION: <!--#echo var="VAR_smime-public-cert-directory"--></H1>
35013
35014 UNIX Alpine only.
35015 <P>
35016 If the option
35017 <A HREF="h_config_smime_pubcertcon"><!--#echo var="VAR_smime-public-cert-container"--></A>
35018 is set then this option will have no effect.
35019 <P>
35020 Normally, Public Certificates for use with S/MIME will be stored in the directory
35021 which is the value of this option.
35022 Those certificates will be stored in PEM format, one certificate per file.
35023 The name of the file for the certificate corresponding to
35024 <P>
35025 <CENTER><SAMP>emailaddress</SAMP></CENTER>
35026 <P>
35027 should be
35028 <P>
35029 <CENTER><SAMP>emailaddress.crt</SAMP></CENTER>
35030 <P>
35031 For example, a file for user@example.com would be in the file
35032 <P>
35033 <CENTER><SAMP>user@example.com.crt</SAMP></CENTER>
35034 <P>
35035 in this directory.
35036 <P>
35037 Use the Setup/SMIME screen to modify this variable.
35038 <P>
35039 Typically, the public certificates that you have will come from S/MIME signed
35040 messages that are sent to you.
35041 Alpine will extract the public certificate from the signed message and store
35042 it in the certificates directory.
35043 These PEM format public certificates look something like:
35044 <PRE>
35045 -----BEGIN CERTIFICATE-----
35046 MIIFvTCCBKWgAwIBAgIQD4fYFHVI8T20yN4nus097DANBgkqhkiG9w0BAQUFADCB
35047 rjELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAlVUMRcwFQYDVQQHEw5TYWx0IExha2Ug
35048 Q2l0eTEeMBwGA1UEChMVVGhlIFVTRVJUUlVTVCBOZXR3b3JrMSEwHwYDVQQLExho
35049 ...
35050 2b9KGqDyMWW/rjNnmpjzjT2ObGM7lRA8lke4FLOLajhrz4ogO3b4DFfAAM1VSZH8
35051 D6sOwOLJZkLY8FRsfk63K+2EMzA2+qAzMKupgeTLqXIf
35052 -----END CERTIFICATE-----
35053 </PRE>
35054 <P>
35055 <UL>
35056 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35057 </UL><P>
35058 <P>
35059 <UL>
35060 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35061 </UL><P>
35062 &lt;End of help on this topic&gt;
35063 </BODY>
35064 </HTML>
35065 ====== h_config_smime_pubcertcon =====
35066 <HTML>
35067 <HEAD>
35068 <TITLE>OPTION: <!--#echo var="VAR_smime-public-cert-container"--></TITLE>
35069 </HEAD>
35070 <BODY>
35071 <H1>OPTION: <!--#echo var="VAR_smime-public-cert-container"--></H1>
35072
35073 UNIX Alpine only.
35074 <P>
35075 If this option is set it will be used instead of
35076 <A HREF="h_config_smime_pubcertdir"><!--#echo var="VAR_smime-public-cert-directory"--></A>.
35077 <P>
35078 This option gives you a way to store certificates remotely on an IMAP server
35079 instead of storing the certificates one per file locally.
35080 In order to do that you just give this option a remote folder name for a folder
35081 which does not yet exist.
35082 The name is similar to the name you might use for a remote configuration file.
35083 A remote folder name might look something like:
35084 <P>
35085 <CENTER><SAMP>{myimaphost.myschool.k12.wa.us}mail/publiccerts</SAMP></CENTER>
35086 <P>
35087 See
35088 <A HREF="h_valid_folder_names">Valid Folder Names</A> for more information
35089 about the syntax of folder names.
35090 <P>
35091 Use the Setup/SMIME screen to modify this variable.
35092 <P>
35093 <UL>
35094 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35095 </UL><P>
35096 <P>
35097 <UL>
35098 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35099 </UL><P>
35100 &lt;End of help on this topic&gt;
35101 </BODY>
35102 </HTML>
35103 ====== h_config_smime_privkeydir =====
35104 <HTML>
35105 <HEAD>
35106 <TITLE>OPTION: <!--#echo var="VAR_smime-private-key-directory"--></TITLE>
35107 </HEAD>
35108 <BODY>
35109 <H1>OPTION: <!--#echo var="VAR_smime-private-key-directory"--></H1>
35110
35111 UNIX Alpine only.
35112 <P>
35113 In order to sign outgoing S/MIME messages you will need a
35114 personal digital ID certificate.
35115 You will usually get such a certificate from a certificate authority such as
35116 Thawte or CAcert.
35117 (In order to encrypt outgoing messages you don't need a personal digital ID, you
35118 need the public certificate of the recipient instead.)
35119 If the option
35120 <A HREF="h_config_smime_privkeycon"><!--#echo var="VAR_smime-private-key-container"--></A>
35121 is set then this option will have no effect.
35122 <P>
35123 Normally, Private Keys for use with S/MIME will be stored in the directory
35124 which is the value of this option.
35125 Those certificates will be stored in PEM format, one certificate per file.
35126 The name of the file for the certificate corresponding to your
35127 <P>
35128 <CENTER><SAMP>emailaddress</SAMP></CENTER>
35129 <P>
35130 should be
35131 <P>
35132 <CENTER><SAMP>emailaddress.key</SAMP></CENTER>
35133 <P>
35134 For example, if your address is user@example.com the name of the file would be
35135 <P>
35136 <CENTER><SAMP>user@example.com.key</SAMP></CENTER>
35137 <P>
35138 in this directory.
35139 <P>
35140 Use the Setup/SMIME screen to modify this variable.
35141 <P>
35142 Typically, the private key that you have will come from a Certificate
35143 Authority.
35144 The private key should be stored in a PEM format file that
35145 looks something like:
35146 <PRE>
35147 -----BEGIN RSA PRIVATE KEY-----
35148 Proc-Type: 4,ENCRYPTED
35149 DEK-Info: DES-EDE3-CBC,2CBD328FD84CF5C6
35150
35151 YBEXYLgLU9NJoc1V+vJ6UvcF08RX54S6jXsmgL0b5HGkudG6fhnmHkH7+UCvM5NI
35152 SXO/F8iuZDfs1VGG0NyitkFZ0Zn2vfaGovBvm15gx24b2xnZDLRB7/bNZkurnK5k
35153 VjAjZ2xXn2hFp2GJwqRdmxYNqsKGu52B99oti5HUWuZ2GFRaWjn5hYOqeApZE2uA
35154 ...
35155 oSRqfI51UdSRt0tmGhHeTvybUVrHm9eKft8TTGf+qSBqzSc55CsmoVbRzw4Nfhix
35156 m+4TJybNGNfAgOctSkEyY/OCb49fRRQTCBZVIhzLGGmpYmkO55HbIA==
35157 -----END RSA PRIVATE KEY-----
35158 </PRE>
35159 <P>
35160 <UL>
35161 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35162 </UL><P>
35163 <P>
35164 <UL>
35165 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35166 </UL><P>
35167 &lt;End of help on this topic&gt;
35168 </BODY>
35169 </HTML>
35170 ====== h_config_smime_privkeycon =====
35171 <HTML>
35172 <HEAD>
35173 <TITLE>OPTION: <!--#echo var="VAR_smime-private-key-container"--></TITLE>
35174 </HEAD>
35175 <BODY>
35176 <H1>OPTION: <!--#echo var="VAR_smime-private-key-container"--></H1>
35177
35178 UNIX Alpine only.
35179 <P>
35180 If this option is set it will be used instead of
35181 <A HREF="h_config_smime_privkeydir"><!--#echo var="VAR_smime-private-key-directory"--></A>.
35182 <P>
35183 This option gives you a way to store keys remotely on an IMAP server
35184 instead of storing the keys one per file locally.
35185 In order to do that you just give this option a remote folder name for a folder
35186 which does not yet exist.
35187 The name is similar to the name you might use for a remote configuration file.
35188 A remote folder name might look something like:
35189 <P>
35190 <CENTER><SAMP>{myimaphost.myschool.k12.wa.us}mail/privatekeys</SAMP></CENTER>
35191 <P>
35192 See
35193 <A HREF="h_valid_folder_names">Valid Folder Names</A> for more information
35194 about the syntax of folder names.
35195 <P>
35196 Use the Setup/SMIME screen to modify this variable.
35197 <P>
35198 <UL>
35199 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35200 </UL><P>
35201 <P>
35202 <UL>
35203 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35204 </UL><P>
35205 &lt;End of help on this topic&gt;
35206 </BODY>
35207 </HTML>
35208 ====== h_config_smime_cacertdir =====
35209 <HTML>
35210 <HEAD>
35211 <TITLE>S/MIME OPTION: <!--#echo var="VAR_smime-cacert-directory"--></TITLE>
35212 </HEAD>
35213 <BODY>
35214 <H1>S/MIME OPTION: <!--#echo var="VAR_smime-cacert-directory"--></H1>
35215
35216 UNIX Alpine only.
35217 <P>
35218 If the option
35219 <A HREF="h_config_smime_cacertcon"><!--#echo var="VAR_smime-cacert-container"--></A>
35220 is set then this option will have no effect.
35221 <P>
35222 CACert is a shorthand name for certification authority certificate.
35223 Normally Alpine will use the CACerts that are located in the standard system
35224 location for CACerts.
35225 It may be the case that one of your correspondents has a Digital ID which has
35226 been signed by a certificate authority that is not in the regular set of system certificate
35227 authorities.
35228 You may supplement the system list by adding further certificates of your own.
35229 These should  be stored in the directory
35230 which is the value of this option.
35231 The certificates will be stored in PEM format, one certificate per file.
35232 The names of the files can be anything ending in &quot;.crt&quot;.
35233 <P>
35234 Use the Setup/SMIME screen to modify this variable.
35235 <P>
35236 These PEM format CA certificates look very similar to your public
35237 certificates for particular email addresses
35238 (<A HREF="h_config_smime_pubcertdir"><!--#echo var="VAR_smime-public-cert-directory"--></A>).
35239 <P>
35240 <UL>
35241 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35242 </UL><P>
35243 <P>
35244 <UL>
35245 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35246 </UL><P>
35247 &lt;End of help on this topic&gt;
35248 </BODY>
35249 </HTML>
35250 ====== h_config_smime_cacertcon =====
35251 <HTML>
35252 <HEAD>
35253 <TITLE>S/MIME OPTION: <!--#echo var="VAR_smime-cacert-container"--></TITLE>
35254 </HEAD>
35255 <BODY>
35256 <H1>S/MIME OPTION: <!--#echo var="VAR_smime-cacert-container"--></H1>
35257
35258 UNIX Alpine only.
35259 <P>
35260 If this option is set it will be used instead of
35261 <A HREF="h_config_smime_cacertdir"><!--#echo var="VAR_smime-cacert-directory"--></A>.
35262 <P>
35263 This option gives you a way to store certificates remotely on an IMAP server
35264 instead of storing the certificates one per file locally.
35265 In order to do that you just give this option a remote folder name for a folder
35266 which does not yet exist.
35267 The name is similar to the name you might use for a remote configuration file.
35268 A remote folder name might look something like:
35269 <P>
35270 <CENTER><SAMP>{myimaphost.myschool.k12.wa.us}mail/cacerts</SAMP></CENTER>
35271 <P>
35272 See
35273 <A HREF="h_valid_folder_names">Valid Folder Names</A> for more information
35274 about the syntax of folder names.
35275 <P>
35276 Use the Setup/SMIME screen to modify this variable.
35277 <P>
35278 <UL>
35279 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35280 </UL><P>
35281 <P>
35282 <UL>
35283 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35284 </UL><P>
35285 &lt;End of help on this topic&gt;
35286 </BODY>
35287 </HTML>
35288 ========== h_config_smime_sign_by_default ==========
35289 <HTML>
35290 <HEAD>
35291 <TITLE>S/MIME FEATURE: <!--#echo var="FEAT_smime-sign-by-default"--></TITLE>
35292 </HEAD>
35293 <BODY>
35294 <H1>S/MIME FEATURE: <!--#echo var="FEAT_smime-sign-by-default"--></H1>
35295
35296 UNIX Alpine only.
35297 <P>
35298 This feature only has an effect if your version of Alpine includes
35299 support for S/MIME.
35300 It affects Alpine's behavior when you send a message.
35301 If this option is set, the &quot;Sign&quot; option will default to ON when sending messages.
35302 <P>
35303 Only the default value is affected.
35304 In any case, you may still toggle the Signing option on or off before sending
35305 with the &quot;G Sign&quot; command (provided you have a personal digital ID
35306 certificate).
35307 <P>
35308 <UL>
35309 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35310 </UL><P>
35311 <P>
35312
35313 <UL>
35314 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35315 </UL><P>
35316 &lt;End of help on this topic&gt;
35317 </BODY>
35318 </HTML>
35319 ========== h_config_smime_use_cert_store ==========
35320 <HTML>
35321 <HEAD>
35322 <TITLE>S/MIME FEATURE: <!--#echo var="FEAT_smime-use-store-only"--></TITLE>
35323 </HEAD>
35324 <BODY>
35325 <H1>S/MIME FEATURE: <!--#echo var="FEAT_smime-use-store-only"--></H1>
35326
35327 UNIX Alpine only.
35328 <P>
35329 This feature only has an effect if your version of Alpine includes
35330 support for S/MIME.
35331 It affects Alpine's behavior when you validate a message, and should
35332 not be disabled, unless you are performing a test.
35333 <P>
35334 There are two important aspects of validation: validation of the message
35335 (that is, the message was not modified after it was sent)
35336 as well as validation of the identity of the sender. This option has to
35337 do with the latter.
35338 <P>
35339 In order to validate that the message came from the sender in the message
35340 and not an impersonator, Alpine can
35341 either use the certificates that come in the message, or the ones that
35342 you have personally stored. If this feature is enabled (the default) then
35343 Alpine will use certificates that you have already saved in your store
35344 and not those that come in the message to validate the sender of the
35345 message. In particular, the first time that you receive a signed message
35346 from a sender, and their certificate does not validate against your
35347 store, then you will be asked if you wish to save such certificate. If
35348 you do not wish to save the certificate, then Alpine will fail to validate
35349 the signature of the message. Otherwise, Alpine will proceed to validate
35350 the signature of the message. This behavior helps you prevent against impersonation, because
35351 it is assumed that you trust the certificates that you have saved, and
35352 might not trust those that came with the message that you are validating.
35353 <P>
35354 <UL>
35355 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35356 </UL><P>
35357 <P>
35358
35359 <UL>
35360 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35361 </UL><P>
35362 &lt;End of help on this topic&gt;
35363 </BODY>
35364 </HTML>
35365 ========== h_config_smime_pubcerts_in_keychain ==========
35366 <HTML>
35367 <HEAD>
35368 <TITLE>S/MIME FEATURE: <!--#echo var="FEAT_publiccerts-in-keychain"--></TITLE>
35369 </HEAD>
35370 <BODY>
35371 <H1>S/MIME FEATURE: <!--#echo var="FEAT_publiccerts-in-keychain"--></H1>
35372
35373 UNIX Alpine only.
35374 <P>
35375 If this feature is set the Mac OS X default keychain will be used as the place
35376 to store public certificates instead of a
35377 <A HREF="h_config_smime_pubcertdir"><!--#echo var="VAR_smime-public-cert-directory"--></A>
35378 or a
35379 <A HREF="h_config_smime_pubcertcon"><!--#echo var="VAR_smime-public-cert-container"--></A>.
35380 <P>
35381 <UL>
35382 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35383 </UL><P>
35384 <P>
35385 <UL>
35386 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35387 </UL><P>
35388 &lt;End of help on this topic&gt;
35389 </BODY>
35390 </HTML>
35391 ========== h_config_smime_dont_do_smime ==========
35392 <HTML>
35393 <HEAD>
35394 <TITLE>S/MIME FEATURE: <!--#echo var="FEAT_smime-dont-do-smime"--></TITLE>
35395 </HEAD>
35396 <BODY>
35397 <H1>S/MIME FEATURE: <!--#echo var="FEAT_smime-dont-do-smime"--></H1>
35398
35399 UNIX Alpine only.
35400 <P>
35401 Setting this feature turns off all of Alpine's S/MIME support.
35402 You might want to set this if you are having trouble due to the S/MIME support.
35403 <P>
35404 <UL>
35405 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35406 </UL><P>
35407 <P>
35408
35409 <UL>
35410 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35411 </UL><P>
35412 &lt;End of help on this topic&gt;
35413 </BODY>
35414 </HTML>
35415 ========== h_config_smime_encrypt_by_default ==========
35416 <HTML>
35417 <HEAD>
35418 <TITLE>S/MIME FEATURE: <!--#echo var="FEAT_smime-encrypt-by-default"--></TITLE>
35419 </HEAD>
35420 <BODY>
35421 <H1>S/MIME FEATURE: <!--#echo var="FEAT_smime-encrypt-by-default"--></H1>
35422
35423 UNIX Alpine only.
35424 <P>
35425 This feature only has an effect if your version of Alpine includes
35426 support for S/MIME.
35427 It affects Alpine's behavior when you send a message.
35428 If this option is set, the &quot;Encrypt&quot; option will default to ON when sending messages.
35429 <P>
35430 Only the default value is affected.
35431 In any case, you may still toggle the Encrypt option on or off before sending
35432 with the &quot;E Encrypt&quot; command (provided you have a the public digital ID
35433 for the recipient).
35434 <P>
35435 <UL>
35436 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35437 </UL><P>
35438 <P>
35439
35440 <UL>
35441 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35442 </UL><P>
35443 &lt;End of help on this topic&gt;
35444 </BODY>
35445 </HTML>
35446 ========== h_config_smime_remember_passphrase ==========
35447 <HTML>
35448 <HEAD>
35449 <TITLE>S/MIME FEATURE: <!--#echo var="FEAT_smime-remember-passphrase"--></TITLE>
35450 </HEAD>
35451 <BODY>
35452 <H1>S/MIME FEATURE: <!--#echo var="FEAT_smime-remember-passphrase"--></H1>
35453
35454 UNIX Alpine only.
35455 <P>
35456 This feature only has an effect if your version of Alpine includes
35457 support for S/MIME.
35458 If this option is set, you will only have to enter your passphrase for your private key
35459 once during an Alpine session.
35460 <P>
35461 <UL>
35462 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35463 </UL><P>
35464 <P>
35465
35466 <UL>
35467 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35468 </UL><P>
35469 &lt;End of help on this topic&gt;
35470 </BODY>
35471 </HTML>
35472 ====== h_config_smime_transfer_pub_to_con =====
35473 <HTML>
35474 <HEAD>
35475 <TITLE>S/MIME: Transfer Public Certs to Container</TITLE>
35476 </HEAD>
35477 <BODY>
35478 <H1>S/MIME: Transfer Public Certs to Container</H1>
35479
35480 UNIX Alpine only.
35481 <P>
35482 The Transfer command will copy the public certificates in your configured
35483 <A HREF="h_config_smime_pubcertdir"><!--#echo var="VAR_smime-public-cert-directory"--></A>
35484 to the container in your configured
35485 <A HREF="h_config_smime_pubcertcon"><!--#echo var="VAR_smime-public-cert-container"--></A>.
35486 This might be useful if you decide to switch from using a cert directory to a cert
35487 container.
35488 <P>
35489 Warning: Any previous contents in the container will be lost.
35490 <P>
35491 <UL>
35492 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35493 </UL><P>
35494 <P>
35495 <UL>
35496 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35497 </UL><P>
35498 &lt;End of help on this topic&gt;
35499 </BODY>
35500 </HTML>
35501 ====== h_config_smime_transfer_pub_to_dir =====
35502 <HTML>
35503 <HEAD>
35504 <TITLE>S/MIME: Transfer Public Certs to Directory</TITLE>
35505 </HEAD>
35506 <BODY>
35507 <H1>S/MIME: Transfer Public Certs to Directory</H1>
35508
35509 UNIX Alpine only.
35510 <P>
35511 The Transfer command will copy the public certificates in your configured
35512 <A HREF="h_config_smime_pubcertcon"><!--#echo var="VAR_smime-public-cert-container"--></A>
35513 to the directory in your configured
35514 <A HREF="h_config_smime_pubcertdir"><!--#echo var="VAR_smime-public-cert-directory"--></A>.
35515 This might be useful if you decide to switch from using a cert container to a cert
35516 directory.
35517 <P>
35518 <UL>
35519 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35520 </UL><P>
35521 <P>
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_priv_to_con =====
35529 <HTML>
35530 <HEAD>
35531 <TITLE>S/MIME: Transfer Private Keys to Container</TITLE>
35532 </HEAD>
35533 <BODY>
35534 <H1>S/MIME: Transfer Private Keys to Container</H1>
35535
35536 UNIX Alpine only.
35537 <P>
35538 The Transfer command will copy the private keys in your configured
35539 <A HREF="h_config_smime_privkeydir"><!--#echo var="VAR_smime-private-key-directory"--></A>.
35540 to the container in your configured
35541 <A HREF="h_config_smime_privkeydir"><!--#echo var="VAR_smime-private-key-container"--></A>.
35542 This might be useful if you decide to switch from using a key directory to a key
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_priv_to_dir =====
35558 <HTML>
35559 <HEAD>
35560 <TITLE>S/MIME: Transfer Private Keys to Directory</TITLE>
35561 </HEAD>
35562 <BODY>
35563 <H1>S/MIME: Transfer Private Keys to Directory</H1>
35564
35565 UNIX Alpine only.
35566 <P>
35567 The Transfer command will copy the private keys in your configured
35568 <A HREF="h_config_smime_privkeydir"><!--#echo var="VAR_smime-private-key-container"--></A>.
35569 to the directory in your configured
35570 <A HREF="h_config_smime_privkeydir"><!--#echo var="VAR_smime-private-key-directory"--></A>.
35571 This might be useful if you decide to switch from using a key container to a key
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_cacert_to_con =====
35585 <HTML>
35586 <HEAD>
35587 <TITLE>S/MIME: Transfer CA Certs to Container</TITLE>
35588 </HEAD>
35589 <BODY>
35590 <H1>S/MIME: Transfer CA Certs to Container</H1>
35591
35592 UNIX Alpine only.
35593 <P>
35594 The Transfer command will copy the CA certificates in your configured
35595 <A HREF="h_config_smime_cacertdir"><!--#echo var="VAR_smime-cacert-directory"--></A>
35596 to the container in your configured
35597 <A HREF="h_config_smime_cacertcon"><!--#echo var="VAR_smime-cacert-container"--></A>.
35598 This might be useful if you decide to switch from using a CA cert directory to a CA cert
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_cacert_to_dir =====
35614 <HTML>
35615 <HEAD>
35616 <TITLE>S/MIME: Transfer CA Certs to Directory</TITLE>
35617 </HEAD>
35618 <BODY>
35619 <H1>S/MIME: Transfer CA Certs to Directory</H1>
35620
35621 UNIX Alpine only.
35622 <P>
35623 The Transfer command will copy the CA certificates in your configured
35624 <A HREF="h_config_smime_cacertcon"><!--#echo var="VAR_smime-cacert-container"--></A>.
35625 to the directory in your configured
35626 <A HREF="h_config_smime_cacertdir"><!--#echo var="VAR_smime-cacert-directory"--></A>.
35627 This might be useful if you decide to switch from using a CA cert container to a CA cert
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_pubcon_to_key =====
35641 <HTML>
35642 <HEAD>
35643 <TITLE>S/MIME: Transfer Public Certs to Keychain</TITLE>
35644 </HEAD>
35645 <BODY>
35646 <H1>S/MIME: Transfer Public Certs to Keychain</H1>
35647
35648 Mac OS X Alpine only.
35649 <P>
35650 The Transfer command will copy the public certificates in your configured
35651 <A HREF="h_config_smime_pubcertcon"><!--#echo var="VAR_smime-public-cert-container"--></A>
35652 to your default Mac OS X Keychain.
35653 This might be useful if you decide to switch from using a cert container to using
35654 the Keychain to store your public certs, which you may do by using the
35655 feature
35656 <A HREF="h_config_smime_pubcerts_in_keychain">S/MIME FEATURE: <!--#echo var="FEAT_publiccerts-in-keychain"--></A>.
35657 <P>
35658 <UL>
35659 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35660 </UL><P>
35661 <P>
35662 <UL>
35663 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35664 </UL><P>
35665 &lt;End of help on this topic&gt;
35666 </BODY>
35667 </HTML>
35668 ====== h_config_smime_transfer_pubkey_to_con =====
35669 <HTML>
35670 <HEAD>
35671 <TITLE>S/MIME: Transfer Public Certs to Keychain</TITLE>
35672 </HEAD>
35673 <BODY>
35674 <H1>S/MIME: Transfer Public Certs to Keychain</H1>
35675
35676 UNIX Alpine only.
35677 <P>
35678 The Transfer command will copy the public certificates in your configured
35679 <A HREF="h_config_smime_pubcertcon"><!--#echo var="VAR_smime-public-cert-container"--></A>
35680 to your default Mac OS X Keychain.
35681 This might be useful if you decide to switch from using a cert container to using
35682 the Keychain to store your public certs.
35683 <P>
35684 <UL>
35685 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35686 </UL><P>
35687 <P>
35688 <UL>
35689 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35690 </UL><P>
35691 &lt;End of help on this topic&gt;
35692 </BODY>
35693 </HTML>
35694 ====== h_config_smime_public_certificates =====
35695 <HTML>
35696 <HEAD>
35697 <TITLE>S/MIME: Manage Public Certificates</TITLE>
35698 </HEAD>
35699 <BODY>
35700 <H1>S/MIME: Manage Public Certificates</H1>
35701
35702 UNIX Alpine only.
35703 <P>
35704 This menu item allows you to manage your public certificates, this
35705 may include your own public certificate, but it normally includes
35706 certificates of people you correspond with. These certificates are
35707 saved by Alpine automatically when they are found in signed messages
35708 that you receive. This interface allows you to manage them, by
35709 giving you the option to delete them, or trust them (in the case
35710 of self-signed certificates).
35711
35712 <P>
35713 Please note that Alpine will not validate a message that was sent to you
35714 using a self-signed certificate, unless you decide to trust that certificate.
35715 Internally, a certificate is trusted by copying it to the
35716 <A HREF="h_config_smime_certificate_authorities">Certificate Authorities</A>
35717 collection. If you decide that you want to stop trusting a self-signed
35718 certificate, you must delete such certificate from such collection.
35719 <P>
35720 The <B>I</B> Import command available in this screen allows you to
35721 import a command to this collection.
35722 <P>
35723 <UL>
35724 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35725 </UL><P>
35726 <P>
35727 <UL>
35728 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35729 </UL><P>
35730 &lt;End of help on this topic&gt;
35731 </BODY>
35732 </HTML>
35733 ====== h_config_smime_private_keys =====
35734 <HTML>
35735 <HEAD>
35736 <TITLE>S/MIME: Manage Private Keys</TITLE>
35737 </HEAD>
35738 <BODY>
35739 <H1>S/MIME: Manage Private Keys</H1>
35740
35741 UNIX Alpine only.
35742 <P>
35743 This option allows you to manage your private key. Normally a person has only
35744 one key, in the same way that a person only has one valid passport, or ID card,
35745 at any given time. This option allows you to manage private keys. You can
35746 delete them or import them. Additionally, you can view information
35747 about your public certificate, such as the issuer and the dates of validity
35748 of such certificate, among others.
35749
35750 <P>
35751 If you have more than one e-mail address for which you want to use the
35752 same private key, you must add all those addresses to the private key at
35753 the moment that the key is generated. When you receive a signed message using
35754 a key generated for several e-mail addresses, Alpine will save a
35755 certificate for each e-mail address included in such certificate.
35756 <P>
35757 The <B>I</B> Import command available in this screen allows you to
35758 import a command to this collection.
35759 <P>
35760 <UL>
35761 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35762 </UL><P>
35763 <P>
35764 <UL>
35765 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35766 </UL><P>
35767 &lt;End of help on this topic&gt;
35768 </BODY>
35769 </HTML>
35770 ====== h_config_smime_certificate_authorities =====
35771 <HTML>
35772 <HEAD>
35773 <TITLE>S/MIME: Manage Certificate Authorities</TITLE>
35774 </HEAD>
35775 <BODY>
35776 <H1>S/MIME: Manage Certificate Authorities</H1>
35777
35778 UNIX Alpine only.
35779 <P>
35780 This collection contains certificates that are needed to validate the
35781 certificate of another person, and therefore contains certificates that
35782 you trust. Typically a certificate is signed by another entity, called a
35783 certificate authority. This option allows you to manage which certificates
35784 you trust, allowing you to import them and to delete them or view information
35785 about each certificate, such as the issuer and the dates of validity
35786 of such certificate.
35787 <P>
35788 The <B>I</B> Import command available in this screen allows you to
35789 import a command to this collection.
35790 <P>
35791 <UL>
35792 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35793 </UL><P>
35794 <P>
35795 <UL>
35796 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35797 </UL><P>
35798 &lt;End of help on this topic&gt;
35799 </BODY>
35800 </HTML>
35801 ====== h_config_smime_password_file_certificates =====
35802 <HTML>
35803 <HEAD>
35804 <TITLE>S/MIME: Manage Password File Certificates</TITLE>
35805 </HEAD>
35806 <BODY>
35807 <H1>S/MIME: Manage Password File Certificates</H1>
35808
35809 UNIX Alpine only.
35810 <P>
35811 This option allows you to manage the certificates that are used to
35812 encrypt and decrypt your password file. This is useful in case you
35813 want to change the certificates used to encrypt your password file.
35814 <P>
35815 In order to avoid unauthorized use of this option, you are asked to
35816 enter the password of the current private key used to encrypt your
35817 password file.
35818 <P>
35819 Once you have entered your password for the current key, you enter a
35820 screen where you can import your new key, and see the information on your
35821 current key.
35822 <P>
35823 To import a new key press &quot;RETURN&quot; and enter the location of
35824 the new key. You will be asked to enter the password of the new key. If
35825 this part of the process is successful, Alpine will search for the
35826 certificate that matches that key. If your key is named
35827 &quot;your_email@address.com.key&quot;, then Alpine will look for your
35828 certificate in the same directory in the file named
35829 &quot;your_email@address.com.crt&quot;, otherwise it will look for it
35830 as part of your key (that is, it will look to see if your certificate
35831 is in the file &quot;your_email@address.com.key&quot;), if all of this
35832 fails, Alpine will ask you to enter the location of the certificate
35833 that matches the key you unlocked. If a certificate is found, it will be
35834 used, and in this case, the password file will be read, decrypted with the
35835 old key and encrypted with the new key. Once this is done, the new key and
35836 certificates are saved, and the old keys are permanently deleted.
35837 <P>
35838 Alpine does not create a backup of your password file, or your old keys
35839 that will be replaced. If you need to keep old copies, you will have to do
35840 this operation outside Alpine.
35841 <UL>
35842 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35843 </UL><P>
35844 <P>
35845 <UL>
35846 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35847 </UL><P>
35848 &lt;End of help on this topic&gt;
35849 </BODY>
35850 </HTML>
35851 ====== h_certificate_information =====
35852 <HTML>
35853 <HEAD>
35854 <TITLE>S/MIME: Certificate Information Screen</TITLE>
35855 </HEAD>
35856 <BODY>
35857 <H1>S/MIME: Certificate Information Screen</H1>
35858
35859 UNIX Alpine only.
35860 <P>
35861 The CERTIFICATE INFORMATION screen shows you information contained in a certificate
35862 such as its owner, e-mail address, issuer, and interval of validity,
35863 among others.
35864 <P>
35865 In the case of public certificates, this screen shows you if there was a
35866 failure when attempting to validate such message. If the certificate is
35867 self-signed, then the <B>T</B> Trust command will be available, which
35868 you can use to trust such certificate and make Alpine not fail validating
35869 signatures signed with such certificate.
35870 <P>
35871 You can also mark a certificate deleted, with the <B>D</B> command, or
35872 remove the deleted mark with the <B>U</B> undelete command.
35873 <P>
35874 In the case of your private key, Alpine shows you the information
35875 from your public key. Additionally, Alpine allows you to see public
35876 and private information about your key, with the <B>B</B> and
35877 <B>R</B> commands respectively.
35878 <UL>
35879 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35880 </UL><P>
35881 <P>
35882 <UL>
35883 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35884 </UL><P>
35885 &lt;End of help on this topic&gt;
35886 </BODY>
35887 </HTML>
35888 ====== h_config_smime_manage_public_menu =====
35889 <HTML>
35890 <HEAD>
35891 <TITLE>S/MIME: Menu of Commands to Manage Public Certificates</TITLE>
35892 </HEAD>
35893 <BODY>
35894 <H1>S/MIME: Commands that Manage Public Certificates</H1>
35895
35896 UNIX Alpine only.
35897 <P>
35898 This screen allows you to manage your public certificates.
35899 <P>
35900 The format of this screen is as follows. There are five fields: The
35901 leftmost field is normally empty, but it could contain the letter
35902 &quot;D&quot; to indicate that that certificate has been marked for
35903 deletion. The next field is the e-mail address of the owner of the
35904 certificate, shown in its entirety. The third and fourth field are the
35905 first and last day validity for that certificate, respectively. The date
35906 is displayed in the user's locale unless the option
35907 <A HREF="h_config_disable_index_locale_dates"><!--#echo var="FEAT_disable-index-locale-dates"--></A>
35908 is set. In this case, the month, day and year are represented by two
35909 digits, and the format used is mm/dd/yy. Finally, the fifth
35910 field is what can be displayed of the MD5 hash of the certificate. You can
35911 use any of the last three fields to distinguish between two certificates
35912 for the same owner.
35913 <P>
35914 Available commands in this screen and a short description of what they
35915 do follows.
35916 <UL>
35917 <LI> <B>I</B> Imports a public certificate to this collection.
35918 <LI> <B>V</B> View information about a certificate such as the name of the person the
35919 certificate was issued to, its dates of validity, and validity status.
35920 <LI> <B>D</B> Marks a certificate deleted.
35921 <LI> <B>U</B> Removes the deletion mark on a certificate.
35922 <LI> <B>X</B> Removes all certificates marked deleted permanently (cannot be undone).
35923 <LI> <B>T</B> This command is only available for self-signed certificates, and allows you to
35924 trust a certificate by copying it to the collection of trusted certificates.
35925 </UL>
35926 <P>
35927 All commands provide feedback to let you know about their success or failure.
35928 <P>
35929 <UL>
35930 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35931 </UL><P>
35932 <P>
35933 <UL>
35934 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35935 </UL><P>
35936 &lt;End of help on this topic&gt;
35937 </BODY>
35938 </HTML>
35939 ====== h_config_smime_manage_private_menu =====
35940 <HTML>
35941 <HEAD>
35942 <TITLE>S/MIME: Menu of Commands to Manage Private Keys</TITLE>
35943 </HEAD>
35944 <BODY>
35945 <H1>S/MIME: Commands that Manage Private Keys</H1>
35946
35947 UNIX Alpine only.
35948 <P>
35949 This screen allows you to manage your private key.
35950 <P>
35951 The format of this screen is as follows. There are five fields: The
35952 leftmost field is normally empty, but it could contain the letter
35953 &quot;D&quot; to indicate that that certificate has been marked for
35954 deletion. The next field is the e-mail address of the owner of the
35955 certificate, shown in its entirety. The third field is the first day of
35956 validity for that certificate; the fourth field in the last day that that
35957 certificate is valid, and the fifth field is what can be displayed of the
35958 MD5 hash of the public certificate corresponding to this private key. You
35959 can use any of the last three fields to distinguish between two
35960 certificates for the same owner.
35961 <P>
35962 Available commands and a short description of what they do follows.
35963 <UL>
35964 <LI> <B>I</B> Imports a new public key to this collection.
35965 <LI> <B>V</B> View information about the public certificate corresponding to this
35966 key.
35967 <LI> <B>D</B> Marks a key to be deleted.
35968 <LI> <B>U</B> Removes the deletion mark on a key.
35969 <LI> <B>X</B> Removes all keys marked deleted permanently (cannot be undone).
35970 Note that expunging a private key does not remove the public key, which must
35971 be removed separately.
35972 </UL>
35973 <P>
35974 All commands provide feedback to let you know about their success or failure.
35975 <P>
35976 <UL>
35977 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
35978 </UL><P>
35979 <P>
35980 <UL>
35981 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35982 </UL><P>
35983 &lt;End of help on this topic&gt;
35984 </BODY>
35985 </HTML>
35986 ====== h_config_smime_manage_cacerts_menu =====
35987 <HTML>
35988 <HEAD>
35989 <TITLE>S/MIME: Menu of Commands to Manage Certificate Authorities</TITLE>
35990 </HEAD>
35991 <BODY>
35992 <H1>S/MIME: Commands that Manage Certificate Authorities</H1>
35993
35994 UNIX Alpine only.
35995 <P>
35996 This screen allows you to manage your collection of certificates that you
35997 trust.
35998 <P>
35999 The format of this screen is as follows. There are five fields: The
36000 leftmost field is normally empty, but it could contain the letter
36001 &quot;D&quot; to indicate that that certificate has been marked for
36002 deletion. The next field is the e-mail address of the owner of the
36003 certificate, shown in its entirety. The third field is the first day of
36004 validity for that certificate; the fourth field in the last day that that
36005 certificate is valid, and the fifth field is what can be displayed of the
36006 MD5 hash of the certificate. You can use any of the last three fields to
36007 distinguish between two certificates for the same owner.
36008 <P>
36009 Available commands and a short description of what they do follows.
36010 <UL>
36011 <LI> <B>I</B> Imports a trusted certificate to this collection. This is
36012 done by reading the certificate and validating it. Once a certificate
36013 is found to be valid, it is saved, adding the extension &quot;.crt&quot;
36014 to the certificate, if necessary.
36015 <LI> <B>V</B> View information about this certificate, such as its issuer
36016 and validity dates.
36017 <LI> <B>D</B> Marks a certificate to be deleted.
36018 <LI> <B>U</B> Removes the deletion mark on a certificate.
36019 <LI> <B>X</B> Removes all certificates marked deleted permanently (cannot be undone).
36020 </UL>
36021 <P>
36022 All commands provide feedback to let you know about their success or failure.
36023 <P>
36024 <UL>
36025 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36026 </UL><P>
36027 <P>
36028 <UL>
36029 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36030 </UL><P>
36031 &lt;End of help on this topic&gt;
36032 </BODY>
36033 </HTML>
36034 ====== h_config_lame_list_mode =====
36035 <HTML>
36036 <HEAD>
36037 <TITLE>FEATURE: <!--#echo var="FEAT_enable-lame-list-mode"--></TITLE>
36038 </HEAD>
36039 <BODY>
36040 <H1>FEATURE: <!--#echo var="FEAT_enable-lame-list-mode"--></H1>
36041
36042 This feature modifies the method Alpine uses to ask your IMAP
36043 server for folder names to display in the FOLDER LIST screen.
36044 It is intended to compensate for a small set of IMAP servers that
36045 are programmed to ignore a part of the request, and thus respond
36046 to Alpine's query with nonsensical results.
36047 <P>
36048
36049 If you find that Alpine is erroneously displaying blank folder lists,
36050 try enabling this feature.
36051 <P>
36052
36053 NOTE: Enabling this feature has consequences for the Goto and Save
36054 commands.  Many servers allow access to folders outside the area
36055 reserved for your personal folders via some reserved character,
36056 typically '#' (sharp), '~' (tilde) or '/' (slash).  This mechanism
36057 allows, at the Goto and Save prompts, quick access to folders
36058 outside your personal folder collection without requiring a specific
36059 collection definition.  This behavior will generally not be available
36060 when this feature is enabled.
36061
36062 <P>
36063 <UL>
36064 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36065 </UL><P>
36066 &lt;End of help on this topic&gt;
36067 </BODY>
36068 </HTML>
36069 ====== h_config_enable_mulnewsrcs =====
36070 <HTML>
36071 <HEAD>
36072 <TITLE>FEATURE: <!--#echo var="FEAT_enable-multiple-newsrcs"--></TITLE>
36073 </HEAD>
36074 <BODY>
36075 <H1>FEATURE: <!--#echo var="FEAT_enable-multiple-newsrcs"--></H1>
36076
36077 This feature makes it so Alpine can use multiple newsrcs based on
36078 the news server being connected to, which allows for separate lists
36079 of subscribed-to newsgroups. When this feature is not set, there is only
36080 one list of newsgroups.
36081 <P>
36082 Under this feature, the name of a newsrc is based on the news server.
36083 For example, if your <a href="h_config_newsrc_path"><!--#echo var="VAR_newsrc-path"--></a>
36084 is set to &quot;.newsrc&quot;, and the news server you are connecting to is
36085 news.example.com, then the newsrc to be used is .newsrc-news.example.com.
36086 Setting this feature for the first time will allow for the option of using
36087 your old newsrc the next time you read news.
36088 <P>
36089 If this feature is set, then the feature
36090 <A HREF="h_config_mulnews_as_typed"><!--#echo var="FEAT_mult-newsrc-hostnames-as-typed"--></A>
36091 also may affect the name of the newsrc file that is used.
36092 <P>
36093 <UL>
36094 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36095 </UL><P>
36096 &lt;End of help on this topic&gt;
36097 </BODY>
36098 </HTML>
36099 ======= h_ab_export_vcard =======
36100 <HTML>
36101 <HEAD>
36102 <TITLE>Address Book Export Format</TITLE>
36103 </HEAD>
36104 <BODY>
36105 <H1>Address Book Export Format</H1>
36106
36107 You are exporting address book data from Alpine to a file outside of Alpine.
36108 You are being asked to choose the format of the export.
36109 Here are the choices:
36110
36111 <DL>
36112 <DT><EM>A</EM>ddress List</DT>
36113 <DD>
36114 The addresses from the address book entries you are saving
36115 from will be saved one address per line.
36116 Address book lists (those with more than one address) will have
36117 all of their addresses saved separately.
36118 </DD>
36119
36120 <DT><EM>V</EM>Card</DT>
36121 <DD>
36122 The entries will be saved in
36123 <A HREF="h_whatis_vcard">vCard</A> format.
36124 </DD>
36125
36126 <DT><EM>T</EM>ab Separated</DT>
36127 <DD>
36128 The entries will be saved in tab-separated columns.
36129 There will be just 4 columns of data that correspond to Alpine's
36130 Nickname field, Full Name field, Address field, and Comment field.
36131 It might prove useful to Select only the Simple, non-List address book
36132 entries before Saving.
36133 </DD>
36134
36135 <DT><EM>^C</EM> Cancel</DT>
36136 <DD>
36137 Cancel out of the Save.
36138 </DD>
36139
36140 </DL>
36141
36142
36143 <P>
36144 &lt;End of help on this topic&gt;
36145 </BODY>
36146 </HTML>
36147 ====== h_config_predict_nntp_server =====
36148 <HTML>
36149 <HEAD>
36150 <TITLE>FEATURE: <!--#echo var="FEAT_predict-nntp-server"--></TITLE>
36151 </HEAD>
36152 <BODY>
36153 <H1>FEATURE: <!--#echo var="FEAT_predict-nntp-server"--></H1>
36154
36155 This feature allows Alpine to assume that the open NNTP server at the
36156 time of composition is the NNTP server to which the message should be
36157 posted.  This is especially recommended when there are multiple News
36158 collections.  If this feature is not set, Alpine will try to post to the first server in
36159 the <a href="h_config_nntp_server"><!--#echo var="VAR_nntp-server"--></a> variable.  Setting
36160 this feature also negates the need to add News collection servers to
36161 the <!--#echo var="VAR_nntp-server"--> variable.
36162 <P>
36163 This feature can be especially handy when used in conjunction with
36164 <a href="h_config_enable_mulnewsrcs"><!--#echo var="FEAT_enable-multiple-newsrcs"--></a>.
36165 <P>
36166 <UL>
36167 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36168 </UL><P>
36169 &lt;End of help on this topic&gt;
36170 </BODY>
36171 </HTML>
36172 ====== h_config_nntp_search_uses_overview =====
36173 <HTML>
36174 <HEAD>
36175 <TITLE>FEATURE: <!--#echo var="FEAT_nntp-search-uses-overview"--></TITLE>
36176 </HEAD>
36177 <BODY>
36178 <H1>FEATURE: <!--#echo var="FEAT_nntp-search-uses-overview"--></H1>
36179
36180 This feature should probably be turned on unless it causes trouble.
36181 The results of the NNTP overview command (XOVER) may be used to help
36182 with some searches in news groups.
36183 It should result in quicker response time.
36184 Turning this feature on apparently causes search results which are
36185 different from what you would get with the feature turned off on some
36186 servers.
36187 <P>
36188 <UL>
36189 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36190 </UL><P>
36191 &lt;End of help on this topic&gt;
36192 </BODY>
36193 </HTML>
36194 ====== h_config_thread_sorts_by_arrival =====
36195 <HTML>
36196 <HEAD>
36197 <TITLE>FEATURE: <!--#echo var="FEAT_thread-sorts-by-arrival"--></TITLE>
36198 </HEAD>
36199 <BODY>
36200 <H1>FEATURE: <!--#echo var="FEAT_thread-sorts-by-arrival"--></H1>
36201
36202 This feature affects how a threading sort arranges threads.  The default way
36203 to arrange threads is by the date of the earliest message in the thread.
36204 This feature arranges threads by the last message to arrive in a thread.
36205 <P>
36206 This feature causes old threads that get recent messages to sort to the bottom,
36207 where previously a message arrival to a thread would not rearrange the order of
36208 that thread.
36209 <P>
36210 <UL>
36211 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36212 </UL><P>
36213 &lt;End of help on this topic&gt;
36214 </BODY>
36215 </HTML>
36216 ====== h_config_textplain_int =====
36217 <HTML>
36218 <HEAD>
36219 <TITLE>FEATURE: <!--#echo var="FEAT_show-plain-text-internally"--></TITLE>
36220 </HEAD>
36221 <BODY>
36222 <H1>FEATURE: <!--#echo var="FEAT_show-plain-text-internally"--></H1>
36223
36224 This feature modifies the method Alpine uses to display Text/Plain
36225 MIME attachments from the Attachment Index screen.  Normally, the
36226 &quot;View&quot; command searches for any externally defined (usually
36227 via the
36228 &quot;<A HREF="h_config_mailcap_path">Mailcap</A>&quot; file) viewer,
36229 and displays the selected text within that viewer.
36230
36231 <P>
36232 Enabling this feature causes Alpine to ignore any external viewer
36233 settings and always display text with Alpine's internal viewer.
36234
36235 <P>
36236 <UL>
36237 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36238 </UL><P>
36239 &lt;End of help on this topic&gt;
36240 </BODY>
36241 </HTML>
36242 ====== h_config_wp_columns =====
36243 <HTML>
36244 <HEAD>
36245 <TITLE>WEB ALPINE OPTION: <!--#echo var="VAR_wp-columns"--></TITLE>
36246 </HEAD>
36247 <BODY>
36248 <H1>WEB ALPINE OPTION: <!--#echo var="VAR_wp-columns"--></H1>
36249
36250 Web Alpine only.
36251 <P>
36252 This configuration setting specifies the number of horizontal characters
36253 used to format various WebAlpine pages.  Smaller values will tend to reduce
36254 the amount of horizontal scrolling required to view pages within narrow
36255 browsers, such as those found on PDAs, and larger values will tend to
36256 spread more information across the page.
36257
36258 <P>
36259 The Message List page uses the width to determine how many characters
36260 to assign each field.  Note, a smaller value may result in a disproportionate
36261 amount of blank space between fields on each line.  Similarly, a large
36262 value may result in cramped fields or horizontal scrolling.
36263
36264 <P>
36265 The Message View page uses this value to determine when to wrap lines
36266 in displayed message text.  Note, a smaller value may result in jagged
36267 right margins or confusing quoting.  A larger value may cause lines of text to
36268 run beyond the browser's right edge, requiring horizontal scrolling.
36269
36270 <P>
36271 <UL>
36272 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36273 </UL><P>
36274 &lt;End of help on this topic&gt;
36275 </BODY>
36276 </HTML>
36277 ====== h_config_wp_state =====
36278 <HTML>
36279 <HEAD>
36280 <TITLE>WEB ALPINE OPTION: <!--#echo var="VAR_wp-state"--></TITLE>
36281 </HEAD>
36282 <BODY>
36283 <H1>WEB ALPINE OPTION: <!--#echo var="VAR_wp-state"--></H1>
36284
36285 Web Alpine only.
36286 <P>
36287 Various aspects of cross-session state.
36288
36289 <P>
36290 <UL>
36291 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36292 </UL><P>
36293 &lt;End of help on this topic&gt;
36294 </BODY>
36295 </HTML>
36296 ====== h_config_wp_aggstate =====
36297 <HTML>
36298 <HEAD>
36299 <TITLE>WEB ALPINE OPTION: <!--#echo var="VAR_wp-aggstate"--></TITLE>
36300 </HEAD>
36301 <BODY>
36302 <H1>WEB ALPINE OPTION: <!--#echo var="VAR_wp-aggstate"--></H1>
36303
36304 Web Alpine only.
36305 <P>
36306 Aggregate operations tab state.
36307
36308 <P>
36309 <UL>
36310 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36311 </UL><P>
36312 &lt;End of help on this topic&gt;
36313 </BODY>
36314 </HTML>
36315 ====== h_config_wp_indexlines =====
36316 <HTML>
36317 <HEAD>
36318 <TITLE>WEB ALPINE OPTION: <!--#echo var="VAR_wp-indexlines"--></TITLE>
36319 </HEAD>
36320 <BODY>
36321 <H1>WEB ALPINE OPTION: <!--#echo var="VAR_wp-indexlines"--></H1>
36322
36323 Web Alpine only.
36324 <P>
36325 Number of index lines in table.
36326
36327 <P>
36328 <UL>
36329 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36330 </UL><P>
36331 &lt;End of help on this topic&gt;
36332 </BODY>
36333 </HTML>
36334 ====== h_config_wp_indexheight =====
36335 <HTML>
36336 <HEAD>
36337 <TITLE>WEB ALPINE OPTION: <!--#echo var="VAR_wp-indexheight"--></TITLE>
36338 </HEAD>
36339 <BODY>
36340 <H1>WEB ALPINE OPTION: <!--#echo var="VAR_wp-indexheight"--></H1>
36341
36342 Web Alpine only.
36343 <P>
36344 Index table row height.
36345
36346 <P>
36347 <UL>
36348 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36349 </UL><P>
36350 &lt;End of help on this topic&gt;
36351 </BODY>
36352 </HTML>
36353 ====== h_config_rss_news =====
36354 <HTML>
36355 <HEAD>
36356 <TITLE>WEB ALPINE OPTION: <!--#echo var="VAR_rss_news"--></TITLE>
36357 </HEAD>
36358 <BODY>
36359 <H1>WEB ALPINE OPTION: <!--#echo var="VAR_rss-news"--></H1>
36360
36361 Web Alpine only.
36362 <P>
36363 RSS News feed.
36364
36365 <P>
36366 <UL>
36367 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36368 </UL><P>
36369 &lt;End of help on this topic&gt;
36370 </BODY>
36371 </HTML>
36372 ====== h_config_rss_weather =====
36373 <HTML>
36374 <HEAD>
36375 <TITLE>WEB ALPINE OPTION: <!--#echo var="VAR_rss-weather"--></TITLE>
36376 </HEAD>
36377 <BODY>
36378 <H1>WEB ALPINE OPTION: <!--#echo var="VAR_rss-weather"--></H1>
36379
36380 Web Alpine only.
36381 <P>
36382 RSS Weather feed.
36383
36384 <P>
36385 <UL>
36386 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36387 </UL><P>
36388 &lt;End of help on this topic&gt;
36389 </BODY>
36390 </HTML>
36391 ====== h_config_send_confirms_only_expanded =====
36392 <HTML>
36393 <HEAD>
36394 <TITLE>FEATURE: send-confirms-only-expanded</TITLE>
36395 </HEAD>
36396 <BODY>
36397 <H1>FEATURE: send-confirms-only-expanded (Web Alpine Only)</H1>
36398
36399 This Web Alpine option specifies whether or not a Send confirmations
36400 happens when a composed message is readied for sending or not.  The
36401 default behavior is to not confirm that the nicknames were expanded to
36402 the intended addresses.
36403
36404 <P>
36405 <UL>
36406 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36407 </UL><P>
36408 &lt;End of help on this topic&gt;
36409 </BODY>
36410 </HTML>
36411 ====== h_config_enable_jump_command =====
36412 <HTML>
36413 <HEAD>
36414 <TITLE>FEATURE: enable-jump-command</TITLE>
36415 </HEAD>
36416 <BODY>
36417 <H1>FEATURE: enable-jump-command (Web Alpine Only)</H1>
36418
36419 This Web Alpine option specifies whether or not a Jump command is
36420 offered in the Message List and Message View pages.  The command is
36421 implemented as an input field in the left column of the List and View
36422 screens.
36423
36424 <P>
36425 When enabled and a number is entered in the input field while the
36426 Message List is displayed, the Message List is reframed with the
36427 specified message.  While viewing a message, the message associated
36428 with the specified message number is displayed.
36429
36430 <P>
36431 <UL>
36432 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36433 </UL><P>
36434 &lt;End of help on this topic&gt;
36435 </BODY>
36436 </HTML>
36437 ====== h_config_enable_newmail_sound =====
36438 <HTML>
36439 <HEAD>
36440 <TITLE>FEATURE: enable-newmail-sound</TITLE>
36441 </HEAD>
36442 <BODY>
36443 <H1>FEATURE: enable-newmail-sound (Web Alpine Only)</H1>
36444
36445 This Web Alpine option specifies whether or not a sound file is sent
36446 to the web browser along with the newmail notification message.
36447
36448
36449 <P>
36450 <UL>
36451 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36452 </UL><P>
36453 &lt;End of help on this topic&gt;
36454 </BODY>
36455 </HTML>
36456 ====== h_config_render_html_internally =====
36457 <HTML>
36458 <HEAD>
36459 <TITLE>FEATURE: render-html-internally</TITLE>
36460 </HEAD>
36461 <BODY>
36462 <H1>FEATURE: render-html-internally (Web Alpine Only)</H1>
36463
36464 By default, Web Alpine will pass cleansed HTML text you receive in messages
36465 to the browser for display (rendering).  This feature causes Web Alpine to convert
36466 the HTML text into plain text in the same way Unix and PC-Alpine do.
36467
36468
36469 <P>
36470 <UL>
36471 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36472 </UL><P>
36473 &lt;End of help on this topic&gt;
36474 </BODY>
36475 </HTML>
36476 ====== h_config_role_undo =====
36477 Yes, remember changes and exit back to list of roles; No, discard changes
36478 made in this screen; ^C, cancel exit and stay in this config screen.
36479 ====== h_exit_editor =====
36480 S, save changes and exit from the editor; D, do not save changes but
36481 do exit from the editor; or ^C, cancel exit and stay in the editor.
36482 ====== h_config_undo =====
36483 Yes, save changes and exit; No, exit without saving any changes made since
36484 entering this CONFIGURATION screen; ^C, cancel exit and stay in config screen.
36485 ====== h_os_index_whereis =====
36486 Enter ^V or ^Y to go immediately to the last or first message in the index.
36487 Or, enter the match string followed by RETURN.
36488 ====== h_os_index_whereis_agg =====
36489 Enter ^V or ^Y to go immediately to the last or first message in the index,
36490 Or, enter the match string followed by RETURN (or ^X to select all matches).
36491 =========== h_oe_add_full ==================
36492 Type the full name of the person being added and press the RETURN key.
36493 Press ^C to cancel addition.
36494 =========== h_oe_add_nick ==================
36495 Type a short nickname and press RETURN.  A nickname is a short easy-to-
36496 remember word, name or initials like "joe", or "wcfields."  ^C to cancel.
36497 ========== h_oe_add_addr ================
36498 Type the e-mail address and press RETURN.
36499 Press ^C to cancel addition.
36500 ========== h_oe_crlst_full ==============
36501 Type a long name or description for the list that you are creating and
36502 press RETURN.  Press ^C to cancel creation of list.
36503 =========== h_oe_crlst_nick =============
36504 Type a nickname (short, easy-to-remember name or single word) for the list
36505 you are creating and press RETURN.  Press ^C to cancel.
36506 ========== h_oe_crlst_addr ==============
36507 Type an e-mail address, or a nickname already in the address book that you
36508 want to be part of this list and press RETURN.
36509 ========== h_oe_adlst_addr =============
36510 Type an e-mail address or a nickname already in the address book that you
36511 want to add to this list and press RETURN.
36512 ========== h_oe_editab_nick ============
36513 Change the nickname using the arrow keys and delete key.  Press RETURN
36514 when done.  Press ^C to cancel editing and leave the nickname as it was.
36515 ========== h_oe_editab_full ============
36516 Change the full name using the arrow keys and delete key.  Press RETURN
36517 when done.  Press ^C to cancel editing and leave the full name as it was.
36518 ========== h_oe_editab_addr ============
36519 Change the address using the arrow keys and delete key.  Press RETURN
36520 when done.  Press ^C to cancel editing and leave the address as it was.
36521 ========== h_oe_editab_fcc ============
36522 Change the fcc using the arrow keys and delete key.  Press RETURN when
36523 done.  Press ^C to cancel editing and leave the fcc as it was.
36524 ========== h_oe_editab_comment ============
36525 Change the comment field using the arrow keys and delete key.  Press RETURN
36526 when done.  Press ^C to cancel editing and leave the comment as it was.
36527 ====== h_ab_forward =====
36528 Yes, expand nicknames and qualify local names with your current domain name;
36529 No, leave nicknames and local names as is;  ^C, cancel.
36530 ========== h_ab_export ==========
36531 Type the name of a file to write the addresses into and
36532 press RETURN.  You may also specify an absolute path.  Use ^C to cancel.
36533 ========== h_ab_edit_a_field ==========
36534 Edit any of the fields of the currently selected entry by typing one of the
36535 letters at the bottom of the screen.  Press ^C to cancel edit.
36536 ====== h_ab_del_data_revert =====
36537 Press B to completely delete addrbook and revert to default, C to delete config
36538 and revert while leaving data, or D to only delete data (make it empty).
36539 ====== h_ab_del_data_modify =====
36540 Press B to completely delete addrbook, C to delete configuration while leaving
36541 data, or D to delete data (make it empty) but leave config. ^C to cancel.
36542 ====== h_ab_del_config_modify =====
36543 Yes, remove this address book from my configuration.
36544 No, make no changes now.
36545 ====== h_ab_del_config_revert =====
36546 Yes, remove this address book from my config and revert to default.
36547 No, make no changes now.
36548 ====== h_ab_del_default =====
36549 Yes, remove this default address book from my configuration.
36550 No, make no changes now.
36551 ====== h_ab_really_delete =====
36552 Yes, delete the actual contents of the address book, not just the
36553 configuration.  No, don't delete the data after all, cancel and start over.
36554 ====== h_ab_del_ignore =====
36555 Press I to ignore all the default address books for this category.  Press R to
36556 remove this one address book and add the others to your personal list.
36557 ====== h_ab_del_dir_ignore =====
36558 Press I to ignore all the default directory servers for this category.
36559 Press R to remove this one server and add the others to your personal list.
36560 ====== h_ab_copy_dups =====
36561 Yes, overwrite the existing entry.
36562 No, skip duplicates but save the rest. Press ^C to cancel.
36563 ====== h_confirm_cancel =====
36564 Type C to Confirm that you want to abandon the message you are composing.
36565 Type N or ^C to cancel out of the cancel and keep composing.
36566 ====== h_ab_text_or_vcard =====
36567 Text, start composer with displayed text already included.
36568 VCard, start composer with address book entry attached as a vCard. ^C cancels.
36569 ====== h_ab_backup_or_ldap =====
36570 Backup, copy email address from entry and allow editing of it.
36571 LDAP, copy LDAP search criteria, do not allow editing of it. ^C cancels.
36572 ====== h_ldap_text_or_vcard =====
36573 Text: export displayed text for selected entry. Address: export only the
36574 email address. VCard: export entry in vCard format. ^C cancels.
36575 ====== h_ab_save_exp =====
36576 Save, save entry or entries to an address book.
36577 Export, save to file outside of pine. ^C cancels save.
36578 ====== h_ab_add =====
36579 A, add a brand new entry to this address book.
36580 E, edit the entry that is currently highlighted. ^C to cancel.
36581 ====== h_ab_shuf =====
36582 U, swap order of highlighted address book and the one above it.
36583 D, swap order of highlighted address book and the one below it. ^C to cancel.
36584 ====== h_ab_shuf_up =====
36585 U, swap order of highlighted address book and the one above it.
36586 Press ^C to cancel.
36587 ====== h_ab_shuf_down =====
36588 D, swap order of highlighted address book and the one below it.
36589 Press ^C to cancel.
36590 ====== h_folder_prop =====
36591 Count is # of messages in the folder, Unseen means messages that have not
36592 been read, New means messages that were Recently added to the folder.
36593 ====== h_role_shuf =====
36594 U, swap order of highlighted rule and the one above it.
36595 D, swap order of highlighted rule and the one below it. ^C to cancel.
36596 ====== h_role_shuf_up =====
36597 U, swap order of highlighted rule and the one above it.
36598 Press ^C to cancel.
36599 ====== h_role_shuf_down =====
36600 D, swap order of highlighted rule and the one below it.
36601 Press ^C to cancel.
36602 ====== h_incoming_shuf =====
36603 B, swap order of highlighted directory and the one before it.
36604 F, swap order of highlighted directory and the one after it. ^C to cancel.
36605 ====== h_incoming_shuf_up =====
36606 B, swap order of highlighted directory and the one before it.
36607 Press ^C to cancel.
36608 ====== h_incoming_shuf_down =====
36609 F, swap order of highlighted directory and the one after it.
36610 Press ^C to cancel.
36611 ====== h_dir_shuf =====
36612 U, swap order of highlighted directory and the one above it.
36613 D, swap order of highlighted directory and the one below it. ^C to cancel.
36614 ====== h_dir_shuf_up =====
36615 U, swap order of highlighted directory and the one above it.
36616 Press ^C to cancel.
36617 ====== h_dir_shuf_down =====
36618 D, swap order of highlighted directory and the one below it.
36619 Press ^C to cancel.
36620 ====== h_hdrcolor_shuf =====
36621 U, swap order of highlighted Header Color and the one above it.
36622 D, swap order of highlighted Header Color and the one below it. ^C to cancel.
36623 ====== h_hdrcolor_shuf_up =====
36624 U, swap order of highlighted Header Color and the one above it.
36625 Press ^C to cancel.
36626 ====== h_hdrcolor_shuf_down =====
36627 D, swap order of highlighted Header Color and the one below it.
36628 Press ^C to cancel.
36629 ========== h_oe_editab_al ============
36630 Change the address using the arrow keys and delete key.  Press RETURN
36631 when done.  Press ^C to cancel editing and leave the address as it was.
36632 ========== h_dir_comp_search ===============
36633 Type a string to look for just like you would in the composer. Your configured
36634 rules for the servers with the implicit flag set will be used.
36635 ========== h_oe_searchab ===============
36636 Type the word or name you want to search for and press RETURN.  If you press
36637 RETURN without entering anything the word in [] will be searched for.
36638 ========== h_oe_chooseabook ==========
36639 Choose the address book you want to save the new entry in.
36640 Use ^N or ^P to change address books.  ^C to cancel.
36641 ========== h_oe_takeaddr ==========
36642 Edit the e-mail address using the arrow and delete keys.  Press RETURN
36643 when done.  Press ^C to cancel adding this entry to the address book.
36644 ========== h_oe_take_replace ==========
36645 Press R to replace the old entry with this new data.  You will still have
36646 another chance to cancel.  N to enter another nickname.  ^C to cancel now.
36647 ========== h_oe_take_replace_or_add ==========
36648 Press R to replace the old entry.  Press A to add the selected addresses to
36649 the old existing list.  N to enter another nickname. ^C to cancel now.
36650 ========== h_oe_takename ==========
36651 Edit the full name to be correct using the arrow and delete keys.  Press RETURN
36652 when done.  Press ^C to cancel adding this entry to the address book.
36653 ========== h_oe_takenick ==========
36654 Type a nickname (short easy-to-remember name, initials or single word) for this
36655 entry in the address book and press RETURN.  Press ^C to cancel addition.
36656 ========== h_oe_jump ==========
36657 Type the message number you want to jump to and press RETURN.  The word "end"
36658 represents the last message. Press ^C to cancel jumping to another message.
36659 ========== h_oe_jump_thd ==========
36660 Type the thread number you want to jump to and press RETURN.  The word "end"
36661 represents the last thread. Press ^C to cancel jumping to another thread.
36662 ========== h_oe_debuglevel ==========
36663 Higher number shows more debugging details.
36664 Press ^C if you want to cancel the change.
36665 ========== h_oe_broach ==========
36666 Type the name of the folder you want to open and press RETURN.  Press ^P/^N
36667 to go to the previous/next collections in the list.  Press ^C to cancel goto.
36668 ========== h_oe_foldsearch ==========
36669 Type the text you want to search for in foldernames and press RETURN.  If you
36670 press RETURN without entering anything, any text in [] will be searched for.
36671 ========== h_oe_foldrename ==========
36672 Change the old name of the folder to the new name using the arrow and
36673 delete keys and press RETURN.  Press ^C to cancel rename.
36674 ========== h_oe_login ==========
36675 Enter your login name for the host you are opening the mailbox on.  Just press
36676 RETURN to use your login from this host as is, or edit it with delete key.
36677 ========== h_oe_passwd ==========
36678 Type your password for the host and login shown as part of the prompt.
36679 Press ^C to cancel opening folder.
36680 ========== h_oe_choosep ==========
36681 Enter the number associated with the printer you want to select.  Press ^C to
36682 cancel the printer selection.  The current selection is highlighted.
36683 ========== h_oe_customp ==========
36684 Type the name of the Unix print command and press RETURN.  Press ^C to
36685 cancel the printer selection.
36686 ========== h_oe_searchview ==========
36687 Type the word or name you want to search for and press RETURN.  If you press
36688 RETURN without entering anything the word in [] will be searched for.
36689 ========== h_oe_keylock ==========
36690 The keyboard is in use and locked by another user.  Only that user can
36691 unlock this keyboard by typing the password.
36692 ========== h_wt_expire ==========
36693 At the beginning of each month Alpine offers to rename your current sent-mail
36694 folder to one named for the month so you have a sent-mail folder for each month
36695 ========== h_wt_delete_old ==========
36696 It is the beginning of the month, and we need to conserve disk
36697 space.  Please delete any sent-mail that you do not need.
36698 ========== h_select_sort ==========
36699 Select the order for sorting the index by typing the capitalized letter.
36700 Arrival is by arrival in your mailbox; Date is by time/day message was sent.
36701 ========== h_no_F_arg ============
36702 Enter name of file to be opened.
36703
36704 ========== h_sticky_personal_name ==========
36705 Type in your name as you want it to appear on outgoing email.  This entry
36706 will be saved into your Alpine configuration file.
36707 ========== h_sticky_inbox ============
36708 INBOX syntax is usually {complete.machine.name}INBOX
36709 This entry will be saved in your Alpine configuration file.
36710 ========== h_sticky_smtp ============
36711 The name of the computer on your campus that relays your outgoing email
36712 to the Internet.  This entry will be saved in your Alpine configuration file.
36713 ========== h_sticky_user_id ==========
36714 The username or login-id part of your email address.  This entry will be
36715 saved in your Alpine configuration file.
36716 ========== h_sticky_domain ==========
36717 The domain part of your email address, NOT the name of your PC.  This
36718 entry will be saved in your Alpine configuration file.
36719 ========== h_bounce =========
36720 Enter the address or nickname of the intended recipient.  Alpine will resend
36721 the message, which will retain the original author's From: address.
36722 ========== h_incoming_add_folder_nickname =========
36723 Enter an (optional) nickname that will be used in lieu of the actual
36724 host and folder names in the FOLDER LIST display.
36725 ========== h_anon_forward ==========
36726 Enter the address of your intended recipient, or ^C to cancel.
36727 Example: jsmith@somewhere.edu
36728 ========== h_news_subscribe ==========
36729 Enter the name of the newsgroup to which you wish to subscribe,
36730 or ^C to cancel.  Example: comp.mail.pine
36731 ========== h_pipe_msg ==========
36732 Enter the name of the Unix command to which you wish to send this
36733 message, or ^C to cancel.
36734 ========== h_pipe_attach ==========
36735 Enter the name of the Unix command to which you wish to send this
36736 attachment, or ^C to cancel.
36737 ========== h_select_by_num ==========
36738 Enter a list of message numbers (or number ranges), or ^C to cancel. "end"
36739 is the last message. "." is the current message. Example: 1-.,7-9,11,19,35-end
36740 ========== h_select_by_thrdnum ==========
36741 Enter a list of message numbers (or number ranges), or ^C to cancel. "end"
36742 is the last message. "." is the current message. Example: 1-.,7-9,11,19,35-end
36743 ========== h_select_txt_from ==========
36744 Messages with From: headers containing the entered string will be selected.
36745 ^C to cancel. ^G again to see original options.
36746 ========== h_select_txt_not_from ==========
36747 Messages without From: headers containing the entered string will be selected.
36748 ^C to cancel. ^G again to see original options.
36749 ========== h_select_txt_to ==========
36750 Messages with To: headers containing the entered string will be selected.
36751 ^C to cancel. ^G again to see original options.
36752 ========== h_select_txt_not_to ==========
36753 Messages without To: headers containing the entered string will be selected.
36754 ^C to cancel. ^G again to see original options.
36755 ========== h_select_txt_cc ==========
36756 Messages with Cc: headers containing the entered string will be selected.
36757 ^C to cancel. ^G again to see original options.
36758 ========== h_select_txt_not_cc ==========
36759 Messages without Cc: headers containing the entered string will be selected.
36760 ^C to cancel. ^G again to see original options.
36761 ========== h_select_txt_subj ==========
36762 Messages with Subject: headers containing the entered string will be selected.
36763 ^C to cancel.  ^X enters Subject: line of current message.
36764 ========== h_select_txt_not_subj ==========
36765 Messages without Subject headers containing the entered string will be selected.
36766 ^C to cancel.  ^X enters Subject: line of current message.
36767 ========== h_select_txt_all ==========
36768 All messages containing the entered string will be selected.  Headers and body,
36769 but not encoded attachments, will be compared.  Enter ^C to cancel.
36770 ========== h_select_txt_not_all ==========
36771 All messages that don't contain the entered string will be selected.  Headers
36772 and body, but not encoded attachments, will be compared.  Enter ^C to cancel.
36773 ========== h_select_txt_body ==========
36774 All messages containing the entered string will be selected. Body text, but
36775 not headers or encoded attachments, will be compared. ^C to cancel.
36776 ========== h_select_txt_not_body ==========
36777 All messages that don't contain the entered string will be selected. Body
36778 text, but not headers or encoded attachments, will be compared. ^C to cancel.
36779 ========== h_select_txt_recip ==========
36780 Messages with Cc: or To: headers containing the entered string will be selected.
36781 ^C to cancel. ^G again to see original options.
36782 ========== h_select_txt_not_recip ==========
36783 Messages without Cc: or To: headers containing the string will be selected.
36784 ^C to cancel. ^G again to see original options.
36785 ========== h_select_txt_partic ==========
36786 Messages with Cc, To, or From headers containing the string will be selected.
36787 ^C to cancel. ^G again to see original options.
36788 ========== h_select_txt_not_partic ==========
36789 Messages without Cc, To, or From headers containing the string will be selected.
36790 ^C to cancel. ^G again to see original options.
36791 ========== h_select_date ==========
36792 If typed, date may be in DD-MMM-YYYY format (04-Jul-2006) or in ISO format
36793 (2006-07-04). ^P/^N also changes default date. ^X enters date of current msg.
36794 ========== h_attach_index_whereis ==========
36795 Enter some text that appears in the Attachment Index entry for the desired
36796 attachment.  The first attachment containing that text will be highlighted.
36797 ========== h_kb_lock ==========
36798 Keystrokes entered here (up to a RETURN) comprise a password that must
36799 be entered again later in order to unlock the keyboard.
36800 ========== h_compose_default ==========
36801 N, compose a new message. R, set a role.
36802 ^C to cancel.
36803 ========== h_untranslatable ==========
36804 Send using UTF-8 character set; Send but replace untranslatable characters
36805 with question marks; return to the composer; or cancel message altogether.
36806 ========== h_compose_intrptd ==========
36807 N, compose a new msg. I, continue interrupted msg. R, set a role.
36808 ^C to cancel.
36809 ========== h_compose_postponed ==========
36810 N, compose a new message. P, continue postponed msg. R, set a role.
36811 ^C to cancel.
36812 ========== h_compose_intrptd_postponed ==========
36813 N, compose a new msg. I, continue interrupted msg. P, continue postponed msg.
36814 R, set a role. ^C to cancel.
36815 ========== h_compose_form ==========
36816 N, compose a new message. F, use form letter. R, set a role.
36817 ^C to cancel.
36818 ========== h_compose_intrptd_form ==========
36819 N, compose a new msg. I, continue interrupted msg. F, use form letter.
36820 R, set a role. ^C to cancel.
36821 ========== h_compose_postponed_form ==========
36822 N, compose a new message. P, continue postponed msg. F, use form letter.
36823 R, set a role. ^C to cancel.
36824 ========== h_compose_intrptd_postponed_form ==========
36825 N, compose a new msg. I, continue interrupted msg. P, continue postponed msg.
36826 F, use form letter. R, set a role. ^C to cancel.
36827 ========== h_config_context_del_except ==========
36828 If you delete the last exceptional collection you can only add it back by
36829 manually editing the exceptions config file.
36830 ========== h_config_whereis ==========
36831 To move quickly to a particular line, enter a search string or
36832 ^C to cancel.
36833 ========== h_config_edit_scorei ==========
36834 Enter interval in the form (min,max). -INF and INF may be used to represent
36835 -infinity and infinity. ^C to cancel change. RETURN to accept change.
36836 ========== h_config_add ==========
36837 Enter desired value; use normal editing keys to modify (e.g. ^K, ^D).  Just
36838 pressing RETURN sets the Empty Value (this turns off any global default).
36839 ========== h_config_add_custom_color ==========
36840 Enter a header fieldname. For example, "subject" or "from".
36841
36842 ========== h_config_add_pat_hdr ==========
36843 Enter a header fieldname. For example, "reply-to" or "organization" or
36844 any fieldname you want that isn't included already.
36845 ========== h_config_print_opt_choice ==========
36846 You may edit either the initialization string (characters printed before
36847 printing starts) or the trailer string.  Choose one or ^C to cancel.
36848 ========== h_config_print_init ==========
36849 Enter a C-style string for this.  You may use common backslash escapes like
36850 \\n for newline, \\ooo for octal character, and \\xhh for hex character.
36851 ========== h_config_change ==========
36852 Edit the existing value using arrow keys, ^K to delete entire entry, ^D to
36853 delete current (highlighted) character, etc.  Enter ^C to cancel change.
36854 ========== h_config_replace_add ==========
36855 Replace ignores the current default, Add places the current default in your
36856 editing buffer as if you had typed it in.
36857 ========== h_config_insert_after ==========
36858 Enter a nickname for this print command.  (InsertBefore puts the new item
36859 before the current line, InsertAfter puts it after the current line.)
36860 ========== h_config_print_cmd ==========
36861 Enter command to be executed for the printer.  Use normal editing keys
36862 to modify, ^C to cancel, carriage return to accept current value.
36863 ========== h_config_role_del ==========
36864 Answering Yes will remove this rule completely from your rules list.
36865 ========== h_config_role_addfile ==========
36866 Type the name of a file to add to your configuration. You don't need to
36867 use a file, you may add rules directly (with Add) without using a file.
36868 ========== h_config_role_delfile ==========
36869 Answering Yes will remove this rule file completely from your rules list.
36870 The rules data file itself will not be removed.
36871 ========== h_config_print_del ==========
36872 Answering Yes will remove this printer completely from your printer list.
36873 ========== h_config_print_name_cmd ==========
36874 You may edit the Nickname of this printer, the Command to be executed when
36875 printing, or change the Options associated with this printer.
36876 ========== h_send_check_fcc ==========
36877 Yes, send message without an Fcc.
36878 No, return to composer.
36879 ========== h_send_check_subj ==========
36880 Yes, send message without a Subject.
36881 No, return to composer.
36882 ========== h_send_check_to_cc ==========
36883 Yes, send message without a To address, or a Cc address, or a Newsgroup.
36884 No, return to composer.
36885 ========== h_send_fcc_only ==========
36886 Yes, copy message to Fcc only and send to NO recipients.
36887 No, return to composer.
36888 ========== h_send_prompt ==========
36889 Yes, send the message.
36890 No or ^C, return to composer.
36891 ========== h_send_prompt_flowed ==========
36892 Yes, send the message.  No or ^C, return to composer.
36893 What's Flowed? See Do Not Send Flowed Text in config screen.
36894 ========== h_send_prompt_dsn ==========
36895 Yes, send the message.  No or ^C, return to composer.
36896 What's DSNOpts? See Enable Delivery Status Notification in config screen.
36897 ========== h_send_prompt_dsn_flowed ==========
36898 Yes, send the message.  No or ^C, return to composer. What's DSNOpts? See
36899 Enable Delivery Status Notification. What's Flowed? See Do Not Send Flowed Text.
36900 ========== h_role_confirm ==========
36901 Yes, use displayed role. No, compose without a role.
36902 ^C, cancel the message. ^T, select a role from your other eligible roles.
36903 ========== h_norole_confirm ==========
36904 Return, compose without a role.
36905 ^C, cancel the message. ^T, select a role from your eligible roles.
36906 ========== h_custom_print ==========
36907 Enter a Unix command that accepts its data on standard input.
36908 Alpine will display any information the command sends to standard output.
36909 ========== h_convert_abooks_and_sigs ==========
36910 You will be given the opportunity to convert address books and signature files
36911 to remote configurations.
36912 ========== h_convert_abooks ==========
36913 You will be given the opportunity to convert address books to remote
36914 configurations.
36915 ========== h_flag_keyword ==========
36916 Enter the name of the keyword you want to add for this folder.
36917 No spaces, parentheses, braces, percents or asterisks are allowed.
36918 ========== h_select_keyword ==========
36919 Enter the keyword you want to match, or use ^T to select a keyword from a list
36920 of possible keywords for this folder. Use ! to look for non-matches instead.
36921 ========== h_type_keyword ==========
36922 Enter the keyword you want to add. You may add a nickname in the next step.
36923 No spaces, parentheses, braces, percents or asterisks are allowed.
36924 ========== h_type_keyword_nickname ==========
36925 Enter an optional nickname for the keyword you want to add.
36926 Type Carriage return to use the keyword name instead of a nickname.
36927 ========== h_convert_sigs ==========
36928 You will be given the opportunity to convert signature files to remote
36929 configurations.
36930 ========== h_convert_abook ==========
36931 Yes is fairly safe. You will be ADDing a remote address book that is a copy
36932 of the current address book. The current abook won't be removed automatically.
36933 ========== h_convert_sig ==========
36934 Answering Yes copies the contents of the signature file into your Alpine
36935 configuration file. After that, the contents of the file will not be used.
36936 ========== h_save_addman ==========
36937 Enter the simple name of the folder you want to add. Carriage return to
36938 accept what you have typed so far. ^C to get back to SELECT FOLDER screen.
36939 ========== h_reopen_folder ==========
36940 Yes reopens the folder, as if you were starting over. This uncovers new mail.
36941 No leaves the folder index as it was without discovering new mail.
36942 ========== h_convert_pinerc_server ==========
36943 This is the name of the host (computer) where the remote Alpine configuration
36944 will be stored. This should be an IMAP server that you have permission to use.
36945 ========== h_convert_pinerc_folder ==========
36946 Enter the correct remote folder name. This folder is special and should
36947 contain only configuration data. It shouldn't contain other mail messages.
36948 ========== h_role_compose ==========
36949 Compose a New message, Reply to current message, Forward current message, or
36950 Bounce message. Then you will be asked to choose one of your Roles to be used.
36951 ========== h_role_aggregate ==========
36952 Compose a reply, or forward, or bounce the selected messages. Then you
36953 will be asked to choose one of your Roles to be used for this operation.
36954 ========== h_save_size_changed ==========
36955 The reported size of a message is not the same as the actual size. Answer Yes
36956 to continue and hope for the best or No to Cancel the entire Save.
36957 ========== h_select_by_larger_size ==========
36958 Enter a number or ^C to cancel. All messages greater than this many characters
36959 in size will be selected. Examples: 2176, 1.53K (1530), or 3M (3000000).
36960 ========== h_select_by_smaller_size ==========
36961 Enter a number or ^C to cancel. All messages less than this many characters
36962 in size will be selected. Examples: 2176, 1.53K (1530), or 3M (3000000).
36963 ========== h_preserve_field ==========
36964 Use 'p' to toggle between preserving or not preserving the original To:
36965 and Cc: fields of the message. Enter ^C to cancel message.