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-2020 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 451 2020-06-18 03:25:21
 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-2020 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 <P>
 174 Alpine's privacy policy is a living, online only, document, which can be found at
 175 <A href="h_privacy_policy">http://alpine.x10host.com/privacy.html</A>.
 176 By following the previous link,  Alpine
 177 will connect to an external server, and will download it and display
 178 it for you. Please take some time to read it and understand it.
 179 Since the Privacy Policy could be ammended to take into consideration
 180 new additions to Alpine, please check it periodically.
 181
 182 <P>
 183 This is a development version of Alpine. These enhancements are
 184 released after the release of version 2.22. Please report any
 185 problems you find with this release.
 186
 187 <H2>New in Alpine <!--#echo var="ALPINE_VERSION"--> (<!--#echo var="ALPINE_REVISION"-->)</H2>
 188
 189 <P> Additions include:
 190
 191 <UL>
 192 <LI> Implementation of XOAUTH2 authentication support for Outlook.
 193      Based on documentation suggested by Andrew C Aitchison.
 194
 195 <LI> Add support for the OAUTHBEARER authentication method in Gmail. Thanks to
 196      Alexander Perlis for suggesting it and explaining how the method works.
 197
 198 <LI> Creation of Alpine's Privacy Policy. This is presented as a link to
 199     an online document from the Release Notes (Link at the top of this
 200     document.) Upon user request, Alpine downloads and displays this
 201     document. Links to the privacy policy are also displayed when a user
 202     starts Alpine for the first time, or when a user starts a new version
 203     of Alpine. There is no default exit greeting command for these
 204     screens, and to exit the user must press "E", instead of the old
 205     default, which was the RETURN command. The RETURN command will open
 206     the handle on which the cursor is on, which by default is the Privacy
 207     Policy.
 208
 209 <LI> Support for the SASL-IR IMAP extension that avoids a round trip during
 210      authentication. Similar support added for the SMTP, NNTP and POP3
 211      protocols. Thanks to Geoffrey Bodwin for a report that lead to this
 212      implementation.
 213
 214 <LI> Alpine can pass an HTML message to an external web browser, by using the
 215      &quot;External&quot; command in the <a href="h_attachment_screen">ATTACHMENT INDEX</a>
 216      screen. <A href="h_command_external_browser">Learn more</A>.
 217
 218 <LI> New configuration variable
 219      <a href="h_external_loads_inline_images_only"><!--#echo var="FEAT_external-command-loads-inline-images-only"--></a>
 220      that controls if Alpine will keep the source link to all the images in the
 221      HTML message, or will only pass a link to inline images included in the message. For your
 222      privacy and security this feature is enabled by default.
 223
 224 <LI> When reading an email and a user selects an email address to which to compose
 225      a message from the message, the user will be able to select a role to compose
 226      that message.
 227
 228 <LI> New variable system-certs-path that allows users to indicate the
 229      location of the directory where certificates are located. In PC-Alpine
 230      this must be C:\\libressl\\ssl\\certs. The C: drive can be replaced
 231      by the name of the drive where the binary and DLL files are located.
 232
 233 <LI> New variable system-certs-file that allows users to configure the
 234      location of a container of certificate authority (CA) certificates
 235      to be used to validate certificates of remote servers.
 236
 237 <LI> Remove sleep of 5 seconds for mailcap programs that use the terminal
 238      to display content. Suggested by Carl Edquist. In addition, remove
 239      configurable process table command and its corresponding sleep time.
 240 </UL>
 241
 242 <P>
 243 Bugs addressed:
 244
 245 <UL>
 246  <LI> Security Bug: Alpine can be configured to start a secure connection using /tls
 247       on an insecure connection. However, if the connection is PREAUTH, Alpine
 248       will not upgrade the connection to a secure connection, because a client
 249       must not issue a STARTTLS to a server that supports it in authenticated
 250       state. This makes Alpine continue to use an insecure connection with the
 251       server, exposing user data. Reported by Damian Poddebniak and Fabian
 252       Ising from Münster University of Applied Sciences.
 253
 254    <LI> Selecting by subject might not copy the subject of the current message
 255      to the selection text correctly. Reported by Iosif Fettich.
 256
 257    <LI> Alpine does not set the return path correctly when using a role while bouncing
 258     a message. Reported by Dr. C. Griewatsch.
 259
 260 <LI>Bug in PC-Alpine that made Alpine go into an infinite loop and
 261     consume CPU when it was iconized. Reported by Holger Schieferdecker in
 262     comp.mail.pine.
 263
 264 <LI>Crash in Alpine when attempting to reply to a multipart/alternative
 265     message that is malformed, and the option to include attachments in
 266     reply is enabled. Reported and patched by Peter Tirsek.
 267
 268 <LI>Bug that makes Alpine split encoded words in the subject of a message
 269     in the middle of a utf-8 character into two encoded words, breaking the
 270     encoding. Reported by Jean Chevalier.
 271
 272 <LI> Alpine would not redraw the screen when a check for new mail in an
 273     incoming folder failed due to a failurec while validating the server
 274     certificate, and the user did not allow the connection to proceed.
 275
 276 <LI> Crash in Alpine while resizing the screen when using any of the tokens
 277     SUBJKEYTEXT, SUBJECTTEXT, or SUBJKEYINITTEXT in the index format, and
 278     the screen was resized. Reported by Iggy Mogo.
 279
 280 <LI> When Alpine is trying to authenticate to Gmail, using the XOAUTH2 method,
 281     it does not display the url the user needs to open, in order to authorize
 282     Alpine to access Gmail using XOAUTH2 when Alpine still has not created
 283     a screen. Reported by Baron Fujimoto.
 284
 285 <LI> When an html anchor does not quote the link in the href parameter,
 286     alpine does not link to it.
 287
 288 <LI> Attempt to fix a bug that breaks scrolling of a message in Alpine when
 289      the screen is resized. Reported in the Debian bug system at
 290      <A HREF="https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=956361">https://bugs.debian.org/cgi-bin/bugreport.cgie?bug=956361</A>.
 291 </UL>
 292
 293 <P>
 294 Version 2.22 addresses bugs found in previous releases and has several
 295 additions as well.
 296
 297 <P>
 298 Additions include:
 299
 300 <UL>
 301 <LI> Support for <A HREF="h_xoauth2">XOAUTH2</A> authentication method in Gmail.
 302
 303 <LI> PC-Alpine builds with LibreSSL and supports S/MIME.
 304
 305 <LI> NTLM authentication support with the ntlm library, in Unix systems.
 306 Based on code provided by Maciej W. Rozycki.
 307
 308 <LI> Add /tls1_3 flag for servers that support it. Read more information
 309 in the secure protocols <A HREF="h_network_encryption_security">help</A>.
 310
 311 <LI> To increase user's privacy, remove phone-home code that would prompt
 312 users to send an email message upon starting Alpine for the first time for
 313 purposes of counting. Your use of Alpine does not disclose information about
 314 you or your use of Alpine to the developers of Alpine.
 315
 316 <LI> New variable
 317 <A HREF="h_config_encryption_range"><!--#echo var="VAR_encryption-protocol-range"--></A>
 318 that allows users to configure versions of the SSL/TLS protocol that Alpine is
 319 restricted to try when establishing a secure connection SSL/TLS to a remote
 320 server. The default can be set at compilation time.
 321
 322 <LI> Add -dict option to PC-Pico, which allows users to choose a dictionary
 323 when spelling. Sample usage: -dict "en_US, de_DE, fr_FR".
 324
 325 <LI> Improvements to the configure stage of compilation. Some of
 326 these contributed by Helmut Grohne. See
 327 <A href="https://bugs.debian.org/876164">Bug 876164</A> in Debian.
 328
 329 <LI> Add &quot;remove password&quot; command to the management screen for the
 330 password file encryption key. This allows users to use their password file
 331 without entering a master password.
 332
 333 <LI> Add the &quot;g&quot; option to the select command that works in IMAP
 334 servers that implement the X-GM-EXT-1 capability (such as the one offered
 335 by Gmail.) This allows users to do selection in Alpine as if they were
 336 doing a search in the web interface for Gmail.
 337
 338 <LI> New variable close-connection-timeout, which tells Alpine to close
 339 a connection that is having problems being kept alive after the number
 340 of seconds configured in this variable, if the connection has not
 341 recovered. The default is 0, which means to keep the connection alive
 342 and wait for the connection to recover.
 343
 344 <LI> When a message is of type multipart/mixed, and its first part is
 345 multipart/signed, Alpine will include the text of the original message
 346 in a reply message, instead of including a multipart attachment.
 347 Suggested by Barry Landy.
 348
 349 <LI> S/MIME: Some clients do not transform messages to canonical form when
 350 signing first and encrypting second, which makes Alpine fail to parse the
 351 signed data after encryption. Reported by Holger Trapp.
 352
 353 <LI> Add /auth=XYZ to the way to define a server. This allows users to
 354 select the method to authenticate to an IMAP, SMTP or POP3 server.
 355 Examples are /auth=plain, or /auth=gssapi, etc.
 356
 357 <LI> Add backward search in the index screen. Based on patch by Astyanax Foo,
 358 submitted in 2009, but resubmitted by Erich Eckner on 2019.
 359
 360 <LI> SMIME: When Alpine is set to validate a message using the user's store, and
 361      user agrees to save a certificate of another user, use the saved
 362      certificate immediately to verify the smime message. Reported by
 363      Stefan Mueller.
 364
 365 <LI> Do not use a delay when printing messages to screen when the initial
 366      keystroke sequence of commands is active. Based on a report from Holger
 367      Trapp.
 368
 369 <LI> In PC-Alpine, when the decoded name of an attachment does not agree
 370      with its encoded name, Alpine will offer to save the file using the
 371      UTF8 encoded name.
 372 </UL>
 373
 374 <P>
 375 Bugs that have been addressed include:
 376 <UL>
 377    <LI> Width of characters is not always determined correctly when wcwidth
 378         is used. Revert to using code for the Windows operating system.
 379         Reported by Andrew Ho.
 380
 381    <LI> The call realpath(..., NULL) gives an error in Solaris, which means that
 382         we need to allocate memory for storing the resolved path. Reported by
 383         Fabian Schmidt.
 384
 385    <LI> Crash when attempting to bounce a message due to lack of space in
 386         allocated space for key menu array. Reported by David Sewell.
 387
 388    <LI> Crash when a CA certificate failed to load, and user attempted to
 389         view certificate information of other certificate authorities.
 390
 391    <LI> Crash in the S/MIME configuration screen when a user turned off S/MIME, and
 392         then re-enabled it. Also crash when attempting to enter the S/MIME
 393         configuration screen if S/MIME was turned off.
 394
 395    <LI> Deactivate some color code from Pico (as standalone editor in the
 396         windows version) until I find a way to activate it again. This is
 397         not critical and it is not something that PC-Pico must have (some
 398         of it already exists in other ways, like color support, what does
 399         not exist is the more complex code that Unix-Pico has with color
 400         codes for specific colors.)
 401
 402    <LI> When a message is multipart, and the first part is flowed text,
 403         then forwarding the message will set the first part to be flowed,
 404         and sent that way even when the option Do Not Send Flowed Text is
 405         enabled. Reported by Holger Trapp.
 406
 407    <LI> When a message/rfc822 part of a message is encoded with
 408         Content-Transfer-Encoding: QUOTED-PRINTABLE, Alpine will stop
 409         processing that message. Later this causes Alpine to crash because
 410         when it displays messages, it assumes that both header and body
 411         parts are processed. Reported by Mark Crispin in 2010, in the
 412         Alpine-info list (message with subject "crash bug in
 413         alpine/mailpart.c:format_msg_att()") with no example, and reported
 414         now by Holger Trapp, with an example.
 415
 416    <LI> In addition to the previous report, Alpine encodes message/rfc822
 417         messages as QUOTED-PRINTABLE, in contradiction with RFC 2045,
 418         when it receives a report that its encoding is 8bit. We preserve
 419         the encoding reported by the IMAP server, and do not encode in
 420         QUOTED-PRINTABLE.
 421
 422    <LI> Update build.bat file to add /DWINVER=0x0501 so that Alpine can
 423         build when using Visual Studio 2017. Fix contributed by
 424         Ulf-Dietrich Braunmann.
 425
 426    <LI> When the locale is not set up to UTF-8, alpine might determine the
 427         width of a character incorrectly. Reported by Alexandre Fedotov.
 428
 429    <LI> In some rare cases, when attachments are deleted before saving
 430         emails, the filenames will be displayed in RFC1522 representation,
 431         instead of in decoded form. Reported and patched by Wang Kang.
 432
 433    <LI> When colors are edited from the main setup configuration screen, some
 434         color settings are not updated until Alpine is restarted. Reported by
 435         Andrew Hill.
 436
 437    <LI> If the first part of a message is multipart/alternative, and the
 438         first part of this is also a multipart type, then Alpine might
 439         fail to select the first text part when replying to a message.
 440         Reported by Lucio Chiappetti.
 441
 442    <LI> TLS 1.2 works does not work if Alpine is compiled with openssl &gt;= 1.1.0.
 443         Reported and patched by Kyle George.
 444
 445    <LI> If the directory where Alpine saves the certificates is empty,
 446         alpine would not create a self-signed certificate to encrypt the
 447         password file.
 448
 449    <LI> S/MIME: The list of public certificates is freed before it is
 450         reused when a signature fails to verify. This causes Alpine to
 451         crash. Patch submitted by Linus Torvalds.
 452
 453    <LI> S/MIME: A message could fail to verify its signature even if the
 454         certificate was saved when the message was open. Based on a report
 455         by David Woodhouse to the RedHat bugzilla system.
 456
 457    <LI> When there are time changes in the clock, Alpine might go to sleep
 458         for big amounts of time while displaying messages in the screen.
 459         Reset sleep time to 5 seconds in case it finds it needs to sleep
 460         more than 5 seconds or a negative amount of time.
 461
 462    <LI> Restore recognition of empty directories. It was deleted by mistake
 463         when added support for internationalization in folders. Based on a
 464         report by Michael Rutter.
 465
 466    <LI> Alpine stops parsing the mailcap file when it finds an invalid entry.
 467         Reported by Matt Roberds to the Debian bug system at
 468         <A HREF="https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=886370">https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=886370</A>.
 469
 470    <LI> Crash with error "Lock when already locked" when an attempt to check
 471         for new mail on a locked stream that is being used for a save
 472         operation. Reported by Carlos E.R.
 473
 474    <LI> Alpine removes trailing spaces from passwords, making a longin attempt
 475         fail. Reported by R. Lyons.
 476
 477    <LI> Alpine crashes when opening a remote imap folder and computing scores.
 478         Reported by Paul DeStefano.
 479
 480    <LI> When more than one server was given in the server-name configuration
 481         option of rldap servers, none of them worked. Reported by Robert Wolf.
 482 </UL>
 483
 484 <P>
 485 Version 2.21 addresses bugs found in previous releases and has several
 486 additions as well.
 487
 488 <P>
 489 Additions include:
 490 <UL>
 491   <LI> PC-Alpine: New configuration option "Aspell Dictionaries" allows a
 492        user to choose the dictionary used to spell check, in case the user
 493        communicates in more than one language. Examples of values for the
 494        variable are "en_US" or "de_DE", etc. Only the first 10
 495        dictionaries are offered.
 496
 497   <LI> Unix-Alpine: Connect securely to a LDAP server on a secure port.
 498        Based on a contribution by Wang Kang.
 499
 500   <LI> Colors configured in Alpine are inherited in the composer.
 501
 502   <LI> When Alpine is compiled with password file and SMIME support
 503        the password file is encrypted using a private key/public
 504        certificate pair. If one such pair cannot be found, one will be
 505        created. <A HREF="h_password_file_support">Learn more</A>.
 506
 507   <LI> Alpine builds with any version of OpenSSL greater than or equal
 508        to 1.0.0c. This includes version 1.1.0. Alpine also builds with
 509        LibreSSL.
 510
 511   <LI> New SHORTSUBJECT, SHORTSUBJKEY and SHORTSUBJKEYINIT token for index
 512        format, which removes text in the SUBJECT between &quot;[&quot; and
 513        &quot;]&quot;.
 514
 515   <LI> New SMARTTIME24 token for index screen. It is close to SMARTDATETIME
 516        but it differns in that it gives the time in which the message was
 517        sent for messages that are less than a week old. it uses a 24 hour
 518        format.
 519
 520   <LI> Alpine will include attachments when forwarding some
 521        multipart/alternative messages for which it did not use to include
 522        attachments.
 523
 524   <LI> New configuration option
 525        <a href="h_config_alt_reply_menu"><!--#echo var="FEAT_alternate-reply-menu"--></a>
 526        which adds more ways to control features and variables when you
 527        start to reply to a message.
 528
 529   <LI> Added support for RFC 2971 - IMAP ID extension.
 530
 531   <LI> Add configuration <A href="h_config_ignore_size"><!--#echo var="FEAT_ignore-size-changes"--></A>
 532        that allows users to ignore errors in the computation of the size
 533        of a message from defective servers.
 534
 535   <LI> SMIME: Upgrade the default signature digest from sha1 to sha-256, since
 536        clients such as Thunderbird do not validate signatures that use sha1 digest.
 537
 538   <LI> Add the configuration variable "default-directories", which is called
 539        <A href="h_config_history"><!--#echo var="VAR_default-directories"--></A>
 540        variable saves a list of directories that are readily accessible
 541        for save or export of attachments. This makes it easier to save
 542        attachments in directories that are hard to navigate to, or that
 543        are accessed frequently.
 544
 545   <LI> When a filename is attached and its name is encoded, the save
 546        attachment command will offer to save the file in the encoded form.
 547        This might work for some users, but the save command will have a
 548        subcommand ^N to decode the file name and save the file with the
 549        decoded name.
 550
 551   <LI> The TAB key allows autocomplete in the Fcc field in the composer headers,
 552        as well as autocompletes automatically when only one possibility exists
 553        for the ^J attach command.
 554
 555   <LI> Add support for the &quot;TYPE&quot; and &quot;VALUE&quot; attributes of
 556        the html OL tag.
 557
 558   <LI> Ignore message from smtp server after a successful authentication
 559        challenge.
 560
 561   <LI> When a message is saved in the Form Letter folder, add the ability
 562        to save the role being used to compose such message so that settings
 563        such as the SMTP server set in the role can be used when sending
 564        such form message. Suggested and patched by Frank Doepper.
 565
 566   <LI> If SSLDIR is defined somehow, do not disable S/MIME if the
 567        SSLCERTSDIR is not found.
 568
 569   <LI> When Alpine sends an attachment, it will set the boundary attribute
 570        in lower case, as some SMTP servers, such as those of libero.it
 571        reject messages if the boundary attribute is in uppercase.
 572
 573   <LI> Add the ability to change the private key and certificates used
 574        to encrypt a password file in the SMIME setup configuration screen.
 575        <A HREF="h_config_smime_password_file_certificates">Learn more</A>
 576
 577   <LI> SMIME: The ctrl-E command that gives information on the certificate
 578        is only available for messages that have a signed or encrypted
 579        part.
 580
 581   <LI> SMIME: If a message contains a RFC822 attachment that is
 582        signed/decrypted add the ability to view its SMIME information.
 583
 584   <LI> SMIME: Certificate information in the S/MIME screen is available
 585        for certificates stored in a container.
 586
 587   <LI> SMIME: Offer the common name of the person, instead of the name of
 588        file containing the certificate, as the name to be displayed in the
 589        certificate management screen for certificate authorities.
 590        Suggested by Matthias Rieber.
 591
 592   <LI> SMIME: Management of several alternate name (SAN) certificates is
 593        improved. When importing a SAN certificate, also import a certificate
 594        for the filename, besides for the e-mail addresses in the
 595        certificate. Suggested by Matthias Rieber.
 596
 597   <LI> SMIME: add full year when displaying information about a certificate
 598        in the certificate management screen. Suggested by Matthias Rieber.
 599
 600   <LI> SMIME: sort certificates by some type of alphabetical order in the
 601        displayed name.
 602
 603   <LI> SMIME: Alpine will ask users if they wish to save S/MIME
 604        certificates included in signatures, when the option "Validate
 605        Using Certificate Store Only" is enabled. If the user does not wish
 606        to save it, validation will fail.
 607
 608   <LI> HTML: Add support for decoding entities in hexadecimal notation.
 609        Suggested by Tulip&aacute;nt Gergely.
 610
 611   <LI> The &quot;#&quot; command, when used as part of an aggregate
 612        operation will allow users to select the role used in either
 613        replying, forwarding or replying to the group of selected messages,
 614        Suggested by Hisashi T Fujinaka.
 615
 616   <LI> If the charset of a message can not be determined, use the value set
 617        in the <A HREF="h_config_unk_char_set"><!--#echo var="VAR_unknown-character-set"--></A> for its value.
 618
 619   <LI> Resizing setup screen will redraw screen.
 620
 621   <LI> Unix Alpine only. Experimental: If Alpine/Pico finds a UCS4 code
 622        in the width ambiguous zone, it will use other means to determine
 623        the width, such as call wcwidth.
 624
 625   <LI> Pico: Code reorganization in the search command to make it easier to
 626        add subcommands of the search command.
 627
 628   <LI> Pico: Search command can do a case sensitive match. Use the Ctrl-^
 629        subcommand of the search command to bring this choice into view.
 630
 631   <LI> Pico: Add the ability to search for strings in the beginning or end
 632        of a line. Use the Ctrl-^ subcommand of the search command to bring
 633        this choice into view.
 634
 635   <LI> For a multipart/alternative message, the Take Address command will
 636        work on the part that is being read.
 637
 638   <LI> When sending a message, allow for 512 characters of consecutive
 639        non-white space before folding the subject line.
 640
 641   <LI> Make sure titlebar (the line at the top of the screen) always
 642        contains the name of the folder/newsgroup that is open, if this
 643        fits in the title.
 644
 645   <LI> The feature <a href="h_config_scramble_message_id">FEATURE: <!--#echo var="FEAT_scramble-message-id"--></a>
 646        will also scramble the name, version and operating system in the
 647        message-id header. Based on a contribution by Dennis Davis, which
 648        is itself based on a contribution by Mark Hills.
 649
 650   <LI> Change in logic in imap_set_password function to make Alpine ask if
 651        a user wants to save a password before reading the password file.
 652
 653   <LI> When exporting all parts of a message, if two attachments have the same
 654        name, do not overwrite a file more than once, but instead add a counter
 655        number to the filename to make a new file that does not exist in the file
 656        system.
 657
 658   <LI> Add the Control-R subcommand to the save command for attachments.
 659        This subcommand toggles if the saving will be done in binary mode
 660        for text attachments. When a user saves an attachment using binary
 661        mode it will be saved as it was sent, otherwise the attachment will
 662        be transformed to UTF-8 for further transformation through internal
 663        and user defined filters for saving.
 664
 665   <LI> Add command line argument -smimedir, which allows users to specify
 666        the default path for a directory that contains the public, private,
 667        and ca directories. This is useful in case a user has a backup of
 668        old certificates that cannot be installed in the ~/.alpine-smime
 669        dir.
 670
 671   <LI> Reimplementation of the code that allows the .pinerc file to be a
 672        symbolic link by Kyle George from tcpsoft.com to use realpath.
 673
 674   <LI> When saving an attachment, the "^T" command leads to a screen where the
 675        "A" command can be used to add a file. A directory can be added by
 676        pressing "^X" after the "A" command. Added after a suggestion by
 677        Stefan Goessling.
 678
 679   <LI> When saving an attachment, the ^Y and ^V commands allow a user to
 680        scroll through the history of directories used to save attachments,
 681        while preserving the given name of the file. Suggested by Peter
 682        Koellner.
 683
 684   <LI> SMIME: Turn off automatic signing and encrypting of a message when
 685        bouncing. Suggested after a discussion with Matthias Rieber.
 686
 687   <LI> When messages are selected, warn the user if a message that is not
 688        selected will be bounced, or if not all selected messages will be
 689        bounced. Suggested by Ulf-Dietrich Braumann.
 690
 691   <LI> The bounce command adds a subcommand to choose a role.
 692
 693   <LI> When selecting messages by number, the &quot;.&quot; character can
 694        be used to specify the message on which the cursor is on.
 695
 696   <LI> When Alpine opens an attachment, it sometimes changes the extension
 697        of the file that is being opened and replaces it by another for the
 698        same mime type. If Alpine finds that the extension of the file
 699        corresponds with the mime type, according to the mime-types file,
 700        then it will keep it, and no substitution will be made.
 701
 702   <LI> Set no restrictions on the length of encoded subjects, but encode
 703        words in length of no more than 75 characters.
 704 </UL>
 705
 706
 707 <P>
 708 Bugs that have been addressed include:
 709 <UL>
 710   <LI> SMIME: Crash when a certificate has an invalid date of validity. Also
 711        Alpine will use the function ASN1_TIME_print to determine the date
 712        of validity. Reported by Ben Stienstra.
 713
 714   <LI> SMIME: Crash when attempting to unlock the password file and an
 715        incorrect password is entered.
 716
 717   <LI> SMIME: Crash when checking the signature of a message that contains
 718        a RFC822 attached message. Reported by Holger Trapp and Bj&ouml;rn
 719        Krellner.
 720
 721   <LI> SMIME: Cancelling entering password to unlock key will not reprompt.
 722
 723   <LI> SMIME: fix a bug that did not allow users to transfer certificates to
 724        remote containers. Reported by Matthias Rieber.
 725
 726   <LI> SMIME: certificates included in messages were not being transferred
 727        to a remote container.
 728
 729   <LI> SMIME: Crash if public certificates are located in an inaccessible
 730        remote server and the private key is not available.
 731
 732   <LI> SMIME: Alpine does not remove temporary files created when adding a
 733        CA certificate to a container. Reported by Holger Trapp.
 734
 735   <LI> SMIME: When reading a local certificate, Alpine converts the name
 736        of the certificate to lowercase, which may make Alpine not be able
 737        to read such certificate. Reported by Dennis Davis.
 738
 739   <LI> SMIME: If the option "Remember S/MIME Passphrase" is disabled, then
 740        entering a password to read an encrypted message will make Alpine
 741        forget the key and not ask the password to unlock it again in case
 742        it is necessary to unlock it again. Reported by Ulf-Dietrich
 743        Braumann.
 744
 745   <LI> Alpine would use freed memory while trying to compute the color
 746        of the titlebar. This happened when trying to continue a postponed
 747        message.
 748
 749   <LI> Alpine failed to read an encrypted password file if too many
 750        passwords were saved in the password file.
 751
 752   <LI> When selecting messages while in Threaded Index Screen, some
 753        messages other than top of threads could appear in the index, making
 754        Alpine display messages &quot;out of the screen.&quot;
 755
 756   <LI> The index format would be chopped at the position of an unrecognized
 757        token, instead of skipping the token as intended.
 758
 759   <LI> Work in progress: Avoid calling non-safe functions when Alpine
 760        receives a signal. See bug report
 761        <A HREF="https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=825772">here.</A>
 762
 763   <LI> Crash when attempting to read a message after a bounce command.
 764        In order to produce a crash one needed to use the ^T subcommand and
 765        do a search in a LDAP directory. The crash is produced by changes
 766        to the text in the title bar. Reported by Heinrich Mislik in the
 767        Alpine-info list.
 768
 769   <LI> HTML messages that contain UTF-8 may wrap at the wrong position,
 770        making Alpine not display the correct character at the position
 771        that wrapping is done. Reported by Wang Kang.
 772
 773   <LI> Pico: Searching for a string that is too long causes Pico to crash
 774        in the next search.
 775
 776   <LI> Fix vulnerability in regex library. This only affects those who use
 777        this library, such as the windows version of Alpine. See
 778        <A HREF="http://www.kb.cert.org/vuls/id/695940">http://www.kb.cert.org/vuls/id/695940</A>
 779        for more details.
 780
 781   <LI> Alpine would not set include and lib paths for OpenSSL if this was
 782        installed in /usr/local/ssl.
 783
 784   <LI> If the .pinerc file is a symbolic link, Alpine might not write its
 785        contents when saving its configuration.
 786
 787   <LI> The _INIT_ token does not skip over non-alphanumeric characters in
 788        the name. Reported by Andreas Fehr.
 789
 790   <LI> When opening an INBOX folder in a context different from the
 791        incoming folders collection, from the command line, Alpine would
 792        open the INBOX folder from the incoming folders collection.
 793
 794   <LI> Mismatch in size of UCS and CELL caused a corruption in the
 795        content of a pointer, which made the speller in PC-Alpine get the
 796        content of a word incorrectly.
 797
 798   <LI> Skip testing openssl compatibility version when cross-compilation
 799        is detected. Fix contributed by Antti Sepp&auml;l&auml;
 800
 801   <LI> Alpine fails to remove temporary files used during a display or sending
 802        filter. Fix contributed by Phil Brooke.
 803
 804   <LI> When the index is in zoomed state, adding new messages to the
 805        selection would not show those messages if those messages are on
 806        top of the current message in the top of the screen. Reported by
 807        Ulf-Dietrich Braumann. In addition, when the user scrolls through
 808        the index, this scroll smoothly, without jumping pages. Reported
 809        by Holger Trapp.
 810
 811   <LI> Crash when reviewing history of saving attachments.
 812
 813   <LI> Crash when canceling a goto command on a local collection that has
 814        not been expanded and attempting to expand such collection.
 815
 816   <LI> Crash in Pico when forwarding messages that contain a direction mark
 817        at the end of a line. Reported by James Mingo.
 818
 819   <LI> Solve compilation errors when Alpine is built with Visual Studio 2015.
 820 </UL>
 821
 822
 823 <P>
 824 Version 2.20 addresses bugs found in previous releases and has several
 825 additions as well.
 826
 827 <P>
 828 Additions include:
 829 <P>
 830
 831 <UL>
 832   <LI> Upgrade UW-IMAP to Panda IMAP from
 833        <A HREF="https://github.com/jonabbey/panda-imap">https://github.com/jonabbey/panda-imap</A>.
 834   <LI> S/MIME: Add screen to manage certificates.
 835   <LI> S/MIME: Signatures are validated using the user's certificates instead
 836        of the ones included in the message. Behavior can be disabled by
 837        disabling the option <A href="h_config_smime_use_cert_store">
 838         <!--#echo var="FEAT_smime-use-storey-only"--></A>, which is enabled
 839        by default.
 840   <LI> S/MIME: sign messages using intermediate certificates when needed
 841        and possible.
 842   <LI> S/MIME: validation of certificates for servers that modify signed
 843        content.
 844   <LI> S/MIME: signed and encrypted messages will be signed first and
 845        encrypted second, so that they can be decoded by other clients.
 846   <LI> S/MIME: add the sender certificate to the list of certificates in
 847        encrypted messages to make it possible for the sender to decrypt
 848        the message they sent.
 849   <LI> S/MIME: When transferring certificates to a local container, create
 850        container with default names PublicContainer, PrivateContainer and
 851        CAContainer, as appropriate for these files, unless the user has
 852        provided some other names.
 853   <LI> S/MIME: Forwarding a message will include the signed part as part
 854        of the text and not as a multipart message, just as the reply
 855        command does.
 856   <LI> HTML: Style tag in body of html message causes Alpine to not write
 857        its content until a new &lt;/style&gt;
 858   <LI> HTML: &lt;BR&gt;, &lt;BR /&gt;, and &lt;BR/&gt; are considered
 859        the same inline tag; the same is valid for the &lt;HR&gt; tag.
 860   <LI> Add support to selective expunge through a subcommand of the
 861        select-apply commands. Read more in the <A
 862        HREF="h_index_cmd_expunge">help</A> for the expunge command.
 863   <LI> Pico: New subcommand of the search command, allows to reverse the
 864        direction of search.
 865   <LI> Unix Alpine: If a password file is defined, and S/MIME is enabled,
 866        the key and certificate used to encrypt the password file are saved
 867        in the ~/.alpine-smime/.pwd directory, or in the directory specified
 868        by the -pwdcertdir command line option.
 869        <A HREF="h_password_file_support">Learn more</A>.
 870   <LI> Add /tls1, /tls1_1, /tls1_2 and /dtls1 to the definition of a
 871        server to use different ways to connect using ssl, for
 872        example {server.com/tls1} will attempt to connect to
 873        server.com at the ssl imap port (port 993) and establish a
 874        connection using TLSv1. These flags can be used in
 875        conjunction with the /ssl flag, the ssl flag is redundant.
 876        Conversely, however, the /ssl flag does not imply any of
 877        these flags; the /ssl flag means SSLv3 or, if not available,
 878        SSLv2 in the SSL port.
 879   <LI> Alpine does not attempt to automatically reopen a collection
 880        that was not opened due to cancellation by the user.
 881        Instead, the user must try to open it explicitly.
 882   <LI> Alpine searches for a certificate that matches an email address in
 883        all addresses in a certificate (instead of just the first
 884        one) but when it tries to unlock the certificate, it asks
 885        for the password for the first email address in that
 886        certificate.
 887   <LI> Style tag in body of html message causes Alpine to not write its content
 888        until a new &lt;/style&gt;
 889   <LI> Experimental: Write the content-type of a message in
 890        lowercase, as some non-compliant servers do not understand
 891        uppercase content-type, such as those of GMX.de.
 892   <LI> Experimental: Do not send the RSET command before attempting
 893        to send a message, as this causes a delay in some evily managed
 894        servers.
 895   <LI> Opening a folder updates recent count in maildrops (this
 896        already works for other types of folders)
 897   <LI> Automatically redraw screen after opening an attachment
 898        instead of simply clearing it.
 899   <LI> Pico: Justification works without need of a predefined quote
 900        string. This allows justification of blocks of text that are
 901        indented with spaces.
 902   <LI> Decode the name of attachment names, so they can be written as part
 903        of the description of the part.
 904   <LI> Check bounds and tie strings off to improve security. Contributed
 905        by James Jerkins.
 906   <LI> Replace tabs by spaces in From and Subject fields to control for
 907        size in screen of these fields. Change only in index screen display.
 908   <LI> Aggregate operations allows bouncing a list of messages using a role.
 909        Suggested by Ulf-Dietrich Braumann.
 910   <LI> Disable saving new passwords to the password file. Implemented
 911        by Louis Raphael from dpslabs.com. <A HREF="h_config_disable_password_file_saving">Learn more.</A>
 912   <LI> Makefile: Add $(LIBINTL) to the flags to link rpdump, rpload,
 913      alpined and alpineldap because MAC OSX 10.8 x86_64 needs it. Reported by
 914      Charles M. Register.
 915 </UL>
 916
 917
 918 <P>
 919 Bugs that have been addressed include:
 920 <UL>
 921   <LI> Fix _INIT_ token for reply quote string to include support for 8-bit
 922        in personal names. Reported by Lev Gorenstein.
 923   <LI> When writing the .pinerc file, lines were truncated if they were longer
 924        than 10,000 characters. This could cause data corruption, so now lines
 925        are allowed to be of any length.
 926   <LI> S/MIME: signed messages that contained an attachment would not validate.
 927   <LI> S/MIME: signed and encrypted messages from Thunderbird would not
 928        validate. Thanks to Andreas Schamanek for testing, debugging and
 929        advising during the process of fixing this problem.
 930   <LI> S/MIME: Forwarding messages with multipart content-type failed to be signed
 931        with &quot;Error writing pipe&quot; message. Reported by Andreas Schamanek
 932        and Stefan Mueller.
 933   <LI> S/MIME: Certificates are lost when using a pinerc file outside of the
 934        home directory.
 935   <LI> S/MIME: Accessing the S/MIME configuration screen would deinitialize
 936        SMIME making it not possible to sign or encrypt messages.
 937   <LI> S/MIME: Forwarding a signed message might make the body contain mime
 938        information that is not part of the body, and hence making the body
 939        of the message seem wrong.
 940   <LI> S/MIME Alpine would compute incorrectly the signature of a message
 941        that contains 8bit if the option "Enable 8bit ESMTP Negotiation" is
 942        enabled, the message contains 8bit characters and the smtp server
 943        supports 8bit sending.
 944   <LI> When replying to several messages, subject will be decoded first,
 945        and then stripped from re/fwd before they are compared to determine
 946        the subject of the replied message.
 947   <LI> Crash when tcp connection to NNTP server was lost after connection
 948        had been established, but lost immediately afterwards.
 949   <LI> Crash with message &quot;lock when already locked&quot;, when painting
 950        an index was based on scores that needed information from a remote
 951        addressbook in the same server as the folder opened. Reported by
 952        Peter Koellner.
 953   <LI> Crash in message/rfc822 attachments encoded in base64.
 954   <LI> Postponed messages whose content-type is text/html, text/enriched and
 955        text/richtext are sent with that content-type, even though, after
 956        resuming composition, Alpine had changed its type to text/plain.
 957   <LI> Alpine cannot handle correctly some characters in the Windows-1256
 958        character set, which might lead to a crash or a corruption in the
 959        screen. Work was done to contain the bug. A more complete fix will
 960        be done in a future release. Reported by Professor Robert Funnell.
 961   <LI> WebAlpine: add _GNU_SOURCE to make pubcookie build.
 962   <LI> WebAlpine: fail to build with debug disabled. Fix from Sam Hathaway.
 963   <LI> Save command did not warn of existence of a message with a deleted
 964        attachment in an aggregate save, unless cursor was positioned on a message
 965        with a deleted attachment. Reported by Florian Herzig.
 966   <LI> Transformation of UTF-8 to MUTF7 was not being done when creating a folder
 967        in an IMAP server.
 968   <LI> DATE tokens were not internally transformed to UTF-8, which made their
 969        values not appear complete in the screen. Reported by Werner Scheinast.
 970   <LI> Fixes to configure script so that it will not require PAM for every system.
 971   <LI> Fix to configure script so that it will use CPPFLAGS instead of
 972        CPPCFLAGS, and so the --with-ssl-include-dir option take effect
 973        during the build. Fix by Ulf-Dietrich Braumann.
 974   <LI> Fix in WebAlpine: do not use deprecated dereference in pointer,
 975        needs to use tcl_getstringresult() instead. Reported by
 976        Ulf-Dietrich Braumann.
 977   <LI> Quoted string in URL Viewers configuration variable were not
 978        unquoted before passing to viewer.
 979   <LI> Fix in configure script to detect location of tcl library; add
 980        /usr/local in FreeBSD and fix a bug in configure script that used
 981        $alpine_TCLINC instead of $alpine_TCLINC/tcl.h. Reported and fixed
 982        by Werner Scheinast.
 983   <LI> Move SSL configurations from UW-IMAP to configure script, and
 984        update OpenSSL configuration for Mac OS X.
 985   <LI> Remove -lregex from linker flags when building --with-supplied-regex.
 986   <LI> When the download of an attachment is interrumpted, Alpine stills
 987      caches what was downloaded, making the download incomplete for
 988      subsequent calls of Alpine attempting to open the attachment. In the
 989      future, Alpine will not cache any downloaded part of the attachment
 990      when it is interrupted.
 991 </UL>
 992 <P>
 993
 994
 995 <P>
 996 Version 2.11 addresses bugs found in previous releases and has a few
 997 additions as well.
 998
 999 <P>
1000 Additions include:
1001 <P>
1002
1003 <UL>
1004    <LI> Alpine requires version 1.0.0c of Openssl to build.
1005    <LI> Increase encryption of S/MIME encrypted messages.
1006    <LI> Pico: Improvements in justification of paragraphs: lines that begin
1007 with a quote string, followed by a space were considered individual paragraphs,
1008 now they are considered part of a paragraph. Based on earlier joint work
1009 with Jeff Franklin.
1010    <LI> Unix Alpine: Allow local .pinerc file to be a symbolic link.
1011    <LI> Experimental extended support of recognition of UTF-8 in urls based on
1012 information from <A HREF="http://url.spec.whatwg.org">http://url.spec.whatwg.org</A>.
1013    <LI> Added recognition of ws and wss URIs.
1014    <LI> Add ability to <A HREF="h_config_folder_color">color folder names</A>,
1015  <A HREF="h_config_directory_color">directory names</A>,
1016  and <A HREF="h_config_folder_list_color">text</A> in the FOLDER SCREEN.
1017    <LI> Add the ability to <A HREF="h_config_indextoken_color">color any token</A>
1018 used in the display of the INDEX SCREEN.
1019    <LI> New option <A HREF="h_config_preserve_field"><!--#echo var="FEAT_preserve-original-fields"--></A>
1020 that adds the ability to preserve To: and Cc: fields when replying to a
1021 message, as specified by original sender.
1022    <LI> Add a _SILENT_ token to the <A HREF="h_config_display_filters">list of tokens</A>
1023  for a display filter, so that Alpine will not redraw the screen when it is unnecessary.
1024    <LI> Quota command includes subcommands for printing, forwarding, etc.
1025 </UL>
1026
1027 <P>
1028 Bugs that have been addressed include:
1029 <P>
1030 <UL>
1031   <LI> Crash when a non-compliant SMTP server closes a connection without a QUIT command.
1032   <LI> Crash when resizing the screen in a configuration screen.
1033   <LI> Do not bail out during a tcp timeout, instead close connection and avoid crash.
1034   <LI> Do not use a shell to open a browser.
1035   <LI> Configure script did not test for crypto or pam libraries.
1036   <LI> Configure script attempted to build web component, even if header file tcl.h was not present.
1037   <LI> Change Cygwin directory separator to &quot;/&quot;.
1038   <LI> Alpine could set List- headers, contrary to RFC 2369.
1039 </UL>
1040
1041 <P>
1042 Version 2.10 addresses bugs found in previous releases and has a few
1043 additions as well.
1044
1045 <P>
1046 Additions include:
1047 <P>
1048
1049 <UL>
1050    <LI> Quota report for IMAP folders that support it (press the &quot;@&quot; command in the index screen of such folder).
1051    <LI> Search a folder for the content of any header with the &quot;;&quot; command.
1052    <LI> Foreign characters are decoded correctly in IMAP folder names.
1053    <LI> Question about breaking connection to slow servers includes their name.
1054    <LI> Internal x-alpine-help: resource locator for sending links to internal help.
1055    <LI> OpenSuse: Alpine find location of OpenSSL certificates.
1056    <LI> Cygwin: Alpine builds without need of patch.
1057    <LI> Recognition of proper mime type for docx, xlsx, and pptx files.
1058    <LI> When composing a message, Alpine will create a new thread when the subject is erased.
1059    <LI> Add support for strong encryption of password file when S/MIME is built in.
1060 </UL>
1061
1062 <P>
1063 Bugs that have been addressed include:
1064 <P>
1065
1066 <UL>
1067    <LI> Alpine will close a folder after confirming with user their intention and not reopen it.
1068    <LI> Double allocation of memory in Pico.
1069    <LI> Alpine does not give warning of message sent and posted upon receipt by email of message posted in newsgroup.
1070    <LI> Handling of STYLE html parameter may make Alpine not display the content of a message.
1071    <LI> Not recognition of environment variables in some options.
1072    <LI> Not display of login prompt during initial keystrokes.
1073    <LI> justification of long urls breaks them.
1074    <LI> Incorrect New Mail message when envelope is not available.
1075    <LI> Incorrect display of PREFDATE, PREFDATETIME and PREFTIME tokens.
1076    <LI> Crash when resizing the screen after display of LDAP search.
1077    <LI> Crash when redrawing screen while opening a remote folder collection.
1078    <LI> Infinite loop in scrolltool function during notification of new mail.
1079    <LI> No repaint of the screen after midnight was done when the SMARTDATE token is used in the index screen.
1080    <LI> No display of signed and encrypted S/MIME messages.
1081    <LI> Alpine will not build with OpenSSL.
1082    <LI> Crash for double locking in calls to c-client.
1083    <LI> Bad recognition of mime-encoded text may make Alpine not print the subject of a message.
1084    <LI> Ignore the references header when threading messages
1085    <LI> No update of colors in index screen after update to addressbook.
1086 </UL>
1087
1088 <P>
1089 Version 2.01 addresses bugs found in previous releases and has a few
1090 additions as well.
1091
1092 <P>
1093 Additions include:
1094 <P>
1095
1096 <UL>
1097    <LI> Fixed non-ASCII web alpine handling
1098    <LI> Added web alpine help.
1099    <LI> Allow web alpine inbox on second IMAP server.
1100    <LI> Allow web alpine config reset after bad inbox-path gets set.
1101    <LI> Added web alpine ability to create group contact from contact list members.
1102    <LI> Backed out web alpine coercing of default sort-key of arrival to date/reverse.
1103    <LI> Tidied up web alpine script layout.
1104    <LI> Fixed web alpine status message ordering
1105    <LI> Added web alpine Fcc setting via Contacts in Compose
1106    <LI> Fixed web alpine autodraft attachment issues
1107    <LI> Fixed web alpine problems with recent count maintenance
1108    <LI> Fixed web alpine newmail arrival display in message list
1109    <LI> Added web alpine confirmation to folder create for Move/Copy
1110    <LI> Added web alpine user-domain support
1111    <LI> Fixed web alpine to support INBOX-within-a-collection deletion
1112 </UL>
1113
1114 <P>
1115 Bugs that have been addressed include:
1116 <P>
1117
1118 <UL>
1119    <LI> In web alpine fixed delete all selected within a search result to reorient
1120         correctly to whole-mailbox message list.
1121    <LI> Fixed web alpine delete in view page to be sensitive to sort
1122    <LI> Fixed web alpine open of folder within directory from folder manager page.
1123    <LI> Fixed web alpine open of folder within directory from left column's recent cache.
1124    <LI> Fixed web alpine problems with spaces in special folder names like Drafts
1125    <LI> Fixed web alpine adding contacts from message list and view
1126    <LI> Fixed web alpine create of non-existent fcc
1127    <LI> Remove mistakenly left debugger statement in web alpine javascript.
1128    <LI> Some UNIX alpine build problems fixed
1129    <LI> Crash in pico and pilot when nl_langinfo returned something unrecognizable
1130         or NULL. Add recognition of "646" to nl_langinfo wrapper. This is returned
1131         by locale charmap call on some Solaris 8 systems.
1132    <LI> MacOS Keychain logins were not working correctly with generic host names, like
1133         imap.gmail.com, as opposed to specific instances like rx-in-209.google.com, causing
1134         new password requests when not needed
1135    <LI> Possible crash in WhereIs command while in FOLDER LIST when cursor is located on the
1136         last folder in the list
1137    <LI> Change to S/MIME get_x509_subject_email so that X509v3 alternative names are
1138         looked for along with the email address
1139    <LI> Changes to configure to get spellcheck options with work with arguments.
1140    <LI> Add change from Mark Crispin of panda.com to at least minimally handle non-ascii hostname
1141         returned by gethostname (iPhone can do this)
1142    <LI> Fixed a bug that prevents a filter that moves a message into a local folder
1143         from also setting the DELETE flag in that moved message. Fix from Eduardo Chappa.
1144    <LI> Changed size of shellpath in open_system_pipe from 32 to MAXPATH. Fix from
1145         Jake Scott of marganstanley.com.
1146    <LI> Buffer overflow bug in c-client's tmail/dmail, fix from Mark Crispin. This
1147         is not used in alpine.
1148    <LI> Imapd server crash from unguarded fs_give in IDLE code, fix from Crispin.
1149         Apparently this causes RIM Blackberry BIS service problems. This is not
1150         used in alpine.
1151    <LI> Tmail uninitialized pointer fix from Neil Hoggarth. Not used in alpine.
1152    <LI> Buffer overflow possibility in RFC822BUFFER routines in c-client library.
1153         Fix from Ludwig Nussel of SUSE and from Crispin.
1154    <LI> Include whole filename in export filename history
1155    <LI> Fix display bug in pico when Replace command is canceled. Fix from Eduardo Chappa.
1156 </UL>
1157
1158 <P>
1159 Version 2.00
1160 addressed bugs found in previous releases and had a few additions as well.
1161 <P>
1162 Additions included:
1163 <P>
1164
1165 <UL>
1166    <LI> Redesigned Web Alpine interface
1167    <LI> Experimental <A HREF="h_mainhelp_smime">S/MIME support</A> added
1168         in UNIX versions of Alpine
1169    <LI> Attempt to include the attachment filename as part of the name of the
1170         temporary file used when viewing an attachment with an external program.
1171         Add some randomness to that filename to make it hard to predict the filename.
1172         Add a filename extension, usually derived from the type/subtype, to the
1173         temporary filename. This was previously done only on Windows and MacOS X.
1174    <LI> Enhance address completion in the composer (TAB command) so that it looks
1175         through nicknames, fullnames, and addresses from the address book; addresses
1176         from the message being viewed, if any; and the results from
1177         <A HREF="h_direct_config">LDAP Directory Server</A>
1178         lookups for all of the defined directory servers that have the
1179         <A HREF="h_config_ldap_opts_impl">&quot;Use-Implicitly-From-Composer&quot;</A>
1180         feature set.
1181    <LI> Make the default character set setting more liberal in what it will accept
1182         from the UNIX nl_langinfo call and the various values of LANG seen in the wild
1183    <LI> Remove the Alpine revision number from the titlebar in released versions
1184         while leaving it there in snapshot versions
1185    <LI> Add a <A HREF="h_config_quell_asterisks">feature</A> to suppress the
1186         display of asterisks when you type a password for Alpine
1187    <LI> Add line wrapping when displaying <EM>PRE</EM> formatted sections of HTML
1188    <LI> When the
1189         <A HREF="h_config_dates_to_local"><!--#echo var="FEAT_convert-dates-to-localtime"--></A>
1190         feature is turned on convert not only the dates in the index screen but also
1191         the dates in the MESSAGE VIEW
1192 </UL>
1193
1194 <P>
1195 Bugs addressed in the 2.00 release included:
1196 <P>
1197
1198 <UL>
1199    <LI> Crash when using tab-completion for selecting a Save filename
1200    <LI> Make Web Alpine help text images relative for more portability
1201    <LI> Fixed attach save of html parts in Web Alpine
1202    <LI> Viewing, printing, exporting, replying, and bouncing of message
1203         digests was broken. Replying and bouncing should not have been
1204         allowed at all for digests. It would be nice to have a more standard
1205         index-like view of a message digest but that has not been addressed
1206         with this minor bug fix.
1207    <LI> Adjust wrapping of HTML messages so that the margins specified by
1208         <A HREF="h_config_viewer_margin_left"><!--#echo var="VAR_viewer-margin-left"--></A> and
1209         <A HREF="h_config_viewer_margin_right"><!--#echo var="VAR_viewer-margin-right"--></A>
1210         are observed correctly
1211    <LI> Interrupt of WhereIs command in index was broken
1212    <LI> The <A HREF="h_config_unk_char_set"><!--#echo var="VAR_unknown-character-set"--></A>
1213         option did not work correctly interpreting unknown characters in message headers
1214    <LI> Long address lines could cause blank continuation lines
1215    <LI> Save to a local default INBOX failed if the primary collection was also local,
1216         which it is by default. The save went to  ~/mail/inbox instead.
1217    <LI> Make a default save folder of &quot;inbox&quot; always mean the real
1218         inbox, not the inbox in the primary collection
1219    <LI> Address book entries with lots of addresses would be truncated when
1220         entered in the composer with a screen size wider than 270 or so characters
1221    <LI> Some fields in the index screen were truncated when the screen width was
1222         wider than 256 characters
1223    <LI> Crash when TABing to next folder, the next folder with new mail is a POP
1224         folder, and there is a more than 10 minute pause between typing the TAB
1225         and typing the Yes
1226 </UL>
1227
1228 <P>
1229 Version 1.10(962)
1230 addressed bugs found in previous releases and had a few additions as well.
1231 <P>
1232 Additions included:
1233 <P>
1234
1235 <UL>
1236    <LI> Add the possibility of setting a default role
1237         (see <A HREF="h_role_select">Roles Screen</A>)
1238         which may be convenient if your work flow involves acting in one
1239         role for a while then switching to another role and staying in the
1240         new role for another period of time
1241    <LI> When Saving and the IMAP server problem &quot;Message to save shrank!&quot;
1242         is encountered, ask the user if he or she wants to continue with the
1243         risky Save anyway instead of aborting. This may be helpful if your
1244         IMAP server is broken in this way but be aware that it is possible there
1245         was a real error instead of just a broken server implementation.
1246    <LI> Some configure adjustments for Kerberos detection and
1247         for SCO OpenServer 5 support
1248    <LI> Hide INBOX in a collection if it also appears as an
1249         <A HREF="h_config_enable_incoming">Incoming Folder</A>
1250    <LI> Show asterisks for feedback when the user is typing a password
1251    <LI> Performance improvement for threading of large folders
1252    <LI> Previously, the search used to find
1253         Pattern matches containing To patterns searched for both To
1254         and Resent-To headers. The relatively complicated search this
1255         produces causes problems when using some deficient IMAP servers.
1256         Now the default is to look only for To headers and ignore the
1257         presence of Resent-To. The previous behavior may be restored
1258         with the <A HREF="h_config_use_resentto"><!--#echo var="FEAT_use-resent-to-in-rules"--></A> feature.
1259    <LI> Add an
1260         <A HREF="h_config_unk_char_set"><!--#echo var="VAR_unknown-character-set"--></A>
1261         to help with reading malformed unlabeled messages
1262    <LI><A HREF="h_config_suppress_user_agent"><!--#echo var="FEAT_suppress-user-agent-when-sending"--></A> option added
1263    <LI> Map some Shift-LeftArrow escape sequences to LeftArrow
1264    <LI> Add feature <A HREF="h_config_warn_if_fcc_blank"><!--#echo var="FEAT_warn-if-blank-fcc"--></A>
1265 </UL>
1266
1267 <P>
1268 Bugs addressed in the 1.10(962) release included:
1269 <P>
1270
1271 <UL>
1272    <LI> Crash when encountering certain errors from an SMTP server
1273    <LI> Crash in composer caused by overflow in replace_pat()
1274    <LI> Hang when authenticating to an SMTP server that fails with a
1275         &quot;connection disconnected&quot; error
1276    <LI> Bug in handling of trailing tab character in flowed text
1277    <LI> Security enhancement for mailcap parameter substitution
1278    <LI> <A HREF="h_config_strip_sigdashes"><!--#echo var="FEAT_strip-from-sigdashes-on-reply"--></A>
1279         did not work if the message being replied to was not flowed text
1280         and <A HREF="h_config_quell_flowed_text"><!--#echo var="FEAT_quell-flowed-text"--></A>
1281         was not turned on
1282    <LI> Don't allow printer to be changed through hidden config screen
1283         if system administrator didn't want it to be allowed
1284    <LI> Attempts are sometimes made to set the Forwarded flag when alpine
1285         should know that it won't work, causing error messages to appear
1286    <LI> A <A HREF="h_config_reply_indent_string"><!--#echo var="VAR_reply-indent-string"--></A>
1287         of double-quote double-quote didn't work right
1288    <LI> Quoting wasn't being done to protect special characters from the
1289         MacOS X shell when
1290         <A HREF="h_config_browser"><!--#echo var="VAR_url-viewers"--></A>
1291         was not defined
1292    <LI> On MacOS X message attachments should be shown internally instead of
1293         being shown using the Mail application
1294    <LI> When replying to a message with a charset of X-UNKNOWN Alpine would
1295         sometimes set the outgoing charset to X-UNKNOWN, making the result
1296         unreadable
1297    <LI> When the sending of a message failed lines with leading spaces had one
1298         additional space inserted in each of those lines when the user
1299         was returned to the composer
1300    <LI> The <A HREF="h_index_cmd_whereis">WhereIs</A> command missed some index lines
1301         that contained non-ascii characters because it was truncating the
1302         line being searched so that it was shorter than what was visible on
1303         the screen
1304    <LI> When composing, an attachment with a long name that causes wrapping in
1305         just the wrong place would generate an error and cause the send
1306         of the attachment to fail
1307    <LI> After calling the file browser to attach a file in the composer, a resize
1308         of the window when back in the composer would redraw the last screen that
1309         had been shown in the browser instead of the current composer screen
1310    <LI> Possible crash in index screen when encountering unparsable addresses
1311         or when using one of the PRIORITY tokens or the HEADER token in the
1312         <a href="h_config_index_format"><!--#echo var="VAR_index-format"--></a>
1313    <LI> Problems with Header Color editing if the configuration option
1314         <a href="h_config_customhdr_color"><!--#echo var="VAR_viewer-hdr-colors"--></a>
1315         was inadvertently changed to the Empty Value in the hidden config screen
1316    <LI> When resuming the final postponed message from an Exchange server the user
1317         could get a certificate validation failure because alpine was trying
1318         to validate the canonical name of the folder instead of the name the
1319         user used
1320    <LI> Windows line endings in a mimetypes file on a Unix system cause a
1321         failure to find a match
1322    <LI> Make matching of extension names case independent in mimetypes files
1323    <LI> Windows dialog boxes for entering text were not working correctly
1324    <LI> Replying to or Forwarding multipart/alternative messages which had a
1325         single text/html part did not work well
1326    <LI> Printing the print confirmation page caused a crash
1327    <LI> A To line with a long, quoted personal name could display incorrectly
1328         if it was close to the same width as the screen
1329    <LI> When <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
1330         and <A HREF="h_config_incoming_checking_total"><!--#echo var="FEAT_incoming-checking-includes-total"--></A>
1331         are turned on hide (0/0) when the folder is empty
1332    <LI> Folder completion while Saving didn't work if the collection being
1333         saved to was the local home directory
1334 </UL>
1335
1336 <P>
1337 Version 1.00
1338 was an evolutionary release based on Pine, which was also
1339 developed at the University of Washington.
1340 It is upwards-compatible for existing Pine users.
1341
1342 <P>
1343 Changes included:
1344 <P>
1345 <UL>
1346    <LI> Ground-up reorganization of source code around addition
1347         of "pith/" core routine library.
1348    <LI> Fundamental improvement in Alpine's internal text handling, which
1349         is now based exclusively on Unicode. This allows displaying incoming
1350         messages and producing outgoing messages in many different languages.
1351    <LI> Ground-up reorganization of build and install procedures
1352         based on GNU Build System's autotools. NOTE, the included IMAP library
1353         build is not based on autotools, so some features will not work. However,
1354         it should get built automatically during the Alpine build process.
1355    <LI> Web-based version included built on TCL designed to run under
1356         a suitable CGI-supporting web server such as Apache.
1357 </UL>
1358
1359 <P>
1360
1361 Details on changes in previous (prerelease) versions of Alpine
1362 may be found at the following URL:
1363 <P>
1364 <CENTER><SAMP><A HREF="http://repo.or.cz/alpine.git">http://repo.or.cz/alpine.git</A></SAMP></CENTER>
1365 <P>
1366
1367 <HR WIDTH="75%"><P>
1368
1369 <H2>Getting Help</H2>
1370 <DL>
1371 <DT>Online Help</DT>
1372 <DD>
1373 Every Alpine screen and command has associated help text
1374 accessible via the &quot;?&quot; key (or Ctrl-G in text-input contexts).
1375 </DD>
1376
1377 <DT>Web Help</DT>
1378 <DD>
1379 The most current source of information about Alpine,
1380 including new version availability, is the web page at
1381 <P>
1382 <CENTER><SAMP><A HREF="http://repo.or.cz/alpine.git">http://repo.or.cz/alpine.git</A></SAMP></CENTER>
1383 </DD>
1384 </DL>
1385
1386 <HR WIDTH="75%"><P>
1387
1388 <H2>Additional Information</H2>
1389
1390 General Alpine configuration information can be found
1391 <A HREF="h_news_config">here</A>.
1392 <P>
1393 This is revision (<!--#echo var="ALPINE_REVISION"-->) of the Alpine software.
1394 Alpine mailbox and <A HREF="https://github.com/jonabbey/panda-imap/">IMAP</A> server
1395 access is provided by the IMAP Toolkit Environment (c-client library)
1396 version <!--#echo var="C_CLIENT_VERSION"-->.
1397 <P>
1398 Alpine was developed until 2009 by the Office of Computing
1399 &amp; Communications at the University of Washington in Seattle.
1400 Since then, the effort of developing Alpine has been continued by
1401 a community of volunteers who make good software even better!
1402
1403 <P>
1404 Alpine Copyright 2013-2020 Eduardo Chappa,
1405 <BR> Copyright 2006-2008 University of Washington.
1406
1407 <P>
1408 Additional legal notices can be found <A HREF="h_news_legal">here</A>,
1409 or instead you can find the Apache License, version 2.0 at the web URL:
1410
1411 <P>
1412 <CENTER><A HREF="http://www.apache.org/licenses/LICENSE-2.0">http://www.apache.org/licenses/LICENSE-2.0</A></CENTER>
1413
1414 <P>
1415 &lt;End of Release Notes&gt;
1416 </BODY>
1417 </HTML>
1418 ====== h_password_file_support ======
1419 <HTML>
1420 <HEAD>
1421 <TITLE>Encryption for Password File Support Explained</TITLE>
1422 </HEAD>
1423 <BODY>
1424 <H1>Encryption for Password File Support Explained</H1>
1425
1426 Index<BR>
1427 <OL>
1428 <LI><A HREF="#content">Explanation</A>
1429 <LI><A HREF="#example_existing_key">Example of Use of Existing Key and Certificate</A>
1430 <LI><A HREF="#example_self_signed">Example of Creating Master Password</A>
1431 </OL>
1432
1433 <P><A NAME="content">Unix Alpine Only.</A>
1434
1435 <P> If your version of Alpine has been built with password file support
1436 then you can use a special file to save your passwords, and avoid typing
1437 them every time you open a connection to a remote server.
1438
1439 <P> If, in addition, your version of Alpine was built with SMIME support, then your
1440 password file will be encrypted with a strong key. There are two ways in
1441 which this can happen: Alpine will either use a matching private key and
1442 public certificate pair that you already own, or it will create one for
1443 you, just for purposes of encrypting this file. We describe both processes
1444 below.
1445
1446 <P> Initially, Alpine will scan your public and private directories for a
1447 certificate/private key pair that works. Alpine will pick the first pair
1448 that it finds that matches.
1449
1450 <P> Once a pair has been chosen, it will be copied to the directory
1451 ~/.alpine-smime/.pwd, and from then on, Alpine will use the pair found in
1452 that directory. The first time this process is done, this directory will
1453 be created, a key/certificate pair will be copied to it, from then on
1454 this pair will be used to encrypt and decrypt your password file.
1455
1456 <P> If you want to use a specific key and certificate pair to encrypt
1457 your password file, you can create the directory ~/.alpine-smime/.pwd
1458 manually, and then create your preferred key/certificate pair there.
1459 Alpine will use this key regardless of if it has expired, or if it is
1460 self-signed. These issues do not affect the encryption or decryption
1461 of the password file.
1462
1463 <P> If you prefer not to use the directory ~/.alpine-smime/.pwd to save
1464 your key/certificate pair, you can specify a different one with the
1465 -pwdcertdir command line option in Alpine. If the directory specified by
1466 this option is not found Alpine will fail to encrypt and decrypt your
1467 password file. However if it exists, Alpine will search for a
1468 key/certificate pair in that
1469 directory, and if it does not find one, it will create one and save it
1470 in that directory.
1471
1472 <P> Alpine does not care about the names of the key and certificates in
1473 this directory, but the private key must have &quot;.key&quot; extension
1474 and your public certificate must have the &quot;.crt&quot; extension. The
1475 name of the private key will be used in the prompt when you are asked
1476 to unlock your key to decrypt your password.
1477
1478 <P> If Alpine cannot find a suitable private key and public certificate
1479 pair to encrypt your password, it will create one. You will be asked to
1480 create a &quot;Master Password&quot; to protect such key. At this moment
1481 there are no restrictions on passwords, other than they have to be at
1482 least 8 characters long, but future versions of Alpine will include
1483 functionality to restrict master passwords, as set up by the administrator
1484 of the system in the pine.conf.fixed file.
1485
1486 <P><A NAME="example_existing_key"><B>Example of Use of Existing Key and Certificate</B></A>
1487
1488 <P>Assume you have a private key called peter@address.com.key in your,
1489 ~/.alpine-smime/private directory, and a public certificate called
1490 peter@address.com.crt in your ~/.alpine-smime/public directory, and these
1491 are your only key/certificate pair.
1492
1493 <P> When Alpine starts for the first time, without command line options,
1494 it will check if the directory ~/.alpine-smime/.pwd exists, and if not,
1495 it will create it. Then it will go through your keys and certificates and
1496 find a pair that it can use, and copy the files peter@address.com.key,
1497 and peter@address.com.crt to the ~/.alpine-smime/.pwd directory. Alternatively
1498 you can do the same by copying these files by yourself. This can be done
1499 with the sequence of commands
1500
1501 <PRE>
1502 mkdir ~/.alpine-smime/.pwd
1503 cp ~/.alpine-smime/private/peter@address.com.key ~/.alpine-smime/.pwd
1504 cp ~/.alpine-smime/public/peter@address.com.crt ~/.alpine-smime/.pwd
1505 </PRE>
1506
1507 <P> When Alpine starts, you will be asked the password to unlock your
1508 private key with the prompt.
1509
1510 <PRE>
1511 Enter password of key &lt;peter@address.com&gt; to unlock password file:
1512 </PRE>
1513
1514 <P> If you prefer to use different names for your private and public keys
1515 in the ~/.alpine-smime/.pwd directory, you can do so, but you must
1516 preserve the extension of the files. For example, you can use the names
1517 private_key.key and public_cert.crt instead. In this case, the prompt you
1518 will see when you are asked to unlock your private key will read
1519
1520 <PRE>
1521 Enter password of key &lt;private_key&gt; to unlock password file:
1522 </PRE>
1523
1524 <P>Observe that you do not need to use an existing key/certificate pair,
1525 and that you can create a new private key/public certificate pair to
1526 encrypt and decrypt your password file. Alpine provides a mechanism to
1527 change the encryption key for this file in the S/MIME configuration
1528 screen.
1529
1530 <P><A NAME="example_self_signed"><B>Example of Creating Master Password</B></A>
1531
1532 <P> If Alpine cannot find a suitable private key and public certificate pair
1533 to encrypt your password file, it will create one. When doing so, it will
1534 start the process with the following warning:
1535
1536 <PRE>
1537 Creating a Master Password for your Password file.
1538 </PRE>
1539
1540 <P> Then Alpine will ask you to enter your Master Password:
1541
1542 <PRE>
1543 Create master password (attempt 1 of 3):
1544 </PRE>
1545
1546 <P> Once you enter this password, and it validates according to system policy,
1547 you will be asked to confirm this password.
1548
1549 <PRE>
1550 Confirm master password (attempt 1 of 3):
1551 </PRE>
1552
1553 <P> If you input the same password, then Alpine will set that as your
1554 Master Password, and you will use this password to unlock your key in the
1555 future.
1556
1557 <P> If you would like to switch your Master Password in the future, you can
1558 do so by creating a new public key and public certificate pair. You can do
1559 so in the S/MIME configuration screen, in the &quot;Manage Key and
1560 Certificate for Password File&quot; section, simply enter your current
1561 password to unlock your current key and then press &quot;C&quot; to create
1562 a new key.
1563
1564 <P>
1565 &lt;End of help&gt;
1566 </BODY>
1567 </HTML>
1568 ====== h_network_encryption_security ======
1569 <HTML>
1570 <HEAD>
1571 <TITLE>Network Encryption Security Explained</TITLE>
1572 </HEAD>
1573 <BODY>
1574 <H1>Network Encryption Security Explained</H1>
1575
1576 You can specify which encryption protocol you would like to try when
1577 creating a secure connection to a server. Alpine will attempt to use
1578 that encryption protocol, but in practice the protocol being used will
1579 default to the most secure protocol that both Alpine and the server
1580 support.
1581
1582 <P> If you use the latest version of OpenSSL, the /ssl modifier to the
1583 server definition will use the most secure version of the TLS encryption
1584 protocol. The same will be true if you try /tls1_1 or /tls1_2, but in an
1585 old version of OpenSSL (pre 1.1.0 series) /tls1_1 might mean to use
1586 version 1.1 of the TLS protocol.
1587
1588 <P> You will never go wrong by using the /ssl modifier. At the time of
1589 this writing OpenSSL had released version 1.1.1, with support for
1590 TLS version 1.3. If your version of OpenSSL does not support this version
1591 of the TLS protocol, then the /tls1_3 modifier will only mean to use
1592 the most secure version of the TLS protocol that OpenSSL and the
1593 server can negotiate. In future versions of OpenSSL, /tls1_3 might mean
1594 to try to negotiate a higher version of the TLS protocol.
1595
1596 <P> In order to avoid confusion, the /ssl flag is the best way to guarantee
1597 the highest encryption protocol available, and it is the recommended
1598 modifier to the server definition to create a secure encrypted connection.
1599
1600 <P>
1601 &lt;End of help&gt;
1602 </BODY>
1603 </HTML>
1604 ====== h_xoauth2 ======
1605 <HTML>
1606 <HEAD>
1607 <TITLE>XOAUTH2 Authenticator Explained</TITLE>
1608 </HEAD>
1609 <BODY>
1610 <H1>XOAUTH2 Authenticator Explained</H1>
1611
1612 The XOAUTH2 authenticator method is a way in which you can sign in to your
1613 account to read and send email. This method is different from the traditional
1614 username/password that users are accostumed to, and it needs to be set up
1615 by the user. This text will help you understand this authentication method.
1616
1617 <P>
1618 The most important difference between this method and other authentication
1619 methods is what happens if someone steals your credentials. This method is
1620 attached to three components: Your username, your password and your email
1621 program.
1622
1623 <P>
1624 At the beginning of this process, the developer of the email program
1625 registers the email program with the email service provider (Gmail,
1626 Outlook, etc.) In return, the email service provider creates a client-id.
1627 In addition, some services provice a client-secret.
1628 Since Alpine is an open source program, these values are part
1629 of the source code, and are known to everyone, and cannot be obfuscated.
1630
1631 <P>
1632 After a program has been registered with an email service provider, the
1633 user must authorize the email program access to their email account in
1634 that service. Alpine helps you do that, but it cannot do all the process
1635 for you, and you will need to use an external web browser to authorize
1636 Alpine to read and send email.
1637
1638 <P>
1639 This part of the process is simple. Alpine creates a URL based on the id
1640 and secret created by the email service, which the user opens. Once the
1641 URL has been opened, the user signs in to the server, and once signed into
1642 the account, the user is asked to authorize Alpine access to the email
1643 account. If the user agrees, an &quot;<I>Access Code</I>&quot; will be
1644 generated.
1645
1646 <P>
1647 An Access Code is a very long string, and so the recommendation is to copy
1648 and paste this code back into Alpine, at the time Alpine is helping you
1649 set up this authenticator. This part of the process is done only once per
1650 email program (If you run Alpine in several computers, you would do this
1651 once per computer. Each computer gets its own Access Code.)
1652
1653 <P>
1654 Once Alpine has an Access Code, it goes back internally to the email
1655 service and asks it to generate two strings, called the &quot;<I>Refresh
1656 Token</I>&quot; and the &quot;<I>Access Token</I>&quot;. This part is
1657 invisible to the user, and they will never see it, but in order for you to
1658 understand what to do in case you lose them, you need to understand their
1659 use.
1660
1661 <P>
1662 The <I>Access Token</I> is the equivalent of a temporary password. It
1663 allows the user to access (and reaccess as many times as they would like)
1664 their email account for a limited amount of time, typically 1 hour after
1665 it was issued. After that time expires, users need a new Access Token.
1666
1667 <P>
1668 The <I>Refresh Token</I> is the equivalent of a password generator. With
1669 this token, Alpine can go to the email service provider and request a new
1670 Access Token. This part of the process does not need user intervention,
1671 anyone can do this, as long as they have the Refresh Token, program id and
1672 program secret, so it is important that users keep their Refresh Token as
1673 secure as they can.
1674
1675 <P>
1676 Given that the Refresh Token and the Access Token are long strings, users
1677 are not supposed to be able to memorize them and recall them later. Alpine
1678 will store them in the password file, should a user have one. Otherwise,
1679 the user will have to create one each time they run Alpine, starting by
1680 creating the Access Code all over each time they try to sign in to their
1681 email account. When Alpine is compiled with SSL and password file support,
1682 it will default to saving this information using encryption and under a
1683 master password, so unless they have made changes to this process, their
1684 Refresh and Access Tokens are saved securely and persist from one session
1685 to the next.
1686
1687 <P>
1688 Should any person steal your Refresh Token, you must login to your account
1689 with your username and password and revoke Alpine authorization to your
1690 account. This is enough to stop the person who stole your Refresh Token
1691 from accessing your email service. In the case of Gmail, changing your
1692 password will invalidate your Refresh Token, and this will be enough to
1693 prevent others from using a stolen Refresh Token. Consult with your email
1694 service provider to learn what you can do if someone steals your Refresh
1695 Token.
1696
1697 <P>
1698 If, for any reason, Alpine cannot sign in to your email service for two
1699 consecutive times with Access Codes generated by your Refresh Token, it
1700 will remove the Refresh Token from your password file, forcing you to get
1701 a new one, by getting an Access Code first, and granting authorization to
1702 Alpine to access your email once again.
1703
1704 <P>
1705 This implementation of XOAUTH2 knows the list of servers that it can
1706 access using the same credentials, so Alpine will be able to read and send
1707 emails using the same Access Token. You will not have to create
1708 Access and Refresh Tokens for the IMAP and SMTP servers separately.
1709
1710 <P>
1711 &lt;End of help&gt;
1712 </BODY>
1713 </HTML>
1714 ====== h_tls_failure_details ======
1715 <HTML>
1716 <HEAD>
1717 <TITLE>Certificate Validation Details</TITLE>
1718 </HEAD>
1719 <BODY>
1720 <H1>Certificate Validation Details</H1>
1721
1722 This screen gives details as to why the certificate validation failed: the
1723 name of the desired server system; the reason for failure; and the name on
1724 the certificate.  This is primarily of interest to experts.
1725
1726 <P>
1727 &lt;End of help&gt;
1728 </BODY>
1729 </HTML>
1730 ====== h_tls_failure ======
1731 <HTML>
1732 <HEAD>
1733 <TITLE>TLS or SSL Failure</TITLE>
1734 </HEAD>
1735 <BODY>
1736 <H1>TLS or SSL Failure</H1>
1737
1738 An attempt was made to establish a secure, encrypted connection to the
1739 server system using either Transport Layer Security (TLS) or the older
1740 Secure Sockets Layer (SSL).  This attempt failed.
1741
1742 <P>
1743 You should contact your server system management for more assistance.
1744 The problem is probably at the server system and not in Alpine or your local
1745 system.  The text in this screen may be helpful for the server system
1746 management in debugging the problem,
1747
1748 <P>
1749 &lt;End of help&gt;
1750 </BODY>
1751 </HTML>
1752 ====== h_tls_validation_failure ======
1753 <HTML>
1754 <HEAD>
1755 <TITLE>TLS and SSL Certificate Validation Failures</TITLE>
1756 </HEAD>
1757 <BODY>
1758 <H1>TLS and SSL Certificate Validation Failures</H1>
1759
1760 An attempt was made to establish a secure, encrypted connection to the
1761 server system using either Transport Layer Security (TLS) or the older
1762 Secure Sockets Layer (SSL).
1763
1764 <P>
1765 An important part of this procedure is server certificate validation.  A
1766 server certificate is an &quot;electronic identification card&quot; for the server
1767 system that is signed by a well-known certificate authority (CA).  Alpine
1768 compares the server system identity in the server certificate with the
1769 name of the server system to which it is trying to connect.  Alpine also
1770 verifies that the CA signature is authentic.
1771
1772 <P>
1773 Some common failure conditions are:
1774 <P>
1775
1776 <UL>
1777   <LI> [UNIX Alpine] Self signed certificate.  This means that the server system
1778 signed its own certificate.  This does not necessarily indicate anything
1779 bad; the server operators may simply have elected to not purchase a
1780 signed certificate from a certificate authority.
1781
1782   <LI> [UNIX Alpine] Unable to get local issuer certificate.  This means that
1783 the signature on the server system is from an unknown certificate authority.
1784 It can also mean that no certificate authority certificates have been
1785 installed on the local UNIX system.
1786
1787   <LI> [PC Alpine] Self-signed certificate or untrusted authority.  This is
1788 the same as either of the above two conditions in UNIX Alpine.  Note that
1789 Windows systems typically have a full set of certificate authority
1790 certificates installed, so it is more likely to be a self-signed
1791 certificate than an unknown certificate authority.
1792
1793   <LI> Server name does not match certificate.  This means that the server
1794 presented a proper signed certificate for a name other than the desired
1795 name.
1796 </UL>
1797
1798 <P>
1799 Any of these conditions can indicate that you are being attacked and have
1800 been directed to an imposter server that will record your password and
1801 your private mail messages.  It can also mean something innocuous.
1802
1803 <P>
1804 If you are certain that the problem is innocuous, you can append the
1805 option
1806
1807 <P>
1808 <CENTER><SAMP>/novalidate-cert</SAMP></CENTER>
1809 <P>
1810
1811 to the server system name where it appears in your configuration (e.g. the
1812 <A HREF="h_config_inbox_path"><!--#echo var="VAR_inbox-path"--></A>,
1813 a folder-collection, or a news or SMTP server).  This will
1814 disable certificate validation.  On the other hand, if you are attacked,
1815 you will get no warning if you do this.
1816
1817 <P> When you get an error indicating a self-signed certificate from the
1818 remote server, you can download and install the certificate for that
1819 server. Avoid using the /NoValidate-Cert modifier. Alpine cannot help you
1820 with this process because certificates are part of the system and are not
1821 under the control of the user. Find directions on how to download and
1822 install certificates for your system using your favorite search engine.
1823
1824 <P>
1825 &lt;End of Cert Validation Failures help&gt;
1826 </BODY>
1827 </HTML>
1828 ====== h_oauth2_start ======
1829 <HTML>
1830 <HEAD>
1831 <TITLE>Setting up XOAUTH2 Authentication</TITLE>
1832 </HEAD>
1833 <BODY>
1834 <H1>Setting up XOAUTH2 Authentication</H1>
1835
1836 You are trying to connect to a server that uses the XOAUTH2 method of
1837 authentication.
1838
1839 <P>
1840 In order to set this up, you need to authenticate in the target server
1841 and authorize Alpine to access your email account.
1842
1843 <P>
1844 After you have authorized Alpine, the server will generate an
1845 &quot;access code.&quot; In order to use this code, press 'C'
1846 and copy and paste this code back into Alpine.
1847
1848 <P>
1849 After you have input the code, Alpine will conclude logging you into your
1850 account.
1851
1852 <P>
1853 &lt;End of setting up XOAUTH2 Authentication help&gt;
1854 </BODY>
1855 </HTML>
1856 ====== h_release_tlscerts ======
1857 <HTML>
1858 <HEAD>
1859 <TITLE>TLS and SSL usage note</TITLE>
1860 </HEAD>
1861 <BODY>
1862 <H1>TLS and SSL usage note</H1>
1863
1864 <P>
1865 When using Alpine from Unix or Windows 2000,
1866 server certificates must be signed by a trusted certificate authority.
1867 You may relax this requirement (at the cost of some security) by using
1868 the
1869 <A HREF="h_folder_server_syntax">NoValidate-Cert</A>
1870 modifier in the mailbox name.
1871
1872 <P>
1873 <CENTER><SAMP>{foo.example.com/novalidate-cert}INBOX</SAMP></CENTER>
1874 <P>
1875
1876 The fully-qualified host name of the server should be used
1877 so that it matches the host name in the server certificate.
1878 <P>
1879 Here is an example of a host specification that directs Alpine to use
1880 the SSL port (993) and an encrypted data stream.
1881 <P>
1882 <CENTER><SAMP>{foo.example.com/ssl}INBOX</SAMP></CENTER>
1883 <P>
1884 &lt;End of TLS usage help&gt;
1885 </BODY>
1886 </HTML>
1887 ====== h_news_config ======
1888 <HTML>
1889 <HEAD>
1890 <TITLE>Alpine Configuration</TITLE>
1891 </HEAD>
1892 <BODY>
1893 <H1>Alpine Configuration</H1>
1894
1895 <H2>Using Environment Variables</H2>
1896
1897 The values of Alpine configuration options may include environment variables
1898 that are replaced by the value of the variable at the time Alpine is run
1899 (and also at the time the config option is changed).
1900 The syntax to use environment variables is a subset of the common Unix
1901 shell dollar-syntax.
1902 For example, if
1903
1904 <P><CENTER><SAMP>$VAR</SAMP></CENTER><P>
1905
1906 appears in the value of an Alpine configuration option it is looked up in the
1907 envirom ent (using getenv(&quot;VAR&quot;)) and its
1908 looked-up value replaces the <SAMP>$VAR</SAMP> part of the option value.
1909 To include a literal dollar sign you may precede the dollar sign with another
1910 dollar sign.
1911 In other words, if the text
1912
1913 <P><CENTER><SAMP>$$text</SAMP></CENTER><P>
1914
1915 is the value of a configuration option, it will be expanded to
1916
1917 <P><CENTER><SAMP>$text</SAMP></CENTER><P>
1918
1919 and no environment lookup will be done.
1920 For Unix Alpine it will also work to use a backslash character to
1921 escape the special meaning of the dollar sign, but $$ is preferable since
1922 it works for both PC-Alpine and Unix Alpine, allowing the configuration option
1923 to be in a shared configuration file.
1924 <P>
1925
1926 This all sounds more complicated than it actually is.
1927 An example may make it clearer.
1928 Unfortunately, the way in which environment variables are set is OS-dependent
1929 and command shell-dependent.
1930 In some Unix command shells you may use
1931
1932 <P><CENTER><SAMP>PERSNAME="Fred Flintstone"</SAMP></CENTER><P>
1933    <CENTER><SAMP>export PERSNAME</SAMP></CENTER><P>
1934
1935 Now, if you use Alpine's Setup/Config screen to set
1936
1937 <P><CENTER><SAMP><!--#echo var="VAR_personal-name"-->=$PERSNAME</SAMP></CENTER><P>
1938
1939 the <SAMP>$PERSNAME</SAMP> would be replaced by <SAMP>Fred Flintstone</SAMP>
1940 so that this would be equivalent to
1941
1942 <P><CENTER><SAMP><!--#echo var="VAR_personal-name"-->=Fred Flintstone</SAMP></CENTER><P>
1943
1944 Note, environment variable substitution happens after configuration
1945 options that are lists are split into the separate elements of the list,
1946 so a single environment variable can't contain a list of values.
1947
1948 <P>
1949 The environment variable doesn't have to be the only thing
1950 after the equal sign.
1951 However, if the name of the variable is not at the end of the line or
1952 followed by a space (so that you can tell where the variable name ends),
1953 it must be enclosed in curly braces like
1954
1955 <P><CENTER><SAMP>${VAR}</SAMP></CENTER><P>
1956
1957 It is always ok to use the braces even if you don't need to.
1958 <P>
1959 It is also possible to set a default value for an environment variable.
1960 This default value will be used if the environment variable is not
1961 set (that is, if getenv(&quot;VAR&quot;) returns NULL).
1962 The syntax used to set a default value is
1963
1964 <P><CENTER><SAMP>${VAR:-default value}</SAMP></CENTER><P>
1965
1966 If the config file contains
1967
1968 <P><CENTER><SAMP>personal-name=${VAR:-Fred Flintstone}</SAMP></CENTER><P>
1969
1970 then when Alpine is run <SAMP>VAR</SAMP> will be looked up in the environment.
1971 If <SAMP>VAR</SAMP> is found then <SAMP>personal-name</SAMP> will have
1972 the value that <SAMP>VAR</SAMP> was set to, otherwise,
1973 <SAMP>personal-name</SAMP> will be set to <SAMP>Fred Flintstone</SAMP>,
1974 the default value.
1975 (Note that the variable is called &quot;personal-name&quot; in the config
1976 file but is displayed in the config screen as
1977 &quot;<!--#echo var="VAR_personal-name"-->&quot;.
1978 In general, the value that goes into a config file is never exactly the
1979 same as the value you see on the screen.)
1980
1981 <P>
1982 An example where an environment variable might be useful is the
1983 variable <SAMP>Inbox-Path</SAMP> in the global configuration file.
1984 Suppose most users used the server
1985
1986 <P><CENTER><SAMP>imapserver.example.com</SAMP></CENTER><P>
1987
1988 but that there were some exceptions who used
1989
1990 <P><CENTER><SAMP>altimapserver.example.com</SAMP></CENTER><P>
1991
1992 In this case, the system manager might include the following line in
1993 the systemwide default Alpine configuration file
1994
1995 <P><CENTER><SAMP>Inbox-Path=${IMAPSERVER:-imapserver.example.com}</SAMP></CENTER><P>
1996
1997 For the exceptional users adding
1998
1999 <P><CENTER><SAMP>IMAPSERVER=altimapserver.example.com</SAMP></CENTER><P>
2000
2001 to their environment should work.
2002 <P>
2003 Another example might be the case where a user has to use a different
2004 SMTP server from work and from home.
2005 The setup might be something as simple as
2006
2007 <P><CENTER><SAMP>smtp-server=$SMTP</SAMP></CENTER><P>
2008
2009 or perhaps a default value could be given.
2010 Note that, as mentioned above, the variable <SAMP>SMTP</SAMP> cannot contain
2011 a list of SMTP servers.
2012 <P>
2013
2014 <H2>Configuration precedence</H2>
2015
2016 There are several levels of Alpine configuration.  Configuration values at
2017 a given level override corresponding values at lower levels.  In order of
2018 increasing precedence:
2019 <P>
2020 <UL>
2021  <LI> built-in defaults
2022  <LI> system-wide
2023 <!--chtml if pinemode="os_windows"-->
2024       config file from command line or provided
2025       by "PINECONF" environment variable
2026 <!--chtml else-->
2027       pine.conf file
2028 <!--chtml endif-->
2029  <LI> personal configuration file
2030  <LI> personal exceptions configuration file
2031  <LI> command-line options
2032  <!--chtml if pinemode="os_windows"--><!--chtml else-->
2033  <LI> system-wide pine.conf.fixed file<!--chtml endif-->
2034 </UL>
2035 <P>
2036 The values in both the personal configuration file and the
2037 <A HREF="h_config_exceptions">exceptions</A>
2038 configuration file may be set using the Setup command.
2039 Setup/Config is the command to change most of the personal configuration
2040 options.
2041 The other Setup subcommands are also used to change the configuration,
2042 for example, Setup/AddressBook, Setup/Rules, and so on.
2043 Changing the personal exceptions configuration is very similar.
2044 To change a value in the Config screen you would use the command
2045 Setup/eXceptions/Config.
2046 Likewise for the other Setup subcommands (Setup/eXceptions/Rules and so on).
2047 <P>
2048 There are a couple exceptions to the rule that configuration values are replaced
2049 by the value of the same option in a higher-precedence file.
2050 The Feature-List variable has values that are additive, but can be
2051 negated by prepending &quot;no-&quot; in front of an individual feature name.
2052 So for features, each individual feature's value is replaced by the value
2053 of the same feature in a higher-precedence file.
2054 Note that this is done automatically for you when you change these values via
2055 the Setup/Config command.
2056 The other exception to the <EM>replace</EM> semantics happens when you
2057 use <A HREF="h_config_inheritance">configuration inheritance</A>
2058 for option lists.
2059 <P>
2060
2061 <H2>File name defaults</H2>
2062
2063 Notes:<P>
2064
2065 <BR> &lt;exe dir&gt; = directory where pine.exe found.
2066 <BR> &lt;pinerc dir&gt; = directory where pinerc found.
2067 <BR> # = default file name is overridable in pinerc.
2068 <BR> $HOME, if not explicitly set, defaults to root of the current drive.
2069 <BR> $MAILCAPS, if set, is used in lieu of the default mailcap search paths.
2070 <BR> + between the mailcap paths implies that the two files are combined.
2071 <BR> ; between other default paths implies that the first one found is used.
2072 </P>
2073 Alpine looks for most support files in the same directory it finds its
2074 personal configuration file (pinerc).  The -p command-line flag may be
2075 used to specify a particular path name for the pinerc file.  If a
2076 pinerc file does not exist, it will be created (if directory permissions
2077 allow).  In PC-Alpine, if -p or $PINERC are not defined, Alpine will look
2078 in $HOME&#92;PINE and the directory containing the PINE.EXE.  If a PINERC
2079 file does not exist in either one, it will create one in the first of those
2080 two directories that is writable.  In detail:
2081 <PRE>
2082
2083 PC-Alpine:
2084
2085  executable     &lt;DOS search path&gt;&#92;pine.exe
2086  help index     &lt;exe dir&gt;&#92;pine.ndx
2087  help text      &lt;exe dir&gt;&#92;pine.hlp
2088
2089  pers config    $PINERC  ;  $HOME&#92;pine&#92;PINERC  ;  &lt;exe dir&gt;&#92;PINERC
2090  except config  $PINERCEX ; $HOME&#92;pine&#92;PINERCEX  ;  &lt;exe dir&gt;&#92;PINERCEX
2091  global cfg     $PINECONF
2092
2093  debug          &lt;pinerc dir&gt;&#92;pinedebg.txtN
2094  crash          &lt;pinerc dir&gt;&#92;pinecrsh.txt
2095  signature#     &lt;pinerc dir&gt;&#92;pine.sig
2096  addressbook#   &lt;pinerc dir&gt;&#92;addrbook
2097  mailcap#       &lt;pinerc dir&gt;&#92;mailcap  +  &lt;exe dir&gt;&#92;mailcap
2098  mimetypes#     &lt;pinerc dir&gt;&#92;mimetype +  &lt;exe dir&gt;&#92;mimetype
2099  newsrc#        $HOME&#92;newsrc (if exists, else) &lt;pinerc dir&gt;&#92;newsrc
2100  sentmail#      $HOME&#92;mail&#92;sentmail.mtx
2101  postponed#     $HOME&#92;mail&#92;postpond.mtx
2102  interrupted    $HOME&#92;mail&#92;intruptd
2103
2104 Unix Alpine:
2105
2106  executable     &lt;Unix search path&gt;/pine
2107  persnl cfg     ~/.pinerc
2108  except cfg     ~/.pinercex
2109  global cfg     <!--#echo var="PINE_CONF_PATH"-->
2110  fixed cfg      <!--#echo var="PINE_CONF_FIXED_PATH"-->
2111  local help     <!--#echo var="PINE_INFO_PATH"-->
2112
2113  interrupted    ~/.pine-interrupted-mail
2114  debug          ~/.pine-debugN
2115  crash          ~/.pine-crash
2116  newsrc#        ~/.newsrc
2117  signature#     &lt;pinerc dir&gt;/.signature
2118  addressbook#   &lt;pinerc dir&gt;/.addressbook
2119  postponed#     ~/mail/postponed-msgs
2120  sentmail#      ~/mail/sent-mail
2121  mailcap#       ~/.mailcap + /etc/mailcap
2122                            + /usr/etc/mailcap + /usr/local/etc/mailcap
2123  mimetypes#     ~/.mime.types + /etc/mime.types + /usr/local/lib/mime.types
2124
2125  news-spool     varies across Unix flavors, e.g. /var/spool/news or /usr/spool/news
2126  active-news    varies across Unix flavors, e.g. /usr/lib/news/active
2127  lock files     /tmp/.<!--#echo var="MAIL_SPOOL_LOCK_PATH"-->
2128  inbox          <!--#echo var="MAIL_SPOOL_PATH"-->
2129  password       /etc/passwd
2130
2131 Unix Alpine and PC-Alpine:
2132
2133  .ab*           remote addressbook support files
2134  a[1-9]*        temporary (while Alpine is running) addressbook files
2135
2136 </PRE>
2137 <P>
2138
2139 <H2>Mailcap files</H2>
2140
2141 Alpine honors the mailcap configuration system for specifying external
2142 programs for handling attachments.  The mailcap file maps MIME attachment
2143 types to the external programs loaded on your system that can display
2144 and/or print the file.  A sample mailcap file comes bundled with the Alpine
2145 distribution.  It includes comments that explain the syntax you need to
2146 use for mailcap.  With the mailcap file, any program (mail readers,
2147 newsreaders, WWW clients) can use the same configuration for handling
2148 MIME-encoded data.
2149 <P>
2150
2151 <H2>MIME-Types files</H2>
2152
2153 Alpine uses mime-types files (.mime.types or MIMETYPE) to determine
2154 what Content-Type to use for labeling an attached file, based on
2155 the file extension.  That is, this file provides a mapping between
2156 filename extensions and MIME content-types.
2157 <P>
2158
2159 <H2>Environment variables</H2>
2160
2161 PC-Alpine uses the following environment variables:
2162 <DL>
2163 <DT>PINERC</DT>
2164 <DD>Optional path to pinerc file.</DD>
2165 <DT>PINERCEX</DT>
2166 <DD>Optional path to personal exceptions configuration file.</DD>
2167 <DT>PINECONF</DT>
2168 <DD>Optional path to global pine config file.</DD>
2169 <DT>HOME</DT>
2170 <DT>TMPDIR, TMP, or TEMP</DT>
2171 <DT>COMSPEC</DT>
2172 <DT>MAILCAPS</DT>
2173 <DD>A <B>semicolon</B> delimited list of path names to mailcap files.</DD>
2174 <DT>USER_DICTIONARY</DT>
2175 <DD>Used to specify the file to contain the user's spell check
2176 dictionary.  The default is <SAMP>DICT.U</SAMP> in the same
2177 directory as the <SAMP>SPELL32.DLL</SAMP></DD>
2178 </DL>
2179
2180 Unix Alpine uses the following environment variables:
2181 <DL>
2182 <DT>TERM</DT>
2183 <DD>Tells Alpine what kind of terminal is being used.</DD>
2184 <DT>DISPLAY</DT>
2185 <DD>Determines if Alpine will try to display IMAGE attachments.</DD>
2186 <DT>SHELL</DT>
2187 <DD>If not set, default is &quot;/bin/sh&quot;.</DD>
2188 <DT>TMPDIR, TMP, or TEMP</DT>
2189 <DT>MAILCAPS</DT>
2190 <DD>A <B>colon</B> delimited list of path names to mailcap files.</DD>
2191 </DL>
2192 <!--chtml if pinemode="os_windows"-->
2193 <P>
2194 <H2>Common PC-Alpine Configuration Problems</H2>
2195
2196 <H3>Configuration settings aren't being saved</H3>
2197
2198 <P>This problem can happen if you run pine from one directory and
2199 then decide to move your pine directory to another location.  PC-Alpine
2200 stores certain variables, including the configuration location, in the
2201 Windows Registry (which you shouldn't ever need to manually edit).  There
2202 are a couple of ways to go about removing or resetting the values in the
2203 registry.
2204
2205 <P>
2206 1) Run PC-Alpine's registry value deletion command.  This can be done by
2207 running: &quot;&lt;your&nbsp;pine&nbsp;directory&gt;&#92;pine.exe&nbsp;-registry&nbsp;clear&quot; from the DOS
2208 prompt. You could create a shortcut to pine.exe and change the &quot;Target&quot;
2209 value to the above command.
2210
2211 <P>
2212 2) Tell PC-Alpine where to look for the configuration file.  Configuration
2213 information is stored in a file called the PINERC.  With the &quot;-p&nbsp;PINERC&quot;
2214 option, you can tell PC-Alpine the location of your pinerc.  An example of
2215 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;.
2216 Again, you can use the DOS prompt or the shortcut method explained in (1).
2217
2218 <P>
2219 Additionally, there is the &quot;-registry&nbsp;set&quot; option, which will actively
2220 set registry values to the current setting, and is therefore useful with
2221 the &quot;-p&nbsp;PINERC&quot; option.
2222
2223 <!--chtml endif-->
2224 <P>
2225 &lt;End of Configuration Notes&gt;
2226 </BODY>
2227 </HTML>
2228 ====== h_news_legal ======
2229 <html>
2230 <head>
2231 <TITLE>Alpine Legal Notices</TITLE>
2232 </head>
2233 <body>
2234
2235 <H1>Alpine Legal Notices</H1>
2236
2237 Alpine and its constituent programs are covered by the Apache License Version 2.0.
2238
2239
2240 <P>
2241 &lt;End of Alpine Legal Notices&gt;
2242 </BODY>
2243 </HTML>
2244 ===== h_info_on_mbox =====
2245 <HTML>
2246 <HEAD>
2247 <TITLE>Information on mbox driver</TITLE>
2248 </HEAD>
2249 <BODY>
2250 <H1>Information on &quot;Missing Mail&quot; and the &quot;mbox&quot; driver</H1>
2251
2252 Beginning with Pine 4.00 (Pine came before Alpine)
2253 a new INBOX access method is
2254 available as part of the standard configuration.  It is called the
2255 &quot;mbox&quot; driver and it works like this:<P>
2256
2257 <P>
2258 <BLOCKQUOTE>
2259 If the file &quot;mbox&quot; exists in the user's home directory, and
2260 is in Unix mailbox format, then when INBOX is opened this file will be
2261 selected as INBOX instead of the mail spool file.  Messages will be
2262 automatically transferred from the mail spool file into the mbox
2263 file.
2264 </BLOCKQUOTE>
2265
2266 <P>
2267 The advantage of this method is that, after new mail has been copied
2268 from the system mail spool, all subsequent access is confined to the
2269 user's home directory, which is desirable on some systems.  However, a
2270 possible disadvantage is that mail tools other than those from the
2271 University of Washington will not know to look for mail in the user's
2272 mbox file.  For example, POP or IMAP servers other than those from the
2273 University of Washington, and many &quot;new mail notification&quot;
2274 programs may not work as expected with this driver enabled.<P>
2275
2276 To disable this behavior, either remove/rename the &quot;mbox&quot;
2277 file or find the <A HREF="h_config_disable_drivers"><!--#echo var="VAR_disable-these-drivers"--></A>
2278 option in Setup/Config
2279 and add &quot;mbox&quot; to it:
2280 <P>
2281 <CENTER><SAMP><!--#echo var="VAR_disable-these-drivers"-->=mbox</SAMP></CENTER>
2282 <P>
2283 &lt;End of help on this topic&gt;
2284 </BODY>
2285 </HTML>
2286 ===== h_info_on_locking =====
2287 <HTML>
2288 <HEAD>
2289 <TITLE>FAQs on Alpine Locking</TITLE>
2290 </HEAD>
2291 <BODY>
2292 <H1>What Systems Managers Need to Know about Alpine File Locking</H1>
2293
2294 There is an extensive section on locking in the Alpine technical notes;
2295 this information is intended to provide answers to some common questions:<P>
2296 <OL>
2297 <LI> Why did locking change in Pine 4.00?<BR>
2298 The actual locking mechanisms did not change in 4.00.
2299 What changed is that when one particular locking mechanism used by Alpine
2300 fails, Alpine now issues a warning message.  Prior to Pine 4.00, the locking
2301 failure would occur, but no warning was issued.<P>
2302
2303 <LI> Is this what the &quot;Mailbox vulnerable&quot; message is about?<BR>
2304 Yes.  It means that Alpine was unable to create a lockfile in the
2305 spool directory, generally because of overly restrictive protections on the
2306 spool directory.  The correct permissions on the spool directory for
2307 running Alpine are 1777, i.e. read-write-execute permission for everyone,
2308 with the sticky-bit set, so only owners of a file can delete them.<P>
2309
2310 <LI> Why does Alpine require that the mail spool directory have 1777
2311    protections?<BR>
2312 Alpine was designed to run without special privileges.  This means that in
2313 order to create a lockfile in the spool directory, it is necessary to have
2314 the spool directory permissions be world-writable.<P>
2315
2316 <LI> Can't you create the lockfile somewhere else?<BR>
2317 No.  The lockfile in question must be in the mail spool directory, because
2318 that's where the mail delivery program expects to find it, and the purpose
2319 of the file is to coordinate access between the mail client (Alpine) and the
2320 mail delivery program.<P>
2321
2322 <LI> Isn't having the spool directory world-writable a big security risk?<BR>
2323 No.  Remember that the individual mail files in the spool directory are
2324 NOT world-writable, only the containing directory.  Setting the &quot;sticky
2325 bit&quot; -- indicated by the &quot;1&quot; before the &quot;777&quot; mode
2326 -- means that only the owner of the file (or root) can delete files in the
2327 directory.  So the only bad behavior that is invited by the 1777 mode is that
2328 anyone could
2329 create a random file in the spool directory.  If the spool directory is
2330 under quota control along with home directories, there is little incentive
2331 for anyone to do this, and even without quotas a periodic scan for
2332 non-mail files usually takes care of the problem.  <P>
2333
2334 <LI> Why not run Alpine as setgid mail?<BR>
2335 Alpine was never designed to run with privileges, and to do so introduces a
2336 significant security vulnerability.  For example, if a user suspends Alpine,
2337 the resulting shell will have group privileges.  This is one example of
2338 why we strongly recommend against running Alpine as a privileged program.
2339 In addition, a &quot;privileged mailer &quot paradigm would mean that normal
2340 users
2341 could not test Alpine versions or other mailers that had not been installed
2342 by the system administrators.<P>
2343
2344
2345 <LI> Are there any alternatives to creating .lock files in the spool dir?<BR>
2346 There are, but they all have different sets of tradeoffs, and not all will
2347 work on all systems.  Some examples:<UL>
2348  <LI> Use lock system calls.  Works fine on a few systems, provided mail
2349    spool is local.   Doesn't work reliably if NFS is used.
2350    Doesn't work unless <B>all</B> the mail programs accessing the spool dir
2351    use the same calls.
2352  <LI> Deliver mail to user's home directory.  An excellent solution, highly
2353    recommended -- but one which is incompatible with some &quot;legacy&quot;
2354 mail tools that always look in the spool directory for the mail.
2355 </UL><P>
2356
2357 <LI> Are these spool directory lock files the only kinds of locks used by
2358    Alpine?<BR>
2359 No.  Alpine also creates lockfiles in the /tmp directory.  For normal Unix
2360 mailbox format folders, these are used to coordinate access between
2361 multiple Alpine sessions.  <P>
2362
2363 <LI> What about the
2364 <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>
2365 This is for people who are content to live dangerously, or who have
2366 specific knowledge that the spool directory lockfiles are superfluous on
2367 their system (because both Alpine and the mail delivery program are using
2368 system call file locking in a context that works reliably, e.g. not NFS.)<P>
2369
2370 <LI> Where can I find more details on how Alpine locking works?<BR>
2371 See the Alpine Technical Notes.<P>
2372
2373 </OL>
2374 <P>
2375 &lt;End of help on this topic&gt;
2376 </BODY>
2377 </HTML>
2378 ===== h_finding_help ====
2379 <HTML>
2380 <HEAD>
2381 <TITLE>Finding more information and requesting help</TITLE>
2382 </HEAD>
2383 <BODY>
2384 <H1>Places to Look for More Answers</H1>
2385 If you have questions about or problems with Alpine that you cannot resolve
2386 after consulting the program's internal, context-sensitive help screens, here
2387 are additional information resources that you may find helpful:
2388 <P>
2389 <UL>
2390   <LI> Alpine's top-level <A HREF="main_menu_tx">MAIN MENU HELP</A>.<P>
2391
2392   <LI> Alpine's <A HREF="h_help_index">Help Index</A>.<P>
2393
2394   <LI> Alpine's internal <A HREF="h_news">Release Notes</A>.  They contain a
2395 listing of changes in Alpine <!--#echo var="ALPINE_VERSION"-->
2396   since the last version, which may be useful for you to be aware of,
2397 <B>especially</B> if a &quot;problem&quot; you are encountering is actually
2398 a change in the way an aspect of Alpine works.  There, you will also find notes
2399 on Alpine configuration.<P>
2400   <LI> The main site for Alpine contains information on configuring and solving problems
2401        with Alpine, it can be found at
2402
2403 <CENTER><A HREF="http://alpine.x10host.com/alpine/">http://alpine.x10host.com/alpine/</A></CENTER>
2404
2405   <LI> Archives of the Alpine-info mailing list, at <A
2406 href="http://mailman13.u.washington.edu/pipermail/alpine-info/">http://mailman13.u.washington.edu/pipermail/alpine-info/</A>
2407
2408   <LI>The newsgroup comp.mail.pine.
2409
2410 </UL>
2411 <P><HR WIDTH="75%">
2412 <H1>Requesting help</H1>
2413 If the internal help, the Release Notes, and your
2414 local online and print resources do not help you resolve a problem, please
2415 start by contacting your local computer support staff and asking for help.
2416 <p>
2417 This is especially true if:
2418 <ul>
2419   <li>You suddenly have trouble sending or receiving mail.
2420   <li>You receive a "disk quota exceeded" message.
2421   <li>You have forgotten your password.
2422   <li>You think your account may have been compromised.
2423   <li>You need help viewing an attachment.
2424   <li>You need to know how to configure your:
2425       <A HREF="h_config_nntp_server">NNTP (news) server</A>,
2426       <A HREF="h_config_smtp_server">SMTP (sending mail) server</A>,
2427       <A HREF="h_config_ldap_server">LDAP (directory lookup) server</A>, or
2428       <A HREF="h_config_inbox_path">INBOX (incoming mail) path</A>.
2429   <li>You want to know what alternative editors or spellcheckers you may be able to use.
2430   <li>You want to block email from a particular person.
2431   <li>You're going on vacation and need to autorespond to incoming mail.
2432   <li>You want to automatically file or filter incoming messages.
2433 </ul>
2434
2435 In all of these cases,
2436 you should contact <B>your</B> support staff, because <B>only they</B>
2437 will be able to assist you effectively. Your support staff may be, depending on who
2438 provides you with the email account you use Alpine with, for example:<UL>
2439 <LI> the computing help desk of (a department of) your university, school,
2440 employer, ... ; or
2441 <LI> the customer service center of your Internet Service Provider; or
2442 <LI> the friendly volunteer helpers of your Freenet; or
2443 <LI> the person who setup your computer and internet connection.
2444 </UL>
2445
2446 <P>
2447 If you have no local computing support to turn to, the worldwide <b>comp.mail.pine</b>
2448 newsgroup can be a valuable source of information and assistance for Alpine
2449 user issues.
2450 <P>
2451 For systems/email administrators, developers, trainers, user support
2452 personnel, and others involved with Alpine messaging on a &quot;technical&quot;
2453 level, the mailing list alpine-info is available; for information on
2454 subscribing and posting to it, see
2455 <P>
2456 <CENTER><A HREF="https://mailman13.u.washington.edu/mailman/listinfo/alpine-info">https://mailman13.u.washington.edu/mailman/listinfo/alpine-info</A></CENTER>
2457 <P>
2458
2459 Regardless of whom you are asking for help with Alpine, remember
2460 to provide as much detail as you can about the
2461 nature of any problem you are encountering, such as
2462 <UL>
2463 <LI>when it first occurred;
2464 <LI>what, if anything, happened that might have brought it about;
2465 <LI>whether it still persists;
2466 <LI>whether it is reproducible, and if so, how;
2467 <LI>what, if anything, you already tried to solve it.
2468 </UL>
2469 It may also be helpful if you specify what version of Alpine you are using
2470 <!--chtml if pinemode="running"-->
2471 -- this is <!--#echo var="ALPINE_VERSION"--> --
2472 <!--chtml endif-->
2473 and on what system, and when the copy of Alpine you are using was created
2474 <!--chtml if pinemode="running"-->
2475 -- for this copy: <!--#echo var=ALPINE_COMPILE_DATE-->
2476 <!--chtml endif-->
2477
2478 <!--chtml if pinemode="running"-->
2479 <P>
2480 When the Alpine program you are currently using was installed, a support
2481 contact email address may have been set up; in that case, you can simply select
2482 this link now to send a message to it:<BR>
2483 <A HREF="X-Alpine-Gripe:_LOCAL_ADDRESS_?local"><!--#echo var="_LOCAL_FULLNAME_"--></A><P>
2484 <!--chtml endif-->
2485 <!--chtml if [ -r PINE_INFO_PATH ]-->
2486 <HR WIDTH="75%">Local Support Contacts:<P>
2487 <!--#include file="PINE_INFO_PATH"-->
2488 <HR WIDTH="75%">
2489 <!--chtml endif-->
2490 <P>
2491 &lt;End of help on this topic&gt;
2492 </BODY>
2493 </HTML>
2494 ===== new_user_greeting ======
2495 <HTML>
2496 <HEAD>
2497 <TITLE>NEW USER GREETING</TITLE>
2498 </HEAD>
2499 <BODY>
2500 <CENTER>&lt;&lt;&lt;This message will appear only once&gt;&gt;&gt;</CENTER>
2501 <BR>
2502 <H1>Welcome to Alpine ... a Program for Internet News and Email</H1>
2503 We hope you will explore Alpine's many capabilities. From the MAIN MENU,
2504 select Setup/Config to see many of the options available to you. Also note
2505 that all screens have context-sensitive help text available.
2506
2507 <P>
2508 Alpine's privacy policy is a living, online only, document, which can be found at
2509 <A href="h_privacy_policy">http://alpine.x10host.com/privacy.html</A>.
2510 By following the previous link,  Alpine
2511 will connect to an external server, and will download it and display
2512 it for you. Please take some time to read it and understand it.
2513 Since the Privacy Policy could be ammended to take into consideration
2514 new additions to Alpine, please check it periodically. You can always
2515 find a link to the Privacy Policy in the <A href="h_news">Release Notes</A>.
2516
2517 <P>
2518 To Exit this screen and continue your Alpine session press "E".
2519 </BODY>
2520 </HTML>
2521 ===== new_alpine_user_greeting ======
2522 <HTML>
2523 <HEAD>
2524 <TITLE>NEW ALPINE USER GREETING</TITLE>
2525 </HEAD>
2526 <BODY>
2527 <CENTER>&lt;&lt;&lt;This message will appear only once&gt;&gt;&gt;</CENTER>
2528 <BR>
2529 <H1>Welcome to Alpine ... a Program for Internet News and Email</H1>
2530 Your Alpine configuration file indicates that you may have used Pine before
2531 but not Alpine.
2532 If you are familiar with the way Pine works, you should be comfortable
2533 using Alpine.
2534 Your Pine configuration file is automatically used for Alpine.
2535 The Release Notes may be viewed by pressing
2536 &quot;R&quot; now or while in the MAIN MENU.
2537
2538 <P>
2539 Alpine's privacy policy is a living, online only, document, which can be found at
2540 <A href="h_privacy_policy">http://alpine.x10host.com/privacy.html</A>.
2541 By following the previous link,  Alpine
2542 will connect to an external server, and will download it and display
2543 it for you. Please take some time to read it and understand it.
2544 Since the Privacy Policy could be ammended to take into consideration
2545 new additions to Alpine, please check it periodically. You can always
2546 find a link to the Privacy Policy in the <A href="h_news">Release Notes</A>.
2547
2548 <P>
2549 To Exit this screen and continue your Alpine session press "E".
2550 </BODY>
2551 </HTML>
2552 ===== new_version_greeting ======
2553 <HTML>
2554 <HEAD>
2555 <TITLE>NEW VERSION GREETING</TITLE>
2556 </HEAD>
2557 <BODY>
2558 <CENTER>&lt;&lt;&lt;This message will appear only once&gt;&gt;&gt;</CENTER>
2559 <BR>
2560 <H1>Welcome to Alpine version <!--#echo var="ALPINE_VERSION"-->!</H1>
2561 Your Alpine configuration file indicates that you may not have used
2562 this version of Alpine before.  This version's significant changes are
2563 documented in the Release Notes, which may be viewed by pressing
2564 &quot;R&quot; now or while in the MAIN MENU.
2565 <P>
2566 <P>
2567 Alpine's privacy policy is a living, online only, document, which can be found at
2568 <A href="h_privacy_policy">http://alpine.x10host.com/privacy.html</A>.
2569 By following the previous link,  Alpine
2570 will connect to an external server, and will download it and display
2571 it for you. Please take some time to read it and understand it.
2572 Since the Privacy Policy could be ammended to take into consideration
2573 new additions to Alpine, please check it periodically. You can always
2574 find a link to the Privacy Policy in the <A href="h_news">Release Notes</A>.
2575
2576 <P>
2577 To Exit this screen and continue your Alpine session press "E".
2578 </BODY>
2579 </HTML>
2580
2581 ===== main_menu_tx ======
2582 <HTML>
2583 <HEAD>
2584 <TITLE>GENERAL INFORMATION ON THE ALPINE MESSAGE SYSTEM</TITLE>
2585 </HEAD>
2586 <BODY>
2587 <H1>GENERAL INFORMATION ON THE ALPINE MESSAGE SYSTEM</H1>
2588 <DIV ALIGN=CENTER>
2589 Version <!--#echo var="ALPINE_VERSION"-->
2590 <!--chtml if pinemode="running"-->
2591 <BR>(built <!--#echo var=ALPINE_COMPILE_DATE-->)
2592 <!--chtml endif-->
2593 </DIV>
2594 <CENTER>Copyright 2013-2020 Eduardo Chappa,
2595 <BR>Copyright 2006-2008 University of Washington.
2596 </CENTER>
2597
2598 <P>
2599 When you are viewing a help screen, there may be links to
2600 other topics highlighted (in Reverse video) in the text.
2601 Here is an example.
2602 The word &quot;Introduction&quot; in the TABLE OF CONTENTS below should be
2603 highlighted.
2604 If you type carriage return (or V for View Link, see the commands at the
2605 bottom of the screen) you will be taken to a new help screen to view the
2606 Introduction.
2607 The commands at the bottom of the screen should then include
2608 &quot;P Prev Help&quot;.
2609 If you type &quot;P&quot; you will end up back here.
2610 If you type &quot;E&quot; for Exit, you will be back out of help and returned
2611 to the place you were in Alpine when you entered Help.
2612 In this case, you would go back to the MAIN MENU.
2613 There are also other links that are highlighted in bold (or the color used
2614 by your terminal to display bold).
2615 The items after the Introduction in the TABLE OF CONTENTS are all examples
2616 of such links.
2617 In order to view those links, you first have to make the link you want
2618 to view the current link.
2619 The &quot;NextLink&quot; and &quot;PrevLink&quot; commands
2620 (see bottom of screen) can do that for you.
2621 <P>
2622
2623 <H2>TABLE OF CONTENTS</H2>
2624 <OL>
2625   <LI> <A HREF="h_mainhelp_intro">Introduction</A>
2626   <LI> <A HREF="h_mainhelp_pinehelp">Alpine Help</A>
2627 <!--chtml if [ -r PINE_INFO_PATH ]-->
2628   <LI> <A HREF="h_mainhelp_localsupport">Local Support Contacts</A>
2629 <!--chtml endif-->
2630   <LI> <A HREF="h_mainhelp_cmds">Giving Commands in Alpine</A>
2631   <LI> <A HREF="h_mainhelp_config">Alpine Configuration</A>
2632   <LI> <A HREF="h_mainhelp_status">Titlebar Line</A>
2633   <LI> <A HREF="h_mainhelp_mainmenu">Main Menu</A>
2634   <LI> <A HREF="h_mainhelp_index">Index of Messages</A>
2635   <LI> <A HREF="h_mainhelp_reading">Reading Messages</A>
2636   <LI> <A HREF="h_mainhelp_composing">Composing Messages</A>
2637   <LI> <A HREF="h_mainhelp_readingnews">Reading News</A>
2638   <LI> <A HREF="h_mainhelp_abooks">Address Books</A>
2639   <LI> <A HREF="h_mainhelp_ldap">LDAP Directories</A>
2640   <LI> <A HREF="h_mainhelp_folders">Folders</A>
2641   <LI> <A HREF="h_mainhelp_collections">Collection Lists</A>
2642   <LI> <A HREF="h_mainhelp_aggops">Aggregate Operations</A>
2643   <LI> <A HREF="h_mainhelp_color">Color Setup</A>
2644   <LI> <A HREF="h_mainhelp_filtering">Filtering</A>
2645   <LI> <A HREF="h_mainhelp_roles">Roles</A>
2646   <LI> <A HREF="h_mainhelp_patterns">Patterns</A>
2647   <LI> <A HREF="h_mainhelp_keywords">Keywords (or Flags, or Labels)</A>
2648   <LI> <A HREF="h_mainhelp_mouse">Using a Mouse</A>
2649   <LI> <A HREF="h_mainhelp_cmdlineopts">Command Line Options</A>
2650   <LI> <A HREF="h_mainhelp_securing">Securing Your Alpine Session</A>
2651   <LI> <A HREF="h_mainhelp_smime">S/MIME</A>
2652   <LI> <A HREF="h_mainhelp_problems">Reporting Problems</A>
2653   <LI> <A HREF="X-Alpine-Config:">Show Supported Options in this Alpine</A>
2654   <LI> <A HREF="h_help_index">Index to Alpine's Online Help</A>
2655 </OL>
2656
2657 <P>
2658 &lt;End of help on this topic&gt;
2659 </BODY>
2660 </HTML>
2661 ===== h_mainhelp_intro ======
2662 <HTML>
2663 <HEAD>
2664 <TITLE>Introduction</TITLE>
2665 </HEAD>
2666 <BODY>
2667 <H1>Introduction</H1>
2668
2669 Alpine is an &quot;Alternatively Licensed Program for Internet
2670 News and Email&quot; produced until 2009 by the University of Washington.
2671 It is intended to be an easy-to-use program for
2672 sending, receiving, and filing Internet electronic mail messages and
2673 bulletin board (Netnews/Usenet) messages. Alpine supports the following
2674 Internet protocols and specifications: SMTP (Simple Mail Transport Protocol),
2675 NNTP (Network News Transport Protocol), MIME (Multipurpose Internet Mail
2676 Extensions), IMAP (Internet Message Access Protocol), and LDAP (Lightweight
2677 Directory Access Protocol).<p>
2678
2679 Although originally designed for inexperienced email users, Alpine has
2680 evolved to support many advanced features.  There are an ever-growing
2681 number of configuration and personal-preference options, though which of
2682 them are available to you is determined by your local system managers.
2683
2684 <H2>WHAT ALPINE DOES...</H2>
2685
2686 Alpine is a &quot;mail user agent&quot; (MUA), which is a program that
2687 allows you to
2688 compose and read messages using Internet mail standards.  (Whether you
2689 can correspond with others on the Internet depends on whether or not your
2690 computer is connected to the Internet.)  Alpine also allows reading and
2691 posting messages on the Internet &quot;net news&quot; system, provided
2692 that your site operates a suitable news server.
2693
2694 <H2>WHAT ALPINE DOES NOT DO...</H2>
2695
2696 A &quot;mail user agent&quot; such as Alpine is just one part of a
2697 messaging system. Here are some things that are <B>not</B> done by Alpine,
2698 but require other programs:<P>
2699 <UL>
2700  <LI> Actual relaying of email... which is done by &quot;message transfer
2701 agents&quot;.
2702  <LI> Vacation messages... automatically responding to incoming messages
2703  <LI> Anything to do with &quot;talk&quot;... which has nothing to do with
2704 email.
2705  <LI> Anything to do with &quot;irc&quot;... which has nothing to do with email.
2706  <LI> List processing... resending one message to a list of recipients.
2707 </UL>
2708
2709 <P>
2710 &lt;End of help on this topic&gt;
2711 </BODY>
2712 </HTML>
2713
2714 ===== h_mainhelp_pinehelp ======
2715 <HTML>
2716 <HEAD>
2717 <TITLE>Alpine Help</TITLE>
2718 </HEAD>
2719 <BODY>
2720 <H1>Alpine Help</H1>
2721
2722 Alpine help is generally context-sensitive. In other words, each Alpine screen you
2723 use will have its own help text, explaining the choices available for that
2724 screen. This general help section, on the other hand, attempts to give an
2725 overall picture of what Alpine is capable of doing, as well as pointers to
2726 additional help sections about specific topics.<p>
2727
2728 Much of the help text contains links to further help topics, similar to
2729 how the World Wide Web works.
2730 You may choose a link to view using the &quot;NextLink&quot; and
2731 &quot;PrevLink&quot; commands to change the link that is highlighted.
2732 The &quot;View Link&quot; command will then show you the highlighted link.
2733 Similar to the Back button in a web browser, the &quot;Prev Help&quot; command
2734 will return you to where you were before viewing the link, and &quot;Exit Help&quot
2735 will return you to the location in Alpine before you asked for help.
2736 For example, if you are reading this text in Alpine you may return to the
2737 help table of contents with the &quot;Prev Help&quot; command or you may view the
2738 Release notes link in the next paragraph and then return here with
2739 &quot;Prev Help&quot;.
2740 <P>
2741
2742 In addition to this general help on Alpine, <A HREF="h_news">Release Notes</A>
2743 on the current Alpine version are also available from the MAIN MENU: Press
2744 <!--chtml if pinemode="function_key"-->
2745 &quot;F9&quot;
2746 <!--chtml else-->
2747 &quot;R&quot;
2748 <!--chtml endif-->
2749 to browse the release notes.  These include changes since the last release,
2750 configuration information, the history of the Alpine
2751 project, credits, and legal notices.
2752
2753 Alpine releases are available via the world wide web at
2754 <P>
2755 <CENTER><SAMP><A
2756 HREF="http://repo.or.cz/alpine.git">http://repo.or.cz/alpine.git</A></SAMP
2757 ></CENTER>
2758 <P>
2759
2760 If you would like to print <EM>all</EM> of Alpine's internal help text
2761 (not recommended) for a little light bedtime reading, then press
2762 <!--chtml if pinemode="function_key"-->
2763 &quot;F12&quot;
2764 <!--chtml else-->
2765 &quot;Z&quot;
2766 <!--chtml endif-->
2767 now.  (This assumes that the
2768 copy of Alpine you are using has been properly configured for printing
2769 at your site.)
2770 <P>
2771 &lt;End of help on this topic&gt;
2772 </BODY>
2773 </HTML>
2774 ===== h_mainhelp_localsupport ======
2775 <HTML>
2776 <HEAD>
2777 <TITLE>Local Support Contacts</TITLE>
2778 </HEAD>
2779 <BODY>
2780 <H1>Local Support Contacts</H1>
2781
2782 <!--chtml if [ -r PINE_INFO_PATH ]-->
2783 <!--#include file="PINE_INFO_PATH"-->
2784 <!--chtml else-->
2785 No Local Support Contacts configured.
2786 <!--chtml endif-->
2787
2788 <P>
2789 &lt;End of help on this topic&gt;
2790 </BODY>
2791 </HTML>
2792
2793 ===== h_mainhelp_cmds ======
2794 <HTML>
2795 <HEAD>
2796 <TITLE>Giving Commands in Alpine</TITLE>
2797 </HEAD>
2798 <BODY>
2799 <H1>Giving Commands in Alpine</H1>
2800
2801 Unless configured otherwise
2802 (<A HREF="h_config_blank_keymenu"><!--#echo var="FEAT_disable-keymenu"--></A>)
2803 the bottom two lines of the screen are always used to list the
2804 commands you can give.  You press the keys that are highlighted to give
2805 the command.  The commands for getting help and going back to the main
2806 menu are always present (except when viewing help as you are now).
2807 <!--chtml if pinemode="function_key"-->
2808 <!--chtml else-->
2809 <p>
2810 Pressing O (meaning &quot;Other Commands&quot;) changes the keys
2811 you see at the bottom of any screen. In some cases there are 3 or
2812 even 4 different
2813 sets of keys that can be seen by using the O key. <EM>All commands are
2814 active</EM>, even if they are not currently showing at the bottom of your
2815 screen. In other words, you <EM>never</EM> need to press the O key, except to
2816 remind yourself of the proper key to press to perform an operation.
2817
2818 <H2>Control Key Commands</H2>
2819 When composing mail, and in a few other places, in Alpine you
2820 have to use Control keys. This means pressing the Control key (usually labeled
2821 &quot;Ctrl&quot;) and the
2822 letter indicated at the same time.  Usually, this is shown with a
2823 &quot;^&quot; in front of the letter.  On some systems, certain control
2824 characters are intercepted before they get to Alpine.  As a work-around,
2825 you can press the ESCAPE key twice followed by the desired key.  For
2826 example, if Ctrl-O (^O) does not work on your system, try typing
2827 &quot;ESC ESC O&quot;.
2828 <!--chtml endif-->
2829 <H2>Paging Up and Down</H2>
2830 The &quot;+&quot; and &quot;-&quot; keys are used for
2831 moving to the next or previous page.  The space bar is a synonym for
2832 &quot;+&quot;.  You may also use Ctrl-V to page down and Ctrl-Y to page
2833 up as you do in the message composer.  On screens with a WhereIs (search)
2834 command, W or Ctrl-W followed by Ctrl-V will move to the bottom of the
2835 message or list, and W or Ctrl-W followed by Ctrl-Y will move to the top
2836 of the message or list.
2837
2838 <H2>Return Key</H2>
2839 The return key is usually a synonym for a frequently used
2840 command.  When viewing a message, there is currently not a default
2841 command, so RETURN does nothing; when in the index, it is synonymous with
2842 &quot;view msg&quot;. In the key menu at the bottom of the screen, whatever is
2843 enclosed in square brackets [] is the same as the return key.
2844
2845 <H2>Control Keys Not Used By Alpine</H2>
2846 Most commands in Alpine are single letters, with -- we hope -- some mnemonic
2847 value, but in places where Alpine is expecting text input, e.g. in the composer or
2848 at prompts for file/folder names, control keys must be used for editing and
2849 navigation functions.
2850 <P>
2851
2852 Alpine has used nearly all the control keys available.  There are, however,
2853 certain control keys that are reserved by other programs or for technical
2854 reasons.  Alpine does not use any of these keys:
2855 <DL>
2856  <DT>Ctrl-S</DT> <DD>Used by Unix as &quot;stop output&quot;</DD>
2857  <DT>Ctrl-Q</DT> <DD>Used by Unix as &quot;resume output&quot;</DD>
2858  <DT>Ctrl-]</DT> <DD>Often used by Telnet as escape key</DD>
2859 </DL>
2860 <P>
2861 Note: Ctrl-S and Ctrl-Q can be subject to
2862 <A HREF="h_special_xon_xoff">special handling</A>.
2863 <P>
2864 In addition, while the ESC key alone is not used for command input,
2865 Alpine will recognize two consecutive ESC key presses followed by a letter
2866 key as a substitute for control key input.  For example, the control key
2867 <SAMP>Ctrl-X</SAMP> can alternatively be entered using the
2868 three keystrokes: <SAMP>ESC&nbsp;ESC&nbsp;x</SAMP>.
2869 This is useful if the communication program you are using
2870 (e.g. Telnet) has its own, conflicting, idea of what certain control
2871 characters mean.
2872
2873
2874 <H2>Repainting the Screen</H2>
2875 Sometimes what is displayed on the screen will be
2876 incorrect due to noise on the phone line or other causes and you will want
2877 to repaint the whole screen to make it correct.  You can use the Ctrl-L
2878 command to do this.  It never hurts to do it when in doubt.
2879
2880 <P>
2881 &lt;End of help on this topic&gt;
2882 </BODY>
2883 </HTML>
2884 ===== h_mainhelp_status ======
2885 <HTML>
2886 <HEAD>
2887 <TITLE>Titlebar Line</TITLE>
2888 </HEAD>
2889 <BODY>
2890 <H1>Titlebar Line</H1>
2891
2892 The top line of the screen is Alpine's titlebar line.  It will always display
2893 the current version of Alpine and will also convey information about the
2894 status of the program.  This is where you look to find out what
2895 collection, folder and message number is active and where you are in Alpine.
2896 <P>
2897
2898 If the titlebar line says &quot;READONLY&quot; it means that the open folder
2899 (typically your INBOX) is &quot;locked&quot; by another mail session --
2900 most likely a more recent session of Alpine has taken the INBOX lock.
2901 <P>
2902
2903 If the titlebar line says &quot;CLOSED&quot; it means that you are trying to
2904 access a
2905 folder on a remote mail server, and for some reason, communication with
2906 the mail server has either been lost, or never successfully established.
2907 This can be a result of trying to open a non-existent folder, or one
2908 stored on an invalid or non-operational server, or it can mean that Alpine
2909 has been suspended for more that 30 minutes while accessing a remote mail
2910 server.
2911
2912 <P>
2913 &lt;End of help on this topic&gt;
2914 </BODY>
2915 </HTML>
2916 ===== h_mainhelp_mainmenu ======
2917 <HTML>
2918 <HEAD>
2919 <TITLE>Main Menu</TITLE>
2920 </HEAD>
2921 <BODY>
2922 <H1>Main Menu</H1>
2923
2924 The Main Menu lists Alpine's main options.
2925 The key or keys you must type to enter your
2926 choice are to the left of each option or command name.
2927 You can type either uppercase or lowercase letters,
2928 and you should not press &lt;Return&gt; after typing the
2929 letter (unless you are specifically asking for the default,
2930 highlighted command).
2931 <P>
2932
2933 From the Main Menu you can choose to read online help, write (compose) and
2934 send a message, look at an index of your mail messages, open or maintain
2935 your mail folders, update your address book, configure Alpine, and quit Alpine.
2936 There are additional options listed at
2937 the bottom of the screen as well.
2938
2939 <P>
2940 The Help command usually returns context-sensitive help information.
2941 However, in the Main Menu you get the most general help, which includes
2942 a Table of Contents.
2943 The last entry in the Table of Contents is an Index of help topics,
2944 so this is a good place to go if you are having trouble finding how
2945 to do something.
2946
2947 <H2>Main Menu Commands</H2>
2948 The Alpine main menu lists the most common Alpine functions. A <a
2949 href="h_main_menu_commands">full list of these
2950 commands</a> and what they do is available.
2951 <P>
2952 &lt;End of help on this topic&gt;
2953 </BODY>
2954 </HTML>
2955 ===== h_mainhelp_abooks ======
2956 <HTML>
2957 <HEAD>
2958 <TITLE>Address Books</TITLE>
2959 </HEAD>
2960 <BODY>
2961 <H1>Address Books</H1>
2962
2963
2964 As you use email, you can build a list of your regular email correspondents
2965 in your Alpine
2966 Address Book. At the Alpine MAIN MENU, press A to see the Address Book List
2967 screen. Your
2968 personal address book will be highlighted. Press &lt;Return&gt; to view it.
2969 You can use the address book to store email addresses for individuals or
2970 groups, to create easily
2971 remembered &quot;nicknames&quot; for these addresses, and to quickly retrieve an email
2972 address when you are composing a message.
2973 <P>
2974 There are two ways to add addresses to your address book: you can add them
2975 manually or take them from messages (by pressing T to access the Take command).
2976 With either method, you specify nicknames for your correspondents. A single
2977 address book entry (or nickname) can point to just one email address, or, it can
2978 point to more than one. When it points to more than one, it is called a
2979 distribution list. Each distribution list has a nickname, a full name, and a
2980 list of addresses. These
2981 addresses may be actual addresses, other nicknames in your address book, or
2982 other
2983 distribution lists.
2984
2985 <P>
2986 Additional information is available in Alpine's online help:
2987 <ul>
2988   <li><a href="h_abook_opened">The Alpine Address Book</a></li>
2989 </ul>
2990 <P>
2991 &lt;End of help on this topic&gt;
2992 </BODY>
2993 </HTML>
2994 ===== h_mainhelp_ldap ======
2995 <HTML>
2996 <HEAD>
2997 <TITLE>LDAP</TITLE>
2998 </HEAD>
2999 <BODY>
3000 <H1>LDAP</H1>
3001
3002 LDAP (Lightweight Directory Access Protocol) is a standard means of accessing
3003 an organization's shared
3004 directories. Essentially, using LDAP, Alpine is able to find email addresses in
3005 large address
3006 books, rather like the White Pages provided by the phone company. As an Alpine
3007 user, it is not
3008 necessary to know much about how this works, only how to use it and how to
3009 configure
3010 it.
3011 <P>
3012 More information on configuring LDAP is available in Alpine's online help:
3013 <ul>
3014   <li><a href="h_direct_config">Setup LDAP Directory Servers</a></li>
3015 </ul>
3016 <P>
3017 Additional help on using LDAP in Alpine is also available:
3018 <ul>
3019   <li><a href="h_ldap_view">LDAP Response View Explained</a></li>
3020 </ul>
3021 <P>
3022 &lt;End of help on this topic&gt;
3023 </BODY>
3024 </HTML>
3025 ===== h_mainhelp_index ======
3026 <HTML>
3027 <HEAD>
3028 <TITLE>Index of Messages</TITLE>
3029 </HEAD>
3030 <BODY>
3031 <H1>Index of Messages</H1>
3032
3033 In Alpine's message index, the selected message is highlighted. The first
3034 column on the left is blank, shows a &quot;+&quot; if the message was
3035 sent directly to you (i.e., it is not a
3036 copy or from a list), or a &quot;-&quot; if you were explicitly Cc'd.
3037 <P>
3038 The second column may be blank, or it may contain:
3039 <ul>
3040   <li>"N" if the message is new (unread), </li>
3041   <li>"A" if you have answered the message (using the Reply command), </li>
3042   <li>"D" if you have marked the message for deletion.</li>
3043 </ul>
3044
3045 <P>
3046 Note: If you answer a message as well as mark it deleted (in either order),
3047 you will only see the &quot;D&quot;.
3048
3049 <P>
3050 The rest of the columns in the message line show you the message
3051 number, date sent, sender, size, and subject. For details, press ? (Help).
3052 The behavior and appearance of the Index screen is highly configurable.
3053 In the Setup/Config screen search (with the WhereIs command) for options
3054 that contain the words &quot;index&quot; or &quot;thread&quot; to see
3055 many of the configuration possibilities.
3056 In particular, the
3057 &quot;<A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A>&quot;
3058 option may be used to configure the look of the standard MESSAGE INDEX lines
3059 in many different ways.
3060 Find <!--#echo var="VAR_index-format"--> in the Setup/Config screen and
3061 read the help text there for more information.
3062 <P>
3063 Most of the commands you need to handle your messages are visible at the
3064 bottom of the screen, and you can press O (OTHER CMDS) to see additional
3065 commands that are available.
3066 You do not need to see these &quot;other commands&quot;
3067 on the screen to use them. That is, you never need to press O as a prefix
3068 for any other command.
3069
3070 <P>
3071 Additional information is available in Alpine's online help:
3072 <ul>
3073   <li><a href="h_mail_index">Message Index Commands</a></li>
3074 </ul>
3075 <P>
3076 &lt;End of help on this topic&gt;
3077 </BODY>
3078 </HTML>
3079 ===== h_mainhelp_reading ======
3080 <HTML>
3081 <HEAD>
3082 <TITLE>Reading Messages</TITLE>
3083 </HEAD>
3084 <BODY>
3085 <H1>Reading Messages</H1>
3086
3087 The message text screen shows you the text of the message along with
3088 its header. If a message has attachments, those will be listed (but not
3089 displayed) also.  The titlebar line displays information about the currently
3090 open message, folder and collection.  You see the name of the collection
3091 (if there is one) in angle brackets, then the name of the folder, then the
3092 message number and finally the position within the current message (in
3093 percent). If the message is marked for deletion
3094 &quot;DEL&quot; will appear in the
3095 upper right as well.
3096
3097 <P>
3098 As with every Alpine screen, the bottom two lines show you the commands
3099 available.
3100
3101 <P>Additional information is available in Alpine's online help:
3102 <ul>
3103   <li><a href="h_mail_view">Message Text Screen</a></li>
3104   <li><a href="h_attachment_screen">Attachment Index Screen Explained</a></li>
3105   <li><a href="h_mail_text_att_view">Attachment View Screen Explained</a></li>
3106 </ul>
3107 <P>
3108 &lt;End of help on this topic&gt;
3109 </BODY>
3110 </HTML>
3111 ===== h_mainhelp_composing ======
3112 <HTML>
3113 <HEAD>
3114 <TITLE>Composing Messages</TITLE>
3115 </HEAD>
3116 <BODY>
3117 <H1>Composing Messages</H1>
3118
3119 To write a message, press C (Compose). You see the Compose Message
3120 screen, which is divided into two parts: the header area and the message
3121 text area. The header area is where information on the recipient (the To:
3122 field) and the subject line go, while the message text area contains the
3123 actual text of the email message. Different commands are available to you
3124 when your cursor is in different areas on this screen. To see additional
3125 help on commands in either the message text or header area, type
3126 <Control>G (Get help).
3127
3128 <P>
3129 To move around, use the arrow keys or Ctrl-N (Next line) and Ctrl-P
3130 (Previous line); to correct typing errors, use &lt;Backspace&gt; or &lt;Delete&gt;.
3131
3132 <P>The following information from Alpine's online help may prove useful:
3133 <ul>
3134   <li><a href="h_composer_to">Message Header Commands</a></li>
3135   <li><a href="h_compose_richhdr">Rich Header Command</a></li>
3136   <li><a href="h_composer">Composer Commands</a></li>
3137   <li><a href="h_edit_nav_cmds">Composer Editing Commands</a></li>
3138   <li><a href="h_config_change_your_from">Changing your From Address</a></li>
3139   <li><a href="h_compose_send">Send Command</a></li>
3140   <li><a href="h_compose_spell">Spell Check Command</a></li>
3141 </ul>
3142 <P>
3143 &lt;End of help on this topic&gt;
3144 </BODY>
3145 </HTML>
3146 ===== h_mainhelp_collections ======
3147 <HTML>
3148 <HEAD>
3149 <TITLE>Collection Lists</TITLE>
3150 </HEAD>
3151 <BODY>
3152 <H1>Collection Lists</H1>
3153
3154 Collection lists are Alpine's way of organizing groups of folders. Each
3155 "collection" can reside on a different server, for example, and contain a
3156 different group of mail folders.
3157
3158 <P>
3159 For more information on this, see:
3160 <ul>
3161   <li><a href="h_what_are_collections">Folder Collections Explained</a></li>
3162 </ul>
3163 <P>
3164 Additional information relating to collection lists is also available in
3165 Alpine's online
3166 help:
3167 <ul>
3168   <li><a href="h_collection_maint">Setup Collection List Screen</a></li>
3169   <li><a href="h_collection_screen">Collection List Screen</a></li>
3170 </ul>
3171 <P>
3172 &lt;End of help on this topic&gt;
3173 </BODY>
3174 </HTML>
3175 ===== h_mainhelp_folders ======
3176 <HTML>
3177 <HEAD>
3178 <TITLE>Folders</TITLE>
3179 </HEAD>
3180 <BODY>
3181 <H1>Folders</H1>
3182
3183 Messages can quickly accumulate in your INBOX folder. If you use email
3184 often, you soon could have hundreds. You need to delete messages you do
3185 not want, and you can use folders to organize messages you wish to save. A
3186 folder is a collection of one or more messages that are stored (just like
3187 the messages in your INBOX) so you can access and manage them.
3188
3189 <P>
3190 You can organize your email messages into different folders by topic,
3191 correspondent, date, or any other category that is meaningful to you. You
3192 can create your own folders, and Alpine automatically provides three:
3193 <ul>
3194   <li>The INBOX folder: messages sent to you are listed in this folder.
3195       When you first start Alpine and go to the Message Index screen, you are
3196 looking at the list of messages in your INBOX folder. Every incoming
3197 message remains in your INBOX until you delete it or save it in another
3198 folder. </li>
3199   <li>The sent-mail folder: copies of messages you send are stored in this
3200 folder. This is
3201 convenient if you cannot remember whether you actually sent a message and want
3202 to check, or
3203 if you want to send a message again.</li>
3204   <li>The saved-messages folder: copies of messages you save are stored in this
3205 folder
3206 unless you choose to save them to other folders you create yourself.</li>
3207 </ul>
3208
3209 <P>
3210 More information about folders is available in Alpine's online help:
3211 <ul>
3212   <li><a href="h_folder_open">Explanation of Folder Selection</a></li>
3213   <li><a href="h_folder_maint">Help for Folder List</a></li>
3214   <li><a href="h_valid_folder_names">Explanation of Valid Folder Names</a></li>
3215   <li><a href="h_folder_fcc">Folder Select for Fcc ("sent-mail")
3216 Explained</a></li>
3217   <li><a href="h_folder_save">Folder Select for Save Explained</a></li>
3218 </ul>
3219 <P>
3220 &lt;End of help on this topic&gt;
3221 </BODY>
3222 </HTML>
3223 ===== h_mainhelp_color ======
3224 <HTML>
3225 <HEAD>
3226 <TITLE>Color</TITLE>
3227 </HEAD>
3228 <BODY>
3229 <H1>Color</H1>
3230
3231 If the terminal emulator you are using is capable of displaying color or if
3232 you are using PC-Alpine, then it is possible to set up Alpine so that various
3233 parts of the display will be shown in colors you configure. This is done
3234 using the Setup Color screen, available from the MAIN MENU by selecting
3235 the Setup command followed by &quot;K&quot; for Kolor (because &quot;C&quot;
3236 stands for Config in this context).
3237
3238 <P>
3239 For example, you may color things like the titlebar, the current item,
3240 the keymenu, and the status messages.
3241 You may also color lines in the index, and headers and quoted text in the
3242 MESSAGE TEXT screen.
3243 You use the Color Setup screen for configuring most of this, but you must
3244 use the IndexColor setup for coloring whole index lines.
3245 These are available from the MAIN MENU under Setup/Kolor and Setup/Rules/IndexColor.
3246
3247 <P>
3248 The following entries in Alpine's online help provide additional information
3249 about how to use color:
3250 <UL>
3251   <LI> <A HREF="h_color_setup">Color Setup screen</A>
3252   <LI> <A HREF="h_rules_incols">Index Line Color</A>
3253   <LI> <A HREF="h_config_quote_color">quoted text</A> in message view
3254   <LI> <A HREF="h_config_customhdr_pattern">text associated with user-defined headers</A> in message view
3255 </UL>
3256 <P>
3257 &lt;End of help on this topic&gt;
3258 </BODY>
3259 </HTML>
3260 ===== h_mainhelp_mouse ======
3261 <HTML>
3262 <HEAD>
3263 <TITLE>Using a Mouse</TITLE>
3264 </HEAD>
3265 <BODY>
3266 <H1>Using a Mouse</H1>
3267
3268 If you are using PC-Alpine mouse support is turned on automatically.
3269 If you are using UNIX Alpine within an X terminal window or within
3270 a terminal emulator that supports an xterm-style mouse, then you may
3271 turn on support for the mouse with the feature
3272 <A HREF="h_config_enable_mouse"><!--#echo var="FEAT_enable-mouse-in-xterm"--></A>.
3273 For UNIX Alpine you will also need to set the $DISPLAY environment variable.
3274 <P>
3275 PC-Alpine offers considerable mouse support.  You can view what is
3276 &quot;clickable&quot; by dragging your mouse over any screen; when the
3277 arrow cursor changes into a hand, you found something. Mouse-click
3278 possibilities include navigating between screens and folders and
3279 double-clicking on hyperlinks to open your Web browser.
3280 Context-sensitive pop-up menus appear with a right-click on your PC-Alpine
3281 screen.  Examples of right-click options include &quot;copy&quot; after
3282 selecting text to copy and &quot;View in New Window&quot; when you click
3283 on a particular message in the Message Index. The menu choices available
3284 to you will vary based upon what screen is open, where on the screen your
3285 cursor is located, and even what action you have already taken.
3286 Within a folder, you may set the &quot;Important&quot; flag on any
3287 message.
3288 <P>
3289 X terminal mouse support is more limited but still quite powerful.
3290 As with PC-Alpine, clicking on any of the commands in the keymenu at
3291 the bottom of the screen will execute that command as if you typed it.
3292 Double-clicking on a link, for example the link to the
3293 <!--#echo var="FEAT_enable-mouse-in-xterm"--> feature in the paragraph above,
3294 will take you to that link.
3295 Double-clicking on an index line will view the message, and so on.
3296 <P>
3297 &lt;End of help on this topic&gt;
3298 </BODY>
3299 </HTML>
3300 ===== h_mainhelp_keywords ======
3301 <HTML>
3302 <HEAD>
3303 <TITLE>Keywords</TITLE>
3304 </HEAD>
3305 <BODY>
3306 <H1>Keywords</H1>
3307
3308 Within a folder, you may set the &quot;Important&quot; flag on any
3309 message.
3310 This doesn't have any system-defined meaning and is only called
3311 the Important flag because many users use it to signify that a message
3312 is important to them in some way.
3313 <P>
3314 You may also define your own set of keywords.
3315 You might know these as user defined flags or as labels.
3316 These are similar to the Important flag but you choose the names for yourself.
3317 <P>
3318 Alpine will only display keywords that
3319 have been added by you in the Flag Details screen or
3320 that have been configured by you using the Setup/Config option
3321 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>.
3322 Keywords set by other means (for example, by another email client) will not
3323 show up in Alpine unless you configure Alpine to know about them.
3324 They will show up in the Flag Details screen, but will not show up, for example,
3325 in the index line.
3326
3327 <P>
3328 The following entries in Alpine's online help provide additional information
3329 about how to use keywords:
3330 <ul>
3331   <li><A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--> config option</A></li>
3332   <li><A HREF="h_common_flag">Flag command to set keywords</A></li>
3333 </ul>
3334 <P>
3335 &lt;End of help on this topic&gt;
3336 </BODY>
3337 </HTML>
3338 ===== h_mainhelp_roles ======
3339 <HTML>
3340 <HEAD>
3341 <TITLE>Roles</TITLE>
3342 </HEAD>
3343 <BODY>
3344 <H1>Roles</H1>
3345
3346 You may play different roles depending on who you are replying to. For
3347 example, if you are replying to a message addressed to help-desk you may
3348 be acting as a Help Desk Worker. That role may require that you use a
3349 different return address and/or a different signature.
3350
3351 <P>
3352 To configure roles, go to the MAIN MENU and use the Setup command
3353 followed by &quot;Rules&quot; and then &quot;Roles&quot;.
3354 The following entries in Alpine's online help provide additional information
3355 about how to
3356 use roles:
3357 <ul>
3358   <li><a href="h_rules_roles">Setup Roles Screen</a></li>
3359   <li><a href="h_role_select">Roles Screen</a></li>
3360 </ul>
3361 <P>
3362 &lt;End of help on this topic&gt;
3363 </BODY>
3364 </HTML>
3365 ===== h_mainhelp_filtering ======
3366 <HTML>
3367 <HEAD>
3368 <TITLE>Filtering</TITLE>
3369 </HEAD>
3370 <BODY>
3371 <H1>Filtering</H1>
3372
3373 The software that actually delivers mail (the stuff that happens
3374 before Alpine is involved) for you is in a better position to do mail filtering
3375 than Alpine itself.
3376 If possible, you may want to look into using that sort of mail filtering to
3377 deliver mail to different folders, delete it, or forward it.
3378 However, if you'd like Alpine to help with this, Alpine's filtering is for you.
3379
3380 <P>
3381 Filtering is a way to automatically move certain messages from one folder
3382 to another or to automatically delete messages.
3383 You may also automatically set the state (Important, New, Deleted, Answered) of messages
3384 and set <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> for messages.
3385 Alpine doesn't have the ability to forward mail to another address or
3386 to deliver vacation messages.
3387
3388 <P>
3389 To configure filtering, go to the MAIN MENU and use the Setup command
3390 followed by &quot;Rules&quot; and then &quot;Filters&quot;.
3391 The following entries in Alpine's online help provide additional information
3392 about how to use filtering:
3393 <UL>
3394   <LI> <A HREF="h_rules_filter">Filtering Setup screen</A>
3395 </UL>
3396 <P>
3397 &lt;End of help on this topic&gt;
3398 </BODY>
3399 </HTML>
3400 ===== h_mainhelp_patterns ======
3401 <HTML>
3402 <HEAD>
3403 <TITLE>Patterns</TITLE>
3404 </HEAD>
3405 <BODY>
3406 <H1>Patterns</H1>
3407
3408 Patterns are used with Roles, Filtering, Index Coloring,
3409 Scoring, Other Rules, and Search Rules, so it may help you to understand exactly how Patterns work.
3410 The following entries in Alpine's online help provide information
3411 about using Patterns:
3412 <UL>
3413   <LI> <A HREF="h_rule_patterns">Patterns</A>
3414 </UL>
3415 <P>
3416 &lt;End of help on this topic&gt;
3417 </BODY>
3418 </HTML>
3419 ===== h_mainhelp_cmdlineopts ======
3420 <HTML>
3421 <HEAD>
3422 <TITLE>Command Line Options</TITLE>
3423 </HEAD>
3424 <BODY>
3425 <H1>Command Line Options</H1>
3426
3427 Alpine accepts a number of command line arguments, allowing you, for
3428 example, to start Alpine and immediately access a particular folder.
3429 Many of these arguments overlap with options in the Alpine configuration file.
3430 If there is a difference, then an option set on the command line takes
3431 precedence.
3432 Alpine expects command line arguments (other than addresses) to be
3433 preceded by a &quot;-&quot; (dash) as normally used by UNIX programs.
3434 A <a href="h_command_line_options">full list</a> of command line
3435 possibilities is available.
3436 <P>
3437 &lt;End of help on this topic&gt;
3438 </BODY>
3439 </HTML>
3440 ===== h_mainhelp_config ======
3441 <HTML>
3442 <HEAD>
3443 <TITLE>Alpine Configuration</TITLE>
3444 </HEAD>
3445 <BODY>
3446 <H1>Alpine Configuration</H1>
3447
3448 Unless it has been administratively disabled, the Setup command on the
3449 MAIN MENU has several subcommands that allow you to modify Alpine's behavior.
3450 The possible subcommands are for general Configuration settings,
3451 Printer settings, Changing your Password, Signature setup,
3452 AddressBook setup, Collection Lists setup, Rules (including Roles, Filters,
3453 Scores, Search, Indexcolor, and Other rules), LDAP Directory setup,
3454 and Color configuration.
3455 In particular, the &quot;Config&quot; subcommand has many features you may
3456 set or unset and many other configuration variables that may be set to change
3457 the way Alpine works.
3458 Every one of the hundreds of options available in that configuration settings
3459 screen has help text associated with it.
3460 You may read that text by moving the cursor to highlight the option and then
3461 typing the Help command.
3462 <P>
3463 These settings are stored in your personal
3464 &quot;pinerc&quot; configuration file (or, optionally, they may be stored
3465 <A HREF="h_config_remote_config">remotely</A>),
3466 but on shared systems these settings
3467 may be over-ridden by a system-wide control file (due to local site
3468 security or support policies).  A global pine configuration file can also
3469 be used to set default values for all Alpine users on a particular system.
3470 Power users may be interested in splitting their personal configuration
3471 data into two pieces, a generic piece and
3472 <A HREF="h_config_exceptions">exceptions</A> which apply to
3473 a particular platform.
3474 They may also be interested in <A HREF="h_config_inheritance">configuration inheritance</A>.
3475 General Alpine configuration information can be found
3476 <A HREF="h_news_config">here</A>.
3477 <P>
3478 &lt;End of help on this topic&gt;
3479 </BODY>
3480 </HTML>
3481 ===== h_mainhelp_aggops ======
3482 <HTML>
3483 <HEAD>
3484 <TITLE>Aggregate Operations</TITLE>
3485 </HEAD>
3486 <BODY>
3487 <H1>Aggregate Operations</H1>
3488
3489 When you are in the MESSAGE INDEX, the available commands
3490 (for example, Delete, Undelete, Save, Reply, and so on)
3491 normally act on a single message.
3492 So, for example, if you press the Delete command, the currently highlighted
3493 message is marked Deleted.
3494 These commands that normally act on a single message may be applied to
3495 several messages at once instead.
3496 <P>
3497 By default this feature is turned on, but it could be administratively turned
3498 off to reduce complexity.
3499 The feature
3500 <A HREF="h_config_enable_agg_ops"><!--#echo var="FEAT_enable-aggregate-command-set"--></A>
3501 in the Setup/Config screen is used to turn it off or on.
3502 When this feature is turned on, the four commands &quot;Select&quot;,
3503 &quot;SelectCur&quot;, &quot;ZoomMode&quot;, and &quot;Apply&quot;
3504 are available.
3505 The two selection commands allow you to mark a set of
3506 messages as being &quot;selected&quot;.
3507 The &quot;ZoomMode&quot; command will toggle between
3508 displaying only the selected messages and displaying all the messages.
3509 The &quot;Apply&quot; command allows you to
3510 apply one of the regular MESSAGE INDEX commands to all of the selected
3511 messages instead of to only the highlighted message.
3512 <P>
3513 An example aggregate operation would be to catch up when reading
3514 a news group.
3515 That is, get rid of all the messages in the news group so that you can
3516 start fresh.
3517 The easiest way to do this in Alpine is to use aggregate operations.
3518 You want to Delete all of the messages in the group.
3519 You could start at the top and type &quot;D&quot; once for every message.
3520 A much faster method is to first Select all of the messages in the group,
3521 and then Delete all of them.
3522 This would take four keystrokes:
3523 <P>
3524 <CENTER><SAMP>; a (to select all messages)</SAMP></CENTER>
3525 <BR>
3526 <CENTER><SAMP>a d (to delete all selected messages)</SAMP></CENTER>
3527 <P>
3528 Another use of Select is to use it for searching for a particular message
3529 or set of messages in a large folder.
3530 You may know that the message was From a certain user.
3531 You could select all messages from that user to start, and use Zoom to
3532 look at only those messages.
3533 If there were still too many messages to look at you could Narrow the
3534 set of messages further by selecting from all of those messages only
3535 the ones that were after a certain date, or contained a particular phrase
3536 in the Subject, or were too a particular address, and so on.
3537 That may be the end of what you are doing, or you may want to use Apply to
3538 Save or Forward or Print all of the selected messages.
3539 <P>
3540 Some related help topics are
3541 <UL>
3542 <LI> <A HREF="h_index_cmd_select">Selecting: Select and WhereIs/Select</A>,
3543 <LI> <A HREF="h_config_enable_agg_ops"><!--#echo var="FEAT_enable-aggregate-command-set"--></A>,
3544 <LI> <A HREF="h_config_auto_unselect"><!--#echo var="FEAT_auto-unselect-after-apply"--></A>.
3545 <LI> <A HREF="h_config_auto_unzoom"><!--#echo var="FEAT_auto-unzoom-after-apply"--></A>,
3546 <LI> <A HREF="h_config_auto_zoom"><!--#echo var="FEAT_auto-zoom-after-select"--></A>, and
3547 <LI> <A HREF="h_config_select_wo_confirm"><!--#echo var="FEAT_select-without-confirm"--></A>.
3548 </UL>
3549 <P>
3550 &lt;End of help on this topic&gt;
3551 </BODY>
3552 </HTML>
3553 ===== h_mainhelp_readingnews ======
3554 <HTML>
3555 <HEAD>
3556 <TITLE>Reading News</TITLE>
3557 </HEAD>
3558 <BODY>
3559 <H1>Reading News</H1>
3560
3561 <H2>Background</H2>
3562 Alpine can read and post to Internet (or USENET) newsgroups, using the same
3563 commands as for mail. Similar to mailing lists but existing on a larger scale,
3564 Usenet newsgroups allow groups of people with common interests to discuss
3565 particular topics. You might find newsgroups related to your career, or you
3566 might wish to check out the online discussion among the fans of your favorite
3567 television show.
3568
3569 <H2>Configuring Alpine for Reading News</H2>
3570 Alpine often arrives
3571 pre-configured by your system administrator to automatically access the
3572 newsgroups offered by your organization, Internet Service Provider, or
3573 school. PC-Alpine users, and those attempting to customize Unix Alpine, will
3574 need additional details on <a href="h_configuring_news">how to
3575 configure Alpine to read news</a>.
3576
3577 <H2>Accessing Newsgroups</H2>
3578 The first step in reading news is to access the newsgroups collections
3579 screen from Alpine. If everything is configured properly, you should be able
3580 to do this by first typing L (folder List), then selecting the folder
3581 collection listed as "News." The actual name of this collection may differ
3582 from system to system.
3583
3584 <H2>Subscribing to Newsgroups</H2>
3585
3586 Once you have accessed the news collection, you need to subscribe to a
3587 newsgroup that interests you. Subscribing to a newsgroup means that Alpine
3588 will keep a record of the newsgroups in which you are interested and which
3589 articles in those newsgroups have been read.
3590
3591 <H2>Using Newsgroups</H2>
3592 Alpine uses the similar commands to read news as to read mail. For example,
3593 the D command marks messages as Deleted (or "Dismissed," if you prefer),
3594 and the R command Replies to a news posting. Basically, Alpine allows you to
3595 read news as if it were mail, so you don't need to change the way you
3596 interact with Alpine.
3597 <P>
3598 There is also additional Alpine help available on
3599 <A HREF="h_reading_news">how to use Alpine to read news</A>.
3600 <P>
3601 &lt;End of help on this topic&gt;
3602 </BODY>
3603 </HTML>
3604 ===== h_mainhelp_securing ======
3605 <HTML>
3606 <HEAD>
3607 <TITLE>Securing your Alpine Session</TITLE>
3608 </HEAD>
3609 <BODY>
3610 <H1>Securing your Alpine Session</H1>
3611
3612 By default, Alpine will attempt to connect to an IMAP server on the normal
3613 IMAP service port (143).
3614 If the Alpine you are using has been built to
3615 support &quot;Transport Layer Security&quot; (TLS)
3616 and &quot;Secure Sockets Layer&quot; (SSL)
3617 (check by clicking <A HREF="X-Alpine-Config:">here</A>),
3618 and the server offers the STARTTLS capability, then a secure (encrypted)
3619 session will be established.
3620 <P>
3621 When you are connected to a remote folder the titlebar will contain a plus sign
3622 in the far right column if the connection is encrypted using TLS or SSL.
3623 Similarly, when you are being prompted for a password a plus sign will appear in the prompt
3624 if the connection is encrypted.
3625
3626 <H2>More Information on Alpine with SSL and TLS</H2>
3627 <UL>
3628 <LI> <A HREF="h_release_tlscerts">TLS and SSL Usage Note</A> </LI>
3629 <LI> <A HREF="h_folder_server_syntax">/SSL</A> option for older servers which support port 993 SSL but not TLS </LI>
3630 <LI> <A HREF="h_config_alt_auth"><!--#echo var="FEAT_try-alternative-authentication-driver-first"--></A> feature </LI>
3631 <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>
3632 </UL>
3633 <H2>Here are some other security-related features and options</H2>
3634 <P>
3635 <UL>
3636 <LI> <A HREF="h_config_disable_password_caching"><!--#echo var="FEAT_disable-password-caching"--></A> feature to disable password caching </LI>
3637 <LI> <A HREF="h_config_disable_password_file_saving"><!--#echo var="FEAT_disable-password-file-saving"--></A> Disable password file saving</LI>
3638 <LI> <A HREF="h_config_mailcap_params"><!--#echo var="FEAT_enable-mailcap-param-substitution"--></A> feature </LI>
3639 <LI> <A HREF="h_config_disable_auths"><!--#echo var="VAR_disable-these-authenticators"--></A> option </LI>
3640 <LI> <A HREF="h_config_encryption_range"><!--#echo var="VAR_encryption-protocol-range"--></A> option </LI>
3641 </UL>
3642 <P>
3643 &lt;End of help on this topic&gt;
3644 </BODY>
3645 </HTML>
3646 ===== h_mainhelp_problems ======
3647 <HTML>
3648 <HEAD>
3649 <TITLE>Reporting Problems</TITLE>
3650 </HEAD>
3651 <BODY>
3652 <H1>Reporting Problems</H1>
3653
3654 We ask that you first read the relevant help screens and then seek
3655 assistance from your own local support staff.  Once you are sure that your
3656 difficulty is not a local configuration problem, you might look at the
3657 help section explaining where to look for
3658 <A HREF="h_finding_help">more information</A> and where to
3659 get assistance.
3660 <P>
3661
3662 <ADDRESS>
3663    Eduardo Chappa &lt;chappa@gmx.com&gt;
3664 </ADDRESS>
3665
3666 <P>
3667 &lt;End of help on this topic&gt;
3668 </BODY>
3669 </HTML>
3670 ===== h_main_menu_commands ======
3671 <HTML>
3672 <HEAD>
3673 <TITLE>MAIN MENU COMMANDS</TITLE>
3674 </HEAD>
3675 <BODY>
3676 <H1>MAIN MENU COMMANDS</H1>
3677
3678 <!--chtml if pinemode="function_key"-->
3679 &nbsp;Available&nbsp;Commands&nbsp;--
3680 &nbsp;Group&nbsp;1&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;2<BR>
3681 &nbsp;------------------------------
3682 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;--------------------
3683 ----------<BR>
3684 &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>
3685 &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>
3686 &nbsp;F3&nbsp;&nbsp;Quit&nbsp;Alpine<BR>
3687 &nbsp;F4&nbsp;&nbsp;Execute&nbsp;current&nbsp;MAIN&nbsp;MENU&nbsp;command&nbsp;&nbsp;&nbsp;F4&nbsp;&nbsp;<A
3688 HREF="h_common_compose">Compose</A>&nbsp;a&nbsp;message<BR>
3689 &nbsp;F5&nbsp;&nbsp;Select&nbsp;previous&nbsp;command&nbsp;up&nbsp;on&nbsp;menu&nbsp;&nbsp;F5&nbsp;&nbsp;<A
3690 HREF="h_common_folders">FOLDER&nbsp;LIST</A>&nbsp;screen<BR>
3691 &nbsp;F6&nbsp;&nbsp;Select&nbsp;next&nbsp;command&nbsp;down&nbsp;on&nbsp;menu&nbsp;&nbsp;&nbsp;&nbsp;F6&nbsp;&nbsp;<A
3692 HREF="h_common_goto">Goto</A>&nbsp;a&nbsp;specified&nbsp;folder<BR>
3693 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
3694 &nbsp;F7&nbsp;&nbsp;<A
3695 HREF="h_common_index">MESSAGE&nbsp;INDEX</A>&nbsp;screen<BR>
3696 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
3697 &nbsp;F8&nbsp;&nbsp;<A
3698 HREF="h_main_journal">Journal</A>&nbsp;of&nbsp;status&nbsp;messages<BR>
3699 &nbsp;F9&nbsp;&nbsp;Display&nbsp;<A
3700 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
3701 HREF="h_main_setup">SETUP</A>&nbsp;menus<BR>
3702 &nbsp;F10&nbsp;<A
3703 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
3704 HREF="h_main_addrbook">ADDRESS&nbsp;BOOK</A>&nbsp;screen<BR>
3705 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
3706 &nbsp;F11&nbsp;<A
3707 HREF="h_common_role">Compose&nbsp;message&nbsp;using&nbsp;a&nbsp;role</a><BR>
3708 <!--chtml else-->
3709 &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>
3710 &nbsp;---------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;--------------------------<BR>
3711 &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>
3712 &nbsp;C&nbsp;&nbsp;<A
3713 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>
3714 &nbsp;I&nbsp;&nbsp;<A
3715 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>
3716 &nbsp;L&nbsp;&nbsp;<A
3717 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>
3718 &nbsp;A&nbsp;&nbsp;<A
3719 HREF="h_main_addrbook">ADDRESS&nbsp;BOOK</A>&nbsp;screen&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;K&nbsp;&nbsp;<A
3720 HREF="h_main_kblock">Lock&nbsp;Keyboard</A><BR>
3721 &nbsp;S&nbsp;&nbsp;<A
3722 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
3723 HREF="h_common_goto">Goto</A>&nbsp;a&nbsp;specified&nbsp;folder<BR>
3724 &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>
3725 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&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
3726 HREF="h_common_role">Compose&nbsp;message&nbsp;using&nbsp;a&nbsp;role</a><BR>
3727 <!--chtml endif-->
3728
3729 <P>
3730 NOTE:
3731 <OL>
3732  <LI>For help on a particular command, highlight the bold text associated
3733 with it above and hit Return.
3734  <LI> The availability of certain commands (e.g. some of the options under
3735 SETUP) is determined by Alpine configuration files and system capabilities.
3736 At some sites, certain commands may not be available due to security or
3737 support concerns.
3738 </OL>
3739 <P>
3740 &lt;End of help on this topic&gt;
3741 </BODY>
3742 </HTML>
3743
3744 ===== h_command_line_options ======
3745 <HTML>
3746 <HEAD>
3747 <TITLE>COMMAND LINE OPTIONS</TITLE>
3748 </HEAD>
3749 <BODY>
3750 <H1>COMMAND LINE OPTIONS</H1>
3751 Possible starting arguments for Alpine:
3752
3753 <DL COMPACT>
3754
3755 <DT> <EM>[addresses]</EM>
3756
3757 <DD> Send-to:  If you give <EM>Alpine</EM> an argument or arguments which
3758 do not begin with a dash, <EM>Alpine</EM> treats them as email addresses.
3759 <EM>Alpine</EM> will startup in
3760 the composer with a message started to the addresses specified.
3761 Once the message is sent, the <EM>Alpine</EM> session closes.
3762 Standard input redirection is allowed.
3763 Separate multiple addresses with a space between them.
3764 Addresses are placed in the &quot;To&quot; field only.
3765 <P>
3766
3767 <DT> &lt; <EM>file</EM>
3768
3769 <DD> <EM>Alpine</EM> will startup in the composer with <EM>file</EM> read
3770 into the body of the message.
3771 Once the message is sent, the <EM>Alpine</EM> session closes.
3772 <P>
3773
3774 <DT> -attach <EM>file</EM>
3775
3776 <DD> Go directly into composer with given file attached.
3777 <P>
3778
3779 <DT> -attachlist <EM>file-list</EM>
3780
3781 <DD> Go directly into composer with given files attached.
3782 This must be the last option on the command line.
3783 <P>
3784
3785 <DT> -attach_and_delete <EM>file</EM>
3786
3787 <DD> Go directly into composer with given file attached, delete when finished.
3788 <P>
3789
3790 <DT> -aux <EM>local_directory</EM>
3791
3792 <DD> <EM>PC-Alpine</EM> only.
3793 This tells <EM>PC-Alpine</EM> the local directory to use for storing auxiliary
3794 files, like debug files, address books, and signature files.  The pinerc may
3795 be local or remote.
3796 <P>
3797
3798 <DT> -bail
3799
3800 <DD> If the personal configuration file doesn't already exist, exit.
3801 This might be useful if the configuration file is accessed using some
3802 remote filesystem protocol. If the remote mount is missing this will cause
3803 <EM>Alpine</EM> to quit instead of creating a new pinerc.
3804 <P>
3805
3806 <DT> -c <EM>n</EM>
3807
3808 <DD> When used with the <CODE>-f</CODE> option, apply the <EM>n</EM>th context.
3809 This is used when there are multiple folder collections (contexts) and you
3810 want to open a folder not in the primary collection.
3811 <P>
3812
3813 <DT> -conf
3814
3815 <DD> Configuration: Prints a sample system configuration file to the
3816 screen or standard output. To generate an initial system configuration
3817 file, execute
3818
3819 <PRE><CODE>
3820                 pine -conf > <!--#echo var="PINE_CONF_PATH"-->
3821 </CODE></PRE>
3822 <P>
3823
3824 To generate a system configuration file using settings from an old
3825 system configuration file, execute
3826
3827 <PRE><CODE>
3828                 pine -P old-pine.conf -conf > <!--#echo var="PINE_CONF_PATH"-->
3829 </CODE></PRE>
3830 <P>
3831 A system configuration file is not required.
3832 <P>
3833
3834 <DT> -copy_abook &lt;<EM>local_abook_file</EM>&gt; &lt;<EM>remote_abook_folder</EM>&gt;
3835
3836 <DD> Copy an address book file to a remote address book folder.
3837 If the remote folder doesn't exist, it will be created.
3838 If it exists but the first message in the folder isn't a remote address
3839 book header message, the copy will be aborted.
3840 This flag will not usually be used by a user.
3841 Instead, the user will create a remote address book from within <EM>Alpine</EM>
3842 and copy entries from the local address book by using aggregate Save in
3843 the address book screen.
3844 <P>
3845
3846 <DT> -copy_pinerc &lt;<EM>local_pinerc_file</EM>&gt; &lt;<EM>remote_pinerc_folder</EM>&gt;
3847
3848 <DD> Copy a pinerc configuration file to a remote pinerc folder.
3849 If the remote folder doesn't exist, it will be created.
3850 If it exists but the first message in the folder isn't a remote pinerc
3851 header message, the copy will be aborted.
3852 This flag may be useful to users who already have a local pinerc file and
3853 would like to convert it to a remote pinerc folder and use that instead.
3854 This gives a way to bootstrap that conversion without having to manually
3855 reset all of the variables in the remote pinerc folder.
3856 <P>
3857
3858 <DT> -d <EM>debug-level</EM>
3859
3860 <DD> Debug Level:  Sets the level of debugging information written by
3861 <EM>Alpine</EM>.
3862 <EM>debug-level</EM> can be set to any integer 0-9.
3863 A debug level of 0 turns off debugging for the session.
3864 (Actually there are some levels higher than 9, but you probably don't
3865 want to see them.)
3866 <P>
3867
3868 <DT> -d <EM>keywords</EM>
3869
3870 <DD> You may use a more detailed version of the debugging flag to set
3871 the debug level in separate parts of <EM>Alpine</EM>.
3872 The possibilities are flush, timestamp, imap=0..4, tcp, numfiles=0..31, and
3873 verbose=0..9.
3874 <EM>Flush</EM> causes debugging information to be flushed immediately to
3875 the debug file as it is written.
3876 <EM>Verbose</EM> is the general debugging verbosity level.
3877 <EM>Timestamp</EM> causes timestamps to be added to the debug file, which
3878 is useful when you are trying to figure out what is responsible for delays.
3879 <EM>Numfiles</EM> sets the number of debug files saved.
3880 <EM>Imap</EM> sets the debug level for the debugging statements related
3881 to the conversation with the IMAP server, and more generally, for the
3882 debugging related to <EM>Alpine</EM>'s interaction with the C-Client library.
3883 <EM>Tcp</EM> turns on some TCP/IP debugging.
3884 <P>
3885
3886 <DT> -f <EM>folder</EM>
3887
3888 <DD> Startup folder:  <EM>Alpine</EM> will open this folder in place
3889 of the standard INBOX.
3890 <P>
3891
3892 <DT> -F <EM>file</EM>
3893
3894 <DD> Open named text file for viewing and forwarding.
3895 <P>
3896
3897 <DT> -h
3898
3899 <DD> Help:  Prints the list of available command-line arguments to the
3900 screen.
3901 <P>
3902
3903 <DT> -i
3904
3905 <DD> <EM>Alpine</EM> will start up in the FOLDER INDEX
3906 screen instead of the MAIN MENU.
3907 <P>
3908
3909 Configuration equivalent:  <EM><!--#echo var="VAR_initial-keystroke-list"-->=i</EM>.
3910 <P>
3911
3912 <DT> -I <EM>a,b,c,...</EM>
3913
3914 <DD> Initial Keystrokes:  <EM>Alpine</EM> will execute this comma-separated
3915 sequence of commands upon startup.
3916 This allows users to get <EM>Alpine</EM> to start in any
3917 of its menus/screens.
3918 You cannot include any input to the composer in the initial keystrokes.
3919 The key &lt;Return&gt; is represented by a ``CR'' in
3920 the keystroke list; the spacebar is designated by the letters ``SPACE''.
3921 Control keys are two character sequences beginning with ``^'', such as
3922 ``^I''.
3923 A tab character is ``TAB''.
3924 Function keys are ``F1'' - ``F12'' and the arrow keys are ``UP'',
3925 ``DOWN'', ``LEFT'', and ``RIGHT''.
3926 A restriction is that you can't mix function keys and character keys in this
3927 list even though you can, in some cases, mix them when running <EM>Alpine</EM>.
3928 A user can always use only <EM>character</EM> keys in the startup list even
3929 if he or she is using <EM>function</EM> keys normally, or vice versa.
3930 If an element in this list is a string of characters surrounded by double
3931 quotes (&quot;) then it will be expanded into the individual characters in
3932 the string, excluding the double quotes.
3933 <P>
3934
3935 Configuration equivalent:  <EM><!--#echo var="VAR_initial-keystroke-list"--></EM>
3936 <P>
3937
3938 <DT> -install
3939
3940 <DD> For <EM>PC-Alpine</EM> only, this option prompts the user for
3941 some basic information to help with getting properly set up.
3942 <P>
3943
3944 <DT> -k
3945
3946 <DD> Function-Key Mode:  When invoked in this way, <EM>Alpine</EM> expects
3947 the input of commands to be function-keys.
3948 Otherwise, commands are linked to the regular character keys.
3949 <P>
3950
3951 Configuration equivalent:  <EM><!--#echo var="FEAT_use-function-keys"--></EM> included in
3952 <EM>Feature-List</EM>.
3953 <P>
3954
3955 <DT> -n <EM>n</EM>
3956
3957 <DD> Message-Number:  When specified, <EM>Alpine</EM> starts up in the
3958 FOLDER INDEX screen with the current message being the specified
3959 message number.
3960 <P>
3961
3962 <DT> -nosplash
3963
3964 <DD> <EM>PC-Alpine</EM> only.
3965 This tells <EM>PC-Alpine</EM> not to display the splash screen upon startup.
3966 This may be helpful for certain troubleshooting or terminal server scenarios.
3967 <P>
3968
3969 <DT> -o <EM>folder</EM>
3970
3971 <DD> Opens the INBOX (or a folder specified via the -f argument) ReadOnly.
3972 <P>
3973
3974 <DT> -p <EM>pinerc</EM>
3975
3976 <DD> Uses the named file as the personal configuration file instead of
3977 <EM>~/.pinerc</EM> or the default PINERC search sequence <EM>PC-Alpine</EM> uses.
3978 Alpinerc may be either a local file or a remote configuration folder.
3979 <P>
3980
3981 <DT> -P <EM>pinerc</EM>
3982
3983 <DD> Uses the named file as the system wide configuration file instead of
3984 <EM><!--#echo var="PINE_CONF_PATH"--></EM> on UNIX, or nothing on <EM>PC-Alpine</EM>.
3985 Alpinerc may be either a local file or a remote configuration folder.
3986 <P>
3987
3988 <DT> -passfile <EM>passfile</EM>
3989
3990 <DD> This tells <EM>Alpine</EM> what file should be used as the password file.
3991 This should be a fully-qualified filename.
3992 <P>
3993
3994 <DT> -pinerc <EM>file</EM>
3995
3996 <DD> Output fresh pinerc configuration to <EM>file</EM>, preserving the
3997 settings of variables that the user has made.
3998 Use <EM>file</EM> set to ``-'' to make output go to standard out.
3999 <P>
4000
4001 <DT> -r
4002
4003 <DD> Restricted Mode:  For UNIX <EM>Alpine</EM> only.
4004 <EM>Alpine</EM> in restricted mode can only send email to itself.
4005 Save and export are limited.
4006 <P>
4007
4008 <DT> -registry <EM>cmd</EM>
4009
4010 <DD> For <EM>PC-Alpine</EM> only, this option affects the values of
4011 <EM>Alpine</EM>'s registry entries.
4012 Possible values for <EM>cmd</EM> are set, clear, and dump.
4013 <EM>Set</EM> will always reset <EM>Alpine</EM>'s registry
4014 entries according to its current settings.
4015 <EM>Clear</EM> will clear the registry values.
4016 <EM>Clearsilent</EM> will clear the registry values without any dialogs.
4017 <EM>Dump</EM> will display the values of current registry settings.
4018 Note that the dump command is currently disabled.
4019 Without the -registry option, <EM>PC-Alpine</EM> will write values into
4020 the registry only if there currently aren't any values set.
4021 <P>
4022
4023 <DT> -sort <EM>key</EM>
4024
4025 <DD> Sort-Key:  Specifies the order messages will be displayed in for the
4026 FOLDER INDEX screen.
4027 <EM>Key</EM> can have the following values:
4028 arrival, date, subject, orderedsubj, thread, from, size, score, to, cc,
4029 arrival/reverse, date/reverse, subject/reverse, orderedsubj/reverse, thread/reverse,
4030 from/reverse, size/reverse, score/reverse, to/reverse, and cc/reverse.
4031 The default value is &quot;arrival&quot;.
4032 The <EM>key</EM> value reverse is equivalent to arrival/reverse.
4033 <P>
4034
4035 Configuration equivalent:  <EM><!--#echo var="VAR_sort-key"--></EM>.
4036 <P>
4037
4038 <DT> -uninstall
4039
4040 <DD> For <EM>PC-Alpine</EM> only, this option removes references to Alpine
4041 in Windows settings.  The registry settings are removed and
4042 the password cache is cleared.
4043 <P>
4044
4045 <DT> -url <EM>url</EM>
4046
4047 <DD> Open the given URL.
4048 <P>
4049
4050 <DT> -v
4051
4052 <DD> Version:  Print version information to the screen.
4053 <P>
4054
4055 <DT> -x <EM>exceptions_config</EM>
4056
4057 <DD> Configuration settings in the exceptions configuration override your normal
4058 default settings.
4059 <EM>Exceptions_config</EM> may be either a local file or a remote Alpine configuration folder.
4060 <P>
4061
4062 <DT> -z
4063
4064 <DD> Enable Suspend:  When run with this flag, the key sequence ctrl-z
4065 will suspend the <EM>Alpine</EM> session.
4066 <P>
4067
4068 Configuration equivalent:  <EM><!--#echo var="FEAT_enable-suspend"--></EM> included in
4069 <EM>Feature-List</EM>.
4070 <P>
4071
4072 <DT> -<EM>option</EM>=<EM>value</EM>
4073
4074 <DD> Assign <EM>value</EM> to the config option <EM>option</EM>.
4075 For example, <EM>-signature-file=sig1</EM> or
4076 <EM>-Feature-List=signature-at-bottom</EM>.
4077 Note:  Feature-List values are
4078 additive and features may be preceded with no- to turn them off.
4079 Also, as a special case, the &quot;Feature-List=&quot; part of that may be
4080 omitted. For example, <EM>-signature-at-bottom</EM> is equivalent to
4081 <EM>-Feature-List=signature-at-bottom</EM>.
4082 <P>
4083
4084 </DL>
4085 <P>
4086 &lt;End of help on this topic&gt;
4087 </BODY>
4088 </HTML>
4089 ===== h_configuring_news ======
4090 <HTML>
4091 <HEAD>
4092 <TITLE>CONFIGURING NEWS</TITLE>
4093 </HEAD>
4094 <BODY>
4095 <H1>CONFIGURING NEWS</H1>
4096 Alpine can access news folders in any one of three different ways:
4097 <DL>
4098 <DT>REMOTE NNTP</DT>
4099 <DD>Using the Network News Transport Protocol (NNTP) to
4100 access news on a remote news server.  In this case the newsrc file is
4101 stored on the machine where Alpine is running.
4102
4103 <P>
4104 To specify a remote news-collection accessed via NNTP use the
4105 SETUP/collectionList screen's &quot;Add&quot; command.  Set the
4106 Server: value to the NNTP server's hostname appended with the
4107 communication method &quot;/service=NNTP&quot;, and set the Path:
4108 value to the &quot;#news.&quot; namespace (without the quotes).  See
4109 the &quot;<A HREF="h_composer_cntxt_server">Server:</A>&quot; field's
4110 help text for a more complete explanation of access method, and the
4111 &quot;<A HREF="h_composer_cntxt_path">Path:</A>&quot; field's help
4112 text for a more complete explanation of &quot;namespace&quot;.
4113 <P>
4114 Instead of specifying a news-collection, you may simply set the
4115 <A HREF="h_config_nntp_server">NNTP Server</A>
4116 option, which will cause Alpine to create a default news-collection for you.
4117 Another NNTP option that may be of interest is
4118 <A HREF="h_config_nntprange"><!--#echo var="VAR_nntp-range"--></A>.
4119
4120 <DT>REMOTE IMAP</DT>
4121 <DD>Using the Internet Message Access Protocol (IMAP) to
4122 access news on a remote news server.  In this case, your newsrc file is
4123 stored on the news server, in your home directory, so you must have an
4124 account on the news server, but you would be running Alpine on a different
4125 machine.  The news server must be running an IMAPd server process.
4126
4127 <P>
4128 To specify a remote news-collection accessed via IMAP use the
4129 SETUP/collectionList screen's &quot;Add&quot; command.  Set the
4130 Server: value to the IMAP server's hostname, and set the Path: value
4131 to the &quot;#news.&quot; namespace (without the quotes).  See the
4132 &quot;<A HREF="h_composer_cntxt_path">Path:</A>&quot; field's help
4133 text for a more complete explanation of &quot;namespace&quot;.
4134
4135 </DD>
4136
4137 <DT>LOCAL</DT>
4138 <DD>Using local file access to the news database.  In this
4139 case, your newsrc file is stored on the news server, in your home
4140 directory, so you must have an account on the news server, and you would
4141 be running Alpine on the same machine.
4142
4143 <P>
4144 To specify a local news-collection use the SETUP/collectionList
4145 screen's &quot;Add&quot; command.  Leave the Server: value blank, and
4146 set the Path: value to the &quot;#news.&quot; namespace (without the
4147 quotes).  See the &quot;<A HREF="h_composer_cntxt_path">Path:</A>&quot;
4148 field's help text for a more complete explanation of &quot;namespace&quot;.
4149
4150 </DD>
4151 </DL>
4152
4153 <P>
4154
4155 NOTE: Should no news-collection be defined as above, Alpine will
4156 automatically create one using the Setup/Config screen's
4157 &quot;<!--#echo var="VAR_nntp-server"-->&quot; variable's value if defined.  The collection
4158 will be created as a &quot;Remote NNTP&quot; as described above.
4159
4160 <P>
4161
4162 If you are a PC-Alpine user, either option 1 (NNTP) or option 2 (IMAP) is
4163 possible.  If you don't have an account on the news server, or if the news
4164 server is not running an IMAP daemon, then you must use NNTP.  (If you are not
4165 sure, ask your service provider, university, or company for help.)  In
4166 this case, your Unix .newsrc file can be transferred to your PC.  A good
4167 place to put it would be in the same directory as your PINERC file, under
4168 the name NEWSRC, but you can
4169 <A HREF="h_config_newsrc_path">specify a different location</A>
4170 via Alpine's Setup/Config screen.
4171
4172 <P>
4173 Other configuration features related to news are
4174 <A HREF="h_config_8bit_nntp"><!--#echo var="FEAT_enable-8bit-nntp-posting"--></A>.
4175 <A HREF="h_config_compose_news_wo_conf"><!--#echo var="FEAT_compose-sets-newsgroup-without-confirm"--></A>,
4176 <A HREF="h_config_news_uses_recent"><!--#echo var="FEAT_news-approximates-new-status"--></A>,
4177 <A HREF="h_config_news_cross_deletes"><!--#echo var="FEAT_news-deletes-across-groups"--></A>,
4178 <A HREF="h_config_news_catchup"><!--#echo var="FEAT_news-offers-catchup-on-close"--></A>,
4179 <A HREF="h_config_post_wo_validation"><!--#echo var="FEAT_news-post-without-validation"--></A>,
4180 <A HREF="h_config_read_in_newsrc_order"><!--#echo var="FEAT_news-read-in-newsrc-order"--></A>, and
4181 <A HREF="h_config_quell_post_prompt"><!--#echo var="FEAT_quell-extra-post-prompt"--></A>.
4182
4183 <P>
4184 &lt;End of help on this topic&gt;
4185 </BODY>
4186 </HTML>
4187 ===== h_reading_news ======
4188 <HTML>
4189 <HEAD>
4190 <TITLE>READING NEWS</TITLE>
4191 </HEAD>
4192 <BODY>
4193 <H1>READING NEWS</H1>
4194
4195 Alpine uses almost the same commands for manipulating news folders as for
4196 mail folders.  This means, for example, that when you are done with a
4197 message, you would use &quot;D&quot; to mark it as Deleted (or Dismissed,
4198 if you prefer.)  This &quot;mail-like&quot; behavior differs from that of
4199 most newsreaders, wherein a message is implicitly dismissed after you have
4200 looked at it once. We strongly believe that Alpine should offer as much
4201 consistency as possible between mail and news, so the mail paradigm --
4202 wherein a message does not magically disappear without explicit action by
4203 the user -- is used for news as well. <P>
4204
4205 If you answer a message in a news folder, the index view will show the
4206 &quot;A&quot; flag as usual; but the industry standard file Alpine uses to
4207 keep track of what news as been read has no way of storing this flag, so
4208 it will not be preserved across sessions.  The Deleted flag is the only
4209 one that is preserved when you leave and then return to a newsgroup.  As an
4210 additional note on replies, when you Reply to a newsgroup message and say
4211 you want to reply to all recipients, Alpine will ask if you want to post the
4212 message to all the newsgroups listed in the original message. <P>
4213
4214 If you would like Alpine to mark more-or-less recent news messages as
4215 &quot;New&quot;, then set the
4216 <A HREF="h_config_news_uses_recent">&quot;<!--#echo var="FEAT_news-approximates-new-status"-->&quot;</A>
4217 feature (which is set by default).  This will cause messages after the last one you have marked as
4218 Deleted to appear with &quot;N&quot; status in the MESSAGE INDEX.  The
4219 &quot;N&quot; status often makes it easier to distinguish later news
4220 articles from those you've previously seen, but not yet disposed of via
4221 the &quot;D&quot; key.  Note that this is an approximation, not an exact
4222 record of which messages you have not seen.
4223 <P>
4224
4225 A frequent operation in news-reading is &quot;catching up&quot; -- that
4226 is, getting rid of all the messages in the newsgroup so that you can
4227 &quot;start fresh.&quot;  The easiest way to do this in Alpine is via the
4228 Select command.  You would enter the following four keystrokes:
4229 <tt>;aad</tt> to select all messaged, and then apply the delete (or
4230 dismiss) command to all of them.
4231
4232 <P>
4233 There are also additional details on
4234 <A HREF="h_configuring_news">configuring news</a>.
4235
4236 <P>
4237 &lt;End of help on this topic&gt;
4238 </BODY>
4239 </HTML>
4240 ====== h_help_index ======
4241 <HTML>
4242 <HEAD>
4243 <TITLE>Help Index</TITLE>
4244 </HEAD>
4245 <BODY>
4246 <H1>Help Index</H1>
4247 <ul>
4248 <li><a href="h_mainhelp_abooks">Address Books</a></li>
4249 <li><a href="h_abook_top">ADDRESS BOOK LIST COMMANDS</a>
4250 <li><a href="h_main_addrbook">Address Book Command</a>
4251 <li><a href="h_abook_view">Address Book View Explained</a>
4252 <li><a href="h_compose_addrcomplete">Address Completion</a>
4253 <li><a href="h_abook_select_listmode">Address Listmode Selection from Composer Explained</a>
4254 <li><a href="h_abook_select_checks">Address Selection from Composer Explained</a>
4255 <li><a href="h_composer_abook_comment">Addressbook Comment Explained</a>
4256 <li><a href="h_composer_abook_fcc">Addressbook Fcc Explained</a>
4257 <li><a href="h_composer_abook_add_folder">Addressbook Folder Name Field Explained</a>
4258 <li><a href="h_composer_abook_full">Addressbook Fullname Explained</a>
4259 <li><a href="h_composer_abook_add_nick">Addressbook NickName Field Explained</a>
4260 <li><a href="h_composer_abook_nick">Addressbook Nickname Explained</a>
4261 <li><a href="h_abook_select_addr">Addressbook Selection Explained</a>
4262 <li><a href="h_abook_select_top">Addressbook Selection Navigation Explained</a>
4263 <li><a href="h_composer_abook_add_server">Addressbook Server Name Field Explained</a>
4264 <li><a href="h_mainhelp_aggops">Aggregate Operations</a>
4265 <li><a href="h_mainhelp_config">Alpine Configuration</a>
4266 <li><a href="h_mainhelp_pinehelp">Alpine Help</a>
4267 <li><a href="h_news_legal">Alpine Legal Notices</a>
4268 <li><a href="h_compose_alted">Alt Editor Command</a>
4269 <li><a href="h_index_cmd_apply">Apply Command</a>
4270 <li><a href="h_attachment_screen">Attachment Index Screen Explained</a>
4271 <li><a href="h_mail_text_att_view">Attachment View Screen Explained</a>
4272 <li><a href="h_mainhelp_filtering">Blocking Messages</a>
4273 <li><a href="h_composer_browse">BROWSER</a>
4274 <li><a href="h_common_bounce">Bounce Command</a>
4275 <li><a href="h_compose_cancel">Cancel Command</a>
4276 <li><a href="h_config_change_your_from">Changing your From Address</a>
4277 <li><a href="h_collection_screen">COLLECTION LIST screen</a>
4278 <li><a href="h_mainhelp_color">Color</a>
4279 <li><a href="h_composer_ctrl_j">COMPOSER ATTACH</a>
4280 <li><a href="h_composer">COMPOSER COMMANDS</a>
4281 <li><a href="h_mainhelp_composing">Composing Messages</a>
4282 <li><a href="h_mainhelp_collections">Collection Lists</a>
4283 <li><a href="h_composer_cntxt_nick">Collection Nickname Explained</a>
4284 <li><a href="h_composer_cntxt_path">Collection Path: Explained</a>
4285 <li><a href="h_composer_cntxt_server">Collection Server: Explained</a>
4286 <li><a href="h_composer_cntxt_view">Collection View: Explained</a>
4287 <li><a href="h_mainhelp_cmdlineopts">Command Line Options</a>
4288 <li><a href="h_common_compose">Compose Command</a>
4289 <li><a href="h_edit_nav_cmds">Composer Editing Commands Explained</a>
4290 <li><a href="h_common_conditional_cmds">Conditional Commands</a>
4291 <li><a href="h_reply_token_conditionals">Conditional Inclusion of Text for <!--#echo var="VAR_reply-leadin"-->, Signatures, and Templates</a>
4292 <li><a href="h_mainhelp_config">Configuration</a>
4293 <li><a href="h_composer_custom_free">CUSTOMIZED HEADER FIELD</a>
4294 <li><a href="h_config_dflt_color">Default Color</a>
4295 <li><a href="h_common_delete">Delete and Undelete Commands</a>
4296 <li><a href="h_composer_qserv_cn">Directory Query Form Explained</a>
4297 <li><a href="h_special_list_commands">Email List Commands Explained</a>
4298 <li><a href="h_composer_search">Explanation of Composer Whereis Command </a>
4299 <li><a href="h_folder_open">Explanation of Folder Selection</a>
4300 <li><a href="h_special_xon_xoff">Explanation of Alpine's XOFF/XON Handling</a>
4301 <li><a href="h_valid_folder_names">Explanation of Valid Folder Names</a>
4302 <li><a href="h_ge_export">Export File Selection</a>
4303 <li><a href="h_ge_allparts">Export Message File Selection</a>
4304 <li><a href="h_index_cmd_expunge">Expunge/Exclude Command</a>
4305 <li><a href="h_info_on_locking">FAQs on Alpine Locking</a>
4306 <li><a href="h_config_allow_chg_from">FEATURE: <!--#echo var="FEAT_allow-changing-from"--></a>
4307 <li><a href="h_config_allow_talk">FEATURE: <!--#echo var="FEAT_allow-talk"--></a>
4308 <li><a href="h_config_alt_compose_menu">FEATURE: <!--#echo var="FEAT_alternate-compose-menu"--></a>
4309 <li><a href="h_config_alt_role_menu">FEATURE: <!--#echo var="FEAT_alternate-role-menu"--></a>
4310 <li><a href="h_config_alt_reply_menu">FEATURE: <!--#echo var="FEAT_alternate-reply-menu"--></a>
4311 <li><a href="h_config_force_low_speed">FEATURE: <!--#echo var="FEAT_assume-slow-link"--></a>
4312 <li><a href="h_config_auto_read_msgs">FEATURE: <!--#echo var="FEAT_auto-move-read-msgs"--></a>
4313 <li><a href="h_config_auto_open_unread">FEATURE: <!--#echo var="FEAT_auto-open-next-unread"--></a>
4314 <li><a href="h_config_auto_unselect">FEATURE: <!--#echo var="FEAT_auto-unselect-after-apply"--></a>
4315 <li><a href="h_config_auto_unzoom">FEATURE: <!--#echo var="FEAT_auto-unzoom-after-apply"--></a>
4316 <li><a href="h_config_auto_zoom">FEATURE: <!--#echo var="FEAT_auto-zoom-after-select"--></a>
4317 <li><a href="h_config_use_boring_spinner">FEATURE: <!--#echo var="FEAT_busy-cue-spinner-only"--></a>
4318 <li><a href="h_config_check_mail_onquit">FEATURE: <!--#echo var="FEAT_check-newmail-when-quitting"--></a>
4319 <li><a href="h_config_combined_abook_display">FEATURE: <!--#echo var="FEAT_combined-addrbook-display"--></a>
4320 <li><a href="h_config_combined_folder_display">FEATURE: <!--#echo var="FEAT_combined-folder-display"--></a>
4321 <li><a href="h_config_combined_subdir_display">FEATURE: <!--#echo var="FEAT_combined-subdirectory-display"--></a>
4322 <li><a href="h_config_cancel_confirm">FEATURE: <!--#echo var="FEAT_compose-cancel-confirm-uses-yes"--></a>
4323 <li><a href="h_config_lame_list_mode">FEATURE: <!--#echo var="FEAT_enable-lame-list-mode"--></a>
4324 <li><a href="h_config_compose_rejects_unqual">FEATURE: <!--#echo var="FEAT_compose-rejects-unqualified-addrs"--></a>
4325 <li><a href="h_config_send_filter_dflt">FEATURE: <!--#echo var="FEAT_compose-send-offers-first-filter"--></a>
4326 <li><a href="h_config_compose_news_wo_conf">FEATURE: <!--#echo var="FEAT_compose-sets-newsgroup-without-confirm"--></a>
4327 <li><a href="h_config_del_from_dot">FEATURE: <!--#echo var="FEAT_compose-cut-from-cursor"--></a>
4328 <li><a href="h_config_compose_maps_del">FEATURE: <!--#echo var="FEAT_compose-maps-delete-key-to-ctrl-d"--></a>
4329 <li><a href="h_config_confirm_role">FEATURE: <!--#echo var="FEAT_confirm-role-even-for-default"--></a>
4330 <li><a href="h_config_tab_no_prompt">FEATURE: <!--#echo var="FEAT_continue-tab-without-confirm"--></a>
4331 <li><a href="h_config_dates_to_local">FEATURE: <!--#echo var="FEAT_convert-dates-to-localtime"--></a>
4332 <li><a href="h_config_copy_to_to_from">FEATURE: <!--#echo var="FEAT_copy-to-address-to-from-if-it-is-us"--></a>
4333 <li><a href="h_config_del_skips_del">FEATURE: <!--#echo var="FEAT_delete-skips-deleted"--></a>
4334 <li><a href="h_config_disable_config_cmd">FEATURE: <!--#echo var="FEAT_disable-config-cmd"--></a>
4335 <li><a href="h_config_disable_index_locale_dates">FEATURE: <!--#echo var="FEAT_disable-index-locale-dates"--></a>
4336 <li><a href="h_config_disable_kb_lock">FEATURE: <!--#echo var="FEAT_disable-keyboard-lock-cmd"--></a>
4337 <li><a href="h_config_blank_keymenu">FEATURE: <!--#echo var="FEAT_disable-keymenu"--></a>
4338 <li><a href="h_config_disable_password_caching">FEATURE: <!--#echo var="FEAT_disable-password-caching"--></a>
4339 <li><a href="h_config_disable_password_cmd">FEATURE: <!--#echo var="FEAT_disable-password-cmd"--></a>
4340 <li><a href="h_config_disable_pipes_in_sigs">FEATURE: <!--#echo var="FEAT_disable-pipes-in-sigs"--></a>
4341 <li><a href="h_config_disable_pipes_in_templates">FEATURE: <!--#echo var="FEAT_disable-pipes-in-templates"--></a>
4342 <li><a href="h_config_disable_regex">FEATURE: <!--#echo var="FEAT_disable-regular-expression-matching-for-alternate-addresses"--></a>
4343 <li><a href="h_config_disable_roles_setup">FEATURE: <!--#echo var="FEAT_disable-roles-setup-cmd"--></a>
4344 <li><a href="h_config_disable_roles_sigedit">FEATURE: <!--#echo var="FEAT_disable-roles-sig-edit"--></a>
4345 <li><a href="h_config_disable_roles_templateedit">FEATURE: <!--#echo var="FEAT_disable-roles-template-edit"--></a>
4346 <li><a href="h_config_input_history">FEATURE: <!--#echo var="FEAT_disable-save-input-history"--></a>
4347 <li><a href="h_config_disable_collate">FEATURE: <!--#echo var="FEAT_disable-setlocale-collate"--></a>
4348 <li><a href="h_config_disable_shared">FEATURE: <!--#echo var="FEAT_disable-shared-namespaces"--></a>
4349 <li><a href="h_config_disable_signature_edit">FEATURE: <!--#echo var="FEAT_disable-signature-edit-cmd"--></a>
4350 <li><a href="h_config_take_fullname">FEATURE: <!--#echo var="FEAT_disable-take-fullname-in-addresses"--></a>
4351 <li><a href="h_config_take_lastfirst">FEATURE: <!--#echo var="FEAT_disable-take-last-comma-first"--></a>
4352 <li><a href="h_config_disable_reset_disp">FEATURE: <!--#echo var="FEAT_disable-terminal-reset-for-display-filters"--></a>
4353 <li><a href="h_config_disable_sender">FEATURE: <!--#echo var="FEAT_disable-sender"--></a>
4354 <li><a href="h_config_quell_dead_letter">FEATURE: <!--#echo var="FEAT_quell-dead-letter-on-cancel"--></a>
4355 <li><a href="h_config_quell_flowed_text">FEATURE: <!--#echo var="FEAT_quell-flowed-text"--></a>
4356 <li><a href="h_downgrade_multipart_to_text">FEATURE: <!--#echo var="FEAT_downgrade-multipart-to-text"--></a>
4357 <li><a href="h_config_8bit_smtp">FEATURE: <!--#echo var="FEAT_enable-8bit-esmtp-negotiation"--></a>
4358 <li><a href="h_config_8bit_nntp">FEATURE: <!--#echo var="FEAT_enable-8bit-nntp-posting"--></a>
4359 <li><a href="h_config_enable_agg_ops">FEATURE: <!--#echo var="FEAT_enable-aggregate-command-set"--></a>
4360 <li><a href="h_config_enable_alt_ed">FEATURE: <!--#echo var="FEAT_enable-alternate-editor-cmd"--></a>
4361 <li><a href="h_config_alt_ed_now">FEATURE: <!--#echo var="FEAT_enable-alternate-editor-implicitly"--></a>
4362 <li><a href="h_config_arrow_nav">FEATURE: <!--#echo var="FEAT_enable-arrow-navigation"--></a>
4363 <li><a href="h_config_relaxed_arrow_nav">FEATURE: <!--#echo var="FEAT_enable-arrow-navigation-relaxed"--></a>
4364 <li><a href="h_config_compose_bg_post">FEATURE: <!--#echo var="FEAT_enable-background-sending"--></a>
4365 <li><a href="h_config_enable_bounce">FEATURE: <!--#echo var="FEAT_enable-bounce-cmd"--></a>
4366 <li><a href="h_config_cruise_mode">FEATURE: <!--#echo var="FEAT_enable-cruise-mode"--></a>
4367 <li><a href="h_config_cruise_mode_delete">FEATURE: <!--#echo var="FEAT_enable-cruise-mode-delete"--></a>
4368 <li><a href="h_config_compose_dsn">FEATURE: <!--#echo var="FEAT_enable-delivery-status-notification"--></a>
4369 <li><a href="h_config_enable_dot_files">FEATURE: <!--#echo var="FEAT_enable-dot-files"--></a>
4370 <li><a href="h_config_enable_lessthan_exit">FEATURE: <!--#echo var="FEAT_enable-exit-via-lessthan-command"--></a>
4371 <li><a href="h_config_fast_recent">FEATURE: <!--#echo var="FEAT_enable-fast-recent-test"--></a>
4372 <li><a href="h_config_enable_flag">FEATURE: <!--#echo var="FEAT_enable-flag-cmd"--></a>
4373 <li><a href="h_config_flag_screen_default">FEATURE: <!--#echo var="FEAT_enable-flag-screen-implicitly"--></a>
4374 <li><a href="h_config_flag_screen_kw_shortcut">FEATURE: <!--#echo var="FEAT_enable-flag-screen-keyword-shortcut"--></a>
4375 <li><a href="h_config_enable_full_hdr_and_text">FEATURE: <!--#echo var="FEAT_enable-full-header-and-text"--></a>
4376 <li><a href="h_config_enable_full_hdr">FEATURE: <!--#echo var="FEAT_enable-full-header-cmd"--></a>
4377 <li><a href="h_config_allow_goto">FEATURE: <!--#echo var="FEAT_enable-goto-in-file-browser"--></a>
4378 <li><a href="h_config_enable_dot_folders">FEATURE: <!--#echo var="FEAT_enable-dot-folders"--></a>
4379 <li><a href="h_config_enable_incoming">FEATURE: <!--#echo var="FEAT_enable-incoming-folders"--></a>
4380 <li><a href="h_config_enable_incoming_checking">FEATURE: <!--#echo var="FEAT_enable-incoming-folders-checking"--></a>
4381 <li><a href="h_config_enable_jump">FEATURE: <!--#echo var="FEAT_enable-jump-shortcut"--></a>
4382 <li><a href="h_config_show_delay_cue">FEATURE: <!--#echo var="FEAT_enable-mail-check-cue"--></a>
4383 <li><a href="h_config_mailcap_params">FEATURE: <!--#echo var="FEAT_enable-mailcap-param-substitution"--></a>
4384 <li><a href="h_config_enable_mouse">FEATURE: <!--#echo var="FEAT_enable-mouse-in-xterm"--></a>
4385 <li><a href="h_config_enable_view_addresses">FEATURE: <!--#echo var="FEAT_enable-msg-view-addresses"--></a>
4386 <li><a href="h_config_enable_view_attach">FEATURE: <!--#echo var="FEAT_enable-msg-view-attachments"--></a>
4387 <li><a href="h_external_loads_inline_images_only">FEATURE: <!--#echo var="FEAT_external-command-loads-inline-images-only"--></a>
4388 <li><a href="h_config_enable_view_arrows">FEATURE: <!--#echo var="FEAT_enable-msg-view-forced-arrows"--></a>
4389 <li><a href="h_config_enable_view_url">FEATURE: <!--#echo var="FEAT_enable-msg-view-urls"--></a>
4390 <li><a href="h_config_enable_view_web_host">FEATURE: <!--#echo var="FEAT_enable-msg-view-web-hostnames"--></a>
4391 <li><a href="h_config_enable_mulnewsrcs">FEATURE: <!--#echo var="FEAT_enable-multiple-newsrcs"--></a>
4392 <li><a href="h_config_enable_xterm_newmail">FEATURE: <!--#echo var="FEAT_enable-newmail-in-xterm-icon"--></a>
4393 <li><a href="h_config_enable_newmail_short_text">FEATURE: <!--#echo var="FEAT_enable-newmail-short-text-in-icon"--></a>
4394 <li><a href="h_config_sub_lists">FEATURE: <!--#echo var="FEAT_enable-partial-match-lists"--></a>
4395 <li><a href="h_config_enable_y_print">FEATURE: <!--#echo var="FEAT_enable-print-via-y-command"--></a>
4396 <li><a href="h_config_prefix_editing">FEATURE: <!--#echo var="FEAT_enable-reply-indent-string-editing"--></a>
4397 <li><a href="h_config_enable_search_and_repl">FEATURE: <!--#echo var="FEAT_enable-search-and-replace"--></a>
4398 <li><a href="h_config_sigdashes">FEATURE: <!--#echo var="FEAT_enable-sigdashes"--></a>
4399 <li><a href="h_config_new_thread_blank_subject">FEATURE: <!--#echo var="FEAT_new-thread-on-blank-subject"--></a>
4400 <li><a href="h_config_can_suspend">FEATURE: <!--#echo var="FEAT_enable-suspend"--></a>
4401 <li><a href="h_config_enable_tab_complete">FEATURE: <!--#echo var="FEAT_enable-tab-completion"--></a>
4402 <li><a href="h_config_enable_take_export">FEATURE: <!--#echo var="FEAT_enable-take-export"--></a>
4403 <li><a href="h_config_enable_role_take">FEATURE: <!--#echo var="FEAT_enable-rules-under-take"--></a>
4404 <li><a href="h_config_tray_icon">FEATURE: <!--#echo var="FEAT_enable-tray-icon"--></a>
4405 <li><a href="h_config_enable_pipe">FEATURE: <!--#echo var="FEAT_enable-unix-pipe-cmd"--></a>
4406 <li><a href="h_config_verbose_post">FEATURE: <!--#echo var="FEAT_enable-verbose-smtp-posting"--></a>
4407 <li><a href="h_config_expanded_addrbooks">FEATURE: <!--#echo var="FEAT_expanded-view-of-addressbooks"--></a>
4408 <li><a href="h_config_expanded_distlists">FEATURE: <!--#echo var="FEAT_expanded-view-of-distribution-lists"--></a>
4409 <li><a href="h_config_expanded_folders">FEATURE: <!--#echo var="FEAT_expanded-view-of-folders"--></a>
4410 <li><a href="h_config_expose_hidden_config">FEATURE: <!--#echo var="FEAT_expose-hidden-config"--></a>
4411 <li><a href="h_config_expunge_manually">FEATURE: <!--#echo var="FEAT_expunge-only-manually"--></a>
4412 <li><a href="h_config_auto_expunge">FEATURE: <!--#echo var="FEAT_expunge-without-confirm"--></a>
4413 <li><a href="h_config_full_auto_expunge">FEATURE: <!--#echo var="FEAT_expunge-without-confirm-everywhere"--></a>
4414 <li><a href="h_config_no_fcc_attach">FEATURE: <!--#echo var="FEAT_fcc-without-attachments"--></a>
4415 <li><a href="h_config_force_arrow">FEATURE: <!--#echo var="FEAT_force-arrow-cursor"--></a>
4416 <li><a href="h_config_ignore_size">FEATURE: <!--#echo var="FEAT_ignore-size-changes"--></a>
4417 <li><a href="h_config_forward_as_attachment">FEATURE: <!--#echo var="FEAT_forward-as-attachment"--></a>
4418 <li><a href="h_config_preserve_field">FEATURE: <!--#echo var="FEAT_preserve-original-fields"--></a>
4419 <li><a href="h_config_quell_empty_dirs">FEATURE: <!--#echo var="FEAT_quell-empty-directories"--></a>
4420 <li><a href="h_config_hide_nntp_path">FEATURE: <!--#echo var="FEAT_hide-nntp-path"--></a>
4421 <li><a href="h_config_attach_in_reply">FEATURE: <!--#echo var="FEAT_include-attachments-in-reply"--></a>
4422 <li><a href="h_config_fcc_on_bounce">FEATURE: <!--#echo var="FEAT_fcc-on-bounce"--></a>
4423 <li><a href="h_config_include_header">FEATURE: <!--#echo var="FEAT_include-header-in-reply"--></a>
4424 <li><a href="h_config_auto_include_reply">FEATURE: <!--#echo var="FEAT_include-text-in-reply"--></a>
4425 <li><a href="h_config_incoming_checking_total">FEATURE: <!--#echo var="FEAT_incoming-checking-includes-total"--></a>
4426 <li><a href="h_config_incoming_checking_recent">FEATURE: <!--#echo var="FEAT_incoming-checking-uses-recent"--></a>
4427 <li><a href="h_config_add_ldap">FEATURE: <!--#echo var="FEAT_ldap-result-to-addrbook-add"--></a>
4428 <li><a href="h_config_maildrops_preserve_state">FEATURE: <!--#echo var="FEAT_maildrops-preserve-state"--></a>
4429 <li><a href="h_config_mark_fcc_seen">FEATURE: <!--#echo var="FEAT_mark-fcc-seen"--></a>
4430 <li><a href="h_config_mark_for_cc">FEATURE: <!--#echo var="FEAT_mark-for-cc"--></a>
4431 <li><a href="h_config_mulnews_as_typed">FEATURE: <!--#echo var="FEAT_mult-newsrc-hostnames-as-typed"--></a>
4432 <li><a href="h_config_news_uses_recent">FEATURE: <!--#echo var="FEAT_news-approximates-new-status"--></a>
4433 <li><a href="h_config_news_cross_deletes">FEATURE: <!--#echo var="FEAT_news-deletes-across-groups"--></a>
4434 <li><a href="h_config_news_catchup">FEATURE: <!--#echo var="FEAT_news-offers-catchup-on-close"--></a>
4435 <li><a href="h_config_post_wo_validation">FEATURE: <!--#echo var="FEAT_news-post-without-validation"--></a>
4436 <li><a href="h_config_read_in_newsrc_order">FEATURE: <!--#echo var="FEAT_news-read-in-newsrc-order"--></a>
4437 <li><a href="h_config_nntp_search_uses_overview">FEATURE: <!--#echo var="FEAT_nntp-search-uses-overview"--></a>
4438 <li><a href="h_config_thread_sorts_by_arrival">FEATURE: <!--#echo var="FEAT_thread-sorts-by-arrival"--></a>
4439 <li><a href="h_config_expunge_inbox">FEATURE: <!--#echo var="FEAT_offer-expunge-of-inbox"--></a>
4440 <li><a href="h_config_expunge_stayopens">FEATURE: <!--#echo var="FEAT_offer-expunge-of-stayopen-folders"--></a>
4441 <li><a href="h_config_pass_c1_control">FEATURE: <!--#echo var="FEAT_pass-c1-control-characters-as-is"--></a>
4442 <li><a href="h_config_pass_control">FEATURE: <!--#echo var="FEAT_pass-control-characters-as-is"--></a>
4443 <li><a href="h_config_predict_nntp_server">FEATURE: <!--#echo var="FEAT_predict-nntp-server"--></a>
4444 <li><a href="h_config_prefer_plain_text">FEATURE: <!--#echo var="FEAT_prefer-plain-text"--></a>
4445 <li><a href="h_config_preopen_stayopens">FEATURE: <!--#echo var="FEAT_preopen-stayopen-folders"--></a>
4446 <li><a href="h_config_preserve_start_stop">FEATURE: <!--#echo var="FEAT_preserve-start-stop-characters"--></a>
4447 <li><a href="h_config_quell_folder_internal_msg">FEATURE: <!--#echo var="FEAT_quell-folder-internal-msg"--></a>
4448 <li><a href="h_config_quell_checks_comp">FEATURE: <!--#echo var="FEAT_quell-mailchecks-composing-except-inbox"--></a>
4449 <li><a href="h_config_quell_checks_comp_inbox">FEATURE: <!--#echo var="FEAT_quell-mailchecks-composing-inbox"--></a>
4450 <li><a href="h_config_quell_partial">FEATURE: <!--#echo var="FEAT_quell-partial-fetching"--></a>
4451 <li><a href="h_config_quell_local_lookup">FEATURE: <!--#echo var="FEAT_quell-user-lookup-in-passwd-file"--></a>
4452 <li><a href="h_config_ff_between_msgs">FEATURE: <!--#echo var="FEAT_print-formfeed-between-messages"--></a>
4453 <li><a href="h_config_print_from">FEATURE: <!--#echo var="FEAT_print-includes-from-line"--></a>
4454 <li><a href="h_config_print_index">FEATURE: <!--#echo var="FEAT_print-index-enabled"--></a>
4455 <li><a href="h_config_custom_print">FEATURE: <!--#echo var="FEAT_print-offers-custom-cmd-prompt"--></a>
4456 <li><a href="h_config_prune_uses_iso">FEATURE: <!--#echo var="FEAT_prune-uses-yyyy-mm"--></a>
4457 <li><a href="h_config_quell_personal_name_prompt">FEATURE: <!--#echo var="FEAT_quell-personal-name-prompt"--></a>
4458 <li><a href="h_config_quell_ssl_largeblocks">FEATURE: <!--#echo var="FEAT_quell-ssl-largeblocks"--></a>
4459 <li><a href="h_config_quell_user_id_prompt">FEATURE: <!--#echo var="FEAT_quell-user-id-prompt"--></a>
4460 <li><a href="h_config_quit_wo_confirm">FEATURE: <!--#echo var="FEAT_quit-without-confirm"--></a>
4461 <li><a href="h_config_quote_replace_noflow">FEATURE: <!--#echo var="FEAT_quote-replace-nonflowed"--></a>
4462 <li><a href="h_config_next_thrd_wo_confirm">FEATURE: <!--#echo var="FEAT_next-thread-without-confirm"--></a>
4463 <li><a href="h_config_auto_reply_to">FEATURE: <!--#echo var="FEAT_reply-always-uses-reply-to"--></a>
4464 <li><a href="h_config_inbox_no_confirm">FEATURE: <!--#echo var="FEAT_return-to-inbox-without-confirm"--></a>
4465 <li><a href="h_config_save_aggregates">FEATURE: <!--#echo var="FEAT_save-aggregates-copy-sequence"--></a>
4466 <li><a href="h_config_save_part_wo_confirm">FEATURE: <!--#echo var="FEAT_save-partial-msg-without-confirm"--></a>
4467 <li><a href="h_config_save_advances">FEATURE: <!--#echo var="FEAT_save-will-advance"--></a>
4468 <li><a href="h_config_save_wont_delete">FEATURE: <!--#echo var="FEAT_save-will-not-delete"--></a>
4469 <li><a href="h_config_quote_all_froms">FEATURE: <!--#echo var="FEAT_save-will-quote-leading-froms"--></a>
4470 <li><a href="h_config_scramble_message_id">FEATURE: <!--#echo var="FEAT_scramble-message-id"--></a>
4471 <li><a href="h_config_select_wo_confirm">FEATURE: <!--#echo var="FEAT_select-without-confirm"--></a>
4472 <li><a href="h_config_auto_fcc_only">FEATURE: <!--#echo var="FEAT_fcc-only-without-confirm"--></a>
4473 <li><a href="h_config_send_wo_confirm">FEATURE: <!--#echo var="FEAT_send-without-confirm"--></a>
4474 <li><a href="h_config_separate_fold_dir_view">FEATURE: <!--#echo var="FEAT_separate-folder-and-directory-entries"--></a>
4475 <li><a href="h_config_show_cursor">FEATURE: <!--#echo var="FEAT_show-cursor"--></a>
4476 <li><a href="h_config_textplain_int">FEATURE: <!--#echo var="FEAT_show-plain-text-internally"--></a>
4477 <li><a href="h_config_select_in_bold">FEATURE: <!--#echo var="FEAT_show-selected-in-boldface"--></a>
4478 <li><a href="h_config_show_sort">FEATURE: <!--#echo var="FEAT_show-sort"--></a>
4479 <li><a href="h_config_single_list">FEATURE: <!--#echo var="FEAT_single-column-folder-list"--></a>
4480 <li><a href="h_config_sig_at_bottom">FEATURE: <!--#echo var="FEAT_signature-at-bottom"--></a>
4481 <li><a href="h_config_slash_coll_entire">FEATURE: <!--#echo var="FEAT_slash-collapses-entire-thread"--></a>
4482 <li><a href="h_config_sort_fcc_alpha">FEATURE: <!--#echo var="FEAT_sort-default-fcc-alpha"--></a>
4483 <li><a href="h_config_sort_save_alpha">FEATURE: <!--#echo var="FEAT_sort-default-save-alpha"--></a>
4484 <li><a href="h_config_always_spell_check">FEATURE: <!--#echo var="FEAT_spell-check-before-sending"--></a>
4485 <li><a href="h_config_winpos_in_config">FEATURE: <!--#echo var="FEAT_store-window-position-in-config"--></a>
4486 <li><a href="h_config_strip_sigdashes">FEATURE: <!--#echo var="FEAT_strip-from-sigdashes-on-reply"--></a>
4487 <li><a href="h_config_strip_ws_before_send">FEATURE: <!--#echo var="FEAT_strip-whitespace-before-send"--></a>
4488 <li><a href="h_config_quells_asterisks">FEATURE: <!--#echo var="FEAT_suppress-asterisks-in-password-prompt"--></a>
4489 <li><a href="h_config_quell_attach_ext_warn">FEATURE: <!--#echo var="FEAT_quell-attachment-extension-warn"--></a>
4490 <li><a href="h_config_quell_attach_extra_prompt">FEATURE: <!--#echo var="FEAT_quell-attachment-extra-prompt"--></a>
4491 <li><a href="h_config_no_bezerk_zone">FEATURE: <!--#echo var="FEAT_quell-berkeley-format-timezone"--></a>
4492 <li><a href="h_config_quell_charset_warning">FEATURE: <!--#echo var="FEAT_quell-charset-warning"--></a>
4493 <li><a href="h_config_quell_content_id">FEATURE: <!--#echo var="FEAT_quell-content-id"--></a>
4494 <li><a href="h_config_quell_post_prompt">FEATURE: <!--#echo var="FEAT_quell-extra-post-prompt"--></a>
4495 <li><a href="h_config_quell_filtering_done_message">FEATURE: <!--#echo var="FEAT_quell-filtering-done-message"--></a>
4496 <li><a href="h_config_quell_filtering_messages">FEATURE: <!--#echo var="FEAT_quell-filtering-messages"--></a>
4497 <li><a href="h_config_quell_full_hdr_reset">FEATURE: <!--#echo var="FEAT_quell-full-header-auto-reset"--></a>
4498 <li><a href="h_config_quell_imap_env">FEATURE: <!--#echo var="FEAT_quell-imap-envelope-update"--></a>
4499 <li><a href="h_config_quell_lock_failure_warnings">FEATURE: <!--#echo var="FEAT_quell-lock-failure-warnings"--></a>
4500 <li><a href="h_config_quell_domain_warn">FEATURE: <!--#echo var="FEAT_quell-maildomain-warning"--></a>
4501 <li><a href="h_config_quell_news_env">FEATURE: <!--#echo var="FEAT_quell-news-envelope-update"--></a>
4502 <li><a href="h_config_quell_host_after_url">FEATURE: <!--#echo var="FEAT_quell-server-after-link-in-html"--></a>
4503 <li><a href="h_config_quell_beeps">FEATURE: <!--#echo var="FEAT_quell-status-message-beeping"--></a>
4504 <li><a href="h_config_quell_tz_comment">FEATURE: <!--#echo var="FEAT_quell-timezone-comment-when-sending"--></a>
4505 <li><a href="h_config_suppress_user_agent">FEATURE: <!--#echo var="FEAT_suppress-user-agent-when-sending"--></a>
4506 <li><a href="h_config_tab_checks_recent">FEATURE: <!--#echo var="FEAT_tab-checks-recent"--></a>
4507 <li><a href="h_config_tab_uses_unseen">FEATURE: <!--#echo var="FEAT_tab-uses-unseen-for-next-folder"--></a>
4508 <li><a href="h_config_tab_new_only">FEATURE: <!--#echo var="FEAT_tab-visits-next-new-message-only"--></a>
4509 <li><a href="h_config_termcap_wins">FEATURE: <!--#echo var="FEAT_termdef-takes-precedence"--></a>
4510 <li><a href="h_config_color_thrd_import">FEATURE: <!--#echo var="FEAT_thread-index-shows-important-color"--></a>
4511 <li><a href="h_config_alt_auth">FEATURE: <!--#echo var="FEAT_try-alternative-authentication-driver-first"--></a>
4512 <li><a href="h_config_unsel_wont_advance">FEATURE: <!--#echo var="FEAT_unselect-will-not-advance"--></a>
4513 <li><a href="h_config_use_current_dir">FEATURE: <!--#echo var="FEAT_use-current-dir"--></a>
4514 <li><a href="h_config_use_fk">FEATURE: <!--#echo var="FEAT_use-function-keys"--></a>
4515 <li><a href="h_config_use_reg_start_for_stayopen">FEATURE: <!--#echo var="FEAT_use-regular-startup-rule-for-stayopen-folders"--></a>
4516 <li><a href="h_config_use_resentto">FEATURE: <!--#echo var="FEAT_use-resent-to-in-rules"--></a>
4517 <li><a href="h_config_use_sender_not_x">FEATURE: <!--#echo var="FEAT_use-sender-not-x-sender"--></a>
4518 <li><a href="h_config_suspend_spawns">FEATURE: <!--#echo var="FEAT_use-subshell-for-suspend"--></a>
4519 <li><a href="h_config_use_system_translation">FEATURE: Use System Translation</a>
4520 <li><a href="h_config_vertical_list">FEATURE: <!--#echo var="FEAT_vertical-folder-list"--></a>
4521 <li><a href="h_config_warn_if_fcc_blank">FEATURE: <!--#echo var="FEAT_warn-if-blank-fcc"--></a>
4522 <li><a href="h_config_warn_if_subj_blank">FEATURE: <!--#echo var="FEAT_warn-if-blank-subject"--></a>
4523 <li><a href="h_config_warn_if_no_to_or_cc">FEATURE: <!--#echo var="FEAT_warn-if-blank-to-and-cc-and-newsgroups"--></a>
4524 <li><a href="h_mainhelp_filtering">Filtering</a>
4525 <li><a href="h_finding_help">Finding more information and requesting help</a>
4526 <li><a href="h_common_flag">Flag Command</a>
4527 <li><a href="h_config_quell_flowed_text">Flowed Text</a>
4528 <li><a href="h_mainhelp_folders">Folders</a>
4529 <li><a href="h_what_are_collections">Folder Collections Explained</a>
4530 <li><a href="h_common_folders">Folder List Command</a>
4531 <li><a href="h_folder_fcc">Folder Select for Fcc Explained</a>
4532 <li><a href="h_folder_save">Folder Select for Save Explained</a>
4533 <li><a href="h_folder_server_syntax">Folder Server Name Syntax</a>
4534 <li><a href="h_config_change_your_from">From Address, Changing</a>
4535 <li><a href="main_menu_tx">GENERAL INFORMATION ON THE ALPINE MESSAGE SYSTEM</a>
4536 <li><a href="h_pine_for_windows">GETTING HELP IN ALPINE</a>
4537 <li><a href="h_common_goto">Goto Command</a>
4538 <li><a href="h_common_hdrmode">HdrMode Command</a>
4539 <li><a href="h_mainhelp_pinehelp">Help</a>
4540 <li><a href="h_special_help_nav">Help Text Navigation Explained</a>
4541 <li><a href="h_folder_maint">Help for Folder List</a>
4542 <li><a href="h_valid_folder_names">IMAP</a>
4543 <li><a href="h_ge_import">Import File Selection</a>
4544 <li><a href="h_mainhelp_index">Index of Messages</a>
4545 <li><a href="h_composer_ins_m">INSERT MESSAGE</a>
4546 <li><a href="h_composer_ins">INSERT TEXT FILE</a>
4547 <li><a href="h_address_format">INTERNET EMAIL ADDRESS FORMAT</a>
4548 <li><a href="h_info_on_mbox">Information on mbox driver</a>
4549 <li><a href="h_mainhelp_intro">Introduction</a>
4550 <li><a href="h_main_journal">Journal Command</a>
4551 <li><a href="h_common_jump">Jump Command</a>
4552 <li><a href="h_compose_justify">Justify Command</a>
4553 <li><a href="h_main_kblock">Keyboard Lock Command</a>
4554 <li><a href="h_mainhelp_keywords">Keywords (or Flags, or Labels)</a>
4555 <li><a href="h_mainhelp_ldap">LDAP</a>
4556 <li><a href="h_config_ldap_opts_tls">LDAP FEATURE: Attempt-TLS-On-Connection</a>
4557 <li><a href="h_config_ldap_opts_nosub">LDAP FEATURE: Disable-Ad-Hoc-Space-Substitution</a>
4558 <li><a href="h_config_ldap_opts_rhs">LDAP FEATURE: Lookup-Addrbook-Contents</a>
4559 <li><a href="h_config_ldap_opts_tlsmust">LDAP FEATURE: Require-TLS-On-Connection</a>
4560 <li><a href="h_config_ldap_opts_ldaps">LDAP FEATURE: Require-LDAPS-On-Connection</a>
4561 <li><a href="h_config_ldap_opts_ref">LDAP FEATURE: Save-Search-Criteria-Not-Result</a>
4562 <li><a href="h_config_ldap_opts_impl">LDAP FEATURE: Use-Implicitly-From-Composer</a>
4563 <li><a href="h_config_ldap_binddn">LDAP OPTION: Bind-DN</a>
4564 <li><a href="h_config_ldap_cust">LDAP OPTION: Custom-Search-Filter</a>
4565 <li><a href="h_config_ldap_email_attr">LDAP OPTION: EmailAttribute</a>
4566 <li><a href="h_config_ldap_gn_attr">LDAP OPTION: GivennameAttribute</a>
4567 <li><a href="h_config_ldap_server">LDAP OPTION: <!--#echo var="VAR_ldap-servers"--></a>
4568 <li><a href="h_config_ldap_cn_attr">LDAP OPTION: NameAttribute</a>
4569 <li><a href="h_config_ldap_nick">LDAP OPTION: Nickname</a>
4570 <li><a href="h_config_ldap_port">LDAP OPTION: Port</a>
4571 <li><a href="h_config_ldap_base">LDAP OPTION: Search-Base</a>
4572 <li><a href="h_config_ldap_searchrules">LDAP OPTION: Search-Rule</a>
4573 <li><a href="h_config_ldap_searchtypes">LDAP OPTION: Search-Type</a>
4574 <li><a href="h_config_ldap_size">LDAP OPTION: Sizelimit</a>
4575 <li><a href="h_config_ldap_sn_attr">LDAP OPTION: SurnameAttribute</a>
4576 <li><a href="h_config_ldap_time">LDAP OPTION: Timelimit</a>
4577 <li><a href="h_ldap_view">LDAP Response View Explained</a>
4578 <li><a href="h_maildrop">Mail Drop: What is it?</a>
4579 <li><a href="h_mainhelp_mainmenu">MAIN MENU</a>
4580 <li><a href="h_mail_index">MESSAGE INDEX COMMANDS</a>
4581 <li><a href="h_mail_view">MESSAGE TEXT SCREEN</a>
4582 <li><a href="h_compose_markcutpaste">Mark, Cut and Paste Commands</a>
4583 <li><a href="h_common_index">Message Index Command</a>
4584 <li><a href="h_mainhelp_mouse">Mouse</a>
4585 <li><a href="h_mainhelp_aggops">Multiple Message Operations</a>
4586 <li><a href="new_user_greeting">NEW USER GREETING</a>
4587 <li><a href="new_version_greeting">NEW VERSION GREETING</a>
4588 <li><a href="h_mainhelp_readingnews">News Reading</a>
4589 <li><a href="h_folder_subscribe">Newsgroup Subscribe Screen explained</a>
4590 <li><a href="h_folder_postnews">Newsgroup selecting for Posting explained</a>
4591 <li><a href="h_common_nextnew">NextNew Command</a>
4592 <li><a href="h_abook_select_nick">Nickname Selection Explained</a>
4593 <li><a href="h_mainhelp_readingnews">NNTP</a>
4594 <li><a href="h_config_address_book">OPTION: <!--#echo var="VAR_address-book"--></a>
4595 <li><a href="h_config_abook_formats">OPTION: <!--#echo var="VAR_addressbook-formats"--></a>
4596 <li><a href="h_config_ab_sort_rule">OPTION: <!--#echo var="VAR_addrbook-sort-rule"--></a></a>
4597 <li><a href="h_config_alt_addresses">OPTION: <!--#echo var="VAR_alt-addresses"--></a>
4598 <li><a href="h_config_active_msg_interval">OPTION: <!--#echo var="VAR_busy-cue-rate"--></a>
4599 <li><a href="h_config_color_style">OPTION: Color Style</a>
4600 <li><a href="h_config_wordseps">OPTION: <!--#echo var="VAR_composer-word-separators"--></a>
4601 <li><a href="h_config_composer_wrap_column">OPTION: <!--#echo var="VAR_composer-wrap-column"--></a>
4602 <li><a href="h_config_index_color_style">OPTION: <!--#echo var="VAR_current-indexline-style"--></a>
4603 <li><a href="h_config_cursor_style">OPTION: Cursor Style</a>
4604 <li><a href="h_config_custom_hdrs">OPTION: <!--#echo var="VAR_customized-hdrs"--></a>
4605 <li><a href="h_config_deadlets">OPTION: <!--#echo var="VAR_dead-letter-files"--></a>
4606 <li><a href="h_config_comp_hdrs">OPTION: <!--#echo var="VAR_default-composer-hdrs"--></a>
4607 <li><a href="h_config_default_fcc">OPTION: <!--#echo var="VAR_default-fcc"--></a>
4608 <li><a href="h_config_def_save_folder">OPTION: <!--#echo var="VAR_default-saved-msg-folder"--></a>
4609 <li><a href="h_config_disable_auths">OPTION: <!--#echo var="VAR_disable-these-authenticators"--></a>
4610 <li><a href="h_config_encryption_range">OPTION: <!--#echo var="VAR_encryption-protocol-range"--></a>
4611 <li><a href="h_config_disable_drivers">OPTION: <!--#echo var="VAR_disable-these-drivers"--></a>
4612 <li><a href="h_config_char_set">OPTION: Display Character Set</a>
4613 <li><a href="h_config_display_filters">OPTION: <!--#echo var="VAR_display-filters"--></a>
4614 <li><a href="h_config_download_cmd">OPTION: <!--#echo var="VAR_download-command"--></a>
4615 <li><a href="h_config_download_prefix">OPTION: <!--#echo var="VAR_download-command-prefix"--></a>
4616 <li><a href="h_config_editor">OPTION: <!--#echo var="VAR_editor"--></a>
4617 <li><a href="h_config_empty_hdr_msg">OPTION: <!--#echo var="VAR_empty-header-message"--></a>
4618 <li><a href="h_config_fcc_rule">OPTION: <!--#echo var="VAR_fcc-name-rule"--></a>
4619 <li><a href="h_config_file_dir">OPTION: File Directory</a>
4620 <li><a href="h_config_folder_spec">OPTION: <!--#echo var="VAR_folder-collections"--></a>
4621 <li><a href="h_config_reopen_rule">OPTION: <!--#echo var="VAR_folder-reopen-rule"--></a>
4622 <li><a href="h_config_fld_sort_rule">OPTION: <!--#echo var="VAR_folder-sort-rule"--></a>
4623 <li><a href="h_config_font_char_set">OPTION: Font Character Set</a>
4624 <li><a href="h_config_font_name">OPTION: Font Name</a>
4625 <li><a href="h_config_font_size">OPTION: Font Size</a>
4626 <li><a href="h_config_font_style">OPTION: Font Style</a>
4627 <li><a href="h_config_form_folder">OPTION: <!--#echo var="VAR_form-letter-folder"--></a>
4628 <li><a href="h_config_glob_addrbook">OPTION: <!--#echo var="VAR_global-address-book"--></a>
4629 <li><a href="h_config_goto_default">OPTION: <!--#echo var="VAR_goto-default-rule"--></a>
4630 <li><a href="h_config_header_general_color">OPTION: Header General Color</a>
4631 <li><a href="h_config_image_viewer">OPTION: <!--#echo var="VAR_image-viewer"--></a>
4632 <li><a href="h_config_inbox_path">OPTION: <!--#echo var="VAR_inbox-path"--></a>
4633 <li><a href="h_config_archived_folders">OPTION: <!--#echo var="VAR_incoming-archive-folders"--></a>
4634 <li><a href="h_config_incoming_interv">OPTION: <!--#echo var="VAR_incoming-check-interval"--></a>
4635 <li><a href="h_config_incoming_second_interv">OPTION: <!--#echo var="VAR_incoming-check-interval-secondary"--></a>
4636 <li><a href="h_config_incoming_list">OPTION: <!--#echo var="VAR_incoming-check-list"--></a>
4637 <li><a href="h_config_incoming_timeo">OPTION: <!--#echo var="VAR_incoming-check-timeout"--></a>
4638 <li><a href="h_config_incoming_folders">OPTION: <!--#echo var="VAR_incoming-folders"--></a>
4639 <li><a href="h_config_inc_startup">OPTION: <!--#echo var="VAR_incoming-startup-rule"--></a>
4640 <li><a href="h_config_incunseen_color">OPTION: Incoming Unseen Color</a>
4641 <li><a href="h_config_index_arrow_color">OPTION: Index Arrow Color</a>
4642 <li><a href="h_config_index_color">OPTION: Index Colors</a>
4643 <li><a href="h_config_index_format">OPTION: <!--#echo var="VAR_index-format"--></a>
4644 <li><a href="h_config_index_from_color">OPTION: Index From Color</a>
4645 <li><a href="h_config_index_opening_color">OPTION: Index Opening Color</a>
4646 <li><a href="h_config_index_pri_color">OPTION: Index Priority Symbol Colors</a>
4647 <li><a href="h_config_index_subject_color">OPTION: Index Subject Color</a>
4648 <li><a href="h_config_init_cmd_list">OPTION: <!--#echo var="VAR_initial-keystroke-list"--></a>
4649 <li><a href="h_config_key_char_set">OPTION: Keyboard Character Set</a>
4650 <li><a href="h_config_keylabel_color">OPTION: KeyLabel Color</a>
4651 <li><a href="h_config_keyname_color">OPTION: KeyName Color</a>
4652 <li><a href="h_config_keywords">OPTION: <!--#echo var="VAR_keywords"--></a>
4653 <li><a href="h_config_kw_color">OPTION: Keyword Colors</a>
4654 <li><a href="h_config_kw_braces">OPTION: <!--#echo var="VAR_keyword-surrounding-chars"--></a>
4655 <li><a href="h_config_prune_date">OPTION: <!--#echo var="VAR_last-time-prune-questioned"--></a>
4656 <li><a href="h_config_last_vers">OPTION: <!--#echo var="VAR_last-version-used"--></a>
4657 <li><a href="h_config_literal_sig">OPTION: <!--#echo var="VAR_literal-signature"--></a>
4658 <li><a href="h_config_mailcheck">OPTION: <!--#echo var="VAR_mail-check-interval"--></a>
4659 <li><a href="h_config_mailchecknoncurr">OPTION: <!--#echo var="VAR_mail-check-interval-noncurrent"--></a>
4660 <li><a href="h_config_mailcap_path">OPTION: <!--#echo var="VAR_mailcap-search-path"--></a>
4661 <li><a href="h_config_maildropcheck">OPTION: <!--#echo var="VAR_maildrop-check-minimum"--></a>
4662 <li><a href="h_config_maxremstream">OPTION: <!--#echo var="VAR_max-remote-connections"--></a>
4663 <li><a href="h_config_metamsg_color">OPTION: Meta-Message Color</a>
4664 <li><a href="h_config_mimetype_path">OPTION: <!--#echo var="VAR_mimetype-search-path"--></a>
4665 <li><a href="h_config_new_ver_quell">OPTION: <!--#echo var="VAR_new-version-threshold"--></a>
4666 <li><a href="h_config_fifopath">OPTION: NewMail FIFO Path</a>
4667 <li><a href="h_config_newmailwidth">OPTION: <!--#echo var="VAR_newmail-window-width"--></a>
4668 <li><a href="h_config_news_active">OPTION: <!--#echo var="VAR_news-active-file-path"--></a>
4669 <li><a href="h_config_news_spec">OPTION: <!--#echo var="VAR_news-collections"--></a>
4670 <li><a href="h_config_news_spool">OPTION: <!--#echo var="VAR_news-spool-directory"--></a>
4671 <li><a href="h_config_newsrc_path">OPTION: <!--#echo var="VAR_newsrc-path"--></a>
4672 <li><a href="h_config_nntprange">OPTION: <!--#echo var="VAR_nntp-range"--></a>
4673 <li><a href="h_config_nntp_server">OPTION: <!--#echo var="VAR_nntp-server"--></HEAD></a>
4674 <li><a href="h_config_normal_color">OPTION: Normal Color</a>
4675 <li><a href="h_config_opening_sep">OPTION: <!--#echo var="VAR_opening-text-separator-chars"--></a>
4676 <li><a href="h_config_oper_dir">OPTION: <!--#echo var="VAR_operating-dir"--></a>
4677 <li><a href="h_config_pat_old">OPTION: Patterns</a>
4678 <li><a href="h_config_pat_filts">OPTION: <!--#echo var="VAR_patterns-filters2"--></a>
4679 <li><a href="h_config_pat_other">OPTION: <!--#echo var="VAR_patterns-other"--></a>
4680 <li><a href="h_config_pat_roles">OPTION: <!--#echo var="VAR_patterns-roles"--></a>
4681 <li><a href="h_config_pat_scores">OPTION: <!--#echo var="VAR_patterns-scores2"--></a>
4682 <li><a href="h_config_pers_name">OPTION: <!--#echo var="VAR_personal-name"--></a>
4683 <li><a href="h_config_print_cat">OPTION: <!--#echo var="VAR_personal-print-category"--></a>
4684 <li><a href="h_config_print_command">OPTION: <!--#echo var="VAR_personal-print-command"--></a>
4685 <li><a href="h_config_post_char_set">OPTION: <!--#echo var="VAR_posting-character-set"--></a>
4686 <li><a href="h_config_postponed_folder">OPTION: <!--#echo var="VAR_postponed-folder"--></a>
4687 <li><a href="h_config_print_font_char_set">OPTION: Print-Font-Char-Set</a>
4688 <li><a href="h_config_print_font_name">OPTION: Print-Font-Name</a>
4689 <li><a href="h_config_print_font_size">OPTION: Print-Font-Size</a>
4690 <li><a href="h_config_print_font_style">OPTION: Print-Font-Style</a>
4691 <li><a href="h_config_printer">OPTION: Printer</a>
4692 <li><a href="h_config_prompt_color">OPTION: Prompt Color</a>
4693 <li><a href="h_config_pruned_folders">OPTION: <!--#echo var="VAR_pruned-folders"--></a>
4694 <li><a href="h_config_pruning_rule">OPTION: <!--#echo var="VAR_pruning-rule"--></a>
4695 <li><a href="h_config_quote_color">OPTION: Quote Colors</a>
4696 <li><a href="h_config_quote_replace_string">OPTION: <!--#echo var="VAR_quote-replace-string"--></a>
4697 <li><a href="h_config_quote_suppression">OPTION: <!--#echo var="VAR_quote-suppression-threshold"--></a>
4698 <li><a href="h_config_read_message_folder">OPTION: <!--#echo var="VAR_read-message-folder"--></a>
4699 <li><a href="h_config_remote_abook_history">OPTION: <!--#echo var="VAR_remote-abook-history"--></a>
4700 <li><a href="h_config_abook_metafile">OPTION: <!--#echo var="VAR_remote-abook-metafile"--></a>
4701 <li><a href="h_config_remote_abook_validity">OPTION: <!--#echo var="VAR_remote-abook-validity"--></a>
4702 <li><a href="h_config_reply_indent_string">OPTION: <!--#echo var="VAR_reply-indent-string"--></a>
4703 <li><a href="h_config_reply_intro">OPTION: <!--#echo var="VAR_reply-leadin"--></a>
4704 <li><a href="h_config_reverse_color">OPTION: Reverse Color</a>
4705 <li><a href="h_config_rshcmd">OPTION: <!--#echo var="VAR_rsh-command"--></a>
4706 <li><a href="h_config_rsh_open_timeo">OPTION: <!--#echo var="VAR_rsh-open-timeout"--></a>
4707 <li><a href="h_config_rshpath">OPTION: <!--#echo var="VAR_rsh-path"--></a>
4708 <li><a href="h_config_saved_msg_name_rule">OPTION: <!--#echo var="VAR_saved-msg-name-rule"--></a>
4709 <li><a href="h_config_scroll_margin">OPTION: <!--#echo var="VAR_scroll-margin"--></a>
4710 <li><a href="h_config_slctbl_color">OPTION: Selectable Item Color</a>
4711 <li><a href="h_config_sending_filter">OPTION: <!--#echo var="VAR_sending-filters"--></a>
4712 <li><a href="h_config_sendmail_path">OPTION: <!--#echo var="VAR_sendmail-path"--></a>
4713 <li><a href="h_config_signature_color">OPTION: Signature Color</a>
4714 <li><a href="h_config_signature_file">OPTION: <!--#echo var="VAR_signature-file"--></a>
4715 <li><a href="h_config_smtp_server">OPTION: <!--#echo var="VAR_smtp-server"--></a>
4716 <li><a href="h_config_sort_key">OPTION: <!--#echo var="VAR_sort-key"--></a>
4717 <li><a href="h_config_speller">OPTION: <!--#echo var="VAR_speller"--></a>
4718 <li><a href="h_config_aspell_dictionary">OPTION: <!--#echo var="VAR_aspell-dictionary-list"--></a>
4719 <li><a href="h_config_sshcmd">OPTION: <!--#echo var="VAR_ssh-command"--></a>
4720 <li><a href="h_config_ssh_open_timeo">OPTION: <!--#echo var="VAR_ssh-open-timeout"--></a>
4721 <li><a href="h_config_sshpath">OPTION: <!--#echo var="VAR_ssh-path"--></a>
4722 <li><a href="h_config_status_color">OPTION: Status Color</a>
4723 <li><a href="h_config_status_msg_delay">OPTION: <!--#echo var="VAR_status-message-delay"--></a>
4724 <li><a href="h_config_permlocked">OPTION: <!--#echo var="VAR_stay-open-folders"--></a>
4725 <li><a href="h_config_tcp_open_timeo">OPTION: <!--#echo var="VAR_tcp-open-timeout"--></a>
4726 <li><a href="h_config_tcp_query_timeo">OPTION: <!--#echo var="VAR_tcp-query-timeout"--></a>
4727 <li><a href="h_config_quit_query_timeo">OPTION: <!--#echo var="VAR_close-connection-timeout"--></a>
4728 <li><a href="h_config_tcp_readwarn_timeo">OPTION: <!--#echo var="VAR_tcp-read-warning-timeout"--></a>
4729 <li><a href="h_config_tcp_writewarn_timeo">OPTION: <!--#echo var="VAR_tcp-write-warning-timeout"--></a>
4730 <li><a href="h_config_thread_disp_style">OPTION: <!--#echo var="VAR_threading-display-style"--></a>
4731 <li><a href="h_config_thread_exp_char">OPTION: <!--#echo var="VAR_threading-expanded-character"--></a>
4732 <li><a href="h_config_thread_index_style">OPTION: <!--#echo var="VAR_threading-index-style"--></a>
4733 <li><a href="h_config_thread_indicator_char">OPTION: <!--#echo var="VAR_threading-indicator-character"--></a>
4734 <li><a href="h_config_thread_lastreply_char">OPTION: <!--#echo var="VAR_threading-lastreply-character"--></a>
4735 <li><a href="h_config_title_color">OPTION: Title Color</a>
4736 <li><a href="h_config_titleclosed_color">OPTION: Title Closed Color</a>
4737 <li><a href="h_config_titlebar_color_style">OPTION: <!--#echo var="VAR_titlebar-color-style"--></a>
4738 <li><a href="h_config_unk_char_set">OPTION: <!--#echo var="VAR_unknown-character-set"--></a>
4739 <li><a href="h_config_upload_cmd">OPTION: <!--#echo var="VAR_upload-command"--></a>
4740 <li><a href="h_config_upload_prefix">OPTION: <!--#echo var="VAR_upload-command-prefix"--></a>
4741 <li><a href="h_config_browser">OPTION: <!--#echo var="VAR_url-viewers"--></a>
4742 <li><a href="h_config_history">OPTION: <!--#echo var="VAR_default-directories"--></a>
4743 <li><a href="h_config_domain_name">OPTION: <!--#echo var="VAR_use-only-domain-name"--></a>
4744 <li><a href="h_config_user_dom">OPTION: <!--#echo var="VAR_user-domain"--></a>
4745 <li><a href="h_config_user_id">OPTION: <!--#echo var="VAR_user-id"--></a>
4746 <li><a href="h_config_user_input_timeo">OPTION: <!--#echo var="VAR_user-input-timeout"--></a>
4747 <li><a href="h_config_viewer_headers">OPTION: <!--#echo var="VAR_viewer-hdrs"--></a>
4748 <li><a href="h_config_customhdr_pattern">OPTION: Viewer Header Color Pattern</a>
4749 <li><a href="h_config_customhdr_color">OPTION: <!--#echo var="VAR_viewer-hdr-colors"--></a>
4750 <li><a href="h_config_viewer_margin_left">OPTION: <!--#echo var="VAR_viewer-margin-left"--></a>
4751 <li><a href="h_config_viewer_margin_right">OPTION: <!--#echo var="VAR_viewer-margin-right"--></a>
4752 <li><a href="h_config_viewer_overlap">OPTION: <!--#echo var="VAR_viewer-overlap"--></a>
4753 <li><a href="h_config_window_position">OPTION: Window-Position</a>
4754 <li><a href="h_mainhelp_patterns">Patterns</a>
4755 <li><a href="h_config_role_abookfrom">PATTERNS: Address in Address Book</a>
4756 <li><a href="h_config_role_age">PATTERNS: Age Interval</a>
4757 <li><a href="h_config_role_alltextpat">PATTERNS: AllText Pattern</a>
4758 <li><a href="h_config_role_bom">PATTERNS: Beginning of Month</a>
4759 <li><a href="h_config_role_boy">PATTERNS: Beginning of Year</a>
4760 <li><a href="h_config_role_bodytextpat">PATTERNS: BodyText Pattern</a>
4761 <li><a href="h_config_role_cat_cmd">PATTERNS: Categorizer Command</a>
4762 <li><a href="h_config_role_cat_cmd_example">PATTERNS: Categorizer Command Example</a>
4763 <li><a href="h_config_role_ccpat">PATTERNS: Cc Pattern</a>
4764 <li><a href="h_config_role_cat_limit">PATTERNS: Character Limit</a>
4765 <li><a href="h_config_role_charsetpat">PATTERNS: Character Set Pattern</a>
4766 <li><a href="h_config_role_comment">PATTERNS: Comment</a>
4767 <li><a href="h_config_role_fldr_type">PATTERNS: Current Folder Type</a>
4768 <li><a href="h_config_role_cat_status">PATTERNS: Exit Status Interval</a>
4769 <li><a href="h_config_role_arbpat">PATTERNS: Extra Headers Pattern</a>
4770 <li><a href="h_config_role_frompat">PATTERNS: From Pattern</a>
4771 <li><a href="h_config_role_keywordpat">PATTERNS: Keyword Pattern</a>
4772 <li><a href="h_config_role_stat_ans">PATTERNS: Message Answered Status</a>
4773 <li><a href="h_config_role_stat_del">PATTERNS: Message Deleted Status</a>
4774 <li><a href="h_config_role_stat_imp">PATTERNS: Message Important Status</a>
4775 <li><a href="h_config_role_stat_new">PATTERNS: Message New Status</a>
4776 <li><a href="h_config_role_stat_recent">PATTERNS: Message Recent Status</a>
4777 <li><a href="h_config_role_newspat">PATTERNS: News Pattern</a>
4778 <li><a href="h_config_role_nick">PATTERNS: Nickname</a>
4779 <li><a href="h_config_role_particpat">PATTERNS: Participant Pattern</a>
4780 <li><a href="h_config_role_stat_8bitsubj">PATTERNS: Raw 8-bit in Subject</a>
4781 <li><a href="h_config_role_recippat">PATTERNS: Recipient Pattern</a>
4782 <li><a href="h_config_role_scorei">PATTERNS: Score Interval</a>
4783 <li><a href="h_config_role_senderpat">PATTERNS: Sender Pattern</a>
4784 <li><a href="h_config_role_size">PATTERNS: Size Interval</a>
4785 <li><a href="h_config_role_subjpat">PATTERNS: Subject Pattern</a>
4786 <li><a href="h_config_role_topat">PATTERNS: To Pattern</a>
4787 <li><a href="h_config_filt_opts_nonterm">PATTERNS FEATURE: Dont-Stop-Even-if-Rule-Matches</a>
4788 <li><a href="h_config_filt_opts_notdel">PATTERNS FEATURE: Move-Only-if-Not-Deleted</a>
4789 <li><a href="h_config_filt_opts_sentdate">PATTERNS FEATURE: Use-Date-Header-For-Age</a>
4790 <li><a href="h_config_filt_rule_type">PATTERNS FILTER ACTION: Filter Action</a>
4791 <li><a href="h_config_filter_kw_clr">PATTERNS FILTER ACTION: Clear These Keywords</a>
4792 <li><a href="h_config_filt_stat_ans">PATTERNS FILTER ACTION: Set Answered Status</a>
4793 <li><a href="h_config_filt_stat_del">PATTERNS FILTER ACTION: Set Deleted Status</a>
4794 <li><a href="h_config_filt_stat_imp">PATTERNS FILTER ACTION: Set Important Status</a>
4795 <li><a href="h_config_filt_stat_new">PATTERNS FILTER ACTION: Set New Status</a>
4796 <li><a href="h_config_filter_kw_set">PATTERNS FILTER ACTION: Set These Keywords</a>
4797 <li><a href="h_config_incol">PATTERNS INDEXCOLOR ACTION: Index Line Color</a>
4798 <li><a href="h_config_set_index_format">PATTERNS OTHER ACTION: Set Index Format</a>
4799 <li><a href="h_config_perfolder_sort">PATTERNS OTHER ACTION: Set Sort Order</a>
4800 <li><a href="h_config_other_startup">PATTERNS OTHER ACTION: Set Startup Rule</a>
4801 <li><a href="h_config_role_inick">PATTERNS ROLE ACTION: Initialize Values From Role</a>
4802 <li><a href="h_config_role_setfcc">PATTERNS ROLE ACTION: Set Fcc</a>
4803 <li><a href="h_config_role_setfrom">PATTERNS ROLE ACTION: Set From</a>
4804 <li><a href="h_config_role_setlitsig">PATTERNS ROLE ACTION: Set Literal Signature</a>
4805 <li><a href="h_config_role_setotherhdr">PATTERNS ROLE ACTION: Set Other Headers</a>
4806 <li><a href="h_config_role_setreplyto">PATTERNS ROLE ACTION: Set Reply-To</a>
4807 <li><a href="h_config_role_setsig">PATTERNS ROLE ACTION: Set Signature</a>
4808 <li><a href="h_config_role_settempl">PATTERNS ROLE ACTION: Set Template</a>
4809 <li><a href="h_config_role_usenntp">PATTERNS ROLE ACTION: Use NNTP Server</a>
4810 <li><a href="h_config_role_usesmtp">PATTERNS ROLE ACTION: Use SMTP Server</a>
4811 <li><a href="h_config_role_scoreval">PATTERNS SCORE ACTION: Score Value</a>
4812 <li><a href="h_config_role_scorehdrtok">PATTERNS SCORE ACTION: Score Value From Header</a>
4813 <li><a href="h_config_role_composeuse">PATTERNS USE: Compose Use</a>
4814 <li><a href="h_config_role_forwarduse">PATTERNS USE: Forward Use</a>
4815 <li><a href="h_config_role_replyuse">PATTERNS USE: Reply Use</a>
4816 <li><a href="h_pipe_command">Pipe Command SubOptions</a>
4817 <li><a href="h_common_pipe">Pipe Command</a>
4818 <li><a href="h_valid_folder_names">POP</a>
4819 <li><a href="h_common_postpone">Postpone Command</a>
4820 <li><a href="h_common_print">Print Command</a>
4821 <li><a href="h_mainhelp_readingnews">Reading News</a>
4822 <li><a href="h_news">RELEASE NOTES for Alpine</a>
4823 <li><a href="h_mainhelp_roles">Roles</a>
4824 <li><a href="h_role_select">ROLES SCREEN</a>
4825 <li><a href="h_compose_readfile">Read File Command</a>
4826 <li><a href="h_mainhelp_reading">Reading Messages</a>
4827 <li><a href="h_main_release_notes">Release Notes Command</a>
4828 <li><a href="h_common_reply">Reply and Forward Commands</a>
4829 <li><a href="h_compose_richhdr">Rich Header Command</a>
4830 <li><a href="h_common_role">Role Command</a>
4831 <li><a href="h_mainhelp_smime">S/MIME</a>
4832 <li><a href="h_index_cmd_select">Searching for Messages</a>
4833 <li><a href="h_address_display">SEARCH RESULTS INDEX</a>
4834 <li><a href="h_address_select">SEARCH RESULTS INDEX</a>
4835 <li><a href="h_simple_index">SELECT POSTPONED MESSAGE</a>
4836 <li><a href="h_abook_config">SETUP ADDRESS BOOKS SCREEN</a>
4837 <li><a href="h_collection_maint">SETUP COLLECTION LIST screen</a>
4838 <li><a href="h_color_setup">SETUP COLOR COMMANDS</a>
4839 <li><a href="h_direct_config">SETUP LDAP DIRECTORY SERVERS SCREEN</a>
4840 <li><a href="h_rules_roles">SETUP ROLES SCREEN</a>
4841 <li><a href="h_rules_incols">SETUP INDEX COLORS SCREEN</a>
4842 <li><a href="h_rules_filter">SETUP FILTERING SCREEN</a>
4843 <li><a href="h_rules_score">SETUP SCORING SCREEN</a>
4844 <li><a href="h_common_save">Save and Export Commands</a>
4845 <li><a href="h_mainhelp_securing">Securing Your Alpine Session</a>
4846 <li><a href="h_index_cmd_select">Selecting: Select and WhereIs/Select</a>
4847 <li><a href="h_compose_send">Send Command</a>
4848 <li><a href="h_folder_server_syntax">Server Name Syntax</a>
4849 <li><a href="h_main_setup">Setup Command</a>
4850 <li><a href="X-Alpine-Config:">Show Supported Options in this Alpine</a>
4851 <li><a href="h_composer_sigedit">Signature Editor Commands Explained</a>
4852 <li><a href="h_simple_text_view">Simple Text View Screen Explained</a>
4853 <li><a href="h_mainhelp_smime">S/MIME</a>
4854 <li><a href="h_config_smime_dont_do_smime">S/MIME FEATURE: <!--#echo var="FEAT_smime-dont-do-smime"--></a>
4855 <li><a href="h_config_smime_encrypt_by_default">S/MIME FEATURE: <!--#echo var="FEAT_smime-encrypt-by-default"--></a>
4856 <li><a href="h_config_smime_remember_passphrase">S/MIME FEATURE: <!--#echo var="FEAT_smime-remember-passphrase"--></a>
4857 <li><a href="h_config_smime_sign_by_default">S/MIME FEATURE: <!--#echo var="FEAT_smime-sign-by-default"--></a>
4858 <li><a href="h_config_smime_use_cert_store">S/MIME FEATURE: <!--#echo var="FEAT_smime-use-store-only"--></a>
4859 <li><a href="h_config_smime_pubcerts_in_keychain">S/MIME FEATURE: <!--#echo var="FEAT_publiccerts-in-keychain"--></a>
4860 <li><a href="h_config_smime_cacertcon">S/MIME OPTION: <!--#echo var="VAR_smime-cacert-container"--></a>
4861 <li><a href="h_config_smime_cacertdir">S/MIME OPTION: <!--#echo var="VAR_smime-cacert-directory"--></a>
4862 <li><a href="h_config_smime_privkeycon">S/MIME OPTION: <!--#echo var="VAR_smime-private-key-container"--></a>
4863 <li><a href="h_config_smime_privkeydir">S/MIME OPTION: <!--#echo var="VAR_smime-private-key-directory"--></a>
4864 <li><a href="h_config_smime_pubcertcon">S/MIME OPTION: <!--#echo var="VAR_smime-public-cert-container"--></a>
4865 <li><a href="h_config_smime_pubcertdir">S/MIME OPTION: <!--#echo var="VAR_smime-public-cert-directory"--></a>
4866 <li><a href="h_config_smime_transfer_cacert_to_con">S/MIME: Transfer CA Certs to Container</a>
4867 <li><a href="h_config_smime_transfer_cacert_to_dir">S/MIME: Transfer CA Certs to Directory</a>
4868 <li><a href="h_config_smime_transfer_priv_to_con">S/MIME: Transfer Private Keys to Container</a>
4869 <li><a href="h_config_smime_transfer_priv_to_dir">S/MIME: Transfer Private Keys to Directory</a>
4870 <li><a href="h_config_smime_transfer_pub_to_con">S/MIME: Transfer Public Certs to Container</a>
4871 <li><a href="h_config_smime_transfer_pub_to_dir">S/MIME: Transfer Public Certs to Directory</a>
4872 <li><a href="h_config_smime_public_certificates">S/MIME: Manage Public Certificates</a>
4873 <li><a href="h_config_smime_private_keys">S/MIME: Manage Private Keys</a>
4874 <li><a href="h_config_smime_certificate_authorities">S/MIME: Manage Certificate Authorities</a>
4875 <li><a href="h_index_cmd_sort">Sort Command</a>
4876 <li><a href="h_compose_spell">Spell Check Command</a>
4877 <li><a href="h_common_suspend">Suspend Command</a>
4878 <li><a href="h_compose_addrcomplete">THE MESSAGE COMPOSER'S ADDRESS COMPLETION</a>
4879 <li><a href="h_composer_attachment">THE MESSAGE COMPOSER'S ATTCHMNT FIELD</a>
4880 <li><a href="h_composer_bcc">THE MESSAGE COMPOSER'S BCC FIELD</a>
4881 <li><a href="h_composer_cc">THE MESSAGE COMPOSER'S CC FIELD</a>
4882 <li><a href="h_composer_from">THE MESSAGE COMPOSER'S FROM FIELD</a>
4883 <li><a href="h_composer_lcc">THE MESSAGE COMPOSER'S LCC FIELD</a>
4884 <li><a href="h_composer_news">THE MESSAGE COMPOSER'S NEWSGRPS LINE</a>
4885 <li><a href="h_composer_reply_to">THE MESSAGE COMPOSER'S REPLY-TO FIELD</a>
4886 <li><a href="h_composer_to">THE MESSAGE COMPOSER'S TO FIELD</a>
4887 <li><a href="h_abook_opened">THE ALPINE ADDRESS BOOK</a>
4888 <li><a href="h_abook_select_nicks_take">Take Address Nickname Selection Explained</a>
4889 <li><a href="h_takeaddr_screen">Take Address Screen Explained</a>
4890 <li><a href="h_common_take">TakeAddr Command</a>
4891 <li><a href="h_mainhelp_status">Titlebar Line</a>
4892 <li><a href="h_index_tokens">Tokens for Index and Replying</a>
4893 <li><a href="h_config_usenone_color">Use None Color</a>
4894 <li><a href="h_config_usenormal_color">Use Normal Color</a>
4895 <li><a href="h_config_usetransparent_color">Use Transparent Color</a>
4896 <li><a href="h_whatis_vcard">VCARD EXPLAINED</a>
4897 <li><a href="h_view_cmd_hilite">View Hilite and Next item/Previous item</a>
4898 <li><a href="h_view_cmd_viewattch">ViewAttch Command</a>
4899 <li><a href="h_index_cmd_whereis">WhereIs Command</a>
4900 <li><a href="h_view_cmd_whereis">WhereIs Command</a>
4901 <li><a href="h_index_cmd_zoom">ZoomMode Command</a>
4902 <li><a href="h_config_browser_xterm"><!--#echo var="VAR_url-viewers"--> and X windows applications</a>
4903 </UL>
4904
4905 <P>
4906 &lt;End of Help Index&gt;
4907 </BODY>
4908 </HTML>
4909
4910
4911 ============== h_config_remote_config =============
4912 <HTML>
4913 <HEAD>
4914 <TITLE>Remote Configuration</TITLE>
4915 </HEAD>
4916 <BODY>
4917 <H1>Remote Configuration</H1>
4918
4919 You may use the command line argument &quot;-p pinerc&quot; to tell
4920 Alpine to use a non-default configuration file.
4921 There are two types of storage for configuration information.
4922 <EM>Local</EM> configuration files are used by default.
4923 These are just regular files on the UNIX system or on the PC.
4924 The file &quot;<CODE>.pinerc</CODE>&quot; is the default for Unix Alpine and the
4925 file &quot;<CODE>PINERC</CODE>&quot; is the default for PC-Alpine.
4926 <EM>Remote</EM> configuration folders are stored on an IMAP server.
4927 The advantage of using a remote configuration is that the same information
4928 may be accessed from multiple platforms.
4929 For example, if you use one computer at work and another at home, the same
4930 configuration could be used from both places.
4931 A configuration change from one place would be seen in both places.
4932 To use a remote configuration you simply give a
4933 <A HREF="h_valid_folder_names">remote folder name</A>
4934 as the argument to the &quot;-p&quot; command line option.
4935 The command line might look something like:
4936 <P>
4937 <CENTER><SAMP>pine -p {my.imap.server}remote_pinerc</SAMP></CENTER>
4938 <P>
4939 If there are special characters in the command shell you use, you may need to
4940 quote the last argument (to protect the curly braces from the shell).
4941 The command might look like:
4942 <P>
4943 <CENTER><SAMP>pine -p &quot;{my.imap.server}remote_pinerc&quot;</SAMP></CENTER>
4944 <P>
4945 You should choose a folder name for a folder that does not yet exist.
4946 It will be created containing an empty configuration.
4947 Do not use a folder that you wish to store regular mail messages in.
4948 <P>
4949 The Setup/RemoteConfigSetup command will help you convert from a local
4950 configuration to a remote configuration.
4951 It will create a remote configuration for you and copy your current local
4952 configuration to it.
4953 It will also help you convert local address books into remote address books
4954 and local signature files into literal signatures contained in the
4955 remote configuration file.
4956 <P>
4957 If the Setup/RemoteConfigSetup command doesn't do what you want, you
4958 may copy a local pinerc file to a remote configuration folder by hand
4959 by using the command line option &quot;-copy_pinerc&quot;.
4960 <P>
4961 Another command line option, which is somewhat related to remote
4962 configuration, is the option &quot;-x exceptions_config&quot;.
4963 The configuration settings in the exceptions configuration override
4964 your default settings.
4965 It may be useful to store the default configuration (the -p argument) remotely
4966 and to have the exceptions configuration stored in a local file.
4967 You might put generic configuration information in the remote configuration
4968 and platform-specific configuration on each platform in the exceptions
4969 configuration.
4970 The arguments to the &quot;-p&quot; and &quot;-x&quot; options
4971 can be either remote folders or local files.
4972 <P>
4973 There is another command line argument that works only with PC-Alpine and
4974 which may prove useful when using a remote configuration.
4975 The option &quot;-aux local_directory&quot; allows you to tell PC-Alpine where
4976 to store your local auxiliary files.
4977 This only has an effect if your configuration file is remote.
4978 Some examples of auxiliary files are debug files, address book files, and
4979 signature files.
4980 <P>
4981 &lt;End of help on this topic&gt;
4982 </BODY>
4983 </HTML>
4984 ============== h_config_exceptions =============
4985 <HTML>
4986 <HEAD>
4987 <TITLE>Generic and Exceptional Configuration</TITLE>
4988 </HEAD>
4989 <BODY>
4990 <H1>Generic and Exceptional Configuration</H1>
4991
4992 If you use Alpine from more than one platform it may be convenient
4993 to split your configuration information into two pieces, a generic piece
4994 and exceptions that apply to a particular platform.
4995 For example, suppose you use Alpine from home and from work.
4996 Most of your configuration settings are probably the
4997 same in both locations, so those settings belong in the generic settings
4998 configuration.
4999 However, you may use a different SMTP server and INBOX
5000 from home than you do from work.
5001 The
5002 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>
5003 and
5004 <A HREF="h_config_inbox_path">&quot;<!--#echo var="VAR_inbox-path"-->&quot;</A>
5005 options could be
5006 part of your exceptional configuration so that they could be different in the
5007 two places.
5008 <P>
5009 The command line option &quot;-x exceptions_config&quot;
5010 may be used to split your configuration into generic and exceptional pieces.
5011 &quot;Exceptions_config&quot; may be either local or remote.
5012 The regular Alpine configuration file will contain the generic data, and
5013 &quot;exceptions_config&quot; will contain the exceptional data.
5014 <P>
5015 For Unix Alpine, if you don't have a &quot;-x&quot; command line option,
5016 Alpine will look for the file &quot;<CODE>.pinercex</CODE>&quot;
5017 in the same local directory that the regular config file is located in (usually
5018 the Unix home directory).
5019 If the regular config file is remote (because the command line option
5020 &quot;-p remote_config&quot; was used) then Unix Alpine looks in the Unix home
5021 directory for &quot;<CODE>.pinercex</CODE>&quot;.
5022 If the file does not already exist then no exceptions will be used.
5023 You can force exceptions to be used by using the &quot;-x&quot; option or
5024 by creating an empty &quot;<CODE>.pinercex</CODE>&quot; file.
5025 <P>
5026 For PC-Alpine, if you don't have a &quot;-x&quot; command line option,
5027 PC-Alpine will use the value of the
5028 environment variable <CODE>$PINERCEX</CODE>.
5029 If that is not set, PC-Alpine will look for
5030 the local file &quot;<CODE>PINERCEX</CODE>&quot;
5031 in the same local directory that the regular config file is located in.
5032 If the regular config file is remote (because the command line option
5033 &quot;-p remote_config&quot; was used) then PC-Alpine looks in the
5034 local directory specified by the &quot;-aux local_directory&quot; command
5035 line argument, or the directory <CODE>$HOME&#92;PINE</CODE>, or
5036 in the <CODE>&lt;PINE.EXE </CODE>directory<CODE>&gt;</CODE>.
5037 <P>
5038 When you have an exception configuration there is a new command
5039 in the Alpine Setup screen, Setup/eXceptions.
5040 It toggles between exceptions and the regular configuration.
5041 This is the usual way to make changes in your exceptional configuration data.
5042 For example, you would type &quot;S&quot; for Setup, &quot;X&quot; for
5043 eXception, then follow that with one of the Setup commands, like &quot;C&quot;
5044 for Config or &quot;K&quot; for Kolor.
5045 <P>
5046 For most people, splitting the configuration information into two pieces is
5047 going to be most useful if the generic information is accessed
5048 <A HREF="h_config_remote_config">remotely</A>).
5049 That data will be the same no matter where you access it from and if you
5050 change it that change will show up everywhere.
5051 The exceptional data will most commonly be in a local file, so that the
5052 contents may easily be different on each computing platform used.
5053 <P>
5054 If you already have a local configuration file with settings you like
5055 you may find that the command Setup/RemoteConfigSetup is useful
5056 in helping you convert to a remote configuration.
5057 The command line flag &quot;-copy_pinerc&quot;
5058 may also be useful.
5059 <P>
5060 &lt;End of help on this topic&gt;
5061 </BODY>
5062 </HTML>
5063 ============== h_config_inheritance =============
5064 <HTML>
5065 <HEAD>
5066 <TITLE>Configuration Inheritance</TITLE>
5067 </HEAD>
5068 <BODY>
5069 <H1>Configuration Inheritance</H1>
5070
5071 Configuration inheritance is a power user feature.
5072 It is confusing and not completely supported by the configuration
5073 user interface.
5074 We start with an explanation of how configuration works in hopes of making
5075 it easier to describe how inheritance works.
5076 <P>
5077 Alpine uses a hierarchy of configuration values from different locations.
5078 There are five ways in which each configuration option (configuration
5079 variable) can be set.
5080 In increasing order of precedence they are:
5081 <P>
5082 <OL>
5083 <LI> the system-wide configuration file.
5084
5085 <LI> the personal configuration file
5086
5087 <LI> the personal exceptions file
5088
5089 <LI> a command line argument
5090
5091 <LI> the system-wide <EM>fixed</EM> configuration file (Unix Alpine only)
5092 </OL>
5093 <P>
5094 The fixed configuration file is normally
5095 <CODE><!--#echo var="PINE_CONF_FIXED_PATH"--></CODE>.
5096 <P>
5097 The system-wide configuration file is normally
5098 <CODE><!--#echo var="PINE_CONF_PATH"--></CODE> for Unix Alpine and is normally not
5099 set for PC-Alpine.
5100 For PC-Alpine, if the environment variable <EM>$PINECONF</EM> is set, that
5101 is used for the system-wide configuration.
5102 This location can be set or changed on the command line with the -P flag.
5103 The system-wide configuration file can be either a local file or a
5104 remote configuration folder.
5105 <P>
5106 For Unix Alpine, the personal configuration file is normally the file
5107 <CODE>.pinerc</CODE> in the user's home directory.
5108 This can be changed with the -p command line flag.
5109 For PC-Alpine, the personal configuration file is in
5110 <CODE>$PINERC</CODE> or <CODE>&lt;AlpineRC registry value&gt;</CODE> or
5111 <CODE>$HOME&#92;PINE&#92;PINERC</CODE> or
5112 <CODE>&lt;PINE.EXE </CODE>dir<CODE>&gt;&#92;PINERC</CODE>.
5113 This can be changed with the -p command line flag.
5114 If -p is used, the configuration data may be in a local file or a remote config
5115 folder.
5116 <P>
5117 For Unix Alpine, the personal exceptions configuration file is named
5118 <CODE>.pinercex</CODE> and is in the same directory as the personal
5119 configuration file, if that configuration file is not remote, and is in
5120 the home directory if the personal configuration file is remote.
5121 If the file exists, then exceptions are turned on.
5122 If it doesn't, then you are not using exceptions.
5123 Alternatively, you may change the location of the exceptions configuration
5124 by using the command line argument &quot;-x &lt;exceptions_config&gt;&quot;.
5125 Like the personal configuration data, exceptions_config may be
5126 either local or remote.
5127 <P>
5128 For PC-Alpine, the personal exceptions configuration file is named
5129 <CODE>PINERCEX</CODE> and is in the same directory as the personal
5130 configuration file unless the personal configuration file is remote.
5131 In that case, it is in the local directory specified by the
5132 &quot;-aux local_directory&quot; command line argument.
5133 (In the case that the personal configuration is remote and there is no
5134 &quot;-aux&quot; command line argument, Alpine searches for
5135 a PINERCEX file in the directory <CODE>$HOME&#92;PINE</CODE> and
5136 the directory <CODE>&lt;PINE.EXE </CODE>dir<CODE>&gt;</CODE>.)
5137 If the file exists, then exceptions are turned on.
5138 If it doesn't, then you are not using exceptions.
5139 You may change the location of the exceptions configuration
5140 by using the command line argument &quot;-x &lt;exceptions_config&gt;&quot;.
5141 or with the
5142 environment variable <CODE>$PINERCEX</CODE> (if there is no &quot;-x&quot;
5143 option).
5144 <P>
5145 To reiterate, the value of a configuration option is taken from the
5146 last location in the list above in which it is set.
5147 Or, thinking about it slightly differently, a default value for an option
5148 is established in the system-wide configuration file (or internally by Alpine
5149 if there is no value in the system-wide file).
5150 That default remains in effect until and unless it is overridden by a value in a
5151 location further down the list, in which case a new &quot;default&quot;
5152 value is established.
5153 As we continue down the list of locations we either retain the
5154 value at each step or establish a new value.
5155 The value that is still set after going through the whole list of
5156 configuration locations is the one that is used.
5157 <P>
5158 So, for example, if an option is set in the system-wide configuration
5159 file and in the personal configuration file, but is not set in the
5160 exceptions, on the command line, or in the fixed file; then the value
5161 from the personal configuration file is the one that is used.
5162 Or, if it is set in the system-wide config, in the personal config, not
5163 in the exceptions, but is set on the command line; then the value
5164 on the command line is used.
5165 <P>
5166 Finally we get to inheritance.
5167 For configuration options that are lists, like &quot;<!--#echo var="VAR_smtp-server"-->&quot; or
5168 &quot;<!--#echo var="VAR_incoming-folders"-->&quot;,
5169 the inheritance mechanism makes it possible to <EM>combine</EM>
5170 the values from different locations instead of <EM>replacing</EM> the value.
5171 This is true of all configuration lists other than the &quot;Feature-List&quot;,
5172 for which you may already set whatever you want at
5173 any configuration location (by using the &quot;no-&quot; prefix if
5174 necessary).
5175 <P>
5176 To use inheritance, set the first item in a configuration list to the
5177 token &quot;INHERIT&quot;, without the quotes.
5178 If the first item is &quot;INHERIT&quot;,
5179 then instead of replacing the default value established so far, the rest of
5180 the list is appended to the default value established so far and that is
5181 the new value.
5182 <P>
5183 Here is an example which may make it clearer. Suppose we have:
5184 <P>
5185 <PRE>
5186  System-wide config :   smtp-server = smtp1.corp.com, smtp2.corp.com
5187  Personal config    :   smtp-server = INHERIT, mysmtp.home
5188  Exceptions config  :   smtp-server = &lt;No Value Set&gt;
5189  Command line       :   smtp-server = &lt;No Value Set&gt;
5190  Fixed config       :   smtp-server = &lt;No Value Set&gt;
5191 </PRE>
5192 <P>
5193
5194 This would result in an effective smtp-server option of
5195 <P>
5196 <PRE>
5197  smtp-server = smtp1.corp.com, smtp2.corp.com, mysmtp.home
5198 </PRE>
5199 <P>
5200 The &quot;INHERIT&quot; token can be used in any of the configuration files
5201 and the effect cascades.
5202 For example, if we change the above example to:
5203 <P>
5204 <PRE>
5205  System-wide config :   smtp-server = smtp1.corp.com, smtp2.corp.com
5206  Personal config    :   smtp-server = INHERIT, mysmtp.home
5207  Exceptions config  :   smtp-server = INHERIT, yoursmtp.org
5208  Command line       :   smtp-server = &lt;No Value Set&gt;
5209  Fixed config       :   smtp-server = &lt;No Value Set&gt;
5210 </PRE>
5211 <P>
5212
5213 This would result in:
5214 <P>
5215 <PRE>
5216  smtp-server = smtp1.corp.com, smtp2.corp.com, mysmtp.home, yoursmtp.org
5217 </PRE>
5218 <P>
5219 Unset variables are skipped over (the default value is carried forward) so
5220 that, for example:
5221 <P>
5222 <PRE>
5223  System-wide config :   smtp-server = smtp1.corp.com, smtp2.corp.com
5224  Personal config    :   smtp-server = &lt;No Value Set&gt;
5225  Exceptions config  :   smtp-server = INHERIT, yoursmtp.org
5226  Command line       :   smtp-server = &lt;No Value Set&gt;
5227  Fixed config       :   smtp-server = &lt;No Value Set&gt;
5228 </PRE>
5229 <P>
5230
5231 produces:
5232 <P>
5233 <PRE>
5234  smtp-server = smtp1.corp.com, smtp2.corp.com, yoursmtp.org
5235 </PRE>
5236 <P>
5237
5238 If any later configuration location has a value set (for a particular list
5239 option) which does <EM>not</EM> begin with &quot;INHERIT&quot;,
5240 then that value replaces whatever value has been defined up to that point.
5241 In other words, that cancels out any previous inheritance.
5242 <P>
5243 <PRE>
5244  System-wide config :   smtp-server = smtp1.corp.com, smtp2.corp.com
5245  Personal config    :   smtp-server = INHERIT, mysmtp.org
5246  Exceptions config  :   smtp-server = yoursmtp.org
5247  Command line       :   smtp-server = &lt;No Value Set&gt;
5248  Fixed config       :   smtp-server = &lt;No Value Set&gt;
5249 </PRE>
5250 <P>
5251
5252 results in:
5253 <P>
5254 <PRE>
5255  smtp-server = yoursmtp.org
5256 </PRE>
5257 <P>
5258
5259 For some configuration options, like &quot;<!--#echo var="VAR_viewer-hdr-colors"-->&quot; or
5260 &quot;<!--#echo var="VAR_patterns-roles"-->&quot;, it is
5261 difficult to insert the value &quot;INHERIT&quot; into the list of values
5262 for the option using the normal Setup tools.
5263 In other words, the color setting screen (for example) does not
5264 provide a way to input the text &quot;INHERIT&quot; as the first
5265 item in the <!--#echo var="VAR_viewer-hdr-colors"--> option.
5266 The way to do this is to either edit the pinerc file directly and manually
5267 insert it, or turn
5268 on the <A HREF="h_config_expose_hidden_config"><!--#echo var="FEAT_expose-hidden-config"--></A>
5269 feature and insert it using the Setup/Config screen.
5270 <P>
5271 &lt;End of help on this topic&gt;
5272 </BODY>
5273 </HTML>
5274 ============== h_special_xon_xoff =============
5275 <HTML>
5276 <HEAD>
5277 <TITLE>Explanation of Alpine's XOFF/XON Handling</TITLE>
5278 </HEAD>
5279 <BODY>
5280 <H1>XOFF/XON Handling within Alpine</H1>
5281
5282 By default, Alpine treats Ctrl-S or Ctrl-Q (sometimes known as XOFF
5283 and XON) as normal characters, even though Alpine does not use them.
5284 However, the printer, modem, or communication software you are using may
5285 be configured for &quot;software flow control,&quot; which means that
5286 XON/XOFF must be treated as special characters by the operating system.
5287 If you see messages such as &quot;^S not defined for this screen&quot;,
5288 then your system is probably using software flow control. In this case
5289 you will need to set the
5290 <A HREF="h_config_preserve_start_stop">&quot;<!--#echo var="FEAT_preserve-start-stop-characters"-->&quot;</A>
5291 feature.
5292 <P>
5293 If you <EM>do</EM> set this
5294 feature, be advised that if you accidentally hit a Ctrl-S, Alpine will
5295 mysteriously freeze up with no warning.  In this case, try typing a Ctrl-Q
5296 and see if that puts things right.  Printing via the
5297 &quot;attached-to-ansi&quot; or
5298 &quot;attached-to-wyse&quot;
5299 option will automatically enable software
5300 flow-control handling for the duration of the printing.
5301 <P>
5302 &lt;End of help on this topic&gt;
5303 </BODY>
5304 </HTML>
5305 ============= h_special_help_nav =============
5306 <HTML>
5307 <HEAD>
5308 <TITLE>Help Text Navigation Explained</TITLE>
5309 </HEAD>
5310 <BODY>
5311 <H1>Help Text Navigation Explained</H1>
5312
5313 Alpine contains extensive context-sensitive help text.   At any point,
5314 pressing the &quot;?&quot; key will bring up a page of help text
5315 explaining the options available to you.  You can leave the help
5316 text screen and return to normal Alpine operation by pressing
5317 the
5318 <!--chtml if pinemode="function_key"-->
5319 F3 function
5320 <!--chtml else-->
5321 &quot;E&quot;
5322 <!--chtml endif-->
5323 key to Exit Help at any time.
5324
5325 <P>
5326 Within the help screen you might find a word or phrase displayed in
5327 inverse text and others displayed in bold typeface.  Such words and
5328 phrases are used to tell you Alpine has more information available on
5329 the topic they describe.
5330 The inverted text is the &quot;selected&quot; topic.
5331 Use the arrow keys, Ctrl-F, and Ctrl-B to change which of the phrases
5332 displayed in bold type
5333 is &quot;selected&quot;.
5334 Hit the Return key to display the information Alpine has available on that
5335 topic.  While viewing such additional information, the
5336 <!--chtml if pinemode="function_key"-->
5337 F3 function
5338 <!--chtml else-->
5339 &quot;P&quot;
5340 <!--chtml endif-->
5341 key will return you to the previous help screen, and the
5342 <!--chtml if pinemode="function_key"-->
5343 F2 function
5344 <!--chtml else-->
5345 &quot;E&quot;
5346 <!--chtml endif-->
5347 key will Exit the Help system altogether.
5348
5349 <P>
5350 The "N" command will tell you the internal name of the help text you are
5351 reading each time, so that you can send this name in the text of a message
5352 and create a direct link to that internal help using the x-pine-help URL
5353 scheme. For example, the direct link to this item is
5354 x-pine-help:h_special_help_nav. If you add this text to a message, then
5355 a person using Pine to read such message would have a direct link to this
5356 help text.
5357
5358 <P>
5359 When you are finished reading this help text, you can press the
5360 <!--chtml if pinemode="function_key"-->
5361 F3 function
5362 <!--chtml else-->
5363 &quot;P&quot;
5364 <!--chtml endif-->
5365 key to return to the previously displayed help text.
5366
5367 <P>
5368 &lt;End of help on this topic&gt;
5369 </BODY>
5370 </HTML>
5371 ============= h_special_list_commands =============
5372 <HTML>
5373 <HEAD>
5374 <TITLE>Email List Commands Explained</TITLE>
5375 </HEAD>
5376 <BODY>
5377 <H1>Email List Commands Explained</H1>
5378
5379 Electonic mail lists provide a way for like-minded users to join in
5380 discussions on topics of interest.  The email list itself is
5381 represented by a
5382 single address that participants send messages to when they have
5383 something of interest to share with other members of the list.  The
5384 receiving computer then, either automatically or after review by the
5385 list's owner (or moderator), sends a copy of that message to each
5386 member of the list.
5387
5388 <P>
5389 Usually, subscribing and unsubscribing is done by sending requests in
5390 an email message to a special address setup to handle managing list
5391 membership.  Often this is the name of the list followed by
5392 <I>-request</I>.  This address is almost <EM>never</EM> the same as
5393 the address used to send messages to the list.
5394
5395 <P>
5396 Unfortunately, email list participation commands are more a matter
5397 of convention than standard, and thus may vary from list to list.
5398 Increasingly, list management software is adding information to
5399 the copy of the postings as they're copied to the list members that
5400 explains how to do the various list management functions.
5401
5402 <P>
5403 Alpine will recognize this information and offer the management commands
5404 they represent in a simple display. One or more of the following
5405 operations will be made available:
5406
5407 <DL>
5408 <DT>Help</DT>
5409 <DD>
5410 A method to get help on subscribing, unsubscribing,
5411 an explanation of what the list is about, or special instructions
5412 for participation.  This may be in the form of a reply in response
5413 to an email message, or instructions on how to connect to a Web site.
5414 </DD>
5415
5416 <DT>Unsubscribe</DT>
5417 <DD>
5418 A method to get your email addressed removed from the list of
5419 recipients of the email list.
5420 </DD>
5421
5422 <DT>Subscribe</DT>
5423 <DD>
5424 A method to get your email address added to the list of recipients
5425 of the email list.  It may be in the form of a message sent to
5426 a special address or you may be connected to a web site.
5427 <DD>
5428 </DD>
5429
5430 <DT>Post</DT>
5431 <DD>
5432 A method used to post to the email list.  However, it might also
5433 indicate that no posting is allowed directly to the list.
5434 </DD>
5435
5436 <DT>Owner</DT>
5437 <DD>
5438 A method to contact the list owner for special questions you might
5439 have regarding the list.
5440 </DD>
5441
5442 <DT>Archive</DT>
5443 <DD>
5444 A method to view an archive of previous messages posted to the list.
5445 This may be in the form of a mail folder on a remote computer, an
5446 IMAP mailbox or even a Web site.
5447 </DD>
5448 </DL>
5449
5450 <P>
5451 &lt;End of help on this topic&gt;
5452 </BODY>
5453 </HTML>
5454 ============= h_quota_command =============
5455 <HTML>
5456 <HEAD>
5457 <TITLE>Quota Screen Explained</TITLE>
5458 </HEAD>
5459 <BODY>
5460 <H1>Quota Screen Explained</H1>
5461
5462 <P> This screen summarizes the quota report for this mailbox in the
5463 IMAP server. For each resource that you have a quota, this reports summarizes
5464 its use and limit.
5465
5466 <P> Your IMAP server administrator may have set a quota based either on
5467 the total size of your mailbox (STORAGE), or the number of messages in
5468 your mailbox (MESSAGES), or some other criteria. This will be reported
5469 to you indicating the type of quota, its total use and its limit.
5470
5471 <P> The report for STORAGE is reported in kibibytes (KiB). One kibibyte is
5472 1024 bytes. Each of the characters that you see in this help text is one
5473 byte, and this help text is about 1 kibibyte in size. Small messages sent
5474 by Alpine are normally less than 4 kibibytes in size (which includes
5475 headers and text). Other email programs may send messages with bigger
5476 sizes when they send messages, since they send plain text and an
5477 alternative part in HTML.
5478
5479 <P> A convenient way to save space for the STORAGE type of quota is by
5480 deleting attachments. This is done on each individual message by pressing
5481 the &quot;V&quot; command while reading the message text, then moving the cursor
5482 to the position of the attachment that is to be deleted, then pressing
5483 &quot;D&quot; to delete such attachment, going back to reading the
5484 message with the &quot;&lt;&quot; command and pressing &quot;S&quot; to
5485 save the message in the same folder you are reading from. The saved
5486 message will not have the attachment that was marked deleted. Now you
5487 can delete and expunge the message with the unwanted attachment.
5488
5489 <P>
5490 &lt;End of help on this topic&gt;
5491 </BODY>
5492 </HTML>
5493 ============= h_mail_thread_index =============
5494 <HTML>
5495 <HEAD>
5496 <TITLE>THREAD INDEX COMMANDS</TITLE>
5497 </HEAD>
5498 <BODY>
5499 <H1>THREAD INDEX COMMANDS</H1>
5500 <!--chtml if pinemode="function_key"-->
5501 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>
5502 -------------------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;-----------------------------<BR>
5503 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>
5504 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>
5505 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>
5506 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>
5507 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>
5508 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>
5509 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>
5510 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>
5511 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>
5512 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>
5513 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>
5514 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>
5515 <BR>
5516 Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;3<BR>
5517 -----------------------------<BR>
5518 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>
5519 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>
5520 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>
5521 <BR>
5522 Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;4<BR>
5523 -----------------------------<BR>
5524 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
5525 F6&nbsp;&nbsp;<A HREF="h_common_role">Compose&nbsp;using&nbsp;a&nbsp;role</A><BR>
5526 <BR>
5527 <!--chtml else-->
5528 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>
5529 -------------------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;---------------------------------<BR>
5530 &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>
5531 &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>
5532 &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>
5533 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>
5534 &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>
5535 &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>
5536 &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>
5537 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>
5538 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&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>
5539 <BR>
5540 Miscellaneous&nbsp;Operations&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;General&nbsp;Alpine&nbsp;Commands<BR>
5541 ------------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;---------------------<BR>
5542 &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>
5543 &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>
5544 &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>
5545 &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>
5546 &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>
5547 &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>
5548 &nbsp;:&nbsp;&nbsp;&nbsp;Select&nbsp;Messages&nbsp;in&nbsp;Current&nbsp;Thread<BR>
5549 <!--chtml endif-->
5550 <P>
5551
5552 NOTE:
5553 <OL>
5554  <LI>For help on a particular command, highlight the bold text associated
5555 with it above and hit Return.
5556  <LI>Availability of certain commands depends on <A HREF="h_common_conditional_cmds">feature settings</A>.
5557 </OL>
5558
5559 <H2>Description of the THREAD INDEX Screen</H2>
5560
5561 The THREAD INDEX displays summary information from each
5562 thread (conversation) in the current folder.
5563 This is useful if you want to quickly
5564 scan new threads, or find a particular thread without having to go
5565 through the text of each message, or to quickly get rid of junk
5566 threads, etc.
5567 The current thread is always highlighted.
5568 Each line of the THREAD INDEX contains the following columns: <P>
5569 <DL>
5570  <DT>STATUS:</DT>
5571  <DD> The markings on the left side of the thread tell you about its
5572 status.  You may see one or more of the following codes on any given
5573 thread:
5574 <UL>
5575   <LI> &quot;D&quot; for Deleted. All of the messages in this thread are marked for deletion but not yet eXpunged from the folder.
5576   <LI> &quot;A&quot; for Answered. All of the messages in this thread are marked answered.
5577   <LI> &quot;N&quot; for New. At least one message in the thread is New (you haven't looked at it yet).
5578   <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.
5579   <LI> &quot;-&quot; for cc-to-you. The &quot;-&quot; indicates that a
5580         message in the thread was sent to you as a cc:. This symbol will only show up if
5581         the feature
5582         &quot;<A HREF="h_config_mark_for_cc"><!--#echo var="FEAT_mark-for-cc"--></A>&quot; is turned on (which is the default).
5583   <LI> &quot;X&quot; for selected.  You have selected at least one message in the thread by using the
5584         &quot;select&quot; command.  (Some systems may optionally allow selected
5585         messages to be denoted by the index line being displayed in bold
5586         type instead.)
5587   <LI> &quot;*&quot; for Important.  You have previously used the &quot;Flag&quot; command
5588       to mark at least one message in this thread as &quot;important&quot;.
5589 </UL></DD><P>
5590
5591  <DT>THREAD NUMBER:</DT>
5592  <DD>Threads in a folder are numbered, from one through the number
5593 of threads in the folder, to help you know where you are in the folder.
5594 </DD><P>
5595
5596  <DT>DATE STARTED:</DT>
5597  <DD>The date the thread was started. This is actually from the Date header
5598 of the first message in the thread. It doesn't take different time zones
5599 into account.</DD><P>
5600
5601  <DT>WHO STARTED THE THREAD:</DT>
5602  <DD>This is usually the name of the sender of the first message in the thread, taken from
5603 the From header of the message.
5604 If there is no personal name given in that
5605 address, then the email address is used instead.
5606 If the message is from you (or from one of your
5607 <A HREF="h_config_alt_addresses">alternate addresses</A>),
5608 then the recipient's name is shown here instead, with the characters
5609 &quot;To: &quot; inserted before the name.
5610 (The idea of this is that if you started the thread you would rather see who
5611 the mail was sent to instead of that the mail was from you.)
5612 In Newsgroups, if you are
5613 the sender and there are no email recipients, the newsgroup name will be
5614 listed after the &quot;To: &quot;.
5615 </DD><P>
5616
5617  <DT>SIZE:</DT>
5618  <DD>The number in parentheses is the number of messages in the thread.</DD><P>
5619
5620  <DT>SUBJECT:</DT>
5621  <DD>As much of the thread's subject line as will fit on the screen.
5622 This is the subject of the first message in the thread.</DD>
5623 </DL>
5624
5625 <P><UL>
5626 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
5627 </UL>
5628 <P>
5629 &lt;End of help on this topic&gt;
5630 </BODY>
5631 </HTML>
5632 ============= h_mail_index =============
5633 <HTML>
5634 <HEAD>
5635 <TITLE>MESSAGE INDEX COMMANDS</TITLE>
5636 </HEAD>
5637 <BODY>
5638 <H1>MESSAGE INDEX COMMANDS</H1>
5639 <!--chtml if pinemode="function_key"-->
5640 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>
5641 -------------------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;-----------------------------<BR>
5642 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>
5643 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>
5644 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>
5645 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>
5646 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>
5647 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>
5648 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>
5649 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>
5650 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>
5651 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>
5652 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>
5653 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>
5654 <BR>
5655 Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;3<BR>
5656 -----------------------------<BR>
5657 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>
5658 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>
5659 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>
5660 <BR>
5661 Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;4<BR>
5662 -----------------------------<BR>
5663 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
5664 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>
5665 <BR>
5666 <!--chtml else-->
5667 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>
5668 -------------------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;---------------------------------<BR>
5669 &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>
5670 &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>
5671 &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>
5672 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>
5673 &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>
5674 &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>
5675 &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>
5676 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>
5677 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&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>
5678 Miscellaneous&nbsp;Operations<BR>
5679 ------------------------<BR>
5680 &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>
5681 &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>
5682 &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>
5683 &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>
5684 &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>
5685 &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>
5686 &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>
5687 &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>
5688 <!--chtml endif-->
5689 <P>
5690
5691 NOTE:
5692 <OL>
5693  <LI>For help on a particular command, highlight the bold text associated
5694 with it above and hit Return.
5695  <LI>Availability of certain commands depends on <A HREF="h_common_conditional_cmds">feature settings</A>.
5696 </OL>
5697
5698 <H2>Description of the MESSAGE INDEX Screen</H2>
5699
5700 The MESSAGE INDEX displays summary information from each
5701 message in the current folder.
5702 This is useful if you want to quickly
5703 scan new messages, or find a particular message without having to go
5704 through the text of each message, or to quickly get rid of junk
5705 messages, etc.
5706 <P>
5707 The current message is always highlighted
5708 and many commands operate on the current message.
5709 For example, the Delete command will delete the current message.
5710 If the folder is sorted by either Threads or OrderedSubject, then, depending
5711 on some of your configuration settings, a single line in the index may
5712 refer to an entire thread or to a subthread.
5713 If that is the case, then the commands that normally operate on the current
5714 message will operate on the thread or subthread instead.
5715 For example, the Delete command will delete the whole collapsed thread
5716 instead of just a single message.
5717 <P>
5718 Each line of the MESSAGE INDEX contains the following columns (by default --
5719 you can change this with the
5720 &quot;<A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A>&quot; option
5721 in the SETUP CONFIGURATION screen): <P>
5722 <DL>
5723  <DT>STATUS:</DT>
5724  <DD> The markings on the left side of the message tell you about its
5725 status.  You may see one or more of the following codes on any given
5726 message:
5727 <UL>
5728   <LI> &quot;D&quot; for Deleted.  You have marked this message for deletion but not
5729          yet eXpunged the folder.
5730   <LI> &quot;N&quot; for New.  You have not looked at the text of the message yet.
5731   <LI> &quot;A&quot; for Answered.  Any time you reply to a message it is considered
5732          to be answered.
5733   <LI> &quot;F&quot; for Forwarded.  Similar to Answered, this is set whenever you
5734          forward a message.
5735   <LI> &quot;+&quot; for direct-to-you.  The &quot;+&quot; indicates that a message was sent
5736         directly to your account, your copy is not part of a cc: or a
5737         mailing list.
5738   <LI> &quot;-&quot; for cc-to-you. The &quot;-&quot; indicates that a
5739         message was sent to you as a cc:. This symbol will only show up if
5740         the feature
5741         &quot;<A HREF="h_config_mark_for_cc"><!--#echo var="FEAT_mark-for-cc"--></A>&quot; is turned on (which is the default).
5742   <LI> &quot;X&quot; for selected.  You have selected the message by using the
5743         &quot;select&quot; command.  (Some systems may optionally allow selected
5744         messages to be denoted by the index line being displayed in bold
5745         type.)
5746   <LI> &quot;*&quot; for Important.  You have previously used the &quot;Flag&quot; command
5747       to mark this message as &quot;important&quot;.
5748 </UL></DD><P>
5749
5750  <DT>MESSAGE NUMBER:</DT>
5751  <DD>Messages in a folder are numbered, from one through the number
5752 of messages in the folder, to help you know where you are in the folder.
5753 These numbers are always in increasing order, even if you sort the folder
5754 in a different way.</DD><P>
5755
5756  <DT>DATE SENT:</DT>
5757  <DD>The date the message was sent.  By default, messages are
5758 ordered by arrival time, not by date sent.  Most of the time, arrival time
5759 and date sent (effectively departure time) are similar.  Sometimes,
5760 however, the index will appear to be out of order because a message took a
5761 long time in delivery or because the sender is in a different time
5762 zone than you are. This date is just the date from the Date header
5763 field in the message.</DD><P>
5764
5765  <DT>WHO SENT THE MESSAGE:</DT>
5766  <DD>This is usually the name of the sender of the message, taken from
5767 the From header of the message.
5768 If there is no personal name given in that
5769 address, then the email address is used instead.
5770 If the message is from you (or from one of your
5771 <A HREF="h_config_alt_addresses">alternate addresses</A>),
5772 then the recipient's name is shown here instead, with the characters
5773 &quot;To: &quot; inserted before the name.
5774 (The idea of this is that if you sent the mail you would rather see who
5775 the mail was sent to instead of that the mail was from you.
5776 This behavior may be changed by modifying the <!--#echo var="VAR_index-format"--> option mentioned
5777 above.
5778 In particular, use the FROM token or the FROMORTONOTNEWS token
5779 in place of the FROMORTO token.)
5780 In Newsgroups, if you are
5781 the sender and there are no email recipients, the newsgroup name will be
5782 listed after the &quot;To: &quot;. </DD><P>
5783
5784  <DT>SIZE:</DT>
5785  <DD>The number in parentheses is the number of characters in the message.
5786 It may have a suffix of K, M, or G which means the number should be
5787 multiplied by one thousand, one million, or one billion to get the
5788 size of the message.</DD><P>
5789
5790  <DT>SUBJECT:</DT>
5791  <DD>As much of the message's subject line as will fit on the screen.</DD>
5792 </DL>
5793
5794 <P><UL>
5795 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
5796 </UL>
5797 <P>
5798 &lt;End of help on this topic&gt;
5799 </BODY>
5800 </HTML>
5801 ============= h_mail_view ========================
5802 <HTML>
5803 <HEAD>
5804 <TITLE>MESSAGE TEXT SCREEN</TITLE>
5805 </HEAD>
5806 <BODY>
5807 <H1>MESSAGE TEXT SCREEN</H1>
5808 <!--chtml if pinemode="function_key"-->
5809 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>
5810 -------------------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;------------------------------<BR>
5811 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>
5812 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>
5813 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>
5814 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>
5815 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>
5816 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>
5817 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>
5818 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>
5819 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>
5820 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>
5821 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>
5822 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>
5823 <BR>
5824 Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;3<BR>
5825 ------------------------------<BR>
5826 F1&nbsp;&nbsp;Show&nbsp;Help&nbsp;Text<BR>
5827 F2&nbsp;&nbsp;Toggle&nbsp;to&nbsp;see&nbsp;more&nbsp;commands<BR>
5828 F3&nbsp;&nbsp;<A HREF="h_view_cmd_hilite">View&nbsp;hilited</A><BR>
5829 F4&nbsp;&nbsp;Select&nbsp;current&nbsp;message<BR>
5830 F5&nbsp;&nbsp;Previous&nbsp;selectable&nbsp;item<BR>
5831 F6&nbsp;&nbsp;Next&nbsp;selectable&nbsp;item<BR>
5832 F7&nbsp;&nbsp;<A HREF="h_common_jump">Jump</A>&nbsp;to&nbsp;message&nbsp;number<BR>
5833 F8&nbsp;&nbsp;<A HREF="h_common_nextnew">Next&nbsp;new</A>&nbsp;message<BR>
5834 F9&nbsp;&nbsp;<A HREF="h_common_hdrmode">Display&nbsp;full&nbsp;headers</A><BR>
5835 F10&nbsp;<A HREF="h_common_bounce">Bounce</A>&nbsp;message<BR>
5836 F11&nbsp;<A HREF="h_common_flag">Flag</A>&nbsp;message<BR>
5837 F12&nbsp;<A HREF="h_common_pipe">Pipe</A>&nbsp;to&nbsp;a&nbsp;Unix&nbsp;command<BR>
5838 Available&nbsp;Commands&nbsp;--&nbsp;Group&nbsp;4<BR>
5839 F5&nbsp;&nbsp;<A HREF="h_common_role">Compose using a role</A><BR>
5840 <!--chtml else-->
5841 Operations&nbsp;on&nbsp;the&nbsp;Current&nbsp;Message<BR>
5842 ---------------------------------<BR>
5843 <BR>
5844 &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>
5845 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>
5846 &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>
5847 &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>
5848 &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>
5849 &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>
5850 &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>
5851 &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>
5852 &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>
5853 <BR>
5854 Navigating&nbsp;the&nbsp;List&nbsp;of&nbsp;Messages&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Other&nbsp;Commands<BR>
5855 -------------------------------&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;----------------------------<BR>
5856 &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>
5857 &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>
5858 &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>
5859 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>
5860 <BR>
5861 General&nbsp;Alpine&nbsp;Commands<BR>
5862 ---------------------<BR>
5863 &nbsp;O&nbsp;&nbsp;Show&nbsp;all&nbsp;other&nbsp;available&nbsp;commands<BR>
5864 &nbsp;?&nbsp;&nbsp;Show&nbsp;Help&nbsp;text&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Q&nbsp;Quit&nbsp;Alpine<BR>
5865 &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>
5866 &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>
5867 &nbsp;&nbsp;&nbsp;&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>
5868 <!--chtml endif-->
5869 <P>
5870
5871 NOTE:
5872 <OL>
5873  <LI>For help on a particular command, highlight the bold text associated
5874 with it above and hit Return.
5875  <LI>Availability of certain commands depends on <A HREF="h_common_conditional_cmds">feature settings</A>.
5876 </OL>
5877
5878 <H2>Description of the MESSAGE TEXT Screen</H2>
5879
5880 The top line of the view message screen displays status
5881 information about the currently open collection and folder and about the
5882 current message.  It shows the name of the collection in angle brackets
5883 and then the name of the folder.  The line also displays the number
5884 of messages in the folder, the number of the current message and the
5885 percentage of the current message that has been displayed on the screen.
5886 If the message is marked for deletion &quot;DEL&quot; will appear in the upper
5887 right corner.
5888 If the message has been answered (but not deleted) &quot;ANS&quot; will show
5889 in the corner.
5890 <P>
5891
5892 NOTE: to rapidly move to the end of a message, hit the
5893 <!--chtml if pinemode="function_key"-->F8<!--chtml else-->W<!--chtml endif-->
5894 (or Ctrl-W) key followed
5895 by Ctrl-V.  Similarly,
5896 <!--chtml if pinemode="function_key"-->F8<!--chtml else-->W<!--chtml endif-->
5897 followed by Ctrl-Y will take you to the beginning of
5898 a message.
5899
5900 <H2>Explanation of Alternate Character Sets</H2>
5901
5902 Alpine attempts to stay out of the way so that it won't prevent you from
5903 viewing mail in any character set.  It will simply send the message to
5904 your display device.  If the device is capable of displaying the
5905 message as it was written it will do so.  If not, the display may be
5906 partially or totally incorrect.
5907 If the message contains characters that are not representable in your
5908 <A HREF="h_config_char_set">&quot;Display Character Set&quot;</A>
5909 variable in your configuration, then a warning message will be printed
5910 to your screen at the beginning of the message display.
5911 It is probably best to use UNIX Alpine in a terminal emulator
5912 capable of displaying UTF-8 characters.
5913 See <A HREF="h_config_char_set">Display Character Set</A> for a little
5914 more information about character set settings.
5915
5916 <P><UL>
5917 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
5918 </UL>
5919 <P>
5920 &lt;End of help on this topic&gt;
5921 </BODY>
5922 </HTML>
5923 ======= h_index_cmd_select =======
5924 <HTML>
5925 <HEAD>
5926 <TITLE>Selecting: Select and WhereIs/Select</TITLE>
5927 </HEAD>
5928 <BODY>
5929 <H1>Selecting: Select and WhereIs/Select</H1>
5930
5931 Aggregate operations give you the ability to process a group of messages
5932 at once.  Acting on multiple messages requires two steps: (1) selecting a
5933 set of messages and then; (2) applying a command to that set. The first
5934 part is handled by the select command.  Select allows you to
5935 select messages based on their status (read, answered, etc.), contents,
5936 date, size, or keywords.
5937 You may also select based on one of your Rules or based on threads,
5938 and there are quick options to select a specific message or range of messages,
5939 to select the current message, or to select all messages.
5940 <P>
5941
5942 We describe the various selection criteria briefly:
5943 <P>
5944
5945 <DL>
5946 <DT>select All</DT>
5947 <DD> Marks all the messages in the folder as selected.
5948 </DD>
5949
5950 <DT>select Cur</DT>
5951 <DD> Selects the currently highlighted message or currently highlighted
5952 set of messages if in a threaded view.
5953 </DD>
5954
5955 <DT>select by Number</DT>
5956 <DD> Select by message number. This may be a comma-separated list instead or
5957 a single entry.
5958 Each element in the list may be either a single message number or a range
5959 of numbers with a dash between the lowest and highest member of the range.
5960 Some examples are 7 to select only message number 7; 2-5 to select messages
5961 2 through 5; and 2-5,7-9,11 to select messages 2, 3, 4, 5, 7, 8, 9, and 11.
5962 The word &quot;end&quot; or the character &quot;$&quot; may be used as a
5963 substitute for the highest numbered message in the folder, while the
5964 character &quot;.&quot; represents the message number holding the position
5965 of the cursor in the folder.
5966 If in a separate thread index where the numbers refer to threads instead of
5967 to messages, then you will be selecting all of the messages in the
5968 referenced threads instead of selecting by message number.
5969 </DD>
5970
5971 <DT>select by Date</DT>
5972 <DD> Select by either the date stored in the Date headers of each message,
5973 or by the date when the messages arrived.
5974 This does not adjust for different time zones, but just checks to see what
5975 day the message was sent on.
5976 You may type in a date. If you do, the date should be in the form
5977 <P><SAMP><CENTER>DD-Mon-YYYY</CENTER></SAMP><P>
5978 For example,
5979 <P><SAMP><CENTER>24-Nov-2004</CENTER></SAMP><P>
5980 or
5981 <P><SAMP><CENTER>09-Nov-2004</CENTER></SAMP><P>
5982 If the date you want is close to the current date, it is probably
5983 easier to use the &quot;^P&nbsp;Prev Day&quot; or &quot;^N&nbsp;Next Day&quot; commands to change the default date that
5984 is displayed, instead of typing in the date yourself.
5985 Or, the &quot;^X&nbsp;Cur Msg&quot; command may be used to fill in
5986 the date of the currently highlighted message.
5987 <P>
5988 There are six possible settings that are selected using the
5989 &quot;^W&nbsp;Toggle When&quot; command.
5990 Three of them select messages based on the Date headers.
5991 They are &quot;SENT SINCE&quot;, &quot;SENT BEFORE&quot;,
5992 and &quot;SENT ON&quot;.
5993 SINCE is all messages with the selected date or later.
5994 BEFORE is all messages earlier than the selected date (not including the day
5995 itself).
5996 ON is all messages sent on the selected date.
5997 The other three select messages in the same way but they use the arrival
5998 times of the messages instead of the Date headers included in the messages.
5999 Those three are &quot;ARRIVED SINCE&quot;, &quot;ARRIVED BEFORE&quot;,
6000 and &quot;ARRIVED ON&quot;.
6001 When you save a message from one folder to another the arrival time is
6002 preserved.
6003 </DD>
6004
6005 <DT>select by Text</DT>
6006 <DD> Selects messages based on the message contents.
6007 This allows you to select a set of messages based on whether or not the
6008 message headers or message body contain specified text.
6009 You may look for text in the Subject, the From header,
6010 the To header, or the Cc header.
6011 You may also choose Recipient, which searches for the text in
6012 either the To or the Cc header;
6013 or Participant, which means To or Cc or From.
6014 Besides those specific header searches, you may also search the entire
6015 header and text of the message with &quot;All Text&quot;, or just the
6016 body of the message.
6017 <P>
6018 To search for the absence of text, first type the &quot;! Not&quot; command
6019 before typing the specific type of text search.
6020 For example, you could type &quot;!&quot; followed by &quot;S&quot; to
6021 search for all messages that do not contain a particular word in their
6022 Subjects.
6023 <P>
6024 If you choose a Subject search, you may use the subject from the current
6025 message by typing the &quot;^X Cur Subject&quot; command.
6026 You may then edit it further if you wish.
6027 For example, you might select the subject of a reply and edit the
6028 &quot;Re:&nbsp;&quot; off of the front of it in order to search for
6029 the original message being replied to.
6030 All of the other header searches allow you to use addresses from the
6031 headers of the current message if you want to.
6032 You may use the &quot;^T Cur To&quot;, &quot;^R Cur From&quot;, or
6033 &quot;^W Cur Cc&quot;.
6034 In each case, if there is more than one address, only the first is offered.
6035 </DD>
6036
6037 <DT>select by Status</DT>
6038 <DD> Selects messages based on their status.
6039 You may select all New, Important, Deleted, Answered, Recent, or Unseen
6040 messages.
6041 Or, if you first type the &quot;! Not&quot; command, you get not New,
6042 or not Important, and so on.
6043 If you select Deleted messages, you will get all messages with their
6044 Deleted flag set.
6045 Likewise for Important messages, all messages that you have flagged as
6046 being Important with the
6047 <A HREF="h_common_flag">Flag</A> command.
6048 The &quot;New&quot; and &quot;Answered&quot; choices are a little bit odd
6049 because they try to match what you see on the screen by default.
6050 &quot;New&quot; is a shorthand for messages that are Unseen, Undeleted,
6051 and Unanswered.
6052 If you have looked at the message, or deleted it, or answered it; then it
6053 is not considered &quot;New &quot;.
6054 &quot;!&nbsp;New&quot; is the opposite of &quot;New&quot;.
6055 <P>
6056 &quot;Answered&quot; is another one that is a little different.
6057 It means that the message has been Answered <EM>and</EM> is not deleted.
6058 And to make it even more confusing, &quot;!&nbsp;Answered&quot; is not
6059 the opposite of &quot;Answered&quot;!
6060 Instead, &quot;!&nbsp;Answered&quot; stands for messages that are
6061 both Unanswered <EM>and</EM> not deleted.
6062 <P>
6063 The other two types were added later because the special nature of the
6064 New flag was not what was wanted by all users.
6065 New does match what you see in the index by default, but if you use
6066 the IMAPSTATUS or SHORTIMAPSTATUS token in the
6067 &quot;<A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A>&quot; it may not
6068 be exactly what you want.
6069 &quot;Unseen&quot; simply selects all unseen messages, whether or not
6070 they are deleted or answered, and
6071 &quot;Recent&quot; selects all of the messages that have been added to
6072 the folder since you started this Alpine session.
6073 (That's not technically quite true. If there are multiple mail clients
6074 reading an IMAP mailbox, each message will be marked as Recent in only
6075 one of the client's sessions.)
6076 </DD>
6077
6078 <DT>select by siZe</DT>
6079 <DD> Selects messages based on their size being smaller than or larger
6080 than the size you specify.
6081 The size is the number of bytes.
6082 You may use the suffix &quot;K&quot; or &quot;k&quot; to mean 1,000 times
6083 the number.
6084 For example, 7K is the same as 7000.
6085 The suffix &quot;M&quot; or &quot;m&quot; means 1,000,000 times the number,
6086 and the suffix &quot;G&quot; or &quot;g&quot; means 1,000,000,000 times.
6087 Use the &quot;^W&quot; command to toggle back and forth between Smaller
6088 and Larger.
6089 </DD>
6090
6091 <DT>select by Keyword</DT>
6092 <DD> Selects messages that either have or do not have
6093 (using the &quot;!&nbsp;Not&quot; command)
6094 a particular <A HREF="h_config_keywords">Keyword</A> set.
6095 One way to select a keyword is to use the &quot;^T&nbsp;To&nbsp;List&quot;
6096 command to select one from your list of keywords.
6097 The
6098 <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.
6099 </DD>
6100
6101 <DT>select by Rule</DT>
6102 <DD> Selects messages that either match or don't match
6103 (using the &quot;!&nbsp;Not&quot; command)
6104 one of the Rules you have defined.
6105 The most likely method of filling in the Rule is to use the
6106 &quot;^T&nbsp;To&nbsp;List&quot;
6107 command to select one of your Rules.
6108 All of the Rules you have defined will be in the list, including
6109 Rules for Searching, Indexcolors, Filtering, Roles, Score setting, and Other.
6110 They may not all make sense for this purpose, but they are all there for
6111 flexibility.
6112 You might find it useful to define some rules solely for the purpose
6113 of being used by the Select command.
6114 There is a special category for such Rules. They are called Search Rules.
6115 <P>
6116 Unfortunately, Alpine does not allow all possible Rules to be defined.
6117 For example, there is no logical OR operation.
6118 OR is accomplished in the Filter Rules or the other types of Rules by
6119 simply defining two rules, one that matches the first part of the OR
6120 and another that matches the second part.
6121 But you can't do that here, since you only have a single Rule to work with.
6122 Likewise, the order of Rules is usually important.
6123 For example, if the first Filter Rule (or Indexcolor rule or ...) matches
6124 a message, then that stops the search for a further match.
6125 This means that you may be confused if you try to use Select by Rule to
6126 check your Filter rules because the order is important when filtering but
6127 is not considered here.
6128 </DD>
6129
6130 <DT>select by tHread</DT>
6131 <DD> Selects all of the messages in the current thread.
6132 </DD>
6133 </DL>
6134
6135 After you have an initial selection, the next and subsequent selection
6136 commands modify the selection.
6137 The select command changes. It first gives
6138 you selection &quot;alteration&quot; options: &quot;unselect All&quot;,
6139 &quot;unselect Current&quot;,
6140 &quot;Broaden selection&quot; (implements a logical OR), and
6141 &quot;Narrow selection&quot; (implements a logical AND).
6142 After you choose either Broaden or Narrow, you then choose one of the
6143 selection criteria listed above (by Text or Number or ...).
6144 You may use select as many times as you wish to get the selected set right.
6145 <P>
6146
6147 The WhereIs command has a feature (Ctrl-X) to
6148 select all the messages that match the WhereIs search. WhereIs searches
6149 through just the text that appears on the MESSAGE INDEX screen.
6150 This method is often slower than using the select command itself, unless the
6151 line you are looking for is not too far away in the index.
6152 <P>
6153
6154 The availability of the aggregate operations commands is determined by the
6155 <A HREF="h_config_enable_agg_ops">&quot;<!--#echo var="FEAT_enable-aggregate-command-set"-->&quot;</A>
6156 Feature-List option in your Alpine
6157 configuration, which defaults to set.
6158 The features
6159 <A HREF="h_config_auto_zoom">&quot;<!--#echo var="FEAT_auto-zoom-after-select"-->&quot;</A>
6160 and
6161 <A HREF="h_config_select_wo_confirm">&quot;<!--#echo var="FEAT_select-without-confirm"-->&quot;</A>
6162 affect the behavior of the Select command.
6163
6164 <P>
6165 &lt;End of help on this topic&gt;
6166 </BODY>
6167 </HTML>
6168 ======= h_select_rule =======
6169 <HTML>
6170 <HEAD>
6171 <TITLE>Select: Rule</TITLE>
6172 </HEAD>
6173 <BODY>
6174 <H1>Select: Rule</H1>
6175
6176 You are selecting messages that either match or don't match
6177 one of the Rules you have defined.
6178 You may either type the nickname of the Rule at the prompt, or use the
6179 &quot;^T&nbsp;To&nbsp;List&quot;
6180 command to select one of your Rules.
6181 All of the Rules you have defined will be in the list, including
6182 Rules for Indexcolors, Filtering, Roles, Score setting, and Other.
6183 They may not all make sense for this purpose, but they are all there for
6184 flexibility.
6185 Rules may be added by using the Setup/Rules screen off of the main Alpine
6186 menu.
6187 <P>
6188 Unfortunately, Alpine does not allow all possible Rules to be defined.
6189 For example, there is no logical OR operation.
6190 OR is accomplished in the Filter Rules or the other types of Rules by
6191 simply defining two rules, one that matches the first part of the OR
6192 and another that matches the second part.
6193 But you can't do that here, since you only have a single Rule to work with.
6194 Likewise, the order of Rules is usually important.
6195 For example, if the first Filter Rule (or Indexcolor rule or ...) matches
6196 a message, then that stops the search for a further match.
6197 This means that you may be confused if you try to use Select by Rule to
6198 check your Filter rules because the order is important when filtering but
6199 is not considered here.
6200
6201 <P>
6202 &lt;End of help on this topic&gt;
6203 </BODY>
6204 </HTML>
6205 ======= h_select_text =======
6206 <HTML>
6207 <HEAD>
6208 <TITLE>Select: Text</TITLE>
6209 </HEAD>
6210 <BODY>
6211 <H1>Select: Text</H1>
6212
6213 You are selecting messages based on the contents of the message.
6214 This allows you to select a set of messages based on whether or not the
6215 message headers or message body contain specified text.
6216 You may look for text in the Subject, the From header,
6217 the To header, or the Cc header.
6218 You may also choose Recipient, which searches for the text in
6219 either the To or the Cc header;
6220 or Participant, which means either the To header, or the Cc header,
6221 or the From header.
6222 Besides those specific header searches, you may also search the entire
6223 header and text of the message with &quot;All Text&quot;, or just the
6224 body of the message with &quot;Body&quot;.
6225 <P>
6226 To search for the absence of text, first type the &quot;!&nbsp;Not&quot; command
6227 before typing the specific type of text search.
6228 For example, you could type &quot;!&quot; followed by &quot;S&quot; to
6229 search for all messages that do not contain a particular word in their
6230 Subjects.
6231 <P>
6232 If you choose a Subject search, you may use the subject from the current
6233 message by typing the &quot;^X Cur Subject&quot; command.
6234 You may then edit it further if you wish.
6235 For example, you might select the subject of a reply and edit the
6236 &quot;Re:&nbsp;&quot; off of the front of it in order to search for
6237 the original message being replied to.
6238 All of the other header searches allow you to use addresses from the
6239 headers of the current message if you want to.
6240 You may use the &quot;^T Cur To&quot;, &quot;^R Cur From&quot;, or
6241 &quot;^W Cur Cc&quot;.
6242 In each case, if there is more than one address, only the first is offered.
6243
6244 <P>
6245 &lt;End of help on this topic&gt;
6246 </BODY>
6247 </HTML>
6248 ======= h_select_status =======
6249 <HTML>
6250 <HEAD>
6251 <TITLE>Select: Status</TITLE>
6252 </HEAD>
6253 <BODY>
6254 <H1>Select: Status</H1>
6255
6256 You are selecting messages based on the status of the message.
6257 For example, whether or not the message has been marked Deleted or Important,
6258 or whether or not it has been Answered or is New.
6259 If you first type the &quot;!&nbsp;Not&quot; command, you will get the
6260 opposite: not Deleted, not Important, and so on.
6261 <P>
6262 If you select Deleted messages, you will get all messages with their
6263 Deleted flag set.
6264 Likewise for Important messages, all messages that you have flagged as
6265 being Important with the
6266 <A HREF="h_common_flag">Flag</A> command.
6267 The &quot;New&quot; and &quot;Answered&quot; choices are a little bit odd
6268 because they try to match what you see on the screen by default.
6269 &quot;New&quot; is a shorthand for messages that are Unseen, Undeleted,
6270 and Unanswered.
6271 If you have looked at the message, or deleted it, or answered it; then it
6272 is not considered &quot;New &quot;.
6273 &quot;!&nbsp;New&quot; is the opposite of &quot;New&quot;.
6274 <P>
6275 &quot;Answered&quot; is another one that is a little different.
6276 It means that the message has been Answered <EM>and</EM> is not deleted.
6277 And to make it even more confusing, &quot;!&nbsp;Answered&quot; is not
6278 the opposite of &quot;Answered&quot;!
6279 Instead, &quot;!&nbsp;Answered&quot; stands for messages that are
6280 both Unanswered <EM>and</EM> not deleted.
6281 <P>
6282 (The New and Answered options may seem counter-intuitive.
6283 The reason it is done this way is
6284 because, by default, a Deleted message will show up with the &quot;D&quot;
6285 symbol in the MAIL INDEX screen even if it is New or Answered.
6286 The Delete symbol overrides the New and Answered symbols, because you
6287 usually don't care about the message anymore once you've deleted it.
6288 Similarly, you usually only care about whether a message is Answered or
6289 not if it is not Deleted.
6290 Once it is Deleted you've put it out of your mind.)
6291 <P>
6292 The other two options were added later because the special nature of the
6293 New flag was not what was wanted by all users.
6294 New does match what you see in the index by default, but if you use
6295 the IMAPSTATUS or SHORTIMAPSTATUS token in the
6296 &quot;<A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A>&quot; it may not
6297 be exactly what you expect.
6298 &quot;Unseen&quot; simply selects all unseen messages, whether or not
6299 they are deleted or answered, and
6300 &quot;Recent&quot; selects all of the messages that have been added to
6301 the folder since you started this Alpine session.
6302 (That's not technically quite true. If there are multiple mail clients
6303 reading an IMAP mailbox, each message will be marked as Recent in only
6304 one of the client's sessions.
6305 That behavior can be convenienent for some purposes, like filtering, but
6306 it isn't usually what you expect when selecting.)
6307
6308 <P>
6309 &lt;End of help on this topic&gt;
6310 </BODY>
6311 </HTML>
6312 ======= h_index_cmd_apply =======
6313 <HTML>
6314 <HEAD>
6315 <TITLE>Apply Command</TITLE>
6316 </HEAD>
6317 <BODY>
6318 <H1>Apply Command</H1>
6319
6320 Apply
6321 (<!--chtml if pinemode="function_key"-->F6<!--chtml else-->A<!--chtml endif-->)
6322 is the second step of most aggregate operations.  Apply
6323 becomes active any time there is a defined set of selected messages.  The
6324 following commands can be applied to a selected message set: delete,
6325 undelete, reply, forward,
6326 <!--chtml if pinemode="os_windows"-->
6327 <!--chtml else-->
6328 pipe,
6329 <!--chtml endif-->
6330 print, take address, save, export, bounce, and flag.
6331 <P>
6332
6333 The behavior of some of these commands in an aggregate sense is not easy to
6334 explain.  Try them out to see what they do.
6335 The feature
6336 <A HREF="h_config_auto_unzoom">&quot;<!--#echo var="FEAT_auto-unzoom-after-apply"-->&quot;</A>
6337 affects the behavior of the Apply command, as does the feature
6338 <A HREF="h_config_auto_unselect">&quot;<!--#echo var="FEAT_auto-unselect-after-apply"-->&quot;</A>.
6339
6340 <P>
6341 &lt;End of help on this topic&gt;
6342 </BODY>
6343 </HTML>
6344 ======= h_index_cmd_zoom =======
6345 <HTML>
6346 <HEAD>
6347 <TITLE>ZoomMode Command</TITLE>
6348 </HEAD>
6349 <BODY>
6350 <H1>ZoomMode Command</H1>
6351
6352 Another action you might want to take on a set of selected messages is to
6353 zoom in on them.  Like apply, zoom only becomes active when messages have
6354 been selected.
6355 ZoomMode
6356 (<!--chtml if pinemode="function_key"-->F3<!--chtml else-->Z<!--chtml endif-->)
6357 is a toggle command that allows you to
6358 zoom-in (and only see the selected messages) and zoom-out (to see all
6359 messages in the folder).  Neither apply nor zoom removes the markings that
6360 define the selected set; you need to use a select command in order
6361 to do that.
6362
6363 <P>
6364 &lt;End of help on this topic&gt;
6365 </BODY>
6366 </HTML>
6367 ======= h_index_collapse_expand =======
6368 <HTML>
6369 <HEAD>
6370 <TITLE>Collapse/Expand Command</TITLE>
6371 </HEAD>
6372 <BODY>
6373 <H1>Collapse/Expand Command</H1>
6374
6375 The Collapse/Expand command is only available from the MESSAGE INDEX screen when
6376 the folder is sorted by either Threads or OrderedSubject, and the
6377 <A HREF="h_config_thread_disp_style"><!--#echo var="VAR_threading-display-style"--></A>
6378 is set to something other than &quot;none&quot;.
6379 By default, this command collapses or expands the subthread that starts at
6380 the currently highlighted message, if any.
6381 If the subthread is already collapsed, then this command expands it.
6382 If the subthread is expanded, then this command collapses it.
6383 If there are no more messages below the current message in the
6384 thread tree (that is, there are no replies to the current message) then
6385 this command does nothing.
6386
6387 <P>
6388 The behavior of this command is affected by the option
6389 <A HREF="h_config_slash_coll_entire">&quot;<!--#echo var="FEAT_slash-collapses-entire-thread"-->&quot;</A>.
6390 Normally, this command Collapses or Expands the subthread that
6391 starts at the currently highlighted message.
6392 If the above option is set, then this command Collapses or Expands the
6393 entire current thread instead of just the subthread.
6394 The current thread is simply the top-level thread that contains the
6395 current message.
6396
6397 <P>
6398 &lt;End of help on this topic&gt;
6399 </BODY>
6400 </HTML>
6401 ======= h_index_cmd_sort =======
6402 <HTML>
6403 <HEAD>
6404 <TITLE>Sort Command</TITLE>
6405 </HEAD>
6406 <BODY>
6407 <H1>Sort Command</H1>
6408
6409 In Alpine's generic configuration, messages are presented in the order in
6410 which they arrive.  This default can be changed in the SETUP CONFIGURATION
6411 with the &quot;<A HREF="h_config_sort_key"><!--#echo var="VAR_sort-key"--></A>&quot; option.
6412 You can also re-sort the folder on demand with the sort
6413 (<!--chtml if pinemode="function_key"-->F7<!--chtml else-->$<!--chtml endif-->)
6414 command.
6415 Your sorting options are:
6416 <P>
6417 <UL>
6418  <LI> <A HREF="h_index_sort_arrival">A</A>rrival
6419  <LI> <A HREF="h_index_sort_date">D</A>ate
6420  <LI> <A HREF="h_index_sort_subj">S</A>ubject
6421  <LI> <A HREF="h_index_sort_ordsubj">O</A>rderedSubject
6422  <LI> t<A HREF="h_index_sort_thread">H</A>read
6423  <LI> <A HREF="h_index_sort_from">F</A>rom
6424  <LI> si<A HREF="h_index_sort_size">Z</A>e
6425  <LI> scor<A HREF="h_index_sort_score">E</A>,
6426  <LI> <A HREF="h_index_sort_to">T</A>o
6427  <LI> <A HREF="h_index_sort_cc">C</A>c
6428 </UL>
6429
6430 <P>
6431 The Reverse option will toggle the order the index is currently
6432 sorted by, but will not change the relative sort order.
6433
6434 <P>
6435 Sorting a folder does not actually rearrange the way the folder is saved,
6436 it just re-arranges how the messages are presented to you.  This means
6437 that Alpine has to do the work of sorting every time you change sort order.
6438 Sometimes, especially with PC-Alpine or with large folders, this could take
6439 a while.
6440
6441 <P>
6442 &lt;End of help on this topic&gt;
6443 </BODY>
6444 </HTML>
6445 ======= h_index_sort_default =======
6446 <HTML>
6447 <HEAD>
6448 <TITLE>SORT OPTION: Default</TITLE>
6449 </HEAD>
6450 <BODY>
6451 <H1>SORT OPTION: Default</H1>
6452
6453 The <EM>Default</EM> sort option just means to use the default sort order
6454 set in the
6455 <li><a href="h_config_sort_key"><!--#echo var="VAR_sort-key"--></a>
6456 option in Setup/Config.
6457
6458 <P>
6459 &lt;End of help on this topic&gt;
6460 </BODY>
6461 </HTML>
6462 ======= h_index_sort_arrival =======
6463 <HTML>
6464 <HEAD>
6465 <TITLE>SORT OPTION: Arrival</TITLE>
6466 </HEAD>
6467 <BODY>
6468 <H1>SORT OPTION: Arrival</H1>
6469
6470 The <EM>Arrival</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX
6471 in the order that they exist in the folder.  This is usually the same as the
6472 order in which they arrived.  This option is comparable to not sorting
6473 the messages at all.
6474
6475 <P>
6476 &lt;End of help on this topic&gt;
6477 </BODY>
6478 </HTML>
6479 ======= h_index_sort_date =======
6480 <HTML>
6481 <HEAD>
6482 <TITLE>SORT OPTION: Date</TITLE>
6483 </HEAD>
6484 <BODY>
6485 <H1>SORT OPTION: Date</H1>
6486
6487 The <EM>Date</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX
6488 according to the date and time they were
6489 sent.
6490
6491 <P>
6492 On a folder like INBOX, sorting by &quot;Date&quot; should be almost
6493 identical to sorting by &quot;Arrival&quot;.
6494
6495 <P>
6496 &lt;End of help on this topic&gt;
6497 </BODY>
6498 </HTML>
6499 ======= h_index_sort_subj =======
6500 <HTML>
6501 <HEAD>
6502 <TITLE>SORT OPTION: Subject</TITLE>
6503 </HEAD>
6504 <BODY>
6505 <H1>SORT OPTION: Subject</H1>
6506
6507 The <EM>Subject</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX
6508 by subject.
6509
6510 <P>
6511 Messages with the same subject are
6512 first grouped together, and then the groups of like-subject messages
6513 are arranged alphabetically.
6514
6515 <P>
6516 Alpine ignores leading &quot;Re:&quot; and
6517 &quot;re:&quot; and trailing &quot;(fwd)&quot; when determining the
6518 likeness and alphabetical order of subject lines.
6519
6520 <P>
6521 &lt;End of help on this topic&gt;
6522 </BODY>
6523 </HTML>
6524 ======= h_index_sort_ordsubj =======
6525 <HTML>
6526 <HEAD>
6527 <TITLE>SORT OPTION: OrderedSubject</TITLE>
6528 </HEAD>
6529 <BODY>
6530 <H1>SORT OPTION: OrderedSubject</H1>
6531
6532 The <EM>OrderedSubject</EM> sort option arranges messages in the
6533 MESSAGE&nbsp;INDEX by grouping all messages with the same subject
6534 together, similar to sort by <A HREF="h_index_sort_subj">S</A>ubject.
6535
6536 <P>
6537 However, <EM>OrderedSubj</EM> then arranges the groups of like-subject
6538 messages by the date of the oldest message in the group.
6539
6540 <P>
6541 This sort method provides for pseudo threading of conversations within
6542 a folder.
6543 You may want to try sorting by Thread instead.
6544
6545 <P>
6546 &lt;End of help on this topic&gt;
6547 </BODY>
6548 </HTML>
6549 ======= h_index_sort_thread =======
6550 <HTML>
6551 <HEAD>
6552 <TITLE>SORT OPTION: Thread</TITLE>
6553 </HEAD>
6554 <BODY>
6555 <H1>SORT OPTION: Thread</H1>
6556
6557 The <EM>Thread</EM> sort option arranges messages in the
6558 MESSAGE&nbsp;INDEX by grouping all messages that indicate
6559 they are part of a conversation (discussion thread) taking
6560 place within a mailbox or newsgroup.  This indication is
6561 based on information in the message's header -- specifically
6562 its <tt>References:</tt>, <tt>Message-ID:</tt>, and <tt>Subject:</tt> fields.
6563
6564 <P>
6565 &lt;End of help on this topic&gt;
6566 </BODY>
6567 </HTML>
6568 ======= h_index_sort_from =======
6569 <HTML>
6570 <HEAD>
6571 <TITLE>SORT OPTION: From</TITLE>
6572 </HEAD>
6573 <BODY>
6574 <H1>SORT OPTION: From</H1>
6575
6576 The <EM>From</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX
6577 by the name of the author of the message.
6578
6579 <P>
6580 Messages with the same author are grouped together. Groups of
6581 messages are then put into alphabetical order according to message
6582 author.
6583
6584 <P>
6585 &lt;End of help on this topic&gt;
6586 </BODY>
6587 </HTML>
6588 ======= h_index_sort_size =======
6589 <HTML>
6590 <HEAD>
6591 <TITLE>SORT OPTION: Size</TITLE>
6592 </HEAD>
6593 <BODY>
6594 <H1>SORT OPTION: Size</H1>
6595
6596 The <EM>Size</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX
6597 by their relative sizes.
6598
6599 <P>
6600 &lt;End of help on this topic&gt;
6601 </BODY>
6602 </HTML>
6603 ======= h_index_sort_score =======
6604 <HTML>
6605 <HEAD>
6606 <TITLE>SORT OPTION: Score</TITLE>
6607 </HEAD>
6608 <BODY>
6609 <H1>SORT OPTION: Score</H1>
6610
6611 The <EM>Score</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX
6612 by their scores.
6613
6614 <P>
6615 Messages with the same score are sorted in arrival order.
6616 Scores are something you create using the
6617 <A HREF="h_rules_score">&quot;SETUP SCORING&quot;</A> screen.
6618
6619 <P>
6620 &lt;End of help on this topic&gt;
6621 </BODY>
6622 </HTML>
6623 ======= h_index_sort_to =======
6624 <HTML>
6625 <HEAD>
6626 <TITLE>SORT OPTION: To</TITLE>
6627 </HEAD>
6628 <BODY>
6629 <H1>SORT OPTION: To</H1>
6630
6631 The <EM>To</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX
6632 by the names of the recipients of the message.
6633
6634 <P>
6635 Messages with the same recipients are grouped together. Groups of
6636 messages are then put into alphabetical order according to message
6637 recipients.
6638
6639 <P>
6640 &lt;End of help on this topic&gt;
6641 </BODY>
6642 </HTML>
6643 ======= h_index_sort_cc =======
6644 <HTML>
6645 <HEAD>
6646 <TITLE>SORT OPTION: Cc</TITLE>
6647 </HEAD>
6648 <BODY>
6649 <H1>SORT OPTION: Cc</H1>
6650
6651 The <EM>Cc</EM> sort option arranges messages in the MESSAGE&nbsp;INDEX by
6652 the names of the carbon copy addresses of the message.
6653
6654 <P>
6655 &lt;End of help on this topic&gt;
6656 </BODY>
6657 </HTML>
6658 ======= h_index_cmd_whereis =======
6659 <HTML>
6660 <HEAD>
6661 <TITLE>WhereIs Command</TITLE>
6662 </HEAD>
6663 <BODY>
6664 <H1>WhereIs Command</H1>
6665
6666 The WhereIs
6667 (<!--chtml if pinemode="function_key"-->F8<!--chtml else-->W<!--chtml endif-->)
6668 command lets you search the MESSAGE INDEX for a word.
6669 It scans through whatever you see, usually the name of the author
6670 and the Subject line.
6671 WhereIs has special subcommands to let you find the beginning of the
6672 index (Ctrl-Y -- first message)
6673 or the end of the index (Ctrl-V -- last message).
6674 <P>
6675 Note that WhereIs only searches through the visible text on the screen.
6676 For example, if only part of the Subject of a message is shown because it
6677 is long, then only the visible portion of the Subject is searched.
6678 Also note that WhereIs does not &quot;see&quot; the
6679 &quot;X&quot; in column one of Index entries for selected messages
6680 so it can't be used to search for
6681 selected messages (use &quot;Zoom&quot; instead).
6682 <P>
6683 If the feature
6684 <A HREF="h_config_enable_agg_ops">&quot;<!--#echo var="FEAT_enable-aggregate-command-set"-->&quot;</A>
6685 is turned on,
6686 WhereIs can also be used as a quick way to select messages that match the
6687 string being searched for.
6688 Instead of typing carriage return to search for the next match, type
6689 Ctrl-X to select all matches.
6690 Once again, this only selects matches that are (or would be if the right
6691 index line was on the screen) visible.
6692 Truncated From lines or Subjects will cause matches to be missed.
6693 Although WhereIs is sometimes convenient for quick matching, the Select
6694 command is usually more powerful and usually faster.
6695
6696 <P>
6697 &lt;End of help on this topic&gt;
6698 </BODY>
6699 </HTML>
6700 ======= h_view_cmd_whereis =======
6701 <HTML>
6702 <HEAD>
6703 <TITLE>WhereIs Command</TITLE>
6704 </HEAD>
6705 <BODY>
6706 <H1>WhereIs Command</H1>
6707
6708 The WhereIs
6709 (<!--chtml if pinemode="function_key"-->F8<!--chtml else-->W<!--chtml endif-->)
6710 command does a &quot;find in current message&quot; operation.  You
6711 type in text and Alpine will try to find it in the message you are
6712 reading.  WhereIs also has subcommands to jump to the beginning (Ctrl-Y)
6713 or end (Ctrl-V) of the message.
6714 That is, to rapidly move to the end of a message, hit the
6715 <!--chtml if pinemode="function_key"-->F8<!--chtml else-->W<!--chtml endif-->
6716 (or Ctrl-W) key followed
6717 by Ctrl-V.  Similarly,
6718 <!--chtml if pinemode="function_key"-->F8<!--chtml else-->W<!--chtml endif-->
6719 followed by Ctrl-Y will take you to the beginning of a message.
6720
6721 <P>
6722 &lt;End of help on this topic&gt;
6723 </BODY>
6724 </HTML>
6725 ======= h_view_cmd_hilite =======
6726 <HTML>
6727 <HEAD>
6728 <TITLE>View Hilite and Next item/Previous item</TITLE>
6729 </HEAD>
6730 <BODY>
6731 <H1>View Hilite and Next item/Previous item</H1>
6732
6733 Sometimes messages may be in the form of formatted HTML text
6734 or they may contain URLs or Web server hostnames.
6735 When any of the features
6736 <A HREF="h_config_enable_view_url">&quot;<!--#echo var="FEAT_enable-msg-view-urls"-->&quot;</A>,
6737 <A HREF="h_config_enable_view_web_host">&quot;<!--#echo var="FEAT_enable-msg-view-web-hostnames"-->&quot;</A>,
6738 <A HREF="h_config_enable_view_attach">&quot;<!--#echo var="FEAT_enable-msg-view-attachments"-->&quot;</A>,
6739 or
6740 <A HREF="h_config_enable_view_addresses">&quot;<!--#echo var="FEAT_enable-msg-view-addresses"-->&quot;</A>
6741 are enabled, Alpine will represent such selectable items in the text
6742 in bold typeface.  One of the selectable items will be displayed in
6743 inverse video (highlighted).  This is the &quot;currently selected&quot; item.
6744 Press the Return key to view the currently selected item.
6745 <P>
6746
6747 The Up and Down Arrows keys can be used to change the selected item
6748 (also see the feature
6749 <A HREF="h_config_enable_view_arrows">&quot;<!--#echo var="FEAT_enable-msg-view-forced-arrows"-->&quot;</A>).
6750 If there are no selectable items in the direction of the arrow you
6751 pressed, Alpine will scroll the display in that direction until one
6752 becomes visible.  To &quot;jump&quot; forwards/backwards among selectable
6753 items in the message text, use the Previous and Next item commands,
6754 <!--chtml if pinemode="function_key"-->F5 and F6
6755 <!--chtml else-->^B and ^F<!--chtml endif-->.
6756
6757 <P>
6758 &lt;End of help on this topic&gt;
6759 </BODY>
6760 </HTML>
6761 ======= h_view_cmd_viewattch =======
6762 <HTML>
6763 <HEAD>
6764 <TITLE>ViewAttch Command</TITLE>
6765 </HEAD>
6766 <BODY>
6767 <H1>ViewAttch Command</H1>
6768
6769
6770 The View/Save Attachment
6771 (<!--chtml if pinemode="function_key"-->F4<!--chtml else-->V<!--chtml endif-->)
6772 command allows you to handle MIME attachments to a message you have
6773 received.  Alpine shows you a list of the message attachments -- you just
6774 choose the attachment you want.  You may either view or save the
6775 selected attachment.
6776
6777 <P>
6778 Because many attachments require external programs for display, there
6779 is some system configuration that has to happen before you can
6780 actually display attachments.  Hopefully much of that will have been
6781 done already by your system administrator.  MIME configuration is
6782 handled with the &quot;mailcap&quot; configuration file.  (See the section
6783 on configuration in the
6784 <A HREF="h_news">release notes</A> for more information.)
6785
6786 <P>
6787 &lt;End of help on this topic&gt;
6788 </BODY>
6789 </HTML>
6790 ======= h_index_cmd_expunge =======
6791 <HTML>
6792 <HEAD>
6793 <TITLE>Expunge/Exclude Command</TITLE>
6794 </HEAD>
6795 <BODY>
6796 <H1>Expunge/Exclude Command</H1>
6797
6798 Expunge/Exclude
6799 (<!--chtml if pinemode="function_key"-->F3<!--chtml else-->X<!--chtml endif-->)
6800 is the command Alpine uses to actually remove all messages
6801 marked for deletion.  With regular email files, expunge literally deletes
6802 the text from the current folder.  With newsgroups or shared mailboxes,
6803 you don't have permission to actually remove the message, so it is an
6804 exclude -- Alpine removes the message from your view of the folder even
6805 though it is not technically gone.
6806
6807 <P> A selective expunge command is available in IMAP folders that support
6808 the UID EXPUNGE extension in <A
6809 HREF="http://tools.ietf.org/html/rfc4315">RFC 4315</A> as well as for all
6810 other folders (local folders in all formats, POP3 inbox, and newsgroups)
6811 as a subcommand of the apply command. If some selected messages are marked
6812 deleted, then the apply command will offer the eXpunge command, which when
6813 executed will only expunge those messages that are selected and deleted.
6814
6815 <P>
6816 Observe that the expunge command (when not used from the apply command)
6817 will expunge/exclude all deleted messages from the folder, and so all
6818 messages marked deleted will be expunged, regardless of if they are
6819 selected or not. In other words, there is no protection against
6820 potentially expunging more messages than only those that have been
6821 selected and deleted.
6822 <P>
6823
6824 The configuration features
6825 <A HREF="h_config_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm"-->&quot;</A>
6826 and
6827 <A HREF="h_config_full_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm-everywhere"-->&quot;</A>
6828 affect the behavior of the Expunge command.
6829
6830 <P>
6831 &lt;End of help on this topic&gt;
6832 </BODY>
6833 </HTML>
6834 ======= h_common_compose =======
6835 <HTML>
6836 <HEAD>
6837 <TITLE>Compose Command</TITLE>
6838 </HEAD>
6839 <BODY>
6840 <H1>Compose Command</H1>
6841
6842 The Compose command takes you into the Alpine message composer where you
6843 can start a new message for sending.  This is where you type in the
6844 message's text and specify its recipient list (the &quot;To:&quot;
6845 address), where copies should be directed (e.g., &quot;Fcc&quot;,
6846 &quot;Cc:&quot; or &quot;Bcc:&quot;), and which files, if any, should
6847 be attached to the message.
6848
6849 <P>
6850 When you type this command, Alpine will also automatically check for any
6851 interrupted (i.e., a message that was being composed when your modem
6852 or network connection was broken) or previously postponed messages and
6853 offer you a chance to continue working on those.
6854
6855 <P>
6856 <UL>
6857 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
6858 </UL><P>
6859 &lt;End of help on this topic&gt;
6860 </BODY>
6861 </HTML>
6862 ======= h_common_index =======
6863 <HTML>
6864 <HEAD>
6865 <TITLE>Message Index Command</TITLE>
6866 </HEAD>
6867 <BODY>
6868 <H1>Message Index Command</H1>
6869
6870 The Index command takes you to the MESSAGE INDEX screen that displays a
6871 summary caption for each message in the currently-open folder. One
6872 message will be highlighted; this is the &quot;Current&quot; message.
6873 The message commands available from this screen (e.g. View, Reply,
6874 Forward, Delete, Print, Save, etc) apply to the current message.
6875
6876 <P>
6877 &lt;End of help on this topic&gt;
6878 </BODY>
6879 </HTML>
6880 ======= h_common_folders =======
6881 <HTML>
6882 <HEAD>
6883 <TITLE>Folder List Command</TITLE>
6884 </HEAD>
6885 <BODY>
6886 <H1>Folder List Command</H1>
6887
6888 This Folder List command takes you to the FOLDER LIST screen that displays
6889 the names of all your message folders and allows you to view, rename,
6890 delete, and add folders.  You can open (view) a different folder than the
6891 one currently open by highlighting the desired one (using the arrow keys
6892 or their control-key equivalents) and pressing RETURN.
6893
6894 <P>
6895 If you have multiple folder collections defined (see the Help text for
6896 the FOLDER LIST screen to learn more about Collections), you may need
6897 to press Return to expand the collection and display all of the
6898 folders in it.
6899
6900 <P>
6901 &lt;End of help on this topic&gt;
6902 </BODY>
6903 </HTML>
6904 ======= h_main_addrbook =======
6905 <HTML>
6906 <HEAD>
6907 <TITLE>Address Book Command</TITLE>
6908 </HEAD>
6909 <BODY>
6910 <H1>Address Book Command</H1>
6911
6912 This command, available only from the MAIN MENU, takes you
6913 to the ADDRESS BOOK management screen.  From here, your personal address
6914 book(s) may be updated.
6915
6916 <P>
6917 &lt;End of help on this topic&gt;
6918 </BODY>
6919 </HTML>
6920 ======= h_main_setup =======
6921 <HTML>
6922 <HEAD>
6923 <TITLE>Setup Command</TITLE>
6924 </HEAD>
6925 <BODY>
6926 <H1>Setup Command</H1>
6927
6928 The Setup command, available only from the MAIN MENU, prompts you for
6929 one of several configuration screens, including the SETUP CONFIGURATION
6930 screen, by which you may activate optional Alpine features.
6931
6932 <P>
6933 &lt;End of help on this topic&gt;
6934 </BODY>
6935 </HTML>
6936 ======= h_main_release_notes =======
6937 <HTML>
6938 <HEAD>
6939 <TITLE>Release Notes Command</TITLE>
6940 </HEAD>
6941 <BODY>
6942 <H1>Release Notes Command</H1>
6943
6944 This command displays information about Alpine <!--#echo var="ALPINE_VERSION"-->,
6945 as well as pointers to further information such as history and legal notes.
6946
6947 <P>
6948 &lt;End of help on this topic&gt;
6949 </BODY>
6950 </HTML>
6951 ======= h_main_kblock =======
6952 <HTML>
6953 <HEAD>
6954 <TITLE>Keyboard Lock Command</TITLE>
6955 </HEAD>
6956 <BODY>
6957 <H1>Keyboard Lock Command</H1>
6958
6959 This command allows your Alpine session to be protected
6960 during a temporary absence from your terminal.
6961
6962 <P>
6963 &lt;End of help on this topic&gt;
6964 </BODY>
6965 </HTML>
6966 ======= h_main_journal =======
6967 <HTML>
6968 <HEAD>
6969 <TITLE>Journal Command</TITLE>
6970 </HEAD>
6971 <BODY>
6972 <H1>Journal Command</H1>
6973
6974 This command displays a list of all the status messages Alpine has
6975 displayed (on the third line from the bottom of the screen). This may
6976 be useful if a message disappeared before you had a chance to read it.
6977
6978 <P>
6979 &lt;End of help on this topic&gt;
6980 </BODY>
6981 </HTML>
6982 ======= h_common_role =======
6983 <HTML>
6984 <HEAD>
6985 <TITLE>Role Command</TITLE>
6986 </HEAD>
6987 <BODY>
6988 <H1>Role Command</H1>
6989
6990 The Role command is similar to the Compose command except that it starts
6991 off by letting you select a <A HREF="h_rules_roles">role</A>
6992 to be used for the composition.
6993 You may set up alternate roles by using Setup/Rules/Roles.
6994
6995 <P>
6996 &lt;End of help on this topic&gt;
6997 </BODY>
6998 </HTML>
6999 ======= h_common_conditional_cmds =======
7000 <HTML>
7001 <HEAD>
7002 <TITLE>Conditional Commands</TITLE>
7003 </HEAD>
7004 <BODY>
7005 <H1>Conditional Commands</H1>
7006
7007 The presence or absence of certain commands, particularly in the
7008 MESSAGE INDEX and MESSAGE TEXT screens, is determined by
7009 whether or not specific features are set in your Alpine configuration.
7010 (You can access the SETUP CONFIGURATION screen, where they are found, from
7011 Alpine's MAIN MENU.)  To see if a desired command's availability is
7012 conditioned on a feature setting, see the command's help text (highlight
7013 the phrase associated with the command and hit Return).
7014
7015 <P>
7016 Also note that some
7017 commands may be administratively disabled by your system manager;
7018 if they don't work, please check with your local help desk.
7019
7020 <P>
7021 <UL>
7022 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
7023 </UL><P>
7024 &lt;End of help on this topic&gt;
7025 </BODY>
7026 </HTML>
7027 ======= h_common_pipe =======
7028 <HTML>
7029 <HEAD>
7030 <TITLE>Pipe Command</TITLE>
7031 </HEAD>
7032 <BODY>
7033 <H1>Pipe Command</H1>
7034
7035 Pipe
7036 (<!--chtml if pinemode="function_key"-->F12<!--chtml else-->|<!--chtml endif-->)
7037 allows you to send a message to a specified Unix command for external
7038 processing.
7039 This command's availability is controlled by the
7040 <A HREF="h_config_enable_pipe">&quot;<!--#echo var="FEAT_enable-unix-pipe-cmd"-->&quot;</A>
7041 feature.
7042 By default, the processed text of the message is sent to the command
7043 you specify and the output is captured by Alpine and shown to you.
7044 When you run the pipe command, there are some sub-commands which may be
7045 used to alter this behavior.
7046 These sub-commands are described <A HREF="h_pipe_command">here</A>.
7047
7048 <P>
7049 &lt;End of help on this topic&gt;
7050 </BODY>
7051 </HTML>
7052 ======= h_common_goto =======
7053 <HTML>
7054 <HEAD>
7055 <TITLE>Goto Command</TITLE>
7056 </HEAD>
7057 <BODY>
7058 <H1>Goto Command</H1>
7059
7060 Goto
7061 (<!--chtml if pinemode="function_key"-->F6<!--chtml else-->G<!--chtml endif-->)
7062 is the command that lets you bypass Alpine's folder selection screens
7063 and jump directly to a new folder.  You can select any folder in the
7064 world: one in your current collection, one in a different collection or
7065 one in a collection you've never even used before.
7066 <P>
7067
7068 Alpine will help you as much as possible to narrow in on the folder you want.
7069 However, if the folder is outside of your defined collections, you are
7070 going to have to enter the exact folder location using the correct
7071 <A HREF="h_valid_folder_names">syntax</A>
7072 for a remote folder and/or fully-qualified path name.
7073
7074 <P>
7075 &lt;End of help on this topic&gt;
7076 </BODY>
7077 </HTML>
7078 ======= h_common_nextnew =======
7079 <HTML>
7080 <HEAD>
7081 <TITLE>NextNew Command</TITLE>
7082 </HEAD>
7083 <BODY>
7084 <H1>NextNew Command</H1>
7085
7086 When you press the TAB key, Alpine advances to the next
7087 &quot;interesting&quot; message.
7088 This will be the next message you have not seen before, or the next message
7089 you have flagged Important, whichever comes first.
7090 Unread messages that have been deleted are not considered interesting.
7091 (A note about reading news. Alpine expects you to &quot;Delete&quot; news
7092 articles after you have read them if you want to remove them from future
7093 consideration. See <A HREF="h_mainhelp_readingnews">Reading News</A> for
7094 more information.)
7095
7096 <P>
7097 The NextNew command is affected by the feature
7098 <A HREF="h_config_tab_new_only">&quot;<!--#echo var="FEAT_tab-visits-next-new-message-only"-->&quot;</A>,
7099 which causes Alpine to only consider Unread messages interesting, not messages
7100 flagged Important.
7101
7102 <P>
7103 This command behaves a little differently when it finds there are no more
7104 interesting messages left in the current folder.
7105 If the current folder is one of your Incoming Message Folders
7106 (<A HREF="h_config_enable_incoming">&quot;<!--#echo var="FEAT_enable-incoming-folders"-->&quot;</A>)
7107 or it is a newsgroup, then Alpine will try to find the next folder or
7108 newsgroup that contains <EM>Recent</EM> messages and will ask you
7109 if you want to open that folder.
7110 This behavior may be modified by using the
7111 <A HREF="h_config_tab_uses_unseen">&quot;<!--#echo var="FEAT_tab-uses-unseen-for-next-folder"-->&quot;</A>
7112 feature that causes Alpine to look for Unseen messages instead of Recent
7113 messages.
7114 The NextNew command's behavior is also affected by the configuration features
7115 <A HREF="h_config_auto_open_unread">&quot;<!--#echo var="FEAT_auto-open-next-unread"-->&quot;</A>,
7116 and
7117 <A HREF="h_config_tab_no_prompt">&quot;<!--#echo var="FEAT_continue-tab-without-confirm"-->&quot;</A>.
7118
7119 <P>
7120 &lt;End of help on this topic&gt;
7121 </BODY>
7122 </HTML>
7123 ======= h_common_jump =======
7124 <HTML>
7125 <HEAD>
7126 <TITLE>Jump Command</TITLE>
7127 </HEAD>
7128 <BODY>
7129 <H1>Jump Command</H1>
7130
7131 This is Alpine's way of allowing you to go straight to a specific message.
7132 Just press &quot;J&quot; and then enter the message number.  By default, Alpine is also
7133 configured such that typing in any number automatically jumps you to that
7134 message
7135 (<A HREF="h_config_enable_jump">&quot;<!--#echo var="FEAT_enable-jump-shortcut"-->&quot;</A>
7136 in the SETUP CONFIGURATION).
7137
7138 <P>
7139 &lt;End of help on this topic&gt;
7140 </BODY>
7141 </HTML>
7142 ======= h_common_flag =======
7143 <HTML>
7144 <HEAD>
7145 <TITLE>Flag Command</TITLE>
7146 </HEAD>
7147 <BODY>
7148 <H1>Flag Command</H1>
7149
7150 Flag
7151 (<!--chtml if pinemode="function_key"-->F11<!--chtml else-->*<!--chtml endif-->)
7152 is the command that allows users to manipulate the status flags that
7153 appear on the left side of the MESSAGE INDEX screen.  The most common
7154 use of this is to mark a message as important. This is something of a
7155 note to yourself to get back to that message.  You may also use the
7156 flag command to set (or unset) the flags that indicate that a message
7157 is new, answered, deleted, or forwarded.<P>
7158
7159 Provided the mail server supports it,
7160 you may also manipulate user-defined keywords
7161 for a message using the flag command.
7162 These keywords will be available if you use the Flag Details screen that you
7163 can get to after typing the
7164 Flag (<!--chtml if pinemode="function_key"-->F11<!--chtml else-->*<!--chtml endif-->)
7165 command.
7166 They will be listed after the Important, New, Answered, Deleted , and Forwarded flags,
7167 which are always present.
7168 You may add new keywords by using the Add KW command from the Flag Details screen
7169 or by defining them in the <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in the Setup/Config screen.
7170
7171 The availability of the flag command is determined by the
7172 <A HREF="h_config_enable_flag">&quot;<!--#echo var="FEAT_enable-flag-cmd"-->&quot;</A>
7173 feature in your Alpine configuration. Also, it is possible that Flag could be
7174 administratively disabled by your system manager; if it doesn't work,
7175 please check with your local help desk before reporting a bug.
7176 The behavior of the flag command may be modified by the
7177 <A HREF="h_config_flag_screen_default">&quot;<!--#echo var="FEAT_enable-flag-screen-implicitly"-->&quot;</A> option or the
7178 <A HREF="h_config_flag_screen_kw_shortcut">&quot;<!--#echo var="FEAT_enable-flag-screen-keyword-shortcut"-->&quot;</A> option.
7179
7180 <P>
7181 &lt;End of help on this topic&gt;
7182 </BODY>
7183 </HTML>
7184 ======= h_common_hdrmode =======
7185 <HTML>
7186 <HEAD>
7187 <TITLE>HdrMode Command</TITLE>
7188 </HEAD>
7189 <BODY>
7190 <H1>HdrMode Command</H1>
7191
7192 Every email message comes with some header lines that you normally
7193 don't see (and don't want to see).
7194 These include anywhere from 3-20 lines (or more) added by the
7195 Internet mail transport system to record the route your message took,
7196 for diagnostic purposes.
7197 These are normally of no import and simply
7198 add clutter, so Alpine suppresses them in the MESSAGE TEXT display.
7199 This also includes other non-standard headers the message may contain.
7200 If you want to see these headers, there is a way to reveal them.
7201 <P>
7202
7203 The Header Mode
7204 (<!--chtml if pinemode="function_key"-->F9<!--chtml else-->H<!--chtml endif-->)
7205 command is a toggle that controls Alpine's handling of these header
7206 lines.  Normally, full headers is &quot;off&quot; and you only see a
7207 few lines about who a message is to and who it is from.  When you
7208 press
7209 (<!--chtml if pinemode="function_key"-->F9<!--chtml else-->H<!--chtml endif-->)
7210 to turn full headers on, Alpine will show you
7211 the normal header lines as well as delivery headers, comment headers,
7212 MIME headers, and any other headers present.
7213 <P>
7214
7215 Several different Alpine commands honor the header mode -- it affects how
7216 messages are displayed, how they appear in forward and reply email, how
7217 they are printed, how they are saved, and how they are exported.
7218 <!--chtml if pinemode="os_windows"-->
7219 <!--chtml else-->
7220 The pipe command is also affected.
7221 <!--chtml endif-->
7222 <P>
7223
7224 The presence or absence of the Header Mode command is determined by the
7225 <A HREF="h_config_enable_full_hdr">&quot;<!--#echo var="FEAT_enable-full-header-cmd"-->&quot;</A>
7226 Feature-List option in your Alpine configuration.
7227
7228 <P>
7229 If you have also turned on the
7230 <A HREF="h_config_quote_suppression">&quot;Quote Suppression&quot;</A>
7231 option then the HdrMode command actually rotates through three states
7232 instead of just two.
7233 The first is the normal view with long quotes suppressed.
7234 The second is the normal view but with the long quotes included.
7235 The last enables the display of all headers in the message.
7236 When using Export, Pipe, Print, Forward, or Reply the quotes are
7237 never suppressed, so the first two states are identical.
7238
7239 <P>
7240 The behavior of the Header Mode command may be altered slightly by
7241 turning on the
7242 <A HREF="h_config_quell_full_hdr_reset">&quot;<!--#echo var="FEAT_quell-full-header-auto-reset"-->&quot;</A>
7243 Feature-List option in your Alpine configuration.
7244 In particular, it will cause the Header Mode to be persistent when moving
7245 from message to message instead of resetting to the default for each message.
7246
7247 <P>
7248 <UL>
7249 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
7250 </UL><P>
7251 &lt;End of help on this topic&gt;
7252 </BODY>
7253 </HTML>
7254 ======= h_common_print =======
7255 <HTML>
7256 <HEAD>
7257 <TITLE>Print Command</TITLE>
7258 </HEAD>
7259 <BODY>
7260 <H1>Print Command</H1>
7261
7262 The Print
7263 (<!--chtml if pinemode="function_key"-->F9<!--chtml else-->%<!--chtml endif-->)
7264 command allows you to print a copy of a message.
7265 There are many SETUP CONFIGURATION features that affect the
7266 Print command, including
7267 <A HREF="h_config_enable_y_print">&quot;<!--#echo var="FEAT_enable-print-via-y-command"-->&quot;</A>,
7268 <A HREF="h_config_print_index">&quot;<!--#echo var="FEAT_print-index-enabled"-->&quot;</A>,
7269 <A HREF="h_config_custom_print">&quot;<!--#echo var="FEAT_print-offers-custom-cmd-prompt"-->&quot;</A>,
7270 <A HREF="h_config_print_from">&quot;<!--#echo var="FEAT_print-includes-from-line"-->&quot;</A>, and
7271 <A HREF="h_config_ff_between_msgs">&quot;<!--#echo var="FEAT_print-formfeed-between-messages"-->&quot;</A>.
7272 You set up for printing by using the Printer option of the Setup command
7273 on the MAIN MENU.
7274 <P>
7275
7276 <P>
7277 &lt;End of help on this topic&gt;
7278 </BODY>
7279 </HTML>
7280 ======= h_common_take =======
7281 <HTML>
7282 <HEAD>
7283 <TITLE>TakeAddr Command</TITLE>
7284 </HEAD>
7285 <BODY>
7286 <H1>TakeAddr Command</H1>
7287
7288
7289 With the Take Address
7290 (<!--chtml if pinemode="function_key"-->F10<!--chtml else-->T<!--chtml endif-->)
7291 command, you can extract email addresses from an
7292 incoming message and save them in an address book.  This is an easy way
7293 to add to your address book and avoid having to remember the email
7294 addresses of the people who write to you.
7295 <P>
7296
7297 If the message is just to you individually, then you will only need to
7298 provide a nickname.  If the message contains more than one email address,
7299 then you will see an address
7300 selection screen that lets you choose the address you want to save into
7301 your address book, or lets you choose several of them add to a
7302 personal distribution list.
7303 <P>
7304
7305 Once you've added an entry to your address book, you can use it from the
7306 message composer by typing the nickname of the entry into one of the
7307 header fields (for example, into the To: field), or you can use ^T from
7308 the header field to select the entry from your address book.
7309 <P>
7310
7311 If the configuration feature
7312 <A HREF="h_config_enable_role_take">&quot;<!--#echo var="FEAT_enable-rules-under-take"-->&quot;</A>
7313 is set, the behavior of the Take command is altered slightly.
7314
7315 <P>
7316 &lt;End of help on this topic&gt;
7317 </BODY>
7318 </HTML>
7319 ======= h_ge_import =======
7320 <HTML>
7321 <HEAD>
7322 <TITLE>Import File Selection</TITLE>
7323 </HEAD>
7324 <BODY>
7325 <H1>Import File Selection</H1>
7326
7327 You are importing a file that you previously
7328 exported from Alpine.
7329 You are now being asked for the name of that file.
7330 The easiest way to select a file is probably with the &quot;^T&quot;
7331 &quot;To Files&quot; command.
7332 Alternatively, you may type in a file name.
7333 It may be an absolute pathname.
7334 Otherwise, it is a file located in your home directory
7335 or current working directory
7336 <!--chtml if pinemode="running"-->
7337 (which, at least for your current Alpine &quot;session,&quot;
7338 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
7339 <!--chtml endif-->, depending on the
7340 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A> option.
7341 In any case, you finish by typing a carriage return to accept the
7342 file name that is displayed.
7343 When the feature
7344 <A HREF="h_config_enable_tab_complete">&quot;<!--#echo var="FEAT_enable-tab-completion"-->&quot;</A>
7345 is turned on you may use TAB to complete partially typed in names.
7346 <P>
7347 You may cancel the import operation by typing &quot;^C&quot; after exiting
7348 this help.
7349 <P>
7350 &lt;End of help on this topic&gt;
7351 </BODY>
7352 </HTML>
7353 ======= h_ge_allparts =======
7354 <HTML>
7355 <HEAD>
7356 <TITLE>Export Message File Selection</TITLE>
7357 </HEAD>
7358 <BODY>
7359 <H1>Export Message File Selection</H1>
7360
7361 You are Exporting a message from an Alpine mail folder
7362 to a plain text file.
7363 You also have the option of exporting all of the attachments associated
7364 with the message.
7365 You are now being asked for the name of the file to export <EM>to</EM>.
7366 The easiest way to select a file is probably with the &quot;^T&quot;
7367 &quot;To Files&quot; subcommand.
7368 After returning from that subcommand you will still be allowed to
7369 edit the name you have selected.
7370 Alternatively, you may type in a file name.
7371 It may be an absolute pathname.
7372 Otherwise, it is a file located in your home directory
7373 or current working directory
7374 <!--chtml if pinemode="running"-->
7375 (which, at least for your current Alpine &quot;session,&quot;
7376 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
7377 <!--chtml endif-->, depending on the
7378 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A> option.
7379 In any case, you finish by typing a carriage return to accept the
7380 file name that is displayed.
7381 When the feature
7382 <A HREF="h_config_enable_tab_complete">&quot;<!--#echo var="FEAT_enable-tab-completion"-->&quot;</A>
7383 is turned on you may use TAB to complete partially typed in names.
7384 <P>
7385 The message you are exporting appears to have some attachments.
7386 If you wish to save <EM>all</EM> of the attachments at once,
7387 type the &quot;^P&quot; &quot;AllParts&quot; command to turn on
7388 saving of the attachments.
7389 You may turn it back off by typing &quot;^P&quot; again, which will now
7390 be labeled &quot;NoAllParts&quot; instead.
7391 If you want to save the parts the command displayed should be
7392 &quot;NoAllParts&quot;!
7393 When you choose to save attachments like this, the attachments will be saved
7394 in a newly created directory.
7395 That directory will have the same name as the file name you choose here,
7396 with the letters &quot;.d&quot; appended.
7397 If that directory already exists, then the letters &quot;.d_1&quot; will
7398 be tried, then &quot;.d_2&quot; and so on until a name that doesn't exist
7399 is found.
7400 For example, if you select the file name
7401 <P>
7402 <CENTER><SAMP>filename</SAMP></CENTER>
7403 <P>
7404 to export the message to, then the directory used for the attachments will be
7405 <P>
7406 <CENTER><SAMP>filename.d</SAMP></CENTER>
7407 <P>
7408 or perhaps
7409 <P>
7410 <CENTER><SAMP>filename.d_&lt;n&gt;</SAMP></CENTER>
7411 <P>
7412 The attachments will then be put into files inside that directory.
7413 The names for the attachment files will be derived from the attachments
7414 if possible.
7415 This is done in the same way as the default values are derived if you
7416 save them one at a time.
7417 (The &quot;filename&quot; parameter from the Content-Disposition header
7418 is the first choice. If that doesn't exist, the &quot;name&quot;
7419 parameter from the Content-Type header is used.)
7420 If a name for a particular attachment is not available, then the
7421 part number of the attachment is used, with the characters &quot;part_&quot;
7422 prepended.
7423 An example of that would be
7424 <P>
7425 <CENTER><SAMP>part_2.1</SAMP></CENTER>
7426 <P>
7427 If you want to save only some of the attachments or if you want more control
7428 over the directory and filename where an attachment is saved you may
7429 cancel out of this command and View the attachment list.
7430 From there you can save each attachment individually.
7431 <P>
7432 You may cancel the Export operation by typing &quot;^C&quot; after exiting
7433 this help.
7434 <P>
7435 &lt;End of help on this topic&gt;
7436 </BODY>
7437 </HTML>
7438 ======= h_ge_export =======
7439 <HTML>
7440 <HEAD>
7441 <TITLE>Export File Selection</TITLE>
7442 </HEAD>
7443 <BODY>
7444 <H1>Export File Selection</H1>
7445
7446 You are Exporting or Saving something from within the Alpine world
7447 (a message, an attachment, etc.)
7448 to a plain text file.
7449 You are now being asked for the name of the file to export <EM>to</EM>.
7450 The easiest way to select a file is probably with the &quot;^T&quot;
7451 &quot;To Files&quot; subcommand.
7452 After returning from that subcommand you will still be allowed to
7453 edit the name you have selected.
7454 Alternatively, you may type in a file name.
7455 It may be an absolute pathname.
7456 Otherwise, it is a file located in your home directory
7457 or current working directory
7458 <!--chtml if pinemode="running"-->
7459 (which, at least for your current Alpine &quot;session,&quot;
7460 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
7461 <!--chtml endif-->, depending on the
7462 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A> option.
7463 In any case, you finish by typing a carriage return to accept the
7464 file name that is displayed.
7465 When the feature
7466 <A HREF="h_config_enable_tab_complete">&quot;<!--#echo var="FEAT_enable-tab-completion"-->&quot;</A>
7467 is turned on you may use TAB to complete partially typed in names.
7468 <P>
7469 If the object you are exporting is a message with some attachments,
7470 you may wish to save all of the attachments by typing the &quot;^P&quot;
7471 &quot;AllParts&quot; command to turn on saving of the attachments.
7472 This subcommand will only be visible if the message actually has attachments.
7473 You may also View the attachment list and save individual attachments from
7474 there.
7475 <P>
7476 If you are SAVING a text part (text/plain, text/html, etc.) you can use
7477 the Control-R subcommand to toggle if saving will be done in binary mode,
7478 meaning that the attachment will be decoded, but will not be transformed
7479 to UTF-8 for further processing (either in internal filters, or user
7480 supplied filters.) This is useful in case you either want to preserve
7481 the text as it was encoded originally to you, or the attachment was
7482 incorrectly attached (the attachment is not of text type) and you need
7483 the original text to process the attachment.
7484 <P>
7485 You may cancel the Export operation by typing &quot;^C&quot; after exiting
7486 this help.
7487 <P>
7488 &lt;End of help on this topic&gt;
7489 </BODY>
7490 </HTML>
7491 ======= h_common_save =======
7492 <HTML>
7493 <HEAD>
7494 <TITLE>Save and Export Commands</TITLE>
7495 </HEAD>
7496 <BODY>
7497 <H1>Save and Export Commands</H1>
7498
7499 Save
7500 (<!--chtml if pinemode="function_key"-->F11<!--chtml else-->S<!--chtml endif-->)
7501 and Export
7502 (<!--chtml if pinemode="function_key"-->F12<!--chtml else-->E<!--chtml endif-->)
7503 are the two alternatives Alpine gives you to keep a copy of the message
7504 you are reading. If you want to keep the message within Alpine's email
7505 world, use &quot;Save&quot;; if you want to use the message in another
7506 program, use &quot;Export&quot;.
7507 <P>
7508
7509 When you Save a message, it is put into an existing folder or into a new
7510 folder in one of your existing folder collections.  The message stays in
7511 email format and can be read by Alpine again.  Alpine may use a special format
7512 for its mail folders -- never edit an Alpine folder by hand or with any
7513 program other than Alpine.  The exact behavior of the Save command can be
7514 configured with the
7515 <A HREF="h_config_quote_all_froms">&quot;<!--#echo var="FEAT_save-will-quote-leading-froms"-->&quot;</A>,
7516 <A HREF="h_config_save_wont_delete">&quot;<!--#echo var="FEAT_save-will-not-delete"-->&quot;</A>,
7517 and
7518 <A HREF="h_config_save_advances">&quot;<!--#echo var="FEAT_save-will-advance"-->&quot;</A>
7519 feature list settings.
7520 The name of the folder offered as a default is controlled by the option
7521 <A HREF="h_config_saved_msg_name_rule">&quot;<!--#echo var="VAR_saved-msg-name-rule"-->&quot;</A>.
7522 <P>
7523
7524 When you use Export, the message is placed in a plain text file in your
7525 home directory
7526 <!--chtml if pinemode="running"-->
7527 (which, in the present configuration of your system, is
7528  &quot;<!--#echo var="HOME_DIR"-->&quot;)
7529 <!--chtml endif-->
7530 or current working directory
7531 <!--chtml if pinemode="running"-->
7532 (which, at least for your current Alpine &quot;session,&quot;
7533 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
7534 <!--chtml endif-->, depending on the
7535 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
7536 configuration setting.  In the normal case, only minimal
7537 headers are exported with the message; however, if the full header mode
7538 (whose availability may be disabled  by setting the feature
7539 <A HREF="h_config_enable_full_hdr">&quot;<!--#echo var="FEAT_enable-full-header-cmd"-->&quot;</A>
7540 in SETUP CONFIGURATION) is
7541 toggled on, then complete headers are exported along with the message
7542 text. (If you have any <A HREF="h_config_display_filters"><!--#echo var="VAR_display-filters"--></A>
7543 defined, they may affect the contents of the exported file.)
7544
7545 <P>
7546 &lt;End of help on this topic&gt;
7547 </BODY>
7548 </HTML>
7549 ======= h_common_bounce =======
7550 <HTML>
7551 <HEAD>
7552 <TITLE>Bounce Command</TITLE>
7553 </HEAD>
7554 <BODY>
7555 <H1>Bounce Command</H1>
7556
7557 The Bounce
7558 (<!--chtml if pinemode="function_key"-->F10<!--chtml else-->B<!--chtml endif-->)
7559 command allows you to re-send, or &quot;remail&quot;, a
7560 message, as if you were never in the loop.  It is analogous to crossing
7561 out your address on a postal letter, writing a different address on the
7562 envelope, and putting it into the mailbox. Bounce is used primarily to
7563 redirect email that was sent to you in error.
7564 Also, some owners of email
7565 lists need the bounce command to handle list traffic.
7566 Bounce is not anonymous.
7567 A ReSent-From header is added to the message so that the recipient may
7568 tell that you Bounced it to them.
7569 <P>
7570
7571 The presence or absence of the Bounce command is determined by the
7572 <A HREF="h_config_enable_bounce">&quot;<!--#echo var="FEAT_enable-bounce-cmd"-->&quot;</A>
7573 feature in your Alpine configuration.
7574 The feature
7575 <A HREF="h_config_fcc_on_bounce">&quot;<!--#echo var="FEAT_fcc-on-bounce"-->&quot;</A>
7576 affects the behavior of the Bounce command.
7577 Also, it is possible that Bounce could be
7578 administratively disabled by your system manager; if it doesn't work,
7579 please check with your local help desk before reporting a bug.
7580
7581 <P>
7582 &lt;End of help on this topic&gt;
7583 </BODY>
7584 </HTML>
7585 ======= h_common_reply =======
7586 <HTML>
7587 <HEAD>
7588 <TITLE>Reply and Forward Commands</TITLE>
7589 </HEAD>
7590 <BODY>
7591
7592 <H1>Reply and Forward Commands</H1>
7593
7594 Replying
7595 (<!--chtml if pinemode="function_key"-->F11<!--chtml else-->R<!--chtml endif-->)
7596 and Forwarding
7597 (<!--chtml if pinemode="function_key"-->F12<!--chtml else-->F<!--chtml endif-->)
7598 are your two alternatives for following up on the
7599 message you are reading.  You would use reply if you want to get email
7600 back to the author of the message and/or the other people who have
7601 already seen it.  You use forward if you want somebody new to see the
7602 message.
7603 <P>
7604
7605 In the normal case, the only thing that you must supply when forwarding a
7606 message is the name/email address of the new recipient.
7607 Alpine will include the text of the forwarded message.
7608 Alpine will also include any attachments to the message.
7609 There is space above the forwarded text for you to include additional comments.
7610 <P>
7611
7612 When replying, you usually have to answer some questions.
7613 If the message is to multiple people and/or specified with a Reply-To: header,
7614 then you will have to decide who should get the reply.
7615 You also need to decide whether or not to include the previous
7616 message in your reply.
7617 Some of this is configurable.
7618 Specifically, see the
7619 <A HREF="h_config_include_header">&quot;<!--#echo var="FEAT_include-header-in-reply"-->&quot;</A>,
7620 <A HREF="h_config_auto_include_reply">&quot;<!--#echo var="FEAT_include-text-in-reply"-->&quot;</A>,
7621 <A HREF="h_config_attach_in_reply">&quot;<!--#echo var="FEAT_include-attachments-in-reply"-->&quot;</A>,
7622 and
7623 <A HREF="h_config_auto_reply_to">&quot;<!--#echo var="FEAT_reply-always-uses-reply-to"-->&quot;</A>
7624 configuration features.
7625 <P>
7626
7627 Both the Reply and Forward commands react to the full header mode toggle.
7628 If the full header mode is on, then all the header and delivery lines are
7629 included with the text of the message in your reply/forward.
7630 <P>
7631
7632 Other configuration features that affect the Reply command are
7633 <A HREF="h_config_sig_at_bottom">&quot;<!--#echo var="FEAT_signature-at-bottom"-->&quot;</A>,
7634 <A HREF="h_config_sigdashes">&quot;<!--#echo var="FEAT_enable-sigdashes"-->&quot;</A>, and
7635 <A HREF="h_config_strip_sigdashes">&quot;<!--#echo var="FEAT_strip-from-sigdashes-on-reply"-->&quot;</A>.
7636
7637 <P>
7638 &lt;End of help on this topic&gt;
7639 </BODY>
7640 </HTML>
7641 ======= h_common_delete =======
7642 <HTML>
7643 <HEAD>
7644 <TITLE>Delete and Undelete Commands</TITLE>
7645 </HEAD>
7646 <BODY>
7647 <H1>Delete and Undelete Commands</H1>
7648
7649 Delete
7650 (<!--chtml if pinemode="function_key"-->F9<!--chtml else-->D<!--chtml endif-->)
7651 and Undelete
7652 (<!--chtml if pinemode="function_key"-->F10<!--chtml else-->U<!--chtml endif-->)
7653 allow you to change the Deleted flag for the current message.
7654 Delete marks a message Deleted (turns on the Deleted flag) and Undelete
7655 removes the mark.
7656 In the MESSAGE INDEX, deleted messages have a &quot;D&quot; in the status field
7657 at the left hand edge of the index line.
7658 When viewing a deleted message, the letters &quot;DEL&quot; will be present
7659 in the upper right hand corner of the screen.
7660 Delete simply <EM>marks</EM> a message Deleted, it does not actually
7661 get rid of the message.
7662 The eXpunge command (available from the MESSAGE INDEX screen) actually
7663 removes all of the deleted messages in a folder.
7664 Once a message is eXpunged, it can't be retrieved.
7665 <P>
7666
7667 The Delete command is affected by the setting of the configuration feature
7668 <A HREF="h_config_del_skips_del">&quot;<!--#echo var="FEAT_delete-skips-deleted"-->&quot;</A>.
7669
7670 <P>
7671 &lt;End of help on this topic&gt;
7672 </BODY>
7673 </HTML>
7674 ======= h_common_postpone =======
7675 <HTML>
7676 <HEAD>
7677 <TITLE>Postpone Command</TITLE>
7678 </HEAD>
7679 <BODY>
7680 <H1>Postpone Command</H1>
7681
7682 The postpone
7683 <!--chtml if pinemode="function_key"-->(F11)<!--chtml else-->(^O)<!--chtml endif-->
7684 command allows you to temporarily stop working on the current
7685 message so you may read
7686 other messages or compose another message.  When you want to resume a
7687 message later, start to compose and answer &quot;yes&quot; to the
7688 &quot;Continue postponed composition?&quot; question.  You may
7689 postpone as many messages as you like.
7690
7691 <P>
7692 Note: If a <A HREF="h_config_form_folder"><!--#echo var="VAR_form-letter-folder"--></A> is defined
7693 in the Setup/Config screen, then the Postpone command will prompt you for
7694 the folder in which to store your outgoing message.
7695
7696 <P>
7697 &lt;End of help on this topic&gt;
7698 </BODY>
7699 </HTML>
7700 ======= h_compose_cancel =======
7701 <HTML>
7702 <HEAD>
7703 <TITLE>Cancel Command</TITLE>
7704 </HEAD>
7705 <BODY>
7706 <H1>Cancel Command</H1>
7707
7708 Cancel
7709 <!--chtml if pinemode="function_key"-->
7710 (F2)
7711 <!--chtml else-->
7712 (^C)
7713 <!--chtml endif-->
7714
7715 The Cancel command returns you to Alpine's normal mail processing and
7716 causes the message currently under composition to be thrown out.
7717 The message text <EM>will be lost</EM>.
7718
7719 <P>
7720 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
7721 will be preserved in the file named
7722 <!--chtml if pinemode="os_windows"-->
7723 &quot;DEADLETR&quot;.
7724 <!--chtml else-->
7725 &quot;dead.letter&quot; in your home directory.
7726 <!--chtml endif-->
7727 If you unintentionally cancel a message, look there for its text.
7728
7729 <P>
7730 &lt;End of help on this topic&gt;
7731 </BODY>
7732 </HTML>
7733 ======= h_compose_addrcomplete =======
7734 <HTML>
7735 <HEAD>
7736 <TITLE>Address Completion</TITLE>
7737 </HEAD>
7738 <BODY>
7739 <H1>Address Completion</H1>
7740
7741 When entering addresses in the address fields of the composer (To, Cc, etc.)
7742 the TAB key may be used to help complete the address.
7743 Type a partial nickname and tap the TAB key to complete the typing.
7744 The unambiguous part of the name will be filled in automatically.
7745 Typing TAB twice in succession will bring up a selection list of possibilities,
7746 making it easy to find and choose the correct address.
7747
7748 <P>
7749 The matching algorithm is rather ad hoc.
7750 The search starts with a search of your address book.
7751 It counts as a match if the nickname, address, or fullname field of an
7752 entry begins with the text typed in so far. It is also a match if
7753 a later word in the fullname (for example, the middle name or last name)
7754 begins with the entered text.
7755 <P>
7756 Next comes an LDAP search.
7757 The search will happen for any servers that have the
7758 <A HREF="h_config_ldap_opts_impl">&quot;Use-Implicitly-From-Composer&quot;</A>
7759 feature set. You can set or unset the feature for each server independently
7760 in the Setup/Directory screen.
7761 <P>
7762 Finally, if you are replying to or forwarding a message, that message is
7763 searched for likely candidate addresses that match the typed-in text.
7764
7765 <P>
7766 &lt;End of help on this topic&gt;
7767 </BODY>
7768 </HTML>
7769 ======= h_compose_richhdr =======
7770 <HTML>
7771 <HEAD>
7772 <TITLE>Rich Header Command</TITLE>
7773 </HEAD>
7774 <BODY>
7775 <H1>Rich Header Command</H1>
7776
7777 The Rich Header command allows you to toggle between the list of
7778 all message headers available for editing and those that are most
7779 common.
7780
7781 <P>
7782 Use this toggle to expose headers that are not normally visible by
7783 default.
7784 This set usually includes the
7785 &quot;Bcc:&quot;,
7786 &quot;Fcc:&quot;,
7787 &quot;Lcc:&quot;,
7788 and &quot;Newsgroups&quot;
7789 headers.
7790 If you are posting to a newsgroup the set of defaults is a little different.
7791 Obviously, in that case, the Newsgroups header is of interest so is not
7792 hidden.
7793 For news posting the hidden set includes the
7794 &quot;To:&quot;,
7795 &quot;Cc:&quot;,
7796 &quot;Bcc:&quot;,
7797 &quot;Fcc:&quot;,
7798 and &quot;Lcc:&quot;
7799 headers.
7800 You won't normally want to edit these, which is why they are hidden,
7801 but it is sometimes useful to be able to set them manually.
7802
7803 <P>
7804 The default sets of headers listed above can be altered.
7805 Any header that you have added to the
7806 <A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A>
7807 option, but not to the
7808 <A HREF="h_config_comp_hdrs"><!--#echo var="VAR_default-composer-hdrs"--></A>
7809 option will appear when you use the Rich Headers command to
7810 make the Rich Headers visible.
7811 (Headers listed in the <!--#echo var="VAR_default-composer-hdrs"--> list will be visible
7812 even without toggling the Rich Headers command.)
7813
7814 <P>
7815 &lt;End of help on this topic&gt;
7816 </BODY>
7817 </HTML>
7818 ======= h_compose_send =======
7819 <HTML>
7820 <HEAD>
7821 <TITLE>Send Command</TITLE>
7822 </HEAD>
7823 <BODY>
7824 <H1>Send Command</H1>
7825
7826 The Send command
7827 <!--chtml if pinemode="function_key"-->
7828 (F3)
7829 <!--chtml else-->
7830 (^X)
7831 <!--chtml endif-->
7832 tells Alpine you are finished composing.
7833 Before actually sending it, though, Alpine will ask you to confirm
7834 your intention, and, at the same time, redisplayed the message text
7835 with the recipients at the top of the screen to give you the opportunity
7836 to review and verify that the message is addressed to the people
7837 you intended.
7838 <P>
7839 If the feature
7840 <A HREF="h_config_send_wo_confirm">&quot;<!--#echo var="FEAT_send-without-confirm"-->&quot;</A> is set,
7841 then this confirmation prompt and any options it allows are skipped.
7842
7843 <P>
7844 This confirmation prompt may also offer, depending
7845 on your particular Setup/Config, options allowing you to set
7846 <A HREF="h_config_compose_dsn">delivery status notifications</A>,
7847 include attachments in the &quot;Fcc&quot; (if you had previously
7848 specified that they <A HREF="h_config_no_fcc_attach">exclude attachments</A>,
7849 observe details of the
7850 <A HREF="h_config_verbose_post">message submission process</A>,
7851 choose the filter through which the
7852 <A HREF="h_config_sending_filter">outgoing text should first pass</A>,
7853 or turn of flowed text generation.
7854
7855 <P>
7856 &lt;End of help on this topic&gt;
7857 </BODY>
7858 </HTML>
7859 ======= h_compose_markcutpaste =======
7860 <HTML>
7861 <HEAD>
7862 <TITLE>Mark, Cut and Paste Commands</TITLE>
7863 </HEAD>
7864 <BODY>
7865 <H1>Mark, Cut and Paste Commands</H1>
7866
7867 You can define a &quot;block&quot; of text, which can subsequently
7868  be deleted or
7869 copied as a unit, by setting a mark at the start of the block (Ctrl-^) and
7870 then moving the cursor to the end of the desired text block.  You can then
7871 &quot;cut&quot; the block out
7872 <!--chtml if pinemode="function_key"-->
7873 &quot;F9&quot;,
7874 <!--chtml else-->
7875 &quot;Ctrl-K&quot;,
7876 <!--chtml endif-->
7877 move the cursor, and &quot;paste&quot; it
7878 <!--chtml if pinemode="function_key"-->
7879 &quot;F10&quot;,
7880 <!--chtml else-->
7881 &quot;Ctrl-U&quot;,
7882 <!--chtml endif-->
7883 in the new location.  Also, you can paste more than once, allowing you
7884 to use this feature to copy a block of text.<P>
7885
7886 If you press
7887 <!--chtml if pinemode="function_key"-->
7888 &quot;F9&quot;
7889 <!--chtml else-->
7890 &quot;^K&quot;
7891 <!--chtml endif-->
7892 without having marked anything, Alpine will delete
7893 a single line.  If you delete a group of lines together, Alpine keeps them
7894 in the same buffer, so
7895 <!--chtml if pinemode="function_key"-->
7896 F10
7897 <!--chtml else-->
7898 ^U
7899 <!--chtml endif-->
7900 will restore them as a block.  About
7901 terminology:  Mark is shown as &quot;^^&quot;.  The first &quot;^&quot; means you should
7902 hold down the &quot;Control&quot; key on your keyboard.  The second &quot;^&quot; means
7903 &quot;type the character ^&quot;.
7904
7905 <P>
7906 &lt;End of help on this topic&gt;
7907 </BODY>
7908 </HTML>
7909 ======= h_compose_justify =======
7910 <HTML>
7911 <HEAD>
7912 <TITLE>Justify Command</TITLE>
7913 </HEAD>
7914 <BODY>
7915 <H1>Justify Command</H1>
7916
7917 The Justify
7918 <!--chtml if pinemode="function_key"-->
7919 (F4)
7920 <!--chtml else-->
7921 (^J)
7922 <!--chtml endif-->
7923 command reformats the text in the paragraph the cursor is in.
7924 Paragraphs are separated by one blank line or a line beginning with a space.
7925 This is useful when you have been editing a paragraph and the lines become
7926 uneven.  The text is left aligned or justified and the right is ragged.  If
7927 the text is already justified as typed with auto-wrap, no justification will
7928 be done.
7929
7930 <P>
7931 If you have set a <A HREF="h_compose_markcutpaste">mark</A> to select a
7932 block of text, the Justify command is modified.
7933 Instead of automatically justifying the current paragraph you will be
7934 asked if you want to justify the paragraph, justify the selected region,
7935 or adjust the quote level of the selected region.
7936 Adjusting the quote level only works if you are using standard
7937 &quot;&gt;&nbsp;&quot; or &quot;&gt;&quot; quotes, which is the default if you haven't
7938 changed &quot;<A HREF="h_config_reply_indent_string"><!--#echo var="VAR_reply-indent-string"--></A>&quot;.
7939
7940 <P>
7941 When composing a reply containing included text, the justify command
7942 will reformat text to the right of the
7943 &quot;<A HREF="h_config_reply_indent_string"><!--#echo var="VAR_reply-indent-string"--></A>&quot;,
7944 adding or removing indented lines as needed.  Paragraphs are separated
7945 by a blank line, a line containing only the <!--#echo var="VAR_reply-indent-string"-->, or a
7946 line containing the indent string and one or more blank spaces.
7947 Included text that was previously indented (or &quot;quoted&quot;) is
7948 not preserved.
7949
7950 <P>
7951 Because of the introduction of <A HREF="h_config_quell_flowed_text">Flowed Text</A>
7952 in 1999 and its wide-spread adoption since then, you will usually be better off if you
7953 use the standard
7954 &quot;&gt;&nbsp;&quot; or &quot;&gt;&quot; quotes.
7955
7956 <P>
7957 &lt;End of help on this topic&gt;
7958 </BODY>
7959 </HTML>
7960 ======= h_compose_spell =======
7961 <HTML>
7962 <HEAD>
7963 <TITLE>Spell Check Command</TITLE>
7964 </HEAD>
7965 <BODY>
7966 <H1>Spell Check Command</H1>
7967
7968 The &quot;To Spell&quot;
7969 <!--chtml if pinemode="function_key"-->
7970 (F12)
7971 <!--chtml else-->
7972 (^T)
7973 <!--chtml endif-->
7974 command calls an external spell checking program to look over the
7975 message you are composing.  By default, Alpine uses
7976 <P>
7977 <CENTER><SAMP>aspell --dont-backup --mode=email check</SAMP></CENTER>
7978 <P>
7979 if it knows where to find &quot;aspell&quot;.
7980 If there is no &quot;aspell&quot; command available but the command &quot;ispell&quot; is available
7981 then the command used is
7982 <P>
7983 <CENTER><SAMP>ispell -l</SAMP></CENTER>
7984 <P>
7985 Otherwise, the ancient &quot;spell&quot; command is used.
7986 <P>
7987 For PC-Alpine, you must install the aspell library code that you
7988 may get from
7989 <A HREF="http://aspell.net/win32/">http://aspell.net/win32/</A>.
7990
7991 <P>
7992 &lt;End of help on this topic&gt;
7993 </BODY>
7994 </HTML>
7995 ======= h_compose_alted =======
7996 <HTML>
7997 <HEAD>
7998 <TITLE>Alt Editor Command</TITLE>
7999 </HEAD>
8000 <BODY>
8001 <H1>Alt Editor Command</H1>
8002
8003 The &quot;Alt Editor&quot; command's availability depends on the
8004 Setup/Config variable &quot;<A HREF="h_config_editor"><!--#echo var="VAR_editor"--></A>&quot;.
8005
8006 <P>
8007 When the variable specifies a valid editor on your system, this
8008 command will launch it with the current text of your message
8009 already filled in.
8010
8011 <P>
8012 &lt;End of help on this topic&gt;
8013 </BODY>
8014 </HTML>
8015 ======= h_compose_readfile =======
8016 <HTML>
8017 <HEAD>
8018 <TITLE>Read File Command</TITLE>
8019 </HEAD>
8020 <BODY>
8021 <H1>Read File Command</H1>
8022
8023 The &quot;Read File&quot;
8024 <!--chtml if pinemode="function_key"-->
8025 (F5)
8026 <!--chtml else-->
8027 (^R)
8028 <!--chtml endif-->
8029 command allows you to copy in text from an existing file. You will be
8030 prompted for the name of a file to be inserted into the message.  The file
8031 name is relative to your home directory
8032 <!--chtml if pinemode="running"-->
8033 (which, in the present configuration of your system, is
8034  &quot;<!--#echo var="HOME_DIR"-->&quot;)
8035 <!--chtml endif-->
8036 or current working directory
8037 <!--chtml if pinemode="running"-->
8038 (which, at least for your current Alpine &quot;session,&quot;
8039 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
8040 <!--chtml endif-->, depending on the
8041 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
8042 configuration setting; or, the file name must be specified as a full path name
8043 <!--chtml if pinemode="os_windows"-->
8044 -- for example: &quot;A:&#92;PAPER.TXT&quot;
8045 <!--chtml else-->
8046 -- for example: &quot;/tmp/wisdom-of-the-day&quot;
8047 <!--chtml endif-->
8048 (without the quotation marks).
8049
8050 <P>
8051 The file will be inserted where the cursor is located.  <B>The
8052 file to be read must be on the same system as Alpine.</B> If you use Alpine on a
8053 Unix machine but have files on a PC or Mac, the files must be transferred
8054 to the system Alpine is running on before they can be read.  Please ask your
8055 local computer support people about the correct way to transfer a file to
8056 your Alpine system.
8057
8058 <P>
8059 &lt;End of help on this topic&gt;
8060 </BODY>
8061 </HTML>
8062 ======= h_config_tray_icon =======
8063 <HTML>
8064 <HEAD>
8065 <TITLE>FEATURE: <!--#echo var="FEAT_enable-tray-icon"--></TITLE>
8066 </HEAD>
8067 <BODY>
8068 <H1>FEATURE: <!--#echo var="FEAT_enable-tray-icon"--></H1>
8069
8070 PC-Alpine only.
8071 <P>
8072 This option restores a behavior of previous versions of PC-Alpine.
8073 These
8074 versions, when started, installed a PC-Alpine icon in the notification
8075 tray of Window's Taskbar.  The primary use of this icon was to indicate
8076 new mail arrival by turning red (while the Taskbar icon remained green).
8077 Additionally, the icon now changes to yellow to signify that a mail folder
8078 has been closed unexpectedly.
8079
8080 <P>
8081 Rather than add another icon to the Taskbar, this version of PC-Alpine will
8082 color its Taskbar entry's icon red (as well as the icon in the Window
8083 Title).  This feature is only provided for backwards compatibility.
8084
8085 <P>
8086 &lt;End of help on this topic&gt;
8087 </BODY>
8088 </HTML>
8089 ======= h_common_suspend =======
8090 <HTML>
8091 <HEAD>
8092 <TITLE>Suspend Command</TITLE>
8093 </HEAD>
8094 <BODY>
8095 <H1>Suspend Command</H1>
8096
8097 With the <A HREF="h_config_can_suspend"><!--#echo var="FEAT_enable-suspend"--></A> feature
8098 enabled, you can, at almost any time, temporarily halt your Alpine session,
8099 <!--chtml if pinemode="os_windows"-->
8100 minimizing it into an icon.
8101 <!--chtml else-->
8102 and return to your system prompt.
8103 <!--chtml endif-->
8104
8105 <P>
8106 &lt;End of help on this topic&gt;
8107 </BODY>
8108 </HTML>
8109 ======= h_pipe_command =======
8110 <HTML>
8111 <HEAD>
8112 <TITLE>Pipe Command SubOptions</TITLE>
8113 </HEAD>
8114 <BODY>
8115 <H1>Pipe Command SubOptions</H1>
8116
8117 By default, when you use the Pipe command, the processed text of the
8118 message is sent to the Unix command
8119 you specify and the output is captured by Alpine and shown to you.
8120 (This command is available in PC-Alpine, as well, but there aren't many
8121 Windows commands that work well with piping.)
8122 There are some sub-commands that may be used to alter this behavior.
8123 These are toggles that switch the behavior between two possibilities.
8124 They can be combined in any way you wish.
8125 <P>
8126 By default, the prompt at the bottom of the screen looks like
8127 <P>
8128 <CENTER><SAMP>Pipe message 37 to :</SAMP></CENTER>
8129 <P>
8130 or
8131 <P>
8132 <CENTER><SAMP>Pipe messages to :</SAMP></CENTER>
8133 <P>
8134 if you are piping more than one message.
8135 <P>
8136 The sub-command options are:
8137 <DL>
8138    <DT>Shown Text or Raw Text</DT>
8139    <DD>This option toggles between sending the shown (processed) text
8140 of the message to the Unix command, and sending the
8141 raw (unprocessed) text of the message to the Unix command.
8142 The default is to send the shown text.
8143 The raw version of the message will contain all of the headers and any
8144 MIME encoding that the message contains.
8145 If you've selected the Raw Text then the prompt will have the additional word
8146 &quot;RAW&quot; in it, like
8147 <P>
8148 <CENTER><SAMP>Pipe RAW messages to :</SAMP></CENTER>
8149 <P>
8150 You can experiment with this option by piping to something simple like the
8151 Unix &quot;cat&quot; command.
8152    </DD>
8153    <DT>Captured Output or Free Output</DT>
8154    <DD>This option toggles between having Alpine capture the output of
8155 the Unix pipe command for display, and not capturing it.
8156 If the command you are piping to is a filter that will produce output
8157 you want to view, then you want to capture that output
8158 for display (the default).
8159 If the Unix command doesn't produce output or handles the display itself,
8160 then you want free output.
8161 When you've selected the Free Output option the prompt will change to
8162 <P>
8163 <CENTER><SAMP>Pipe messages to (uncaptured) :</SAMP></CENTER>
8164 <P>
8165    </DD>
8166    <DT>No Delimiter or With Delimiter</DT>
8167    <DD>This option controls whether or not a Unix mailbox style delimiter
8168 will come before the text of the message.
8169 This is the delimiter used in the common Unix mailbox format.
8170 It's the single line that begins with the five characters
8171 &quot;From&quot; followed by a &lt;SPACE&gt; character.
8172 You'll usually only want to include this if the Unix command requires
8173 input in the format of a traditional Unix mailbox file.
8174 When you've selected the With Delimiter option the prompt will change to
8175 <P>
8176 <CENTER><SAMP>Pipe messages to (delimited) :</SAMP></CENTER>
8177 <P>
8178    </DD>
8179    <DT>To Same Pipe or To Individual Pipes</DT>
8180    <DD>This option only shows up if you are running an aggregate
8181 pipe command.
8182 That is, the command was Apply Pipe, not just Pipe.
8183 You have the option of piping all of the selected messages through a
8184 single pipe to a single instance of the Unix command,
8185 or piping each individual message through a separate pipe to separate
8186 instances of the Unix command.
8187 The default is that all of the output will go through a single pipe
8188 to a single instance of the command.
8189 You can try this option with a command like &quot;less&quot;, with Free
8190 Output enabled.
8191 When you've selected the Individual Pipes option the prompt will change to
8192 <P>
8193 <CENTER><SAMP>Pipe messages to (new pipe) :</SAMP></CENTER>
8194 <P>
8195    </DD>
8196 </DL>
8197
8198 <P>
8199 As mentioned earlier, the options can be combined in any way you wish.
8200 You may leave them all off, turn them all on, or turn some of them on
8201 and some of them off.
8202 If you use the pipe command a second time in the same session the default
8203 options will be what you used the last time.
8204
8205 <P>
8206 &lt;End of help on this topic&gt;
8207 </BODY>
8208 </HTML>
8209 ========== h_emptydir_subfolder_name =========
8210 <HTML>
8211 <HEAD>
8212 <TITLE>ENTER SUBFOLDER NAME</TITLE>
8213 </HEAD>
8214 <BODY>
8215 <H1>Enter Subfolder Name</H1>
8216
8217 <P>
8218 This is the name of a new subfolder in the directory you are creating.
8219 Because empty directories are hidden and therefore not useful, you must also
8220 create a subfolder in the directory you are creating in order that the
8221 directory remains visible.
8222 <P>
8223 Alternatively, you may turn off the configuration feature
8224 <A HREF="h_config_quell_empty_dirs"><!--#echo var="FEAT_quell-empty-directories"--></A>
8225 so that empty directories remain visible.
8226 If you do that, you will not be required to create the subfolder when you
8227 create a directory.
8228
8229 <P>
8230 &lt;End of help on this topic&gt;
8231 </BODY>
8232 </HTML>
8233 ========== h_incoming_add_folder_name =========
8234 <HTML>
8235 <HEAD>
8236 <TITLE>ENTER FOLDER NAME</TITLE>
8237 </HEAD>
8238 <BODY>
8239 <H1>Enter Folder Name</H1>
8240
8241 <P>
8242 This is the name of the folder on the previously specified server.
8243 By default the folder name is interpreted as defining a section of your personal
8244 folder area.  This area and how you specify it are defined by the
8245 server, if one is specified.
8246
8247 <P>
8248 To define a folder outside the default area, prefix
8249 the path with the namespace to use when interpreting the
8250 given path.  If a namespace is specified, the folder name begins with the
8251 sharp (#) character followed by the name of the namespace
8252 and then the namespace's path-element-delimiter.  Aside from the
8253 name's format, namespaces can also imply access rights, content
8254 policy, audience, location, and, occasionally, access methods.
8255
8256 <P>
8257 Each server exports its own set (possibly of size one) of
8258 namespaces.
8259 For a more detailed explanation read about
8260 <A HREF="h_folder_name_namespaces">Namespaces</A>.
8261
8262 <P>
8263 To specify the default for INBOX on the server you can usually just enter
8264 &quot;INBOX&quot;, and the server will understand the special meaning of
8265 that word.
8266
8267 <P>
8268 &lt;End of help on this topic&gt;
8269 </BODY>
8270 </HTML>
8271 ========== h_incoming_add_folder_host =========
8272 <HTML>
8273 <HEAD>
8274 <TITLE>ENTER INCOMING FOLDER SERVER</TITLE>
8275 </HEAD>
8276 <BODY>
8277 <H1>Enter Incoming Folder Server</H1>
8278
8279 You are being asked for the name of the server for use with this incoming
8280 folder.
8281 If the folder is on the machine where Alpine is running, then just enter
8282 RETURN without typing a server name.
8283
8284 <P>
8285 If the folder is on an IMAP server then type the server's name followed
8286 by RETURN.
8287 You may use the ^X command if the server is the same as the server that
8288 the INBOX is on.
8289
8290 <P>
8291 You may have to add optional extra information to the server name.
8292 For example, if the IMAP server is using a non-standard port number you
8293 would specify that by appending a colon (:) followed by the port number
8294 to the server name
8295
8296 <P>
8297 <CENTER><SAMP>foo.example.com:port</SAMP></CENTER>
8298 <P>
8299
8300 or you may need to specify a different protocol if the server is not an
8301 IMAP server. For example:
8302
8303 <P>
8304 <CENTER><SAMP>foo.example.com/pop3</SAMP></CENTER>
8305 <P>
8306
8307 for a POP server or
8308
8309 <P>
8310 <CENTER><SAMP>foo.example.com/nntp</SAMP></CENTER>
8311 <P>
8312
8313 for an NNTP news server.
8314 For an explanation of all of the possibilities, see
8315 <A HREF="h_folder_server_syntax">Server Name Syntax</A>
8316 for folders.
8317
8318 <P>
8319 There is a special command (^W) if you want to set up a folder that gets its
8320 mail from a
8321 <A HREF="h_maildrop">Mail Drop</A>.
8322 If you type that command, you will be prompted for the information for
8323 both the Mail Drop folder and the destination folder.
8324
8325 <P>
8326 &lt;End of help on this topic&gt;
8327 </BODY>
8328 </HTML>
8329 ========== h_incoming_add_inbox =========
8330 <HTML>
8331 <HEAD>
8332 <TITLE>ENTER INBOX SERVER</TITLE>
8333 </HEAD>
8334 <BODY>
8335 <H1>Enter INBOX Server</H1>
8336
8337 You are being asked for the name of the server for use with
8338 the INBOX folder.
8339 Type the server's name followed by RETURN.
8340
8341 <P>
8342 You may have to add optional extra information to the server name.
8343 For example, if the server is using a non-standard port number you
8344 would specify that by appending a colon (:) followed by the port number
8345 to the server name
8346
8347 <P>
8348 <CENTER><SAMP>foo.example.com:port</SAMP></CENTER>
8349 <P>
8350
8351 or you may need to specify a different protocol if the server is not an
8352 IMAP server. For example:
8353
8354 <P>
8355 <CENTER><SAMP>foo.example.com/pop3</SAMP></CENTER>
8356 <P>
8357
8358 for a POP server.
8359 <P>
8360
8361 For an explanation of all of the possibilities, see
8362 <A HREF="h_folder_server_syntax">Server Name Syntax</A>
8363 for folders.
8364
8365 <P>
8366 If the INBOX folder is on the machine where Alpine is running, then just enter
8367 RETURN without typing a server name.
8368
8369 <P>
8370 There is a special command (^W) if you want to set up a folder that gets its
8371 mail from a
8372 <A HREF="h_maildrop">Mail Drop</A>.
8373 If you type that command, you will be prompted for the information for
8374 both the Mail Drop folder and the destination folder, which will be used
8375 as your INBOX folder.
8376
8377 <P>
8378 &lt;End of help on this topic&gt;
8379 </BODY>
8380 </HTML>
8381 ========== h_incoming_add_maildrop_destn =========
8382 <HTML>
8383 <HEAD>
8384 <TITLE>ENTER DESTINATION SERVER</TITLE>
8385 </HEAD>
8386 <BODY>
8387 <H1>Enter Destination Server</H1>
8388
8389 You are being asked for the name of the server where the destination
8390 folder is for use with this Mail Drop incoming folder.
8391 That is, you are using a Mail Drop for this incoming folder and
8392 you've already entered
8393 the server and folder name for the Mail Drop.
8394 Now you need to enter the server for the destination folder
8395 where the mail should be copied to.
8396 Mail will come from the Mail Drop and be copied to the destination folder.
8397
8398 <P>
8399 Type the server's name followed by RETURN.
8400 If the folder is local to this computer, just type RETURN without entering
8401 a server name.
8402
8403 <P>
8404 You may have to add optional extra information to the server name.
8405 For example, if the server is using a non-standard port number you
8406 would specify that by appending a colon (:) followed by the port number
8407 to the server name
8408
8409 <P>
8410 <CENTER><SAMP>foo.example.com:port</SAMP></CENTER>
8411 <P>
8412
8413 For an explanation of all of the possibilities, see
8414 <A HREF="h_folder_server_syntax">Server Name Syntax</A>
8415 for folders.
8416
8417 <P>
8418 &lt;End of help on this topic&gt;
8419 </BODY>
8420 </HTML>
8421 ========== h_inbox_add_maildrop_destn =========
8422 <HTML>
8423 <HEAD>
8424 <TITLE>ENTER DESTINATION SERVER</TITLE>
8425 </HEAD>
8426 <BODY>
8427 <H1>Enter Destination Server</H1>
8428
8429 You are being asked for the name of the server where the destination
8430 folder is for use with your Mail Drop INBOX.
8431 That is, you are using a Mail Drop for your INBOX and you've already entered
8432 the server and folder name for the Mail Drop.
8433 Now you need to enter the server for the destination folder
8434 where the mail should be copied to.
8435 Mail will come from the Mail Drop and be copied to the destination folder.
8436
8437 <P>
8438 Type the server's name followed by RETURN.
8439 If the folder is local to this computer, just type RETURN without entering
8440 a server name.
8441
8442 <P>
8443 You may have to add optional extra information to the server name.
8444 For example, if the server is using a non-standard port number you
8445 would specify that by appending a colon (:) followed by the port number
8446 to the server name
8447
8448 <P>
8449 <CENTER><SAMP>foo.example.com:port</SAMP></CENTER>
8450 <P>
8451
8452 For an explanation of all of the possibilities, see
8453 <A HREF="h_folder_server_syntax">Server Name Syntax</A>
8454 for folders.
8455
8456 <P>
8457 &lt;End of help on this topic&gt;
8458 </BODY>
8459 </HTML>
8460 ========== h_inbox_add_maildrop =========
8461 <HTML>
8462 <HEAD>
8463 <TITLE>ENTER MAILDROP SERVER</TITLE>
8464 </HEAD>
8465 <BODY>
8466 <H1>Enter Mail Drop Server</H1>
8467
8468 You are being asked for the name of the Mail Drop server for use with
8469 your INBOX.
8470
8471 <P>
8472 Type the server's name followed by RETURN.
8473
8474 <P>
8475 You may have to add optional extra information to the server name.
8476 For example, if the server is using a non-standard port number you
8477 would specify that by appending a colon (:) followed by the port number
8478 to the server name
8479
8480 <P>
8481 <CENTER><SAMP>foo.example.com:port</SAMP></CENTER>
8482 <P>
8483
8484 or you may need to specify a different protocol if the server is not an
8485 IMAP server. For example:
8486
8487 <P>
8488 <CENTER><SAMP>foo.example.com/pop3</SAMP></CENTER>
8489 <P>
8490
8491 for a POP server or
8492
8493 <P>
8494 <CENTER><SAMP>foo.example.com/nntp</SAMP></CENTER>
8495 <P>
8496
8497 for an NNTP news server.
8498 For an explanation of all of the possibilities, see
8499 <A HREF="h_folder_server_syntax">Server Name Syntax</A>
8500 for folders.
8501
8502 <P>
8503 &lt;End of help on this topic&gt;
8504 </BODY>
8505 </HTML>
8506 ========== h_incoming_add_maildrop =========
8507 <HTML>
8508 <HEAD>
8509 <TITLE>ENTER MAILDROP SERVER</TITLE>
8510 </HEAD>
8511 <BODY>
8512 <H1>Enter Mail Drop Server</H1>
8513
8514 You are being asked for the name of the Mail Drop server for use with
8515 this incoming folder.
8516
8517 <P>
8518 Type the server's name followed by RETURN.
8519 You may use the ^X command if the server is the same as the server that
8520 the INBOX is on.
8521
8522 <P>
8523 You may have to add optional extra information to the server name.
8524 For example, if the server is using a non-standard port number you
8525 would specify that by appending a colon (:) followed by the port number
8526 to the server name
8527
8528 <P>
8529 <CENTER><SAMP>foo.example.com:port</SAMP></CENTER>
8530 <P>
8531
8532 or you may need to specify a different protocol if the server is not an
8533 IMAP server. For example:
8534
8535 <P>
8536 <CENTER><SAMP>foo.example.com/pop3</SAMP></CENTER>
8537 <P>
8538
8539 for a POP server or
8540
8541 <P>
8542 <CENTER><SAMP>foo.example.com/nntp</SAMP></CENTER>
8543 <P>
8544
8545 for an NNTP news server.
8546 For an explanation of all of the possibilities, see
8547 <A HREF="h_folder_server_syntax">Server Name Syntax</A>
8548 for folders.
8549
8550 <P>
8551 If the Mail Drop folder is on the machine where Alpine is running, then just enter
8552 RETURN without typing a server name.
8553
8554 <P>
8555 &lt;End of help on this topic&gt;
8556 </BODY>
8557 </HTML>
8558 ========== h_maildrop =========
8559 <HTML>
8560 <HEAD>
8561 <TITLE>WHAT IS A MAIL DROP?</TITLE>
8562 </HEAD>
8563 <BODY>
8564 <H1>What is a Mail Drop?</H1>
8565
8566 In some situaions it may make sense to have your mail delivered to one
8567 folder (the Mail Drop) and then when you want to read mail that has been
8568 delivered to the Mail Drop folder Alpine will move it to another
8569 destination folder.
8570 Often the Mail Drop will be a remote folder and messages will be moved from
8571 there to a local destination folder.
8572
8573 <P>
8574 One example where this might make sense is if the Mail Drop folder is accessible
8575 only with the POP protocol.
8576 You could designate your POP inbox as the Mail Drop folder and have Alpine move
8577 mail from there to a local (on the same machine Alpine is running on)
8578 destination folder, where you'll read it.
8579
8580 <P>
8581 A Mail Drop may only be used as your Inbox or as an
8582 <A HREF="h_config_enable_incoming">&quot;Incoming folder&quot;</A>.
8583
8584 <P>
8585 There is no attempt to synchronize the contents of the destination folder
8586 with the contents of the Mail Drop folder.
8587 All that happens is that all of the messages in the Mail Drop folder are
8588 copied to the destination folder and then they are deleted and expunged (if possible)
8589 from the Mail Drop folder.
8590 The next time a check for new mail is made, any messages in the Mail
8591 Drop folder are once again copied to the destination folder and deleted
8592 and expunged from the Mail Drop folder.
8593 (If the Mail Drop folder is a news group, then the messages can't be
8594 expunged from the newsgroup. Instead, only Recent messages are copied from
8595 the newsgroup to the destination folder.)
8596
8597 <P>
8598 Configuration of a Mail Drop is a little different from configuration of
8599 a folder that does not use a Mail Drop because you have to specify two
8600 folder names instead of one.
8601 The two folders may be any types of folders that Alpine can normally use.
8602 They don't have to be a remote folder and a local folder, that is
8603 simply the most common usage.
8604 When you use a Mail Drop folder Alpine will periodically re-open the Mail
8605 Drop to check for new mail.
8606 The new-mail checks will happen at the frequency set with the
8607 <A HREF="h_config_mailcheck"><!--#echo var="VAR_mail-check-interval"--></A> option,
8608 but with a minimum time
8609 (<A HREF="h_config_maildropcheck"><!--#echo var="VAR_maildrop-check-minimum"--></A>)
8610 between checks.
8611 Because of this minimum you may notice that new mail does not
8612 appear promptly when you expect it.
8613 The reason for this is to protect the server from over-zealous opening and
8614 closing of the Mail Drop folder.
8615 If the user initiates the check by typing ^L (Ctrl-L) or the Next command when at
8616 the end of the folder index, then the check will happen, regardless of how
8617 long it has been since the previous check.
8618 <P>
8619 If there is new mail, that mail will be copied to the destination folder
8620 and then will be deleted from the Mail Drop.
8621 Note that using a Mail Drop with a local destination folder does not make
8622 sense if you read mail from more than one machine, because the mail is
8623 downloaded to the destination folder (which is accessible from only one
8624 machine) and deleted from the Mail Drop.
8625 <P>
8626 The feature <A HREF="h_config_maildrops_preserve_state"><!--#echo var="FEAT_maildrops-preserve-state"--></A> modifies the operation of Mail Drops.
8627
8628 <P>
8629 The actual syntax used by Alpine for a folder that uses a Mail Drop is:
8630
8631 <P>
8632 <CENTER><SAMP>#move&lt;DELIM&gt;&lt;MailDropFolder&gt;&lt;DELIM&gt;&lt;DestinationFolder&gt;</SAMP></CENTER>
8633 <P>
8634 The brackets are not literal.
8635 <P>
8636 <CENTER><SAMP>&lt;DELIM&gt;</SAMP></CENTER>
8637 <P>
8638 is a single character that does not appear in the MailDropFolder name.
8639 If the name doesn't contain spaces then it can be a space character.
8640 The two folder names are full technical
8641 <A HREF="h_valid_folder_names">folder names</A>
8642 as used by Alpine.
8643 Here are a couple examples to give you an idea what is being talked about:
8644
8645 <P>
8646 <CENTER><SAMP>#move&nbsp;{popserver.example.com/pop3}inbox&nbsp;localfolder</SAMP></CENTER>
8647 <P>
8648 <CENTER><SAMP>#move+{nntpserver.example.com/nntp}#news.comp.mail.pine+local&nbsp;folder</SAMP></CENTER>
8649 <P>
8650
8651 A #move folder may only be used as an
8652 <A HREF="h_config_enable_incoming">&quot;Incoming folder&quot;</A> or
8653 an Inbox.
8654 When you are in the FOLDER LIST of Incoming Message Folders (after turning
8655 on the
8656 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="FEAT_enable-incoming-folders"-->&quot;</A>
8657 option)
8658 the Add command has a subcommand &quot;Use Mail Drop&quot;
8659 which may be helpful for defining the folder in your Alpine configuration.
8660 The same is true when you edit the
8661 <A HREF="h_config_inbox_path"><!--#echo var="VAR_inbox-path"--></A>
8662 option in Setup/Config.
8663 Each of these configuration methods will also create the DestinationFolder
8664 if it doesn't already exist.
8665 If you are having problems, make sure the DestinationFolder exists.
8666
8667 <P>
8668 &lt;End of help on this topic&gt;
8669 </BODY>
8670 </HTML>
8671 ========== h_save =========
8672 <HTML>
8673 <HEAD>
8674 <TITLE>CHOOSE A FOLDER TO SAVE INTO</TITLE>
8675 </HEAD>
8676 <BODY>
8677 <H1>Choose a Folder to Save Into</H1>
8678
8679 After Exiting from this help text,
8680 type the name of the folder you want to save into and press RETURN.
8681 <P>
8682 Press ^T to get a list of your folders to choose from.
8683 Press ^C to cancel the Save.
8684 <P>
8685 If you have Folder Collections defined you may use
8686 Ctrl-P (Previous collection) and Ctrl-N (Next collection) to switch
8687 the collection being saved to.
8688 <P>
8689 If Tab Completion is enabled (it is enabled by default)
8690 you may type a Tab character to have Alpine complete the folder name for you.
8691 <P>
8692 If Partial Match Lists is enabled (it is enabled by default) you may type
8693 Ctrl-X to get a list of matches to the prefix you've typed in so far.
8694 <P>
8695 If the Ctrl-R subcommand is present that means you can decide to Delete or
8696 not Delete the message you are saving after you save it.
8697 The label on that key gives the action to switch to.
8698 If it says Delete and you type Ctrl-R the label displayed will change to
8699 No Delete and the source message will be deleted after the save. If it
8700 says No Delete and you type Ctrl-R the label displayed will change to
8701 Delete and the message will not be deleted.
8702 You can control the default for the Delete parameter with the
8703 configuration feature <!--#echo var="FEAT_save-will-not-delete"-->.
8704 <P>
8705 Similarly, if the Ctrl-W subcommand is present that means you can decide
8706 to Preserve the order of the messages being saved or not.
8707 If it is labeled Preserve Order and you type Ctrl-W, the resulting Saved messages
8708 will be in the same order as you see them in the source folder now.
8709 The opposite action (which is usually the default) is that you don't care
8710 about the order.
8711 The Saved messages may or may not be in the same order in the destination folder.
8712 There may be a performance penalty for choosing to save the messages in order.
8713 You can control the default for the Preserve Order parameter with the
8714 configuration feature
8715 <!--#echo var="FEAT_save-aggregates-copy-sequence"-->.
8716
8717 <P>
8718 If you haven't disabled the Save Input History and you've already done a
8719 Save earlier in this session then you may use the Up and Down arrows to retrieve
8720 a folder name used in a previous Save.
8721
8722 <P>
8723 &lt;End of help on this topic&gt;
8724 </BODY>
8725 </HTML>
8726 ============= h_simple_index ========================
8727 <HTML>
8728 <HEAD>
8729 <TITLE>SELECT POSTPONED MESSAGE</TITLE>
8730 </HEAD>
8731 <BODY>
8732 <H1>POSTPONED MESSAGE SELECTION COMMANDS</H1>
8733 <!--chtml if pinemode="function_key"-->
8734 <PRE>
8735 Navigating the List of Messages               General Alpine Commands
8736 -------------------------------               -----------------------
8737  F5   Move to previous message                 F1   Show this help text
8738  F6   Move to next message
8739  F7   Show previous screen of messages
8740  F8   Show next screen of messages
8741
8742 Message Selection Commands
8743 --------------------------
8744  F3   Exit the Message Select menu (canceling Send command)
8745  F4   Select the currently highlighted message
8746  F9   Mark the currently highlighted message as deleted
8747  F10  Undelete (remove deletion mark from) the highlighted message
8748 </PRE>
8749 <!--chtml else-->
8750 <PRE>
8751 Navigating the List of Messages               General Alpine Commands
8752 -------------------------------               -----------------------
8753   P  Move to previous message                  ?  Show this help text
8754   N  Move to next message
8755   -  Show previous screen of messages
8756  Spc (space bar) Show next screen of messages
8757
8758 Message Selection Commands
8759 --------------------------
8760   E  Exit the Message Select menu (canceling Send command)
8761   S  Select the currently highlighted message
8762   D  Mark the currently highlighted message as deleted
8763   U  Undelete (remove deletion mark from) the highlighted message
8764 </PRE>
8765 <!--chtml endif-->
8766 <P>
8767 <H2>Description of the Select Postponed Message Screen</H2>
8768
8769 This screen allows you to select one of several previously postponed
8770 messages in order to continue composition.  Your options are very limited
8771 -- the screen is not meant to let you manipulate these messages.  However,
8772 you may now delete messages from this list.  Once you choose a message,
8773 Alpine reads it in and puts you into the regular message composer.
8774 <P>
8775
8776 Messages do not stay in this postponed state automatically.  If you select
8777 a message and then want to postpone it again, use the normal postpone
8778 (Ctrl-O) command in the composer.
8779 <P>
8780
8781 If you exit this screen without selecting a message, the Compose command
8782 that got you here is canceled.  Other than messages explicitly marked
8783 &quot;Deleted&quot;, no messages will be removed.
8784
8785 <P>
8786 &lt;End of help on this topic&gt;
8787 </BODY>
8788 </HTML>
8789 ============= h_collection_screen ========================
8790 <HTML>
8791 <HEAD>
8792 <TITLE>COLLECTION LIST screen</TITLE>
8793 </HEAD>
8794 <BODY>
8795 <H1>COLLECTION LIST screen</H1>
8796
8797 The COLLECTION LIST screen is used to select one of your
8798 collection definitions to display the folders they contain.  See
8799 <A HREF="h_what_are_collections">Folder Collections Explained</A> for
8800 detailed explanation of collections.<P>
8801
8802 To manage your collection definitions (Add, Change, Delete, etc.), use
8803 the <A HREF="h_collection_maint">Setup/collectionList</A> command on Alpine's
8804 MAIN MENU.
8805
8806 <P>
8807 &lt;End of help on this topic&gt;
8808 </BODY>
8809 </HTML>
8810 ============= h_collection_maint ========================
8811 <HTML>
8812 <HEAD>
8813 <TITLE>SETUP COLLECTION LIST screen</TITLE>
8814 </HEAD>
8815 <BODY>
8816 <H1>SETUP COLLECTION LIST screen</H1>
8817
8818 The SETUP COLLECTION LIST screen lets you manage your collection
8819 definitions.  See
8820 <A HREF="h_what_are_collections">Folder Collections Explained</A>
8821 for detailed explanation of collections.<P>
8822
8823 Maintenance commands include:
8824 <DL>
8825 <DT>Change
8826 <!--chtml if pinemode="function_key"-->
8827 (F4)
8828 <!--chtml else-->
8829 (C)
8830 <!--chtml endif-->
8831 </DT>
8832
8833 <DD>Modify attributes of the selected collection definition.
8834
8835 <DT>Add Cltn
8836 <!--chtml if pinemode="function_key"-->
8837 (F9)
8838 <!--chtml else-->
8839 (A)
8840 <!--chtml endif-->
8841 </DT>
8842
8843 <DD>Create a new collection definition.
8844 </DD>
8845
8846 <DT>Del Cltn
8847 <!--chtml if pinemode="function_key"-->
8848 (F10)
8849 <!--chtml else-->
8850 (D)
8851 <!--chtml endif-->
8852 </DT>
8853
8854 <DD>Delete the selected collection definition.<BR>
8855 NOTE: The folders and directories referred to by the
8856 collection definition are <EM>NOT</EM> deleted.  Folders must
8857 be deleted, if that's what you wish to do, from the
8858 <A HREF="h_folder_maint">FOLDER LIST screen</A>, which shows the
8859 individual folders in a collection.
8860 </DD>
8861
8862 <DT>Shuffle
8863 <!--chtml if pinemode="function_key"-->
8864 (F11)
8865 <!--chtml else-->
8866 ($)
8867 <!--chtml endif-->
8868 </DT>
8869
8870 <DD>Change the order of the displayed collections.  Alpine will offer
8871 to move the currently selected collection one position UP
8872 or DOWN.
8873 </DD>
8874 </DL>
8875
8876 <P>
8877 &lt;End of help on this topic&gt;
8878 </BODY>
8879 </HTML>
8880 ============ h_what_are_collections ==========
8881 <HTML>
8882 <HEAD>
8883 <TITLE>Folder Collections Explained</TITLE>
8884 </HEAD>
8885 <BODY>
8886 <H1>Folder Collections Explained</H1>
8887
8888
8889 Those of you with simple mail configurations will just see a list of all the
8890 folders you have when choosing FOLDER LIST from Alpine's MAIN MENU.
8891 The special folders for INBOX, sent mail and saved messages
8892 will appear at the top of the list.  All others are in alphabetical order.
8893 <P>
8894 If you
8895 or your system administrator have defined more than one collection or if
8896 you have a collection (for newsgroups or email folders) defined on your
8897 system, then you will see the COLLECTION LIST screen first when choosing
8898 FOLDER LIST from Alpine's MAIN MENU.
8899 <P>
8900 <H2>Why have multiple folder collections?</H2>
8901 <P>
8902 For Alpine users who only maintain email folders (and not too many) on one host,
8903 a single folder collection is probably sufficient.<P>
8904
8905 However, people who have more than one email account - for example, one
8906 at their university, and one with their personal Internet Service Provider -
8907 will have different sets of folders on different hosts, and they may want to
8908 access them all from the same installation of Alpine, rather than use different
8909 software and/or log into other hosts to manipulate messages in different
8910 accounts.  (If in doubt whether one of your email accounts can be accessed
8911 with Alpine, contact the technical support people for that account.)  Even people
8912 who have only one email account on one host, but have dozens or
8913 hundreds of email folders, may want to arrange these folders together in a
8914 meaningful way.<BR>
8915 That is where multiple collections come in.
8916
8917 <H2>Types of Collections</H2>
8918 <DL>
8919 <DT>INCOMING FOLDERS</DT>
8920 <DD>&quot;Incoming Message Folders&quot;
8921 is a special collection typically used to supplement your single INBOX.
8922 All the folders here are meant to be ones that receive incoming messages,
8923 which you intend to check more or less frequently.
8924 You may have multiple folders like this because you or your systems
8925 administrator have set up an external program or you may have set up
8926 Alpine to filter incoming
8927 messages into different folders, based on certain criteria such as
8928 sender, recipient, or subject; or because you have multiple accounts and
8929 wish to check their INBOXes easily.  This collection is established by
8930 setting the
8931 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="FEAT_enable-incoming-folders"-->&quot;</A>
8932 feature in the SETUP CONFIGURATION screen, which is accessed from the
8933 MAIN MENU.
8934 </DD>
8935
8936 <DT>NEWS</DT>
8937 <DD>You can also define a collection specifically for
8938 newsgroups.  Alpine does this for you implicitly when you
8939 <A HREF="h_config_nntp_server">define an NNTP Server</A>
8940 in your Alpine configuration.  The news collection appears last in the
8941 COLLECTION LIST (though you can shuffle it up in the order of presentation),
8942 and Alpine knows not to save messages there.
8943 </DD>
8944
8945 <DT>DEFAULT COLLECTION</DT>
8946 <DD>This is the default collection for your saved and sent messages folders.
8947 </DD>
8948 </DL>
8949
8950 <P>
8951
8952 <H2>Defining Collections</H2>
8953 <P>
8954 In the absence of any folder-collection definitions, Alpine will assume a
8955 single default folder collection.
8956 <!--chtml if pinemode="os_windows"-->
8957 <!--chtml else-->
8958 If necessary, Alpine will create the directory
8959 &quot;mail&quot; in your Unix home directory
8960 to hold your folders.
8961 <!--chtml endif-->
8962 <P>
8963 You can use the
8964 <A HREF="h_collection_maint">Setup/collectionList screen</A>, called up from
8965 the MAIN MENU, to manage your collection list.
8966 <P>
8967 &lt;End of help on this topic&gt;
8968 </BODY>
8969 </HTML>
8970 ===== h_select_address_screen =====
8971 <HTML>
8972 <HEAD>
8973 <TITLE>SELECT AN ADDRESS SCREEN</TITLE>
8974 </HEAD>
8975 <BODY>
8976 <H1>SELECT AN ADDRESS SCREEN</H1>
8977 <H2>COMMANDS</H2>
8978 <!--chtml if pinemode="function_key"-->
8979 <PRE>
8980 Available  Commands
8981 -------------------------------
8982 F1  Show Help Text
8983 F3  Exit without selecting anything
8984 F4  Select the highlighted address
8985 F5  Move highlight to previous address
8986 F6  Move highlight to next address
8987 F7  Previous page of addresses
8988 F8  Next page of addresses
8989 F11 Print
8990 F12 WhereIs
8991 </PRE>
8992 <!--chtml else-->
8993 <PRE>
8994 Navigation                     General Alpine Commands
8995 -------------------------      -----------------------
8996  P  Prev Address                ?  Display this help text
8997  N  Next Address                E  Exit without selecting anything
8998  -  Previous page               %  Print
8999 Spc (space bar) Next page
9000  W  WhereIs
9001
9002 Select Command
9003 ------------------------------------------------
9004  S  Select the highlighted address
9005 </PRE>
9006 <!--chtml endif-->
9007
9008 <H2>Description of the Select Address Screen</H2>
9009
9010 This screen gives you an easy way to select an address from all of
9011 the address book entries that match the prefix typed so far.
9012
9013 <P><UL>
9014 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
9015 </UL>
9016 <P>
9017 &lt;End of help on this topic&gt;
9018 </BODY>
9019 </HTML>
9020 ===== h_select_rule_screen =====
9021 <HTML>
9022 <HEAD>
9023 <TITLE>SELECT A RULE SCREEN</TITLE>
9024 </HEAD>
9025 <BODY>
9026 <H1>SELECT A RULE SCREEN</H1>
9027 <H2>COMMANDS</H2>
9028 <!--chtml if pinemode="function_key"-->
9029 <PRE>
9030 Available  Commands
9031 -------------------------------
9032 F1  Show Help Text
9033 F3  Exit without selecting anything
9034 F4  Select the highlighted rule
9035 F5  Move highlight to previous rule
9036 F6  Move highlight to next rule
9037 F7  Previous page of rules
9038 F8  Next page of rules
9039 F11 Print
9040 F12 WhereIs
9041 </PRE>
9042 <!--chtml else-->
9043 <PRE>
9044 Navigation                     General Alpine Commands
9045 -------------------------      -----------------------
9046  P  Prev Rule                   ?  Display this help text
9047  N  Next Rule                   E  Exit without selecting anything
9048  -  Previous page               %  Print
9049 Spc (space bar) Next page
9050  W  WhereIs
9051
9052 Select Command
9053 ------------------------------------------------
9054  S  Select the highlighted rule
9055 </PRE>
9056 <!--chtml endif-->
9057
9058 <H2>Description of the Select Rule Screen</H2>
9059
9060 This screen just gives you an easy way to select a rule from all of your
9061 defined rules.
9062 The list of rules presented is the list of nicknames of all of the rules
9063 defined using Setup/Rules.
9064 For selecting messages, it is likely that the Indexcolor rules and possibly
9065 the Roles rules will be most useful.
9066 The others are there also, in case you find a use for them.
9067 <P>
9068 In order for this to be useful for selecting messages, the nicknames of
9069 the rules have to be different.
9070 Alpine actually just gets the nickname of the rule that you select and then
9071 looks up that rule using the nickname.
9072 So if there are duplicate nicknames, the first rule that has that
9073 nickname will be used.
9074
9075 <P><UL>
9076 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
9077 </UL>
9078 <P>
9079 &lt;End of help on this topic&gt;
9080 </BODY>
9081 </HTML>
9082 ===== h_select_priority_screen =====
9083 <HTML>
9084 <HEAD>
9085 <TITLE>SELECT A PRIORITY SCREEN</TITLE>
9086 </HEAD>
9087 <BODY>
9088 <H1>SELECT A PRIORITY SCREEN</H1>
9089 <H2>COMMANDS</H2>
9090 <!--chtml if pinemode="function_key"-->
9091 <PRE>
9092 Available  Commands
9093 -------------------------------
9094 F1  Show Help Text
9095 F3  Exit without selecting anything
9096 F4  Select the highlighted priority
9097 F5  Move highlight to previous priority
9098 F6  Move highlight to next priority
9099 F7  Previous page of priorities
9100 F8  Next page of priorities
9101 F11 Print
9102 F12 WhereIs
9103 </PRE>
9104 <!--chtml else-->
9105 <PRE>
9106 Navigation                     General Alpine Commands
9107 -------------------------      -----------------------
9108  P  Prev Priority               ?  Display this help text
9109  N  Next Priority               E  Exit without selecting anything
9110  -  Previous page               %  Print
9111 Spc (space bar) Next page
9112  W  WhereIs
9113
9114 Select Command
9115 ------------------------------------------------
9116  S  Select the highlighted priority
9117 </PRE>
9118 <!--chtml endif-->
9119
9120 <H2>Description of the Select Priority Screen</H2>
9121
9122 This screen gives you a way to select a priority for the message you are sending.
9123 This priority will be placed in the non-standard X-Priority header of your outgoing mail.
9124 Some mail programs will display an indication of the priority level to
9125 the recipient of the message, some will ignore it.
9126 Even in cases where the mail programs of both the sender and the recipient
9127 agree on the meaning of this header, keep in mind that it is
9128 something that the sender sets so it is only an indication
9129 of the priority that the sender attaches to the mail.
9130 Alpine can be made to display an indication of this priority in incoming
9131 messages by use of one of the tokens
9132 (<A HREF="h_index_tokens">Tokens for Index and Replying</A>)
9133 PRIORITY, PRIORITYALPHA, or PRIORITY! in the
9134 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option.
9135
9136 <P><UL>
9137 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
9138 </UL>
9139 <P>
9140 &lt;End of help on this topic&gt;
9141 </BODY>
9142 </HTML>
9143 ===== h_select_keyword_screen =====
9144 <HTML>
9145 <HEAD>
9146 <TITLE>SELECT A KEYWORD SCREEN</TITLE>
9147 </HEAD>
9148 <BODY>
9149 <H1>SELECT A KEYWORD SCREEN</H1>
9150 <H2>COMMANDS</H2>
9151 <!--chtml if pinemode="function_key"-->
9152 <PRE>
9153 Available  Commands
9154 -------------------------------
9155 F1  Show Help Text
9156 F3  Exit without selecting anything
9157 F4  Select the highlighted keyword
9158 F5  Move highlight to previous keyword
9159 F6  Move highlight to next keyword
9160 F7  Previous page of keywords
9161 F8  Next page of keywords
9162 F11 Print
9163 F12 WhereIs
9164 </PRE>
9165 <!--chtml else-->
9166 <PRE>
9167 Navigation                     General Alpine Commands
9168 -------------------------      -----------------------
9169  P  Prev Keyword                ?  Display this help text
9170  N  Next Keyword                E  Exit without selecting anything
9171  -  Previous page               %  Print
9172 Spc (space bar) Next page
9173  W  WhereIs
9174
9175 Select Command
9176 ------------------------------------------------
9177  S  Select the highlighted keyword
9178 </PRE>
9179 <!--chtml endif-->
9180
9181 <H2>Description of the Select Keyword Screen</H2>
9182
9183 This screen just gives you an easy way to select a keyword.
9184 The list of keywords presented is the list of all keywords defined in your
9185 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option.
9186 If you have given a keyword a nickname, that nickname is displayed
9187 instead of the actual keyword.
9188
9189 <P><UL>
9190 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
9191 </UL>
9192 <P>
9193 &lt;End of help on this topic&gt;
9194 </BODY>
9195 </HTML>
9196 ===== h_select_charset_screen =====
9197 <HTML>
9198 <HEAD>
9199 <TITLE>SELECT A CHARACTER SET SCREEN</TITLE>
9200 </HEAD>
9201 <BODY>
9202 <H1>SELECT A CHARACTER SET SCREEN</H1>
9203 <H2>COMMANDS</H2>
9204 <!--chtml if pinemode="function_key"-->
9205 <PRE>
9206 Available  Commands
9207 -------------------------------
9208 F1  Show Help Text
9209 F3  Exit without selecting anything
9210 F4  Select the highlighted character set
9211 F5  Move highlight to previous character set
9212 F6  Move highlight to next character set
9213 F7  Previous page of character sets
9214 F8  Next page of character sets
9215 F11 Print
9216 F12 WhereIs
9217 </PRE>
9218 <!--chtml else-->
9219 <PRE>
9220 Navigation                     General Alpine Commands
9221 -------------------------      -----------------------
9222  P  Prev Character Set          ?  Display this help text
9223  N  Next Character Set          E  Exit without selecting anything
9224  -  Previous page               %  Print
9225 Spc (space bar) Next page
9226  W  WhereIs
9227
9228 Select Command
9229 ------------------------------------------------
9230  S  Select the highlighted character set
9231 </PRE>
9232 <!--chtml endif-->
9233
9234 <H2>Description of the Select A Character Set Screen</H2>
9235
9236 This screen just gives you an easy way to select a character set from the
9237 set of character sets Alpine knows about.
9238 The list presented will vary slightly depending on what option you are
9239 selecting the character set for.
9240
9241 <P><UL>
9242 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
9243 </UL>
9244 <P>
9245 &lt;End of help on this topic&gt;
9246 </BODY>
9247 </HTML>
9248 ===== h_select_multcharsets_screen =====
9249 <HTML>
9250 <HEAD>
9251 <TITLE>SELECT CHARACTER SETS SCREEN</TITLE>
9252 </HEAD>
9253 <BODY>
9254 <H1>SELECT CHARACTER SETS SCREEN</H1>
9255 <H2>COMMANDS</H2>
9256 <!--chtml if pinemode="function_key"-->
9257 <PRE>
9258 Available  Commands
9259 -------------------------------
9260 F1  Show Help Text
9261 F3  Exit without selecting anything
9262 F4  Select the highlighted charset (or chosen charsets in ListMode)
9263 F5  Move highlight to previous charset
9264 F6  Move highlight to next charset
9265 F7  Previous page of charsets
9266 F8  Next page of charsets
9267 F9  Toggle choices when using ListMode
9268 F10 Turn on/off ListMode (makes it easy to choose multiple charsets)
9269 F11 Print
9270 F12 WhereIs
9271 </PRE>
9272 <!--chtml else-->
9273 <PRE>
9274 Navigation                     General Alpine Commands
9275 -------------------------      -----------------------
9276  P  Prev Charset                ?  Display this help text
9277  N  Next Charset                E  Exit without selecting anything
9278  -  Previous page               %  Print
9279 Spc (space bar) Next page
9280  W  WhereIs
9281
9282 Select Command
9283 ------------------------------------------------
9284  S  Select the highlighted charset (or chosen charsets in ListMode)
9285  L  Turn on ListMode (makes it easy to choose multiple charsets)
9286  1  Turn off ListMode
9287  X  Toggle choices when using ListMode
9288 </PRE>
9289 <!--chtml endif-->
9290
9291 <H2>Description of the Select Character Set Screen</H2>
9292
9293 This screen just gives you an easy way to select a character set or a list of
9294 character sets.
9295 The list of character sets presented is the list of all character sets known to
9296 Alpine.
9297 You may select other character sets by typing them in directly.
9298
9299 <P><UL>
9300 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
9301 </UL>
9302 <P>
9303 &lt;End of help on this topic&gt;
9304 </BODY>
9305 </HTML>
9306 ===== h_select_multkeyword_screen =====
9307 <HTML>
9308 <HEAD>
9309 <TITLE>SELECT KEYWORDS SCREEN</TITLE>
9310 </HEAD>
9311 <BODY>
9312 <H1>SELECT KEYWORDS SCREEN</H1>
9313 <H2>COMMANDS</H2>
9314 <!--chtml if pinemode="function_key"-->
9315 <PRE>
9316 Available  Commands
9317 -------------------------------
9318 F1  Show Help Text
9319 F3  Exit without selecting anything
9320 F4  Select the highlighted keyword (or chosen keywords in ListMode)
9321 F5  Move highlight to previous keyword
9322 F6  Move highlight to next keyword
9323 F7  Previous page of keywords
9324 F8  Next page of keywords
9325 F9  Toggle choices when using ListMode
9326 F10 Turn on/off ListMode (makes it easy to choose multiple keywords)
9327 F11 Print
9328 F12 WhereIs
9329 </PRE>
9330 <!--chtml else-->
9331 <PRE>
9332 Navigation                     General Alpine Commands
9333 -------------------------      -----------------------
9334  P  Prev Keyword                ?  Display this help text
9335  N  Next Keyword                E  Exit without selecting anything
9336  -  Previous page               %  Print
9337 Spc (space bar) Next page
9338  W  WhereIs
9339
9340 Select Command
9341 ------------------------------------------------
9342  S  Select the highlighted keyword (or chosen keywords in ListMode)
9343  L  Turn on ListMode (makes it easy to choose multiple keywords)
9344  1  Turn off ListMode
9345  X  Toggle choices when using ListMode
9346 </PRE>
9347 <!--chtml endif-->
9348
9349 <H2>Description of the Select Keyword Screen</H2>
9350
9351 This screen just gives you an easy way to select a keyword or a list of
9352 keywords.
9353 The list of keywords presented is the list of all keywords defined in your
9354 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option.
9355 If you have given a keyword a nickname, that nickname is displayed
9356 instead of the actual keyword.
9357
9358 <P><UL>
9359 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
9360 </UL>
9361 <P>
9362 &lt;End of help on this topic&gt;
9363 </BODY>
9364 </HTML>
9365 ===== h_select_incoming_to_monitor =====
9366 <HTML>
9367 <HEAD>
9368 <TITLE>SELECT FOLDERS TO CHECK SCREEN</TITLE>
9369 </HEAD>
9370 <BODY>
9371 <H1>SELECT FOLDERS TO CHECK SCREEN</H1>
9372 <H2>COMMANDS</H2>
9373 <!--chtml if pinemode="function_key"-->
9374 <PRE>
9375 Available  Commands
9376 -------------------------------
9377 F1  Show Help Text
9378 F3  Exit without selecting anything
9379 F4  Select the marked folders
9380 F5  Move highlight to previous folder
9381 F6  Move highlight to next folder
9382 F7  Previous page of folders
9383 F8  Next page of folders
9384 F9  Toggle choices on or off
9385 F11 Print
9386 F12 WhereIs
9387 </PRE>
9388 <!--chtml else-->
9389 <PRE>
9390 Navigation                     General Alpine Commands
9391 -------------------------      -----------------------
9392  P  Prev Folder                 ?  Display this help text
9393  N  Next Folder                ^C  exit without changing anything
9394  -  Previous page               %  Print
9395 Spc (space bar) Next page
9396  W  WhereIs
9397
9398 Select Command
9399 ------------------------------------------------
9400  S  Select the marked folders
9401  X  Toggle choices on or off
9402 </PRE>
9403 <!--chtml endif-->
9404
9405 <H2>Description of the Select Folders to Check Screen</H2>
9406
9407 This screen is only useful if the feature
9408 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
9409 is set.
9410 By default, when you set that feature all of your incoming folders
9411 will be checked periodically for Unseen messages.
9412 By using this screen, you may restrict the set of monitored folders to
9413 a subset of all of the incoming folders.
9414 <P>
9415 Mark the folders you want to monitor for Unseen messages with
9416 an &quot;X&quot;.
9417 When you've finished marking all your selections use the Select
9418 command to register your choices.
9419 To return to the default of checking all incoming folders
9420 delete all folders or unmark all folders.
9421
9422 <P><UL>
9423 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
9424 </UL>
9425 <P>
9426 &lt;End of help on this topic&gt;
9427 </BODY>
9428 </HTML>
9429 ===== h_role_select =====
9430 <HTML>
9431 <HEAD>
9432 <TITLE>ROLES SCREEN</TITLE>
9433 </HEAD>
9434 <BODY>
9435 <H1>ROLES SCREEN</H1>
9436 <H2>ROLES COMMANDS</H2>
9437 <!--chtml if pinemode="function_key"-->
9438 <PRE>
9439 Available  Commands
9440 -------------------------------
9441 F1  Show Help Text
9442 F3  Exit without a selection
9443 F4  Select a role to use in composition
9444 F5  Move to previous role
9445 F6  Move to next role
9446 F7  Previous page of roles
9447 F8  Next page of roles
9448 F11 Change Default Role
9449 F12 Whereis (search role nicknames)
9450 </PRE>
9451 <!--chtml else-->
9452 <PRE>
9453 Navigation                     General Alpine Commands
9454 -------------------------      -----------------------
9455  P  Prev Role                     ?  Display this help text
9456  N  Next Role                     E  Exit without a selection
9457  -  Previous page
9458 Spc (space bar) Next page
9459  W  WhereIs (search for word in role nicknames)
9460
9461 Select Role Commands
9462 ------------------------------------------------
9463  [Return]  Select highlighted role
9464  D         Change Default Role
9465 </PRE>
9466 <!--chtml endif-->
9467
9468 <H2>Description of the Roles Screen</H2>
9469
9470 With this screen you select a role to be used in the composition of a
9471 message.
9472 Use the Previous and Next commands to highlight the role you wish to
9473 use.
9474 When you type carriage return you will be placed in the composer using the highlighted role.
9475 <P>
9476 You don't have any non-default <A HREF="h_rules_roles">roles</A>
9477 available unless you set them up.
9478 You may do so by using the Setup/Rules command on the MAIN MENU.
9479 <P>
9480 By using the D command, you may set a default role that will persist until
9481 you change it or until you exit Alpine.
9482 The D command toggles through three states: set the default role, unset the
9483 default role, and leave the default role as it is.
9484 <P><UL>
9485 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
9486 </UL>
9487 <P>
9488 &lt;End of help on this topic&gt;
9489 </BODY>
9490 </HTML>
9491 ===== h_role_abook_select =====
9492 <HTML>
9493 <HEAD>
9494 <TITLE>SELECT ADDRESS BOOK SCREEN</TITLE>
9495 </HEAD>
9496 <BODY>
9497 <H1>SELECT ADDRESS BOOK SCREEN</H1>
9498 <H2>COMMANDS</H2>
9499 <!--chtml if pinemode="function_key"-->
9500 <PRE>
9501 Available  Commands
9502 -------------------------------
9503 F1  Show Help Text
9504 F3  Exit screen without selecting anything
9505 F4  Select highlighted address book
9506 F5  Move to previous address book
9507 F6  Move to next address book
9508 F7  Previous page of address books
9509 F8  Next page of address books
9510 F12 Whereis
9511 </PRE>
9512 <!--chtml else-->
9513 <PRE>
9514 Navigation                     General Alpine Commands
9515 -------------------------      -----------------------
9516  P  Previous addrbook          ?  Display this help text
9517  N  Next addrbook
9518  -  Previous page
9519 Spc (space bar) Next page
9520  W  WhereIs
9521
9522 Select Role Commands
9523 ------------------------------------------------
9524  S  Select highlighted address book
9525  E  Exit screen without selecting anything
9526 </PRE>
9527 <!--chtml endif-->
9528
9529 <H2>Description of the Select Address Book Screen</H2>
9530
9531 This screen helps you select one of your address books.
9532 Use the Previous and Next commands to highlight the address book you wish to
9533 select.
9534 <P><UL>
9535 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
9536 </UL>
9537 <P>
9538 &lt;End of help on this topic&gt;
9539 </BODY>
9540 </HTML>
9541 ======== h_rule_patterns =============
9542 <HTML>
9543 <HEAD>
9544 <TITLE>PATTERNS</TITLE>
9545 </HEAD>
9546 <BODY>
9547 <H1>PATTERNS</H1>
9548 Patterns are used with Roles, Filtering, Index Coloring,
9549 Scoring, Other Rules, and Search Rules.
9550 Patterns are compared with a message to see if there is a match.
9551 For Filtering, the messages being checked are all the messages in the
9552 folder, one at a time.
9553 For Index Line Coloring, each message that is visible on the screen is
9554 checked for matches with the Index Coloring Patterns.
9555 Roles are used with the Reply, Forward, and Compose commands.
9556 For Reply, the message used to compare the Pattern with is the message
9557 being replied to;
9558 for Forward, the message used to compare the Pattern with is the message
9559 being forwarded;
9560 and for Compose, there is no message, so the parts of the Pattern that depend
9561 on a message (everything other than Current Folder Type and the
9562 Beginning of Month and Year)
9563 are not used.
9564 Only the Current Folder Type matters for Compose (plus the Beginning of
9565 Month or Year, which you wouldn't usually use for a Role).
9566 For Scoring, the message being scored is compared with all of the Score
9567 Patterns, and the Score Values from the ones that match are added together to
9568 get the message's score.
9569 For Other Rules, there is no message. Only the Current Folder Type is checked
9570 for Other Rules.
9571 <P>
9572 Each Pattern has several possible parts, all of which are optional.
9573 In order for there to be a match, <EM>ALL</EM> of the
9574 <EM>defined</EM> parts of the Pattern must match the message.
9575 If a part is not defined it is considered a match, but note that a filtering
9576 Pattern must have at least one defined part or it will be ignored.
9577 For example, if the To pattern is not defined it will be
9578 displayed as
9579 <P>
9580 <CENTER>To pattern = &lt;No Value Set&gt;</CENTER>
9581 <P>
9582 That is considered a match because it is not defined.
9583 This means that the Pattern with nothing defined is a match if the
9584 Current Folder Type matches, but there is an exception that was mentioned
9585 in the previous paragraph.
9586 Because filtering is a potentially destructive action, filtering Patterns
9587 with nothing other than Current Folder Type defined are ignored.
9588 If you really want a filtering Pattern to match all messages (subject to
9589 Current Folder Type) the best way to do it is to define a Score interval
9590 that includes all possible scores.
9591 This would be the score interval <SAMP>(-INF,INF)</SAMP>.
9592 This can be used even if you haven't defined any rules to Set Scores.
9593 <P>
9594 There are six predefined header patterns called the To, From, Sender, Cc, News,
9595 and Subject patterns.
9596 Besides those six predefined header patterns, you may add
9597 additional header patterns with header fieldnames of your choosing.
9598 You add an extra header pattern by placing the cursor on one of the
9599 patterns while in the role editor and using the &quot;eXtraHdr&quot; command.
9600 The Recip pattern is a header pattern that stands for Recipient (To OR Cc)
9601 and the Partic pattern is a header pattern that stands for
9602 Participant (From OR To OR Cc).
9603 (Defining the Recip pattern does not have the same effect as defining both
9604 the To and Cc patterns. Recip is To <EM>OR</EM> Cc, not To <EM>AND</EM> Cc.)
9605 Similar to the header patterns are the AllText pattern and the BodyText pattern.
9606 Instead of comparing this pattern's text against only the contents of
9607 a particular header field, the text for the AllText pattern is compared
9608 with text anywhere in the message's header or body, and the text for the
9609 BodyText pattern is compared with text anywhere in the message's body.
9610 <P>
9611 Any of the header patterns, the AllText pattern, or the BodyText pattern may be negated with the
9612 &quot;!&quot; &quot;toggle NOT&quot; command.
9613 You can tell that <EM>NOT</EM> has been turned on by looking for the character
9614 &quot;!&quot; at the beginning of the pattern line.
9615 When the &quot;!&quot; is present, it reverses the meaning of the match.
9616 That is, if the pattern matches then it is considered to NOT be a match, and
9617 if it does not match it is considered to be a match.
9618 <P>
9619 Don't make the mistake of putting the &quot;!&quot; in the data field for
9620 a pattern.
9621 For example, if you type the characters &quot;!urgent&quot; into the Subject
9622 pattern, the pattern will look like:
9623 <P>
9624 <PRE>
9625  Subject pattern = !urgent
9626 </PRE>
9627 <P>
9628 This means you want to match the 7 character sequence &quot;!urgent&quot;.
9629 In order to match messages that do not have &quot;urgent&quot; in
9630 their Subject field, first type the characters &quot;urgent&quot; followed
9631 by carriage return for the value of the Subject pattern, then negate it
9632 by typing the &quot;!&quot; command.
9633 It should look like
9634 <P>
9635 <PRE>
9636  ! Subject pattern = urgent
9637 </PRE>
9638 <P>
9639 The contents of each of these header patterns (or the AllText or BodyText patterns) may
9640 be a complete email address, part of an address, or a random set of
9641 characters to match against.
9642 It may also be a list of such patterns, which means you
9643 are looking for a match against the first pattern in the list <EM>OR</EM>
9644 the second pattern <EM>OR</EM> the third and so on.
9645 For example, a Subject pattern equal to
9646 <P>
9647 <PRE>
9648  Subject pattern = urgent
9649                    emergency
9650                    alert
9651 </PRE>
9652 <P>
9653 would match all messages with a subject that contained at least one
9654 of those words.
9655 It would also match subjects containing the words &quot;alerts&quot; or
9656 &quot;Urgently&quot;.
9657 <P>
9658 The same example with &quot;NOT&quot; turned on would be
9659 <P>
9660 <PRE>
9661  ! Subject pattern = urgent
9662                      emergency
9663                      alert
9664 </PRE>
9665 <P>
9666 which would match all messages with a subject that did <EM>NOT</EM> contain any of
9667 those words.
9668 You can use the &quot;Add Value&quot; command to add new words to the list,
9669 or you can enter them as a comma-separated list.
9670 <P>
9671 (It is not possible to specify two patterns that must <EM>BOTH</EM> be
9672 present for a match.
9673 It is only possible to specify that <EM>EITHER</EM> pattern1 <EM>OR</EM>
9674 pattern2 must be present,
9675 and that is exactly what using a list does.)
9676 <P>
9677 The &quot;Current Folder Type&quot; and the &quot;Score Interval&quot; are
9678 also part of the Pattern, although the &quot;Score Interval&quot; is not used
9679 when checking for matches for Scoring.
9680 There are five similar settings that relate to the status of the message.
9681 These settings rely on the message being New or not, Deleted or not,
9682 Answered or not, Important or not, and Recent or not.
9683 There are also some other miscellaneous settings.
9684 The first is the Age of the message in days.
9685 Another is the Size of the message, in bytes.
9686 The third is a setting that detects whether or not the Subject of a
9687 message contains raw 8-bit characters (unencoded characters with the most
9688 significant bit set).
9689 There is a setting that detects whether or not this is the first time
9690 Alpine has been run this month (doesn't depend on individual messages),
9691 and another that detects whether or not this is the first time Alpine has
9692 been run this year.
9693 Other parts of the Pattern detect whether or not the From address of a
9694 message appears in your address book, whether or not certain keywords
9695 are set for a message, and whether or not certain character sets are
9696 used in a message.
9697
9698 <H2>Parts of a Pattern</H2>
9699
9700 <H3>Header patterns</H3>
9701
9702 A header pattern is simply text that is searched for in the corresponding
9703 header field.
9704 For example, if a Pattern has a From header pattern with the value
9705 &quot;@company.com&quot;, then only messages that have a From header
9706 that contains the text &quot;@company.com&quot; will be possible
9707 matches.
9708 Matches don't have to be exact.
9709 For example, if the relevant field of a message contains the text
9710 &quot;mailbox@domain&quot; somewhere
9711 in it, then header patterns of &quot;box&quot;, or &quot;x@d&quot;, or
9712 &quot;mailbox@domain&quot; are all matches.
9713 <P>
9714 All parts of the Pattern must match so, for example,
9715 if a message matches a defined
9716 From pattern, it still must be checked against the other parts of the
9717 Pattern that have been defined.
9718 The To header pattern is a slightly special case.
9719 If the message being checked has a Resent-To header
9720 and the feature <A HREF="h_config_use_resentto"><!--#echo var="FEAT_use-resent-to-in-rules"--></A> is turned on, the addresses
9721 there are used in place of the addresses in the To header.
9722 This is only true for the To header.
9723 Resent-cc and Resent-From headers are never used unless you add them
9724 with the eXtraHdrs command.
9725 <P>
9726 The meaning of a header pattern may be negated with the
9727 &quot;!&quot; &quot;toggle NOT&quot; command.
9728 You can tell that <EM>NOT</EM> has been turned on by looking for the character
9729 &quot;!&quot; at the beginning of the pattern line.
9730 It would look something like
9731 <P>
9732 <PRE>
9733  ! From pattern = susan@example.com
9734 </PRE>
9735 <P>
9736 When the &quot;!&quot; is present, it reverses the meaning of the match.
9737 <P>
9738 If you want to check for the presence of a header field but don't care
9739 about its value, then
9740 the empty pattern that you get by entering a pair of
9741 double quotes (&quot;&quot;) should match any message that
9742 has the corresponding header field.
9743
9744 <H3><A NAME="pattern_alltext">AllText patterns</A></H3>
9745
9746 AllText patterns are just like header patterns except that the text is
9747 searched for anywhere in the message's headers or body, not just in the
9748 contents of a particular header field.
9749 <P>
9750
9751 <H3><A NAME="pattern_bodytext">BodyText patterns</A></H3>
9752
9753 BodyText patterns are just like header patterns except that the text is
9754 searched for anywhere in the message's body, not just in the
9755 contents of a particular header field.
9756 <P>
9757
9758 If there is more than one header pattern or AllText pattern or BodyText pattern
9759 for which you want to take the
9760 same action there is a shorthand notation that may be used.
9761 Any of these patterns may be a list of patterns instead of
9762 just a single pattern.
9763 If any one of the patterns in the list matches the message
9764 then it is considered a match.
9765 For example, if &quot;company1&quot; and &quot;company2&quot; both required
9766 you to use the same role when replying to messages, you might have
9767 a To pattern that looks like
9768 <P>
9769 <PRE>
9770  To pattern = company1.com
9771               company2.com
9772 </PRE>
9773 <P>
9774 This means that if the mail you are replying to was addressed to
9775 either &quot;anything@company1.com&quot; or &quot;anything@company2.com&quot;,
9776 then this Pattern is a match and the same actions will be taken.
9777 <P>
9778 The meaning of an AllText or BodyText pattern may be negated with the
9779 &quot;!&quot; &quot;toggle NOT&quot; command.
9780 You can tell that <EM>NOT</EM> has been turned on by looking for the character
9781 &quot;!&quot; at the beginning of the pattern line.
9782 When the &quot;!&quot; is present, it reverses the meaning of the match.
9783 <P>
9784 A technicality: Since comma is the character used to separate multiple values
9785 in any of the fields that may have multiple values (such as header patterns,
9786 AllText patterns, BodyText patterns, keywords, folder lists, and so on),
9787 you must escape comma with a
9788 backslash (&#92;) if you want to include a literal comma in one of those fields.
9789 In other words, if you type a backslash followed by a comma it will
9790 be interpreted as a comma by Alpine, instead of as a separator between
9791 pattern values.
9792 All other backslashes (those not followed by a comma) are literal
9793 backslashes and should not be escaped.
9794 It's unlikely you'll ever need to enter a literal comma or backslash in
9795 any of the patterns.
9796
9797 <H3><A NAME="pattern_current_folder">Current Folder Type</A></H3>
9798
9799 The &quot;Current Folder Type&quot; may be set to one of four different
9800 values: &quot;Any&quot;, &quot;News&quot;, &quot;Email&quot;, or
9801 &quot;Specific&quot;.
9802 If the value is set to &quot;News&quot;, then the
9803 Pattern will only match if the currently open folder is a newsgroup.
9804 The value &quot;Email&quot; only matches if the current folder is not news and
9805 the value &quot;Any&quot; causes any folder to match.
9806 If the value of &quot;Current Folder Type&quot; is set to &quot;Specific&quot;,
9807 then you must fill in a value for &quot;Folder&quot;, which is on the line
9808 below the &quot;Specific&quot; line.
9809 In this case you will only get a match if the currently open folder is
9810 the specific folder you list.
9811 You may give a list of folders instead of just a single
9812 folder name, in which case the Pattern will match if the open folder is
9813 any one of the folders in the list.
9814 The name of each folder in the list may be either &quot;INBOX&quot;,
9815 the technical specification
9816 of the folder (like what appears in your configuration file) or, if the
9817 folder is one of your incoming folders, it may be the nickname you've given
9818 the folder.
9819 Here are some samples of specific folder names:
9820 <P>
9821 <CENTER><SAMP>{monet.art.example.com}mail/art-class</SAMP></CENTER>
9822 <P>
9823 <CENTER><SAMP>{news.example.com/nntp}#news.comp.mail.pine</SAMP></CENTER>
9824 <P>
9825 <CENTER><SAMP>mail/local-folder</SAMP></CENTER>
9826 <P>
9827 The easiest way to fill in the &quot;Folder&quot; field is to use
9828 the &quot;T&quot; command that is available when the &quot;Folder&quot; line is
9829 highlighted, or to use the &quot;Take&quot; command with the configuration
9830 feature
9831 <A HREF="h_config_enable_role_take">&quot;<!--#echo var="FEAT_enable-rules-under-take"-->&quot;</A>
9832 turned on.
9833 <P>
9834 When reading a newsgroup, there may be a performance penalty
9835 incurred when collecting the information necessary to check whether
9836 or not a Pattern matches a message.
9837 For this reason, the default Current Folder Type is set to &quot;Email&quot;.
9838 If you have Patterns with a Current Folder Type of either
9839 &quot;Any&quot; or &quot;News&quot; and those Patterns are used for
9840 Index Line Coloring or Scoring, you may experience
9841 slower screen redrawing in the MESSAGE INDEX screen when in a newsgroup.
9842
9843 <H3><A NAME="pattern_age_interval">Age Interval</A></H3>
9844
9845 The &quot;Age Interval&quot; may be set to an interval of message
9846 ages that should be considered a match.
9847 Like the other parts of the Pattern, if it is unset it will be ignored.
9848 The Age Interval looks like
9849 <P>
9850 <CENTER><SAMP>(min_age,max_age)</SAMP></CENTER>
9851 <P>
9852 where &quot;min_age&quot; and &quot;max_age&quot; are integers greater
9853 than or equal to zero.
9854 The special value &quot;INF&quot; may be used for
9855 the max value. It represents infinity.
9856 <P>
9857 Actually, this option may be defined as a list of intervals instead
9858 of just a single interval.
9859 The list is separated by commas.
9860 It can look like
9861 <P>
9862 <CENTER><SAMP>(min_age1,max_age1),(min_age2,max_age2),...</SAMP></CENTER>
9863 <P>
9864 When there is an Age Interval defined, it is a match if the age, in days, of
9865 the message is contained in any of the intervals.
9866 The intervals include both endpoints.
9867 <P>
9868 Even though this option is called Age, it isn't actually
9869 the <EM>age</EM> of the message.
9870 Instead, it is how many days ago the message arrived in one of your folders.
9871 If the current time is a little past midnight, then a message that arrived
9872 just before midnight arrived yesterday, even though the message is only
9873 a few minutes old.
9874 By default, the date being used is not the date in the Date
9875 header of the message.
9876 It is the date that the message arrived in one of your folders.
9877 When you Save a message from one folder to another that arrival date
9878 is preserved.
9879 If you would like to use the date in the Date header that is possible.
9880 Turn on the option
9881 <A HREF="h_config_filt_opts_sentdate">&quot;Use-Date-Header-For-Age&quot;</A>
9882 near the bottom of the rule definition.
9883 A value of 0 is today, 1 is yesterday, 2 is the day before yesterday, and so on.
9884
9885 <H3><A NAME="pattern_size_interval">Size Interval</A></H3>
9886
9887 The &quot;Size Interval&quot; may be set to an interval of message
9888 sizes that should be considered a match.
9889 Like the other parts of the Pattern, if it is unset it will be ignored.
9890 The Size Interval looks like
9891 <P>
9892 <CENTER><SAMP>(min_size,max_size)</SAMP></CENTER>
9893 <P>
9894 where &quot;min_size&quot; and &quot;max_size&quot; are integers greater
9895 than or equal to zero.
9896 The special value &quot;INF&quot; may be used for
9897 the max value. It represents infinity.
9898 <P>
9899 Actually, this option may be defined as a list of intervals instead
9900 of just a single interval.
9901 The list is separated by commas.
9902 It can look like
9903 <P>
9904 <CENTER><SAMP>(min_size1,max_size1),(min_size2,max_size2),...</SAMP></CENTER>
9905 <P>
9906 When there is a Size Interval defined, it is a match if the size, in bytes, of
9907 the message is contained in any of the intervals.
9908 The intervals include both endpoints.
9909
9910 <H3><A NAME="pattern_score_interval">Score Interval</A></H3>
9911
9912 The &quot;Score Interval&quot; may be set to an interval of message
9913 scores that should be considered a match.
9914 Like the other parts of the Pattern, if it is unset it will be ignored.
9915 The Score Interval looks like
9916 <P>
9917 <CENTER><SAMP>(min_score,max_score)</SAMP></CENTER>
9918 <P>
9919 where &quot;min_score&quot; and &quot;max_score&quot; are positive or
9920 negative integers, with min_score less than or equal to max_score.
9921 The special values &quot;-INF&quot; and &quot;INF&quot; may be used for
9922 the min and max values to represent negative and positive infinity.
9923 <P>
9924 Actually, a list of intervals may be used if you wish.
9925 A list would look like
9926 <P>
9927 <CENTER><SAMP>(min_score1,max_score1),(min_score2,max_score2),...</SAMP></CENTER>
9928 <P>
9929 When there is a Score Interval defined, it is a match if the score for
9930 the message is contained in any of the intervals in the list.
9931 The intervals include the endpoints.
9932 The score for a message is calculated by looking at every Score rule defined and
9933 adding up the Score Values for the ones that match the message.
9934 When deciding whether or not a Pattern matches a message for purposes of
9935 calculating the score, the Score Interval is ignored.
9936
9937 <H3><A NAME="pattern_message_status">Message Status</A></H3>
9938
9939 There are five separate message status settings.
9940 By default, all five are set to the value &quot;Don't care&quot;, which
9941 will match any message.
9942 The value &quot;Yes&quot; means that the particular status must be true
9943 for a match, and the value &quot;No&quot; means that the particular
9944 status must not be true for a match.
9945 For example, one of the five Message Status settings is whether a message
9946 is marked Important or not.
9947 A &quot;Yes&quot; means that the message must be Important to be
9948 considered a match and &quot;No&quot; means that the message must not be
9949 Important to be considered a match.
9950 The same is true of the other four message status settings that depend
9951 on whether or not the message is New; whether the message has
9952 been Answered or not; whether the message has been Deleted or not, and
9953 whether the message is Recent or not.
9954 <P>
9955 The nomenclature for New and Recent is a bit confusing:
9956 <P>
9957 New means that the message is Unseen.
9958 It could have been in your mailbox for a long time but if you haven't looked
9959 at it, it is still considered New.
9960 That matches the default Alpine index display that shows an N for such a
9961 message.
9962 <P>
9963 Recent means that the message was added to this folder since the last time
9964 you opened the folder.
9965 Alpine also shows an N by default for these types of messages.
9966 If you were to run two copies of Alpine that opened a folder one right after
9967 the other, a message would only show up as Recent in (at most) the first
9968 Alpine session.
9969
9970 <H3><A NAME="pattern_message_keywords">Message Keywords</A></H3>
9971
9972 Keywords are similar to Message Status, but they are chosen by the user.
9973 Provided the mail server allows for it, you may add a set of possible keywords
9974 to a folder and then you may set those keywords or not for each message
9975 in the folder (see <A HREF="h_common_flag">Flag Command</A>).
9976 The syntax of this part of the Pattern is similar to the header patterns.
9977 It is a list of keywords.
9978 The Keyword part of the Pattern is a match if the message has any of
9979 the keywords in the list set.
9980 Like other parts of the Pattern, if this is unset it will be ignored.
9981
9982 <H3><A NAME="pattern_message_charsets">Message Character Sets</A></H3>
9983
9984 A message may use one or more character sets.
9985 This part of the Pattern matches messages that make use of one or more of
9986 the character sets specified in the pattern.
9987 It will be considered a match if a message uses any of the character
9988 sets in the list you give here.
9989
9990 <P>
9991 Besides actual character set names (for example, ISO-8859-7, KOI8-R, or
9992 GB2312) you may also use some shorthand names that Alpine provides.
9993 These names are more understandable shorthand names for sets of
9994 character set names.
9995 Two examples are &quot;Cyrillic&quot; and &quot;Greek&quot;.
9996 Selecting one of these shorthand names is equivalent to selecting all of
9997 the character sets that make up the set.
9998 You can see all of these shorthand names and the lists of character sets
9999 they stand for by typing the &quot;T&quot; command with the Character
10000 Set pattern highlighted.
10001 The syntax of this part of the Pattern is similar to the header patterns
10002 and the Message Keywords pattern.
10003 It is a list of character sets (or shorthand names).
10004 The Character Set part of the Pattern is a match if the message uses any
10005 of the character sets in the list.
10006 Like other parts of the Pattern, if this is unset it will be ignored.
10007
10008 <H3><A NAME="pattern_8bit_subject">Raw 8-bit in Subject</A></H3>
10009
10010 It seems that lots of unwanted email contains unencoded 8-bit characters
10011 in the Subject.
10012 Normally, characters with the 8th bit set are not allowed in the Subject
10013 header unless they are MIME-encoded.
10014 This option gives you a way to match messages that have Subjects that
10015 contain unencoded 8-bit characters.
10016 By default, the value of this option is &quot;Don't care&quot;, which
10017 will match any message.
10018 The value &quot;Yes&quot; means that there must be raw 8-bit characters in
10019 the Subject of the message in order for there to be a match,
10020 and the value &quot;No&quot; is the opposite.
10021 Setting this option will affect performance in large folders because the
10022 subject of each message in the folder has to be checked.
10023
10024 <H3><A NAME="pattern_bom">Beginning of Month</A></H3>
10025
10026 This option gives you a way to take some action once per month.
10027 By default, the value of this option is &quot;Don't care&quot;, which
10028 will always match.
10029 The value &quot;Yes&quot; means that this must be the first time Alpine has
10030 been run this month in order to count as a match,
10031 and the value &quot;No&quot; is the opposite.
10032
10033 <H3><A NAME="pattern_boy">Beginning of Year</A></H3>
10034
10035 This option gives you a way to take some action once per year.
10036 By default, the value of this option is &quot;Don't care&quot;, which
10037 will always match.
10038 The value &quot;Yes&quot; means that this must be the first time Alpine has
10039 been run this year in order to count as a match,
10040 and the value &quot;No&quot; is the opposite.
10041
10042 <H3><A NAME="pattern_abookfrom">Address in Address Books</A></H3>
10043
10044 This option gives you a way to match messages that have an address
10045 that is in one of your address books.
10046 Only the simple entries in your address books are searched.
10047 Address book distribution lists are ignored!
10048 By default, the value of this option is &quot;Don't care&quot;, which
10049 will match any message.
10050 The value &quot;Yes, in any address book&quot; means the address
10051 from the message must be in at least one of your
10052 address books in order to be a match.
10053 The value &quot;No, not in any address book&quot;
10054 means none of the addresses may
10055 be in any of your address books in order to be a match.
10056 The values &quot;Yes, in specific address books&quot; and
10057 &quot;No, not in any of specific address books&quot; are similar but instead
10058 of depending on all address books you are allowed to give a list of address
10059 books to look in.
10060 The addresses from the message that are checked for are determined by the
10061 setting you have for &quot;Types of addresses to check for in address book&quot;.
10062 If you set this to &quot;From&quot; the From address from the message will
10063 be looked up in the address book.
10064 If you set it to only &quot;To&quot; then the To addresses will be used.
10065 If any of the To addresses are in the address book then it is considered
10066 a match for &quot;Yes&quot; or not a match for &quot;No&quot;.
10067 You could set it to both From and To, in which case all of the From and To
10068 addresses are used.
10069 The &quot;Reply-To&quot; and &quot;Sender&quot; cases are a little unusual.
10070 Due to deficiencies in our tools, Reply-To uses the Reply-To address if it
10071 exists or the From address if there is no Reply-To address.
10072 Same for the Sender address.
10073 Setting this option may affect performance in large folders because the
10074 From and Reply-To of each message in the folder have to be checked.
10075
10076 <H3><A NAME="pattern_categorizer">Categorizer Command</A></H3>
10077
10078 This is a command that is run with its standard input set to the message
10079 being checked and its standard output discarded.
10080 The full directory path should be specified.
10081 The command will be run and then its exit status will be checked against
10082 the Exit Status Interval, which defaults to just the value zero.
10083 If the exit status of the command falls in the interval, it is considered
10084 a match, otherwise it is not a match.
10085 <P>
10086
10087 This option may actually be a list of commands.
10088 The first one that exists and is executable is used.
10089 That makes it possible to use the same configuration with Unix Alpine and
10090 PC-Alpine.
10091 <P>
10092
10093 If none of the commands in the list exists and is executable then the rule
10094 is <EM>not</EM> a match.
10095 If it is possible that the command may not exist, you should be careful
10096 to structure your rules so that nothing destructive
10097 happens when the command does not exist.
10098 For example, you might have a filter that filters away spam when there is
10099 a match but does nothing when there is not a match.
10100 That would continue to work correctly if the command didn't exist.
10101 However, if you have a filter that filters away spam when there is not
10102 a match and keeps it when there is a match, that would filter everything
10103 if the categorizer command didn't exist.
10104 <P>
10105 Here is an <A HREF="h_config_role_cat_cmd_example">example</A>
10106 setup for the bogofilter filter.
10107
10108 <P>
10109 &lt;End of help on this topic&gt;
10110 </BODY>
10111 </HTML>
10112 ===== h_rules_roles =====
10113 <HTML>
10114 <HEAD>
10115 <TITLE>SETUP ROLES SCREEN</TITLE>
10116 </HEAD>
10117 <BODY>
10118 <H1>SETUP ROLES SCREEN</H1>
10119 <H2>SETUP ROLES COMMANDS</H2>
10120 <!--chtml if pinemode="function_key"-->
10121 <PRE>
10122 Available  Commands -- Group 1         Available Commands -- Group 2
10123 -------------------------------        ------------------------------
10124 F1  Show Help Text                      F1  Show Help Text
10125 F2  See commands in next group          F2  See commands in next group
10126 F3  Back to MAIN Alpine menu
10127 F4  Change configuration for role
10128 F5  Move to previous role               F5  Include file in role config
10129 F6  Move to next role                   F6  Exclude file from config
10130 F7  Previous page of roles
10131 F8  Next page of roles
10132 F9  Add new role                        F9  Replicate existing role
10133 F10 Delete existing role
10134 F11 Shuffle the order of roles
10135 F12 Whereis (search role nicknames)
10136 </PRE>
10137 <!--chtml else-->
10138 <PRE>
10139 Navigation                     General Alpine Commands
10140 -------------------------      -----------------------
10141  P  Prev Role                     ?  Display this help text
10142  N  Next Role                     E  Back to MAIN Alpine menu
10143  -  Previous page
10144 Spc (space bar) Next page
10145  W  WhereIs (search for word in role nicknames)
10146
10147 Setup Roles Commands
10148 ------------------------------------------------
10149  A  Add new role                  $  Shuffle the order of roles
10150  D  Delete existing role          C  Change configuration for highlighted role
10151  R  Replicate existing role
10152  I  Include file in role config   X  Exclude file from role config
10153 </PRE>
10154 <!--chtml endif-->
10155
10156 <H2>Description of the Setup Roles Screen</H2>
10157
10158 This screen lets you add, delete, modify, or change the order of the rules
10159 that determine the role you are playing when composing a message.
10160 <P>
10161 You may play different roles depending on who you are replying to.
10162 For example, if you are replying to a message addressed to help-desk you
10163 may be acting as a Help Desk Worker.
10164 That role may require that you use a different return address and/or
10165 a different signature.
10166 <P>
10167 Roles are optional.
10168 If you set up roles they work like this:  Each role has a set of
10169 &quot;Uses&quot;, which indicate whether or not a role is eligible to be
10170 considered for a particular use; a &quot;Pattern&quot;,
10171 which is used to decide which of the eligible roles is used; and a set
10172 of &quot;Actions&quot;, which are taken when that role is used.
10173 When you reply to a message, the message you are replying to is compared
10174 with the Patterns of the roles marked as eligible for use when replying.
10175 The comparisons start with the first eligible role and keep going until there
10176 is a match.
10177 If a match is found, the matching role's Actions are taken.
10178 <P>
10179 It is also possible to set a default role and to change that role during
10180 your Alpine session.
10181 When you start Alpine no default role will be set.
10182 You may set or change the current default role by using the &quot;D&quot;
10183 command in the role selection screen.
10184 You'll see that screen while composing a message and being asked to select
10185 a role.
10186 An easy way to get to that screen is to use the <A HREF="h_common_role">Role Command</A> to
10187 compose a message.
10188 You may find a default role useful if you normally perform the duties of one
10189 of your roles for a while, then you switch to another role and stay in the
10190 new role for another period of time.
10191 It may be easier than using the Role Command to select the role each time you
10192 compose a message.
10193
10194 <H2>Role Uses</H2>
10195
10196 There are three types of use to be configured;
10197 one for Replying, one for Forwarding, and one for Composing.
10198 These indicate whether or not you want a role to be considered when you
10199 type the Reply, Forward, or Compose commands.
10200 (The Role command is an alternate form of the Compose command, and it is
10201 not affected by these settings.)
10202 Each of these Use types has three possible values.
10203 The value &quot;Never&quot;
10204 means that the role will never be considered as a candidate for use with
10205 the corresponding command.
10206 For example, if you set a role's Reply Use to Never, then when you Reply to
10207 a message, that role won't even be considered.
10208 (That isn't quite true. If the message you are replying to matches some other
10209 role that requires confirmation,
10210 then there will be a ^T command available which allows you to select a role
10211 from all of your roles, not just the reply-eligible roles.)
10212 <P>
10213
10214 The options &quot;With confirmation&quot; and &quot;Without confirmation&quot;
10215 both mean that you do want to consider this role when using the corresponding
10216 command.
10217 For either of these settings the role's Pattern will
10218 be checked to see if it matches the message.
10219 For Reply Use, the message used to compare the Pattern with is the message
10220 being replied to.
10221 For Forward Use, the message used to compare the Pattern with is the message
10222 being forwarded.
10223 For Compose Use, there is no message, so the parts of the Pattern that depend
10224 on a message (everything other than Current Folder Type) are ignored.
10225 In all cases, the Current Folder Type is checked if defined.
10226 If there is a match then this role will either be used without confirmation
10227 or will be the default when confirmation is asked for, depending on
10228 which of the two options is selected.
10229 If confirmation is requested, you will have a chance to
10230 choose No Role instead of the offered role, or to
10231 change the role to any one of your other roles (with the ^T command).
10232
10233 <H2>Role Patterns</H2>
10234
10235 In order to determine whether or not a message matches a role the message is
10236 compared with the Role's Pattern.
10237 These Patterns are the same for use with Roles, Filtering, Index Coloring,
10238 Scoring, Other Rules, and Search Rules, so are described in only one place,
10239 &quot;<A HREF="h_rule_patterns">here</A>&quot;.
10240 <P>
10241 Since header patterns, AllText patterns, and BodyText patterns that are unset are ignored,
10242 a role that has all header patterns unset, the AllText pattern unset,
10243 the BodyText pattern unset,
10244 the Score Interval unset, and the Current Folder Type set to
10245 &quot;Any&quot; may be used as a default role.
10246 It should be put last in the list of roles since the matching
10247 starts at the beginning and proceeds until one of the roles is a match.
10248 If no roles at all match, then Alpine will
10249 use its regular methods of defining the role.
10250 If you wanted to, you could define a different &quot;default&quot; role
10251 for Replying, Forwarding, and Composing by setting the
10252 &quot;Use&quot; fields appropriately.
10253
10254 <H2>Role Actions</H2>
10255
10256 Once a role match is found, the role's Actions are taken.
10257 For each role there are several possible actions that may be defined.
10258 They are actions to set the From address, the Reply-To address,
10259 the Fcc, the Signature, the Template file, and Other Headers.
10260
10261 <H3>Set From</H3>
10262
10263 The From address is the address used on the From line of the message
10264 you are sending.
10265
10266 <H3>Set Reply-To</H3>
10267
10268 The Reply-To address is the address used on the Reply-To line of the message
10269 you are sending.
10270 You don't need a Reply-To address unless it is different from the From address.
10271
10272 <H3>Set Other Headers</H3>
10273
10274 If you want to set the value of the From or Reply-To headers, use
10275 the specific fields &quot;Set From&quot; or &quot;Set Reply-To&quot;.
10276 If you want to set the values of other headers, use this field.
10277 This field is similar to the
10278 <A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A> configuration option.
10279 Each header you specify here must include the header tag
10280 (&quot;To:&quot;, &quot;Approved:&quot;, etc.)
10281 and may optionally include a value for that header.
10282 It is different from the <!--#echo var="VAR_customized-hdrs"--> in that the value you give
10283 for a header here will replace any value that already exists.
10284 For example, if you are Replying to a message there will be at least one
10285 address in the To header (the address you are Replying to).
10286 However, if you Reply using a role that sets the To header, that role's
10287 To header value will be used instead.
10288
10289 <H3>Set Fcc</H3>
10290
10291 The Fcc is used as the Fcc for the message you are sending.
10292
10293 <H3>Set Signature or Set LiteralSig</H3>
10294
10295 The Signature is the name of a file to be used as the signature file when
10296 this role is being used.
10297 If the name of the file has a vertical bar following it (|)
10298 then it is assumed that the file is a program that should be run to
10299 produce the signature.
10300 If the LiteralSig is set, then it is used instead of the signature file.
10301 LiteralSig is just a different way to store the signature.
10302 It is stored in the pine configuration file instead of in a separate
10303 signature file.
10304 If the <A HREF="h_config_literal_sig"><!--#echo var="VAR_literal-signature"--></A> option is defined
10305 either in the role or as the default signature in the Setup/Config screen,
10306 then the signature file is ignored.
10307
10308 <H3>Set Template</H3>
10309
10310 A Template is the name of a file to be included in the message when this
10311 role is being used.
10312 If the name of the file has a vertical bar following it (|)
10313 then it is assumed that the file is a program that should be run to
10314 produce the template.
10315
10316 <P>
10317 Both signature files and template files may be stored remotely on an IMAP
10318 server.
10319 In order to do that you just give the file a remote name.
10320 This works just like the regular
10321 <A HREF="h_config_signature_file"><!--#echo var="VAR_signature-file"--></A>
10322 option that is configured from the Setup/Configuration screen.
10323 A remote signature file name might look like:
10324 <P>
10325 <CENTER><SAMP>{myimaphost.myschool.k12.wa.us}mail/sig3</SAMP></CENTER>
10326 <P>
10327 Once you have named the remote signature or template file you create its
10328 contents by using the &quot;F&quot; &quot;editFile&quot; command when the
10329 cursor is on the &quot;Set Signature&quot; or &quot;Set Template&quot;
10330 line of the role editor.
10331
10332 <P>
10333 Both signature files and template files (or the output of signature programs
10334 and template file programs) may contain special tokens
10335 that are replaced with contents
10336 that depend on the message being replied to or forwarded.
10337 See the help for the individual fields inside the role editor for more
10338 information on tokens.
10339
10340 <H3>Use SMTP Server</H3>
10341
10342 If this field has a value, then it will be used as the SMTP server
10343 to send mail when this role is being used (unless the SMTP server variable
10344 is set in the system-wide fixed configuration file).
10345 It has the same semantics as the
10346 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>
10347 variable in the Setup/Config screen.
10348 When you postpone the composition this SMTP server list will be saved
10349 with the postponed composition and it cannot be changed later.
10350 Because of that, you may want to make this a list of SMTP servers
10351 with the preferred server at the front of the list and alternate servers
10352 later in the list.
10353
10354 <P>
10355 If any of the actions are left unset, then the action depends on what
10356 is present in the &quot;Initialize settings using role&quot; field.
10357 If you've listed the nickname of another one of your roles there, then the
10358 corresponding action from that role will be used here.
10359 If that action is also blank, or if there is no nickname specified,
10360 then Alpine will do whatever it normally does to set these actions.
10361 This depends on other configuration options and features you've set.
10362
10363 <H2>Command Descriptions</H2>
10364
10365 <H3>Add</H3>
10366
10367 The Add command is used to add a new role definition to your set of
10368 roles.
10369 The new role will be added after the highlighted role.
10370
10371 <H3>Delete</H3>
10372
10373 The Delete command deletes the currently highlighted role.
10374
10375 <H3>Change</H3>
10376
10377 The Change command lets you edit the nickname, Uses, Pattern,
10378 and Actions of the currently highlighted role.
10379
10380 <H3>Shuffle</H3>
10381
10382 The Shuffle command allows you to change the order of the roles.
10383 You may move the currently highlighted role up or down in the list.
10384 The order of the roles is important since the roles are tested for a
10385 match starting with the first role and continuing until a match is found.
10386 You should place the roles with more specific Patterns near the beginning
10387 of the list, and those with more general Patterns near the end so that
10388 the more specific matches will happen when appropriate.
10389
10390 <H3>Replicate</H3>
10391
10392 The Replicate command is used to copy an existing role and modify it.
10393 The new role will be added after the highlighted role.
10394
10395 <H3>IncludeFile</H3>
10396
10397 The IncludeFile command allows you to add a roles file to your configuration.
10398 Usually, your roles will be contained in your Alpine configuration file.
10399 If you wish, some or all of your roles may be stored in a separate file.
10400 If a roles file already exists (maybe it was made by somebody else using
10401 Alpine), you may insert it before the currently highlighted role.
10402 You may also insert an empty file or a file that does not yet exist.
10403 Once you have an empty roles file in your configuration, you may use
10404 the Shuffle command to move roles into it.
10405 In fact, that's the only way to get the initial role into the file.
10406
10407 <H3>eXcludeFile</H3>
10408
10409 The eXcludeFile command removes a roles file from your roles configuration.
10410 A limitation of the program is that in order to exclude a roles file
10411 that file must have at least one role
10412 in it, otherwise you won't be able to highlight a line in the file.
10413 So you may have to add a dummy role to the file in order to exclude the file.
10414 <P><UL>
10415 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
10416 </UL>
10417 <P>
10418 &lt;End of help on this topic&gt;
10419 </BODY>
10420 </HTML>
10421 ===== h_rules_other =====
10422 <HTML>
10423 <HEAD>
10424 <TITLE>SETUP OTHER RULES SCREEN</TITLE>
10425 </HEAD>
10426 <BODY>
10427 <H1>SETUP OTHER RULES SCREEN</H1>
10428 <H2>SETUP OTHER RULES COMMANDS</H2>
10429 <!--chtml if pinemode="function_key"-->
10430 <PRE>
10431 Available  Commands -- Group 1         Available Commands -- Group 2
10432 -------------------------------        ------------------------------
10433 F1  Show Help Text                      F1  Show Help Text
10434 F2  See commands in next group          F2  See commands in next group
10435 F3  Back to MAIN Alpine menu
10436 F4  Change configuration for rule
10437 F5  Move to previous rule               F5  Include file in rule config
10438 F6  Move to next rule                   F6  Exclude file from config
10439 F7  Previous page of rules
10440 F8  Next page of rules
10441 F9  Add new rule                        F9  Replicate existing rule
10442 F10 Delete existing rule
10443 F11 Shuffle the order of rules
10444 F12 Whereis (search rule nicknames)
10445 </PRE>
10446 <!--chtml else-->
10447 <PRE>
10448 Navigation                     General Alpine Commands
10449 -------------------------      -----------------------
10450  P  Prev rule                     ?  Display this help text
10451  N  Next rule                     E  Back to MAIN Alpine menu
10452  -  Previous page
10453 Spc (space bar) Next page
10454  W  WhereIs (search for word in rule nicknames)
10455
10456 Setup Other Rules Commands
10457 ------------------------------------------------
10458  A  Add new rule                  $  Shuffle the order of rules
10459  D  Delete existing rule          C  Change configuration for highlighted rule
10460  R  Replicate existing rule
10461  I  Include file in rule config   X  Exclude file from rule config
10462 </PRE>
10463 <!--chtml endif-->
10464
10465 <H2>Description of the Setup Other Rules Screen</H2>
10466
10467 This is where you may set various actions that do not fit well into the
10468 other Rules categories.
10469
10470 <H2>Patterns</H2>
10471
10472 Other Rules are a little different from the rest of the Rules because
10473 they depend only on the current folder, and not on a particular message.
10474 In order to determine whether or not a rule's actions should be applied
10475 the current folder is compared with the rule's Pattern, which consists
10476 of only the Current Folder Type.
10477 Current Folder Type works the same for Other Rules as it does for Roles,
10478 Filtering, Index Coloring, and Scoring.
10479 Keep in mind that the only part of the Pattern that applies to Other
10480 Rules is the Current Folder Type when looking at the description of
10481 Patterns given
10482 &quot;<A HREF="h_rule_patterns">here</A>&quot;.
10483
10484 <H2>The Actions</H2>
10485
10486 <H3>Set Sort Order</H3>
10487
10488 When you enter a new folder, these rules will be checked to see if you
10489 have set a sort order that is different from your default sort order.
10490 The default is set in the Setup/Config screen with
10491 the &quot;<A HREF="h_config_sort_key"><!--#echo var="VAR_sort-key"--></A>&quot; option.
10492 If the Sort Order action is set, then the folder will be displayed sorted in
10493 that sort order instead of in the default order.
10494 <P>
10495 A possible point of confusion arises when you change the configuration
10496 of the Sort Order for the currently open folder.
10497 The folder will normally be re-sorted when you go back to viewing the
10498 index.
10499 However, if you have manually sorted the folder with the
10500 Sort
10501 (<!--chtml if pinemode="function_key"-->F7<!--chtml else-->$<!--chtml endif-->)
10502 command, then it will not be re-sorted until the next time it is opened.
10503
10504 <H3>Set Index Format</H3>
10505
10506 When you enter a new folder, these rules will be checked to see if you
10507 have set an Index Format that is different from your default Index Format,
10508 which is set with the
10509 <A HREF="h_config_index_format">&quot;<!--#echo var="VAR_index-format"-->&quot;</A> option.
10510 If so, the index will be displayed with this format instead of the default.
10511
10512 <H3>Set Startup Rule</H3>
10513
10514 When you enter a new folder, these rules will be checked to see if you
10515 have set a startup rule that is different from the default startup rule.
10516 The default for incoming folders is set in the Setup/Config screen with
10517 the &quot;<!--#echo var="VAR_incoming-startup-rule"-->&quot; option.
10518 The default for folders other than INBOX that are not part of your
10519 incoming collection
10520 (see <A HREF="h_config_enable_incoming"><!--#echo var="FEAT_enable-incoming-folders"--></A> feature)
10521 is to start with the last message in the folder.
10522 If the Startup Rule is set to something other than &quot;default&quot;,
10523 then the rule will determine which message will be the current message when
10524 the folder is first opened.
10525 <P>
10526 The various startup rule possibilities work the same here as they do in
10527 the incoming collection, so check
10528 <A HREF="h_config_inc_startup"><!--#echo var="VAR_incoming-startup-rule"--></A>
10529 for more help.
10530
10531 <H2>Command Descriptions</H2>
10532
10533 <H3>Add</H3>
10534
10535 The Add command is used to add a new rule definition to your set of
10536 rules.
10537 The new rule will be added after the highlighted rule.
10538
10539 <H3>Delete</H3>
10540
10541 The Delete command deletes the currently highlighted rule.
10542
10543 <H3>Change</H3>
10544
10545 The Change command lets you edit the nickname, Pattern,
10546 and Action of the currently highlighted rule.
10547
10548 <H3>Shuffle</H3>
10549
10550 The Shuffle command allows you to change the order of the rules.
10551 You may move the currently highlighted rule up or down in the list.
10552 The order of the rules is important since the rules are tested for a
10553 match starting with the first rule and continuing until a match is found.
10554 You should place the rules with more specific Patterns near the beginning
10555 of the list, and those with more general Patterns near the end so that
10556 the more specific matches will happen when appropriate.
10557
10558 <H3>Replicate</H3>
10559
10560 The Replicate command is used to copy an existing rule definition and modify it.
10561 The new rule will be added after the highlighted rule.
10562
10563 <H3>IncludeFile</H3>
10564
10565 The IncludeFile command allows you to add a rules file to your configuration.
10566 Usually, your rules will be contained in your Alpine configuration file.
10567 If you wish, some or all of your rules may be stored in a separate file.
10568 If a rules file already exists (maybe it was made by somebody else using
10569 Alpine), you may insert it before the currently highlighted rule.
10570 You may also insert an empty file or a file that does not yet exist.
10571 Once you have an empty rules file in your configuration, you may use
10572 the Shuffle command to move rules into it.
10573 In fact, that's the only way to get the initial rule into the file.
10574
10575 <H3>eXcludeFile</H3>
10576
10577 The eXcludeFile command removes a rules file from your rules configuration.
10578 A limitation of the program is that in order to exclude a rules file
10579 that file must have at least one rule
10580 in it, otherwise you won't be able to highlight a line in the file.
10581 So you may have to add a dummy rule to the file in order to exclude the file.
10582 <P><UL>
10583 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
10584 </UL>
10585 <P>
10586 &lt;End of help on this topic&gt;
10587 </BODY>
10588 </HTML>
10589 ===== h_rules_srch =====
10590 <HTML>
10591 <HEAD>
10592 <TITLE>SETUP SEARCH RULES SCREEN</TITLE>
10593 </HEAD>
10594 <BODY>
10595 <H1>SETUP SEARCH RULES SCREEN</H1>
10596 <H2>SETUP SEARCH RULES COMMANDS</H2>
10597 <!--chtml if pinemode="function_key"-->
10598 <PRE>
10599 Available  Commands -- Group 1         Available Commands -- Group 2
10600 -------------------------------        ------------------------------
10601 F1  Show Help Text                      F1  Show Help Text
10602 F2  See commands in next group          F2  See commands in next group
10603 F3  Back to MAIN Alpine menu
10604 F4  Change configuration for rule
10605 F5  Move to previous rule               F5  Include file in rule config
10606 F6  Move to next rule                   F6  Exclude file from config
10607 F7  Previous page of rules
10608 F8  Next page of rules
10609 F9  Add new rule                        F9  Replicate existing rule
10610 F10 Delete existing rule
10611 F11 Shuffle the order of rules
10612 F12 Whereis (search rule nicknames)
10613 </PRE>
10614 <!--chtml else-->
10615 <PRE>
10616 Navigation                     General Alpine Commands
10617 -------------------------      -----------------------
10618  P  Prev rule                     ?  Display this help text
10619  N  Next rule                     E  Back to MAIN Alpine menu
10620  -  Previous page
10621 Spc (space bar) Next page
10622  W  WhereIs (search for word in rule nicknames)
10623
10624 Setup Search Rules Commands
10625 ------------------------------------------------
10626  A  Add new rule                  $  Shuffle the order of rules
10627  D  Delete existing rule          C  Change configuration for highlighted rule
10628  R  Replicate existing rule
10629  I  Include file in rule config   X  Exclude file from rule config
10630 </PRE>
10631 <!--chtml endif-->
10632
10633 <H2>Description of the Setup Search Rules Screen</H2>
10634
10635 One of the commands that becomes available when that feature is turned on
10636 is the &quot;; Select&quot; command, which is used in the MESSAGE INDEX
10637 screen to select a set of messages.
10638 One way of selecting messages is to use a Rule.
10639 All of the messages that match (or don't match if you wish)
10640 a Rule's Pattern will be selected.
10641 <P>
10642 Any of your Rules may be used for this purpose.
10643 You might already have Rules set up for filtering, index line color, scores, or roles;
10644 and you may use any of those Rules with the Select command.
10645 However, you might find it more convenient to set up a separate set of Rules
10646 just for this purpose without having to worry about what other effects
10647 they may cause.
10648 That is the purpose of these Select Rules.
10649
10650 <P>
10651 Each rule has a &quot;Pattern&quot;
10652 that is used to decide which messages are selected when you use it with
10653 the Select command.
10654
10655 <H2>Patterns</H2>
10656
10657 In order to determine whether or not a message should be selected
10658 the message is compared with the rule's Pattern.
10659 These Patterns are the same for use with Roles, Filtering, Index Coloring,
10660 Scoring, Other Rules, and Search Rules, so are described in only one place,
10661 &quot;<A HREF="h_rule_patterns">here</A>&quot;.
10662
10663 <H2>Command Descriptions</H2>
10664
10665 <H3>Add</H3>
10666
10667 The Add command is used to add a new rule definition to your set of
10668 rules.
10669 The new rule will be added after the highlighted rule.
10670
10671 <H3>Delete</H3>
10672
10673 The Delete command deletes the currently highlighted rule.
10674
10675 <H3>Change</H3>
10676
10677 The Change command lets you edit the nickname and Pattern
10678 of the currently highlighted rule.
10679
10680 <H3>Shuffle</H3>
10681
10682 The Shuffle command allows you to change the order of the rules.
10683 This affects only the order they are presented in when you use the
10684 ^T subcommand of the Select by Rule command.
10685 You may move the currently highlighted rule up or down in the list.
10686
10687 <H3>Replicate</H3>
10688
10689 The Replicate command is used to copy an existing rule definition and modify it.
10690 The new rule will be added after the highlighted rule.
10691
10692 <H3>IncludeFile</H3>
10693
10694 The IncludeFile command allows you to add a rules file to your configuration.
10695 Usually, your rules will be contained in your Alpine configuration file.
10696 If you wish, some or all of your rules may be stored in a separate file.
10697 If a rules file already exists (maybe it was made by somebody else using
10698 Alpine), you may insert it before the currently highlighted rule.
10699 You may also insert an empty file or a file that does not yet exist.
10700 Once you have an empty rules file in your configuration, you may use
10701 the Shuffle command to move rules into it.
10702 In fact, that's the only way to get the initial rule into the file.
10703
10704 <H3>eXcludeFile</H3>
10705
10706 The eXcludeFile command removes a rules file from your rules configuration.
10707 A limitation of the program is that in order to exclude a rules file
10708 that file must have at least one rule
10709 in it, otherwise you won't be able to highlight a line in the file.
10710 So you may have to add a dummy rule to the file in order to exclude the file.
10711 <P><UL>
10712 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
10713 </UL>
10714 <P>
10715 &lt;End of help on this topic&gt;
10716 </BODY>
10717 </HTML>
10718 ===== h_rules_incols =====
10719 <HTML>
10720 <HEAD>
10721 <TITLE>SETUP INDEX LINE COLORS SCREEN</TITLE>
10722 </HEAD>
10723 <BODY>
10724 <H1>SETUP INDEX LINE COLORS SCREEN</H1>
10725 <H2>SETUP INDEX LINE COLORS COMMANDS</H2>
10726 <!--chtml if pinemode="function_key"-->
10727 <PRE>
10728 Available  Commands -- Group 1         Available Commands -- Group 2
10729 -------------------------------        ------------------------------
10730 F1  Show Help Text                      F1  Show Help Text
10731 F2  See commands in next group          F2  See commands in next group
10732 F3  Back to MAIN Alpine menu
10733 F4  Change configuration for rule
10734 F5  Move to previous rule               F5  Include file in rule config
10735 F6  Move to next rule                   F6  Exclude file from config
10736 F7  Previous page of rules
10737 F8  Next page of rules
10738 F9  Add new rule                        F9  Replicate existing rule
10739 F10 Delete existing rule
10740 F11 Shuffle the order of rules
10741 F12 Whereis (search rule nicknames)
10742 </PRE>
10743 <!--chtml else-->
10744 <PRE>
10745 Navigation                     General Alpine Commands
10746 -------------------------      -----------------------
10747  P  Prev rule                     ?  Display this help text
10748  N  Next rule                     E  Back to MAIN Alpine menu
10749  -  Previous page
10750 Spc (space bar) Next page
10751  W  WhereIs (search for word in rule nicknames)
10752
10753 Setup Index Color Commands
10754 ------------------------------------------------
10755  A  Add new rule                  $  Shuffle the order of rules
10756  D  Delete existing rule          C  Change configuration for highlighted rule
10757  R  Replicate existing rule
10758  I  Include file in rule config   X  Exclude file from rule config
10759 </PRE>
10760 <!--chtml endif-->
10761
10762 <H2>Description of the Setup Index Line Colors Screen</H2>
10763
10764 Index Line Color causes lines in the MESSAGE INDEX screen to be colored.
10765 This action is only available if your terminal is capable of displaying
10766 color and color display has been enabled with the
10767 <A HREF="h_config_color_style">Color Style</A> option within the
10768 Setup Color screen.
10769 (In PC-Alpine, color is always enabled so there is no option to turn on.)
10770 This screen lets you add, delete, modify, or change the order of the rules
10771 that cause the lines in the MESSAGE INDEX to be displayed in different
10772 colors.
10773 <P>
10774 Each rule has a &quot;Pattern&quot;,
10775 which is used to decide which of the rules is used; and the color that
10776 is used if the Pattern matches a particular message.
10777
10778 <H2>Index Color Patterns</H2>
10779
10780 In order to determine whether or not a message matches an Index Color Rule
10781 the message is compared with the rule's Pattern.
10782 These Patterns are the same for use with Roles, Filtering, Index Coloring,
10783 Scoring, Other Rules, and Search Rules, so are described in only one place,
10784 &quot;<A HREF="h_rule_patterns">here</A>&quot;.
10785
10786 <P>
10787 If none of the Index Color rules is a match for a particular index line,
10788 then the color used is set using
10789 the <A HREF="h_color_setup">Setup Kolor</A> screen.
10790
10791 <H2>Index Line Color</H2>
10792
10793 This is the color that index lines are colored when there is a matching
10794 Pattern.
10795 This colors the whole index line, except possibly the status letters,
10796 which may be colored separately using
10797 the <A HREF="h_color_setup">Setup Kolor</A> screen.
10798
10799 <H2>Command Descriptions</H2>
10800
10801 <H3>Add</H3>
10802
10803 The Add command is used to add a new rule definition to your set of
10804 rules.
10805 The new rule will be added after the highlighted rule.
10806
10807 <H3>Delete</H3>
10808
10809 The Delete command deletes the currently highlighted rule.
10810
10811 <H3>Change</H3>
10812
10813 The Change command lets you edit the nickname, Pattern,
10814 and Index Line Color of the currently highlighted rule.
10815
10816 <H3>Shuffle</H3>
10817
10818 The Shuffle command allows you to change the order of the rules.
10819 You may move the currently highlighted rule up or down in the list.
10820 The order of the rules is important since the rules are tested for a
10821 match starting with the first rule and continuing until a match is found.
10822 You should place the rules with more specific Patterns near the beginning
10823 of the list, and those with more general Patterns near the end so that
10824 the more specific matches will happen when appropriate.
10825
10826 <H3>Replicate</H3>
10827
10828 The Replicate command is used to copy an existing rule definition and modify it.
10829 The new rule will be added after the highlighted rule.
10830
10831 <H3>IncludeFile</H3>
10832
10833 The IncludeFile command allows you to add a rules file to your configuration.
10834 Usually, your rules will be contained in your Alpine configuration file.
10835 If you wish, some or all of your rules may be stored in a separate file.
10836 If a rules file already exists (maybe it was made by somebody else using
10837 Alpine), you may insert it before the currently highlighted rule.
10838 You may also insert an empty file or a file that does not yet exist.
10839 Once you have an empty rules file in your configuration, you may use
10840 the Shuffle command to move rules into it.
10841 In fact, that's the only way to get the initial rule into the file.
10842
10843 <H3>eXcludeFile</H3>
10844
10845 The eXcludeFile command removes a rules file from your rules configuration.
10846 A limitation of the program is that in order to exclude a rules file
10847 that file must have at least one rule
10848 in it, otherwise you won't be able to highlight a line in the file.
10849 So you may have to add a dummy rule to the file in order to exclude the file.
10850 <P><UL>
10851 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
10852 </UL>
10853 <P>
10854 &lt;End of help on this topic&gt;
10855 </BODY>
10856 </HTML>
10857 ===== h_rules_filter =====
10858 <HTML>
10859 <HEAD>
10860 <TITLE>SETUP FILTERING SCREEN</TITLE>
10861 </HEAD>
10862 <BODY>
10863 <H1>SETUP FILTERING SCREEN</H1>
10864 <H2>SETUP FILTERING COMMANDS</H2>
10865 <!--chtml if pinemode="function_key"-->
10866 <PRE>
10867 Available  Commands -- Group 1         Available Commands -- Group 2
10868 -------------------------------        ------------------------------
10869 F1  Show Help Text                      F1  Show Help Text
10870 F2  See commands in next group          F2  See commands in next group
10871 F3  Back to MAIN Alpine menu
10872 F4  Change configuration for filter
10873 F5  Move to previous filter             F5  Include file in filter config
10874 F6  Move to next filter                 F6  Exclude file from config
10875 F7  Previous page of filters
10876 F8  Next page of filters
10877 F9  Add new filter                      F9  Replicate existing filter
10878 F10 Delete existing filter
10879 F11 Shuffle the order of filters
10880 F12 Whereis (search filter nicknames)
10881 </PRE>
10882 <!--chtml else-->
10883 <PRE>
10884 Navigation                     General Alpine Commands
10885 -------------------------      -----------------------
10886  P  Prev Filter                   ?  Display this help text
10887  N  Next Filter                   E  Back to MAIN Alpine menu
10888  -  Previous page
10889 Spc (space bar) Next page
10890  W  WhereIs (search for word in filter nicknames)
10891
10892 Setup Filters Commands
10893 ------------------------------------------------
10894  A  Add new filter                $  Shuffle the order of filters
10895  D  Delete existing filter        C  Change configuration for highlighted filter
10896  R  Replicate existing filter
10897  I  Include file in filter config X  Exclude file from filter config
10898 </PRE>
10899 <!--chtml endif-->
10900
10901 <H2>Description of the Setup Filtering Screen</H2>
10902
10903 This screen lets you add, delete, modify, or change the order of the rules
10904 that determine the filtering Alpine does on folders you view.
10905 <P>
10906 The software that actually delivers mail (the stuff that happens
10907 before Alpine is involved) for you is in a better position to do mail filtering
10908 than Alpine itself.
10909 If possible, you may want to look into using that sort of mail filtering to
10910 deliver mail to different folders, delete it, or forward it.
10911 However, if you'd like Alpine to help with this, Alpine's filtering is for you.
10912 <P>
10913 Filtering is a way to automatically move certain messages from one folder
10914 to another or to delete messages.
10915 It can also be used to set message status (Important, Deleted, New,
10916 Answered) and to set <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> for messages.
10917 Alpine doesn't have the ability to forward mail to another address or
10918 to deliver vacation messages.
10919 <P>
10920 Each filtering rule has a &quot;Pattern&quot; and a &quot;Filter Action&quot;.
10921 When a folder is opened, when new mail arrives in an open folder, or
10922 when mail is Expunged from a folder; each
10923 message is compared with the Patterns of your filtering rules.
10924 The comparisons start with the first rule and keep going until there
10925 is a match.
10926 If a match is found, the message may be deleted or moved, depending on
10927 the setting of the Filter Action.
10928 If the message is not deleted, it may have its status altered.
10929
10930 <P>
10931 <EM>NOTE:</EM>
10932 When setting up a Pattern used to delete messages,
10933 it is recommended that you test the Pattern first with a &quot;Move&quot;
10934 folder specified in
10935 case unintended matches occur.  Messages that are deleted will be removed
10936 from the folder and <EM>unrecoverable</EM> from within Alpine after the
10937 next Expunge command or once the folder being filtered has been closed.
10938
10939 <H2>Filter Patterns</H2>
10940
10941 In order to determine whether or not a message matches a filter the message is
10942 compared with the Filter's Pattern.
10943 These Patterns are the same for use with Roles, Filtering, Index Coloring,
10944 Scoring, Other Rules, and Search Rules, so are described in only one place,
10945 &quot;<A HREF="h_rule_patterns">here</A>&quot;.
10946 <P>
10947 Since filtering is a potentially destructive action, if you have a filtering
10948 Pattern with nothing other than Current Folder Type set, that filtering
10949 rule is ignored.
10950
10951 <H2>Filter Actions</H2>
10952
10953 Once a filter match is found for a particular message, there are some actions
10954 that may be taken.
10955 First, the message may have its status changed.
10956 This is the same message status that you can manipulate manually using the
10957 <a href="h_common_flag">Flag Command</a>.
10958 There are always four elements of message status that you can control.
10959 You can set or clear the Important status, the New status, the Deleted
10960 status, and the Answered status.
10961 Of course, if the filter is going to delete the message,
10962 then there is no point in setting message status.
10963 You may also be able to set user-defined keywords for a message.
10964 Read a little about keywords in the help text for the
10965 <A HREF="h_common_flag">Flag</A> command.
10966 <P>
10967 Second, the filter may delete or move the message.
10968 Deleting the message marks it Deleted and removes it from view.
10969 It is effectively gone forever (though it technically is still there until
10970 the next expunge command, which may happen implicitly).
10971 Moving the message moves it from the open folder into the folder
10972 listed on the &quot;Folder List&quot; line of the filter configuration.
10973 If you list more than one folder name (separated by commas) then the message
10974 will be copied to each of those folders.
10975 In any case, if &quot;Delete&quot; or &quot;Move&quot; is set then the
10976 message is removed from the current folder.
10977 If you just want to set the messages status without deleting it from
10978 the folder, then set the filter action to
10979 &quot;Just Set Message Status&quot;.
10980 <P>
10981 (There is no way to do a Copy instead of a Move, due to the difficulties
10982 involved in keeping track of whether or not a message has
10983 already been copied.)
10984
10985 <H2>Command Descriptions</H2>
10986
10987 <H3>Add</H3>
10988
10989 The Add command is used to add a new filter definition to your set of
10990 filters.
10991 The new filter will be added after the highlighted filter.
10992
10993 <H3>Delete</H3>
10994
10995 The Delete command deletes the currently highlighted filter.
10996
10997 <H3>Change</H3>
10998
10999 The Change command lets you edit the nickname, Pattern,
11000 and Folder of the currently highlighted filter.
11001
11002 <H3>Shuffle</H3>
11003
11004 The Shuffle command allows you to change the order of the filters.
11005 You may move the currently highlighted filter up or down in the list.
11006 The order of the filters is important since the filters are tested for a
11007 match starting with the first filter and continuing until a match is found.
11008 You should place the filters with more specific Patterns near the beginning
11009 of the list, and those with more general Patterns near the end so that
11010 the more specific matches will happen when appropriate.
11011
11012 <H3>Replicate</H3>
11013
11014 The Replicate command is used to copy an existing filter and modify it.
11015 The new filter will be added after the highlighted filter.
11016
11017 <H3>IncludeFile</H3>
11018
11019 The IncludeFile command allows you to add a filters file to your configuration.
11020 Usually, your filters will be contained in your Alpine configuration file.
11021 If you wish, some or all of your filters may be stored in a separate file.
11022 If a filters file already exists (maybe it was made by somebody else using
11023 Alpine), you may insert it before the currently highlighted filter.
11024 You may also insert an empty file or a file that does not yet exist.
11025 Once you have an empty filters file in your configuration, you may use
11026 the Shuffle command to move filters into it.
11027 In fact, that's the only way to get the initial filter into the file.
11028
11029 <H3>eXcludeFile</H3>
11030
11031 The eXcludeFile command removes a filters file from your filters configuration.
11032 A limitation of the program is that in order to exclude a filters file
11033 that file must have at least one filter
11034 in it, otherwise you won't be able to highlight a line in the file.
11035 So you may have to add a dummy filter to the file in order to exclude the file.
11036 <P><UL>
11037 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
11038 </UL>
11039 <P>
11040 <H3>Performance Considerations</H3>
11041 The number and type of patterns being tested can
11042 adversely effect performance.  Issues to be aware
11043 of include:
11044 <P>
11045 <UL>
11046   <LI> The more filters you have defined the longer it will take to run down
11047 the list.  Deleting unused filters is a good idea.
11048   <LI> Filtering in newsgroups served by an NNTP server will be slow
11049 if your patterns include tests other than &quot;From:&quot;
11050 or &quot;Subject:&quot;.
11051 </UL>
11052 <P>
11053 &lt;End of help on this topic&gt;
11054 </BODY>
11055 </HTML>
11056 ===== h_rules_score =====
11057 <HTML>
11058 <HEAD>
11059 <TITLE>SETUP SCORING SCREEN</TITLE>
11060 </HEAD>
11061 <BODY>
11062 <H1>SETUP SCORING SCREEN</H1>
11063 <H2>SETUP SCORING COMMANDS</H2>
11064 <!--chtml if pinemode="function_key"-->
11065 <PRE>
11066 Available  Commands -- Group 1         Available Commands -- Group 2
11067 -------------------------------        ------------------------------
11068 F1  Show Help Text                      F1  Show Help Text
11069 F2  See commands in next group          F2  See commands in next group
11070 F3  Back to MAIN Alpine menu
11071 F4  Change configuration for rule
11072 F5  Move to previous rule               F5  Include file in rule config
11073 F6  Move to next rule                   F6  Exclude file from config
11074 F7  Previous page of rules
11075 F8  Next page of rules
11076 F9  Add new rule                        F9  Replicate existing rule
11077 F10 Delete existing rule
11078 F11 Shuffle the order of rules
11079 F12 Whereis (search rule nicknames)
11080 </PRE>
11081 <!--chtml else-->
11082 <PRE>
11083 Navigation                     General Alpine Commands
11084 -------------------------      -----------------------
11085  P  Prev rule                     ?  Display this help text
11086  N  Next rule                     E  Back to MAIN Alpine menu
11087  -  Previous page
11088 Spc (space bar) Next page
11089  W  WhereIs (search for word in rule nicknames)
11090
11091 Setup Scoring Commands
11092 ------------------------------------------------
11093  A  Add new rule                  $  Shuffle the order of rules
11094  D  Delete existing rule          C  Change configuration for highlighted rule
11095  R  Replicate existing rule
11096  I  Include file in rule config   X  Exclude file from rule config
11097 </PRE>
11098 <!--chtml endif-->
11099
11100 <H2>Description of the Setup Scoring Screen</H2>
11101
11102 Most people will not use scores at all, but if you do use them, here's how
11103 they work in Alpine.
11104 Using this screen, you may define Scoring rules.
11105 The score for a message is calculated by looking at every Score rule defined
11106 and adding up the Score Values for the ones that match the message.
11107 If there are no matches for a message, it has a score of zero.
11108 Message scores may be used a couple of ways in Alpine.
11109
11110 <H3>Sorting by Score</H3>
11111
11112 One of the methods you may use to sort message indexes is to sort by
11113 score.
11114 The scores of all the messages in a folder will be calculated and then
11115 the index will be ordered by placing the messages in order of ascending or
11116 descending score.
11117
11118 <H3>Scores for use in Patterns</H3>
11119
11120 The Patterns used for Roles, Index Line Coloring, and Filtering have a
11121 category labeled &quot;Score Interval&quot;.
11122 When a message is being compared with a Pattern to check for a match, if
11123 the Score Interval is set only messages that have a score somewhere in
11124 the interval are a match.
11125
11126 <H2>Scoring Rule Patterns</H2>
11127
11128 In order to determine whether or not a message matches a scoring rule
11129 the message is compared with the rule's Pattern.
11130 These Patterns are the same for use with Roles, Filtering, Index Coloring,
11131 Scoring, Other Rules, and Search Rules, so are described in only one place,
11132 &quot;<A HREF="h_rule_patterns">here</A>&quot;.
11133
11134 <P>
11135 Actually, Scoring rule Patterns are slightly different from the other types of
11136 Patterns because Scoring rule Patterns don't contain a Score Interval.
11137 In other words, when calculating the score for a message, which is done
11138 by looking at the Scoring rule Patterns, scores aren't used.
11139
11140 <H2>Score Value</H2>
11141
11142 This is the value that will be added to the score for a message if the
11143 rule's Pattern is a match.
11144 Each individual Score Value is an integer between -100 and 100, and the
11145 values from matching rules are added together to get a message's score.
11146 There is also a way to extract the value from a particular header of each
11147 message. See the help text for Score Value for further information.
11148
11149 <H2>Command Descriptions</H2>
11150
11151 <H3>Add</H3>
11152
11153 The Add command is used to add a new scoring rule definition.
11154 The new rule will be added after the highlighted rule.
11155
11156 <H3>Delete</H3>
11157
11158 The Delete command deletes the currently highlighted scoring rule.
11159
11160 <H3>Change</H3>
11161
11162 The Change command lets you edit the nickname, Pattern,
11163 and Score Value of the currently highlighted scoring rule.
11164
11165 <H3>Shuffle</H3>
11166
11167 The Shuffle command allows you to change the order of the scoring rules.
11168 You may move the currently highlighted rule up or down in the list.
11169 The order of the rules is important since the rules are tested for a
11170 match starting with the first rule and continuing until a match is found.
11171 You should place the rules with more specific Patterns near the beginning
11172 of the list, and those with more general Patterns near the end so that
11173 the more specific matches will happen when appropriate.
11174
11175 <H3>Replicate</H3>
11176
11177 The Replicate command is used to copy an existing rule and modify it.
11178 The new rule will be added after the highlighted rule.
11179
11180 <H3>IncludeFile</H3>
11181
11182 The IncludeFile command allows you to add a rules file to your configuration.
11183 Usually, your rules will be contained in your Alpine configuration file.
11184 If you wish, some or all of your rules may be stored in a separate file.
11185 If a rules file already exists (maybe it was made by somebody else using
11186 Alpine), you may insert it before the currently highlighted rule.
11187 You may also insert an empty file or a file that does not yet exist.
11188 Once you have an empty rules file in your configuration, you may use
11189 the Shuffle command to move rules into it.
11190 In fact, that's the only way to get the initial rule into the file.
11191
11192 <H3>eXcludeFile</H3>
11193
11194 The eXcludeFile command removes a rules file from your rules configuration.
11195 A limitation of the program is that in order to exclude a rules file
11196 that file must have at least one rule
11197 in it, otherwise you won't be able to highlight a line in the file.
11198 So you may have to add a dummy rule to the file in order to exclude the file.
11199 <P><UL>
11200 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
11201 </UL>
11202 <P>
11203 &lt;End of help on this topic&gt;
11204 </BODY>
11205 </HTML>
11206 ===== h_direct_config =====
11207 <HTML>
11208 <HEAD>
11209 <TITLE>SETUP LDAP DIRECTORY SERVERS SCREEN</TITLE>
11210 </HEAD>
11211 <BODY>
11212 <H1>SETUP LDAP DIRECTORY SERVERS SCREEN</H1>
11213 <H2>SETUP LDAP DIRECTORY SERVERS COMMANDS</H2>
11214 <!--chtml if pinemode="function_key"-->
11215 <PRE>
11216 Available  Commands
11217 -------------------------------
11218 F1  Show Help Text
11219 F3  Back to MAIN Alpine menu
11220 F4  Change configuration for directory server
11221 F5  Move to previous directory server
11222 F6  Move to next directory server
11223 F7  Previous page of directory servers
11224 F8  Next page of directory servers
11225 F9  Add new directory server
11226 F10 Delete existing directory server
11227 F11 Shuffle the order of directory servers
11228 F12 Whereis (search directory server titles)
11229 </PRE>
11230 <!--chtml else-->
11231 <PRE>
11232 Navigation                     General Alpine Commands
11233 -------------------------      -----------------------
11234  P  Prev Directory Server         ?  Display this help text
11235  N  Next Directory Server         E  Back to MAIN Alpine menu
11236  -  Previous page
11237 Spc (space bar) Next page
11238  W  WhereIs (search for word in directory server titles)
11239
11240 Setup LDAP Directory Server Commands
11241 ------------------------------------------------
11242  A  Add new directory server      $  Shuffle the order of directory servers
11243  D  Delete existing dir server    C  Change configuration for highlighted server
11244 </PRE>
11245 <!--chtml endif-->
11246
11247 <H2>Description of the Setup LDAP Directory Servers Screen</H2>
11248
11249 This screen lets you add, delete, modify, or change the order of your
11250 directory servers. You may also set some optional behavior for each server.
11251 The &quot;Add Dir&quot; command brings up a blank form to
11252 fill in. You will have to supply at least the name of the LDAP server.
11253 You will often have to supply a search base to be used with that server,
11254 as well. Once the form has been brought up on your screen, there is help
11255 available for each of the options you may set.
11256 <P>
11257 The &quot;Del Dir&quot; command allows you to remove a directory server
11258 from your configuration.
11259 <P>
11260 The &quot;Change&quot; command is similar to the &quot;Add Dir&quot; command.
11261 The difference is that instead of bringing up a form for a new server
11262 configuration, you are changing the configuration of an existing entry.
11263 For example, you might want to correct a typing error, change a
11264 nickname, or change one of the options set for that server.
11265 <P>
11266 The &quot;Shuffle&quot; command is used to change the order of directory
11267 servers.
11268 <P><UL>
11269 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
11270 </UL>
11271 <P>
11272 &lt;End of help on this topic&gt;
11273 </BODY>
11274 </HTML>
11275 ============= h_address_display ========================
11276 <HTML>
11277 <HEAD>
11278 <TITLE>SEARCH RESULTS INDEX</TITLE>
11279 </HEAD>
11280 <BODY>
11281 <H1>SEARCH RESULTS INDEX</H1>
11282 This screen shows the results, if any, of your Directory Server search.
11283 Commands (besides those for screen navigation) are:
11284 <DL>
11285 <DT>View
11286 <!--chtml if pinemode="function_key"-->
11287 (F4)
11288 <!--chtml else-->
11289 (V)
11290 <!--chtml endif-->
11291 </DT>
11292 <DD>See the full information for the selected entry.
11293
11294 <DT>Compose
11295 <!--chtml if pinemode="function_key"-->
11296 (F9)
11297 <!--chtml else-->
11298 (C)
11299 <!--chtml endif--></DT>
11300 <DD>Compose a message with the selected entry as the recipient.
11301
11302 <DT>Role
11303 <!--chtml if pinemode="function_key"-->
11304 (F2)
11305 <!--chtml else-->
11306 (#)
11307 <!--chtml endif--></DT>
11308 <DD>Compose a message with the selected entry as the recipient. This differs
11309 from Compose in that you may select a role before beginning your composition.
11310
11311 <DT>Forward
11312 <!--chtml if pinemode="function_key"-->
11313 (F10)
11314 <!--chtml else-->
11315 (F)
11316 <!--chtml endif--></DT>
11317 <DD>Send the full information for the selected entry as an
11318 email message to someone else.
11319
11320 <DT>Save
11321 <!--chtml if pinemode="function_key"-->
11322 (F11)
11323 <!--chtml else-->
11324 (S)
11325 <!--chtml endif-->
11326 </DT>
11327 <DD>Save to your address book:
11328 <UL>
11329 <LI>the result of the search (as just found through your query) for the
11330 selected entry; or
11331 <LI>the selected entry for repeated Directory Server searching when used
11332 in the future.
11333 </UL>
11334 or<BR>
11335 Export to a file (external to Alpine):
11336 <UL>
11337 <LI>the full information for the selected entry; or
11338 <LI>the email address from the selected entry; or
11339 <LI>the selected entry in <A HREF="h_whatis_vcard">vCard</A> format.
11340 </UL>
11341 <DT>WhereIs
11342 <!--chtml if pinemode="function_key"-->
11343 (F12)
11344 <!--chtml else-->
11345 (W)
11346 <!--chtml endif-->
11347 </DT>
11348 <DD>Search for text in the SEARCH RESULTS INDEX screen. (Searches only the
11349 displayed text, not the full records for each entry.)
11350 </DL>
11351 &lt;End of help on this topic&gt;
11352 </BODY>
11353 </HTML>
11354 ============= h_address_select ========================
11355 <HTML>
11356 <HEAD>
11357 <TITLE>SEARCH RESULTS INDEX</TITLE>
11358 </HEAD>
11359 <BODY>
11360 <H1>SEARCH RESULTS INDEX</H1>
11361 This screen shows the results, if any, of your Directory Server search.
11362 Commands (besides those for screen navigation) are:
11363 <DL>
11364 <DT>Select
11365 </DT>
11366 <DD>Select this entry for use.
11367
11368 <DT>ExitSelect
11369 <DD>Exit without selecting any of the entries.
11370
11371 <DT>WhereIs
11372 </DT>
11373 <DD>Search for text in the SEARCH RESULTS INDEX screen. (Searches only the
11374 displayed text, not the full records for each entry.)
11375 </DL>
11376 &lt;End of help on this topic&gt;
11377 </BODY>
11378 </HTML>
11379 ===== h_folder_maint =====
11380 <HTML>
11381 <HEAD>
11382 <TITLE>Help for Folder List</TITLE>
11383 </HEAD>
11384 <BODY>
11385 <H1>FOLDER LIST COMMANDS</H1>
11386 <!--chtml if pinemode="function_key"-->
11387 <PRE>
11388 Available Commands -- Group 1        Available Commands -- Group 2
11389 -------------------------------      ------------------------------
11390 F1  Show Help Text                    F1  Show Help Text
11391 F2  See commands in next group        F2  See commands in next group
11392 F3  MAIN MENU Screen                  F3  Quit Alpine
11393 F4  Select folder and view it         F4  MAIN MENU Screen
11394 F5  Move to previous folder
11395 F6  Move to next folder               F6  Specify a folder to go to
11396 F7  Show previous screen of listing   F7  Show MESSAGE INDEX of current folder
11397 F8  Show next screen of listing       F8  Compose a message
11398 F9  Add a new folder                  F9  Print folder listing
11399 F10 Delete selected folder
11400 F11 Rename selected folder
11401 F12 Whereis (search folder names)
11402
11403 Available Commands -- Group 3
11404 F1  Show Help Text
11405 F2  See commands in next group
11406 F5  Go to next new message
11407     (or count recent messages if <A HREF="h_config_tab_checks_recent"><!--#echo var="FEAT_tab-checks-recent"--></A> is set)
11408 F8  Compose a message using roles
11409 F9  Export folder to a file
11410 F10 Import the file back to a folder
11411 </PRE>
11412 <!--chtml else-->
11413 <PRE>
11414 Navigating the Folder Screen            Operations on the Selected Folder
11415 ----------------------------            ---------------------------------
11416  P   Move to previous folder              V  View Index of selected folder
11417  N   Move to next folder                  D  Delete
11418  -   Show previous page of listing        R  Rename
11419 Spc  (space bar) Show next page           E  Export to file
11420                                           U  Import from file to folder
11421
11422 FOLDER LIST Screen Commands              General Alpine Command
11423 ---------------------------              -----------------------
11424  A  Add a folder                          O  Show all other available commands
11425  G  Specify a folder to go to             ?  Show Help text
11426  I  Show MESSAGE INDEX of current folder  M  MAIN MENU Screen
11427  W  Whereis (search folder names)         Q  Quit Alpine
11428  %  Print folder listing                  C  Compose a message
11429                                           #  Compose a message using roles
11430 </PRE>
11431 <!--chtml endif-->
11432 <P>
11433 These commands are only available in the FOLDER LIST screen when the
11434 <A HREF="h_config_enable_agg_ops">&quot;<!--#echo var="FEAT_enable-aggregate-command-set"-->&quot;
11435 feature</A> is set in the SETUP CONFIGURATION screen:<DL>
11436 <DT>Select:</DT>
11437 <DD>Select folders by certain criteria:<UL>
11438 <LI>All: of limited use, since there is no Apply command.
11439 <LI>by Property: <UL>
11440         <LI>folder contains messages not yet seen
11441         <LI>folder contains new messages
11442         <LI>folder contains exactly as many, more, or fewer messages
11443 than a given number
11444         </UL>
11445 <LI>by Text: <UL>
11446         <LI>contained in name of folder (Name Select)
11447         <LI>contained in messages in folder (Content Select)
11448         </UL>
11449 </UL></DD>
11450
11451 <DT>Select current:</DT>
11452 <DD>Select the folder the cursor is on.  (Can be used to &quot;manually&quot;
11453 add one or more folders to a set created with the Select command described
11454 above.)</DD>
11455 <DT>Zoom mode:</DT>
11456 <DD>Toggles display of only selected folders or all folders on and off.</DD>
11457 </DL>
11458 <P>
11459 If the feature
11460 <A HREF="h_config_tab_checks_recent">&quot;<!--#echo var="FEAT_tab-checks-recent"-->&quot;</A>
11461 is set then the TAB key will display the number of recent messages and
11462 the total number of messages in the highlighted folder.
11463 <P>
11464 The &quot;Export&quot; command causes the lowest common denominator style
11465 mailbox to be written to a file.
11466 If the file already exists, you are asked if you want to delete it.
11467 If you say No, then the operation is aborted.
11468 Export might be a reasonable way to store a backup or an archival copy of
11469 a folder.
11470 The exported-to file is a local file on the system where you are running Alpine.
11471 The &quot;Import&quot; command is the opposite of the Export command.
11472 It reads a file created by Export and asks where it should save it in your
11473 folders.
11474 This could be a new folder or an existing folder.
11475 If the folder already exists, the messages from the exported file will be
11476 appended to the folder.
11477 <P>
11478 <CENTER>Description of the FOLDER LIST Screen</CENTER>
11479
11480 The purpose of the FOLDER LIST screen is to help you browse and manage
11481 the folders and directories (also known as &quot;hierarchy&quot;)
11482 contained within a collection.
11483
11484 <P>
11485 Folders and directories are arranged alphabetically across lines of
11486 the screen.  Directories, if present, are denoted by a special
11487 character at the end of the name known as the hierarchy delimiter
11488 (typically, &quot;/&quot;).  By default, folders and directories are
11489 mixed together.  The
11490 "<A HREF="h_config_fld_sort_rule"><!--#echo var="VAR_folder-sort-rule"--></A>"
11491 configuration option can be used to group directories toward the
11492 beginning or end of the list.
11493
11494 <P>
11495 The Next/Prev Page commands help browse the list, the Next/Prev Fldr
11496 commands change the &quot;selected&quot; (i.e., highlighted) folder or
11497 directory, and the View Fldr/Dir commands will &quot;open&quot; the
11498 selected item.  Folder and directory management is provided via the
11499 Rename, Delete and Add commands.
11500
11501 <P><CENTER>About Folders</CENTER>
11502 What are Folders?<P>
11503
11504 Folders are simply files where messages are kept.  Every message has to be
11505 in a folder.  Most every Alpine user starts out with 3 folders: an INBOX, a
11506 folder for sent mail and a folder for saved messages.<P>
11507
11508 You may create as many other folders as you wish.  They must be given
11509 names that can be filenames on the filesystem.
11510 <P>
11511
11512 You can move messages from one folder to another by opening the original
11513 folder and saving messages into the other folder just as you can save
11514 message from your INBOX to any other folder.<P>
11515
11516 Folders are typically just files in the filesystem.  However, the files
11517 that are
11518 folders have some special formatting in them (so that Alpine knows where one
11519 message ends and another begins) and should <EM>not</EM> be edited outside of
11520 Alpine.  If you want copies of your messages in text files that you can edit
11521 or otherwise manipulate, use the Export command to copy them from Alpine into
11522 your regular file area.
11523
11524 <P>
11525 FOR MORE INFORMATION: See the section on
11526 <A HREF="h_valid_folder_names">Valid Folder Names</A>.
11527 <P>
11528 <CENTER>About Directories</CENTER>
11529 <P>
11530 A directory is simply a container used to group folders within a
11531 folder list.  You can create as many directories as you like.  And
11532 directories can even contain directories themselves.
11533
11534 <P>
11535 SPECIAL NOTES: When accessing folders on an IMAP server, it is important
11536 to note that not all IMAP servers support directories.  If you find that
11537 the Add command fails to offer the &quot;Create Directory&quot; subcommand,
11538 then it's likely that directories are not supported by the server serving
11539 in that collection.
11540
11541 <P>
11542 Similarly, servers that do provide for directories may not do so in
11543 the same way.  On some servers, for example, each folder name you
11544 create is at the same time capable of being a directory.  When this
11545 happens, Alpine will display both the folder name and the name of the
11546 directory (with trailing hierarchy delimiter) in the folder list.
11547
11548 <P>
11549 Another issue with IMAP access, though with a much smaller set of servers,
11550 is that not all servers accept the request to list out the available
11551 folders and directories in the same way.  If you find yourself having
11552 trouble viewing folders on your server, you might investigate the
11553 &quot;<A HREF="h_config_lame_list_mode"><!--#echo var="FEAT_enable-lame-list-mode"--></A>&quot;
11554 feature.
11555 <P>
11556 <UL>
11557 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
11558 </UL>
11559 <P>
11560 &lt;End of help on this topic&gt;
11561 </BODY>
11562 </HTML>
11563 ========= h_valid_folder_names ========
11564 <HTML>
11565 <HEAD>
11566 <TITLE>Explanation of Valid Folder Names</TITLE>
11567 </HEAD>
11568 <BODY>
11569 <H1>Folder Name Syntax Explained</H1>
11570
11571 Once your folder collections are defined, you can usually refer to
11572 folders by their simple (unqualified) name, or pick from a FOLDER LIST
11573 display.  However, understanding the complete syntax for folder names,
11574 both local and remote, is handy when using the Goto command and when
11575 you are adding new folder collections via the Setups/collectionList screen.
11576 <P>
11577 An Alpine folder name looks like
11578
11579 <P>
11580 <CENTER><SAMP>[{&lt;remote-specification&gt;}][#&lt;namespace&gt;]&lt;namespace-specific-part&gt;</SAMP></CENTER>
11581 <P>
11582
11583 The square brackets ([]) mean that the part is optional.
11584
11585 <P>
11586 If there is no remote-specification, then the folder name is interpreted
11587 locally on the computer running Alpine.
11588 Local folder names depend on the operating system used by the computer
11589 running Alpine, as well as the configuration of that system.  For example,
11590 &quot;C:&#92;PINE&#92;FOLDERS&#92;OCT-94&quot; might exist on a PC, and
11591 &quot;~/mail/september-1994&quot; might be a reasonable folder name on a
11592 system running Unix.
11593
11594 <P>
11595 Alpine users have the option of using folders that are stored on some other
11596 computer.  Alpine accesses remote folders via IMAP (the Internet Message
11597 Access Protocol), or in the case of news, via NNTP (the Network News
11598 Transport Protocol).  To be able to access remote folders in Alpine, the
11599 remote host must be running the appropriate server software (imapd or
11600 nntpd) and you must correctly specify the name of the folder to Alpine,
11601 including the domain name of the remote machine. For example,
11602 <P>
11603 <CENTER><SAMP>&#123;monet.art.example.com}INBOX</SAMP></CENTER>
11604 <P>
11605 could be a remote folder specification, and so could
11606 <P>
11607 <CENTER><SAMP>&#123;unixhost.art.example.com}~/mail/september-1994</SAMP></CENTER>
11608 and
11609 <P>
11610 <CENTER><SAMP>&#123;winhost.art.example.com}&#92;mymail&#92;SEP-94</SAMP></CENTER>
11611 <P>
11612 Note that in the case of remote folders, the directory/file path in the specification is
11613 determined by the operating system of the remote computer, <B>not</B> by
11614 the operating system of the computer on which you are running Alpine.
11615 <P>
11616 As you can tell, the name of the computer is in &#123;} brackets
11617 followed immediately by the name of the folder.  (In each of these cases the
11618 optional namespace is missing.)  If, as in these
11619 examples, there is no remote access protocol specified, then IMAP is
11620 assumed.  Check
11621 <A HREF="h_folder_server_syntax">here</A>
11622 for a more detailed look at what options can be placed between the brackets.
11623 If there are no brackets at all, then the folder name is interpreted locally
11624 on the computer on which you are running Alpine.
11625
11626 <P>
11627 To the right of the brackets when a server name is present, or at the
11628 start of the foldername if no server is present, the sharp sign,
11629 &quot;#&quot;, holds special meaning.  It indicates a folder name
11630 outside the area reserved for your personal folders.  In fact, it's
11631 used to indicate both the name of the folder, and a special phrase
11632 telling Alpine how to interpret the name that follows.
11633
11634 <P>
11635 So, for example, Alpine can be used to access a newsgroup that might be
11636 available on your computer using:
11637 <P>
11638 <CENTER><SAMP>#news.comp.mail.pine</SAMP></CENTER>
11639 <P>
11640 The sharp sign indicates the folder name is outside your personal
11641 folder area.  The &quot;news.&quot; phrase after it tells Alpine to
11642 interpret the remainder of the name as a newsgroup.
11643
11644 <P>
11645 Similarly, to access a newsgroup on your IMAP server, you might
11646 use something like:
11647 <P>
11648 <CENTER><SAMP>&#123;wharhol.art.example.com}#news.comp.mail.misc</SAMP></CENTER>
11649
11650 <P>
11651 There are a number of such special phrases (or &quot;namespaces&quot;)
11652 available.  For a more detailed explanation read about
11653 <A HREF="h_folder_name_namespaces">Namespaces</A>.
11654
11655 <P>
11656 Note that &quot;INBOX&quot; has special meaning in both local and remote folder
11657 names.  The name INBOX refers to your &quot;principal incoming
11658 message folder&quot; and will be mapped to the actual file name used for your
11659 INBOX on any given host.  Therefore, a name like
11660 &quot;&#123;xxx.art.example.com}INBOX&quot; refers to whatever file is used to
11661 store incoming mail for you on that particular host.
11662
11663 <P>
11664 &lt;End of help on this topic&gt;
11665 </BODY>
11666 </HTML>
11667 ======= h_folder_name_namespaces =======
11668 <HTML>
11669 <HEAD>
11670 <TITLE>FOLDER NAME NAMESPACES EXPLAINED</TITLE>
11671 </HEAD>
11672 <BODY>
11673 <H1>Folder Name Namespaces Explained</H1>
11674
11675 An Alpine folder name looks like
11676
11677 <P>
11678 <CENTER><SAMP>[{&lt;remote-specification&gt;}][#&lt;namespace&gt;][&lt;namespace-specific-part&gt;]</SAMP></CENTER>
11679 <P>
11680
11681 The local part of a folder name has an optional &quot;Namespace&quot; which
11682 tells Alpine how to interpret the rest of the name.
11683
11684 <P>
11685 By default the folder name is interpreted as defining a section of your personal
11686 folder area.  This area and how you specify it are defined by the
11687 server, if one is specified, or, typically, the home
11688 directory, if no server is defined.
11689
11690 <P>
11691 If a namespace is specified, it begins with the
11692 sharp, &quot;#&quot;, character followed by the name of the namespace
11693 and then the namespace's path-element-delimiter.  Aside from the
11694 path's format, namespaces can also imply access rights, content
11695 policy, audience, location, and, occasionally, access methods.
11696
11697 <P>
11698 Each server exports its own set (possibly of size one) of
11699 namespaces.  Hence, it's likely communication with your server's
11700 administrator will be required for specific configurations.  Some of
11701 the more common namespaces, however, include:
11702
11703 <DL>
11704 <DT>#news.</DT>
11705 <DD>This specifies a set of folders in the newsgroup namespace.  Newsgroup
11706 names are hierarchically defined with each level delimited by a period.
11707 <P>
11708 <CENTER><SAMP>#news.comp.mail.pine</SAMP></CENTER>
11709 <P>
11710 </DD>
11711 <DT>#public/</DT>
11712 <DD>This specifies a folder area that the server may export to the general
11713 public.
11714 </DD>
11715 <DT>#shared/</DT>
11716 <DD>This specifies a folder area that the server may export to groups
11717 of users.
11718 </DD>
11719 <DT>#ftp/</DT>
11720 <DD>This specifies a folder area that is the same as that it may have
11721 exported via the &quot;File Transfer Protocol&quot;.
11722 </DD>
11723 <DT>#mh/</DT>
11724 <DD>This specifies the personal folder area associated with folders
11725 and directories that were created using the MH message handling system.
11726 </DD>
11727 <DT>#move/</DT>
11728 <DD>This namespace is interpreted locally by Alpine. It has an unusual interpretation and format.
11729 <P>
11730 <CENTER><SAMP>#move&lt;DELIM&gt;&lt;MailDropFolder&gt;&lt;DELIM&gt;&lt;DestinationFolder&gt;</SAMP></CENTER>
11731 <P>
11732 The #move namespace is followed by two folder names separated by a delimiter
11733 character.
11734 The delimiter character may be any character that does not appear in
11735 the MailDropFolder name.
11736 The meaning of #move is that mail will be copied from the MailDropFolder to
11737 the DestinationFolder and then deleted (if possible) from the MailDropFolder.
11738 Periodic checks at frequency
11739 <A HREF="h_config_mailcheck"><!--#echo var="VAR_mail-check-interval"--></A>, but with a minimum
11740 time between checks set by
11741 <A HREF="h_config_maildropcheck"><!--#echo var="VAR_maildrop-check-minimum"--></A>,
11742 are made for new mail arriving in the MailDropFolder.
11743 An example that copies mail from a POP inbox to a local folder follows
11744 <P>
11745 <CENTER><SAMP>#move+{popserver.example.com/pop3/ssl}inbox+local folder</SAMP></CENTER>
11746 <P>
11747 To you it appears that mail is being delivered to the local folder when it
11748 is copied from the MailDropFolder, and you read mail from the local folder.
11749 <P>
11750 Note that if the DestinationFolder does not exist then the messages are not
11751 copied from the MailDropFolder.
11752 A #move folder may only be used as an
11753 <A HREF="h_config_enable_incoming">&quot;Incoming folder&quot;</A> or
11754 an Inbox.
11755 When you are in the FOLDER LIST of Incoming Message Folders (after turning
11756 on the
11757 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="FEAT_enable-incoming-folders"-->&quot;</A>
11758 option)
11759 the Add command has a subcommand &quot;Use Mail Drop&quot;
11760 which may be helpful for defining the folder in your Alpine configuration.
11761 The same is true when you edit the
11762 <A HREF="h_config_inbox_path"><!--#echo var="VAR_inbox-path"--></A>
11763 option in Setup/Config.
11764 Each of these configuration methods will also create the DestinationFolder
11765 if it doesn't already exist.
11766 If you are having problems, make sure the DestinationFolder exists.
11767 You may find some more useful information about Mail Drops at
11768 <A HREF="h_maildrop">What is a Mail Drop?</A>.
11769 </DD>
11770 </DL>
11771 <P>
11772
11773 In addition, the server may support access to other user's folders,
11774 provided you have suitable permissions.  Common methods use a prefix
11775 of either &quot;~<VAR>user</VAR>/&quot;, or &quot;/<VAR>user</VAR>/&quot; to
11776 indicate the root of the other user's folder area.
11777
11778 <P>
11779 No, nothing's simple.
11780
11781 <P>
11782 &lt;End of help on this topic&gt;
11783 </BODY>
11784 </HTML>
11785 ============= h_whatis_vcard ========================
11786 <HTML>
11787 <HEAD>
11788 <TITLE>VCARD EXPLAINED</TITLE>
11789 </HEAD>
11790 <BODY>
11791 <H1>What is the vCard format?</H1>
11792 A &quot;vCard&quot; is a sort of electronic business card, for exchanging
11793 information about and among people and organizations electronically.
11794 More information about vCard can be found (as of May 1998) on the WWW site
11795 of the Internet Mail Consortium at the URL:
11796 <P>
11797 <CENTER><A HREF="http://www.imc.org/pdi/">http://www.imc.org/pdi/</A></CENTER>
11798 <P>
11799 &lt;End of help on this topic&gt;
11800 </BODY>
11801 </HTML>
11802 ===== h_folder_open =====
11803 <HTML>
11804 <HEAD>
11805 <TITLE>Explanation of Folder Selection</TITLE>
11806 </HEAD>
11807 <BODY>
11808 <BR>
11809 <BR>
11810 This screen is designed to allow you to quickly and easily survey your
11811 folders and select one to open.
11812 <!--chtml if pinemode="function_key"-->
11813 <PRE>
11814 Navigating the List of Folders             General Alpine Commands
11815 ------------------------------             -----------------------
11816  P   Move to previous folder               ?   Show this help text
11817  N   Move to next folder
11818  -   Show previous screen of folders
11819 Spc  (space bar) Show next screen
11820  W   WhereIs (search folder names)
11821
11822 Folder Selection Commands
11823 -------------------------
11824  E   Exit the Folder Select menu (without selecting a folder)
11825  S   Select the currently highlighted folder
11826 </PRE>
11827 <!--chtml else-->
11828 <PRE>
11829 Navigating the List of Folders             General Alpine Commands
11830 ------------------------------             -----------------------
11831 F5   Move to previous folder               F1  Show this help text
11832 F6   Move to next folder
11833 F7   Show previous screen of folders
11834 F8   Show next screen of folders
11835 F12  WhereIs (search folder names)
11836
11837 Folder Selection Commands
11838 -------------------------
11839 F3   Exit the Folder Select menu (without selecting a folder)
11840 F4   Select the currently highlighted folder
11841 </PRE>
11842 <!--chtml endif-->
11843 <P>
11844 FOR MORE INFORMATION: See the section on
11845 <A HREF="h_valid_folder_names">Valid Folder Names</A>.
11846 <P>
11847 &lt;End of help on this topic&gt;
11848 </BODY>
11849 </HTML>
11850 ===== h_folder_subscribe =====
11851 <HTML>
11852 <HEAD>
11853 <TITLE>Newsgroup Subscribe Screen explained</TITLE>
11854 </HEAD>
11855 <BODY>
11856 <H1>FOLDER SUBSCRIBE HELP</H1>
11857
11858 This screen is designed to help you subscribe to newsgroups you are
11859 not currently subscribed to.  The screen display is a list of all
11860 available newsgroups (or possibly a partial list if you specified a
11861 partial name when entering the screen).  Groups you have already
11862 subscribed to have the letters &quot;SUB&quot; next to them.  You may
11863 select a single new group to subscribe to by moving the cursor to that
11864 group and pressing &quot;S&quot; or carriage return.  Alternatively,
11865 you may change into ListMode with the &quot;ListMode&quot; command.
11866 The display will change slightly so that each group has a checkbox in
11867 front of it.  Use the cursor and the Set/Unset command to place an
11868 &quot;X&quot; in front of each newsgroup you wish to subscribe to.
11869 <P>
11870
11871 When you are finished marking groups, the &quot;Subscribe&quot;
11872 command will subscribe you to those groups you have marked.  Note, you
11873 may not unsubscribe to groups with this command.  Instead of the
11874 &quot;A&quot; &quot;Subscribe&quot; command, use the &quot;D&quot;
11875 UnSbscrbe command.
11876 <P>
11877
11878 <!--chtml if pinemode="function_key"-->
11879 <PRE>
11880 Navigating the List of Newsgroups          General Alpine Commands
11881 ---------------------------------          -----------------------
11882 F5   Move to previous group                F1   Show this help text
11883 F6   Move to next group
11884 F7   Show previous screen of groups
11885 F8   Show next screen of groups
11886 F12  WhereIs (search group names)
11887 F9   Use ListMode
11888
11889 Group Selection Commands
11890 -------------------------
11891 F3  Exit the News Subscribe menu (without selecting any groups)
11892 F4  Subscribe to the currently highlighted newsgroup
11893 </PRE>
11894 <!--chtml else-->
11895 <PRE>
11896 Navigating the List of Newsgroups          General Alpine Commands
11897 ---------------------------------          -----------------------
11898  P   Move to previous group                ?   Show this help text
11899  N   Move to next group
11900  -   Show previous screen of groups
11901 Spc  (space bar) Show next screen
11902  W   WhereIs (search group names)
11903  L   Use ListMode
11904
11905 Group Selection Commands
11906 -------------------------
11907  E   Exit the News Subscribe menu (without selecting any groups)
11908  S   Subscribe to the currently highlighted newsgroup
11909 </PRE>
11910 <!--chtml endif-->
11911 <P>
11912 When in ListMode, there is an additional command for marking groups to
11913 subscribe to:
11914 <P>
11915 <!--chtml if pinemode="function_key"-->
11916 <PRE>
11917 ListMode Commands
11918 -------------------------
11919 F9  Set or unset the highlighted group
11920 </PRE>
11921 <!--chtml else-->
11922 <PRE>
11923 ListMode Commands
11924 -------------------------
11925 X   Set or unset the highlighted group
11926 </PRE>
11927 <!--chtml endif-->
11928 <P>
11929 &lt;End of help on this topic&gt;
11930 </BODY>
11931 </HTML>
11932 ===== h_folder_postnews =====
11933 <HTML>
11934 <HEAD>
11935 <TITLE>Newsgroup selecting for Posting explained</TITLE>
11936 </HEAD>
11937 <BODY>
11938 This screen is designed to allow you to quickly and easily survey
11939 the available newsgroups and select one to post news to.
11940 <P>
11941 <!--chtml if pinemode="function_key"-->
11942 <PRE>
11943 Navigating the List of Newsgroups          General Alpine Commands
11944 ---------------------------------          -----------------------
11945 F5   Move to previous group                F1  Show this help text
11946 F6   Move to next group
11947 F7   Show previous screen of groups
11948 F8   Show next screen of groups
11949 F12  WhereIs (search group names)
11950
11951 Group Selection Commands
11952 -------------------------
11953 F3   Exit the Selection menu (without selecting a group)
11954 F4   Select the currently highlighted newsgroup
11955 </PRE>
11956 <!--chtml else-->
11957 <PRE>
11958 Navigating the List of Newsgroups          General Alpine Commands
11959 ---------------------------------          -----------------------
11960  P   Move to previous group                ?  Show this help text
11961  N   Move to next group
11962  -   Show previous screen of groups
11963 Spc  (space bar) Show next screen of groups
11964  W   WhereIs (search group names)
11965
11966 Group Selection Commands
11967 -------------------------
11968  E   Exit the Selection menu (without selecting a group)
11969  S   Select the currently highlighted newsgroup
11970 </PRE>
11971 <!--chtml endif-->
11972 <P>
11973 &lt;End of help on this topic&gt;
11974 </BODY>
11975 </HTML>
11976 ===== h_folder_save =====
11977 <HTML>
11978 <HEAD>
11979 <TITLE>Folder Select for Save Explained</TITLE>
11980 </HEAD>
11981 <BODY>
11982 This screen is designed to allow you to quickly and easily survey your
11983 folders and select one to use for saving the current message.
11984 <P>
11985
11986 <!--chtml if pinemode="function_key"-->
11987 <PRE>
11988 Navigating the List of Folders             General Alpine Commands
11989 ------------------------------             -----------------------
11990 F5   Move to previous folder               F1  Show this help text
11991 F6   Move to next folder
11992 F7   Show previous screen of folders
11993 F8   Show next screen of folders
11994 F12  WhereIs (search folder names)
11995
11996 Folder Selection Commands
11997 -------------------------
11998 F3   Exit the Folder Select menu (without selecting a folder)
11999 F4   Select the currently highlighted folder
12000 F11  AddNew folder (just like Select, but you type in a new folder name)
12001 </PRE>
12002 <!--chtml else-->
12003 <PRE>
12004 Navigating the List of Folders             General Alpine Commands
12005 ------------------------------             -----------------------
12006  P   Move to previous folder               ?  Show this help text
12007  N   Move to next folder
12008  -   Show previous screen of folders
12009 Spc  (space bar) Show next screen of folders
12010  W   WhereIs (search folder names)
12011
12012 Folder Selection Commands
12013 -------------------------
12014  E   Exit the Folder Select menu (without selecting a folder)
12015  S   Select the currently highlighted folder
12016  A   AddNew folder (just like Select, but you type in a new folder name)
12017 </PRE>
12018 <!--chtml endif-->
12019 <P>
12020 FOR MORE INFORMATION: See the section on
12021 <A HREF="h_valid_folder_names">Valid Folder Names</A>.
12022 <P>
12023 &lt;End of help on this topic&gt;
12024 </BODY>
12025 </HTML>
12026 ===== h_folder_fcc =====
12027 <HTML>
12028 <HEAD>
12029 <TITLE>Folder Select for Fcc Explained</TITLE>
12030 </HEAD>
12031 <BODY>
12032 This screen is designed to allow you to quickly and easily survey your
12033 folders and select one to use as the file carbon copy (fcc) for the
12034 current message.
12035 <P>
12036
12037 <!--chtml if pinemode="function_key"-->
12038 <PRE>
12039 Navigating the List of Folders             General Alpine Commands
12040 ------------------------------             -----------------------
12041 F5   Move to previous folder               F1  Show this help text
12042 F6   Move to next folder
12043 F7   Show previous screen of folders
12044 F8   Show next screen of folders
12045 F12  WhereIs (search folder names)
12046
12047 Folder Selection Commands
12048 -------------------------
12049 F3   Exit the Folder Select menu (without selecting a folder)
12050 F4   Select the currently highlighted folder
12051 F11  AddNew folder (just like Select, but you type in a new folder name)
12052 </PRE>
12053 <!--chtml else-->
12054 <PRE>
12055 Navigating the List of Folders             General Alpine Commands
12056 ------------------------------             -----------------------
12057  P   Move to previous folder               ?  Show this help text
12058  N   Move to next folder
12059  -   Show previous screen of folders
12060 Spc  (space bar) Show next screen of folders
12061  W   WhereIs (search folder names)
12062
12063 Folder Selection Commands
12064 -------------------------
12065  E   Exit the Folder Select menu (without selecting a folder)
12066  S   Select the currently highlighted folder
12067  A   AddNew folder (just like Select, but you type in a new folder name)
12068 </PRE>
12069 <!--chtml endif-->
12070 <P>
12071 FOR MORE INFORMATION: See the section on
12072 <A HREF="h_valid_folder_names">Valid Folder Names</A>.
12073 <P>
12074 &lt;End of help on this topic&gt;
12075 </BODY>
12076 </HTML>
12077 ===== h_folder_pattern_roles =====
12078 <HTML>
12079 <HEAD>
12080 <TITLE>Folder Select for Current Folder Explained</TITLE>
12081 </HEAD>
12082 <BODY>
12083 This screen is designed to allow you to quickly and easily survey your
12084 folders and select one to use as the specific Current Folder
12085 in a Pattern.
12086 <P>
12087
12088 <!--chtml if pinemode="function_key"-->
12089 <PRE>
12090 Navigating the List of Folders             General Alpine Commands
12091 ------------------------------             -----------------------
12092 F5   Move to previous folder               F1  Show this help text
12093 F6   Move to next folder
12094 F7   Show previous screen of folders
12095 F8   Show next screen of folders
12096 F12  WhereIs (search folder names)
12097
12098 Folder Selection Commands
12099 -------------------------
12100 F3   Exit the Folder Select menu (without selecting a folder)
12101 F4   Select the currently highlighted folder
12102 F11  AddNew folder (just like Select, but you type in a new folder name)
12103 </PRE>
12104 <!--chtml else-->
12105 <PRE>
12106 Navigating the List of Folders             General Alpine Commands
12107 ------------------------------             -----------------------
12108  P   Move to previous folder               ?  Show this help text
12109  N   Move to next folder
12110  -   Show previous screen of folders
12111 Spc  (space bar) Show next screen of folders
12112  W   WhereIs (search folder names)
12113
12114 Folder Selection Commands
12115 -------------------------
12116  E   Exit the Folder Select menu (without selecting a folder)
12117  S   Select the currently highlighted folder
12118  A   AddNew folder (just like Select, but you type in a new folder name)
12119 </PRE>
12120 <!--chtml endif-->
12121 <P>
12122 FOR MORE INFORMATION: See the section on
12123 <A HREF="h_valid_folder_names">Valid Folder Names</A>.
12124 <P>
12125 &lt;End of help on this topic&gt;
12126 </BODY>
12127 </HTML>
12128 ===== h_folder_stayopen_folders =====
12129 <HTML>
12130 <HEAD>
12131 <TITLE>Folder Select Explained</TITLE>
12132 </HEAD>
12133 <BODY>
12134 This screen is designed to allow you to quickly and easily survey your
12135 folders and select one to use as a Stay-Open folder.
12136 <P>
12137
12138 <!--chtml if pinemode="function_key"-->
12139 <PRE>
12140 Navigating the List of Folders             General Alpine Commands
12141 ------------------------------             -----------------------
12142 F5   Move to previous folder               F1  Show this help text
12143 F6   Move to next folder
12144 F7   Show previous screen of folders
12145 F8   Show next screen of folders
12146 F12  WhereIs (search folder names)
12147
12148 Folder Selection Commands
12149 -------------------------
12150 F3   Exit the Folder Select menu (without selecting a folder)
12151 F4   Select the currently highlighted folder
12152 F11  AddNew folder (just like Select, but you type in a new folder name)
12153 </PRE>
12154 <!--chtml else-->
12155 <PRE>
12156 Navigating the List of Folders             General Alpine Commands
12157 ------------------------------             -----------------------
12158  P   Move to previous folder               ?  Show this help text
12159  N   Move to next folder
12160  -   Show previous screen of folders
12161 Spc  (space bar) Show next screen of folders
12162  W   WhereIs (search folder names)
12163
12164 Folder Selection Commands
12165 -------------------------
12166  E   Exit the Folder Select menu (without selecting a folder)
12167  S   Select the currently highlighted folder
12168  A   AddNew folder (just like Select, but you type in a new folder name)
12169 </PRE>
12170 <!--chtml endif-->
12171 <P>
12172 FOR MORE INFORMATION: See the section on
12173 <A HREF="h_valid_folder_names">Valid Folder Names</A>.
12174 <P>
12175 &lt;End of help on this topic&gt;
12176 </BODY>
12177 </HTML>
12178 ===== h_folder_action_roles =====
12179 <HTML>
12180 <HEAD>
12181 <TITLE>Folder Select Explained</TITLE>
12182 </HEAD>
12183 <BODY>
12184 This screen is designed to allow you to quickly and easily survey your
12185 folders and select one to use as the folder into which messages
12186 matching this filter will be moved.
12187 <P>
12188
12189 <!--chtml if pinemode="function_key"-->
12190 <PRE>
12191 Navigating the List of Folders             General Alpine Commands
12192 ------------------------------             -----------------------
12193 F5   Move to previous folder               F1  Show this help text
12194 F6   Move to next folder
12195 F7   Show previous screen of folders
12196 F8   Show next screen of folders
12197 F12  WhereIs (search folder names)
12198
12199 Folder Selection Commands
12200 -------------------------
12201 F3   Exit the Folder Select menu (without selecting a folder)
12202 F4   Select the currently highlighted folder
12203 F11  AddNew folder (just like Select, but you type in a new folder name)
12204 </PRE>
12205 <!--chtml else-->
12206 <PRE>
12207 Navigating the List of Folders             General Alpine Commands
12208 ------------------------------             -----------------------
12209  P   Move to previous folder               ?  Show this help text
12210  N   Move to next folder
12211  -   Show previous screen of folders
12212 Spc  (space bar) Show next screen of folders
12213  W   WhereIs (search folder names)
12214
12215 Folder Selection Commands
12216 -------------------------
12217  E   Exit the Folder Select menu (without selecting a folder)
12218  S   Select the currently highlighted folder
12219  A   AddNew folder (just like Select, but you type in a new folder name)
12220 </PRE>
12221 <!--chtml endif-->
12222 <P>
12223 FOR MORE INFORMATION: See the section on
12224 <A HREF="h_valid_folder_names">Valid Folder Names</A>.
12225 <P>
12226 &lt;End of help on this topic&gt;
12227 </BODY>
12228 </HTML>
12229 ===== h_abook_config =====
12230 <HTML>
12231 <HEAD>
12232 <TITLE>SETUP ADDRESS BOOKS SCREEN</TITLE>
12233 </HEAD>
12234 <BODY>
12235 <H1>SETUP ADDRESS BOOKS SCREEN</H1>
12236 <H2>SETUP ADDRESS BOOKS COMMANDS</H2>
12237 <!--chtml if pinemode="function_key"-->
12238 <PRE>
12239 Available  Commands
12240 -------------------------------
12241 F1  Show Help Text
12242 F3  Back to MAIN Alpine menu
12243 F4  Change configuration for address book
12244 F5  Move to previous address book
12245 F6  Move to next address book
12246 F7  Previous page of address books
12247 F8  Next page of address books
12248 F9  Add new address book
12249 F10 Delete existing address book
12250 F11 Shuffle the order of address books
12251 F12 Whereis (search address book titles)
12252 </PRE>
12253 <!--chtml else-->
12254 <PRE>
12255 Navigation                     General Alpine Commands
12256 -----------------------        -----------------------
12257  P  Prev Address Book           ?  Display this help text
12258  N  Next Address Book           E  Back to MAIN Alpine menu
12259  -  Previous page
12260 Spc (space bar) Next page
12261  W  WhereIs (search for word in address book titles)
12262
12263 Setup Address Books Commands
12264 ------------------------------------------------
12265  A  Add new address book          $  Shuffle the order of address books
12266  D  Delete existing address book  C  Change configuration for address book
12267 </PRE>
12268 <!--chtml endif-->
12269
12270 <H2>Description of the Setup Address Books Screen</H2>
12271
12272 This screen lets you add, delete, modify, or change the order of your
12273 address books.  The &quot;Add Abook&quot; command brings up a blank form to
12274 fill in.  If you are adding a remote address book on an IMAP server
12275 you should fill in the name of the IMAP server.  Otherwise, leave
12276 that field blank.  (Note that remote IMAP address books are an Alpine
12277 concept and are unlikely to interoperate with other mail clients.)
12278 For a remote address book, fill in the name of the remote folder
12279 in the Folder field.  This should be a folder that is used only for
12280 this one purpose, not a general purpose folder you expect to store
12281 messages in.
12282 <P>If you are adding a local address book, fill in the
12283 Folder Name field with a local file name (e.g., .addressbook).
12284 <P>
12285 <B>Please note:</B> Remote address books stored on an IMAP server are
12286 of an entirely different format (namely, a special-purpose
12287 &quot;mail folder&quot;) than that of the local addressbook familiar
12288 to Alpine users.  Therefore,
12289 you cannot use &quot;add a remote address book&quot; to make an existing
12290 Alpine .addressbook file you may have on a remote IMAP server accessible to
12291 Alpine running on a different host.
12292 <P>
12293
12294 The &quot;Del Abook&quot; command allows you to remove an address book
12295 from your configuration.  It will also ask you if you wish to remove
12296 the data for that address book, which would erase all traces of the
12297 address book if you answer Yes.
12298 <P>
12299
12300 The &quot;Change&quot; command is similar to the &quot;Add Abook&quot; command.
12301 The difference is that instead of adding a new address book to your
12302 configuration, you are changing the configuration of an existing entry.
12303 For example, you might want to correct a typing error or change a
12304 nickname.  The &quot;Change&quot; command is not a move command.  If you
12305 change the folder name or server name the data will not be moved for you.
12306 <P>
12307
12308 The &quot;Shuffle&quot; command is used for two purposes.  If you shuffle
12309 an address book toward another address book in the same group then
12310 the order of those two address books will be swapped.  If you shuffle
12311 the last Personal address book down towards the Global address book
12312 section, it will become a Global address book.  If you shuffle
12313 the first Global address book up it will become a Personal address
12314 book.  The main difference between Personal and Global address
12315 books is that Global address books are forced read-only.
12316 <P><UL>
12317 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
12318 </UL>
12319 <P>
12320 &lt;End of help on this topic&gt;
12321 </BODY>
12322 </HTML>
12323 ===== h_abook_top =====
12324 <HTML>
12325 <HEAD>
12326 <TITLE>ADDRESS BOOK LIST COMMANDS</TITLE>
12327 </HEAD>
12328 <BODY>
12329 <H1>ADDRESS BOOK LIST COMMANDS</H1>
12330 <!--chtml if pinemode="function_key"-->
12331 <PRE>
12332 Available  Commands -- Group 1         Available Commands -- Group 2
12333 -------------------------------        ------------------------------
12334 F1  Show Help Text                      F1  Show Help Text
12335 F2  See commands in next group          F2  See commands in next group
12336 F3  Exit to MAIN MENU                   F3  Quit Alpine
12337 F4  View/Edit selected address book
12338 F5  Move to previous address book       F5  FOLDER LIST screen
12339 F6  Move to next address book           F6  Specify a folder to go to
12340 F7  Previous page                       F7  MESSAGE INDEX screen
12341 F8  Next page                           F9  Print list of address books
12342 F12 Whereis (search for word)
12343 </PRE>
12344 <!--chtml else-->
12345 <PRE>
12346 Navigation                       General Alpine Commands
12347 -----------------------          -----------------------
12348  P  Previous Entry                ?  Display this help text
12349  N  Next Entry                    O  Show all other available commands
12350  -  Previous page                 &lt;  Back to MAIN Alpine menu
12351 Spc (space bar) Next page         Q  Quit Alpine
12352  W  WhereIs (search for word)     L  FOLDER LIST screen
12353                                   G  Specify a folder to go to
12354 Address Book Commands             I  MESSAGE INDEX screen
12355 ------------------------------------------------
12356  &gt;  View/Edit selected address book
12357               or
12358  &gt;  Search on selected directory server
12359
12360  %  Print list of address books and directory servers
12361 </PRE>
12362 <!--chtml endif-->
12363
12364 <H2>Description of the Address Book List Screen</H2>
12365
12366 From this screen you may choose which address book you wish to view
12367 or edit. For more information on address books, view one of your
12368 address books (with
12369 <!--chtml if pinemode="function_key"-->
12370 F4
12371 <!--chtml else-->
12372 &quot;&gt;&quot;
12373 <!--chtml endif-->)
12374 and see the Help Text there.<P>
12375
12376 You may also choose a directory server on which to search for entries.
12377 You do that by highlighting the directory server line and using
12378 <!--chtml if pinemode="function_key"-->
12379 F4
12380 <!--chtml else-->
12381 &quot;&gt;&quot;
12382 <!--chtml endif-->.<P>
12383
12384 If you wish to define new address books or directory servers go to the Main
12385 menu and choose Setup. You may then either choose to setup AddressBooks or
12386 Directory (among other things). It's possible that the Directory option
12387 will not be there if the Alpine you are using does not contain LDAP directory
12388 lookup functionality.
12389
12390 <P><UL>
12391 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
12392 </UL><P>
12393 &lt;End of help on this topic&gt;
12394 </BODY>
12395 </HTML>
12396 ===== h_abook_opened =====
12397 <HTML>
12398 <HEAD>
12399 <TITLE>THE ALPINE ADDRESS BOOK</TITLE>
12400 </HEAD>
12401 <BODY>
12402 <H1>THE ALPINE ADDRESS BOOK</H1>
12403 <H2>ADDRESS BOOK COMMANDS</H2>
12404 <PRE>
12405 <!--chtml if pinemode="function_key"-->
12406 Available  Commands -- Group 1         Available Commands -- Group 2
12407 -------------------------------        ------------------------------
12408 F1  Show Help Text                      F1  Show Help Text
12409 F2  See commands in next group          F2  See commands in next group
12410 F3  Exit this screen                    F3  Quit Alpine
12411 F4  View/Edit selected entry            F4  Go to MAIN MENU screen
12412 F5  Move to previous entry              F5  FOLDER LIST screen
12413 F6  Move to next entry                  F6  Specify a folder to go to
12414 F7  Previous page of address book       F7  MESSAGE INDEX screen
12415 F8  Next page of address book           F8  Compose to entry using roles
12416 F9  Add new entry to address book       F9  Print address book
12417 F10 Delete selected entry               F10 TakeAddr to another addrbook
12418 F11 Compose to selected entry           F11 Save or Export addrbook selections
12419 F12 Whereis (search address book)       F12 Forward entry by mail
12420
12421 Available Commands -- Group 3
12422 ------------------------------
12423 F3  Select                              F6  Zoom (or unZoom)
12424 F5  Select Current                      F7  Apply Command to Selection
12425 <!--chtml else-->
12426 Address Book Navigation        General Alpine Commands
12427 -----------------------        -----------------------
12428  P  Prev Address                  ?  Display this help text
12429  N  Next Address                  O  Show all other available commands
12430  -  Previous page of address book M  Back to MAIN MENU
12431 Spc (space bar) Next page         Q  Quit Alpine
12432  W  WhereIs (search for word      C  Compose message to selected addr
12433      or name in address book)     #  Compose to addr using roles
12434  &lt;  To List of Address Books if   L  FOLDER LIST screen
12435      more than one, else to MAIN  G  Specify a folder to go to
12436                                   I  MESSAGE INDEX screen
12437
12438 Address Book Commands
12439 ----------------------------------------------------
12440  &gt;  View/Update selected entry    D  Delete selected entries
12441  %  Print address book            S  Save or Export address book selections
12442  F  Forward entries by mail       @  Add new entry to address book
12443
12444  ;  Select command                Z  Toggle Zoom Mode
12445  :  Select highlighted entry      A  Apply command to selected entries
12446
12447 <!--chtml endif-->
12448 </PRE>
12449 Note:  The presence or absence of the final four commands above is
12450 controlled by the option
12451 <A HREF="h_config_enable_agg_ops">&quot;<!--#echo var="FEAT_enable-aggregate-command-set"-->&quot;</A>.
12452 <P>
12453
12454 <H2>Description of the Address Book Screen</H2>
12455
12456 This screen lets you edit and manage entries in your address book.  It
12457 also acts as a short-cut for composing messages to people in the address
12458 book.  When, from this screen, you press <!--chtml if pinemode="function_key"-->F11<!--chtml else-->&quot;C&quot;<!--chtml endif--> for ComposeTo, the
12459 message starts &quot;pre-addressed&quot; to whatever address book entry is
12460 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
12461 role to use in your composition.
12462 <P>
12463 Alpine's address book helps you keep a list of addresses you send email to so
12464 you do not have to remember addresses that are often complex.  Each entry
12465 in the address book has five fields, all of them optional.  The three
12466 elements that are usually visible on the ADDRESS BOOK display, are: <DL>
12467
12468         <P><DT>NICKNAME: <DD>A short easy-to-remember label to identify the entry.
12469         This is what you type in as you are addressing the message in the
12470         composer.  If there is a matching entry in your address book(s),
12471         Alpine will extract the corresponding FullName and Address fields to
12472         generate the actual address for your message.
12473
12474         <P><DT>FULLNAME: <DD>A longer field where you can put the full name
12475 of the
12476         person or organization.  Usually the full names are put in last
12477         name first so they sort nicely in alphabetical order.  Whatever
12478         you put as the name here will appear on the message when it is
12479         finally delivered.  Examples:<PRE>
12480            Garcia Marquez, Gabriel
12481            Henscheid, Eckhard
12482            Alpine-Info mailing list
12483            Library materials renewal requests
12484            Kim An-guk
12485            &quot;George III, King of Great Britain, 1738-1820&quot;
12486 </PRE>
12487 (In the second-to-last example, no comma is used in the name so that
12488 the family name appears first in the address book and when the entry is
12489 used in the composer.
12490 In the last example, retaining the commas is intended;
12491 double-quotation marks surround the name to
12492 prevent the transposition of its parts when the entry is used in
12493 the composer.)
12494
12495         <P><DT>ADDRESS: <DD>This is the actual email address itself.  This must be
12496         a valid Internet address that conforms to the Internet message
12497         header standard, RFC-822.  (See also <A HREF="h_address_format">Explanation of Address formats</A>.)</DL>
12498
12499 The two fields that aren't usually visible are:<DL>
12500
12501   <P><DT>FCC: <DD>The name of the folder you would like a copy of any outgoing
12502         message to this address to be saved in.  If this field is set, and
12503         this address is the first one in the message's To: header, then
12504         Alpine will use this folder name for the FCC in lieu of the normal
12505         FCC folder name.
12506
12507   <P><DT>COMMENTS: <DD>This field contains arbitrary text for your convenience.
12508         </DL>
12509 <P>
12510 Due to screen width limitations, these last two fields do not show up in
12511 the normal ADDRESS BOOK display.  You may select the
12512 &quot;View/Update&quot; command to
12513 view or modify them.  You may use the configuration variable
12514 <A HREF="h_config_abook_formats">&quot;<!--#echo var="VAR_addressbook-formats"-->&quot;</A>
12515 to add these fields to your ADDRESS BOOK
12516 display, or to modify the format of the display.
12517
12518 <H2>Sorting the Address book</H2>
12519
12520 By default, address book entries are sorted alphabetically on the full
12521 name with distribution lists sorted to the end.  Sorting can be changed by
12522 resetting the address book sort rule in the Alpine SETUP CONFIGURATION screen
12523 --assuming you have &quot;write&quot; permission for the address book file.
12524 <P>
12525 Unlike the sorting of folders (which only changes presentation), sorting an
12526 address book actually changes the file as it is kept on the computer.  For
12527 this reason you won't be able to sort a shared or system-wide address
12528 book.
12529
12530 <H2>Adding New Entries</H2>
12531
12532 The easiest way to add new entries to your address book is to use the
12533 &quot;TakeAddr&quot; command when viewing a message.
12534 This command allows you to take addresses from the header and body of the
12535 message and put them into your address book, without having to type
12536 them in.
12537 <P>
12538
12539 To manually add a new entry from within the address book screen, use the AddNew
12540 (<!--chtml if pinemode="function_key"-->F9<!--chtml else-->&quot;@&quot;<!--chtml endif-->) command.
12541 Use this command both for adding a simple alias and for adding a
12542 distribution list.
12543
12544 <H2>Distribution Lists</H2>
12545
12546 Address book entries can be simple cases of aliases (a single nickname is linked
12547 to a single email address) or distribution lists (a single nickname
12548 pointing at more than one email address).  Each distribution list has a
12549 nickname, a full name and a list of addresses.  The addresses may be
12550 actual addresses or they may be other nicknames in your address book.
12551 They may even refer to other distribution lists.
12552 There's really no difference between a simple alias and a distribution list,
12553 other than the number of addresses.
12554 Therefore, you can turn a simple alias with one address into a distribution
12555 list simply by adding more addresses.
12556 To add entries to an existing list or alias
12557 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
12558 a single address from the list if the cursor is placed on the address;
12559 it will delete the entire distribution list if the cursor is on the
12560 nickname/fullname line.  View/Update may also be used to delete addresses
12561 from a list.
12562 <P>
12563 Address field entries in distribution lists may take any one of three
12564 forms: a nickname existing in any of the defined address books, a normal
12565 address of the form &quot;jsmith@art.example.com&quot;, or a complete
12566 fullname/address combination, e.g. &quot;John Smith
12567 &lt;jsmith@art.example.com&gt;&quot;.
12568 <P>
12569 Distribution lists in Alpine address books can only be used by the person or
12570 people who have access to that address book.  They are not usually used to
12571 implement discussion groups, but can be used to facilitate small
12572 discussion groups if all the participants have access to the same shared
12573 address book.
12574
12575 <H2>FCC and Comments</H2>
12576
12577 As mentioned above, each entry in the address book also has two other optional
12578 fields, Fcc and Comments.  The command to look at or change either of these
12579 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
12580 Comments field is just for your own use.  The Fcc field overrides the
12581 default Fcc if this address is the first one on the To line.  The WhereIs
12582 command may be used to search for particular strings in the address book,
12583 including fields that are not visible (like Comment and Fcc by default).
12584
12585 <H2>Aggregate Operations</H2>
12586
12587 If the feature
12588 <A HREF="h_config_enable_agg_ops">&quot;<!--#echo var="FEAT_enable-aggregate-command-set"-->&quot;</A>
12589 is turned on (the default), then the four commands &quot;Select&quot;,
12590 &quot;Select Current&quot;, &quot;Zoom&quot;, and &quot;Apply&quot;
12591 are available.  The two selection commands allow you to mark a set of
12592 address book entries as being selected.  If you have more than one address
12593 book, the selections may be in more than one of those address books.
12594 The &quot;Zoom&quot; command will toggle between displaying only the selected
12595 entries and all of the entries.  The &quot;Apply&quot; command allows you to
12596 apply one of the regular address book commands to all of the selected
12597 entries.  Usually the address book commands apply to only the entry
12598 highlighted by the cursor.  The &quot;Apply&quot; command works with the
12599 commands &quot;ComposeTo&quot;, &quot;Delete&quot;, &quot;Print&quot;,
12600 &quot;Save&quot;, &quot;Forward&quot;, and &quot;Role&quot;.
12601
12602 <H2>Exporting and Forwarding Address book entries</H2>
12603
12604 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
12605 address book entry is placed in a plain text file in your home directory
12606 <!--chtml if pinemode="running"-->
12607 (which, in the present configuration of your system, is
12608  &quot;<!--#echo var="HOME_DIR"-->&quot;)
12609 <!--chtml endif-->
12610 or current working directory
12611 <!--chtml if pinemode="running"-->
12612 (which, at least for your current Alpine &quot;session,&quot;
12613 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
12614 <!--chtml endif-->, depending on the
12615 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
12616 configuration setting.  If you have some entries selected and use the
12617 Apply (<!--chtml if pinemode="function_key"-->F7<!--chtml else-->&quot;A&quot;<!--chtml endif-->) Export command, all of the selected addresses will be
12618 placed in the text file.
12619 <P>
12620 When you use the Forward (<!--chtml if pinemode="function_key"-->F12<!--chtml else-->&quot;F&quot;<!--chtml endif-->) command, the currently highlighted
12621 address book entry is placed in a special attachment and you are put into
12622 the composer.  You can fill in some comments in the body of the message,
12623 if you'd like, and send it to somebody else who uses Alpine.  The recipient
12624 may use the TakeAddr command on that message to insert the address book
12625 entry you sent in their own address book.  If you have some entries
12626 selected and use the Apply Forward command all of the selected entries
12627 will be forwarded in a single message.  You may
12628 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.
12629 The recipient must be using Alpine in order to receive this correctly.
12630 One way for the recipient to handle this might be to create an empty
12631 address book and then &quot;Take&quot; your forwarded address book entries into
12632 that empty address book.
12633
12634 <H2>Multiple and/or Site-Wide Address books</H2>
12635
12636 You may have more than one personal address book.  In addition, there may
12637 be one or more global address books.  This capability allows you to have
12638 multiple personal address books (some of which may be shared) and it also
12639 allows system administrators to implement site-wide address books that
12640 contain entries for users on multiple machines within the organization.
12641 <P><DL>
12642 <DT>Searching
12643   <DD> If you enter a nickname when composing a message, your
12644   personal address books will be searched through in order, and then the
12645   global address book(s) searched. If more than one address book has an entry
12646   for the nickname, Alpine uses the first one that it finds, so an entry in
12647   your personal address book would override a global address book entry. If
12648   after searching all the address books there is still no match, (Unix) Alpine
12649   then searches the local host password file on the assumption that you have
12650   entered a local user name rather than an address book nickname.
12651   You may change the search order of your address books with the <!--chtml if pinemode="function_key"-->F3<!--chtml else-->$<!--chtml endif--> Shuffle
12652   command, but global address books are always searched after personal
12653   address books.
12654
12655   <P><DT>Tab completion
12656   <DD> If the
12657   <A HREF="h_config_enable_tab_complete"><!--#echo var="FEAT_enable-tab-completion"--></A>
12658   feature is turned on (the default) then the Tab key may be used
12659   in the composer to complete partially typed nicknames in the To
12660   or Cc lines. You type the first few letters of a nickname and then
12661   press the Tab key. It there is only one nickname that matches it will
12662   be filled in by Alpine. If there is more than one the unambiguous part
12663   of the nicknames will be filled in. For example, if your address book or
12664   books contains only the two entries &quot;barley&quot; and &quot;barbecue&quot;
12665   beginning with the letters &quot;ba&quot;, then if you type &quot;ba&quot;
12666   followed by a Tab character Alpine will fill in &quot;bar&quot; and stop.
12667   If you then type a second Tab character you will be presented with a list
12668   of matching nicknames to select from. Alternatively, you could type another
12669   &quot;b&quot; resulting in &quot;barb&quot; and then a Tab would fill
12670   in the entire &quot;barbecue&quot; entry.
12671
12672   <P><DT>Defining
12673   <DD> You define multiple personal address books in the
12674   <A HREF="h_abook_config">SETUP AddressBooks</A> screen, which you may reach
12675   from the MAIN MENU.
12676   You may add as many as you like.  Global address books are usually
12677   site-wide address books defined by the System administrator, but
12678   you may define global address books of your own just like you define
12679   personal address books.
12680
12681   <P><DT>Creating and updating
12682   <DD> Personal address books are normally created empty
12683   and populated by explicit additions from within Alpine, e.g. via the
12684   TakeAddr command.  Unlike personal address books, global address books may
12685   not be modified/updated from within Alpine; that is, they are Read-Only.
12686   Thus, global address books are created, populated and updated outside of
12687   Alpine. They might be hand-edited, generated by a program from another
12688   database, or by copying an existing address book.  They might also be
12689   some other user's personal address book, and so be modified normally by
12690   that user but accessed Read-Only by you.  See the Alpine Technical
12691   Notes document (included in the Alpine distribution) for more information on
12692   this.
12693
12694   <P><DT>Accessing
12695   <DD>There are two different types of address books in Alpine.
12696   A local address book is stored in a regular file and the normal file
12697   access permissions apply.  A remote address book is stored on an IMAP
12698   server in a special folder that contains only messages pertaining to
12699   that address book.  The last message in the remote folder contains a
12700   copy of the address book data, and that data is copied to a local cache
12701   file in your home directory.  From there it is accessed just like a local
12702   address book.  The name of the cache file is kept track of in a special
12703   file called the
12704   <A HREF="h_config_abook_metafile"><!--#echo var="VAR_remote-abook-metafile"--></A>,
12705   the name of which is stored in
12706   your Alpine configuration file the first time you use a remote address book.
12707   Just as local Alpine address books use a format that only Alpine understands,
12708   remote Alpine address books do the same and other mail reading programs
12709   are unlikely to be able to understand them.<P>
12710   While global address books are explicitly intended to be shared, there is
12711   nothing to prevent you from sharing a personal address book with other
12712   Alpine users. This might be useful in the case of a small workgroup.
12713   However, it is recommended that updates to shared personal address books
12714   be done when other Alpine users are not accessing the address book. Alpine
12715   does not do any file-locking to manage concurrent updates to the
12716   addressbook, but it does check to see if the file has been modified before
12717   making any changes.  Consequently, inadvertent concurrent updates will
12718   only cause other Alpine users to have to restart their address book
12719   operation, which will cause Alpine to reopen the updated file.
12720
12721   <P><DT>Converting to Remote
12722   <DD>The easiest way to convert an existing local
12723   address book into a remote address book is to create an empty new remote
12724   personal address book by typing &quot;A&quot; to execute the
12725   &quot;Add Pers Abook&quot; command in the SETUP Addressbook screen.
12726   Make sure you add a <EM>personal</EM> address book, not a <EM>global</EM>
12727   address book.
12728   After you have added the empty
12729   remote address book, go into the screen for the address book you wish
12730   to copy and &quot;Select&quot; &quot;All&quot;.
12731   This selects every entry in that
12732   address book.  Then type the command &quot;Apply Save&quot;.
12733   You will be asked for the address book to save to.  You may use ^P and ^N
12734   to get to the new empty address book, then hit RETURN and the addresses
12735   will be copied.
12736   At this point you'll probably want to unselect all the entries in the local
12737   address book before proceeding. You do that with
12738   &quot;Select&quot; &quot;unselect All&quot;.
12739
12740 </DL>
12741 <UL>
12742 <LI><A HREF="h_address_format">Explanation of Address formats</A>
12743 </UL>
12744 <P><UL>
12745 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
12746 </UL>
12747 <P>
12748 &lt;End of help on this topic&gt;
12749 </BODY>
12750 </HTML>
12751 ===== h_abook_select_addr =====
12752 <HTML>
12753 <HEAD>
12754 <TITLE>Addressbook Selection Explained</TITLE>
12755 </HEAD>
12756 <BODY>
12757 <H1>SELECT ADDRESS</H1>
12758 <!--chtml if pinemode="function_key"-->
12759 <PRE>
12760 Navigating the List of Messages               General Alpine Commands
12761 -------------------------------               -----------------------
12762 F5   Move to previous entry                   F1  Show this help text
12763 F6   Move to next entry
12764 F7   Show previous screen of address book
12765 F8   Show next screen of address book
12766 F12  WhereIs (search through address book)
12767
12768 Address Selection Commands
12769 --------------------------
12770 F3   Exit the Address Select screen (without selecting an address)
12771 F4   Select the currently highlighted entry
12772 </PRE>
12773 <!--chtml else-->
12774 <PRE>
12775 Navigating the List of Messages               General Alpine Commands
12776 -------------------------------               -----------------------
12777  P   Move to previous entry                    ?  Show this help text
12778  N   Move to next entry
12779  -   Show previous screen of address book
12780 Spc  (space bar) Show next screen of address book
12781  W   WhereIs (search through address book)
12782
12783 Address Selection Commands
12784 --------------------------
12785  E   Exit the Address Select screen (without selecting an address)
12786  S   Select the currently highlighted entry
12787 </PRE>
12788 <!--chtml endif-->
12789 <P>
12790
12791 This screen is designed to let you easily scan your address book(s) in
12792 order to select an entry for the message you are composing.  You cannot
12793 edit your address book in any way at this time, for address book
12794 maintenance, select the address book command when not composing a message.
12795 <P>
12796
12797 If you are composing a message and know the nickname of the person/list you
12798 want, you can bypass this screen by simply typing in the nickname on the
12799 appropriate header line (To:, Cc:, etc.)  Exiting this screen without
12800 selecting an entry does not cancel your message.
12801 <P>
12802
12803 FOR MORE INFORMATION on addressing see
12804 <A HREF="h_address_format">Explanation of Address formats</A>, and the
12805 <A HREF="h_abook_opened">Address Book Screen's</A>
12806 help text.
12807 <P>
12808 &lt;End of help on this topic&gt;
12809 </BODY>
12810 </HTML>
12811 ===== h_abook_select_top =====
12812 <HTML>
12813 <HEAD>
12814 <TITLE>Addressbook Selection Navigation Explained</TITLE>
12815 </HEAD>
12816 <BODY>
12817 <H1>NAVIGATING WHILE SELECTING ADDRESSES</H1>
12818 <!--chtml if pinemode="function_key"-->
12819 <PRE>
12820 Navigating the List of Address Books       General Alpine Commands
12821 ------------------------------------       -----------------------
12822 F4   View the highlighted address book
12823 F5   Move to previous address book         F1  Show this help text
12824 F6   Move to next address book
12825 F7   Show previous screen of address books
12826 F8   Show next screen of address books
12827 F12  WhereIs (search through address books)
12828
12829 Address Selection Commands
12830 --------------------------
12831 F3   Exit the Address Select screen (without selecting an address)
12832 F4   Select the currently selected entries (if using ListMode)
12833 F9   Change to ListMode
12834 </PRE>
12835 <!--chtml else-->
12836 <PRE>
12837 Navigating the List of Address Books       General Alpine Commands
12838 ------------------------------------       -----------------------
12839  &gt;   View the highlighted address book
12840  P   Move to previous address book         ?  Show this help text
12841  N   Move to next address book
12842  -   Show previous screen of address books
12843 Spc  (space bar) Show next screen of address books
12844  W   WhereIs (search through address books)
12845
12846 Address Selection Commands
12847 --------------------------
12848  E   Exit the Address Select screen (without selecting an address)
12849  S   Select the currently selected entries (if using ListMode)
12850  L   Change to ListMode
12851 </PRE>
12852 <!--chtml endif-->
12853 <P>
12854
12855 This screen is designed to let you easily scan your address book(s) in
12856 order to select entries for the message you are composing.  You cannot
12857 edit your address book in any way at this time.  For address book
12858 maintenance, select the address book command when not composing a message.
12859 <P>
12860
12861 If you are composing a message and know the nickname of the person/list you
12862 want, you can bypass this screen by simply typing in the nickname on the
12863 appropriate header line (To:, Cc:, etc.)  Exiting this screen without
12864 selecting an entry does not cancel your message.
12865 <P>
12866
12867 The ListMode command will add a column at the left edge of the screen.
12868 You mark the entries that you wish to select with the &quot;X&quot; command.
12869 This allows you to choose more than one entry at a time.
12870 <P>
12871
12872 An alternative method of composing a message to entries in your
12873 address book(s) is to first use the &quot;Select&quot; command from
12874 the address book maintenance screen and then the &quot;Apply&quot;
12875 &quot;ComposeTo&quot; command to start the composer composing to the
12876 selected entries.
12877 <P>
12878
12879 FOR MORE INFORMATION on addressing see
12880 <A HREF="h_address_format">Explanation of Address formats</A>, and the
12881 <A HREF="h_abook_opened">Address Book Screen's</A>
12882 help text.
12883 <P>
12884 &lt;End of help on this topic&gt;
12885 </BODY>
12886 </HTML>
12887 ===== h_abook_select_listmode =====
12888 <HTML>
12889 <HEAD>
12890 <TITLE>Address Listmode Selection from Composer Explained</TITLE>
12891 </HEAD>
12892 <BODY>
12893 <H1>COMPOSER: SELECT ADDRESSES</H1>
12894 <!--chtml if pinemode="function_key"-->
12895 <PRE>
12896 Navigating the List of Messages                 General Alpine Commands
12897 -------------------------------                 -----------------------
12898 F5   Move to previous entry                     F1  Show this help text
12899 F6   Move to next entry
12900 F7   Show previous screen of address book
12901 F8   Show next screen of address book
12902 F12  WhereIs (search through address book)
12903
12904 Address Selection Commands
12905 --------------------------
12906 F3   Exit the Address Select screen (without selecting an address)
12907 F4   Select the currently highlighted entry
12908 F9   Change to ListMode
12909 </PRE>
12910 <!--chtml else-->
12911 <PRE>
12912 Navigating the List of Messages                 General Alpine Commands
12913 -------------------------------                 -----------------------
12914  P   Move to previous entry                     ?  Show this help text
12915  N   Move to next entry
12916  -   Show previous screen of address book
12917 Spc  (space bar) Show next screen of address book
12918  W   WhereIs (search through address book)
12919
12920 Address Selection Commands
12921 --------------------------
12922  E   Exit the Address Select screen (without selecting an address)
12923  S   Select the currently highlighted entry
12924  L   Change to ListMode
12925 </PRE>
12926 <!--chtml endif-->
12927 <P>
12928
12929 This screen is designed to let you easily scan your address book(s) in
12930 order to select entries for the message you are composing.  You cannot
12931 edit your address book in any way at this time, for address book
12932 maintenance, select the address book command when not composing a message.
12933 <P>
12934
12935 If you are composing a message and know the nickname of the person/list you
12936 want, you can bypass this screen by simply typing in the nickname on the
12937 appropriate header line (To:, Cc:, etc.)  Exiting this screen without
12938 selecting an entry does not cancel your message.
12939 <P>
12940
12941 The ListMode command will add a column at the left edge of the screen.
12942 You mark the entries that you wish to select with the &quot;X&quot; command.
12943 This allows you to choose more than one entry at a time.
12944 <P>
12945
12946 An alternative method of composing a message to entries in your
12947 address book(s) is to first use the &quot;Select&quot; command from
12948 the address book maintenance screen and then the &quot;Apply&quot;
12949 &quot;ComposeTo&quot; command to start the composer composing to the
12950 selected entries.
12951 <P>
12952
12953 FOR MORE INFORMATION on addressing see
12954 <A HREF="h_address_format">Explanation of Address formats</A>, and the
12955 <A HREF="h_abook_opened">Address Book Screen's</A>
12956 help text.
12957 <P>
12958 &lt;End of help on this topic&gt;
12959 </BODY>
12960 </HTML>
12961 ===== h_abook_select_checks =====
12962 <HTML>
12963 <HEAD>
12964 <TITLE>Address Selection from Composer Explained</TITLE>
12965 </HEAD>
12966 <BODY>
12967 <H1>COMPOSER: SELECT ADDRESSES</H1>
12968 <!--chtml if pinemode="function_key"-->
12969 <PRE>
12970 Navigating the List of Messages                 General Alpine Commands
12971 -------------------------------                 -----------------------
12972 F5   Move to previous entry                     F1  Show this help text
12973 F6   Move to next entry
12974 F7   Show previous screen of address book
12975 F8   Show next screen of address book
12976 F12  WhereIs (search through address book)
12977
12978 Address Selection Commands
12979 --------------------------
12980 F3   Exit the Address Select screen (without selecting an address)
12981 F4   Select the currently highlighted entry
12982 F8   Either Sets or Unsets all entries in this address book
12983 F9   Set or Unset the highlighted entry
12984 </PRE>
12985 <!--chtml else-->
12986 <PRE>
12987 Navigating the List of Messages                 General Alpine Commands
12988 -------------------------------                 -----------------------
12989  P   Move to previous entry                     ?  Show this help text
12990  N   Move to next entry
12991  -   Show previous screen of address book
12992 Spc  (space bar) Show next screen of address book
12993  W   WhereIs (search through address book)
12994
12995 Address Selection Commands
12996 --------------------------
12997  E   Exit the Address Select screen (without selecting an address)
12998  S   Select the currently highlighted entry
12999  X   Set or Unset the highlighted entry
13000  A   Either Sets or Unsets all entries in this address book
13001 </PRE>
13002 <!--chtml endif-->
13003 <P>
13004
13005 Mark the entries you wish to select with the &quot;X Set/Unset&quot;
13006 command.  Type &quot;S Select&quot; to select all of the entries you
13007 have marked, just as if you had typed them in by hand.
13008 <P>
13009
13010 An alternative method of composing a message to entries in your
13011 address book(s) is to first use the &quot;Select&quot; command from
13012 the address book maintenance screen and then the &quot;Apply&quot;
13013 &quot;ComposeTo&quot; command to start the composer composing to the
13014 selected entries.
13015 <P>
13016
13017 FOR MORE INFORMATION on addressing see
13018 <A HREF="h_address_format">Explanation of Address formats</A>, and the
13019 <A HREF="h_abook_opened">Address Book Screen's</A>
13020 help text.
13021 <P>
13022 &lt;End of help on this topic&gt;
13023 </BODY>
13024 </HTML>
13025 ===== h_abook_select_nicks_take =====
13026 <HTML>
13027 <HEAD>
13028 <TITLE>Take Address Nickname Selection Explained</TITLE>
13029 </HEAD>
13030 <BODY>
13031 <H1>TAKEADDR: SELECT NICKNAME</H1>
13032 <!--chtml if pinemode="function_key"-->
13033 <PRE>
13034 Navigating the List of Messages                 General Alpine Commands
13035 -------------------------------                 -----------------------
13036 F5   Move to previous entry                     F1  Show this help text
13037 F6   Move to next entry
13038 F7   Show previous screen of address book
13039 F8   Show next screen of address book
13040 F12  WhereIs (search through address book)
13041
13042 Message Selection Commands
13043 --------------------------
13044 F3   Exit the Nickname Select screen (without selecting an address)
13045 F4   Select the currently highlighted entry
13046 </PRE>
13047 <!--chtml else-->
13048 <PRE>
13049 Navigating the List of Messages                 General Alpine Commands
13050 -------------------------------                 -----------------------
13051  P   Move to previous entry                     ?  Show this help text
13052  N   Move to next entry
13053  -   Show previous screen of address book
13054 Spc  (space bar) Show next screen of address book
13055  W   WhereIs (search through address book)
13056
13057 Message Selection Commands
13058 --------------------------
13059  E   Exit the Nickname Select screen (without selecting an address)
13060  S   Select the currently highlighted entry
13061 </PRE>
13062 <!--chtml endif-->
13063 <P>
13064
13065 This screen is designed to let you modify or add to an existing
13066 address book entry.  You have already selected the name(s) and
13067 address(es) through &quot;Take Address&quot;.  This screen simply lets
13068 you scan your address books and select the nickname to be
13069 changed/augmented.  If you want to add a new entry, then you are in
13070 the wrong place-- Select &quot;Exit&quot; command.
13071 <P>
13072
13073 FOR MORE INFORMATION on addressing see
13074 <A HREF="h_address_format">Explanation of Address formats</A>, and the
13075 <A HREF="h_abook_opened">Address Book Screen's</A>
13076 help text.
13077 <P>
13078 &lt;End of help on this topic&gt;
13079 </BODY>
13080 </HTML>
13081 ===== h_abook_select_nick =====
13082 <HTML>
13083 <HEAD>
13084 <TITLE>Nickname Selection Explained</TITLE>
13085 </HEAD>
13086 <BODY>
13087 <H1>SELECT NICKNAME</H1>
13088 <!--chtml if pinemode="function_key"-->
13089 <PRE>
13090 Navigating the List of Messages                 General Alpine Commands
13091 -------------------------------                 -----------------------
13092 F5   Move to previous entry                     F1  Show this help text
13093 F6   Move to next entry
13094 F7   Show previous screen of address book
13095 F8   Show next screen of address book
13096 F12  WhereIs (search through address book)
13097
13098 Message Selection Commands
13099 --------------------------
13100 F3   Exit the Nickname Select screen (without selecting an address)
13101 F4   Select the currently highlighted entry
13102 </PRE>
13103 <!--chtml else-->
13104 <PRE>
13105 Navigating the List of Messages                 General Alpine Commands
13106 -------------------------------                 -----------------------
13107  P   Move to previous entry                     ?  Show this help text
13108  N   Move to next entry
13109  -   Show previous screen of address book
13110 Spc  (space bar) Show next screen of address book
13111  W   WhereIs (search through address book)
13112
13113 Message Selection Commands
13114 --------------------------
13115  E   Exit the Nickname Select screen (without selecting an address)
13116  S   Select the currently highlighted entry
13117 </PRE>
13118 <!--chtml endif-->
13119 <P>
13120
13121 This screen is designed to let you look at the nicknames in your address
13122 books before choosing a new one.
13123 <P>
13124
13125 FOR MORE INFORMATION on addressing see
13126 <A HREF="h_address_format">Explanation of Address formats</A>, and the
13127 <A HREF="h_abook_opened">Address Book Screen's</A>
13128 help text.
13129 <P>
13130 &lt;End of help on this topic&gt;
13131 </BODY>
13132 </HTML>
13133 ===== h_takeaddr_screen =====
13134 <HTML>
13135 <HEAD>
13136 <TITLE>Take Address Screen Explained</TITLE>
13137 </HEAD>
13138 <BODY>
13139 <H1>TAKE ADDRESS COMMANDS</H1>
13140 <!--chtml if pinemode="function_key"-->
13141 <PRE>
13142 Navigating the List of Addresses       Address Selection Commands
13143 --------------------------------       --------------------------
13144  F5  Move to previous entry            F3  Exit without taking address
13145  F6  Move to next entry                F4  Take current address(es)
13146  F7  Show previous page of address list
13147  F8  Show next page of address list
13148  F2  WhereIs (search list)
13149                                --------------
13150 Mode Toggle            F9  Set/Unset current address
13151 -----------            F10 Set all
13152  F12 Toggle between List and single mode       F11 Unset all
13153 </PRE>
13154 <!--chtml else-->
13155 <PRE>
13156 Navigating the List of Addresses       Address Selection Commands
13157 --------------------------------       --------------------------
13158  P  Move to previous entry              &lt;  Exit without taking address
13159  N  Move to next entry                  T  Take address
13160  -  Show previous page of address list
13161 Spc (space bar) Show next page of address list
13162  W  WhereIs (search list)              List Mode
13163                                        ---------
13164 Single Mode                             X  Set/Unset current address
13165 -----------                             A  Set all addresses
13166  L  Switch to list mode                 U  Unset all addresses
13167                                         S  Switch to single mode
13168 </PRE>
13169 <!--chtml endif-->
13170
13171 <H2>Description of the Take Address Screen</H2>
13172
13173 This screen is designed to let you select one or more address/name
13174 combinations from the current message and put them into your address book.
13175 The cursor is initially placed on the line with the message author.
13176 Other lines include the names of people and/or mailing lists who also
13177 received the message.  Other people &quot;involved&quot; in the
13178 message (e.g. the person named as Reply-To:) are also listed here.
13179 <P>
13180
13181 The simple case is adding a new, single entry into your address book. To
13182 do this, simply highlight the correct line and press
13183 <!--chtml if pinemode="function_key"-->
13184 F4.
13185 <!--chtml else-->
13186 &quot;T&quot;.
13187 <!--chtml endif-->
13188 To create a new list or add to an existing list, switch the screen display
13189 into List Mode by pressing
13190 <!--chtml if pinemode="function_key"-->
13191 F12.
13192 <!--chtml else-->
13193 &quot;L&quot;.
13194 <!--chtml endif-->
13195 In List Mode, you select the
13196 group of addresses you wish to manipulate by marking them with an
13197 &quot;X&quot;.
13198 The Set/Unset
13199 <!--chtml if pinemode="function_key"-->
13200 (F9)
13201 <!--chtml else-->
13202 (&quot;X&quot;)
13203 <!--chtml endif-->
13204 command will turn the &quot;X&quot; on for the
13205 highlighted address if it was off or turn it off if it was previously on.
13206 The SetAll command will select all of the addresses, and the UnSetAll
13207 command will turn off all the selections.  Once you've gotten the
13208 selection the way you want it, you may create a new list by pressing
13209 <!--chtml if pinemode="function_key"-->
13210 F4.
13211 <!--chtml else-->
13212 &quot;T&quot;.
13213 <!--chtml endif-->
13214 <P>
13215
13216 In both the simple and list cases, after choosing to take the address,
13217 you will be asked for the nickname of the entry.  Typing in a new name
13218 creates the new entry/list.  Entering an existing nickname will replace
13219 the entry (simple case) or add to the list (list case).  Alternatively,
13220 you can press Ctrl-T at the nickname prompt and select an existing
13221 nickname from your address book.
13222 <P>
13223
13224 You will normally start in Single Mode, unless you used the Apply command
13225 to startup the TakeAddr screen, in which case you will start in List Mode.
13226 You may switch between the two modes at any time.  If you've already
13227 selected several addresses in List Mode, those will be remembered when you
13228 switch to Single Mode and then back to List Mode.  The set of addresses
13229 that are pre-selected when you start in List Mode are the From addresses
13230 of all of the messages you are operating on.  You may, of course, easily
13231 erase those selections with the UnSetAll command.
13232 <P>
13233
13234 If you have more than one writable address book, you will be prompted for
13235 the name of the address book you wish to add the new entry to before
13236 anything else. You can use ^N and ^P to choose among the defined address
13237 books, or type in the address book name.
13238 <P>
13239
13240 FOR MORE INFORMATION on addressing see
13241 <A HREF="h_address_format">Explanation of Address formats</A>, and the
13242 <A HREF="h_abook_opened">Address Book Screen's</A>
13243 help text.
13244 <P>
13245 &lt;End of help on this topic&gt;
13246 </BODY>
13247 </HTML>
13248 ===== h_takeexport_screen =====
13249 <HTML>
13250 <HEAD>
13251 <TITLE>Take Export Screen Explained</TITLE>
13252 </HEAD>
13253 <BODY>
13254 <H1>TAKE EXPORT COMMANDS</H1>
13255 <!--chtml if pinemode="function_key"-->
13256 <PRE>
13257 Navigating the List of Addresses       Address Selection Commands
13258 --------------------------------       --------------------------
13259  F5  Move to previous entry            F3  Exit without taking address
13260  F6  Move to next entry                F4  Take current address(es)
13261  F7  Show previous page of address list
13262  F8  Show next page of address list
13263  F2  WhereIs (search list)
13264                                --------------
13265 Mode Toggle            F9  Set/Unset current address
13266 -----------            F10 Set all
13267  F12 Toggle between List and single mode       F11 Unset all
13268 </PRE>
13269 <!--chtml else-->
13270 <PRE>
13271 Navigating the List of Addresses       Address Selection Commands
13272 --------------------------------       --------------------------
13273  P  Move to previous entry              &lt;  Exit without taking address
13274  N  Move to next entry                  T  Take address
13275  -  Show previous page of address list
13276 Spc (space bar) Show next page of address list
13277  W  WhereIs (search list)              List Mode
13278                                        ---------
13279 Single Mode                             X  Set/Unset current address
13280 -----------                             A  Set all addresses
13281  L  Switch to list mode                 U  Unset all addresses
13282                                         S  Switch to single mode
13283 </PRE>
13284 <!--chtml endif-->
13285
13286 <H2>Description of the Take Export Screen</H2>
13287
13288 This screen is designed to let you select one or more addresses
13289 from the current message and put them into a file.
13290 Only the user@domain_name part of each address is put into the file.
13291 <P>
13292
13293 To put a single entry into a file simply highlight the correct line and press
13294 <!--chtml if pinemode="function_key"-->
13295 F4.
13296 <!--chtml else-->
13297 &quot;T&quot;.
13298 <!--chtml endif-->
13299 To put more than one entry into a file
13300 switch the screen display
13301 into List Mode by pressing
13302 <!--chtml if pinemode="function_key"-->
13303 F12.
13304 <!--chtml else-->
13305 &quot;L&quot;.
13306 <!--chtml endif-->
13307 In List Mode, you select the
13308 group of addresses you wish to manipulate by marking them with an
13309 &quot;X&quot;.
13310 The Set/Unset
13311 <!--chtml if pinemode="function_key"-->
13312 (F9)
13313 <!--chtml else-->
13314 (&quot;X&quot;)
13315 <!--chtml endif-->
13316 command will turn the &quot;X&quot; on for the
13317 highlighted address if it was off or turn it off if it was previously on.
13318 The SetAll command will select all of the addresses, and the UnSetAll
13319 command will turn off all the selections.  Once you've gotten the
13320 selection the way you want it, you may put the addresses in a file by typing
13321 <!--chtml if pinemode="function_key"-->
13322 F4.
13323 <!--chtml else-->
13324 &quot;T&quot;.
13325 <!--chtml endif-->
13326 <P>
13327
13328 You will be asked for the name of a file to put the addresses in.
13329 If the file already exists, you will be asked whether you want to Overwrite
13330 (replace) the contents of the file or Append to the contents of the file.
13331 <P>
13332
13333 &lt;End of help on this topic&gt;
13334 </BODY>
13335 </HTML>
13336 ============= h_abook_view ========================
13337 <HTML>
13338 <HEAD>
13339 <TITLE>Address Book View Explained</TITLE>
13340 </HEAD>
13341 <BODY>
13342 This function allows you to view the contents of an address book entry. You
13343 can only view one entry at a time.
13344 <P>
13345 <DL>
13346 <DT>Help
13347 <!--chtml if pinemode="function_key"-->
13348 (F1)
13349 <!--chtml else-->
13350 (?)
13351 <!--chtml endif-->
13352 </DT>
13353 <DD>
13354 Display this help text.
13355
13356 <DT>Abook
13357 <!--chtml if pinemode="function_key"-->
13358 (F3)
13359 <!--chtml else-->
13360 (&lt;)
13361 <!--chtml endif-->
13362 </DT>
13363 <DD>
13364 Go back to index of address book entries.
13365
13366 <DT>Update
13367 <!--chtml if pinemode="function_key"-->
13368 (F4)
13369 <!--chtml else-->
13370 (U)
13371 <!--chtml endif-->
13372 </DT>
13373 <DD>
13374 Update (modify) this entry.
13375
13376 <DT>ComposeTo
13377 <!--chtml if pinemode="function_key"-->
13378 (F5)
13379 <!--chtml else-->
13380 (C)
13381 <!--chtml endif-->
13382 </DT>
13383 <DD>Compose a message to the address(es) in this entry.
13384
13385 <DT>Role
13386 <!--chtml if pinemode="function_key"-->
13387 (F6)
13388 <!--chtml else-->
13389 (#)
13390 <!--chtml endif-->
13391 </DT>
13392 <DD>Compose a message to the address(es) in this entry using roles.
13393
13394 <DT>Prev Page
13395 <!--chtml if pinemode="function_key"-->
13396 (F7)
13397 <!--chtml else-->
13398 (-)
13399 <!--chtml endif-->
13400 </DT>
13401 <DD>
13402 Show the previous page of the current entry.
13403
13404 <DT>Next Page
13405 <!--chtml if pinemode="function_key"-->
13406 (F8)
13407 <!--chtml else-->
13408 (Space)
13409 <!--chtml endif-->
13410 </DT>
13411 <DD>
13412 Show the next page of the current entry.
13413
13414 <DT>Print
13415 <!--chtml if pinemode="function_key"-->
13416 (F9)
13417 <!--chtml else-->
13418 (%)
13419 <!--chtml endif-->
13420 </DT>
13421 <DD>Print the current entry.  You can select the
13422 printer or the print command via the &quot;Setup&quot; command
13423 on the MAIN MENU.
13424
13425 <DT>WhereIs
13426 <!--chtml if pinemode="function_key"-->
13427 (F10)
13428 <!--chtml else-->
13429 (W)
13430 <!--chtml endif-->
13431 </DT>
13432 <DD>Search the entry for a string of letters.  If it is
13433 found, move to it.  The string can be one word or a phrase.
13434 If there are multiple occurrences, the cursor moves to the
13435 first occurrence beyond the current cursor position.
13436
13437 <DT>Fwd Email
13438 <!--chtml if pinemode="function_key"-->
13439 (F11)
13440 <!--chtml else-->
13441 (F)
13442 <!--chtml endif-->
13443 </DT>
13444 <DD>Begin composition of a new mail message with the displayed
13445 text already inserted in the message body.
13446
13447 </DL>
13448 <P>
13449 &lt;End of help on this topic&gt;
13450 </BODY>
13451 </HTML>
13452 ============= h_ldap_view ========================
13453 <HTML>
13454 <HEAD>
13455 <TITLE>LDAP Response View Explained</TITLE>
13456 </HEAD>
13457 <BODY>
13458 This function allows you to view the contents of a directory entry. You
13459 can only view one entry at a time.
13460 <P>
13461 <DL>
13462 <DT>Help
13463 <!--chtml if pinemode="function_key"-->
13464 (F1)
13465 <!--chtml else-->
13466 (?)
13467 <!--chtml endif-->
13468 </DT>
13469 <DD>
13470 Display this help text.
13471
13472 <DT>Results Index
13473 <!--chtml if pinemode="function_key"-->
13474 (F3)
13475 <!--chtml else-->
13476 (&lt;)
13477 <!--chtml endif-->
13478 </DT>
13479 <DD>Go back to index of search results.
13480
13481 <DT>ComposeTo
13482 <!--chtml if pinemode="function_key"-->
13483 (F5)
13484 <!--chtml else-->
13485 (C)
13486 <!--chtml endif-->
13487 </DT>
13488 <DD>Compose a message to the address(es) in this entry.
13489
13490 <DT>Role
13491 <!--chtml if pinemode="function_key"-->
13492 (F6)
13493 <!--chtml else-->
13494 (#)
13495 <!--chtml endif-->
13496 </DT>
13497 <DD>Compose a message to the address(es) in this entry using roles.
13498
13499 <DT>Prev Page
13500 <!--chtml if pinemode="function_key"-->
13501 (F7)
13502 <!--chtml else-->
13503 (-)
13504 <!--chtml endif-->
13505 </DT>
13506 <DD>
13507 Show the previous page of the current entry.
13508
13509 <DT>Next Page
13510 <!--chtml if pinemode="function_key"-->
13511 (F8)
13512 <!--chtml else-->
13513 (Space)
13514 <!--chtml endif-->
13515 </DT>
13516 <DD>
13517 Show the next page of the current entry.
13518
13519 <DT>Print
13520 <!--chtml if pinemode="function_key"-->
13521 (F9)
13522 <!--chtml else-->
13523 (%)
13524 <!--chtml endif-->
13525 </DT>
13526 <DD>Print the current entry on paper.  You can select the
13527 printer or the print command via the &quot;Setup&quot; command
13528 on the MAIN MENU.
13529
13530 <DT>WhereIs
13531 <!--chtml if pinemode="function_key"-->
13532 (F10)
13533 <!--chtml else-->
13534 (W)
13535 <!--chtml endif-->
13536 </DT>
13537 <DD>Search the entry for a string of letters.  If it is
13538 found, move to it.  The string can be one word or a phrase.
13539 If there are multiple occurrences, the cursor moves to the
13540 first occurrence beyond the current cursor position.
13541
13542 <DT>Fwd Email
13543 <!--chtml if pinemode="function_key"-->
13544 (F11)
13545 <!--chtml else-->
13546 (F)
13547 <!--chtml endif-->
13548 </DT>
13549 <DD>Begin composition of a new mail message with the displayed
13550 text already inserted in the message body.
13551
13552 <DT>Save
13553 <!--chtml if pinemode="function_key"-->
13554 (F12)
13555 <!--chtml else-->
13556 (S)
13557 <!--chtml endif-->
13558 </DT>
13559 <DD>Save the displayed entry to one of your address books or export
13560 it to a file.
13561 </DL>
13562 <P>
13563 &lt;End of help on this topic&gt;
13564 </BODY>
13565 </HTML>
13566 ===== h_attachment_screen =====
13567 <HTML>
13568 <HEAD>
13569 <TITLE>Attachment Index Screen Explained</TITLE>
13570 </HEAD>
13571 <BODY>
13572 The &quot;ATTACHMENT INDEX&quot; displays a list of the current
13573 message's attachments, and allows various operations on them.  The
13574 first attachment is usually the message text, but does not include the
13575 header portion of the message.
13576 <P>
13577 Available commands include:
13578 <P>
13579 <DL>
13580
13581 <DT>Help</DT>
13582 <DD>Show this help text.
13583
13584 <DT>Msg #<I>num</I></DT>
13585 <DD>Leave this screen without displaying or saving any attachments.
13586
13587 <DT>View</DT>
13588 <DD>View the currently selected attachment.
13589
13590 <DT>External</DT>
13591 <DD>Passes a TEXT/HTML message to an external browser for its display.
13592
13593 <DT>Prev Attach</DT>
13594 <DD>Move to previous attachment.
13595
13596 <DT>Next Attach</DT>
13597 <DD>Move to next attachment.
13598
13599 <DT>Prev Page</DT>
13600 <DD>Previous page of the listed attachments.
13601
13602 <DT>Next Page</DT>
13603 <DD>Next page of the listed attachments.
13604
13605 <DT>Delete</DT>
13606 <DD>Mark the currently selected attachment for Deletion.
13607 This does not modify the current message by deleting the attachment from
13608 it, but instead the delete flag <EM>only</EM> has an effect when saving
13609 the message to a folder.
13610 Attachments marked for deletion are not copied to the destination folder
13611 along with the rest of the message when it is saved.
13612 It is ok for the destination folder to be the same as the current folder.
13613 In addition, the delete mark <EM>only</EM> applies to this Alpine session.
13614
13615 <DT>Undelete</DT>
13616 <DD>Turn off the Delete flag for the selected attachment.
13617
13618 <DT>Save</DT>
13619 <DD>Save the selected attachment to a file.  If the attachment is of
13620 type &quot;RFC822/Message&quot;, then the attachment will be saved to
13621 the specified mail folder.
13622
13623 <DT>Export</DT>
13624 <DD>If the attachment is of
13625 type &quot;RFC822/Message&quot;, then &quot;Export&quot; is used to
13626 copy the message to a file in the same way this command works on
13627 messages in the MESSAGE INDEX and MESSAGE TEXT screens.
13628
13629 <DT>Pipe</DT>
13630 <DD>Pipe the attachment contents into a UNIX command (if enabled).
13631 A description of the Pipe sub-commands is  <A HREF="h_pipe_command">here</A>.
13632
13633 <DT>WhereIs</DT>
13634 <DD>Find a matching string in the attachment list.
13635
13636 <DT>AboutAttch</DT>
13637 <DD>Examine various aspects of the selected attachment.
13638
13639 <DT>Print</DT>
13640 <DD>Print the selected attachment.
13641
13642 <DT>Forward</DT>
13643 <DD>Forward the selected attachment as an attachment.
13644 </DL>
13645
13646 <P>
13647
13648 All attachments can be saved or piped into a UNIX command, but some may
13649 not be readily displayed by either Alpine or an external tool.  In such
13650 cases, the reason why the message cannot be displayed is displayed on
13651 Alpine's message line.
13652 <P>
13653 &lt;End of help on this topic&gt;
13654 </BODY>
13655 </HTML>
13656 ============= h_mail_text_att_view ========================
13657 <HTML>
13658 <HEAD>
13659 <TITLE>Attachment View Screen Explained</TITLE>
13660 </HEAD>
13661 <BODY>
13662 This function allows you to view the contents of a text attachment. You
13663 can only view one attachment at a time.
13664 <P>
13665 Available commands include:
13666 <P>
13667 <DL>
13668
13669 <DT>Help</DT>
13670 <DD>Display this help text
13671
13672 <DT>AttchIndex</DT>
13673 <DD>Leave viewer and return to the &quot;ATTACHMENT INDEX&quot; screen
13674
13675 <DT>Prev Page</DT>
13676 <DD>Show the previous page of the current attachment.
13677
13678 <DT>Next Page</DT>
13679 <DD>Show the next page of the current attachment by pressing the space bar.
13680
13681 <DT>Delete</DT>
13682 <DD>Mark the viewed attachment for Deletion.  The delete
13683 flag <EM>only</EM> has affect when saving the message to a folder.
13684 Attachments marked for deletion are excluded from the message when
13685 it is saved.  In addition, the delete mark <EM>only</EM> applies to
13686 this Alpine session.
13687
13688 <DT>Undelete</DT>
13689 <DD>Turn off the Delete flag for the selected attachment.
13690
13691 <DT>Save</DT>
13692 <DD>Copy the current attachment to a file.  If you just enter
13693 a filename, the attachment will be saved with that name in
13694 your home directory
13695 <!--chtml if pinemode="running"-->
13696 (which, in the present configuration of your system, is
13697  &quot;<!--#echo var="HOME_DIR"-->&quot;)
13698 <!--chtml endif-->
13699 or current working directory
13700 <!--chtml if pinemode="running"-->
13701 (which, at least for your current Alpine &quot;session,&quot;
13702 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
13703 <!--chtml endif-->, depending on the
13704 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
13705 configuration setting.  You may enter the full
13706 path and filename to save it in another directory instead.
13707
13708 <DT>Export</DT>
13709 <DD>If the attachment is of
13710 type &quot;RFC822/Message&quot;, then &quot;Export&quot; is used to
13711 copy the message to a file in the same way this command works on
13712 messages in the MESSAGE INDEX and MESSAGE TEXT screens.
13713 (If you have any <A HREF="h_config_display_filters"><!--#echo var="VAR_display-filters"--></A>
13714 defined, they may affect the contents of the exported file.)
13715
13716 <DT>Pipe</DT>
13717 <DD>Pipe the attachment contents into a UNIX command (if enabled)
13718
13719 <DT>WhereIs</DT>
13720 <DD>Search the attachment for a string of letters.  If it is
13721 found, move to it.  The string can be one word or a phrase.
13722 If there are multiple occurrences, the cursor moves to the
13723 first occurrence beyond the current cursor position.
13724
13725 <DT>Print</DT>
13726 <DD>Print the current attachment on paper.  You can select the
13727 printer or the print command via the &quot;Setup&quot; command
13728 on the MAIN MENU.
13729
13730 <DT>Forward</DT>
13731 <DD>Forward the selected attachment as an attachment.
13732 </DL>
13733 <P>
13734 &lt;End of help on this topic&gt;
13735 </BODY>
13736 </HTML>
13737 ============= h_journal ==============
13738 <HTML>
13739 <HEAD>
13740 <TITLE>Recent Message Journal Explained</TITLE>
13741 </HEAD>
13742 <BODY>
13743
13744 The following commands are available on this screen:
13745 <P>
13746 <DL>
13747 <DT>Help</DT>
13748 <DD>Show this help text
13749
13750 <DT>Exit</DT>
13751 <DD>Exit Viewer, and go back to mail processing
13752
13753 <DT>Prev Page</DT>
13754 <DD>Show the previous page text
13755
13756 <DT>Next Page</DT>
13757 <DD>Show the next page of text by pressing the space bar
13758
13759 <DT>Print</DT>
13760 <DD>Print the displayed text on paper.  You can select the
13761 printer or the print command via the &quot;Setup&quot; command
13762 on the MAIN MENU.
13763
13764 <DT>Fwd Email</DT>
13765 <DD>Begin composition of a new mail message with the displayed
13766 text already inserted in the message body.
13767
13768 <DT>Save</DT>
13769 <DD>Copy the displayed text to a file.  If you just enter
13770 a filename, the text will be saved with that name in
13771 your
13772 home directory
13773 <!--chtml if pinemode="running"-->
13774 (which, in the present configuration of your system, is
13775  &quot;<!--#echo var="HOME_DIR"-->&quot;)
13776 <!--chtml endif-->
13777 or current working directory
13778 <!--chtml if pinemode="running"-->
13779 (which, at least for your current Alpine &quot;session,&quot;
13780 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
13781 <!--chtml endif-->, depending on the
13782 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
13783 configuration setting.   You may enter the full
13784 path and filename to save it in another directory instead.
13785
13786 <DT>WhereIs</DT>
13787 <DD>Search the text for a string of letters.  If it is
13788 found, move to it.  The string can be one word or a phrase.
13789 If there are multiple occurrences, the cursor moves to the
13790 first occurrence beyond the current cursor position.
13791 </DL>
13792 <P>
13793 &lt;End of help on this topic&gt;
13794 </BODY>
13795 </HTML>
13796 ============= h_debugjournal ==============
13797 <HTML>
13798 <HEAD>
13799 <TITLE>Debug Journal Explained</TITLE>
13800 </HEAD>
13801 <BODY>
13802
13803 The following commands are available on this screen:
13804 <P>
13805 <DL>
13806 <DT>Help</DT>
13807 <DD>Show this help text
13808
13809 <DT>Exit</DT>
13810 <DD>Exit Viewer, and go back to mail processing
13811
13812 <DT>Timestamps</DT>
13813 <DD>Turn on or off timestamps.
13814
13815 <DT>DebugView</DT>
13816 <DD>Set the level of debugging you want to see. The level may be any number
13817 in the range 0-9. Higher numbers show more debugging detail. Note that the
13818 debugging information has already been captured. This setting just causes the
13819 debugging information that you see to be filtered. If you set this to
13820 the number &quot;5&quot; then you will be shown all of the debugging information
13821 at levels 5 and below.
13822 It's actually a bit more complicated than that. A fixed amount of memory
13823 is used to store the debug information.
13824 Since the amount of memory used is limited the debugging information
13825 has to be trimmed back when it gets too large.
13826
13827 <DT>Prev Page</DT>
13828 <DD>Show the previous page text
13829
13830 <DT>Next Page</DT>
13831 <DD>Show the next page of text by pressing the space bar
13832
13833 <DT>Print</DT>
13834 <DD>Print the displayed text on paper.  You can select the
13835 printer or the print command via the &quot;Setup&quot; command
13836 on the MAIN MENU.
13837
13838 <DT>Fwd Email</DT>
13839 <DD>Begin composition of a new mail message with the displayed
13840 text already inserted in the message body.
13841
13842 <DT>Save</DT>
13843 <DD>Copy the displayed text to a file.  If you just enter
13844 a filename, the text will be saved with that name in
13845 your
13846 home directory
13847 <!--chtml if pinemode="running"-->
13848 (which, in the present configuration of your system, is
13849  &quot;<!--#echo var="HOME_DIR"-->&quot;)
13850 <!--chtml endif-->
13851 or current working directory
13852 <!--chtml if pinemode="running"-->
13853 (which, at least for your current Alpine &quot;session,&quot;
13854 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
13855 <!--chtml endif-->, depending on the
13856 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
13857 configuration setting.   You may enter the full
13858 path and filename to save it in another directory instead.
13859
13860 <DT>WhereIs</DT>
13861 <DD>Search the text for a string of letters.  If it is
13862 found, move to it.  The string can be one word or a phrase.
13863 If there are multiple occurrences, the cursor moves to the
13864 first occurrence beyond the current cursor position.
13865 </DL>
13866 <P>
13867 &lt;End of help on this topic&gt;
13868 </BODY>
13869 </HTML>
13870 ============= h_simple_text_view ==============
13871 <HTML>
13872 <HEAD>
13873 <TITLE>Simple Text View Screen Explained</TITLE>
13874 </HEAD>
13875 <BODY>
13876
13877 The following commands are available on this screen:
13878 <P>
13879 <DL>
13880 <DT>Help</DT>
13881 <DD>Show this help text
13882
13883 <DT>Exit</DT>
13884 <DD>Exit Viewer, and go back to mail processing
13885
13886 <DT>Prev Page</DT>
13887 <DD>Show the previous page text
13888
13889 <DT>Next Page</DT>
13890 <DD>Show the next page of text by pressing the space bar
13891
13892 <DT>Print</DT>
13893 <DD>Print the displayed text on paper.  You can select the
13894 printer or the print command via the &quot;Setup&quot; command
13895 on the MAIN MENU.
13896
13897 <DT>Fwd Email</DT>
13898 <DD>Begin composition of a new mail message with the displayed
13899 text already inserted in the message body.
13900
13901 <DT>Save</DT>
13902 <DD>Copy the displayed text to a file.  If you just enter
13903 a filename, the attachment will be saved with that name in
13904 your
13905 home directory
13906 <!--chtml if pinemode="running"-->
13907 (which, in the present configuration of your system, is
13908  &quot;<!--#echo var="HOME_DIR"-->&quot;)
13909 <!--chtml endif-->
13910 or current working directory
13911 <!--chtml if pinemode="running"-->
13912 (which, at least for your current Alpine &quot;session,&quot;
13913 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
13914 <!--chtml endif-->, depending on the
13915 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
13916 configuration setting.   You may enter the full
13917 path and filename to save it in another directory instead.
13918
13919 <DT>WhereIs</DT>
13920 <DD>Search the attachment for a string of letters.  If it is
13921 found, move to it.  The string can be one word or a phrase.
13922 If there are multiple occurrences, the cursor moves to the
13923 first occurrence beyond the current cursor position.
13924 </DL>
13925 <P>
13926 &lt;End of help on this topic&gt;
13927 </BODY>
13928 </HTML>
13929 ======= h_pine_for_windows ========
13930 <HTML>
13931 <HEAD>
13932 <TITLE>GETTING HELP IN PC-ALPINE</TITLE>
13933 </HEAD>
13934 <BODY>
13935 <H1>Getting Help In PC-Alpine</H1>
13936
13937 <P>
13938 PC-Alpine offers general and specific help text. From the <A
13939 HREF="main_menu_tx">MAIN MENU</A>, you will find an overview in the MAIN
13940 MENU HELP and the <A HREF="h_news">Release Notes</A>.  On all screens,
13941 specific help for that screen is available from the toolbar Help menu or
13942 with the
13943 <!--chtml if pinemode="function_key"-->
13944 &quot;F1&quot; key.
13945 <!--chtml else-->
13946 &quot;?&quot; or &quot;Ctrl-G&quot; keys. &quot;Ctrl-G&quot; is used where
13947 typing &quot;?&quot; would be mistaken as entering text.
13948 <!--chtml endif-->
13949
13950 <P>
13951 Although this version of Alpine is for Microsoft Windows, it is not
13952 considered a full &quot;Graphical User Interface&quot; application.
13953 Yet, many of the controls that Windows users are accustomed to seeing,
13954 such as scrollbars and toolbars, are available.
13955
13956 <P>
13957 PC-Alpine offers considerable mouse support.  You can view what is
13958 &quot;click-able&quot; by dragging your mouse over any screen; when the
13959 arrow cursor changes into a hand, you found something. Mouse-click
13960 possibilities include navigating between screens and folders and
13961 double-clicking on hyperlinks to open your Web browser.
13962 Context-sensitive pop-up menus appear with a right-click on your PC-Alpine
13963 screen.  Examples of right-click options include &quot;copy&quot; after
13964 selecting text to copy and &quot;View in New Window&quot; when you click
13965 on a particular message in the Message Index. The menu choices available
13966 to you will vary based upon what screen is open, where on the screen your
13967 cursor is located, and even what action you have already taken.
13968
13969 <P>
13970 &lt;End of help on this topic&gt;
13971 </BODY>
13972 </HTML>
13973 ===== h_composer =====
13974 <HTML>
13975 <HEAD>
13976 <TITLE>COMPOSER COMMANDS</TITLE>
13977 </HEAD>
13978 <BODY>
13979 <H1>COMPOSER COMMANDS</H1>
13980
13981 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>
13982 &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>
13983 &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>
13984 &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>
13985 &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>
13986 &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>
13987 &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>
13988 &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>
13989 &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>
13990 &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>
13991 ---------------------------------------|&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>
13992 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>
13993 &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>
13994 &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>
13995 &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>
13996
13997 <P>
13998 NOTE:
13999 <OL>
14000  <LI>For help on a particular command, highlight the bold text associated
14001 with it above and hit Return.
14002  <LI> The availability of certain commands
14003 is determined by Alpine configuration files and system capabilities.
14004 At some sites, certain commands may not be available due to security or
14005 support concerns.
14006  <LI>Alpine does not use the following keys:  Ctrl-S, Ctrl-Q, Ctrl-],
14007 Ctrl-&#92;, ESC.
14008  <LI>For special handling of Ctrl-S and Ctrl-Q see special comments regarding
14009 <A HREF="h_special_xon_xoff">&quot;XOFF/XON&quot;</A>.
14010 </OL>
14011
14012 <P>
14013 HINT: To move rapidly to the bottom of a message you are composing,
14014 enter ^W^V.  To go to the top, ^W^Y.  These can be used in conjunction
14015 with the Mark and Cut commands to eliminate large amounts of unwanted
14016 text in a Reply.
14017
14018 <H2>Description of Composer</H2>
14019
14020 Alpine has a built-in editing program that allows you to compose messages
14021 without having to leave Alpine.  The editor is designed to be very simple to
14022 use so that you can get started writing email right away.
14023
14024 <P>
14025 Messages are usually just text, about 80 columns wide.  Using upper and
14026 lower case is encouraged.  On some systems the size limit of the message
14027 is about 100,000 characters, which is about 2,000 lines.  You can include
14028 punctuation and special characters found on most keyboards, but you can't
14029 include characters with diacritical marks and certain special symbols.
14030
14031 <P>
14032 Text automatically wraps as you type past the end of a line so you do not
14033 have to hit return.  Using the
14034 &quot;<A HREF="h_compose_justify">Justify</A>&quot; command,
14035 you can also reformat text explicitly, perhaps after you have
14036 deleted some text.
14037
14038 <P>
14039 You can include other text files with the
14040 &quot;<A HREF="h_compose_readfile">Read File</A>&quot; command,
14041 which will prompt you for the name of the file to insert at the
14042 current cursor position.
14043
14044 <P>
14045 <UL>
14046 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14047 </UL>
14048 <P>
14049 &lt;End of help on this topic&gt;
14050 </BODY>
14051 </HTML>
14052 ====== h_composer_browse =====
14053 <HTML>
14054 <HEAD>
14055 <TITLE>BROWSER</TITLE>
14056 </HEAD>
14057 <BODY>
14058 <H1>BROWSER</H1>
14059 This screen lets you browse your files and directories.  To go to another
14060 directory (identified by &quot;(dir)&quot;), move the cursor to it and
14061 choose &quot;Select&quot; (the default choice on the menu);
14062 or choose &quot;Goto&quot; and enter the name of the directory.
14063 <!--chtml if pinemode="os_windows"-->
14064 <!--chtml else-->
14065 In Unix Alpine, you may use
14066 &quot;~&quot; to refer to your home directory or &quot;~user&quot; to refer
14067 to another's home directory.
14068 <!--chtml endif--><P>
14069 To select a file, move the cursor to it and
14070 choose &quot;Select&quot; (the default choice on the menu).
14071 <P>
14072 <UL>
14073 <LI>Note <B>if</B> you are currently using the BROWSER for choosing a file for
14074 inclusion in the
14075 message body (that is, you chose &quot;Read File&quot; with the cursor under
14076 the
14077 &quot;----- Message Text -----&quot; line
14078 while composing, then &quot;To Files&quot;):  Since the file
14079 selected will become part of the message text, it must be in a format
14080 suitable for that (Alpine does not check!), such as a plain text file.
14081 Files of other formats (for example, graphics, databases, software
14082 programs) should be
14083 <B>attached</B> to the message instead --
14084 by moving the cursor in the COMPOSE MESSAGE screen into the
14085 message header area and pressing
14086 <!--chtml if pinemode="function_key"-->
14087 F6.
14088 <!--chtml else-->
14089 Ctrl-J.
14090 <!--chtml endif-->
14091
14092 <P><LI>
14093 Note <B>if</B> you are currently using the BROWSER for saving a message
14094 attachment, or exporting a message, to a file: You can use the Add command to
14095 provide the name for a new file to save/export to, and then select that name
14096 to use it for the save/export operation.  Back at the prompt
14097 &quot;EXPORT: Copy message to file in ...&quot; hit Enter, then choose
14098 either Overwrite or Append (it doesn't make a difference, since the file is
14099 so far empty).  Note: If you cancel the
14100 operation at that point, the file created with the Add command will remain
14101 0 bytes in size.
14102
14103 </UL>
14104 <P><UL>
14105 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14106 </UL>
14107 <P>
14108 &lt;End of help on this topic&gt;
14109 </BODY>
14110 </HTML>
14111 ====== h_composer_ins =====
14112 <HTML>
14113 <HEAD>
14114 <TITLE>INSERT TEXT FILE</TITLE>
14115 </HEAD>
14116 <BODY>
14117 <H1>INSERT TEXT FILE</H1>
14118
14119 Use this function to insert a text file. The file name
14120 given can be an absolute file path name for your system
14121 <!--chtml if pinemode="os_windows"-->
14122 (for example, &quot;H:&#92;SIGFILES&#92;FULLINFO.TXT&quot;), a file
14123 with a relative pathname, or simply a file name without
14124 drive or directory specification.
14125 <!--chtml else-->
14126 (for example, &quot;/tmp/exported.earlier&quot; on Unix hosts),
14127 a file in your home directory, or a file path relative to your
14128 home directory.  In Unix Alpine, you may use &quot;~&quot; to refer to
14129 your home directory or &quot;~user&quot; to refer to another
14130 account's home directory.
14131 <!--chtml endif-->
14132 <P>
14133 No wild card characters may be used.
14134 The file must reside on the system running Alpine.
14135 <P>
14136 If the
14137 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
14138 feature is set, names are relative to your current working directory
14139 <!--chtml if pinemode="running"-->
14140 (which, at least for your current Alpine &quot;session,&quot;
14141 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
14142 <!--chtml endif-->
14143 rather than your home directory
14144 <!--chtml if pinemode="running"-->
14145 (which, in the present configuration of your system, is
14146  &quot;<!--#echo var="HOME_DIR"-->&quot;)
14147 <!--chtml endif-->
14148 .
14149 <P><UL>
14150 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14151 </UL>
14152 <P>
14153 &lt;End of help on this topic&gt;
14154 </BODY>
14155 </HTML>
14156 ====== h_composer_ins_m =====
14157 <HTML>
14158 <HEAD>
14159 <TITLE>INSERT MESSAGE</TITLE>
14160 </HEAD>
14161 <BODY>
14162 <H1>INSERT MESSAGE</H1>
14163
14164 Type in the number of a message in the currently open folder to insert it
14165 into your message.
14166 <P><UL>
14167 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14168 </UL>
14169 <P>
14170 &lt;End of help on this topic&gt;
14171 </BODY>
14172 </HTML>
14173 ====== h_composer_search =====
14174 <HTML>
14175 <HEAD>
14176 <TITLE>Explanation of Composer Whereis Command </TITLE>
14177 </HEAD>
14178 <BODY>
14179 <H1>Help For Whereis Command</H1>
14180
14181 Whereis is used to search the message for a word or part of a word.
14182 When searching in the composer, only the message part of your mail is
14183 searched, and the cursor is put on the first occurrence appearing
14184 after the location of the cursor.  The search will wrap to the
14185 beginning of the message when it no longer finds matches in the
14186 remainder of the message.
14187
14188 To search for the same string a second time, press
14189 <!--chtml if pinemode="function_key"-->
14190 &quot;F6&quot;
14191 <!--chtml else-->
14192 &quot;^W&quot;
14193 <!--chtml endif-->
14194 to begin search and then just press RETURN to accept the previous
14195 search string shown in square brackets rather than entering a new
14196 search string.<P>
14197
14198 The &quot;Search&quot; prompt has several sub-command available:
14199
14200 <DL>
14201 <DT>Get Help</DT>
14202 <DD> Takes you to this help page.
14203
14204 <DT>Cancel</DT>
14205 <DD> Cancels the prompt.  No search takes place.
14206
14207 <DT>First Line</DT>
14208 <DD> Takes you back to the composer with the cursor on the first character
14209 of the first line of text.
14210
14211 <DT>Last Line</DT>
14212 <DD> Takes you back to the composer with the cursor on the last character
14213 of the last line of text.
14214
14215 <DT>Replace (Optional)</DT>
14216 <DD> This sub-command is enabled by the
14217 <A HREF="h_config_enable_search_and_repl">&quot;<!--#echo var="FEAT_enable-search-and-replace"-->&quot;</A>
14218 feature (which is on by default); see its help screen for details on how replacing works.
14219
14220 </DL>
14221
14222 &lt;End of help on this topic&gt;
14223 </BODY>
14224 </HTML>
14225 ====== h_sigedit_search =====
14226 <HTML>
14227 <HEAD>
14228 <TITLE>Explanation of Whereis Command </TITLE>
14229 </HEAD>
14230 <BODY>
14231 <H1>Help For Whereis Command</H1>
14232
14233 Whereis is used to search for a word or part of a word.
14234 When searching the cursor is put on the first occurrence appearing
14235 after the location of the cursor.  The search will wrap to the
14236 beginning of the signature when it no longer finds matches in the
14237 remainder of the signature.
14238
14239 To search for the same string a second time, press
14240 <!--chtml if pinemode="function_key"-->
14241 &quot;F6&quot;
14242 <!--chtml else-->
14243 &quot;^W&quot;
14244 <!--chtml endif-->
14245 to begin search and then just press RETURN to accept the previous
14246 search string shown in square brackets rather than entering a new
14247 search string.<P>
14248
14249 The &quot;Search&quot; prompt has several sub-command available:
14250
14251 <DL>
14252 <DT>Get Help</DT>
14253 <DD> Takes you to this help page.
14254
14255 <DT>Cancel</DT>
14256 <DD> Cancels the prompt.  No search takes place.
14257
14258 <DT>First Line</DT>
14259 <DD> Takes you back to the composer with the cursor on the first character
14260 of the first line of text.
14261
14262 <DT>Last Line</DT>
14263 <DD> Takes you back to the composer with the cursor on the last character
14264 of the last line of text.
14265
14266 <DT>Replace (Optional)</DT>
14267 <DD> This sub-command is enabled by the
14268 <A HREF="h_config_enable_search_and_repl">&quot;<!--#echo var="FEAT_enable-search-and-replace"-->&quot;</A>
14269 feature (which is on by default); see its help screen for details on how replacing works.
14270
14271 </DL>
14272
14273 &lt;End of help on this topic&gt;
14274 </BODY>
14275 </HTML>
14276 ======= h_composer_to ====
14277 <HTML>
14278 <HEAD>
14279 <TITLE>THE MESSAGE COMPOSER'S TO FIELD</TITLE>
14280 </HEAD>
14281 <BODY>
14282 <H1>THE MESSAGE COMPOSER'S TO FIELD</H1>
14283
14284 <H2>The &quot;To:&quot; field</H2>
14285 The address you enter here must be a valid email address that is reachable
14286 from your site.
14287
14288 <H2>Email Address Format</H2>
14289 You may enter a full name and email address,
14290 <!--chtml if pinemode="os_windows"-->
14291 <!--chtml else-->
14292 a local (meaning, on the same
14293 host as the one you are running Alpine on) username that Alpine will
14294 complete for you,
14295 <!--chtml endif-->
14296 the nickname of someone in a
14297 <A HREF="h_abook_opened">Alpine Address Book</A>, or a local
14298 mail alias defined by your system administrator.  When you move the cursor
14299 out of this field, the nicknames will be expanded to the addresses in your
14300 address book, and the local usernames will be expanded to include the
14301 persons' actual names.  You may enter as many addresses as you wish, but they
14302 must be separated by commas.  You can move around this and other header fields
14303 with the arrow keys and use many of the usual composer editing keys.
14304 <P>
14305 <UL>
14306 <LI><A HREF="h_address_format">Explanation of Address formats</A>
14307 </UL>
14308
14309 <P>
14310 <H2>MESSAGE HEADER COMMANDS</H2>
14311 <!--chtml if pinemode="function_key"-->
14312 CURSOR&nbsp;MOTION&nbsp;KEYS----------------------|EDITING&nbsp;KEYS-------------------------<BR>
14313 ^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>
14314 ^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>
14315 ^P&nbsp;(Up&nbsp;Arrow)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Previous&nbsp;line&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|<BR>
14316 ^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>
14317 ^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>
14318 ^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>
14319 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>
14320 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>
14321 ^@&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>
14322 ----------------------------------------|<BR>
14323 MESSAGE&nbsp;COMMANDS&nbsp;&nbsp;|&nbsp;GENERAL&nbsp;COMMANDS&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;F12&nbsp;&nbsp;&nbsp;&nbsp;To&nbsp;Addressbook/Browser<BR>
14324 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>
14325 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>
14326 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>
14327 <!--chtml else-->
14328 CURSOR&nbsp;MOTION&nbsp;KEYS----------------------|EDITING&nbsp;KEYS-------------------------<BR>
14329 ^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>
14330 ^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>
14331 ^P&nbsp;(Up&nbsp;Arrow)&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Previous&nbsp;line&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;|&nbsp;<BR>
14332 ^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>
14333 ^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>
14334 ^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>
14335 ^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>
14336 ^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>
14337 ^@&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>
14338 ----------------------------------------|&nbsp;^R&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="h_compose_richhdr">Rich&nbsp;Headers</A><BR>
14339 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>
14340 ^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>
14341 ^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>
14342 ^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>
14343 <!--chtml endif-->
14344
14345 <P>
14346 NOTE:
14347 <OL>
14348  <LI>For help on a particular command, highlight the bold text associated
14349 with it above and hit Return.
14350  <LI> The availability of certain commands
14351 is determined by Alpine configuration files and system capabilities.
14352 At some sites, certain commands may not be available due to security or
14353 support concerns.
14354 </OL>
14355
14356 <P>
14357 <UL>
14358 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14359 </UL><P>
14360 &lt;End of help on this topic&gt;
14361 </BODY>
14362 </HTML>
14363 ======= h_composer_cc ====
14364 <HTML>
14365 <HEAD>
14366 <TITLE>THE MESSAGE COMPOSER'S CC FIELD</TITLE>
14367 </HEAD>
14368 <BODY>
14369 <H1>THE MESSAGE COMPOSER'S CC FIELD</H1>
14370 The Cc: field is just like the To: field, except it is used for addressees
14371 that you wish to send a &quot;carbon&quot; copy to.  That is, the message is
14372 not directly meant directly &quot;for&quot; these recipients, but you wanted
14373 them to see the message.  The only difference the recipients see is that their
14374 name is in the Cc: field, rather than the To: field.
14375 <P>
14376 For help with Cc: field editing
14377 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
14378 <P>
14379 <UL>
14380 <LI><A HREF="h_address_format">Explanation of Address formats</A>
14381 </UL>
14382 <P>
14383 <UL>
14384 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14385 </UL><P>
14386 &lt;End of help on this topic&gt;
14387 </BODY>
14388 </HTML>
14389 ======= h_composer_bcc ====
14390 <HTML>
14391 <HEAD>
14392 <TITLE>THE MESSAGE COMPOSER'S BCC FIELD</TITLE>
14393 </HEAD>
14394 <BODY>
14395 <H1>THE MESSAGE COMPOSER'S BCC FIELD</H1>
14396 The &quot;Bcc:&quot; (Blind carbon copy) header is used when you wish to send
14397 a copy of the message to one or more people whose addresses you do not
14398 wish disclosed, either to reduce clutter or for confidentiality.
14399 <P>
14400 The format of the Bcc: field is just the same as the To: and Cc: fields in
14401 the way the addresses are entered.  The recipients listed here will
14402 receive a copy of the message, but --assuming your site's mail transport
14403 software is properly configured-- their addresses will not show up in the
14404 headers of the message, as delivered to all of the recipients.  The To:
14405 and Cc:  recipients will not know a copy was sent to the Bcc: recipients.
14406 <P>
14407 Note: if there is no To: or Cc: or Lcc: address in the message, Alpine
14408 will automatically generate and place in the To: field a pseudo-address of
14409   &quot;undisclosed-recipients: ;&quot;
14410 or whatever string has been specified in the
14411 <A HREF="h_config_empty_hdr_msg">&quot;<!--#echo var="VAR_empty-header-message"-->&quot;</A>
14412 variable.
14413 <P>
14414 The reason for this is to avoid embarrassment caused by some Internet
14415 mail transfer software that interprets a &quot;missing&quot; To: header as
14416 an error and replaces it with an Apparently-to: header that may contain
14417 the addresses you entered on the Bcc: line.  In addition, it may be
14418 less disconcerting to Bcc: recipients to see <B>something</B> in the To: field.
14419 <P>
14420 You can manipulate what text ends up on the (originally) empty To:
14421 field.  Just remember to put a colon and semicolon at the end of the
14422 field, which is a special notation denoting that it is not a real address.
14423 <P>
14424 For information on message header editing
14425 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
14426 <P>
14427 <UL>
14428 <LI><A HREF="h_address_format">Explanation of Address formats</A>
14429 </UL>
14430 <P>
14431 <UL>
14432 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14433 </UL><P>
14434 &lt;End of help on this topic&gt;
14435 </BODY>
14436 </HTML>
14437 ======= h_composer_lcc ====
14438 <HTML>
14439 <HEAD>
14440 <TITLE>THE MESSAGE COMPOSER'S LCC FIELD</TITLE>
14441 </HEAD>
14442 <BODY>
14443 <H1>THE MESSAGE COMPOSER'S LCC FIELD</H1>
14444 The &quot;Lcc:&quot; (List carbon copy) header is intended to be used when
14445 you wish to send a message to a list of people but avoid having all
14446 of their addresses visible, in order to reduce clutter when the
14447 message is received.
14448 <P>
14449 It is similar to the
14450 <A HREF="h_composer_bcc">&quot;Bcc&quot; (Blind carbon copy) header</A>
14451 in that individual
14452 addressees are hidden, but Lcc is designed to work specifically with
14453 distribution lists you have created in your
14454 <A HREF="h_abook_opened">Alpine Address Book</A>.  Placing
14455 the nickname of the list on the Lcc line will result in the full name of
14456 your Alpine Address Book list being placed on the To: line of the message,
14457 using a special notation that distinguishes it from a real address. You
14458 must leave the To: line blank for your list name to appear there.
14459 <P>
14460 For example, if you have this list entered in your Address Book:<PRE>
14461
14462         largo         Key Largo List       DISTRIBUTION LIST:
14463                                            bogie@mgm.com
14464                                            lauren@mgm.com
14465                                            walter@mgm.com</PRE>
14466
14467
14468 and you enter &quot;largo&quot; on the Lcc: line while composing a message,
14469 the result is:<PRE>
14470
14471         To      : Key Largo List: ;
14472         Cc      :
14473         Bcc     :
14474         Fcc     : sent-mail
14475         Lcc     : Key Largo List &lt;bogie@mgm.com&gt;,
14476                   lauren@mgm.com,
14477                   walter@mgm.com
14478         Subject :</PRE>
14479
14480 Each recipient listed on the Lcc: line receives a copy of the message
14481 without their address being visible (as though they were listed on the
14482 Bcc: line). The colon-semicolon notation used to put the full-name of the
14483 list on the To: line is a special address format that doesn't specify any
14484 actual addressees, but does give some information to the recipients of the
14485 message.
14486 <P>
14487 Note: if after entering an LCC, you delete the list name that is placed
14488 on the To: line, then recipients will see <PRE>
14489        To: undisclosed-recipients: ;</PRE>
14490
14491 (or whatever string is defined in the
14492 <A HREF="h_config_empty_hdr_msg">&quot;<!--#echo var="VAR_empty-header-message"-->&quot;</A>
14493 variable) just as in the BCC case.
14494 <P>
14495 For help with Lcc: field editing
14496 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
14497 <P>
14498 <UL>
14499 <LI><A HREF="h_address_format">Explanation of Address formats</A>
14500 </UL>
14501 <P>
14502 <UL>
14503 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14504 </UL><P>
14505 &lt;End of help on this topic&gt;
14506 </BODY>
14507 </HTML>
14508 ======= h_composer_from =======
14509 <HTML>
14510 <HEAD>
14511 <TITLE>THE MESSAGE COMPOSER'S FROM FIELD</TITLE>
14512 </HEAD>
14513 <BODY>
14514 <H1>THE MESSAGE COMPOSER'S FROM FIELD</H1>
14515
14516 This header carries your return address.  It is the address toward which
14517 replies (and often, future unrelated correspondence) will be directed,
14518 unless you have <A HREF="h_config_custom_hdrs">defined an optional
14519 &quot;Reply-To:&quot; header</A> in the SETUP CONFIGURATION screen.  Make
14520 sure this address is correct.
14521 <P>
14522 For help with message header editing
14523 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
14524 <P>
14525 <UL>
14526 <LI><A HREF="h_address_format">Explanation of Address formats</A>
14527 </UL>
14528 <P>
14529 <UL>
14530 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14531 </UL><P>
14532 &lt;End of help on this topic&gt;
14533 </BODY>
14534 </HTML>
14535 ======= h_composer_reply_to =======
14536 <HTML>
14537 <HEAD>
14538 <TITLE>THE MESSAGE COMPOSER'S REPLY-TO FIELD</TITLE>
14539 </HEAD>
14540 <BODY>
14541 <H1>THE MESSAGE COMPOSER'S REPLY-TO FIELD</H1>
14542
14543 Most people should not need this header. The Reply-To: header is used in
14544 cases where you would like replies to your messages to be directed to an
14545 address other than your normal &quot;From:&quot; address.  This is atypical,
14546 but can happen when you use multiple machines and do not have the same account
14547 name on each one, or when you wish to direct certain replies to accounts
14548 or folders designated for specific classes of correspondence.
14549 <P>
14550 For help with message header editing
14551 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
14552 <P>
14553 <UL>
14554 <LI><A HREF="h_address_format">Explanation of Address formats</A>
14555 </UL>
14556
14557 <P>
14558 <UL>
14559 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14560 </UL><P>
14561 &lt;End of help on this topic&gt;
14562 </BODY>
14563 </HTML>
14564 ======= h_composer_custom_addr ====
14565 <HTML>
14566 <HEAD>
14567 <TITLE>CUSTOMIZED HEADER FIELD</TITLE>
14568 </HEAD>
14569 <BODY>
14570 <H1>CUSTOMIZED HEADER FIELD</H1>
14571 This is a customized header, i.e. not one that is part of Alpine's normal
14572 set of Compose headers.
14573 <P>
14574 For help with message header editing
14575 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
14576 <P>
14577 <UL>
14578 <LI><A HREF="h_address_format">Explanation of Address formats</A>
14579 </UL>
14580 <P>
14581 <UL>
14582 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14583 </UL><P>
14584 &lt;End of help on this topic&gt;
14585 </BODY>
14586 </HTML>
14587 ======= h_composer_custom_free ====
14588 <HTML>
14589 <HEAD>
14590 <TITLE>CUSTOMIZED HEADER FIELD</TITLE>
14591 </HEAD>
14592 <BODY>
14593 <H1>CUSTOMIZED HEADER FIELD</H1>
14594 This is a customized header, i.e. not one that is part of Alpine's normal
14595 set of Compose headers.
14596 <P>
14597 This field consists of arbitrary text.
14598 <P>
14599 For help with message header editing
14600 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
14601 <P>
14602 <UL>
14603 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14604 </UL><P>
14605 &lt;End of help on this topic&gt;
14606 </BODY>
14607 </HTML>
14608 ====== h_composer_news =====
14609 <HTML>
14610 <HEAD>
14611 <TITLE>THE MESSAGE COMPOSER'S NEWSGRPS LINE</TITLE>
14612 </HEAD>
14613 <BODY>
14614 <h1>THE MESSAGE COMPOSER'S NEWSGRPS LINE</h1>
14615 Use the newsgroups line to specify any and all USENET newsgroups to which
14616 your message should be posted.  When composing a message from scratch, this
14617 line may be hidden.  If so, just press the rich headers command
14618 (<!--chtml if pinemode="function_key"-->F5<!--chtml else-->^R<!--chtml endif-->)
14619 to make it visible.
14620 <P>
14621 <EM>Be aware</EM> that when you post to a newsgroup thousands of
14622 people will be reading your message.  Also, you or your system manager
14623 must have defined an &quot;<!--#echo var="VAR_nntp-server"-->&quot; in your Alpine configuration
14624 in order for you to be able to post.
14625 <P>
14626 For help with message header editing
14627 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
14628 <P><UL>
14629 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14630 </UL>
14631 <P>
14632 &lt;End of help on this topic&gt;
14633 </BODY>
14634 </HTML>
14635 ======= h_composer_fcc ====
14636 <HTML>
14637 <HEADER>
14638 <TITLE>THE MESSAGE COMPOSER'S FCC FIELD</TITLE>
14639 </HEADER>
14640 <BODY>
14641 <H1>THE MESSAGE COMPOSER'S FCC FIELD</H1>
14642 The FCC (File Carbon Copy) specifies the folder used to keep a copy of
14643 each outgoing message.  The default value can be configured with the
14644 &quot;<!--#echo var="VAR_default-fcc"-->&quot; and &quot;<!--#echo var="VAR_fcc-name-rule"-->&quot; options.  You can change or remove
14645 the file carbon copy on any message you send by editing the FCC header.<p>
14646
14647 You may type ^T to get a list of all your folders and select one to use as
14648 the FCC for this message.<P>
14649
14650 For help with message header editing
14651 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
14652 <P>
14653 <UL>
14654 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14655 </UL><P>
14656 &lt;End of help on this topic&gt;
14657 </BODY>
14658 </HTML>
14659 ======= h_composer_subject ====
14660 <HTML>
14661 <HEADER>
14662 <TITLE>THE MESSAGE COMPOSER'S SUBJECT FIELD</TITLE>
14663 </HEADER>
14664 <BODY>
14665 <H1>THE MESSAGE COMPOSER'S SUBJECT FIELD</H1>
14666
14667 The subject header provides a place to enter a few words that summarize
14668 the topic of the message you are sending.  You may leave this line blank,
14669 but it is considered a courtesy to use a meaningful subject.<p>
14670
14671 For help with message header editing
14672 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
14673 <P>
14674 <UL>
14675 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14676 </UL><P>
14677 &lt;End of help on this topic&gt;
14678 </BODY>
14679 </HTML>
14680 ======= h_composer_attachment ====
14681 <HTML>
14682 <HEAD>
14683 <TITLE>THE MESSAGE COMPOSER'S ATTCHMNT FIELD</TITLE>
14684 </HEAD>
14685 <BODY>
14686 <H1>THE MESSAGE COMPOSER'S ATTCHMNT FIELD</H1>
14687
14688 The &quot;Attchmnt:&quot; field is where you specify what file or
14689 files you'd like attached to
14690 the message you are composing.  Those files must reside on the machine
14691 running Alpine. If your file is on a PC or Mac and you run Alpine with an
14692 account on a Unix machine, you'll have to transfer it before attaching it.
14693 Contact local computer support people for assistance with transferring.
14694
14695 <P>
14696 The file name
14697 given can be an absolute file path name for your system
14698 <!--chtml if pinemode="os_windows"-->
14699 (for example, &quot;H:&#92;SIGFILES&#92;FULLINFO.TXT&quot;), a file
14700 with a relative pathname, or simply a file name without
14701 drive or directory specification.
14702 <!--chtml else-->
14703 (for example, &quot;/tmp/exported.earlier&quot; on Unix hosts),
14704 a file in your home directory, or a file path relative to your
14705 home directory.  In Unix Alpine, you may use &quot;~&quot; to refer to
14706 your home directory or &quot;~user&quot; to refer to another
14707 account's home directory.
14708 <!--chtml endif--><P>
14709 No wild card characters may be used.
14710 <P>If the
14711 <A HREF="h_config_use_current_dir">&quot;<!--#echo var="FEAT_use-current-dir"-->&quot;</A>
14712 feature is set, names are relative to your current working directory
14713 <!--chtml if pinemode="running"-->
14714 (which, at least for your current Alpine &quot;session,&quot;
14715 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
14716 <!--chtml endif-->
14717 rather than your home directory
14718 <!--chtml if pinemode="running"-->
14719 (which, in the present configuration of your system, is
14720  &quot;<!--#echo var="HOME_DIR"-->&quot;)
14721 <!--chtml endif-->
14722 .
14723 <P>
14724 Alpine uses MIME encoding for attachments, so binaries and files of any
14725 length can safely be delivered to any MIME-capable mail reading program.
14726 If you send an attachment to someone who does not have a MIME-capable mail
14727 reading program yet, then the main message text will be readable, but
14728 attachments (even attachments that are just plain text) are not.
14729 <P>
14730
14731 Typing the filename on the Attchmnt: line achieves the same
14732 result as using the
14733 <!--chtml if pinemode="function_key"-->
14734 F6
14735 <!--chtml else-->
14736 Ctrl-J
14737 <!--chtml endif--> command.
14738 <P>
14739
14740 If you Forward a message with attachments, you may delete them from your
14741 Forwarded message by editing the Attchmnt header line.
14742 <P>
14743
14744 For help with message header editing
14745 commands, check the <A HREF="h_composer_to">Help for the To:</A> header.
14746 <P>
14747 <UL>
14748 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
14749 </UL><P>
14750 &lt;End of help on this topic&gt;
14751 </BODY>
14752 </HTML>
14753 ======= h_composer_ctrl_j ====
14754 <HTML>
14755 <HEAD>
14756 <TITLE>COMPOSER ATTACH</TITLE>
14757 </HEAD>
14758 <BODY>
14759 After the
14760 <!--chtml if pinemode="function_key"-->
14761 F6
14762 <!--chtml else-->
14763 Ctrl-J
14764 <!--chtml endif--> command:
14765 At the &quot;File to attach:&quot; prompt, enter the name of the
14766 existing file to attach to your message.
14767 When the feature
14768 <A HREF="h_config_enable_tab_complete">&quot;<!--#echo var="FEAT_enable-tab-completion"-->&quot;</A>
14769 is set
14770 you need only enter the beginning of the filename (enough of it to uniquely
14771 identify the file) and press TAB to complete it.
14772
14773 Or, press ^T to use the BROWSER screen for
14774 selecting the file.  <P>
14775 For more information on attaching files, see the help screen for the
14776 composer's
14777 <A HREF="h_composer_attachment">Attchmnt: field</A>, which is normally hidden,
14778 but can be revealed using the
14779 <!--chtml if pinemode="function_key"-->
14780 F5
14781 <!--chtml else-->
14782 Ctrl-R
14783 <!--chtml endif-->
14784 command with the cursor positioned above the
14785 &quot;----- Message Text -----&quot; line in the COMPOSE MESSAGE screen.
14786 <P>
14787 &lt;End of help on this topic&gt;
14788 </BODY>
14789 </HTML>
14790 ======= h_edit_nav_cmds =========
14791 <HTML>
14792 <HEAD>
14793 <TITLE>Composer Editing Commands Explained</TITLE>
14794 </HEAD>
14795 <BODY>
14796 <H1>EDITING and NAVIGATION COMMANDS</H1>
14797 <!--chtml if pinemode="function_key"-->
14798 <PRE>
14799 CURSOR MOTION KEYS----------------------|EDITING KEYS-------------------------
14800 ^B (Left Arrow)    Back character       | ^D       Delete current character
14801 ^F (Right Arrow)   Forward character    | ^H (DEL) Delete previous character
14802 ^P (Up Arrow)      Previous line        |
14803 ^N (Down Arrow)    Next line            | F9       Cut marked text or
14804 ^A                 Beginning of line    |            delete current line
14805 ^E                 End of line          | F10      Undelete line(s)
14806 F7                 Previous page        |
14807 F8                 Next page            |-------------------------------------
14808 ^@ (Ctrl-SPACE)    Next word            | MISCELLANEOUS COMMANDS
14809 ----------------------------------------|
14810 EXIT COMMANDS    |  GENERAL COMMANDS    | F12    To Addressbook
14811 F3   Cancel      |   F1    Get help     | F12    RichView (expand lists)
14812 F2  eXit/save    |   ^Z    Suspend      | ^L     Redraw Screen
14813 </PRE>
14814 <!--chtml else-->
14815 <PRE>
14816 CURSOR MOTION KEYS----------------------|EDITING KEYS-------------------------
14817 ^B (Left Arrow)    Back character       | ^D       Delete current character
14818 ^F (Right Arrow)   Forward character    | ^H (DEL) Delete previous character
14819 ^P (Up Arrow)      Previous line        |
14820 ^N (Down Arrow)    Next line            | ^K       Cut marked text or
14821 ^A                 Beginning of line    |            delete current line
14822 ^E                 End of line          | ^U       Undelete line(s)
14823 ^Y                 Previous page        |
14824 ^V                 Next page            |-------------------------------------
14825 ^@ (Ctrl-SPACE)    Next word            | MISCELLANEOUS COMMANDS
14826 ----------------------------------------|
14827 EXIT COMMANDS    |  GENERAL COMMANDS    | ^T     To Addressbook
14828 ^C   Cancel      |   ^G    Get help     | ^R     RichView  (expand lists)
14829 ^X   eXit/save   |   ^Z    Suspend      | ^L     Redraw Screen
14830 </PRE>
14831 <!--chtml endif-->
14832 &lt;End of help on this topic&gt;
14833 </BODY>
14834 </HTML>
14835 ===== h_composer_sigedit =====
14836 <HTML>
14837 <HEAD>
14838 <TITLE>Signature Editor Commands Explained</TITLE>
14839 </HEAD>
14840 <BODY>
14841 <H1>SIGNATURE EDITOR COMMANDS</H1>
14842 <!--chtml if pinemode="function_key"-->
14843 <PRE>
14844 CURSOR MOTION KEYS                     |EDITING KEYS
14845   ^B (Left Arrow)   Back character     | ^D       Delete current character
14846   ^F (Right Arrow)  Forward character  | ^H (DEL) Delete previous character
14847   ^P (Up Arrow)     Previous line      | ^^       Set a mark
14848   ^N (Down Arrow)   Next line          | F9       Cut marked text or
14849   ^A                Beginning of line  |           delete current line
14850   ^E                End of line        | F10       Paste text, undelete lines
14851   F7                Previous page      |           cut with ^K, or unjustify
14852   F8                Next page          |-------------------------------------
14853   ^@ (Ctrl-SPACE)   Next word          |SCREEN/COMPOSITION COMMANDS
14854 ---------------------------------------| F6       Whereis (search for string)
14855 MESSAGE COMMANDS | GENERAL COMMANDS    | F12      Spell checker
14856  F3   Cancel     |  F1    Get help     | F4       Justify paragraph
14857                  |  ^Z    Suspend      | ^L       Redraw Screen
14858  F2   Send       |  F6    Alt. editor  | F5       Read in a file
14859 </PRE>
14860 <!--chtml else-->
14861 <PRE>
14862 CURSOR MOTION KEYS                     |EDITING KEYS
14863   ^B (Left Arrow)   Back character     | ^D       Delete current character
14864   ^F (Right Arrow)  Forward character  | ^H (DEL) Delete previous character
14865   ^P (Up Arrow)     Previous line      | ^^       Set a mark
14866   ^N (Down Arrow)   Next line          | ^K       Cut marked text or
14867   ^A                Beginning of line  |           delete current line
14868   ^E                End of line        | ^U        Paste text, undelete lines
14869   ^Y                Previous page      |           cut with ^K, or unjustify
14870   ^V                Next page          |-------------------------------------
14871   ^@ (Ctrl-SPACE)   Next word          |SCREEN/COMPOSITION COMMANDS
14872 ---------------------------------------| ^W       <A HREF="h_composer_search">Whereis</A> (search text)
14873 MESSAGE COMMANDS | GENERAL COMMANDS    | ^T       Spell checker
14874  ^C   Cancel     |  ^G    Get help     | ^J       <A HREF="h_compose_justify">Justify</A> paragraph
14875                  |  ^Z    <A HREF="h_common_suspend">Suspend</A>      | ^L       Redraw Screen
14876  ^X   Send       |  ^_    Alt. editor  | ^R       Read in a file
14877 </PRE>
14878 <!--chtml endif-->
14879
14880 NOTE: The presence or absence of the following commands is determined
14881 by &quot;Feature-List&quot; options in your Alpine configuration.  Also,
14882 some of these commands may be administratively disabled by your system
14883 manager; if they don't work, please check with your local help desk
14884 before reporting a bug.
14885 <P>
14886 <UL>
14887  <LI>Suspend (suspends Alpine and gives a system prompt)
14888  <LI>Alternate editor (allows you to compose with your own editor)
14889 </UL>
14890 <P>
14891
14892 Alpine does not use the following keys:  Ctrl-S, Ctrl-Q, Ctrl-],
14893 Ctrl-&#92;, ESC
14894 <P>
14895
14896 NOTE: For special handling of Ctrl-S and Ctrl-Q see special comments regarding
14897 <A HREF="h_special_xon_xoff">&quot;XOFF/XON&quot;</A>.
14898 <P>
14899 &lt;End of help on this topic&gt;
14900 </BODY>
14901 </HTML>
14902 ===== h_composer_commentedit =====
14903 <HTML>
14904 <HEAD>
14905 <TITLE>Comment Editor Commands Explained</TITLE>
14906 </HEAD>
14907 <BODY>
14908 <H1>COMMENT EDITOR COMMANDS</H1>
14909 <!--chtml if pinemode="function_key"-->
14910 <PRE>
14911 CURSOR MOTION KEYS                     |EDITING KEYS
14912   ^B (Left Arrow)   Back character     | ^D       Delete current character
14913   ^F (Right Arrow)  Forward character  | ^H (DEL) Delete previous character
14914   ^P (Up Arrow)     Previous line      | ^^       Set a mark
14915   ^N (Down Arrow)   Next line          | F9       Cut marked text or
14916   ^A                Beginning of line  |           delete current line
14917   ^E                End of line        | F10       Paste text, undelete lines
14918   F7                Previous page      |           cut with ^K, or unjustify
14919   F8                Next page          |-------------------------------------
14920   ^@ (Ctrl-SPACE)   Next word          |SCREEN/COMPOSITION COMMANDS
14921 ---------------------------------------| F6       Whereis (search for string)
14922 MESSAGE COMMANDS | GENERAL COMMANDS    | F12      Spell checker
14923  F3   Cancel     |  F1    Get help     | F4       Justify paragraph
14924                  |  ^Z    Suspend      | ^L       Redraw Screen
14925  F2   Send       |  F6    Alt. editor  | F5       Read in a file
14926 </PRE>
14927 <!--chtml else-->
14928 <PRE>
14929 CURSOR MOTION KEYS                     |EDITING KEYS
14930   ^B (Left Arrow)   Back character     | ^D       Delete current character
14931   ^F (Right Arrow)  Forward character  | ^H (DEL) Delete previous character
14932   ^P (Up Arrow)     Previous line      | ^^       Set a mark
14933   ^N (Down Arrow)   Next line          | ^K       Cut marked text or
14934   ^A                Beginning of line  |           delete current line
14935   ^E                End of line        | ^U        Paste text, undelete lines
14936   ^Y                Previous page      |           cut with ^K, or unjustify
14937   ^V                Next page          |-------------------------------------
14938   ^@ (Ctrl-SPACE)   Next word          |SCREEN/COMPOSITION COMMANDS
14939 ---------------------------------------| ^W       <A HREF="h_composer_search">Whereis</A> (search text)
14940 MESSAGE COMMANDS | GENERAL COMMANDS    | ^T       Spell checker
14941  ^C   Cancel     |  ^G    Get help     | ^J       <A HREF="h_compose_justify">Justify</A> paragraph
14942                  |  ^Z    <A HREF="h_common_suspend">Suspend</A>      | ^L       Redraw Screen
14943  ^X   Send       |  ^_    Alt. editor  | ^R       Read in a file
14944 </PRE>
14945 <!--chtml endif-->
14946
14947 NOTE: The presence or absence of the following commands is determined
14948 by &quot;Feature-List&quot; options in your Alpine configuration.  Also,
14949 some of these commands may be administratively disabled by your system
14950 manager; if they don't work, please check with your local help desk
14951 before reporting a bug.
14952 <P>
14953 <UL>
14954  <LI>Suspend (suspends Alpine and gives a system prompt)
14955  <LI>Alternate editor (allows you to compose with your own editor)
14956 </UL>
14957 <P>
14958
14959 Alpine does not use the following keys:  Ctrl-S, Ctrl-Q, Ctrl-],
14960 Ctrl-&#92;, ESC
14961 <P>
14962
14963 NOTE: For special handling of Ctrl-S and Ctrl-Q see special comments regarding
14964 <A HREF="h_special_xon_xoff">&quot;XOFF/XON&quot;</A>.
14965 <P>
14966 &lt;End of help on this topic&gt;
14967 </BODY>
14968 </HTML>
14969 ======= h_composer_abook_nick =======
14970 <HTML>
14971 <HEAD>
14972 <TITLE>Addressbook Nickname Explained</TITLE>
14973 </HEAD>
14974 <BODY>
14975 This is a short nickname for this address book entry.  If it is used in
14976 place of an address from the composer, the composer will fill in the
14977 address(es) for the entry that matches the nickname.
14978 <P>
14979
14980 Look <A HREF="h_edit_nav_cmds">here</A>
14981 to see the available Editing and Navigation commands.
14982 <P>
14983 &lt;End of help on this topic&gt;
14984 </BODY>
14985 </HTML>
14986 ======= h_composer_abook_full =======
14987 <HTML>
14988 <HEAD>
14989 <TITLE>Addressbook Fullname Explained</TITLE>
14990 </HEAD>
14991 <BODY>
14992 This is the full name field for this entry.  If this is going to be a
14993 distribution list (more than one address), it should be a descriptive
14994 phrase describing the list.  It will be included in the mail header if you
14995 put the list in the To: or CC: field, or in the To: line if you put the
14996 list in the Lcc: field.  It's OK to leave this field blank (and OK to
14997 leave any of the other fields blank, too). If this address book entry is
14998 going to be a simple entry with just one address, then this field is the
14999 person's name. When you send mail to this entry, this is the field to the
15000 left of the brackets. That is, it is the most readable part of the
15001 address. For example, in the sample address:
15002 <PRE>
15003        John Doe &lt;jdoe@some.domain&gt;
15004 </PRE>
15005 "John Doe" is the full name field. If you are sorting your address book
15006 with one of the options that uses full names, then it might be useful to
15007 enter the full name as "Last, First", for example:
15008 <PRE>
15009        Doe, John
15010 </PRE>
15011 so that it will be sorted using Doe instead of John. This will be changed
15012 back into John Doe when you use it.
15013 <P>
15014 Look <A HREF="h_edit_nav_cmds">here</A>
15015 to see the available Editing and Navigation commands.
15016 <P>
15017 &lt;End of help on this topic&gt;
15018 </BODY>
15019 </HTML>
15020 ======= h_composer_abook_fcc =======
15021 <HTML>
15022 <HEAD>
15023 <TITLE>Addressbook Fcc Explained</TITLE>
15024 </HEAD>
15025 <BODY>
15026 If this entry is the first one in the To: line of an outgoing message,
15027 this field will be used for the Fcc (File Carbon Copy) instead of whatever
15028 you would normally get (which depends on which
15029 <A HREF="h_config_saved_msg_name_rule">&quot;<!--#echo var="VAR_saved-msg-name-rule"-->&quot;</A>
15030 you've chosen).
15031 <P>
15032 If this field consists of two double quotes (&quot;&quot;) that tells Alpine
15033 that you don't want any Fcc associated with this entry.
15034 <P>
15035 Look <A HREF="h_edit_nav_cmds">here</A>
15036 to see the available Editing and Navigation commands.
15037 <P>
15038 &lt;End of help on this topic&gt;
15039 </BODY>
15040 </HTML>
15041 ====== h_config_combined_abook_display =====
15042 <HTML>
15043 <HEAD>
15044 <TITLE>FEATURE: <!--#echo var="FEAT_combined-addrbook-display"--></TITLE>
15045 </HEAD>
15046 <BODY>
15047 <H1>FEATURE: <!--#echo var="FEAT_combined-addrbook-display"--></H1>
15048
15049 This feature affects the address book display screens.
15050 Normally, expanding an address book from the ADDRESS BOOK LIST screen
15051 will cause the remaining address books and directory servers to disappear
15052 from the screen, leaving only the entries of the expanded address book.
15053 If this feature is set, then the other address books will remain on the screen,
15054 so that all of the address books can be present at once.
15055
15056 <P>
15057 The way that commands work won't be changed.
15058 For example, the Select All command will select all of the entries in the
15059 current address book, not all of the entries in all of the address books.
15060 The WhereIs command will change a little.
15061 It will search through all of the text on the screen plus all of the entries
15062 from expanded address books.
15063
15064 <P>
15065 When this feature is set, the setting of the feature
15066 <A HREF="h_config_expanded_addrbooks">&quot;<!--#echo var="FEAT_expanded-view-of-addressbooks"-->&quot;</A>
15067 has an effect.
15068 <P>
15069 &lt;End of help on this topic&gt;
15070 </BODY>
15071 </HTML>
15072 ====== h_config_titlebar_color_style =====
15073 <HTML>
15074 <HEAD>
15075 <TITLE>OPTION: <!--#echo var="VAR_titlebar-color-style"--></TITLE>
15076 </HEAD>
15077 <BODY>
15078 <H1>OPTION: <!--#echo var="VAR_titlebar-color-style"--></H1>
15079
15080 This option affects the colors used to display the titlebar (the top
15081 line on the screen) when viewing a message.
15082
15083 <P>
15084 The available options include:
15085 <P>
15086
15087 <DL>
15088 <DT>default</DT>
15089 <DD>The color of the titlebar will be the color you set for the
15090 <A HREF="h_config_title_color">Title Color</A>.
15091 The Title Color may be set by using the
15092 <A HREF="h_color_setup">Setup Kolor</A> screen.
15093 </DD>
15094
15095 <DT>indexline</DT>
15096 <DD>The color of the titlebar will be the same as the color of the
15097 index line corresponding to the message being viewed.
15098 The rules that determine what color the index line will be may be set
15099 up by going to the Setup/Rules/Indexcolor screen.
15100 If the index line for a message is not colored explicitly by the
15101 Indexcolor rules, then the titlebar will be colored the same as for
15102 the &quot;default&quot; option above (which is not the same color that
15103 the index line itself will have).
15104 </DD>
15105
15106 <DT>reverse-indexline</DT>
15107 <DD>This is similar to the &quot;indexline&quot; option except the
15108 foreground and background colors from the corresponding index line will
15109 be reversed.
15110 For example, if the index line color is red letters on a white background,
15111 then the titlebar will be white letters on a red background.
15112 If the index line for a message is not colored explicitly by the
15113 Indexcolor rules, then the titlebar will be colored the same as for
15114 the &quot;default&quot; option above (which is not the same color that
15115 the index line itself will have).
15116 </DD>
15117 </DL>
15118
15119 <P>
15120
15121 <UL>
15122 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
15123 </UL><P>
15124 &lt;End of help on this topic&gt;
15125 </BODY>
15126 </HTML>
15127 ====== h_config_index_color_style =====
15128 <HTML>
15129 <HEAD>
15130 <TITLE>OPTION: <!--#echo var="VAR_current-indexline-style"--></TITLE>
15131 </HEAD>
15132 <BODY>
15133 <H1>OPTION: <!--#echo var="VAR_current-indexline-style"--></H1>
15134
15135 This option affects the colors used to display the current line in the
15136 MESSAGE INDEX screen.
15137 If you do not have Index Color Rules defined, then this option will
15138 have no effect in the index.
15139 Those Rules may be defined by going to the Setup/Rules/Indexcolor screen.
15140 <P>
15141 If the option
15142 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
15143 is turned on and the
15144 <A HREF="h_config_incunseen_color">Incoming Unseen Color</A>
15145 is set to something other than the default, then
15146 this option also affects the color used to display the current folder
15147 in the Incoming FOLDER LIST screen.
15148
15149 <P>
15150 The available options include:
15151 <P>
15152
15153 <DL>
15154 <DT>flip-colors</DT>
15155 <DD>This is the default.
15156 If an index line is colored because it matches one of your
15157 Index Color Rules, then its colors will be reversed when it is the currently
15158 highlighted line.
15159 For example, if the line is normally red text on a blue background, then
15160 when it is the current line it will be drawn as blue text on a red background.
15161 <P>
15162 The rest of the option values all revert to this flip-colors behavior if
15163 there is no Reverse Color defined.
15164 </DD>
15165
15166 <DT>reverse</DT>
15167 <DD>With this option the Reverse color is always used to highlight the
15168 current line.
15169 </DD>
15170
15171 <DT>reverse-fg</DT>
15172 <DD>The foreground part of the Reverse Color is used to highlight
15173 the current line.
15174 If this would cause the text to be unreadable (because the foreground and
15175 background colors are the same) or if it would cause no change in the
15176 color of the index line, then the colors are flipped instead.
15177 <P>
15178 Some people think this works particularly well if you use different
15179 background colors to emphasize &quot;interesting&quot; lines,
15180 but always with the same Normal foreground color,
15181 and you use a different foreground color for the Reverse Color.
15182 </DD>
15183
15184 <DT>reverse-fg-no-ambiguity</DT>
15185 <DD>With the &quot;reverse-fg&quot; rule above, it is possible that
15186 the resulting color will be exactly the same as the regular Reverse
15187 Color.
15188 That can lead to some possible confusion because an
15189 &quot;interesting&quot;
15190 line that is the current line will be displayed exactly the same as a
15191 non-interesting line that is current.
15192 You can't tell whether the line is just a regular current line or if it is
15193 an &quot;interesting&quot; current line by looking at the color.
15194 Setting the option to this value removes that ambiguity.
15195 It is the same as the &quot;reverse-fg&quot; setting unless the resulting
15196 interesting current line would look just like a non-interesting current line.
15197 In that case, the interesting line's colors are simply flipped (like in the
15198 default behavior).
15199 <P>
15200 As an alternative way to preserve the line's interestingness in this case,
15201 you may find that using both a different foreground and a different
15202 background color for the interesting line will help.
15203 </DD>
15204
15205 <DT>reverse-bg</DT>
15206 <DD>The background part of the Reverse Color is used to highlight
15207 the current line.
15208 If this would cause the text to be unreadable (because the foreground and
15209 background colors are the same) or if it would cause no change in the
15210 color of the index line, then the colors are flipped instead.
15211 <P>
15212 Some people think this works particularly well if you use different
15213 foreground colors to emphasize &quot;interesting&quot; lines,
15214 but always with the same Normal background color,
15215 and you use a different background color for the Reverse Color.
15216 </DD>
15217
15218 <DT>reverse-bg-no-ambiguity</DT>
15219 <DD>As with the &quot;reverse-fg&quot; case, the &quot;reverse-bg&quot;
15220 rule may also result in a color that is exactly the same as the regular
15221 Reverse Color.
15222 Setting the option to this value removes that ambiguity.
15223 It is the same as the &quot;reverse-bg&quot; setting unless the resulting
15224 current line has the same color as the Reverse Color.
15225 In that case, the interesting line's colors are simply flipped (like in the
15226 default behavior).
15227 </DD>
15228 </DL>
15229
15230 <P>
15231
15232 <UL>
15233 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
15234 </UL><P>
15235 &lt;End of help on this topic&gt;
15236 </BODY>
15237 </HTML>
15238 ====== h_config_expanded_addrbooks =====
15239 <HTML>
15240 <HEAD>
15241 <TITLE>FEATURE: <!--#echo var="FEAT_expanded-view-of-addressbooks"--></TITLE>
15242 </HEAD>
15243 <BODY>
15244 <H1>FEATURE: <!--#echo var="FEAT_expanded-view-of-addressbooks"--></H1>
15245
15246 If multiple address books (either personal or global) are defined, and you
15247 wish to have them all expanded implicitly upon entering the ADDRESS BOOK
15248 screen, then set this feature. This feature will have no effect unless the
15249 feature
15250 <A HREF="h_config_combined_abook_display">&quot;<!--#echo var="FEAT_combined-addrbook-display"-->&quot;</A>
15251 is also set.
15252 <P>
15253 &lt;End of help on this topic&gt;
15254 </BODY>
15255 </HTML>
15256 ====== h_config_combined_folder_display =====
15257 <HTML>
15258 <HEAD>
15259 <TITLE>FEATURE: <!--#echo var="FEAT_combined-folder-display"--></TITLE>
15260 </HEAD>
15261 <BODY>
15262 <H1>FEATURE: <!--#echo var="FEAT_combined-folder-display"--></H1>
15263
15264 This feature affects the folder list display screens.
15265 Normally, each folder list is viewed within its collection only.  This
15266 command allows folder lists to be viewed within a single screen that
15267 combines the contents of all collections.
15268
15269 <P>
15270 The way that commands work won't be changed.
15271 For example, the Select All command will select all of the folders in the
15272 current collection, not all of the entries in all of the collections.
15273 The WhereIs command will change a little.
15274 It will search through all of the folders in the current collection as well
15275 as all the folder in any other expanded collection.
15276
15277 <P>
15278 When this feature is set, the setting of the feature
15279 <A HREF="h_config_expanded_folders">&quot;<!--#echo var="FEAT_expanded-view-of-folders"-->&quot;</A>
15280 has an effect.
15281 <P>
15282 &lt;End of help on this topic&gt;
15283 </BODY>
15284 </HTML>
15285 ====== h_config_combined_subdir_display =====
15286 <HTML>
15287 <HEAD>
15288 <TITLE>FEATURE: <!--#echo var="FEAT_combined-subdirectory-display"--></TITLE>
15289 </HEAD>
15290 <BODY>
15291 <H1>FEATURE: <!--#echo var="FEAT_combined-subdirectory-display"--></H1>
15292
15293 This feature affects the Folder List screen when
15294 the
15295 <A HREF="h_config_combined_folder_display">&quot;<!--#echo var="FEAT_combined-folder-display"-->&quot;</A>
15296 feature is enabled.  Normally, selecting a directory from the Folder
15297 List takes you into a new screen displaying only the contents of
15298 that directory.
15299
15300 <P>
15301 Enabling this feature will cause the contents of the selected
15302 directory to be
15303 displayed within the boundaries of the &quot;Collection&quot; it
15304 is a part of.  All previously displayed collections will remain
15305 in the screen.
15306
15307 <P>
15308 The way that commands work won't be changed.
15309 For example, the Select All command will select all of the folders in the
15310 directory, as opposed to all of the entries in all of the collections.
15311 The WhereIs command will change a little.
15312 It will search through all of the folders in the current collection as well
15313 as all the folder in any other expanded collection.
15314
15315 <P>
15316 &lt;End of help on this topic&gt;
15317 </BODY>
15318 </HTML>
15319 ====== h_config_separate_fold_dir_view =====
15320 <HTML>
15321 <HEAD>
15322 <TITLE>FEATURE: <!--#echo var="FEAT_separate-folder-and-directory-entries"--></TITLE>
15323 </HEAD>
15324 <BODY>
15325 <H1>FEATURE: <!--#echo var="FEAT_separate-folder-and-directory-entries"--></H1>
15326
15327 This feature affects folder collections wherein a folder
15328 and directory can have the same name.  By default, Alpine displays them
15329 only once, denoting that it is both a folder and directory by appending
15330 the folder name with the hierarchy character enclosed
15331 in square brackets.
15332
15333
15334 <P>
15335 Enabling this feature will cause Alpine to display such names
15336 separately marking the name representing a directory with a trailing
15337 hierarchy delimiter (typically the slash, &quot;/&quot;, character).
15338
15339 <P>
15340 The feature also alters the command set slightly.  By default, the
15341 right-arrow descends into the directory, while hitting the Return key will
15342 cause the folder by that name to be opened.
15343
15344 <P>
15345 With this feature set, the Return key will open the highlighted folder, or
15346 enter the highlighted directory.
15347
15348 <P>
15349 &lt;End of help on this topic&gt;
15350 </BODY>
15351 </HTML>
15352 ====== h_config_expanded_folders =====
15353 <HTML>
15354 <HEAD>
15355 <TITLE>FEATURE: <!--#echo var="FEAT_expanded-view-of-folders"--></TITLE>
15356 </HEAD>
15357 <BODY>
15358 <H1>FEATURE: <!--#echo var="FEAT_expanded-view-of-folders"--></H1>
15359
15360 If multiple folder collections are defined, and you
15361 wish to have them all expanded implicitly upon entering the FOLDER LIST
15362 screen, then set this feature. This feature will have no effect unless the
15363 feature
15364 <A HREF="h_config_combined_folder_display">&quot;<!--#echo var="FEAT_combined-folder-display"-->&quot;</A>
15365 is also set.
15366 <P>
15367 &lt;End of help on this topic&gt;
15368 </BODY>
15369 </HTML>
15370 ======= h_config_ldap_server =======
15371 <HTML>
15372 <HEAD>
15373 <TITLE>LDAP OPTION: <!--#echo var="VAR_ldap-servers"--></TITLE>
15374 </HEAD>
15375 <BODY>
15376 <H1>LDAP OPTION: <!--#echo var="VAR_ldap-servers"--></H1>
15377 This is the name of the host where an LDAP server is running.
15378 For redundancy, this may be a space-delimited set of server names, in which
15379 case the first server that answers is used.
15380 Each of the server names may be optionally followed by
15381 a colon and a port number.
15382 If this form is used then the port number configured below in the
15383 <EM>port</EM> field is not used.
15384 <P>
15385 To find out whether your organization has its own LDAP server,
15386 contact its computing support staff.
15387 <P><UL>
15388 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
15389 </UL>
15390 <P>
15391 &lt;End of help on this topic&gt;
15392 </BODY>
15393 </HTML>
15394 ======= h_config_ldap_base =======
15395 <HTML>
15396 <HEAD>
15397 <TITLE>LDAP OPTION: Search-Base</TITLE>
15398 </HEAD>
15399 <BODY>
15400 <H1>LDAP OPTION: Search-Base</H1>
15401
15402 This is the search base to be used on this server.  It functions as a filter
15403 by restricting your searches in the LDAP server database
15404 to the specified contents of the specified fields.  Without it, searches
15405 submitted to this directory server may fail.  It might be something
15406 like:
15407
15408 <PRE>
15409       O = &lt;Your Organization Name&gt;, C = US
15410 </PRE>
15411 or it might be blank.
15412 (Some LDAP servers actually ignore anything specified here.)
15413 <P>
15414 If in doubt what parameters you should specify here,
15415 contact the maintainers of the LDAP server.
15416 <P><UL>
15417 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
15418 </UL>
15419 <P>
15420 &lt;End of help on this topic&gt;
15421 </BODY>
15422 </HTML>
15423 ======= h_config_ldap_port =======
15424 <HTML>
15425 <HEAD>
15426 <TITLE>LDAP OPTION: Port</TITLE>
15427 </HEAD>
15428 <BODY>
15429 <H1>LDAP OPTION: Port</H1>
15430
15431 This is the TCP port number to be used with this LDAP server. If you leave
15432 this blank port 389 will be used.
15433 <P>
15434 &lt;End of help on this topic&gt;
15435 </BODY>
15436 </HTML>
15437 ======= h_config_ldap_nick =======
15438 <HTML>
15439 <HEAD>
15440 <TITLE>LDAP OPTION: Nickname</TITLE>
15441 </HEAD>
15442 <BODY>
15443 <H1>LDAP OPTION: Nickname</H1>
15444
15445 This is a nickname to be used in displays. If you don't supply a
15446 nickname the server name
15447 (<A HREF="h_config_ldap_server">&quot;<!--#echo var="VAR_ldap-servers"-->&quot;</A>)
15448 will be used instead.  This option is strictly for your convenience.
15449 <P>
15450 &lt;End of help on this topic&gt;
15451 </BODY>
15452 </HTML>
15453 ======= h_config_ldap_binddn =======
15454 <HTML>
15455 <HEAD>
15456 <TITLE>LDAP OPTION: Bind-DN</TITLE>
15457 </HEAD>
15458 <BODY>
15459 <H1>LDAP OPTION: Bind-DN</H1>
15460
15461 You may need to authenticate to the LDAP server before you are able to use it.
15462 This is the Distinguished Name to bind to when authenticating to this server.
15463 Try leaving this blank until you know you need it.
15464 <P>
15465 Alpine only knows about LDAP Simple authentication.
15466 It does not attempt LDAP SASL authentication.
15467 The DN and password will be sent in the clear unless TLS encryption is
15468 being used on this connection.
15469 Because of this, you may want to set the LDAP feature
15470 <A HREF="h_config_ldap_opts_tls">&quot;Attempt-TLS-On-Connection&quot;</A>
15471 or the feature
15472 <A HREF="h_config_ldap_opts_tlsmust">&quot;Require-TLS-On-Connection&quot;</A>
15473 if you are going to be providing a password.
15474 <P><UL>
15475 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
15476 </UL>
15477 <P>
15478 &lt;End of help on this topic&gt;
15479 </BODY>
15480 </HTML>
15481 ======= h_config_ldap_opts_impl =======
15482 <HTML>
15483 <HEAD>
15484 <TITLE>LDAP FEATURE: Use-Implicitly-From-Composer</TITLE>
15485 </HEAD>
15486 <BODY>
15487 <H1>LDAP FEATURE: Use-Implicitly-From-Composer</H1>
15488
15489 Set this to have lookups done to this server implicitly from the composer.
15490 If an address doesn't look like a fully-qualified address, it will be looked
15491 up in your address books, and if it doesn't match a nickname there, then it
15492 will be looked up on the LDAP servers that have this feature set.
15493 The lookups will also be done when using the address completion feature
15494 (TAB command) in the composer if any of the serves have this feature set.
15495 Also see the LDAP feature
15496 <A HREF="h_config_ldap_opts_rhs">&quot;Lookup-Addrbook-Contents&quot;</A>
15497 and the Setup/Config feature
15498 <A HREF="h_config_add_ldap">&quot;<!--#echo var="FEAT_ldap-result-to-addrbook-add"-->&quot;</A>.
15499 <P>
15500 &lt;End of help on this topic&gt;
15501 </BODY>
15502 </HTML>
15503 ======= h_config_ldap_opts_tls =======
15504 <HTML>
15505 <HEAD>
15506 <TITLE>LDAP FEATURE: Attempt-TLS-On-Connection</TITLE>
15507 </HEAD>
15508 <BODY>
15509 <H1>LDAP FEATURE: Attempt-TLS-On-Connection</H1>
15510
15511 When connecting to this server Alpine will attempt to use TLS encryption
15512 on the connection.
15513 Also see the closely related feature
15514 <A HREF="h_config_ldap_opts_tlsmust">&quot;Require-TLS-On-Connection&quot;</A>
15515 <P>
15516 Note that if this option is set, then
15517 <A HREF="h_config_ldap_opts_ldaps">
15518 &quot;Require-LDAPS-On-Connection&quot;</A>
15519 can not be enabled for this server. You must disable this feature in
15520 order to use
15521 <A HREF="h_config_ldap_opts_ldaps">
15522 &quot;Require-LDAPS-On-Connection&quot;</A>
15523 <P>
15524 &lt;End of help on this topic&gt;
15525 </BODY>
15526 </HTML>
15527 ======= h_config_ldap_opts_tlsmust =======
15528 <HTML>
15529 <HEAD>
15530 <TITLE>LDAP FEATURE: Require-TLS-On-Connection</TITLE>
15531 </HEAD>
15532 <BODY>
15533 <H1>LDAP FEATURE: Require-TLS-On-Connection</H1>
15534
15535 When connecting to this server Alpine will attempt to use TLS encryption
15536 on the connection.
15537 If the StartTLS operation fails then the connection will not be used.
15538 <P>
15539 Note that if this option is set, then
15540 <A HREF="h_config_ldap_opts_ldaps">
15541 &quot;Require-LDAPS-On-Connection&quot;</A>
15542 can not be enabled for this server. You must disable this feature in
15543 order to use
15544 <A HREF="h_config_ldap_opts_ldaps">
15545 &quot;Require-LDAPS-On-Connection&quot;</A>
15546 <P>
15547 &lt;End of help on this topic&gt;
15548 </BODY>
15549 </HTML>
15550 ======= h_config_ldap_opts_ldaps =======
15551 <HTML>
15552 <HEAD>
15553 <TITLE>LDAP FEATURE: Require-LDAPS-On-Connection</TITLE>
15554 </HEAD>
15555 <BODY>
15556 <H1>LDAP FEATURE: Require-LDAPS-On-Connection</H1>
15557
15558 When connecting to this server Alpine will use LDAPS (LDAP over SSL/TLS)
15559 on the connection.
15560 <P>
15561 This feature can not be used along with
15562 <A HREF="h_config_ldap_opts_tlsmust">&quot;Require-TLS-On-Connection&quot;</A>
15563  or
15564 <A HREF="h_config_ldap_opts_tls">&quot;Attempt-TLS-On-Connection&quot;</A>.
15565 If you want to connect using StartTLS to this server, you must disable
15566 this feature first.
15567 <P>
15568 &lt;End of help on this topic&gt;
15569 </BODY>
15570 </HTML>
15571 ====== h_config_ldap_opts_rhs =====
15572 <HTML>
15573 <HEAD>
15574 <TITLE>LDAP FEATURE: Lookup-Addrbook-Contents</TITLE>
15575 </HEAD>
15576 <BODY>
15577 <H1>LDAP FEATURE: Lookup-Addrbook-Contents</H1>
15578
15579 Normally implicit LDAP lookups from the composer are done only for the
15580 strings you type in from the composer screen. In other words, you type in
15581 something in the To or CC field and press return, then the string is looked up.
15582 First that string is looked up in your address books. If a match is found
15583 there, then the results of that match are looked up again. If you place
15584 a string in your address book that you want to have looked up on the LDAP
15585 directory server, you need to turn on this feature. If you set this feature
15586 for a server, you almost always will also want to set the
15587 <A HREF="h_config_ldap_opts_impl">&quot;Use-Implicitly-From-Composer&quot;</A>
15588 feature. An example might serve to best illustrate this feature.
15589 <P>
15590 If an LDAP lookup of &quot;William Clinton&quot; normally returns an
15591 entry with an
15592 address of pres@whitehouse.gov, then you might put an entry in your address
15593 book that looks like:
15594 <P>
15595 <CENTER><SAMP>Nickname = bill</SAMP></CENTER><BR>
15596 <CENTER><SAMP>Address = &quot;William Clinton&quot;</SAMP></CENTER>
15597 <P>
15598 Now, when you type &quot;bill&quot; into an
15599 address field in the composer Alpine will
15600 find the &quot;bill&quot; entry in your address book.
15601 It will replace &quot;bill&quot; with
15602 &quot;William Clinton&quot;.
15603 It will then search for an entry with that nickname
15604 in your address book and not find one. If this feature
15605 is set, Alpine will then attempt to lookup
15606 &quot;William Clinton&quot; on the LDAP server and find the entry with address
15607 pres@whitehouse.gov.
15608 <P>
15609 A better way to accomplish the same thing is probably to use the feature
15610 <A HREF="h_config_ldap_opts_ref">&quot;Save-Search-Criteria-Not-Result&quot;</A>.
15611 <P>
15612 &lt;End of help on this topic&gt;
15613 </BODY>
15614 </HTML>
15615 ====== h_config_ldap_opts_ref =====
15616 <HTML>
15617 <HEAD>
15618 <TITLE>LDAP FEATURE: Save-Search-Criteria-Not-Result</TITLE>
15619 </HEAD>
15620 <BODY>
15621 <H1>LDAP FEATURE: Save-Search-Criteria-Not-Result</H1>
15622
15623 Normally when you save the results of an LDAP directory lookup to your
15624 address book the results of the lookup are saved. If this feature is set
15625 and the entry being saved was found on this directory server, then the
15626 search criteria is saved instead of the results of the search. When this
15627 address book entry is used in the future, instead of copying the results
15628 from the address book the directory lookup will be done again. This could
15629 be useful if the copied result might become stale because the data on
15630 the directory server changes (for example, the entry's email address changes).
15631 You probably don't want to set this feature if the server is at all slow or
15632 unreliable.
15633 <P>
15634 The way this actually works is that instead of saving the email address
15635 in your address book, Alpine saves enough information to look up the same
15636 directory entry again. In particular, it saves the server name and the
15637 distinguished name of the entry. It's possible that the server administrators
15638 might change the format of distinguished names on the server, or that the
15639 entry might be removed from the server. If Alpine notices this, you will be warned
15640 and a backup copy of the email address will be used. You may want to create
15641 a new entry in this case, since you will get the annoying warning every
15642 time you use the old entry. You may do that by Saving the entry to a new
15643 nickname in the same address book. You will be asked whether or not you
15644 want to use the backup email address.
15645 <P>
15646 A related feature in the Setup/Config screen is
15647 <A HREF="h_config_add_ldap">&quot;<!--#echo var="FEAT_ldap-result-to-addrbook-add"-->&quot;</A>.
15648 <P>
15649 &lt;End of help on this topic&gt;
15650 </BODY>
15651 </HTML>
15652 ======= h_config_ldap_opts_nosub =======
15653 <HTML>
15654 <HEAD>
15655 <TITLE>LDAP FEATURE: Disable-Ad-Hoc-Space-Substitution</TITLE>
15656 </HEAD>
15657 <BODY>
15658 <H1>LDAP FEATURE: Disable-Ad-Hoc-Space-Substitution</H1>
15659
15660 Spaces in your input are normally handled specially.
15661 Each space character is replaced
15662 by
15663 <P>
15664 <CENTER><SAMP>*&nbsp;&lt;SPACE&gt;</SAMP></CENTER>
15665 <P>
15666 in the search query (but not by &quot;* &lt;SPACE&gt; *&quot;).
15667 The reason this is done is so the input string
15668 <P>
15669 <CENTER><SAMP>Greg Donald</SAMP></CENTER>
15670 <P>
15671 (which is converted to &quot;Greg* Donald&quot;) will match
15672 the names &quot;Greg Donald&quot;,
15673 &quot;Gregory Donald&quot;, &quot;Greg F. Donald&quot;, and
15674 &quot;Gregory F Donald&quot;; but it won't match &quot;Greg McDonald&quot;.
15675 If the &quot;Search-Rule&quot; you were using was &quot;begins-with&quot;,
15676 then it would also match the name &quot;Greg Donaldson&quot;.
15677 <P>
15678 Turning on this feature will disable this substitution.
15679 <P>
15680 &lt;End of help on this topic&gt;
15681 </BODY>
15682 </HTML>
15683 ====== h_config_ldap_searchtypes =======
15684 <HTML>
15685 <HEAD>
15686 <TITLE>LDAP OPTION: Search-Type</TITLE>
15687 </HEAD>
15688 <BODY>
15689 <H1>LDAP OPTION: Search-Type</H1>
15690
15691 This affects the way that LDAP searches are done.
15692 In particular, this tells the server where to look for the string to be matched.
15693 If set to &quot;name&quot; then the string that is being searched for will
15694 be compared with the string in the
15695 &quot;Name&quot; field on the server
15696 (technically, it is the &quot;commonname&quot; field on the server).
15697 &quot;Surname&quot; means we're looking for a
15698 match in the &quot;Surname&quot; field on the
15699 server (actually the &quot;sn&quot; field).
15700 &quot;Givenname&quot; really is &quot;givenname&quot;
15701 and &quot;email&quot; is the electronic mail address (this is actually the field
15702 called &quot;mail&quot; or &quot;electronicmail&quot; on the server).
15703 The other three types are combinations of
15704 the types listed so far. &quot;Name-or-email&quot;
15705 means the string should appear
15706 in either the &quot;name&quot; field OR the &quot;email&quot; field.
15707 Likewise, &quot;surname-or-givenname&quot;
15708 means &quot;surname&quot; OR &quot;givenname&quot;
15709 and &quot;sur-or-given-or-name-or-email&quot; means the obvious thing.
15710 <P>
15711 This search TYPE is combined with the
15712 search <A HREF="h_config_ldap_searchrules">RULE</A>
15713 to form the actual search query.
15714 <P>
15715 The usual default value for this
15716 option is &quot;sur-or-given-or-name-or-email&quot;.
15717 This type of search may be slow on some servers.
15718 Try &quot;name-or-email&quot;, which is often
15719 faster, or just &quot;name&quot; if the performance seems to be a problem.
15720 <P>
15721 Some servers have been configured with different attribute names for
15722 these four fields.
15723 In other words, instead of using the attribute name &quot;mail&quot;
15724 for the email address field, the server might be configured to use something
15725 else, for example, &quot;rfc822mail&quot; or &quot;internetemailaddress&quot;.
15726 Alpine can be configured to use these different attribute names by using
15727 the four configuration options:
15728 <P><UL>
15729 <LI><A HREF="h_config_ldap_email_attr">&quot;EmailAttribute&quot;</A>
15730 </UL>
15731 <P><UL>
15732 <LI><A HREF="h_config_ldap_cn_attr">&quot;NameAttribute&quot;</A>
15733 </UL>
15734 <P><UL>
15735 <LI><A HREF="h_config_ldap_sn_attr">&quot;SurnameAttribute&quot;</A>
15736 </UL>
15737 <P><UL>
15738 <LI><A HREF="h_config_ldap_gn_attr">&quot;GivennameAttribute&quot;</A>
15739 </UL>
15740 <P>
15741 &lt;End of help on this topic&gt;
15742 </BODY>
15743 </HTML>
15744 ====== h_config_ldap_searchrules =======
15745 <HTML>
15746 <HEAD>
15747 <TITLE>LDAP OPTION: Search-Rule</TITLE>
15748 </HEAD>
15749 <BODY>
15750 <H1>LDAP OPTION: Search-Rule</H1>
15751
15752 This affects the way that LDAP searches are done.
15753 If set to &quot;equals&quot; then
15754 only exact matches count.
15755 &quot;Contains&quot; means that the string you type in
15756 is a substring of what you are matching against.
15757 &quot;Begins-with&quot; and &quot;ends-with&quot;
15758 mean that the string starts or ends with the string you type in.
15759 <P>
15760 Spaces in your input are normally handled specially, but you can turn that
15761 special handling off with the
15762 <A HREF="h_config_ldap_opts_nosub">&quot;Disable-Ad-Hoc-Space-Substitution&quot;</A>
15763 feature.
15764 <P>
15765 The usual default value for this option is &quot;begins-with&quot;.
15766 <P>
15767 &lt;End of help on this topic&gt;
15768 </BODY>
15769 </HTML>
15770 ======= h_config_ldap_email_attr =======
15771 <HTML>
15772 <HEAD>
15773 <TITLE>LDAP OPTION: EmailAttribute</TITLE>
15774 </HEAD>
15775 <BODY>
15776 <H1>LDAP OPTION: EmailAttribute</H1>
15777
15778 This is the name of the attribute that is searched for when looking for
15779 an email address. The default value for this option is &quot;mail&quot; or
15780 &quot;electronicmail&quot;.
15781 If the server you are using uses a different attribute name for the email
15782 address, put that attribute name here.
15783 <P>
15784 This will affect the search filter used if your Search-Type is one that
15785 contains a search for &quot;email&quot;.
15786 It will also cause the attribute value matching this attribute name to be used
15787 as the email address when you look up an entry from the composer.
15788 <P>
15789 &lt;End of help on this topic&gt;
15790 </BODY>
15791 </HTML>
15792 ======= h_config_ldap_sn_attr =======
15793 <HTML>
15794 <HEAD>
15795 <TITLE>LDAP OPTION: SurnameAttribute</TITLE>
15796 </HEAD>
15797 <BODY>
15798 <H1>LDAP OPTION: SurnameAttribute</H1>
15799
15800 This is the name of the attribute that is searched for when looking for
15801 the surname of the entry. The default value for this option is &quot;sn&quot;.
15802 If the server you are using uses a different attribute name for the surname,
15803 put that attribute name here.
15804 This will affect the search filter used if your Search-Type is one that
15805 contains a search for &quot;surname&quot;.
15806 <P>
15807 &lt;End of help on this topic&gt;
15808 </BODY>
15809 </HTML>
15810 ======= h_config_ldap_gn_attr =======
15811 <HTML>
15812 <HEAD>
15813 <TITLE>LDAP OPTION: GivennameAttribute</TITLE>
15814 </HEAD>
15815 <BODY>
15816 <H1>LDAP OPTION: GivennameAttribute</H1>
15817
15818 This is the name of the attribute that is searched for when looking for
15819 the given name of the entry. The default value for this option is &quot;givenname&quot;.
15820 If the server you are using uses a different attribute name for the given name,
15821 put that attribute name here.
15822 This will affect the search filter used if your Search-Type is one that
15823 contains a search for &quot;givenname&quot;.
15824 <P>
15825 &lt;End of help on this topic&gt;
15826 </BODY>
15827 </HTML>
15828 ======= h_config_ldap_cn_attr =======
15829 <HTML>
15830 <HEAD>
15831 <TITLE>LDAP OPTION: NameAttribute</TITLE>
15832 </HEAD>
15833 <BODY>
15834 <H1>LDAP OPTION: NameAttribute</H1>
15835
15836 This is the name of the attribute that is searched for when looking for
15837 the name of the entry. The default value for this option is &quot;cn&quot;, which
15838 stands for common name.
15839 If the server you are using uses a different attribute name for the name,
15840 put that attribute name here.
15841 This will affect the search filter used if your Search-Type is one that
15842 contains a search for &quot;name&quot;.
15843 <P>
15844 &lt;End of help on this topic&gt;
15845 </BODY>
15846 </HTML>
15847 ======= h_config_ldap_time =======
15848 <HTML>
15849 <HEAD>
15850 <TITLE>LDAP OPTION: Timelimit</TITLE>
15851 </HEAD>
15852 <BODY>
15853 <H1>LDAP OPTION: Timelimit</H1>
15854
15855 This places a limit on the number of seconds the LDAP search will continue.
15856 The default is 30 seconds. A value of 0 means no limit. Note that some servers
15857 may place limits of their own on searches.
15858 <P>
15859 &lt;End of help on this topic&gt;
15860 </BODY>
15861 </HTML>
15862 ======= h_config_ldap_size =======
15863 <HTML>
15864 <HEAD>
15865 <TITLE>LDAP OPTION: Sizelimit</TITLE>
15866 </HEAD>
15867 <BODY>
15868 <H1>LDAP OPTION: Sizelimit</H1>
15869
15870 This places a limit on the number of entries returned by the LDAP server.
15871 A value of 0 means no limit. The default is 0. Note that some servers
15872 may place limits of their own on searches.
15873 <P>
15874 &lt;End of help on this topic&gt;
15875 </BODY>
15876 </HTML>
15877 ======= h_config_ldap_cust =======
15878 <HTML>
15879 <HEAD>
15880 <TITLE>LDAP OPTION: Custom-Search-Filter</TITLE>
15881 </HEAD>
15882 <BODY>
15883 <H1>LDAP OPTION: Custom-Search-Filter</H1>
15884
15885 This one is for advanced users only! If you define this, then the
15886 &quot;Search-Type&quot; and &quot;Search-Rule&quot; defined are both ignored.
15887 However, the feature
15888 <A HREF="h_config_ldap_opts_nosub">&quot;Disable-Ad-Hoc-Space-Substitution&quot;</A>
15889 is still in effect.
15890 That is, the space substitution will take place even in a custom filter unless
15891 you disable it.
15892 <P>
15893 If your LDAP service stops working and you suspect it might be because
15894 of your custom filter, just delete this filter and try using the
15895 &quot;Search-Type&quot; and &quot;Search-Rule&quot; instead.
15896 Another option that sometimes causes trouble is the
15897 <A HREF="h_config_ldap_base">&quot;Search-Base&quot;</A> option.
15898 <P>
15899 This variable may be set to the string representation of an LDAP search
15900 filter (see RFC1960). In the places where you want the address string to be
15901 substituted in, put a '%s' in this filter string. Here are some examples:
15902 <P>
15903 A &quot;Search-Type&quot; of &quot;name&quot; with &quot;Search-Rule&quot; of &quot;begins-with&quot;
15904 is equivalent to the &quot;Custom-Search-Filter&quot;
15905 <PRE>
15906      (cn=%s*)
15907 </PRE>
15908 When you try to match against the string &quot;string&quot; the program replaces
15909 the &quot;%s&quot; with &quot;string&quot; (without the quotes). You may have multiple &quot;%s&quot;'s and
15910 they will all be replaced with the string. There is a limit of 10 &quot;%s&quot;'s.
15911 <P>
15912 A &quot;Search-Type&quot; of &quot;name-or-email&quot; with &quot;Search-Rule&quot;
15913 of &quot;contains&quot; is equivalent to
15914 <PRE>
15915      (|(cn=*%s*)(mail=*%s*))
15916 </PRE>
15917 <P>
15918 If your server uses a different attribute <EM>name</EM> than
15919 Alpine uses by default,
15920 (for example, it uses &quot;rfc822mail&quot; instead of &quot;mail&quot;),
15921 then you may be able to use one or more of the four attribute configuration
15922 options instead of defining a custom filter:
15923 <P><UL>
15924 <LI><A HREF="h_config_ldap_email_attr">&quot;EmailAttribute&quot;</A>
15925 </UL>
15926 <P><UL>
15927 <LI><A HREF="h_config_ldap_cn_attr">&quot;NameAttribute&quot;</A>
15928 </UL>
15929 <P><UL>
15930 <LI><A HREF="h_config_ldap_sn_attr">&quot;SurnameAttribute&quot;</A>
15931 </UL>
15932 <P><UL>
15933 <LI><A HREF="h_config_ldap_gn_attr">&quot;GivennameAttribute&quot;</A>
15934 </UL>
15935 <P>
15936 &lt;End of help on this topic&gt;
15937 </BODY>
15938 </HTML>
15939 ======= h_composer_abook_comment =======
15940 <HTML>
15941 <HEAD>
15942 <TITLE>Addressbook Comment Explained</TITLE>
15943 </HEAD>
15944 <BODY>
15945 This is a comment to help you remember what this entry is. The WhereIs
15946 command searches comments so that it is easier to find an entry with a comment
15947 you know about attached to it. This field is not used in the outgoing message.
15948 <P>
15949 Look <A HREF="h_edit_nav_cmds">here</A>
15950 to see the available Editing and Navigation commands.
15951 <P>
15952 &lt;End of help on this topic&gt;
15953 </BODY>
15954 </HTML>
15955 ======= h_composer_abook_addrs =======
15956 <HTML>
15957 <HEAD>
15958 <TITLE>Addressbook Lists</TITLE>
15959 </HEAD>
15960 <BODY>
15961 <H1>Addressbook Lists</H1>
15962
15963 This is a list of addresses to send to when sending to this address book
15964 entry.  Each member of the list may be an address or another nickname from
15965 any of your address books.  If it is an address, it is OK to include the
15966 full name field as well as the electronic address portion of that address.
15967 For example, the following are all legitimate entries in this field:
15968
15969 <DL><DT>&nbsp;</DT>
15970 <DD>john&nbsp;&nbsp;&nbsp;&nbsp;(a nickname in your address book)
15971 <DD>jdoe@some.domain
15972 <DD>John Doe &lt;jdoe@some.domain&gt;
15973 </DL>
15974
15975 The addresses should be listed separated by commas, just like you would
15976 enter them from the composer.
15977
15978 <P>
15979
15980 The only difference between a distribution list and a simple entry with a
15981 single address, is that a distribution list has more than one address
15982 listed in the Addresses: field, whereas a simple personal entry has just
15983 one address.
15984
15985 <P>
15986
15987 For individual address book entries, if there is a full name in the
15988 Fullname: field (filling in the Fullname: field is not required), it is
15989 used.  If the full name is specified in the Address: field and not in the
15990 Fullname: field, then the full name from the Address: field is used.
15991
15992 <P>
15993
15994 If you type the nickname of a distribution list from one of your address
15995 books in the Lcc: field, then the full name of that list is used in the
15996 To: field.  If you put a list in the To: or Cc: fields, that list will be
15997 expanded into all of its addresses.  If the list has a full name, then
15998 that will appear at the beginning of the addresses.
15999
16000 <DL><DT>&nbsp;</DT>
16001 <DD>Sewing Club &lt;john@somewhere&gt;, nancy@something.else, Sal
16002 &lt;sal@here.there&gt;
16003 </DL>
16004
16005 If the first address in the distribution list also has a full name, then
16006 the list full name and that full name are combined into something like the
16007 following:
16008
16009 <DL><DT>&nbsp;</DT>
16010 <DD>Sewing Club -- John Smith &lt;john@somewhere&gt;
16011 </DL>
16012
16013
16014 If you specify a list via Lcc, the full name is used in the To: line.  If
16015 you specify a list in the To: or Cc: fields, then it uses the same method
16016 as for individual entries for filling in the full name.
16017
16018 <P>
16019
16020 For help with editing and navigation commands, check the Help for the
16021 Nickname: field.
16022
16023 <P>
16024 &lt;End of help on this topic&gt;
16025 </BODY>
16026 </HTML>
16027 ======= h_config_xoauth2_client_id =======
16028 <HTML>
16029 <HEAD>
16030 <TITLE>Client-Id Explained</TITLE>
16031 </HEAD>
16032 <BODY>
16033 <H1>Client-Id Explained</H1>
16034
16035 If you have registered Alpine with your service provider to use the XOAUTH2 authenticator, or
16036 someone has shared a client-id and client-secret with you, use this field to input the
16037 client-id.
16038 <P>
16039 The Client-Id field is a string that your provider generates for the program
16040 being registered. However, some providers allow different users to register
16041 the same program. Users of the Mutt email program already do this to use
16042 XOAUTH2 authentication in Gmail.
16043
16044 <P>
16045 &lt;End of help on this topic&gt;
16046 </BODY>
16047 </HTML>
16048 ======= h_config_xoauth2_client_secret =======
16049 <HTML>
16050 <HEAD>
16051 <TITLE>Client-Secret Explained</TITLE>
16052 </HEAD>
16053 <BODY>
16054 <H1>Client-Secret Explained</H1>
16055
16056 If you have registered Alpine with your service provider to use the XOAUTH2 authenticator, or
16057 someone has shared a client-id and client-secret with you, use this field to input the
16058 client-secret. Some servers require both a client-id and a client-secret, some other servers do
16059 not require a client-secret. If a client-secret is required, use this field to add one.
16060
16061 <P> The client-secret field is supposed to be kept secret, that is, not
16062 shared with any of the users, but due to the open source nature of Alpine,
16063 it is not possible to keep it secret in any meaningful way. The intention
16064 of this field is so that only the coders of an app can use the codes given
16065 to them and authenticate their users to the services they are requesting.
16066 This means that other coders would not be able to impresonate that app,
16067 and use it to steal data from those users. In the case of Alpine this is
16068 not possible, as Alpine does not steal data from its users, so users are safe
16069 sharing client-secrets. Just make sure you obtain your copy of Alpine from
16070 a reputable provider or compile the source code by yourself. The official
16071 source code of this project is located at
16072
16073 <P><CENTER><A HREF="http://repo.or.cz/alpine.git">http://repo.or.cz/alpine.git</A>.</CENTER>
16074
16075 <P>
16076 &lt;End of help on this topic&gt;
16077 </BODY>
16078 </HTML>
16079 ======= h_config_role_nick =======
16080 <HTML>
16081 <HEAD>
16082 <TITLE>Nickname Explained</TITLE>
16083 </HEAD>
16084 <BODY>
16085 <H1>Nickname Explained</H1>
16086
16087 This is a nickname to help you.
16088 You should have a different nickname for each role you define.
16089 The nickname will be used in the SETUP ROLE RULES screen to allow you to
16090 pick a role to edit.
16091 It will also be used when you send a message to let you know you are
16092 sending with a different role than you use by default, and
16093 it will be useful for choosing a role when composing with the Role command
16094 or when composing with one of the Role Uses set to With Confirmation.
16095 This field is not used in the outgoing message.
16096 <P>
16097 Look <A HREF="h_edit_nav_cmds">here</A>
16098 to see the available Editing and Navigation commands.
16099 <P>
16100 &lt;End of help on this topic&gt;
16101 </BODY>
16102 </HTML>
16103 ======= h_config_role_comment =======
16104 <HTML>
16105 <HEAD>
16106 <TITLE>Comment Explained</TITLE>
16107 </HEAD>
16108 <BODY>
16109 <H1>Comment Explained</H1>
16110
16111 This is a comment to help you.
16112 This comment does not play any functional role, it is simply an optional
16113 comment to help you remember what the rule is for.
16114 <P>
16115 Look <A HREF="h_edit_nav_cmds">here</A>
16116 to see the available Editing and Navigation commands.
16117 <P>
16118 &lt;End of help on this topic&gt;
16119 </BODY>
16120 </HTML>
16121 ======= h_config_other_nick =======
16122 <HTML>
16123 <HEAD>
16124 <TITLE>Nickname Explained</TITLE>
16125 </HEAD>
16126 <BODY>
16127 <H1>Nickname Explained</H1>
16128
16129 This is a nickname to help you.
16130 You should have a different nickname for each rule you define.
16131 The nickname will be used in the SETUP OTHER RULES screen to allow you to
16132 pick a rule to edit.
16133 <P>
16134 Look <A HREF="h_edit_nav_cmds">here</A>
16135 to see the available Editing and Navigation commands.
16136 <P>
16137 &lt;End of help on this topic&gt;
16138 </BODY>
16139 </HTML>
16140 ======= h_config_score_nick =======
16141 <HTML>
16142 <HEAD>
16143 <TITLE>Nickname Explained</TITLE>
16144 </HEAD>
16145 <BODY>
16146 <H1>Nickname Explained</H1>
16147
16148 This is a nickname to help you.
16149 You should have a different nickname for each scoring rule you define.
16150 The nickname will be used in the SETUP SCORING RULES screen to allow you to
16151 pick a rule to edit.
16152 <P>
16153 Look <A HREF="h_edit_nav_cmds">here</A>
16154 to see the available Editing and Navigation commands.
16155 <P>
16156 &lt;End of help on this topic&gt;
16157 </BODY>
16158 </HTML>
16159 ======= h_config_incol_nick =======
16160 <HTML>
16161 <HEAD>
16162 <TITLE>Nickname Explained</TITLE>
16163 </HEAD>
16164 <BODY>
16165 <H1>Nickname Explained</H1>
16166
16167 This is a nickname to help you.
16168 You should have a different nickname for each color rule you define.
16169 The nickname will be used in the SETUP INDEX COLOR RULES screen to allow you to
16170 pick a rule to edit.
16171 <P>
16172 Look <A HREF="h_edit_nav_cmds">here</A>
16173 to see the available Editing and Navigation commands.
16174 <P>
16175 &lt;End of help on this topic&gt;
16176 </BODY>
16177 </HTML>
16178 ======= h_config_filt_nick =======
16179 <HTML>
16180 <HEAD>
16181 <TITLE>Nickname Explained</TITLE>
16182 </HEAD>
16183 <BODY>
16184 <H1>Nickname Explained</H1>
16185
16186 This is a nickname to help you.
16187 You should have a different nickname for each filtering rule you define.
16188 The nickname will be used in the SETUP FILTERING RULES screen to allow you to
16189 pick a rule to edit.
16190 <P>
16191 Look <A HREF="h_edit_nav_cmds">here</A>
16192 to see the available Editing and Navigation commands.
16193 <P>
16194 &lt;End of help on this topic&gt;
16195 </BODY>
16196 </HTML>
16197 ======= h_config_score_topat =======
16198 <HTML>
16199 <HEAD>
16200 <TITLE>&quot;To:&quot; Pattern Explained</TITLE>
16201 </HEAD>
16202 <BODY>
16203 <H1>&quot;To:&quot; Pattern Explained</H1>
16204
16205 Any text you enter as the &quot;To pattern&quot;
16206 will be compared to the recipients from the To: line of
16207 the message being scored.
16208 When the text you entered matches
16209 all or part of the To: line of a message, then the Score Value
16210 you have specified will be added to the score for the message.
16211 (Any other non-blank parts of the Pattern must match, too.)
16212 <P>
16213
16214 You may enter a complete email address, part of an address, or a
16215 list of addresses or partial addresses.
16216 For example:
16217 <P>
16218
16219 <PRE>
16220  To pattern = friend@public.com
16221
16222  To pattern = rated.net
16223
16224  To pattern = xxx@adults.com
16225               admin@msn.com
16226               fool@motleyfool.com
16227 </PRE>
16228
16229 <P>
16230 Each of those are valid To patterns.
16231 <P>
16232
16233 Messages match those patterns if any of the
16234 addresses in the To: line of the message contains the pattern.
16235 If the pattern is a list of patterns
16236 (like the last example above) then it is a match if any of the patterns in
16237 the list match any of the addresses in the To: line.
16238 (It is not possible to specify two addresses that must <EM>BOTH</EM> be
16239 present for a match.
16240 It is only possible to specify that <EM>EITHER</EM> address1 <EM>OR</EM>
16241 address2 must be present.
16242 That is exactly what using a list does.)
16243 <P>
16244
16245 Some messages may be &quot;bounced&quot; to you, and will
16246 have a &quot;Resent-To:&quot; header line.
16247 If the message contains a Resent-To: line
16248 and the feature <A HREF="h_config_use_resentto"><!--#echo var="FEAT_use-resent-to-in-rules"--></A> is turned on,
16249 Alpine will look for
16250 matches to your &quot;To patterns&quot; there, and <EM>NOT</EM> in
16251 the original To: line.
16252 <P>
16253
16254 When entering a pattern, you may choose an address from your address book
16255 with the &quot;T&quot; command.
16256 <P>
16257
16258 It is possible to add a <EM>NOT</EM> to the To Pattern meaning with the
16259 &quot;!&quot; &quot;toggle NOT&quot; command.
16260 This changes the meaning of the To pattern so that it has the opposite meaning.
16261 It will be considered a match if there are no matches between the
16262 addresses in the To: line and the list of To patterns.
16263 <P>
16264 Don't make the mistake of putting the &quot;!&quot; in the data field for
16265 the pattern.
16266 For example, if you type the characters &quot;!frizzle&quot; into the To
16267 pattern, the pattern will look like:
16268 <P>
16269 <PRE>
16270  To pattern = !frizzle
16271 </PRE>
16272 <P>
16273 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
16274 In order to match messages that do not have &quot;frizzle&quot; in
16275 their To field, first type the characters &quot;frizzle&quot; followed
16276 by carriage return for the value of the To pattern, then negate it
16277 by typing the &quot;!&quot; command.
16278 It should end up looking like
16279 <P>
16280 <PRE>
16281  ! To pattern = frizzle
16282 </PRE>
16283 <P>
16284 You are not limited to using the six standard header patterns that are
16285 normally shown (To, From, Sender, Cc, News, and Subject).
16286 You may add any other header to a Pattern by
16287 using the &quot;eXtraHdr&quot; command to specify a different
16288 message header line; and then the Add or Change command to fill in
16289 a pattern for the new header line, just like you would for a standard header.
16290 <P>
16291 A technicality: Since comma is the character used to separate multiple
16292 values in a pattern field, you have to escape comma with a backslash (&#92;) if
16293 you want to include a literal comma in the field.
16294 In other words, if you type a backslash followed by a comma it will
16295 be interpreted as a comma by Alpine, instead of as a separator between
16296 pattern values.
16297 All other backslashes are literal backslashes and should not be escaped.
16298 <P>
16299 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16300 for more information on Patterns.
16301 <P>
16302 Look <A HREF="h_edit_nav_cmds">here</A>
16303 to see the available Editing and Navigation commands.
16304 <P>
16305 &lt;End of help on this topic&gt;
16306 </BODY>
16307 </HTML>
16308 ======= h_config_incol_topat =======
16309 <HTML>
16310 <HEAD>
16311 <TITLE>&quot;To:&quot; Pattern Explained</TITLE>
16312 </HEAD>
16313 <BODY>
16314 <H1>&quot;To:&quot; Pattern Explained</H1>
16315
16316 Any text you enter as the &quot;To pattern&quot;
16317 will be compared to the recipients from the To: lines of
16318 the messages in the index.
16319 When the text you entered matches
16320 all or part of the To: line of a message, then the Index Line Color you have
16321 specified will be used for that line in the index.
16322 (Any other non-blank parts of the Pattern must match, too.)
16323 <P>
16324
16325 You may enter a complete email address, part of an address, or a
16326 list of addresses or partial addresses.
16327 For example:
16328 <P>
16329
16330 <PRE>
16331  To pattern = friend@public.com
16332  To pattern = rated.net
16333  To pattern = xxx@adults.com
16334               admin@msn.com
16335               fool@motleyfool.com
16336 </PRE>
16337
16338 <P>
16339 Each of those are valid To patterns.
16340 <P>
16341
16342 Messages match those patterns if any of the
16343 addresses in the To: line of the message contains the pattern.
16344 If the pattern is a list of patterns
16345 (like the last example above) then it is a match if any of the patterns in
16346 the list match any of the addresses in the To: line.
16347 (It is not possible to specify two addresses that must <EM>BOTH</EM> be
16348 present for a match.
16349 It is only possible to specify that <EM>EITHER</EM> address1 <EM>OR</EM>
16350 address2 must be present.
16351 That is exactly what using a list does.)
16352 <P>
16353
16354 Some messages may be &quot;bounced&quot; to you, and will
16355 have a &quot;Resent-To:&quot; header line.
16356 If the message contains a Resent-To: line
16357 and the feature <A HREF="h_config_use_resentto"><!--#echo var="FEAT_use-resent-to-in-rules"--></A> is turned on,
16358 Alpine will look for
16359 matches to your &quot;To patterns&quot; there, and <EM>NOT</EM> in
16360 the original To: line.
16361 <P>
16362
16363 When entering a pattern, you may choose an address from your address book
16364 with the &quot;T&quot; command.
16365 <P>
16366
16367 It is possible to add a <EM>NOT</EM> to the To Pattern meaning with the
16368 &quot;!&quot; &quot;toggle NOT&quot; command.
16369 This changes the meaning of the To pattern so that it has the opposite meaning.
16370 It will be considered a match if there are no matches between the
16371 addresses in the To: line and the list of To patterns.
16372 <P>
16373 Don't make the mistake of putting the &quot;!&quot; in the data field for
16374 the pattern.
16375 For example, if you type the characters &quot;!frizzle&quot; into the To
16376 pattern, the pattern will look like:
16377 <P>
16378 <PRE>
16379  To pattern = !frizzle
16380 </PRE>
16381 <P>
16382 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
16383 In order to match messages that do not have &quot;frizzle&quot; in
16384 their To field, first type the characters &quot;frizzle&quot; followed
16385 by carriage return for the value of the To pattern, then negate it
16386 by typing the &quot;!&quot; command.
16387 It should end up looking like
16388 <P>
16389 <PRE>
16390  ! To pattern = frizzle
16391 </PRE>
16392 <P>
16393
16394 You are not limited to using the six standard header patterns that are
16395 normally shown (To, From, Sender, Cc, News, and Subject).
16396 You may add any other header to a Pattern by
16397 using the &quot;eXtraHdr&quot; command to specify a different
16398 message header line; and then the Add or Change command to fill in
16399 a pattern for the new header line, just like you would for a standard header.
16400 <P>
16401 A technicality: Since comma is the character used to separate multiple
16402 values in a pattern field, you have to escape comma with a backslash (&#92;) if
16403 you want to include a literal comma in the field.
16404 In other words, if you type a backslash followed by a comma it will
16405 be interpreted as a comma by Alpine, instead of as a separator between
16406 pattern values.
16407 All other backslashes are literal backslashes and should not be escaped.
16408 <P>
16409 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16410 for more information on Patterns.
16411 <P>
16412 Look <A HREF="h_edit_nav_cmds">here</A>
16413 to see the available Editing and Navigation commands.
16414 <P>
16415 &lt;End of help on this topic&gt;
16416 </BODY>
16417 </HTML>
16418 ======= h_config_other_topat =======
16419 <HTML>
16420 <HEAD>
16421 <TITLE>&quot;To:&quot; Pattern Explained</TITLE>
16422 </HEAD>
16423 <BODY>
16424 <H1>&quot;To:&quot; Pattern Explained</H1>
16425
16426 For some of the OTHER RULES actions, there is no message that is being
16427 compared against.
16428 If that is the case, then only the Current Folder Type is checked.
16429 In particular, this To pattern is ignored.
16430 Actions that fall into this category include both
16431 Sort Order and Index Format.
16432 <P>
16433 A technicality: Since comma is the character used to separate multiple
16434 values in a pattern field, you have to escape comma with a backslash (&#92;) if
16435 you want to include a literal comma in the field.
16436 In other words, if you type a backslash followed by a comma it will
16437 be interpreted as a comma by Alpine, instead of as a separator between
16438 pattern values.
16439 All other backslashes are literal backslashes and should not be escaped.
16440 <P>
16441 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16442 for more information on Patterns.
16443 <P>
16444 Look <A HREF="h_edit_nav_cmds">here</A>
16445 to see the available Editing and Navigation commands.
16446 <P>
16447 &lt;End of help on this topic&gt;
16448 </BODY>
16449 </HTML>
16450 ======= h_config_filt_topat =======
16451 <HTML>
16452 <HEAD>
16453 <TITLE>&quot;To:&quot; Pattern Explained</TITLE>
16454 </HEAD>
16455 <BODY>
16456 <H1>&quot;To:&quot; Pattern Explained</H1>
16457
16458 Any text you enter as the &quot;To pattern&quot;
16459 will be compared to the recipients from the To: line of
16460 messages when Alpine opens folders.
16461 When the text you entered matches
16462 all or part of the To: line of a message, then the Filter Action you have
16463 specified will be carried out.
16464 (Any other non-blank parts of the Pattern must match, too.)
16465 <P>
16466
16467 You may enter a complete email address, part of an address, or a
16468 list of addresses or partial addresses.
16469 For example:
16470 <P>
16471
16472 <PRE>
16473  To pattern = friend@public.com
16474  To pattern = rated.net
16475  To pattern = xxx@adults.com
16476               admin@msn.com
16477               fool@motleyfool.com
16478 </PRE>
16479
16480 <P>
16481 Each of those are valid To patterns.
16482 <P>
16483
16484 Messages match those patterns if any of the
16485 addresses in the To: line of the message contains the pattern.
16486 If the pattern is a list of patterns
16487 (like the last example above) then it is a match if any of the patterns in
16488 the list match any of the addresses in the To: line.
16489 (It is not possible to specify two addresses that must <EM>BOTH</EM> be
16490 present for a match.
16491 It is only possible to specify that <EM>EITHER</EM> address1 <EM>OR</EM>
16492 address2 must be present.
16493 That is exactly what using a list does.)
16494 <P>
16495
16496 Some messages may be &quot;bounced&quot; to you, and will
16497 have a &quot;Resent-To:&quot; header line.
16498 If the message contains a Resent-To: line
16499 and the feature <A HREF="h_config_use_resentto"><!--#echo var="FEAT_use-resent-to-in-rules"--></A> is turned on,
16500 Alpine will look for
16501 matches to your &quot;To patterns&quot; there, and <EM>NOT</EM> in
16502 the original To: line.
16503 <P>
16504
16505 When entering a pattern, you may choose an address from your address book
16506 with the &quot;T&quot; command.
16507 <P>
16508
16509 It is possible to add a <EM>NOT</EM> to the To Pattern meaning with the
16510 &quot;!&quot; &quot;toggle NOT&quot; command.
16511 This changes the meaning of the To pattern so that it has the opposite meaning.
16512 It will be considered a match if there are no matches between the
16513 addresses in the To: line and the list of To patterns.
16514 <P>
16515 Don't make the mistake of putting the &quot;!&quot; in the data field for
16516 the pattern.
16517 For example, if you type the characters &quot;!frizzle&quot; into the To
16518 pattern, the pattern will look like:
16519 <P>
16520 <PRE>
16521  To pattern = !frizzle
16522 </PRE>
16523 <P>
16524 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
16525 In order to match messages that do not have &quot;frizzle&quot; in
16526 their To field, first type the characters &quot;frizzle&quot; followed
16527 by carriage return for the value of the To pattern, then negate it
16528 by typing the &quot;!&quot; command.
16529 It should end up looking like
16530 <P>
16531 <PRE>
16532  ! To pattern = frizzle
16533 </PRE>
16534 <P>
16535
16536 You are not limited to using the six standard header patterns that are
16537 normally shown (To, From, Sender, Cc, News, and Subject).
16538 You may add any other header to a Pattern by
16539 using the &quot;eXtraHdr&quot; command to specify a different
16540 message header line; and then the Add or Change command to fill in
16541 a pattern for the new header line, just like you would for a standard header.
16542 <P>
16543 A technicality: Since comma is the character used to separate multiple
16544 values in a pattern field, you have to escape comma with a backslash (&#92;) if
16545 you want to include a literal comma in the field.
16546 In other words, if you type a backslash followed by a comma it will
16547 be interpreted as a comma by Alpine, instead of as a separator between
16548 pattern values.
16549 All other backslashes are literal backslashes and should not be escaped.
16550 <P>
16551 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16552 for more information on Patterns.
16553 <P>
16554 Look <A HREF="h_edit_nav_cmds">here</A>
16555 to see the available Editing and Navigation commands.
16556 <P>
16557 &lt;End of help on this topic&gt;
16558 </BODY>
16559 </HTML>
16560 ======= h_config_role_topat =======
16561 <HTML>
16562 <HEAD>
16563 <TITLE>&quot;To:&quot; Pattern Explained</TITLE>
16564 </HEAD>
16565 <BODY>
16566 <H1>&quot;To:&quot; Pattern Explained</H1>
16567
16568 Any text you enter as the &quot;To pattern&quot;
16569 will be compared to the recipients from the To: line of
16570 the message being replied to or forwarded.
16571 (Any other non-blank parts of the Pattern must match, too.)
16572 In the case of the Compose command, this pattern and the other header
16573 patterns are ignored.
16574 <P>
16575
16576 You may enter a complete email address, part of an address, or a
16577 list of addresses or partial addresses.
16578 For example:
16579 <P>
16580
16581 <PRE>
16582  To pattern = friend@public.com
16583  To pattern = rated.net
16584  To pattern = xxx@adults.com
16585               admin@msn.com
16586               fool@motleyfool.com
16587 </PRE>
16588
16589 <P>
16590 Each of those are valid To patterns.
16591 <P>
16592
16593 Messages match those patterns if any of the
16594 addresses in the To: line of the message contains the pattern.
16595 If the pattern is a list of patterns
16596 (like the last example above) then it is a match if any of the patterns in
16597 the list match any of the addresses in the To: line.
16598 (It is not possible to specify two addresses that must <EM>BOTH</EM> be
16599 present for a match.
16600 It is only possible to specify that <EM>EITHER</EM> address1 <EM>OR</EM>
16601 address2 must be present.
16602 That is exactly what using a list does.)
16603 <P>
16604
16605 Some messages may be &quot;bounced&quot; to you, and will
16606 have a &quot;Resent-To:&quot; header line.
16607 If the message contains a Resent-To: line
16608 and the feature <A HREF="h_config_use_resentto"><!--#echo var="FEAT_use-resent-to-in-rules"--></A> is turned on,
16609 Alpine will look for
16610 matches to your &quot;To patterns&quot; there, and <EM>NOT</EM> in
16611 the original To: line.
16612 <P>
16613
16614 When entering a pattern, you may choose an address from your address book
16615 with the &quot;T&quot; command.
16616 <P>
16617
16618 It is possible to add a <EM>NOT</EM> to the To Pattern meaning with the
16619 &quot;!&quot; &quot;toggle NOT&quot; command.
16620 This changes the meaning of the To pattern so that it has the opposite meaning.
16621 It will be considered a match if there are no matches between the
16622 addresses in the To: line and the list of To patterns.
16623 <P>
16624 Don't make the mistake of putting the &quot;!&quot; in the data field for
16625 the pattern.
16626 For example, if you type the characters &quot;!frizzle&quot; into the To
16627 pattern, the pattern will look like:
16628 <P>
16629 <PRE>
16630  To pattern = !frizzle
16631 </PRE>
16632 <P>
16633 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
16634 In order to match messages that do not have &quot;frizzle&quot; in
16635 their To field, first type the characters &quot;frizzle&quot; followed
16636 by carriage return for the value of the To pattern, then negate it
16637 by typing the &quot;!&quot; command.
16638 It should end up looking like
16639 <P>
16640 <PRE>
16641  ! To pattern = frizzle
16642 </PRE>
16643 <P>
16644
16645 You are not limited to using the six standard header patterns that are
16646 normally shown (To, From, Sender, Cc, News, and Subject).
16647 You may add any other header to a Pattern by
16648 using the &quot;eXtraHdr&quot; command to specify a different
16649 message header line; and then the Add or Change command to fill in
16650 a pattern for the new header line, just like you would for a standard header.
16651 <P>
16652 A technicality: Since comma is the character used to separate multiple
16653 values in a pattern field, you have to escape comma with a backslash (&#92;) if
16654 you want to include a literal comma in the field.
16655 In other words, if you type a backslash followed by a comma it will
16656 be interpreted as a comma by Alpine, instead of as a separator between
16657 pattern values.
16658 All other backslashes are literal backslashes and should not be escaped.
16659 <P>
16660 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16661 for more information on Patterns.
16662 <P>
16663 Look <A HREF="h_edit_nav_cmds">here</A>
16664 to see the available Editing and Navigation commands.
16665 <P>
16666 &lt;End of help on this topic&gt;
16667 </BODY>
16668 </HTML>
16669 ======= h_config_role_frompat =======
16670 <HTML>
16671 <HEAD>
16672 <TITLE>&quot;From:&quot; Pattern Explained</TITLE>
16673 </HEAD>
16674 <BODY>
16675 <H1>&quot;From:&quot; Pattern Explained</H1>
16676
16677 This is just like the &quot;To pattern&quot; except that it is compared with
16678 the address in the From: line of the message
16679 instead of the addresses from the To: line.
16680 See the help for the To pattern for more information on header patterns.
16681 <P>
16682 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16683 for more information on Patterns.
16684 <P>
16685 Look <A HREF="h_edit_nav_cmds">here</A>
16686 to see the available Editing and Navigation commands.
16687 <P>
16688 &lt;End of help on this topic&gt;
16689 </BODY>
16690 </HTML>
16691 ======= h_config_role_senderpat =======
16692 <HTML>
16693 <HEAD>
16694 <TITLE>&quot;Sender:&quot; Pattern Explained</TITLE>
16695 </HEAD>
16696 <BODY>
16697 <H1>&quot;Sender:&quot; Pattern Explained</H1>
16698
16699 This is just like the &quot;To pattern&quot; except that it is compared with
16700 the address from the Sender: line of the message
16701 instead of the addresses from the To: line.
16702 See the help for the To pattern for more information on header patterns.
16703 <P>
16704 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16705 for more information on Patterns.
16706 <P>
16707 Look <A HREF="h_edit_nav_cmds">here</A>
16708 to see the available Editing and Navigation commands.
16709 <P>
16710 &lt;End of help on this topic&gt;
16711 </BODY>
16712 </HTML>
16713 ======= h_config_role_ccpat =======
16714 <HTML>
16715 <HEAD>
16716 <TITLE>&quot;Cc:&quot; Pattern Explained</TITLE>
16717 </HEAD>
16718 <BODY>
16719 <H1>&quot;Cc:&quot; Pattern Explained</H1>
16720
16721 This is just like the &quot;To pattern&quot; except that it is compared with
16722 the addresses from the Cc: line of the message
16723 instead of the addresses from the To: line.
16724 See the help for the To pattern for more information on header patterns.
16725 <P>
16726 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16727 for more information on Patterns.
16728 <P>
16729 Look <A HREF="h_edit_nav_cmds">here</A>
16730 to see the available Editing and Navigation commands.
16731 <P>
16732 &lt;End of help on this topic&gt;
16733 </BODY>
16734 </HTML>
16735 ======= h_config_role_recippat =======
16736 <HTML>
16737 <HEAD>
16738 <TITLE>Recipient Pattern Explained</TITLE>
16739 </HEAD>
16740 <BODY>
16741 <H1>Recipient Pattern Explained</H1>
16742
16743 This is just like the &quot;To pattern&quot; except that it is compared with
16744 the addresses from both the To: line and the Cc: line of the
16745 message instead of just the addresses from the To: line.
16746 In other words, it is considered a match if the pattern matches
16747 <EM>EITHER</EM> an address in the To: line <EM>OR</EM> an address
16748 in the Cc: line.
16749 (Notice that defining the Recipient pattern does not have the same
16750 effect as defining both the To and Cc patterns.
16751 Recipient is To <EM>OR</EM> Cc; not To <EM>AND</EM> Cc.
16752 It is equivalent to having two different rules;
16753 one with a To pattern and the other with the same Cc pattern.)
16754 <P>
16755 A technicality: Since comma is the character used to separate multiple
16756 values in a pattern field, you have to escape comma with a backslash (&#92;) if
16757 you want to include a literal comma in the field.
16758 In other words, if you type a backslash followed by a comma it will
16759 be interpreted as a comma by Alpine, instead of as a separator between
16760 pattern values.
16761 All other backslashes are literal backslashes and should not be escaped.
16762 <P>
16763 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16764 for more information on Patterns.
16765 <P>
16766 Look <A HREF="h_edit_nav_cmds">here</A>
16767 to see the available Editing and Navigation commands.
16768 <P>
16769 &lt;End of help on this topic&gt;
16770 </BODY>
16771 </HTML>
16772 ======= h_config_role_particpat =======
16773 <HTML>
16774 <HEAD>
16775 <TITLE>Participant Pattern Explained</TITLE>
16776 </HEAD>
16777 <BODY>
16778 <H1>Participant Pattern Explained</H1>
16779
16780 This is just like the &quot;To pattern&quot; except that it is compared with
16781 the addresses from the From: line, the To: line, and the Cc: line of the
16782 message instead of just the addresses from the To: line.
16783 In other words, it is considered a match if the pattern matches
16784 <EM>EITHER</EM> an address in the From: line, <EM>OR</EM> an address
16785 in the To: line, <EM>OR</EM> an address in the Cc: line.
16786 (Notice that defining the Participant pattern does not have the same
16787 effect as defining all of the From, To, and Cc patterns.
16788 Participant is From <EM>OR</EM> To <EM>OR</EM> Cc; not
16789 From <EM>AND</EM> To <EM>AND</EM> Cc.
16790 It is equivalent to having three different rules;
16791 one with a From pattern, another with the same To pattern, and a third with
16792 the same Cc pattern.)
16793 <P>
16794 A technicality: Since comma is the character used to separate multiple
16795 values in a pattern field, you have to escape comma with a backslash (&#92;) if
16796 you want to include a literal comma in the field.
16797 In other words, if you type a backslash followed by a comma it will
16798 be interpreted as a comma by Alpine, instead of as a separator between
16799 pattern values.
16800 All other backslashes are literal backslashes and should not be escaped.
16801 <P>
16802 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16803 for more information on Patterns.
16804 <P>
16805 Look <A HREF="h_edit_nav_cmds">here</A>
16806 to see the available Editing and Navigation commands.
16807 <P>
16808 &lt;End of help on this topic&gt;
16809 </BODY>
16810 </HTML>
16811 ======= h_config_role_newspat =======
16812 <HTML>
16813 <HEAD>
16814 <TITLE>News Pattern Explained</TITLE>
16815 </HEAD>
16816 <BODY>
16817 <H1>News Pattern Explained</H1>
16818
16819 If this pattern is non-blank, then for this rule to be considered a
16820 match, at least one of the newsgroups from
16821 the Newsgroups line of the message must match this pattern.
16822 If this pattern is a list of patterns, then at least one of the
16823 newsgroups must match at least one of the patterns.
16824 (Any other non-blank parts of the Pattern must match, too.)
16825 <P>
16826 It is possible to add a <EM>NOT</EM> to the News Pattern meaning with the
16827 &quot;!&quot; &quot;toggle NOT&quot; command.
16828 This changes the meaning of the News pattern so that it has the opposite meaning.
16829 It will be considered a match if there are no matches between the
16830 addresses in the Newsgroups: line and the list of News patterns.
16831 <P>
16832 Don't make the mistake of putting the &quot;!&quot; in the data field for
16833 the pattern.
16834 For example, if you type the characters &quot;!frizzle&quot; into the News
16835 pattern, the pattern will look like:
16836 <P>
16837 <PRE>
16838  News pattern = !frizzle
16839 </PRE>
16840 <P>
16841 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
16842 In order to match messages that do not have &quot;frizzle&quot; in
16843 their Newsgroups header, first type the characters &quot;frizzle&quot; followed
16844 by carriage return for the value of the News pattern, then negate it
16845 by typing the &quot;!&quot; command.
16846 It should end up looking like
16847 <P>
16848 <PRE>
16849  ! News pattern = frizzle
16850 </PRE>
16851 <P>
16852 A technicality: Since comma is the character used to separate multiple
16853 values in a pattern field, you have to escape comma with a backslash (&#92;) if
16854 you want to include a literal comma in the field.
16855 In other words, if you type a backslash followed by a comma it will
16856 be interpreted as a comma by Alpine, instead of as a separator between
16857 pattern values.
16858 All other backslashes are literal backslashes and should not be escaped.
16859 <P>
16860
16861 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16862 for more information on Patterns.
16863 <P>
16864 Look <A HREF="h_edit_nav_cmds">here</A>
16865 to see the available Editing and Navigation commands.
16866 <P>
16867 &lt;End of help on this topic&gt;
16868 </BODY>
16869 </HTML>
16870 ======= h_config_role_subjpat =======
16871 <HTML>
16872 <HEAD>
16873 <TITLE>&quot;Subject:&quot; Pattern Explained</TITLE>
16874 </HEAD>
16875 <BODY>
16876 <H1>&quot;Subject:&quot; Pattern Explained</H1>
16877
16878 This is similar to the other parts of the Pattern.
16879 It is compared with
16880 the contents from the Subject of the message.
16881 <P>
16882 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16883 for more information on Patterns.
16884 <P>
16885 It is possible to add a <EM>NOT</EM> to the Subject Pattern meaning with the
16886 &quot;!&quot; &quot;toggle NOT&quot; command.
16887 This changes the meaning of the Subject pattern so that it has the opposite meaning.
16888 It will be considered a match if there are no matches between the
16889 text in the Subject: line and the list of Subject patterns.
16890 <P>
16891
16892 If you wish to have a header pattern that is not one of the six standard
16893 header patterns, you may add it with the &quot;eXtraHdr&quot; command.
16894 <P>
16895 A technicality: Since comma is the character used to separate multiple
16896 values in a pattern field, you have to escape comma with a backslash (&#92;) if
16897 you want to include a literal comma in the field.
16898 In other words, if you type a backslash followed by a comma it will
16899 be interpreted as a comma by Alpine, instead of as a separator between
16900 pattern values.
16901 All other backslashes are literal backslashes and should not be escaped.
16902 <P>
16903 Look <A HREF="h_edit_nav_cmds">here</A>
16904 to see the available Editing and Navigation commands.
16905 <P>
16906 &lt;End of help on this topic&gt;
16907 </BODY>
16908 </HTML>
16909 ======= h_config_role_alltextpat =======
16910 <HTML>
16911 <HEAD>
16912 <TITLE>AllText Pattern Explained</TITLE>
16913 </HEAD>
16914 <BODY>
16915 <H1>AllText Pattern Explained</H1>
16916
16917 This is similar to the header patterns.
16918 Instead of comparing with text in a particular header field it
16919 is compared with all of the text in the message header and body.
16920 <P>
16921 It is possible to add a <EM>NOT</EM> to the AllText Pattern meaning with the
16922 &quot;!&quot; &quot;toggle NOT&quot; command.
16923 This changes the meaning of the AllText pattern so that it has the opposite meaning.
16924 It will be considered a match if there are no matches between the
16925 text of the message and the list of AllText patterns.
16926 <P>
16927 Don't make the mistake of putting the &quot;!&quot; in the data field for
16928 the pattern.
16929 For example, if you type the characters &quot;!frizzle&quot; into the AllText
16930 pattern, the pattern will look like:
16931 <P>
16932 <PRE>
16933  AllText pattern = !frizzle
16934 </PRE>
16935 <P>
16936 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
16937 In order to match messages that do not have &quot;frizzle&quot; in
16938 the text of the message, first type the characters &quot;frizzle&quot; followed
16939 by carriage return for the value of the AllText pattern, then negate it
16940 by typing the &quot;!&quot; command.
16941 It should end up looking like
16942 <P>
16943 <PRE>
16944  ! AllText pattern = frizzle
16945 </PRE>
16946 <P>
16947 It is possible that you may notice degraded performance when using
16948 AllText Patterns.
16949 <P>
16950 A technicality: Since comma is the character used to separate multiple
16951 values in a pattern field, you have to escape comma with a backslash (&#92;) if
16952 you want to include a literal comma in the field.
16953 In other words, if you type a backslash followed by a comma it will
16954 be interpreted as a comma by Alpine, instead of as a separator between
16955 pattern values.
16956 All other backslashes are literal backslashes and should not be escaped.
16957 <P>
16958 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
16959 for more information on Patterns.
16960 <P>
16961 Look <A HREF="h_edit_nav_cmds">here</A>
16962 to see the available Editing and Navigation commands.
16963 <P>
16964 &lt;End of help on this topic&gt;
16965 </BODY>
16966 </HTML>
16967 ======= h_config_role_bodytextpat =======
16968 <HTML>
16969 <HEAD>
16970 <TITLE>BodyText Pattern Explained</TITLE>
16971 </HEAD>
16972 <BODY>
16973 <H1>BodyText Pattern Explained</H1>
16974
16975 This is similar to the header patterns.
16976 Instead of comparing with text in a particular header field it
16977 is compared with all of the text in the message body.
16978 <P>
16979 It is possible to add a <EM>NOT</EM> to the BodyText Pattern meaning with the
16980 &quot;!&quot; &quot;toggle NOT&quot; command.
16981 This changes the meaning of the BodyText pattern so that it has the opposite meaning.
16982 It will be considered a match if there are no matches between the
16983 text of the body of the message and the list of BodyText patterns.
16984 <P>
16985 Don't make the mistake of putting the &quot;!&quot; in the data field for
16986 the pattern.
16987 For example, if you type the characters &quot;!frizzle&quot; into the BodyText
16988 pattern, the pattern will look like:
16989 <P>
16990 <PRE>
16991  BdyText pattern = !frizzle
16992 </PRE>
16993 <P>
16994 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
16995 In order to match messages that do not have &quot;frizzle&quot; in
16996 their BodyText, first type the characters &quot;frizzle&quot; followed
16997 by carriage return for the value of the BodyText pattern, then negate it
16998 by typing the &quot;!&quot; command.
16999 It should end up looking like
17000 <P>
17001 <PRE>
17002  ! BodyText pattern = frizzle
17003 </PRE>
17004 <P>
17005 It is possible that you may notice degraded performance when using
17006 BodyText Patterns.
17007 <P>
17008 A technicality: Since comma is the character used to separate multiple
17009 values in a pattern field, you have to escape comma with a backslash (&#92;) if
17010 you want to include a literal comma in the field.
17011 In other words, if you type a backslash followed by a comma it will
17012 be interpreted as a comma by Alpine, instead of as a separator between
17013 pattern values.
17014 All other backslashes are literal backslashes and should not be escaped.
17015 <P>
17016 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17017 for more information on Patterns.
17018 <P>
17019 Look <A HREF="h_edit_nav_cmds">here</A>
17020 to see the available Editing and Navigation commands.
17021 <P>
17022 &lt;End of help on this topic&gt;
17023 </BODY>
17024 </HTML>
17025 ======= h_config_role_charsetpat =======
17026 <HTML>
17027 <HEAD>
17028 <TITLE>Character Set Pattern Explained</TITLE>
17029 </HEAD>
17030 <BODY>
17031 <H1>Character Set Pattern Explained</H1>
17032
17033 A message may use one or more character sets.
17034 This part of the Pattern matches messages that make use of
17035 certain specified character sets.
17036 It will be considered a match if a message uses any of the character
17037 sets in the list you give here.
17038
17039 <P>
17040 When filling in a value for this field, you may use
17041 the &quot;T&quot; command, which presents you with a large list of
17042 possible character sets to choose from.
17043 You may also just type in the name of a character set, and it need not
17044 be one that Alpine knows about.
17045
17046 <P>
17047 Besides actual character set names (for example, ISO-8859-7, KOI8-R, or
17048 GB2312) you may also use some shorthand names that Alpine provides.
17049 These names are more understandable shorthand names for sets of
17050 character set names.
17051 Two examples are &quot;Cyrillic&quot; and &quot;Greek&quot;.
17052 Selecting one of these shorthand names is equivalent to selecting all of
17053 the character sets that make up the set.
17054 You can see all of these shorthand names and the lists of character sets
17055 they stand for by typing the &quot;T&quot; command.
17056
17057 <P>
17058 For the purposes of this Pattern,
17059 Alpine will search through a message for all of the text parts and
17060 collect the character sets declared for each part.
17061 It will also look in the Subject line for a character set used there.
17062 Alpine does not actually look at the text of the message or the text
17063 of the Subject to determine if a declared character set is actually
17064 used, it looks only at the declarations themselves in the MIME part headers
17065 and in the Subject.
17066
17067 <P>
17068 It is possible to add a <EM>NOT</EM> to the Character Set Pattern meaning with the
17069 &quot;!&quot; &quot;toggle NOT&quot; command.
17070 This changes the meaning of the Character Set pattern so that
17071 it has the opposite meaning.
17072 It will be considered a match if none of the character sets in the
17073 list are used in a message.
17074 <P>
17075 Don't make the mistake of putting the &quot;!&quot; in the data field for
17076 the pattern.
17077 For example, if you type the characters &quot;!GB2312&quot; into the
17078 Character Set pattern, the pattern will look like:
17079 <P>
17080 <PRE>
17081  Charset pattern = !GB2312
17082 </PRE>
17083 <P>
17084 This means you want to match the 7 character sequence &quot;!GB2312&quot;.
17085 In order to match messages that do not have the
17086 character set &quot;GB2312&quot;
17087 set, first type the characters &quot;GB2312&quot; followed
17088 by carriage return for the value of the Character Set pattern, then negate it
17089 by typing the &quot;!&quot; command.
17090 It should end up looking like
17091 <P>
17092 <PRE>
17093  ! Charset pattern = GB2312
17094 </PRE>
17095 <P>
17096 A technicality: Since comma is the character used to separate multiple
17097 values in a pattern field, you have to escape comma with a backslash (&#92;) if
17098 you want to include a literal comma in the field.
17099 In other words, if you type a backslash followed by a comma it will
17100 be interpreted as a comma by Alpine, instead of as a separator between
17101 pattern values.
17102 All other backslashes are literal backslashes and should not be escaped.
17103 <P>
17104 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17105 for more information on Patterns.
17106 <P>
17107 Look <A HREF="h_edit_nav_cmds">here</A>
17108 to see the available Editing and Navigation commands.
17109 <P>
17110 &lt;End of help on this topic&gt;
17111 </BODY>
17112 </HTML>
17113 ======= h_config_role_keywordpat =======
17114 <HTML>
17115 <HEAD>
17116 <TITLE>Keyword Pattern Explained</TITLE>
17117 </HEAD>
17118 <BODY>
17119 <H1>Keyword Pattern Explained</H1>
17120
17121 A folder may have user-defined keywords.
17122 These are similar to the Important flag, which the user may set using the
17123 Flag command.
17124 The difference is that the Important flag is always present for each folder.
17125 User-defined keywords are picked by the user.
17126 You may add new keywords by defining them in the
17127 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in the Setup/Config screen.
17128 After you have added a potential keyword with the <!--#echo var="VAR_keywords"--> option,
17129 the Flag command may be used to set or clear the keyword on individual messages.
17130 If you have given a keyword a nickname when configuring it,
17131 that nickname may be used instead of the actual keyword.
17132
17133 <P>
17134 When filling in a value for this field, it may be easiest to use
17135 the &quot;T&quot; command, which presents you with a list of the keywords
17136 you have defined to choose from.
17137
17138 <P>
17139 This part of the Pattern matches messages with certain keywords set.
17140 It will be considered a match if a message has any of the keywords in the
17141 list set.
17142 A keyword that you have not defined using the
17143 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in the Setup/Config screen
17144 will not be a match.
17145
17146 <P>
17147 It is possible to add a <EM>NOT</EM> to the Keyword Pattern meaning with the
17148 &quot;!&quot; &quot;toggle NOT&quot; command.
17149 This changes the meaning of the Keyword pattern so that it has the opposite meaning.
17150 It will be considered a match if none of the keywords in the list are set
17151 for a message.
17152 A keyword that you have not defined using the
17153 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in the Setup/Config screen
17154 will not be a match, so a <EM>NOT</EM> of that keyword does match.
17155 <P>
17156 Don't make the mistake of putting the &quot;!&quot; in the data field for
17157 the pattern.
17158 For example, if you type the characters &quot;!frizzle&quot; into the Keyword
17159 pattern, the pattern will look like:
17160 <P>
17161 <PRE>
17162  Keyword pattern = !frizzle
17163 </PRE>
17164 <P>
17165 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
17166 In order to match messages that do not have the keyword &quot;frizzle&quot;
17167 set, first type the characters &quot;frizzle&quot; followed
17168 by carriage return for the value of the Keyword pattern, then negate it
17169 by typing the &quot;!&quot; command.
17170 It should end up looking like
17171 <P>
17172 <PRE>
17173  ! Keyword pattern = frizzle
17174 </PRE>
17175 <P>
17176 A technicality: Since comma is the character used to separate multiple
17177 values in a pattern field, you have to escape comma with a backslash (&#92;) if
17178 you want to include a literal comma in the field.
17179 In other words, if you type a backslash followed by a comma it will
17180 be interpreted as a comma by Alpine, instead of as a separator between
17181 pattern values.
17182 All other backslashes are literal backslashes and should not be escaped.
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_arbpat =======
17194 <HTML>
17195 <HEAD>
17196 <TITLE>Extra Header Patterns Explained</TITLE>
17197 </HEAD>
17198 <BODY>
17199 <H1>Extra Header Patterns Explained</H1>
17200
17201 The header patterns that come after the Participant pattern but before the
17202 AllText pattern are extra header patterns that you have added to a rule's
17203 Pattern. These are just like the other header patterns except that
17204 the contents of the particular header listed on the left hand side will
17205 be used for comparisons.
17206 <P>
17207 The &quot;eXtraHdr&quot; command may be used to add more of these
17208 header patterns to the rule you are editing.
17209 <P>
17210 The &quot;RemoveHdr&quot; command may be used to delete the highlighted
17211 extra header pattern from the rule you are editing.
17212 <P>
17213 It is possible to add a <EM>NOT</EM> to the Extra Header Pattern meaning with the
17214 &quot;!&quot; &quot;toggle NOT&quot; command.
17215 This changes the meaning of the pattern so that it has the opposite meaning.
17216 It will be considered a match if there are no matches between the
17217 text in the header line and the list of patterns.
17218 <P>
17219 Don't make the mistake of putting the &quot;!&quot; in the data field for
17220 the pattern.
17221 For example, if you type the characters &quot;!frizzle&quot; into the
17222 pattern, the pattern will look like:
17223 <P>
17224 <PRE>
17225  Xyz pattern = !frizzle
17226 </PRE>
17227 <P>
17228 This means you want to match the 8 character sequence &quot;!frizzle&quot;.
17229 In order to match messages that do not have &quot;frizzle&quot; in
17230 their Xyz field, first type the characters &quot;frizzle&quot; followed
17231 by carriage return for the value of the pattern, then negate it
17232 by typing the &quot;!&quot; command.
17233 It should end up looking like
17234 <P>
17235 <PRE>
17236  ! Xyz pattern = frizzle
17237 </PRE>
17238
17239 <P>
17240 A technicality: Since comma is the character used to separate multiple
17241 values in a pattern field, you have to escape comma with a backslash (&#92;) if
17242 you want to include a literal comma in the field.
17243 In other words, if you type a backslash followed by a comma it will
17244 be interpreted as a comma by Alpine, instead of as a separator between
17245 pattern values.
17246 All other backslashes are literal backslashes and should not be escaped.
17247 <P>
17248 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17249 for more information on Patterns.
17250 <P>
17251 Look <A HREF="h_edit_nav_cmds">here</A>
17252 to see the available Editing and Navigation commands.
17253 <P>
17254 &lt;End of help on this topic&gt;
17255 </BODY>
17256 </HTML>
17257 ======= h_config_role_cat_cmd =======
17258 <HTML>
17259 <HEAD>
17260 <TITLE>Categorizer Command Explained</TITLE>
17261 </HEAD>
17262 <BODY>
17263 <H1>Categorizer Command Explained</H1>
17264
17265 This is a command that is run with its standard input set to the message
17266 being checked and its standard output discarded.
17267 The full directory path should be specified.
17268 The command will be run and then its exit status will be checked against
17269 the Exit Status Interval, which defaults to just the value zero.
17270 If the exit status of the command falls in the interval, it is considered
17271 a match, otherwise it is not a match.
17272 <P>
17273
17274 This option may actually be a list of commands.
17275 The first one that exists and is executable is used.
17276 That makes it possible to use the same configuration with Unix Alpine and
17277 PC-Alpine.
17278 <P>
17279
17280 If none of the commands in the list exists and is executable then the rule
17281 is <EM>not</EM> a match.
17282 If it is possible that the command may not exist, you should be careful
17283 to structure your rules so that nothing destructive
17284 happens when the command does not exist.
17285 For example, you might have a filter that filters away spam when there is
17286 a match but does nothing when there is not a match.
17287 That would cause no harm if the command didn't exist.
17288 However, if you have a filter that filters away spam when there is not
17289 a match and keeps it when there is a match, that would filter everything
17290 if the categorizer command didn't exist.
17291 <P>
17292 Here is an <A HREF="h_config_role_cat_cmd_example">example</A>
17293 setup for the bogofilter filter.
17294
17295 <P>
17296 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17297 for more information on Patterns.
17298 <P>
17299 Look <A HREF="h_edit_nav_cmds">here</A>
17300 to see the available Editing and Navigation commands.
17301 <P>
17302 &lt;End of help on this topic&gt;
17303 </BODY>
17304 </HTML>
17305 ======= h_config_role_cat_cmd_example =======
17306 <HTML>
17307 <HEAD>
17308 <TITLE>Categorizer Command Example</TITLE>
17309 </HEAD>
17310 <BODY>
17311 <H1>Categorizer Command Example</H1>
17312
17313 Bogofilter
17314 (<A HREF="http://bogofilter.sourceforge.net/">http://bogofilter.sourceforge.net/</A>)
17315 is a mail filter that attempts to classify mail as spam or
17316 non-spam using statistical analysis of the message content.
17317 When run with no arguments and a message as standard input, it exits with
17318 exit status 0 if it thinks a message is spam and 1 if it thinks
17319 it is not spam.
17320 To use bogofilter as your Categorizer Command you would simply set Command to
17321 the pathname of the bogofilter program.
17322 For example,
17323 <P>
17324 <CENTER><SAMP>Command = /usr/local/bin/bogofilter</SAMP></CENTER>
17325 <P>
17326 Exit status of zero is what you are interested in, so you'd set the
17327 Exit Status Interval to
17328 <P>
17329 <CENTER><SAMP>Exit Status Interval = (0,0)</SAMP></CENTER>
17330 <P>
17331
17332 In order to prevent downloading an entire huge message to check for spam, you
17333 might want to set the Character Limit to a few thousand characters (the
17334 assumption being that the spam will reveal itself in those characters)
17335 <P>
17336 <CENTER><SAMP>Character Limit = 50000</SAMP></CENTER>
17337 <P>
17338
17339 You would probably use bogofilter in an Alpine Filter Rule, and have the action
17340 be to move the message to a spam folder.
17341 It would usually be wise to also check the &quot;Message is Recent&quot;
17342 part of the rule so that messages are only checked when they first arrive,
17343 and to restrict the Current Folder Type to just your INBOX.
17344 The reason for checking only Recent messages is to save the time it takes
17345 to run bogofilter on each message.
17346 As an experiment, you might start out by using this in an Indexcolor Rule
17347 instead of a Filter Rule.
17348 In that case, you probably wouldn't check the Recent checkbox.
17349 <P>
17350 The use described above assumes that you are somehow maintaining bogofilter's
17351 database of words associated with spam and non-spam messages.
17352 One way to start your database would be to select a bunch of spam messages
17353 in Alpine (you might Save spam messages to a special folder or use Alpine's
17354 Select command to select several) and then Apply
17355 (<A HREF="h_config_enable_agg_ops"><!--#echo var="FEAT_enable-aggregate-command-set"--></A>)
17356 a pipe command to the spam messages.
17357 For example, you could have a shell script or an alias
17358 called <EM>this_is_spam</EM>, which would simply be the command
17359 <P>
17360 <CENTER><SAMP>bogofilter -s</SAMP></CENTER>
17361 <P>
17362
17363 It is probably best to use the pipe command's Raw Text, With Delimiter,
17364 and Free Output options,
17365 which are at the bottom of the screen when you type the pipe command.
17366 That's because bogofilter expects the raw message as input, and uses
17367 the Delimiters to tell when a new message starts.
17368 You would not need to use a separate pipe for each message, because
17369 bogofilter can handle multiple messages at once.
17370 <P>
17371 Similarly, you would select a group of non-spam messages
17372 and run them through a <EM>this_is_nonspam</EM> script
17373 that was something like
17374 <P>
17375 <CENTER><SAMP>bogofilter -n</SAMP></CENTER>
17376 <P>
17377
17378 For the more adventurous, the next step might be to automate the upkeep of
17379 the bogofilter database.
17380 It might make more sense to have bogofilter be part of the delivery process,
17381 but it is also possible to do it entirely from within Alpine.
17382 Instead of using just plain &quot;bogofilter&quot; as the Categorizer Command,
17383 the &quot;-u&quot; argument will cause bogofilter to update the database.
17384 <P>
17385 <CENTER><SAMP>Command = /usr/local/bin/bogofilter -u</SAMP></CENTER>
17386 <P>
17387 You'd want a couple more aliases or shell scripts called something like
17388 <EM>change_to_spam</EM>
17389 <P>
17390 <CENTER><SAMP>bogofilter -Ns</SAMP></CENTER>
17391 <P>
17392 and
17393 <EM>change_to_nonspam</EM>
17394 <P>
17395 <CENTER><SAMP>bogofilter -Sn</SAMP></CENTER>
17396 <P>
17397 When you run across a message in your INBOX that should have been
17398 classified as spam you would pipe it to the change_to_spam script, and
17399 when you run across a message in your spam folder that should have been
17400 left in your INBOX you would pipe it through change_to_nonspam.
17401
17402 <P>
17403 There is a technical problem with this approach.
17404 Alpine may check your filters more than once.
17405 In particular, every time you start Alpine the filters will be checked for
17406 each message.
17407 Also, if you have any filters that depend on message state (New, Deleted, etc.)
17408 then Alpine will recheck for matches in messages that have changed state
17409 at the time you close the folder and before expunging.
17410 This is usually ok.
17411 However, in this case it is a problem because the command
17412 <P>
17413 <CENTER><SAMP>Command = /usr/local/bin/bogofilter -u</SAMP></CENTER>
17414 <P>
17415 has the side effect of updating the database.
17416 So you run the risk of updating the database multiple times for a single
17417 message instead of updating it just once per message.
17418 There are some ways to work around this problem.
17419 What you need is a way to mark the message after you have run the filter.
17420 One way to mark messages is with the use of a keyword (say &quot;Bogo&quot;).
17421 Besides having the filter move the message to a spam folder, also have it
17422 set the Bogo keyword.
17423 (Note that you will have to set up the &quot;Bogo&quot; keyword in the
17424 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in Setup/Config.)
17425 This rule can only set the Bogo keyword for the messages that it matches.
17426 You will also need to add a second rule right after this one that
17427 matches all the messages that don't have the Bogo keyword set
17428 (put the keyword in the Keyword pattern and toggle
17429 the Not with the ! command)
17430 and takes the action of setting it.
17431 Then change the &quot;bogofilter -u&quot; rule so that it won't be a match
17432 (and so it won't re-run the bogofilter command) if the keyword is already
17433 set.
17434 <P>
17435 What you will end up with is a rule that runs &quot;bogofilter -u&quot;
17436 on all messages that don't have the Bogo keyword set.
17437 This will have the side effect of inserting that message in the bogofilter
17438 database, match or not.
17439 If this rule matches (it is spam), the Bogo keyword will be set and
17440 the message will be moved to a spam folder.
17441 If it does not match, the
17442 following rule will mark the message by turning on the keyword.
17443 This second rule should be a non-terminating
17444 (<A HREF="h_config_filt_opts_nonterm">Dont-Stop-Even-if-Rule-Matches</A>)
17445 rule so that it doesn't stop the filtering process before the rest of
17446 your rules are consulted.
17447
17448 <P>
17449 In summary, the first rule is something like
17450 <PRE>
17451   Nickname          = bogofilter -u rule
17452   Current Folder Type =
17453                (*) Specific
17454                    Folder = INBOX
17455
17456   ! Keyword pattern = Bogo
17457
17458   External Categorizer Commands =
17459        Command              = /usr/local/bin/bogofilter -u
17460        Exit Status Interval = (0,0)
17461        Character Limit      = <No Value Set: using "-1">  (optionally set this)
17462
17463   Filter Action =
17464        (*) Move
17465            Folder = spam
17466
17467   Set These Keywords   = Bogo
17468 </PRE>
17469 <P>
17470 and the following rule is
17471 <PRE>
17472   Nickname          = Set Bogo Keyword
17473   Current Folder Type =
17474                (*) Specific
17475                    Folder = INBOX
17476
17477   ! Keyword pattern = Bogo
17478
17479   Filter Action =
17480        (*) Just Set Message Status
17481
17482   Set These Keywords   = Bogo
17483
17484   Features =
17485       [X]  dont-stop-even-if-rule-matches
17486 </PRE>
17487 <P>
17488 If it is possible for you to insert bogofilter in the delivery process instead
17489 of having it called from Alpine you could prevent having to wait
17490 for the bogofilter processing while you read your mail.
17491 You would have bogofilter add a header to the message at the time of delivery
17492 that identified it as spam or nonspam.
17493 With this method, you could avoid using a Categorizer Command while running Alpine,
17494 and just match on the header instead.
17495 You might still want to use the scripts mentioned above to initialize the
17496 database or to re-classify wrongly classified messages.
17497
17498 <P>
17499 Finally, it isn't for the faint-hearted,
17500 but it is also possible to run bogofilter from PC-Alpine.
17501 You can install Cygwin from
17502 <A HREF="http://www.cygwin.com/">http://www.cygwin.com/</A> and
17503 then compile bogofilter in the cygwin environment, and run it from
17504 within PC-Alpine.
17505 You would end up with a Categorizer command that looked something like
17506 <P>
17507 <CENTER><SAMP>Command = C:&#92;cygwin&#92;bin&#92;bogofilter.exe -u</SAMP></CENTER>
17508 <P>
17509 Note that the &quot;.exe&quot; extension is explicit,
17510 and that the bogofilter.exe executable should be in the same directory
17511 as cygwin1.dll.
17512
17513 <P>
17514 &lt;End of help on this topic&gt;
17515 </BODY>
17516 </HTML>
17517 ======= h_config_role_cat_status =======
17518 <HTML>
17519 <HEAD>
17520 <TITLE>Exit Status Interval Explained</TITLE>
17521 </HEAD>
17522 <BODY>
17523 <H1>Exit Status Interval Explained</H1>
17524
17525 The categorizer command is run and the result is the exit status of
17526 that command.
17527 If that exit status falls in the Exit Status Interval
17528 then it is considered a match, otherwise it is not a match.
17529 Of course for the entire rule to match, it must also be checked against
17530 the other defined parts of the Pattern.
17531 <P>
17532 The Exit Status Interval defaults to the single value 0 (zero).
17533 If you define it, it should be set to something like:
17534 <P>
17535 <CENTER><SAMP>(min_exit_value,max_exit_value)</SAMP></CENTER>
17536 <P>
17537 where &quot;min_exit_value&quot; and &quot;max_exit_value&quot; are integers.
17538 The special values &quot;INF&quot; and &quot;-INF&quot; may be used for large
17539 positive and negative integers.
17540 <P>
17541 Actually, a list of intervals may be used if you wish.
17542 A list would look like
17543 <P>
17544 <CENTER><SAMP>(min_exit_value1,max_exit_value1),(min_exit_value2,max_exit_value2),...</SAMP></CENTER>
17545 <P>
17546 When there is an Exit Status Interval defined, it is a match if the exit status
17547 of the categorizer command is contained in any of the intervals.
17548 The intervals include both endpoints.
17549 <P>
17550 The default interval is
17551 <P>
17552 <CENTER><SAMP>(0,0)</SAMP></CENTER>
17553 <P>
17554 and it matches only if the command exits with exit status equal to zero.
17555
17556 <P>
17557 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17558 for more information on Patterns.
17559 <P>
17560 Look <A HREF="h_edit_nav_cmds">here</A>
17561 to see the available Editing and Navigation commands.
17562 <P>
17563 &lt;End of help on this topic&gt;
17564 </BODY>
17565 </HTML>
17566 ======= h_config_role_cat_limit =======
17567 <HTML>
17568 <HEAD>
17569 <TITLE>Character Limit Explained</TITLE>
17570 </HEAD>
17571 <BODY>
17572 <H1>Character Limit Explained</H1>
17573
17574 Setting this option makes it possible to limit how much of the message
17575 is made available to the categorizer command as input.
17576 The default value (-1) means that the entire message is fed to the
17577 command.
17578 A value of 0 (zero) means that only the headers of the message are
17579 made available.
17580 A positive integer means that the headers plus that many characters from
17581 the body of the message are passed to the categorizer.
17582
17583 <P>
17584 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17585 for more information on Patterns.
17586 <P>
17587 Look <A HREF="h_edit_nav_cmds">here</A>
17588 to see the available Editing and Navigation commands.
17589 <P>
17590 &lt;End of help on this topic&gt;
17591 </BODY>
17592 </HTML>
17593 ======= h_config_role_age =======
17594 <HTML>
17595 <HEAD>
17596 <TITLE>Age Interval Explained</TITLE>
17597 </HEAD>
17598 <BODY>
17599 <H1>Age Interval Explained</H1>
17600
17601 The Age Interval, if defined, is part of the Pattern.
17602 If you use this, it should be set to something like:
17603 <P>
17604 <CENTER><SAMP>(min_age,max_age)</SAMP></CENTER>
17605 <P>
17606 where &quot;min_age&quot; and &quot;max_age&quot; are non-negative integers.
17607 The special value &quot;INF&quot; may be used for the max value.
17608 It represents infinity.
17609 <P>
17610 In rare cases it may be useful to use the more general form of the value,
17611 which is a comma-separated list of intervals.
17612 It would look something like:
17613 <P>
17614 <CENTER><SAMP>(min_age1,max_age1),(min_age2,max_age2),...</SAMP></CENTER>
17615 <P>
17616 When there is an Age Interval defined, it is a match if the age, in days, of
17617 the message is contained in the interval.
17618 The interval includes both endpoints.
17619 If the option is set to a list of intervals then it is a match if the
17620 age of the message is contained in any of the intervals.
17621 <P>
17622 Even though this option is called Age, it isn't actually
17623 the <EM>age</EM> of the message.
17624 Instead, it is how many days ago the message arrived in one of your folders.
17625 If the current time is a little past midnight, then a message that arrived
17626 just before midnight arrived yesterday, even though the message is only
17627 a few minutes old.
17628 By default, the date being used is not the date in the Date
17629 header of the message.
17630 It is the date that the message arrived in one of your folders.
17631 When you Save a message from one folder to another that arrival date
17632 is preserved.
17633 If you would like to use the date in the Date header that is possible.
17634 Turn on the option
17635 <A HREF="h_config_filt_opts_sentdate">&quot;Use-Date-Header-For-Age&quot;</A>
17636 near the bottom of the rule definition.
17637 <P>
17638 A value of 0 is today, 1 is yesterday, 2 is the day before yesterday, and so on.
17639 The age interval
17640 <P>
17641 <CENTER><SAMP>(2,2)</SAMP></CENTER>
17642 <P>
17643 matches all messages that arrived on the day before yesterday.
17644 The interval
17645 <P>
17646 <CENTER><SAMP>(180,INF)</SAMP></CENTER>
17647 <P>
17648 matches all messages that arrived at least 180 days before today.
17649 The interval
17650 <P>
17651 <CENTER><SAMP>(0,1)</SAMP></CENTER>
17652 <P>
17653 matches all messages that arrived today or yesterday.
17654
17655 <P>
17656 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17657 for more information on Patterns.
17658 <P>
17659 Look <A HREF="h_edit_nav_cmds">here</A>
17660 to see the available Editing and Navigation commands.
17661 <P>
17662 &lt;End of help on this topic&gt;
17663 </BODY>
17664 </HTML>
17665 ======= h_config_role_size =======
17666 <HTML>
17667 <HEAD>
17668 <TITLE>Size Interval Explained</TITLE>
17669 </HEAD>
17670 <BODY>
17671 <H1>Size Interval Explained</H1>
17672
17673 The Size Interval, if defined, is part of the Pattern.
17674 If you use this, it should be set to something like:
17675 <P>
17676 <CENTER><SAMP>(min_size,max_size)</SAMP></CENTER>
17677 <P>
17678 where &quot;min_size&quot; and &quot;max_size&quot; are non-negative integers.
17679 The special value &quot;INF&quot; may be used for the max value.
17680 It represents infinity.
17681 <P>
17682 In rare cases it may be useful to use the more general form of the value,
17683 which is a comma-separated list of intervals.
17684 It would look something like:
17685 <P>
17686 <CENTER><SAMP>(min_size1,max_size1),(min_size2,max_size2),...</SAMP></CENTER>
17687 <P>
17688 When there is a Size Interval defined, it is a match if the size of
17689 the message is contained in the interval.
17690 The interval includes both endpoints.
17691 If the option is set to a list of intervals then it is a match if the
17692 size of the message is contained in any of the intervals.
17693 <P>
17694 The size interval
17695 <P>
17696 <CENTER><SAMP>(10000,50000)</SAMP></CENTER>
17697 <P>
17698 matches all messages with sizes greater than or equal to 10000, and less
17699 than or equal to 50000.
17700 The interval
17701 <P>
17702 <CENTER><SAMP>(100000,INF)</SAMP></CENTER>
17703 <P>
17704 matches all messages with sizes greater than or equal to 100000.
17705
17706 <P>
17707 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17708 for more information on Patterns.
17709 <P>
17710 Look <A HREF="h_edit_nav_cmds">here</A>
17711 to see the available Editing and Navigation commands.
17712 <P>
17713 &lt;End of help on this topic&gt;
17714 </BODY>
17715 </HTML>
17716 ======= h_config_role_scorei =======
17717 <HTML>
17718 <HEAD>
17719 <TITLE>Score Interval Explained</TITLE>
17720 </HEAD>
17721 <BODY>
17722 <H1>Score Interval Explained</H1>
17723
17724 The Score Interval, if defined, is part of the Pattern.
17725 If you use this, it should be set to something like:
17726 <P>
17727 <CENTER><SAMP>(min_score,max_score)</SAMP></CENTER>
17728 <P>
17729 where &quot;min_score&quot; and &quot;max_score&quot; are integers between
17730 -32000 and 32000.
17731 The special values &quot;-INF&quot; and &quot;INF&quot; may be used for
17732 the min and max values.
17733 These represent negative and positive infinity.
17734 <P>
17735 Actually, the value may be a list of intervals rather than just a
17736 single interval if that is useful.
17737 The elements of the list are separated by commas like:
17738 <P>
17739 <CENTER><SAMP>(min_score1,max_score1),(min_score2,max_score2),...</SAMP></CENTER>
17740 <P>
17741 When there is a Score Interval defined, it is a match if the score for
17742 the message is contained in any of the intervals.
17743 The intervals include both endpoints.
17744 The score for a message is calculated by looking at every scoring rule
17745 defined and adding up the Score Values for the rules that match the message.
17746 Scoring rules are created using the
17747 <A HREF="h_rules_score">&quot;SETUP SCORING&quot;</A> screen.
17748
17749 <P>
17750 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17751 for more information on Patterns.
17752 <P>
17753 Look <A HREF="h_edit_nav_cmds">here</A>
17754 to see the available Editing and Navigation commands.
17755 <P>
17756 &lt;End of help on this topic&gt;
17757 </BODY>
17758 </HTML>
17759 ======= h_config_role_fldr_type =======
17760 <HTML>
17761 <HEAD>
17762 <TITLE>Current Folder Type Explained</TITLE>
17763 </HEAD>
17764 <BODY>
17765 <H1>Current Folder Type Explained</H1>
17766
17767 The Current Folder Type is part of the role's Pattern.
17768 It refers to the type of the currently open folder, which is the folder
17769 you were last looking at from the MESSAGE INDEX or MESSAGE TEXT screen.
17770 In order for a role to be considered a match, the current folder must
17771 be of the type you set here.
17772 The three types &quot;Any&quot;, &quot;News&quot;, and &quot;Email&quot; are
17773 all what you might think.
17774 <P>
17775 If the Current Folder Type for a role's Pattern is set to &quot;News&quot;, for
17776 example, then
17777 that role will only be a match if the current folder is a newsgroup and
17778 the rest of the Pattern matches.
17779 The value &quot;Specific&quot; may be used when you want to limit the match
17780 to a specific folder (not just a specific type of folder), or to a list of
17781 specific folders.
17782 <P>
17783 In order to match a specific folder you Select the &quot;Specific&quot;
17784 button <EM>AND</EM> fill in
17785 the name (or list of names) of
17786 the folder in the &quot;Folder List&quot; field.
17787 If the current folder is any of the folders in the list, that is considered
17788 a match.
17789 The name of each folder in the list may be either &quot;INBOX&quot;,
17790 the technical specification
17791 of the folder (like what appears in your configuration file) or, if the
17792 folder is one of your incoming folders, it may be the nickname you've given
17793 the folder.
17794 Here are a couple samples of specific folder names:
17795 <P>
17796 <CENTER><SAMP>{monet.art.example.com/user=vincent}mail/art-class</SAMP></CENTER>
17797 <P>
17798 <CENTER><SAMP>{news.example.com/nntp/user=peter}#news.comp.mail.pine</SAMP></CENTER>
17799 <P>
17800 Observe that in order for an external folder (IMAP, POP, News) to be a match,
17801 you must also add the /user= option in the definition of the incoming folder.
17802 <P>
17803 The easiest way to fill in the &quot;Folder List&quot; field is to use
17804 the &quot;T&quot; command that is available when the &quot;Folder List&quot; line is
17805 highlighted, or to use the &quot;Take&quot; command with the configuration
17806 feature
17807 <A HREF="h_config_enable_role_take">&quot;<!--#echo var="FEAT_enable-rules-under-take"-->&quot;</A>
17808 turned on.
17809 Note that you won't be able to edit the &quot;Folder List&quot; line unless the
17810 Current Folder Type is set to &quot;Specific&quot;, and any value that
17811 &quot;Folder List&quot; has is ignored unless the type
17812 is set to &quot;Specific&quot;.
17813 <P>
17814 When reading a newsgroup, there may be a performance penalty
17815 incurred when collecting the information necessary to check a Pattern.
17816 For this reason, the default Current Folder Type is set to &quot;Email&quot;.
17817 <P>
17818 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17819 for more information on Patterns.
17820 <P>
17821 Look <A HREF="h_edit_nav_cmds">here</A>
17822 to see the available Editing and Navigation commands.
17823 <P>
17824 &lt;End of help on this topic&gt;
17825 </BODY>
17826 </HTML>
17827 ======= h_config_filt_rule_type =======
17828 <HTML>
17829 <HEAD>
17830 <TITLE>Filter Action Explained</TITLE>
17831 </HEAD>
17832 <BODY>
17833 <H1>Filter Action Explained</H1>
17834
17835 The Filter Action specifies the action to be taken when the Pattern is a
17836 match.
17837 It may be set to &quot;Delete&quot; &quot;Move&quot;, or
17838 &quot;Just Set Message Status&quot;.
17839 <P>
17840 If it is set to &quot;Delete&quot;, then the message that matches the
17841 Pattern will be deleted from the open folder.
17842 <P>
17843 If it is set to &quot;Move&quot;, then the name of the folder to which
17844 the matching message should be moved is given in the &quot;Folder List&quot; field on the
17845 next line of the screen.
17846 A list of folders separated by commas may be given, in which case the
17847 message will be copied to all of the folders in the list before it is
17848 deleted.
17849 <P>
17850 If it is set to neither of those two values (it is set to the value
17851 labeled &quot;Just Set Message Status&quot;) then the message status
17852 setting will happen
17853 but the message will not be deleted or moved.
17854 <P>
17855 If you are Moving a message you may also set Message Status if you wish.
17856 <P>
17857 The easiest way to fill in the &quot;Folder List&quot; field is to use
17858 the T command that is available when the &quot;Folder List&quot; line is
17859 highlighted.
17860 Note that you won't be able to edit the &quot;Folder List&quot; line unless the
17861 Filter Action is set to &quot;Move&quot;, and any value that
17862 &quot;Folder List&quot; has is ignored unless the type
17863 is set to &quot;Move&quot;.
17864 <P>
17865 There are a few tokens that may be used in the names in the Folder List.
17866 They are all related to the date on which the filtering is taking place.
17867 The tokens are words surrounded by underscores.
17868 For example, if you want your filter to move messages to a folder named
17869 <P><CENTER><SAMP>abc-year-mon</SAMP></CENTER><P>
17870 you could specify the folder as
17871 <P><CENTER><SAMP>abc-_CURYEAR_-_CURMONTHABBREV_</SAMP></CENTER><P>
17872 which would result in a file named something like
17873 <P><CENTER><SAMP>abc-2004-oct</SAMP></CENTER><P>
17874 or
17875 <P><CENTER><SAMP>abc-_CURYEAR2DIGIT_-_CURMONTH2DIGIT_</SAMP></CENTER><P>
17876 which would result in a file named something like
17877 <P><CENTER><SAMP>abc-04-10</SAMP></CENTER><P>
17878 The available tokens are listed
17879 <A HREF="h_index_tokens">here</A>.
17880 <P>
17881 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17882 for more information on Patterns.
17883 <P>
17884 Look <A HREF="h_edit_nav_cmds">here</A>
17885 to see the available Editing and Navigation commands.
17886 <P>
17887 &lt;End of help on this topic&gt;
17888 </BODY>
17889 </HTML>
17890 ======= h_config_score_fldr_type =======
17891 <HTML>
17892 <HEAD>
17893 <TITLE>Current Folder Type Explained</TITLE>
17894 </HEAD>
17895 <BODY>
17896 <H1>Current Folder Type Explained</H1>
17897
17898 The Current Folder Type is part of the scoring rule's Pattern.
17899 It refers to the type of the folder that
17900 the message being scored is in.
17901 In order for a rule to be considered a match, the current folder must
17902 be of the type you set here.
17903 The three types &quot;Any&quot;, &quot;News&quot;, and &quot;Email&quot; are
17904 all what you might think.
17905 <P>
17906 If the Current Folder Type for a Pattern is set to &quot;News&quot;, for
17907 example, then
17908 that Pattern will only match if the current folder is a newsgroup and
17909 the rest of the Pattern matches.
17910 The value &quot;Specific&quot; may be used when you want to limit the match
17911 to a specific folder (not just a specific type of folder), or to a list of
17912 specific folders.
17913 <P>
17914 In order to match a specific folder you Select the &quot;Specific&quot;
17915 button <EM>AND</EM> fill in
17916 the name (or list of names) of
17917 the folder in the &quot;Folder List&quot; field.
17918 If the current folder is any of the folders in the list, that is considered
17919 a match.
17920 The name of each folder in the list may be either &quot;INBOX&quot;, the technical specification
17921 of the folder (like what appears in your configuration file) or, if the
17922 folder is one of your incoming folders, it may be the nickname you've given
17923 the folder.
17924 Here are a couple samples of specific folder names:
17925 <P>
17926 <CENTER><SAMP>{monet.art.example.com}mail/art-class</SAMP></CENTER>
17927 <P>
17928 <CENTER><SAMP>{news.example.com/nntp}#news.comp.mail.pine</SAMP></CENTER>
17929 <P>
17930 The easiest way to fill in the &quot;Folder List&quot; field is to use
17931 the T command that is available when the &quot;Folder List&quot; line is
17932 highlighted.
17933 Note that you won't be able to edit the &quot;Folder List&quot; line unless the
17934 Current Folder Type is set to &quot;Specific&quot;, and any value that
17935 &quot;Folder List&quot; has is ignored unless the type
17936 is set to &quot;Specific&quot;.
17937 <P>
17938 When reading a newsgroup, there may be a performance penalty
17939 incurred when collecting the information necessary to check a Pattern.
17940 For this reason, the default Current Folder Type is set to &quot;Email&quot;.
17941 For example, if you have Index Line Coloring rules that have Score Intervals
17942 defined then the scores for all the visible messages will need to be calculated.
17943 If some of your Scoring rules have
17944 a Current Folder Type of
17945 &quot;Any&quot; or &quot;News&quot; this may cause the MESSAGE INDEX
17946 screen to draw more slowly when in a newsgroup.
17947 <P>
17948 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
17949 for more information on Patterns.
17950 <P>
17951 Look <A HREF="h_edit_nav_cmds">here</A>
17952 to see the available Editing and Navigation commands.
17953 <P>
17954 &lt;End of help on this topic&gt;
17955 </BODY>
17956 </HTML>
17957 ======= h_config_other_fldr_type =======
17958 <HTML>
17959 <HEAD>
17960 <TITLE>Current Folder Type Explained</TITLE>
17961 </HEAD>
17962 <BODY>
17963 <H1>Current Folder Type Explained</H1>
17964
17965 The Current Folder Type is part of the rule's Pattern.
17966 It refers to the type of the folder being viewed.
17967 In order for a rule to be considered a match, the current folder must
17968 be of the type you set here.
17969 The three types &quot;Any&quot;, &quot;News&quot;, and &quot;Email&quot; are
17970 all what you might think.
17971 <P>
17972 If the Current Folder Type for a Pattern is set to &quot;News&quot;, for
17973 example, then
17974 that Pattern will only match if the current folder is a newsgroup.
17975 The value &quot;Specific&quot; may be used when you want to limit the match
17976 to a specific folder (not just a specific type of folder), or to a list of
17977 specific folders.
17978 <P>
17979 In order to match a specific folder you Select the &quot;Specific&quot;
17980 button <EM>AND</EM> fill in
17981 the name (or list of names) of
17982 the folder in the &quot;Folder List&quot; field.
17983 If the current folder is any of the folders in the list, that is considered
17984 a match.
17985 The name of each folder in the list may be either &quot;INBOX&quot;, the technical specification
17986 of the folder (like what appears in your configuration file) or, if the
17987 folder is one of your incoming folders, it may be the nickname you've given
17988 the folder.
17989 Here are a couple samples of specific folder names:
17990 <P>
17991 <CENTER><SAMP>{monet.art.example.com}mail/art-class</SAMP></CENTER>
17992 <P>
17993 <CENTER><SAMP>{news.example.com/nntp}#news.comp.mail.pine</SAMP></CENTER>
17994 <P>
17995 The easiest way to fill in the &quot;Folder List&quot; field is to use
17996 the T command that is available when the &quot;Folder List&quot; line is
17997 highlighted.
17998 Note that you won't be able to edit the &quot;Folder List&quot; line unless the
17999 Current Folder Type is set to &quot;Specific&quot;, and any value that
18000 &quot;Folder List&quot; has is ignored unless the type
18001 is set to &quot;Specific&quot;.
18002 <P>
18003 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18004 for more information on Patterns.
18005 <P>
18006 Look <A HREF="h_edit_nav_cmds">here</A>
18007 to see the available Editing and Navigation commands.
18008 <P>
18009 &lt;End of help on this topic&gt;
18010 </BODY>
18011 </HTML>
18012 ======= h_config_incol_fldr_type =======
18013 <HTML>
18014 <HEAD>
18015 <TITLE>Current Folder Type Explained</TITLE>
18016 </HEAD>
18017 <BODY>
18018 <H1>Current Folder Type Explained</H1>
18019
18020 The Current Folder Type is part of the Line Coloring rule's Pattern.
18021 It refers to the type of the folder for which the MESSAGE INDEX is
18022 being viewed.
18023 In order for a rule to be considered a match, the current folder must
18024 be of the type you set here.
18025 The three types &quot;Any&quot;, &quot;News&quot;, and &quot;Email&quot; are
18026 all what you might think.
18027 <P>
18028 If the Current Folder Type for a Pattern is set to &quot;News&quot;, for
18029 example, then
18030 that Pattern will only match if the current folder is a newsgroup and
18031 the rest of the Pattern matches.
18032 The value &quot;Specific&quot; may be used when you want to limit the match
18033 to a specific folder (not just a specific type of folder), or to a list of
18034 specific folders.
18035 <P>
18036 In order to match a specific folder you Select the &quot;Specific&quot;
18037 button <EM>AND</EM> fill in
18038 the name (or list of names) of
18039 the folder in the &quot;Folder List&quot; field.
18040 If the current folder is any of the folders in the list, that is considered
18041 a match.
18042 The name of each folder in the list may be either &quot;INBOX&quot;, the technical specification
18043 of the folder (like what appears in your configuration file) or, if the
18044 folder is one of your incoming folders, it may be the nickname you've given
18045 the folder.
18046 Here are a couple samples of specific folder names:
18047 <P>
18048 <CENTER><SAMP>{monet.art.example.com}mail/art-class</SAMP></CENTER>
18049 <P>
18050 <CENTER><SAMP>{news.example.com/nntp}#news.comp.mail.pine</SAMP></CENTER>
18051 <P>
18052 The easiest way to fill in the &quot;Folder List&quot; field is to use
18053 the T command that is available when the &quot;Folder List&quot; line is
18054 highlighted.
18055 Note that you won't be able to edit the &quot;Folder List&quot; line unless the
18056 Current Folder Type is set to &quot;Specific&quot;, and any value that
18057 &quot;Folder List&quot; has is ignored unless the type
18058 is set to &quot;Specific&quot;.
18059 <P>
18060 When reading a newsgroup, there may be a performance penalty
18061 incurred when collecting the information necessary to check a Pattern.
18062 For this reason, the default Current Folder Type is set to &quot;Email&quot;.
18063 For example, a rule with a non-Normal Index Line Color
18064 and a Current Folder Type of
18065 &quot;Any&quot; or &quot;News&quot; may cause the MESSAGE INDEX
18066 screen to draw more slowly when in a newsgroup.
18067 <P>
18068 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18069 for more information on Patterns.
18070 <P>
18071 Look <A HREF="h_edit_nav_cmds">here</A>
18072 to see the available Editing and Navigation commands.
18073 <P>
18074 &lt;End of help on this topic&gt;
18075 </BODY>
18076 </HTML>
18077 ======= h_config_filt_fldr_type =======
18078 <HTML>
18079 <HEAD>
18080 <TITLE>Current Folder Type Explained</TITLE>
18081 </HEAD>
18082 <BODY>
18083 <H1>Current Folder Type Explained</H1>
18084
18085 The Current Folder Type is part of the Filtering rule's Pattern.
18086 It refers to the type of the folder for which the filtering is being done.
18087 In order for a rule to be considered a match, the current folder must
18088 be of the type you set here.
18089 The three types &quot;Any&quot;, &quot;News&quot;, and &quot;Email&quot; are
18090 all what you might think.
18091 <P>
18092 If the Current Folder Type for a Pattern is set to &quot;News&quot;, for
18093 example, then
18094 that Pattern will only match if the current folder is a newsgroup and
18095 the rest of the Pattern matches.
18096 The value &quot;Specific&quot; may be used when you want to limit the match
18097 to a specific folder (not just a specific type of folder), or to a list of
18098 specific folders.
18099 <P>
18100 In order to match a specific folder you Select the &quot;Specific&quot;
18101 button <EM>AND</EM> fill in
18102 the name (or list of names) of
18103 the folder in the &quot;Folder List&quot; field.
18104 If the current folder is any of the folders in the list, that is considered
18105 a match.
18106 The name of each folder in the list may be either &quot;INBOX&quot;, the technical specification
18107 of the folder (like what appears in your configuration file) or, if the
18108 folder is one of your incoming folders, it may be the nickname you've given
18109 the folder.
18110 Here are a couple samples of specific folder names:
18111 <P>
18112 <CENTER><SAMP>{monet.art.example.com}mail/art-class</SAMP></CENTER>
18113 <P>
18114 <CENTER><SAMP>{news.example.com/nntp}#news.comp.mail.pine</SAMP></CENTER>
18115 <P>
18116 The easiest way to fill in the &quot;Folder List&quot; field is to use
18117 the T command that is available when the &quot;Folder List&quot; line is
18118 highlighted.
18119 Note that you won't be able to edit the &quot;Folder List&quot; line unless the
18120 Current Folder Type is set to &quot;Specific&quot;, and any value that
18121 &quot;Folder List&quot; has is ignored unless the type
18122 is set to &quot;Specific&quot;.
18123 <P>
18124 When reading a newsgroup, there may be a performance penalty
18125 incurred when collecting the information necessary to check a Pattern.
18126 For this reason, the default Current Folder Type is set to &quot;Email&quot;.
18127 For example, a rule with a Current Folder Type of either
18128 &quot;Any&quot; or &quot;News&quot; may cause the filtering to happen
18129 more slowly when opening a newsgroup.
18130 <P>
18131 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18132 for more information on Patterns.
18133 <P>
18134 Look <A HREF="h_edit_nav_cmds">here</A>
18135 to see the available Editing and Navigation commands.
18136 <P>
18137 &lt;End of help on this topic&gt;
18138 </BODY>
18139 </HTML>
18140 ======= h_config_role_stat_imp =======
18141 <HTML>
18142 <HEAD>
18143 <TITLE>Message Important Status Explained</TITLE>
18144 </HEAD>
18145 <BODY>
18146 <H1>Message Important Status Explained</H1>
18147
18148 This part of the Pattern may have one of three possible values.
18149 The default value is &quot;Don't care&quot;, which matches any message.
18150 The other two values are &quot;Yes&quot;, which means the message must be
18151 flagged &quot;Important&quot; in order to be a match; or &quot;No&quot;, which
18152 means the message must <EM>not</EM> be flagged &quot;Important&quot; in order
18153 to be a match.
18154 <P>
18155 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18156 for more information on Patterns.
18157 <P>
18158 Look <A HREF="h_edit_nav_cmds">here</A>
18159 to see the available Editing and Navigation commands.
18160 <P>
18161 &lt;End of help on this topic&gt;
18162 </BODY>
18163 </HTML>
18164 ======= h_config_role_stat_new =======
18165 <HTML>
18166 <HEAD>
18167 <TITLE>Message New Status Explained</TITLE>
18168 </HEAD>
18169 <BODY>
18170 <H1>Message New Status Explained</H1>
18171
18172 This part of the Pattern may have one of three possible values.
18173 The default value is &quot;Don't care&quot;, which matches any message.
18174 The other two values are &quot;Yes&quot;, which means the message must be
18175 &quot;New&quot; in order to be a match; or &quot;No&quot;, which
18176 means the message must <EM>not</EM> be &quot;New&quot; in order
18177 to be a match.
18178 &quot;New&quot; is the same as <EM>Unseen</EM> and not &quot;New&quot; is the
18179 same as <EM>Seen</EM>.
18180 <P>
18181 The nomenclature for New and Recent is a bit confusing:
18182 <P>
18183 New means that the message is Unseen.
18184 It could have been in your mailbox for a long time but if you haven't looked
18185 at it, it is still considered New.
18186 That matches the default Alpine index display that shows an N for such a
18187 message.
18188 <P>
18189 Recent means that the message was added to this folder since the last time
18190 you opened the folder.
18191 Alpine also shows an N by default for these types of messages.
18192 If you were to run two copies of Alpine that opened a folder one right after
18193 the other, a message would only show up as Recent in (at most) the first
18194 Alpine session.
18195 <P>
18196 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18197 for more information on Patterns.
18198 <P>
18199 Look <A HREF="h_edit_nav_cmds">here</A>
18200 to see the available Editing and Navigation commands.
18201 <P>
18202 &lt;End of help on this topic&gt;
18203 </BODY>
18204 </HTML>
18205 ======= h_config_role_stat_recent =======
18206 <HTML>
18207 <HEAD>
18208 <TITLE>Message Recent Status Explained</TITLE>
18209 </HEAD>
18210 <BODY>
18211 <H1>Message Recent Status Explained</H1>
18212
18213 This part of the Pattern may have one of three possible values.
18214 The default value is &quot;Don't care&quot;, which matches any message.
18215 The other two values are &quot;Yes&quot;, which means the message must be
18216 &quot;Recent&quot; in order to be a match; or &quot;No&quot;, which
18217 means the message must <EM>not</EM> be &quot;Recent&quot; in order
18218 to be a match.
18219 &quot;Recent&quot; means that the message was added to the folder since
18220 the last time the folder was opened.
18221 If more than one mail client has the folder opened, the message will
18222 appear to be &quot;Recent&quot; to only one of the clients.
18223 <P>
18224 The nomenclature for New and Recent is a bit confusing:
18225 <P>
18226 New means that the message is Unseen.
18227 It could have been in your mailbox for a long time but if you haven't looked
18228 at it, it is still considered New.
18229 That matches the default Alpine index display that shows an N for such a
18230 message.
18231 <P>
18232 Recent means that the message was added to this folder since the last time
18233 you opened the folder.
18234 Alpine also shows an N by default for these types of messages.
18235 If you were to run two copies of Alpine that opened a folder one right after
18236 the other, a message would only show up as Recent in (at most) the first
18237 Alpine session.
18238 <P>
18239 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18240 for more information on Patterns.
18241 <P>
18242 Look <A HREF="h_edit_nav_cmds">here</A>
18243 to see the available Editing and Navigation commands.
18244 <P>
18245 &lt;End of help on this topic&gt;
18246 </BODY>
18247 </HTML>
18248 ======= h_config_role_stat_del =======
18249 <HTML>
18250 <HEAD>
18251 <TITLE>Message Deleted Status Explained</TITLE>
18252 </HEAD>
18253 <BODY>
18254 <H1>Message Deleted Status Explained</H1>
18255
18256 This part of the Pattern may have one of three possible values.
18257 The default value is &quot;Don't care&quot;, which matches any message.
18258 The other two values are &quot;Yes&quot;, which means the message must be
18259 marked &quot;Deleted&quot; in order to be a match; or &quot;No&quot;, which
18260 means the message must <EM>not</EM> be marked &quot;Deleted&quot; in order
18261 to be a match.
18262 <P>
18263 If you are thinking of using this part of the Pattern as a way to prevent
18264 messages from being filtered more than once in a Filter Pattern,
18265 take a look at the Filter Option
18266 <A HREF="h_config_filt_opts_notdel">&quot;Move-Only-if-Not-Deleted&quot;</A>
18267 instead.
18268 It should work better than using this field since it will hide the filtered
18269 messages even if they are already Deleted.
18270 That option is at the bottom of the Filter configuration screen.
18271 <P>
18272 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18273 for more information on Patterns.
18274 <P>
18275 Look <A HREF="h_edit_nav_cmds">here</A>
18276 to see the available Editing and Navigation commands.
18277 <P>
18278 &lt;End of help on this topic&gt;
18279 </BODY>
18280 </HTML>
18281 ======= h_config_role_stat_ans =======
18282 <HTML>
18283 <HEAD>
18284 <TITLE>Message Answered Status Explained</TITLE>
18285 </HEAD>
18286 <BODY>
18287 <H1>Message Answered Status Explained</H1>
18288
18289 This part of the Pattern may have one of three possible values.
18290 The default value is &quot;Don't care&quot;, which matches any message.
18291 The other two values are &quot;Yes&quot;, which means the message must be
18292 marked &quot;Answered&quot; in order to be a match; or &quot;No&quot;, which
18293 means the message must <EM>not</EM> be marked &quot;Answered&quot; in order
18294 to be a match.
18295 <P>
18296 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18297 for more information on Patterns.
18298 <P>
18299 Look <A HREF="h_edit_nav_cmds">here</A>
18300 to see the available Editing and Navigation commands.
18301 <P>
18302 &lt;End of help on this topic&gt;
18303 </BODY>
18304 </HTML>
18305 ======= h_config_role_abookfrom =======
18306 <HTML>
18307 <HEAD>
18308 <TITLE>Address in Address Book Explained</TITLE>
18309 </HEAD>
18310 <BODY>
18311 <H1>Address in Address Book Explained</H1>
18312
18313 This option gives you a way to match messages that contain an address
18314 that is in one of your address books.
18315 Only the simple entries in your address books are searched.
18316 Address book distribution lists are ignored!
18317 <P>
18318 This part of the Pattern may have one of five possible values.
18319 The default value is &quot;Don't care&quot;, which matches any message.
18320 The value &quot;Yes, in any address book&quot; means at least one of the addresses
18321 from the message must be in at least one of your
18322 address books in order to be a match.
18323 The value &quot;No, not in any address book&quot;
18324 means none of the addresses may
18325 be in any of your address books in order to be a match.
18326 <P>
18327 The values &quot;Yes, in specific address books&quot; and
18328 &quot;No, not in any of specific address books&quot; are similar but instead
18329 of depending on all address books you are allowed to give a list of address
18330 books to look in.
18331 Usually this would be a single address book but it may be a
18332 list of address books as well.
18333 For each of these &quot;specific&quot; address book options you Select which
18334 of the Specific options you want (Yes or No) <EM>AND</EM> fill in the
18335 name (or list of names) of the address book in the
18336 &quot;Abook List&quot; field.
18337 The names to be used are those that appear in the ADDRESS BOOK LIST screen.
18338 The easiest way to fill in the Abook List field it to use
18339 the &quot;T&quot; command that is available when the &quot;Abook List&quot;
18340 line is highlighted.
18341 Note that you won't be able to edit the &quot;Abook List&quot; line unless the
18342 option is set to one of the two &quot;Specific&quot;, values.
18343 <P>
18344 The addresses from the message that are checked for are determined by the
18345 setting you have for &quot;Types of addresses to check for in address book&quot;.
18346 If you set this to &quot;From&quot; the From address from the message will
18347 be looked up in the address book.
18348 If you set it to &quot;To&quot; instead then the To addresses will be used.
18349 If any of the To addresses are in the address book then it is considered
18350 a match for &quot;Yes&quot; or not a match for &quot;No&quot;.
18351 You could set it to both From and To, in which case all of the From and To
18352 addresses are used.
18353 The &quot;Reply-To&quot; and &quot;Sender&quot; cases are a little unusual.
18354 Due to deficiencies in our tools, Reply-To uses the Reply-To address if it
18355 exists or the From address if there is no Reply-To address.
18356 Same for the Sender address.
18357 <P>
18358 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18359 for more information on Patterns.
18360 <P>
18361 Look <A HREF="h_edit_nav_cmds">here</A>
18362 to see the available Editing and Navigation commands.
18363 <P>
18364 &lt;End of help on this topic&gt;
18365 </BODY>
18366 </HTML>
18367 ======= h_config_inabook_from =======
18368 <HTML>
18369 <HEAD>
18370 <TITLE>From</TITLE>
18371 </HEAD>
18372 <BODY>
18373 <H1>From</H1>
18374
18375 Setting the From line will cause the address from the From header line
18376 of the message to be checked for in the address book.
18377 <P>
18378 &lt;End of help on this topic&gt;
18379 </BODY>
18380 </HTML>
18381 ======= h_config_inabook_replyto =======
18382 <HTML>
18383 <HEAD>
18384 <TITLE>Reply-To</TITLE>
18385 </HEAD>
18386 <BODY>
18387 <H1>Reply-To</H1>
18388
18389 Setting the Reply-To line will cause the address from the Reply-To header line
18390 of the message to be checked for in the address book.
18391 However, if there is no Reply-To header line in the message the From header
18392 line will be used instead.
18393 We understand this is dumb but we don't have an easy way around it.
18394 <P>
18395 &lt;End of help on this topic&gt;
18396 </BODY>
18397 </HTML>
18398 ======= h_config_inabook_sender =======
18399 <HTML>
18400 <HEAD>
18401 <TITLE>Sender</TITLE>
18402 </HEAD>
18403 <BODY>
18404 <H1>Sender</H1>
18405
18406 Setting the Sender line will cause the address from the Sender header line
18407 of the message to be checked for in the address book.
18408 However, if there is no Sender header line in the message the From header
18409 line will be used instead.
18410 We understand this is dumb but we don't have an easy way around it.
18411 <P>
18412 &lt;End of help on this topic&gt;
18413 </BODY>
18414 </HTML>
18415 ======= h_config_inabook_to =======
18416 <HTML>
18417 <HEAD>
18418 <TITLE>To</TITLE>
18419 </HEAD>
18420 <BODY>
18421 <H1>To</H1>
18422
18423 Setting the To line will cause the address from the To header line
18424 of the message to be checked for in the address book.
18425 <P>
18426 &lt;End of help on this topic&gt;
18427 </BODY>
18428 </HTML>
18429 ======= h_config_inabook_cc =======
18430 <HTML>
18431 <HEAD>
18432 <TITLE>CC</TITLE>
18433 </HEAD>
18434 <BODY>
18435 <H1>CC</H1>
18436
18437 Setting the CC line will cause the address from the CC header line
18438 of the message to be checked for in the address book.
18439 <P>
18440 &lt;End of help on this topic&gt;
18441 </BODY>
18442 </HTML>
18443 ======= h_config_role_stat_8bitsubj =======
18444 <HTML>
18445 <HEAD>
18446 <TITLE>Raw 8-bit in Subject Explained</TITLE>
18447 </HEAD>
18448 <BODY>
18449 <H1>Raw 8-bit in Subject Explained</H1>
18450
18451 It seems that lots of unwanted email contains unencoded 8-bit characters
18452 in the Subject.
18453 Normally, characters with the 8th bit set are not allowed in the Subject
18454 header unless they are MIME-encoded.
18455 This option gives you a way to match messages that have Subjects that
18456 contain unencoded 8-bit characters.
18457 <P>
18458 This part of the Pattern may have one of three possible values.
18459 The default value is &quot;Don't care&quot;, which matches any message.
18460 The other two values are &quot;Yes&quot;, which means the Subject of
18461 the message must contain unencoded 8-bit characters (characters with the
18462 most significant bit set)
18463 in order to be a match; or &quot;No&quot;, which
18464 means the Subject must <EM>not</EM>
18465 contain unencoded 8-bit characters in order to be a match.
18466 <P>
18467 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18468 for more information on Patterns.
18469 <P>
18470 Look <A HREF="h_edit_nav_cmds">here</A>
18471 to see the available Editing and Navigation commands.
18472 <P>
18473 &lt;End of help on this topic&gt;
18474 </BODY>
18475 </HTML>
18476 ======= h_config_role_bom =======
18477 <HTML>
18478 <HEAD>
18479 <TITLE>Beginning of Month</TITLE>
18480 </HEAD>
18481 <BODY>
18482 <H1>Beginning of Month</H1>
18483
18484 This option gives you a limited ability to take different actions depending on whether
18485 this is the first time Alpine has been run this month or not.
18486 Though it would be nice to have such an option available, this is not the
18487 same as whether or not this is the first time a paricular folder has been
18488 opened this month.
18489 If you want some action (probably Filtering) to take place in a folder each
18490 month, then you will need to be sure that the folder is opened during the
18491 first Alpine session of the month in order for this option to be helpful.
18492 <P>
18493 This part of the Pattern may have one of three possible values.
18494 The default value is &quot;Don't care&quot;, which matches any message.
18495 The other two values are &quot;Yes&quot;, which means this is the first
18496 time Alpine has been run this month;
18497 or &quot;No&quot;, which
18498 means this is not the first time Alpine has been run this month.
18499 <P>
18500 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18501 for more information on Patterns.
18502 <P>
18503 Here are some technical details.
18504 The way that Alpine decides if it is the beginning of the month or not is
18505 to compare today's date with the date stored in the
18506 <A HREF="h_config_prune_date"><!--#echo var="VAR_last-time-prune-questioned"--></A>
18507 variable in the config file.
18508 If the month of today's date is later than the month stored in the variable,
18509 then this is considered to be the first time you have run Alpine this month, and
18510 that turns the Beginning of the Month option on.
18511 <P>
18512 Look <A HREF="h_edit_nav_cmds">here</A>
18513 to see the available Editing and Navigation commands.
18514 <P>
18515 &lt;End of help on this topic&gt;
18516 </BODY>
18517 </HTML>
18518 ======= h_config_role_boy =======
18519 <HTML>
18520 <HEAD>
18521 <TITLE>Beginning of Year</TITLE>
18522 </HEAD>
18523 <BODY>
18524 <H1>Beginning of Year</H1>
18525
18526 This option gives you a limited ability to take different actions depending on whether
18527 this is the first time Alpine has been run this year or not.
18528 Though it would be nice to have such an option available, this is not the
18529 same as whether or not this is the first time a paricular folder has been
18530 opened this year.
18531 If you want some action (probably Filtering) to take place in a folder each
18532 year, then you will need to be sure that the folder is opened during the
18533 first Alpine session of the year in order for this option to be helpful.
18534 <P>
18535 This part of the Pattern may have one of three possible values.
18536 The default value is &quot;Don't care&quot;, which matches any message.
18537 The other two values are &quot;Yes&quot;, which means this is the first
18538 time Alpine has been run this year;
18539 or &quot;No&quot;, which
18540 means this is not the first time Alpine has been run this year.
18541 <P>
18542 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
18543 for more information on Patterns.
18544 <P>
18545 Here are some technical details.
18546 The way that Alpine decides if it is the beginning of the year or not is
18547 to compare today's date with the date stored in the
18548 <A HREF="h_config_prune_date"><!--#echo var="VAR_last-time-prune-questioned"--></A>
18549 variable in the config file.
18550 If the year of today's date is later than the year stored in the variable,
18551 then this is considered to be the first time you have run Alpine this year, and
18552 that turns the Beginning of the Year option on.
18553 <P>
18554 Look <A HREF="h_edit_nav_cmds">here</A>
18555 to see the available Editing and Navigation commands.
18556 <P>
18557 &lt;End of help on this topic&gt;
18558 </BODY>
18559 </HTML>
18560 ======= h_config_role_inick =======
18561 <HTML>
18562 <HEAD>
18563 <TITLE>Initialize Values From Role Explained</TITLE>
18564 </HEAD>
18565 <BODY>
18566 <H1>Initialize Values From Role Explained</H1>
18567
18568 This is a power user feature.
18569 You will usually want to leave this field empty.
18570 The value of this field is the nickname of another one of your roles.
18571 The Action values from that other role
18572 are used as the initial values of the Action items for this role.
18573 If you put something in any of the action fields for this role, that will
18574 override whatever was in the corresponding field of the initializer role.
18575 <P>
18576 You might use this field if the &quot;Action&quot; part of one of your roles
18577 is something you want to use in more than one role.
18578 Instead of filling in those action values again for each role, you
18579 may give the nickname of the role where the values are filled in.
18580 It's just a shortcut way to define Role Actions.
18581 <P>
18582 Here's an example to help explain how this works.
18583 Suppose you have a role with nickname &quot;role1&quot; and role1 has
18584 (among other things)
18585 <P>
18586 <CENTER><SAMP>Set Reply-To = The Pres &lt;president@example.com&gt;</SAMP></CENTER>
18587 <P>
18588 set.
18589 If in &quot;role2&quot; you set &quot;Initialize settings using role&quot; to
18590 &quot;role1&quot;, then role2 will inherit the Set Reply-To value
18591 from role1 by default (and any of the other inheritable action values
18592 that are set).
18593 So if role2 had
18594 <P>
18595 <CENTER><SAMP>Set Reply-To = &lt;No Value Set&gt;</SAMP></CENTER>
18596 <P>
18597 defined, the Reply-To used with role2 would be &quot;The Pres &lt;president@example.com&gt;&quot;
18598 However, if role2 had
18599 <P>
18600 <CENTER><SAMP>Set Reply-To = VP &lt;vicepresident@example.com&gt;</SAMP></CENTER>
18601 <P>
18602 defined, then the Reply-To used with role2 would be &quot;VP &lt;vicepresident@example.com&gt;&quot; instead.
18603 <P>
18604 If you wish,
18605 you may choose a nickname from your list of roles by using the
18606 &quot;T&quot; command.
18607 If the role you are using to initialize also has a role it initializes from,
18608 then that initialization happens first.
18609 That is, inheritance works as expected with the grandparent and
18610 great-grandparent (and so on) roles having the expected effect.
18611 <P>
18612 Look <A HREF="h_edit_nav_cmds">here</A>
18613 to see the available Editing and Navigation commands.
18614 <P>
18615 &lt;End of help on this topic&gt;
18616 </BODY>
18617 </HTML>
18618 ======= h_config_role_setfrom =======
18619 <HTML>
18620 <HEAD>
18621 <TITLE>Set From Explained</TITLE>
18622 </HEAD>
18623 <BODY>
18624 <H1>Set From Explained</H1>
18625
18626 This describes part of the action to be taken if the Pattern for this
18627 role is a match.
18628 This field consists of a single address that will be used as the From
18629 address on the message you are sending.
18630 This should be a fully-qualified address like
18631 <P>
18632 <CENTER><SAMP>Full Name &lt;user@domain&gt;</SAMP></CENTER>
18633 <P>
18634 or just
18635 <P>
18636 <CENTER><SAMP>user@domain</SAMP></CENTER>
18637 <P>
18638 If you wish,
18639 you may choose an address from your address book with the
18640 &quot;T&quot; command.
18641 <P>
18642 If this is left blank, then your normal From address will be used.
18643 <P>
18644 You may also find it useful to add the changed From address to the
18645 <a href="h_config_alt_addresses"><!--#echo var="VAR_alt-addresses"--></a>
18646 configuration option.
18647 <P>
18648 Look <A HREF="h_edit_nav_cmds">here</A>
18649 to see the available Editing and Navigation commands.
18650 <P>
18651 &lt;End of help on this topic&gt;
18652 </BODY>
18653 </HTML>
18654 ======= h_config_role_setreplyto =======
18655 <HTML>
18656 <HEAD>
18657 <TITLE>Set Reply-To Explained</TITLE>
18658 </HEAD>
18659 <BODY>
18660 <H1>Set Reply-To Explained</H1>
18661
18662 This describes part of the action to be taken if the Pattern for this
18663 role is a match.
18664 This field consists of a single address that will be used as the Reply-To
18665 address on the message you are sending.
18666 This may be a fully-qualified address like
18667 <P>
18668 <CENTER><SAMP>Full Name &lt;user@domain&gt;</SAMP></CENTER>
18669 <P>
18670 or just
18671 <P>
18672 <CENTER><SAMP>user@domain</SAMP></CENTER>
18673 <P>
18674 If you wish,
18675 you may choose an address from your address book with the
18676 &quot;T&quot; command.
18677 <P>
18678 If this is left blank, then there won't be a Reply-To address unless
18679 you have configured one specially with the
18680 "<A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A>"
18681 configuration option.
18682 <P>
18683 Look <A HREF="h_edit_nav_cmds">here</A>
18684 to see the available Editing and Navigation commands.
18685 <P>
18686 &lt;End of help on this topic&gt;
18687 </BODY>
18688 </HTML>
18689 ======= h_config_role_setfcc =======
18690 <HTML>
18691 <HEAD>
18692 <TITLE>Set Fcc Explained</TITLE>
18693 </HEAD>
18694 <BODY>
18695 <H1>Set Fcc Explained</H1>
18696
18697 This describes part of the action to be taken if the Pattern for this
18698 role is a match.
18699 This field consists of a single folder name that will be used in
18700 the Fcc field of the message you are sending.
18701 You may put anything here that you would normally type into the Fcc
18702 field from the composer.
18703 <P>
18704 In addition, an fcc of &quot;&quot; (two double quotation marks) means
18705 no Fcc.
18706 <P>
18707 A blank field here means that Alpine will use its normal rules for deciding
18708 the default value of the Fcc field.
18709 For many roles, perhaps most, it may make more sense for you to use the
18710 other Alpine facilities for setting the Fcc.
18711 In particular, if you want the Fcc to depend on who you are sending the
18712 message to then the <A HREF="h_config_fcc_rule">&quot;<!--#echo var="VAR_fcc-name-rule"-->&quot;</A>
18713 is probably more useful.
18714 In that case, you would want to leave the Fcc field here blank.
18715 However, if you have a role that depends on who the message you are replying
18716 to was From, or what address that message was sent to;
18717 then it might make sense to set the Fcc for that role here.
18718 <P>
18719 If you wish,
18720 you may choose a folder from your folder collections by using the
18721 &quot;T&quot; command.
18722 <P>
18723 Look <A HREF="h_edit_nav_cmds">here</A>
18724 to see the available Editing and Navigation commands.
18725 <P>
18726 &lt;End of help on this topic&gt;
18727 </BODY>
18728 </HTML>
18729 ======= h_config_role_usesmtp =======
18730 <HTML>
18731 <HEAD>
18732 <TITLE>Use SMTP Server Explained</TITLE>
18733 </HEAD>
18734 <BODY>
18735 <H1>Use SMTP Server Explained</H1>
18736
18737 This describes part of the action to be taken if the Pattern for this
18738 role is a match.
18739 If this field has a value, then it will be used as the SMTP server
18740 to send mail when this role is being used (unless the SMTP server variable
18741 is set in the system-wide fixed configuration file).
18742 It has the same semantics as the
18743 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>
18744 variable in the Setup/Config screen.
18745 <P>
18746 If you are using this to post from home when you are at home and from
18747 work when you are at work you need to be careful about postponing messages.
18748 When you postpone a composition that was using a role with this variable
18749 set, the SMTP server list will be saved
18750 with the postponed composition.
18751 It cannot be changed later.
18752 Because of this, you may want to make this a list of SMTP servers
18753 with the preferred server at the front of the list and alternate servers
18754 later in the list.
18755 In your &quot;Home&quot; role you would put the home SMTP server first and
18756 the work SMTP server last.
18757 In your &quot;Work&quot; role you would put the work SMTP server first and
18758 the home SMTP server last.
18759 Then if you start a composition as &quot;Work&quot;, postpone
18760 it, and then later resume it from home the work SMTP server will fail but
18761 the home SMTP server later in the list will succeed.
18762 <P>
18763 You may be able to simplify things by making the regular
18764 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>
18765 variable in the Setup/Config screen a list instead of using roles
18766 to set the SMTP server.
18767
18768 <P>
18769 Look <A HREF="h_edit_nav_cmds">here</A>
18770 to see the available Editing and Navigation commands.
18771 <P>
18772 &lt;End of help on this topic&gt;
18773 </BODY>
18774 </HTML>
18775 ======= h_config_role_usenntp =======
18776 <HTML>
18777 <HEAD>
18778 <TITLE>Use NNTP Server Explained</TITLE>
18779 </HEAD>
18780 <BODY>
18781 <H1>Use NNTP Server Explained</H1>
18782
18783 This describes part of the action to be taken if the Pattern for this
18784 role is a match.
18785 If this field has a value, then it will be used as the NNTP server
18786 to post to newsgroups when this role is being used (unless the NNTP server
18787 variable
18788 is set in the system-wide fixed configuration file).
18789 It has the same semantics as the
18790 <A HREF="h_config_nntp_server">&quot;<!--#echo var="VAR_nntp-server"-->&quot;</A>
18791 variable in the Setup/Config screen.
18792 <P>
18793 This role setting can facilitate posting to the right nntp server for someone
18794 who reads news from various news sources.  The feature
18795 <A HREF="h_config_predict_nntp_server">&quot;<!--#echo var="FEAT_predict-nntp-server"-->&quot;</A>
18796 allows for setting the correct <!--#echo var="VAR_nntp-server"--> without having to individually
18797 set a role for that <!--#echo var="VAR_nntp-server"-->, but for greater flexibility, setting
18798 nntp servers for roles may be more desirable for some people.
18799 <P>
18800 If you are using this to post from home when you are at home and from
18801 work when you are at work you need to be careful about postponing messages.
18802 When you postpone a composition that was using a role with this variable
18803 set, the NNTP server list will be saved
18804 with the postponed composition.
18805 It cannot be changed later.
18806 Because of this, you may want to make this a list of NNTP servers
18807 with the preferred server at the front of the list and alternate servers
18808 later in the list.
18809 In your &quot;Home&quot; role you would put the home NNTP server first and
18810 the work NNTP server last.
18811 In your &quot;Work&quot; role you would put the work NNTP server first and
18812 the home NNTP server last.
18813 Then if you start a composition as &quot;Work&quot;, postpone
18814 it, and then later resume it from home the work NNTP server will fail but
18815 the home NNTP server later in the list will succeed.
18816 <P>
18817 You may be able to simplify things by making the regular
18818 <A HREF="h_config_nntp_server">&quot;<!--#echo var="VAR_nntp-server"-->&quot;</A>
18819 variable in the Setup/Config screen a list instead of using roles
18820 to set the NNTP server.
18821
18822 <P>
18823 Look <A HREF="h_edit_nav_cmds">here</A>
18824 to see the available Editing and Navigation commands.
18825 <P>
18826 &lt;End of help on this topic&gt;
18827 </BODY>
18828 </HTML>
18829 ======= h_config_role_setotherhdr =======
18830 <HTML>
18831 <HEAD>
18832 <TITLE>Set Other Headers Explained</TITLE>
18833 </HEAD>
18834 <BODY>
18835 <H1>Set Other Headers Explained</H1>
18836
18837 This describes part of the action to be taken if the Pattern for this
18838 role is a match.
18839 This field gives you a way to set values for headers besides
18840 &quot;From&quot; and &quot;Reply-To&quot;.
18841 If you want to set either of those, use the specific
18842 &quot;Set From&quot; and &quot;Set Reply-To&quot; settings above.
18843 <P>
18844 This field is similar to the
18845 "<A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A>" option.
18846 Each header you specify here must include the header tag
18847 (&quot;To:&quot;, &quot;Approved:&quot;, etc.)
18848 and may optionally include a value for that header.
18849 In order to see these headers when you compose using this role you
18850 must use the rich header
18851 <!--chtml if pinemode="function_key"-->(F5)
18852 <!--chtml else-->(Ctrl-R)<!--chtml endif--> command.
18853 Here's an example that shows how you might set the To address.
18854 <P>
18855 <CENTER><SAMP>Set Other Hdrs = To: Full Name &lt;user@domain&gt;</SAMP></CENTER>
18856 <P>
18857 Headers set in this way are different from headers set with the
18858 <!--#echo var="VAR_customized-hdrs"--> option in that the value you give for a header here
18859 will replace any value that already exists.
18860 For example, if you are Replying to a message there will already be at
18861 least one address in the To header (the address you are Replying to).
18862 However, if you Reply using a role that sets the To header, that role's
18863 To header value will be used instead.
18864 <P>
18865 Limitation: Because commas are used to separate the list of
18866 Other Headers, it is not possible to have the value of a
18867 header contain a comma;
18868 nor is there currently an &quot;escape&quot; mechanism provided
18869 to make this work.
18870 <P>
18871 Look <A HREF="h_edit_nav_cmds">here</A>
18872 to see the available Editing and Navigation commands.
18873 <P>
18874 &lt;End of help on this topic&gt;
18875 </BODY>
18876 </HTML>
18877 ======= h_config_role_setlitsig =======
18878 <HTML>
18879 <HEAD>
18880 <TITLE>Set Literal Signature Explained</TITLE>
18881 </HEAD>
18882 <BODY>
18883 <H1>Set Literal Signature Explained</H1>
18884
18885 This describes part of the action to be taken if the Pattern for this
18886 role is a match.
18887 This field contains the actual text for your signature, as opposed to
18888 the name of a file containing your signature.
18889 If this is defined it takes precedence over any value set in the
18890 &quot;Set Signature&quot; field.
18891 <P>
18892 This is simply a different way to store the signature.
18893 The signature is stored inside your Alpine configuration file instead of in
18894 a separate file.
18895 Tokens work the same way they do with
18896 <A HREF="h_config_role_setsig">Set Signature</A>, so refer to the
18897 help text there for more information.
18898 <P>
18899
18900 The two character sequence &#92;n (backslash followed by
18901 the character n) will be used to signify a line-break in your signature.
18902 You don't have to enter the &#92;n, but it will be visible in the
18903 CHANGE THIS ROLE RULE window after you are done editing the signature.
18904 <P>
18905 Look <A HREF="h_edit_nav_cmds">here</A>
18906 to see the available Editing and Navigation commands.
18907 <P>
18908 &lt;End of help on this topic&gt;
18909 </BODY>
18910 </HTML>
18911 ======= h_config_role_setsig =======
18912 <HTML>
18913 <HEAD>
18914 <TITLE>Set Signature Explained</TITLE>
18915 </HEAD>
18916 <BODY>
18917 <H1>Set Signature Explained</H1>
18918
18919 This describes part of the action to be taken if the Pattern for this
18920 role is a match.
18921 <P>
18922 If either the default <A HREF="h_config_literal_sig"><!--#echo var="VAR_literal-signature"--></A>
18923 option from Setup/Config
18924 or the &quot;Set LiteralSig&quot; option for this role are defined,
18925 then this option will be ignored.
18926 You can tell that that is the case because the value of this
18927 option will show up as
18928 <P>
18929 <CENTER><SAMP>&lt;Ignored: using LiteralSig instead&gt;</SAMP></CENTER>
18930 <P>
18931 You may either use all Literal Signatures (signatures stored in your
18932 configuration file) throughout Alpine, or all signature files.
18933 You can't mix the two.
18934 <P>
18935 This field consists of a filename that will be used as the signature
18936 file when using this role.
18937 <P>
18938 If the filename is followed by a vertical bar (|) then instead
18939 of reading the contents of the file the file is assumed to be a
18940 program that will produce the text to be used on its standard output.
18941 The program can't have any arguments and doesn't receive any input from Alpine,
18942 but the rest of the processing works as if the contents came from a file.
18943 <P>
18944 Instead of storing the data in a local file, the
18945 signature data may be stored remotely in an IMAP folder.
18946 In order to do this,
18947 you must use a remote name for the signature.
18948 A remote signature name might look like:
18949 <P>
18950 <CENTER><SAMP>{myimaphost.myschool.k12.wa.us}mail/sig3</SAMP></CENTER>
18951 <P>
18952
18953 The syntax used here is the same as the syntax used for a remote
18954 <A HREF="h_config_signature_file"><!--#echo var="VAR_signature-file"--></A>.
18955 Note that you may not access an existing signature file remotely,
18956 you have to create a new <EM>folder</EM> that contains the signature data.
18957 If the name you use here for the signature data is a remote name, then when
18958 you edit the file using the &quot;F&quot; command the data will
18959 be saved remotely in the folder.
18960 You aren't required to do anything special to create the folder, it
18961 gets created if you use a remote name.
18962
18963 <P>
18964 If you type &quot;F&quot; you may edit the contents of the file (as opposed to
18965 the name of the file) you have specified.
18966 If you type &quot;T&quot; you may use a browser to choose an existing filename.
18967 <P>
18968 Besides containing regular text, a signature file may also
18969 contain (or a signature program may produce) tokens that are replaced with text
18970 that depends on the message you are replying to or forwarding.
18971 The tokens all look like _word_ (a word surrounded by underscores).
18972 For example, if the token
18973 <P>
18974 <CENTER><SAMP>_DATE_</SAMP></CENTER>
18975 <P>
18976 is included in the text of the signature file, then when you reply to
18977 or forward a message, the token will be replaced with the actual date
18978 the message you are replying to or forwarding was sent.
18979 <P>
18980 If you use a role that has a signature file for a plain composition
18981 (that is, not a reply or forward) then there is no original message, so
18982 any tokens that depend on the message will be replaced with nothing.
18983 So if you want a signature file to be useful for new compositions it
18984 shouldn't include any of the tokens that depend on the message being
18985 replied to or forwarded.
18986 <P>
18987 The list of available tokens is
18988 <A HREF="h_index_tokens">here</A>.
18989 <P>
18990 Actually, for the adventurous, there is a way to conditionally include text based
18991 on whether or not a token would result in specific replacement text.
18992 For example, you could include some text based on whether or not
18993 the _NEWS_ token would result in any newsgroups if it was used.
18994 It's explained in detail
18995 <A HREF="h_reply_token_conditionals">here</A>.
18996 <P>
18997 In the very unlikely event that you want to include a literal token in
18998 a signature file, you must precede it with a backslash character.
18999 For example, to include the literal text _DATE_ you must actually use
19000 &#92;_DATE_.
19001 It is not possible to have a literal backslash followed by an expanded token.
19002 <P>
19003 A blank field here means that Alpine will use its normal rules for deciding
19004 which file (if any) to use for the signature file.
19005 <P>
19006 An alternate method for storing the signature is available in
19007 <A HREF="h_config_role_setlitsig">Set Literal Signature</A>.
19008 <P>
19009 Look <A HREF="h_edit_nav_cmds">here</A>
19010 to see the available Editing and Navigation commands.
19011 <P>
19012 &lt;End of help on this topic&gt;
19013 </BODY>
19014 </HTML>
19015 ======= h_config_role_settempl =======
19016 <HTML>
19017 <HEAD>
19018 <TITLE>Set Template Explained</TITLE>
19019 </HEAD>
19020 <BODY>
19021 <H1>Set Template Explained</H1>
19022
19023 This describes part of the action to be taken if the Pattern for this
19024 role is a match.
19025 This field consists of a filename that will be used as the template
19026 file when using this role.
19027 The template file is a file that is included at the top of the message you
19028 are composing.
19029 <P>
19030 If the filename is followed by a vertical bar (|) then instead
19031 of reading the contents of the file the file is assumed to be a
19032 program that will produce the text to be used on its standard output.
19033 The program can't have any arguments and doesn't receive any input from Alpine,
19034 but the rest of the processing works as if the contents came from a file.
19035 <P>
19036 Instead of storing the data in a local file, the
19037 template may be stored remotely in an IMAP folder.
19038 In order to do this,
19039 you must use a remote name for the template.
19040 A remote template name might look like:
19041 <P>
19042 <CENTER><SAMP>{myimaphost.myschool.k12.wa.us}mail/templ3</SAMP></CENTER>
19043 <P>
19044
19045 The syntax used here is the same as the syntax used for a remote
19046 <A HREF="h_config_signature_file"><!--#echo var="VAR_signature-file"--></A>.
19047 Note that you may not access an existing template file remotely,
19048 you have to create a new <EM>folder</EM> that contains the template data.
19049 If the name you use here for the template is a remote name, then when
19050 you edit the file using the &quot;F&quot; command the data will
19051 be saved remotely in the folder.
19052 You aren't required to do anything special to create the folder, it
19053 gets created if you use a remote name.
19054 <P>
19055 If you type &quot;F&quot; you may edit the contents of the file (as opposed to
19056 the name of the file) you have specified.
19057 If you type &quot;T&quot; you may use a browser to choose an existing filename.
19058 <P>
19059 Besides containing regular text, the template file may also
19060 contain (or a template file program may produce) tokens that are replaced with text
19061 that depends on the message you are replying to or forwarding.
19062 The tokens all look like _word_ (a word surrounded by underscores).
19063 For example, if the token
19064 <P>
19065 <CENTER><SAMP>_DATE_</SAMP></CENTER>
19066 <P>
19067 is included in the text of the template file, then when you reply to
19068 or forward a message, the token will be replaced with the actual date
19069 the message you are replying to or forwarding was sent.
19070 <P>
19071 If you use a role that has a template file for a plain composition
19072 (that is, not a reply or forward) then there is no original message, so
19073 any tokens that depend on the message will be replaced with nothing.
19074 So if you want a template file to be useful for new compositions it
19075 shouldn't include any of the tokens that depend on the message being
19076 replied to or forwarded.
19077 <P>
19078 The list of available tokens is
19079 <A HREF="h_index_tokens">here</A>.
19080 <P>
19081 Actually, for the adventurous, there is a way to conditionally include text based
19082 on whether or not a token would result in specific replacement text.
19083 For example, you could include some text based on whether or not
19084 the _NEWS_ token would result in any newsgroups if it was used.
19085 It's explained in detail
19086 <A HREF="h_reply_token_conditionals">here</A>.
19087 <P>
19088 In the very unlikely event that you want to include a literal token in
19089 a template file, you must precede it with a backslash character.
19090 For example, to include the literal text _DATE_ you must actually use
19091 &#92;_DATE_.
19092 It is not possible to have a literal backslash followed by an expanded token.
19093 <P>
19094 A blank template field means that Alpine will not use a template file when
19095 this role is being used.
19096 <P>
19097 Look <A HREF="h_edit_nav_cmds">here</A>
19098 to see the available Editing and Navigation commands.
19099 <P>
19100 &lt;End of help on this topic&gt;
19101 </BODY>
19102 </HTML>
19103 ======= h_config_filt_stat_imp =======
19104 <HTML>
19105 <HEAD>
19106 <TITLE>Set Important Status Explained</TITLE>
19107 </HEAD>
19108 <BODY>
19109 <H1>Set Important Status Explained</H1>
19110
19111 This describes part of the action to be taken if the Pattern for this
19112 filter is a match.
19113 If set to &quot;Don't change it&quot; then this does nothing.
19114 If set to &quot;Set this state&quot; then the Important flag is set
19115 for the matching message.
19116 If set to &quot;Clear this state&quot; then the Important flag is cleared
19117 for the matching message.
19118 The important flag usually causes an asterisk to show up in the MESSAGE
19119 INDEX.
19120 It may also be useful when selecting a set of messages
19121 with the Select command.
19122 <P>
19123 Look <A HREF="h_edit_nav_cmds">here</A>
19124 to see the available Editing and Navigation commands.
19125 <P>
19126 &lt;End of help on this topic&gt;
19127 </BODY>
19128 </HTML>
19129 ======= h_config_filt_stat_new =======
19130 <HTML>
19131 <HEAD>
19132 <TITLE>Set New Status Explained</TITLE>
19133 </HEAD>
19134 <BODY>
19135 <H1>Set New Status Explained</H1>
19136
19137 This describes part of the action to be taken if the Pattern for this
19138 filter is a match.
19139 If set to &quot;Don't change it&quot; then this does nothing.
19140 If set to &quot;Set this state&quot; then the
19141 matching message is marked New.
19142 If set to &quot;Clear this state&quot; then the
19143 matching message is marked Seen.
19144 <P>
19145 Look <A HREF="h_edit_nav_cmds">here</A>
19146 to see the available Editing and Navigation commands.
19147 <P>
19148 &lt;End of help on this topic&gt;
19149 </BODY>
19150 </HTML>
19151 ======= h_config_filt_stat_ans =======
19152 <HTML>
19153 <HEAD>
19154 <TITLE>Set Answered Status Explained</TITLE>
19155 </HEAD>
19156 <BODY>
19157 <H1>Set Answered Status Explained</H1>
19158
19159 This describes part of the action to be taken if the Pattern for this
19160 filter is a match.
19161 If set to &quot;Don't change it&quot; then this does nothing.
19162 If set to &quot;Set this state&quot; then the Answered flag is set
19163 for the matching message.
19164 If set to &quot;Clear this state&quot; then the Answered flag is cleared
19165 for the matching message.
19166 <P>
19167 Look <A HREF="h_edit_nav_cmds">here</A>
19168 to see the available Editing and Navigation commands.
19169 <P>
19170 &lt;End of help on this topic&gt;
19171 </BODY>
19172 </HTML>
19173 ======= h_config_filt_stat_del =======
19174 <HTML>
19175 <HEAD>
19176 <TITLE>Set Deleted Status Explained</TITLE>
19177 </HEAD>
19178 <BODY>
19179 <H1>Set Deleted Status Explained</H1>
19180
19181 This describes part of the action to be taken if the Pattern for this
19182 filter is a match.
19183 If set to &quot;Don't change it&quot; then this does nothing.
19184 If set to &quot;Set this state&quot; then the
19185 matching message is marked Deleted.
19186 If set to &quot;Clear this state&quot; then the
19187 matching message is marked UnDeleted.
19188 <P>
19189 You should not use this option unless you are prepared to have matching
19190 messages expunged from the folder permanently.
19191 For example, if you type the Expunge command, this filter is applied
19192 before the expunge, so matching messages will be marked Deleted and then
19193 will be permanently expunged from the folder.
19194 However, since the index isn't redrawn in between the time that the message
19195 is marked Deleted and the time that you are asked to expunge, the only
19196 indication that you are expunging the message comes in the number of messages
19197 being expunged.
19198 The same thing may happen when you close a folder.
19199 It is also possible that an expunge not initiated by you will
19200 delete matching messages.
19201 <P>
19202 Look <A HREF="h_edit_nav_cmds">here</A>
19203 to see the available Editing and Navigation commands.
19204 <P>
19205 &lt;End of help on this topic&gt;
19206 </BODY>
19207 </HTML>
19208 ======= h_config_role_scoreval =======
19209 <HTML>
19210 <HEAD>
19211 <TITLE>Score Value Explained</TITLE>
19212 </HEAD>
19213 <BODY>
19214 <H1>Score Value Explained</H1>
19215
19216 A message's score is the sum of the Score Values from all of the Scoring rules
19217 with Patterns that match the message.
19218 The value you give here is the Score Value associated with this rule.
19219 A Score Value is an integer between -100 and 100, with the default
19220 value of zero.
19221 <P>
19222 Alternatively, if the
19223 <A HREF="h_config_role_scorehdrtok">&quot;Score From Header&quot;</A>
19224 field is defined
19225 (on the line right below the &quot;Score Value&quot; field)
19226 then the &quot;Score Value&quot; is ignored and
19227 the &quot;Score From Header&quot; field is used instead.
19228 <P>
19229 Look <A HREF="h_edit_nav_cmds">here</A>
19230 to see the available Editing and Navigation commands.
19231 <P>
19232 &lt;End of help on this topic&gt;
19233 </BODY>
19234 </HTML>
19235 ======= h_config_role_scorehdrtok =======
19236 <HTML>
19237 <HEAD>
19238 <TITLE>Score Value From Header Explained</TITLE>
19239 </HEAD>
19240 <BODY>
19241 <H1>Score Value From Header Explained</H1>
19242
19243 This option provides a way to use a number that appears in the headers of your
19244 messages as the message's score, or as a component of that score.
19245 If this field is defined then it is used instead of the &quot;Score Value&quot;.
19246 The idea behind this option is that there may be a score embedded in the
19247 headers of messages that has already been calculated outside of Alpine.
19248 For example, messages delivered to you may contain an &quot;X-Spam&quot; header and
19249 somewhere in that header there is a score.
19250 <P>
19251 The value for this option is the name of the header followed by parentheses
19252 with two arguments inside:
19253 <P>
19254 <CENTER><SAMP>HeaderName(field_number,field_separators)</SAMP></CENTER>
19255 <P>
19256 No space is allowed between the comma and the start of the field_separators.
19257 It would be interpreted as the first separator if it was there.
19258 Field 0 is the whole line, Field 1 is the data up to the first separator, Field 2
19259 starts after that and goes to the second separator, and so on.
19260 It's easier to explain with examples.
19261 <P>
19262 <CENTER><SAMP>X-Spam(2,&quot;&nbsp;&quot;)</SAMP></CENTER>
19263 <P>
19264 In the above example the header that is used is the &quot;X-Spam&quot; header.
19265 The value of that header (the part after the colon and the space) is split
19266 into fields separated by spaces.
19267 <P>
19268 <CENTER><SAMP>Field1 &lt;space&gt; Field2 &lt;space&gt; Field3 ...</SAMP></CENTER>
19269 <P>
19270 The second field is selected and converted to an integer. It only makes sense
19271 if Field2 really is an integer.
19272 <P>
19273 Here's an example of a SpamAssassin header.
19274 The exact look of the header will vary, but if your incoming mail
19275 contains headers that look like the following
19276 <P>
19277 <CENTER><SAMP>X-Spam-Status: Yes, hits=10.6 tagged_above=-999.0 required=7.0 tests=BAYE...</SAMP></CENTER>
19278 <P>
19279 you might want to use the hits value as a score.
19280 Since the score is an integer value you can't make use of the decimal part of
19281 the number, but
19282 you might split off the hits=10 part as a score by using the characters &quot;=&quot;
19283 and &quot;.&quot; as your separators.
19284 <P>
19285 <CENTER><SAMP>X-Spam-Status(2,&quot;=.&quot;)</SAMP></CENTER>
19286 <P>
19287 The first field starts with the Y in Yes and goes until the &quot;=&quot; after
19288 hits.
19289 The second field is &quot;10&quot; so the score value would be 10.
19290 <P>
19291 Another example we've seen has headers that look like
19292 <P>
19293 <CENTER><SAMP>X-Spam: Gauge=IIIIIII, Probability=7%, Report=...</SAMP></CENTER>
19294 <P>
19295 Because there are two equals before the 7% the value
19296 <P>
19297 <CENTER><SAMP>X-Spam(3,&quot;=%&quot;)</SAMP></CENTER>
19298 <P>
19299 should capture the probability as the score.
19300 <P>
19301 The Score From Header scoring value actually works just like the
19302 regular Score Value in that the rest of the pattern has to match before
19303 it is used and the scores from all the different scoring rules that
19304 match for a particular message are added together.
19305 When using the Score From Header method it may (or may not) make sense to
19306 use only a single scoring rule with a pattern that matches every message.
19307 <P>
19308 Look <A HREF="h_edit_nav_cmds">here</A>
19309 to see the available Editing and Navigation commands.
19310 <P>
19311 &lt;End of help on this topic&gt;
19312 </BODY>
19313 </HTML>
19314 ======= h_config_role_replyuse =======
19315 <HTML>
19316 <HEAD>
19317 <TITLE>Reply Use Explained</TITLE>
19318 </HEAD>
19319 <BODY>
19320 <H1>Reply Use Explained</H1>
19321
19322 This option determines how this particular role will be used when Replying
19323 to a message.
19324 There are three possible values for this option.
19325 The value &quot;Never&quot;
19326 means that this role will not be a candidate for use when Replying.
19327 The role's Pattern will not be checked for a match, however the role will
19328 be available to be manually switched to if there is a confirmation prompt.
19329 <P>
19330
19331 The options &quot;With confirmation&quot; and &quot;Without confirmation&quot;
19332 mean that you do want to consider this role when Replying.
19333 For either of these settings, the role's Pattern will be compared with
19334 the message being replied to.
19335 If there is a match then this role will either be used without confirmation
19336 or will be the default when confirmation is asked for, depending on
19337 which of the two options is selected.
19338 If confirmation is requested, you will also have a chance to
19339 manually change the role to any one of your other roles.
19340 <P>
19341
19342 You won't be prompted for confirmation if none of your role Patterns
19343 match the message being replied to.
19344 This is independent of the value of the current option.
19345 The <A HREF="h_config_confirm_role"><!--#echo var="FEAT_confirm-role-even-for-default"--></A>
19346 feature may be used to change this behavior.
19347 <P>
19348 &lt;End of help on this topic&gt;
19349 </BODY>
19350 </HTML>
19351 ======= h_config_role_forwarduse =======
19352 <HTML>
19353 <HEAD>
19354 <TITLE>Forward Use Explained</TITLE>
19355 </HEAD>
19356 <BODY>
19357 <H1>Forward Use Explained</H1>
19358
19359 This option determines how this particular role will be used when Forwarding
19360 a message.
19361 There are three possible values for this option.
19362 The value &quot;Never&quot;
19363 means that this role will not be a candidate for use when Forwarding.
19364 The role's Pattern will not be checked for a match, however the role will
19365 be available to be manually switched to if there is a confirmation prompt.
19366 <P>
19367
19368 The options &quot;With confirmation&quot; and &quot;Without confirmation&quot;
19369 mean that you do want to consider this role when Forwarding.
19370 For either of these settings, the role's Pattern will be compared with
19371 the message being forwarded.
19372 If there is a match then this role will either be used without confirmation
19373 or will be the default when confirmation is asked for, depending on
19374 which of the two options is selected.
19375 If confirmation is requested, you will also have a chance to
19376 manually change the role to any one of your other roles.
19377 <P>
19378
19379 You won't be prompted for confirmation if none of your role Patterns
19380 match the message being forwarded.
19381 This is independent of the value of the current option.
19382 The <A HREF="h_config_confirm_role"><!--#echo var="FEAT_confirm-role-even-for-default"--></A>
19383 feature may be used to change this behavior.
19384 <P>
19385 &lt;End of help on this topic&gt;
19386 </BODY>
19387 </HTML>
19388 ======= h_config_role_composeuse =======
19389 <HTML>
19390 <HEAD>
19391 <TITLE>Compose Use Explained</TITLE>
19392 </HEAD>
19393 <BODY>
19394 <H1>Compose Use Explained</H1>
19395
19396 This option determines how this particular role will be used when Composing
19397 a new message using the &quot;Compose&quot; command.
19398 This does not affect what happens when using the &quot;Role&quot; command
19399 to compose a new message.
19400 The &quot;Role&quot; command allows you to select a role from all of the
19401 roles you have defined, regardless of what Uses you've assigned to those
19402 roles.
19403 <P>
19404
19405 There are three possible values for this option.
19406 The value &quot;Never&quot;
19407 means that this role will not be a candidate for use when Composing.
19408 The role's Current Folder Type will not be checked for a match, however the role
19409 will be available to be manually switched to if there is a confirmation prompt.
19410 <P>
19411
19412 The options &quot;With confirmation&quot; and &quot;Without confirmation&quot;
19413 mean that you do want to consider this role when Composing.
19414 For either of these settings,
19415 the role's Current Folder Type will be checked (since there is no message
19416 to compare with, the rest of the Pattern is considered a match).
19417 If there is a match then this role will either be used without confirmation
19418 or will be the default when confirmation is asked for, depending on
19419 which of the two options is selected.
19420 If confirmation is requested, you will also have a chance to
19421 manually change the role to any one of your other roles.
19422 <P>
19423
19424 When using the Compose command the role checking is a little different
19425 because there is no message being replied to or forwarded.
19426 Because of this the Current Folder Type is checked but the header pattern
19427 fields, the AllText pattern, the BodyText pattern, and the Score Interval are all ignored.
19428 A role is considered to be a match if it is a candidate for Compose Use and
19429 its Current Folder Type matches the currently open folder.
19430 This could be useful if you want to set a role based on the folder you
19431 are reading, or the type of folder you are reading.
19432 <P>
19433
19434 You won't be prompted for confirmation if none of your role Patterns
19435 are a match.
19436 This is independent of the value of the current option.
19437 The <A HREF="h_config_confirm_role"><!--#echo var="FEAT_confirm-role-even-for-default"--></A>
19438 feature may be used to change this behavior.
19439 <P>
19440 &lt;End of help on this topic&gt;
19441 </BODY>
19442 </HTML>
19443 ======= h_config_filter_folder =======
19444 <HTML>
19445 <HEAD>
19446 <TITLE>Filter Folder Explained</TITLE>
19447 </HEAD>
19448 <BODY>
19449 <H1>Filter Folder Explained</H1>
19450
19451 When the Filter Action is set to &quot;Move&quot;,
19452 the folder or folders specified here will be used to store messages matching
19453 the provided pattern.
19454
19455 <P>
19456 If you set the Filter Action to &quot;Move&quot; you must give a folder name
19457 here.
19458
19459 <P>
19460 If you wish,
19461 you may choose a folder from your folder collections by using the
19462 &quot;T&quot; command.
19463 <P>
19464 Besides regular text, the folder name may also contain
19465 tokens that are replaced with text representing the current date
19466 when you run Alpine.
19467 For example, if the folder name you use is
19468 <P>
19469 <CENTER><SAMP>abc-_CURYEAR_-_CURMONTHABBREV_</SAMP></CENTER>
19470 <P>
19471 that is replaced with something like
19472 <P>
19473 <CENTER><SAMP>abc-2004-oct</SAMP></CENTER>
19474 <P>
19475 Or,
19476 <P>
19477 <CENTER><SAMP>abc-_CURYEAR2DIGIT_-_CURMONTH2DIGIT_</SAMP></CENTER>
19478 <P>
19479 becomes
19480 <P>
19481 <CENTER><SAMP>abc-04-10</SAMP></CENTER>
19482 <P>
19483 The token names must be surrounded by underscores in order to be recognized
19484 as tokens.
19485 The tokens that may be used are those that are derived from the current date.
19486 They're listed near the bottom of the list of tokens give
19487 <A HREF="h_index_tokens">here</A>.
19488 <P>
19489 Look &quot;<A HREF="h_rule_patterns">here</A>&quot;
19490 for more information on Patterns.
19491 <P>
19492 Look <A HREF="h_edit_nav_cmds">here</A>
19493 to see the available Editing and Navigation commands.
19494 <P>
19495 &lt;End of help on this topic&gt;
19496 </BODY>
19497 </HTML>
19498 ======= h_config_filter_kw_set =======
19499 <HTML>
19500 <HEAD>
19501 <TITLE>Set These Keywords Explained</TITLE>
19502 </HEAD>
19503 <BODY>
19504 <H1>Set These Keywords Explained</H1>
19505
19506 This describes part of the action to be taken if the Pattern for this
19507 filter is a match.
19508 Read a little about keywords in the help text for the
19509 <A HREF="h_common_flag">Flag</A> command.
19510 This option is a list of keywords that will be Set when there is a match.
19511 If you wish, you may choose keywords from the list of keywords you have
19512 defined with the &quot;T&quot; command.
19513 You may add new keywords by defining them in the
19514 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in the Setup/Config screen.
19515 If you have given a keyword a nickname when configuring it,
19516 that nickname may be used instead of the actual keyword.
19517
19518 <P>
19519 Look <A HREF="h_edit_nav_cmds">here</A>
19520 to see the available Editing and Navigation commands.
19521 <P>
19522 &lt;End of help on this topic&gt;
19523 </BODY>
19524 </HTML>
19525 ======= h_config_filter_kw_clr =======
19526 <HTML>
19527 <HEAD>
19528 <TITLE>Clear These Keywords Explained</TITLE>
19529 </HEAD>
19530 <BODY>
19531 <H1>Clear These Keywords Explained</H1>
19532
19533 This describes part of the action to be taken if the Pattern for this
19534 filter is a match.
19535 Read a little about keywords in the help text for the
19536 <A HREF="h_common_flag">Flag</A> command.
19537 This option is a list of keywords that will be Cleared when there is a match.
19538 If you wish, you may choose keywords from the list of keywords you have
19539 defined with the &quot;T&quot; command.
19540 You may add new keywords by defining them in the
19541 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in the Setup/Config screen.
19542 If you have given a keyword a nickname when configuring it,
19543 that nickname may be used instead of the actual keyword.
19544
19545 <P>
19546 Look <A HREF="h_edit_nav_cmds">here</A>
19547 to see the available Editing and Navigation commands.
19548 <P>
19549 &lt;End of help on this topic&gt;
19550 </BODY>
19551 </HTML>
19552 ======= h_index_tokens =======
19553 <HTML>
19554 <HEAD>
19555 <TITLE>Tokens for Index and Replying</TITLE>
19556 </HEAD>
19557 <BODY>
19558
19559 This set of special tokens may be used in the
19560 <A HREF="h_config_index_format">&quot;<!--#echo var="VAR_index-format"-->&quot;</A> option,
19561 in the <A HREF="h_config_reply_intro">&quot;<!--#echo var="VAR_reply-leadin"-->&quot;</A> option,
19562 in signature files,
19563 in template files used in
19564 <A HREF="h_rules_roles">&quot;roles&quot;</A>, and in the folder name
19565 that is the target of a Filter Rule.
19566 Some of them aren't available in all situations.
19567 <P>
19568 The tokens are used as they appear below for the &quot;<!--#echo var="VAR_index-format"-->&quot;
19569 option, but they must be surrounded by underscores for the
19570 &quot;<!--#echo var="VAR_reply-leadin"-->&quot; option, in signature and template files,
19571 and in the target of Filter Rules.
19572 <P>
19573 <P>
19574
19575 <H1><EM>Tokens Available for all Cases (except Filter Rules)</EM></H1>
19576
19577 <DL>
19578 <DT>SUBJECT</DT>
19579 <DD>
19580 This token represents the Subject the sender gave the message.
19581 Alternatives for use in the index screen are SHORTSUBJECT,
19582 SUBJKEY, SHORTSUBJKEY, SUBJKEYINIT, SHORTSUBJKEYINIT, SUBJECTTEXT,
19583 SUBJKEYTEXT, and SUBJKEYINITTEXT.
19584 You may color the subject text in the MESSAGE INDEX screen differently by using the
19585 <A HREF="h_config_index_subject_color">Index Subject Color</A> and the
19586 <A HREF="h_config_index_opening_color">Index Opening Color</A>
19587 options available from
19588 the <A HREF="h_color_setup">Setup Kolor</A> screen.
19589 </DD>
19590
19591 <DT>FROM</DT>
19592 <DD>
19593 This token represents the personal name (or email address if the name
19594 is unavailable) of the person specified in the message's &quot;From:&quot;
19595 header field.
19596 You may color the from text in the MESSAGE INDEX screen differently by using the
19597 <A HREF="h_config_index_from_color">Index From Color</A>
19598 option available from
19599 the <A HREF="h_color_setup">Setup Kolor</A> screen.
19600 </DD>
19601
19602 <DT>ADDRESS</DT>
19603 <DD>
19604 This is similar to the &quot;FROM&quot; token, only it is always the
19605 email address, never the personal name.
19606 For example, &quot;mailbox@domain&quot;.
19607 </DD>
19608
19609 <DT>MAILBOX</DT>
19610 <DD>
19611 This is the same as the &quot;ADDRESS&quot; except that the
19612 domain part of the address is left off.
19613 For example, &quot;mailbox&quot;.
19614 </DD>
19615
19616 <DT>SENDER</DT>
19617 <DD>
19618 This token represents the personal name (or email address) of the person
19619 listed in the message's &quot;Sender:&quot; header field.
19620 </DD>
19621
19622 <DT>TO</DT>
19623 <DD>
19624 This token represents the personal names (or email addresses if the names
19625 are unavailable) of the persons specified in the
19626 message's &quot;To:&quot; header field.
19627 </DD>
19628
19629 <DT>NEWSANDTO</DT>
19630 <DD>
19631 This token represents the newsgroups from the
19632 message's &quot;Newsgroups:&quot; header field <EM>and</EM>
19633 the personal names (or email addresses if the names
19634 are unavailable) of the persons specified in the
19635 message's &quot;To:&quot; header field.
19636 </DD>
19637
19638 <DT>TOANDNEWS</DT>
19639 <DD>
19640 Same as &quot;NEWSANDTO&quot; except in the opposite order.
19641 </DD>
19642
19643 <DT>NEWS</DT>
19644 <DD>
19645 This token represents the newsgroups from the
19646 message's &quot;Newsgroups:&quot; header field.
19647 </DD>
19648
19649 <DT>CC</DT>
19650 <DD>
19651 This token represents the personal names (or email addresses if the names
19652 are unavailable) of the persons specified in the
19653 message's &quot;Cc:&quot; header field.
19654 </DD>
19655
19656 <DT>RECIPS</DT>
19657 <DD>
19658 This token represents the personal names (or email addresses if the names
19659 are unavailable) of the persons specified in both the
19660 message's &quot;To:&quot; header field and
19661 the message's &quot;Cc:&quot; header field.
19662 </DD>
19663
19664 <DT>NEWSANDRECIPS</DT>
19665 <DD>
19666 This token represents the newsgroups from the
19667 message's &quot;Newsgroups:&quot; header field <EM>and</EM>
19668 the personal names (or email addresses if the names
19669 are unavailable) of the persons specified in the
19670 message's &quot;To:&quot; and &quot;Cc:&quot; header fields.
19671 </DD>
19672
19673 <DT>RECIPSANDNEWS</DT>
19674 <DD>
19675 Same as &quot;NEWSANDRECIPS&quot; except in the opposite order.
19676 </DD>
19677
19678 <DT>INIT</DT>
19679 <DD>
19680 This token represents the initials from the personal name
19681 of the person specified in the message's &quot;From:&quot;
19682 header field.
19683 If there is no personal name, it is blank.
19684 </DD>
19685
19686 <DT>DATE</DT>
19687 <DD>
19688 This token represents the date on which the message was sent, according
19689 to the &quot;Date&quot; header field.
19690 It has the format MMM DD. For example, &quot;Oct 23&quot;.
19691 The feature
19692 <A HREF="h_config_dates_to_local"><!--#echo var="FEAT_convert-dates-to-localtime"--></A>,
19693 which adjusts for the timezone the message was sent from,
19694 may have an effect on the value of this token as well as the values of
19695 all of the other DATE or TIME tokens.
19696 Some of the DATE and TIME tokens are displayed in a locale-specific
19697 way unless the option
19698 <A HREF="h_config_disable_index_locale_dates"><!--#echo var="FEAT_disable-index-locale-dates"--></A> is set.
19699 </DD>
19700
19701 <DT>SMARTDATE</DT>
19702 <DD>
19703 This token represents the date on which the message was sent, according
19704 to the &quot;Date&quot; header field.
19705 It is &quot;Today&quot; if the message was sent today,
19706 &quot;Yesterday&quot; for yesterday,
19707 &quot;Wednesday&quot; if it was last Wednesday, and so on. If the
19708 message is from last year and is more than six months old it includes the year, as well.
19709 See the SMARTDATE alternatives below, as well.
19710 </DD>
19711
19712 <DT>SMARTTIME</DT>
19713 <DD>
19714 This token represents the most relevant elements of the date on which
19715 the message was sent (according to the &quot;Date&quot; header field),
19716 in a compact form. If the message was sent today, only the time is used
19717 (e.g. &quot;9:22am&quot;, &quot;10:07pm&quot;); if it was sent during
19718 the past week, the day of the week and the hour are used
19719 (e.g. &quot;Wed09am&quot;, &quot;Thu10pm&quot;); other dates are
19720 given as date, month, and year (e.g. &quot;23Aug00&quot;,
19721 &quot;9Apr98&quot;).
19722 </DD>
19723
19724 <DT>SMARTTIME24</DT>
19725 <DD>
19726 This token has the structure &quot;day hour:minute&quot;
19727 (e.g. &quot;Sun 19:03&quot;) for messages dated less than a week
19728 from the current date, or &quot;month day&quot; (e.g.
19729 &quot;Nov 23&quot;) for messages dated less than 6 months
19730 ago, or &quot;day/month/year&quot; (e.g &quot;06/Jan/16&quot;)
19731 for messages dated more than 6 months ago. It uses 9 characters
19732 of the width of the screen, and it left aligned.
19733 </DD>
19734
19735 <DT>SMARTDATETIME</DT>
19736 <DD>
19737 This is a combination of SMARTDATE and SMARTTIME.
19738 It is SMARTDATE unless the SMARTDATE value is &quot;Today&quot;, in which
19739 case it is SMARTTIME.
19740 See the SMARTDATETIME alternatives below, as well.
19741 </DD>
19742
19743 <DT>DATEISO</DT>
19744 <DD>
19745 This token represents the date on which the message was sent, according
19746 to the &quot;Date&quot; header field.
19747 It has the format YYYY-MM-DD. For example, &quot;1998-10-23&quot;.
19748 </DD>
19749
19750 <DT>SHORTDATEISO</DT>
19751 <DD>
19752 This token represents the date on which the message was sent, according
19753 to the &quot;Date&quot; header field.
19754 It has the format YY-MM-DD. For example, &quot;98-10-23&quot;.
19755 </DD>
19756
19757 <DT>SHORTDATE1</DT>
19758 <DD>
19759 This token represents the date on which the message was sent, according
19760 to the &quot;Date&quot; header field.
19761 It has the format MM/DD/YY. For example, &quot;10/23/98&quot;.
19762 </DD>
19763
19764 <DT>SHORTDATE2</DT>
19765 <DD>
19766 This token represents the date on which the message was sent, according
19767 to the &quot;Date&quot; header field.
19768 It has the format DD/MM/YY. For example, &quot;23/10/98&quot;.
19769 </DD>
19770
19771 <DT>SHORTDATE3</DT>
19772 <DD>
19773 This token represents the date on which the message was sent, according
19774 to the &quot;Date&quot; header field.
19775 It has the format DD.MM.YY. For example, &quot;23.10.98&quot;.
19776 </DD>
19777
19778 <DT>SHORTDATE4</DT>
19779 <DD>
19780 This token represents the date on which the message was sent, according
19781 to the &quot;Date&quot; header field.
19782 It has the format YY.MM.DD. For example, &quot;98.10.23&quot;.
19783 </DD>
19784
19785 <DT>LONGDATE</DT>
19786 <DD>
19787 This token represents the date on which the message was sent, according
19788 to the &quot;Date&quot; header field.
19789 It has the format MMM DD, YYYY. For example, &quot;Oct 23, 1998&quot;.
19790 </DD>
19791
19792 <DT>SMARTDATE alternatives</DT>
19793 <DD>
19794 There are several versions of SMARTDATE that are all the same except
19795 for the way they format dates far in the past.
19796 SMARTDATE formats the date using the information from your locale settings
19797 to format the date string. It may end up formatting dates so that they look
19798 like DATEISO tokens, or SHORTDATE2 tokens, or something else entirely.
19799 The feature
19800 <A HREF="h_config_dates_to_local"><!--#echo var="FEAT_convert-dates-to-localtime"--></A>
19801 may have an effect on the values of these tokens.
19802 If you want more control you may use one of the following.
19803   <DL>
19804   <DT>SMARTDATE</DT> <DD>If the option
19805 <A HREF="h_config_disable_index_locale_dates"><!--#echo var="FEAT_disable-index-locale-dates"--></A> is not set
19806 then this will be locale specific. Control this with the
19807 LC_TIME locale setting on a UNIX system. On Windows
19808 the Regional Options control panel may be used to set the Short date
19809 format. At the programming level, the strftime routine is what Alpine
19810 uses to print the date.
19811 If the <!--#echo var="FEAT_disable-index-locale-dates"--> option is set then this is equivalent
19812 to SMARTDATES1.</DD>
19813   <DT>SMARTDATEISO</DT> <DD>DATEISO format. See text above.</DD>
19814   <DT>SMARTDATESHORTISO</DT> <DD>SHORTDATEISO format.</DD>
19815   <DT>SMARTDATES1</DT> <DD>SHORTDATE1 format.</DD>
19816   <DT>SMARTDATES2</DT> <DD>SHORTDATE2 format.</DD>
19817   <DT>SMARTDATES3</DT> <DD>SHORTDATE3 format.</DD>
19818   <DT>SMARTDATES4</DT> <DD>SHORTDATE4 format.</DD>
19819   </DL>
19820 </DD>
19821
19822 <DT>SMARTDATETIME alternatives</DT>
19823 <DD>
19824 There are several versions of SMARTDATETIME that are all very similar.
19825 The ones that end in 24 use a 24-hour clock for Today's messages instead
19826 of a 12-hour clock.
19827 The other variation is
19828 for the way they format dates far in the past.
19829 SMARTDATETIME and SMARTDATETIME24 format the date using the information from your locale settings
19830 to format the date string. It may end up formatting dates so that they look
19831 like DATEISO tokens, or SHORTDATE2 tokens, or something else entirely.
19832 The feature
19833 <A HREF="h_config_dates_to_local"><!--#echo var="FEAT_convert-dates-to-localtime"--></A>
19834 may have an effect on the values of these tokens.
19835 The possible choices are:
19836   <DL>
19837   <DT>SMARTDATETIME</DT> <DD>If the option
19838 <A HREF="h_config_disable_index_locale_dates"><!--#echo var="FEAT_disable-index-locale-dates"--></A> is not set
19839 then this will be locale specific. Control this with the
19840 LC_TIME locale setting on a UNIX system. On Windows
19841 the Regional Options control panel may be used to set the Short date
19842 format. At the programming level, the strftime routine is what Alpine
19843 uses to print the date.
19844 If the <!--#echo var="FEAT_disable-index-locale-dates"--> option is set then this is equivalent
19845 to SMARTDATETIMES1.</DD>
19846   <DT>SMARTDATETIME24</DT> <DD>Use TIME24 for Today</DD>
19847   <DT>SMARTDATETIMEISO</DT> <DD>DATEISO format. See text above.</DD>
19848   <DT>SMARTDATETIMEISO24</DT> <DD>Use TIME24 for Today</DD>
19849   <DT>SMARTDATETIMESHORTISO</DT> <DD>SHORTDATEISO format.</DD>
19850   <DT>SMARTDATETIMESHORTISO24</DT> <DD>Use TIME24 for Today</DD>
19851   <DT>SMARTDATETIMES1</DT> <DD>SHORTDATE1 format.</DD>
19852   <DT>SMARTDATETIMES124</DT> <DD>Use TIME24 for Today</DD>
19853   <DT>SMARTDATETIMES2</DT> <DD>SHORTDATE2 format.</DD>
19854   <DT>SMARTDATETIMES224</DT> <DD>Use TIME24 for Today</DD>
19855   <DT>SMARTDATETIMES3</DT> <DD>SHORTDATE3 format.</DD>
19856   <DT>SMARTDATETIMES324</DT> <DD>Use TIME24 for Today</DD>
19857   <DT>SMARTDATETIMES4</DT> <DD>SHORTDATE4 format.</DD>
19858   <DT>SMARTDATETIMES424</DT> <DD>Use TIME24 for Today</DD>
19859   </DL>
19860 </DD>
19861
19862 <DT>DAYDATE</DT>
19863 <DD>
19864 This token represents the date on which the message was sent, according
19865 to the &quot;Date&quot; header field.
19866 It looks like &quot;Sat, 23 Oct 1998&quot;.
19867 This token is never converted in any locale-specific way.
19868 </DD>
19869
19870 <DT>PREFDATE</DT>
19871 <DD>
19872 This token represents the date on which the message was sent, according
19873 to the &quot;Date&quot; header field.
19874 It is your operating system's idea of the preferred date representation for the current locale.
19875 Internally it uses the %x version of the date from the strftime routine.
19876 </DD>
19877
19878 <DT>PREFTIME</DT>
19879 <DD>
19880 This token represents the time at which the message was sent, according
19881 to the &quot;Date&quot; header field.
19882 It is the preferred time representation for the current locale.
19883 Internally it uses the %X version of the time from the strftime routine.
19884 </DD>
19885
19886 <DT>PREFDATETIME</DT>
19887 <DD>
19888 This token represents the date and time at which the message was sent, according
19889 to the &quot;Date&quot; header field.
19890 It is the preferred date and time representation for the current locale.
19891 Internally it uses the %c version of the time from the strftime routine.
19892 </DD>
19893
19894 <DT>DAY</DT>
19895 <DD>
19896 This token represents the day of the month on which the message was sent,
19897 according to the &quot;Date&quot; header field.
19898 For example, &quot;23&quot; or &quot;9&quot;.
19899 </DD>
19900
19901 <DT>DAY2DIGIT</DT>
19902 <DD>
19903 This token represents the day of the month on which the message was sent,
19904 according to the &quot;Date&quot; header field.
19905 For example, &quot;23&quot; or &quot;09&quot;.
19906 It is always 2 digits.
19907 </DD>
19908
19909 <DT>DAYORDINAL</DT>
19910 <DD>
19911 This token represents the ordinal number that is the day of
19912 the month on which the message was sent,
19913 according to the &quot;Date&quot; header field.
19914 For example, &quot;23rd&quot; or &quot;9th&quot;.
19915 </DD>
19916
19917 <DT>DAYOFWEEK</DT>
19918 <DD>
19919 This token represents the day of the week on which the message was sent,
19920 according to the &quot;Date&quot; header field.
19921 For example, &quot;Sunday&quot; or &quot;Wednesday&quot;.
19922 </DD>
19923
19924 <DT>DAYOFWEEKABBREV</DT>
19925 <DD>
19926 This token represents the day of the week on which the message was sent,
19927 according to the &quot;Date&quot; header field.
19928 For example, &quot;Sun&quot; or &quot;Wed&quot;.
19929 </DD>
19930
19931 <DT>MONTHABBREV</DT>
19932 <DD>
19933 This token represents the month the message was sent, according
19934 to the &quot;Date&quot; header field.
19935 For example, &quot;Oct&quot;.
19936 </DD>
19937
19938 <DT>MONTHLONG</DT>
19939 <DD>
19940 This token represents the month in which the message was sent, according
19941 to the &quot;Date&quot; header field.
19942 For example, &quot;October&quot;.
19943 </DD>
19944
19945 <DT>MONTH</DT>
19946 <DD>
19947 This token represents the month in which the message was sent, according
19948 to the &quot;Date&quot; header field.
19949 For example, &quot;10&quot; or &quot;9&quot;.
19950 </DD>
19951
19952 <DT>MONTH2DIGIT</DT>
19953 <DD>
19954 This token represents the month in which the message was sent, according
19955 to the &quot;Date&quot; header field.
19956 For example, &quot;10&quot; or &quot;09&quot;.
19957 It is always 2 digits.
19958 </DD>
19959
19960 <DT>YEAR</DT>
19961 <DD>
19962 This token represents the year the message was sent, according
19963 to the &quot;Date&quot; header field.
19964 For example, &quot;1998&quot; or &quot;2001&quot;.
19965 </DD>
19966
19967 <DT>YEAR2DIGIT</DT>
19968 <DD>
19969 This token represents the year the message was sent, according
19970 to the &quot;Date&quot; header field.
19971 For example, &quot;98&quot; or &quot;01&quot;.
19972 It is always 2 digits.
19973 </DD>
19974
19975 <DT>TIME24</DT>
19976 <DD>
19977 This token represents the time at which the message was sent, according
19978 to the &quot;Date&quot; header field.
19979 There is no adjustment made for different time zones, so you'll get
19980 the time the message was sent according to the time zone the sender
19981 was in.
19982 It has the format HH:MM. For example, &quot;17:28&quot;.
19983 </DD>
19984
19985 <DT>TIME12</DT>
19986 <DD>
19987 This token represents the time at which the message was sent, according
19988 to the &quot;Date&quot; header field.
19989 This time is for a 12 hour clock.
19990 It has the format HH:MMpm.
19991 For example, &quot;5:28pm&quot; or &quot;11:13am&quot;.
19992 </DD>
19993
19994 <DT>TIMEZONE</DT>
19995 <DD>
19996 This token represents the numeric timezone from
19997 the &quot;Date&quot; header field.
19998 It has the format [+-]HHMM. For example, &quot;-0800&quot;.
19999 </DD>
20000
20001 </DL>
20002
20003 <P>
20004 <H1><EM>Tokens Available Only for <!--#echo var="VAR_index-format"--></EM></H1>
20005
20006 <DL>
20007 <DT>MSGNO</DT>
20008 <DD>
20009 This token represents the message's current position in the folder that,
20010 of course, may change as the folder is sorted or new mail arrives.
20011 </DD>
20012
20013 <DT>STATUS</DT>
20014 <DD>
20015 This token represents a three character wide field displaying various
20016 aspects of the message's state.
20017 The first character is either blank,
20018 a '*' for message marked Important, or a '+' indicating a message
20019 addressed directly to you (as opposed to your having received it via a
20020 mailing list, for example).
20021 When the feature
20022 &quot;<A HREF="h_config_mark_for_cc"><!--#echo var="FEAT_mark-for-cc"--></A>&quot;
20023 is set, if the first character would have been
20024 blank then it will instead be a '-' if the message is cc'd to you.
20025 The second character is typically blank,
20026 though the arrow cursor may occupy it if either the
20027 &quot;<A HREF="h_config_force_low_speed"><!--#echo var="FEAT_assume-slow-link"--></A>&quot;
20028 or the
20029 &quot;<A HREF="h_config_force_arrow"><!--#echo var="FEAT_force-arrow-cursor"--></A>&quot; feature
20030 is set (or you actually are on a slow link).
20031 The third character is either '<A HREF="h_flag_deleted">D</A>' (Deleted),
20032 '<A HREF="h_flag_answered">A</A>' (Answered),
20033 '<A HREF="h_flag_forwarded">F</A>' (Forwarded),
20034 '<A HREF="h_flag_new">N</A>' (New), or blank.
20035 <P>
20036 If you are using a threaded view of the index and this message is at the
20037 top of a collapsed portion of a thread,
20038 then this token refers to all of the messages in the collapsed portion of
20039 the thread instead of just the top message.
20040 The first character will be a '*' if <EM>any</EM> of the messages in the thread
20041 are marked Important, else a '+' if any of the messages are addressed
20042 to you, else a '-' if any of the messages are cc'd to you.
20043 The third character will be a 'D' if <EM>all</EM> of the messages
20044 in the collapsed thread are marked deleted,
20045 an 'A' if <EM>all</EM> of the messages
20046 in the collapsed thread are marked answered,
20047 it will be an 'N' if any of
20048 the messages are undeleted and unseen, and it will be blank otherwise.
20049 </DD>
20050
20051 <DT>FULLSTATUS</DT>
20052 <DD>
20053 This token represents a less abbreviated alternative
20054 to the &quot;STATUS&quot; token.
20055 It is six characters wide.
20056 The first character is '+', '-', or blank, the
20057 second blank, the third either '*' or blank, the fourth
20058 '<A HREF="h_flag_new">N</A>' or blank,
20059 the fifth '<A HREF="h_flag_answered">A</A>'
20060 or blank, and the sixth character is
20061 either '<A HREF="h_flag_deleted">D</A>' or
20062 blank.
20063 <P>
20064 If you are using a threaded view of the index and this message is at the
20065 top of a collapsed portion of a thread,
20066 then this token refers to all of the messages in the collapsed portion of
20067 the thread instead of just the top message.
20068 The first character is '+', '-', or blank depending on whether <EM>any</EM>
20069 of the messages in the collapsed thread are addressed to you or cc'd to you.
20070 The third character will be '*' if any of the messages are marked
20071 Important.
20072 The fourth character will be 'N' if all of the messages in the thread
20073 are New, else 'n' if some of the messages in the thread are New, else blank.
20074 The fifth character will be 'A' or 'a' or blank, and the sixth character
20075 will be 'D' or 'd' or blank.
20076 </DD>
20077
20078 <DT>IMAPSTATUS</DT>
20079 <DD>
20080 This token represents an even less abbreviated alternative to the
20081 &quot;STATUS&quot; token.
20082 It differs from &quot;FULLSTATUS&quot; in only the fourth character, which is
20083 an 'N' if the message is new to this folder since the last time
20084 it was opened <EM>and</EM> it has not been viewed, an 'R' (Recent) if the message
20085 is new to the folder and has been viewed, a 'U' (Unseen) if the message is not
20086 new to the folder since it was last opened <EM>but</EM> has not been
20087 viewed, or a blank if the message has been in the folder since it was
20088 last opened and has been viewed.
20089 <P>
20090 If you are using a threaded view of the index and this message is at the
20091 top of a collapsed portion of a thread,
20092 then the fourth character will be
20093 'N' if all of the messages in the thread are unseen and recent;
20094 else 'n' if some of the messages in the thread are unseen and recent;
20095 else 'U' if all of the messages in the thread are unseen and not recent;
20096 else 'u' if some of the messages in the thread are unseen and not recent;
20097 else 'R' if all of the messages in the thread are seen and recent;
20098 else 'r' if some of the messages in the thread are seen and recent;
20099 else blank.
20100 </DD>
20101
20102 <DT>SHORTIMAPSTATUS</DT>
20103 <DD>
20104 This is the same as the last four of the six characters of IMAPSTATUS,
20105 so the '+' To Me information will be missing.
20106 </DD>
20107
20108 <DT>SIZE</DT>
20109 <DD>
20110 This token represents the total size, in bytes, of the message.
20111 If a &quot;K&quot; (Kilobyte)
20112 follows the number, the size is approximately 1,000
20113 times that many bytes (rounded to the nearest 1,000).
20114 If an &quot;M&quot; (Megabyte) follows the number, the size is approximately
20115 1,000,000 times that many bytes.
20116 Commas are not used in this field.
20117 This field is seven characters wide, including the enclosing parentheses.
20118 Sizes are rounded when &quot;K&quot; or &quot;M&quot; is present.
20119 The progression of sizes used looks like:
20120
20121 <P>
20122 <CENTER><SAMP>0 1 ... 9999 10K ... 999K 1.0M ... 99.9M 100M ... 2000M</SAMP></CENTER>
20123 <P>
20124 </DD>
20125
20126 <DT>SIZECOMMA</DT>
20127 <DD>
20128 This token represents the total size, in bytes, of the message.
20129 If a &quot;K&quot; (Kilobyte)
20130 follows the number, the size is approximately 1,000
20131 times that many bytes (rounded to the nearest 1,000).
20132 If an &quot;M&quot; (Megabyte) follows the number, the size is approximately
20133 1,000,000 times that many bytes.
20134 Commas are used if the number shown is 1,000 or greater.
20135 The SIZECOMMA field is one character wider than the SIZE field.
20136 Sizes are rounded when &quot;K&quot; or &quot;M&quot; is present.
20137 The progression of sizes used looks like:
20138
20139 <P>
20140 <CENTER><SAMP>0 1 ... 99,999 100K ... 9,999K 10.0M ... 999.9M 1,000M ... 2,000M</SAMP></CENTER>
20141 <P>
20142 </DD>
20143
20144 <DT>KSIZE</DT>
20145 <DD>
20146 This token represents the total size of the message, expressed in
20147 kilobytes or megabytes, as most appropriate.
20148 These are 1,024 byte kilobytes and 1,024 x 1,024 byte megabytes.
20149 The progression of sizes used looks like:
20150
20151 <P>
20152 <CENTER><SAMP>0K 1K ... 1023K 1.0M ... 99.9M 100M ... 2047M</SAMP></CENTER>
20153 <P>
20154 </DD>
20155
20156 <DT>SIZENARROW</DT>
20157 <DD>
20158 This token represents the total size, in bytes, of the message.
20159 If a &quot;K&quot; (Kilobyte)
20160 follows the number, the size is approximately 1,000
20161 times that many bytes.
20162 If an &quot;M&quot; (Megabyte) follows the number, the size is approximately
20163 1,000,000 times that many bytes.
20164 If a &quot;G&quot; (Gigabyte) follows the number, the size is approximately
20165 1,000,000,000 times that many bytes.
20166 This field uses only five characters of screen width, including the enclosing
20167 parentheses.
20168 The progression of sizes used looks like:
20169
20170 <P>
20171 <CENTER><SAMP>0 1 ... 999 1K ... 99K .1M ... .9M 1M ... 99M .1G ... .9G 1G 2G</SAMP></CENTER>
20172 <P>
20173 </DD>
20174
20175 <DT>DESCRIPSIZE</DT>
20176 <DD>
20177 This token is intended to represent a more useful description of the
20178 message than just its size, but it isn't very useful at this point.
20179 The plus sign in this view means there are attachments.
20180 Note that including this token in
20181 the &quot;<!--#echo var="VAR_index-format"-->&quot; could slow down the
20182 display a little while Alpine collects the necessary information.
20183 </DD>
20184
20185 <DT>SHORTSUBJECT</DT>
20186 <DD> This token is the same as SUBJECT, but removes
20187 text between &quot;[&quot; and &quot;]&quot;. Typically text enclosed
20188 between these characters corresponds to mailing list names, and may be
20189 unnecessary or unwanted in some instances.
20190 </DD>
20191
20192 <DT>SUBJKEY</DT>
20193 <DD>
20194 This token is the same as the SUBJECT token unless keywords are set for
20195 the message.
20196 In that case, a list of keywords enclosed in braces will be prepended to
20197 the subject of the message.
20198 Only those keywords that you have defined in your
20199 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option
20200 in Setup/Config are considered in the list.
20201 In other words, keywords that have been set by some other means, perhaps
20202 by another email program, won't show up unless included in
20203 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>.
20204 Having this set in the <!--#echo var="VAR_index-format"--> will also cause the keywords to be
20205 prepended to the subject in the MESSAGE TEXT screen.
20206 If you have given a keyword a nickname
20207 (<A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>), that nickname is displayed
20208 instead of the actual keyword.
20209 The <A HREF="h_config_kw_braces"><!--#echo var="VAR_keyword-surrounding-chars"--></A>
20210 option may be used to modify this token slightly.
20211 It is also possible to color keywords in the index using the
20212 Setup/Kolor screen (<A HREF="h_config_kw_color">Keyword Colors</A>).
20213 </DD>
20214
20215 <DT>SHORTSUBJKEY</DT>
20216 <DD> This token is the same as SUBJKEY, but it is based on
20217 SHORTSUBJECT, instead of in SUBJECT.
20218 </DD>
20219
20220 <DT>SUBJKEYINIT</DT>
20221 <DD>
20222 This token is the same as the SUBJKEY token except that instead of
20223 prepending a list of keywords to the subject, a list of first initials
20224 of keywords will be prepended instead.
20225 For example, if a message has the keywords <EM>Work</EM> and <EM>Now</EM>
20226 set (or Work and Now are the Alpine nicknames of keywords that are set)
20227 then the SUBJKEY token would cause a result like
20228 <P>
20229 <CENTER><SAMP>{Work Now} actual subject</SAMP></CENTER>
20230 <P>
20231 whereas the SUBJKEYINIT token would give
20232 <P>
20233 <CENTER><SAMP>{WN} actual subject</SAMP></CENTER>
20234 <P>
20235 Only those keywords that you have defined in your
20236 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option
20237 in Setup/Config are considered in the list.
20238 In other words, keywords that have been set by some other means, perhaps
20239 by another email program, won't show up unless included in
20240 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>.
20241 The <A HREF="h_config_kw_braces"><!--#echo var="VAR_keyword-surrounding-chars"--></A>
20242 option may be used to modify this token slightly.
20243 It is also possible to color keywords in the index using the
20244 Setup/Kolor screen (<A HREF="h_config_kw_color">Keyword Colors</A>).
20245 </DD>
20246
20247 <DT>SHORTSUBJKEYINIT</DT>
20248 <DD> This token is the same as SUBJKEYINIT, but it is based on
20249 SHORTSUBJECT, instead of in SUBJECT.
20250 </DD>
20251
20252 <DT>SUBJECTTEXT</DT>
20253 <DD>
20254 Same as SUBJECT but if there is room in the Subject field for more text,
20255 the opening part of the text of the message is displayed after the subject.
20256 The time needed to fetch the text may cause a performance problem
20257 which can, of course, be avoided by using the SUBJECT version of
20258 the Subject instead.
20259 You may color this opening text differently by using the
20260 <A HREF="h_config_index_opening_color">Index Opening Color</A> option available from
20261 the <A HREF="h_color_setup">Setup Kolor</A> screen.
20262 You may adjust the characters that are displayed between the Subject and the
20263 opening text with the option
20264 <A HREF="h_config_opening_sep"><!--#echo var="VAR_opening-text-separator-chars"--></A>.
20265 </DD>
20266
20267 <DT>SUBJKEYTEXT</DT>
20268 <DD>
20269 Same as SUBJKEY but with the opening message text.
20270 </DD>
20271
20272 <DT>OPENINGTEXT</DT>
20273 <DD>
20274 This is similar to SUBJECTTEXT.
20275 Instead of combining the Subject and the opening text in a single
20276 field in the index screen this token allows you to allocate a
20277 separate column just for the opening text of the message.
20278 The time needed to fetch this text may cause a performance problem.
20279 You may color this opening text differently by using the
20280 <A HREF="h_config_index_opening_color">Index Opening Color</A> option available from
20281 the <A HREF="h_color_setup">Setup Kolor</A> screen.
20282 </DD>
20283
20284 <DT>OPENINGTEXTNQ</DT>
20285 <DD>
20286 This is very similar to OPENINGTEXT.
20287 The NQ stands for No Quotes.
20288 The only difference is that quoted text (lines beginning with &gt;) is deleted.
20289 For some messages this may be confusing.
20290 For example, a message might have a line preceding some quoted
20291 text that reads something like &quot;On May 8th person A said.&quot;
20292 That no longer makes sense after the quoted text is deleted and it
20293 will appear that person A said whatever the text after the quote
20294 is, even though that is really person B talking.
20295 </DD>
20296
20297 <DT>SUBJKEYINITTEXT</DT>
20298 <DD>
20299 Same as SUBJKEYINIT but with the opening message text.
20300 </DD>
20301
20302 <DT>KEY</DT>
20303 <DD>
20304 This is a space-delimited list of keywords that are set for the message.
20305 Only those keywords that you have defined in your
20306 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option
20307 in Setup/Config are considered in the list.
20308 In other words, keywords that have been set by some other means, perhaps
20309 by another email program, won't show up unless included in
20310 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>.
20311 If you have given a keyword a nickname
20312 (<A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>), that nickname is displayed
20313 instead of the actual keyword.
20314 It is also possible to color keywords in the index using the
20315 Setup/Kolor screen (<A HREF="h_config_kw_color">Keyword Colors</A>).
20316 This token defaults to an arbitrary width of 5.
20317 You should set it to whatever width suits you using something
20318 like KEY(17) in the <!--#echo var="VAR_index-format"-->.
20319 </DD>
20320
20321 <DT>KEYINIT</DT>
20322 <DD>
20323 This is a list of keyword initials that are set for the message.
20324 If you have given a keyword a nickname
20325 (<A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>), the initial of that nickname
20326 is displayed instead of the initial of the actual keyword.
20327 It is also possible to color keyword initials in the index using the
20328 Setup/Kolor screen (<A HREF="h_config_kw_color">Keyword Colors</A>).
20329 This token defaults to an arbitrary width of 2.
20330 You should set it to whatever width suits you using something
20331 like KEYINIT(3) in the <!--#echo var="VAR_index-format"-->.
20332 </DD>
20333
20334 <DT>PRIORITY</DT>
20335 <DD>
20336 The X-Priority header is a non-standard header that is used in a
20337 somewhat standard way by many mail programs.
20338 Alpine expects the value of this header to be a digit with a value
20339 from 1 to 5, with 1 being the highest priority and 5 the lowest priority.
20340 Since this priority is something that the sender sets it is only an indication
20341 of the priority that the sender attaches to the mail and it is therefore almost
20342 totally unreliable for use as a filtering criterion.
20343 This token will display the numeric value of the priority if it is between
20344 1 and 5.
20345 It will be suppressed (blank) if the value is 3, which is normal priority.
20346 This token may be colored with the
20347 <A HREF="h_config_index_pri_color">Index Priority Symbol Colors</A>.
20348 </DD>
20349
20350 <DT>PRIORITYALPHA</DT>
20351 <DD>
20352 This is a more verbose interpretation of the X-Priority field.
20353 Once again nothing is displayed unless the value of the field
20354 is 1, 2, 4, or 5.
20355 The values displayed for those values are:
20356 <P>
20357 <TABLE>
20358 <TR> <TD>1</TD> <TD>Highest</TD> </TR>
20359 <TR> <TD>2</TD> <TD>High</TD> </TR>
20360 <TR> <TD>4</TD> <TD>Low</TD> </TR>
20361 <TR> <TD>5</TD> <TD>Lowest</TD> </TR>
20362 </TABLE>
20363 <P>
20364 This token may be colored with the
20365 <A HREF="h_config_index_pri_color">Index Priority Symbol Colors</A>.
20366 </DD>
20367
20368 <DT>PRIORITY!</DT>
20369 <DD>
20370 This is a one character, non-numeric version of the X-Priority field.
20371 If the value of the X-Priority header is 1 or 2 an exclamation
20372 point is displayed.
20373 If the value is 4 or 5 a &quot;v&quot; (think down arrow) is displayed.
20374 This token may be colored with the
20375 <A HREF="h_config_index_pri_color">Index Priority Symbol Colors</A>.
20376 </DD>
20377
20378 <DT>ATT</DT>
20379 <DD>
20380 This is a one column wide field that represents the number of attachments
20381 a message has. It will be blank if there are no attachments, a single
20382 digit for one to nine attachments, or an asterisk for more than nine.
20383 Note that including this token in
20384 the &quot;<!--#echo var="VAR_index-format"-->&quot; could slow down the
20385 display a little while Alpine collects the necessary information.
20386 </DD>
20387
20388 <DT>FROMORTO</DT>
20389 <DD>
20390 This token represents <EM>either</EM> the personal name (or email address) of
20391 the person listed in the message's &quot;From:&quot; header
20392 field, <EM>or</EM>, if that address is yours or one of your
20393 <A HREF="h_config_alt_addresses">alternate addresses</A>,
20394 the first person specified in the
20395 message's &quot;To:&quot; header field
20396 with the prefix &quot;To: &quot; prepended.
20397 If the from address is yours and there is also no &quot;To&quot; address,
20398 Alpine will use the address on the &quot;Cc&quot; line.
20399 If there is no address there, either, Alpine will look for a newsgroup name
20400 from the &quot;Newsgroups&quot; header field and put
20401 that after the &quot;To: &quot; prefix.
20402 </DD>
20403
20404 <DT>FROMORTONOTNEWS</DT>
20405 <DD>
20406 This is almost the same as <EM>FROMORTO</EM>.
20407 The difference is that newsgroups aren't considered.
20408 When a message is from you, doesn't have a To or Cc, and does have
20409 a Newsgroups header; this token will be your name instead of the name
20410 of the newsgroup (like it would be with FROMORTO).
20411 </DD>
20412
20413 <DT>TEXT</DT>
20414 <DD>
20415 This is a different sort of token.
20416 It allows you to display a label within each index line.
20417 It will be the same fixed text for each line.
20418 It is different from all the other tokens in that there is no space column
20419 displayed after this token.
20420 Instead, it is butted up against the following field.
20421 It also has a different syntax.
20422 The text to display is given following a colon after the
20423 word &quot;TEXT&quot;.
20424 For example,
20425 <P>
20426 <CENTER><SAMP>TEXT:abc=</SAMP></CENTER>
20427 <P>
20428 would insert the literal text &quot;abc=&quot; (without the quotes)
20429 into the index display line.
20430 You must quote the text if it includes space characters, like
20431 <P>
20432 <CENTER><SAMP>TEXT:&quot;abc&nbsp;=&nbsp;&quot;</SAMP></CENTER>
20433 <P>
20434 </DD>
20435
20436 <DT>HEADER</DT>
20437 <DD>
20438 This allows you to display the text from a particular header line in the
20439 message.
20440 The syntax for this token is substantially different from all the others
20441 in order that you might be able to display a portion of the text following
20442 a particular header.
20443 The header name you are interested in is given following a colon
20444 after the word &quot;HEADER&quot;.
20445 For example,
20446 <P>
20447 <CENTER><SAMP>HEADER:X-Spam</SAMP></CENTER>
20448 <P>
20449 would display the text of the X-Spam header, if any.
20450 Like for other index tokens a width field may (and probably should)
20451 follow this.
20452 <P>
20453 <CENTER><SAMP>HEADER:X-Spam(10)</SAMP></CENTER>
20454 <P>
20455 displays the first ten characters of the X-Spam header.
20456 Unlike other index tokens, the syntax for HEADER is more flexible.
20457 An optional second argument comes after a comma inside the parentheses.
20458 It specifies the &quot;field&quot; number.
20459 By default, the field separator is a space character.
20460 No extra space characters are allowed in the argument list.
20461 <P>
20462 <CENTER><SAMP>HEADER:X-Spam(10,2)</SAMP></CENTER>
20463 <P>
20464 would display the second field, left-justified, in a 10 character
20465 wide field.
20466 The second field would consist of all the text after the first space
20467 up to the next space or the end of the header.
20468 The default field number is zero, which stands for the entire line.
20469 There is also an optional third argument that is a list of field
20470 separators. It defaults to a space character.
20471 The example
20472 <P>
20473 <CENTER><SAMP>HEADER:X-Spam(10,2,:%&nbsp;)</SAMP></CENTER>
20474 <P>
20475 would cause the field separators to be any of colon, percent,
20476 or space (there is a space character between the percent and the
20477 right parenthesis).
20478 The first field runs from the start of the header value up to the first
20479 colon, percent, or space; the second goes from there to the next; and so on.
20480 In order to use a comma character as a field separator you must escape
20481 it by preceding it with a backslash (&#92;).
20482 The same is true of the backslash character itself.
20483 There is one further optional argument.
20484 It is an R or an L to specify right or left adjustment of the text
20485 within the field.
20486 The default is to left justify, however if you are displaying numbers
20487 you might prefer to right justify.
20488 <P>
20489 Here's an example of a SpamAssassin header.
20490 The exact look of the header will vary, but if your incoming mail
20491 contains headers that look like the following
20492 <P>
20493 <CENTER><SAMP>X-Spam-Status: Yes, hits=10.6 tagged_above=-999.0 required=7.0 tests=BAYE...</SAMP></CENTER>
20494 <P>
20495 you might want to display the hits value.
20496 The first field starts with the Y in Yes.
20497 To get what you're interested in you might use &quot;=&quot; and
20498 space as the field separators and display the third field, like
20499 <P>
20500 <CENTER><SAMP>HEADER:X-Spam-Status(4,3,=&nbsp;)</SAMP></CENTER>
20501 <P>
20502 or maybe you would break at the dot instead
20503 <P>
20504 <CENTER><SAMP>HEADER:X-Spam-Status(2,2,=.,R)</SAMP></CENTER>
20505 <P>
20506 Another example we've seen has headers that look like
20507 <P>
20508 <CENTER><SAMP>X-Spam: Gauge=IIIIIII, Probability=7%, Report=...</SAMP></CENTER>
20509 <P>
20510 Because there are two equals and a comma before the 7% and a comma
20511 after it, the token
20512 <P>
20513 <CENTER><SAMP>HEADER:X-Spam(3,4,=&#92;,,R)</SAMP></CENTER>
20514 <P>
20515 should display the probability (for example 7% or 83%) right justified
20516 in a 3-wide field.
20517 </DD>
20518
20519 <DT>ARROW</DT>
20520 <DD>
20521 This gives an alternative way to display the current message in the
20522 MESSAGE INDEX screen.
20523 Usually the current message is indicated by the line being shown in
20524 reverse video.
20525 Instead, if the ARROW token is included in your <!--#echo var="VAR_index-format"-->,
20526 the current line will include an &quot;arrow&quot; that
20527 looks like
20528 <P>
20529 <CENTER><SAMP>-&gt;</SAMP></CENTER>
20530 <P>
20531 in the ARROW token's field.
20532 For all of the non-current messages, the ARROW field will be filled
20533 with blanks.
20534 If you use the fixed-field width feature the length of the &quot;arrow&quot;
20535 may be adjusted.
20536 The arrow will be drawn as width-1 dashes followed by a greater than sign.
20537 For example, if you use ARROW(3) you will get
20538 <P>
20539 <CENTER><SAMP>--&gt;</SAMP></CENTER>
20540 <P>
20541 and ARROW(1) will give you just
20542 <P>
20543 <CENTER><SAMP>&gt;</SAMP></CENTER>
20544 <P>
20545 It is also possible to set the color of the ARROW field.
20546 By default (and for non-current messages) the arrow is colored the same
20547 as the index line it is part of.
20548 You may set it to be another color with the
20549 <A HREF="h_config_index_arrow_color">Index Arrow Color</A> option available from
20550 the <A HREF="h_color_setup">Setup Kolor</A> screen.
20551 </DD>
20552
20553 <DT>SCORE</DT>
20554 <DD>
20555 This gives the
20556 <a href="h_rules_score">score</a>
20557 of each message.
20558 This will be six columns wide to accommodate the widest possible score.
20559 You will probably want to use the <!--#echo var="VAR_index-format"--> fixed-field width feature
20560 to limit the width of the field to the widest score that
20561 you use (e.g. SCORE(3) if your scores are always between 0 and 999).
20562 If you have not defined any score rules the scores will all be zero.
20563 If any of your score rules contain AllText or BodyText patterns
20564 then including SCORE in the <!--#echo var="VAR_index-format"-->
20565 may slow down the display of the MESSAGE INDEX screen.
20566 </DD>
20567 </DL>
20568
20569 <P>
20570 <H1><EM>Tokens Available for all but <!--#echo var="VAR_index-format"--></EM></H1>
20571
20572 <DL>
20573 <DT>CURNEWS</DT>
20574 <DD>
20575 This token represents the current newsgroup if there is one.
20576 For example, &quot;comp.mail.pine&quot;.
20577 </DD>
20578
20579 <DT>MSGID</DT>
20580 <DD>
20581 This token represents the message ID of the message.
20582 This token does not work with Filter Rule folder names.
20583 </DD>
20584
20585 <DT>CURDATE</DT>
20586 <DD>
20587 This token represents the current date.
20588 It has the format MMM DD. For example, &quot;Oct 23&quot;.
20589 </DD>
20590
20591 <DT>CURDATEISO</DT>
20592 <DD>
20593 This token represents the current date.
20594 It has the format YYYY-MM-DD. For example, &quot;1998-10-23&quot;.
20595 </DD>
20596
20597 <DT>CURDATEISOS</DT>
20598 <DD>
20599 This token represents the current date.
20600 It has the format YY-MM-DD. For example, &quot;98-10-23&quot;.
20601 </DD>
20602
20603 <DT>CURPREFDATE</DT>
20604 <DD>
20605 This token represents the current date.
20606 It is your operating system's idea of the preferred date representation for the current locale.
20607 Internally it uses the %x version of the date from the strftime routine.
20608 </DD>
20609
20610 <DT>CURPREFTIME</DT>
20611 <DD>
20612 This token represents the current time.
20613 It is the preferred time representation for the current locale.
20614 Internally it uses the %X version of the time from the strftime routine.
20615 </DD>
20616
20617 <DT>CURPREFDATETIME</DT>
20618 <DD>
20619 This token represents the current date and time.
20620 It is the preferred date and time representation for the current locale.
20621 Internally it uses the %c version of the time from the strftime routine.
20622 </DD>
20623
20624 <DT>CURTIME24</DT>
20625 <DD>
20626 This token represents the current time.
20627 It has the format HH:MM. For example, &quot;17:28&quot;.
20628 </DD>
20629
20630 <DT>CURTIME12</DT>
20631 <DD>
20632 This token represents the current time.
20633 This time is for a 12 hour clock.
20634 It has the format HH:MMpm.
20635 For example, &quot;5:28pm&quot; or &quot;11:13am&quot;.
20636 </DD>
20637
20638 <DT>CURDAY</DT>
20639 <DD>
20640 This token represents the current day of the month.
20641 For example, &quot;23&quot; or &quot;9&quot;.
20642 </DD>
20643
20644 <DT>CURDAY2DIGIT</DT>
20645 <DD>
20646 This token represents the current day of the month.
20647 For example, &quot;23&quot; or &quot;09&quot;.
20648 It is always 2 digits.
20649 </DD>
20650
20651 <DT>CURDAYOFWEEK</DT>
20652 <DD>
20653 This token represents the current day of the week.
20654 For example, &quot;Sunday&quot; or &quot;Wednesday&quot;.
20655 </DD>
20656
20657 <DT>CURDAYOFWEEKABBREV</DT>
20658 <DD>
20659 This token represents the current day of the week.
20660 For example, &quot;Sun&quot; or &quot;Wed&quot;.
20661 </DD>
20662
20663 <DT>CURMONTH</DT>
20664 <DD>
20665 This token represents the current month.
20666 For example, &quot;10&quot; or &quot;9&quot;.
20667 </DD>
20668
20669 <DT>CURMONTH2DIGIT</DT>
20670 <DD>
20671 This token represents the current month.
20672 For example, &quot;10&quot; or &quot;09&quot;.
20673 It is always 2 digits.
20674 </DD>
20675
20676 <DT>CURMONTHLONG</DT>
20677 <DD>
20678 This token represents the current month.
20679 For example, &quot;October&quot;.
20680 </DD>
20681
20682 <DT>CURMONTHABBREV</DT>
20683 <DD>
20684 This token represents the current month.
20685 For example, &quot;Oct&quot;.
20686 </DD>
20687
20688 <DT>CURYEAR</DT>
20689 <DD>
20690 This token represents the current year.
20691 For example, &quot;1998&quot; or &quot;2001&quot;.
20692 </DD>
20693
20694 <DT>CURYEAR2DIGIT</DT>
20695 <DD>
20696 This token represents the current year.
20697 For example, &quot;98&quot; or &quot;01&quot;.
20698 It is always 2 digits.
20699 </DD>
20700
20701 <DT>LASTMONTH</DT>
20702 <DD>
20703 This token represents last month.
20704 For example, if this is November (the 11th month),
20705 it is equal to &quot;10&quot; or if this is October (the 10th month),
20706 it is &quot;9&quot;.
20707 It is possible that this and the other tokens beginning with LASTMONTH
20708 below could be useful when used with a Filtering Rule that
20709 has the &quot;Beginning of Month&quot; option set.
20710 </DD>
20711
20712 <DT>LASTMONTH2DIGIT</DT>
20713 <DD>
20714 This token represents last month.
20715 For example, if this is November (the 11th month),
20716 it is equal to &quot;10&quot; or if this is October (the 10th month),
20717 it is &quot;09&quot;.
20718 It is always 2 digits.
20719 </DD>
20720
20721 <DT>LASTMONTHLONG</DT>
20722 <DD>
20723 This token represents last month.
20724 For example, if this is November the value is &quot;October&quot;.
20725 </DD>
20726
20727 <DT>LASTMONTHABBREV</DT>
20728 <DD>
20729 This token represents last month.
20730 For example, if this is November the value is &quot;Oct&quot;.
20731 </DD>
20732
20733 <DT>LASTMONTHYEAR</DT>
20734 <DD>
20735 This token represents what the year was a month ago.
20736 For example, if this is October, 1998, it is &quot;1998&quot;.
20737 If this is January, 1998, it is &quot;1997&quot;.
20738 </DD>
20739
20740 <DT>LASTMONTHYEAR2DIGIT</DT>
20741 <DD>
20742 This token represents what the year was a month ago.
20743 For example, if this is October, 1998, it is &quot;98&quot;.
20744 If this is January, 1998, it is &quot;97&quot;.
20745 </DD>
20746
20747 <DT>LASTYEAR</DT>
20748 <DD>
20749 This token represents last year.
20750 For example, if this is 1998, it equals &quot;1997&quot;.
20751 It is possible that this
20752 could be useful when used with a Filtering Rule that
20753 has the &quot;Beginning of Year&quot; option set.
20754 </DD>
20755
20756 <DT>LASTYEAR2DIGIT</DT>
20757 <DD>
20758 This token represents last year.
20759 For example, if this is 1998, it equals &quot;97&quot;.
20760 It is always 2 digits.
20761 </DD>
20762
20763 <DT>ROLENICK</DT>
20764 <DD>
20765 This token represents the nickname of the
20766 role currently being used.  If no role is being used,
20767 then no text will be printed for this token.
20768 This token does not work with Filter Rule folder names.
20769 </DD>
20770 </DL>
20771
20772 <P>
20773 <H1><EM>Token Available Only for <!--#echo var="VAR_reply-leadin"--></EM></H1>
20774 See the help for the
20775 <A HREF="h_config_reply_intro">&quot;<!--#echo var="VAR_reply-leadin"-->&quot;</A> option
20776 to see why you might want to use this.
20777 Since the <!--#echo var="VAR_reply-leadin"--> contains free text this token
20778 must be surrounded by underscores when used.
20779
20780 <DL>
20781 <DT>NEWLINE</DT>
20782 <DD>
20783 This is an end of line marker.
20784 </DD>
20785 </DL>
20786
20787 <P>
20788 <H1><EM>Token Available Only for Templates and Signatures</EM></H1>
20789
20790 <DL>
20791 <DT>CURSORPOS</DT>
20792 <DD>
20793 This token is different from the others.
20794 When it is replaced it is replaced with nothing, but it sets an Alpine
20795 internal variable that tells the composer to start with the cursor
20796 positioned at the position where this token was.
20797 If both the template file and the signature file contain
20798 a &quot;CURSORPOS&quot; token, then the position in the template file
20799 is used.
20800 If there is a template file and neither it nor the signature file contains
20801 a &quot;CURSORPOS&quot; token, then the cursor is positioned
20802 after the end of the contents of the
20803 template file when the composer starts up.
20804 </DD>
20805 </DL>
20806
20807 <P>
20808 &lt;End of help on this topic&gt;
20809 </BODY>
20810 </HTML>
20811 ======= h_reply_token_conditionals =======
20812 <HTML>
20813 <HEAD>
20814 <TITLE>Conditional Inclusion of Text for <!--#echo var="VAR_reply-leadin"-->, Signatures, and Templates</TITLE>
20815 </HEAD>
20816 <BODY>
20817 <H1>Conditional Inclusion of Text for <!--#echo var="VAR_reply-leadin"-->, Signatures, and Templates</H1>
20818
20819 Conditional text inclusion may be used with
20820 the <A HREF="h_config_reply_intro">&quot;<!--#echo var="VAR_reply-leadin"-->&quot;</A> option,
20821 in signature files, and in template files used in
20822 <A HREF="h_rules_roles">&quot;roles&quot;</A>.
20823 It may <EM>not</EM> be used with the
20824 <A HREF="h_config_index_format">&quot;<!--#echo var="VAR_index-format"-->&quot;</A> option.
20825
20826 <P>
20827 There is a limited if-else capability for including text.
20828 The if-else condition is based
20829 on whether or not a given token would result in replacement text you
20830 specify.
20831 The syntax of this conditional inclusion is
20832 <P>
20833 <CENTER><SAMP>_token_(match_this, if_matched [ , if_not_matched ] )</SAMP></CENTER>
20834 <P>
20835 The left parenthesis must follow the underscore immediately, with no
20836 intervening space.
20837 It means the token is expanded and the results of that expansion are
20838 compared against the &quot;match_this&quot; argument.
20839 If there is an exact match, then the &quot;if_matched&quot; text is used
20840 as the replacement text.
20841 Otherwise, the &quot;if_not_matched&quot; text is used.
20842 One of the most useful values for the &quot;match_this&quot; argument is
20843 the empty string, &quot;&quot;.
20844 In that case the expansion is compared against the empty string.
20845 <P>
20846 Here's an example to make it clearer.
20847 This text could be included in one of your template files:
20848 <P>
20849 <CENTER><SAMP>_NEWS_(&quot;&quot;, &quot;I'm replying to email&quot;, &quot;I'm replying to news&quot;)</SAMP></CENTER>
20850 <P>
20851 If that is included in a template file that you are using while replying
20852 to a message (because you chose to use the role it was part of),
20853 and that message has a newsgroup header and a newsgroup in that header,
20854 then the text
20855 <P>
20856 <CENTER><SAMP>I'm replying to news</SAMP></CENTER>
20857 <P>
20858 will be included in the message you are about to compose.
20859 On the other hand, if the message you are replying to does not have
20860 a newsgroup, then the text
20861 <P>
20862 <CENTER><SAMP>I'm replying to email</SAMP></CENTER>
20863 <P>
20864 would be included instead.
20865 This would also work in signature files and in
20866 the &quot;<!--#echo var="VAR_reply-leadin"-->&quot; option.
20867 If the &quot;match_this&quot;, &quot;if_matched&quot;,
20868 or &quot;if_not_matched&quot; arguments contain
20869 spaces, parentheses, or commas;
20870 they have to be quoted with double quotation marks (like in the example
20871 above).
20872 If you want to include a literal quote (&quot;) in the text you must escape the
20873 quote by preceding it with a backslash (&#92;) character.
20874 If you want to include a literal backslash character you must escape it
20875 by preceding it with another backslash.
20876 <P>
20877 The comma followed by &quot;if_not_matched&quot; is optional.
20878 If there is no &quot;if_not_matched&quot;
20879 present then no text is included if the not_matched case is true.
20880 Here's another example:
20881 <P>
20882 <CENTER><SAMP>_NEWS_(&quot;&quot;, &quot;&quot;, &quot;This msg was seen in group: _NEWS_.&quot;)</SAMP></CENTER>
20883 <P>
20884 Here you can see that tokens may appear in the arguments.
20885 The same is true for tokens with the conditional parentheses.
20886 They may appear in arguments,
20887 though you do have to be careful to get the quoting and escaping of
20888 nested double quotes correct.
20889 If this was in the signature file being used and you were replying to a message
20890 sent to comp.mail.pine the resulting text would be:
20891 <P>
20892 <CENTER><SAMP>This msg was seen in group: comp.mail.pine.</SAMP></CENTER>
20893 <P>
20894 If you were replying to a message that wasn't sent to any newsgroup the
20895 resulting text would be a single blank line.
20896 The reason you'd get a blank line is because the end of the line is
20897 outside of the conditional, so is always included.
20898 If you wanted to get rid of that blank line you could do so by moving
20899 the end of line inside the conditional.
20900 In other words, it's ok to have multi-line
20901 &quot;if_matched&quot; or &quot;if_not_matched&quot; arguments in your
20902 template file.
20903 The text just continues until the next double quotation, even if it's not
20904 on the same line.
20905 <P>
20906 Here's an example for use in the &quot;<!--#echo var="VAR_reply-leadin"-->&quot;:
20907 <P>
20908 <CENTER><SAMP>On _DAYDATE_, _FROM__CURNEWS_(&quot;&quot;, &quot;&quot;, &quot;seen in _CURNEWS_,&quot;) wrote</SAMP></CENTER>
20909 <P>
20910 If this was in your <!--#echo var="VAR_reply-leadin"--> and you were replying to a message
20911 while reading the newsgroup comp.mail.pine the resulting text would be:
20912 <P>
20913 <CENTER><SAMP>On Sat, 24 Oct 1998, Fred Flintstone, seen in comp.mail.pine, wrote:</SAMP></CENTER>
20914 <P>
20915 If you were replying to a message while reading an email folder instead
20916 of a newsgroup the resulting leadin text would be
20917 <P>
20918 <CENTER><SAMP>On Sat, 24 Oct 1998, Fred Flintstone wrote:</SAMP></CENTER>
20919 <P>
20920 Here's one more (contrived) example illustrating a matching argument
20921 that is not the empty string.
20922 <P>
20923 <CENTER><SAMP>_SMARTDATE_("Today", _SMARTDATE_, "On _DATE_") _FROM_ wrote:</SAMP></CENTER>
20924 <P>
20925 If this was the value of your &quot;<!--#echo var="VAR_reply-leadin"-->&quot; option and you
20926 were replying to
20927 a message that was sent today, then the value of the &quot;<!--#echo var="VAR_reply-leadin"-->&quot;
20928 would be
20929 <P>
20930 <CENTER><SAMP>Today Fred Flintstone wrote:</SAMP></CENTER>
20931 <P>
20932 But if you were replying to a message sent on Oct. 27 (and that wasn't
20933 today) you would get
20934 <P>
20935 <CENTER><SAMP>On Oct 27 Fred Flintstone wrote:</SAMP></CENTER>
20936 <P>
20937
20938 &lt;End of help on this topic&gt;
20939 </BODY>
20940 </HTML>
20941 ======= h_composer_cntxt_nick =======
20942 <HTML>
20943 <HEAD>
20944 <TITLE>Collection Nickname Explained</TITLE>
20945 </HEAD>
20946 <BODY>
20947 <H1>Collection Edit Help -- Nickname Field</H1>
20948
20949 This field is provided so you can add a short nickname to use when
20950 referring to this collection within Alpine.  Spaces are allowed, and
20951 you don't need to use double-quotes.  However, the double-quote
20952 character is not allowed.
20953 <P>
20954 Look <A HREF="h_edit_nav_cmds">here</A>
20955 to see the available Editing and Navigation commands.
20956 <P>
20957 &lt;End of help on this topic&gt;
20958 </BODY>
20959 </HTML>
20960 ======= h_folder_server_syntax =======
20961 <HTML>
20962 <HEAD>
20963 <TITLE>Server Name Syntax</TITLE>
20964 </HEAD>
20965 <BODY>
20966 <H1>Server Name Syntax</H1>
20967
20968 This help describes the syntax that may be used for server names
20969 that may be associated with remote folders or SMTP servers.
20970
20971 <P>
20972 A server name is the hostname of the server.
20973 It's a good idea to use the host's fully-qualified network name.
20974
20975 <P>
20976 <CENTER><SAMP>foo.example.com</SAMP></CENTER>
20977 <P>
20978
20979 However, IP addresses are allowed if surrounded
20980 with square-brackets.
20981
20982 <P>
20983 <CENTER><SAMP>[127.0.0.1]</SAMP></CENTER>
20984 <P>
20985
20986 An optional network port number may be supplied by appending
20987 a colon (:) followed by the port number
20988 to the server name.
20989 By default, the IMAP port number, 143, is used.
20990
20991 <P>
20992 <CENTER><SAMP>foo.example.com:port</SAMP></CENTER>
20993 <P>
20994
20995 Besides server name and optional port number, various other optional
20996 parameters may be supplied that alter Alpine's interaction with the server.
20997 A parameter is supplied by appending a slash (/) character followed by
20998 the parameter's name and,
20999 depending on the particular parameter, the value assigned to that
21000 name, to the server name (and optional port number).
21001 Parameter names are <EM>not</EM> case sensitive.
21002 Currently supported parameters include:
21003
21004 <DL>
21005
21006 <DT>User</DT>
21007 <DD>This parameter requires an associated value, and is intended to
21008 provide the username identifier with which to establish the server
21009 connection.
21010 If your SMTP server offers SMTP AUTH authentication, adding this
21011 parameter to the
21012 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>
21013 option will cause Alpine to attempt to authenticate to the server using the
21014 supplied username.
21015 Similarly, if your NNTP server offers NNTP &quot;AUTHINFO SASL&quot;
21016 or &quot;AUTHINFO USER&quot; authentication, adding this parameter to the
21017 <A HREF="h_config_nntp_server"><!--#echo var="VAR_nntp-server"--></A>
21018 option (or to the server name for any folder collection using NNTP)
21019 will cause Alpine to attempt
21020 to authenticate to the server using the supplied username.
21021 An example might be:
21022
21023 <P>
21024 <CENTER><SAMP>/user=katie</SAMP></CENTER>
21025 <P>
21026
21027 </DD>
21028
21029 <DT>STARTTLS</DT>
21030 <DD>
21031 This is a unary parameter indicating communication with the server must
21032 take place over a TLS connection. If you use this parameter, Alpine will
21033 establish an insecure connection to the server, and later will attempts to
21034 use a secure encrypted connection. If the attempt to use TLS fails then
21035 this parameter will cause the connection to fail instead of falling back
21036 to an insecure connection.
21037 <P>
21038 Use this option when you are told to use STARTTLS. If you are told to use
21039 SSL or TLS on port 993, use the /ssl unary parameter instead, and not this
21040 parameter. Use this parameter when establishing a connection to a server
21041 on an insecure port (normally port 143 for IMAP) and then needing to
21042 establish a secure connection using STARTTLS.
21043
21044 <P><A href="h_security_considerations">Learn more</A> about security
21045 considerations when you use this option.
21046
21047 <P>
21048 <CENTER><SAMP>/starttls</SAMP></CENTER>
21049 <P>
21050
21051 </DD>
21052
21053 <DT>SSL</DT>
21054 <DD>
21055 This is a unary parameter indicating communication with the server should
21056 take place over a Secure Socket Layer connection.  The server must support
21057 this method, and be prepared to accept connections on the appropriate
21058 port (993 by default).
21059 Alpine must be linked with an SSL library for this option to be operational.
21060 Using this option will make Alpine try to connect to the server using the
21061 most secure encrypted SSL connection that both your version of Alpine and the
21062 server support.
21063
21064 <P>
21065 <CENTER><SAMP>/ssl</SAMP></CENTER>
21066 <P>
21067
21068 </DD>
21069
21070 <DT>TLS1</DT>
21071 <DD>
21072 This parameter indicates that the connection to the server will be made
21073 over the SSL port, but using the TLSv1 protocol, instead of the usual
21074 SSLv3 or SSLv2 protocols.
21075 Alpine must be linked with an SSL library for this option to be operational.
21076
21077 <P>
21078 <CENTER><SAMP>/tls1</SAMP></CENTER>
21079 <P>
21080 </DD>
21081
21082 <DT>TLS1_1</DT>
21083 <DD>
21084 This parameter indicates that the connection to the server will be made
21085 over the SSL port, but using the TLSv1.1 protocol.
21086 Alpine must be linked with an SSL library that supports this encryption
21087 protocol for this option to be operational.
21088
21089 <P>
21090 <CENTER><SAMP>/tls1_1</SAMP></CENTER>
21091 <P>
21092 </DD>
21093
21094 <DT>TLS1_2</DT>
21095 <DD>
21096 This parameter indicates that the connection to the server will be made
21097 over the SSL port, but using the TLSv1.2 protocol.
21098 Alpine must be linked with an SSL library that supports this encryption
21099 protocol for this option to be operational.
21100
21101 <P>
21102 <CENTER><SAMP>/tls1_2</SAMP></CENTER>
21103 <P>
21104 </DD>
21105
21106 <DT>TLS1_3</DT>
21107 <DD>
21108 This parameter indicates that the connection to the server will be made
21109 over the SSL port, but using the TLSv1.3 protocol.
21110 Alpine must be linked with an SSL library that supports this encryption
21111 protocol for this option to be operational.
21112
21113 <P>
21114 <CENTER><SAMP>/tls1_3</SAMP></CENTER>
21115 <P>
21116 </DD>
21117
21118 <DT>NoValidate-Cert</DT>
21119 <DD>Do not validate certificates (for TLS or SSL connections) from the server.
21120 This is needed if the server uses self-signed certificates or if Alpine
21121 cannot validate the certificate for some other known reason. You should avoid
21122 using this option, and instead install the certificate of the server, so you
21123 are not a victim of a cracker-in-the-middle attack.
21124 <P>
21125 </DD>
21126
21127 <DT>Anonymous</DT>
21128 <DD>This is a unary parameter (that means it does not have a value)
21129 indicating that the connection be logged in as
21130 &quot;anonymous&quot; rather than a specific user.
21131 Not all servers offer anonymous
21132 access; those which do generally only offer read-only access to certain
21133 &quot;public&quot; folders.
21134
21135 <P>
21136 <CENTER><SAMP>/anonymous</SAMP></CENTER>
21137 <P>
21138
21139 </DD>
21140
21141 <DT>Secure</DT>
21142 <DD>This is a unary parameter indicating that the connection use the
21143 most secure authentication method mutually supported by Alpine and the
21144 server.
21145 Alpine is capable of authenticating connections to
21146 the server using several methods.
21147 By default, Alpine will attempt each
21148 method until either a connection is established or the
21149 list of methods is exhausted.
21150 This parameter causes Alpine to instead fail
21151 the connection if the first (generally most &quot;secure&quot;) method fails.
21152
21153 <P>
21154 <CENTER><SAMP>/secure</SAMP></CENTER>
21155 <P>
21156
21157 </DD>
21158
21159 <DT>Submit</DT>
21160 <DD>This is a unary parameter for use with the
21161 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A> option.
21162 It indicates that the connection should be made to the Submit server
21163 (<A HREF="http://www.ietf.org/rfc/rfc2476.txt">RFC 3676</A>)
21164 (port 587) instead of the SMTP port (25).
21165 At the time this help was written the submit option was equivalent to
21166 specifying port 587. <A href="h_security_considerations">Learn more</A>
21167 about security considerations when you use this option.
21168
21169 <P>
21170 <CENTER><SAMP>/submit</SAMP></CENTER>
21171 <P>
21172 or
21173 <P>
21174 <CENTER><SAMP>host:587</SAMP></CENTER>
21175 <P>
21176
21177 </DD>
21178
21179 <DT>Debug</DT>
21180 <DD>This is a unary parameter indicating that the connection be established
21181 in a verbose mode.  Basically, it causes Alpine to log the communication with
21182 the server in Alpine's debug file.
21183 Normally, the pine -d command-line flag would be used instead.
21184 <P>
21185 </DD>
21186
21187 <DT>NoRsh</DT>
21188 <DD>By default, Alpine attempts to login using &quot;rsh&quot;,
21189 the UNIX remote shell program.
21190 Including &quot;NoRsh&quot; will cause connections to this server to skip
21191 the &quot;rsh&quot; attempt.
21192 This might be useful to avoid long timeouts caused by rsh firewalls, for
21193 example.
21194 <P>
21195 </DD>
21196
21197 <DT>Loser</DT>
21198 <DD>This option makes sense only for IMAP servers that do not perform
21199 a SEARCH command correctly. If your filtering rules
21200 fail to filter some messages, that should have been filtered, then this
21201 option will make Alpine download all data necessary data to perform that
21202 search. There is a performance penalty when using this option. Downloading
21203 the data to perform the search will take longer than requesting the IMAP
21204 server to perform the filtering, but the filtering will be done correctly.
21205 <P>
21206 </DD>
21207
21208
21209 <DT>Service</DT>
21210 <DD>This parameter requires an associated value.  The default value is
21211 &quot;IMAP&quot; which indicates communication with the server based
21212 on the IMAP4rev1 protocol (defined in RFC 3501 -- see
21213 <A HREF="http://www.imap.org/docs/rfc3501.html">http://www.imap.org/docs/rfc3501.html</A>).</DD>
21214
21215 Other service values include:
21216  <DL>
21217  <DT>NNTP</DT>
21218  <DD>This value indicates communication with the server takes place via
21219 the Network News Transfer Protocol.  Use this to define a collection
21220 of newsgroups on a remote news server.  So
21221
21222 <P>
21223 <CENTER><SAMP>/service=NNTP</SAMP></CENTER>
21224 <P>
21225 or just
21226 <P>
21227 <CENTER><SAMP>/NNTP</SAMP></CENTER>
21228 <P>
21229
21230 is the way to specify NNTP access.
21231 <P>
21232  </DD>
21233
21234  <DT>POP3</DT>
21235  <DD>This value indicates communication with the server takes place via the
21236 Post Office Protocol 3 protocol.
21237
21238 <P>
21239 <CENTER><SAMP>/service=POP3</SAMP></CENTER>
21240 <P>
21241 or just
21242 <P>
21243 <CENTER><SAMP>/POP3</SAMP></CENTER>
21244 <P>
21245
21246 Note that there are several important issues
21247 to consider when selecting this option:
21248 <OL>
21249  <LI> POP3 provides access to only your INBOX.  In other words,
21250 secondary folders such as your &quot;saved-messages&quot; are inaccessible.
21251  <LI> Alpine's implementation of POP3 does not follow the traditional POP
21252 model and will leave your mail on the server. Refer to the
21253 <A HREF="h_maildrop">Mail Drop</A> functionality for a possible way around this problem.
21254  <LI> See the discussion about new-mail checking in <A HREF="h_config_reopen_rule">&quot;<!--#echo var="VAR_folder-reopen-rule"-->&quot;</A>.
21255 </OL>
21256 </DD>
21257 </DL>
21258 </DL>
21259
21260 <P>
21261 Note that it is possible to include more than one parameter in a server
21262 specification by concatenating the parameters. For example:
21263
21264 <P>
21265 <CENTER><SAMP>foo.example.com:port/user=katie/novalidate-cert/debug</SAMP></CENTER>
21266 <P>
21267
21268 <P>
21269 &lt;End of help on this topic&gt;
21270 </BODY>
21271 </HTML>
21272 ======= h_security_considerations =======
21273 <HTML>
21274 <HEAD>
21275 <TITLE>SSL, TLS, STARTTLS and More Security Considerations</TITLE>
21276 </HEAD>
21277 <BODY>
21278 <H1>SSL, TLS, STARTTLS and More Security Considerations</H1>
21279
21280 The purpose of this text is to educate users on how to best choose
21281 the type of security connection to a remote server using the SSL and TLS
21282 encryption protocols.
21283
21284 <P>
21285 In the past, and when Alpine originally started to support encrypted connections
21286 to remote servers, the /ssl modifier was needed, and it meant any of the SSLv2
21287 or SSLv3 protocols. Those encryption protocols are considered not fully secure
21288 anymore, and in fact, you might not be able to use them anymore.
21289
21290 <P> Today the /ssl modifier means to use the most secure encryption
21291 protocol between your version of Alpine and what the server supports. This
21292 might mean more modern protocols, such as TLS 1.0, TLS 1.1, etc. As of
21293 this writing, Alpine supports connection using TLS 1.3. These protocols
21294 are considered more secure today and they should be preferred over the old
21295 SSL protocols.
21296
21297 <P> A source of confusion for Alpine users might be the meaning of the
21298 modifier /tls with respect to the names of the encryption protocols, such
21299 as TLS 1.2. The meaning of /tls is to start an encrypted connection to a
21300 server after an insecure connection has been established, and we will
21301 discuss this later in this help text. The preferred way flag is to use
21302 /starttls, instead of /tls.
21303
21304 <P>The best way to start an encrypted connection to a server is to use the
21305 /ssl modifier. If your provider allows encrypted connections on port 993
21306 for IMAP, or port 995 for POP3, or in port 465 for SMTP, just define your
21307 server by adding the /ssl modifier and do not add the port to the server.
21308 Alpine knows that the secure connection will be done in the correct port,
21309 and will use the most secure encryption available between Alpine and the
21310 server. You only need to use the port number when it is different from the
21311 default port numbers for this type of connections, and those were given
21312 above.
21313
21314 <P>Most email service providers identify secure connections by saying
21315 &quot;SSL or TLS&quot;. In this case, use the /ssl modifier, and only use
21316 the port number in case it is different to the ones above.
21317
21318 <P>If your service provider says to use STARTTLS, then you need to use the
21319 /starttls modifier. If your service provider gives you the option to use SSL or
21320 TLS and to use STARTTLS choose the secure port and choose the /ssl
21321 modifier. This is because connections using the /starttls modifier can be
21322 attacked and your username and password can be stolen by a hacker. The next
21323 paragraph describes in short how to do this.
21324
21325 <P> When you use the /starttls modifier, Alpine connects insecurely to the
21326 remote server. Because the connection is insecure, it is possible that you
21327 connect to a different server, which connects you to the real server. This
21328 is called &quot;man-in-the-middle&quot; attack, and so your communication
21329 will pass through the hackers computer before it reaches the real target.
21330 An example of a possible man-in-the-middle is your internet service provider,
21331 or your employer in some instances.
21332 This means that the hacker can modify the replies from the correct server
21333 and give you the illusion of security before you are actually connected to
21334 the secure server. Therefore, you might disclose your username and
21335 password to the hacker before you establish a secure connection to the correct
21336 server.
21337
21338 <P> Therefore, if possible avoid using STARTTLS (for IMAP and POP) or SUBMIT
21339 for SMTP (in port 587), as these are subject to attack. If possible
21340 ask your provider for secure connections for SSL or TLS in the secure ports
21341 993 for IMAP, 995 for POP or 465 for SMTP.
21342
21343 <P> In the current state, even as of TLS 1.3, these protocols are considered
21344 secure but they do not protect your privacy. For example your internet
21345 service provider might track to which servers you are connecting securely.
21346 Encryption protocols are evolving to not only protect the security of your
21347 data, but also your privacy.
21348
21349 <P> Other types of errors can lead to insecure connections. An example is
21350 when the name of the server as provided by the user does not match the
21351 name of the server in the certificate.
21352 <A href="h_tls_validation_failure">Read more</A> about security errors
21353 of this type and learn how to protect yourself against this type of
21354 errors.
21355
21356 <P>
21357 &lt;End of help on this topic&gt;
21358 </BODY>
21359 </HTML>
21360 ======= h_composer_cntxt_server =======
21361 <HTML>
21362 <HEAD>
21363 <TITLE>Collection Server: Explained</TITLE>
21364 </HEAD>
21365 <BODY>
21366 <H1>Collection Edit Help -- Server Field</H1>
21367
21368 This collection's &quot;Server:&quot; definition indicates the
21369 hostname of the server providing access to the folders in this
21370 collection.
21371 The syntax of this server name is the same as for other server names used
21372 in remote folder names in
21373 Alpine and is described
21374 <A HREF="h_folder_server_syntax">here</A>.
21375
21376 <P>
21377 &lt;End of help on this topic&gt;
21378 </BODY>
21379 </HTML>
21380 ======= h_composer_cntxt_path =======
21381 <HTML>
21382 <HEAD>
21383 <TITLE>Collection Path: Explained</TITLE>
21384 </HEAD>
21385 <BODY>
21386 <H1>Collection Edit Help -- Path Field</H1>
21387
21388 The collection's &quot;Path:&quot; definition indicates the location
21389 of the folders in this collection.  If the path or any of its components
21390 do not exist, Alpine will prompt you for their creation when exiting the
21391 Add/Change screen.
21392
21393 <P>
21394 By default the path is interpreted as defining a section of your personal
21395 folder area.  This area and how you specify it are defined by the
21396 server, if one is specified in the collection, or, typically, the home
21397 directory if no server is defined.
21398
21399 <P>
21400 To define a collection outside the default &quot;area&quot;, prefix
21401 the path with the &quot;namespace&quot; to use when interpreting the
21402 given path.  If a namespace is specified, the Path begins with the
21403 sharp, &quot;#&quot;, character followed by the name of the namespace
21404 and then the namespace's path-element-delimiter.  Aside from the
21405 path's format, namespaces can also imply access rights, content
21406 policy, audience, location, and, occasionally, access methods.
21407
21408 <P>
21409 Each server exports its own set (possibly of size one) of
21410 namespaces.  Hence, it's likely communication with your server's
21411 administrator will be required for specific configurations.  Some of
21412 the more common namespaces, however, include:
21413
21414 <DL>
21415 <DT>#news.</DT>
21416 <DD>This specifies a set of folders in the newsgroup namespace.  Newsgroup
21417 names are hierarchically defined with each level delimited by a period.
21418 </DD>
21419 <DT>#public/</DT>
21420 <DD>This specifies a folder area that the server may export to the general
21421 public.
21422 </DD>
21423 <DT>#shared/</DT>
21424 <DD>This specifies a folder area that the folder may export to groups
21425 of users.
21426 </DD>
21427 <DT>#ftp/</DT>
21428 <DD>This specifies a folder area that is the same as that it may have
21429 exported via the &quot;File Transfer Protocol&quot;.
21430 </DD>
21431 <DT>#mh/</DT>
21432 <DD>This specifies the personal folder area associated with folders
21433 and directories that were created using the MH message handling system.
21434 </DD>
21435 </DL>
21436 <P>
21437
21438 In addition, the server may support access to other user's folders,
21439 provided you have suitable permissions.  Common methods use a prefix
21440 of either &quot;~<VAR>user</VAR>/&quot;, or &quot;/<VAR>user</VAR>/&quot; to
21441 indicate the root of the other user's folder area.
21442
21443 <P>
21444 No, nothing's simple.
21445
21446 <P>
21447 &lt;End of help on this topic&gt;
21448 </BODY>
21449 </HTML>
21450 ======= h_composer_cntxt_view =======
21451 <HTML>
21452 <HEAD>
21453 <TITLE>Collection View: Explained</TITLE>
21454 </HEAD>
21455 <BODY>
21456 <H1>Collection Edit Help -- View Field</H1>
21457
21458 The collection's &quot;View:&quot; definition provides a way to limit
21459 the displayed list of folders within a collection.  By default, only
21460 folders that contain the specified characters anywhere in their name
21461 are shown in the collection's folder list.
21462
21463 <P>
21464 Additionally, you can use a wildcard character to better control
21465 the list of folders selected for display.  The wildcard specifier is
21466 the star, &quot;*&quot;, character.
21467
21468 <P>
21469 So, for example, to define a collection of all folders ending with
21470 &quot;c&quot;, you'd specify a view of &quot;*c&quot; (without the
21471 quote characters!).  Or, similarly, to define a collection of folders
21472 whose names start with &quot;a&quot; and end with &quot;z&quot;, you'd
21473 specify a view of &quot;a*z&quot;.
21474
21475 <P>
21476 &lt;End of help on this topic&gt;
21477 </BODY>
21478 </HTML>
21479 ======= h_composer_abook_add_server =======
21480 <HTML>
21481 <HEAD>
21482 <TITLE>Addressbook Server Name Field Explained</TITLE>
21483 </HEAD>
21484 <BODY>
21485 This field should be left blank if the address book is stored in a regular
21486 file on this system.  If it is a remote address book stored on an IMAP
21487 server then this is the name of that IMAP server.
21488 <P>
21489 Look <A HREF="h_edit_nav_cmds">here</A>
21490 to see the available Editing and Navigation commands.
21491 <P>
21492 &lt;End of help on this topic&gt;
21493 </BODY>
21494 </HTML>
21495 ======= h_composer_abook_add_folder =======
21496 <HTML>
21497 <HEAD>
21498 <TITLE>Addressbook Folder Name Field Explained</TITLE>
21499 </HEAD>
21500 <BODY>
21501 For a remote address book (one for which the Server Name is filled in)
21502 this is the name of a folder on the remote server. The address book data
21503 will be stored in this folder. This folder should be used only for
21504 storing this single address book, not for other address books or for
21505 other messages.
21506 <P>
21507 For a local address book (one for which the Server Name is not filled in)
21508 this is the name of a file in which the address book will be stored.
21509 The file is in the same directory as the Alpine configuration file if the
21510 configuration file is local.
21511 If the configuration file is remote, then this will be in the home directory
21512 for Unix Alpine and in the directory specified by the
21513 &quot;-aux local_directory&quot; command line argument.
21514 <P>
21515 Look <A HREF="h_edit_nav_cmds">here</A>
21516 to see the available Editing and Navigation commands.
21517 <P>
21518 &lt;End of help on this topic&gt;
21519 </BODY>
21520 </HTML>
21521 ======= h_composer_abook_add_nick =======
21522 <HTML>
21523 <HEAD>
21524 <TITLE>Addressbook NickName Field Explained</TITLE>
21525 </HEAD>
21526 <BODY>
21527 This is just an optional nickname for this address book. If present, it
21528 is used in some of the displays and error messages in the address book
21529 maintenance screens. It is for your convenience only and serves no
21530 other purpose.
21531 <P>
21532 Look <A HREF="h_edit_nav_cmds">here</A>
21533 to see the available Editing and Navigation commands.
21534 <P>
21535 &lt;End of help on this topic&gt;
21536 </BODY>
21537 </HTML>
21538 ======= h_composer_qserv_cn =======
21539 <HTML>
21540 <HEAD>
21541 <TITLE>Directory Query Form Explained</TITLE>
21542 </HEAD>
21543 <BODY>
21544
21545 Fill in as many of these fields as you wish to narrow down your
21546 search. All the fields you fill in must match in order for an entry
21547 to be returned. You may use the wildcard character &quot;*&quot; in
21548 any of the fields, it matches any zero or more characters at that
21549 point in the string. There are no implicit wildcards, so the match is
21550 exact unless you include wildcards.
21551 <P>
21552
21553 Note that if an attribute isn't present at all, then the match will fail.
21554 For example, if a server doesn't support the Locality attribute, then no
21555 matter what you put in the Locality field (other than leaving it empty)
21556 the search will fail.
21557 <P>
21558
21559 This field, the Common Name field, is typically a person's full name.
21560 <P>
21561
21562 <H1>EDITING and NAVIGATION COMMANDS</H1>
21563 <!--chtml if pinemode="function_key"-->
21564 <PRE>
21565 CURSOR MOTION KEYS----------------------|EDITING KEYS-------------------------
21566 ^B (Left Arrow)    Back character       | ^D       Delete current character
21567 ^F (Right Arrow)   Forward character    | ^H (DEL) Delete previous character
21568 ^P (Up Arrow)      Previous line        |
21569 ^N (Down Arrow)    Next line            | F9       Cut marked text or
21570 ^A                 Beginning of line    |            delete current line
21571 ^E                 End of line          | F10      Undelete line(s)
21572 F7                 Previous page        |
21573 F8                 Next page            |-------------------------------------
21574 ^@ (Ctrl-SPACE)    Next word            | MISCELLANEOUS COMMANDS
21575 ----------------------------------------|
21576 EXIT COMMANDS    |  GENERAL COMMANDS    | F5    Restore previous search
21577 F2   Cancel      |   F1    Get help     |
21578 F3   Search      |   ^Z    Suspend      | ^L    Redraw Screen
21579 </PRE>
21580 <!--chtml else-->
21581 <PRE>
21582 CURSOR MOTION KEYS----------------------|EDITING KEYS-------------------------
21583 ^B (Left Arrow)    Back character       | ^D       Delete current character
21584 ^F (Right Arrow)   Forward character    | ^H (DEL) Delete previous character
21585 ^P (Up Arrow)      Previous line        |
21586 ^N (Down Arrow)    Next line            | ^K       Cut marked text or
21587 ^A                 Beginning of line    |            delete current line
21588 ^E                 End of line          | ^U       Undelete line(s)
21589 ^Y                 Previous page        |
21590 ^V                 Next page            |-------------------------------------
21591 ^@ (Ctrl-SPACE)    Next word            | MISCELLANEOUS COMMANDS
21592 ----------------------------------------|
21593 EXIT COMMANDS    |  GENERAL COMMANDS    | ^R     Restore previous search
21594 ^C   Cancel      |   ^G    Get help     |
21595 ^X   Search      |   ^Z    Suspend      | ^L     Redraw Screen
21596 </PRE>
21597 <!--chtml endif-->
21598 <P><UL>
21599 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21600 </UL><P>
21601 &lt;End of help on this topic&gt;
21602 </BODY>
21603 </HTML>
21604 ======= h_composer_qserv_sn =======
21605
21606 The Surname is usually the family name of a person.
21607
21608 <End of help on this topic>
21609 ======= h_composer_qserv_gn =======
21610
21611 This is the part of a person's name that isn't the surname or initials.
21612
21613 <End of help on this topic>
21614 ======= h_composer_qserv_mail =======
21615
21616 This is the email address of a person.
21617
21618 <End of help on this topic>
21619 ======= h_composer_qserv_org =======
21620
21621 This is the organization a person belongs to.
21622
21623 <End of help on this topic>
21624 ======= h_composer_qserv_unit =======
21625
21626 This is the organizational unit a person belongs to.
21627
21628 <End of help on this topic>
21629 ======= h_composer_qserv_country =======
21630
21631 This is the country a person belongs to.
21632
21633 <End of help on this topic>
21634 ======= h_composer_qserv_state =======
21635
21636 This is the state a person belongs to.
21637
21638 <End of help on this topic>
21639 ======= h_composer_qserv_locality =======
21640
21641 This is the locality a person belongs to.
21642
21643 <End of help on this topic>
21644 ======= h_composer_qserv_custom =======
21645
21646 This one is for advanced users only! If you put something in this field,
21647 then the rest of the fields are ignored.
21648
21649 This field may be set to the string representation of an LDAP search
21650 filter (see RFC1960). Here are some examples:
21651
21652 To search for an entry with a surname equal to "clinton" you could set
21653 the custom filter to:
21654
21655      (sn=clinton)
21656
21657 This is equivalent to putting "clinton" in the SurName field.
21658 To search for an entry that has a surname that begins with "clint" and
21659 has a givenname equal to "william" you could use:
21660
21661      (&(sn=clint*)(givenname=william))
21662
21663 This is equivalent to setting the SurName field to "clint*" and the
21664 GivenName field to "william".
21665 To search for an entry where either the common name OR the email address
21666 contains "abcde" you could use:
21667
21668      (|(cn=*abcde*)(mail=*abcde*))
21669
21670 That isn't equivalent to anything you can do by setting the other fields
21671 because of the OR.
21672
21673 <End of help on this topic>
21674 ======= h_composer_qserv_qq =======
21675
21676 This one is a little different from the rest of the categories.  It causes
21677 a search to be formed from the configured search filter that you filled
21678 in when you added the directory server to your configuration. It can also
21679 be combined with the other fields if you'd like.
21680
21681 <End of help on this topic>
21682 ======= h_address_format =======
21683 <HTML>
21684 <HEAD>
21685 <TITLE>INTERNET EMAIL ADDRESS FORMAT</TITLE>
21686 </HEAD>
21687 <BODY>
21688 <H1>INTERNET EMAIL ADDRESS FORMAT</H1>
21689
21690 A valid email address on the Internet has a username, an &quot;@&quot; sign,
21691 and then a domain, with no spaces.
21692 For example, jsmith@art.example.com might be the email address
21693 of a person
21694 with the username &quot;jsmith&quot; who has an account in the domain
21695 &quot;art.example.com&quot;.  The number of dot-separated segments on the
21696 right of the &quot;@&quot; sign can vary - a shorter example would be
21697 isabelle@elsewhere.edu (the shortest possible form: here, only the
21698 organization's domain is specified after the &quot;@&quot; sign); a longer
21699 example would be
21700  jsingh@shakti.edutech.example.com
21701 (here, the name of the host &quot;shakti&quot; in the domain
21702 edutech.example.com is also specified).
21703 <P>
21704 If you do not know the exact email address of someone you want to write
21705 to, ask them what it is using other means of communication than email; or
21706 use the tools for
21707 finding people's addresses that are available on the Internet.
21708 <P>
21709 If you are sending to someone on the same system as you are, you can leave
21710 the &quot;@&quot; sign and all the information to its right off of the
21711 address, and Alpine will fill it in automatically,
21712 unless the feature
21713 <A HREF="h_config_compose_rejects_unqual">&quot;<!--#echo var="FEAT_compose-rejects-unqualified-addrs"-->&quot;</A> is set in SETUP CONFIGURATION.
21714 <P>
21715
21716 When an email address you send a message to is not reachable -- either because
21717 it is simply an incorrect address, or because email can temporarily not be
21718 delivered to it due to a technical problem on the way to or at the recipient's
21719 end -- you will almost always get an error notification email message back.
21720 <P>
21721 If you encounter problems with, or have questions about, email delivery or
21722 email address syntax, contact your local network computing consultants.
21723 <P><UL>
21724 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21725 </UL>
21726 <P>
21727 &lt;End of help on this topic&gt;
21728 </BODY>
21729 </HTML>
21730 ======= h_flag_user_flag =======
21731 <HTML>
21732 <HEAD>
21733 <TITLE>STATUS FLAG: User Defined Keyword</TITLE>
21734 </HEAD>
21735 <BODY>
21736 <H1>STATUS FLAG: User Defined Keyword</h1>
21737
21738 This is a keyword that is defined for this folder.
21739 It was most likely defined by the owner of the folder.
21740 Alpine will not set or clear this flag on its own.
21741
21742 <P><UL>
21743 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21744 </UL><P>
21745 &lt;End of help on this topic&gt;
21746 </BODY>
21747 </HTML>
21748 ======= h_flag_important =======
21749 <html>
21750 <title>STATUS FLAG: Important</title>
21751 <body>
21752 <h1>STATUS FLAG: Important</h1>
21753
21754
21755 The <EM>Important</EM> flag, indicated by an asterisk in Alpine's
21756 MESSAGE&nbsp;INDEX
21757 screen, can only be set by the user, and is intended to be used in
21758 whatever fashion makes sense to you.  You are the only one that can set or
21759 clear it.
21760
21761 <P>
21762 &lt;End of help on this topic&gt;
21763 </BODY>
21764 </HTML>
21765 ======= h_flag_new =======
21766 <html>
21767 <title>STATUS FLAG: New</title>
21768 <body>
21769 <h1>STATUS FLAG: New</h1>
21770
21771
21772 The <EM>New</EM> flag, indicated by the letter 'N' in Alpine's
21773 MESSAGE&nbsp;INDEX screen,
21774 is automatically set when messages are delivered to your Inbox (or other
21775 folder specified outside of Alpine).  Likewise, it is cleared automatically
21776 the first time you read the message it is associated with.
21777
21778 <P>
21779 Sometimes it's helpful in prioritizing your mail.  For example, perhaps
21780 a message isn't weighty enough to assign it an <A HREF="h_flag_important">Important</A> flag, but
21781 you'd like to be reminded of it next time you read mail.  This can be done
21782 easily by <A HREF="h_common_flag">explicitly</A> resetting the <EM>New</EM> flag.
21783
21784
21785 <P>
21786 &lt;End of help on this topic&gt;
21787 </BODY>
21788 </HTML>
21789 ======= h_flag_answered =======
21790 <html>
21791 <title>STATUS FLAG: Answered</title>
21792 <body>
21793 <h1>STATUS FLAG: Answered</h1>
21794
21795 The <EM>Answered</EM> flag, indicated by the letter 'A' in Alpine's
21796 MESSAGE&nbsp;INDEX
21797 screen, is automatically set when you reply to a message.  This flag is not
21798 automatically cleared.
21799
21800 <P>
21801 &lt;End of help on this topic&gt;
21802 </BODY>
21803 </HTML>
21804 ======= h_flag_forwarded =======
21805 <html>
21806 <title>STATUS FLAG: Forwarded</title>
21807 <body>
21808 <h1>STATUS FLAG: Forwarded</h1>
21809
21810 The <EM>Forwarded</EM> flag, indicated by the letter 'F' in Alpine's
21811 MESSAGE&nbsp;INDEX
21812 screen, is automatically set when you forward a message.  This flag is not
21813 automatically cleared.
21814
21815 <P>
21816 &lt;End of help on this topic&gt;
21817 </BODY>
21818 </HTML>
21819 ======= h_flag_deleted =======
21820 <html>
21821 <title>STATUS FLAG: Deleted</title>
21822 <body>
21823 <h1>STATUS FLAG: Deleted</h1>
21824
21825 The <EM>Deleted</EM> flag, indicated by the letter 'D' in Alpine's
21826 MESSAGE&nbsp;INDEX
21827 screen, is set when you use the &quot;"D&nbsp;Delete&quot; command.
21828 It is cleared
21829 when you use the &quot;U&nbsp;Undelete&quot; command.
21830
21831 <P>
21832 Messages marked with this flag will be permanently removed from
21833 the folder when you issue the <A HREF="h_index_cmd_expunge">Expunge</A>
21834 command, or
21835 when you indicate acceptance of their removal upon leaving the folder.
21836
21837 <P>
21838 Note, there can be other actions implicit in the
21839 &quot;D&nbsp;Delete&quot; command,
21840 such as advancing to the next message, that may be momentarily undesirable.
21841 For this reason, it's sometimes useful to set or clear the <EM>Deleted</EM>
21842 flag <A HREF="h_common_flag">explicitly</A>.
21843
21844 <P>
21845 &lt;End of help on this topic&gt;
21846 </BODY>
21847 </HTML>
21848 ====== h_config_incoming_timeo ======
21849 <HTML>
21850 <HEAD>
21851 <TITLE>OPTION: <!--#echo var="VAR_incoming-check-timeout"--></TITLE>
21852 </HEAD>
21853 <BODY>
21854 <H1>OPTION: <!--#echo var="VAR_incoming-check-timeout"--></H1>
21855
21856 This option has no effect unless the feature
21857 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
21858 is set, which in turn has no effect unless
21859 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
21860 is set.
21861 <P>
21862 Sets the time in seconds that Alpine will
21863 attempt to open a network connection used for monitoring for Unseen
21864 messages in Incoming Folders. The default is 5.
21865 If a connection has not completed within this many seconds Alpine will
21866 give up and consider it a failed connection.
21867 <P>
21868 <UL>
21869 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21870 </UL><P>
21871 &lt;End of help on this topic&gt;
21872 </BODY>
21873 </HTML>
21874 ====== h_config_incoming_interv ======
21875 <HTML>
21876 <HEAD>
21877 <TITLE>OPTION: <!--#echo var="VAR_incoming-check-interval"--></TITLE>
21878 </HEAD>
21879 <BODY>
21880 <H1>OPTION: <!--#echo var="VAR_incoming-check-interval"--></H1>
21881
21882 This option has no effect unless the feature
21883 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
21884 is set, which in turn has no effect unless
21885 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
21886 is set.
21887 <P>
21888 This option specifies, in seconds, how often Alpine will check
21889 for new mail and state changes in Incoming Folders when Incoming Folders
21890 Checking is turned on.
21891 The default is 3 minutes (180).
21892 This value applies only to folders that are local to the system that
21893 Alpine is running on or that are accessed using the IMAP protocol.
21894 The similar option
21895 <A HREF="h_config_incoming_second_interv"><!--#echo var="VAR_incoming-check-interval-secondary"--></A>
21896 applies to all other monitored folders.
21897 <P>
21898 <UL>
21899 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21900 </UL><P>
21901 &lt;End of help on this topic&gt;
21902 </BODY>
21903 </HTML>
21904 ====== h_config_incoming_second_interv ======
21905 <HTML>
21906 <HEAD>
21907 <TITLE>OPTION: <!--#echo var="VAR_incoming-check-interval-secondary"--></TITLE>
21908 </HEAD>
21909 <BODY>
21910 <H1>OPTION: <!--#echo var="VAR_incoming-check-interval-secondary"--></H1>
21911
21912 This option has no effect unless the feature
21913 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
21914 is set, which in turn has no effect unless
21915 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
21916 is set.
21917 <P>
21918 This option together with the option
21919 <A HREF="h_config_incoming_interv"><!--#echo var="VAR_incoming-check-interval"--></A>
21920 specifies, in seconds, how often Alpine will check
21921 for new mail and state changes in Incoming Folders when Incoming Folders
21922 Checking is turned on.
21923 The default for this option is 3 minutes (180).
21924 For folders that are local to this system or
21925 that are accessed using the IMAP protocol
21926 the value of the option
21927 <A HREF="h_config_incoming_interv"><!--#echo var="VAR_incoming-check-interval"--></A>
21928 is used.
21929 For all other monitored folders, the value of this option is used.
21930 <P>
21931 The reason there are two separate options is because it is usually
21932 less expensive to check local and IMAP folders than it is to check
21933 other types, like POP or NNTP folders.
21934 You may want to set this secondary value to a higher number than
21935 the primary check interval.
21936 <P>
21937 <UL>
21938 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21939 </UL><P>
21940 &lt;End of help on this topic&gt;
21941 </BODY>
21942 </HTML>
21943 ====== h_config_incoming_list ======
21944 <HTML>
21945 <HEAD>
21946 <TITLE>OPTION: <!--#echo var="VAR_incoming-check-list"--></TITLE>
21947 </HEAD>
21948 <BODY>
21949 <H1>OPTION: <!--#echo var="VAR_incoming-check-list"--></H1>
21950
21951 This option has no effect unless the feature
21952 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
21953 is set, which in turn has no effect unless
21954 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
21955 is set.
21956 <P>
21957 When monitoring the Incoming Message Folders for Unseen messages Alpine will
21958 normally monitor all Incoming Folders.
21959 You may use this option to restrict the list of monitored folders to a
21960 subset of all Incoming Folders.
21961 <P>
21962 <UL>
21963 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21964 </UL><P>
21965 &lt;End of help on this topic&gt;
21966 </BODY>
21967 </HTML>
21968 ====== h_config_pers_name ======
21969 <HTML>
21970 <HEAD>
21971 <TITLE>OPTION: <!--#echo var="VAR_personal-name"--></TITLE>
21972 </HEAD>
21973 <BODY>
21974 <H1>OPTION: <!--#echo var="VAR_personal-name"--></H1>
21975
21976 This value is used to determine the full name part of the "From" address
21977 on messages you send.
21978 <!--chtml if pinemode="os_windows"-->
21979  PC-Alpine requires that this be set in order to properly construct the "From" address.
21980 <!--chtml else-->
21981  If unset, Unix Alpine will obtain your full name from
21982  the system password file. PC-Alpine, on the other hand, requires that this be set.
21983 <!--chtml endif-->
21984 <P>
21985 If you want to change the value of what gets included in the From header
21986 in messages you send (other than just the Personal Name)
21987 look <A HREF="h_config_change_your_from">here</A> for a description.
21988 <P><UL>
21989 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
21990 </UL><P>
21991 &lt;End of help on this topic&gt;
21992 </BODY>
21993 </HTML>
21994 ====== h_config_pruned_folders ======
21995 <html>
21996 <header>
21997 <title>OPTION: <!--#echo var="VAR_pruned-folders"--></title>
21998 </header>
21999 <body>
22000 <h1>OPTION: <!--#echo var="VAR_pruned-folders"--></h1>
22001
22002 This variable allows you to define a list of one or more folders that
22003 Alpine will offer to prune for you in the same way it automatically offers
22004 to prune your "sent-mail" folder each month.
22005 Each folder in this list must be a folder in your default folder collection
22006 (the first folder collection if you have more than one), and it is just
22007 the relative name of the folder in the collection, not the fully-qualified name.
22008 It is similar to sent-mail.
22009 Instead of something like
22010 <P>
22011 <CENTER><SAMP><!--#echo var="VAR_pruned-folders"-->={servername}mail/folder</SAMP></CENTER>
22012 <P>
22013 the correct value to use would be
22014 <P>
22015 <CENTER><SAMP>folder</SAMP></CENTER>
22016 <P>
22017 There is an assumption here that your first collection is the folders in
22018 <P>
22019 <CENTER><SAMP>{servername}mail</SAMP></CENTER>
22020 <P>
22021
22022 Once a month, for each folder listed, Alpine will offer to move
22023 the contents of the folder to a new folder of the same name but with
22024 the previous month's date appended.  Alpine will then look for any such
22025 date-appended folder names created for a previous month, and offer each
22026 one it finds for deletion.
22027 <P>
22028
22029 If you decline the first offer, no mail is moved and no new folder is
22030 created.
22031 <P>
22032
22033 The new folders will be created
22034 in your default folder collection.
22035 <P>
22036
22037 <UL>
22038 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22039 </UL><P>
22040 &lt;End of help on this topic&gt;
22041 </body>
22042 </html>
22043 ====== h_config_upload_cmd ======
22044 <HTML>
22045 <HEAD>
22046 <TITLE>OPTION: <!--#echo var="VAR_upload-command"--></TITLE>
22047 </HEAD>
22048 <BODY>
22049 <H1>OPTION: <!--#echo var="VAR_upload-command"--></H1>
22050
22051 This option affects the behavior of the Composer's &quot;Read File&quot;
22052 (^R in the message body) and &quot;Attach File&quot; (^J in the header)
22053 commands.  It specifies
22054 a Unix program name, and any necessary command line arguments, that Alpine can
22055 use to transfer files from your personal computer into messages that you are
22056 composing.<P>
22057
22058 <B>Note:</B> this facility is intended for use with serial line transfer
22059 protocols, such as kermit, xmodem, or zmodem.  It is <B>not</B> intended
22060 to work with TCP/IP file transfer programs such as ftp.<P>
22061
22062 If a program is specified, the commands listed above are modified to offer a
22063 subcommand (^Y) to activate the transfer.  Obviously, the Unix program
22064 specified here must match the transfer program or protocol available on the
22065 personal computer.<P>
22066
22067 Alpine expects to exchange uploaded data via a file on your Unix system.  When
22068 the specified upload program finishes, Alpine expects the uploaded data to be
22069 contained in this file.<P>
22070
22071 When upload is invoked via the &quot;Read File&quot; subcommand, Alpine
22072 generates a
22073 temporary file name that it will pass to the specified Unix program.  Alpine
22074 will read the resulting uploaded text from this file and then delete it when
22075 the upload command is finished.<P>
22076
22077 When upload is invoked via the &quot;Attach File&quot; subcommand, Alpine will
22078 prompt
22079 you for the name of the file that is to contain the uploaded information that
22080 it is to attach.  Alpine will attach this file to the composition, but will
22081 <B>not</B> delete this file after the upload command is finished.<P>
22082
22083 The special token &quot;_FILE_&quot; may be included among the Unix program's
22084 command
22085 line arguments.  Alpine will replace this symbol with the name of the file
22086 being used to exchange the uploaded information.  This token allows you to
22087 position the file name where it is required in the Unix program's command
22088 line arguments.<P>
22089
22090 If the &quot;_FILE_&quot; token is not present in the specified command, the
22091 temporary file's name is automatically appended to the specified Unix
22092 program.  In other words, you don't need to use &quot;_FILE_&quot; if it is the
22093 <B>last</B> command line argument.
22094 <P><UL>
22095 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22096 </UL><P>
22097 &lt;End of help on this topic&gt;
22098 </BODY>
22099 </HTML>
22100 ====== h_config_upload_prefix ======
22101 <HTML>
22102 <HEAD>
22103 <TITLE>OPTION: <!--#echo var="VAR_upload-command-prefix"--></TITLE>
22104 </HEAD>
22105 <BODY>
22106 <H1>OPTION: <!--#echo var="VAR_upload-command-prefix"--></H1>
22107
22108 This option is used in conjunction with the <!--#echo var="VAR_upload-command"--> option.
22109 It defines text to be written to the terminal emulator (via standard output)
22110 immediately prior to starting upload command.  This is useful for
22111 integrated serial line file transfer agents that permit command passing
22112 (e.g., Kermit's APC method).<P>
22113
22114 The special token &quot;_FILE_&quot; may be included in the string specification.
22115 That symbol will be replaced with the (Alpine-created) name of the temporary
22116 file in which Alpine will expect to find the uploaded file.
22117 <P><UL>
22118 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22119 </UL><P>
22120 &lt;End of help on this topic&gt;
22121 </BODY>
22122 </HTML>
22123 ====== h_config_download_cmd ======
22124 <HTML>
22125 <HEAD>
22126 <TITLE>OPTION: <!--#echo var="VAR_download-command"--></TITLE>
22127 </HEAD>
22128 <BODY>
22129 <H1>OPTION: <!--#echo var="VAR_download-command"--></H1>
22130
22131 This option affects the behavior of the Export command.  It specifies a Unix
22132 program name, and any necessary command line arguments, that Alpine can use to
22133 transfer the exported message to your personal computer's disk.<P>
22134 Note: this facility is intended for use with serial line transfer
22135 protocols, such as kermit, xmodem, or zmodem.  It is <B>not</B> intended
22136 to work with TCP/IP file transfer programs such as ftp.<P>
22137 If a program is specified, the Export command is modified to offer a
22138 subcommand (^V) to activate the transfer (in lieu of saving it to
22139  the machine where Alpine is running).  Obviously, the Unix program
22140 specified here must match the transfer program or protocol available on the
22141 personal computer.<P>
22142
22143 When this subcommand is selected and before Alpine invokes the specified Unix
22144 program, Alpine will create a temporary file containing the text of the
22145 exported message.  Alpine uses this file to pass the exported message text to
22146 the specified Unix program.<P>
22147
22148 The special token &quot;_FILE_&quot; may be included among the Unix program's command
22149 line arguments.  Alpine will replace this symbol with the temporary file's name
22150 before executing the Unix program.  This token allows you to position the
22151 file name where it is required in the Unix program's command line arguments.
22152 <P>
22153 If the &quot;_FILE_&quot; token is not present in the specified command, the
22154 temporary file's name is automatically appended to the specified Unix
22155 program.  In other words, you don't need to use &quot;_FILE_&quot; if it is the
22156 <B>last</B> command line argument.
22157 <P><UL>
22158 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22159 </UL><P>
22160 &lt;End of help on this topic&gt;
22161 </BODY>
22162 </HTML>
22163 ====== h_config_download_prefix ======
22164 <HTML>
22165 <HEAD>
22166 <TITLE>OPTION: <!--#echo var="VAR_download-command-prefix"--></TITLE>
22167 </HEAD>
22168 <BODY>
22169 <H1>OPTION: <!--#echo var="VAR_download-command-prefix"--></H1>
22170
22171 This option is used in conjunction with the <!--#echo var="VAR_download-command"--> option.
22172 It defines text to be written to the terminal emulator (via standard output)
22173 immediately prior to starting the download command.  This is useful for
22174 integrated serial line file transfer agents that permit command passing
22175 (e.g., Kermit's APC method).
22176 <P>
22177 The special token &quot;_FILE_&quot; may be included in the string
22178 specification.
22179 That symbol will be replaced with the (Alpine-created) name of the temporary
22180 file into which Alpine will place the message to be downloaded.
22181 <P><UL>
22182 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22183 </UL><P>
22184 &lt;End of help on this topic&gt;
22185 </BODY>
22186 </HTML>
22187 ====== h_config_mailcap_path ======
22188 <HTML>
22189 <HEAD>
22190 <TITLE>OPTION: <!--#echo var="VAR_mailcap-search-path"--></TITLE>
22191 </HEAD>
22192 <BODY>
22193 <H1>OPTION: <!--#echo var="VAR_mailcap-search-path"--></H1>
22194 This variable is used to replace Alpine's default mailcap file search path.
22195 It takes one or more file names (full paths must be specified) in which to
22196 look for mail capability data.  The default search path can be found in this
22197 <A HREF="h_news_config">Alpine Configuration</A> help, near the bottom.
22198 If there is more than one file name listed, list members should be delimited
22199 by
22200 <!--chtml if pinemode="os_windows"-->
22201 a semi-colon (;) under Windows; for example:<PRE>
22202         C:&#92;MYCONFIG&#92;MAILCAP.TXT;H:&#92;NETCONFIG&#92;MAILCAP.TXT
22203 </PRE>
22204 <!--chtml else-->
22205 a colon (:) under UNIX; for example:<PRE>
22206         ~/.mailcap:/etc/mailcap:/usr/etc/mailcap:/usr/local/etc/mailcap
22207 </PRE>
22208 <!--chtml endif-->
22209 <P><UL>
22210 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22211 </UL>
22212 <P>
22213 &lt;End of help on this topic&gt;
22214 </BODY>
22215 </HTML>
22216 ====== h_config_mimetype_path ======
22217 <HTML>
22218 <HEAD>
22219 <TITLE>OPTION: <!--#echo var="VAR_mimetype-search-path"--></TITLE>
22220 </HEAD>
22221 <BODY>
22222 <H1>OPTION: <!--#echo var="VAR_mimetype-search-path"--></H1>
22223
22224 This variable is used to replace Alpine's default mime.types file search path.
22225 It takes one or more file names (full paths must be specified) in which to
22226 look for file-name-extension to MIME type mapping data.  The default search
22227 path can be found in this
22228 <A HREF="h_news_config">Alpine Configuration</A> help.
22229
22230 <P>
22231
22232 If there is more than one file name listed, list members should be delimited
22233 by a colon (:) under UNIX and a semi-colon (;) under Windows.
22234 <P>
22235 &lt;End of help on this topic&gt;
22236 </BODY></HTML>
22237 ====== h_config_system_certs_path ======
22238 <HTML>
22239 <HEAD>
22240 <TITLE>OPTION: <!--#echo var="VAR_system-certs-path"--></TITLE>
22241 </HEAD>
22242 <BODY>
22243 <H1>OPTION: <!--#echo var="VAR_system-certs-path"--></H1>
22244
22245 When Alpine is built to support secure connections to remote servers, a directory
22246 must be reserved in the system to store certificates that will be used to validate
22247 remote servers. This is normally configured at the time that Alpine is built, but
22248 there might be circumstances under which a user might want to use a different
22249 directory. For example, the directory might not be accessible, or has not been
22250 updated and contains old certificates that have expired.
22251
22252 <P>
22253 This variable can be used to list
22254 the directory where such certificates can be found. Alpine will use the first
22255 directory in this list that exists in your system and can be accessed. This
22256 allows for users to be able to use the same pinerc file in different systems.
22257
22258 <P>
22259 Example of values for this option might be:
22260
22261 <PRE>
22262 System CACerts Dir = /etc/ssl/certs
22263                      /usr/local/ssl/certs
22264                      C:\\libressl\\ssl\\certs
22265 <PRE>
22266
22267 <P>
22268 In unix systems, the default location of the certificates for openssl can
22269 be obtained by first executing the command
22270
22271 <PRE>openssl version -d</PRE>
22272
22273 and adding &quot;/certs&quot; to that value. In Windows the default location
22274 for the certificates is C:\\libressl\\ssl\\certs. This value was set by
22275 LibreSSL developers, and this option can be used to override this default.
22276
22277 <P>
22278 &lt;End of help on this topic&gt;
22279 </BODY></HTML>
22280 ====== h_config_system_certs_file ======
22281 <HTML>
22282 <HEAD>
22283 <TITLE>OPTION: <!--#echo var="VAR_system-certs-file"--></TITLE>
22284 </HEAD>
22285 <BODY>
22286 <H1>OPTION: <!--#echo var="VAR_system-certs-file"--></H1>
22287
22288 This option sets the location of the container file that holds
22289 certificate authority (CA) certificates.
22290 Alpine will use the first
22291 container in this list that exists in your system and can be accessed. This
22292 allows for users to be able to use the same pinerc file in different systems.
22293
22294 <P>
22295 Example of values for this option might be:
22296
22297 <PRE>
22298 System Certs Path = /etc/ssl/certs/cert.pem
22299                     /usr/local/ssl/ca-root-nss.crt
22300                     C:\\libressl\\ssl\\certs\\cert.pem
22301 <PRE>
22302
22303 <P>
22304 In unix systems, the default location of the certificates for openssl can
22305 be obtained by first executing the command
22306
22307 <PRE>openssl version -d</PRE>
22308
22309 and adding &quot;/certs&quot; to that value. In Windows the default location
22310 for the certificates is C:\\libressl\\ssl\\certs\\cert.pem. This value was set
22311 by LibreSSL developers, and this option can be used to override this default.
22312
22313 <P>
22314 &lt;End of help on this topic&gt;
22315 </BODY></HTML>
22316 ====== h_config_set_att_ansi ======
22317 <HTML><HEAD>
22318 <TITLE>OPTION: Set printer to attached ansi printer</TITLE>
22319 </HEAD>
22320 <BODY>
22321 <H1>OPTION: Set printer to attached ansi printer</H1>
22322
22323 Type "S" to set your printer to "attached-to-ansi".<BR>
22324 It is OK to include "attached-to-ansi" in your personal list below.
22325 <P>
22326 &lt;End of help on this topic&gt;
22327 </BODY></HTML>
22328 ====== h_config_set_att_ansi2 ======
22329 <HTML><HEAD>
22330 <TITLE>OPTION: Set printer to attached ansi printer (no formfeed)</TITLE>
22331 </HEAD>
22332 <BODY>
22333 <H1>OPTION: Set printer to attached ansi printer (no formfeed)</H1>
22334
22335 Type "S" to set your printer to "attached-to-ansi-no-formfeed".<BR>
22336 It is OK to include "attached-to-ansi-no-formfeed" in your personal
22337 list below.
22338
22339 <P>
22340
22341 This is the same as the "attached-to-ansi" option except that a
22342 formfeed character will not be appended to the end of the print job.
22343 If your printer already ejects the paper by itself at the end of the
22344 job, you may prefer the "no-formfeed" form of this printer so that you
22345 don't get an extra blank page between print jobs.
22346 <P>
22347
22348 &lt;End of help on this topic&gt;
22349 </BODY></HTML>
22350 ====== h_config_set_att_wyse ======
22351 <HTML><HEAD>
22352 <TITLE>OPTION: Set printer to attached Wyse60 printer</TITLE>
22353 </HEAD>
22354 <BODY>
22355 <H1>OPTION: Set printer to attached Wyse60 printer</H1>
22356
22357 Type "S" to set your printer to "attached-to-wyse".<BR>
22358 It is OK to include "attached-to-wyse" in your personal list below.
22359 <P>
22360 This is very similar to "attached-to-ansi".
22361 The only difference is in the control characters sent to turn the printer
22362 on and off.
22363 The ansi version of the printer uses ESC LEFT_BRACKET 5 i
22364 to turn on the printer and ESC LEFT_BRACKET 4 i
22365 to turn it off.
22366 The Wyse version uses Ctrl-R for on, and Ctrl-T for off.
22367 &lt;End of help on this topic&gt;
22368 </BODY></HTML>
22369 ====== h_config_set_att_wyse2 ======
22370 <HTML><HEAD>
22371 <TITLE>OPTION: Set printer to attached Wyse60 printer (no formfeed)</TITLE>
22372 </HEAD>
22373 <BODY>
22374 <H1>OPTION: Set printer to attached Wyse60 printer (no formfeed)</H1>
22375
22376 Type "S" to set your printer to "attached-to-wyse-no-formfeed".<BR>
22377 It is OK to include "attached-to-wyse-no-formfeed" in your personal
22378 list below.
22379
22380 <P>
22381
22382 This is the same as the "attached-to-wyse" option except that a
22383 formfeed character will not be appended to the end of the print job.
22384 If your printer already ejects the paper by itself at the end of the
22385 job, you may prefer the "no-formfeed" form of this printer so that you
22386 don't get an extra blank page between print jobs.
22387 <P>
22388
22389 &lt;End of help on this topic&gt;
22390 </BODY></HTML>
22391 ====== h_config_set_stand_print ======
22392 <HTML>
22393 <HEAD>
22394 <TITLE>OPTION: Set default printer</TITLE>
22395 </HEAD>
22396 <H1>OPTION: Set default printer</H1>
22397 <BODY>
22398 Move to the printer you want and type "S" to set it to be your
22399 default printer.  This list is not modifiable by you and has been
22400 set up by the system administrators.  If there is more than one printer
22401 listed in the Command List, you will be able to cycle through that
22402 whole list at the time you print, starting with your default.
22403 It is OK to include entries from this Standard list in your personal
22404 list below.
22405 <P>
22406 &lt;End of help on this topic&gt;
22407 </BODY>
22408 </HTML>
22409 ====== h_config_set_custom_print ======
22410 <HTML>
22411 <HEAD>
22412 <TITLE>OPTION: Set default printer</TITLE>
22413 </HEAD>
22414 <H1>OPTION: Set default printer</H1>
22415 <BODY>
22416 You may add as many print commands as you want to your personal list.
22417 Specify one of them as your default printer by moving to the printer
22418 you want and typing "S".  If there is more than one printer listed
22419 in the Command List, you will be able to cycle through that list at
22420 the time you print, starting with your default.  It is OK to include
22421 entries from the Standard list above or to include the command
22422 "attached-to-ansi", "attached-to-ansi-no-formfeed", "attached-to-wyse", or
22423 "attached-to-wyse-no-formfeed" as one of the entries here.
22424 <P>
22425 &lt;End of help on this topic&gt;
22426 </BODY>
22427 </HTML>
22428 ====== h_config_user_id =====
22429 <HTML>
22430 <HEAD>
22431 <TITLE>OPTION: <!--#echo var="VAR_user-id"--></TITLE>
22432 </HEAD>
22433 <BODY>
22434 <H1>OPTION: <!--#echo var="VAR_user-id"--></H1>
22435
22436 This value is used as part of the "From" address on messages you send.
22437 It is also the default login name for remote IMAP server access.  Set this
22438 to the username part you want to appear on outgoing email.
22439 <P>
22440 If you want to change the value of what gets included in the From header
22441 in messages you send (other than just the User ID)
22442 look <A HREF="h_config_change_your_from">here</A> for a description.
22443
22444 <P><UL>
22445 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22446 </UL><P>
22447 &lt;End of help on this topic&gt;
22448 </BODY>
22449 </HTML>
22450 ====== h_config_user_dom =====
22451 <HTML>
22452 <HEAD>
22453 <TITLE>OPTION: <!--#echo var="VAR_user-domain"--></TITLE>
22454 </HEAD>
22455 <BODY>
22456 <H1>OPTION: <!--#echo var="VAR_user-domain"--></H1>
22457
22458 This value specifies the domain part (right-hand side) of your return
22459 address on outgoing email and is also used as the default domain for email
22460 composed to a local user.
22461 <!--chtml if pinemode="os_windows"-->
22462  This value is required for PC-Alpine. If you are unsure as to what this should be,
22463  contact your local help desk, system administrator, or Internet Service Provider.
22464 <!--chtml else-->
22465  If unset, Unix Alpine will obtain the domain from
22466  the system.  Often this value will be set for your whole site by the
22467  system administrator.<P>
22468 <!--chtml endif-->
22469 If you set this, see also the <A HREF="h_config_quell_local_lookup">
22470 &quot;<!--#echo var="FEAT_quell-user-lookup-in-passwd-file"-->&quot;</A> feature.
22471 <P>
22472 If you want to change the value of what gets included in the From header
22473 in messages you send (other than just the User Domain)
22474 look <A HREF="h_config_change_your_from">here</A> for a description.
22475 <P><UL>
22476 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22477 </UL><P>
22478 &lt;End of help on this topic&gt;
22479 </BODY>
22480 </HTML>
22481 ====== h_config_smtp_server =====
22482 <HTML>
22483 <HEAD>
22484 <TITLE>OPTION: <!--#echo var="VAR_smtp-server"--></TITLE>
22485 </HEAD>
22486 <BODY>
22487 <H1>OPTION: <!--#echo var="VAR_smtp-server"--></H1>
22488 This value specifies the name of one or more SMTP
22489 (Simple Mail Transfer Protocol) servers for sending mail.
22490 <!--chtml if pinemode="os_windows"-->
22491 You must have an SMTP server for use with PC-Alpine.
22492 SMTP servers are
22493 normally set up by a system administrator for use by all members of a given
22494 campus or department.
22495 Contact your local help desk to ask what SMTP
22496 servers you should use.
22497 <!--chtml else-->
22498 Unix Alpine users may not need to set an SMTP server.
22499 Alpine will attempt to execute the program (usually sendmail) that is used
22500 to insert mail into the mail system.
22501 If this works for you, you may leave this option blank.
22502 If there is an SMTP server running on the Unix host you may be able to
22503 improve sending performance slightly by setting the SMTP server option
22504 to &quot;localhost&quot; or to the actual name of the Unix host.
22505 <P>
22506 If the Unix host doesn't work the way Alpine was expecting you will need to
22507 set the value of this option.
22508 SMTP servers are
22509 normally set up by a system administrator for use by all members of a given
22510 campus or department.
22511 Contact your local help desk to ask what SMTP
22512 servers you should use.
22513 <!--chtml endif-->
22514 <P>
22515 Your SMTP server may offer SMTP AUTH authentication.
22516 It may even require it.
22517 If your SMTP server offers SMTP AUTH authentication you may specify a
22518 &quot;user&quot; name parameter to cause Alpine to attempt to authenticate.
22519 This parameter requires an associated value,
22520 the username identifier with which to establish the server
22521 connection.
22522 An example might be:
22523
22524 <P>
22525 <CENTER><SAMP>smtpserver.example.com/user=katie</SAMP></CENTER>
22526 <P>
22527
22528 If AUTH authentication is offered by the server, this will cause Alpine to
22529 attempt to use it.
22530 If AUTH authentication is not offered by the server, this will cause Alpine
22531 to fail sending with an error similar to:
22532
22533 <P>
22534 <CENTER><SAMP>Error: SMTP authentication not available</SAMP></CENTER>
22535 <P>
22536
22537 Another type of authentication that is used by some ISPs is called
22538 &quot;POP before SMTP&quot; or &quot;IMAP before SMTP&quot;,
22539 which means that you have to authenticate
22540 yourself to the POP or IMAP server by opening a mailbox before you
22541 can send mail.
22542 To do this, you usually only have to open your INBOX.
22543
22544 <P>
22545 You may tell Alpine to use the
22546 <A HREF="http://www.ietf.org/rfc/rfc2476.txt">Message Submission</A>
22547 port (587) instead of the SMTP port (25) by including the &quot;submit&quot;
22548 parameter
22549 in this option.
22550 At this time &quot;/submit&quot; is simply equivalent to specifying
22551 port 587, though it may imply more than that at some point in the future.
22552 Some ISPs are blocking port 25 in order to reduce the amount of spam
22553 being sent to their users.
22554 You may find that the submit option allows you to get around such a block.
22555
22556 <P>
22557 <CENTER><SAMP>smtpserver.example.com/submit</SAMP></CENTER>
22558 <P>
22559
22560 To specify any non-standard port number on the SMTP server you may follow
22561 the hostname with a colon followed by the portnumber.
22562
22563 <P>
22564 <CENTER><SAMP>smtpserver.example.com:12345</SAMP></CENTER>
22565 <P>
22566
22567 Normally, when a connection is made to the Smtp-Server Alpine will attempt
22568 to negotiate a secure (encrypted) session using Transport Layer Security (TLS).
22569 If that fails then a non-encrypted connection will be attempted instead.
22570 You may specify that a TLS connection is required if you wish.
22571 If you append &quot;/starttls&quot; to the name then the connection will fail
22572 instead of falling back to a non-secure connection.
22573
22574 <P>
22575 <CENTER><SAMP>smtpserver.example.com/starttls</SAMP></CENTER>
22576 <P>
22577
22578
22579 For more details about server name possibilities see
22580 <A HREF="h_folder_server_syntax">Server Name Syntax</A>.
22581 <P>
22582
22583 <UL>
22584 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22585 </UL>
22586 <P>
22587 &lt;End of help on this topic&gt;
22588 </BODY>
22589 </HTML>
22590 ====== h_config_nntp_server =====
22591 <HTML>
22592 <HEAD>
22593 <TITLE>OPTION: <!--#echo var="VAR_nntp-server"--></TITLE></HEAD>
22594 <BODY>
22595 <H1>OPTION: <!--#echo var="VAR_nntp-server"--></H1>
22596
22597 This value specifies the name of one or more NNTP
22598 (Network News Transfer Protocol)
22599 servers for reading and posting USENET news.
22600 NNTP servers are normally
22601 set up by a system administrator for use by all members of a given campus
22602 or department.
22603 Contact your local help desk to ask what NNTP servers you should use.
22604 <!--chtml if pinemode="os_windows"--><!--chtml else-->
22605 Often Unix Alpine users will find that this variable has been
22606 set for the whole system (and they don't have to worry about it).
22607 <!--chtml endif-->
22608 When you define an NNTP server here, Alpine implicitly defines a news
22609 collection for you, assuming that server as the news server and assuming
22610 that you will use the NNTP protocol and a local newsrc configuration file
22611 for reading news.
22612 For more about reading news with Alpine, see
22613 <A HREF="h_reading_news">how to use Alpine to read news</A>.
22614 <P>
22615 Your NNTP server may offer NNTP &quot;AUTHINFO SASL&quot;
22616 or &quot;AUTHINFO USER&quot; authentication.
22617 It may even require it.
22618 If your NNTP server does offer such authentication you may specify a user name
22619 parameter to cause Alpine to attempt to authenticate.
22620 The same is true for the server name in a folder collection that uses NNTP.
22621 This parameter requires an associated value,
22622 the username identifier with which to establish the server connection.
22623 An example might be:
22624
22625 <P>
22626 <CENTER><SAMP>nntpserver.example.com/user=katie</SAMP></CENTER>
22627 <P>
22628
22629 If authentication is offered by the server, this will cause Alpine to
22630 attempt to use it.
22631 If authentication is not offered by the server, this will cause Alpine
22632 to fail with an error similar to:
22633
22634 <P>
22635 <CENTER><SAMP>Error: NNTP authentication not available</SAMP></CENTER>
22636 <P>
22637 For more details about the server name possibilities see
22638 <A HREF="h_folder_server_syntax">Server Name Syntax</A>.
22639 <P><UL>
22640 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22641 </UL><P>
22642 &lt;End of help on this topic&gt;
22643 </BODY>
22644 </HTML>
22645 ====== h_config_inbox_path =====
22646 <HTML>
22647 <HEAD>
22648 <TITLE>OPTION: <!--#echo var="VAR_inbox-path"--></TITLE>
22649 </HEAD>
22650 <BODY>
22651 <H1>OPTION: <!--#echo var="VAR_inbox-path"--></H1>
22652
22653 This value overrides the default value of your INBOX name/path/location.
22654 <!--chtml if pinemode="os_windows"-->
22655 PC-Alpine users must specify an inbox path and it must be a folder on an
22656 IMAP server.
22657 <!--chtml else-->
22658 Unix and VMS Alpine users will often find that this variable
22659 has been pre-configured by your system administrator.
22660 <!--chtml endif-->
22661 You may be able to specify an alternate INBOX that is either a local folder
22662 or a folder on an IMAP server.
22663 <P>
22664 A typical remote <!--#echo var="VAR_inbox-path"--> entry would be: &#123;monet.art.example.com}INBOX
22665 where &quot;monet.art.example.com&quot; is replaced by the name of your IMAP
22666 mail server.
22667 <P>
22668 See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
22669 details on the syntax of folder definitions.
22670 <P>
22671 See <A HREF="h_info_on_mbox">Missing mail and the mbox driver</A> if your
22672 mail is disappearing.
22673 <P><UL>
22674 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22675 </UL><P>
22676 &lt;End of help on this topic&gt;
22677 </BODY>
22678 </HTML>
22679 ====== h_config_change_your_from =====
22680 <HTML>
22681 <HEAD>
22682 <TITLE>How to Change your From Address</TITLE>
22683 </HEAD>
22684 <BODY>
22685 <H1>How to Change your From Address</H1>
22686
22687 If the From address that Alpine includes in mail that you send is not correct,
22688 you may want to configure a different default value for the From address.
22689 You may follow these directions to change the default:
22690
22691 <P>
22692 <UL>
22693   <LI> Go to the Main Alpine Menu
22694   <LI> From there type the Setup Command
22695   <LI> From there type the Config Command
22696 </UL>
22697
22698 <P>
22699 You've probably already seen this SETUP CONFIGURATION screen.
22700 If not, there are many options you may want to set here.
22701 To set the value of the From header you may use the
22702 <A href="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A> option.
22703 Find it by scrolling down a few pages or use the WhereIs command to
22704 search for &quot;customized&quot;.
22705 You may want to read the help text associated with the option.
22706 <P>
22707 To add a custom From header, type the Add command and enter the
22708 full header line, including the leading &quot;From:&nbsp;&quot;.
22709 For example:
22710 <P>
22711 <CENTER><SAMP>From: Full Name &lt;user@example.com&gt;</SAMP></CENTER>
22712 <P>
22713 Now exit the Setup command and try sending mail to yourself to see
22714 what the From line looks like.
22715 <P>
22716 When you are in the composer you may edit the custom From line by typing
22717 Ctrl-R while your cursor is in the headers of the message and then moving
22718 to the From line and editing.
22719 If you want to leave the default value the same but add the possibility
22720 of being able to edit the header when you compose, add just the header
22721 name without a value.
22722 For example:
22723 <P>
22724 <CENTER><SAMP>From:</SAMP></CENTER>
22725 <P>
22726 If you change your From address you may also find it useful to add the
22727 changed From address to the
22728 <a href="h_config_alt_addresses"><!--#echo var="VAR_alt-addresses"--></a>
22729 configuration option.
22730 <P>
22731 <UL>
22732 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22733 </UL><P>
22734 &lt;End of help on this topic&gt;
22735 </BODY>
22736 </HTML>
22737 ====== h_config_default_fcc =====
22738 <HTML>
22739 <HEAD>
22740 <TITLE>OPTION: <!--#echo var="VAR_default-fcc"--></TITLE>
22741 </HEAD>
22742 <BODY>
22743 <H1>OPTION: <!--#echo var="VAR_default-fcc"--></H1>
22744
22745 This value specifies where a copy of outgoing mail should be saved.  If
22746 this is not a path name, it will be in the default collection for saves.
22747 Any valid folder specification, local or IMAP, is allowed.  This default
22748 folder carbon copy only applies when the
22749 <A HREF="h_config_fcc_rule">&quot;<!--#echo var="VAR_fcc-name-rule"-->&quot;</A>
22750 is set to use the default folder.
22751 <!--chtml if pinemode="os_windows"-->
22752 PC-Alpine default is &quot;SENTMAIL&quot; (normally stored as SENTMAIL.MTX)
22753 <!--chtml else-->
22754 Unix Alpine default
22755 is normally &quot;sent-mail&quot; in the default folder collection.
22756 <!--chtml endif-->
22757 <P>
22758 If you access your email through an IMAP server, especially if you often switch between Unix Alpine
22759 and PC-Alpine, or between various desktop email systems, you may want to set this to a folder on your
22760 IMAP server (remember that in order to later access this remote folder through Alpine, it
22761 must be in a folder collection. See <A HREF="h_what_are_collections">Folder Collections Explained</a>
22762 for more information). An example:<p>
22763 <CENTER><SAMP>{monet.art.example.com}mail/sent-mail</SAMP></CENTER>
22764 <P>
22765 To suppress saving of outgoing mail, set: <!--#echo var="VAR_default-fcc"-->=&quot;&quot;
22766 <P>
22767 See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
22768 details on the syntax of folder definitions.
22769 <P>
22770 <UL>
22771 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22772 </UL><P>
22773 &lt;End of help on this topic&gt;
22774 </BODY>
22775 </HTML>
22776 ====== h_config_def_save_folder =====
22777 <HTML>
22778 <HEAD>
22779 <TITLE>OPTION: <!--#echo var="VAR_default-saved-msg-folder"--></TITLE>
22780 </HEAD>
22781 <BODY>
22782 <H1>OPTION: <!--#echo var="VAR_default-saved-msg-folder"--></H1>
22783
22784 This option determines the default folder name for save-message operations
22785 (&quot;saves&quot;).
22786 <P>
22787 If this is not a path name, it will be in the default collection for saves.
22788 Any valid folder specification, local or IMAP, is allowed.  This default
22789 folder only applies when the
22790 <A HREF="h_config_saved_msg_name_rule">&quot;<!--#echo var="VAR_saved-msg-name-rule"-->&quot;</A>
22791 doesn't override it.
22792 <!--chtml if pinemode="os_windows"-->
22793 PC-Alpine default is &quot;SAVEMAIL&quot; (normally stored as SAVEMAIL.MTX).
22794 <!--chtml else-->
22795 Unix Alpine default
22796 is normally &quot;saved-messages&quot; in the default folder collection.
22797 <!--chtml endif-->
22798 If you access your email through an IMAP server, especially if you often switch between Unix
22799 and PC-Alpine, or between various desktop email systems, you may want to set this to a folder on an
22800 IMAP server (remember that in order to later access this remote folder through Alpine, it
22801 should be in a folder collection. See <A HREF="h_what_are_collections">Folder Collections Explained</a>
22802 for more information). An example:<p>
22803 <CENTER><SAMP>{monet.art.example.com}mail/saved-messages</SAMP></CENTER>
22804 <P>
22805 See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
22806 details on the syntax of folder definitions.
22807 <P>
22808 <UL>
22809 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22810 </UL><P>
22811 &lt;End of help on this topic&gt;
22812 </BODY>
22813 </HTML>
22814 ====== h_config_postponed_folder =====
22815 <HTML>
22816 <HEAD>
22817 <TITLE>OPTION: <!--#echo var="VAR_postponed-folder"--></TITLE>
22818 </HEAD>
22819 <BODY>
22820 <H1>OPTION: <!--#echo var="VAR_postponed-folder"--></H1>
22821
22822 This value overrides the default name for the folder where postponed
22823 messages are saved.  If this is not a path name, it will be in the default
22824 collection for message Saves.  Any valid folder specification, local or
22825 remote, is allowed.
22826 PC-Alpine default
22827 is &quot;POSTPOND&quot; (stored as POSTPOND.MTX).
22828 The Unix Alpine default is normally &quot;postponed-msgs&quot;
22829 in the default collection.
22830 <P>
22831 Tip: If you are using different installations of (PC-)Alpine -- for example, PC-Alpine on your personal
22832 computer at home, and Unix Alpine on campus -- you can postpone a composition begun with one Alpine and
22833 resume it later with the other if you set this option to the <B>same folder on the same IMAP host</B>
22834 in all Alpine copies you use.
22835 (Remember that in order to later access this remote folder through Alpine, it must be in a folder
22836 collection. See <A HREF="h_what_are_collections">Folder Collections Extensions Explained</a>
22837 for more information). An
22838 example:<p>
22839 <CENTER><SAMP>{monet.art.example.com}mail/postponed-msgs</SAMP></CENTER>
22840 <P>
22841 See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
22842 details on the syntax of folder definitions.
22843 <P>
22844 <UL>
22845 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22846 </UL><P>
22847 &lt;End of help on this topic&gt;
22848 </BODY>
22849 </HTML>
22850 ====== h_config_read_message_folder =====
22851 <HTML>
22852 <HEAD>
22853 <TITLE>OPTION: <!--#echo var="VAR_read-message-folder"--></TITLE>
22854 </HEAD>
22855 <BODY>
22856 <H1>OPTION: <!--#echo var="VAR_read-message-folder"--></H1>
22857
22858 By virtue of specifying a folder name here, Alpine will be configured to
22859 save all messages that you have read during a session into the designated
22860 &quot;read messages&quot; folder.  This allows you to more easily distinguish
22861 between your really new email (in your INBOX) and those that you have
22862 already read.  Depending on how you define the
22863 <A HREF="h_config_auto_read_msgs">&quot;auto-move-read-messages&quot;</A>
22864 setting, you may or may not be asked when you quit
22865 Alpine if you want read messages to be moved to this folder.  In either
22866 case, moving the messages means they will be deleted from your INBOX.
22867 <P>
22868 If this is not a path name, it will be in the default collection for
22869 saves.  Any valid folder specification, local or remote (via IMAP), is
22870 allowed.  There is no default for the name of the read message folder.
22871 <P>
22872 See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
22873 details on the syntax of folder definitions.
22874 <P>
22875 <UL>
22876 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22877 </UL><P>
22878 &lt;End of help on this topic&gt;
22879 </BODY>
22880 </HTML>
22881 ====== h_config_form_folder =====
22882 <HTML>
22883 <HEAD>
22884 <TITLE>OPTION: <!--#echo var="VAR_form-letter-folder"--></TITLE>
22885 </HEAD>
22886 <BODY>
22887 <H1>OPTION: <!--#echo var="VAR_form-letter-folder"--></H1>
22888
22889 A &quot;<!--#echo var="VAR_form-letter-folder"-->&quot; is a mail folder that is intended to
22890 contain messages that you have composed and that are intended to be
22891 sent in their original form repeatedly.
22892
22893 <P>
22894 Setting this variable will alter Alpine's usual behavior when you
22895 execute the Compose command.  Normally, Alpine offers a chance to
22896 continue a postponed or interrupted message should one or the other
22897 exist.  When this variable is set to a folder name that exists, Alpine
22898 will also offer the chance to select a message from the folder to
22899 insert into the composer (much like when continuing a postponed message).
22900 The difference, however, is that Alpine will not automatically delete
22901 the selected message from the Form Letter Folder.
22902 <P>
22903 Setting this variable will also affect Alpine's behavior when you
22904 Postpone a message from the composer.  Normally, Alpine simply stashes
22905 the message away in your
22906 &quot;<A HREF="h_config_postponed_folder"><!--#echo var="VAR_postponed-folder"--></A>&quot;.
22907 Regardless of the specified folder's existence, Alpine will ask which
22908 folder you intend the message to be stored in.  Choose the
22909 &quot;F&quot; option to store the message in your Form Letter Folder.
22910 This is the most common way to add a message to the folder.
22911
22912 <P>
22913 Another method of adding messages to the folder is via the Alpine
22914 composer's <SAMP>Fcc:</SAMP> field.  If you are sending a message that
22915 you expect to send in the same form again, you can enter the Form
22916 Letter Folder's name in this field.  Alpine, as usual, will copy the
22917 message as it's sent.  Note, when you later select this message from
22918 your Form Letter Folder, it will have the same recipients as the original
22919 message.
22920
22921 <P>
22922 To delete a message from the Form Letter Folder, you can either select
22923 the folder from a suitable FOLDER LIST screen, or use the Delete
22924 command in the MESSAGE INDEX offered when selecting from the folder as
22925 part of the Compose command.  You can delete a Form Letter Folder just
22926 as any other folder from a suitable FOLDER LIST screen.
22927
22928 <P>
22929 You may find that the <A HREF="h_rules_roles">&quot;Roles&quot;</A>
22930 facility can be used
22931 to replace the Form Letter Folder.
22932
22933 <P>
22934 See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
22935 details on the syntax of folder definitions.
22936
22937 <P>
22938 <UL>
22939 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22940 </UL><P>
22941 &lt;End of help on this topic&gt;
22942 </BODY>
22943 </HTML>
22944 ====== h_config_archived_folders =====
22945 <HTML>
22946 <HEAD>
22947 <TITLE>OPTION: <!--#echo var="VAR_incoming-archive-folders"--></TITLE>
22948 </HEAD>
22949 <BODY>
22950 <H1>OPTION: <!--#echo var="VAR_incoming-archive-folders"--></H1>
22951
22952 This is like
22953 <A HREF="h_config_read_message_folder"><!--#echo var="VAR_read-message-folder"--></A>,
22954 only more general.  You may archive
22955 any of the folders in your incoming collection.  This is a list of folder
22956 pairs, with the first separated from the second in the pair by a space.
22957 The first folder in a pair is the folder you want to archive, and the
22958 second folder is the folder that read messages from the first should be
22959 moved to.  Depending on how you define the
22960 <A HREF="h_config_auto_read_msgs">&quot;auto-move-read-messages&quot;</A>
22961 setting, you may or may not be asked when you
22962 leave the first folder if you want read messages to be moved to the
22963 second folder.  In either case, moving the messages means they will be
22964 deleted from the first folder.
22965 <P>
22966 The name of the first folder in each pair can be either the technical
22967 specification of the folder (like what appears in your configuration file)
22968 or (much easier) the nickname that you gave the folder when you made it
22969 an incoming folder.
22970 <p>
22971 For example:<p>
22972 <CENTER><SAMP>{monet.art.example.com}inbox {monet.art.example.com}mail/inbox-archive</SAMP></CENTER>
22973 <p>or, using nicknames:<p>
22974 <CENTER><SAMP>inbox inbox-archive</SAMP></CENTER>
22975 <P>
22976 If these are not path names, they will be in the default collection for
22977 saves. Any valid folder specification, local or remote (via IMAP), is
22978 allowed. There is no default.
22979 <P>
22980 See the section on <A HREF="h_valid_folder_names">Valid Folder Names</A> for
22981 details on the syntax of folder definitions.
22982 <P>
22983 <UL>
22984 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
22985 </UL><P>
22986 &lt;End of help on this topic&gt;
22987 </BODY>
22988 </HTML>
22989 ====== h_config_newsrc_path ======
22990 <HTML>
22991 <HEAD>
22992 <TITLE>OPTION: <!--#echo var="VAR_newsrc-path"--></TITLE>
22993 </HEAD>
22994 <BODY>
22995 <H1>OPTION: <!--#echo var="VAR_newsrc-path"--></H1>
22996
22997 This option overrides the default name Alpine uses for your "newsrc" news
22998 status and subscription file.  If set, Alpine will take this value as the
22999 full pathname for the desired newsrc file.<P>
23000
23001 If this option is <B>not</B> set,
23002 <!--chtml if pinemode="os_windows"-->
23003 PC-Alpine looks first for $HOME&#92;NEWSRC (where $HOME defaults to the root
23004 of the current drive, e.g. &quot;C:&#92;&quot;) and then it looks in the same
23005 directory as your pinerc file for NEWSRC.
23006 <!--chtml else-->
23007 Unix Alpine looks for the file ~/.newsrc (that is, the file named .newsrc in
23008 your account's home directory).
23009 <!--chtml endif-->
23010 <P><UL>
23011 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23012 </UL>
23013 <P>
23014 &lt;End of help on this topic&gt;
23015 </BODY>
23016 </HTML>
23017 ====== h_config_literal_sig =====
23018 <HTML>
23019 <HEAD>
23020 <TITLE>OPTION: <!--#echo var="VAR_literal-signature"--></TITLE>
23021 </HEAD>
23022 <BODY>
23023 <H1>OPTION: <!--#echo var="VAR_literal-signature"--></H1>
23024
23025 With this option your actual signature, as opposed to
23026 the name of a file containing your signature,
23027 is stored in the Alpine configuration file.
23028 If this is defined it takes precedence over the <!--#echo var="VAR_signature-file"--> option.
23029 <P>
23030
23031 This is simply a different way to store the signature.
23032 The signature is stored inside your Alpine configuration file instead of in
23033 a separate file.
23034 Tokens work the same way they do with the
23035 <A HREF="h_config_signature_file"><!--#echo var="VAR_signature-file"--></A> so look there for
23036 help.
23037 <P>
23038
23039 The Setup/Signature command on Alpine's MAIN MENU will edit
23040 the &quot;<!--#echo var="VAR_literal-signature"-->&quot; by default.  However, if no
23041 &quot;<!--#echo var="VAR_literal-signature"-->&quot; is defined and the file named in the
23042 &quot;<!--#echo var="VAR_signature-file"-->&quot; option exists, then the latter will be used
23043 instead.
23044 <P>
23045
23046 The two character sequence &#92;n (backslash followed by
23047 the character n) will be used to signify a line-break in your signature.
23048 You don't have to enter the &#92;n, but it will be visible in the
23049 SETUP CONFIGURATION window after you are done editing the signature.
23050
23051 <P>
23052 <UL>
23053 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23054 </UL><P>
23055 &lt;End of help on this topic&gt;
23056 </BODY>
23057 </HTML>
23058 ====== h_config_signature_file =====
23059 <HTML>
23060 <HEAD>
23061 <TITLE>OPTION: <!--#echo var="VAR_signature-file"--></TITLE>
23062 </HEAD>
23063 <BODY>
23064 <H1>OPTION: <!--#echo var="VAR_signature-file"--></H1>
23065
23066 If a <A HREF="h_config_literal_sig"><!--#echo var="VAR_literal-signature"--></A> option is defined,
23067 then this &quot;<!--#echo var="VAR_signature-file"-->&quot; option will be ignored.
23068 You can tell that that is the case because the value of the
23069 &quot;<!--#echo var="VAR_signature-file"-->&quot; will show up as
23070 <P>
23071 <CENTER><SAMP>&lt;Ignored: using <!--#echo var="VAR_literal-signature"--> instead&gt;</SAMP></CENTER>
23072 <P>
23073 You may either use all Literal Signatures (signatures stored in your
23074 configuration file) throughout Alpine, or all signature files.
23075 You can't mix the two.
23076 <P>
23077 This is the name of a file that will be automatically inserted into
23078 outgoing messages.
23079 It typically contains information such as your
23080 name, email address and organizational affiliation.
23081 Alpine adds the
23082 signature into the message as soon as you enter the composer so you
23083 can choose to remove it or edit it on a message by message basis.
23084 Signature file placement in message replies is controlled by the
23085 &quot;<A HREF="h_config_sig_at_bottom"><!--#echo var="FEAT_signature-at-bottom"--></A>&quot;
23086 setting in the feature list.
23087 <P>
23088
23089 The default file name is
23090 <!--chtml if pinemode="os_windows"-->
23091 &quot;PINE.SIG&quot; in the same directory as your PINERC file if your
23092 PINERC file is a local file.
23093 If your PINERC file is remote, then it will be in the directory specified
23094 by the &quot;-aux local_directory&quot; command line option.
23095 <!--chtml else-->
23096 &quot;.signature&quot;.
23097 <!--chtml endif-->
23098 <P>
23099
23100 To create or edit your signature file choose Setup from the MAIN MENU
23101 and then select S for Signature (Main/Setup/Signature).  This puts you
23102 into the Signature Editor where you can enter a <EM>few</EM> lines of
23103 text containing your identity and affiliation.
23104
23105 <P>
23106 If the filename is followed by a vertical bar (|) then instead
23107 of reading the contents of the file the file is assumed to be a
23108 program that will produce the text to be used on its standard output.
23109 The program can't have any arguments and doesn't receive any input from Alpine,
23110 but the rest of the processing works as if the contents came from a file.
23111
23112 <P>
23113 Instead of storing the data in a local file, the
23114 signature data may be stored remotely in an IMAP folder.
23115 In order to do this,
23116 you must use a remote name for the file.
23117 A remote <!--#echo var="VAR_signature-file"--> name might look like:
23118 <P>
23119 <CENTER><SAMP>{myimaphost.myschool.k12.wa.us}mail/signature</SAMP></CENTER>
23120 <P>
23121
23122 The syntax used here is the same as the syntax used for remote configuration
23123 files from the command line.
23124 Note that you may not access an existing signature file remotely,
23125 you have to create a new <EM>folder</EM> that contains the signature data.
23126 If the name you use here for the signature file is a remote name, then when
23127 you edit the file from the Setup/Signature command the data will be stored
23128 remotely in the folder.
23129 You aren't required to do anything special to create the folder, it
23130 gets created automatically if you use a remote name.
23131
23132 <P>
23133 Besides regular text, the signature file may also contain
23134 (or a signature program may produce) tokens that
23135 are replaced with text that usually depends on the message you are replying
23136 to or forwarding.
23137 For example, if the signature file contains the token
23138 <P>
23139 <CENTER><SAMP>_DATE_</SAMP></CENTER>
23140 <P>
23141 anywhere in the text, then that token is replaced by the date
23142 the message you are replying to or forwarding was sent.
23143 If it contains
23144 <P>
23145 <CENTER><SAMP>_CURDATE_</SAMP></CENTER>
23146 <P>
23147 that is replaced with the current date.
23148 The first is an example of a token that depends on the message you
23149 are replying to (or forwarding) and the second is an example which
23150 doesn't depend on anything other than the current date.
23151 You have to be a little careful with this facility since tokens that
23152 depend on the message you are replying to or forwarding will be replaced
23153 by nothing in the case where you are composing a new message from scratch.
23154 The use of <A HREF="h_rules_roles">&quot;roles&quot;</A> may help you
23155 in this respect.
23156 It allows you to use different signature files in different cases.
23157 <P>
23158
23159 The list of tokens available for use in the signature file is
23160 <A HREF="h_index_tokens">here</A>.
23161 <P>
23162
23163 Instead of, or along with the use of &quot;roles&quot; to give you
23164 different signature files in different situations, there is also
23165 a way to conditionally include text based
23166 on whether or not a token would result in specific replacement text.
23167 For example, you could include some text based on whether or not
23168 the _NEWS_ token would result in any newsgroups if it was used.
23169 This is explained in detail
23170 <A HREF="h_reply_token_conditionals">here</A>.
23171 This isn't for the faint of heart.
23172 <P>
23173 In the very unlikely event that you want to include a literal token
23174 in the signature you must precede it with a backslash character.
23175 For example,
23176 <P>
23177 <CENTER><SAMP>&#92;_DAYDATE_ = _DAYDATE_</SAMP></CENTER>
23178 <P>
23179 would produce something like
23180 <P>
23181 <CENTER><SAMP>_DAYDATE_ = Sat, 24 Oct 1998</SAMP></CENTER>
23182 <P>
23183 It is not possible to have a literal backslash followed by an expanded token.
23184 <P>
23185 An alternate method for storing the signature data is available by using the
23186 <A HREF="h_config_literal_sig"><!--#echo var="VAR_literal-signature"--></A> configuration option.
23187 This variable will be used by default.
23188 <P>
23189 <UL>
23190 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23191 </UL><P>
23192 &lt;End of help on this topic&gt;
23193 </BODY>
23194 </HTML>
23195 ====== h_config_init_cmd_list =====
23196 <HTML>
23197 <HEAD>
23198 <TITLE>OPTION: <!--#echo var="VAR_initial-keystroke-list"--></TITLE>
23199 </HEAD>
23200 <BODY>
23201 <H1>OPTION: <!--#echo var="VAR_initial-keystroke-list"--></H1>
23202
23203 The initial keystroke--or command--list option lets you start Alpine at
23204 any place you like.
23205 Whatever keystrokes you specify here will be executed
23206 by Alpine upon startup as a macro.
23207 The words SPACE, TAB, DOWN, UP, LEFT, and
23208 RIGHT indicate the pressing of those keys.
23209 CR indicates the pressing of the RETURN key.
23210 F1 through F12 represent the function keys, and ^ followed
23211 by a character indicates that key pressed along with the control key (in
23212 other words, ^P means Ctrl-P).
23213 As a shortcut notation, an element of the list may be several characters
23214 surrounded by double-quotes (").
23215 That will be expanded into the individual keystrokes
23216 (excluding the double-quote characters).
23217 For example, the quoted-string
23218
23219 <P><CENTER>"ABC"</CENTER>
23220
23221 <P>
23222 is interpreted the same as the three separate list members
23223
23224 <P><CENTER>A and B and C</CENTER>
23225
23226 <P>
23227 which is also the same as
23228
23229 <P><CENTER>A,B,C</CENTER>
23230
23231 <P>
23232 An example: To view message 1 on startup,
23233 you could use an <!--#echo var="VAR_initial-keystroke-list"--> equal to
23234
23235 <P><CENTER>I,J,1,CR,V</CENTER>
23236
23237 <P>
23238 An equivalent version of this is
23239
23240 <P><CENTER>"IJ1",CR,V</CENTER>
23241
23242 <P>
23243 Restrictions: You cannot pre-type into the composer with the initial
23244 keystroke list, and you cannot mix function key commands with letter
23245 commands.
23246
23247 <P><UL>
23248 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23249 </UL>
23250 <P>
23251 &lt;End of help on this topic&gt;
23252 </BODY>
23253 </HTML>
23254 ====== h_config_comp_hdrs =====
23255 <html>
23256 <header>
23257 <title>OPTION: <!--#echo var="VAR_default-composer-hdrs"--></title>
23258 </header>
23259 <body>
23260 <h1>OPTION: <!--#echo var="VAR_default-composer-hdrs"--></h1>
23261
23262 You can control which headers you want visible when composing outgoing
23263 email using this option.
23264 You can specify any of the regular set, any
23265 <A HREF="h_compose_richhdr">Rich Header</A>,
23266 or any <A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A>
23267 that you have already defined.
23268 If you use this setting at all, you must specify all the
23269 headers you want to see, you can't just add to the regular header set.
23270 The default set is To:, Cc:, Attchmnt:, and Subject:.<p>
23271
23272 Note that the "Newsgroups:" header will be abbreviated in the Composer
23273 display, but should be spelled out in full here.<p>
23274 <UL>
23275 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23276 </UL><P>
23277 &lt;End of help on this topic&gt;
23278 </body>
23279 </html>
23280 ====== h_config_custom_hdrs =====
23281 <HTML>
23282 <HEAD>
23283 <TITLE>OPTION: <!--#echo var="VAR_customized-hdrs"--></TITLE>
23284 </HEAD>
23285 <BODY>
23286 <H1>OPTION: <!--#echo var="VAR_customized-hdrs"--></H1>
23287
23288 You may add your own custom headers to outgoing messages.
23289 Each header you specify here must include the header tag
23290 (<A HREF="h_composer_reply_to">Reply-To:</A>, Approved:, etc.)
23291 and may optionally include a value for that header.
23292 If you want to see these custom headers each time you compose a message,
23293 you must add them to your
23294 <A HREF="h_config_comp_hdrs"><!--#echo var="VAR_default-composer-hdrs"--></A> list,
23295 otherwise they become part
23296 of the rich header set that you only see when you press the
23297 <A HREF="h_compose_richhdr">Rich Header</A>
23298 <!--chtml if pinemode="function_key"-->(F5)
23299 <!--chtml else-->(Ctrl-R)<!--chtml endif--> command.
23300 (If you are looking for a way to change which headers are <EM>displayed</EM>
23301 when you view a message, take a look at the
23302 <A HREF="h_config_viewer_headers"><!--#echo var="VAR_viewer-hdrs"--></A>
23303 option instead.)
23304 Here's an example that shows how you might set your From address
23305 <P>
23306 <CENTER><SAMP>From: Full Name &lt;user@example.com&gt;</SAMP></CENTER>
23307 <P>
23308 and another showing how you might set a Reply-To address
23309 <P>
23310 <CENTER><SAMP>Reply-To: user@example.com</SAMP></CENTER>
23311 <P>
23312 You may also set non-standard header values here.
23313 For example, you could add
23314 <P>
23315 <CENTER><SAMP>Organization: My Organization Name</SAMP></CENTER>
23316 <P>
23317 or even
23318 <P>
23319 <CENTER><SAMP>X-Favorite-Colors: Purple and Gold</SAMP></CENTER>
23320 <P>
23321 If you include a value after the colon then that header will be included
23322 in your outgoing messages unless you delete it before sending.
23323 If a header in the <!--#echo var="VAR_customized-hdrs"--> list has only a tag but no value, then
23324 it will not be included in outgoing messages unless you edit a value
23325 in manually.
23326 For example, if
23327 <P>
23328 <CENTER><SAMP>Reply-To:</SAMP></CENTER>
23329 <P>
23330 is in the list, then the Reply-To header will be available for editing
23331 but won't be included unless a value is added while in the composer.
23332 <P>
23333 It's actually a little more complicated than that.
23334 The values of headers that you set with the <!--#echo var="VAR_customized-hdrs"--> option are
23335 defaults.
23336 If the message you are about to compose already has a value for a header,
23337 that value is used instead of a value from your <!--#echo var="VAR_customized-hdrs"-->.
23338 For example, if you are Replying to a message the Subject field
23339 will already be filled in.
23340 In that case, if the <!--#echo var="VAR_customized-hdrs"--> list contains a Subject line, the
23341 custom subject will <EM>NOT</EM> be used.
23342 The subject derived from the subject of the message you are Replying
23343 to will be used instead.
23344 <P>
23345 It is also possible to make header setting even more complicated and more
23346 automatic by using
23347 <A HREF="h_rules_roles">Roles</A>,
23348 but if all you want to do is set a default value for a header, you don't
23349 need to think about Roles.
23350 <P>
23351 If you change your From address you may also find it useful to add the
23352 changed From address to the
23353 <a href="h_config_alt_addresses"><!--#echo var="VAR_alt-addresses"--></a>
23354 configuration option.
23355 <P>
23356 Limitation: Because commas are used to separate the list of
23357 <!--#echo var="VAR_customized-hdrs"-->, it is not possible to have the value of a
23358 header contain a comma.
23359 Nor is there currently an &quot;escape&quot; mechanism provided
23360 to make this work.
23361 <P><UL>
23362 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23363 </UL>
23364 <P>
23365 &lt;End of help on this topic&gt;
23366 </BODY>
23367 </HTML>
23368 ====== h_config_viewer_headers =====
23369 <HTML>
23370 <HEAD>
23371 <TITLE>OPTION: <!--#echo var="VAR_viewer-hdrs"--></TITLE>
23372 </HEAD>
23373 <BODY>
23374 <H1>OPTION: <!--#echo var="VAR_viewer-hdrs"--></H1>
23375
23376 You may change the default list of headers that are viewed by listing
23377 the headers you want to view here.  If the headers in your
23378 &quot;<!--#echo var="VAR_viewer-hdrs"-->&quot; list are present in the message, then they
23379 will be shown.  The order of the headers you list will be honored.  If
23380 the special value &quot;all-except&quot; is included as the first
23381 header in the &quot;<!--#echo var="VAR_viewer-hdrs"-->&quot; list, then all headers in the
23382 message except those in the list will be shown.  The values are all
23383 case insensitive.
23384
23385 <P>
23386 Note that once you put anything in the &quot;<!--#echo var="VAR_viewer-hdrs"-->&quot; list,
23387 then the original default headers are ignored.  So, if you just wanted
23388 to add the header Organization to the list, you would have to list
23389 Organization plus all of the other headers originally in the default
23390 list.  If you just included Organization and nothing else, then you
23391 would see only the Organization header, nothing else.
23392
23393 <P>
23394 The default list of headers includes:
23395 <UL>
23396   <LI>From
23397   <LI>Resent-From
23398   <LI>To
23399   <LI>Resent-To
23400   <LI>Cc
23401   <LI>Resent-cc
23402   <LI>Bcc
23403   <LI>Newsgroups
23404   <LI>Followup-To
23405   <LI>Date
23406   <LI>Resent-Date
23407   <LI>Subject
23408   <LI>Resent-Subject
23409   <LI>Reply-To
23410 </UL>
23411
23412 <P>
23413 If you are looking for a way to control which headers are included in
23414 outgoing mail and are visible or not in the composer, take a look at the
23415 options
23416 <A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A>
23417 and <A HREF="h_config_comp_hdrs"><!--#echo var="VAR_default-composer-hdrs"--></A> instead of
23418 this option.
23419 <P>
23420 <UL>
23421 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23422 </UL><P>
23423 &lt;End of help on this topic&gt;
23424 </BODY>
23425 </HTML>
23426 ====== h_config_viewer_margin_left =====
23427 <HTML>
23428 <HEAD>
23429 <TITLE>OPTION: <!--#echo var="VAR_viewer-margin-left"--></TITLE>
23430 </HEAD>
23431 <BODY>
23432 <H1>OPTION: <!--#echo var="VAR_viewer-margin-left"--></H1>
23433
23434 This variable controls the left-hand vertical margin's width in
23435 Alpine's Message Viewing screen.
23436 Its value is the number of space characters preceding each displayed line.
23437 For consistency with
23438 <A HREF="h_config_viewer_margin_right"><!--#echo var="VAR_viewer-margin-right"--></A>,
23439 you may specify the column number to start in
23440 (column numbering begins with number 1)
23441 instead of the width of the margin by appending a lower case letter
23442 &quot;c&quot; to the number.
23443 For example, a value of &quot;2c&quot; means to start the text in column two,
23444 which is entirely equivalent to a value of &quot;1&quot;, which means to
23445 leave a margin of 1 space.
23446 <P>
23447 The default is a left margin of 0 (zero).
23448 Misconfigurations (for example, negative values or values with starting
23449 left columns greater than the ending right column)
23450 are silently ignored.
23451 If the number of columns for text between the <!--#echo var="VAR_viewer-margin-left"--> and
23452 the <!--#echo var="VAR_viewer-margin-right"--> is fewer than 8, then margins of zero will be used
23453 instead.
23454
23455 <P>
23456 &lt;End of help on this topic&gt;
23457 </BODY>
23458 </HTML>
23459 ====== h_config_viewer_margin_right =====
23460 <HTML>
23461 <HEAD>
23462 <TITLE>OPTION: <!--#echo var="VAR_viewer-margin-right"--></TITLE>
23463 </HEAD>
23464 <BODY>
23465 <H1>OPTION: <!--#echo var="VAR_viewer-margin-right"--></H1>
23466
23467 This variable controls the right-hand vertical margin's width in
23468 Alpine's Message Viewing screen.
23469 Its value is the number of space characters following each displayed line.
23470 You may specify the column number to end the text in
23471 (column numbering begins with number 1)
23472 instead of the width of the margin by appending a lower case letter
23473 &quot;c&quot; to the number.
23474 For example, a value of &quot;76c&quot; means to end the text in column 76.
23475 If the screen is 80 characters wide, this is equivalent to a value
23476 of &quot;4&quot;, which means to leave a margin of 4 spaces.
23477 However, if you use different size screens at different times, then these
23478 two values are not equivalent.
23479 <P>
23480 The default right margin is 4.
23481 Misconfigurations (for example, negative values or values with starting
23482 left columns greater than the ending right column)
23483 are silently ignored.
23484 If the number of columns for text between the
23485 <A HREF="h_config_viewer_margin_left"><!--#echo var="VAR_viewer-margin-left"--></A> and
23486 the <!--#echo var="VAR_viewer-margin-right"--> is fewer than 8, then margins of zero will be used
23487 instead.
23488
23489 <P>
23490 &lt;End of help on this topic&gt;
23491 </BODY>
23492 </HTML>
23493 ====== h_config_quote_suppression =====
23494 <HTML>
23495 <HEAD>
23496 <TITLE>OPTION: <!--#echo var="VAR_quote-suppression-threshold"--></TITLE>
23497 </HEAD>
23498 <BODY>
23499 <H1>OPTION: <!--#echo var="VAR_quote-suppression-threshold"--></H1>
23500
23501 This option should be used with care.
23502 It will cause some of the quoted text to be eliminated from the
23503 display when viewing a message in the MESSAGE TEXT screen.
23504 For example, if you set the <!--#echo var="VAR_quote-suppression-threshold"--> to the
23505 value &quot;5&quot;,
23506 this will cause quoted text that is longer than five lines to be truncated.
23507 Quoted text of five or fewer consecutive lines will be displayed in its entirety.
23508 Quoted text of more than six lines will have the first five lines displayed
23509 followed by a line that looks something like
23510 <P>
23511 <CENTER><SAMP>[ 12 lines of quoted text hidden from view ]</SAMP></CENTER>
23512 <P>
23513 As a special case, if exactly one line of quoted text would be hidden, the
23514 entire quote will be shown instead.
23515 So for the above example, quoted text that is exactly six lines long will
23516 will be shown in its entirety.
23517 (In other words, instead of hiding a single line and adding a line
23518 that announces that one line was hidden, the line is just shown.)
23519 <P>
23520 If the sender of a message has carefully chosen the quotes that he or she
23521 includes, hiding those quotes may change the meaning of the message.
23522 For that reason, Alpine requires that when you want to set the value of this
23523 variable to something less than four lines, you actually have to set it
23524 to the negative of that number.
23525 So if you want to set this option to &quot;3&quot;, you actually have to
23526 set it to &quot;-3&quot;.
23527 The only purpose of this is to get you to think about whether or not you
23528 really want to do this!
23529 If you want to delete all quoted text you set the value of this option
23530 to the special value &quot;-10&quot;.
23531 <P>
23532 The legal values for this option are
23533 <P>
23534 <TABLE>
23535 <TR>
23536   <TD> &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;0&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </TD>
23537   <TD> Default, don't hide anything </TD>
23538 </TR>
23539 <TR>
23540   <TD> &nbsp;-1,-2,-3&nbsp;&nbsp; </TD>
23541   <TD> Suppress quote lines past 1, 2, or 3 lines </TD>
23542 </TR>
23543 <TR>
23544   <TD> &nbsp;4,5,6,...&nbsp; </TD>
23545   <TD> Suppress if more than that many lines </TD>
23546 </TR>
23547 <TR>
23548   <TD> &nbsp;&nbsp;&nbsp;-10&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </TD>
23549   <TD> Suppress all quoted lines </TD>
23550 </TR>
23551 </TABLE>
23552 <P>
23553 If you set this option to a non-default value you may sometimes wish to
23554 view the quoted text that is not shown.
23555 When this is the case, the
23556 <A HREF="h_common_hdrmode">HdrMode Command</A>
23557 may be used to show the hidden text.
23558 Typing the &quot;H&quot; command once will show the hidden text.
23559 Typing a second &quot;H&quot; will also turn on Full Header mode.
23560 The presence or absence of the HdrMode command is determined by the
23561 <A HREF="h_config_enable_full_hdr">&quot;<!--#echo var="FEAT_enable-full-header-cmd"-->&quot;</A>
23562 Feature-List option in your Alpine configuration, so you will want to
23563 be sure that is turned on if you use quote suppression.
23564 <P>
23565 For the purposes of this option, a quote is a line that begins with the
23566 character &quot;&gt;&quot;.
23567 <P>
23568 Quotes are only suppressed when displaying a message on the screen.
23569 The entire quote will be left intact when printing or forwarding or something
23570 similar.
23571 <P>
23572 &lt;End of help on this topic&gt;
23573 </BODY>
23574 </HTML>
23575 ====== h_config_saved_msg_name_rule =====
23576 <HTML>
23577 <HEAD>
23578 <TITLE>OPTION: <!--#echo var="VAR_saved-msg-name-rule"--></TITLE>
23579 </HEAD>
23580 <BODY>
23581 <H1>OPTION: <!--#echo var="VAR_saved-msg-name-rule"--></H1>
23582
23583 This option determines the default folder name when saving
23584 a message.
23585
23586 <P>
23587 The default option is &quot;default-folder&quot;, which is the folder
23588 called &quot;saved-messages&quot; in Unix Alpine and
23589 &quot;savemail&quot; in PC-Alpine.  To change the default folder, modify
23590 the Alpine option called
23591 <A HREF="h_config_def_save_folder">&quot;<!--#echo var="VAR_default-saved-msg-folder"-->&quot;</A>.
23592
23593 <P>
23594 Choosing any of the &quot;by-&quot; options cause Alpine to attempt to
23595 get the chosen option's value for the message being saved (or for the
23596 first message being saved if using an aggregrate save).
23597 For example, if &quot;by-from&quot; is chosen, Alpine attempts to get the
23598 value of who the message came from (i.e. the from address).
23599 Alpine then attempts to save the message to a folder matching that value.
23600 If &quot;by-from&quot; is chosen and no value is obtained, Alpine uses
23601 &quot;by-sender&quot;.
23602 The opposite is also true.
23603 If &quot;by-recipient&quot; is chosen and the message was posted to a
23604 newsgroup, Alpine will use the newsgroup name.
23605 If &quot;by-replyto&quot; is chosen and no value is obtained, Alpine uses
23606 &quot;by-from&quot;.
23607
23608 <P>
23609 If any of the &quot;by-realname&quot; options are chosen, Alpine will attempt
23610 to use the personal name part of the address instead of the mailbox part.
23611 If any of the &quot;by-nick&quot; options are chosen, the
23612 address is looked up in your address book and if found, the
23613 nickname for that entry is used.
23614 Only simple address book entries are checked, not distribution lists.
23615 Similarly, if any of the
23616 &quot;by-fcc&quot; options are chosen, the fcc from the corresponding
23617 address book entry is used.
23618 If by-realname, or the by-nick or by-fcc lookups result in no value,
23619 then if the chosen option ends with the &quot;then-from&quot;,
23620 &quot;then-sender&quot;, &quot;then-replyto&quot;,
23621 or &quot;then-recip&quot; suffix, Alpine
23622 reverts to the same behavior as &quot;by-from&quot;,
23623 &quot;by-sender&quot;, &quot;by-replyto&quot;, or &quot;by-recip&quot;
23624 depending on which option was specified.
23625 If the chosen option doesn't end with one of
23626 the &quot;then-&quot; suffixes, then Alpine reverts to the default
23627 folder when no match is found in the address book.
23628
23629 <P>
23630 Choosing the option called &quot;last-folder-used&quot;, causes Alpine
23631 to save to the folder that you saved to the last time you saved a
23632 message.  The first time you save a message in an Alpine session, Alpine
23633 attempts to save the message to the default folder.
23634
23635 <P>
23636 Here is an example to make some of the options clearer.
23637 If the message is From
23638 <P>
23639 <CENTER><SAMP>Fred Flintstone &lt;flint@bedrock.org&gt;</SAMP></CENTER>
23640 <P>
23641 and this rule is set to &quot;by-from&quot;, then the default folder offered
23642 in the save dialog would be &quot;flint&quot;.
23643 <P>
23644 If this rule is set to &quot;by-realname-of-from&quot; then the default would
23645 be &quot;Fred Flintstone&quot;.
23646 <P>
23647 If this rule is set to &quot;by-nick-of-from&quot; then Alpine will search
23648 for the address &quot;flint@bedrock.org&quot; in your address book.
23649 If an entry is found and it has a nickname associated with it, that nickname
23650 will be offered as the default folder.
23651 If not, the default saved message folder will be offered as the default.
23652 <P>
23653 If this rule is set to &quot;by-fcc-of-from&quot; then Alpine will search
23654 for the address &quot;flint@bedrock.org&quot; in your address book.
23655 If an entry is found and it has an Fcc associated with it, that Fcc
23656 will be offered as the default folder.
23657 If not, the default saved message folder will be offered as the default.
23658 <P>
23659 If this rule is set to &quot;by-nick-of-from-then-from&quot; then Alpine will search
23660 for the address &quot;flint@bedrock.org&quot; in your address book.
23661 If an entry is found and it has a nickname associated with it, that nickname
23662 will be offered as the default folder.
23663 If it is not found (or has no nickname) then the default offered will be
23664 the same as it would be for the &quot;by-from&quot; rule.
23665 That is, it would be &quot;flint&quot;
23666 <P>
23667 <UL>
23668 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23669 </UL><P>
23670 &lt;End of help on this topic&gt;
23671 </BODY>
23672 </HTML>
23673 ====== h_config_fcc_rule =====
23674 <HTML>
23675 <HEAD>
23676 <TITLE>OPTION: <!--#echo var="VAR_fcc-name-rule"--></TITLE>
23677 </HEAD>
23678 <BODY>
23679 <H1>OPTION: <!--#echo var="VAR_fcc-name-rule"--></H1>
23680
23681 This option determines the default name for folder carbon copy. Choose
23682 one:
23683
23684 <DL>
23685 <DT>default-fcc</DT>
23686 <DD>This is the normal default, the value of which is set in the
23687 &quot;<!--#echo var="VAR_default-fcc"-->&quot; variable as specified earlier in this
23688 configuration.
23689 </DD>
23690
23691 <DT>last-fcc-used</DT>
23692 <DD> Causes Alpine to use the folder that was last
23693 used in the fcc field
23694 </DD>
23695
23696 <DT>by-nickname</DT>
23697 <DD>Means that Alpine will use the nickname
23698 from your address book that matches the first address in the To line.
23699 If there is no match, it will use the value of the
23700 &quot;<!--#echo var="VAR_default-fcc"-->&quot; variable.
23701 </DD>
23702
23703 <DT>by-recipient</DT>
23704 <DD>Means Alpine will form a folder name
23705 based on the left hand side of the first address in the To line.
23706 </DD>
23707
23708 <DT>by-nick-then-recip</DT>
23709 <DD>Means that it will use the
23710 matching nickname from your address book if there is one, otherwise it
23711 will extract the recipient name from the address and use that (like
23712 by-recipient).
23713 </DD>
23714
23715 <DT>current-folder</DT>
23716 <DD>Causes a copy to be written to
23717 the currently open folder, unless that is the INBOX.  In the case
23718 where the current folder is the INBOX, the &quot;<!--#echo var="VAR_default-fcc"-->&quot; is
23719 used instead.
23720 </DD>
23721 </DL>
23722
23723 <P>
23724 Note: Whatever the fcc specified by the rule here, it will be
23725 over-ridden by any fcc entries you have in your address book.
23726
23727 <P>
23728 <UL>
23729 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23730 </UL><P>
23731 &lt;End of help on this topic&gt;
23732 </BODY>
23733 </HTML>
23734 ====== h_config_sort_key =====
23735 <HTML>
23736 <HEAD>
23737 <TITLE>OPTION: <!--#echo var="VAR_sort-key"--></TITLE>
23738 </HEAD>
23739 <BODY>
23740 <H1>OPTION: <!--#echo var="VAR_sort-key"--></H1>
23741
23742 This option determines the order in which messages will be displayed in
23743 the MESSAGE INDEX screen.  Choose from:
23744 <P>
23745 <UL>
23746  <LI> <A HREF="h_index_sort_arrival">Arrival</A>
23747  <LI> <A HREF="h_index_sort_date">Date</A>
23748  <LI> <A HREF="h_index_sort_subj">Subject</A>
23749  <LI> <A HREF="h_index_sort_ordsubj">OrderedSubj</A>
23750  <LI> <A HREF="h_index_sort_thread">Thread</A>
23751  <LI> <A HREF="h_index_sort_from">From</A>
23752  <LI> <A HREF="h_index_sort_size">Size</A>
23753  <LI> <A HREF="h_index_sort_score">Score</A>
23754  <LI> <A HREF="h_index_sort_to">To</A>
23755  <LI> <A HREF="h_index_sort_cc">Cc</A>
23756 </UL>
23757
23758 <P>
23759 Each type of sort may also be reversed.
23760 Normal default is by &quot;Arrival&quot;.
23761
23762 <P>
23763 A possible point of confusion arises when you change the configuration
23764 of the <!--#echo var="VAR_sort-key"-->.
23765 The folder will normally be re-sorted when you go back to viewing the
23766 index.
23767 However, if you have manually sorted the folder with the
23768 Sort
23769 (<!--chtml if pinemode="function_key"-->F7<!--chtml else-->$<!--chtml endif-->)
23770 command, then it will not be re-sorted until the next time it is opened.
23771
23772 <P>
23773 <UL>
23774 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23775 </UL><P>
23776 &lt;End of help on this topic&gt;
23777 </BODY>
23778 </HTML>
23779 ====== h_config_other_startup =====
23780 <HTML>
23781 <HEAD>
23782 <TITLE>OPTION: Set Startup Rule</TITLE>
23783 </HEAD>
23784 <BODY>
23785 <H1>OPTION: Set Startup Rule</H1>
23786
23787 This option determines which message will be the <EM>current message</EM> when
23788 the folder is first opened.
23789 It works the same way that the option
23790 <A HREF="h_config_inc_startup"><!--#echo var="VAR_incoming-startup-rule"--></A>
23791 works, so look there for help.
23792 It may be used for any folder, not just incoming folders.
23793
23794 <P>
23795 <UL>
23796 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23797 </UL><P>
23798 &lt;End of help on this topic&gt;
23799 </BODY>
23800 </HTML>
23801 ====== h_config_perfolder_sort =====
23802 <HTML>
23803 <HEAD>
23804 <TITLE>Set Sort Order</TITLE>
23805 </HEAD>
23806 <BODY>
23807 <H1>Set Sort Order</H1>
23808
23809 This option determines the order in which messages will be displayed in
23810 the MESSAGE INDEX screen when the Current Folder Type set in the
23811 Pattern is a match. Choose from:
23812 <P>
23813 <UL>
23814  <LI> <A HREF="h_index_sort_default">Default</A>
23815  <LI> <A HREF="h_index_sort_arrival">Arrival</A>
23816  <LI> <A HREF="h_index_sort_date">Date</A>
23817  <LI> <A HREF="h_index_sort_subj">Subject</A>
23818  <LI> <A HREF="h_index_sort_ordsubj">OrderedSubj</A>
23819  <LI> <A HREF="h_index_sort_thread">Thread</A>
23820  <LI> <A HREF="h_index_sort_from">From</A>
23821  <LI> <A HREF="h_index_sort_size">Size</A>
23822  <LI> <A HREF="h_index_sort_score">Score</A>
23823  <LI> <A HREF="h_index_sort_to">To</A>
23824  <LI> <A HREF="h_index_sort_cc">Cc</A>
23825 </UL>
23826
23827 <P>
23828 Each type of sort may also be reversed.
23829 Normal default is by &quot;Arrival&quot;.
23830
23831 <P>
23832 A possible point of confusion arises when you change the configuration
23833 of the Sort Order for the currently open folder.
23834 The folder will normally be re-sorted when you go back to viewing the
23835 index.
23836 However, if you have manually sorted the folder with the
23837 Sort
23838 (<!--chtml if pinemode="function_key"-->F7<!--chtml else-->$<!--chtml endif-->)
23839 command, then it will not be re-sorted until the next time it is opened.
23840
23841 <P>
23842 <UL>
23843 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23844 </UL><P>
23845 &lt;End of help on this topic&gt;
23846 </BODY>
23847 </HTML>
23848 ====== h_config_fld_sort_rule =====
23849 <HTML>
23850 <HEAD>
23851 <TITLE>OPTION: <!--#echo var="VAR_folder-sort-rule"--></TITLE>
23852 </HEAD>
23853 <BODY>
23854 <H1>OPTION: <!--#echo var="VAR_folder-sort-rule"--></H1>
23855
23856 This option controls the order in which folder list entries will be
23857 presented in the FOLDER LIST screen.  Choose one of the following:
23858
23859 <DL>
23860 <DT>Alphabetical</DT>
23861 <DD>sort by alphabetical name independent of type
23862 </DD>
23863
23864 <DT>Alpha-with-dirs-last</DT>
23865 <DD>sort by alphabetical name grouping directory entries
23866 to the end of the list
23867 </DD>
23868
23869 <DT>Alpha-with-dirs-first</DT>
23870 <DD>sort by alphabetical name grouping directory entries
23871 to the start of the list
23872 </DD>
23873 </DL>
23874
23875 The normal default is &quot;Alphabetical&quot;.
23876
23877 <P>
23878 <UL>
23879 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23880 </UL><P>
23881 &lt;End of help on this topic&gt;
23882 </BODY>
23883 </HTML>
23884 ====== h_config_ab_sort_rule =====
23885 <HTML>
23886 <HEAD>
23887 <TITLE>OPTION: <!--#echo var="VAR_addrbook-sort-rule"--></a></TITLE>
23888 </HEAD>
23889 <BODY>
23890 <H1>OPTION: <!--#echo var="VAR_addrbook-sort-rule"--></a></H1>
23891
23892 This option controls the order in which address book entries will be
23893 presented.  Choose one of the following:
23894
23895 <DL>
23896 <DT>fullname</DT>
23897 <DD>use fullname field, lists mixed in
23898 </DD>
23899
23900 <DT>fullname-with-lists-last</DT>
23901 <DD>use fullname field, but put lists at end
23902 </DD>
23903
23904 <DT>nickname</DT>
23905 <DD>use nickname field, lists mixed in
23906 </DD>
23907
23908 <DT>nickname-with-lists-last</DT>
23909 <DD>use nickname field, but put lists at end
23910 </DD>
23911
23912 <DT>dont-sort</DT>
23913 <DD>don't change order of file
23914 </DD>
23915 </DL>
23916
23917 <P>
23918 The normal default is &quot;fullname-with-lists-last&quot;.
23919 If you use an address book from more than one computer and those
23920 computers sort the address book differently then the sort order
23921 will be the order where the last change to the address book was
23922 made.
23923 There are two reasons the sorting might be different on different
23924 systems.
23925 First, the <!--#echo var="VAR_addrbook-sort-rule"--></a> may be set differently in the two
23926 places.
23927 Second, the collation rules on the two computers may be different.
23928 For example, one system might ignore special characters while the other
23929 doesn't or one may sort upper and lower case letters together while
23930 the other doesn't.
23931 In any case, the order you see is the order on the system where the
23932 last change was made, for example by an address book edit or a
23933 Take Address command.
23934
23935 <P>
23936 <UL>
23937 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
23938 </UL><P>
23939 &lt;End of help on this topic&gt;
23940 </BODY>
23941 </HTML>
23942 ====== h_config_post_char_set =====
23943 <HTML>
23944 <HEAD>
23945 <TITLE>OPTION: <!--#echo var="VAR_posting-character-set"--></TITLE>
23946 </HEAD>
23947 <BODY>
23948 <H1>OPTION: <!--#echo var="VAR_posting-character-set"--></H1>
23949
23950 The <!--#echo var="VAR_posting-character-set"--> configuration option is used
23951 when sending messages.
23952
23953 <P>
23954
23955 When sending a message the text typed in the composer is
23956 labeled with the character set specified by this option.
23957 If the composed text is not fully representable in the
23958 specified <!--#echo var="VAR_posting-character-set"-->, then it is labeled as &quot;UTF-8.&quot
23959 instead;
23960
23961 <P>
23962 Attachments are labeled with your
23963 <A HREF="h_config_key_char_set">&quot;Keyboard Character Set&quot;</A>.
23964
23965 <P>
23966 Generally, there should be little need to set this option.
23967 If left unset, the
23968 default behavior is to label composed text as specifically as
23969 possible.  That is, if the composed text has no non-ASCII characters,
23970 it is labeled as &quot;US-ASCII.&quot; Similarly, if it is composed of
23971 only ISO-8859-15 characters, it is labeled as such.  Alpine will
23972 attempt to automatically detect a number of character sets including ISO-8859-15,
23973 ISO-8859-1, ISO-8859-2, VISCII, KOI8-R, KOI8-U, ISO-8859-7, ISO-8859-6,
23974 ISO-8859-8, TIS-620, ISO-2022-JP, GB2312, BIG5, and EUC-KR.
23975 If the message contains a mix of character sets,
23976 it is labeled as &quot;UTF-8.&quot;
23977
23978 <P>
23979
23980 This setting is provided to allow you to force a particular character set that
23981 Alpine does not automatically detect. For example, if a message is representable
23982 in more than one character set then Alpine may choose a different default
23983 than you want.
23984 Lastly, by setting this option explicitly to
23985 &quot;UTF-8&quot; all non-ASCII messages you send will be labeled as
23986 &quot;UTF-8&quot; instead of something more specific.
23987
23988 <P>
23989 In the Setup/Config screen you may choose from a list of all the
23990 character sets Alpine knows about by using the &quot;T&quot; ToCharsets command.
23991
23992 <P>
23993 The options
23994 <A HREF="h_config_char_set">&quot;Display Character Set&quot;</A>
23995 and <A HREF="h_config_key_char_set">&quot;Keyboard Character Set&quot;</A>
23996 are closely related.
23997 Setting the feature
23998 <A HREF="h_config_use_system_translation">&quot;Use System Translation&quot;</A>
23999 should cause this option to be ignored.
24000
24001 <P>
24002 <UL>
24003 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24004 </UL><P>
24005 &lt;End of help on this topic&gt;
24006 </BODY>
24007 </HTML>
24008 ====== h_config_unk_char_set =====
24009 <HTML>
24010 <HEAD>
24011 <TITLE>OPTION: <!--#echo var="VAR_unknown-character-set"--></TITLE>
24012 </HEAD>
24013 <BODY>
24014 <H1>OPTION: <!--#echo var="VAR_unknown-character-set"--></H1>
24015
24016 The <!--#echo var="VAR_unknown-character-set"--> configuration option is used
24017 when reading or replying to messages.
24018
24019 <P>
24020
24021 A text message should either be made up of all US-ASCII characters
24022 or it should contain a charset label which tells the software which
24023 character set encoding to use to interpret the message.
24024 Sometimes a malformed message may be unlabeled but contain non-ascii text.
24025 This message is outside of the standards so any attempt to read it could fail.
24026 When Alpine attempts to read such a message it will try to interpret the
24027 text in the character set you specify here.
24028 For example, if you have correspondents who send you unlabeled messages that
24029 are usually made up of characters from the WINDOWS-1251 character set, setting
24030 this <!--#echo var="VAR_unknown-character-set"--> to <CODE>WINDOWS-1251</CODE> will
24031 allow you to read those messages.
24032 Of course, if the unlabeled message is actually in some other character set,
24033 then you may see garbage on your screen.
24034 <P>
24035 Instead of just unlabeled text, this option also affects text which is labeled
24036 with the charsets &quot;X-Unknown&quot;, &quot;MISSING_PARAMETER_VALUE&quot;
24037 or &quot;US-ASCII&quot;.
24038
24039 <P>
24040 In the Setup/Config screen you may choose from a list of all the
24041 character sets Alpine knows about by using the &quot;T&quot; ToCharsets command.
24042
24043 <P>
24044 <UL>
24045 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24046 </UL><P>
24047 &lt;End of help on this topic&gt;
24048 </BODY>
24049 </HTML>
24050 ====== h_config_char_set =====
24051 <HTML>
24052 <HEAD>
24053 <TITLE>OPTION: Display Character Set</TITLE>
24054 </HEAD>
24055 <BODY>
24056 <H1>OPTION: Display Character Set</H1>
24057
24058 The Display Character Set configuration option is used when viewing messages.
24059 <P>
24060 Alpine uses Unicode characters internally and
24061 it is a goal for Alpine to handle email in many different languages.
24062 Alpine will properly display only left-to-right character sets
24063 in a fixed-width font. Specifically, Alpine assumes that a fixed-width
24064 font is in use, in the sense that
24065 characters are assumed to take up zero, one, or two character cell
24066 widths from left to right on the screen. This is true even in PC-Alpine.
24067 <P>
24068
24069 Alpine recognizes some local character sets that are right-to-left
24070 (Arabic, Hebrew, and Thai) or not representable in a fixed-width font
24071 (Arabic) and properly converts texts in these character sets to/from
24072 Unicode; however, there are known display bugs with these character
24073 sets.
24074 <P>
24075
24076 There are three possible configuration character settings and some
24077 environment variable settings that can affect how Alpine
24078 handles international characters.
24079 The first two of these are only available in UNIX Alpine.
24080 The three configuration options are
24081 Display Character Set,
24082 Keyboard Character Set, and
24083 <!--#echo var="VAR_posting-character-set"-->.
24084 The Keyboard Character Set defaults to being the same value
24085 as the Display Character Set, and that is usually correct, because
24086 the keyboard almost always produces characters in the same character set
24087 as the display displays.
24088 The Display Character Set is the character set that Alpine
24089 will attempt to use when sending characters to the display.
24090 <P>
24091
24092 By default, the Display Character Set variable is not set and UNIX Alpine
24093 will attempt to get this information from the environment.
24094 In particular, the <CODE>nl_langinfo(CODESET)</CODE> call is used.
24095 This usually depends on the setting of the environment variables LANG or LC_CTYPE.
24096 An explicit configuration setting for Display Character Set will,
24097 of course, override any default setting.
24098 <P>
24099 For PC-Alpine the Display Character Set
24100 and the Keyboard Character Set
24101 are always equivalent to <CODE>UTF-8</CODE> and this is not settable.
24102 <P>
24103
24104 It is probably best to use UNIX Alpine in a terminal emulator
24105 capable of displaying UTF-8 characters, since that will allow you to
24106 view just about any received text that is correctly formatted (note,
24107 however, the above comments about known index display bugs with certain
24108 character sets). You'll need to have an emulator that uses a UTF-8 font
24109 and you'll need to set up your environment to use a UTF-8 charmap. For
24110 example, on a Linux system you might include
24111 <P>
24112 <CENTER> <CODE>setenv LANG en_US.UTF-8</CODE> </CENTER>
24113 <P>
24114
24115 or something similar in your UNIX startup files.
24116 You'd also have to select a UTF-8 font in your terminal emulator.
24117 <P>
24118
24119 The types of values that the character set variables may be set to are
24120 <CODE>UTF-8</CODE>, <CODE>ISO-8859-1</CODE>, or <CODE>EUC-JP</CODE>.
24121 The <CODE>ISO-2022</CODE> character sets are not supported for input or
24122 for display, but as a special case, <CODE>ISO-2022-JP</CODE> is supported
24123 for use only as a <!--#echo var="VAR_posting-character-set"-->.
24124 In the Setup/Config screen you may choose from a list of all the
24125 character sets Alpine knows about by using the &quot;T&quot; ToCharsets command.
24126 Here is a list of many of the possible character sets:
24127
24128 <P>
24129 <TABLE>
24130 <TR> <TD>UTF-8</TD> <TD>Unicode</TD> </TR>
24131 <TR> <TD>US-ASCII</TD> <TD>7 bit American English characters</TD> </TR>
24132 <TR> <TD>ISO-8859-1</TD> <TD>8 bit European "Latin 1" character set</TD> </TR>
24133 <TR> <TD>ISO-8859-2</TD> <TD>8 bit European "Latin 2" character set</TD> </TR>
24134 <TR> <TD>ISO-8859-3</TD> <TD>8 bit European "Latin 3" character set</TD> </TR>
24135 <TR> <TD>ISO-8859-4</TD> <TD>8 bit European "Latin 4" character set</TD> </TR>
24136 <TR> <TD>ISO-8859-5</TD> <TD>8 bit Latin and Cyrillic</TD> </TR>
24137 <TR> <TD>ISO-8859-6</TD> <TD>8 bit Latin and Arabic</TD> </TR>
24138 <TR> <TD>ISO-8859-7</TD> <TD>8 bit Latin and Greek</TD> </TR>
24139 <TR> <TD>ISO-8859-8</TD> <TD>8 bit Latin and Hebrew</TD> </TR>
24140 <TR> <TD>ISO-8859-9</TD> <TD>8 bit European "Latin 5" character set</TD> </TR>
24141 <TR> <TD>ISO-8859-10</TD> <TD>8 bit European "Latin 6" character set</TD> </TR>
24142 <TR> <TD>ISO-8859-11</TD> <TD>Latin and Thai</TD> </TR>
24143 <TR> <TD>ISO-8859-12</TD> <TD>Reserved</TD> </TR>
24144 <TR> <TD>ISO-8859-13</TD> <TD>8 bit European "Latin 7" character set</TD> </TR>
24145 <TR> <TD>ISO-8859-14</TD> <TD>8 bit European "Latin 8" character set</TD> </TR>
24146 <TR> <TD>ISO-8859-15</TD> <TD>8 bit European "Latin 9" character set</TD> </TR>
24147 <TR> <TD>ISO-8859-16</TD> <TD>8 bit European "Latin 10" character set</TD> </TR>
24148 <TR> <TD>KOI8-R</TD> <TD>8 bit Latin and Russian</TD> </TR>
24149 <TR> <TD>KOI8-U</TD> <TD>8 bit Latin and Ukrainian</TD> </TR>
24150 <TR> <TD>WINDOWS-1251</TD> <TD>8 bit Latin and Russian</TD> </TR>
24151 <TR> <TD>TIS-620</TD> <TD>8 bit Latin and Thai</TD> </TR>
24152 <TR> <TD>VISCII</TD> <TD>8 bit Latin and Vietnamese</TD> </TR>
24153 <TR> <TD>GBK</TD> <TD>Latin and Chinese Simplified</TD> </TR>
24154 <TR> <TD>GB2312</TD> <TD>Latin and Chinese Simplified</TD> </TR>
24155 <TR> <TD>CN-GB</TD> <TD>Latin and Chinese Simplified</TD> </TR>
24156 <TR> <TD>BIG5</TD> <TD>Latin and Chinese Traditional</TD> </TR>
24157 <TR> <TD>BIG-5</TD> <TD>Latin and Chinese Traditional</TD> </TR>
24158 <TR> <TD>EUC-JP</TD> <TD>Latin and Japanese</TD> </TR>
24159 <TR> <TD>SHIFT-JIS</TD> <TD>Latin and Japanese</TD> </TR>
24160 <TR> <TD>EUC-KR</TD> <TD>Latin and Korean</TD> </TR>
24161 <TR> <TD>KSC5601</TD> <TD>Latin and Korean</TD> </TR>
24162 </TABLE>
24163 <P>
24164
24165 When reading incoming email, Alpine understands many different
24166 character sets and is able to convert the incoming mail into Unicode.
24167 The Unicode will be converted to the Display Character Set
24168 for display on your terminal.
24169 Characters typed at the keyboard will be converted from the
24170 Keyboard Character Set to Unicode for Alpine's internal
24171 use.
24172 You may find that you can read some malformed messages that do not
24173 contain a character set label by setting the option
24174 <A HREF="h_config_unk_char_set">&quot;<!--#echo var="VAR_unknown-character-set"-->&quot;</A>.
24175 <P>
24176
24177 The <!--#echo var="VAR_posting-character-set"--> is used when sending messages.
24178 The default behavior obtained by leaving this variable unset is usually
24179 what is wanted. In that default case, Alpine will attempt
24180 to label the message with the most specific character set from the
24181 rather arbitrary set
24182 <P>
24183 US-ASCII, ISO-8859-15,
24184 ISO-8859-1, ISO-8859-2, VISCII, KOI8-R, KOI8-U, ISO-8859-7, ISO-8859-6,
24185 ISO-8859-8, TIS-620, ISO-2022-JP, GB2312, BIG5, EUC-KR, and UTF-8.
24186 <P>
24187
24188 For example, if the message is made up of only US-ASCII characters, it
24189 will be labeled US-ASCII. Otherwise, if it is all ISO-8859-15 characters,
24190 that will be the label. If that doesn't work the same is tried for the
24191 remaining members of the list.
24192
24193 <P>
24194 It might make sense to set <!--#echo var="VAR_posting-character-set"--> to an
24195 explicit value instead.
24196 For example, if you usually send messages in Greek, setting this
24197 option to ISO-8859-7 will result in messages being labeled as
24198 US-ASCII if there are no non-ascii characters, ISO-8859-7 if there
24199 are only Greek characters, or UTF-8 if there are some characters
24200 that aren't representable in ISO-8859-7.
24201 Another possibility is to set this option explicitly to UTF-8.
24202 In that case
24203 Alpine labels only ascii messages as US-ASCII and all other
24204 messages as UTF-8.
24205 <P>
24206
24207 The options
24208 <A HREF="h_config_post_char_set">&quot;<!--#echo var="VAR_posting-character-set"-->&quot;</A>
24209 and <A HREF="h_config_key_char_set">&quot;Keyboard Character Set&quot;</A>
24210 are closely related to this option.
24211 Setting the feature
24212 <A HREF="h_config_use_system_translation">&quot;Use System Translation&quot;</A>
24213 should cause this option to be ignored.
24214
24215 <P>
24216 When displaying a message, Alpine compares this setting to the character
24217 set specified in the message.  If not all of the
24218 characters in the message can be displayed using the Display Character Set
24219 then Alpine places an editorial
24220 comment in the displayed text (enclosed in square-brackets) indicating
24221 that some characters may not be displayed correctly.
24222 This comment may be eliminated by turning on the option
24223 <A HREF="h_config_quell_charset_warning"><!--#echo var="FEAT_quell-charset-warning"--></A>.
24224
24225 <P>
24226 <UL>
24227 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24228 </UL><P>
24229 &lt;End of help on this topic&gt;
24230 </BODY>
24231 </HTML>
24232 ====== h_config_key_char_set =====
24233 <HTML>
24234 <HEAD>
24235 <TITLE>OPTION: Keyboard Character Set</TITLE>
24236 </HEAD>
24237 <BODY>
24238 <H1>OPTION: Keyboard Character Set</H1>
24239
24240 UNIX Alpine only.
24241 <P>
24242 The Keyboard Character Set identifies the character set of the characters
24243 coming from your keyboard.
24244 It defaults to having the same value as your
24245 <A HREF="h_config_char_set">&quot;Display Character Set&quot;</A>,
24246 which in turn defaults to a value obtained from your environment.
24247 It is unlikely that you will need to use this option, because the keyboard
24248 almost always produces the same kind of characters as the display displays.
24249
24250 <P>
24251 This character set is also used when accessing files in your local
24252 file system.
24253 The names of the files are assumed to be in the same character set as
24254 what the keyboard produces, as well as the contents of the files.
24255
24256 <P>
24257 In the Setup/Config screen you may choose from a list of all the
24258 character sets Alpine knows about by using the &quot;T&quot; ToCharsets command.
24259
24260 <P>
24261 The options
24262 <A HREF="h_config_char_set">&quot;Display Character Set&quot;</A>
24263 and <A HREF="h_config_post_char_set">&quot;<!--#echo var="VAR_posting-character-set"-->&quot;</A>
24264 are closely related.
24265 Setting the feature
24266 <A HREF="h_config_use_system_translation">&quot;Use System Translation&quot;</A>
24267 should cause this option to be ignored.
24268
24269 <P>
24270 <UL>
24271 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24272 </UL><P>
24273 &lt;End of help on this topic&gt;
24274 </BODY>
24275 </HTML>
24276 ====== h_config_editor =====
24277 <HTML>
24278 <HEAD>
24279 <TITLE>OPTION: <!--#echo var="VAR_editor"--></TITLE>
24280 </HEAD>
24281 <BODY>
24282 <H1>OPTION: <!--#echo var="VAR_editor"--></H1>
24283
24284 <!--#echo var="VAR_editor"--> specifies the program invoked by ^_ in the Composer. This is
24285 normally an alternative to Alpine's internal composer (Pico).  You could use
24286 this setting to specify an alternate editor to use occasionally or if you
24287 have a favorite editor and want to use it all the time (see the
24288 <A HREF="h_config_alt_ed_now">&quot;<!--#echo var="FEAT_enable-alternate-editor-implicitly"-->&quot;</A> setting).  <P>
24289 If you specify multiple editors for this option, ^_ will invoke the first one
24290 of those specified that exists and is executable.  When specifying a program
24291 for use here, make sure that the format of the text it saves -- which, when
24292 you exit it, will become the message body in Alpine -- is appropriate
24293 for the body of an email message; avoid proprietary formats that may result in
24294 a message body that the recipient of your message will be unable to decipher.
24295 <P>
24296 <!--chtml if pinemode="os_windows"-->
24297 <!--chtml else-->
24298 If you are in doubt about what editors are available on your system, or which
24299 of them may be appropriate for specification here, ask your local computing
24300 support staff.
24301 <!--chtml endif-->
24302 <P>
24303 Note that if <a href="h_config_quell_flowed_text"><!--#echo var="FEAT_quell-flowed-text"--></a> is
24304 unset, outgoing text will be set as flowed.  In most cases this will be fine,
24305 but if the editor has a &quot;flowed text&quot; mode, it would be best to
24306 use that.
24307
24308 <P><UL>
24309 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24310 </UL>
24311 <P>
24312 &lt;End of help on this topic&gt;
24313 </BODY>
24314 </HTML>
24315 ====== h_config_speller =====
24316 <HTML>
24317 <HEAD>
24318 <TITLE>OPTION: <!--#echo var="VAR_speller"--></TITLE>
24319 </HEAD>
24320 <BODY>
24321 <H1>OPTION: <!--#echo var="VAR_speller"--></H1>
24322
24323 UNIX Alpine only.
24324 <P>
24325 For PC-Alpine, you must install the aspell library code that you
24326 may get from
24327 <A HREF="http://aspell.net/win32/">http://aspell.net/win32/</A>.
24328 <P>
24329 This option affects the behavior of the ^T (spell check) command in the
24330 Composer.  It specifies the program invoked by ^T in the Composer.
24331 By default, Alpine uses
24332 <P>
24333 <CENTER><SAMP>aspell --dont-backup --mode=email check</SAMP></CENTER>
24334 <P>
24335 if it knows where to find &quot;aspell&quot;.
24336 If there is no &quot;aspell&quot; command available but the command &quot;ispell&quot; is available
24337 then the command used is
24338 <P>
24339 <CENTER><SAMP>ispell -l</SAMP></CENTER>
24340 <P>
24341 Otherwise, the ancient &quot;spell&quot; command is used.
24342 <P>
24343 If you specify a value for this command (with full pathname) then that is what
24344 will be used instead of any of the defaults.
24345 When invoking this
24346 spell-checking program, Alpine appends a tempfile name (where the message is
24347 passed) to the command line. Alpine expects the speller to correct the
24348 spelling in that file. When you exit from that program Alpine will read the
24349 tempfile back into the composer.
24350 <P>
24351 Don't set this speller option to the standard Unix spell command.
24352 That won't work because spell works in a different way.
24353
24354 <P>
24355 <UL>
24356 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24357 </UL><P>
24358 &lt;End of help on this topic&gt;
24359 </BODY>
24360 </HTML>
24361 ====== h_config_aspell_dictionary =====
24362 <HTML>
24363 <HEAD>
24364 <TITLE>OPTION: <!--#echo var="VAR_aspell-dictionary-list"--></TITLE>
24365 </HEAD>
24366 <BODY>
24367 <H1>OPTION: <!--#echo var="VAR_aspell-dictionary-list"--></H1>
24368
24369 PC Alpine only.
24370 <P>
24371 This option specifies a list of dictionaries you will use with
24372 aspell. A sample entry is &quot;en_US&quot; for american english, or
24373 &quot;en_GB&quot; for british english.
24374
24375 <P>
24376 <UL>
24377 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24378 </UL><P>
24379 &lt;End of help on this topic&gt;
24380 </BODY>
24381 </HTML>
24382 ====== h_config_display_filters =====
24383 <HTML>
24384 <HEAD>
24385 <TITLE>OPTION: <!--#echo var="VAR_display-filters"--></TITLE>
24386 </HEAD>
24387 <BODY>
24388 <H1>OPTION: <!--#echo var="VAR_display-filters"--></H1>
24389
24390 This option defines a list of text-filtering commands (programs or
24391 scripts) that may be used to filter text portions of received messages
24392 prior to their use (e.g., presentation in the &quot;MESSAGE TEXT&quot;
24393 display screen, exporting to a text file).
24394 For security reasons, the full path name of the
24395 filter command must be specified.
24396
24397 <P>
24398 The command is executed and the message is piped into its standard input.
24399 The standard output of the command is read back by Alpine.  The
24400 &quot;_TMPFILE_&quot; token (see below) overrides this default behavior.
24401
24402 <P>
24403 The filter's use is based on the configured &quot;trigger&quot; string.  The
24404 format of a filter definition is:
24405
24406 <P>
24407 <CENTER>&lt;trigger&gt; &lt;command&gt; &lt;arguments&gt;</CENTER>
24408
24409 <P>
24410 You can specify as many filters as you wish, separating them with a comma.
24411 Each filter can have only one trigger and command.  Thus, two trigger
24412 strings that invoke the same command require separate filter
24413 specifications.
24414
24415 <P>
24416 The &quot;trigger&quot; is simply text that, if found in the message,
24417 will invoke the associated command.  If the trigger contains any space
24418 characters, it must be placed within quotes.  Likewise, should you
24419 wish a filter to be invoked unconditionally, define the trigger as the
24420 null string, &quot;&quot; (two consecutive double-quote characters).  If the
24421 trigger string is found anywhere in the text of the message the filter
24422 is invoked.  Placing the trigger text within the tokens defined below
24423 changes where within the text the trigger must be before considering
24424 it a match.
24425
24426 <P>
24427 Trigger Modifying Tokens:
24428 <DL>
24429 <DT>_CHARSET(<VAR>string</VAR>)_</DT>
24430 <DD>This token tells Alpine to invoke the supplied command
24431 if the text is in a character set matching <VAR>string</VAR>
24432 (e.g., ISO-8859-2 or ISO-2022-JP).
24433 </DD>
24434
24435
24436 <DT>_LEADING(<VAR>string</VAR>)_</DT>
24437 <DD>This token tells Alpine to invoke the supplied command
24438 if the enclosed <VAR>string</VAR> is found to be the first
24439 non-whitespace text.
24440 <BR>NOTE: Quotes are necessary if <VAR>string</VAR> contains
24441 the space character.
24442 </DD>
24443
24444 <DT>_BEGINNING(<VAR>string</VAR>)_</DT>
24445 <DD>This token tells Alpine to invoke the supplied command
24446 if the enclosed <VAR>string</VAR> is found at the beginning
24447 of any line in the text.
24448 <BR>NOTE: Quotes are necessary if <VAR>string</VAR> contains
24449 the space character.
24450 </DD>
24451 </DL>
24452
24453 <P>
24454 The &quot;command&quot; and &quot;arguments&quot; portion is simply
24455 the command line to be invoked if the trigger string is found.  Below
24456 are tokens that Alpine will recognize and replace with special values
24457 when the command is actually invoked.
24458
24459 <P>
24460 Command Modifying Tokens:
24461
24462 <DL>
24463 <DT>_TMPFILE_</DT>
24464 <DD>When the command is executed, this token is
24465 replaced with the path and name of the temporary
24466 file containing the text to be filtered.  Alpine
24467 expects the filter to replace this data with the
24468 filter's result.
24469
24470 <P>
24471 NOTE: Use of this token implies that the text to
24472 be filtered is not piped into standard input of the
24473 executed command and its standard output is ignored.
24474 Alpine restores the tty modes before invoking the
24475 filter in case the filter interacts with the user
24476 via its own standard input and output.
24477 </DD>
24478
24479 <DT>_RESULTFILE_</DT>
24480 <DD>When the command is executed, this token is
24481 replaced with the path and name of a temporary
24482 file intended to contain a status message from the
24483 filter.  Alpine displays this in the message status
24484 field.
24485 </DD>
24486
24487 <DT>_DATAFILE_</DT>
24488 <DD>When the command is executed, this token is
24489 replaced with the path and name of a temporary
24490 file that Alpine creates once per session and deletes
24491 upon exit.  The file is intended to be used by the
24492 filter to store state information between instances
24493 of the filter.
24494 </DD>
24495
24496 <DT>_PREPENDKEY_</DT>
24497 <DD>When the command is executed, this token indicates that a random
24498 number will be passed down the input stream before the message text.
24499 This number could be used as a session key.  It is sent in this way to
24500 improve security.  The number is unique to the current Alpine session
24501 and is only generated once per session.
24502 </DD>
24503
24504 <DT>_SILENT_</DT>
24505 <DD>When the filter is executed, this token tells Alpine not to repaint
24506 the screen while the command is being executed. This can be used with
24507 filters that do not interact with the user, and therefore repainting
24508 the screen is not necessary.
24509 </DD>
24510 </DL>
24511
24512 <P>
24513 The feature
24514 <A HREF="h_config_disable_reset_disp"><!--#echo var="FEAT_disable-terminal-reset-for-display-filters"--></A> is related.
24515 <P>
24516 Performance caveat/considerations:
24517 <BR>
24518 Testing for the trigger and invoking the filter doesn't come for free.
24519 There is overhead associated with searching for the trigger string, testing
24520 for the filter's existence and actually piping the text through the filter.
24521 The impact can be reduced if the Trigger Modifying Tokens above are
24522 employed.
24523 <P>
24524 &lt;End of help on this topic&gt;
24525 </BODY>
24526 </HTML>
24527 ====== h_config_sending_filter =====
24528 <HTML>
24529 <HEAD>
24530 <TITLE>OPTION: <!--#echo var="VAR_sending-filters"--></TITLE>
24531 </HEAD>
24532 <BODY>
24533 <H1>OPTION: <!--#echo var="VAR_sending-filters"--></H1>
24534
24535 This option defines a list of text-filtering commands (programs and
24536 scripts) that may be selectively invoked to process a message just before
24537 it is sent.  If set, the Composer's ^X (Send) command will allow you to
24538 select which filter (or none) to apply to the message before it is sent.
24539 For security reasons, the full path of the filter program must be
24540 specified.
24541
24542 <P>
24543 Command Modifying Tokens:
24544
24545 <DL>
24546 <DT>_RECIPIENTS_</DT>
24547 <DD>When the command is executed, this token is replaced
24548 with the space delimited list of recipients of the
24549 message being sent.
24550 </DD>
24551
24552 <DT>_TMPFILE_</DT>
24553 <DD>
24554 When the command is executed, this token is
24555 replaced with the path and name of the temporary
24556 file containing the text to be filtered.  Alpine
24557 expects the filter to replace this data with the
24558 filter's result.
24559
24560 <P>
24561 NOTE: Use of this token implies that the text to
24562 be filtered is not piped into standard input of the
24563 executed command and its standard output is ignored.
24564 Alpine restores the tty modes before invoking the
24565 filter in case the filter interacts with the user
24566 via its own standard input and output.
24567 </DD>
24568
24569 <DT>_RESULTFILE_</DT>
24570 <DD>When the command is executed, this token is
24571 replaced with the path and name of a temporary
24572 file intended to contain a status message from the
24573 filter.  Alpine displays this in the message status
24574 field.
24575 </DD>
24576
24577 <DT>_DATAFILE_</DT>
24578 <DD>When the command is executed, this token is replaced
24579 in the command line with the path and name of a
24580 temporary file that Alpine creates once per session
24581 and deletes upon exit.  The file is intended to be
24582 used by the filter to store state information between
24583 instances of the filter.
24584 </DD>
24585
24586 <DT>_PREPENDKEY_</DT>
24587 <DD>When the command is executed, this token indicates
24588 that a random number will be passed down the input
24589 stream before the message text.  This number could
24590 be used as a session key.  It is sent in this way
24591 to improve security.  The number is unique to the
24592 current Alpine session and is only generated once per
24593 session.
24594 </DD>
24595
24596 <DT>_INCLUDEALLHDRS_</DT>
24597 <DD>When the command is executed, this token indicates
24598 that the headers of the message will be passed down the input stream
24599 before the message text.
24600 </DD>
24601
24602 <DT>_MIMETYPE_</DT>
24603 <DD>When the command is executed, this token is replaced in the
24604 command name with a temporary file name used to accept any new MIME
24605 Content-Type information necessitated by the output of the filter.
24606 Upon the filter's exit, if the file contains new MIME type
24607 information, Alpine verifies its format and replaces the outgoing
24608 message's MIME type information with that contained in the file. This
24609 is basically a cheap way of sending something other than Text/Plain.
24610 </DD>
24611 </DL>
24612
24613 <P>
24614 NOTE: Only the body text, which is visible in the Composer, is piped
24615 through this filter.  Attachments are not sent to the filter.
24616 <P>
24617 Sending filters are not used if the feature
24618 <A HREF="h_config_send_wo_confirm">&quot;<!--#echo var="FEAT_send-without-confirm"-->&quot;</A> is set.
24619 <P>
24620 <UL>
24621 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24622 </UL><P>
24623 &lt;End of help on this topic&gt;
24624 </BODY>
24625 </HTML>
24626 ====== h_config_keywords =====
24627 <HTML>
24628 <HEAD>
24629 <TITLE>OPTION: <!--#echo var="VAR_keywords"--></TITLE>
24630 </HEAD>
24631 <BODY>
24632 <H1>OPTION: <!--#echo var="VAR_keywords"--></H1>
24633
24634 You may define your own set of keywords and optionally set them on a
24635 message by message basis.
24636 These are similar to the &quot;Important&quot; flag which the user
24637 may set using the Flag command.
24638 The difference is that the Important flag is always present for each folder.
24639 User-defined keywords are chosen by the user.
24640 You may set up the list of possible keywords here, or you may add keywords
24641 from the Flag Details screen that you
24642 can get to after typing the
24643 Flag (<!--chtml if pinemode="function_key"-->F11<!--chtml else-->*<!--chtml endif-->)
24644 command.
24645 After the keywords have been defined,
24646 then you use the <A HREF="h_common_flag">Flag command</A>
24647 to set or clear the keywords in each message.
24648 The behavior of the flag command may be modified by using the
24649 <A HREF="h_config_flag_screen_default">&quot;<!--#echo var="FEAT_enable-flag-screen-implicitly"-->&quot;</A> option or the
24650 <A HREF="h_config_flag_screen_kw_shortcut">&quot;<!--#echo var="FEAT_enable-flag-screen-keyword-shortcut"-->&quot;</A> option.
24651
24652 <P>
24653 Keywords may be used when Selecting messages (Select Keyword).
24654 Keywords may also be used in the Patterns of Rules (Filters, Indexcolors, etc).
24655 Filter Rules may be used to set keywords automatically.
24656 Keywords may be displayed as part of the Subject of a message by using
24657 the SUBJKEY or SUBJKEYINIT tokens in the
24658 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option.
24659 The <A HREF="h_config_kw_braces"><!--#echo var="VAR_keyword-surrounding-chars"--></A>
24660 option may be used to modify the display of keywords using
24661 SUBJKEY and SUBJKEYINIT slightly.
24662 Keywords may also be displayed in a column of their own in the MESSAGE INDEX
24663 screen by using the KEY or KEYINIT tokens.
24664 It is also possible to color keywords in the index using the
24665 Setup/Kolor screen (<A HREF="h_config_kw_color">Keyword Colors</A>).
24666 Keywords are not supported by all mail servers.
24667
24668 <P>
24669 You may give keywords nicknames if you wish.
24670 If the keyword definition you type in contains a SPACE character, then the
24671 actual value of the keyword is everything after the last SPACE and the
24672 nickname for that keyword is everything before the last SPACE.
24673 For example, suppose you are trying to interoperate with another email program
24674 that uses a particular keyword with an unpleasant name.
24675 Maybe it uses a keyword called
24676 <P>
24677 <CENTER><SAMP>VendorName.SoftwareName.08</SAMP></CENTER>
24678 <P>
24679 but for you that keyword means that the message is work-related.
24680 You could define a keyword to have the value
24681 <P>
24682 <CENTER><SAMP>Work VendorName.SoftwareName.08</SAMP></CENTER>
24683 <P>
24684 and then you would use the name &quot;Work&quot; when dealing with
24685 that keyword in Alpine.
24686 If you defined it as
24687 <P>
24688 <CENTER><SAMP>My Work VendorName.SoftwareName.08</SAMP></CENTER>
24689 <P>
24690 the nickname would be everything before the last SPACE, that is the nickname
24691 would be &quot;My Work&quot;.
24692 <P>
24693 Some commonly used keywords begin with dollar signs.
24694 This presents a slight complication, because the dollar sign is normally used
24695 to signify
24696 <A HREF="h_news_config">environment variable expansion</A>
24697 in the Alpine configuration.
24698 In order to specify a keyword that begins with a dollar sign you must
24699 precede the dollar sign with a second dollar sign to escape its special
24700 meaning.
24701 For example, if you want to include the keyword
24702 <P>
24703 <CENTER><SAMP>$Label1</SAMP></CENTER>
24704 <P>
24705 as one of your possible keywords, you must enter the text
24706 <P>
24707 <CENTER><SAMP>$$Label1</SAMP></CENTER>
24708 <P>
24709
24710 instead.
24711 <P>
24712 There are a couple limitations.
24713 First, not all servers support keywords.
24714 Second, some servers (including the IMAP server included with Alpine)
24715 have a per folder limit on the number of keywords that may be defined.
24716 This count commonly includes every keyword you have ever used in the
24717 folder, even if it is no longer being used.
24718 In other words, you can add keywords but you cannot remove them easily.
24719 If you have changed keywords over the life of a folder and find that
24720 you have reached such a limit, one possible solution might be to copy
24721 all of the messages to a newly created folder (using Alpine) and then
24722 delete the original and rename the new folder.
24723 The reason this might work is that only the keywords currently set in
24724 any of the messages will be used in the new folder, hopefully putting you
24725 under the limit.
24726
24727 <P>
24728 <UL>
24729 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24730 </UL><P>
24731 &lt;End of help on this topic&gt;
24732 </BODY>
24733 </HTML>
24734 ====== h_config_alt_addresses =====
24735 <HTML>
24736 <HEAD>
24737 <TITLE>OPTION: <!--#echo var="VAR_alt-addresses"--></TITLE>
24738 </HEAD>
24739 <BODY>
24740 <H1>OPTION: <!--#echo var="VAR_alt-addresses"--></H1>
24741
24742 This option provides a place for you to list alternate email addresses
24743 you may have.
24744 Each address in the list should be the actual email address part of an
24745 address, without the full name field or the angle brackets.
24746 For example:
24747
24748 <P>
24749 <CENTER><SAMP>user@example.com</SAMP></CENTER>
24750 <P>
24751
24752 The matching is case-insensitive, so this would match any of
24753 <SAMP>User@example.com</SAMP>, <SAMP>user@Example.Com</SAMP>, or
24754 <SAMP>USER@EXAMPLE.COM</SAMP> as well.
24755
24756 <P>
24757 If set, the option affects the behavior of the Reply
24758 command and the &quot;+&quot; symbol in the MESSAGE INDEX, which denotes that
24759 a message has been addressed specifically to you.
24760
24761 <P>
24762 In the default INDEX display
24763 the personal name (or email address) of
24764 the person listed in the message's &quot;From:&quot; header
24765 field is usually displayed except when that address is yours or one of your
24766 alternate addresses.
24767 In that case you will usually see the name of
24768 the first person specified in the
24769 message's &quot;To:&quot; header field
24770 with the prefix &quot;To: &quot; prepended.
24771
24772 <P>
24773 With respect to Reply, the reply-to-all option will exclude addresses
24774 listed here.
24775
24776 <P>
24777 The feature
24778 <A HREF="h_config_copy_to_to_from"><!--#echo var="FEAT_copy-to-address-to-from-if-it-is-us"--></A>
24779 is somewhat related to this option.
24780
24781 <P>
24782 In addition to a list of actual addresses,
24783 you may use regular expressions (as used with egrep with the ignore case flag)
24784 to describe the addresses you want to match.
24785 Alpine will somewhat arbitrarily interpret your entry as a regular
24786 expression if it contains any of the characters
24787 *, |, +, ?, {, [, ^, $, or &#92;.
24788 Otherwise, it will be treated literally.
24789 The feature
24790 <a href="h_config_disable_regex"><!--#echo var="FEAT_disable-regular-expression-matching-for-alternate-addresses"--></a>
24791 may be used to turn off regular expression processing regardless of whether or not
24792 special characters appear in the entry.
24793
24794 <P>
24795 A description of how regular expressions work is beyond the
24796 scope of this help text, but some examples follow.
24797
24798 <P>
24799 The entry
24800
24801 <P>
24802 <CENTER><SAMP>.*@example.com</SAMP></CENTER>
24803 <P>
24804
24805 in the <!--#echo var="VAR_alt-addresses"--> list would mean that any
24806 address with a domain name of <SAMP>example.com</SAMP> (such as
24807 <SAMP>fred@example.com</SAMP> or <SAMP>wilma@example.com</SAMP>) will be considered
24808 one of your alternate addresses.
24809 Strictly speaking, the dot in <SAMP>example.com</SAMP> ought to be escaped with
24810 a backslash, as in <SAMP>example&#92;.com</SAMP>, and a dollar sign anchor ought
24811 to come at the end of the expression to prevent a match of <SAMP>example.com.org</SAMP>.
24812 Complicating things further, the dollar sign
24813 is special in the Alpine configuration (it signifies environment variable expansion)
24814 so the dollar sign should be doubled or backslash escaped for Alpine's sake.
24815 Quotes around the whole expression will not escape the dollar sign successfully.
24816 So this example should look like
24817
24818 <P>
24819 <CENTER><SAMP>.*@example&#92;.com$$</SAMP></CENTER>
24820 <P>
24821
24822 <P>
24823 The entry
24824
24825 <P>
24826 <CENTER><SAMP>^fred[0-9]*@example.com$$</SAMP></CENTER>
24827 <P>
24828
24829 would match
24830 <SAMP>fred3@example.com</SAMP> or <SAMP>fred17@example.com</SAMP> as well
24831 as <SAMP>fred@example.com</SAMP>.
24832
24833 <P>
24834 You could match all addresses that look like
24835 <SAMP>fred+stuff@example.com</SAMP> for any value of <SAMP>stuff</SAMP> with the
24836 entry
24837
24838 <P>
24839 <CENTER><SAMP>^fred&#92;+.*@example.com$$</SAMP></CENTER>
24840 <P>
24841
24842 Notice that you have to escape the plus sign with a backslash because plus
24843 is a special character in regular expressions.
24844 If you wanted to match plain <SAMP>fred</SAMP> as well as <SAMP>fred+stuff</SAMP>
24845 the expression
24846
24847 <P>
24848 <CENTER><SAMP>^fred(()|&#92;+.*)@example.com$$</SAMP></CENTER>
24849 <P>
24850
24851 would do it, but it would be easier to just add fred@example.com as a
24852 separate entry.
24853
24854 <P>
24855 One more example, a match of all first-level subdomains, is given by
24856
24857 <P>
24858 <CENTER><SAMP>^fred@[[:alnum:]_-]*&#92;.example&#92;.com$$</SAMP></CENTER>
24859 <P>
24860
24861 <P>
24862 Because the regular expression matching is based on an old library
24863 (<SAMP>hs_regex</SAMP>) the regular expressions might not work exactly as you expect,
24864 but they should be close.
24865
24866 <P>
24867 <UL>
24868 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24869 </UL><P>
24870 &lt;End of help on this topic&gt;
24871 </BODY>
24872 </HTML>
24873 ====== h_config_abook_formats =====
24874 <HTML>
24875 <HEAD>
24876 <TITLE>OPTION: <!--#echo var="VAR_addressbook-formats"--></TITLE>
24877 </HEAD>
24878 <BODY>
24879 <H1>OPTION: <!--#echo var="VAR_addressbook-formats"--></H1>
24880
24881 This option specifies the format that address books are displayed in.
24882 Normally, address books are displayed with the nicknames in the first
24883 column, the fullnames in the second column, and addresses in the third
24884 column.  The system figures out reasonable defaults for the widths of
24885 the columns.  An address book may be given a different format by
24886 listing special tokens in the order you want them to display.  The
24887 possible tokens are NICKNAME, FULLNAME, ADDRESS, FCC, and COMMENT.
24888 So, for example, to get the default behavior you could list
24889
24890 <P>
24891 <CENTER><!--#echo var="VAR_addressbook-formats"-->=NICKNAME FULLNAME ADDRESS</CENTER>
24892
24893 <P>
24894 (You can also use the token DEFAULT to get the default behavior for
24895 an address book format.)
24896
24897 <P>
24898 The tokens are separated by spaces.  &quot;<!--#echo var="VAR_addressbook-formats"-->&quot;
24899 is a list, so if you have more than one address book you may have a
24900 separate format for each by putting its format at the corresponding
24901 location in the &quot;<!--#echo var="VAR_addressbook-formats"-->&quot; list.
24902
24903 <P>
24904
24905 Listed first are the personal address books, then the global address
24906 books.  So, if you have two personal address books and one global
24907 address book, you may have up to three formats in the
24908 &quot;<!--#echo var="VAR_addressbook-formats"-->&quot; list.  If
24909 &quot;<!--#echo var="VAR_addressbook-formats"-->&quot; doesn't have as many elements as there
24910 are address books, the last element is used repeatedly.
24911
24912 <P>
24913
24914 Each of the tokens may also be optionally followed by parentheses with
24915 either a number or a percentage inside the parentheses.  For example,
24916 <SAMP>FULLNAME(13)</SAMP> means to allocate 13 characters of space to
24917 the fullnames column, <SAMP>FULLNAME(20%)</SAMP> means to allocate 20%
24918 of the available space (the screen width minus the space for
24919 inter-column spaces) to the fullnames column, while plain
24920 <SAMP>FULLNAME</SAMP> means the system will attempt to figure out a
24921 reasonable number of columns.
24922
24923 <P>
24924 There are always 2 spaces between every column, so if you use
24925 fixed column widths (like 13) you should remember to take that into
24926 account.
24927
24928 <P>
24929 <UL>
24930 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24931 </UL><P>
24932 &lt;End of help on this topic&gt;
24933 </BODY>
24934 </HTML>
24935 ====== h_config_set_index_format =====
24936 <HTML>
24937 <HEAD>
24938 <TITLE>Set Index Format</TITLE>
24939 </HEAD>
24940 <BODY>
24941 <H1>Set Index Format</H1>
24942
24943 This option is used to customize the content of lines in the
24944 <A HREF="h_mail_index">MESSAGE INDEX screen</A>.
24945 This action works exactly like the regular
24946 &quot;<!--#echo var="VAR_index-format"-->&quot; option in the Setup/Config screen,
24947 except that you can have a folder-specific value for it if you specify it here.
24948 Consult the help for
24949 &quot;<A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A>&quot;
24950 for more information.
24951
24952 <P>
24953 <UL>
24954 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
24955 </UL><P>
24956 &lt;End of help on this topic&gt;
24957 </BODY>
24958 </HTML>
24959 ====== h_config_index_format =====
24960 <HTML>
24961 <HEAD>
24962 <TITLE>OPTION: <!--#echo var="VAR_index-format"--></TITLE>
24963 </HEAD>
24964 <BODY>
24965 <H1>OPTION: <!--#echo var="VAR_index-format"--></H1>
24966
24967 This option is used to customize the content of lines in the
24968 <A HREF="h_mail_index">MESSAGE INDEX screen</A>.  Each line is intended
24969 to convey some amount of immediately relevant information about each
24970 message in the current folder.
24971 <P>
24972
24973 Alpine provides a pre-defined set of informational fields with
24974 reasonable column widths automatically computed.  You can, however,
24975 replace this default set by listing special tokens in the order you
24976 want them displayed.
24977 <P>
24978
24979 The list of available tokens is
24980 <A HREF="h_index_tokens">here</A>.
24981 <P>
24982
24983 Spaces are used to separate listed tokens.  Additionally, you can
24984 specify how much of the screen's width the token's associated data
24985 should occupy on the index line by appending to the token a pair of
24986 parentheses enclosing either a number or percentage.  For example,
24987 &quot;SUBJECT(13)&quot; means to allocate 13 characters of space to the subject
24988 column, and &quot;SUBJECT(20%)&quot; means to
24989 allocate 20% of the available space
24990 to the subjects column, while plain &quot;SUBJECT&quot; means the system will
24991 attempt to figure out a reasonable amount of space.
24992 <P>
24993
24994 There is always one space between every pair of columns, so if you use fixed
24995 column widths (like 13) you should remember to take that into account.
24996 Several of the fields are virtually fixed-width, so it doesn't make
24997 much sense to specify the width for them.  The fields STATUS,
24998 FULLSTATUS, IMAPSTATUS, MSGNO, the DATE fields, SIZE,
24999 and DESCRIPSIZE all fall into that category.
25000 You <EM>may</EM> specify widths for those if you wish, but
25001 you're probably better off letting the system pick those widths.  <P>
25002
25003 <P>
25004 The default is equivalent to:
25005
25006 <P>
25007 <CENTER><SAMP>STATUS MSGNO SMARTDATETIME24 FROMORTO(33%) SIZENARROW SUBJKEY(67%)</SAMP></CENTER>
25008
25009 <P>
25010 This means that the four fields without percentages will be allocated
25011 first, and then 33% and 67% of the <EM>remaining</EM> space will go to
25012 the from and subject fields.  If one of those two fields is specified
25013 as a percentage and the other is left for the system to choose, then
25014 the percentage is taken as an absolute percentage of the screen, not
25015 of the space remaining after allocating the first four columns.  It
25016 doesn't usually make sense to do it that way.  If you leave off all
25017 the widths, then the subject and from fields (if both are present) are
25018 allocated space in a 2 to 1 ratio, which is almost exactly the same as
25019 the default.
25020
25021 <P>
25022 What you are most likely to do with this configuration option is to
25023 specify which fields appear at all, which order they appear in, and the
25024 percentage of screen that is used for the from and subject fields if you
25025 don't like the 2 to 1 default.
25026
25027 <P>
25028 If you want to retain the default format that Pine 4.64 had, use
25029
25030 <P>
25031 <CENTER><SAMP><!--#echo var="VAR_index-format"-->=STATUS MSGNO DATE FROMORTO(33%) SIZE SUBJKEY(67%)</SAMP></CENTER>
25032 <P>
25033 <EM>and</EM> set the feature
25034 <A HREF="h_config_disable_index_locale_dates"><!--#echo var="FEAT_disable-index-locale-dates"--></A>.
25035 <UL>
25036 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25037 </UL><P>
25038 &lt;End of help on this topic&gt;
25039 </BODY>
25040 </HTML>
25041 ====== h_config_reply_intro =====
25042 <HTML>
25043 <HEAD>
25044 <TITLE>OPTION: <!--#echo var="VAR_reply-leadin"--></TITLE>
25045 </HEAD>
25046 <BODY>
25047 <H1>OPTION: <!--#echo var="VAR_reply-leadin"--></H1>
25048
25049 This option is used to customize the content of the introduction line
25050 that is included when replying to a message and including the original
25051 message in the reply.
25052 The normal default (what you will get if you delete this variable) looks
25053 something like:
25054 <P>
25055 <CENTER><SAMP>On Sat, 24 Oct 1998, Fred Flintstone wrote:</SAMP></CENTER>
25056 <P>
25057 where the day of the week is only included if it is available in the
25058 original message.
25059 You can replace this default with text of your own.
25060 The text may contain tokens that are replaced with text
25061 that depends on the message you are replying to.
25062 For example, the default is equivalent to:
25063 <P>
25064 <CENTER><SAMP>On _DAYDATE_, _FROM_ wrote:</SAMP></CENTER>
25065 <P>
25066
25067 Since this variable includes regular text mixed with special tokens
25068 the tokens have to be surrounded by underscore characters.
25069 For example, to use the token &quot;<SAMP>PREFDATE</SAMP>&quot;
25070 you would need to use &quot;<SAMP>_PREFDATE_</SAMP>&quot;,
25071 not &quot;<SAMP>PREFDATE</SAMP>&quot;.
25072 <P>
25073 The list of available tokens is
25074 <A HREF="h_index_tokens">here</A>.
25075
25076 <P>
25077 By default, the text is all on a single line and is followed by a blank line.
25078 If your &quot;<!--#echo var="VAR_reply-leadin"-->&quot; turns out to be longer
25079 than 80 characters when replying to a particular message, it is shortened.
25080 However, if you use the token
25081 <P>
25082 <CENTER><SAMP>_NEWLINE_</SAMP></CENTER>
25083 <P>
25084
25085 anywhere in the value, no end of line or blank line is appended, and no
25086 shortening is done.
25087 The _NEWLINE_ token may be used to get rid of the blank line following
25088 the text, to add more blank lines, or to form a multi-line
25089 &quot;<!--#echo var="VAR_reply-leadin"-->&quot;.
25090 To clarify how _NEWLINE_ works recall that the default value is:
25091 <P>
25092 <CENTER><SAMP>On _DAYDATE_, _FROM_ wrote:</SAMP></CENTER>
25093 <P>
25094
25095 That is equivalent to
25096 <P>
25097 <CENTER><SAMP>On _DAYDATE_, _FROM_ wrote:_NEWLINE__NEWLINE_</SAMP></CENTER>
25098 <P>
25099
25100 In the former case, two newlines are added automatically because
25101 no _NEWLINE_ token appears in the value of the option (for backwards
25102 compatibility). In the latter case, the newlines are explicit.
25103 If you want to remove the blank line that follows the
25104 &quot;<!--#echo var="VAR_reply-leadin"-->&quot; text use a single
25105 _NEWLINE_ token like
25106 <P>
25107 <CENTER><SAMP>On _DAYDATE_, _FROM_ wrote:_NEWLINE_</SAMP></CENTER>
25108 <P>
25109
25110 Because of the backwards compatibility problem, it is not possible to
25111 remove all of the ends of lines, because then there will be no _NEWLINE_ tokens
25112 and that will cause the automatic adding of two newlines!
25113 If you want, you may embed newlines in the middle of the text, as well,
25114 producing a multi-line &quot;<!--#echo var="VAR_reply-leadin"-->&quot;.
25115
25116 <P>
25117 By default, no attempt is made to localize the date.
25118 If you prefer a localized form you may find that one of the tokens
25119 _PREFDATE_ or _PREFDATETIME_ is a satisfactory substitute.
25120 If you want more control one of the many other date tokens, such as _DATEISO_,
25121 might be better.
25122
25123 <P>
25124 For the adventurous, there is a way to conditionally include text based
25125 on whether or not a token would result in specific replacement text.
25126 For example, you could include some text based on whether or not
25127 the _NEWS_ token would result in any newsgroups if it was used.
25128 It's explained in detail
25129 <A HREF="h_reply_token_conditionals">here</A>.
25130
25131 <P>
25132 In the very unlikely event that you want to include a literal token
25133 in the introduction line you must precede it with a backslash character.
25134 For example,
25135 <P>
25136 <CENTER><SAMP>&#92;_DAYDATE_ = _DAYDATE_</SAMP></CENTER>
25137 <P>
25138 would produce something like
25139 <P>
25140 <CENTER><SAMP>_DAYDATE_ = Sat, 24 Oct 1998</SAMP></CENTER>
25141 <P>
25142 It is not possible to have a literal backslash followed by an expanded token.
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_remote_abook_history =====
25151 <HTML>
25152 <HEAD>
25153 <TITLE>OPTION: <!--#echo var="VAR_remote-abook-history"--></TITLE>
25154 </HEAD>
25155 <BODY>
25156 <H1>OPTION: <!--#echo var="VAR_remote-abook-history"--></H1>
25157
25158 Sets how many extra copies of
25159 remote address book
25160 data will be kept in each remote address book folder.
25161 The default is three.
25162 These extra copies are simply old versions of the data. Each time a change
25163 is made a new copy of the address book data is appended to the folder. Old
25164 copies are trimmed, if possible, when Alpine exits.
25165 An old copy can be put back into use by
25166 deleting and expunging newer versions of the data from the folder.
25167 Don't delete the first message from the folder. It is a special header
25168 message for the remote address book and it must be there.
25169 This is to prevent regular folders from being used as remote address book
25170 folders and having their data destroyed.
25171 <P>
25172 This option is also used to determine how many extra copies of remote
25173 Alpine configuration files are kept.
25174 <P>
25175 <UL>
25176 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25177 </UL><P>
25178 &lt;End of help on this topic&gt;
25179 </BODY>
25180 </HTML>
25181 ====== h_config_remote_abook_validity =====
25182 <HTML>
25183 <HEAD>
25184 <TITLE>OPTION: <!--#echo var="VAR_remote-abook-validity"--></TITLE>
25185 </HEAD>
25186 <BODY>
25187 <H1>OPTION: <!--#echo var="VAR_remote-abook-validity"--></H1>
25188
25189 Sets the minimum number of minutes that a
25190 remote address book will be considered up to date.
25191 Whenever an entry contained in a remote address book is used,
25192 if more than this many minutes have
25193 passed since the last check the remote server will be queried to see if the
25194 address book has changed.
25195 If it has changed, the local copy is updated.
25196 The default value is five minutes.
25197 The special value of -1 means never check.
25198 The special value of zero means only check when the address book is first
25199 opened.
25200 <P>
25201 No matter what the value, the validity check is always done when the
25202 address book is about to be changed by the user.
25203 The check can be initiated manually by typing <EM>^L</EM> (Ctrl-L)
25204 while in the address book maintenance screen for the remote address book.
25205 <P>
25206 <UL>
25207 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25208 </UL><P>
25209 &lt;End of help on this topic&gt;
25210 </BODY>
25211 </HTML>
25212 ====== h_config_user_input_timeo =====
25213 <HTML>
25214 <HEAD>
25215 <TITLE>OPTION: <!--#echo var="VAR_user-input-timeout"--></TITLE>
25216 </HEAD>
25217 <BODY>
25218 <H1>OPTION: <!--#echo var="VAR_user-input-timeout"--></H1>
25219
25220 If this is set to an integer greater than zero, then this is the number
25221 of <EM>hours</EM> to wait for user input before Alpine times out.
25222 If Alpine is
25223 in the midst of composing a message or is waiting for user response to
25224 a question, then it will not timeout.
25225 However, if Alpine is sitting idle waiting for
25226 the user to tell it what to do next and the user does not give any
25227 input for this many hours, Alpine will exit.
25228 No expunging or moving of read
25229 messages will take place.
25230 It will exit similarly to the way it would exit
25231 if it received a hangup signal.
25232 This may be useful for cleaning up unused Alpine sessions that have been
25233 forgotten by their owners.
25234 The Alpine developers envision system administrators
25235 setting this to a value of several hours (24?) so that it won't surprise
25236 a user who didn't want to be disconnected.
25237 <P>
25238 <UL>
25239 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25240 </UL><P>
25241 &lt;End of help on this topic&gt;
25242 </BODY>
25243 </HTML>
25244 ====== h_config_ssh_open_timeo =====
25245 <HTML>
25246 <HEAD>
25247 <TITLE>OPTION: <!--#echo var="VAR_ssh-open-timeout"--></TITLE>
25248 </HEAD>
25249 <BODY>
25250 <H1>OPTION: <!--#echo var="VAR_ssh-open-timeout"--></H1>
25251
25252 Sets the time in seconds that Alpine will
25253 attempt to open a UNIX secure shell connection.
25254 The default is 15, the minimum non-zero value is 5,
25255 and the maximum is unlimited. If this is set to zero ssh connections
25256 will be completely disabled.
25257 <P>
25258 <UL>
25259 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25260 </UL><P>
25261 &lt;End of help on this topic&gt;
25262 </BODY>
25263 </HTML>
25264 ====== h_config_rsh_open_timeo =====
25265 <HTML>
25266 <HEAD>
25267 <TITLE>OPTION: <!--#echo var="VAR_rsh-open-timeout"--></TITLE>
25268 </HEAD>
25269 <BODY>
25270 <H1>OPTION: <!--#echo var="VAR_rsh-open-timeout"--></H1>
25271
25272 Sets the time in seconds that Alpine will
25273 attempt to open a UNIX remote shell connection.
25274 The default is 15, the minimum non-zero value is 5,
25275 and the maximum is unlimited. If this is set to zero rsh connections
25276 will be completely disabled.
25277 This might be useful if rsh connections will never work in your environment
25278 but are causing delays due to firewalls or some other reason.
25279 <P>
25280 <UL>
25281 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25282 </UL><P>
25283 &lt;End of help on this topic&gt;
25284 </BODY>
25285 </HTML>
25286 ====== h_config_tcp_open_timeo =====
25287 <HTML>
25288 <HEAD>
25289 <TITLE>OPTION: <!--#echo var="VAR_tcp-open-timeout"--></TITLE>
25290 </HEAD>
25291 <BODY>
25292 <H1>OPTION: <!--#echo var="VAR_tcp-open-timeout"--></H1>
25293
25294 Sets the time in seconds that Alpine will
25295 attempt to open a network connection. The default is 30, the minimum is 5,
25296 and the maximum is system defined (typically 75). If a connection has not
25297 completed within this many seconds Alpine will give up and consider it a
25298 failed connection.
25299 <P>
25300 <UL>
25301 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25302 </UL><P>
25303 &lt;End of help on this topic&gt;
25304 </BODY>
25305 </HTML>
25306 ====== h_config_tcp_readwarn_timeo =====
25307 <HTML>
25308 <HEAD>
25309 <TITLE>OPTION: <!--#echo var="VAR_tcp-read-warning-timeout"--></TITLE>
25310 </HEAD>
25311 <BODY>
25312 <H1>OPTION: <!--#echo var="VAR_tcp-read-warning-timeout"--></H1>
25313
25314 Sets the time in seconds that Alpine will
25315 wait for a network read before warning you that things are moving slowly
25316 and possibly giving you the option to break the connection.
25317 The default is 15 seconds. The minimum is 5 seconds and the maximumn is
25318 1000 seconds.
25319 <P>
25320 Related option: <A HREF="h_config_tcp_query_timeo"><!--#echo var="VAR_tcp-query-timeout"--></A>.
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_tcp_writewarn_timeo =====
25329 <HTML>
25330 <HEAD>
25331 <TITLE>OPTION: <!--#echo var="VAR_tcp-write-warning-timeout"--></TITLE>
25332 </HEAD>
25333 <BODY>
25334 <H1>OPTION: <!--#echo var="VAR_tcp-write-warning-timeout"--></H1>
25335
25336 Sets the time in seconds that Alpine will
25337 wait for a network write before warning you that things are moving slowly
25338 and possibly giving you the option to break the connection.
25339 The default is 0 which means it is unset. If set to a non-zero value, the
25340 minimum is 5 and the maximum is 1000.
25341 <P>
25342 Related option: <A HREF="h_config_tcp_query_timeo"><!--#echo var="VAR_tcp-query-timeout"--></A>.
25343 <P>
25344 <UL>
25345 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25346 </UL><P>
25347 &lt;End of help on this topic&gt;
25348 </BODY>
25349 </HTML>
25350 ====== h_config_tcp_query_timeo =====
25351 <HTML>
25352 <HEAD>
25353 <TITLE>OPTION: <!--#echo var="VAR_tcp-query-timeout"--></TITLE>
25354 </HEAD>
25355 <BODY>
25356 <H1>OPTION: <!--#echo var="VAR_tcp-query-timeout"--></H1>
25357
25358 When Alpine times out a network read or write it will normally just display
25359 a message saying &quot;Still waiting&quot;.
25360 However, if enough time has elapsed since it started waiting it will offer
25361 to let you break the connection.
25362 That amount of time is set by this option, which defaults to 60 seconds,
25363 has a minimum of 5 seconds, and a maximum of 1000 seconds.
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_quit_query_timeo =====
25372 <HTML>
25373 <HEAD>
25374 <TITLE>OPTION: <!--#echo var="VAR_close-connection-timeout"--></TITLE>
25375 </HEAD>
25376 <BODY>
25377 <H1>OPTION: <!--#echo var="VAR_close-connection-timeout"--></H1>
25378
25379 The original purpose of this option was to close a connection after this
25380 much time has elapsed without response from the server. The problem this
25381 generates is that a server might not reply on time due to a slow operation
25382 (for example, sorting a large folder, or filtering messages, etc.) In those
25383 situations it is desirable to wait for the server, even when this takes
25384 a long time.
25385
25386 <P>
25387 In order to have a good compromise so that a user can distinguish between
25388 when a connection is closed, therefore
25389 we do not need to wait for it, and the operation that the user is waiting
25390 for takes a long time, this option only applies to the
25391 &quot;NOOP&quot; IMAP command. So, if a NOOP command has been issued,
25392 and the connection does not return after the number of seconds configured
25393 here, which must be at least the amount configured in the option
25394 <a href="h_config_tcp_query_timeo"><!--#echo var="VAR_tcp-query-timeout"--></a>,
25395 then Alpine will close the connection.
25396
25397 <P>
25398 Closing connections that have connectivity problems is a good idea. In an ideal
25399 world, one would like all connections to be fast and reliable, so the amount
25400 of time and effort put into parsing a folder to report its state when it is
25401 opened is not wasted, so keeping connections alive is good, but the problem
25402 with this is that waiting for a user to reply to a &quot;keep connection
25403 alive?&quot; question can take a long time, and that might affect other
25404 connections that could be closed because Alpine is not pinging them while it
25405 is waiting for a reply from a user for a different connection. Therefore
25406 setting this value helps to keep other connections alive, in case
25407 you have several incoming folders in other servers.
25408
25409 <P>
25410 The default value for this option is 0, which means that no connections will
25411 be closed automatically, so if you want connections to be closed automatically
25412 you must set this option to a positive number bigger or equal than the
25413 value of the option <!--#echo var="VAR_tcp-query-timeout"-->.
25414 <P>
25415 <UL>
25416 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25417 </UL><P>
25418 &lt;End of help on this topic&gt;
25419 </BODY>
25420 </HTML>
25421 ====== h_config_incoming_folders =====
25422 <HTML>
25423 <HEAD>
25424 <TITLE>OPTION: <!--#echo var="VAR_incoming-folders"--></TITLE>
25425 </HEAD>
25426 <BODY>
25427 <H1>OPTION: <!--#echo var="VAR_incoming-folders"--></H1>
25428
25429 This is a list of one or more folders other than <EM>INBOX</EM> that
25430 may receive new messages.
25431 It is related to the
25432 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="FEAT_enable-incoming-folders"-->&quot;</A>
25433 feature.
25434 This variable is normally manipulated with the Add, Delete, and Rename
25435 commands in the FOLDER LIST for the Incoming Message Folders collection.
25436 <P>
25437 <UL>
25438 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25439 </UL><P>
25440 &lt;End of help on this topic&gt;
25441 </BODY>
25442 </HTML>
25443 ====== h_config_folder_spec =====
25444 <HTML>
25445 <HEAD>
25446 <TITLE>OPTION: <!--#echo var="VAR_folder-collections"--></TITLE>
25447 </HEAD>
25448 <BODY>
25449 <H1>OPTION: <!--#echo var="VAR_folder-collections"--></H1>
25450
25451 This is a list of one or more collections where saved mail is stored.
25452 The first collection in this list is the default
25453 collection for <EM>Save</EM>s,
25454 including <A HREF="h_config_default_fcc"><!--#echo var="VAR_default-fcc"--></A>.
25455 <P>
25456 This variable is normally manipulated using the Setup/collectionList screen.
25457 <P>
25458 <UL>
25459 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25460 </UL><P>
25461 &lt;End of help on this topic&gt;
25462 </BODY>
25463 </HTML>
25464 ====== h_config_news_spec =====
25465 <HTML>
25466 <HEAD>
25467 <TITLE>OPTION: <!--#echo var="VAR_news-collections"--></TITLE>
25468 </HEAD>
25469 <BODY>
25470 <H1>OPTION: <!--#echo var="VAR_news-collections"--></H1>
25471
25472 This is a list of collections where news folders are located.
25473 <P>
25474 This variable is normally manipulated using the Setup/collectionList screen.
25475 <P>
25476 <UL>
25477 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25478 </UL><P>
25479 &lt;End of help on this topic&gt;
25480 </BODY>
25481 </HTML>
25482 ====== h_config_address_book =====
25483 <HTML>
25484 <HEAD>
25485 <TITLE>OPTION: <!--#echo var="VAR_address-book"--></TITLE>
25486 </HEAD>
25487 <BODY>
25488 <H1>OPTION: <!--#echo var="VAR_address-book"--></H1>
25489
25490 A list of personal address books.
25491 Each entry in the list is an
25492 optional nickname followed by a pathname or file name relative to the home
25493 directory.
25494 The nickname is separated from the rest of the line with whitespace.
25495 Instead of a local pathname or file name, a remote folder name can be given.
25496 This causes the address book to
25497 be a Remote address book.
25498 <P>
25499 Use the Setup/AddressBook screen to modify this variable.
25500 <P>
25501 <UL>
25502 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25503 </UL><P>
25504 &lt;End of help on this topic&gt;
25505 </BODY>
25506 </HTML>
25507 ====== h_config_glob_addrbook =====
25508 <HTML>
25509 <HEAD>
25510 <TITLE>OPTION: <!--#echo var="VAR_global-address-book"--></TITLE>
25511 </HEAD>
25512 <BODY>
25513 <H1>OPTION: <!--#echo var="VAR_global-address-book"--></H1>
25514
25515 A list of shared address books.  Each entry in the list is an
25516 optional nickname followed by a pathname or file name relative to the home
25517 directory.
25518 A SPACE character separates the nickname from the rest of the line.
25519 Instead of a local pathname or file name, a remote folder name can be given.
25520 This causes the address book to
25521 be a Remote address book.
25522 Global address books are
25523 defined to be ReadOnly.
25524 <P>
25525 Use the Setup/AddressBook screen to modify this variable.
25526 <P>
25527 <UL>
25528 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25529 </UL><P>
25530 &lt;End of help on this topic&gt;
25531 </BODY>
25532 </HTML>
25533 ====== h_config_last_vers =====
25534 <HTML>
25535 <HEAD>
25536 <TITLE>OPTION: <!--#echo var="VAR_last-version-used"--></TITLE>
25537 </HEAD>
25538 <BODY>
25539 <H1>OPTION: <!--#echo var="VAR_last-version-used"--></H1>
25540
25541 This is set automatically by Alpine.
25542 It is used to keep track of the last version of Alpine that
25543 was run by the user.
25544 Whenever the version number increases, a new version message is printed out.
25545 This may not be set in the system-wide configuration files.
25546 <P>
25547 <UL>
25548 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25549 </UL><P>
25550 &lt;End of help on this topic&gt;
25551 </BODY>
25552 </HTML>
25553 ====== h_config_printer =====
25554 <HTML>
25555 <HEAD>
25556 <TITLE>OPTION: Printer</TITLE>
25557 </HEAD>
25558 <BODY>
25559 <H1>OPTION: Printer</H1>
25560
25561 Your default printer selection.
25562 <P>
25563 Use the Setup/Printer screen to modify this variable.
25564 <P>
25565 <UL>
25566 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25567 </UL><P>
25568 &lt;End of help on this topic&gt;
25569 </BODY>
25570 </HTML>
25571 ====== h_config_print_cat =====
25572 <HTML>
25573 <HEAD>
25574 <TITLE>OPTION: <!--#echo var="VAR_personal-print-category"--></TITLE>
25575 </HEAD>
25576 <BODY>
25577 <H1>OPTION: <!--#echo var="VAR_personal-print-category"--></H1>
25578
25579 This is an internal Alpine variable.
25580 It will be equal to 1, 2, or 3 depending on whether the default printer is
25581 attached, standard, or a personal print command.
25582 <P>
25583 Use the Setup/Printer screen to modify this variable.
25584 <P>
25585 <UL>
25586 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25587 </UL><P>
25588 &lt;End of help on this topic&gt;
25589 </BODY>
25590 </HTML>
25591 ====== h_config_print_command =====
25592 <HTML>
25593 <HEAD>
25594 <TITLE>OPTION: <!--#echo var="VAR_personal-print-command"--></TITLE>
25595 </HEAD>
25596 <BODY>
25597 <H1>OPTION: <!--#echo var="VAR_personal-print-command"--></H1>
25598
25599 List of personal print commands.
25600 <P>
25601 Use the Setup/Printer screen to modify this variable.
25602 <P>
25603 <UL>
25604 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25605 </UL><P>
25606 &lt;End of help on this topic&gt;
25607 </BODY>
25608 </HTML>
25609 ====== h_config_pat_old =====
25610 <HTML>
25611 <HEAD>
25612 <TITLE>OPTION: Patterns</TITLE>
25613 </HEAD>
25614 <BODY>
25615 <H1>OPTION: Patterns</H1>
25616
25617 The option Patterns is obsolete in Alpine and in Pine 4.50 and later, replaced by the
25618 options Patterns-Roles, Patterns-Filters, Patterns-Scores, Patterns-Indexcolors,
25619 and Patterns-Other.
25620 Patterns-Scores and Patterns-Filters have been replaced since then by
25621 Patterns-Scores2 and Patterns-Filters2.
25622 <P>
25623 Use the Setup/Rules screens to modify these variable.
25624 <P>
25625 <UL>
25626 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25627 </UL><P>
25628 &lt;End of help on this topic&gt;
25629 </BODY>
25630 </HTML>
25631 ====== h_config_pat_roles =====
25632 <HTML>
25633 <HEAD>
25634 <TITLE>OPTION: <!--#echo var="VAR_patterns-roles"--></TITLE>
25635 </HEAD>
25636 <BODY>
25637 <H1>OPTION: <!--#echo var="VAR_patterns-roles"--></H1>
25638
25639 List of rules used for roles.
25640 The option Patterns is obsolete in Alpine and in Pine 4.50 and later, replaced by this and
25641 other options.
25642 <P>
25643 Use the Setup/Rules/Roles screen to modify this variable.
25644 <P>
25645 <UL>
25646 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25647 </UL><P>
25648 &lt;End of help on this topic&gt;
25649 </BODY>
25650 </HTML>
25651 ====== h_config_pat_filts =====
25652 <HTML>
25653 <HEAD>
25654 <TITLE>OPTION: <!--#echo var="VAR_patterns-filters2"--></TITLE>
25655 </HEAD>
25656 <BODY>
25657 <H1>OPTION: <!--#echo var="VAR_patterns-filters2"--></H1>
25658
25659 List of rules used for filters.
25660 <P>
25661 Use the Setup/Rules/Filters screen to modify this variable.
25662 <P>
25663 <UL>
25664 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25665 </UL><P>
25666 &lt;End of help on this topic&gt;
25667 </BODY>
25668 </HTML>
25669 ====== h_config_pat_scores =====
25670 <HTML>
25671 <HEAD>
25672 <TITLE>OPTION: <!--#echo var="VAR_patterns-scores2"--></TITLE>
25673 </HEAD>
25674 <BODY>
25675 <H1>OPTION: <!--#echo var="VAR_patterns-scores2"--></H1>
25676
25677 List of rules used for scoring.
25678 <P>
25679 Use the Setup/Rules/SetScores screen to modify this variable.
25680 <P>
25681 <UL>
25682 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25683 </UL><P>
25684 &lt;End of help on this topic&gt;
25685 </BODY>
25686 </HTML>
25687 ====== h_config_pat_other =====
25688 <HTML>
25689 <HEAD>
25690 <TITLE>OPTION: <!--#echo var="VAR_patterns-other"--></TITLE>
25691 </HEAD>
25692 <BODY>
25693 <H1>OPTION: <!--#echo var="VAR_patterns-other"--></H1>
25694
25695 List of rules used for miscellaneous configuration.
25696 <P>
25697 Use the Setup/Rules/Other screen to modify this variable.
25698 <P>
25699 <UL>
25700 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25701 </UL><P>
25702 &lt;End of help on this topic&gt;
25703 </BODY>
25704 </HTML>
25705 ====== h_config_pat_incols =====
25706 <HTML>
25707 <HEAD>
25708 <TITLE>OPTION: patterns-indexcolors</TITLE>
25709 </HEAD>
25710 <BODY>
25711 <H1>OPTION: patterns-indexcolors</H1>
25712
25713 List of rules used for coloring lines in the index.
25714 <P>
25715 Use the Setup/Rules/Indexcolor screen to modify this variable.
25716 <P>
25717 <UL>
25718 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25719 </UL><P>
25720 &lt;End of help on this topic&gt;
25721 </BODY>
25722 </HTML>
25723 ====== h_config_pat_srch =====
25724 <HTML>
25725 <HEAD>
25726 <TITLE>OPTION: patterns-search</TITLE>
25727 </HEAD>
25728 <BODY>
25729 <H1>OPTION: patterns-search</H1>
25730
25731 List of rules used only for searching with the Select command in the MESSAGE INDEX.
25732 <P>
25733 Use the Setup/Rules/searCh screen to modify this variable.
25734 <P>
25735 <UL>
25736 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25737 </UL><P>
25738 &lt;End of help on this topic&gt;
25739 </BODY>
25740 </HTML>
25741 ====== h_config_font_name =====
25742 <HTML>
25743 <HEAD>
25744 <TITLE>OPTION: Font Name</TITLE>
25745 </HEAD>
25746 <BODY>
25747 <H1>OPTION: Font Name</H1>
25748
25749 PC-Alpine only.
25750 <P>
25751 Name of normal font.
25752 <P>
25753 Use the pulldown Config menu to modify this variable.
25754 <P>
25755 <UL>
25756 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25757 </UL><P>
25758 &lt;End of help on this topic&gt;
25759 </BODY>
25760 </HTML>
25761 ====== h_config_font_size =====
25762 <HTML>
25763 <HEAD>
25764 <TITLE>OPTION: Font Size</TITLE>
25765 </HEAD>
25766 <BODY>
25767 <H1>OPTION: Font Size</H1>
25768
25769 PC-Alpine only.
25770 <P>
25771 Size of normal font.
25772 <P>
25773 Use the pulldown Config menu to modify this variable.
25774 <P>
25775 <UL>
25776 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25777 </UL><P>
25778 &lt;End of help on this topic&gt;
25779 </BODY>
25780 </HTML>
25781 ====== h_config_font_style =====
25782 <HTML>
25783 <HEAD>
25784 <TITLE>OPTION: Font Style</TITLE>
25785 </HEAD>
25786 <BODY>
25787 <H1>OPTION: Font Style</H1>
25788
25789 PC-Alpine only.
25790 <P>
25791 Style of normal font.
25792 <P>
25793 Use the pulldown Config menu to modify this variable.
25794 <P>
25795 <UL>
25796 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25797 </UL><P>
25798 &lt;End of help on this topic&gt;
25799 </BODY>
25800 </HTML>
25801 ====== h_config_font_char_set =====
25802 <HTML>
25803 <HEAD>
25804 <TITLE>OPTION: Font Character Set</TITLE>
25805 </HEAD>
25806 <BODY>
25807 <H1>OPTION: Font Character Set</H1>
25808
25809 PC-Alpine only.
25810 <P>
25811 Character set of normal font.
25812 <P>
25813 Use the pulldown Config menu to modify this variable.
25814 <P>
25815 <UL>
25816 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25817 </UL><P>
25818 &lt;End of help on this topic&gt;
25819 </BODY>
25820 </HTML>
25821 ====== h_config_print_font_name =====
25822 <HTML>
25823 <HEAD>
25824 <TITLE>OPTION: Print-Font-Name</TITLE>
25825 </HEAD>
25826 <BODY>
25827 <H1>OPTION: Print-Font-Name</H1>
25828
25829 PC-Alpine only.
25830 <P>
25831 Name of printer font.
25832 <P>
25833 Use the pulldown Config menu to modify this variable.
25834 <P>
25835 <UL>
25836 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25837 </UL><P>
25838 &lt;End of help on this topic&gt;
25839 </BODY>
25840 </HTML>
25841 ====== h_config_print_font_size =====
25842 <HTML>
25843 <HEAD>
25844 <TITLE>OPTION: Print-Font-Size</TITLE>
25845 </HEAD>
25846 <BODY>
25847 <H1>OPTION: Print-Font-Size</H1>
25848
25849 PC-Alpine only.
25850 <P>
25851 Size of printer font.
25852 <P>
25853 Use the pulldown Config menu to modify this variable.
25854 <P>
25855 <UL>
25856 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25857 </UL><P>
25858 &lt;End of help on this topic&gt;
25859 </BODY>
25860 </HTML>
25861 ====== h_config_print_font_style =====
25862 <HTML>
25863 <HEAD>
25864 <TITLE>OPTION: Print-Font-Style</TITLE>
25865 </HEAD>
25866 <BODY>
25867 <H1>OPTION: Print-Font-Style</H1>
25868
25869 PC-Alpine only.
25870 <P>
25871 Style of printer font.
25872 <P>
25873 Use the pulldown Config menu to modify this variable.
25874 <P>
25875 <UL>
25876 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25877 </UL><P>
25878 &lt;End of help on this topic&gt;
25879 </BODY>
25880 </HTML>
25881 ====== h_config_print_font_char_set =====
25882 <HTML>
25883 <HEAD>
25884 <TITLE>OPTION: Print-Font-Char-Set</TITLE>
25885 </HEAD>
25886 <BODY>
25887 <H1>OPTION: Print-Font-Char-Set</H1>
25888
25889 PC-Alpine only.
25890 <P>
25891 Character set of printer font.
25892 <P>
25893 Use the pulldown Config menu to modify this variable.
25894 <P>
25895 <UL>
25896 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25897 </UL><P>
25898 &lt;End of help on this topic&gt;
25899 </BODY>
25900 </HTML>
25901 ====== h_config_window_position =====
25902 <HTML>
25903 <HEAD>
25904 <TITLE>OPTION: Window-Position</TITLE>
25905 </HEAD>
25906 <BODY>
25907 <H1>OPTION: Window-Position</H1>
25908
25909 PC-Alpine only.
25910 <P>
25911 Position on the screen of the Alpine window.
25912 <P>
25913 Alpine normally maintains this variable itself, and it is set automatically.
25914 This variable is provided to those who wish to use the same window position
25915 across different machines from the same configuration.
25916 <A HREF="h_config_winpos_in_config"><!--#echo var="FEAT_store-window-position-in-config"--></A>
25917 must also be set for this setting to be used.
25918 <P>
25919 The format for this variable is of the form: <CODE>CxR+X+Y</CODE>, where
25920 C is the number of columns, R is the number of rows, and X and Y specify the
25921 top left corner of the window.
25922 <P>
25923 <UL>
25924 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25925 </UL><P>
25926 &lt;End of help on this topic&gt;
25927 </BODY>
25928 </HTML>
25929 ====== h_config_cursor_style =====
25930 <HTML>
25931 <HEAD>
25932 <TITLE>OPTION: Cursor Style</TITLE>
25933 </HEAD>
25934 <BODY>
25935 <H1>OPTION: Cursor Style</H1>
25936
25937 PC-Alpine only.
25938 <P>
25939 Cursor style.
25940 <P>
25941 Use the pulldown Config menu to modify this variable.
25942 <P>
25943 <UL>
25944 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25945 </UL><P>
25946 &lt;End of help on this topic&gt;
25947 </BODY>
25948 </HTML>
25949 ====== h_config_ldap_servers =====
25950 <HTML>
25951 <HEAD>
25952 <TITLE>OPTION: <!--#echo var="VAR_ldap-servers"--></TITLE>
25953 </HEAD>
25954 <BODY>
25955 <H1>OPTION: <!--#echo var="VAR_ldap-servers"--></H1>
25956
25957 List of LDAP servers and associated data.
25958 <P>
25959 Use the Setup/Directory screen to modify this variable.
25960 <P>
25961 <UL>
25962 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25963 </UL><P>
25964 &lt;End of help on this topic&gt;
25965 </BODY>
25966 </HTML>
25967 ====== h_config_sendmail_path =====
25968 <HTML>
25969 <HEAD>
25970 <TITLE>OPTION: <!--#echo var="VAR_sendmail-path"--></TITLE>
25971 </HEAD>
25972 <BODY>
25973 <H1>OPTION: <!--#echo var="VAR_sendmail-path"--></H1>
25974
25975 This names the path to an
25976 alternative program, and any necessary arguments, to be used in posting
25977 mail messages. See the Technical notes for more information.
25978 <P>
25979 <UL>
25980 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
25981 </UL><P>
25982 &lt;End of help on this topic&gt;
25983 </BODY>
25984 </HTML>
25985 ====== h_config_oper_dir =====
25986 <HTML>
25987 <HEAD>
25988 <TITLE>OPTION: <!--#echo var="VAR_operating-dir"--></TITLE>
25989 </HEAD>
25990 <BODY>
25991 <H1>OPTION: <!--#echo var="VAR_operating-dir"--></H1>
25992
25993 This names the root of the
25994 tree to which you are restricted when reading and writing folders and
25995 files. It is usually used in the system-wide,
25996 <EM>fixed</EM> configuration file.
25997 <P>
25998 <UL>
25999 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26000 </UL><P>
26001 &lt;End of help on this topic&gt;
26002 </BODY>
26003 </HTML>
26004 ====== h_config_rshpath =====
26005 <HTML>
26006 <HEAD>
26007 <TITLE>OPTION: <!--#echo var="VAR_rsh-path"--></TITLE>
26008 </HEAD>
26009 <BODY>
26010 <H1>OPTION: <!--#echo var="VAR_rsh-path"--></H1>
26011
26012 Sets the name of the command used to open a UNIX remote shell
26013 connection. The default is typically <CODE>/usr/ucb/rsh</CODE>.
26014 <P>
26015 <UL>
26016 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26017 </UL><P>
26018 &lt;End of help on this topic&gt;
26019 </BODY>
26020 </HTML>
26021 ====== h_config_rshcmd =====
26022 <HTML>
26023 <HEAD>
26024 <TITLE>OPTION: <!--#echo var="VAR_rsh-command"--></TITLE>
26025 </HEAD>
26026 <BODY>
26027 <H1>OPTION: <!--#echo var="VAR_rsh-command"--></H1>
26028
26029 Sets the format of the command used to
26030 open a UNIX remote shell connection. The default is
26031 "%s %s -l %s exec /etc/r%sd". All four "%s" entries MUST exist in the
26032 provided command. The first is for the command's pathname, the second is
26033 for the host to connect to, the third is for the user to connect as, and
26034 the fourth is for the connection method (typically <CODE>imap</CODE>).
26035 <P>
26036 <UL>
26037 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26038 </UL><P>
26039 &lt;End of help on this topic&gt;
26040 </BODY>
26041 </HTML>
26042 ====== h_config_sshpath =====
26043 <HTML>
26044 <HEAD>
26045 <TITLE>OPTION: <!--#echo var="VAR_ssh-path"--></TITLE>
26046 </HEAD>
26047 <BODY>
26048 <H1>OPTION: <!--#echo var="VAR_ssh-path"--></H1>
26049
26050 Sets the name of the command used to open a UNIX secure shell
26051 connection. The default is typically <CODE>/usr/bin/ssh</CODE>.
26052 <P>
26053 <UL>
26054 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26055 </UL><P>
26056 &lt;End of help on this topic&gt;
26057 </BODY>
26058 </HTML>
26059 ====== h_config_sshcmd =====
26060 <HTML>
26061 <HEAD>
26062 <TITLE>OPTION: <!--#echo var="VAR_ssh-command"--></TITLE>
26063 </HEAD>
26064 <BODY>
26065 <H1>OPTION: <!--#echo var="VAR_ssh-command"--></H1>
26066
26067 Sets the format of the command used to
26068 open a UNIX secure shell connection. The default is
26069 "%s %s -l %s exec /etc/r%sd". All four "%s" entries MUST exist in the
26070 provided command. The first is for the command's pathname, the second is
26071 for the host to connect to, the third is for the user to connect as, and
26072 the fourth is for the connection method (typically <CODE>imap</CODE>).
26073 <P>
26074 <UL>
26075 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26076 </UL><P>
26077 &lt;End of help on this topic&gt;
26078 </BODY>
26079 </HTML>
26080 ====== h_config_new_ver_quell =====
26081 <HTML>
26082 <HEAD>
26083 <TITLE>OPTION: <!--#echo var="VAR_new-version-threshold"--></TITLE>
26084 </HEAD>
26085 <BODY>
26086 <H1>OPTION: <!--#echo var="VAR_new-version-threshold"--></H1>
26087
26088 When a new version of Alpine is run for the first time it offers a
26089 special explanatory screen to the user upon startup.  This option
26090 helps control when and if that special screen appears for users that
26091 have previously run Alpine.  It takes as its value an Alpine version
26092 number.  Alpine versions less than the specified value will suppress this
26093 special screen while versions equal to or greater than that specified
26094 will behave normally.
26095 <P>
26096 <UL>
26097 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26098 </UL><P>
26099 &lt;End of help on this topic&gt;
26100 </BODY>
26101 </HTML>
26102 ====== h_config_disable_drivers =====
26103 <HTML>
26104 <HEAD>
26105 <TITLE>OPTION: <!--#echo var="VAR_disable-these-drivers"--></TITLE>
26106 </HEAD>
26107 <BODY>
26108 <H1>OPTION: <!--#echo var="VAR_disable-these-drivers"--></H1>
26109
26110 This variable is a list of mail drivers that will be disabled.
26111 The candidates for disabling are listed below.
26112 There may be more in the future if you compile Alpine with
26113 a newer version of the c-client library.
26114 <P>
26115
26116 <UL>
26117 <LI> mbox
26118 <LI> mbx
26119 <LI> mh
26120 <LI> mmdf
26121 <LI> mtx
26122 <LI> mx
26123 <LI> news
26124 <LI> phile
26125 <LI> tenex
26126 <LI> unix
26127 </UL>
26128 <P>
26129
26130 The <EM>mbox</EM> driver enables the following behavior: if there is a
26131 file called <CODE>mbox</CODE>
26132 in your home directory, and if that file is either empty or in Unix mailbox
26133 format, then every time you open <EM>INBOX</EM> the <EM>mbox</EM> driver
26134 will automatically transfer mail from the system mail spool directory into the
26135 <CODE>mbox</CODE> file and
26136 delete it from the spool directory. If you disable the <EM>mbox</EM> driver,
26137 this will not happen.
26138 <P>
26139
26140 It is not recommended to disable the driver that supports the system default
26141 mailbox format. On most non-SCO systems, that driver is the
26142 <EM>unix</EM> driver.
26143 On most SCO systems, it is the <EM>mmdf</EM> driver.
26144 The system default driver may be
26145 configured to something else on your system; check with your system manager
26146 for additional information.
26147 <P>
26148
26149 It is most likely not very useful for you to disable any of the drivers other
26150 than possibly <EM>mbox</EM>.
26151 You could disable some of the others if you know for
26152 certain that you don't need them but the performance gain in doing so
26153 is very modest.
26154 <P>
26155 <UL>
26156 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26157 </UL><P>
26158 &lt;End of help on this topic&gt;
26159 </BODY>
26160 </HTML>
26161 ====== h_config_disable_auths =====
26162 <HTML>
26163 <HEAD>
26164 <TITLE>OPTION: <!--#echo var="VAR_disable-these-authenticators"--></TITLE>
26165 </HEAD>
26166 <BODY>
26167 <H1>OPTION: <!--#echo var="VAR_disable-these-authenticators"--></H1>
26168
26169 This variable is a list of SASL (Simple Authentication and Security
26170 Layer) authenticators that will be disabled.
26171 SASL is a mechanism for
26172 authenticating to IMAP, POP3, SMTP, and other network servers.
26173 <P>
26174
26175 Alpine matches its list of supported authenticators with the server to
26176 determine the most secure authenticator that is supported by both.
26177 If no matching authenticators are found, Alpine will revert to plaintext
26178 login (or, in the case of SMTP, will be unable to authenticate at all).
26179 <P>
26180 The candidates for disabling can be found <A HREF="X-Alpine-Config:">here</A>.
26181 <P>
26182
26183 Normally, you will not disable any authenticators.
26184 There are two exceptions:
26185 <P>
26186 <OL>
26187 <LI> You use a broken server that advertises an authenticator,
26188 but does not actually implement it.
26189 <LI> You have a Kerberos-capable version of Alpine and the server is
26190 also Kerberos-capable, but you can not obtain Kerberos
26191 credentials on the server machine, thus you desire to disable
26192 GSSAPI (which in turn disables Alpine's Kerberos support).
26193 </OL>
26194 <P>
26195 It is never necessary to disable authenticators, since Alpine will try
26196 other authenticators before giving up.
26197 However, disabling the relevant authenticator avoids annoying error messages.
26198 <P>
26199 <UL>
26200 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26201 </UL><P>
26202 &lt;End of help on this topic&gt;
26203 </BODY>
26204 </HTML>
26205 ====== h_config_encryption_range =====
26206 <HTML>
26207 <HEAD>
26208 <TITLE>OPTION: <!--#echo var="VAR_encryption-protocol-range"--></TITLE>
26209 </HEAD>
26210 <BODY>
26211 <H1>OPTION: <!--#echo var="VAR_encryption-protocol-range"--></H1>
26212
26213 This option sets a range of encryption protocols that can be attempted when
26214 Alpine will try to establish a secure connection using the SSL or TLS
26215 protocols.
26216
26217 <P>
26218 Before a secure connection to an external server is established, Alpine and the
26219 server will attempt to negotiate a secure connection. This part is known as the
26220 &quot;ClientHello&quot;. At that time Alpine will announce the version of
26221 encryption that it would like to establish. The server can reject that, and announce
26222 a different version of encryption. Once both the server and Alpine have found
26223 a version of encryption that they both agree on, they will both use it to start
26224 a secure connection.
26225
26226 <P>
26227 The use of the /ssl parameter in the definition of the server will make Alpine
26228 attempt the highest encryption protocol that it can use, in agreement with the
26229 server. However, using this option, you will set limits to the versions of
26230 the protocols that are used. This would, for example, allow you to disable the use
26231 of ssl3, in favor of more modern protocols.
26232
26233 <P>
26234 For purposes of this option, the protocols are sorted
26235 as follows
26236
26237 <P>
26238 <CENTER>
26239 no_min < ssl3 < tls1 < tls1_1 < tls1_2 < tls1_3 < no_max
26240 </CENTER>
26241
26242 <P>
26243 For example, if you want to disable ssl3, all you have to do is to set the minimum
26244 version to tls1, or any higher protocol.
26245
26246 <P>The name of the parameters used to configure this option is the same as the
26247 parameters that are added to the definition of a server to make it a secure
26248 connection, and they are listed above for your reference.
26249
26250 <P>
26251 The special values &quot;no_min&quot; and &quot;no_max&quot; do not set values
26252 for the minimum and maximum protocol versions, and Alpine will use the maximum
26253 and minimum values of encryption protocols built into your SSL library.
26254
26255 <P>
26256 <UL>
26257 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26258 </UL><P>
26259 &lt;End of help on this topic&gt;
26260 </BODY>
26261 </HTML>
26262 ====== h_config_abook_metafile =====
26263 <HTML>
26264 <HEAD>
26265 <TITLE>OPTION: <!--#echo var="VAR_remote-abook-metafile"--></TITLE>
26266 </HEAD>
26267 <BODY>
26268 <H1>OPTION: <!--#echo var="VAR_remote-abook-metafile"--></H1>
26269
26270 This is usually set by Alpine and is the name of a file
26271 that contains data about
26272 remote address books and remote configuration files.
26273 <P>
26274 <UL>
26275 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26276 </UL><P>
26277 &lt;End of help on this topic&gt;
26278 </BODY>
26279 </HTML>
26280 ====== h_config_composer_wrap_column =====
26281 <HTML>
26282 <HEAD>
26283 <TITLE>OPTION: <!--#echo var="VAR_composer-wrap-column"--></TITLE>
26284 </HEAD>
26285 <BODY>
26286 <H1>OPTION: <!--#echo var="VAR_composer-wrap-column"--></H1>
26287
26288
26289 This option specifies an aspect of Alpine's Composer.  This gives the
26290 maximum width that auto-wrapped lines will have.  It's also the maximum
26291 width of lines justified using the <A HREF="h_compose_justify">^J
26292 Justify</A> command.  The normal default
26293 is &quot;74&quot;.  The largest allowed setting is normally &quot;80&quot;
26294 in order to
26295 prevent very long lines from being sent in outgoing mail.  When the mail
26296 is actually sent, trailing spaces will be stripped off of each line.
26297
26298 <P>
26299 <UL>
26300 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26301 </UL><P>
26302 &lt;End of help on this topic&gt;
26303 </BODY>
26304 </HTML>
26305 ====== h_config_deadlets =====
26306 <HTML>
26307 <HEAD>
26308 <TITLE>OPTION: <!--#echo var="VAR_dead-letter-files"--></TITLE>
26309 </HEAD>
26310 <BODY>
26311 <H1>OPTION: <!--#echo var="VAR_dead-letter-files"--></H1>
26312
26313
26314 This option affects Alpine's behavior when you cancel a message being
26315 composed.  Alpine's usual behavior is to write the canceled message to
26316 a file named
26317 <!--chtml if pinemode="os_windows"-->
26318 &quot;DEADLETR&quot;,
26319 <!--chtml else-->
26320 &quot;dead.letter&quot; in your home directory,
26321 <!--chtml endif-->
26322 overwriting any previous message.
26323 <P>
26324 If you set this option to a value higher than one, then that many copies
26325 of dead letter files will be saved.
26326 For example, if you set this option to &quot;3&quot; then you may have
26327 files named
26328 <!--chtml if pinemode="os_windows"-->
26329 &quot;DEADLETR&quot;,
26330 &quot;DEADLETR2&quot;, and
26331 &quot;DEADLETR3&quot;.
26332 <!--chtml else-->
26333 &quot;dead.letter&quot;,
26334 &quot;dead.letter2&quot;, and
26335 &quot;dead.letter3&quot; in your home directory.
26336 <!--chtml endif-->
26337 In this example, the most recently cancelled message will be in
26338 <!--chtml if pinemode="os_windows"-->
26339 &quot;DEADLETR&quot;,
26340 <!--chtml else-->
26341 &quot;dead.letter&quot;,
26342 <!--chtml endif-->
26343 and the third most recently cancelled message will be in
26344 <!--chtml if pinemode="os_windows"-->
26345 &quot;DEADLETR3&quot;.
26346 <!--chtml else-->
26347 &quot;dead.letter3&quot;.
26348 <!--chtml endif-->
26349 The fourth most recently cancelled message will no longer be saved.
26350
26351 <P>
26352 If you set this option to zero, then NO record of canceled messages is
26353 maintained.
26354 <P>
26355 If the feature
26356 <A HREF="h_config_quell_dead_letter"><!--#echo var="FEAT_quell-dead-letter-on-cancel"--></A>
26357 is set, that overrides whatever you set for this option.
26358 If this option had existed at the time, then the Quell feature would not
26359 have been added, but it is still there for backwards compatibility.
26360 So, in order for this option to have the desired effect, make sure the
26361 Quell feature is turned off.
26362
26363 <P>
26364 <UL>
26365 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26366 </UL><P>
26367 &lt;End of help on this topic&gt;
26368 </BODY>
26369 </HTML>
26370 ====== h_config_maxremstream =====
26371 <HTML>
26372 <HEAD>
26373 <TITLE>OPTION: <!--#echo var="VAR_max-remote-connections"--></TITLE>
26374 </HEAD>
26375 <BODY>
26376 <H1>OPTION: <!--#echo var="VAR_max-remote-connections"--></H1>
26377
26378 This option affects low-level behavior of Alpine.
26379 The default value for this option is <EM>3</EM>.
26380 If your INBOX is accessed using the IMAP protocol
26381 from an IMAP server, that connection is kept open throughout the
26382 duration of your Alpine session, independent of the value of this option.
26383 The same is true of any
26384 <A HREF="h_config_permlocked">&quot;<!--#echo var="VAR_stay-open-folders"-->&quot;</A>
26385 you have defined.
26386 This option controls Alpine's behavior when connecting to remote IMAP folders
26387 other than your INBOX or your <!--#echo var="VAR_stay-open-folders"-->.
26388 It specifies the maximum number of remote IMAP connections (other than
26389 those mentioned above) that Alpine will use for accessing the rest of your
26390 folders.
26391 If you set this option to zero, you will turn off most remote connection
26392 re-use.
26393 It's difficult to understand exactly what this option does, and it is usually
26394 fine to leave it set to its default value.
26395 It is probably more likely that you will be interested in setting the
26396 <A HREF="h_config_permlocked">&quot;<!--#echo var="VAR_stay-open-folders"-->&quot;</A> option
26397 instead of changing the value of this option.
26398 A slightly longer explanation of what is going on with this option
26399 is given in the next paragraphs.
26400
26401 <P>
26402 There are some time costs involved in opening and closing remote IMAP
26403 folders, the main costs being the time you have to wait for the connection
26404 to the server and the time for the folder to open.
26405 Opening a folder may involve not only the time the server takes to do its
26406 processing but time that Alpine uses to do filtering.
26407 These times can vary widely.
26408 They depend on how loaded the server is, how large
26409 the folder being opened is, and how you set up filtering, among other things.
26410 Once Alpine has opened a connection to a particular folder, it will attempt
26411 to keep that connection open in case you use it again.
26412 In order to do this,
26413 Alpine will attempt to use the <!--#echo var="VAR_max-remote-connections"--> (the value of
26414 this option) IMAP connections you have allotted for this purpose.
26415 <P>
26416 For example, suppose the value of this option is set to &quot;2&quot;.
26417 If your INBOX is accessed on a remote server using the IMAP protocol, that
26418 doesn't count as one of the remote connections but it is always kept open.
26419 If you then open another IMAP folder, that would be your first
26420 remote connection counted as one of the <!--#echo var="VAR_max-remote-connections"--> connections.
26421 If you open a third folder the second will be left open, in case you
26422 return to it.
26423 You won't be able to tell it has been left open.
26424 It will appear to be closed when you leave the folder but the connection
26425 will remain in the background.
26426 Now suppose you go back to the second folder (the first folder after the
26427 INBOX).
26428 A connection to that folder is still open so you won't have to wait
26429 for the startup time to open it.
26430 Meanwhile, the connection to the third folder will be left behind.
26431 Now, if you open a fourth folder, you will bump into the
26432 <!--#echo var="VAR_max-remote-connections"--> limit, because this will be the third folder other
26433 than INBOX and you have the option set to &quot;2&quot;.
26434 The connection that is being used for
26435 the third folder will be re-used for this new fourth folder.
26436 If you go back to the third folder after this, it is no longer already
26437 connected when you get there.
26438 You'll still save some time since Alpine will re-use the connection to the
26439 fourth folder and you have already logged in on that connection,
26440 but the folder will have to be re-opened from scratch.
26441 <P>
26442 If a folder is large and the startup cost is dominated by the time it takes
26443 to open that folder or to run filters on it, then it will pay to make the
26444 value of this option large enough to keep it open.
26445 On the other hand, if you only revisit a handful of folders or if
26446 the folders are small, then it might
26447 make more sense to keep this number small so that the reconnect
26448 time (the time to start up a new connection and authenticate)
26449 is eliminated instead.
26450 <P>
26451 You may also need to consider the impact on the server.
26452 On the surface, a larger number here may cause a larger impact on the
26453 server, since you will have more connections open to the server.
26454 On the other hand, not only will <EM>you</EM> be avoiding the startup costs
26455 associated with reopening a folder, but the <EM>server</EM> will be
26456 avoiding those costs as well.
26457 <P>
26458 When twenty five minutes pass without any active use of an IMAP connection
26459 being saved for possible re-use, that connection will be shut down,
26460
26461 <P>
26462 <UL>
26463 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26464 </UL><P>
26465 &lt;End of help on this topic&gt;
26466 </BODY>
26467 </HTML>
26468 ====== h_config_permlocked =====
26469 <HTML>
26470 <HEAD>
26471 <TITLE>OPTION: <!--#echo var="VAR_stay-open-folders"--></TITLE>
26472 </HEAD>
26473 <BODY>
26474 <H1>OPTION: <!--#echo var="VAR_stay-open-folders"--></H1>
26475
26476 This option affects low-level behavior of Alpine.
26477 There is no default value for this option.
26478 It is related to the options
26479 <A HREF="h_config_preopen_stayopens">&quot;<!--#echo var="FEAT_preopen-stayopen-folders"-->&quot;</A>,
26480 <A HREF="h_config_maxremstream">&quot;<!--#echo var="VAR_max-remote-connections"-->&quot;</A>,
26481 and <A HREF="h_config_expunge_stayopens">&quot;<!--#echo var="FEAT_offer-expunge-of-stayopen-folders"-->&quot;</A>.
26482
26483 <P>
26484 Note: changes made to this list take effect the next time you open a
26485 folder in the list.
26486
26487 <P>
26488 This is a list of folders that will be permanently kept open once they
26489 are first opened.
26490 The names in this list may be either the nickname of an Incoming folder
26491 or the full technical specification of a folder.
26492 The folders in this list need not be remote IMAP folders, they could usefully
26493 be local folders, as well.
26494 If a folder in the list is a newsgroup or is not accessed either locally
26495 or via IMAP, then the entry will be ignored.
26496 For example, folders accessed via NNTP or POP3 will not be kept open, since
26497 the way that new mail is found with those protocols involves closing and
26498 reopening the connection.
26499 <P>
26500 Once a Stay Open folder has been opened, new-mail checking will continue
26501 to happen on that folder for the rest of the Alpine session.
26502 Your INBOX is always implicitly included in this Stay-Open list and doesn't
26503 need to be added explicitly.
26504 <P>
26505 Another difference that you may notice between a Stay Open folder and a
26506 non-Stay Open folder is which message is selected as the current message
26507 when you enter the folder index.
26508 Normally, the starting position for an incoming folder (which most Stay Open
26509 folders will likely be) is controlled by the
26510 <A HREF="h_config_inc_startup"><!--#echo var="VAR_incoming-startup-rule"--></A>.
26511 However, if a folder is a Stay Open folder, when you re-enter the folder
26512 after the first time the current message will be the same as it was when
26513 you left the folder.
26514 An exception is made if you use the TAB command to get to the folder.
26515 In that case, the message number will be incremented by one from what it
26516 was when you left the folder.
26517 <P>
26518 The above special behavior is thought to be useful.
26519 However, it is special and different from what you might at first expect.
26520 The feature
26521 <A HREF="h_config_use_reg_start_for_stayopen"><!--#echo var="FEAT_use-regular-startup-rule-for-stayopen-folders"--></A>
26522 may be used to turn off this special treatment.
26523 <P>
26524 If the message that was current when you left the folder no longer exists,
26525 then the regular startup rule will be used instead.
26526
26527 <P>
26528 <UL>
26529 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26530 </UL><P>
26531 &lt;End of help on this topic&gt;
26532 </BODY>
26533 </HTML>
26534 ====== h_config_viewer_overlap =====
26535 <html>
26536 <header>
26537 <title>OPTION: <!--#echo var="VAR_viewer-overlap"--></title>
26538 </header>
26539 <body>
26540 <h1>OPTION: <!--#echo var="VAR_viewer-overlap"--></h1>
26541
26542 This option specifies an aspect of Alpine's Message Viewing screen.  When
26543 the space bar is used to page forward in a message, the number of lines
26544 specified by the &quot;<!--#echo var="VAR_viewer-overlap"-->&quot; variable will be repeated from the
26545 bottom of the screen.  That is, if this was set to two lines, then the
26546 bottom two lines of the screen would be repeated on the top of the next
26547 screen.  The normal default value is "2".<p>
26548 <UL>
26549 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26550 </UL><P>
26551 &lt;End of help on this topic&gt;
26552 </body>
26553 </html>
26554 ====== h_config_scroll_margin =====
26555 <HTML>
26556 <HEAD>
26557 <TITLE>OPTION: <!--#echo var="VAR_scroll-margin"--></TITLE>
26558 </HEAD>
26559 <BODY>
26560 <H1>OPTION: <!--#echo var="VAR_scroll-margin"--></H1>
26561
26562 This option controls when Alpine's line-by-line scrolling occurs.
26563 Typically, when a selected item is at the top or bottom screen edge
26564 and the UP or DOWN (and Ctrl-P or Ctrl-N) keys are struck, the
26565 displayed items are scrolled down or up by a single line.
26566
26567 <P>
26568 This option allows you to tell Alpine the number of lines from the top and
26569 bottom screen edge that line-by-line paging should occur.  For example,
26570 setting this value to one (1) will cause Alpine to scroll the display
26571 vertically when you move to select an item on the display's top or
26572 bottom edge.
26573
26574 <P>
26575 By default, this variable is zero, indicating that scrolling happens
26576 when you move up or down to select an item immediately off the display's
26577 top or bottom edge.
26578
26579 <P>
26580 <UL>
26581 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26582 </UL><P>
26583 &lt;End of help on this topic&gt;
26584 </BODY>
26585 </HTML>
26586 ====== h_config_wordseps =====
26587 <HTML>
26588 <HEAD>
26589 <TITLE>OPTION: <!--#echo var="VAR_composer-word-separators"--></TITLE>
26590 </HEAD>
26591 <BODY>
26592 <H1>OPTION: <!--#echo var="VAR_composer-word-separators"--></H1>
26593
26594 This option affects how a &quot;word&quot; is defined in the composer.
26595 The definition of a word is used when using the Forward Word and Backward
26596 Word commands in the composer, as well as when using the spell checker.
26597 Whitespace is always considered a word separator.
26598 Punctuation (like question marks, periods, commas, and so on) is always
26599 a word separator if it comes at the end of a word.
26600 By default, a punctuation character that is in the middle of a word does
26601 not break up that word as long as the character before and the character
26602 after it are both alphanumeric.
26603 If you add a character to this option it will be considered a
26604 word separator even when it occurs in the middle of an alphanumeric word.
26605 For example, if you want to skip through each part of an address instead
26606 of skipping the whole address at once you might want to include &quot;@&quot;
26607 and &quot;.&quot; in this list.
26608 If you want the word-skipper to stop on each part of a UNIX filename you
26609 could add &quot;/&quot; to the list.
26610 The equal sign and dash are other possibilities you might find helpful.
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_reply_indent_string =====
26619 <HTML>
26620 <HEAD>
26621 <TITLE>OPTION: <!--#echo var="VAR_reply-indent-string"--></TITLE>
26622 </HEAD>
26623 <BODY>
26624 <H1>OPTION: <!--#echo var="VAR_reply-indent-string"--></H1>
26625
26626 This option specifies an aspect of Alpine's Reply command.
26627 When a message is replied to and the text of the message is included, the
26628 included text usually has the string &quot;&gt;&nbsp;&quot; prepended
26629 to each line indicating it is quoted text.
26630 (In case you haven't seen this before, &quot;string&quot; is a technical term
26631 that means chunk of text.)
26632
26633 <P>
26634 Because of the introduction of <A HREF="h_config_quell_flowed_text">Flowed Text</A>
26635 in 1999 and its wide-spread adoption since then, you will usually be better off if you
26636 use one of the standard values,
26637 &quot;&gt;&nbsp;&quot; or &quot;&gt;&quot;, for this option.
26638
26639 <P>
26640 This option specifies a different value for that string.
26641 If you wish to use a string that begins or ends with a space,
26642 enclose the string in double quotes.
26643
26644 <P>
26645 Besides simple text, the prepended string can be based
26646 on the message being replied to.
26647 The following tokens are substituted for the message's corresponding value:
26648
26649 <DL>
26650 <DT>_FROM_</DT>
26651 <DD>This token gets replaced with the message sender's &quot;username&quot;.
26652 If the name is longer than six characters, only the first six characters are
26653 used.
26654 </DD>
26655
26656 <DT>_NICK_</DT>
26657 <DD>This token gets replaced with the nickname of the message sender's
26658 address as found in your addressbook.
26659 If no addressbook entry is found,
26660 Alpine replaces the characters &quot;_NICK_&quot; with nothing.
26661 If the nickname is longer than six characters, only the first six characters are
26662 used.
26663 </DD>
26664
26665 <DT>_INIT_</DT>
26666 <DD>This token gets replaced with the initials of the sender of the message.
26667 </DD>
26668
26669 </DL>
26670
26671 NOTE: When the
26672 <A HREF="h_config_prefix_editing">&quot;<!--#echo var="FEAT_enable-reply-indent-string-editing"-->&quot;</A>
26673 feature is enabled, you are given the opportunity to edit the string, whether
26674 it is the default or one automatically generated using the above tokens.
26675 <P>
26676 If you change your <!--#echo var="VAR_reply-indent-string"-->
26677 so that it is not equal to the default value of &quot;&gt;&nbsp;&quot;, then
26678 quoted text will not be flowed
26679 (<A HREF="h_config_quell_flowed_text">Flowed Text</A>)
26680 when you reply.
26681 For this reason, we recommend that you leave your <!--#echo var="VAR_reply-indent-string"-->
26682 set to the default value.
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_quote_replace_string =====
26691 <HTML>
26692 <HEAD>
26693 <TITLE>OPTION: <!--#echo var="VAR_quote-replace-string"--></TITLE>
26694 </HEAD>
26695 <BODY>
26696 <H1>OPTION: <!--#echo var="VAR_quote-replace-string"--></H1>
26697
26698 This option specifies what string to use as a quote when <b>viewing</b> a
26699 message.  The standard way of quoting messages when replying is the string
26700 &quot;&gt;&nbsp;&quot; (quote space).
26701 With this variable set, viewing a message will
26702 replace occurrences of
26703 &quot;&gt;&nbsp;&quot; and &quot;&gt;&quot; with the replacement string.
26704 This setting works best when
26705 <A HREF="h_config_reply_indent_string"><!--#echo var="VAR_reply-indent-string"--></A>
26706 or the equivalent setting in your correspondents' mail programs
26707 is set to the default
26708 &quot;&gt;&nbsp;&quot;, but it will also work fine with the
26709 <!--#echo var="VAR_reply-indent-string"--> set to &quot;&gt;&quot;.
26710 <P>
26711 By default, this setting will only work on messages that are flowed, which is
26712 the default way of sending messages for many mail clients including
26713 Alpine.  Enable the feature
26714 <A HREF="h_config_quote_replace_noflow"><!--#echo var="FEAT_quote-replace-nonflowed"--></A>
26715 to also have quote-replacement performed on non-flowed messages.
26716 <P>
26717
26718 Setting this option will replace  &quot;&gt;&quot; and
26719 &quot;&gt;&nbsp;&quot; with the new setting. This string may include trailing
26720 spaces. To preserve those spaces enclose the full string in double quotes.
26721 <P>
26722 No padding to separate the text of the message from the quote string is
26723 added. This means that if you do not add trailing spaces to the value of
26724 this variable, text will be displayed right next to the quote string,
26725 which may be undesirable. This can be avoided by adding a new string
26726 separated by a space from your selection of quote string replacement. This
26727 last string will be used for padding. For example, setting this variable to
26728 <br>&quot;&gt;&quot; &quot; &quot; has the effect of setting
26729 &quot;&gt;&quot; as the <!--#echo var="VAR_quote-replace-string"-->, with the text padded by
26730 a space from the last quote string to make it more readable.
26731 <P>
26732 One possible setting for this variable could be
26733 &quot;&nbsp;&nbsp;&nbsp;&nbsp;&quot; (four spaces wrapped in quotes), which
26734 would have the effect of indenting each level of quoting four spaces and
26735 removing the &quot;&gt;&quot;'s.  Different levels of quoting could be made
26736 more discernible by setting colors for quoted text.
26737 <P>
26738 Replying to or forwarding the viewed message will preserve the original
26739 formatting of the message, so quote-replacement will not be performed on
26740 messages that are being composed.
26741 <P>
26742 <UL>
26743 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26744 </UL><P>
26745 &lt;End of help on this topic&gt;
26746 </BODY>
26747 </HTML>
26748 ====== h_config_empty_hdr_msg =====
26749 <HTML>
26750 <HEAD>
26751 <TITLE>OPTION: <!--#echo var="VAR_empty-header-message"--></TITLE>
26752 </HEAD>
26753 <BODY>
26754 <H1>OPTION: <!--#echo var="VAR_empty-header-message"--></H1>
26755
26756 When sending, if both the To and Cc fields are empty and you
26757 are sending the message to a Bcc,
26758 Alpine will put a special address in the To line.  The default value is:
26759
26760 <P>
26761 <CENTER><SAMP>undisclosed-recipients:&nbsp;;</SAMP></CENTER>
26762
26763 <P>
26764 The reason for this is to avoid embarrassment caused by some Internet
26765 mail transfer software that interprets a &quot;missing&quot;
26766 <SAMP>To:</SAMP> header as an error and replaces it with an
26767 <SAMP>Apparently-to:</SAMP> header that may contain the addresses you
26768 entered on the <SAMP>Bcc:</SAMP> line, defeating the purpose of the
26769 Bcc.  You may change the part of this message that comes before the
26770 &quot;:&nbsp;;&quot; by setting the &quot;<!--#echo var="VAR_empty-header-message"-->&quot;
26771 variable to something else.
26772
26773 <P>
26774 The normal default is &quot;undisclosed-recipients&quot;.
26775
26776 <P>
26777 <UL>
26778 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26779 </UL><P>
26780 &lt;End of help on this topic&gt;
26781 </BODY>
26782 </HTML>
26783 ====== h_config_status_msg_delay =====
26784 <HTML>
26785 <HEAD>
26786 <TITLE>OPTION: <!--#echo var="VAR_status-message-delay"--></TITLE>
26787 </HEAD>
26788 <BODY>
26789 <H1>OPTION: <!--#echo var="VAR_status-message-delay"--></H1>
26790
26791 This option has evolved over time, causing the possible values to be
26792 counter-intuitive.
26793 Read carefully before you set this option.
26794 First we explain what the option does, then there is a longer discussion
26795 following that.
26796 <P>
26797 If this is set to zero, the default value, it has <EM>no</EM> effect.
26798 Positive and negative values serve two similar, but different purposes.
26799 <P>
26800 If it is set to a positive number, it causes the cursor to move to the
26801 status line whenever a status message is printed and pause there for this
26802 many seconds.
26803 It will probably only be useful if the
26804 <A HREF="h_config_show_cursor">&quot;<!--#echo var="FEAT_show-cursor"-->&quot;</A> feature is
26805 also turned on.
26806 Setting this option to a positive number can only be used to
26807 <EM>increase</EM> the status message delay.
26808 This may be useful for Braille displays, or other non-traditional displays.
26809 <P>
26810 If it is set to a negative number the interpretation is a bit complicated.
26811 Negative numbers are used to <EM>decrease</EM> the amount of delay Alpine uses to
26812 allow you to read important status messages.
26813 Of course, this may cause you to miss some important messages.
26814 If you see a message flash by but miss what it says you can use the
26815 Journal command from the MAIN MENU to read it.
26816 If you set this option to a negative value, the delay will be
26817 no more than one second less than the absolute value
26818 of the value you set.
26819 So if you set it to -1, the delay will be no more than zero seconds, no
26820 delay at all.
26821 If you set it to -2, the delay will be no more than 1 second.
26822 And so on, -3 is 2 seconds, -4 is 3 seconds, ...
26823 If the delay that Alpine would have used by default is less than this delay,
26824 then the smaller delay set by Alpine will be used.
26825 Setting this option to a negative value can only reduce the amount of
26826 delay, never increase it.
26827 <P>
26828 Here is a more detailed explanation.
26829 Status messages are the messages that show up spontaneously in the
26830 status message line, usually the third line from the bottom of the screen.
26831 By default, Alpine assigns each status message it produces a minimum
26832 display time.
26833 Some status messages have a minimum display time of zero.
26834 You can see an example of such a message by paging up in this help text
26835 until you reach the top of the screen.
26836 If you try to page past the top you will see the message
26837 <P>
26838 <CENTER><SAMP>[Already at start of help text]</SAMP></CENTER>
26839 <P>
26840 in the status line.
26841 If there is another more important use of the status message line this message
26842 might be replaced quickly, or it even might not be shown at all.
26843 However, if there is no reason to get rid of the message, it might stay
26844 there for several seconds while you read the help.
26845 An example where it is replaced immediately happens when you page up in
26846 the help text past the top of the screen, but then type the &quot;WhereIs&quot;
26847 command right after paging up.
26848 The message will disappear immediately without causing a delay (unless you
26849 have set this option to a positive value) to allow you to type input for
26850 the &quot;WhereIs&quot; command.
26851 Since it isn't a very important message, Alpine has set its minimum display
26852 time to zero seconds.
26853 <P>
26854 Other messages have minimum display times of three or more seconds.
26855 These are usually error messages that Alpine thinks you ought to see.
26856 For example, it might be a message about a failed Save or a failed folder open.
26857 It is often the case that this minimum display time won't delay you in
26858 any way because the status message line is not needed for another reason.
26859 However, there are times when Alpine has to delay what it is doing in
26860 order to display a status message for the minimum display time.
26861 This happens when a message is being displayed and Alpine wants to ask
26862 for input from the keyboard.
26863 For example, when you Save a message you use the status message line.
26864 You get a prompt there asking for the name of the folder to save to.
26865 If there is a status message being displayed that has not
26866 yet displayed for its minimum
26867 time Alpine will display that status message surrounded with the characters
26868 &gt; and &lt; to show you that it is delaying.
26869 That might happen, for example, if you tried to save to a folder that
26870 caused an error, then followed that immediately with another Save command.
26871 You might find yourself waiting for a status message like
26872 <P>
26873 <CENTER><SAMP>[&gt;Can't get write access to mailbox, access is readonly&lt;]</SAMP></CENTER>
26874 <P>
26875 to finish displaying for three seconds.
26876 If that is something you find happening to you frequently, you may use
26877 negative values of this option to decrease or eliminate that delay, at
26878 the risk of missing the message.
26879 <P>
26880 <UL>
26881 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26882 </UL><P>
26883 &lt;End of help on this topic&gt;
26884 </BODY>
26885 </HTML>
26886 ====== h_config_active_msg_interval =====
26887 <HTML>
26888 <HEAD>
26889 <TITLE>OPTION: <!--#echo var="VAR_busy-cue-rate"--></TITLE>
26890 </HEAD>
26891 <BODY>
26892 <H1>OPTION: <!--#echo var="VAR_busy-cue-rate"--></H1>
26893
26894 When Alpine is delayed for some reason it usually shows that
26895 something is happening with a small animated display in the status
26896 message line near the bottom of the screen.
26897 This option sets how frequently the characters (for example, a spinning bar)
26898 in the active status message lines are updated.
26899 At most, it can be set to be updated 20 times per second.
26900
26901 <P>
26902 Setting this value to zero will prevent display of the animations
26903 altogether.
26904
26905 <P>
26906 The option <A HREF="h_config_use_boring_spinner"><!--#echo var="FEAT_busy-cue-spinner-only"--></A>
26907 can be used to remove the randomness from this animated display.
26908
26909 <P>
26910 <UL>
26911 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26912 </UL><P>
26913 &lt;End of help on this topic&gt;
26914 </BODY>
26915 </HTML>
26916 ====== h_config_mailchecknoncurr =====
26917 <HTML>
26918 <HEADER>
26919 <TITLE>OPTION: <!--#echo var="VAR_mail-check-interval-noncurrent"--></TITLE>
26920 </HEADER>
26921 <BODY>
26922 <H1>OPTION: <!--#echo var="VAR_mail-check-interval-noncurrent"--></H1>
26923
26924 This option is closely related to the
26925 <A HREF="h_config_mailcheck">&quot;<!--#echo var="VAR_mail-check-interval"-->&quot;</A>
26926 option, as well as the
26927 <A HREF="h_config_quell_checks_comp">&quot;<!--#echo var="FEAT_quell-mailchecks-composing-except-inbox"-->&quot;</A> and
26928 <A HREF="h_config_quell_checks_comp_inbox">&quot;<!--#echo var="FEAT_quell-mailchecks-composing-inbox"-->&quot;</A> options.
26929 If the &quot;<!--#echo var="VAR_mail-check-interval"-->&quot; option is set to zero, then automatic
26930 new-mail checking is disabled and this option will have no effect.
26931 <P>
26932 Normally this option is set to zero, which means that the value used will be
26933 the same as the value for the &quot;<!--#echo var="VAR_mail-check-interval"-->&quot;.
26934 If you set this option to a value different from zero
26935 (usually larger than the value for &quot;<!--#echo var="VAR_mail-check-interval"-->&quot;)
26936 then that is the check interval that will be used
26937 for folders that are not the currently open folder or the INBOX.
26938 You may not even have any folders that are noncurrent and not the INBOX.
26939 If you do, it is likely that they are due to
26940 <A HREF="h_config_permlocked">&quot;<!--#echo var="VAR_stay-open-folders"-->&quot;</A>
26941 you have configured.
26942 This option also affects the rate of mail checking done on cached
26943 connections to folders you previously had open but are no longer actively
26944 using.
26945 You aren't expected to understand that last sentence, but if you are interested
26946 take a look at
26947 <A HREF="h_config_maxremstream">&quot;<!--#echo var="VAR_max-remote-connections"-->&quot;</A>
26948 and the related options.
26949 <P>
26950 <UL>
26951 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
26952 </UL><P>
26953 &lt;End of help on this topic&gt;
26954 </BODY>
26955 </HTML>
26956 ====== h_config_fifopath =====
26957 <HTML>
26958 <HEADER>
26959 <TITLE>OPTION: NewMail FIFO Path</TITLE>
26960 </HEADER>
26961 <BODY>
26962 <H1>OPTION: NewMail FIFO Path</H1>
26963
26964 This option is only available in UNIX Alpine.
26965 However, there is a very similar feature built in to PC-Alpine.
26966 In PC-Alpine's Config menu at the top of the screen
26967 is an option called &quot;New Mail Window&quot;.
26968 <P>
26969 You may have Alpine create a FIFO special file (also called a named pipe) where
26970 it will send a one-line message each time a new message is received in
26971 the current folder, the INBOX, or any open
26972 <A HREF="h_config_permlocked"><!--#echo var="VAR_stay-open-folders"--></A>.
26973 To protect against two different Alpines both writing to the same FIFO, Alpine
26974 will only create the FIFO and write to it if it doesn't already exist.
26975 <P>
26976 A possible way to use this option would be to have a separate window
26977 on your screen running the command
26978 <P>
26979 <CENTER><SAMP>cat filename</SAMP></CENTER>
26980 <P>
26981 where &quot;filename&quot; is the name of the file given for this option.
26982 Because the file won't exist until after you start Alpine, you must <EM>first</EM>
26983 start Alpine and <EM>then</EM> run the &quot;cat&quot; command.
26984 You may be tempted to use &quot;tail -f filename&quot; to view the new
26985 mail log.
26986 However, the common implementations of the tail command will not do what you
26987 are hoping.
26988 <P>
26989 The width of the messages produced for the FIFO may be altered with the
26990 <A HREF="h_config_newmailwidth"><!--#echo var="VAR_newmail-window-width"--></A> option.
26991 <P>
26992 On some systems, fifos may only be created in a local filesystem.
26993 In other words, they may not be in NFS filesystems.
26994 This requirement is not universal.
26995 If the system you are using supports it, it should work.
26996 (It is often the case that your home directory is in an NFS filesystem.
26997 If that is the case, you might try using a file in the &quot;/tmp&quot;
26998 filesystem, which is usually a local filesystem.)
26999 Even when it is possible to use an NFS-mounted filesystem as a place to name
27000 the fifo (for example, your home directory), it will still be the case that
27001 the reader (probably the &quot;cat&quot; command) and the
27002 writer (Alpine) of the fifo must be running on the same system.
27003 <P>
27004 <UL>
27005 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27006 </UL><P>
27007 &lt;End of help on this topic&gt;
27008 </BODY>
27009 </HTML>
27010 ====== h_config_newmailwidth =====
27011 <HTML>
27012 <HEADER>
27013 <TITLE>OPTION: <!--#echo var="VAR_newmail-window-width"--></TITLE>
27014 </HEADER>
27015 <BODY>
27016 <H1>OPTION: <!--#echo var="VAR_newmail-window-width"--></H1>
27017
27018 For UNIX Alpine, this option is only useful if you have turned on the
27019 <A HREF="h_config_fifopath">NewMail FIFO Path</A> option.
27020 That option causes new mail messages to be sent to a fifo file.
27021 Those messages will be 80 characters wide by default.
27022 You can change the width of those messages by changing this option.
27023 For example, if you are reading those messages in another window you might
27024 want to set this width to the width of that other window.
27025 <P>
27026 If you are using PC-Alpine, it has an option in the Config menu to turn
27027 on the &quot;New Mail Window&quot;.
27028 This present option also controls the width of that window.
27029 <P>
27030 <UL>
27031 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27032 </UL><P>
27033 &lt;End of help on this topic&gt;
27034 </BODY>
27035 </HTML>
27036 ====== h_config_mailcheck =====
27037 <HTML>
27038 <HEADER>
27039 <TITLE>OPTION: <!--#echo var="VAR_mail-check-interval"--></TITLE>
27040 </HEADER>
27041 <BODY>
27042 <H1>OPTION: <!--#echo var="VAR_mail-check-interval"--></H1>
27043
27044 This option specifies, in seconds,
27045 how often Alpine will check for new mail.
27046 If set to zero, new-mail checking is disabled.
27047 (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
27048 current message is the last message of the folder.)
27049 There is a minimum value for this option, normally 15 seconds.
27050 The default value is normally 150 seconds.
27051 The higher you set this option, the easier it is on the server.
27052 <P>
27053 There are some situations where automatic new-mail checking does not work.
27054 See the discussion about new-mail checking in
27055 <A HREF="h_config_reopen_rule">&quot;<!--#echo var="VAR_folder-reopen-rule"-->&quot;</A>.
27056 <P>
27057 The new-mail checking will not happen exactly at the frequency that you specify.
27058 For example, Alpine may elect to defer a non-INBOX mail check if you
27059 are busy typing.
27060 Or, it may check more frequently than you have specified if that is
27061 thought to be necessary to keep the server from closing the connection
27062 to the folder due to inactivity.
27063 If Alpine checks for new mail as a side effect of another command, it will reset
27064 the timer, so that new-mail checking may seem to happen irregularly instead of
27065 every X seconds like clockwork.
27066 <P>
27067 If you are anxious to know about new mail as soon as possible, set the check
27068 interval low, and you'll know about the new mail by approximately
27069 that amount of time after it arrives.
27070 If you aren't so worried about knowing right away, set this option to a
27071 higher value.
27072 That will save the server some processing time and may save you some of
27073 the time you spend waiting for new-mail checks to happen if you are
27074 dealing with a slow server or slow network connection.
27075 <P>
27076 If you suspect that new-mail checking is causing slow downs for you,
27077 you may want to look into the options
27078 <A HREF="h_config_quell_checks_comp">&quot;<!--#echo var="FEAT_quell-mailchecks-composing-except-inbox"-->&quot;</A>,
27079 <A HREF="h_config_quell_checks_comp_inbox">&quot;<!--#echo var="FEAT_quell-mailchecks-composing-inbox"-->&quot;</A> and
27080 <A HREF="h_config_mailchecknoncurr">&quot;<!--#echo var="VAR_mail-check-interval-noncurrent"-->&quot;</A>,
27081 which refine when mail checking is done.
27082 <P>
27083 If the mailbox being checked uses a <A HREF="h_maildrop">Mail Drop</A> then
27084 there is a minimum time
27085 (<A HREF="h_config_maildropcheck">&quot;<!--#echo var="VAR_maildrop-check-minimum"-->&quot;</A>)
27086 between new-mail checks.
27087 Because of this minimum you may notice that new mail does not
27088 appear promptly when you expect it.
27089 The reason for this is to protect the server from over-zealous opening and
27090 closing of the Mail Drop folder, since that is a costly operation.
27091 <P>
27092 <UL>
27093 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27094 </UL><P>
27095 &lt;End of help on this topic&gt;
27096 </BODY>
27097 </HTML>
27098 ====== h_config_quell_checks_comp =====
27099 <HTML>
27100 <HEAD>
27101 <TITLE>FEATURE: <!--#echo var="FEAT_quell-mailchecks-composing-except-inbox"--></TITLE>
27102 </HEAD>
27103 <BODY>
27104 <H1>FEATURE: <!--#echo var="FEAT_quell-mailchecks-composing-except-inbox"--></H1>
27105
27106 This option is closely related to the
27107 <A HREF="h_config_mailcheck">&quot;<!--#echo var="VAR_mail-check-interval"-->&quot;</A>
27108 option, the
27109 <A HREF="h_config_mailchecknoncurr">&quot;<!--#echo var="VAR_mail-check-interval-noncurrent"-->&quot;</A> option, and
27110 <A HREF="h_config_quell_checks_comp_inbox">&quot;<!--#echo var="FEAT_quell-mailchecks-composing-inbox"-->&quot;</A>.
27111 <P>
27112 If this option is set, then the normal new-mail checking that happens
27113 while you are composing will not happen for folders other than your
27114 INBOX (which depends on the setting
27115 of &quot;<!--#echo var="FEAT_quell-mailchecks-composing-inbox"-->&quot;).
27116 <P>
27117 You might want to set this option if you are experiencing delays while
27118 composing that you think might be related to the speed of the new-mail
27119 checks.
27120 <P>
27121 Even with this option turned on, an occasional new-mail check may be done
27122 in order to keep the server from killing the connection to the folder.
27123 For example, IMAP servers may remove a connection to a folder if there
27124 has been no activity on the connection for 30 minutes or more.
27125 Instead of letting that happen, Alpine will check for new mail before the
27126 30 minutes is up even though you have turned on this feature to quell
27127 those checks.
27128 <P>
27129 Besides new-mail checks, checkpoint operations on the folders
27130 will also be quelled when you set this option.
27131 The purpose of checkpointing is to write the changes to a folder out to
27132 disk periodically in order to avoid losing those changes when system or
27133 software problems occur.
27134 New-mail checking and checkpointing while you are not composing are not
27135 affected by this option.
27136
27137 <P>
27138 &lt;End of help on this topic&gt;
27139 </BODY>
27140 </HTML>
27141 ====== h_config_quell_checks_comp_inbox =====
27142 <HTML>
27143 <HEAD>
27144 <TITLE>FEATURE: <!--#echo var="FEAT_quell-mailchecks-composing-inbox"--></TITLE>
27145 </HEAD>
27146 <BODY>
27147 <H1>FEATURE: <!--#echo var="FEAT_quell-mailchecks-composing-inbox"--></H1>
27148
27149 This option is closely related to the
27150 <A HREF="h_config_mailcheck">&quot;<!--#echo var="VAR_mail-check-interval"-->&quot;</A>
27151 option, the
27152 <A HREF="h_config_mailchecknoncurr">&quot;<!--#echo var="VAR_mail-check-interval-noncurrent"-->&quot;</A> option, and
27153 <A HREF="h_config_quell_checks_comp">&quot;<!--#echo var="FEAT_quell-mailchecks-composing-except-inbox"-->&quot;</A>.
27154 <P>
27155 If this option is set, then the normal new-mail checking that happens
27156 while you are composing will not happen for your INBOX.
27157 Checking of other folders is controlled in a similar way with the
27158 &quot;<!--#echo var="FEAT_quell-mailchecks-composing-except-inbox"-->&quot; option.
27159 <P>
27160 You might want to set this option if you are experiencing delays while
27161 composing that you think might be related to the speed of the new-mail
27162 checks.
27163 <P>
27164 Even with this option turned on, an occasional new-mail check may be done
27165 in order to keep the server from killing the connection to the folder.
27166 For example, IMAP servers may remove a connection to a folder if there
27167 has been no activity on the connection for 30 minutes or more.
27168 Instead of letting that happen, Alpine will check for new mail before the
27169 30 minutes is up even though you have turned on this feature to quell
27170 those checks.
27171 <P>
27172 Besides new-mail checks, checkpoint operations on the INBOX
27173 will also be quelled when you set this option.
27174 The purpose of checkpointing is to write the changes to a folder out to
27175 disk periodically in order to avoid losing those changes when system or
27176 software problems occur.
27177 New-mail checking and checkpointing while you are not composing are not
27178 affected by this option.
27179 <P>
27180 &lt;End of help on this topic&gt;
27181 </BODY>
27182 </HTML>
27183 ====== h_config_maildropcheck =====
27184 <HTML>
27185 <HEADER>
27186 <TITLE>OPTION: <!--#echo var="VAR_maildrop-check-minimum"--></TITLE>
27187 </HEADER>
27188 <BODY>
27189 <H1>OPTION: <!--#echo var="VAR_maildrop-check-minimum"--></H1>
27190
27191 New-mail checking for a
27192 <A HREF="h_maildrop">Mail Drop</A> is a little different from new
27193 mail checking for a regular folder.
27194 One of the differences is that the connection to the Mail Drop is not
27195 kept open and so the cost of checking
27196 (delay for you and additional load for the server) may be significant.
27197 Because of this additional cost we set a minimum time that
27198 must pass between checks.
27199 This minimum only applies to the automatic checking done by Alpine.
27200 If you force a check by typing ^L (Ctrl-L) or by typing the Next command when you are
27201 at the end of a folder index, then the check is done right away.
27202 <P>
27203 This option specifies, in seconds, the <EM>minimum</EM> time between Mail Drop
27204 new-mail checks.
27205 You may want to set this minimum high in order to avoid experiencing some
27206 of the delays associated with the checks.
27207 Note that the time between checks is still controlled by the regular
27208 <A HREF="h_config_mailcheck"><!--#echo var="VAR_mail-check-interval"--></A> option.
27209 When Alpine is about to do an automatic check for new mail (because
27210 the <!--#echo var="VAR_mail-check-interval"--> has expired) then if the time since the last
27211 new-mail check
27212 of any open Mail Drops has been greater than the <!--#echo var="VAR_maildrop-check-minimum"-->,
27213 the Mail Drop is checked for new mail as well.
27214 Therefore, it is only useful to set this option to a value that is higher
27215 than the <!--#echo var="VAR_mail-check-interval"-->.
27216 <P>
27217 If this option is set to zero, automatic Mail Drop new-mail
27218 checking is disabled.
27219 There is a minimum value, normally 60 seconds.
27220 The default value is normally 60 seconds as well.
27221 This applies to the INBOX and to the currently open folder if that is
27222 different from the INBOX.
27223
27224 <P>
27225 <UL>
27226 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27227 </UL><P>
27228 &lt;End of help on this topic&gt;
27229 </BODY>
27230 </HTML>
27231 ====== h_config_nntprange =====
27232 <HTML>
27233 <HEADER>
27234 <TITLE>OPTION: <!--#echo var="VAR_nntp-range"--></TITLE>
27235 </HEADER>
27236 <BODY>
27237 <H1>OPTION: <!--#echo var="VAR_nntp-range"--></H1>
27238
27239 This option applies only to newsgroups accessed using the NNTP protocol.
27240 It does not, for example,
27241 apply to newsgroups accessed using an IMAP-to-NNTP proxy.
27242
27243 <P>
27244 When you open a connection to a News server using the NNTP protocol, you
27245 normally have access to all of the articles in each newsgroup.
27246 If a server keeps a large backlog of messages it may speed performance
27247 some to restrict attention to only the newer messages in a group.
27248 This option allows you to set how many article numbers should be checked
27249 when opening a newsgroup.
27250 You can think of &quot;<!--#echo var="VAR_nntp-range"-->&quot; as specifying the maximum number
27251 of messages you ever want to see.
27252 For example, if you only ever wanted to look at the last 500 messages in each
27253 newsgroup you could set this option to 500.
27254 In actuality, it isn't quite that.
27255 Instead, for performance reasons, it specifies the range of article
27256 numbers to be checked, beginning
27257 with the highest numbered article and going backwards from there.
27258 If there are messages that have been canceled or deleted
27259 their article numbers are still counted as part of the range.
27260 <P>
27261 So, more precisely, setting the &quot;<!--#echo var="VAR_nntp-range"-->&quot; will cause article
27262 numbers
27263 <P><CENTER>last_article_number - <!--#echo var="VAR_nntp-range"--> + 1 through last_article_number</CENTER>
27264 <P>
27265 to be considered when reading a newsgroup.
27266 The number of messages that show up in your index will be less than or equal
27267 to the value of &quot;<!--#echo var="VAR_nntp-range"-->&quot;.
27268
27269 <P>
27270 The purpose of this option is simply to speed up access when reading news.
27271 The speedup comes because Alpine can ignore all but the last <!--#echo var="VAR_nntp-range"--> article
27272 numbers, and can avoid downloading any information about the ignored articles.
27273 There is a cost you pay for this speedup.
27274 That cost is that there is no way for you to see those ignored articles.
27275 The articles that come before the range you specify are invisible to you and
27276 to Alpine, as if they did not exist at all.
27277 There is no way to see those messages using, for example, an unexclude command
27278 or something similar.
27279 The only way to see those articles is to set this option high enough (or
27280 set it to zero) and then to reopen the newsgroup.
27281
27282 <P>
27283 If this option is set to 0 (which is also the default),
27284 then the range is unlimited.
27285 This option applies globally to all NNTP servers and to all newsgroups
27286 on those servers.
27287 There is no way to set different values for different newsgroups or servers.
27288
27289 <P>
27290 <UL>
27291 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27292 </UL><P>
27293 &lt;End of help on this topic&gt;
27294 </BODY>
27295 </HTML>
27296 ====== h_config_news_active =====
27297 <html>
27298 <header>
27299 <title>OPTION: <!--#echo var="VAR_news-active-file-path"--></title>
27300 </header>
27301 <body>
27302 <h1>OPTION: <!--#echo var="VAR_news-active-file-path"--></h1>
27303
27304 This option tells Alpine where to look for the "active file" for newsgroups
27305 when accessing news locally, rather than via NNTP.  The default path is
27306 usually "/usr/lib/news/active".<p>
27307 <UL>
27308 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27309 </UL><P>
27310 &lt;End of help on this topic&gt;
27311 </body>
27312 </html>
27313 ====== h_config_news_spool =====
27314 <html>
27315 <header>
27316 <title>OPTION: <!--#echo var="VAR_news-spool-directory"--></title>
27317 </header>
27318 <body>
27319 <h1>OPTION: <!--#echo var="VAR_news-spool-directory"--></h1>
27320
27321 This option tells Alpine where to look for the "news spool" for newsgroups
27322 when accessing news locally, rather than via NNTP.  The default path is
27323 usually "/var/spool/news".<p>
27324 <UL>
27325 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27326 </UL><P>
27327 &lt;End of help on this topic&gt;
27328 </body>
27329 </html>
27330 ====== h_config_image_viewer =====
27331 <html>
27332 <header>
27333 <title>OPTION: <!--#echo var="VAR_image-viewer"--></title>
27334 </header>
27335 <body>
27336 <h1>OPTION: <!--#echo var="VAR_image-viewer"--></h1>
27337 <body>
27338 This option specifies the program Alpine should call to view MIME
27339 attachments of type IMAGE (e.g. GIF or TIFF).  The Image Viewer setting is
27340 no longer needed, but remains for backward compatibility.  The more
27341 general method for associating external printing and viewing programs with
27342 specific MIME data types is to use the system's (or your personal)
27343 "mailcap" configuration file.<p>
27344 <UL>
27345 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27346 </UL><P>
27347 &lt;End of help on this topic&gt;
27348 </body>
27349 </html>
27350 ====== h_config_domain_name =====
27351 <HTML>
27352 <HEAD>
27353 <TITLE>OPTION: <!--#echo var="VAR_use-only-domain-name"--></TITLE>
27354 </HEAD>
27355 <BODY>
27356 <H1>OPTION: <!--#echo var="VAR_use-only-domain-name"--></H1>
27357
27358 This option is used only if the
27359 <A HREF="h_config_user_dom">&quot;<!--#echo var="VAR_user-domain"-->&quot;</A> option is <B>not</B>
27360 set.  If set to &quot;Yes&quot; (and <!--#echo var="VAR_user-domain"--> is not used), then Alpine
27361 strips the hostname from your return (&quot;From&quot;) address and when
27362 completing unqualified addresses that you enter into the composer.
27363 <P>
27364 If you set this, see also the <A HREF="h_config_quell_local_lookup">
27365 &quot;<!--#echo var="FEAT_quell-user-lookup-in-passwd-file"-->&quot;</A> feature.
27366
27367
27368 <!--chtml if pinemode="os_windows"-->
27369 <P>This option is not applicable to PC-Alpine.
27370 <!--chtml else-->
27371 <P>
27372 <!--chtml endif-->
27373 <UL>
27374 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27375 </UL>
27376 <P>
27377 &lt;End of help on this topic&gt;
27378 </BODY>
27379 </HTML>
27380 ====== h_config_prune_date =====
27381 <HTML>
27382 <HEAD>
27383 <TITLE>OPTION: Last-Time-Prune Question</TITLE>
27384 </HEAD>
27385 <BODY>
27386 <H1>OPTION: Last-Time-Prune Question</H1>
27387
27388 This value records the last time you were asked about deleting old
27389 sent-mail.
27390 It is set automatically by Alpine at the beginning of each month.
27391 In the past, if you wished to suppress the monthly sent-mail
27392 pruning feature, you could set this to a date in the future.
27393 This value is relative to the year 1900, so
27394 to set this, for example, to October 2005, use 105.10.
27395 <P>
27396 You can still do that if you wish, or you can use the
27397 <A HREF="h_config_pruning_rule"><!--#echo var="VAR_pruning-rule"--></A> option, which is probably
27398 a little more convenient to use.
27399 <P>
27400 <UL>
27401 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27402 </UL><P>
27403 &lt;End of help on this topic&gt;
27404 </BODY>
27405 </HTML>
27406 ====== h_config_goto_default =====
27407 <HTML>
27408 <HEAD>
27409 <TITLE>OPTION: <!--#echo var="VAR_goto-default-rule"--></TITLE>
27410 </HEAD>
27411 <BODY>
27412 <H1>OPTION: <!--#echo var="VAR_goto-default-rule"--></H1>
27413
27414 This value affects Alpine's behavior when you use the Goto command.
27415 Alpine's usual behavior has two parts.  If your current folder is
27416 &quot;Inbox&quot;, Alpine will offer the last open folder as the
27417 default.  If the current folder is other than &quot;Inbox&quot;,
27418 &quot;Inbox&quot; is offered as the default.
27419
27420 <P>
27421 The available options include:
27422
27423 <DL>
27424
27425  <DT>folder-in-first-collection</DT>
27426
27427  <DD> Alpine will offer the most recently visited folder in the default
27428 collection found in the &quot;Collection List&quot; screen as the default.
27429 </DD>
27430
27431  <DT> inbox-or-folder-in-first-collection</DT>
27432
27433  <DD> If the current folder is &quot;Inbox&quot;,
27434 Alpine will offer the most recently visited folder in the
27435 default collection found in the &quot;Collection List&quot; screen.
27436 If the current folder is other than &quot;Inbox&quot;,
27437 &quot;Inbox&quot; is offered as the default.
27438 </DD>
27439
27440  <DT> inbox-or-folder-in-recent-collection</DT>
27441
27442  <DD> This is Alpine's default behavior.
27443 If the current folder is &quot;Inbox&quot;,
27444 Alpine will offer the last open
27445 folder as the default.
27446 If the current folder is other than &quot;Inbox&quot;,
27447 &quot;Inbox&quot; is offered as the default.
27448 </DD>
27449
27450  <DT> first-collection-with-inbox-default</DT>
27451
27452  <DD> Instead of offering the most recently visited folder in the default
27453 collection, the default collection is offered but with &quot;Inbox&quot; as
27454 the default folder.
27455 If you type in a folder name it will be in the default collection.
27456 If you simply accept the default, however, your &quot;Inbox&quot; will be opened.
27457 </DD>
27458
27459  <DT> most-recent-folder</DT>
27460
27461  <DD> The last accepted value simply causes the most recently opened
27462 folder to be offered as the default regardless of the currently opened
27463 folder.
27464 </DD>
27465 </DL>
27466
27467 <P>
27468 NOTE: The default while a newsgroup is open remains the same; the last
27469 open newsgroup.
27470
27471 <P>
27472 <UL>
27473 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27474 </UL><P>
27475 &lt;End of help on this topic&gt;
27476 </BODY>
27477 </HTML>
27478 ====== h_config_thread_lastreply_char =====
27479 <HTML>
27480 <HEAD>
27481 <TITLE>OPTION: <!--#echo var="VAR_threading-lastreply-character"--></TITLE>
27482 </HEAD>
27483 <BODY>
27484 <H1>OPTION: <!--#echo var="VAR_threading-lastreply-character"--></H1>
27485
27486 The <!--#echo var="VAR_threading-lastreply-character"--> option has a small effect on the MESSAGE
27487 INDEX display when using a
27488 <A HREF="h_config_thread_disp_style"><!--#echo var="VAR_threading-display-style"--></A>
27489 of &quot;show-thread-structure&quot;, &quot;mutt-like&quot;, or
27490 &quot;show-structure-in-from&quot;; and sorting by Threads or OrderedSubject.
27491 The value of this option is a single character.
27492 This character is used instead of the vertical line character when there are
27493 no more replies directly to the parent of the current message.
27494 It can be used to &quot;round-off&quot; the bottom of the vertical line
27495 by setting it to a character such as a backslash (&#92;) or
27496 a backquote (&#96;).
27497 The default value of this option is the backslash character (&#92;).
27498 This option may not be set to the Empty Value.
27499 In that case, the default will be used instead.
27500
27501 <P>
27502 <UL>
27503 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27504 </UL><P>
27505 &lt;End of help on this topic&gt;
27506 </BODY>
27507 </HTML>
27508 ====== h_config_thread_indicator_char =====
27509 <HTML>
27510 <HEAD>
27511 <TITLE>OPTION: <!--#echo var="VAR_threading-indicator-character"--></TITLE>
27512 </HEAD>
27513 <BODY>
27514 <H1>OPTION: <!--#echo var="VAR_threading-indicator-character"--></H1>
27515
27516 The <!--#echo var="VAR_threading-indicator-character"--> option has a small effect on the MESSAGE
27517 INDEX display when using a
27518 <A HREF="h_config_thread_disp_style"><!--#echo var="VAR_threading-display-style"--></A> other
27519 than &quot;none&quot; and sorting by Threads or OrderedSubject.
27520 The value of this option is a single character.
27521 This character is used to indicate that part of a thread (a conversation) is
27522 hidden beneath a message.
27523 The message could be expanded
27524 if desired with the &quot;/&quot; Collapse/Expand command.
27525 By default, the value of this option is the greater than sign (&gt;).
27526 <P>
27527 If this option is set to the Empty Value, then the column (and the following
27528 blank column) will be deleted from the display.
27529
27530 <P>
27531 This option is closely related to the
27532 <A HREF="h_config_thread_exp_char"><!--#echo var="VAR_threading-expanded-character"--></A> option.
27533 Another similar option that affects the thread display is the
27534 <A HREF="h_config_thread_lastreply_char"><!--#echo var="VAR_threading-lastreply-character"--></A> option.
27535
27536 <P>
27537 <UL>
27538 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27539 </UL><P>
27540 &lt;End of help on this topic&gt;
27541 </BODY>
27542 </HTML>
27543 ====== h_config_thread_exp_char =====
27544 <HTML>
27545 <HEAD>
27546 <TITLE>OPTION: <!--#echo var="VAR_threading-expanded-character"--></TITLE>
27547 </HEAD>
27548 <BODY>
27549 <H1>OPTION: <!--#echo var="VAR_threading-expanded-character"--></H1>
27550
27551 The <!--#echo var="VAR_threading-expanded-character"--> option has a small effect on the MESSAGE
27552 INDEX display when using a
27553 <A HREF="h_config_thread_disp_style"><!--#echo var="VAR_threading-display-style"--></A> other
27554 than &quot;none&quot;.
27555 The value of this option is a single character.
27556 This character is used to indicate that part of a thread has been expanded
27557 and could be collapsed if desired with
27558 the &quot;/&quot; Collapse/Expand command.
27559 By default, the value of this option is a dot (.).
27560 <P>
27561 If this option is set to the Empty Value, then the column (and the following
27562 blank column) will be deleted from the display.
27563
27564 <P>
27565 This option is closely related to the
27566 <A HREF="h_config_thread_indicator_char"><!--#echo var="VAR_threading-indicator-character"--></A> option.
27567 Another similar option that affects the thread display is the
27568 <A HREF="h_config_thread_lastreply_char"><!--#echo var="VAR_threading-lastreply-character"--></A> option.
27569
27570 <P>
27571 <UL>
27572 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27573 </UL><P>
27574 &lt;End of help on this topic&gt;
27575 </BODY>
27576 </HTML>
27577 ====== h_config_thread_index_style =====
27578 <HTML>
27579 <HEAD>
27580 <TITLE>OPTION: <!--#echo var="VAR_threading-index-style"--></TITLE>
27581 </HEAD>
27582 <BODY>
27583 <H1>OPTION: <!--#echo var="VAR_threading-index-style"--></H1>
27584
27585 When a folder is sorted by Threads or OrderedSubject,
27586 this option will affect the INDEX displays.
27587 <P>
27588
27589 The possible values for this option are:
27590
27591 <DL>
27592 <DT>regular-index-with-expanded-threads</DT>
27593 <DD>This is the default display.
27594 If the configuration option
27595 <A HREF="h_config_thread_disp_style">&quot;<!--#echo var="VAR_threading-display-style"-->&quot;</A>
27596 is set to something other than &quot;none&quot;, then this setting
27597 will cause Alpine to start off with a MESSAGE INDEX with all of
27598 the threads expanded.
27599 That is, each message will have a line in the MESSAGE INDEX display.
27600 The Collapse/Expand command (/) may be used to manually collapse or
27601 expand a thread or subthread (see also <A HREF="h_config_slash_coll_entire">&quot;<!--#echo var="FEAT_slash-collapses-entire-thread"-->&quot;</A>).
27602 <P>
27603 This setting affects the display when the folder is first threaded.
27604 The collapsed state may also be re-initialized by re-sorting the folder manually
27605 using the SortIndex command ($).
27606 After re-sorting the threads will once again all be expanded, even if you
27607 have previously collapsed some of them.
27608 <P>
27609 If &quot;<!--#echo var="VAR_threading-display-style"-->&quot; is set to &quot;none&quot;, then
27610 the display will be the regular default Alpine MESSAGE INDEX, but sorted
27611 in a different order.
27612 </DD>
27613
27614 <DT>regular-index-with-collapsed-threads</DT>
27615 <DD>If the configuration option
27616 <A HREF="h_config_thread_disp_style">&quot;<!--#echo var="VAR_threading-display-style"-->&quot;</A>
27617 is set to something other than &quot;none&quot;, then this setting
27618 will cause Alpine to start out with all of the threads collapsed instead of
27619 starting out with all of the threads expanded.
27620 The Collapse/Expand command (/) may be used to manually collapse or
27621 expand a thread or subthread (see also <A HREF="h_config_slash_coll_entire">&quot;<!--#echo var="FEAT_slash-collapses-entire-thread"-->&quot;</A>).
27622 <P>
27623 This setting affects the display when the folder is first threaded.
27624 The collapsed state may also be re-initialized by re-sorting the folder manually
27625 using the SortIndex command ($).
27626 After re-sorting the threads will once again all be collapsed, even if you
27627 have previously expanded some of them.
27628 </DD>
27629
27630 <DT>separate-index-screen-always</DT>
27631 <DD>With this setting and the next, you will see an index of threads
27632 instead of an
27633 index of messages, provided you have sorted by Threads or OrderedSubject.
27634 <P>
27635 The THREAD INDEX contains a '*' in the first column if any message in the thread
27636 is marked Important.
27637 If not, it contains a '+' if any message in the thread is to you.
27638 The second column is blank. The third column contains a 'D' if all of the
27639 messages in the thread are deleted.
27640 Otherwise, it contains an 'N' if any of the messages in the thread are New.
27641 <P>
27642 When you view a particular thread from the THREAD INDEX you will be
27643 in the MESSAGE INDEX display
27644 but the index will only contain messages from the thread you are viewing.
27645 </DD>
27646
27647 <DT>separate-index-screen-except-for-single-messages</DT>
27648 <DD>This is very similar to the option above.
27649 When you are in the THREAD INDEX, one of the available commands
27650 is &quot;ViewThd&quot;.
27651 With the setting &quot;separate-index-screen-always&quot; (the option above)
27652 when you view a particular thread you will be in the
27653 MESSAGE INDEX display and the index will only contain messages from
27654 the thread you are viewing.
27655 If the thread you are viewing consists of a single message, the MESSAGE INDEX
27656 will be an index with only one message in it.
27657 If you use this &quot;separate-index-screen-except-for-single-messages&quot;
27658 setting instead, then that index that contains a single message
27659 will be skipped and you will go directly from the THREAD INDEX into the
27660 MESSAGE TEXT screen.
27661 </DD>
27662
27663 </DL>
27664
27665 <P>
27666 <UL>
27667 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27668 </UL><P>
27669 &lt;End of help on this topic&gt;
27670 </BODY>
27671 </HTML>
27672 ====== h_config_thread_disp_style =====
27673 <HTML>
27674 <HEAD>
27675 <TITLE>OPTION: <!--#echo var="VAR_threading-display-style"--></TITLE>
27676 </HEAD>
27677 <BODY>
27678 <H1>OPTION: <!--#echo var="VAR_threading-display-style"--></H1>
27679
27680 When a folder is sorted by Threads or OrderedSubject,
27681 this option will affect the MESSAGE INDEX display.
27682 By default, Alpine will display the MESSAGE INDEX in the
27683 &quot;show-thread-structure&quot; style if a folder is sorted
27684 by Threads or OrderedSubject.
27685 <P>
27686
27687 The possible values for this option are:
27688
27689 <DL>
27690 <DT>none</DT>
27691 <DD>Regular index display.
27692 The same index line as would be displayed without threading is used.
27693 The only difference will be in the order of the messages.
27694 </DD>
27695
27696 <DT>show-thread-structure</DT>
27697 <DD>Threaded Subjects will be indented and vertical bars and horizontal
27698 lines will be added to make it easier to see the relationships among
27699 the messages in a thread (a conversation).
27700 </DD>
27701
27702 <DT>mutt-like</DT>
27703 <DD>This is the same as the option above except that the Subject
27704 is suppressed (is blank) if it matches the previous Subject in the thread.
27705 The name comes from the email client <A HREF="http://www.mutt.org/">Mutt</A>.
27706 Here is an example of what a mutt-like index might look like.
27707 In this example, the first column represents the message number, the
27708 <A HREF="h_config_thread_index_style"><!--#echo var="VAR_threading-index-style"--></A>
27709 is set to &quot;regular-index-with-expanded-threads&quot;, and the
27710 <A HREF="h_config_thread_lastreply_char"><!--#echo var="VAR_threading-lastreply-character"--></A>
27711 is set to a backslash:
27712 <PRE>
27713 &nbsp;&nbsp;&nbsp;1    Some topic
27714 &nbsp;&nbsp;&nbsp;&nbsp;2  . Subject           original message in thread
27715 &nbsp;&nbsp;&nbsp;&nbsp;3    |->               reply to 2
27716 &nbsp;&nbsp;&nbsp;&nbsp;4  . |->               another reply to 2
27717 &nbsp;&nbsp;&nbsp;&nbsp;5  . | &#92;->             reply to 4
27718 &nbsp;&nbsp;&nbsp;&nbsp;6  . |   &#92;->           reply to 5
27719 &nbsp;&nbsp;&nbsp;&nbsp;7    |     &#92;->         reply to 6
27720 &nbsp;&nbsp;&nbsp;&nbsp;8    |->               another reply to 2
27721 &nbsp;&nbsp;&nbsp;&nbsp;9  . |->New subject    another reply to 2 but with a New subject
27722 &nbsp;&nbsp;&nbsp;10    | |->             reply to 9
27723 &nbsp;&nbsp;&nbsp;11    | &#92;->             another reply to 9
27724 &nbsp;&nbsp;&nbsp;12    |   &#92;->           reply to 11
27725 &nbsp;&nbsp;&nbsp;13    &#92;->               final reply to 2
27726 &nbsp;&nbsp;&nbsp;14    Next topic
27727 </PRE>
27728 </DD>
27729
27730 <DT>indent-subject-1</DT>
27731 <DD>Threaded Subjects will be indented one space per level of the conversation.
27732 The bars and lines that show up in the show-thread-structure display will
27733 not be there with this style.
27734 </DD>
27735
27736 <DT>indent-subject-2</DT>
27737 <DD>Same as above but indent two spaces per level instead of one space.
27738 </DD>
27739
27740 <DT>indent-from-1</DT>
27741 <DD>Similar to indent-subject-1, except that instead of indenting the
27742 Subject field one space the From field of a thread will be indented one
27743 space per level of the conversation.
27744 </DD>
27745
27746 <DT>indent-from-2</DT>
27747 <DD>Same as above but indent two spaces per level instead of one space.
27748 </DD>
27749
27750 <DT>show-structure-in-from</DT>
27751 <DD>The structure of the thread is illustrated with indenting, vertical bars,
27752 and horizontal lines just like with the show-thread-structure option, but
27753 the From field is used to show the relationships instead of the Subject field.
27754 </DD>
27755
27756 </DL>
27757
27758 <P>
27759 <UL>
27760 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27761 </UL><P>
27762 &lt;End of help on this topic&gt;
27763 </BODY>
27764 </HTML>
27765 ====== h_config_pruning_rule =====
27766 <HTML>
27767 <HEAD>
27768 <TITLE>OPTION: <!--#echo var="VAR_pruning-rule"--></TITLE>
27769 </HEAD>
27770 <BODY>
27771 <H1>OPTION: <!--#echo var="VAR_pruning-rule"--></H1>
27772
27773 By default, Alpine will ask at the beginning of each month whether or not
27774 you want to rename your sent-mail folder to a name like sent-mail-month-year.
27775 (See the feature <A HREF="h_config_prune_uses_iso"><!--#echo var="FEAT_prune-uses-yyyy-mm"--></A> to
27776 change the format of the folder to sent-mail-yyyy-mm.)
27777 It will also ask whether you would like to delete old sent-mail folders.
27778 If you have defined
27779 <A HREF="h_config_read_message_folder"><!--#echo var="VAR_read-message-folder"--></A>
27780 or
27781 <A HREF="h_config_pruned_folders"><!--#echo var="VAR_pruned-folders"--></A>
27782 Alpine will also ask about pruning those folders.
27783 <P>
27784
27785 With this option you may provide an automatic answer to these questions.
27786 The default value is to ask you what you'd like to do.
27787 <P>
27788
27789 The six possible values for this option are:
27790
27791 <DL>
27792 <DT>ask about rename, ask about deleting</DT>
27793 <DD>This is the default.
27794 Alpine will ask whether you want to rename the folders and whether you
27795 want to delete each of the old folders.
27796 </DD>
27797
27798 <DT>ask about rename, don't delete</DT>
27799 <DD>Alpine will ask whether you want to rename the folders, but won't
27800 ask about or delete old folders.
27801 </DD>
27802
27803 <DT>always rename, ask about deleting</DT>
27804 <DD>This means you want to always answer yes and have Alpine automatically
27805 rename the folder if possible.
27806 You will also be asked about deleting old folders.
27807 </DD>
27808
27809 <DT>always rename, don't delete</DT>
27810 <DD>This means you want to always answer yes and have Alpine automatically
27811 rename the folder if possible.
27812 There will be no deleting of old folders.
27813 </DD>
27814
27815 <DT>don't rename, ask about deleting</DT>
27816 <DD>This means you want to always answer no.
27817 Alpine will not rename the folder.
27818 You will be asked about deleting old folders.
27819 </DD>
27820
27821 <DT>don't rename, don't delete</DT>
27822 <DD>This means you want to always answer no.
27823 Alpine will not rename the folder.
27824 There will be no deleting of old folders, either.
27825 </DD>
27826 </DL>
27827
27828 <P>
27829 <UL>
27830 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27831 </UL><P>
27832 &lt;End of help on this topic&gt;
27833 </BODY>
27834 </HTML>
27835 ====== h_config_reopen_rule =====
27836 <HTML>
27837 <HEAD>
27838 <TITLE>OPTION: <!--#echo var="VAR_folder-reopen-rule"--></TITLE>
27839 </HEAD>
27840 <BODY>
27841 <H1>OPTION: <!--#echo var="VAR_folder-reopen-rule"--></H1>
27842
27843 Alpine normally checks for new mail in the currently open folder
27844 and in the INBOX every few <A HREF="h_config_mailcheck">minutes</A>.
27845
27846 <P>
27847 There are some situations where automatic new-mail checking does not work.
27848 For example, if a mail folder is opened using the POP protocol or a newsgroup
27849 is being read using the NNTP protocol, then new-mail checking is disabled.
27850
27851 <P>
27852 It may be possible to check for new mail in these cases by reopening the
27853 folder.
27854 Alpine does not do this for you automatically, but you may do the commands
27855 manually to cause this to happen.
27856 You reopen by going back to the folder list screen from the message
27857 index screen with the &quot;&lt;&quot; command,
27858 and then going back into the message index screen with
27859 the &quot;&gt;&quot; command.
27860 (Actually, any method you would normally use to open a folder will work the
27861 same as the &quot;&lt;&quot; followed by &quot;&gt;&quot; method.
27862 For example, the GoTo Folder command will work, or you may use L to go to the
27863 Folder List screen and Carriage Return to reopen the folder.)
27864
27865 <P>
27866 There are some cases where Alpine knows that reopening the folder should
27867 be useful as a way to discover new mail.
27868 At the time of this writing, connections made using the POP protocol,
27869 news reading using the NNTP protocol, local news reading, and local
27870 ReadOnly folders that are in the traditional UNIX or the MMDF format all
27871 fall into this category.
27872 There are other cases where it <EM>may</EM> be a way to discover new mail, but Alpine
27873 has no way of knowing, so it might also just be an exercise in futility.
27874 All remote, ReadOnly folders other than those listed just above fall into this
27875 category.
27876 The setting of this option together with the type of folder
27877 controls how Alpine will react to the apparent attempt to reopen a folder.
27878
27879 <P>
27880 If you don't reopen, then you will just be back in
27881 the message index with no change.
27882 You left the index and came back, but the folder remained &quot;open&quot;
27883 the whole time.
27884 However, if you do reopen the folder, the folder is closed and then reopened.
27885 In this case, the current state of the open folder is lost.
27886 The New status, Important and Answered flags,
27887 selected state, Zoom state, collapsed or expanded state of threads,
27888 current message number,
27889 and any other temporary state is all lost when the reopen happens.
27890 For POP folders (but not NNTP newsgroups) the Deleted flags are also lost.
27891
27892 <P>
27893 In the possibilities listed below, the text says &quot;POP/NNTP&quot; in
27894 several places.
27895 That really implies the case where Alpine knows it is a good way to discover
27896 new mail, which is more than just POP and NNTP, but POP and NNTP are
27897 the cases of most interest.
27898 This option probably has more possible values than it deserves. They are:
27899
27900 <DL>
27901 <DT>Always reopen</DT>
27902 <DD>Alpine will not ask whether you want to reopen but will just do the reopen
27903 whenever you type a command that implies a reopen, regardless of the
27904 access method.
27905 In other words, it is assumed you would always answer Yes if asked
27906 about reopening.
27907 </DD>
27908
27909 <DT>Yes for POP/NNTP, Ask about other remote [Yes]</DT>
27910 <DD>Alpine will assume a Yes answer if the access method is POP or NNTP, but
27911 will ask you whether to reopen other remote folders,
27912 with a default answer of Yes.
27913 </DD>
27914
27915 <DT>Yes for POP/NNTP, Ask about other remote [No]</DT>
27916 <DD>Alpine will assume a Yes answer if the access method is POP or NNTP, but
27917 will ask you whether to reopen other remote folders,
27918 with a default answer of No.
27919 </DD>
27920
27921 <DT>Yes for POP/NNTP, No for other remote</DT>
27922 <DD>Alpine will assume a Yes answer if the access method is POP or NNTP, and
27923 will assume a No answer for all other remote folders.
27924 </DD>
27925
27926 <DT>Always ask [Yes]</DT>
27927 <DD>Alpine will not differentiate based on access method.
27928 It will always ask for all remote folders, with a default answer of Yes.
27929 </DD>
27930
27931 <DT>Always ask [No]</DT>
27932 <DD>Alpine will not differentiate based on access method.
27933 It will always ask for all remote folders, with a default answer of No.
27934 </DD>
27935
27936 <DT>Ask about POP/NNTP [Yes], No for other remote</DT>
27937 <DD>Alpine will ask if the access method is POP or NNTP, with a default answer
27938 of Yes.
27939 It will never attempt to reopen other remote folders.
27940 </DD>
27941
27942 <DT>Ask about POP/NNTP [No], No for other remote</DT>
27943 <DD>This is the default.
27944 Alpine will ask if the access method is POP or NNTP, with a default answer
27945 of No.
27946 It will never attempt to reopen other remote folders.
27947 </DD>
27948
27949 <DT>Never reopen</DT>
27950 <DD>Alpine will never attempt to reopen already open folders.
27951 </DD>
27952 </DL>
27953
27954 <P>
27955 Remember, wherever it says POP or NNTP above it really means POP or NNTP or
27956 any of the other situations where it is likely that reopening is a good way
27957 to discover new mail.
27958
27959 <P>
27960 There is an alternative that may be of useful in some situations.
27961 Instead of manually checking for new mail you can set up a
27962 <A HREF="h_maildrop">Mail Drop</A>
27963 and automatically check for new mail.
27964
27965 <P>
27966 <UL>
27967 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
27968 </UL><P>
27969 &lt;End of help on this topic&gt;
27970 </BODY>
27971 </HTML>
27972 ====== h_config_inc_startup =====
27973 <HTML>
27974 <HEAD>
27975 <TITLE>OPTION: <!--#echo var="VAR_incoming-startup-rule"--></TITLE>
27976 </HEAD>
27977 <BODY>
27978 <H1>OPTION: <!--#echo var="VAR_incoming-startup-rule"--></H1>
27979
27980 This value affects Alpine's behavior when opening the &quot;INBOX&quot; or
27981 one of the &quot;INCOMING MESSAGE FOLDERS&quot;.
27982 It determines which message will be the <EM>current message</EM> when
27983 the folder is first opened.
27984 The default value is &quot;first-unseen&quot;.
27985
27986 <P>
27987 The seven possible values for this option are:
27988
27989 <DL>
27990 <DT>first-unseen</DT>
27991 <DD>The current message is set to the first
27992 unseen message that has not been marked deleted, or the last message if
27993 all of the messages have been seen previously.
27994 Messages which have not been seen or which have been seen but re-marked
27995 as New are considered unseen messages.
27996 See the note at the bottom of this help about newsgroups.
27997 </DD>
27998
27999 <DT>first-recent</DT>
28000 <DD>Similar to the default, but rather than starting on the first
28001 unseen message Alpine starts on the first <EM>recent</EM> message.
28002 A message is recent if it arrived since the last time the folder was
28003 open.  This value causes the current message to be set to the first
28004 recent message if there is one, otherwise to the last
28005 message in the folder.
28006 </DD>
28007
28008 <DT>first-important</DT>
28009 <DD>This will result in the current message being set to the first
28010 message marked Important (but not Deleted).
28011 If no messages are marked Important, then it will be the last message.
28012 Messages are marked Important by <EM>you</EM>, not by the sender, using
28013 the
28014 <A HREF="h_common_flag">Flag command</A>.
28015 Or they may be marked Important by an Alpine
28016 <A HREF="h_mainhelp_filtering">Filter</A>
28017 that you have set up.
28018 </DD>
28019
28020 <DT>first-important-or-unseen</DT>
28021 <DD>This selects the first of the first unseen and the first important
28022 messages.
28023 </DD>
28024
28025 <DT>first-important-or-recent</DT>
28026 <DD>This selects the first of the first recent and the first important
28027 messages.
28028 </DD>
28029
28030 <DT>first</DT>
28031 <DD>Simply starts you on the <EM>first</EM> undeleted message in the folder.
28032 If all messages are deleted you start on the last message.
28033 </DD>
28034
28035 <DT>last</DT>
28036 <DD>Simply starts you on the <EM>last</EM> undeleted message in the folder
28037 If all messages are deleted you start on the last message.
28038 </DD>
28039 </DL>
28040
28041 <P>
28042 NOTE:  For newsgroups in the incoming collection, &quot;first-unseen&quot; and
28043 &quot;first-recent&quot; are the same and are affected by whether or not the
28044 feature
28045 <A HREF="h_config_news_uses_recent">&quot;<!--#echo var="FEAT_news-approximates-new-status"-->&quot;</A>
28046 is turned on.
28047 Also, there is no permanent storage in news for an Important flag.
28048 This means that no messages will be marked Important when a newsgroup is
28049 first opened.
28050
28051 <P>
28052 <UL>
28053 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28054 </UL><P>
28055 &lt;End of help on this topic&gt;
28056 </BODY>
28057 </HTML>
28058 ====== h_config_browser =====
28059 <HTML>
28060 <HEAD>
28061 <TITLE>OPTION: <!--#echo var="VAR_url-viewers"--></TITLE>
28062 </HEAD>
28063 <BODY>
28064 <H1>OPTION: <!--#echo var="VAR_url-viewers"--></H1>
28065 <!--chtml if pinemode="os_windows"-->
28066 PC-Alpine users do not need to enter anything here, unless:<UL>
28067 <LI> they want to override, for use with Alpine, the application defined
28068 in the Windows operating system for handling URLs; or
28069 <LI> they are (planning on) using the same configuration file with
28070 Unix Alpine.
28071 </UL>
28072 <P>
28073 Note that if using a viewer that has a space in its path, you should
28074 use the DOS name for that directory or file. Example:
28075 <PRE>
28076 url-viewer=C:&#92;Progra~1&#92;mozilla&#92;mozilla.exe
28077 </PRE>
28078 <HR><P>
28079 <!--chtml endif-->
28080 This option affects Alpine's handling of URLs that are found in
28081 messages you read.  Normally, only URLs Alpine can handle directly
28082 are automatically offered for selection in the &quot;Message
28083 Text&quot; screen.  When one or more applications
28084 capable of deciphering URLs on their command line are added here, Alpine
28085 will choose the first available to display URLs it cannot handle directly.
28086 A viewer's availability is based on its being specified with a <B>full
28087 directory path</B> and the evaluation of any optionally supplied
28088 parameters described below.
28089
28090 <P>
28091 Additionally, to support various connection methods and applications, each
28092 entry in this list can optionally begin with one or more of
28093 the following special tokens.  The allowed tokens include:
28094
28095 <P>
28096 <DL>
28097 <DT>_TEST(<VAR>test-string</VAR>)_</DT>
28098 <DD>
28099 The <VAR>test-string</VAR> is a shell command that Alpine will run to
28100 evaluate a viewer's availability.  The command specified by the test
28101 string is run and if its resulting exit status is non-zero, Alpine will
28102 not consider the associated viewer for use.
28103 </DD>
28104
28105 <DT>_SCHEME(<VAR>scheme-list</VAR>)_</DT>
28106 <DD>
28107 The <VAR>scheme-list</VAR> is a list of one or more (comma-delimited)
28108 URL schemes that are to be used with the associated viewer.  This is
28109 the way to configure Alpine to recognize URLs other than the built-in set.
28110 <P>
28111 It can also be used to override Alpine's built-in handlers.
28112 For example, you could specify &quot;news&quot; in the <VAR>scheme-list</VAR>,
28113 and Alpine would use (provided it passed all other criteria) the associated
28114 viewer when it encountered a URL of the form &quot;news:comp.mail.pine&quot;.
28115
28116 </DD>
28117 </DL>
28118
28119 <P>
28120 By default, Alpine will simply append a space character followed by the
28121 selected URL prior to launching the command in your specified SHELL.  You can
28122 optionally specify where in the command the selected URL should appear
28123 by using the &quot;_URL_&quot; token.  All occurrences found in the command
28124 will be replaced with the selected URL before the command is handed
28125 to the shell.  If such replacement occurs, the default appending of the
28126 selected URL does not take place.
28127
28128 <P>
28129 NOTE: If the viewer you specify has any command-line arguments,
28130 including the &quot;_URL_&quot; token, you will need to add a
28131 double-quote character before the command path and after the last
28132 argument (see the &quot;lynx&quot; example below).
28133
28134 <P>
28135 So, here are some example entries:
28136 <PRE>
28137 url-viewers = _TEST(&quot;test -n '$&#123;DISPLAY}'&quot;)_  /usr/local/bin/netscape
28138               &quot;/usr/local/bin/lynx _URL_&quot;
28139               C:&#92;BIN&#92;NETSCAPE.BAT
28140 </PRE>
28141 <P>
28142 This example shows that for the first viewer in the list to be used
28143 the environment variable &quot;DISPLAY&quot; must be defined.  If it
28144 is, then the path and file &quot;/usr/local/bin/netscape&quot; must exist.
28145 If neither condition is met,
28146 then the path and file &quot;/usr/local/bin/lynx&quot; must exist.
28147 If it does, then the &quot;_URL_&quot; token is replaced by the selected URL.
28148 If the path to &quot;lynx&quot; is invalid,
28149 then the final path and file C:&#92;BIN&#92;NETSCAPE.BAT must exist.
28150 Note that the last
28151 entry is a DOS/Windows path.  This is one way to support Alpine running
28152 on more than one architecture with the same configuration file.<P>
28153 <P>
28154 <!--chtml if pinemode="os_windows"-->
28155 <!--chtml else-->
28156 Note that depending on the type of browser used and the method of
28157 its invocation (such as whether it will open in a separate window) from
28158 the MESSAGE TEXT screen, the browser may &quot;supplant&quot;
28159 the MESSAGE TEXT screen, and you will have to quit the browser to return to
28160 it (for example, when using Lynx; to exit Lynx, use the &quot;Q&quot; command).
28161 In other words, launching the browser from Alpine may make Alpine
28162 &quot;disappear&quot; (although it is still &quot;running&quot;)
28163 until you close the browser again.<P>
28164 <UL><LI><A HREF="h_config_browser_xterm">Defining <!--#echo var="VAR_url-viewers"--> in an X windows
28165 environment: for advanced users and  systems administrators</A>
28166 </UL>
28167 <!--chtml endif-->
28168 <P>If you are unsure what browsers are available on your system or how to
28169 specify them in Alpine's <!--#echo var="VAR_url-viewers"--> option for best usability, contact your
28170 local computing support staff.
28171 <P><UL>
28172 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28173 </UL>
28174 <P>
28175 &lt;End of help on this topic&gt;
28176 </BODY>
28177 </HTML>
28178 ====== h_config_history =====
28179 <HTML>
28180 <HEAD>
28181 <TITLE>OPTION: <!--#echo var="VAR_default-directories"--></TITLE>
28182 </HEAD>
28183 <BODY>
28184 <H1>OPTION: <!--#echo var="VAR_default-directories"--></H1>
28185 <P>
28186 This option allows you to input a list of directories that Alpine will offer
28187 for you to use when you are saving or exporting attachments. This is useful
28188 when navigating to specific directories becomes too tedious, or when you
28189 need to do this on a daily basis, and want Alpine to remember this on a
28190 permanent basis.
28191 <P>
28192 The list of directories saved here can be accessed using the ^Y and ^V commands
28193 in the save prompt for attachments, or the export command.
28194
28195 <P><UL>
28196 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28197 </UL>
28198 <P>
28199 &lt;End of help on this topic&gt;
28200 </BODY>
28201 </HTML>
28202 ====== h_config_browser_xterm =====
28203 <HTML>
28204 <HEAD>
28205 <TITLE><!--#echo var="VAR_url-viewers"--> and X windows applications</TITLE>
28206 </HEAD>
28207 <BODY>
28208 <H1>Defining <!--#echo var="VAR_url-viewers"--> in an X windows
28209 environment: for advanced users and  systems administrators</H1>
28210 If you are using Alpine with an X-terminal (emulator) and want to define an
28211 X windows-based application in <!--#echo var="VAR_url-viewers"-->,
28212 you may want to do so in a manner that causes any <B>already</B>
28213 invoked viewer application to be used for viewing URLs you select from Alpine
28214 messages, and a <B>new</B> URL-viewer process to be
28215 started <B>only</B> if the same application has <B>not already</B>
28216 been launched -- for one reason, to avoid file-locking contentions among
28217 multiple invocations of the same URL-viewer application.
28218 (The example entries set in the help screen for the &quot;<!--#echo var="VAR_url-viewers"-->&quot;
28219 option does not do this.)  A method of doing that would be:<OL>
28220 <LI> use
28221 the _TEST(<VAR>test-string</VAR>)_ token in the <B>first</B> entry to
28222 check (using commands appropriate for your Unix shell
28223 in place of <VAR>test-string</VAR>) for the presence of a
28224 lockfile created by the URL-viewer application -- which implies that the
28225 application is already running, though this is not foolproof.
28226 Following that in the same <!--#echo var="VAR_url-viewers"--> entry, specify the
28227 application with its appropriate command line option(s) to
28228 show the URL selected from the Alpine message in an already open window of
28229 that application, or perhaps in a new window of that application.
28230
28231 <LI> In the
28232 <B>second</B> entry for the <!--#echo var="VAR_url-viewers"--> option, specify the same
28233 application without those command line options, but this time using the
28234 _TEST(...)_ token to check whether the environment variable &quot;DISPLAY&quot;
28235 is defined.
28236 <LI> If you will be using Alpine (with the same .pinerc file) outside of the X
28237 windows environment (for instance, using VT-100 terminal emulation), you
28238 may wish to specify a non-X windows URL-viewer application such as Lynx
28239 as the last entry.
28240 </OL><BR>
28241 How exactly you define your <!--#echo var="VAR_url-viewers"--> entries to do this will depend on
28242 the command shell, the URL-viewer application(s), and possibly the specific
28243 version of the latter, you are using.
28244 <P>
28245 Relevant command
28246 line options for the Netscape browser for showing URLs (selected from Alpine)
28247 when Netscape is already running are discussed in the document
28248 &quot;Remote Control of UNIX Netscape&quot;
28249 found at the URL (as of 12 Aug. 1998):
28250 <P>
28251
28252 <CENTER><A HREF="http://home.netscape.com/newsref/std/x-remote.html">http://home.netscape.com/newsref/std/x-remote.html</A></CENTER>
28253
28254 <P>(If the URL-viewer application is
28255 <B>not</B> running on the same host as Alpine, but being launched from an
28256 applications server, you may not be able to use the command line options for
28257 using an existing invocation of the application in Alpine's <!--#echo var="VAR_url-viewers"--> entry.)
28258 <P>
28259 <!--chtml if this-method="shown-to-work"-->
28260 An example using the Korn shell and the Netscape browser (first entry wrapped
28261 because of its length, but should all appear on one line):
28262 <P>
28263 url-viewers = _TEST("test -L /myhomedir/.netscape/lock")_ &quot;/usr/local/bin/netscape -remote 'openURL(_URL_,  new-window)' &amp;&quot;<BR>
28264
28265 _TEST(&quot;test -n '$&#123;DISPLAY}'&quot;)_ &quot;/usr/local/bin/netscape &amp;&quot;<BR>
28266               &quot;/usr/local/bin/lynx '_URL_'&quot;
28267 <P>
28268 <!--chtml endif-->
28269 <P>
28270 <UL>
28271 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28272 </UL><P>
28273 &lt;End of help on this topic&gt;
28274 </BODY>
28275 </HTML>
28276 ====== h_config_enable_full_hdr =====
28277 <HTML>
28278 <HEAD>
28279 <TITLE>FEATURE: <!--#echo var="FEAT_enable-full-header-cmd"--></TITLE>
28280 </HEAD>
28281 <BODY>
28282 <H1>FEATURE: <!--#echo var="FEAT_enable-full-header-cmd"--></H1>
28283
28284 This feature enables the &quot;H Full Headers&quot; command which toggles between
28285 the display of all headers in the message and the normal edited view of
28286 headers.  The Full Header command also controls which headers are included
28287 for Export, Pipe, Print, Forward, and Reply functions.  (For Reply, the
28288 Full Header mode will respect the
28289 <A HREF="h_config_include_header">&quot;Include-Headers-in-Reply&quot;</A>
28290 feature setting.)
28291 <P>
28292 If Full Header mode is turned on and you Forward a message, you will
28293 be asked if you'd like to forward the message as an attachment, as opposed
28294 to including the text of the message in the body of your new message.
28295 <P>
28296 If you have also turned on the
28297 <A HREF="h_config_quote_suppression">&quot;Quote Suppression&quot;</A>
28298 option then the Full Headers command actually rotates through three states
28299 instead of just two.
28300 The first is the normal view with long quotes suppressed.
28301 The second is the normal view but with the long quotes included.
28302 The last enables the display of all headers in the message.
28303 When using Export, Pipe, Print, Forward, or Reply the quotes are
28304 never suppressed, so the first two states are identical.
28305 <P>
28306 Normally, the Header Mode will reset
28307 to the default behavior when moving to a new message.
28308 The mode can be made to persist from message to message by setting the feature
28309 <A HREF="h_config_quell_full_hdr_reset"><!--#echo var="FEAT_quell-full-header-auto-reset"--></A>.
28310 <P>
28311 <UL>
28312 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28313 </UL><P>
28314 &lt;End of help on this topic&gt;
28315 </BODY>
28316 </HTML>
28317 ====== h_config_enable_full_hdr_and_text =====
28318 <HTML>
28319 <HEAD>
28320 <TITLE>FEATURE: <!--#echo var="FEAT_enable-full-header-and-text"--></TITLE>
28321 </HEAD>
28322 <BODY>
28323 <H1>FEATURE: <!--#echo var="FEAT_enable-full-header-and-text"--></H1>
28324
28325 This feature affects how the &quot;H Full Headers&quot; command displays
28326 message text.  If set, the raw message text will be displayed.  This
28327 especially affects MIME formatted email, where the entire MIME format
28328 will be displayed.  This feature similarly affects how messages are
28329 included for the Export, Pipe, Print, Forward, and Reply functions.
28330 <P>
28331 When viewing a raw message that has attachments with this feature set,
28332 you will not be able to view attachments without first leaving full
28333 headers mode.  This is because MIME parsing is not done on the raw message.
28334 <P>
28335 <UL>
28336 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28337 </UL><P>
28338 &lt;End of help on this topic&gt;
28339 </BODY>
28340 </HTML>
28341 ====== h_config_enable_pipe =====
28342 <HTML>
28343 <HEAD>
28344 <TITLE>FEATURE: <!--#echo var="FEAT_enable-unix-pipe-cmd"--></TITLE>
28345 </HEAD>
28346 <BODY>
28347 <H1>FEATURE: <!--#echo var="FEAT_enable-unix-pipe-cmd"--></H1>
28348
28349 This feature enables the "| Pipe" command that sends the current message
28350 to the specified command for external processing.
28351 <P>
28352
28353 A short description of how the pipe command works is given
28354 <A HREF="h_pipe_command">here</A>.
28355
28356 <P>
28357 <UL>
28358 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28359 </UL><P>
28360 &lt;End of help on this topic&gt;
28361 </BODY>
28362 </HTML>
28363 ====== h_config_quell_full_hdr_reset =====
28364 <HTML>
28365 <HEAD>
28366 <TITLE>FEATURE: <!--#echo var="FEAT_quell-full-header-auto-reset"--></TITLE>
28367 </HEAD>
28368 <BODY>
28369 <H1>FEATURE: <!--#echo var="FEAT_quell-full-header-auto-reset"--></H1>
28370
28371 The <A HREF="h_common_hdrmode">HdrMode Command</A>
28372 normally resets to the default state when switching to a new message.
28373 For example, if you've used the &quot;H&quot; command to turn on Full
28374 Headers for a message you are viewing, and then you type the Next command
28375 to look at the next message, the full headers will no longer be shown.
28376 Setting this feature disables that reset.
28377 Instead, the Header Mode remains the same from message to message.
28378
28379 <P>
28380 The presence or absence of the HdrMode command is determined by the
28381 <A HREF="h_config_enable_full_hdr">&quot;<!--#echo var="FEAT_enable-full-header-cmd"-->&quot;</A>
28382 Feature-List option.
28383 <P>
28384 <UL>
28385 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28386 </UL><P>
28387 &lt;End of help on this topic&gt;
28388 </BODY>
28389 </HTML>
28390 ====== h_config_enable_tab_complete =====
28391 <HTML>
28392 <HEAD>
28393 <TITLE>FEATURE: <!--#echo var="FEAT_enable-tab-completion"--></TITLE>
28394 </HEAD>
28395 <BODY>
28396 <H1>FEATURE: <!--#echo var="FEAT_enable-tab-completion"--></H1>
28397
28398 This feature enables the TAB key when at a prompt for a filename. In this
28399 case, TAB will cause the partial name already entered to be automatically
28400 completed, provided the partial name is unambiguous.
28401 This feature is on by default.
28402 <P>
28403 Similarly, this feature also enables TAB completion of address book
28404 nicknames when at a prompt for a nickname,
28405 or when typing in an address field in the composer.
28406 <P>
28407 &lt;End of help on this topic&gt;
28408 </BODY>
28409 </HTML>
28410 ====== h_config_quit_wo_confirm =====
28411 <HTML>
28412 <HEAD>
28413 <TITLE>FEATURE: <!--#echo var="FEAT_quit-without-confirm"--></TITLE>
28414 </HEAD>
28415 <BODY>
28416 <H1>FEATURE: <!--#echo var="FEAT_quit-without-confirm"--></H1>
28417
28418 This feature controls whether or not Alpine will ask for confirmation when a
28419 Quit command is received.
28420 <P>
28421 &lt;End of help on this topic&gt;
28422 </BODY>
28423 </HTML>
28424 ====== h_config_quote_replace_noflow =====
28425 <HTML>
28426 <HEAD>
28427 <TITLE>FEATURE: <!--#echo var="FEAT_quote-replace-nonflowed"--></TITLE>
28428 </HEAD>
28429 <BODY>
28430 <H1>FEATURE: <!--#echo var="FEAT_quote-replace-nonflowed"--></H1>
28431
28432 This feature, which is only active when
28433 <A HREF="h_config_quote_replace_string"><!--#echo var="VAR_quote-replace-string"--></A> is
28434 also set,
28435 enables quote-replacement on non-flowed messages.  It is off
28436 by default because a non-flowed message is more dependent on its format,
28437 and thus quote-replacement may cause less-than-pleasing results.
28438 Setting this feature will cause quote-replacement similar to that of flowed
28439 messages, but with the added possibility of long lines being wrapped
28440 into new lines if the Quote-Replacement-String is longer than the string
28441 it is replacing, which is &quot;&gt;&nbsp;&quot;.
28442 <P>
28443 &lt;End of help on this topic&gt;
28444 </BODY>
28445 </HTML>
28446 ====== h_config_enable_jump =====
28447 <HTML>
28448 <HEAD>
28449 <TITLE>FEATURE: <!--#echo var="FEAT_enable-jump-shortcut"--></TITLE>
28450 </HEAD>
28451 <BODY>
28452 <H1>FEATURE: <!--#echo var="FEAT_enable-jump-shortcut"--></H1>
28453
28454 When this feature is set you may enter a number (followed by RETURN)
28455 and jump to that message number, when in the MESSAGE INDEX or MESSAGE TEXT
28456 screens.  In other words, it obviates the need for typing the "J" for the
28457 Jump command.
28458 <P>
28459 &lt;End of help on this topic&gt;
28460 </BODY>
28461 </HTML>
28462 ====== h_config_enable_alt_ed =====
28463 <HTML>
28464 <HEAD>
28465 <TITLE>FEATURE: <!--#echo var="FEAT_enable-alternate-editor-cmd"--></TITLE>
28466 </HEAD>
28467 <BODY>
28468 <H1>FEATURE: <!--#echo var="FEAT_enable-alternate-editor-cmd"--></H1>
28469
28470 If this feature is set (the default), and the
28471 <A HREF="h_config_editor">&quot;<!--#echo var="VAR_editor"-->&quot;</A> option
28472 <B>is not</B> set, entering
28473 the ^_ (Ctrl-underscore) key while composing a message will prompt you
28474 for the name of the editor you would like to use.
28475 <P>
28476 If the environment variable $EDITOR is set, its value will be offered as
28477 a default.
28478 <P>
28479 If the <A HREF="h_config_editor">&quot;<!--#echo var="VAR_editor"-->&quot;</A> option
28480 <B>is</B> set, the ^_ key will activate the specified
28481 editor without prompting, in which case it is not necessary to
28482 set the &quot;<!--#echo var="FEAT_enable-alternate-editor-cmd"-->&quot; feature.
28483 <P>
28484 <UL>
28485 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28486 </UL><P>
28487 &lt;End of help on this topic&gt;
28488 </BODY>
28489 </HTML>
28490 ====== h_config_alt_ed_now =====
28491 <HTML>
28492 <HEAD>
28493 <TITLE>FEATURE: <!--#echo var="FEAT_enable-alternate-editor-implicitly"--></TITLE>
28494 </HEAD>
28495 <BODY>
28496 <H1>FEATURE: <!--#echo var="FEAT_enable-alternate-editor-implicitly"--></H1>
28497
28498 If this feature and the <A HREF="h_config_editor">&quot;<!--#echo var="VAR_editor"-->&quot;</A>
28499 variable are both set, Alpine will
28500 automatically activate the specified editor when the cursor is moved from
28501 the header of the message being composed into the message text.  For
28502 replies, the alternate editor will be activated immediately.  If this
28503 feature is set but the &quot;<!--#echo var="VAR_editor"-->&quot; variable is not set, then Alpine will
28504 automatically ask for the name of an alternate editor when the cursor
28505 is moved out of the header being composed, or if a reply is being done.
28506
28507 <P><UL>
28508 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28509 </UL>
28510 <P>
28511 &lt;End of help on this topic&gt;
28512 </BODY>
28513 </HTML>
28514 ====== h_config_enable_bounce =====
28515 <HTML>
28516 <HEAD>
28517 <TITLE>FEATURE: <!--#echo var="FEAT_enable-bounce-cmd"--></TITLE>
28518 </HEAD>
28519 <H1>FEATURE: <!--#echo var="FEAT_enable-bounce-cmd"--></H1>
28520 <BODY>
28521
28522 Setting this feature enables the "B Bounce" command, which will prompt
28523 for an address and *remail* the message to the new recipient.  This command
28524 is used to re-direct messages that you have received in error, or need to
28525 be redirected for some other reason (e.g. list moderation).  The final
28526 recipient will see a header indicating that you have Resent the msg, but
28527 the message's From: header will show the original author of the message,
28528 and replies to it will go back to that author, and not to you.
28529 <P>
28530 &lt;End of help on this topic&gt;
28531 </BODY>
28532 </HTML>
28533 ====== h_config_enable_agg_ops =====
28534 <HTML>
28535 <HEAD>
28536 <TITLE>FEATURE: <!--#echo var="FEAT_enable-aggregate-command-set"--></TITLE>
28537 </HEAD>
28538 <BODY>
28539 <H1>FEATURE: <!--#echo var="FEAT_enable-aggregate-command-set"--></H1>
28540
28541 When this feature is set you may use the commands and subcommands that relate to
28542 performing operations on more than one message at a time.  We call these
28543 &quot;aggregate operations&quot;.  In particular, the
28544 <!--chtml if pinemode="function_key"-->&quot;F5
28545 <!--chtml else-->&quot;;
28546 <!--chtml endif--> Select&quot;,
28547
28548 <!--chtml if pinemode="function_key"-->
28549 &quot;F6
28550 <!--chtml else-->
28551 &quot;A
28552 <!--chtml endif-->
28553 Apply&quot;, and
28554 <!--chtml if pinemode="function_key"-->
28555 &quot;F4
28556 <!--chtml else-->
28557 &quot;Z
28558 <!--chtml endif-->
28559 Zoom&quot; commands are enabled by this feature.  Select is used to
28560 &quot;tag&quot; one or more messages meeting the specified criteria.  Apply can
28561 then be used to apply any message command to all of the selected/tagged
28562 messages.  Further, the Zoom command allows you to toggle the MESSAGE INDEX
28563 view between just those Selected and all messages in the folder.
28564 <P>
28565 This feature also enables the
28566 <!--chtml if pinemode="function_key"-->
28567 &quot;F7&quot;
28568 <!--chtml else-->
28569 &quot;^X&quot;
28570 <!--chtml endif-->
28571
28572 subcommand in the MESSAGE INDEX
28573 WhereIs command that causes all messages matching the WhereIs argument to
28574 become selected; and the Select, Select Current, and ZoomMode commands in the
28575 <A HREF="h_folder_maint">FOLDER LIST screen</A>.
28576 <P>
28577 Some related help topics are
28578 <UL>
28579 <LI> <A HREF="h_mainhelp_aggops">Aggregate Operations</A>
28580 <LI> <A HREF="h_index_cmd_select">Selecting: Select and WhereIs/Select</A>,
28581 <LI> <A HREF="h_config_auto_unzoom"><!--#echo var="FEAT_auto-unzoom-after-apply"--></A>,
28582 <LI> <A HREF="h_config_auto_unselect"><!--#echo var="FEAT_auto-unselect-after-apply"--></A>.
28583 <LI> <A HREF="h_config_auto_zoom"><!--#echo var="FEAT_auto-zoom-after-select"--></A>, and
28584 <LI> <A HREF="h_config_select_wo_confirm"><!--#echo var="FEAT_select-without-confirm"--></A>.
28585 </UL>
28586 <P>
28587 <UL>
28588 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28589 </UL><P>
28590 &lt;End of help on this topic&gt;
28591 </BODY>
28592 </HTML>
28593
28594 ====== h_config_enable_flag =====
28595 <HTML>
28596 <HEAD>
28597 <TITLE>FEATURE: <!--#echo var="FEAT_enable-flag-cmd"--></TITLE>
28598 </HEAD>
28599 <BODY>
28600 <H1>FEATURE: <!--#echo var="FEAT_enable-flag-cmd"--></H1>
28601
28602 Setting this feature enables the
28603 <A HREF="h_common_flag">&quot;* Flag&quot;</A>
28604 command that allows you to
28605 manipulate the status flags associated with a message.  By default, Flag
28606 will set the "Important" flag, which results in an asterisk being
28607 displayed in column one of the MESSAGE INDEX for such messages.
28608 <P>
28609 &lt;End of help on this topic&gt;
28610 </BODY>
28611 </HTML>
28612 ====== h_config_flag_screen_default =====
28613 <HTML>
28614 <HEAD>
28615 <TITLE>FEATURE: <!--#echo var="FEAT_enable-flag-screen-implicitly"--></TITLE>
28616 </HEAD>
28617 <BODY>
28618 <H1>FEATURE: <!--#echo var="FEAT_enable-flag-screen-implicitly"--></H1>
28619
28620 The feature modifies the behavior of the
28621 <a href="h_common_flag">Flag</a>
28622 command (provided it too is
28623 <A HREF="h_config_enable_flag">enabled</A>).
28624 By default, when the "* Flag" command is selected,
28625 Alpine offers a prompt to set one of several flags and also offers the
28626 option of entering the detailed flag manipulation screen via the "^T"
28627 key. Enabling this feature causes Alpine to immediately enter the detailed
28628 flag screen rather than first offer the simple prompt.
28629 The
28630 <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.
28631 <P>
28632 &lt;End of help on this topic&gt;
28633 </BODY>
28634 </HTML>
28635 ====== h_config_flag_screen_kw_shortcut =====
28636 <HTML>
28637 <HEAD>
28638 <TITLE>FEATURE: <!--#echo var="FEAT_enable-flag-screen-keyword-shortcut"--></TITLE>
28639 </HEAD>
28640 <BODY>
28641 <H1>FEATURE: <!--#echo var="FEAT_enable-flag-screen-keyword-shortcut"--></H1>
28642
28643 This feature modifies the behavior of the
28644 <a href="h_common_flag">Flag</a> command
28645 and the <A HREF="h_index_cmd_select">Select</A> command.
28646 This feature is set by default.
28647 When this feature is not set, when the "* Flag" command is selected,
28648 Alpine offers a prompt to set one of several flags and also offers the
28649 option of entering the detailed flag manipulation screen via the "^T"
28650 key.
28651 If you have
28652 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>
28653 defined, then enabling this feature adds a shortcut way to set or unset
28654 keywords.
28655 You use &quot;*&quot; followed by the first letter of a keyword (or the nickname of
28656 a keyword if you've given it a nickname) and that will set the keyword.
28657 <P>
28658 An example is easier to understand than the explanation.
28659 The flag command can always be used to set the system flags.
28660 For example, to set the Answered flag you would type
28661 <P>
28662 <CENTER><SAMP>* A</SAMP></CENTER>
28663 <P>
28664 Now suppose you have defined a keyword &quot;Work&quot; using the <!--#echo var="VAR_keywords"-->
28665 option in the Config screen.
28666 By default, to set a keyword like &quot;Work&quot; you would usually
28667 have to go to the Flag Details screen using
28668 the &quot;^T To Flag Details&quot; command.
28669 Instead, if you have enabled this feature, you may type
28670 <P>
28671 <CENTER><SAMP>* W</SAMP></CENTER>
28672 <P>
28673 to set the Work flag, or
28674 <P>
28675 <CENTER><SAMP>* ! W</SAMP></CENTER>
28676 <P>
28677 to unset it.
28678 Just like for the other flag setting commands, the case of the letter does
28679 not matter, so &quot;w&quot; or &quot;W&quot; both set the &quot;Work&quot;
28680 keyword.
28681 <P>
28682 Notice that you can only use this trick for one keyword that begins
28683 with &quot;W&quot;.
28684 If you happen to have a &quot;Work&quot; keyword and another keyword that is
28685 &quot;WIFI&quot; the &quot;* W&quot; command will set the first one in
28686 your list of keywords.
28687 Also, there are five letters that are reserved for system
28688 flags and the NOT command.
28689 If you type &quot;* A&quot; it will always set the Answered flag, not
28690 your &quot;Aardvark&quot; keyword.
28691 In order to set the &quot;Aardvark&quot; keyword you'll still have to use
28692 the Flag Details screen.
28693 <P>
28694 Because enabling the
28695 <A HREF="h_config_flag_screen_default"><!--#echo var="FEAT_enable-flag-screen-implicitly"--></A>
28696 option causes Alpine to skip directly to the Flag Details screen when the
28697 Flag command is used,
28698 setting it will cause this feature to have no effect at all.
28699 <P>
28700 Similarly, when Selecting by Keyword, setting this option will allow you
28701 to use Keyword initials instead of full keywords.
28702 <P>
28703 &lt;End of help on this topic&gt;
28704 </BODY>
28705 </HTML>
28706 ====== h_config_can_suspend =====
28707 <HTML>
28708 <HEAD>
28709 <TITLE>FEATURE: <!--#echo var="FEAT_enable-suspend"--></TITLE>
28710 </HEAD>
28711 <BODY>
28712 <H1>FEATURE: <!--#echo var="FEAT_enable-suspend"--></H1>
28713
28714 Setting this feature will allow you to type ^Z (Control Z) to
28715 <!--chtml if pinemode="os_windows"-->
28716 minimize Alpine into its icon, bringing into focus whatever
28717 application is running behind the PC-Alpine window.
28718 <!--chtml else-->
28719 temporarily suspend Alpine.
28720
28721 <P>
28722 This does not exit Alpine, but puts it in the background to watch
28723 for new mail and such.  Normally, you type a command, such
28724 as &quot;fg&quot; at your system prompt to return to your Alpine session.
28725
28726 <P>
28727 The <A HREF="h_config_suspend_spawns"><!--#echo var="FEAT_use-subshell-for-suspend"--></A> feature
28728 adjusts whether Alpine is placed into the background of the shell its
28729 running in or starts a news shell.
28730 <!--chtml endif-->
28731
28732 <P>
28733 <UL>
28734 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28735 </UL><P>
28736 &lt;End of help on this topic&gt;
28737 </BODY>
28738 </HTML>
28739 ====== h_config_take_lastfirst ======
28740 <HTML>
28741 <HEAD>
28742 <TITLE>FEATURE: <!--#echo var="FEAT_disable-take-last-comma-first"--></TITLE>
28743 </HEAD>
28744 <BODY>
28745 <H1>FEATURE: <!--#echo var="FEAT_disable-take-last-comma-first"--></H1>
28746
28747 Normally, when TakeAddr is used to copy an address from a message into
28748 an address book entry, Alpine will attempt to rewrite the full name of the
28749 address in the form
28750 <P>
28751
28752 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Last, First<P>
28753
28754 instead of<P>
28755
28756 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;First Last
28757
28758 <P>
28759 It does this because many people find it useful to sort by Last name
28760 instead of First name.  If this feature is set, then the TakeAddr command
28761 will not attempt to reverse the name in this manner.
28762 <P>
28763 &lt;End of help on this topic&gt;
28764 </BODY></HTML>
28765 ====== h_config_disable_regex ======
28766 <HTML>
28767 <HEAD>
28768 <TITLE>FEATURE: <!--#echo var="FEAT_disable-regular-expression-matching-for-alternate-addresses"--></TITLE>
28769 </HEAD>
28770 <BODY>
28771 <H1>FEATURE: <!--#echo var="FEAT_disable-regular-expression-matching-for-alternate-addresses"--></H1>
28772
28773 Normally, the
28774 <a href="h_config_alt_addresses"><!--#echo var="VAR_alt-addresses"--></a>
28775 option is interpreted as a regular expression.
28776 One type of address that might cause trouble is an address that
28777 contains a plus sign.
28778 If you want to have an address with a plus as one of your
28779 <!--#echo var="VAR_alt-addresses"-->
28780 and you don't want to use regular expressions, then setting this
28781 feature will cause Alpine to treat the addresses you list literally instead.
28782 <P>
28783 &lt;End of help on this topic&gt;
28784 </BODY></HTML>
28785 ====== h_config_take_fullname ======
28786 <HTML>
28787 <HEAD>
28788 <TITLE>FEATURE: <!--#echo var="FEAT_disable-take-fullname-in-addresses"--></TITLE>
28789 </HEAD>
28790 <BODY>
28791 <H1>FEATURE: <!--#echo var="FEAT_disable-take-fullname-in-addresses"--></H1>
28792
28793 Normally, when TakeAddr is used to copy an address or addresses
28794 from a message into an address book entry, Alpine will try to preserve
28795 the full name associated with each address in the list of addresses.
28796 The reason for this is so that if the entry is a list or later becomes a
28797 list, then information about the individual addresses in the list
28798 is preserved.
28799 If you would rather just have the simple addresses in the list of addresses,
28800 set this feature. For example, with the default setting you might
28801 see something like this in the ADDRESS BOOK editor after you type TakeAddr
28802 <P>
28803 <PRE>
28804  Nickname  : nick
28805  Fullname  : Bedrock Elders
28806  Fcc       :
28807  Comment   :
28808  Addresses : Fred Flintstone &lt;flint@bedrock.org&gt;,
28809              Barney Rubble &lt;rubble@bedrock.org&gt;
28810 </PRE>
28811 <P>
28812 but with this feature set it would look like
28813 <P>
28814 <PRE>
28815  Nickname  : nick
28816  Fullname  : Bedrock Elders
28817  Fcc       :
28818  Comment   :
28819  Addresses : flint@bedrock.org,
28820              rubble@bedrock.org
28821 </PRE>
28822 <P>
28823 instead. Note the difference in the Addresses field.
28824 <P>
28825 &lt;End of help on this topic&gt;
28826 </BODY></HTML>
28827 ====== h_config_print_from ======
28828 <HTML>
28829 <HEAD>
28830 <TITLE>FEATURE: <!--#echo var="FEAT_print-includes-from-line"--></TITLE>
28831 </HEAD>
28832 <BODY>
28833 <H1>FEATURE: <!--#echo var="FEAT_print-includes-from-line"--></H1>
28834
28835 If this feature is set, then the Berkeley-mail style From line is included
28836 at the start of each message that is printed.  This line looks something
28837 like the following, with the address replaced by the address from the
28838 From line of the message being printed:
28839 <P>
28840 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;From user@domain.somewhere.com Mon May 13
28841 14:11:06 1998
28842 <P>
28843 &lt;End of help on this topic&gt;
28844 </BODY>
28845 </HTML>
28846 ====== h_config_expanded_distlists ======
28847 <HTML>
28848 <HEAD>
28849 <TITLE>FEATURE: <!--#echo var="FEAT_expanded-view-of-distribution-lists"--></TITLE>
28850 </HEAD>
28851 <BODY>
28852 <H1>FEATURE: <!--#echo var="FEAT_expanded-view-of-distribution-lists"--></H1>
28853 If this feature is set, then distribution lists in the address book
28854 screen will always be expanded automatically.
28855 <P>
28856 &lt;End of help on this topic&gt;
28857 </BODY>
28858 </HTML>
28859 ====== h_config_compose_news_wo_conf ======
28860 <HTML>
28861 <HEAD>
28862 <TITLE>FEATURE: <!--#echo var="FEAT_compose-sets-newsgroup-without-confirm"--></TITLE>
28863 </HEAD>
28864 <BODY>
28865 <H1>FEATURE: <!--#echo var="FEAT_compose-sets-newsgroup-without-confirm"--></H1>
28866 This feature controls one aspect of Alpine's Composer.  If you enter the
28867 composer while reading a newsgroup, you will normally be prompted to
28868 determine whether you intend the new message to be posted to the current
28869 newsgroup or not.  If this feature is set, Alpine will not prompt you
28870 in this situation, and will assume that you do indeed wish to post
28871 to the newsgroup you are reading.
28872 <P>
28873 &lt;End of help on this topic&gt;
28874 </BODY>
28875 </HTML>
28876 ====== h_config_compose_rejects_unqual ======
28877 <HTML>
28878 <HEAD>
28879 <TITLE>FEATURE: <!--#echo var="FEAT_compose-rejects-unqualified-addrs"--></TITLE>
28880 </HEAD>
28881 <BODY>
28882 <H1>FEATURE: <!--#echo var="FEAT_compose-rejects-unqualified-addrs"--></H1>
28883
28884 This feature controls one aspect of the message composer; in particular,
28885 what happens when an unqualified name is entered into an address header.
28886 If set, unqualified names entered as addresses will be treated as errors
28887 unless they match an addressbook nickname.  Alpine will not attempt to turn
28888 them into complete addresses by adding your local domain.<P>
28889
28890 A complete (fully qualified) address is one containing a username followed
28891 by an &quot;@&quot; (&quot;at&quot;) symbol, followed by a domain name (e.g.
28892 &quot;jsmith@example.com&quot;).  An unqualified name is one <B>without</B>
28893 the &quot;@&quot; symbol and domain name (e.g. &quot;jsmith&quot;).
28894
28895 (See also <A HREF="h_address_format">Explanation of Address formats</A>.)
28896
28897 <P>
28898
28899 When you enter a fully qualified address, Alpine does not interpret or
28900 modify it, but simply passes it on to the mail-transport-agent (MTA) for
28901 your system.  Alpine conforms to the Internet standards governing message
28902 headers and will not send an unqualifed name to the MTA.  Therefore, when
28903 you enter an unqualified name, Alpine will normally attempt to turn it into
28904 a fully qualified address, first by checking to see if you have entered a
28905 matching nickname in your addressbook, or failing that, by simply adding
28906 your own domain to the name entered.  So if your address is
28907 &quot;jsmith@example.com&quot; and you enter &quot;fred&quot;, then (assuming
28908 &quot;fred&quot; is not a nickname in your addressbook), Alpine will turn
28909 that into &quot;fred@example.com&quot;.<P>
28910
28911 There are situations where it is not desirable for Alpine to interpret such
28912 unqualified names as valid (local) addresses.  For example, if &quot;fred&quot;
28913 turned out to be a typo (intended to be an addressbook nickname), but
28914 there actually was a &quot;fred&quot; in your local domain, the message might
28915 be mis-delivered without your realizing it.  In order to reduce the likelihood
28916 of such accidents, setting this feature will cause Alpine to treat such
28917 addresses as errors, and require that you explicitly enter the full local
28918 address (e.g. &quot;fred@example.com&quot;) or correct the name so that it
28919 matches an address book nickname.<P>
28920
28921 Consider this a safety feature against mis-directed mail.
28922 <P>
28923 <UL>
28924 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28925 </UL><P>
28926 &lt;End of help on this topic&gt;
28927 </BODY>
28928 </HTML>
28929 ====== h_config_quell_local_lookup ======
28930 <HTML>
28931 <HEAD>
28932 <TITLE>FEATURE: <!--#echo var="FEAT_quell-user-lookup-in-passwd-file"--></TITLE>
28933 </HEAD>
28934 <BODY>
28935 <H1>FEATURE: <!--#echo var="FEAT_quell-user-lookup-in-passwd-file"--></H1>
28936
28937 This feature controls an aspect of Alpine's Composer, and if needed, will
28938 usually be set by your system manager in Alpine's system-wide configuration
28939 file. Specifically, if this feature is set, Alpine will not attempt to look
28940 in the system password file to find a Full Name for the entered address.
28941 <P>
28942 Normally, names you enter into address fields (e.g. To: or Cc:) are
28943 checked against your address book(s) to see if they match an address book
28944 nickname.  Failing that, (in Unix Alpine) the name is then checked against
28945 the Unix password file.  If the entered name matches a username in the
28946 system password file, Alpine extracts the corresponding Full Name information
28947 for that individual, and adds that to the address being entered.
28948 <P>
28949 However, password file matching can have surprising (incorrect) results if
28950 other users of the system do not receive mail at the domain you are using.
28951 That is, if either the
28952 <A HREF="h_config_user_dom">&quot;<!--#echo var="VAR_user-domain"-->&quot;</A> or
28953 <A HREF="h_config_domain_name">&quot;<!--#echo var="VAR_use-only-domain-name"-->&quot;</A>
28954 option
28955 is set such that the administrative domain of other users on the system
28956 isn't accurately reflected, Alpine should be told that a passwd file match
28957 is coincidental, and Full Name info will be incorrect.  For example, a
28958 personal name from the password file could get falsely paired with the
28959 entered name as it is turned into an address in the configured domain.
28960 <P>
28961 If you are seeing this behavior, enabling this feature will prevent Unix
28962 Alpine from looking up names in the password file to find the Full Name
28963 for incomplete addresses you enter.<P>
28964 <UL>
28965 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
28966 </UL>
28967 <P>
28968 &lt;End of help on this topic&gt;
28969 </BODY>
28970 </HTML>
28971 ====== h_config_tab_checks_recent ======
28972 <HTML>
28973 <HEAD>
28974 <TITLE>FEATURE: <!--#echo var="FEAT_tab-checks-recent"--></TITLE>
28975 </HEAD>
28976 <BODY>
28977 <H1>FEATURE: <!--#echo var="FEAT_tab-checks-recent"--></H1>
28978
28979 In a FOLDER LIST screen, the TAB key usually just changes which
28980 folder is highlighted.
28981 If this feature is set, then the TAB key will cause the number of
28982 recent messages and the total number of messages in the highlighted folder
28983 to be displayed instead.
28984
28985 <P>
28986 &lt;End of help on this topic&gt;
28987 </BODY>
28988 </HTML>
28989 ====== h_config_maildrops_preserve_state ======
28990 <HTML>
28991 <HEAD>
28992 <TITLE>FEATURE: <!--#echo var="FEAT_maildrops-preserve-state"--></TITLE>
28993 </HEAD>
28994 <BODY>
28995 <H1>FEATURE: <!--#echo var="FEAT_maildrops-preserve-state"--></H1>
28996
28997 This feature affects the way <A HREF="h_maildrop">Mail Drops</A> work.
28998 Normally, when mail is moved from a Mail Drop folder to a destination
28999 folder, it is delivered as new mail.
29000 Any Seen/New, Answered, Important/Flagged state that has changed will be
29001 ignored.
29002 All of the mail will be considered unSeen, unAnswered, and unImportant after
29003 it is moved.
29004 <P>
29005 If this feature is set, then the state changes that have been made
29006 to the messages in the Mail Drop folder will be preserved.
29007 <P>
29008 In any case, messages that are already marked Deleted when the
29009 mail is to be moved from the Mail Drop will be ignored.
29010 <P>
29011 &lt;End of help on this topic&gt;
29012 </BODY>
29013 </HTML>
29014 ====== h_config_preopen_stayopens ======
29015 <HTML>
29016 <HEAD>
29017 <TITLE>FEATURE: <!--#echo var="FEAT_preopen-stayopen-folders"--></TITLE>
29018 </HEAD>
29019 <BODY>
29020 <H1>FEATURE: <!--#echo var="FEAT_preopen-stayopen-folders"--></H1>
29021
29022 This feature is related to the option
29023 <A HREF="h_config_permlocked">&quot;<!--#echo var="VAR_stay-open-folders"-->&quot;</A>.
29024 Normally, Stay Open folders are only opened on demand, when the user
29025 asks to open them.
29026 From then on they are kept open for the duration of the session.
29027 However, if this feature is set, then the Stay Open folders will all be
29028 opened at startup, at the same time that the INBOX is opened.
29029
29030 <P>
29031 &lt;End of help on this topic&gt;
29032 </BODY>
29033 </HTML>
29034 ====== h_config_expunge_inbox ======
29035 <HTML>
29036 <HEAD>
29037 <TITLE>FEATURE: <!--#echo var="FEAT_offer-expunge-of-inbox"--></TITLE>
29038 </HEAD>
29039 <BODY>
29040 <H1>FEATURE: <!--#echo var="FEAT_offer-expunge-of-inbox"--></H1>
29041
29042 The INBOX is normally treated differently from regular folders in several
29043 ways.
29044 One of the differences is that the normal &quot;close&quot; sequence of
29045 events is deferred until Alpine is exited, instead of happening when you
29046 leave the INBOX to view another folder.
29047 The &quot;close&quot; sequence normally includes the Expunging
29048 of deleted messages
29049 (either automatically or after a prompt, controlled by the features
29050 <A HREF="h_config_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm"-->&quot;</A>,
29051 <A HREF="h_config_full_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm-everywhere"-->&quot;</A>, and
29052 <A HREF="h_config_expunge_manually"><!--#echo var="FEAT_expunge-only-manually"--></A>), and the
29053 handling of the
29054 <A HREF="h_config_read_message_folder"><!--#echo var="VAR_read-message-folder"--></A>.
29055
29056 <P>
29057 If this feature is set the &quot;close&quot; sequence handling will take
29058 place every time you leave the INBOX.
29059 The INBOX will still be kept open, but the offer to Expunge and the archiving
29060 to the <!--#echo var="VAR_read-message-folder"-->
29061 will take place each time you leave the INBOX instead of only once at the
29062 end of the session.
29063
29064 <P>
29065 &lt;End of help on this topic&gt;
29066 </BODY>
29067 </HTML>
29068 ====== h_config_expunge_stayopens ======
29069 <HTML>
29070 <HEAD>
29071 <TITLE>FEATURE: <!--#echo var="FEAT_offer-expunge-of-stayopen-folders"--></TITLE>
29072 </HEAD>
29073 <BODY>
29074 <H1>FEATURE: <!--#echo var="FEAT_offer-expunge-of-stayopen-folders"--></H1>
29075
29076 This feature is related to the option
29077 <A HREF="h_config_permlocked">&quot;<!--#echo var="VAR_stay-open-folders"-->&quot;</A>.
29078 Stay Open folders are treated differently from regular folders in several
29079 ways.
29080 One of the differences is that the normal &quot;close&quot; sequence of
29081 events is deferred until Alpine is exited, instead of happening when you
29082 leave the folder to view another folder.
29083 The &quot;close&quot; sequence normally includes the Expunging
29084 of deleted messages
29085 (either automatically or after a prompt, controlled by the features
29086 <A HREF="h_config_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm"-->&quot;</A>,
29087 <A HREF="h_config_full_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm-everywhere"-->&quot;</A>, and
29088 <A HREF="h_config_expunge_manually"><!--#echo var="FEAT_expunge-only-manually"--></A>), and the
29089 handling of
29090 <A HREF="h_config_archived_folders"><!--#echo var="VAR_incoming-archive-folders"--></A>.
29091
29092 <P>
29093 If this feature is set the &quot;close&quot; sequence handling will take
29094 place when you leave the Stay Open folder.
29095 The folder will still be kept open, but the offer to Expunge and the archiving
29096 will take place each time you leave the folder instead of only once at the
29097 end of the session.
29098 This feature does not affect the INBOX, which will still only be processed
29099 when you exit Alpine.
29100 However, there is a similar feature that affects only the INBOX called
29101 <A HREF="h_config_expunge_inbox">&quot;<!--#echo var="FEAT_offer-expunge-of-inbox"-->&quot;</A>.
29102
29103 <P>
29104 &lt;End of help on this topic&gt;
29105 </BODY>
29106 </HTML>
29107 ====== h_config_preserve_start_stop ======
29108 <HTML>
29109 <HEAD>
29110 <TITLE>FEATURE: <!--#echo var="FEAT_preserve-start-stop-characters"--></TITLE>
29111 </HEAD>
29112 <BODY>
29113 <H1>FEATURE: <!--#echo var="FEAT_preserve-start-stop-characters"--></H1>
29114
29115 This feature controls how special control key characters, typically
29116 Ctrl-S and Ctrl-Q, are interpreted when input to Alpine.  These characters
29117 are known as the "stop" and "start" characters and are sometimes used in
29118 communications paths to control data flow between devices that operate at
29119 different speeds.
29120
29121 <P>
29122
29123 By default, Alpine turns the system's handling of these special characters
29124 off except during printing.  However, if you see Alpine reporting input errors
29125 such as:
29126 <P>
29127 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;[ Command "^Q" not defined for this screen.]
29128 <P>
29129 and, at the same time, see your display become garbled, then it is likely
29130 that setting this option will solve the problem.  Be aware, though, that
29131 enabling this feature will also cause Alpine to ostensibly "hang"
29132 whenever the Ctrl-S key combination is entered as the system is now
29133 interpreting such input as a "stop output" command.  To "start
29134 output"  again, simply type Ctrl-Q.
29135 <P>
29136 &lt;End of help on this topic&gt;
29137 </BODY>
29138 </HTML>
29139 ====== h_config_enable_incoming ======
29140 <HTML>
29141 <HEAD>
29142 <TITLE>FEATURE: <!--#echo var="FEAT_enable-incoming-folders"--></TITLE>
29143 </HEAD>
29144 <BODY>
29145 <H1>FEATURE: <!--#echo var="FEAT_enable-incoming-folders"--></H1>
29146
29147 Alpine's Incoming Message Folders collection
29148 provides a convenient way to access multiple incoming folders.
29149 It is also useful if you have accounts on multiple computers.
29150 <P>
29151
29152 If set, this feature defines a pseudo-folder collection called
29153 &quot;INCOMING MESSAGE FOLDERS&quot;.  Initially, the only folder included
29154 in this collection will be your INBOX, which will no longer show up in
29155 your Default folder collection.
29156 <P>
29157
29158 You may add more folders to the Incoming Message Folders collection by
29159 using the
29160 <!--chtml if pinemode="function_key"-->
29161 &quot;F10
29162 <!--chtml else-->
29163 &quot;A
29164 <!--chtml endif-->
29165 Add&quot; command in the FOLDER LIST screen.  You will be prompted for
29166 the host the folder is stored on (which defaults to the same host used
29167 for your INBOX), a nickname, and the actual folder name.  Once a set
29168 of Incoming Message Folders are defined, the TAB key (in MESSAGE INDEX
29169 or MESSAGE TEXT screens) may be used to scan the folders for those
29170 with Recent messages.  If you add more folders to
29171 your <!--#echo var="VAR_incoming-folders"--> collection, turning this feature back off will have
29172 no effect.
29173 <P>
29174 NOTE: Normally the software that actually delivers mail (the stuff that happens
29175 before Alpine is involved) is in a better position to do delivery filtering
29176 than is Alpine itself.
29177 If possible, you may want to look at programs such as
29178 &quot;filter&quot; or &quot;procmail&quot;, which are examples of delivery
29179 filtering programs.
29180 If you'd prefer to have Alpine do the filtering for you, you may set that
29181 up.
29182 Look <A HREF="h_rules_filter">here</A> for help with Alpine filtering.
29183 <P>
29184 <UL>
29185 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29186 </UL><P>
29187 &lt;End of help on this topic&gt;
29188 </BODY>
29189 </HTML>
29190 ====== h_config_enable_incoming_checking ======
29191 <HTML>
29192 <HEAD>
29193 <TITLE>FEATURE: <!--#echo var="FEAT_enable-incoming-folders-checking"--></TITLE>
29194 </HEAD>
29195 <BODY>
29196 <H1>FEATURE: <!--#echo var="FEAT_enable-incoming-folders-checking"--></H1>
29197
29198 This feature is only operational if you have enabled the optional
29199 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A> collection.
29200 If you do have Incoming Message Folders and you also set this feature,
29201 then the number of Unseen messages in each folder will be displayed
29202 in the FOLDER LIST screen for the Incoming Message Folders.
29203 The number of Unseen messages in a folder will be displayed in parentheses
29204 to the right of the name of each folder.
29205 If there are no Unseen messages in a folder then only the name
29206 is displayed, not a set of parentheses with zero inside them.
29207 A redraw command, Ctrl-L, can be used in the FOLDER LIST screen for
29208 the Incoming Message Folders to cause an immediate update.
29209 <P>
29210 If a check for Unseen messages fails for a particular folder then Alpine
29211 will no longer attempt to check that folder for the duration of the
29212 session and this will be indicated by a question mark inside the
29213 parentheses.
29214 <P>
29215 The features
29216 <A HREF="h_config_incoming_checking_total"><!--#echo var="FEAT_incoming-checking-includes-total"--></A>,
29217 <A HREF="h_config_incoming_checking_recent"><!--#echo var="FEAT_incoming-checking-uses-recent"--></A>,
29218 <A HREF="h_config_incoming_list"><!--#echo var="VAR_incoming-check-list"--></A>,
29219 <A HREF="h_config_incoming_interv"><!--#echo var="VAR_incoming-check-interval"--></A>,
29220 <A HREF="h_config_incoming_second_interv"><!--#echo var="VAR_incoming-check-interval-secondary"--></A>, and
29221 <A HREF="h_config_incoming_timeo"><!--#echo var="VAR_incoming-check-timeout"--></A>
29222 all affect how this feature behaves.
29223 <P>
29224 <UL>
29225 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29226 </UL><P>
29227 &lt;End of help on this topic&gt;
29228 </BODY>
29229 </HTML>
29230 ====== h_config_incoming_checking_total ======
29231 <HTML>
29232 <HEAD>
29233 <TITLE>FEATURE: <!--#echo var="FEAT_incoming-checking-includes-total"--></TITLE>
29234 </HEAD>
29235 <BODY>
29236 <H1>FEATURE: <!--#echo var="FEAT_incoming-checking-includes-total"--></H1>
29237
29238 This option has no effect unless the feature
29239 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
29240 is set, which in turn has no effect unless
29241 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
29242 is set.
29243 <P>
29244 When incoming folder checking is turned on the default is to display
29245 the number of unseen messages in each folder.
29246 More precisely, it is the number of undeleted unseen messages.
29247 Using this option you may also display the total number of messages
29248 in each folder.
29249 Instead of a single number representing the number of unseen messages
29250 you will get two numbers separated by a slash character.
29251 The first is the number of unseen messages and the second is the
29252 total number of messages.
29253 <P>
29254 You may also use the recent message count instead of the unseen message
29255 count by turning on the feature
29256 <A HREF="h_config_incoming_checking_recent"><!--#echo var="FEAT_incoming-checking-uses-recent"--></A>.
29257 <P>
29258 <UL>
29259 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29260 </UL><P>
29261 &lt;End of help on this topic&gt;
29262 </BODY>
29263 </HTML>
29264 ====== h_config_incoming_checking_recent ======
29265 <HTML>
29266 <HEAD>
29267 <TITLE>FEATURE: <!--#echo var="FEAT_incoming-checking-uses-recent"--></TITLE>
29268 </HEAD>
29269 <BODY>
29270 <H1>FEATURE: <!--#echo var="FEAT_incoming-checking-uses-recent"--></H1>
29271
29272 This option has no effect unless the feature
29273 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
29274 is set, which in turn has no effect unless
29275 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
29276 is set.
29277 <P>
29278 When incoming folder checking is turned on the default is to display
29279 the number of unseen messages in each folder.
29280 More precisely, it is the number of undeleted unseen messages.
29281 Using this option you may display the number of recent messages instead
29282 of the number of unseen messages.
29283 A message is only counted as recent if this is the first session to
29284 see it, so the recent count might be less than the unseen count.
29285 The difference between the two would be accounted for by the unseen messages
29286 in the folder which were there previously but have not been looked at yet.
29287 <P>
29288 If you simultaneously run more than one email client at a time
29289 (for example, you run more than one Alpine in parallel) then turning
29290 this feature on can cause some confusion.
29291 The confusion stems from the fact that each message is only considered to be
29292 recent in one session.
29293 That means that the counts of new messages may be different in the two
29294 Alpines running side by side, because each incoming message will only be
29295 counted as recent in one of the two sessions.
29296 <P>
29297 You may also display the total number of messages
29298 in each folder by using the
29299 <A HREF="h_config_incoming_checking_total"><!--#echo var="FEAT_incoming-checking-includes-total"--></A>
29300 option.
29301 <P>
29302 <UL>
29303 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29304 </UL><P>
29305 &lt;End of help on this topic&gt;
29306 </BODY>
29307 </HTML>
29308 ====== h_config_attach_in_reply ======
29309 <HTML>
29310 <HEAD>
29311 <TITLE>FEATURE: <!--#echo var="FEAT_include-attachments-in-reply"--></TITLE>
29312 </HEAD>
29313 <BODY>
29314 <H1>FEATURE: <!--#echo var="FEAT_include-attachments-in-reply"--></H1>
29315
29316 This feature controls an aspect of Alpine's Reply command. If set, any MIME
29317 attachments that were part of the original message will automatically be
29318 included in the Reply.
29319 <P>
29320 &lt;End of help on this topic&gt;
29321 </BODY>
29322 </HTML>
29323 ====== h_config_include_header =====
29324 <HTML>
29325 <HEAD>
29326 <TITLE>FEATURE: <!--#echo var="FEAT_include-header-in-reply"--></TITLE>
29327 </HEAD>
29328 <BODY>
29329 <H1>FEATURE: <!--#echo var="FEAT_include-header-in-reply"--></H1>
29330
29331 This feature controls an aspect of Alpine's Reply command. If set, and the
29332 original message is being included in the reply, then headers from that
29333 message will also be part of the reply.
29334 <P>
29335 &lt;End of help on this topic&gt;
29336 </HEAD>
29337 </HTML>
29338 ====== h_config_sig_at_bottom =====
29339 <HTML>
29340 <HEAD>
29341 <TITLE>FEATURE: <!--#echo var="FEAT_signature-at-bottom"--></TITLE>
29342 </HEAD>
29343 <BODY>
29344 <H1>FEATURE: <!--#echo var="FEAT_signature-at-bottom"--></H1>
29345
29346 This feature controls an aspect of Alpine's Reply command.  If this feature
29347 is set, and the original message is being included in the reply, then the
29348 contents of your signature file (if any) will be inserted after the included
29349 message.
29350 <P>
29351 This feature does not affect the results of a Forward command.
29352 <P>
29353 &lt;End of help on this topic&gt;
29354 </BODY>
29355 </HTML>
29356 ====== h_config_sigdashes =====
29357 <HTML>
29358 <HEAD>
29359 <TITLE>FEATURE: <!--#echo var="FEAT_enable-sigdashes"--></TITLE>
29360 </HEAD>
29361 <BODY>
29362 <H1>FEATURE: <!--#echo var="FEAT_enable-sigdashes"--></H1>
29363
29364 This feature enables support for the common USENET news convention
29365 of preceding a message signature with the special line consisting of
29366 the three characters &quot;--&nbsp;&quot; (i.e., dash, dash, and space).
29367
29368 <P>
29369 When enabled and a
29370 &quot;<A HREF="h_config_signature_file"><!--#echo var="VAR_signature-file"--></A>&quot; exists,
29371 Alpine will insert the special line before including the file's text (unless
29372 the special line already exists somewhere in the file's text).
29373
29374 <P>
29375 In addition, when you Reply or Followup to a message containing one of
29376 these special lines and choose to include its text, Alpine will observe
29377 the convention of not including text beyond the special line in your
29378 reply.
29379 If <A HREF="h_config_enable_full_hdr">&quot;Full Header&quot;</A>
29380 mode is enabled and turned on, then Alpine <EM>will</EM>
29381 include the text beyond the special line regardless of the setting of
29382 this feature.
29383
29384 <P>
29385 See also &quot;<a href="h_config_strip_sigdashes"><!--#echo var="FEAT_strip-from-sigdashes-on-reply"--></a>&quot;
29386 for a related feature.
29387
29388 <P>
29389 <UL>
29390 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29391 </UL><P>
29392 &lt;End of help on this topic&gt;
29393 </BODY>
29394 </HTML>
29395 ====== h_config_new_thread_blank_subject =====
29396 <HTML>
29397 <HEAD>
29398 <TITLE>FEATURE: <!--#echo var="FEAT_new-thread-on-blank-subject"--></TITLE>
29399 </HEAD>
29400 <BODY>
29401 <H1>FEATURE: <!--#echo var="FEAT_new-thread-on-blank-subject"--></H1>
29402
29403 When this feature is enabled (the default) Alpine will create a new thread
29404 every time that the subject line becomes empty at any time during composition.
29405
29406 <P>
29407 This behavior is particularly useful in case you are replying to a message.
29408 Replying to a message causes the message to be in the same thread than the
29409 original message that is being replied to. However, many authors want to create
29410 a new message (in a different thread) while replying to a message, and they do
29411 this by changing the full subject, by first deleting the original subject and
29412 typing the new subject of the current message.
29413
29414 <P>
29415 Enabling this feature causes that any time that the subject is deleted, the
29416 message being composed will be considered the first message of a new thread.
29417
29418 <P>
29419 <UL>
29420 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29421 </UL><P>
29422 &lt;End of help on this topic&gt;
29423 </BODY>
29424 </HTML>
29425 ====== h_config_strip_sigdashes =====
29426 <HTML>
29427 <HEAD>
29428 <TITLE>FEATURE: <!--#echo var="FEAT_strip-from-sigdashes-on-reply"--></TITLE>
29429 </HEAD>
29430 <BODY>
29431 <H1>FEATURE: <!--#echo var="FEAT_strip-from-sigdashes-on-reply"--></H1>
29432
29433 This feature doesn't do anything if the feature
29434 &quot;<A HREF="h_config_sigdashes"><!--#echo var="FEAT_enable-sigdashes"--></A>&quot; is turned on.
29435 However, if the &quot;<!--#echo var="FEAT_enable-sigdashes"-->&quot; feature is not turned on,
29436 then turning on this feature enables support for the convention
29437 of not including text beyond the sigdashes line when Replying or Following
29438 up to a message and including the text of that message.
29439 If <A HREF="h_config_enable_full_hdr">&quot;Full Header&quot;</A>
29440 mode is enabled and turned on, then Alpine <EM>will</EM>
29441 include the text beyond the special line regardless of the setting of
29442 this feature.
29443 <P>
29444 In other words, this is a way to turn on the signature stripping behavior
29445 without also turning on the dashes-adding behavior.
29446 <P>
29447 <UL>
29448 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29449 </UL><P>
29450 &lt;End of help on this topic&gt;
29451 </BODY>
29452 </HTML>
29453 ====== h_config_forward_as_attachment =====
29454 <HTML>
29455 <HEAD>
29456 <TITLE>FEATURE: <!--#echo var="FEAT_forward-as-attachment"--></TITLE>
29457 </HEAD>
29458 <BODY>
29459 <H1>FEATURE: <!--#echo var="FEAT_forward-as-attachment"--></H1>
29460
29461 This feature affects the way forwarded message text is handled.  When set, rather than
29462 include the text of the forwarded message below any additional text you provide in the
29463 composer, the forwarded message is attached in its entirety to the message you send.
29464 <P>
29465 This is useful in that it keeps the text you provide in the composer distinct from the
29466 text of the forwarded message.  Similarly, it allows the recipient to
29467 conveniently operate on the forwarded message.  For example, they might reply directly to
29468 the sender of the forwarded message, or process it as part of a spam report.
29469 <UL>
29470 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29471 </UL><P>
29472 &lt;End of help on this topic&gt;
29473 </BODY>
29474 </HTML>
29475 ====== h_config_preserve_field =====
29476 <HTML>
29477 <HEAD>
29478 <TITLE>FEATURE: <!--#echo var="FEAT_preserve-original-fields"--></TITLE>
29479 </HEAD>
29480 <BODY>
29481 <H1>FEATURE: <!--#echo var="FEAT_preserve-original-fields"--></H1>
29482
29483 This feature affects Alpine's behavior when one replies to a message.
29484 When you receive a message, some or all of the recipients of the message
29485 have been added to the To: and Cc: fields. If you reply to such message,
29486 and this feature is disabled, then the original sender of the message is
29487 added to the To: field, and all other recipients are added to the Cc:
29488 field, while your address is added to the From: field.
29489
29490 <P>
29491 However, if this feature is enabled, then Alpine will preserve the
29492 original fields as sent in the original message, so the Cc: and To:
29493 fields will be preserved. The sender's address will be added to the To:
29494 field, while your address is added to the From: field.
29495
29496 <P>
29497 The behavior of this feature is that replies to all messages will behave
29498 in the way described above. If you only intend this to happen on a per
29499 message basis, then keep this feature disabled, and when replying to a
29500 message you will see a new option in the menu for the &quot;Reply to all
29501 recipients?&quot; question. In this case, pressing &quot;p&quot; will
29502 make Alpine toggle its question so you can preserve the To: and Cc:
29503 fields for that message only.
29504
29505 <UL>
29506 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
29507 </UL><P>
29508 &lt;End of help on this topic&gt;
29509 </BODY>
29510 </HTML>
29511 ====== h_config_sub_lists =====
29512 <HTML>
29513 <HEAD>
29514 <TITLE>FEATURE: <!--#echo var="FEAT_enable-partial-match-lists"--></TITLE>
29515 </HEAD>
29516 <BODY>
29517 <H1>FEATURE: <!--#echo var="FEAT_enable-partial-match-lists"--></H1>
29518
29519 This feature affects the subcommands available when Saving,
29520 or when Opening a new folder. If set, the subcommand ^X ListMatches will be
29521 available. This command allows you to type in a substring of the folder
29522 you are looking for and when you type ^X it will display all folders
29523 that contain that substring in their names.
29524 This feature is set by default.
29525
29526 <P>
29527 &lt;End of help on this topic&gt;
29528 </BODY>
29529 </HTML>
29530 ====== h_config_scramble_message_id =====
29531 <HTML>
29532 <HEAD>
29533 <TITLE>FEATURE: <!--#echo var="FEAT_scramble-message-id"--></TITLE>
29534 </HEAD>
29535 <BODY>
29536 <H1>FEATURE: <!--#echo var="FEAT_scramble-message-id"--></H1>
29537
29538 Normally the Message-ID header that Alpine generates when sending a message
29539 contains the name of the computer from which the message is being sent.
29540 Some believe that this hostname could be used by spammers or could
29541 be used by others for nefarious purposes.
29542 If this feature is set, that name will be transformed with a simple
29543 Rot13 transformation.
29544 The result will still have the correct syntax for a Message-ID but the
29545 part of the MessageID that is often a domain name will not be an actual
29546 domain name because the letters will be scrambled.
29547 <P>
29548 In addition, other information such as the name program, version, and
29549 a code for operating system used to build Alpine, will be encoded using
29550 the Rot13 transformation, except for the version number which will be
29551 encoded using a Rot5 transformation.
29552 <P>
29553 It is possible (but unlikely?) that some spam detection
29554 software will use that as a reason to reject the mail as spam.
29555 It has also been reported that some spam detection software uses the
29556 fact that there are no dots after the &quot;@&quot; as a reason to reject
29557 messages.
29558 If your PC-Alpine Message-ID is using a name without a dot that is because
29559 that is what Windows thinks is your &quot;Full computer name&quot;.
29560 The method used to set this varies from one type of Windows to another but
29561 check under Settings -> Control Panel -> System and
29562 look for Network Identification or Computer Name or something similar.
29563 How to set it is beyond the scope of Alpine.
29564
29565 <P>
29566 &lt;End of help on this topic&gt;
29567 </BODY>
29568 </HTML>
29569 ====== h_downgrade_multipart_to_text =====
29570 <HTML>
29571 <HEAD>
29572 <TITLE>FEATURE: <!--#echo var="FEAT_downgrade-multipart-to-text"--></TITLE>
29573 </HEAD>
29574 <BODY>
29575 <H1>FEATURE: <!--#echo var="FEAT_downgrade-multipart-to-text"--></H1>
29576
29577 <P>
29578 This feature affects Alpine's behavior when sending mail.  Internet
29579 standards require Alpine to translate all non-ASCII characters in
29580 messages that it sends using MIME encoding.  This encoding can be
29581 ostensibly broken for recipients if any agent between Alpine and the
29582 recipient, such as an email list expander, appends text to the
29583 message, such as list information or advertising.  When sending such
29584 messages Alpine attempts to protect such encoding by placing extra
29585 MIME boundaries around the message text.
29586 <P>
29587 These extra boundaries are invisible to recipients that
29588 use MIME-aware email programs (the vast majority).  However, if
29589 you correspond with users of email programs that are not MIME-aware,
29590 or do not handle the extra boundaries gracefully, you can
29591 use this feature to prevent Alpine from including the extra
29592 MIME information.  Of course, it will increase the likelihood
29593 that non-ASCII text you send may appear corrupt to the recipient.
29594 <P>
29595 &lt;End of help on this topic&gt;
29596 </BODY>
29597 </HTML>
29598 ====== h_config_show_sort =====
29599 <HTML>
29600 <HEAD>
29601 <TITLE>FEATURE: <!--#echo var="FEAT_show-sort"--></TITLE>
29602 </HEAD>
29603 <BODY>
29604 <H1>FEATURE: <!--#echo var="FEAT_show-sort"--></H1>
29605
29606 If this feature is set and there is sufficient space on the screen,
29607 a short indication of the current sort order will be
29608 added in the titlebar (the top line on the screen), before the name
29609 of the folder.
29610 For example, with the default Arrival sort in effect,
29611 the display would have the characters
29612
29613 <P><CENTER>[A]</CENTER><P>
29614
29615 added between the title of the screen and the folder name.
29616 The letters are the same as the letters you may type to manually
29617 sort a folder with the SortIndex command ($).
29618 The letters in the table below are the ones that may show
29619 up in the titlebar line.
29620 <P>
29621 <TABLE>
29622 <TR> <TD> A </TD> <TD> <EM>A</EM>rrival        </TD> </TR>
29623 <TR> <TD> S </TD> <TD> <EM>S</EM>ubject        </TD> </TR>
29624 <TR> <TD> F </TD> <TD> <EM>F</EM>rom           </TD> </TR>
29625 <TR> <TD> T </TD> <TD> <EM>T</EM>o             </TD> </TR>
29626 <TR> <TD> C </TD> <TD> <EM>C</EM>c             </TD> </TR>
29627 <TR> <TD> D </TD> <TD> <EM>D</EM>ate           </TD> </TR>
29628 <TR> <TD> Z </TD> <TD> si<EM>Z</EM>e           </TD> </TR>
29629 <TR> <TD> O </TD> <TD> <EM>O</EM>rderedsubject </TD> </TR>
29630 <TR> <TD> E </TD> <TD> scor<EM>E</EM>          </TD> </TR>
29631 <TR> <TD> H </TD> <TD> t<EM>H</EM>read         </TD> </TR>
29632 </TABLE>
29633 <P>
29634 If the sort order is Reversed, the letter above will be preceded by the letter
29635 &quot;R&quot;, for example
29636
29637 <P><CENTER>[RS]</CENTER><P>
29638
29639 means that a Reverse Subject sort is in effect.
29640 For the case where the sort is in Reverse Arrival order, the &quot;A&quot; is
29641 left out, and just an &quot;R&quot; is shown.
29642
29643 <P><CENTER>[R]</CENTER>
29644
29645 <P>
29646 &lt;End of help on this topic&gt;
29647 </BODY>
29648 </HTML>
29649 ====== h_config_disable_reset_disp =====
29650 <HTML>
29651 <HEAD>
29652 <TITLE>FEATURE: <!--#echo var="FEAT_disable-terminal-reset-for-display-filters"--></TITLE>
29653 </HEAD>
29654 <BODY>
29655 <H1>FEATURE: <!--#echo var="FEAT_disable-terminal-reset-for-display-filters"--></H1>
29656
29657 UNIX Alpine only.
29658 <P>
29659 This feature affects Alpine's behavior when using
29660 <A HREF="h_config_display_filters"><!--#echo var="VAR_display-filters"--></A>.
29661 Normally, before the display filter is run, the terminal mode is reset
29662 to what it was before you started Alpine.
29663 This may be necessary if the filter requires the use of the terminal.
29664 For example, it may need to interact with you.
29665 If you set this feature, then the terminal mode will not be reset.
29666 One thing that turning on this feature should fix is the coloring of
29667 <A HREF="h_config_quote_color">quoted text</A> in the message view, which
29668 breaks because the terminal reset resets the color state of the terminal.
29669
29670 <P>
29671 &lt;End of help on this topic&gt;
29672 </BODY>
29673 </HTML>
29674 ====== h_config_disable_sender =====
29675 <HTML>
29676 <HEAD>
29677 <TITLE>FEATURE: <!--#echo var="FEAT_disable-sender"--></TITLE>
29678 </HEAD>
29679 <BODY>
29680 <H1>FEATURE: <!--#echo var="FEAT_disable-sender"--></H1>
29681
29682 This feature affects Alpine's generation of the &quot;Sender:&quot; or
29683 <A HREF="h_config_use_sender_not_x">&quot;X-X-Sender&quot;</A>
29684 header fields.
29685 By default, Alpine will generate such a header in situations where the
29686 username or domain are not the same as
29687 the &quot;From:&quot; header on the message.
29688 With this feature set,
29689 no &quot;Sender:&quot; or &quot;X-X-Sender&quot; header will be generated.
29690 This may be desirable on a system that is virtually hosting many domains,
29691 and the sysadmin has other methods available for tracking a message to
29692 its originator.
29693 <P>
29694 See also <A HREF="h_config_allow_chg_from">&quot;<!--#echo var="FEAT_allow-changing-from"-->&quot;</A>.
29695
29696 <P>
29697 &lt;End of help on this topic&gt;
29698 </BODY>
29699 </HTML>
29700 ====== h_config_use_sender_not_x =====
29701 <HTML>
29702 <HEAD>
29703 <TITLE>FEATURE: <!--#echo var="FEAT_use-sender-not-x-sender"--></TITLE>
29704 </HEAD>
29705 <BODY>
29706 <H1>FEATURE: <!--#echo var="FEAT_use-sender-not-x-sender"--></H1>
29707
29708 Normally Alpine adds a header line
29709 labeled &quot;X-X-Sender&quot;, if the sender is
29710 different from the From: line.
29711 The standard specifies that this header
29712 line should be labeled &quot;Sender&quot;, not &quot;X-X-Sender&quot;.
29713 Setting this feature causes
29714 &quot;Sender&quot; to be used instead of &quot;X-X-Sender&quot;.
29715 <P>
29716 See also <A HREF="h_config_disable_sender">&quot;<!--#echo var="FEAT_disable-sender"-->&quot;</A>.
29717
29718 <P>
29719 &lt;End of help on this topic&gt;
29720 </BODY>
29721 </HTML>
29722 ====== h_config_use_fk =====
29723 <HTML>
29724 <HEAD>
29725 <TITLE>FEATURE: <!--#echo var="FEAT_use-function-keys"--></TITLE>
29726 </HEAD>
29727 <BODY>
29728 <H1>FEATURE: <!--#echo var="FEAT_use-function-keys"--></H1>
29729
29730 This feature specifies that Alpine will respond to function keys instead of
29731 the normal single-letter commands. In this mode, the key menus at the
29732 bottom of each screen will show function key designations instead of the
29733 normal mnemonic key.
29734
29735 <P>
29736 &lt;End of help on this topic&gt;
29737 </BODY>
29738 </HTML>
29739 ====== h_config_cancel_confirm =====
29740 <HTML>
29741 <HEAD>
29742 <TITLE>FEATURE: <!--#echo var="FEAT_compose-cancel-confirm-uses-yes"--></TITLE>
29743 </HEAD>
29744 <BODY>
29745 <H1>FEATURE: <!--#echo var="FEAT_compose-cancel-confirm-uses-yes"--></H1>
29746
29747 This feature affects what happens when you type ^C to cancel a composition.
29748 By default, if you attempt to cancel a composition by typing ^C, you will be
29749 asked to confirm the cancellation by typing a &quot;C&quot;
29750 for <EM>C</EM>onfirm.
29751 It logically ought to be a &quot;Y&quot; for <EM>Y</EM>es, but that is
29752 risky because the &quot;^C Y&quot; needed to cancel a message
29753 is close (on the keyboard) to the &quot;^X Y&quot; needed to send a message.
29754 <P>
29755 If this feature is set the confirmation asked for
29756 will be a &quot;<EM>Y</EM>es&quot;
29757 instead of a &quot;<EM>C</EM>onfirm&quot; response.
29758
29759 <P>
29760 &lt;End of help on this topic&gt;
29761 </BODY>
29762 </HTML>
29763 ====== h_config_compose_maps_del =====
29764 <HTML>
29765 <HEAD>
29766 <TITLE>FEATURE: <!--#echo var="FEAT_compose-maps-delete-key-to-ctrl-d"--></TITLE>
29767 </HEAD>
29768 <BODY>
29769 <H1>FEATURE: <!--#echo var="FEAT_compose-maps-delete-key-to-ctrl-d"--></H1>
29770
29771 This feature affects the behavior of the DELETE key.
29772 If set, Delete will be equivalent to ^D, and delete
29773 the current character.  Normally Alpine defines the Delete key
29774 to be equivalent to ^H, which deletes the <EM>previous</EM>
29775 character.
29776
29777 <P>
29778 &lt;End of help on this topic&gt;
29779 </BODY>
29780 </HTML>
29781 ====== h_config_compose_bg_post =====
29782 <HTML>
29783 <HEAD>
29784 <TITLE>FEATURE: <!--#echo var="FEAT_enable-background-sending"--></TITLE>
29785 </HEAD>
29786 <BODY>
29787 <H1>FEATURE: <!--#echo var="FEAT_enable-background-sending"--></H1>
29788
29789 This feature affects the behavior of Alpine's mail sending.  If set, this
29790 feature enables a subcommand in the composer's "Send?" confirmation
29791 prompt.  The subcommand allows you to tell Alpine to handle the actual
29792 posting in the background.  While this feature usually allows posting
29793 to appear to happen very fast, it has no affect on the actual delivery
29794 time it takes a message to arrive at its destination.
29795
29796 <P>
29797 Please Note:
29798 <OL>
29799  <LI>This feature will have no effect if the feature
29800        <A HREF="h_config_send_wo_confirm">&quot;<!--#echo var="FEAT_send-without-confirm"-->&quot;</A>
29801        is set.
29802  <LI>This feature isn't supported on all systems.  All DOS and Windows,
29803        as well as several Unix ports, do not recognize this feature.
29804  <LI>Error handling is significantly different when this feature is
29805         enabled.  Any message posting failure results in the message
29806         being appended to your &quot;Interrupted&quot; mail folder.  When you
29807         type the <A HREF="h_common_compose">C</A>ompose command,
29808         Alpine will notice this folder and
29809         offer to extract any messages contained.  Upon continuing a
29810         failed message, Alpine will display the nature of the failure
29811         in the status message line.
29812  <LI> <EM>WARNING</EM>: Under extreme conditions, it is possible
29813         for message data to
29814         get lost.  <EM>Do</EM> <EM>not</EM> enable this feature
29815         if you typically run close to any sort of disk-space limits or quotas.
29816 </OL>
29817 <P>
29818 &lt;End of help on this topic&gt;
29819 </BODY>
29820 </HTML>
29821 ====== h_config_compose_dsn =====
29822 <HTML>
29823 <HEAD>
29824 <TITLE>FEATURE: <!--#echo var="FEAT_enable-delivery-status-notification"--></TITLE>
29825 </HEAD>
29826 <BODY>
29827 <H1>FEATURE: <!--#echo var="FEAT_enable-delivery-status-notification"--></H1>
29828
29829 This feature affects the behavior of Alpine's mail sending.  If set, this
29830 feature enables a subcommand in the composer's &quot;Send?&quot; confirmation
29831 prompt.  The subcommand allows you to tell Alpine to request the type of
29832 Delivery Status Notification (DSN) that you would like.  Most users will
29833 be happy with the default, and need not enable this feature.
29834 <P>
29835 If the feature
29836 <A HREF="h_config_send_wo_confirm">&quot;<!--#echo var="FEAT_send-without-confirm"-->&quot;</A> is set,
29837 then this feature has no effect and the type of DSN is not selectable.
29838
29839 <P>
29840 Turning on this feature and then turning on the DSNOpts from the send
29841 prompt reveals four on-off toggles at the bottom of the screen.
29842 The &quot;X&quot; command toggles between NoErrRets and ErrRets.  NoErrRets requests
29843 that no notification be returned to you, even if there is a delivery
29844 failure.  The &quot;D&quot; key toggles between Delay and NoDelay.  This tells the
29845 server that you are willing (or not) to receive delay notifications, which
29846 happen when there is an unusual delay at some mail server (in that mail
29847 server's opinion).  The &quot;S&quot; key toggles between Success and NoSuccess.
29848 Success requests that you be sent a DSN message when the message is
29849 successfully delivered to the recipients mailbox.  Setting NoErrRets will
29850 automatically turn off Delay and Success notification, and will flip the
29851 toggles to show that.  Similarly, turning on Delay and/or Success will
29852 automatically toggle the &quot;X&quot; key to ErrRets.  The fourth command, the
29853 &quot;H&quot; key, toggles between RetHdrs and RetFull.  RetFull requests that
29854 the full message be returned in any failed DSN.  RetHdrs requests that
29855 only the headers be returned in any failed DSN.  Notice that this command
29856 applies only to failed delivery status reports.  For delay or success
29857 reports, the full message is never returned, only the headers are returned.
29858
29859 <P>
29860 If you don't enable the DSN feature or if you don't turn it on for a
29861 particular message, the default is that you will be notified about failures,
29862 you might be notified about delays, and you won't be notified about
29863 successes.  You will usually receive the full message back when there is
29864 a failure.
29865
29866 <P>
29867 If you turn on the DSNOpts the default is to return as much information as
29868 possible to you.  That is, by default, the Success and Delay options are
29869 turned on and the full message will be returned on failure.
29870
29871 <P>
29872 The sending prompt will display the current DSN request (if any) in a
29873 shorthand form.  It will be:
29874
29875 <P><CENTER>[Never]</CENTER>
29876
29877 <P>
29878 if you have requested NoErrRets.  Otherwise, it will look something like:
29879
29880 <P><CENTER>[FDS-Hdrs]</CENTER>
29881
29882 <P>
29883 The &quot;F&quot; will always be there, indicating that you will be notified
29884 of failures.  (Alpine doesn't provide a way to request no failure notification
29885 and at the same time request either success or delay notification.  The only
29886 way to request no failure notifications is to request no notifications at
29887 all with NoErrRets.)  The &quot;D&quot; and/or &quot;S&quot; will be present if you have
29888 requested Delay and/or Success notification.  If one of those is missing,
29889 that means you are requesting no notification of the corresponding type.
29890 After the dash it will say either Hdrs or Full.  Hdrs means to return only
29891 the headers and Full means to return the full message (applies to
29892 failure notifications only).
29893
29894 <P>
29895 NOTE: This feature relies on your system's mail transport agent or
29896 configured
29897 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>
29898 having the negotiation mechanism introduced in
29899 &quot;Extended SMTP&quot; (ESMTP) and the specific extension called
29900 &quot;Delivery Status Notification&quot; (DSN).  If the mail transport agent you
29901 are using doesn't support DSN, a short warning will be shown to you on
29902 the message line at the bottom of the screen after you send your message,
29903 but your message will have been sent anyway.
29904
29905 <P>
29906 Note that DSNs don't provide a mechanism to request read receipts.  That
29907 is, if you request notification on success you are notified when the
29908 message is delivered to the mailbox, not when the message is read.
29909
29910 <P>
29911 ESMTP allows for graceful migration to upgraded mail transfer agents, but
29912 it is possible that this feature might cause problems for some servers.
29913
29914 <P>
29915 &lt;End of help on this topic&gt;
29916 </BODY>
29917 </HTML>
29918 ====== h_config_auto_zoom =====
29919 <HTML>
29920 <HEAD>
29921 <TITLE>FEATURE: <!--#echo var="FEAT_auto-zoom-after-select"--></TITLE>
29922 </HEAD>
29923 <BODY>
29924 <H1>FEATURE: <!--#echo var="FEAT_auto-zoom-after-select"--></H1>
29925
29926 This feature affects the behavior of the Select command.
29927 If set, the select command will automatically perform a zoom
29928 after the select is complete.
29929 This feature is set by default.
29930 <P>
29931 Some related help topics are
29932 <UL>
29933 <LI> <A HREF="h_mainhelp_aggops">Aggregate Operations</A>
29934 <LI> <A HREF="h_index_cmd_select">Selecting: Select and WhereIs/Select</A>,
29935 <LI> <A HREF="h_config_enable_agg_ops"><!--#echo var="FEAT_enable-aggregate-command-set"--></A>,
29936 <LI> <A HREF="h_config_auto_unzoom"><!--#echo var="FEAT_auto-unzoom-after-apply"--></A>, and
29937 <LI> <A HREF="h_config_auto_unselect"><!--#echo var="FEAT_auto-unselect-after-apply"--></A>.
29938 <LI> <A HREF="h_config_select_wo_confirm"><!--#echo var="FEAT_select-without-confirm"--></A>.
29939 </UL>
29940
29941 <P>
29942 &lt;End of help on this topic&gt;
29943 </BODY>
29944 </HTML>
29945 ====== h_config_auto_unzoom =====
29946 <HTML>
29947 <HEAD>
29948 <TITLE>FEATURE: <!--#echo var="FEAT_auto-unzoom-after-apply"--></TITLE>
29949 </HEAD>
29950 <BODY>
29951 <H1>FEATURE: <!--#echo var="FEAT_auto-unzoom-after-apply"--></H1>
29952
29953 This feature affects the behavior of the Apply command.  If set, and if
29954 you are currently looking at a Zoomed Index view of selected messages,
29955 the Apply command will do the operation you specify, but then will
29956 implicitly do an &quot;UnZoom&quot;, so that you will automatically be back in
29957 the normal Index view after the Apply.
29958 This feature is set by default.
29959
29960 <P>
29961 Some related help topics are
29962 <UL>
29963 <LI> <A HREF="h_mainhelp_aggops">Aggregate Operations</A>
29964 <LI> <A HREF="h_index_cmd_select">Selecting: Select and WhereIs/Select</A>,
29965 <LI> <A HREF="h_config_enable_agg_ops"><!--#echo var="FEAT_enable-aggregate-command-set"--></A>,
29966 <LI> <A HREF="h_config_auto_unselect"><!--#echo var="FEAT_auto-unselect-after-apply"--></A>.
29967 <LI> <A HREF="h_config_auto_zoom"><!--#echo var="FEAT_auto-zoom-after-select"--></A>, and
29968 <LI> <A HREF="h_config_select_wo_confirm"><!--#echo var="FEAT_select-without-confirm"--></A>.
29969 </UL>
29970 <P>
29971 &lt;End of help on this topic&gt;
29972 </BODY>
29973 </HTML>
29974 ====== h_config_auto_unselect =====
29975 <HTML>
29976 <HEAD>
29977 <TITLE>FEATURE: <!--#echo var="FEAT_auto-unselect-after-apply"--></TITLE>
29978 </HEAD>
29979 <BODY>
29980 <H1>FEATURE: <!--#echo var="FEAT_auto-unselect-after-apply"--></H1>
29981
29982 This feature affects the behavior of the Apply command.  If set,
29983 the Apply command will do the operation you specify, but then will
29984 implicitly do an &quot;UnSelect All&quot;, so that you will automatically be back in
29985 the normal Index view after the Apply.
29986
29987 <P>
29988 Some related help topics are
29989 <UL>
29990 <LI> <A HREF="h_mainhelp_aggops">Aggregate Operations</A>
29991 <LI> <A HREF="h_index_cmd_select">Selecting: Select and WhereIs/Select</A>,
29992 <LI> <A HREF="h_config_enable_agg_ops"><!--#echo var="FEAT_enable-aggregate-command-set"--></A>,
29993 <LI> <A HREF="h_config_auto_zoom"><!--#echo var="FEAT_auto-zoom-after-select"--></A>, and
29994 <LI> <A HREF="h_config_auto_unzoom"><!--#echo var="FEAT_auto-unzoom-after-apply"--></A>, and
29995 <LI> <A HREF="h_config_select_wo_confirm"><!--#echo var="FEAT_select-without-confirm"--></A>.
29996 </UL>
29997 <P>
29998 &lt;End of help on this topic&gt;
29999 </BODY>
30000 </HTML>
30001 ====== h_config_fast_recent =====
30002 <HTML>
30003 <HEAD>
30004 <TITLE>FEATURE: <!--#echo var="FEAT_enable-fast-recent-test"--></TITLE>
30005 </HEAD>
30006 <BODY>
30007 <H1>FEATURE: <!--#echo var="FEAT_enable-fast-recent-test"--></H1>
30008
30009 This feature controls the behavior of the TAB key when traversing folders
30010 in the optional
30011 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
30012 collection or in optional <!--#echo var="VAR_news-collections"-->.
30013
30014 <P>
30015 When the TAB
30016 (<A HREF="h_common_nextnew">NextNew</A>)
30017 key is pressed, the default behavior is to
30018 explicitly examine the status of the folder for the number of recent
30019 messages (messages delivered since the last time it was viewed).
30020 Depending on the size and number of messages in the folder, this test
30021 can be time consuming.
30022
30023 <P>
30024 Enabling this feature will cause Alpine to only test for the existence of
30025 any recent messages rather than to obtain the count.  This is much faster
30026 in many cases.  The downside is that you're not given the number of recent
30027 messages when prompted to view the next folder.
30028 If the feature
30029 <A HREF="h_config_tab_uses_unseen">&quot;<!--#echo var="FEAT_tab-uses-unseen-for-next-folder"-->&quot;</A>
30030 is turned on, then the present feature will have no effect.
30031
30032 <P>
30033 <UL>
30034 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30035 </UL><P>
30036 &lt;End of help on this topic&gt;
30037 </BODY>
30038 </HTML>
30039 ====== h_config_arrow_nav =====
30040 <HTML>
30041 <HEAD>
30042 <TITLE>FEATURE: <!--#echo var="FEAT_enable-arrow-navigation"--></TITLE>
30043 </HEAD>
30044 <BODY>
30045 <H1>FEATURE: <!--#echo var="FEAT_enable-arrow-navigation"--></H1>
30046
30047 This feature controls the behavior of the left and right arrow keys.
30048 If set, the left and right arrow keys will operate like the usual
30049 navigation keys &lt; and &gt;.
30050 This feature is set by default.
30051
30052 <P>
30053 If you set this feature, and do not like the changed behavior of the up/down
30054 arrow
30055 keys when navigating through the FOLDER LIST screen --
30056 <B>first</B> from column to column, if more than one folder is
30057 displayed per row,
30058 and <B>then</B> from row to row -- you may either also wish to set the feature
30059 &quot;<A HREF="h_config_relaxed_arrow_nav"><!--#echo var="FEAT_enable-arrow-navigation-relaxed"--></A>&quot;,
30060 &quot;<A HREF="h_config_single_list"><!--#echo var="FEAT_single-column-folder-list"--></A>&quot;, or
30061 use the ^P/^N (instead of up/down arrow) keys to move up/down the list of
30062 folders in each column.
30063 <P>
30064 <UL>
30065 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30066 </UL><P>
30067 &lt;End of help on this topic&gt;
30068 </BODY>
30069 </HTML>
30070 ====== h_config_relaxed_arrow_nav =====
30071 <HTML>
30072 <HEAD>
30073 <TITLE>FEATURE: <!--#echo var="FEAT_enable-arrow-navigation-relaxed"--></TITLE>
30074 </HEAD>
30075 <BODY>
30076 <H1>FEATURE: <!--#echo var="FEAT_enable-arrow-navigation-relaxed"--></H1>
30077
30078 This feature controls the behavior of the left, right, up and down
30079 arrow keys in the FOLDER LIST screen when the &quot;<A
30080 HREF="h_config_arrow_nav"><!--#echo var="FEAT_enable-arrow-navigation"--></A>&quot; feature is
30081 set.
30082 This feature is set by default.
30083
30084 <P>
30085
30086 When this feature is set, the left and right
30087 arrow keys in the FOLDER LIST screen
30088 move the highlight bar to the left or right, and the up and
30089 down arrows move it up or down.
30090
30091 <P>
30092 When the &quot;<!--#echo var="FEAT_enable-arrow-navigation"-->&quot; feature is set and this
30093 feature is not set;
30094 the left and right arrow keys in the Folder List screen strictly
30095 track the commands bound to the '&lt;' and '&gt;' keys, and the up
30096 and down arrow keys move the highlight bar to the previous and next
30097 folder or directory name.
30098
30099 <P>
30100 <UL>
30101 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30102 </UL><P>
30103 &lt;End of help on this topic&gt;
30104 </BODY>
30105 </HTML>
30106 ====== h_config_alt_compose_menu =====
30107 <HTML>
30108 <HEAD>
30109 <TITLE>FEATURE: <!--#echo var="FEAT_alternate-compose-menu"--></TITLE>
30110 </HEAD>
30111 <BODY>
30112 <H1>FEATURE: <!--#echo var="FEAT_alternate-compose-menu"--></H1>
30113
30114 This feature controls the menu that is displayed when Compose is selected.
30115 If set, a list of options will be presented, with each option representing
30116 the type of composition that could be used. This feature is most useful for
30117 users who want to avoid being prompted with each option separately, or who
30118 want to avoid the checking of remote postponed or form letter folders.
30119 The possible types of composition are:
30120
30121 <P>
30122 New, for starting a new composition. Note that if New is selected and roles
30123 are set, roles are checked for matches and applied according to the setting
30124 of the matching role.
30125
30126 <P>
30127 Interrupted, for continuing an interrupted composition. This option is only
30128 offered if an interrupted message folder is detected.
30129
30130 <P>
30131 Postponed, for continuing postponed compositions. This option is offered
30132 if a <!--#echo var="VAR_postponed-folder"--> is set in the config REGARDLESS OF whether or not
30133 the postponed folder actually exists. This option is especially handy
30134 for avoiding having to check for the existence of a remote postponed folder.
30135
30136 <P>
30137 Form, for using form letters. This option is offered if the <!--#echo var="VAR_form-letter-folder"-->
30138 is set in the config, and is not checked for existence for reasons similar
30139 to those explained by the postponed option.
30140
30141 <P>
30142 setRole, for selecting a role to apply to a composition.
30143
30144 <P>
30145 &lt;End of help on this topic&gt;
30146 </BODY>
30147 </HTML>
30148 ====== h_config_alt_role_menu =====
30149 <HTML>
30150 <HEAD>
30151 <TITLE>FEATURE: <!--#echo var="FEAT_alternate-role-menu"--></TITLE>
30152 </HEAD>
30153 <BODY>
30154 <H1>FEATURE: <!--#echo var="FEAT_alternate-role-menu"--></H1>
30155
30156 Normally the <A HREF="h_common_role">Role Command</A> allows you to choose
30157 a role and compose a new message using that role.
30158 When this feature is set, the role command will first ask whether you want to
30159 Compose a new message, Forward the current message, Reply to the
30160 current message, or Bounce the current message.
30161 If you are not in the MESSAGE INDEX and are not viewing a message,
30162 then there is no current message and the question will be skipped.
30163 After you have chosen to Compose, Forward, Reply, or Bounce you will
30164 then choose the role to be used.
30165 <P>
30166 When Bouncing the &quot;Set From&quot; address is used for the
30167 Resent-From header, the &quot;Set Fcc&quot; value is used for the Fcc
30168 provided that the option
30169 <A HREF="h_config_fcc_on_bounce">&quot;<!--#echo var="FEAT_fcc-on-bounce"-->&quot;</A> is turned on,
30170 and the &quot;Use SMTP Server&quot; value is used for the SMTP server, if
30171 set.
30172 Other actions of the role are ignored when Bouncing.
30173
30174 <P>
30175 &lt;End of help on this topic&gt;
30176 </BODY>
30177 </HTML>
30178 ====== h_config_always_spell_check =====
30179 <HTML>
30180 <HEAD>
30181 <TITLE>FEATURE: <!--#echo var="FEAT_spell-check-before-sending"--></TITLE>
30182 </HEAD>
30183 <BODY>
30184 <H1>FEATURE: <!--#echo var="FEAT_spell-check-before-sending"--></H1>
30185 <P>
30186 When this feature is set, every composed message will be spell-checked before
30187 being sent.
30188 <P>
30189 &lt;End of help on this topic&gt;
30190 </BODY>
30191 </HTML>
30192 ====== h_config_quell_asterisks =====
30193 <HTML>
30194 <HEAD>
30195 <TITLE>FEATURE: <!--#echo var="FEAT_suppress-asterisks-in-password-prompt"--></TITLE>
30196 </HEAD>
30197 <BODY>
30198 <H1>FEATURE: <!--#echo var="FEAT_suppress-asterisks-in-password-prompt"--></H1>
30199 <P>
30200 When you are running Alpine you will sometimes be asked for a password
30201 in a prompt on the third line from the bottom of the screen.
30202 Normally each password character you type will cause an asterisk to echo
30203 on the screen. That gives you some feedback to know that your typing is
30204 being recognized.
30205 There is a very slight security risk in doing it this way because someone
30206 watching over your shoulder might be able to see how many characters there
30207 are in your password.
30208 If you'd like to suppress the echoing of the asterisks set this feature.
30209 <P>
30210 &lt;End of help on this topic&gt;
30211 </BODY>
30212 </HTML>
30213 ====== h_config_quell_flowed_text =====
30214 <HTML>
30215 <HEAD>
30216 <TITLE>FEATURE: <!--#echo var="FEAT_quell-flowed-text"--></TITLE>
30217 </HEAD>
30218 <BODY>
30219 <H1>FEATURE: <!--#echo var="FEAT_quell-flowed-text"--></H1>
30220 <P>
30221 Alpine generates flowed text where possible.
30222 The method for generating flowed text is defined by
30223 <A HREF="http://www.ietf.org/rfc/rfc3676.txt">RFC 3676</A>,
30224 the benefit of doing so is
30225 to send message text that can properly be viewed both on normal width displays
30226 and on displays with smaller or larger than normal screen widths.
30227 With flowed text, a space at the end of a line tells the receiving mail
30228 client that the following line belongs to the same paragraph.
30229 Quoted text will also be affected, with only the innermost
30230 level of &quot;&gt;&quot; quoting being followed by a space.
30231 However, if you have changed the
30232 <A HREF="h_config_reply_indent_string">&quot;<!--#echo var="VAR_reply-indent-string"-->&quot;</A>
30233 so that it is not equal to the default value of &quot;&gt;&nbsp;&quot;, then
30234 quoted text will not be flowed.
30235 For this reason, we recommend that you leave your
30236 &quot;<!--#echo var="VAR_reply-indent-string"-->&quot; set to the default.
30237 <P>
30238 This feature turns off the generation of flowed text, as it might be
30239 desired to more tightly control how a message is displayed on the receiving end.
30240 <P>
30241 If this feature is <EM>not</EM> set, you can control on a message by message
30242 basis whether or not flowed text is generated.
30243 You do this by typing ^V at the Send confirmation prompt that you get
30244 after typing ^X to send a message.
30245 ^V is a toggle that turns flowing off and back on if typed again.
30246 If for some reason flowing cannot be done on a particular message, then the
30247 ^V command will not be available.
30248 This would be the case, for example, if this feature was set, or if your
30249 &quot;<!--#echo var="VAR_reply-indent-string"-->&quot; was set to a non-default value.
30250 If the feature
30251 <A HREF="h_config_send_wo_confirm">&quot;<!--#echo var="FEAT_send-without-confirm"-->&quot;</A> is set,
30252 then the opportunity to control on a message by message basis
30253 whether or not flowed text is generated is lost.
30254 <P>
30255 When this feature is not set and you have typed ^V to turn off flowing,
30256 the Send confirmation prompt will change to look like
30257 <P>
30258 <CENTER><SAMP>Send message (not flowed)?</SAMP></CENTER>
30259 <P>
30260 <A HREF="h_config_strip_ws_before_send">&quot;<!--#echo var="FEAT_strip-whitespace-before-send"-->&quot;</A> will
30261 also turn off the sending of flowed text messages, but it differs in that
30262 it also trims all trailing white space from a message before sending it.
30263 <P>
30264 If alternate editors are used extensively, be aware that a message will still
30265 be sent flowed if this feature is unset.  In most cases this will be fine,
30266 but if the editor has a &quot;flowed text&quot; mode, it would be best to
30267 use that.
30268 <P>
30269 &lt;End of help on this topic&gt;
30270 </BODY>
30271 </HTML>
30272 ====== h_config_strip_ws_before_send =====
30273 <HTML>
30274 <HEAD>
30275 <TITLE>FEATURE: <!--#echo var="FEAT_strip-whitespace-before-send"--></TITLE>
30276 </HEAD>
30277 <BODY>
30278 <H1>FEATURE: <!--#echo var="FEAT_strip-whitespace-before-send"--></H1>
30279 <P>
30280 By default, trailing whitespace is not stripped from
30281 a message before sending.  Trailing whitespace should have no effect on an
30282 email message, and in flowed text can aid in delimiting paragraphs.
30283 However, the old behavior of stripping trailing whitespace was in place
30284 to better deal with older clients that couldn't handle certain types of
30285 text encodings.  This feature restores the old behavior
30286 <P>
30287 Trailing whitespace is of aid to flowed-text-formatted messages, which are
30288 generated by default but can be turned off via the
30289 <A HREF="h_config_quell_flowed_text">&quot;<!--#echo var="FEAT_quell-flowed-text"-->&quot;</A> feature.
30290 <!--#echo var="FEAT_strip-whitespace-before-send"--> also has the effect of turning off sending
30291 of flowed text.
30292 <P>
30293 &lt;End of help on this topic&gt;
30294 </BODY>
30295 </HTML>
30296 ====== h_config_alt_reply_menu =====
30297 <HTML>
30298 <HEAD>
30299 <TITLE>FEATURE: <!--#echo var="FEAT_alternate-reply-menu"--></TITLE>
30300 </HEAD>
30301 <BODY>
30302 <H1>FEATURE: <!--#echo var="FEAT_alternate-reply-menu"--></H1>
30303
30304 Note that if this option is enabled, then the option
30305 <A HREF="h_config_auto_include_reply"><!--#echo var="FEAT_include-text-in-reply"--></A>
30306 is ignored. See below to understand why.
30307 <P>
30308 When you reply to a message, a series of questions are asked that
30309 determines how your reply will be handled by Alpine. This feature only
30310 affects the result of the first question you are asked, and its purpose is
30311 to set values that could override defaults set in Alpine's main
30312 configuration screen. As a result, this menu allows you to configure even
30313 more features than you would be able to do without this option. For
30314 example, this menu always allows you to override or select a <A
30315 HREF="h_rules_roles">Role</A> if you have defined one, or allows you to
30316 override your indent string, regardless of if you have enabled
30317 <A HREF="h_config_prefix_editing"><!--#echo var="FEAT_enable-reply-indent-string-editing"--></A>.
30318 The full list of options can be found below.
30319 <P>
30320 Here is an example of how this option works. After you press Reply,
30321 if you see &quot;A Inc Attach&quot; in the menu, it means that
30322 if you press &quot;A&quot;, then Alpine will include the attachments
30323 of the original message, and the default is not to include them.
30324 Conversely, if you see &quot;A No Attach&quot;
30325 then by pressing &quot;A&quot; Alpine will not include
30326 attachments in your reply, and the default is that Alpine will
30327 include them in your reply. The value that you see when you
30328 start your reply is controlled by the option
30329 <A HREF="h_config_attach_in_reply">
30330 <!--#echo var="FEAT_include-attachments-in-reply"-->
30331 </A>. If the feature is enabled, then Alpine will display
30332 &quot;A No Attach&quot; to override the default behavior. You can
30333 toggle between the two values of this option by pressing &quot;A&quot;.
30334 Remember that the value that you see in the menu is the action that will
30335 be done when you press the associated command.
30336 <P>
30337 Below are your options:
30338 <OL>
30339 <LI><B>A</B>: This determines if Alpine will include or not the
30340 attachments sent to you in the message that you are replying to. The default
30341 is to use the value of the configuration option
30342 <A HREF="h_config_attach_in_reply"><!--#echo var="FEAT_include-attachments-in-reply"--></A> and can be overridden by using this command.
30343
30344 <LI><B>H</B>: This command determines if the headers of a message are
30345 included in the body of the message that is being replied to. By default
30346 Alpine will use the value of the configuration option
30347 <A HREF="h_config_include_header"><!--#echo var="FEAT_include-header-in-reply"--></A>.
30348 Observe that by toggling this option to include headers, text will be toggled
30349 to be included by default.
30350
30351 <LI><B>R</B>: Can be used to set a role different from the default.
30352
30353 <LI><B>S</B>: Determines if Alpine will strip the signature from a
30354 message. The default is to strip the signature when the message is not
30355 viewed in headers mode, and you either have enabled
30356 <A HREF="h_config_sigdashes"><!--#echo var="FEAT_enable-sigdashes"--></A>
30357 or
30358 <A HREF="h_config_strip_sigdashes"><!--#echo var="FEAT_strip-from-sigdashes-on-reply"--></A>.
30359
30360 <LI><B>Ctrl-R</B>: Can be used to edit the
30361 <A HREF="h_config_reply_indent_string">&quot;<!--#echo var="VAR_reply-indent-string"-->&quot;</A>.
30362 </OL>
30363 <P>
30364 In order to include the text of the original message in the reply
30365 you either need to press 'y' to include the original text, or 'n' to
30366 exclude it from the reply. Pressing return will execute the default
30367 action, which is to include text only if the option
30368 <A HREF="h_config_auto_include_reply"><!--#echo var="FEAT_include-text-in-reply"--></A>
30369 is enabled. However, notice that the default is to include text if you edit the
30370 reply indent string or if you explicitly set through this menu that you
30371 want headers included in the reply message.
30372
30373 <P>
30374 &lt;End of help on this topic&gt;
30375 </BODY>
30376 </HTML>
30377 ====== h_config_del_from_dot =====
30378 <HTML>
30379 <HEAD>
30380 <TITLE>FEATURE: <!--#echo var="FEAT_compose-cut-from-cursor"--></TITLE>
30381 </HEAD>
30382 <BODY>
30383 <H1>FEATURE: <!--#echo var="FEAT_compose-cut-from-cursor"--></H1>
30384
30385 This feature controls the behavior of the Ctrl-K command in the composer.
30386 If set, ^K will cut from the current cursor position to the end of the line,
30387 rather than cutting the entire line.
30388
30389 <P>
30390 &lt;End of help on this topic&gt;
30391 </BODY>
30392 </HTML>
30393 ====== h_config_print_index =====
30394 <HTML>
30395 <HEAD>
30396 <TITLE>FEATURE: <!--#echo var="FEAT_print-index-enabled"--></TITLE>
30397 </HEAD>
30398 <BODY>
30399 <H1>FEATURE: <!--#echo var="FEAT_print-index-enabled"--></H1>
30400
30401 This feature controls the behavior of the Print command when in the
30402 MESSAGE INDEX screen.  If set, the print command will give you a prompt
30403 asking if you wish to print the message index, or the currently highlighted
30404 message. If not set, the message will be printed.
30405
30406 <P>
30407 &lt;End of help on this topic&gt;
30408 </BODY>
30409 </HTML>
30410 ====== h_config_allow_talk =====
30411 <HTML>
30412 <HEAD>
30413 <TITLE>FEATURE: <!--#echo var="FEAT_allow-talk"--></TITLE>
30414 </HEAD>
30415 <BODY>
30416 <H1>FEATURE: <!--#echo var="FEAT_allow-talk"--></H1>
30417
30418 UNIX Alpine only.
30419 <P>
30420 By default, permission for others to &quot;talk&quot; to your terminal is turned
30421 off when you are running Alpine.  When this feature is set, permission is
30422 instead turned on.  If enabled, you may see unexpected messages in the
30423 middle of your Alpine screen from someone attempting to contact you via the
30424 &quot;talk&quot; program.
30425
30426 <P>
30427 NOTE: The &quot;talk&quot; program has nothing to do with Alpine or email.  The
30428 talk daemon on your system will attempt to print a message on your screen
30429 when someone else is trying to contact you.  If you wish to see these
30430 messages while you are running Alpine, you should enable this feature.
30431
30432 <P>
30433 If you do enable this feature and see a &quot;talk&quot; message, you must
30434 suspend or quit Alpine before you can respond.
30435
30436 <P>
30437 &lt;End of help on this topic&gt;
30438 </BODY>
30439 </HTML>
30440 ====== h_config_send_filter_dflt =====
30441 <HTML>
30442 <HEAD>
30443 <TITLE>FEATURE: <!--#echo var="FEAT_compose-send-offers-first-filter"--></TITLE>
30444 </HEAD>
30445 <BODY>
30446 <H1>FEATURE: <!--#echo var="FEAT_compose-send-offers-first-filter"--></H1>
30447 If you have <A HREF="h_config_sending_filter">&quot;<!--#echo var="VAR_sending-filters"-->&quot;</A>
30448 configured, setting this feature will cause
30449 the first filter in the <!--#echo var="VAR_sending-filters"--> list to be offered as the default
30450 instead of unfiltered, the usual default.
30451 <P>
30452 <UL>
30453 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30454 </UL><P>
30455 &lt;End of help on this topic&gt;
30456 </BODY>
30457 </HTML>
30458 ====== h_config_custom_print =====
30459 <HTML>
30460 <HEAD>
30461 <TITLE>FEATURE: <!--#echo var="FEAT_print-offers-custom-cmd-prompt"--></TITLE>
30462 </HEAD>
30463 <BODY>
30464 <H1>FEATURE: <!--#echo var="FEAT_print-offers-custom-cmd-prompt"--></H1>
30465
30466 When this feature is set, the print command will have an additional
30467 subcommand called "C CustomPrint".  If selected, you will have
30468 the opportunity to enter any system print command --instead of being
30469 restricted to using those that have been previously configured in the
30470 printer setup menu.
30471 <P>
30472
30473 &lt;End of help on this topic&gt;
30474 </BODY>
30475 </HTML>
30476 ====== h_config_enable_dot_files =====
30477 <HTML>
30478 <HEAD>
30479 <TITLE>FEATURE: <!--#echo var="FEAT_enable-dot-files"--></TITLE>
30480 </HEAD>
30481 <BODY>
30482 <H1>FEATURE: <!--#echo var="FEAT_enable-dot-files"--></H1>
30483
30484 When this feature is set, files beginning with dot (".") will be
30485 visible in the file browser.  For example, you'll be able to select them
30486 when using the browser to add an attachment to a message.
30487 <P>
30488 &lt;End of help on this topic&gt;
30489 </BODY>
30490 </HTML>
30491 ====== h_config_enable_dot_folders =====
30492 <HTML>
30493 <HEAD>
30494 <TITLE>FEATURE: <!--#echo var="FEAT_enable-dot-folders"--></TITLE>
30495 </HEAD>
30496 <BODY>
30497 <H1>FEATURE: <!--#echo var="FEAT_enable-dot-folders"--></H1>
30498
30499 When this feature is set, folders beginning with dot (".") may be added
30500 and viewed.
30501 <P>
30502 &lt;End of help on this topic&gt;
30503 </BODY>
30504 </HTML>
30505 ====== h_config_ff_between_msgs =====
30506 <HTML>
30507 <HEAD>
30508 <TITLE>FEATURE: <!--#echo var="FEAT_print-formfeed-between-messages"--></TITLE>
30509 </HEAD>
30510 <BODY>
30511 <H1>FEATURE: <!--#echo var="FEAT_print-formfeed-between-messages"--></H1>
30512
30513 Setting this feature causes a formfeed to be printed between messages when
30514 printing multiple messages (with Apply Print command).
30515 <P>
30516 &lt;End of help on this topic&gt;
30517 </BODY>
30518 </HTML>
30519 ====== h_config_blank_keymenu =====
30520 <HTML>
30521 <HEAD>
30522 <TITLE>FEATURE: <!--#echo var="FEAT_disable-keymenu"--></TITLE>
30523 </HEAD>
30524 <BODY>
30525 <H1>FEATURE: <!--#echo var="FEAT_disable-keymenu"--></H1>
30526
30527 If this feature is set the command key menu that normally appears on the
30528 bottom two lines of the screen will not usually be there.  Asking for
30529 help with ^G or ? will cause the key menu to appear instead of causing
30530 the help message to come up.  If you want to actually see the help text,
30531 another ^G or ? will show it to you.  After the key menu has popped
30532 up with the help key it will remain there for an O for Other command but
30533 disappear if any other command is typed.
30534 <P>
30535 &lt;End of help on this topic&gt;
30536 </BODY>
30537 </HTML>
30538 ====== h_config_enable_mouse =====
30539 <HTML>
30540 <HEAD>
30541 <TITLE>FEATURE: <!--#echo var="FEAT_enable-mouse-in-xterm"--></TITLE>
30542 </HEAD>
30543 <BODY>
30544 <H1>FEATURE: <!--#echo var="FEAT_enable-mouse-in-xterm"--></H1>
30545
30546 This feature controls whether or not an X terminal mouse can be used with
30547 Alpine.  If set, and the $DISPLAY variable indicates that an X terminal is
30548 being used, the left mouse button on the mouse can be used to select text
30549 or commands.
30550 Clicking on a command at the bottom of the screen will behave as if you had
30551 typed that command.
30552 Clicking on an index line will move the current message highlight to
30553 that line.
30554 Double-clicking on an index line will view the message.
30555 Double-clicking on a link will view the link.
30556 <P>
30557 This type of mouse support will also work in some terminal emulators which are
30558 not actually X terminals, but which have extra code to support the xterm
30559 style mouse.
30560 For those emulators you not only need to turn this feature on but you also
30561 have to set the $DISPLAY environment variable even though it isn't needed
30562 for your terminal.
30563 That will cause Alpine to think that it is an xterm and to properly interpret the
30564 escape sequences sent by the mouse.
30565 <P>
30566 Note: if this feature is set, the behavior of X terminal cut-and-paste is
30567 also modified.  It is sometimes possible to hold the shift key down while clicking
30568 left or middle mouse buttons for the normal xterm cut/paste operations.
30569 There is also an Alpine command to toggle this mode on or off.
30570 The command is Ctrl-&#92; (Control-backslash).
30571 <P>
30572 &lt;End of help on this topic&gt;
30573 </BODY>
30574 </HTML>
30575 ====== h_config_enable_xterm_newmail =====
30576 <HTML>
30577 <HEAD>
30578 <TITLE>FEATURE: <!--#echo var="FEAT_enable-newmail-in-xterm-icon"--></TITLE>
30579 </HEAD>
30580 <BODY>
30581 <H1>FEATURE: <!--#echo var="FEAT_enable-newmail-in-xterm-icon"--></H1>
30582
30583 This feature controls whether or not Alpine will attempt to announce new
30584 mail arrival when it is running in an X terminal window and that window
30585 is iconified.  If set, and the $DISPLAY variable indicates that an X
30586 terminal is being used, Alpine will send appropriate escape sequences to
30587 the X terminal to modify the label on Alpine's icon to indicate that new
30588 mail has arrived. Alpine will also modify the Alpine window's title to
30589 indicate new mail.
30590 See also <a href="h_config_enable_newmail_short_text"><!--#echo var="FEAT_enable-newmail-short-text-in-icon"--></a>.
30591 <P>
30592 &lt;End of help on this topic&gt;
30593 </BODY></HTML>
30594 ====== h_config_enable_newmail_short_text =====
30595 <HTML>
30596 <HEAD>
30597 <TITLE>FEATURE: <!--#echo var="FEAT_enable-newmail-short-text-in-icon"--></TITLE>
30598 </HEAD>
30599 <BODY>
30600 <H1>FEATURE: <!--#echo var="FEAT_enable-newmail-short-text-in-icon"--></H1>
30601
30602 This feature controls the text to be displayed in an icon in the event
30603 of a new message arrival.  Normally, the message will
30604 be the one that is displayed on the screen.  This feature shortens the
30605 message to a count of the number of new messages in brackets.  This may be
30606 more useful for those who use the window's title bar in the task bar as a
30607 new mail indicator.  This feature is only useful if the
30608 <A HREF="h_config_enable_xterm_newmail"><!--#echo var="FEAT_enable-newmail-in-xterm-icon"--></A>
30609 feature is also set.  Like the <!--#echo var="FEAT_enable-newmail-in-xterm-icon"-->
30610 feature, this feature is only relevant when run in an xterm environment.
30611 <P>
30612 &lt;End of help on this topic&gt;
30613 </BODY></HTML>
30614 ====== h_config_copy_to_to_from =====
30615 <HTML>
30616 <HEAD>
30617 <TITLE>FEATURE: <!--#echo var="FEAT_copy-to-address-to-from-if-it-is-us"--></TITLE>
30618 </HEAD>
30619 <BODY>
30620 <H1>FEATURE: <!--#echo var="FEAT_copy-to-address-to-from-if-it-is-us"--></H1>
30621
30622 This feature affects the From address used when Replying to a message.
30623 It is probably only useful if you have some
30624 <a href="h_config_alt_addresses"><!--#echo var="VAR_alt-addresses"--></a>
30625 defined.
30626 When enabled, it checks to see if any of the addresses in the To or Cc
30627 fields of the message you are replying to is one of your addresses.
30628 If it is, and there is only one of them, then that address is used as
30629 the From address in the message you are composing.
30630 In other words, you will be using a From address that is the same
30631 as the To address that was used to get the mail to you in the first place.
30632
30633 <P>
30634 If a role is being used and it has a From address defined, that From address will
30635 be used rather than the one derived from this feature.
30636
30637 <P>
30638 <UL>
30639 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30640 </UL><P>
30641 &lt;End of help on this topic&gt;
30642 </BODY>
30643 </HTML>
30644 ====== h_config_prefix_editing =====
30645 <HTML>
30646 <HEAD>
30647 <TITLE>FEATURE: <!--#echo var="FEAT_enable-reply-indent-string-editing"--></TITLE>
30648 </HEAD>
30649 <BODY>
30650 <H1>FEATURE: <!--#echo var="FEAT_enable-reply-indent-string-editing"--></H1>
30651
30652 This feature affects the Reply command's &quot;Include original message
30653 in Reply?&quot; prompt.  When enabled, it causes the
30654 &quot;Edit Indent String&quot; sub-command to appear which allows
30655 you to edit the string Alpine would otherwise use to denote included
30656 text from the message being replied to.<P>
30657
30658 Thus, you can change Alpine's default message quote character (usually
30659 an angle bracket) on a per message basis. So you could change your quoted message to
30660 look, for example, like this:<p>
30661
30662 <pre>On Tues, 26 Jan 1999, John Q. Smith wrote:
30663
30664 John: I just wanted to say hello and to congratulate you
30665 John: on a job well done!</pre><p>
30666
30667 The configuration option
30668 <A HREF="h_config_reply_indent_string">&quot;<!--#echo var="VAR_reply-indent-string"-->&quot;</A>
30669 may be used to change what appears as the default string to be edited.
30670 <P>
30671 NOTE: Edited <!--#echo var="VAR_reply-indent-string"--> only apply to the message
30672 currently being replied to.
30673 <P>
30674 If you change your <!--#echo var="VAR_reply-indent-string"-->
30675 so that it is not equal to the default value of &quot;&gt;&nbsp;&quot;, then
30676 quoted text will not be flowed
30677 (<A HREF="h_config_quell_flowed_text">Flowed Text</A>)
30678 when you reply.
30679 For this reason, we recommend that you leave your <!--#echo var="VAR_reply-indent-string"-->
30680 set to the default value.
30681 <P>
30682 <UL>
30683 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30684 </UL><P>
30685 &lt;End of help on this topic&gt;
30686 </BODY>
30687 </HTML>
30688 ====== h_config_enable_search_and_repl =====
30689 <HTML>
30690 <HEAD>
30691 <TITLE>FEATURE: <!--#echo var="FEAT_enable-search-and-replace"--></TITLE>
30692 </HEAD>
30693 <BODY>
30694 <H1>FEATURE: <!--#echo var="FEAT_enable-search-and-replace"--></H1>
30695
30696 This feature modifies the behavior of Alpine's composer.  Setting this
30697 feature causes Alpine to offer the "^R Replace" subcommand, which
30698 allows you to search and replace text strings in a message you are composing,
30699 inside the "^W Where is" command.
30700
30701 <P>
30702
30703 To search and replace text, first enter the text to be replaced at the
30704 "Search: " prompt.  Then, rather than pressing Enter to just search for that
30705 text, press ^R, which turns the prompt into
30706
30707 <P>
30708
30709 Search (to replace):
30710
30711 <P>
30712
30713 and then press Enter.  The cursor will highlight the first occurrence
30714 of the text string you entered, and the prompt will show:
30715
30716 <P>
30717
30718 Replace "<your text string>" with :
30719
30720 <P>
30721
30722 where <your text string> is what you entered at the previous prompt;
30723 here, enter the replacement text.  To only replace the highlighted
30724 occurrence, simply press Enter now; to replace all occurrences in the
30725 message, press ^X (Repl All), then Enter.  You will then be asked to confirm
30726 each replacement.
30727
30728 <P>
30729
30730 The command ^R toggles between "Replace" and "Don't Replace"; its subcommand
30731 ^X toggles between "Replace All" and "Replace One."
30732
30733 <P>
30734
30735 If you previously searched for text in a message, it will be offered for
30736 re-use as part of the prompt, shown in [ ] brackets.
30737
30738 <P>
30739 &lt;End of help on this topic&gt;
30740 </BODY>
30741 </HTML>
30742 ====== h_config_enable_view_attach =====
30743 <HTML>
30744 <HEAD>
30745 <TITLE>FEATURE: <!--#echo var="FEAT_enable-msg-view-attachments"--></TITLE>
30746 </HEAD>
30747 <BODY>
30748 <H1>FEATURE: <!--#echo var="FEAT_enable-msg-view-attachments"--></H1>
30749
30750 This feature modifies the behavior of Alpine's MESSAGE TEXT screen.
30751 Setting this feature causes Alpine to present attachments in boldface.
30752 The first available attachment is displayed in inverse.  This is the
30753 "selected" attachment.  Pressing RETURN will cause Alpine to display
30754 the selected attachment.  Use the arrow keys to change which of the
30755 attachments displayed in boldface is the current selection.
30756
30757 <P>
30758
30759 Speaking of arrow keys, the Up and Down Arrows will select the next
30760 and previous attachments if one is available on the screen for selection.
30761 Otherwise, they will simply adjust the viewed text one line up or down.
30762
30763 <P>
30764
30765 Similarly, when selectable items are present in a message, the Ctrl-F key
30766 can be used to select the next item in the message independent of which
30767 portion of the viewed message is currently displayed. The Ctrl-B key can
30768 be used to select the previous item in the same way.
30769 <P>
30770 &lt;End of help on this topic&gt;
30771 </BODY>
30772 </HTML>
30773 ====== h_config_enable_y_print =====
30774 <HTML>
30775 <HEAD>
30776 <TITLE>FEATURE: <!--#echo var="FEAT_enable-print-via-y-command"--></TITLE>
30777 </HEAD>
30778 <BODY>
30779 <H1>FEATURE: <!--#echo var="FEAT_enable-print-via-y-command"--></H1>
30780
30781 This feature modifies the behavior of Alpine's Print command.
30782 <P>
30783 By default, Alpine's print command is available by pressing the "%" key.
30784 (This command is a substantial change from Pine versions before 4.00 --
30785 where the print command was "Y" -- based on numerous complaints about
30786 printing being invoked inadvertently, since Y also means "Yes.")
30787
30788 <P>
30789
30790 This feature is supplied to mitigate any disruption or anxiety users
30791 might feel as a result of this change.
30792
30793 <P>
30794
30795 Enabling this feature will cause Alpine to recognize both the old
30796 command, "Y" for Prynt, as well the new "%" method for invoking
30797 printing.  Note, key menu labels are not changed as a result of
30798 enabling this feature.
30799
30800 <P>
30801
30802 &lt;End of help on this topic&gt;
30803 </BODY>
30804 </HTML>
30805 ====== h_config_enable_lessthan_exit =====
30806 <HTML>
30807 <HEAD>
30808 <TITLE>FEATURE: <!--#echo var="FEAT_enable-exit-via-lessthan-command"--></TITLE>
30809 </HEAD>
30810 <BODY>
30811 <H1>FEATURE: <!--#echo var="FEAT_enable-exit-via-lessthan-command"--></H1>
30812
30813 If this feature is set, then on screens where there is an Exit command
30814 but no < command, the < key will perform the same function as the Exit
30815 command.
30816 This feature is set by default.
30817 <P>
30818 &lt;End of help on this topic&gt;
30819 </BODY>
30820 </HTML>
30821 ====== h_config_enable_view_url =====
30822 <HTML>
30823 <HEAD>
30824 <TITLE>FEATURE: <!--#echo var="FEAT_enable-msg-view-urls"--></TITLE>
30825 </HEAD>
30826 <BODY>
30827 <H1>FEATURE: <!--#echo var="FEAT_enable-msg-view-urls"--></H1>
30828 This feature modifies the behavior of Alpine's MESSAGE TEXT screen.
30829 When this feature is set (the default) Alpine will select possible URLs from the
30830 displayed text and display them in boldface for selection.
30831 <P>
30832 The first available URL is displayed in inverse.  This is the
30833 &quot;selected&quot; URL.  Pressing RETURN will cause Alpine to display
30834 the selected URL via either built-in means as with mailto:, imap:,
30835 news:, and nntp:, or via an external application as defined
30836 by the <A HREF="h_config_browser">&quot;url-viewer&quot;</A>
30837 variable.
30838 <P>
30839 Use the arrow keys to change which of the URLs displayed in boldface
30840 is the current selection.
30841 <P>
30842 Speaking of arrow keys, the Up and Down Arrows will select the next
30843 and previous URL if one is available on the screen for selection (unless
30844 you have set the feature
30845 <A HREF="h_config_enable_view_arrows">&quot;<!--#echo var="FEAT_enable-msg-view-forced-arrows"-->&quot;</A>).
30846 Otherwise, they will simply adjust the viewed text one line up or down.
30847 <P>
30848 Similarly, when selectable items are present in a message, the Ctrl-F
30849 key can be used to select the next item in the message independent
30850 of which portion of the viewed message is currently displayed. The
30851 Ctrl-B key can be used to select the previous item in the same way.
30852 <P>
30853 <UL>
30854 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30855 </UL><P>
30856 &lt;End of help on this topic&gt;
30857 </BODY>
30858 </HTML>
30859 ====== h_config_enable_view_web_host =====
30860 <HTML>
30861 <HEAD>
30862 <TITLE>FEATURE: <!--#echo var="FEAT_enable-msg-view-web-hostnames"--></TITLE>
30863 </HEAD>
30864 <BODY>
30865 <H1>FEATURE: <!--#echo var="FEAT_enable-msg-view-web-hostnames"--></H1>
30866
30867 This feature modifies the behavior of Alpine's MESSAGE TEXT screen.
30868 When this feature is set (the default) Alpine will select possible web hostnames
30869 from the displayed text and display them in boldface for selection.
30870 This can be useful when you receive messages referencing World Wide Web
30871 sites without the use of complete URLs; for example, specifying only
30872 &quot;www.some.site.com&quot; (which will <B>not</B> become a
30873 selectable
30874 item by setting <A HREF="h_config_enable_view_url">&quot;<!--#echo var="FEAT_enable-msg-view-urls"-->&quot;</A>)
30875 rather than explicitly
30876 &quot;http://www.some.site.com&quot;.
30877 <P>
30878 The first available hostname is displayed in inverse.  This is the
30879 &quot;selected&quot; hostname.  Pressing RETURN will cause Alpine to display
30880 the selected hostname via an external application as defined
30881 by the <A HREF="h_config_browser">&quot;url-viewer&quot;</A>
30882 variable.
30883 <P>
30884 Use the arrow keys (unless you have set the feature
30885 <A HREF="h_config_enable_view_arrows">&quot;<!--#echo var="FEAT_enable-msg-view-forced-arrows"-->&quot;</A>)
30886 to change which of the hostnames displayed in
30887 boldface is the current selection.
30888 <P>
30889 Similarly, when selectable web hostnames are present in a message, the Ctrl-F
30890 key can be used to select the next web hostname in the message independent
30891 of which portion of the viewed message is currently displayed. The
30892 Ctrl-B key can be used to select the previous web hostnames in the same way.
30893 <P>
30894 <UL>
30895 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30896 </UL><P>
30897 &lt;End of help on this topic&gt;
30898 </BODY>
30899 </HTML>
30900 ====== h_config_enable_view_addresses =====
30901 <HTML>
30902 <HEAD>
30903 <TITLE>FEATURE: <!--#echo var="FEAT_enable-msg-view-addresses"--></TITLE>
30904 </HEAD>
30905 <BODY>
30906 <H1>FEATURE: <!--#echo var="FEAT_enable-msg-view-addresses"--></H1>
30907
30908 This feature modifies the behavior of Alpine's MESSAGE TEXT screen.
30909 Setting this feature causes Alpine to select possible email addresses
30910 from the displayed text and display them in boldface for selection.
30911
30912 <P>
30913 The first available email address is displayed in inverse.  This is the
30914 &quot;selected&quot; address.  Pressing RETURN will cause Alpine to enter
30915 the message composition screen with the To: field filled in with the
30916 selected address.
30917 <P>
30918 Use the arrow keys (unless you have set the feature
30919 <A HREF="h_config_enable_view_arrows">&quot;<!--#echo var="FEAT_enable-msg-view-forced-arrows"-->&quot;</A>)
30920 to change which of the hostnames displayed in
30921 boldface is the current selection.
30922 <P>
30923 Similarly, when selectable web hostnames are present in a message, the Ctrl-F
30924 key can be used to select the next web hostname in the message independent
30925 of which portion of the viewed message is currently displayed. The
30926 Ctrl-B key can be used to select the previous web hostnames in the same way.
30927 <P>
30928 <UL>
30929 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
30930 </UL><P>
30931 &lt;End of help on this topic&gt;
30932 </BODY>
30933 </HTML>
30934 ====== h_external_loads_inline_images_only =====
30935 <HTML>
30936 <HEAD>
30937 <TITLE>FEATURE: <!--#echo var="FEAT_external-command-loads-inline-images-only"--></TITLE>
30938 </HEAD>
30939 <BODY>
30940 <H1>FEATURE: <!--#echo var="FEAT_external-command-loads-inline-images-only"--></H1>
30941
30942 Alpine allows you to pass a HTML message to the browser that you have configured in your
30943 <A HREF="h_config_browser"><!--#echo var="VAR_url-viewers"--></A> variable. This allows
30944 you to read a message outside of Alpine. This is desirable when Alpine does not display
30945 html correctly, or when you wish to read the message and see the inline images in the message.
30946
30947 <P>
30948 An inline image is one that comes with the message and is necessary for the correct display of
30949 the message. However, there are instances in which the source of an image will come from
30950 external servers. If this feature is enabled (the default) then Alpine will only pass inline
30951 images to the browser and will remove the link to external images, so only inline images will
30952 be used to display the message, and no external image will be loaded. Alpine does this to protect
30953 your privacy and security.
30954
30955 <P>
30956 Please note that messages are usually formatted by the sender so that they display correctly once
30957 all images have been loaded. Enabling this feature might cause the message not to be correctly
30958 displayed by your browser.
30959
30960 <P>
30961 Also consider security and privacy implications of opening an HTML message in a browser. You are
30962 always protected when you do not use this feature, but you might not have the same level of
30963 protection if you try to open a spam or scam using the html view. Also commercial email is
30964 normally embedded with links to external images that let them, their partners, and your internet
30965 service provider (which could be your employer or school)  know that you opened their message or
30966 connected to a web site, violating your privacy.
30967
30968 <P>
30969 If you are worried about your privacy and security, do not use an external viewer to open
30970 html files, and keep using the internal mechanisms that Alpine provides to read messages.
30971
30972 <P>
30973 &lt;End of help on this topic&gt;
30974 </BODY>
30975 <HTML>
30976 ====== h_config_enable_view_arrows =====
30977 <HTML>
30978 <HEAD>
30979 <TITLE>FEATURE: <!--#echo var="FEAT_enable-msg-view-forced-arrows"--></TITLE>
30980 </HEAD>
30981 <BODY>
30982 <H1>FEATURE: <!--#echo var="FEAT_enable-msg-view-forced-arrows"--></H1>
30983
30984 This feature modifies Up and Down arrow key behavior in Alpine's
30985 MESSAGE TEXT screen when selectable Attachments, URL's, or
30986 web-hostnames are presented. Alpine's usual behavior is to move to
30987 the next or previous selectable item if currently displayed or
30988 simply to adjust the screen view by one line.
30989
30990 <P>
30991
30992 Setting this feature causes the UP and Down arrow key to behave as
30993 if no selectable items were present in the message.
30994
30995 <P>
30996
30997 Note, the Ctrl-F (next selectable item) and Ctrl-B (previous selectable
30998 item) functionality is unchanged.
30999 <P>
31000
31001 &lt;End of help on this topic&gt;
31002 </BODY>
31003 <HTML>
31004 ====== h_config_quell_charset_warning =====
31005 <HTML>
31006 <HEAD>
31007 <TITLE>FEATURE: <!--#echo var="FEAT_quell-charset-warning"--></TITLE>
31008 </HEAD>
31009 <BODY>
31010 <H1>FEATURE: <!--#echo var="FEAT_quell-charset-warning"--></H1>
31011
31012 By default, if the message you are viewing contains characters that are
31013 not representable in your
31014 <A HREF="h_config_char_set">&quot;Display Character Set&quot;</A>
31015 then Alpine will
31016 add a warning to the start of the displayed text.
31017 If this option is set, then that editorial message will be suppressed.
31018 <P>
31019 Setting this feature also suppresses the comment about the character set
31020 in header lines.
31021 For example, when viewing a message you might see
31022 <P>
31023 <CENTER><SAMP>From: &quot;[ISO-8859-2] Name&quot; &lt;address&gt;</SAMP></CENTER>
31024 <P>
31025 in the From header if your Character-Set is something other than ISO-8859-2.
31026 If you set this feature, the comment about the character set will
31027 no longer be there.
31028 <P>
31029 &lt;End of help on this topic&gt;
31030 </BODY>
31031 </HTML>
31032 ====== h_config_quell_host_after_url =====
31033 <HTML>
31034 <HEAD>
31035 <TITLE>FEATURE: <!--#echo var="FEAT_quell-server-after-link-in-html"--></TITLE>
31036 </HEAD>
31037 <BODY>
31038 <H1>FEATURE: <!--#echo var="FEAT_quell-server-after-link-in-html"--></H1>
31039
31040 By default, links in HTML text are displayed with the host the link
31041 references appended, within square brackets, to the link text.  Alpine
31042 does this to help indicate where a link will take you, particularly when
31043 the link text might suggest a different destination.
31044
31045 <P>
31046 Setting this feature will prevent the server name from being appended
31047 to the displayed text.
31048
31049 <P>
31050 &lt;End of help on this topic&gt;
31051 </BODY>
31052 </HTML>
31053 ====== h_config_prefer_plain_text =====
31054 <HTML>
31055 <HEAD>
31056 <TITLE>FEATURE: <!--#echo var="FEAT_prefer-plain-text"--></TITLE>
31057 </HEAD>
31058 <BODY>
31059 <H1>FEATURE: <!--#echo var="FEAT_prefer-plain-text"--></H1>
31060
31061 A message being viewed may contain alternate versions of the same content.
31062 Those alternate versions are supposed to be ordered by the sending software such that the
31063 first alternative is the least preferred and the last alternative is the
31064 most preferred. Alpine will normally display the most-preferred version that
31065 it knows how to display. This is most often encountered where the two
31066 alternate versions are a plain text version and an HTML version, with the
31067 HTML version listed last as the most preferred.
31068 <P>
31069 If this option is set, then any plain text version will be preferred to
31070 all other versions.
31071 <P>
31072 When viewing a message there is a command &quot;A TogglePreferPlain&quot;,
31073 which will temporarily change the sense of this option.
31074 If this option is set you will first see the plain text version of a
31075 message.
31076 If you then type the &quot;A&quot; command, you will see the most preferred version,
31077 most likely HTML, instead.
31078 Typing the &quot;A&quot; command a second time will switch it back.
31079 Alternatively, if the present option is not set you will originally see
31080 the most preferred version of the message and typing &quot;A&quot; will switch to
31081 the plain text version.
31082 <P>
31083 &lt;End of help on this topic&gt;
31084 </BODY>
31085 </HTML>
31086 ====== h_config_pass_control =====
31087 <HTML>
31088 <HEAD>
31089 <TITLE>FEATURE: <!--#echo var="FEAT_pass-control-characters-as-is"--></TITLE>
31090 </HEAD>
31091 <BODY>
31092 <H1>FEATURE: <!--#echo var="FEAT_pass-control-characters-as-is"--></H1>
31093
31094 It is probably not useful to set this option.
31095 This is a legacy option left behind &quot;just in case&quot;.
31096 Multi-byte characters that have an octet that has the same
31097 value as a control character are permitted through whether or not
31098 this option is turned on.
31099 <P>
31100 This feature controls how certain characters contained in messages are
31101 displayed.
31102 If set, all characters in a message will be sent to the
31103 screen. Normally, control characters are displayed as shown below to
31104 avoid a garbled screen and to
31105 avoid inadvertently changing terminal setup parameters.
31106 Control characters are usually displayed as two character sequences like
31107 <P><CENTER><SAMP> ^C </SAMP></CENTER><P>
31108 for Control-C,
31109 <P><CENTER><SAMP> ^[ </SAMP></CENTER><P>
31110 for ESCAPE,
31111 <P><CENTER><SAMP> ^? </SAMP></CENTER><P>
31112 for DELETE, and
31113 <P><CENTER><SAMP> ~E </SAMP></CENTER><P>
31114 for the character with value 133 (0x85).
31115 (The DEL character is displayed as ^?, regular control characters are displayed
31116 as the character ^ followed by the character obtained by adding the
31117 five low-order bits of the character to 0x40, and the C1
31118 control characters 0x80 - 0x9F are displayed as the character ~ followed by the
31119 character obtained by adding the
31120 five low-order bits of the character to 0x40.)
31121 Sometimes, in cases where changing a single control character into a
31122 two-character sequence would confuse Alpine's display routines,
31123 a question mark is substituted for the control character.
31124 <P>
31125 If you wish to filter out regular control characters but pass the
31126 so-called C1 control characters (0x80 <= char < 0xA0) through unchanged, then
31127 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.
31128 <P>
31129 &lt;End of help on this topic&gt;
31130 </BODY>
31131 </HTML>
31132 ====== h_config_pass_c1_control =====
31133 <HTML>
31134 <HEAD>
31135 <TITLE>FEATURE: <!--#echo var="FEAT_pass-c1-control-characters-as-is"--></TITLE>
31136 </HEAD>
31137 <BODY>
31138 <H1>FEATURE: <!--#echo var="FEAT_pass-c1-control-characters-as-is"--></H1>
31139
31140 It is probably not useful to set this option.
31141 This is a legacy option left behind &quot;just in case&quot;.
31142 Multi-byte characters that have an octet that has the same
31143 value as a control character are permitted through whether or not
31144 this option is turned on.
31145 <P>
31146 If the feature <A HREF="h_config_pass_control"><!--#echo var="FEAT_pass-control-characters-as-is"--></A>
31147 is set, then this feature has no effect.
31148 However, if you wish to filter out regular control characters but pass the
31149 so-called C1 control characters (0x80 <= char < 0xA0) through unchanged, then
31150 you may leave <A HREF="h_config_pass_control"><!--#echo var="FEAT_pass-control-characters-as-is"--></A>
31151 unset and set this feature.
31152 <P>
31153 &lt;End of help on this topic&gt;
31154 </BODY>
31155 </HTML>
31156 ====== h_config_fcc_on_bounce =====
31157 <HTML>
31158 <HEAD>
31159 <TITLE>FEATURE: <!--#echo var="FEAT_fcc-on-bounce"--></TITLE>
31160 </HEAD>
31161 <BODY>
31162 <H1>FEATURE: <!--#echo var="FEAT_fcc-on-bounce"--></H1>
31163
31164 This feature controls an aspect of Alpine's behavior when bouncing a
31165 message. If set, normal FCC ("File Carbon Copy") processing will be
31166 done, just as if you had composed a message to the address you are
31167 bouncing to.  If not set, no FCC of the message will be saved.
31168 <P>
31169 &lt;End of help on this topic&gt;
31170 </BODY>
31171 </HTML>
31172 ====== h_config_show_cursor =====
31173 <HTML>
31174 <HEAD>
31175 <TITLE>FEATURE: <!--#echo var="FEAT_show-cursor"--></TITLE>
31176 </HEAD>
31177 <BODY>
31178 <H1>FEATURE: <!--#echo var="FEAT_show-cursor"--></H1>
31179
31180 This feature controls an aspect of Alpine's displays.  If set, the system
31181 cursor will move to convenient locations in the displays.  For example,
31182 to the beginning of the status field of the highlighted index line, or
31183 to the highlighted word after a successful WhereIs command.  It is intended
31184 to draw your attention to an "interesting" spot on the screen.
31185 <P>
31186 &lt;End of help on this topic&gt;
31187 </BODY>
31188 </HTML>
31189 ====== h_config_sort_fcc_alpha =====
31190 <HTML>
31191 <HEAD>
31192 <TITLE>FEATURE: <!--#echo var="FEAT_sort-default-fcc-alpha"--></TITLE>
31193 </HEAD>
31194 <BODY>
31195 <H1>FEATURE: <!--#echo var="FEAT_sort-default-fcc-alpha"--></H1>
31196
31197 This feature controls an aspect of Alpine's FOLDER LIST screen.
31198 If set, the default Fcc folder will be sorted alphabetically with the other
31199 folders instead of appearing right after the INBOX.
31200 <P>
31201 &lt;End of help on this topic&gt;
31202 </BODY>
31203 </HTML>
31204 ====== h_config_sort_save_alpha =====
31205 <HTML>
31206 <HEAD>
31207 <TITLE>FEATURE: <!--#echo var="FEAT_sort-default-save-alpha"--></TITLE>
31208 </HEAD>
31209 <BODY>
31210 <H1>FEATURE: <!--#echo var="FEAT_sort-default-save-alpha"--></H1>
31211
31212 This feature controls an aspect of Alpine's FOLDER LIST screen.
31213 If set, the default save folder will be sorted alphabetically with the other
31214 folders instead of appearing right after the INBOX (and default FCC folder).
31215 <P>
31216 &lt;End of help on this topic&gt;
31217 </BODY>
31218 </HTML>
31219 ====== h_config_single_list =====
31220 <HTML>
31221 <HEAD>
31222 <TITLE>FEATURE: <!--#echo var="FEAT_single-column-folder-list"--></TITLE>
31223 </HEAD>
31224 <BODY>
31225 <H1>FEATURE: <!--#echo var="FEAT_single-column-folder-list"--></H1>
31226
31227 This feature controls an aspect of Alpine's FOLDER LIST screen.  If set,
31228 the folders will be listed one per line instead of several per line
31229 in the FOLDER LIST display.
31230 <P>
31231 &lt;End of help on this topic&gt;
31232 </BODY>
31233 </HTML>
31234 ====== h_config_vertical_list =====
31235 <HTML>
31236 <HEAD>
31237 <TITLE>FEATURE: <!--#echo var="FEAT_vertical-folder-list"--></TITLE>
31238 </HEAD>
31239 <BODY>
31240 <H1>FEATURE: <!--#echo var="FEAT_vertical-folder-list"--></H1>
31241
31242 This feature controls an aspect of Alpine's FOLDER LIST screen.  If set,
31243 the folders will be listed alphabetically down the columns rather
31244 than across the columns as is the default.
31245 <P>
31246 &lt;End of help on this topic&gt;
31247 </BODY>
31248 </HTML>
31249 ====== h_config_verbose_post =====
31250 <HTML>
31251 <HEAD>
31252 <TITLE>FEATURE: <!--#echo var="FEAT_enable-verbose-smtp-posting"--></TITLE>
31253 </HEAD>
31254 <BODY>
31255 <H1>FEATURE: <!--#echo var="FEAT_enable-verbose-smtp-posting"--></H1>
31256 This feature controls an aspect of Alpine's message sending.  When enabled,
31257 Alpine will send a VERB (i.e., VERBose) command early in the posting process
31258 intended to cause the SMTP server to provide a more detailed account of
31259 the transaction.  This feature is typically only useful to system
31260 administrators and other support personnel as an aid in troubleshooting
31261 problems.
31262 <P>
31263 Note, this feature relies on a specific capability of the system's mail
31264 transport agent or configured
31265 <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>.
31266 It is possible that this
31267 feature will cause problems for some transport agents, and may result in
31268 sending failure.  In addition, as the verbose output comes from the mail
31269 transport agent, it is likely to vary from one system to another.
31270 <P><UL>
31271 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31272 </UL><P>
31273 &lt;End of help on this topic&gt;
31274 </BODY>
31275 </HTML>
31276 ====== h_config_auto_reply_to =====
31277 <HTML>
31278 <HEAD>
31279 <TITLE>FEATURE: <!--#echo var="FEAT_reply-always-uses-reply-to"--></TITLE>
31280 </HEAD>
31281 <BODY>
31282 <H1>FEATURE: <!--#echo var="FEAT_reply-always-uses-reply-to"--></H1>
31283
31284 This feature controls an aspect of Alpine's Reply command.  If set, Alpine
31285 will not prompt when a message being replied to contains a "Reply-To:"
31286 header value, but will simply use its value (as opposed to using the
31287 "From:" field's value).
31288
31289 <P>
31290
31291 Note: Using the "Reply-To:" address is usually the preferred behavior,
31292 however, some mailing list managers choose to place the list's address in
31293 the "Reply-To:" field of any message sent out to the list.  In such
31294 cases, this feature makes it all too easy for personal replies to be
31295 inadvertently sent to the entire mail list, so be careful!
31296 <P>
31297 &lt;End of help on this topic&gt;
31298 </BODY>
31299 </HTML>
31300 ====== h_config_del_skips_del =====
31301 <HTML>
31302 <HEAD>
31303 <TITLE>FEATURE: <!--#echo var="FEAT_delete-skips-deleted"--></TITLE>
31304 </HEAD>
31305 <BODY>
31306 <H1>FEATURE: <!--#echo var="FEAT_delete-skips-deleted"--></H1>
31307
31308 This feature controls an aspect of Alpine's Delete command.  If set, this
31309 feature will cause the Delete command to advance past following messages that
31310 are marked deleted.  In other words, pressing "D" will both mark the
31311 current message deleted and advance to the next message that is not marked
31312 deleted.
31313 This feature is set by default.
31314 <P>
31315 &lt;End of help on this topic&gt;
31316 </BODY></HTML>
31317 ====== h_config_expunge_manually =====
31318 <HTML>
31319 <HEAD>
31320 <TITLE>FEATURE: <!--#echo var="FEAT_expunge-only-manually"--></TITLE>
31321 </HEAD>
31322 <BODY>
31323 <H1>FEATURE: <!--#echo var="FEAT_expunge-only-manually"--></H1>
31324
31325 Normally, when you close a folder that contains deleted messages you are
31326 asked if you want to expunge those messages from the folder permanently.
31327 If this feature is set, you won't be asked and the deleted messages will
31328 remain in the folder.
31329 If you choose to set this feature you will have to expunge the
31330 messages manually using the eXpunge command, which you can use while
31331 in the MESSAGE INDEX screen.
31332 If you do not expunge deleted messages the size of your
31333 folder will continue to increase until you are out of disk space.
31334 <P>
31335 <UL>
31336 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31337 </UL><P>
31338 &lt;End of help on this topic&gt;
31339 </BODY>
31340 </HTML>
31341 ====== h_config_auto_expunge =====
31342 <HTML>
31343 <HEAD>
31344 <TITLE>FEATURE: <!--#echo var="FEAT_expunge-without-confirm"--></TITLE>
31345 </HEAD>
31346 <BODY>
31347 <H1>FEATURE: <!--#echo var="FEAT_expunge-without-confirm"--></H1>
31348
31349 This features controls an aspect of Alpine's eXpunge command.  If set, you
31350 will <B>not</B> be prompted to confirm your intent before the expunge takes
31351 place.
31352 Actually, this is only true for the INBOX folder and for folders in the
31353 Incoming Folders collection. See the feature
31354 <A HREF="h_config_full_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm-everywhere"-->&quot;</A>.
31355 <P>
31356 <UL>
31357 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31358 </UL><P>
31359 &lt;End of help on this topic&gt;
31360 </BODY>
31361 </HTML>
31362 ====== h_config_full_auto_expunge =====
31363 <HTML>
31364 <HEAD>
31365 <TITLE>FEATURE: <!--#echo var="FEAT_expunge-without-confirm-everywhere"--></TITLE>
31366 </HEAD>
31367 <BODY>
31368 <H1>FEATURE: <!--#echo var="FEAT_expunge-without-confirm-everywhere"--></H1>
31369
31370 This features controls an aspect of Alpine's eXpunge command.  If set, you
31371 will <B>not</B> be prompted to confirm your intent before the expunge
31372 takes place.  This feature sets this behavior for all folders, unlike the
31373 <A HREF="h_config_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm"-->&quot;</A>
31374 feature that works only for incoming folders.
31375 <P>
31376 <UL>
31377 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31378 </UL><P>
31379 &lt;End of help on this topic&gt;
31380 </BODY>
31381 </HTML>
31382 ====== h_config_auto_read_msgs =====
31383 <HTML>
31384 <HEAD>
31385 <TITLE>FEATURE: <!--#echo var="FEAT_auto-move-read-msgs"--></TITLE>
31386 </HEAD>
31387 <BODY>
31388 <H1>FEATURE: <!--#echo var="FEAT_auto-move-read-msgs"--></H1>
31389 This feature controls an aspect of Alpine's behavior upon quitting.  If set,
31390 and the
31391 <A HREF="h_config_read_message_folder">&quot;<!--#echo var="VAR_read-message-folder"-->&quot;</A>
31392 option is also set, then Alpine will
31393 automatically transfer all read messages to the designated folder and mark
31394 them as deleted in the INBOX.  Messages in the INBOX marked with an
31395 &quot;N&quot; (meaning New, or unseen) are not affected.
31396 <P>
31397 <UL>
31398 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31399 </UL><P>
31400 &lt;End of help on this topic&gt;
31401 </BODY>
31402 </HTML>
31403 ====== h_config_auto_fcc_only =====
31404 <HTML>
31405 <HEAD>
31406 <TITLE>FEATURE: <!--#echo var="FEAT_fcc-only-without-confirm"--></TITLE>
31407 </HEAD>
31408 <BODY>
31409 <H1>FEATURE: <!--#echo var="FEAT_fcc-only-without-confirm"--></H1>
31410 This features controls an aspect of Alpine's composer.
31411 The only time this feature will be used is if you attempt to send mail
31412 that has no recipients but does have an Fcc.
31413 Normally, Alpine will ask if you really mean to copy the message only to
31414 the Fcc.
31415 That is, it asks if you really meant to have no recipients.
31416 If this feature is set, you
31417 will <B>not</B> be prompted to confirm your intent to make only a copy
31418 of a message with no recipients.
31419 <P>
31420 This feature is closely related to
31421 <A HREF="h_config_warn_if_no_to_or_cc"><!--#echo var="FEAT_warn-if-blank-to-and-cc-and-newsgroups"--></A>.
31422 The difference between this feature and that feature is that this feature
31423 considers a Bcc to be a recipient while that feature will ask for confirmation
31424 even if there is a Bcc when there is no To, Cc, or Newsgroup.
31425 The default values also differ. This feature defaults to asking the question
31426 and you have to turn it off.
31427 The <!--#echo var="FEAT_warn-if-blank-to-and-cc-and-newsgroups"--> feature defaults to not asking
31428 unless you turn it on.
31429 <P>
31430
31431 <UL>
31432 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31433 </UL><P>
31434 &lt;End of help on this topic&gt;
31435 </BODY>
31436 </HTML>
31437 ====== h_config_mark_fcc_seen =====
31438 <HTML>
31439 <HEAD>
31440 <TITLE>FEATURE: <!--#echo var="FEAT_mark-fcc-seen"--></TITLE>
31441 </HEAD>
31442 <BODY>
31443 <H1>FEATURE: <!--#echo var="FEAT_mark-fcc-seen"--></H1>
31444
31445 This features controls the way Fccs (File carbon copies) are
31446 made of the messages you send.
31447
31448 <P>
31449 Normally, when Alpine saves a copy of a message you sent as an Fcc, that
31450 copy will be marked as Unseen.
31451 When you look at the folder it was saved in the message will appear to
31452 be a New message until you read it.
31453 When this feature is enabled, the message will be marked as having
31454 been Seen.
31455
31456 <P>
31457 <UL>
31458 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31459 </UL><P>
31460 &lt;End of help on this topic&gt;
31461 </BODY>
31462 </HTML>
31463 ====== h_config_no_fcc_attach =====
31464 <HTML>
31465 <HEAD>
31466 <TITLE>FEATURE: <!--#echo var="FEAT_fcc-without-attachments"--></TITLE>
31467 </HEAD>
31468 <BODY>
31469 <H1>FEATURE: <!--#echo var="FEAT_fcc-without-attachments"--></H1>
31470
31471 This features controls the way Fcc's (File carbon copies) are
31472 made of the messages you send.
31473
31474 <P>
31475 Normally, Alpine saves an exact copy of your message as it was sent.
31476 When this feature is enabled, the &quot;body&quot; of the message
31477 you send (the text you type in the composer) is preserved in the
31478 copy as before, however all attachments are replaced with text
31479 explaining what had been sent rather than the attachments themselves.
31480
31481 <P>
31482 This feature also affects Alpine's &quot;Send ?&quot; confirmation prompt
31483 in that a new &quot;^F Fcc Attchmnts&quot; option becomes available which
31484 allows you to interactively set whether or not attachments are saved
31485 to the Fcc'd copy.
31486
31487 <P>
31488 <UL>
31489 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31490 </UL><P>
31491 &lt;End of help on this topic&gt;
31492 </BODY>
31493 </HTML>
31494 ====== h_config_read_in_newsrc_order =====
31495 <HTML>
31496 <HEAD>
31497 <TITLE>FEATURE: <!--#echo var="FEAT_news-read-in-newsrc-order"--></TITLE>
31498 </HEAD>
31499 <BODY>
31500 <H1>FEATURE: <!--#echo var="FEAT_news-read-in-newsrc-order"--></H1>
31501
31502 This feature controls the order in which newsgroups will be presented.  If
31503 set, they will be presented in the same order as they occur in your
31504 <!--chtml if pinemode="os_windows"-->
31505 &quot;NEWSRC&quot;
31506 <!--chtml else-->
31507 &quot;.newsrc&quot;
31508 <!--chtml endif-->
31509 file (the default location of which can be changed with the
31510 <A HREF="h_config_newsrc_path">&quot;<!--#echo var="VAR_newsrc-path"-->&quot;</A> option).
31511 <P>
31512 If not set, the newsgroups will be presented in alphabetical order.
31513 <P>
31514 <UL>
31515 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31516 </UL><P>
31517 &lt;End of help on this topic&gt;
31518 </BODY>
31519 </HTML>
31520 ====== h_config_quell_tz_comment =====
31521 <HTML>
31522 <HEAD>
31523 <TITLE>FEATURE: <!--#echo var="FEAT_quell-timezone-comment-when-sending"--></TITLE>
31524 </HEAD>
31525 <BODY>
31526 <H1>FEATURE: <!--#echo var="FEAT_quell-timezone-comment-when-sending"--></H1>
31527
31528 Normally, when Alpine generates a Date header for outgoing mail,
31529 it will try to include the symbolic timezone at the end of the
31530 header inside parentheses.
31531 The symbolic timezone is often three characters long, but on
31532 some operating systems, it may be longer.
31533 Apparently there are some SMTP servers in the world that will reject an
31534 incoming message if it has a Date header longer than about 80 characters.
31535 If this feature is set, the symbolic timezone normally generated by
31536 Alpine will not be included.
31537 You probably don't need to worry about this feature unless you run into
31538 the problem described above.
31539
31540 <P>
31541 &lt;End of help on this topic&gt;
31542 </BODY>
31543 </HTML>
31544 ====== h_config_post_wo_validation =====
31545 <HTML>
31546 <HEAD>
31547 <TITLE>FEATURE: <!--#echo var="FEAT_news-post-without-validation"--></TITLE>
31548 </HEAD>
31549 <BODY>
31550 <H1>FEATURE: <!--#echo var="FEAT_news-post-without-validation"--></H1>
31551
31552 This feature controls whether the NNTP server is queried as newsgroups
31553 are entered for posting.  Validation over slow links (e.g. dialup using
31554 SLIP or PPP) can cause delays.  Set this feature to eliminate such delays.
31555 <P>
31556 &lt;End of help on this topic&gt;
31557 </BODY>
31558 </HTML>
31559 ====== h_config_send_wo_confirm =====
31560 <HTML>
31561 <HEAD>
31562 <TITLE>FEATURE: <!--#echo var="FEAT_send-without-confirm"--></TITLE>
31563 </HEAD>
31564 <BODY>
31565 <H1>FEATURE: <!--#echo var="FEAT_send-without-confirm"--></H1>
31566
31567 By default, when you send or post a message you will be asked to confirm
31568 with a question that looks something like:
31569
31570 <P>
31571 <CENTER><SAMP>Send message?</SAMP></CENTER>
31572 <P>
31573
31574 If this feature is set, you
31575 will <B>not</B> be prompted to confirm your intent to send
31576 and your message will be sent.
31577 <P>
31578 If this feature is set it disables some possibilities and renders some
31579 other features meaningless.
31580 You will not be able to use
31581 <A HREF="h_config_sending_filter">Sending Filters</A>,
31582 Verbose sending mode,
31583 <A HREF="h_config_compose_bg_post">Background Sending</A>,
31584 <A HREF="h_config_compose_dsn">Delivery Status Notifications</A>,
31585 or ^V to turn off the generation of flowed text for this message.
31586 These options are normally available as suboptions in the Send prompt, but
31587 with no Send prompt the options are gone.
31588
31589 <P>
31590 A somewhat related feature is
31591 <A HREF="h_config_quell_post_prompt">&quot;<!--#echo var="FEAT_quell-extra-post-prompt"-->&quot;</A>,
31592 which may be used to eliminate the extra confirmation
31593 question when posting to a newsgroup.
31594 <P>
31595 <UL>
31596 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31597 </UL><P>
31598 &lt;End of help on this topic&gt;
31599 </BODY>
31600 </HTML>
31601 ====== h_config_quell_filtering_done_message =====
31602 <HTML>
31603 <HEAD>
31604 <TITLE>FEATURE: <!--#echo var="FEAT_quell-filtering-done-message"--></TITLE>
31605 </HEAD>
31606 <BODY>
31607 <H1>FEATURE: <!--#echo var="FEAT_quell-filtering-done-message"--></H1>
31608
31609 If you use Filter Rules that move messages or set status of messages
31610 you sometimes see a message from Alpine that looks like
31611
31612 <P>
31613 <CENTER><SAMP>filtering done</SAMP></CENTER>
31614 <P>
31615
31616 If this feature is set, this message will be suppressed.
31617 If the feature
31618 <A HREF="h_config_quell_filtering_messages"><!--#echo var="FEAT_quell-filtering-messages"--></A>
31619 is set then this message will be suppressed regardless.
31620
31621 <P>
31622 <UL>
31623 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31624 </UL><P>
31625 &lt;End of help on this topic&gt;
31626 </BODY>
31627 </HTML>
31628 ====== h_config_quell_filtering_messages =====
31629 <HTML>
31630 <HEAD>
31631 <TITLE>FEATURE: <!--#echo var="FEAT_quell-filtering-messages"--></TITLE>
31632 </HEAD>
31633 <BODY>
31634 <H1>FEATURE: <!--#echo var="FEAT_quell-filtering-messages"--></H1>
31635
31636 If you use Filter Rules that move messages or set status of messages
31637 you sometimes see messages from Alpine that look like
31638
31639 <P>
31640 <CENTER><SAMP>&lt;filter name&gt;: Moving 2 filtered messages to &lt;folder name&gt;</SAMP></CENTER>
31641 <P>
31642
31643 or
31644
31645 <P>
31646 <CENTER><SAMP>&lt;filter name&gt;: Setting flags in 5 messages</SAMP></CENTER>
31647 <P>
31648
31649 or
31650
31651 <P>
31652 <CENTER><SAMP>Processing filter &lt;filter name&gt;</SAMP></CENTER>
31653 <P>
31654
31655 If this feature is set, these messages will be suppressed.
31656 The feature
31657 <A HREF="h_config_quell_filtering_done_message"><!--#echo var="FEAT_quell-filtering-done-message"--></A>
31658 is related.
31659
31660 <P>
31661 <UL>
31662 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31663 </UL><P>
31664 &lt;End of help on this topic&gt;
31665 </BODY>
31666 </HTML>
31667 ====== h_config_quell_post_prompt =====
31668 <HTML>
31669 <HEAD>
31670 <TITLE>FEATURE: <!--#echo var="FEAT_quell-extra-post-prompt"--></TITLE>
31671 </HEAD>
31672 <BODY>
31673 <H1>FEATURE: <!--#echo var="FEAT_quell-extra-post-prompt"--></H1>
31674
31675 By default, when you post a message to a newsgroup you are asked to confirm
31676 that you want to post with the question
31677
31678 <P>
31679 <CENTER><SAMP>Posted message may go to thousands of readers. Really post?</SAMP></CENTER>
31680 <P>
31681
31682 If this feature is set, you
31683 will <B>not</B> be prompted to confirm your intent to post to a newsgroup
31684 and your message will be posted.
31685
31686 <P>
31687 <UL>
31688 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31689 </UL><P>
31690 &lt;End of help on this topic&gt;
31691 </BODY>
31692 </HTML>
31693 ====== h_config_check_mail_onquit =====
31694 <HTML>
31695 <HEAD>
31696 <TITLE>FEATURE: <!--#echo var="FEAT_check-newmail-when-quitting"--></TITLE>
31697 </HEAD>
31698 <BODY>
31699 <H1>FEATURE: <!--#echo var="FEAT_check-newmail-when-quitting"--></H1>
31700
31701 If this feature is set, Alpine will check for new mail after you give the
31702 Quit command.
31703 If new mail has arrived since the previous check, you will be notified
31704 and given the choice of quitting or not quitting.
31705 <P>
31706 <UL>
31707 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31708 </UL><P>
31709 &lt;End of help on this topic&gt;
31710 </BODY>
31711 </HTML>
31712 ====== h_config_inbox_no_confirm =====
31713 <HTML>
31714 <HEAD>
31715 <TITLE>FEATURE: <!--#echo var="FEAT_return-to-inbox-without-confirm"--></TITLE>
31716 </HEAD>
31717 <BODY>
31718 <H1>FEATURE: <!--#echo var="FEAT_return-to-inbox-without-confirm"--></H1>
31719
31720 Normally, when you use the TAB <A HREF="h_common_nextnew">NextNew</A>
31721 command and there are no more folders or newsgroups to visit, you are asked
31722 if you want to return to the INBOX.
31723 If this feature is set you will not be asked.
31724 It will be assumed that you do want to return to the INBOX.
31725 <P>
31726 <UL>
31727 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31728 </UL><P>
31729 &lt;End of help on this topic&gt;
31730 </BODY>
31731 </HTML>
31732 ====== h_config_dates_to_local =====
31733 <HTML>
31734 <HEAD>
31735 <TITLE>FEATURE: <!--#echo var="FEAT_convert-dates-to-localtime"--></TITLE>
31736 </HEAD>
31737 <BODY>
31738 <H1>FEATURE: <!--#echo var="FEAT_convert-dates-to-localtime"--></H1>
31739
31740 Normally, the message dates that you see in the
31741 MESSAGE INDEX and MESSAGE VIEW are displayed in the timezone they were sent from.
31742 For example, if a message was sent to you from a few timezones to the east
31743 it might appear that it was sent from the future;
31744 or if it was sent from somewhere to the west it might appear
31745 as if it is from yesterday even though it was sent only a few minutes ago.
31746 If this feature is set an attempt will be made to convert the dates
31747 to your local timezone to be displayed.
31748 <P>
31749 Note that this does not affect the results of Select by Date or of
31750 anything else other than these displayed dates.
31751 When viewing the message you may look at the original unconverted value of the Date
31752 header by using the <A HREF="h_common_hdrmode">HdrMode Command</A>.
31753 <P>
31754 <UL>
31755 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31756 </UL><P>
31757 &lt;End of help on this topic&gt;
31758 </BODY>
31759 </HTML>
31760 ====== h_config_tab_no_prompt =====
31761 <HTML>
31762 <HEAD>
31763 <TITLE>FEATURE: <!--#echo var="FEAT_continue-tab-without-confirm"--></TITLE>
31764 </HEAD>
31765 <BODY>
31766 <H1>FEATURE: <!--#echo var="FEAT_continue-tab-without-confirm"--></H1>
31767
31768 Normally, when you use the TAB <A HREF="h_common_nextnew">NextNew</A>
31769 command and there is a problem checking a folder, you are asked
31770 whether you want to continue with the search in the following folder or not.
31771 This question gives you a chance to stop the NextNew processing.
31772 (The checking problem might be caused by the fact that the folder does not
31773 exist, or by an authentication problem, or by a server problem
31774 of some sort.)
31775 <P>
31776
31777 If this feature is set you will not be asked.
31778 It will be assumed that you do want to continue.
31779 <P>
31780 <UL>
31781 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31782 </UL><P>
31783 &lt;End of help on this topic&gt;
31784 </BODY>
31785 </HTML>
31786 ====== h_config_input_history =====
31787 <HTML>
31788 <HEAD>
31789 <TITLE>FEATURE: <!--#echo var="FEAT_disable-save-input-history"--></TITLE>
31790 </HEAD>
31791 <BODY>
31792 <H1>FEATURE: <!--#echo var="FEAT_disable-save-input-history"--></H1>
31793
31794 Many of the prompts that ask for input in the status line near the
31795 bottom of the screen will respond to Up Arrow and Down Arrow
31796 with the history of previous entries.
31797 For example, in the MESSAGE INDEX screen when you use the WhereIs
31798 command the text you entered will be remembered and can be recalled
31799 by using the Up Arrow key.
31800 Another example, when saving a message the folders saved to will
31801 be remembered and can be recalled using the arrow keys.
31802 <P>
31803 In the Save prompt, some users prefer that the Up and Down arrow keys
31804 be used for the Previous Collection and Next Collection commands
31805 instead of for a history of previous saves.
31806 If this option is set the Up and Down arrow keys will become synonyms for the
31807 Previous Collection and Next Collection (^P and ^N) commands in the
31808 prompt for the name of a folder to Save to or in the prompt for the
31809 name of a folder to GoTo.
31810 When this feature is not set (the default), ^P and ^N will change the
31811 collection and the arrow keys will show the history.
31812 <P>
31813 <UL>
31814 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31815 </UL><P>
31816 &lt;End of help on this topic&gt;
31817 </BODY>
31818 </HTML>
31819 ====== h_config_confirm_role =====
31820 <HTML>
31821 <HEAD>
31822 <TITLE>FEATURE: <!--#echo var="FEAT_confirm-role-even-for-default"--></TITLE>
31823 </HEAD>
31824 <BODY>
31825 <H1>FEATURE: <!--#echo var="FEAT_confirm-role-even-for-default"--></H1>
31826
31827 If you have roles, when you Reply to or Forward a message, or Compose
31828 a new message, Alpine
31829 will search through your roles for one that matches.
31830 Normally, if no matches are found you will be placed into the composer
31831 with no opportunity to select a role.
31832 If this feature is set, then you will be asked to confirm that you don't
31833 want a role.
31834 This will give you the opportunity to select a role (with the ^T command).
31835 If you confirm no role with a Return, you will be placed in
31836 the composer with no role.
31837 You may also confirm with either an &quot;N&quot; or a &quot;Y&quot;.
31838 These behave the same as if you pressed the Return.
31839 (The &quot;N&quot; and &quot;Y&quot; answers are available because they
31840 match what you might type if there was a role match.)
31841 <P>
31842 If you are using the alternate form of the Compose command called
31843 &quot;Role&quot;, then all of your roles will be available to you,
31844 independent of the value of this feature and of the values set for all of
31845 Reply Use, Forward Use, and Compose Use.
31846 <P>
31847 <UL>
31848 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31849 </UL><P>
31850 &lt;End of help on this topic&gt;
31851 </BODY>
31852 </HTML>
31853 ====== h_config_news_cross_deletes =====
31854 <HTML>
31855 <HEAD>
31856 <TITLE>FEATURE: <!--#echo var="FEAT_news-deletes-across-groups"--></TITLE>
31857 </HEAD>
31858 <BODY>
31859 <H1>FEATURE: <!--#echo var="FEAT_news-deletes-across-groups"--></H1>
31860
31861 This feature controls what Alpine does when you delete a message in a
31862 newsgroup that appears in more than one newsgroup.  Such a message
31863 is sometimes termed a &quot;crossposting&quot; in that it was posted
31864 across several newsgroups.
31865
31866 <P>
31867 Alpine's default behavior when you delete such a message is to remove
31868 only the copy in the current newsgroup from view when you use the
31869 &quot;Exclude&quot; command or the next time you visit the newsgroup.
31870
31871 <P>
31872 Enabling this feature causes Alpine to remove every occurrence of the
31873 message from all newsgroups it appears in and to which you are
31874 subscribed.
31875
31876 <P>
31877 NOTE: As currently implemented, enabling this feature may increase the
31878 time it takes the Expunge command and newsgroup closing to complete.
31879
31880 <P>
31881 <UL>
31882 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31883 </UL><P>
31884 &lt;End of help on this topic&gt;
31885 </BODY>
31886 </HTML>
31887 ====== h_config_news_catchup =====
31888 <HTML>
31889 <HEAD>
31890 <TITLE>FEATURE: <!--#echo var="FEAT_news-offers-catchup-on-close"--></TITLE>
31891 </HEAD>
31892 <BODY>
31893 <H1>FEATURE: <!--#echo var="FEAT_news-offers-catchup-on-close"--></H1>
31894
31895 This feature controls what Alpine does as it closes a newsgroup.
31896 When set, Alpine will offer to delete all messages from the newsgroup
31897 as you are quitting Alpine or opening a new folder.
31898
31899 <P>
31900 This feature is useful if you typically read all the interesting messages
31901 in a newsgroup each time you open it.  This feature saves you from
31902 having to delete each message in a newsgroup as you read it or from
31903 selecting all the messages and doing an
31904 <A HREF="h_config_enable_agg_ops">aggregate delete</A> before you
31905 move on to the next folder or newsgroup.
31906
31907 <P>
31908 <UL>
31909 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
31910 </UL><P>
31911 &lt;End of help on this topic&gt;
31912 </BODY>
31913 </HTML>
31914 ====== h_config_next_thrd_wo_confirm =====
31915 <HTML>
31916 <HEAD>
31917 <TITLE>FEATURE: <!--#echo var="FEAT_next-thread-without-confirm"--></TITLE>
31918 </HEAD>
31919 <BODY>
31920 <H1>FEATURE: <!--#echo var="FEAT_next-thread-without-confirm"--></H1>
31921
31922 This feature controls an aspect of Alpine's Next and Prev commands in
31923 the case where you are using one of the
31924 &quot;separate-index-screen&quot; styles for the configuration option
31925 <A HREF="h_config_thread_index_style">&quot;<!--#echo var="VAR_threading-index-style"-->&quot;</A>
31926 and currently have the folder sorted by a Threaded or OrderedSubject sort.
31927 When you are Viewing a particular thread you have a
31928 MESSAGE INDEX of only the messages in that thread.
31929 If you press the Next command with the last message in the thread highlighted
31930 you will normally be asked if you want to &quot;View next thread?&quot;,
31931 assuming there is a next thread to view.
31932 If this feature is set it will be assumed that you always want to view the
31933 next thread and you won't be asked to confirm that.
31934 Similarly, if the first message of the thread is highlighted and you
31935 press the Prev command, this feature will prevent the question
31936 &quot;View previous thread&quot;.
31937 <P>
31938 This feature only has an effect in the MESSAGE INDEX screen.
31939 If you then view a particular message from that screen and press the
31940 Next command, you will be sent to the next thread without being asked,
31941 independent of the setting of this feature.
31942 <P>
31943 The feature
31944 <A HREF="h_config_auto_open_unread">&quot;<!--#echo var="FEAT_auto-open-next-unread"-->&quot;</A> also has some similar effects.
31945 <P>
31946 &lt;End of help on this topic&gt;
31947 </BODY>
31948 </HTML>
31949 ====== h_config_kw_braces =====
31950 <HTML>
31951 <HEAD>
31952 <TITLE>OPTION: <!--#echo var="VAR_keyword-surrounding-chars"--></TITLE>
31953 </HEAD>
31954 <BODY>
31955 <H1>OPTION: <!--#echo var="VAR_keyword-surrounding-chars"--></H1>
31956
31957 This option controls a minor aspect of Alpine's MESSAGE INDEX and MESSAGE
31958 TEXT screens.
31959 If you have modified the
31960 &quot;<A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A>&quot; option
31961 so that either the &quot;SUBJKEY&quot; or &quot;SUBJKEYINIT&quot; tokens
31962 are used to display keywords or their initials along with the Subject; then
31963 this option may be used to modify the resulting display slightly.
31964 By default, the keywords or initials displayed for these tokens will be
31965 surrounded with curly braces ({ and }) and a trailing space.
31966 For example, if keywords &quot;Work&quot; and &quot;Now&quot; are set for
31967 a message, the &quot;SUBJKEY&quot; token will normally look like
31968 <P>
31969 <CENTER><SAMP>{Work Now} actual subject</SAMP></CENTER>
31970 <P>
31971 and the SUBJKEYINIT token would look like
31972 <P>
31973 <CENTER><SAMP>{WN} actual subject</SAMP></CENTER>
31974 <P>
31975 The default character before the keywords is the left brace ({) and the
31976 default after the keywords is the right brace followed by a space (} ).
31977 <P>
31978 This option allows you to change that.
31979 You should set it to two values separated by a space.
31980 The values may be quoted if they include space characters.
31981 So, for example, the default value could be specified explicitly by setting this
31982 option to
31983 <P>
31984 <CENTER><SAMP><!--#echo var="VAR_keyword-surrounding-chars"-->="{" "}&nbsp;"</SAMP></CENTER>
31985 <P>
31986 The first part wouldn't need to be quoted (but it doesn't hurt).
31987 The second part does need the quotes because it includes a space character.
31988 If you wanted to change the braces to brackets you could use
31989 <P>
31990 <CENTER><SAMP><!--#echo var="VAR_keyword-surrounding-chars"-->="[" "]&nbsp;"</SAMP></CENTER>
31991 <P>
31992 Inside the quotes you can use backslash quote to mean quote, so
31993 <P>
31994 <CENTER><SAMP><!--#echo var="VAR_keyword-surrounding-chars"-->="&#92;"" "&#92;" "</SAMP></CENTER>
31995 <P>
31996 would produce
31997 <P>
31998 <CENTER><SAMP>"Work Now" actual subject</SAMP></CENTER>
31999 <P>
32000 It is also possible to color keywords in the index using the
32001 Setup/Kolor screen (<A HREF="h_config_kw_color">Keyword Colors</A>).
32002 <P>
32003 It is not possible to change the fact that a space character is used to
32004 separate the keywords if more than one keyword is set for a message.
32005 It is also not possible to change the fact that there are no separators
32006 between the keyword initials if more than one keyword is set.
32007 <P>
32008 &lt;End of help on this topic&gt;
32009 </BODY>
32010 </HTML>
32011 ====== h_config_opening_sep =====
32012 <HTML>
32013 <HEAD>
32014 <TITLE>OPTION: <!--#echo var="VAR_opening-text-separator-chars"--></TITLE>
32015 </HEAD>
32016 <BODY>
32017 <H1>OPTION: <!--#echo var="VAR_opening-text-separator-chars"--></H1>
32018
32019 This option controls a minor aspect of Alpine's MESSAGE INDEX screen.
32020 With some setups the text of the subject is followed
32021 by the opening text of the message if there is any room available in the index line.
32022 If you have configured your
32023 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option
32024 to include one of the Subject tokens that causes this behavior
32025 (SUBJECTTEXT, SUBJKEYTEXT, or SUBJKEYINITTEXT), then this option may be used
32026 to modify what is displayed slightly.
32027 By default, the Subject is separated from the opening text of the message by
32028 the three characters space dash space;
32029 <P>
32030 <CENTER><SAMP>&quot;&nbsp;-&nbsp;&quot;</SAMP></CENTER>
32031 <P>
32032 Use this option to set it to something different.
32033 The value must be quoted if it includes any space characters.
32034 For example, the default value could be specified explicitly by setting this
32035 option to
32036 <P>
32037 <CENTER><SAMP><!--#echo var="VAR_opening-text-separator-chars"-->="&nbsp;-&nbsp;"</SAMP></CENTER>
32038 <P>
32039 &lt;End of help on this topic&gt;
32040 </BODY>
32041 </HTML>
32042 ====== h_config_select_wo_confirm =====
32043 <HTML>
32044 <HEAD>
32045 <TITLE>FEATURE: <!--#echo var="FEAT_select-without-confirm"--></TITLE>
32046 </HEAD>
32047 <BODY>
32048 <H1>FEATURE: <!--#echo var="FEAT_select-without-confirm"--></H1>
32049
32050 This feature controls an aspect of Alpine's Save, Export, and Goto commands.
32051 These commands all take text input to specify the name of the folder or
32052 file to be used, but allow you to press ^T for a list of possible names.
32053 If set, the selected name will be used immediately, without further
32054 opportunity to confirm or edit the name.
32055 <P>
32056 Some related help topics are
32057 <UL>
32058 <LI> <A HREF="h_mainhelp_aggops">Aggregate Operations</A>
32059 <LI> <A HREF="h_index_cmd_select">Selecting: Select and WhereIs/Select</A>,
32060 <LI> <A HREF="h_config_enable_agg_ops"><!--#echo var="FEAT_enable-aggregate-command-set"--></A>,
32061 <LI> <A HREF="h_config_auto_unselect"><!--#echo var="FEAT_auto-unselect-after-apply"--></A>.
32062 <LI> <A HREF="h_config_auto_unzoom"><!--#echo var="FEAT_auto-unzoom-after-apply"--></A>, and
32063 <LI> <A HREF="h_config_auto_zoom"><!--#echo var="FEAT_auto-zoom-after-select"--></A>.
32064 </UL>
32065 <P>
32066 &lt;End of help on this topic&gt;
32067 </BODY>
32068 </HTML>
32069 ====== h_config_save_part_wo_confirm =====
32070 <HTML>
32071 <HEAD>
32072 <TITLE>FEATURE: <!--#echo var="FEAT_save-partial-msg-without-confirm"--></TITLE>
32073 </HEAD>
32074 <BODY>
32075 <H1>FEATURE: <!--#echo var="FEAT_save-partial-msg-without-confirm"--></H1>
32076
32077 This feature controls an aspect of Alpine's Save command.
32078 By default, when you Save a message that has some deleted parts, you will
32079 be asked to confirm that you want to Save with a prompt that looks like:
32080 <P>
32081 <CENTER><SAMP>Saved copy will NOT include entire message!  Continue?</SAMP></CENTER>
32082 <P>
32083 If this feature is set, you will not be asked.
32084 <P>
32085 &lt;End of help on this topic&gt;
32086 </BODY>
32087 </HTML>
32088 ====== h_config_use_resentto =====
32089 <HTML>
32090 <HEAD>
32091 <TITLE>FEATURE: <!--#echo var="FEAT_use-resent-to-in-rules"--></TITLE>
32092 </HEAD>
32093 <BODY>
32094 <H1>FEATURE: <!--#echo var="FEAT_use-resent-to-in-rules"--></H1>
32095
32096 This feature is turned off by default because turning it on causes problems
32097 with some deficient IMAP servers.
32098 In Alpine <A HREF="h_mainhelp_filtering">Filters</A> and other types of Rules, if the
32099 <A HREF="h_rule_patterns">Pattern</A>
32100 contains a To header pattern and this feature is turned on,
32101 then a check is made in the message to see
32102 if a Resent-To header is present, and that is used instead of the To header.
32103 If this feature is not turned on, then the regular To header will always
32104 be used.
32105
32106 <P>
32107 &lt;End of help on this topic&gt;
32108 </BODY>
32109 </HTML>
32110 ====== h_config_use_reg_start_for_stayopen =====
32111 <HTML>
32112 <HEAD>
32113 <TITLE>FEATURE: <!--#echo var="FEAT_use-regular-startup-rule-for-stayopen-folders"--></TITLE>
32114 </HEAD>
32115 <BODY>
32116 <H1>FEATURE: <!--#echo var="FEAT_use-regular-startup-rule-for-stayopen-folders"--></H1>
32117
32118 This feature affects which message is selected as the current message
32119 when you enter a
32120 <A HREF="h_config_permlocked">Stay Open</A> folder.
32121 <P>
32122 Normally, the starting position for an incoming folder (which most Stay Open
32123 folders will likely be) is controlled by the
32124 <A HREF="h_config_inc_startup"><!--#echo var="VAR_incoming-startup-rule"--></A>.
32125 However, if a folder is a Stay Open folder, when you re-enter the folder
32126 after the first time the current message will be the same as it was when
32127 you left the folder.
32128 An exception is made if you use the TAB command to get to the folder.
32129 In that case, the message number will be incremented by one from what it
32130 was when you left the folder.
32131 <P>
32132 The above special behavior is thought to be useful.
32133 However, it is special and different from what you might at first expect.
32134 If this feature is set, then Stay Open folders will not be treated specially
32135 as far as the startup rule is concerned.
32136
32137 <P>
32138 &lt;End of help on this topic&gt;
32139 </BODY>
32140 </HTML>
32141 ====== h_config_use_current_dir =====
32142 <HTML>
32143 <HEAD>
32144 <TITLE>FEATURE: <!--#echo var="FEAT_use-current-dir"--></TITLE>
32145 </HEAD>
32146 <BODY>
32147 <H1>FEATURE: <!--#echo var="FEAT_use-current-dir"--></H1>
32148
32149 This feature controls an aspect of several commands.
32150 If set, your &quot;current working directory&quot;
32151 <!--chtml if pinemode="running"-->
32152 (which, at least for your current Alpine &quot;session,&quot;
32153 is &quot;<!--#echo var="CURRENT_DIR"-->&quot;)
32154 <!--chtml endif-->
32155 will be used instead of your home directory
32156 <!--chtml if pinemode="running"-->
32157 (which, in the present configuration of your system, is
32158  &quot;<!--#echo var="HOME_DIR"-->&quot;)
32159 <!--chtml endif-->
32160 for all of the following operations:<UL>
32161     <LI> Export in the MESSAGE INDEX and MESSAGE TEXT screens
32162     <LI> Attachment Save in the MESSAGE TEXT and ATTACHMENT TEXT screens
32163     <LI> <!--chtml if pinemode="function_key"-->F4
32164          <!--chtml else-->Ctrl-R
32165          <!--chtml endif--> file inclusion in the COMPOSER
32166     <LI> <!--chtml if pinemode="function_key"-->F5
32167          <!--chtml else-->Ctrl-J
32168          <!--chtml endif--> file attachment in the COMPOSER
32169 </UL>
32170 <!--chtml if pinemode="os_windows"-->
32171 <P>
32172 If you are starting PC-Alpine from a desktop icon or the Start menu,
32173 you can set the &quot;current drive&quot;
32174 by specifying it in the &quot;Start in:&quot;
32175 box found in the Shortcut tab of the Properties.
32176 <!--chtml endif-->
32177 <P>
32178 <UL>
32179 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32180 </UL>
32181
32182 <P>
32183 &lt;End of help on this topic&gt;
32184 </BODY>
32185 </HTML>
32186 ====== h_config_save_wont_delete =====
32187 <HTML>
32188 <HEAD>
32189 <TITLE>FEATURE: <!--#echo var="FEAT_save-will-not-delete"--></TITLE>
32190 </HEAD>
32191 <BODY>
32192 <H1>FEATURE: <!--#echo var="FEAT_save-will-not-delete"--></H1>
32193
32194 This feature controls one aspect of the Save command.  If set, Save will
32195 not mark the message &quot;deleted&quot; (its default behavior) after
32196 it has been copied to the designated folder.
32197
32198 <P>
32199 &lt;End of help on this topic&gt;
32200 </BODY>
32201 </HTML>
32202 ====== h_config_use_boring_spinner =====
32203 <HTML>
32204 <HEAD>
32205 <TITLE>FEATURE: <!--#echo var="FEAT_busy-cue-spinner-only"--></TITLE>
32206 </HEAD>
32207 <BODY>
32208 <H1>FEATURE: <!--#echo var="FEAT_busy-cue-spinner-only"--></H1>
32209
32210 When Alpine is delayed for some reason it usually shows that
32211 something is happening with a small animated display in the status
32212 message line near the bottom of the screen.
32213 Setting this feature will cause that animation to be the same
32214 each time instead of having Alpine choose a random animation.
32215 You may turn the animation off altogether by setting the
32216 <A HREF="h_config_active_msg_interval"><!--#echo var="VAR_busy-cue-rate"--></A>
32217 option to zero.
32218
32219 <P>
32220 &lt;End of help on this topic&gt;
32221 </BODY>
32222 </HTML>
32223 ====== h_config_unsel_wont_advance =====
32224 <HTML>
32225 <HEAD>
32226 <TITLE>FEATURE: <!--#echo var="FEAT_unselect-will-not-advance"--></TITLE>
32227 </HEAD>
32228 <BODY>
32229 <H1>FEATURE: <!--#echo var="FEAT_unselect-will-not-advance"--></H1>
32230
32231 This feature controls one aspect of the Unselect Current message command.
32232 Normally, when the Unselect current message command (:) is typed when the
32233 current message is selected, the message will be unselected and the next
32234 message will become the current message.
32235 If this feature is set, the cursor will not advance to the next message.
32236 Instead, the current message will remain the current message after
32237 unselecting.
32238
32239 <P>
32240 &lt;End of help on this topic&gt;
32241 </BODY>
32242 </HTML>
32243 ====== h_config_prune_uses_iso =====
32244 <HTML>
32245 <HEAD>
32246 <TITLE>FEATURE: <!--#echo var="FEAT_prune-uses-yyyy-mm"--></TITLE>
32247 </HEAD>
32248 <BODY>
32249 <H1>FEATURE: <!--#echo var="FEAT_prune-uses-yyyy-mm"--></H1>
32250
32251 By default, Alpine asks monthly whether or not you would like to rename
32252 some folders to a new name containing the date.
32253 It also asks whether or not you would like to delete some old folders.
32254 See the <A HREF="h_config_pruning_rule"><!--#echo var="VAR_pruning-rule"--></A> option for an
32255 explanation.
32256
32257 <P>
32258 By default, the name used when renaming a folder looks like
32259 <P>
32260 <CENTER><SAMP>&lt;foldername&gt;-&lt;month&gt;-&lt;year&gt;</SAMP></CENTER>
32261 <P>
32262 For example, the first time you run Alpine in May of 2004,
32263 the folder &quot;sent-mail&quot; might be renamed to
32264 <P>
32265 <CENTER><SAMP>sent-mail-apr-2004</SAMP></CENTER>
32266 <P>
32267 If this feature is set, the name used will be of the form
32268 <P>
32269 <CENTER><SAMP>&lt;foldername&gt;-&lt;yyyy&gt;-&lt;mm&gt;</SAMP></CENTER>
32270 <P>
32271 where &quot;yyyy&quot; is the year and &quot;mm&quot; is the two-digit
32272 month (01, 02, ..., 12).
32273 For the April, 2004 example above, it would instead be
32274 <P>
32275 <CENTER><SAMP>sent-mail-2004-04</SAMP></CENTER>
32276 <P>
32277 because April is the 4th month of the year.
32278 A reason you might want to set this feature is so that the folders
32279 will sort in chronological order.
32280
32281 <P>
32282 &lt;End of help on this topic&gt;
32283 </BODY>
32284 </HTML>
32285 ====== h_config_save_advances =====
32286 <HTML>
32287 <HEAD>
32288 <TITLE>FEATURE: <!--#echo var="FEAT_save-will-advance"--></TITLE>
32289 </HEAD>
32290 <BODY>
32291 <H1>FEATURE: <!--#echo var="FEAT_save-will-advance"--></H1>
32292
32293 This feature controls one aspect of the Save command.  If set, Save will
32294 (in addition to copying the current message to the designated folder) also
32295 advance to the next message.
32296
32297 <P>
32298 &lt;End of help on this topic&gt;
32299 </BODY>
32300 </HTML>
32301 ====== h_config_force_arrow =====
32302 <HTML>
32303 <HEAD>
32304 <TITLE>FEATURE: <!--#echo var="FEAT_force-arrow-cursor"--></TITLE>
32305 </HEAD>
32306 <BODY>
32307 <H1>FEATURE: <!--#echo var="FEAT_force-arrow-cursor"--></H1>
32308
32309 This feature affects Alpine's MESSAGE INDEX display routine.
32310 If set, the normal inverse-video cursor will be
32311 replaced by a simple &quot;arrow&quot; cursor, which normally occupies the
32312 second column of the index display.
32313 <P>
32314 This is the same index cursor you get if you turn on
32315 <A HREF="h_config_force_low_speed"><!--#echo var="FEAT_assume-slow-link"--></A>, but the index
32316 line coloring will still be present if this feature is turned on and
32317 <!--#echo var="FEAT_assume-slow-link"--> is off.
32318 <P>
32319 An alternative version of the Arrow cursor is available by including the
32320 <A HREF="h_config_index_arrow_color">ARROW</A>
32321 token in the
32322 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option.
32323 <P>
32324 It ought to be the case that this feature also affects the ATTACHMENT INDEX,
32325 but that is not implemented.
32326
32327 <P>
32328 &lt;End of help on this topic&gt;
32329 </BODY>
32330 </HTML>
32331 ====== h_config_ignore_size =====
32332 <HTML>
32333 <HEAD>
32334 <TITLE>FEATURE: <!--#echo var="FEAT_ignore-size-changes"--></TITLE>
32335 </HEAD>
32336 <BODY>
32337 <H1>FEATURE: <!--#echo var="FEAT_ignore-size-changes"--></H1>
32338
32339 When you have an account residing in an IMAP server, Alpine records the
32340 size of each message as reported by the server. However, when Alpine saves
32341 a message in such IMAP server, Alpine will compute the size of the message
32342 independently, from the data it received. If these two numbers do not
32343 match for a message, Alpine asks you if you still want to take the risk of
32344 saving such message, since data corruption or loss of data could result
32345 from this save.
32346
32347 <P>
32348 Sometimes the root of this problem is that the IMAP server does not
32349 compute sizes correctly, and there will not be loss of information when
32350 saving such message. Enabling this feature will make Alpine ignore such
32351 error and continue saving the message without producing any warnings or
32352 ever stopping the process, as if there had not been any error. This option
32353 applies to all IMAP servers that you use, so if you enable this feature,
32354 size discrepancy warnings will not be given for any IMAP server you
32355 connect to.
32356
32357 <P>
32358 Example of a server where you could reproduce this problem is the Gmail
32359 IMAP server. Another example can be found in some versions of the Exchange
32360 server.
32361
32362 <P>
32363 It is recommended that this feature be disabled most of the time and only
32364 enabled when you find a server which you can determine that has the above
32365 mentioned defect, but be disabled again after making the save operation
32366 succeed.
32367
32368 <P>
32369 &lt;End of help on this topic&gt;
32370 </BODY>
32371 </HTML>
32372 ====== h_config_force_low_speed =====
32373 <HTML>
32374 <HEAD>
32375 <TITLE>FEATURE: <!--#echo var="FEAT_assume-slow-link"--></TITLE>
32376 </HEAD>
32377 <BODY>
32378 <H1>FEATURE: <!--#echo var="FEAT_assume-slow-link"--></H1>
32379
32380 UNIX Alpine only.
32381 <P>
32382 This feature affects Alpine's display routines.  If set, the normal
32383 inverse-video cursor (used to highlight the current item in a list) will be
32384 replaced by an &quot;arrow&quot; cursor and other
32385 screen update optimizations for
32386 low-speed links (e.g. 2400 bps dialup connections) will be activated.
32387 One of the optimizations is that colored index lines (set up with Indexcolor
32388 Rules) will not be colored.
32389 If you are just turning this feature on because you like using
32390 the &quot;arrow&quot; cursor you may have an arrow cursor with index line
32391 coloring by turning this feature off and the
32392 <A HREF="h_config_force_arrow"><!--#echo var="FEAT_force-arrow-cursor"--></A> on.
32393
32394 <P>
32395 &lt;End of help on this topic&gt;
32396 </BODY>
32397 </HTML>
32398 ====== h_config_show_delay_cue =====
32399 <HTML>
32400 <HEAD>
32401 <TITLE>FEATURE: <!--#echo var="FEAT_enable-mail-check-cue"--></TITLE>
32402 </HEAD>
32403 <BODY>
32404 <H1>FEATURE: <!--#echo var="FEAT_enable-mail-check-cue"--></H1>
32405
32406 If set, this feature will cause an asterisk to appear in the upper
32407 left-hand corner of the screen whenever Alpine checks for new mail.
32408 Two asterisks whenever Alpine saves (checkpoints) the state of the current
32409 mailbox to disk.
32410
32411 <!--chtml if pinemode="os_windows"-->
32412 <P>
32413 In addition, PC-Alpine will display a less-than symbol, '&lt;', when
32414 it is trying to open a network connection (e.g, to open your INBOX
32415 on an IMAP
32416 server) or read from the network connection.  A greater-than symbol,
32417 will be displayed when PC-Alpine is trying to write to the network
32418 connection (e.g, sending a command to your IMAP server).
32419 <!--chtml endif-->
32420
32421 <P>
32422 &lt;End of help on this topic&gt;
32423 </BODY>
32424 </HTML>
32425 ====== h_config_color_style =====
32426 <HTML>
32427 <HEAD>
32428 <TITLE>OPTION: Color Style</TITLE>
32429 </HEAD>
32430 <BODY>
32431 <H1>OPTION: Color Style</H1>
32432
32433 UNIX Alpine only.
32434 <P>
32435 If the terminal or terminal emulator you are using is capable of displaying
32436 colors, this option controls whether or not color will be used in Alpine.
32437 If you turn color on and things are set up correctly,
32438 you should see color appear on the screen immediately.
32439 Modern terminal emulators are usually capable of displaying colors.
32440 <P>
32441 The available options include:
32442 <P>
32443
32444 <DL>
32445 <DT>no-color</DT>
32446 <DD>Don't use color.
32447 </DD>
32448
32449 <DT>use-termdef</DT>
32450 <DD>In order to decide if your terminal is capable of color, Alpine looks in
32451 the terminal capabilities database, TERMINFO or TERMCAP, depending on
32452 how Alpine was compiled.
32453 This is a good option to choose if you switch between a color and a non-color
32454 terminal with the same Alpine configuration.
32455 Alpine will know to use color on the color terminal because it is described
32456 in the termcap entry, and Alpine will know to use black and white on the
32457 non-color terminal.
32458 The Alpine Technical Notes, distributed with the source code of Alpine
32459 have more information on configuring a TERMCAP or TERMINFO
32460 entry for color Alpine.
32461 This is usually something a system administrator does.
32462 </DD>
32463
32464 <DT>force-ansi-8color</DT>
32465 <DD>This is probably the setting that most people should use.
32466 Because setting up a termcap entry is confusing and because the
32467 terminal capabilities database is often not correctly configured for color,
32468 this choice and the next may be easier for you to use.
32469 If your terminal emulator responds to ANSI color escape sequences, which
32470 many do, this option will cause Alpine to believe your terminal will respond
32471 to the escape sequences that produce eight different foreground and background
32472 colors.
32473 The escape sequences used to set the foreground colors are
32474
32475   <P><CENTER>ESC&nbsp;[&nbsp;3&nbsp;&lt;color_number&gt;&nbsp;m</CENTER><P>
32476
32477 where the color_number is an ASCII digit between 0 and 7.
32478 The numbers 0 through 7 should correspond to the colors black, red, green,
32479 yellow, blue, magenta, cyan, and white.
32480 Some terminal emulators use a pre-ANSI scheme that swaps
32481 the colors blue and red and the colors yellow and cyan.
32482 This will cause the default colors to be different, but other than that
32483 things should work fine.
32484 There is also a 9th color available, the last one shown, which is the default
32485 color from the terminal emulator.
32486 When used as a background color some people refer to this color as
32487 &quot;transparent&quot;, which is why the letters &quot;TRAN&quot; are
32488 shown in the color swatch of the SETUP COLOR screen.
32489 The foreground transparent color is shown as
32490 the color of the &quot;TRAN&quot; text.
32491 (The transparent color will not work correctly in a PC-Alpine configuration.)
32492 The escape sequences used to set the background colors are the same
32493 as for the foreground colors except a &quot;4&quot; replaces the &quot;3&quot;.
32494 The escape sequences for foreground and background default colors (transparent)
32495 are 39m and 49m.
32496 <P>
32497 Note: With the Tera Term terminal emulator this setting works well.
32498 You should also have the Tera Term &quot;Full color&quot; option turned OFF.
32499 You may find the &quot;Full color&quot; option in Tera Term's &quot;Setup&quot;
32500 menu, in the &quot;Window&quot; submenu.
32501 </DD>
32502
32503 <DT>force-ansi-16color</DT>
32504 <DD>Many terminal emulators know about the same eight colors above
32505 plus eight more.
32506 This option attempts to use all 16 colors.
32507 The same escape sequences as for the eight-color terminal are used
32508 for the first eight colors.
32509 The escape sequences used to set foreground colors 8-15 are the same as
32510 for 0-7 except the &quot;3&quot; is replaced with a &quot;9&quot;.
32511 The background color sequences for colors 8-15 are the same as for 0-7
32512 except the &quot;4&quot; is replaced with &quot;10&quot;.
32513 You can tell if the 16 colors are working by turning on this option
32514 and then going into one of the color configuration screens, for example,
32515 the configuration screen for Normal Color.
32516 If you see 16 different colors to select from (plus a 17th for
32517 the transparent color), it's working.
32518 </DD>
32519
32520 <DT>force-xterm-256color</DT>
32521 <DD>Some versions of xterm (and some other terminal emulators)
32522 have support for 256 colors.
32523 The escape sequences used to set the foreground colors are
32524
32525   <P><CENTER>ESC&nbsp;[&nbsp;38&nbsp;;&nbsp;5&nbsp;;&nbsp;&lt;color_number&gt;&nbsp;m</CENTER><P>
32526
32527 where the color_number is an ASCII digit between 0 and 255.
32528 Background colors are the same with the 38 replaced with a 48.
32529 The numbers 0 through 15 are probably similar to the 16 color version
32530 above, then comes a 6x6x6 color cube, followed by 24 colors of gray.
32531 The terminal default (transparent) color is the 257th color at the bottom.
32532 Some terminal emulators will misinterpret these escape sequences causing
32533 the terminal to blink or overstrike characters or to do something else
32534 undesirable.
32535 <P>
32536 The PuTTY terminal emulator has an option called &quot;Allow terminal to
32537 use xterm 256-colour mode&quot; which allows PuTTY to work well with
32538 this 256-color setting.
32539
32540 </DD>
32541 </DL>
32542
32543 <P>
32544 The normal default is &quot;no-color&quot;.
32545 <P>
32546
32547 Once you've turned on color you may set the
32548 colors of many objects on the screen individually.
32549 For example, you may add colors to the status letters on the MESSAGE
32550 INDEX page.
32551 Most categories of color that Alpine supports are configurable here.
32552 For example, &quot;Normal Color&quot;
32553 is the color used to display most of the text in Alpine, and
32554 &quot;Reverse Color&quot; is used to display highlighted text, such as the
32555 current message in the MESSAGE INDEX.
32556 <P>
32557 Lines in the MESSAGE INDEX may also be colored.
32558 Use Setup Rules to get to the Indexcolor configuration screen.
32559 <P>
32560
32561 <UL>
32562 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32563 </UL><P>
32564 &lt;End of help on this topic&gt;
32565 </BODY>
32566 </HTML>
32567 ====== h_config_disable_index_locale_dates =====
32568 <HTML>
32569 <HEAD>
32570 <TITLE>FEATURE: <!--#echo var="FEAT_disable-index-locale-dates"--></TITLE>
32571 </HEAD>
32572 <BODY>
32573 <H1>FEATURE: <!--#echo var="FEAT_disable-index-locale-dates"--></H1>
32574
32575 This feature affects the display of dates in the MESSAGE INDEX.
32576 Normally an attempt is made to localize the dates
32577 used in the MESSAGE INDEX display to your locale.
32578 This is controlled with the
32579 LC_TIME locale setting on a UNIX system.
32580 On Windows the Regional Options control panel may be used to set the date format.
32581 At the programming level, Alpine is using the strftime routine
32582 to print the parts of a date.
32583 <P>
32584 If this feature is set, dates are displayed in English and
32585 with the conventions of the United States.
32586 <P>
32587
32588 <UL>
32589 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32590 </UL><P>
32591 &lt;End of help on this topic&gt;
32592 </BODY>
32593 </HTML>
32594 ====== h_config_auto_open_unread =====
32595 <HTML>
32596 <HEAD>
32597 <TITLE>FEATURE: <!--#echo var="FEAT_auto-open-next-unread"--></TITLE>
32598 </HEAD>
32599 <BODY>
32600 <H1>FEATURE: <!--#echo var="FEAT_auto-open-next-unread"--></H1>
32601
32602 This feature controls the behavior of the TAB key when traversing folders
32603 in the optional
32604 <A HREF="h_config_enable_incoming">&quot;<!--#echo var="VAR_incoming-folders"-->&quot;</A>
32605 collection or in optional <!--#echo var="VAR_news-collections"-->.
32606 <P>
32607 When the TAB
32608 (<A HREF="h_common_nextnew">NextNew</A>)
32609 key is pressed, and there
32610 are no more unseen messages in the current (incoming message or news)
32611 folder, Alpine will search the list of folders in the current collection for
32612 one containing New or Recent (new since the last time the folder was
32613 opened) messages.
32614 This behavior may be modified slightly with the
32615 <A HREF="h_config_tab_uses_unseen">&quot;<!--#echo var="FEAT_tab-uses-unseen-for-next-folder"-->&quot;</A>
32616 feature that causes Alpine to look for Unseen messages instead of Recent
32617 messages.
32618 Normally, when such a folder is found, Alpine will ask
32619 whether you wish to open the folder.  If this feature is set, Alpine will
32620 automatically open the folder without prompting.
32621 <P>
32622 This feature also affects some other similar situations.
32623 If you have a
32624 <A HREF="h_config_thread_index_style"><!--#echo var="VAR_threading-index-style"--></A>
32625 that is equal to one of the &quot;separate-&quot; values, and you are
32626 viewing a thread; then when you type the NextNew command and are at the
32627 end of the current thread you will automatically go to the next thread
32628 if this feature is set.
32629 By default, you would be asked if you want to view the next thread.
32630 You will also be asked at times whether or not you want to view the next
32631 thread after you delete the last message in the thread.
32632 Setting this feature will also cause that question to be skipped.
32633 <P>
32634
32635 <UL>
32636 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32637 </UL><P>
32638 &lt;End of help on this topic&gt;
32639 </BODY>
32640 </HTML>
32641 ====== h_config_auto_include_reply =====
32642 <HTML>
32643 <HEAD>
32644 <TITLE>FEATURE: <!--#echo var="FEAT_include-text-in-reply"--></TITLE>
32645 </HEAD>
32646 <BODY>
32647 <H1>FEATURE: <!--#echo var="FEAT_include-text-in-reply"--></H1>
32648
32649 This feature controls an aspect of Alpine's Reply command.  Normally, Alpine
32650 will ask whether you wish to include the original message in your reply.
32651 If this feature is set and the feature
32652 <A HREF="h_config_prefix_editing">&quot;<!--#echo var="FEAT_enable-reply-indent-string-editing"-->&quot;</A>
32653 is <EM>not</EM> set, then the original message will be included in the reply
32654 automatically, without prompting.
32655 <P>
32656 &lt;End of help on this topic&gt;
32657 </BODY>
32658 </HTML>
32659 ====== h_config_select_in_bold =====
32660 <HTML>
32661 <HEAD>
32662 <TITLE>FEATURE: <!--#echo var="FEAT_show-selected-in-boldface"--></TITLE>
32663 </HEAD>
32664 <BODY>
32665 <H1>FEATURE: <!--#echo var="FEAT_show-selected-in-boldface"--></H1>
32666
32667 This feature controls an aspect of Alpine's
32668 <A HREF="h_config_enable_agg_ops">&quot;aggregate operation&quot;</A>
32669 commands; in
32670 particular, the Select and WhereIs commands. Select and WhereIs (with the
32671 ^X subcommand) will search the current folder for messages meeting a
32672 specified criteria, and &quot;tag&quot; the resulting messages with an
32673 &quot;X&quot; in the
32674 first column of the applicable lines in the MESSAGE INDEX.  If this feature
32675 is set, instead of using the &quot;X&quot; to denote a selected message,
32676 Alpine will
32677 attempt to display those index lines in boldface. Whether this is
32678 preferable to the &quot;X&quot; will depend on personal taste and the type of
32679 terminal being used.
32680 <P>
32681 <UL>
32682 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32683 </UL><P>
32684 &lt;End of help on this topic&gt;
32685 </BODY>
32686 </HTML>
32687 ====== h_config_alt_auth =====
32688 <HTML>
32689 <HEAD>
32690 <TITLE>FEATURE: <!--#echo var="FEAT_try-alternative-authentication-driver-first"--></TITLE>
32691 </HEAD>
32692 <BODY>
32693 <H1>FEATURE: <!--#echo var="FEAT_try-alternative-authentication-driver-first"--></H1>
32694
32695 This feature affects how Alpine connects to IMAP servers.
32696 Its utility has largely been overtaken by events,
32697 but it may still be useful in some circumstances.
32698 If you only connect to modern IMAP servers that support
32699 &quot;STARTTLS&quot; you can ignore this feature.
32700
32701 <P>
32702 Details:
32703
32704 <P>
32705 By default, Alpine will attempt to connect to an IMAP server on the
32706 normal IMAP service port (143), and if the server offers &quot;Transport Layer
32707 Security&quot; (STARTTLS) and Alpine has been compiled with encryption capability,
32708 then a secure (encrypted) session will be negotiated.
32709
32710 <P>
32711 With this feature enabled, before connecting on the normal IMAP port, Alpine
32712 will first attempt to connect to an alternate IMAP service port (993) used
32713 specifically for encrypted IMAP sessions via the Secure Sockets Layer
32714 (SSL) or Transport Layer Security (TLS) method.
32715 If the SSL attempt fails, Alpine will then try the default
32716 behavior described in the previous paragraph.
32717
32718 <P>
32719 STARTTLS negotiation on the normal port is preferred, and supersedes the use of
32720 SSL on port 993, but older servers may not provide STARTTLS support.
32721 This feature may be convenient when accessing IMAP servers that do not support
32722 STARTTLS, but do support SSL or TLS connections on port 993.
32723 However, it is important to understand that with this feature enabled,
32724 Alpine will <EM>attempt</EM> to make a secure connection if that is possible,
32725 but it will proceed to make an insecure connection if that is the only
32726 option offered by the server, or if the Alpine in question has been built
32727 without encryption capability.
32728
32729 <P>
32730 Note that this feature specifies a per-user (or system-wide) default
32731 behavior, but host/folder specification flags may be used to control the
32732 behavior of any specific connection.
32733 This feature interacts with some of
32734 the possible host/folder path specification flags as follows:
32735
32736 <P>
32737 The <SAMP>/starttls</SAMP> host flag, for example,
32738
32739 <P>
32740 <CENTER><SAMP>{foo.example.com/starttls}INBOX</SAMP></CENTER>
32741 <P>
32742 will over-ride this feature for the specified host by bypassing the
32743 SSL or TLS connection attempt.
32744 Moreover, with <SAMP>/starttls</SAMP> specified,
32745 the connection attempt will fail if the
32746 service on port 143 does not offer TLS support.
32747
32748 <P>
32749 The <SAMP>/ssl</SAMP> host flag, for example,
32750
32751 <P>
32752 <CENTER><SAMP>{foo.example.com/ssl}INBOX</SAMP></CENTER>
32753 <P>
32754 will insist on an SSL or TLS connection for the specified host,
32755 and will fail if the SSL or TLS service on port 993 is not available.
32756 Alpine will not subsequently retry a connection
32757 on port 143 if <SAMP>/ssl</SAMP> is specified.
32758
32759 <P>
32760 <UL>
32761 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32762 </UL><P>
32763 &lt;End of help on this topic&gt;
32764 </BODY>
32765 </HTML>
32766 ====== h_config_file_dir ======
32767 <HTML>
32768 <HEAD>
32769 <TITLE>OPTION: File Directory</TITLE>
32770 </HEAD>
32771 <BODY>
32772 <H1>OPTION: File Directory</H1>
32773
32774 PC-Alpine only.
32775 <P>
32776 This value affects the Composer's &quot;^J&nbsp;Attach&quot; command,
32777 the Attachment Index Screen's &quot;S&nbsp;Save&quot; command, and the
32778 Message Index's &quot;E&nbsp;Export&quot; command.
32779
32780 <P>
32781 Normally, when a filename is supplied that lacks a leading &quot;path&quot;
32782 component, Alpine assumes the file exists in the user's home directory.
32783 Under Windows operating systems, this definition isn't always clear.  This
32784 feature allows you to explicitly set where Alpine should look for files
32785 without a leading path.
32786
32787 <P>
32788 NOTE: this feature's value is ignored if either
32789 <A HREF="h_config_use_current_dir"><!--#echo var="FEAT_use-current-dir"--></A> feature
32790 is set or the PINERC has a value for the &quot;<!--#echo var="VAR_operating-dir"-->&quot; variable.
32791
32792 <P>
32793 <UL>
32794 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
32795 </UL><P>
32796 &lt;End of help on this topic&gt;
32797 </BODY>
32798 </HTML>
32799 ====== h_config_quote_all_froms =====
32800 <HTML>
32801 <HEAD>
32802 <TITLE>FEATURE: <!--#echo var="FEAT_save-will-quote-leading-froms"--></TITLE>
32803 </HEAD>
32804 <BODY>
32805 <H1>FEATURE: <!--#echo var="FEAT_save-will-quote-leading-froms"--></H1>
32806
32807 This feature controls an aspect of the Save command (and also the way
32808 outgoing messages are saved to an FCC folder).  If set, Alpine will add
32809 a leading &quot;>&quot; character in front of message lines beginning with &quot;From&quot;
32810 when they are saved to another folder, including lines syntactically
32811 distinguishable from the type of message separator line commonly used on
32812 Unix systems.
32813
32814 <P>
32815 The default behavior is that a &quot;>&quot; will be prepended only to lines
32816 beginning with &quot;From &quot; that might otherwise be confused with a message
32817 separator line on Unix systems.  If pine is the only mail program you use,
32818 this default is reasonable.  If another program you use has trouble
32819 displaying a message with an unquoted &quot;From &quot; saved by Alpine, you should
32820 enable this feature.  This feature only applies to the common Unix mailbox
32821 format that uses message separator lines beginning with &quot;From &quot;.  If
32822 Alpine has been configured to use a different mailbox format (possibly
32823 incompatible with other mail programs), then this issue does not arise,
32824 and the feature is irrelevant.
32825
32826 <P>
32827 &lt;End of help on this topic&gt;
32828 </BODY>
32829 </HTML>
32830 ====== h_config_normal_color =====
32831 <HTML>
32832 <HEAD>
32833 <TITLE>OPTION: Normal Color</TITLE>
32834 </HEAD>
32835 <BODY>
32836 <H1>OPTION: Normal Color</H1>
32837
32838 Sets the color Alpine normally uses.
32839 The foreground color is the color of the actual character and the
32840 background color is the color of the area behind the character.
32841 By default this color is black characters on a white background.
32842 <P>
32843 <A HREF="h_color_setup">Descriptions of the available commands</A>
32844 <P>
32845 Look <A HREF="h_edit_nav_cmds">here</A>
32846 to see the available Editing and Navigation commands.
32847 <P>
32848 &lt;End of help on this topic&gt;
32849 </BODY>
32850 </HTML>
32851 ====== h_config_reverse_color =====
32852 <HTML>
32853 <HEAD>
32854 <TITLE>OPTION: Reverse Color</TITLE>
32855 </HEAD>
32856 <BODY>
32857 <H1>OPTION: Reverse Color</H1>
32858
32859 Sets the color Alpine uses for reverse video characters.
32860 The foreground color is the color of the actual character and the
32861 background color is the color of the area behind the character.
32862 <P>
32863 <A HREF="h_color_setup">Descriptions of the available commands</A>
32864 <P>
32865 Look <A HREF="h_edit_nav_cmds">here</A>
32866 to see the available Editing and Navigation commands.
32867 <P>
32868 &lt;End of help on this topic&gt;
32869 </BODY>
32870 </HTML>
32871 ====== h_config_title_color =====
32872 <HTML>
32873 <HEAD>
32874 <TITLE>OPTION: Title Color</TITLE>
32875 </HEAD>
32876 <BODY>
32877 <H1>OPTION: Title Color</H1>
32878
32879 Sets the color Alpine uses for the titlebar (the top line on the screen).
32880 The foreground color is the color of the actual character and the
32881 background color is the color of the area behind the character.
32882 By default, the Title Color is black characters on a yellow background.
32883 <P>
32884 The actual titlebar color may be different from the Title Color if
32885 the option
32886 <A HREF="h_config_titlebar_color_style">&quot;<!--#echo var="VAR_titlebar-color-style"-->&quot;</A>
32887 is set to some value other than the default.
32888 It may also be different if the current folder is closed and the
32889 <A HREF="h_config_titleclosed_color">Title Closed Color</A>
32890 color is set to something different from the Title Color.
32891 <P>
32892 <A HREF="h_color_setup">Descriptions of the available commands</A>
32893 <P>
32894 Look <A HREF="h_edit_nav_cmds">here</A>
32895 to see the available Editing and Navigation commands.
32896 <P>
32897 &lt;End of help on this topic&gt;
32898 </BODY>
32899 </HTML>
32900 ====== h_config_titleclosed_color =====
32901 <HTML>
32902 <HEAD>
32903 <TITLE>OPTION: Title Closed Color</TITLE>
32904 </HEAD>
32905 <BODY>
32906 <H1>OPTION: Title Closed Color</H1>
32907
32908 Sets the color Alpine uses for the titlebar (the top line on the screen)
32909 when the current folder is closed.
32910 The foreground color is the color of the actual character and the
32911 background color is the color of the area behind the character.
32912 By default, the Title Color Closed Color is white characters on a red background.
32913 <P>
32914 By setting this color to something noticeable you will be alerted to the
32915 fact that the current folder is closed, perhaps unexpectedly.
32916 <P>
32917 &lt;End of help on this topic&gt;
32918 </BODY>
32919 </HTML>
32920 ====== h_config_status_color =====
32921 <HTML>
32922 <HEAD>
32923 <TITLE>OPTION: Status Color</TITLE>
32924 </HEAD>
32925 <BODY>
32926 <H1>OPTION: Status Color</H1>
32927
32928 Sets the color Alpine uses for status messages written to the message
32929 line near the bottom of the screen.
32930 The foreground color is the color of the actual character and the
32931 background color is the color of the area behind the character.
32932 By default, the Status Color is the same as the Reverse Color.
32933 <P>
32934 <A HREF="h_color_setup">Descriptions of the available commands</A>
32935 <P>
32936 Look <A HREF="h_edit_nav_cmds">here</A>
32937 to see the available Editing and Navigation commands.
32938 <P>
32939 &lt;End of help on this topic&gt;
32940 </BODY>
32941 </HTML>
32942 ====== h_config_index_opening_color =====
32943 <HTML>
32944 <HEAD>
32945 <TITLE>OPTION: Index Opening Color</TITLE>
32946 </HEAD>
32947 <BODY>
32948 <H1>OPTION: Index Opening Color</H1>
32949
32950 With some setups the text of the subject is followed
32951 by the opening text of the message if there is any room available in the index line.
32952 If you have configured your
32953 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option
32954 to include one of the Subject tokens that causes this behavior
32955 (SUBJECTTEXT, SUBJKEYTEXT, or SUBJKEYINITTEXT), you may set the color of
32956 this opening text with this option.
32957 This coloring takes place for all but the current index line, and the Opening
32958 Color appears to be in front of any color from an Index Color Rule.
32959 <P>
32960 By default the Index Opening Color is gray characters on a white background.
32961
32962 <P>
32963 <A HREF="h_color_setup">Descriptions of the available commands</A>
32964 <P>
32965 Look <A HREF="h_edit_nav_cmds">here</A>
32966 to see the available Editing and Navigation commands.
32967 <P>
32968 &lt;End of help on this topic&gt;
32969 </BODY>
32970 </HTML>
32971 ====== h_config_index_pri_color =====
32972 <HTML>
32973 <HEAD>
32974 <TITLE>OPTION: Index Priority Symbol Colors</TITLE>
32975 </HEAD>
32976 <BODY>
32977 <H1>OPTION: Index Priority Symbol Colors</H1>
32978
32979 The X-Priority header is a non-standard header that is used in a
32980 somewhat standard way by many mail programs.
32981 Alpine expects the value of this header to be a digit with a value
32982 from 1 to 5, with 1 being the highest priority and 5 the lowest priority.
32983 Alpine can be made to display an indication of this priority in
32984 messages by use of one of the tokens
32985 (<A HREF="h_index_tokens">Tokens for Index and Replying</A>)
32986 PRIORITY, PRIORITYALPHA, or PRIORITY! in the
32987 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option.
32988
32989 <P>
32990 You may set the color used to draw these tokens by use of the colors
32991 Index High Priority Symbol Color and Index Low Priority Symbol Color.
32992 This coloring takes place for all but the current index line, and the Priority
32993 Color appears to be in front of any color from an Index Color Rule.
32994 If the priority has a value of 1 or 2 the High Priority color will be
32995 used,
32996 and if the value is 4 or 5 the Low Priority color will be used.
32997 <P>
32998 If you don't set these colors the index line will be colored in the same color as
32999 the bulk of the index line.
33000
33001 <P>
33002 <A HREF="h_color_setup">Descriptions of the available commands</A>
33003 <P>
33004 Look <A HREF="h_edit_nav_cmds">here</A>
33005 to see the available Editing and Navigation commands.
33006 <P>
33007 &lt;End of help on this topic&gt;
33008 </BODY>
33009 </HTML>
33010 ====== h_config_index_subject_color =====
33011 <HTML>
33012 <HEAD>
33013 <TITLE>OPTION: Index Subject Color</TITLE>
33014 </HEAD>
33015 <BODY>
33016 <H1>OPTION: Index Subject Color</H1>
33017
33018 You may set the color used to draw the Subject part of the index line.
33019 This coloring takes place for all but the current index line, and the Subject
33020 Color appears to be in front of any color from an Index Color Rule.
33021 <P>
33022 If you don't set this color it will be colored in the same color as
33023 the bulk of the index line.
33024
33025 <P>
33026 <A HREF="h_color_setup">Descriptions of the available commands</A>
33027 <P>
33028 Look <A HREF="h_edit_nav_cmds">here</A>
33029 to see the available Editing and Navigation commands.
33030 <P>
33031 &lt;End of help on this topic&gt;
33032 </BODY>
33033 </HTML>
33034 ====== h_config_index_from_color =====
33035 <HTML>
33036 <HEAD>
33037 <TITLE>OPTION: Index From Color</TITLE>
33038 </HEAD>
33039 <BODY>
33040 <H1>OPTION: Index From Color</H1>
33041
33042 You may set the color used to draw the From part of the index line.
33043 This coloring takes place for all but the current index line, and the From
33044 Color appears to be in front of any color from an Index Color Rule.
33045 <P>
33046 If you don't set this color it will be colored in the same color as
33047 the bulk of the index line.
33048
33049 <P>
33050 <A HREF="h_color_setup">Descriptions of the available commands</A>
33051 <P>
33052 Look <A HREF="h_edit_nav_cmds">here</A>
33053 to see the available Editing and Navigation commands.
33054 <P>
33055 &lt;End of help on this topic&gt;
33056 </BODY>
33057 </HTML>
33058 ====== h_config_index_arrow_color =====
33059 <HTML>
33060 <HEAD>
33061 <TITLE>OPTION: Index Arrow Color</TITLE>
33062 </HEAD>
33063 <BODY>
33064 <H1>OPTION: Index Arrow Color</H1>
33065
33066 If you have configured your
33067 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option
33068 to include the &quot;ARROW&quot; token, you may set the color of
33069 the arrow displayed with this option.
33070 If you don't set the color it will be colored in the same color as
33071 the bulk of the index line.
33072
33073 <P>
33074 <A HREF="h_color_setup">Descriptions of the available commands</A>
33075 <P>
33076 Look <A HREF="h_edit_nav_cmds">here</A>
33077 to see the available Editing and Navigation commands.
33078 <P>
33079 &lt;End of help on this topic&gt;
33080 </BODY>
33081 </HTML>
33082 ====== h_config_index_color =====
33083 <HTML>
33084 <HEAD>
33085 <TITLE>OPTION: Index Colors</TITLE>
33086 </HEAD>
33087 <BODY>
33088 <H1>OPTION: Index Colors</H1>
33089
33090 You may add color to the single character symbols that give the status
33091 of each message in the MESSAGE INDEX.
33092 By default the characters &quot;+&quot;, &quot;*&quot;, &quot;D&quot;,
33093 &quot;A&quot;, and &quot;N&quot; show up near the left hand side of the
33094 screen depending on whether the message is addressed to you, and whether
33095 the message is marked Important, is Deleted, is Answered, or is New.
33096 The color for each of those characters may be specified by setting the
33097 &quot;Index-to-me&quot; Symbol Color,
33098 the &quot;Index-important&quot; Symbol Color,
33099 the &quot;Index-deleted&quot; Symbol Color,
33100 the &quot;Index-answered&quot; Symbol Color,
33101 and the &quot;Index-new&quot; Symbol Color.
33102 There are also two other symbol colors called &quot;Index-recent&quot;
33103 and &quot;Index-unseen&quot;.
33104 These two colors will only be used if you have configured your
33105 &quot;<A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A>&quot; option
33106 to include the &quot;IMAPSTATUS&quot; or &quot;SHORTIMAPSTATUS&quot; token.
33107 <P>
33108 The default colors for these symbols are:
33109 <TABLE>
33110 <TR> <TD> &nbsp;&nbsp;Index-to-me&nbsp;&nbsp;&nbsp;&nbsp; </TD> <TD> black on cyan </TD> </TR>
33111 <TR> <TD> &nbsp;&nbsp;Index-important </TD> <TD> white on bright red </TD> </TR>
33112 <TR> <TD> &nbsp;&nbsp;Index-deleted&nbsp;&nbsp; </TD> <TD> same as Normal Color </TD> </TR>
33113 <TR> <TD> &nbsp;&nbsp;Index-answered&nbsp; </TD> <TD> bright red on yellow </TD> </TR>
33114 <TR> <TD> &nbsp;&nbsp;Index-new&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </TD> <TD> white on magenta </TD> </TR>
33115 <TR> <TD> &nbsp;&nbsp;Index-recent&nbsp;&nbsp;&nbsp; </TD> <TD> same as Normal Color </TD> </TR>
33116 <TR> <TD> &nbsp;&nbsp;Index-unseen&nbsp;&nbsp;&nbsp; </TD> <TD> same as Normal Color </TD> </TR>
33117 </TABLE>
33118 <P>
33119 Besides coloring the message status symbols, you may also color the
33120 entire index line.
33121 This is done by using the
33122 <A HREF="h_rules_incols">SETUP INDEX LINE COLORS</A> screen, which you
33123 may get to with the commands <EM>S</EM>etup/<EM>R</EM>ules/<EM>I</EM>ndexcolor.
33124 When the entire line is colored that color will be &quot;behind&quot; the
33125 status symbol colors talked about in the paragraph above.
33126 <P>
33127 You may also color
33128 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>
33129 in the index using the
33130 Setup/Kolor screen (<A HREF="h_config_kw_color">Keyword Colors</A>);
33131 the <A HREF="h_config_index_arrow_color">ARROW</A> cursor;
33132 the Subject using
33133 <A HREF="h_config_index_subject_color">Index Subject Color</A>;
33134 the From field using
33135 <A HREF="h_config_index_from_color">Index From Color</A>;
33136 and the
33137 <A HREF="h_config_index_opening_color">Index Opening</A> text.
33138 <P>
33139 <A HREF="h_color_setup">Descriptions of the available commands</A>
33140 <P>
33141 Look <A HREF="h_edit_nav_cmds">here</A>
33142 to see the available Editing and Navigation commands.
33143 <P>
33144 &lt;End of help on this topic&gt;
33145 </BODY>
33146 </HTML>
33147 ====== h_config_metamsg_color =====
33148 <HTML>
33149 <HEAD>
33150 <TITLE>OPTION: Meta-Message Color</TITLE>
33151 </HEAD>
33152 <BODY>
33153 <H1>OPTION: Meta-Message Color</H1>
33154
33155 Sets the color Alpine uses in the MESSAGE TEXT screen for messages to you
33156 that aren't part of the message itself.
33157 For example, an attachment that isn't shown might produce a meta
33158 message something like:
33159 <P>
33160 <CENTER><SAMP> [ Part 2, &quot;comment&quot; Text/PLAIN (Name: &quot;file&quot;) ]</SAMP></CENTER>
33161 <P>
33162 If you set the
33163 <A HREF="h_config_quote_suppression"><!--#echo var="VAR_quote-suppression-threshold"--></A>
33164 option you might see
33165 <P>
33166 <CENTER><SAMP>[ 12 lines of quoted text hidden from view ]</SAMP></CENTER>
33167 <P>
33168 Warnings about suspicious looking URLs in HTML will also be colored
33169 with this color.
33170 <P>
33171 The foreground color is the color of the actual character and the
33172 background color is the color of the area behind the character.
33173 By default, the Meta-Message Color is black characters on a yellow background.
33174 <P>
33175 <A HREF="h_color_setup">Descriptions of the available commands</A>
33176 <P>
33177 Look <A HREF="h_edit_nav_cmds">here</A>
33178 to see the available Editing and Navigation commands.
33179 <P>
33180 &lt;End of help on this topic&gt;
33181 </BODY>
33182 </HTML>
33183 ====== h_config_keylabel_color =====
33184 <HTML>
33185 <HEAD>
33186 <TITLE>OPTION: KeyLabel Color</TITLE>
33187 </HEAD>
33188 <BODY>
33189 <H1>OPTION: KeyLabel Color</H1>
33190
33191 Sets the color Alpine uses for the labels of the keys in the two-line
33192 menu at the bottom of the screen.
33193 For example, some of the screens have a &quot;P PrevMsg&quot; command.
33194 This option sets the color used when displaying &quot;PrevMsg&quot;.
33195 The foreground color is the color of the actual character and the
33196 background color is the color of the area behind the character.
33197 By default, the KeyLabel Color is the same as the Normal Color.
33198 <P>
33199 WARNING: Some terminal emulators have the property that the screen will scroll
33200 down one line whenever a character is written to the character cell in the
33201 lower right corner of the screen.
33202 Alpine can usually avoid writing a character in that corner of the screen.
33203 However, if you have defined a KeyLabel Color then Alpine does have to write
33204 a character in that cell in order to color the cell correctly.
33205 If you find that your display sometimes scrolls up a line this could be
33206 the problem.
33207 The most obvious symptom is probably that the titlebar at the top of the
33208 screen scrolls off the screen.
33209 Try setting KeyLabel Color to Default to see if that fixes the problem.
33210 <P>
33211 <A HREF="h_color_setup">Descriptions of the available commands</A>
33212 <P>
33213 Look <A HREF="h_edit_nav_cmds">here</A>
33214 to see the available Editing and Navigation commands.
33215 <P>
33216 &lt;End of help on this topic&gt;
33217 </BODY>
33218 </HTML>
33219 ====== h_config_keyname_color =====
33220 <HTML>
33221 <HEAD>
33222 <TITLE>OPTION: KeyName Color</TITLE>
33223 </HEAD>
33224 <BODY>
33225 <H1>OPTION: KeyName Color</H1>
33226
33227 Sets the color Alpine uses for the names of the keys in the two-line
33228 menu at the bottom of the screen.
33229 For example, some of the screens have a &quot;P PrevMsg&quot; command.
33230 This option sets the color used when displaying the &quot;P&quot;.
33231 The foreground color is the color of the actual character and the
33232 background color is the color of the area behind the character.
33233 By default, the KeyName Color is the same as the Reverse Color.
33234 <P>
33235 <A HREF="h_color_setup">Descriptions of the available commands</A>
33236 <P>
33237 Look <A HREF="h_edit_nav_cmds">here</A>
33238 to see the available Editing and Navigation commands.
33239 <P>
33240 &lt;End of help on this topic&gt;
33241 </BODY>
33242 </HTML>
33243 ====== h_config_slctbl_color =====
33244 <HTML>
33245 <HEAD>
33246 <TITLE>OPTION: Selectable Item Color</TITLE>
33247 </HEAD>
33248 <BODY>
33249 <H1>OPTION: Selectable Item Color</H1>
33250
33251 Sets the color Alpine uses for selectable items, such as URLs.
33252 The foreground color is the color of the actual character and the
33253 background color is the color of the area behind the character.
33254 By default, the Selectable Item Color is the same as the Normal Color,
33255 except that it is bold.
33256 <P>
33257 <A HREF="h_color_setup">Descriptions of the available commands</A>
33258 <P>
33259 Look <A HREF="h_edit_nav_cmds">here</A>
33260 to see the available Editing and Navigation commands.
33261 <P>
33262 &lt;End of help on this topic&gt;
33263 </BODY>
33264 </HTML>
33265 ====== h_config_quote_color =====
33266 <HTML>
33267 <HEAD>
33268 <TITLE>OPTION: Quote Colors</TITLE>
33269 </HEAD>
33270 <BODY>
33271 <H1>OPTION: Quote Colors</H1>
33272
33273 Sets the colors Alpine uses for coloring quoted text in the MESSAGE TEXT
33274 screen.
33275 If a line begins with a &gt; character (or space followed by &gt;)
33276 it is considered a quote.
33277 That line will be given the Quote1 Color (first level quote).
33278 If there is a second level of quoting then the Quote2 Color will be used.
33279 Alpine considers there to be a second level of quoting if that first &gt; is
33280 followed by another &gt; (or space followed by &gt;).
33281 If there are characters other than whitespace and &gt; signs, then it isn't
33282 considered another level of quoting.
33283 Similarly, if there is a third level of quoting the Quote3 Color will be
33284 used.
33285 If there are more levels after that the Quote Colors are re-used.
33286 If you define all three colors then it would repeat like Color1, Color2, Color3,
33287 Color1, Color2, Color3, ...
33288 If you only define the first two it would be
33289 Color1, Color2, Color1, Color2, ...
33290 If you define only the Quote1 Color, then the entire quote would be that
33291 color regardless of the quoting levels.
33292 By default, the Quote1 Color is black characters on a greenish-blue background;
33293 the Quote2 Color is black characters on a dull yellow background; and
33294 the Quote3 Color is black characters on a green background.
33295 <P>
33296 <A HREF="h_color_setup">Descriptions of the available commands</A>
33297 <P>
33298 Look <A HREF="h_edit_nav_cmds">here</A>
33299 to see the available Editing and Navigation commands.
33300 <P>
33301 &lt;End of help on this topic&gt;
33302 </BODY>
33303 </HTML>
33304 ====== h_config_folder_color =====
33305 <HTML>
33306 <HEAD>
33307 <TITLE>OPTION: Folder Color</TITLE>
33308 </HEAD>
33309 <BODY>
33310 <H1>OPTION: Folder Color</H1>
33311
33312 Sets the colors Alpine uses for coloring a folder in the FOLDER LIST
33313 screen. By default, the Folder Color is the normal text color.
33314
33315 <P>
33316 If you set a color for this feature, other than the normal color
33317 (the default), or a color for
33318 <A HREF="h_config_directory_color">Directory Color</A>, then directories
33319 will be colored according to the color specified in the
33320 <A HREF="h_config_directory_color">Directory Color</A> option. In this
33321 case, the color will be the only indication that the colored name
33322 refers to a directory. The normal behavior is that Alpine
33323 indicates that a name refers to a directory by appending a
33324 separator (like &quot;/&quot; or &quot;.&quot;) to the name of
33325 the folder.
33326
33327 <P>
33328 If a folder is a directory, then the folder name will be painted
33329 according to the color defined by this variable, and a separator
33330 indicator  (like &quot;/&quot; or &quot;.&quot;) will be added
33331 to the name. That
33332 indicator will be painted according to the color defined in the
33333 <A HREF="h_config_directory_color">Directory Color</A> option.
33334
33335 <P>
33336 &lt;End of help on this topic&gt;
33337 </BODY>
33338 </HTML>
33339 ====== h_config_directory_color =====
33340 <HTML>
33341 <HEAD>
33342 <TITLE>OPTION: Directory Color</TITLE>
33343 </HEAD>
33344 <BODY>
33345 <H1>OPTION: Directory Color</H1>
33346
33347 Sets the colors Alpine uses for coloring a directory in the FOLDER LIST
33348 screen. By default, the Folder Color is the normal text color.
33349 <P>
33350 If you set a color for this feature, other than the normal color
33351 (the default), or a color for
33352 <A HREF="h_config_folder_color">Folder Color</A>, then folders
33353 will be colored according to the color specified in the
33354 <A HREF="h_config_folder_color">Folder Color</A> option. In this
33355 case, the color will be the only indication that the colored name
33356 refers to a directory. The normal behavior is that Alpine
33357 indicates that a name refers to a directory by appending a
33358 separator (like &quot;/&quot; or &quot;.&quot;) to the name of
33359 the folder.
33360 <P>
33361 If a folder is a directory, then the folder name will be painted
33362 according to the color defined by the option
33363 <A HREF="h_config_folder_color">Folder Color</A>, and the separator
33364 indicator  (like &quot;/&quot; or &quot;.&quot;) will be added
33365 after the name. That
33366 indicator will be painted according to the color defined in this
33367 option.
33368 <P>
33369 &lt;End of help on this topic&gt;
33370 </BODY>
33371 </HTML>
33372 ====== h_config_folder_list_color =====
33373 <HTML>
33374 <HEAD>
33375 <TITLE>OPTION: Folder-List Color</TITLE>
33376 </HEAD>
33377 <BODY>
33378 <H1>OPTION: Folder-List Color</H1>
33379
33380 Sets the colors Alpine uses for coloring normal text in the FOLDER LIST
33381 screen. By default, the Folder-List Color is the normal text color.
33382 <P>
33383 This text refers to the informative text that Alpine displays so you
33384 can recognize each collection. The color of the content of each collection
33385 is determined by the options <A HREF="h_config_folder_color">Folder Color</A>
33386 and <A HREF="h_config_directory_color">Directory Color</A>.
33387 <P>
33388 Unlike the options
33389 <A HREF="h_config_folder_color">Folder Color</A>
33390 and <A HREF="h_config_directory_color">Directory Color</A>, configuring
33391 this option does not affect the way that Alpine reports folders,
33392 directories and folders that are directories.
33393 <P>
33394 &lt;End of help on this topic&gt;
33395 </BODY>
33396 </HTML>
33397 ====== h_config_incunseen_color =====
33398 <HTML>
33399 <HEAD>
33400 <TITLE>OPTION: Incoming Unseen Color</TITLE>
33401 </HEAD>
33402 <BODY>
33403 <H1>OPTION: Incoming Unseen Color</H1>
33404
33405 If the option
33406 <A HREF="h_config_enable_incoming_checking"><!--#echo var="FEAT_enable-incoming-folders-checking"--></A>
33407 is turned on it is possible to highlight the folders that contain
33408 unseen messages by coloring them with this color.
33409 By default, this is the same as the Normal Color and no highlighting is done.
33410 <P>
33411 Usually the &quot;current&quot; folder (the folder the cursor is on)
33412 is highlighted using reverse video.
33413 If the current folder is colored because it contains unseen messages then
33414 the color used to show that it is also the current folder is controlled
33415 by the
33416 <A HREF="h_config_index_color_style"><!--#echo var="VAR_current-indexline-style"--></A>
33417 feature at the top of the SETUP COLOR screen.
33418 <P>
33419 <A HREF="h_color_setup">Descriptions of the available commands</A>
33420 <P>
33421 Look <A HREF="h_edit_nav_cmds">here</A>
33422 to see the available Editing and Navigation commands.
33423 <P>
33424 &lt;End of help on this topic&gt;
33425 </BODY>
33426 </HTML>
33427 ====== h_config_signature_color =====
33428 <HTML>
33429 <HEAD>
33430 <TITLE>OPTION: Signature Color</TITLE>
33431 </HEAD>
33432 <BODY>
33433 <H1>OPTION: Signature Color</H1>
33434
33435 Sets the color Alpine uses for coloring the signature in the MESSAGE TEXT
33436 screen. According to USENET conventions, the signature is defined as the
33437 paragraph following the &quot;sigdashes&quot;, that is, the special line
33438 consisting of the three characters
33439 &quot;--&nbsp;&quot; (i.e., dash, dash, and space). Alpine allows for one
33440 empty line right after the sigdashes to be considered as part of the
33441 signature.
33442 By default, the Signature Color is blue characters on a white background.
33443 <P>
33444 <A HREF="h_color_setup">Descriptions of the available commands</A>
33445 <P>
33446 Look <A HREF="h_edit_nav_cmds">here</A>
33447 to see the available Editing and Navigation commands.
33448 <P>
33449 &lt;End of help on this topic&gt;
33450 </BODY>
33451 </HTML>
33452 ====== h_config_prompt_color =====
33453 <HTML>
33454 <HEAD>
33455 <TITLE>OPTION: Prompt Color</TITLE>
33456 </HEAD>
33457 <BODY>
33458 <H1>OPTION: Prompt Color</H1>
33459
33460 Sets the color Alpine uses for confirmation prompts and questions that
33461 appear in the status line near the bottom of the screen.
33462 The foreground color is the color of the actual character and the
33463 background color is the color of the area behind the character.
33464 By default, the Prompt Color is the same as the Reverse Color.
33465 <P>
33466 <A HREF="h_color_setup">Descriptions of the available commands</A>
33467 <P>
33468 Look <A HREF="h_edit_nav_cmds">here</A>
33469 to see the available Editing and Navigation commands.
33470 <P>
33471 &lt;End of help on this topic&gt;
33472 </BODY>
33473 </HTML>
33474 ====== h_config_header_general_color =====
33475 <HTML>
33476 <HEAD>
33477 <TITLE>OPTION: Header General Color</TITLE>
33478 </HEAD>
33479 <BODY>
33480 <H1>OPTION: Header General Color</H1>
33481
33482 Sets the color Alpine uses for the headers of a message in the MESSAGE TEXT
33483 screen.
33484 The foreground color is the color of the actual character and the
33485 background color is the color of the area behind the character.
33486 By default, this is the same as the Normal Color.
33487 <P>
33488 It is also possible to set the colors for specific header fields, for
33489 example the Subject, using
33490 <A HREF="h_config_customhdr_color"><!--#echo var="VAR_viewer-hdr-colors"--></A>.
33491 If both a Header General Color and a specific Viewer Header Color are set
33492 the specific color will override the general color, as you would expect.
33493 <P>
33494 <A HREF="h_color_setup">Descriptions of the available commands</A>
33495 <P>
33496 Look <A HREF="h_edit_nav_cmds">here</A>
33497 to see the available Editing and Navigation commands.
33498 <P>
33499 &lt;End of help on this topic&gt;
33500 </BODY>
33501 </HTML>
33502 ====== h_config_incol =====
33503 <HTML>
33504 <HEAD>
33505 <TITLE>Index Line Color</TITLE>
33506 </HEAD>
33507 <BODY>
33508 <H1>Index Line Color</H1>
33509
33510 This option is used to set the color of a line in the index when the
33511 message for that line matches the Pattern.
33512 This colors the whole index line, except possibly the status letters,
33513 which may be colored separately using the
33514 <A HREF="h_color_setup">Setup Kolor</A> screen.
33515 The foreground color is the color of the actual characters and the
33516 background color is the color of the area behind the characters.
33517 <P>
33518 <A HREF="h_color_setup">Descriptions of the available commands</A>
33519 <P>
33520 Look <A HREF="h_edit_nav_cmds">here</A>
33521 to see the available Editing and Navigation commands.
33522 <P>
33523 &lt;End of help on this topic&gt;
33524 </BODY>
33525 </HTML>
33526 ====== h_config_usetransparent_color =====
33527 <HTML>
33528 <HEAD>
33529 <TITLE>OPTION: Use Transparent Color</TITLE>
33530 </HEAD>
33531 <BODY>
33532 <H1>OPTION: Use Transparent Color</H1>
33533
33534 This is a special color supported by some terminal emulators.
33535 It is intended to result in the default foreground or background color
33536 from the terminal emulator.
33537 This is the color the terminal was displaying characters in before you started Alpine.
33538 The reason it is called Transparent is because you could set the foreground color
33539 to some specific color, like Red, and then set the background color to the
33540 Transparent Color. If it works as expected, the background color from the terminal
33541 window in which Alpine is running will show through but with the Red characters
33542 in the foreground.
33543 <P>
33544 <A HREF="h_color_setup">Descriptions of the available commands</A>
33545 <P>
33546 Look <A HREF="h_edit_nav_cmds">here</A>
33547 to see the available Editing and Navigation commands.
33548 <P>
33549 &lt;End of help on this topic&gt;
33550 </BODY>
33551 </HTML>
33552 ====== h_config_usenormal_color =====
33553 <HTML>
33554 <HEAD>
33555 <TITLE>OPTION: Use Normal Color</TITLE>
33556 </HEAD>
33557 <BODY>
33558 <H1>OPTION: Use Normal Color</H1>
33559
33560 When you use this color value, the actual color used will be the same
33561 as the corresponding Normal Color.
33562 For example if your Normal Color is black on white and you set both
33563 the foreground and background colors here to use the Normal Color, you'll
33564 get black on white. If you later change the Normal Color to red on blue
33565 this color will also change to red on blue.
33566 <P>
33567 <A HREF="h_color_setup">Descriptions of the available commands</A>
33568 <P>
33569 Look <A HREF="h_edit_nav_cmds">here</A>
33570 to see the available Editing and Navigation commands.
33571 <P>
33572 &lt;End of help on this topic&gt;
33573 </BODY>
33574 </HTML>
33575 ====== h_config_usenone_color =====
33576 <HTML>
33577 <HEAD>
33578 <TITLE>OPTION: Use None Color</TITLE>
33579 </HEAD>
33580 <BODY>
33581 <H1>OPTION: Use None Color</H1>
33582
33583 This is a special color that simply means to leave the color alone.
33584 It is useful for Index symbols and for Keyword Colors used in the Subject
33585 field of an index line.
33586 The most likely use is to set an explicit foreground color and then set
33587 the background color to the None Color.
33588 That will cause the symbol or keyword to be drawn in the foreground color
33589 with a background equal to whatever color the rest of the index line is already
33590 drawn in.
33591 You will see no visible effect unless you have assigned Indexcolor Rules to
33592 color index lines or you have set an actual color for the Reverse Color.
33593 <P>
33594 <A HREF="h_color_setup">Descriptions of the available commands</A>
33595 <P>
33596 Look <A HREF="h_edit_nav_cmds">here</A>
33597 to see the available Editing and Navigation commands.
33598 <P>
33599 &lt;End of help on this topic&gt;
33600 </BODY>
33601 </HTML>
33602 ====== h_config_dflt_color =====
33603 <HTML>
33604 <HEAD>
33605 <TITLE>OPTION: Default Color</TITLE>
33606 </HEAD>
33607 <BODY>
33608 <H1>OPTION: Default Color</H1>
33609
33610 Setting default will cause the color to be the default color.
33611 Unsetting default is normally done by choosing a color, but in some cases
33612 you may want to declare the current default color to be your non-default
33613 choice.
33614 For example, the default Keyname Color is the same as the Reverse Color.
33615 Whenever the Reverse Color changes the Keyname Color will also change, unless
33616 you've changed it or unset the default box.
33617 <P>
33618 <A HREF="h_color_setup">Descriptions of the available commands</A>
33619 <P>
33620 Look <A HREF="h_edit_nav_cmds">here</A>
33621 to see the available Editing and Navigation commands.
33622 <P>
33623 &lt;End of help on this topic&gt;
33624 </BODY>
33625 </HTML>
33626 ====== h_config_bold_slctbl =====
33627 <HTML>
33628 <HEAD>
33629 <TITLE>OPTION: Bold</TITLE>
33630 </HEAD>
33631 <BODY>
33632 <H1>OPTION: Bold</H1>
33633
33634 The color for this particular section may have the Bold attribute turned
33635 on or off.
33636 Setting bold will cause the characters to be bold.
33637 <P>
33638 <A HREF="h_color_setup">Descriptions of the available commands</A>
33639 <P>
33640 Look <A HREF="h_edit_nav_cmds">here</A>
33641 to see the available Editing and Navigation commands.
33642 <P>
33643 &lt;End of help on this topic&gt;
33644 </BODY>
33645 </HTML>
33646 ====== h_config_kw_color =====
33647 <HTML>
33648 <HEAD>
33649 <TITLE>OPTION: Keyword Colors</TITLE>
33650 </HEAD>
33651 <BODY>
33652 <H1>OPTION: Keyword Colors</H1>
33653
33654 Sets the colors Alpine uses for Keyword fields in the MESSAGE INDEX screen.
33655 Keywords are displayed as part of the Subject by default.
33656 They are also displayed as part of the Subject if the tokens
33657 &quot;SUBJKEY&quot;, &quot;SUBJKEYTEXT&quot;, &quot;SUBJKEYINIT&quot;, or &quot;SUBJKEYINITTEXT&quot; are used in the
33658 <A HREF="h_config_index_format"><!--#echo var="VAR_index-format"--></A> option.
33659 Keywords may also be displayed in a column of their own in the MESSAGE INDEX
33660 screen by using the &quot;KEY&quot; or &quot;KEYINIT&quot; tokens.
33661 <P>
33662 For example, you might have set up a Keyword
33663 &quot;Work&quot; using the
33664 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A> option in the Setup/Config screen.
33665 You could cause that Keyword to show up as a special color
33666 by setting up the Keyword Color using this option, and then including it
33667 in the MESSAGE INDEX screen using one of the tokens listed above in the
33668 <!--#echo var="VAR_index-format"-->.
33669 <P>
33670 <A HREF="h_color_setup">Descriptions of the available commands</A>
33671 <P>
33672 Look <A HREF="h_edit_nav_cmds">here</A>
33673 to see the available Editing and Navigation commands.
33674 <P>
33675 &lt;End of help on this topic&gt;
33676 </BODY>
33677 </HTML>
33678 ====== h_config_customhdr_color =====
33679 <HTML>
33680 <HEAD>
33681 <TITLE>OPTION: <!--#echo var="VAR_viewer-hdr-colors"--></TITLE>
33682 </HEAD>
33683 <BODY>
33684 <H1>OPTION: <!--#echo var="VAR_viewer-hdr-colors"--></H1>
33685
33686 Sets the colors Alpine uses for specific header fields in the MESSAGE TEXT screen.
33687 For example, you may set the color of the Subject header or the From header.
33688 The foreground color is the color of the actual character and the
33689 background color is the color of the area behind the character.
33690 <P>
33691 In addition to setting the colors for particular headers (like the Subject)
33692 you may also set a color to be used for all headers unless overridden by a
33693 more specific Viewer Header Color.
33694 To do this use the
33695 <A HREF="h_config_header_general_color">Header General Color</A>.
33696 <P>
33697 For Header Colors,
33698 there is an additional line on the
33699 screen labeled &quot;Pattern to match&quot;.
33700 If you leave that blank, then the whole field for that header will
33701 be colored.
33702 However, if you give a pattern to match, the coloring will only take place
33703 if there is a match for that pattern in the value of the field.
33704 For example, if you are working on a color for the Subject header and
33705 you fill in a pattern of &quot;important&quot;, then only Subjects that
33706 contain the word &quot;important&quot; will be colored.
33707 <P>
33708 If the pattern you enter is a comma-separated list of patterns, then coloring
33709 happens if any of those patterns matches.
33710 <P>
33711 <A HREF="h_color_setup">Descriptions of the available commands</A>
33712 <P>
33713 Look <A HREF="h_edit_nav_cmds">here</A>
33714 to see the available Editing and Navigation commands.
33715 <P>
33716 &lt;End of help on this topic&gt;
33717 </BODY>
33718 </HTML>
33719 ====== h_config_indextoken_color =====
33720 <HTML>
33721 <HEAD>
33722 <TITLE>OPTION: <!--#echo var="VAR_index-token-colors"--></TITLE>
33723 </HEAD>
33724 <BODY>
33725 <H1>OPTION: <!--#echo var="VAR_index-token-colors"--></H1>
33726
33727 This option allows you to set up the color in which any token, not specified by the
33728 previous options, will be colored in the MESSAGE INDEX screen.
33729 <P>
33730 In order to use this option, you must press the &quot;I&quot; <B>IndxHdr</B> command, and add
33731 a token that can be used in the index format.
33732 The list of available tokens is <A HREF="h_index_tokens">here</A>.
33733 <P>
33734 If you fail to enter a valid token your entry will be ignored, and you will be asked to
33735 enter a new one. Once you have entered a valid token, a line will be added to the
33736 configuration screen that you can use to set up the colors in which that token will
33737 be painted. This is done in the same way that you configure colors for other
33738 variables.
33739
33740 <A HREF="h_color_setup">Descriptions of the available commands</A>
33741 <P>
33742 Look <A HREF="h_edit_nav_cmds">here</A>
33743 to see the available Editing and Navigation commands.
33744 <P>
33745 &lt;End of help on this topic&gt;
33746 </BODY>
33747 </HTML>
33748 ====== h_config_customhdr_pattern =====
33749 <HTML>
33750 <HEAD>
33751 <TITLE>OPTION: Viewer Header Color Pattern</TITLE>
33752 </HEAD>
33753 <BODY>
33754 <H1>OPTION: Viewer Header Color Pattern</H1>
33755
33756 If you leave this blank, then the whole field for the header will
33757 be colored.
33758 If you give a pattern to match, the coloring will only take place
33759 if there is a match for that pattern in the value of the field.
33760 For example, if you are working on a color for the Subject header and
33761 you fill in a pattern of &quot;important&quot;, then only Subjects that
33762 contain the word &quot;important&quot; will be colored.
33763 <P>
33764 For address headers (like From and To) and for the Newsgroups header,
33765 a pattern match will cause only the matched addresses or newsgroups to be
33766 colored.
33767 If there is no pattern to match, then all of the addresses or newsgroups
33768 in the relevant header will be colored.
33769 <P>
33770 The matching pattern may be a comma-separated list of patterns to match
33771 instead of a single pattern.
33772 For example, you could use the pattern &quot;important,urgent&quot; which would
33773 cause a match if either the word &quot;important&quot; or the word
33774 &quot;urgent&quot; appeared in the value of the header.
33775 You could list several comma-separated email addresses in the Header
33776 From Color pattern so that those addresses will be colored when any of
33777 them appear in the From header.
33778 <P>
33779 To add a new matching pattern or change the existing pattern use the
33780 <!--chtml if pinemode="function_key"-->
33781 &quot;F4&quot;
33782 <!--chtml else-->
33783 &quot;C&quot;
33784 <!--chtml endif-->
33785 &quot;Change&quot; command that is available when the &quot;Pattern to
33786 match&quot; line is highlighted.
33787 The
33788 <!--chtml if pinemode="function_key"-->
33789 &quot;F10&quot;
33790 <!--chtml else-->
33791 &quot;D&quot;
33792 <!--chtml endif-->
33793 &quot;Delete&quot; command may be used to quickly remove all patterns
33794 for a particular header.
33795 <P>
33796 &lt;End of help on this topic&gt;
33797 </BODY>
33798 </HTML>
33799 ====== h_color_setup =====
33800 <HTML>
33801 <HEAD>
33802 <TITLE>SETUP COLOR COMMANDS</TITLE>
33803 </HEAD>
33804 <BODY>
33805 <H1>SETUP COLOR COMMANDS</H1>
33806 <!--chtml if pinemode="function_key"-->
33807 <PRE>
33808 Available Commands -- Group 1
33809 -------------------------------
33810 F1  Display this help text
33811 F2  Show other available commands
33812 F3  Exit to MAIN MENU
33813 F4  Select the highlighted foreground or background color
33814 F5  Move to previous line
33815 F6  Move to next line
33816 F7  Previous page
33817 F8  Next page
33818 F9  Add a config section for a header field
33819 F10 Restore all default colors (for all sections)
33820 F11 Print color configuration screen
33821 F12 Whereis (search for word)
33822
33823 Available Commands -- Group 2
33824 -------------------------------
33825 F1  Display this help text
33826 F2  Show other available commands
33827 F5  Delete config section for highlighted header field
33828 F6  Shuffle the order of Header Color sections
33829 </PRE>
33830 <!--chtml else-->
33831 <PRE>
33832 General commands
33833 -------------------------------------------------
33834  ?  Display this help text     E  Exit back to MAIN MENU
33835  P  Previous Line              N  Next Line
33836  -  Previous page             Spc (space bar) Next page
33837  W  WhereIs (search for word)  %  Print color configuration screen
33838
33839 Color Setup Commands
33840 ------------------------------------------------
33841  *  Select the highlighted foreground or background color
33842  A  Add a config section for a header field
33843  D  Delete config section for highlighted header field
33844  R  Restore all default colors (for all sections)
33845  $  Shuffle the order of Header Color sections
33846 </PRE>
33847 <!--chtml endif-->
33848
33849 <H2>Description of the Setup Color Screen</H2>
33850
33851 From this screen you may turn on color and set the colors of
33852 various parts of the Alpine display.
33853 For help on turning on color move your cursor into the Color Style section
33854 at the top of the Setup Color screen and ask for help.
33855
33856 <P>
33857 There are several sections in the Setup Color Screen.
33858 At the top are some settings that handle the style of color used
33859 with your terminal emulator (UNIX only), and some settings that
33860 control how the current indexline and the titlebar are colored.
33861 After that comes a long section called GENERAL COLORS that allows
33862 you to set the color of many elements in the Alpine screens.
33863 For example, the color of the titlebar, status messages,
33864 selectable links, quotes and signatures in messages, and so on.
33865 After that is a section called INDEX COLORS that allows you to
33866 set the colors of various pieces of the displayed index lines in
33867 the MESSAGE INDEX screen.
33868 The next section is HEADER COLORS. This is for coloring headers of
33869 messages in the MESSAGE TEXT screen in just about any way you would like.
33870 Finally, the KEYWORD COLORS section allows you to highlight
33871 <A HREF="h_config_keywords"><!--#echo var="VAR_keywords"--></A>
33872 in the MESSAGE INDEX screen.
33873
33874 <P>
33875 To change a color, highlight the color you want to change (for example,
33876 the Status Color) by moving
33877 the cursor into it.
33878 You may want to read the help text for the color to see a brief description
33879 of what you are coloring.
33880 Then press &quot;C&quot; for Change to set the color to something new.
33881 That will put you into a screen with two columns of colors, one for
33882 the foreground color and one for the background color.
33883 The foreground color is just the color you want the actual characters
33884 to be and the background color is the color of the rest of the rectangle
33885 behind the characters.
33886 Select the foreground and background colors desired by using the Next and
33887 Prev keys to highlight the color, and the * command to select it.
33888 <P>
33889 To set a color to its default value, set the X in the Default line at
33890 the bottom of the list of colors.
33891 <P>
33892
33893 The HEADER COLORS section is a little bit different from the others.
33894 Besides coloring the specific fields that Alpine knows about, you may also
33895 color specific header fields when viewing a message in the MESSAGE TEXT
33896 screen.
33897 For example, you may color the Subject header a particular color.
33898 There are a few commands for use with headers.
33899 The &quot;AddHeader&quot; command adds a section to the color
33900 configuration screen that allows you to set the color for that header.
33901 You'll be asked for the name of the header field you want to color.
33902 If you wanted to color the Subject, you would answer
33903 with the word &quot;subject&quot;.
33904 Once you've added a header field, the color setting works just like the
33905 other color fields, except that there is an additional line on the
33906 configuration screen labeled &quot;Pattern to match&quot;.
33907 If you leave that blank, then the whole field for that header will always
33908 be colored.
33909 However, if you give a pattern to match, the coloring will only take place
33910 if there is a match for that pattern in the value of the field.
33911 For example, if you are working on a color for the Subject header and
33912 you fill in a pattern of &quot;important&quot;, then only Subjects that
33913 contain the word &quot;important&quot; will be colored.
33914 <P>
33915 The &quot;DeleteHdr&quot; command removes a header section from the
33916 configuration altogether.
33917 The &quot;Shuffle&quot; command changes the order of header sections.
33918 This is only necessary if you use header sections with pattern fields.
33919 For example, if you have two Subject sections, one with one pattern and
33920 another with another pattern, and the subject for a particular message
33921 happens to match both, then the color from the first match is used.
33922 <P>
33923
33924 The command &quot;RestoreDefs&quot; will restore all of the default colors.
33925 Each section will change to the default value used for that section when
33926 color is first enabled.
33927 When you restore all default colors the color settings for the Header Colors
33928 will be unset (since that's the default), but the header fields you've
33929 added will remain so that you may easily reset them.
33930 In order to get rid of them completely you'd have to use
33931 the &quot;DeleteHdr&quot; command.
33932
33933 <P>
33934 Remember that <A HREF="h_rules_incols">Index Line Colors</A>
33935 may be set with matching rules and that is configured separately from
33936 the rest of the color settings described here.
33937 It is configured in the Setup/Rules/Indexcolors section of the configuration screen
33938 instead of in the Setup/Kolor section.
33939
33940 <P><UL>
33941 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
33942 </UL><P>
33943 &lt;End of help on this topic&gt;
33944 </BODY>
33945 </HTML>
33946 ====== h_config_news_uses_recent ======
33947 <HTML>
33948 <HEAD>
33949 <TITLE>FEATURE: <!--#echo var="FEAT_news-approximates-new-status"--></TITLE>
33950 </HEAD>
33951 <BODY>
33952 <H1>FEATURE: <!--#echo var="FEAT_news-approximates-new-status"--></H1>
33953
33954 This feature causes certain messages to be marked as "New" in the
33955 MESSAGE INDEX of newsgroups.
33956 This feature is set by default.
33957
33958 <P>
33959
33960 When opening a newsgroup, Alpine will consult your "newsrc" file and
33961 determine the last message you have previously disposed of via the "D"
33962 key.  If this feature is set, any subsequent messages will be shown in the
33963 Index with an "N", and the first of these messages will be highlighted.
33964 Although this is only an approximation of true "New" or "Unseen"
33965 status, it provides a useful cue to distinguish more-or-less recent
33966 messages from those you have seen previously, but are not yet ready to
33967 mark deleted.
33968
33969 <P>
33970
33971 Background: your "newsrc" file (used to store message status information
33972 for newsgroups) is only capable of storing a single flag, and Alpine uses
33973 this to record whether or not you are "done with" a message, as
33974 indicated by marking the message as "Deleted".  Unfortunately, this
33975 means that Alpine has no way to record exactly which messages you have
33976 previously seen, so it normally does not show the "N" status flag for
33977 any messages in a newsgroup. This feature enables a starting
33978 *approximation* of seen/unseen status that may be useful.
33979 <P>
33980 &lt;End of help on this topic&gt;
33981 </BODY>
33982 </HTML>
33983 ====== h_config_expose_hidden_config =====
33984 <HTML>
33985 <HEAD>
33986 <TITLE>FEATURE: <!--#echo var="FEAT_expose-hidden-config"--></TITLE>
33987 </HEAD>
33988 <BODY>
33989 <H1>FEATURE: <!--#echo var="FEAT_expose-hidden-config"--></H1>
33990
33991 If set, this causes configuration options and features that are normally
33992 hidden from view to be editable in the Setup/Config screen.
33993
33994 <P>
33995 The purpose of this feature is to allow you to change configuration
33996 features and variables that are normally hidden.
33997 This is particularly useful if you are using a remote configuration,
33998 where it is difficult to edit the contents manually, but it may also be used
33999 on a local pinerc configuration file.
34000 <P>
34001 If set, several configuration variables and features that are normally
34002 hidden from view will show up in the Setup/Configuration screen.
34003 They will be at the bottom of the configuration screen.
34004 You can find them by searching for the words &quot;hidden configuration&quot;.
34005 <P>
34006
34007 Note that this is an advanced feature that should be used with care.
34008 The reason that this part of the configuration is normally hidden is because
34009 there is a significant potential for causing problems if you change these
34010 variables.
34011 If something breaks after a change try changing it back to see if that is
34012 what is causing the problem.
34013 There are also some variables that are normally hidden because they are
34014 manipulated through Alpine in other ways.
34015 For example, colors are normally set using the Setup/Kolors screen and
34016 the &quot;<!--#echo var="VAR_address-book"-->&quot; variable is normally set using
34017 the Setup/AddressBooks screen, so there is little reason to edit these directly.
34018 The &quot;<!--#echo var="VAR_incoming-folders"-->&quot; variable is normally changed by using
34019 the Add, Delete, and Rename commands in the FOLDER LIST screen,
34020 and the &quot;<!--#echo var="VAR_last-time-prune-questioned"-->&quot; variable is normally used
34021 internally by Alpine and not set directly by the user.
34022 <P>
34023 <UL>
34024 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34025 </UL><P>
34026 &lt;End of help on this topic&gt;
34027 </BODY>
34028 </HTML>
34029 ====== h_config_disable_signature_edit =====
34030 <HTML>
34031 <HEAD>
34032 <TITLE>FEATURE: <!--#echo var="FEAT_disable-signature-edit-cmd"--></TITLE>
34033 </HEAD>
34034 <BODY>
34035 <H1>FEATURE: <!--#echo var="FEAT_disable-signature-edit-cmd"--></H1>
34036
34037 If set, this disables the editing of signature files from within
34038 the Setup/Config screen.
34039 <P>
34040 <UL>
34041 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34042 </UL><P>
34043 &lt;End of help on this topic&gt;
34044 </BODY>
34045 </HTML>
34046 ====== h_config_disable_roles_templateedit =====
34047 <HTML>
34048 <HEAD>
34049 <TITLE>FEATURE: <!--#echo var="FEAT_disable-roles-template-edit"--></TITLE>
34050 </HEAD>
34051 <BODY>
34052 <H1>FEATURE: <!--#echo var="FEAT_disable-roles-template-edit"--></H1>
34053
34054 If set, this disables the editing of template files within the
34055 Role setup screen.
34056 <P>
34057 <UL>
34058 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34059 </UL><P>
34060 &lt;End of help on this topic&gt;
34061 </BODY>
34062 </HTML>
34063 ====== h_config_disable_roles_sigedit =====
34064 <HTML>
34065 <HEAD>
34066 <TITLE>FEATURE: <!--#echo var="FEAT_disable-roles-sig-edit"--></TITLE>
34067 </HEAD>
34068 <BODY>
34069 <H1>FEATURE: <!--#echo var="FEAT_disable-roles-sig-edit"--></H1>
34070
34071 If set, this disables the editing of signature files within the
34072 Role setup screen.
34073 <P>
34074 <UL>
34075 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34076 </UL><P>
34077 &lt;End of help on this topic&gt;
34078 </BODY>
34079 </HTML>
34080 ====== h_config_disable_roles_setup =====
34081 <HTML>
34082 <HEAD>
34083 <TITLE>FEATURE: <!--#echo var="FEAT_disable-roles-setup-cmd"--></TITLE>
34084 </HEAD>
34085 <BODY>
34086 <H1>FEATURE: <!--#echo var="FEAT_disable-roles-setup-cmd"--></H1>
34087
34088 If set, this disables the Setup/Rules/Roles command.
34089 <P>
34090 <UL>
34091 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34092 </UL><P>
34093 &lt;End of help on this topic&gt;
34094 </BODY>
34095 </HTML>
34096 ====== h_config_disable_pipes_in_templates =====
34097 <HTML>
34098 <HEAD>
34099 <TITLE>FEATURE: <!--#echo var="FEAT_disable-pipes-in-templates"--></TITLE>
34100 </HEAD>
34101 <BODY>
34102 <H1>FEATURE: <!--#echo var="FEAT_disable-pipes-in-templates"--></H1>
34103
34104 By default, if a template file name is followed by a vertical bar (|) then
34105 that causes the file to be executed to produce the text for the template.
34106 If this feature is set, then this is not allowed.
34107 <P>
34108 <UL>
34109 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34110 </UL><P>
34111 &lt;End of help on this topic&gt;
34112 </BODY>
34113 </HTML>
34114 ====== h_config_disable_pipes_in_sigs =====
34115 <HTML>
34116 <HEAD>
34117 <TITLE>FEATURE: <!--#echo var="FEAT_disable-pipes-in-sigs"--></TITLE>
34118 </HEAD>
34119 <BODY>
34120 <H1>FEATURE: <!--#echo var="FEAT_disable-pipes-in-sigs"--></H1>
34121
34122 By default, if a signature file name is followed by a vertical bar (|) then
34123 that causes the file to be executed to produce the text for the signature.
34124 If this feature is set, then this is not allowed.
34125 <P>
34126 <UL>
34127 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34128 </UL><P>
34129 &lt;End of help on this topic&gt;
34130 </BODY>
34131 </HTML>
34132 ====== h_config_disable_password_cmd =====
34133 <HTML>
34134 <HEAD>
34135 <TITLE>FEATURE: <!--#echo var="FEAT_disable-password-cmd"--></TITLE>
34136 </HEAD>
34137 <BODY>
34138 <H1>FEATURE: <!--#echo var="FEAT_disable-password-cmd"--></H1>
34139
34140 If set, then the Setup/Newpassword command is disabled.
34141 <P>
34142 <UL>
34143 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34144 </UL><P>
34145 &lt;End of help on this topic&gt;
34146 </BODY>
34147 </HTML>
34148 ====== h_config_disable_password_caching =====
34149 <HTML>
34150 <HEAD>
34151 <TITLE>FEATURE: <!--#echo var="FEAT_disable-password-caching"--></TITLE>
34152 </HEAD>
34153 <BODY>
34154 <H1>FEATURE: <!--#echo var="FEAT_disable-password-caching"--></H1>
34155
34156 Normally, loginname/password combinations are cached in Alpine so that
34157 you do not have to enter the same password more than once in a session.
34158 A disadvantage to this approach is that the password must be stored in
34159 the memory image of the running Alpine in order that it can be re-used.
34160 In the event that Alpine crashes and produces a core dump, and that core
34161 dump is readable by others, the loginname and password could be read
34162 from the core dump.
34163 <P>
34164 If this feature is set, then the passwords will not be cached and you
34165 will have to retype the password whenever Alpine needs it.
34166 Even with this feature set there is still some chance that the core
34167 file will contain a password, so care should be taken to make the
34168 core files unreadable.
34169 <P>
34170 NOTE: If PASSFILE caching is enabled, this does not disable it.
34171 That is a separate and independent feature.
34172 <UL>
34173 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34174 </UL><P>
34175 &lt;End of help on this topic&gt;
34176 </BODY>
34177 </HTML>
34178 ====== h_config_disable_password_file_saving =====
34179 <HTML>
34180 <HEAD>
34181 <TITLE>FEATURE: <!--#echo var="FEAT_disable-password-file-saving"--></TITLE>
34182 </HEAD>
34183 <BODY>
34184 <H1>FEATURE: <!--#echo var="FEAT_disable-password-file-saving"--></H1>
34185
34186 <P> This feature disables caching of passwords, even if your version of Alpine allows
34187 saving passwords. For MAC OS users saving passwords is done using the Apple Key Chain, for
34188 Windows users caching passwords is done using the internal Windows Credentials, and for
34189 other users this is done by using the password file. In this feature, the phrase
34190 &quot;password file&quot; is a misnomer and represents the way in which your system
34191 stores passwords.
34192
34193 <P>
34194 Specifically, this feature changes the behavior of Alpine when a login name and password combination
34195 for a specific server is not found in the password file. The default behavior is that
34196 Alpine will ask the user if they wish to save this information in the password file for future
34197 use. It is assumed that if a user created a password file it is because they intend
34198 to use it, but in some instances a user might want to save some passwords and not others.
34199 In this case, enabling this feature will make Alpine not add any more passwords to the
34200 password file and will only use the passwords that it already saved. If you wish to allow
34201 Alpine to save more passwords in the password file, disable this feature.
34202
34203 <P> Regardless of which method Alpine uses to store passwords, this is done in a secure
34204 way when compiled with OpenSSL or LibreSSL. This is very likely to be your version, and
34205 you can check this by reading the encryption features
34206 <A HREF="X-Alpine-Config:">supported</A> by Alpine.
34207
34208 <P>
34209 <UL>
34210 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34211 </UL><P>
34212 &lt;End of help on this topic&gt;
34213 </BODY>
34214 </HTML>
34215 ====== h_config_disable_kb_lock =====
34216 <HTML>
34217 <HEAD>
34218 <TITLE>FEATURE: <!--#echo var="FEAT_disable-keyboard-lock-cmd"--></TITLE>
34219 </HEAD>
34220 <BODY>
34221 <H1>FEATURE: <!--#echo var="FEAT_disable-keyboard-lock-cmd"--></H1>
34222
34223 If set, then the Keyboard Lock command is removed from the MAIN MENU.
34224 <P>
34225 <UL>
34226 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34227 </UL><P>
34228 &lt;End of help on this topic&gt;
34229 </BODY>
34230 </HTML>
34231 ====== h_config_disable_config_cmd =====
34232 <HTML>
34233 <HEAD>
34234 <TITLE>FEATURE: <!--#echo var="FEAT_disable-config-cmd"--></TITLE>
34235 </HEAD>
34236 <BODY>
34237 <H1>FEATURE: <!--#echo var="FEAT_disable-config-cmd"--></H1>
34238
34239 If set, then the Setup/Config screen is disabled.
34240 <P>
34241 <UL>
34242 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34243 </UL><P>
34244 &lt;End of help on this topic&gt;
34245 </BODY>
34246 </HTML>
34247 ====== h_config_allow_chg_from =====
34248 <HTML>
34249 <HEAD>
34250 <TITLE>FEATURE: <!--#echo var="FEAT_allow-changing-from"--></TITLE>
34251 </HEAD>
34252 <BODY>
34253 <H1>FEATURE: <!--#echo var="FEAT_allow-changing-from"--></H1>
34254
34255 This feature affects Alpine's handling of the &quot;From:&quot; header field
34256 in the "<A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A>" configuration
34257 option.
34258 <P>
34259 If this feature is set then the From line can be changed just like
34260 all the other header fields that can be changed.
34261 This feature defaults to <EM>ON</EM>.
34262 <P>
34263 Even with this feature turned ON (the default) you will not be able
34264 to change the From header unless you add it to your list of
34265 <A HREF="h_config_custom_hdrs"><!--#echo var="VAR_customized-hdrs"--></A>.
34266 You may also want to change the
34267 <A HREF="h_config_comp_hdrs"><!--#echo var="VAR_default-composer-hdrs"--></A>
34268 if you want the From header to always show up in the composer without
34269 having to type the Rich Headers command first.
34270 <P>
34271 Note that many sites restrict the use of this feature in order to
34272 reduce the chance of falsified addresses and misdirected mail.
34273 If you want to change the value of what gets included in the From header
34274 in messages you send
34275 look <A HREF="h_config_change_your_from">here</A> for a description.
34276 <P>
34277 <UL>
34278 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34279 </UL><P>
34280 &lt;End of help on this topic&gt;
34281 </BODY>
34282 </HTML>
34283 ====== h_config_disable_collate =====
34284 <HTML>
34285 <HEAD>
34286 <TITLE>FEATURE: <!--#echo var="FEAT_disable-setlocale-collate"--></TITLE>
34287 </HEAD>
34288 <BODY>
34289 <H1>FEATURE: <!--#echo var="FEAT_disable-setlocale-collate"--></H1>
34290
34291 This is a hard to understand feature that should only be used in rare cases.
34292 Normally, the C function call
34293 <P>
34294 <CENTER><SAMP>setlocale(LC_COLLATE, &quot;&quot;)</SAMP></CENTER>
34295 <P>
34296 is used by Alpine.
34297 If you want to try turning it off,
34298 setting this feature will turn it off.
34299 This part of the locale has to do with the sort order
34300 of characters in your locale.
34301 <P>
34302 <UL>
34303 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34304 </UL><P>
34305 &lt;End of help on this topic&gt;
34306 </BODY>
34307 </HTML>
34308 ====== h_config_quell_attach_extra_prompt =====
34309 <HTML>
34310 <HEAD>
34311 <TITLE>FEATURE: <!--#echo var="FEAT_quell-attachment-extra-prompt"--></TITLE>
34312 </HEAD>
34313 <BODY>
34314 <H1>FEATURE: <!--#echo var="FEAT_quell-attachment-extra-prompt"--></H1>
34315
34316 By default, when you attempt to view an attachment externally
34317 from the &quot;Attachment View&quot; screen, you are asked if you
34318 really want to view the selected attachment.
34319
34320 <P>
34321 If this feature is set, you will <B>not</B> be prompted to confirm
34322 your selection.  Prior to Alpine and to Pine 4.50, the default behavior was to not
34323 prompt. This feature was added for those wanting to preserve that
34324 behavior (along with
34325 <A HREF="h_config_quell_attach_ext_warn"><!--#echo var="FEAT_quell-attachment-extension-warn"--></A>).
34326
34327 <P>
34328 <UL>
34329 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34330 </UL><P>
34331 &lt;End of help on this topic&gt;
34332 </BODY>
34333 </HTML>
34334 ====== h_config_quell_attach_ext_warn =====
34335 <HTML>
34336 <HEAD>
34337 <TITLE>FEATURE: <!--#echo var="FEAT_quell-attachment-extension-warn"--></TITLE>
34338 </HEAD>
34339 <BODY>
34340 <H1>FEATURE: <!--#echo var="FEAT_quell-attachment-extension-warn"--></H1>
34341
34342 <P>
34343 This feature suppresses the extra warning you can get when trying
34344 to view an attachment for which there is no mime-type match.  Turning
34345 on this feature will just run the program according to extension
34346 instead of first warning the user that it will run according to the
34347 file's extension.
34348 <P>
34349 This feature can be used along side
34350 <A HREF="h_config_quell_attach_extra_prompt"><!--#echo var="FEAT_quell-attachment-extra-prompt"--></A>
34351 to preserve the behavior exhibited in Pine versions prior to Pine 4.50.
34352 <P>
34353 <UL>
34354 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34355 </UL><P>
34356 &lt;End of help on this topic&gt;
34357 </BODY>
34358 </HTML>
34359 ====== h_config_mailcap_params =====
34360 <HTML>
34361 <HEAD>
34362 <TITLE>FEATURE: <!--#echo var="FEAT_enable-mailcap-param-substitution"--></TITLE>
34363 </HEAD>
34364 <BODY>
34365 <H1>FEATURE: <!--#echo var="FEAT_enable-mailcap-param-substitution"--></H1>
34366
34367 If set, this will allow mailcap named parameter substitution to occur
34368 in mailcap entries.
34369 By default, this is turned off to prevent security problems that may occur
34370 with some incorrect mailcap configurations.
34371 For more information, see RFC1524 and look for "named parameters" in the
34372 text of the RFC.
34373 <P>
34374 <UL>
34375 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34376 </UL><P>
34377 &lt;End of help on this topic&gt;
34378 </BODY>
34379 </HTML>
34380 ====== h_config_disable_shared =====
34381 <HTML>
34382 <HEAD>
34383 <TITLE>FEATURE: <!--#echo var="FEAT_disable-shared-namespaces"--></TITLE>
34384 </HEAD>
34385 <BODY>
34386 <H1>FEATURE: <!--#echo var="FEAT_disable-shared-namespaces"--></H1>
34387
34388 If this feature is set, the automatic search for namespaces &quot;ftp&quot;,
34389 &quot;imapshared&quot;, and &quot;imappublic&quot; by the underlying library
34390 will be disabled.
34391 The reason this feature exists is because there are some implementations
34392 of system password lookup routines that are very slow when presented with
34393 a long loginname that does not exist.
34394 This feature could be set to prevent the delay at startup time when the
34395 names above are searched for in the password file.
34396 <P>
34397 <UL>
34398 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34399 </UL><P>
34400 &lt;End of help on this topic&gt;
34401 </BODY>
34402 </HTML>
34403 ====== h_config_hide_nntp_path =====
34404 <HTML>
34405 <HEAD>
34406 <TITLE>FEATURE: <!--#echo var="FEAT_hide-nntp-path"--></TITLE>
34407 </HEAD>
34408 <BODY>
34409 <H1>FEATURE: <!--#echo var="FEAT_hide-nntp-path"--></H1>
34410
34411 Normally the Path header that Alpine generates when posting to a newsgroup
34412 contains the name of the computer from which the message is being sent and
34413 the user name.
34414 Some believe that this information is used by spammers.
34415 If this feature is set, that information will be replaced with the text
34416 <P>
34417 <CENTER><SAMP>not-for-mail</SAMP></CENTER>
34418 <P>
34419 instead.
34420 <P>
34421 It should be noted that many servers being connected to will still reveal
34422 the information that this feature attempts to protect.
34423 <P>
34424 <UL>
34425 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34426 </UL><P>
34427 &lt;End of help on this topic&gt;
34428 </BODY>
34429 </HTML>
34430 ====== h_config_no_bezerk_zone =====
34431 <HTML>
34432 <HEAD>
34433 <TITLE>FEATURE: <!--#echo var="FEAT_quell-berkeley-format-timezone"--></TITLE>
34434 </HEAD>
34435 <BODY>
34436 <H1>FEATURE: <!--#echo var="FEAT_quell-berkeley-format-timezone"--></H1>
34437
34438 POSIX mandates a timezone in UNIX mailbox format folder delimiters
34439 (the line that begins with From <SPACE>).
34440 Some versions of Berkeley mail have trouble with this, and don't recognize
34441 the line as a message delimiter.
34442 If this feature is set, the timezone will be left off the delimiter line.
34443 <P>
34444 <UL>
34445 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34446 </UL><P>
34447 &lt;End of help on this topic&gt;
34448 </BODY>
34449 </HTML>
34450 ====== h_config_quell_domain_warn =====
34451 <HTML>
34452 <HEAD>
34453 <TITLE>FEATURE: <!--#echo var="FEAT_quell-maildomain-warning"--></TITLE>
34454 </HEAD>
34455 <BODY>
34456 <H1>FEATURE: <!--#echo var="FEAT_quell-maildomain-warning"--></H1>
34457
34458 When your configuration is set up so that your domain name contains no dots,
34459 it is usually a configuration error.
34460 By default, Alpine will warn you about this when you start it up.
34461 You will see a warning message that looks like
34462
34463 <P>
34464 <CENTER><SAMP>Incomplete maildomain &quot;&lt;domain&gt;&quot;.</SAMP></CENTER>
34465
34466 <P>
34467 If this feature is set, the warning is turned off.
34468 <P>
34469 <UL>
34470 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34471 </UL><P>
34472 &lt;End of help on this topic&gt;
34473 </BODY>
34474 </HTML>
34475 ====== h_config_quell_imap_env =====
34476 <HTML>
34477 <HEAD>
34478 <TITLE>FEATURE: <!--#echo var="FEAT_quell-imap-envelope-update"--></TITLE>
34479 </HEAD>
34480 <BODY>
34481 <H1>FEATURE: <!--#echo var="FEAT_quell-imap-envelope-update"--></H1>
34482
34483 In the MESSAGE INDEX screen, if the open folder is being accessed
34484 using IMAP, Alpine normally tries to paint the index lines on the screen
34485 as soon as the information arrives from the IMAP server.
34486 This means that the index information makes it onto the screen more quickly
34487 than it otherwise would.
34488 This sometimes results in behavior that bothers some users.
34489 For example, when paging to a new page of the index, it may be possible for
34490 the lines to be painted on the screen in a random order, rather than from
34491 top to bottom.
34492 <P>
34493
34494 Setting this feature causes Alpine to wait for all of the information
34495 to be gathered before it paints the index screen.
34496 Once it collects all of the information, the screen will be painted quickly
34497 from top to bottom.
34498 <P>
34499 <UL>
34500 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34501 </UL><P>
34502 &lt;End of help on this topic&gt;
34503 </BODY>
34504 </HTML>
34505 ====== h_config_quell_news_env =====
34506 <HTML>
34507 <HEAD>
34508 <TITLE>FEATURE: <!--#echo var="FEAT_quell-news-envelope-update"--></TITLE>
34509 </HEAD>
34510 <BODY>
34511 <H1>FEATURE: <!--#echo var="FEAT_quell-news-envelope-update"--></H1>
34512
34513 In the MESSAGE INDEX screen, if the open folder is being accessed
34514 using NNTP (News), Alpine normally tries to paint the index lines on the screen
34515 as soon as the information arrives from the NNTP server.
34516 This means that the index information makes it onto the screen more quickly
34517 than it otherwise would.
34518 This sometimes results in behavior that bothers some users.
34519 For example, when paging to a new page of the index, it may be possible for
34520 the lines to be painted on the screen in a random order, rather than from
34521 top to bottom.
34522 <P>
34523
34524 Setting this feature causes Alpine to wait for all of the information
34525 to be gathered before it paints the index screen.
34526 Once it collects all of the information, the screen will be painted quickly
34527 from top to bottom.
34528 <P>
34529 <UL>
34530 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34531 </UL><P>
34532 &lt;End of help on this topic&gt;
34533 </BODY>
34534 </HTML>
34535 ====== h_config_quell_content_id =====
34536 <HTML>
34537 <HEAD>
34538 <TITLE>FEATURE: <!--#echo var="FEAT_quell-content-id"--></TITLE>
34539 </HEAD>
34540 <BODY>
34541 <H1>FEATURE: <!--#echo var="FEAT_quell-content-id"--></H1>
34542
34543 This feature changes the behavior of Alpine when sending messages.
34544 It is intended to work around a bug in Microsoft's Outlook XP mail user
34545 agent.
34546 As of this writing, Microsoft has acknowledged the bug but
34547 has not added it to the Knowledge Base.
34548 We have been told that there will be a post-SP1 hotfix for Outlook XP.
34549 This particular bug has bug fix number OfficeQFE:4781.
34550 The nature of the bug is that messages with attachments that
34551 contain a Content-ID header (which standard Alpine attachments do)
34552 do not show the attachment indicator (a paperclip) when viewed with
34553 Outlook XP.
34554 So the user has no indication that the message contains an attachment.
34555
34556 <P>
34557 If this feature is set then Alpine will remove most Content-ID headers
34558 before sending a message.
34559 If an attachment is of type MESSAGE, then the existing Content-ID headers
34560 inside the message will be left intact.
34561 This would only happen with Alpine if a message was forwarded as an attachment
34562 or if a message with a message attached was forwarded.
34563 Similarly if an attachment of type MULTIPART/ALTERNATIVE is forwarded,
34564 the Content-ID headers of the alternative parts will not be removed.
34565
34566 <P>
34567 Because the Content-ID header is a standard part of MIME it is possible
34568 that setting this feature will break something.
34569 For example, if an attachment has a Content-ID header that is necessary
34570 for the correct functioning of that attachment, it is possible that Alpine
34571 may remove that header when the attachment is forwarded.
34572 However, it seems fairly safe at this time.
34573
34574 <P>
34575 <UL>
34576 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34577 </UL><P>
34578 &lt;End of help on this topic&gt;
34579 </BODY>
34580 </HTML>
34581 ====== h_config_winpos_in_config =====
34582 <HTML>
34583 <HEAD>
34584 <TITLE>FEATURE: <!--#echo var="FEAT_store-window-position-in-config"--></TITLE>
34585 </HEAD>
34586 <BODY>
34587 <H1>FEATURE: <!--#echo var="FEAT_store-window-position-in-config"--></H1>
34588
34589 PC-Alpine only.
34590 <P>
34591
34592 Normally, PC-Alpine will store its window size and position in the
34593 Windows Registry.
34594 This is convenient if you want to use the same remote
34595 configuration from more than one PC.
34596 If you use multiple configuration files to start PC-Alpine, you may want
34597 to store the window size and position in the configuration file instead
34598 of in the Registry.
34599 Setting this feature causes the value to be stored in
34600 <A HREF="h_config_window_position">Window-Position</A>.
34601
34602 <P>
34603 <UL>
34604 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34605 </UL><P>
34606 &lt;End of help on this topic&gt;
34607 </BODY>
34608 </HTML>
34609 ====== h_config_quell_ssl_largeblocks =====
34610 <HTML>
34611 <HEAD>
34612 <TITLE>FEATURE: <!--#echo var="FEAT_quell-ssl-largeblocks"--></TITLE>
34613 </HEAD>
34614 <BODY>
34615 <H1>FEATURE: <!--#echo var="FEAT_quell-ssl-largeblocks"--></H1>
34616
34617 PC-Alpine only.
34618 <P>
34619 This feature changes the behavior of fetching messages
34620 and attachments so that the message data is fetched in chunks no larger
34621 than 12K bytes.
34622 This works around a bug in Microsoft's SSL/TLS support.
34623 Some versions of Microsoft SSL are not able to read full-sized (16K)
34624 SSL/TLS packets.
34625 Some servers will send such packets and this will
34626 cause PC-Alpine to crash with the error
34627
34628 <P>
34629 <CENTER><SAMP>incomplete SecBuffer exceeds maximum buffer size</SAMP></CENTER>
34630
34631 <P>
34632 Microsoft is aware of the problem and has developed a hotfix for it, it is
34633 discussed in article 300562 in the Microsoft Knowledge Base.
34634 <P>
34635 <UL>
34636 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34637 </UL><P>
34638 &lt;End of help on this topic&gt;
34639 </BODY>
34640 </HTML>
34641 ====== h_config_quell_partial =====
34642 <HTML>
34643 <HEAD>
34644 <TITLE>FEATURE: <!--#echo var="FEAT_quell-partial-fetching"--></TITLE>
34645 </HEAD>
34646 <BODY>
34647 <H1>FEATURE: <!--#echo var="FEAT_quell-partial-fetching"--></H1>
34648
34649 Partial fetching is a feature of the IMAP protocol.
34650 By default, Alpine
34651 will use partial fetching when copying the contents of a message or attachment
34652 from the IMAP server to Alpine.
34653 This means that the fetch will be done in many
34654 small chunks instead of one big chunk. The main benefit of this approach is
34655 that the fetch becomes interruptible. That is, the user can type <EM>^C</EM>
34656 to stop the fetch early. In some cases partial fetching may cause a performance
34657 problem so that the fetching of data takes significantly longer when partial
34658 fetching is used. Turning on this feature will turn off partial fetching.
34659 <P>
34660 <UL>
34661 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34662 </UL><P>
34663 &lt;End of help on this topic&gt;
34664 </BODY>
34665 </HTML>
34666 ====== h_config_quell_personal_name_prompt =====
34667 <HTML>
34668 <HEAD>
34669 <TITLE>FEATURE: <!--#echo var="FEAT_quell-personal-name-prompt"--></TITLE>
34670 </HEAD>
34671 <BODY>
34672 <H1>FEATURE: <!--#echo var="FEAT_quell-personal-name-prompt"--></H1>
34673
34674 PC-Alpine only.  This feature quells the prompting for a
34675 <A HREF="h_config_pers_name">personal name</A>.  This
34676 prompt normally happens before composing a message, and only happens when
34677 there is no personal name already set.
34678 <P>
34679 <UL>
34680 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34681 </UL><P>
34682 &lt;End of help on this topic&gt;
34683 </BODY>
34684 </HTML>
34685 ====== h_config_quell_user_id_prompt =====
34686 <HTML>
34687 <HEAD>
34688 <TITLE>FEATURE: <!--#echo var="FEAT_quell-user-id-prompt"--></TITLE>
34689 </HEAD>
34690 <BODY>
34691 <H1>FEATURE: <!--#echo var="FEAT_quell-user-id-prompt"--></H1>
34692
34693 PC-Alpine only.  This feature quells the prompting for a
34694 <A HREF="h_config_user_id"><!--#echo var="VAR_user-id"--></A>
34695 if the information can be obtained from the login name used
34696 to open the INBOX.  Normally, this prompt happens before composing
34697 a message, and only happens when there is no user-id already set
34698 in the configuration.
34699 <P>
34700 With this feature set, composing a message is only possible after
34701 establishing a connection to the INBOX.
34702 <P>
34703 <UL>
34704 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34705 </UL><P>
34706 &lt;End of help on this topic&gt;
34707 </BODY>
34708 </HTML>
34709 ====== h_config_save_aggregates =====
34710 <HTML>
34711 <HEAD>
34712 <TITLE>FEATURE: <!--#echo var="FEAT_save-aggregates-copy-sequence"--></TITLE>
34713 </HEAD>
34714 <BODY>
34715 <H1>FEATURE: <!--#echo var="FEAT_save-aggregates-copy-sequence"--></H1>
34716
34717 This feature will optimize an aggregate copy operation, if
34718 possible, by issuing a single IMAP <EM>COPY</EM> command with a
34719 list of the messages to be copied.
34720 This feature is set by default.
34721 This may reduce network traffic and elapsed time for the Save.
34722 <EM>However, many IMAP servers (including the UW IMAP server) do
34723 not preserve the order of messages when this optimization is applied.</EM>
34724 If this feature is not set,
34725 Alpine will copy each message individually and the order of the messages
34726 will be preserved.
34727 <P>
34728 <UL>
34729 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34730 </UL><P>
34731 &lt;End of help on this topic&gt;
34732 </BODY>
34733 </HTML>
34734 ====== h_config_use_system_translation =====
34735 <HTML>
34736 <HEAD>
34737 <TITLE>FEATURE: Use System Translation</TITLE>
34738 </HEAD>
34739 <BODY>
34740 <H1>FEATURE: Use System Translation</H1>
34741
34742 UNIX Alpine only.
34743 <P>
34744 Alpine normally uses its own internal software to convert between the multi-byte
34745 representation of characters and the Unicode representation of those
34746 same characters.
34747 It converts from the multi-byte characters your keyboard produces to Unicode,
34748 and from Unicode to the multi-byte characters your display expects.
34749 Alpine also uses its own internal software to decide how much space on
34750 the screen a particular Unicode character will occupy.
34751
34752 <P>
34753 Setting this feature tells Alpine to use the system-supplied routines to
34754 perform these tasks instead.
34755 In particular there are three tasks and three system routines that will
34756 be used for these tasks.
34757
34758 <P>
34759 To convert from multi-byte to Unicode the routine
34760
34761 <P>
34762 <CENTER><SAMP>mbstowcs</SAMP></CENTER>
34763 <P>
34764
34765 is used.
34766 To convert from Unicode to multi-byte the routine
34767
34768 <P>
34769 <CENTER><SAMP>wcrtomb</SAMP></CENTER>
34770 <P>
34771
34772 is used.
34773 And to find the screen width a particular Unicode character will
34774 occupy the routine used is
34775
34776 <P>
34777 <CENTER><SAMP>wcwidth</SAMP></CENTER>
34778 <P>
34779
34780 This feature has been only lightly tested.
34781 The internal routines should normally be used unless you run into
34782 a problem that you think may be solved by using the system routines.
34783 Note that your environment needs to be set up for these
34784 routines to work correctly.
34785 In particular, the LANG or LC_CTYPE variable in your environment will
34786 need to be set.
34787
34788 <P>
34789 <UL>
34790 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34791 </UL><P>
34792 &lt;End of help on this topic&gt;
34793 </BODY>
34794 </HTML>
34795 ====== h_config_suspend_spawns =====
34796 <HTML>
34797 <HEAD>
34798 <TITLE>FEATURE: <!--#echo var="FEAT_use-subshell-for-suspend"--></TITLE>
34799 </HEAD>
34800 <BODY>
34801 <H1>FEATURE: <!--#echo var="FEAT_use-subshell-for-suspend"--></H1>
34802
34803 This feature affects Alpine's behavior when process suspension is enabled
34804 and then activated via the Ctrl-Z key.  Alpine suspension allows one to
34805 temporarily interact with the operating system command &quot;shell&quot;
34806 without
34807 quitting Alpine, and then subsequently resume the still-active Alpine session.
34808 <P>
34809
34810 When the <A HREF="h_config_can_suspend">&quot;<!--#echo var="FEAT_enable-suspend"-->&quot;</A> feature
34811 is set and subsequently the Ctrl-Z key
34812 is pressed, Alpine will normally suspend itself and return temporary control
34813 to Alpine's parent shell process.  However, if this feature is set, Alpine
34814 will instead create an inferior subshell process.  This is useful when the
34815 parent process is not intended to be used interactively.  Examples include
34816 invoking Alpine via the -e argument of the Unix &quot;xterm&quot; program,
34817 or via a menu system.<P>
34818
34819 Note that one typically resumes a suspended Alpine by entering the Unix
34820 &quot;fg&quot; command, but if this feature is set, it will be necessary to
34821 enter the &quot;exit&quot; command instead.
34822 <P>
34823 <UL>
34824 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34825 </UL><P>
34826 &lt;End of help on this topic&gt;
34827 </BODY>
34828 </HTML>
34829 ====== h_config_8bit_smtp =====
34830 <HTML>
34831 <HEAD>
34832 <TITLE>FEATURE: <!--#echo var="FEAT_enable-8bit-esmtp-negotiation"--></TITLE>
34833 </HEAD>
34834 <BODY>
34835 <H1>FEATURE: <!--#echo var="FEAT_enable-8bit-esmtp-negotiation"--></H1>
34836
34837 This feature affects Alpine's behavior when sending mail.
34838 By default, this feature is set.
34839 Internet standards
34840 require that all electronic mail messages traversing the global Internet
34841 consist of 7bit ASCII characters unless a pair of cooperating mail
34842 transfer agents explicitly agree to allow 8bit messages.  In general,
34843 then, exchanging messages in non-ASCII characters requires MIME encoding.
34844 <P>
34845 However, there are now Internet standards that allow for unencoded 8bit
34846 exchange of messages between cooperating systems.  When this feature is set
34847 Alpine will try to negotiate unencoded 8bit transmission during the
34848 sending process.  Should the negotiation fail, Alpine will fall back to its
34849 ordinary encoding rules.
34850 <P>
34851 Note, this feature relies on your system's mail transport agent or
34852 configured <A HREF="h_config_smtp_server">&quot;<!--#echo var="VAR_smtp-server"-->&quot;</A>
34853 having the negotiation mechanism introduced in
34854 &quot;Extended SMTP&quot; (ESMTP) and the specific extension called
34855 &quot;8BITMIME&quot;.
34856 <P>
34857 ESMTP allows for graceful migration to upgraded mail transfer agents, but
34858 it is possible that this feature might cause problems for some servers.
34859 <P><UL>
34860 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34861 </UL>
34862 <P>&lt;End of help on this topic&gt;
34863 </BODY>
34864 </HTML>
34865 ====== h_config_8bit_nntp =====
34866 <HTML>
34867 <HEAD>
34868 <TITLE>FEATURE: <!--#echo var="FEAT_enable-8bit-nntp-posting"--></TITLE>
34869 </HEAD>
34870 <BODY>
34871 <H1>FEATURE: <!--#echo var="FEAT_enable-8bit-nntp-posting"--></H1>
34872
34873 This feature affects Alpine's behavior when posting news.
34874
34875 <P>
34876
34877 The Internet standard for exchanging USENET news messages (RFC-1036)
34878 specifies that USENET messages should conform to Internet mail standards
34879 and contain only 7bit characters, but much of the news transport software
34880 in use today is capable of successfully sending messages containing 8bit
34881 characters.  Hence, many people believe that it is appropriate to send 8bit
34882 news messages without any MIME encoding.
34883
34884 <P>
34885
34886 Moreover, there is no Internet standard for explicitly negotiating 8bit
34887 transfer, as there is for Internet email.  Therefore, Alpine provides the
34888 option of posting unencoded 8bit news messages, though not as the default.
34889 Setting this feature will turn OFF Alpine's MIME encoding of newsgroup
34890 postings that contain 8bit characters.
34891
34892 <P>
34893
34894 Note, articles may cross a path or pass through news transport software
34895 that is unsafe or even hostile to 8bit characters.  At best this will only
34896 cause the posting to become garbled.  The safest way to transmit 8bit
34897 characters is to leave Alpine's MIME encoding turned on, but recipients
34898 who lack MIME-aware tools are often annoyed when they receive MIME-encoded
34899 messages.
34900 <P>
34901 &lt;End of help on this topic&gt;
34902 </BODY>
34903 </HTML>
34904 ====== h_config_mark_for_cc =====
34905 <HTML>
34906 <HEAD>
34907 <TITLE>FEATURE: <!--#echo var="FEAT_mark-for-cc"--></TITLE>
34908 </HEAD>
34909 <BODY>
34910 <H1>FEATURE: <!--#echo var="FEAT_mark-for-cc"--></H1>
34911
34912 This feature affects Alpine's MESSAGE INDEX display.
34913 By default, a '+' is displayed in the first column if the
34914 message is addressed directly to you.
34915 When this feature is set and the message is not addressed to you, then a
34916 '-' character is displayed if the message is instead Cc'd directly
34917 to you.
34918
34919 <P>
34920 <UL>
34921 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
34922 </UL><P>
34923 &lt;End of help on this topic&gt;
34924 </BODY>
34925 </HTML>
34926 ====== h_config_tab_uses_unseen =====
34927 <HTML>
34928 <HEAD>
34929 <TITLE>FEATURE: <!--#echo var="FEAT_tab-uses-unseen-for-next-folder"--></TITLE>
34930 </HEAD>
34931 <BODY>
34932 <H1>FEATURE: <!--#echo var="FEAT_tab-uses-unseen-for-next-folder"--></H1>
34933
34934 This feature affects Alpine's behavior when using the TAB
34935 <A HREF="h_common_nextnew">NextNew Command</A>
34936 to move from one folder to the next.
34937 Alpine's usual behavior is to search for folders
34938 with <EM>Recent</EM> messages in them.
34939 Recent messages are messages that have arrived since the last time the
34940 folder was opened.
34941
34942 <P>
34943 Setting this feature causes Alpine to search for <EM>Unseen</EM>
34944 messages instead of Recent messages.
34945 Unseen messages remain Unseen until you view them (or flag then as Seen with
34946 the <A HREF="h_common_flag">Flag Command</A>).
34947 Setting this feature allows you to locate messages you have not read
34948 instead of only recently received messages.
34949 When this feature is set, the feature
34950 <A HREF="h_config_fast_recent">&quot;<!--#echo var="FEAT_enable-fast-recent-test"-->&quot;</A>
34951 will have no effect, so the checking may be slower.
34952
34953 <P>
34954 Another reason why you might want to use this feature is that Alpine sometimes
34955 opens folders implicitly behind the scenes, and this clears the
34956 Recent status of all messages in the folder.
34957 One example where this happens is when Saving or filtering a
34958 message to another folder.
34959 If that message has some <A HREF="h_config_keywords">keywords</A>
34960 set, then because of some shortcomings
34961 in the IMAP specification, the best way to ensure that those keywords are
34962 still set in the saved copy of the message is to open the folder and
34963 set the keywords explicitly.
34964 Because this clears the Recent status of all messages in that folder the
34965 folder will not be found by the NextNew command unless this feature is set.
34966
34967 <P>
34968 &lt;End of help on this topic&gt;
34969 </BODY>
34970 </HTML>
34971 ====== h_config_tab_new_only =====
34972 <HTML>
34973 <HEAD>
34974 <TITLE>FEATURE: <!--#echo var="FEAT_tab-visits-next-new-message-only"--></TITLE>
34975 </HEAD>
34976 <BODY>
34977 <H1>FEATURE: <!--#echo var="FEAT_tab-visits-next-new-message-only"--></H1>
34978
34979 This feature affects Alpine's behavior when using the TAB key to move from
34980 one message to the next.  Alpine's usual behavior is to select the next
34981 unread message or message flagged as "Important".
34982
34983 <P>
34984
34985 Setting this feature causes Alpine to skip the messages flagged as important,
34986 and select unread messages exclusively.  Tab behavior when there are no
34987 new messages left to select remains unchanged.
34988 <P>
34989 &lt;End of help on this topic&gt;
34990 </BODY>
34991 </HTML>
34992 ====== h_config_warn_if_subj_blank =====
34993 <HTML>
34994 <HEAD>
34995 <TITLE>FEATURE: <!--#echo var="FEAT_warn-if-blank-subject"--></TITLE>
34996 </HEAD>
34997 <BODY>
34998 <H1>FEATURE: <!--#echo var="FEAT_warn-if-blank-subject"--></H1>
34999
35000 This feature affects Alpine's behavior when you send a message being
35001 composed.
35002 If this option is set, Alpine will check to see if the message about to be sent
35003 has a subject or not.
35004 If not, you will be asked if you want to send the message anyway.
35005 <P>
35006
35007 <UL>
35008 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35009 </UL><P>
35010 &lt;End of help on this topic&gt;
35011 </BODY>
35012 </HTML>
35013 ====== h_config_warn_if_fcc_blank =====
35014 <HTML>
35015 <HEAD>
35016 <TITLE>FEATURE: <!--#echo var="FEAT_warn-if-blank-fcc"--></TITLE>
35017 </HEAD>
35018 <BODY>
35019 <H1>FEATURE: <!--#echo var="FEAT_warn-if-blank-fcc"--></H1>
35020
35021 This feature affects Alpine's behavior when you send a message being
35022 composed.
35023 If this option is set, Alpine will check to see if the message about to be sent
35024 has an Fcc or not.
35025 If not, you will be asked if you want to send the message anyway.
35026 <P>
35027
35028 <UL>
35029 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35030 </UL><P>
35031 &lt;End of help on this topic&gt;
35032 </BODY>
35033 </HTML>
35034 ====== h_config_warn_if_no_to_or_cc =====
35035 <HTML>
35036 <HEAD>
35037 <TITLE>FEATURE: <!--#echo var="FEAT_warn-if-blank-to-and-cc-and-newsgroups"--></TITLE>
35038 </HEAD>
35039 <BODY>
35040 <H1>FEATURE: <!--#echo var="FEAT_warn-if-blank-to-and-cc-and-newsgroups"--></H1>
35041
35042 This feature affects Alpine's behavior when you send a message being
35043 composed.
35044 If this option is set, Alpine will check to see if the message about to be sent
35045 has either a To address, a Cc address, or a Newsgroup.
35046 If none of these is set,
35047 you will be asked if you want to send the message anyway.
35048 <P>
35049
35050 This feature is closely related to
35051 <A HREF="h_config_auto_fcc_only"><!--#echo var="FEAT_fcc-only-without-confirm"--></A>.
35052 Alpine will normally ask if you want to copy a message only to the Fcc.
35053 This feature also applies to cases where there is a Bcc but still no To, Cc,
35054 or Newsgroup.
35055 If the <!--#echo var="FEAT_fcc-only-without-confirm"--> feature is set and you are sending a
35056 message with only an Fcc, then you won't be asked about sending with
35057 a blank To and Cc and Newsgroups header even if this feature is set.
35058 Similarly, if you have already been asked if you want to send to the Fcc
35059 only and you have answered Yes, then you won't be asked again about sending with
35060 blank To, Cc, and Newsgroups headers even if this feature is set.
35061 <P>
35062
35063 <UL>
35064 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35065 </UL><P>
35066 &lt;End of help on this topic&gt;
35067 </BODY>
35068 </HTML>
35069 ====== h_config_quell_dead_letter =====
35070 <HTML>
35071 <HEAD>
35072 <TITLE>FEATURE: <!--#echo var="FEAT_quell-dead-letter-on-cancel"--></TITLE>
35073 </HEAD>
35074 <BODY>
35075 <H1>FEATURE: <!--#echo var="FEAT_quell-dead-letter-on-cancel"--></H1>
35076
35077 This feature affects Alpine's behavior when you cancel a message being
35078 composed.  Alpine's usual behavior is to write the canceled message to
35079 a file named
35080 <!--chtml if pinemode="os_windows"-->
35081 &quot;DEADLETR&quot;,
35082 <!--chtml else-->
35083 &quot;dead.letter&quot; in your home directory,
35084 <!--chtml endif-->
35085 overwriting any previous message. Under
35086 some conditions (some routine), this can introduce a noticeable delay.
35087 Setting this feature will cause Alpine NOT to write canceled compositions
35088 into the file.
35089 <P>
35090 NOTE: Enabling this feature means NO record of canceled messages is
35091 maintained.
35092 <P>
35093 This feature affects the newer option
35094 <A HREF="h_config_deadlets"><!--#echo var="VAR_dead-letter-files"--></A>, which specifies the
35095 number of dead letter files to keep around.
35096 If this feature is set, then the <!--#echo var="VAR_dead-letter-files"--> option has no effect.
35097 <P>
35098 <UL>
35099 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35100 </UL><P>
35101 &lt;End of help on this topic&gt;
35102 </BODY>
35103 </HTML>
35104 ====== h_config_quell_beeps =====
35105 <HTML>
35106 <HEAD>
35107 <TITLE>FEATURE: <!--#echo var="FEAT_quell-status-message-beeping"--></TITLE>
35108 </HEAD>
35109 <BODY>
35110 <H1>FEATURE: <!--#echo var="FEAT_quell-status-message-beeping"--></H1>
35111
35112 This feature affects Alpine's behavior when it displays status message
35113 (e.g., Error complaints, New mail warnings, etc).  Setting this feature
35114 will not affect the display of such messages, but will cause those that
35115 emit a beep to become silent.
35116
35117 <P>
35118 <UL>
35119 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35120 </UL><P>
35121 &lt;End of help on this topic&gt;
35122 </BODY>
35123 </HTML>
35124 ====== h_config_suppress_user_agent =====
35125 <HTML>
35126 <HEAD>
35127 <TITLE>FEATURE: <!--#echo var="FEAT_suppress-user-agent-when-sending"--></TITLE>
35128 </HEAD>
35129 <BODY>
35130 <H1>FEATURE: <!--#echo var="FEAT_suppress-user-agent-when-sending"--></H1>
35131
35132 If this feature is set then Alpine will not generate a
35133 <CODE>User-Agent</CODE> header in outgoing messages.
35134 <P>
35135 <UL>
35136 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35137 </UL><P>
35138 &lt;End of help on this topic&gt;
35139 </BODY>
35140 </HTML>
35141 ====== h_config_quell_lock_failure_warnings =====
35142 <HTML>
35143 <HEAD>
35144 <TITLE>FEATURE: <!--#echo var="FEAT_quell-lock-failure-warnings"--></TITLE>
35145 </HEAD>
35146 <BODY>
35147 <H1>FEATURE: <!--#echo var="FEAT_quell-lock-failure-warnings"--></H1>
35148
35149 This feature affects Alpine's behavior when it encounters a problem
35150 acquiring a mail folder lock.  Typically, a secondary file associated
35151 with the mail folder being opened is created as part of the locking
35152 process.  On some systems, such file creation has been administratively
35153 precluded by the system configuration.
35154 <P>
35155 Alpine issues a warning when such failures occur, which can become bothersome
35156 if the system is configured to disallow such actions.  Setting this
35157 feature causes Alpine to remain silent when this part of lock creation fails.
35158 <P>
35159 WARNING: systems that have been configured in a way that precludes locking
35160 introduce some risk of mail folder corruption when more than one program
35161 attempts to modify the mail folder.  This is most likely to occur to one's
35162 INBOX or other incoming message folder.
35163 <P>
35164 See also <A HREF="h_info_on_locking">&quot;What Systems Managers Need to Know about Alpine File Locking&quot;</A>.
35165 <P>
35166 <UL>
35167 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35168 </UL><P>
35169 &lt;End of help on this topic&gt;
35170 </BODY>
35171 </HTML>
35172 ====== h_config_enable_role_take ======
35173 <HTML>
35174 <HEAD>
35175 <TITLE>FEATURE: <!--#echo var="FEAT_enable-rules-under-take"--></TITLE>
35176 </HEAD>
35177 <BODY>
35178 <H1>FEATURE: <!--#echo var="FEAT_enable-rules-under-take"--></H1>
35179
35180 Normally, the Take command takes addresses from a message and helps you
35181 put them into your Address Book.
35182 If you use Rules for Indexcolors, Roles, Filtering, or Scoring;
35183 you may find it useful
35184 to be able to Take information from a message's headers and put it into
35185 a new Rule.
35186 When this feature is set, you will be given an extra prompt that gives
35187 you the choice to Take into the Address Book or Take into a rule.
35188 <P><UL>
35189 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35190 </UL>
35191 <P>
35192 &lt;End of help on this topic&gt;
35193 </BODY>
35194 </HTML>
35195 ====== h_config_enable_take_export ======
35196 <HTML>
35197 <HEAD>
35198 <TITLE>FEATURE: <!--#echo var="FEAT_enable-take-export"--></TITLE>
35199 </HEAD>
35200 <BODY>
35201 <H1>FEATURE: <!--#echo var="FEAT_enable-take-export"--></H1>
35202
35203 Normally, the Take command takes addresses from a message and helps you
35204 put them into your Address Book.
35205 When this feature is set, you will be given an extra prompt that gives you
35206 the choice to Take addresses into a file instead of your Address
35207 Book.
35208 Only the user@domain_name part of the address is put in the file.
35209 <P><UL>
35210 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35211 </UL>
35212 <P>
35213 &lt;End of help on this topic&gt;
35214 </BODY>
35215 </HTML>
35216 ====== h_config_quell_folder_internal_msg ======
35217 <HTML>
35218 <HEAD>
35219 <TITLE>FEATURE: <!--#echo var="FEAT_quell-folder-internal-msg"--></TITLE>
35220 </HEAD>
35221 <BODY>
35222 <H1>FEATURE: <!--#echo var="FEAT_quell-folder-internal-msg"--></H1>
35223
35224 This feature determines whether or not Alpine will create
35225 &quot;pseudo messages&quot; in folders that are in standard Unix or
35226 MMDF format. <P>
35227
35228 Alpine will normally create these pseudo messages when they are not already
35229 present in a standard Unix or MMDF folder.  Their purpose is to record
35230 certain mailbox state data needed for correct IMAP and POP server
35231 operation, and also for Alpine to be able to mark messages as Answered when
35232 the Reply has been postponed.<P>
35233
35234 Sites that do not use IMAP/POP for remote mail access, and that need to
35235 support mail tools that are adversely affected by the presence of the
35236 pseudo-messages (e.g. some mail notification tools) may enable this
35237 feature to tell Alpine not to create them.  Note that Alpine's
35238 &quot;Answered&quot; flag
35239 capability will be adversely affected if this is done.<P>
35240
35241 Note too that, even if this feature is enabled, Alpine will not remove
35242 pseudo-messages when it encounters them (e.g. those created by UW's imapd
35243 or ipopd servers.) This feature has no effect on folders that are not in
35244 standard Unix or MMDF format, as pseudo-messages are not needed in the
35245 other formats to record mailbox state information.
35246 <P><UL>
35247 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35248 </UL>
35249 <P>
35250 &lt;End of help on this topic&gt;
35251 </BODY>
35252 </HTML>
35253 ====== h_config_mulnews_as_typed ======
35254 <HTML>
35255 <HEAD>
35256 <TITLE>FEATURE: <!--#echo var="FEAT_mult-newsrc-hostnames-as-typed"--></TITLE>
35257 </HEAD>
35258 <BODY>
35259 <H1>FEATURE: <!--#echo var="FEAT_mult-newsrc-hostnames-as-typed"--></H1>
35260
35261 This feature will be of little use to most users.
35262 It has no effect unless the feature
35263 <A HREF="h_config_enable_mulnewsrcs"><!--#echo var="FEAT_enable-multiple-newsrcs"--></A>
35264 is set.
35265
35266 When the <!--#echo var="FEAT_enable-multiple-newsrcs"--> feature is set
35267 then the setting of this feature may have an effect on the names of the
35268 newsrc files used.
35269 Normally, the name of the news server will be canonicalized before it is
35270 used in the newsrc file name.
35271 For example, if you type the news server name
35272
35273 <P>
35274 <CENTER><SAMP>servername</SAMP></CENTER>
35275 <P>
35276
35277 it is likely that the canonical name will be something like
35278
35279 <P>
35280 <CENTER><SAMP>servername.example.com</SAMP></CENTER>
35281 <P>
35282
35283 Or it may be the case that
35284
35285 <P>
35286 <CENTER><SAMP>servername.example.com</SAMP></CENTER>
35287 <P>
35288
35289 is really an alias (a DNS CNAME) for
35290
35291 <P>
35292 <CENTER><SAMP>othername.example.com</SAMP></CENTER>
35293 <P>
35294
35295 If this feature is not set, then the canonicalized names will be used.
35296 If this feature is set, then the name you typed in (or put in your
35297 configuration) will be used.
35298
35299 <P><UL>
35300 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35301 </UL>
35302 <P>
35303 &lt;End of help on this topic&gt;
35304 </BODY>
35305 </HTML>
35306 ====== h_config_quell_empty_dirs ======
35307 <HTML>
35308 <HEAD>
35309 <TITLE>FEATURE: <!--#echo var="FEAT_quell-empty-directories"--></TITLE>
35310 </HEAD>
35311 <BODY>
35312 <H1>FEATURE: <!--#echo var="FEAT_quell-empty-directories"--></H1>
35313
35314 This feature causes Alpine to remove from the display any directories
35315 that do not contain at least one file or directory.  This can be useful
35316 to prevent overly cluttered folder lists when a collection is stored on
35317 a server that treats all names as both a folder and a directory.
35318
35319 <P>
35320 Note, enabling this feature can cause surprising behavior!  For example,
35321 you can still use Add to create a directory, but unless you immediately
35322 enter that directory and create a folder, that newly created directory
35323 may not be displayed next time you enter the folder list.
35324
35325 <P>
35326 The description above is not quite correct.
35327 Only directories which potentially may hold messages are hidden if empty.
35328 That is, a directory which is really just a directory and is not selectable
35329 as a folder will not be hidden.
35330 Such directories can occur on servers that treat most names as both a folder
35331 and a directory.
35332 These directories are typically created implicitly when a folder is created
35333 inside a directory that does not yet exist.
35334
35335 <P>
35336 <UL>
35337 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35338 </UL><P>
35339 &lt;End of help on this topic&gt;
35340 </BODY>
35341 </HTML>
35342 ====== h_config_termcap_wins =====
35343 <HTML>
35344 <HEAD>
35345 <TITLE>FEATURE: <!--#echo var="FEAT_termdef-takes-precedence"--></TITLE>
35346 </HEAD>
35347 <BODY>
35348 <H1>FEATURE: <!--#echo var="FEAT_termdef-takes-precedence"--></H1>
35349
35350 This feature may affect Alpine's low-level input routines.  Termcap (or
35351 terminfo, depending on how your copy of Alpine was compiled and linked)
35352 is the name of the database that describes terminal capabilities.  In
35353 particular, it describes the sequences of characters that various keys
35354 will emit.
35355
35356 <P>
35357 An example would be the Up Arrow key on the keyboard.  Up
35358 Arrow is not a distinct character on most Unix systems.  When you press
35359 the Up Arrow key a short sequence of characters are produced.  This
35360 sequence is supposed to be described in the termcap database by the
35361 &quot;ku&quot; capability (or by the &quot;kcuu1&quot; capability if you
35362 are using terminfo instead of termcap).
35363
35364 <P>
35365 By default, Alpine defines some terminal
35366 escape sequences that are commonly used.  For example, the sequence
35367 &quot;ESC&nbsp;O&nbsp;A&quot; is recognized as an Up Arrow key.  The sequence
35368 &quot;ESC&nbsp;[&nbsp;A&quot;
35369 is also recognized as an Up Arrow key.  These are chosen because common
35370 terminals like VT100's or ANSI standard terminals produce these
35371 sequences when you press the Up Arrow key.
35372
35373 <P>
35374 If your system's termcap
35375 (terminfo) database assigns some other function to the sequence
35376 &quot;ESC&nbsp;O&nbsp;A&quot;
35377 it is usually ignored by Alpine.  Also, if your termcap (terminfo)
35378 database assigns a sequence that doesn't begin with an escape
35379 character (<SAMP>ESC</SAMP>) it is usually ignored by Alpine.
35380 This usually works fine
35381 because most terminals emit the escape sequences that Alpine has defined
35382 by default.  We have also found that it is usually better to have these
35383 defaults take precedence over the definitions contained in the database
35384 because the defaults are more likely to be correct than the database.
35385
35386 <P>
35387 There are some terminals where this breaks down.  If you want Alpine to
35388 believe the definitions given in your termcap (terminfo) database in
35389 preference to the defaults the Alpine itself sets up, then you may turn
35390 this feature on.  Then, sequences of characters that are defined in
35391 both termcap (terminfo) and in Alpine's set of defaults will be
35392 interpreted the way that termcap (terminfo) says they should be
35393 interpreted.  Also, if your terminal capabilities database assigns a
35394 sequence that doesn't begin with escape, it will not be ignored.
35395
35396 <P>
35397 <UL>
35398 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35399 </UL><P>
35400 &lt;End of help on this topic&gt;
35401 </BODY>
35402 </HTML>
35403 ====== h_config_cruise_mode =====
35404 <HTML>
35405 <HEAD>
35406 <TITLE>FEATURE: <!--#echo var="FEAT_enable-cruise-mode"--></TITLE>
35407 </HEAD>
35408 <BODY>
35409 <H1>FEATURE: <!--#echo var="FEAT_enable-cruise-mode"--></H1>
35410
35411 This feature affects Alpine's behavior when you hit the
35412 &quot;Space&nbsp;Bar&quot; at
35413 the end of a displayed message.  Typically, Alpine complains that the end
35414 of the text has already been reached.  Setting this feature causes such
35415 keystrokes to be interpreted as if the &quot;Tab&quot; key had been hit, thus
35416 taking you to the next &quot;interesting&quot; message,
35417 or scanning ahead to the
35418 next incoming folder with &quot;interesting&quot; messages.
35419
35420 <P>
35421 <UL>
35422 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35423 </UL><P>
35424 &lt;End of help on this topic&gt;
35425 </BODY>
35426 </HTML>
35427 ====== h_config_cruise_mode_delete =====
35428 <HTML>
35429 <HEAD>
35430 <TITLE>FEATURE: <!--#echo var="FEAT_enable-cruise-mode-delete"--></TITLE>
35431 </HEAD>
35432 <BODY>
35433 <H1>FEATURE: <!--#echo var="FEAT_enable-cruise-mode-delete"--></H1>
35434
35435 This feature modifies the behavior of Alpine's
35436 <A HREF="h_config_cruise_mode">&quot;<!--#echo var="FEAT_enable-cruise-mode"-->&quot;</A> feature.
35437 Setting this feature causes Alpine to implicitly delete read
35438 messages when it moves on to display the next &quot;interesting&quot; message.
35439 <P>
35440 NOTE: Beware when enabling this feature AND the
35441 <A HREF="h_config_auto_expunge">&quot;<!--#echo var="FEAT_expunge-without-confirm"-->&quot;</A>
35442 feature.
35443 <P>
35444 <UL>
35445 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35446 </UL><P>
35447 &lt;End of help on this topic&gt;
35448 </BODY>
35449 </HTML>
35450 ====== h_config_slash_coll_entire =====
35451 <HTML>
35452 <HEAD>
35453 <TITLE>FEATURE: <!--#echo var="FEAT_slash-collapses-entire-thread"--></TITLE>
35454 </HEAD>
35455 <BODY>
35456 <H1>FEATURE: <!--#echo var="FEAT_slash-collapses-entire-thread"--></H1>
35457
35458 The slash (/) command is available from the MESSAGE INDEX screen when
35459 the folder is sorted by either Threads or OrderedSubject, and the
35460 <A HREF="h_config_thread_disp_style"><!--#echo var="VAR_threading-display-style"--></A>
35461 is set to something other than &quot;none&quot;.
35462 Normally, the slash command Collapses or Expands the subthread that
35463 starts at the currently highlighted message, if any.
35464 If this option is set, then the slash command Collapses or Expands the
35465 <EM>entire</EM> current thread instead of just the subthread.
35466 The current thread is simply the top-level thread that contains the
35467 current message.
35468
35469 <P>
35470 <UL>
35471 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35472 </UL><P>
35473 &lt;End of help on this topic&gt;
35474 </BODY>
35475 </HTML>
35476 ====== h_config_color_thrd_import =====
35477 <HTML>
35478 <HEAD>
35479 <TITLE>FEATURE: <!--#echo var="FEAT_thread-index-shows-important-color"--></TITLE>
35480 </HEAD>
35481 <BODY>
35482 <H1>FEATURE: <!--#echo var="FEAT_thread-index-shows-important-color"--></H1>
35483
35484 This option affects only the THREAD INDEX screen.
35485 Whether or not you ever see a THREAD INDEX screen depends on the setting
35486 of the configuration option
35487 <A HREF="h_config_thread_index_style">&quot;<!--#echo var="VAR_threading-index-style"-->&quot;</A>
35488 and on the sort order of the index.
35489
35490 <P>
35491 If a message within a thread is flagged as Important
35492 and this option is set, then
35493 the entire line in the THREAD INDEX will be colored the color of the
35494 Index-important Symbol, which can be set using the
35495 <A HREF="h_color_setup">Setup Kolor</A> screen.
35496
35497 <P>
35498 <UL>
35499 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35500 </UL><P>
35501 &lt;End of help on this topic&gt;
35502 </BODY>
35503 </HTML>
35504 ====== h_config_allow_goto =====
35505 <HTML>
35506 <HEAD>
35507 <TITLE>FEATURE: <!--#echo var="FEAT_enable-goto-in-file-browser"--></TITLE>
35508 </HEAD>
35509 <BODY>
35510 <H1>FEATURE: <!--#echo var="FEAT_enable-goto-in-file-browser"--></H1>
35511
35512 This feature modifies the behavior of Alpine's file browser.  Setting this
35513 feature causes Alpine to offer the "G Goto" command in the file browser.
35514 That is the default.
35515
35516 <P>
35517
35518 The Goto command allows you to explicitly type in the desired directory.
35519 <P>
35520 &lt;End of help on this topic&gt;
35521 </BODY></HTML>
35522 ====== h_config_add_ldap =====
35523 <HTML>
35524 <HEAD>
35525 <TITLE>FEATURE: <!--#echo var="FEAT_ldap-result-to-addrbook-add"--></TITLE>
35526 </HEAD>
35527 <BODY>
35528 <H1>FEATURE: <!--#echo var="FEAT_ldap-result-to-addrbook-add"--></H1>
35529
35530 If both the Directory option
35531 <A HREF="h_config_ldap_opts_impl">&quot;Use-Implicitly-From-Composer&quot;</A>
35532 and this feature are set,
35533 then when an implicit directory lookup is done from the
35534 composer you will automatically be prompted to add the result of the
35535 directory lookup to your address book.
35536 <P>
35537 <UL>
35538 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35539 </UL><P>
35540 &lt;End of help on this topic&gt;
35541 </BODY>
35542 </HTML>
35543 ===== h_patterns_compat_behavior =====
35544 <HTML>
35545 <HEAD>
35546 <TITLE>Rules Behavior Changes in Pine 4.50</TITLE>
35547 </HEAD>
35548 <BODY>
35549 <H1>Rules Behavior Changes in Pine 4.50</H1>
35550
35551 In Alpine, Rules that contain unrecognized elements
35552 are ignored.
35553 In most cases, the unrecognized elements will be something that was
35554 added as a new Rules feature in a later version of Alpine.
35555 In versions of Pine <EM>prior</EM> to 4.50, Pine did <EM>not</EM>
35556 ignore rules that contained unrecognized elements.
35557 For example, a new element of Rules that was added in Pine 4.50 is
35558 Age interval.
35559 Suppose you add an Indexcolor rule, using version Pine 4.50 or later, that colors
35560 all messages older than a week red.
35561 Now, if you run Pine 4.44 using that same configuration file, it will not
35562 recognize the Age interval and so will just ignore it.
35563 That means that all messages will match that rule so all messages will
35564 be colored red when using Pine version 4.44.
35565
35566 <P>
35567 This behavior was considered a bug so it is fixed in Alpine and Pine 4.50 and later.
35568 However, since the behavior still exists in versions prior to Pine 4.50 and
35569 since Filtering is a potentially destructive operation, another measure
35570 was taken to attempt to avoid unintentional Filtering of messages.
35571 The first time that you run Alpine or a Pine that is version 4.50 or greater,
35572 the rules in your Filters configuration variable (&quot;Patterns-Filters&quot;)
35573 will be copied to a new Filters configuration variable
35574 with a different name (&quot;Patterns-Filters2&quot;).
35575 From then on, Alpine will continue to use the new
35576 variable.
35577 Of course, Pine version 4.44 or lower will continue to use the old
35578 variable.
35579 That means that if you are using Alpine
35580 and also using a version of Pine that is older than 4.50, they will not
35581 share the configuration information about Filters.
35582 If you make a change in one version you won't see it in the other version.
35583
35584 <P>
35585 Since Scoring can be used to trigger Filtering, the same thing has been
35586 done for Score rules.
35587 The old configuration variable name is (&quot;Patterns-Scores&quot;)
35588 and the new name is (&quot;Patterns-Scores2&quot;).
35589 The same is not true of Role, Indexcolor, and Other rules that are
35590 thought to be less harmful when a mistake is made.
35591
35592 <P>
35593 &lt;End of help on this topic&gt;
35594 </BODY>
35595 </HTML>
35596 ======= h_config_filt_opts_sentdate =======
35597 <HTML>
35598 <HEAD>
35599 <TITLE>PATTERN FEATURE: Use-Date-Header-For-Age</TITLE>
35600 </HEAD>
35601 <BODY>
35602 <H1>PATTERN FEATURE: Use-Date-Header-For-Age</H1>
35603
35604 By default, the Age interval of a Pattern uses a message's time of
35605 arrival to compute the age of the message.
35606 If this feature is set, the date in the message's Date header will
35607 be used instead.
35608 <P>
35609 &lt;End of help on this topic&gt;
35610 </BODY>
35611 </HTML>
35612 ======= h_config_filt_opts_notdel =======
35613 <HTML>
35614 <HEAD>
35615 <TITLE>FILTER FEATURE: Move-Only-if-Not-Deleted</TITLE>
35616 </HEAD>
35617 <BODY>
35618 <H1>FILTER FEATURE: Move-Only-if-Not-Deleted</H1>
35619
35620 If this option is set then a message will be moved into the
35621 specified folder only if it is not marked for deletion.
35622 This is useful if you have multiple Alpine sessions running
35623 simultaneously and you don't want messages to be filtered into a
35624 folder more than once.
35625 It is also useful if you want to filter
35626 only the &quot;undeleted&quot; messages in a newsgroup into a folder.
35627 This method is not foolproof.
35628 There may be cases where a message
35629 gets marked deleted and so it is never filtered into the folder.
35630 For example, if you deleted it in another Alpine session or another mail
35631 program that didn't use the filtering rule.
35632 <P>
35633 This option has no effect if the Filter Action is not set to Move.
35634 <P>
35635 &lt;End of help on this topic&gt;
35636 </BODY>
35637 </HTML>
35638 ======= h_config_filt_opts_nonterm =======
35639 <HTML>
35640 <HEAD>
35641 <TITLE>FILTER FEATURE: Dont-Stop-Even-if-Rule-Matches</TITLE>
35642 </HEAD>
35643 <BODY>
35644 <H1>FILTER FEATURE: Dont-Stop-Even-if-Rule-Matches</H1>
35645
35646 If this option is set then this is a non-terminating rule.
35647 Usually, for each message, Alpine searches through the Filter Rules until
35648 a match is found and then it performs the action associated with that rule.
35649 Rules following the match are not considered.
35650 If this option is set then the search for matches will continue at the next
35651 rule.
35652 <P>
35653 If a non-terminating rule matches then the actions associated with
35654 that rule, except for any implied deletion of the message, are performed
35655 before the match for the next rule is checked.
35656 For example, if the non-terminating rule sets the Important status, then that
35657 status will be set when the next rule is considered.
35658 However, if the non-terminating rule Moves the message, the message will
35659 actually be copied instead of copied and deleted so that it is still there
35660 for the next rule.
35661 A moved message is deleted after all the relevant rules have been checked.
35662 The name of the &quot;Move&quot; action is confusing in this case because
35663 a single message can be moved to more than one folder.
35664 It turns the Move into a Copy instead, but it is still followed by a deletion
35665 at the end.
35666 <P>
35667 This option may be useful if you want to have a single message filtered to
35668 two different folders because it matches two different Patterns.
35669 For example, suppose you normally filter messages to a particular mailing
35670 list into one folder, and messages addressed directly to you into a second
35671 folder.
35672 If a message is sent to both you and the list (and you can tell that by
35673 looking at the headers of the message) this option may give you a convenient
35674 way to capture a copy to each folder.
35675 (It may also cause you to capture two copies to each folder,
35676 depending on whether your mail system delivers one or two copies of the
35677 message to you and on how the list works.)
35678 <P>
35679 &lt;End of help on this topic&gt;
35680 </BODY>
35681 </HTML>
35682 ====== h_command_external_browser =====
35683 <HTML>
35684 <HEAD>
35685 <TITLE>The External Browser Command</TITLE>
35686 </HEAD>
35687 <BODY>
35688 <H1>The External Browser Command</H1>
35689
35690 <P>
35691 A new command was added to Alpine that allows users to send HTML messages to be displayed
35692 by a web browser. This is helpful when a user wants to see images in the context of the
35693 message, or get a better display of the message than Alpine provides.
35694
35695 <P>
35696 The simplest way to use this command is to do as follows. While reading a message,
35697 press the &quot;V&quot; to go to the <A href="h_attachment_screen">ATTACHMENT SCREEN</A>.
35698 In that screen move the cursor until it is on top of a TEXT/HTML attachment and press the
35699 &quot;X&quot; key. This will make Alpine launch the browser you have configured for
35700 in the <a href="h_config_browser"><!--#echo var="VAR_url-viewers"--></a> variable, and
35701 you should be able to read the message in your browser, as well as in Alpine.
35702
35703 <P> If the message you sent to your browser has inline images, then the images attached to
35704 the message that are necessary for the display of the message are also sent to the browser
35705 for its display.
35706
35707 <P> The text that follows will explain more details about this command, and is only
35708 recommended for more advanced users.
35709
35710 <h1><CENTER>Displaying Images</CENTER></h1>
35711
35712 <P> First, we will talk about displaying images in an HTML file. Typically, HTML images
35713 are displayed as the result of some specific code of the form
35714 <center>
35715 <PRE>
35716 &lt;img src=&quot;...&quot;&gt;,
35717 </PRE>
35718 </center>
35719 where the text between the quotes tells Alpine how to find the image.
35720 If the source of the image is internal to the message, Alpine passes that image to the
35721 browser. Otherwise Alpine erases the link to the image. This is done so that
35722 you can be protected from a bad use of external images. Images can be used to track
35723 that you read the message, or your location, devices you own, etc.. Since Alpine does
35724 not open images in any messages, your
35725 privacy is always protected this way. Therefore, when you do not pass the links to
35726 external images to a browser, your privacy is being protected. However, doing this
35727 might make the message not be displayed correctly, since when the message was
35728 created the images were part of the formatted message, and not having images might make
35729 this formatting look awkward.
35730
35731 <P> If you would like that Alpine display all images, regardless of their source, and
35732 regardless of the sender, then you need to disable the feature <a
35733 href="h_external_loads_inline_images_only"><!--#echo var="FEAT_external-command-loads-inline-images-only"--></a>.
35734 The message will display as intended, but you will leak information to the sender of the
35735 message, as well as to your internet service provider, which could be your employer, or
35736 school, etc.
35737
35738 <P> Alpine provides an alternative mechanism to either send all links to the images to the
35739 external browser or to send only those that are attached to the message you are trying to
35740 display. In order to use this mechanism you must first enable
35741 <a href="h_config_enable_view_attach"><!--#echo var="FEAT_enable-msg-view-attachments"--></a>.
35742 This allows Alpine to add direct links to each attachments. If you want to send an HTML
35743 attachment to an external browser, you would place the cursor over the attachment and press
35744 the &quot;Return&quot; or &quot;Enter&quot; key to open the attachment. When you do that
35745 you will see a prompt and menu which says
35746
35747 <pre>
35748 View selected Attachment  ?
35749 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Y [Yes]&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;X External
35750 ^C Cancel&nbsp;&nbsp;&nbsp;&nbsp;N No
35751 </pre>
35752
35753 <P>In order to send this message to an external browser, you would press the &quot;X&quot;
35754 key. This will change the prompt and menu to
35755
35756 <pre>
35757 View selected Attachment using external viewer including inline images only ?
35758 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Y [Yes]&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;X No eXternal
35759 ^C Cancel&nbsp;&nbsp;&nbsp;&nbsp;N No&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;I All images
35760 </pre>
35761
35762 <P>This is telling you that if you answer &quot;Yes&quot; to this question, and external
35763 browser will be used to send this messages, and only inline images, that is, those attached
35764 in the message will be sent to the browser. If you would like to send all images in
35765 this case, the menu tells you that you must press the &quot;I&quot; key. Pressing
35766 that key changes the prompt and menu to
35767
35768 <pre>
35769 View selected Attachment using external viewer including all images ?
35770 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Y [Yes]&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;X No eXternal
35771 ^C Cancel&nbsp;&nbsp;&nbsp;&nbsp;N No&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;I Inline imgs
35772 </pre>
35773
35774 <P>and as you can see the prompt says that if you press &quot;Yes&quot; then the message
35775 will be sent to the browser including the source of all images, including those in
35776 external servers. Notice that the &quot;X&quot; command now is a toggle. If you
35777 were to press it now, you would return to the original prompt,
35778
35779 <pre>
35780 View selected Attachment  ?
35781 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Y [Yes]&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;X External
35782 ^C Cancel&nbsp;&nbsp;&nbsp;&nbsp;N No
35783 </pre>
35784
35785 <P>which means that if you answer &quot;Yes&quot; at this time your message would not
35786 be sent to your external browser for display, unless you have configured a mailcap
35787 entry to display HTML files.
35788
35789 <P> One of the lessons of this discussion is that if you never press the &quot;X&quot;
35790 command in the ATTACHMENT SCREEN, and you never press the &quot;X&quot; command when
35791 launching a viewer for an attachment in the MESSAGE TEXT screen, you will never use this
35792 mechanism, and Alpine will resort to your already configured mechanisms to open HTML
35793 text.This means you can live your life without worrying that Alpine will do anything
35794 different because of this new feature. You do not have to use it, but if you do, you should
35795 know the risks and advantages and decide when and how to use it.
35796
35797 <h1><CENTER>Saving HTML Messages to Disk</CENTER></h1>
35798
35799 <P>
35800 No matter what your reason to send a message to an external web browser is, Alpine must
35801 write your message to a file (and also all related inline images), and point your browser
35802 to open that file. Alpine saves all your messages and auxiliary images in a subdirectory
35803 of the ~/.alpine-html directory in unix-like Alpine, or the alpine-html folder in your home
35804 directory in PC-Alpine. If Alpine cannot access these directories, or create folders
35805 in them, then the full mechanism described above will fail, and you will not be able
35806 to send messages to an external browser for display.
35807
35808 <P>
35809 Unfortunately browsers do not remove the file that Alpine created, nor the images
35810 that Alpine saved in order to display this message, so if you use this mechanism often
35811 you will create many directories and files which the browser will not remove. Alpine
35812 will remove these files when you exit Alpine. Any temporary directory that Alpine
35813 created that has existed for longer than 10 minutes will be automatically erased.
35814 Alpine also erases these directories upon exiting.
35815
35816 <P>
35817 When Alpine creates a directory to house the files associated to a message that will
35818 pass to an external browser, it tries to delete that directory later on, according to
35819 the discussion above. What this means is that you should consider the contents of the
35820 ~/.alpine-html directory in unix-like Alpine and the alpine-html folder in PC-Alpine
35821 as temporary, and not rely on their existence. If you attempt to save files in one of
35822 these directories, chances are your data will be deleted by Alpine. Since deleting is
35823 a destructive action,
35824 every session of Alpine that you have open will only attempt to remove the directories
35825 it created, with their content in them. If this operation fails, Alpine will not try
35826 to investigate, nor will report to you, why the operation failed. Therefore, users
35827 should periodically check their html directory to see if there is content there that
35828 they wish to delete.
35829
35830 <P>
35831 <UL>
35832 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
35833 </UL><P>
35834 &lt;End of help on this topic&gt;
35835 </BODY>
35836 </HTML>
35837 ===== h_mainhelp_smime ======
35838 <HTML>
35839 <HEAD>
35840 <TITLE>S/MIME Overview</TITLE>
35841 </HEAD>
35842 <BODY>
35843 <H1>S/MIME Overview</H1>
35844
35845 S/MIME is a standard for the public key encryption and signing of email.
35846 UNIX Alpine contains a basic implementation of S/MIME based on
35847 the <A HREF="http://www.openssl.org/">OpenSSL</A> libraries. The
35848 same support can be provided using the
35849 <A HREF="http://www.libressl.org/">LibreSSL</A> libraries. The
35850 support for S/MIME in PC-Alpine is fully based on the LibreSSL libraries.
35851 To check if this version of Alpine supports S/MIME look at
35852 <A HREF="X-Alpine-Config:">Supported Options in this Alpine</A> and look
35853 for &quot;S/MIME&quot; under the &quot;Encryption&quot; heading.
35854 <P>
35855 Some limitations:
35856 <UL>
35857    <LI> There is no provision for checking for CRLs
35858         (Certificate Revocation Lists) in Alpine.
35859    <LI> This built-in S/MIME implementation is not compatible with and does not help with PGP.
35860    <LI> There is no mechanism available for feeding either an entire incoming
35861         or an entire outgoing message to an external
35862         filter and using that external filter to do S/MIME or PGP processing.
35863    <LI> Because the implementation currently uses OpenSSL, there is only a very
35864         limited integration with the Mac OS Keychain (the storing and access of
35865         public certificates).
35866 </UL>
35867 <P>
35868 The S/MIME configuration screen is reached by going to the Main Menu and typing
35869 the &quot;S&nbsp;Setup&quot; command followed by &quot;M&nbsp;S/MIME&quot;.
35870 <P>
35871
35872 <H2>S/MIME BASICS</H2>
35873
35874 In order to digitally sign messages you send you must have a public/private key-pair.
35875 This may be obtained from a public Certificate Authority (CA) such as Thawte, Verisign, Comodo,
35876 or GoDaddy; or from a smaller CA such as a university which provides certificates for its
35877 users or a company which provides certificates for its workers.
35878 These certificates are bound to an email address, so the identity being verified is the
35879 email address not a person's name.
35880 <P>
35881 Mail is signed by using the sender's private key, which only the owner of the private key
35882 has access to.
35883 The signature is verified using the signer's public key, which anyone can
35884 have access to.
35885 With Alpine, the first time you receive a signed message the public key of the
35886 sender will be stored for future use.
35887
35888 <P>
35889 Mail is encrypted using the recipient's public key and decrypted by
35890 the recipient with their private key.
35891
35892 <P>
35893 You need a key of your own in order to sign outgoing messages and to have others
35894 encrypt messages sent to you.
35895 You do not need a key of your own to verify signed messages sent by others or to
35896 encrypt messages sent to others.
35897
35898 <H2>ALPINE S/MIME CERTIFICATE STORAGE</H2>
35899
35900 By default UNIX Alpine stores the certificates it uses in a directory in your
35901 home directory.
35902 The directory name is
35903 <P>
35904 <CENTER><SAMP>.alpine-smime</SAMP></CENTER>
35905 <P>
35906 For PC-Alpine, the equivalent directory is called
35907 <CENTER><SAMP>alpine-smime</SAMP></CENTER>
35908 and is also located under your home directory.
35909 <P>
35910 Within that directory are three subdirectories.
35911 Each of the three subdirectories contains files with PEM-encoded contents,
35912 the default format for OpenSSL.
35913 The &quot;<SAMP>public</SAMP>&quot; directory contains public certificates.
35914 The files within that directory have names that are email addresses with the
35915 suffix &quot;<SAMP>.crt</SAMP>&quot; appended.
35916 An example filename is
35917 <P>
35918 <CENTER><SAMP>user@example.com.crt</SAMP></CENTER>
35919 <P>
35920 The &quot;<SAMP>private</SAMP>&quot; directory contains private keys, probably just one for
35921 your private key.
35922 These are also email addresses but with the suffix &quot;<SAMP>.key</SAMP>&quot; instead.
35923 The third directory is &quot;<SAMP>ca</SAMP>&quot; and it contains certificates for any Certificate
35924 Authorities that you want to trust but that aren't contained in the set of system CAs.
35925 Those files may have arbitrary names as long as they end with the
35926 suffix &quot;<SAMP>.crt</SAMP>&quot;.
35927
35928 <H2>HOW TO SIGN AND ENCRYPT</H2>
35929
35930 If you have a certificate you may sign outgoing messages.
35931 After typing the Ctrl-X command to send a message you will see the prompt
35932 <P>
35933 <CENTER><SAMP>Send message?</SAMP></CENTER>
35934 <P>
35935 Available subcommands include &quot;G&nbsp;Sign&quot; and &quot;E&nbsp;Encrypt&quot;.
35936 Typing the &quot;G&quot; command will change the prompt to
35937 <P>
35938 <CENTER><SAMP>Send message (Signed)?</SAMP></CENTER>
35939 <P>
35940 Typing the &quot;E&quot; command will change the prompt to
35941 <P>
35942 <CENTER><SAMP>Send message (Encrypted)?</SAMP></CENTER>
35943 <P>
35944 You may even type both to get
35945 <P>
35946 <CENTER><SAMP>Send message (Encrypted, Signed)?</SAMP></CENTER>
35947 <P>
35948
35949 <H2>HOW TO READ SIGNED OR ENCRYPTED MESSAGES</H2>
35950
35951 The reading of a signed message should not require any special action on
35952 your part.
35953 There should be an editorial addition at the start of the message which
35954 says either
35955 <P>
35956 <CENTER><SAMP>This message was cryptographically signed.</SAMP></CENTER>
35957 <P>
35958 or
35959 <P>
35960 <CENTER><SAMP>This message was cryptographically signed but the signature could not be verified.</SAMP></CENTER>
35961 <P>
35962 If an encrypted message is sent to you the encrypted text will not
35963 be shown.
35964 You will have to type the &quot;Ctrl-D&nbsp;Decrypt&quot; command (from the screen where
35965 you are viewing the message) and supply your passphrase when asked.
35966 <P>
35967 For a signed or encrypted message there is also a &quot;Ctrl-E&nbsp;Security&quot; command
35968 which gives you some information about the certificate used to sign or encrypt the message.
35969
35970 <H2>MISCELLANEOUS</H2>
35971
35972 If you have access to a private certificate in the PKCS12 format, which
35973 would sometimes be in a file with a &quot;.p12&quot; extension, then you can
35974 use the following commands to generate private keys, public and certificate
35975 authorities certificates. In the examples below, we assume that the
35976 certificate in the p12 format is called &quot;certificate.p12&quot;, and
35977 that your email address is &quot;your@address.com&quot;.
35978
35979 <P>
35980 In order to create a private key use the command
35981 <P>
35982 <CENTER><SAMP>openssl pkcs12 -in certificate.p12 -out your@address.com.key</SAMP></CENTER>
35983 <P>
35984 In order to create a public certificate use the command
35985 <P>
35986 <CENTER><SAMP>
35987 openssl pkcs12 -in certificate.p12 -clcerts -nokeys -out your@address.com.crt
35988 </SAMP></CENTER>
35989 <P>
35990 In order to create a certificate authority certificate use the command
35991 <P>
35992 <CENTER><SAMP>
35993 openssl pkcs12 -in certificate.p12 -cacerts -nokeys -out certificate-ca.crt
35994 </SAMP></CENTER>
35995
35996 <P> If the previous command produces an empty file, it means that the
35997 certificate authority was not included in the .p12 file, so you will have
35998 to get it from some other sources. You will need these certificates, so
35999 that you can validate correctly signatures.
36000
36001 <P>
36002 After you have exported these certificates and keys, you can  use the import
36003 command in Alpine, from the S/MIME configuration screen,
36004 to import these certificates into Alpine. They will be available for use
36005 as soon as you import them.
36006 <P>
36007 &lt;End of help on this topic&gt;
36008 </BODY>
36009 </HTML>
36010 ====== h_config_smime_pubcertdir =====
36011 <HTML>
36012 <HEAD>
36013 <TITLE>S/MIME OPTION: <!--#echo var="VAR_smime-public-cert-directory"--></TITLE>
36014 </HEAD>
36015 <BODY>
36016 <H1>S/MIME OPTION: <!--#echo var="VAR_smime-public-cert-directory"--></H1>
36017
36018 <P>
36019 If the option
36020 <A HREF="h_config_smime_pubcertcon"><!--#echo var="VAR_smime-public-cert-container"--></A>
36021 is set then this option will have no effect.
36022 <P>
36023 Normally, Public Certificates for use with S/MIME will be stored in the directory
36024 which is the value of this option.
36025 Those certificates will be stored in PEM format, one certificate per file.
36026 The name of the file for the certificate corresponding to
36027 <P>
36028 <CENTER><SAMP>emailaddress</SAMP></CENTER>
36029 <P>
36030 should be
36031 <P>
36032 <CENTER><SAMP>emailaddress.crt</SAMP></CENTER>
36033 <P>
36034 For example, a file for user@example.com would be in the file
36035 <P>
36036 <CENTER><SAMP>user@example.com.crt</SAMP></CENTER>
36037 <P>
36038 in this directory.
36039 <P>
36040 Use the Setup/SMIME screen to modify this variable.
36041 <P>
36042 Typically, the public certificates that you have will come from S/MIME signed
36043 messages that are sent to you.
36044 Alpine will extract the public certificate from the signed message and store
36045 it in the certificates directory.
36046 These PEM format public certificates look something like:
36047 <PRE>
36048 -----BEGIN CERTIFICATE-----
36049 MIIFvTCCBKWgAwIBAgIQD4fYFHVI8T20yN4nus097DANBgkqhkiG9w0BAQUFADCB
36050 rjELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAlVUMRcwFQYDVQQHEw5TYWx0IExha2Ug
36051 Q2l0eTEeMBwGA1UEChMVVGhlIFVTRVJUUlVTVCBOZXR3b3JrMSEwHwYDVQQLExho
36052 ...
36053 2b9KGqDyMWW/rjNnmpjzjT2ObGM7lRA8lke4FLOLajhrz4ogO3b4DFfAAM1VSZH8
36054 D6sOwOLJZkLY8FRsfk63K+2EMzA2+qAzMKupgeTLqXIf
36055 -----END CERTIFICATE-----
36056 </PRE>
36057 <P>
36058 <UL>
36059 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36060 </UL><P>
36061 <P>
36062 <UL>
36063 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36064 </UL><P>
36065 &lt;End of help on this topic&gt;
36066 </BODY>
36067 </HTML>
36068 ====== h_config_smime_pubcertcon =====
36069 <HTML>
36070 <HEAD>
36071 <TITLE>OPTION: <!--#echo var="VAR_smime-public-cert-container"--></TITLE>
36072 </HEAD>
36073 <BODY>
36074 <H1>OPTION: <!--#echo var="VAR_smime-public-cert-container"--></H1>
36075
36076 <P>
36077 If this option is set it will be used instead of
36078 <A HREF="h_config_smime_pubcertdir"><!--#echo var="VAR_smime-public-cert-directory"--></A>.
36079 <P>
36080 This option gives you a way to store certificates remotely on an IMAP server
36081 instead of storing the certificates one per file locally.
36082 In order to do that you just give this option a remote folder name for a folder
36083 which does not yet exist.
36084 The name is similar to the name you might use for a remote configuration file.
36085 A remote folder name might look something like:
36086 <P>
36087 <CENTER><SAMP>{myimaphost.myschool.k12.wa.us}mail/publiccerts</SAMP></CENTER>
36088 <P>
36089 See
36090 <A HREF="h_valid_folder_names">Valid Folder Names</A> for more information
36091 about the syntax of folder names.
36092 <P>
36093 Use the Setup/SMIME screen to modify this variable.
36094 <P>
36095 <UL>
36096 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36097 </UL><P>
36098 <P>
36099 <UL>
36100 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36101 </UL><P>
36102 &lt;End of help on this topic&gt;
36103 </BODY>
36104 </HTML>
36105 ====== h_config_smime_privkeydir =====
36106 <HTML>
36107 <HEAD>
36108 <TITLE>OPTION: <!--#echo var="VAR_smime-private-key-directory"--></TITLE>
36109 </HEAD>
36110 <BODY>
36111 <H1>OPTION: <!--#echo var="VAR_smime-private-key-directory"--></H1>
36112
36113 <P>
36114 In order to sign outgoing S/MIME messages you will need a
36115 personal digital ID certificate.
36116 You will usually get such a certificate from a certificate authority such as
36117 Thawte or CAcert.
36118 (In order to encrypt outgoing messages you don't need a personal digital ID, you
36119 need the public certificate of the recipient instead.)
36120 If the option
36121 <A HREF="h_config_smime_privkeycon"><!--#echo var="VAR_smime-private-key-container"--></A>
36122 is set then this option will have no effect.
36123 <P>
36124 Normally, Private Keys for use with S/MIME will be stored in the directory
36125 which is the value of this option.
36126 Those certificates will be stored in PEM format, one certificate per file.
36127 The name of the file for the certificate corresponding to your
36128 <P>
36129 <CENTER><SAMP>emailaddress</SAMP></CENTER>
36130 <P>
36131 should be
36132 <P>
36133 <CENTER><SAMP>emailaddress.key</SAMP></CENTER>
36134 <P>
36135 For example, if your address is user@example.com the name of the file would be
36136 <P>
36137 <CENTER><SAMP>user@example.com.key</SAMP></CENTER>
36138 <P>
36139 in this directory.
36140 <P>
36141 Use the Setup/SMIME screen to modify this variable.
36142 <P>
36143 Typically, the private key that you have will come from a Certificate
36144 Authority.
36145 The private key should be stored in a PEM format file that
36146 looks something like:
36147 <PRE>
36148 -----BEGIN RSA PRIVATE KEY-----
36149 Proc-Type: 4,ENCRYPTED
36150 DEK-Info: DES-EDE3-CBC,2CBD328FD84CF5C6
36151
36152 YBEXYLgLU9NJoc1V+vJ6UvcF08RX54S6jXsmgL0b5HGkudG6fhnmHkH7+UCvM5NI
36153 SXO/F8iuZDfs1VGG0NyitkFZ0Zn2vfaGovBvm15gx24b2xnZDLRB7/bNZkurnK5k
36154 VjAjZ2xXn2hFp2GJwqRdmxYNqsKGu52B99oti5HUWuZ2GFRaWjn5hYOqeApZE2uA
36155 ...
36156 oSRqfI51UdSRt0tmGhHeTvybUVrHm9eKft8TTGf+qSBqzSc55CsmoVbRzw4Nfhix
36157 m+4TJybNGNfAgOctSkEyY/OCb49fRRQTCBZVIhzLGGmpYmkO55HbIA==
36158 -----END RSA PRIVATE KEY-----
36159 </PRE>
36160 <P>
36161 <UL>
36162 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36163 </UL><P>
36164 <P>
36165 <UL>
36166 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36167 </UL><P>
36168 &lt;End of help on this topic&gt;
36169 </BODY>
36170 </HTML>
36171 ====== h_config_smime_privkeycon =====
36172 <HTML>
36173 <HEAD>
36174 <TITLE>OPTION: <!--#echo var="VAR_smime-private-key-container"--></TITLE>
36175 </HEAD>
36176 <BODY>
36177 <H1>OPTION: <!--#echo var="VAR_smime-private-key-container"--></H1>
36178
36179 <P>
36180 If this option is set it will be used instead of
36181 <A HREF="h_config_smime_privkeydir"><!--#echo var="VAR_smime-private-key-directory"--></A>.
36182 <P>
36183 This option gives you a way to store keys remotely on an IMAP server
36184 instead of storing the keys one per file locally.
36185 In order to do that you just give this option a remote folder name for a folder
36186 which does not yet exist.
36187 The name is similar to the name you might use for a remote configuration file.
36188 A remote folder name might look something like:
36189 <P>
36190 <CENTER><SAMP>{myimaphost.myschool.k12.wa.us}mail/privatekeys</SAMP></CENTER>
36191 <P>
36192 See
36193 <A HREF="h_valid_folder_names">Valid Folder Names</A> for more information
36194 about the syntax of folder names.
36195 <P>
36196 Use the Setup/SMIME screen to modify this variable.
36197 <P>
36198 <UL>
36199 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36200 </UL><P>
36201 <P>
36202 <UL>
36203 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36204 </UL><P>
36205 &lt;End of help on this topic&gt;
36206 </BODY>
36207 </HTML>
36208 ====== h_config_smime_cacertdir =====
36209 <HTML>
36210 <HEAD>
36211 <TITLE>S/MIME OPTION: <!--#echo var="VAR_smime-cacert-directory"--></TITLE>
36212 </HEAD>
36213 <BODY>
36214 <H1>S/MIME OPTION: <!--#echo var="VAR_smime-cacert-directory"--></H1>
36215
36216 <P>
36217 If the option
36218 <A HREF="h_config_smime_cacertcon"><!--#echo var="VAR_smime-cacert-container"--></A>
36219 is set then this option will have no effect.
36220 <P>
36221 CACert is a shorthand name for certification authority certificate.
36222 Normally Alpine will use the CACerts that are located in the standard system
36223 location for CACerts.
36224 It may be the case that one of your correspondents has a Digital ID which has
36225 been signed by a certificate authority that is not in the regular set of system certificate
36226 authorities.
36227 You may supplement the system list by adding further certificates of your own.
36228 These should  be stored in the directory
36229 which is the value of this option.
36230 The certificates will be stored in PEM format, one certificate per file.
36231 The names of the files can be anything ending in &quot;.crt&quot;.
36232 <P>
36233 Use the Setup/SMIME screen to modify this variable.
36234 <P>
36235 These PEM format CA certificates look very similar to your public
36236 certificates for particular email addresses
36237 (<A HREF="h_config_smime_pubcertdir"><!--#echo var="VAR_smime-public-cert-directory"--></A>).
36238 <P>
36239 <UL>
36240 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36241 </UL><P>
36242 <P>
36243 <UL>
36244 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36245 </UL><P>
36246 &lt;End of help on this topic&gt;
36247 </BODY>
36248 </HTML>
36249 ====== h_config_smime_cacertcon =====
36250 <HTML>
36251 <HEAD>
36252 <TITLE>S/MIME OPTION: <!--#echo var="VAR_smime-cacert-container"--></TITLE>
36253 </HEAD>
36254 <BODY>
36255 <H1>S/MIME OPTION: <!--#echo var="VAR_smime-cacert-container"--></H1>
36256
36257 <P>
36258 If this option is set it will be used instead of
36259 <A HREF="h_config_smime_cacertdir"><!--#echo var="VAR_smime-cacert-directory"--></A>.
36260 <P>
36261 This option gives you a way to store certificates remotely on an IMAP server
36262 instead of storing the certificates one per file locally.
36263 In order to do that you just give this option a remote folder name for a folder
36264 which does not yet exist.
36265 The name is similar to the name you might use for a remote configuration file.
36266 A remote folder name might look something like:
36267 <P>
36268 <CENTER><SAMP>{myimaphost.myschool.k12.wa.us}mail/cacerts</SAMP></CENTER>
36269 <P>
36270 See
36271 <A HREF="h_valid_folder_names">Valid Folder Names</A> for more information
36272 about the syntax of folder names.
36273 <P>
36274 Use the Setup/SMIME screen to modify this variable.
36275 <P>
36276 <UL>
36277 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36278 </UL><P>
36279 <P>
36280 <UL>
36281 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36282 </UL><P>
36283 &lt;End of help on this topic&gt;
36284 </BODY>
36285 </HTML>
36286 ========== h_config_smime_sign_by_default ==========
36287 <HTML>
36288 <HEAD>
36289 <TITLE>S/MIME FEATURE: <!--#echo var="FEAT_smime-sign-by-default"--></TITLE>
36290 </HEAD>
36291 <BODY>
36292 <H1>S/MIME FEATURE: <!--#echo var="FEAT_smime-sign-by-default"--></H1>
36293
36294 <P>
36295 This feature only has an effect if your version of Alpine includes
36296 support for S/MIME.
36297 It affects Alpine's behavior when you send a message.
36298 If this option is set, the &quot;Sign&quot; option will default to ON when sending messages.
36299 <P>
36300 Only the default value is affected.
36301 In any case, you may still toggle the Signing option on or off before sending
36302 with the &quot;G Sign&quot; command (provided you have a personal digital ID
36303 certificate).
36304 <P>
36305 <UL>
36306 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36307 </UL><P>
36308 <P>
36309
36310 <UL>
36311 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36312 </UL><P>
36313 &lt;End of help on this topic&gt;
36314 </BODY>
36315 </HTML>
36316 ========== h_config_smime_use_cert_store ==========
36317 <HTML>
36318 <HEAD>
36319 <TITLE>S/MIME FEATURE: <!--#echo var="FEAT_smime-use-store-only"--></TITLE>
36320 </HEAD>
36321 <BODY>
36322 <H1>S/MIME FEATURE: <!--#echo var="FEAT_smime-use-store-only"--></H1>
36323
36324 <P>
36325 This feature only has an effect if your version of Alpine includes
36326 support for S/MIME.
36327 It affects Alpine's behavior when you validate a message, and should
36328 not be disabled, unless you are performing a test.
36329 <P>
36330 There are two important aspects of validation: validation of the message
36331 (that is, the message was not modified after it was sent)
36332 as well as validation of the identity of the sender. This option has to
36333 do with the latter.
36334 <P>
36335 In order to validate that the message came from the sender in the message
36336 and not an impersonator, Alpine can
36337 either use the certificates that come in the message, or the ones that
36338 you have personally stored. If this feature is enabled (the default) then
36339 Alpine will use certificates that you have already saved in your store
36340 and not those that come in the message to validate the sender of the
36341 message. In particular, the first time that you receive a signed message
36342 from a sender, and their certificate does not validate against your
36343 store, then you will be asked if you wish to save such certificate. If
36344 you do not wish to save the certificate, then Alpine will fail to validate
36345 the signature of the message. Otherwise, Alpine will proceed to validate
36346 the signature of the message. This behavior helps you prevent against impersonation, because
36347 it is assumed that you trust the certificates that you have saved, and
36348 might not trust those that came with the message that you are validating.
36349 <P>
36350 <UL>
36351 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36352 </UL><P>
36353 <P>
36354
36355 <UL>
36356 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36357 </UL><P>
36358 &lt;End of help on this topic&gt;
36359 </BODY>
36360 </HTML>
36361 ========== h_config_smime_pubcerts_in_keychain ==========
36362 <HTML>
36363 <HEAD>
36364 <TITLE>S/MIME FEATURE: <!--#echo var="FEAT_publiccerts-in-keychain"--></TITLE>
36365 </HEAD>
36366 <BODY>
36367 <H1>S/MIME FEATURE: <!--#echo var="FEAT_publiccerts-in-keychain"--></H1>
36368
36369 <P>
36370 If this feature is set the Mac OS X default keychain will be used as the place
36371 to store public certificates instead of a
36372 <A HREF="h_config_smime_pubcertdir"><!--#echo var="VAR_smime-public-cert-directory"--></A>
36373 or a
36374 <A HREF="h_config_smime_pubcertcon"><!--#echo var="VAR_smime-public-cert-container"--></A>.
36375 <P>
36376 <UL>
36377 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36378 </UL><P>
36379 <P>
36380 <UL>
36381 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36382 </UL><P>
36383 &lt;End of help on this topic&gt;
36384 </BODY>
36385 </HTML>
36386 ========== h_config_smime_dont_do_smime ==========
36387 <HTML>
36388 <HEAD>
36389 <TITLE>S/MIME FEATURE: <!--#echo var="FEAT_smime-dont-do-smime"--></TITLE>
36390 </HEAD>
36391 <BODY>
36392 <H1>S/MIME FEATURE: <!--#echo var="FEAT_smime-dont-do-smime"--></H1>
36393
36394 <P>
36395 Setting this feature turns off all of Alpine's S/MIME support.
36396 You might want to set this if you are having trouble due to the S/MIME support.
36397 <P>
36398 <UL>
36399 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36400 </UL><P>
36401 <P>
36402
36403 <UL>
36404 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36405 </UL><P>
36406 &lt;End of help on this topic&gt;
36407 </BODY>
36408 </HTML>
36409 ========== h_config_smime_encrypt_by_default ==========
36410 <HTML>
36411 <HEAD>
36412 <TITLE>S/MIME FEATURE: <!--#echo var="FEAT_smime-encrypt-by-default"--></TITLE>
36413 </HEAD>
36414 <BODY>
36415 <H1>S/MIME FEATURE: <!--#echo var="FEAT_smime-encrypt-by-default"--></H1>
36416
36417 <P>
36418 This feature only has an effect if your version of Alpine includes
36419 support for S/MIME.
36420 It affects Alpine's behavior when you send a message.
36421 If this option is set, the &quot;Encrypt&quot; option will default to ON when sending messages.
36422 <P>
36423 Only the default value is affected.
36424 In any case, you may still toggle the Encrypt option on or off before sending
36425 with the &quot;E Encrypt&quot; command (provided you have a the public digital ID
36426 for the recipient).
36427 <P>
36428 <UL>
36429 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36430 </UL><P>
36431 <P>
36432
36433 <UL>
36434 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36435 </UL><P>
36436 &lt;End of help on this topic&gt;
36437 </BODY>
36438 </HTML>
36439 ========== h_config_smime_remember_passphrase ==========
36440 <HTML>
36441 <HEAD>
36442 <TITLE>S/MIME FEATURE: <!--#echo var="FEAT_smime-remember-passphrase"--></TITLE>
36443 </HEAD>
36444 <BODY>
36445 <H1>S/MIME FEATURE: <!--#echo var="FEAT_smime-remember-passphrase"--></H1>
36446
36447 <P>
36448 This feature only has an effect if your version of Alpine includes
36449 support for S/MIME.
36450 If this option is set, you will only have to enter your passphrase for your private key
36451 once during an Alpine session.
36452 <P>
36453 <UL>
36454 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36455 </UL><P>
36456 <P>
36457
36458 <UL>
36459 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36460 </UL><P>
36461 &lt;End of help on this topic&gt;
36462 </BODY>
36463 </HTML>
36464 ====== h_config_smime_transfer_pub_to_con =====
36465 <HTML>
36466 <HEAD>
36467 <TITLE>S/MIME: Transfer Public Certs to Container</TITLE>
36468 </HEAD>
36469 <BODY>
36470 <H1>S/MIME: Transfer Public Certs to Container</H1>
36471
36472 <P>
36473 The Transfer command will copy the public certificates in your configured
36474 <A HREF="h_config_smime_pubcertdir"><!--#echo var="VAR_smime-public-cert-directory"--></A>
36475 to the container in your configured
36476 <A HREF="h_config_smime_pubcertcon"><!--#echo var="VAR_smime-public-cert-container"--></A>.
36477 This might be useful if you decide to switch from using a cert directory to a cert
36478 container.
36479 <P>
36480 Warning: Any previous contents in the container will be lost.
36481 <P>
36482 <UL>
36483 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36484 </UL><P>
36485 <P>
36486 <UL>
36487 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36488 </UL><P>
36489 &lt;End of help on this topic&gt;
36490 </BODY>
36491 </HTML>
36492 ====== h_config_smime_transfer_pub_to_dir =====
36493 <HTML>
36494 <HEAD>
36495 <TITLE>S/MIME: Transfer Public Certs to Directory</TITLE>
36496 </HEAD>
36497 <BODY>
36498 <H1>S/MIME: Transfer Public Certs to Directory</H1>
36499
36500 <P>
36501 The Transfer command will copy the public certificates in your configured
36502 <A HREF="h_config_smime_pubcertcon"><!--#echo var="VAR_smime-public-cert-container"--></A>
36503 to the directory in your configured
36504 <A HREF="h_config_smime_pubcertdir"><!--#echo var="VAR_smime-public-cert-directory"--></A>.
36505 This might be useful if you decide to switch from using a cert container to a cert
36506 directory.
36507 <P>
36508 <UL>
36509 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36510 </UL><P>
36511 <P>
36512 <UL>
36513 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36514 </UL><P>
36515 &lt;End of help on this topic&gt;
36516 </BODY>
36517 </HTML>
36518 ====== h_config_smime_transfer_priv_to_con =====
36519 <HTML>
36520 <HEAD>
36521 <TITLE>S/MIME: Transfer Private Keys to Container</TITLE>
36522 </HEAD>
36523 <BODY>
36524 <H1>S/MIME: Transfer Private Keys to Container</H1>
36525
36526 <P>
36527 The Transfer command will copy the private keys in your configured
36528 <A HREF="h_config_smime_privkeydir"><!--#echo var="VAR_smime-private-key-directory"--></A>.
36529 to the container in your configured
36530 <A HREF="h_config_smime_privkeydir"><!--#echo var="VAR_smime-private-key-container"--></A>.
36531 This might be useful if you decide to switch from using a key directory to a key
36532 container.
36533 <P>
36534 Warning: Any previous contents in the container will be lost.
36535 <P>
36536 <UL>
36537 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36538 </UL><P>
36539 <P>
36540 <UL>
36541 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36542 </UL><P>
36543 &lt;End of help on this topic&gt;
36544 </BODY>
36545 </HTML>
36546 ====== h_config_smime_transfer_priv_to_dir =====
36547 <HTML>
36548 <HEAD>
36549 <TITLE>S/MIME: Transfer Private Keys to Directory</TITLE>
36550 </HEAD>
36551 <BODY>
36552 <H1>S/MIME: Transfer Private Keys to Directory</H1>
36553
36554 <P>
36555 The Transfer command will copy the private keys in your configured
36556 <A HREF="h_config_smime_privkeydir"><!--#echo var="VAR_smime-private-key-container"--></A>.
36557 to the directory in your configured
36558 <A HREF="h_config_smime_privkeydir"><!--#echo var="VAR_smime-private-key-directory"--></A>.
36559 This might be useful if you decide to switch from using a key container to a key
36560 directory.
36561 <P>
36562 <UL>
36563 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36564 </UL><P>
36565 <P>
36566 <UL>
36567 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36568 </UL><P>
36569 &lt;End of help on this topic&gt;
36570 </BODY>
36571 </HTML>
36572 ====== h_config_smime_transfer_cacert_to_con =====
36573 <HTML>
36574 <HEAD>
36575 <TITLE>S/MIME: Transfer CA Certs to Container</TITLE>
36576 </HEAD>
36577 <BODY>
36578 <H1>S/MIME: Transfer CA Certs to Container</H1>
36579
36580 <P>
36581 The Transfer command will copy the CA certificates in your configured
36582 <A HREF="h_config_smime_cacertdir"><!--#echo var="VAR_smime-cacert-directory"--></A>
36583 to the container in your configured
36584 <A HREF="h_config_smime_cacertcon"><!--#echo var="VAR_smime-cacert-container"--></A>.
36585 This might be useful if you decide to switch from using a CA cert directory to a CA cert
36586 container.
36587 <P>
36588 Warning: Any previous contents in the container will be lost.
36589 <P>
36590 <UL>
36591 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36592 </UL><P>
36593 <P>
36594 <UL>
36595 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36596 </UL><P>
36597 &lt;End of help on this topic&gt;
36598 </BODY>
36599 </HTML>
36600 ====== h_config_smime_transfer_cacert_to_dir =====
36601 <HTML>
36602 <HEAD>
36603 <TITLE>S/MIME: Transfer CA Certs to Directory</TITLE>
36604 </HEAD>
36605 <BODY>
36606 <H1>S/MIME: Transfer CA Certs to Directory</H1>
36607
36608 <P>
36609 The Transfer command will copy the CA certificates in your configured
36610 <A HREF="h_config_smime_cacertcon"><!--#echo var="VAR_smime-cacert-container"--></A>.
36611 to the directory in your configured
36612 <A HREF="h_config_smime_cacertdir"><!--#echo var="VAR_smime-cacert-directory"--></A>.
36613 This might be useful if you decide to switch from using a CA cert container to a CA cert
36614 directory.
36615 <P>
36616 <UL>
36617 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36618 </UL><P>
36619 <P>
36620 <UL>
36621 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36622 </UL><P>
36623 &lt;End of help on this topic&gt;
36624 </BODY>
36625 </HTML>
36626 ====== h_config_smime_transfer_pubcon_to_key =====
36627 <HTML>
36628 <HEAD>
36629 <TITLE>S/MIME: Transfer Public Certs to Keychain</TITLE>
36630 </HEAD>
36631 <BODY>
36632 <H1>S/MIME: Transfer Public Certs to Keychain</H1>
36633
36634 Mac OS X Alpine only.
36635 <P>
36636 The Transfer command will copy the public certificates in your configured
36637 <A HREF="h_config_smime_pubcertcon"><!--#echo var="VAR_smime-public-cert-container"--></A>
36638 to your default Mac OS X Keychain.
36639 This might be useful if you decide to switch from using a cert container to using
36640 the Keychain to store your public certs, which you may do by using the
36641 feature
36642 <A HREF="h_config_smime_pubcerts_in_keychain">S/MIME FEATURE: <!--#echo var="FEAT_publiccerts-in-keychain"--></A>.
36643 <P>
36644 <UL>
36645 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36646 </UL><P>
36647 <P>
36648 <UL>
36649 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36650 </UL><P>
36651 &lt;End of help on this topic&gt;
36652 </BODY>
36653 </HTML>
36654 ====== h_config_smime_transfer_pubkey_to_con =====
36655 <HTML>
36656 <HEAD>
36657 <TITLE>S/MIME: Transfer Public Certs to Keychain</TITLE>
36658 </HEAD>
36659 <BODY>
36660 <H1>S/MIME: Transfer Public Certs to Keychain</H1>
36661
36662 <P>
36663 The Transfer command will copy the public certificates in your configured
36664 <A HREF="h_config_smime_pubcertcon"><!--#echo var="VAR_smime-public-cert-container"--></A>
36665 to your default Mac OS X Keychain.
36666 This might be useful if you decide to switch from using a cert container to using
36667 the Keychain to store your public certs.
36668 <P>
36669 <UL>
36670 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36671 </UL><P>
36672 <P>
36673 <UL>
36674 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36675 </UL><P>
36676 &lt;End of help on this topic&gt;
36677 </BODY>
36678 </HTML>
36679 ====== h_config_smime_public_certificates =====
36680 <HTML>
36681 <HEAD>
36682 <TITLE>S/MIME: Manage Public Certificates</TITLE>
36683 </HEAD>
36684 <BODY>
36685 <H1>S/MIME: Manage Public Certificates</H1>
36686
36687 <P>
36688 This menu item allows you to manage your public certificates, this
36689 may include your own public certificate, but it normally includes
36690 certificates of people you correspond with. These certificates are
36691 saved by Alpine automatically when they are found in signed messages
36692 that you receive. This interface allows you to manage them, by
36693 giving you the option to delete them, or trust them (in the case
36694 of self-signed certificates).
36695
36696 <P>
36697 Please note that Alpine will not validate a message that was sent to you
36698 using a self-signed certificate, unless you decide to trust that certificate.
36699 Internally, a certificate is trusted by copying it to the
36700 <A HREF="h_config_smime_certificate_authorities">Certificate Authorities</A>
36701 collection. If you decide that you want to stop trusting a self-signed
36702 certificate, you must delete such certificate from such collection.
36703 <P>
36704 The <B>I</B> Import command available in this screen allows you to
36705 import a command to this collection.
36706 <P>
36707 <UL>
36708 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36709 </UL><P>
36710 <P>
36711 <UL>
36712 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36713 </UL><P>
36714 &lt;End of help on this topic&gt;
36715 </BODY>
36716 </HTML>
36717 ====== h_config_smime_private_keys =====
36718 <HTML>
36719 <HEAD>
36720 <TITLE>S/MIME: Manage Private Keys</TITLE>
36721 </HEAD>
36722 <BODY>
36723 <H1>S/MIME: Manage Private Keys</H1>
36724
36725 <P>
36726 This option allows you to manage your private key. Normally a person has only
36727 one key, in the same way that a person only has one valid passport, or ID card,
36728 at any given time. This option allows you to manage private keys. You can
36729 delete them or import them. Additionally, you can view information
36730 about your public certificate, such as the issuer and the dates of validity
36731 of such certificate, among others.
36732
36733 <P>
36734 If you have more than one e-mail address for which you want to use the
36735 same private key, you must add all those addresses to the private key at
36736 the moment that the key is generated. When you receive a signed message using
36737 a key generated for several e-mail addresses, Alpine will save a
36738 certificate for each e-mail address included in such certificate.
36739 <P>
36740 The <B>I</B> Import command available in this screen allows you to
36741 import a command to this collection.
36742 <P>
36743 <UL>
36744 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36745 </UL><P>
36746 <P>
36747 <UL>
36748 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36749 </UL><P>
36750 &lt;End of help on this topic&gt;
36751 </BODY>
36752 </HTML>
36753 ====== h_config_smime_certificate_authorities =====
36754 <HTML>
36755 <HEAD>
36756 <TITLE>S/MIME: Manage Certificate Authorities</TITLE>
36757 </HEAD>
36758 <BODY>
36759 <H1>S/MIME: Manage Certificate Authorities</H1>
36760
36761 <P>
36762 This collection contains certificates that are needed to validate the
36763 certificate of another person, and therefore contains certificates that
36764 you trust. Typically a certificate is signed by another entity, called a
36765 certificate authority. This option allows you to manage which certificates
36766 you trust, allowing you to import them and to delete them or view information
36767 about each certificate, such as the issuer and the dates of validity
36768 of such certificate.
36769 <P>
36770 The <B>I</B> Import command available in this screen allows you to
36771 import a command to this collection.
36772 <P>
36773 <UL>
36774 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36775 </UL><P>
36776 <P>
36777 <UL>
36778 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36779 </UL><P>
36780 &lt;End of help on this topic&gt;
36781 </BODY>
36782 </HTML>
36783 ====== h_config_smime_password_file_certificates =====
36784 <HTML>
36785 <HEAD>
36786 <TITLE>S/MIME: Manage Password File Certificates</TITLE>
36787 </HEAD>
36788 <BODY>
36789 <H1>S/MIME: Manage Password File Certificates</H1>
36790
36791 <P>
36792 This option allows you to manage the certificates that are used to
36793 encrypt and decrypt your password file. This is useful in case you
36794 want to change the certificates used to encrypt your password file.
36795 <P>
36796 Depending on the version of Alpine that you used for the first time
36797 to set this up, you might have had to enter a password to enter this
36798 screen. In the case that you did not enter a password to enter this
36799 screen, you should know two things that are important:
36800 <UL>
36801 <LI> If anyone takes control of your computer (for example, if you
36802 left it unattended) then that person can add a password to your
36803 password file and make it unreadable to you in the future.
36804 <LI> If anyone can access your computer (this includes remote access)
36805 then that person can steal your password file and decrypt it without
36806 your help. This gives access to that person to the same services you
36807 have access and such person can use your name to access that service.
36808 In particular, that person can try to hack into your service provider
36809 with your name on it, or that person could try to send spam with
36810 your name.
36811 </UL>
36812 <P> Needless to say, this is not advisable. You should keep your
36813 password file protected. In order to do so, all you need to do is use
36814 the &quot;Create Key&quot; command to create a key. Once you do this,
36815 Alpine will use that key, encrypted with the password used to create that
36816 key, to protect your password file.
36817 <P>
36818 In this screen you can import a new key to encrypt your password file,
36819 and read cryptographic information on your current key.
36820 <P>
36821 To import a new key press &quot;RETURN&quot; and enter the location of
36822 the new key. You will be asked to enter the password of the new key. If
36823 this part of the process is successful, Alpine will search for the
36824 certificate that matches that key. If your key is named
36825 &quot;your_email@address.com.key&quot;, then Alpine will look for your
36826 certificate in the same directory in the file named
36827 &quot;your_email@address.com.crt&quot;, otherwise it will look for it
36828 as part of your key (that is, it will look to see if your certificate
36829 is in the file &quot;your_email@address.com.key&quot;), if all of this
36830 fails, Alpine will ask you to enter the location of the certificate
36831 that matches the key you unlocked. If a certificate is found, it will be
36832 used, and in this case, the password file will be read, decrypted with the
36833 old key and encrypted with the new key. Once this is done, the new key and
36834 certificates are saved, and the old keys are permanently deleted.
36835 <P>
36836 Alpine does not create a backup of your password file, or your old keys
36837 that will be replaced. If you need to keep old copies, you will have to do
36838 this operation outside Alpine.
36839 <P>
36840 Observe that you can use this screen to remove the password for the key.
36841 As explained earlier, this is not advisable, but you can always restore the
36842 password to encrypt your password file by creating a new key.
36843 <P>
36844 Be safe and keep your password file encrypted with a password.
36845 <UL>
36846 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36847 </UL><P>
36848 <P>
36849 <UL>
36850 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36851 </UL><P>
36852 &lt;End of help on this topic&gt;
36853 </BODY>
36854 </HTML>
36855 ====== h_certificate_information =====
36856 <HTML>
36857 <HEAD>
36858 <TITLE>S/MIME: Certificate Information Screen</TITLE>
36859 </HEAD>
36860 <BODY>
36861 <H1>S/MIME: Certificate Information Screen</H1>
36862
36863 <P>
36864 The CERTIFICATE INFORMATION screen shows you information contained in a certificate
36865 such as its owner, e-mail address, issuer, and interval of validity,
36866 among others.
36867 <P>
36868 In the case of public certificates, this screen shows you if there was a
36869 failure when attempting to validate such message. If the certificate is
36870 self-signed, then the <B>T</B> Trust command will be available, which
36871 you can use to trust such certificate and make Alpine not fail validating
36872 signatures signed with such certificate.
36873 <P>
36874 You can also mark a certificate deleted, with the <B>D</B> command, or
36875 remove the deleted mark with the <B>U</B> undelete command.
36876 <P>
36877 In the case of your private key, Alpine shows you the information
36878 from your public key. Additionally, Alpine allows you to see public
36879 and private information about your key, with the <B>B</B> and
36880 <B>R</B> commands respectively.
36881 <UL>
36882 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36883 </UL><P>
36884 <P>
36885 <UL>
36886 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36887 </UL><P>
36888 &lt;End of help on this topic&gt;
36889 </BODY>
36890 </HTML>
36891 ====== h_config_smime_manage_public_menu =====
36892 <HTML>
36893 <HEAD>
36894 <TITLE>S/MIME: Menu of Commands to Manage Public Certificates</TITLE>
36895 </HEAD>
36896 <BODY>
36897 <H1>S/MIME: Commands that Manage Public Certificates</H1>
36898
36899 <P>
36900 This screen allows you to manage your public certificates.
36901 <P>
36902 The format of this screen is as follows. There are five fields: The
36903 leftmost field is normally empty, but it could contain the letter
36904 &quot;D&quot; to indicate that that certificate has been marked for
36905 deletion. The next field is the e-mail address of the owner of the
36906 certificate, shown in its entirety. The third and fourth field are the
36907 first and last day validity for that certificate, respectively. The date
36908 is displayed in the user's locale unless the option
36909 <A HREF="h_config_disable_index_locale_dates"><!--#echo var="FEAT_disable-index-locale-dates"--></A>
36910 is set. In this case, the month, day and year are represented by two
36911 digits, and the format used is mm/dd/yy. Finally, the fifth
36912 field is what can be displayed of the MD5 hash of the certificate. You can
36913 use any of the last three fields to distinguish between two certificates
36914 for the same owner.
36915 <P>
36916 Available commands in this screen and a short description of what they
36917 do follows.
36918 <UL>
36919 <LI> <B>I</B> Imports a public certificate to this collection.
36920 <LI> <B>V</B> View information about a certificate such as the name of the person the
36921 certificate was issued to, its dates of validity, and validity status.
36922 <LI> <B>D</B> Marks a certificate deleted.
36923 <LI> <B>U</B> Removes the deletion mark on a certificate.
36924 <LI> <B>X</B> Removes all certificates marked deleted permanently (cannot be undone).
36925 <LI> <B>T</B> This command is only available for self-signed certificates, and allows you to
36926 trust a certificate by copying it to the collection of trusted certificates.
36927 </UL>
36928 <P>
36929 All commands provide feedback to let you know about their success or failure.
36930 <P>
36931 <UL>
36932 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36933 </UL><P>
36934 <P>
36935 <UL>
36936 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36937 </UL><P>
36938 &lt;End of help on this topic&gt;
36939 </BODY>
36940 </HTML>
36941 ====== h_config_smime_manage_private_menu =====
36942 <HTML>
36943 <HEAD>
36944 <TITLE>S/MIME: Menu of Commands to Manage Private Keys</TITLE>
36945 </HEAD>
36946 <BODY>
36947 <H1>S/MIME: Commands that Manage Private Keys</H1>
36948
36949 <P>
36950 This screen allows you to manage your private key.
36951 <P>
36952 The format of this screen is as follows. There are five fields: The
36953 leftmost field is normally empty, but it could contain the letter
36954 &quot;D&quot; to indicate that that certificate has been marked for
36955 deletion. The next field is the e-mail address of the owner of the
36956 certificate, shown in its entirety. The third field is the first day of
36957 validity for that certificate; the fourth field in the last day that that
36958 certificate is valid, and the fifth field is what can be displayed of the
36959 MD5 hash of the public certificate corresponding to this private key. You
36960 can use any of the last three fields to distinguish between two
36961 certificates for the same owner.
36962 <P>
36963 Available commands and a short description of what they do follows.
36964 <UL>
36965 <LI> <B>I</B> Imports a new public key to this collection.
36966 <LI> <B>V</B> View information about the public certificate corresponding to this
36967 key.
36968 <LI> <B>D</B> Marks a key to be deleted.
36969 <LI> <B>U</B> Removes the deletion mark on a key.
36970 <LI> <B>X</B> Removes all keys marked deleted permanently (cannot be undone).
36971 Note that expunging a private key does not remove the public key, which must
36972 be removed separately.
36973 </UL>
36974 <P>
36975 All commands provide feedback to let you know about their success or failure.
36976 <P>
36977 <UL>
36978 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
36979 </UL><P>
36980 <P>
36981 <UL>
36982 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
36983 </UL><P>
36984 &lt;End of help on this topic&gt;
36985 </BODY>
36986 </HTML>
36987 ====== h_config_smime_manage_cacerts_menu =====
36988 <HTML>
36989 <HEAD>
36990 <TITLE>S/MIME: Menu of Commands to Manage Certificate Authorities</TITLE>
36991 </HEAD>
36992 <BODY>
36993 <H1>S/MIME: Commands that Manage Certificate Authorities</H1>
36994
36995 <P>
36996 This screen allows you to manage your collection of certificates that you
36997 trust.
36998 <P>
36999 The format of this screen is as follows. There are five fields: The
37000 leftmost field is normally empty, but it could contain the letter
37001 &quot;D&quot; to indicate that that certificate has been marked for
37002 deletion. The next field is the e-mail address of the owner of the
37003 certificate, shown in its entirety. The third field is the first day of
37004 validity for that certificate; the fourth field in the last day that that
37005 certificate is valid, and the fifth field is what can be displayed of the
37006 MD5 hash of the certificate. You can use any of the last three fields to
37007 distinguish between two certificates for the same owner.
37008 <P>
37009 Available commands and a short description of what they do follows.
37010 <UL>
37011 <LI> <B>I</B> Imports a trusted certificate to this collection. This is
37012 done by reading the certificate and validating it. Once a certificate
37013 is found to be valid, it is saved, adding the extension &quot;.crt&quot;
37014 to the certificate, if necessary.
37015 <LI> <B>V</B> View information about this certificate, such as its issuer
37016 and validity dates.
37017 <LI> <B>D</B> Marks a certificate to be deleted.
37018 <LI> <B>U</B> Removes the deletion mark on a certificate.
37019 <LI> <B>X</B> Removes all certificates marked deleted permanently (cannot be undone).
37020 </UL>
37021 <P>
37022 All commands provide feedback to let you know about their success or failure.
37023 <P>
37024 <UL>
37025 <LI><A HREF="h_mainhelp_smime">General S/MIME help</A>
37026 </UL><P>
37027 <P>
37028 <UL>
37029 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37030 </UL><P>
37031 &lt;End of help on this topic&gt;
37032 </BODY>
37033 </HTML>
37034 ====== h_config_lame_list_mode =====
37035 <HTML>
37036 <HEAD>
37037 <TITLE>FEATURE: <!--#echo var="FEAT_enable-lame-list-mode"--></TITLE>
37038 </HEAD>
37039 <BODY>
37040 <H1>FEATURE: <!--#echo var="FEAT_enable-lame-list-mode"--></H1>
37041
37042 This feature modifies the method Alpine uses to ask your IMAP
37043 server for folder names to display in the FOLDER LIST screen.
37044 It is intended to compensate for a small set of IMAP servers that
37045 are programmed to ignore a part of the request, and thus respond
37046 to Alpine's query with nonsensical results.
37047 <P>
37048
37049 If you find that Alpine is erroneously displaying blank folder lists,
37050 try enabling this feature.
37051 <P>
37052
37053 NOTE: Enabling this feature has consequences for the Goto and Save
37054 commands.  Many servers allow access to folders outside the area
37055 reserved for your personal folders via some reserved character,
37056 typically '#' (sharp), '~' (tilde) or '/' (slash).  This mechanism
37057 allows, at the Goto and Save prompts, quick access to folders
37058 outside your personal folder collection without requiring a specific
37059 collection definition.  This behavior will generally not be available
37060 when this feature is enabled.
37061
37062 <P>
37063 <UL>
37064 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37065 </UL><P>
37066 &lt;End of help on this topic&gt;
37067 </BODY>
37068 </HTML>
37069 ====== h_config_enable_mulnewsrcs =====
37070 <HTML>
37071 <HEAD>
37072 <TITLE>FEATURE: <!--#echo var="FEAT_enable-multiple-newsrcs"--></TITLE>
37073 </HEAD>
37074 <BODY>
37075 <H1>FEATURE: <!--#echo var="FEAT_enable-multiple-newsrcs"--></H1>
37076
37077 This feature makes it so Alpine can use multiple newsrcs based on
37078 the news server being connected to, which allows for separate lists
37079 of subscribed-to newsgroups. When this feature is not set, there is only
37080 one list of newsgroups.
37081 <P>
37082 Under this feature, the name of a newsrc is based on the news server.
37083 For example, if your <a href="h_config_newsrc_path"><!--#echo var="VAR_newsrc-path"--></a>
37084 is set to &quot;.newsrc&quot;, and the news server you are connecting to is
37085 news.example.com, then the newsrc to be used is .newsrc-news.example.com.
37086 Setting this feature for the first time will allow for the option of using
37087 your old newsrc the next time you read news.
37088 <P>
37089 If this feature is set, then the feature
37090 <A HREF="h_config_mulnews_as_typed"><!--#echo var="FEAT_mult-newsrc-hostnames-as-typed"--></A>
37091 also may affect the name of the newsrc file that is used.
37092 <P>
37093 <UL>
37094 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37095 </UL><P>
37096 &lt;End of help on this topic&gt;
37097 </BODY>
37098 </HTML>
37099 ======= h_ab_export_vcard =======
37100 <HTML>
37101 <HEAD>
37102 <TITLE>Address Book Export Format</TITLE>
37103 </HEAD>
37104 <BODY>
37105 <H1>Address Book Export Format</H1>
37106
37107 You are exporting address book data from Alpine to a file outside of Alpine.
37108 You are being asked to choose the format of the export.
37109 Here are the choices:
37110
37111 <DL>
37112 <DT><EM>A</EM>ddress List</DT>
37113 <DD>
37114 The addresses from the address book entries you are saving
37115 from will be saved one address per line.
37116 Address book lists (those with more than one address) will have
37117 all of their addresses saved separately.
37118 </DD>
37119
37120 <DT><EM>V</EM>Card</DT>
37121 <DD>
37122 The entries will be saved in
37123 <A HREF="h_whatis_vcard">vCard</A> format.
37124 </DD>
37125
37126 <DT><EM>T</EM>ab Separated</DT>
37127 <DD>
37128 The entries will be saved in tab-separated columns.
37129 There will be just 4 columns of data that correspond to Alpine's
37130 Nickname field, Full Name field, Address field, and Comment field.
37131 It might prove useful to Select only the Simple, non-List address book
37132 entries before Saving.
37133 </DD>
37134
37135 <DT><EM>^C</EM> Cancel</DT>
37136 <DD>
37137 Cancel out of the Save.
37138 </DD>
37139
37140 </DL>
37141
37142
37143 <P>
37144 &lt;End of help on this topic&gt;
37145 </BODY>
37146 </HTML>
37147 ====== h_config_predict_nntp_server =====
37148 <HTML>
37149 <HEAD>
37150 <TITLE>FEATURE: <!--#echo var="FEAT_predict-nntp-server"--></TITLE>
37151 </HEAD>
37152 <BODY>
37153 <H1>FEATURE: <!--#echo var="FEAT_predict-nntp-server"--></H1>
37154
37155 This feature allows Alpine to assume that the open NNTP server at the
37156 time of composition is the NNTP server to which the message should be
37157 posted.  This is especially recommended when there are multiple News
37158 collections.  If this feature is not set, Alpine will try to post to the first server in
37159 the <a href="h_config_nntp_server"><!--#echo var="VAR_nntp-server"--></a> variable.  Setting
37160 this feature also negates the need to add News collection servers to
37161 the <!--#echo var="VAR_nntp-server"--> variable.
37162 <P>
37163 This feature can be especially handy when used in conjunction with
37164 <a href="h_config_enable_mulnewsrcs"><!--#echo var="FEAT_enable-multiple-newsrcs"--></a>.
37165 <P>
37166 <UL>
37167 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37168 </UL><P>
37169 &lt;End of help on this topic&gt;
37170 </BODY>
37171 </HTML>
37172 ====== h_config_nntp_search_uses_overview =====
37173 <HTML>
37174 <HEAD>
37175 <TITLE>FEATURE: <!--#echo var="FEAT_nntp-search-uses-overview"--></TITLE>
37176 </HEAD>
37177 <BODY>
37178 <H1>FEATURE: <!--#echo var="FEAT_nntp-search-uses-overview"--></H1>
37179
37180 This feature should probably be turned on unless it causes trouble.
37181 The results of the NNTP overview command (XOVER) may be used to help
37182 with some searches in news groups.
37183 It should result in quicker response time.
37184 Turning this feature on apparently causes search results which are
37185 different from what you would get with the feature turned off on some
37186 servers.
37187 <P>
37188 <UL>
37189 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37190 </UL><P>
37191 &lt;End of help on this topic&gt;
37192 </BODY>
37193 </HTML>
37194 ====== h_config_thread_sorts_by_arrival =====
37195 <HTML>
37196 <HEAD>
37197 <TITLE>FEATURE: <!--#echo var="FEAT_thread-sorts-by-arrival"--></TITLE>
37198 </HEAD>
37199 <BODY>
37200 <H1>FEATURE: <!--#echo var="FEAT_thread-sorts-by-arrival"--></H1>
37201
37202 This feature affects how a threading sort arranges threads.  The default way
37203 to arrange threads is by the date of the earliest message in the thread.
37204 This feature arranges threads by the last message to arrive in a thread.
37205 <P>
37206 This feature causes old threads that get recent messages to sort to the bottom,
37207 where previously a message arrival to a thread would not rearrange the order of
37208 that thread.
37209 <P>
37210 <UL>
37211 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37212 </UL><P>
37213 &lt;End of help on this topic&gt;
37214 </BODY>
37215 </HTML>
37216 ====== h_config_textplain_int =====
37217 <HTML>
37218 <HEAD>
37219 <TITLE>FEATURE: <!--#echo var="FEAT_show-plain-text-internally"--></TITLE>
37220 </HEAD>
37221 <BODY>
37222 <H1>FEATURE: <!--#echo var="FEAT_show-plain-text-internally"--></H1>
37223
37224 This feature modifies the method Alpine uses to display Text/Plain
37225 MIME attachments from the Attachment Index screen.  Normally, the
37226 &quot;View&quot; command searches for any externally defined (usually
37227 via the
37228 &quot;<A HREF="h_config_mailcap_path">Mailcap</A>&quot; file) viewer,
37229 and displays the selected text within that viewer.
37230
37231 <P>
37232 Enabling this feature causes Alpine to ignore any external viewer
37233 settings and always display text with Alpine's internal viewer.
37234
37235 <P>
37236 <UL>
37237 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37238 </UL><P>
37239 &lt;End of help on this topic&gt;
37240 </BODY>
37241 </HTML>
37242 ====== h_config_wp_columns =====
37243 <HTML>
37244 <HEAD>
37245 <TITLE>WEB ALPINE OPTION: <!--#echo var="VAR_wp-columns"--></TITLE>
37246 </HEAD>
37247 <BODY>
37248 <H1>WEB ALPINE OPTION: <!--#echo var="VAR_wp-columns"--></H1>
37249
37250 Web Alpine only.
37251 <P>
37252 This configuration setting specifies the number of horizontal characters
37253 used to format various WebAlpine pages.  Smaller values will tend to reduce
37254 the amount of horizontal scrolling required to view pages within narrow
37255 browsers, such as those found on PDAs, and larger values will tend to
37256 spread more information across the page.
37257
37258 <P>
37259 The Message List page uses the width to determine how many characters
37260 to assign each field.  Note, a smaller value may result in a disproportionate
37261 amount of blank space between fields on each line.  Similarly, a large
37262 value may result in cramped fields or horizontal scrolling.
37263
37264 <P>
37265 The Message View page uses this value to determine when to wrap lines
37266 in displayed message text.  Note, a smaller value may result in jagged
37267 right margins or confusing quoting.  A larger value may cause lines of text to
37268 run beyond the browser's right edge, requiring horizontal scrolling.
37269
37270 <P>
37271 <UL>
37272 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37273 </UL><P>
37274 &lt;End of help on this topic&gt;
37275 </BODY>
37276 </HTML>
37277 ====== h_config_wp_state =====
37278 <HTML>
37279 <HEAD>
37280 <TITLE>WEB ALPINE OPTION: <!--#echo var="VAR_wp-state"--></TITLE>
37281 </HEAD>
37282 <BODY>
37283 <H1>WEB ALPINE OPTION: <!--#echo var="VAR_wp-state"--></H1>
37284
37285 Web Alpine only.
37286 <P>
37287 Various aspects of cross-session state.
37288
37289 <P>
37290 <UL>
37291 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37292 </UL><P>
37293 &lt;End of help on this topic&gt;
37294 </BODY>
37295 </HTML>
37296 ====== h_config_wp_aggstate =====
37297 <HTML>
37298 <HEAD>
37299 <TITLE>WEB ALPINE OPTION: <!--#echo var="VAR_wp-aggstate"--></TITLE>
37300 </HEAD>
37301 <BODY>
37302 <H1>WEB ALPINE OPTION: <!--#echo var="VAR_wp-aggstate"--></H1>
37303
37304 Web Alpine only.
37305 <P>
37306 Aggregate operations tab state.
37307
37308 <P>
37309 <UL>
37310 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37311 </UL><P>
37312 &lt;End of help on this topic&gt;
37313 </BODY>
37314 </HTML>
37315 ====== h_config_wp_indexlines =====
37316 <HTML>
37317 <HEAD>
37318 <TITLE>WEB ALPINE OPTION: <!--#echo var="VAR_wp-indexlines"--></TITLE>
37319 </HEAD>
37320 <BODY>
37321 <H1>WEB ALPINE OPTION: <!--#echo var="VAR_wp-indexlines"--></H1>
37322
37323 Web Alpine only.
37324 <P>
37325 Number of index lines in table.
37326
37327 <P>
37328 <UL>
37329 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37330 </UL><P>
37331 &lt;End of help on this topic&gt;
37332 </BODY>
37333 </HTML>
37334 ====== h_config_wp_indexheight =====
37335 <HTML>
37336 <HEAD>
37337 <TITLE>WEB ALPINE OPTION: <!--#echo var="VAR_wp-indexheight"--></TITLE>
37338 </HEAD>
37339 <BODY>
37340 <H1>WEB ALPINE OPTION: <!--#echo var="VAR_wp-indexheight"--></H1>
37341
37342 Web Alpine only.
37343 <P>
37344 Index table row height.
37345
37346 <P>
37347 <UL>
37348 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37349 </UL><P>
37350 &lt;End of help on this topic&gt;
37351 </BODY>
37352 </HTML>
37353 ====== h_config_rss_news =====
37354 <HTML>
37355 <HEAD>
37356 <TITLE>WEB ALPINE OPTION: <!--#echo var="VAR_rss_news"--></TITLE>
37357 </HEAD>
37358 <BODY>
37359 <H1>WEB ALPINE OPTION: <!--#echo var="VAR_rss-news"--></H1>
37360
37361 Web Alpine only.
37362 <P>
37363 RSS News feed.
37364
37365 <P>
37366 <UL>
37367 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37368 </UL><P>
37369 &lt;End of help on this topic&gt;
37370 </BODY>
37371 </HTML>
37372 ====== h_config_rss_weather =====
37373 <HTML>
37374 <HEAD>
37375 <TITLE>WEB ALPINE OPTION: <!--#echo var="VAR_rss-weather"--></TITLE>
37376 </HEAD>
37377 <BODY>
37378 <H1>WEB ALPINE OPTION: <!--#echo var="VAR_rss-weather"--></H1>
37379
37380 Web Alpine only.
37381 <P>
37382 RSS Weather feed.
37383
37384 <P>
37385 <UL>
37386 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37387 </UL><P>
37388 &lt;End of help on this topic&gt;
37389 </BODY>
37390 </HTML>
37391 ====== h_config_send_confirms_only_expanded =====
37392 <HTML>
37393 <HEAD>
37394 <TITLE>FEATURE: send-confirms-only-expanded</TITLE>
37395 </HEAD>
37396 <BODY>
37397 <H1>FEATURE: send-confirms-only-expanded (Web Alpine Only)</H1>
37398
37399 This Web Alpine option specifies whether or not a Send confirmations
37400 happens when a composed message is readied for sending or not.  The
37401 default behavior is to not confirm that the nicknames were expanded to
37402 the intended addresses.
37403
37404 <P>
37405 <UL>
37406 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37407 </UL><P>
37408 &lt;End of help on this topic&gt;
37409 </BODY>
37410 </HTML>
37411 ====== h_config_enable_jump_command =====
37412 <HTML>
37413 <HEAD>
37414 <TITLE>FEATURE: enable-jump-command</TITLE>
37415 </HEAD>
37416 <BODY>
37417 <H1>FEATURE: enable-jump-command (Web Alpine Only)</H1>
37418
37419 This Web Alpine option specifies whether or not a Jump command is
37420 offered in the Message List and Message View pages.  The command is
37421 implemented as an input field in the left column of the List and View
37422 screens.
37423
37424 <P>
37425 When enabled and a number is entered in the input field while the
37426 Message List is displayed, the Message List is reframed with the
37427 specified message.  While viewing a message, the message associated
37428 with the specified message number is displayed.
37429
37430 <P>
37431 <UL>
37432 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37433 </UL><P>
37434 &lt;End of help on this topic&gt;
37435 </BODY>
37436 </HTML>
37437 ====== h_config_enable_newmail_sound =====
37438 <HTML>
37439 <HEAD>
37440 <TITLE>FEATURE: enable-newmail-sound</TITLE>
37441 </HEAD>
37442 <BODY>
37443 <H1>FEATURE: enable-newmail-sound (Web Alpine Only)</H1>
37444
37445 This Web Alpine option specifies whether or not a sound file is sent
37446 to the web browser along with the newmail notification message.
37447
37448
37449 <P>
37450 <UL>
37451 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37452 </UL><P>
37453 &lt;End of help on this topic&gt;
37454 </BODY>
37455 </HTML>
37456 ====== h_config_render_html_internally =====
37457 <HTML>
37458 <HEAD>
37459 <TITLE>FEATURE: render-html-internally</TITLE>
37460 </HEAD>
37461 <BODY>
37462 <H1>FEATURE: render-html-internally (Web Alpine Only)</H1>
37463
37464 By default, Web Alpine will pass cleansed HTML text you receive in messages
37465 to the browser for display (rendering).  This feature causes Web Alpine to convert
37466 the HTML text into plain text in the same way Unix and PC-Alpine do.
37467
37468
37469 <P>
37470 <UL>
37471 <LI><A HREF="h_finding_help">Finding more information and requesting help</A>
37472 </UL><P>
37473 &lt;End of help on this topic&gt;
37474 </BODY>
37475 </HTML>
37476 ====== h_config_role_undo =====
37477 Yes, remember changes and exit back to list of roles; No, discard changes
37478 made in this screen; ^C, cancel exit and stay in this config screen.
37479 ====== h_exit_editor =====
37480 S, save changes and exit from the editor; D, do not save changes but
37481 do exit from the editor; or ^C, cancel exit and stay in the editor.
37482 ====== h_config_undo =====
37483 Yes, save changes and exit; No, exit without saving any changes made since
37484 entering this CONFIGURATION screen; ^C, cancel exit and stay in config screen.
37485 ====== h_os_index_whereis =====
37486 Enter ^V or ^Y to go immediately to the last or first message in the index.
37487 Or, enter the match string followed by RETURN.
37488 ====== h_os_index_whereis_agg =====
37489 Enter ^V or ^Y to go immediately to the last or first message in the index,
37490 Or, enter the match string followed by RETURN (or ^X to select all matches).
37491 =========== h_oe_add_full ==================
37492 Type the full name of the person being added and press the RETURN key.
37493 Press ^C to cancel addition.
37494 =========== h_oe_add_nick ==================
37495 Type a short nickname and press RETURN.  A nickname is a short easy-to-
37496 remember word, name or initials like "joe", or "wcfields."  ^C to cancel.
37497 ========== h_oe_add_addr ================
37498 Type the e-mail address and press RETURN.
37499 Press ^C to cancel addition.
37500 ========== h_oe_crlst_full ==============
37501 Type a long name or description for the list that you are creating and
37502 press RETURN.  Press ^C to cancel creation of list.
37503 =========== h_oe_crlst_nick =============
37504 Type a nickname (short, easy-to-remember name or single word) for the list
37505 you are creating and press RETURN.  Press ^C to cancel.
37506 ========== h_oe_crlst_addr ==============
37507 Type an e-mail address, or a nickname already in the address book that you
37508 want to be part of this list and press RETURN.
37509 ========== h_oe_adlst_addr =============
37510 Type an e-mail address or a nickname already in the address book that you
37511 want to add to this list and press RETURN.
37512 ========== h_oe_editab_nick ============
37513 Change the nickname using the arrow keys and delete key.  Press RETURN
37514 when done.  Press ^C to cancel editing and leave the nickname as it was.
37515 ========== h_oe_editab_full ============
37516 Change the full name using the arrow keys and delete key.  Press RETURN
37517 when done.  Press ^C to cancel editing and leave the full name as it was.
37518 ========== h_oe_editab_addr ============
37519 Change the address using the arrow keys and delete key.  Press RETURN
37520 when done.  Press ^C to cancel editing and leave the address as it was.
37521 ========== h_oe_editab_fcc ============
37522 Change the fcc using the arrow keys and delete key.  Press RETURN when
37523 done.  Press ^C to cancel editing and leave the fcc as it was.
37524 ========== h_oe_editab_comment ============
37525 Change the comment field using the arrow keys and delete key.  Press RETURN
37526 when done.  Press ^C to cancel editing and leave the comment as it was.
37527 ====== h_ab_forward =====
37528 Yes, expand nicknames and qualify local names with your current domain name;
37529 No, leave nicknames and local names as is;  ^C, cancel.
37530 ========== h_ab_export ==========
37531 Type the name of a file to write the addresses into and
37532 press RETURN.  You may also specify an absolute path.  Use ^C to cancel.
37533 ========== h_ab_edit_a_field ==========
37534 Edit any of the fields of the currently selected entry by typing one of the
37535 letters at the bottom of the screen.  Press ^C to cancel edit.
37536 ====== h_ab_del_data_revert =====
37537 Press B to completely delete addrbook and revert to default, C to delete config
37538 and revert while leaving data, or D to only delete data (make it empty).
37539 ====== h_ab_del_data_modify =====
37540 Press B to completely delete addrbook, C to delete configuration while leaving
37541 data, or D to delete data (make it empty) but leave config. ^C to cancel.
37542 ====== h_ab_del_config_modify =====
37543 Yes, remove this address book from my configuration.
37544 No, make no changes now.
37545 ====== h_ab_del_config_revert =====
37546 Yes, remove this address book from my config and revert to default.
37547 No, make no changes now.
37548 ====== h_ab_del_default =====
37549 Yes, remove this default address book from my configuration.
37550 No, make no changes now.
37551 ====== h_ab_really_delete =====
37552 Yes, delete the actual contents of the address book, not just the
37553 configuration.  No, don't delete the data after all, cancel and start over.
37554 ====== h_ab_del_ignore =====
37555 Press I to ignore all the default address books for this category.  Press R to
37556 remove this one address book and add the others to your personal list.
37557 ====== h_ab_del_dir_ignore =====
37558 Press I to ignore all the default directory servers for this category.
37559 Press R to remove this one server and add the others to your personal list.
37560 ====== h_ab_copy_dups =====
37561 Yes, overwrite the existing entry.
37562 No, skip duplicates but save the rest. Press ^C to cancel.
37563 ====== h_confirm_cancel =====
37564 Type C to Confirm that you want to abandon the message you are composing.
37565 Type N or ^C to cancel out of the cancel and keep composing.
37566 ====== h_ab_text_or_vcard =====
37567 Text, start composer with displayed text already included.
37568 VCard, start composer with address book entry attached as a vCard. ^C cancels.
37569 ====== h_ab_backup_or_ldap =====
37570 Backup, copy email address from entry and allow editing of it.
37571 LDAP, copy LDAP search criteria, do not allow editing of it. ^C cancels.
37572 ====== h_ldap_text_or_vcard =====
37573 Text: export displayed text for selected entry. Address: export only the
37574 email address. VCard: export entry in vCard format. ^C cancels.
37575 ====== h_ab_save_exp =====
37576 Save, save entry or entries to an address book.
37577 Export, save to file outside of pine. ^C cancels save.
37578 ====== h_ab_add =====
37579 A, add a brand new entry to this address book.
37580 E, edit the entry that is currently highlighted. ^C to cancel.
37581 ====== h_ab_shuf =====
37582 U, swap order of highlighted address book and the one above it.
37583 D, swap order of highlighted address book and the one below it. ^C to cancel.
37584 ====== h_ab_shuf_up =====
37585 U, swap order of highlighted address book and the one above it.
37586 Press ^C to cancel.
37587 ====== h_ab_shuf_down =====
37588 D, swap order of highlighted address book and the one below it.
37589 Press ^C to cancel.
37590 ====== h_folder_prop =====
37591 Count is # of messages in the folder, Unseen means messages that have not
37592 been read, New means messages that were Recently added to the folder.
37593 ====== h_role_shuf =====
37594 U, swap order of highlighted rule and the one above it.
37595 D, swap order of highlighted rule and the one below it. ^C to cancel.
37596 ====== h_role_shuf_up =====
37597 U, swap order of highlighted rule and the one above it.
37598 Press ^C to cancel.
37599 ====== h_role_shuf_down =====
37600 D, swap order of highlighted rule and the one below it.
37601 Press ^C to cancel.
37602 ====== h_incoming_shuf =====
37603 B, swap order of highlighted directory and the one before it.
37604 F, swap order of highlighted directory and the one after it. ^C to cancel.
37605 ====== h_incoming_shuf_up =====
37606 B, swap order of highlighted directory and the one before it.
37607 Press ^C to cancel.
37608 ====== h_incoming_shuf_down =====
37609 F, swap order of highlighted directory and the one after it.
37610 Press ^C to cancel.
37611 ====== h_dir_shuf =====
37612 U, swap order of highlighted directory and the one above it.
37613 D, swap order of highlighted directory and the one below it. ^C to cancel.
37614 ====== h_dir_shuf_up =====
37615 U, swap order of highlighted directory and the one above it.
37616 Press ^C to cancel.
37617 ====== h_dir_shuf_down =====
37618 D, swap order of highlighted directory and the one below it.
37619 Press ^C to cancel.
37620 ====== h_hdrcolor_shuf =====
37621 U, swap order of highlighted Header Color and the one above it.
37622 D, swap order of highlighted Header Color and the one below it. ^C to cancel.
37623 ====== h_hdrcolor_shuf_up =====
37624 U, swap order of highlighted Header Color and the one above it.
37625 Press ^C to cancel.
37626 ====== h_hdrcolor_shuf_down =====
37627 D, swap order of highlighted Header Color and the one below it.
37628 Press ^C to cancel.
37629 ========== h_oe_editab_al ============
37630 Change the address using the arrow keys and delete key.  Press RETURN
37631 when done.  Press ^C to cancel editing and leave the address as it was.
37632 ========== h_dir_comp_search ===============
37633 Type a string to look for just like you would in the composer. Your configured
37634 rules for the servers with the implicit flag set will be used.
37635 ========== h_oe_searchab ===============
37636 Type the word or name you want to search for and press RETURN.  If you press
37637 RETURN without entering anything the word in [] will be searched for.
37638 ========== h_oe_chooseabook ==========
37639 Choose the address book you want to save the new entry in.
37640 Use ^N or ^P to change address books.  ^C to cancel.
37641 ========== h_oe_takeaddr ==========
37642 Edit the e-mail address using the arrow and delete keys.  Press RETURN
37643 when done.  Press ^C to cancel adding this entry to the address book.
37644 ========== h_oe_take_replace ==========
37645 Press R to replace the old entry with this new data.  You will still have
37646 another chance to cancel.  N to enter another nickname.  ^C to cancel now.
37647 ========== h_oe_take_replace_or_add ==========
37648 Press R to replace the old entry.  Press A to add the selected addresses to
37649 the old existing list.  N to enter another nickname. ^C to cancel now.
37650 ========== h_oe_takename ==========
37651 Edit the full name to be correct using the arrow and delete keys.  Press RETURN
37652 when done.  Press ^C to cancel adding this entry to the address book.
37653 ========== h_oe_takenick ==========
37654 Type a nickname (short easy-to-remember name, initials or single word) for this
37655 entry in the address book and press RETURN.  Press ^C to cancel addition.
37656 ========== h_oe_jump ==========
37657 Type the message number you want to jump to and press RETURN.  The word "end"
37658 represents the last message. Press ^C to cancel jumping to another message.
37659 ========== h_oe_jump_thd ==========
37660 Type the thread number you want to jump to and press RETURN.  The word "end"
37661 represents the last thread. Press ^C to cancel jumping to another thread.
37662 ========== h_oe_debuglevel ==========
37663 Higher number shows more debugging details.
37664 Press ^C if you want to cancel the change.
37665 ========== h_oe_broach ==========
37666 Type the name of the folder you want to open and press RETURN.  Press ^P/^N
37667 to go to the previous/next collections in the list.  Press ^C to cancel goto.
37668 ========== h_oe_foldsearch ==========
37669 Type the text you want to search for in foldernames and press RETURN.  If you
37670 press RETURN without entering anything, any text in [] will be searched for.
37671 ========== h_oe_foldrename ==========
37672 Change the old name of the folder to the new name using the arrow and
37673 delete keys and press RETURN.  Press ^C to cancel rename.
37674 ========== h_oe_login ==========
37675 Enter your login name for the host you are opening the mailbox on.  Just press
37676 RETURN to use your login from this host as is, or edit it with delete key.
37677 ========== h_oe_passwd ==========
37678 Type your password for the host and login shown as part of the prompt.
37679 Press ^C to cancel opening folder.
37680 ========== h_oe_choosep ==========
37681 Enter the number associated with the printer you want to select.  Press ^C to
37682 cancel the printer selection.  The current selection is highlighted.
37683 ========== h_oe_customp ==========
37684 Type the name of the Unix print command and press RETURN.  Press ^C to
37685 cancel the printer selection.
37686 ========== h_oe_searchview ==========
37687 Type the word or name you want to search for and press RETURN.  If you press
37688 RETURN without entering anything the word in [] will be searched for.
37689 ========== h_oe_keylock ==========
37690 The keyboard is in use and locked by another user.  Only that user can
37691 unlock this keyboard by typing the password.
37692 ========== h_wt_expire ==========
37693 At the beginning of each month Alpine offers to rename your current sent-mail
37694 folder to one named for the month so you have a sent-mail folder for each month
37695 ========== h_wt_delete_old ==========
37696 It is the beginning of the month, and we need to conserve disk
37697 space.  Please delete any sent-mail that you do not need.
37698 ========== h_select_sort ==========
37699 Select the order for sorting the index by typing the capitalized letter.
37700 Arrival is by arrival in your mailbox; Date is by time/day message was sent.
37701 ========== h_no_F_arg ============
37702 Enter name of file to be opened.
37703
37704 ========== h_sticky_personal_name ==========
37705 Type in your name as you want it to appear on outgoing email.  This entry
37706 will be saved into your Alpine configuration file.
37707 ========== h_sticky_inbox ============
37708 INBOX syntax is usually {complete.machine.name}INBOX
37709 This entry will be saved in your Alpine configuration file.
37710 ========== h_sticky_smtp ============
37711 The name of the computer on your campus that relays your outgoing email
37712 to the Internet.  This entry will be saved in your Alpine configuration file.
37713 ========== h_sticky_user_id ==========
37714 The username or login-id part of your email address.  This entry will be
37715 saved in your Alpine configuration file.
37716 ========== h_sticky_domain ==========
37717 The domain part of your email address, NOT the name of your PC.  This
37718 entry will be saved in your Alpine configuration file.
37719 ========== h_bounce =========
37720 Enter the address or nickname of the intended recipient.  Alpine will resend
37721 the message, which will retain the original author's From: address.
37722 ========== h_incoming_add_folder_nickname =========
37723 Enter an (optional) nickname that will be used in lieu of the actual
37724 host and folder names in the FOLDER LIST display.
37725 ========== h_anon_forward ==========
37726 Enter the address of your intended recipient, or ^C to cancel.
37727 Example: jsmith@somewhere.edu
37728 ========== h_news_subscribe ==========
37729 Enter the name of the newsgroup to which you wish to subscribe,
37730 or ^C to cancel.  Example: comp.mail.pine
37731 ========== h_pipe_msg ==========
37732 Enter the name of the Unix command to which you wish to send this
37733 message, or ^C to cancel.
37734 ========== h_pipe_attach ==========
37735 Enter the name of the Unix command to which you wish to send this
37736 attachment, or ^C to cancel.
37737 ========== h_select_by_num ==========
37738 Enter a list of message numbers (or number ranges), or ^C to cancel. "end"
37739 is the last message. "." is the current message. Example: 1-.,7-9,11,19,35-end
37740 ========== h_select_by_gm_content ==========
37741 Enter your search key in the same way that you would enter a search
37742 key in the web interface for Gmail.
37743 ========== h_select_by_thrdnum ==========
37744 Enter a list of message numbers (or number ranges), or ^C to cancel. "end"
37745 is the last message. "." is the current message. Example: 1-.,7-9,11,19,35-end
37746 ========== h_select_txt_from ==========
37747 Messages with From: headers containing the entered string will be selected.
37748 ^C to cancel. ^G again to see original options.
37749 ========== h_select_txt_not_from ==========
37750 Messages without From: headers containing the entered string will be selected.
37751 ^C to cancel. ^G again to see original options.
37752 ========== h_select_txt_to ==========
37753 Messages with To: headers containing the entered string will be selected.
37754 ^C to cancel. ^G again to see original options.
37755 ========== h_select_txt_not_to ==========
37756 Messages without To: headers containing the entered string will be selected.
37757 ^C to cancel. ^G again to see original options.
37758 ========== h_select_txt_cc ==========
37759 Messages with Cc: headers containing the entered string will be selected.
37760 ^C to cancel. ^G again to see original options.
37761 ========== h_select_txt_not_cc ==========
37762 Messages without Cc: headers containing the entered string will be selected.
37763 ^C to cancel. ^G again to see original options.
37764 ========== h_select_txt_subj ==========
37765 Messages with Subject: headers containing the entered string will be selected.
37766 ^C to cancel.  ^X enters Subject: line of current message.
37767 ========== h_select_txt_not_subj ==========
37768 Messages without Subject headers containing the entered string will be selected.
37769 ^C to cancel.  ^X enters Subject: line of current message.
37770 ========== h_select_txt_all ==========
37771 All messages containing the entered string will be selected.  Headers and body,
37772 but not encoded attachments, will be compared.  Enter ^C to cancel.
37773 ========== h_select_txt_not_all ==========
37774 All messages that don't contain the entered string will be selected.  Headers
37775 and body, but not encoded attachments, will be compared.  Enter ^C to cancel.
37776 ========== h_select_txt_body ==========
37777 All messages containing the entered string will be selected. Body text, but
37778 not headers or encoded attachments, will be compared. ^C to cancel.
37779 ========== h_select_txt_not_body ==========
37780 All messages that don't contain the entered string will be selected. Body
37781 text, but not headers or encoded attachments, will be compared. ^C to cancel.
37782 ========== h_select_txt_recip ==========
37783 Messages with Cc: or To: headers containing the entered string will be selected.
37784 ^C to cancel. ^G again to see original options.
37785 ========== h_select_txt_not_recip ==========
37786 Messages without Cc: or To: headers containing the string will be selected.
37787 ^C to cancel. ^G again to see original options.
37788 ========== h_select_txt_partic ==========
37789 Messages with Cc, To, or From headers containing the string will be selected.
37790 ^C to cancel. ^G again to see original options.
37791 ========== h_select_txt_not_partic ==========
37792 Messages without Cc, To, or From headers containing the string will be selected.
37793 ^C to cancel. ^G again to see original options.
37794 ========== h_select_date ==========
37795 If typed, date may be in DD-MMM-YYYY format (04-Jul-2006) or in ISO format
37796 (2006-07-04). ^P/^N also changes default date. ^X enters date of current msg.
37797 ========== h_attach_index_whereis ==========
37798 Enter some text that appears in the Attachment Index entry for the desired
37799 attachment.  The first attachment containing that text will be highlighted.
37800 ========== h_kb_lock ==========
37801 Keystrokes entered here (up to a RETURN) comprise a password that must
37802 be entered again later in order to unlock the keyboard.
37803 ========== h_compose_default ==========
37804 N, compose a new message. R, set a role.
37805 ^C to cancel.
37806 ========== h_untranslatable ==========
37807 Send using UTF-8 character set; Send but replace untranslatable characters
37808 with question marks; return to the composer; or cancel message altogether.
37809 ========== h_compose_intrptd ==========
37810 N, compose a new msg. I, continue interrupted msg. R, set a role.
37811 ^C to cancel.
37812 ========== h_compose_postponed ==========
37813 N, compose a new message. P, continue postponed msg. R, set a role.
37814 ^C to cancel.
37815 ========== h_compose_intrptd_postponed ==========
37816 N, compose a new msg. I, continue interrupted msg. P, continue postponed msg.
37817 R, set a role. ^C to cancel.
37818 ========== h_compose_form ==========
37819 N, compose a new message. F, use form letter. R, set a role.
37820 ^C to cancel.
37821 ========== h_compose_intrptd_form ==========
37822 N, compose a new msg. I, continue interrupted msg. F, use form letter.
37823 R, set a role. ^C to cancel.
37824 ========== h_compose_postponed_form ==========
37825 N, compose a new message. P, continue postponed msg. F, use form letter.
37826 R, set a role. ^C to cancel.
37827 ========== h_compose_intrptd_postponed_form ==========
37828 N, compose a new msg. I, continue interrupted msg. P, continue postponed msg.
37829 F, use form letter. R, set a role. ^C to cancel.
37830 ========== h_config_context_del_except ==========
37831 If you delete the last exceptional collection you can only add it back by
37832 manually editing the exceptions config file.
37833 ========== h_config_whereis ==========
37834 To move quickly to a particular line, enter a search string or
37835 ^C to cancel.
37836 ========== h_config_edit_scorei ==========
37837 Enter interval in the form (min,max). -INF and INF may be used to represent
37838 -infinity and infinity. ^C to cancel change. RETURN to accept change.
37839 ========== h_config_add ==========
37840 Enter desired value; use normal editing keys to modify (e.g. ^K, ^D).  Just
37841 pressing RETURN sets the Empty Value (this turns off any global default).
37842 ========== h_config_add_custom_color ==========
37843 Enter a header fieldname. For example, "subject" or "from".
37844
37845 ========== h_config_add_pat_hdr ==========
37846 Enter a header fieldname. For example, "reply-to" or "organization" or
37847 any fieldname you want that isn't included already.
37848 ========== h_config_print_opt_choice ==========
37849 You may edit either the initialization string (characters printed before
37850 printing starts) or the trailer string.  Choose one or ^C to cancel.
37851 ========== h_config_print_init ==========
37852 Enter a C-style string for this.  You may use common backslash escapes like
37853 \\n for newline, \\ooo for octal character, and \\xhh for hex character.
37854 ========== h_config_change ==========
37855 Edit the existing value using arrow keys, ^K to delete entire entry, ^D to
37856 delete current (highlighted) character, etc.  Enter ^C to cancel change.
37857 ========== h_config_replace_add ==========
37858 Replace ignores the current default, Add places the current default in your
37859 editing buffer as if you had typed it in.
37860 ========== h_config_insert_after ==========
37861 Enter a nickname for this print command.  (InsertBefore puts the new item
37862 before the current line, InsertAfter puts it after the current line.)
37863 ========== h_config_print_cmd ==========
37864 Enter command to be executed for the printer.  Use normal editing keys
37865 to modify, ^C to cancel, carriage return to accept current value.
37866 ========== h_config_role_del ==========
37867 Answering Yes will remove this rule completely from your rules list.
37868 ========== h_config_role_addfile ==========
37869 Type the name of a file to add to your configuration. You don't need to
37870 use a file, you may add rules directly (with Add) without using a file.
37871 ========== h_config_role_delfile ==========
37872 Answering Yes will remove this rule file completely from your rules list.
37873 The rules data file itself will not be removed.
37874 ========== h_config_print_del ==========
37875 Answering Yes will remove this printer completely from your printer list.
37876 ========== h_config_print_name_cmd ==========
37877 You may edit the Nickname of this printer, the Command to be executed when
37878 printing, or change the Options associated with this printer.
37879 ========== h_send_check_fcc ==========
37880 Yes, send message without an Fcc.
37881 No, return to composer.
37882 ========== h_send_check_subj ==========
37883 Yes, send message without a Subject.
37884 No, return to composer.
37885 ========== h_send_check_to_cc ==========
37886 Yes, send message without a To address, or a Cc address, or a Newsgroup.
37887 No, return to composer.
37888 ========== h_send_fcc_only ==========
37889 Yes, copy message to Fcc only and send to NO recipients.
37890 No, return to composer.
37891 ========== h_send_prompt ==========
37892 Yes, send the message.
37893 No or ^C, return to composer.
37894 ========== h_send_prompt_flowed ==========
37895 Yes, send the message.  No or ^C, return to composer.
37896 What's Flowed? See Do Not Send Flowed Text in config screen.
37897 ========== h_send_prompt_dsn ==========
37898 Yes, send the message.  No or ^C, return to composer.
37899 What's DSNOpts? See Enable Delivery Status Notification in config screen.
37900 ========== h_send_prompt_dsn_flowed ==========
37901 Yes, send the message.  No or ^C, return to composer. What's DSNOpts? See
37902 Enable Delivery Status Notification. What's Flowed? See Do Not Send Flowed Text.
37903 ========== h_role_confirm ==========
37904 Yes, use displayed role. No, compose without a role.
37905 ^C, cancel the message. ^T, select a role from your other eligible roles.
37906 ========== h_norole_confirm ==========
37907 Return, compose without a role.
37908 ^C, cancel the message. ^T, select a role from your eligible roles.
37909 ========== h_custom_print ==========
37910 Enter a Unix command that accepts its data on standard input.
37911 Alpine will display any information the command sends to standard output.
37912 ========== h_convert_abooks_and_sigs ==========
37913 You will be given the opportunity to convert address books and signature files
37914 to remote configurations.
37915 ========== h_convert_abooks ==========
37916 You will be given the opportunity to convert address books to remote
37917 configurations.
37918 ========== h_flag_keyword ==========
37919 Enter the name of the keyword you want to add for this folder.
37920 No spaces, parentheses, braces, percents or asterisks are allowed.
37921 ========== h_select_keyword ==========
37922 Enter the keyword you want to match, or use ^T to select a keyword from a list
37923 of possible keywords for this folder. Use ! to look for non-matches instead.
37924 ========== h_type_keyword ==========
37925 Enter the keyword you want to add. You may add a nickname in the next step.
37926 No spaces, parentheses, braces, percents or asterisks are allowed.
37927 ========== h_type_keyword_nickname ==========
37928 Enter an optional nickname for the keyword you want to add.
37929 Type Carriage return to use the keyword name instead of a nickname.
37930 ========== h_convert_sigs ==========
37931 You will be given the opportunity to convert signature files to remote
37932 configurations.
37933 ========== h_convert_abook ==========
37934 Yes is fairly safe. You will be ADDing a remote address book that is a copy
37935 of the current address book. The current abook won't be removed automatically.
37936 ========== h_convert_sig ==========
37937 Answering Yes copies the contents of the signature file into your Alpine
37938 configuration file. After that, the contents of the file will not be used.
37939 ========== h_save_addman ==========
37940 Enter the simple name of the folder you want to add. Carriage return to
37941 accept what you have typed so far. ^C to get back to SELECT FOLDER screen.
37942 ========== h_reopen_folder ==========
37943 Yes reopens the folder, as if you were starting over. This uncovers new mail.
37944 No leaves the folder index as it was without discovering new mail.
37945 ========== h_convert_pinerc_server ==========
37946 This is the name of the host (computer) where the remote Alpine configuration
37947 will be stored. This should be an IMAP server that you have permission to use.
37948 ========== h_convert_pinerc_folder ==========
37949 Enter the correct remote folder name. This folder is special and should
37950 contain only configuration data. It shouldn't contain other mail messages.
37951 ========== h_role_compose ==========
37952 Compose a New message, Reply to current message, Forward current message, or
37953 Bounce message. Then you will be asked to choose one of your Roles to be used.
37954 ========== h_role_aggregate ==========
37955 Compose a reply, or forward, or bounce the selected messages. Then you
37956 will be asked to choose one of your Roles to be used for this operation.
37957 ========== h_save_size_changed ==========
37958 The reported size of a message is not the same as the actual size. Answer Yes
37959 to continue and hope for the best or No to Cancel the entire Save.
37960 ========== h_select_by_larger_size ==========
37961 Enter a number or ^C to cancel. All messages greater than this many characters
37962 in size will be selected. Examples: 2176, 1.53K (1530), or 3M (3000000).
37963 ========== h_select_by_smaller_size ==========
37964 Enter a number or ^C to cancel. All messages less than this many characters
37965 in size will be selected. Examples: 2176, 1.53K (1530), or 3M (3000000).
37966 ========== h_preserve_field ==========
37967 Use 'p' to toggle between preserving or not preserving the original To:
37968 and Cc: fields of the message. Enter ^C to cancel message.
37969 ========== h_privacy_policy ==========
37970 x-alpine-http:http://alpine.x10host.com/privacy.html